@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/resources/transactions.d.ts

@@ -3,16 +3,23 @@
  *
  * CRUD operations, filtering, pagination, and client relationships.
  *
- * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * This is the base (unscoped) resource. For scope-scoped SDKs, use:
  * - MexTransactionsResource - Mexico-scoped with flattened MX fields
  * - AVITransactionsResource - Mexico AVI-scoped with flattened AVI fields
  * - JYSTransactionsResource - Mexico JYS-scoped with flattened JYS fields
  * - TSCTransactionsResource - Mexico TSC-scoped with flattened TSC fields
  */
-import type { AtomicBatchResult, CreateTransactionInput, ListOptions, PaginatedResponse, PartialBatchResult, RelatedClient, ResourceTagResponse, RiskAssessmentInfo, TransactionFilter, TransactionSort, UpdateTransactionInput, UpsertResult, UpsertTransactionInput } from "@artu-ai/shared";
+import type { AtomicBatchResult, Checklist, CreateTransactionInput, ListOptions, MigrationPreview, MigrationResult, migrateTransactionInputSchema, PaginatedResponse, PartialBatchResult, RelatedClient, ResourceTagResponse, RiskAssessmentInfo, Scope, TransactionFilter, TransactionSort, UpdateTransactionInput, UpsertResult, UpsertTransactionInput } from "@artu-ai/shared";
 import { ClientRole } from "@artu-ai/shared";
+import { z } from "zod";
 import { Transaction, type TransactionData } from "../models";
+import { Evidence } from "../models/Evidence";
 import { BaseResource } from "./base";
+/**
+ * Options for `transactions.migrate` / `transactions.migratePreview`. The
+ * source-row `id` is supplied as the first argument, so it is omitted here.
+ */
+export type MigrateTransactionOptions = Omit<z.input<typeof migrateTransactionInputSchema>, "id">;
 /**
  * Base resource manager for transaction operations.
  *
@@ -30,7 +37,7 @@ import { BaseResource } from "./base";
  *   scopes: ["MX"],
  *   relatedClientIds: ["client_sender"],
  *   timestamp: new Date(),
- *   jurisdictions: {
+ *   scopeData: {
  *     MX: { actividadVulnerable: { AVI: { ... } } },
  *   },
  * });
@@ -43,13 +50,14 @@ import { BaseResource } from "./base";
  * ```
  */
 export declare class TransactionsResource<TSort = TransactionSort> extends BaseResource<Transaction, CreateTransactionInput, UpdateTransactionInput, TransactionFilter, TSort> {
+    protected scopeFilterKey: "scope" | "scopes" | null;
     /**
      * Fetches a product by ID and caches it for the duration of a batch.
      * Subclasses can override for scope-specific product resources.
      */
     private fetchProduct;
     /**
-     * Merges product jurisdiction data into nested transaction input.
+     * Merges product scope data into nested transaction input.
      * Used by the base (unscoped) resource. User-provided values take precedence.
      */
     protected mergeProductData<T extends Record<string, unknown>>(data: T): Promise<T>;
@@ -57,7 +65,7 @@ export declare class TransactionsResource<TSort = TransactionSort> extends BaseR
      * Merges product data into flat (scoped) transaction input.
      * Extracts the scope-specific fields from the product and merges at root level.
      *
-     * @param scopePath - Path to the scope data in the product jurisdictions
+     * @param scopePath - Path to the scope data in the product scopeData
      *   e.g., ["MX", "actividadVulnerable", "ARI"]
      */
     protected mergeProductDataFlat<T extends Record<string, unknown>>(data: T, scopePath: string[]): Promise<T>;
@@ -85,15 +93,52 @@ export declare class TransactionsResource<TSort = TransactionSort> extends BaseR
     /**
      * Retrieves a transaction by ID.
      */
-    retrieve(id: string): Promise<Transaction>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<Transaction>;
+    /**
+     * Retrieves the raw, un-instantiated transaction 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 - Transaction ID
+     * @returns The raw API payload (`TransactionData`) — not a model instance
+     */
+    retrieveRaw(id: string): Promise<TransactionData>;
     /**
      * Retrieves a transaction by metadata key/value.
      */
-    retrieveByMetadata(key: string, value: string): Promise<Transaction>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<Transaction>;
     /**
      * Retrieves a transaction by externalId.
      */
-    retrieveByExternalId(externalId: string): Promise<Transaction>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<Transaction>;
+    /**
+     * Get the compliance checklist for a transaction in a given scope.
+     *
+     * @param id - The transaction's UUID
+     * @param opts.scope - The scope to evaluate (e.g., "MX:AV:AVI")
+     * @param opts.includeChildren - When true, rollup items include
+     *   per-child item arrays. Defaults to true; pass false to receive
+     *   only the rollup summaries (useful for list views).
+     */
+    checklist(id: string, opts: {
+        scope: Scope;
+        includeChildren?: boolean;
+    }): Promise<Checklist>;
     /**
      * Updates a transaction.
      */
@@ -105,14 +150,18 @@ export declare class TransactionsResource<TSort = TransactionSort> extends BaseR
     /**
      * Lists transactions with optional filtering and pagination.
      */
-    list(options?: ListOptions<TransactionFilter, TSort>): Promise<PaginatedResponse<Transaction>>;
+    list(options?: ListOptions<TransactionFilter, TSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<Transaction>>;
     /**
      * Counts transactions matching the given filter.
      *
      * @param filter - Optional filter criteria
      * @returns The count of matching transactions
      */
-    count(filter?: TransactionFilter): Promise<number>;
+    count(filter?: TransactionFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     /**
      * Lists all transactions for a specific client.
      *
@@ -138,6 +187,7 @@ export declare class TransactionsResource<TSort = TransactionSort> extends BaseR
         filter?: TransactionFilter;
         sort?: TSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<Transaction, void, undefined>;
     /**
      * Links a client to a transaction with an optional role.
@@ -206,6 +256,31 @@ export declare class TransactionsResource<TSort = TransactionSort> extends BaseR
     upsertManyByExternalId(transactions: UpsertTransactionInput[], options: {
         atomic: false;
     }): Promise<PartialBatchResult<UpsertResult<Transaction>>>;
+    /**
+     * Links an evidence record to a transaction.
+     *
+     * @param input - Transaction ID and evidence ID to link
+     */
+    linkEvidence(input: {
+        transactionId: string;
+        evidenceId: string;
+    }): Promise<void>;
+    /**
+     * Unlinks an evidence record from a transaction.
+     *
+     * @param input - Transaction ID and evidence ID to unlink
+     */
+    unlinkEvidence(input: {
+        transactionId: string;
+        evidenceId: string;
+    }): Promise<void>;
+    /**
+     * Lists all evidence records linked to a transaction.
+     *
+     * @param transactionId - Transaction ID
+     * @returns Paginated list of evidence records
+     */
+    listEvidence(transactionId: string): Promise<PaginatedResponse<Evidence>>;
     /**
      * Adds tags to a transaction.
      */
@@ -222,10 +297,50 @@ export declare class TransactionsResource<TSort = TransactionSort> extends BaseR
      * Lists all tags on a transaction.
      */
     listTags(id: string): Promise<ResourceTagResponse[]>;
+    /**
+     * Copies this transaction into the other environment (test ↔ live),
+     * upserting it and the selected subresources (evidence, related clients) by
+     * externalId.
+     *
+     * The whole graph is migrated atomically: nothing is written unless every
+     * resource can be matched by externalId. When any resource in the graph
+     * lacks an externalId the call throws {@link MigrationBlockedError} (whose
+     * `blockers` lists the offending resources) and nothing is written — assign
+     * the missing externalIds and retry.
+     *
+     * @param id - Source-environment transaction id
+     * @param options - Target environment, precedence, and subresource selection
+     * @returns The completed migration result (target id, action, per-resource counts)
+     * @throws {MigrationBlockedError} when resources in the graph lack an externalId
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.transactions.migrate(transactionId, { to: "live" });
+     * console.log(result.action, result.targetId);
+     * ```
+     */
+    migrate(id: string, options: MigrateTransactionOptions): Promise<Extract<MigrationResult, {
+        status: "completed";
+    }>>;
+    /**
+     * Dry-run of {@link migrate}: reports what would be created/updated in the
+     * target environment and any blockers, without writing anything.
+     *
+     * @param id - Source-environment transaction id
+     * @param options - Target environment, precedence, and subresource selection
+     * @returns The migration preview (target action, blockers, per-resource counts)
+     */
+    migratePreview(id: string, options: MigrateTransactionOptions): Promise<MigrationPreview>;
     /**
      * Instantiates a Transaction model from API response data.
      * Subclasses override this to return their specific model type.
      */
     protected instantiate(data: TransactionData): Transaction;
+    /**
+     * Public, pure transform from a raw transaction 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: TransactionData): Transaction;
 }
-//# sourceMappingURL=transactions.d.ts.map

package/dist/resources/transactions.js

@@ -3,7 +3,7 @@
  *
  * CRUD operations, filtering, pagination, and client relationships.
  *
- * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
+ * This is the base (unscoped) resource. For scope-scoped SDKs, use:
  * - MexTransactionsResource - Mexico-scoped with flattened MX fields
  * - AVITransactionsResource - Mexico AVI-scoped with flattened AVI fields
  * - JYSTransactionsResource - Mexico JYS-scoped with flattened JYS fields
@@ -11,7 +11,9 @@
  */
 import { createTransactionInputSchema, updateTransactionInputSchema, upsertTransactionInputSchema, } from "@artu-ai/shared";
 import { z } from "zod";
+import { MigrationBlockedError } from "../errors/migration";
 import { Transaction } from "../models";
+import { Evidence } from "../models/Evidence";
 import { BaseResource } from "./base";
 // ===========================
 // TransactionsResource
@@ -33,7 +35,7 @@ import { BaseResource } from "./base";
  *   scopes: ["MX"],
  *   relatedClientIds: ["client_sender"],
  *   timestamp: new Date(),
- *   jurisdictions: {
+ *   scopeData: {
  *     MX: { actividadVulnerable: { AVI: { ... } } },
  *   },
  * });
@@ -46,6 +48,7 @@ import { BaseResource } from "./base";
  * ```
  */
 export class TransactionsResource extends BaseResource {
+    scopeFilterKey = "scopes";
     // ─────────────────────────────────────────────────────────────────
     // Product Merge
     // ─────────────────────────────────────────────────────────────────
@@ -55,41 +58,41 @@ export class TransactionsResource extends BaseResource {
      */
     async fetchProduct(productId) {
         const product = await this.execute(() => this.trpc.products.retrieve.query({ id: productId }));
-        return product?.jurisdictions ?? null;
+        return product?.scopeData ?? null;
     }
     /**
-     * Merges product jurisdiction data into nested transaction input.
+     * Merges product scope data into nested transaction input.
      * Used by the base (unscoped) resource. User-provided values take precedence.
      */
     async mergeProductData(data) {
         const productId = data.productId;
         if (!productId)
             return data;
-        const productJurisdictions = await this.fetchProduct(productId);
-        if (!productJurisdictions)
+        const productScopeData = await this.fetchProduct(productId);
+        if (!productScopeData)
             return data;
-        const txJurisdictions = data.jurisdictions ?? {};
+        const txJurisdictions = data.scopeData ?? {};
         return {
             ...data,
-            jurisdictions: deepMergeDefaults(txJurisdictions, productJurisdictions),
+            scopeData: deepMergeDefaults(txJurisdictions, productScopeData),
         };
     }
     /**
      * Merges product data into flat (scoped) transaction input.
      * Extracts the scope-specific fields from the product and merges at root level.
      *
-     * @param scopePath - Path to the scope data in the product jurisdictions
+     * @param scopePath - Path to the scope data in the product scopeData
      *   e.g., ["MX", "actividadVulnerable", "ARI"]
      */
     async mergeProductDataFlat(data, scopePath) {
         const productId = data.productId;
         if (!productId)
             return data;
-        const productJurisdictions = await this.fetchProduct(productId);
-        if (!productJurisdictions)
+        const productScopeData = await this.fetchProduct(productId);
+        if (!productScopeData)
             return data;
         // Navigate to the scope-specific data in the product
-        let scopeData = productJurisdictions;
+        let scopeData = productScopeData;
         for (const key of scopePath) {
             if (scopeData && typeof scopeData === "object") {
                 scopeData = scopeData[key];
@@ -115,13 +118,13 @@ export class TransactionsResource extends BaseResource {
             const productId = item.productId;
             if (!productId)
                 return item;
-            const productJurisdictions = productMap.get(productId);
-            if (!productJurisdictions)
+            const productScopeData = productMap.get(productId);
+            if (!productScopeData)
                 return item;
-            const txJurisdictions = item.jurisdictions ?? {};
+            const txJurisdictions = item.scopeData ?? {};
             return {
                 ...item,
-                jurisdictions: deepMergeDefaults(txJurisdictions, productJurisdictions),
+                scopeData: deepMergeDefaults(txJurisdictions, productScopeData),
             };
         });
     }
@@ -136,11 +139,11 @@ export class TransactionsResource extends BaseResource {
             const productId = item.productId;
             if (!productId)
                 return item;
-            const productJurisdictions = productMap.get(productId);
-            if (!productJurisdictions)
+            const productScopeData = productMap.get(productId);
+            if (!productScopeData)
                 return item;
             // Navigate to scope-specific data
-            let scopeData = productJurisdictions;
+            let scopeData = productScopeData;
             for (const key of scopePath) {
                 if (scopeData && typeof scopeData === "object") {
                     scopeData = scopeData[key];
@@ -169,7 +172,7 @@ export class TransactionsResource extends BaseResource {
         const products = await Promise.all(productIds.map((id) => this.execute(() => this.trpc.products.retrieve.query({ id }))));
         return new Map(products
             .filter(Boolean)
-            .map((p) => [p.id, p.jurisdictions]));
+            .map((p) => [p.id, p.scopeData]));
     }
     // ─────────────────────────────────────────────────────────────────
     // CRUD Operations
@@ -189,24 +192,70 @@ export class TransactionsResource extends BaseResource {
     /**
      * Retrieves a transaction by ID.
      */
-    async retrieve(id) {
-        const response = await this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
+    /**
+     * Retrieves the raw, un-instantiated transaction 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 - Transaction ID
+     * @returns The raw API payload (`TransactionData`) — not a model instance
+     */
+    async retrieveRaw(id) {
+        return this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+    }
     /**
      * Retrieves a transaction by metadata key/value.
      */
-    async retrieveByMetadata(key, value) {
-        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
     /**
      * Retrieves a transaction by externalId.
      */
-    async retrieveByExternalId(externalId) {
-        const response = await this.execute(() => this.trpc.transactions.retrieveByExternalId.query({ externalId }));
+    async retrieveByExternalId(externalId, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByExternalId.query({
+            externalId,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
         return this.instantiate(response);
     }
+    /**
+     * Get the compliance checklist for a transaction in a given scope.
+     *
+     * @param id - The transaction's UUID
+     * @param opts.scope - The scope to evaluate (e.g., "MX:AV:AVI")
+     * @param opts.includeChildren - When true, rollup items include
+     *   per-child item arrays. Defaults to true; pass false to receive
+     *   only the rollup summaries (useful for list views).
+     */
+    async checklist(id, opts) {
+        return this.execute(() => this.trpc.transactions.checklist.query({
+            id,
+            scope: opts.scope,
+            includeChildren: opts.includeChildren ?? true,
+        }));
+    }
     /**
      * Updates a transaction.
      */
@@ -229,7 +278,12 @@ export class TransactionsResource extends BaseResource {
      * Lists transactions with optional filtering and pagination.
      */
     async list(options) {
-        const response = await this.execute(() => this.trpc.transactions.list.query(options));
+        const { crossScope, ...rest } = options ?? {};
+        const filter = this.applyAutoScope(rest.filter, crossScope);
+        const response = await this.execute(() => this.trpc.transactions.list.query({
+            ...rest,
+            filter,
+        }));
         return {
             data: response.data.map((t) => this.instantiate(t)),
             pagination: response.pagination,
@@ -241,8 +295,9 @@ export class TransactionsResource extends BaseResource {
      * @param filter - Optional filter criteria
      * @returns The count of matching transactions
      */
-    async count(filter) {
-        const response = await this.execute(() => this.trpc.transactions.count.query({ filter }));
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(filter, options?.crossScope);
+        const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
         return response.count;
     }
     /**
@@ -276,6 +331,7 @@ export class TransactionsResource extends BaseResource {
             filter: options?.filter,
             sort: options?.sort,
             pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
         });
     }
     // ─────────────────────────────────────────────────────────────────
@@ -417,6 +473,45 @@ export class TransactionsResource extends BaseResource {
         }
     }
     // ─────────────────────────────────────────────────────────────────
+    // Evidence Relationship Management
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Links an evidence record to a transaction.
+     *
+     * @param input - Transaction ID and evidence ID to link
+     */
+    async linkEvidence(input) {
+        await this.execute(() => this.trpc.evidence.linkTransaction.mutate({
+            evidenceId: input.evidenceId,
+            transactionId: input.transactionId,
+        }));
+    }
+    /**
+     * Unlinks an evidence record from a transaction.
+     *
+     * @param input - Transaction ID and evidence ID to unlink
+     */
+    async unlinkEvidence(input) {
+        await this.execute(() => this.trpc.evidence.unlinkTransaction.mutate({
+            evidenceId: input.evidenceId,
+            transactionId: input.transactionId,
+        }));
+    }
+    /**
+     * Lists all evidence records linked to a transaction.
+     *
+     * @param transactionId - Transaction ID
+     * @returns Paginated list of evidence records
+     */
+    async listEvidence(transactionId) {
+        const response = await this.execute(() => this.trpc.evidence.listForTransaction.query({ transactionId }));
+        const typedResponse = response;
+        return {
+            data: typedResponse.data.map((d) => new Evidence(d)),
+            pagination: typedResponse.pagination,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
     // Tag Operations
     // ─────────────────────────────────────────────────────────────────
     /**
@@ -444,6 +539,49 @@ export class TransactionsResource extends BaseResource {
         return this.execute(() => this.trpc.transactions.listTags.query({ id }));
     }
     // ─────────────────────────────────────────────────────────────────
+    // Cross-environment Migration
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Copies this transaction into the other environment (test ↔ live),
+     * upserting it and the selected subresources (evidence, related clients) by
+     * externalId.
+     *
+     * The whole graph is migrated atomically: nothing is written unless every
+     * resource can be matched by externalId. When any resource in the graph
+     * lacks an externalId the call throws {@link MigrationBlockedError} (whose
+     * `blockers` lists the offending resources) and nothing is written — assign
+     * the missing externalIds and retry.
+     *
+     * @param id - Source-environment transaction id
+     * @param options - Target environment, precedence, and subresource selection
+     * @returns The completed migration result (target id, action, per-resource counts)
+     * @throws {MigrationBlockedError} when resources in the graph lack an externalId
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.transactions.migrate(transactionId, { to: "live" });
+     * console.log(result.action, result.targetId);
+     * ```
+     */
+    async migrate(id, options) {
+        const response = await this.execute(() => this.trpc.transactions.migrate.mutate({ ...options, id }));
+        if (response.status === "blocked") {
+            throw new MigrationBlockedError(response.blockers);
+        }
+        return response;
+    }
+    /**
+     * Dry-run of {@link migrate}: reports what would be created/updated in the
+     * target environment and any blockers, without writing anything.
+     *
+     * @param id - Source-environment transaction id
+     * @param options - Target environment, precedence, and subresource selection
+     * @returns The migration preview (target action, blockers, per-resource counts)
+     */
+    async migratePreview(id, options) {
+        return this.execute(() => this.trpc.transactions.migratePreview.mutate({ ...options, id }));
+    }
+    // ─────────────────────────────────────────────────────────────────
     // Instantiation (protected for subclasses to override)
     // ─────────────────────────────────────────────────────────────────
     /**
@@ -453,6 +591,15 @@ export class TransactionsResource extends BaseResource {
     instantiate(data) {
         return new Transaction(data);
     }
+    /**
+     * Public, pure transform from a raw transaction 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);
+    }
 }
 // ===========================
 // Utilities

package/dist/resources/users.d.ts

@@ -8,8 +8,7 @@
  * - List/manage invitations
  * - Assign/revoke roles
  */
-import type { AssignUserRoleInput, RevokeUserRoleInput, UserRoleResponse } from "@artu-ai/shared";
-import type { TRPCClient } from "../utils/trpc-client";
+import type { AssignUserRoleInput, Locale, RevokeUserRoleInput, UserRoleResponse } from "@artu-ai/shared";
 export interface Member {
     id: string;
     userId: string;
@@ -25,6 +24,16 @@ export interface Member {
         slug: string;
     }[];
 }
+/** Lightweight user summary returned by `users.get`. Excludes roles and
+ *  membership status — those belong to the full `Member` shape that
+ *  org-settings surfaces consume. */
+export interface UserSummary {
+    userId: string;
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+    profilePictureUrl: string | null;
+}
 export interface Invitation {
     id: string;
     email: string;
@@ -43,8 +52,15 @@ export interface InviteUserInput {
 }
 export declare class UsersResource {
     private readonly trpc;
-    constructor(trpc: TRPCClient);
     listMembers(): Promise<Member[]>;
+    /**
+     * Resolve a single user by id, scoped to the caller's org. Returns
+     * `null` when the user isn't a member (cross-org probes look
+     * indistinguishable from "user doesn't exist"). Two WorkOS calls
+     * round-trip; cache client-side via React Query if you're calling
+     * this from a list surface.
+     */
+    get(userId: string): Promise<UserSummary | null>;
     removeMember(membershipId: string): Promise<void>;
     listInvitations(options?: {
         status?: "pending" | "accepted" | "expired" | "revoked";
@@ -54,8 +70,20 @@ export declare class UsersResource {
     listRoleAssignments(): Promise<UserRoleResponse[]>;
     listRolesForUser(userId: string): Promise<UserRoleResponse[]>;
     myRoles(): Promise<UserRoleResponse[]>;
+    /**
+     * Persist the current user's preferred locale to their WorkOS profile.
+     * The dashboard cookie remains the immediate render source of truth; this
+     * makes the choice durable across devices and cleared cookies.
+     */
+    updateLocale(locale: Locale): Promise<{
+        locale: Locale;
+    }>;
+    /** Record the current user's acceptance of the Terms & Conditions. */
+    acceptTerms(): Promise<{
+        termsAcceptedAt: string;
+        termsVersion: string;
+    }>;
     assignRole(input: AssignUserRoleInput): Promise<UserRoleResponse>;
     revokeRole(input: RevokeUserRoleInput): Promise<void>;
     private execute;
 }
-//# sourceMappingURL=users.d.ts.map