LP#1816180 Pending Patron - No Address Type
[working/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             'UPDATE_USER',
250             'CREATE_USER',
251             'CREATE_USER_GROUP_LINK', 
252             'UPDATE_PATRON_COLLECTIONS_EXEMPT',
253             'UPDATE_PATRON_CLAIM_RETURN_COUNT',
254             'UPDATE_PATRON_CLAIM_NEVER_CHECKED_OUT_COUNT',
255             'UPDATE_PATRON_ACTIVE_CARD',
256             'UPDATE_PATRON_PRIMARY_CARD'
257         ];
258
259         return egCore.perm.hasPermAt(perms_needed, true)
260         .then(function(perm_map) {
261
262             angular.forEach(perms_needed, function(perm) {
263                 perm_map[perm] = 
264                     Boolean(perm_map[perm].indexOf(org_id) > -1);
265             });
266
267             return perm_map;
268         });
269     }
270
271     service.get_surveys = function() {
272         var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
273
274         return egCore.pcrud.search('asv', {
275                 owner : org_ids,
276                 start_date : {'<=' : 'now'},
277                 end_date : {'>=' : 'now'}
278             }, {   
279                 flesh : 2, 
280                 flesh_fields : {
281                     asv : ['questions'], 
282                     asvq : ['answers']
283                 }
284             }, 
285             {atomic : true}
286         ).then(function(surveys) {
287             surveys = surveys.sort(function(a,b) {
288                 return a.name() < b.name() ? -1 : 1 });
289             service.surveys = surveys;
290             angular.forEach(surveys, function(survey) {
291                 angular.forEach(survey.questions(), function(question) {
292                     service.survey_questions[question.id()] = question;
293                     angular.forEach(question.answers(), function(answer) {
294                         service.survey_answers[answer.id()] = answer;
295                     });
296                 });
297             });
298
299             egLovefield.setListInOfflineCache('asv', service.surveys)
300             egLovefield.setListInOfflineCache('asvq', service.survey_questions)
301             egLovefield.setListInOfflineCache('asva', service.survey_answers)
302
303         });
304     }
305
306     service.get_stat_cats = function() {
307         return egCore.net.request(
308             'open-ils.circ',
309             'open-ils.circ.stat_cat.actor.retrieve.all',
310             egCore.auth.token(), egCore.auth.user().ws_ou()
311         ).then(function(cats) {
312             cats = cats.sort(function(a, b) {
313                 return a.name() < b.name() ? -1 : 1});
314             angular.forEach(cats, function(cat) {
315                 cat.entries(
316                     cat.entries().sort(function(a,b) {
317                         return a.value() < b.value() ? -1 : 1
318                     })
319                 );
320             });
321             service.stat_cats = cats;
322             return egLovefield.setStatCatsCache(cats);
323         });
324     };
325
326     service.get_org_settings = function() {
327         return egCore.org.settings([
328             'global.password_regex',
329             'global.juvenile_age_threshold',
330             'patron.password.use_phone',
331             'ui.patron.default_inet_access_level',
332             'ui.patron.default_ident_type',
333             'ui.patron.default_country',
334             'ui.patron.registration.require_address',
335             'circ.holds.behind_desk_pickup_supported',
336             'circ.patron_edit.clone.copy_address',
337             'circ.privacy_waiver',
338             'ui.patron.edit.au.prefix.require',
339             'ui.patron.edit.au.prefix.show',
340             'ui.patron.edit.au.prefix.suggest',
341             'ui.patron.edit.ac.barcode.regex',
342             'ui.patron.edit.au.second_given_name.show',
343             'ui.patron.edit.au.second_given_name.suggest',
344             'ui.patron.edit.au.suffix.show',
345             'ui.patron.edit.au.suffix.suggest',
346             'ui.patron.edit.au.alias.show',
347             'ui.patron.edit.au.alias.suggest',
348             'ui.patron.edit.au.dob.require',
349             'ui.patron.edit.au.dob.show',
350             'ui.patron.edit.au.dob.suggest',
351             'ui.patron.edit.au.dob.calendar',
352             'ui.patron.edit.au.dob.example',
353             'ui.patron.edit.au.juvenile.show',
354             'ui.patron.edit.au.juvenile.suggest',
355             'ui.patron.edit.au.ident_value.show',
356             'ui.patron.edit.au.ident_value.suggest',
357             'ui.patron.edit.au.ident_value2.show',
358             'ui.patron.edit.au.ident_value2.suggest',
359             'ui.patron.edit.au.email.require',
360             'ui.patron.edit.au.email.show',
361             'ui.patron.edit.au.email.suggest',
362             'ui.patron.edit.au.email.regex',
363             'ui.patron.edit.au.email.example',
364             'ui.patron.edit.au.day_phone.require',
365             'ui.patron.edit.au.day_phone.show',
366             'ui.patron.edit.au.day_phone.suggest',
367             'ui.patron.edit.au.day_phone.regex',
368             'ui.patron.edit.au.day_phone.example',
369             'ui.patron.edit.au.evening_phone.require',
370             'ui.patron.edit.au.evening_phone.show',
371             'ui.patron.edit.au.evening_phone.suggest',
372             'ui.patron.edit.au.evening_phone.regex',
373             'ui.patron.edit.au.evening_phone.example',
374             'ui.patron.edit.au.other_phone.require',
375             'ui.patron.edit.au.other_phone.show',
376             'ui.patron.edit.au.other_phone.suggest',
377             'ui.patron.edit.au.other_phone.regex',
378             'ui.patron.edit.au.other_phone.example',
379             'ui.patron.edit.phone.regex',
380             'ui.patron.edit.phone.example',
381             'ui.patron.edit.au.active.show',
382             'ui.patron.edit.au.active.suggest',
383             'ui.patron.edit.au.barred.show',
384             'ui.patron.edit.au.barred.suggest',
385             'ui.patron.edit.au.master_account.show',
386             'ui.patron.edit.au.master_account.suggest',
387             'ui.patron.edit.au.claims_returned_count.show',
388             'ui.patron.edit.au.claims_returned_count.suggest',
389             'ui.patron.edit.au.claims_never_checked_out_count.show',
390             'ui.patron.edit.au.claims_never_checked_out_count.suggest',
391             'ui.patron.edit.au.alert_message.show',
392             'ui.patron.edit.au.alert_message.suggest',
393             'ui.patron.edit.aua.post_code.regex',
394             'ui.patron.edit.aua.post_code.example',
395             'ui.patron.edit.aua.county.require',
396             'ui.patron.edit.au.guardian.show',
397             'ui.patron.edit.au.guardian.suggest',
398             'ui.patron.edit.guardian_required_for_juv',
399             'format.date',
400             'ui.patron.edit.default_suggested',
401             'opac.barcode_regex',
402             'opac.username_regex',
403             'sms.enable',
404             'ui.patron.edit.aua.state.require',
405             'ui.patron.edit.aua.state.suggest',
406             'ui.patron.edit.aua.state.show',
407             'ui.admin.work_log.max_entries',
408             'ui.admin.patron_log.max_entries'
409         ]).then(function(settings) {
410             service.org_settings = settings;
411             if (egCore && egCore.env && !egCore.env.aous) {
412                 egCore.env.aous = settings;
413                 console.log('setting egCore.env.aous');
414             }
415             return service.process_org_settings(settings);
416         });
417     };
418
419     // some org settings require the retrieval of additional data
420     service.process_org_settings = function(settings) {
421
422         var promises = [egLovefield.setSettingsCache(settings)];
423
424         if (settings['sms.enable']) {
425             // fetch SMS carriers
426             promises.push(
427                 egCore.pcrud.search('csc', 
428                     {active: 'true'}, 
429                     {'order_by':[
430                         {'class':'csc', 'field':'name'},
431                         {'class':'csc', 'field':'region'}
432                     ]}, {atomic : true}
433                 ).then(function(carriers) {
434                     service.sms_carriers = carriers;
435                 })
436             );
437         } else {
438             // if other promises are added below, this is not necessary.
439             promises.push($q.when());  
440         }
441
442         // other post-org-settings processing goes here,
443         // adding to promises as needed.
444
445         return $q.all(promises);
446     };
447
448     service.get_ident_types = function() {
449         if (egCore.env.cit) {
450             service.ident_types = egCore.env.cit.list;
451             return $q.when();
452         } else {
453             return egCore.pcrud.retrieveAll('cit', {}, {atomic : true})
454             .then(function(types) { 
455                 egCore.env.absorbList(types, 'cit')
456                 service.ident_types = types 
457             });
458         }
459     };
460
461     service.get_net_access_levels = function() {
462         if (egCore.env.cnal) {
463             service.net_access_levels = egCore.env.cnal.list;
464             return $q.when();
465         } else {
466             return egCore.pcrud.retrieveAll('cnal', {}, {atomic : true})
467             .then(function(levels) { 
468                 egCore.env.absorbList(levels, 'cnal')
469                 service.net_access_levels = levels 
470             });
471         }
472     }
473
474     service.get_perm_groups = function() {
475         if (egCore.env.pgt) {
476             service.profiles = egCore.env.pgt.list;
477             return service.set_edit_profiles();
478         } else {
479             return egCore.pcrud.search('pgt', {parent : null}, 
480                 {flesh : -1, flesh_fields : {pgt : ['children']}}
481             ).then(
482                 function(tree) {
483                     egCore.env.absorbTree(tree, 'pgt')
484                     service.profiles = egCore.env.pgt.list;
485                     return service.set_edit_profiles();
486                 }
487             );
488         }
489     }
490
491     service.searchPermGroupEntries = function(org) {
492         return egCore.pcrud.search('pgtde', {org: org, parent: null},
493             {flesh: -1, flesh_fields: {pgtde: ['grp', 'children']}}, {atomic: true}
494         ).then(function(treeArray) {
495             if (!treeArray.length && egCore.org.get(org).parent_ou()) {
496                 return service.searchPermGroupEntries(egCore.org.get(org).parent_ou());
497             }
498             return treeArray;
499         });
500     }
501
502     service.get_perm_group_entries = function() {
503         if (egCore.env.pgtde) {
504             service.profile_entries = egCore.env.pgtde.list;
505             return service.set_edit_profile_entries();
506         } else {
507             return service.searchPermGroupEntries(egCore.auth.user().ws_ou()).then(function(treeArray) {
508                 function compare(a,b) {
509                   if (a.position() > b.position())
510                     return -1;
511                   if (a.position() < b.position())
512                     return 1;
513                   return 0;
514                 }
515
516                 var list = [];
517                 function squash(node) {
518                     node.children().sort(compare);
519                     list.push(node);
520                     angular.forEach(node.children(), squash);
521                 }
522
523                 angular.forEach(treeArray, squash);
524                 var blob = egCore.env.absorbList(list, 'pgtde');
525                 blob.tree = treeArray;
526
527                 service.profile_entries = egCore.env.pgtde.list;
528                 return service.set_edit_profile_entries();
529             });
530         }
531     }
532
533     service.get_field_doc = function() {
534         var to_cache = [];
535         return egCore.pcrud.search('fdoc', {
536             fm_class: ['au', 'ac', 'aua', 'actsc', 'asv', 'asvq', 'asva']})
537         .then(
538             function () {
539                 return egLovefield.setListInOfflineCache('fdoc', to_cache)
540             },
541             null,
542             function(doc) {
543                 if (!service.field_doc[doc.fm_class()]) {
544                     service.field_doc[doc.fm_class()] = {};
545                 }
546                 service.field_doc[doc.fm_class()][doc.field()] = doc;
547                 to_cache.push(doc);
548             }
549         );
550
551     };
552
553     service.get_user_setting_types = function() {
554
555         // No need to re-fetch the common setting types.
556         if (Object.keys(service.user_setting_types).length) 
557             return $q.when();
558
559         var org_ids = egCore.org.ancestors(egCore.auth.user().ws_ou(), true);
560
561         var static_types = [
562             'circ.holds_behind_desk', 
563             'circ.collections.exempt', 
564             'opac.hold_notify', 
565             'opac.default_phone', 
566             'opac.default_pickup_location', 
567             'opac.default_sms_carrier', 
568             'opac.default_sms_notify'];
569
570         return egCore.pcrud.search('cust', {
571             '-or' : [
572                 {name : static_types}, // common user settings
573                 {name : { // opt-in notification user settings
574                     'in': {
575                         select : {atevdef : ['opt_in_setting']}, 
576                         from : 'atevdef',
577                         // we only care about opt-in settings for 
578                         // event_defs our users encounter
579                         where : {'+atevdef' : {owner : org_ids}}
580                     }
581                 }}
582             ]
583         }, {}, {atomic : true}).then(function(setting_types) {
584
585             egCore.env.absorbList(setting_types, 'cust'); // why not...
586
587             angular.forEach(setting_types, function(stype) {
588                 service.user_setting_types[stype.name()] = stype;
589                 if (static_types.indexOf(stype.name()) == -1) {
590                     service.opt_in_setting_types[stype.name()] = stype;
591                 }
592             });
593         });
594     };
595
596     service.get_user_settings = function() {
597
598         return service.get_user_setting_types()
599         .then(function() {
600
601             var setting_types = Object.values(service.user_setting_types);
602
603             if (service.patron_id) {
604                 // retrieve applied values for the current user 
605                 // for the setting types we care about.
606
607                 var setting_names = 
608                     setting_types.map(function(obj) { return obj.name() });
609
610                 return egCore.net.request(
611                     'open-ils.actor', 
612                     'open-ils.actor.patron.settings.retrieve.authoritative',
613                     egCore.auth.token(),
614                     service.patron_id,
615                     setting_names
616                 ).then(function(settings) {
617                     service.user_settings = settings;
618                 });
619
620             } else {
621
622                 // apply default user setting values
623                 angular.forEach(setting_types, function(stype, index) {
624                     if (stype.reg_default() != undefined) {
625                         var val = stype.reg_default();
626                         if (stype.datatype() == 'bool') {
627                             // A boolean user setting type whose default 
628                             // value starts with t/T is considered 'true',
629                             // false otherwise.
630                             val = Boolean((val+'').match(/^t/i));
631                         }
632                         service.user_settings[stype.name()] = val;
633                     }
634                 });
635             }
636         });
637     }
638
639     service.invalidate_field = function(patron, field) {
640         console.log('Invalidating patron field ' + field);
641
642         return egCore.net.request(
643             'open-ils.actor',
644             'open-ils.actor.invalidate.' + field,
645             egCore.auth.token(), patron.id, null, patron.home_ou.id()
646
647         ).then(function(res) {
648             // clear the invalid value from the form
649             patron[field] = '';
650
651             // update last_xact_id so future save operations
652             // on this patron will be allowed
653             patron.last_xact_id = res.payload.last_xact_id[patron.id];
654         });
655     }
656
657     service.dupe_patron_search = function(patron, type, value) {
658         var search;
659
660         console.log('Dupe search called with "'+ type +'" and value '+ value);
661
662         if (type.match(/phone/)) type = 'phone'; // day_phone, etc.
663
664         switch (type) {
665
666             case 'name':
667                 var fname = patron.first_given_name;   
668                 var lname = patron.family_name;   
669                 if (!(fname && lname)) return $q.when({count:0});
670                 search = {
671                     first_given_name : {value : fname, group : 0},
672                     family_name : {value : lname, group : 0}
673                 };
674                 break;
675
676             case 'email':
677                 search = {email : {value : value, group : 0}};
678                 break;
679
680             case 'ident':
681                 search = {ident : {value : value, group : 2}};
682                 break;
683
684             case 'phone':
685                 search = {phone : {value : value, group : 2}};
686                 break;
687
688             case 'address':
689                 search = {};
690                 angular.forEach(['street1', 'street2', 'city', 'post_code'],
691                     function(field) {
692                         if(value[field])
693                             search[field] = {value : value[field], group: 1};
694                     }
695                 );
696                 break;
697         }
698
699         return egCore.net.request( 
700             'open-ils.actor', 
701             'open-ils.actor.patron.search.advanced',
702             egCore.auth.token(), search, null, null, 1
703         ).then(function(res) {
704             res = res.filter(function(id) {return id != patron.id});
705             return {
706                 count : res.length,
707                 search : search
708             };
709         });
710     }
711
712     service.init_patron = function(current) {
713
714         if (!current)
715             return $q.when(service.init_new_patron());
716
717         service.patron = current;
718         return $q.when(service.init_existing_patron(current));
719     }
720
721     service.ingest_address = function(patron, addr) {
722         addr.valid = addr.valid == 't';
723         addr.within_city_limits = addr.within_city_limits == 't';
724         addr._is_mailing = (patron.mailing_address && 
725             addr.id == patron.mailing_address.id);
726         addr._is_billing = (patron.billing_address && 
727             addr.id == patron.billing_address.id);
728         addr.pending = addr.pending === 't';
729     }
730
731     service.ingest_waiver_entry = function(patron, waiver_entry) {
732         waiver_entry.place_holds = waiver_entry.place_holds == 't';
733         waiver_entry.pickup_holds = waiver_entry.pickup_holds == 't';
734         waiver_entry.view_history = waiver_entry.view_history == 't';
735         waiver_entry.checkout_items = waiver_entry.checkout_items == 't';
736     }
737
738     /*
739      * Existing patron objects reqire some data munging before insertion
740      * into the scope.
741      *
742      * 1. Turn everything into a hash
743      * 2. ... Except certain fields (selectors) whose widgets require objects
744      * 3. Bools must be Boolean, not t/f.
745      */
746     service.init_existing_patron = function(current) {
747
748         service.existing_patron = current;
749
750         var patron = egCore.idl.toHash(current);
751
752         patron.home_ou = egCore.org.get(patron.home_ou.id);
753         patron.expire_date = new Date(Date.parse(patron.expire_date));
754         patron.dob = service.parse_dob(patron.dob);
755         patron.profile = current.profile(); // pre-hash version
756         patron.net_access_level = current.net_access_level();
757         patron.ident_type = current.ident_type();
758         patron.ident_type2 = current.ident_type2();
759         patron.groups = current.groups(); // pre-hash
760
761         angular.forEach(
762             ['juvenile', 'barred', 'active', 'master_account'],
763             function(field) { patron[field] = patron[field] == 't'; }
764         );
765
766         angular.forEach(patron.cards, function(card) {
767             card.active = card.active == 't';
768             if (card.id == patron.card.id) {
769                 patron.card = card;
770                 card._primary = true;
771             }
772         });
773
774         angular.forEach(patron.addresses, 
775             function(addr) { service.ingest_address(patron, addr) });
776
777         // Link replaced address to its pending address.
778         angular.forEach(patron.addresses, function(addr) {
779             if (addr.replaces) {
780                 addr._replaces = patron.addresses.filter(
781                     function(a) {return a.id == addr.replaces})[0];
782             }
783         });
784
785         angular.forEach(patron.waiver_entries,
786             function(waiver_entry) { service.ingest_waiver_entry(patron, waiver_entry) });
787
788         service.get_linked_addr_users(patron.addresses);
789
790         // Remove stat cat entries that link to out-of-scope stat
791         // cats.  With this, we avoid unnecessarily updating (or worse,
792         // modifying) stat cat values that are not ours to modify.
793         patron.stat_cat_entries = patron.stat_cat_entries.filter(
794             function(map) {
795                 return Boolean(
796                     // service.stat_cats only contains in-scope stat cats.
797                     service.stat_cats.filter(function(cat) { 
798                         return (cat.id() == map.stat_cat.id) })[0]
799                 );
800             }
801         );
802
803         // toss entries for existing stat cat maps into our living 
804         // stat cat entry map, which is modified within the template.
805         angular.forEach(patron.stat_cat_entries, function(map) {
806             service.stat_cat_entry_maps[map.stat_cat.id] = map.stat_cat_entry;
807         });
808
809         service.patron = patron;
810         return patron;
811     }
812
813     service.init_new_patron = function() {
814         var addr = {
815             id : service.virt_id--,
816             isnew : true,
817             valid : true,
818             address_type : egCore.strings.REG_ADDR_TYPE,
819             _is_mailing : true,
820             _is_billing : true,
821             within_city_limits : false,
822             country : service.org_settings['ui.patron.default_country'],
823         };
824
825         var card = {
826             id : service.virt_id--,
827             isnew : true,
828             active : true,
829             _primary : true
830         };
831
832         var user = {
833             isnew : true,
834             active : true,
835             card : card,
836             cards : [card],
837             home_ou : egCore.org.get(egCore.auth.user().ws_ou()),
838             stat_cat_entries : [],
839             waiver_entries : [],
840             groups : [],
841             addresses : [addr]
842         };
843
844         if (service.clone_user)
845             service.copy_clone_data(user);
846
847         if (service.stage_user)
848             service.copy_stage_data(user);
849
850         return user;
851     }
852
853     // dob is always YYYY-MM-DD
854     // Dates of birth do not contain timezone info, which can lead to
855     // inconcistent timezone handling, potentially representing
856     // different points in time, depending on the implementation.
857     // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse
858     // See "Differences in assumed time zone"
859     // TODO: move this into egDate ?
860     service.parse_dob = function(dob) {
861         if (!dob) return null;
862         var parts = dob.split('-');
863         return new Date(parts[0], parts[1] - 1, parts[2])
864     }
865
866     service.copy_stage_data = function(user) {
867         var cuser = service.stage_user;
868
869         // copy the data into our new user object
870
871         for (var key in egCore.idl.classes.stgu.field_map) {
872             if (egCore.idl.classes.au.field_map[key] &&
873                 !egCore.idl.classes.stgu.field_map[key].virtual) {
874                 if (cuser.user[key]() !== null)
875                     user[key] = cuser.user[key]();
876             }
877         }
878
879         if (user.home_ou) user.home_ou = egCore.org.get(user.home_ou);
880         if (user.profile) user.profile = egCore.env.pgt.map[user.profile];
881         if (user.ident_type) 
882             user.ident_type = egCore.env.cit.map[user.ident_type];
883         if (user.ident_type2)
884             user.ident_type2 = egCore.env.cit.map[user.ident_type2];
885         user.dob = service.parse_dob(user.dob);
886
887         // Clear the usrname if it looks like a UUID
888         if (user.usrname.replace(/-/g,'').match(/[0-9a-f]{32}/)) 
889             user.usrname = '';
890
891         // Don't use stub address if we have one from the staged user.
892         if (cuser.mailing_addresses.length || cuser.billing_addresses.length)
893             user.addresses = [];
894
895         // is_mailing=false implies is_billing
896         function addr_from_stage(stage_addr) {
897             if (!stage_addr) return;
898             var cls = stage_addr.classname;
899
900             var addr = {
901                 id : service.virt_id--,
902                 usr : user.id,
903                 isnew : true,
904                 valid : true,
905                 address_type : egCore.strings.REG_ADDR_TYPE,
906                 _is_mailing : cls == 'stgma',
907                 _is_billing : cls == 'stgba'
908             };
909
910             user.mailing_address = addr;
911             user.addresses.push(addr);
912
913             for (var key in egCore.idl.classes[cls].field_map) {
914                 if (egCore.idl.classes.aua.field_map[key] &&
915                     !egCore.idl.classes[cls].field_map[key].virtual) {
916                     if (stage_addr[key]() !== null)
917                         addr[key] = stage_addr[key]();
918                 }
919             }
920         }
921
922         addr_from_stage(cuser.mailing_addresses[0]);
923         addr_from_stage(cuser.billing_addresses[0]);
924
925         if (user.addresses.length == 1) {
926             // If there is only one address, 
927             // use it as both mailing and billing.
928             var addr = user.addresses[0];
929             addr._is_mailing = addr._is_billing = true;
930             user.mailing_address = user.billing_address = addr;
931         }
932
933         if (cuser.cards.length) {
934             user.card = {
935                 id : service.virt_id--,
936                 barcode : cuser.cards[0].barcode(),
937                 isnew : true,
938                 active : true,
939                 _primary : true
940             };
941
942             user.cards.push(user.card);
943             if (user.usrname == '') 
944                 user.usrname = card.barcode;
945         }
946
947         angular.forEach(cuser.settings, function(setting) {
948             service.user_settings[setting.setting()] = Boolean(setting.value());
949         });
950     }
951
952     // copy select values from the cloned user to the new user.
953     // user is a hash
954     service.copy_clone_data = function(user) {
955         var clone_user = service.clone_user;
956
957         // flesh the home org locally
958         user.home_ou = egCore.org.get(clone_user.home_ou());
959         if (user.profile) user.profile = egCore.env.pgt.map[user.profile];
960
961         if (!clone_user.billing_address() &&
962             !clone_user.mailing_address())
963             return; // no addresses to copy or link
964
965         // if the cloned user has any addresses, we don't need 
966         // the stub address created in init_new_patron.
967         user.addresses = [];
968
969         var copy_addresses = 
970             service.org_settings['circ.patron_edit.clone.copy_address'];
971
972         var clone_fields = [
973             'day_phone',
974             'evening_phone',
975             'other_phone',
976             'usrgroup'
977         ]; 
978
979         angular.forEach(clone_fields, function(field) {
980             user[field] = clone_user[field]();
981         });
982
983         if (copy_addresses) {
984             var bill_addr, mail_addr;
985
986             // copy the billing and mailing addresses into new addresses
987             function clone_addr(addr) {
988                 var new_addr = egCore.idl.toHash(addr);
989                 new_addr.id = service.virt_id--;
990                 new_addr.usr = user.id;
991                 new_addr.isnew = true;
992                 new_addr.valid = true;
993                 user.addresses.push(new_addr);
994                 return new_addr;
995             }
996
997             if (bill_addr = clone_user.billing_address()) {
998                 var addr = clone_addr(bill_addr);
999                 addr._is_billing = true;
1000                 user.billing_address = addr;
1001             }
1002
1003             if (mail_addr = clone_user.mailing_address()) {
1004
1005                 if (bill_addr && bill_addr.id() == mail_addr.id()) {
1006                     user.mailing_address = user.billing_address;
1007                     user.mailing_address._is_mailing = true;
1008                 } else {
1009                     var addr = clone_addr(mail_addr);
1010                     addr._is_mailing = true;
1011                     user.mailing_address = addr;
1012                 }
1013
1014                 if (!bill_addr) {
1015                     // if there is no billing addr, use the mailing addr
1016                     user.billing_address = user.mailing_address;
1017                     user.billing_address._is_billing = true;
1018                 }
1019             }
1020
1021
1022         } else {
1023
1024             // link the billing and mailing addresses
1025             var addr;
1026             if (addr = clone_user.billing_address()) {
1027                 user.billing_address = egCore.idl.toHash(addr);
1028                 user.billing_address._is_billing = true;
1029                 user.addresses.push(user.billing_address);
1030                 user.billing_address._linked_owner_id = clone_user.id();
1031                 user.billing_address._linked_owner = service.format_name(
1032                     clone_user.family_name(),
1033                     clone_user.first_given_name(),
1034                     clone_user.second_given_name()
1035                 );
1036             }
1037
1038             if (addr = clone_user.mailing_address()) {
1039                 if (user.billing_address && 
1040                     addr.id() == user.billing_address.id) {
1041                     // mailing matches billing
1042                     user.mailing_address = user.billing_address;
1043                     user.mailing_address._is_mailing = true;
1044                 } else {
1045                     user.mailing_address = egCore.idl.toHash(addr);
1046                     user.mailing_address._is_mailing = true;
1047                     user.addresses.push(user.mailing_address);
1048                     user.mailing_address._linked_owner_id = clone_user.id();
1049                     user.mailing_address._linked_owner = service.format_name(
1050                         clone_user.family_name(),
1051                         clone_user.first_given_name(),
1052                         clone_user.second_given_name()
1053                     );
1054                 }
1055             }
1056         }
1057     }
1058
1059     // translate the patron back into IDL form
1060     service.save_user = function(phash) {
1061
1062         var patron = egCore.idl.fromHash('au', phash);
1063
1064         patron.home_ou(patron.home_ou().id());
1065         patron.expire_date(patron.expire_date().toISOString());
1066         patron.profile(patron.profile().id());
1067         if (patron.dob()) 
1068             patron.dob(patron.dob().toISOString().replace(/T.*/,''));
1069         if (patron.ident_type()) 
1070             patron.ident_type(patron.ident_type().id());
1071         if (patron.net_access_level())
1072             patron.net_access_level(patron.net_access_level().id());
1073
1074         angular.forEach(
1075             ['juvenile', 'barred', 'active', 'master_account'],
1076             function(field) { patron[field](phash[field] ? 't' : 'f'); }
1077         );
1078
1079         var card_hashes = patron.cards();
1080         patron.cards([]);
1081         angular.forEach(card_hashes, function(chash) {
1082             var card = egCore.idl.fromHash('ac', chash)
1083             card.usr(patron.id());
1084             card.active(chash.active ? 't' : 'f');
1085             patron.cards().push(card);
1086             if (chash._primary) {
1087                 patron.card(card);
1088             }
1089         });
1090
1091         var addr_hashes = patron.addresses();
1092         patron.addresses([]);
1093         angular.forEach(addr_hashes, function(addr_hash) {
1094             if (!addr_hash.isnew && !addr_hash.isdeleted) 
1095                 addr_hash.ischanged = true;
1096             var addr = egCore.idl.fromHash('aua', addr_hash);
1097             patron.addresses().push(addr);
1098             addr.valid(addr.valid() ? 't' : 'f');
1099             addr.within_city_limits(addr.within_city_limits() ? 't' : 'f');
1100             addr.pending(addr.pending() ? 't' : 'f');
1101             if (addr_hash._is_mailing) patron.mailing_address(addr);
1102             if (addr_hash._is_billing) patron.billing_address(addr);
1103         });
1104
1105         patron.survey_responses([]);
1106         angular.forEach(service.survey_responses, function(answer) {
1107             var question = service.survey_questions[answer.question()];
1108             var resp = new egCore.idl.asvr();
1109             resp.isnew(true);
1110             resp.survey(question.survey());
1111             resp.question(question.id());
1112             resp.answer(answer.id());
1113             resp.usr(patron.id());
1114             resp.answer_date('now');
1115             patron.survey_responses().push(resp);
1116         });
1117         
1118         // re-object-ify the patron stat cat entry maps
1119         var maps = [];
1120         angular.forEach(patron.stat_cat_entries(), function(entry) {
1121             var e = egCore.idl.fromHash('actscecm', entry);
1122             e.stat_cat(e.stat_cat().id);
1123             maps.push(e);
1124         });
1125         patron.stat_cat_entries(maps);
1126
1127         // service.stat_cat_entry_maps maps stats to values
1128         // patron.stat_cat_entries is an array of stat_cat_entry_usr_map's
1129         angular.forEach(
1130             service.stat_cat_entry_maps, function(value, cat_id) {
1131
1132             // see if we already have a mapping for this entry
1133             var existing = patron.stat_cat_entries().filter(
1134                 function(e) { return e.stat_cat() == cat_id })[0];
1135
1136             if (existing) { // we have a mapping
1137                 // if the existing mapping matches the new one,
1138                 // there' nothing left to do
1139                 if (existing.stat_cat_entry() == value) return;
1140
1141                 // mappings differ.  delete the old one and create
1142                 // a new one below.
1143                 existing.isdeleted(true);
1144             }
1145
1146             var newmap = new egCore.idl.actscecm();
1147             newmap.target_usr(patron.id());
1148             newmap.isnew(true);
1149             newmap.stat_cat(cat_id);
1150             newmap.stat_cat_entry(value);
1151             patron.stat_cat_entries().push(newmap);
1152         });
1153
1154         var waiver_hashes = patron.waiver_entries();
1155         patron.waiver_entries([]);
1156         angular.forEach(waiver_hashes, function(waiver_hash) {
1157             if (!waiver_hash.isnew && !waiver_hash.isdeleted)
1158                 waiver_hash.ischanged = true;
1159             var waiver_entry = egCore.idl.fromHash('aupw', waiver_hash);
1160             patron.waiver_entries().push(waiver_entry);
1161         });
1162
1163         if (!patron.isnew()) patron.ischanged(true);
1164
1165         return egCore.net.request(
1166             'open-ils.actor', 
1167             'open-ils.actor.patron.update',
1168             egCore.auth.token(), patron);
1169     }
1170
1171     service.remove_staged_user = function() {
1172         if (!service.stage_user) return $q.when();
1173         return egCore.net.request(
1174             'open-ils.actor',
1175             'open-ils.actor.user.stage.delete',
1176             egCore.auth.token(),
1177             service.stage_user.user.row_id()
1178         );
1179     }
1180
1181     service.save_user_settings = function(new_user, user_settings) {
1182
1183         var settings = {};
1184         if (service.patron_id) {
1185             // Update all user editor setting values for existing 
1186             // users regardless of whether a value changed.
1187             settings = user_settings;
1188
1189         } else {
1190             // Create settings for all non-null setting values for new patrons.
1191             angular.forEach(user_settings, function(val, key) {
1192                 if (val !== null) settings[key] = val;
1193             });
1194         }
1195
1196         if (Object.keys(settings).length == 0) return $q.when();
1197
1198         return egCore.net.request(
1199             'open-ils.actor',
1200             'open-ils.actor.patron.settings.update',
1201             egCore.auth.token(), new_user.id(), settings
1202         ).then(function(resp) {
1203             return resp;
1204         });
1205     }
1206
1207     // Applies field-specific validation regex's from org settings 
1208     // to form fields.  Be careful not remove any pattern data we
1209     // are not explicitly over-writing in the provided patterns obj.
1210     service.set_field_patterns = function(patterns) {
1211         if (service.org_settings['opac.username_regex']) {
1212             patterns.au.usrname = 
1213                 new RegExp(service.org_settings['opac.username_regex']);
1214         }
1215
1216         if (service.org_settings['ui.patron.edit.ac.barcode.regex']) {
1217             patterns.ac.barcode = 
1218                 new RegExp(service.org_settings['ui.patron.edit.ac.barcode.regex']);
1219         }
1220
1221         if (service.org_settings['global.password_regex']) {
1222             patterns.au.passwd = 
1223                 new RegExp(service.org_settings['global.password_regex']);
1224         }
1225
1226         var phone_reg = service.org_settings['ui.patron.edit.phone.regex'];
1227         if (phone_reg) {
1228             // apply generic phone regex first, replace below as needed.
1229             patterns.au.day_phone = new RegExp(phone_reg);
1230             patterns.au.evening_phone = new RegExp(phone_reg);
1231             patterns.au.other_phone = new RegExp(phone_reg);
1232         }
1233
1234         // the remaining patterns fit a well-known key name pattern
1235
1236         angular.forEach(service.org_settings, function(val, key) {
1237             if (!val) return;
1238             var parts = key.match(/ui.patron.edit\.(\w+)\.(\w+)\.regex/);
1239             if (!parts) return;
1240             var cls = parts[1];
1241             var name = parts[2];
1242             patterns[cls][name] = new RegExp(val);
1243         });
1244     }
1245
1246     return service;
1247 }])
1248
1249 .controller('PatronRegCtrl',
1250        ['$scope','$routeParams','$q','$uibModal','$window','egCore',
1251         'patronSvc','patronRegSvc','egUnloadPrompt','egAlertDialog',
1252         'egWorkLog', '$timeout',
1253 function($scope , $routeParams , $q , $uibModal , $window , egCore ,
1254          patronSvc , patronRegSvc , egUnloadPrompt, egAlertDialog ,
1255          egWorkLog, $timeout) {
1256
1257     $scope.page_data_loaded = false;
1258     $scope.hold_notify_type = { phone : null, email : null, sms : null };
1259     $scope.clone_id = patronRegSvc.clone_id = $routeParams.clone_id;
1260     $scope.stage_username = 
1261         patronRegSvc.stage_username = $routeParams.stage_username;
1262     $scope.patron_id = 
1263         patronRegSvc.patron_id = $routeParams.edit_id || $routeParams.id;
1264
1265     // for existing patrons, disable barcode input by default
1266     $scope.disable_bc = $scope.focus_usrname = Boolean($scope.patron_id);
1267     $scope.focus_bc = !Boolean($scope.patron_id);
1268     $scope.address_alerts = [];
1269     $scope.dupe_counts = {};
1270
1271     // map of perm name to true/false for perms the logged in user
1272     // has at the currently selected patron home org unit.
1273     $scope.perms = {};
1274
1275     $scope.name_tab = 'primary';
1276
1277     if (!$scope.edit_passthru) {
1278         // in edit more, scope.edit_passthru is delivered to us by
1279         // the enclosing controller.  In register mode, there is 
1280         // no enclosing controller, so we create our own.
1281         $scope.edit_passthru = {};
1282     }
1283
1284     // 0=all, 1=suggested, 2=all
1285     $scope.edit_passthru.vis_level = 0; 
1286
1287     // Apply default values for new patrons during initial registration
1288     // prs is shorthand for patronSvc
1289     function set_new_patron_defaults(prs) {
1290         if (!$scope.patron.passwd) {
1291             // passsword may originate from staged user.
1292             $scope.generate_password();
1293         }
1294         $scope.hold_notify_type.phone = true;
1295         $scope.hold_notify_type.email = true;
1296         $scope.hold_notify_type.sms = false;
1297
1298         // staged users may be loaded w/ a profile.
1299         $scope.set_expire_date();
1300
1301         if (prs.org_settings['ui.patron.default_ident_type']) {
1302             // $scope.patron needs this field to be an object
1303             var id = prs.org_settings['ui.patron.default_ident_type'];
1304             var ident_type = $scope.ident_types.filter(
1305                 function(type) { return type.id() == id })[0];
1306             $scope.patron.ident_type = ident_type;
1307         }
1308         if (prs.org_settings['ui.patron.default_inet_access_level']) {
1309             // $scope.patron needs this field to be an object
1310             var id = prs.org_settings['ui.patron.default_inet_access_level'];
1311             var level = $scope.net_access_levels.filter(
1312                 function(lvl) { return lvl.id() == id })[0];
1313             $scope.patron.net_access_level = level;
1314         }
1315         if (prs.org_settings['ui.patron.default_country']) {
1316             $scope.patron.addresses[0].country = 
1317                 prs.org_settings['ui.patron.default_country'];
1318         }
1319     }
1320
1321     // A null or undefined pattern leads to exceptions.  Before the
1322     // patterns are loaded from the server, default all patterns
1323     // to an innocuous regex.  To avoid re-creating numerous
1324     // RegExp objects, cache the stub RegExp after initial creation.
1325     // note: angular docs say ng-pattern accepts a regexp or string,
1326     // but as of writing, it only works with a regexp object.
1327     // (Likely an angular 1.2 vs. 1.4 issue).
1328     var field_patterns = {au : {}, ac : {}, aua : {}};
1329     $scope.field_pattern = function(cls, field) { 
1330         if (!field_patterns[cls][field])
1331             field_patterns[cls][field] = new RegExp('.*');
1332         return field_patterns[cls][field];
1333     }
1334
1335     // Main page load function.  Kicks off tab init and data loading.
1336     $q.all([
1337
1338         $scope.initTab ? // initTab comes from patron app
1339             $scope.initTab('edit', $routeParams.id) : $q.when(),
1340
1341         patronRegSvc.init(),
1342
1343     ]).then(function(){ return patronRegSvc.init_patron(patronSvc ? patronSvc.current : patronRegSvc.patron ) })
1344       .then(function(patron) {
1345         // called after initTab and patronRegSvc.init have completed
1346         // in standalone mode, we have no patronSvc
1347         var prs = patronRegSvc;
1348         $scope.patron = patron;
1349         $scope.field_doc = prs.field_doc;
1350         $scope.edit_profiles = prs.edit_profiles;
1351         $scope.edit_profile_entries = prs.edit_profile_entries;
1352         $scope.ident_types = prs.ident_types;
1353         $scope.net_access_levels = prs.net_access_levels;
1354         $scope.user_setting_types = prs.user_setting_types;
1355         $scope.opt_in_setting_types = prs.opt_in_setting_types;
1356         $scope.org_settings = prs.org_settings;
1357         $scope.sms_carriers = prs.sms_carriers;
1358         $scope.stat_cats = prs.stat_cats;
1359         $scope.surveys = prs.surveys;
1360         $scope.survey_responses = prs.survey_responses;
1361         $scope.stat_cat_entry_maps = prs.stat_cat_entry_maps;
1362         $scope.stage_user = prs.stage_user;
1363         $scope.stage_user_requestor = prs.stage_user_requestor;
1364
1365         $scope.user_settings = prs.user_settings;
1366         prs.user_settings = {};
1367
1368         // If a default pickup lib is applied to the patron, apply it 
1369         // to the UI at page load time.  Otherwise, leave the value unset.
1370         if ($scope.user_settings['opac.default_pickup_location']) {
1371             $scope.patron._pickup_lib = egCore.org.get(
1372                 $scope.user_settings['opac.default_pickup_location']);
1373         }
1374
1375         extract_hold_notify();
1376         if ($scope.patron.isnew)
1377             set_new_patron_defaults(prs);
1378
1379         $scope.handle_home_org_changed();
1380
1381         if ($scope.org_settings['ui.patron.edit.default_suggested'])
1382             $scope.edit_passthru.vis_level = 1;
1383
1384         // Stat cats are fetched from open-ils.storage, where 't'==1
1385         $scope.hasRequiredStatCat = prs.stat_cats.filter(
1386                 function(cat) {return cat.required() == 1} ).length > 0;
1387
1388         $scope.page_data_loaded = true;
1389
1390         prs.set_field_patterns(field_patterns);
1391         apply_username_regex();
1392
1393         add_date_watchers();
1394
1395         if ($scope.org_settings['ui.patron.edit.guardian_required_for_juv']) {
1396             add_juv_watcher();
1397         }
1398     });
1399
1400     function add_date_watchers() {
1401
1402         $scope.$watch('patron.dob', function(newVal, oldVal) {
1403             // Even though this runs after page data load, there
1404             // are still times when it fires unnecessarily.
1405             if (newVal === oldVal) return;
1406
1407             console.debug('dob change: ' + newVal + ' : ' + oldVal);
1408             maintain_juvenile_flag();
1409         });
1410
1411         // No need to watch expire_date
1412     }
1413
1414     function add_juv_watcher() {
1415         $scope.$watch('patron.juvenile', function(newVal, oldVal) {
1416             if (newVal === oldVal) return;
1417             if (newVal) {
1418                 field_visibility['au.guardian'] = 3; // required
1419             } else {
1420                 // Value will be reassessed by show_field()
1421                 delete field_visibility['au.guardian'];
1422             }
1423         });
1424     }
1425
1426     // update the currently displayed field documentation
1427     $scope.set_selected_field_doc = function(cls, field) {
1428         $scope.selected_field_doc = $scope.field_doc[cls][field];
1429     }
1430
1431     // returns the tree depth of the selected profile group tree node.
1432     $scope.pgt_depth = function(grp) {
1433         var d = 0;
1434         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
1435         return d;
1436     }
1437
1438     // returns the tree depth of the selected profile group tree node.
1439     $scope.pgtde_depth = function(entry) {
1440         var d = 0;
1441         while (entry = egCore.env.pgtde.map[entry.parent()]) d++;
1442         return d;
1443     }
1444
1445     // IDL fields used for labels in the UI.
1446     $scope.idl_fields = {
1447         au  : egCore.idl.classes.au.field_map,
1448         ac  : egCore.idl.classes.ac.field_map,
1449         aua : egCore.idl.classes.aua.field_map
1450     };
1451
1452     // field visibility cache.  Some fields are universally required.
1453     // 3 == value universally required
1454     // 2 == field is visible by default
1455     // 1 == field is suggested by default
1456     var field_visibility = {};
1457     var default_field_visibility = {
1458         'ac.barcode' : 3,
1459         'au.usrname' : 3,
1460         'au.passwd' :  3,
1461         'au.first_given_name' : 3,
1462         'au.family_name' : 3,
1463         'au.pref_first_given_name' : 2,
1464         'au.pref_family_name' : 2,
1465         'au.ident_type' : 3,
1466         'au.ident_type2' : 2,
1467         'au.home_ou' : 3,
1468         'au.profile' : 3,
1469         'au.expire_date' : 3,
1470         'au.net_access_level' : 3,
1471         'aua.address_type' : 3,
1472         'aua.post_code' : 3,
1473         'aua.street1' : 3,
1474         'aua.street2' : 2,
1475         'aua.city' : 3,
1476         'aua.county' : 2,
1477         'aua.state' : 2,
1478         'aua.country' : 3,
1479         'aua.valid' : 2,
1480         'aua.within_city_limits' : 2,
1481         'stat_cats' : 1,
1482         'surveys' : 1,
1483         'au.name_keywords': 1
1484     }; 
1485
1486     // Returns true if the selected field should be visible
1487     // given the current required/suggested/all setting.
1488     // The visibility flag applied to each field as a result of calling
1489     // this function also sets (via the same flag) the requiredness state.
1490     $scope.show_field = function(field_key) {
1491         // org settings have not been received yet.
1492         if (!$scope.org_settings) return false;
1493
1494         if (field_visibility[field_key] == undefined) {
1495             // compile and cache the visibility for the selected field
1496
1497             // The preferred name fields use the primary name field settings
1498             var org_key = field_key;
1499             var alt_name = false;
1500             if (field_key.match(/^au.alt_/)) {
1501                 alt_name = true;
1502                 org_key = field_key.slice(7);
1503             }
1504
1505             var req_set = 'ui.patron.edit.' + org_key + '.require';
1506             var sho_set = 'ui.patron.edit.' + org_key + '.show';
1507             var sug_set = 'ui.patron.edit.' + org_key + '.suggest';
1508
1509             if ($scope.org_settings[req_set]) {
1510                 if (alt_name) {
1511                     // Avoid requiring alt name fields when primary 
1512                     // name fields are required.
1513                     field_visibility[field_key] = 2;
1514                 } else {
1515                     field_visibility[field_key] = 3;
1516                 }
1517
1518             } else if ($scope.org_settings[sho_set]) {
1519                 field_visibility[field_key] = 2;
1520
1521             } else if ($scope.org_settings[sug_set]) {
1522                 field_visibility[field_key] = 1;
1523             }
1524         }
1525
1526         if (field_visibility[field_key] == undefined) {
1527             // No org settings were applied above.  Use the default
1528             // settings if present or assume the field has no
1529             // visibility flags applied.
1530             field_visibility[field_key] = 
1531                 default_field_visibility[field_key] || 0;
1532         }
1533
1534         return field_visibility[field_key] >= $scope.edit_passthru.vis_level;
1535     }
1536
1537     // See $scope.show_field().
1538     // A field with visbility level 3 means it's required.
1539     $scope.field_required = function(cls, field) {
1540
1541         // Value in the password field is not required
1542         // for existing patrons.
1543         if (field == 'passwd' && $scope.patron && !$scope.patron.isnew) 
1544           return false;
1545
1546         return (field_visibility[cls + '.' + field] == 3);
1547     }
1548
1549     // generates a random 4-digit password
1550     $scope.generate_password = function() {
1551         $scope.patron.passwd = Math.floor(Math.random()*9000) + 1000;
1552     }
1553
1554     $scope.set_expire_date = function() {
1555         if (!$scope.patron.profile) return;
1556         var seconds = egCore.date.intervalToSeconds(
1557             $scope.patron.profile.perm_interval());
1558         var now_epoch = new Date().getTime();
1559         $scope.patron.expire_date = new Date(
1560             now_epoch + (seconds * 1000 /* milliseconds */))
1561         $scope.field_modified();
1562     }
1563
1564     // grp is the pgt object
1565     $scope.set_profile = function(grp) {
1566         $scope.patron.profile = grp;
1567         $scope.set_expire_date();
1568         $scope.field_modified();
1569     }
1570
1571     $scope.invalid_profile = function() {
1572         return !(
1573             $scope.patron && 
1574             $scope.patron.profile && 
1575             $scope.patron.profile.usergroup() == 't'
1576         );
1577     }
1578
1579     $scope.new_address = function() {
1580         var addr = egCore.idl.toHash(new egCore.idl.aua());
1581         patronRegSvc.ingest_address($scope.patron, addr);
1582         addr.id = patronRegSvc.virt_id--;
1583         addr.isnew = true;
1584         addr.valid = true;
1585         addr.within_city_limits = true;
1586         addr.country = $scope.org_settings['ui.patron.default_country'];
1587         $scope.patron.addresses.push(addr);
1588     }
1589
1590     // keep deleted addresses out of the patron object so
1591     // they won't appear in the UI.  They'll be re-inserted
1592     // when the patron is updated.
1593     deleted_addresses = [];
1594     $scope.delete_address = function(id) {
1595
1596         if ($scope.patron.isnew &&
1597             $scope.patron.addresses.length == 1 &&
1598             $scope.org_settings['ui.patron.registration.require_address']) {
1599             egAlertDialog.open(egCore.strings.REG_ADDR_REQUIRED);
1600             return;
1601         }
1602
1603         var addresses = [];
1604         angular.forEach($scope.patron.addresses, function(addr) {
1605             if (addr.id == id) {
1606                 if (id > 0) {
1607                     addr.isdeleted = true;
1608                     deleted_addresses.push(addr);
1609                 }
1610             } else {
1611                 addresses.push(addr);
1612             }
1613         });
1614         $scope.patron.addresses = addresses;
1615     } 
1616
1617     $scope.approve_pending_address = function(addr) {
1618
1619         egCore.net.request(
1620             'open-ils.actor',
1621             'open-ils.actor.user.pending_address.approve',
1622             egCore.auth.token(), addr.id
1623         ).then(function(replaced_id) {
1624             var evt = egCore.evt.parse(replaced_id);
1625             if (evt) { alert(evt); return; }
1626
1627             // Remove the pending address and the replaced address
1628             // from the local list of patron addresses.
1629             var addresses = [];
1630             angular.forEach($scope.patron.addresses, function(a) {
1631                 if (a.id != addr.id && a.id != replaced_id) {
1632                     addresses.push(a);
1633                 }
1634             });
1635             $scope.patron.addresses = addresses;
1636
1637             // Fetch a fresh copy of the modified address from the server.
1638             // and add it back to the list.
1639             egCore.pcrud.retrieve('aua', replaced_id, {}, {authoritative: true})
1640             .then(null, null, function(new_addr) {
1641                 new_addr = egCore.idl.toHash(new_addr);
1642                 patronRegSvc.ingest_address($scope.patron, new_addr);
1643                 $scope.patron.addresses.push(new_addr);
1644             });
1645         });
1646     }
1647
1648     $scope.post_code_changed = function(addr) { 
1649         egCore.net.request(
1650             'open-ils.search', 'open-ils.search.zip', addr.post_code)
1651         .then(function(resp) {
1652             if (!resp) return;
1653             if (resp.city) addr.city = resp.city;
1654             if (resp.state) addr.state = resp.state;
1655             if (resp.county) addr.county = resp.county;
1656             if (resp.alert) alert(resp.alert);
1657         });
1658     }
1659
1660     $scope.new_waiver_entry = function() {
1661         var waiver = egCore.idl.toHash(new egCore.idl.aupw());
1662         patronRegSvc.ingest_waiver_entry($scope.patron, waiver);
1663         waiver.id = patronRegSvc.virt_id--;
1664         waiver.isnew = true;
1665         $scope.patron.waiver_entries.push(waiver);
1666     }
1667
1668     deleted_waiver_entries = [];
1669     $scope.delete_waiver_entry = function(waiver_entry) {
1670         if (waiver_entry.id > 0) {
1671             waiver_entry.isdeleted = true;
1672             deleted_waiver_entries.push(waiver_entry);
1673         }
1674         var index = $scope.patron.waiver_entries.indexOf(waiver_entry);
1675         $scope.patron.waiver_entries.splice(index, 1);
1676     }
1677
1678     $scope.replace_card = function() {
1679         $scope.patron.card.active = false;
1680         $scope.patron.card.ischanged = true;
1681         $scope.disable_bc = false;
1682
1683         var new_card = egCore.idl.toHash(new egCore.idl.ac());
1684         new_card.id = patronRegSvc.virt_id--;
1685         new_card.isnew = true;
1686         new_card.active = true;
1687         new_card._primary = 'on';
1688         $scope.patron.card = new_card;
1689
1690         // Remove any previous attempts to replace the card, since they
1691         // may be incomplete or created by accident.
1692         $scope.patron.cards =
1693             $scope.patron.cards.filter(function(c) {return !c.isnew})
1694         $scope.patron.cards.push(new_card);
1695     }
1696
1697     $scope.day_phone_changed = function(phone) {
1698         if (phone && $scope.patron.isnew && 
1699             $scope.org_settings['patron.password.use_phone']) {
1700             $scope.patron.passwd = phone.substr(-4);
1701         }
1702     }
1703
1704     $scope.barcode_changed = function(bc) {
1705         if (!bc) return;
1706         $scope.dupe_barcode = false;
1707         egCore.net.request(
1708             'open-ils.actor',
1709             'open-ils.actor.barcode.exists',
1710             egCore.auth.token(), bc
1711         ).then(function(resp) {
1712             if (resp == '1') { // duplicate card
1713                 $scope.dupe_barcode = true;
1714                 console.log('duplicate barcode detected: ' + bc);
1715             } else {
1716                 if (!$scope.patron.usrname)
1717                     $scope.patron.usrname = bc;
1718                 // No dupe -- A-OK
1719             }
1720         });
1721     }
1722
1723     $scope.cards_dialog = function() {
1724         $uibModal.open({
1725             templateUrl: './circ/patron/t_patron_cards_dialog',
1726             backdrop: 'static',
1727             controller: 
1728                    ['$scope','$uibModalInstance','cards','perms','patron',
1729             function($scope , $uibModalInstance , cards , perms , patron) {
1730                 // scope here is the modal-level scope
1731                 $scope.args = {cards : cards, primary_barcode : null};
1732                 angular.forEach(cards, function(card) {
1733                     if (card.id == patron.card.id) {
1734                         $scope.args.primary_barcode = card.id;
1735                     }
1736                 });
1737                 $scope.perms = perms;
1738                 $scope.ok = function() { $uibModalInstance.close($scope.args) }
1739                 $scope.cancel = function () { $uibModalInstance.dismiss() }
1740             }],
1741             resolve : {
1742                 cards : function() {
1743                     // scope here is the controller-level scope
1744                     return $scope.patron.cards;
1745                 },
1746                 perms : function() {
1747                     return $scope.perms;
1748                 },
1749                 patron : function() {
1750                     return $scope.patron;
1751                 }
1752             }
1753         }).result.then(
1754             function(args) {
1755                 angular.forEach(args.cards, function(card) {
1756                     card.ischanged = true; // assume cards need updating, OK?
1757                     if (card.id == args.primary_barcode) {
1758                         $scope.patron.card = card;
1759                         card._primary = true;
1760                     } else {
1761                         card._primary = false;
1762                     }
1763                 });
1764             }
1765         );
1766     }
1767
1768     $scope.set_addr_type = function(addr, type) {
1769         var addrs = $scope.patron.addresses;
1770         if (addr['_is_'+type]) {
1771             angular.forEach(addrs, function(a) {
1772                 if (a.id != addr.id) a['_is_'+type] = false;
1773             });
1774         } else {
1775             // unchecking mailing/billing means we have to randomly
1776             // select another address to fill that role.  Select the
1777             // first address in the list (that does not match the
1778             // modifed address)
1779             for (var i = 0; i < addrs.length; i++) {
1780                 if (addrs[i].id != addr.id) {
1781                     addrs[i]['_is_' + type] = true;
1782                     break;
1783                 }
1784             }
1785         }
1786     }
1787
1788
1789     // Translate hold notify preferences from the form/scope back into a 
1790     // single user setting value for opac.hold_notify.
1791     function compress_hold_notify() {
1792         var hold_notify_methods = [];
1793         if ($scope.hold_notify_type.phone) {
1794             hold_notify_methods.push('phone');
1795         }
1796         if ($scope.hold_notify_type.email) {
1797             hold_notify_methods.push('email');
1798         }
1799         if ($scope.hold_notify_type.sms) {
1800             hold_notify_methods.push('sms');
1801         }
1802
1803         $scope.user_settings['opac.hold_notify'] = hold_notify_methods.join(':');
1804     }
1805
1806     // dialog for selecting additional permission groups
1807     $scope.secondary_groups_dialog = function() {
1808         $uibModal.open({
1809             templateUrl: './circ/patron/t_patron_groups_dialog',
1810             backdrop: 'static',
1811             controller: 
1812                    ['$scope','$uibModalInstance','linked_groups','pgt_depth',
1813             function($scope , $uibModalInstance , linked_groups , pgt_depth) {
1814
1815                 $scope.pgt_depth = pgt_depth;
1816                 $scope.args = {
1817                     linked_groups : linked_groups,
1818                     edit_profiles : patronRegSvc.edit_profiles,
1819                     new_profile   : patronRegSvc.edit_profiles[0]
1820                 };
1821
1822                 // add a new group to the linked groups list
1823                 $scope.link_group = function($event, grp) {
1824                     var found = false; // avoid duplicates
1825                     angular.forEach($scope.args.linked_groups, 
1826                         function(g) {if (g.id() == grp.id()) found = true});
1827                     if (!found) $scope.args.linked_groups.push(grp);
1828                     $event.preventDefault(); // avoid close
1829                 }
1830
1831                 // remove a group from the linked groups list
1832                 $scope.unlink_group = function($event, grp) {
1833                     $scope.args.linked_groups = 
1834                         $scope.args.linked_groups.filter(function(g) {
1835                         return g.id() != grp.id()
1836                     });
1837                     $event.preventDefault(); // avoid close
1838                 }
1839
1840                 $scope.ok = function() { $uibModalInstance.close($scope.args) }
1841                 $scope.cancel = function () { $uibModalInstance.dismiss() }
1842             }],
1843             resolve : {
1844                 linked_groups : function() { return $scope.patron.groups },
1845                 pgt_depth : function() { return $scope.pgt_depth }
1846             }
1847         }).result.then(
1848             function(args) {
1849
1850                 if ($scope.patron.isnew) {
1851                     // groups must be linked for new patrons after the
1852                     // patron is created.
1853                     $scope.patron.groups = args.linked_groups;
1854                     return;
1855                 }
1856
1857                 // update links groups for existing users in real time.
1858                 var ids = args.linked_groups.map(function(g) {return g.id()});
1859                 patronRegSvc.apply_secondary_groups($scope.patron.id, ids)
1860                 .then(function(success) {
1861                     if (success)
1862                         $scope.patron.groups = args.linked_groups;
1863                 });
1864             }
1865         );
1866     }
1867
1868     function extract_hold_notify() {
1869         var notify = $scope.user_settings['opac.hold_notify'];
1870         if (!notify) return;
1871         $scope.hold_notify_type.phone = Boolean(notify.match(/phone/));
1872         $scope.hold_notify_type.email = Boolean(notify.match(/email/));
1873         $scope.hold_notify_type.sms = Boolean(notify.match(/sms/));
1874     }
1875
1876     $scope.invalidate_field = function(field) {
1877         patronRegSvc.invalidate_field($scope.patron, field);
1878     }
1879
1880     address_alert = function(addr) {
1881         var args = {
1882             street1: addr.street1,
1883             street2: addr.street2,
1884             city: addr.city,
1885             state: addr.state,
1886             county: addr.county,
1887             country: addr.country,
1888             post_code: addr.post_code,
1889             mailing_address: addr._is_mailing,
1890             billing_address: addr._is_billing
1891         }
1892
1893         egCore.net.request(
1894             'open-ils.actor',
1895             'open-ils.actor.address_alert.test',
1896             egCore.auth.token(), egCore.auth.user().ws_ou(), args
1897             ).then(function(res) {
1898                 $scope.address_alerts = res;
1899         });
1900     }
1901
1902     $scope.dupe_value_changed = function(type, value) {
1903         if (!$scope.dupe_search_encoded)
1904             $scope.dupe_search_encoded = {};
1905
1906         $scope.dupe_counts[type] = 0;
1907
1908         patronRegSvc.dupe_patron_search($scope.patron, type, value)
1909         .then(function(res) {
1910             $scope.dupe_counts[type] = res.count;
1911             if (res.count) {
1912                 $scope.dupe_search_encoded[type] = 
1913                     encodeURIComponent(js2JSON(res.search));
1914             } else {
1915                 $scope.dupe_search_encoded[type] = '';
1916             }
1917         });
1918     }
1919
1920     $scope.handle_home_org_changed = function() {
1921         org_id = $scope.patron.home_ou.id();
1922         patronRegSvc.has_perms_for_org(org_id).then(function(map) {
1923             angular.forEach(map, function(v, k) { $scope.perms[k] = v });
1924         });
1925     }
1926
1927     $scope.handle_pulib_changed = function(org) {
1928         if (!$scope.user_settings) return; // still rendering
1929         $scope.user_settings['opac.default_pickup_location'] = org.id();
1930     }
1931
1932     // This is called with every character typed in a form field,
1933     // since that's the only way to gaurantee something has changed.
1934     // See handle_field_changed for ng-change vs. ng-blur.
1935     $scope.field_modified = function() {
1936         // Call attach with every field change, regardless of whether
1937         // it's been called before.  This will allow for re-attach after
1938         // the user clicks through the unload warning. egUnloadPrompt
1939         // will ensure we only attach once.
1940         egUnloadPrompt.attach($scope);
1941     }
1942
1943     // also monitor when form is changed *by the user*, as using
1944     // an ng-change handler doesn't work with eg-date-input
1945     $scope.$watch('reg_form.$pristine', function(newVal, oldVal) {
1946         if (!newVal) egUnloadPrompt.attach($scope);
1947     });
1948
1949     // username regex (if present) must be removed any time
1950     // the username matches the barcode to avoid firing the
1951     // invalid field handlers.
1952     function apply_username_regex() {
1953         var regex = $scope.org_settings['opac.username_regex'];
1954         if (regex) {
1955             if ($scope.patron.card.barcode) {
1956                 // username must match the regex or the barcode
1957                 field_patterns.au.usrname = 
1958                     new RegExp(
1959                         regex + '|^' + $scope.patron.card.barcode + '$');
1960             } else {
1961                 // username must match the regex
1962                 field_patterns.au.usrname = new RegExp(regex);
1963             }
1964         } else {
1965             // username can be any format.
1966             field_patterns.au.usrname = new RegExp('.*');
1967         }
1968     }
1969
1970     // obj could be the patron, an address, etc.
1971     // This is called any time a form field achieves then loses focus.
1972     // It does not necessarily mean the field has changed.
1973     // The alternative is ng-change, but it's called with each character
1974     // typed, which would be overkill for many of the actions called here.
1975     $scope.handle_field_changed = function(obj, field_name) {
1976         var cls = obj.classname; // set by egIdl
1977         var value = obj[field_name];
1978
1979         console.debug('changing field ' + field_name + ' to ' + value);
1980
1981         switch (field_name) {
1982             case 'day_phone' : 
1983                 if ($scope.patron.day_phone && 
1984                     $scope.patron.isnew && 
1985                     $scope.org_settings['patron.password.use_phone']) {
1986                     $scope.patron.passwd = $scope.patron.day_phone.substr(-4);
1987                 }
1988             case 'evening_phone' : 
1989             case 'other_phone' : 
1990                 $scope.dupe_value_changed(field_name, value);
1991                 break;
1992
1993             case 'ident_value':
1994             case 'ident_value2':
1995                 $scope.dupe_value_changed('ident', value);
1996                 break;
1997
1998             case 'first_given_name':
1999             case 'family_name':
2000                 $scope.dupe_value_changed('name', value);
2001                 break;
2002
2003             case 'email':
2004                 $scope.dupe_value_changed('email', value);
2005                 break;
2006
2007             case 'street1':
2008             case 'street2':
2009             case 'city':
2010                 // dupe search on address wants the address object as the value.
2011                 $scope.dupe_value_changed('address', obj);
2012                 address_alert(obj);
2013                 break;
2014
2015             case 'post_code':
2016                 $scope.post_code_changed(obj);
2017                 break;
2018
2019             case 'usrname':
2020                 patronRegSvc.check_dupe_username(value)
2021                 .then(function(yes) {$scope.dupe_username = Boolean(yes)});
2022                 break;
2023
2024             case 'barcode':
2025                 // TODO: finish barcode_changed handler.
2026                 $scope.barcode_changed(value);
2027                 apply_username_regex();
2028                 break;
2029         }
2030     }
2031
2032     // patron.juvenile is set to true if the user was born after
2033     function maintain_juvenile_flag() {
2034         if ( !($scope.patron && $scope.patron.dob) ) return;
2035
2036         var juv_interval = 
2037             $scope.org_settings['global.juvenile_age_threshold'] 
2038             || '18 years';
2039
2040         var base = new Date();
2041
2042         base.setTime(base.getTime() - 
2043             Number(egCore.date.intervalToSeconds(juv_interval) + '000'));
2044
2045         $scope.patron.juvenile = ($scope.patron.dob > base);
2046     }
2047
2048     // returns true (disable) for orgs that cannot have users.
2049     $scope.disable_home_org = function(org_id) {
2050         if (!org_id) return;
2051         var org = egCore.org.get(org_id);
2052         return (
2053             org &&
2054             org.ou_type() &&
2055             org.ou_type().can_have_users() == 'f'
2056         );
2057     }
2058
2059     // returns true (disable) for orgs that cannot have vols (for holds pickup)
2060     $scope.disable_pulib = function(org_id) {
2061         if (!org_id) return;
2062         return !egCore.org.CanHaveVolumes(org_id);
2063     }
2064
2065     // Returns true if the Save and Save & Clone buttons should be disabled.
2066     $scope.edit_passthru.hide_save_actions = function() {
2067         return $scope.patron.isnew ?
2068             !$scope.perms.CREATE_USER : 
2069             !$scope.perms.UPDATE_USER;
2070     }
2071
2072     // Returns true if any input elements are tagged as invalid
2073     // via Angular patterns or required attributes.
2074     function form_has_invalid_fields() {
2075         return $('#patron-reg-container .ng-invalid').length > 0;
2076     }
2077
2078     function form_is_incomplete() {
2079         return (
2080             $scope.dupe_username ||
2081             $scope.dupe_barcode ||
2082             form_has_invalid_fields()
2083         );
2084
2085     }
2086
2087     $scope.edit_passthru.save = function(save_args) {
2088         if (!save_args) save_args = {};
2089
2090         if (form_is_incomplete()) {
2091             // User has not provided valid values for all required fields.
2092             return egAlertDialog.open(egCore.strings.REG_INVALID_FIELDS);
2093         }
2094
2095         // remove page unload warning prompt
2096         egUnloadPrompt.clear();
2097
2098         // toss the deleted addresses back into the patron's list of
2099         // addresses so it's included in the update
2100         $scope.patron.addresses = 
2101             $scope.patron.addresses.concat(deleted_addresses);
2102         
2103         // ditto for waiver entries
2104         $scope.patron.waiver_entries = 
2105             $scope.patron.waiver_entries.concat(deleted_waiver_entries);
2106
2107         compress_hold_notify();
2108
2109         var updated_user;
2110
2111         patronRegSvc.save_user($scope.patron)
2112         .then(function(new_user) { 
2113             if (new_user && new_user.classname) {
2114                 updated_user = new_user;
2115                 return patronRegSvc.save_user_settings(
2116                     new_user, $scope.user_settings); 
2117             } else {
2118                 var evt = egCore.evt.parse(new_user);
2119
2120                 if (evt && evt.textcode == 'XACT_COLLISION') {
2121                     return egAlertDialog.open(
2122                         egCore.strings.PATRON_EDIT_COLLISION).result;
2123                 }
2124
2125                 // debug only -- should not get here.
2126                 alert('Patron update failed. \n\n' + js2JSON(new_user));
2127             }
2128
2129         }).then(function() {
2130
2131             // only remove the staged user if the update succeeded.
2132             if (updated_user) 
2133                 return patronRegSvc.remove_staged_user();
2134
2135             return $q.when();
2136
2137         }).then(function() {
2138
2139             // linked groups for new users must be created after the new
2140             // user is created.
2141             if ($scope.patron.isnew && 
2142                 $scope.patron.groups && $scope.patron.groups.length) {
2143                 var ids = $scope.patron.groups.map(function(g) {return g.id()});
2144                 return patronRegSvc.apply_secondary_groups(updated_user.id(), ids)
2145             }
2146
2147             return $q.when();
2148
2149         }).then(function() {
2150
2151             if (updated_user) {
2152                 egWorkLog.record(
2153                     $scope.patron.isnew
2154                     ? egCore.strings.EG_WORK_LOG_REGISTERED_PATRON
2155                     : egCore.strings.EG_WORK_LOG_EDITED_PATRON, {
2156                         'action' : $scope.patron.isnew ? 'registered_patron' : 'edited_patron',
2157                         'patron_id' : updated_user.id()
2158                     }
2159                 );
2160             }
2161
2162             // reloading the page means potentially losing some information
2163             // (e.g. last patron search), but is the only way to ensure all
2164             // components are properly updated to reflect the modified patron.
2165             if (updated_user && save_args.clone) {
2166                 // open a separate tab for registering a new 
2167                 // patron from our cloned data.
2168                 var url = 'https://' 
2169                     + $window.location.hostname 
2170                     + egCore.env.basePath 
2171                     + '/circ/patron/register/clone/' 
2172                     + updated_user.id();
2173                 $window.open(url, '_blank').focus();
2174
2175             } else if ($window.location.href.indexOf('stage') > -1 ){
2176                 // we're here after deleting a self-reg staged user.
2177                 // Just close tab, since refresh won't find staged user
2178                 $timeout(function(){
2179                     if (typeof BroadcastChannel != 'undefined') {
2180                         var bChannel = new BroadcastChannel("eg.pending_usr.update");
2181                         bChannel.postMessage({
2182                             usr: egCore.idl.toHash(updated_user)
2183                         });
2184                     }
2185
2186                     $window.close();
2187                 });
2188             } else {
2189                 // reload the current page
2190                 $window.location.href = location.href;
2191             }
2192         });
2193     }
2194
2195     $scope.edit_passthru.print = function() {
2196         var print_data = {patron : $scope.patron}
2197
2198         return egCore.print.print({
2199             context : 'default',
2200             template : 'patron_data',
2201             scope : print_data
2202         });
2203     }
2204 }])