@artu-ai/compliance-sdk 0.13.3 → 0.14.0

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

package/dist/models/Evidence.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Evidence model
+ *
+ * Represents a compliance evidence record optionally backed by a file.
+ * Evidence can be created with a file upload, with data fields only, or both.
+ */
+import type { EvidenceResponse } from "@artu-ai/shared";
+import { EvidenceStatus } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+/**
+ * Evidence data as returned by the API.
+ */
+export type EvidenceData = EvidenceResponse;
+/**
+ * Evidence model - represents a compliance evidence record.
+ *
+ * @example
+ * ```typescript
+ * const evidence = await sdk.evidence.retrieve("ev_123");
+ *
+ * console.log(evidence.status);         // "uploaded"
+ * console.log(evidence.filename);       // "contrato.pdf"
+ * console.log(evidence.formattedSize);  // "1.2 MB"
+ * console.log(evidence.isAvailable);    // true
+ * ```
+ */
+export declare class Evidence extends BaseModel<EvidenceData> {
+    /**
+     * Unique identifier for this evidence record
+     */
+    get id(): string;
+    /**
+     * Scope for this evidence (MX, US)
+     */
+    get scope(): "MX" | "US";
+    /**
+     * Evidence type (scope-specific)
+     */
+    get type(): string;
+    /**
+     * Evidence category
+     */
+    get category(): string;
+    /**
+     * Lifecycle status
+     */
+    get status(): EvidenceStatus;
+    /**
+     * Whether a file is attached to this evidence
+     */
+    get hasFile(): boolean;
+    /**
+     * Original filename (undefined if no file attached)
+     */
+    get filename(): string | undefined;
+    /**
+     * MIME content type (undefined if no file attached)
+     */
+    get contentType(): string | undefined;
+    /**
+     * File size in bytes (undefined if no file attached)
+     */
+    get size(): number | undefined;
+    /**
+     * Human-readable file size (e.g., "1.2 MB").
+     * Returns undefined if no file attached.
+     */
+    get formattedSize(): string | undefined;
+    /**
+     * File extension derived from filename.
+     * Returns empty string if no file or no extension.
+     */
+    get extension(): string;
+    /**
+     * Whether the evidence is available (uploaded or verified)
+     */
+    get isAvailable(): boolean;
+    /**
+     * Whether the evidence is pending a file upload
+     */
+    get isPendingUpload(): boolean;
+    /**
+     * Whether the evidence has no file (data-only)
+     */
+    get isNoFile(): boolean;
+    /**
+     * Whether the evidence has been submitted for review
+     */
+    get isPendingReview(): boolean;
+    /**
+     * Whether the evidence has been verified
+     */
+    get isVerified(): boolean;
+    /**
+     * Whether the evidence was rejected
+     */
+    get isRejected(): boolean;
+    /**
+     * Evidence expiration date, if set
+     */
+    get expiresAt(): Date | undefined;
+    /**
+     * Days until evidence expires (negative if already expired).
+     * Returns undefined if no expiration is set.
+     */
+    get daysUntilExpiry(): number | undefined;
+    /**
+     * Reason the evidence was rejected, if any
+     */
+    get rejectionReason(): string | undefined;
+    /**
+     * Timestamp when the evidence was reviewed (verified or rejected)
+     */
+    get reviewedAt(): Date | undefined;
+    /**
+     * Opaque ID of the user who reviewed the evidence
+     */
+    get reviewedBy(): string | undefined;
+    /**
+     * Timestamp when the evidence was verified
+     */
+    get verifiedAt(): Date | undefined;
+    /**
+     * Opaque ID of the user who verified the evidence
+     */
+    get verifiedBy(): string | undefined;
+    /**
+     * Evidence-specific fields (extracted or provided data)
+     */
+    get fields(): Record<string, unknown> | undefined;
+    /**
+     * Get a specific field value
+     */
+    getField<T = unknown>(key: string): T | undefined;
+    /**
+     * External ID for idempotent operations
+     */
+    get externalId(): string | undefined;
+    /**
+     * Custom metadata attached to the evidence
+     */
+    get metadata(): Record<string, unknown> | undefined;
+    /**
+     * Get a specific metadata value
+     */
+    getMetadata<T = unknown>(key: string): T | undefined;
+    /**
+     * When the evidence record was created
+     */
+    get createdAt(): Date;
+    /**
+     * When the evidence record was last updated
+     */
+    get updatedAt(): Date;
+    /**
+     * Whether this is Mexico evidence
+     */
+    get isMexico(): boolean;
+}
+/**
+ * Type guard for Evidence model
+ */
+export declare function isEvidence(value: unknown): value is Evidence;
+//# sourceMappingURL=Evidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Evidence.d.ts","sourceRoot":"","sources":["../../src/models/Evidence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAM5C;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAS,SAAQ,SAAS,CAAC,YAAY,CAAC;IAKpD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI,CAEvB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;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,CAKtC;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAMtB;IAMD;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAKzB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,GAAG,SAAS,CAEhC;IAED;;;OAGG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAKxC;IAMD;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAGxC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAGjC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAGjC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAMD;;OAEG;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;CACD;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}

package/dist/models/Evidence.js

@@ -0,0 +1,298 @@
+/**
+ * Evidence model
+ *
+ * Represents a compliance evidence record optionally backed by a file.
+ * Evidence can be created with a file upload, with data fields only, or both.
+ */
+import { EvidenceStatus } from "@artu-ai/shared";
+import { BaseModel } from "./base";
+// ─────────────────────────────────────────────────────────────────
+// Evidence Model
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Evidence model - represents a compliance evidence record.
+ *
+ * @example
+ * ```typescript
+ * const evidence = await sdk.evidence.retrieve("ev_123");
+ *
+ * console.log(evidence.status);         // "uploaded"
+ * console.log(evidence.filename);       // "contrato.pdf"
+ * console.log(evidence.formattedSize);  // "1.2 MB"
+ * console.log(evidence.isAvailable);    // true
+ * ```
+ */
+export class Evidence extends BaseModel {
+    // ─────────────────────────────────────────────────────────────────
+    // Core Properties
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Unique identifier for this evidence record
+     */
+    get id() {
+        return this._data.id;
+    }
+    /**
+     * Scope for this evidence (MX, US)
+     */
+    get scope() {
+        return this._data.scope;
+    }
+    /**
+     * Evidence type (scope-specific)
+     */
+    get type() {
+        return this._data.type;
+    }
+    /**
+     * Evidence category
+     */
+    get category() {
+        return this._data.category;
+    }
+    /**
+     * Lifecycle status
+     */
+    get status() {
+        return this._data.status;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // File Properties
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Whether a file is attached to this evidence
+     */
+    get hasFile() {
+        return !!this._data.filename;
+    }
+    /**
+     * Original filename (undefined if no file attached)
+     */
+    get filename() {
+        return this._data.filename ?? undefined;
+    }
+    /**
+     * MIME content type (undefined if no file attached)
+     */
+    get contentType() {
+        return this._data.contentType ?? undefined;
+    }
+    /**
+     * File size in bytes (undefined if no file attached)
+     */
+    get size() {
+        return this._data.size ?? undefined;
+    }
+    /**
+     * Human-readable file size (e.g., "1.2 MB").
+     * Returns undefined if no file attached.
+     */
+    get formattedSize() {
+        if (this._data.size === undefined || this._data.size === null) {
+            return undefined;
+        }
+        return formatBytes(this._data.size);
+    }
+    /**
+     * File extension derived from filename.
+     * Returns empty string if no file or no extension.
+     */
+    get extension() {
+        if (!this.filename)
+            return "";
+        const parts = this.filename.split(".");
+        const ext = parts.at(-1);
+        if (!ext || parts.length <= 1)
+            return "";
+        return ext.toLowerCase();
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Status Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Whether the evidence is available (uploaded or verified)
+     */
+    get isAvailable() {
+        return (this.status === EvidenceStatus.Uploaded ||
+            this.status === EvidenceStatus.Verified);
+    }
+    /**
+     * Whether the evidence is pending a file upload
+     */
+    get isPendingUpload() {
+        return this.status === EvidenceStatus.PendingUpload;
+    }
+    /**
+     * Whether the evidence has no file (data-only)
+     */
+    get isNoFile() {
+        return this.status === EvidenceStatus.NoFile;
+    }
+    /**
+     * Whether the evidence has been submitted for review
+     */
+    get isPendingReview() {
+        return this.status === EvidenceStatus.PendingReview;
+    }
+    /**
+     * Whether the evidence has been verified
+     */
+    get isVerified() {
+        return this.status === EvidenceStatus.Verified;
+    }
+    /**
+     * Whether the evidence was rejected
+     */
+    get isRejected() {
+        return this.status === EvidenceStatus.Rejected;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Validity
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Evidence expiration date, if set
+     */
+    get expiresAt() {
+        return this._data.expiresAt ? new Date(this._data.expiresAt) : undefined;
+    }
+    /**
+     * Days until evidence expires (negative if already expired).
+     * Returns undefined if no expiration is set.
+     */
+    get daysUntilExpiry() {
+        if (!this.expiresAt)
+            return undefined;
+        const now = new Date();
+        const diffTime = this.expiresAt.getTime() - now.getTime();
+        return Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Review Audit
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Reason the evidence was rejected, if any
+     */
+    get rejectionReason() {
+        const value = this._data.rejectionReason;
+        return typeof value === "string" ? value : undefined;
+    }
+    /**
+     * Timestamp when the evidence 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 evidence
+     */
+    get reviewedBy() {
+        const value = this._data.reviewedBy;
+        return typeof value === "string" ? value : undefined;
+    }
+    /**
+     * Timestamp when the evidence was verified
+     */
+    get verifiedAt() {
+        const value = this._data.verifiedAt;
+        return typeof value === "string" ? new Date(value) : undefined;
+    }
+    /**
+     * Opaque ID of the user who verified the evidence
+     */
+    get verifiedBy() {
+        const value = this._data.verifiedBy;
+        return typeof value === "string" ? value : undefined;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Fields
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Evidence-specific fields (extracted or provided data)
+     */
+    get fields() {
+        const value = this._data.fields;
+        return value ?? undefined;
+    }
+    /**
+     * Get a specific field value
+     */
+    getField(key) {
+        return this.fields?.[key];
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Metadata
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * External ID for idempotent operations
+     */
+    get externalId() {
+        return this._data.externalId ?? undefined;
+    }
+    /**
+     * Custom metadata attached to the evidence
+     */
+    get metadata() {
+        return this._data.metadata ?? undefined;
+    }
+    /**
+     * Get a specific metadata value
+     */
+    getMetadata(key) {
+        return this.metadata?.[key];
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Timestamps
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * When the evidence record was created
+     */
+    get createdAt() {
+        return new Date(this._data.createdAt);
+    }
+    /**
+     * When the evidence record was last updated
+     */
+    get updatedAt() {
+        return new Date(this._data.updatedAt);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Scope Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Whether this is Mexico evidence
+     */
+    get isMexico() {
+        return this._data.scope === "MX";
+    }
+}
+// ─────────────────────────────────────────────────────────────────
+// Type Guard
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Type guard for Evidence model
+ */
+export function isEvidence(value) {
+    return value instanceof Evidence;
+}
+// ─────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Format bytes into a human-readable string
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 bytes";
+    const units = ["bytes", "KB", "MB", "GB"];
+    let size = bytes;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    if (unitIndex === 0) {
+        return `${size} ${units[unitIndex]}`;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+}

package/dist/models/Product.d.ts

@@ -4,7 +4,7 @@
  * Pure data model with no API calls.
  * Provides type-safe access to common product properties.
  */
-import type { BaseProduct, EmbeddedTag, Jurisdiction } from "@artu-ai/shared";
+import type { BaseProduct, EmbeddedTag, Scope } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 /**
  * Product data as returned from the API.
@@ -54,15 +54,15 @@ export declare class Product extends BaseModel<ProductData> {
      */
     get tags(): EmbeddedTag[];
     /**
-     * Checks if product has data for a specific jurisdiction
+     * Checks if product has data for a specific scope
      */
-    hasJurisdiction(jurisdiction: Jurisdiction): boolean;
+    hasScope(scope: Scope): boolean;
     /**
-     * Raw jurisdiction data object
+     * Raw scope data object
      */
-    get jurisdictions(): BaseProduct["jurisdictions"];
+    get scopeData(): BaseProduct["scopeData"];
     /**
-     * Raw data for jurisdiction-specific access
+     * Raw data for scope-specific access
      */
     get data(): ProductData;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Product.d.ts","sourceRoot":"","sources":["../../src/models/Product.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;CACrB;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,OAAQ,SAAQ,SAAS,CAAC,WAAW,CAAC;IAKlD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAMD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,EAAE,CAExB;IAMD;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO;IAKpD;;OAEG;IACH,IAAI,aAAa,IAAI,WAAW,CAAC,eAAe,CAAC,CAEhD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,CAEtB;IAMD;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,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,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}
+{"version":3,"file":"Product.d.ts","sourceRoot":"","sources":["../../src/models/Product.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;CACrB;AAMD;;;;;;;;;;;GAWG;AACH,qBAAa,OAAQ,SAAQ,SAAS,CAAC,WAAW,CAAC;IAKlD;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAMD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,EAAE,CAExB;IAMD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAK/B;;OAEG;IACH,IAAI,SAAS,IAAI,WAAW,CAAC,WAAW,CAAC,CAExC;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,CAEtB;IAMD;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,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,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}