@danielfgray/pg-sourcerer 0.1.0

package/dist/services/emissions.js

@@ -0,0 +1,194 @@
+/**
+ * Emission Buffer Service
+ *
+ * Buffers code emissions from plugins before writing to disk.
+ * Supports both string content and AST nodes (serialized by the plugin runner).
+ * AST emissions to the same file are merged automatically.
+ */
+import { Array as Arr, Context, Effect, Layer, MutableHashMap, MutableHashSet, Option, pipe } from "effect";
+import { EmitConflict } from "../errors.js";
+/**
+ * EmissionBuffer service tag
+ */
+export class Emissions extends Context.Tag("Emissions")() {
+}
+// =============================================================================
+// Import Resolution Helpers
+// =============================================================================
+import recast from "recast";
+const b = recast.types.builders;
+/**
+ * Resolve imports and prepend import statements to AST
+ */
+function prependImports(ast, imports, forFile, symbols) {
+    // Group imports by source path for merging
+    const bySource = pipe(imports, Arr.reduce(new Map(), (map, ref) => {
+        const resolved = resolveImportRef(ref, forFile, symbols);
+        if (!resolved)
+            return map;
+        const { source, named, types, defaultImport } = resolved;
+        const existing = map.get(source) ?? { named: new Set(), types: new Set() };
+        named.forEach((n) => existing.named.add(n));
+        types.forEach((t) => existing.types.add(t));
+        if (defaultImport)
+            existing.default = defaultImport;
+        map.set(source, existing);
+        return map;
+    }));
+    const statements = pipe([...bySource.entries()], Arr.flatMap(([source, { named, types, default: defaultImport }]) => {
+        const result = [];
+        // Value imports (default + named)
+        const valueSpecifiers = [
+            ...(defaultImport ? [b.importDefaultSpecifier(b.identifier(defaultImport))] : []),
+            ...pipe([...named], Arr.map((name) => b.importSpecifier(b.identifier(name), b.identifier(name)))),
+        ];
+        if (valueSpecifiers.length > 0) {
+            result.push(b.importDeclaration(valueSpecifiers, b.stringLiteral(source)));
+        }
+        // Type imports as a separate type-only import declaration
+        if (types.size > 0) {
+            const typeSpecifiers = pipe([...types], Arr.map((name) => b.importSpecifier(b.identifier(name), b.identifier(name))));
+            const typeImport = b.importDeclaration(typeSpecifiers, b.stringLiteral(source));
+            typeImport.importKind = "type";
+            result.push(typeImport);
+        }
+        return result;
+    }));
+    // Prepend imports to program body
+    return b.program([...statements, ...ast.body]);
+}
+/** Normalize path for comparison (remove leading ./) */
+const normalizePath = (path) => path.replace(/^\.\//, "");
+/** Resolve an ImportRef to source/named/types/default */
+function resolveImportRef(ref, forFile, symbols) {
+    switch (ref.kind) {
+        case "symbol": {
+            const symbol = symbols.resolve(ref.ref);
+            if (!symbol)
+                return undefined;
+            // Skip import if symbol is in the same file (already declared locally)
+            if (normalizePath(symbol.file) === normalizePath(forFile))
+                return undefined;
+            const importStmt = symbols.importFor(symbol, forFile);
+            const base = {
+                source: importStmt.from,
+                named: [...importStmt.named],
+                types: [...importStmt.types],
+            };
+            return importStmt.default !== undefined
+                ? { ...base, defaultImport: importStmt.default }
+                : base;
+        }
+        case "package":
+        case "relative": {
+            const base = {
+                source: ref.from,
+                named: ref.names ? [...ref.names] : [],
+                types: ref.types ? [...ref.types] : [],
+            };
+            return ref.default !== undefined
+                ? { ...base, defaultImport: ref.default }
+                : base;
+        }
+    }
+}
+// =============================================================================
+// AST Emission Merging (Pure Functions)
+// =============================================================================
+/** Merge two import arrays */
+const mergeImports = (a, b) => [...(a ?? []), ...(b ?? [])];
+/** Merge two plugin attribution strings */
+const mergePluginAttribution = (a, b) => `${a}, ${b}`;
+/** Create an AST entry, only including optional fields when defined */
+const makeAstEntry = (path, ast, plugin, header, imports) => pipe({ path, ast, plugin }, (entry) => header !== undefined ? { ...entry, header } : entry, (entry) => imports && imports.length > 0 ? { ...entry, imports } : entry);
+/** Merge a new emission into an existing one (keeps first header) */
+const mergeAstEntries = (existing, ast, plugin, _header, imports) => makeAstEntry(existing.path, b.program([...existing.ast.body, ...ast.body]), mergePluginAttribution(existing.plugin, plugin), existing.header, mergeImports(existing.imports, imports));
+// =============================================================================
+// Emission Buffer Implementation
+// =============================================================================
+/**
+ * Create a new emission buffer
+ */
+export function createEmissionBuffer() {
+    const emissions = MutableHashMap.empty();
+    const astEmissions = MutableHashMap.empty();
+    // Track plugins per path for string emission conflict detection
+    const stringEmitPlugins = MutableHashMap.empty();
+    return {
+        emit: (path, content, plugin) => {
+            // Track plugin for conflict detection
+            MutableHashMap.modifyAt(stringEmitPlugins, path, Option.match({
+                onNone: () => Option.some(MutableHashSet.make(plugin)),
+                onSome: (set) => Option.some(MutableHashSet.add(set, plugin))
+            }));
+            MutableHashMap.set(emissions, path, { path, content, plugin });
+        },
+        emitAst: (path, ast, plugin, header, imports) => {
+            MutableHashMap.modifyAt(astEmissions, path, Option.match({
+                onNone: () => Option.some(makeAstEntry(path, ast, plugin, header, imports)),
+                onSome: (existing) => Option.some(mergeAstEntries(existing, ast, plugin, header, imports))
+            }));
+        },
+        appendEmit: (path, content, plugin) => {
+            pipe(MutableHashMap.get(emissions, path), Option.match({
+                onNone: () => {
+                    MutableHashMap.modifyAt(stringEmitPlugins, path, Option.match({
+                        onNone: () => Option.some(MutableHashSet.make(plugin)),
+                        onSome: (set) => Option.some(MutableHashSet.add(set, plugin))
+                    }));
+                    MutableHashMap.set(emissions, path, { path, content, plugin });
+                },
+                onSome: (existing) => {
+                    if (existing.plugin === plugin) {
+                        MutableHashMap.set(emissions, path, {
+                            path,
+                            content: existing.content + content,
+                            plugin,
+                        });
+                    }
+                    else {
+                        // Track conflict for validation
+                        MutableHashMap.modifyAt(stringEmitPlugins, path, Option.match({
+                            onNone: () => Option.some(MutableHashSet.make(plugin)),
+                            onSome: (set) => Option.some(MutableHashSet.add(set, plugin))
+                        }));
+                    }
+                }
+            }));
+        },
+        getAll: () => MutableHashMap.values(emissions),
+        getAstEmissions: () => MutableHashMap.values(astEmissions),
+        serializeAst: (serialize, symbols) => {
+            for (const entry of MutableHashMap.values(astEmissions)) {
+                const finalAst = entry.imports && entry.imports.length > 0
+                    ? prependImports(entry.ast, entry.imports, entry.path, symbols)
+                    : entry.ast;
+                const code = serialize(finalAst);
+                const content = entry.header ? entry.header + code : code;
+                MutableHashMap.set(emissions, entry.path, { path: entry.path, content, plugin: entry.plugin });
+            }
+            MutableHashMap.clear(astEmissions);
+        },
+        validate: () => pipe([...stringEmitPlugins], Arr.findFirst(([_, plugins]) => MutableHashSet.size(plugins) > 1), Option.match({
+            onNone: () => Effect.void,
+            onSome: ([path, plugins]) => {
+                const pluginList = [...plugins].join(", ");
+                return Effect.fail(new EmitConflict({
+                    message: `Multiple plugins emitted to the same file: ${path} (plugins: ${pluginList})`,
+                    path,
+                    plugins: [...plugins],
+                }));
+            }
+        })),
+        clear: () => {
+            MutableHashMap.clear(emissions);
+            MutableHashMap.clear(astEmissions);
+            MutableHashMap.clear(stringEmitPlugins);
+        },
+    };
+}
+/**
+ * Live layer - creates fresh emission buffer per use
+ */
+export const EmissionsLive = Layer.sync(Emissions, () => createEmissionBuffer());
+//# sourceMappingURL=emissions.js.map

package/dist/services/emissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emissions.js","sourceRoot":"","sources":["../../src/services/emissions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,IAAI,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAQ3G,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAoF3C;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAGpD;CAAG;AAEN,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAA;AAE/B;;GAEG;AACH,SAAS,cAAc,CACrB,GAAc,EACd,OAA6B,EAC7B,OAAe,EACf,OAAuB;IAEvB,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,IAAI,CACnB,OAAO,EACP,GAAG,CAAC,MAAM,CACR,IAAI,GAAG,EAAwE,EAC/E,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACX,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QACxD,IAAI,CAAC,QAAQ;YAAE,OAAO,GAAG,CAAA;QAEzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,QAAQ,CAAA;QACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,EAAU,EAAE,KAAK,EAAE,IAAI,GAAG,EAAU,EAAE,CAAA;QAC1F,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAI,aAAa;YAAE,QAAQ,CAAC,OAAO,GAAG,aAAa,CAAA;QACnD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACzB,OAAO,GAAG,CAAA;IACZ,CAAC,CACF,CACF,CAAA;IAID,MAAM,UAAU,GAAoB,IAAI,CACtC,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,EACvB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE;QACjE,MAAM,MAAM,GAAoB,EAAE,CAAA;QAElC,kCAAkC;QAClC,MAAM,eAAe,GAAsB;YACzC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAClG,CAAA;QACD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC5E,CAAC;QAED,0DAA0D;QAC1D,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,cAAc,GAAsB,IAAI,CAC5C,CAAC,GAAG,KAAK,CAAC,EACV,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAC7E,CAAA;YACD,MAAM,UAAU,GAAG,CAAC,CAAC,iBAAiB,CAAC,cAAc,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;YAC/E,UAAU,CAAC,UAAU,GAAG,MAAM,CAAA;YAC9B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACzB,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAC,CACH,CAAA;IAED,kCAAkC;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAChD,CAAC;AAED,wDAAwD;AACxD,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;AAEzE,yDAAyD;AACzD,SAAS,gBAAgB,CACvB,GAAc,EACd,OAAe,EACf,OAAuB;IAEvB,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACvC,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAA;YAC7B,uEAAuE;YACvE,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC;gBAAE,OAAO,SAAS,CAAA;YAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACrD,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE,UAAU,CAAC,IAAI;gBACvB,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;gBAC5B,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;aAC7B,CAAA;YACD,OAAO,UAAU,CAAC,OAAO,KAAK,SAAS;gBACrC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,OAAO,EAAE;gBAChD,CAAC,CAAC,IAAI,CAAA;QACV,CAAC;QACD,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE,GAAG,CAAC,IAAI;gBAChB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;gBACtC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;aACvC,CAAA;YACD,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS;gBAC9B,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE;gBACzC,CAAC,CAAC,IAAI,CAAA;QACV,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,8BAA8B;AAC9B,MAAM,YAAY,GAAG,CACnB,CAAwB,EACxB,CAAwB,EACF,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AAEvD,2CAA2C;AAC3C,MAAM,sBAAsB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAA;AAE7E,uEAAuE;AACvE,MAAM,YAAY,GAAG,CACnB,IAAY,EACZ,GAAc,EACd,MAAc,EACd,MAAe,EACf,OAA8B,EACZ,EAAE,CACpB,IAAI,CACF,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAsB,EACzC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,EAC9D,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CACzE,CAAA;AAEH,qEAAqE;AACrE,MAAM,eAAe,GAAG,CACtB,QAA0B,EAC1B,GAAc,EACd,MAAc,EACd,OAAgB,EAChB,OAA8B,EACZ,EAAE,CACpB,YAAY,CACV,QAAQ,CAAC,IAAI,EACb,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,EAC9C,sBAAsB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/C,QAAQ,CAAC,MAAM,EACf,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CACxC,CAAA;AAEH,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAyB,CAAA;IAC/D,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,EAA4B,CAAA;IACrE,gEAAgE;IAChE,MAAM,iBAAiB,GAAG,cAAc,CAAC,KAAK,EAAiD,CAAA;IAE/F,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9B,sCAAsC;YACtC,cAAc,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;gBAC5D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;aAC9D,CAAC,CAAC,CAAA;YACH,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YAC9C,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;gBACvD,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC3E,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;aAC3F,CAAC,CAAC,CAAA;QACL,CAAC;QAED,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YACpC,IAAI,CACF,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,EACnC,MAAM,CAAC,KAAK,CAAC;gBACX,MAAM,EAAE,GAAG,EAAE;oBACX,cAAc,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;wBAC5D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBACtD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;qBAC9D,CAAC,CAAC,CAAA;oBACH,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;gBAChE,CAAC;gBACD,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;oBACnB,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;wBAC/B,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE;4BAClC,IAAI;4BACJ,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,OAAO;4BACnC,MAAM;yBACP,CAAC,CAAA;oBACJ,CAAC;yBAAM,CAAC;wBACN,gCAAgC;wBAChC,cAAc,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;4BAC5D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;4BACtD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;yBAC9D,CAAC,CAAC,CAAA;oBACL,CAAC;gBACH,CAAC;aACF,CAAC,CACH,CAAA;QACH,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC;QAE9C,eAAe,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC;QAE1D,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;YACnC,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBACxD,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;oBAC/D,CAAC,CAAC,KAAK,CAAC,GAAG,CAAA;gBAEb,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;gBAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;gBACzD,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;YAChG,CAAC;YACD,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QACpC,CAAC;QAED,QAAQ,EAAE,GAAG,EAAE,CACb,IAAI,CACF,CAAC,GAAG,iBAAiB,CAAC,EACtB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EACjE,MAAM,CAAC,KAAK,CAAC;YACX,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;YACzB,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC1B,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC1C,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,YAAY,CAAC;oBACf,OAAO,EAAE,8CAA8C,IAAI,cAAc,UAAU,GAAG;oBACtF,IAAI;oBACJ,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;iBACtB,CAAC,CACH,CAAA;YACH,CAAC;SACF,CAAC,CACH;QAEH,KAAK,EAAE,GAAG,EAAE;YACV,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YAC/B,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;YAClC,cAAc,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QACzC,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,oBAAoB,EAAE,CAAC,CAAA"}

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

@@ -0,0 +1,81 @@
+import type { namedTypes as n } from "ast-types";
+import type { SymbolProgram } from "../lib/conjure.js";
+import type { EmissionBuffer } from "./emissions.js";
+import type { SymbolRegistry } from "./symbols.js";
+/**
+ * Reference to a symbol from another file (resolved via SymbolRegistry)
+ */
+export interface SymbolImportRef {
+    readonly kind: "symbol";
+    readonly ref: {
+        readonly capability: string;
+        readonly entity: string;
+        readonly shape?: string;
+    };
+}
+/**
+ * Import from an external package
+ */
+export interface PackageImportRef {
+    readonly kind: "package";
+    readonly names?: readonly string[];
+    readonly types?: readonly string[];
+    readonly default?: string;
+    readonly from: string;
+}
+/**
+ * Import from a relative path (not tracked in SymbolRegistry)
+ */
+export interface RelativeImportRef {
+    readonly kind: "relative";
+    readonly names?: readonly string[];
+    readonly types?: readonly string[];
+    readonly default?: string;
+    readonly from: string;
+}
+/**
+ * All import reference types
+ */
+export type ImportRef = SymbolImportRef | PackageImportRef | RelativeImportRef;
+/**
+ * Fluent builder for constructing files with imports, headers, and AST content
+ */
+export interface FileBuilder {
+    /**
+     * Add a header comment or statements to the file
+     * Can be called multiple times - headers are concatenated
+     */
+    header(content: string | readonly n.Statement[]): FileBuilder;
+    /**
+     * Request an import (resolved after all plugins run)
+     */
+    import(ref: ImportRef): FileBuilder;
+    /**
+     * Add AST content to the file
+     * Can be called multiple times - bodies are concatenated
+     * Extracts symbols from SymbolProgram automatically
+     */
+    ast(program: n.Program | SymbolProgram): FileBuilder;
+    /**
+     * Add raw string content (mutually exclusive with ast())
+     */
+    content(text: string): FileBuilder;
+    /**
+     * Finalize and emit the file
+     * Registers symbols and queues for serialization
+     */
+    emit(): void;
+}
+/**
+ * Create a FileBuilder instance
+ */
+export declare function createFileBuilder(path: string, plugin: string, emissions: EmissionBuffer, symbolRegistry: SymbolRegistry): FileBuilder;
+/**
+ * Factory function type for creating FileBuilders
+ */
+export type FileBuilderFactory = (path: string) => FileBuilder;
+/**
+ * Create a factory that produces FileBuilders with shared context
+ */
+export declare function createFileBuilderFactory(plugin: string, emissions: EmissionBuffer, symbolRegistry: SymbolRegistry): FileBuilderFactory;
+//# sourceMappingURL=file-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-builder.d.ts","sourceRoot":"","sources":["../../src/services/file-builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,IAAI,CAAC,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,cAAc,CAAA;AAM1D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KACxB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAM9E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,SAAS,EAAE,GAAG,WAAW,CAAA;IAE7D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,WAAW,CAAA;IAEnC;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,aAAa,GAAG,WAAW,CAAA;IAEpD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAElC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAA;CACb;AA0BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,cAAc,GAC7B,WAAW,CA2Gb;AAMD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,CAAA;AAE9D;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,cAAc,GAC7B,kBAAkB,CAGpB"}

package/dist/services/file-builder.js

@@ -0,0 +1,112 @@
+/**
+ * FileBuilder - Fluent API for structured file emission
+ *
+ * Provides a builder pattern for constructing files with:
+ * - Header comments
+ * - Import declarations (resolved after all plugins run)
+ * - AST program body with symbol metadata extraction
+ */
+import recast from "recast";
+// =============================================================================
+// Type Guards
+// =============================================================================
+function isSymbolProgram(prog) {
+    return "_tag" in prog && prog._tag === "SymbolProgram";
+}
+/**
+ * Create a FileBuilder instance
+ */
+export function createFileBuilder(path, plugin, emissions, symbolRegistry) {
+    const state = {
+        path,
+        plugin,
+        headers: [],
+        imports: [],
+        statements: [],
+        symbols: [],
+        rawContent: null,
+    };
+    const builder = {
+        header(content) {
+            if (typeof content === "string") {
+                state.headers.push(content);
+            }
+            else {
+                // Convert statements to string via placeholder
+                // For now, just store a marker - actual serialization happens in emit()
+                throw new Error("AST headers not yet implemented - use string headers for now");
+            }
+            return builder;
+        },
+        import(ref) {
+            state.imports.push(ref);
+            return builder;
+        },
+        ast(program) {
+            if (state.rawContent !== null) {
+                throw new Error(`Cannot mix ast() and content() for file ${state.path}`);
+            }
+            if (isSymbolProgram(program)) {
+                // Extract statements and symbols
+                state.statements.push(...program.node.body);
+                state.symbols.push(...program.symbols);
+            }
+            else {
+                // Plain n.Program - just extract statements
+                state.statements.push(...program.body);
+            }
+            return builder;
+        },
+        content(text) {
+            if (state.statements.length > 0) {
+                throw new Error(`Cannot mix content() and ast() for file ${state.path}`);
+            }
+            state.rawContent =
+                state.rawContent !== null ? state.rawContent + text : text;
+            return builder;
+        },
+        emit() {
+            // Register all symbols with file path
+            for (const meta of state.symbols) {
+                const baseSymbol = {
+                    name: meta.name,
+                    file: state.path,
+                    capability: meta.capability,
+                    entity: meta.entity,
+                    isType: meta.isType,
+                    isDefault: meta.isDefault ?? false,
+                };
+                const symbol = meta.shape !== undefined
+                    ? { ...baseSymbol, shape: meta.shape }
+                    : baseSymbol;
+                symbolRegistry.register(symbol, state.plugin);
+            }
+            // Build header string
+            const headerStr = state.headers.length > 0 ? state.headers.join("\n") + "\n" : undefined;
+            if (state.rawContent !== null) {
+                // Raw content mode
+                const fullContent = headerStr
+                    ? headerStr + state.rawContent
+                    : state.rawContent;
+                emissions.emit(state.path, fullContent, state.plugin);
+            }
+            else {
+                // AST mode - create program and emit via emitAst
+                // Import resolution will happen in a later pass
+                const b = recast.types.builders;
+                // Type assertion needed: recast's StatementKind is compatible with n.Statement
+                const program = b.program(state.statements);
+                // Emit AST with imports for resolution during serializeAst
+                emissions.emitAst(state.path, program, state.plugin, headerStr, state.imports.length > 0 ? state.imports : undefined);
+            }
+        },
+    };
+    return builder;
+}
+/**
+ * Create a factory that produces FileBuilders with shared context
+ */
+export function createFileBuilderFactory(plugin, emissions, symbolRegistry) {
+    return (path) => createFileBuilder(path, plugin, emissions, symbolRegistry);
+}
+//# sourceMappingURL=file-builder.js.map

package/dist/services/file-builder.js.map

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

package/dist/services/file-writer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * File Writer Service
+ *
+ * Writes buffered emissions to disk using @effect/platform FileSystem.
+ */
+import { Context, Effect, Layer } from "effect";
+import { FileSystem, Path } from "@effect/platform";
+import type { EmissionEntry } from "./emissions.js";
+import { WriteError } from "../errors.js";
+/**
+ * Result of a write operation
+ */
+export interface WriteResult {
+    readonly path: string;
+    readonly written: boolean;
+    readonly reason?: string;
+}
+/**
+ * Options for writing files
+ */
+export interface WriteOptions {
+    /** Output directory root */
+    readonly outputDir: string;
+    /** Dry run mode - don't actually write, just return what would be written */
+    readonly dryRun?: boolean;
+    /** Header to prepend to generated files */
+    readonly header?: string;
+}
+/**
+ * File writer interface
+ */
+export interface FileWriter {
+    /**
+     * Write all emissions to disk
+     */
+    readonly writeAll: (emissions: readonly EmissionEntry[], options: WriteOptions) => Effect.Effect<readonly WriteResult[], WriteError, FileSystem.FileSystem | Path.Path>;
+}
+declare const FileWriterSvc_base: Context.TagClass<FileWriterSvc, "FileWriter", FileWriter>;
+/**
+ * FileWriter service tag
+ */
+export declare class FileWriterSvc extends FileWriterSvc_base {
+}
+/**
+ * Default generated file header
+ */
+export declare const defaultHeader: (timestamp?: Date) => string;
+/**
+ * Create a file writer
+ */
+export declare function createFileWriter(): FileWriter;
+/**
+ * Live layer - provides the file writer with real filesystem operations
+ */
+export declare const FileWriterLive: Layer.Layer<FileWriterSvc, never, never>;
+export {};
+//# sourceMappingURL=file-writer.d.ts.map

package/dist/services/file-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer.d.ts","sourceRoot":"","sources":["../../src/services/file-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAsB,MAAM,QAAQ,CAAA;AACnE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,SAAS,EAAE,SAAS,aAAa,EAAE,EACnC,OAAO,EAAE,YAAY,KAClB,MAAM,CAAC,MAAM,CAAC,SAAS,WAAW,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;CAC1F;;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,kBAGhC;CAAG;AAEN;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,YAAW,IAAiB,KAAG,MAM5D,CAAA;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAiE7C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,0CAAmD,CAAA"}

package/dist/services/file-writer.js

@@ -0,0 +1,76 @@
+/**
+ * File Writer Service
+ *
+ * Writes buffered emissions to disk using @effect/platform FileSystem.
+ */
+import { Context, Effect, Layer, pipe, Array as Arr } from "effect";
+import { FileSystem, Path } from "@effect/platform";
+import { WriteError } from "../errors.js";
+/**
+ * FileWriter service tag
+ */
+export class FileWriterSvc extends Context.Tag("FileWriter")() {
+}
+/**
+ * Default generated file header
+ */
+export const defaultHeader = (timestamp = new Date()) => `/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ * Generated by pg-sourcerer at ${timestamp.toISOString()}
+ */
+
+`;
+/**
+ * Map a PlatformError to a WriteError
+ */
+const toWriteError = (path) => (err) => new WriteError({
+    message: `File operation failed: ${path} - ${err.message}`,
+    path,
+    cause: err,
+});
+/**
+ * Create a file writer
+ */
+export function createFileWriter() {
+    return {
+        writeAll: (emissions, options) => Effect.gen(function* () {
+            const fs = yield* FileSystem.FileSystem;
+            const pathSvc = yield* Path.Path;
+            const header = options.header ?? defaultHeader();
+            const outputDir = options.outputDir;
+            // Collect unique directories that need to be created
+            const directories = pipe(emissions, Arr.map((e) => pathSvc.dirname(pathSvc.join(outputDir, e.path))), Arr.dedupe);
+            // In dry-run mode, just return what would be written
+            if (options.dryRun) {
+                return pipe(emissions, Arr.map((e) => ({
+                    path: pathSvc.join(outputDir, e.path),
+                    written: false,
+                    reason: "dry-run",
+                })));
+            }
+            // Create directories
+            yield* Effect.forEach(directories, (dir) => fs.makeDirectory(dir, { recursive: true }).pipe(Effect.catchAll((err) => 
+            // Ignore "already exists" errors
+            err._tag === "SystemError" && err.reason === "AlreadyExists"
+                ? Effect.void
+                : Effect.fail(toWriteError(dir)(err)))), { concurrency: 1 } // Sequential to avoid race conditions
+            );
+            // Write files
+            const results = yield* Effect.forEach(emissions, (entry) => {
+                const fullPath = pathSvc.join(outputDir, entry.path);
+                const contentWithHeader = header + entry.content;
+                return fs.writeFileString(fullPath, contentWithHeader).pipe(Effect.map(() => ({
+                    path: fullPath,
+                    written: true,
+                })), Effect.catchAll((err) => Effect.fail(toWriteError(fullPath)(err))));
+            }, { concurrency: 10 } // Parallel file writes
+            );
+            return results;
+        }),
+    };
+}
+/**
+ * Live layer - provides the file writer with real filesystem operations
+ */
+export const FileWriterLive = Layer.succeed(FileWriterSvc, createFileWriter());
+//# sourceMappingURL=file-writer.js.map

package/dist/services/file-writer.js.map

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