polen 0.11.0-next.14 → 0.11.0-next.15

package/build/lib/services-crud/browser-ro.d.ts

@@ -0,0 +1,51 @@
+import { Layer } from 'effect';
+import { CrudService } from './service.js';
+declare const FetchError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FetchError";
+} & Readonly<A>;
+/**
+ * Structured error types for browser read-only operations
+ */
+export declare class FetchError extends FetchError_base<{
+    readonly url: string;
+    readonly status: number;
+    readonly statusText: string;
+}> {
+}
+declare const NetworkError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "NetworkError";
+} & Readonly<A>;
+export declare class NetworkError extends NetworkError_base<{
+    readonly relativePath: string;
+    readonly cause: unknown;
+}> {
+}
+declare const UnsupportedOperationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "UnsupportedOperationError";
+} & Readonly<A>;
+export declare class UnsupportedOperationError extends UnsupportedOperationError_base<{
+    readonly operation: string;
+    readonly message: string;
+}> {
+}
+/**
+ * Create a read-only CRUD service layer for browser environments.
+ *
+ * This service uses the fetch API to read files from a remote server.
+ * Write, list, and remove operations are not supported and will fail
+ * with descriptive error messages.
+ *
+ * This is ideal for:
+ * - Loading static data from a CDN or static server
+ * - Reading configuration files in browser applications
+ * - Fetching pre-generated data exports
+ *
+ * For write operations in browser environments, implement a custom
+ * service that uses your API endpoints.
+ *
+ * @param baseUrl - Base URL for all fetch operations
+ * @returns Layer providing read-only CrudService backed by HTTP fetch
+ */
+export declare const browserReadOnly: (baseUrl: string) => Layer.Layer<CrudService, never, never>;
+export {};
+//# sourceMappingURL=browser-ro.d.ts.map

package/build/lib/services-crud/browser-ro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-ro.d.ts","sourceRoot":"","sources":["../../../src/lib/services-crud/browser-ro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;;;;AAE1C;;GAEG;AACH,qBAAa,UAAW,SAAQ,gBAA+B;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAC;CAAG;;;;AAEL,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,qBAAa,yBAA0B,SAAQ,+BAA8C;IAC3F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAEL;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,2CAyD9C,CAAA"}

package/build/lib/services-crud/browser-ro.js

@@ -0,0 +1,69 @@
+import { Data, Effect, Layer } from 'effect';
+import { CrudService } from './service.js';
+/**
+ * Structured error types for browser read-only operations
+ */
+export class FetchError extends Data.TaggedError('FetchError') {
+}
+export class NetworkError extends Data.TaggedError('NetworkError') {
+}
+export class UnsupportedOperationError extends Data.TaggedError('UnsupportedOperationError') {
+}
+/**
+ * Create a read-only CRUD service layer for browser environments.
+ *
+ * This service uses the fetch API to read files from a remote server.
+ * Write, list, and remove operations are not supported and will fail
+ * with descriptive error messages.
+ *
+ * This is ideal for:
+ * - Loading static data from a CDN or static server
+ * - Reading configuration files in browser applications
+ * - Fetching pre-generated data exports
+ *
+ * For write operations in browser environments, implement a custom
+ * service that uses your API endpoints.
+ *
+ * @param baseUrl - Base URL for all fetch operations
+ * @returns Layer providing read-only CrudService backed by HTTP fetch
+ */
+export const browserReadOnly = (baseUrl) => {
+    const normalizedBaseUrl = baseUrl.endsWith('/') ? baseUrl : baseUrl + '/';
+    return Layer.succeed(CrudService, {
+        read: (relativePath) => Effect.gen(function* () {
+            const url = new URL(relativePath, normalizedBaseUrl).toString();
+            const response = yield* Effect.tryPromise({
+                try: () => fetch(url),
+                catch: (cause) => new NetworkError({ relativePath, cause }),
+            });
+            if (!response.ok) {
+                return yield* Effect.fail(new FetchError({
+                    url,
+                    status: response.status,
+                    statusText: response.statusText,
+                }));
+            }
+            return yield* Effect.tryPromise({
+                try: () => response.text(),
+                catch: (cause) => new NetworkError({ relativePath, cause }),
+            });
+        }),
+        write: (_relativePath, _data) => Effect.fail(new UnsupportedOperationError({
+            operation: 'write',
+            message: 'Write operations not supported by Browser Read-Only service. '
+                + 'Use a server-side CRUD service or implement a custom browser service for your API.',
+        })),
+        list: (_relativePath) => Effect.fail(new UnsupportedOperationError({
+            operation: 'list',
+            message: 'List operations not supported by Browser Read-Only service. '
+                + 'Browser environments cannot list remote directories. '
+                + 'Consider using a manifest file or selection-based loading.',
+        })),
+        remove: (_relativePath) => Effect.fail(new UnsupportedOperationError({
+            operation: 'remove',
+            message: 'Remove operations not supported by Browser Read-Only service. '
+                + 'Use a server-side CRUD service or implement a custom browser service for your API.',
+        })),
+    });
+};
+//# sourceMappingURL=browser-ro.js.map

package/build/lib/services-crud/browser-ro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-ro.js","sourceRoot":"","sources":["../../../src/lib/services-crud/browser-ro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,IAAI,CAAC,WAAW,CAAC,YAAY,CAI3D;CAAG;AAEL,MAAM,OAAO,YAAa,SAAQ,IAAI,CAAC,WAAW,CAAC,cAAc,CAG/D;CAAG;AAEL,MAAM,OAAO,yBAA0B,SAAQ,IAAI,CAAC,WAAW,CAAC,2BAA2B,CAGzF;CAAG;AAEL;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,EAAE;IACjD,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAA;IAEzE,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;QAChC,IAAI,EAAE,CAAC,YAAoB,EAAE,EAAE,CAC7B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAA;YAE/D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACxC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;gBACrB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;aAC5D,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,UAAU,CAAC;oBACb,GAAG;oBACH,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;iBAChC,CAAC,CACH,CAAA;YACH,CAAC;YAED,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE;gBAC1B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;aAC5D,CAAC,CAAA;QACJ,CAAC,CAAC;QAEJ,KAAK,EAAE,CAAC,aAAqB,EAAE,KAAa,EAAE,EAAE,CAC9C,MAAM,CAAC,IAAI,CACT,IAAI,yBAAyB,CAAC;YAC5B,SAAS,EAAE,OAAO;YAClB,OAAO,EAAE,+DAA+D;kBACpE,oFAAoF;SACzF,CAAC,CACH;QAEH,IAAI,EAAE,CAAC,aAAqB,EAAE,EAAE,CAC9B,MAAM,CAAC,IAAI,CACT,IAAI,yBAAyB,CAAC;YAC5B,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,8DAA8D;kBACnE,uDAAuD;kBACvD,4DAA4D;SACjE,CAAC,CACH;QAEH,MAAM,EAAE,CAAC,aAAqB,EAAE,EAAE,CAChC,MAAM,CAAC,IAAI,CACT,IAAI,yBAAyB,CAAC;YAC5B,SAAS,EAAE,QAAQ;YACnB,OAAO,EAAE,gEAAgE;kBACrE,oFAAoF;SACzF,CAAC,CACH;KACJ,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/build/lib/services-crud/filesystem.d.ts

@@ -0,0 +1,17 @@
+import { Layer } from 'effect';
+import { CrudService } from './service.js';
+/**
+ * Create a CRUD service layer that adapts Effect Platform FileSystem service.
+ *
+ * This adapter bridges the gap between the generic CRUD service interface and
+ * the rich FileSystem service from Effect Platform. It handles:
+ * - Auto-creation of parent directories on write
+ * - Path resolution relative to the base path
+ * - Error mapping from PlatformError to generic Error
+ * - Graceful handling of missing files/directories
+ *
+ * @param basePath - Base directory path for all operations
+ * @returns Layer providing CrudService backed by FileSystem
+ */
+export declare const fromFileSystem: (basePath: string) => Layer.Layer<CrudService, never, never>;
+//# sourceMappingURL=filesystem.d.ts.map

package/build/lib/services-crud/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/lib/services-crud/filesystem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,2CA4C5C,CAAA"}

package/build/lib/services-crud/filesystem.js

@@ -0,0 +1,36 @@
+import { FileSystem, Path } from '@effect/platform';
+import { NodeFileSystem, NodePath } from '@effect/platform-node';
+import { Effect, Layer } from 'effect';
+import { CrudService } from './service.js';
+/**
+ * Create a CRUD service layer that adapts Effect Platform FileSystem service.
+ *
+ * This adapter bridges the gap between the generic CRUD service interface and
+ * the rich FileSystem service from Effect Platform. It handles:
+ * - Auto-creation of parent directories on write
+ * - Path resolution relative to the base path
+ * - Error mapping from PlatformError to generic Error
+ * - Graceful handling of missing files/directories
+ *
+ * @param basePath - Base directory path for all operations
+ * @returns Layer providing CrudService backed by FileSystem
+ */
+export const fromFileSystem = (basePath) => Layer.effect(CrudService, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    return {
+        read: (relativePath) => fs.readFileString(path.join(basePath, relativePath))
+            .pipe(Effect.mapError(error => new Error(`Failed to read ${relativePath}: ${error}`))),
+        write: (relativePath, data) => Effect.gen(function* () {
+            const fullPath = path.join(basePath, relativePath);
+            const dir = path.dirname(fullPath);
+            yield* fs.makeDirectory(dir, { recursive: true });
+            yield* fs.writeFileString(fullPath, data);
+        }).pipe(Effect.mapError(error => new Error(`Failed to write ${relativePath}: ${error}`))),
+        list: (relativePath) => fs.readDirectory(path.join(basePath, relativePath))
+            .pipe(Effect.catchTag('SystemError', error => error.reason === 'NotFound' ? Effect.succeed([]) : Effect.fail(error)), Effect.mapError(error => new Error(`Failed to list ${relativePath}: ${error}`))),
+        remove: (relativePath) => fs.remove(path.join(basePath, relativePath))
+            .pipe(Effect.catchTag('SystemError', error => error.reason === 'NotFound' ? Effect.succeed(undefined) : Effect.fail(error)), Effect.mapError(error => new Error(`Failed to remove ${relativePath}: ${error}`))),
+    };
+})).pipe(Layer.provide(NodeFileSystem.layer), Layer.provide(NodePath.layer));
+//# sourceMappingURL=filesystem.js.map

package/build/lib/services-crud/filesystem.js.map

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

package/build/lib/services-crud/memory.d.ts

@@ -0,0 +1,31 @@
+import { Layer } from 'effect';
+import { CrudService } from './service.js';
+/**
+ * Options for configuring the memory CRUD service.
+ */
+export interface MemoryOptions {
+    /**
+     * Base path for all operations (defaults to '.')
+     */
+    basePath?: string;
+    /**
+     * Initial files to populate the memory filesystem
+     */
+    initialFiles?: Map<string, string> | Record<string, string>;
+}
+/**
+ * Create a CRUD service layer backed by in-memory storage.
+ *
+ * This service stores all data in memory using a Map, making it perfect for:
+ * - Unit testing with isolated, predictable state
+ * - Temporary data storage that doesn't need persistence
+ * - Fast operations without disk I/O overhead
+ *
+ * The service maintains proper path semantics and directory structure
+ * simulation while keeping everything in memory.
+ *
+ * @param options - Configuration options
+ * @returns Layer providing CrudService backed by memory storage
+ */
+export declare const memory: (options?: MemoryOptions) => Layer.Layer<CrudService, never, never>;
+//# sourceMappingURL=memory.d.ts.map

package/build/lib/services-crud/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/lib/services-crud/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5D;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,GAAI,UAAU,aAAa,2CAoD7C,CAAA"}

package/build/lib/services-crud/memory.js

@@ -0,0 +1,61 @@
+import { Effect, Layer } from 'effect';
+import * as path from 'node:path';
+import { CrudService } from './service.js';
+/**
+ * Create a CRUD service layer backed by in-memory storage.
+ *
+ * This service stores all data in memory using a Map, making it perfect for:
+ * - Unit testing with isolated, predictable state
+ * - Temporary data storage that doesn't need persistence
+ * - Fast operations without disk I/O overhead
+ *
+ * The service maintains proper path semantics and directory structure
+ * simulation while keeping everything in memory.
+ *
+ * @param options - Configuration options
+ * @returns Layer providing CrudService backed by memory storage
+ */
+export const memory = (options) => {
+    const basePath = options?.basePath || '.';
+    const initialFilesInput = options?.initialFiles instanceof Map
+        ? options.initialFiles
+        : new Map(Object.entries(options?.initialFiles || {}));
+    // Convert initial files to use full paths and create persistent storage
+    const files = new Map();
+    for (const [filename, content] of initialFilesInput) {
+        const fullPath = path.join(basePath, filename);
+        files.set(fullPath, content);
+    }
+    return Layer.succeed(CrudService, {
+        read: (relativePath) => Effect.sync(() => {
+            const fullPath = path.join(basePath, relativePath);
+            const content = files.get(fullPath);
+            if (content === undefined) {
+                throw new Error(`File not found: ${relativePath}`);
+            }
+            return content;
+        }),
+        write: (relativePath, data) => Effect.sync(() => {
+            const fullPath = path.join(basePath, relativePath);
+            files.set(fullPath, data);
+        }),
+        list: (relativePath) => Effect.sync(() => {
+            const searchPath = path.join(basePath, relativePath);
+            const normalizedSearchPath = searchPath.endsWith('/') ? searchPath : searchPath + '/';
+            // Find all files in the directory
+            return Array.from(files.keys())
+                .filter(filePath => {
+                const dir = path.dirname(filePath);
+                const normalizedDir = dir.endsWith('/') ? dir : dir + '/';
+                return normalizedDir === normalizedSearchPath
+                    || (searchPath === basePath && dir === searchPath);
+            })
+                .map(filePath => path.basename(filePath));
+        }),
+        remove: (relativePath) => Effect.sync(() => {
+            const fullPath = path.join(basePath, relativePath);
+            files.delete(fullPath);
+        }),
+    });
+};
+//# sourceMappingURL=memory.js.map

package/build/lib/services-crud/memory.js.map

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

package/build/lib/services-crud/service.d.ts

@@ -0,0 +1,45 @@
+import { Context, Effect } from 'effect';
+/**
+ * Core CRUD service interface for basic file operations.
+ *
+ * This interface provides platform-agnostic CRUD operations for string-based file content.
+ * Implementations can target different platforms (filesystem, memory, HTTP, etc.) while
+ * maintaining the same interface contract.
+ */
+export interface CrudService {
+    /**
+     * Read file contents as a string.
+     *
+     * @param path - Relative path to the file
+     * @returns Effect resolving to file contents as string
+     */
+    readonly read: (path: string) => Effect.Effect<string, Error>;
+    /**
+     * Write string data to a file.
+     * Implementations should auto-create parent directories as needed.
+     *
+     * @param path - Relative path to the file
+     * @param data - String content to write
+     * @returns Effect resolving when write is complete
+     */
+    readonly write: (path: string, data: string) => Effect.Effect<void, Error>;
+    /**
+     * List contents of a directory.
+     *
+     * @param path - Relative path to the directory
+     * @returns Effect resolving to array of filenames in the directory
+     */
+    readonly list: (path: string) => Effect.Effect<readonly string[], Error>;
+    /**
+     * Remove a file or directory.
+     *
+     * @param path - Relative path to the file or directory to remove
+     * @returns Effect resolving when removal is complete
+     */
+    readonly remove: (path: string) => Effect.Effect<void, Error>;
+}
+/**
+ * Service tag for dependency injection.
+ */
+export declare const CrudService: Context.Tag<CrudService, CrudService>;
+//# sourceMappingURL=service.d.ts.map

package/build/lib/services-crud/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/lib/services-crud/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAExC;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAE7D;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAE1E;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,CAAA;IAExE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;CAC9D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,uCAAsE,CAAA"}

package/build/lib/services-crud/service.js

@@ -0,0 +1,6 @@
+import { Context, Effect } from 'effect';
+/**
+ * Service tag for dependency injection.
+ */
+export const CrudService = Context.GenericTag('@polen/services-crud/CrudService');
+//# sourceMappingURL=service.js.map

package/build/lib/services-crud/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/lib/services-crud/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AA6CxC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAc,kCAAkC,CAAC,CAAA"}

package/build/lib/stack-processor/stack-processor.d.ts

@@ -1,4 +1,21 @@
 import type { Bool, Fn, Prom } from '@wollybeard/kit';
+import { Effect } from 'effect';
+/**
+ * Effect-based version that processes functions sequentially until predicate is met
+ */
+export declare const untilEffect: <A extends readonly unknown[], R, E, Context>(predicate: (value: R) => boolean) => <fns extends readonly ((..._: A) => Effect.Effect<R, E, Context>)[]>(fns: fns) => (...args: A) => Effect.Effect<R | undefined, E, Context>;
+/**
+ * Legacy Promise-based version for backward compatibility
+ * @deprecated Use untilEffect for better error handling and composition
+ */
 export declare const until: (predicate: Bool.Predicate) => <fn extends Fn.AnyAny>(fns: fn[]) => Fn.ReturnExtract<Prom.AnyAny, fn>;
+/**
+ * Effect-based version that processes functions until a defined result is found
+ */
+export declare const untilDefinedEffect: <fns_1 extends readonly ((..._: readonly unknown[]) => Effect.Effect<unknown, unknown, unknown>)[]>(fns: fns_1) => (...args: readonly unknown[]) => Effect.Effect<unknown, unknown, unknown>;
+/**
+ * Legacy Promise-based version for backward compatibility
+ * @deprecated Use untilDefinedEffect
+ */
 export declare const untilDefined: <fn extends Fn.AnyAny>(fns: fn[]) => Fn.ReturnExtract<Prom.AnyAny, fn>;
 //# sourceMappingURL=stack-processor.d.ts.map

package/build/lib/stack-processor/stack-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack-processor.d.ts","sourceRoot":"","sources":["../../../src/lib/stack-processor/stack-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGrD,eAAO,MAAM,KAAK,GAChB,WAAW,IAAI,CAAC,SAAS,MAE1B,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CASlE,CAAA;AAED,eAAO,MAAM,YAAY,GAXxB,EAAE,SAAS,EAAE,CAAC,MAAM,OAAO,EAAE,EAAE,KAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAWlB,CAAA"}
+{"version":3,"file":"stack-processor.d.ts","sourceRoot":"","sources":["../../../src/lib/stack-processor/stack-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EACrE,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,MAEjC,GAAG,SAAS,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,EACjE,KAAK,GAAG,MAET,GAAG,MAAM,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,OAAO,CAOjD,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,KAAK,GAChB,WAAW,IAAI,CAAC,SAAS,MAE1B,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CASlE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,sHA9B9B,GAAG,wBAAO,6CA8BkD,CAAA;AAE7D;;;GAGG;AACH,eAAO,MAAM,YAAY,GApBxB,EAAE,SAAS,EAAE,CAAC,MAAM,OAAO,EAAE,EAAE,KAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAoBlB,CAAA"}

package/build/lib/stack-processor/stack-processor.js

@@ -1,4 +1,20 @@
 import { Undefined } from '@wollybeard/kit';
+import { Effect } from 'effect';
+/**
+ * Effect-based version that processes functions sequentially until predicate is met
+ */
+export const untilEffect = (predicate) => (fns) => (...args) => Effect.gen(function* () {
+    for (const fn of fns) {
+        const result = yield* fn(...args);
+        if (predicate(result))
+            return result;
+    }
+    return undefined;
+});
+/**
+ * Legacy Promise-based version for backward compatibility
+ * @deprecated Use untilEffect for better error handling and composition
+ */
 export const until = (predicate) => (fns) => {
     // @ts-expect-error
     return async (...args) => {
@@ -10,5 +26,13 @@ export const until = (predicate) => (fns) => {
         return undefined;
     };
 };
+/**
+ * Effect-based version that processes functions until a defined result is found
+ */
+export const untilDefinedEffect = untilEffect(Undefined.isnt);
+/**
+ * Legacy Promise-based version for backward compatibility
+ * @deprecated Use untilDefinedEffect
+ */
 export const untilDefined = until(Undefined.isnt);
 //# sourceMappingURL=stack-processor.js.map

package/build/lib/stack-processor/stack-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"stack-processor.js","sourceRoot":"","sources":["../../../src/lib/stack-processor/stack-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,SAAyB,EACzB,EAAE,CACJ,CAAuB,GAAS,EAAqC,EAAE;IACrE,mBAAmB;IACnB,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;QACvB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,MAAM,GAAQ,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YACrC,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAA;QACtC,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"stack-processor.js","sourceRoot":"","sources":["../../../src/lib/stack-processor/stack-processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,SAAgC,EAChC,EAAE,CACJ,CACE,GAAQ,EACR,EAAE,CACJ,CAAC,GAAG,IAAO,EAA4C,EAAE,CACvD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACjC,IAAI,SAAS,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAA;IACtC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAC,CAAA;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,SAAyB,EACzB,EAAE,CACJ,CAAuB,GAAS,EAAqC,EAAE;IACrE,mBAAmB;IACnB,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;QACvB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,MAAM,GAAQ,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YACrC,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAA;QACtC,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA"}

package/build/lib/task/report.d.ts

@@ -15,13 +15,13 @@ export interface FormatOptions<$Input, $Output> {
     /**
      * Force masks to reveal all data
      */
-    debug?: boolean;
+    debug?: boolean | undefined;
     /**
      * A mask to apply to the input (if any) and successful return (if any).
      *
      * @default Uses the mask bundled with the task, if any.
      */
-    mask?: MaskOptions<$Input, $Output>;
+    mask?: MaskOptions<$Input, $Output> | undefined;
 }
 export declare const formatReport: <$Input, $Output>(report: Report<$Input, $Output>, options?: FormatOptions<$Input, $Output>) => string;
 export declare const exitWithReport: <$Input, $Output>(report: Report<$Input, $Output>, options?: FormatOptions<$Input, $Output>) => never;

package/build/lib/task/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/lib/task/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAExD,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO;IACrC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,OAAO,GAAG,KAAK,CAAA;QACvB,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAA;YACb,GAAG,EAAE,MAAM,CAAA;YACX,QAAQ,EAAE,MAAM,CAAA;SACjB,CAAA;KACF,CAAA;CACF;AAED,MAAM,WAAW,aAAa,CAAC,MAAM,EAAE,OAAO;IAC5C;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,EAAE,OAAO,EAC1C,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,MA4BF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,EAAE,OAAO,EAC5C,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,KAKF,CAAA"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/lib/task/report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAExD,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO;IACrC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,OAAO,GAAG,KAAK,CAAA;QACvB,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAA;YACb,GAAG,EAAE,MAAM,CAAA;YACX,QAAQ,EAAE,MAAM,CAAA;SACjB,CAAA;KACF,CAAA;CACF;AAED,MAAM,WAAW,aAAa,CAAC,MAAM,EAAE,OAAO;IAC5C;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAChD;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,EAAE,OAAO,EAC1C,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,MA4BF,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,EAAE,OAAO,EAC5C,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,KACvC,KAKF,CAAA"}

package/build/lib/task/task.d.ts

@@ -1,11 +1,12 @@
 import type { Mask } from '#lib/mask';
+import { Effect } from 'effect';
 import type { Report } from './report.js';
 export interface Definition<$Input = any, $Output = any> {
     name: string;
-    mask?: MaskOptions<$Input, $Output>;
+    mask?: MaskOptions<$Input, $Output> | undefined;
 }
-export interface Task<$Input, $Output> {
-    (input: $Input): Promise<Report<$Input, $Output>>;
+export interface Task<$Input, $Output, $Error = never, $Requirements = never> {
+    (input: $Input): Effect.Effect<Report<$Input, $Output>, $Error, $Requirements>;
     definition: Definition<$Input, $Output>;
 }
 export interface MaskOptions<$Input, $Output> {
@@ -18,16 +19,16 @@ export interface MaskOptions<$Input, $Output> {
      */
     output?: Mask.InferOptions<$Output>;
 }
-export declare const create: <$Input, $Output>(fn: (input: $Input) => Promise<$Output>, options?: {
+export declare const create: <$Input, $Output, $Error = never, $Requirements = never>(fn: (input: $Input) => Effect.Effect<$Output, $Error, $Requirements>, options?: {
     /**
      * @default the fn name
      */
-    name?: string;
+    name?: string | undefined;
     /**
      * An optional default mask to use for successfully returned values.
      */
-    mask?: MaskOptions<$Input, $Output>;
-}) => Task<$Input, $Output>;
+    mask?: MaskOptions<$Input, $Output> | undefined;
+}) => Task<$Input, $Output, $Error, $Requirements>;
 /**
  * Sugar method that creates a task, executes it, and exits with the report.
  * Equivalent to: create(fn, options) -> task(input) -> exitWithReport(report)
@@ -36,9 +37,9 @@ export declare const create: <$Input, $Output>(fn: (input: $Input) => Promise<$O
  * @param input - Input to pass to the task
  * @param options - Combined task creation and format options
  */
-export declare const runAndExit: <$Input, $Output>(fn: (input: $Input) => Promise<$Output>, input: $Input, options?: {
-    name?: string;
-    mask?: MaskOptions<$Input, $Output>;
-    debug?: boolean;
-}) => Promise<never>;
+export declare const runAndExit: <$Input, $Output, $Error = never, $Requirements = never>(fn: (input: $Input) => Effect.Effect<$Output, $Error, $Requirements>, input: $Input, options?: {
+    name?: string | undefined;
+    mask?: MaskOptions<$Input, $Output> | undefined;
+    debug?: boolean | undefined;
+}) => Effect.Effect<never, never, $Requirements>;
 //# sourceMappingURL=task.d.ts.map

package/build/lib/task/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/lib/task/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,IAAI,CAAC,MAAM,EAAE,OAAO;IACnC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjD,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,OAAO;IAC1C;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;CACpC;AAED,eAAO,MAAM,MAAM,GAAI,MAAM,EAAE,OAAO,EACpC,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvC,UAAU;IACR;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC,KACA,IAAI,CAAC,MAAM,EAAE,OAAO,CA8CtB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAU,MAAM,EAAE,OAAO,EAC9C,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACvC,OAAO,MAAM,EACb,UAAU;IACR,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,KACA,OAAO,CAAC,KAAK,CAUf,CAAA"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/lib/task/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOzC,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAChD;AAED,MAAM,WAAW,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK;IAC1E,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA;IAC9E,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,OAAO;IAC1C;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;CACpC;AAMD,eAAO,MAAM,MAAM,GAAI,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAC3E,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EACpE,UAAU;IACR;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAChD,KACA,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAgD7C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,aAAa,GAAG,KAAK,EAC/E,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EACpE,OAAO,MAAM,EACb,UAAU;IACR,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAC/C,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC5B,KACA,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAgBM,CAAA"}

package/build/lib/task/task.js

@@ -1,19 +1,23 @@
+import { Effect } from 'effect';
 import { exitWithReport } from './report.js';
+// ============================================================================
+// Core Functions
+// ============================================================================
 export const create = (fn, options) => {
     const definition = {
-        name: options?.name ?? (fn.name || `anonymous`),
+        name: options?.name ?? 'anonymous',
         mask: options?.mask,
     };
-    const task = async (input) => {
+    const task = (input) => Effect.gen(function* () {
         const start = performance.now();
-        try {
-            const output = await fn(input);
-            const end = performance.now();
+        const result = yield* fn(input).pipe(Effect.either);
+        const end = performance.now();
+        if (result._tag === 'Right') {
             return {
                 task: definition,
                 execution: {
                     input,
-                    output,
+                    output: result.right,
                     timings: {
                         start,
                         end,
@@ -22,13 +26,12 @@ export const create = (fn, options) => {
                 },
             };
         }
-        catch (error) {
-            const end = performance.now();
+        else {
             return {
                 task: definition,
                 execution: {
                     input,
-                    output: error,
+                    output: result.left,
                     timings: {
                         start,
                         end,
@@ -37,7 +40,7 @@ export const create = (fn, options) => {
                 },
             };
         }
-    };
+    });
     task.definition = definition;
     return task;
 };
@@ -49,15 +52,20 @@ export const create = (fn, options) => {
  * @param input - Input to pass to the task
  * @param options - Combined task creation and format options
  */
-export const runAndExit = async (fn, input, options) => {
+export const runAndExit = (fn, input, options) => Effect.gen(function* () {
     const task = create(fn, {
         name: options?.name,
         mask: options?.mask,
     });
-    const report = await task(input);
-    return exitWithReport(report, {
+    // The task function handles errors internally and wraps them in the report
+    // so it should never fail - it always returns a Report
+    const report = yield* task(input);
+    // exitWithReport calls process.exit, so it never returns
+    exitWithReport(report, {
         debug: options?.debug,
         mask: options?.mask,
     });
-};
+    // This line will never be reached, but TypeScript needs it for the never type
+    return yield* Effect.die('unreachable');
+});
 //# sourceMappingURL=task.js.map

package/build/lib/task/task.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/lib/task/task.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAuB5C,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,EAAuC,EACvC,OASC,EACsB,EAAE;IACzB,MAAM,UAAU,GAAgC;QAC9C,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,WAAW,CAAC;QAC/C,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAA;IAED,MAAM,IAAI,GAAG,KAAK,EAAE,KAAa,EAAoC,EAAE;QACrE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAE/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAA;YAC9B,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YAE7B,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE;oBACT,KAAK;oBACL,MAAM;oBACN,OAAO,EAAE;wBACP,KAAK;wBACL,GAAG;wBACH,QAAQ,EAAE,GAAG,GAAG,KAAK;qBACtB;iBACF;aACF,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YAE7B,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE;oBACT,KAAK;oBACL,MAAM,EAAE,KAAc;oBACtB,OAAO,EAAE;wBACP,KAAK;wBACL,GAAG;wBACH,QAAQ,EAAE,GAAG,GAAG,KAAK;qBACtB;iBACF;aACF,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAE5B,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,EAAuC,EACvC,KAAa,EACb,OAIC,EACe,EAAE;IAClB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,EAAE;QACtB,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAA;IAChC,OAAO,cAAc,CAAC,MAAM,EAAE;QAC5B,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/lib/task/task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AA2B5C,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,EAAoE,EACpE,OASC,EAC6C,EAAE;IAChD,MAAM,UAAU,GAAgC;QAC9C,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,WAAW;QAClC,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,KAAa,EAAiE,EAAE,CAC5F,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAE/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAClC,MAAM,CAAC,MAAM,CACd,CAAA;QAED,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAE7B,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE;oBACT,KAAK;oBACL,MAAM,EAAE,MAAM,CAAC,KAAK;oBACpB,OAAO,EAAE;wBACP,KAAK;wBACL,GAAG;wBACH,QAAQ,EAAE,GAAG,GAAG,KAAK;qBACtB;iBACF;aACF,CAAA;QACH,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE;oBACT,KAAK;oBACL,MAAM,EAAE,MAAM,CAAC,IAAa;oBAC5B,OAAO,EAAE;wBACP,KAAK;wBACL,GAAG;wBACH,QAAQ,EAAE,GAAG,GAAG,KAAK;qBACtB;iBACF;aACF,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEJ,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAE5B,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,EAAoE,EACpE,KAAa,EACb,OAIC,EAC2C,EAAE,CAC9C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,EAAE;QACtB,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC,CAAA;IACF,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjC,yDAAyD;IACzD,cAAc,CAAC,MAAM,EAAE;QACrB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC,CAAA;IACF,8EAA8E;IAC9E,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;AACzC,CAAC,CAA+C,CAAA"}

package/build/lib/version/$$.d.ts

@@ -0,0 +1,2 @@
+export * from './version.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/lib/version/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/lib/version/$$.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/build/lib/version/$$.js

@@ -0,0 +1,2 @@
+export * from './version.js';
+//# sourceMappingURL=$$.js.map

package/build/lib/version/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/lib/version/$$.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}