@settlemint/dalp-sdk 2.1.7-main.22780180229

package/dist/plugins/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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";

package/dist/plugins/index.js

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

package/dist/serializers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 JSON-safe 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[];

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type-only exports for the DALP SDK.
+ *
+ * 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 { ContractRouterClient } from "@orpc/contract";
+import type { rpcContract } from "./contract.js";
+/**
+ * Fully typed DALP API client.
+ *
+ * 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 DalpClient = ContractRouterClient<typeof rpcContract>;
+/**
+ * Configuration for creating a DALP API client.
+ */
+export interface DalpClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /** API key for authentication (issued via the DALP dashboard or CLI). */
+    apiKey: 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 true
+     */
+    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;
+}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+/** Semver version of the published SDK package. */
+export declare const SDK_VERSION: string;
+/** Default User-Agent header sent with every SDK request. */
+export declare const SDK_USER_AGENT: string;

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@settlemint/dalp-sdk",
+  "version": "2.1.7-main.22780180229",
+  "private": false,
+  "description": "Fully typed SDK for the DALP tokenization platform API",
+  "homepage": "https://settlemint.com",
+  "bugs": {
+    "email": "support@settlemint.com"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": {
+    "name": "SettleMint",
+    "email": "support@settlemint.com",
+    "url": "https://settlemint.com"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js",
+      "default": "./dist/plugins/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && bun scripts/build.js && tsgo -p tsconfig.build.json && bun scripts/fix-dts-extensions.js",
+    "publint": "publint run --strict --pack npm",
+    "attw": "attw --pack . --profile esm-only",
+    "publish": "cp ../../LICENSE . && npm publish --ignore-scripts --tag ${TAG:-latest} --access public",
+    "prepack": "cp ../../LICENSE .",
+    "test": "vitest run --changed main --project unit",
+    "typecheck": "tsgo --noEmit"
+  },
+  "dependencies": {
+    "@orpc/client": "1.13.6",
+    "@orpc/contract": "1.13.5",
+    "currency-codes": "2.2.0",
+    "date-fns": "4.1.0",
+    "dnum": "2.17.0",
+    "iso-3166": "4.4.0",
+    "viem": "2.46.3",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.2",
+    "@dalp/dapi-contract": "workspace:*",
+    "@tools/typescript-config": "workspace:*",
+    "@tools/vitest-config": "workspace:*",
+    "publint": "0.3.18",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}