@tellescope/sdk 2.0.0-beta.1 → 2.0.0-beta.3

package/lib/esm/tests/api_tests/programs.test.js

@@ -105,23 +105,23 @@ var poll_for = function (get, done, attempts) {
     });
 };
 export var programs_checks = function () { return __awaiter(void 0, void 0, void 0, function () {
-    var checks, record, tenant, sdk_1, programsEnduser, createdPrograms, replacedPrograms, missingNameError, err_1, authToken, enduserSession, selfRead, selfUpdateError, err_2, afterSelfUpdate, ORDER_SOURCE_1, create_order_1, tags_after_order, orderMatching, orderNonMatching, orderNoPrograms, configuration, tags_after_reading, vitalMatching, vitalNonMatching, e_1;
-    var _a, _b;
-    return __generator(this, function (_c) {
-        switch (_c.label) {
+    var checks, record, tenant, sdk_1, programsEnduser, createdPrograms, replacedPrograms, missingNameError, err_1, authToken, enduserSession, selfRead, selfUpdateError, err_2, afterSelfUpdate, ORDER_SOURCE_1, create_order_1, tags_after_order, orderMatching, orderNonMatching, orderNoPrograms, configuration, tags_after_reading, vitalMatching, vitalNonMatching, CONDITION_FIELD_1, tags_after_create, conditionMatching, conditionNonMatching, MUTATION_FIELD_1, PROGRAM_1, save_trigger_error, unknownMatchKey, unknownValueKey, operatorKey, emptyMatch, emptyUpdate, unknownField, fire_mutation, programs_once_1, settled_enduser, addedId, added, duplicateId, afterDuplicate, updatedId, afterUpdate, clearedId, afterClear, clearedEntry, removedId, afterRemove, noMatchRemoveId, noMatchUpdateId, afterNoMatchRemove, afterNoMatchUpdate, alreadyDischargedId, afterAlreadyDischarged, fieldsChangedEnduser_1, fieldsChangedTags, emptiedEnduser_1, emptiedTags, _a, _b, _c, _d, _e, _f, cascadeId, afterCascade, fieldEqualsTags, feMatching, feNonMatching, BULK_SOURCE_1, BULK_PROGRAM_1, bulkEndusers, _g, bulkPrograms, e_1;
+    var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+    return __generator(this, function (_v) {
+        switch (_v.label) {
             case 0:
                 checks = [];
                 record = function (label, pass, detail) { return checks.push({ label: label, pass: pass, detail: detail }); };
-                _c.label = 1;
+                _v.label = 1;
             case 1:
-                _c.trys.push([1, , 29, 34]);
+                _v.trys.push([1, , 80, 85]);
                 return [4 /*yield*/, setup_isolated_tenant({
                         name: "ProgramFilters ".concat(RAND()),
                         users: [{ isAdmin: true }],
                         apiKeys: 0,
                     })];
             case 2:
-                tenant = _c.sent();
+                tenant = _v.sent();
                 sdk_1 = tenant.sdk;
                 return [4 /*yield*/, sdk_1.api.endusers.createOne({
                         fname: 'Programs',
@@ -129,69 +129,71 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                         email: "programs-field-".concat(RAND(), "@tellescope.example"),
                         devices: [{ title: 'Cuff', id: "dev-a-".concat(RAND()) }, { title: 'Scale', id: "dev-b-".concat(RAND()) }],
                         programs: [
-                            { name: 'CHF', deviceIds: ['dev-a'] },
-                            { name: 'Diabetes' }, // deviceIds is optional
+                            { name: 'CHF', deviceIds: ['dev-a'], status: 'Active' },
+                            { name: 'Diabetes' }, // deviceIds and status are optional
                         ],
                     })];
             case 3:
-                programsEnduser = _c.sent();
+                programsEnduser = _v.sent();
                 return [4 /*yield*/, sdk_1.api.endusers.getOne(programsEnduser.id)];
             case 4:
-                createdPrograms = (_c.sent()).programs;
-                record('F: Enduser.programs round-trips on create, with and without deviceIds', (createdPrograms === null || createdPrograms === void 0 ? void 0 : createdPrograms.length) === 2
+                createdPrograms = (_v.sent()).programs;
+                record('F: Enduser.programs round-trips on create, with and without deviceIds / status', (createdPrograms === null || createdPrograms === void 0 ? void 0 : createdPrograms.length) === 2
                     && createdPrograms[0].name === 'CHF'
                     && JSON.stringify(createdPrograms[0].deviceIds) === JSON.stringify(['dev-a'])
+                    && createdPrograms[0].status === 'Active'
                     && createdPrograms[1].name === 'Diabetes'
-                    && createdPrograms[1].deviceIds === undefined, "programs=".concat(JSON.stringify(createdPrograms)));
+                    && createdPrograms[1].deviceIds === undefined
+                    && createdPrograms[1].status === undefined, "programs=".concat(JSON.stringify(createdPrograms)));
                 return [4 /*yield*/, sdk_1.api.endusers.updateOne(programsEnduser.id, { programs: [{ name: 'CHF', deviceIds: ['dev-a', 'dev-b'] }] }, { replaceObjectFields: true })];
             case 5:
-                _c.sent();
+                _v.sent();
                 return [4 /*yield*/, sdk_1.api.endusers.getOne(programsEnduser.id)];
             case 6:
-                replacedPrograms = (_c.sent()).programs;
+                replacedPrograms = (_v.sent()).programs;
                 record('G: updating programs with replaceObjectFields replaces the whole list', (replacedPrograms === null || replacedPrograms === void 0 ? void 0 : replacedPrograms.length) === 1
                     && replacedPrograms[0].name === 'CHF'
                     && JSON.stringify(replacedPrograms[0].deviceIds) === JSON.stringify(['dev-a', 'dev-b']), "programs=".concat(JSON.stringify(replacedPrograms)));
                 missingNameError = '';
-                _c.label = 7;
+                _v.label = 7;
             case 7:
-                _c.trys.push([7, 9, , 10]);
+                _v.trys.push([7, 9, , 10]);
                 return [4 /*yield*/, sdk_1.api.endusers.updateOne(programsEnduser.id, { programs: [{ deviceIds: ['dev-a'] }] })];
             case 8:
-                _c.sent();
+                _v.sent();
                 return [3 /*break*/, 10];
             case 9:
-                err_1 = _c.sent();
-                missingNameError = (_a = err_1 === null || err_1 === void 0 ? void 0 : err_1.message) !== null && _a !== void 0 ? _a : String(err_1);
+                err_1 = _v.sent();
+                missingNameError = (_h = err_1 === null || err_1 === void 0 ? void 0 : err_1.message) !== null && _h !== void 0 ? _h : String(err_1);
                 return [3 /*break*/, 10];
             case 10:
                 record('H: a program entry without a name is rejected', missingNameError.includes('name'), "error=".concat(JSON.stringify(missingNameError) || '(none — the write was ACCEPTED)'));
                 return [4 /*yield*/, sdk_1.api.endusers.generate_auth_token({ id: programsEnduser.id })];
             case 11:
-                authToken = (_c.sent()).authToken;
+                authToken = (_v.sent()).authToken;
                 enduserSession = new EnduserSession({ host: host, authToken: authToken, businessId: tenant.businessId });
                 return [4 /*yield*/, enduserSession.refresh_session()];
             case 12:
-                _c.sent();
+                _v.sent();
                 return [4 /*yield*/, enduserSession.api.endusers.getOne(programsEnduser.id)];
             case 13:
-                selfRead = _c.sent();
+                selfRead = _v.sent();
                 record('I: Enduser.programs is redacted from the enduser\'s own read of their record', selfRead.programs === undefined, "enduser-session programs=".concat(JSON.stringify(selfRead.programs)));
                 selfUpdateError = '';
-                _c.label = 14;
+                _v.label = 14;
             case 14:
-                _c.trys.push([14, 16, , 17]);
+                _v.trys.push([14, 16, , 17]);
                 return [4 /*yield*/, enduserSession.api.endusers.updateOne(programsEnduser.id, { programs: [{ name: 'Self Assigned' }] })];
             case 15:
-                _c.sent();
+                _v.sent();
                 return [3 /*break*/, 17];
             case 16:
-                err_2 = _c.sent();
-                selfUpdateError = (_b = err_2 === null || err_2 === void 0 ? void 0 : err_2.message) !== null && _b !== void 0 ? _b : String(err_2);
+                err_2 = _v.sent();
+                selfUpdateError = (_j = err_2 === null || err_2 === void 0 ? void 0 : err_2.message) !== null && _j !== void 0 ? _j : String(err_2);
                 return [3 /*break*/, 17];
             case 17: return [4 /*yield*/, sdk_1.api.endusers.getOne(programsEnduser.id)];
             case 18:
-                afterSelfUpdate = (_c.sent()).programs;
+                afterSelfUpdate = (_v.sent()).programs;
                 record('J: an enduser cannot update their own programs', selfUpdateError.includes('cannot be updated by endusers')
                     && (afterSelfUpdate === null || afterSelfUpdate === void 0 ? void 0 : afterSelfUpdate.length) === 1 && afterSelfUpdate[0].name === 'CHF', "error=".concat(JSON.stringify(selfUpdateError) || '(none — the write was ACCEPTED)')
                     + " programs=".concat(JSON.stringify(afterSelfUpdate)));
@@ -205,7 +207,7 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                     // no programs filter — the shape of every trigger that exists today; must match regardless
                 ];
             case 19:
-                _c.sent();
+                _v.sent();
                 // no programs filter — the shape of every trigger that exists today; must match regardless
                 return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
                         event: { type: 'Order Status Equals', info: { source: ORDER_SOURCE_1, status: 'shipped' } },
@@ -215,7 +217,7 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                     })];
             case 20:
                 // no programs filter — the shape of every trigger that exists today; must match regardless
-                _c.sent();
+                _v.sent();
                 create_order_1 = function (enduserId, programs) { return __awaiter(void 0, void 0, void 0, function () {
                     return __generator(this, function (_a) {
                         return [2 /*return*/, (sdk_1.api.enduser_orders.createOne(__assign({ enduserId: enduserId, source: ORDER_SOURCE_1, externalId: "ext-".concat(RAND()), title: 'Program filter order', status: 'shipped' }, (programs ? { programs: programs } : {}))))];
@@ -243,15 +245,15 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                 }); };
                 return [4 /*yield*/, tags_after_order([{ name: 'CHF' }])];
             case 21:
-                orderMatching = _c.sent();
+                orderMatching = _v.sent();
                 record('A: Order Status Equals with programs=[CHF] fires for an order in program CHF', orderMatching.includes('order-chf') && orderMatching.includes('order-any'), "tags=".concat(JSON.stringify(orderMatching)));
                 return [4 /*yield*/, tags_after_order([{ name: 'Diabetes' }])];
             case 22:
-                orderNonMatching = _c.sent();
+                orderNonMatching = _v.sent();
                 record('B: Order Status Equals with programs=[CHF] does NOT fire for an order in program Diabetes', !orderNonMatching.includes('order-chf') && orderNonMatching.includes('order-any'), "tags=".concat(JSON.stringify(orderNonMatching)));
                 return [4 /*yield*/, tags_after_order(undefined)];
             case 23:
-                orderNoPrograms = _c.sent();
+                orderNoPrograms = _v.sent();
                 record('C: Order Status Equals with programs=[CHF] does NOT fire for an order with no programs,'
                     + ' while the unfiltered trigger still does (back-compat)', !orderNoPrograms.includes('order-chf') && orderNoPrograms.includes('order-any'), "tags=".concat(JSON.stringify(orderNoPrograms)));
                 return [4 /*yield*/, sdk_1.api.vital_configurations.createOne({
@@ -265,7 +267,7 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                         ],
                     })];
             case 24:
-                configuration = _c.sent();
+                configuration = _v.sent();
                 return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
                         event: {
                             type: 'Vital Update',
@@ -276,7 +278,7 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                         title: "Vital programs=[CHF] ".concat(RAND()),
                     })];
             case 25:
-                _c.sent();
+                _v.sent();
                 return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
                         event: {
                             type: 'Vital Update',
@@ -287,7 +289,7 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                         title: "Vital programs unset ".concat(RAND()),
                     })];
             case 26:
-                _c.sent();
+                _v.sent();
                 tags_after_reading = function (programs) { return __awaiter(void 0, void 0, void 0, function () {
                     var enduser, after;
                     var _a;
@@ -308,29 +310,448 @@ export var programs_checks = function () { return __awaiter(void 0, void 0, void
                 }); };
                 return [4 /*yield*/, tags_after_reading([{ name: 'CHF' }])];
             case 27:
-                vitalMatching = _c.sent();
+                vitalMatching = _v.sent();
                 record('D: Vital Update with programs=[CHF] fires for a reading in program CHF', vitalMatching.includes('vital-chf') && vitalMatching.includes('vital-any'), "tags=".concat(JSON.stringify(vitalMatching)));
                 return [4 /*yield*/, tags_after_reading([{ name: 'Diabetes' }])];
             case 28:
-                vitalNonMatching = _c.sent();
+                vitalNonMatching = _v.sent();
                 record('E: Vital Update with programs=[CHF] does NOT fire for a reading in program Diabetes,'
                     + ' while the unfiltered trigger still does (back-compat)', !vitalNonMatching.includes('vital-chf') && vitalNonMatching.includes('vital-any'), "tags=".concat(JSON.stringify(vitalNonMatching)));
-                return [3 /*break*/, 34];
+                CONDITION_FIELD_1 = "ProgramConditionKey".concat(RAND());
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: CONDITION_FIELD_1, value: 'go' } },
+                        action: { type: 'Add Tags', info: { tags: ['condition-chf'] } },
+                        enduserCondition: { $and: [{ condition: { Programs: { $in: 'CHF' } } }] },
+                        status: 'Active',
+                        title: "Programs condition Is In CHF ".concat(RAND()),
+                    })
+                    // the same event with no enduserCondition — the barrier that makes an absence above meaningful
+                ];
             case 29:
-                if (!tenant) return [3 /*break*/, 33];
-                _c.label = 30;
+                _v.sent();
+                // the same event with no enduserCondition — the barrier that makes an absence above meaningful
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: CONDITION_FIELD_1, value: 'go' } },
+                        action: { type: 'Add Tags', info: { tags: ['condition-any'] } },
+                        status: 'Active',
+                        title: "Programs condition unset ".concat(RAND()),
+                    })
+                    // `waitFor` is the tag that makes the read meaningful. For the positive check that is the
+                    // conditioned trigger's own tag — the two triggers are dispatched by separate awaited calls, so the
+                    // unconditioned trigger's tag can land first and polling on it alone would read too early. For the
+                    // negative check, where there is no tag to wait for, the unconditioned trigger is the barrier.
+                ];
             case 30:
-                _c.trys.push([30, 32, , 33]);
-                return [4 /*yield*/, tenant.teardown()];
+                // the same event with no enduserCondition — the barrier that makes an absence above meaningful
+                _v.sent();
+                tags_after_create = function (programs, waitFor) { return __awaiter(void 0, void 0, void 0, function () {
+                    var enduser, after;
+                    var _a;
+                    var _b;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0: return [4 /*yield*/, sdk_1.api.endusers.createOne(__assign({ fname: 'Programs', lname: 'Condition', fields: (_a = {}, _a[CONDITION_FIELD_1] = 'go', _a) }, (programs ? { programs: programs } : {})))];
+                            case 1:
+                                enduser = _c.sent();
+                                return [4 /*yield*/, poll_for(function () { return sdk_1.api.endusers.getOne(enduser.id); }, function (e) { var _a; return !!((_a = e.tags) === null || _a === void 0 ? void 0 : _a.includes(waitFor)); })];
+                            case 2:
+                                after = _c.sent();
+                                return [2 /*return*/, (_b = after.tags) !== null && _b !== void 0 ? _b : []];
+                        }
+                    });
+                }); };
+                return [4 /*yield*/, tags_after_create([{ name: 'CHF', status: 'active' }], 'condition-chf')];
             case 31:
-                _c.sent();
-                return [3 /*break*/, 33];
+                conditionMatching = _v.sent();
+                record('K: a trigger with a Programs Is In CHF enduserCondition fires for a patient in program CHF', conditionMatching.includes('condition-chf') && conditionMatching.includes('condition-any'), "tags=".concat(JSON.stringify(conditionMatching)));
+                return [4 /*yield*/, tags_after_create(undefined, 'condition-any')];
             case 32:
-                e_1 = _c.sent();
+                conditionNonMatching = _v.sent();
+                record('L: the same trigger does NOT fire for a patient with no programs,'
+                    + ' while the unconditioned trigger still does', !conditionNonMatching.includes('condition-chf') && conditionNonMatching.includes('condition-any'), "tags=".concat(JSON.stringify(conditionNonMatching)));
+                MUTATION_FIELD_1 = "ProgramMutation".concat(RAND());
+                PROGRAM_1 = 'CHF';
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: MUTATION_FIELD_1, value: '$exists' } },
+                        action: { type: 'Add Tags', info: { tags: ['mutation-any'] } },
+                        status: 'Active',
+                        title: "Mutation barrier ".concat(RAND()),
+                    })];
+            case 33:
+                _v.sent();
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: MUTATION_FIELD_1, value: 'add' } },
+                        action: { type: 'Add List Item', info: { field: 'programs', match: { name: PROGRAM_1 }, values: { status: 'Active' } } },
+                        status: 'Active',
+                        title: "Add List Item ".concat(RAND()),
+                    })];
+            case 34:
+                _v.sent();
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: MUTATION_FIELD_1, value: 'status' } },
+                        action: { type: 'Update List Item', info: { field: 'programs', match: { name: PROGRAM_1 }, values: { status: 'Discharged' } } },
+                        status: 'Active',
+                        title: "Update List Item ".concat(RAND()),
+                    })];
+            case 35:
+                _v.sent();
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        // a BLANK value clears that sub-field, rather than being a no-op — the $unset half of the action
+                        event: { type: 'Field Equals', info: { field: MUTATION_FIELD_1, value: 'clear' } },
+                        action: { type: 'Update List Item', info: { field: 'programs', match: { name: PROGRAM_1 }, values: { status: '' } } },
+                        status: 'Active',
+                        title: "Clear List Item status ".concat(RAND()),
+                    })];
+            case 36:
+                _v.sent();
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: MUTATION_FIELD_1, value: 'remove' } },
+                        action: { type: 'Remove List Item', info: { field: 'programs', match: { name: PROGRAM_1 } } },
+                        status: 'Active',
+                        title: "Remove List Item ".concat(RAND()),
+                    })
+                    /**
+                     * The sub-fields a mutation may touch are ENDUSER_LIST_FIELD_CONFIG's, checked when the trigger is
+                     * SAVED (an automation_triggers constraint, sharing list_item_mutation_error with the editor).
+                     *
+                     * Rejecting here rather than at fire time is the point: an accepted-but-ignored key leaves a
+                     * trigger that looks configured and silently never does what it says. It is also what keeps a
+                     * `$`-prefixed or dotted key out of the Mongo paths the action builds from these keys.
+                     */
+                ];
+            case 37:
+                _v.sent();
+                save_trigger_error = function (action) { return __awaiter(void 0, void 0, void 0, function () {
+                    var created, err_3;
+                    var _a;
+                    return __generator(this, function (_b) {
+                        switch (_b.label) {
+                            case 0:
+                                _b.trys.push([0, 3, , 4]);
+                                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                                        event: { type: 'Field Equals', info: { field: "Never".concat(RAND()), value: 'never' } },
+                                        action: action,
+                                        status: 'Inactive', title: "Rejected ".concat(RAND()),
+                                    })
+                                    // it saved; leave nothing behind for the later checks to trip over
+                                ];
+                            case 1:
+                                created = _b.sent();
+                                // it saved; leave nothing behind for the later checks to trip over
+                                return [4 /*yield*/, sdk_1.api.automation_triggers.deleteOne(created.id)];
+                            case 2:
+                                // it saved; leave nothing behind for the later checks to trip over
+                                _b.sent();
+                                return [2 /*return*/, ''];
+                            case 3:
+                                err_3 = _b.sent();
+                                return [2 /*return*/, (_a = err_3 === null || err_3 === void 0 ? void 0 : err_3.message) !== null && _a !== void 0 ? _a : String(err_3)];
+                            case 4: return [2 /*return*/];
+                        }
+                    });
+                }); };
+                return [4 /*yield*/, save_trigger_error({
+                        type: 'Add List Item', info: { field: 'programs', match: { title: PROGRAM_1 } },
+                    })];
+            case 38:
+                unknownMatchKey = _v.sent();
+                return [4 /*yield*/, save_trigger_error({
+                        type: 'Update List Item', info: { field: 'programs', match: { name: PROGRAM_1 }, values: { deviceIds: 'x' } },
+                    })];
+            case 39:
+                unknownValueKey = _v.sent();
+                return [4 /*yield*/, save_trigger_error({
+                        type: 'Add List Item', info: { field: 'programs', match: { '$where': PROGRAM_1 } },
+                    })];
+            case 40:
+                operatorKey = _v.sent();
+                return [4 /*yield*/, save_trigger_error({
+                        type: 'Remove List Item', info: { field: 'programs', match: {} },
+                    })];
+            case 41:
+                emptyMatch = _v.sent();
+                return [4 /*yield*/, save_trigger_error({
+                        type: 'Update List Item', info: { field: 'programs', match: { name: PROGRAM_1 }, values: {} },
+                    })];
+            case 42:
+                emptyUpdate = _v.sent();
+                return [4 /*yield*/, save_trigger_error({
+                        type: 'Add List Item', info: { field: 'diagnoses', match: { code: 'I50' } },
+                    })];
+            case 43:
+                unknownField = _v.sent();
+                record('Y: a list mutation naming a sub-field (or field) outside the registry is rejected ON SAVE,'
+                    + ' naming the offending key', 
+                // the message, not merely "an error": the point of sharing list_item_mutation_error with the
+                // editor is that both reject the same action with the same wording, and a rejection for some
+                // unrelated reason would pass a non-empty check while proving nothing
+                unknownMatchKey.includes('title') && unknownValueKey.includes('deviceIds')
+                    && operatorKey.includes('$where') && unknownField.includes('diagnoses'), "match=".concat(JSON.stringify(unknownMatchKey), " values=").concat(JSON.stringify(unknownValueKey))
+                    + " operator=".concat(JSON.stringify(operatorKey), " field=").concat(JSON.stringify(unknownField)));
+                record('Z: a list mutation that matches nothing, or an Update that sets nothing, is rejected ON SAVE', !!emptyMatch && !!emptyUpdate, "emptyMatch=".concat(JSON.stringify(emptyMatch), " emptyUpdate=").concat(JSON.stringify(emptyUpdate)));
+                fire_mutation = function (value, programs) { return __awaiter(void 0, void 0, void 0, function () {
+                    var enduser;
+                    var _a;
+                    return __generator(this, function (_b) {
+                        switch (_b.label) {
+                            case 0: return [4 /*yield*/, sdk_1.api.endusers.createOne(__assign({ fname: 'Programs', lname: 'Mutation' }, (programs ? { programs: programs } : {})))
+                                // an UPDATE, not a create: the mutation actions are reached through the update path, and Field
+                                // Equals on programs (below) is update-only
+                            ];
+                            case 1:
+                                enduser = _b.sent();
+                                // an UPDATE, not a create: the mutation actions are reached through the update path, and Field
+                                // Equals on programs (below) is update-only
+                                return [4 /*yield*/, sdk_1.api.endusers.updateOne(enduser.id, { fields: (_a = {}, _a[MUTATION_FIELD_1] = value, _a) })];
+                            case 2:
+                                // an UPDATE, not a create: the mutation actions are reached through the update path, and Field
+                                // Equals on programs (below) is update-only
+                                _b.sent();
+                                return [2 /*return*/, enduser.id];
+                        }
+                    });
+                }); };
+                programs_once_1 = function (id, done, attempts) { return __awaiter(void 0, void 0, void 0, function () {
+                    var _a;
+                    return __generator(this, function (_b) {
+                        switch (_b.label) {
+                            case 0: return [4 /*yield*/, poll_for(function () { return sdk_1.api.endusers.getOne(id); }, function (e) { var _a; return done((_a = e.programs) !== null && _a !== void 0 ? _a : []); }, attempts)];
+                            case 1: return [2 /*return*/, ((_a = (_b.sent()).programs) !== null && _a !== void 0 ? _a : [])
+                                /**
+                                 * For the checks that assert NOTHING changed. The barrier tag proves trigger processing happened for
+                                 * this patient, but the barrier and the mutation are two triggers dispatched from one loop in
+                                 * whatever order the trigger page came back in, so the tag alone does not prove the mutation already
+                                 * ran. The extra settle closes that window; the positive checks need none of this, since they poll
+                                 * for their own effect.
+                                 */
+                            ];
+                        }
+                    });
+                }); };
+                settled_enduser = function (id) { return __awaiter(void 0, void 0, void 0, function () {
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0: return [4 /*yield*/, poll_for(function () { return sdk_1.api.endusers.getOne(id); }, function (e) { var _a; return !!((_a = e.tags) === null || _a === void 0 ? void 0 : _a.includes('mutation-any')); })];
+                            case 1:
+                                _a.sent();
+                                return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 2000); })];
+                            case 2:
+                                _a.sent();
+                                return [2 /*return*/, sdk_1.api.endusers.getOne(id)];
+                        }
+                    });
+                }); };
+                return [4 /*yield*/, fire_mutation('add')];
+            case 44:
+                addedId = _v.sent();
+                return [4 /*yield*/, programs_once_1(addedId, function (p) { return p.length > 0; })];
+            case 45:
+                added = _v.sent();
+                record('M: Add List Item adds the configured program, with the status the action carries', added.length === 1 && added[0].name === PROGRAM_1 && added[0].status === 'Active', "programs=".concat(JSON.stringify(added)));
+                return [4 /*yield*/, fire_mutation('add', [{ name: PROGRAM_1, status: 'Discharged' }])];
+            case 46:
+                duplicateId = _v.sent();
+                return [4 /*yield*/, settled_enduser(duplicateId)];
+            case 47:
+                afterDuplicate = (_k = (_v.sent()).programs) !== null && _k !== void 0 ? _k : [];
+                record('N: Add List Item no-ops when the patient is already in that program, and does NOT reset its status', afterDuplicate.length === 1
+                    && afterDuplicate[0].name === PROGRAM_1 && afterDuplicate[0].status === 'Discharged', "programs=".concat(JSON.stringify(afterDuplicate)));
+                return [4 /*yield*/, fire_mutation('status', [
+                        { name: PROGRAM_1, status: 'Active' }, { name: 'Diabetes', status: 'Active' }, { name: PROGRAM_1 },
+                    ])];
+            case 48:
+                updatedId = _v.sent();
+                return [4 /*yield*/, programs_once_1(updatedId, function (p) { return p.filter(function (x) { return x.name === PROGRAM_1 && x.status === 'Discharged'; }).length === 2; })];
+            case 49:
+                afterUpdate = _v.sent();
+                record('O: Update List Item sets the status on EVERY entry with that name, and on no other entry', afterUpdate.length === 3
+                    && afterUpdate.filter(function (p) { return p.name === PROGRAM_1 && p.status === 'Discharged'; }).length === 2
+                    && ((_l = afterUpdate.find(function (p) { return p.name === 'Diabetes'; })) === null || _l === void 0 ? void 0 : _l.status) === 'Active', "programs=".concat(JSON.stringify(afterUpdate)));
+                return [4 /*yield*/, fire_mutation('clear', [
+                        { name: PROGRAM_1, status: 'Active' }, { name: 'Diabetes', status: 'Active' },
+                    ])];
+            case 50:
+                clearedId = _v.sent();
+                return [4 /*yield*/, programs_once_1(clearedId, function (p) { return p.some(function (x) { return x.name === PROGRAM_1 && x.status === undefined; }); })];
+            case 51:
+                afterClear = _v.sent();
+                clearedEntry = afterClear.find(function (p) { return p.name === PROGRAM_1; });
+                record('AA: Update List Item with a blank value CLEARS that sub-field, leaving no key behind', afterClear.length === 2
+                    && !!clearedEntry && !('status' in clearedEntry)
+                    && ((_m = afterClear.find(function (p) { return p.name === 'Diabetes'; })) === null || _m === void 0 ? void 0 : _m.status) === 'Active', "programs=".concat(JSON.stringify(afterClear))
+                    + " keys=".concat(JSON.stringify(Object.keys(clearedEntry !== null && clearedEntry !== void 0 ? clearedEntry : {}))));
+                return [4 /*yield*/, fire_mutation('remove', [
+                        { name: PROGRAM_1 }, { name: 'Diabetes', status: 'Active' }, { name: PROGRAM_1, status: 'Active' },
+                    ])];
+            case 52:
+                removedId = _v.sent();
+                return [4 /*yield*/, programs_once_1(removedId, function (p) { return !p.some(function (x) { return x.name === PROGRAM_1; }); })];
+            case 53:
+                afterRemove = _v.sent();
+                record('P: Remove List Item removes EVERY entry with that name, whatever status they hold, and nothing else', afterRemove.length === 1 && afterRemove[0].name === 'Diabetes' && afterRemove[0].status === 'Active', "programs=".concat(JSON.stringify(afterRemove)));
+                return [4 /*yield*/, fire_mutation('remove', [{ name: 'Diabetes', status: 'Active' }])];
+            case 54:
+                noMatchRemoveId = _v.sent();
+                return [4 /*yield*/, fire_mutation('status', [{ name: 'Diabetes', status: 'Active' }])];
+            case 55:
+                noMatchUpdateId = _v.sent();
+                return [4 /*yield*/, settled_enduser(noMatchRemoveId)];
+            case 56:
+                afterNoMatchRemove = (_o = (_v.sent()).programs) !== null && _o !== void 0 ? _o : [];
+                return [4 /*yield*/, settled_enduser(noMatchUpdateId)];
+            case 57:
+                afterNoMatchUpdate = (_p = (_v.sent()).programs) !== null && _p !== void 0 ? _p : [];
+                record('Q: Remove and Update List Item both no-op when no entry carries that name', JSON.stringify(afterNoMatchRemove) === JSON.stringify([{ name: 'Diabetes', status: 'Active' }])
+                    && JSON.stringify(afterNoMatchUpdate) === JSON.stringify([{ name: 'Diabetes', status: 'Active' }]), "afterRemove=".concat(JSON.stringify(afterNoMatchRemove), " afterUpdate=").concat(JSON.stringify(afterNoMatchUpdate)));
+                return [4 /*yield*/, fire_mutation('status', [{ name: PROGRAM_1, status: 'Discharged' }])];
+            case 58:
+                alreadyDischargedId = _v.sent();
+                return [4 /*yield*/, settled_enduser(alreadyDischargedId)];
+            case 59:
+                afterAlreadyDischarged = (_q = (_v.sent()).programs) !== null && _q !== void 0 ? _q : [];
+                record('X: Update List Item leaves an entry alone when it already carries the target status', JSON.stringify(afterAlreadyDischarged) === JSON.stringify([{ name: PROGRAM_1, status: 'Discharged' }]), "programs=".concat(JSON.stringify(afterAlreadyDischarged)));
+                /* ============ Fields Changed on programs, and the no-cascade rule ============ */
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Fields Changed', info: { fields: ['programs'] } },
+                        action: { type: 'Add Tags', info: { tags: ['programs-fc'] } },
+                        status: 'Active',
+                        title: "Fields Changed programs ".concat(RAND()),
+                    })];
+            case 60:
+                /* ============ Fields Changed on programs, and the no-cascade rule ============ */
+                _v.sent();
+                return [4 /*yield*/, sdk_1.api.endusers.createOne({ fname: 'Programs', lname: 'Changed' })];
+            case 61:
+                fieldsChangedEnduser_1 = _v.sent();
+                return [4 /*yield*/, sdk_1.api.endusers.updateOne(fieldsChangedEnduser_1.id, { programs: [{ name: PROGRAM_1 }] }, { replaceObjectFields: true })];
+            case 62:
+                _v.sent();
+                return [4 /*yield*/, poll_for(function () { return sdk_1.api.endusers.getOne(fieldsChangedEnduser_1.id); }, function (e) { var _a; return !!((_a = e.tags) === null || _a === void 0 ? void 0 : _a.includes('programs-fc')); })];
+            case 63:
+                fieldsChangedTags = (_r = (_v.sent()).tags) !== null && _r !== void 0 ? _r : [];
+                record('R: a Fields Changed trigger on programs fires for a direct staff/API write', fieldsChangedTags.includes('programs-fc'), "tags=".concat(JSON.stringify(fieldsChangedTags)));
+                return [4 /*yield*/, sdk_1.api.endusers.createOne({
+                        fname: 'Programs', lname: 'Emptied', programs: [{ name: PROGRAM_1, status: 'Active' }],
+                    })];
+            case 64:
+                emptiedEnduser_1 = _v.sent();
+                return [4 /*yield*/, sdk_1.api.endusers.updateOne(emptiedEnduser_1.id, { programs: [] }, { replaceObjectFields: true })];
+            case 65:
+                _v.sent();
+                return [4 /*yield*/, poll_for(function () { return sdk_1.api.endusers.getOne(emptiedEnduser_1.id); }, function (e) { var _a; return !!((_a = e.tags) === null || _a === void 0 ? void 0 : _a.includes('programs-fc')); })];
+            case 66:
+                emptiedTags = (_s = (_v.sent()).tags) !== null && _s !== void 0 ? _s : [];
+                _a = record;
+                _b = ['W: a Fields Changed trigger on programs still fires when the patient\'s LAST program is removed',
+                    emptiedTags.includes('programs-fc')];
+                _c = "tags=".concat(JSON.stringify(emptiedTags));
+                _d = " programs=".concat;
+                _f = (_e = JSON).stringify;
+                return [4 /*yield*/, sdk_1.api.endusers.getOne(emptiedEnduser_1.id)];
+            case 67:
+                _a.apply(void 0, _b.concat([_c + _d.apply(" programs=", [_f.apply(_e, [(_v.sent()).programs])])]));
+                return [4 /*yield*/, fire_mutation('add')];
+            case 68:
+                cascadeId = _v.sent();
+                return [4 /*yield*/, programs_once_1(cascadeId, function (p) { return p.some(function (x) { return x.name === PROGRAM_1; }); })]; // the trigger's write landed
+            case 69:
+                _v.sent(); // the trigger's write landed
+                return [4 /*yield*/, settled_enduser(cascadeId)];
+            case 70:
+                afterCascade = _v.sent();
+                record('S: a program written by a trigger does NOT re-fire programs automations (no cascade),'
+                    + ' while trigger processing demonstrably ran for this patient', !((_t = afterCascade.tags) === null || _t === void 0 ? void 0 : _t.includes('programs-fc')) && !!((_u = afterCascade.tags) === null || _u === void 0 ? void 0 : _u.includes('mutation-any')), "tags=".concat(JSON.stringify(afterCascade.tags), " programs=").concat(JSON.stringify(afterCascade.programs)));
+                /* ============ Field Equals on programs ============ */
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Field Equals', info: { field: 'programs', value: PROGRAM_1 } },
+                        action: { type: 'Add Tags', info: { tags: ['programs-fe'] } },
+                        status: 'Active',
+                        title: "Field Equals programs ".concat(RAND()),
+                    })];
+            case 71:
+                /* ============ Field Equals on programs ============ */
+                _v.sent();
+                fieldEqualsTags = function (programs, waitFor) { return __awaiter(void 0, void 0, void 0, function () {
+                    var enduser, after;
+                    var _a;
+                    return __generator(this, function (_b) {
+                        switch (_b.label) {
+                            case 0: return [4 /*yield*/, sdk_1.api.endusers.createOne({ fname: 'Programs', lname: 'FieldEquals' })];
+                            case 1:
+                                enduser = _b.sent();
+                                return [4 /*yield*/, sdk_1.api.endusers.updateOne(enduser.id, { programs: programs }, { replaceObjectFields: true })];
+                            case 2:
+                                _b.sent();
+                                return [4 /*yield*/, poll_for(function () { return sdk_1.api.endusers.getOne(enduser.id); }, function (e) { var _a; return !!((_a = e.tags) === null || _a === void 0 ? void 0 : _a.includes(waitFor)); })];
+                            case 3:
+                                after = _b.sent();
+                                return [2 /*return*/, (_a = after.tags) !== null && _a !== void 0 ? _a : []];
+                        }
+                    });
+                }); };
+                return [4 /*yield*/, fieldEqualsTags([{ name: PROGRAM_1, status: 'Active' }], 'programs-fe')];
+            case 72:
+                feMatching = _v.sent();
+                record('T: Field Equals on programs fires for a patient put into a program of that name', feMatching.includes('programs-fe'), "tags=".concat(JSON.stringify(feMatching)));
+                return [4 /*yield*/, fieldEqualsTags([{ name: 'Diabetes' }], 'programs-fc')];
+            case 73:
+                feNonMatching = _v.sent();
+                return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 2000); })];
+            case 74:
+                _v.sent();
+                record('U: Field Equals on programs does NOT fire for a different program name,'
+                    + ' while the Fields Changed trigger on the same write still does', !feNonMatching.includes('programs-fe') && feNonMatching.includes('programs-fc'), "tags=".concat(JSON.stringify(feNonMatching)));
+                BULK_SOURCE_1 = "ProgramBulkSource".concat(RAND());
+                BULK_PROGRAM_1 = 'Bulk Program';
+                return [4 /*yield*/, sdk_1.api.automation_triggers.createOne({
+                        event: { type: 'Order Status Equals', info: { source: BULK_SOURCE_1, status: 'shipped' } },
+                        action: { type: 'Add List Item', info: { field: 'programs', match: { name: BULK_PROGRAM_1 } } },
+                        status: 'Active',
+                        title: "Bulk Add List Item ".concat(RAND()),
+                    })];
+            case 75:
+                _v.sent();
+                return [4 /*yield*/, sdk_1.api.endusers.createOne({ fname: 'Programs', lname: 'BulkA' })];
+            case 76:
+                _g = [
+                    _v.sent()
+                ];
+                return [4 /*yield*/, sdk_1.api.endusers.createOne({ fname: 'Programs', lname: 'BulkB' })];
+            case 77:
+                bulkEndusers = _g.concat([
+                    _v.sent()
+                ]);
+                return [4 /*yield*/, sdk_1.api.enduser_orders.createSome(bulkEndusers.map(function (e) { return ({
+                        enduserId: e.id,
+                        source: BULK_SOURCE_1,
+                        externalId: "ext-".concat(RAND()),
+                        title: 'Bulk program order',
+                        status: 'shipped',
+                    }); }))];
+            case 78:
+                _v.sent();
+                return [4 /*yield*/, Promise.all(bulkEndusers.map(function (e) { return (programs_once_1(e.id, function (p) { return p.some(function (x) { return x.name === BULK_PROGRAM_1; }); }, 240) // up to 60s; worker-paced
+                    ); }))];
+            case 79:
+                bulkPrograms = _v.sent();
+                record('V: an Add List Item action dispatched in bulk is deferred to the single-record path and applied'
+                    + ' to every patient in the batch', bulkPrograms.every(function (p) { return p.length === 1 && p[0].name === BULK_PROGRAM_1; }), "programs=".concat(JSON.stringify(bulkPrograms), " (needs a worker running to drain delayed_events)"));
+                return [3 /*break*/, 85];
+            case 80:
+                if (!tenant) return [3 /*break*/, 84];
+                _v.label = 81;
+            case 81:
+                _v.trys.push([81, 83, , 84]);
+                return [4 /*yield*/, tenant.teardown()];
+            case 82:
+                _v.sent();
+                return [3 /*break*/, 84];
+            case 83:
+                e_1 = _v.sent();
                 console.error('teardown failed', e_1);
-                return [3 /*break*/, 33];
-            case 33: return [7 /*endfinally*/];
-            case 34: return [2 /*return*/, checks];
+                return [3 /*break*/, 84];
+            case 84: return [7 /*endfinally*/];
+            case 85: return [2 /*return*/, checks];
         }
     });
 }); };
@@ -349,6 +770,8 @@ export var programs_tests = function () { return __awaiter(void 0, void 0, void
         }
     });
 }); };
+/** Enrolls this suite in the auto-discovered parallel pool — see run_discovered_isolated_suites. */
+export var ISOLATED_SUITE = { name: 'Programs', run: programs_checks };
 // Allow running this test file independently
 if (require.main === module) {
     console.log("\uD83C\uDF10 Using API URL: ".concat(host));