@dereekb/dbx-cli 13.16.0 → 13.17.0

package/eslint/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@dereekb/dbx-cli/eslint",
+  "version": "13.17.0",
+  "peerDependencies": {
+    "@dereekb/dbx-cli": "13.17.0",
+    "@dereekb/util": "13.17.0",
+    "@typescript-eslint/utils": "8.59.3"
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "8.59.3",
+    "eslint": "10.4.0"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "module": "./index.esm.js",
+      "types": "./index.d.ts",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
+    }
+  },
+  "module": "./index.esm.js",
+  "main": "./index.cjs.js",
+  "types": "./index.d.ts"
+}

package/eslint/rollup.alias-internal.config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @param config - The rollup config @nx/rollup hands to the hook.
+ * @param _options - The @nx/rollup options (unused).
+ * @returns The mutated rollup config.
+ *
+ * @nx /rollup `rollupConfig` hook that inlines the workspace's internal `@dereekb/*` imports into
+ * the published ESLint plugin bundle. Prepends an alias plugin redirecting {@link INTERNAL_ALIASES}
+ * to their TS sources and wraps the `external: "all"` callback so {@link BUNDLED_DEPENDENCIES} are
+ * treated as internal.
+ */
+export default function applyInternalAliases(config: any, _options: any): Promise<any>;

package/eslint/src/index.d.ts

@@ -0,0 +1 @@
+export * from './lib';

package/eslint/src/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { DBX_CLI_VALID_DBX_ROUTE_MODEL_TAGS_RULE, type DbxCliValidDbxRouteModelTagsRuleDefinition } from './valid-dbx-route-model-tags.rule';
+export { DBX_CLI_ESLINT_PLUGIN, dbxCliESLintPlugin, type DbxCliEslintPlugin } from './plugin';

package/eslint/src/lib/plugin.d.ts

@@ -0,0 +1,22 @@
+import { type DbxCliValidDbxRouteModelTagsRuleDefinition } from './valid-dbx-route-model-tags.rule';
+/**
+ * ESLint plugin interface for `@dereekb/dbx-cli` rules.
+ */
+export interface DbxCliEslintPlugin {
+    readonly rules: {
+        readonly 'valid-dbx-route-model-tags': DbxCliValidDbxRouteModelTagsRuleDefinition;
+    };
+}
+/**
+ * ESLint plugin for `@dereekb/dbx-cli` rules.
+ *
+ * Register as a plugin in your flat ESLint config, then enable individual rules
+ * under the chosen plugin prefix (e.g. 'dereekb-dbx-cli/valid-dbx-route-model-tags').
+ */
+export declare const DBX_CLI_ESLINT_PLUGIN: DbxCliEslintPlugin;
+/**
+ * camelCase alias of {@link DBX_CLI_ESLINT_PLUGIN} matching the conventional ESLint plugin export name.
+ *
+ * @dbxAllowConstantName
+ */
+export declare const dbxCliESLintPlugin: DbxCliEslintPlugin;

package/eslint/src/lib/valid-dbx-route-model-tags.rule.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ESLint rule that validates `@dbxRouteModel` / `@dbxRouteModelList` JSDoc tag
+ * grammar at author time. Each tag is parsed through `@dereekb/dbx-cli`'s
+ * canonical {@link parseRouteModelTag} grammar — the exact parser the build-time
+ * route-manifest builder uses — so ESLint and the manifest generator can never
+ * disagree about what a valid tag is. A malformed tag (typo'd model type, bad
+ * key template, wrong token count, unknown `@dbxRouteModel*` name) is reported on
+ * its own JSDoc line with the parser's failure reason.
+ *
+ * Scope: route-model tags live on `@Component` classes in `*.component.ts` and on
+ * exported `Ng2StateDeclaration` consts in `*.router.ts`, so the rule visits class
+ * and variable declarations (anchoring to their `export` wrapper for the leading
+ * JSDoc). It has no auto-fix — the correct value requires human / agent judgment.
+ */
+interface AstNode {
+    readonly type: string;
+    [key: string]: any;
+}
+/**
+ * ESLint rule definition for valid-dbx-route-model-tags.
+ */
+export interface DbxCliValidDbxRouteModelTagsRuleDefinition {
+    readonly meta: {
+        readonly type: 'problem';
+        readonly docs: {
+            readonly description: string;
+            readonly recommended: boolean;
+        };
+        readonly messages: Readonly<Record<string, string>>;
+        readonly schema: readonly object[];
+    };
+    create(context: {
+        report: (descriptor: {
+            loc?: AstNode;
+            node?: AstNode;
+            messageId: string;
+            data?: Record<string, string>;
+        }) => void;
+        sourceCode: AstNode;
+    }): Record<string, (node: AstNode) => void>;
+}
+/**
+ * ESLint rule enforcing that `@dbxRouteModel` / `@dbxRouteModelList` tags parse
+ * cleanly through the canonical route-model grammar. Reuses
+ * {@link parseRouteModelTag} from `@dereekb/dbx-cli` so a tag that lints clean is
+ * a tag the build-time manifest builder will accept.
+ *
+ * Checks (delegated to the grammar parser):
+ *
+ * - `@dbxRouteModel <modelType> <keyTemplate>` has exactly two tokens with a valid
+ *   model-type identifier and a parseable key template (`:param` / `{authUid}` /
+ *   even-segment `gb/:id/...` form).
+ * - `@dbxRouteModelList <modelType>` has a single valid model-type token.
+ * - A `@dbxRouteModel*` tag with an unknown name is flagged.
+ *
+ * Report-only — no auto-fix, since the corrected value needs judgment.
+ */
+export declare const DBX_CLI_VALID_DBX_ROUTE_MODEL_TAGS_RULE: DbxCliValidDbxRouteModelTagsRuleDefinition;
+export {};

package/firebase-api-manifest/main.js

@@ -469,14 +469,92 @@ function readJsDocSummary(node) {
   return result;
 }
 
+// packages/util/src/lib/string/sort.ts
+var compareStrings = (a, b) => a.localeCompare(b);
+
+// packages/dbx-cli/src/lib/scan-helpers/firestore-model-extract-utils.ts
+import { Node as Node3 } from "ts-morph";
+var PASSTHROUGH_TYPE_WRAPPERS = /* @__PURE__ */ new Set(["Partial", "Required", "Readonly", "NonNullable", "MaybeMap", "Pick", "Omit"]);
+function parseFirestoreModelIdentityArgs(args) {
+  let result;
+  if (args.length === 1) {
+    const modelType = stringLiteralValue(args[0]);
+    if (modelType !== void 0) {
+      result = { modelType, collectionPrefix: void 0, parentIdentityConst: void 0 };
+    }
+  } else if (args.length === 2) {
+    const first = stringLiteralValue(args[0]);
+    if (first === void 0) {
+      const modelType = stringLiteralValue(args[1]);
+      if (modelType !== void 0) {
+        result = { modelType, collectionPrefix: void 0, parentIdentityConst: identifierName(args[0]) };
+      }
+    } else {
+      result = { modelType: first, collectionPrefix: stringLiteralValue(args[1]), parentIdentityConst: void 0 };
+    }
+  } else if (args.length >= 3) {
+    const modelType = stringLiteralValue(args[1]);
+    if (modelType !== void 0) {
+      result = { modelType, collectionPrefix: stringLiteralValue(args[2]), parentIdentityConst: identifierName(args[0]) };
+    }
+  }
+  return result;
+}
+function resolveExtendsName(expr) {
+  const head = expr.getExpression().getText();
+  let result = head;
+  if (PASSTHROUGH_TYPE_WRAPPERS.has(head)) {
+    const typeArgs = expr.getTypeArguments();
+    if (typeArgs.length > 0) {
+      const peeled = peelTypeNode(typeArgs[0]);
+      if (peeled !== void 0) {
+        result = peeled;
+      }
+    }
+  }
+  return result;
+}
+function peelTypeNode(node) {
+  let current = node;
+  while (Node3.isParenthesizedTypeNode(current)) {
+    current = current.getTypeNode();
+  }
+  let result;
+  if (Node3.isTypeReference(current)) {
+    const name = current.getTypeName().getText();
+    if (PASSTHROUGH_TYPE_WRAPPERS.has(name)) {
+      const inner = current.getTypeArguments();
+      if (inner.length > 0) {
+        result = peelTypeNode(inner[0]);
+      }
+    } else {
+      result = name;
+    }
+  }
+  return result;
+}
+function stringLiteralValue(node) {
+  let result;
+  if (Node3.isStringLiteral(node) || Node3.isNoSubstitutionTemplateLiteral(node)) {
+    result = node.getLiteralText();
+  }
+  return result;
+}
+function identifierName(node) {
+  let result;
+  if (Node3.isIdentifier(node)) {
+    result = node.getText();
+  }
+  return result;
+}
+
 // packages/dbx-cli/manifest-extract/src/lib/extract-models.ts
-import { Node as Node3, Project as Project3 } from "ts-morph";
+import { Node as Node4, Project as Project3 } from "ts-morph";
 var READ_LEVEL_VALUES = /* @__PURE__ */ new Set(["system", "owner", "admin-only", "permissions"]);
 var SERVICE_FACTORY_TAG = "dbxModelServiceFactory";
 var MCP_TOOL_NAME_SEGMENT_TAG = "dbxModelMcpToolNameSegment";
 var MODEL_TYPE_VALUE_PATTERN = /^[a-z][A-Za-z0-9_$]*$/;
 var TOOL_NAME_SEGMENT_PATTERN = /^[A-Za-z][A-Za-z0-9_$]*$/;
-var PASSTHROUGH_TYPE_WRAPPERS = /* @__PURE__ */ new Set(["Partial", "Required", "Readonly", "NonNullable", "MaybeMap", "Pick", "Omit"]);
 var IDENTITY_FN = "firestoreModelIdentity";
 var CONVERTER_FN_NAMES = ["snapshotConverterFunctions", "firestoreSubObject", "firestoreObjectArray"];
 var SUB_OBJECT_FN = "firestoreSubObject";
@@ -484,6 +562,7 @@ var OBJECT_ARRAY_FN = "firestoreObjectArray";
 var SNAPSHOT_FN = "snapshotConverterFunctions";
 var FIELDS_LITERAL_KEY = "fields";
 var OBJECT_FIELD_KEY = "objectField";
+var FIRESTORE_FIELD_KEY = "firestoreField";
 function extractModelsFromSource(input) {
   const project = new Project3({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(input.name, input.text, { overwrite: true });
@@ -501,9 +580,9 @@ function readIdentities(sourceFile) {
     if (!statement.isExported()) continue;
     for (const decl of statement.getDeclarations()) {
       const initializer = decl.getInitializer();
-      if (!initializer || !Node3.isCallExpression(initializer)) continue;
+      if (!initializer || !Node4.isCallExpression(initializer)) continue;
       if (initializer.getExpression().getText() !== IDENTITY_FN) continue;
-      const parsed = parseIdentityArgs(initializer);
+      const parsed = parseFirestoreModelIdentityArgs(initializer.getArguments());
       if (parsed) {
         out.push({ identityConst: decl.getName(), ...parsed });
       }
@@ -511,32 +590,6 @@ function readIdentities(sourceFile) {
   }
   return out;
 }
-function parseIdentityArgs(call) {
-  const args = call.getArguments();
-  let result;
-  if (args.length === 1) {
-    const modelType = stringLiteralValue(args[0]);
-    if (modelType !== void 0) {
-      result = { modelType, collectionPrefix: void 0, parentIdentityConst: void 0 };
-    }
-  } else if (args.length === 2) {
-    const first = stringLiteralValue(args[0]);
-    if (first === void 0) {
-      const modelType = stringLiteralValue(args[1]);
-      if (modelType !== void 0) {
-        result = { modelType, collectionPrefix: void 0, parentIdentityConst: identifierName(args[0]) };
-      }
-    } else {
-      result = { modelType: first, collectionPrefix: stringLiteralValue(args[1]), parentIdentityConst: void 0 };
-    }
-  } else if (args.length >= 3) {
-    const modelType = stringLiteralValue(args[1]);
-    if (modelType !== void 0) {
-      result = { modelType, collectionPrefix: stringLiteralValue(args[2]), parentIdentityConst: identifierName(args[0]) };
-    }
-  }
-  return result;
-}
 function readInterfaces(sourceFile) {
   const out = [];
   for (const decl of sourceFile.getInterfaces()) {
@@ -637,46 +690,13 @@ function readServiceFactoryModelType(jsDocs) {
   }
   return result;
 }
-function resolveExtendsName(expr) {
-  const head = expr.getExpression().getText();
-  let result = head;
-  if (PASSTHROUGH_TYPE_WRAPPERS.has(head)) {
-    const typeArgs = expr.getTypeArguments();
-    if (typeArgs.length > 0) {
-      const peeled = peelTypeNode(typeArgs[0]);
-      if (peeled !== void 0) {
-        result = peeled;
-      }
-    }
-  }
-  return result;
-}
-function peelTypeNode(node) {
-  let current = node;
-  while (Node3.isParenthesizedTypeNode(current)) {
-    current = current.getTypeNode();
-  }
-  let result;
-  if (Node3.isTypeReference(current)) {
-    const name = current.getTypeName().getText();
-    if (PASSTHROUGH_TYPE_WRAPPERS.has(name)) {
-      const inner = current.getTypeArguments();
-      if (inner.length > 0) {
-        result = peelTypeNode(inner[0]);
-      }
-    } else {
-      result = name;
-    }
-  }
-  return result;
-}
 function readConverters(sourceFile) {
   const out = [];
   for (const statement of sourceFile.getVariableStatements()) {
     if (!statement.isExported()) continue;
     for (const decl of statement.getDeclarations()) {
       const initializer = decl.getInitializer();
-      if (!initializer || !Node3.isCallExpression(initializer)) continue;
+      if (!initializer || !Node4.isCallExpression(initializer)) continue;
       const factory = initializer.getExpression().getText();
       if (!isConverterFactoryName(factory)) continue;
       const interfaceName = readGenericInterfaceName(initializer);
@@ -710,13 +730,13 @@ function readConverterFields(call) {
   let result;
   if (args.length > 0) {
     const config = args[0];
-    if (Node3.isObjectLiteralExpression(config)) {
+    if (Node4.isObjectLiteralExpression(config)) {
       let fieldsLiteral;
       if (fnName === SNAPSHOT_FN) {
         fieldsLiteral = readObjectProperty(config, FIELDS_LITERAL_KEY);
       } else {
         const objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
-        if (objectField && Node3.isObjectLiteralExpression(objectField)) {
+        if (objectField && Node4.isObjectLiteralExpression(objectField)) {
           fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
         }
       }
@@ -730,7 +750,7 @@ function readConverterFields(call) {
 function readFieldEntries(fields) {
   const out = [];
   for (const property of fields.getProperties()) {
-    if (Node3.isPropertyAssignment(property)) {
+    if (Node4.isPropertyAssignment(property)) {
       const initializer = property.getInitializer();
       const converterText = initializer ? initializer.getText().replaceAll(/\s+/g, " ").trim() : "";
       const nested = initializer ? readNestedFromExpression(initializer) : void 0;
@@ -741,7 +761,7 @@ function readFieldEntries(fields) {
         nestedConverterInline: nested?.inline,
         nestedIsArray: nested?.isArray
       });
-    } else if (Node3.isShorthandPropertyAssignment(property)) {
+    } else if (Node4.isShorthandPropertyAssignment(property)) {
       const name = property.getName();
       out.push({ key: name, converter: name });
     }
@@ -750,7 +770,7 @@ function readFieldEntries(fields) {
 }
 function readNestedFromExpression(expr) {
   let result;
-  if (Node3.isCallExpression(expr)) {
+  if (Node4.isCallExpression(expr)) {
     const fnName = expr.getExpression().getText();
     if (fnName === SUB_OBJECT_FN || fnName === OBJECT_ARRAY_FN) {
       result = readNestedConverterCall(expr, fnName);
@@ -763,10 +783,10 @@ function readNestedConverterCall(call, fnName) {
   const args = call.getArguments();
   if (args.length > 0) {
     const config = args[0];
-    if (Node3.isObjectLiteralExpression(config)) {
-      const objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
-      if (objectField) {
-        result = buildNestedConverterMatch({ objectField, call, fnName });
+    if (Node4.isObjectLiteralExpression(config)) {
+      const valueNode = readPropertyValue(config, OBJECT_FIELD_KEY) ?? readPropertyValue(config, FIRESTORE_FIELD_KEY);
+      if (valueNode) {
+        result = buildNestedConverterMatch({ objectField: valueNode, call, fnName });
       }
     }
   }
@@ -776,9 +796,9 @@ function buildNestedConverterMatch(input) {
   const { objectField, call, fnName } = input;
   const isArray = fnName === OBJECT_ARRAY_FN;
   let result;
-  if (Node3.isIdentifier(objectField)) {
+  if (Node4.isIdentifier(objectField)) {
     result = { ref: objectField.getText(), isArray };
-  } else if (Node3.isObjectLiteralExpression(objectField)) {
+  } else if (Node4.isObjectLiteralExpression(objectField)) {
     const fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
     if (fieldsLiteral) {
       result = {
@@ -792,22 +812,27 @@ function buildNestedConverterMatch(input) {
         isArray
       };
     }
+  } else if (Node4.isCallExpression(objectField)) {
+    const nested = readNestedFromExpression(objectField);
+    if (nested) {
+      result = { ...nested, isArray };
+    }
   }
   return result;
 }
 function readPropertyValue(literal, key) {
   const property = literal.getProperty(key);
   let result;
-  if (property && Node3.isPropertyAssignment(property)) {
+  if (property && Node4.isPropertyAssignment(property)) {
     result = property.getInitializer();
-  } else if (property && Node3.isShorthandPropertyAssignment(property)) {
+  } else if (property && Node4.isShorthandPropertyAssignment(property)) {
     result = property.getNameNode();
   }
   return result;
 }
 function readObjectProperty(literal, key) {
   const value = readPropertyValue(literal, key);
-  return value && Node3.isObjectLiteralExpression(value) ? value : void 0;
+  return value && Node4.isObjectLiteralExpression(value) ? value : void 0;
 }
 function readEnums(sourceFile) {
   const out = [];
@@ -906,20 +931,6 @@ function firstParagraph(text) {
   }
   return collected.join(" ").trim();
 }
-function stringLiteralValue(node) {
-  let result;
-  if (Node3.isStringLiteral(node) || Node3.isNoSubstitutionTemplateLiteral(node)) {
-    result = node.getLiteralText();
-  }
-  return result;
-}
-function identifierName(node) {
-  let result;
-  if (Node3.isIdentifier(node)) {
-    result = node.getText();
-  }
-  return result;
-}
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/find-api-files.ts
 function findApiFiles(packageRoot) {
@@ -1022,6 +1033,47 @@ function assembleModels(input) {
   accumulator.entries.sort((a, b) => a.modelType.localeCompare(b.modelType));
   return accumulator.entries;
 }
+function collectModelEnums(input) {
+  const registry = buildEnumRegistry(input.extractions);
+  const referenced = collectReferencedEnumNames(input.models);
+  const out = {};
+  for (const name of [...referenced].sort((a, b) => a.localeCompare(b))) {
+    const extracted = registry.get(name);
+    if (extracted) {
+      out[name] = buildModelEnumEntry(extracted);
+    }
+  }
+  return out;
+}
+function buildEnumRegistry(extractions) {
+  const registry = /* @__PURE__ */ new Map();
+  for (const { extraction } of extractions) {
+    for (const e of extraction.enums) {
+      if (!registry.has(e.name)) registry.set(e.name, e);
+    }
+  }
+  return registry;
+}
+function collectReferencedEnumNames(models) {
+  const referenced = /* @__PURE__ */ new Set();
+  for (const model of models) {
+    addReferencedEnumNames(model.fields, referenced);
+  }
+  return referenced;
+}
+function addReferencedEnumNames(fields, referenced) {
+  for (const field of fields) {
+    if (field.enumRef) referenced.add(field.enumRef);
+    if (field.nestedFields) addReferencedEnumNames(field.nestedFields, referenced);
+  }
+}
+function buildModelEnumEntry(e) {
+  return {
+    name: e.name,
+    values: e.values.map((v) => v.description ? { name: v.name, value: v.value, description: v.description } : { name: v.name, value: v.value }),
+    ...e.description ? { description: e.description } : {}
+  };
+}
 function buildGlobalRegistries(extractions) {
   const converterRegistry = /* @__PURE__ */ new Map();
   const interfaceRegistry = /* @__PURE__ */ new Map();
@@ -1358,13 +1410,8 @@ function escapeRegExp(value) {
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/emit.ts
 import { format, resolveConfig } from "prettier";
-
-// packages/util/src/lib/string/sort.ts
-var compareStrings = (a, b) => a.localeCompare(b);
-
-// packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/emit.ts
 async function renderManifest(input) {
-  const { outputFile, entries, projectName, namespace, modelEntries, modelNamespace, emitConverters = false } = input;
+  const { outputFile, entries, projectName, namespace, modelEntries, modelNamespace, enumEntries, enumNamespace, emitConverters = false } = input;
   const importsByPackage = /* @__PURE__ */ new Map();
   for (const entry of entries) {
     if (!entry.packageName || !entry.validatorName) continue;
@@ -1378,12 +1425,18 @@ async function renderManifest(input) {
   });
   const entryLines = entries.map((e) => renderEntry(e));
   const emitModels = Boolean(modelEntries && modelEntries.length > 0 && modelNamespace);
-  const dbxCliTypeImports = emitModels ? `import { type CliApiManifest, type CliModelManifest } from '@dereekb/dbx-cli';` : `import { type CliApiManifest } from '@dereekb/dbx-cli';`;
+  const emitEnums = Boolean(enumEntries && Object.keys(enumEntries).length > 0 && enumNamespace);
+  const dbxCliTypeNames = ["type CliApiManifest", ...emitModels ? ["type CliModelManifest"] : [], ...emitEnums ? ["type CliEnumManifest"] : []];
+  const dbxCliTypeImports = `import { ${dbxCliTypeNames.join(", ")} } from '@dereekb/dbx-cli';`;
   const modelSection = emitModels ? `
 
 export const ${modelNamespace}: CliModelManifest = [
 ${(modelEntries ?? []).map((m) => renderModelEntry(m, emitConverters)).join(",\n")}
 ];
+` : "";
+  const enumSection = emitEnums ? `
+
+export const ${enumNamespace}: CliEnumManifest = ${renderEnumManifest(enumEntries ?? {})};
 ` : "";
   const source = `/* eslint-disable @nx/enforce-module-boundaries */
 // AUTO-GENERATED \u2014 DO NOT EDIT.
@@ -1394,7 +1447,7 @@ ${dbxCliTypeImports}
 
 export const ${namespace}: CliApiManifest = [
 ${entryLines.join(",\n")}
-];${modelSection}
+];${modelSection}${enumSection}
 `;
   return formatWithPrettier(source, outputFile);
 }
@@ -1459,6 +1512,23 @@ function renderModelFields(fields, emitConverters) {
   }
   return result;
 }
+function renderEnumManifest(enums) {
+  const names = Object.keys(enums).sort((a, b) => a.localeCompare(b));
+  const items = names.map((name) => `${JSON.stringify(name)}: ${renderEnumEntry(enums[name])}`);
+  return names.length === 0 ? "{}" : `{ ${items.join(", ")} }`;
+}
+function renderEnumEntry(entry) {
+  const parts = [`name: ${JSON.stringify(entry.name)}`, `values: ${renderEnumValues(entry.values)}`, entry.description ? `description: ${JSON.stringify(entry.description)}` : void 0];
+  return `{ ${parts.filter(Boolean).join(", ")} }`;
+}
+function renderEnumValues(values) {
+  const items = values.map((value) => renderEnumValue(value));
+  return `[${items.join(", ")}]`;
+}
+function renderEnumValue(value) {
+  const parts = [`name: ${JSON.stringify(value.name)}`, `value: ${JSON.stringify(value.value)}`, value.description ? `description: ${JSON.stringify(value.description)}` : void 0];
+  return `{ ${parts.filter(Boolean).join(", ")} }`;
+}
 function renderModelField(field, emitConverters) {
   const nestedIsArrayLiteral = field.nestedIsArray ? "true" : "false";
   const parts = [
@@ -1566,8 +1636,9 @@ async function main() {
   collected.sort(compareEntries);
   const modelEntries = flags.emitModels ? assembleModels({ extractions: modelSources }) : [];
   const filteredModelEntries = flags.only ? modelEntries.filter((m) => flags.only?.has(m.modelType)) : modelEntries;
+  const enumEntries = flags.emitModels ? collectModelEnums({ extractions: modelSources, models: filteredModelEntries }) : {};
   ensureOutputDir(outputDir);
-  const formatted = await renderManifest({ outputFile, entries: collected, projectName, namespace, modelEntries: filteredModelEntries, modelNamespace: deriveModelNamespace(flags.project), emitConverters: flags.emitModelConverters });
+  const formatted = await renderManifest({ outputFile, entries: collected, projectName, namespace, modelEntries: filteredModelEntries, modelNamespace: deriveModelNamespace(flags.project), enumEntries, enumNamespace: deriveEnumNamespace(flags.project), emitConverters: flags.emitModelConverters });
   if (existsSync3(outputFile) && readFileSync6(outputFile, "utf8") === formatted) {
     console.log(`[unchanged] ${relative2(WORKSPACE_ROOT, outputFile)}`);
   } else {
@@ -1575,7 +1646,7 @@ async function main() {
     console.log(`[wrote] ${relative2(WORKSPACE_ROOT, outputFile)}`);
   }
   const groupCount = packageCache.size === 0 ? 0 : new Set(collected.map((c) => c.entry.groupName)).size;
-  const modelSummary = flags.emitModels ? ` \xB7 ${filteredModelEntries.length} models` : "";
+  const modelSummary = flags.emitModels ? ` \xB7 ${filteredModelEntries.length} models \xB7 ${Object.keys(enumEntries).length} enums` : "";
   console.log(`Summary: ${groupCount} groups \xB7 ${collected.length} entries \xB7 ${collected.length - missingValidators} validators bound \xB7 ${missingValidators} missing \xB7 ${skippedGroups} skipped${modelSummary}`);
   if (flags.strict && missingValidators > 0) {
     console.error(`[strict] ${missingValidators} validator(s) missing \u2014 failing build.`);
@@ -1607,6 +1678,10 @@ function deriveModelNamespace(projectName) {
   const base = (projectName ?? "cli").replaceAll(/[^a-zA-Z0-9]+/g, "_");
   return `${base.toUpperCase()}_MODEL_MANIFEST`;
 }
+function deriveEnumNamespace(projectName) {
+  const base = (projectName ?? "cli").replaceAll(/[^a-zA-Z0-9]+/g, "_");
+  return `${base.toUpperCase()}_ENUM_MANIFEST`;
+}
 function parseFlags(argv) {
   let only;
   let strict = false;

package/firebase-api-manifest/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@dereekb/dbx-cli-firebase-api-manifest",
-  "version": "13.16.0",
+  "version": "13.17.0",
   "private": true,
   "type": "module",
   "devDependencies": {
     "ts-morph": "^21.0.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "13.16.0",
-    "@dereekb/util": "13.16.0",
+    "@dereekb/dbx-cli": "13.17.0",
+    "@dereekb/util": "13.17.0",
     "prettier": "3.8.3"
   }
 }

package/generate-firestore-indexes/main.js

@@ -5,14 +5,14 @@ const require = __createRequire(import.meta.url);
 // packages/dbx-cli/generate-firestore-indexes/package.json
 var package_default = {
   name: "@dereekb/dbx-cli-generate-firestore-indexes",
-  version: "13.16.0",
+  version: "13.17.0",
   private: true,
   type: "module",
   devDependencies: {
     eslint: "10.4.0"
   },
   peerDependencies: {
-    "@dereekb/dbx-cli": "13.16.0"
+    "@dereekb/dbx-cli": "13.17.0"
   }
 };
 

package/generate-firestore-indexes/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/dbx-cli-generate-firestore-indexes",
-  "version": "13.16.0",
+  "version": "13.17.0",
   "private": true,
   "type": "module",
   "devDependencies": {
     "eslint": "10.4.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "13.16.0"
+    "@dereekb/dbx-cli": "13.17.0"
   }
 }

package/generate-mcp-manifest/main.js

@@ -1022,11 +1022,13 @@ function renderMcpManifest(input, now = /* @__PURE__ */ new Date()) {
     registerToolEntry({ entry, segments, nameCounts, tools, seenNames, warnings, errors });
   }
   const models = input.modelManifest != null && input.modelManifest.length > 0 ? input.modelManifest.map(projectModelEntry) : void 0;
+  const enums = input.enumManifest != null && Object.keys(input.enumManifest).length > 0 ? input.enumManifest : void 0;
   const auth = input.auth == null ? void 0 : projectAuthSection(input.auth.registry, input.auth.app);
   const base = { version: MCP_MANIFEST_VERSION, generatedAt: now.toISOString(), tools };
   const manifest = {
     ...base,
     ...models == null ? {} : { models },
+    ...enums == null ? {} : { enums },
     ...auth == null ? {} : { auth }
   };
   return { manifest, warnings, errors };
@@ -1312,8 +1314,9 @@ Expected output of \`nx run <cli>:generate-api-manifest\`.`);
   writeFileSync(tmpPath, serialized);
   renameSync(tmpPath, outputPath);
   const modelCount = manifest.models?.length ?? 0;
+  const enumCount = manifest.enums == null ? 0 : Object.keys(manifest.enums).length;
   const authCount = manifest.auth?.claims.length ?? 0;
-  console.log(`[wrote] ${relative2(WORKSPACE_ROOT, outputPath)} \u2014 ${Object.keys(manifest.tools).length} tools, ${modelCount} models, ${authCount} auth claims`);
+  console.log(`[wrote] ${relative2(WORKSPACE_ROOT, outputPath)} \u2014 ${Object.keys(manifest.tools).length} tools, ${modelCount} models, ${enumCount} enums, ${authCount} auth claims`);
 }
 async function maybeLoadAuth(flags) {
   if (flags.app == null || flags.claimsInputs.length === 0) {
@@ -1342,7 +1345,10 @@ async function loadManifest(path) {
   const namedModel = Object.entries(loaded).find(([key]) => key.endsWith("_MODEL_MANIFEST"));
   const modelManifestValue = namedModel?.[1];
   const modelManifest = Array.isArray(modelManifestValue) ? modelManifestValue : void 0;
-  return { apiManifest, modelManifest };
+  const namedEnum = Object.entries(loaded).find(([key]) => key.endsWith("_ENUM_MANIFEST"));
+  const enumManifestValue = namedEnum?.[1];
+  const enumManifest = enumManifestValue != null && typeof enumManifestValue === "object" && !Array.isArray(enumManifestValue) ? enumManifestValue : void 0;
+  return { apiManifest, modelManifest, enumManifest };
 }
 function loadTsconfigPathAliases() {
   const tsconfigPath = resolve(WORKSPACE_ROOT, "tsconfig.base.json");