]> git.evergreen-ils.org Git - Evergreen.git/blob - Open-ILS/web/js/ui/default/staff/circ/patron/regctl.js
LP#1879993: use default value for opac.hold_notify when appropriate
[Evergreen.git] / 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
1300         var notify = 'phone:email'; // hard-coded default when opac.hold_notify has no reg_default
1301         var notify_stype = $scope.user_setting_types['opac.hold_notify'];
1302         if (notify_stype && notify_stype.reg_default() !== undefined && notify_stype.reg_default() !== null) {
1303             console.log('using default opac.hold_notify');
1304             notify = notify_stype.reg_default();
1305         }
1306         $scope.hold_notify_type.phone = Boolean(notify.match(/phone/));
1307         $scope.hold_notify_type.email = Boolean(notify.match(/email/));
1308         $scope.hold_notify_type.sms = Boolean(notify.match(/sms/));
1309
1310         // staged users may be loaded w/ a profile.
1311         $scope.set_expire_date();
1312
1313         if (prs.org_settings['ui.patron.default_ident_type']) {
1314             // $scope.patron needs this field to be an object
1315             var id = prs.org_settings['ui.patron.default_ident_type'];
1316             var ident_type = $scope.ident_types.filter(
1317                 function(type) { return type.id() == id })[0];
1318             $scope.patron.ident_type = ident_type;
1319         }
1320         if (prs.org_settings['ui.patron.default_inet_access_level']) {
1321             // $scope.patron needs this field to be an object
1322             var id = prs.org_settings['ui.patron.default_inet_access_level'];
1323             var level = $scope.net_access_levels.filter(
1324                 function(lvl) { return lvl.id() == id })[0];
1325             $scope.patron.net_access_level = level;
1326         }
1327         if (prs.org_settings['ui.patron.default_country']) {
1328             $scope.patron.addresses[0].country = 
1329                 prs.org_settings['ui.patron.default_country'];
1330         }
1331     }
1332
1333     // A null or undefined pattern leads to exceptions.  Before the
1334     // patterns are loaded from the server, default all patterns
1335     // to an innocuous regex.  To avoid re-creating numerous
1336     // RegExp objects, cache the stub RegExp after initial creation.
1337     // note: angular docs say ng-pattern accepts a regexp or string,
1338     // but as of writing, it only works with a regexp object.
1339     // (Likely an angular 1.2 vs. 1.4 issue).
1340     var field_patterns = {au : {}, ac : {}, aua : {}};
1341     $scope.field_pattern = function(cls, field) { 
1342         if (!field_patterns[cls][field])
1343             field_patterns[cls][field] = new RegExp('.*');
1344         return field_patterns[cls][field];
1345     }
1346
1347     // Main page load function.  Kicks off tab init and data loading.
1348     $q.all([
1349
1350         $scope.initTab ? // initTab comes from patron app
1351             $scope.initTab('edit', $routeParams.id) : $q.when(),
1352
1353         patronRegSvc.init(),
1354
1355     ]).then(function(){ return patronRegSvc.init_patron(patronSvc ? patronSvc.current : patronRegSvc.patron ) })
1356       .then(function(patron) {
1357         // called after initTab and patronRegSvc.init have completed
1358         // in standalone mode, we have no patronSvc
1359         var prs = patronRegSvc;
1360         $scope.patron = patron;
1361         $scope.field_doc = prs.field_doc;
1362         $scope.edit_profiles = prs.edit_profiles;
1363         $scope.edit_profile_entries = prs.edit_profile_entries;
1364         $scope.ident_types = prs.ident_types;
1365         $scope.net_access_levels = prs.net_access_levels;
1366         $scope.user_setting_types = prs.user_setting_types;
1367         $scope.opt_in_setting_types = prs.opt_in_setting_types;
1368         $scope.org_settings = prs.org_settings;
1369         $scope.sms_carriers = prs.sms_carriers;
1370         $scope.stat_cats = prs.stat_cats;
1371         $scope.surveys = prs.surveys;
1372         $scope.survey_responses = prs.survey_responses;
1373         $scope.stat_cat_entry_maps = prs.stat_cat_entry_maps;
1374         $scope.stage_user = prs.stage_user;
1375         $scope.stage_user_requestor = prs.stage_user_requestor;
1376
1377         $scope.user_settings = prs.user_settings;
1378         prs.user_settings = {};
1379
1380         // If a default pickup lib is applied to the patron, apply it 
1381         // to the UI at page load time.  Otherwise, leave the value unset.
1382         if ($scope.user_settings['opac.default_pickup_location']) {
1383             $scope.patron._pickup_lib = egCore.org.get(
1384                 $scope.user_settings['opac.default_pickup_location']);
1385         }
1386
1387         extract_hold_notify();
1388
1389         if ($scope.patron.isnew)
1390             set_new_patron_defaults(prs);
1391
1392         $scope.handle_home_org_changed();
1393
1394         if ($scope.org_settings['ui.patron.edit.default_suggested'])
1395             $scope.edit_passthru.vis_level = 1;
1396
1397         // Stat cats are fetched from open-ils.storage, where 't'==1
1398         $scope.hasRequiredStatCat = prs.stat_cats.filter(
1399                 function(cat) {return cat.required() == 1} ).length > 0;
1400
1401         $scope.page_data_loaded = true;
1402
1403         prs.set_field_patterns(field_patterns);
1404         apply_username_regex();
1405
1406         add_date_watchers();
1407
1408         if ($scope.org_settings['ui.patron.edit.guardian_required_for_juv']) {
1409             add_juv_watcher();
1410         }
1411     });
1412
1413     function add_date_watchers() {
1414
1415         $scope.$watch('patron.dob', function(newVal, oldVal) {
1416             // Even though this runs after page data load, there
1417             // are still times when it fires unnecessarily.
1418             if (newVal === oldVal) return;
1419
1420             console.debug('dob change: ' + newVal + ' : ' + oldVal);
1421             maintain_juvenile_flag();
1422         });
1423
1424         // No need to watch expire_date
1425     }
1426
1427     function add_juv_watcher() {
1428         $scope.$watch('patron.juvenile', function(newVal, oldVal) {
1429             if (newVal === oldVal) return;
1430             if (newVal) {
1431                 field_visibility['au.guardian'] = 3; // required
1432             } else {
1433                 // Value will be reassessed by show_field()
1434                 delete field_visibility['au.guardian'];
1435             }
1436         });
1437     }
1438     
1439     // add watchers for hold notify method prefs
1440     $scope.$watch('hold_notify_type.phone', function(newVal, oldVal) {
1441         var notifyOpt = $scope.hold_notify_observer['phone'];
1442         if (newVal !== null) {
1443             notifyOpt.newval = newVal;
1444         }
1445     });
1446
1447     $scope.$watch('hold_notify_type.sms', function(newVal, oldVal) {
1448         var notifyOpt = $scope.hold_notify_observer['sms'];
1449         if (newVal !== null) {
1450             notifyOpt.newval = newVal;
1451         }
1452     });
1453     
1454     $scope.$watch('hold_notify_type.email', function(newVal, oldVal) {
1455         var notifyOpt = $scope.hold_notify_observer['email'];
1456         if (newVal !== null) {
1457             notifyOpt.newval = newVal;
1458         }
1459     });
1460
1461     // update the currently displayed field documentation
1462     $scope.set_selected_field_doc = function(cls, field) {
1463         $scope.selected_field_doc = $scope.field_doc[cls][field];
1464     }
1465
1466     // returns the tree depth of the selected profile group tree node.
1467     $scope.pgt_depth = function(grp) {
1468         var d = 0;
1469         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
1470         return d;
1471     }
1472
1473     // returns the tree depth of the selected profile group tree node.
1474     $scope.pgtde_depth = function(entry) {
1475         var d = 0;
1476         while (entry = egCore.env.pgtde.map[entry.parent()]) d++;
1477         return d;
1478     }
1479
1480     // IDL fields used for labels in the UI.
1481     $scope.idl_fields = {
1482         au  : egCore.idl.classes.au.field_map,
1483         ac  : egCore.idl.classes.ac.field_map,
1484         aua : egCore.idl.classes.aua.field_map
1485     };
1486
1487     // field visibility cache.  Some fields are universally required.
1488     // 3 == value universally required
1489     // 2 == field is visible by default
1490     // 1 == field is suggested by default
1491     var field_visibility = {};
1492     var default_field_visibility = {
1493         'ac.barcode' : 3,
1494         'au.usrname' : 3,
1495         'au.passwd' :  3,
1496         'au.first_given_name' : 3,
1497         'au.family_name' : 3,
1498         'au.pref_first_given_name' : 2,
1499         'au.pref_family_name' : 2,
1500         'au.ident_type' : 3,
1501         'au.ident_type2' : 2,
1502         'au.home_ou' : 3,
1503         'au.profile' : 3,
1504         'au.expire_date' : 3,
1505         'au.net_access_level' : 3,
1506         'aua.address_type' : 3,
1507         'aua.post_code' : 3,
1508         'aua.street1' : 3,
1509         'aua.street2' : 2,
1510         'aua.city' : 3,
1511         'aua.county' : 2,
1512         'aua.state' : 2,
1513         'aua.country' : 3,
1514         'aua.valid' : 2,
1515         'aua.within_city_limits' : 2,
1516         'stat_cats' : 1,
1517         'surveys' : 1,
1518         'au.name_keywords': 1
1519     }; 
1520
1521     // Returns true if the selected field should be visible
1522     // given the current required/suggested/all setting.
1523     // The visibility flag applied to each field as a result of calling
1524     // this function also sets (via the same flag) the requiredness state.
1525     $scope.show_field = function(field_key) {
1526         // org settings have not been received yet.
1527         if (!$scope.org_settings) return false;
1528
1529         if (field_visibility[field_key] == undefined) {
1530             // compile and cache the visibility for the selected field
1531
1532             // The preferred name fields use the primary name field settings
1533             var org_key = field_key;
1534             var alt_name = false;
1535             if (field_key.match(/^au.alt_/)) {
1536                 alt_name = true;
1537                 org_key = field_key.slice(7);
1538             }
1539
1540             var req_set = 'ui.patron.edit.' + org_key + '.require';
1541             var sho_set = 'ui.patron.edit.' + org_key + '.show';
1542             var sug_set = 'ui.patron.edit.' + org_key + '.suggest';
1543
1544             if ($scope.org_settings[req_set]) {
1545                 if (alt_name) {
1546                     // Avoid requiring alt name fields when primary 
1547                     // name fields are required.
1548                     field_visibility[field_key] = 2;
1549                 } else {
1550                     field_visibility[field_key] = 3;
1551                 }
1552
1553             } else if ($scope.org_settings[sho_set]) {
1554                 field_visibility[field_key] = 2;
1555
1556             } else if ($scope.org_settings[sug_set]) {
1557                 field_visibility[field_key] = 1;
1558             }
1559         }
1560
1561         if (field_visibility[field_key] == undefined) {
1562             // No org settings were applied above.  Use the default
1563             // settings if present or assume the field has no
1564             // visibility flags applied.
1565             field_visibility[field_key] = 
1566                 default_field_visibility[field_key] || 0;
1567         }
1568
1569         return field_visibility[field_key] >= $scope.edit_passthru.vis_level;
1570     }
1571
1572     // See $scope.show_field().
1573     // A field with visbility level 3 means it's required.
1574     $scope.field_required = function(cls, field) {
1575
1576         // Value in the password field is not required
1577         // for existing patrons.
1578         if (field == 'passwd' && $scope.patron && !$scope.patron.isnew) 
1579           return false;
1580
1581         return (field_visibility[cls + '.' + field] == 3);
1582     }
1583
1584     // generates a random 4-digit password
1585     $scope.generate_password = function() {
1586         $scope.patron.passwd = Math.floor(Math.random()*9000) + 1000;
1587     }
1588
1589     $scope.set_expire_date = function() {
1590         if (!$scope.patron.profile) return;
1591         var seconds = egCore.date.intervalToSeconds(
1592             $scope.patron.profile.perm_interval());
1593         var now_epoch = new Date().getTime();
1594         $scope.patron.expire_date = new Date(
1595             now_epoch + (seconds * 1000 /* milliseconds */))
1596         $scope.field_modified();
1597     }
1598
1599     // grp is the pgt object
1600     $scope.set_profile = function(grp) {
1601         // If we can't save because of group perms or create/update perms
1602         if ($scope.edit_passthru.hide_save_actions()) return;
1603         $scope.patron.profile = grp;
1604         $scope.set_expire_date();
1605         $scope.field_modified();
1606     }
1607
1608     $scope.invalid_profile = function() {
1609         return !(
1610             $scope.patron && 
1611             $scope.patron.profile && 
1612             $scope.patron.profile.usergroup() == 't'
1613         );
1614     }
1615
1616     $scope.new_address = function() {
1617         var addr = egCore.idl.toHash(new egCore.idl.aua());
1618         patronRegSvc.ingest_address($scope.patron, addr);
1619         addr.id = patronRegSvc.virt_id--;
1620         addr.isnew = true;
1621         addr.valid = true;
1622         addr.within_city_limits = true;
1623         addr.country = $scope.org_settings['ui.patron.default_country'];
1624         $scope.patron.addresses.push(addr);
1625     }
1626
1627     // keep deleted addresses out of the patron object so
1628     // they won't appear in the UI.  They'll be re-inserted
1629     // when the patron is updated.
1630     deleted_addresses = [];
1631     $scope.delete_address = function(id) {
1632
1633         if ($scope.patron.isnew &&
1634             $scope.patron.addresses.length == 1 &&
1635             $scope.org_settings['ui.patron.registration.require_address']) {
1636             egAlertDialog.open(egCore.strings.REG_ADDR_REQUIRED);
1637             return;
1638         }
1639
1640         var addresses = [];
1641         angular.forEach($scope.patron.addresses, function(addr) {
1642             if (addr.id == id) {
1643                 if (id > 0) {
1644                     addr.isdeleted = true;
1645                     deleted_addresses.push(addr);
1646                 }
1647             } else {
1648                 addresses.push(addr);
1649             }
1650         });
1651         $scope.patron.addresses = addresses;
1652     } 
1653
1654     $scope.approve_pending_address = function(addr) {
1655
1656         egCore.net.request(
1657             'open-ils.actor',
1658             'open-ils.actor.user.pending_address.approve',
1659             egCore.auth.token(), addr.id
1660         ).then(function(replaced_id) {
1661             var evt = egCore.evt.parse(replaced_id);
1662             if (evt) { alert(evt); return; }
1663
1664             // Remove the pending address and the replaced address
1665             // from the local list of patron addresses.
1666             var addresses = [];
1667             angular.forEach($scope.patron.addresses, function(a) {
1668                 if (a.id != addr.id && a.id != replaced_id) {
1669                     addresses.push(a);
1670                 }
1671             });
1672             $scope.patron.addresses = addresses;
1673
1674             // Fetch a fresh copy of the modified address from the server.
1675             // and add it back to the list.
1676             egCore.pcrud.retrieve('aua', replaced_id, {}, {authoritative: true})
1677             .then(null, null, function(new_addr) {
1678                 new_addr = egCore.idl.toHash(new_addr);
1679                 patronRegSvc.ingest_address($scope.patron, new_addr);
1680                 $scope.patron.addresses.push(new_addr);
1681             });
1682         });
1683     }
1684
1685     $scope.post_code_changed = function(addr) { 
1686         egCore.net.request(
1687             'open-ils.search', 'open-ils.search.zip', addr.post_code)
1688         .then(function(resp) {
1689             if (!resp) return;
1690             if (resp.city) addr.city = resp.city;
1691             if (resp.state) addr.state = resp.state;
1692             if (resp.county) addr.county = resp.county;
1693             if (resp.alert) alert(resp.alert);
1694         });
1695     }
1696
1697     $scope.new_waiver_entry = function() {
1698         var waiver = egCore.idl.toHash(new egCore.idl.aupw());
1699         patronRegSvc.ingest_waiver_entry($scope.patron, waiver);
1700         waiver.id = patronRegSvc.virt_id--;
1701         waiver.isnew = true;
1702         $scope.patron.waiver_entries.push(waiver);
1703     }
1704
1705     deleted_waiver_entries = [];
1706     $scope.delete_waiver_entry = function(waiver_entry) {
1707         if (waiver_entry.id > 0) {
1708             waiver_entry.isdeleted = true;
1709             deleted_waiver_entries.push(waiver_entry);
1710         }
1711         var index = $scope.patron.waiver_entries.indexOf(waiver_entry);
1712         $scope.patron.waiver_entries.splice(index, 1);
1713     }
1714
1715     $scope.replace_card = function() {
1716         $scope.patron.card.active = false;
1717         $scope.patron.card.ischanged = true;
1718         $scope.disable_bc = false;
1719
1720         var new_card = egCore.idl.toHash(new egCore.idl.ac());
1721         new_card.id = patronRegSvc.virt_id--;
1722         new_card.isnew = true;
1723         new_card.active = true;
1724         new_card._primary = 'on';
1725         $scope.patron.card = new_card;
1726
1727         // Remove any previous attempts to replace the card, since they
1728         // may be incomplete or created by accident.
1729         $scope.patron.cards =
1730             $scope.patron.cards.filter(function(c) {return !c.isnew})
1731         $scope.patron.cards.push(new_card);
1732     }
1733
1734     $scope.day_phone_changed = function(phone) {
1735         if (phone && $scope.patron.isnew && 
1736             $scope.org_settings['patron.password.use_phone']) {
1737             $scope.patron.passwd = phone.substr(-4);
1738         }
1739     }
1740
1741     $scope.barcode_changed = function(bc) {
1742         if (!bc) return;
1743         $scope.dupe_barcode = false;
1744         egCore.net.request(
1745             'open-ils.actor',
1746             'open-ils.actor.barcode.exists',
1747             egCore.auth.token(), bc
1748         ).then(function(resp) {
1749             if (resp == '1') { // duplicate card
1750                 $scope.dupe_barcode = true;
1751                 console.log('duplicate barcode detected: ' + bc);
1752             } else {
1753                 if (!$scope.patron.usrname)
1754                     $scope.patron.usrname = bc;
1755                 // No dupe -- A-OK
1756             }
1757         });
1758     }
1759
1760     $scope.cards_dialog = function() {
1761         $uibModal.open({
1762             templateUrl: './circ/patron/t_patron_cards_dialog',
1763             backdrop: 'static',
1764             controller: 
1765                    ['$scope','$uibModalInstance','cards','perms','patron',
1766             function($scope , $uibModalInstance , cards , perms , patron) {
1767                 // scope here is the modal-level scope
1768                 $scope.args = {cards : cards, primary_barcode : null};
1769                 angular.forEach(cards, function(card) {
1770                     if (card.id == patron.card.id) {
1771                         $scope.args.primary_barcode = card.id;
1772                     }
1773                 });
1774                 $scope.perms = perms;
1775                 $scope.ok = function() { $uibModalInstance.close($scope.args) }
1776                 $scope.cancel = function () { $uibModalInstance.dismiss() }
1777             }],
1778             resolve : {
1779                 cards : function() {
1780                     // scope here is the controller-level scope
1781                     return $scope.patron.cards;
1782                 },
1783                 perms : function() {
1784                     return $scope.perms;
1785                 },
1786                 patron : function() {
1787                     return $scope.patron;
1788                 }
1789             }
1790         }).result.then(
1791             function(args) {
1792                 angular.forEach(args.cards, function(card) {
1793                     card.ischanged = true; // assume cards need updating, OK?
1794                     if (card.id == args.primary_barcode) {
1795                         $scope.patron.card = card;
1796                         card._primary = true;
1797                     } else {
1798                         card._primary = false;
1799                     }
1800                 });
1801             }
1802         );
1803     }
1804
1805     $scope.set_addr_type = function(addr, type) {
1806         var addrs = $scope.patron.addresses;
1807         if (addr['_is_'+type]) {
1808             angular.forEach(addrs, function(a) {
1809                 if (a.id != addr.id) a['_is_'+type] = false;
1810             });
1811         } else {
1812             // unchecking mailing/billing means we have to randomly
1813             // select another address to fill that role.  Select the
1814             // first address in the list (that does not match the
1815             // modifed address)
1816             for (var i = 0; i < addrs.length; i++) {
1817                 if (addrs[i].id != addr.id) {
1818                     addrs[i]['_is_' + type] = true;
1819                     break;
1820                 }
1821             }
1822         }
1823     }
1824
1825
1826     // Translate hold notify preferences from the form/scope back into a 
1827     // single user setting value for opac.hold_notify.
1828     function compress_hold_notify() {
1829         var hold_notify_methods = [];
1830         if ($scope.hold_notify_type.phone) {
1831             hold_notify_methods.push('phone');
1832         }
1833         if ($scope.hold_notify_type.email) {
1834             hold_notify_methods.push('email');
1835         }
1836         if ($scope.hold_notify_type.sms) {
1837             hold_notify_methods.push('sms');
1838         }
1839
1840         $scope.user_settings['opac.hold_notify'] = hold_notify_methods.join(':');
1841     }
1842
1843     // dialog for selecting additional permission groups
1844     $scope.secondary_groups_dialog = function() {
1845         $uibModal.open({
1846             templateUrl: './circ/patron/t_patron_groups_dialog',
1847             backdrop: 'static',
1848             controller: 
1849                    ['$scope','$uibModalInstance','linked_groups','pgt_depth',
1850             function($scope , $uibModalInstance , linked_groups , pgt_depth) {
1851
1852                 $scope.pgt_depth = pgt_depth;
1853                 $scope.args = {
1854                     linked_groups : linked_groups,
1855                     edit_profiles : patronRegSvc.edit_profiles,
1856                     new_profile   : patronRegSvc.edit_profiles[0]
1857                 };
1858
1859                 // add a new group to the linked groups list
1860                 $scope.link_group = function($event, grp) {
1861                     var found = false; // avoid duplicates
1862                     angular.forEach($scope.args.linked_groups, 
1863                         function(g) {if (g.id() == grp.id()) found = true});
1864                     if (!found) $scope.args.linked_groups.push(grp);
1865                     $event.preventDefault(); // avoid close
1866                 }
1867
1868                 // remove a group from the linked groups list
1869                 $scope.unlink_group = function($event, grp) {
1870                     $scope.args.linked_groups = 
1871                         $scope.args.linked_groups.filter(function(g) {
1872                         return g.id() != grp.id()
1873                     });
1874                     $event.preventDefault(); // avoid close
1875                 }
1876
1877                 $scope.ok = function() { $uibModalInstance.close($scope.args) }
1878                 $scope.cancel = function () { $uibModalInstance.dismiss() }
1879             }],
1880             resolve : {
1881                 linked_groups : function() { return $scope.patron.groups },
1882                 pgt_depth : function() { return $scope.pgt_depth }
1883             }
1884         }).result.then(
1885             function(args) {
1886
1887                 if ($scope.patron.isnew) {
1888                     // groups must be linked for new patrons after the
1889                     // patron is created.
1890                     $scope.patron.groups = args.linked_groups;
1891                     return;
1892                 }
1893
1894                 // update links groups for existing users in real time.
1895                 var ids = args.linked_groups.map(function(g) {return g.id()});
1896                 patronRegSvc.apply_secondary_groups($scope.patron.id, ids)
1897                 .then(function(success) {
1898                     if (success)
1899                         $scope.patron.groups = args.linked_groups;
1900                 });
1901             }
1902         );
1903     }
1904
1905     function extract_hold_notify() {
1906         var p = $scope.patron;
1907
1908         // get the user's opac.hold_notify setting
1909         var notify = $scope.user_settings['opac.hold_notify'];
1910
1911         // if it's not set, use the default opac.hold_notify value
1912         if (!notify && !(notify === '')) {
1913             var notify_stype = $scope.user_setting_types['opac.hold_notify'];
1914             if (notify_stype && notify_stype.reg_default() !== undefined && notify_stype.reg_default() !== null) {
1915                 notify = notify_stype.reg_default();
1916             } else {
1917                 // no setting and no default: set phone and email to true
1918                 $scope.hold_notify_type.phone = true;
1919                 $scope.hold_notify_type.email = true;
1920                 return;
1921             }
1922         }
1923
1924         $scope.hold_notify_type.phone = Boolean(notify.match(/phone/));
1925         $scope.hold_notify_type.email = Boolean(notify.match(/email/));
1926         $scope.hold_notify_type.sms = Boolean(notify.match(/sms/));
1927
1928         // stores original loaded values for comparison later
1929         for (var k in $scope.hold_notify_type){
1930             var val = $scope.hold_notify_type[k];
1931
1932             if ($scope.hold_notify_type.hasOwnProperty(k)){
1933                 $scope.hold_notify_observer[k] = {old : val, newval: null};
1934             }
1935         }
1936
1937         // actual value from user
1938         $scope.hold_rel_contacts.day_phone = { old: p.day_phone, newval : null };
1939         $scope.hold_rel_contacts.other_phone = { old: p.other_phone, newval : null };
1940         $scope.hold_rel_contacts.evening_phone = { old: p.evening_phone, newval : null };
1941         // from user_settings
1942         $scope.hold_rel_contacts.default_phone = { old: $scope.user_settings['opac.default_phone'], newval : null };
1943         $scope.hold_rel_contacts.default_sms = { old: $scope.user_settings['opac.default_sms_notify'], newval : null };
1944         $scope.hold_rel_contacts.default_sms_carrier_id = { old: $scope.user_settings['opac.default_sms_carrier'], newval : null };
1945
1946     }
1947
1948     function normalizePhone(number){
1949         // normalize phone # for comparison, only digits
1950         if (number == null || number == undefined) return '';
1951         
1952         var regex = /[^\d]/g;
1953         return number.replace(regex, '');
1954     }
1955
1956     $scope.invalidate_field = function(field) {
1957         patronRegSvc.invalidate_field($scope.patron, field).then(function() {
1958             $scope.handle_field_changed($scope.patron, field);
1959         });
1960     }
1961
1962     address_alert = function(addr) {
1963         var args = {
1964             street1: addr.street1,
1965             street2: addr.street2,
1966             city: addr.city,
1967             state: addr.state,
1968             county: addr.county,
1969             country: addr.country,
1970             post_code: addr.post_code,
1971             mailing_address: addr._is_mailing,
1972             billing_address: addr._is_billing
1973         }
1974
1975         egCore.net.request(
1976             'open-ils.actor',
1977             'open-ils.actor.address_alert.test',
1978             egCore.auth.token(), egCore.auth.user().ws_ou(), args
1979             ).then(function(res) {
1980                 $scope.address_alerts = res;
1981         });
1982     }
1983
1984     $scope.dupe_value_changed = function(type, value) {
1985         if (!$scope.dupe_search_encoded)
1986             $scope.dupe_search_encoded = {};
1987
1988         $scope.dupe_counts[type] = 0;
1989
1990         patronRegSvc.dupe_patron_search($scope.patron, type, value)
1991         .then(function(res) {
1992             $scope.dupe_counts[type] = res.count;
1993             if (res.count) {
1994                 $scope.dupe_search_encoded[type] = 
1995                     encodeURIComponent(js2JSON(res.search));
1996             } else {
1997                 $scope.dupe_search_encoded[type] = '';
1998             }
1999         });
2000     }
2001
2002     $scope.handle_home_org_changed = function() {
2003         org_id = $scope.patron.home_ou.id();
2004         patronRegSvc.has_perms_for_org(org_id).then(function(map) {
2005             angular.forEach(map, function(v, k) { $scope.perms[k] = v });
2006         });
2007     }
2008
2009     $scope.handle_pulib_changed = function(org) {
2010         if (!$scope.user_settings) return; // still rendering
2011         $scope.user_settings['opac.default_pickup_location'] = org.id();
2012     }
2013
2014     // This is called with every character typed in a form field,
2015     // since that's the only way to gaurantee something has changed.
2016     // See handle_field_changed for ng-change vs. ng-blur.
2017     $scope.field_modified = function() {
2018         // Call attach with every field change, regardless of whether
2019         // it's been called before.  This will allow for re-attach after
2020         // the user clicks through the unload warning. egUnloadPrompt
2021         // will ensure we only attach once.
2022         egUnloadPrompt.attach($scope);
2023     }
2024
2025     // also monitor when form is changed *by the user*, as using
2026     // an ng-change handler doesn't work with eg-date-input
2027     $scope.$watch('reg_form.$pristine', function(newVal, oldVal) {
2028         if (!newVal) egUnloadPrompt.attach($scope);
2029     });
2030
2031     // username regex (if present) must be removed any time
2032     // the username matches the barcode to avoid firing the
2033     // invalid field handlers.
2034     function apply_username_regex() {
2035         var regex = $scope.org_settings['opac.username_regex'];
2036         if (regex) {
2037             if ($scope.patron.card.barcode) {
2038                 // username must match the regex or the barcode
2039                 field_patterns.au.usrname = 
2040                     new RegExp(
2041                         regex + '|^' + $scope.patron.card.barcode + '$');
2042             } else {
2043                 // username must match the regex
2044                 field_patterns.au.usrname = new RegExp(regex);
2045             }
2046         } else {
2047             // username can be any format.
2048             field_patterns.au.usrname = new RegExp('.*');
2049         }
2050     }
2051
2052     // obj could be the patron, an address, etc.
2053     // This is called any time a form field achieves then loses focus.
2054     // It does not necessarily mean the field has changed.
2055     // The alternative is ng-change, but it's called with each character
2056     // typed, which would be overkill for many of the actions called here.
2057     $scope.handle_field_changed = function(obj, field_name) {
2058         var cls = obj.classname; // set by egIdl
2059         var value = obj[field_name];
2060
2061         console.debug('changing field ' + field_name + ' to ' + value);
2062
2063         switch (field_name) {
2064             case 'day_phone' :
2065                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.day_phone.old)){
2066                     $scope.hold_rel_contacts.day_phone.newval = value;
2067                 }
2068                 if ($scope.patron.day_phone && 
2069                     $scope.patron.isnew && 
2070                     $scope.org_settings['patron.password.use_phone']) {
2071                     $scope.patron.passwd = $scope.patron.day_phone.substr(-4);
2072                 }
2073                 $scope.dupe_value_changed(field_name, value);
2074                 break;
2075             case 'evening_phone' :
2076                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.evening_phone.old)){
2077                     $scope.hold_rel_contacts.evening_phone.newval = value;
2078                 }
2079                 $scope.dupe_value_changed(field_name, value);
2080                 break;
2081             case 'other_phone' : 
2082                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.other_phone.old)){
2083                     $scope.hold_rel_contacts.other_phone.newval = value;
2084                 }
2085                 $scope.dupe_value_changed(field_name, value);
2086                 break;
2087             case 'ident_value':
2088             case 'ident_value2':
2089                 $scope.dupe_value_changed('ident', value);
2090                 break;
2091
2092             case 'first_given_name':
2093             case 'family_name':
2094                 $scope.dupe_value_changed('name', value);
2095                 break;
2096
2097             case 'email':
2098                 $scope.dupe_value_changed('email', value);
2099                 break;
2100
2101             case 'street1':
2102             case 'street2':
2103             case 'city':
2104                 // dupe search on address wants the address object as the value.
2105                 $scope.dupe_value_changed('address', obj);
2106                 address_alert(obj);
2107                 break;
2108
2109             case 'post_code':
2110                 $scope.post_code_changed(obj);
2111                 break;
2112
2113             case 'usrname':
2114                 patronRegSvc.check_dupe_username(value)
2115                 .then(function(yes) {$scope.dupe_username = Boolean(yes)});
2116                 break;
2117
2118             case 'barcode':
2119                 // TODO: finish barcode_changed handler.
2120                 $scope.barcode_changed(value);
2121                 apply_username_regex();
2122                 break;
2123             case 'opac.default_phone':
2124                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.default_phone.old)){
2125                     $scope.hold_rel_contacts.default_phone.newval = value;
2126                 }
2127                 break;
2128             case 'opac.default_sms_notify':
2129                 if (normalizePhone(value) !== normalizePhone($scope.hold_rel_contacts.default_sms.old)){
2130                     $scope.hold_rel_contacts.default_sms.newval = value;
2131                 }
2132                 break;
2133             case 'opac.default_sms_carrier':
2134                 if (value !== $scope.hold_rel_contacts.default_sms_carrier_id.old){
2135                     $scope.hold_rel_contacts.default_sms_carrier_id.newval = value;
2136                 }
2137                 break;
2138         }
2139     }
2140
2141     // patron.juvenile is set to true if the user was born after
2142     function maintain_juvenile_flag() {
2143         if ( !($scope.patron && $scope.patron.dob) ) return;
2144
2145         var juv_interval = 
2146             $scope.org_settings['global.juvenile_age_threshold'] 
2147             || '18 years';
2148
2149         var base = new Date();
2150
2151         base.setTime(base.getTime() - 
2152             Number(egCore.date.intervalToSeconds(juv_interval) + '000'));
2153
2154         $scope.patron.juvenile = ($scope.patron.dob > base);
2155     }
2156
2157     // returns true (disable) for orgs that cannot have users.
2158     $scope.disable_home_org = function(org_id) {
2159         if (!org_id) return;
2160         var org = egCore.org.get(org_id);
2161         return (
2162             org &&
2163             org.ou_type() &&
2164             org.ou_type().can_have_users() == 'f'
2165         );
2166     }
2167
2168     // returns true (disable) for orgs that cannot have vols (for holds pickup)
2169     $scope.disable_pulib = function(org_id) {
2170         if (!org_id) return;
2171         return !egCore.org.CanHaveVolumes(org_id);
2172     }
2173
2174     // Returns true if attempting to edit self, but perms don't allow
2175     $scope.edit_passthru.self_edit_disallowed = function() {
2176         if ($scope.patron.id
2177             && $scope.patron.id == egCore.auth.user().id()
2178             && !$scope.perms.EDIT_SELF_IN_CLIENT
2179         ) return true;
2180         return false;
2181     }
2182
2183     // Returns true if attempting to edit a user without appropriate group application perms
2184     $scope.edit_passthru.group_edit_disallowed = function() {
2185         if ( $scope.patron.profile
2186              && patronRegSvc
2187                 .edit_profiles
2188                 .filter(function(p) {
2189                     return $scope.patron.profile.id() == p.id();
2190                 }).length == 0
2191         ) return true;
2192         return false;
2193     }
2194
2195     // Returns true if the Save and Save & Clone buttons should be disabled.
2196     $scope.edit_passthru.hide_save_actions = function() {
2197         if ($scope.edit_passthru.self_edit_disallowed()) return true;
2198         if ($scope.edit_passthru.group_edit_disallowed()) return true;
2199
2200         return $scope.patron.isnew ?
2201             !$scope.perms.CREATE_USER : 
2202             !$scope.perms.UPDATE_USER;
2203     }
2204
2205     // Returns true if any input elements are tagged as invalid
2206     // via Angular patterns or required attributes.
2207     function form_has_invalid_fields() {
2208         return $('#patron-reg-container .ng-invalid').length > 0;
2209     }
2210
2211     function form_is_incomplete() {
2212         return (
2213             $scope.dupe_username ||
2214             $scope.dupe_barcode ||
2215             form_has_invalid_fields()
2216         );
2217
2218     }
2219
2220     $scope.edit_passthru.save = function(save_args) {
2221         if (!save_args) save_args = {};
2222
2223         if (form_is_incomplete()) {
2224             // User has not provided valid values for all required fields.
2225             return egAlertDialog.open(egCore.strings.REG_INVALID_FIELDS);
2226         }
2227
2228         // remove page unload warning prompt
2229         egUnloadPrompt.clear();
2230
2231         // toss the deleted addresses back into the patron's list of
2232         // addresses so it's included in the update
2233         $scope.patron.addresses = 
2234             $scope.patron.addresses.concat(deleted_addresses);
2235         
2236         // ditto for waiver entries
2237         $scope.patron.waiver_entries = 
2238             $scope.patron.waiver_entries.concat(deleted_waiver_entries);
2239
2240         compress_hold_notify();
2241
2242         var updated_user;
2243
2244         patronRegSvc.save_user($scope.patron)
2245         .then(function(new_user) { 
2246             if (new_user && new_user.classname) {
2247                 updated_user = new_user;
2248                 return patronRegSvc.save_user_settings(
2249                     new_user, $scope.user_settings); 
2250             } else {
2251                 var evt = egCore.evt.parse(new_user);
2252
2253                 if (evt && evt.textcode == 'XACT_COLLISION') {
2254                     return egAlertDialog.open(
2255                         egCore.strings.PATRON_EDIT_COLLISION).result;
2256                 }
2257
2258                 // debug only -- should not get here.
2259                 alert('Patron update failed. \n\n' + js2JSON(new_user));
2260             }
2261
2262         }).then(function() {
2263
2264             // only remove the staged user if the update succeeded.
2265             if (updated_user) 
2266                 return patronRegSvc.remove_staged_user();
2267
2268             return $q.when();
2269
2270         }).then(function() {
2271
2272             // linked groups for new users must be created after the new
2273             // user is created.
2274             if ($scope.patron.isnew && 
2275                 $scope.patron.groups && $scope.patron.groups.length) {
2276                 var ids = $scope.patron.groups.map(function(g) {return g.id()});
2277                 return patronRegSvc.apply_secondary_groups(updated_user.id(), ids)
2278             }
2279             return $q.when();
2280
2281         }).then(findChangedFieldsAffectedHolds)
2282         .then(function(changed_fields_plus_holds) {
2283             var needModal = changed_fields_plus_holds[0] && changed_fields_plus_holds[0].length > 0;
2284             return needModal
2285                 ? $scope.update_holds_notify_modal(changed_fields_plus_holds[0])
2286                 : $q.when(); // nothing changed, continue
2287         }).then(function() {
2288             if (updated_user) {
2289                 egWorkLog.record(
2290                     $scope.patron.isnew
2291                     ? egCore.strings.EG_WORK_LOG_REGISTERED_PATRON
2292                     : egCore.strings.EG_WORK_LOG_EDITED_PATRON, {
2293                         'action' : $scope.patron.isnew ? 'registered_patron' : 'edited_patron',
2294                         'patron_id' : updated_user.id()
2295                     }
2296                 );
2297             }
2298
2299             // reloading the page means potentially losing some information
2300             // (e.g. last patron search), but is the only way to ensure all
2301             // components are properly updated to reflect the modified patron.
2302             if (updated_user && save_args.clone) {
2303                 // open a separate tab for registering a new 
2304                 // patron from our cloned data.
2305                 var url = 'https://' 
2306                     + $window.location.hostname 
2307                     + egCore.env.basePath 
2308                     + '/circ/patron/register/clone/' 
2309                     + updated_user.id();
2310                 $window.open(url, '_blank').focus();
2311
2312             } else if ($window.location.href.indexOf('stage') > -1 ){
2313                 // we're here after deleting a self-reg staged user.
2314                 // Just close tab, since refresh won't find staged user
2315                 $timeout(function(){
2316                     if (typeof BroadcastChannel != 'undefined') {
2317                         var bChannel = new BroadcastChannel("eg.pending_usr.update");
2318                         bChannel.postMessage({
2319                             usr: egCore.idl.toHash(updated_user)
2320                         });
2321                     }
2322
2323                     $window.close();
2324                 });
2325             } else {
2326                 // reload the current page
2327                 $window.location.href = location.href;
2328             }
2329         });
2330     }
2331     
2332     var phone_inputs = ["day_phone", "evening_phone","other_phone", "default_phone"];
2333     var sms_inputs = ["default_sms", "default_sms_carrier_id"];
2334     var method_prefs = ["sms_notify", "phone_notify", "email_notify"];
2335     var groupBy = function(xs, key){
2336         return xs.reduce(function(rv, x){
2337             (rv[x[key]] = rv[x[key]] || []).push(x);
2338             return rv;
2339         }, {});
2340     };
2341
2342     function findChangedFieldsAffectedHolds(){
2343     
2344         var changed_hold_fields = [];
2345
2346         var default_phone_changed = false;
2347         var default_sms_carrier_changed = false;
2348         var default_sms_changed = false;
2349         for (var c in $scope.hold_rel_contacts){
2350             var newinput = $scope.hold_rel_contacts[c].newval;
2351             if ($scope.hold_rel_contacts.hasOwnProperty(c)
2352                 && newinput !== null // null means user has not provided a value in this session
2353                 && newinput != $scope.hold_rel_contacts[c].old){
2354                 var changed = $scope.hold_rel_contacts[c];
2355                 changed.name = c;
2356                 changed.isChecked = false;
2357                 changed_hold_fields.push(changed);
2358                 if (c === 'default_phone') default_phone_changed = true;
2359                 if (c === 'default_sms_carrier_id') default_sms_carrier_changed = true;
2360                 if (c === 'default_sms') default_sms_changed = true;
2361             }
2362         }
2363
2364         for (var c in $scope.hold_notify_observer){
2365             var newinput = $scope.hold_notify_observer[c].newval;
2366             if ($scope.hold_notify_observer.hasOwnProperty(c)
2367                 && newinput !== null // null means user has not provided a value in this session
2368                 && newinput != $scope.hold_notify_observer[c].old){
2369                 var changed = $scope.hold_notify_observer[c];
2370                 changed.name = c + "_notify";
2371                 changed.isChecked = false;
2372                 changed_hold_fields.push(changed);
2373
2374                 // if we're turning on phone notifications, offer to update to the
2375                 // current default number
2376                 if (c === 'phone' && $scope.user_settings['opac.default_phone'] && newinput && !default_phone_changed) {
2377                     changed_hold_fields.push({
2378                         name: 'default_phone',
2379                         old: 'nosuch',
2380                         newval: $scope.user_settings['opac.default_phone'],
2381                         isChecked: false
2382                     });
2383                 }
2384                 // and similarly for SMS
2385                 if (c === 'sms' && $scope.user_settings['opac.default_sms_carrier'] && newinput && !default_sms_carrier_changed) {
2386                     changed_hold_fields.push({
2387                         name: 'default_sms_carrier_id',
2388                         old: -1,
2389                         newval: $scope.user_settings['opac.default_sms_carrier'],
2390                         isChecked: false
2391                     });
2392                 }
2393                 if (c === 'sms' && $scope.user_settings['opac.default_sms_notify'] && newinput && !default_sms_changed) {
2394                     changed_hold_fields.push({
2395                         name: 'default_sms',
2396                         old: 'nosuch',
2397                         newval: $scope.user_settings['opac.default_sms_notify'],
2398                         isChecked: false
2399                     });
2400                 }
2401             }
2402         }
2403
2404         var promises = [];
2405         angular.forEach(changed_hold_fields, function(c){
2406             promises.push(egCore.net.request('open-ils.circ',
2407             'open-ils.circ.holds.retrieve_by_notify_staff',
2408             egCore.auth.token(),
2409             $scope.patron.id,
2410             c.name.includes('notify') || c.name.includes('carrier') ? c.old : c.newval,
2411             c.name)
2412                 .then(function(affected_holds){
2413                     if(!affected_holds || affected_holds.length < 1){
2414                         // no holds affected - remove change from list
2415                         var p = changed_hold_fields.indexOf(c);
2416                         changed_hold_fields.splice(p, 1);
2417                     } else {
2418                         c.affects = affected_holds;
2419                         //c.groups = {};
2420                         //angular.forEach(c.affects, function(h){
2421                         //    c.groups[]
2422                         //});
2423                         if (!c.name.includes("notify")){
2424                             if (c.name === "default_sms_carrier_id") {
2425                                 c.groups = groupBy(c.affects,'sms_carrier');
2426                             } else {
2427                                 c.groups = groupBy(c.affects, c.name.includes('_phone') ? 'phone_notify':'sms_notify');
2428                             }
2429                         }
2430                     }
2431                     return $q.when(changed_hold_fields);
2432                 })
2433             );
2434         });
2435
2436         return $q.all(promises);
2437     }
2438
2439     $scope.update_holds_notify_modal = function(changed_hold_fields){
2440         // open modal after-save, pre-reload modal to deal with updated hold notification stuff
2441         if ($scope.patron.isnew || changed_hold_fields.length < 1){
2442             return $q.when();
2443         }
2444
2445         return $uibModal.open({
2446             templateUrl: './circ/patron/t_hold_notify_update',
2447             backdrop: 'static',
2448             controller:
2449                        ['$scope','$uibModalInstance','changed_fields','patron','carriers','def_carrier_id','default_phone','default_sms',
2450                 function($scope , $uibModalInstance , changed_fields , patron,  carriers,  def_carrier_id , default_phone , default_sms) {
2451                 // local modal scope
2452                 $scope.ch_fields = changed_fields;
2453                 $scope.focusMe = true;
2454                 $scope.ok = function(msg) {
2455
2456                     // Need to do this so the page will reload automatically
2457                     if (msg == 'no-update') return $uibModalInstance.close();
2458
2459                     //var selectedChanges = $scope.changed_fields.filter(function(c) {
2460                     //    return c.isChecked;
2461                     //});
2462                     var selectedChanges = [];
2463                     angular.forEach($scope.ch_fields, function(f){
2464                         if (f.name == 'phone_notify' && f.newval && f.isChecked) {
2465                             // convert to default_phone change
2466                             f.sel_hids = f.affects.map(function(h){ return h.id});
2467                             f.newval = default_phone;
2468                             f.name = 'default_phone';
2469                             selectedChanges.push(f);
2470                         } else if (f.name == 'sms_notify' && f.newval && f.isChecked) {
2471                             // convert to default_sms change
2472                             f.sel_hids = f.affects.map(function(h){ return h.id});
2473                             f.newval = default_sms;
2474                             f.name = 'default_sms';
2475                             selectedChanges.push(f);
2476                         } else if (f.name.includes('notify') || f.name.includes('carrier')){
2477                             if (f.isChecked){
2478                                 f.sel_hids = f.affects.map(function(h){ return h.id});
2479                                 selectedChanges.push(f);
2480                             }
2481                         } else {
2482                             // this is the sms or phone, so look in the groups obj
2483                             f.sel_hids = [];
2484                             for (var k in f.groups){
2485                                 if (f.groups.hasOwnProperty(k)){
2486                                     var sel_holds = f.groups[k].filter(function(h){
2487                                         return h.isChecked;
2488                                     });
2489                                     
2490                                     var hids = sel_holds.map(function(h){ return h.id});
2491                                     f.sel_hids.push.apply(f.sel_hids, hids);
2492                                 }
2493                             }
2494
2495                             if (f.sel_hids.length > 0) selectedChanges.push(f);
2496                         }
2497                     });
2498
2499
2500                     // call method to update holds for each change
2501                     var chain = $q.when();
2502                     angular.forEach(selectedChanges, function(c){
2503                         var carrierId = c.name.includes('default_sms') ? Number(def_carrier_id) : null;
2504                         chain = chain.then(function() {
2505                             return egCore.net.request('open-ils.circ',
2506                                     'open-ils.circ.holds.batch_update_holds_by_notify_staff', egCore.auth.token(),
2507                                     patron.id,
2508                                     c.sel_hids,
2509                                     c.old, // TODO: for number changes, old val is effectively moot
2510                                     c.newval,
2511                                     c.name,
2512                                     carrierId).then(function(okList){ console.log(okList) });
2513                         });
2514                     });
2515
2516                     // carry out the updates and close modal
2517                     chain.finally(function(){ $uibModalInstance.close() });
2518                 }
2519
2520                 $scope.cancel = function () { $uibModalInstance.dismiss() }
2521
2522                 $scope.isNumberCh = function(c){
2523                     return !(c.name.includes('notify') || c.name.includes('carrier'));
2524                 }
2525
2526                 $scope.chgCt = 0;
2527                 $scope.groupChanged = function(ch_f, grpK){
2528                     var holdArr = ch_f.groups[grpK];
2529                     if (holdArr && holdArr.length > 0){
2530                         angular.forEach(holdArr, function(h){
2531                             if (h.isChecked) { h.isChecked = !h.isChecked; $scope.chgCt-- }
2532                             else { h.isChecked = true; $scope.chgCt++ }
2533                         });
2534                     }
2535                 }
2536                 
2537                 $scope.nonGrpChanged = function(field_ch){
2538                     if (field_ch.isChecked) $scope.chgCt++;
2539                     else $scope.chgCt--;
2540                 };
2541
2542                 // use this function as a keydown handler on form
2543                 // elements that should not submit the form on enter.
2544                 $scope.preventSubmit = function($event) {
2545                     if ($event.keyCode == 13)
2546                         $event.preventDefault();
2547                 }
2548
2549                 $scope.prettyCarrier = function(carrierId){
2550                     var sms_carrierObj = carriers.find(function(c){ return c.id == carrierId});
2551                     return sms_carrierObj.name;
2552                 };
2553                 $scope.prettyBool = function(v){
2554                     return v ? 'YES' : 'NO';
2555                 };
2556             }],
2557             resolve : {
2558                     changed_fields : function(){ return changed_hold_fields },
2559                     patron : function(){ return $scope.patron },
2560                     def_carrier_id : function(){
2561                                        var d = $scope.hold_rel_contacts.default_sms_carrier_id;
2562                                        return d.newval ? d.newval : d.old;
2563                                     },
2564                     default_phone : function() {
2565                                         return ($scope.hold_rel_contacts.default_phone.newval) ?
2566                                                     $scope.hold_rel_contacts.default_phone.newval :
2567                                                     $scope.hold_rel_contacts.default_phone.old;
2568                                     },
2569                     default_sms : function() {
2570                                         return ($scope.hold_rel_contacts.default_sms.newval) ?
2571                                                     $scope.hold_rel_contacts.default_sms.newval :
2572                                                     $scope.hold_rel_contacts.default_sms.old;
2573                                     },
2574                     carriers : function(){ return $scope.sms_carriers.map(function(c){ return egCore.idl.toHash(c) }) }
2575                 }
2576         }).result;
2577     }
2578     
2579     $scope.edit_passthru.print = function() {
2580         var print_data = {patron : $scope.patron}
2581
2582         return egCore.print.print({
2583             context : 'default',
2584             template : 'patron_data',
2585             scope : print_data
2586         });
2587     }
2588 }])