@uvrn/sdk 1.0.2 → 1.3.0

package/dist/client.js

@@ -0,0 +1,376 @@
+"use strict";
+/**
+ * Delta Engine SDK Client
+ *
+ * Main client class for interacting with Delta Engine in multiple modes:
+ * - CLI: Spawns CLI process
+ * - HTTP: Makes API requests
+ * - Local: Direct function calls
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeltaEngineClient = void 0;
+const validators_1 = require("./validators");
+const errors_1 = require("./errors");
+const child_process_1 = require("child_process");
+const promises_1 = require("fs/promises");
+const os_1 = require("os");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+/**
+ * Client for interacting with Delta Engine
+ *
+ * Supports three execution modes:
+ * - **CLI**: Spawns the CLI executable
+ * - **HTTP**: Makes requests to REST API
+ * - **Local**: Direct import of core engine
+ *
+ * @example
+ * ```typescript
+ * // CLI mode
+ * const client = new DeltaEngineClient({
+ *   mode: 'cli',
+ *   cliPath: '/usr/local/bin/uvrn'
+ * });
+ *
+ * // HTTP mode
+ * const client = new DeltaEngineClient({
+ *   mode: 'http',
+ *   apiUrl: 'http://localhost:3000',
+ *   timeout: 30000
+ * });
+ *
+ * // Local mode
+ * const client = new DeltaEngineClient({
+ *   mode: 'local'
+ * });
+ * ```
+ */
+class DeltaEngineClient {
+    options;
+    /**
+     * Creates a new DeltaEngineClient
+     *
+     * @param options - Client configuration
+     * @throws {ConfigurationError} if configuration is invalid
+     */
+    constructor(options) {
+        // Validate configuration
+        this.validateOptions(options);
+        // Set defaults
+        this.options = {
+            mode: options.mode,
+            cliPath: options.cliPath || '',
+            apiUrl: options.apiUrl || '',
+            timeout: options.timeout || 30000,
+            retries: options.retries || 3
+        };
+    }
+    /**
+     * Validates client options
+     * @internal
+     */
+    validateOptions(options) {
+        if (!options.mode) {
+            throw new errors_1.ConfigurationError('mode is required');
+        }
+        if (!['cli', 'http', 'local'].includes(options.mode)) {
+            throw new errors_1.ConfigurationError(`Invalid mode: ${options.mode}. Must be 'cli', 'http', or 'local'`);
+        }
+        if (options.mode === 'cli' && !options.cliPath) {
+            throw new errors_1.ConfigurationError('cliPath is required for CLI mode');
+        }
+        if (options.mode === 'http' && !options.apiUrl) {
+            throw new errors_1.ConfigurationError('apiUrl is required for HTTP mode');
+        }
+    }
+    /**
+     * Executes a bundle and returns a receipt
+     *
+     * @param bundle - The DeltaBundle to execute
+     * @returns Promise resolving to DeltaReceipt
+     * @throws {ValidationError} if bundle is invalid
+     * @throws {ExecutionError} if execution fails
+     * @throws {NetworkError} if HTTP request fails (HTTP mode only)
+     *
+     * @example
+     * ```typescript
+     * const bundle = {
+     *   bundleId: 'test-1',
+     *   claim: 'Revenue matches forecast',
+     *   dataSpecs: [...],
+     *   thresholdPct: 0.05
+     * };
+     *
+     * const receipt = await client.runEngine(bundle);
+     * console.log('Outcome:', receipt.outcome);
+     * ```
+     */
+    async runEngine(bundle) {
+        // Validate bundle first
+        const validation = (0, validators_1.validateBundle)(bundle);
+        if (!validation.valid) {
+            throw new errors_1.ValidationError('Invalid bundle', validation.errors || []);
+        }
+        // Execute based on mode
+        switch (this.options.mode) {
+            case 'cli':
+                return this.runEngineCLI(bundle);
+            case 'http':
+                return this.runEngineHTTP(bundle);
+            case 'local':
+                return this.runEngineLocal(bundle);
+            default:
+                throw new errors_1.ConfigurationError(`Unsupported mode: ${this.options.mode}`);
+        }
+    }
+    /**
+     * Executes bundle via CLI mode
+     * @internal
+     */
+    async runEngineCLI(bundle) {
+        const tempFile = (0, path_1.join)((0, os_1.tmpdir)(), `delta-bundle-${(0, crypto_1.randomBytes)(8).toString('hex')}.json`);
+        try {
+            // Write bundle to temp file
+            await (0, promises_1.writeFile)(tempFile, JSON.stringify(bundle, null, 2));
+            // Spawn CLI process
+            const result = await this.spawnCLI(tempFile);
+            // Parse and validate receipt
+            const receipt = JSON.parse(result);
+            const receiptValidation = (0, validators_1.validateReceipt)(receipt);
+            if (!receiptValidation.valid) {
+                throw new errors_1.ValidationError('Invalid receipt from CLI', receiptValidation.errors || []);
+            }
+            return receipt;
+        }
+        catch (error) {
+            if (error instanceof errors_1.DeltaEngineError) {
+                throw error;
+            }
+            throw new errors_1.ExecutionError(`CLI execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        finally {
+            // Clean up temp file
+            try {
+                await (0, promises_1.unlink)(tempFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+    }
+    /**
+     * Spawns CLI process and captures output
+     * @internal
+     */
+    spawnCLI(bundlePath) {
+        return new Promise((resolve, reject) => {
+            const child = (0, child_process_1.spawn)(this.options.cliPath, ['run', bundlePath], {
+                timeout: this.options.timeout
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('error', (error) => {
+                reject(new errors_1.ExecutionError(`Failed to spawn CLI: ${error.message}`));
+            });
+            child.on('close', (code) => {
+                if (code === 0) {
+                    resolve(stdout);
+                }
+                else {
+                    reject(new errors_1.ExecutionError(`CLI exited with code ${code ?? -1}`, code ?? undefined, stderr));
+                }
+            });
+        });
+    }
+    /**
+     * Executes bundle via HTTP API mode
+     * @internal
+     */
+    async runEngineHTTP(bundle) {
+        const url = `${this.options.apiUrl}/api/v1/delta/run`;
+        try {
+            const response = await this.fetchWithRetry(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(bundle)
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                throw new errors_1.NetworkError(`HTTP ${response.status}: ${response.statusText}`, response.status, errorBody);
+            }
+            const receipt = await response.json();
+            // Validate receipt
+            const validation = (0, validators_1.validateReceipt)(receipt);
+            if (!validation.valid) {
+                throw new errors_1.ValidationError('Invalid receipt from API', validation.errors || []);
+            }
+            return receipt;
+        }
+        catch (error) {
+            if (error instanceof errors_1.DeltaEngineError) {
+                throw error;
+            }
+            throw new errors_1.NetworkError(`HTTP request failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Fetch with retry logic
+     * @internal
+     */
+    async fetchWithRetry(url, options, attempt = 1) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (error) {
+            if (attempt < this.options.retries) {
+                // Exponential backoff
+                const delay = Math.min(1000 * Math.pow(2, attempt - 1), 10000);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                return this.fetchWithRetry(url, options, attempt + 1);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Executes bundle via local mode (direct import)
+     * @internal
+     */
+    async runEngineLocal(bundle) {
+        try {
+            // Dynamic import to avoid bundling core if not needed
+            const { runDeltaEngine } = await Promise.resolve().then(() => __importStar(require('@uvrn/core')));
+            const receipt = runDeltaEngine(bundle);
+            // Validate receipt
+            const validation = (0, validators_1.validateReceipt)(receipt);
+            if (!validation.valid) {
+                throw new errors_1.ValidationError('Invalid receipt from local engine', validation.errors || []);
+            }
+            return receipt;
+        }
+        catch (error) {
+            if (error instanceof errors_1.DeltaEngineError) {
+                throw error;
+            }
+            throw new errors_1.ExecutionError(`Local execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validates a bundle without executing it
+     *
+     * @param bundle - The bundle to validate
+     * @returns ValidationResult with detailed errors
+     *
+     * @example
+     * ```typescript
+     * const result = await client.validateBundle(bundle);
+     * if (!result.valid) {
+     *   console.error('Validation errors:', result.errors);
+     * }
+     * ```
+     */
+    async validateBundle(bundle) {
+        return (0, validators_1.validateBundle)(bundle);
+    }
+    /**
+     * Verifies a receipt's integrity and determinism
+     *
+     * Checks:
+     * 1. Receipt hash integrity
+     * 2. Deterministic replay (if original bundle available)
+     *
+     * @param receipt - The receipt to verify
+     * @returns VerificationResult with detailed information
+     *
+     * @example
+     * ```typescript
+     * const result = await client.verifyReceipt(receipt);
+     * if (!result.verified) {
+     *   console.error('Receipt verification failed!');
+     * }
+     * if (!result.deterministic) {
+     *   console.warn('Non-deterministic execution detected!');
+     * }
+     * ```
+     */
+    async verifyReceipt(receipt) {
+        // Validate receipt structure first
+        const validation = (0, validators_1.validateReceipt)(receipt);
+        if (!validation.valid) {
+            return {
+                verified: false,
+                deterministic: false,
+                error: `Invalid receipt structure: ${validation.errors?.map(e => e.message).join(', ')}`
+            };
+        }
+        // Verify hash
+        const hashValid = (0, validators_1.verifyReceiptHash)(receipt);
+        if (!hashValid) {
+            return {
+                verified: false,
+                deterministic: false,
+                originalHash: receipt.hash,
+                error: 'Receipt hash verification failed - receipt may have been tampered with'
+            };
+        }
+        // For determinism check, we would need the original bundle
+        // This is a limitation - receipts don't currently store bundles
+        return {
+            verified: true,
+            deterministic: true, // Assumed true if hash is valid
+            originalHash: receipt.hash,
+            details: {
+                note: 'Determinism check requires original bundle replay'
+            }
+        };
+    }
+}
+exports.DeltaEngineClient = DeltaEngineClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Custom Error Classes for Delta Engine SDK
+ */
+/**
+ * Base error class for all Delta Engine SDK errors
+ */
+export declare class DeltaEngineError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when bundle or receipt validation fails
+ */
+export declare class ValidationError extends DeltaEngineError {
+    readonly errors: Array<{
+        field: string;
+        message: string;
+    }>;
+    constructor(message: string, errors?: Array<{
+        field: string;
+        message: string;
+    }>);
+}
+/**
+ * Error thrown during engine execution
+ */
+export declare class ExecutionError extends DeltaEngineError {
+    readonly exitCode?: number;
+    readonly stderr?: string;
+    constructor(message: string, exitCode?: number, stderr?: string);
+}
+/**
+ * Error thrown during HTTP API communication (HTTP mode only)
+ */
+export declare class NetworkError extends DeltaEngineError {
+    readonly statusCode?: number;
+    readonly response?: unknown;
+    constructor(message: string, statusCode?: number, response?: unknown);
+}
+/**
+ * Error thrown when configuration is invalid
+ */
+export declare class ConfigurationError extends DeltaEngineError {
+    constructor(message: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,SAAgB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAM;CAMpF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAOhE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;IAChD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,QAAQ,CAAC,EAAE,OAAO,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO;CAOrE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,OAAO,EAAE,MAAM;CAK5B"}

package/dist/errors/index.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Custom Error Classes for Delta Engine SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationError = exports.NetworkError = exports.ExecutionError = exports.ValidationError = exports.DeltaEngineError = void 0;
+/**
+ * Base error class for all Delta Engine SDK errors
+ */
+class DeltaEngineError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DeltaEngineError';
+        Object.setPrototypeOf(this, DeltaEngineError.prototype);
+    }
+}
+exports.DeltaEngineError = DeltaEngineError;
+/**
+ * Error thrown when bundle or receipt validation fails
+ */
+class ValidationError extends DeltaEngineError {
+    errors;
+    constructor(message, errors = []) {
+        super(message);
+        this.name = 'ValidationError';
+        this.errors = errors;
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown during engine execution
+ */
+class ExecutionError extends DeltaEngineError {
+    exitCode;
+    stderr;
+    constructor(message, exitCode, stderr) {
+        super(message);
+        this.name = 'ExecutionError';
+        this.exitCode = exitCode;
+        this.stderr = stderr;
+        Object.setPrototypeOf(this, ExecutionError.prototype);
+    }
+}
+exports.ExecutionError = ExecutionError;
+/**
+ * Error thrown during HTTP API communication (HTTP mode only)
+ */
+class NetworkError extends DeltaEngineError {
+    statusCode;
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.name = 'NetworkError';
+        this.statusCode = statusCode;
+        this.response = response;
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error thrown when configuration is invalid
+ */
+class ConfigurationError extends DeltaEngineError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigurationError';
+        Object.setPrototypeOf(this, ConfigurationError.prototype);
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAND,4CAMC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnC,MAAM,CAA4C;IAElE,YAAY,OAAe,EAAE,SAAoD,EAAE;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AATD,0CASC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,gBAAgB;IAClC,QAAQ,CAAU;IAClB,MAAM,CAAU;IAEhC,YAAY,OAAe,EAAE,QAAiB,EAAE,MAAe;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAXD,wCAWC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,gBAAgB;IAChC,UAAU,CAAU;IACpB,QAAQ,CAAW;IAEnC,YAAY,OAAe,EAAE,UAAmB,EAAE,QAAkB;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAXD,oCAWC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAND,gDAMC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @uvrn/sdk
+ *
+ * TypeScript SDK for interacting with Loosechain Delta Engine
+ *
+ * @packageDocumentation
+ */
+export { DeltaEngineClient } from './client';
+export { BundleBuilder } from './builder';
+export { validateBundle, validateReceipt, verifyReceiptHash, replayReceipt } from './validators';
+export { DeltaEngineError, ValidationError, ExecutionError, NetworkError, ConfigurationError } from './errors';
+export type { MetricPoint, DataSpec, DeltaBundle, DeltaRound, Outcome, DeltaReceipt, CoreValidationResult, CoreVerifyResult, EngineOpts, ClientMode, ClientOptions, ValidationError as ValidationErrorType, ValidationResult, VerificationResult, ReplayResult, BundleBuilderOptions } from './types';
+export { DeltaEngineClient as default } from './client';
+/**
+ * Package version
+ */
+export declare const VERSION = "1.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAGlB,YAAY,EAEV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,OAAO,EACP,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EAGV,UAAU,EACV,aAAa,EACb,eAAe,IAAI,mBAAmB,EACtC,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,iBAAiB,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @uvrn/sdk
+ *
+ * TypeScript SDK for interacting with Loosechain Delta Engine
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.default = exports.ConfigurationError = exports.NetworkError = exports.ExecutionError = exports.ValidationError = exports.DeltaEngineError = exports.replayReceipt = exports.verifyReceiptHash = exports.validateReceipt = exports.validateBundle = exports.BundleBuilder = exports.DeltaEngineClient = void 0;
+// Export main client
+var client_1 = require("./client");
+Object.defineProperty(exports, "DeltaEngineClient", { enumerable: true, get: function () { return client_1.DeltaEngineClient; } });
+// Export builder utility
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "BundleBuilder", { enumerable: true, get: function () { return builder_1.BundleBuilder; } });
+// Export validators
+var validators_1 = require("./validators");
+Object.defineProperty(exports, "validateBundle", { enumerable: true, get: function () { return validators_1.validateBundle; } });
+Object.defineProperty(exports, "validateReceipt", { enumerable: true, get: function () { return validators_1.validateReceipt; } });
+Object.defineProperty(exports, "verifyReceiptHash", { enumerable: true, get: function () { return validators_1.verifyReceiptHash; } });
+Object.defineProperty(exports, "replayReceipt", { enumerable: true, get: function () { return validators_1.replayReceipt; } });
+// Export error classes
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "DeltaEngineError", { enumerable: true, get: function () { return errors_1.DeltaEngineError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "ExecutionError", { enumerable: true, get: function () { return errors_1.ExecutionError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return errors_1.ConfigurationError; } });
+// Export default
+var client_2 = require("./client");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_2.DeltaEngineClient; } });
+/**
+ * Package version
+ */
+exports.VERSION = '1.0.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qBAAqB;AACrB,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA;AAE1B,yBAAyB;AACzB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AAEtB,oBAAoB;AACpB,2CAKsB;AAJpB,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AAGf,uBAAuB;AACvB,mCAMkB;AALhB,0GAAA,gBAAgB,OAAA;AAChB,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,4GAAA,kBAAkB,OAAA;AA0BpB,iBAAiB;AACjB,mCAAwD;AAA/C,iGAAA,iBAAiB,OAAW;AAErC;;GAEG;AACU,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Type Exports for Delta Engine SDK
+ *
+ * Re-exports core types from uvrn-core and SDK-specific types
+ */
+export type { 
+/**
+ * A single metric data point with key, value, and optional metadata
+ */
+MetricPoint, 
+/**
+ * Specification for a data source containing metrics
+ */
+DataSpec, 
+/**
+ * Complete bundle submitted to Delta Engine for verification
+ */
+DeltaBundle, 
+/**
+ * Information about a single engine execution round
+ */
+DeltaRound, 
+/**
+ * Final outcome of engine execution: 'consensus' or 'indeterminate'
+ */
+Outcome, 
+/**
+ * Receipt produced by Delta Engine after processing a bundle
+ */
+DeltaReceipt, 
+/**
+ * Result of validation operations
+ */
+ValidationResult as CoreValidationResult, 
+/**
+ * Result of verification operations
+ */
+VerifyResult as CoreVerifyResult, 
+/**
+ * Options for engine execution
+ */
+EngineOpts } from '@uvrn/core';
+export type { ClientMode, ClientOptions, ValidationError, ValidationResult, VerificationResult, ReplayResult, BundleBuilderOptions } from './sdk';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY;AACV;;GAEG;AACH,WAAW;AAEX;;GAEG;AACH,QAAQ;AAER;;GAEG;AACH,WAAW;AAEX;;GAEG;AACH,UAAU;AAEV;;GAEG;AACH,OAAO;AAEP;;GAEG;AACH,YAAY;AAEZ;;GAEG;AACH,gBAAgB,IAAI,oBAAoB;AAExC;;GAEG;AACH,YAAY,IAAI,gBAAgB;AAEhC;;GAEG;AACH,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACrB,MAAM,OAAO,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Type Exports for Delta Engine SDK
+ *
+ * Re-exports core types from uvrn-core and SDK-specific types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}