@settlemint/dalp-sdk 3.1.17 → 3.1.18-main.33796706856

package/dist/chunk-f4t1bm86.js

@@ -0,0 +1,67 @@
+// src/proxy/builder.ts
+function buildIndex(table) {
+  const root = { children: new Map };
+  for (const id of Object.keys(table.routes)) {
+    let cursor = root;
+    for (const segment of id.split("/")) {
+      let next = cursor.children.get(segment);
+      if (next === undefined) {
+        next = { children: new Map };
+        cursor.children.set(segment, next);
+      }
+      cursor = next;
+    }
+    cursor.routeId = id;
+  }
+  return root;
+}
+function makeNode(node, table, executor, factories, cache) {
+  const cached = cache.get(node);
+  if (cached !== undefined) {
+    return cached;
+  }
+  const route = node.routeId === undefined ? undefined : table.routes[node.routeId];
+  const id = node.routeId;
+  const target = route === undefined || id === undefined ? {} : Object.assign((input, options) => executor(route, id, input, options), {
+    queryOptions: (input, options) => factories.queryOptions(route, id, input, options),
+    mutationOptions: (options) => factories.mutationOptions(route, id, options)
+  });
+  const proxy = new Proxy(target, {
+    get(base, property, receiver) {
+      if (typeof property !== "string") {
+        return Reflect.get(base, property, receiver);
+      }
+      if (Object.hasOwn(base, property) || property in Function.prototype) {
+        return Reflect.get(base, property, receiver);
+      }
+      const child = node.children.get(property);
+      return child === undefined ? undefined : makeNode(child, table, executor, factories, cache);
+    },
+    has(base, property) {
+      return typeof property === "string" && node.children.has(property) || Reflect.has(base, property);
+    },
+    ownKeys(base) {
+      return [...new Set([...Reflect.ownKeys(base), ...node.children.keys()])];
+    },
+    getOwnPropertyDescriptor(base, property) {
+      if (typeof property === "string" && node.children.has(property)) {
+        return {
+          configurable: true,
+          enumerable: true,
+          value: makeNode(node.children.get(property), table, executor, factories, cache)
+        };
+      }
+      return Reflect.getOwnPropertyDescriptor(base, property);
+    }
+  });
+  cache.set(node, proxy);
+  return proxy;
+}
+function buildProxy(table, executor, factories) {
+  return makeNode(buildIndex(table), table, executor, factories, new Map);
+}
+function findRoute(table, id) {
+  return table.routes[id];
+}
+
+export { buildProxy, findRoute };

package/dist/chunk-fjnq61hj.js

@@ -0,0 +1,11 @@
+// src/reads-as-funding-paused.ts
+function readsAsFundingPaused(status) {
+  if (status === null || typeof status !== "object") {
+    return false;
+  }
+  const requirement = Reflect.get(status, "activeRequirement");
+  return requirement !== undefined && requirement !== null;
+}
+var PAUSED_POLL_INTERVAL_MAX_MS = 30000;
+
+export { readsAsFundingPaused, PAUSED_POLL_INTERVAL_MAX_MS };

package/dist/chunk-h12fatty.js

@@ -0,0 +1,63 @@
+import {
+  createDalpSdkConfigurationError
+} from "./chunk-y0d2c7kp.js";
+
+// src/secret.ts
+var SECRET_REDACTION_MARKER = "[REDACTED]";
+var inspectSymbol = Symbol.for("nodejs.util.inspect.custom");
+var secretValue = new WeakMap;
+
+class Secret {
+  constructor(value) {
+    secretValue.set(this, value);
+    Object.freeze(this);
+  }
+  static from(value) {
+    if (value.trim().length === 0) {
+      throw new TypeError("DALP SDK: a secret value must not be empty.");
+    }
+    return new Secret(value);
+  }
+  toString() {
+    return SECRET_REDACTION_MARKER;
+  }
+  toJSON() {
+    return SECRET_REDACTION_MARKER;
+  }
+  [inspectSymbol]() {
+    return SECRET_REDACTION_MARKER;
+  }
+}
+var secret = (value) => Secret.from(value);
+var unwrapSecret = (value) => {
+  const raw = secretValue.get(value);
+  if (raw === undefined) {
+    throw new TypeError("DALP SDK: cannot unwrap an invalid secret value.");
+  }
+  return raw;
+};
+
+// src/url.ts
+function normalizeDalpBaseUrl(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch (error) {
+    throw createDalpSdkConfigurationError({
+      message: `DALP SDK: invalid url "${url}". Provide a full URL including the protocol (e.g., "https://dalp.example.com").`,
+      why: "The SDK could not parse the configured DALP API URL.",
+      fix: 'Provide a full http:// or https:// URL, for example "https://dalp.example.com".',
+      cause: error
+    });
+  }
+  if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+    throw createDalpSdkConfigurationError({
+      message: `DALP SDK: url must use https:// or http:// protocol, got "${parsed.protocol}".`,
+      why: `The SDK received a URL with the unsupported "${parsed.protocol}" protocol.`,
+      fix: 'Use a DALP API base URL that starts with "https://" or "http://".'
+    });
+  }
+  return `${parsed.origin}${parsed.pathname.replace(/\/+$/, "")}`;
+}
+
+export { SECRET_REDACTION_MARKER, Secret, secret, unwrapSecret, normalizeDalpBaseUrl };

package/dist/chunk-r0vsftj4.js

@@ -0,0 +1,102 @@
+// src/verify-webhook.ts
+import { Webhook as StandardWebhook } from "standardwebhooks";
+var DEFAULT_TIMESTAMP_TOLERANCE_SECONDS = 5 * 60;
+function toStandardWebhookSecret(secret) {
+  return secret.replace(/^dalp_whsk_/u, "");
+}
+async function verifyWebhook(input) {
+  const headers = normalizeHeaders(input.headers);
+  const nowMillis = input.now instanceof Date ? input.now.getTime() : input.now ?? Date.now();
+  const tolerance = input.timestampToleranceSeconds ?? DEFAULT_TIMESTAMP_TOLERANCE_SECONDS;
+  if (!hasFiniteTimestamp(headers) || isOutsideTimestampTolerance(headers, nowMillis, tolerance)) {
+    return { ok: false, code: "TIMESTAMP_SKEW" };
+  }
+  const rawText = typeof input.rawBody === "string" ? input.rawBody : new TextDecoder().decode(input.rawBody);
+  const eventId = headers["webhook-id"];
+  if (eventId !== undefined && await input.replayStore?.has(eventId) === true) {
+    return { ok: false, code: "REPLAYED_EVENT" };
+  }
+  let sawMalformedBody = false;
+  let sawReplayStoreFailure = false;
+  for (const candidate of Array.isArray(input.secret) ? input.secret : [input.secret]) {
+    if (!matchesSignature(candidate, rawText, headers)) {
+      continue;
+    }
+    let event;
+    try {
+      event = JSON.parse(rawText);
+    } catch {
+      sawMalformedBody = true;
+      continue;
+    }
+    if (eventId !== undefined && input.replayStore !== undefined) {
+      try {
+        await input.replayStore.add(eventId);
+      } catch {
+        sawReplayStoreFailure = true;
+        continue;
+      }
+    }
+    return { ok: true, event };
+  }
+  if (sawReplayStoreFailure) {
+    return { ok: false, code: "REPLAY_STORE_FAILURE" };
+  }
+  if (sawMalformedBody) {
+    return { ok: false, code: "MALFORMED_BODY" };
+  }
+  return { ok: false, code: classifySignatureFailure(rawText, headers) };
+}
+function matchesSignature(secret, rawBody, headers) {
+  const eventId = headers["webhook-id"];
+  const timestamp = Number(headers["webhook-timestamp"]);
+  const signatures = headers["webhook-signature"];
+  if (eventId === undefined || !Number.isFinite(timestamp) || signatures === undefined) {
+    return false;
+  }
+  const expected = new StandardWebhook(toStandardWebhookSecret(secret)).sign(eventId, new Date(timestamp * 1000), rawBody);
+  return signatures.split(" ").some((signature) => {
+    const left = new TextEncoder().encode(signature);
+    const right = new TextEncoder().encode(expected);
+    if (left.byteLength !== right.byteLength) {
+      return false;
+    }
+    let difference = 0;
+    for (let index = 0;index < left.byteLength; index += 1) {
+      difference |= (left[index] ?? 0) ^ (right[index] ?? 0);
+    }
+    return difference === 0;
+  });
+}
+function normalizeHeaders(input) {
+  if (input instanceof Headers) {
+    return Object.fromEntries(input.entries());
+  }
+  const headers = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== undefined) {
+      headers[key.toLowerCase()] = typeof value === "string" ? value : value.join(",");
+    }
+  }
+  return headers;
+}
+function hasFiniteTimestamp(headers) {
+  return Number.isFinite(Number(headers["webhook-timestamp"]));
+}
+function isOutsideTimestampTolerance(headers, nowMillis, toleranceSeconds) {
+  const timestamp = Number(headers["webhook-timestamp"]);
+  return Number.isFinite(timestamp) && Math.abs(nowMillis / 1000 - timestamp) > toleranceSeconds;
+}
+function classifySignatureFailure(rawBody, headers) {
+  try {
+    const parsed = JSON.parse(rawBody);
+    if (typeof parsed.evt_id !== "string" || parsed.evt_id !== headers["webhook-id"]) {
+      return "BODY_HASH_MISMATCH";
+    }
+  } catch {
+    return "BODY_HASH_MISMATCH";
+  }
+  return "SECRET_MISMATCH";
+}
+
+export { toStandardWebhookSecret, verifyWebhook };

package/dist/chunk-x0z79vz6.js

@@ -0,0 +1,33 @@
+import {
+  buildProxy,
+  findRoute
+} from "./chunk-f4t1bm86.js";
+import {
+  createFetchExecutor,
+  createTanstackFactories,
+  createTransport,
+  sendRequest,
+  streamRequest
+} from "./chunk-def7rqy6.js";
+import {
+  data
+} from "./chunk-18qmk0m7.js";
+
+// src/proxy/client.ts
+function createDalpClient(options) {
+  const transport = createTransport(options);
+  const api = buildProxy(data, createFetchExecutor(transport), createTanstackFactories(transport));
+  return {
+    api,
+    conditionalRequests: transport.conditionalRequests,
+    execute: async (routeId, input, callOptions) => {
+      const route = findRoute(data, routeId);
+      if (route === undefined) {
+        throw new TypeError(`Unknown DALP route \`${routeId}\``);
+      }
+      const result = route.serializer === "sse" ? streamRequest(transport, route, input, callOptions) : await sendRequest(transport, route, input, callOptions);
+      return result;
+    }
+  };
+}
+export { createDalpClient };

package/dist/chunk-y0d2c7kp.js

@@ -0,0 +1,54 @@
+// src/errors/sdk-error.ts
+var DALP_SDK_ERROR_CODE = "DALP_SDK_ERROR";
+var DALP_SDK_ERROR_CATEGORY = "sdk.configuration";
+
+class DalpSdkError extends Error {
+  code;
+  category;
+  status;
+  retryable;
+  why;
+  fix;
+  details;
+  retryAfterSeconds;
+  constructor(options) {
+    super(options.message, { cause: options.cause });
+    this.name = "DalpSdkError";
+    this.code = options.code ?? DALP_SDK_ERROR_CODE;
+    this.category = options.category;
+    this.status = options.status;
+    this.retryable = options.retryable;
+    this.why = options.why;
+    this.fix = options.fix;
+    this.details = options.details;
+    this.retryAfterSeconds = options.retryAfterSeconds;
+  }
+  toJSON() {
+    return {
+      name: "DalpSdkError",
+      code: this.code,
+      category: this.category,
+      retryable: this.retryable,
+      message: this.message,
+      why: this.why,
+      fix: this.fix,
+      ...this.status === undefined ? {} : { status: this.status },
+      ...this.details === undefined ? {} : { details: this.details },
+      ...this.retryAfterSeconds === undefined ? {} : { retryAfterSeconds: this.retryAfterSeconds }
+    };
+  }
+}
+function createDalpSdkConfigurationError(input) {
+  return new DalpSdkError({
+    code: DALP_SDK_ERROR_CODE,
+    category: DALP_SDK_ERROR_CATEGORY,
+    status: 400,
+    retryable: false,
+    message: input.message,
+    why: input.why,
+    fix: input.fix,
+    cause: input.cause
+  });
+}
+
+export { DalpSdkError, createDalpSdkConfigurationError };

package/dist/client/conditional-request.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Conditional GET, as a fetch decorator.
+ *
+ * The policy is unchanged from the interceptor pair this replaces: hold the
+ * ETag and body of a successful GET, send `If-None-Match` on the next one, and
+ * serve the held body on a 304. Only the attachment point moved, from a
+ * generated client's interceptor list to the fetch the transport already wraps
+ * for compression and SSR.
+ */
+import type { DalpFetch } from "./ssr-fetch.ts";
+/** Handle a caller holds so it can clear the store on sign-out or org switch. */
+export interface ConditionalRequestStore {
+    readonly clear: () => void;
+}
+/**
+ * Wrap `fetch` with the If-None-Match / 304 rewrite pair for conditional GET.
+ *
+ * Server ETags must be strong content digests computed after authorization
+ * inside the requester's partition. The dapi response cache guarantees this:
+ * `encodeResponseCacheEntry` sets `etag` to the SHA-256 of the serialized
+ * body after the request-context middleware has authenticated the session.
+ * Version-stamp ETags (generation counters, watermarks, table versions) are
+ * forbidden for conditional-request adopters: a stamp can collide across
+ * tenants or lag a body change and would let this store serve another
+ * partition's bytes as a 200.
+ */
+export declare function withConditionalRequests(base: DalpFetch): {
+    fetch: DalpFetch;
+    store: ConditionalRequestStore;
+};

package/dist/client/factory.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The client factory.
+ *
+ * The transport policy this used to assemble around the generated client now
+ * lives in `../proxy/transport.ts`, which both interpreters share. This module
+ * stays as the published entry point's seam so a consumer's import path did not
+ * move with the internals.
+ *
+ * @module
+ */
+export { createDalpClient, type DalpClient } from "../proxy/client.ts";
+export { createDalpContextHeaders } from "../proxy/transport.ts";
+export type { CreateDalpClientOptions, DalpClientContext, DalpSsrOptions, Transport } from "../proxy/transport.ts";
+export type { DalpFetch } from "./ssr-fetch.ts";

package/dist/client/query-serializer.d.ts

@@ -0,0 +1,2 @@
+/** Serialize generated SDK query objects with recursive OpenAPI deepObject keys. */
+export declare function serializeDalpQuery(query: unknown): string;

package/dist/client/request-compression.d.ts

@@ -0,0 +1,47 @@
+import type { DalpFetch } from "./ssr-fetch.ts";
+/**
+ * Request-body compression for DALP server/CLI clients.
+ *
+ * Bun 1.4 added a `compress` fetch option: it compresses a buffered body
+ * before sending and sets `Content-Encoding` on the wire. This wrapper opts
+ * eligible outgoing bodies into gzip so big JSON payloads shrink in transit;
+ * the receiving DAPI host decodes them at its boundary
+ * (`@dapi/server/request-body-decoding`), so callers need no per-route work.
+ *
+ * Eligibility mirrors what the transport can actually do:
+ *
+ * - Only body-bearing methods (`GET`/`HEAD` never).
+ * - Bodies already carrying `Content-Encoding`, or an explicit caller
+ *   `compress`, pass through untouched.
+ * - With `(url, init)` the body must be one of Bun's buffered types
+ *   (string, ArrayBuffer, TypedArray/DataView, Blob) and fall inside the
+ *   size window — gzip framing dominates tiny payloads, and huge explicitly
+ *   sized bodies stay uncompressed (the DAPI decode cap mirrors this bound).
+ * - Streams, `FormData`, and `URLSearchParams` pass through: the transport
+ *   forwards streaming bodies unchanged.
+ * - A `Request` instance is measured through a bounded clone before compression.
+ */
+/** Bodies smaller than this stay uncompressed; gzip framing dominates tiny JSON. */
+export declare const DALP_SDK_REQUEST_COMPRESSION_MIN_BODY_BYTES = 1024;
+/** Explicitly-sized bodies larger than this are sent uncompressed. */
+export declare const DALP_SDK_REQUEST_COMPRESSION_MAX_BODY_BYTES = 16777216;
+/**
+ * Bun's `compress` fetch option. bun-types 1.4.0 still types `RequestInit`
+ * from lib.dom without it, so the field is declared here and set through one
+ * narrow cast at the transport seam.
+ */
+export type FetchRequestCompression = true | "gzip" | "deflate" | "br" | "zstd";
+export interface CompressionRequestInit extends RequestInit {
+    readonly compress?: FetchRequestCompression;
+}
+export interface RequestBodyCompressionOptions {
+    /** Test seam overriding DALP_SDK_REQUEST_COMPRESSION_MIN_BODY_BYTES. */
+    readonly minBodyBytes?: number;
+    /** Test seam overriding DALP_SDK_REQUEST_COMPRESSION_MAX_BODY_BYTES. */
+    readonly maxBodyBytes?: number;
+}
+/**
+ * Wrap a fetch seam so eligible request bodies travel gzip-compressed.
+ * Ineligible calls forward the original arguments untouched.
+ */
+export declare function withRequestBodyCompression(fetchImpl: DalpFetch, options?: RequestBodyCompressionOptions): DalpFetch;

package/dist/client/ssr-fetch.d.ts

@@ -0,0 +1,12 @@
+/** Minimal fetch shape — Bun's `typeof fetch` also requires `preconnect`. */
+export type DalpFetch = ((input: RequestInfo | URL, init?: RequestInit) => Promise<Response>) & {
+    readonly preconnect?: typeof fetch.preconnect;
+};
+export interface CreateSsrFetchOptions {
+    readonly allowedOrigins?: ReadonlyArray<string | URL>;
+    readonly baseUrl: string | URL;
+    readonly fetch: DalpFetch;
+    readonly requestHeaders: HeadersInit;
+}
+/** Direct destinations must be approved; unapproved redirects lose all caller credentials and context. */
+export declare function createSsrFetch(options: CreateSsrFetchOptions): DalpFetch;

package/dist/effect.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The Effect call surface.
+ *
+ * The same namespaced tree as the root entry, returning `Effect` values instead
+ * of promises. It exists because the CLI and other code under our control want
+ * Effect, and hiding it behind promises there would mean unwrapping and
+ * rewrapping at every boundary.
+ *
+ * This entry is deliberately absent from `PUBLISHED_ENTRIES` in
+ * `scripts/check-zero-effect.ts`. That gate walks the import graph from every
+ * listed entry and fails on any reachable `effect` module, and Bun's transpiler
+ * reports a type-only import exactly like a value one. Keeping this entry off
+ * the list is what lets the root stay provably Effect-free while this one uses
+ * Effect freely.
+ *
+ * Errors are tagged from the wire envelope rather than decoded from per-route
+ * schemas. The envelope is identical across every route (`code`, `status`,
+ * `message`, and a `data` carrying the stable DALP id), so one reader covers
+ * 759 routes, and no runtime schema ships.
+ *
+ * @module
+ */
+import * as Effect from "effect/Effect";
+import type { DalpApi, DalpRouteId, DalpRouteTypes } from "./generated/api-types.d.ts";
+import { type CallOptions } from "./proxy/builder.ts";
+import { type CreateDalpClientOptions } from "./proxy/transport.ts";
+/** The failure channel every route call carries. */
+export declare class DalpRequestError extends Error {
+    readonly _tag = "DalpRequestError";
+    /** Stable DALP error id when the platform supplied one, else the SDK code. */
+    readonly id: string;
+    readonly status: number | undefined;
+    readonly retryable: boolean;
+    readonly routeId: string;
+    constructor(routeId: string, cause: unknown);
+}
+/** The Effect-shaped mirror of `DalpApi`. */
+export type DalpEffectApi = DalpEffectApiNode<DalpApi>;
+/**
+ * A stream leaf answers with its frame sequence rather than one body, so it is
+ * matched before the promise leaf: its call signature returns an `AsyncIterable`
+ * and would otherwise fall through to the recursive branch, which maps a call
+ * signature to an object with no keys and leaves the route uncallable.
+ */
+type DalpEffectApiNode<T> = {
+    readonly [K in keyof T]: T[K] extends (...args: infer Args) => AsyncIterable<infer Frame> ? (...args: Args) => Effect.Effect<AsyncIterable<Frame>, DalpRequestError> : T[K] extends (...args: infer Args) => Promise<infer A> ? (...args: Args) => Effect.Effect<A, DalpRequestError> : DalpEffectApiNode<T[K]>;
+};
+/** The routes that answer with `text/event-stream`, named by the route table. */
+export type DalpStreamingRouteId = {
+    [Id in DalpRouteId]: DalpRouteTypes[Id]["streaming"] extends true ? Id : never;
+}[DalpRouteId];
+export interface DalpEffectClient {
+    readonly api: DalpEffectApi;
+    /**
+     * Two signatures rather than one conditional return type. A caller generic over
+     * the streaming routes has to resolve the frame sequence from its own
+     * constraint, and a conditional keyed on `Id` stays unresolved until `Id` is a
+     * single route, which is what pushed every such caller into an assertion.
+     */
+    readonly execute: {
+        <Id extends DalpStreamingRouteId>(routeId: Id, input?: DalpRouteTypes[Id]["request"], options?: CallOptions): Effect.Effect<AsyncIterable<DalpRouteTypes[Id]["response"]>, DalpRequestError>;
+        <Id extends DalpRouteId>(routeId: Id, input?: DalpRouteTypes[Id]["request"], options?: CallOptions): Effect.Effect<DalpRouteTypes[Id]["response"], DalpRequestError>;
+    };
+}
+/** Create the Effect client. Same routes, same transport, different channel. */
+export declare function createDalpEffectClient(options: CreateDalpClientOptions): DalpEffectClient;
+export type { CallOptions } from "./proxy/builder.ts";
+export type { CreateDalpClientOptions } from "./proxy/transport.ts";
+export type { DalpRouteId, DalpRouteTypes } from "./generated/api-types.d.ts";

package/dist/effect.js

@@ -0,0 +1,82 @@
+import {
+  buildProxy,
+  findRoute
+} from "./chunk-f4t1bm86.js";
+import {
+  DalpApiError,
+  createTransport,
+  queryKeyFor,
+  sendRequest,
+  streamRequest
+} from "./chunk-def7rqy6.js";
+import"./chunk-fjnq61hj.js";
+import {
+  data
+} from "./chunk-18qmk0m7.js";
+import"./chunk-h12fatty.js";
+import"./chunk-y0d2c7kp.js";
+
+// src/effect.ts
+import * as Effect from "effect/Effect";
+class DalpRequestError extends Error {
+  _tag = "DalpRequestError";
+  id;
+  status;
+  retryable;
+  routeId;
+  constructor(routeId, cause) {
+    const api = cause instanceof DalpApiError ? cause : undefined;
+    super(api?.message ?? `DALP request failed for ${routeId}`, { cause });
+    this.name = "DalpRequestError";
+    this._tag = "DalpRequestError";
+    this.routeId = routeId;
+    this.id = api?.code ?? "sdk.transport.REQUEST_FAILED";
+    this.status = api?.status;
+    this.retryable = api?.retryable ?? true;
+  }
+}
+function runRoute(transport, route, id, input, options) {
+  return Effect.callback((resume) => {
+    const controller = new AbortController;
+    const signal = options?.signal ?? controller.signal;
+    const run = async () => {
+      try {
+        resume(Effect.succeed(route.serializer === "sse" ? streamRequest(transport, route, input, { ...options, signal }) : await sendRequest(transport, route, input, { ...options, signal })));
+      } catch (error) {
+        resume(Effect.fail(new DalpRequestError(id, error)));
+      }
+    };
+    run();
+    return Effect.sync(() => {
+      controller.abort();
+    });
+  });
+}
+function createDalpEffectClient(options) {
+  const transport = createTransport(options);
+  const executor = (route, id, input, callOptions) => runRoute(transport, route, id, input, callOptions);
+  const factories = {
+    queryOptions: (route, id, input, callOptions) => ({
+      queryKey: queryKeyFor(id, input),
+      queryFn: () => runRoute(transport, route, id, input, callOptions)
+    }),
+    mutationOptions: (route, id, callOptions) => ({
+      mutationKey: ["dalp", id],
+      mutationFn: (input) => runRoute(transport, route, id, input, callOptions)
+    })
+  };
+  return {
+    api: buildProxy(data, executor, factories),
+    execute: (routeId, input, callOptions) => {
+      const route = findRoute(data, routeId);
+      if (route === undefined) {
+        return Effect.fail(new DalpRequestError(routeId, new TypeError(`Unknown DALP route \`${routeId}\``)));
+      }
+      return runRoute(transport, route, routeId, input, callOptions);
+    }
+  };
+}
+export {
+  DalpRequestError,
+  createDalpEffectClient
+};

package/dist/errors/api-error.d.ts

@@ -0,0 +1,29 @@
+import { findCurrentError } from "./find-current-error.ts";
+export type DalpApiErrorCategory = "client" | "auth" | "permission" | "domain" | "contract" | "dependency" | "operational" | "config" | "unknown";
+export interface DalpApiErrorOptions {
+    readonly message: string;
+    readonly cause?: unknown;
+    readonly id?: string;
+    readonly code: string;
+    readonly category: DalpApiErrorCategory;
+    readonly status?: number;
+    readonly retryable: boolean;
+    readonly why: string;
+    readonly fix: string;
+    readonly retryAfterSeconds?: number;
+}
+export declare class DalpApiError extends Error {
+    readonly id?: string;
+    readonly code: string;
+    readonly category: DalpApiErrorCategory;
+    readonly status?: number;
+    readonly retryable: boolean;
+    readonly why: string;
+    readonly fix: string;
+    readonly retryAfterSeconds?: number;
+    constructor(options: DalpApiErrorOptions);
+    static make(options: DalpApiErrorOptions): DalpApiError;
+}
+export declare const isDalpApiError: (error: unknown) => error is DalpApiError;
+export declare const findDalpSdkError: typeof findCurrentError;
+export declare const makeDalpApiError: (error: unknown) => DalpApiError;

package/dist/errors/find-current-error.d.ts

@@ -0,0 +1,8 @@
+import { DalpSdkError } from "./sdk-error.ts";
+/**
+ * Walk a nested SDK error graph and return the first DalpSdkError.
+ *
+ * Follows `cause` and `reasons[].error` / `reasons[].defect`. Stops after
+ * `maxNodes` so a cyclic wrapper cannot loop forever.
+ */
+export declare const findCurrentError: (error: unknown, maxNodes?: number) => DalpSdkError | undefined;