@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/resources/alerts.d.ts

@@ -3,13 +3,13 @@
  *
  * CRUD operations, alert items management, validation, and generation.
  *
- * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * This is the base (unscoped) resource. For scope-scoped SDKs, use:
  * - MexAlertsResource - Mexico-scoped with flattened MX fields
  * - AVIAlertsResource - Mexico AVI-scoped with flattened AVI fields
  * - JYSAlertsResource - Mexico JYS-scoped with flattened JYS fields
  * - TSCAlertsResource - Mexico TSC-scoped with flattened TSC fields
  */
-import type { AlertClientItemFilter, AlertDefaultsInput, AlertFilter, AlertItemFilter, AlertItemSort, AlertSort, AlertTransactionItemFilter, AtomicBatchResult, ClientSort, CreateAlertInput, CreateAlertItemInput, GenerateResult, ListOptions, PaginatedResponse, PartialBatchResult, ReportType, ResourceTagResponse, SplitOptions, TransactionSort, UpdateAlertInput, UpdateAlertItemInput, UpdateReportStatusInput, UpsertAlertInput, UpsertResult, ValidationResult } from "@artu-ai/shared";
+import type { AcknowledgmentDownloadUrl, AcknowledgmentUploadUrl, AlertClientItemFilter, AlertDefaultsInput, AlertFilter, AlertItemFilter, AlertItemSort, AlertSort, AlertTransactionItemFilter, AtomicBatchResult, ClientSort, CreateAlertInput, CreateAlertItemInput, GenerateResult, GetAcknowledgmentUploadUrlInput, ListOptions, PaginatedResponse, PartialBatchResult, ReportType, ResourceTagResponse, SplitOptions, TransactionSort, UpdateAlertInput, UpdateAlertItemInput, UpdateAlertStatusInput, UpsertAlertInput, UpsertResult, ValidationResult } from "@artu-ai/shared";
 import { Alert, AlertClientItem, type AlertClientItemData, type AlertData, AlertItem, type AlertItemData, AlertTransactionItem, type AlertTransactionItemData } from "../models";
 import { AlertItemsResource } from "./alert-items";
 import { BaseResource } from "./base";
@@ -33,7 +33,7 @@ export interface AddItemsResult {
  * ```typescript
  * // Create a alert with full nested format
  * const alert = await sdk.alerts.create({
- *   jurisdictions: {
+ *   scopeData: {
  *     MX: {
  *       actividadVulnerable: {
  *         AVI: { mesReportado: "202401" }
@@ -56,6 +56,7 @@ export interface AddItemsResult {
  * ```
  */
 export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaultsInput, TItem extends AlertItem = AlertItem, TItemFilter = AlertItemFilter> extends BaseResource<Alert, CreateAlertInput, UpdateAlertInput, AlertFilter, TSort> {
+    protected scopeFilterKey: "scope" | "scopes" | null;
     /**
      * Top-level alert items sub-resource.
      * Provides list/count/iterate across all alerts.
@@ -78,29 +79,81 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
     /**
      * Retrieves a alert by ID.
      */
-    retrieve(id: string): Promise<Alert>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<Alert>;
+    /**
+     * Retrieves the raw, un-instantiated alert payload by ID.
+     *
+     * The API call is identical across every scope; only the client-side
+     * reshape differs. The React SDK caches this single scope-agnostic payload
+     * and lets each scope derive its own shape via `materialize`, avoiding N
+     * redundant fetches in nested scope-overview components.
+     *
+     * Intentionally does NOT pass `requireScope` (unlike `retrieve`): that is a
+     * client-supplied optional narrowing filter, not the authorization boundary.
+     * Tenant isolation is enforced server-side by RLS and applies identically
+     * here. A shared, id-keyed payload cannot carry a per-scope filter without
+     * leaking one scope's narrowing onto the others sharing the cache entry.
+     *
+     * @param id - Alert ID
+     * @returns The raw API payload (`AlertData`) — not a model instance
+     */
+    retrieveRaw(id: string): Promise<AlertData>;
     /**
      * Retrieves a alert by metadata key/value.
      */
-    retrieveByMetadata(key: string, value: string): Promise<Alert>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<Alert>;
     /**
      * Retrieves a alert by externalId.
      */
-    retrieveByExternalId(externalId: string): Promise<Alert>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<Alert>;
     /**
      * Updates a alert.
      */
     update(id: string, data: UpdateAlertInput): Promise<Alert>;
     /**
-     * Updates a alert's status.
+     * Updates an alert's lifecycle status.
      *
-     * Restrictions:
-     * - Can only manually set to: Draft
-     * - Cannot change from: Accepted (terminal), Submitted (awaiting response)
+     * Use this to manually transition an alert to a new state (e.g., InReview, Resolved, Dismissed).
+     * System-managed states (ReportValidating, ReportValid, ReportInvalid) cannot be set directly.
+     */
+    updateStatus(alertId: string, data: UpdateAlertStatusInput): Promise<Alert>;
+    /**
+     * Marks an alert as filed.
      *
-     * Use this to reset a alert back to Draft status for re-editing.
+     * Requires the alert to be in `report_valid` state with a current report,
+     * and an acknowledgment file must already be uploaded at the deterministic
+     * storage path via `getAcknowledgmentUploadUrl`. Terminal transition —
+     * the alert cannot be transitioned further once filed.
      */
-    updateStatus(id: string, data: UpdateReportStatusInput): Promise<Alert>;
+    markAsFiled(alertId: string): Promise<Alert>;
+    /**
+     * Gets a presigned upload URL for uploading an alert's acknowledgment file.
+     *
+     * The file is stored at a deterministic path derived from the alert's
+     * organization, environment, and ID. Call `markAsFiled` after uploading.
+     *
+     * @param alertId - The alert ID
+     * @param data - Upload options (contentType)
+     * @returns Presigned upload URL with expiry
+     */
+    getAcknowledgmentUploadUrl(alertId: string, data: GetAcknowledgmentUploadUrlInput): Promise<AcknowledgmentUploadUrl>;
+    /**
+     * Gets a presigned download URL for an alert's acknowledgment file.
+     *
+     * The alert must have been filed (i.e., `isFiled === true`) for this to succeed.
+     * The returned URL is valid for a limited time (configured by the storage provider).
+     *
+     * @param alertId - The alert ID
+     * @returns Presigned URL with filename, contentType, and expiry
+     * @throws If the alert has not been filed
+     */
+    getAcknowledgmentDownloadUrl(alertId: string): Promise<AcknowledgmentDownloadUrl>;
     /**
      * Deletes a alert.
      */
@@ -108,14 +161,18 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
     /**
      * Lists alerts with optional filtering and pagination.
      */
-    list(options?: ListOptions<AlertFilter, TSort>): Promise<PaginatedResponse<Alert>>;
+    list(options?: ListOptions<AlertFilter, TSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<Alert>>;
     /**
      * Counts alerts matching the given filter.
      *
      * @param filter - Optional filter criteria
      * @returns The count of matching alerts
      */
-    count(filter?: AlertFilter): Promise<number>;
+    count(filter?: AlertFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     /**
      * Returns an async iterator over all alerts matching the filter.
      */
@@ -123,6 +180,7 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
         filter?: AlertFilter;
         sort?: TSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<Alert, void, undefined>;
     /**
      * Adds an item to a alert.
@@ -166,14 +224,17 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
         removed: number;
     }>;
     /**
-     * Validates a alert and its items.
+     * Validates an alert and its items.
      *
-     * Requires reportType and optional jurisdiction-specific defaults.
+     * Requires reportType and optional scope-specific defaults.
      * For scoped SDKs, use the scoped resource which provides a simpler API.
      *
+     * The reportType must be valid for this resource's scope (client-side pre-flight check).
+     * The server enforces the same constraint authoritatively.
+     *
      * @param alertId - The alert ID to validate
      * @param reportType - The report type (e.g., "mex.actividad-vulnerable.avi")
-     * @param defaults - Jurisdiction-specific defaults for validation (optional)
+     * @param defaults - Scope-specific defaults for validation (optional)
      */
     validateReport(alertId: string, reportType: ReportType, defaults?: TDefaults): Promise<ValidationResult>;
     /**
@@ -189,9 +250,12 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
      *
      * Use `validateReport` for dry-run/preview validation without generating output.
      *
+     * The reportType must be valid for this resource's scope (client-side pre-flight check).
+     * The server enforces the same constraint authoritatively.
+     *
      * @param alertId - The alert ID to generate
      * @param reportType - The report type (e.g., "mex.actividad-vulnerable.avi")
-     * @param defaults - Jurisdiction-specific defaults for generation (optional)
+     * @param defaults - Scope-specific defaults for generation (optional)
      * @param options - Optional generation options including split strategy
      * @returns GenerateResult with status "success" or "validation_failed"
      */
@@ -285,6 +349,13 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
      * Subclasses override this to return their specific model type.
      */
     protected instantiate(data: AlertData): Alert;
+    /**
+     * Public, pure transform from a raw alert payload to this scope's model.
+     * Wraps the protected `instantiate` so the React SDK can apply it inside a
+     * TanStack Query `select`. Subclasses override `instantiate` (and `materialize`),
+     * so each scope materializes its own model type.
+     */
+    materialize(data: AlertData): Alert;
     /**
      * Instantiates a AlertItem model from API response data.
      * Subclasses override this to return their specific model type.
@@ -301,4 +372,3 @@ export declare class AlertsResource<TSort = AlertSort, TDefaults = AlertDefaults
      */
     protected instantiateClientItem(data: AlertClientItemData): AlertClientItem;
 }
-//# sourceMappingURL=alerts.d.ts.map

package/dist/resources/alerts.js

@@ -3,13 +3,13 @@
  *
  * CRUD operations, alert items management, validation, and generation.
  *
- * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * This is the base (unscoped) resource. For scope-scoped SDKs, use:
  * - MexAlertsResource - Mexico-scoped with flattened MX fields
  * - AVIAlertsResource - Mexico AVI-scoped with flattened AVI fields
  * - JYSAlertsResource - Mexico JYS-scoped with flattened JYS fields
  * - TSCAlertsResource - Mexico TSC-scoped with flattened TSC fields
  */
-import { createAlertInputSchema, createAlertItemInputSchema, generateReportInputSchema, updateAlertInputSchema, updateAlertItemInputSchema, updateReportStatusInputSchema, upsertAlertInputSchema, validateReportInputSchema, } from "@artu-ai/shared";
+import { createAlertInputSchema, createAlertItemInputSchema, generateReportInputSchema, getAcknowledgmentUploadUrlInputSchema, ReportTypeUtils, updateAlertInputSchema, updateAlertItemInputSchema, updateAlertStatusInputSchema, upsertAlertInputSchema, validateReportInputSchema, } from "@artu-ai/shared";
 import { z } from "zod";
 import { Alert, AlertClientItem, AlertItem, AlertTransactionItem, } from "../models";
 import { AlertItemsResource } from "./alert-items";
@@ -30,7 +30,7 @@ import { mergeTenantIntoDefaults } from "./merge-tenant-defaults";
  * ```typescript
  * // Create a alert with full nested format
  * const alert = await sdk.alerts.create({
- *   jurisdictions: {
+ *   scopeData: {
  *     MX: {
  *       actividadVulnerable: {
  *         AVI: { mesReportado: "202401" }
@@ -53,6 +53,7 @@ import { mergeTenantIntoDefaults } from "./merge-tenant-defaults";
  * ```
  */
 export class AlertsResource extends BaseResource {
+    scopeFilterKey = "scope";
     /**
      * Top-level alert items sub-resource.
      * Provides list/count/iterate across all alerts.
@@ -85,22 +86,52 @@ export class AlertsResource extends BaseResource {
     /**
      * Retrieves a alert by ID.
      */
-    async retrieve(id) {
-        const response = await this.execute(() => this.trpc.alerts.retrieve.query({ id }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.alerts.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
+    /**
+     * Retrieves the raw, un-instantiated alert payload by ID.
+     *
+     * The API call is identical across every scope; only the client-side
+     * reshape differs. The React SDK caches this single scope-agnostic payload
+     * and lets each scope derive its own shape via `materialize`, avoiding N
+     * redundant fetches in nested scope-overview components.
+     *
+     * Intentionally does NOT pass `requireScope` (unlike `retrieve`): that is a
+     * client-supplied optional narrowing filter, not the authorization boundary.
+     * Tenant isolation is enforced server-side by RLS and applies identically
+     * here. A shared, id-keyed payload cannot carry a per-scope filter without
+     * leaking one scope's narrowing onto the others sharing the cache entry.
+     *
+     * @param id - Alert ID
+     * @returns The raw API payload (`AlertData`) — not a model instance
+     */
+    async retrieveRaw(id) {
+        return this.execute(() => this.trpc.alerts.retrieve.query({ id }));
+    }
     /**
      * Retrieves a alert by metadata key/value.
      */
-    async retrieveByMetadata(key, value) {
-        const response = await this.execute(() => this.trpc.alerts.retrieveByMetadata.query({ key, value }));
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.alerts.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     /**
      * Retrieves a alert by externalId.
      */
-    async retrieveByExternalId(externalId) {
-        const response = await this.execute(() => this.trpc.alerts.retrieveByExternalId.query({ externalId }));
+    async retrieveByExternalId(externalId, opts) {
+        const response = await this.execute(() => this.trpc.alerts.retrieveByExternalId.query({
+            externalId,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     /**
@@ -112,19 +143,58 @@ export class AlertsResource extends BaseResource {
         return this.instantiate(response);
     }
     /**
-     * Updates a alert's status.
+     * Updates an alert's lifecycle status.
      *
-     * Restrictions:
-     * - Can only manually set to: Draft
-     * - Cannot change from: Accepted (terminal), Submitted (awaiting response)
+     * Use this to manually transition an alert to a new state (e.g., InReview, Resolved, Dismissed).
+     * System-managed states (ReportValidating, ReportValid, ReportInvalid) cannot be set directly.
+     */
+    async updateStatus(alertId, data) {
+        const validated = this.validate(updateAlertStatusInputSchema, data);
+        const response = await this.execute(() => this.trpc.alerts.updateStatus.mutate({ alertId, ...validated }));
+        return this.instantiate(response);
+    }
+    /**
+     * Marks an alert as filed.
      *
-     * Use this to reset a alert back to Draft status for re-editing.
+     * Requires the alert to be in `report_valid` state with a current report,
+     * and an acknowledgment file must already be uploaded at the deterministic
+     * storage path via `getAcknowledgmentUploadUrl`. Terminal transition —
+     * the alert cannot be transitioned further once filed.
      */
-    async updateStatus(id, data) {
-        const validated = this.validate(updateReportStatusInputSchema, data);
-        const response = await this.execute(() => this.trpc.alerts.updateStatus.mutate({ id, data: validated }));
+    async markAsFiled(alertId) {
+        const response = await this.execute(() => this.trpc.alerts.markAsFiled.mutate({ alertId }));
         return this.instantiate(response);
     }
+    /**
+     * Gets a presigned upload URL for uploading an alert's acknowledgment file.
+     *
+     * The file is stored at a deterministic path derived from the alert's
+     * organization, environment, and ID. Call `markAsFiled` after uploading.
+     *
+     * @param alertId - The alert ID
+     * @param data - Upload options (contentType)
+     * @returns Presigned upload URL with expiry
+     */
+    async getAcknowledgmentUploadUrl(alertId, data) {
+        const validated = this.validate(getAcknowledgmentUploadUrlInputSchema, data);
+        return this.execute(() => this.trpc.alerts.getAcknowledgmentUploadUrl.mutate({
+            alertId,
+            ...validated,
+        }));
+    }
+    /**
+     * Gets a presigned download URL for an alert's acknowledgment file.
+     *
+     * The alert must have been filed (i.e., `isFiled === true`) for this to succeed.
+     * The returned URL is valid for a limited time (configured by the storage provider).
+     *
+     * @param alertId - The alert ID
+     * @returns Presigned URL with filename, contentType, and expiry
+     * @throws If the alert has not been filed
+     */
+    async getAcknowledgmentDownloadUrl(alertId) {
+        return this.execute(() => this.trpc.alerts.getAcknowledgmentDownloadUrl.query({ alertId }));
+    }
     /**
      * Deletes a alert.
      */
@@ -135,7 +205,12 @@ export class AlertsResource extends BaseResource {
      * Lists alerts with optional filtering and pagination.
      */
     async list(options) {
-        const response = await this.execute(() => this.trpc.alerts.list.query(options));
+        const { crossScope, ...rest } = options ?? {};
+        const filter = this.applyAutoScope(rest.filter, crossScope);
+        const response = await this.execute(() => this.trpc.alerts.list.query({
+            ...rest,
+            filter,
+        }));
         return {
             data: response.data.map((r) => this.instantiate(r)),
             pagination: response.pagination,
@@ -147,8 +222,9 @@ export class AlertsResource extends BaseResource {
      * @param filter - Optional filter criteria
      * @returns The count of matching alerts
      */
-    async count(filter) {
-        const response = await this.execute(() => this.trpc.alerts.count.query({ filter }));
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(filter, options?.crossScope);
+        const response = await this.execute(() => this.trpc.alerts.count.query({ filter: scopedFilter }));
         return response.count;
     }
     /**
@@ -159,6 +235,7 @@ export class AlertsResource extends BaseResource {
             filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
     // ─────────────────────────────────────────────────────────────────
@@ -260,16 +337,24 @@ export class AlertsResource extends BaseResource {
     // Validation & Generation
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Validates a alert and its items.
+     * Validates an alert and its items.
      *
-     * Requires reportType and optional jurisdiction-specific defaults.
+     * Requires reportType and optional scope-specific defaults.
      * For scoped SDKs, use the scoped resource which provides a simpler API.
      *
+     * The reportType must be valid for this resource's scope (client-side pre-flight check).
+     * The server enforces the same constraint authoritatively.
+     *
      * @param alertId - The alert ID to validate
      * @param reportType - The report type (e.g., "mex.actividad-vulnerable.avi")
-     * @param defaults - Jurisdiction-specific defaults for validation (optional)
+     * @param defaults - Scope-specific defaults for validation (optional)
      */
     async validateReport(alertId, reportType, defaults) {
+        const scope = (this.scope ?? (await this.retrieve(alertId)).scope);
+        const allowed = ReportTypeUtils.forScope(scope);
+        if (!allowed.includes(reportType)) {
+            throw new Error("Report type is not valid for this alert's scope.");
+        }
         const mergedDefaults = await this.mergeTenantDefaults(defaults, reportType);
         const validated = this.validate(validateReportInputSchema, {
             alertId,
@@ -291,13 +376,21 @@ export class AlertsResource extends BaseResource {
      *
      * Use `validateReport` for dry-run/preview validation without generating output.
      *
+     * The reportType must be valid for this resource's scope (client-side pre-flight check).
+     * The server enforces the same constraint authoritatively.
+     *
      * @param alertId - The alert ID to generate
      * @param reportType - The report type (e.g., "mex.actividad-vulnerable.avi")
-     * @param defaults - Jurisdiction-specific defaults for generation (optional)
+     * @param defaults - Scope-specific defaults for generation (optional)
      * @param options - Optional generation options including split strategy
      * @returns GenerateResult with status "success" or "validation_failed"
      */
     async generateReport(alertId, reportType, defaults, options) {
+        const scope = (this.scope ?? (await this.retrieve(alertId)).scope);
+        const allowed = ReportTypeUtils.forScope(scope);
+        if (!allowed.includes(reportType)) {
+            throw new Error("Report type is not valid for this alert's scope.");
+        }
         const mergedDefaults = await this.mergeTenantDefaults(defaults, reportType);
         const validated = this.validate(generateReportInputSchema, {
             alertId,
@@ -465,6 +558,15 @@ export class AlertsResource extends BaseResource {
     instantiate(data) {
         return new Alert(data);
     }
+    /**
+     * Public, pure transform from a raw alert payload to this scope's model.
+     * Wraps the protected `instantiate` so the React SDK can apply it inside a
+     * TanStack Query `select`. Subclasses override `instantiate` (and `materialize`),
+     * so each scope materializes its own model type.
+     */
+    materialize(data) {
+        return this.instantiate(data);
+    }
     /**
      * Instantiates a AlertItem model from API response data.
      * Subclasses override this to return their specific model type.

package/dist/resources/api-keys.d.ts

@@ -5,10 +5,8 @@
  * API key roles are immutable after creation.
  */
 import type { ApiKeyResponse, CreateApiKeyInput, CreateApiKeyResponse } from "@artu-ai/shared";
-import type { TRPCClient } from "../utils/trpc-client";
 export declare class ApiKeysResource {
     private readonly trpc;
-    constructor(trpc: TRPCClient);
     list(): Promise<ApiKeyResponse[]>;
     get(id: string): Promise<ApiKeyResponse>;
     /**
@@ -20,4 +18,3 @@ export declare class ApiKeysResource {
     delete(id: string): Promise<void>;
     private execute;
 }
-//# sourceMappingURL=api-keys.d.ts.map

package/dist/resources/api-keys.js

@@ -9,6 +9,7 @@ import { TRPCClientError } from "@trpc/client";
 import { mapTRPCError, ValidationError } from "../errors";
 export class ApiKeysResource {
     trpc;
+    /** @internal */
     constructor(trpc) {
         this.trpc = trpc;
     }

package/dist/resources/audit-logs.d.ts

@@ -5,7 +5,6 @@
  * Provides listing, retrieval, and hash chain verification.
  */
 import type { AuditChainVerification, AuditLogFilter, AuditLogResponse, PaginatedResponse } from "@artu-ai/shared";
-import type { TRPCClient } from "../utils/trpc-client";
 export type AuditLog = AuditLogResponse;
 export type { AuditLogFilter, AuditChainVerification };
 /**
@@ -31,7 +30,6 @@ export type { AuditLogFilter, AuditChainVerification };
  */
 export declare class AuditLogsResource {
     private readonly trpc;
-    constructor(trpc: TRPCClient);
     /**
      * Lists audit logs with optional filtering and pagination.
      */
@@ -55,4 +53,3 @@ export declare class AuditLogsResource {
      */
     verify(): Promise<AuditChainVerification>;
 }
-//# sourceMappingURL=audit-logs.d.ts.map

package/dist/resources/audit-logs.js

@@ -30,6 +30,7 @@
  */
 export class AuditLogsResource {
     trpc;
+    /** @internal */
     constructor(trpc) {
         this.trpc = trpc;
     }

package/dist/resources/bank-accounts.d.ts

@@ -3,10 +3,10 @@
  *
  * Manages bank account information for clients.
  *
- * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * This is the base (unscoped) resource. For scope-scoped SDKs, use:
  * - MexBankAccountsResource - Mexico-scoped with flattened CLABE fields
  */
-import type { AtomicBatchResult, BankAccountFilter, BankAccountSort, CreateBankAccountInput, ListOptions, PaginatedResponse, PartialBatchResult, SyncItem, SyncResult, UpdateBankAccountInput, UpsertBankAccountInput, UpsertResult } from "@artu-ai/shared";
+import type { AtomicBatchResult, BankAccountFilter, BankAccountSort, CreateBankAccountInput, ListOptions, PaginatedResponse, PartialBatchResult, SyncItem, SyncResult, UpdateBankAccountInput, UpsertBankAccountByExternalIdInput, UpsertBankAccountInput, UpsertResult } from "@artu-ai/shared";
 import { BankAccount, type BankAccountData } from "../models/BankAccount";
 import { BaseResource } from "./base";
 /**
@@ -20,7 +20,7 @@ import { BaseResource } from "./base";
  *   bankName: "BBVA México",
  *   type: BankAccountType.Checking,
  *   currency: Currency.MXN,
- *   jurisdictions: {
+ *   scopeData: {
  *     MX: {
  *       clabe: "012345678901234567",
  *     },
@@ -145,7 +145,7 @@ export declare class BankAccountsResource<TSort = BankAccountSort> extends BaseR
      * @param data - Bank account upsert data (must include externalId and clientId)
      * @returns The created or updated bank account with action indicator
      */
-    upsertByExternalId(data: UpsertBankAccountInput): Promise<UpsertResult<BankAccount>>;
+    upsertByExternalId(data: UpsertBankAccountByExternalIdInput): Promise<UpsertResult<BankAccount>>;
     /**
      * Creates or updates multiple bank accounts by externalId in a single request.
      *
@@ -209,4 +209,3 @@ export declare class BankAccountsResource<TSort = BankAccountSort> extends BaseR
      */
     protected instantiate(data: BankAccountData): BankAccount;
 }
-//# sourceMappingURL=bank-accounts.d.ts.map

package/dist/resources/bank-accounts.js

@@ -3,68 +3,11 @@
  *
  * Manages bank account information for clients.
  *
- * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * This is the base (unscoped) resource. For scope-scoped SDKs, use:
  * - MexBankAccountsResource - Mexico-scoped with flattened CLABE fields
  */
-import { Clabe, createBankAccountInputSchema, replaceSyncItemSchema, updateBankAccountInputSchema, upsertBankAccountInputSchema, } from "@artu-ai/shared";
+import { createBankAccountInputSchema, fillMexBankAccountFields, replaceSyncItemSchema, updateBankAccountInputSchema, upsertBankAccountByExternalIdInputSchema, upsertBankAccountInputSchema, } from "@artu-ai/shared";
 import { z } from "zod";
-// ─────────────────────────────────────────────────────────────────
-// MX Bank Account Field Auto-Fill
-// ─────────────────────────────────────────────────────────────────
-/**
- * Fill missing MX bank account fields from CLABE or its constituent parts
- * before sending to the API.
- *
- * - If `clabe` is present → extracts missing codigoBanco, codigoPlaza, accountNumber, bankName
- * - If `codigoBanco` + `codigoPlaza` + `accountNumber` present → computes missing clabe (+ bankName)
- * - Only fills fields that are not already set
- * - Returns input unchanged if not MX or no fields can be filled
- */
-function fillMexBankAccountFields(data) {
-    const country = data.country;
-    const clabe = typeof data.clabe === "string" ? data.clabe : undefined;
-    const codigoBanco = typeof data.codigoBanco === "string" ? data.codigoBanco : undefined;
-    const codigoPlaza = typeof data.codigoPlaza === "string" ? data.codigoPlaza : undefined;
-    const accountNumber = typeof data.accountNumber === "string" ? data.accountNumber : undefined;
-    const bankName = typeof data.bankName === "string" ? data.bankName : undefined;
-    // Only process MX bank accounts or inputs with MX-specific fields
-    if (country !== "MX" && !clabe && !codigoBanco && !codigoPlaza) {
-        return data;
-    }
-    const filled = { ...data };
-    // Direction 1: CLABE → parts
-    if (clabe && clabe.length === 18) {
-        const result = Clabe.parse(clabe);
-        if (result.valid) {
-            if (!codigoBanco)
-                filled.codigoBanco = result.bankCode;
-            if (!codigoPlaza)
-                filled.codigoPlaza = result.plazaCode;
-            if (!accountNumber)
-                filled.accountNumber = result.accountNumber;
-            if (!bankName && result.bankName)
-                filled.bankName = result.bankName;
-        }
-    }
-    // Direction 2: parts → CLABE
-    const finalCodigoBanco = typeof filled.codigoBanco === "string" ? filled.codigoBanco : undefined;
-    const finalCodigoPlaza = typeof filled.codigoPlaza === "string" ? filled.codigoPlaza : undefined;
-    const finalAccountNumber = typeof filled.accountNumber === "string" ? filled.accountNumber : undefined;
-    if (!clabe &&
-        finalCodigoBanco?.length === 3 &&
-        finalCodigoPlaza?.length === 3 &&
-        finalAccountNumber) {
-        const computed = Clabe.calculate(finalCodigoBanco, finalCodigoPlaza, finalAccountNumber);
-        const result = Clabe.parse(computed);
-        if (result.valid) {
-            filled.clabe = result.clabe;
-            if (!bankName && !filled.bankName && result.bankName) {
-                filled.bankName = result.bankName;
-            }
-        }
-    }
-    return filled;
-}
 import { BankAccount } from "../models/BankAccount";
 import { BaseResource } from "./base";
 // ===========================
@@ -81,7 +24,7 @@ import { BaseResource } from "./base";
  *   bankName: "BBVA México",
  *   type: BankAccountType.Checking,
  *   currency: Currency.MXN,
- *   jurisdictions: {
+ *   scopeData: {
  *     MX: {
  *       clabe: "012345678901234567",
  *     },
@@ -281,7 +224,7 @@ export class BankAccountsResource extends BaseResource {
      * @returns The created or updated bank account with action indicator
      */
     async upsertByExternalId(data) {
-        const validated = this.validate(upsertBankAccountInputSchema, this.fillMexFields(data));
+        const validated = this.validate(upsertBankAccountByExternalIdInputSchema, this.fillMexFields(data));
         const response = await this.execute(() => this.trpc.bankAccounts.upsertByExternalId.mutate(validated));
         return {
             data: this.instantiate(response.data),