@artu-ai/compliance-sdk 0.13.3 → 0.14.0

package/dist/models/Alert.js

@@ -4,7 +4,7 @@
  * Pure data model with no API calls.
  * Provides type-safe access to common alert properties.
  */
-import { ReportStatus } from "@artu-ai/shared";
+import { AlertStatus } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 // ===========================
 // Alert Model
@@ -13,13 +13,12 @@ import { BaseModel } from "./base";
  * Base Alert Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models (MexAlert, etc.).
+ * Extended by scope-specific models (MexAlert, etc.).
  *
  * @example
  * ```typescript
  * const alert = await sdk.alerts.retrieve("alert_123");
- * console.log(alert.type);
- * console.log(alert.reportStatus);
+ * console.log(alert.status);
  * ```
  */
 export class Alert extends BaseModel {
@@ -48,10 +47,10 @@ export class Alert extends BaseModel {
     // Status
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Alert status
+     * Alert lifecycle status
      */
-    get reportStatus() {
-        return this._data.reportStatus;
+    get status() {
+        return this._data.status;
     }
     /**
      * Number of items in the alert
@@ -60,47 +59,115 @@ export class Alert extends BaseModel {
         return this._data.itemCount;
     }
     /**
-     * Whether the alert is in draft status
+     * Whether the alert is in the initial `new` state (just created, untouched by analyst)
      */
-    get isDraft() {
-        return this._data.reportStatus === ReportStatus.Draft;
+    get isNew() {
+        return this._data.status === AlertStatus.New;
     }
     /**
-     * Whether the alert has been validated successfully
+     * Whether an analyst has opened / claimed the alert
      */
-    get isValid() {
-        return this._data.reportStatus === ReportStatus.Valid;
+    get isInReview() {
+        return this._data.status === AlertStatus.InReview;
     }
     /**
-     * Whether the alert failed validation
+     * Whether the alert is in the reporting lane with no validation result yet
      */
-    get isInvalid() {
-        return this._data.reportStatus === ReportStatus.Invalid;
+    get isReportDraft() {
+        return this._data.status === AlertStatus.ReportDraft;
     }
     /**
-     * Whether the alert can be edited
+     * Whether the alert is currently being validated (transient)
+     */
+    get isReportValidating() {
+        return this._data.status === AlertStatus.ReportValidating;
+    }
+    /**
+     * Whether the latest generated report passed validation
+     */
+    get isReportValid() {
+        return this._data.status === AlertStatus.ReportValid;
+    }
+    /**
+     * Whether the latest generated report failed validation
+     */
+    get isReportInvalid() {
+        return this._data.status === AlertStatus.ReportInvalid;
+    }
+    /**
+     * Whether the alert has been filed (terminal state)
+     */
+    get isFiled() {
+        return this._data.status === AlertStatus.Filed;
+    }
+    /**
+     * Whether the alert has been resolved without filing (terminal state)
+     */
+    get isResolved() {
+        return this._data.status === AlertStatus.Resolved;
+    }
+    /**
+     * Whether the alert has been dismissed (terminal state)
+     */
+    get isDismissed() {
+        return this._data.status === AlertStatus.Dismissed;
+    }
+    /**
+     * Whether the alert is in a terminal state (Filed, Resolved, or Dismissed)
+     */
+    get isTerminal() {
+        const s = this._data.status;
+        return (s === AlertStatus.Filed ||
+            s === AlertStatus.Resolved ||
+            s === AlertStatus.Dismissed);
+    }
+    /**
+     * Whether the alert can be edited.
+     * Editable states: New, InReview, ReportDraft, ReportInvalid, ReportValid.
      */
     get canEdit() {
-        const s = this._data.reportStatus;
-        return (s === ReportStatus.Draft ||
-            s === ReportStatus.Valid ||
-            s === ReportStatus.Invalid);
+        const s = this._data.status;
+        return (s === AlertStatus.New ||
+            s === AlertStatus.InReview ||
+            s === AlertStatus.ReportDraft ||
+            s === AlertStatus.ReportInvalid ||
+            s === AlertStatus.ReportValid);
     }
     /**
-     * Whether the alert can be validated/generated
+     * Whether the alert can be validated/generated.
+     * True for: New, InReview, ReportDraft, ReportInvalid, ReportValid.
      */
     get canGenerate() {
-        const s = this._data.reportStatus;
-        return s === ReportStatus.Draft || s === ReportStatus.Valid;
+        const s = this._data.status;
+        return (s === AlertStatus.New ||
+            s === AlertStatus.InReview ||
+            s === AlertStatus.ReportDraft ||
+            s === AlertStatus.ReportInvalid ||
+            s === AlertStatus.ReportValid);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Filing Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * ISO datetime when the alert was filed, or null if not filed
+     */
+    get filedAt() {
+        return this._data.filedAt ?? null;
+    }
+    /**
+     * ID of the report that was filed, or null if not filed
+     */
+    get filedReportId() {
+        return this._data.filedReportId ?? null;
     }
     // ─────────────────────────────────────────────────────────────────
-    // Scopes & Jurisdiction
+    // Scopes
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Scopes this alert belongs to
+     * Scope this alert belongs to
      */
-    get scopes() {
-        return this._data.scopes ?? [];
+    get scope() {
+        return this._data.scope ?? "base";
     }
     /**
      * Tags applied to this alert.
@@ -109,10 +176,10 @@ export class Alert extends BaseModel {
         return this._data.tags ?? [];
     }
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions() {
-        return this._data.jurisdictions ?? {};
+    get scopeData() {
+        return this._data.scopeData ?? {};
     }
     // ─────────────────────────────────────────────────────────────────
     // Metadata
@@ -142,10 +209,10 @@ export class Alert extends BaseModel {
         return this._data.metadata;
     }
     /**
-     * ID of the rule that created this alert, if any
+     * ID of the workflow that created this alert, if any
      */
-    get createdByRuleId() {
-        return this._data.createdByRuleId;
+    get createdByWorkflowId() {
+        return this._data.createdByWorkflowId;
     }
     // ─────────────────────────────────────────────────────────────────
     // Timestamps
@@ -167,7 +234,7 @@ export class Alert extends BaseModel {
     // ─────────────────────────────────────────────────────────────────
     toString() {
         const label = this.name ?? this.id;
-        return `Alert(${label}, ${this.reportStatus})`;
+        return `Alert(${label}, ${this.status})`;
     }
 }
 // ===========================

package/dist/models/AlertClientItem.d.ts

@@ -12,9 +12,10 @@ import { Client, type ClientData } from "./Client";
 export type AlertClientItemData = ClientData & {
     alertItemId?: string;
     alertItemValidationErrors?: AlertItemValidationError[];
-    alertItemJurisdictions?: Record<string, unknown>;
+    alertItemScopeData?: Record<string, unknown>;
     alertItemMetadata?: Record<string, unknown>;
     alertItemCreatedAt?: string;
+    linkedTransactionId?: string;
 };
 /**
  * Alert Client Item Model.
@@ -48,9 +49,9 @@ export declare class AlertClientItem extends Client {
      */
     get hasWarnings(): boolean;
     /**
-     * Alert item jurisdiction data
+     * Alert item scope data
      */
-    get alertItemJurisdictions(): Record<string, unknown> | undefined;
+    get alertItemScopeData(): Record<string, unknown> | undefined;
     /**
      * Alert item metadata
      */
@@ -59,6 +60,11 @@ export declare class AlertClientItem extends Client {
      * When this client was added to the alert
      */
     get alertItemCreatedAt(): Date | undefined;
+    /**
+     * The transaction ID that links this client to the alert (for indirect clients).
+     * Undefined for directly-linked clients.
+     */
+    get linkedTransactionId(): string | undefined;
     toString(): string;
 }
 export declare function isAlertClientItem(value: unknown): value is AlertClientItem;

package/dist/models/AlertClientItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AlertClientItem.d.ts","sourceRoot":"","sources":["../../src/models/AlertClientItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IAC1C,UAAkB,KAAK,EAAE,mBAAmB,CAAC;IAE7C;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,yBAAyB,IAAI,wBAAwB,EAAE,CAE1D;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEhE;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE3D;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,IAAI,GAAG,SAAS,CAIzC;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}
+{"version":3,"file":"AlertClientItem.d.ts","sourceRoot":"","sources":["../../src/models/AlertClientItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,MAAM;IAC1C,UAAkB,KAAK,EAAE,mBAAmB,CAAC;IAE7C;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,yBAAyB,IAAI,wBAAwB,EAAE,CAE1D;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE5D;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE3D;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,IAAI,GAAG,SAAS,CAIzC;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAE5C;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E"}

package/dist/models/AlertClientItem.js

@@ -46,10 +46,10 @@ export class AlertClientItem extends Client {
         return this.alertItemValidationErrors.some((e) => e.severity === "warning");
     }
     /**
-     * Alert item jurisdiction data
+     * Alert item scope data
      */
-    get alertItemJurisdictions() {
-        return this._data.alertItemJurisdictions;
+    get alertItemScopeData() {
+        return this._data.alertItemScopeData;
     }
     /**
      * Alert item metadata
@@ -65,6 +65,13 @@ export class AlertClientItem extends Client {
             ? new Date(this._data.alertItemCreatedAt)
             : undefined;
     }
+    /**
+     * The transaction ID that links this client to the alert (for indirect clients).
+     * Undefined for directly-linked clients.
+     */
+    get linkedTransactionId() {
+        return this._data.linkedTransactionId;
+    }
     toString() {
         return `AlertClientItem(${this.id}, ${this.name}, alertItem=${this.alertItemId ?? "indirect"})`;
     }

package/dist/models/AlertItem.d.ts

@@ -4,7 +4,7 @@
  * Pure data model with no API calls.
  * Provides type-safe access to common alert item properties.
  */
-import type { AlertItem as AlertItemSchema, AlertItemValidationError, BaseAlertItem } from "@artu-ai/shared";
+import type { AlertItem as AlertItemSchema, AlertItemValidationError, BaseAlertItem, Scope } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 /**
  * Alert item data as returned from the API.
@@ -14,7 +14,7 @@ export type AlertItemData = AlertItemSchema;
  * Base Alert Item Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models.
+ * Extended by scope-specific models.
  *
  * @example
  * ```typescript
@@ -86,9 +86,13 @@ export declare class AlertItem extends BaseModel<AlertItemData> {
      */
     get warningCount(): number;
     /**
-     * Raw jurisdiction data object
+     * The scope this alert item belongs to (e.g., "MX:AV:MJR")
      */
-    get jurisdictions(): BaseAlertItem["jurisdictions"];
+    get scope(): Scope;
+    /**
+     * Raw scope data object
+     */
+    get scopeData(): BaseAlertItem["scopeData"];
     /**
      * When the item was created
      */

package/dist/models/AlertItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AlertItem.d.ts","sourceRoot":"","sources":["../../src/models/AlertItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,SAAS,IAAI,eAAe,EAC5B,wBAAwB,EACxB,aAAa,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAM5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAU,SAAQ,SAAS,CAAC,aAAa,CAAC;IAKtD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAMD;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAMD;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,EAAE,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAE5C;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAMD;;OAEG;IACH,IAAI,gBAAgB,IAAI,wBAAwB,EAAE,CAEjD;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAMD;;OAEG;IACH,IAAI,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC,CAElD;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMQ,QAAQ,IAAI,MAAM;CAG3B;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}
+{"version":3,"file":"AlertItem.d.ts","sourceRoot":"","sources":["../../src/models/AlertItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,SAAS,IAAI,eAAe,EAC5B,wBAAwB,EACxB,aAAa,EACb,KAAK,EACL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAM5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAU,SAAQ,SAAS,CAAC,aAAa,CAAC;IAKtD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAMD;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAMD;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,EAAE,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAE5C;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAMD;;OAEG;IACH,IAAI,gBAAgB,IAAI,wBAAwB,EAAE,CAEjD;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAMD;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,aAAa,CAAC,WAAW,CAAC,CAE1C;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMQ,QAAQ,IAAI,MAAM;CAG3B;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}

package/dist/models/AlertItem.js

@@ -12,7 +12,7 @@ import { BaseModel } from "./base";
  * Base Alert Item Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models.
+ * Extended by scope-specific models.
  *
  * @example
  * ```typescript
@@ -126,13 +126,19 @@ export class AlertItem extends BaseModel {
         return this.validationErrors.filter((e) => e.severity === "warning").length;
     }
     // ─────────────────────────────────────────────────────────────────
-    // Jurisdiction
+    // Scope
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Raw jurisdiction data object
+     * The scope this alert item belongs to (e.g., "MX:AV:MJR")
      */
-    get jurisdictions() {
-        return this._data.jurisdictions ?? {};
+    get scope() {
+        return this._data.scope;
+    }
+    /**
+     * Raw scope data object
+     */
+    get scopeData() {
+        return this._data.scopeData ?? {};
     }
     // ─────────────────────────────────────────────────────────────────
     // Timestamps

package/dist/models/AlertTransactionItem.d.ts

@@ -12,7 +12,7 @@ import { Transaction, type TransactionData } from "./Transaction";
 export interface AlertTransactionItemData extends TransactionData {
     alertItemId: string;
     alertItemValidationErrors?: AlertItemValidationError[];
-    alertItemJurisdictions?: Record<string, unknown>;
+    alertItemScopeData?: Record<string, unknown>;
     alertItemMetadata?: Record<string, unknown>;
     alertItemCreatedAt?: string;
 }
@@ -20,7 +20,7 @@ export interface AlertTransactionItemData extends TransactionData {
  * Alert Transaction Item Model.
  *
  * Extends Transaction with alert-item-specific fields like validation errors,
- * jurisdiction data, and the alert item ID (needed for remove operations).
+ * scope data, and the alert item ID (needed for remove operations).
  */
 export declare class AlertTransactionItem extends Transaction {
     protected _data: AlertTransactionItemData;
@@ -42,9 +42,9 @@ export declare class AlertTransactionItem extends Transaction {
      */
     get hasWarnings(): boolean;
     /**
-     * Alert item jurisdiction data
+     * Alert item scope data
      */
-    get alertItemJurisdictions(): Record<string, unknown> | undefined;
+    get alertItemScopeData(): Record<string, unknown> | undefined;
     /**
      * Alert item metadata
      */

package/dist/models/AlertTransactionItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AlertTransactionItem.d.ts","sourceRoot":"","sources":["../../src/models/AlertTransactionItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IACpD,UAAkB,KAAK,EAAE,wBAAwB,CAAC;IAElD;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,yBAAyB,IAAI,wBAAwB,EAAE,CAE1D;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEhE;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE3D;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,IAAI,GAAG,SAAS,CAIzC;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,oBAAoB,CAE/B"}
+{"version":3,"file":"AlertTransactionItem.d.ts","sourceRoot":"","sources":["../../src/models/AlertTransactionItem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;IACpD,UAAkB,KAAK,EAAE,wBAAwB,CAAC;IAElD;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,yBAAyB,IAAI,wBAAwB,EAAE,CAE1D;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE5D;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE3D;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,IAAI,GAAG,SAAS,CAIzC;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,oBAAoB,CAE/B"}

package/dist/models/AlertTransactionItem.js

@@ -9,7 +9,7 @@ import { Transaction } from "./Transaction";
  * Alert Transaction Item Model.
  *
  * Extends Transaction with alert-item-specific fields like validation errors,
- * jurisdiction data, and the alert item ID (needed for remove operations).
+ * scope data, and the alert item ID (needed for remove operations).
  */
 export class AlertTransactionItem extends Transaction {
     /**
@@ -38,10 +38,10 @@ export class AlertTransactionItem extends Transaction {
         return this.alertItemValidationErrors.some((e) => e.severity === "warning");
     }
     /**
-     * Alert item jurisdiction data
+     * Alert item scope data
      */
-    get alertItemJurisdictions() {
-        return this._data.alertItemJurisdictions;
+    get alertItemScopeData() {
+        return this._data.alertItemScopeData;
     }
     /**
      * Alert item metadata

package/dist/models/Client.d.ts

@@ -4,7 +4,7 @@
  * Pure data model with no API calls.
  * Provides type-safe access to common client properties.
  */
-import type { AddressResponse, BankAccountResponse, BaseClient, ClientRelationshipType, ContactMethodResponse, DocumentResponse, EmbeddedTag, Employment, Jurisdiction, LinkedClientResponse, RiskAssessmentSnapshot, RiskAssessments } from "@artu-ai/shared";
+import type { AddressResponse, BankAccountResponse, BaseClient, ClientRelationshipType, ContactMethodResponse, DocumentResponse, EmbeddedTag, Employment, LinkedClientResponse, RiskAssessmentSnapshot, RiskAssessments, Scope } from "@artu-ai/shared";
 import { ClientType } from "@artu-ai/shared";
 import { Address } from "./Address";
 import { BankAccount } from "./BankAccount";
@@ -17,6 +17,7 @@ export type ClientData = BaseClient & {
     updatedAt: string;
     email?: string | null;
     phone?: string | null;
+    age?: number | null;
     addresses?: AddressResponse[];
     contactMethods?: ContactMethodResponse[];
     bankAccounts?: BankAccountResponse[];
@@ -29,7 +30,7 @@ export type ClientData = BaseClient & {
  * Base Client Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models (MexClient, etc.).
+ * Extended by scope-specific models (MexClient, etc.).
  *
  * @example
  * ```typescript
@@ -116,13 +117,13 @@ export declare class Client extends BaseModel<ClientData> {
      */
     get tags(): EmbeddedTag[];
     /**
-     * Checks if client has data for a specific jurisdiction
+     * Checks if client has data for a specific scope
      */
-    hasJurisdiction(jurisdiction: Jurisdiction): boolean;
+    hasScope(scope: Scope): boolean;
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions(): BaseClient["jurisdictions"];
+    get scopeData(): BaseClient["scopeData"];
     /**
      * External ID for integration with other systems
      */
@@ -139,6 +140,12 @@ export declare class Client extends BaseModel<ClientData> {
      * Primary phone (if included)
      */
     get phone(): string | null | undefined;
+    /**
+     * Computed age in whole years, derived from the type-appropriate date
+     * (birthDate for individuals, incorporationDate for companies,
+     * formationDate for trusts). Null when the source date is missing.
+     */
+    get age(): number | null | undefined;
     /**
      * Addresses (if included)
      */
@@ -211,7 +218,9 @@ export declare class Client extends BaseModel<ClientData> {
      */
     riskAssessmentDisplayScore(): {
         score: number;
+        minScore: number;
         maxScore: number;
+        label?: string;
     } | undefined;
     /** Find the most recently calculated snapshot across all assessments */
     private _latestRiskSnapshot;

package/dist/models/Client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/models/Client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/models/Client.ts"],"names":[],"mappings":"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"}

package/dist/models/Client.js

@@ -13,15 +13,16 @@ import { Document } from "./Document";
 // ===========================
 // Utilities
 // ===========================
-function applyRiskRounding(value, mode) {
+function applyRiskRounding(value, mode, decimalPlaces = 0) {
+    const factor = Math.pow(10, decimalPlaces);
     switch (mode) {
         case "floor":
-            return Math.floor(value);
+            return Math.floor(value * factor) / factor;
         case "round":
-            return Math.round(value);
+            return Math.round(value * factor) / factor;
         case "ceil":
         default:
-            return Math.ceil(value);
+            return Math.ceil(value * factor) / factor;
     }
 }
 /**
@@ -46,7 +47,7 @@ function parseDateString(value) {
  * Base Client Model.
  *
  * Pure data model with no API calls.
- * Extended by jurisdiction-specific models (MexClient, etc.).
+ * Extended by scope-specific models (MexClient, etc.).
  *
  * @example
  * ```typescript
@@ -184,7 +185,7 @@ export class Client extends BaseModel {
         return raw ? parseDateString(raw) : undefined;
     }
     // ─────────────────────────────────────────────────────────────────
-    // Jurisdiction
+    // Scope
     // ─────────────────────────────────────────────────────────────────
     /**
      * Scopes this client belongs to (e.g. ["MX", "MX:AV:AVI"]).
@@ -199,18 +200,18 @@ export class Client extends BaseModel {
         return this._data.tags ?? [];
     }
     /**
-     * Checks if client has data for a specific jurisdiction
+     * Checks if client has data for a specific scope
      */
-    hasJurisdiction(jurisdiction) {
-        if (!this._data.jurisdictions)
+    hasScope(scope) {
+        if (!this._data.scopeData)
             return false;
-        return jurisdiction in this._data.jurisdictions;
+        return scope in this._data.scopeData;
     }
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions() {
-        return this._data.jurisdictions ?? {};
+    get scopeData() {
+        return this._data.scopeData ?? {};
     }
     // ─────────────────────────────────────────────────────────────────
     // Metadata
@@ -239,6 +240,14 @@ export class Client extends BaseModel {
     get phone() {
         return this._data.phone;
     }
+    /**
+     * Computed age in whole years, derived from the type-appropriate date
+     * (birthDate for individuals, incorporationDate for companies,
+     * formationDate for trusts). Null when the source date is missing.
+     */
+    get age() {
+        return this._data.age;
+    }
     /**
      * Addresses (if included)
      */
@@ -346,12 +355,24 @@ export class Client extends BaseModel {
         const snapshot = this._latestRiskSnapshot();
         if (!snapshot)
             return undefined;
+        const minScore = snapshot.minScore ?? 0;
         const maxScore = snapshot.maxScore ?? 100;
         const mode = snapshot.roundingMode ?? "ceil";
-        return {
-            score: applyRiskRounding(snapshot.overall * maxScore, mode),
-            maxScore,
-        };
+        const dp = snapshot.decimalPlaces ?? 0;
+        const score = applyRiskRounding(minScore + snapshot.overall * (maxScore - minScore), mode, dp);
+        let label;
+        if (snapshot.riskLevels && snapshot.riskLevels.length > 0) {
+            const sorted = [...snapshot.riskLevels].sort((a, b) => a.maxValue - b.maxValue);
+            for (const level of sorted) {
+                if (score <= level.maxValue) {
+                    label = level.label;
+                    break;
+                }
+            }
+            if (!label)
+                label = sorted[sorted.length - 1]?.label;
+        }
+        return { score, minScore, maxScore, label };
     }
     /** Find the most recently calculated snapshot across all assessments */
     _latestRiskSnapshot() {