@d19n/youfibre-odin-sdk 2.0.340 → 2.0.341

package/dist/actions-v2/SendTlosNinjaCaseEmailDto.d.ts

@@ -23,7 +23,7 @@ export interface SendTlosNinjaCaseEmailMessage extends OdinRecordCreatedEvent<Se
  * Properties for SendTlosNinjaCaseEmail action
  *
  * @property Required fields: 1
- * @property Optional fields: 7
+ * @property Optional fields: 9
  */
 export interface SendTlosNinjaCaseEmailProperties {
     /**
@@ -85,6 +85,20 @@ export interface SendTlosNinjaCaseEmailProperties {
      * @type {TEXT}
      */
     MessageId?: string | null;
+    /**
+     * Title
+     *
+     * Used for title
+     * @type {TEXT}
+     */
+    Title?: string | null;
+    /**
+     * Subject
+     *
+     * Data field for Email records. Used by Communications team.
+     * @type {TEXT}
+     */
+    Subject?: string | null;
 }
 /**
  * SendTlosNinjaCaseEmail

package/dist/entities-v2/Case.d.ts

@@ -355,9 +355,11 @@ export declare enum CaseProblem {
  * - `TLOS_APP` - TLOS App
  * - `TLOS_PORTAL` - TLOS Portal
  * - `TRUSTPILOT_SERVICE_REVIEW` - Trustpilot review
+ * - `TWITTER_X_DM` - Twitter/X DM
+ * - `TWITTER_X_MENTION` - Twitter/X Mention
  * - `WEB_CHAT` - Web chat
  * - `WEB_FORM_BUSINESS` - Web form - Business
- * - `WHATSAPP` - Whatsapp
+ * - ... and 1 more
  */
 export declare enum CaseChannel {
     CALL = "CALL",
@@ -371,6 +373,8 @@ export declare enum CaseChannel {
     TLOS_APP = "TLOS_APP",
     TLOS_PORTAL = "TLOS_PORTAL",
     TRUSTPILOT_REVIEW = "TRUSTPILOT_SERVICE_REVIEW",
+    TWITTER_X_DM = "TWITTER_X_DM",
+    TWITTER_X_MENTION = "TWITTER_X_MENTION",
     WEB_CHAT = "WEB_CHAT",
     WEB_FORM_BUSINESS = "WEB_FORM_BUSINESS",
     WHATSAPP = "WHATSAPP"

package/dist/entities-v2/Case.js

@@ -347,9 +347,11 @@ var CaseProblem;
  * - `TLOS_APP` - TLOS App
  * - `TLOS_PORTAL` - TLOS Portal
  * - `TRUSTPILOT_SERVICE_REVIEW` - Trustpilot review
+ * - `TWITTER_X_DM` - Twitter/X DM
+ * - `TWITTER_X_MENTION` - Twitter/X Mention
  * - `WEB_CHAT` - Web chat
  * - `WEB_FORM_BUSINESS` - Web form - Business
- * - `WHATSAPP` - Whatsapp
+ * - ... and 1 more
  */
 var CaseChannel;
 (function (CaseChannel) {
@@ -364,6 +366,8 @@ var CaseChannel;
     CaseChannel["TLOS_APP"] = "TLOS_APP";
     CaseChannel["TLOS_PORTAL"] = "TLOS_PORTAL";
     CaseChannel["TRUSTPILOT_REVIEW"] = "TRUSTPILOT_SERVICE_REVIEW";
+    CaseChannel["TWITTER_X_DM"] = "TWITTER_X_DM";
+    CaseChannel["TWITTER_X_MENTION"] = "TWITTER_X_MENTION";
     CaseChannel["WEB_CHAT"] = "WEB_CHAT";
     CaseChannel["WEB_FORM_BUSINESS"] = "WEB_FORM_BUSINESS";
     CaseChannel["WHATSAPP"] = "WHATSAPP";

package/dist/process-model/order-process.projection.js

@@ -130,6 +130,29 @@ exports.ORDER_PROCESS_PROJECTION = {
                 {
                     kind: 'related-record',
                     id: 'supply-must-have-active-progressing-install',
+                    /**
+                     * NOT START ORDERS. A START order takes over a line that is already
+                     * provisioned, so no engineer attends: the supplier cancels its INSTALL
+                     * and says so with
+                     * `NETOMNIA_INSTALL_WORK_ORDER_CANCELLED_ENGINEER_NOT_REQUIRED`. A
+                     * Cancelled INSTALL is therefore the normal, correct state for these
+                     * orders — they activate on the COMPLETED-OrderKci gate instead.
+                     *
+                     * Without this scope the dep fires BLOCKER on every healthy START order
+                     * and the Cancelled-INSTALL clause below prescribes `cancel-parent`,
+                     * which would deny a customer a service that is physically ready.
+                     * Measured in production 2026-09-16: 98 of the 122 orders off-track on
+                     * this dep were START, 58 of them with a COMPLETED confirmation.
+                     *
+                     * `notEq` is plain `!==` in the engine, so a NULL SupplierOrderType —
+                     * the ordinary NEW-provide case — still matches and stays in scope.
+                     *
+                     * Ported from the BP, which has declared this since 2026-08-13:
+                     * agent-os/knowledge/business-processes/order.ts:740
+                     */
+                    parentFilter: [
+                        { column: 'SupplierOrderType', op: 'notEq', value: 'START' },
+                    ],
                     relation: {
                         entity: 'FieldServiceModule:WorkOrder',
                         filter: [

package/dist/process-model/order-process.projection.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/process-model/order-process.projection.spec.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * ORDER projection — scope of `supply-must-have-active-progressing-install`.
+ *
+ * A START order takes over a line that is already provisioned, so no engineer
+ * attends: the supplier cancels its INSTALL and says so with
+ * `NETOMNIA_INSTALL_WORK_ORDER_CANCELLED_ENGINEER_NOT_REQUIRED`. A Cancelled
+ * INSTALL is therefore the normal, correct state for these orders — they
+ * activate on the COMPLETED-OrderKci gate instead.
+ *
+ * The BP has excluded START from this rule since 2026-08-13
+ * (agent-os/knowledge/business-processes/order.ts:740). The projection is a
+ * hand-maintained copy and never received it, so the engine kept scoring healthy
+ * START orders BLOCKER and prescribing `cancel-parent` — which would deny a
+ * customer a service that is physically ready. Production 2026-09-16: 98 of the
+ * 122 orders off-track on this dep were START, 58 with a COMPLETED confirmation.
+ *
+ * These tests pin the scope so the drift cannot return silently.
+ *
+ * Run: npm run test:process-model
+ */
+const order_process_projection_1 = require("./order-process.projection");
+const process_validator_1 = require("./process-validator");
+const DEP_ID = 'supply-must-have-active-progressing-install';
+const WO_ENTITY = 'FieldServiceModule:WorkOrder';
+let passed = 0;
+let failed = 0;
+const failures = [];
+function assert(label, cond, hint) {
+    if (cond) {
+        passed += 1;
+        console.log(`  PASS  ${label}`);
+    }
+    else {
+        failed += 1;
+        const msg = `  FAIL  ${label}${hint ? ' — ' + hint : ''}`;
+        failures.push(msg);
+        console.log(msg);
+    }
+}
+/** A Supply order, optionally carrying a SupplierOrderType discriminator. */
+function supplyOrder(supplierOrderType) {
+    return {
+        id: 'ord-1',
+        recordNumber: 'OR0000001',
+        stage: { key: 'OrderStageSupply', name: 'Supply' },
+        createdAt: new Date(Date.now() - 3 * 86400000).toISOString(),
+        properties: supplierOrderType === undefined
+            ? { Provider: 'NETOMNIA' }
+            : { Provider: 'NETOMNIA', SupplierOrderType: supplierOrderType },
+    };
+}
+const CANCELLED_INSTALL = {
+    id: 'wo-1',
+    recordNumber: 'WO-1',
+    type: 'INSTALL',
+    stage: { key: 'WorkOrderStageCancelled', name: 'Cancelled' },
+};
+const SCHEDULED_INSTALL = {
+    id: 'wo-2',
+    recordNumber: 'WO-2',
+    type: 'INSTALL',
+    stage: { key: 'WorkOrderStageScheduled', name: 'Scheduled' },
+};
+function score(order, workOrders) {
+    return (0, process_validator_1.validateAgainstProcess)({
+        record: order,
+        process: order_process_projection_1.ORDER_PROCESS_PROJECTION,
+        relations: { [WO_ENTITY]: workOrders },
+    });
+}
+function verdictFor(report, depId) {
+    return report.verdicts.find((v) => v.depId === depId);
+}
+function run() {
+    var _a, _b, _c, _d, _e;
+    console.log(`\n${DEP_ID} — START orders are out of scope\n`);
+    {
+        const v = verdictFor(score(supplyOrder('START'), [CANCELLED_INSTALL]), DEP_ID);
+        assert('START + Cancelled INSTALL scores correct (parentFilter excludes it)', (v === null || v === void 0 ? void 0 : v.status) === 'correct', `got ${v === null || v === void 0 ? void 0 : v.status} / ${(_b = (_a = v === null || v === void 0 ? void 0 : v.prescribedAction) === null || _a === void 0 ? void 0 : _a.kind) !== null && _b !== void 0 ? _b : 'no action'}`);
+    }
+    {
+        const v = verdictFor(score(supplyOrder('NEW'), [CANCELLED_INSTALL]), DEP_ID);
+        assert('NEW + Cancelled INSTALL still scores variance', (v === null || v === void 0 ? void 0 : v.status) === 'variance', `got ${v === null || v === void 0 ? void 0 : v.status}`);
+        assert('NEW + Cancelled INSTALL still prescribes cancel-parent', ((_c = v === null || v === void 0 ? void 0 : v.prescribedAction) === null || _c === void 0 ? void 0 : _c.kind) === 'cancel-parent', `got ${(_d = v === null || v === void 0 ? void 0 : v.prescribedAction) === null || _d === void 0 ? void 0 : _d.kind}`);
+    }
+    {
+        // `notEq` is plain `!==`, so the ordinary NEW-provide case (no discriminator
+        // written) must stay fully in scope. This is the rule's blast radius.
+        const v = verdictFor(score(supplyOrder(undefined), [CANCELLED_INSTALL]), DEP_ID);
+        assert('absent SupplierOrderType stays in scope (variance)', (v === null || v === void 0 ? void 0 : v.status) === 'variance', `got ${v === null || v === void 0 ? void 0 : v.status}`);
+    }
+    {
+        const v = verdictFor(score(supplyOrder('START'), [SCHEDULED_INSTALL]), DEP_ID);
+        assert('START + Scheduled INSTALL scores correct', (v === null || v === void 0 ? void 0 : v.status) === 'correct', `got ${v === null || v === void 0 ? void 0 : v.status}`);
+    }
+    {
+        const v = verdictFor(score(supplyOrder('NEW'), [SCHEDULED_INSTALL]), DEP_ID);
+        assert('NEW + Scheduled INSTALL scores correct', (v === null || v === void 0 ? void 0 : v.status) === 'correct', `got ${v === null || v === void 0 ? void 0 : v.status}`);
+    }
+    {
+        // The projection must carry the BP's filter verbatim, not merely behave
+        // correctly for the cases above.
+        const supply = order_process_projection_1.ORDER_PROCESS_PROJECTION.stages.find((s) => s.key === 'OrderStageSupply');
+        const dep = (_e = supply === null || supply === void 0 ? void 0 : supply.dependencies) === null || _e === void 0 ? void 0 : _e.find((d) => d.id === DEP_ID);
+        const pf = dep && 'parentFilter' in dep ? dep.parentFilter : undefined;
+        assert('dep declares parentFilter SupplierOrderType notEq START', (pf === null || pf === void 0 ? void 0 : pf.length) === 1 &&
+            pf[0].column === 'SupplierOrderType' &&
+            pf[0].op === 'notEq' &&
+            pf[0].value === 'START', `got ${JSON.stringify(pf)}`);
+    }
+    console.log('\n────────────────────────────────────────');
+    console.log(`Tests: ${passed} passed, ${failed} failed`);
+    if (failed > 0) {
+        console.log('');
+        failures.forEach((f) => console.log(f));
+        process.exit(1);
+    }
+}
+run();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.340",
+  "version": "2.0.341",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",
@@ -42,12 +42,17 @@
     "ts-node": "^10.9.2",
     "typescript": "4.8.4"
   },
+  "overrides": {
+    "uuid": "^11.1.1",
+    "diff": "^4.0.4"
+  },
   "dependencies": {
     "@d19n/odin-sdk-generator": "^3.0.244",
     "@d19n/odin-types": "^3.6.8"
   },
   "scripts": {
     "test:wholesale-provider": "npx --yes tsx src/wholesale-provider/test/netomnia-provider.spec.ts && npx --yes tsx src/wholesale-provider/test/kci-effect-bridge.spec.ts",
+    "test:process-model": "npx --yes tsx src/process-model/order-process.projection.spec.ts",
     "release:beta": "echo Local publish disabled. Use GitHub Actions workflow_dispatch on .github/workflows/release.yml with target=beta && exit 1",
     "release:prod": "echo Local publish disabled. Use GitHub Actions workflow_dispatch on .github/workflows/release.yml with target=prod && exit 1"
   },