@xkova/sdk 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/member-resources.d.ts

@@ -18,8 +18,64 @@ export declare class XKOVAMemberResources {
     get paymentRequests(): import("./resources/index.js").PaymentRequestsResource;
     get wallets(): import("./resources/index.js").WalletsResource;
     readonly self: {
+        profile: () => Promise<{
+            id: import("./generated/types.js").components["schemas"]["AccountHolderId"];
+            tenant_id?: string;
+            state: "active" | "held" | "closed" | "closed_uncooperative" | "provisioning_failed";
+            state_reason?: string | null;
+            state_changed_at?: import("./generated/types.js").components["schemas"]["TimestampUtc"] | null;
+            tier: "tier_1" | "tier_2";
+            tier_2_uplift_status?: "not_requested" | "pending" | "passed" | "failed";
+            first_use_completed: boolean;
+            cip_payload?: {
+                name_hash?: string;
+                dob_hash?: string;
+                id_hash?: string;
+                address_hash?: string;
+            } | null;
+            cip_accepted_at?: import("./generated/types.js").components["schemas"]["TimestampUtc"] | null;
+            merchant_role_state?: "none" | "pending_review" | "approved" | "rejected" | "revoked";
+            auto_save_contacts?: boolean;
+            created_at: import("./generated/types.js").components["schemas"]["TimestampUtc"];
+            updated_at?: import("./generated/types.js").components["schemas"]["TimestampUtc"];
+            email?: string | null;
+            first_name?: string | null;
+            last_name?: string | null;
+            phone?: string | null;
+            avatar_url?: string | null;
+        }>;
+        productEnrollment: (product: string, control?: XKOVARequestControl) => Promise<{
+            product: string;
+            status: "not_opened" | "setup_required" | "opening" | "active" | "requires_review";
+            terms_version: string | null;
+            accepted_at: string | null;
+            credit: {
+                amount: string;
+                token_deployment_id: string;
+                token_address: string;
+                token_symbol: string;
+                chain: import("./generated/types.js").components["schemas"]["ChainDescriptor"];
+                status: "pending" | "submitted" | "settled" | "requires_review";
+                transaction_hash: string | null;
+            } | null;
+        }>;
+        acceptProductEnrollment: (product: string, body: ReqBody<"acceptAccountHolderSelfProductEnrollment">, opts?: XKOVAMutationOptions) => Promise<{
+            product: string;
+            status: "not_opened" | "setup_required" | "opening" | "active" | "requires_review";
+            terms_version: string | null;
+            accepted_at: string | null;
+            credit: {
+                amount: string;
+                token_deployment_id: string;
+                token_address: string;
+                token_symbol: string;
+                chain: import("./generated/types.js").components["schemas"]["ChainDescriptor"];
+                status: "pending" | "submitted" | "settled" | "requires_review";
+                transaction_hash: string | null;
+            } | null;
+        }>;
         actionReadiness: (control?: XKOVARequestControl) => Promise<{
-            authorization_method: "hosted_passkey" | "external_oidc";
+            authorization_method: "hosted_passkey" | "external_oidc" | "xkova_webauthn";
             setup_status: "passkey_required" | "recovery_acknowledgement_required" | "recovery_required" | "ready" | "externally_managed";
             action_authorization_enabled: boolean;
             requires_fresh_proof: true;
@@ -53,10 +109,20 @@ export declare class XKOVAMemberResources {
         }>;
         balance: (control?: XKOVARequestControl) => Promise<{
             balances: import("./generated/types.js").components["schemas"]["AccountHolderSelfBalanceEntry"][];
+            data_freshness: import("./generated/types.js").components["schemas"]["DataFreshness"][];
         }>;
         wallets: (control?: XKOVARequestControl) => Promise<{
             data: import("./generated/types.js").components["schemas"]["Wallet"][];
         }>;
+        walletAuth: (control?: XKOVARequestControl) => Promise<{
+            strategy: "auth_endpoint";
+            payload: string;
+            client_id: string;
+            project_id: string;
+            external_user_id: string;
+            expires_at: string;
+            expected_address?: string;
+        } & Record<string, never>>;
         walletReadiness: (control?: XKOVARequestControl) => Promise<{
             status: "not_registered" | "provisioning" | "ready";
             wallets: import("./generated/types.js").components["schemas"]["Wallet"][];

package/dist/member-resources.js

@@ -31,11 +31,15 @@ export class XKOVAMemberResources {
         return this.client.wallets;
     }
     self = {
+        profile: () => this.client.accountHolders.selfProfile(this.context),
+        productEnrollment: (product, control) => this.client.accountHolders.selfProductEnrollment(this.context, product, control),
+        acceptProductEnrollment: (product, body, opts) => this.client.accountHolders.acceptSelfProductEnrollment(this.context, product, body, opts),
         actionReadiness: (control) => this.client.accountHolders.selfActionReadiness({ ...this.context, accountHolderId: this.accountHolderId }, control),
         sandboxBankingContext: (control) => this.client.accountHolders.selfSandboxBankingContext(this.context, control),
         verification: (control) => this.client.accountHolders.selfVerification(this.context, control),
         balance: (control) => this.client.accountHolders.selfBalance(this.context, control),
         wallets: (control) => this.client.accountHolders.listSelfWallets(this.context, control),
+        walletAuth: (control) => this.client.accountHolders.selfWalletAuth(this.context, control),
         walletReadiness: (control) => this.client.accountHolders.selfWalletReadiness(this.context, control),
         ensureWalletProvisioning: (opts) => this.client.accountHolders.ensureSelfWalletProvisioning(this.context, opts),
         bankBalance: (control) => this.client.accountHolders.selfBankBalance(this.context, control),
@@ -47,10 +51,10 @@ export class XKOVAMemberResources {
         requestDataExport: (opts) => this.client.accountHolders.requestSelfDataExport(this.context, opts),
         dataExport: (id, control) => this.client.accountHolders.selfDataExport(this.context, id, control),
         transactions: (query, control) => this.client.accountHolders.listSelfTransactions(this.context, query, control),
-        avatar: () => this.client.accountHolders.avatarUrl(this.accountHolderId),
-        uploadAvatar: (image, control) => this.client.accountHolders.uploadAvatar(this.accountHolderId, image, control),
-        deleteAvatar: (opts) => this.client.accountHolders.deleteAvatar(this.accountHolderId, opts),
-        confirmAvatar: (body, opts) => this.client.accountHolders.confirmAvatar(this.accountHolderId, body, opts),
-        presignAvatarUpload: (body, opts) => this.client.accountHolders.presignAvatarUpload(this.accountHolderId, body, opts),
+        avatar: () => this.client.accountHolders.selfAvatarUrl(this.context),
+        uploadAvatar: (image, control) => this.client.accountHolders.uploadSelfAvatar(this.context, image, control),
+        deleteAvatar: (opts) => this.client.accountHolders.deleteSelfAvatar(this.context, opts),
+        confirmAvatar: (body, opts) => this.client.accountHolders.confirmSelfAvatar(this.context, body, opts),
+        presignAvatarUpload: (body, opts) => this.client.accountHolders.presignSelfAvatarUpload(this.context, body, opts),
     };
 }

package/dist/request-signing.js

@@ -11,6 +11,10 @@ const CONDITIONAL_HEADERS = [
     'idempotency-key',
     'x-member-session-id',
     'x-xkova-publishable-key',
+    'x-xkova-workforce-key',
+    'x-workforce-session',
+    'x-xkova-human-authorization',
+    'origin',
     'x-account-holder-id',
     'x-sender-wallet-id',
     'x-sandbox-scenario',
@@ -78,6 +82,8 @@ export async function signXKOVARequest(input) {
 function requiredComponents(headers, bodyPresent) {
     const components = [...BASE_COMPONENTS];
     for (const header of CONDITIONAL_HEADERS) {
+        if (header === 'origin' && !headers.has('x-xkova-workforce-key'))
+            continue;
         if (headers.has(header) ||
             (bodyPresent && (header === 'content-digest' || header === 'content-type'))) {
             components.push(header);

package/dist/resources/account-holders.d.ts

@@ -100,6 +100,32 @@ export declare class AccountHoldersResource extends Resource {
         next_cursor?: string | null;
         has_more: boolean;
     }>;
+    selfProfile(context: XKOVAMemberSessionContext, control?: XKOVARequestControl): Promise<{
+        id: import("../generated/types.js").components["schemas"]["AccountHolderId"];
+        tenant_id?: string;
+        state: "active" | "held" | "closed" | "closed_uncooperative" | "provisioning_failed";
+        state_reason?: string | null;
+        state_changed_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
+        tier: "tier_1" | "tier_2";
+        tier_2_uplift_status?: "not_requested" | "pending" | "passed" | "failed";
+        first_use_completed: boolean;
+        cip_payload?: {
+            name_hash?: string;
+            dob_hash?: string;
+            id_hash?: string;
+            address_hash?: string;
+        } | null;
+        cip_accepted_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
+        merchant_role_state?: "none" | "pending_review" | "approved" | "rejected" | "revoked";
+        auto_save_contacts?: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        email?: string | null;
+        first_name?: string | null;
+        last_name?: string | null;
+        phone?: string | null;
+        avatar_url?: string | null;
+    }>;
     selfVerification(context: XKOVAMemberSessionContext, control?: XKOVARequestControl): Promise<{
         required: boolean;
         status: string;
@@ -118,12 +144,52 @@ export declare class AccountHoldersResource extends Resource {
         }[];
         verification_url: string | null;
     }>;
+    selfProductEnrollment(context: XKOVAMemberSessionContext, product: string, control?: XKOVARequestControl): Promise<{
+        product: string;
+        status: "not_opened" | "setup_required" | "opening" | "active" | "requires_review";
+        terms_version: string | null;
+        accepted_at: string | null;
+        credit: {
+            amount: string;
+            token_deployment_id: string;
+            token_address: string;
+            token_symbol: string;
+            chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+            status: "pending" | "submitted" | "settled" | "requires_review";
+            transaction_hash: string | null;
+        } | null;
+    }>;
+    acceptSelfProductEnrollment(context: XKOVAMemberSessionContext, product: string, body: ReqBody<'acceptAccountHolderSelfProductEnrollment'>, opts?: XKOVAMutationOptions): Promise<{
+        product: string;
+        status: "not_opened" | "setup_required" | "opening" | "active" | "requires_review";
+        terms_version: string | null;
+        accepted_at: string | null;
+        credit: {
+            amount: string;
+            token_deployment_id: string;
+            token_address: string;
+            token_symbol: string;
+            chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
+            status: "pending" | "submitted" | "settled" | "requires_review";
+            transaction_hash: string | null;
+        } | null;
+    }>;
     selfBalance(context: XKOVAMemberSessionContext, control?: XKOVARequestControl): Promise<{
         balances: import("../generated/types.js").components["schemas"]["AccountHolderSelfBalanceEntry"][];
+        data_freshness: import("../generated/types.js").components["schemas"]["DataFreshness"][];
     }>;
     listSelfWallets(context: XKOVAMemberSessionContext, control?: XKOVARequestControl): Promise<{
         data: import("../generated/types.js").components["schemas"]["Wallet"][];
     }>;
+    selfWalletAuth(context: XKOVAMemberSessionContext, control?: XKOVARequestControl): Promise<{
+        strategy: "auth_endpoint";
+        payload: string;
+        client_id: string;
+        project_id: string;
+        external_user_id: string;
+        expires_at: string;
+        expected_address?: string;
+    } & Record<string, never>>;
     selfWalletReadiness(context: XKOVAMemberSessionContext, control?: XKOVARequestControl): Promise<{
         status: "not_registered" | "provisioning" | "ready";
         wallets: import("../generated/types.js").components["schemas"]["Wallet"][];
@@ -149,7 +215,7 @@ export declare class AccountHoldersResource extends Resource {
     selfActionReadiness(context: XKOVAMemberSessionContext & {
         accountHolderId: string;
     }, control?: XKOVARequestControl): Promise<{
-        authorization_method: "hosted_passkey" | "external_oidc";
+        authorization_method: "hosted_passkey" | "external_oidc" | "xkova_webauthn";
         setup_status: "passkey_required" | "recovery_acknowledgement_required" | "recovery_required" | "ready" | "externally_managed";
         action_authorization_enabled: boolean;
         requires_fresh_proof: true;
@@ -229,6 +295,70 @@ export declare class AccountHoldersResource extends Resource {
     uploadAvatar(id: string, image: Blob, control?: XKOVARequestControl): Promise<{
         url: string | null;
     }>;
+    uploadSelfAvatar(context: XKOVAMemberSessionContext, image: Blob, control?: XKOVARequestControl): Promise<{
+        url: string | null;
+    }>;
+    private uploadAvatarImage;
+    selfAvatarUrl(context: XKOVAMemberSessionContext): Promise<{
+        url: string | null;
+    }>;
+    deleteSelfAvatar(context: XKOVAMemberSessionContext, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["AccountHolderId"];
+        tenant_id?: string;
+        state: "active" | "held" | "closed" | "closed_uncooperative" | "provisioning_failed";
+        state_reason?: string | null;
+        state_changed_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
+        tier: "tier_1" | "tier_2";
+        tier_2_uplift_status?: "not_requested" | "pending" | "passed" | "failed";
+        first_use_completed: boolean;
+        cip_payload?: {
+            name_hash?: string;
+            dob_hash?: string;
+            id_hash?: string;
+            address_hash?: string;
+        } | null;
+        cip_accepted_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
+        merchant_role_state?: "none" | "pending_review" | "approved" | "rejected" | "revoked";
+        auto_save_contacts?: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        email?: string | null;
+        first_name?: string | null;
+        last_name?: string | null;
+        phone?: string | null;
+        avatar_url?: string | null;
+    }>;
+    confirmSelfAvatar(context: XKOVAMemberSessionContext, body: ReqBody<'confirmAccountHolderSelfAvatar'>, opts?: XKOVAMutationOptions): Promise<{
+        id: import("../generated/types.js").components["schemas"]["AccountHolderId"];
+        tenant_id?: string;
+        state: "active" | "held" | "closed" | "closed_uncooperative" | "provisioning_failed";
+        state_reason?: string | null;
+        state_changed_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
+        tier: "tier_1" | "tier_2";
+        tier_2_uplift_status?: "not_requested" | "pending" | "passed" | "failed";
+        first_use_completed: boolean;
+        cip_payload?: {
+            name_hash?: string;
+            dob_hash?: string;
+            id_hash?: string;
+            address_hash?: string;
+        } | null;
+        cip_accepted_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
+        merchant_role_state?: "none" | "pending_review" | "approved" | "rejected" | "revoked";
+        auto_save_contacts?: boolean;
+        created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+        email?: string | null;
+        first_name?: string | null;
+        last_name?: string | null;
+        phone?: string | null;
+        avatar_url?: string | null;
+    }>;
+    presignSelfAvatarUpload(context: XKOVAMemberSessionContext, body: ReqBody<'presignAccountHolderSelfAvatarUpload'>, opts?: XKOVAMutationOptions): Promise<{
+        upload_url: string;
+        object_key: string;
+        expires_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
+    }>;
     avatarUrl(id: string): Promise<{
         url: string | null;
     }>;

package/dist/resources/account-holders.js

@@ -1,5 +1,6 @@
 import { Resource } from './base.js';
 import { XKOVAUploadError } from '../errors.js';
+import { isAllowedProtocol } from '../url.js';
 function memberSessionHeaders(context) {
     return {
         'X-Member-Session-Id': context.memberSessionId,
@@ -27,15 +28,27 @@ export class AccountHoldersResource extends Resource {
     history(id, query = {}) {
         return this.getJson(`/account-holders/${this.enc(id)}/history`, query);
     }
+    selfProfile(context, control) {
+        return this.getJson('/account-holders/self', undefined, control, memberSessionHeaders(context));
+    }
     selfVerification(context, control) {
         return this.getJson('/account-holders/self/verification', undefined, control, memberSessionHeaders(context));
     }
+    selfProductEnrollment(context, product, control) {
+        return this.getJson(`/account-holders/self/product-enrollments/${this.enc(product)}`, undefined, control, memberSessionHeaders(context));
+    }
+    acceptSelfProductEnrollment(context, product, body, opts) {
+        return this.postJson(`/account-holders/self/product-enrollments/${this.enc(product)}`, body, opts, undefined, memberSessionHeaders(context));
+    }
     selfBalance(context, control) {
         return this.getJson('/account-holders/self/balance', undefined, control, memberSessionHeaders(context));
     }
     listSelfWallets(context, control) {
         return this.getJson('/account-holders/self/wallets', undefined, control, memberSessionHeaders(context));
     }
+    selfWalletAuth(context, control) {
+        return this.postJson('/account-holders/self/wallet-auth', undefined, control, undefined, memberSessionHeaders(context));
+    }
     selfWalletReadiness(context, control) {
         return this.getJson('/account-holders/self/wallet-readiness', undefined, control, memberSessionHeaders(context));
     }
@@ -57,7 +70,7 @@ export class AccountHoldersResource extends Resource {
         }
         const readiness = status.action_readiness;
         if (!readiness ||
-            !['hosted_passkey', 'external_oidc'].includes(readiness.authorization_method) ||
+            !['hosted_passkey', 'external_oidc', 'xkova_webauthn'].includes(readiness.authorization_method) ||
             ![
                 'passkey_required',
                 'recovery_acknowledgement_required',
@@ -102,21 +115,31 @@ export class AccountHoldersResource extends Resource {
      * member context and cookies never follow the presigned URL or a redirect.
      */
     async uploadAvatar(id, image, control = {}) {
+        return this.uploadAvatarImage(image, control, {
+            presign: (body) => this.presignAvatarUpload(id, body, control),
+            confirm: (object_key) => this.confirmAvatar(id, { object_key }, control),
+            read: () => this.avatarUrl(id),
+        });
+    }
+    async uploadSelfAvatar(context, image, control = {}) {
+        return this.uploadAvatarImage(image, control, {
+            presign: (body) => this.presignSelfAvatarUpload(context, body, control),
+            confirm: (object_key) => this.confirmSelfAvatar(context, { object_key }, control),
+            read: () => this.selfAvatarUrl(context),
+        });
+    }
+    async uploadAvatarImage(image, control, operations) {
         if (!['image/png', 'image/jpeg', 'image/webp', 'image/gif'].includes(image.type) ||
             image.size === 0 ||
             image.size > 5 * 1024 * 1024) {
             throw new TypeError('Avatar must be a PNG, JPEG, WebP, or GIF image of at most 5 MiB');
         }
-        const upload = await this.presignAvatarUpload(id, {
-            content_type: image.type,
-            content_length: image.size,
-        }, control);
+        const upload = await operations.presign({ content_type: image.type, content_length: image.size });
         const target = new URL(upload.upload_url);
         if (target.username ||
             target.password ||
             target.hash ||
-            (target.protocol !== 'https:' &&
-                !(target.protocol === 'http:' && target.hostname === 'localhost')) ||
+            !isAllowedProtocol(target) ||
             !Number.isFinite(Date.parse(upload.expires_at)) ||
             Date.parse(upload.expires_at) <= Date.now()) {
             throw new XKOVAUploadError('The avatar upload capability is invalid or expired');
@@ -145,8 +168,20 @@ export class AccountHoldersResource extends Resource {
         }
         if (!response.ok)
             throw new XKOVAUploadError('Object storage rejected the avatar upload', response.status);
-        await this.confirmAvatar(id, { object_key: upload.object_key }, control);
-        return this.avatarUrl(id);
+        await operations.confirm(upload.object_key);
+        return operations.read();
+    }
+    selfAvatarUrl(context) {
+        return this.getJson('/account-holders/self/avatar', undefined, {}, memberSessionHeaders(context));
+    }
+    deleteSelfAvatar(context, opts) {
+        return this.deleteJson('/account-holders/self/avatar', opts, undefined, memberSessionHeaders(context));
+    }
+    confirmSelfAvatar(context, body, opts) {
+        return this.postJson('/account-holders/self/avatar/confirm', body, opts, undefined, memberSessionHeaders(context));
+    }
+    presignSelfAvatarUpload(context, body, opts) {
+        return this.postJson('/account-holders/self/avatar/upload-url', body, opts, undefined, memberSessionHeaders(context));
     }
     avatarUrl(id) {
         return this.getJson(`/account-holders/${this.enc(id)}/avatar`);

package/dist/resources/branding.d.ts

@@ -2,6 +2,8 @@ import { Resource, type ReqBody, type Query } from './base.js';
 import type { XKOVAMutationOptions } from '../client.js';
 export declare class BrandingResource extends Resource {
     get(): Promise<{
+        logo_upload_limits: import("../generated/types.js").components["schemas"]["LogoUploadLimits"];
+        has_logo_override: boolean;
         resolved: {
             brand_name: string;
             legal_name: string;
@@ -28,6 +30,8 @@ export declare class BrandingResource extends Resource {
         theme: import("../generated/types.js").components["schemas"]["TenantBrandingTheme"];
     }>;
     upsert(body: ReqBody<'upsertBranding'>, opts?: XKOVAMutationOptions): Promise<{
+        logo_upload_limits: import("../generated/types.js").components["schemas"]["LogoUploadLimits"];
+        has_logo_override: boolean;
         resolved: {
             brand_name: string;
             legal_name: string;
@@ -94,12 +98,16 @@ export declare class BrandingResource extends Resource {
         last_synced_at: string;
         created_at: string;
     }>;
+    /** Upload bytes to the returned URL, then confirm its opaque key as the same tenant. */
     logoUploadUrl(body: ReqBody<'brandingLogoUploadUrl'>, opts?: XKOVAMutationOptions): Promise<{
         upload_url: string;
         object_key: string;
         expires_at: string;
     }>;
+    /** Publish a newly issued upload. Saved logo URLs or keys are not upload keys. */
     confirmLogo(body: ReqBody<'confirmBrandingLogo'>, opts?: XKOVAMutationOptions): Promise<{
+        logo_upload_limits: import("../generated/types.js").components["schemas"]["LogoUploadLimits"];
+        has_logo_override: boolean;
         resolved: {
             brand_name: string;
             legal_name: string;
@@ -126,6 +134,8 @@ export declare class BrandingResource extends Resource {
         theme: import("../generated/types.js").components["schemas"]["TenantBrandingTheme"];
     }>;
     deleteLogo(opts?: XKOVAMutationOptions): Promise<{
+        logo_upload_limits: import("../generated/types.js").components["schemas"]["LogoUploadLimits"];
+        has_logo_override: boolean;
         resolved: {
             brand_name: string;
             legal_name: string;

package/dist/resources/branding.js

@@ -22,9 +22,11 @@ export class BrandingResource extends Resource {
     verifyEmailDomain(id, opts) {
         return this.postJson(`/branding/email-domains/${this.enc(id)}/verify`, undefined, opts);
     }
+    /** Upload bytes to the returned URL, then confirm its opaque key as the same tenant. */
     logoUploadUrl(body, opts) {
         return this.postJson('/branding/logo/upload-url', body, opts);
     }
+    /** Publish a newly issued upload. Saved logo URLs or keys are not upload keys. */
     confirmLogo(body, opts) {
         return this.postJson('/branding/logo', body, opts);
     }

package/dist/resources/contacts.d.ts

@@ -46,8 +46,8 @@ export declare class ContactsResource extends Resource {
         updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
     }>;
     delete(id: string, query: Query<'deleteContact'>, opts?: XKOVAMutationOptions): Promise<void>;
-    /** Look up a contact by email or phone hash. */
-    search(body: ReqBody<'searchContacts'>, opts?: XKOVAMutationOptions): Promise<{
+    /** Look up contacts with optional cursor pagination. */
+    search(body: ReqBody<'searchContacts'>, opts?: XKOVAMutationOptions, query?: Query<'searchContacts'>): Promise<{
         data: import("../generated/types.js").components["schemas"]["Contact"][];
         next_cursor?: string | null;
         has_more: boolean;

package/dist/resources/contacts.js

@@ -15,8 +15,8 @@ export class ContactsResource extends Resource {
     delete(id, query, opts) {
         return this.deleteJson(`/contacts/${this.enc(id)}`, opts, query);
     }
-    /** Look up a contact by email or phone hash. */
-    search(body, opts) {
-        return this.postJson('/contacts/search', body, opts);
+    /** Look up contacts with optional cursor pagination. */
+    search(body, opts, query = {}) {
+        return this.postJson('/contacts/search', body, opts, query);
     }
 }

package/dist/resources/escrows.d.ts

@@ -7,6 +7,7 @@ export declare class EscrowsResource extends Resource {
         has_more: boolean;
     }>;
     create(body: ReqBody<'createEscrow'>, opts?: XKOVAMutationOptions): Promise<{
+        notification_status?: "queued" | "sent" | "failed" | "cancelled";
         escrow: import("../generated/types.js").components["schemas"]["Escrow"];
         claim_token: string;
         claim_url: string;
@@ -15,6 +16,7 @@ export declare class EscrowsResource extends Resource {
         signing_expires_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
     }>;
     retrieve(id: string, query?: Query<'getEscrow'>): Promise<{
+        notification_status?: "queued" | "sent" | "failed" | "cancelled";
         id: import("../generated/types.js").components["schemas"]["EscrowId"];
         chain: import("../generated/types.js").components["schemas"]["ChainDescriptor"];
         fingerprint: string;
@@ -28,6 +30,7 @@ export declare class EscrowsResource extends Resource {
         on_chain_payment_id?: string | null;
         create_tx_hash?: string | null;
         release_tx_hash?: string | null;
+        data_freshness?: import("../generated/types.js").components["schemas"]["DataFreshness"][];
         fee_accruals?: import("../generated/types.js").components["schemas"]["EscrowFeeAccrual"][];
         net_amount?: import("../generated/types.js").components["schemas"]["Money"] | null;
         claimed_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;

package/dist/resources/payment-requests.d.ts

@@ -11,6 +11,7 @@ export declare class PaymentRequestsResource extends Resource {
         has_more: boolean;
     }>;
     create(body: ReqBody<'createPaymentRequest'>, opts?: XKOVAMutationOptions): Promise<{
+        notification_status?: "queued" | "sent" | "failed" | "cancelled";
         id?: import("../generated/types.js").components["schemas"]["PaymentRequestId"];
         requester_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"];
         payer_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"] | null;
@@ -26,6 +27,7 @@ export declare class PaymentRequestsResource extends Resource {
         updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
     }>;
     retrieve(id: string): Promise<{
+        notification_status?: "queued" | "sent" | "failed" | "cancelled";
         id?: import("../generated/types.js").components["schemas"]["PaymentRequestId"];
         requester_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"];
         payer_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"] | null;
@@ -82,6 +84,7 @@ export declare class PaymentRequestsResource extends Resource {
         finalized_at: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
     }>;
     cancel(id: string, opts?: XKOVAMutationOptions): Promise<{
+        notification_status?: "queued" | "sent" | "failed" | "cancelled";
         id?: import("../generated/types.js").components["schemas"]["PaymentRequestId"];
         requester_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"];
         payer_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"] | null;
@@ -97,6 +100,7 @@ export declare class PaymentRequestsResource extends Resource {
         updated_at?: import("../generated/types.js").components["schemas"]["TimestampUtc"];
     }>;
     decline(id: string, body?: ReqBody<'declinePaymentRequest'>, opts?: XKOVAMutationOptions): Promise<{
+        notification_status?: "queued" | "sent" | "failed" | "cancelled";
         id?: import("../generated/types.js").components["schemas"]["PaymentRequestId"];
         requester_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"];
         payer_id?: import("../generated/types.js").components["schemas"]["AccountHolderId"] | null;

package/dist/resources/payments.d.ts

@@ -178,5 +178,18 @@ export declare class PaymentsResource extends Resource {
         created_at: import("../generated/types.js").components["schemas"]["TimestampUtc"];
         finalized_at: import("../generated/types.js").components["schemas"]["TimestampUtc"] | null;
     }>;
+    /** Requires a resolved member session. Only the sender can continue or cancel. */
+    recovery(id: string): Promise<{
+        payment: import("../generated/types.js").components["schemas"]["Payment"];
+        state: "awaiting_approval" | "approval_expired" | "on_hold" | "processing" | "completed" | "cancelled" | "failed";
+        can_continue: boolean;
+        can_cancel: boolean;
+    }>;
+    cancelForMember(id: string, opts?: XKOVAMutationOptions): Promise<{
+        payment: import("../generated/types.js").components["schemas"]["Payment"];
+        state: "awaiting_approval" | "approval_expired" | "on_hold" | "processing" | "completed" | "cancelled" | "failed";
+        can_continue: boolean;
+        can_cancel: boolean;
+    }>;
 }
 export {};

package/dist/resources/payments.js

@@ -30,4 +30,11 @@ export class PaymentsResource extends Resource {
     cancel(id, opts) {
         return this.postJson(`/payments/${this.enc(id)}/cancel`, undefined, opts);
     }
+    /** Requires a resolved member session. Only the sender can continue or cancel. */
+    recovery(id) {
+        return this.getJson(`/account-holders/self/payments/${this.enc(id)}/recovery`);
+    }
+    cancelForMember(id, opts) {
+        return this.postJson(`/account-holders/self/payments/${this.enc(id)}/cancel`, undefined, opts);
+    }
 }