@artu-ai/compliance-sdk 0.12.4 → 0.13.0

package/dist/models/Client.js

@@ -13,6 +13,17 @@ import { Document } from "./Document";
 // ===========================
 // Utilities
 // ===========================
+function applyRiskRounding(value, mode) {
+    switch (mode) {
+        case "floor":
+            return Math.floor(value);
+        case "round":
+            return Math.round(value);
+        case "ceil":
+        default:
+            return Math.ceil(value);
+    }
+}
 /**
  * Parse a date string, handling date-only strings (YYYY-MM-DD) as local time
  * to avoid timezone conversion issues.
@@ -181,6 +192,12 @@ export class Client extends BaseModel {
     get scopes() {
         return this._data.scopes ?? [];
     }
+    /**
+     * Tags applied to this client.
+     */
+    get tags() {
+        return this._data.tags ?? [];
+    }
     /**
      * Checks if client has data for a specific jurisdiction
      */
@@ -256,6 +273,98 @@ export class Client extends BaseModel {
         }));
     }
     // ─────────────────────────────────────────────────────────────────
+    // Risk Assessments
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Raw risk assessments map — keyed by assessment name, each value is an
+     * append-only array of snapshots representing the assessment history.
+     */
+    get riskAssessments() {
+        return this._data.riskAssessments ?? {};
+    }
+    /**
+     * Names of all risk assessments attached to this client.
+     */
+    get riskAssessmentNames() {
+        return Object.keys(this.riskAssessments);
+    }
+    /**
+     * Retrieve a specific risk assessment snapshot by name and optional version.
+     * Version is the 0-based index in the append-only history array.
+     * Defaults to the latest (most recent) version.
+     *
+     * @param name - The assessment name
+     * @param version - Optional 0-based version index (defaults to latest)
+     * @returns The snapshot, or undefined if not found
+     */
+    riskAssessment(name, version) {
+        const snapshots = this.riskAssessments[name];
+        if (!snapshots || snapshots.length === 0)
+            return undefined;
+        const idx = version ?? snapshots.length - 1;
+        return snapshots[idx];
+    }
+    /**
+     * List all available versions for a named risk assessment.
+     *
+     * @param name - The assessment name
+     * @returns Array of `{ version, calculatedAt }` entries, or empty array if not found
+     */
+    riskAssessmentVersions(name) {
+        const snapshots = this.riskAssessments[name];
+        if (!snapshots)
+            return [];
+        return snapshots.map((s, i) => ({
+            version: i,
+            calculatedAt: s.calculatedAt,
+        }));
+    }
+    /**
+     * Get the overall score for a risk assessment.
+     *
+     * - With a name: returns the overall score of the latest version of that assessment.
+     * - Without a name: returns the overall score of the most recently calculated
+     *   assessment across all assessments (by `calculatedAt`).
+     *
+     * @param name - Optional assessment name
+     * @returns The overall score, or undefined if no assessments exist
+     */
+    riskAssessmentScore(name) {
+        if (name != null) {
+            return this.riskAssessment(name)?.overall;
+        }
+        return this._latestRiskSnapshot()?.overall;
+    }
+    /**
+     * Get the display-ready risk score for the most recent assessment.
+     * Returns the score scaled to maxScore and rounded per the stored mode,
+     * along with the maxScore denominator.
+     *
+     * @returns `{ score, maxScore }` or undefined if no assessments exist
+     */
+    riskAssessmentDisplayScore() {
+        const snapshot = this._latestRiskSnapshot();
+        if (!snapshot)
+            return undefined;
+        const maxScore = snapshot.maxScore ?? 100;
+        const mode = snapshot.roundingMode ?? "ceil";
+        return {
+            score: applyRiskRounding(snapshot.overall * maxScore, mode),
+            maxScore,
+        };
+    }
+    /** Find the most recently calculated snapshot across all assessments */
+    _latestRiskSnapshot() {
+        let latest;
+        for (const snapshots of Object.values(this.riskAssessments)) {
+            const last = snapshots[snapshots.length - 1];
+            if (last && (!latest || last.calculatedAt > latest.calculatedAt)) {
+                latest = last;
+            }
+        }
+        return latest;
+    }
+    // ─────────────────────────────────────────────────────────────────
     // Timestamps
     // ─────────────────────────────────────────────────────────────────
     /**

package/dist/models/Product.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Base Product Model
+ *
+ * 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 { BaseModel } from "./base";
+/**
+ * Product data as returned from the API.
+ * Extends the base schema with server-generated fields.
+ */
+export interface ProductData extends BaseProduct {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    tags?: EmbeddedTag[];
+}
+/**
+ * Base Product Model.
+ *
+ * Pure data model with no API calls.
+ *
+ * @example
+ * ```typescript
+ * const product = await sdk.products.retrieve("prod_123");
+ * console.log(product.name);
+ * console.log(product.scopes);
+ * ```
+ */
+export declare class Product extends BaseModel<ProductData> {
+    /**
+     * Unique identifier
+     */
+    get id(): string;
+    /**
+     * Product name
+     */
+    get name(): string;
+    /**
+     * Product description
+     */
+    get description(): string | undefined;
+    /**
+     * External ID for integration with other systems
+     */
+    get externalId(): string | undefined;
+    /**
+     * Scopes this product belongs to (e.g. ["MX", "MX:AV:ARI"]).
+     */
+    get scopes(): string[];
+    /**
+     * Tags applied to this product.
+     */
+    get tags(): EmbeddedTag[];
+    /**
+     * Checks if product has data for a specific jurisdiction
+     */
+    hasJurisdiction(jurisdiction: Jurisdiction): boolean;
+    /**
+     * Raw jurisdiction data object
+     */
+    get jurisdictions(): BaseProduct["jurisdictions"];
+    /**
+     * Raw data for jurisdiction-specific access
+     */
+    get data(): ProductData;
+    /**
+     * Custom metadata
+     */
+    get metadata(): Record<string, unknown> | undefined;
+    /**
+     * When the product record was created
+     */
+    get createdAt(): Date;
+    /**
+     * When the product record was last updated
+     */
+    get updatedAt(): Date;
+    toString(): string;
+}
+/**
+ * Check if value is any type of Product model
+ */
+export declare function isProduct(value: unknown): value is Product;
+//# sourceMappingURL=Product.d.ts.map

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

@@ -0,0 +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"}

package/dist/models/Product.js

@@ -0,0 +1,128 @@
+/**
+ * Base Product Model
+ *
+ * Pure data model with no API calls.
+ * Provides type-safe access to common product properties.
+ */
+import { BaseModel } from "./base";
+// ===========================
+// Product Model
+// ===========================
+/**
+ * Base Product Model.
+ *
+ * Pure data model with no API calls.
+ *
+ * @example
+ * ```typescript
+ * const product = await sdk.products.retrieve("prod_123");
+ * console.log(product.name);
+ * console.log(product.scopes);
+ * ```
+ */
+export class Product extends BaseModel {
+    // ─────────────────────────────────────────────────────────────────
+    // Identity
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Unique identifier
+     */
+    get id() {
+        return this._data.id;
+    }
+    /**
+     * Product name
+     */
+    get name() {
+        return this._data.name;
+    }
+    /**
+     * Product description
+     */
+    get description() {
+        return this._data.description;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // References
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * External ID for integration with other systems
+     */
+    get externalId() {
+        return this._data.externalId;
+    }
+    /**
+     * Scopes this product belongs to (e.g. ["MX", "MX:AV:ARI"]).
+     */
+    get scopes() {
+        return this._data.scopes ?? [];
+    }
+    /**
+     * Tags applied to this product.
+     */
+    get tags() {
+        return this._data.tags ?? [];
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Jurisdiction
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Checks if product has data for a specific jurisdiction
+     */
+    hasJurisdiction(jurisdiction) {
+        if (!this._data.jurisdictions)
+            return false;
+        return jurisdiction in this._data.jurisdictions;
+    }
+    /**
+     * Raw jurisdiction data object
+     */
+    get jurisdictions() {
+        return this._data.jurisdictions ?? {};
+    }
+    /**
+     * Raw data for jurisdiction-specific access
+     */
+    get data() {
+        return this._data;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Metadata
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Custom metadata
+     */
+    get metadata() {
+        return this._data.metadata;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Timestamps
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * When the product record was created
+     */
+    get createdAt() {
+        return new Date(this._data.createdAt);
+    }
+    /**
+     * When the product record was last updated
+     */
+    get updatedAt() {
+        return new Date(this._data.updatedAt);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // String Representation
+    // ─────────────────────────────────────────────────────────────────
+    toString() {
+        return `Product(${this.id}, ${this.name})`;
+    }
+}
+// ===========================
+// Type Guards
+// ===========================
+/**
+ * Check if value is any type of Product model
+ */
+export function isProduct(value) {
+    return value instanceof Product;
+}

package/dist/models/Rule.d.ts

@@ -4,7 +4,7 @@
  * Pure data model for monitoring rules.
  * Rules define triggers and visual workflows for the rules engine.
  */
-import type { RuleResponse, RuleStatus, RuleTrigger, RuleWorkflow } from "@artu-ai/shared";
+import type { EmbeddedTag, RuleResponse, RuleStatus, RuleTrigger, RuleWorkflow } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 export type RuleData = RuleResponse;
 /**
@@ -25,6 +25,10 @@ export declare class Rule extends BaseModel<RuleData> {
     get trigger(): RuleTrigger;
     get workflow(): RuleWorkflow;
     get metadata(): Record<string, unknown> | undefined;
+    /**
+     * Tags applied to this rule.
+     */
+    get tags(): EmbeddedTag[];
     get createdAt(): Date;
     get updatedAt(): Date;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../src/models/Rule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAMpC;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC5C,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,MAAM,CAEjC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD"}
+{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../src/models/Rule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAMpC;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC5C,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,MAAM,CAEjC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,EAAE,CAExB;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAMD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAEpD"}

package/dist/models/Rule.js

@@ -46,6 +46,12 @@ export class Rule extends BaseModel {
     get metadata() {
         return this._data.metadata;
     }
+    /**
+     * Tags applied to this rule.
+     */
+    get tags() {
+        return this._data.tags ?? [];
+    }
     get createdAt() {
         return new Date(this._data.createdAt);
     }

package/dist/models/RuleEvaluation.d.ts

@@ -24,6 +24,7 @@ export declare class RuleEvaluation extends BaseModel<RuleEvaluationData> {
     get error(): string | null;
     get alertIds(): string[];
     get durationMs(): number | null;
+    get inputs(): Record<string, unknown> | null;
     get resolvedVariables(): Record<string, unknown> | null;
     get workflowTrace(): WorkflowTrace | null;
     get nodeTraces(): NodeTrace[];

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

@@ -1 +1 @@
-{"version":3,"file":"RuleEvaluation.d.ts","sourceRoot":"","sources":["../../src/models/RuleEvaluation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAMxD;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS,CAAC,kBAAkB,CAAC;IAChE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,MAAM,CAEjC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEtD;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAExC;IAED,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED,IAAI,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAE1C;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE"}
+{"version":3,"file":"RuleEvaluation.d.ts","sourceRoot":"","sources":["../../src/models/RuleEvaluation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAMxD;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS,CAAC,kBAAkB,CAAC;IAChE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,MAAM,CAEjC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE3C;IAED,IAAI,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEtD;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAExC;IAED,IAAI,UAAU,IAAI,SAAS,EAAE,CAE5B;IAED,IAAI,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAE1C;IAED,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEQ,QAAQ,IAAI,MAAM;CAG3B;AAMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE"}

package/dist/models/RuleEvaluation.js

@@ -51,6 +51,9 @@ export class RuleEvaluation extends BaseModel {
     get durationMs() {
         return this._data.durationMs;
     }
+    get inputs() {
+        return this._data.inputs ?? null;
+    }
     get resolvedVariables() {
         return this._data.resolvedVariables ?? null;
     }

package/dist/models/Transaction.d.ts

@@ -4,7 +4,7 @@
  * Pure data model with no API calls.
  * Provides type-safe access to common transaction properties.
  */
-import type { BaseTransaction, Jurisdiction } from "@artu-ai/shared";
+import type { BaseTransaction, EmbeddedTag, Jurisdiction, RiskAssessmentSnapshot, RiskAssessments } from "@artu-ai/shared";
 import { TransactionStatus } from "@artu-ai/shared";
 import { BaseModel } from "./base";
 /**
@@ -17,6 +17,10 @@ export interface TransactionData extends Omit<BaseTransaction, "timestamp"> {
     createdAt: string;
     updatedAt: string;
     isAlerted: boolean;
+    alertedAt: string | null;
+    productId?: string;
+    riskAssessments?: RiskAssessments;
+    tags?: EmbeddedTag[];
 }
 /**
  * Base Transaction Model.
@@ -69,6 +73,10 @@ export declare class Transaction extends BaseModel<TransactionData> {
      * Whether this transaction is referenced by at least one active alert item
      */
     get isAlerted(): boolean;
+    /**
+     * When the transaction was first added to an active alert (null if not alerted)
+     */
+    get alertedAt(): string | null;
     /**
      * External ID for integration with other systems
      */
@@ -77,10 +85,18 @@ export declare class Transaction extends BaseModel<TransactionData> {
      * Transaction description
      */
     get description(): string | undefined;
+    /**
+     * Associated product ID
+     */
+    get productId(): string | undefined;
     /**
      * Scopes this transaction belongs to (e.g. ["MX", "MX:AV:AVI"]).
      */
     get scopes(): string[];
+    /**
+     * Tags applied to this transaction.
+     */
+    get tags(): EmbeddedTag[];
     /**
      * Checks if transaction has data for a specific jurisdiction
      */
@@ -89,6 +105,59 @@ export declare class Transaction extends BaseModel<TransactionData> {
      * Raw jurisdiction data object
      */
     get jurisdictions(): BaseTransaction["jurisdictions"];
+    /**
+     * Raw risk assessments map — keyed by assessment name, each value is an
+     * append-only array of snapshots representing the assessment history.
+     */
+    get riskAssessments(): RiskAssessments;
+    /**
+     * Names of all risk assessments attached to this transaction.
+     */
+    get riskAssessmentNames(): string[];
+    /**
+     * Retrieve a specific risk assessment snapshot by name and optional version.
+     * Version is the 0-based index in the append-only history array.
+     * Defaults to the latest (most recent) version.
+     *
+     * @param name - The assessment name
+     * @param version - Optional 0-based version index (defaults to latest)
+     * @returns The snapshot, or undefined if not found
+     */
+    riskAssessment(name: string, version?: number): RiskAssessmentSnapshot | undefined;
+    /**
+     * List all available versions for a named risk assessment.
+     *
+     * @param name - The assessment name
+     * @returns Array of `{ version, calculatedAt }` entries, or empty array if not found
+     */
+    riskAssessmentVersions(name: string): {
+        version: number;
+        calculatedAt: string;
+    }[];
+    /**
+     * Get the overall score for a risk assessment.
+     *
+     * - With a name: returns the overall score of the latest version of that assessment.
+     * - Without a name: returns the overall score of the most recently calculated
+     *   assessment across all assessments (by `calculatedAt`).
+     *
+     * @param name - Optional assessment name
+     * @returns The overall score, or undefined if no assessments exist
+     */
+    riskAssessmentScore(name?: string): number | undefined;
+    /**
+     * Get the display-ready risk score for the most recent assessment.
+     * Returns the score scaled to maxScore and rounded per the stored mode,
+     * along with the maxScore denominator.
+     *
+     * @returns `{ score, maxScore }` or undefined if no assessments exist
+     */
+    riskAssessmentDisplayScore(): {
+        score: number;
+        maxScore: number;
+    } | undefined;
+    /** Find the most recently calculated snapshot across all assessments */
+    private _latestRiskSnapshot;
     /**
      * When the transaction was executed/occurred
      */

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

@@ -1 +1 @@
-{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../src/models/Transaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAMnC;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACnB;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,SAAS,CAAC,eAAe,CAAC;IAK1D;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAMD;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAW5B;IAMD;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,EAAE,CAE/B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAMD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAED;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO;IAKpD;;OAEG;IACH,IAAI,aAAa,IAAI,eAAe,CAAC,eAAe,CAAC,CAEpD;IAMD;;OAEG;IACH,IAAI,SAAS,IAAI,IAAI,CAEpB;IAMD;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAElD;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAItD;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,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../src/models/Transaction.ts"],"names":[],"mappings":"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"}