@workos/oagen 0.0.1 → 0.1.0

package/README.md

@@ -72,9 +72,7 @@ import {
   diffSpecs,
   generate,
   generateFiles,
-  generateIncremental,
   getEmitter,
-  mapChangesToFiles,
   parseSpec,
   planOperation,
   registerEmitter,
@@ -147,7 +145,7 @@ Start with:
 | `oagen parse`    | Parse a spec and print IR JSON                      |
 | `oagen init`     | Scaffold an emitter project                         |
 | `oagen generate` | Run a registered emitter                            |
-| `oagen diff`     | Review spec changes or incrementally regenerate     |
+| `oagen diff`     | Compare two specs and output a diff report          |
 | `oagen extract`  | Advanced: extract an SDK API surface for compat use |
 | `oagen verify`   | Advanced: smoke-test output and run compat checks   |
 

package/dist/{chunk-P5XUDUGY.js → chunk-VUSRNIG2.js}

@@ -44,10 +44,6 @@ function generateFiles(spec, emitter, options) {
   return { files: applyFileHeaders(files, header), ctx, header };
 }
 
-// src/engine/integrate.ts
-import * as fs2 from "fs";
-import * as path2 from "path";
-
 // src/engine/writer.ts
 import * as fs from "fs/promises";
 import * as path from "path";
@@ -95,11 +91,11 @@ function declarationKey(node) {
 function importEntries(node, source) {
   const entries = [];
   const collect = (spec) => {
-    const path3 = spec.childForFieldName("path")?.text ?? spec.text;
+    const path2 = spec.childForFieldName("path")?.text ?? spec.text;
     const name = spec.childForFieldName("name")?.text ?? "";
     const text = source.slice(spec.startIndex, spec.endIndex);
     entries.push({
-      key: `${name}:${path3.replace(/^"|"$/g, "")}`,
+      key: `${name}:${path2.replace(/^"|"$/g, "")}`,
       text
     });
   };
@@ -896,75 +892,11 @@ async function extractStatements(source, language) {
   const tree = safeParse(parser, source);
   return adapter.parseStatements(tree, source);
 }
-async function mergeIntoExisting(existingContent, generatedContent, language, header, options) {
+async function mergeIntoExisting(existingContent, generatedContent, language, header) {
   const adapter = getMergeAdapter(language);
   if (!adapter) {
     throw new Error(`No merge adapter configured for language "${language}"`);
   }
-  if (options?.docstringOnly) {
-    let result2 = existingContent;
-    let docstringUpdates2 = 0;
-    const parser = await getParser(language);
-    const resultTree = safeParse(parser, result2);
-    const generatedTree = safeParse(parser, generatedContent);
-    const resultDocs = adapter.extractDocstrings(resultTree, result2);
-    const generatedDocs = adapter.extractDocstrings(generatedTree, generatedContent);
-    const ignoredRegions = findIgnoredRegions(result2);
-    const ignoredSymbols = buildIgnoredSymbolNames(resultDocs, ignoredRegions);
-    const headerLine2 = header.trim();
-    const edits = [];
-    for (const [symbolName, genInfo] of generatedDocs) {
-      const existInfo = resultDocs.get(symbolName);
-      if (!existInfo) continue;
-      if (ignoredSymbols.has(symbolName)) continue;
-      const genDoc = genInfo.docstring && genInfo.docstring.text.trim() !== headerLine2 ? genInfo.docstring : null;
-      if (genDoc) {
-        if (existInfo.docstring) {
-          const isPreserved = existInfo.docstring.text.includes("@oagen-ignore");
-          if (!isPreserved && existInfo.docstring.text !== genDoc.text) {
-            edits.push({
-              start: existInfo.docstring.startIndex,
-              end: existInfo.docstring.endIndex,
-              newText: genDoc.text
-            });
-            docstringUpdates2++;
-          }
-        } else {
-          const lineStart = existInfo.declStartIndex - existInfo.declColumn;
-          const indent = " ".repeat(existInfo.declColumn);
-          edits.push({ start: lineStart, end: lineStart, newText: indent + genDoc.text + "\n" });
-          docstringUpdates2++;
-        }
-      }
-      for (const [memberName, genMember] of genInfo.members) {
-        const existMember = existInfo.members.get(memberName);
-        if (!existMember || !genMember.docstring) continue;
-        if (existMember.docstring) {
-          const isPreserved = existMember.docstring.text.includes("@oagen-ignore");
-          if (!isPreserved && existMember.docstring.text !== genMember.docstring.text) {
-            edits.push({
-              start: existMember.docstring.startIndex,
-              end: existMember.docstring.endIndex,
-              newText: genMember.docstring.text
-            });
-            docstringUpdates2++;
-          }
-        } else {
-          const lineStart = existMember.declStartIndex - existMember.declColumn;
-          const indent = " ".repeat(existMember.declColumn);
-          edits.push({ start: lineStart, end: lineStart, newText: indent + genMember.docstring.text + "\n" });
-          docstringUpdates2++;
-        }
-      }
-    }
-    if (edits.length > 0) {
-      edits.sort((a, b) => b.start - a.start);
-      for (const edit of edits) {
-        result2 = result2.slice(0, edit.start) + edit.newText + result2.slice(edit.end);
-      }
-    }
-    return { content: result2, added: 0, preserved: 0, changed: docstringUpdates2 > 0 };
-  }
   const existingStatements = await extractStatements(existingContent, language);
   const generatedStatements = await extractStatements(generatedContent, language);
   const existingKeys = /* @__PURE__ */ new Set();
@@ -1237,22 +1169,6 @@ async function writeFiles(files, outputDir, options) {
     }
     if (language && hasGrammar(language)) {
       try {
-        if (file.mergeMode === "docstring-only") {
-          const mergeResult2 = await mergeIntoExisting(existingContent, file.content, language, header, {
-            docstringOnly: true
-          });
-          let finalContent2 = mergeResult2.content;
-          if (header && !finalContent2.startsWith(header)) {
-            finalContent2 = header + "\n\n" + finalContent2;
-          }
-          if (finalContent2 === existingContent) {
-            result.identical.push(file.path);
-          } else {
-            await fs.writeFile(fullPath, finalContent2, "utf-8");
-            result.merged.push(file.path);
-          }
-          continue;
-        }
         const mergeResult = await mergeIntoExisting(existingContent, file.content, language, header);
         let finalContent = mergeResult.content;
         if (header && !finalContent.startsWith(header)) {
@@ -1280,22 +1196,20 @@ async function writeFiles(files, outputDir, options) {
 }
 
 // src/engine/integrate.ts
-function mapFilesForTargetIntegration(files, language, targetDir) {
+function mapFilesForTargetIntegration(files, language) {
   const langPrefix = `${language}/`;
   return files.filter((f) => f.integrateTarget !== false).map((f) => {
     const stripped = f.path.startsWith(langPrefix) ? f.path.replace(langPrefix, "") : f.path;
-    const existsInTarget = targetDir ? fs2.existsSync(path2.join(targetDir, stripped)) : false;
     return {
       ...f,
       skipIfExists: false,
       // Always merge in target — never hard-skip
-      mergeMode: existsInTarget ? "docstring-only" : "full",
       path: stripped
     };
   });
 }
 async function integrateGeneratedFiles(opts) {
-  return writeFiles(mapFilesForTargetIntegration(opts.files, opts.language, opts.targetDir), opts.targetDir, {
+  return writeFiles(mapFilesForTargetIntegration(opts.files, opts.language), opts.targetDir, {
     language: opts.language,
     header: opts.header
   });
@@ -1734,7 +1648,6 @@ function summarize(changes) {
 }
 
 export {
-  writeFiles,
   buildEmitterContext,
   generateAllFiles,
   applyFileHeaders,