Open-ILS/web/js/ui/default/staff/circ/patron/regctl.js

   1
   2 angular.module('egCoreMod')
   3 // toss tihs onto egCoreMod since the page app may vary
   4
   5 .factory('patronRegSvc', ['$q', '$filter', 'egCore', 'egLovefield', function($q, $filter, egCore, egLovefield) {
   6
   7     var service = {
   8         field_doc : {},            // config.idl_field_doc
   9         profiles : [],             // permission groups
  10         profile_entries : [],      // permission gorup display entries
  11         edit_profiles : [],        // perm groups we can modify
  12         edit_profile_entries : [], // perm group display entries we can modify
  13         sms_carriers : [],
  14         user_settings : {},        // applied user settings
  15         user_setting_types : {},   // config.usr_setting_type
  16         opt_in_setting_types : {}, // config.usr_setting_type for event-def opt-in
  17         surveys : [],
  18         survey_questions : {},
  19         survey_answers : {},
  20         survey_responses : {},     // survey.responses for loaded patron in progress
  21         stat_cats : [],
  22         stat_cat_entry_maps : {},   // cat.id to selected value
  23         virt_id : -1,               // virtual ID for new objects
  24         init_done : false           // have we loaded our initialization data?
  25     };
  26
  27     // Launch a series of parallel data retrieval calls.
  28     service.init = function(scope) {
  29
  30         // These are fetched with every instance of the page.
  31         var page_data = [
  32             service.get_user_settings(),
  33             service.get_clone_user(),
  34             service.get_stage_user()
  35         ];
  36
  37         var common_data = [];
  38         if (!service.init_done) {
  39             // These are fetched with every instance of the app.
  40             common_data = [
  41                 service.get_field_doc(),
  42                 service.get_perm_groups(),
  43                 service.get_perm_group_entries(),
  44                 service.get_ident_types(),
  45                 service.get_org_settings(),
  46                 service.get_stat_cats(),
  47                 service.get_surveys(),
  48                 service.get_net_access_levels()
  49             ];
  50             service.init_done = true;
  51         }
  52
  53         return $q.all(common_data.concat(page_data));
  54     };
  55
  56     service.get_clone_user = function() {
  57         if (!service.clone_id) return $q.when();
  58         // we could load egUser and use its get() function, but loading
  59         // user.js into the standalone register UI would mean creating a
  60         // new module, since egUser is not loaded into egCoreMod.  This
  61         // is a lot simpler.
  62         return egCore.net.request(
  63             'open-ils.actor',
  64             'open-ils.actor.user.fleshed.retrieve',
  65             egCore.auth.token(), service.clone_id,
  66             ['billing_address', 'mailing_address'])
  67         .then(function(cuser) {
  68             if (e = egCore.evt.parse(cuser)) {
  69                 alert(e);
  70             } else {
  71                 service.clone_user = cuser;
  72             }
  73         });
  74     }
  75
  76     // When editing a user with addresses linked to other users, fetch
  77     // the linked user(s) so we can display their names and edit links.
  78     service.get_linked_addr_users = function(addrs) {
  79         angular.forEach(addrs, function(addr) {
  80             if (addr.usr == service.existing_patron.id()) return;
  81             egCore.pcrud.retrieve('au', addr.usr)
  82             .then(function(usr) {
  83                 addr._linked_owner_id = usr.id();
  84                 addr._linked_owner = service.format_name(
  85                     usr.family_name(),
  86                     usr.first_given_name(),
  87                     usr.second_given_name()
  88                 );
  89             })
  90         });
  91     }
  92
  93     service.apply_secondary_groups = function(user_id, group_ids) {
  94         return egCore.net.request(
  95             'open-ils.actor',
  96             'open-ils.actor.user.set_groups',
  97             egCore.auth.token(), user_id, group_ids)
  98         .then(function(resp) {
  99             if (resp == 1) {
 100                 return true;
 101             } else {
 102                 // debugging -- should be no events
 103                 alert('linked groups failure ' + egCore.evt.parse(resp));
 104             }
 105         });
 106     }
 107
 108     service.get_stage_user = function() {
 109         if (!service.stage_username) return $q.when();
 110
 111         // fetch the staged user object
 112         return egCore.net.request(
 113             'open-ils.actor',
 114             'open-ils.actor.user.stage.retrieve.by_username',
 115             egCore.auth.token(),
 116             service.stage_username
 117         ).then(function(suser) {
 118             if (e = egCore.evt.parse(suser)) {
 119                 alert(e);
 120             } else {
 121                 service.stage_user = suser;
 122             }
 123         }).then(function() {
 124
 125             if (!service.stage_user) return;
 126             var requestor = service.stage_user.user.requesting_usr();
 127
 128             if (!requestor) return;
 129
 130             // fetch the requesting user
 131             return egCore.net.request(
 132                 'open-ils.actor',
 133                 'open-ils.actor.user.retrieve.parts',
 134                 egCore.auth.token(),
 135                 requestor,
 136                 ['family_name', 'first_given_name', 'second_given_name']
 137             ).then(function(parts) {
 138                 service.stage_user_requestor =
 139                     service.format_name(parts[0], parts[1], parts[2]);
 140             })
 141         });
 142     }
 143
 144     // See note above about not loading egUser.
 145     // TODO: i18n
 146     service.format_name = function(last, first, middle) {
 147         return last + ', ' + first + (middle ? ' ' + middle : '');
 148     }
 149
 150     service.check_dupe_username = function(usrname) {
 151
 152         // empty usernames can't be dupes
 153         if (!usrname) return $q.when(false);
 154
 155         // avoid dupe check if username matches the originally loaded usrname
 156         if (service.existing_patron) {
 157             if (usrname == service.existing_patron.usrname())
 158                 return $q.when(false);
 159         }
 160
 161         return egCore.net.request(
 162             'open-ils.actor',
 163             'open-ils.actor.username.exists',
 164             egCore.auth.token(), usrname);
 165     }
 166
 167     //service.check_grp_app_perm = function(grp_id) {
 168
 169     // determine which user groups our user is not allowed to modify
 170     service.set_edit_profiles = function() {
 171         var all_app_perms = [];
 172         var failed_perms = [];
 173
 174         // extract the application permissions
 175         angular.forEach(service.profiles, function(grp) {
 176             if (grp.application_perm())
 177                 all_app_perms.push(grp.application_perm());
 178         });
 179
 180         // fill in service.edit_profiles by inspecting failed_perms
 181         function traverse_grp_tree(grp, failed) {
 182             failed = failed ||
 183                 failed_perms.indexOf(grp.application_perm()) > -1;
 184
 185             if (!failed) service.edit_profiles.push(grp);
 186
 187             angular.forEach(
 188                 service.profiles.filter( // children of grp
 189                     function(p) { return p.parent() == grp.id() }),
 190                 function(child) {traverse_grp_tree(child, failed)}
 191             );
 192         }
 193
 194         return egCore.perm.hasPermAt(all_app_perms, true).then(
 195             function(perm_orgs) {
 196                 angular.forEach(all_app_perms, function(p) {
 197                     if (perm_orgs[p].length == 0)
 198                         failed_perms.push(p);
 199                 });
 200
 201                 traverse_grp_tree(egCore.env.pgt.tree);
 202             }
 203         );
 204     }
 205
 206     service.set_edit_profile_entries = function() {
 207         var all_app_perms = [];
 208         var failed_perms = [];
 209
 210         // extract the application permissions
 211         angular.forEach(service.profile_entries, function(entry) {
 212             if (entry.grp().application_perm())
 213                 all_app_perms.push(entry.grp().application_perm());
 214         });
 215
 216         // fill in service.edit_profiles by inspecting failed_perms
 217         function traverse_grp_tree(entry, failed) {
 218             failed = failed ||
 219                 failed_perms.indexOf(entry.grp().application_perm()) > -1;
 220
 221             if (!failed) service.edit_profile_entries.push(entry);
 222
 223             angular.forEach(
 224                 service.profile_entries.filter( // children of grp
 225                     function(p) { return p.parent() == entry.id() }),
 226                 function(child) {traverse_grp_tree(child, failed)}
 227             );
 228         }
 229
 230         return egCore.perm.hasPermAt(all_app_perms, true).then(
 231             function(perm_orgs) {
 232                 angular.forEach(all_app_perms, function(p) {
 233                     if (perm_orgs[p].length == 0)
 234                         failed_perms.push(p);
 235                 });
 236
 237                 angular.forEach(egCore.env.pgtde.tree, function(tree) {
 238                     traverse_grp_tree(tree);
 239                 });
 240             }
 241         );
 242     }
 243
 244     // resolves to a hash of perm-name => boolean value indicating
 245     // wether the user has the permission at org_id.
 246     service.has_perms_for_org = function(org_id) {
 247
 248         var perms_needed = [
 249             'EDIT_SELF_IN_CLIENT',
 250             'UPDATE_USER',
 251             'CREATE_USER',
 252             'CREATE_USER_GROUP_LINK',
 253             'UPDATE_PATRON_COLLECTIONS_EXEMPT',
 254             'UPDATE_PATRON_CLAIM_RETURN_COUNT',
 255             'UPDATE_PATRON_CLAIM_NEVER_CHECKED_OUT_COUNT',
 256             'UPDATE_PATRON_ACTIVE_CARD',
 257             'UPDATE_PATRON_PRIMARY_CARD'
 258         ];
 259
 260         return egCore.perm.hasPermAt(perms_needed, true)
 261         .then(function(perm_map) {
 262
 263             angular.forEach(perms_needed, function(perm) {
 264                 perm_map[perm] =
 265                     Boolean(perm_map[perm].indexOf(org_id) > -1);
 266             });
 267
 268             return perm_map;
 269         });
 270     }
 271
 272     service.get_surveys = function() {
 273         var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
 274
 275         return egCore.pcrud.search('asv', {
 276                 owner : org_ids,
 277                 start_date : {'<=' : 'now'},
 278                 end_date : {'>=' : 'now'}
 279             }, {
 280                 flesh : 2,
 281                 flesh_fields : {
 282                     asv : ['questions'],
 283                     asvq : ['answers']
 284                 }
 285             },
 286             {atomic : true}
 287         ).then(function(surveys) {
 288             surveys = surveys.sort(function(a,b) {
 289                 return a.name() < b.name() ? -1 : 1 });
 290             service.surveys = surveys;
 291             angular.forEach(surveys, function(survey) {
 292                 angular.forEach(survey.questions(), function(question) {
 293                     service.survey_questions[question.id()] = question;
 294                     angular.forEach(question.answers(), function(answer) {
 295                         service.survey_answers[answer.id()] = answer;
 296                     });
 297                 });
 298             });
 299
 300             egLovefield.setListInOfflineCache('asv', service.surveys)
 301             egLovefield.setListInOfflineCache('asvq', service.survey_questions)
 302             egLovefield.setListInOfflineCache('asva', service.survey_answers)
 303
 304         });
 305     }
 306
 307     service.get_stat_cats = function() {
 308         return egCore.net.request(
 309             'open-ils.circ',
 310             'open-ils.circ.stat_cat.actor.retrieve.all',
 311             egCore.auth.token(), egCore.auth.user().ws_ou()
 312         ).then(function(cats) {
 313             cats = cats.sort(function(a, b) {
 314                 return a.name() < b.name() ? -1 : 1});
 315             angular.forEach(cats, function(cat) {
 316                 cat.entries(
 317                     cat.entries().sort(function(a,b) {
 318                         return a.value() < b.value() ? -1 : 1
 319                     })
 320                 );
 321             });
 322             service.stat_cats = cats;
 323             return egLovefield.setStatCatsCache(cats);
 324         });
 325     };
 326
 327     service.get_org_settings = function() {
 328         return egCore.org.settings([
 329             'global.password_regex',
 330             'global.juvenile_age_threshold',
 331             'patron.password.use_phone',
 332             'ui.patron.default_inet_access_level',
 333             'ui.patron.default_ident_type',
 334             'ui.patron.default_country',
 335             'ui.patron.registration.require_address',
 336             'circ.holds.behind_desk_pickup_supported',
 337             'circ.patron_edit.clone.copy_address',
 338             'circ.privacy_waiver',
 339             'ui.patron.edit.au.prefix.require',
 340             'ui.patron.edit.au.prefix.show',
 341             'ui.patron.edit.au.prefix.suggest',
 342             'ui.patron.edit.ac.barcode.regex',
 343             'ui.patron.edit.au.second_given_name.show',
 344             'ui.patron.edit.au.second_given_name.suggest',
 345             'ui.patron.edit.au.suffix.show',
 346             'ui.patron.edit.au.suffix.suggest',
 347             'ui.patron.edit.au.alias.show',
 348             'ui.patron.edit.au.alias.suggest',
 349             'ui.patron.edit.au.dob.require',
 350             'ui.patron.edit.au.dob.show',
 351             'ui.patron.edit.au.dob.suggest',
 352             'ui.patron.edit.au.dob.calendar',
 353             'ui.patron.edit.au.dob.example',
 354             'ui.patron.edit.au.juvenile.show',
 355             'ui.patron.edit.au.juvenile.suggest',
 356             'ui.patron.edit.au.ident_value.show',
 357             'ui.patron.edit.au.ident_value.require',
 358             'ui.patron.edit.au.ident_value.suggest',
 359             'ui.patron.edit.au.ident_value2.show',
 360             'ui.patron.edit.au.ident_value2.suggest',
 361             'ui.patron.edit.au.email.require',
 362             'ui.patron.edit.au.email.show',
 363             'ui.patron.edit.au.email.suggest',
 364             'ui.patron.edit.au.email.regex',
 365             'ui.patron.edit.au.email.example',
 366             'ui.patron.edit.au.day_phone.require',
 367             'ui.patron.edit.au.day_phone.show',
 368             'ui.patron.edit.au.day_phone.suggest',
 369             'ui.patron.edit.au.day_phone.regex',
 370             'ui.patron.edit.au.day_phone.example',
 371             'ui.patron.edit.au.evening_phone.require',
 372             'ui.patron.edit.au.evening_phone.show',
 373             'ui.patron.edit.au.evening_phone.suggest',
 374             'ui.patron.edit.au.evening_phone.regex',
 375             'ui.patron.edit.au.evening_phone.example',
 376             'ui.patron.edit.au.other_phone.require',
 377             'ui.patron.edit.au.other_phone.show',
 378             'ui.patron.edit.au.other_phone.suggest',
 379             'ui.patron.edit.au.other_phone.regex',
 380             'ui.patron.edit.au.other_phone.example',
 381             'ui.patron.edit.phone.regex',
 382             'ui.patron.edit.phone.example',
 383             'ui.patron.edit.au.active.show',
 384             'ui.patron.edit.au.active.suggest',
 385             'ui.patron.edit.au.barred.show',
 386             'ui.patron.edit.au.barred.suggest',
 387             'ui.patron.edit.au.master_account.show',
 388             'ui.patron.edit.au.master_account.suggest',
 389             'ui.patron.edit.au.claims_returned_count.show',
 390             'ui.patron.edit.au.claims_returned_count.suggest',
 391             'ui.patron.edit.au.claims_never_checked_out_count.show',
 392             'ui.patron.edit.au.claims_never_checked_out_count.suggest',
 393             'ui.patron.edit.au.alert_message.show',
 394             'ui.patron.edit.au.alert_message.suggest',
 395             'ui.patron.edit.aua.post_code.regex',
 396             'ui.patron.edit.aua.post_code.example',
 397             'ui.patron.edit.aua.county.require',
 398             'ui.patron.edit.au.guardian.show',
 399             'ui.patron.edit.au.guardian.suggest',
 400             'ui.patron.edit.guardian_required_for_juv',
 401             'format.date',
 402             'ui.patron.edit.default_suggested',
 403             'opac.barcode_regex',
 404             'opac.username_regex',
 405             'sms.enable',
 406             'ui.patron.edit.aua.state.require',
 407             'ui.patron.edit.aua.state.suggest',
 408             'ui.patron.edit.aua.state.show',
 409             'ui.admin.work_log.max_entries',
 410             'ui.admin.patron_log.max_entries'
 411         ]).then(function(settings) {
 412             service.org_settings = settings;
 413             if (egCore && egCore.env && !egCore.env.aous) {
 414                 egCore.env.aous = settings;
 415                 console.log('setting egCore.env.aous');
 416             }
 417             return service.process_org_settings(settings);
 418         });
 419     };
 420
 421     // some org settings require the retrieval of additional data
 422     service.process_org_settings = function(settings) {
 423
 424         var promises = [egLovefield.setSettingsCache(settings)];
 425
 426         if (settings['sms.enable']) {
 427             // fetch SMS carriers
 428             promises.push(
 429                 egCore.pcrud.search('csc',
 430                     {active: 'true'},
 431                     {'order_by':[
 432                         {'class':'csc', 'field':'name'},
 433                         {'class':'csc', 'field':'region'}
 434                     ]}, {atomic : true}
 435                 ).then(function(carriers) {
 436                     service.sms_carriers = carriers;
 437                 })
 438             );
 439         } else {
 440             // if other promises are added below, this is not necessary.
 441             promises.push($q.when());
 442         }
 443
 444         // other post-org-settings processing goes here,
 445         // adding to promises as needed.
 446
 447         return $q.all(promises);
 448     };
 449
 450     service.get_ident_types = function() {
 451         if (egCore.env.cit) {
 452             service.ident_types = egCore.env.cit.list;
 453             return $q.when();
 454         } else {
 455             return egCore.pcrud.retrieveAll('cit', {}, {atomic : true})
 456             .then(function(types) {
 457                 egCore.env.absorbList(types, 'cit')
 458                 service.ident_types = types
 459             });
 460         }
 461     };
 462
 463     service.get_net_access_levels = function() {
 464         if (egCore.env.cnal) {
 465             service.net_access_levels = egCore.env.cnal.list;
 466             return $q.when();
 467         } else {
 468             return egCore.pcrud.retrieveAll('cnal', {}, {atomic : true})
 469             .then(function(levels) {
 470                 egCore.env.absorbList(levels, 'cnal')
 471                 service.net_access_levels = levels
 472             });
 473         }
 474     }
 475
 476     service.get_perm_groups = function() {
 477         if (egCore.env.pgt) {
 478             service.profiles = egCore.env.pgt.list;
 479             return service.set_edit_profiles();
 480         } else {
 481             return egCore.pcrud.search('pgt', {parent : null},
 482                 {flesh : -1, flesh_fields : {pgt : ['children']}}
 483             ).then(
 484                 function(tree) {
 485                     egCore.env.absorbTree(tree, 'pgt')
 486                     service.profiles = egCore.env.pgt.list;
 487                     return service.set_edit_profiles();
 488                 }
 489             );
 490         }
 491     }
 492
 493     service.searchPermGroupEntries = function(org) {
 494         return egCore.pcrud.search('pgtde', {org: org, parent: null},
 495             {flesh: -1, flesh_fields: {pgtde: ['grp', 'children']}}, {atomic: true}
 496         ).then(function(treeArray) {
 497             if (!treeArray.length && egCore.org.get(org).parent_ou()) {
 498                 return service.searchPermGroupEntries(egCore.org.get(org).parent_ou());
 499             }
 500             return treeArray;
 501         });
 502     }
 503
 504     service.get_perm_group_entries = function() {
 505         if (egCore.env.pgtde) {
 506             service.profile_entries = egCore.env.pgtde.list;
 507             return service.set_edit_profile_entries();
 508         } else {
 509             return service.searchPermGroupEntries(egCore.auth.user().ws_ou()).then(function(treeArray) {
 510                 function compare(a,b) {
 511                   if (a.position() > b.position())
 512                     return -1;
 513                   if (a.position() < b.position())
 514                     return 1;
 515                   return 0;
 516                 }
 517
 518                 var list = [];
 519                 function squash(node) {
 520                     node.children().sort(compare);
 521                     list.push(node);
 522                     angular.forEach(node.children(), squash);
 523                 }
 524
 525                 angular.forEach(treeArray, squash);
 526                 var blob = egCore.env.absorbList(list, 'pgtde');
 527                 blob.tree = treeArray;
 528
 529                 service.profile_entries = egCore.env.pgtde.list;
 530                 return service.set_edit_profile_entries();
 531             });
 532         }
 533     }
 534
 535     service.get_field_doc = function() {
 536         var to_cache = [];
 537         return egCore.pcrud.search('fdoc', {
 538             fm_class: ['au', 'ac', 'aua', 'actsc', 'asv', 'asvq', 'asva']})
 539         .then(
 540             function () {
 541                 return egLovefield.setListInOfflineCache('fdoc', to_cache)
 542             },
 543             null,
 544             function(doc) {
 545                 if (!service.field_doc[doc.fm_class()]) {
 546                     service.field_doc[doc.fm_class()] = {};
 547                 }
 548                 service.field_doc[doc.fm_class()][doc.field()] = doc;
 549                 to_cache.push(doc);
 550             }
 551         );
 552
 553     };
 554
 555     service.get_user_setting_types = function() {
 556
 557         // No need to re-fetch the common setting types.
 558         if (Object.keys(service.user_setting_types).length)
 559             return $q.when();
 560
 561         var org_ids = egCore.org.ancestors(egCore.auth.user().ws_ou(), true);
 562
 563         var static_types = [
 564             'circ.holds_behind_desk',
 565             'circ.collections.exempt',
 566             'opac.hold_notify',
 567             'opac.default_phone',
 568             'opac.default_pickup_location',
 569             'opac.default_sms_carrier',
 570             'opac.default_sms_notify'];
 571
 572         return egCore.pcrud.search('cust', {
 573             '-or' : [
 574                 {name : static_types}, // common user settings
 575                 {name : { // opt-in notification user settings
 576                     'in': {
 577                         select : {atevdef : ['opt_in_setting']},
 578                         from : 'atevdef',
 579                         // we only care about opt-in settings for
 580                         // event_defs our users encounter
 581                         where : {'+atevdef' : {owner : org_ids}}
 582                     }
 583                 }}
 584             ]
 585         }, {}, {atomic : true}).then(function(setting_types) {
 586
 587             egCore.env.absorbList(setting_types, 'cust'); // why not...
 588
 589             angular.forEach(setting_types, function(stype) {
 590                 service.user_setting_types[stype.name()] = stype;
 591                 if (static_types.indexOf(stype.name()) == -1) {
 592                     service.opt_in_setting_types[stype.name()] = stype;
 593                 }
 594             });
 595         });
 596     };
 597
 598     service.get_user_settings = function() {
 599
 600         return service.get_user_setting_types()
 601         .then(function() {
 602
 603             var setting_types = Object.values(service.user_setting_types);
 604
 605             if (service.patron_id) {
 606                 // retrieve applied values for the current user
 607                 // for the setting types we care about.
 608
 609                 var setting_names =
 610                     setting_types.map(function(obj) { return obj.name() });
 611
 612                 return egCore.net.request(
 613                     'open-ils.actor',
 614                     'open-ils.actor.patron.settings.retrieve.authoritative',
 615                     egCore.auth.token(),
 616                     service.patron_id,
 617                     setting_names
 618                 ).then(function(settings) {
 619                     service.user_settings = settings;
 620                 });
 621
 622             } else {
 623
 624                 // apply default user setting values
 625                 angular.forEach(setting_types, function(stype, index) {
 626                     if (stype.reg_default() != undefined) {
 627                         var val = stype.reg_default();
 628                         if (stype.datatype() == 'bool') {
 629                             // A boolean user setting type whose default
 630                             // value starts with t/T is considered 'true',
 631                             // false otherwise.
 632                             val = Boolean((val+'').match(/^t/i));
 633                         }
 634                         service.user_settings[stype.name()] = val;
 635                     }
 636                 });
 637             }
 638         });
 639     }
 640
 641     service.invalidate_field = function(patron, field) {
 642         console.log('Invalidating patron field ' + field);
 643
 644         return egCore.net.request(
 645             'open-ils.actor',
 646             'open-ils.actor.invalidate.' + field,
 647             egCore.auth.token(), patron.id, null, patron.home_ou.id()
 648
 649         ).then(function(res) {
 650             // clear the invalid value from the form
 651             patron[field] = '';
 652
 653             // update last_xact_id so future save operations
 654             // on this patron will be allowed
 655             patron.last_xact_id = res.payload.last_xact_id[patron.id];
 656         });
 657     }
 658
 659     service.dupe_patron_search = function(patron, type, value) {
 660         var search;
 661
 662         console.log('Dupe search called with "'+ type +'" and value '+ value);
 663
 664         if (type.match(/phone/)) type = 'phone'; // day_phone, etc.
 665
 666         switch (type) {
 667
 668             case 'name':
 669                 var fname = patron.first_given_name;
 670                 var lname = patron.family_name;
 671                 if (!(fname && lname)) return $q.when({count:0});
 672                 search = {
 673                     first_given_name : {value : fname, group : 0},
 674                     family_name : {value : lname, group : 0}
 675                 };
 676                 break;
 677
 678             case 'email':
 679                 search = {email : {value : value, group : 0}};
 680                 break;
 681
 682             case 'ident':
 683                 search = {ident : {value : value, group : 2}};
 684                 break;
 685
 686             case 'phone':
 687                 search = {phone : {value : value, group : 2}};
 688                 break;
 689
 690             case 'address':
 691                 search = {};
 692                 angular.forEach(['street1', 'street2', 'city', 'post_code'],
 693                     function(field) {
 694                         if(value[field])
 695                             search[field] = {value : value[field], group: 1};
 696                     }
 697                 );
 698                 break;
 699         }
 700
 701         return egCore.net.request(
 702             'open-ils.actor',
 703             'open-ils.actor.patron.search.advanced',
 704             egCore.auth.token(), search, null, null, 1
 705         ).then(function(res) {
 706             res = res.filter(function(id) {return id != patron.id});
 707             return {
 708                 count : res.length,
 709                 search : search
 710             };
 711         });
 712     }
 713
 714     service.init_patron = function(current) {
 715
 716         if (!current)
 717             return $q.when(service.init_new_patron());
 718
 719         service.patron = current;
 720         return $q.when(service.init_existing_patron(current));
 721     }
 722
 723     service.ingest_address = function(patron, addr) {
 724         addr.valid = addr.valid == 't';
 725         addr.within_city_limits = addr.within_city_limits == 't';
 726         addr._is_mailing = (patron.mailing_address &&
 727             addr.id == patron.mailing_address.id);
 728         addr._is_billing = (patron.billing_address &&
 729             addr.id == patron.billing_address.id);
 730         addr.pending = addr.pending === 't';
 731     }
 732
 733     service.ingest_waiver_entry = function(patron, waiver_entry) {
 734         waiver_entry.place_holds = waiver_entry.place_holds == 't';
 735         waiver_entry.pickup_holds = waiver_entry.pickup_holds == 't';
 736         waiver_entry.view_history = waiver_entry.view_history == 't';
 737         waiver_entry.checkout_items = waiver_entry.checkout_items == 't';
 738     }
 739
 740     /*
 741      * Existing patron objects reqire some data munging before insertion
 742      * into the scope.
 743      *
 744      * 1. Turn everything into a hash
 745      * 2. ... Except certain fields (selectors) whose widgets require objects
 746      * 3. Bools must be Boolean, not t/f.
 747      */
 748     service.init_existing_patron = function(current) {
 749
 750         service.existing_patron = current;
 751
 752         var patron = egCore.idl.toHash(current);
 753
 754         patron.home_ou = egCore.org.get(patron.home_ou.id);
 755         patron.expire_date = new Date(Date.parse(patron.expire_date));
 756         patron.dob = service.parse_dob(patron.dob);
 757         patron.profile = current.profile(); // pre-hash version
 758         patron.net_access_level = current.net_access_level();
 759         patron.ident_type = current.ident_type();
 760         patron.ident_type2 = current.ident_type2();
 761         patron.groups = current.groups(); // pre-hash
 762
 763         angular.forEach(
 764             ['juvenile', 'barred', 'active', 'master_account'],
 765             function(field) { patron[field] = patron[field] == 't'; }
 766         );
 767
 768         angular.forEach(patron.cards, function(card) {
 769             card.active = card.active == 't';
 770             if (card.id == patron.card.id) {
 771                 patron.card = card;
 772                 card._primary = true;
 773             }
 774         });
 775
 776         angular.forEach(patron.addresses,
 777             function(addr) { service.ingest_address(patron, addr) });
 778
 779         // Link replaced address to its pending address.
 780         angular.forEach(patron.addresses, function(addr) {
 781             if (addr.replaces) {
 782                 addr._replaces = patron.addresses.filter(
 783                     function(a) {return a.id == addr.replaces})[0];
 784             }
 785         });
 786
 787         angular.forEach(patron.waiver_entries,
 788             function(waiver_entry) { service.ingest_waiver_entry(patron, waiver_entry) });
 789
 790         service.get_linked_addr_users(patron.addresses);
 791
 792         // Remove stat cat entries that link to out-of-scope stat
 793         // cats.  With this, we avoid unnecessarily updating (or worse,
 794         // modifying) stat cat values that are not ours to modify.
 795         patron.stat_cat_entries = patron.stat_cat_entries.filter(
 796             function(map) {
 797                 return Boolean(
 798                     // service.stat_cats only contains in-scope stat cats.
 799                     service.stat_cats.filter(function(cat) {
 800                         return (cat.id() == map.stat_cat.id) })[0]
 801                 );
 802             }
 803         );
 804
 805         // toss entries for existing stat cat maps into our living
 806         // stat cat entry map, which is modified within the template.
 807         service.stat_cat_entry_maps = [];
 808         angular.forEach(patron.stat_cat_entries, function(map) {
 809             service.stat_cat_entry_maps[map.stat_cat.id] = map.stat_cat_entry;
 810         });
 811
 812         service.patron = patron;
 813         return patron;
 814     }
 815
 816     service.init_new_patron = function() {
 817         var addr = {
 818             id : service.virt_id--,
 819             isnew : true,
 820             valid : true,
 821             address_type : egCore.strings.REG_ADDR_TYPE,
 822             _is_mailing : true,
 823             _is_billing : true,
 824             within_city_limits : false,
 825             country : service.org_settings['ui.patron.default_country'],
 826         };
 827
 828         var card = {
 829             id : service.virt_id--,
 830             isnew : true,
 831             active : true,
 832             _primary : true
 833         };
 834
 835         var user = {
 836             isnew : true,
 837             active : true,
 838             card : card,
 839             cards : [card],
 840             home_ou : egCore.org.get(egCore.auth.user().ws_ou()),
 841             stat_cat_entries : [],
 842             waiver_entries : [],
 843             groups : [],
 844             addresses : [addr]
 845         };
 846
 847         if (service.clone_user)
 848             service.copy_clone_data(user);
 849
 850         if (service.stage_user)
 851             service.copy_stage_data(user);
 852
 853         return user;
 854     }
 855
 856     // dob is always YYYY-MM-DD
 857     // Dates of birth do not contain timezone info, which can lead to
 858     // inconcistent timezone handling, potentially representing
 859     // different points in time, depending on the implementation.
 860     // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse
 861     // See "Differences in assumed time zone"
 862     // TODO: move this into egDate ?
 863     service.parse_dob = function(dob) {
 864         if (!dob) return null;
 865         var parts = dob.split('-');
 866         return new Date(parts[0], parts[1] - 1, parts[2])
 867     }
 868
 869     service.copy_stage_data = function(user) {
 870         var cuser = service.stage_user;
 871
 872         // copy the data into our new user object
 873
 874         for (var key in egCore.idl.classes.stgu.field_map) {
 875             if (egCore.idl.classes.au.field_map[key] &&
 876                 !egCore.idl.classes.stgu.field_map[key].virtual) {
 877                 if (cuser.user[key]() !== null)
 878                     user[key] = cuser.user[key]();
 879             }
 880         }
 881
 882         if (user.home_ou) user.home_ou = egCore.org.get(user.home_ou);
 883         if (user.profile) user.profile = egCore.env.pgt.map[user.profile];
 884         if (user.ident_type)
 885             user.ident_type = egCore.env.cit.map[user.ident_type];
 886         if (user.ident_type2)
 887             user.ident_type2 = egCore.env.cit.map[user.ident_type2];
 888         user.dob = service.parse_dob(user.dob);
 889
 890         // Clear the usrname if it looks like a UUID
 891         if (user.usrname.replace(/-/g,'').match(/[0-9a-f]{32}/))
 892             user.usrname = '';
 893
 894         // Don't use stub address if we have one from the staged user.
 895         if (cuser.mailing_addresses.length || cuser.billing_addresses.length)
 896             user.addresses = [];
 897
 898         // is_mailing=false implies is_billing
 899         function addr_from_stage(stage_addr) {
 900             if (!stage_addr) return;
 901             var cls = stage_addr.classname;
 902
 903             var addr = {
 904                 id : service.virt_id--,
 905                 usr : user.id,
 906                 isnew : true,
 907                 valid : true,
 908                 address_type : egCore.strings.REG_ADDR_TYPE,
 909                 _is_mailing : cls == 'stgma',
 910                 _is_billing : cls == 'stgba'
 911             };
 912
 913             user.mailing_address = addr;
 914             user.addresses.push(addr);
 915
 916             for (var key in egCore.idl.classes[cls].field_map) {
 917                 if (egCore.idl.classes.aua.field_map[key] &&
 918                     !egCore.idl.classes[cls].field_map[key].virtual) {
 919                     if (stage_addr[key]() !== null)
 920                         addr[key] = stage_addr[key]();
 921                 }
 922             }
 923         }
 924
 925         addr_from_stage(cuser.mailing_addresses[0]);
 926         addr_from_stage(cuser.billing_addresses[0]);
 927
 928         if (user.addresses.length == 1) {
 929             // If there is only one address,
 930             // use it as both mailing and billing.
 931             var addr = user.addresses[0];
 932             addr._is_mailing = addr._is_billing = true;
 933             user.mailing_address = user.billing_address = addr;
 934         }
 935
 936         if (cuser.cards.length) {
 937             user.card = {
 938                 id : service.virt_id--,
 939                 barcode : cuser.cards[0].barcode(),
 940                 isnew : true,
 941                 active : true,
 942                 _primary : true
 943             };
 944
 945             user.cards.push(user.card);
 946             if (user.usrname == '')
 947                 user.usrname = card.barcode;
 948         }
 949
 950         angular.forEach(cuser.settings, function(setting) {
 951             service.user_settings[setting.setting()] = Boolean(setting.value());
 952         });
 953     }
 954
 955     // copy select values from the cloned user to the new user.
 956     // user is a hash
 957     service.copy_clone_data = function(user) {
 958         var clone_user = service.clone_user;
 959
 960         // flesh the home org locally
 961         user.home_ou = egCore.org.get(clone_user.home_ou());
 962         if (user.profile) user.profile = egCore.env.pgt.map[user.profile];
 963
 964         if (!clone_user.billing_address() &&
 965             !clone_user.mailing_address())
 966             return; // no addresses to copy or link
 967
 968         // if the cloned user has any addresses, we don't need
 969         // the stub address created in init_new_patron.
 970         user.addresses = [];
 971
 972         var copy_addresses =
 973             service.org_settings['circ.patron_edit.clone.copy_address'];
 974
 975         var clone_fields = [
 976             'day_phone',
 977             'evening_phone',
 978             'other_phone',
 979             'usrgroup'
 980         ];
 981
 982         angular.forEach(clone_fields, function(field) {
 983             user[field] = clone_user[field]();
 984         });
 985
 986         if (copy_addresses) {
 987             var bill_addr, mail_addr;
 988
 989             // copy the billing and mailing addresses into new addresses
 990             function clone_addr(addr) {
 991                 var new_addr = egCore.idl.toHash(addr);
 992                 new_addr.id = service.virt_id--;
 993                 new_addr.usr = user.id;
 994                 new_addr.isnew = true;
 995                 new_addr.valid = true;
 996                 user.addresses.push(new_addr);
 997                 return new_addr;
 998             }
 999
1000             if (bill_addr = clone_user.billing_address()) {
1001                 var addr = clone_addr(bill_addr);
1002                 addr._is_billing = true;
1003                 user.billing_address = addr;
1004             }
1005
1006             if (mail_addr = clone_user.mailing_address()) {
1007
1008                 if (bill_addr && bill_addr.id() == mail_addr.id()) {
1009                     user.mailing_address = user.billing_address;
1010                     user.mailing_address._is_mailing = true;
1011                 } else {
1012                     var addr = clone_addr(mail_addr);
1013                     addr._is_mailing = true;
1014                     user.mailing_address = addr;
1015                 }
1016
1017                 if (!bill_addr) {
1018                     // if there is no billing addr, use the mailing addr
1019                     user.billing_address = user.mailing_address;
1020                     user.billing_address._is_billing = true;
1021                 }
1022             }
1023
1024
1025         } else {
1026
1027             // link the billing and mailing addresses
1028             var addr;
1029             if (addr = clone_user.billing_address()) {
1030                 user.billing_address = egCore.idl.toHash(addr);
1031                 user.billing_address._is_billing = true;
1032                 user.addresses.push(user.billing_address);
1033                 user.billing_address._linked_owner_id = clone_user.id();
1034                 user.billing_address._linked_owner = service.format_name(
1035                     clone_user.family_name(),
1036                     clone_user.first_given_name(),
1037                     clone_user.second_given_name()
1038                 );
1039             }
1040
1041             if (addr = clone_user.mailing_address()) {
1042                 if (user.billing_address &&
1043                     addr.id() == user.billing_address.id) {
1044                     // mailing matches billing
1045                     user.mailing_address = user.billing_address;
1046                     user.mailing_address._is_mailing = true;
1047                 } else {
1048                     user.mailing_address = egCore.idl.toHash(addr);
1049                     user.mailing_address._is_mailing = true;
1050                     user.addresses.push(user.mailing_address);
1051                     user.mailing_address._linked_owner_id = clone_user.id();
1052                     user.mailing_address._linked_owner = service.format_name(
1053                         clone_user.family_name(),
1054                         clone_user.first_given_name(),
1055                         clone_user.second_given_name()
1056                     );
1057                 }
1058             }
1059         }
1060     }
1061
1062     // translate the patron back into IDL form
1063     service.save_user = function(phash) {
1064
1065         var patron = egCore.idl.fromHash('au', phash);
1066
1067         patron.home_ou(patron.home_ou().id());
1068         patron.expire_date(patron.expire_date().toISOString());
1069         patron.profile(patron.profile().id());
1070         if (patron.dob())
1071             patron.dob(patron.dob().toISOString().replace(/T.*/,''));
1072         if (patron.ident_type())
1073             patron.ident_type(patron.ident_type().id());
1074         if (patron.net_access_level())
1075             patron.net_access_level(patron.net_access_level().id());
1076
1077         angular.forEach(
1078             ['juvenile', 'barred', 'active', 'master_account'],
1079             function(field) { patron[field](phash[field] ? 't' : 'f'); }
1080         );
1081
1082         var card_hashes = patron.cards();
1083         patron.cards([]);
1084         angular.forEach(card_hashes, function(chash) {
1085             var card = egCore.idl.fromHash('ac', chash)
1086             card.usr(patron.id());
1087             card.active(chash.active ? 't' : 'f');
1088             patron.cards().push(card);
1089             if (chash._primary) {
1090                 patron.card(card);
1091             }
1092         });
1093
1094         var addr_hashes = patron.addresses();
1095         patron.addresses([]);
1096         angular.forEach(addr_hashes, function(addr_hash) {
1097             if (!addr_hash.isnew && !addr_hash.isdeleted)
1098                 addr_hash.ischanged = true;
1099             var addr = egCore.idl.fromHash('aua', addr_hash);
1100             patron.addresses().push(addr);
1101             addr.valid(addr.valid() ? 't' : 'f');
1102             addr.within_city_limits(addr.within_city_limits() ? 't' : 'f');
1103             addr.pending(addr.pending() ? 't' : 'f');
1104             if (addr_hash._is_mailing) patron.mailing_address(addr);
1105             if (addr_hash._is_billing) patron.billing_address(addr);
1106         });
1107
1108         patron.survey_responses([]);
1109         angular.forEach(service.survey_responses, function(answer) {
1110             var question = service.survey_questions[answer.question()];
1111             var resp = new egCore.idl.asvr();
1112             resp.isnew(true);
1113             resp.survey(question.survey());
1114             resp.question(question.id());
1115             resp.answer(answer.id());
1116             resp.usr(patron.id());
1117             resp.answer_date('now');
1118             patron.survey_responses().push(resp);
1119         });
1120
1121         // re-object-ify the patron stat cat entry maps
1122         var maps = [];
1123         angular.forEach(patron.stat_cat_entries(), function(entry) {
1124             var e = egCore.idl.fromHash('actscecm', entry);
1125             e.stat_cat(e.stat_cat().id);
1126             maps.push(e);
1127         });
1128         patron.stat_cat_entries(maps);
1129
1130         // service.stat_cat_entry_maps maps stats to values
1131         // patron.stat_cat_entries is an array of stat_cat_entry_usr_map's
1132         angular.forEach(
1133             service.stat_cat_entry_maps, function(value, cat_id) {
1134
1135             // see if we already have a mapping for this entry
1136             var existing = patron.stat_cat_entries().filter(
1137                 function(e) { return e.stat_cat() == cat_id })[0];
1138
1139             if (existing) { // we have a mapping
1140                 // if the existing mapping matches the new one,
1141                 // there' nothing left to do
1142                 if (existing.stat_cat_entry() == value) return;
1143
1144                 // mappings differ.  delete the old one and create
1145                 // a new one below.
1146                 existing.isdeleted(true);
1147             }
1148
1149             var newmap = new egCore.idl.actscecm();
1150             newmap.target_usr(patron.id());
1151             newmap.isnew(true);
1152             newmap.stat_cat(cat_id);
1153             newmap.stat_cat_entry(value);
1154             patron.stat_cat_entries().push(newmap);
1155         });
1156
1157         var waiver_hashes = patron.waiver_entries();
1158         patron.waiver_entries([]);
1159         angular.forEach(waiver_hashes, function(waiver_hash) {
1160             if (!waiver_hash.isnew && !waiver_hash.isdeleted)
1161                 waiver_hash.ischanged = true;
1162             var waiver_entry = egCore.idl.fromHash('aupw', waiver_hash);
1163             patron.waiver_entries().push(waiver_entry);
1164         });
1165
1166         if (!patron.isnew()) patron.ischanged(true);
1167
1168         return egCore.net.request(
1169             'open-ils.actor',
1170             'open-ils.actor.patron.update',
1171             egCore.auth.token(), patron);
1172     }
1173
1174     service.remove_staged_user = function() {
1175         if (!service.stage_user) return $q.when();
1176         return egCore.net.request(
1177             'open-ils.actor',
1178             'open-ils.actor.user.stage.delete',
1179             egCore.auth.token(),
1180             service.stage_user.user.row_id()
1181         );
1182     }
1183
1184     service.save_user_settings = function(new_user, user_settings) {
1185
1186         var settings = {};
1187         if (service.patron_id) {
1188             // Update all user editor setting values for existing
1189             // users regardless of whether a value changed.
1190             settings = user_settings;
1191
1192         } else {
1193             // Create settings for all non-null setting values for new patrons.
1194             angular.forEach(user_settings, function(val, key) {
1195                 if (val !== null) settings[key] = val;
1196             });
1197         }
1198
1199         if (Object.keys(settings).length == 0) return $q.when();
1200
1201         return egCore.net.request(
1202             'open-ils.actor',
1203             'open-ils.actor.patron.settings.update',
1204             egCore.auth.token(), new_user.id(), settings
1205         ).then(function(resp) {
1206             return resp;
1207         });
1208     }
1209
1210     // Applies field-specific validation regex's from org settings
1211     // to form fields.  Be careful not remove any pattern data we
1212     // are not explicitly over-writing in the provided patterns obj.
1213     service.set_field_patterns = function(patterns) {
1214         if (service.org_settings['opac.username_regex']) {
1215             patterns.au.usrname =
1216                 new RegExp(service.org_settings['opac.username_regex']);
1217         }
1218
1219         if (service.org_settings['ui.patron.edit.ac.barcode.regex']) {
1220             patterns.ac.barcode =
1221                 new RegExp(service.org_settings['ui.patron.edit.ac.barcode.regex']);
1222         }
1223
1224         if (service.org_settings['global.password_regex']) {
1225             patterns.au.passwd =
1226                 new RegExp(service.org_settings['global.password_regex']);
1227         }
1228
1229         var phone_reg = service.org_settings['ui.patron.edit.phone.regex'];
1230         if (phone_reg) {
1231             // apply generic phone regex first, replace below as needed.
1232             patterns.au.day_phone = new RegExp(phone_reg);
1233             patterns.au.evening_phone = new RegExp(phone_reg);
1234             patterns.au.other_phone = new RegExp(phone_reg);
1235         }
1236
1237         // the remaining patterns fit a well-known key name pattern
1238
1239         angular.forEach(service.org_settings, function(val, key) {
1240             if (!val) return;
1241             var parts = key.match(/ui.patron.edit\.(\w+)\.(\w+)\.regex/);
1242             if (!parts) return;
1243             var cls = parts[1];
1244             var name = parts[2];
1245             patterns[cls][name] = new RegExp(val);
1246         });
1247     }
1248
1249     return service;
1250 }])
1251
1252 .controller('PatronRegCtrl',
1253        ['$scope','$routeParams','$q','$uibModal','$window','egCore',
1254         'patronSvc','patronRegSvc','egUnloadPrompt','egAlertDialog',
1255         'egWorkLog', '$timeout',
1256 function($scope , $routeParams , $q , $uibModal , $window , egCore ,
1257          patronSvc , patronRegSvc , egUnloadPrompt, egAlertDialog ,
1258          egWorkLog, $timeout) {
1259
1260     $scope.page_data_loaded = false;
1261     $scope.hold_notify_type = { phone : null, email : null, sms : null };
1262     $scope.hold_notify_observer = {};
1263     $scope.hold_rel_contacts = {};
1264     $scope.clone_id = patronRegSvc.clone_id = $routeParams.clone_id;
1265     $scope.stage_username =
1266         patronRegSvc.stage_username = $routeParams.stage_username;
1267     $scope.patron_id =
1268         patronRegSvc.patron_id = $routeParams.edit_id || $routeParams.id;
1269
1270     // for existing patrons, disable barcode input by default
1271     $scope.disable_bc = $scope.focus_usrname = Boolean($scope.patron_id);
1272     $scope.focus_bc = !Boolean($scope.patron_id);
1273     $scope.address_alerts = [];
1274     $scope.dupe_counts = {};
1275
1276     // map of perm name to true/false for perms the logged in user
1277     // has at the currently selected patron home org unit.
1278     $scope.perms = {};
1279
1280     $scope.name_tab = 'primary';
1281
1282     if (!$scope.edit_passthru) {
1283         // in edit more, scope.edit_passthru is delivered to us by
1284         // the enclosing controller.  In register mode, there is
1285         // no enclosing controller, so we create our own.
1286         $scope.edit_passthru = {};
1287     }
1288
1289     // 0=all, 1=suggested, 2=all
1290     $scope.edit_passthru.vis_level = 0;
1291
1292     // Apply default values for new patrons during initial registration
1293     // prs is shorthand for patronSvc
1294     function set_new_patron_defaults(prs) {
1295         if (!$scope.patron.passwd) {
1296             // passsword may originate from staged user.
1297             $scope.generate_password();
1298         }
1299         $scope.hold_notify_type.phone = true;
1300         $scope.hold_notify_type.email = true;
1301         $scope.hold_notify_type.sms = false;
1302
1303         // staged users may be loaded w/ a profile.
1304         $scope.set_expire_date();
1305
1306         if (prs.org_settings['ui.patron.default_ident_type']) {
1307             // $scope.patron needs this field to be an object
1308             var id = prs.org_settings['ui.patron.default_ident_type'];
1309             var ident_type = $scope.ident_types.filter(
1310                 function(type) { return type.id() == id })[0];
1311             $scope.patron.ident_type = ident_type;
1312         }
1313         if (prs.org_settings['ui.patron.default_inet_access_level']) {
1314             // $scope.patron needs this field to be an object
1315             var id = prs.org_settings['ui.patron.default_inet_access_level'];
1316             var level = $scope.net_access_levels.filter(
1317                 function(lvl) { return lvl.id() == id })[0];
1318             $scope.patron.net_access_level = level;
1319         }
1320         if (prs.org_settings['ui.patron.default_country']) {
1321             $scope.patron.addresses[0].country =
1322                 prs.org_settings['ui.patron.default_country'];
1323         }
1324     }
1325
1326     // A null or undefined pattern leads to exceptions.  Before the
1327     // patterns are loaded from the server, default all patterns
1328     // to an innocuous regex.  To avoid re-creating numerous
1329     // RegExp objects, cache the stub RegExp after initial creation.
1330     // note: angular docs say ng-pattern accepts a regexp or string,
1331     // but as of writing, it only works with a regexp object.
1332     // (Likely an angular 1.2 vs. 1.4 issue).
1333     var field_patterns = {au : {}, ac : {}, aua : {}};
1334     $scope.field_pattern = function(cls, field) {
1335         if (!field_patterns[cls][field])
1336             field_patterns[cls][field] = new RegExp('.*');
1337         return field_patterns[cls][field];
1338     }
1339
1340     // Main page load function.  Kicks off tab init and data loading.
1341     $q.all([
1342
1343         $scope.initTab ? // initTab comes from patron app
1344             $scope.initTab('edit', $routeParams.id) : $q.when(),
1345
1346         patronRegSvc.init(),
1347
1348     ]).then(function(){ return patronRegSvc.init_patron(patronSvc ? patronSvc.current : patronRegSvc.patron ) })
1349       .then(function(patron) {
1350         // called after initTab and patronRegSvc.init have completed
1351         // in standalone mode, we have no patronSvc
1352         var prs = patronRegSvc;
1353         $scope.patron = patron;
1354         $scope.field_doc = prs.field_doc;
1355         $scope.edit_profiles = prs.edit_profiles;
1356         $scope.edit_profile_entries = prs.edit_profile_entries;
1357         $scope.ident_types = prs.ident_types;
1358         $scope.net_access_levels = prs.net_access_levels;
1359         $scope.user_setting_types = prs.user_setting_types;
1360         $scope.opt_in_setting_types = prs.opt_in_setting_types;
1361         $scope.org_settings = prs.org_settings;
1362         $scope.sms_carriers = prs.sms_carriers;
1363         $scope.stat_cats = prs.stat_cats;
1364         $scope.surveys = prs.surveys;
1365         $scope.survey_responses = prs.survey_responses;
1366         $scope.stat_cat_entry_maps = prs.stat_cat_entry_maps;
1367         $scope.stage_user = prs.stage_user;
1368         $scope.stage_user_requestor = prs.stage_user_requestor;
1369
1370         $scope.user_settings = prs.user_settings;
1371         prs.user_settings = {};
1372
1373         // If a default pickup lib is applied to the patron, apply it
1374         // to the UI at page load time.  Otherwise, leave the value unset.
1375         if ($scope.user_settings['opac.default_pickup_location']) {
1376             $scope.patron._pickup_lib = egCore.org.get(
1377                 $scope.user_settings['opac.default_pickup_location']);
1378         }
1379
1380         extract_hold_notify();
1381
1382         if ($scope.patron.isnew)
1383             set_new_patron_defaults(prs);
1384
1385         $scope.handle_home_org_changed();
1386
1387         if ($scope.org_settings['ui.patron.edit.default_suggested'])
1388             $scope.edit_passthru.vis_level = 1;
1389
1390         // Stat cats are fetched from open-ils.storage, where 't'==1
1391         $scope.hasRequiredStatCat = prs.stat_cats.filter(
1392                 function(cat) {return cat.required() == 1} ).length > 0;
1393
1394         $scope.page_data_loaded = true;
1395
1396         prs.set_field_patterns(field_patterns);
1397         apply_username_regex();
1398
1399         add_date_watchers();
1400
1401         if ($scope.org_settings['ui.patron.edit.guardian_required_for_juv']) {
1402             add_juv_watcher();
1403         }
1404     });
1405
1406     function add_date_watchers() {
1407
1408         $scope.$watch('patron.dob', function(newVal, oldVal) {
1409             // Even though this runs after page data load, there
1410             // are still times when it fires unnecessarily.
1411             if (newVal === oldVal) return;
1412
1413             console.debug('dob change: ' + newVal + ' : ' + oldVal);
1414             maintain_juvenile_flag();
1415         });
1416
1417         // No need to watch expire_date
1418     }
1419
1420     function add_juv_watcher() {
1421         $scope.$watch('patron.juvenile', function(newVal, oldVal) {
1422             if (newVal === oldVal) return;
1423             if (newVal) {
1424                 field_visibility['au.guardian'] = 3; // required
1425             } else {
1426                 // Value will be reassessed by show_field()
1427                 delete field_visibility['au.guardian'];
1428             }
1429         });
1430     }
1431
1432     // add watchers for hold notify method prefs
1433     $scope.$watch('hold_notify_type.phone', function(newVal, oldVal) {
1434         var notifyOpt = $scope.hold_notify_observer['phone'];
1435         if (newVal !== null) {
1436             notifyOpt.newval = newVal;
1437         }
1438     });
1439
1440     $scope.$watch('hold_notify_type.sms', function(newVal, oldVal) {
1441         var notifyOpt = $scope.hold_notify_observer['sms'];
1442         if (newVal !== null) {
1443             notifyOpt.newval = newVal;
1444         }
1445     });
1446
1447     $scope.$watch('hold_notify_type.email', function(newVal, oldVal) {
1448         var notifyOpt = $scope.hold_notify_observer['email'];
1449         if (newVal !== null) {
1450             notifyOpt.newval = newVal;
1451         }
1452     });
1453
1454     // update the currently displayed field documentation
1455     $scope.set_selected_field_doc = function(cls, field) {
1456         $scope.selected_field_doc = $scope.field_doc[cls][field];
1457     }
1458
1459     // returns the tree depth of the selected profile group tree node.
1460     $scope.pgt_depth = function(grp) {
1461         var d = 0;
1462         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
1463         return d;
1464     }
1465
1466     // returns the tree depth of the selected profile group tree node.
1467     $scope.pgtde_depth = function(entry) {
1468         var d = 0;
1469         while (entry = egCore.env.pgtde.map[entry.parent()]) d++;
1470         return d;
1471     }
1472
1473     // IDL fields used for labels in the UI.
1474     $scope.idl_fields = {
1475         au  : egCore.idl.classes.au.field_map,
1476         ac  : egCore.idl.classes.ac.field_map,
1477         aua : egCore.idl.classes.aua.field_map
1478     };
1479
1480     // field visibility cache.  Some fields are universally required.
1481     // 3 == value universally required
1482     // 2 == field is visible by default
1483     // 1 == field is suggested by default
1484     var field_visibility = {};
1485     var default_field_visibility = {
1486         'ac.barcode' : 3,
1487         'au.usrname' : 3,
1488         'au.passwd' :  3,
1489         'au.first_given_name' : 3,
1490         'au.family_name' : 3,
1491         'au.pref_first_given_name' : 2,
1492         'au.pref_family_name' : 2,
1493         'au.ident_type' : 3,
1494         'au.ident_type2' : 2,
1495         'au.home_ou' : 3,
1496         'au.profile' : 3,
1497         'au.expire_date' : 3,
1498         'au.net_access_level' : 3,
1499         'aua.address_type' : 3,
1500         'aua.post_code' : 3,
1501         'aua.street1' : 3,
1502         'aua.street2' : 2,
1503         'aua.city' : 3,
1504         'aua.county' : 2,
1505         'aua.state' : 2,
1506         'aua.country' : 3,
1507         'aua.valid' : 2,
1508         'aua.within_city_limits' : 2,
1509         'stat_cats' : 1,
1510         'surveys' : 1,
1511         'au.name_keywords': 1
1512     };
1513
1514     // Returns true if the selected field should be visible
1515     // given the current required/suggested/all setting.
1516     // The visibility flag applied to each field as a result of calling
1517     // this function also sets (via the same flag) the requiredness state.
1518     $scope.show_field = function(field_key) {
1519         // org settings have not been received yet.
1520         if (!$scope.org_settings) return false;
1521
1522         if (field_visibility[field_key] == undefined) {
1523             // compile and cache the visibility for the selected field
1524
1525             // The preferred name fields use the primary name field settings
1526             var org_key = field_key;
1527             var alt_name = false;
1528             if (field_key.match(/^au.alt_/)) {
1529                 alt_name = true;
1530                 org_key = field_key.slice(7);
1531             }
1532
1533             var req_set = 'ui.patron.edit.' + org_key + '.require';
1534             var sho_set = 'ui.patron.edit.' + org_key + '.show';
1535             var sug_set = 'ui.patron.edit.' + org_key + '.suggest';
1536
1537             if ($scope.org_settings[req_set]) {
1538                 if (alt_name) {
1539                     // Avoid requiring alt name fields when primary
1540                     // name fields are required.
1541                     field_visibility[field_key] = 2;
1542                 } else {
1543                     field_visibility[field_key] = 3;
1544                 }
1545
1546             } else if ($scope.org_settings[sho_set]) {
1547                 field_visibility[field_key] = 2;
1548
1549             } else if ($scope.org_settings[sug_set]) {
1550                 field_visibility[field_key] = 1;
1551             }
1552         }
1553
1554         if (field_visibility[field_key] == undefined) {
1555             // No org settings were applied above.  Use the default
1556             // settings if present or assume the field has no
1557             // visibility flags applied.
1558             field_visibility[field_key] =
1559                 default_field_visibility[field_key] || 0;
1560         }
1561
1562         return field_visibility[field_key] >= $scope.edit_passthru.vis_level;
1563     }
1564
1565     // See $scope.show_field().
1566     // A field with visbility level 3 means it's required.
1567     $scope.field_required = function(cls, field) {
1568
1569         // Value in the password field is not required
1570         // for existing patrons.
1571         if (field == 'passwd' && $scope.patron && !$scope.patron.isnew)
1572           return false;
1573
1574         return (field_visibility[cls + '.' + field] == 3);
1575     }
1576
1577     // generates a random 4-digit password
1578     $scope.generate_password = function() {
1579         $scope.patron.passwd = Math.floor(Math.random()*9000) + 1000;
1580     }
1581
1582     $scope.set_expire_date = function() {
1583         if (!$scope.patron.profile) return;
1584         var seconds = egCore.date.intervalToSeconds(
1585             $scope.patron.profile.perm_interval());
1586         var now_epoch = new Date().getTime();
1587         $scope.patron.expire_date = new Date(
1588             now_epoch + (seconds * 1000 /* milliseconds */))
1589         $scope.field_modified();
1590     }
1591
1592     // grp is the pgt object
1593     $scope.set_profile = function(grp) {
1594         // If we can't save because of group perms or create/update perms
1595         if ($scope.edit_passthru.hide_save_actions()) return;
1596         $scope.patron.profile = grp;
1597         $scope.set_expire_date();
1598         $scope.field_modified();
1599     }
1600
1601     $scope.invalid_profile = function() {
1602         return !(
1603             $scope.patron &&
1604             $scope.patron.profile &&
1605             $scope.patron.profile.usergroup() == 't'
1606         );
1607     }
1608
1609     $scope.new_address = function() {
1610         var addr = egCore.idl.toHash(new egCore.idl.aua());
1611         patronRegSvc.ingest_address($scope.patron, addr);
1612         addr.id = patronRegSvc.virt_id--;
1613         addr.isnew = true;
1614         addr.valid = true;
1615         addr.within_city_limits = true;
1616         addr.country = $scope.org_settings['ui.patron.default_country'];
1617         $scope.patron.addresses.push(addr);
1618     }
1619
1620     // keep deleted addresses out of the patron object so
1621     // they won't appear in the UI.  They'll be re-inserted
1622     // when the patron is updated.
1623     deleted_addresses = [];
1624     $scope.delete_address = function(id) {
1625
1626         if ($scope.patron.isnew &&
1627             $scope.patron.addresses.length == 1 &&
1628             $scope.org_settings['ui.patron.registration.require_address']) {
1629             egAlertDialog.open(egCore.strings.REG_ADDR_REQUIRED);
1630             return;
1631         }
1632
1633         var addresses = [];
1634         angular.forEach($scope.patron.addresses, function(addr) {
1635             if (addr.id == id) {
1636                 if (id > 0) {
1637                     addr.isdeleted = true;
1638                     deleted_addresses.push(addr);
1639                 }
1640             } else {
1641                 addresses.push(addr);
1642             }
1643         });
1644         $scope.patron.addresses = addresses;
1645     }
1646
1647     $scope.approve_pending_address = function(addr) {
1648
1649         egCore.net.request(
1650             'open-ils.actor',
1651             'open-ils.actor.user.pending_address.approve',
1652             egCore.auth.token(), addr.id
1653         ).then(function(replaced_id) {
1654             var evt = egCore.evt.parse(replaced_id);
1655             if (evt) { alert(evt); return; }
1656
1657             // Remove the pending address and the replaced address
1658             // from the local list of patron addresses.
1659             var addresses = [];
1660             angular.forEach($scope.patron.addresses, function(a) {
1661                 if (a.id != addr.id && a.id != replaced_id) {
1662                     addresses.push(a);
1663                 }
1664             });
1665             $scope.patron.addresses = addresses;
1666
1667             // Fetch a fresh copy of the modified address from the server.
1668             // and add it back to the list.
1669             egCore.pcrud.retrieve('aua', replaced_id, {}, {authoritative: true})
1670             .then(null, null, function(new_addr) {
1671                 new_addr = egCore.idl.toHash(new_addr);
1672                 patronRegSvc.ingest_address($scope.patron, new_addr);
1673                 $scope.patron.addresses.push(new_addr);
1674             });
1675         });
1676     }
1677
1678     $scope.post_code_changed = function(addr) {
1679         egCore.net.request(
1680             'open-ils.search', 'open-ils.search.zip', addr.post_code)
1681         .then(function(resp) {
1682             if (!resp) return;
1683             if (resp.city) addr.city = resp.city;
1684             if (resp.state) addr.state = resp.state;
1685             if (resp.county) addr.county = resp.county;
1686             if (resp.alert) alert(resp.alert);
1687         });
1688     }
1689
1690     $scope.new_waiver_entry = function() {
1691         var waiver = egCore.idl.toHash(new egCore.idl.aupw());
1692         patronRegSvc.ingest_waiver_entry($scope.patron, waiver);
1693         waiver.id = patronRegSvc.virt_id--;
1694         waiver.isnew = true;
1695         $scope.patron.waiver_entries.push(waiver);
1696     }
1697
1698     deleted_waiver_entries = [];
1699     $scope.delete_waiver_entry = function(waiver_entry) {
1700         if (waiver_entry.id > 0) {
1701             waiver_entry.isdeleted = true;
1702             deleted_waiver_entries.push(waiver_entry);
1703         }
1704         var index = $scope.patron.waiver_entries.indexOf(waiver_entry);
1705         $scope.patron.waiver_entries.splice(index, 1);
1706     }
1707
1708     $scope.replace_card = function() {
1709         $scope.patron.card.active = false;
1710         $scope.patron.card.ischanged = true;
1711         $scope.disable_bc = false;
1712
1713         var new_card = egCore.idl.toHash(new egCore.idl.ac());
1714         new_card.id = patronRegSvc.virt_id--;
1715         new_card.isnew = true;
1716         new_card.active = true;
1717         new_card._primary = 'on';
1718         $scope.patron.card = new_card;
1719
1720         // Remove any previous attempts to replace the card, since they
1721         // may be incomplete or created by accident.
1722         $scope.patron.cards =
1723             $scope.patron.cards.filter(function(c) {return !c.isnew})
1724         $scope.patron.cards.push(new_card);
1725     }
1726
1727     $scope.day_phone_changed = function(phone) {
1728         if (phone && $scope.patron.isnew &&
1729             $scope.org_settings['patron.password.use_phone']) {
1730             $scope.patron.passwd = phone.substr(-4);
1731         }
1732     }
1733
1734     $scope.barcode_changed = function(bc) {
1735         if (!bc) return;
1736         $scope.dupe_barcode = false;
1737         egCore.net.request(
1738             'open-ils.actor',
1739             'open-ils.actor.barcode.exists',
1740             egCore.auth.token(), bc
1741         ).then(function(resp) {
1742             if (resp == '1') { // duplicate card
1743                 $scope.dupe_barcode = true;
1744                 console.log('duplicate barcode detected: ' + bc);
1745             } else {
1746                 if (!$scope.patron.usrname)
1747                     $scope.patron.usrname = bc;
1748                 // No dupe -- A-OK
1749             }
1750         });
1751     }
1752
1753     $scope.cards_dialog = function() {
1754         $uibModal.open({
1755             templateUrl: './circ/patron/t_patron_cards_dialog',
1756             backdrop: 'static',
1757             controller:
1758                    ['$scope','$uibModalInstance','cards','perms','patron',
1759             function($scope , $uibModalInstance , cards , perms , patron) {
1760                 // scope here is the modal-level scope
1761                 $scope.args = {cards : cards, primary_barcode : null};
1762                 angular.forEach(cards, function(card) {
1763                     if (card.id == patron.card.id) {
1764                         $scope.args.primary_barcode = card.id;
1765                     }
1766                 });
1767                 $scope.perms = perms;
1768                 $scope.ok = function() { $uibModalInstance.close($scope.args) }
1769                 $scope.cancel = function () { $uibModalInstance.dismiss() }
1770             }],
1771             resolve : {
1772                 cards : function() {
1773                     // scope here is the controller-level scope
1774                     return $scope.patron.cards;
1775                 },
1776                 perms : function() {
1777                     return $scope.perms;
1778                 },
1779                 patron : function() {
1780                     return $scope.patron;
1781                 }
1782             }
1783         }).result.then(
1784             function(args) {
1785                 angular.forEach(args.cards, function(card) {
1786                     card.ischanged = true; // assume cards need updating, OK?
1787                     if (card.id == args.primary_barcode) {
1788                         $scope.patron.card = card;
1789                         card._primary = true;
1790                     } else {
1791                         card._primary = false;
1792                     }
1793                 });
1794             }
1795         );
1796     }
1797
1798     $scope.set_addr_type = function(addr, type) {
1799         var addrs = $scope.patron.addresses;
1800         if (addr['_is_'+type]) {
1801             angular.forEach(addrs, function(a) {
1802                 if (a.id != addr.id) a['_is_'+type] = false;
1803             });
1804         } else {
1805             // unchecking mailing/billing means we have to randomly
1806             // select another address to fill that role.  Select the
1807             // first address in the list (that does not match the
1808             // modifed address)
1809             for (var i = 0; i < addrs.length; i++) {
1810                 if (addrs[i].id != addr.id) {
1811                     addrs[i]['_is_' + type] = true;
1812                     break;
1813                 }
1814             }
1815         }
1816     }
1817
1818
1819     // Translate hold notify preferences from the form/scope back into a
1820     // single user setting value for opac.hold_notify.
1821     function compress_hold_notify() {
1822         var hold_notify_methods = [];
1823         if ($scope.hold_notify_type.phone) {
1824             hold_notify_methods.push('phone');
1825         }
1826         if ($scope.hold_notify_type.email) {
1827             hold_notify_methods.push('email');
1828         }
1829         if ($scope.hold_notify_type.sms) {
1830             hold_notify_methods.push('sms');
1831         }
1832
1833         $scope.user_settings['opac.hold_notify'] = hold_notify_methods.join(':');
1834     }
1835
1836     // dialog for selecting additional permission groups
1837     $scope.secondary_groups_dialog = function() {
1838         $uibModal.open({
1839             templateUrl: './circ/patron/t_patron_groups_dialog',
1840             backdrop: 'static',
1841             controller:
1842                    ['$scope','$uibModalInstance','linked_groups','pgt_depth',
1843             function($scope , $uibModalInstance , linked_groups , pgt_depth) {
1844
1845                 $scope.pgt_depth = pgt_depth;
1846                 $scope.args = {
1847                     linked_groups : linked_groups,
1848                     edit_profiles : patronRegSvc.edit_profiles,
1849                     new_profile   : patronRegSvc.edit_profiles[0]
1850                 };
1851
1852                 // add a new group to the linked groups list
1853                 $scope.link_group = function($event, grp) {
1854                     var found = false; // avoid duplicates
1855                     angular.forEach($scope.args.linked_groups,
1856                         function(g) {if (g.id() == grp.id()) found = true});
1857                     if (!found) $scope.args.linked_groups.push(grp);
1858                     $event.preventDefault(); // avoid close
1859                 }
1860
1861                 // remove a group from the linked groups list
1862                 $scope.unlink_group = function($event, grp) {
1863                     $scope.args.linked_groups =
1864                         $scope.args.linked_groups.filter(function(g) {
1865                         return g.id() != grp.id()
1866                     });
1867                     $event.preventDefault(); // avoid close
1868                 }
1869
1870                 $scope.ok = function() { $uibModalInstance.close($scope.args) }
1871                 $scope.cancel = function () { $uibModalInstance.dismiss() }
1872             }],
1873             resolve : {
1874                 linked_groups : function() { return $scope.patron.groups },
1875                 pgt_depth : function() { return $scope.pgt_depth }
1876             }
1877         }).result.then(
1878             function(args) {
1879
1880                 if ($scope.patron.isnew) {
1881                     // groups must be linked for new patrons after the
1882                     // patron is created.
1883                     $scope.patron.groups = args.linked_groups;
1884                     return;
1885                 }
1886
1887                 // update links groups for existing users in real time.
1888                 var ids = args.linked_groups.map(function(g) {return g.id()});
1889                 patronRegSvc.apply_secondary_groups($scope.patron.id, ids)
1890                 .then(function(success) {
1891                     if (success)
1892                         $scope.patron.groups = args.linked_groups;
1893                 });
1894             }
1895         );
1896     }
1897
1898     function extract_hold_notify() {
1899         var p = $scope.patron;
1900         var notify = $scope.user_settings['opac.hold_notify'];
1901
1902         if (!notify && !(notify === '')) {
1903             $scope.hold_notify_type.phone = true;
1904             $scope.hold_notify_type.email = true;
1905             return;
1906         }
1907
1908         $scope.hold_notify_type.phone = Boolean(notify.match(/phone/));
1909         $scope.hold_notify_type.email = Boolean(notify.match(/email/));
1910         $scope.hold_notify_type.sms = Boolean(notify.match(/sms/));
1911
1912         // stores original loaded values for comparison later
1913         for (var k in $scope.hold_notify_type){
1914             var val = $scope.hold_notify_type[k];
1915
1916             if ($scope.hold_notify_type.hasOwnProperty(k)){
1917                 $scope.hold_notify_observer[k] = {old : val, newval: null};
1918             }
1919         }
1920
1921         // actual value from user
1922         $scope.hold_rel_contacts.day_phone = { old: p.day_phone, newval : null };
1923         $scope.hold_rel_contacts.other_phone = { old: p.other_phone, newval : null };
1924         $scope.hold_rel_contacts.evening_phone = { old: p.evening_phone, newval : null };
1925         // from user_settings
1926         $scope.hold_rel_contacts.default_phone = { old: $scope.user_settings['opac.default_phone'], newval : null };
1927         $scope.hold_rel_contacts.default_sms = { old: $scope.user_settings['opac.default_sms_notify'], newval : null };
1928         $scope.hold_rel_contacts.default_sms_carrier_id = { old: $scope.user_settings['opac.default_sms_carrier'], newval : null };
1929
1930     }
1931
1932     function normalizePhone(number){
1933         // normalize phone # for comparison, only digits
1934         if (number == null || number == undefined) return '';
1935
1936         var regex = /[^\d]/g;
1937         return number.replace(regex, '');
1938     }
1939
1940     $scope.invalidate_field = function(field) {
1941         patronRegSvc.invalidate_field($scope.patron, field).then(function() {
1942             $scope.handle_field_changed($scope.patron, field);
1943         });
1944     }
1945
1946     address_alert = function(addr) {
1947         var args = {
1948             street1: addr.street1,
1949             street2: addr.street2,
1950             city: addr.city,
1951             state: addr.state,
1952             county: addr.county,
1953             country: addr.country,
1954             post_code: addr.post_code,
1955             mailing_address: addr._is_mailing,
1956             billing_address: addr._is_billing
1957         }
1958
1959         egCore.net.request(
1960             'open-ils.actor',
1961             'open-ils.actor.address_alert.test',
1962             egCore.auth.token(), egCore.auth.user().ws_ou(), args
1963             ).then(function(res) {
1964                 $scope.address_alerts = res;
1965         });
1966     }
1967
1968     $scope.dupe_value_changed = function(type, value) {
1969         if (!$scope.dupe_search_encoded)
1970             $scope.dupe_search_encoded = {};
1971
1972         $scope.dupe_counts[type] = 0;
1973
1974         patronRegSvc.dupe_patron_search($scope.patron, type, value)
1975         .then(function(res) {
1976             $scope.dupe_counts[type] = res.count;
1977             if (res.count) {
1978                 $scope.dupe_search_encoded[type] =
1979                     encodeURIComponent(js2JSON(res.search));
1980             } else {
1981                 $scope.dupe_search_encoded[type] = '';
1982             }
1983         });
1984     }
1985
1986     $scope.handle_home_org_changed = function() {
1987         org_id = $scope.patron.home_ou.id();
1988         patronRegSvc.has_perms_for_org(org_id).then(function(map) {
1989             angular.forEach(map, function(v, k) { $scope.perms[k] = v });
1990         });
1991     }
1992
1993     $scope.handle_pulib_changed = function(org) {
1994         if (!$scope.user_settings) return; // still rendering
1995         $scope.user_settings['opac.default_pickup_location'] = org.id();
1996     }
1997
1998     // This is called with every character typed in a form field,
1999     // since that's the only way to gaurantee something has changed.
2000     // See handle_field_changed for ng-change vs. ng-blur.
2001     $scope.field_modified = function() {
2002         // Call attach with every field change, regardless of whether
2003         // it's been called before.  This will allow for re-attach after
2004         // the user clicks through the unload warning. egUnloadPrompt
2005         // will ensure we only attach once.
2006         egUnloadPrompt.attach($scope);
2007     }
2008
2009     // also monitor when form is changed *by the user*, as using
2010     // an ng-change handler doesn't work with eg-date-input
2011     $scope.$watch('reg_form.$pristine', function(newVal, oldVal) {
2012         if (!newVal) egUnloadPrompt.attach($scope);
2013     });
2014
2015     // username regex (if present) must be removed any time
2016     // the username matches the barcode to avoid firing the
2017     // invalid field handlers.
2018     function apply_username_regex() {
2019         var regex = $scope.org_settings['opac.username_regex'];
2020         if (regex) {
2021             if ($scope.patron.card.barcode) {
2022                 // username must match the regex or the barcode
2023                 field_patterns.au.usrname =
2024                     new RegExp(
2025                         regex + '|^' + $scope.patron.card.barcode + '$');
2026             } else {
2027                 // username must match the regex
2028                 field_patterns.au.usrname = new RegExp(regex);
2029             }
2030         } else {
2031             // username can be any format.
2032             field_patterns.au.usrname = new RegExp('.*');
2033         }
2034     }
2035
2036     // obj could be the patron, an address, etc.
2037     // This is called any time a form field achieves then loses focus.
2038     // It does not necessarily mean the field has changed.
2039     // The alternative is ng-change, but it's called with each character
2040     // typed, which would be overkill for many of the actions called here.
2041     $scope.handle_field_changed = function(obj, field_name) {
2042         var cls = obj.classname; // set by egIdl
2043         var value = obj[field_name];
2044
2045         console.debug('changing field ' + field_name + ' to ' + value);
2046
2047         switch (field_name) {
2048             case 'day_phone' :
2049                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.day_phone.old)){
2050                     $scope.hold_rel_contacts.day_phone.newval = value;
2051                 }
2052                 if ($scope.patron.day_phone &&
2053                     $scope.patron.isnew &&
2054                     $scope.org_settings['patron.password.use_phone']) {
2055                     $scope.patron.passwd = $scope.patron.day_phone.substr(-4);
2056                 }
2057                 $scope.dupe_value_changed(field_name, value);
2058                 break;
2059             case 'evening_phone' :
2060                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.evening_phone.old)){
2061                     $scope.hold_rel_contacts.evening_phone.newval = value;
2062                 }
2063                 $scope.dupe_value_changed(field_name, value);
2064                 break;
2065             case 'other_phone' :
2066                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.other_phone.old)){
2067                     $scope.hold_rel_contacts.other_phone.newval = value;
2068                 }
2069                 $scope.dupe_value_changed(field_name, value);
2070                 break;
2071             case 'ident_value':
2072             case 'ident_value2':
2073                 $scope.dupe_value_changed('ident', value);
2074                 break;
2075
2076             case 'first_given_name':
2077             case 'family_name':
2078                 $scope.dupe_value_changed('name', value);
2079                 break;
2080
2081             case 'email':
2082                 $scope.dupe_value_changed('email', value);
2083                 break;
2084
2085             case 'street1':
2086             case 'street2':
2087             case 'city':
2088                 // dupe search on address wants the address object as the value.
2089                 $scope.dupe_value_changed('address', obj);
2090                 address_alert(obj);
2091                 break;
2092
2093             case 'post_code':
2094                 $scope.post_code_changed(obj);
2095                 break;
2096
2097             case 'usrname':
2098                 patronRegSvc.check_dupe_username(value)
2099                 .then(function(yes) {$scope.dupe_username = Boolean(yes)});
2100                 break;
2101
2102             case 'barcode':
2103                 // TODO: finish barcode_changed handler.
2104                 $scope.barcode_changed(value);
2105                 apply_username_regex();
2106                 break;
2107             case 'opac.default_phone':
2108                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.default_phone.old)){
2109                     $scope.hold_rel_contacts.default_phone.newval = value;
2110                 }
2111                 break;
2112             case 'opac.default_sms_notify':
2113                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.default_sms.old)){
2114                     $scope.hold_rel_contacts.default_sms.newval = value;
2115                 }
2116                 break;
2117             case 'opac.default_sms_carrier':
2118                 if (value !== $scope.hold_rel_contacts.default_sms_carrier_id.old){
2119                     $scope.hold_rel_contacts.default_sms_carrier_id.newval = value;
2120                 }
2121                 break;
2122         }
2123     }
2124
2125     // patron.juvenile is set to true if the user was born after
2126     function maintain_juvenile_flag() {
2127         if ( !($scope.patron && $scope.patron.dob) ) return;
2128
2129         var juv_interval =
2130             $scope.org_settings['global.juvenile_age_threshold']
2131             || '18 years';
2132
2133         var base = new Date();
2134
2135         base.setTime(base.getTime() -
2136             Number(egCore.date.intervalToSeconds(juv_interval) + '000'));
2137
2138         $scope.patron.juvenile = ($scope.patron.dob > base);
2139     }
2140
2141     // returns true (disable) for orgs that cannot have users.
2142     $scope.disable_home_org = function(org_id) {
2143         if (!org_id) return;
2144         var org = egCore.org.get(org_id);
2145         return (
2146             org &&
2147             org.ou_type() &&
2148             org.ou_type().can_have_users() == 'f'
2149         );
2150     }
2151
2152     // returns true (disable) for orgs that cannot have vols (for holds pickup)
2153     $scope.disable_pulib = function(org_id) {
2154         if (!org_id) return;
2155         return !egCore.org.CanHaveVolumes(org_id);
2156     }
2157
2158     // Returns true if attempting to edit self, but perms don't allow
2159     $scope.edit_passthru.self_edit_disallowed = function() {
2160         if ($scope.patron.id
2161             && $scope.patron.id == egCore.auth.user().id()
2162             && !$scope.perms.EDIT_SELF_IN_CLIENT
2163         ) return true;
2164         return false;
2165     }
2166
2167     // Returns true if attempting to edit a user without appropriate group application perms
2168     $scope.edit_passthru.group_edit_disallowed = function() {
2169         if ( $scope.patron.profile
2170              && patronRegSvc
2171                 .edit_profiles
2172                 .filter(function(p) {
2173                     return $scope.patron.profile.id() == p.id();
2174                 }).length == 0
2175         ) return true;
2176         return false;
2177     }
2178
2179     // Returns true if the Save and Save & Clone buttons should be disabled.
2180     $scope.edit_passthru.hide_save_actions = function() {
2181         if ($scope.edit_passthru.self_edit_disallowed()) return true;
2182         if ($scope.edit_passthru.group_edit_disallowed()) return true;
2183
2184         return $scope.patron.isnew ?
2185             !$scope.perms.CREATE_USER :
2186             !$scope.perms.UPDATE_USER;
2187     }
2188
2189     // Returns true if any input elements are tagged as invalid
2190     // via Angular patterns or required attributes.
2191     function form_has_invalid_fields() {
2192         return $('#patron-reg-container .ng-invalid').length > 0;
2193     }
2194
2195     function form_is_incomplete() {
2196         return (
2197             $scope.dupe_username ||
2198             $scope.dupe_barcode ||
2199             form_has_invalid_fields()
2200         );
2201
2202     }
2203
2204     $scope.edit_passthru.save = function(save_args) {
2205         if (!save_args) save_args = {};
2206
2207         if (form_is_incomplete()) {
2208             // User has not provided valid values for all required fields.
2209             return egAlertDialog.open(egCore.strings.REG_INVALID_FIELDS);
2210         }
2211
2212         // remove page unload warning prompt
2213         egUnloadPrompt.clear();
2214
2215         // toss the deleted addresses back into the patron's list of
2216         // addresses so it's included in the update
2217         $scope.patron.addresses =
2218             $scope.patron.addresses.concat(deleted_addresses);
2219
2220         // ditto for waiver entries
2221         $scope.patron.waiver_entries =
2222             $scope.patron.waiver_entries.concat(deleted_waiver_entries);
2223
2224         compress_hold_notify();
2225
2226         var updated_user;
2227
2228         patronRegSvc.save_user($scope.patron)
2229         .then(function(new_user) {
2230             if (new_user && new_user.classname) {
2231                 updated_user = new_user;
2232                 return patronRegSvc.save_user_settings(
2233                     new_user, $scope.user_settings);
2234             } else {
2235                 var evt = egCore.evt.parse(new_user);
2236
2237                 if (evt && evt.textcode == 'XACT_COLLISION') {
2238                     return egAlertDialog.open(
2239                         egCore.strings.PATRON_EDIT_COLLISION).result;
2240                 }
2241
2242                 // debug only -- should not get here.
2243                 alert('Patron update failed. \n\n' + js2JSON(new_user));
2244             }
2245
2246         }).then(function() {
2247
2248             // only remove the staged user if the update succeeded.
2249             if (updated_user)
2250                 return patronRegSvc.remove_staged_user();
2251
2252             return $q.when();
2253
2254         }).then(function() {
2255
2256             // linked groups for new users must be created after the new
2257             // user is created.
2258             if ($scope.patron.isnew &&
2259                 $scope.patron.groups && $scope.patron.groups.length) {
2260                 var ids = $scope.patron.groups.map(function(g) {return g.id()});
2261                 return patronRegSvc.apply_secondary_groups(updated_user.id(), ids)
2262             }
2263             return $q.when();
2264
2265         }).then(findChangedFieldsAffectedHolds)
2266         .then(function(changed_fields_plus_holds) {
2267             var needModal = changed_fields_plus_holds[0] && changed_fields_plus_holds[0].length > 0;
2268             return needModal
2269                 ? $scope.update_holds_notify_modal(changed_fields_plus_holds[0])
2270                 : $q.when(); // nothing changed, continue
2271         }).then(function() {
2272             if (updated_user) {
2273                 egWorkLog.record(
2274                     $scope.patron.isnew
2275                     ? egCore.strings.EG_WORK_LOG_REGISTERED_PATRON
2276                     : egCore.strings.EG_WORK_LOG_EDITED_PATRON, {
2277                         'action' : $scope.patron.isnew ? 'registered_patron' : 'edited_patron',
2278                         'patron_id' : updated_user.id()
2279                     }
2280                 );
2281             }
2282
2283             // reloading the page means potentially losing some information
2284             // (e.g. last patron search), but is the only way to ensure all
2285             // components are properly updated to reflect the modified patron.
2286             if (updated_user && save_args.clone) {
2287                 // open a separate tab for registering a new
2288                 // patron from our cloned data.
2289                 var url = 'https://'
2290                     + $window.location.hostname
2291                     + egCore.env.basePath
2292                     + '/circ/patron/register/clone/'
2293                     + updated_user.id();
2294                 $window.open(url, '_blank').focus();
2295
2296             } else if ($window.location.href.indexOf('stage') > -1 ){
2297                 // we're here after deleting a self-reg staged user.
2298                 // Just close tab, since refresh won't find staged user
2299                 $timeout(function(){
2300                     if (typeof BroadcastChannel != 'undefined') {
2301                         var bChannel = new BroadcastChannel("eg.pending_usr.update");
2302                         bChannel.postMessage({
2303                             usr: egCore.idl.toHash(updated_user)
2304                         });
2305                     }
2306
2307                     $window.close();
2308                 });
2309             } else {
2310                 // reload the current page
2311                 $window.location.href = location.href;
2312             }
2313         });
2314     }
2315
2316     var phone_inputs = ["day_phone", "evening_phone","other_phone", "default_phone"];
2317     var sms_inputs = ["default_sms", "default_sms_carrier_id"];
2318     var method_prefs = ["sms_notify", "phone_notify", "email_notify"];
2319     var groupBy = function(xs, key){
2320         return xs.reduce(function(rv, x){
2321             (rv[x[key]] = rv[x[key]] || []).push(x);
2322             return rv;
2323         }, {});
2324     };
2325
2326     function findChangedFieldsAffectedHolds(){
2327
2328         var changed_hold_fields = [];
2329
2330         var default_phone_changed = false;
2331         var default_sms_carrier_changed = false;
2332         var default_sms_changed = false;
2333         for (var c in $scope.hold_rel_contacts){
2334             var newinput = $scope.hold_rel_contacts[c].newval;
2335             if ($scope.hold_rel_contacts.hasOwnProperty(c)
2336                 && newinput !== null // null means user has not provided a value in this session
2337                 && newinput != $scope.hold_rel_contacts[c].old){
2338                 var changed = $scope.hold_rel_contacts[c];
2339                 changed.name = c;
2340                 changed.isChecked = false;
2341                 changed_hold_fields.push(changed);
2342                 if (c === 'default_phone') default_phone_changed = true;
2343                 if (c === 'default_sms_carrier_id') default_sms_carrier_changed = true;
2344                 if (c === 'default_sms') default_sms_changed = true;
2345             }
2346         }
2347
2348         for (var c in $scope.hold_notify_observer){
2349             var newinput = $scope.hold_notify_observer[c].newval;
2350             if ($scope.hold_notify_observer.hasOwnProperty(c)
2351                 && newinput !== null // null means user has not provided a value in this session
2352                 && newinput != $scope.hold_notify_observer[c].old){
2353                 var changed = $scope.hold_notify_observer[c];
2354                 changed.name = c + "_notify";
2355                 changed.isChecked = false;
2356                 changed_hold_fields.push(changed);
2357
2358                 // if we're turning on phone notifications, offer to update to the
2359                 // current default number
2360                 if (c === 'phone' && $scope.user_settings['opac.default_phone'] && newinput && !default_phone_changed) {
2361                     changed_hold_fields.push({
2362                         name: 'default_phone',
2363                         old: 'nosuch',
2364                         newval: $scope.user_settings['opac.default_phone'],
2365                         isChecked: false
2366                     });
2367                 }
2368                 // and similarly for SMS
2369                 if (c === 'sms' && $scope.user_settings['opac.default_sms_carrier'] && newinput && !default_sms_carrier_changed) {
2370                     changed_hold_fields.push({
2371                         name: 'default_sms_carrier_id',
2372                         old: -1,
2373                         newval: $scope.user_settings['opac.default_sms_carrier'],
2374                         isChecked: false
2375                     });
2376                 }
2377                 if (c === 'sms' && $scope.user_settings['opac.default_sms_notify'] && newinput && !default_sms_changed) {
2378                     changed_hold_fields.push({
2379                         name: 'default_sms',
2380                         old: 'nosuch',
2381                         newval: $scope.user_settings['opac.default_sms_notify'],
2382                         isChecked: false
2383                     });
2384                 }
2385             }
2386         }
2387
2388         var promises = [];
2389         angular.forEach(changed_hold_fields, function(c){
2390             promises.push(egCore.net.request('open-ils.circ',
2391             'open-ils.circ.holds.retrieve_by_notify_staff',
2392             egCore.auth.token(),
2393             $scope.patron.id,
2394             c.name.includes('notify') || c.name.includes('carrier') ? c.old : c.newval,
2395             c.name)
2396                 .then(function(affected_holds){
2397                     if(!affected_holds || affected_holds.length < 1){
2398                         // no holds affected - remove change from list
2399                         var p = changed_hold_fields.indexOf(c);
2400                         changed_hold_fields.splice(p, 1);
2401                     } else {
2402                         c.affects = affected_holds;
2403                         //c.groups = {};
2404                         //angular.forEach(c.affects, function(h){
2405                         //    c.groups[]
2406                         //});
2407                         if (!c.name.includes("notify")){
2408                             if (c.name === "default_sms_carrier_id") {
2409                                 c.groups = groupBy(c.affects,'sms_carrier');
2410                             } else {
2411                                 c.groups = groupBy(c.affects, c.name.includes('_phone') ? 'phone_notify':'sms_notify');
2412                             }
2413                         }
2414                     }
2415                     return $q.when(changed_hold_fields);
2416                 })
2417             );
2418         });
2419
2420         return $q.all(promises);
2421     }
2422
2423     $scope.update_holds_notify_modal = function(changed_hold_fields){
2424         // open modal after-save, pre-reload modal to deal with updated hold notification stuff
2425         if ($scope.patron.isnew || changed_hold_fields.length < 1){
2426             return $q.when();
2427         }
2428
2429         return $uibModal.open({
2430             templateUrl: './circ/patron/t_hold_notify_update',
2431             backdrop: 'static',
2432             controller:
2433                        ['$scope','$uibModalInstance','changed_fields','patron','carriers','def_carrier_id','default_phone','default_sms',
2434                 function($scope , $uibModalInstance , changed_fields , patron,  carriers,  def_carrier_id , default_phone , default_sms) {
2435                 // local modal scope
2436                 $scope.ch_fields = changed_fields;
2437                 $scope.focusMe = true;
2438                 $scope.ok = function(msg) {
2439
2440                     // Need to do this so the page will reload automatically
2441                     if (msg == 'no-update') return $uibModalInstance.close();
2442
2443                     //var selectedChanges = $scope.changed_fields.filter(function(c) {
2444                     //    return c.isChecked;
2445                     //});
2446                     var selectedChanges = [];
2447                     angular.forEach($scope.ch_fields, function(f){
2448                         if (f.name == 'phone_notify' && f.newval && f.isChecked) {
2449                             // convert to default_phone change
2450                             f.sel_hids = f.affects.map(function(h){ return h.id});
2451                             f.newval = default_phone;
2452                             f.name = 'default_phone';
2453                             selectedChanges.push(f);
2454                         } else if (f.name == 'sms_notify' && f.newval && f.isChecked) {
2455                             // convert to default_sms change
2456                             f.sel_hids = f.affects.map(function(h){ return h.id});
2457                             f.newval = default_sms;
2458                             f.name = 'default_sms';
2459                             selectedChanges.push(f);
2460                         } else if (f.name.includes('notify') || f.name.includes('carrier')){
2461                             if (f.isChecked){
2462                                 f.sel_hids = f.affects.map(function(h){ return h.id});
2463                                 selectedChanges.push(f);
2464                             }
2465                         } else {
2466                             // this is the sms or phone, so look in the groups obj
2467                             f.sel_hids = [];
2468                             for (var k in f.groups){
2469                                 if (f.groups.hasOwnProperty(k)){
2470                                     var sel_holds = f.groups[k].filter(function(h){
2471                                         return h.isChecked;
2472                                     });
2473
2474                                     var hids = sel_holds.map(function(h){ return h.id});
2475                                     f.sel_hids.push.apply(f.sel_hids, hids);
2476                                 }
2477                             }
2478
2479                             if (f.sel_hids.length > 0) selectedChanges.push(f);
2480                         }
2481                     });
2482
2483
2484                     // call method to update holds for each change
2485                     var chain = $q.when();
2486                     angular.forEach(selectedChanges, function(c){
2487                         var carrierId = c.name.includes('default_sms') ? Number(def_carrier_id) : null;
2488                         chain = chain.then(function() {
2489                             return egCore.net.request('open-ils.circ',
2490                                     'open-ils.circ.holds.batch_update_holds_by_notify_staff', egCore.auth.token(),
2491                                     patron.id,
2492                                     c.sel_hids,
2493                                     c.old, // TODO: for number changes, old val is effectively moot
2494                                     c.newval,
2495                                     c.name,
2496                                     carrierId).then(function(okList){ console.log(okList) });
2497                         });
2498                     });
2499
2500                     // carry out the updates and close modal
2501                     chain.finally(function(){ $uibModalInstance.close() });
2502                 }
2503
2504                 $scope.cancel = function () { $uibModalInstance.dismiss() }
2505
2506                 $scope.isNumberCh = function(c){
2507                     return !(c.name.includes('notify') || c.name.includes('carrier'));
2508                 }
2509
2510                 $scope.chgCt = 0;
2511                 $scope.groupChanged = function(ch_f, grpK){
2512                     var holdArr = ch_f.groups[grpK];
2513                     if (holdArr && holdArr.length > 0){
2514                         angular.forEach(holdArr, function(h){
2515                             if (h.isChecked) { h.isChecked = !h.isChecked; $scope.chgCt-- }
2516                             else { h.isChecked = true; $scope.chgCt++ }
2517                         });
2518                     }
2519                 }
2520
2521                 $scope.nonGrpChanged = function(field_ch){
2522                     if (field_ch.isChecked) $scope.chgCt++;
2523                     else $scope.chgCt--;
2524                 };
2525
2526                 // use this function as a keydown handler on form
2527                 // elements that should not submit the form on enter.
2528                 $scope.preventSubmit = function($event) {
2529                     if ($event.keyCode == 13)
2530                         $event.preventDefault();
2531                 }
2532
2533                 $scope.prettyCarrier = function(carrierId){
2534                     var sms_carrierObj = carriers.find(function(c){ return c.id == carrierId});
2535                     return sms_carrierObj.name;
2536                 };
2537                 $scope.prettyBool = function(v){
2538                     return v ? 'YES' : 'NO';
2539                 };
2540             }],
2541             resolve : {
2542                     changed_fields : function(){ return changed_hold_fields },
2543                     patron : function(){ return $scope.patron },
2544                     def_carrier_id : function(){
2545                                        var d = $scope.hold_rel_contacts.default_sms_carrier_id;
2546                                        return d.newval ? d.newval : d.old;
2547                                     },
2548                     default_phone : function() {
2549                                         return ($scope.hold_rel_contacts.default_phone.newval) ?
2550                                                     $scope.hold_rel_contacts.default_phone.newval :
2551                                                     $scope.hold_rel_contacts.default_phone.old;
2552                                     },
2553                     default_sms : function() {
2554                                         return ($scope.hold_rel_contacts.default_sms.newval) ?
2555                                                     $scope.hold_rel_contacts.default_sms.newval :
2556                                                     $scope.hold_rel_contacts.default_sms.old;
2557                                     },
2558                     carriers : function(){ return $scope.sms_carriers.map(function(c){ return egCore.idl.toHash(c) }) }
2559                 }
2560         }).result;
2561     }
2562
2563     $scope.edit_passthru.print = function() {
2564         var print_data = {patron : $scope.patron}
2565
2566         return egCore.print.print({
2567             context : 'default',
2568             template : 'patron_data',
2569             scope : print_data
2570         });
2571     }
2572 }])