@acmekit/acmekit 2.13.40 → 2.13.43

package/dist/commands/generate/utils/config-updater.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Add a module to the `modules` array in acmekit-config.ts.
+ * Handles three cases:
+ * 1. `modules` array exists → append entry
+ * 2. `modules` key missing → add it to defineConfig
+ * 3. Module already registered → skip (idempotent)
+ */
+export declare function addModuleToConfig(directory: string, modulePath: string): {
+    updated: boolean;
+    configPath: string;
+};
+//# sourceMappingURL=config-updater.d.ts.map

package/dist/commands/generate/utils/config-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-updater.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate/utils/config-updater.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAiC1C"}

package/dist/commands/generate/utils/config-updater.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addModuleToConfig = addModuleToConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Add a module to the `modules` array in acmekit-config.ts.
+ * Handles three cases:
+ * 1. `modules` array exists → append entry
+ * 2. `modules` key missing → add it to defineConfig
+ * 3. Module already registered → skip (idempotent)
+ */
+function addModuleToConfig(directory, modulePath) {
+    const configPath = (0, path_1.join)(directory, "acmekit-config.ts");
+    let content = (0, fs_1.readFileSync)(configPath, "utf-8");
+    // Check if already registered
+    if (content.includes(`"${modulePath}"`) ||
+        content.includes(`'${modulePath}'`)) {
+        return { updated: false, configPath };
+    }
+    const entry = `\n    {\n      resolve: "${modulePath}",\n    },`;
+    // Case 1: modules array exists — insert before closing ]
+    const modulesArrayRegex = /(modules\s*:\s*\[)([\s\S]*?)(\s*\])/;
+    const match = content.match(modulesArrayRegex);
+    if (match) {
+        const [full, open, items, close] = match;
+        content = content.replace(full, `${open}${items}${entry}${close}`);
+    }
+    else {
+        // Case 2: no modules key — add before closing }) of defineConfig
+        // Match optional trailing comma before the closing })
+        const defineConfigClose = /(,?)(\s*\n\s*}\s*\))/;
+        content = content.replace(defineConfigClose, `,\n  modules: [${entry}\n  ]$2`);
+    }
+    (0, fs_1.writeFileSync)(configPath, content, "utf-8");
+    return { updated: true, configPath };
+}
+//# sourceMappingURL=config-updater.js.map

package/dist/commands/generate/utils/config-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-updater.js","sourceRoot":"","sources":["../../../../src/commands/generate/utils/config-updater.ts"],"names":[],"mappings":";;AAUA,8CAoCC;AA9CD,2BAAgD;AAChD,+BAA2B;AAE3B;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,SAAiB,EACjB,UAAkB;IAElB,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,mBAAmB,CAAC,CAAA;IACvD,IAAI,OAAO,GAAG,IAAA,iBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAE/C,8BAA8B;IAC9B,IACE,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,GAAG,CAAC;QACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,UAAU,GAAG,CAAC,EACnC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IACvC,CAAC;IAED,MAAM,KAAK,GAAG,4BAA4B,UAAU,YAAY,CAAA;IAEhE,yDAAyD;IACzD,MAAM,iBAAiB,GAAG,qCAAqC,CAAA;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;IAE9C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;QACxC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC;SAAM,CAAC;QACN,iEAAiE;QACjE,sDAAsD;QACtD,MAAM,iBAAiB,GAAG,sBAAsB,CAAA;QAChD,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,iBAAiB,EACjB,kBAAkB,KAAK,SAAS,CACjC,CAAA;IACH,CAAC;IAED,IAAA,kBAAa,EAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AACtC,CAAC"}

package/dist/commands/generate/utils/file-writer.d.ts

@@ -0,0 +1,17 @@
+export type FileToCreate = {
+    path: string;
+    content: string;
+};
+export type WriteResult = {
+    created: string[];
+    skipped: string[];
+    overwritten: string[];
+};
+/**
+ * Write multiple files, creating directories as needed.
+ * Skips files that already exist (idempotent) unless overwrite is true.
+ */
+export declare function writeFiles(files: FileToCreate[], options?: {
+    overwrite?: boolean;
+}): WriteResult;
+//# sourceMappingURL=file-writer.d.ts.map

package/dist/commands/generate/utils/file-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate/utils/file-writer.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAAA;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,WAAW,CAsBb"}

package/dist/commands/generate/utils/file-writer.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFiles = writeFiles;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Write multiple files, creating directories as needed.
+ * Skips files that already exist (idempotent) unless overwrite is true.
+ */
+function writeFiles(files, options) {
+    const created = [];
+    const skipped = [];
+    const overwritten = [];
+    for (const file of files) {
+        if ((0, fs_1.existsSync)(file.path)) {
+            if (options?.overwrite) {
+                (0, fs_1.writeFileSync)(file.path, file.content, "utf-8");
+                overwritten.push(file.path);
+            }
+            else {
+                skipped.push(file.path);
+            }
+            continue;
+        }
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(file.path), { recursive: true });
+        (0, fs_1.writeFileSync)(file.path, file.content, "utf-8");
+        created.push(file.path);
+    }
+    return { created, skipped, overwritten };
+}
+//# sourceMappingURL=file-writer.js.map

package/dist/commands/generate/utils/file-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer.js","sourceRoot":"","sources":["../../../../src/commands/generate/utils/file-writer.ts"],"names":[],"mappings":";;AAkBA,gCAyBC;AA3CD,2BAAyD;AACzD,+BAA8B;AAa9B;;;GAGG;AACH,SAAgB,UAAU,CACxB,KAAqB,EACrB,OAAiC;IAEjC,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,WAAW,GAAa,EAAE,CAAA;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAA,eAAU,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;gBACvB,IAAA,kBAAa,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBAC/C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAClD,IAAA,kBAAa,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AAC1C,CAAC"}

package/dist/commands/generate/utils/log.d.ts

@@ -0,0 +1,13 @@
+export declare function printSummary(args: {
+    type: string;
+    name: string;
+    created: string[];
+    skipped: string[];
+    overwritten?: string[];
+    configUpdated?: {
+        path: string;
+    };
+    nextSteps: string[];
+    directory: string;
+}): void;
+//# sourceMappingURL=log.d.ts.map

package/dist/commands/generate/utils/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate/utils/log.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,QA+CA"}

package/dist/commands/generate/utils/log.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printSummary = printSummary;
+const path_1 = require("path");
+function printSummary(args) {
+    const { type, name, created, skipped, overwritten, configUpdated, nextSteps, directory, } = args;
+    console.log(`\n✔ Generated ${type}: ${name}\n`);
+    if (created.length > 0) {
+        console.log("Created files:");
+        for (const file of created) {
+            console.log(`  + ${(0, path_1.relative)(directory, file)}`);
+        }
+    }
+    if (overwritten && overwritten.length > 0) {
+        console.log("\nOverwritten:");
+        for (const file of overwritten) {
+            console.log(`  ↻ ${(0, path_1.relative)(directory, file)}`);
+        }
+    }
+    if (skipped.length > 0) {
+        console.log("\nSkipped (already exist):");
+        for (const file of skipped) {
+            console.log(`  - ${(0, path_1.relative)(directory, file)}`);
+        }
+    }
+    if (configUpdated) {
+        console.log(`\nUpdated: ${(0, path_1.relative)(directory, configUpdated.path)}`);
+    }
+    if (nextSteps.length > 0) {
+        console.log("\nNext steps:");
+        for (const step of nextSteps) {
+            console.log(`  → ${step}`);
+        }
+    }
+    console.log();
+}
+//# sourceMappingURL=log.js.map

package/dist/commands/generate/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../../src/commands/generate/utils/log.ts"],"names":[],"mappings":";;AAEA,oCAwDC;AA1DD,+BAA+B;AAE/B,SAAgB,YAAY,CAAC,IAS5B;IACC,MAAM,EACJ,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EACP,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,GACV,GAAG,IAAI,CAAA;IAER,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,KAAK,IAAI,IAAI,CAAC,CAAA;IAE/C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;QAC7B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAA,eAAQ,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;QAC7B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAA,eAAQ,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;QACzC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAA,eAAQ,EAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,cAAc,IAAA,eAAQ,EAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACtE,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAA;AACf,CAAC"}

package/dist/commands/generate/utils/model-introspector.d.ts

@@ -0,0 +1,22 @@
+export type FieldInfo = {
+    name: string;
+    dataType: string;
+    nullable: boolean;
+    primaryKey: boolean;
+    hasDefault: boolean;
+    enumChoices?: string[];
+    searchable?: boolean;
+    computed?: boolean;
+};
+export type EntityInfo = {
+    name: string;
+    fields: FieldInfo[];
+};
+/**
+ * Load all DML entities from a module's models/ directory.
+ * Returns structured metadata for each entity.
+ */
+export declare function introspectModule(directory: string, moduleName: string): EntityInfo[];
+export declare function fieldToTsType(field: FieldInfo): string;
+export declare function fieldToZodType(field: FieldInfo): string;
+//# sourceMappingURL=model-introspector.d.ts.map

package/dist/commands/generate/utils/model-introspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-introspector.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate/utils/model-introspector.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,EAAE,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,UAAU,EAAE,CA4Dd;AAeD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAKtD;AAYD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAMvD"}

package/dist/commands/generate/utils/model-introspector.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.introspectModule = introspectModule;
+exports.fieldToTsType = fieldToTsType;
+exports.fieldToZodType = fieldToZodType;
+const path_1 = require("path");
+const fs_1 = require("fs");
+/**
+ * Load all DML entities from a module's models/ directory.
+ * Returns structured metadata for each entity.
+ */
+function introspectModule(directory, moduleName) {
+    const modelsDir = (0, path_1.join)(directory, "src", "modules", moduleName, "models");
+    const files = (0, fs_1.readdirSync)(modelsDir).filter((f) => f.endsWith(".ts") && f !== "index.ts");
+    const entities = [];
+    for (const file of files) {
+        const modelPath = (0, path_1.join)(modelsDir, file);
+        const mod = require(modelPath);
+        const entity = mod.default || mod;
+        // Skip non-DML exports
+        if (!entity?.parse) {
+            continue;
+        }
+        const parsed = entity.parse();
+        const fields = [];
+        for (const [key, property] of Object.entries(parsed.schema)) {
+            // Skip items without a parse method
+            if (typeof property.parse !== "function") {
+                continue;
+            }
+            const meta = property.parse(key);
+            // Skip relationships (no fieldName)
+            if (!("fieldName" in meta)) {
+                continue;
+            }
+            // Skip auto-added timestamp fields
+            if (["created_at", "updated_at", "deleted_at"].includes(key)) {
+                continue;
+            }
+            // Skip computed fields
+            if (meta.computed) {
+                continue;
+            }
+            fields.push({
+                name: meta.fieldName,
+                dataType: meta.dataType.name,
+                nullable: meta.nullable,
+                primaryKey: !!meta.primaryKey,
+                hasDefault: meta.defaultValue !== undefined,
+                enumChoices: meta.dataType.options?.choices,
+                searchable: meta.dataType.options?.searchable,
+                computed: meta.computed,
+            });
+        }
+        entities.push({ name: parsed.name, fields });
+    }
+    return entities;
+}
+const TS_TYPE_MAP = {
+    text: "string",
+    id: "string",
+    boolean: "boolean",
+    number: "number",
+    float: "number",
+    bigNumber: "number",
+    serial: "number",
+    dateTime: "Date",
+    json: "Record<string, unknown>",
+    array: "string[]",
+};
+function fieldToTsType(field) {
+    if (field.dataType === "enum" && field.enumChoices) {
+        return field.enumChoices.map((c) => `"${c}"`).join(" | ");
+    }
+    return TS_TYPE_MAP[field.dataType] || "unknown";
+}
+const ZOD_TYPE_MAP = {
+    text: "z.string()",
+    boolean: "z.boolean()",
+    number: "z.number()",
+    float: "z.number()",
+    bigNumber: "z.number()",
+    json: "z.record(z.unknown())",
+    array: "z.array(z.string())",
+};
+function fieldToZodType(field) {
+    if (field.dataType === "enum" && field.enumChoices) {
+        const choices = field.enumChoices.map((c) => `"${c}"`).join(", ");
+        return `z.enum([${choices}])`;
+    }
+    return ZOD_TYPE_MAP[field.dataType] || "z.unknown()";
+}
+//# sourceMappingURL=model-introspector.js.map

package/dist/commands/generate/utils/model-introspector.js.map

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

package/dist/commands/generate/utils/naming.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Naming convention helpers for code generators.
+ *
+ * Input names follow these conventions:
+ * - Module/Entity names: PascalCase (Blog, BlogPost)
+ * - Workflow/subscriber/job names: kebab-case (publish-post)
+ * - Route paths: slash-separated (admin/posts)
+ */
+/** "BlogPost" → "blog-post", "blog-post" → "blog-post" */
+export declare function toKebabCase(str: string): string;
+/** "blog-post" → "BlogPost", "BlogPost" → "BlogPost" */
+export declare function toPascalCase(str: string): string;
+/** "blog-post" → "blogPost", "BlogPost" → "blogPost" */
+export declare function toCamelCase(str: string): string;
+/** "BlogPost" → "blog_post" */
+export declare function toSnakeCase(str: string): string;
+/** "Post" → "posts", "Category" → "categories", "Status" → "statuses" */
+export declare function pluralize(str: string): string;
+/** "BlogPost" → "blog-posts" (kebab + pluralize) */
+export declare function toResourcePath(entity: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/commands/generate/utils/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate/utils/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAcD,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqB7C;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/commands/generate/utils/naming.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Naming convention helpers for code generators.
+ *
+ * Input names follow these conventions:
+ * - Module/Entity names: PascalCase (Blog, BlogPost)
+ * - Workflow/subscriber/job names: kebab-case (publish-post)
+ * - Route paths: slash-separated (admin/posts)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = toPascalCase;
+exports.toCamelCase = toCamelCase;
+exports.toSnakeCase = toSnakeCase;
+exports.pluralize = pluralize;
+exports.toResourcePath = toResourcePath;
+/** "BlogPost" → "blog-post", "blog-post" → "blog-post" */
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/([A-Z])([A-Z][a-z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .toLowerCase();
+}
+/** "blog-post" → "BlogPost", "BlogPost" → "BlogPost" */
+function toPascalCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+        .replace(/^(.)/, (_, c) => c.toUpperCase());
+}
+/** "blog-post" → "blogPost", "BlogPost" → "blogPost" */
+function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/** "BlogPost" → "blog_post" */
+function toSnakeCase(str) {
+    return toKebabCase(str).replace(/-/g, "_");
+}
+const IRREGULAR_PLURALS = {
+    person: "people",
+    child: "children",
+    man: "men",
+    woman: "women",
+    mouse: "mice",
+    goose: "geese",
+    ox: "oxen",
+    foot: "feet",
+    tooth: "teeth",
+};
+/** "Post" → "posts", "Category" → "categories", "Status" → "statuses" */
+function pluralize(str) {
+    const lower = str.toLowerCase();
+    if (IRREGULAR_PLURALS[lower]) {
+        // Preserve the original casing of the first char
+        const plural = IRREGULAR_PLURALS[lower];
+        return str.charAt(0) === str.charAt(0).toUpperCase()
+            ? plural.charAt(0).toUpperCase() + plural.slice(1)
+            : plural;
+    }
+    if (lower.endsWith("s") || lower.endsWith("x") || lower.endsWith("z") ||
+        lower.endsWith("ch") || lower.endsWith("sh")) {
+        return str + "es";
+    }
+    if (lower.endsWith("y") && !/[aeiou]y$/i.test(str)) {
+        return str.slice(0, -1) + "ies";
+    }
+    return str + "s";
+}
+/** "BlogPost" → "blog-posts" (kebab + pluralize) */
+function toResourcePath(entity) {
+    return pluralize(toKebabCase(entity));
+}
+//# sourceMappingURL=naming.js.map

package/dist/commands/generate/utils/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../../src/commands/generate/utils/naming.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAGH,kCAMC;AAGD,oCAIC;AAGD,kCAGC;AAGD,kCAEC;AAeD,8BAqBC;AAGD,wCAEC;AAlED,0DAA0D;AAC1D,SAAgB,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG;SACP,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;SACxC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAA;AAClB,CAAC;AAED,wDAAwD;AACxD,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AAC/C,CAAC;AAED,wDAAwD;AACxD,SAAgB,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACzD,CAAC;AAED,+BAA+B;AAC/B,SAAgB,WAAW,CAAC,GAAW;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,iBAAiB,GAA2B;IAChD,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,OAAO;IACd,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAA;AAED,yEAAyE;AACzE,SAAgB,SAAS,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAA;IAE/B,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,iDAAiD;QACjD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;QACvC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YAClD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,CAAC,CAAC,MAAM,CAAA;IACZ,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACjE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,GAAG,IAAI,CAAA;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IACjC,CAAC;IAED,OAAO,GAAG,GAAG,GAAG,CAAA;AAClB,CAAC;AAED,oDAAoD;AACpD,SAAgB,cAAc,CAAC,MAAc;IAC3C,OAAO,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;AACvC,CAAC"}

package/dist/commands/generate/workflow.d.ts

@@ -0,0 +1,7 @@
+type Options = {
+    name: string;
+    directory: string;
+};
+export default function generateWorkflow({ name, directory }: Options): Promise<void>;
+export {};
+//# sourceMappingURL=workflow.d.ts.map

package/dist/commands/generate/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/commands/generate/workflow.ts"],"names":[],"mappings":"AAKA,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAA8B,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,iBA6D1E"}

package/dist/commands/generate/workflow.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = generateWorkflow;
+const path_1 = require("path");
+const file_writer_1 = require("./utils/file-writer");
+const naming_1 = require("./utils/naming");
+const log_1 = require("./utils/log");
+async function generateWorkflow({ name, directory }) {
+    const kebabName = (0, naming_1.toKebabCase)(name);
+    const camelName = (0, naming_1.toCamelCase)(name);
+    const pascalName = (0, naming_1.toPascalCase)(name);
+    const filePath = (0, path_1.join)(directory, "src", "workflows", `${kebabName}.ts`);
+    const content = `import {
+  createStep,
+  createWorkflow,
+  StepResponse,
+  WorkflowResponse,
+} from "@acmekit/framework/workflows-sdk"
+import type { WorkflowData } from "@acmekit/framework/workflows-sdk"
+
+type ${pascalName}Input = {
+  // TODO: define input fields
+}
+
+type ${pascalName}Output = {
+  // TODO: define output fields
+}
+
+const ${camelName}StepId = "${kebabName}-step"
+
+const ${camelName}Step = createStep(
+  ${camelName}StepId,
+  async (input: ${pascalName}Input, { container }) => {
+    // TODO: implement step logic
+    const result = {}
+    return new StepResponse(result, input)
+  },
+  async (compensationData, { container }) => {
+    // TODO: implement compensation (rollback) logic
+  }
+)
+
+export const ${camelName}WorkflowId = "${kebabName}"
+
+export const ${camelName}Workflow = createWorkflow(
+  ${camelName}WorkflowId,
+  (input: WorkflowData<${pascalName}Input>) => {
+    const result = ${camelName}Step(input)
+    return new WorkflowResponse(result)
+  }
+)
+`;
+    const result = (0, file_writer_1.writeFiles)([{ path: filePath, content }]);
+    (0, log_1.printSummary)({
+        type: "workflow",
+        name: kebabName,
+        ...result,
+        nextSteps: [
+            `Define input/output types in src/workflows/${kebabName}.ts`,
+            "Implement the step logic and compensation",
+            `Use the workflow in an API route: ${camelName}Workflow(req.scope).run({ input: { ... } })`,
+        ],
+        directory,
+    });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/commands/generate/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/commands/generate/workflow.ts"],"names":[],"mappings":";;AAUA,mCA6DC;AAvED,+BAA2B;AAC3B,qDAAgD;AAChD,2CAAuE;AACvE,qCAA0C;AAO3B,KAAK,UAAU,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAW;IACzE,MAAM,SAAS,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,IAAA,qBAAY,EAAC,IAAI,CAAC,CAAA;IAErC,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,KAAK,CAAC,CAAA;IAEvE,MAAM,OAAO,GAAG;;;;;;;;OAQX,UAAU;;;;OAIV,UAAU;;;;QAIT,SAAS,aAAa,SAAS;;QAE/B,SAAS;IACb,SAAS;kBACK,UAAU;;;;;;;;;;eAUb,SAAS,iBAAiB,SAAS;;eAEnC,SAAS;IACpB,SAAS;yBACY,UAAU;qBACd,SAAS;;;;CAI7B,CAAA;IAEC,MAAM,MAAM,GAAG,IAAA,wBAAU,EAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IAExD,IAAA,kBAAY,EAAC;QACX,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,SAAS;QACf,GAAG,MAAM;QACT,SAAS,EAAE;YACT,8CAA8C,SAAS,KAAK;YAC5D,2CAA2C;YAC3C,qCAAqC,SAAS,6CAA6C;SAC5F;QACD,SAAS;KACV,CAAC,CAAA;AACJ,CAAC"}

package/dist/loaders/docs.d.ts

@@ -0,0 +1,10 @@
+import { PluginDetails } from "@acmekit/framework/types";
+import { Express } from "express";
+type Options = {
+    app: Express;
+    rootDirectory: string;
+    plugins: PluginDetails[];
+};
+export default function docsLoader({ app, rootDirectory, plugins, }: Options): Promise<Express>;
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/dist/loaders/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/loaders/docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAQjC,KAAK,OAAO,GAAG;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB,CAAA;AAmDD,wBAA8B,UAAU,CAAC,EACvC,GAAG,EACH,aAAa,EACb,OAAO,GACR,EAAE,OAAO,oBAoDT"}

package/dist/loaders/docs.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = docsLoader;
+const logger_1 = require("@acmekit/framework/logger");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const DOCS_RELATIVE_OUTPUT_DIR = "./public/docs";
+const DEFAULT_DOCS_PATH = "/docs";
+const NOT_ALLOWED_PATHS = ["/auth", "/client", "/admin"];
+function slugifyPluginName(name) {
+    return name
+        .replace(/^@[^/]+\//, "")
+        .replace(/[^a-z0-9-]/gi, "-")
+        .toLowerCase();
+}
+/**
+ * Loads docs config.ts using esbuild (same loader as vite plugin).
+ * Inlined here to avoid importing the vite plugin at runtime.
+ */
+function loadDocsConfig(docsDir) {
+    const tsPath = path_1.default.join(docsDir, "config.ts");
+    const jsPath = path_1.default.join(docsDir, "config.js");
+    const configPath = fs_1.default.existsSync(tsPath)
+        ? tsPath
+        : fs_1.default.existsSync(jsPath)
+            ? jsPath
+            : null;
+    if (!configPath) {
+        return undefined;
+    }
+    try {
+        const { transformSync } = require("esbuild");
+        const raw = fs_1.default.readFileSync(configPath, "utf-8");
+        const ext = path_1.default.extname(configPath);
+        const { code } = transformSync(raw, {
+            loader: ext === ".ts" ? "ts" : "js",
+            format: "cjs",
+        });
+        const mod = { exports: {} };
+        new Function("module", "exports", code)(mod, mod.exports);
+        return mod.exports.default || mod.exports;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function docsLoader({ app, rootDirectory, plugins, }) {
+    const projectDocsDir = path_1.default.join(rootDirectory, "src", "docs");
+    // No src/docs/ folder → no docs
+    if (!fs_1.default.existsSync(projectDocsDir)) {
+        return app;
+    }
+    // Load config.ts from src/docs/
+    const config = loadDocsConfig(projectDocsDir);
+    const docsPath = config?.path || DEFAULT_DOCS_PATH;
+    if (NOT_ALLOWED_PATHS.includes(docsPath)) {
+        logger_1.logger.error(`The docs path "${docsPath}" is reserved. Please set a different path in src/docs/config.ts. Reserved: ${NOT_ALLOWED_PATHS.join(", ")}.`);
+    }
+    // Collect plugin docs sources
+    const pluginDocsPaths = [];
+    const pluginSources = [];
+    for (const plugin of plugins) {
+        if (!plugin.docs) {
+            continue;
+        }
+        if (plugin.docs.type === "local") {
+            pluginSources.push({
+                slug: slugifyPluginName(plugin.name),
+                resolve: plugin.docs.resolve,
+                type: "local",
+            });
+        }
+        else {
+            pluginDocsPaths.push(plugin.docs.resolve);
+        }
+    }
+    const bundlerOptions = {
+        path: docsPath,
+        outDir: path_1.default.join(rootDirectory, DOCS_RELATIVE_OUTPUT_DIR),
+        sources: [rootDirectory],
+        plugins: pluginDocsPaths,
+        pluginSources: pluginSources.length ? pluginSources : undefined,
+        backendUrl: config?.backendUrl,
+    };
+    if (process.env.NODE_ENV === "development") {
+        return initDevelopmentServer(app, bundlerOptions);
+    }
+    return serveProductionBuild(app, bundlerOptions);
+}
+async function initDevelopmentServer(app, options) {
+    try {
+        const { develop } = await import("@acmekit/docs-bundler");
+        const docsMiddleware = await develop(options);
+        app.use(options.path, docsMiddleware);
+    }
+    catch (err) {
+        if (err.code === "MODULE_NOT_FOUND" ||
+            err.code === "ERR_MODULE_NOT_FOUND") {
+            logger_1.logger.warn(`src/docs/ found but @acmekit/docs-bundler is not installed. ` +
+                `Run "npm add @acmekit/docs-bundler" to enable docs.`);
+        }
+        else {
+            throw err;
+        }
+    }
+    return app;
+}
+async function serveProductionBuild(app, options) {
+    try {
+        const { serve } = await import("@acmekit/docs-bundler");
+        const docsRoute = await serve(options);
+        app.use(options.path, docsRoute);
+    }
+    catch (err) {
+        if (err.code === "MODULE_NOT_FOUND" ||
+            err.code === "ERR_MODULE_NOT_FOUND") {
+            logger_1.logger.warn(`src/docs/ found but @acmekit/docs-bundler is not installed. ` +
+                `Run "npm add @acmekit/docs-bundler" to enable docs.`);
+        }
+        else {
+            throw err;
+        }
+    }
+    return app;
+}
+//# sourceMappingURL=docs.js.map