veilioexchange 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VEILIO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,160 @@
-# Temporary Holding Version
+# veilioexchange
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript SDK for **VEILIO**: sealed-bid auctions for digital assets and milestone service escrow, built on [viem](https://viem.sh).
+
+- **Networks:** BNB Smart Chain Testnet (97), Base Sepolia (84532) and Solana Devnet. Testnet only.
+- **Formats:** ESM and CommonJS, with TypeScript types.
+- **Runtime:** Node.js 18+ or any modern browser.
+
+```sh
+npm install veilioexchange viem
+```
+
+`viem` is a peer dependency, so your app and the SDK share one copy.
+
+## Auctions
+
+```ts
+import { createPublicClient, createWalletClient, http } from 'viem';
+import { bscTestnet } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+import { createVeilioAgent } from 'veilioexchange';
+
+const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
+const publicClient = createPublicClient({ chain: bscTestnet, transport: http() });
+const walletClient = createWalletClient({ account, chain: bscTestnet, transport: http() });
+
+const agent = createVeilioAgent({
+  publicClient,
+  walletClient,
+  account: account.address,
+  apiBaseUrl: 'https://your-veilio-host', // needed for searchAssets / getAssetDetails
+});
+
+const { auctions } = await agent.listAuctions({ limit: 20 });
+const auctionId = auctions[0].id;
+
+// Sealed bid: random 32-byte secret + keccak256 commitment, computed locally.
+const bid = agent.prepareBid(auctionId, '0.05'); // max bid in BNB
+// Store `bid` (including bid.secret) somewhere durable and encrypted.
+// If the secret is lost the bid can never be revealed.
+
+await agent.commitBid(bid, '0.08');   // deposit >= max bid; over-deposit to hide your ceiling
+await agent.revealBid(bid);           // during the Revealing window
+
+const result = await agent.getAuctionResult(auctionId);
+if (result.isWinner) await agent.claimAsset(auctionId);
+```
+
+## Services escrow
+
+```ts
+import { createVeilioServicesClient, signServiceAuth } from 'veilioexchange';
+
+const services = createVeilioServicesClient({
+  publicClient,
+  walletClient,
+  account: account.address,
+  chainId: 97, // or 84532 for Base Sepolia (use matching viem clients)
+});
+
+const orderId = 'srv-order-uuid-101';
+
+const deposit = await services.deposit({
+  orderId,
+  seller: '0xSeller...',
+  deadline: Math.floor(Date.now() / 1000) + 3 * 86400,
+  amount: '0.25',
+});
+await deposit.wait();
+
+const order = await services.getOrder(orderId);      // status: 'Funded'
+await (await services.submitDelivery(orderId, 'ipfs://QmProof')).wait(); // seller
+await (await services.releaseFunds(orderId)).wait(); // buyer; 5% fee on release
+
+// Fee-free exits: services.refund(orderId, reason), services.refundTimeout(orderId),
+// services.dispute(orderId, reason)
+```
+
+### Signed API calls
+
+Off-chain order actions on the VEILIO API carry an EIP-191 signature:
+
+```ts
+const auth = await signServiceAuth(account, 'verify-deposit', orderId);
+
+await fetch(`https://your-veilio-host/api/orders/${orderId}/verify-deposit`, {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ txHash: deposit.txHash, network: 'bnb:97', auth }),
+});
+```
+
+## Solana Devnet
+
+Solana lives in its own entry point so EVM-only users never load `@solana/web3.js`:
+
+```sh
+npm install veilioexchange @solana/web3.js
+```
+
+```ts
+import { Connection, Keypair, clusterApiUrl } from '@solana/web3.js';
+import { createVeilioSolanaClient, keypairSigner } from 'veilioexchange/solana';
+
+const connection = new Connection(clusterApiUrl('devnet'), 'confirmed');
+const agentKey = Keypair.fromSecretKey(/* load your devnet key from a secret store */);
+
+const solana = createVeilioSolanaClient({
+  connection,
+  signer: keypairSigner(agentKey), // or a Phantom provider: window.phantom.solana
+});
+
+// Sealed-bid auction
+const auctions = await solana.listAuctions();
+const bid = solana.prepareBid(auctions[0].auctionId, '0.25'); // max bid in SOL
+// Store `bid` (salt included) in encrypted storage before committing.
+await solana.commitBid(bid, '0.3');
+await solana.revealBid(bid);
+
+// Service escrow
+await solana.deposit({
+  orderId: 'ord-1739-abc12',     // up to 32 bytes, or 32-byte hex
+  seller: 'SellerBase58...',
+  reviewer: 'ReviewerWallet...',  // a wallet that can sign, never a program ID
+  feeRecipient: 'FeeWallet...',
+  amountSol: '1.5',
+  deadline: Math.floor(Date.now() / 1000) + 3 * 86400,
+});
+await solana.submitDelivery('ord-1739-abc12', 'ipfs://QmProof'); // seller
+await solana.releaseFunds('ord-1739-abc12');                     // buyer
+```
+
+Solana support needs Node.js 18+ (it uses `node:crypto`). Base58 addresses are case-sensitive; never lowercase them.
+
+| Program (Devnet) | ID |
+|---|---|
+| Auction | `5Tw1iJGN1hhyRzepbD5eLoaRoZTEiKcqrh2HoZYhYEta` |
+| Service escrow | `5Vj4y8BT74PDe5VwLuDp9agTR5ak4vtZdwxnBfRW3R8s` |
+
+## Contract addresses
+
+Defaults live in `VEILIO_DEPLOYMENTS`. Every client takes a `contractAddress` option to point at your own deployment.
+
+| Network | Auction | Service escrow |
+|---|---|---|
+| BNB Testnet (97) | `0xc12EcD53B9dAE1753409B87f10Bf00684BF7d8B1` | `0x794f1610B5588a55B19D8c82e4381448a388C965` |
+| Base Sepolia (84532) | `0x2a56D1a2C8Ffc63b0b009fceEa9d8d182A17A025` | `0x13C16c508780639E86cA9d4322Ba9739C15e78Af` |
+
+## Errors
+
+Failures are thrown as `VeilioSdkError` with a typed `code` (`INVALID_INPUT`, `CHAIN_MISMATCH`, `WALLET_REQUIRED`, `TRANSACTION_REVERTED`, ...) and a `retryable` flag.
+
+## Security
+
+- Use a dedicated testnet wallet for agents and load its key from the environment. Never commit it.
+- Bid deposits and bidder addresses are public on-chain; only the bid value is sealed until reveal.
+
+## License
+
+MIT

package/dist/cjs/auth.d.ts

@@ -0,0 +1,31 @@
+import type { Address, Hex } from 'viem';
+/** Signed `auth` object expected by VEILIO Services API routes. */
+export interface ServiceAuthPayload {
+    address: Address;
+    signature: Hex;
+    timestamp: number;
+    nonce: string;
+}
+/** Anything that can produce an EIP-191 personal_sign signature (a viem LocalAccount works). */
+export interface MessageSigner {
+    address: Address;
+    signMessage: (args: {
+        message: string;
+    }) => Promise<Hex>;
+}
+/** Random 16-hex-character nonce from a cryptographically secure source. */
+export declare function generateAuthNonce(): string;
+/** Exact message the VEILIO API verifies; must match the server byte-for-byte. */
+export declare function createServiceAuthMessage(input: {
+    action: string;
+    orderId: string;
+    address: string;
+    timestamp: number;
+    nonce: string;
+}): string;
+/**
+ * Builds the signed `auth` payload for an off-chain Services action
+ * (e.g. 'accept-payment-request', 'verify-deposit', 'submit', 'revision', 'approve', 'cancel').
+ */
+export declare function signServiceAuth(signer: MessageSigner, action: string, orderId: string): Promise<ServiceAuthPayload>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/cjs/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGzC,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAC1D;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAUT;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAM7B"}

package/dist/cjs/auth.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAuthNonce = generateAuthNonce;
+exports.createServiceAuthMessage = createServiceAuthMessage;
+exports.signServiceAuth = signServiceAuth;
+const errors_js_1 = require("./errors.js");
+/** Random 16-hex-character nonce from a cryptographically secure source. */
+function generateAuthNonce() {
+    const cryptoApi = globalThis.crypto;
+    if (!cryptoApi?.getRandomValues) {
+        throw new errors_js_1.VeilioSdkError({
+            code: 'INVALID_CONFIG',
+            message: 'A cryptographically secure random generator is required to create an auth nonce.',
+        });
+    }
+    const bytes = cryptoApi.getRandomValues(new Uint8Array(8));
+    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+/** Exact message the VEILIO API verifies; must match the server byte-for-byte. */
+function createServiceAuthMessage(input) {
+    return [
+        'VEILIO SERVICES AUTHORIZATION V1',
+        `Action: ${input.action}`,
+        `Order ID: ${input.orderId}`,
+        `Wallet: ${input.address.toLowerCase()}`,
+        `Timestamp: ${input.timestamp}`,
+        `Nonce: ${input.nonce}`,
+        'Purpose: Authorize off-chain state change for VEILIO Services escrow.',
+    ].join('\n');
+}
+/**
+ * Builds the signed `auth` payload for an off-chain Services action
+ * (e.g. 'accept-payment-request', 'verify-deposit', 'submit', 'revision', 'approve', 'cancel').
+ */
+async function signServiceAuth(signer, action, orderId) {
+    const timestamp = Date.now();
+    const nonce = generateAuthNonce();
+    const message = createServiceAuthMessage({ action, orderId, address: signer.address, timestamp, nonce });
+    const signature = await signer.signMessage({ message });
+    return { address: signer.address, signature, timestamp, nonce };
+}
+//# sourceMappingURL=auth.js.map

package/dist/cjs/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/auth.ts"],"names":[],"mappings":";;AAkBA,8CAUC;AAGD,4DAgBC;AAMD,0CAUC;AA9DD,2CAA6C;AAgB7C,4EAA4E;AAC5E,SAAgB,iBAAiB;IAC/B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,CAAC;QAChC,MAAM,IAAI,0BAAc,CAAC;YACvB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,kFAAkF;SAC5F,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,kFAAkF;AAClF,SAAgB,wBAAwB,CAAC,KAMxC;IACC,OAAO;QACL,kCAAkC;QAClC,WAAW,KAAK,CAAC,MAAM,EAAE;QACzB,aAAa,KAAK,CAAC,OAAO,EAAE;QAC5B,WAAW,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE;QACxC,cAAc,KAAK,CAAC,SAAS,EAAE;QAC/B,UAAU,KAAK,CAAC,KAAK,EAAE;QACvB,uEAAuE;KACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,MAAc,EACd,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACzG,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAClE,CAAC"}

package/dist/cjs/deployments.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from 'viem';
+/**
+ * Known VEILIO testnet deployments. Every client accepts an explicit
+ * `contractAddress`, so these are defaults only; override them when you
+ * point the SDK at your own deployment.
+ */
+export declare const VEILIO_DEPLOYMENTS: {
+    readonly bnbTestnet: {
+        readonly chainId: 97;
+        readonly auction: Address;
+        readonly serviceEscrow: Address;
+        readonly serviceRegistry: Address;
+    };
+    readonly baseSepolia: {
+        readonly chainId: 84532;
+        readonly auction: Address;
+        readonly serviceEscrow: Address;
+        readonly serviceRegistry: Address;
+    };
+};
+//# sourceMappingURL=deployments.d.ts.map

package/dist/cjs/deployments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;0BAG8B,OAAO;gCACD,OAAO;kCACL,OAAO;;;;0BAIf,OAAO;gCACD,OAAO;kCACL,OAAO;;CAElE,CAAC"}

package/dist/cjs/deployments.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VEILIO_DEPLOYMENTS = void 0;
+/**
+ * Known VEILIO testnet deployments. Every client accepts an explicit
+ * `contractAddress`, so these are defaults only; override them when you
+ * point the SDK at your own deployment.
+ */
+exports.VEILIO_DEPLOYMENTS = {
+    bnbTestnet: {
+        chainId: 97,
+        auction: '0xc12EcD53B9dAE1753409B87f10Bf00684BF7d8B1',
+        serviceEscrow: '0x794f1610B5588a55B19D8c82e4381448a388C965',
+        serviceRegistry: '0x016A23A069180587d5D8B09413e97E1e78ccD702',
+    },
+    baseSepolia: {
+        chainId: 84532,
+        auction: '0x2a56D1a2C8Ffc63b0b009fceEa9d8d182A17A025',
+        serviceEscrow: '0x13C16c508780639E86cA9d4322Ba9739C15e78Af',
+        serviceRegistry: '0x74a6Bf3ed462898F7b3E13e7F4d1c444570bCb88',
+    },
+};
+//# sourceMappingURL=deployments.js.map

package/dist/cjs/deployments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../../src/deployments.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,kBAAkB,GAAG;IAChC,UAAU,EAAE;QACV,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,4CAAuD;QAChE,aAAa,EAAE,4CAAuD;QACtE,eAAe,EAAE,4CAAuD;KACzE;IACD,WAAW,EAAE;QACX,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,4CAAuD;QAChE,aAAa,EAAE,4CAAuD;QACtE,eAAe,EAAE,4CAAuD;KACzE;CACO,CAAC"}

package/dist/cjs/errors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * VEILIO Agent SDK — Standardized Error System
+ *
+ * Provides typed error codes, human-readable messages, retryability metadata,
+ * and contextual debugging information for external developers and autonomous agents.
+ */
+export type VeilioErrorCode = 'INVALID_CONFIG' | 'INVALID_INPUT' | 'CHAIN_MISMATCH' | 'WALLET_REQUIRED' | 'WALLET_DISCONNECTED' | 'TRANSACTION_REVERTED' | 'TRANSACTION_TIMEOUT' | 'RPC_ERROR' | 'CONTRACT_ERROR' | 'NOT_FOUND' | 'UNAUTHORIZED';
+export interface VeilioSdkErrorDetails {
+    code: VeilioErrorCode;
+    message: string;
+    retryable?: boolean;
+    cause?: unknown;
+    context?: Record<string, unknown>;
+}
+export declare class VeilioSdkError extends Error {
+    readonly code: VeilioErrorCode;
+    readonly retryable: boolean;
+    readonly context?: Record<string, unknown>;
+    constructor(details: VeilioSdkErrorDetails);
+    toJSON(): {
+        name: string;
+        code: VeilioErrorCode;
+        message: string;
+        retryable: boolean;
+        context: Record<string, unknown> | undefined;
+    };
+}
+export declare function isVeilioSdkError(error: unknown): error is VeilioSdkError;
+/**
+ * Wraps an unknown error into a VeilioSdkError while preserving cause and message.
+ */
+export declare function wrapAsVeilioError(error: unknown, fallbackCode?: VeilioErrorCode, fallbackMessage?: string, retryable?: boolean): VeilioSdkError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,cAAc,CAAC;AAEnB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,qBAAqB;IAWnC,MAAM;;;;;;;CASd;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,YAAY,GAAE,eAA6B,EAC3C,eAAe,SAAqC,EACpD,SAAS,UAAQ,GAChB,cAAc,CAYhB"}

package/dist/cjs/errors.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * VEILIO Agent SDK — Standardized Error System
+ *
+ * Provides typed error codes, human-readable messages, retryability metadata,
+ * and contextual debugging information for external developers and autonomous agents.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VeilioSdkError = void 0;
+exports.isVeilioSdkError = isVeilioSdkError;
+exports.wrapAsVeilioError = wrapAsVeilioError;
+class VeilioSdkError extends Error {
+    constructor(details) {
+        super(details.message, { cause: details.cause });
+        this.name = 'VeilioSdkError';
+        this.code = details.code;
+        this.retryable = details.retryable ?? false;
+        this.context = details.context;
+        // Maintain proper prototype chain for ES5/ES6 environments
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            retryable: this.retryable,
+            context: this.context,
+        };
+    }
+}
+exports.VeilioSdkError = VeilioSdkError;
+function isVeilioSdkError(error) {
+    return error instanceof VeilioSdkError;
+}
+/**
+ * Wraps an unknown error into a VeilioSdkError while preserving cause and message.
+ */
+function wrapAsVeilioError(error, fallbackCode = 'RPC_ERROR', fallbackMessage = 'An unexpected SDK error occurred', retryable = false) {
+    if (isVeilioSdkError(error)) {
+        return error;
+    }
+    const message = error instanceof Error ? error.message : fallbackMessage;
+    return new VeilioSdkError({
+        code: fallbackCode,
+        message,
+        retryable,
+        cause: error,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAkDH,4CAEC;AAKD,8CAiBC;AAnDD,MAAa,cAAe,SAAQ,KAAK;IAKvC,YAAY,OAA8B;QACxC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAE/B,2DAA2D;QAC3D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAzBD,wCAyBC;AAED,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,KAAc,EACd,eAAgC,WAAW,EAC3C,eAAe,GAAG,kCAAkC,EACpD,SAAS,GAAG,KAAK;IAEjB,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,OAAO,IAAI,cAAc,CAAC;QACxB,IAAI,EAAE,YAAY;QAClB,OAAO;QACP,SAAS;QACT,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC"}