@danielfgray/pg-sourcerer 0.3.0 → 0.4.0

package/dist/services/plugin.d.ts

@@ -1,421 +0,0 @@
-/**
- * Plugin System
- *
- * A generic request/plugin coordination system. Core routes requests to plugins
- * without understanding what resources represent (schemas, queries, routes, etc.).
- *
- * Key concepts:
- * - Plugin: Handles requests for a resource kind
- * - Request: A need for a resource with specific params
- * - DeferredResource: A placeholder resolved after plugin execution
- *
- * Execution phases:
- * 1. Registration - Plugins registered, singletons identified
- * 2. Collection - Requests collected via ctx.request()
- * 3. Resolution - Match requests to plugins, build DAG
- * 4. Execution - Run plugins in topological order
- * 5. Finalization - Emit files, resolve imports
- */
-import { Context, Layer, Schema as S } from "effect";
-import type { FileBuilder } from "./file-builder.js";
-import type { SymbolRegistry } from "./symbols.js";
-import type { SemanticIR } from "../ir/semantic-ir.js";
-import type { TypeHintRegistry } from "./type-hints.js";
-import type { CoreInflection } from "./inflection.js";
-/**
- * A request for a resource of a specific kind with arbitrary params.
- *
- * Core does not interpret the params - they are opaque data passed to providers.
- */
-export interface ResourceRequest {
-    /** The resource kind (e.g., "validation-schema", "query-functions") */
-    readonly kind: string;
-    /** Opaque params interpreted by the provider */
-    readonly params: unknown;
-}
-/**
- * A service handler function that processes requests for a specific kind.
- *
- * Registered by plugins via ctx.registerHandler() and invoked by ctx.request().
- * This enables on-demand generation where a later plugin can request resources
- * from an earlier plugin's handler.
- *
- * @typeParam TParams - The request params shape
- * @typeParam TResult - The result shape
- */
-export type ServiceHandler<TParams = unknown, TResult = unknown> = (params: TParams, ctx: PluginContext) => TResult;
-/**
- * A deferred resource reference.
- *
- * Created when a provider calls ctx.request(). The result is populated
- * after the resolution and execution phases complete.
- */
-export interface DeferredResource<T = unknown> {
-    /** The resource kind this request is for */
-    readonly kind: string;
-    /** The params used for this request */
-    readonly params: unknown;
-    /**
-     * The resolved result. Accessing before resolution throws.
-     * After resolution, contains the provider's return value.
-     */
-    readonly result: T;
-}
-/**
- * Context provided to plugins during the provide() call.
- *
- * Allows plugins to:
- * - Access the semantic IR
- * - Access type hints and inflection
- * - Register service handlers for on-demand requests
- * - Make requests to other plugins' handlers
- * - Emit files
- * - Register symbols
- */
-export interface PluginContext {
-    /**
-     * The semantic IR containing all entities, enums, relations, etc.
-     */
-    readonly ir: SemanticIR;
-    /**
-     * Type hint registry for user-configured type overrides.
-     */
-    readonly typeHints: TypeHintRegistry;
-    /**
-     * Inflection service for naming transformations.
-     */
-    readonly inflection: CoreInflection;
-    /**
-     * Register a service handler for a resource kind.
-     *
-     * Other plugins can then call ctx.request(kind, params) to invoke this handler.
-     * This enables on-demand generation patterns where consumers drive what gets generated.
-     *
-     * @example
-     * ```typescript
-     * // In zod plugin:
-     * ctx.registerHandler("schemas", (params, ctx) => {
-     *   if (params.variant === "params") {
-     *     return generateParamSchema(params.entity, params.method)
-     *   }
-     *   return generateEntitySchema(params.entity, params.shape)
-     * })
-     *
-     * // In http-elysia plugin:
-     * const schema = ctx.request("schemas", { entity: "User", method: "findById", variant: "params" })
-     * ```
-     *
-     * @param kind - Resource kind this handler provides
-     * @param handler - Function to handle requests
-     */
-    readonly registerHandler: <TParams = unknown, TResult = unknown>(kind: string, handler: ServiceHandler<TParams, TResult>) => void;
-    /**
-     * Request a resource from a registered handler.
-     *
-     * Invokes the handler registered for the given kind with the provided params.
-     * If no handler is registered, falls back to the result cache (for static dependencies).
-     *
-     * @param kind - Resource kind to request
-     * @param params - Opaque params for the handler
-     * @returns The result from the handler
-     * @throws If no handler is registered and no cached result exists
-     */
-    readonly request: <T = unknown>(kind: string, params: unknown) => T;
-    /**
-     * Create a FileBuilder for structured file emission.
-     *
-     * @param path - Output file path relative to outputDir
-     */
-    readonly file: (path: string) => FileBuilder;
-    /**
-     * Symbol registry for cross-file imports.
-     * Also used for method symbol registration (plugin-to-plugin coordination).
-     */
-    readonly symbols: SymbolRegistry;
-}
-/**
- * A plugin handles requests for a specific resource kind.
- *
- * Core calls canProvide() to match requests to plugins, then calls
- * provide() to generate the resource.
- *
- * @typeParam TParams - The expected params shape (opaque to core)
- * @typeParam TResult - The result shape (opaque to core)
- */
-export interface Plugin<TParams = unknown, TResult = unknown> {
-    /**
-     * Unique plugin name for identification and error messages.
-     */
-    readonly name: string;
-    /**
-     * The resource kind this plugin handles.
-     * Multiple plugins can handle the same kind - first match wins.
-     */
-    readonly kind: string;
-    /**
-     * If true, this plugin runs once automatically without explicit request.
-     * The result is shared by all dependents.
-     *
-     * Typical singletons: introspection, semantic-ir
-     */
-    readonly singleton?: boolean;
-    /**
-     * Params to use for singleton execution.
-     * Only meaningful when singleton is true.
-     */
-    readonly singletonParams?: TParams;
-    /**
-     * Check if this plugin can handle a request with the given params.
-     *
-     * Called during resolution to match requests to plugins.
-     * First plugin that returns true wins.
-     *
-     * @param params - The request params (opaque to core)
-     * @returns true if this plugin can handle the request
-     */
-    readonly canProvide: (params: TParams) => boolean;
-    /**
-     * Declare what resources this plugin needs before it can run.
-     *
-     * Used to build the dependency DAG. The results are passed to provide().
-     *
-     * @param params - The request params
-     * @returns Array of resource requests that must be resolved first
-     */
-    readonly requires?: (params: TParams) => readonly ResourceRequest[];
-    /**
-     * Declare optional dependencies that enhance this plugin if available.
-     *
-     * Unlike `requires`, missing optional dependencies don't cause errors.
-     * If a provider exists, the dependency is resolved and ordering is enforced.
-     * If no provider exists, the dependency is silently skipped.
-     *
-     * Useful for plugins that have fallback behavior when an optional dependency
-     * isn't available (e.g., http-elysia falling back to TypeBox when no schema
-     * plugin is registered).
-     *
-     * @param params - The request params
-     * @returns Array of optional resource requests
-     */
-    readonly optionalRequires?: (params: TParams) => readonly ResourceRequest[];
-    /**
-     * Generate the resource.
-     *
-     * Called during execution phase after all dependencies are resolved.
-     *
-     * @param params - The request params
-     * @param deps - Resolved results from requires() in same order
-     * @param ctx - Plugin context for sub-requests and emission
-     * @returns The resource result (shape is plugin-defined)
-     */
-    readonly provide: (params: TParams, deps: readonly unknown[], ctx: PluginContext) => TResult;
-}
-declare const PluginNotFound_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: "PluginNotFound";
-} & Readonly<A>;
-/**
- * No plugin could handle a request.
- */
-export declare class PluginNotFound extends PluginNotFound_base<{
-    readonly message: string;
-    readonly kind: string;
-    readonly params: unknown;
-    readonly requestedBy?: string;
-}> {
-}
-declare const PluginCycle_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: "PluginCycle";
-} & Readonly<A>;
-/**
- * A cycle was detected in plugin dependencies.
- */
-export declare class PluginCycle extends PluginCycle_base<{
-    readonly message: string;
-    readonly cycle: readonly string[];
-}> {
-}
-declare const PluginExecutionFailed_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: "PluginExecutionFailed";
-} & Readonly<A>;
-/**
- * A plugin failed during execution.
- */
-export declare class PluginExecutionFailed extends PluginExecutionFailed_base<{
-    readonly message: string;
-    readonly plugin: string;
-    readonly kind: string;
-    readonly params: unknown;
-    readonly cause: unknown;
-}> {
-}
-declare const ResourceNotResolved_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: "ResourceNotResolved";
-} & Readonly<A>;
-/**
- * Attempted to access a deferred resource before resolution.
- */
-export declare class ResourceNotResolved extends ResourceNotResolved_base<{
-    readonly message: string;
-    readonly kind: string;
-    readonly params: unknown;
-}> {
-}
-/**
- * Union of all plugin-related errors.
- */
-export type PluginError = PluginNotFound | PluginCycle | PluginExecutionFailed | ResourceNotResolved;
-/**
- * A pending request tracked by the registry.
- * @internal
- */
-export interface PendingRequest {
-    readonly kind: string;
-    readonly params: unknown;
-    readonly requestedBy: string;
-    readonly deferred: MutableDeferredResource;
-}
-/**
- * A mutable deferred resource used during resolution.
- * @internal
- */
-export interface MutableDeferredResource<T = unknown> {
-    readonly kind: string;
-    readonly params: unknown;
-    resolved: boolean;
-    value: T | undefined;
-}
-/**
- * Create a mutable deferred resource.
- * @internal
- */
-export declare const createDeferredResource: <T = unknown>(kind: string, params: unknown) => MutableDeferredResource<T>;
-/**
- * Create a read-only deferred resource view.
- * Throws if accessed before resolution.
- * @internal
- */
-export declare const asDeferredResource: <T>(mutable: MutableDeferredResource<T>) => DeferredResource<T>;
-/**
- * Registry for service handlers.
- *
- * Plugins register handlers during their provide() call.
- * Other plugins can then invoke these handlers via ctx.request().
- */
-export interface ServiceRegistry {
-    /**
-     * Register a handler for a resource kind.
-     * Multiple handlers can be registered for the same kind - they're tried in order.
-     *
-     * @param kind - Resource kind this handler provides
-     * @param handler - Function to handle requests
-     * @param pluginName - Name of the plugin registering (for error messages)
-     */
-    readonly register: (kind: string, handler: ServiceHandler, pluginName: string) => void;
-    /**
-     * Invoke a handler for the given kind and params.
-     *
-     * @param kind - Resource kind to request
-     * @param params - Opaque params for the handler
-     * @param ctx - Plugin context to pass to handler
-     * @returns The handler result, or undefined if no handler matched
-     */
-    readonly invoke: <T = unknown>(kind: string, params: unknown, ctx: PluginContext) => T | undefined;
-    /**
-     * Check if any handler is registered for a kind.
-     */
-    readonly hasHandler: (kind: string) => boolean;
-}
-/**
- * Create a service registry for handler registration and invocation.
- */
-export declare const createServiceRegistry: () => ServiceRegistry;
-declare const Services_base: Context.TagClass<Services, "Services", ServiceRegistry>;
-/**
- * Effect service tag for ServiceRegistry.
- */
-export declare class Services extends Services_base {
-}
-/**
- * Plugin registry service interface.
- *
- * Manages plugin registration and request collection during execution.
- */
-export interface PluginRegistry {
-    /**
-     * Register a plugin for a resource kind.
-     *
-     * @param plugin - The plugin to register
-     */
-    readonly register: (plugin: Plugin) => void;
-    /**
-     * Request a resource. Returns a deferred reference.
-     *
-     * The deferred is populated after resolution and execution phases.
-     *
-     * @param kind - Resource kind to request
-     * @param params - Opaque params for the plugin
-     * @param requestedBy - Name of the requester (for error messages)
-     * @returns A deferred resource reference
-     */
-    readonly request: <T = unknown>(kind: string, params: unknown, requestedBy: string) => DeferredResource<T>;
-    /**
-     * Get all registered plugins.
-     * @internal Used by resolution phase.
-     */
-    readonly getPlugins: () => readonly Plugin[];
-    /**
-     * Get all pending requests.
-     * @internal Used by resolution phase.
-     */
-    readonly getPendingRequests: () => readonly PendingRequest[];
-    /**
-     * Get singleton plugins.
-     * @internal Used by resolution phase to create implicit requests.
-     */
-    readonly getSingletons: () => readonly Plugin[];
-}
-declare const Plugins_base: Context.TagClass<Plugins, "Plugins", PluginRegistry>;
-/**
- * Effect service tag for PluginRegistry.
- */
-export declare class Plugins extends Plugins_base {
-}
-/**
- * Schema for ResourceRequest (for artifact serialization if needed).
- */
-export declare const ResourceRequestSchema: S.Struct<{
-    kind: typeof S.String;
-    params: typeof S.Unknown;
-}>;
-/**
- * Define a plugin with type inference.
- *
- * @example
- * ```typescript
- * const zodSchemas = definePlugin({
- *   name: "zod-schemas",
- *   kind: "validation-schema",
- *   canProvide: (p) => !p.format || p.format === "zod",
- *   requires: () => [{ kind: "semantic-ir", params: {} }],
- *   provide: (params, [ir], ctx) => {
- *     // Generate schema, return symbol ref
- *   },
- * })
- * ```
- */
-export declare function definePlugin<TParams = unknown, TResult = unknown>(plugin: Plugin<TParams, TResult>): Plugin<TParams, TResult>;
-/**
- * Create a plugin registry for collecting plugins and requests.
- *
- * Used during generation to:
- * 1. Collect plugin registrations
- * 2. Collect requests during plugin execution
- * 3. Provide data to resolution phase
- */
-export declare const createPluginRegistry: () => PluginRegistry;
-/**
- * Layer providing a fresh plugin registry.
- */
-export declare const PluginsLive: Layer.Layer<Plugins, never, never>;
-export {};
-//# sourceMappingURL=plugin.d.ts.map

package/dist/services/plugin.d.ts.map

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

package/dist/services/plugin.js

@@ -1,197 +0,0 @@
-/**
- * Plugin System
- *
- * A generic request/plugin coordination system. Core routes requests to plugins
- * without understanding what resources represent (schemas, queries, routes, etc.).
- *
- * Key concepts:
- * - Plugin: Handles requests for a resource kind
- * - Request: A need for a resource with specific params
- * - DeferredResource: A placeholder resolved after plugin execution
- *
- * Execution phases:
- * 1. Registration - Plugins registered, singletons identified
- * 2. Collection - Requests collected via ctx.request()
- * 3. Resolution - Match requests to plugins, build DAG
- * 4. Execution - Run plugins in topological order
- * 5. Finalization - Emit files, resolve imports
- */
-import { Context, Data, Layer, MutableHashMap, MutableList, Option, pipe, Schema as S } from "effect";
-// ============================================================================
-// Plugin Errors - Domain Agnostic
-// ============================================================================
-/**
- * No plugin could handle a request.
- */
-export class PluginNotFound extends Data.TaggedError("PluginNotFound") {
-}
-/**
- * A cycle was detected in plugin dependencies.
- */
-export class PluginCycle extends Data.TaggedError("PluginCycle") {
-}
-/**
- * A plugin failed during execution.
- */
-export class PluginExecutionFailed extends Data.TaggedError("PluginExecutionFailed") {
-}
-/**
- * Attempted to access a deferred resource before resolution.
- */
-export class ResourceNotResolved extends Data.TaggedError("ResourceNotResolved") {
-}
-/**
- * Create a mutable deferred resource.
- * @internal
- */
-export const createDeferredResource = (kind, params) => ({
-    kind,
-    params,
-    resolved: false,
-    value: undefined,
-});
-/**
- * Create a read-only deferred resource view.
- * Throws if accessed before resolution.
- * @internal
- */
-export const asDeferredResource = (mutable) => ({
-    kind: mutable.kind,
-    params: mutable.params,
-    get result() {
-        if (!mutable.resolved) {
-            throw new ResourceNotResolved({
-                message: `Resource "${mutable.kind}" has not been resolved yet`,
-                kind: mutable.kind,
-                params: mutable.params,
-            });
-        }
-        return mutable.value;
-    },
-});
-/**
- * Create a service registry for handler registration and invocation.
- */
-export const createServiceRegistry = () => {
-    const handlers = MutableHashMap.empty();
-    return {
-        register: (kind, handler, pluginName) => {
-            pipe(MutableHashMap.get(handlers, kind), Option.match({
-                onNone: () => {
-                    MutableHashMap.set(handlers, kind, MutableList.make({ handler, plugin: pluginName }));
-                },
-                onSome: (list) => {
-                    MutableList.append(list, { handler, plugin: pluginName });
-                },
-            }));
-        },
-        invoke: (kind, params, ctx) => {
-            return pipe(MutableHashMap.get(handlers, kind), Option.flatMap((list) => {
-                // Try each handler until one returns a result
-                for (const { handler } of list) {
-                    try {
-                        const result = handler(params, ctx);
-                        if (result !== undefined) {
-                            return Option.some(result);
-                        }
-                    }
-                    catch {
-                        // Handler threw - try next one
-                        continue;
-                    }
-                }
-                return Option.none();
-            }), Option.getOrUndefined);
-        },
-        hasHandler: (kind) => MutableHashMap.has(handlers, kind),
-    };
-};
-/**
- * Effect service tag for ServiceRegistry.
- */
-export class Services extends Context.Tag("Services")() {
-}
-/**
- * Effect service tag for PluginRegistry.
- */
-export class Plugins extends Context.Tag("Plugins")() {
-}
-// ============================================================================
-// Schema for Serialization (if needed)
-// ============================================================================
-/**
- * Schema for ResourceRequest (for artifact serialization if needed).
- */
-export const ResourceRequestSchema = S.Struct({
-    kind: S.String,
-    params: S.Unknown,
-});
-// ============================================================================
-// Helper: definePlugin
-// ============================================================================
-/**
- * Define a plugin with type inference.
- *
- * @example
- * ```typescript
- * const zodSchemas = definePlugin({
- *   name: "zod-schemas",
- *   kind: "validation-schema",
- *   canProvide: (p) => !p.format || p.format === "zod",
- *   requires: () => [{ kind: "semantic-ir", params: {} }],
- *   provide: (params, [ir], ctx) => {
- *     // Generate schema, return symbol ref
- *   },
- * })
- * ```
- */
-export function definePlugin(plugin) {
-    return plugin;
-}
-// ============================================================================
-// Plugin Registry Implementation
-// ============================================================================
-/**
- * Create a plugin registry for collecting plugins and requests.
- *
- * Used during generation to:
- * 1. Collect plugin registrations
- * 2. Collect requests during plugin execution
- * 3. Provide data to resolution phase
- */
-export const createPluginRegistry = () => {
-    const pluginsByKind = MutableHashMap.empty();
-    const allPlugins = MutableList.empty();
-    const pendingRequests = MutableList.empty();
-    return {
-        register: (plugin) => {
-            MutableList.append(allPlugins, plugin);
-            pipe(MutableHashMap.get(pluginsByKind, plugin.kind), Option.match({
-                onNone: () => {
-                    MutableHashMap.set(pluginsByKind, plugin.kind, MutableList.make(plugin));
-                },
-                onSome: (list) => {
-                    MutableList.append(list, plugin);
-                },
-            }));
-        },
-        request: (kind, params, requestedBy) => {
-            const mutable = createDeferredResource(kind, params);
-            MutableList.append(pendingRequests, {
-                kind,
-                params,
-                requestedBy,
-                deferred: mutable,
-            });
-            return asDeferredResource(mutable);
-        },
-        getPlugins: () => Array.from(allPlugins),
-        getPendingRequests: () => Array.from(pendingRequests),
-        getSingletons: () => pipe(Array.from(allPlugins), (plugins) => plugins.filter((p) => p.singleton === true)),
-    };
-};
-/**
- * Layer providing a fresh plugin registry.
- */
-export const PluginsLive = Layer.sync(Plugins, createPluginRegistry);
-//# sourceMappingURL=plugin.js.map

package/dist/services/plugin.js.map

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

package/dist/services/resolution.d.ts

@@ -1,38 +0,0 @@
-/**
- * Resolution Phase
- *
- * Matches requests to providers, expands dependencies, builds DAG,
- * detects cycles, and produces an execution plan.
- */
-import { Effect } from "effect";
-import { type PluginRegistry, type Plugin, type ResourceRequest, PluginCycle, PluginNotFound } from "./plugin.js";
-/**
- * A resolved request: a request matched to a provider.
- */
-export interface ResolvedRequest {
-    readonly kind: string;
-    readonly params: unknown;
-    readonly provider: Plugin;
-    /** Required dependencies (from provider.requires) - always resolved */
-    readonly dependencies: readonly ResourceRequest[];
-    /** Optional dependencies that were successfully resolved (from provider.optionalRequires) */
-    readonly optionalDependencies: readonly ResourceRequest[];
-}
-/**
- * Execution plan: topologically sorted list of resolved requests.
- */
-export interface ExecutionPlan {
-    readonly steps: readonly ResolvedRequest[];
-}
-/**
- * Resolve all requests and produce an execution plan.
- *
- * Steps:
- * 1. Collect all requests (pending + singletons + transitive dependencies)
- * 2. Match each request to a provider
- * 3. Build dependency DAG
- * 4. Detect cycles
- * 5. Topologically sort
- */
-export declare const resolve: (registry: PluginRegistry) => Effect.Effect<ExecutionPlan, PluginNotFound | PluginCycle>;
-//# sourceMappingURL=resolution.d.ts.map

package/dist/services/resolution.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../src/services/resolution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAsB,MAAM,EAAyB,MAAM,QAAQ,CAAA;AAC1E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAA;AAMpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAA;IACjD,6FAA6F;IAC7F,QAAQ,CAAC,oBAAoB,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;CAC3C;AA2UD;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,GAClB,UAAU,cAAc,KACvB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,cAAc,GAAG,WAAW,CAUzD,CAAA"}