@open-mercato/cli 0.4.9-develop-7afbe1e834 → 0.4.9-develop-94fb251ed3

package/AGENTS.md

@@ -16,6 +16,7 @@ The CLI auto-discovers module files across all packages and `apps/mercato/src/mo
 
 - `index.ts` (metadata), `cli.ts`, `di.ts`, `acl.ts`, `setup.ts`, `ce.ts`
 - `search.ts`, `events.ts`, `notifications.ts`, `ai-tools.ts`
+- `generators.ts` — module-level generator plugin declarations (see below)
 - `data/entities.ts`, `data/extensions.ts`
 - `api/`, `subscribers/`, `workers/`, `widgets/`
 
@@ -65,6 +66,39 @@ yarn build:packages   # Rebuild with generated files
 
 Each module has an optional `cli.ts` with a default export for module-specific CLI commands. These are auto-discovered and registered in `modules.cli.generated.ts`.
 
+## Generator Plugins (`generators.ts`)
+
+Modules can declare additional aggregated output files by exporting `generatorPlugins: GeneratorPlugin[]` from a `generators.ts` file at the module root. The CLI discovers these at generation time via dynamic import and drives the extra output files without any hardcoded knowledge in the CLI package.
+
+```typescript
+// src/modules/<module>/generators.ts
+import type { GeneratorPlugin } from '@open-mercato/shared/modules/generators'
+
+function buildMyOutput({ importSection, entriesLiteral }: { importSection: string; entriesLiteral: string }): string {
+  return `// AUTO-GENERATED by mercato generate registry
+${importSection ? `${importSection}\n` : ''}export const myItemEntries = [
+${entriesLiteral ? `  ${entriesLiteral}\n` : ''}]
+`
+}
+
+export const generatorPlugins: GeneratorPlugin[] = [
+  {
+    id: 'mymodule.my-registry',           // unique ID — first declaration wins
+    conventionFile: 'mymodule.items.ts',  // file to look for in every module
+    importPrefix: 'MYMODULE_ITEMS',
+    configExpr: (importName: string, moduleId: string) =>
+      `{ moduleId: '${moduleId}', items: (${importName}.default ?? ${importName}.myItems ?? []) }`,
+    outputFileName: 'mymodule-items.generated.ts',
+    buildOutput: buildMyOutput,
+  },
+]
+```
+
+Rules:
+- MUST only use `import type` (no runtime imports) so the file is safe to execute at generation time
+- The `id` is deduped across modules; the first registered definition wins
+- If a module is disabled, its `generators.ts` is never loaded, so its output files are not written
+
 ## Testing Generator Changes
 
 After modifying generator logic, run the generator and verify the output files in `apps/mercato/.mercato/generated/`. Check that all expected modules, entities, and registrations appear correctly.

package/dist/lib/generators/module-registry.js

@@ -293,6 +293,8 @@ async function generateModuleRegistry(options) {
   const eventsChecksumFile = path.join(outputDir, "events.generated.checksum");
   const analyticsOutFile = path.join(outputDir, "analytics.generated.ts");
   const analyticsChecksumFile = path.join(outputDir, "analytics.generated.checksum");
+  const bootstrapRegsOutFile = path.join(outputDir, "bootstrap-registrations.generated.ts");
+  const bootstrapRegsChecksumFile = path.join(outputDir, "bootstrap-registrations.generated.checksum");
   const transFieldsOutFile = path.join(outputDir, "translations-fields.generated.ts");
   const transFieldsChecksumFile = path.join(outputDir, "translations-fields.generated.checksum");
   const enrichersOutFile = path.join(outputDir, "enrichers.generated.ts");
@@ -307,7 +309,33 @@ async function generateModuleRegistry(options) {
   const guardsChecksumFile = path.join(outputDir, "guards.generated.checksum");
   const commandInterceptorsOutFile = path.join(outputDir, "command-interceptors.generated.ts");
   const commandInterceptorsChecksumFile = path.join(outputDir, "command-interceptors.generated.checksum");
+  const frontendMiddlewareOutFile = path.join(outputDir, "frontend-middleware.generated.ts");
+  const frontendMiddlewareChecksumFile = path.join(outputDir, "frontend-middleware.generated.checksum");
+  const backendMiddlewareOutFile = path.join(outputDir, "backend-middleware.generated.ts");
+  const backendMiddlewareChecksumFile = path.join(outputDir, "backend-middleware.generated.checksum");
   const enabled = resolver.loadEnabledModules();
+  const pluginRegistry = /* @__PURE__ */ new Map();
+  const pluginState = /* @__PURE__ */ new Map();
+  for (const entry of enabled) {
+    const roots = resolver.getModulePaths(entry);
+    const rawImps = resolver.getModuleImportBase(entry);
+    const isAppMod = entry.from === "@app";
+    const appImportBase = isAppMod ? `../../src/modules/${entry.id}` : rawImps.appBase;
+    const imps = { appBase: appImportBase, pkgBase: rawImps.pkgBase };
+    const resolved = resolveModuleFile(roots, imps, "generators.ts");
+    if (!resolved) continue;
+    try {
+      const pluginMod = await import(resolved.absolutePath);
+      const plugins = pluginMod.generatorPlugins ?? pluginMod.default ?? [];
+      for (const plugin of plugins) {
+        if (!pluginRegistry.has(plugin.id)) {
+          pluginRegistry.set(plugin.id, plugin);
+          pluginState.set(plugin.id, { imports: [], configs: [] });
+        }
+      }
+    } catch {
+    }
+  }
   const imports = [];
   const moduleDecls = [];
   const importIdRef = { value: 0 };
@@ -348,6 +376,10 @@ async function generateModuleRegistry(options) {
   const guardImports = [];
   const commandInterceptorConfigs = [];
   const commandInterceptorImports = [];
+  const frontendMiddlewareConfigs = [];
+  const frontendMiddlewareImports = [];
+  const backendMiddlewareConfigs = [];
+  const backendMiddlewareImports = [];
   const umesConflictSources = [];
   for (const entry of enabled) {
     const modId = entry.id;
@@ -599,6 +631,19 @@ async function generateModuleRegistry(options) {
       sharedImports: imports,
       configExpr: (n, id) => `{ moduleId: '${id}', fields: (${n}.default ?? ${n}.translatableFields ?? {}) as Record<string, string[]> }`
     });
+    for (const plugin of pluginRegistry.values()) {
+      processStandaloneConfig({
+        roots,
+        imps,
+        modId,
+        importIdRef,
+        relativePath: plugin.conventionFile,
+        prefix: plugin.importPrefix,
+        standaloneImports: pluginState.get(plugin.id).imports,
+        standaloneConfigs: pluginState.get(plugin.id).configs,
+        configExpr: plugin.configExpr
+      });
+    }
     {
       const resolved = resolveModuleFile(roots, imps, "inbox-actions.ts");
       if (resolved) {
@@ -632,6 +677,28 @@ async function generateModuleRegistry(options) {
       standaloneConfigs: commandInterceptorConfigs,
       configExpr: (n, id) => `{ moduleId: '${id}', interceptors: ((${n} as any).interceptors ?? (${n} as any).default ?? []) }`
     });
+    processStandaloneConfig({
+      roots,
+      imps,
+      modId,
+      importIdRef,
+      relativePath: "frontend/middleware.ts",
+      prefix: "FRONTEND_MIDDLEWARE",
+      standaloneImports: frontendMiddlewareImports,
+      standaloneConfigs: frontendMiddlewareConfigs,
+      configExpr: (n, id) => `{ moduleId: '${id}', middleware: ((${n} as any).middleware ?? (${n} as any).default ?? []) }`
+    });
+    processStandaloneConfig({
+      roots,
+      imps,
+      modId,
+      importIdRef,
+      relativePath: "backend/middleware.ts",
+      prefix: "BACKEND_MIDDLEWARE",
+      standaloneImports: backendMiddlewareImports,
+      standaloneConfigs: backendMiddlewareConfigs,
+      configExpr: (n, id) => `{ moduleId: '${id}', middleware: ((${n} as any).middleware ?? (${n} as any).default ?? []) }`
+    });
     {
       const setup = resolveConventionFile(roots, imps, "setup.ts", "SETUP", modId, importIdRef, imports);
       if (setup) setupImportName = setup.importName;
@@ -1269,6 +1336,39 @@ export const allAiTools = aiToolConfigEntries.flatMap(e => e.tools)
   writeGeneratedFile({ outFile: eventsOutFile, checksumFile: eventsChecksumFile, content: eventsOutput, structureChecksum, result, quiet });
   writeGeneratedFile({ outFile: analyticsOutFile, checksumFile: analyticsChecksumFile, content: analyticsOutput, structureChecksum, result, quiet });
   writeGeneratedFile({ outFile: transFieldsOutFile, checksumFile: transFieldsChecksumFile, content: transFieldsOutput, structureChecksum, result, quiet });
+  for (const [pluginId, plugin] of pluginRegistry) {
+    const state = pluginState.get(pluginId);
+    const importSection = state.imports.join("\n");
+    const entriesLiteral = state.configs.join(",\n  ");
+    const content = plugin.buildOutput({ importSection, entriesLiteral });
+    const outFile2 = path.join(outputDir, plugin.outputFileName);
+    const checksumFile2 = outFile2.replace(".ts", ".checksum");
+    writeGeneratedFile({ outFile: outFile2, checksumFile: checksumFile2, content, structureChecksum, result, quiet });
+  }
+  {
+    const bootstrapPlugins = [...pluginRegistry.values()].filter((p) => p.bootstrapRegistration);
+    const allEntryImports = [];
+    const allRegImports = [];
+    const allCalls = [];
+    for (const plugin of bootstrapPlugins) {
+      const reg = plugin.bootstrapRegistration;
+      const outputBase = plugin.outputFileName.replace(".ts", "");
+      allEntryImports.push(`import { ${reg.entriesExportName} } from './${outputBase}'`);
+      allRegImports.push(...reg.registrationImports);
+      allCalls.push(reg.buildCall(reg.entriesExportName));
+    }
+    const uniqueImports = [.../* @__PURE__ */ new Set([...allEntryImports, ...allRegImports])];
+    const importSection = uniqueImports.join("\n");
+    const body = allCalls.length ? `  ${allCalls.join("\n  ")}` : "";
+    const bootstrapRegsOutput = `// AUTO-GENERATED by mercato generate registry
+${importSection ? `${importSection}
+` : ""}
+export function runBootstrapRegistrations(): void {
+${body}
+}
+`;
+    writeGeneratedFile({ outFile: bootstrapRegsOutFile, checksumFile: bootstrapRegsChecksumFile, content: bootstrapRegsOutput, structureChecksum, result, quiet });
+  }
   const enricherEntriesLiteral = enricherConfigs.join(",\n  ");
   const enricherImportSection = enricherImports.join("\n");
   const enrichersOutput = `// AUTO-GENERATED by mercato generate registry
@@ -1368,6 +1468,50 @@ ${commandInterceptorEntriesLiteral ? `  ${commandInterceptorEntriesLiteral}
 ` : ""}]
 `;
   writeGeneratedFile({ outFile: commandInterceptorsOutFile, checksumFile: commandInterceptorsChecksumFile, content: commandInterceptorsOutput, structureChecksum, result, quiet });
+  const frontendMiddlewareEntriesLiteral = frontendMiddlewareConfigs.join(",\n  ");
+  const frontendMiddlewareImportSection = frontendMiddlewareImports.join("\n");
+  const frontendMiddlewareOutput = `// AUTO-GENERATED by mercato generate registry
+import type { PageMiddlewareRegistryEntry, PageRouteMiddleware } from '@open-mercato/shared/modules/middleware/page'
+${frontendMiddlewareImportSection ? `
+${frontendMiddlewareImportSection}
+` : "\n"}type FrontendMiddlewareEntry = { moduleId: string; middleware: PageRouteMiddleware[] }
+
+const entriesRaw: FrontendMiddlewareEntry[] = [
+${frontendMiddlewareEntriesLiteral ? `  ${frontendMiddlewareEntriesLiteral}
+` : ""}]
+
+export const frontendMiddlewareEntries: PageMiddlewareRegistryEntry[] = entriesRaw
+`;
+  writeGeneratedFile({
+    outFile: frontendMiddlewareOutFile,
+    checksumFile: frontendMiddlewareChecksumFile,
+    content: frontendMiddlewareOutput,
+    structureChecksum,
+    result,
+    quiet
+  });
+  const backendMiddlewareEntriesLiteral = backendMiddlewareConfigs.join(",\n  ");
+  const backendMiddlewareImportSection = backendMiddlewareImports.join("\n");
+  const backendMiddlewareOutput = `// AUTO-GENERATED by mercato generate registry
+import type { PageMiddlewareRegistryEntry, PageRouteMiddleware } from '@open-mercato/shared/modules/middleware/page'
+${backendMiddlewareImportSection ? `
+${backendMiddlewareImportSection}
+` : "\n"}type BackendMiddlewareEntry = { moduleId: string; middleware: PageRouteMiddleware[] }
+
+const entriesRaw: BackendMiddlewareEntry[] = [
+${backendMiddlewareEntriesLiteral ? `  ${backendMiddlewareEntriesLiteral}
+` : ""}]
+
+export const backendMiddlewareEntries: PageMiddlewareRegistryEntry[] = entriesRaw
+`;
+  writeGeneratedFile({
+    outFile: backendMiddlewareOutFile,
+    checksumFile: backendMiddlewareChecksumFile,
+    content: backendMiddlewareOutput,
+    structureChecksum,
+    result,
+    quiet
+  });
   return result;
 }
 async function generateModuleRegistryCli(options) {