@malyuga/aether-cli 0.1.1

package/dist/commands/upgrade.js

@@ -0,0 +1,42 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { loadConfig } from "../core/project.js";
+import { compositionRel } from "../core/paths.js";
+import { CLI_NAME, DEFAULT_APP_ENTRY, EXIT_FAIL, EXIT_OK, PACKAGE_JSON } from "../core/constants.js";
+export async function runUpgrade(cwd, options) {
+    const suggestions = [];
+    if (!existsSync(join(cwd, PACKAGE_JSON))) {
+        suggestions.push(`Run ${CLI_NAME} init to create a project.`);
+    }
+    else {
+        try {
+            loadConfig(cwd);
+        }
+        catch (err) {
+            suggestions.push(err instanceof Error ? err.message : String(err));
+        }
+        const comp = compositionRel({ root: cwd, config: loadConfig(cwd), appEntryPath: "" });
+        if (!existsSync(join(cwd, comp))) {
+            suggestions.push(`Add ${comp} (restore from latest ${CLI_NAME} init template).`);
+        }
+        if (!existsSync(join(cwd, DEFAULT_APP_ENTRY))) {
+            suggestions.push(`Restore ${DEFAULT_APP_ENTRY} from latest ${CLI_NAME} init template.`);
+        }
+    }
+    const ok = suggestions.length === 0;
+    const payload = { ok, suggestions, dryRun: Boolean(options.dryRun) };
+    if (options.json) {
+        console.log(JSON.stringify(payload, null, 2));
+    }
+    else if (ok) {
+        console.log("Project matches current Aether composition contract.");
+    }
+    else {
+        console.log("Upgrade suggestions:");
+        for (const s of suggestions) {
+            console.log(`- ${s}`);
+        }
+    }
+    return ok ? EXIT_OK : EXIT_FAIL;
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,OAA6C;IACzF,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QACzC,WAAW,CAAC,IAAI,CAAC,OAAO,QAAQ,4BAA4B,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,UAAU,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC,OAAO,IAAI,yBAAyB,QAAQ,kBAAkB,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC;YAC9C,WAAW,CAAC,IAAI,CAAC,WAAW,iBAAiB,gBAAgB,QAAQ,iBAAiB,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IAErE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,IAAI,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClC,CAAC"}

package/dist/core/ast.d.ts

@@ -0,0 +1,7 @@
+import type { SourceFile } from "ts-morph";
+export declare function addNamedImportIfMissing(sf: SourceFile, moduleSpecifier: string, namedImports: string[]): void;
+/** Append identifier to `const <arrayName> = [...]` if not already present. */
+export declare function appendToArrayLiteralIfMissing(sf: SourceFile, arrayVariableName: string, elementIdentifier: string, asSpread?: boolean): void;
+/** Append `...createFooModule({}).routes` to `buildAppRoutes()` return array if missing. */
+export declare function appendModuleRoutesSpreadIfMissing(sf: SourceFile, moduleFactory: string, moduleCallArgs: string): void;
+//# sourceMappingURL=ast.d.ts.map

package/dist/core/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../src/core/ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,UAAU,EACd,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EAAE,GACrB,IAAI,CAmBN;AAwCD,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC3C,EAAE,EAAE,UAAU,EACd,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,UAAQ,GACf,IAAI,CAeN;AAkBD,4FAA4F;AAC5F,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,UAAU,EACd,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,IAAI,CAcN"}

package/dist/core/ast.js

@@ -0,0 +1,90 @@
+import { SyntaxKind } from "ts-morph";
+import { AST_SYMBOL } from "./constants.js";
+export function addNamedImportIfMissing(sf, moduleSpecifier, namedImports) {
+    const existing = sf.getImportDeclaration((d) => d.getModuleSpecifierValue() === moduleSpecifier);
+    if (!existing) {
+        sf.addImportDeclaration({
+            moduleSpecifier,
+            namedImports: namedImports.map((name) => ({ name })),
+        });
+        return;
+    }
+    for (const name of namedImports) {
+        const has = existing.getNamedImports().some((ni) => ni.getName() === name);
+        if (!has) {
+            existing.addNamedImport(name);
+        }
+    }
+}
+function findVariableArrayLiteral(sf, variableName) {
+    for (const decl of sf.getVariableDeclarations()) {
+        if (decl.getName() !== variableName)
+            continue;
+        const init = decl.getInitializer();
+        if (!init || !init.isKind(SyntaxKind.ArrayLiteralExpression))
+            continue;
+        return init.asKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+    }
+    return undefined;
+}
+function spreadContainsIdentifier(element, identifier) {
+    if (element.isKind(SyntaxKind.SpreadElement)) {
+        const expr = element.asKindOrThrow(SyntaxKind.SpreadElement).getExpression();
+        if (expr.isKind(SyntaxKind.Identifier) && expr.getText() === identifier) {
+            return true;
+        }
+    }
+    return false;
+}
+function arrayContainsIdentifier(arr, identifier) {
+    return arr.getElements().some((el) => {
+        if (el.isKind(SyntaxKind.Identifier) && el.getText() === identifier) {
+            return true;
+        }
+        return spreadContainsIdentifier(el, identifier);
+    });
+}
+/** Append identifier to `const <arrayName> = [...]` if not already present. */
+export function appendToArrayLiteralIfMissing(sf, arrayVariableName, elementIdentifier, asSpread = false) {
+    const arr = findVariableArrayLiteral(sf, arrayVariableName);
+    if (!arr) {
+        throw new Error(`Could not find array variable "${arrayVariableName}" in ${sf.getFilePath()}`);
+    }
+    if (arrayContainsIdentifier(arr, elementIdentifier)) {
+        return;
+    }
+    if (asSpread) {
+        arr.addElement(`...${elementIdentifier}`);
+    }
+    else {
+        arr.addElement(elementIdentifier);
+    }
+}
+function findBuildAppRoutesReturnArray(sf) {
+    const fn = sf.getFunction(AST_SYMBOL.buildAppRoutes);
+    if (!fn) {
+        return undefined;
+    }
+    for (const ret of fn.getDescendantsOfKind(SyntaxKind.ReturnStatement)) {
+        const expr = ret.getExpression();
+        if (expr?.isKind(SyntaxKind.ArrayLiteralExpression)) {
+            return expr;
+        }
+    }
+    return undefined;
+}
+/** Append `...createFooModule({}).routes` to `buildAppRoutes()` return array if missing. */
+export function appendModuleRoutesSpreadIfMissing(sf, moduleFactory, moduleCallArgs) {
+    const arr = findBuildAppRoutesReturnArray(sf);
+    if (!arr) {
+        throw new Error(`Could not find ${AST_SYMBOL.buildAppRoutes}() return array in ${sf.getFilePath()}`);
+    }
+    const marker = `${moduleFactory}(`;
+    for (const el of arr.getElements()) {
+        if (el.getText().includes(marker)) {
+            return;
+        }
+    }
+    arr.addElement(`...${moduleFactory}(${moduleCallArgs}).routes`);
+}
+//# sourceMappingURL=ast.js.map

package/dist/core/ast.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,133 @@
+/** Canonical layout and contract values. Do not scatter these literals. */
+export declare const CLI_NAME = "aether";
+export declare const CONFIG_FILE = "aether.config.json";
+export declare const CONFIG_VERSION = 1;
+export declare const PACKAGE_JSON = "package.json";
+export declare const TSCONFIG_JSON = "tsconfig.json";
+export declare const GITIGNORE = ".gitignore";
+export declare const ENV_FILE = ".env";
+export declare const ENV_EXAMPLE_FILE = ".env.example";
+export declare const DEFAULT_SRC_DIR = "src";
+export declare const APP_DIR = "app";
+export declare const MIDDLEWARE_DIR = "middleware";
+export declare const HEALTH_DIR = "health";
+export declare const TESTS_DIR = "tests";
+export declare const DIST_DIR = "dist";
+export declare const TEMPLATES_DIRNAME = "templates";
+export declare const APP_ENTRY_BASENAME = "app.ts";
+export declare const MAIN_BASENAME = "main.ts";
+export declare const COMPOSITION_BASENAME = "composition.ts";
+export declare const DEFAULT_APP_ENTRY = "src/app.ts";
+export declare const DEFAULT_MAIN = "src/main.ts";
+export declare const DEFAULT_COMPOSITION = "src/app/composition.ts";
+export declare const MIN_NODE_MAJOR = 20;
+export declare const EXIT_OK = 0;
+export declare const EXIT_FAIL = 1;
+export declare const JSON_MIME: "application/json";
+export declare const OPENAPI_VERSION_PREFIX = "3.";
+export declare const OPENAPI_SCHEMA_REF_PREFIX = "#/components/schemas/";
+export declare const OPENAPI_HTTP_METHOD: {
+    readonly post: "post";
+    readonly patch: "patch";
+    readonly put: "put";
+};
+export type OpenApiHttpMethod = (typeof OPENAPI_HTTP_METHOD)[keyof typeof OPENAPI_HTTP_METHOD];
+export declare const OPENAPI_SCHEMA_TYPE: {
+    readonly string: "string";
+    readonly boolean: "boolean";
+    readonly number: "number";
+    readonly integer: "integer";
+};
+export declare const TS_SCALAR_TYPE: {
+    readonly string: "string";
+    readonly number: "number";
+    readonly boolean: "boolean";
+};
+export type TsScalarType = (typeof TS_SCALAR_TYPE)[keyof typeof TS_SCALAR_TYPE];
+export declare const ENTITY_ID_FIELD = "id";
+export declare const DEFAULT_PROJECT_NAME = "app";
+export declare const AETHER_TMP_SUFFIX = ".aether.tmp";
+export declare const TEMPLATE_INIT_DIR = "init";
+export declare const INIT_TEMPLATE: {
+    readonly packageJson: "init/package.json.eta";
+    readonly tsconfig: "init/tsconfig.json.eta";
+    readonly gitignore: "init/gitignore.eta";
+    readonly aetherConfig: "init/aether.config.json.eta";
+    readonly envExample: "init/env.example.eta";
+    readonly env: "init/env.eta";
+    readonly main: "init/src-main.ts.eta";
+    readonly composition: "init/src-app-composition.ts.eta";
+    readonly app: "init/src-app.ts.eta";
+    readonly appConfig: "init/src-app-config.ts.eta";
+    readonly appServer: "init/src-app-server.ts.eta";
+    readonly appRouter: "init/src-app-router.ts.eta";
+    readonly appHttp: "init/src-app-http.ts.eta";
+    readonly appList: "init/src-app-list.ts.eta";
+    readonly appLogger: "init/src-app-logger.ts.eta";
+    readonly middlewareTypes: "init/src-app-middleware-types.ts.eta";
+    readonly middlewareRequestLogger: "init/src-app-middleware-request-logger.ts.eta";
+    readonly middlewareErrorHandler: "init/src-app-middleware-error-handler.ts.eta";
+    readonly middlewareCors: "init/src-app-middleware-cors.ts.eta";
+    readonly middlewareBodyLimit: "init/src-app-middleware-body-limit.ts.eta";
+    readonly middlewareBearerAuth: "init/src-app-middleware-bearer-auth.ts.eta";
+    readonly healthRoutes: "init/src-health-health.routes.ts.eta";
+};
+export declare const APP_SCAFFOLD: {
+    readonly config: "config.ts";
+    readonly server: "server.ts";
+    readonly router: "router.ts";
+    readonly http: "http.ts";
+    readonly list: "list.ts";
+    readonly logger: "logger.ts";
+};
+export declare const MIDDLEWARE_SCAFFOLD: {
+    readonly types: "types.ts";
+    readonly requestLogger: "request-logger.ts";
+    readonly errorHandler: "error-handler.ts";
+    readonly cors: "cors.ts";
+    readonly bodyLimit: "body-limit.ts";
+    readonly bearerAuth: "bearer-auth.ts";
+};
+export declare const HEALTH_ROUTES_BASENAME = "health.routes.ts";
+export declare const RESOURCE_TEST_SUFFIX: {
+    readonly repositoryFake: "repository.fake";
+    readonly moduleTest: "module.test";
+};
+export declare const FILE_OP: {
+    readonly create: "create";
+    readonly modify: "modify";
+};
+export type FileOpKind = (typeof FILE_OP)[keyof typeof FILE_OP];
+export declare const GENERATOR: {
+    readonly project: "project";
+    readonly resource: "resource";
+    readonly middleware: "middleware";
+    readonly openapi: "openapi";
+};
+export type GeneratorName = (typeof GENERATOR)[keyof typeof GENERATOR];
+export declare const RESOURCE_LAYER: {
+    readonly types: "types";
+    readonly validate: "validate";
+    readonly repository: "repository";
+    readonly service: "service";
+    readonly controller: "controller";
+    readonly routes: "routes";
+    readonly module: "module";
+};
+export type ResourceLayer = (typeof RESOURCE_LAYER)[keyof typeof RESOURCE_LAYER];
+export declare const RESOURCE_PLAN_MODE: {
+    readonly full: "full";
+    readonly schema: "schema";
+};
+export type ResourcePlanMode = (typeof RESOURCE_PLAN_MODE)[keyof typeof RESOURCE_PLAN_MODE];
+export declare const RESOURCE_TEMPLATE: Record<ResourceLayer, string>;
+export declare const TEMPLATE: {
+    readonly middleware: "middleware/middleware.ts.eta";
+    readonly resourceTestsFake: "resource/repository.fake.ts.eta";
+    readonly resourceTestsModule: "resource/module.test.ts.eta";
+};
+export declare const AST_SYMBOL: {
+    readonly buildAppRoutes: "buildAppRoutes";
+    readonly middlewareArray: "middleware";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

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

package/dist/core/constants.js

@@ -0,0 +1,135 @@
+/** Canonical layout and contract values. Do not scatter these literals. */
+export const CLI_NAME = "aether";
+export const CONFIG_FILE = "aether.config.json";
+export const CONFIG_VERSION = 1;
+export const PACKAGE_JSON = "package.json";
+export const TSCONFIG_JSON = "tsconfig.json";
+export const GITIGNORE = ".gitignore";
+export const ENV_FILE = ".env";
+export const ENV_EXAMPLE_FILE = ".env.example";
+export const DEFAULT_SRC_DIR = "src";
+export const APP_DIR = "app";
+export const MIDDLEWARE_DIR = "middleware";
+export const HEALTH_DIR = "health";
+export const TESTS_DIR = "tests";
+export const DIST_DIR = "dist";
+export const TEMPLATES_DIRNAME = "templates";
+export const APP_ENTRY_BASENAME = "app.ts";
+export const MAIN_BASENAME = "main.ts";
+export const COMPOSITION_BASENAME = "composition.ts";
+export const DEFAULT_APP_ENTRY = `${DEFAULT_SRC_DIR}/${APP_ENTRY_BASENAME}`;
+export const DEFAULT_MAIN = `${DEFAULT_SRC_DIR}/${MAIN_BASENAME}`;
+export const DEFAULT_COMPOSITION = `${DEFAULT_SRC_DIR}/${APP_DIR}/${COMPOSITION_BASENAME}`;
+export const MIN_NODE_MAJOR = 20;
+export const EXIT_OK = 0;
+export const EXIT_FAIL = 1;
+export const JSON_MIME = "application/json";
+export const OPENAPI_VERSION_PREFIX = "3.";
+export const OPENAPI_SCHEMA_REF_PREFIX = "#/components/schemas/";
+export const OPENAPI_HTTP_METHOD = {
+    post: "post",
+    patch: "patch",
+    put: "put",
+};
+export const OPENAPI_SCHEMA_TYPE = {
+    string: "string",
+    boolean: "boolean",
+    number: "number",
+    integer: "integer",
+};
+export const TS_SCALAR_TYPE = {
+    string: "string",
+    number: "number",
+    boolean: "boolean",
+};
+export const ENTITY_ID_FIELD = "id";
+export const DEFAULT_PROJECT_NAME = "app";
+export const AETHER_TMP_SUFFIX = ".aether.tmp";
+export const TEMPLATE_INIT_DIR = "init";
+export const INIT_TEMPLATE = {
+    packageJson: `${TEMPLATE_INIT_DIR}/package.json.eta`,
+    tsconfig: `${TEMPLATE_INIT_DIR}/tsconfig.json.eta`,
+    gitignore: `${TEMPLATE_INIT_DIR}/gitignore.eta`,
+    aetherConfig: `${TEMPLATE_INIT_DIR}/aether.config.json.eta`,
+    envExample: `${TEMPLATE_INIT_DIR}/env.example.eta`,
+    env: `${TEMPLATE_INIT_DIR}/env.eta`,
+    main: `${TEMPLATE_INIT_DIR}/src-main.ts.eta`,
+    composition: `${TEMPLATE_INIT_DIR}/src-app-composition.ts.eta`,
+    app: `${TEMPLATE_INIT_DIR}/src-app.ts.eta`,
+    appConfig: `${TEMPLATE_INIT_DIR}/src-app-config.ts.eta`,
+    appServer: `${TEMPLATE_INIT_DIR}/src-app-server.ts.eta`,
+    appRouter: `${TEMPLATE_INIT_DIR}/src-app-router.ts.eta`,
+    appHttp: `${TEMPLATE_INIT_DIR}/src-app-http.ts.eta`,
+    appList: `${TEMPLATE_INIT_DIR}/src-app-list.ts.eta`,
+    appLogger: `${TEMPLATE_INIT_DIR}/src-app-logger.ts.eta`,
+    middlewareTypes: `${TEMPLATE_INIT_DIR}/src-app-middleware-types.ts.eta`,
+    middlewareRequestLogger: `${TEMPLATE_INIT_DIR}/src-app-middleware-request-logger.ts.eta`,
+    middlewareErrorHandler: `${TEMPLATE_INIT_DIR}/src-app-middleware-error-handler.ts.eta`,
+    middlewareCors: `${TEMPLATE_INIT_DIR}/src-app-middleware-cors.ts.eta`,
+    middlewareBodyLimit: `${TEMPLATE_INIT_DIR}/src-app-middleware-body-limit.ts.eta`,
+    middlewareBearerAuth: `${TEMPLATE_INIT_DIR}/src-app-middleware-bearer-auth.ts.eta`,
+    healthRoutes: `${TEMPLATE_INIT_DIR}/src-health-health.routes.ts.eta`,
+};
+export const APP_SCAFFOLD = {
+    config: "config.ts",
+    server: "server.ts",
+    router: "router.ts",
+    http: "http.ts",
+    list: "list.ts",
+    logger: "logger.ts",
+};
+export const MIDDLEWARE_SCAFFOLD = {
+    types: "types.ts",
+    requestLogger: "request-logger.ts",
+    errorHandler: "error-handler.ts",
+    cors: "cors.ts",
+    bodyLimit: "body-limit.ts",
+    bearerAuth: "bearer-auth.ts",
+};
+export const HEALTH_ROUTES_BASENAME = "health.routes.ts";
+export const RESOURCE_TEST_SUFFIX = {
+    repositoryFake: "repository.fake",
+    moduleTest: "module.test",
+};
+export const FILE_OP = {
+    create: "create",
+    modify: "modify",
+};
+export const GENERATOR = {
+    project: "project",
+    resource: "resource",
+    middleware: "middleware",
+    openapi: "openapi",
+};
+export const RESOURCE_LAYER = {
+    types: "types",
+    validate: "validate",
+    repository: "repository",
+    service: "service",
+    controller: "controller",
+    routes: "routes",
+    module: "module",
+};
+export const RESOURCE_PLAN_MODE = {
+    full: "full",
+    schema: "schema",
+};
+export const RESOURCE_TEMPLATE = {
+    types: "resource/types.ts.eta",
+    validate: "resource/validate.ts.eta",
+    repository: "resource/repository.ts.eta",
+    service: "resource/service.ts.eta",
+    controller: "resource/controller.ts.eta",
+    routes: "resource/routes.ts.eta",
+    module: "resource/module.ts.eta",
+};
+export const TEMPLATE = {
+    middleware: "middleware/middleware.ts.eta",
+    resourceTestsFake: "resource/repository.fake.ts.eta",
+    resourceTestsModule: "resource/module.test.ts.eta",
+};
+export const AST_SYMBOL = {
+    buildAppRoutes: "buildAppRoutes",
+    middlewareArray: "middleware",
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

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

package/dist/core/diff.d.ts

@@ -0,0 +1,20 @@
+import { type FileOpKind } from "./constants.js";
+export interface PlanOpJson {
+    kind: FileOpKind;
+    path: string;
+}
+export interface PlanJson {
+    ops: PlanOpJson[];
+}
+export declare function planToJson(ops: {
+    kind: FileOpKind;
+    path: string;
+}[]): PlanJson;
+export declare function formatUnifiedDiff(path: string, before: string, after: string): string;
+export declare function formatMaterializedDiff(materialized: Array<{
+    kind: string;
+    path: string;
+    contents: string;
+    previousContents?: string;
+}>): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/core/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/core/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,UAAU,EAAE,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,QAAQ,CAI9E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBrF;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/F,MAAM,CAUR"}

package/dist/core/diff.js

@@ -0,0 +1,39 @@
+import { FILE_OP } from "./constants.js";
+export function planToJson(ops) {
+    return {
+        ops: ops.map((op) => ({ kind: op.kind, path: op.path })),
+    };
+}
+export function formatUnifiedDiff(path, before, after) {
+    const beforeLines = before.split("\n");
+    const afterLines = after.split("\n");
+    const lines = [`--- a/${path}`, `+++ b/${path}`];
+    const max = Math.max(beforeLines.length, afterLines.length);
+    for (let i = 0; i < max; i++) {
+        const b = beforeLines[i];
+        const a = afterLines[i];
+        if (b === a) {
+            if (b !== undefined)
+                lines.push(` ${b}`);
+            continue;
+        }
+        if (b !== undefined)
+            lines.push(`-${b}`);
+        if (a !== undefined)
+            lines.push(`+${a}`);
+    }
+    return lines.join("\n");
+}
+export function formatMaterializedDiff(materialized) {
+    const chunks = [];
+    for (const op of materialized) {
+        if (op.kind === FILE_OP.create) {
+            chunks.push(formatUnifiedDiff(op.path, "", op.contents));
+        }
+        else if (op.previousContents !== undefined && op.previousContents !== op.contents) {
+            chunks.push(formatUnifiedDiff(op.path, op.previousContents, op.contents));
+        }
+    }
+    return chunks.filter(Boolean).join("\n\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/core/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/core/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,gBAAgB,CAAC;AAW1D,MAAM,UAAU,UAAU,CAAC,GAAyC;IAClE,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAc,EAAE,KAAa;IAC3E,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAa,CAAC,SAAS,IAAI,EAAE,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,YAAgG;IAEhG,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,EAAE,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,CAAC,gBAAgB,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC;YACpF,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,19 @@
+export declare const ErrorCode: {
+    readonly VALIDATION: "VALIDATION";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly ALREADY_EXISTS: "ALREADY_EXISTS";
+    readonly CONFIG: "CONFIG";
+    readonly INTERNAL: "INTERNAL";
+};
+export type ChiselErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+export declare class ChiselError extends Error {
+    readonly code: ChiselErrorCode;
+    constructor(code: ChiselErrorCode, message: string);
+}
+export declare function isChiselError(err: unknown): err is ChiselError;
+export declare function formatUserError(err: unknown): string;
+export declare function errorToJson(err: unknown): {
+    code: string;
+    message: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;aACpB,UAAU,EAAE,YAAY;aACxB,SAAS,EAAE,WAAW;aACtB,cAAc,EAAE,gBAAgB;aAChC,MAAM,EAAE,QAAQ;aAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEzE,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B,YAAY,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAIjD;CACF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQ3E"}

package/dist/core/errors.js

@@ -0,0 +1,37 @@
+export const ErrorCode = {
+    VALIDATION: "VALIDATION",
+    NOT_FOUND: "NOT_FOUND",
+    ALREADY_EXISTS: "ALREADY_EXISTS",
+    CONFIG: "CONFIG",
+    INTERNAL: "INTERNAL",
+};
+export class ChiselError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ChiselError";
+        this.code = code;
+    }
+}
+export function isChiselError(err) {
+    return err instanceof ChiselError;
+}
+export function formatUserError(err) {
+    if (isChiselError(err)) {
+        return `[${err.code}] ${err.message}`;
+    }
+    if (err instanceof Error) {
+        return err.message;
+    }
+    return String(err);
+}
+export function errorToJson(err) {
+    if (isChiselError(err)) {
+        return { code: err.code, message: err.message };
+    }
+    if (err instanceof Error) {
+        return { code: ErrorCode.INTERNAL, message: err.message };
+    }
+    return { code: ErrorCode.INTERNAL, message: String(err) };
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,WAAW,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/core/naming.d.ts

@@ -0,0 +1,10 @@
+export declare function validateResourceName(name: string): void;
+export declare function toKebab(name: string): string;
+export declare function toCamel(name: string): string;
+export declare function toPascal(name: string): string;
+/** Naive plural → singular for type names (users → User). Override with --singular. */
+export declare function naiveSingular(pluralKebab: string): string;
+export declare function resolveSingularPascal(pluralKebab: string, singularOption?: string): string;
+export declare function middlewareFileName(name: string): string;
+export declare function middlewareExportName(name: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/core/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/core/naming.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAO1F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/core/naming.js

@@ -0,0 +1,50 @@
+const RESOURCE_NAME_RE = /^[a-z][a-z0-9-]*$/;
+export function validateResourceName(name) {
+    if (!RESOURCE_NAME_RE.test(name)) {
+        throw new Error(`Invalid name "${name}". Use kebab-case: lowercase letters, digits, hyphens; must start with a letter.`);
+    }
+}
+export function toKebab(name) {
+    return name.replace(/_/g, "-").toLowerCase();
+}
+export function toCamel(name) {
+    const parts = toKebab(name).split("-").filter(Boolean);
+    return parts
+        .map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join("");
+}
+export function toPascal(name) {
+    const camel = toCamel(name);
+    return camel[0].toUpperCase() + camel.slice(1);
+}
+/** Naive plural → singular for type names (users → User). Override with --singular. */
+export function naiveSingular(pluralKebab) {
+    const camel = toCamel(pluralKebab);
+    if (camel.endsWith("ies") && camel.length > 3) {
+        return camel.slice(0, -3) + "y";
+    }
+    if (camel.endsWith("ses") || camel.endsWith("xes") || camel.endsWith("zes")) {
+        return camel.slice(0, -2);
+    }
+    if (camel.endsWith("s") && !camel.endsWith("ss") && camel.length > 1) {
+        return camel.slice(0, -1);
+    }
+    return camel;
+}
+export function resolveSingularPascal(pluralKebab, singularOption) {
+    if (singularOption) {
+        const s = singularOption.trim();
+        if (/^[A-Z]/.test(s))
+            return s;
+        return toPascal(s);
+    }
+    return toPascal(naiveSingular(pluralKebab));
+}
+export function middlewareFileName(name) {
+    validateResourceName(toKebab(name));
+    return toKebab(name);
+}
+export function middlewareExportName(name) {
+    return `${toCamel(middlewareFileName(name))}Middleware`;
+}
+//# sourceMappingURL=naming.js.map