@no-witness-labs/midday-sdk 0.2.0 → 0.2.2

package/dist/sdk/Type.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Type helpers for Effect-to-Promise API conversion.
+ *
+ * @since 0.3.0
+ * @module
+ */
+import type * as Effect from 'effect/Effect';
+/**
+ * Utility to force TypeScript to expand and display computed types.
+ * Improves IDE hover display for complex mapped types.
+ */
+type Expand<T> = T extends (...args: infer A) => infer R ? (...args: A) => R : T extends object ? {
+    [K in keyof T]: T[K];
+} : T;
+/**
+ * Converts an Effect type to a Promise type by extracting the success value.
+ * Handles both direct Effect types and functions returning Effects.
+ *
+ * @example
+ * ```typescript
+ * type EffectType = Effect.Effect<string, Error>;
+ * type PromiseType = EffectToPromise<EffectType>; // Promise<string>
+ *
+ * type EffectFn = (x: number) => Effect.Effect<string, Error>;
+ * type PromiseFn = EffectToPromise<EffectFn>; // (x: number) => Promise<string>
+ * ```
+ */
+export type EffectToPromise<T> = T extends Effect.Effect<infer Return, infer _Error, infer _Context> ? Promise<Return> : T extends (...args: Array<any>) => Effect.Effect<infer Return, infer _Error, infer _Context> ? (...args: Parameters<T>) => Promise<Return> : never;
+/**
+ * Converts an API interface with Effect-returning methods to Promise-returning methods.
+ *
+ * Used to create the Promise-based wrapper API from the Effect-based API.
+ *
+ * @example
+ * ```typescript
+ * interface MyAPIEffect {
+ *   readonly foo: () => Effect.Effect<string, Error>;
+ *   readonly bar: (n: number) => Effect.Effect<boolean, Error>;
+ * }
+ *
+ * // Results in:
+ * // {
+ * //   readonly foo: () => Promise<string>;
+ * //   readonly bar: (n: number) => Promise<boolean>;
+ * // }
+ * type MyAPI = EffectToPromiseAPI<MyAPIEffect>;
+ * ```
+ */
+export type EffectToPromiseAPI<T> = Expand<{
+    readonly [K in keyof T]: EffectToPromise<T[K]>;
+}>;
+/**
+ * Selective Promise conversion - specify which Effects become Promises, rest become sync.
+ *
+ * @example
+ * ```typescript
+ * interface MyAPIEffect {
+ *   readonly asyncOp: () => Effect.Effect<string, Error>;
+ *   readonly syncOp: () => Effect.Effect<number, Error>;
+ * }
+ *
+ * // asyncOp becomes Promise, syncOp becomes sync (returns number directly)
+ * type MyAPI = SelectivePromiseAPI<MyAPIEffect, 'asyncOp'>;
+ * ```
+ */
+export type SelectivePromiseAPI<T, PromiseKeys extends keyof T = never> = {
+    readonly [K in PromiseKeys]: EffectToPromise<T[K]>;
+} & {
+    readonly [K in Exclude<keyof T, PromiseKeys>]: T[K] extends Effect.Effect<infer Return, any, any> ? Return : T[K];
+};
+/**
+ * Selective Sync conversion - specify which Effects become sync, rest become Promises.
+ *
+ * @example
+ * ```typescript
+ * interface MyAPIEffect {
+ *   readonly asyncOp: () => Effect.Effect<string, Error>;
+ *   readonly syncOp: () => Effect.Effect<number, Error>;
+ * }
+ *
+ * // syncOp becomes sync (returns number), asyncOp becomes Promise
+ * type MyAPI = SelectiveSyncAPI<MyAPIEffect, 'syncOp'>;
+ * ```
+ */
+export type SelectiveSyncAPI<T, SyncKeys extends keyof T = never> = {
+    readonly [K in SyncKeys]: T[K] extends Effect.Effect<infer Return, any, any> ? Return : T[K];
+} & {
+    readonly [K in Exclude<keyof T, SyncKeys>]: EffectToPromise<T[K]>;
+};
+export {};
+//# sourceMappingURL=Type.d.ts.map

package/dist/sdk/Type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Type.d.ts","sourceRoot":"","sources":["../../src/sdk/Type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAE7C;;;GAGG;AACH,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GACpD,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GACjB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GACxB,CAAC,CAAC;AAER;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,QAAQ,CAAC,GAChG,OAAO,CAAC,MAAM,CAAC,GAEf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,MAAM,MAAM,EAAE,MAAM,QAAQ,CAAC,GAC1F,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GAC3C,KAAK,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,GAAG,KAAK,IAAI;IAExE,QAAQ,EAAE,CAAC,IAAI,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnD,GAAG;IAGF,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;CAClH,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,CAAC,GAAG,KAAK,IAAI;IAGlE,QAAQ,EAAE,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;CAC7F,GAAG;IAEF,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE,CAAC"}

package/dist/sdk/Type.js

@@ -0,0 +1,8 @@
+/**
+ * Type helpers for Effect-to-Promise API conversion.
+ *
+ * @since 0.3.0
+ * @module
+ */
+export {};
+//# sourceMappingURL=Type.js.map

package/dist/sdk/Type.js.map

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

package/dist/utils/address.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Address parsing utilities for Midnight Network.
+ *
+ * Supports multiple address formats: Bech32m, hex, and base64.
+ *
+ * @since 0.2.0
+ * @module
+ */
+/**
+ * Parsed shielded address containing coin and encryption public keys.
+ */
+export interface ParsedAddress {
+    /** Coin public key as 64-character hex string */
+    coinPublicKey: string;
+    /** Encryption public key as 64-character hex string */
+    encryptionPublicKey: string;
+}
+/**
+ * Parse a shielded address from various formats.
+ *
+ * Supports:
+ * - Bech32m format (midnightxxxx...)
+ * - Hex string (128 characters = 64 bytes for both keys)
+ * - Base64 encoded bytes
+ *
+ * @param address - Address in any supported format
+ * @returns Parsed address with hex-encoded public keys
+ * @throws Error if address format is invalid
+ *
+ * @example
+ * ```typescript
+ * // Parse Bech32m address
+ * const parsed = parseShieldedAddress('midnight1...');
+ *
+ * // Parse hex address (64 bytes = 128 hex chars)
+ * const parsed = parseShieldedAddress('aabbcc...');
+ *
+ * console.log(parsed.coinPublicKey);       // 64-char hex
+ * console.log(parsed.encryptionPublicKey); // 64-char hex
+ * ```
+ */
+export declare function parseShieldedAddress(address: string): ParsedAddress;
+/**
+ * Convert a hex public key to Uint8Array for contract calls.
+ *
+ * @param hex - 64-character hex string (32 bytes)
+ * @returns Uint8Array of 32 bytes
+ *
+ * @example
+ * ```typescript
+ * const keyBytes = hexToPublicKey(parsed.coinPublicKey);
+ * // Use in contract calls
+ * ```
+ */
+export declare function hexToPublicKey(hex: string): Uint8Array;
+//# sourceMappingURL=address.d.ts.map

package/dist/utils/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/utils/address.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA2BnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMtD"}

package/dist/utils/address.js

@@ -0,0 +1,135 @@
+/**
+ * Address parsing utilities for Midnight Network.
+ *
+ * Supports multiple address formats: Bech32m, hex, and base64.
+ *
+ * @since 0.2.0
+ * @module
+ */
+import { hexToBytes, bytesToHex, base64ToBytes } from './hex.js';
+/**
+ * Parse a shielded address from various formats.
+ *
+ * Supports:
+ * - Bech32m format (midnightxxxx...)
+ * - Hex string (128 characters = 64 bytes for both keys)
+ * - Base64 encoded bytes
+ *
+ * @param address - Address in any supported format
+ * @returns Parsed address with hex-encoded public keys
+ * @throws Error if address format is invalid
+ *
+ * @example
+ * ```typescript
+ * // Parse Bech32m address
+ * const parsed = parseShieldedAddress('midnight1...');
+ *
+ * // Parse hex address (64 bytes = 128 hex chars)
+ * const parsed = parseShieldedAddress('aabbcc...');
+ *
+ * console.log(parsed.coinPublicKey);       // 64-char hex
+ * console.log(parsed.encryptionPublicKey); // 64-char hex
+ * ```
+ */
+export function parseShieldedAddress(address) {
+    let bytes;
+    // Try to detect format and decode
+    if (address.startsWith('midnight')) {
+        // Bech32m format - use the ledger's built-in parser
+        // The address contains the encoded public keys
+        bytes = decodeBech32m(address);
+    }
+    else if (/^[0-9a-fA-F]+$/.test(address)) {
+        // Hex format
+        bytes = hexToBytes(address);
+    }
+    else if (/^[A-Za-z0-9+/=]+$/.test(address)) {
+        // Base64 format
+        bytes = base64ToBytes(address);
+    }
+    else {
+        throw new Error(`Invalid address format: ${address.slice(0, 20)}...`);
+    }
+    // Shielded address should be 64 bytes (32 bytes each for coin and encryption keys)
+    if (bytes.length !== 64) {
+        throw new Error(`Invalid address length: expected 64 bytes, got ${bytes.length}`);
+    }
+    return {
+        coinPublicKey: bytesToHex(bytes.slice(0, 32)),
+        encryptionPublicKey: bytesToHex(bytes.slice(32, 64)),
+    };
+}
+/**
+ * Convert a hex public key to Uint8Array for contract calls.
+ *
+ * @param hex - 64-character hex string (32 bytes)
+ * @returns Uint8Array of 32 bytes
+ *
+ * @example
+ * ```typescript
+ * const keyBytes = hexToPublicKey(parsed.coinPublicKey);
+ * // Use in contract calls
+ * ```
+ */
+export function hexToPublicKey(hex) {
+    const bytes = hexToBytes(hex);
+    if (bytes.length !== 32) {
+        throw new Error(`Invalid public key length: expected 32 bytes, got ${bytes.length}`);
+    }
+    return bytes;
+}
+// Bech32m character set
+const BECH32M_CHARSET = 'qpzry9x8gf2tvdw0s3jn54khce6mua7l';
+/**
+ * Decode a Bech32m address to bytes.
+ * This is a simplified implementation for Midnight addresses.
+ */
+function decodeBech32m(bech32) {
+    const lower = bech32.toLowerCase();
+    const sepIndex = lower.lastIndexOf('1');
+    if (sepIndex < 1) {
+        throw new Error('Invalid bech32m: no separator found');
+    }
+    const data = lower.slice(sepIndex + 1);
+    // Convert bech32 characters to 5-bit values
+    const values = [];
+    for (const char of data) {
+        const value = BECH32M_CHARSET.indexOf(char);
+        if (value === -1) {
+            throw new Error(`Invalid bech32m character: ${char}`);
+        }
+        values.push(value);
+    }
+    // Remove checksum (last 6 values)
+    const dataValues = values.slice(0, -6);
+    // Convert from 5-bit to 8-bit (skip first value which is witness version)
+    const bytes = convertBits(dataValues.slice(1), 5, 8, false);
+    return new Uint8Array(bytes);
+}
+/**
+ * Convert between bit sizes (used in bech32 encoding).
+ */
+function convertBits(data, fromBits, toBits, pad) {
+    let acc = 0;
+    let bits = 0;
+    const result = [];
+    const maxv = (1 << toBits) - 1;
+    for (const value of data) {
+        acc = (acc << fromBits) | value;
+        bits += fromBits;
+        while (bits >= toBits) {
+            bits -= toBits;
+            result.push((acc >> bits) & maxv);
+        }
+    }
+    if (pad) {
+        if (bits > 0) {
+            result.push((acc << (toBits - bits)) & maxv);
+        }
+    }
+    else if (bits >= fromBits || ((acc << (toBits - bits)) & maxv) !== 0) {
+        // Check for invalid padding
+    }
+    return result;
+}
+//# sourceMappingURL=address.js.map

package/dist/utils/address.js.map

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

package/dist/utils/coin.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Coin creation utilities for Midnight Network.
+ *
+ * Creates coin structures for contract calls with nonce, color, and value.
+ *
+ * @since 0.2.0
+ * @module
+ */
+/**
+ * Coin information containing nonce, color, and value.
+ */
+export interface CoinInfo {
+    /** Random nonce (32 bytes) */
+    nonce: Uint8Array;
+    /** Token color/type (32 bytes) */
+    color: Uint8Array;
+    /** Token value */
+    value: bigint;
+}
+/**
+ * Get the native token color.
+ *
+ * @returns 32-byte Uint8Array representing the native token color
+ */
+export declare function getNativeTokenColor(): Uint8Array;
+/**
+ * Create a new coin with random nonce and native token color.
+ *
+ * @param amount - Token amount (as bigint or number)
+ * @returns CoinInfo with nonce, color, and value
+ *
+ * @example
+ * ```typescript
+ * // Create a coin with 1 TNIGHT (10^6 units)
+ * const coin = createCoin(1_000_000n);
+ *
+ * // Use in contract deployment
+ * await contract.deploy({ coin });
+ * ```
+ */
+export declare function createCoin(amount: bigint | number): CoinInfo;
+/**
+ * Create a coin with a custom token color.
+ *
+ * @param amount - Token amount
+ * @param color - Token color as Uint8Array (32 bytes)
+ * @returns CoinInfo with nonce, color, and value
+ *
+ * @example
+ * ```typescript
+ * const customCoin = createCustomCoin(100n, myTokenColor);
+ * ```
+ */
+export declare function createCustomCoin(amount: bigint | number, color: Uint8Array): CoinInfo;
+//# sourceMappingURL=coin.d.ts.map

package/dist/utils/coin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coin.d.ts","sourceRoot":"","sources":["../../src/utils/coin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAeD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAIhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAY5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,CAgBrF"}

package/dist/utils/coin.js

@@ -0,0 +1,84 @@
+/**
+ * Coin creation utilities for Midnight Network.
+ *
+ * Creates coin structures for contract calls with nonce, color, and value.
+ *
+ * @since 0.2.0
+ * @module
+ */
+import { encodeRawTokenType, nativeToken } from '@midnight-ntwrk/ledger-v6';
+/**
+ * Generate a cryptographically secure random nonce.
+ *
+ * Uses crypto.getRandomValues which is available in both browser and Node.js 18+.
+ *
+ * @returns Random 32-byte Uint8Array
+ */
+function generateNonce() {
+    const nonce = new Uint8Array(32);
+    crypto.getRandomValues(nonce);
+    return nonce;
+}
+/**
+ * Get the native token color.
+ *
+ * @returns 32-byte Uint8Array representing the native token color
+ */
+export function getNativeTokenColor() {
+    const rawType = nativeToken().raw;
+    const encoded = encodeRawTokenType(rawType);
+    return new Uint8Array(encoded);
+}
+/**
+ * Create a new coin with random nonce and native token color.
+ *
+ * @param amount - Token amount (as bigint or number)
+ * @returns CoinInfo with nonce, color, and value
+ *
+ * @example
+ * ```typescript
+ * // Create a coin with 1 TNIGHT (10^6 units)
+ * const coin = createCoin(1_000_000n);
+ *
+ * // Use in contract deployment
+ * await contract.deploy({ coin });
+ * ```
+ */
+export function createCoin(amount) {
+    const value = typeof amount === 'number' ? BigInt(amount) : amount;
+    if (value < 0n) {
+        throw new Error('Coin value cannot be negative');
+    }
+    return {
+        nonce: generateNonce(),
+        color: getNativeTokenColor(),
+        value,
+    };
+}
+/**
+ * Create a coin with a custom token color.
+ *
+ * @param amount - Token amount
+ * @param color - Token color as Uint8Array (32 bytes)
+ * @returns CoinInfo with nonce, color, and value
+ *
+ * @example
+ * ```typescript
+ * const customCoin = createCustomCoin(100n, myTokenColor);
+ * ```
+ */
+export function createCustomCoin(amount, color) {
+    if (color.length !== 32) {
+        throw new Error(`Invalid color length: expected 32 bytes, got ${color.length}`);
+    }
+    const value = typeof amount === 'number' ? BigInt(amount) : amount;
+    if (value < 0n) {
+        throw new Error('Coin value cannot be negative');
+    }
+    return {
+        nonce: generateNonce(),
+        color,
+        value,
+    };
+}
+//# sourceMappingURL=coin.js.map

package/dist/utils/coin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coin.js","sourceRoot":"","sources":["../../src/utils/coin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAc5E;;;;;;GAMG;AACH,SAAS,aAAa;IACpB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC,GAAG,CAAC;IAClC,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnE,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,aAAa,EAAE;QACtB,KAAK,EAAE,mBAAmB,EAAE;QAC5B,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAuB,EAAE,KAAiB;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEnE,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,aAAa,EAAE;QACtB,KAAK;QACL,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/utils/effect-runtime.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Effect runtime utilities for executing Effect programs.
+ *
+ * @since 0.3.0
+ * @module
+ */
+import { Effect } from 'effect';
+/**
+ * Run an Effect synchronously with clean error handling.
+ *
+ * - Executes the Effect using Effect.runSyncExit
+ * - On failure, extracts the error from the Exit and cleans stack traces
+ * - Removes Effect.ts internal stack frames for cleaner error messages
+ * - Throws the cleaned error for standard error handling
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { runEffect } from '@no-witness-labs/midday-sdk';
+ *
+ * const myEffect = Effect.succeed(42);
+ *
+ * try {
+ *   const result = runEffect(myEffect);
+ *   console.log(result);
+ * } catch (error) {
+ *   // Error with clean stack trace, no Effect.ts internals
+ *   console.error(error);
+ * }
+ * ```
+ *
+ * @since 0.3.0
+ * @category utilities
+ */
+export declare function runEffect<A, E>(effect: Effect.Effect<A, E>): A;
+/**
+ * Run an Effect asynchronously and convert it to a Promise with clean error handling.
+ *
+ * - Executes the Effect using Effect.runPromiseExit
+ * - On failure, extracts the error from the Exit and cleans stack traces
+ * - Removes Effect.ts internal stack frames for cleaner error messages
+ * - Throws the cleaned error for standard Promise error handling
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { runEffectPromise } from '@no-witness-labs/midday-sdk';
+ *
+ * const myEffect = Effect.succeed(42);
+ *
+ * async function example() {
+ *   try {
+ *     const result = await runEffectPromise(myEffect);
+ *     console.log(result);
+ *   } catch (error) {
+ *     // Error with clean stack trace, no Effect.ts internals
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ *
+ * @since 0.3.0
+ * @category utilities
+ */
+export declare function runEffectPromise<A, E>(effect: Effect.Effect<A, E>): Promise<A>;
+//# sourceMappingURL=effect-runtime.d.ts.map

package/dist/utils/effect-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-runtime.d.ts","sourceRoot":"","sources":["../../src/utils/effect-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAsE7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAc9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcpF"}

package/dist/utils/effect-runtime.js

@@ -0,0 +1,147 @@
+/**
+ * Effect runtime utilities for executing Effect programs.
+ *
+ * @since 0.3.0
+ * @module
+ */
+import { Cause, Effect, Exit } from 'effect';
+/**
+ * Patterns to filter from stack traces - Effect.ts internal implementation details
+ */
+const EFFECT_INTERNAL_PATTERNS = [
+    /node_modules\/.pnpm\/effect@.*\/node_modules\/effect\//,
+    /at FiberRuntime\./,
+    /at EffectPrimitive\./,
+    /at Object\.Iterator/,
+    /at runLoop/,
+    /at evaluateEffect/,
+    /at body \(/,
+    /effect_instruction_i\d+/,
+    /at pipeArguments/,
+    /at pipe \(/,
+    /at Arguments\./,
+    /at Module\./,
+    /at issue \(/,
+    /at \.\.\.$/, // Lines like "... 7 lines matching cause stack trace ..."
+];
+/**
+ * Clean a single error's stack trace by removing Effect.ts internals
+ */
+function cleanStackTrace(stack) {
+    if (!stack)
+        return '';
+    const lines = stack.split('\n');
+    const cleaned = lines.filter((line) => {
+        // Keep the error message line (first line)
+        if (!line.trim().startsWith('at '))
+            return true;
+        // Filter out Effect.ts internal lines
+        return !EFFECT_INTERNAL_PATTERNS.some((pattern) => pattern.test(line));
+    });
+    return cleaned.join('\n');
+}
+/**
+ * Recursively clean error chain (error and all causes)
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function cleanErrorChain(error) {
+    if (!error)
+        return error;
+    // Clean current error's stack
+    if (error.stack) {
+        error.stack = cleanStackTrace(error.stack);
+    }
+    // Recursively clean cause chain
+    if (error.cause) {
+        error.cause = cleanErrorChain(error.cause);
+    }
+    // Handle Effect.ts internal cause field
+    if (error[Symbol.for('effect/Runtime/FiberFailure/Cause')]) {
+        const cause = error[Symbol.for('effect/Runtime/FiberFailure/Cause')];
+        if (cause && typeof cause === 'object') {
+            if (cause.error) {
+                cause.error = cleanErrorChain(cause.error);
+            }
+        }
+    }
+    return error;
+}
+/**
+ * Run an Effect synchronously with clean error handling.
+ *
+ * - Executes the Effect using Effect.runSyncExit
+ * - On failure, extracts the error from the Exit and cleans stack traces
+ * - Removes Effect.ts internal stack frames for cleaner error messages
+ * - Throws the cleaned error for standard error handling
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { runEffect } from '@no-witness-labs/midday-sdk';
+ *
+ * const myEffect = Effect.succeed(42);
+ *
+ * try {
+ *   const result = runEffect(myEffect);
+ *   console.log(result);
+ * } catch (error) {
+ *   // Error with clean stack trace, no Effect.ts internals
+ *   console.error(error);
+ * }
+ * ```
+ *
+ * @since 0.3.0
+ * @category utilities
+ */
+export function runEffect(effect) {
+    const exit = Effect.runSyncExit(effect);
+    if (Exit.isFailure(exit)) {
+        // Extract the error from the failure
+        const error = Cause.squash(exit.cause);
+        // Clean the error's stack trace
+        const cleanedError = cleanErrorChain(error);
+        throw cleanedError;
+    }
+    return exit.value;
+}
+/**
+ * Run an Effect asynchronously and convert it to a Promise with clean error handling.
+ *
+ * - Executes the Effect using Effect.runPromiseExit
+ * - On failure, extracts the error from the Exit and cleans stack traces
+ * - Removes Effect.ts internal stack frames for cleaner error messages
+ * - Throws the cleaned error for standard Promise error handling
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { runEffectPromise } from '@no-witness-labs/midday-sdk';
+ *
+ * const myEffect = Effect.succeed(42);
+ *
+ * async function example() {
+ *   try {
+ *     const result = await runEffectPromise(myEffect);
+ *     console.log(result);
+ *   } catch (error) {
+ *     // Error with clean stack trace, no Effect.ts internals
+ *     console.error(error);
+ *   }
+ * }
+ * ```
+ *
+ * @since 0.3.0
+ * @category utilities
+ */
+export async function runEffectPromise(effect) {
+    const exit = await Effect.runPromiseExit(effect);
+    if (Exit.isFailure(exit)) {
+        // Extract the error from the failure
+        const error = Cause.squash(exit.cause);
+        // Clean the error's stack trace
+        const cleanedError = cleanErrorChain(error);
+        throw cleanedError;
+    }
+    return exit.value;
+}
+//# sourceMappingURL=effect-runtime.js.map