@sdk-it/vite 0.46.10 → 0.47.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -20,23 +20,29 @@ export default defineConfig({
20
20
  sdkIt('./openapi.yaml', {
21
21
  output: './src/sdk',
22
22
  name: 'Example',
23
+ packageName: '@acme/example-client',
23
24
  mode: 'minimal',
24
25
  }),
25
26
  ],
26
27
  });
27
28
  ```
28
29
 
29
- Relative paths are resolved from Vite's project root. Local specification
30
- files are watched during development, and generation also runs at build
31
- start. You can pass an OpenAPI object or a function that resolves to an
32
- OpenAPI object or local path instead.
30
+ The settings are the options of `generate` from `@sdk-it/typescript`, so `name`
31
+ and `packageName` are required.
32
+
33
+ Relative paths are resolved from Vite's project root. Generation runs at build
34
+ start. During development, the plugin watches the specification file and each
35
+ local file that it refers to through `$ref`. When one of these files changes,
36
+ the plugin generates the SDK again. You can pass an OpenAPI object or a
37
+ function that resolves to an OpenAPI object or local path instead.
33
38
 
34
39
  ## Use a TypeScript backend project
35
40
 
36
- First initialize the SDK-IT project workflow:
41
+ First initialize the SDK-IT project workflow. Name the client and point the
42
+ initializer at the backend's tsconfig:
37
43
 
38
44
  ```bash
39
- npx @sdk-it/cli@latest init
45
+ npx @sdk-it/cli@latest init --name Backend --project ./apps/backend/tsconfig.json
40
46
  ```
41
47
 
42
48
  Then add the plugin without an OpenAPI argument:
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,cAAc,CAAC;AAExE,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,KAAK,eAAe,GAAG,MACrB,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;AAC3D,MAAM,CAAC,OAAO,UAAU,KAAK,IAAI,MAAM,CAAC;AACxC,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAAC;AACrE,MAAM,CAAC,OAAO,UAAU,KAAK,CAC3B,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,eAAe,EACjD,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAEL,KAAK,MAAM,EAIZ,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,cAAc,CAAC;AAIxE,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAM/C,KAAK,eAAe,GAAG,MACrB,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;AAC3D,MAAM,CAAC,OAAO,UAAU,KAAK,IAAI,MAAM,CAAC;AACxC,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAAC;AACrE,MAAM,CAAC,OAAO,UAAU,KAAK,CAC3B,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,eAAe,EACjD,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAAC"}
package/dist/index.js CHANGED
@@ -1,9 +1,11 @@
1
1
  // packages/vite/src/index.ts
2
- import chalk from "chalk";
3
- import { createHash } from "node:crypto";
2
+ import crypto from "node:crypto";
4
3
  import { join, resolve } from "node:path";
5
4
  import { fileURLToPath } from "node:url";
6
- import "vite";
5
+ import { styleText } from "node:util";
6
+ import {
7
+ normalizePath
8
+ } from "vite";
7
9
  import { loadSpec } from "@sdk-it/spec";
8
10
  import { generate } from "@sdk-it/typescript";
9
11
 
@@ -32,6 +34,7 @@ function projectPlugin(options = {}) {
32
34
  }
33
35
 
34
36
  // packages/vite/src/index.ts
37
+ var sdkit = styleText("blue", "SDKIT");
35
38
  function sdkIt(openapi, settings) {
36
39
  if (openapi === void 0 || isProjectPluginOptions(openapi)) {
37
40
  return {
@@ -39,10 +42,13 @@ function sdkIt(openapi, settings) {
39
42
  ...projectPlugin(openapi)
40
43
  };
41
44
  }
42
- return {
43
- name: "sdk-it",
44
- ...typeof openapi === "function" ? functionPlugin(openapi, settings) : typeof openapi === "string" ? filePlugin(openapi, settings) : specPlugin(openapi, settings)
45
- };
45
+ if (typeof openapi === "function") {
46
+ return { name: "sdk-it", ...functionPlugin(openapi, settings) };
47
+ }
48
+ if (typeof openapi === "string") {
49
+ return { name: "sdk-it", ...filePlugin(openapi, settings) };
50
+ }
51
+ return { name: "sdk-it", ...specPlugin(openapi, settings) };
46
52
  }
47
53
  function isProjectPluginOptions(input) {
48
54
  return typeof input === "object" && input !== null && !("openapi" in input);
@@ -53,57 +59,71 @@ function functionPlugin(openapi, settings) {
53
59
  async configResolved(config) {
54
60
  const resolved = await openapi();
55
61
  delegatePlugin = typeof resolved === "string" ? filePlugin(resolved, settings) : specPlugin(resolved, settings);
56
- return delegatePlugin.configResolved?.(config);
62
+ return delegatePlugin.configResolved(config);
57
63
  },
58
64
  configureServer(server) {
59
- return delegatePlugin.configureServer?.(server);
65
+ return delegatePlugin.configureServer(server);
60
66
  },
61
- async buildStart(options) {
62
- return delegatePlugin.buildStart?.(options);
67
+ async buildStart() {
68
+ return delegatePlugin.buildStart();
63
69
  }
64
70
  };
65
71
  }
66
72
  function filePlugin(openapi, settings) {
67
- let watchPath = null;
68
- let sourceRef = null;
73
+ const source = Promise.withResolvers();
74
+ const devWatcher = Promise.withResolvers();
75
+ let watched = /* @__PURE__ */ new Set();
76
+ let loads = 0;
77
+ const watch = (documents) => {
78
+ watched = new Set(
79
+ documents.filter((document) => document.startsWith("file:")).map((document) => normalizePath(fileURLToPath(document)))
80
+ );
81
+ void devWatcher.promise.then((watcher) => watcher.add([...watched]));
82
+ };
69
83
  const generateIfNeeded = async (ref) => {
70
- const spec = await loadSpec(ref);
84
+ const load = ++loads;
85
+ const { spec, documents } = await loadSpec(ref);
86
+ if (load === loads) watch(documents);
71
87
  return cachedGeneration(settings.output, hashSpec(spec), async () => {
72
- console.log(`${chalk.blue("SDKIT")}: Generating SDK.`);
88
+ console.log(`${sdkit}: Generating SDK.`);
73
89
  await generate(spec, settings);
74
- console.log(`${chalk.blue("SDKIT")}: SDK generated successfully.`);
90
+ console.log(`${sdkit}: SDK generated successfully.`);
75
91
  });
76
92
  };
77
93
  return {
78
- configureServer(server) {
79
- if (!sourceRef) return;
94
+ async configureServer(server) {
95
+ const { ref, watchPath } = await source.promise;
80
96
  if (!watchPath) return;
81
- console.log(
82
- `${chalk.blue("SDKIT")}: Watching for spec changes in`,
83
- watchPath
84
- );
85
- server.watcher.add(watchPath);
86
- server.watcher.on("change", async (file) => {
87
- if (file === watchPath) {
88
- console.log(`${chalk.blue("SDKIT")}: OpenAPI spec changed`, file);
89
- await generateIfNeeded(sourceRef);
90
- }
91
- });
97
+ console.log(`${sdkit}: Watching for spec changes in`, watchPath);
98
+ server.watcher.add([...watched]);
99
+ devWatcher.resolve(server.watcher);
100
+ const regenerate = (file) => {
101
+ if (!watched.has(normalizePath(file))) return;
102
+ console.log(`${sdkit}: OpenAPI spec changed`, file);
103
+ generateIfNeeded(ref).catch(
104
+ (error) => console.error(
105
+ `${styleText("red", "SDKIT", { stream: process.stderr })}: SDK generation failed.`,
106
+ error
107
+ )
108
+ );
109
+ };
110
+ server.watcher.on("change", regenerate);
111
+ server.watcher.on("add", regenerate);
92
112
  },
93
113
  async buildStart() {
94
- if (!sourceRef) return;
95
- await generateIfNeeded(sourceRef);
114
+ const { ref } = await source.promise;
115
+ await generateIfNeeded(ref);
96
116
  },
97
117
  async configResolved(config) {
98
- if (startsWithProtocol(openapi)) {
99
- if (openapi.startsWith("file:")) {
100
- watchPath = fileURLToPath(openapi);
101
- sourceRef = openapi;
102
- }
103
- } else {
104
- watchPath = join(config.root, openapi);
105
- sourceRef = join(config.root, openapi);
118
+ const ref = startsWithProtocol(openapi) ? openapi : join(config.root, openapi);
119
+ let watchPath;
120
+ if (!startsWithProtocol(openapi)) {
121
+ watchPath = ref;
122
+ } else if (openapi.startsWith("file:")) {
123
+ watchPath = fileURLToPath(openapi);
106
124
  }
125
+ if (watchPath) watched = /* @__PURE__ */ new Set([normalizePath(watchPath)]);
126
+ source.resolve({ ref, watchPath });
107
127
  }
108
128
  };
109
129
  }
@@ -111,9 +131,9 @@ function specPlugin(openapi, settings) {
111
131
  const generateIfNeeded = async (document) => {
112
132
  const spec = structuredClone(document);
113
133
  return cachedGeneration(settings.output, hashSpec(spec), async () => {
114
- console.log(`${chalk.blue("SDKIT")}: Generating SDK.`);
134
+ console.log(`${sdkit}: Generating SDK.`);
115
135
  await generate(spec, settings);
116
- console.log(`${chalk.blue("SDKIT")}: SDK generated successfully.`);
136
+ console.log(`${sdkit}: SDK generated successfully.`);
117
137
  });
118
138
  };
119
139
  return {
@@ -141,7 +161,7 @@ function cachedGeneration(output, hash, fn) {
141
161
  return promise;
142
162
  }
143
163
  function hashSpec(spec) {
144
- return createHash("sha256").update(JSON.stringify(spec)).digest("hex");
164
+ return crypto.hash("sha256", JSON.stringify(spec));
145
165
  }
146
166
  function startsWithProtocol(url) {
147
167
  return /^[a-zA-Z][a-zA-Z0-9+\-.]*:\/\//.test(url);
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/index.ts", "../src/project.ts"],
4
- "sourcesContent": ["import chalk from 'chalk';\nimport { createHash } from 'node:crypto';\nimport { join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { OpenAPIObject } from 'openapi3-ts/oas31';\nimport { type Plugin } from 'vite';\n\nimport { loadSpec } from '@sdk-it/spec';\nimport { generate } from '@sdk-it/typescript';\n\nimport { type ProjectPluginOptions, projectPlugin } from './project.ts';\n\ntype Settings = Parameters<typeof generate>[1];\ntype OpenapiFunction = () =>\n string | OpenAPIObject | Promise<string | OpenAPIObject>;\nexport default function sdkIt(): Plugin;\nexport default function sdkIt(options: ProjectPluginOptions): Plugin;\nexport default function sdkIt(\n openapi: OpenAPIObject | string | OpenapiFunction,\n settings: Settings,\n): Plugin;\nexport default function sdkIt(\n openapi?: OpenAPIObject | string | OpenapiFunction | ProjectPluginOptions,\n settings?: Settings,\n): Plugin {\n if (openapi === undefined || isProjectPluginOptions(openapi)) {\n return {\n name: 'sdk-it',\n ...projectPlugin(openapi),\n };\n }\n return {\n name: 'sdk-it',\n ...(typeof openapi === 'function'\n ? functionPlugin(openapi, settings!)\n : typeof openapi === 'string'\n ? filePlugin(openapi, settings!)\n : specPlugin(openapi, settings!)),\n };\n}\n\nfunction isProjectPluginOptions(\n input: OpenAPIObject | string | OpenapiFunction | ProjectPluginOptions,\n): input is ProjectPluginOptions {\n return typeof input === 'object' && input !== null && !('openapi' in input);\n}\n\nfunction functionPlugin(\n openapi: OpenapiFunction,\n settings: Settings,\n): Omit<Plugin, 'name'> {\n let delegatePlugin!:\n ReturnType<typeof specPlugin> | ReturnType<typeof filePlugin>;\n\n return {\n async configResolved(config) {\n // Resolve the function once\n const resolved = await openapi();\n\n // Create the appropriate delegate plugin based on the resolved type\n delegatePlugin =\n typeof resolved === 'string'\n ? filePlugin(resolved, settings)\n : specPlugin(resolved, settings);\n\n return (delegatePlugin.configResolved as any)?.(config);\n },\n configureServer(server) {\n return (delegatePlugin.configureServer as any)?.(server);\n },\n async buildStart(options) {\n return (delegatePlugin.buildStart as any)?.(options);\n },\n };\n}\n\nfunction filePlugin(openapi: string, settings: Settings): Omit<Plugin, 'name'> {\n let watchPath: string | null = null;\n let sourceRef: string | null = null;\n\n const generateIfNeeded = async (ref: string) => {\n const spec = await loadSpec(ref);\n return cachedGeneration(settings.output, hashSpec(spec), async () => {\n console.log(`${chalk.blue('SDKIT')}: Generating SDK.`);\n await generate(spec, settings);\n console.log(`${chalk.blue('SDKIT')}: SDK generated successfully.`);\n });\n };\n\n return {\n configureServer(server) {\n if (!sourceRef) return;\n\n if (!watchPath) return;\n console.log(\n `${chalk.blue('SDKIT')}: Watching for spec changes in`,\n watchPath,\n );\n server.watcher.add(watchPath);\n server.watcher.on('change', async (file) => {\n if (file === watchPath) {\n console.log(`${chalk.blue('SDKIT')}: OpenAPI spec changed`, file);\n await generateIfNeeded(sourceRef!);\n }\n });\n },\n async buildStart() {\n if (!sourceRef) return;\n await generateIfNeeded(sourceRef);\n },\n async configResolved(config) {\n if (startsWithProtocol(openapi)) {\n if (openapi.startsWith('file:')) {\n watchPath = fileURLToPath(openapi);\n sourceRef = openapi;\n }\n } else {\n watchPath = join(config.root, openapi);\n sourceRef = join(config.root, openapi);\n }\n },\n };\n}\n\nfunction specPlugin(\n openapi: OpenAPIObject,\n settings: Settings,\n): Omit<Plugin, 'name'> {\n const generateIfNeeded = async (document: OpenAPIObject) => {\n const spec = structuredClone(document);\n return cachedGeneration(settings.output, hashSpec(spec), async () => {\n console.log(`${chalk.blue('SDKIT')}: Generating SDK.`);\n await generate(spec, settings);\n console.log(`${chalk.blue('SDKIT')}: SDK generated successfully.`);\n });\n };\n return {\n async configResolved() {\n // No-op for specPlugin\n },\n async configureServer() {\n await generateIfNeeded(openapi);\n },\n async buildStart() {\n await generateIfNeeded(openapi);\n },\n };\n}\n\nconst generationCache = new Map<\n string,\n { hash: string; promise: Promise<void> }\n>();\n\nfunction cachedGeneration(\n output: string,\n hash: string,\n fn: () => Promise<void>,\n): Promise<void> {\n const key = resolve(output);\n const existing = generationCache.get(key);\n // Only the latest queued generation can represent this output directory.\n if (existing?.hash === hash) return existing.promise;\n\n // A failed predecessor still releases the queue; its own caller keeps the error.\n const promise: Promise<void> = (\n existing ? existing.promise.then(fn, fn) : fn()\n ).catch((err) => {\n if (generationCache.get(key)?.promise === promise)\n generationCache.delete(key);\n throw err;\n });\n generationCache.set(key, { hash, promise });\n return promise;\n}\n\nfunction hashSpec(spec: OpenAPIObject): string {\n return createHash('sha256').update(JSON.stringify(spec)).digest('hex');\n}\n\nfunction startsWithProtocol(url: string): boolean {\n return /^[a-zA-Z][a-zA-Z0-9+\\-.]*:\\/\\//.test(url);\n}\n", "import type { Plugin } from 'vite';\n\nexport interface ProjectPluginOptions {\n config?: string;\n}\n\nexport function projectPlugin(\n options: ProjectPluginOptions = {},\n): Omit<Plugin, 'name'> {\n let root = process.cwd();\n\n const generate = async () => {\n const { generateProject, loadProjectConfig } = await import('@sdk-it/cli');\n const config = await loadProjectConfig({\n cwd: root,\n config: options.config,\n });\n await generateProject(config);\n };\n\n return {\n configResolved(config) {\n root = config.root;\n },\n async configureServer() {\n await generate();\n },\n async buildStart() {\n await generate();\n },\n };\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import crypto from 'node:crypto';\nimport { join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { styleText } from 'node:util';\nimport type { OpenAPIObject } from 'openapi3-ts/oas31';\nimport {\n type FSWatcher,\n type Plugin,\n type ResolvedConfig,\n type ViteDevServer,\n normalizePath,\n} from 'vite';\n\nimport { loadSpec } from '@sdk-it/spec';\nimport { generate } from '@sdk-it/typescript';\n\nimport { type ProjectPluginOptions, projectPlugin } from './project.ts';\n\nconst sdkit = styleText('blue', 'SDKIT');\n\ntype Settings = Parameters<typeof generate>[1];\ninterface SourcePlugin {\n configResolved(config: ResolvedConfig): Promise<void>;\n configureServer(server: ViteDevServer): Promise<void>;\n buildStart(): Promise<void>;\n}\ntype OpenapiFunction = () =>\n string | OpenAPIObject | Promise<string | OpenAPIObject>;\nexport default function sdkIt(): Plugin;\nexport default function sdkIt(options: ProjectPluginOptions): Plugin;\nexport default function sdkIt(\n openapi: OpenAPIObject | string | OpenapiFunction,\n settings: Settings,\n): Plugin;\nexport default function sdkIt(\n openapi?: OpenAPIObject | string | OpenapiFunction | ProjectPluginOptions,\n settings?: Settings,\n): Plugin {\n if (openapi === undefined || isProjectPluginOptions(openapi)) {\n return {\n name: 'sdk-it',\n ...projectPlugin(openapi),\n };\n }\n if (typeof openapi === 'function') {\n return { name: 'sdk-it', ...functionPlugin(openapi, settings!) };\n }\n if (typeof openapi === 'string') {\n return { name: 'sdk-it', ...filePlugin(openapi, settings!) };\n }\n return { name: 'sdk-it', ...specPlugin(openapi, settings!) };\n}\n\nfunction isProjectPluginOptions(\n input: OpenAPIObject | string | OpenapiFunction | ProjectPluginOptions,\n): input is ProjectPluginOptions {\n return typeof input === 'object' && input !== null && !('openapi' in input);\n}\n\nfunction functionPlugin(\n openapi: OpenapiFunction,\n settings: Settings,\n): Omit<Plugin, 'name'> {\n let delegatePlugin!: SourcePlugin;\n\n return {\n async configResolved(config) {\n const resolved = await openapi();\n delegatePlugin =\n typeof resolved === 'string'\n ? filePlugin(resolved, settings)\n : specPlugin(resolved, settings);\n\n return delegatePlugin.configResolved(config);\n },\n configureServer(server) {\n return delegatePlugin.configureServer(server);\n },\n async buildStart() {\n return delegatePlugin.buildStart();\n },\n };\n}\n\nfunction filePlugin(openapi: string, settings: Settings): SourcePlugin {\n // Vite resolves the config before it starts a dev server or a build.\n const source = Promise.withResolvers<{ ref: string; watchPath?: string }>();\n // Only a dev server has a watcher; a build never resolves this.\n const devWatcher = Promise.withResolvers<FSWatcher>();\n // Every local file the spec was read from; an edit to any of them regenerates.\n let watched = new Set<string>();\n let loads = 0;\n\n const watch = (documents: string[]) => {\n watched = new Set(\n documents\n .filter((document) => document.startsWith('file:'))\n .map((document) => normalizePath(fileURLToPath(document))),\n );\n void devWatcher.promise.then((watcher) => watcher.add([...watched]));\n };\n\n const generateIfNeeded = async (ref: string) => {\n const load = ++loads;\n const { spec, documents } = await loadSpec(ref);\n if (load === loads) watch(documents);\n return cachedGeneration(settings.output, hashSpec(spec), async () => {\n console.log(`${sdkit}: Generating SDK.`);\n await generate(spec, settings);\n console.log(`${sdkit}: SDK generated successfully.`);\n });\n };\n\n return {\n async configureServer(server) {\n const { ref, watchPath } = await source.promise;\n if (!watchPath) return;\n console.log(`${sdkit}: Watching for spec changes in`, watchPath);\n server.watcher.add([...watched]);\n devWatcher.resolve(server.watcher);\n const regenerate = (file: string) => {\n if (!watched.has(normalizePath(file))) return;\n console.log(`${sdkit}: OpenAPI spec changed`, file);\n // A half-saved file fails to load; the next save tries again.\n generateIfNeeded(ref).catch((error: unknown) =>\n console.error(\n `${styleText('red', 'SDKIT', { stream: process.stderr })}: SDK generation failed.`,\n error,\n ),\n );\n };\n server.watcher.on('change', regenerate);\n server.watcher.on('add', regenerate);\n },\n async buildStart() {\n const { ref } = await source.promise;\n await generateIfNeeded(ref);\n },\n async configResolved(config) {\n const ref = startsWithProtocol(openapi)\n ? openapi\n : join(config.root, openapi);\n let watchPath: string | undefined;\n if (!startsWithProtocol(openapi)) {\n watchPath = ref;\n } else if (openapi.startsWith('file:')) {\n watchPath = fileURLToPath(openapi);\n }\n if (watchPath) watched = new Set([normalizePath(watchPath)]);\n source.resolve({ ref, watchPath });\n },\n };\n}\n\nfunction specPlugin(openapi: OpenAPIObject, settings: Settings): SourcePlugin {\n const generateIfNeeded = async (document: OpenAPIObject) => {\n const spec = structuredClone(document);\n return cachedGeneration(settings.output, hashSpec(spec), async () => {\n console.log(`${sdkit}: Generating SDK.`);\n await generate(spec, settings);\n console.log(`${sdkit}: SDK generated successfully.`);\n });\n };\n return {\n async configResolved() {},\n async configureServer() {\n await generateIfNeeded(openapi);\n },\n async buildStart() {\n await generateIfNeeded(openapi);\n },\n };\n}\n\nconst generationCache = new Map<\n string,\n { hash: string; promise: Promise<void> }\n>();\n\nfunction cachedGeneration(\n output: string,\n hash: string,\n fn: () => Promise<void>,\n): Promise<void> {\n const key = resolve(output);\n const existing = generationCache.get(key);\n // Only the latest queued generation can represent this output directory.\n if (existing?.hash === hash) return existing.promise;\n\n // A failed predecessor still releases the queue; its own caller keeps the error.\n const promise: Promise<void> = (\n existing ? existing.promise.then(fn, fn) : fn()\n ).catch((err) => {\n if (generationCache.get(key)?.promise === promise)\n generationCache.delete(key);\n throw err;\n });\n generationCache.set(key, { hash, promise });\n return promise;\n}\n\nfunction hashSpec(spec: OpenAPIObject): string {\n return crypto.hash('sha256', JSON.stringify(spec));\n}\n\nfunction startsWithProtocol(url: string): boolean {\n return /^[a-zA-Z][a-zA-Z0-9+\\-.]*:\\/\\//.test(url);\n}\n", "import type { Plugin } from 'vite';\n\nexport interface ProjectPluginOptions {\n config?: string;\n}\n\nexport function projectPlugin(\n options: ProjectPluginOptions = {},\n): Omit<Plugin, 'name'> {\n let root = process.cwd();\n\n const generate = async () => {\n const { generateProject, loadProjectConfig } = await import('@sdk-it/cli');\n const config = await loadProjectConfig({\n cwd: root,\n config: options.config,\n });\n await generateProject(config);\n };\n\n return {\n configResolved(config) {\n root = config.root;\n },\n async configureServer() {\n await generate();\n },\n async buildStart() {\n await generate();\n },\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": ["generate"]
7
7
  }
@@ -1 +1 @@
1
- {"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBtB"}
1
+ {"version":3,"file":"project.d.ts","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBtB"}
package/package.json CHANGED
@@ -1,6 +1,15 @@
1
1
  {
2
2
  "name": "@sdk-it/vite",
3
- "version": "0.46.10",
3
+ "version": "0.47.0",
4
+ "repository": {
5
+ "type": "git",
6
+ "url": "https://github.com/JanuaryLabs/sdk-it",
7
+ "directory": "packages/vite"
8
+ },
9
+ "bugs": {
10
+ "url": "https://github.com/JanuaryLabs/sdk-it/issues"
11
+ },
12
+ "homepage": "https://github.com/JanuaryLabs/sdk-it/tree/main/packages/vite#readme",
4
13
  "type": "module",
5
14
  "main": "./dist/index.js",
6
15
  "module": "./dist/index.js",
@@ -27,15 +36,16 @@
27
36
  "!**/*.test.*"
28
37
  ],
29
38
  "devDependencies": {
30
- "chalk": "^5.6.0"
39
+ "@sdk-it/core": "0.47.0",
40
+ "@sdk-it/testing": "*",
41
+ "@zukhruf/fs": "^0.8.22"
31
42
  },
32
43
  "peerDependencies": {
33
- "@sdk-it/cli": "0.46.10",
34
- "openapi3-ts": "4.5.0",
35
- "vite": "^6.0.0 || ^7.0.0",
36
- "@sdk-it/spec": "0.46.10",
37
- "@sdk-it/typescript": "0.46.10",
38
- "chalk": "^5.6.0"
44
+ "@sdk-it/cli": "0.47.0",
45
+ "openapi3-ts": "4.6.2",
46
+ "vite": "^7.0.0 || ^8.0.0",
47
+ "@sdk-it/spec": "0.47.0",
48
+ "@sdk-it/typescript": "0.47.0"
39
49
  },
40
50
  "peerDependenciesMeta": {
41
51
  "@sdk-it/cli": {