zudojs-cli 2.1.2 → 2.2.0

package/dist/src/generators/frontend/frontendPipeline.js

@@ -157,4 +157,3 @@ async function recordDependencies(projectPath, dependencies, devDependencies) {
         "package.json": JSON.stringify(pkg, null, 2) + "\n",
     });
 }
-//# sourceMappingURL=frontendPipeline.js.map

package/dist/src/generators/frontend/index.d.ts

@@ -4,4 +4,3 @@
  * Frontend project generator using framework adapters.
  */
 export { FrontendGenerator } from "./frontendGenerator.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/frontend/index.js

@@ -4,4 +4,3 @@
  * Frontend project generator using framework adapters.
  */
 export { FrontendGenerator } from "./frontendGenerator.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/fullstack/fullstackBackend.layout.d.ts

@@ -23,4 +23,3 @@ export interface FullstackBackendLayout {
  * compose file, README) are dropped: the fullstack root owns those.
  */
 export declare function layoutFullstackBackend(architecture: string, backendFiles: Readonly<Record<string, string>>): FullstackBackendLayout;
-//# sourceMappingURL=fullstackBackend.layout.d.ts.map

package/dist/src/generators/fullstack/fullstackBackend.layout.js

@@ -31,4 +31,3 @@ export function layoutFullstackBackend(architecture, backendFiles) {
         createdDirectories: ["apps/gateway", "apps/services"],
     };
 }
-//# sourceMappingURL=fullstackBackend.layout.js.map

package/dist/src/generators/fullstack/fullstackComposer.core.d.ts

@@ -40,4 +40,3 @@ export declare class FullstackComposer {
     private generateSharedPackages;
     private generateFrontend;
 }
-//# sourceMappingURL=fullstackComposer.core.d.ts.map

package/dist/src/generators/fullstack/fullstackComposer.core.js

@@ -180,4 +180,3 @@ export type Timestamp = string;
         return ["apps/web/"];
     }
 }
-//# sourceMappingURL=fullstackComposer.core.js.map

package/dist/src/generators/fullstack/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { FullstackComposer } from "./fullstackComposer.core.js";
 export { layoutFullstackBackend, type FullstackBackendLayout, } from "./fullstackBackend.layout.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/fullstack/index.js

@@ -5,4 +5,3 @@
  */
 export { FullstackComposer } from "./fullstackComposer.core.js";
 export { layoutFullstackBackend, } from "./fullstackBackend.layout.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/index.d.ts

@@ -11,4 +11,3 @@ export { generateModule } from "./module/module.generator.js";
 export { generateCommand } from "./command/command.generator.js";
 export { generateQuery } from "./query/query.generator.js";
 export { generateResource, resolveResourceLayout, planResource, RESOURCE_SCHEMATICS, } from "./resource/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/index.js

@@ -11,4 +11,3 @@ export { generateModule } from "./module/module.generator.js";
 export { generateCommand } from "./command/command.generator.js";
 export { generateQuery } from "./query/query.generator.js";
 export { generateResource, resolveResourceLayout, planResource, RESOURCE_SCHEMATICS, } from "./resource/index.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/infrastructure/index.d.ts

@@ -4,4 +4,3 @@
  * Generates Docker, docker-compose, and database infrastructure files.
  */
 export { InfrastructureGenerator, type InfrastructureOptions, } from "./infrastructure.generator.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/infrastructure/index.js

@@ -4,4 +4,3 @@
  * Generates Docker, docker-compose, and database infrastructure files.
  */
 export { InfrastructureGenerator, } from "./infrastructure.generator.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/infrastructure/infrastructure.generator.d.ts

@@ -24,4 +24,3 @@ export declare class InfrastructureGenerator {
     private getSimpleDockerCompose;
     private getDockerCompose;
 }
-//# sourceMappingURL=infrastructure.generator.d.ts.map

package/dist/src/generators/infrastructure/infrastructure.generator.js

@@ -152,4 +152,3 @@ ${dependsOn}`;
         return `services:${serviceDefs}${db ? `\n${this.getDbServiceBlock(db)}` : ""}`;
     }
 }
-//# sourceMappingURL=infrastructure.generator.js.map

package/dist/src/generators/integration/index.d.ts

@@ -4,4 +4,3 @@
  * Generates integration files between frontend and backend (API client, CORS, env files, proxy).
  */
 export { IntegrationGenerator } from "./integrationGenerator.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/integration/index.js

@@ -4,4 +4,3 @@
  * Generates integration files between frontend and backend (API client, CORS, env files, proxy).
  */
 export { IntegrationGenerator } from "./integrationGenerator.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/integration/integrationGenerator.core.d.ts

@@ -35,4 +35,3 @@ export declare class IntegrationGenerator {
     private generateCorsConfig;
     private generateViteProxy;
 }
-//# sourceMappingURL=integrationGenerator.core.d.ts.map

package/dist/src/generators/integration/integrationGenerator.core.js

@@ -238,4 +238,3 @@ export default defineConfig({
 `;
     }
 }
-//# sourceMappingURL=integrationGenerator.core.js.map

package/dist/src/generators/job/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Job Generator
  */
 export { generateJob, type GenerateJobOptions } from "./job.generator.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/job/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Job Generator
  */
 export { generateJob } from "./job.generator.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/job/job.generator.d.ts

@@ -9,4 +9,3 @@ export interface GenerateJobOptions {
     readonly dryRun?: boolean;
 }
 export declare function generateJob(options: GenerateJobOptions, cwd: string): Promise<string[]>;
-//# sourceMappingURL=job.generator.d.ts.map

package/dist/src/generators/job/job.generator.js

@@ -24,4 +24,3 @@ export async function ${nameCamel}Job() {
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }
-//# sourceMappingURL=job.generator.js.map

package/dist/src/generators/middleware/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * zudojs-cli — Middleware Generator
  */
-export { generateMiddleware, type GenerateMiddlewareOptions, } from "./middleware.generator.js";
-//# sourceMappingURL=index.d.ts.map
+export { generateMiddleware, middlewareAppSrc, middlewareServerLines, type GenerateMiddlewareOptions, type MiddlewareRegistration, } from "./middleware.generator.js";
+export { renderMiddlewareFile, type MiddlewareFileOptions } from "./middleware.template.js";

package/dist/src/generators/middleware/index.js

@@ -1,5 +1,5 @@
 /**
  * zudojs-cli — Middleware Generator
  */
-export { generateMiddleware, } from "./middleware.generator.js";
-//# sourceMappingURL=index.js.map
+export { generateMiddleware, middlewareAppSrc, middlewareServerLines, } from "./middleware.generator.js";
+export { renderMiddlewareFile } from "./middleware.template.js";

package/dist/src/generators/middleware/middleware.generator.d.ts

@@ -1,12 +1,38 @@
 /**
  * zudojs-cli — Middleware Generator
  *
- * Generates middleware files.
+ * Writes `<basePath>/middlewares/<name>.middleware.ts` (an `HttpMiddleware`
+ * from @zudojs/http), exports it from the folder barrel and registers it in
+ * the app's `src/server.ts` between the `zudojs:server-imports` and
+ * `zudojs:server-middleware` markers. A server.ts missing either marker pair
+ * is left unchanged (no import without its registration) and the lines to
+ * add by hand are reported instead.
  */
 export interface GenerateMiddlewareOptions {
     readonly name: string;
     readonly basePath: string;
     readonly dryRun?: boolean;
+    /** Receives the registration outcome (e.g. lines to add by hand). */
+    readonly onRegistered?: (registration: MiddlewareRegistration) => void;
 }
+/** Outcome of registering a generated middleware in `server.ts`. */
+export interface MiddlewareRegistration {
+    /** Whether server.ts now runs the middleware. */
+    readonly registered: boolean;
+    /** The server file it was (or should be) registered in. */
+    readonly serverFile: string;
+    /** Lines to add by hand when `registered` is false. */
+    readonly manualSteps: readonly string[];
+}
+/**
+ * The app source directory owning `basePath`: `src` for `src` and
+ * `src/modules/billing`, `apps/services/x/src` for a service.
+ */
+export declare function middlewareAppSrc(basePath: string): string;
+/** The import and pipeline lines that register `factoryName` in server.ts. */
+export declare function middlewareServerLines(basePath: string, factoryName: string): {
+    readonly serverFile: string;
+    readonly importLine: string;
+    readonly entryLine: string;
+};
 export declare function generateMiddleware(options: GenerateMiddlewareOptions, cwd: string): Promise<string[]>;
-//# sourceMappingURL=middleware.generator.d.ts.map

package/dist/src/generators/middleware/middleware.generator.js

@@ -1,29 +1,73 @@
 /**
  * zudojs-cli — Middleware Generator
  *
- * Generates middleware files.
+ * Writes `<basePath>/middlewares/<name>.middleware.ts` (an `HttpMiddleware`
+ * from @zudojs/http), exports it from the folder barrel and registers it in
+ * the app's `src/server.ts` between the `zudojs:server-imports` and
+ * `zudojs:server-middleware` markers. A server.ts missing either marker pair
+ * is left unchanged (no import without its registration) and the lines to
+ * add by hand are reported instead.
  */
-import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { posix } from "node:path";
+import { CLIValidationError } from "../../errors/index.js";
+import { mergeBarrelExport, writeFileTree } from "../../utils/utils.fileSystem.js";
 import { normalizeName, toCamelCase } from "../../utils/utils.name.js";
+import { MARKERS, applyMarkerEdits, conflictingImport, planMarkerEdits, } from "../../wiring/index.js";
+import { renderMiddlewareFile } from "./middleware.template.js";
+/**
+ * The app source directory owning `basePath`: `src` for `src` and
+ * `src/modules/billing`, `apps/services/x/src` for a service.
+ */
+export function middlewareAppSrc(basePath) {
+    return basePath.replace(/\/modules\/[^/]+$/, "");
+}
+/** The import and pipeline lines that register `factoryName` in server.ts. */
+export function middlewareServerLines(basePath, factoryName) {
+    const appSrc = middlewareAppSrc(basePath);
+    const barrel = posix.relative(appSrc, `${basePath}/middlewares/index.js`);
+    return {
+        serverFile: `${appSrc}/server.ts`,
+        importLine: `import { ${factoryName} } from "./${barrel}";`,
+        entryLine: `${factoryName}(),`,
+    };
+}
 export async function generateMiddleware(options, cwd) {
     const name = normalizeName(options.name);
-    const nameCamel = toCamelCase(options.name);
+    const factoryName = `${toCamelCase(options.name)}Middleware`;
+    const lines = middlewareServerLines(options.basePath, factoryName);
+    const barrel = `${options.basePath}/middlewares/index.ts`;
+    const clash = conflictingImport(cwd, lines.serverFile, lines.importLine);
+    if (clash !== undefined) {
+        throw new CLIValidationError(`${lines.serverFile} already imports ${factoryName} (${clash.trim()}), so middleware "${name}" cannot be registered. Choose another name.`);
+    }
     const files = {
-        [`${options.basePath}/middlewares/${name}.middleware.ts`]: `/**
- * ${name} middleware.
- */
-
-export function ${nameCamel}Middleware() {
-  return async (ctx: unknown, next: () => Promise<void>) => {
-    await next();
-  };
-}
-`,
+        [`${options.basePath}/middlewares/${name}.middleware.ts`]: renderMiddlewareFile({
+            name,
+            factoryName,
+            serverFile: lines.serverFile,
+        }),
+        [barrel]: mergeBarrelExport(cwd, barrel, `export { ${factoryName} } from "./${name}.middleware.js";`),
     };
+    const edits = [
+        { file: lines.serverFile, marker: MARKERS.serverImports, line: lines.importLine },
+        { file: lines.serverFile, marker: MARKERS.serverMiddleware, line: lines.entryLine },
+    ];
+    const planned = planMarkerEdits(cwd, edits).outcome;
+    const registered = planned.manualSteps.length === 0;
     if (options.dryRun) {
-        return Object.keys(files);
+        return [...Object.keys(files), ...(registered ? planned.edited : [])];
     }
     await writeFileTree(cwd, files);
-    return Object.keys(files);
+    const edited = registered ? (await applyMarkerEdits(cwd, edits)).edited : [];
+    options.onRegistered?.({
+        registered,
+        serverFile: lines.serverFile,
+        manualSteps: registered
+            ? []
+            : [
+                `In ${lines.serverFile}: ${lines.importLine}`,
+                `In ${lines.serverFile}: add ${lines.entryLine} to the middlewares list of the HttpMiddlewarePipeline, before dispatch`,
+            ],
+    });
+    return [...Object.keys(files), ...edited];
 }
-//# sourceMappingURL=middleware.generator.js.map

package/dist/src/generators/middleware/middleware.template.d.ts

@@ -0,0 +1,20 @@
+/**
+ * zudojs-cli — Generated `<name>.middleware.ts`.
+ *
+ * `generate middleware` used to write
+ * `(ctx: unknown, next: () => Promise<void>) => Promise<void>`: registering
+ * it in the server pipeline failed tsc with TS2322, and because it returned
+ * nothing the response produced by `next()` was dropped. The file is now a
+ * real `HttpMiddleware` from @zudojs/http that returns `next()`'s response.
+ */
+/** Options for {@link renderMiddlewareFile}. */
+export interface MiddlewareFileOptions {
+    /** Normalized (kebab-case) name, e.g. `request-timer`. */
+    readonly name: string;
+    /** Factory function name, e.g. `requestTimerMiddleware`. */
+    readonly factoryName: string;
+    /** Where the factory is registered, e.g. `src/server.ts`. */
+    readonly serverFile: string;
+}
+/** Renders the middleware source file. */
+export declare function renderMiddlewareFile(options: MiddlewareFileOptions): string;

package/dist/src/generators/middleware/middleware.template.js

@@ -0,0 +1,34 @@
+/**
+ * zudojs-cli — Generated `<name>.middleware.ts`.
+ *
+ * `generate middleware` used to write
+ * `(ctx: unknown, next: () => Promise<void>) => Promise<void>`: registering
+ * it in the server pipeline failed tsc with TS2322, and because it returned
+ * nothing the response produced by `next()` was dropped. The file is now a
+ * real `HttpMiddleware` from @zudojs/http that returns `next()`'s response.
+ */
+/** Renders the middleware source file. */
+export function renderMiddlewareFile(options) {
+    return `import type { HttpMiddleware } from "@zudojs/http";
+
+/**
+ * ${options.name} middleware.
+ *
+ * It runs when \`${options.factoryName}()\` is in the \`middlewares\` list of
+ * ${options.serverFile}, between the \`// zudojs:server-middleware\` markers:
+ * after the security headers, CORS and rate limit, before routing.
+ * \`zudojs generate middleware\` adds it there when the markers exist.
+ *
+ * To answer without calling \`next()\`, return a response such as
+ * \`createResponseContext({ status: 403 }).json({ error: "Forbidden" })\`.
+ * Otherwise return what \`next()\` resolves to, and \`clone()\` it before
+ * changing its headers.
+ */
+export function ${options.factoryName}(): HttpMiddleware {
+  return async (_context, next) => {
+    const response = await next();
+    return response;
+  };
+}
+`;
+}

package/dist/src/generators/model/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Model Generator
  */
 export { generateModel, type GenerateModelOptions } from "./model.generator.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/model/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Model Generator
  */
 export { generateModel } from "./model.generator.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/model/model.generator.d.ts

@@ -9,4 +9,3 @@ export interface GenerateModelOptions {
     readonly dryRun?: boolean;
 }
 export declare function generateModel(options: GenerateModelOptions, cwd: string): Promise<string[]>;
-//# sourceMappingURL=model.generator.d.ts.map

package/dist/src/generators/model/model.generator.js

@@ -26,4 +26,3 @@ export interface ${namePascal}Model {
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }
-//# sourceMappingURL=model.generator.js.map

package/dist/src/generators/module/index.d.ts

@@ -3,4 +3,3 @@
  */
 export { generateModule, type GenerateModuleOptions, } from "./module.generator.js";
 export { registerModuleInApp, type ModuleRegistration, } from "./module.registration.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/module/index.js

@@ -3,4 +3,3 @@
  */
 export { generateModule, } from "./module.generator.js";
 export { registerModuleInApp, } from "./module.registration.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/module/module.generator.d.ts

@@ -15,4 +15,3 @@ export interface GenerateModuleOptions {
     readonly onRegistered?: (registration: ModuleRegistration) => void;
 }
 export declare function generateModule(options: GenerateModuleOptions, cwd: string): Promise<string[]>;
-//# sourceMappingURL=module.generator.d.ts.map

package/dist/src/generators/module/module.generator.js

@@ -12,7 +12,7 @@ import { assertGeneratableName, toPascalCase } from "../../utils/utils.name.js";
 import { moduleSpec, renderModuleFile } from "../../templates/shared/appRuntime.template.js";
 import { registerModuleInApp } from "./module.registration.js";
 import { moduleRoutesWiring, renderModuleRoutesIndex, } from "../../templates/backendApp/index.js";
-import { MARKERS, applyMarkerEdits, conflictingImport } from "../../wiring/index.js";
+import { MARKERS, applyMarkerEdits, conflictingImport, planMarkerEdits, } from "../../wiring/index.js";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 export async function generateModule(options, cwd) {
@@ -48,11 +48,34 @@ export class ${namePascal}Feature {
     if (clash !== undefined) {
         throw new CLIValidationError(`${appRoutes} already imports ${routes.functionName} (${clash.trim()}), so module "${name}" cannot register its routes. Choose another name.`);
     }
+    const routeEditList = hasAppRoutes
+        ? [
+            { file: appRoutes, marker: MARKERS.routeImports, line: routes.importLine },
+            { file: appRoutes, marker: MARKERS.routes, line: routes.entryLine },
+        ]
+        : [];
     if (hasAppRoutes) {
         files[`${basePath}/${name}/routes/index.ts`] = renderModuleRoutesIndex(routes.functionName, "../../../container.js");
+        // Checked before anything is written: a routes index without its
+        // markers used to be reported after the files existed, as a warning on
+        // a run that exited 0, and the module's routes answered 404.
+        const { manualSteps } = planMarkerEdits(cwd, routeEditList).outcome;
+        if (manualSteps.length > 0) {
+            throw new CLIValidationError(`Cannot register the routes of module "${name}": ${appRoutes} is missing its markers, so nothing was written.
+${manualSteps
+                .map((step) => `  - ${step}`)
+                .join("\n")}\nRestore the marker comments and re-run.`);
+        }
     }
+    const appPath = `${dirname(basePath)}/app.ts`;
+    const appImport = `./${basename(basePath)}/index.js`;
     if (options.dryRun) {
-        return hasAppRoutes ? [...Object.keys(files), appRoutes] : Object.keys(files);
+        const registration = registerModuleInApp(cwd, appPath, spec.className, appImport, true);
+        return [
+            ...Object.keys(files),
+            ...(hasAppRoutes ? [appRoutes] : []),
+            ...(registration.registered ? [appPath] : []),
+        ];
     }
     try {
         await writeFileTree(cwd, files);
@@ -60,14 +83,8 @@ export class ${namePascal}Feature {
     catch (error) {
         throw new CLIGenerationError(`Failed to generate module: ${name}`, error);
     }
-    const routeEdits = hasAppRoutes
-        ? await applyMarkerEdits(cwd, [
-            { file: appRoutes, marker: MARKERS.routeImports, line: routes.importLine },
-            { file: appRoutes, marker: MARKERS.routes, line: routes.entryLine },
-        ])
-        : undefined;
-    const appPath = `${dirname(basePath)}/app.ts`;
-    const registration = registerModuleInApp(cwd, appPath, spec.className, `./${basename(basePath)}/index.js`);
+    const routeEdits = hasAppRoutes ? await applyMarkerEdits(cwd, routeEditList) : undefined;
+    const registration = registerModuleInApp(cwd, appPath, spec.className, appImport);
     options.onRegistered?.(routeEdits && routeEdits.manualSteps.length > 0
         ? {
             registered: registration.registered,
@@ -80,4 +97,3 @@ export class ${namePascal}Feature {
         ...(routeEdits?.edited ?? []),
     ];
 }
-//# sourceMappingURL=module.generator.js.map

package/dist/src/generators/module/module.registration.d.ts

@@ -17,7 +17,8 @@ export interface ModuleRegistration {
 /**
  * Adds `new <className>()` to the module list in `appPath` and imports it
  * from `importPath`. Idempotent. Leaves a hand-edited app.ts it does not
- * recognise untouched and returns the lines to add instead.
+ * recognise untouched and returns the lines to add instead. With `dryRun`
+ * it reports the outcome and writes nothing, so a dry run can list app.ts
+ * among the files a real run would change.
  */
-export declare function registerModuleInApp(cwd: string, appPath: string, className: string, importPath: string): ModuleRegistration;
-//# sourceMappingURL=module.registration.d.ts.map
+export declare function registerModuleInApp(cwd: string, appPath: string, className: string, importPath: string, dryRun?: boolean): ModuleRegistration;

package/dist/src/generators/module/module.registration.js

@@ -15,9 +15,11 @@ const MODULE_LIST = "  for (const module of [\n";
 /**
  * Adds `new <className>()` to the module list in `appPath` and imports it
  * from `importPath`. Idempotent. Leaves a hand-edited app.ts it does not
- * recognise untouched and returns the lines to add instead.
+ * recognise untouched and returns the lines to add instead. With `dryRun`
+ * it reports the outcome and writes nothing, so a dry run can list app.ts
+ * among the files a real run would change.
  */
-export function registerModuleInApp(cwd, appPath, className, importPath) {
+export function registerModuleInApp(cwd, appPath, className, importPath, dryRun = false) {
     const importLine = `import { ${className} } from "${importPath}";`;
     const entry = `    new ${className}(),\n`;
     const manualSteps = [
@@ -43,8 +45,7 @@ export function registerModuleInApp(cwd, appPath, className, importPath) {
         source.slice(insertAt);
     // During the overwrite check the generator runs with writes captured; the
     // registration is an intended edit, not a conflict, so it is skipped then.
-    if (!activeWriteCapture())
+    if (!dryRun && !activeWriteCapture())
         writeFileSync(fullPath, updated);
     return { registered: true, manualSteps: [] };
 }
-//# sourceMappingURL=module.registration.js.map

package/dist/src/generators/project/project.generator.d.ts

@@ -5,4 +5,3 @@ export interface GenerateProjectResult {
 }
 export declare function generateProject(options: ScaffoldOptions, basePath?: string): Promise<GenerateProjectResult>;
 export declare function getZudojsVersion(): string;
-//# sourceMappingURL=project.generator.d.ts.map

package/dist/src/generators/project/project.generator.js

@@ -48,4 +48,3 @@ export async function generateProject(options, basePath = ".") {
 export function getZudojsVersion() {
     return CLI_VERSION;
 }
-//# sourceMappingURL=project.generator.js.map

package/dist/src/generators/query/index.d.ts

@@ -3,4 +3,3 @@
  * `QueryHandler` subclass for @zudojs/cqrs.
  */
 export * from "./query.generator.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/query/index.js

@@ -3,4 +3,3 @@
  * `QueryHandler` subclass for @zudojs/cqrs.
  */
 export * from "./query.generator.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/query/query.generator.d.ts

@@ -16,4 +16,3 @@ export interface GenerateQueryOptions {
  * their paths (only the paths on a dry run).
  */
 export declare function generateQuery(options: GenerateQueryOptions, cwd: string): Promise<string[]>;
-//# sourceMappingURL=query.generator.d.ts.map

package/dist/src/generators/query/query.generator.js

@@ -37,4 +37,3 @@ export async function generateQuery(options, cwd) {
         throw new CLIGenerationError(`Failed to generate query: ${names.slug} in ${servicePath}`, error);
     }
 }
-//# sourceMappingURL=query.generator.js.map

package/dist/src/generators/query/query.template.d.ts

@@ -11,4 +11,3 @@ export declare function renderQueryFile(n: CqrsSchematicNames): string;
 export declare function renderQueryHandlerFile(n: CqrsSchematicNames): string;
 /** `index.ts`: the query folder's barrel. */
 export declare function renderQueryBarrel(n: CqrsSchematicNames): string;
-//# sourceMappingURL=query.template.d.ts.map

package/dist/src/generators/query/query.template.js

@@ -69,4 +69,3 @@ export function renderQueryBarrel(n) {
 export * from "./${n.slug}.handler.js";
 `;
 }
-//# sourceMappingURL=query.template.js.map

package/dist/src/generators/resource/index.d.ts

@@ -5,4 +5,3 @@ export * from "./resource.plan.js";
 export * from "./resource.generator.js";
 export * from "./resource.layout.js";
 export * from "./resource.run.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/generators/resource/index.js

@@ -5,4 +5,3 @@ export * from "./resource.plan.js";
 export * from "./resource.generator.js";
 export * from "./resource.layout.js";
 export * from "./resource.run.js";
-//# sourceMappingURL=index.js.map

package/dist/src/generators/resource/resource.checks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * zudojs-cli — What must hold before a resource schematic writes anything.
+ *
+ * Every check runs before the first file is written, so a refused run
+ * leaves the project exactly as it was: the schematic's own files must not
+ * exist (unless `--force`), the container key and the routes import must be
+ * free, and — when the schematic registers itself — the marker pairs it
+ * inserts into must be present. A missing marker used to be a warning
+ * printed after the files were written and the run had "succeeded", with
+ * the unregistered routes answering 404.
+ */
+import { type ResourceLayout, type ResourceNames, type ResourceWiring } from "../../templates/resource/index.js";
+import { type MarkerEdit } from "../../wiring/index.js";
+import type { ResourcePlan, ResourceSchematic } from "./resource.plan.js";
+/** Inputs of {@link assertResourceWritable}. */
+export interface ResourceCheckInput {
+    readonly cwd: string;
+    readonly schematic: ResourceSchematic;
+    readonly names: ResourceNames;
+    readonly layout: ResourceLayout;
+    readonly plan: ResourcePlan;
+    readonly wiring: ResourceWiring;
+    readonly edits: readonly MarkerEdit[];
+    readonly force: boolean;
+}
+/**
+ * Throws a {@link CLIValidationError} when the schematic cannot be written
+ * cleanly; returns the schematic's own files that already exist (empty
+ * unless `force`).
+ */
+export declare function assertResourceWritable(input: ResourceCheckInput): readonly string[];