@dereekb/dbx-components-mcp 14.5.1 → 14.6.0

package/dbx-components-mcp.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 // packages/dbx-components-mcp/package.json
 var package_default = {
   name: "@dereekb/dbx-components-mcp",
-  version: "14.5.1",
+  version: "14.6.0",
   sideEffects: false,
   type: "module",
   bin: {
@@ -22,8 +22,8 @@ var package_default = {
     "ts-morph": "^21.0.0"
   },
   peerDependencies: {
-    "@dereekb/dbx-cli": "14.5.1",
-    "@dereekb/util": "14.5.1"
+    "@dereekb/dbx-cli": "14.6.0",
+    "@dereekb/util": "14.6.0"
   }
 };
 
@@ -2337,6 +2337,10 @@ var FIREBASE_MODELS = [
     description: "Root notification container for a model. The document ID is the two-way flat key of the model it represents (see {@link notificationBoxIdForModel} in `notification.id.ts`).",
     modelGroup: "Notification",
     collectionKind: "root",
+    compositeKey: {
+      from: "*",
+      encoding: "two-way"
+    },
     archetypes: ["composite-key-root"]
   },
   {
@@ -2417,6 +2421,10 @@ var FIREBASE_MODELS = [
     description: "Aggregated notification feed for a specific model. Holds embedded {@link NotificationItem} entries that summarize recent notifications, similar to an activity feed.",
     modelGroup: "Notification",
     collectionKind: "root",
+    compositeKey: {
+      from: "*",
+      encoding: "two-way"
+    },
     archetypes: ["root-singleton-aggregate", "composite-key-root"]
   },
   {
@@ -29467,6 +29475,7 @@ var SERVICE_FACTORY_TAG = "dbxModelServiceFactory";
 var MCP_TOOL_NAME_SEGMENT_TAG = "dbxModelMcpToolNameSegment";
 var MODEL_TYPE_VALUE_PATTERN2 = /^[a-z][A-Za-z0-9_$]*$/;
 var TOOL_NAME_SEGMENT_PATTERN = /^[A-Za-z][A-Za-z0-9_$]*$/;
+var COMPOSITE_KEY_MODEL_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_$]*$/;
 var IDENTITY_FN = "firestoreModelIdentity";
 var IDENTITY_TYPE = "FirestoreModelIdentity";
 var ROOT_IDENTITY_TYPE = "RootFirestoreModelIdentity";
@@ -29583,6 +29592,7 @@ function buildInterface2(decl) {
   const dbxModelRead = readDbxModelReadTag(jsDocs);
   const dbxModelServerOnly = jsDocsHaveTag(jsDocs, "dbxModelServerOnly");
   const mcpToolNameSegment = readMcpToolNameSegmentTag(jsDocs);
+  const compositeKey2 = readDbxModelCompositeKeyTag2(jsDocs);
   const extendsNames = decl.getExtends().map(resolveExtendsName);
   const props = [];
   for (const prop of decl.getProperties()) {
@@ -29608,7 +29618,8 @@ function buildInterface2(decl) {
     props,
     ...dbxModelRead === void 0 ? {} : { dbxModelRead },
     ...dbxModelServerOnly ? { dbxModelServerOnly: true } : {},
-    ...mcpToolNameSegment === void 0 ? {} : { mcpToolNameSegment }
+    ...mcpToolNameSegment === void 0 ? {} : { mcpToolNameSegment },
+    ...compositeKey2 === void 0 ? {} : { compositeKey: compositeKey2 }
   };
 }
 function readMcpToolNameSegmentTag(jsDocs) {
@@ -29643,6 +29654,43 @@ function readDbxModelReadTag(jsDocs) {
   }
   return result;
 }
+function readDbxModelCompositeKeyTag2(jsDocs) {
+  let result;
+  for (const doc of jsDocs) {
+    for (const tag of doc.getTags()) {
+      if (tag.getTagName() !== "dbxModelCompositeKey") continue;
+      if (result !== void 0) continue;
+      result = parseCompositeKeyTagValue2(tag.getCommentText() ?? "");
+    }
+  }
+  return result;
+}
+function parseCompositeKeyTagValue2(raw) {
+  let from;
+  let encoding;
+  for (const token of raw.trim().split(/\s+/)) {
+    const eq = token.indexOf("=");
+    if (eq <= 0) continue;
+    const key = token.slice(0, eq);
+    const value = token.slice(eq + 1);
+    if (key === "from") {
+      from = parseCompositeKeyFromValue3(value);
+    } else if (key === "encoding" && (value === "one-way" || value === "two-way")) {
+      encoding = value;
+    }
+  }
+  return from !== void 0 && encoding !== void 0 ? { from, encoding } : void 0;
+}
+function parseCompositeKeyFromValue3(value) {
+  let result;
+  if (value === "*") {
+    result = "*";
+  } else {
+    const names = value.split(",").map((x) => x.trim()).filter((x) => COMPOSITE_KEY_MODEL_NAME_PATTERN.test(x));
+    result = names.length > 0 ? names : void 0;
+  }
+  return result;
+}
 function readServiceFactories(sourceFile) {
   const out = [];
   for (const statement of sourceFile.getVariableStatements()) {
@@ -40781,7 +40829,7 @@ var DBX_MODEL_DECODE_TOOL = {
     "",
     'Document mode \u2014 pass `data` as a JSON string (copied straight from the Firestore console) or an already-parsed object to identify the model, expand abbreviated field names, decode enum integer values, and surface foreign-key relationships. Optionally pass `model` to skip detection and target a specific model by interface name (`"StorageFile"`), identity constant (`"storageFileIdentity"`), `modelType` (`"storageFile"`), or collection prefix (`"sf"`).',
     "",
-    'Key mode \u2014 pass just `key` (e.g. `"jwr/hkzQa9W6MpaP99RTlQJcImbWdZm2"`) to resolve the model identity and id from the collection prefix alone, no document required. Subcollection paths like `"nb/abc/nbn/def"` are walked end-to-end so the leaf model is reported alongside its parent chain.',
+    'Key mode \u2014 pass just `key` (e.g. `"jwr/hkzQa9W6MpaP99RTlQJcImbWdZm2"`) to resolve the model identity and id from the collection prefix alone, no document required. Subcollection paths like `"nb/abc/nbn/def"` are walked end-to-end so the leaf model is reported alongside its parent chain. Composite-key models derived from the key (`@dbxModelCompositeKey from=\u2026`) are listed with their ready-to-use flattened keys, and a two-way composite-key leaf reports the source key recovered from its id.',
     "",
     "At least one of `data` or `key` is required."
   ].join("\n"),
@@ -40905,6 +40953,29 @@ function buildPrefixMap() {
   }
   return out;
 }
+function findDerivedCompositeKeys(rawKey, leafModel) {
+  const out = [];
+  for (const model of FIREBASE_MODELS) {
+    const compositeKey2 = model.compositeKey;
+    if (!compositeKey2 || model.modelType === leafModel.modelType) continue;
+    const matches = compositeKey2.from === "*" || compositeKey2.from.some((name) => name === leafModel.name || name === leafModel.identityConst || name === leafModel.modelType);
+    if (!matches) continue;
+    const flatId = compositeKey2.encoding === "two-way" ? rawKey.replaceAll("/", "_") : rawKey.replaceAll("/", "");
+    out.push({ key: `${model.collectionPrefix}/${flatId}`, model, encoding: compositeKey2.encoding });
+  }
+  return out;
+}
+function decodeCompositeSource(leaf) {
+  let result;
+  if (leaf.model?.compositeKey?.encoding === "two-way" && leaf.id.includes("_")) {
+    const sourceKey = leaf.id.replaceAll("_", "/");
+    const decoded = decodeKeyPath(sourceKey, void 0);
+    if (!("error" in decoded)) {
+      result = { key: sourceKey, path: decoded };
+    }
+  }
+  return result;
+}
 function decodeKeyPath(key, hint) {
   const trimmed = key.trim();
   if (trimmed.length === 0) {
@@ -40971,8 +41042,24 @@ function formatUnresolved(unresolvedPrefixes) {
   const list = unresolvedPrefixes.map((p) => `\`${p}\``).join(", ");
   return ["", `_Unresolved ${label}: ${list}. Run \`dbx_model_lookup\` to browse known models._`];
 }
+function formatCompositeSource(source) {
+  if (!source) return [];
+  const sourceModel = source.path.leaf.model ? source.path.leaf.model.name : `_unknown_ (prefix \`${source.path.leaf.prefix}\`)`;
+  return ["", `**Composite source (two-way):** \`${source.key}\` \u2192 ${sourceModel}`];
+}
+function formatDerivedKeys(derived) {
+  if (derived.length === 0) return [];
+  const out = ["", "**Derived keys:**"];
+  for (const entry of derived) {
+    out.push(`- ${entry.model.name} (${entry.encoding}) \u2014 \`${entry.key}\``);
+  }
+  return out;
+}
 function formatKeyDecode(input, rawKey) {
-  const lines = ["_Model decoded from key prefix._", "", ...formatLeaf(input.leaf), ...formatAncestors(input.ancestors), ...formatUnresolved(input.unresolvedPrefixes), "", `_Key:_ \`${rawKey}\``];
+  const trimmedKey = rawKey.trim();
+  const derived = input.leaf.model ? findDerivedCompositeKeys(trimmedKey, input.leaf.model) : [];
+  const compositeSource = decodeCompositeSource(input.leaf);
+  const lines = ["_Model decoded from key prefix._", "", ...formatLeaf(input.leaf), ...formatAncestors(input.ancestors), ...formatUnresolved(input.unresolvedPrefixes), ...formatCompositeSource(compositeSource), ...formatDerivedKeys(derived), "", `_Key:_ \`${rawKey}\``];
   return lines.join("\n");
 }
 function runModelDecode(rawArgs) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "14.5.1",
+  "version": "14.6.0",
   "sideEffects": false,
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "ts-morph": "^21.0.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "14.5.1",
-    "@dereekb/util": "14.5.1"
+    "@dereekb/dbx-cli": "14.6.0",
+    "@dereekb/util": "14.6.0"
   }
 }