@artu-ai/compliance-sdk 0.13.4 → 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,41 +59,109 @@ 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
     // ─────────────────────────────────────────────────────────────────
     /**
      * Scope this alert belongs to
@@ -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
@@ -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,7 +12,7 @@ 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;
@@ -49,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
      */

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;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,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;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"}
+{"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

package/dist/models/AlertItem.d.ts

@@ -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
@@ -90,9 +90,9 @@ export declare class AlertItem extends BaseModel<AlertItemData> {
      */
     get scope(): Scope;
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions(): BaseAlertItem["jurisdictions"];
+    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,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,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,7 +126,7 @@ export class AlertItem extends BaseModel {
         return this.validationErrors.filter((e) => e.severity === "warning").length;
     }
     // ─────────────────────────────────────────────────────────────────
-    // Scope & Jurisdiction
+    // Scope
     // ─────────────────────────────────────────────────────────────────
     /**
      * The scope this alert item belongs to (e.g., "MX:AV:MJR")
@@ -135,10 +135,10 @@ export class AlertItem extends BaseModel {
         return this._data.scope;
     }
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions() {
-        return this._data.jurisdictions ?? {};
+    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";
@@ -30,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
@@ -117,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
      */

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

@@ -1 +1 @@
-{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/models/Client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA2CtC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAErC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzC,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACvC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;CACrB,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,qBAAa,MAAO,SAAQ,SAAS,CAAC,UAAU,CAAC;IAKhD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,UAAU,CAErB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,WAAW,IAAI,MAAM,CAYxB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,EAAE,CAE5B;IAMD;;;OAGG;IACH,IAAI,SAAS,IAAI,IAAI,GAAG,SAAS,CAMhC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAInC;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,GAAG,SAAS,CAInC;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAIvC;IAMD;;;OAGG;IACH,IAAI,iBAAiB,IAAI,IAAI,GAAG,SAAS,CAKxC;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAIvC;IAMD;;;OAGG;IACH,IAAI,aAAa,IAAI,IAAI,GAAG,SAAS,CAKpC;IAMD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,EAAE,CAExB;IAED;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO;IAKpD;;OAEG;IACH,IAAI,aAAa,IAAI,UAAU,CAAC,eAAe,CAAC,CAE/C;IAMD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAErC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAErC;IAED;;;;OAIG;IACH,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,EAAE,GAAG,SAAS,CAErC;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,aAAa,EAAE,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,WAAW,EAAE,GAAG,SAAS,CAE5C;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,EAAE,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,aAAa,IACd;QACA,gBAAgB,EAAE,sBAAsB,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC;KACd,EAAE,GACH,SAAS,CAKX;IAMD;;;OAGG;IACH,IAAI,eAAe,IAAI,eAAe,CAErC;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,EAAE,CAElC;IAED;;;;;;;;OAQG;IACH,cAAc,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACd,sBAAsB,GAAG,SAAS;IAOrC;;;;;OAKG;IACH,sBAAsB,CACrB,IAAI,EAAE,MAAM,GACV;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE;IAS9C;;;;;;;;;OASG;IACH,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAOtD;;;;;;OAMG;IACH,0BAA0B,IACvB;QACA,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KACd,GACD,SAAS;IA4BZ,wEAAwE;IACxE,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMQ,QAAQ,IAAI,MAAM;CAG3B;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/C"}
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/models/Client.ts"],"names":[],"mappings":"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"}

package/dist/models/Client.js

@@ -47,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
@@ -185,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"]).
@@ -200,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

package/dist/models/Document.d.ts

@@ -2,9 +2,9 @@
  * Document model
  *
  * Represents a file uploaded for a client.
- * Supports jurisdiction-specific document types (MX, US).
+ * Supports scope-specific document types (MX, US).
  */
-import { DocumentCategory, type DocumentResponse, DocumentStatus, Jurisdiction } from "@artu-ai/shared";
+import { DocumentCategory, type DocumentResponse, DocumentStatus } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 /**
  * Document data as returned by the API.
@@ -37,11 +37,11 @@ export declare class Document extends BaseModel<DocumentData> {
      */
     get clientId(): string;
     /**
-     * Jurisdiction for this document (MX, US)
+     * Scope for this document (MX, US)
      */
-    get jurisdiction(): Jurisdiction;
+    get scope(): "MX" | "US";
     /**
-     * Document type (jurisdiction-specific)
+     * Document type (scope-specific)
      */
     get type(): string;
     /**
@@ -106,10 +106,32 @@ export declare class Document extends BaseModel<DocumentData> {
      * Days until document expires (negative if already expired)
      */
     get daysUntilExpiry(): number | undefined;
+    /**
+     * Reason a document was rejected, if any. Set by `documents.reject(...)`.
+     */
+    get rejectionReason(): string | undefined;
+    /**
+     * Timestamp when the document was reviewed (verified or rejected).
+     */
+    get reviewedAt(): Date | undefined;
+    /**
+     * Opaque ID of the user who reviewed the document.
+     */
+    get reviewedBy(): string | undefined;
+    /**
+     * Timestamp when the document was verified. Retained for back-compat
+     * — prefer `reviewedAt` for new code (verify dual-writes both).
+     */
+    get verifiedAt(): Date | undefined;
+    /**
+     * Opaque ID of the user who verified the document. See `reviewedBy`
+     * for the canonical field.
+     */
+    get verifiedBy(): string | undefined;
     /**
      * Document-specific fields (extracted or provided data)
      *
-     * For typed fields, use jurisdiction-specific document models:
+     * For typed fields, use scope-specific document models:
      * - MexIneFrontDocument.ineFields
      * - MexPassportDocument.passportFields
      * - etc.

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

@@ -1 +1 @@
-{"version":3,"file":"Document.d.ts","sourceRoot":"","sources":["../../src/models/Document.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,cAAc,EACd,YAAY,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAM5C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,SAAQ,SAAS,CAAC,YAAY,CAAC;IAKpD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,CAE/B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,gBAAgB,CAE/B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,cAAc,CAE3B;IAMD;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAItC;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAMtB;IAMD;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAKzB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAIvB;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,GAAG,SAAS,CAEhC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAKxC;IAMD;;;;;;;OAOG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGhD;IAED;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQjD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQpD;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD;;OAEG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;OAEG;IACH,IAAI,uBAAuB,IAAI,OAAO,CAErC;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;CACD"}
+{"version":3,"file":"Document.d.ts","sourceRoot":"","sources":["../../src/models/Document.ts"],"names":[],"mappings":"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"}

package/dist/models/Document.js

@@ -2,9 +2,9 @@
  * Document model
  *
  * Represents a file uploaded for a client.
- * Supports jurisdiction-specific document types (MX, US).
+ * Supports scope-specific document types (MX, US).
  */
-import { DocumentCategory, DocumentStatus, Jurisdiction, } from "@artu-ai/shared";
+import { DocumentCategory, DocumentStatus, } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 // ─────────────────────────────────────────────────────────────────
 // Document Model
@@ -42,13 +42,13 @@ export class Document extends BaseModel {
         return this._data.clientId;
     }
     /**
-     * Jurisdiction for this document (MX, US)
+     * Scope for this document (MX, US)
      */
-    get jurisdiction() {
-        return this._data.jurisdiction;
+    get scope() {
+        return this._data.scope;
     }
     /**
-     * Document type (jurisdiction-specific)
+     * Document type (scope-specific)
      */
     get type() {
         return this._data.type;
@@ -172,12 +172,57 @@ export class Document extends BaseModel {
         return Math.ceil(diffTime / (1000 * 60 * 60 * 24));
     }
     // ─────────────────────────────────────────────────────────────────
+    // Review audit
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Reason a document was rejected, if any. Set by `documents.reject(...)`.
+     */
+    get rejectionReason() {
+        const value = this._data
+            .rejectionReason;
+        return typeof value === "string" ? value : undefined;
+    }
+    /**
+     * Timestamp when the document was reviewed (verified or rejected).
+     */
+    get reviewedAt() {
+        const value = this._data
+            .reviewedAt;
+        return typeof value === "string" ? new Date(value) : undefined;
+    }
+    /**
+     * Opaque ID of the user who reviewed the document.
+     */
+    get reviewedBy() {
+        const value = this._data
+            .reviewedBy;
+        return typeof value === "string" ? value : undefined;
+    }
+    /**
+     * Timestamp when the document was verified. Retained for back-compat
+     * — prefer `reviewedAt` for new code (verify dual-writes both).
+     */
+    get verifiedAt() {
+        const value = this._data
+            .verifiedAt;
+        return typeof value === "string" ? new Date(value) : undefined;
+    }
+    /**
+     * Opaque ID of the user who verified the document. See `reviewedBy`
+     * for the canonical field.
+     */
+    get verifiedBy() {
+        const value = this._data
+            .verifiedBy;
+        return typeof value === "string" ? value : undefined;
+    }
+    // ─────────────────────────────────────────────────────────────────
     // Fields
     // ─────────────────────────────────────────────────────────────────
     /**
      * Document-specific fields (extracted or provided data)
      *
-     * For typed fields, use jurisdiction-specific document models:
+     * For typed fields, use scope-specific document models:
      * - MexIneFrontDocument.ineFields
      * - MexPassportDocument.passportFields
      * - etc.
@@ -229,13 +274,13 @@ export class Document extends BaseModel {
         return new Date(this._data.updatedAt);
     }
     // ─────────────────────────────────────────────────────────────────
-    // Jurisdiction Type Guards
+    // Scope Type Guards
     // ─────────────────────────────────────────────────────────────────
     /**
      * Whether this is a Mexico document
      */
     get isMexico() {
-        return this._data.jurisdiction === Jurisdiction.Mexico;
+        return this._data.scope === "MX";
     }
     // ─────────────────────────────────────────────────────────────────
     // Category Helpers