@pattern-stack/codegen 0.27.2 → 0.28.0

package/dist/src/cli/index.js

@@ -44,7 +44,7 @@ import {
   validateOrchestrationProject,
   validateProviders,
   writeManifest
-} from "../../chunk-K4BQQ2NN.js";
+} from "../../chunk-YUVEJNRE.js";
 import "../../chunk-KVOWSC5S.js";
 import "../../chunk-VCXOPBYY.js";
 import "../../chunk-PRWIX6UW.js";
@@ -64,7 +64,7 @@ import "../../chunk-TIZXQU26.js";
 import "../../chunk-JEINYUJH.js";
 import {
   isDivisibleCursor
-} from "../../chunk-5TK7MEN4.js";
+} from "../../chunk-CPUSJPAP.js";
 import "../../chunk-4KNXX6TI.js";
 import "../../chunk-3CJFPU6Q.js";
 import "../../chunk-U64T4YZE.js";
@@ -2017,7 +2017,10 @@ async function generateBridgeRegistry(opts) {
       skipped: true
     };
   }
-  const triggers = scanHandlerFiles(handlersDir);
+  const triggers = [
+    ...scanHandlerFiles(handlersDir),
+    ...opts.extraTriggers ?? []
+  ];
   validateNoDuplicateTriggers(triggers);
   const knownEventTypes = readKnownEventTypes(eventsGeneratedDir);
   validateAgainstEventRegistry(triggers, knownEventTypes);
@@ -2375,7 +2378,7 @@ function collectMergedEvents(opts) {
   const { events: entitySugar, issues: sugarIssues } = collectEntityEvents(entitiesDir);
   const { events: merged, issues: mergeIssues } = mergeEvents(
     topLevelResult.events,
-    entitySugar
+    [...entitySugar, ...opts.extraSugarEvents ?? []]
   );
   const issues = [
     ...topLevelResult.issues,
@@ -2505,6 +2508,10 @@ var REGISTRY_INTERFACE = [
   // materialise ticks. `every` is ms-or-duration-string; the rest carry the
   // schema defaults.
   "	schedule?: { every: string | number; align: boolean; catchUp: boolean; maxCatchUpSlots: number };",
+  // Trigger-catalog projection — present only on events that opted in via the
+  // `trigger:` block (selectable workflow triggers). Consumers build their
+  // authoring catalog from this instead of a hand-maintained parallel list.
+  "	trigger?: { surface: string; label?: string; description?: string; fields: string[] };",
   "}"
 ].join("\n");
 var REGISTRY_GETTER = [
@@ -2566,6 +2573,9 @@ function buildRegistryContent(events) {
         `		schedule: { every: ${every}, align: ${ev.schedule.align}, catchUp: ${ev.schedule.catchUp}, maxCatchUpSlots: ${ev.schedule.maxCatchUpSlots} },`
       );
     }
+    if (ev.trigger !== void 0) {
+      chunks.push(`		trigger: ${JSON.stringify(ev.trigger)},`);
+    }
     chunks.push(`	},`);
   }
   chunks.push(
@@ -2729,10 +2739,11 @@ function buildEventCodegenContents(events, mode = "vendored") {
   ];
 }
 async function generateEventCodegen(opts) {
-  const { entitiesDir, eventsDir, outputDir, mode = "vendored", dryRun = false } = opts;
+  const { entitiesDir, eventsDir, outputDir, mode = "vendored", dryRun = false, extraSugarEvents } = opts;
   const { events: merged, issues } = collectMergedEvents({
     entitiesDir,
-    eventsDir
+    eventsDir,
+    extraSugarEvents
   });
   const files = buildEventCodegenContents(merged, mode).map(
     ({ name, content }) => ({
@@ -5729,6 +5740,21 @@ function resolvableRels(entity, ctx) {
 function fkField(rel2) {
   return rel2.foreignKey && rel2.foreignKey.length > 0 ? rel2.foreignKey : `${rel2.target}_id`;
 }
+function lookupFullFetchNames(ctx) {
+  const referenceTargets = /* @__PURE__ */ new Set();
+  for (const e of ctx.entities) {
+    for (const r of resolvableRels(e, ctx)) referenceTargets.add(r.target.name);
+  }
+  const out = /* @__PURE__ */ new Set();
+  for (const e of ctx.entities) {
+    const parsed = ctx.parsed.get(e.name);
+    const hasUnboundedText = parsed ? Array.from(parsed.fields.values()).some(
+      (f) => f.type === "text" || f.type === "string" && f.constraints.maxLength === void 0
+    ) : false;
+    if (referenceTargets.has(e.name) || !hasUnboundedText) out.add(e.name);
+  }
+  return out;
+}
 function buildStoreIndexFile(ctx) {
   const entities = sortEntities(ctx.entities);
   const hookImports = entities.map((e) => `import { ${e.camelName}Hooks } from '../entities/${e.name}';`).join("\n");
@@ -5781,8 +5807,10 @@ export type AppStore = typeof store;
 }
 function buildResolversFile(ctx) {
   const entities = sortEntities(ctx.entities);
+  const fullFetch = lookupFullFetchNames(ctx);
+  const fetched = entities.filter((e) => fullFetch.has(e.name));
   const collectionImports = entities.map((e) => `import { ${e.camelName}Collection } from '../collections/${e.name}';`).join("\n");
-  const apiImports = entities.map((e) => `import { ${e.camelName}Api } from '../api/${e.name}';`).join("\n");
+  const apiImports = fetched.map((e) => `import { ${e.camelName}Api } from '../api/${e.name}';`).join("\n");
   const typeImports = entities.map((e) => `import type { ${e.className} } from '${ctx.config.dbEntitiesImport}/${e.name}';`).join("\n");
   const resolverIface = entities.map(
     (e) => `	${e.camelName}: (id: string | null | undefined) => ${e.className} | undefined;`
@@ -5795,7 +5823,7 @@ function buildResolversFile(ctx) {
 		},`
   ).join("\n");
   const hydrationCacheFields = entities.map((e) => `	${e.camelName}: new Map<string, ${e.className}>(),`).join("\n");
-  const hydrationCalls = entities.map(
+  const hydrationCalls = fetched.map(
     (e) => `		${e.camelName}Api.listAll().then((rows) => {
 			hydrationCache.${e.camelName} = new Map(rows.map((r) => [r.id as string, r]));
 		}),`
@@ -5884,22 +5912,34 @@ ${refsSection}`;
 }
 function buildLookupsFile(ctx) {
   const entities = sortEntities(ctx.entities);
+  const fullFetch = lookupFullFetchNames(ctx);
+  const fetched = entities.filter((e) => fullFetch.has(e.name));
   const collectionImports = entities.map((e) => `import { ${e.camelName}Collection } from '../collections/${e.name}';`).join("\n");
-  const apiImports = entities.map((e) => `import { ${e.camelName}Api } from '../api/${e.name}';`).join("\n");
+  const apiImports = fetched.map((e) => `import { ${e.camelName}Api } from '../api/${e.name}';`).join("\n");
   const typeImports = entities.map((e) => `import type { ${e.className} } from '${ctx.config.dbEntitiesImport}/${e.name}';`).join("\n");
   const lookupIface = entities.map((e) => `	${e.plural}: Map<string, ${e.className}>;`).join("\n");
-  const lookupBuild = entities.map(
-    (e) => `		${e.plural}: new Map(
+  const collectionStateMap = (e) => `		${e.plural}: new Map(
 			Array.from(${e.camelName}Collection.state.values()).map((item) => [
 				(item as ${e.className}).id as string,
 				item as ${e.className},
 			]),
-		),`
-  ).join("\n");
-  const lookupBuildAsyncDecls = entities.map((e) => `		${e.camelName}Api.listAll(),`).join("\n");
-  const lookupBuildAsyncFields = entities.map(
-    (e, i) => `		${e.plural}: new Map(rows[${i}].map((r) => [r.id as string, r as ${e.className}])),`
-  ).join("\n");
+		),`;
+  const lookupBuild = entities.map(collectionStateMap).join("\n");
+  const lookupBuildAsyncDecls = fetched.map((e) => `		${e.camelName}Api.listAll(),`).join("\n");
+  const fetchedIndex = new Map(fetched.map((e, i) => [e.name, i]));
+  const lookupBuildAsyncFields = entities.map((e) => {
+    const i = fetchedIndex.get(e.name);
+    return i === void 0 ? collectionStateMap(e) : `		${e.plural}: new Map(rows[${i}].map((r) => [r.id as string, r as ${e.className}])),`;
+  }).join("\n");
+  const lookupBuildAsyncBody = fetched.length > 0 ? `	const rows = await Promise.all([
+${lookupBuildAsyncDecls}
+	]);
+	return {
+${lookupBuildAsyncFields}
+	};` : `	await Promise.resolve();
+	return {
+${lookupBuildAsyncFields}
+	};`;
   const body = `${collectionImports}
 ${apiImports}
 ${typeImports}
@@ -5923,12 +5963,7 @@ ${lookupBuild}
  * may not be on the current page.
  */
 export async function buildLookupsAsync(): Promise<EntityLookups> {
-	const rows = await Promise.all([
-${lookupBuildAsyncDecls}
-	]);
-	return {
-${lookupBuildAsyncFields}
-	};
+${lookupBuildAsyncBody}
 }
 
 /**
@@ -5938,20 +5973,40 @@ ${lookupBuildAsyncFields}
  */
 export function createLookups() {
 	let cache: EntityLookups | null = null;
+	// Run-once guard for \`hydrate()\`. The store runtime calls hydrate from a
+	// per-mount useEffect with NO dedup, so without this every EntityList/useData
+	// mount (x2 under React StrictMode) kicks off another full buildLookupsAsync()
+	// \u2014 a listAll() of every entity. On a large table (tens of thousands of rows)
+	// that slurps the whole table N times concurrently and can OOM the renderer.
+	// The guard collapses all callers onto a single hydration: cache the resolved
+	// set, and dedupe concurrent callers onto one in-flight promise. \`clear()\`
+	// forces a refresh. NOTE: this caps the damage but does not make full-fetching
+	// a huge table cheap \u2014 lazy/on-demand FK resolution is the deeper fix.
+	let inFlight: Promise<EntityLookups> | null = null;
 	return {
 		build: (): EntityLookups => {
 			cache = buildLookups();
 			return cache;
 		},
 		hydrate: async (): Promise<EntityLookups> => {
-			cache = await buildLookupsAsync();
-			return cache;
+			if (cache) return cache;
+			if (inFlight) return inFlight;
+			inFlight = buildLookupsAsync()
+				.then((result) => {
+					cache = result;
+					return result;
+				})
+				.finally(() => {
+					inFlight = null;
+				});
+			return inFlight;
 		},
 		get current(): EntityLookups | null {
 			return cache;
 		},
 		clear: (): void => {
 			cache = null;
+			inFlight = null;
 		},
 	};
 }
@@ -6422,6 +6477,7 @@ var GenerateConfigSchema = z.object({
 }).passthrough();
 var PathsConfigSchema = z.object({
   events_dir: z.string().optional(),
+  jobs_dir: z.string().optional(),
   generated: z.string().default("src/generated")
 }).passthrough();
 var PatternsConfigSchema = z.array(z.string()).optional().default(["src/patterns/*.pattern.ts"]);