LP#1564685 Prevent linked address edit on reload
[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', 'egCore', function($q, egCore) {
6
7     var service = {
8         field_doc : {},            // config.idl_field_doc
9         profiles : [],             // permission groups
10         edit_profiles : [],        // perm groups we can modify
11         sms_carriers : [],
12         user_settings : {},        // applied user settings
13         user_setting_types : {},   // config.usr_setting_type
14         opt_in_setting_types : {}, // config.usr_setting_type for event-def opt-in
15         surveys : [],
16         survey_questions : {},
17         survey_answers : {},
18         survey_responses : {},     // survey.responses for loaded patron in progress
19         stat_cats : [],
20         stat_cat_entry_maps : {},   // cat.id to selected value
21         virt_id : -1,               // virtual ID for new objects
22         init_done : false           // have we loaded our initialization data?
23     };
24
25     // launch a series of parallel data retrieval calls
26     service.init = function(scope) {
27
28         // Data loaded here only needs to be retrieved the first time this
29         // tab becomes active within the current instance of the patron app.
30         // In other words, navigating between patron tabs will not cause
31         // all of this data to be reloaded.  Navigating to a separate app
32         // and returning will cause the data to be reloaded.
33         if (service.init_done) return $q.when();
34         service.init_done = true;
35
36         return $q.all([
37             service.get_field_doc(),
38             service.get_perm_groups(),
39             service.get_ident_types(),
40             service.get_user_settings(),
41             service.get_org_settings(),
42             service.get_stat_cats(),
43             service.get_surveys(),
44             service.get_clone_user(),
45             service.get_stage_user(),
46             service.get_net_access_levels()
47         ]);
48     };
49
50     service.get_clone_user = function() {
51         if (!service.clone_id) return $q.when();
52         // we could load egUser and use its get() function, but loading
53         // user.js into the standalone register UI would mean creating a
54         // new module, since egUser is not loaded into egCoreMod.  This
55         // is a lot simpler.
56         return egCore.net.request(
57             'open-ils.actor',
58             'open-ils.actor.user.fleshed.retrieve',
59             egCore.auth.token(), service.clone_id, 
60             ['billing_address', 'mailing_address'])
61         .then(function(cuser) {
62             if (e = egCore.evt.parse(cuser)) {
63                 alert(e);
64             } else {
65                 service.clone_user = cuser;
66             }
67         });
68     }
69
70     // When editing a user with addresses linked to other users, fetch
71     // the linked user(s) so we can display their names and edit links.
72     service.get_linked_addr_users = function(addrs) {
73         angular.forEach(addrs, function(addr) {
74             if (addr.usr == service.existing_patron.id()) return;
75             egCore.pcrud.retrieve('au', addr.usr)
76             .then(function(usr) {
77                 addr._linked_owner_id = usr.id();
78                 addr._linked_owner = service.format_name(
79                     usr.family_name(),
80                     usr.first_given_name(),
81                     usr.second_given_name()
82                 );
83             })
84         });
85     }
86
87     service.apply_secondary_groups = function(user_id, group_ids) {
88         return egCore.net.request(
89             'open-ils.actor',
90             'open-ils.actor.user.set_groups',
91             egCore.auth.token(), user_id, group_ids)
92         .then(function(resp) {
93             if (resp == 1) {
94                 return true;
95             } else {
96                 // debugging -- should be no events
97                 alert('linked groups failure ' + egCore.evt.parse(resp));
98             }
99         });
100     }
101
102     service.get_stage_user = function() {
103         if (!service.stage_username) return $q.when();
104
105         // fetch the staged user object
106         return egCore.net.request(
107             'open-ils.actor',
108             'open-ils.actor.user.stage.retrieve.by_username',
109             egCore.auth.token(), 
110             service.stage_username
111         ).then(function(suser) {
112             if (e = egCore.evt.parse(suser)) {
113                 alert(e);
114             } else {
115                 service.stage_user = suser;
116             }
117         }).then(function() {
118
119             if (!service.stage_user) return;
120             var requestor = service.stage_user.user.requesting_usr();
121
122             if (!requestor) return;
123
124             // fetch the requesting user
125             return egCore.net.request(
126                 'open-ils.actor', 
127                 'open-ils.actor.user.retrieve.parts',
128                 egCore.auth.token(),
129                 requestor, 
130                 ['family_name', 'first_given_name', 'second_given_name'] 
131             ).then(function(parts) {
132                 service.stage_user_requestor = 
133                     service.format_name(parts[0], parts[1], parts[2]);
134             })
135         });
136     }
137
138     // See note above about not loading egUser.
139     // TODO: i18n
140     service.format_name = function(last, first, middle) {
141         return last + ', ' + first + (middle ? ' ' + middle : '');
142     }
143
144     service.check_dupe_username = function(usrname) {
145
146         // empty usernames can't be dupes
147         if (!usrname) return $q.when(false);
148
149         // avoid dupe check if username matches the originally loaded usrname
150         if (service.existing_patron) {
151             if (usrname == service.existing_patron.usrname())
152                 return $q.when(false);
153         }
154
155         return egCore.net.request(
156             'open-ils.actor',
157             'open-ils.actor.username.exists',
158             egCore.auth.token(), usrname);
159     }
160
161     //service.check_grp_app_perm = function(grp_id) {
162
163     // determine which user groups our user is not allowed to modify
164     service.set_edit_profiles = function() {
165         var all_app_perms = [];
166         var failed_perms = [];
167
168         // extract the application permissions
169         angular.forEach(service.profiles, function(grp) {
170             if (grp.application_perm())
171                 all_app_perms.push(grp.application_perm());
172         }); 
173
174         // fill in service.edit_profiles by inspecting failed_perms
175         function traverse_grp_tree(grp, failed) {
176             failed = failed || 
177                 failed_perms.indexOf(grp.application_perm()) > -1;
178
179             if (!failed) service.edit_profiles.push(grp);
180
181             angular.forEach(
182                 service.profiles.filter( // children of grp
183                     function(p) { return p.parent() == grp.id() }),
184                 function(child) {traverse_grp_tree(child, failed)}
185             );
186         }
187
188         return egCore.perm.hasPermAt(all_app_perms, true).then(
189             function(perm_orgs) {
190                 angular.forEach(all_app_perms, function(p) {
191                     if (perm_orgs[p].length == 0)
192                         failed_perms.push(p);
193                 });
194
195                 traverse_grp_tree(egCore.env.pgt.tree);
196             }
197         );
198     }
199
200     // resolves to a hash of perm-name => boolean value indicating
201     // wether the user has the permission at org_id.
202     service.has_perms_for_org = function(org_id) {
203
204         var perms_needed = [
205             'UPDATE_USER',
206             'CREATE_USER',
207             'CREATE_USER_GROUP_LINK', 
208             'UPDATE_PATRON_COLLECTIONS_EXEMPT',
209             'UPDATE_PATRON_CLAIM_RETURN_COUNT',
210             'UPDATE_PATRON_CLAIM_NEVER_CHECKED_OUT_COUNT',
211             'UPDATE_PATRON_ACTIVE_CARD',
212             'UPDATE_PATRON_PRIMARY_CARD'
213         ];
214
215         return egCore.perm.hasPermAt(perms_needed, true)
216         .then(function(perm_map) {
217
218             angular.forEach(perms_needed, function(perm) {
219                 perm_map[perm] = 
220                     Boolean(perm_map[perm].indexOf(org_id) > -1);
221             });
222
223             return perm_map;
224         });
225     }
226
227     service.get_surveys = function() {
228         var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
229
230         return egCore.pcrud.search('asv', {
231                 owner : org_ids,
232                 start_date : {'<=' : 'now'},
233                 end_date : {'>=' : 'now'}
234             }, {   
235                 flesh : 2, 
236                 flesh_fields : {
237                     asv : ['questions'], 
238                     asvq : ['answers']
239                 }
240             }, 
241             {atomic : true}
242         ).then(function(surveys) {
243             surveys = surveys.sort(function(a,b) {
244                 return a.name() < b.name() ? -1 : 1 });
245             service.surveys = surveys;
246             angular.forEach(surveys, function(survey) {
247                 angular.forEach(survey.questions(), function(question) {
248                     service.survey_questions[question.id()] = question;
249                     angular.forEach(question.answers(), function(answer) {
250                         service.survey_answers[answer.id()] = answer;
251                     });
252                 });
253             });
254         });
255     }
256
257     service.get_stat_cats = function() {
258         return egCore.net.request(
259             'open-ils.circ',
260             'open-ils.circ.stat_cat.actor.retrieve.all',
261             egCore.auth.token(), egCore.auth.user().ws_ou()
262         ).then(function(cats) {
263             cats = cats.sort(function(a, b) {
264                 return a.name() < b.name() ? -1 : 1});
265             angular.forEach(cats, function(cat) {
266                 cat.entries(
267                     cat.entries().sort(function(a,b) {
268                         return a.value() < b.value() ? -1 : 1
269                     })
270                 );
271             });
272             service.stat_cats = cats;
273         });
274     };
275
276     service.get_org_settings = function() {
277         return egCore.org.settings([
278             'global.password_regex',
279             'global.juvenile_age_threshold',
280             'patron.password.use_phone',
281             'ui.patron.default_inet_access_level',
282             'ui.patron.default_ident_type',
283             'ui.patron.default_country',
284             'ui.patron.registration.require_address',
285             'circ.holds.behind_desk_pickup_supported',
286             'circ.patron_edit.clone.copy_address',
287             'ui.patron.edit.au.prefix.require',
288             'ui.patron.edit.au.prefix.show',
289             'ui.patron.edit.au.prefix.suggest',
290             'ui.patron.edit.ac.barcode.regex',
291             'ui.patron.edit.au.second_given_name.show',
292             'ui.patron.edit.au.second_given_name.suggest',
293             'ui.patron.edit.au.suffix.show',
294             'ui.patron.edit.au.suffix.suggest',
295             'ui.patron.edit.au.alias.show',
296             'ui.patron.edit.au.alias.suggest',
297             'ui.patron.edit.au.dob.require',
298             'ui.patron.edit.au.dob.show',
299             'ui.patron.edit.au.dob.suggest',
300             'ui.patron.edit.au.dob.calendar',
301             'ui.patron.edit.au.juvenile.show',
302             'ui.patron.edit.au.juvenile.suggest',
303             'ui.patron.edit.au.ident_value.show',
304             'ui.patron.edit.au.ident_value.suggest',
305             'ui.patron.edit.au.ident_value2.show',
306             'ui.patron.edit.au.ident_value2.suggest',
307             'ui.patron.edit.au.email.require',
308             'ui.patron.edit.au.email.show',
309             'ui.patron.edit.au.email.suggest',
310             'ui.patron.edit.au.email.regex',
311             'ui.patron.edit.au.email.example',
312             'ui.patron.edit.au.day_phone.require',
313             'ui.patron.edit.au.day_phone.show',
314             'ui.patron.edit.au.day_phone.suggest',
315             'ui.patron.edit.au.day_phone.regex',
316             'ui.patron.edit.au.day_phone.example',
317             'ui.patron.edit.au.evening_phone.require',
318             'ui.patron.edit.au.evening_phone.show',
319             'ui.patron.edit.au.evening_phone.suggest',
320             'ui.patron.edit.au.evening_phone.regex',
321             'ui.patron.edit.au.evening_phone.example',
322             'ui.patron.edit.au.other_phone.require',
323             'ui.patron.edit.au.other_phone.show',
324             'ui.patron.edit.au.other_phone.suggest',
325             'ui.patron.edit.au.other_phone.regex',
326             'ui.patron.edit.au.other_phone.example',
327             'ui.patron.edit.phone.regex',
328             'ui.patron.edit.phone.example',
329             'ui.patron.edit.au.active.show',
330             'ui.patron.edit.au.active.suggest',
331             'ui.patron.edit.au.barred.show',
332             'ui.patron.edit.au.barred.suggest',
333             'ui.patron.edit.au.master_account.show',
334             'ui.patron.edit.au.master_account.suggest',
335             'ui.patron.edit.au.claims_returned_count.show',
336             'ui.patron.edit.au.claims_returned_count.suggest',
337             'ui.patron.edit.au.claims_never_checked_out_count.show',
338             'ui.patron.edit.au.claims_never_checked_out_count.suggest',
339             'ui.patron.edit.au.alert_message.show',
340             'ui.patron.edit.au.alert_message.suggest',
341             'ui.patron.edit.aua.post_code.regex',
342             'ui.patron.edit.aua.post_code.example',
343             'ui.patron.edit.aua.county.require',
344             'format.date',
345             'ui.patron.edit.default_suggested',
346             'opac.barcode_regex',
347             'opac.username_regex',
348             'sms.enable',
349             'ui.patron.edit.aua.state.require',
350             'ui.patron.edit.aua.state.suggest',
351             'ui.patron.edit.aua.state.show'
352         ]).then(function(settings) {
353             service.org_settings = settings;
354             return service.process_org_settings(settings);
355         });
356     };
357
358     // some org settings require the retrieval of additional data
359     service.process_org_settings = function(settings) {
360
361         var promises = [];
362
363         if (settings['sms.enable']) {
364             // fetch SMS carriers
365             promises.push(
366                 egCore.pcrud.search('csc', 
367                     {active: 'true'}, 
368                     {'order_by':[
369                         {'class':'csc', 'field':'name'},
370                         {'class':'csc', 'field':'region'}
371                     ]}, {atomic : true}
372                 ).then(function(carriers) {
373                     service.sms_carriers = carriers;
374                 })
375             );
376         } else {
377             // if other promises are added below, this is not necessary.
378             promises.push($q.when());  
379         }
380
381         // other post-org-settings processing goes here,
382         // adding to promises as needed.
383
384         return $q.all(promises);
385     };
386
387     service.get_ident_types = function() {
388         if (egCore.env.cit) {
389             service.ident_types = egCore.env.cit.list;
390             return $q.when();
391         } else {
392             return egCore.pcrud.retrieveAll('cit', {}, {atomic : true})
393             .then(function(types) { 
394                 egCore.env.absorbList(types, 'cit')
395                 service.ident_types = types 
396             });
397         }
398     };
399
400     service.get_net_access_levels = function() {
401         if (egCore.env.cnal) {
402             service.net_access_levels = egCore.env.cnal.list;
403             return $q.when();
404         } else {
405             return egCore.pcrud.retrieveAll('cnal', {}, {atomic : true})
406             .then(function(levels) { 
407                 egCore.env.absorbList(levels, 'cnal')
408                 service.net_access_levels = levels 
409             });
410         }
411     }
412
413     service.get_perm_groups = function() {
414         if (egCore.env.pgt) {
415             service.profiles = egCore.env.pgt.list;
416             return service.set_edit_profiles();
417         } else {
418             return egCore.pcrud.search('pgt', {parent : null}, 
419                 {flesh : -1, flesh_fields : {pgt : ['children']}}
420             ).then(
421                 function(tree) {
422                     egCore.env.absorbTree(tree, 'pgt')
423                     service.profiles = egCore.env.pgt.list;
424                     return service.set_edit_profiles();
425                 }
426             );
427         }
428     }
429
430     service.get_field_doc = function() {
431         return egCore.pcrud.search('fdoc', {
432             fm_class: ['au', 'ac', 'aua', 'actsc', 'asv', 'asvq', 'asva']})
433         .then(null, null, function(doc) {
434             if (!service.field_doc[doc.fm_class()]) {
435                 service.field_doc[doc.fm_class()] = {};
436             }
437             service.field_doc[doc.fm_class()][doc.field()] = doc;
438         });
439     };
440
441     service.get_user_settings = function() {
442         var org_ids = egCore.org.ancestors(egCore.auth.user().ws_ou(), true);
443
444         var static_types = [
445             'circ.holds_behind_desk', 
446             'circ.collections.exempt', 
447             'opac.hold_notify', 
448             'opac.default_phone', 
449             'opac.default_pickup_location', 
450             'opac.default_sms_carrier', 
451             'opac.default_sms_notify'];
452
453         return egCore.pcrud.search('cust', {
454             '-or' : [
455                 {name : static_types}, // common user settings
456                 {name : { // opt-in notification user settings
457                     'in': {
458                         select : {atevdef : ['opt_in_setting']}, 
459                         from : 'atevdef',
460                         // we only care about opt-in settings for 
461                         // event_defs our users encounter
462                         where : {'+atevdef' : {owner : org_ids}}
463                     }
464                 }}
465             ]
466         }, {}, {atomic : true}).then(function(setting_types) {
467
468             angular.forEach(setting_types, function(stype) {
469                 service.user_setting_types[stype.name()] = stype;
470                 if (static_types.indexOf(stype.name()) == -1) {
471                     service.opt_in_setting_types[stype.name()] = stype;
472                 }
473             });
474
475             if (service.patron_id) {
476                 // retrieve applied values for the current user 
477                 // for the setting types we care about.
478
479                 var setting_names = 
480                     setting_types.map(function(obj) { return obj.name() });
481
482                 return egCore.net.request(
483                     'open-ils.actor', 
484                     'open-ils.actor.patron.settings.retrieve.authoritative',
485                     egCore.auth.token(),
486                     service.patron_id,
487                     setting_names
488                 ).then(function(settings) {
489                     service.user_settings = settings;
490                 });
491             } else {
492
493                 // apply default user setting values
494                 angular.forEach(setting_types, function(stype, index) {
495                     if (stype.reg_default() != undefined) {
496                         service.user_settings[setting.name()] = 
497                             setting.reg_default();
498                     }
499                 });
500             }
501         });
502     }
503
504     service.invalidate_field = function(patron, field) {
505         console.log('Invalidating patron field ' + field);
506
507         return egCore.net.request(
508             'open-ils.actor',
509             'open-ils.actor.invalidate.' + field,
510             egCore.auth.token(), patron.id, null, patron.home_ou.id()
511
512         ).then(function(res) {
513             // clear the invalid value from the form
514             patron[field] = '';
515
516             // update last_xact_id so future save operations
517             // on this patron will be allowed
518             patron.last_xact_id = res.payload.last_xact_id[patron.id];
519         });
520     }
521
522     service.dupe_patron_search = function(patron, type, value) {
523         var search;
524
525         console.log('Dupe search called with "'+ type +'" and value '+ value);
526
527         switch (type) {
528
529             case 'name':
530                 var fname = patron.first_given_name;   
531                 var lname = patron.family_name;   
532                 if (!(fname && lname)) return $q.when({count:0});
533                 search = {
534                     first_given_name : {value : fname, group : 0},
535                     family_name : {value : lname, group : 0}
536                 };
537                 break;
538
539             case 'email':
540                 search = {email : {value : value, group : 0}};
541                 break;
542
543             case 'ident':
544                 search = {ident : {value : value, group : 2}};
545                 break;
546
547             case 'phone':
548                 search = {phone : {value : value, group : 2}};
549                 break;
550
551             case 'address':
552                 search = {};
553                 angular.forEach(['street1', 'street2', 'city', 'post_code'],
554                     function(field) {
555                         if(value[field])
556                             search[field] = {value : value[field], group: 1};
557                     }
558                 );
559                 break;
560         }
561
562         return egCore.net.request( 
563             'open-ils.actor', 
564             'open-ils.actor.patron.search.advanced',
565             egCore.auth.token(), search, null, null, 1
566         ).then(function(res) {
567             res = res.filter(function(id) {return id != patron.id});
568             return {
569                 count : res.length,
570                 search : search
571             };
572         });
573     }
574
575     service.init_patron = function(current) {
576
577         if (!current)
578             return service.init_new_patron();
579
580         service.patron = current;
581         return service.init_existing_patron(current)
582     }
583
584     service.ingest_address = function(patron, addr) {
585         addr.valid = addr.valid == 't';
586         addr.within_city_limits = addr.within_city_limits == 't';
587         addr._is_mailing = (patron.mailing_address && 
588             addr.id == patron.mailing_address.id);
589         addr._is_billing = (patron.billing_address && 
590             addr.id == patron.billing_address.id);
591     }
592
593     /*
594      * Existing patron objects reqire some data munging before insertion
595      * into the scope.
596      *
597      * 1. Turn everything into a hash
598      * 2. ... Except certain fields (selectors) whose widgets require objects
599      * 3. Bools must be Boolean, not t/f.
600      */
601     service.init_existing_patron = function(current) {
602
603         service.existing_patron = current;
604
605         var patron = egCore.idl.toHash(current);
606
607         patron.home_ou = egCore.org.get(patron.home_ou.id);
608         patron.expire_date = new Date(Date.parse(patron.expire_date));
609         patron.dob = service.parse_dob(patron.dob);
610         patron.profile = current.profile(); // pre-hash version
611         patron.net_access_level = current.net_access_level();
612         patron.ident_type = current.ident_type();
613         patron.groups = current.groups(); // pre-hash
614
615         angular.forEach(
616             ['juvenile', 'barred', 'active', 'master_account'],
617             function(field) { patron[field] = patron[field] == 't'; }
618         );
619
620         angular.forEach(patron.cards, function(card) {
621             card.active = card.active == 't';
622             if (card.id == patron.card.id) {
623                 patron.card = card;
624                 card._primary = 'on';
625             }
626         });
627
628         angular.forEach(patron.addresses, 
629             function(addr) { service.ingest_address(patron, addr) });
630
631         service.get_linked_addr_users(patron.addresses);
632
633         // Remove stat cat entries that link to out-of-scope stat
634         // cats.  With this, we avoid unnecessarily updating (or worse,
635         // modifying) stat cat values that are not ours to modify.
636         patron.stat_cat_entries = patron.stat_cat_entries.filter(
637             function(map) {
638                 return Boolean(
639                     // service.stat_cats only contains in-scope stat cats.
640                     service.stat_cats.filter(function(cat) { 
641                         return (cat.id() == map.stat_cat.id) })[0]
642                 );
643             }
644         );
645
646         // toss entries for existing stat cat maps into our living 
647         // stat cat entry map, which is modified within the template.
648         angular.forEach(patron.stat_cat_entries, function(map) {
649             service.stat_cat_entry_maps[map.stat_cat.id] = map.stat_cat_entry;
650         });
651
652         return patron;
653     }
654
655     service.init_new_patron = function() {
656         var addr = {
657             id : service.virt_id--,
658             isnew : true,
659             valid : true,
660             address_type : egCore.strings.REG_ADDR_TYPE,
661             _is_mailing : true,
662             _is_billing : true,
663             within_city_limits : false,
664             country : service.org_settings['ui.patron.default_country'],
665         };
666
667         var card = {
668             id : service.virt_id--,
669             isnew : true,
670             active : true,
671             _primary : 'on'
672         };
673
674         var user = {
675             isnew : true,
676             active : true,
677             card : card,
678             cards : [card],
679             home_ou : egCore.org.get(egCore.auth.user().ws_ou()),
680             stat_cat_entries : [],
681             groups : [],
682             addresses : [addr]
683         };
684
685         if (service.clone_user)
686             service.copy_clone_data(user);
687
688         if (service.stage_user)
689             service.copy_stage_data(user);
690
691         return user;
692     }
693
694     // dob is always YYYY-MM-DD
695     // Dates of birth do not contain timezone info, which can lead to
696     // inconcistent timezone handling, potentially representing
697     // different points in time, depending on the implementation.
698     // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse
699     // See "Differences in assumed time zone"
700     // TODO: move this into egDate ?
701     service.parse_dob = function(dob) {
702         if (!dob) return null;
703         var parts = dob.split('-');
704         var d = new Date(); // always local time zone, yay.
705         d.setFullYear(parts[0]);
706         d.setMonth(parts[1]);
707         d.setDate(parts[2]);
708         return d;
709     }
710
711     service.copy_stage_data = function(user) {
712         var cuser = service.stage_user;
713
714         // copy the data into our new user object
715
716         for (var key in egCore.idl.classes.stgu.field_map) {
717             if (egCore.idl.classes.au.field_map[key] &&
718                 !egCore.idl.classes.stgu.field_map[key].virtual) {
719                 if (cuser.user[key]() !== null)
720                     user[key] = cuser.user[key]();
721             }
722         }
723
724         if (user.home_ou) user.home_ou = egCore.org.get(user.home_ou);
725         if (user.profile) user.profile = egCore.env.pgt.map[user.profile];
726         if (user.ident_type) 
727             user.ident_type = egCore.env.cit.map[user.ident_type];
728         user.dob = service.parse_dob(user.dob);
729
730         // Clear the usrname if it looks like a UUID
731         if (user.usrname.replace(/-/g,'').match(/[0-9a-f]{32}/)) 
732             user.usrname = '';
733
734         // Don't use stub address if we have one from the staged user.
735         if (cuser.mailing_addresses.length || cuser.billing_addresses.length)
736             user.addresses = [];
737
738         // is_mailing=false implies is_billing
739         function addr_from_stage(stage_addr) {
740             if (!stage_addr) return;
741             var cls = stage_addr.classname;
742
743             var addr = {
744                 id : service.virt_id--,
745                 usr : user.id,
746                 isnew : true,
747                 valid : true,
748                 _is_mailing : cls == 'stgma',
749                 _is_billing : cls == 'stgba'
750             };
751
752             user.mailing_address = addr;
753             user.addresses.push(addr);
754
755             for (var key in egCore.idl.classes[cls].field_map) {
756                 if (egCore.idl.classes.aua.field_map[key] &&
757                     !egCore.idl.classes[cls].field_map[key].virtual) {
758                     if (stage_addr[key]() !== null)
759                         addr[key] = stage_addr[key]();
760                 }
761             }
762         }
763
764         addr_from_stage(cuser.mailing_addresses[0]);
765         addr_from_stage(cuser.billing_addresses[0]);
766
767         if (user.addresses.length == 1) {
768             // If there is only one address, 
769             // use it as both mailing and billing.
770             var addr = user.addresses[0];
771             addr._is_mailing = addr._is_billing = true;
772             user.mailing_address = user.billing_address = addr;
773         }
774
775         if (cuser.cards.length) {
776             user.card = {
777                 id : service.virt_id--,
778                 barcode : cuser.cards[0].barcode(),
779                 isnew : true,
780                 active : true,
781                 _primary : 'on'
782             };
783
784             user.cards.push(user.card);
785             if (user.usrname == '') 
786                 user.usrname = card.barcode;
787         }
788     }
789
790     // copy select values from the cloned user to the new user.
791     // user is a hash
792     service.copy_clone_data = function(user) {
793         var clone_user = service.clone_user;
794
795         // flesh the home org locally
796         user.home_ou = egCore.org.get(clone_user.home_ou());
797         if (user.profile) user.profile = egCore.env.pgt.map[user.profile];
798
799         if (!clone_user.billing_address() &&
800             !clone_user.mailing_address())
801             return; // no addresses to copy or link
802
803         // if the cloned user has any addresses, we don't need 
804         // the stub address created in init_new_patron.
805         user.addresses = [];
806
807         var copy_addresses = 
808             service.org_settings['circ.patron_edit.clone.copy_address'];
809
810         var clone_fields = [
811             'day_phone',
812             'evening_phone',
813             'other_phone',
814             'usrgroup'
815         ]; 
816
817         angular.forEach(clone_fields, function(field) {
818             user[field] = clone_user[field]();
819         });
820
821         if (copy_addresses) {
822             var bill_addr, mail_addr;
823
824             // copy the billing and mailing addresses into new addresses
825             function clone_addr(addr) {
826                 var new_addr = egCore.idl.toHash(addr);
827                 new_addr.id = service.virt_id--;
828                 new_addr.usr = user.id;
829                 new_addr.isnew = true;
830                 new_addr.valid = true;
831                 user.addresses.push(new_addr);
832                 return new_addr;
833             }
834
835             if (bill_addr = clone_user.billing_address()) {
836                 var addr = clone_addr(bill_addr);
837                 addr._is_billing = true;
838                 user.billing_address = addr;
839             }
840
841             if (mail_addr = clone_user.mailing_address()) {
842
843                 if (bill_addr && bill_addr.id() == mail_addr.id()) {
844                     user.mailing_address = user.billing_address;
845                     user.mailing_address._is_mailing = true;
846                 } else {
847                     var addr = clone_addr(mail_addr);
848                     addr._is_mailing = true;
849                     user.mailing_address = addr;
850                 }
851
852                 if (!bill_addr) {
853                     // if there is no billing addr, use the mailing addr
854                     user.billing_address = user.mailing_address;
855                     user.billing_address._is_billing = true;
856                 }
857             }
858
859
860         } else {
861
862             // link the billing and mailing addresses
863             var addr;
864             if (addr = clone_user.billing_address()) {
865                 user.billing_address = egCore.idl.toHash(addr);
866                 user.billing_address._is_billing = true;
867                 user.addresses.push(user.billing_address);
868                 user.billing_address._linked_owner_id = clone_user.id();
869                 user.billing_address._linked_owner = service.format_name(
870                     clone_user.family_name(),
871                     clone_user.first_given_name(),
872                     clone_user.second_given_name()
873                 );
874             }
875
876             if (addr = clone_user.mailing_address()) {
877                 if (user.billing_address && 
878                     addr.id() == user.billing_address.id) {
879                     // mailing matches billing
880                     user.mailing_address = user.billing_address;
881                     user.mailing_address._is_mailing = true;
882                 } else {
883                     user.mailing_address = egCore.idl.toHash(addr);
884                     user.mailing_address._is_mailing = true;
885                     user.addresses.push(user.mailing_address);
886                     user.mailing_address._linked_owner_id = clone_user.id();
887                     user.mailing_address._linked_owner = service.format_name(
888                         clone_user.family_name(),
889                         clone_user.first_given_name(),
890                         clone_user.second_given_name()
891                     );
892                 }
893             }
894         }
895     }
896
897     // translate the patron back into IDL form
898     service.save_user = function(phash) {
899
900         var patron = egCore.idl.fromHash('au', phash);
901
902         patron.home_ou(patron.home_ou().id());
903         patron.expire_date(patron.expire_date().toISOString());
904         patron.profile(patron.profile().id());
905         if (patron.dob()) 
906             patron.dob(patron.dob().toISOString().replace(/T.*/,''));
907         if (patron.ident_type()) 
908             patron.ident_type(patron.ident_type().id());
909         if (patron.net_access_level())
910             patron.net_access_level(patron.net_access_level().id());
911
912         angular.forEach(
913             ['juvenile', 'barred', 'active', 'master_account'],
914             function(field) { patron[field](phash[field] ? 't' : 'f'); }
915         );
916
917         var card_hashes = patron.cards();
918         patron.cards([]);
919         angular.forEach(card_hashes, function(chash) {
920             var card = egCore.idl.fromHash('ac', chash)
921             card.usr(patron.id());
922             card.active(chash.active ? 't' : 'f');
923             patron.cards().push(card);
924             if (chash._primary) {
925                 patron.card(card);
926             }
927         });
928
929         var addr_hashes = patron.addresses();
930         patron.addresses([]);
931         angular.forEach(addr_hashes, function(addr_hash) {
932             if (!addr_hash.isnew && !addr_hash.isdeleted) 
933                 addr_hash.ischanged = true;
934             var addr = egCore.idl.fromHash('aua', addr_hash);
935             patron.addresses().push(addr);
936             addr.valid(addr.valid() ? 't' : 'f');
937             addr.within_city_limits(addr.within_city_limits() ? 't' : 'f');
938             if (addr_hash._is_mailing) patron.mailing_address(addr);
939             if (addr_hash._is_billing) patron.billing_address(addr);
940         });
941
942         patron.survey_responses([]);
943         angular.forEach(service.survey_responses, function(answer) {
944             var question = service.survey_questions[answer.question()];
945             var resp = new egCore.idl.asvr();
946             resp.isnew(true);
947             resp.survey(question.survey());
948             resp.question(question.id());
949             resp.answer(answer.id());
950             resp.usr(patron.id());
951             resp.answer_date('now');
952             patron.survey_responses().push(resp);
953         });
954         
955         // re-object-ify the patron stat cat entry maps
956         var maps = [];
957         angular.forEach(patron.stat_cat_entries(), function(entry) {
958             var e = egCore.idl.fromHash('actscecm', entry);
959             e.stat_cat(e.stat_cat().id);
960             maps.push(e);
961         });
962         patron.stat_cat_entries(maps);
963
964         // service.stat_cat_entry_maps maps stats to values
965         // patron.stat_cat_entries is an array of stat_cat_entry_usr_map's
966         angular.forEach(
967             service.stat_cat_entry_maps, function(value, cat_id) {
968
969             // see if we already have a mapping for this entry
970             var existing = patron.stat_cat_entries().filter(
971                 function(e) { return e.stat_cat() == cat_id })[0];
972
973             if (existing) { // we have a mapping
974                 // if the existing mapping matches the new one,
975                 // there' nothing left to do
976                 if (existing.stat_cat_entry() == value) return;
977
978                 // mappings differ.  delete the old one and create
979                 // a new one below.
980                 existing.isdeleted(true);
981             }
982
983             var newmap = new egCore.idl.actscecm();
984             newmap.target_usr(patron.id());
985             newmap.isnew(true);
986             newmap.stat_cat(cat_id);
987             newmap.stat_cat_entry(value);
988             patron.stat_cat_entries().push(newmap);
989         });
990
991         if (!patron.isnew()) patron.ischanged(true);
992
993         return egCore.net.request(
994             'open-ils.actor', 
995             'open-ils.actor.patron.update',
996             egCore.auth.token(), patron);
997     }
998
999     service.remove_staged_user = function() {
1000         if (!service.stage_user) return $q.when();
1001         return egCore.net.request(
1002             'open-ils.actor',
1003             'open-ils.actor.user.stage.delete',
1004             egCore.auth.token(),
1005             service.stage_user.row_id()
1006         );
1007     }
1008
1009     service.save_user_settings = function(new_user, user_settings) {
1010         // user_settings contains the values from the scope/form.
1011         // service.user_settings contain the values from page load time.
1012
1013         var settings = {};
1014         if (service.patron_id) {
1015             // only update modified settings for existing patrons
1016             angular.forEach(user_settings, function(val, key) {
1017                 if (val !== service.user_settings[key])
1018                     settings[key] = val;
1019             });
1020
1021         } else {
1022             // all non-null setting values are updated for new patrons
1023             angular.forEach(user_settings, function(val, key) {
1024                 if (val !== null) settings[key] = val;
1025             });
1026         }
1027
1028         if (Object.keys(settings).length == 0) return $q.when();
1029
1030         return egCore.net.request(
1031             'open-ils.actor',
1032             'open-ils.actor.patron.settings.update',
1033             egCore.auth.token(), new_user.id(), settings
1034         ).then(function(resp) {
1035             return resp;
1036         });
1037     }
1038
1039     // Applies field-specific validation regex's from org settings 
1040     // to form fields.  Be careful not remove any pattern data we
1041     // are not explicitly over-writing in the provided patterns obj.
1042     service.set_field_patterns = function(patterns) {
1043         if (service.org_settings['opac.username_regex']) {
1044             patterns.au.usrname = 
1045                 new RegExp(service.org_settings['opac.username_regex']);
1046         }
1047
1048         if (service.org_settings['opac.barcode_regex']) {
1049             patterns.ac.barcode = 
1050                 new RegExp(service.org_settings['opac.barcode_regex']);
1051         }
1052
1053         if (service.org_settings['global.password_regex']) {
1054             patterns.au.passwd = 
1055                 new RegExp(service.org_settings['global.password_regex']);
1056         }
1057
1058         var phone_reg = service.org_settings['ui.patron.edit.phone.regex'];
1059         if (phone_reg) {
1060             // apply generic phone regex first, replace below as needed.
1061             patterns.au.day_phone = new RegExp(phone_reg);
1062             patterns.au.evening_phone = new RegExp(phone_reg);
1063             patterns.au.other_phone = new RegExp(phone_reg);
1064         }
1065
1066         // the remaining patterns fit a well-known key name pattern
1067
1068         angular.forEach(service.org_settings, function(val, key) {
1069             if (!val) return;
1070             var parts = key.match(/ui.patron.edit\.(\w+)\.(\w+)\.regex/);
1071             if (!parts) return;
1072             var cls = parts[1];
1073             var name = parts[2];
1074             patterns[cls][name] = new RegExp(val);
1075         });
1076     }
1077
1078     return service;
1079 }]);
1080
1081
1082 function PatronRegCtrl($scope, $routeParams, $q, $modal, $window, egCore, 
1083     patronSvc, patronRegSvc, egUnloadPrompt, egAlertDialog) {
1084
1085     $scope.page_data_loaded = false;
1086     $scope.clone_id = patronRegSvc.clone_id = $routeParams.clone_id;
1087     $scope.stage_username = 
1088         patronRegSvc.stage_username = $routeParams.stage_username;
1089     $scope.patron_id = 
1090         patronRegSvc.patron_id = $routeParams.edit_id || $routeParams.id;
1091
1092     // for existing patrons, disable barcode input by default
1093     $scope.disable_bc = $scope.focus_usrname = Boolean($scope.patron_id);
1094     $scope.focus_bc = !Boolean($scope.patron_id);
1095     $scope.dupe_counts = {};
1096
1097     // map of perm name to true/false for perms the logged in user
1098     // has at the currently selected patron home org unit.
1099     $scope.perms = {};
1100
1101     if (!$scope.edit_passthru) {
1102         // in edit more, scope.edit_passthru is delivered to us by
1103         // the enclosing controller.  In register mode, there is 
1104         // no enclosing controller, so we create our own.
1105         $scope.edit_passthru = {};
1106     }
1107
1108     // 0=all, 1=suggested, 2=all
1109     $scope.edit_passthru.vis_level = 0; 
1110
1111     // Apply default values for new patrons during initial registration
1112     // prs is shorthand for patronSvc
1113     function set_new_patron_defaults(prs) {
1114         if (!$scope.patron.passwd) {
1115             // passsword may originate from staged user.
1116             $scope.generate_password();
1117         }
1118         $scope.hold_notify_phone = true;
1119         $scope.hold_notify_email = true;
1120
1121         // staged users may be loaded w/ a profile.
1122         $scope.set_expire_date();
1123
1124         if (prs.org_settings['ui.patron.default_ident_type']) {
1125             // $scope.patron needs this field to be an object
1126             var id = prs.org_settings['ui.patron.default_ident_type'];
1127             var ident_type = $scope.ident_types.filter(
1128                 function(type) { return type.id() == id })[0];
1129             $scope.patron.ident_type = ident_type;
1130         }
1131         if (prs.org_settings['ui.patron.default_inet_access_level']) {
1132             // $scope.patron needs this field to be an object
1133             var id = prs.org_settings['ui.patron.default_inet_access_level'];
1134             var level = $scope.net_access_levels.filter(
1135                 function(lvl) { return lvl.id() == id })[0];
1136             $scope.patron.net_access_level = level;
1137         }
1138         if (prs.org_settings['ui.patron.default_country']) {
1139             $scope.patron.addresses[0].country = 
1140                 prs.org_settings['ui.patron.default_country'];
1141         }
1142     }
1143
1144     // A null or undefined pattern leads to exceptions.  Before the
1145     // patterns are loaded from the server, default all patterns
1146     // to an innocuous regex.  To avoid re-creating numerous
1147     // RegExp objects, cache the stub RegExp after initial creation.
1148     // note: angular docs say ng-pattern accepts a regexp or string,
1149     // but as of writing, it only works with a regexp object.
1150     // (Likely an angular 1.2 vs. 1.4 issue).
1151     var field_patterns = {au : {}, ac : {}, aua : {}};
1152     $scope.field_pattern = function(cls, field) { 
1153         if (!field_patterns[cls][field])
1154             field_patterns[cls][field] = new RegExp('.*');
1155         return field_patterns[cls][field];
1156     }
1157
1158     // Main page load function.  Kicks off tab init and data loading.
1159     $q.all([
1160
1161         $scope.initTab ? // initTab comes from patron app
1162             $scope.initTab('edit', $routeParams.id) : $q.when(),
1163
1164         patronRegSvc.init()
1165
1166     ]).then(function() {
1167         // called after initTab and patronRegSvc.init have completed
1168
1169         var prs = patronRegSvc; // brevity
1170         // in standalone mode, we have no patronSvc
1171         $scope.patron = prs.init_patron(patronSvc ? patronSvc.current : null);
1172         $scope.field_doc = prs.field_doc;
1173         $scope.edit_profiles = prs.edit_profiles;
1174         $scope.ident_types = prs.ident_types;
1175         $scope.net_access_levels = prs.net_access_levels;
1176         $scope.user_setting_types = prs.user_setting_types;
1177         $scope.opt_in_setting_types = prs.opt_in_setting_types;
1178         $scope.org_settings = prs.org_settings;
1179         $scope.sms_carriers = prs.sms_carriers;
1180         $scope.stat_cats = prs.stat_cats;
1181         $scope.surveys = prs.surveys;
1182         $scope.survey_responses = prs.survey_responses;
1183         $scope.stat_cat_entry_maps = prs.stat_cat_entry_maps;
1184         $scope.stage_user = prs.stage_user;
1185         $scope.stage_user_requestor = prs.stage_user_requestor;
1186
1187         $scope.user_settings = prs.user_settings;
1188         // clone the user settings back into the patronRegSvc so
1189         // we have a copy of the original state of the settings.
1190         prs.user_settings = {};
1191         angular.forEach($scope.user_settings, function(val, key) {
1192             prs.user_settings[key] = val;
1193         });
1194
1195         extract_hold_notify();
1196         $scope.handle_home_org_changed();
1197
1198         if ($scope.org_settings['ui.patron.edit.default_suggested'])
1199             $scope.edit_passthru.vis_level = 1;
1200
1201         if ($scope.patron.isnew) 
1202             set_new_patron_defaults(prs);
1203
1204         $scope.page_data_loaded = true;
1205
1206         prs.set_field_patterns(field_patterns);
1207         apply_username_regex();
1208     });
1209
1210
1211     // update the currently displayed field documentation
1212     $scope.set_selected_field_doc = function(cls, field) {
1213         $scope.selected_field_doc = $scope.field_doc[cls][field];
1214     }
1215
1216     // returns the tree depth of the selected profile group tree node.
1217     $scope.pgt_depth = function(grp) {
1218         var d = 0;
1219         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
1220         return d;
1221     }
1222
1223     // IDL fields used for labels in the UI.
1224     $scope.idl_fields = {
1225         au  : egCore.idl.classes.au.field_map,
1226         ac  : egCore.idl.classes.ac.field_map,
1227         aua : egCore.idl.classes.aua.field_map
1228     };
1229
1230     // field visibility cache.  Some fields are universally required.
1231     // 3 == value universally required
1232     // 2 == field is visible by default
1233     // 1 == field is suggested by default
1234     var field_visibility = {};
1235     var default_field_visibility = {
1236         'ac.barcode' : 3,
1237         'au.usrname' : 3,
1238         'au.passwd' :  3,
1239         'au.first_given_name' : 3,
1240         'au.family_name' : 3,
1241         'au.ident_type' : 3,
1242         'au.home_ou' : 3,
1243         'au.profile' : 3,
1244         'au.expire_date' : 3,
1245         'au.net_access_level' : 3,
1246         'aua.address_type' : 3,
1247         'aua.post_code' : 3,
1248         'aua.street1' : 3,
1249         'aua.street2' : 2,
1250         'aua.city' : 3,
1251         'aua.county' : 2,
1252         'aua.state' : 2,
1253         'aua.country' : 3,
1254         'aua.valid' : 2,
1255         'aua.within_city_limits' : 2,
1256         'stat_cats' : 1,
1257         'surveys' : 1
1258     }; 
1259
1260     // Returns true if the selected field should be visible
1261     // given the current required/suggested/all setting.
1262     // The visibility flag applied to each field as a result of calling
1263     // this function also sets (via the same flag) the requiredness state.
1264     $scope.show_field = function(field_key) {
1265         // org settings have not been received yet.
1266         if (!$scope.org_settings) return false;
1267
1268         if (field_visibility[field_key] == undefined) {
1269             // compile and cache the visibility for the selected field
1270
1271             var req_set = 'ui.patron.edit.' + field_key + '.require';
1272             var sho_set = 'ui.patron.edit.' + field_key + '.show';
1273             var sug_set = 'ui.patron.edit.' + field_key + '.suggest';
1274
1275             if ($scope.org_settings[req_set]) {
1276                 field_visibility[field_key] = 3;
1277
1278             } else if ($scope.org_settings[sho_set]) {
1279                 field_visibility[field_key] = 2;
1280
1281             } else if ($scope.org_settings[sug_set]) {
1282                 field_visibility[field_key] = 1;
1283             }
1284         }
1285
1286         if (field_visibility[field_key] == undefined) {
1287             // No org settings were applied above.  Use the default
1288             // settings if present or assume the field has no
1289             // visibility flags applied.
1290             field_visibility[field_key] = 
1291                 default_field_visibility[field_key] || 0;
1292         }
1293
1294         return field_visibility[field_key] >= $scope.edit_passthru.vis_level;
1295     }
1296
1297     // See $scope.show_field().
1298     // A field with visbility level 3 means it's required.
1299     $scope.field_required = function(cls, field) {
1300
1301         // Value in the password field is not required
1302         // for existing patrons.
1303         if (field == 'passwd' && $scope.patron && !$scope.patron.isnew) 
1304           return false;
1305
1306         return (field_visibility[cls + '.' + field] == 3);
1307     }
1308
1309     // generates a random 4-digit password
1310     $scope.generate_password = function() {
1311         $scope.patron.passwd = Math.floor(Math.random()*9000) + 1000;
1312     }
1313
1314     $scope.set_expire_date = function() {
1315         if (!$scope.patron.profile) return;
1316         var seconds = egCore.date.intervalToSeconds(
1317             $scope.patron.profile.perm_interval());
1318         var now_epoch = new Date().getTime();
1319         $scope.patron.expire_date = new Date(
1320             now_epoch + (seconds * 1000 /* milliseconds */))
1321     }
1322
1323     // grp is the pgt object
1324     $scope.set_profile = function(grp) {
1325         $scope.patron.profile = grp;
1326         $scope.set_expire_date();
1327         $scope.field_modified();
1328     }
1329
1330     $scope.invalid_profile = function() {
1331         return !(
1332             $scope.patron && 
1333             $scope.patron.profile && 
1334             $scope.patron.profile.usergroup() == 't'
1335         );
1336     }
1337
1338     $scope.new_address = function() {
1339         var addr = egCore.idl.toHash(new egCore.idl.aua());
1340         patronRegSvc.ingest_address($scope.patron, addr);
1341         addr.id = patronRegSvc.virt_id--;
1342         addr.isnew = true;
1343         addr.valid = true;
1344         addr.within_city_limits = true;
1345         addr.country = $scope.org_settings['ui.patron.default_country'];
1346         $scope.patron.addresses.push(addr);
1347     }
1348
1349     // keep deleted addresses out of the patron object so
1350     // they won't appear in the UI.  They'll be re-inserted
1351     // when the patron is updated.
1352     deleted_addresses = [];
1353     $scope.delete_address = function(id) {
1354
1355         if ($scope.patron.isnew &&
1356             $scope.patron.addresses.length == 1 &&
1357             $scope.org_settings['ui.patron.registration.require_address']) {
1358             egAlertDialog.open(egCore.strings.REG_ADDR_REQUIRED);
1359             return;
1360         }
1361
1362         var addresses = [];
1363         angular.forEach($scope.patron.addresses, function(addr) {
1364             if (addr.id == id) {
1365                 if (id > 0) {
1366                     addr.isdeleted = true;
1367                     deleted_addresses.push(addr);
1368                 }
1369             } else {
1370                 addresses.push(addr);
1371             }
1372         });
1373         $scope.patron.addresses = addresses;
1374     } 
1375
1376     $scope.post_code_changed = function(addr) { 
1377         egCore.net.request(
1378             'open-ils.search', 'open-ils.search.zip', addr.post_code)
1379         .then(function(resp) {
1380             if (!resp) return;
1381             if (resp.city) addr.city = resp.city;
1382             if (resp.state) addr.state = resp.state;
1383             if (resp.county) addr.county = resp.county;
1384             if (resp.alert) alert(resp.alert);
1385         });
1386     }
1387
1388     $scope.replace_card = function() {
1389         $scope.patron.card.active = false;
1390         $scope.patron.card.ischanged = true;
1391         $scope.disable_bc = false;
1392
1393         var new_card = egCore.idl.toHash(new egCore.idl.ac());
1394         new_card.id = patronRegSvc.virt_id--;
1395         new_card.isnew = true;
1396         new_card.active = true;
1397         new_card._primary = 'on';
1398         $scope.patron.card = new_card;
1399         $scope.patron.cards.push(new_card);
1400     }
1401
1402     $scope.day_phone_changed = function(phone) {
1403         if (phone && $scope.patron.isnew && 
1404             $scope.org_settings['patron.password.use_phone']) {
1405             $scope.patron.passwd = phone.substr(-4);
1406         }
1407     }
1408
1409     $scope.barcode_changed = function(bc) {
1410         if (!bc) return;
1411         $scope.dupe_barcode = false;
1412         egCore.net.request(
1413             'open-ils.actor',
1414             'open-ils.actor.barcode.exists',
1415             egCore.auth.token(), bc
1416         ).then(function(resp) {
1417             if (resp == '1') { // duplicate card
1418                 $scope.dupe_barcode = true;
1419                 console.log('duplicate barcode detected: ' + bc);
1420             } else {
1421                 if (!$scope.patron.usrname)
1422                     $scope.patron.usrname = bc;
1423                 // No dupe -- A-OK
1424             }
1425         });
1426     }
1427
1428     $scope.cards_dialog = function() {
1429         $modal.open({
1430             templateUrl: './circ/patron/t_patron_cards_dialog',
1431             controller: 
1432                    ['$scope','$modalInstance','cards', 'perms',
1433             function($scope , $modalInstance , cards, perms) {
1434                 // scope here is the modal-level scope
1435                 $scope.args = {cards : cards};
1436                 $scope.perms = perms;
1437                 $scope.ok = function() { $modalInstance.close($scope.args) }
1438                 $scope.cancel = function () { $modalInstance.dismiss() }
1439             }],
1440             resolve : {
1441                 cards : function() {
1442                     // scope here is the controller-level scope
1443                     return $scope.patron.cards;
1444                 },
1445                 perms : function() {
1446                     return $scope.perms;
1447                 }
1448             }
1449         }).result.then(
1450             function(args) {
1451                 angular.forEach(args.cards, function(card) {
1452                     card.ischanged = true; // assume cards need updating, OK?
1453                     if (card._primary == 'on' && 
1454                         card.id != $scope.patron.card.id) {
1455                         $scope.patron.card = card;
1456                     }
1457                 });
1458             }
1459         );
1460     }
1461
1462     $scope.set_addr_type = function(addr, type) {
1463         var addrs = $scope.patron.addresses;
1464         if (addr['_is_'+type]) {
1465             angular.forEach(addrs, function(a) {
1466                 if (a.id != addr.id) a['_is_'+type] = false;
1467             });
1468         } else {
1469             // unchecking mailing/billing means we have to randomly
1470             // select another address to fill that role.  Select the
1471             // first address in the list (that does not match the
1472             // modifed address)
1473             for (var i = 0; i < addrs.length; i++) {
1474                 if (addrs[i].id != addr.id) {
1475                     addrs[i]['_is_' + type] = true;
1476                     break;
1477                 }
1478             }
1479         }
1480     }
1481
1482
1483     // Translate hold notify preferences from the form/scope back into a 
1484     // single user setting value for opac.hold_notify.
1485     function compress_hold_notify() {
1486         var hold_notify = '';
1487         var splitter = '';
1488         if ($scope.hold_notify_phone) {
1489             hold_notify = 'phone';
1490             splitter = ':';
1491         }
1492         if ($scope.hold_notify_email) {
1493             hold_notify = splitter + 'email';
1494             splitter = ':';
1495         }
1496         if ($scope.hold_notify_sms) {
1497             hold_notify = splitter + 'sms';
1498             splitter = ':';
1499         }
1500         $scope.user_settings['opac.hold_notify'] = hold_notify;
1501     }
1502
1503     // dialog for selecting additional permission groups
1504     $scope.secondary_groups_dialog = function() {
1505         $modal.open({
1506             templateUrl: './circ/patron/t_patron_groups_dialog',
1507             controller: 
1508                    ['$scope','$modalInstance','linked_groups','pgt_depth',
1509             function($scope , $modalInstance , linked_groups , pgt_depth) {
1510
1511                 $scope.pgt_depth = pgt_depth;
1512                 $scope.args = {
1513                     linked_groups : linked_groups,
1514                     edit_profiles : patronRegSvc.edit_profiles,
1515                     new_profile   : patronRegSvc.edit_profiles[0]
1516                 };
1517
1518                 // add a new group to the linked groups list
1519                 $scope.link_group = function($event, grp) {
1520                     var found = false; // avoid duplicates
1521                     angular.forEach($scope.args.linked_groups, 
1522                         function(g) {if (g.id() == grp.id()) found = true});
1523                     if (!found) $scope.args.linked_groups.push(grp);
1524                     $event.preventDefault(); // avoid close
1525                 }
1526
1527                 // remove a group from the linked groups list
1528                 $scope.unlink_group = function($event, grp) {
1529                     $scope.args.linked_groups = 
1530                         $scope.args.linked_groups.filter(function(g) {
1531                         return g.id() != grp.id()
1532                     });
1533                     $event.preventDefault(); // avoid close
1534                 }
1535
1536                 $scope.ok = function() { $modalInstance.close($scope.args) }
1537                 $scope.cancel = function () { $modalInstance.dismiss() }
1538             }],
1539             resolve : {
1540                 linked_groups : function() { return $scope.patron.groups },
1541                 pgt_depth : function() { return $scope.pgt_depth }
1542             }
1543         }).result.then(
1544             function(args) {
1545
1546                 if ($scope.patron.isnew) {
1547                     // groups must be linked for new patrons after the
1548                     // patron is created.
1549                     $scope.patron.groups = args.linked_groups;
1550                     return;
1551                 }
1552
1553                 // update links groups for existing users in real time.
1554                 var ids = args.linked_groups.map(function(g) {return g.id()});
1555                 patronRegSvc.apply_secondary_groups($scope.patron.id, ids)
1556                 .then(function(success) {
1557                     if (success)
1558                         $scope.patron.groups = args.linked_groups;
1559                 });
1560             }
1561         );
1562     }
1563
1564     function extract_hold_notify() {
1565         notify = $scope.user_settings['opac.hold_notify'];
1566         if (!notify) return;
1567         $scope.hold_notify_phone = Boolean(notify.match(/phone/));
1568         $scope.hold_notify_email = Boolean(notify.match(/email/));
1569         $scope.hold_notify_sms = Boolean(notify.match(/sms/));
1570     }
1571
1572     $scope.invalidate_field = function(field) {
1573         patronRegSvc.invalidate_field($scope.patron, field);
1574     }
1575
1576
1577     $scope.dupe_value_changed = function(type, value) {
1578         $scope.dupe_counts[type] = 0;
1579         patronRegSvc.dupe_patron_search($scope.patron, type, value)
1580         .then(function(res) {
1581             $scope.dupe_counts[type] = res.count;
1582             if (res.count) {
1583                 $scope.dupe_search_encoded = 
1584                     encodeURIComponent(js2JSON(res.search));
1585             } else {
1586                 $scope.dupe_search_encoded = '';
1587             }
1588         });
1589     }
1590
1591     $scope.handle_home_org_changed = function() {
1592         org_id = $scope.patron.home_ou.id();
1593         patronRegSvc.has_perms_for_org(org_id).then(function(map) {
1594             angular.forEach(map, function(v, k) { $scope.perms[k] = v });
1595         });
1596     }
1597
1598     // This is called with every character typed in a form field,
1599     // since that's the only way to gaurantee something has changed.
1600     // See handle_field_changed for ng-change vs. ng-blur.
1601     $scope.field_modified = function() {
1602         // Call attach with every field change, regardless of whether
1603         // it's been called before.  This will allow for re-attach after
1604         // the user clicks through the unload warning. egUnloadPrompt
1605         // will ensure we only attach once.
1606         egUnloadPrompt.attach($scope);
1607     }
1608
1609     // username regex (if present) must be removed any time
1610     // the username matches the barcode to avoid firing the
1611     // invalid field handlers.
1612     function apply_username_regex() {
1613         var regex = $scope.org_settings['opac.username_regex'];
1614         if (regex) {
1615             if ($scope.patron.card.barcode) {
1616                 // username must match the regex or the barcode
1617                 field_patterns.au.usrname = 
1618                     new RegExp(
1619                         regex + '|^' + $scope.patron.card.barcode + '$');
1620             } else {
1621                 // username must match the regex
1622                 field_patterns.au.usrname = new RegExp(regex);
1623             }
1624         } else {
1625             // username can be any format.
1626             field_patterns.au.usrname = new RegExp('.*');
1627         }
1628     }
1629
1630     // obj could be the patron, an address, etc.
1631     // This is called any time a form field achieves then loses focus.
1632     // It does not necessarily mean the field has changed.
1633     // The alternative is ng-change, but it's called with each character
1634     // typed, which would be overkill for many of the actions called here.
1635     $scope.handle_field_changed = function(obj, field_name) {
1636         var cls = obj.classname; // set by egIdl
1637         var value = obj[field_name];
1638
1639         console.log('changing field ' + field_name + ' to ' + value);
1640
1641         switch (field_name) {
1642             case 'day_phone' : 
1643                 if ($scope.patron.day_phone && 
1644                     $scope.patron.isnew && 
1645                     $scope.org_settings['patron.password.use_phone']) {
1646                     $scope.patron.passwd = phone.substr(-4);
1647                 }
1648             case 'evening_phone' : 
1649             case 'other_phone' : 
1650                 $scope.dupe_value_changed('phone', value);
1651                 break;
1652
1653             case 'ident_value':
1654             case 'ident_value2':
1655                 $scope.dupe_value_changed('ident', value);
1656                 break;
1657
1658             case 'first_given_name':
1659             case 'family_name':
1660                 $scope.dupe_value_changed('name', value);
1661                 break;
1662
1663             case 'email':
1664                 $scope.dupe_value_changed('email', value);
1665                 break;
1666
1667             case 'street1':
1668             case 'street2':
1669             case 'city':
1670                 // dupe search on address wants the address object as the value.
1671                 $scope.dupe_value_changed('address', obj);
1672                 break;
1673
1674             case 'post_code':
1675                 $scope.post_code_changed(obj);
1676                 break;
1677
1678             case 'usrname':
1679                 patronRegSvc.check_dupe_username(value)
1680                 .then(function(yes) {$scope.dupe_username = Boolean(yes)});
1681                 break;
1682
1683             case 'barcode':
1684                 // TODO: finish barcode_changed handler.
1685                 $scope.barcode_changed(value);
1686                 apply_username_regex();
1687                 break;
1688
1689             case 'dob':
1690                 maintain_juvenile_flag();
1691                 break;
1692         }
1693     }
1694
1695     // patron.juvenile is set to true if the user was born after
1696     function maintain_juvenile_flag() {
1697         if ( !($scope.patron && $scope.patron.dob) ) return;
1698
1699         var juv_interval = 
1700             $scope.org_settings['global.juvenile_age_threshold'] 
1701             || '18 years';
1702
1703         var base = new Date();
1704
1705         base.setTime(base.getTime() - 
1706             Number(egCore.date.intervalToSeconds(juv_interval) + '000'));
1707
1708         $scope.patron.juvenile = ($scope.patron.dob > base);
1709     }
1710
1711     // returns true (disable) for orgs that cannot have users.
1712     $scope.disable_home_org = function(org_id) {
1713         if (!org_id) return;
1714         var org = egCore.org.get(org_id);
1715         return (
1716             org &&
1717             org.ou_type() &&
1718             org.ou_type().can_have_users() == 'f'
1719         );
1720     }
1721
1722     // Returns true if the Save and Save & Clone buttons should be disabled.
1723     $scope.edit_passthru.hide_save_actions = function() {
1724         return $scope.patron.isnew ?
1725             !$scope.perms.CREATE_USER : 
1726             !$scope.perms.UPDATE_USER;
1727     }
1728
1729     // Returns true if any input elements are tagged as invalid
1730     // via Angular patterns or required attributes.
1731     function form_has_invalid_fields() {
1732         return $('#patron-reg-container .ng-invalid').length > 0;
1733     }
1734
1735     function form_is_incomplete() {
1736         return (
1737             $scope.dupe_username ||
1738             $scope.dupe_barcode ||
1739             form_has_invalid_fields()
1740         );
1741
1742     }
1743
1744     $scope.edit_passthru.save = function(save_args) {
1745         if (!save_args) save_args = {};
1746
1747         if (form_is_incomplete()) {
1748             // User has not provided valid values for all required fields.
1749             return egAlertDialog.open(egCore.strings.REG_INVALID_FIELDS);
1750         }
1751
1752         // remove page unload warning prompt
1753         egUnloadPrompt.clear();
1754
1755         // toss the deleted addresses back into the patron's list of
1756         // addresses so it's included in the update
1757         $scope.patron.addresses = 
1758             $scope.patron.addresses.concat(deleted_addresses);
1759         
1760         compress_hold_notify();
1761
1762         var updated_user;
1763
1764         patronRegSvc.save_user($scope.patron)
1765         .then(function(new_user) { 
1766             if (new_user && new_user.classname) {
1767                 updated_user = new_user;
1768                 return patronRegSvc.save_user_settings(
1769                     new_user, $scope.user_settings); 
1770             } else {
1771                 alert('Patron update failed. \n\n' + js2JSON(new_user));
1772             }
1773
1774         }).then(function() {
1775
1776             // only remove the staged user if the update succeeded.
1777             if (updated_user) 
1778                 return patronRegSvc.remove_staged_user();
1779
1780             return $q.when();
1781
1782         }).then(function() {
1783
1784             // linked groups for new users must be created after the new
1785             // user is created.
1786             if ($scope.patron.isnew && 
1787                 $scope.patron.groups && $scope.patron.groups.length) {
1788                 var ids = $scope.patron.groups.map(function(g) {return g.id()});
1789                 return patronRegSvc.apply_secondary_groups(updated_user.id(), ids)
1790             }
1791
1792             return $q.when();
1793
1794         }).then(function() {
1795
1796             // reloading the page means potentially losing some information
1797             // (e.g. last patron search), but is the only way to ensure all
1798             // components are properly updated to reflect the modified patron.
1799             if (updated_user && save_args.clone) {
1800                 // open a separate tab for registering a new 
1801                 // patron from our cloned data.
1802                 var url = 'https://' 
1803                     + $window.location.hostname 
1804                     + egCore.env.basePath 
1805                     + '/circ/patron/register/clone/' 
1806                     + updated_user.id();
1807                 $window.open(url, '_blank').focus();
1808
1809             } else {
1810                 // reload the current page
1811                 $window.location.href = location.href;
1812             }
1813         });
1814     }
1815 }
1816
1817 // This controller may be loaded from different modules (patron edit vs.
1818 // register new patron), so we have to inject the controller params manually.
1819 PatronRegCtrl.$inject = ['$scope', '$routeParams', '$q', '$modal', 
1820     '$window', 'egCore', 'patronSvc', 'patronRegSvc', 'egUnloadPrompt', 'egAlertDialog'];
1821