@settlemint/dalp-sdk 3.1.26-main.37116470199 → 3.1.26

package/dist/{auth/permissions.d.ts → auth-permissions.d.ts}

@@ -1,5 +1,13 @@
+/**
+ * Client-side Better Auth access-control metadata for DALP auth clients.
+ *
+ * Related: packages/dalp/auth/src/utils/permissions.ts, kit/sdk/src/auth.ts
+ *
+ * @module
+ */
 import { type AccessControl, type Role } from "better-auth/plugins/access";
 export declare const accessControl: AccessControl;
 export declare const adminRole: Role;
 export declare const ownerRole: Role;
 export declare const memberRole: Role;
+//# sourceMappingURL=auth-permissions.d.ts.map

package/dist/auth-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-permissions.d.ts","sourceRoot":"","sources":["../src/auth-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,IAAI,EAAuB,MAAM,4BAA4B,CAAC;AAuBhG,eAAO,MAAM,aAAa,EAAE,aAI1B,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,IAOtB,CAAC;AAEH,eAAO,MAAM,SAAS,EAAE,IAMtB,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,IAKvB,CAAC"}

package/dist/{auth/wallet-plugins.d.ts → auth-wallet-plugins.d.ts}

@@ -1,68 +1,3 @@
-import type { DalpAuthResult } from "./client.ts";
-export type WalletAuthOperation<TInput, TData> = (input: TInput, options?: unknown) => Promise<DalpAuthResult<TData>>;
-export interface DalpWalletAuthClient {
-    readonly wallet: {
-        readonly pincode: {
-            readonly enable: WalletAuthOperation<{
-                readonly pincode: string;
-                readonly password?: string;
-            }, {
-                readonly success: boolean;
-            }>;
-            readonly update: WalletAuthOperation<{
-                readonly newPincode: string;
-                readonly password: string;
-            }, {
-                readonly success: boolean;
-            }>;
-            readonly disable: WalletAuthOperation<{
-                readonly password: string;
-            }, {
-                readonly success: boolean;
-            }>;
-            readonly reset: WalletAuthOperation<{
-                readonly newPincode: string;
-                readonly recoveryCode: string;
-            }, {
-                readonly success: boolean;
-                readonly recoveryCodes?: ReadonlyArray<string>;
-            }>;
-        };
-        readonly twoFactor: {
-            readonly enable: WalletAuthOperation<{
-                readonly issuer?: string;
-                readonly password?: string;
-            }, {
-                readonly totpURI: string;
-            }>;
-            readonly verify: WalletAuthOperation<{
-                readonly code: string;
-            }, {
-                readonly status: boolean;
-            }>;
-            readonly disable: WalletAuthOperation<{
-                readonly password: string;
-            }, {
-                readonly status: boolean;
-            }>;
-        };
-        readonly secretCodes: {
-            readonly generate: WalletAuthOperation<{
-                readonly password?: string;
-            }, {
-                readonly rotated: boolean;
-                readonly secretCodes: ReadonlyArray<string>;
-                readonly verificationId: string;
-            }>;
-            readonly confirm: WalletAuthOperation<{
-                readonly stored: boolean;
-                readonly verificationId: string;
-            }, {
-                readonly success: boolean;
-            }>;
-        };
-    };
-}
 export declare const walletPincodeClient: () => {
     id: "wallet-pincode";
     $InferServerPlugin: {
@@ -143,6 +78,9 @@ export declare const walletSecretCodesClient: () => {
         signal: "$sessionSignal";
     }[];
 };
-export type StripLeadingSlash<T extends string> = T extends `/${infer Rest}` ? Rest : never;
-export type WalletPluginPathMethodKeys = keyof ReturnType<typeof walletPincodeClient>["pathMethods"] | keyof ReturnType<typeof walletTwoFactorClient>["pathMethods"] | keyof ReturnType<typeof walletSecretCodesClient>["pathMethods"];
-export type WalletAuthEndpointPath = StripLeadingSlash<WalletPluginPathMethodKeys>;
+type StripLeadingSlash<T extends string> = T extends `/${infer Rest}` ? Rest : never;
+type WalletPluginPathMethodKeys = keyof ReturnType<typeof walletPincodeClient>["pathMethods"] | keyof ReturnType<typeof walletTwoFactorClient>["pathMethods"] | keyof ReturnType<typeof walletSecretCodesClient>["pathMethods"];
+/** CLI coverage keys for DALP wallet Better Auth plugin endpoints (no leading slash). */
+export type WalletAuthEndpointPath = StripLeadingSlash<WalletPluginPathMethodKeys & string>;
+export {};
+//# sourceMappingURL=auth-wallet-plugins.d.ts.map

package/dist/auth-wallet-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-wallet-plugins.d.ts","sourceRoot":"","sources":["../src/auth-wallet-plugins.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBK,CAAC;AAEtC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;CAoBG,CAAC;AAEtC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;CAmBC,CAAC;AAEtC,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,MAAM,IAAI,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAErF,KAAK,0BAA0B,GAC3B,MAAM,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,aAAa,CAAC,GAC3D,MAAM,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,aAAa,CAAC,GAC7D,MAAM,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpE,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,0BAA0B,GAAG,MAAM,CAAC,CAAC"}

package/dist/auth.d.ts

@@ -1,8 +1,115 @@
-export { createDalpAuthClient, makeDalpAuthClient } from "./auth/live.ts";
-export type { DalpAuthClient } from "./auth/live.ts";
-export { decodeDalpAuthClientConfig } from "./auth/client.ts";
-export type { DalpAuthSurface } from "./auth-surface.ts";
-export type { DalpAuthClientConfig, DalpCliAuthClient, DalpAuthError, DalpAuthOperation, DalpAuthResult, DalpOrganizationInvitation, DalpOrganizationInvitationsQuery, DalpOrganizationMember, DalpOrganizationMembersQuery, DecodedDalpAuthClientConfig, } from "./auth/client.ts";
-export type { DalpPasskeyCeremony } from "./auth/native-passkey.ts";
-export type { DalpRuntime } from "./runtime.ts";
-export type { WalletAuthEndpointPath } from "./auth/wallet-plugins.ts";
+import { DalpCookieStore } from "./cookie-store.js";
+export interface DalpAuthClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /** API key used for Better Auth API-key-authenticated operations. */
+    apiKey?: string;
+    /** Better Auth session token sent as an Authorization bearer token. */
+    sessionToken?: string;
+    /** Cookie header value for explicit Node/browser-session handoff. */
+    cookie?: string;
+    /** Cookie store for Node-side session persistence across Better Auth calls. */
+    cookieStore?: DalpCookieStore;
+    /**
+     * Organization ID for multi-tenant setups.
+     * Sent as `x-organization-id` when provided.
+     */
+    organizationId?: string;
+    /**
+     * Additional headers merged into every Better Auth request.
+     * Can override defaults like `User-Agent` but cannot override configured security headers.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom `fetch` implementation.
+     * Use this to inject logging, proxy configuration, or test doubles.
+     */
+    fetch?: typeof globalThis.fetch;
+}
+export interface DalpAuthError {
+    code?: string;
+    message?: string;
+    status?: number;
+    statusText?: string;
+    [key: string]: unknown;
+}
+export interface DalpAuthResult<TData = unknown, TError = DalpAuthError> {
+    data: TData | null;
+    error: TError | null;
+}
+export type DalpAuthOperation<TInput = Record<string, unknown>, TData = unknown> = (input?: TInput, options?: unknown) => Promise<DalpAuthResult<TData>>;
+export interface DalpAuthClient {
+    signIn: Record<string, DalpAuthOperation> & {
+        email: DalpAuthOperation;
+    };
+    signUp: Record<string, DalpAuthOperation> & {
+        email: DalpAuthOperation;
+    };
+    getSession: DalpAuthOperation;
+    listSessions: DalpAuthOperation;
+    revokeSession: DalpAuthOperation;
+    revokeOtherSessions: DalpAuthOperation;
+    apiKey: Record<string, DalpAuthOperation> & {
+        create: DalpAuthOperation;
+        list: DalpAuthOperation;
+        delete: DalpAuthOperation;
+    };
+    organization: Record<string, DalpAuthOperation> & {
+        create: DalpAuthOperation;
+        list: DalpAuthOperation;
+        setActive: DalpAuthOperation;
+        inviteMember: DalpAuthOperation;
+        acceptInvitation: DalpAuthOperation;
+        listMembers: DalpAuthOperation;
+        addMember: DalpAuthOperation;
+        removeMember: DalpAuthOperation;
+    };
+    admin: Record<string, DalpAuthOperation> & {
+        listUsers: DalpAuthOperation;
+        createUser: DalpAuthOperation;
+        removeUser: DalpAuthOperation;
+        setRole: DalpAuthOperation;
+    };
+    device: Record<string, DalpAuthOperation> & {
+        code: DalpAuthOperation;
+        token: DalpAuthOperation;
+        approve: DalpAuthOperation;
+        deny: DalpAuthOperation;
+    };
+    passkey: Record<string, DalpAuthOperation>;
+    twoFactor: Record<string, DalpAuthOperation> & {
+        enable: DalpAuthOperation;
+        disable: DalpAuthOperation;
+        verifyTotp: DalpAuthOperation;
+        verifyBackupCode: DalpAuthOperation;
+        generateBackupCodes: DalpAuthOperation;
+    };
+    wallet: {
+        pincode: {
+            enable: DalpAuthOperation;
+            disable: DalpAuthOperation;
+            update: DalpAuthOperation;
+            reset: DalpAuthOperation;
+        };
+        twoFactor: {
+            enable: DalpAuthOperation;
+            disable: DalpAuthOperation;
+            verify: DalpAuthOperation;
+        };
+        secretCodes: {
+            generate: DalpAuthOperation;
+            confirm: DalpAuthOperation;
+        };
+        passkey: {
+            register: DalpAuthOperation;
+            complete: DalpAuthOperation;
+            disable: DalpAuthOperation;
+            challenge: DalpAuthOperation;
+            verify: DalpAuthOperation;
+        };
+    };
+    $fetch: (path: string, options?: Record<string, unknown>) => Promise<unknown>;
+    $ERROR_CODES: Record<string, unknown>;
+}
+export declare function createDalpAuthClient(config: DalpAuthClientConfig): DalpAuthClient;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

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

package/dist/bundler.d.ts

@@ -0,0 +1,217 @@
+import type { Address, Hex } from "viem";
+import type { RpcEstimateUserOperationGasReturnType, RpcUserOperation, RpcUserOperationRequest } from "viem/account-abstraction";
+import type { DapiPublicError } from "./dapi-errors.js";
+import { DalpSdkError } from "./sdk-error.js";
+/**
+ * viem's ERC-4337 RPC **input** types, re-exported under SDK-owned names so
+ * consumer code never imports from `viem`. These stay type-only — `import type`
+ * keeps viem's account-abstraction runtime off the published call path. The
+ * viem generic is pinned to `"0.9"` because the DALP bundler serves EntryPoint
+ * v0.9 only and reconstructs a `UserOperation<"0.9">` from the v0.9 fields; the
+ * version-generic types would accept older-EntryPoint fields (`initCode`,
+ * `paymasterAndData`) the server silently drops.
+ */
+export type DalpEstimateUserOperationGasReturnType = RpcEstimateUserOperationGasReturnType<"0.9">;
+export type DalpUserOperation = RpcUserOperation<"0.9">;
+export type DalpUserOperationRequest = RpcUserOperationRequest<"0.9">;
+/**
+ * ERC-7769 / ERC-4337 account-abstraction JSON-RPC error codes, vendored from
+ * `kit/dapi/src/routes/bundler/types.ts`. The catalog is non-contiguous:
+ * `-32506` is intentionally absent from this v0.9 dispatcher surface. The codes
+ * are fixed by ERC-7769, so the drift test (`bundler.test.ts`) asserts these
+ * against the explicit standard values as a transcription guard.
+ */
+export declare const BUNDLER_AA_ERROR_CODES: {
+    readonly AA_VALIDATION: -32500;
+    readonly AA_PAYMASTER_VALIDATION: -32501;
+    readonly AA_OPCODE: -32502;
+    readonly AA_OUT_OF_TIME_RANGE: -32503;
+    readonly AA_PAYMASTER_THROTTLED: -32504;
+    readonly AA_STAKE: -32505;
+    readonly AA_SIGNATURE: -32507;
+    readonly AA_PAYMASTER_BALANCE: -32508;
+};
+export declare const BUNDLER_VENDOR_ERROR_CODES: {
+    readonly EXECUTION_REVERTED: -32521;
+};
+/** Name of a vendored ERC-7769 account-abstraction error code. */
+export type BundlerAaErrorName = keyof typeof BUNDLER_AA_ERROR_CODES;
+export type BundlerVendorErrorName = keyof typeof BUNDLER_VENDOR_ERROR_CODES;
+/** Options for constructing a {@link DalpBundlerError}. */
+export interface DalpBundlerErrorOptions {
+    /** The numeric JSON-RPC error code returned by the bundler endpoint. */
+    code: number;
+    message: string;
+    why: string;
+    fix: string;
+    aaErrorName?: BundlerAaErrorName;
+    vendorErrorName?: BundlerVendorErrorName;
+    revertData?: Hex;
+    dapiError?: DapiPublicError;
+    status?: number;
+    /** Whether the failure is retryable. Defaults to `false` when omitted. */
+    retryable?: boolean;
+    cause?: unknown;
+}
+declare class DalpBundlerRpcError extends DalpSdkError {
+    /** The vendored AA error name when `code` maps to a known ERC-7769 code. */
+    readonly aaErrorName?: BundlerAaErrorName;
+    readonly vendorErrorName?: BundlerVendorErrorName;
+    readonly revertData?: Hex;
+    constructor(options: DalpBundlerErrorOptions);
+}
+/**
+ * A bundler/paymaster JSON-RPC failure. Extends {@link DalpSdkError}; the
+ * `code` field carries the numeric ERC-7769 JSON-RPC error code so callers can
+ * branch on `BUNDLER_AA_ERROR_CODES`. The concrete class is re-typed here so
+ * `code` surfaces as `number` rather than ORPCError's inherited `string`.
+ */
+export type DalpBundlerError = Omit<DalpBundlerRpcError, "code"> & {
+    readonly code: number;
+};
+export declare const DalpBundlerError: {
+    new (options: DalpBundlerErrorOptions): DalpBundlerError;
+    readonly prototype: DalpBundlerError;
+};
+/**
+ * A mined or in-flight UserOperation as returned by `eth_getUserOperationByHash`.
+ *
+ * SDK-owned (not viem's `RpcGetUserOperationByHashReturnType`) because the server
+ * emits a DALP-partial shape: a mined result carries only
+ * `userOperation: { sender, nonce }` with `blockHash: null`, while an in-flight
+ * result carries the full canonical UserOperation with `blockNumber`/`blockHash`/
+ * `transactionHash` null. Fields the server always emits are required; fields it
+ * omits are optional.
+ */
+export interface BundlerUserOperationByHash {
+    userOperation: {
+        sender: Address;
+        nonce: Hex;
+        callData?: Hex;
+        callGasLimit?: Hex;
+        verificationGasLimit?: Hex;
+        preVerificationGas?: Hex;
+        maxFeePerGas?: Hex;
+        maxPriorityFeePerGas?: Hex;
+        factory?: Address;
+        factoryData?: Hex;
+        paymaster?: Address;
+        paymasterVerificationGasLimit?: Hex;
+        paymasterPostOpGasLimit?: Hex;
+        paymasterData?: Hex;
+        signature?: Hex;
+    };
+    entryPoint: Address;
+    transactionHash: Hex | null;
+    blockNumber: Hex | null;
+    blockHash: Hex | null;
+}
+/** A single log entry within a {@link BundlerUserOperationReceipt}. */
+export interface BundlerUserOperationReceiptLog {
+    address: Address;
+    /** Raw indexed EVM log topics for this UserOperation-attributed event. */
+    topics: Hex[];
+    data: Hex;
+    blockNumber: Hex;
+    blockHash: Hex | null;
+    transactionHash: Hex;
+    transactionIndex: Hex;
+    logIndex: Hex;
+    removed: boolean;
+}
+/**
+ * A UserOperation receipt as returned by `eth_getUserOperationReceipt`.
+ *
+ * SDK-owned (not viem's `RpcUserOperationReceipt`) because the server emits a
+ * minimal `receipt` ({@link BundlerUserOperationReceipt.receipt}), logs with a
+ * nullable `blockHash`, and a nullable `paymaster`.
+ */
+export interface BundlerUserOperationReceipt {
+    userOpHash: Hex;
+    entryPoint: Address;
+    sender: Address;
+    nonce: Hex;
+    paymaster: Address | null;
+    actualGasCost: Hex;
+    actualGasUsed: Hex;
+    success: boolean;
+    logs: BundlerUserOperationReceiptLog[];
+    receipt: {
+        transactionHash: Hex;
+        blockNumber: Hex;
+        transactionIndex: Hex;
+    };
+}
+/** Result of `pm_getPaymasterStubData`. */
+export interface BundlerPaymasterStubData {
+    paymaster: Address;
+    paymasterData: Hex;
+    paymasterVerificationGasLimit?: Hex;
+    paymasterPostOpGasLimit?: Hex;
+}
+/** Result of `pm_getPaymasterData`. */
+export interface BundlerPaymasterData {
+    paymaster: Address;
+    paymasterData: Hex;
+}
+/**
+ * Configuration for {@link createDalpBundlerClient}.
+ *
+ * Unlike {@link createDalpClient}, `apiKey` is **required**: the bundler
+ * endpoint is auth-only (`requireApiKey: true`) with no public variant.
+ */
+export interface DalpBundlerClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /** API key for the bundler endpoint (issued via the DALP dashboard or CLI). */
+    apiKey: string;
+    /**
+     * Organization ID for multi-tenant setups.
+     * Pass this explicitly when the API key may map to more than one organization.
+     */
+    organizationId?: string;
+    /**
+     * Additional headers merged into every request. Cannot override the security
+     * headers (`x-api-key`, `x-organization-id`).
+     */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /** Custom `fetch` implementation (logging, proxy, test doubles). */
+    fetch?: typeof globalThis.fetch;
+}
+/** A typed client over the eight ERC-4337 / ERC-7677 bundler JSON-RPC methods. */
+export interface DalpBundlerClient {
+    /** `eth_sendUserOperation` — submit a caller-signed UserOperation; resolves to its hash. */
+    sendUserOperation(userOperation: RpcUserOperation<"0.9">, entryPoint: Address): Promise<Hex>;
+    /**
+     * `eth_estimateUserOperationGas` — estimate gas limits for a UserOperation.
+     * Takes the partial request shape (`RpcUserOperationRequest`): the gas and
+     * signature fields the estimate computes need not be populated.
+     */
+    estimateUserOperationGas(userOperation: RpcUserOperationRequest<"0.9">, entryPoint: Address): Promise<RpcEstimateUserOperationGasReturnType<"0.9">>;
+    /** `eth_getUserOperationByHash` — resolves the (DALP-partial) UserOperation, or `null` on miss. */
+    getUserOperationByHash(hash: Hex): Promise<BundlerUserOperationByHash | null>;
+    /** `eth_getUserOperationReceipt` — resolves the receipt, or `null` on miss. */
+    getUserOperationReceipt(hash: Hex): Promise<BundlerUserOperationReceipt | null>;
+    /** `eth_supportedEntryPoints` — the EntryPoint addresses this bundler serves. */
+    getSupportedEntryPoints(): Promise<Address[]>;
+    /**
+     * `eth_chainId` — the served chain id as a `bigint`, decoded from its hex
+     * quantity. Returns `bigint` (not `number`) so chain ids above
+     * `Number.MAX_SAFE_INTEGER` are represented without precision loss.
+     */
+    getChainId(): Promise<bigint>;
+    /**
+     * `pm_getPaymasterStubData` — stub paymaster data for gas estimation. Takes
+     * the partial request shape (`RpcUserOperationRequest`); paymaster fields are
+     * what this call produces.
+     */
+    getPaymasterStubData(userOperation: RpcUserOperationRequest<"0.9">, entryPoint: Address, chainId: number | bigint, context?: unknown): Promise<BundlerPaymasterStubData>;
+    /**
+     * `pm_getPaymasterData` — final paymaster sponsorship data. Takes the partial
+     * request shape (`RpcUserOperationRequest`).
+     */
+    getPaymasterData(userOperation: RpcUserOperationRequest<"0.9">, entryPoint: Address, chainId: number | bigint, context?: unknown): Promise<BundlerPaymasterData>;
+}
+export declare function createDalpBundlerClient(config: DalpBundlerClientConfig): DalpBundlerClient;
+export {};
+//# sourceMappingURL=bundler.d.ts.map

package/dist/bundler.d.ts.map

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

package/dist/chunk-xm8h1dzh.js

@@ -0,0 +1,33 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+
+export { __toESM, __commonJS };

package/dist/client.d.ts

@@ -0,0 +1,19 @@
+import type { DalpClient, DalpClientConfig, PublicDalpClientConfig } from "./types.js";
+/**
+ * Create a fully typed DALP API client.
+ *
+ * @example
+ * ```typescript
+ * import { createDalpClient } from "@settlemint/dalp-sdk";
+ *
+ * const dalp = createDalpClient({
+ *   url: "https://dalp.example.com",
+ *   apiKey: "sm_dalp_...",
+ *   organizationId: "org_...",
+ * });
+ *
+ * const tokens = await dalp.token.list({ query: {} });
+ * ```
+ */
+export declare function createDalpClient(config: DalpClientConfig | PublicDalpClientConfig): DalpClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAyB,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAmB9G;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,GAAG,UAAU,CAsG9F"}