@nestia/editor 14.0.0 → 14.0.2

package/lib/NestiaEditorModule.js.map

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

package/lib/NestiaEditorModule.mjs

@@ -1,45 +1,65 @@
+import { NESTIA_EDITOR_DEFAULT_PACKAGE } from "./internal/NestiaEditorDefaultPackage.mjs";
 import * as fs from "fs";
+import path from "path";
 //#region src/NestiaEditorModule.ts
 let NestiaEditorModule;
 (function(_NestiaEditorModule) {
 	_NestiaEditorModule.setup = async (props) => {
-		const prefix = "/" + [getGlobalPrefix(props.application), props.path].join("/").split("/").filter((str) => str.length !== 0).join("/");
+		const prefix = [getGlobalPrefix(props.application), props.path].join("/").split("/").filter((str) => str.length !== 0).map((str) => "/" + str).join("");
 		const adaptor = props.application.getHttpAdapter();
-		const staticFiles = [
-			{
-				path: "/index.html",
-				type: "text/html",
-				content: await getIndex(props)
-			},
-			{
-				path: "/swagger.json",
-				type: "application/json",
-				content: JSON.stringify(typeof props.swagger === "string" ? await getSwagger(props.swagger) : props.swagger, null, 2)
-			},
-			await getJavaScript()
-		];
+		const index = await getIndex(props);
+		const staticFiles = [{
+			path: "/index.html",
+			type: "text/html",
+			content: index
+		}, ...await getJavaScripts(index)];
 		for (const f of staticFiles) adaptor.get(prefix + f.path, (_, res) => {
 			res.type(f.type);
 			return res.send(f.content);
 		});
-		for (const p of ["", "/"]) adaptor.get(prefix + p, (_, res) => {
+		let document = typeof props.swagger === "string" ? null : JSON.stringify(props.swagger, null, 2);
+		let pending = null;
+		adaptor.get(prefix + "/swagger.json", async (_, res) => {
+			try {
+				if (document === null) {
+					pending ??= (async () => JSON.stringify(await getSwagger(await resolveLocation(props.application, props.swagger)), null, 2))().finally(() => {
+						pending = null;
+					});
+					document = await pending;
+				}
+			} catch (error) {
+				res.status(502);
+				res.type("text/plain");
+				return res.send(error instanceof Error ? error.message : String(error));
+			}
+			res.type("application/json");
+			return res.send(document);
+		});
+		for (const p of prefix.length === 0 ? ["/"] : ["", "/"]) adaptor.get(prefix + p, (_, res) => {
 			return res.redirect(prefix + "/index.html");
 		});
 	};
 	const getGlobalPrefix = (app) => typeof app.config?.globalPrefix === "string" ? app.config.globalPrefix : "";
 })(NestiaEditorModule || (NestiaEditorModule = {}));
 const getIndex = async (props) => {
-	return (await fs.promises.readFile(`${__dirname}/../dist/index.html`, "utf8")).replace(`"@ORGANIZATION/PROJECT"`, JSON.stringify(props.package ?? "@ORGANIZATION/PROJECT")).replace("window.simulate = false", `window.simulate = ${!!props.simulate}`).replace("window.e2e = false", `window.e2e = ${!!props.e2e}`);
+	return (await fs.promises.readFile(`${__dirname}/../dist/index.html`, "utf8")).replace(JSON.stringify(NESTIA_EDITOR_DEFAULT_PACKAGE), () => JSON.stringify(props.package ?? "@ORGANIZATION/PROJECT")).replace("window.simulate = false", () => `window.simulate = ${!!props.simulate}`).replace("window.e2e = false", () => `window.e2e = ${!!props.e2e}`);
 };
-const getJavaScript = async () => {
-	const path = (await fs.promises.readdir(`${__dirname}/../dist/assets`))[0];
-	if (path === void 0) throw new Error("Unreachable code, no JS file exists.");
-	return {
-		path: `/assets/${path}`,
+const getJavaScripts = async (index) => {
+	const scripts = /* @__PURE__ */ new Set();
+	for (const match of index.matchAll(/<script\b[^>]*\bsrc\s*=\s*(["'])(.*?)\1[^>]*>/gi)) {
+		const url = new URL(match[2], "https://nestia.invalid/");
+		if (url.origin !== "https://nestia.invalid" || url.pathname.startsWith("/assets/") === false || url.pathname.endsWith(".js") === false || url.search.length !== 0 || url.hash.length !== 0) throw new Error(`Unsupported editor script asset: ${match[2]}`);
+		scripts.add(url.pathname);
+	}
+	if (scripts.size === 0) throw new Error("The editor page references no JavaScript asset.");
+	return Promise.all([...scripts].map(async (asset) => ({
+		path: asset,
 		type: "application/javascript",
-		content: await fs.promises.readFile(`${__dirname}/../dist/assets/${path}`, "utf8")
-	};
+		content: await fs.promises.readFile(path.join(__dirname, "../dist", asset.slice(1)), "utf8")
+	})));
 };
+/** An absolute URL as is; a path of the application at its own address. */
+const resolveLocation = async (application, location) => /^[a-z][a-z\d+\-.]*:/i.test(location) ? location : new URL(location, await application.getUrl()).href;
 const getSwagger = async (url) => {
 	const response = await fetch(url);
 	if (response.status !== 200) throw new Error(`Failed to fetch Swagger document from ${url}`);

package/lib/NestiaEditorUploader.d.ts

@@ -1,6 +1,25 @@
+/**
+ * The uploader form: reads a Swagger file, and downloads the generated project.
+ *
+ * The user picks a document, a package name, the mode (SDK or NestJS project), and the options. The project is generated in the browser and downloaded as a zip file. Operations the converter could not handle are reported, so an incomplete project is never presented as complete.
+ *
+ * @evidence contracts/common.md#principled-implementation The form keeps its inputs in component state, composes on request with `NestiaEditorComposer`, and hands the files to `NestiaEditorArchiver`. Composition and archive failures, file-parser errors reported by the picker, and skipped operations reach the error handler. File-reading rejection belongs to the picker callback and is not caught by this form.
+ * @evidence contracts/common.md#clear-and-simple-design One component owns the form state and delegates parsing the file, composing, and archiving to internal modules.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults are the same product defaults as the iframe flow and the package name comes from the shared constant; an error goes to `onError` when given and to `alert` otherwise, with no fixture-specific path.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the inputs, the output, and how skipped operations are reported.
+ */
 export declare function NestiaEditorUploader(props: NestiaEditorUploader.IProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Properties of {@link NestiaEditorUploader}.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace holds the property type of the component with the same name, so the component and its inputs are one public identity.
+ * @evidence contracts/common.md#clear-and-simple-design It contains one interface with one optional callback.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts It adds no behavior; when the callback is absent the component reports errors with `alert`.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the component the properties belong to.
+ */
 export declare namespace NestiaEditorUploader {
     interface IProps {
+        /** Receives conversion errors and skipped-operation warnings; absent uses alert. */
         onError?: (error: string) => void;
     }
 }

package/lib/NestiaEditorUploader.js

@@ -20,6 +20,16 @@ const NestiaEditorArchiver_1 = require("./internal/NestiaEditorArchiver");
 const NestiaEditorComposer_1 = require("./internal/NestiaEditorComposer");
 const NestiaEditorDefaultPackage_1 = require("./internal/NestiaEditorDefaultPackage");
 const NestiaEditorFileUploader_1 = require("./internal/NestiaEditorFileUploader");
+/**
+ * The uploader form: reads a Swagger file, and downloads the generated project.
+ *
+ * The user picks a document, a package name, the mode (SDK or NestJS project), and the options. The project is generated in the browser and downloaded as a zip file. Operations the converter could not handle are reported, so an incomplete project is never presented as complete.
+ *
+ * @evidence contracts/common.md#principled-implementation The form keeps its inputs in component state, composes on request with `NestiaEditorComposer`, and hands the files to `NestiaEditorArchiver`. Composition and archive failures, file-parser errors reported by the picker, and skipped operations reach the error handler. File-reading rejection belongs to the picker callback and is not caught by this form.
+ * @evidence contracts/common.md#clear-and-simple-design One component owns the form state and delegates parsing the file, composing, and archiving to internal modules.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults are the same product defaults as the iframe flow and the package name comes from the shared constant; an error goes to `onError` when given and to `alert` otherwise, with no fixture-specific path.
+ * @evidence contracts/common.md#meaningful-documentation The comment states the inputs, the output, and how skipped operations are reported.
+ */
 function NestiaEditorUploader(props) {
     // PARAMETERS
     const [mode, setMode] = react_1.default.useState("sdk");
@@ -58,6 +68,11 @@ function NestiaEditorUploader(props) {
                     name: NestiaEditorArchiver_1.NestiaEditorArchiver.name(name),
                     files: result.data.files,
                 });
+                if (result.data.skipped.length !== 0)
+                    handleError([
+                        "The project leaves out operations that could not be converted:",
+                        ...result.data.skipped.map((s) => `  - ${s.method} ${s.path}: ${s.messages.join(" ")}`),
+                    ].join("\n"));
             }
             else {
                 handleError(JSON.stringify(result.errors, null, 2));

package/lib/NestiaEditorUploader.js.map

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

package/lib/NestiaEditorUploader.mjs

@@ -1,11 +1,21 @@
+import { NESTIA_EDITOR_DEFAULT_PACKAGE } from "./internal/NestiaEditorDefaultPackage.mjs";
 import { NestiaEditorArchiver } from "./internal/NestiaEditorArchiver.mjs";
 import { NestiaEditorComposer } from "./internal/NestiaEditorComposer.mjs";
-import { NESTIA_EDITOR_DEFAULT_PACKAGE } from "./internal/NestiaEditorDefaultPackage.mjs";
 import { NestiaEditorFileUploader } from "./internal/NestiaEditorFileUploader.mjs";
 import { Button, FormControl, FormControlLabel, FormLabel, Radio, RadioGroup, Switch, TextField } from "@mui/material";
 import React from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/NestiaEditorUploader.tsx
+/**
+* The uploader form: reads a Swagger file, and downloads the generated project.
+*
+* The user picks a document, a package name, the mode (SDK or NestJS project), and the options. The project is generated in the browser and downloaded as a zip file. Operations the converter could not handle are reported, so an incomplete project is never presented as complete.
+*
+* @evidence contracts/common.md#principled-implementation The form keeps its inputs in component state, composes on request with `NestiaEditorComposer`, and hands the files to `NestiaEditorArchiver`. Composition and archive failures, file-parser errors reported by the picker, and skipped operations reach the error handler. File-reading rejection belongs to the picker callback and is not caught by this form.
+* @evidence contracts/common.md#clear-and-simple-design One component owns the form state and delegates parsing the file, composing, and archiving to internal modules.
+* @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults are the same product defaults as the iframe flow and the package name comes from the shared constant; an error goes to `onError` when given and to `alert` otherwise, with no fixture-specific path.
+* @evidence contracts/common.md#meaningful-documentation The comment states the inputs, the output, and how skipped operations are reported.
+*/
 function NestiaEditorUploader(props) {
 	const [mode, setMode] = React.useState("sdk");
 	const [keyword, setKeyword] = React.useState(true);
@@ -33,11 +43,13 @@ function NestiaEditorUploader(props) {
 				simulate,
 				package: name
 			});
-			if (result.success === true) NestiaEditorArchiver.download({
-				name: NestiaEditorArchiver.name(name),
-				files: result.data.files
-			});
-			else handleError(JSON.stringify(result.errors, null, 2));
+			if (result.success === true) {
+				NestiaEditorArchiver.download({
+					name: NestiaEditorArchiver.name(name),
+					files: result.data.files
+				});
+				if (result.data.skipped.length !== 0) handleError(["The project leaves out operations that could not be converted:", ...result.data.skipped.map((s) => `  - ${s.method} ${s.path}: ${s.messages.join(" ")}`)].join("\n"));
+			} else handleError(JSON.stringify(result.errors, null, 2));
 		} catch (exp) {
 			handleError(exp instanceof Error ? exp.message : "unknown error");
 		}

package/lib/internal/NestiaEditorArchiver.d.ts

@@ -6,13 +6,45 @@
  * WebContainer cannot execute. The editor therefore delivers the composed
  * project as a downloadable zip archive instead of an embedded StackBlitz
  * workspace.
+ *
+ * @evidence contracts/common.md#principled-implementation Packing is a synchronous zip of UTF-8 encoded entries through `fflate`, naming derives from the package name with a fixed character whitelist, and the download creates an object URL, clicks an anchor, and revokes the URL later.
+ * @evidence contracts/common.md#clear-and-simple-design Three operations, each one browser or zip concern, in one namespace with no shared state.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The archive is built with the library's public functions and the download uses the standard anchor mechanism; nothing is patched.
+ * @evidence contracts/common.md#meaningful-documentation The namespace prose explains why the editor delivers a zip archive rather than an embedded workspace.
  */
 export declare namespace NestiaEditorArchiver {
-    /** Pack the composed project files into a zip archive. */
+    /**
+     * Pack the composed project files into a zip archive.
+     *
+     * @evidence contracts/common.md#principled-implementation Each own file key names a synchronous ZipDeflate stream added to Zip. Filenames are values rather than dictionary properties, preserving prototype-related names without changing an object's prototype. UTF-8 encoding preserves text; ending the archive emits its directory, including for an empty project.
+     * @evidence contracts/common.md#clear-and-simple-design One loop supplies files to the public synchronous compression streams; the callback collects chunks which are copied once into the returned archive.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It archives exactly the given files; no entry is added, filtered, or renamed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the input and output.
+     */
     const pack: (files: Record<string, string>) => Uint8Array;
-    /** Compose a safe archive file name from a package name. */
+    /**
+     * Compose a safe archive file name from a package name.
+     *
+     * A leading `@` is dropped and every run of characters outside letters,
+     * digits, `.`, `_`, and `-` becomes one `-`. A name with nothing left but
+     * dots, such as an empty package name, has no usable base for the archive, so
+     * the default package name is used instead. Other names retain their dots,
+     * including a leading dot.
+     *
+     * @evidence contracts/common.md#principled-implementation Dropping the `@` and replacing runs of characters outside the whitelist with one `-` yields a file name without path separators. Empty or dots-only bases use the default package name; otherwise dots are retained, so this is not a general rejection of hidden filenames or a validator of npm package names.
+     * @evidence contracts/common.md#clear-and-simple-design One private helper applies the character rule to the package name and to the default, so the rule exists once.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule applies to every input; the only special case is the empty-name guard, which follows from the safe-name requirement.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the character rule and the dots-only fallback.
+     */
     const name: (packageName: string) => string;
-    /** Trigger a browser download of the packed archive. */
+    /**
+     * Trigger a browser download of the packed archive.
+     *
+     * @evidence contracts/common.md#principled-implementation A Blob of the packed bytes is exposed through an object URL and an anchor with the `download` attribute is clicked, which is the browser's standard way to save generated content; the URL is revoked after 30 seconds so its memory is released.
+     * @evidence contracts/common.md#clear-and-simple-design One function, kept apart from `pack` so packing stays testable outside a browser.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the standard DOM and URL APIs; the delayed revocation is not a retry or a compensation.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that it triggers a browser download of the packed archive.
+     */
     const download: (props: {
         name: string;
         files: Record<string, string>;

package/lib/internal/NestiaEditorArchiver.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaEditorArchiver = void 0;
 const fflate_1 = require("fflate");
+const NestiaEditorDefaultPackage_1 = require("./NestiaEditorDefaultPackage");
 /**
  * Archives a composed project into a zip file and hands it to the browser.
  *
@@ -10,19 +11,70 @@ const fflate_1 = require("fflate");
  * WebContainer cannot execute. The editor therefore delivers the composed
  * project as a downloadable zip archive instead of an embedded StackBlitz
  * workspace.
+ *
+ * @evidence contracts/common.md#principled-implementation Packing is a synchronous zip of UTF-8 encoded entries through `fflate`, naming derives from the package name with a fixed character whitelist, and the download creates an object URL, clicks an anchor, and revokes the URL later.
+ * @evidence contracts/common.md#clear-and-simple-design Three operations, each one browser or zip concern, in one namespace with no shared state.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The archive is built with the library's public functions and the download uses the standard anchor mechanism; nothing is patched.
+ * @evidence contracts/common.md#meaningful-documentation The namespace prose explains why the editor delivers a zip archive rather than an embedded workspace.
  */
 var NestiaEditorArchiver;
 (function (NestiaEditorArchiver) {
-    /** Pack the composed project files into a zip archive. */
+    /**
+     * Pack the composed project files into a zip archive.
+     *
+     * @evidence contracts/common.md#principled-implementation Each own file key names a synchronous ZipDeflate stream added to Zip. Filenames are values rather than dictionary properties, preserving prototype-related names without changing an object's prototype. UTF-8 encoding preserves text; ending the archive emits its directory, including for an empty project.
+     * @evidence contracts/common.md#clear-and-simple-design One loop supplies files to the public synchronous compression streams; the callback collects chunks which are copied once into the returned archive.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It archives exactly the given files; no entry is added, filtered, or renamed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the input and output.
+     */
     NestiaEditorArchiver.pack = (files) => {
-        const entries = {};
-        for (const [key, value] of Object.entries(files))
-            entries[key] = (0, fflate_1.strToU8)(value);
-        return (0, fflate_1.zipSync)(entries);
+        const chunks = [];
+        const archive = new fflate_1.Zip((error, chunk) => {
+            if (error)
+                throw error;
+            chunks.push(chunk);
+        });
+        for (const [key, value] of Object.entries(files)) {
+            const entry = new fflate_1.ZipDeflate(key);
+            archive.add(entry);
+            entry.push((0, fflate_1.strToU8)(value), true);
+        }
+        archive.end();
+        const output = new Uint8Array(chunks.reduce((length, chunk) => length + chunk.length, 0));
+        let offset = 0;
+        for (const chunk of chunks) {
+            output.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return output;
+    };
+    /**
+     * Compose a safe archive file name from a package name.
+     *
+     * A leading `@` is dropped and every run of characters outside letters,
+     * digits, `.`, `_`, and `-` becomes one `-`. A name with nothing left but
+     * dots, such as an empty package name, has no usable base for the archive, so
+     * the default package name is used instead. Other names retain their dots,
+     * including a leading dot.
+     *
+     * @evidence contracts/common.md#principled-implementation Dropping the `@` and replacing runs of characters outside the whitelist with one `-` yields a file name without path separators. Empty or dots-only bases use the default package name; otherwise dots are retained, so this is not a general rejection of hidden filenames or a validator of npm package names.
+     * @evidence contracts/common.md#clear-and-simple-design One private helper applies the character rule to the package name and to the default, so the rule exists once.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The rule applies to every input; the only special case is the empty-name guard, which follows from the safe-name requirement.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the character rule and the dots-only fallback.
+     */
+    NestiaEditorArchiver.name = (packageName) => {
+        const base = compose(packageName);
+        return `${/^\.*$/.test(base) ? compose(NestiaEditorDefaultPackage_1.NESTIA_EDITOR_DEFAULT_PACKAGE) : base}.zip`;
     };
-    /** Compose a safe archive file name from a package name. */
-    NestiaEditorArchiver.name = (packageName) => `${packageName.replace(/^@/, "").replace(/[^A-Za-z0-9._-]+/g, "-")}.zip`;
-    /** Trigger a browser download of the packed archive. */
+    const compose = (packageName) => packageName.replace(/^@/, "").replace(/[^A-Za-z0-9._-]+/g, "-");
+    /**
+     * Trigger a browser download of the packed archive.
+     *
+     * @evidence contracts/common.md#principled-implementation A Blob of the packed bytes is exposed through an object URL and an anchor with the `download` attribute is clicked, which is the browser's standard way to save generated content; the URL is revoked after 30 seconds so its memory is released.
+     * @evidence contracts/common.md#clear-and-simple-design One function, kept apart from `pack` so packing stays testable outside a browser.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It uses the standard DOM and URL APIs; the delayed revocation is not a retry or a compensation.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that it triggers a browser download of the packed archive.
+     */
     NestiaEditorArchiver.download = (props) => {
         const blob = new Blob([NestiaEditorArchiver.pack(props.files)], {
             type: "application/zip",

package/lib/internal/NestiaEditorArchiver.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaEditorArchiver.js","sourceRoot":"","sources":["../../src/internal/NestiaEditorArchiver.ts"],"names":[],"mappings":";;;AAAA,mCAA0C;AAE1C;;;;;;;;GAQG;AACH,IAAiB,oBAAoB,CA+BpC;AA/BD,WAAiB,oBAAoB;IACnC,0DAA0D;IAC7C,yBAAI,GAAG,CAAC,KAA6B,EAAc,EAAE;QAChE,MAAM,OAAO,GAA+B,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAA,gBAAO,EAAC,KAAK,CAAC,CAAC;QAChC,OAAO,IAAA,gBAAO,EAAC,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,4DAA4D;IAC/C,yBAAI,GAAG,CAAC,WAAmB,EAAU,EAAE,CAClD,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC;IAE3E,wDAAwD;IAC3C,6BAAQ,GAAG,CAAC,KAGxB,EAAQ,EAAE;QACT,MAAM,IAAI,GAAS,IAAI,IAAI,CACzB,CAAC,yBAAI,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC,EAC9C;YACE,IAAI,EAAE,iBAAiB;SACxB,CACF,CAAC;QACF,MAAM,GAAG,GAAW,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAsB,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;QAClB,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,KAAM,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC,EA/BgB,oBAAoB,aAApB,oBAAoB,GAApB,oBAAoB,QA+BpC"}
+{"version":3,"file":"NestiaEditorArchiver.js","sourceRoot":"","sources":["../../src/internal/NestiaEditorArchiver.ts"],"names":[],"mappings":";;;AAAA,mCAAkD;AAElD,6EAA6E;AAE7E;;;;;;;;;;;;;GAaG;AACH,IAAiB,oBAAoB,CA+EpC;AA/ED,WAAiB,oBAAoB;IACnC;;;;;;;OAOG;IACU,yBAAI,GAAG,CAAC,KAA6B,EAAc,EAAE;QAChE,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,YAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACvC,IAAI,KAAK;gBAAE,MAAM,KAAK,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,mBAAU,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,IAAA,gBAAO,EAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAC3D,CAAC;QACF,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF;;;;;;;;;;;;;OAaG;IACU,yBAAI,GAAG,CAAC,WAAmB,EAAU,EAAE;QAClD,MAAM,IAAI,GAAW,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1C,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,0DAA6B,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACrF,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC9C,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAElE;;;;;;;OAOG;IACU,6BAAQ,GAAG,CAAC,KAGxB,EAAQ,EAAE;QACT,MAAM,IAAI,GAAS,IAAI,IAAI,CACzB,CAAC,yBAAI,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC,EAC9C;YACE,IAAI,EAAE,iBAAiB;SACxB,CACF,CAAC;QACF,MAAM,GAAG,GAAW,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAsB,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;QAClB,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,KAAM,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC,EA/EgB,oBAAoB,aAApB,oBAAoB,GAApB,oBAAoB,QA+EpC"}

package/lib/internal/NestiaEditorArchiver.mjs

@@ -1,13 +1,33 @@
-import { strToU8, zipSync } from "fflate";
+import { NESTIA_EDITOR_DEFAULT_PACKAGE } from "./NestiaEditorDefaultPackage.mjs";
+import { Zip, ZipDeflate, strToU8 } from "fflate";
 //#region src/internal/NestiaEditorArchiver.ts
 let NestiaEditorArchiver;
 (function(_NestiaEditorArchiver) {
 	const pack = _NestiaEditorArchiver.pack = (files) => {
-		const entries = {};
-		for (const [key, value] of Object.entries(files)) entries[key] = strToU8(value);
-		return zipSync(entries);
+		const chunks = [];
+		const archive = new Zip((error, chunk) => {
+			if (error) throw error;
+			chunks.push(chunk);
+		});
+		for (const [key, value] of Object.entries(files)) {
+			const entry = new ZipDeflate(key);
+			archive.add(entry);
+			entry.push(strToU8(value), true);
+		}
+		archive.end();
+		const output = new Uint8Array(chunks.reduce((length, chunk) => length + chunk.length, 0));
+		let offset = 0;
+		for (const chunk of chunks) {
+			output.set(chunk, offset);
+			offset += chunk.length;
+		}
+		return output;
 	};
-	_NestiaEditorArchiver.name = (packageName) => `${packageName.replace(/^@/, "").replace(/[^A-Za-z0-9._-]+/g, "-")}.zip`;
+	_NestiaEditorArchiver.name = (packageName) => {
+		const base = compose(packageName);
+		return `${/^\.*$/.test(base) ? compose(NESTIA_EDITOR_DEFAULT_PACKAGE) : base}.zip`;
+	};
+	const compose = (packageName) => packageName.replace(/^@/, "").replace(/[^A-Za-z0-9._-]+/g, "-");
 	_NestiaEditorArchiver.download = (props) => {
 		const blob = new Blob([pack(props.files)], { type: "application/zip" });
 		const url = URL.createObjectURL(blob);

package/lib/internal/NestiaEditorComposer.d.ts

@@ -1,18 +1,98 @@
 import { OpenApiV3, OpenApiV3_1, OpenApiV3_2, SwaggerV2 } from "@typia/interface";
 import { IValidation } from "typia";
+/**
+ * Composes the files of a project from an OpenAPI document.
+ *
+ * It validates and converts the document with `@nestia/migrate`, then formats
+ * the TypeScript files with Prettier's standalone build.
+ *
+ * @evidence contracts/common.md#principled-implementation The composer delegates conversion to `NestiaMigrateApplication`, which owns the OpenAPI semantics, and formats each `.ts` output with Prettier; a file that fails to format keeps its unformatted text.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with two public entry points that select the migration mode and retain the legacy workspace launch metadata; the shared flow is one private curried function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Conversion and formatting use the public APIs of `@nestia/migrate` and Prettier; a formatting failure is logged and the file is kept as generated.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the composer produces and which libraries do the work.
+ */
 export declare namespace NestiaEditorComposer {
+    /**
+     * Input of the composer: the OpenAPI document, the generator options, and the
+     * package name.
+     *
+     * The internal `files` member bypasses conversion and returns the given files
+     * unchanged.
+     *
+     * @evidence contracts/common.md#principled-implementation The fields are the migrate options the editor exposes plus the document, and `files` lets a caller supply an already composed project.
+     * @evidence contracts/common.md#clear-and-simple-design A flat property record; the document type is the union of the supported OpenAPI and Swagger versions.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No field is defaulted here; the callers own the defaults.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the inputs and the internal member.
+     */
     interface IProps {
+        /** OpenAPI or Swagger source to validate before conversion. */
         document: SwaggerV2.IDocument | OpenApiV3.IDocument | OpenApiV3_1.IDocument | OpenApiV3_2.IDocument;
+        /** Include generated E2E functions. */
         e2e: boolean;
+        /** Group generated parameters into a keyword object. */
         keyword: boolean;
+        /** Include SDK mockup simulators. */
         simulate: boolean;
+        /** Package identity passed to the migration generator. */
         package?: string;
     }
+    /**
+     * Output of the composer: the files, the files to open, the start script, and
+     * the skipped operations.
+     *
+     * @evidence contracts/common.md#principled-implementation The files carry the downloadable project and skipped exposes incomplete conversion. openFile and startScript are legacy workspace metadata with no reader in the current zip UI.
+     * @evidence contracts/common.md#clear-and-simple-design A flat property record without behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Every member is produced by the composer or the migrate application; none is a fixture value.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the members and the `skipped` member documents itself.
+     */
     interface IOutput {
+        /** Relative project paths mapped to UTF-8 text. */
         files: Record<string, string>;
+        /** Legacy comma-separated workspace editor entry paths. */
         openFile: string;
+        /** Legacy workspace launch commands; zip downloads do not execute them. */
         startScript: string[];
+        /**
+         * Operations `@nestia/migrate` could not convert, left out of the files.
+         *
+         * The CLI prints them; the editor reports them to its user, so a project
+         * lacking an operation never passes for a complete one.
+         */
+        skipped: ISkipped[];
     }
+    /**
+     * An operation that could not be converted: its upper-case HTTP method, its
+     * path, and the reasons.
+     *
+     * @evidence contracts/common.md#principled-implementation The migrate application reports errors by method, path, and messages, and the composer normalizes the method to upper case for display.
+     * @evidence contracts/common.md#clear-and-simple-design Three fields with no behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are copied from the migrate errors.
+     * @evidence contracts/common.md#meaningful-documentation The comment states each field.
+     */
+    interface ISkipped {
+        /** Upper-case HTTP method identifying the omitted operation. */
+        method: string;
+        /** OpenAPI path identifying the omitted operation. */
+        path: string;
+        /** Conversion diagnostics supplied by the migrate application. */
+        messages: string[];
+    }
+    /**
+     * Composes a NestJS project from an OpenAPI document.
+     *
+     * @evidence contracts/common.md#principled-implementation It runs the shared flow with the migrate application's `nest` output, the `README.md,test/start.ts` files to open, and the `build:test,test` start script.
+     * @evidence contracts/common.md#clear-and-simple-design A one-expression binding of the shared flow.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The mode selects the public migrate operation. Returned launch metadata comes from the former embedded workspace flow; zip delivery does not read or execute it.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the project kind produced.
+     */
     const nest: (props: IProps) => Promise<IValidation<IOutput>>;
+    /**
+     * Composes a software development kit project from an OpenAPI document.
+     *
+     * @evidence contracts/common.md#principled-implementation It runs the shared flow with the migrate application's `sdk` output, the `README.md,test/start.ts` files to open, and the `swagger` and `hello` start scripts.
+     * @evidence contracts/common.md#clear-and-simple-design A one-expression binding of the shared flow.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The mode selects the public migrate operation. Returned launch metadata comes from the former embedded workspace flow; zip delivery does not read or execute it.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the project kind produced.
+     */
     const sdk: (props: IProps) => Promise<IValidation<IOutput>>;
 }

package/lib/internal/NestiaEditorComposer.js

@@ -50,13 +50,40 @@ const migrate_1 = __importDefault(require("@nestia/migrate"));
 const prettierEsTreePlugin = __importStar(require("prettier/plugins/estree"));
 const prettierTsPlugin = __importStar(require("prettier/plugins/typescript"));
 const standalone_1 = require("prettier/standalone");
+/**
+ * Composes the files of a project from an OpenAPI document.
+ *
+ * It validates and converts the document with `@nestia/migrate`, then formats
+ * the TypeScript files with Prettier's standalone build.
+ *
+ * @evidence contracts/common.md#principled-implementation The composer delegates conversion to `NestiaMigrateApplication`, which owns the OpenAPI semantics, and formats each `.ts` output with Prettier; a file that fails to format keeps its unformatted text.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace with two public entry points that select the migration mode and retain the legacy workspace launch metadata; the shared flow is one private curried function.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Conversion and formatting use the public APIs of `@nestia/migrate` and Prettier; a formatting failure is logged and the file is kept as generated.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the composer produces and which libraries do the work.
+ */
 var NestiaEditorComposer;
 (function (NestiaEditorComposer) {
+    /**
+     * Composes a NestJS project from an OpenAPI document.
+     *
+     * @evidence contracts/common.md#principled-implementation It runs the shared flow with the migrate application's `nest` output, the `README.md,test/start.ts` files to open, and the `build:test,test` start script.
+     * @evidence contracts/common.md#clear-and-simple-design A one-expression binding of the shared flow.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The mode selects the public migrate operation. Returned launch metadata comes from the former embedded workspace flow; zip delivery does not read or execute it.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the project kind produced.
+     */
     NestiaEditorComposer.nest = (props) => compose({
         openFile: "README.md,test/start.ts",
         startScript: ["build:test,test", ""],
         migrate: (app) => app.nest(props),
     })(props);
+    /**
+     * Composes a software development kit project from an OpenAPI document.
+     *
+     * @evidence contracts/common.md#principled-implementation It runs the shared flow with the migrate application's `sdk` output, the `README.md,test/start.ts` files to open, and the `swagger` and `hello` start scripts.
+     * @evidence contracts/common.md#clear-and-simple-design A one-expression binding of the shared flow.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The mode selects the public migrate operation. Returned launch metadata comes from the former embedded workspace flow; zip delivery does not read or execute it.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the project kind produced.
+     */
     NestiaEditorComposer.sdk = (props) => __awaiter(this, void 0, void 0, function* () {
         return compose({
             openFile: "README.md,test/start.ts",
@@ -72,6 +99,7 @@ var NestiaEditorComposer;
                     files: props.files,
                     openFile: config.openFile,
                     startScript: config.startScript,
+                    skipped: [],
                 },
             };
         const result = yield migrate_1.default.NestiaMigrateApplication.validate(props.document);
@@ -96,6 +124,11 @@ var NestiaEditorComposer;
                 files,
                 openFile: config.openFile,
                 startScript: config.startScript,
+                skipped: app.getData().errors.map((error) => ({
+                    method: error.method.toUpperCase(),
+                    path: error.path,
+                    messages: error.messages,
+                })),
             },
         };
     });

package/lib/internal/NestiaEditorComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaEditorComposer.js","sourceRoot":"","sources":["../../src/internal/NestiaEditorComposer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8DAAsC;AAQtC,MAAY,oBAAoB,oDAAgC;AAChE,MAAY,gBAAgB,wDAAoC;AAChE,oDAA6C;AAG7C,IAAiB,oBAAoB,CA2EpC;AA3ED,WAAiB,oBAAoB;IAoBtB,yBAAI,GAAG,CAAC,KAAa,EAAiC,EAAE,CACnE,OAAO,CAAC;QACN,QAAQ,EAAE,yBAAyB;QACnC,WAAW,EAAE,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;KAClC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEC,wBAAG,GAAG,CAAO,KAAa,EAAiC,EAAE;QACxE,OAAA,OAAO,CAAC;YACN,QAAQ,EAAE,yBAAyB;YACnC,WAAW,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;YACjC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;SACjC,CAAC,CAAC,KAAK,CAAC,CAAA;IAAA,CAAC,CAAD,CAAC;IAEZ,MAAM,OAAO,GACX,CAAC,MAIA,EAAE,EAAE,CACL,CAAO,KAAa,EAAiC,EAAE;QACrD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAC3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;iBAChC;aACF,CAAC;QACJ,MAAM,MAAM,GACV,MAAM,iBAAO,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO,MAAM,CAAC;QAE5C,MAAM,GAAG,GAA6B,MAAM,CAAC,IAAI,CAAC;QAClD,MAAM,KAAK,GAA2B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9C,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,KAAK;gBACzC,IAAI,CAAC;oBACH,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,IAAA,mBAAM,EAAC,KAAK,EAAE;wBAC/B,MAAM,EAAE,YAAY;wBACpB,OAAO,EAAE,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;qBAClD,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;QACL,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,KAAK;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC;SAC6B,CAAC;IACnC,CAAC,CAAA,CAAC;AACN,CAAC,EA3EgB,oBAAoB,aAApB,oBAAoB,GAApB,oBAAoB,QA2EpC"}
+{"version":3,"file":"NestiaEditorComposer.js","sourceRoot":"","sources":["../../src/internal/NestiaEditorComposer.ts"],"names":[],"mappings":"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"}