every-plugin 0.1.2 → 0.1.4

package/dist/types.d.ts

@@ -0,0 +1,177 @@
+import type { AnyContractRouter } from "@orpc/contract";
+import type { Context, Router } from "@orpc/server";
+import { Scope } from "effect";
+import type { z } from "zod";
+import type { Plugin, PluginConfigFor, PluginConstructorWithBinding } from "./plugin";
+export type AnyContract = Router<AnyContractRouter, any>;
+/**
+ * Base type for any plugin instance.
+ * This is the foundation that enables type inference across the entire plugin system.
+ * Uses 'any' for context to allow plugins with custom context types.
+ */
+export type AnyPlugin = Plugin<AnyContractRouter, z.ZodTypeAny, z.ZodTypeAny, any>;
+/**
+ * Registry bindings define the compile-time shape of available plugins.
+ * This is a type-only construct that enables full IDE autocomplete and type safety
+ * without requiring runtime plugin imports.
+ */
+export type RegistryBindings = Record<string, {
+    contract: AnyContractRouter;
+    config: PluginConfigFor<z.ZodTypeAny, z.ZodTypeAny>;
+}>;
+/**
+ * Extracts the Plugin type from a binding definition.
+ * This enables type inference: Binding → Plugin → Router → Client
+ */
+export type PluginOf<B> = B extends {
+    contract: infer C;
+    config: infer Conf;
+} ? Conf extends PluginConfigFor<infer V, infer S> ? C extends AnyContractRouter ? Plugin<C, V, S> : never : never : never;
+/**
+ * Extracts the config type from a binding definition.
+ * This provides strongly-typed configuration based on the plugin's zod schema.
+ */
+export type ConfigOf<B> = z.infer<PluginOf<B>["configSchema"]>;
+/**
+ * Extracts the router type from a plugin.
+ * This enables type inference from Plugin → Router → RouterClient with full procedure autocomplete.
+ */
+export type RouterOf<T extends AnyPlugin> = ReturnType<T["createRouter"]>;
+/**
+ * Extracts the context type from a plugin.
+ * This is used for typing the router client context parameter.
+ */
+export type ContextOf<T extends AnyPlugin> = T extends Plugin<AnyContractRouter, z.ZodTypeAny, z.ZodTypeAny, infer TContext> ? TContext : never;
+/**
+ * Infers binding definitions from plugin constructor objects.
+ * Used to derive RegistryBindings from a collection of plugin constructors.
+ */
+export type InferBindingsFromPlugins<T> = {
+    [K in keyof T]: T[K] extends PluginConstructorWithBinding<infer C, infer V, infer S, infer Ctx> ? {
+        contract: C;
+        config: PluginConfigFor<V, S>;
+    } : never;
+};
+/**
+ * Converts registry bindings to plugin constructor types.
+ * This is used internally by the runtime to maintain type safety.
+ */
+export type PluginBindingsFor<R extends RegistryBindings> = {
+    [K in keyof R]: R[K] extends {
+        contract: infer C;
+        config: infer Conf;
+    } ? Conf extends PluginConfigFor<infer V, infer S> ? C extends AnyContractRouter ? PluginConstructorWithBinding<C, V, S, Context> : never : never : never;
+};
+/**
+ * Runtime registry configuration.
+ * Maps plugin IDs to their remote URLs and metadata.
+ */
+export type PluginRegistry = Record<string, {
+    remoteUrl: string;
+    type: string;
+    version?: string;
+    description?: string;
+}>;
+/**
+ * Type-safe registry that enforces key alignment with bindings.
+ * When used with RegistryBindings, ensures plugin IDs match between registry and type definitions.
+ */
+export type PluginRegistryFor<R extends RegistryBindings> = {
+    [K in keyof R]: {
+        remoteUrl: string;
+        type: string;
+        version?: string;
+        description?: string;
+    };
+};
+/**
+ * Configuration for secrets injection.
+ * Secrets are hydrated into plugin configs using template replacement.
+ */
+export interface SecretsConfig {
+    [key: string]: string;
+}
+/**
+ * Plugin constructor with metadata.
+ * Represents a loaded plugin class ready for instantiation.
+ */
+export interface PluginConstructor<T extends AnyPlugin = AnyPlugin> {
+    readonly ctor: new () => T;
+    readonly metadata: {
+        readonly pluginId: string;
+        readonly version?: string;
+        readonly description?: string;
+        readonly type?: string;
+    };
+}
+/**
+ * Instantiated plugin with metadata.
+ * Represents a plugin instance ready for initialization.
+ */
+export interface PluginInstance<T extends AnyPlugin = AnyPlugin> {
+    readonly plugin: T;
+    readonly metadata: {
+        readonly pluginId: string;
+        readonly version?: string;
+        readonly description?: string;
+        readonly type?: string;
+    };
+}
+/**
+ * Fully initialized plugin ready for use.
+ * Contains the plugin instance, validated config, execution context, and scope.
+ * This is what gets passed to createPluginClient for type-safe procedure calls.
+ */
+export interface InitializedPlugin<T extends AnyPlugin = AnyPlugin> {
+    readonly plugin: T;
+    readonly metadata: {
+        readonly pluginId: string;
+        readonly version?: string;
+        readonly description?: string;
+        readonly type?: string;
+    };
+    readonly config: z.infer<T["configSchema"]>;
+    readonly context: ContextOf<T>;
+    readonly scope: Scope.CloseableScope;
+}
+/**
+ * Runtime options for plugin execution and resource management.
+ */
+export interface RuntimeOptions {
+    /** Resource isolation level for plugins */
+    isolation?: "strict" | "shared" | "none";
+    /** Memory limit per plugin instance */
+    memoryLimit?: string;
+    /** Maximum concurrent plugin operations */
+    concurrency?: number;
+    /** Resource timeout for plugin operations */
+    resourceTimeout?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Enable metrics collection */
+    metrics?: boolean;
+}
+/**
+ * Enhanced plugin result containing client, router, and metadata.
+ */
+export interface PluginResult<T extends AnyPlugin = AnyPlugin> {
+    readonly client: import("@orpc/server").RouterClient<RouterOf<T>, Record<never, never>>;
+    readonly router: RouterOf<T>;
+    readonly metadata: {
+        readonly pluginId: string;
+        readonly version?: string;
+        readonly description?: string;
+        readonly type?: string;
+    };
+    readonly initialized: InitializedPlugin<T>;
+}
+/**
+ * Runtime configuration for the plugin system.
+ * The generic R parameter enables compile-time type safety when provided.
+ */
+export interface PluginRuntimeConfig<R extends RegistryBindings = RegistryBindings> {
+    registry: PluginRegistry;
+    secrets?: SecretsConfig;
+    options?: RuntimeOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/zod.d.ts

@@ -0,0 +1,2 @@
+export * from "zod";
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

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

package/dist/zod.js

@@ -0,0 +1 @@
+export * from "zod";

package/package.json

@@ -1,59 +1,101 @@
 {
-	"name": "every-plugin",
-	"version": "0.1.2",
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"default": "./dist/index.js"
-		},
-		"./runtime": {
-			"types": "./dist/runtime/index.d.ts",
-			"default": "./dist/runtime/index.js"
-		},
-		"./testing": {
-			"types": "./dist/testing/index.d.ts",
-			"default": "./dist/testing/index.js"
-		}
-	},
-	"files": [
-		"dist"
-	],
-	"scripts": {
-		"build": "tsc -b",
-		"test": "vitest run --config vitest.unit.config.ts",
-		"test:unit": "vitest run --config vitest.unit.config.ts",
-		"test:integration": "npm run test:build-plugin && vitest run --config vitest.integration.config.ts",
-		"test:all": "npm run test:unit && npm run test:integration",
-		"test:watch": "vitest --config vitest.unit.config.ts --watch",
-		"test:watch:integration": "vitest --config vitest.integration.config.ts --watch",
-		"test:ui": "vitest --ui",
-		"test:build-plugin": "cd __tests__/test-plugin && NODE_ENV=test npm run build"
-	},
-	"peerDependencies": {
-		"typescript": "^5.0.0"
-	},
-	"devDependencies": {
-		"@effect/language-service": "^0.38.1",
-		"@effect/vitest": "^0.25.1",
-		"@rspack/cli": "^1.5.2",
-		"@rspack/core": "^1.5.2",
-		"@types/bun": "^1.2.21",
-		"@types/node": "^24.3.1",
-		"@vitest/ui": "3.2.4",
-		"bun-types": "^1.2.21",
-		"sirv": "^3.0.2",
-		"vitest": "^3.2.4"
-	},
-	"dependencies": {
-		"@better-fetch/fetch": "^1.1.18",
-		"@module-federation/enhanced": "^0.18.3",
-		"@module-federation/node": "^2.7.15",
-		"@module-federation/runtime-core": "^0.18.3",
-		"@orpc/contract": "^1.8.6",
-		"@orpc/server": "^1.8.6",
-		"effect": "^3.17.13",
-		"zod": "^4.1.5"
-	}
+  "name": "every-plugin",
+  "version": "0.1.4",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "default": "./dist/runtime/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./normalize": {
+      "types": "./dist/runtime/services/normalize.d.ts",
+      "require": "./dist/runtime/services/normalize.js",
+      "default": "./dist/runtime/services/normalize.js"
+    },
+    "./effect": {
+      "types": "./dist/effect.d.ts",
+      "default": "./dist/effect.js"
+    },
+    "./zod": {
+      "types": "./dist/zod.d.ts",
+      "default": "./dist/zod.js"
+    },
+    "./orpc": {
+      "types": "./dist/orpc.d.ts",
+      "default": "./dist/orpc.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run --config vitest.unit.config.ts",
+    "test:unit": "vitest run --config vitest.unit.config.ts",
+    "test:integration": "npm run test:build-plugin && vitest run --config vitest.integration.config.ts",
+    "test:all": "npm run test:unit && npm run test:integration",
+    "test:watch": "vitest --config vitest.unit.config.ts --watch",
+    "test:watch:integration": "vitest --config vitest.integration.config.ts --watch",
+    "test:ui": "vitest --ui",
+    "test:build-plugin": "cd __tests__/test-plugin && NODE_ENV=test npm run build"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "devDependencies": {
+    "@effect/language-service": "^0.38.1",
+    "@effect/vitest": "^0.25.1",
+    "@rspack/cli": "^1.5.2",
+    "@rspack/core": "^1.5.2",
+    "@types/bun": "^1.2.21",
+    "@types/node": "^24.3.1",
+    "@vitest/ui": "3.2.4",
+    "bun-types": "^1.2.21",
+    "sirv": "^3.0.2",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@better-fetch/fetch": "^1.1.18",
+    "@module-federation/enhanced": "^0.19.1",
+    "@module-federation/node": "^2.7.15",
+    "@module-federation/runtime-core": "^0.19.1",
+    "@orpc/contract": "1.8.6",
+    "@orpc/server": "1.8.6",
+    "effect": "3.17.13",
+    "zod": "4.1.5"
+  },
+  "keywords": [
+    "plugin",
+    "module-federation",
+    "orpc",
+    "zod",
+    "typescript"
+  ],
+  "author": "plugin.every.near",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/near-everything/every-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/near-everything/every-plugin/issues"
+  },
+  "homepage": "https://plugin.everything.dev",
+  "workspaces": [
+    "./__tests__/test-plugin/*"
+  ]
 }

package/dist/runtime/streaming/index.d.ts

@@ -1,4 +0,0 @@
-export { pipe, StateTransitions } from './state-effects';
-export { createSourceStream } from './streaming';
-export type { StreamingOptions, StreamState } from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/streaming/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/runtime/streaming/index.js

@@ -1,2 +0,0 @@
-export { pipe, StateTransitions } from './state-effects';
-export { createSourceStream } from './streaming';

package/dist/runtime/streaming/state-effects.d.ts

@@ -1,28 +0,0 @@
-/**
- * State transition helpers for common patterns
- */
-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;
-//# sourceMappingURL=state-effects.d.ts.map

package/dist/runtime/streaming/state-effects.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-effects.d.ts","sourceRoot":"","sources":["../../../src/runtime/streaming/state-effects.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;SACE,CAAC,SAAS;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,SAAS,MAAM,YAAW,OAAO,CAAC,CAAC,CAAC,MAClE,OAAO,CAAC,KAAG,CAAC;IAEf;;OAEG;kBACW,CAAC,WAAW,MAAM,MAC7B,OAAO,CAAC,KAAG,CAAC;IAEf;;OAEG;gBACS,CAAC,gBAAgB,MAAM,MAChC,OAAO,CAAC,KAAG,CAAC;IAOf;;OAEG;aACM,CAAC,WAAW,OAAO,CAAC,CAAC,CAAC,MAC5B,OAAO,CAAC,KAAG,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAG,CACxB,CAAC"}

package/dist/runtime/streaming/state-effects.js

@@ -1,30 +0,0 @@
-/**
- * State transition helpers for common patterns
- */
-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);

package/dist/runtime/streaming/streaming.d.ts

@@ -1,8 +0,0 @@
-import { Effect, Stream } from "effect";
-import type { z } from "zod";
-import type { Contract, Plugin } from "../../plugin";
-import { type PluginRuntimeError } from "../errors";
-import type { InitializedPlugin } from "../types";
-import type { StreamingOptions } from "./types";
-export declare const createSourceStream: <T extends Plugin<Contract>, TInput extends z.infer<T["inputSchema"]>, TItem, TPluginState extends z.infer<T["stateSchema"]>>(initializedPlugin: InitializedPlugin<T>, executePlugin: (plugin: InitializedPlugin<T>, input: TInput) => Effect.Effect<z.infer<T["outputSchema"]>, PluginRuntimeError>, input: TInput, options?: StreamingOptions<TItem, TPluginState>) => Stream.Stream<TItem, PluginRuntimeError>;
-//# sourceMappingURL=streaming.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../src/runtime/streaming/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,KAAK,kBAAkB,EAAwB,MAAM,WAAW,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAsB7D,eAAO,MAAM,kBAAkB,GAC7B,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,EAC1B,MAAM,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EACxC,KAAK,EACL,YAAY,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAE9C,mBAAmB,iBAAiB,CAAC,CAAC,CAAC,EACvC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,kBAAkB,CAAC,EAC7H,OAAO,MAAM,EACb,UAAS,gBAAgB,CAAC,KAAK,EAAE,YAAY,CAAM,KAClD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAuHzC,CAAC"}

package/dist/runtime/streaming/streaming.js

@@ -1,113 +0,0 @@
-import { Duration, Effect, Stream } from "effect";
-import { toPluginRuntimeError } from "../errors";
-/**
- * Extract delay from plugin state (nextPollMs field)
- * Returns null if nextPollMs is null (signals termination) or undefined (no delay specified)
- */
-const extractDelayFromState = (state) => {
-    const stateWithPolling = state;
-    if (stateWithPolling?.nextPollMs === null) {
-        return null; // Explicit termination signal
-    }
-    return stateWithPolling?.nextPollMs ? Duration.millis(stateWithPolling.nextPollMs) : null;
-};
-/**
- * Check if plugin state signals stream termination
- */
-const isTerminalState = (state) => {
-    const stateWithPolling = state;
-    return stateWithPolling?.nextPollMs === null;
-};
-export const createSourceStream = (initializedPlugin, executePlugin, input, options = {}) => {
-    // Create initial stream state with plugin's initial state
-    const initialStreamState = {
-        invocations: 0,
-        pluginState: input.state,
-        lastItemCount: 0,
-    };
-    // Use Stream.async for full control over emission timing and delays
-    return Stream.async((emit) => {
-        let currentStreamState = initialStreamState;
-        let totalItemsEmitted = 0;
-        const loop = async () => {
-            try {
-                while (true) {
-                    console.log(`[STREAMING] Starting iteration ${currentStreamState.invocations + 1}`);
-                    // Check invocation limit BEFORE executing
-                    if (options.maxInvocations && currentStreamState.invocations >= options.maxInvocations) {
-                        console.log(`[STREAMING] Reached maxInvocations limit: ${options.maxInvocations}`);
-                        break;
-                    }
-                    // Check maxItems limit BEFORE executing
-                    if (options.maxItems && totalItemsEmitted >= options.maxItems) {
-                        console.log(`[STREAMING] Reached maxItems limit: ${options.maxItems}`);
-                        break;
-                    }
-                    // Execute plugin with current plugin state
-                    const pluginInput = {
-                        ...input,
-                        state: currentStreamState.pluginState ?? null
-                    };
-                    console.log(`[STREAMING] About to execute plugin with input:`, JSON.stringify(pluginInput, null, 2));
-                    console.log(`[STREAMING] Plugin state:`, JSON.stringify(currentStreamState.pluginState, null, 2));
-                    const rawResult = await Effect.runPromise(executePlugin(initializedPlugin, pluginInput).pipe(Effect.catchAll((error) => {
-                        return toPluginRuntimeError(error);
-                    })));
-                    console.log(`[STREAMING] Plugin execution completed`);
-                    // Transform raw plugin result to streaming format
-                    const resultObj = rawResult;
-                    const items = Array.isArray(resultObj.items) ? resultObj.items : [];
-                    const nextPluginState = resultObj.nextState;
-                    console.log(`[STREAMING] Transformed result: ${items.length} items`);
-                    // Update stream state (increment AFTER execution)
-                    currentStreamState = {
-                        invocations: currentStreamState.invocations + 1,
-                        pluginState: nextPluginState,
-                        lastItemCount: items.length,
-                    };
-                    console.log(`[STREAMING] Invocation ${currentStreamState.invocations}, Items: ${items.length}`);
-                    // Call state change hook if provided
-                    if (options.onStateChange) {
-                        await Effect.runPromise(options.onStateChange(nextPluginState, items).pipe(Effect.catchAll((error) => {
-                            console.warn(`[STREAMING] onStateChange failed:`, error);
-                            return Effect.void;
-                        })));
-                    }
-                    // Emit items immediately (before any delays)
-                    for (const item of items) {
-                        if (options.maxItems && totalItemsEmitted >= options.maxItems) {
-                            console.log(`[STREAMING] Stopping emission at maxItems limit: ${options.maxItems}`);
-                            break;
-                        }
-                        emit.single(item);
-                        totalItemsEmitted++;
-                    }
-                    // Check for termination conditions
-                    if (nextPluginState && isTerminalState(nextPluginState)) {
-                        console.log(`[STREAMING] Plugin signaled termination`);
-                        break;
-                    }
-                    // Check stopWhenEmpty condition
-                    if (options.stopWhenEmpty && items.length === 0) {
-                        console.log(`[STREAMING] Stopping due to empty result and stopWhenEmpty=true`);
-                        break;
-                    }
-                    // Handle delay AFTER emission, BEFORE next iteration
-                    const nextDelay = extractDelayFromState(nextPluginState);
-                    if (nextDelay && Duration.toMillis(nextDelay) > 0) {
-                        console.log(`[STREAMING] Sleeping for ${Duration.toMillis(nextDelay)}ms before next iteration`);
-                        await Effect.runPromise(Effect.sleep(nextDelay));
-                    }
-                }
-                // End the stream
-                emit.end();
-            }
-            catch (error) {
-                console.log(`[STREAMING] Error occurred:`, error);
-                emit.fail(error);
-            }
-        };
-        // Start the loop
-        loop();
-    });
-};

package/dist/runtime/streaming/types.d.ts

@@ -1,19 +0,0 @@
-import type { Effect } from "effect";
-/**
- * Internal stream state managed by the runtime
- */
-export interface StreamState<TPluginState> {
-    readonly invocations: number;
-    readonly pluginState: TPluginState;
-    readonly lastItemCount: number;
-}
-/**
- * Enhanced streaming options with Effect-based hooks
- */
-export interface StreamingOptions<TItem = unknown, TPluginState = unknown> {
-    maxItems?: number;
-    maxInvocations?: number;
-    stopWhenEmpty?: boolean;
-    onStateChange?: (newPluginState: TPluginState, items: TItem[]) => Effect.Effect<void, Error>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/runtime/streaming/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/streaming/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,YAAY;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,YAAY,GAAG,OAAO;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,aAAa,CAAC,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAC9F"}

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

@@ -1,3 +0,0 @@
-import type { PluginLogger } from "../plugin";
-export declare const createTestLogger: () => PluginLogger;
-//# sourceMappingURL=test-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/runtime/test-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,eAAO,MAAM,gBAAgB,QAAO,YAYlC,CAAC"}

package/dist/runtime/test-utils.js

@@ -1,7 +0,0 @@
-import { Effect } from "effect";
-export const createTestLogger = () => ({
-    logInfo: (message, context) => Effect.sync(() => console.log(`[INFO] ${message}`, context || '')),
-    logWarning: (message, context) => Effect.sync(() => console.warn(`[WARNING] ${message}`, context || '')),
-    logError: (message, error, context) => Effect.sync(() => console.error(`[ERROR] ${message}`, error, context || '')),
-    logDebug: (message, context) => Effect.sync(() => console.log(`[DEBUG] ${message}`, context || '')),
-});

package/dist/runtime/types.d.ts

@@ -1,40 +0,0 @@
-import type { z } from "zod";
-import type { Plugin, PluginLogger, PluginRegistry } from "../plugin";
-export interface PluginRuntimeConfig {
-    registry: PluginRegistry;
-    secrets?: SecretsConfig;
-    logger?: PluginLogger;
-}
-export interface SecretsConfig {
-    [key: string]: string;
-}
-export type AnyPlugin = Plugin<any, z.ZodTypeAny, z.ZodTypeAny>;
-export interface PluginConstructor {
-    readonly ctor: new () => AnyPlugin;
-    readonly metadata: {
-        readonly pluginId: string;
-        readonly version?: string;
-        readonly description?: string;
-        readonly type?: string;
-    };
-}
-export interface PluginInstance<T extends AnyPlugin = AnyPlugin> {
-    readonly plugin: T;
-    readonly metadata: {
-        readonly pluginId: string;
-        readonly version?: string;
-        readonly description?: string;
-        readonly type?: string;
-    };
-}
-export interface InitializedPlugin<T extends AnyPlugin = AnyPlugin> {
-    readonly plugin: T;
-    readonly metadata: {
-        readonly pluginId: string;
-        readonly version?: string;
-        readonly description?: string;
-        readonly type?: string;
-    };
-    readonly config: z.infer<T["configSchema"]>;
-}
-//# sourceMappingURL=types.d.ts.map