@danielfgray/pg-sourcerer 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env bun
+/**
+ * pg-sourcerer CLI
+ *
+ * Command-line interface for code generation from PostgreSQL schema.
+ *
+ * Log verbosity is controlled via the built-in --log-level flag:
+ *   --log-level debug   Show detailed output (table names, file paths)
+ *   --log-level info    Default - show progress messages
+ *   --log-level none    Suppress all output except errors
+ */
+import { Command, Options } from "@effect/cli";
+import { NodeContext, NodeRuntime } from "@effect/platform-node";
+import { Console, Effect } from "effect";
+import { runGenerate } from "./generate.js";
+import { runInit } from "./init.js";
+// ============================================================================
+// Options
+// ============================================================================
+const configPath = Options.file("config").pipe(Options.withAlias("c"), Options.withDescription("Path to config file"), Options.optional);
+const outputDir = Options.directory("output").pipe(Options.withAlias("o"), Options.withDescription("Override output directory"), Options.optional);
+const dryRun = Options.boolean("dry-run").pipe(Options.withAlias("n"), Options.withDescription("Show what would be generated without writing files"), Options.withDefault(false));
+// ============================================================================
+// Generate Command
+// ============================================================================
+const generateCommand = Command.make("generate", { configPath, outputDir, dryRun }, args => {
+    // Build options object, only including defined values
+    const opts = {
+        dryRun: args.dryRun,
+    };
+    if (args.configPath._tag === "Some") {
+        opts.configPath = args.configPath.value;
+    }
+    if (args.outputDir._tag === "Some") {
+        opts.outputDir = args.outputDir.value;
+    }
+    const logSuccess = (result) => {
+        const written = result.writeResults.filter(r => r.written).length;
+        const total = result.writeResults.length;
+        const suffix = args.dryRun ? " (dry run)" : "";
+        return Console.log(`\n✓ Generated ${args.dryRun ? total : written} files${suffix}`);
+    };
+    return Effect.gen(function* () {
+        const result = yield* runGenerate(opts);
+        yield* logSuccess(result);
+    }).pipe(
+    // Handle ConfigNotFound specially - offer to run init
+    Effect.catchTag("ConfigNotFound", error => Effect.gen(function* () {
+        yield* Console.error(`\n✗ No config file found`);
+        yield* Console.error(`  Searched: ${error.searchPaths.join(", ")}`);
+        // // Ask if user wants to create config - if they quit (Ctrl+C), just fail
+        // const shouldInit = yield* Prompt.confirm({
+        //   message: "Would you like to create one now?",
+        //   initial: true,
+        // }).pipe(Effect.catchTag("QuitException", () => Effect.succeed(false)))
+        //
+        // if (!shouldInit) {
+        //   yield* Console.log("\nRun 'pgsourcerer init' to create a config file.")
+        //   return yield* Effect.fail(error)
+        // }
+        // Run init, catching any errors (user quit, validation, etc.)
+        const initResult = yield* runInit.pipe(Effect.map(() => true), Effect.catchAll(() => Effect.succeed(false)));
+        if (!initResult) {
+            return yield* Effect.fail(error);
+        }
+    })), 
+    // Handle other errors
+    Effect.catchAll((error) => Effect.gen(function* () {
+        yield* Console.error(`\n✗ Error: ${error._tag}`);
+        yield* Console.error(`  ${error.message}`);
+        if (error._tag === "ConfigInvalid") {
+            for (const e of error.errors) {
+                yield* Console.error(`    - ${e}`);
+            }
+        }
+        else if (error._tag === "PluginConfigInvalid") {
+            for (const e of error.errors) {
+                yield* Console.error(`    - ${e}`);
+            }
+        }
+        else if (error._tag === "CapabilityCycle") {
+            yield* Console.error(`  Cycle: ${error.cycle.join(" → ")}`);
+        }
+        yield* Effect.fail(error);
+    })));
+});
+// ============================================================================
+// Init Command
+// ============================================================================
+const initCommand = Command.make("init", {}, () => runInit);
+// ============================================================================
+// Root Command
+// ============================================================================
+const rootCommand = Command.make("pgsourcerer", {}, () => Console.log("pg-sourcerer - Generate TypeScript from PostgreSQL\n\nRun 'pgsourcerer --help' for usage.")).pipe(Command.withSubcommands([generateCommand, initCommand]));
+// ============================================================================
+// CLI App
+// ============================================================================
+const cli = Command.run(rootCommand, {
+    name: "pgsourcerer",
+    version: "0.0.1",
+});
+// Run with Node.js platform
+cli(process.argv).pipe(Effect.provide(NodeContext.layer), NodeRuntime.runMain);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Configuration schema for pg-sourcerer
+ */
+import { Schema as S } from "effect";
+import type { InflectionConfig } from "./services/inflection.js";
+/**
+ * Type hint match criteria
+ */
+export declare const TypeHintMatch: S.Struct<{
+    schema: S.optional<typeof S.String>;
+    table: S.optional<typeof S.String>;
+    column: S.optional<typeof S.String>;
+    pgType: S.optional<typeof S.String>;
+}>;
+export type TypeHintMatch = S.Schema.Type<typeof TypeHintMatch>;
+/**
+ * Type hint - user-configured type override
+ */
+export declare const TypeHint: S.Struct<{
+    match: S.Struct<{
+        schema: S.optional<typeof S.String>;
+        table: S.optional<typeof S.String>;
+        column: S.optional<typeof S.String>;
+        pgType: S.optional<typeof S.String>;
+    }>;
+    hints: S.Record$<typeof S.String, typeof S.Unknown>;
+}>;
+export type TypeHint = S.Schema.Type<typeof TypeHint>;
+/**
+ * Main configuration schema
+ *
+ * Note: `inflection` and `plugins` are typed as S.Any in the schema since
+ * they contain complex types that can't be fully validated at runtime.
+ * Use `ConfigInput` for typed user-facing config and `ResolvedConfig` for
+ * the fully resolved configuration.
+ */
+export declare const Config: S.Struct<{
+    /** Database connection string */
+    connectionString: typeof S.String;
+    /** PostgreSQL role to assume during introspection (for RLS-aware generation) */
+    role: S.optional<typeof S.String>;
+    /** PostgreSQL schemas to introspect */
+    schemas: S.optionalWith<S.Array$<typeof S.String>, {
+        default: () => string[];
+    }>;
+    /** Output directory root */
+    outputDir: S.optionalWith<typeof S.String, {
+        default: () => string;
+    }>;
+    /** Type hints for custom type mapping */
+    typeHints: S.optionalWith<S.Array$<S.Struct<{
+        match: S.Struct<{
+            schema: S.optional<typeof S.String>;
+            table: S.optional<typeof S.String>;
+            column: S.optional<typeof S.String>;
+            pgType: S.optional<typeof S.String>;
+        }>;
+        hints: S.Record$<typeof S.String, typeof S.Unknown>;
+    }>>, {
+        default: () => never[];
+    }>;
+    /** Inflection configuration (validated as Any, properly typed in ConfigInput) */
+    inflection: S.optional<typeof S.Any>;
+    /** Plugins to run (validated individually per plugin) */
+    plugins: S.Array$<typeof S.Any>;
+    /** Formatter callback to transform generated code before writing (validated as Any, properly typed in ConfigInput) */
+    formatter: S.optional<typeof S.String>;
+}>;
+export type Config = S.Schema.Type<typeof Config>;
+/**
+ * User-facing configuration input type.
+ *
+ * This provides proper TypeScript types for `inflection` and `plugins`
+ * which are stored as `S.Any` in the schema for runtime flexibility.
+ * Use this type for `defineConfig()` to give users proper autocomplete.
+ */
+export interface ConfigInput {
+    /** Database connection string */
+    readonly connectionString: string;
+    /** PostgreSQL role to assume during introspection (for RLS-aware generation) */
+    readonly role?: string;
+    /** PostgreSQL schemas to introspect (default: ["public"]) */
+    readonly schemas?: readonly string[];
+    /** Output directory root (default: "src/generated") */
+    readonly outputDir?: string;
+    /** Type hints for custom type mapping */
+    readonly typeHints?: readonly TypeHint[];
+    /**
+     * Inflection configuration for customizing naming conventions.
+     * Each property is a function that transforms a name.
+     *
+     * @example
+     * ```typescript
+     * import { inflect } from "pg-sourcerer"
+     *
+     * inflection: {
+     *   entityName: (name) => inflect.pascalCase(inflect.singularize(name)), // users → User
+     *   fieldName: inflect.camelCase,                   // created_at → createdAt
+     *   enumName: inflect.pascalCase,                   // user_status → UserStatus
+     * }
+     * ```
+     */
+    readonly inflection?: InflectionConfig;
+    /** Plugins to run */
+    readonly plugins: readonly unknown[];
+    /**
+     * Formatter command to run on generated files after writing.
+     * The command will be run with the output directory as the argument.
+     * Errors will fail generation.
+     *
+     * @example
+     * ```typescript
+     * formatter: "prettier --write"
+     * // or
+     * formatter: "biome format --write"
+     * ```
+     */
+    readonly formatter?: string;
+}
+/**
+ * Resolved configuration with all defaults applied
+ */
+export interface ResolvedConfig {
+    readonly connectionString: string;
+    readonly role?: string;
+    readonly schemas: readonly string[];
+    readonly outputDir: string;
+    readonly typeHints: readonly TypeHint[];
+    readonly inflection?: InflectionConfig;
+    readonly plugins: readonly unknown[];
+    readonly formatter?: string;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;EAKxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,aAAa,CAAC,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;EAGnB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;IACjB,iCAAiC;;IAGjC,gFAAgF;;IAGhF,uCAAuC;;;;IAGvC,4BAA4B;;;;IAG5B,yCAAyC;;;;;;;;;;;;IAGzC,iFAAiF;;IAGjF,yDAAyD;;IAGzD,sHAAsH;;EAEtH,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IAEjC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAEpC,uDAAuD;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAE3B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IAExC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAEtC,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAA;IAEpC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAA;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B"}

package/dist/config.js

@@ -0,0 +1,47 @@
+/**
+ * Configuration schema for pg-sourcerer
+ */
+import { Schema as S } from "effect";
+/**
+ * Type hint match criteria
+ */
+export const TypeHintMatch = S.Struct({
+    schema: S.optional(S.String),
+    table: S.optional(S.String),
+    column: S.optional(S.String),
+    pgType: S.optional(S.String),
+});
+/**
+ * Type hint - user-configured type override
+ */
+export const TypeHint = S.Struct({
+    match: TypeHintMatch,
+    hints: S.Record({ key: S.String, value: S.Unknown }),
+});
+/**
+ * Main configuration schema
+ *
+ * Note: `inflection` and `plugins` are typed as S.Any in the schema since
+ * they contain complex types that can't be fully validated at runtime.
+ * Use `ConfigInput` for typed user-facing config and `ResolvedConfig` for
+ * the fully resolved configuration.
+ */
+export const Config = S.Struct({
+    /** Database connection string */
+    connectionString: S.String,
+    /** PostgreSQL role to assume during introspection (for RLS-aware generation) */
+    role: S.optional(S.String),
+    /** PostgreSQL schemas to introspect */
+    schemas: S.optionalWith(S.Array(S.String), { default: () => ["public"] }),
+    /** Output directory root */
+    outputDir: S.optionalWith(S.String, { default: () => "src/generated" }),
+    /** Type hints for custom type mapping */
+    typeHints: S.optionalWith(S.Array(TypeHint), { default: () => [] }),
+    /** Inflection configuration (validated as Any, properly typed in ConfigInput) */
+    inflection: S.optional(S.Any),
+    /** Plugins to run (validated individually per plugin) */
+    plugins: S.Array(S.Any),
+    /** Formatter callback to transform generated code before writing (validated as Any, properly typed in ConfigInput) */
+    formatter: S.optional(S.String),
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAGpC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;CAC7B,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CACrD,CAAC,CAAA;AAGF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,iCAAiC;IACjC,gBAAgB,EAAE,CAAC,CAAC,MAAM;IAE1B,gFAAgF;IAChF,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAE1B,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IAEzE,4BAA4B;IAC5B,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;IAEvE,yCAAyC;IACzC,SAAS,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAEnE,iFAAiF;IACjF,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;IAE7B,yDAAyD;IACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAEvB,sHAAsH;IACtH,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;CAChC,CAAC,CAAA"}

package/dist/errors.d.ts

@@ -0,0 +1,129 @@
+interface ErrorBase {
+    readonly message: string;
+}
+declare const ConfigNotFound_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: "ConfigNotFound";
+} & Readonly<A>;
+export declare class ConfigNotFound extends ConfigNotFound_base<ErrorBase & {
+    readonly searchPaths: readonly string[];
+}> {
+}
+declare const ConfigInvalid_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: "ConfigInvalid";
+} & Readonly<A>;
+export declare class ConfigInvalid extends ConfigInvalid_base<ErrorBase & {
+    readonly path: string;
+    readonly errors: readonly string[];
+}> {
+}
+declare const ConnectionFailed_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: "ConnectionFailed";
+} & Readonly<A>;
+export declare class ConnectionFailed extends ConnectionFailed_base<ErrorBase & {
+    readonly connectionString: string;
+    readonly cause: unknown;
+}> {
+}
+declare const IntrospectionFailed_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: "IntrospectionFailed";
+} & Readonly<A>;
+export declare class IntrospectionFailed extends IntrospectionFailed_base<ErrorBase & {
+    readonly schema: string;
+    readonly cause: unknown;
+}> {
+}
+declare const TagParseError_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: "TagParseError";
+} & Readonly<A>;
+export declare class TagParseError extends TagParseError_base<ErrorBase & {
+    readonly objectType: "table" | "column" | "constraint" | "type";
+    readonly objectName: string;
+    readonly comment: string;
+    readonly cause: unknown;
+}> {
+}
+declare const DuplicatePlugin_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: "DuplicatePlugin";
+} & Readonly<A>;
+export declare class DuplicatePlugin extends DuplicatePlugin_base<ErrorBase & {
+    readonly plugin: string;
+}> {
+}
+declare const CapabilityNotSatisfied_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: "CapabilityNotSatisfied";
+} & Readonly<A>;
+export declare class CapabilityNotSatisfied extends CapabilityNotSatisfied_base<ErrorBase & {
+    readonly required: string;
+    readonly requiredBy: string;
+}> {
+}
+declare const CapabilityConflict_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: "CapabilityConflict";
+} & Readonly<A>;
+export declare class CapabilityConflict extends CapabilityConflict_base<ErrorBase & {
+    readonly capability: string;
+    readonly providers: readonly string[];
+}> {
+}
+declare const CapabilityCycle_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: "CapabilityCycle";
+} & Readonly<A>;
+export declare class CapabilityCycle extends CapabilityCycle_base<ErrorBase & {
+    readonly cycle: readonly string[];
+}> {
+}
+declare const PluginConfigInvalid_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: "PluginConfigInvalid";
+} & Readonly<A>;
+export declare class PluginConfigInvalid extends PluginConfigInvalid_base<ErrorBase & {
+    readonly plugin: string;
+    readonly errors: 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>;
+export declare class PluginExecutionFailed extends PluginExecutionFailed_base<ErrorBase & {
+    readonly plugin: string;
+    readonly entity?: string;
+    readonly field?: string;
+    readonly cause: unknown;
+    readonly hint?: string;
+}> {
+}
+declare const EmitConflict_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: "EmitConflict";
+} & Readonly<A>;
+export declare class EmitConflict extends EmitConflict_base<ErrorBase & {
+    readonly path: string;
+    readonly plugins: readonly string[];
+}> {
+}
+declare const SymbolConflict_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: "SymbolConflict";
+} & Readonly<A>;
+export declare class SymbolConflict extends SymbolConflict_base<ErrorBase & {
+    readonly symbol: string;
+    readonly file: string;
+    readonly plugins: readonly string[];
+}> {
+}
+declare const WriteError_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: "WriteError";
+} & Readonly<A>;
+export declare class WriteError extends WriteError_base<ErrorBase & {
+    readonly path: string;
+    readonly cause: unknown;
+}> {
+}
+declare const FormatError_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: "FormatError";
+} & Readonly<A>;
+export declare class FormatError extends FormatError_base<ErrorBase & {
+    readonly path: string;
+    readonly cause: unknown;
+}> {
+}
+export type SourcererError = ConfigNotFound | ConfigInvalid | ConnectionFailed | IntrospectionFailed | TagParseError | DuplicatePlugin | CapabilityNotSatisfied | CapabilityConflict | CapabilityCycle | PluginConfigInvalid | PluginExecutionFailed | EmitConflict | SymbolConflict | WriteError | FormatError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,41 @@
+/**
+ * Core error types for pg-sourcerer
+ * Using Effect's Data.TaggedEnum for typed error handling
+ */
+import { Data } from "effect";
+// Configuration errors
+export class ConfigNotFound extends Data.TaggedError("ConfigNotFound") {
+}
+export class ConfigInvalid extends Data.TaggedError("ConfigInvalid") {
+}
+// Database errors
+export class ConnectionFailed extends Data.TaggedError("ConnectionFailed") {
+}
+export class IntrospectionFailed extends Data.TaggedError("IntrospectionFailed") {
+}
+// Smart tags errors
+export class TagParseError extends Data.TaggedError("TagParseError") {
+}
+// Plugin errors
+export class DuplicatePlugin extends Data.TaggedError("DuplicatePlugin") {
+}
+export class CapabilityNotSatisfied extends Data.TaggedError("CapabilityNotSatisfied") {
+}
+export class CapabilityConflict extends Data.TaggedError("CapabilityConflict") {
+}
+export class CapabilityCycle extends Data.TaggedError("CapabilityCycle") {
+}
+export class PluginConfigInvalid extends Data.TaggedError("PluginConfigInvalid") {
+}
+export class PluginExecutionFailed extends Data.TaggedError("PluginExecutionFailed") {
+}
+// Emission errors
+export class EmitConflict extends Data.TaggedError("EmitConflict") {
+}
+export class SymbolConflict extends Data.TaggedError("SymbolConflict") {
+}
+export class WriteError extends Data.TaggedError("WriteError") {
+}
+export class FormatError extends Data.TaggedError("FormatError") {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAO7B,uBAAuB;AACvB,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAEpE;CAAG;AAEJ,MAAM,OAAO,aAAc,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAElE;CAAG;AAEJ,kBAAkB;AAClB,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAExE;CAAG;AAEJ,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAE9E;CAAG;AAEJ,oBAAoB;AACpB,MAAM,OAAO,aAAc,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAOlE;CAAG;AAEJ,gBAAgB;AAChB,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAEtE;CAAG;AAEJ,MAAM,OAAO,sBAAuB,SAAQ,IAAI,CAAC,WAAW,CAAC,wBAAwB,CAEpF;CAAG;AAEJ,MAAM,OAAO,kBAAmB,SAAQ,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAE5E;CAAG;AAEJ,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAEtE;CAAG;AAEJ,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAE9E;CAAG;AAEJ,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAQlF;CAAG;AAEJ,kBAAkB;AAClB,MAAM,OAAO,YAAa,SAAQ,IAAI,CAAC,WAAW,CAAC,cAAc,CAEhE;CAAG;AAEJ,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAMpE;CAAG;AAEJ,MAAM,OAAO,UAAW,SAAQ,IAAI,CAAC,WAAW,CAAC,YAAY,CAE5D;CAAG;AAEJ,MAAM,OAAO,WAAY,SAAQ,IAAI,CAAC,WAAW,CAAC,aAAa,CAE9D;CAAG"}

package/dist/generate.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Generate Orchestration Function
+ *
+ * Threads together the full code generation pipeline:
+ * 1. Load config
+ * 2. Introspect database
+ * 3. Build IR
+ * 4. Prepare and run plugins
+ * 5. Write files
+ *
+ * Logging:
+ * - Effect.log (INFO) - Progress messages shown by default
+ * - Effect.logDebug (DEBUG) - Detailed info (entity names, file lists)
+ *
+ * Configure via Logger.withMinimumLogLevel at the call site.
+ */
+import { Effect, Layer } from "effect";
+import { FileSystem, Path, CommandExecutor } from "@effect/platform";
+import type { ResolvedConfig } from "./config.js";
+import type { RunResult } from "./services/plugin-runner.js";
+import { ConfigLoaderService } from "./services/config-loader.js";
+import { DatabaseIntrospectionService } from "./services/introspection.js";
+import { type WriteResult } from "./services/file-writer.js";
+import { type SemanticIR } from "./ir/semantic-ir.js";
+import { ConfigNotFound, ConfigInvalid, ConnectionFailed, IntrospectionFailed, TagParseError, CapabilityConflict, CapabilityCycle, CapabilityNotSatisfied, DuplicatePlugin, PluginConfigInvalid, PluginExecutionFailed, EmitConflict, SymbolConflict, WriteError, FormatError } from "./errors.js";
+/**
+ * Options for the generate function
+ */
+export interface GenerateOptions {
+    /** Path to config file (optional - will search if not provided) */
+    readonly configPath?: string;
+    /** Directory to search for config from (default: cwd) */
+    readonly searchFrom?: string;
+    /** Override output directory from config */
+    readonly outputDir?: string;
+    /** Dry run - don't write files, just return what would be written */
+    readonly dryRun?: boolean;
+}
+/**
+ * Result of a generate operation
+ */
+export interface GenerateResult {
+    /** The loaded configuration */
+    readonly config: ResolvedConfig;
+    /** The built semantic IR */
+    readonly ir: SemanticIR;
+    /** Plugin execution results */
+    readonly pluginResult: RunResult;
+    /** File write results */
+    readonly writeResults: readonly WriteResult[];
+}
+/**
+ * All possible errors from the generate pipeline
+ */
+export type GenerateError = ConfigNotFound | ConfigInvalid | ConnectionFailed | IntrospectionFailed | TagParseError | CapabilityConflict | CapabilityCycle | CapabilityNotSatisfied | DuplicatePlugin | PluginConfigInvalid | PluginExecutionFailed | EmitConflict | SymbolConflict | WriteError | FormatError;
+/**
+ * The main generate pipeline
+ */
+export declare const generate: (options?: GenerateOptions) => Effect.Effect<GenerateResult, GenerateError, ConfigLoaderService | DatabaseIntrospectionService | FileSystem.FileSystem | Path.Path | CommandExecutor.CommandExecutor>;
+/**
+ * Layer that provides all services needed for generate()
+ *
+ * Note: PluginRunner is NOT included here because it needs to be
+ * created with the user's inflection config (from loaded config).
+ * The generate() function creates the PluginRunner internally.
+ */
+export declare const GenerateLive: Layer.Layer<ConfigLoaderService | DatabaseIntrospectionService, never, never>;
+/**
+ * Run generate with all dependencies provided
+ *
+ * This is the main entry point for programmatic usage.
+ * Requires FileSystem, Path, and CommandExecutor from @effect/platform.
+ */
+export declare const runGenerate: (options?: GenerateOptions) => Effect.Effect<GenerateResult, GenerateError, FileSystem.FileSystem | Path.Path | CommandExecutor.CommandExecutor>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAW,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EACL,mBAAmB,EAEpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,4BAA4B,EAE7B,MAAM,6BAA6B,CAAA;AAGpC,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAG9E,OAAO,EAA8E,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACjI,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACZ,MAAM,aAAa,CAAA;AAGpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAA;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAA;IAChC,yBAAyB;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAA;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,sBAAsB,GACtB,eAAe,GACf,mBAAmB,GACnB,qBAAqB,GACrB,YAAY,GACZ,cAAc,GACd,UAAU,GACV,WAAW,CAAA;AA4Cf;;GAEG;AACH,eAAO,MAAM,QAAQ,GACnB,UAAS,eAAoB,KAC5B,MAAM,CAAC,MAAM,CACd,cAAc,EACd,aAAa,EACX,mBAAmB,GACnB,4BAA4B,GAC5B,UAAU,CAAC,UAAU,GACrB,IAAI,CAAC,IAAI,GACT,eAAe,CAAC,eAAe,CA8I/B,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,+EAGxB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,UAAS,eAAoB,KAC5B,MAAM,CAAC,MAAM,CACd,cAAc,EACd,aAAa,EACb,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,eAAe,CACZ,CAAA"}