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