@danielfgray/pg-sourcerer 0.1.0

package/dist/services/introspection.js

@@ -0,0 +1,99 @@
+/**
+ * Database Introspection Service
+ *
+ * Provides typed database introspection using pg-introspection.
+ */
+import { Effect, Context } from "effect";
+import pg from "pg";
+import { makeIntrospectionQuery, parseIntrospectionResults, } from "@pg-sourcerer/pg-introspection";
+import { ConnectionFailed, IntrospectionFailed } from "../errors.js";
+/**
+ * Service tag for dependency injection
+ */
+export class DatabaseIntrospectionService extends Context.Tag("DatabaseIntrospection")() {
+}
+/**
+ * Live implementation using pg
+ */
+export const DatabaseIntrospectionLive = Effect.sync(() => createDatabaseIntrospection());
+/**
+ * Create a DatabaseIntrospection implementation
+ */
+export function createDatabaseIntrospection() {
+    return {
+        introspect: (options) => Effect.gen(function* () {
+            const { connectionString, role } = options;
+            // Create pool and connect
+            const pool = new pg.Pool({ connectionString });
+            const client = yield* Effect.tryPromise({
+                try: () => pool.connect(),
+                catch: (error) => new ConnectionFailed({
+                    message: `Failed to connect to database`,
+                    connectionString: connectionString.replace(/:[^:@]+@/, ":***@"), // Hide password
+                    cause: error,
+                }),
+            });
+            try {
+                // Begin transaction
+                yield* Effect.tryPromise({
+                    try: () => client.query("begin"),
+                    catch: (error) => new IntrospectionFailed({
+                        message: "Failed to begin transaction",
+                        schema: "*",
+                        cause: error,
+                    }),
+                });
+                // Set role if specified
+                if (role) {
+                    yield* Effect.tryPromise({
+                        try: () => client.query("select set_config('role', $1, false)", [role]),
+                        catch: (error) => new IntrospectionFailed({
+                            message: `Failed to set role to '${role}'`,
+                            schema: "*",
+                            cause: error,
+                        }),
+                    });
+                }
+                // Run introspection query
+                const result = yield* Effect.tryPromise({
+                    try: () => client.query(makeIntrospectionQuery()),
+                    catch: (error) => new IntrospectionFailed({
+                        message: "Introspection query failed",
+                        schema: "*",
+                        cause: error,
+                    }),
+                });
+                const rawIntrospection = result.rows[0]?.introspection;
+                if (!rawIntrospection) {
+                    return yield* Effect.fail(new IntrospectionFailed({
+                        message: "Introspection returned no results",
+                        schema: "*",
+                        cause: null,
+                    }));
+                }
+                // Rollback (we only read)
+                yield* Effect.tryPromise({
+                    try: () => client.query("rollback"),
+                    catch: (error) => new IntrospectionFailed({
+                        message: "Failed to rollback transaction",
+                        schema: "*",
+                        cause: error,
+                    }),
+                });
+                // Parse results
+                return parseIntrospectionResults(rawIntrospection, true);
+            }
+            finally {
+                client.release();
+                yield* Effect.promise(() => pool.end());
+            }
+        }),
+    };
+}
+/**
+ * Convenience function for one-off introspection (e.g., scripts)
+ */
+export function introspectDatabase(options) {
+    return createDatabaseIntrospection().introspect(options);
+}
+//# sourceMappingURL=introspection.js.map

package/dist/services/introspection.js.map

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

package/dist/services/ir-builder.d.ts

@@ -0,0 +1,46 @@
+/**
+ * IR Builder Service
+ *
+ * Transforms raw pg-introspection output into SemanticIR.
+ * Builds entities (tables, views, composites), shapes, fields,
+ * relations, and enums.
+ */
+import { Context, Effect, Layer } from "effect";
+import type { Introspection } from "@pg-sourcerer/pg-introspection";
+import type { SemanticIR } from "../ir/semantic-ir.js";
+import { Inflection } from "./inflection.js";
+import { IntrospectionFailed, TagParseError } from "../errors.js";
+/**
+ * Options for IR building
+ */
+export interface IRBuilderOptions {
+    /** PostgreSQL schemas to include */
+    readonly schemas: readonly string[];
+    /** Exclude functions that belong to extensions (default: true) */
+    readonly excludeExtensionFunctions?: boolean;
+    /** Role to use for permission checks (defaults to current user) */
+    readonly role?: string;
+}
+/**
+ * IR Builder service interface
+ */
+export interface IRBuilder {
+    /** Build SemanticIR from pg-introspection output */
+    readonly build: (introspection: Introspection, options: IRBuilderOptions) => Effect.Effect<SemanticIR, IntrospectionFailed | TagParseError, Inflection>;
+}
+declare const IRBuilderSvc_base: Context.TagClass<IRBuilderSvc, "IRBuilder", IRBuilder>;
+/** Service tag */
+export declare class IRBuilderSvc extends IRBuilderSvc_base {
+}
+/**
+ * Live layer - provides IRBuilder service
+ * Note: IRBuilder.build() requires Inflection to be provided at call time
+ */
+export declare const IRBuilderLive: Layer.Layer<IRBuilderSvc, never, never>;
+/**
+ * Factory function for creating IR builder
+ * Note: The returned builder's build() method requires Inflection in the Effect context
+ */
+export declare function createIRBuilderService(): IRBuilder;
+export {};
+//# sourceMappingURL=ir-builder.d.ts.map

package/dist/services/ir-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir-builder.d.ts","sourceRoot":"","sources":["../../src/services/ir-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAA8B,MAAM,QAAQ,CAAA;AAC3E,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAcV,UAAU,EAKX,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAMjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,kEAAkE;IAClE,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,CACd,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,gBAAgB,KACtB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,GAAG,aAAa,EAAE,UAAU,CAAC,CAAA;CAChF;;AAED,kBAAkB;AAClB,qBAAa,YAAa,SAAQ,iBAAmD;CAAG;AA4oCxF;;;GAGG;AACH,eAAO,MAAM,aAAa,yCAAqD,CAAA;AAE/E;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,CAElD"}