@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.0

package/dist/esm/core/index.js

@@ -0,0 +1,19 @@
+/**
+ * @module core
+ * @description Core infrastructure — client creation and RPC connection.
+ *
+ * @example
+ * ```ts
+ * import { SapClient, SapConnection } from "@synapse-sap/sdk";
+ *
+ * // From Anchor provider
+ * const client = SapClient.from(provider);
+ *
+ * // From RPC URL + keypair (synapse-client-sdk compatible)
+ * const conn = SapConnection.devnet();
+ * const client2 = conn.fromKeypair(keypair);
+ * ```
+ */
+export { SapClient } from "./client";
+export { SapConnection, KeypairWallet } from "./connection";
+//# sourceMappingURL=index.js.map

package/dist/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/errors/index.d.ts

@@ -0,0 +1,276 @@
+/**
+ * @module errors
+ * @description Typed error classes for the SAP v2 SDK.
+ *
+ * All SDK errors extend {@link SapError} to allow catch-all handling,
+ * while concrete subclasses enable fine-grained error matching.
+ *
+ * @category Errors
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SapError, SapRpcError, SapAccountNotFoundError } from "@synapse-sap/sdk/errors";
+ *
+ * try {
+ *   const agent = await client.agent.fetch();
+ * } catch (err) {
+ *   if (err instanceof SapAccountNotFoundError) {
+ *     console.log("Agent not registered yet");
+ *   } else if (err instanceof SapRpcError) {
+ *     console.error("RPC failure:", err.rpcCode);
+ *   } else if (err instanceof SapError) {
+ *     console.error("SAP error:", err.message);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ * @see {@link SapValidationError}
+ * @see {@link SapRpcError}
+ * @see {@link SapAccountNotFoundError}
+ * @see {@link SapTimeoutError}
+ * @see {@link SapPermissionError}
+ */
+/**
+ * @name SapError
+ * @description Base class for all SAP SDK errors.
+ *
+ * Extends `Error` and sets `name` automatically so `instanceof`
+ * checks work correctly in both CJS and ESM environments.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {Error}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.fetch();
+ * } catch (err) {
+ *   if (err instanceof SapError) {
+ *     console.error(`[${err.code}] ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapValidationError}
+ * @see {@link SapRpcError}
+ * @see {@link SapAccountNotFoundError}
+ * @see {@link SapTimeoutError}
+ * @see {@link SapPermissionError}
+ */
+export declare class SapError extends Error {
+    /**
+     * @description Machine-readable error code for programmatic handling.
+     * @readonly
+     */
+    readonly code: string;
+    /**
+     * @param message - A human-readable description of the error.
+     * @param code    - Machine-readable error code (defaults to `"SAP_ERROR"`).
+     */
+    constructor(message: string, code?: string);
+}
+/**
+ * @name SapValidationError
+ * @description Thrown when SDK-side input validation fails before sending a
+ * transaction or making an RPC call.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.register({ name: "" });
+ * } catch (err) {
+ *   if (err instanceof SapValidationError) {
+ *     console.error(`Validation failed on field "${err.field}": ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export declare class SapValidationError extends SapError {
+    /**
+     * @description Field or parameter that failed validation (if applicable).
+     * @readonly
+     */
+    readonly field?: string;
+    /**
+     * @param message - A human-readable description of the validation failure.
+     * @param field   - The name of the field or parameter that failed validation.
+     */
+    constructor(message: string, field?: string);
+}
+/**
+ * @name SapRpcError
+ * @description Wraps Solana RPC or Anchor transaction errors with additional
+ * context (error code, logs).
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.register(params);
+ * } catch (err) {
+ *   if (err instanceof SapRpcError) {
+ *     console.error(`RPC error ${err.rpcCode}: ${err.message}`);
+ *     err.logs?.forEach((log) => console.debug(log));
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapRpcError.fromAnchor}
+ * @see {@link SapError}
+ */
+export declare class SapRpcError extends SapError {
+    /**
+     * @description Anchor / program error code, if available.
+     * @readonly
+     */
+    readonly rpcCode?: number;
+    /**
+     * @description Transaction logs returned by the RPC node.
+     * @readonly
+     */
+    readonly logs?: readonly string[];
+    /**
+     * @param message - A human-readable description of the RPC or transaction error.
+     * @param opts    - Optional additional context.
+     * @param opts.rpcCode - Anchor or Solana program error code.
+     * @param opts.logs    - Raw transaction logs from the RPC node.
+     */
+    constructor(message: string, opts?: {
+        rpcCode?: number;
+        logs?: readonly string[];
+    });
+    /**
+     * @static
+     * @description Create a {@link SapRpcError} from an Anchor-style error object.
+     * Extracts `code` and `logs` automatically from the Anchor error shape.
+     *
+     * @param err - The raw Anchor or Solana error object.
+     * @returns A new {@link SapRpcError} populated with extracted code, logs, and message.
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await program.methods.registerAgent(args).rpc();
+     * } catch (raw) {
+     *   throw SapRpcError.fromAnchor(raw);
+     * }
+     * ```
+     *
+     * @see {@link SapRpcError}
+     */
+    static fromAnchor(err: any): SapRpcError;
+}
+/**
+ * @name SapAccountNotFoundError
+ * @description Thrown when an expected on-chain account does not exist or has
+ * been closed.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const agent = await client.agent.fetch(agentPda);
+ * } catch (err) {
+ *   if (err instanceof SapAccountNotFoundError) {
+ *     console.warn(`Missing ${err.accountType ?? "account"}: ${err.address}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export declare class SapAccountNotFoundError extends SapError {
+    /**
+     * @description The base-58 encoded account address that was not found.
+     * @readonly
+     */
+    readonly address: string;
+    /**
+     * @description The expected account type (e.g. `"AgentRecord"`, `"VaultAccount"`).
+     * @readonly
+     */
+    readonly accountType?: string;
+    /**
+     * @param address     - The base-58 encoded address of the missing account.
+     * @param accountType - Optional label for the expected account type.
+     */
+    constructor(address: string, accountType?: string);
+}
+/**
+ * @name SapTimeoutError
+ * @description Thrown when an operation (e.g., transaction confirmation) exceeds
+ * the configured timeout.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.register(params, { timeoutMs: 30_000 });
+ * } catch (err) {
+ *   if (err instanceof SapTimeoutError) {
+ *     console.error(`Timed out after ${err.timeoutMs}ms: ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export declare class SapTimeoutError extends SapError {
+    /**
+     * @description Timeout duration in milliseconds that was exceeded.
+     * @readonly
+     */
+    readonly timeoutMs: number;
+    /**
+     * @param message   - A human-readable description of the timeout.
+     * @param timeoutMs - The timeout threshold in milliseconds.
+     */
+    constructor(message: string, timeoutMs: number);
+}
+/**
+ * @name SapPermissionError
+ * @description Thrown when the current wallet lacks the required permission
+ * (authority, delegate, etc.) for an operation.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.update(agentPda, updates);
+ * } catch (err) {
+ *   if (err instanceof SapPermissionError) {
+ *     console.error(`Permission denied: ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export declare class SapPermissionError extends SapError {
+    /**
+     * @param message - A human-readable description of the permission failure.
+     */
+    constructor(message: string);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,SAAc;CAOhD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAK5C;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAElC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE;IAQvD;;;;;;;;;;;;;;;;;;OAkBG;IAEH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW;CAOzC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAOlD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAK/C;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C;;OAEG;gBACS,OAAO,EAAE,MAAM;CAI5B"}

package/dist/esm/errors/index.js

@@ -0,0 +1,325 @@
+/**
+ * @module errors
+ * @description Typed error classes for the SAP v2 SDK.
+ *
+ * All SDK errors extend {@link SapError} to allow catch-all handling,
+ * while concrete subclasses enable fine-grained error matching.
+ *
+ * @category Errors
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SapError, SapRpcError, SapAccountNotFoundError } from "@synapse-sap/sdk/errors";
+ *
+ * try {
+ *   const agent = await client.agent.fetch();
+ * } catch (err) {
+ *   if (err instanceof SapAccountNotFoundError) {
+ *     console.log("Agent not registered yet");
+ *   } else if (err instanceof SapRpcError) {
+ *     console.error("RPC failure:", err.rpcCode);
+ *   } else if (err instanceof SapError) {
+ *     console.error("SAP error:", err.message);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ * @see {@link SapValidationError}
+ * @see {@link SapRpcError}
+ * @see {@link SapAccountNotFoundError}
+ * @see {@link SapTimeoutError}
+ * @see {@link SapPermissionError}
+ */
+// ═══════════════════════════════════════════════════════════════════
+//  Base Error
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapError
+ * @description Base class for all SAP SDK errors.
+ *
+ * Extends `Error` and sets `name` automatically so `instanceof`
+ * checks work correctly in both CJS and ESM environments.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {Error}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.fetch();
+ * } catch (err) {
+ *   if (err instanceof SapError) {
+ *     console.error(`[${err.code}] ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapValidationError}
+ * @see {@link SapRpcError}
+ * @see {@link SapAccountNotFoundError}
+ * @see {@link SapTimeoutError}
+ * @see {@link SapPermissionError}
+ */
+export class SapError extends Error {
+    /**
+     * @description Machine-readable error code for programmatic handling.
+     * @readonly
+     */
+    code;
+    /**
+     * @param message - A human-readable description of the error.
+     * @param code    - Machine-readable error code (defaults to `"SAP_ERROR"`).
+     */
+    constructor(message, code = "SAP_ERROR") {
+        super(message);
+        this.name = "SapError";
+        this.code = code;
+        // Fix prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Validation Error
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapValidationError
+ * @description Thrown when SDK-side input validation fails before sending a
+ * transaction or making an RPC call.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.register({ name: "" });
+ * } catch (err) {
+ *   if (err instanceof SapValidationError) {
+ *     console.error(`Validation failed on field "${err.field}": ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export class SapValidationError extends SapError {
+    /**
+     * @description Field or parameter that failed validation (if applicable).
+     * @readonly
+     */
+    field;
+    /**
+     * @param message - A human-readable description of the validation failure.
+     * @param field   - The name of the field or parameter that failed validation.
+     */
+    constructor(message, field) {
+        super(message, "SAP_VALIDATION_ERROR");
+        this.name = "SapValidationError";
+        this.field = field;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+//  RPC / Transaction Error
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapRpcError
+ * @description Wraps Solana RPC or Anchor transaction errors with additional
+ * context (error code, logs).
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.register(params);
+ * } catch (err) {
+ *   if (err instanceof SapRpcError) {
+ *     console.error(`RPC error ${err.rpcCode}: ${err.message}`);
+ *     err.logs?.forEach((log) => console.debug(log));
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapRpcError.fromAnchor}
+ * @see {@link SapError}
+ */
+export class SapRpcError extends SapError {
+    /**
+     * @description Anchor / program error code, if available.
+     * @readonly
+     */
+    rpcCode;
+    /**
+     * @description Transaction logs returned by the RPC node.
+     * @readonly
+     */
+    logs;
+    /**
+     * @param message - A human-readable description of the RPC or transaction error.
+     * @param opts    - Optional additional context.
+     * @param opts.rpcCode - Anchor or Solana program error code.
+     * @param opts.logs    - Raw transaction logs from the RPC node.
+     */
+    constructor(message, opts) {
+        super(message, "SAP_RPC_ERROR");
+        this.name = "SapRpcError";
+        this.rpcCode = opts?.rpcCode;
+        this.logs = opts?.logs;
+    }
+    /**
+     * @static
+     * @description Create a {@link SapRpcError} from an Anchor-style error object.
+     * Extracts `code` and `logs` automatically from the Anchor error shape.
+     *
+     * @param err - The raw Anchor or Solana error object.
+     * @returns A new {@link SapRpcError} populated with extracted code, logs, and message.
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await program.methods.registerAgent(args).rpc();
+     * } catch (raw) {
+     *   throw SapRpcError.fromAnchor(raw);
+     * }
+     * ```
+     *
+     * @see {@link SapRpcError}
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static fromAnchor(err) {
+        const code = err?.error?.errorCode?.number ?? err?.code;
+        const logs = err?.logs ?? err?.error?.logs ?? [];
+        const msg = err?.error?.errorMessage ?? err?.message ?? "Unknown RPC error";
+        return new SapRpcError(msg, { rpcCode: code, logs });
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Account Not Found
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapAccountNotFoundError
+ * @description Thrown when an expected on-chain account does not exist or has
+ * been closed.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const agent = await client.agent.fetch(agentPda);
+ * } catch (err) {
+ *   if (err instanceof SapAccountNotFoundError) {
+ *     console.warn(`Missing ${err.accountType ?? "account"}: ${err.address}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export class SapAccountNotFoundError extends SapError {
+    /**
+     * @description The base-58 encoded account address that was not found.
+     * @readonly
+     */
+    address;
+    /**
+     * @description The expected account type (e.g. `"AgentRecord"`, `"VaultAccount"`).
+     * @readonly
+     */
+    accountType;
+    /**
+     * @param address     - The base-58 encoded address of the missing account.
+     * @param accountType - Optional label for the expected account type.
+     */
+    constructor(address, accountType) {
+        const label = accountType ? `${accountType} account` : "Account";
+        super(`${label} not found: ${address}`, "SAP_ACCOUNT_NOT_FOUND");
+        this.name = "SapAccountNotFoundError";
+        this.address = address;
+        this.accountType = accountType;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Timeout Error
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapTimeoutError
+ * @description Thrown when an operation (e.g., transaction confirmation) exceeds
+ * the configured timeout.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.register(params, { timeoutMs: 30_000 });
+ * } catch (err) {
+ *   if (err instanceof SapTimeoutError) {
+ *     console.error(`Timed out after ${err.timeoutMs}ms: ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export class SapTimeoutError extends SapError {
+    /**
+     * @description Timeout duration in milliseconds that was exceeded.
+     * @readonly
+     */
+    timeoutMs;
+    /**
+     * @param message   - A human-readable description of the timeout.
+     * @param timeoutMs - The timeout threshold in milliseconds.
+     */
+    constructor(message, timeoutMs) {
+        super(message, "SAP_TIMEOUT");
+        this.name = "SapTimeoutError";
+        this.timeoutMs = timeoutMs;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+//  Permission Error
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapPermissionError
+ * @description Thrown when the current wallet lacks the required permission
+ * (authority, delegate, etc.) for an operation.
+ *
+ * @category Errors
+ * @since v0.1.0
+ * @extends {SapError}
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.agent.update(agentPda, updates);
+ * } catch (err) {
+ *   if (err instanceof SapPermissionError) {
+ *     console.error(`Permission denied: ${err.message}`);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link SapError}
+ */
+export class SapPermissionError extends SapError {
+    /**
+     * @param message - A human-readable description of the permission failure.
+     */
+    constructor(message) {
+        super(message, "SAP_PERMISSION_DENIED");
+        this.name = "SapPermissionError";
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

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

package/dist/esm/errors.d.ts

@@ -1,3 +1,11 @@
+/** Generic SDK error */
+export declare class SapError extends Error {
+    constructor(message: string);
+}
+/** Validation-specific SDK error */
+export declare class SapValidationError extends Error {
+    constructor(message: string);
+}
 /** All v0.13 SapError variants with recovery hints */
 export declare enum SapErrorCode {
     NameTooLong = 6000,

package/dist/esm/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAOA,sDAAsD;AACtD,oBAAY,YAAY;IAEtB,WAAW,OAAO;IAClB,YAAY,OAAO;IACnB,eAAe,OAAO;IACtB,eAAe,OAAO;IACtB,cAAc,OAAO;IACrB,mBAAmB,OAAO;IAC1B,uBAAuB,OAAO;IAC9B,WAAW,OAAO;IAGlB,SAAS,OAAO;IAChB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IACzB,cAAc,OAAO;IACrB,YAAY,OAAO;IACnB,mBAAmB,OAAO;IAC1B,kBAAkB,OAAO;IACzB,oBAAoB,OAAO;IAG3B,iBAAiB,OAAO;IACxB,SAAS,OAAO;IAChB,cAAc,OAAO;IACrB,mBAAmB,OAAO;IAC1B,aAAa,OAAO;IACpB,oBAAoB,OAAO;IAC3B,qBAAqB,OAAO;IAC5B,iCAAiC,OAAO;IACxC,aAAa,OAAO;IACpB,kBAAkB,OAAO;IACzB,iBAAiB,OAAO;IAGxB,yBAAyB,OAAO;IAChC,cAAc,OAAO;IACrB,iBAAiB,OAAO;IACxB,qBAAqB,OAAO;IAC5B,oBAAoB,OAAO;IAC3B,0BAA0B,OAAO;IACjC,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IACzB,wBAAwB,OAAO;IAC/B,wBAAwB,OAAO;IAC/B,oBAAoB,OAAO;IAC3B,0BAA0B,OAAO;IACjC,uBAAuB,OAAO;IAC9B,oBAAoB,OAAO;IAC3B,YAAY,OAAO;IACnB,mBAAmB,OAAO;IAC1B,gBAAgB,OAAO;IACvB,UAAU,OAAO;IACjB,cAAc,OAAO;IACrB,eAAe,OAAO;IACtB,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,qBAAqB,OAAO;IAC5B,WAAW,OAAO;IAClB,oBAAoB,OAAO;IAC3B,aAAa,OAAO;IACpB,iBAAiB,OAAO;IAGxB,oBAAoB,OAAO;IAC3B,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,sBAAsB,OAAO;IAC7B,kBAAkB,OAAO;IACzB,mBAAmB,OAAO;IAC1B,kBAAkB,OAAO;IACzB,aAAa,OAAO;IAGpB,oBAAoB,OAAO;IAC3B,aAAa,OAAO;IACpB,+BAA+B,OAAO;IACtC,4BAA4B,OAAO;IACnC,2BAA2B,OAAO;IAGlC,qBAAqB,OAAO;IAC5B,6BAA6B,OAAO;IACpC,uBAAuB,OAAO;IAC9B,sBAAsB,OAAO;IAC7B,qBAAqB,OAAO;IAC5B,uBAAuB,OAAO;IAC9B,yBAAyB,OAAO;IAChC,uBAAuB,OAAO;IAC9B,sBAAsB,OAAO;IAC7B,sBAAsB,OAAO;IAG7B,kBAAkB,OAAO;IAGzB,aAAa,OAAO;IACpB,uBAAuB,OAAO;IAC9B,mBAAmB,OAAO;IAC1B,aAAa,OAAO;IACpB,WAAW,OAAO;IAClB,eAAe,OAAO;IACtB,kBAAkB,OAAO;IACzB,eAAe,OAAO;IACtB,aAAa,OAAO;IACpB,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,gBAAgB,OAAO;IACvB,WAAW,OAAO;IAClB,wBAAwB,OAAO;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAmCzD;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAO3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAgBpE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/esm/errors.js

@@ -1,3 +1,11 @@
+/** Generic SDK error */
+export class SapError extends Error {
+    constructor(message) { super(message); this.name = "SapError"; }
+}
+/** Validation-specific SDK error */
+export class SapValidationError extends Error {
+    constructor(message) { super(message); this.name = "SapValidationError"; }
+}
 // ================================================================
 //  synapse-sap-sdk / src/errors.ts
 //  On-chain error codes ↔ human-readable messages + recovery actions