zudojs-cli 2.1.3 → 2.2.0

package/dist/src/resolvers/dependency/dependencyResolver.core.d.ts

@@ -40,4 +40,3 @@ export declare class DependencyResolver {
     resolve(requirements: readonly DependencyRequirement[]): DependencyResolutionResult;
     private checkConflicts;
 }
-//# sourceMappingURL=dependencyResolver.core.d.ts.map

package/dist/src/resolvers/dependency/dependencyResolver.core.js

@@ -99,4 +99,3 @@ export class DependencyResolver {
         return null;
     }
 }
-//# sourceMappingURL=dependencyResolver.core.js.map

package/dist/src/resolvers/dependency/dependencyVersions.constant.d.ts

@@ -104,4 +104,3 @@ export declare const ANGULAR_VITEST_VERSION_RANGE = "^4.1.11";
  * no version of their own.
  */
 export declare const DEFAULT_DEPENDENCY_VERSIONS: ReadonlyMap<string, string>;
-//# sourceMappingURL=dependencyVersions.constant.d.ts.map

package/dist/src/resolvers/dependency/dependencyVersions.constant.js

@@ -106,4 +106,3 @@ export const ANGULAR_VITEST_VERSION_RANGE = "^4.1.11";
  * no version of their own.
  */
 export const DEFAULT_DEPENDENCY_VERSIONS = new Map(Object.entries(DEPENDENCY_VERSION_RANGES));
-//# sourceMappingURL=dependencyVersions.constant.js.map

package/dist/src/resolvers/dependency/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { DependencyResolver, type DependencyResolutionResult, type ResolvedDependency, type DependencyConflict, } from "./dependencyResolver.core.js";
 export { ANGULAR_VITEST_VERSION_RANGE, DEFAULT_DEPENDENCY_VERSIONS, DEPENDENCY_VERSION_RANGES, TYPESCRIPT_VERSION_RANGES, } from "./dependencyVersions.constant.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/resolvers/dependency/index.js

@@ -5,4 +5,3 @@
  */
 export { DependencyResolver, } from "./dependencyResolver.core.js";
 export { ANGULAR_VITEST_VERSION_RANGE, DEFAULT_DEPENDENCY_VERSIONS, DEPENDENCY_VERSION_RANGES, TYPESCRIPT_VERSION_RANGES, } from "./dependencyVersions.constant.js";
-//# sourceMappingURL=index.js.map

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

@@ -8,4 +8,3 @@ export { resolveProjectPath, findProjectRoot } from "./project.resolver.js";
 export { CapabilityResolver, type CapabilityDependency, type CapabilityResolutionResult, } from "./capability/index.js";
 export { ConfigurationResolver, type ResolvedConfiguration, } from "./configuration/index.js";
 export { resolveProjectLayout, detectPackageManager, type ProjectLayout, type ProjectLayoutType, type ProjectLayoutSource, } from "./layout/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/resolvers/index.js

@@ -8,4 +8,3 @@ export { resolveProjectPath, findProjectRoot } from "./project.resolver.js";
 export { CapabilityResolver, } from "./capability/index.js";
 export { ConfigurationResolver, } from "./configuration/index.js";
 export { resolveProjectLayout, detectPackageManager, } from "./layout/index.js";
-//# sourceMappingURL=index.js.map

package/dist/src/resolvers/layout/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Project Layout Resolver
  */
 export { resolveProjectLayout, detectPackageManager, type ProjectLayout, type ProjectLayoutType, type ProjectLayoutSource, } from "./projectLayout.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/resolvers/layout/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Project Layout Resolver
  */
 export { resolveProjectLayout, detectPackageManager, } from "./projectLayout.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/resolvers/layout/projectLayout.core.d.ts

@@ -57,4 +57,3 @@ export declare function detectPackageManager(root: string): PackageManager;
  * no legacy config and no `zudojs` block in `package.json`.
  */
 export declare function resolveProjectLayout(cwd: string): ProjectLayout | null;
-//# sourceMappingURL=projectLayout.core.d.ts.map

package/dist/src/resolvers/layout/projectLayout.core.js

@@ -228,4 +228,3 @@ export function resolveProjectLayout(cwd) {
         source: raw.source,
     };
 }
-//# sourceMappingURL=projectLayout.core.js.map

package/dist/src/resolvers/project.resolver.d.ts

@@ -24,4 +24,3 @@ export interface FindProjectRootOptions {
  */
 export declare function findProjectRoot(startDir?: string, options?: FindProjectRootOptions): string | null;
 export declare function resolveProjectPath(cwd: string, name: string): string;
-//# sourceMappingURL=project.resolver.d.ts.map

package/dist/src/resolvers/project.resolver.js

@@ -35,4 +35,3 @@ export function findProjectRoot(startDir = process.cwd(), options = {}) {
 export function resolveProjectPath(cwd, name) {
     return join(cwd, name);
 }
-//# sourceMappingURL=project.resolver.js.map

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

@@ -4,4 +4,3 @@
  * Rollback system barrel exports.
  */
 export { RollbackManager, type RollbackEntry, type RollbackFailure, type RollbackResult, } from "./rollbackManager.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/rollback/index.js

@@ -4,4 +4,3 @@
  * Rollback system barrel exports.
  */
 export { RollbackManager, } from "./rollbackManager.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/rollback/rollbackManager.core.d.ts

@@ -34,4 +34,3 @@ export declare class RollbackManager {
     get entriesCount(): number;
     clear(): void;
 }
-//# sourceMappingURL=rollbackManager.core.d.ts.map

package/dist/src/rollback/rollbackManager.core.js

@@ -63,4 +63,3 @@ export class RollbackManager {
         this.entries.length = 0;
     }
 }
-//# sourceMappingURL=rollbackManager.core.js.map

package/dist/src/runners/package-manager/index.d.ts

@@ -4,4 +4,3 @@
  * Runners for package manager operations.
  */
 export { PackageManagerRunner, assertPackageManager, type PackageManagerRunOptions, } from "./packageManagerRunner.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/runners/package-manager/index.js

@@ -4,4 +4,3 @@
  * Runners for package manager operations.
  */
 export { PackageManagerRunner, assertPackageManager, } from "./packageManagerRunner.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/runners/package-manager/packageManagerRunner.core.d.ts

@@ -27,4 +27,3 @@ export declare class PackageManagerRunner {
     addDev(packages: readonly string[], options: PackageManagerRunOptions): Promise<void>;
     run(script: string, options: PackageManagerRunOptions): Promise<void>;
 }
-//# sourceMappingURL=packageManagerRunner.core.d.ts.map

package/dist/src/runners/package-manager/packageManagerRunner.core.js

@@ -68,4 +68,3 @@ export class PackageManagerRunner {
         await execCommand(this.manager, args, options.cwd);
     }
 }
-//# sourceMappingURL=packageManagerRunner.core.js.map

package/dist/src/runners/process/index.d.ts

@@ -4,4 +4,3 @@
  * Runners for executing system processes.
  */
 export { ProcessRunner, type ProcessOptions } from "./processRunner.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/runners/process/index.js

@@ -4,4 +4,3 @@
  * Runners for executing system processes.
  */
 export { ProcessRunner } from "./processRunner.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/runners/process/processRunner.core.d.ts

@@ -33,4 +33,3 @@ export declare class ProcessRunner {
         pid: number;
     }>;
 }
-//# sourceMappingURL=processRunner.core.d.ts.map

package/dist/src/runners/process/processRunner.core.js

@@ -74,4 +74,3 @@ export class ProcessRunner {
         });
     }
 }
-//# sourceMappingURL=processRunner.core.js.map

package/dist/src/runners/task/index.d.ts

@@ -4,4 +4,3 @@
  * Runners for executing development tasks.
  */
 export { TaskRunner, type TaskDefinition, type TaskResult, type TaskRunOptions, } from "./taskRunner.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/runners/task/index.js

@@ -4,4 +4,3 @@
  * Runners for executing development tasks.
  */
 export { TaskRunner, } from "./taskRunner.core.js";
-//# sourceMappingURL=index.js.map

package/dist/src/runners/task/taskRunner.core.d.ts

@@ -41,4 +41,3 @@ export declare class TaskRunner {
      */
     runParallel(tasks: readonly TaskDefinition[]): Promise<readonly TaskResult[]>;
 }
-//# sourceMappingURL=taskRunner.core.d.ts.map

package/dist/src/runners/task/taskRunner.core.js

@@ -59,4 +59,3 @@ export class TaskRunner {
         return results;
     }
 }
-//# sourceMappingURL=taskRunner.core.js.map

package/dist/src/scaffolders/framework.scaffolder.d.ts

@@ -69,4 +69,3 @@ export declare class ReactNativeScaffolder extends FrameworkScaffolder {
     readonly command = "npx";
     readonly args: string[];
 }
-//# sourceMappingURL=framework.scaffolder.d.ts.map

package/dist/src/scaffolders/framework.scaffolder.js

@@ -94,4 +94,3 @@ export class ReactNativeScaffolder extends FrameworkScaffolder {
     command = "npx";
     args = ["react-native@latest", "init", "."];
 }
-//# sourceMappingURL=framework.scaffolder.js.map

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

@@ -4,4 +4,3 @@
  * Barrel exports for framework scaffolders.
  */
 export { FrameworkScaffolder, ViteReactScaffolder, ViteVueScaffolder, NextScaffolder, NuxtScaffolder, AngularScaffolder, AstroScaffolder, SvelteScaffolder, SvelteKitScaffolder, VanillaScaffolder, FlutterScaffolder, ReactNativeScaffolder, type ScaffolderResult, } from "./framework.scaffolder.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/scaffolders/index.js

@@ -4,4 +4,3 @@
  * Barrel exports for framework scaffolders.
  */
 export { FrameworkScaffolder, ViteReactScaffolder, ViteVueScaffolder, NextScaffolder, NuxtScaffolder, AngularScaffolder, AstroScaffolder, SvelteScaffolder, SvelteKitScaffolder, VanillaScaffolder, FlutterScaffolder, ReactNativeScaffolder, } from "./framework.scaffolder.js";
-//# sourceMappingURL=index.js.map

package/dist/src/scaffolders/scaffolder.helper.d.ts

@@ -20,4 +20,3 @@ export interface ScaffolderOptions {
  */
 export declare const SCAFFOLD_TIMEOUT_MS = 900000;
 export declare function scaffoldWithFallback(options: ScaffolderOptions): Promise<boolean>;
-//# sourceMappingURL=scaffolder.helper.d.ts.map

package/dist/src/scaffolders/scaffolder.helper.js

@@ -54,4 +54,3 @@ export async function scaffoldWithFallback(options) {
     }
     return true;
 }
-//# sourceMappingURL=scaffolder.helper.js.map

package/dist/src/templates/backendApp/backendApp.core.d.ts

@@ -42,4 +42,3 @@ export declare const EXAMPLE_RESOURCE = "examples";
  * caller adds package.json, tsconfig.json and the empty folder barrels.
  */
 export declare function renderBackendAppSource(options: BackendAppOptions): Record<string, string>;
-//# sourceMappingURL=backendApp.core.d.ts.map

package/dist/src/templates/backendApp/backendApp.core.js

@@ -63,4 +63,3 @@ export function renderBackendAppSource(options) {
     }
     return files;
 }
-//# sourceMappingURL=backendApp.core.js.map

package/dist/src/templates/backendApp/backendApp.modules.d.ts

@@ -23,4 +23,3 @@ export interface ModuleRoutesWiring {
 }
 /** Describes the routes wiring of module `name`. */
 export declare function moduleRoutesWiring(name: string): ModuleRoutesWiring;
-//# sourceMappingURL=backendApp.modules.d.ts.map

package/dist/src/templates/backendApp/backendApp.modules.js

@@ -22,4 +22,3 @@ export function moduleRoutesWiring(name) {
         entryLine: `${functionName}(router, deps);`,
     };
 }
-//# sourceMappingURL=backendApp.modules.js.map

package/dist/src/templates/backendApp/backendApp.project.d.ts

@@ -3,13 +3,30 @@
  * dependency lists, dev tooling, tsconfig, folder barrels and the database
  * setting every app records.
  */
-/** `@zudojs/*` packages the shared app source imports. */
+/**
+ * `@zudojs/*` packages the shared app source imports, plus `@zudojs/middleware`
+ * (what @zudojs/http's middleware is built on; pnpm's strict layout does not
+ * expose it transitively to an app that composes middleware of its own).
+ */
 export declare const APP_SOURCE_DEPENDENCIES: readonly string[];
+/**
+ * Scripts of a backend app. `typecheck` covers sources and tests; `build`
+ * compiles the sources only. No `lint`: it used to repeat `tsc --noEmit`.
+ */
+export declare function backendAppScripts(): Record<string, string>;
 /** `@zudojs/*` packages the generated tests import. */
 export declare const APP_TEST_DEPENDENCIES: readonly string[];
 /** Third-party dev tooling of a backend app. */
 export declare function backendDevDependencies(): Record<string, string>;
-/** tsconfig.json of a backend app (tests are compiled by Vitest, not tsc). */
+/**
+ * tsconfig.test.json of a backend app: the same options over `src/` and
+ * `tests/`, emitting nothing. `tsconfig.json` excludes the tests so `build`
+ * never writes them to `dist/`; without this file they were never checked.
+ */
+export declare function backendTestTsconfig(): string;
+/** Every tsconfig of a backend app, keyed by file name. */
+export declare function backendTsconfigFiles(): Record<string, string>;
+/** tsconfig.json of a backend app: the build; tests are in tsconfig.test.json. */
 export declare function backendTsconfig(): string;
 /** `src/<folder>/index.ts` barrels for {@link APP_FOLDERS}. */
 export declare function emptyBarrels(): Record<string, string>;
@@ -23,4 +40,3 @@ export declare const DATABASE_CONFIG_SECTION = "database: Object.freeze({ url: t
 export declare function applyDatabaseSetting(files: Record<string, string>, envLines: string): Record<string, string>;
 /** `<pm> run <script>` for a package manager. */
 export declare function runCommand(packageManager: string, script: string): string;
-//# sourceMappingURL=backendApp.project.d.ts.map

package/dist/src/templates/backendApp/backendApp.project.js

@@ -5,14 +5,32 @@
  */
 import { DEPENDENCY_VERSION_RANGES, TYPESCRIPT_VERSION_RANGES, } from "../../resolvers/dependency/dependencyVersions.constant.js";
 import { MARKERS, insertBetweenMarkers } from "../../wiring/index.js";
-/** `@zudojs/*` packages the shared app source imports. */
+/**
+ * `@zudojs/*` packages the shared app source imports, plus `@zudojs/middleware`
+ * (what @zudojs/http's middleware is built on; pnpm's strict layout does not
+ * expose it transitively to an app that composes middleware of its own).
+ */
 export const APP_SOURCE_DEPENDENCIES = [
     "@zudojs/config",
     "@zudojs/errors",
     "@zudojs/http",
+    "@zudojs/middleware",
     "@zudojs/schema",
     "@zudojs/security",
 ];
+/**
+ * Scripts of a backend app. `typecheck` covers sources and tests; `build`
+ * compiles the sources only. No `lint`: it used to repeat `tsc --noEmit`.
+ */
+export function backendAppScripts() {
+    return {
+        dev: "tsx watch src/server.ts",
+        start: "node dist/server.js",
+        build: "tsc",
+        typecheck: "tsc --noEmit && tsc -p tsconfig.test.json",
+        test: "vitest run",
+    };
+}
 /** `@zudojs/*` packages the generated tests import. */
 export const APP_TEST_DEPENDENCIES = ["@zudojs/testing"];
 /** Third-party dev tooling of a backend app. */
@@ -24,7 +42,28 @@ export function backendDevDependencies() {
         vitest: DEPENDENCY_VERSION_RANGES.vitest,
     };
 }
-/** tsconfig.json of a backend app (tests are compiled by Vitest, not tsc). */
+/**
+ * tsconfig.test.json of a backend app: the same options over `src/` and
+ * `tests/`, emitting nothing. `tsconfig.json` excludes the tests so `build`
+ * never writes them to `dist/`; without this file they were never checked.
+ */
+export function backendTestTsconfig() {
+    return `{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "noEmit": true
+  },
+  "include": ["src/**/*", "tests/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+`;
+}
+/** Every tsconfig of a backend app, keyed by file name. */
+export function backendTsconfigFiles() {
+    return { "tsconfig.json": backendTsconfig(), "tsconfig.test.json": backendTestTsconfig() };
+}
+/** tsconfig.json of a backend app: the build; tests are in tsconfig.test.json. */
 export function backendTsconfig() {
     return `{
   "compilerOptions": {
@@ -84,4 +123,3 @@ export function runCommand(packageManager, script) {
             return `pnpm run ${script}`;
     }
 }
-//# sourceMappingURL=backendApp.project.js.map

package/dist/src/templates/backendApp/index.d.ts

@@ -5,4 +5,3 @@ export * from "./backendApp.core.js";
 export * from "./backendApp.modules.js";
 export * from "./backendApp.project.js";
 export * from "./parts/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/backendApp/index.js

@@ -5,4 +5,3 @@ export * from "./backendApp.core.js";
 export * from "./backendApp.modules.js";
 export * from "./backendApp.project.js";
 export * from "./parts/index.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/backendApp/parts/config.template.d.ts

@@ -25,4 +25,3 @@ export declare function renderConfigFile(options: {
     readonly defaultPort: number;
     readonly sections: readonly string[];
 }): string;
-//# sourceMappingURL=config.template.d.ts.map

package/dist/src/templates/backendApp/parts/config.template.js

@@ -18,8 +18,12 @@ export function baseEnvVariables(port) {
             value: "",
             comment: "Comma-separated origins allowed to call the API from a browser (empty: none)",
         },
-        { name: "RATE_LIMIT_WINDOW_MS", value: "60000", comment: "Requests allowed per client per window" },
-        { name: "RATE_LIMIT_MAX", value: "300" },
+        { name: "RATE_LIMIT_WINDOW_MS", value: "60000", comment: "Length of the rate-limit window in milliseconds" },
+        {
+            name: "RATE_LIMIT_MAX",
+            value: "1000",
+            comment: "Requests allowed per client per window; 0 disables the limit (load tests, local development)",
+        },
     ];
 }
 /** Renders `.env.example` lines for `variables`. */
@@ -34,12 +38,13 @@ export function renderEnvVariables(variables) {
  * placed between the config markers.
  */
 export function renderConfigFile(options) {
-    return `import { ConfigurationError } from "@zudojs/errors";
-import {
+    return `import {
   createConfigManager,
   createEnvironmentConfigSource,
   type ConfigManager,
 } from "@zudojs/config";
+import { resolveEnvironment } from "@zudojs/constants";
+import { ConfigurationError } from "@zudojs/errors";
 
 const DEFAULT_PORT = ${options.defaultPort};
 
@@ -99,7 +104,10 @@ export async function loadConfig(env: NodeJS.ProcessEnv = process.env) {
   await config.load();
 
   return Object.freeze({
-    nodeEnv: text(config, "node_env", "development"),
+    // NODE_ENV is read here, once, the way the framework reads it: \`prod\`
+    // and \`Production\` are production, an unknown value warns once. app.ts
+    // and server.ts take the resolved value from this object.
+    nodeEnv: resolveEnvironment({ NODE_ENV: text(config, "node_env", "development") }),
     host: text(config, "host", "0.0.0.0"),
     port: port(config),
     corsOrigins: list(config, "cors_origins"),
@@ -115,4 +123,3 @@ ${renderMarkerBlock(MARKERS.config, options.sections, "    ")}
 export type AppConfig = Awaited<ReturnType<typeof loadConfig>>;
 `;
 }
-//# sourceMappingURL=config.template.js.map

package/dist/src/templates/backendApp/parts/httpUtils.template.d.ts

@@ -3,8 +3,8 @@
  *
  * The small helpers every generated controller and the server use: JSON
  * responses, schema-issue responses, JSON body reading, mapping exposed
- * 4xx errors to responses, and the @zudojs/security default headers.
+ * errors to responses, describing unexpected ones for the log, and the
+ * @zudojs/security default headers.
  */
 /** Renders `src/utils/http.ts`. */
 export declare function renderHttpUtils(): string;
-//# sourceMappingURL=httpUtils.template.d.ts.map

package/dist/src/templates/backendApp/parts/httpUtils.template.js

@@ -3,7 +3,8 @@
  *
  * The small helpers every generated controller and the server use: JSON
  * responses, schema-issue responses, JSON body reading, mapping exposed
- * 4xx errors to responses, and the @zudojs/security default headers.
+ * errors to responses, describing unexpected ones for the log, and the
+ * @zudojs/security default headers.
  */
 /** Renders `src/utils/http.ts`. */
 export function renderHttpUtils() {
@@ -61,9 +62,10 @@ export function readJsonBody(ctx: HttpRouterContext): unknown {
 }
 
 /**
- * The response for an error that carries an exposed 4xx status
- * (NotFoundError, badRequest(), ...). Anything else is left to the server,
- * which answers a generic 500 and never leaks the message.
+ * The response for an error that carries an exposed HTTP status
+ * (NotFoundError, badRequest(), an exposed 503, ...): its status, message
+ * and code. \`undefined\` for anything else; server.ts then logs the error
+ * and answers a generic 500 that never leaks the message.
  */
 export function errorResponse(error: unknown): HttpResponseContext | undefined {
   if (typeof error !== "object" || error === null) return undefined;
@@ -74,7 +76,7 @@ export function errorResponse(error: unknown): HttpResponseContext | undefined {
     readonly code?: unknown;
   };
   const status = candidate.statusCode;
-  if (typeof status !== "number" || status < 400 || status > 499) return undefined;
+  if (typeof status !== "number" || status < 400 || status > 599) return undefined;
   if (candidate.expose !== true || typeof candidate.message !== "string") return undefined;
   return json(status, {
     error: candidate.message,
@@ -82,6 +84,19 @@ export function errorResponse(error: unknown): HttpResponseContext | undefined {
   });
 }
 
+/** What the log records about an unexpected error: name, message, code, stack. */
+export function errorDetails(error: unknown): Record<string, string> {
+  if (!(error instanceof Error)) return { error: String(error) };
+  const { code } = error as { readonly code?: unknown };
+  return {
+    error: error.message,
+    name: error.name,
+    ...(typeof code === "string" ? { code } : {}),
+    ...(error.stack === undefined ? {} : { stack: error.stack }),
+    ...(error.cause === undefined ? {} : { cause: error.cause instanceof Error ? error.cause.message : String(error.cause) }),
+  };
+}
+
 /**
  * Adds the @zudojs/security default headers (CSP, HSTS, nosniff,
  * X-Frame-Options DENY, ...) to every response that does not set its own:
@@ -100,4 +115,3 @@ export function securityHeaders(): HttpMiddleware {
 }
 `;
 }
-//# sourceMappingURL=httpUtils.template.js.map

package/dist/src/templates/backendApp/parts/index.d.ts

@@ -6,4 +6,3 @@ export * from "./config.template.js";
 export * from "./httpUtils.template.js";
 export * from "./integrations.template.js";
 export * from "./wiring.template.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/backendApp/parts/index.js

@@ -6,4 +6,3 @@ export * from "./config.template.js";
 export * from "./httpUtils.template.js";
 export * from "./integrations.template.js";
 export * from "./wiring.template.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/backendApp/parts/integrations.template.d.ts

@@ -13,4 +13,3 @@ import type { MarkerLines } from "./wiring.template.js";
 export declare function renderIntegrationsIndex(lines: MarkerLines): string;
 /** Renders `src/integrations/integration.ts`. */
 export declare function renderIntegrationContract(): string;
-//# sourceMappingURL=integrations.template.d.ts.map

package/dist/src/templates/backendApp/parts/integrations.template.js

@@ -112,4 +112,3 @@ export async function checkIntegrations(
 }
 `;
 }
-//# sourceMappingURL=integrations.template.js.map

package/dist/src/templates/backendApp/parts/wiring.template.d.ts

@@ -5,7 +5,9 @@
  *   plus every resource (and module) between the `routes` markers.
  * - `src/modules/<name>/routes/index.ts` does the same for one module.
  * - `src/container.ts` constructs every controller, service and repository
- *   in one place, between the `container` markers.
+ *   in one place, between the `container` markers, and exports the
+ *   `APP_DEPENDENCIES` token under which server.ts registers the result in
+ *   the runtime's DI container.
  */
 /** Lines a template pre-fills between a pair of markers. */
 export interface MarkerLines {
@@ -23,4 +25,3 @@ export declare function renderModuleRoutesIndex(functionName: string, containerF
 export declare function renderHealthRoutes(): string;
 /** Renders `src/container.ts`. */
 export declare function renderContainer(lines: MarkerLines): string;
-//# sourceMappingURL=wiring.template.d.ts.map

package/dist/src/templates/backendApp/parts/wiring.template.js

@@ -5,7 +5,9 @@
  *   plus every resource (and module) between the `routes` markers.
  * - `src/modules/<name>/routes/index.ts` does the same for one module.
  * - `src/container.ts` constructs every controller, service and repository
- *   in one place, between the `container` markers.
+ *   in one place, between the `container` markers, and exports the
+ *   `APP_DEPENDENCIES` token under which server.ts registers the result in
+ *   the runtime's DI container.
  */
 import { MARKERS, renderMarkerBlock } from "../../../wiring/index.js";
 /** Renders `src/routes/index.ts`. */
@@ -80,9 +82,18 @@ export function registerHealthRoutes(router: HttpRouter, check: HealthCheck): vo
 }
 /** Renders `src/container.ts`. */
 export function renderContainer(lines) {
-    return `import type { HealthCheck } from "./routes/health.routes.js";
+    return `import { createToken } from "@zudojs/container";
+
+import type { HealthCheck } from "./routes/health.routes.js";
 ${renderMarkerBlock(MARKERS.containerImports, lines.imports)}
 
+/**
+ * The token server.ts registers the composition root under in the runtime
+ * container, so a module can reach it:
+ * \`context.application.container.resolve(APP_DEPENDENCIES)\`.
+ */
+export const APP_DEPENDENCIES = createToken<AppDependencies>("app.dependencies");
+
 /** Options for {@link createDependencies}. */
 export interface DependencyOptions {
   /** Readiness for /health; server.ts passes the runtime's. */
@@ -108,4 +119,3 @@ ${renderMarkerBlock(MARKERS.container, lines.entries, "    ")}
 export type AppDependencies = ReturnType<typeof createDependencies>;
 `;
 }
-//# sourceMappingURL=wiring.template.js.map

package/dist/src/templates/microservice/index.d.ts

@@ -2,4 +2,3 @@
  * zudojs-cli — Microservice Template Index
  */
 export { generateMicroserviceFiles, resolveMicroserviceServices, RESERVED_MICROSERVICE_APP_NAMES, } from "./microservice.template.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/templates/microservice/index.js

@@ -2,4 +2,3 @@
  * zudojs-cli — Microservice Template Index
  */
 export { generateMicroserviceFiles, resolveMicroserviceServices, RESERVED_MICROSERVICE_APP_NAMES, } from "./microservice.template.js";
-//# sourceMappingURL=index.js.map

package/dist/src/templates/microservice/microservice.template.d.ts

@@ -44,4 +44,3 @@ export declare const RESERVED_MICROSERVICE_APP_NAMES: readonly ["gateway"];
  */
 export declare function resolveMicroserviceServices(requested: readonly string[]): readonly string[];
 export declare function generateMicroserviceFiles(options: ScaffoldOptions): Record<string, string>;
-//# sourceMappingURL=microservice.template.d.ts.map