@dereekb/dbx-cli 13.37.0 → 13.39.0

package/eslint/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@dereekb/dbx-cli/eslint",
-  "version": "13.37.0",
+  "version": "13.39.0",
+  "type": "module",
   "peerDependencies": {
-    "@dereekb/dbx-cli": "13.37.0",
-    "@dereekb/util": "13.37.0",
+    "@dereekb/dbx-cli": "13.39.0",
+    "@dereekb/util": "13.39.0",
     "@typescript-eslint/utils": "8.59.3",
     "typescript": "5.9.3"
   },
@@ -14,13 +15,12 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "module": "./index.esm.js",
       "types": "./index.d.ts",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
+      "import": "./index.esm.js",
+      "default": "./index.esm.js"
     }
   },
   "module": "./index.esm.js",
-  "main": "./index.cjs.js",
+  "main": "./index.esm.js",
   "types": "./index.d.ts"
-}
+}

package/firebase-api-manifest/main.js

@@ -3,15 +3,56 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/main.ts
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync6, writeFileSync } from "node:fs";
-import { dirname as dirname3, isAbsolute as isAbsolute3, relative as relative2, resolve as resolve3 } from "node:path";
+import { existsSync as existsSync4 } from "node:fs";
+import { isAbsolute as isAbsolute3, relative as relative2, resolve as resolve3 } from "node:path";
+
+// packages/util/src/lib/string/sort.ts
+var compareStrings = (a, b) => a.localeCompare(b);
+
+// packages/dbx-cli/src/lib/scan-helpers/emit-generated-ts.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { format, resolveConfig } from "prettier";
+// @__NO_SIDE_EFFECTS__
+function renderGroupedImportLines(imports) {
+  const importsByPackage = /* @__PURE__ */ new Map();
+  for (const { packageName, identifier } of imports) {
+    if (!packageName || !identifier) continue;
+    const set = importsByPackage.get(packageName) ?? /* @__PURE__ */ new Set();
+    set.add(identifier);
+    importsByPackage.set(packageName, set);
+  }
+  return [...importsByPackage.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([pkg, names]) => {
+    const sortedNames = [...names].sort(compareStrings).join(", ");
+    return `import { ${sortedNames} } from '${pkg}';`;
+  });
+}
+async function formatGeneratedTs(source, outputFile) {
+  const config = await resolveConfig(outputFile);
+  return format(source, { ...config, filepath: outputFile });
+}
+function writeGeneratedTsFile(input) {
+  const { outputFile, contents } = input;
+  const outputDir = dirname(outputFile);
+  let result;
+  if (!existsSync(outputDir)) {
+    mkdirSync(outputDir, { recursive: true });
+  }
+  if (existsSync(outputFile) && readFileSync(outputFile, "utf8") === contents) {
+    result = "unchanged";
+  } else {
+    writeFileSync(outputFile, contents);
+    result = "wrote";
+  }
+  return result;
+}
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/parse-functions.ts
-import { readFileSync } from "node:fs";
+import { readFileSync as readFileSync2 } from "node:fs";
 import { Node, Project } from "ts-morph";
 function parseFunctionsConfig(functionsTsPath) {
   const project = new Project({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
-  const text = readFileSync(functionsTsPath, "utf8");
+  const text = readFileSync2(functionsTsPath, "utf8");
   const sourceFile = project.createSourceFile("functions.ts", text, { overwrite: true });
   const importIdentToModule = collectImportSpecifierMap(sourceFile);
   const result = [];
@@ -69,8 +110,8 @@ function collectImportSpecifierMap(sourceFile) {
 }
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/resolve-package.ts
-import { existsSync, readFileSync as readFileSync2 } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "node:fs";
+import { dirname as dirname2, isAbsolute, join, relative, resolve } from "node:path";
 var _pathsCache;
 function loadTsconfigPaths(workspaceRoot) {
   let result;
@@ -78,7 +119,7 @@ function loadTsconfigPaths(workspaceRoot) {
     result = _pathsCache;
   } else {
     const tsconfigPath = join(workspaceRoot, "tsconfig.base.json");
-    const raw = readFileSync2(tsconfigPath, "utf8");
+    const raw = readFileSync3(tsconfigPath, "utf8");
     const cleaned = stripJsonComments(raw);
     const tsconfig = JSON.parse(cleaned);
     const paths = tsconfig.compilerOptions?.paths ?? {};
@@ -97,7 +138,7 @@ function resolveModuleToPackage(input) {
   const { workspaceRoot, importingFile, moduleSpecifier } = input;
   let result;
   if (moduleSpecifier.startsWith(".")) {
-    const importingDir = dirname(importingFile);
+    const importingDir = dirname2(importingFile);
     const candidatePath = resolve(importingDir, moduleSpecifier);
     result = locatePackageForPath(workspaceRoot, candidatePath);
   } else {
@@ -113,38 +154,38 @@ function resolveModuleToPackage(input) {
 }
 function locatePackageInNodeModules(input) {
   const { importingFile, moduleSpecifier } = input;
-  let current = dirname(importingFile);
+  let current = dirname2(importingFile);
   let result;
-  while (!result && current && current !== dirname(current)) {
+  while (!result && current && current !== dirname2(current)) {
     const candidateRoot = join(current, "node_modules", moduleSpecifier);
     const pkgJson = join(candidateRoot, "package.json");
-    if (existsSync(pkgJson)) {
+    if (existsSync2(pkgJson)) {
       try {
-        const pkg = JSON.parse(readFileSync2(pkgJson, "utf8"));
+        const pkg = JSON.parse(readFileSync3(pkgJson, "utf8"));
         if (pkg.name) {
           result = { packageName: pkg.name, packageRoot: candidateRoot };
         }
       } catch {
       }
     }
-    if (!result) current = dirname(current);
+    if (!result) current = dirname2(current);
   }
   return result;
 }
 function locatePackageForPath(workspaceRoot, startPath) {
   let current = startPath;
   let result;
-  while (!result && current && current !== workspaceRoot && current !== dirname(current)) {
-    if (existsSync(join(current, "package.json"))) {
+  while (!result && current && current !== workspaceRoot && current !== dirname2(current)) {
+    if (existsSync2(join(current, "package.json"))) {
       try {
-        const pkg = JSON.parse(readFileSync2(join(current, "package.json"), "utf8"));
+        const pkg = JSON.parse(readFileSync3(join(current, "package.json"), "utf8"));
         if (pkg.name) {
           result = { packageName: pkg.name, packageRoot: current };
         }
       } catch {
       }
     }
-    if (!result) current = dirname(current);
+    if (!result) current = dirname2(current);
   }
   return result;
 }
@@ -156,8 +197,8 @@ function stripJsonComments(text) {
 }
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/find-api-files.ts
-import { readdirSync, readFileSync as readFileSync3, statSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { readdirSync, readFileSync as readFileSync5, statSync as statSync2 } from "node:fs";
+import { join as join3 } from "node:path";
 
 // packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts
 import { Node as Node2, Project as Project2 } from "ts-morph";
@@ -469,9 +510,6 @@ 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"]);
@@ -548,6 +586,114 @@ function identifierName(node) {
   return result;
 }
 
+// packages/dbx-cli/src/lib/scan-helpers/exported-from-package.ts
+import { existsSync as existsSync3, readFileSync as readFileSync4, statSync } from "node:fs";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "node:path";
+function isExportedFromPackage(input) {
+  const { packageRoot, identifier } = input;
+  const indexPath = locateBarrelEntry(packageRoot);
+  return indexPath ? findIdentifierInBarrelChain(indexPath, identifier, /* @__PURE__ */ new Set()) : false;
+}
+function locateBarrelEntry(packageRoot) {
+  const candidates = [join2(packageRoot, "src", "index.ts"), join2(packageRoot, "src", "index.d.ts"), join2(packageRoot, "index.d.ts"), join2(packageRoot, "index.ts")];
+  return candidates.find((candidate) => existsSync3(candidate));
+}
+var EXPORT_DECL_PATTERNS = [/export\s+(?:declare\s+)?const\s+IDENT\b/, /export\s+(?:declare\s+)?function\s+IDENT\b/, /export\s*\{[^}]*\bIDENT\b[^}]*\}/];
+function findIdentifierInBarrelChain(filePath, identifier, visited) {
+  let result = false;
+  if (!visited.has(filePath)) {
+    visited.add(filePath);
+    const text = readFileTextSafe(filePath);
+    if (text !== void 0) {
+      result = barrelTextDeclaresIdentifier(text, identifier) || reExportChainHasIdentifier({ fromFile: filePath, text, identifier, visited });
+    }
+  }
+  return result;
+}
+function readFileTextSafe(filePath) {
+  let text;
+  try {
+    text = readFileSync4(filePath, "utf8");
+  } catch {
+    text = void 0;
+  }
+  return text;
+}
+function barrelTextDeclaresIdentifier(text, identifier) {
+  let result = false;
+  for (const pattern of EXPORT_DECL_PATTERNS) {
+    const re = new RegExp(pattern.source.replace("IDENT", escapeRegExp(identifier)));
+    if (re.test(text)) {
+      result = true;
+      break;
+    }
+  }
+  return result;
+}
+function reExportChainHasIdentifier(input) {
+  const { fromFile, text, identifier, visited } = input;
+  let result = false;
+  const dir = dirname3(fromFile);
+  for (const reExportTarget of collectReExportTargets(text)) {
+    const resolved = resolveReExport(dir, reExportTarget);
+    if (resolved && findIdentifierInBarrelChain(resolved, identifier, visited)) {
+      result = true;
+      break;
+    }
+  }
+  return result;
+}
+function collectReExportTargets(text) {
+  const out = [];
+  const re = /export\s*(?:\*|\{[^}]*\})\s*from\s*['"]([^'"]+)['"]/g;
+  let match;
+  while ((match = re.exec(text)) !== null) {
+    out.push(match[1]);
+  }
+  return out;
+}
+function resolveReExport(fromDir, target) {
+  let result;
+  if (target.startsWith(".")) {
+    const candidate = isAbsolute2(target) ? target : resolve2(fromDir, target);
+    for (const ext of [".ts", ".mts", ".d.ts", "/index.ts", "/index.mts", "/index.d.ts"]) {
+      const probe = hasTsModuleExtension(candidate) ? candidate : candidate + ext;
+      const resolved = resolveExistingTsPath(probe);
+      if (resolved) {
+        result = resolved;
+        break;
+      }
+    }
+  }
+  return result;
+}
+function hasTsModuleExtension(value) {
+  return value.endsWith(".ts") || value.endsWith(".mts");
+}
+function resolveExistingTsPath(probe) {
+  let result;
+  if (existsSync3(probe)) {
+    const stat = statSync(probe);
+    if (stat.isFile()) {
+      result = probe;
+    } else if (stat.isDirectory()) {
+      const sourceIndex = join2(probe, "index.ts");
+      if (existsSync3(sourceIndex)) {
+        result = sourceIndex;
+      } else {
+        const declarationIndex = join2(probe, "index.d.ts");
+        if (existsSync3(declarationIndex)) {
+          result = declarationIndex;
+        }
+      }
+    }
+  }
+  return result;
+}
+function escapeRegExp(value) {
+  return value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+}
+
 // packages/dbx-cli/manifest-extract/src/lib/extract-models.ts
 import { Node as Node4, Project as Project3 } from "ts-morph";
 var READ_LEVEL_VALUES = /* @__PURE__ */ new Set(["system", "owner", "admin-only", "permissions"]);
@@ -602,6 +748,7 @@ function buildInterface(decl) {
   const jsDocs = decl.getJsDocs();
   const hasDbxModelTag = jsDocsHaveTag(jsDocs, "dbxModel");
   const dbxModelRead = readDbxModelReadTag(jsDocs);
+  const dbxModelServerOnly = jsDocsHaveTag(jsDocs, "dbxModelServerOnly");
   const mcpToolNameSegment = readMcpToolNameSegmentTag(jsDocs);
   const extendsNames = decl.getExtends().map(resolveExtendsName);
   const props = [];
@@ -627,6 +774,7 @@ function buildInterface(decl) {
     extendsNames,
     props,
     ...dbxModelRead === void 0 ? {} : { dbxModelRead },
+    ...dbxModelServerOnly ? { dbxModelServerOnly: true } : {},
     ...mcpToolNameSegment === void 0 ? {} : { mcpToolNameSegment }
   };
 }
@@ -934,12 +1082,12 @@ function firstParagraph(text) {
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/find-api-files.ts
 function findApiFiles(packageRoot) {
-  const libRoot = join2(packageRoot, "src", "lib");
+  const libRoot = join3(packageRoot, "src", "lib");
   const out = [];
   if (safeIsDirectory(libRoot)) {
     const seenClassNames = /* @__PURE__ */ new Set();
     for (const file of walkApiFiles(libRoot)) {
-      const text = readFileSync3(file, "utf8");
+      const text = readFileSync5(file, "utf8");
       const extraction = extractCrudEntries({ name: file, text });
       if (!extraction.functionsClassName) continue;
       if (seenClassNames.has(extraction.functionsClassName)) continue;
@@ -952,8 +1100,8 @@ function findApiFiles(packageRoot) {
 function* walkApiFiles(dir) {
   for (const entry of readdirSync(dir).sort()) {
     if (entry === "node_modules" || entry === "dist") continue;
-    const p = join2(dir, entry);
-    const stat = statSync(p);
+    const p = join3(dir, entry);
+    const stat = statSync2(p);
     if (stat.isDirectory()) {
       yield* walkApiFiles(p);
     } else if (isApiFile(entry)) {
@@ -968,7 +1116,7 @@ function isApiFile(name) {
 function safeIsDirectory(p) {
   let result;
   try {
-    result = statSync(p).isDirectory();
+    result = statSync2(p).isDirectory();
   } catch {
     result = false;
   }
@@ -976,14 +1124,14 @@ function safeIsDirectory(p) {
 }
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/find-model-files.ts
-import { readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync2 } from "node:fs";
-import { join as join3 } from "node:path";
+import { readdirSync as readdirSync2, readFileSync as readFileSync6, statSync as statSync3 } from "node:fs";
+import { join as join4 } from "node:path";
 function findModelFiles(packageRoot) {
-  const libRoot = join3(packageRoot, "src", "lib");
+  const libRoot = join4(packageRoot, "src", "lib");
   const out = [];
   if (safeIsDirectory2(libRoot)) {
     for (const filePath of walkSourceFiles(libRoot)) {
-      const text = readFileSync4(filePath, "utf8");
+      const text = readFileSync6(filePath, "utf8");
       if (!textHasModelMarker(text)) continue;
       const extraction = extractModelsFromSource({ name: filePath, text });
       if (extraction.identities.length === 0 && extraction.modelGroups.length === 0 && extraction.converters.length === 0 && extraction.serviceFactories.length === 0) continue;
@@ -998,8 +1146,8 @@ function textHasModelMarker(text) {
 function* walkSourceFiles(dir) {
   for (const entry of readdirSync2(dir).sort()) {
     if (entry === "node_modules" || entry === "dist") continue;
-    const p = join3(dir, entry);
-    const stat = statSync2(p);
+    const p = join4(dir, entry);
+    const stat = statSync3(p);
     if (stat.isDirectory()) {
       yield* walkSourceFiles(p);
     } else if (isCandidateSourceFile(entry)) {
@@ -1013,7 +1161,7 @@ function isCandidateSourceFile(name) {
 function safeIsDirectory2(p) {
   let result;
   try {
-    result = statSync2(p).isDirectory();
+    result = statSync3(p).isDirectory();
   } catch {
     result = false;
   }
@@ -1162,6 +1310,7 @@ function buildManifestEntry(input) {
     fields,
     ...iface.mcpToolNameSegment ? { mcpToolNameSegment: iface.mcpToolNameSegment } : {},
     ...iface.dbxModelRead ? { read: iface.dbxModelRead } : {},
+    ...iface.dbxModelServerOnly ? { serverOnly: true } : {},
     ...serviceFactory ? { serviceFactory } : {}
   };
 }
@@ -1298,131 +1447,19 @@ function capitalize(s) {
 }
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/bind-validators.ts
-import { existsSync as existsSync2, readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync3 } from "node:fs";
-import { dirname as dirname2, isAbsolute as isAbsolute2, join as join4, resolve as resolve2 } from "node:path";
 function deriveValidatorName(paramsTypeName) {
   return paramsTypeName ? paramsTypeName.charAt(0).toLowerCase() + paramsTypeName.slice(1) + "Type" : "";
 }
-function isExportedFromPackage(input) {
-  const { packageRoot, identifier } = input;
-  const indexPath = locateBarrelEntry(packageRoot);
-  return indexPath ? findIdentifierInBarrelChain(indexPath, identifier, /* @__PURE__ */ new Set()) : false;
-}
-function locateBarrelEntry(packageRoot) {
-  const candidates = [join4(packageRoot, "src", "index.ts"), join4(packageRoot, "src", "index.d.ts"), join4(packageRoot, "index.d.ts"), join4(packageRoot, "index.ts")];
-  return candidates.find((candidate) => existsSync2(candidate));
-}
-var EXPORT_DECL_PATTERNS = [/export\s+(?:declare\s+)?const\s+IDENT\b/, /export\s+(?:declare\s+)?function\s+IDENT\b/, /export\s*\{[^}]*\bIDENT\b[^}]*\}/];
-function findIdentifierInBarrelChain(filePath, identifier, visited) {
-  let result = false;
-  if (!visited.has(filePath)) {
-    visited.add(filePath);
-    const text = readFileTextSafe(filePath);
-    if (text !== void 0) {
-      result = barrelTextDeclaresIdentifier(text, identifier) || reExportChainHasIdentifier({ fromFile: filePath, text, identifier, visited });
-    }
-  }
-  return result;
-}
-function readFileTextSafe(filePath) {
-  let text;
-  try {
-    text = readFileSync5(filePath, "utf8");
-  } catch {
-    text = void 0;
-  }
-  return text;
-}
-function barrelTextDeclaresIdentifier(text, identifier) {
-  let result = false;
-  for (const pattern of EXPORT_DECL_PATTERNS) {
-    const re = new RegExp(pattern.source.replace("IDENT", escapeRegExp(identifier)));
-    if (re.test(text)) {
-      result = true;
-      break;
-    }
-  }
-  return result;
-}
-function reExportChainHasIdentifier(input) {
-  const { fromFile, text, identifier, visited } = input;
-  let result = false;
-  const dir = dirname2(fromFile);
-  for (const reExportTarget of collectReExportTargets(text)) {
-    const resolved = resolveReExport(dir, reExportTarget);
-    if (resolved && findIdentifierInBarrelChain(resolved, identifier, visited)) {
-      result = true;
-      break;
-    }
-  }
-  return result;
-}
-function collectReExportTargets(text) {
-  const out = [];
-  const re = /export\s*(?:\*|\{[^}]*\})\s*from\s*['"]([^'"]+)['"]/g;
-  let match;
-  while ((match = re.exec(text)) !== null) {
-    out.push(match[1]);
-  }
-  return out;
-}
-function resolveReExport(fromDir, target) {
-  let result;
-  if (target.startsWith(".")) {
-    const candidate = isAbsolute2(target) ? target : resolve2(fromDir, target);
-    for (const ext of [".ts", ".mts", ".d.ts", "/index.ts", "/index.mts", "/index.d.ts"]) {
-      const probe = hasTsModuleExtension(candidate) ? candidate : candidate + ext;
-      const resolved = resolveExistingTsPath(probe);
-      if (resolved) {
-        result = resolved;
-        break;
-      }
-    }
-  }
-  return result;
-}
-function hasTsModuleExtension(value) {
-  return value.endsWith(".ts") || value.endsWith(".mts");
-}
-function resolveExistingTsPath(probe) {
-  let result;
-  if (existsSync2(probe)) {
-    const stat = statSync3(probe);
-    if (stat.isFile()) {
-      result = probe;
-    } else if (stat.isDirectory()) {
-      const sourceIndex = join4(probe, "index.ts");
-      if (existsSync2(sourceIndex)) {
-        result = sourceIndex;
-      } else {
-        const declarationIndex = join4(probe, "index.d.ts");
-        if (existsSync2(declarationIndex)) {
-          result = declarationIndex;
-        }
-      }
-    }
-  }
-  return result;
-}
-function escapeRegExp(value) {
-  return value.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
-}
 
 // packages/dbx-cli/firebase-api-manifest/src/generate-api-manifest/emit.ts
-import { format, resolveConfig } from "prettier";
 async function renderManifest(input) {
   const { outputFile, entries, projectName, namespace, modelEntries, modelNamespace, enumEntries, enumNamespace, emitConverters = false } = input;
-  const importsByPackage = /* @__PURE__ */ new Map();
+  const validatorImports = [];
   for (const entry of entries) {
     if (!entry.packageName || !entry.validatorName) continue;
-    const set = importsByPackage.get(entry.packageName) ?? /* @__PURE__ */ new Set();
-    set.add(entry.validatorName);
-    importsByPackage.set(entry.packageName, set);
+    validatorImports.push({ packageName: entry.packageName, identifier: entry.validatorName });
   }
-  const importLines = [...importsByPackage.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([pkg, names]) => {
-    const sortedNames = [...names].sort(compareStrings).join(", ");
-    return `import { ${sortedNames} } from '${pkg}';`;
-  });
+  const importLines = renderGroupedImportLines(validatorImports);
   const entryLines = entries.map((e) => renderEntry(e));
   const emitModels = Boolean(modelEntries && modelEntries.length > 0 && modelNamespace);
   const emitEnums = Boolean(enumEntries && Object.keys(enumEntries).length > 0 && enumNamespace);
@@ -1449,7 +1486,7 @@ export const ${namespace}: CliApiManifest = [
 ${entryLines.join(",\n")}
 ];${modelSection}${enumSection}
 `;
-  return formatWithPrettier(source, outputFile);
+  return formatGeneratedTs(source, outputFile);
 }
 function renderEntry({ entry, validatorName }) {
   const fields = [
@@ -1480,10 +1517,6 @@ function renderDocFields(fields) {
   });
   return `[${items.join(", ")}]`;
 }
-async function formatWithPrettier(source, outputFile) {
-  const config = await resolveConfig(outputFile);
-  return format(source, { ...config, filepath: outputFile });
-}
 function renderModelEntry(entry, emitConverters) {
   const fields = [
     `modelType: ${JSON.stringify(entry.modelType)}`,
@@ -1498,6 +1531,7 @@ function renderModelEntry(entry, emitConverters) {
     `fields: ${renderModelFields(entry.fields, emitConverters)}`,
     entry.mcpToolNameSegment ? `mcpToolNameSegment: ${JSON.stringify(entry.mcpToolNameSegment)}` : void 0,
     entry.read ? `read: ${JSON.stringify(entry.read)}` : void 0,
+    entry.serverOnly ? "serverOnly: true" : void 0,
     entry.serviceFactory ? `serviceFactory: { exportName: ${JSON.stringify(entry.serviceFactory.exportName)}, sourceFile: ${JSON.stringify(entry.serviceFactory.sourceFile)} }` : void 0
   ];
   return `  { ${fields.filter(Boolean).join(", ")} }`;
@@ -1556,10 +1590,9 @@ async function main() {
   }
   const functionsConfigPath = resolveWorkspacePath(flags.functionsConfig);
   const outputFile = resolveWorkspacePath(flags.output);
-  const outputDir = dirname3(outputFile);
   const projectName = flags.project ?? "<cli>";
   const namespace = deriveNamespace(flags.project);
-  if (!existsSync3(functionsConfigPath)) {
+  if (!existsSync4(functionsConfigPath)) {
     throw new Error(`functions-config file not found: ${functionsConfigPath}`);
   }
   const groups = parseFunctionsConfig(functionsConfigPath);
@@ -1637,14 +1670,9 @@ async function main() {
   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), enumEntries, enumNamespace: deriveEnumNamespace(flags.project), emitConverters: flags.emitModelConverters });
-  if (existsSync3(outputFile) && readFileSync6(outputFile, "utf8") === formatted) {
-    console.log(`[unchanged] ${relative2(WORKSPACE_ROOT, outputFile)}`);
-  } else {
-    writeFileSync(outputFile, formatted);
-    console.log(`[wrote] ${relative2(WORKSPACE_ROOT, outputFile)}`);
-  }
+  const outcome = writeGeneratedTsFile({ outputFile, contents: formatted });
+  console.log(`[${outcome}] ${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 \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}`);
@@ -1664,9 +1692,6 @@ function compareEntries(a, b) {
   }
   return result;
 }
-function ensureOutputDir(outputDir) {
-  if (!existsSync3(outputDir)) mkdirSync(outputDir, { recursive: true });
-}
 function resolveWorkspacePath(value) {
   return isAbsolute3(value) ? value : resolve3(WORKSPACE_ROOT, value);
 }

package/firebase-api-manifest/package.json

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