@lifi/composer-sdk 0.0.1-alpha

package/dist/errors.cjs

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  ComposeError: () => ComposeError,
+  errorFromHttpResponse: () => errorFromHttpResponse,
+  isComposeError: () => isComposeError
+});
+module.exports = __toCommonJS(errors_exports);
+class ComposeError extends Error {
+  name = "ComposeError";
+  /** Machine-readable error category. */
+  code;
+  /** HTTP status code, when the error originated from an HTTP response. */
+  status;
+  /** The request URL that produced the error. */
+  url;
+  /** Server-provided error kind for finer-grained classification. */
+  kind;
+  /** JSON-pointer path to the field that caused a validation error. */
+  path;
+  /**
+   * Simulation revert diagnostics attached to `simulation_revert` errors.
+   * Contains the raw error bytes and decoded error candidates when the
+   * backend can parse the revert reason.
+   */
+  details;
+  constructor(code, message, options) {
+    super(message, { cause: options?.cause });
+    this.code = code;
+    this.status = options?.status;
+    this.url = options?.url;
+    this.kind = options?.kind;
+    this.path = options?.path;
+    this.details = options?.details;
+  }
+}
+const isComposeError = (e) => e instanceof ComposeError || e instanceof Error && e.name === "ComposeError" && "code" in e;
+const STATUS_TO_CODE = /* @__PURE__ */ new Map([
+  [400, "VALIDATION_ERROR"],
+  [401, "UNAUTHENTICATED"],
+  [403, "FORBIDDEN"],
+  [404, "NOT_FOUND"],
+  [422, "VALIDATION_ERROR"],
+  [429, "RATE_LIMITED"]
+]);
+const tryParseErrorBody = (body) => {
+  try {
+    return JSON.parse(body);
+  } catch {
+    return null;
+  }
+};
+const errorFromHttpResponse = (status, body, url) => {
+  const parsed = tryParseErrorBody(body);
+  const serverError = parsed?.error;
+  return new ComposeError(
+    STATUS_TO_CODE.get(status) ?? (status >= 500 ? "SERVER_ERROR" : "UNKNOWN_ERROR"),
+    (serverError?.message ?? body) || `HTTP ${status}`,
+    {
+      status,
+      url,
+      kind: serverError?.kind,
+      path: serverError?.path,
+      details: serverError?.details
+    }
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ComposeError,
+  errorFromHttpResponse,
+  isComposeError
+});
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["import type { ComposeErrorKind, SimulationRevert } from '@lifi/compose-spec';\n\n/**\n * Machine-readable error codes returned by the SDK.\n *\n * - `NETWORK_ERROR` — The HTTP request failed (DNS, timeout, connection refused).\n * - `VALIDATION_ERROR` — The server rejected the request (HTTP 400/422).\n * - `UNAUTHENTICATED` — The request lacks valid authentication credentials (HTTP 401).\n * - `FORBIDDEN` — The server understood the request but refuses to authorise it (HTTP 403).\n * - `SERVER_ERROR` — The server returned a 5xx status.\n * - `RATE_LIMITED` — The server returned HTTP 429.\n * - `NOT_FOUND` — The requested resource does not exist (HTTP 404).\n * - `UNKNOWN_ERROR` — An unexpected error that doesn't fit other categories.\n */\nexport type ComposeErrorCode =\n  | 'NETWORK_ERROR'\n  | 'VALIDATION_ERROR'\n  | 'UNAUTHENTICATED'\n  | 'FORBIDDEN'\n  | 'SERVER_ERROR'\n  | 'RATE_LIMITED'\n  | 'NOT_FOUND'\n  | 'UNKNOWN_ERROR';\n\n/**\n * Error class for all failures originating from the Compose SDK or API.\n *\n * Includes structured metadata beyond the error message to support\n * programmatic error handling.\n *\n * @example\n * ```ts\n * try {\n *   await builder.compile(run);\n * } catch (e) {\n *   if (isComposeError(e) && e.code === 'VALIDATION_ERROR') {\n *     console.error('Invalid request:', e.message, e.path);\n *   }\n * }\n * ```\n */\nexport class ComposeError extends Error {\n  override readonly name = 'ComposeError';\n  /** Machine-readable error category. */\n  readonly code: ComposeErrorCode;\n  /** HTTP status code, when the error originated from an HTTP response. */\n  readonly status?: number;\n  /** The request URL that produced the error. */\n  readonly url?: string;\n  /** Server-provided error kind for finer-grained classification. */\n  readonly kind?: ComposeErrorKind;\n  /** JSON-pointer path to the field that caused a validation error. */\n  readonly path?: string;\n  /**\n   * Simulation revert diagnostics attached to `simulation_revert` errors.\n   * Contains the raw error bytes and decoded error candidates when the\n   * backend can parse the revert reason.\n   */\n  readonly details?: SimulationRevert;\n\n  constructor(\n    code: ComposeErrorCode,\n    message: string,\n    options?: {\n      status?: number;\n      url?: string;\n      cause?: unknown;\n      kind?: ComposeErrorKind;\n      path?: string;\n      details?: SimulationRevert;\n    },\n  ) {\n    super(message, { cause: options?.cause });\n    this.code = code;\n    this.status = options?.status;\n    this.url = options?.url;\n    this.kind = options?.kind;\n    this.path = options?.path;\n    this.details = options?.details;\n  }\n}\n\n/**\n * Type guard that narrows an unknown error to {@link ComposeError}.\n * @param e - The value to check.\n * @returns `true` if `e` is an instance of `ComposeError`.\n */\nexport const isComposeError = (e: unknown): e is ComposeError =>\n  e instanceof ComposeError ||\n  (e instanceof Error && e.name === 'ComposeError' && 'code' in e);\n\nconst STATUS_TO_CODE: ReadonlyMap<number, ComposeErrorCode> = new Map<\n  number,\n  ComposeErrorCode\n>([\n  [400, 'VALIDATION_ERROR'],\n  [401, 'UNAUTHENTICATED'],\n  [403, 'FORBIDDEN'],\n  [404, 'NOT_FOUND'],\n  [422, 'VALIDATION_ERROR'],\n  [429, 'RATE_LIMITED'],\n]);\n\ninterface ServerErrorBody {\n  readonly error?: {\n    readonly kind?: string;\n    readonly message?: string;\n    readonly path?: string;\n    readonly details?: SimulationRevert;\n  };\n}\n\nconst tryParseErrorBody = (body: string): ServerErrorBody | null => {\n  try {\n    return JSON.parse(body) as ServerErrorBody;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Constructs a {@link ComposeError} from an HTTP error response, extracting\n * structured error details from the response body when available.\n *\n * @param status - The HTTP status code.\n * @param body - The raw response body text.\n * @param url - The request URL that produced the error.\n * @returns A `ComposeError` with the appropriate error code and metadata.\n */\nexport const errorFromHttpResponse = (\n  status: number,\n  body: string,\n  url: string,\n): ComposeError => {\n  const parsed = tryParseErrorBody(body);\n  const serverError = parsed?.error;\n\n  return new ComposeError(\n    STATUS_TO_CODE.get(status) ??\n      (status >= 500 ? 'SERVER_ERROR' : 'UNKNOWN_ERROR'),\n    (serverError?.message ?? body) || `HTTP ${status}`,\n    {\n      status,\n      url,\n      kind: serverError?.kind as ComposeErrorKind | undefined,\n      path: serverError?.path,\n      details: serverError?.details,\n    },\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCO,MAAM,qBAAqB,MAAM;AAAA,EACpB,OAAO;AAAA;AAAA,EAEhB;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA;AAAA,EAET,YACE,MACA,SACA,SAQA;AACA,UAAM,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;AACxC,SAAK,OAAO;AACZ,SAAK,SAAS,SAAS;AACvB,SAAK,MAAM,SAAS;AACpB,SAAK,OAAO,SAAS;AACrB,SAAK,OAAO,SAAS;AACrB,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;AAOO,MAAM,iBAAiB,CAAC,MAC7B,aAAa,gBACZ,aAAa,SAAS,EAAE,SAAS,kBAAkB,UAAU;AAEhE,MAAM,iBAAwD,oBAAI,IAGhE;AAAA,EACA,CAAC,KAAK,kBAAkB;AAAA,EACxB,CAAC,KAAK,iBAAiB;AAAA,EACvB,CAAC,KAAK,WAAW;AAAA,EACjB,CAAC,KAAK,WAAW;AAAA,EACjB,CAAC,KAAK,kBAAkB;AAAA,EACxB,CAAC,KAAK,cAAc;AACtB,CAAC;AAWD,MAAM,oBAAoB,CAAC,SAAyC;AAClE,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWO,MAAM,wBAAwB,CACnC,QACA,MACA,QACiB;AACjB,QAAM,SAAS,kBAAkB,IAAI;AACrC,QAAM,cAAc,QAAQ;AAE5B,SAAO,IAAI;AAAA,IACT,eAAe,IAAI,MAAM,MACtB,UAAU,MAAM,iBAAiB;AAAA,KACnC,aAAa,WAAW,SAAS,QAAQ,MAAM;AAAA,IAChD;AAAA,MACE;AAAA,MACA;AAAA,MACA,MAAM,aAAa;AAAA,MACnB,MAAM,aAAa;AAAA,MACnB,SAAS,aAAa;AAAA,IACxB;AAAA,EACF;AACF;","names":[]}

package/dist/errors.d.cts

@@ -0,0 +1,77 @@
+import { ComposeErrorKind, SimulationRevert } from '@lifi/compose-spec';
+
+/**
+ * Machine-readable error codes returned by the SDK.
+ *
+ * - `NETWORK_ERROR` — The HTTP request failed (DNS, timeout, connection refused).
+ * - `VALIDATION_ERROR` — The server rejected the request (HTTP 400/422).
+ * - `UNAUTHENTICATED` — The request lacks valid authentication credentials (HTTP 401).
+ * - `FORBIDDEN` — The server understood the request but refuses to authorise it (HTTP 403).
+ * - `SERVER_ERROR` — The server returned a 5xx status.
+ * - `RATE_LIMITED` — The server returned HTTP 429.
+ * - `NOT_FOUND` — The requested resource does not exist (HTTP 404).
+ * - `UNKNOWN_ERROR` — An unexpected error that doesn't fit other categories.
+ */
+type ComposeErrorCode = 'NETWORK_ERROR' | 'VALIDATION_ERROR' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'SERVER_ERROR' | 'RATE_LIMITED' | 'NOT_FOUND' | 'UNKNOWN_ERROR';
+/**
+ * Error class for all failures originating from the Compose SDK or API.
+ *
+ * Includes structured metadata beyond the error message to support
+ * programmatic error handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await builder.compile(run);
+ * } catch (e) {
+ *   if (isComposeError(e) && e.code === 'VALIDATION_ERROR') {
+ *     console.error('Invalid request:', e.message, e.path);
+ *   }
+ * }
+ * ```
+ */
+declare class ComposeError extends Error {
+    readonly name = "ComposeError";
+    /** Machine-readable error category. */
+    readonly code: ComposeErrorCode;
+    /** HTTP status code, when the error originated from an HTTP response. */
+    readonly status?: number;
+    /** The request URL that produced the error. */
+    readonly url?: string;
+    /** Server-provided error kind for finer-grained classification. */
+    readonly kind?: ComposeErrorKind;
+    /** JSON-pointer path to the field that caused a validation error. */
+    readonly path?: string;
+    /**
+     * Simulation revert diagnostics attached to `simulation_revert` errors.
+     * Contains the raw error bytes and decoded error candidates when the
+     * backend can parse the revert reason.
+     */
+    readonly details?: SimulationRevert;
+    constructor(code: ComposeErrorCode, message: string, options?: {
+        status?: number;
+        url?: string;
+        cause?: unknown;
+        kind?: ComposeErrorKind;
+        path?: string;
+        details?: SimulationRevert;
+    });
+}
+/**
+ * Type guard that narrows an unknown error to {@link ComposeError}.
+ * @param e - The value to check.
+ * @returns `true` if `e` is an instance of `ComposeError`.
+ */
+declare const isComposeError: (e: unknown) => e is ComposeError;
+/**
+ * Constructs a {@link ComposeError} from an HTTP error response, extracting
+ * structured error details from the response body when available.
+ *
+ * @param status - The HTTP status code.
+ * @param body - The raw response body text.
+ * @param url - The request URL that produced the error.
+ * @returns A `ComposeError` with the appropriate error code and metadata.
+ */
+declare const errorFromHttpResponse: (status: number, body: string, url: string) => ComposeError;
+
+export { ComposeError, type ComposeErrorCode, errorFromHttpResponse, isComposeError };

package/dist/errors.d.ts

@@ -0,0 +1,77 @@
+import { ComposeErrorKind, SimulationRevert } from '@lifi/compose-spec';
+
+/**
+ * Machine-readable error codes returned by the SDK.
+ *
+ * - `NETWORK_ERROR` — The HTTP request failed (DNS, timeout, connection refused).
+ * - `VALIDATION_ERROR` — The server rejected the request (HTTP 400/422).
+ * - `UNAUTHENTICATED` — The request lacks valid authentication credentials (HTTP 401).
+ * - `FORBIDDEN` — The server understood the request but refuses to authorise it (HTTP 403).
+ * - `SERVER_ERROR` — The server returned a 5xx status.
+ * - `RATE_LIMITED` — The server returned HTTP 429.
+ * - `NOT_FOUND` — The requested resource does not exist (HTTP 404).
+ * - `UNKNOWN_ERROR` — An unexpected error that doesn't fit other categories.
+ */
+type ComposeErrorCode = 'NETWORK_ERROR' | 'VALIDATION_ERROR' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'SERVER_ERROR' | 'RATE_LIMITED' | 'NOT_FOUND' | 'UNKNOWN_ERROR';
+/**
+ * Error class for all failures originating from the Compose SDK or API.
+ *
+ * Includes structured metadata beyond the error message to support
+ * programmatic error handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await builder.compile(run);
+ * } catch (e) {
+ *   if (isComposeError(e) && e.code === 'VALIDATION_ERROR') {
+ *     console.error('Invalid request:', e.message, e.path);
+ *   }
+ * }
+ * ```
+ */
+declare class ComposeError extends Error {
+    readonly name = "ComposeError";
+    /** Machine-readable error category. */
+    readonly code: ComposeErrorCode;
+    /** HTTP status code, when the error originated from an HTTP response. */
+    readonly status?: number;
+    /** The request URL that produced the error. */
+    readonly url?: string;
+    /** Server-provided error kind for finer-grained classification. */
+    readonly kind?: ComposeErrorKind;
+    /** JSON-pointer path to the field that caused a validation error. */
+    readonly path?: string;
+    /**
+     * Simulation revert diagnostics attached to `simulation_revert` errors.
+     * Contains the raw error bytes and decoded error candidates when the
+     * backend can parse the revert reason.
+     */
+    readonly details?: SimulationRevert;
+    constructor(code: ComposeErrorCode, message: string, options?: {
+        status?: number;
+        url?: string;
+        cause?: unknown;
+        kind?: ComposeErrorKind;
+        path?: string;
+        details?: SimulationRevert;
+    });
+}
+/**
+ * Type guard that narrows an unknown error to {@link ComposeError}.
+ * @param e - The value to check.
+ * @returns `true` if `e` is an instance of `ComposeError`.
+ */
+declare const isComposeError: (e: unknown) => e is ComposeError;
+/**
+ * Constructs a {@link ComposeError} from an HTTP error response, extracting
+ * structured error details from the response body when available.
+ *
+ * @param status - The HTTP status code.
+ * @param body - The raw response body text.
+ * @param url - The request URL that produced the error.
+ * @returns A `ComposeError` with the appropriate error code and metadata.
+ */
+declare const errorFromHttpResponse: (status: number, body: string, url: string) => ComposeError;
+
+export { ComposeError, type ComposeErrorCode, errorFromHttpResponse, isComposeError };

package/dist/errors.js

@@ -0,0 +1,65 @@
+class ComposeError extends Error {
+  name = "ComposeError";
+  /** Machine-readable error category. */
+  code;
+  /** HTTP status code, when the error originated from an HTTP response. */
+  status;
+  /** The request URL that produced the error. */
+  url;
+  /** Server-provided error kind for finer-grained classification. */
+  kind;
+  /** JSON-pointer path to the field that caused a validation error. */
+  path;
+  /**
+   * Simulation revert diagnostics attached to `simulation_revert` errors.
+   * Contains the raw error bytes and decoded error candidates when the
+   * backend can parse the revert reason.
+   */
+  details;
+  constructor(code, message, options) {
+    super(message, { cause: options?.cause });
+    this.code = code;
+    this.status = options?.status;
+    this.url = options?.url;
+    this.kind = options?.kind;
+    this.path = options?.path;
+    this.details = options?.details;
+  }
+}
+const isComposeError = (e) => e instanceof ComposeError || e instanceof Error && e.name === "ComposeError" && "code" in e;
+const STATUS_TO_CODE = /* @__PURE__ */ new Map([
+  [400, "VALIDATION_ERROR"],
+  [401, "UNAUTHENTICATED"],
+  [403, "FORBIDDEN"],
+  [404, "NOT_FOUND"],
+  [422, "VALIDATION_ERROR"],
+  [429, "RATE_LIMITED"]
+]);
+const tryParseErrorBody = (body) => {
+  try {
+    return JSON.parse(body);
+  } catch {
+    return null;
+  }
+};
+const errorFromHttpResponse = (status, body, url) => {
+  const parsed = tryParseErrorBody(body);
+  const serverError = parsed?.error;
+  return new ComposeError(
+    STATUS_TO_CODE.get(status) ?? (status >= 500 ? "SERVER_ERROR" : "UNKNOWN_ERROR"),
+    (serverError?.message ?? body) || `HTTP ${status}`,
+    {
+      status,
+      url,
+      kind: serverError?.kind,
+      path: serverError?.path,
+      details: serverError?.details
+    }
+  );
+};
+export {
+  ComposeError,
+  errorFromHttpResponse,
+  isComposeError
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["import type { ComposeErrorKind, SimulationRevert } from '@lifi/compose-spec';\n\n/**\n * Machine-readable error codes returned by the SDK.\n *\n * - `NETWORK_ERROR` — The HTTP request failed (DNS, timeout, connection refused).\n * - `VALIDATION_ERROR` — The server rejected the request (HTTP 400/422).\n * - `UNAUTHENTICATED` — The request lacks valid authentication credentials (HTTP 401).\n * - `FORBIDDEN` — The server understood the request but refuses to authorise it (HTTP 403).\n * - `SERVER_ERROR` — The server returned a 5xx status.\n * - `RATE_LIMITED` — The server returned HTTP 429.\n * - `NOT_FOUND` — The requested resource does not exist (HTTP 404).\n * - `UNKNOWN_ERROR` — An unexpected error that doesn't fit other categories.\n */\nexport type ComposeErrorCode =\n  | 'NETWORK_ERROR'\n  | 'VALIDATION_ERROR'\n  | 'UNAUTHENTICATED'\n  | 'FORBIDDEN'\n  | 'SERVER_ERROR'\n  | 'RATE_LIMITED'\n  | 'NOT_FOUND'\n  | 'UNKNOWN_ERROR';\n\n/**\n * Error class for all failures originating from the Compose SDK or API.\n *\n * Includes structured metadata beyond the error message to support\n * programmatic error handling.\n *\n * @example\n * ```ts\n * try {\n *   await builder.compile(run);\n * } catch (e) {\n *   if (isComposeError(e) && e.code === 'VALIDATION_ERROR') {\n *     console.error('Invalid request:', e.message, e.path);\n *   }\n * }\n * ```\n */\nexport class ComposeError extends Error {\n  override readonly name = 'ComposeError';\n  /** Machine-readable error category. */\n  readonly code: ComposeErrorCode;\n  /** HTTP status code, when the error originated from an HTTP response. */\n  readonly status?: number;\n  /** The request URL that produced the error. */\n  readonly url?: string;\n  /** Server-provided error kind for finer-grained classification. */\n  readonly kind?: ComposeErrorKind;\n  /** JSON-pointer path to the field that caused a validation error. */\n  readonly path?: string;\n  /**\n   * Simulation revert diagnostics attached to `simulation_revert` errors.\n   * Contains the raw error bytes and decoded error candidates when the\n   * backend can parse the revert reason.\n   */\n  readonly details?: SimulationRevert;\n\n  constructor(\n    code: ComposeErrorCode,\n    message: string,\n    options?: {\n      status?: number;\n      url?: string;\n      cause?: unknown;\n      kind?: ComposeErrorKind;\n      path?: string;\n      details?: SimulationRevert;\n    },\n  ) {\n    super(message, { cause: options?.cause });\n    this.code = code;\n    this.status = options?.status;\n    this.url = options?.url;\n    this.kind = options?.kind;\n    this.path = options?.path;\n    this.details = options?.details;\n  }\n}\n\n/**\n * Type guard that narrows an unknown error to {@link ComposeError}.\n * @param e - The value to check.\n * @returns `true` if `e` is an instance of `ComposeError`.\n */\nexport const isComposeError = (e: unknown): e is ComposeError =>\n  e instanceof ComposeError ||\n  (e instanceof Error && e.name === 'ComposeError' && 'code' in e);\n\nconst STATUS_TO_CODE: ReadonlyMap<number, ComposeErrorCode> = new Map<\n  number,\n  ComposeErrorCode\n>([\n  [400, 'VALIDATION_ERROR'],\n  [401, 'UNAUTHENTICATED'],\n  [403, 'FORBIDDEN'],\n  [404, 'NOT_FOUND'],\n  [422, 'VALIDATION_ERROR'],\n  [429, 'RATE_LIMITED'],\n]);\n\ninterface ServerErrorBody {\n  readonly error?: {\n    readonly kind?: string;\n    readonly message?: string;\n    readonly path?: string;\n    readonly details?: SimulationRevert;\n  };\n}\n\nconst tryParseErrorBody = (body: string): ServerErrorBody | null => {\n  try {\n    return JSON.parse(body) as ServerErrorBody;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Constructs a {@link ComposeError} from an HTTP error response, extracting\n * structured error details from the response body when available.\n *\n * @param status - The HTTP status code.\n * @param body - The raw response body text.\n * @param url - The request URL that produced the error.\n * @returns A `ComposeError` with the appropriate error code and metadata.\n */\nexport const errorFromHttpResponse = (\n  status: number,\n  body: string,\n  url: string,\n): ComposeError => {\n  const parsed = tryParseErrorBody(body);\n  const serverError = parsed?.error;\n\n  return new ComposeError(\n    STATUS_TO_CODE.get(status) ??\n      (status >= 500 ? 'SERVER_ERROR' : 'UNKNOWN_ERROR'),\n    (serverError?.message ?? body) || `HTTP ${status}`,\n    {\n      status,\n      url,\n      kind: serverError?.kind as ComposeErrorKind | undefined,\n      path: serverError?.path,\n      details: serverError?.details,\n    },\n  );\n};\n"],"mappings":"AAyCO,MAAM,qBAAqB,MAAM;AAAA,EACpB,OAAO;AAAA;AAAA,EAEhB;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA;AAAA,EAET,YACE,MACA,SACA,SAQA;AACA,UAAM,SAAS,EAAE,OAAO,SAAS,MAAM,CAAC;AACxC,SAAK,OAAO;AACZ,SAAK,SAAS,SAAS;AACvB,SAAK,MAAM,SAAS;AACpB,SAAK,OAAO,SAAS;AACrB,SAAK,OAAO,SAAS;AACrB,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;AAOO,MAAM,iBAAiB,CAAC,MAC7B,aAAa,gBACZ,aAAa,SAAS,EAAE,SAAS,kBAAkB,UAAU;AAEhE,MAAM,iBAAwD,oBAAI,IAGhE;AAAA,EACA,CAAC,KAAK,kBAAkB;AAAA,EACxB,CAAC,KAAK,iBAAiB;AAAA,EACvB,CAAC,KAAK,WAAW;AAAA,EACjB,CAAC,KAAK,WAAW;AAAA,EACjB,CAAC,KAAK,kBAAkB;AAAA,EACxB,CAAC,KAAK,cAAc;AACtB,CAAC;AAWD,MAAM,oBAAoB,CAAC,SAAyC;AAClE,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWO,MAAM,wBAAwB,CACnC,QACA,MACA,QACiB;AACjB,QAAM,SAAS,kBAAkB,IAAI;AACrC,QAAM,cAAc,QAAQ;AAE5B,SAAO,IAAI;AAAA,IACT,eAAe,IAAI,MAAM,MACtB,UAAU,MAAM,iBAAiB;AAAA,KACnC,aAAa,WAAW,SAAS,QAAQ,MAAM;AAAA,IAChD;AAAA,MACE;AAAA,MACA;AAAA,MACA,MAAM,aAAa;AAAA,MACnB,MAAM,aAAa;AAAA,MACnB,SAAS,aAAa;AAAA,IACxB;AAAA,EACF;AACF;","names":[]}

package/dist/generated/config.generated.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var config_generated_exports = {};
+module.exports = __toCommonJS(config_generated_exports);
+//# sourceMappingURL=config.generated.cjs.map

package/dist/generated/config.generated.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/generated/config.generated.ts"],"sourcesContent":["// AUTO-GENERATED from manifest.json — do not edit by hand.\n// Regenerate with: yarn workspace @lifi/composer-sdk generate\n\nimport type { Address, IntegerStringInput } from '../types.js';\n\nexport interface CoreSplitConfig {\n  bps: number;\n}\n\n/**\n * a positive number\n */\nexport type Positive = number;\n\nexport interface LifiSwapConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n  slippage?: number;\n  timing?: {\n    swapStepTimingStrategies?: {\n      strategy: 'minWaitTime';\n      minWaitTimeMs: number;\n      startingExpectedResults: number;\n      reduceEveryMs: number;\n    }[];\n    routeTimingStrategies?: {\n      strategy: 'minWaitTime';\n      minWaitTimeMs: number;\n      startingExpectedResults: number;\n      reduceEveryMs: number;\n    }[];\n  };\n}\n\nexport interface LifiZapConfig {\n  resourceOut:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface CoreBpsDownConfig {\n  bps: number;\n}\n\nexport interface CoreBpsUpConfig {\n  bps: number;\n}\n\nexport interface CoreApproveConfig {\n  spender: Address;\n}\n\nexport interface CoreBalanceOfConfig {\n  token: Address;\n  owner?: Address;\n}\n\nexport interface CoreTransferConfig {\n  amount?: IntegerStringInput;\n}\n\nexport interface CoreCallConfig {\n  target: Address;\n  functionSignature: string;\n  callType?: 'Call' | 'ValueCall';\n  args?: Unknown[];\n  approvals?: {\n    spender: Address;\n  }[];\n}\nexport interface Unknown {\n  [k: string]: unknown;\n}\n\nexport interface CoreStaticCallConfig {\n  target: Address;\n  functionSignature: string;\n  args?: Unknown[];\n}\n\nexport interface CoreRawCallConfig {\n  target: Address;\n  calldata: string;\n  callType?: 'Call' | 'StaticCall' | 'ValueCall' | 'DelegateCall';\n  resultType?: string;\n}\n\nexport interface CoreInvokeConfig {\n  target: Address;\n  functionSignature: string;\n  callType?: 'Call' | 'ValueCall';\n  args?: Unknown[];\n}\n\nexport interface CoreAsResourceConfig {\n  resource:\n    | {\n        kind: 'native';\n        chainId: Positive;\n      }\n    | {\n        kind: 'erc20';\n        token: Address;\n        chainId: Positive;\n      };\n}\n\nexport interface CorePeekConfig {\n  target: Address;\n  functionSignature: string;\n  args?: string[];\n}\n\n/**\n * a number between 0 and 10000\n */\nexport type Between010000 = number;\n\nexport interface SlippageGuardConfig {\n  port: string;\n  bps: Between010000;\n}\n\nexport interface BalanceOfMaterialiserConfig {\n  owner: Address;\n}\n\nexport type DirectDepositMaterialiserConfig =\n  | {\n      amount: IntegerStringInput;\n      allowNonExact?: false;\n    }\n  | {\n      amount?: IntegerStringInput;\n      allowNonExact: true;\n    };\n\nexport interface CallMaterialiserConfig {\n  target: Address;\n  calldata: string;\n}\n\nexport interface Erc20BalancePreconditionConfig {\n  wallet: Address;\n  token: Address;\n  balance: IntegerStringInput;\n}\n\nexport interface NativeBalancePreconditionConfig {\n  wallet: Address;\n  balance: IntegerStringInput;\n}\n\nexport interface Erc20AllowancePreconditionConfig {\n  owner: Address;\n  spender: Address;\n  token: Address;\n  allowance: IntegerStringInput;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/generated/config.generated.d.cts

@@ -0,0 +1,144 @@
+import { Address, IntegerStringInput } from '../types.cjs';
+import '@lifi/compose-spec';
+
+interface CoreSplitConfig {
+    bps: number;
+}
+/**
+ * a positive number
+ */
+type Positive = number;
+interface LifiSwapConfig {
+    resourceOut: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+    slippage?: number;
+    timing?: {
+        swapStepTimingStrategies?: {
+            strategy: 'minWaitTime';
+            minWaitTimeMs: number;
+            startingExpectedResults: number;
+            reduceEveryMs: number;
+        }[];
+        routeTimingStrategies?: {
+            strategy: 'minWaitTime';
+            minWaitTimeMs: number;
+            startingExpectedResults: number;
+            reduceEveryMs: number;
+        }[];
+    };
+}
+interface LifiZapConfig {
+    resourceOut: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+}
+interface CoreBpsDownConfig {
+    bps: number;
+}
+interface CoreBpsUpConfig {
+    bps: number;
+}
+interface CoreApproveConfig {
+    spender: Address;
+}
+interface CoreBalanceOfConfig {
+    token: Address;
+    owner?: Address;
+}
+interface CoreTransferConfig {
+    amount?: IntegerStringInput;
+}
+interface CoreCallConfig {
+    target: Address;
+    functionSignature: string;
+    callType?: 'Call' | 'ValueCall';
+    args?: Unknown[];
+    approvals?: {
+        spender: Address;
+    }[];
+}
+interface Unknown {
+    [k: string]: unknown;
+}
+interface CoreStaticCallConfig {
+    target: Address;
+    functionSignature: string;
+    args?: Unknown[];
+}
+interface CoreRawCallConfig {
+    target: Address;
+    calldata: string;
+    callType?: 'Call' | 'StaticCall' | 'ValueCall' | 'DelegateCall';
+    resultType?: string;
+}
+interface CoreInvokeConfig {
+    target: Address;
+    functionSignature: string;
+    callType?: 'Call' | 'ValueCall';
+    args?: Unknown[];
+}
+interface CoreAsResourceConfig {
+    resource: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+}
+interface CorePeekConfig {
+    target: Address;
+    functionSignature: string;
+    args?: string[];
+}
+/**
+ * a number between 0 and 10000
+ */
+type Between010000 = number;
+interface SlippageGuardConfig {
+    port: string;
+    bps: Between010000;
+}
+interface BalanceOfMaterialiserConfig {
+    owner: Address;
+}
+type DirectDepositMaterialiserConfig = {
+    amount: IntegerStringInput;
+    allowNonExact?: false;
+} | {
+    amount?: IntegerStringInput;
+    allowNonExact: true;
+};
+interface CallMaterialiserConfig {
+    target: Address;
+    calldata: string;
+}
+interface Erc20BalancePreconditionConfig {
+    wallet: Address;
+    token: Address;
+    balance: IntegerStringInput;
+}
+interface NativeBalancePreconditionConfig {
+    wallet: Address;
+    balance: IntegerStringInput;
+}
+interface Erc20AllowancePreconditionConfig {
+    owner: Address;
+    spender: Address;
+    token: Address;
+    allowance: IntegerStringInput;
+}
+
+export type { BalanceOfMaterialiserConfig, Between010000, CallMaterialiserConfig, CoreApproveConfig, CoreAsResourceConfig, CoreBalanceOfConfig, CoreBpsDownConfig, CoreBpsUpConfig, CoreCallConfig, CoreInvokeConfig, CorePeekConfig, CoreRawCallConfig, CoreSplitConfig, CoreStaticCallConfig, CoreTransferConfig, DirectDepositMaterialiserConfig, Erc20AllowancePreconditionConfig, Erc20BalancePreconditionConfig, LifiSwapConfig, LifiZapConfig, NativeBalancePreconditionConfig, Positive, SlippageGuardConfig, Unknown };

package/dist/generated/config.generated.d.ts

@@ -0,0 +1,144 @@
+import { Address, IntegerStringInput } from '../types.js';
+import '@lifi/compose-spec';
+
+interface CoreSplitConfig {
+    bps: number;
+}
+/**
+ * a positive number
+ */
+type Positive = number;
+interface LifiSwapConfig {
+    resourceOut: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+    slippage?: number;
+    timing?: {
+        swapStepTimingStrategies?: {
+            strategy: 'minWaitTime';
+            minWaitTimeMs: number;
+            startingExpectedResults: number;
+            reduceEveryMs: number;
+        }[];
+        routeTimingStrategies?: {
+            strategy: 'minWaitTime';
+            minWaitTimeMs: number;
+            startingExpectedResults: number;
+            reduceEveryMs: number;
+        }[];
+    };
+}
+interface LifiZapConfig {
+    resourceOut: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+}
+interface CoreBpsDownConfig {
+    bps: number;
+}
+interface CoreBpsUpConfig {
+    bps: number;
+}
+interface CoreApproveConfig {
+    spender: Address;
+}
+interface CoreBalanceOfConfig {
+    token: Address;
+    owner?: Address;
+}
+interface CoreTransferConfig {
+    amount?: IntegerStringInput;
+}
+interface CoreCallConfig {
+    target: Address;
+    functionSignature: string;
+    callType?: 'Call' | 'ValueCall';
+    args?: Unknown[];
+    approvals?: {
+        spender: Address;
+    }[];
+}
+interface Unknown {
+    [k: string]: unknown;
+}
+interface CoreStaticCallConfig {
+    target: Address;
+    functionSignature: string;
+    args?: Unknown[];
+}
+interface CoreRawCallConfig {
+    target: Address;
+    calldata: string;
+    callType?: 'Call' | 'StaticCall' | 'ValueCall' | 'DelegateCall';
+    resultType?: string;
+}
+interface CoreInvokeConfig {
+    target: Address;
+    functionSignature: string;
+    callType?: 'Call' | 'ValueCall';
+    args?: Unknown[];
+}
+interface CoreAsResourceConfig {
+    resource: {
+        kind: 'native';
+        chainId: Positive;
+    } | {
+        kind: 'erc20';
+        token: Address;
+        chainId: Positive;
+    };
+}
+interface CorePeekConfig {
+    target: Address;
+    functionSignature: string;
+    args?: string[];
+}
+/**
+ * a number between 0 and 10000
+ */
+type Between010000 = number;
+interface SlippageGuardConfig {
+    port: string;
+    bps: Between010000;
+}
+interface BalanceOfMaterialiserConfig {
+    owner: Address;
+}
+type DirectDepositMaterialiserConfig = {
+    amount: IntegerStringInput;
+    allowNonExact?: false;
+} | {
+    amount?: IntegerStringInput;
+    allowNonExact: true;
+};
+interface CallMaterialiserConfig {
+    target: Address;
+    calldata: string;
+}
+interface Erc20BalancePreconditionConfig {
+    wallet: Address;
+    token: Address;
+    balance: IntegerStringInput;
+}
+interface NativeBalancePreconditionConfig {
+    wallet: Address;
+    balance: IntegerStringInput;
+}
+interface Erc20AllowancePreconditionConfig {
+    owner: Address;
+    spender: Address;
+    token: Address;
+    allowance: IntegerStringInput;
+}
+
+export type { BalanceOfMaterialiserConfig, Between010000, CallMaterialiserConfig, CoreApproveConfig, CoreAsResourceConfig, CoreBalanceOfConfig, CoreBpsDownConfig, CoreBpsUpConfig, CoreCallConfig, CoreInvokeConfig, CorePeekConfig, CoreRawCallConfig, CoreSplitConfig, CoreStaticCallConfig, CoreTransferConfig, DirectDepositMaterialiserConfig, Erc20AllowancePreconditionConfig, Erc20BalancePreconditionConfig, LifiSwapConfig, LifiZapConfig, NativeBalancePreconditionConfig, Positive, SlippageGuardConfig, Unknown };

package/dist/generated/config.generated.js

@@ -0,0 +1 @@
+//# sourceMappingURL=config.generated.js.map

package/dist/generated/config.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}