every-plugin 0.0.6 → 0.1.1

package/README.md

@@ -1,265 +1 @@
-# every-plugin
-
-A modular plugin runtime & system built with [Effect.TS](https://effect.website/) for loading, initializing, and executing remote plugins via [Module Federation](https://module-federation.io/).
-
-## Installation
-
-```bash
-npm install every-plugin
-# or
-bun add every-plugin
-```
-
-## Quick Start
-
-### Basic Plugin Usage
-
-```typescript
-import { Effect, ManagedRuntime } from "effect";
-import { PluginRuntime } from "every-plugin/runtime";
-
-// Create a managed runtime (do this once per application/worker)
-const runtime = ManagedRuntime.make(PluginRuntime.Live({
-  registry: {
-    "@my-org/data-processor": {
-      version: "1.0.0",
-      remoteUrl: "https://cdn.example.com/plugins/data-processor@latest/remoteEntry.js",
-      description: "Processes data items",
-      type: "pipeline"
-    }
-  },
-  secrets: {
-    API_KEY: "your-secret-key",
-    DATABASE_URL: "postgresql://..."
-  },
-  logger: customLogger // optional
-}));
-
-// Use the runtime to execute plugins
-const result = await runtime.runPromise(
-  Effect.gen(function* () {
-    const pluginRuntime = yield* PluginRuntime;
-    
-    // Use and execute a plugin in one step
-    const plugin = yield* pluginRuntime.usePlugin("@my-org/data-processor", {
-      apiKey: "{{API_KEY}}", // Will be hydrated from secrets
-      batchSize: 100
-    });
-    
-    const output = yield* pluginRuntime.executePlugin(plugin, {
-      items: ["item1", "item2", "item3"]
-    });
-    
-    return output;
-  })
-);
-
-console.log(result);
-
-// Clean up when done
-await runtime.dispose();
-```
-
-### Alternative: Convenience Factory Function
-
-If you prefer a factory function, you can use the convenience wrapper:
-
-```typescript
-import { createPluginRuntime, PluginRuntime } from "every-plugin/runtime";
-
-// This is equivalent to ManagedRuntime.make(PluginRuntime.Live(config))
-const runtime = createPluginRuntime({
-  registry: { /* ... */ },
-  secrets: { /* ... */ }
-});
-
-const result = await runtime.runPromise(
-  Effect.gen(function* () {
-    const pluginRuntime = yield* PluginRuntime;
-    return yield* pluginRuntime.usePlugin(pluginId, config);
-  })
-);
-```
-
-### Advanced Usage - Granular Control
-
-```typescript
-import { Effect } from "effect";
-import { PluginRuntime } from "every-plugin/runtime";
-
-const processWithGranularControl = Effect.gen(function* () {
-  const pluginRuntime = yield* PluginRuntime;
-  
-  // Step-by-step plugin lifecycle
-  const constructor = yield* pluginRuntime.loadPlugin("@my-org/data-processor");
-  const instance = yield* pluginRuntime.instantiatePlugin(constructor);
-  const initialized = yield* pluginRuntime.initializePlugin(instance, config);
-  const output = yield* pluginRuntime.executePlugin(initialized, input);
-  
-  return output;
-});
-
-await runtime.runPromise(processWithGranularControl);
-```
-
-### Worker Integration
-
-Perfect for BullMQ workers or similar job processing systems:
-
-```typescript
-import { Job } from "bullmq";
-import { Effect } from "effect";
-import { createPluginRuntime, PluginRuntime } from "every-plugin/runtime";
-
-// Initialize runtime once per worker
-const runtime = createPluginRuntime({
-  registry: pluginRegistry,
-  secrets: await loadSecrets(),
-});
-
-// Job processor
-const processJob = (job: Job) => 
-  runtime.runPromise(
-    Effect.gen(function* () {
-      const pluginRuntime = yield* PluginRuntime;
-      const { pluginId, config, input } = job.data;
-      
-      const plugin = yield* pluginRuntime.usePlugin(pluginId, config);
-      return yield* pluginRuntime.executePlugin(plugin, input);
-    })
-  );
-
-// Worker setup
-const worker = new Worker("my-queue", processJob);
-
-// Cleanup on shutdown
-process.on("SIGTERM", async () => {
-  await worker.close();
-  await runtime.dispose();
-});
-```
-
-### React/Next.js Integration
-
-```typescript
-import { createPluginRuntime, PluginRuntime } from "every-plugin/runtime";
-import { Effect } from "effect";
-
-// Create runtime at app level
-const pluginRuntime = createPluginRuntime({
-  registry: clientSideRegistry,
-  secrets: {} // No secrets on client side
-});
-
-// In a React component or API route
-export async function executePlugin(pluginId: string, config: any, input: any) {
-  return pluginRuntime.runPromise(
-    Effect.gen(function* () {
-      const runtime = yield* PluginRuntime;
-      const plugin = yield* runtime.usePlugin(pluginId, config);
-      return yield* runtime.executePlugin(plugin, input);
-    })
-  );
-}
-
-// Cleanup in app teardown
-export function cleanup() {
-  return pluginRuntime.dispose();
-}
-```
-
-## Core Concepts
-
-### Plugin Registry
-
-The registry defines available plugins and their remote locations:
-
-```typescript
-type PluginRegistry = {
-  [pluginId: string]: {
-    version: string;
-    remoteUrl: string;
-    description?: string;
-    type?: string;
-  };
-};
-```
-
-### Secret Hydration
-
-Secrets are automatically hydrated using Mustache-style templating:
-
-```typescript
-const config = {
-  apiKey: "{{API_KEY}}", // Will be replaced with actual secret
-  endpoint: "https://api.example.com"
-};
-```
-
-### Plugin Lifecycle
-
-1. **Load**: Download and cache the remote plugin module
-2. **Instantiate**: Create a new instance of the plugin class
-3. **Initialize**: Configure the plugin with validated config and secrets
-4. **Execute**: Run the plugin with validated input, return validated output
-
-### Error Handling
-
-All operations return Effect types with proper error handling:
-
-```typescript
-const result = await runtime.runPromise(
-  Effect.gen(function* () {
-    const pluginRuntime = yield* PluginRuntime;
-    return yield* pluginRuntime.usePlugin(pluginId, config);
-  }).pipe(
-    Effect.catchAll((error) => {
-      console.error("Plugin execution failed:", error);
-      return Effect.succeed(null); // Fallback value
-    })
-  )
-);
-```
-
-## API Reference
-
-### `createPluginRuntime(config)`
-
-Creates a managed runtime for plugin execution.
-
-**Parameters:**
-
-- `config.registry`: Plugin registry mapping
-- `config.secrets`: Secret values for hydration (optional)
-- `config.logger`: Custom logger implementation (optional)
-
-**Returns:** `ManagedRuntime` instance
-
-### `PluginRuntime`
-
-Effect service tag for accessing the plugin runtime within Effect workflows.
-
-### Plugin Runtime Methods
-
-- `loadPlugin(pluginId)`: Load plugin constructor from registry
-- `instantiatePlugin(constructor)`: Create plugin instance
-- `initializePlugin(instance, config)`: Initialize with config and secrets
-- `executePlugin(plugin, input)`: Execute plugin with input
-- `usePlugin(pluginId, config)`: Load + instantiate + initialize in one step
-
-## Development
-
-```bash
-# Install dependencies
-bun install
-
-# Build the package
-bun run build
-
-# Run tests
-bun test
-```
-
-## License
-
-MIT
+# every-plugin

package/dist/errors.d.ts

@@ -1,8 +1,8 @@
 export declare class PluginExecutionError extends Error {
-	readonly retryable: boolean;
-	constructor(message: string, retryable?: boolean);
+    readonly retryable: boolean;
+    constructor(message: string, retryable?: boolean);
 }
 export declare class ConfigurationError extends PluginExecutionError {
-	constructor(message: string);
+    constructor(message: string);
 }
-//# sourceMappingURL=errors.d.ts.map
+//# sourceMappingURL=errors.d.ts.map

package/dist/index.d.ts

@@ -1,6 +1,4 @@
-export { Effect } from "effect";
-export { z } from "zod";
 export * from "./errors";
 export * from "./plugin";
-export * from "./source";
-//# sourceMappingURL=index.d.ts.map
+export * from "./runtime";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -1,5 +1,3 @@
-export { Effect } from "effect";
-export { z } from "zod";
 export * from "./errors";
 export * from "./plugin";
-export * from "./source";
+export * from "./runtime";

package/dist/plugin.d.ts

@@ -1,39 +1,13 @@
-import { Context, type Effect } from "effect";
+import { Context, Effect } from "effect";
 import { z } from "zod";
-import type { ConfigurationError, PluginExecutionError } from "./errors";
-export declare const createOutputSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
-    success: z.ZodBoolean;
-    data: z.ZodOptional<T>;
-    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        message: z.ZodString;
-        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        stack: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+import type { ConfigurationError } from "./errors";
+export declare function createConfigSchema<V extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>, S extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>>(variablesSchema?: V, secretsSchema?: S): z.ZodObject<{
+    variables: z.ZodOptional<V> | z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    secrets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>> | z.ZodOptional<S>;
 }, z.core.$strip>;
-export declare function createConfigSchema<V extends z.ZodTypeAny, S extends z.ZodTypeAny>(variablesSchema?: V, secretsSchema?: S): z.ZodObject<{
-    variables: z.ZodOptional<V>;
-    secrets: z.ZodOptional<S>;
-}>;
-export declare function createInputSchema<I extends z.ZodTypeAny>(inputSchema: I): I;
-export declare const ErrorDetailsSchema: z.ZodObject<{
-    message: z.ZodString;
-    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    stack: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type ErrorDetails = z.infer<typeof ErrorDetailsSchema>;
-export type Config<V extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>, S extends z.ZodTypeAny = z.ZodRecord<z.ZodString, z.ZodUnknown>> = z.infer<ReturnType<typeof createConfigSchema<V, S>>>;
-export type Input<I extends z.ZodTypeAny> = z.infer<ReturnType<typeof createInputSchema<I>>>;
-export type Output<T extends z.ZodTypeAny> = z.infer<ReturnType<typeof createOutputSchema<T>>>;
-export interface Plugin<TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny, TConfigSchema extends z.ZodTypeAny> {
-    readonly id: string;
-    readonly type: PluginType;
-    readonly inputSchema: TInputSchema;
-    readonly outputSchema: TOutputSchema;
-    readonly configSchema: TConfigSchema;
-    initialize(config?: z.infer<TConfigSchema>): Effect.Effect<void, ConfigurationError, PluginLoggerTag>;
-    execute(input: z.infer<TInputSchema>): Effect.Effect<z.infer<TOutputSchema>, PluginExecutionError, PluginLoggerTag>;
-    shutdown(): Effect.Effect<void, never, PluginLoggerTag>;
-}
+export declare function createStateSchema<T extends z.ZodTypeAny>(pluginStateSchema: T): z.ZodIntersection<z.ZodObject<{
+    nextPollMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>, T>;
 export type PluginType = "transformer" | "distributor" | "source";
 export interface PluginMetadata {
     remoteUrl: string;
@@ -53,5 +27,71 @@ export interface PluginLogger {
 declare const PluginLoggerTag_base: Context.TagClass<PluginLoggerTag, "PluginLogger", PluginLogger>;
 export declare class PluginLoggerTag extends PluginLoggerTag_base {
 }
+/**
+ * Schema creators for contract-based plugins
+ */
+export declare function createPluginInputSchema<TContract, TStateSchema extends z.ZodTypeAny>(contract: TContract, stateSchema: TStateSchema): z.ZodDiscriminatedUnion<[z.ZodObject<any, z.core.$strip>, ...z.ZodObject<any, z.core.$strip>[]], "procedure">;
+export declare function createPluginOutputSchema<TContract, TStateSchema extends z.ZodTypeAny>(contract: TContract, stateSchema: TStateSchema): z.ZodUnion<[z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]]>;
+/**
+ * Unified Plugin interface for all plugin types
+ */
+export interface Plugin<TContract = Record<string, any>, TConfigSchema extends z.ZodTypeAny = z.ZodTypeAny, TStateSchema extends z.ZodTypeAny = z.ZodNull> {
+    readonly id: string;
+    readonly type: PluginType;
+    readonly contract: TContract;
+    readonly configSchema: TConfigSchema;
+    readonly stateSchema: TStateSchema;
+    readonly inputSchema: ReturnType<typeof createPluginInputSchema<TContract, TStateSchema>>;
+    readonly outputSchema: ReturnType<typeof createPluginOutputSchema<TContract, TStateSchema>>;
+    initialize(config?: z.infer<TConfigSchema>): Effect.Effect<void, ConfigurationError, PluginLoggerTag>;
+    shutdown(): Effect.Effect<void, never, PluginLoggerTag>;
+    createRouter(): any;
+    isStreamable(procedureName: string): boolean;
+}
+/**
+ * State transition utilities for plugins
+ * These provide a functional approach to state updates while keeping the API simple
+ */
+export declare const StateTransitions: {
+    /**
+     * Transition to a new phase with optional updates
+     */
+    to: <T extends {
+        phase?: string;
+    }>(phase: string, updates?: Partial<T>) => (state: T) => T;
+    /**
+     * Add polling delay to state
+     */
+    withPolling: <T>(delayMs: number) => (state: T) => T;
+    /**
+     * Set error state with message and stop polling
+     */
+    withError: <T>(errorMessage: string) => (state: T) => T;
+    /**
+     * Preserve existing state with updates
+     */
+    update: <T>(updates: Partial<T>) => (state: T) => T;
+};
+/**
+ * Simple pipe utility for composing state transformations
+ */
+export declare const pipe: <T>(value: T, ...fns: Array<(val: T) => T>) => T;
+/**
+ * Simple plugin base class that uses pure oRPC patterns
+ * Plugin just needs to define contract, config, and create oRPC router
+ */
+export declare abstract class SimplePlugin<TContract, TConfigSchema extends z.ZodTypeAny, TStateSchema extends z.ZodTypeAny = z.ZodNull> implements Plugin<TContract, TConfigSchema, TStateSchema> {
+    abstract readonly id: string;
+    abstract readonly type: PluginType;
+    abstract readonly contract: TContract;
+    abstract readonly configSchema: TConfigSchema;
+    readonly stateSchema: TStateSchema;
+    get inputSchema(): z.ZodDiscriminatedUnion<[z.ZodObject<any, z.core.$strip>, ...z.ZodObject<any, z.core.$strip>[]], "procedure">;
+    get outputSchema(): z.ZodUnion<[z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]]>;
+    initialize(config?: z.infer<TConfigSchema>): Effect.Effect<void, ConfigurationError, PluginLoggerTag>;
+    abstract createRouter(): any;
+    shutdown(): Effect.Effect<void, never, PluginLoggerTag>;
+    isStreamable(procedureName: string): boolean;
+}
 export {};
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -1,25 +1,108 @@
-import { Context } from "effect";
+import { Context, Effect } from "effect";
 import { z } from "zod";
-// Helpers
-export const createOutputSchema = (dataSchema) => z.object({
-    success: z.boolean(),
-    data: dataSchema.optional(),
-    errors: z.array(ErrorDetailsSchema).optional(),
-});
 export function createConfigSchema(variablesSchema, secretsSchema) {
     return z.object({
-        variables: (variablesSchema ?? z.record(z.string(), z.unknown())).optional(),
-        secrets: (secretsSchema ?? z.record(z.string(), z.unknown())).optional(),
+        variables: variablesSchema ? variablesSchema.optional() : z.record(z.string(), z.unknown()).optional(),
+        secrets: secretsSchema ? secretsSchema.optional() : z.record(z.string(), z.unknown()).optional(),
     });
 }
-export function createInputSchema(inputSchema) {
-    return inputSchema;
+export function createStateSchema(pluginStateSchema) {
+    const BaseStreamingStateSchema = z.object({
+        nextPollMs: z.number().nullable().optional(), // null = terminate, undefined/0 = no delay, number = delay ms
+    });
+    return BaseStreamingStateSchema.and(pluginStateSchema);
 }
-// Core schemas
-export const ErrorDetailsSchema = z.object({
-    message: z.string(),
-    details: z.record(z.string(), z.unknown()).optional(),
-    stack: z.string().optional(),
-});
 export class PluginLoggerTag extends Context.Tag("PluginLogger")() {
 }
+/**
+ * Schema creators for contract-based plugins
+ */
+export function createPluginInputSchema(contract, stateSchema) {
+    const contractEntries = Object.entries(contract);
+    const procedureSchemas = contractEntries.map(([procedureName, procedureSpec]) => {
+        // Extract input and output schemas from oRPC contract procedure
+        const inputSchema = procedureSpec['~orpc']?.inputSchema || z.object({});
+        const outputSchema = procedureSpec['~orpc']?.outputSchema || z.object({});
+        // Check if this procedure is streamable (has nextState in output)
+        const isStreamable = outputSchema._def?.shape?.nextState !== undefined;
+        const baseSchema = z.object({
+            procedure: z.literal(procedureName),
+            input: inputSchema,
+        });
+        // Only add state field for streamable procedures
+        return isStreamable
+            ? baseSchema.extend({ state: stateSchema })
+            : baseSchema;
+    });
+    return z.discriminatedUnion("procedure", procedureSchemas);
+}
+export function createPluginOutputSchema(contract, stateSchema) {
+    const contractEntries = Object.entries(contract);
+    const procedureOutputSchemas = contractEntries.map(([_, procedureSpec]) => {
+        // Extract output schema from oRPC contract procedure
+        return procedureSpec['~orpc']?.outputSchema || z.object({});
+    });
+    // Return union of all procedure output schemas
+    return z.union(procedureOutputSchemas);
+}
+/**
+ * State transition utilities for plugins
+ * These provide a functional approach to state updates while keeping the API simple
+ */
+export const StateTransitions = {
+    /**
+     * Transition to a new phase with optional updates
+     */
+    to: (phase, updates = {}) => (state) => ({ ...state, phase, ...updates }),
+    /**
+     * Add polling delay to state
+     */
+    withPolling: (delayMs) => (state) => ({ ...state, nextPollMs: delayMs }),
+    /**
+     * Set error state with message and stop polling
+     */
+    withError: (errorMessage) => (state) => ({
+        ...state,
+        phase: 'error',
+        errorMessage,
+        nextPollMs: null
+    }),
+    /**
+     * Preserve existing state with updates
+     */
+    update: (updates) => (state) => ({ ...state, ...updates }),
+};
+/**
+ * Simple pipe utility for composing state transformations
+ */
+export const pipe = (value, ...fns) => fns.reduce((acc, fn) => fn(acc), value);
+/**
+ * Simple plugin base class that uses pure oRPC patterns
+ * Plugin just needs to define contract, config, and create oRPC router
+ */
+export class SimplePlugin {
+    stateSchema = z.null();
+    // Auto-generated schemas
+    get inputSchema() {
+        return createPluginInputSchema(this.contract, this.stateSchema);
+    }
+    get outputSchema() {
+        return createPluginOutputSchema(this.contract, this.stateSchema);
+    }
+    // Default implementations - runtime handles validation
+    initialize(config) {
+        return Effect.void;
+    }
+    shutdown() {
+        return Effect.void;
+    }
+    // Default streamable detection
+    isStreamable(procedureName) {
+        const contractEntries = Object.entries(this.contract);
+        const procedure = contractEntries.find(([name]) => name === procedureName);
+        if (!procedure)
+            return false;
+        const outputSchema = procedure[1]['~orpc']?.outputSchema;
+        return outputSchema?._def?.shape?.nextState !== undefined;
+    }
+}

package/dist/runtime/errors.d.ts

@@ -1,41 +1,45 @@
 import type { z } from "zod";
-declare const PluginRuntimeError_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: "PluginRuntimeError";
+declare const PluginRuntimeError_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: "PluginRuntimeError";
 } & Readonly<A>;
 export declare class PluginRuntimeError extends PluginRuntimeError_base<{
-	readonly pluginId?: string;
-	readonly operation: string;
-	readonly cause?: Error;
-	readonly retryable: boolean;
-}> {}
-declare const ModuleFederationError_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: "ModuleFederationError";
+    readonly pluginId?: string;
+    readonly operation: string;
+    readonly cause?: Error;
+    readonly retryable: boolean;
+}> {
+}
+declare const ModuleFederationError_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: "ModuleFederationError";
 } & Readonly<A>;
 export declare class ModuleFederationError extends ModuleFederationError_base<{
-	readonly pluginId: string;
-	readonly remoteUrl: string;
-	readonly cause?: Error;
-}> {}
-declare const ValidationError_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: "ValidationError";
+    readonly pluginId: string;
+    readonly remoteUrl: string;
+    readonly cause?: Error;
+}> {
+}
+declare const ValidationError_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: "ValidationError";
 } & Readonly<A>;
 export declare class ValidationError extends ValidationError_base<{
-	readonly pluginId: string;
-	readonly stage: "config" | "input" | "output";
-	readonly zodError: z.ZodError;
-}> {}
-//# sourceMappingURL=errors.d.ts.map
+    readonly pluginId: string;
+    readonly stage: "config" | "input" | "output" | "state";
+    readonly zodError: z.ZodError;
+}> {
+}
+declare const StreamError_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: "StreamError";
+} & Readonly<A>;
+export declare class StreamError extends StreamError_base<{
+    readonly pluginId: string;
+    readonly operation: "callback" | "state-extraction" | "item-extraction" | "stream-termination";
+    readonly cause?: Error;
+    readonly context?: {
+        readonly iteration?: number;
+        readonly itemsProcessed?: number;
+        readonly procedureName?: string;
+    };
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAE7B,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;CAAI;;;;AAEN,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC;CAAI;;;;AAEN,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;CAC/B,CAAC;CAAI"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAE7B,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B,CAAC;CAAG;;;;AAEL,qBAAa,qBAAsB,SAAQ,2BAEzC;IACD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACvB,CAAC;CAAG;;;;AAEL,qBAAa,eAAgB,SAAQ,qBAAoC;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;CAC9B,CAAC;CAAG;;;;AAEL,qBAAa,WAAY,SAAQ,iBAAgC;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACF,CAAC;CAAG"}

package/dist/runtime/errors.js

@@ -5,3 +5,5 @@ export class ModuleFederationError extends Data.TaggedError("ModuleFederationErr
 }
 export class ValidationError extends Data.TaggedError("ValidationError") {
 }
+export class StreamError extends Data.TaggedError("StreamError") {
+}