@settlemint/dalp-sdk 3.1.18-main.33808370488 → 3.1.18

package/dist/platform.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Combined DALP platform client factory.
+ *
+ * Related: kit/sdk/src/client.ts, kit/sdk/src/auth.ts
+ *
+ * @module
+ */
+import { type DalpAuthClient } from "./auth.js";
+import { DalpCookieStore } from "./cookie-store.js";
+import type { DalpClient, DalpClientConfig } from "./types.js";
+export interface DalpPlatformClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /** API key used by the DAPI client and, by default, the auth client. */
+    apiKey?: string;
+    /** Organization ID sent to both DAPI and auth operations when provided. */
+    organizationId?: string;
+    /** Headers merged into DAPI requests. */
+    headers?: DalpClientConfig["headers"];
+    /** Headers merged into Better Auth requests. */
+    authHeaders?: Record<string, string>;
+    /** Better Auth session token sent as an Authorization bearer token. */
+    sessionToken?: string;
+    /** Initial cookie header for Better Auth session handoff. */
+    cookie?: string;
+    /** Existing cookie store to reuse across platform clients. */
+    cookieStore?: DalpCookieStore;
+    /** Validate outgoing DAPI requests against the contract before sending. */
+    requestValidation?: boolean;
+    /** Validate incoming DAPI responses against the contract. */
+    responseValidation?: boolean;
+    /** Custom `fetch` implementation for both DAPI and Better Auth clients. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface DalpPlatformClient {
+    dapi: DalpClient;
+    auth: DalpAuthClient;
+    cookieStore: DalpCookieStore;
+}
+export declare function createDalpPlatformClient(config: DalpPlatformClientConfig): DalpPlatformClient;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AAEvF,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yCAAyC;IACzC,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAEtC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAyB7F"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Optional oRPC link plugins for advanced SDK usage.
+ *
+ * These are thin re-exports with JSDoc guidance. Import from
+ * `@settlemint/dalp-sdk/plugins` to keep the main entry point lean.
+ *
+ * Related: kit/sdk/src/client.ts
+ *
+ * @module
+ */
+export { RequestValidationPlugin, ResponseValidationPlugin } from "@orpc/contract/plugins";
+export { BatchLinkPlugin } from "@orpc/client/plugins";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,10 @@
+import"../chunk-xm8h1dzh.js";
+
+// src/plugins/index.ts
+import { RequestValidationPlugin, ResponseValidationPlugin } from "@orpc/contract/plugins";
+import { BatchLinkPlugin } from "@orpc/client/plugins";
+export {
+  ResponseValidationPlugin,
+  RequestValidationPlugin,
+  BatchLinkPlugin
+};

package/dist/sdk-error.d.ts

@@ -0,0 +1,74 @@
+import { ORPCError } from "@orpc/client";
+import type { DapiErrorId, DapiPublicError } from "./dapi-errors.js";
+interface DalpOrpcErrorJson {
+    readonly defined: true;
+    readonly code: string;
+    readonly status: number;
+    readonly message: string;
+    readonly data: {
+        readonly id: string;
+        readonly category: string;
+        readonly retryable: boolean;
+        readonly why: string;
+        readonly fix: string;
+        readonly requestId?: string;
+        readonly retryAfterSeconds?: unknown;
+        readonly [key: string]: unknown;
+    };
+}
+export interface DalpSdkErrorOptions {
+    code?: string;
+    id?: DapiErrorId;
+    category: string;
+    status?: number;
+    retryable: boolean;
+    message: string;
+    why: string;
+    fix: string;
+    details?: Record<string, unknown>;
+    dapiError?: DapiPublicError;
+    /** Full ORPC `data` from the wire, including typed route/contract fields. */
+    orpcData?: Record<string, unknown>;
+    /**
+     * Seconds the server asks the client to wait before retrying, decoded from a
+     * `Retry-After`-bearing error (e.g. `INDEXER_REINDEXING`). Present only when
+     * the error carried the value; never a default.
+     */
+    retryAfterSeconds?: number;
+    cause?: unknown;
+}
+export interface DalpSdkConfigurationErrorInput {
+    message: string;
+    why: string;
+    fix: string;
+    cause?: unknown;
+}
+export type DalpSdkErrorJson = ReturnType<ORPCError<string, DapiPublicError | undefined>["toJSON"]> & {
+    id?: DapiErrorId;
+    category: string;
+    retryable: boolean;
+    why: string;
+    fix: string;
+    details?: Record<string, unknown>;
+    retryAfterSeconds?: number;
+};
+export declare class DalpSdkError extends ORPCError<string, DapiPublicError | undefined> {
+    readonly id?: DapiErrorId;
+    readonly category: string;
+    readonly retryable: boolean;
+    readonly why: string;
+    readonly fix: string;
+    readonly details?: Record<string, unknown>;
+    readonly dapiError?: DapiPublicError;
+    readonly retryAfterSeconds?: number;
+    constructor(options: DalpSdkErrorOptions);
+    toJSON(): DalpSdkErrorJson;
+}
+export declare function createDalpSdkConfigurationError(input: DalpSdkConfigurationErrorInput): DalpSdkError;
+export declare function createDalpSdkErrorFromOrpcJson(parsed: DalpOrpcErrorJson, cause?: unknown, retryAfterSeconds?: number): DalpSdkError;
+export declare function createDalpSdkErrorFromDapiPublicError(error: DapiPublicError, cause?: unknown, retryAfterSeconds?: number): DalpSdkError;
+export declare function decodeDapiErrorResponseBody(body: unknown): DalpSdkError | null;
+export declare function getDapiPublicErrorFromResponseBody(body: unknown): DapiPublicError | undefined;
+export declare function isDapiPublicError(value: unknown): value is DapiPublicError;
+export {};
+//# sourceMappingURL=sdk-error.d.ts.map

package/dist/sdk-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-error.d.ts","sourceRoot":"","sources":["../src/sdk-error.ts"],"names":[],"mappings":"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"}

package/dist/serializers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Custom JSON serializers for oRPC wire format.
+ *
+ * Vendored from @core/validation to avoid pulling in heavy transitive
+ * dependencies (viem, date-fns, iso-3166). Only the serializer objects
+ * are included — not the Zod schemas or helper functions.
+ *
+ * Related: packages/core/validation/src/bigdecimal.ts,
+ *          packages/core/validation/src/bigint.ts,
+ *          packages/core/validation/src/timestamp.ts
+ *
+ * @module
+ */
+import type { StandardRPCCustomJsonSerializer } from "@orpc/client/standard";
+/**
+ * Serializer for arbitrary-precision decimal values (dnum).
+ *
+ * Encodes `Dnum` values as locale-independent decimal strings on the wire
+ * and decodes them back into `Dnum` tuples on the receiving side.
+ */
+export declare const bigDecimalSerializer: StandardRPCCustomJsonSerializer;
+/**
+ * Serializer for native `bigint` values.
+ *
+ * Encodes bigints as decimal strings on the wire since JSON does not
+ * support the `bigint` primitive natively.
+ */
+export declare const bigIntSerializer: StandardRPCCustomJsonSerializer;
+/**
+ * Serializer for `Date` objects.
+ *
+ * Encodes dates as ISO-8601 strings on the wire and reconstructs
+ * `Date` instances on deserialization.
+ */
+export declare const timestampSerializer: StandardRPCCustomJsonSerializer;
+/**
+ * All DALP custom JSON serializers, pre-configured for use with
+ * `RPCLink` or `RPCHandler` `customJsonSerializers` option.
+ */
+export declare const dalpSerializers: readonly StandardRPCCustomJsonSerializer[];
+//# sourceMappingURL=serializers.d.ts.map

package/dist/serializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../src/serializers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAqD7E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,+BA6BlC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,+BAK9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,+BAKjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,+BAA+B,EAIrE,CAAC"}

package/dist/types.d.ts

@@ -1,73 +1,110 @@
 /**
- * Generated request, response, and model types for the v2 surface.
+ * Type-only exports for the DALP SDK.
  *
- * Type-only by construction — the emitted JavaScript is empty, so a consumer
- * that imports only types pays nothing at runtime. The dist completeness
- * graph accepts that empty file when `dist/types.d.ts` is present.
+ * Import from `@settlemint/dalp-sdk/types` when you only need types
+ * (e.g., for function signatures) without pulling in runtime code.
+ *
+ * Related: kit/sdk/src/client.ts
  *
  * @module
  */
-import type { AssumableParticipant, EvmAddress, TokenFeatureDividendYield as TokenFeatureDividendYieldWire, TokenFeatureExternalTransactionFee as TokenFeatureExternalTransactionFeeWire, TokenFeatureFixedTreasuryYield as TokenFeatureFixedTreasuryYieldWire, TokenFeatureHistoricalBalances as TokenFeatureHistoricalBalancesWire, TokenFeatureInterestYield as TokenFeatureInterestYieldWire, TokenFeatureMaturityRedemption as TokenFeatureMaturityRedemptionWire, TokenFeatureTransactionFee as TokenFeatureTransactionFeeWire, TokenFeatureTransactionFeeAccounting as TokenFeatureTransactionFeeAccountingWire, TokenDocumentGetUploadUrlBody, TokenTopicScheme, TokenTrustedIssuer, ThemeLogoUpload, EvmUserEventV2Item, UserEventV2Item, UserEventV2ItemCollectionResponse, UserMe, participantsMultisigDrafts_createInvite_Response, token_create_Request, system_feeds_issuerSigned_create_Request, tokenTopicSchemes_create_Request, tokenTrustedIssuers_create_Request } from "./generated/api-types.d.ts";
-/** Participant kinds returned by the participant search surface. */
-export type ParticipantKind = "person" | "company" | "fund" | "spv" | "department" | "joint_account" | "asset" | "organisation" | "claim_issuer" | "addon";
-/** Address projection requested from participant search. */
-export type ParticipantAddressPurpose = "transfer" | "identity" | "participant";
-/** Token eligibility filter accepted by participant search. */
-export interface EligibleForTokenFilter {
-    readonly tokenAddress: EvmAddress;
-    readonly action: "mint" | "transfer" | "burn";
-    readonly reveal?: boolean;
-}
-/** Current ability to act as an assumable participant. */
-export type ActAvailability = AssumableParticipant["actAvailability"];
-/** Stable onboarding flags returned with the current user. */
-export type OnboardingState = UserMe["onboardingState"];
+import type { ContractRouterClient } from "@orpc/contract";
+import type { JsonifiedClient } from "@orpc/openapi-client";
+import type { rpcContract } from "./contract.js";
 /**
- * One row of the authenticated user's event feed, on whichever ledger produced it.
+ * Fully typed DALP API client.
  *
- * Discriminated on `family`. Narrow before reading anything else: `blockNumber`,
- * `transactionHash`, `gasUsed` and `gasPrice` exist only on the `evm` arm, and
- * `ledgerOffset`, `updateId` and `nodeId` only on the `canton` one.
+ * Uses `JsonifiedClient` because the SDK communicates via the OpenAPI/REST
+ * endpoint where values are serialized as standard JSON (e.g., Date → string,
+ * BigInt → string).
+ *
+ * Provides auto-completed access to all v2 API namespaces:
+ * `account`, `actions`, `addons`, `admin`, `contacts`, `exchangeRates`,
+ * `externalToken`, `identityRecovery`, `monitoring`, `search`,
+ * `settings`, `system`, `token`, `transaction`, `user`.
  */
-export type UserEvent = UserEventV2Item;
-/** The `evm` arm of {@link UserEvent}: one indexed contract event. */
-export type EvmUserEvent = EvmUserEventV2Item;
-/** One page of the authenticated user's event feed, across both chain families. */
-export type UserEventCollectionResponse = UserEventV2ItemCollectionResponse;
-/** One decoded name/value entry attached to a user activity event. */
-export type UserEventValue = NonNullable<EvmUserEvent["values"]>[number];
-/** Registry tier from which a topic scheme was inherited. */
-export type TokenTopicSchemeInheritanceLevel = TokenTopicScheme["inheritanceLevel"];
-/** Registry tier from which a trusted issuer was inherited. */
-export type TokenTrustedIssuerInheritanceLevel = TokenTrustedIssuer["inheritanceLevel"];
-/** Body accepted when a token-level topic scheme is created. */
-export type TokenTopicSchemeCreateInput = tokenTopicSchemes_create_Request;
-/** Body accepted when a token-level trusted issuer is created. */
-export type TokenTrustedIssuerCreateInput = tokenTrustedIssuers_create_Request;
-/** Successful token returned when a multisig invite is created. */
-export type MultisigDraftCreateInviteOutput = participantsMultisigDrafts_createInvite_Response;
-/** Body accepted when an issuer-signed scalar feed is created. */
-export type IssuerSignedCreateInput = system_feeds_issuerSigned_create_Request;
-/** Image slot accepted by the theme logo upload endpoints. */
-export type ThemeLogoMode = ThemeLogoUpload["mode"];
-/** Config carried by an attached historical-balances feature. */
-export type TokenFeatureHistoricalBalancesConfig = NonNullable<TokenFeatureHistoricalBalancesWire>;
-/** Config carried by an attached maturity-redemption feature. */
-export type TokenFeatureMaturityRedemptionConfig = NonNullable<TokenFeatureMaturityRedemptionWire>;
-/** Config carried by an attached fixed-treasury-yield feature. */
-export type TokenFeatureFixedTreasuryYieldConfig = NonNullable<TokenFeatureFixedTreasuryYieldWire>;
-/** Config carried by an attached dividend-yield feature. */
-export type TokenFeatureDividendYieldConfig = NonNullable<TokenFeatureDividendYieldWire>;
-/** Config carried by an attached interest-yield feature. */
-export type TokenFeatureInterestYieldConfig = NonNullable<TokenFeatureInterestYieldWire>;
-/** Config carried by an attached transaction-fee feature. */
-export type TokenFeatureTransactionFeeConfig = NonNullable<TokenFeatureTransactionFeeWire>;
-/** Config carried by an attached transaction-fee-accounting feature. */
-export type TokenFeatureTransactionFeeAccountingConfig = NonNullable<TokenFeatureTransactionFeeAccountingWire>;
-/** Config carried by an attached external-transaction-fee feature. */
-export type TokenFeatureExternalTransactionFeeConfig = NonNullable<TokenFeatureExternalTransactionFeeWire>;
-/** MIME type accepted by token-document upload endpoints. */
-export type TokenDocumentMimeType = TokenDocumentGetUploadUrlBody["mimeType"];
-/** Body accepted by the token-create endpoint. */
-export type TokenCreateInput = token_create_Request;
-export type * from "./generated/api-types.d.ts";
+export type DalpClient = JsonifiedClient<ContractRouterClient<typeof rpcContract, DalpClientCallContext>>;
+/**
+ * Per-call client context threaded into individual SDK operations as the second
+ * argument, e.g. `client.token.create(input, { context: { idempotencyKey } })`.
+ * Every field is optional and scoped to the single call, unlike the client-level
+ * {@link BaseDalpClientConfig.idempotencyKey} which applies to every request.
+ */
+export interface DalpClientCallContext {
+    /**
+     * Idempotency key sent as the `Idempotency-Key` header for this call only,
+     * overriding any client-level key. Use a fresh value per genuine retry of a
+     * failed mutation: dapi burns the key of a failed transaction, so re-sending
+     * under the same key is rejected ("previously failed. Use a new idempotency
+     * key to retry"). A stable value within one logical attempt keeps network-level
+     * fetch retries deduplicated.
+     */
+    idempotencyKey?: string;
+    /**
+     * oRPC error codes the caller treats as expected for this call and does not
+     * want surfaced by its own error logging (e.g. an existence probe that accepts
+     * `NOT_FOUND`). A client-side hint scoped to the single call; it is not sent to
+     * the server.
+     */
+    skipLoggingFor?: readonly string[];
+}
+interface BaseDalpClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /**
+     * Organization ID for multi-tenant setups.
+     * Required when the API key is scoped to multiple organizations.
+     */
+    organizationId?: string;
+    /**
+     * Additional headers merged into every request.
+     * Accepts a static object or a (possibly async) function for dynamic headers.
+     * Can override defaults like `User-Agent` but cannot override security headers (`x-api-key`, `x-organization-id`).
+     */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /**
+     * Validate outgoing requests against the contract before sending.
+     * Catches schema violations client-side for faster feedback.
+     * @defaultValue false
+     */
+    requestValidation?: boolean;
+    /**
+     * Validate incoming responses against the contract.
+     * Useful during development to catch API drift.
+     * @defaultValue false
+     */
+    responseValidation?: boolean;
+    /**
+     * Custom `fetch` implementation.
+     * Use this to inject logging, proxy configuration, or test doubles.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Idempotency key sent as the `Idempotency-Key` header on every request.
+     *
+     * **Warning:** This value is sent on _every_ request made by the client.
+     * If you reuse the same client instance for multiple mutations, the server
+     * will deduplicate all but the first — subsequent mutations silently return
+     * the first response. Only set this when the client is used for a single
+     * mutation (e.g., a one-shot script). For multi-mutation workflows, set the
+     * header per-request via the `headers` callback instead.
+     *
+     * When omitted, no idempotency key header is sent.
+     */
+    idempotencyKey?: string;
+}
+/**
+ * Configuration for creating an authenticated DALP API client.
+ */
+export interface DalpClientConfig extends BaseDalpClientConfig {
+    /** API key for authenticated routes (issued via the DALP dashboard or CLI). */
+    apiKey: string;
+}
+/**
+ * Configuration for creating a public DALP API client.
+ */
+export interface PublicDalpClientConfig extends BaseDalpClientConfig {
+    apiKey?: undefined;
+}
+export type { WalletAuthEndpointPath } from "./auth-wallet-plugins.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,oBAAoB,CAAC,OAAO,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAE1G;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,UAAU,oBAAoB;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEpG;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/url.d.ts

@@ -1 +1,2 @@
 export declare function normalizeDalpBaseUrl(url: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AASA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBxD"}

package/dist/verify-webhook.d.ts

@@ -1,23 +1,34 @@
-import type { Webhook } from "./webhook-events.ts";
-export type WebhookVerificationFailure = "TIMESTAMP_SKEW" | "SECRET_MISMATCH" | "BODY_HASH_MISMATCH" | "REPLAYED_EVENT" | "MALFORMED_BODY" | "REPLAY_STORE_FAILURE";
+import type { Webhook } from "./webhook-events.js";
+export type WebhookVerificationFailure = "TIMESTAMP_SKEW" | "SECRET_MISMATCH" | "BODY_HASH_MISMATCH";
 export type WebhookVerificationResult = {
-    readonly ok: true;
-    readonly event: Webhook.Event;
+    ok: true;
+    event: Webhook.Event;
 } | {
-    readonly ok: false;
-    readonly code: WebhookVerificationFailure;
+    ok: false;
+    code: WebhookVerificationFailure;
 };
-export interface WebhookReplayStore {
-    readonly has: (eventId: string) => boolean | Promise<boolean>;
-    readonly add: (eventId: string) => void | Promise<void>;
-}
 export interface VerifyWebhookInput {
-    readonly rawBody: string | Uint8Array;
-    readonly headers: Headers | Record<string, string | ReadonlyArray<string> | undefined>;
-    readonly secret: string | ReadonlyArray<string>;
-    readonly replayStore?: WebhookReplayStore;
-    readonly now?: number | Date;
-    readonly timestampToleranceSeconds?: number;
+    rawBody: string | Uint8Array;
+    headers: Headers | Record<string, string | string[] | undefined>;
+    secret: string | readonly string[];
 }
+/**
+ * Strip the `dalp_whsk_` family prefix from a DALP signing secret.
+ *
+ * The Standard Webhooks library expects the bare secret material; DALP
+ * adds the prefix for parity with the `sm_dalp_` API-key family. Both
+ * the dispatcher (DALP-side) and any verifier (DALP or consumer) must
+ * call this before constructing a `new Webhook(...)` instance, otherwise
+ * the HMAC inputs differ on the two ends and every signature mismatches.
+ */
 export declare function toStandardWebhookSecret(secret: string): string;
-export declare function verifyWebhook(input: VerifyWebhookInput): Promise<WebhookVerificationResult>;
+/**
+ * Verifies a DALP webhook signature and returns the typed event union.
+ *
+ * Use the returned lifecycle state and `supersedes` accessor to reconcile
+ * cached DAPI mutation responses with later on-chain outcomes.
+ *
+ * @see ../../kit/docs/content/events/idempotency-and-on-chain-outcome.mdx
+ */
+export declare function verifyWebhook({ rawBody, headers, secret }: VerifyWebhookInput): WebhookVerificationResult;
+//# sourceMappingURL=verify-webhook.d.ts.map

package/dist/verify-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-webhook.d.ts","sourceRoot":"","sources":["../src/verify-webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAErG,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACjE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACpC;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,kBAAkB,GAAG,yBAAyB,CAkBzG"}

package/dist/version.d.ts

@@ -2,3 +2,4 @@
 export declare const SDK_VERSION: string;
 /** Default User-Agent header sent with every SDK request. */
 export declare const SDK_USER_AGENT: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAYA,mDAAmD;AACnD,eAAO,MAAM,WAAW,EAAE,MAA4B,CAAC;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,cAAc,QAA6B,CAAC"}

package/dist/wait-for-transaction.d.ts

@@ -1,67 +1,94 @@
-import type { DalpClient } from "./proxy/client.ts";
-import type { EvmTransactionStatusOutput } from "./generated/api-types.d.ts";
-export interface WaitForTransactionContractError {
-    readonly id: string;
-    readonly args: Readonly<Record<string, string>>;
-    readonly why: string;
-    readonly message: string;
-    readonly fix?: string;
+/**
+ * Bounded wait-until-terminal barrier for queued DALP mutations.
+ *
+ * A v2 mutation may return a `202`-style async-accepted envelope when its
+ * synchronous wait window elapses while the execution workflow is still
+ * confirming. `waitForTransaction` turns that into a deterministic outcome:
+ * poll the transaction status route at a FIXED interval bounded by a wall-clock
+ * deadline, resolve on a terminal success, throw a typed error on a terminal
+ * failure, and throw a loud timeout error if the deadline elapses first.
+ *
+ * This is a determinism barrier, not a masking retry — total wait is bounded by
+ * `timeoutMs` (never exponential), and a never-terminating transaction fails
+ * loud and bounded instead of hanging.
+ *
+ * Related: kit/sdk/src/types.ts
+ * Related: packages/dalp/api-contract/src/routes/transaction/routes/transaction.status.schema.ts
+ *
+ * @module
+ */
+import type { DalpClient } from "./types.js";
+/** Outcome shape returned by the transaction status route, narrowed to the fields this helper reads. */
+export interface WaitForTransactionResult {
+    readonly tokenAddress?: unknown;
 }
 export interface WaitForTransactionStatus {
-    readonly transactionId: string;
-    readonly status: string;
-    readonly subStatus: string | null;
-    readonly transactionHash: string | null;
-    readonly errorMessage: string | null;
-    readonly contractError?: WaitForTransactionContractError | null;
-    readonly result?: WaitForTransactionResult;
-    /** The open funding ask a write parked by the funding gate is waiting on. */
-    readonly activeRequirement?: EvmTransactionStatusOutput["activeRequirement"];
-}
-/** Kind-scoped terminal result from the generated transaction status contract. */
-export type WaitForTransactionResult = NonNullable<EvmTransactionStatusOutput["result"]>;
-export interface WaitForTransactionSuccess extends WaitForTransactionStatus {
-    readonly status: "COMPLETED";
+    transactionId: string;
+    status: string;
+    subStatus: string | null;
+    transactionHash: string | null;
+    errorMessage: string | null;
+    result?: WaitForTransactionResult;
 }
 export interface WaitForTransactionOptions {
-    readonly timeoutMs?: number;
-    readonly pollIntervalMs?: number;
-    readonly signal?: AbortSignal;
-    readonly onStatus?: (status: WaitForTransactionStatus) => void;
+    /** Wall-clock ceiling for the whole wait, in milliseconds. Default 120_000. */
+    timeoutMs?: number;
+    /** Fixed delay between status polls, in milliseconds. Default 2_000. */
+    intervalMs?: number;
+    /**
+     * Resolve (instead of continuing to poll) when the transaction reaches
+     * `PENDING_APPROVAL` — an external approval gate (DFNS / Fireblocks) that is
+     * not a stall and may legitimately outlast the deadline. Default `true`.
+     */
+    resolveOnPendingApproval?: boolean;
     /**
-     * Whether the wait outlasts a funding pause. True, the default, restarts the
-     * timeout on every status that reports an open funding ask, so the wait ends
-     * only when the ask is paid or the platform fails the request. False ends
-     * the wait on the first such status with reason `funding-paused`, for a
-     * caller that shows the write as pending and lets the payment land on its
-     * own time.
+     * Cancels the wait when the owning context (React component, request handler,
+     * workflow step) is torn down. An aborted signal stops the loop on the next
+     * iteration, cancels the in-flight status request, and surfaces as a
+     * {@link DalpTransactionWaitError} with `reason: "aborted"`.
      */
-    readonly holdWhilePaused?: boolean;
-    readonly now?: () => number;
-    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
-    readonly readStatus?: (transactionId: string, signal?: AbortSignal) => Promise<WaitForTransactionStatus>;
+    signal?: AbortSignal;
 }
-export type TransactionWaitFailureReason = "terminal-failure" | "timeout" | "aborted" | "funding-paused";
+/**
+ * Thrown when a transaction reaches a terminal failure state
+ * (`FAILED` / `DEAD_LETTER` / `CANCELLED`), does not reach any terminal state
+ * within the deadline (`reason: "timeout"`), or the caller's `AbortSignal`
+ * fires (`reason: "aborted"`).
+ */
 export declare class DalpTransactionWaitError extends Error {
-    readonly code = "sdk.transaction.WAIT_FAILED";
-    readonly category: "operational";
     readonly transactionId: string;
-    readonly reason: TransactionWaitFailureReason;
-    readonly lastStatus?: WaitForTransactionStatus;
-    readonly elapsedMs?: number;
-    constructor(transactionId: string, reason: TransactionWaitFailureReason, lastStatus?: WaitForTransactionStatus, elapsedMs?: number);
-    get status(): string;
-    get subStatus(): string | null;
-    get retryable(): boolean;
+    readonly status: string;
+    readonly subStatus: string | null;
+    readonly reason: "terminal-failure" | "timeout" | "aborted";
+    readonly lastStatus: WaitForTransactionStatus | undefined;
+    constructor(options: {
+        message: string;
+        transactionId: string;
+        status: string;
+        subStatus: string | null;
+        reason: "terminal-failure" | "timeout" | "aborted";
+        lastStatus?: WaitForTransactionStatus;
+        cause?: unknown;
+    });
 }
-export declare const isDalpTransactionWaitError: (error: unknown) => error is DalpTransactionWaitError;
 /**
- * Poll transaction status until a terminal verdict, timeout, or abort.
+ * Poll the transaction status route until the transaction reaches a terminal
+ * state or the deadline elapses.
+ *
+ * - `COMPLETED` → resolves with the final status (the handler already waited for
+ *   the indexer drain, so this is a true read-after-write guarantee).
+ * - `FAILED` / `DEAD_LETTER` / `CANCELLED` → throws {@link DalpTransactionWaitError}
+ *   (`reason: "terminal-failure"`) carrying `status`, `subStatus`, and
+ *   `errorMessage` — fail fast, do not keep polling.
+ * - `PENDING_APPROVAL` → resolves as pending (when `resolveOnPendingApproval`,
+ *   the default) so an external approval gate is never treated as a stall.
+ * - deadline elapsed → throws {@link DalpTransactionWaitError} (`reason: "timeout"`)
+ *   carrying the last observed status — a loud, bounded failure, never an
+ *   indefinite hang.
  *
- * The timeout measures the platform's progress. A status that reports an
- * open funding ask restarts it, so a write parked on an operator payment is
- * never reported as a timeout and a resumed write gets its whole budget back.
- * `holdWhilePaused: false` ends the wait on that status instead. The
- * `elapsedMs` a timeout carries is the whole wait, pauses included.
+ * @param client A DALP API client.
+ * @param transactionId The queue transaction identifier (UUIDv7) returned in the
+ *   async-accepted envelope.
  */
-export declare function waitForTransaction(client: DalpClient, transactionId: string, options?: WaitForTransactionOptions): Promise<WaitForTransactionSuccess>;
+export declare function waitForTransaction(client: DalpClient, transactionId: string, options?: WaitForTransactionOptions): Promise<WaitForTransactionStatus>;
+//# sourceMappingURL=wait-for-transaction.d.ts.map

package/dist/wait-for-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-transaction.d.ts","sourceRoot":"","sources":["../src/wait-for-transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiB7C,wGAAwG;AACxG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAE1D,YAAY,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;QACnD,UAAU,CAAC,EAAE,wBAAwB,CAAC;QACtC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,EAQA;CACF;AA0BD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAsFnC"}