@pattern-stack/codegen 0.20.1 → 0.21.0

package/dist/runtime/subsystems/jobs/jobs-domain.module.js

@@ -1,21 +1,21 @@
 import {
   JobsDomainModule
-} from "../../../chunk-AJILKWGO.js";
+} from "../../../chunk-GMRTI7AK.js";
+import "../../../chunk-VQOAATIG.js";
+import "../../../chunk-3A34R6CI.js";
+import "../../../chunk-CDLWYZVQ.js";
+import "../../../chunk-L3LZWWSX.js";
 import "../../../chunk-DV4RV2DC.js";
-import "../../../chunk-MB5VVG4Z.js";
-import "../../../chunk-DUMI2J5M.js";
 import "../../../chunk-PNZSGAB2.js";
-import "../../../chunk-VNBC3VXM.js";
-import "../../../chunk-BHZP6LOV.js";
 import "../../../chunk-SNQ3TOWP.js";
-import "../../../chunk-T4BIIU5E.js";
-import "../../../chunk-L3LZWWSX.js";
 import "../../../chunk-I6MVCB5A.js";
 import "../../../chunk-RHVN6NA7.js";
-import "../../../chunk-ZPL74UQN.js";
-import "../../../chunk-7P5ODGLA.js";
-import "../../../chunk-OKXZ63IA.js";
+import "../../../chunk-TKU6VYG3.js";
+import "../../../chunk-T4BIIU5E.js";
 import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-OKXZ63IA.js";
+import "../../../chunk-7P5ODGLA.js";
+import "../../../chunk-ZPL74UQN.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/observability/index.js

@@ -5,18 +5,18 @@ import {
 } from "../../../chunk-EWYCWP4H.js";
 import {
   ObservabilityModule
-} from "../../../chunk-E45CSC33.js";
+} from "../../../chunk-XKWOJZZ4.js";
 import {
   BridgeMetricsReporter
 } from "../../../chunk-AQFQ4BYM.js";
-import "../../../chunk-W2UIDI3R.js";
+import "../../../chunk-CLWBNXKF.js";
 import {
   OBSERVABILITY,
   OBSERVABILITY_MODULE_OPTIONS
 } from "../../../chunk-Y7RRSEOC.js";
 import "../../../chunk-ZPL74UQN.js";
-import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-H5NH7KPE.js";
+import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/observability/observability.module.js

@@ -1,12 +1,12 @@
 import {
   ObservabilityModule
-} from "../../../chunk-E45CSC33.js";
+} from "../../../chunk-XKWOJZZ4.js";
 import "../../../chunk-AQFQ4BYM.js";
-import "../../../chunk-W2UIDI3R.js";
+import "../../../chunk-CLWBNXKF.js";
 import "../../../chunk-Y7RRSEOC.js";
 import "../../../chunk-ZPL74UQN.js";
-import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-H5NH7KPE.js";
+import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/observability/observability.service.js

@@ -1,9 +1,9 @@
 import {
   ObservabilityService
-} from "../../../chunk-W2UIDI3R.js";
+} from "../../../chunk-CLWBNXKF.js";
 import "../../../chunk-ZPL74UQN.js";
-import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-H5NH7KPE.js";
+import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/storage/index.js

@@ -1,10 +1,7 @@
 import "../../../chunk-ZUMULSEQ.js";
 import {
   StorageModule
-} from "../../../chunk-BK5ICA2F.js";
-import {
-  STORAGE
-} from "../../../chunk-NYBCQZC7.js";
+} from "../../../chunk-4MVGAMUA.js";
 import {
   LocalStorageBackend
 } from "../../../chunk-JWNHNUYL.js";
@@ -12,6 +9,9 @@ import {
   MemoryStorageBackend
 } from "../../../chunk-3SZFUTXE.js";
 import "../../../chunk-J6MN42LG.js";
+import {
+  STORAGE
+} from "../../../chunk-NYBCQZC7.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-2E224ZSN.js";
 export {

package/dist/runtime/subsystems/storage/storage.module.js

@@ -1,10 +1,10 @@
 import {
   StorageModule
-} from "../../../chunk-BK5ICA2F.js";
-import "../../../chunk-NYBCQZC7.js";
+} from "../../../chunk-4MVGAMUA.js";
 import "../../../chunk-JWNHNUYL.js";
 import "../../../chunk-3SZFUTXE.js";
 import "../../../chunk-J6MN42LG.js";
+import "../../../chunk-NYBCQZC7.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-2E224ZSN.js";
 export {

package/dist/src/cli/index.js

@@ -1,11 +1,15 @@
 #!/usr/bin/env node
 import {
   DIRECTION_TO_POOL,
+  EAV_DATA_TYPE_TO_FIELD_TYPE,
   EVENT_FIELD_TYPES,
+  EXTERNAL_SYNC_FIELDS,
+  EXTERNAL_SYNC_GROUP,
   _resetRegistryForTests,
   analyzeDomain,
   buildManifest,
   collectEntitySurfaces,
+  deriveFieldMeta,
   detectYamlType,
   findYamlFiles,
   formatConsole,
@@ -17,7 +21,9 @@ import {
   getManifestDir,
   getOrchestrationPatternNames,
   getPendingSuggestions,
+  hasExternalSyncShape,
   isActiveProvider,
+  isEntityRefField,
   isManifestStale,
   loadAppPatterns,
   loadEntities,
@@ -38,15 +44,19 @@ import {
   validateOrchestrationProject,
   validateProviders,
   writeManifest
-} from "../../chunk-KK5A7B2T.js";
+} from "../../chunk-524YKITE.js";
 import "../../chunk-KVOWSC5S.js";
-import "../../chunk-ATVGYF3D.js";
-import "../../chunk-YK5JEVLX.js";
+import "../../chunk-QFUIE37H.js";
+import "../../chunk-FFUDEIFF.js";
 import "../../chunk-EO2QPOKH.js";
 import "../../chunk-PRWIX6UW.js";
-import "../../chunk-XWBK3XJK.js";
+import "../../chunk-O2A6XHGD.js";
+import "../../chunk-HNWZFNKP.js";
 import "../../chunk-AHV4GDYM.js";
 import "../../chunk-SQDOBLBP.js";
+import "../../chunk-43SBT72G.js";
+import "../../chunk-4MF3HKJA.js";
+import "../../chunk-TIZXQU26.js";
 import "../../chunk-JEINYUJH.js";
 import {
   isDivisibleCursor
@@ -57,10 +67,6 @@ import "../../chunk-TDEHU73T.js";
 import "../../chunk-S7C6TIIF.js";
 import "../../chunk-MZ6GV4YF.js";
 import "../../chunk-LG57S2SC.js";
-import "../../chunk-HNWZFNKP.js";
-import "../../chunk-I6UXRJ3Q.js";
-import "../../chunk-TIZXQU26.js";
-import "../../chunk-4MF3HKJA.js";
 import "../../chunk-U64T4YZE.js";
 import "../../chunk-2E224ZSN.js";
 
@@ -2877,6 +2883,23 @@ var COMPOSERS = {
       ],
       calls: [`	IntegrationModule.forRoot({ ${parts.join(", ")} }),`]
     };
+  },
+  // #473 — observability combiner (ADR-025). NO `backend` / `multiTenant`:
+  // it owns no durable state — portability is inherited from whichever
+  // backends the composed siblings run (see `ObservabilityModule` docblock).
+  // The only `forRoot` option is `reporters` (OBS-6); thread the config
+  // block's `reporters:` when a reporter is enabled, else emit a bare
+  // `forRoot()`. Ordered LAST in `COMPOSABLE_ORDER` so it registers after the
+  // read ports it composes via `@Optional()` DI.
+  observability: ({ moduleImport, cfg }) => {
+    const reportersClause = observabilityReportersClause(cfg);
+    const opts = reportersClause ? `{ ${reportersClause} }` : "";
+    return {
+      imports: [
+        `import { ObservabilityModule } from '${moduleImport("observability", "observability.module")}';`
+      ],
+      calls: [`	ObservabilityModule.forRoot(${opts}),`]
+    };
   }
 };
 function integrationDifferClause(cfg) {
@@ -2891,6 +2914,18 @@ function integrationDifferClause(cfg) {
   if (Object.keys(inner).length === 0) return "";
   return `differ: ${jsonToTs(inner)}`;
 }
+function observabilityReportersClause(cfg) {
+  const reporters = cfg?.reporters;
+  if (!reporters || typeof reporters !== "object") return "";
+  const enabled = {};
+  for (const [key, value] of Object.entries(reporters)) {
+    if (value && typeof value === "object" && value.enabled === true) {
+      enabled[key] = value;
+    }
+  }
+  if (Object.keys(enabled).length === 0) return "";
+  return `reporters: ${jsonToTs(enabled)}`;
+}
 var PACKAGE2 = "@pattern-stack/codegen";
 function makeModuleImport(mode, subsystemsRel) {
   if (mode === "vendored") {
@@ -2898,7 +2933,13 @@ function makeModuleImport(mode, subsystemsRel) {
   }
   return (subsystem) => subsystem === "events" ? `${PACKAGE2}/subsystems` : `${PACKAGE2}/runtime/subsystems/${subsystem}/index`;
 }
-var COMPOSABLE_ORDER = ["events", "jobs", "bridge", "integration"];
+var COMPOSABLE_ORDER = [
+  "events",
+  "jobs",
+  "bridge",
+  "integration",
+  "observability"
+];
 var HEADER5 = `// AUTO-GENERATED by @pattern-stack/codegen. DO NOT EDIT.
 // Subsystem composition barrel \u2014 reflects \`subsystems.install\` in
 // codegen.config.yaml and the per-subsystem option blocks
@@ -5459,79 +5500,11 @@ function emitStore(ctx, outDir) {
 
 // src/emitters/frontend/emit-fields.ts
 import { join as join15 } from "path";
-
-// src/emitters/frontend/field-meta.ts
-var CAMEL2 = (s) => s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
-function formatLabel(fieldName) {
-  return fieldName.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-}
-function inferUiType(field) {
-  if (field.ui.type) return field.ui.type;
-  if (Array.isArray(field.choices) && field.choices.length > 0) return "enum";
-  if (field.foreignKey) return "reference";
-  const nameLower = field.name.toLowerCase();
-  if (nameLower.includes("email")) return "email";
-  if (nameLower.includes("url") || nameLower.includes("website")) return "url";
-  if (nameLower.includes("password")) return "password";
-  if (nameLower.includes("price") || nameLower.includes("amount") || nameLower.includes("cost") || nameLower.includes("value") || nameLower.includes("revenue")) {
-    return "money";
-  }
-  if (nameLower.includes("percent") || nameLower.includes("rate")) {
-    return "percentage";
-  }
-  switch (field.type) {
-    case "string":
-      return field.constraints.maxLength && field.constraints.maxLength > 500 ? "textarea" : "text";
-    case "integer":
-    case "decimal":
-      return "number";
-    case "boolean":
-      return "boolean";
-    case "uuid":
-      return "text";
-    case "date":
-      return "date";
-    case "datetime":
-      return "datetime";
-    case "json":
-      return "json";
-    default:
-      return "text";
-  }
-}
-function inferUiImportance(field) {
-  if (field.ui.importance) return field.ui.importance;
-  const nameLower = field.name.toLowerCase();
-  if (["id", "created_at", "updated_at", "deleted_at"].includes(nameLower)) {
-    return "tertiary";
-  }
-  if (field.foreignKey && nameLower.endsWith("_id")) return "secondary";
-  if (field.required) return "primary";
-  if (nameLower.includes("name") || nameLower.includes("title")) return "primary";
-  return "secondary";
-}
-function isEntityRefField(field) {
-  if (field.type === "entity_ref") return true;
-  return field.name.endsWith("_entity_type") || field.name.endsWith("_entity_id");
-}
-function deriveFieldMeta(field) {
-  const hasChoices = Array.isArray(field.choices) && field.choices.length > 0;
-  const meta = {
-    field: CAMEL2(field.name),
-    label: field.ui.label ?? formatLabel(field.name),
-    type: inferUiType(field),
-    importance: inferUiImportance(field),
-    sortable: field.ui.sortable ?? false,
-    filterable: field.ui.filterable ?? false
-  };
-  if (hasChoices) meta.choices = field.choices;
-  if (field.foreignKey) meta.reference = field.foreignKey.table;
-  return meta;
-}
-
-// src/emitters/frontend/emit-fields.ts
 var SOURCE_DESC_SET5 = "the entity set";
 function buildFieldMetaTypeFile() {
+  const eavKeys = Object.keys(EAV_DATA_TYPE_TO_FIELD_TYPE);
+  const eavUnion = eavKeys.map((k) => `	| '${k}'`).join("\n");
+  const eavEntries = Object.entries(EAV_DATA_TYPE_TO_FIELD_TYPE).map(([k, v]) => `	${k}: '${v}',`).join("\n");
   const body = `/**
  * Field metadata types for DataGrid, forms, and admin surfaces.
  */
@@ -5563,37 +5536,85 @@ export interface FieldMeta<T = unknown> {
 	importance: FieldImportance;
 	sortable?: boolean;
 	filterable?: boolean;
+	/** Layout grouping (e.g. 'external_sync'). */
+	group?: string;
+	/** \`false\` \u21D2 hidden by default. Absent means visible. */
+	visible?: boolean;
+	placeholder?: string;
+	/** Help/description text shown alongside the field. */
+	help?: string;
 	format?: Record<string, unknown>;
 	choices?: string[];
 	reference?: string;
+	/** Curated/displayed field \u2014 drives card & preview field selection. */
+	isKeyField?: boolean;
+	/** Sort position within the key-field set. */
+	keyFieldOrder?: number;
 }
+
+/** EAV \`field_definitions.data_type\` vocabulary. */
+export type EavDataType =
+${eavUnion};
+
+/**
+ * EAV \`field_definitions.data_type\` \u2192 \`FieldType\` rendering contract: an EAV
+ * field renders through the same vocabulary as a native column. Note both
+ * \`picklist\` and \`multipicklist\` map to \`enum\` \u2014 multi-select rendering is a
+ * consumer-side concern (check the EAV row's cardinality, not the FieldType).
+ */
+export const EAV_DATA_TYPE_TO_FIELD_TYPE: Record<EavDataType, FieldType> = {
+${eavEntries}
+};
 `;
   return withBanner(SOURCE_DESC_SET5, body);
 }
 function hasTimestamps(parsed) {
   return parsed?.behaviors.includes("timestamps") ?? false;
 }
+function hasSoftDelete(parsed) {
+  return parsed?.behaviors.includes("soft_delete") ?? false;
+}
 function displayFields(parsed) {
   if (!parsed) return [];
+  const syncShape = hasExternalSyncShape(parsed.fields.keys());
   const out = [];
   for (const field of parsed.fields.values()) {
     if (field.name === "id") continue;
     if (isEntityRefField(field)) continue;
-    out.push(deriveFieldMeta(field));
+    const defaults = syncShape && EXTERNAL_SYNC_FIELDS.has(field.name) ? { group: EXTERNAL_SYNC_GROUP } : void 0;
+    out.push(deriveFieldMeta(field, defaults));
   }
   return out;
 }
+function quote(s) {
+  return s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
 function renderFieldMeta(meta) {
   const lines = [
     `		field: '${meta.field}',`,
-    `		label: '${meta.label}',`,
+    `		label: '${quote(meta.label)}',`,
     `		type: '${meta.type}' as FieldType,`,
     `		importance: '${meta.importance}' as FieldImportance,`
   ];
   if (meta.sortable) lines.push("		sortable: true,");
   if (meta.filterable) lines.push("		filterable: true,");
+  if (meta.group !== void 0) lines.push(`		group: '${quote(meta.group)}',`);
+  if (meta.visible !== void 0) lines.push(`		visible: ${meta.visible},`);
+  if (meta.placeholder !== void 0) {
+    lines.push(`		placeholder: '${quote(meta.placeholder)}',`);
+  }
+  if (meta.help !== void 0) lines.push(`		help: '${quote(meta.help)}',`);
+  if (meta.format !== void 0) {
+    lines.push(`		format: ${JSON.stringify(meta.format)},`);
+  }
   if (meta.choices) lines.push(`		choices: ${JSON.stringify(meta.choices)},`);
   if (meta.reference) lines.push(`		reference: '${meta.reference}',`);
+  if (meta.isKeyField) {
+    lines.push("		isKeyField: true,");
+    if (meta.keyFieldOrder !== void 0) {
+      lines.push(`		keyFieldOrder: ${meta.keyFieldOrder},`);
+    }
+  }
   return `	${meta.field}: {
 ${lines.join("\n")}
 	},`;
@@ -5607,6 +5628,7 @@ function buildEntityFieldsFile(entity, ctx) {
   const fields = displayFields(parsed);
   const rels = resolvableRels(entity, ctx);
   const ts3 = hasTimestamps(parsed);
+  const sd = hasSoftDelete(parsed);
   const fieldEntries = fields.map(renderFieldMeta);
   const relEntries = rels.map(
     (r) => `	${r.propertyName}: {
@@ -5633,8 +5655,22 @@ function buildEntityFieldsFile(entity, ctx) {
 		format: { dateFormat: 'relative' },
 	},`
   ] : [];
-  const allEntries = [...fieldEntries, ...relEntries, ...tsEntries].join("\n");
+  const sdEntries = sd ? [
+    `	deletedAt: {
+		field: 'deletedAt',
+		label: 'Deleted',
+		type: 'datetime' as FieldType,
+		importance: 'tertiary' as FieldImportance,
+		format: { dateFormat: 'relative' },
+	},`
+  ] : [];
+  const allEntries = [...fieldEntries, ...relEntries, ...tsEntries, ...sdEntries].join(
+    "\n"
+  );
   const primaryFields = fields.filter((f) => f.importance === "primary").map((f) => `		'${f.field}',`).join("\n");
+  const keyFields = fields.filter((f) => f.isKeyField).sort(
+    (a, b) => (a.keyFieldOrder ?? Number.MAX_SAFE_INTEGER) - (b.keyFieldOrder ?? Number.MAX_SAFE_INTEGER)
+  ).map((f) => `		'${f.field}',`).join("\n");
   const searchFields = fields.filter((f) => f.filterable).map((f) => `		'${f.field}',`).join("\n");
   const defaultSortField = ts3 ? "createdAt" : "id";
   const expose = parsed?.expose ?? ["repository", "rest", "trpc"];
@@ -5656,6 +5692,9 @@ export const ${camelName}Metadata = {
 
 	primaryFields: [
 ${primaryFields}
+	],
+	keyFields: [
+${keyFields}
 	],
 	searchFields: [
 ${searchFields}
@@ -8622,7 +8661,7 @@ function buildAuthImportRewriter(subsystemsRoot) {
     const relPosix = rel2.split(path24.sep).join("/");
     return content.replace(
       AUTH_BARE_IMPORT_RE,
-      (_match, quote) => `${quote}${relPosix}${quote}`
+      (_match, quote2) => `${quote2}${relPosix}${quote2}`
     );
   };
 }