openapi-sync 5.0.6 → 6.0.0

package/bin/cli.js

@@ -1,39 +1,366 @@
 #!/usr/bin/env node
 
+// ──────────────────────────────────────────────────────────────────────────────
+// openapi-sync CLI
+//
+// AGENT USAGE GUIDE
+// -----------------
+// All commands support `--json` for machine-readable stdout and `--silent` to
+// suppress progress logs. Exit codes: 0 = success, 1 = config error,
+// 2 = network/spec error, 3 = generation error.
+//
+// Non-interactive init (no prompts, safe for agents):
+//   npx openapi-sync init --no-interactive \
+//     --api-name petstore \
+//     --api-url https://petstore3.swagger.io/api/v3/openapi.json \
+//     --output-folder ./src/api \
+//     --client-type react-query \
+//     --validation-library zod \
+//     --config-format typescript
+//
+// Validate config and specs without writing files:
+//   npx openapi-sync validate --json
+//
+// List all endpoints:
+//   npx openapi-sync list-endpoints --json
+//
+// Sync (generate types + endpoints + validation schemas):
+//   npx openapi-sync --json
+//
+// Generate a typed API client:
+//   npx openapi-sync generate-client --type react-query --json
+// ──────────────────────────────────────────────────────────────────────────────
+
 const OpenApisync = require("../dist/index");
 
 const yargs = require("yargs/yargs");
 const { hideBin } = require("yargs/helpers");
 
-// Setup yargs with commands
-const argv = yargs(hideBin(process.argv))
+// ── Output helpers ───────────────────────────────────────────────────────────
+
+/**
+ * Write a JSON result to stdout and exit with the appropriate code.
+ * Used when --json flag is present.
+ */
+function jsonExit(data, exitCode = 0) {
+  process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+  process.exit(exitCode);
+}
+
+/**
+ * Determine the exit code from a SyncResult or ValidationResult.
+ */
+function exitCodeFromResult(result) {
+  if (result.success === false || result.valid === false) return 1;
+  if (result.errors && result.errors.length > 0) return 1;
+  return 0;
+}
+
+// ── CLI definition ────────────────────────────────────────────────────────────
+
+yargs(hideBin(process.argv))
+  // ── Global flags ──────────────────────────────────────────────────────────
+  .option("json", {
+    type: "boolean",
+    global: true,
+    description:
+      "Emit a single JSON object to stdout instead of human-readable logs. " +
+      "Use this when calling from scripts or AI agents.",
+    default: false,
+  })
+  .option("silent", {
+    type: "boolean",
+    global: true,
+    description: "Suppress all console output (implied by --json).",
+    default: false,
+  })
+
+  // ── `init` command ─────────────────────────────────────────────────────────
   .command(
     "init",
-    "Interactive setup wizard to create configuration",
+    "Create an openapi.sync config file (interactive or non-interactive)",
+    (yargs) => {
+      return yargs
+        .option("no-interactive", {
+          alias: "y",
+          type: "boolean",
+          description:
+            "Skip all prompts and create config from flags + defaults. " +
+            "Use this from scripts or AI agents.",
+          default: false,
+        })
+        // All wizard fields available as flags so agents can pass everything:
+        .option("api-name", {
+          type: "string",
+          description: "Name for this API (e.g. petstore)",
+        })
+        .option("api-url", {
+          type: "string",
+          description: "URL to the OpenAPI spec (JSON or YAML)",
+        })
+        .option("api-file", {
+          type: "string",
+          description: "Path to a local OpenAPI spec file",
+        })
+        .option("output-folder", {
+          type: "string",
+          description: "Output folder for generated files",
+          default: "./src/api",
+        })
+        .option("config-format", {
+          type: "string",
+          choices: ["typescript", "json", "javascript"],
+          description: "Config file format",
+          default: "typescript",
+        })
+        .option("client-type", {
+          type: "string",
+          choices: ["react-query", "swr", "fetch", "axios", "rtk-query"],
+          description: "API client type to generate",
+        })
+        .option("validation-library", {
+          type: "string",
+          choices: ["zod", "yup", "joi"],
+          description: "Runtime validation library",
+        })
+        .option("folder-split", {
+          type: "boolean",
+          description: "Organize generated code into folders by OpenAPI tags",
+          default: false,
+        })
+        .option("types-prefix", {
+          type: "string",
+          description: "Prefix for generated TypeScript interface names",
+          default: "I",
+        })
+        .option("use-operation-id", {
+          type: "boolean",
+          description: "Use operationId from spec for type/function names",
+          default: true,
+        })
+        .option("exclude-tags", {
+          type: "string",
+          description: "Comma-separated tags to exclude (e.g. deprecated,internal)",
+        })
+        .option("show-curl", {
+          type: "boolean",
+          description: "Include cURL examples in generated docs",
+          default: true,
+        })
+        .option("refetch-interval", {
+          type: "number",
+          description: "Auto-refetch interval in ms (0 to disable)",
+          default: 0,
+        })
+        .option("run-sync", {
+          type: "boolean",
+          description: "Run initial sync after creating config",
+          default: false,
+        })
+        .example(
+          "$0 init",
+          "Interactive wizard (human use)"
+        )
+        .example(
+          "$0 init --no-interactive --api-name petstore --api-url https://petstore3.swagger.io/api/v3/openapi.json",
+          "Non-interactive setup (agent use)"
+        )
+        .example(
+          "$0 init --no-interactive --api-name myapi --api-url https://api.example.com/openapi.json --client-type react-query --validation-library zod --json",
+          "Full non-interactive setup with JSON output"
+        );
+    },
+    async (argv) => {
+      const noInteractive = argv["no-interactive"] || argv.y;
+
+      if (noInteractive) {
+        // ── Non-interactive path (agent-safe) ─────────────────────────────
+        const silent = argv.silent || argv.json;
+
+        const apiName = argv["api-name"] || "myapi";
+        const apiSource = argv["api-url"] || argv["api-file"];
+
+        if (!apiSource) {
+          const err = {
+            success: false,
+            error: {
+              code: "CONFIG_INVALID",
+              message:
+                "You must provide --api-url or --api-file when using --no-interactive.",
+            },
+          };
+          if (argv.json) return jsonExit(err, 1);
+          console.error(`❌ ${err.error.message}`);
+          process.exit(1);
+        }
+
+        const { nonInteractiveInit } = require("../dist/Openapi-sync/interactive-init");
+
+        const result = await nonInteractiveInit({
+          apiName,
+          apiSource,
+          outputFolder: argv["output-folder"],
+          configFormat: argv["config-format"],
+          clientType: argv["client-type"],
+          validationLibrary: argv["validation-library"],
+          folderSplit: argv["folder-split"],
+          typesPrefix: argv["types-prefix"],
+          useOperationId: argv["use-operation-id"],
+          excludeTags: argv["exclude-tags"]
+            ? argv["exclude-tags"].split(",").map((t) => t.trim())
+            : [],
+          showCurl: argv["show-curl"],
+          refetchInterval: argv["refetch-interval"] || undefined,
+          runSync: argv["run-sync"],
+          silent,
+        });
+
+        if (argv.json) {
+          return jsonExit(result, result.success ? 0 : 1);
+        }
+      } else {
+        // ── Interactive wizard path (human use) ───────────────────────────
+        await OpenApisync.InteractiveInit();
+      }
+    }
+  )
+
+  // ── `validate` command ─────────────────────────────────────────────────────
+  .command(
+    "validate",
+    "Validate the config file and all API specs without writing any files. " +
+      "Safe to run repeatedly — no side effects.",
     () => {},
-    async () => {
-      await OpenApisync.InteractiveInit();
+    async (argv) => {
+      const silent = argv.silent || argv.json;
+
+      const result = await OpenApisync.ValidateConfig({ silent });
+
+      if (argv.json) {
+        return jsonExit(result, result.valid ? 0 : 1);
+      }
+
+      process.exit(result.valid ? 0 : 1);
     }
   )
+
+  // ── `list-endpoints` command ───────────────────────────────────────────────
   .command(
-    ["$0", "sync"],
-    "Sync OpenAPI specifications and generate types",
+    "list-endpoints",
+    "List all endpoints discovered from your OpenAPI specs. No files are written.",
     (yargs) => {
-      return yargs.option("refreshinterval", {
-        alias: "ri",
-        type: "number",
-        description: "Interval at which to refetch specifications",
+      return yargs
+        .option("api", {
+          alias: "a",
+          type: "string",
+          description: "Limit to a specific API from your config",
+        })
+        .option("tags", {
+          type: "string",
+          description: "Comma-separated tags to filter by",
+        })
+        .example("$0 list-endpoints --json", "List all endpoints as JSON")
+        .example(
+          "$0 list-endpoints --api petstore --tags pet --json",
+          "List pet-tagged endpoints for petstore"
+        );
+    },
+    async (argv) => {
+      const silent = argv.silent || argv.json;
+      const tags = argv.tags
+        ? argv.tags.split(",").map((t) => t.trim())
+        : undefined;
+
+      const result = await OpenApisync.ListEndpoints({
+        apiName: argv.api,
+        tags,
+        silent,
       });
+
+      if (argv.json) {
+        return jsonExit(result, 0);
+      }
+
+      // Human-readable output
+      for (const [api, endpoints] of Object.entries(result)) {
+        console.log(`\n📋 ${api} (${endpoints.length} endpoints)`);
+        for (const ep of endpoints) {
+          const tags = ep.tags?.length ? `  [${ep.tags.join(", ")}]` : "";
+          console.log(`  ${ep.method.padEnd(7)} ${ep.path}${tags}`);
+          if (ep.summary) console.log(`           ${ep.summary}`);
+        }
+      }
+    }
+  )
+
+  // ── `sync` / default command ───────────────────────────────────────────────
+  .command(
+    ["$0", "sync"],
+    "Sync OpenAPI specifications and generate types, endpoints, and validation schemas",
+    (yargs) => {
+      return yargs
+        .option("refreshinterval", {
+          alias: "ri",
+          type: "number",
+          description: "Interval in ms to auto-refetch specifications",
+        })
+        .option("dry-run", {
+          type: "boolean",
+          description:
+            "Show what files would be written without actually writing them",
+          default: false,
+        })
+        .example("$0", "Sync all APIs")
+        .example("$0 --json", "Sync and emit JSON result")
+        .example("$0 --dry-run --json", "Preview what would be written");
     },
-    (argv) => {
-      OpenApisync.Init({
+    async (argv) => {
+      if (argv["dry-run"]) {
+        // Dry-run: validate first to count endpoints, then report what would be written
+        const silent = argv.silent || argv.json;
+        const validation = await OpenApisync.ValidateConfig({ silent });
+
+        const dryRunResult = {
+          dryRun: true,
+          valid: validation.valid,
+          apis: validation.apis,
+          message: validation.valid
+            ? "Dry run complete. Run without --dry-run to write files."
+            : "Validation failed. Fix errors before syncing.",
+        };
+
+        if (argv.json) {
+          return jsonExit(dryRunResult, validation.valid ? 0 : 1);
+        }
+
+        if (validation.valid) {
+          console.log("\n✅ Dry run: config and specs are valid.");
+          console.log("   Run without --dry-run to write files.\n");
+        } else {
+          console.error("\n❌ Dry run: validation failed — see errors above.\n");
+          process.exit(1);
+        }
+        return;
+      }
+
+      const silent = argv.silent || argv.json;
+      const result = await OpenApisync.Init({
         refetchInterval: argv.refreshinterval,
+        silent,
       });
+
+      if (argv.json) {
+        return jsonExit(result, exitCodeFromResult(result));
+      }
+
+      if (!result.success) process.exit(1);
     }
   )
+
+  // ── `generate-client` command ──────────────────────────────────────────────
   .command(
     "generate-client",
-    "Generate API client from OpenAPI specification",
+    "Generate a type-safe API client from your OpenAPI specs",
     (yargs) => {
       return yargs
         .option("type", {
@@ -68,17 +395,22 @@ const argv = yargs(hideBin(process.argv))
           type: "string",
           description: "Base URL for API requests",
         })
+        .option("dry-run", {
+          type: "boolean",
+          description: "Show what files would be written without writing them",
+          default: false,
+        })
         .example(
-          "$0 generate-client --type fetch",
-          "Generate fetch client for all APIs"
+          "$0 generate-client --type fetch --json",
+          "Generate fetch client and emit JSON result"
         )
         .example(
           "$0 generate-client --type react-query --api petstore",
-          "Generate React Query hooks for petstore API"
+          "Generate React Query hooks for petstore"
         )
         .example(
           "$0 generate-client --type axios --tags pets,users",
-          "Generate axios client for endpoints with pets or users tags"
+          "Generate axios client filtered by tags"
         )
         .example(
           "$0 generate-client --type swr --endpoints getPetById,createPet",
@@ -86,26 +418,63 @@ const argv = yargs(hideBin(process.argv))
         );
     },
     async (argv) => {
-      // First, sync API specs and generate types/endpoints
-      console.log("🔄 Syncing API specifications first...\n");
-      await OpenApisync.Init();
+      if (argv["dry-run"]) {
+        // Validate and list what would be generated
+        const silent = argv.silent || argv.json;
+        const endpoints = await OpenApisync.ListEndpoints({
+          apiName: argv.api,
+          tags: argv.tags,
+          silent,
+        });
+        const dryRunResult = {
+          dryRun: true,
+          type: argv.type,
+          apis: endpoints,
+          message: `Would generate a ${argv.type} client. Run without --dry-run to write files.`,
+        };
+        if (argv.json) return jsonExit(dryRunResult, 0);
+        console.log(`\n✅ Dry run: would generate ${argv.type} client.`);
+        for (const [api, eps] of Object.entries(endpoints)) {
+          console.log(`   ${api}: ${eps.length} endpoints`);
+        }
+        return;
+      }
 
-      console.log("\n🚀 Now generating client...\n");
+      // First sync to get fresh types
+      const silent = argv.silent || argv.json;
+      const silent2 = silent;
+      await OpenApisync.Init({ silent: silent2 });
 
-      // Then generate the client
-      await OpenApisync.GenerateClient({
+      const result = await OpenApisync.GenerateClient({
         type: argv.type,
         apiName: argv.api,
         tags: argv.tags,
         endpoints: argv.endpoints,
         outputDir: argv.output,
         baseURL: argv["base-url"],
+        silent,
       });
+
+      if (argv.json) {
+        return jsonExit(result, exitCodeFromResult(result));
+      }
+
+      if (!result.success) process.exit(1);
     }
   )
-  .example("$0 init", "Start interactive setup wizard")
-  .example("$0", "Sync API types and endpoints")
-  .example("$0 --refreshinterval 10000", "Sync with 10s refresh interval")
+
+  .example("$0 init", "Interactive setup wizard (human)")
+  .example(
+    "$0 init --no-interactive --api-name petstore --api-url https://petstore3.swagger.io/api/v3/openapi.json",
+    "Non-interactive init (agent)"
+  )
+  .example("$0 validate --json", "Validate config + specs (no file writes)")
+  .example("$0 list-endpoints --json", "List all endpoints as JSON")
+  .example("$0 --json", "Sync and get JSON result")
+  .example(
+    "$0 generate-client --type react-query --json",
+    "Generate React Query hooks with JSON output"
+  )
   .help()
   .alias("help", "h")
   .version()

package/bin/mcp.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+/**
+ * openapi-sync MCP Server entry point.
+ *
+ * Starts the Model Context Protocol server over stdio so that AI agents
+ * (Claude Desktop, Cursor, Copilot, etc.) can call openapi-sync operations
+ * as structured tool invocations.
+ *
+ * Usage — add to Claude Desktop config
+ * (~/ Library/Application Support/Claude/claude_desktop_config.json):
+ *
+ *   {
+ *     "mcpServers": {
+ *       "openapi-sync": {
+ *         "command": "npx",
+ *         "args": ["-y", "openapi-sync-mcp"],
+ *         "cwd": "/path/to/your/project"
+ *       }
+ *     }
+ *   }
+ *
+ * Usage — add to Cursor config (.cursor/mcp.json in project root):
+ *
+ *   {
+ *     "mcpServers": {
+ *       "openapi-sync": {
+ *         "command": "npx",
+ *         "args": ["-y", "openapi-sync-mcp"],
+ *         "cwd": "${workspaceFolder}"
+ *       }
+ *     }
+ *   }
+ */
+
+require("../dist/mcp/server.js");

package/dist/chunk-3VKPQNDD.mjs

@@ -0,0 +1,22 @@
+import {d,f}from'./chunk-VLACEFT4.mjs';import F from'prompts';import s from'fs';import a from'path';function k(){return f(this,null,function*(){try{let e=yield F([{type:"select",name:"configFormat",message:"What configuration format would you like to use?",choices:[{title:"TypeScript (openapi.sync.ts)",value:"typescript"},{title:"JSON (openapi.sync.json)",value:"json"},{title:"JavaScript (openapi.sync.js)",value:"javascript"}],initial:0},{type:"select",name:"apiSource",message:"Where is your OpenAPI specification?",choices:[{title:"URL (e.g., https://api.example.com/openapi.json)",value:"url"},{title:"Local file",value:"file"}],initial:0},{type:t=>t==="url"?"text":null,name:"apiUrl",message:"Enter the OpenAPI specification URL:",validate:t=>t.startsWith("http://")||t.startsWith("https://")?!0:"Please enter a valid URL starting with http:// or https://"},{type:(t,c)=>c.apiSource==="file"?"text":null,name:"apiFile",message:"Enter the path to your OpenAPI file:",validate:t=>t.trim()!==""?!0:"Please enter a valid file path"},{type:"text",name:"apiName",message:"What would you like to name this API?",initial:"myapi",validate:t=>/^[a-zA-Z0-9_-]+$/.test(t)?!0:"API name must contain only letters, numbers, hyphens, and underscores"},{type:"text",name:"outputFolder",message:"Where should generated files be saved?",initial:"./src/api",validate:t=>{if(!t||t.trim()==="")return "Output folder cannot be empty";let c=a.normalize(t);if(c==="/"||c==="C:\\"||c==="\\")return "Cannot use filesystem root directory. Please use a project subfolder like './src/api'";if(a.isAbsolute(t)){let m=process.cwd();if(!t.startsWith(m))return "\u26A0\uFE0F  Warning: Using absolute path outside project directory. Recommended: use relative path like './src/api'"}return !0}},{type:"confirm",name:"enableFolderSplit",message:"Organize generated code into folders by OpenAPI tags?",initial:!1},{type:"confirm",name:"generateClient",message:"Generate API client code?",initial:!0},{type:t=>t?"select":null,name:"clientType",message:"Which client type would you like?",choices:[{title:"React Query (Recommended for React)",value:"react-query"},{title:"RTK Query (Redux Toolkit)",value:"rtk-query"},{title:"SWR",value:"swr"},{title:"Fetch API",value:"fetch"},{title:"Axios",value:"axios"}],initial:0},{type:"confirm",name:"enableValidation",message:"Enable runtime validation schemas?",initial:!0},{type:t=>t?"select":null,name:"validationLibrary",message:"Which validation library?",choices:[{title:"Zod (Recommended)",value:"zod"},{title:"Yup",value:"yup"},{title:"Joi",value:"joi"}],initial:0},{type:"confirm",name:"enableCustomCode",message:"Enable custom code preservation?",initial:!0},{type:"confirm",name:"typesUseOperationId",message:"Use operationId from OpenAPI spec for type names?",initial:!0},{type:"text",name:"typesPrefix",message:"Prefix for TypeScript interface names (leave empty for none):",initial:"I"},{type:"confirm",name:"excludeEndpointsByTags",message:"Exclude endpoints by tags (e.g., deprecated, internal)?",initial:!1},{type:t=>t?"text":null,name:"excludeTags",message:"Enter tags to exclude (comma-separated):",initial:"deprecated,internal"},{type:"confirm",name:"showCurlInDocs",message:"Include cURL examples in generated documentation?",initial:!0},{type:"number",name:"refetchInterval",message:"Refetch interval in milliseconds (0 to disable auto-refresh):",initial:5e3,min:0},{type:"confirm",name:"runSync",message:"Run initial sync after setup?",initial:!0}],{onCancel:()=>{throw r||process.exit(0),new Error("Setup cancelled")}}),n={refetchInterval:e.refetchInterval||void 0,folder:e.outputFolder,api:{[e.apiName]:e.apiUrl||e.apiFile}};e.enableFolderSplit&&(n.folderSplit={byTags:!0}),n.types={name:{prefix:e.typesPrefix||"",useOperationId:e.typesUseOperationId}},n.endpoints={name:{useOperationId:e.typesUseOperationId},doc:{showCurl:e.showCurlInDocs}},e.excludeEndpointsByTags&&e.excludeTags&&(n.endpoints.exclude={tags:e.excludeTags.split(",").map(t=>t.trim())}),e.generateClient&&e.clientType&&(n.clientGeneration={enabled:!0,type:e.clientType,outputDir:a.join(e.outputFolder,e.apiName,"client")},e.clientType==="react-query"?n.clientGeneration.reactQuery={version:5,mutations:!0}:e.clientType==="swr"&&(n.clientGeneration.swr={mutations:!0})),e.enableValidation&&e.validationLibrary&&(n.validations={library:e.validationLibrary}),e.enableCustomCode&&(n.customCode={enabled:!0,position:"bottom"});let g,i;e.configFormat==="json"?(i="openapi.sync.json",g=JSON.stringify(n,null,2)):e.configFormat==="typescript"?(i="openapi.sync.ts",g=`import { IConfig } from "openapi-sync";
+
+const config: IConfig = ${JSON.stringify(n,null,2)};
+
+export default config;
+`):(i="openapi.sync.js",g=`module.exports = ${JSON.stringify(n,null,2)};
+`);let d=a.join(process.cwd(),i);if(s.existsSync(d)&&!(yield F({type:"confirm",name:"value",message:`${i} already exists. Overwrite?`,initial:!1})).value)throw r||process.exit(0),new Error("Configuration file not created");s.writeFileSync(d,g,"utf-8"),r||`${i}`;let l=a.isAbsolute(e.outputFolder)?e.outputFolder:a.join(process.cwd(),e.outputFolder);if(!s.existsSync(l))try{s.mkdirSync(l,{recursive:!0}),r||`${e.outputFolder}`;}catch(t){r||`${t.message}`;}let y=a.join(process.cwd(),".gitignore");if(s.existsSync(y)&&(s.readFileSync(y,"utf-8").includes(e.outputFolder)||s.appendFileSync(y,`
+# OpenAPI Sync generated files
+${e.outputFolder}
+`)),r||(`${i}`,e.generateClient&&e.clientType&&(e.clientType==="axios"||e.clientType==="react-query"||e.clientType==="swr"||e.clientType),e.enableValidation&&e.validationLibrary&&(e.generateClient,`${e.validationLibrary}`)),e.runSync&&!r)try{let{Init:t,GenerateClient:c}=yield import('./index.mjs');yield t({refetchInterval:e.refetchInterval}),e.generateClient&&e.clientType&&(yield c({type:e.clientType,apiName:e.apiName}));}catch(t){console.error(`
+\u274C Error during sync:`,t.message),t.stack&&process.env.DEBUG&&console.error(t.stack);}else r||(e.generateClient||e.enableValidation,e.generateClient&&e.clientType&&(e.generateClient||e.enableValidation,`${e.clientType}`));r||(`${e.outputFolder}${e.apiName}`,e.generateClient&&`${e.outputFolder}${e.apiName}`,e.generateClient&&e.clientType&&`${e.clientType}`);}catch(e){throw r||(console.error(`
+\u274C Error during setup:`,e.message),process.exit(1)),e}})}function G(e){return f(this,null,function*(){let{apiName:n,apiSource:g,outputFolder:i="./src/api",configFormat:d="typescript",clientType:l,validationLibrary:y,folderSplit:t=false,typesPrefix:c="I",useOperationId:m=true,excludeTags:I=[],showCurl:T=true,refetchInterval:v,runSync:O=false,silent:w=false}=e,h=w?{log:()=>{},warn:()=>{},error:()=>{}}:{log:console.log,warn:console.warn,error:console.error},u=[],o={folder:i,api:{[n]:g}};v&&v>0&&(o.refetchInterval=v),t&&(o.folderSplit={byTags:true}),o.types={name:{prefix:c,useOperationId:m}},o.endpoints={name:{useOperationId:m},doc:{showCurl:T}},I.length>0&&(o.endpoints.exclude={tags:I}),l&&(o.clientGeneration={enabled:true,type:l,outputDir:a.join(i,n,"client")},l==="react-query"?o.clientGeneration.reactQuery={version:5,mutations:true}:l==="swr"&&(o.clientGeneration.swr={mutations:true})),y&&(o.validations={library:y}),o.customCode={enabled:true,position:"bottom"};let b,p;d==="json"?(p="openapi.sync.json",b=JSON.stringify(o,null,2)):d==="typescript"?(p="openapi.sync.ts",b=`import { IConfig } from "openapi-sync";
+
+const config: IConfig = ${JSON.stringify(o,null,2)};
+
+export default config;
+`):(p="openapi.sync.js",b=`module.exports = ${JSON.stringify(o,null,2)};
+`);let P=a.join(process.cwd(),p);try{s.writeFileSync(P,b,"utf-8"),h.log(`
+\u2705 Config written: ${p}`);}catch(f){return u.push(`Failed to write config: ${f.message}`),{success:false,configFile:p,message:"Config write failed.",errors:u}}let C=a.isAbsolute(i)?i:a.join(process.cwd(),i);if(!s.existsSync(C))try{s.mkdirSync(C,{recursive:!0});}catch(f){}if(O){h.log(`
+\u{1F504} Running initial sync...`);try{let{Init:f,GenerateClient:j}=yield import('./index.mjs');yield f({silent:w}),l&&(yield j({type:l,apiName:n,silent:w})),h.log("\u2705 Sync complete.");}catch(f){u.push(`Sync failed: ${f.message}`);}}let S=u.length===0?`Config created: ${p}. Run \`npx openapi-sync\` to generate types.`:`Config created with errors (${u.length}).`;return h.log(`
+${S}
+`),{success:u.length===0,configFile:p,message:S,errors:u}})}var r,N=d(()=>{r=process.env.NODE_ENV==="test"||process.env.JEST_WORKER_ID!==void 0;});export{k as a,G as b,N as c};

package/dist/chunk-L52BXDAC.mjs

@@ -0,0 +1,24 @@
+import {d}from'./chunk-VLACEFT4.mjs';import*as f from'js-yaml';var N,y,G=d(()=>{N=/^[A-Za-z_$][A-Za-z0-9_$]*$/,y=/[A-Za-z0-9_$]/;});function J(t,a){return a.split(".").reduce((r,n)=>r&&r[n]!==void 0?r[n]:void 0,t)}var w,M,z,E,D,k,I,O,T,C,U,B=d(()=>{G();w=t=>["object"].includes(typeof t)&&!(t instanceof Blob),M=t=>{try{return f.load(t),!0}catch(a){let o=a;if(o instanceof f.YAMLException)return  false;throw o}},z=t=>{if(M(t)){let a=f.load(t),o=JSON.stringify(a,null,2);return JSON.parse(o)}},E=t=>t.substring(0,1).toUpperCase()+t.substring(1),D=(t,a)=>{let o=t.split("/"),r=`${E(a)}`,n=[];return o.forEach(s=>{if(s[0]==="{"&&s[s.length-1]==="}"){let e=s.replace(/{/,"").replace(/}/,"");n.push(e),s=`$${e}`;}else if(s[0]==="<"&&s[s.length-1]===">"){let e=s.replace(/</,"").replace(/>/,"");n.push(e),s=`$${e}`;}else if(s[0]===":"){let e=s.replace(/:/,"");n.push(e),s=`$${e}`;}let c="";s.split("").forEach(e=>{let i=e;y.test(e)||(i="/"),c+=i;}),c.split("/").forEach(e=>{r+=E(e);});}),{name:r,variables:n,pathParts:o}},k=(t,a=1)=>{let o="{",r=Object.keys(t);for(let n=0;n<r.length;n++){let s=r[n],c=t[s];if(o+=`
+`+"    ".repeat(a)+s+": ",Array.isArray(c)){o+="[";for(let e=0;e<c.length;e++){let i=c[e];typeof i=="object"&&i!==null?o+=k(i,a+1):o+=typeof i=="string"?`"${i}"`:i,e<c.length-1&&(o+=", ");}o+="]";}else typeof c=="object"&&c!==null?o+=""+k(c,a+1):o+=c.split(`
+`).filter(e=>e.trim()!=="").join(`
+${"    ".repeat(a)}`);n<r.length-1&&(o+=", ");}return o+=`
+${"    ".repeat(a-1)}}`,o},I=(t,a=1)=>{let o=t.replace(/\/\*\*?[\s\S]*?\*\//g,r=>r.replace(/^\/\*\*?\s*/,"").replace(/\s*\*\/$/,"").split(`
+`).map(s=>s.replace(/^\s*\*\s?/,"").trim()).filter(s=>s.length>0).map(s=>`// ${s}`).join(`
+`));return `
+\`\`\`typescript
+${"  ".repeat(a)}  ${o.split(`
+`).filter(r=>r.trim()!=="").join(`
+${"  ".repeat(a)}  `)}
+\`\`\``};O=(t,a="CUSTOM CODE")=>{let r=["//","#"].map(e=>({start:`${e} \u{1F512} ${a} START`,end:`${e} \u{1F512} ${a} END`})),n={beforeGenerated:"",afterGenerated:""},s=0,c=[];for(;s<t.length;){let e=null,i=-1;for(let d of r){let b=t.indexOf(d.start,s);b!==-1&&(i===-1||b<i)&&(i=b,e=d);}if(i===-1||!e)break;let p=t.indexOf(e.end,i);if(p===-1)break;let l=p+e.end.length,$=t.substring(l,l+100),u=$.match(/^\s*\n\s*((?:\/\/|#)\s*=+)/);if(u){let d=$.indexOf(`
+`,u.index+1);d!==-1?l+=d+1:l+=u[0].length;}let g=i,S=t.substring(Math.max(0,i-200),i),A=/(^|\n)\s*(?:\/\/|#)\s*=+/g,h,m=-1;for(;(h=A.exec(S))!==null;)m=h.index+h[1].length;m!==-1&&(g=Math.max(0,i-200)+m);let j=t.substring(g,l);c.push({start:g,end:l,content:j}),s=l;}return c.length>0&&(t.substring(0,c[0].start).split(`
+`).filter(p=>{let l=p.trim();return l.length>0&&!l.startsWith("//")&&!l.startsWith("#")}).join("").length===0?(n.beforeGenerated=c[0].content,c.length>1&&(n.afterGenerated=c[1].content)):(n.afterGenerated=c[0].content,c.length>1&&!n.beforeGenerated&&(n.beforeGenerated=c[1].content))),n},T=(t,a="CUSTOM CODE",o=true,r="//")=>{let n=o?`${r} ${t==="top"?"Add your custom code below this line":"Add your custom code above this line"}
+${r} This section will be preserved during regeneration
+`:"";return `${r} ${"=".repeat(60)}
+${r} \u{1F512} ${a} START
+${n}${r} ${"=".repeat(60)}
+
+${r} \u{1F512} ${a} END
+${r} ${"=".repeat(60)}`},C=(t,a,o)=>{if(!t)return t;let r=new RegExp(`^\\s*//\\s*(?:={3,}|\u{1F512}\\s+${a}\\s+(?:START|END)|Add your custom code (?:below|above) this line|This section will be preserved during regeneration)\\s*$`);return t.split(`
+`).map(n=>r.test(n)?n.replace(/^\s*\/\//,o):n).join(`
+`)},U=(t,a,o={})=>{let{position:r="bottom",markerText:n="CUSTOM CODE",includeInstructions:s=true,commentPrefix:c="//"}=o,e={beforeGenerated:"",afterGenerated:""};a&&(e=O(a,n),e.beforeGenerated=C(e.beforeGenerated,n,c),e.afterGenerated=C(e.afterGenerated,n,c)),!e.beforeGenerated&&!e.afterGenerated&&((r==="top"||r==="both")&&(e.beforeGenerated=T("top",n,s,c)),(r==="bottom"||r==="both")&&(e.afterGenerated=T("bottom",n,s,c)));let i=[];return e.beforeGenerated&&(i.push(e.beforeGenerated),i.push("")),i.push(t),e.afterGenerated&&(i.push(""),i.push(e.afterGenerated)),i.join(`
+`)};});export{N as a,y as b,G as c,w as d,M as e,z as f,E as g,D as h,k as i,I as j,J as k,O as l,T as m,U as n,B as o};