@dereekb/dbx-cli 13.11.17 → 13.12.0

package/lint-cache/main.js

@@ -495,30 +495,30 @@ function runQuery(cachePath, filters) {
     throw new Error(`lint cache not found: ${cachePath} \u2014 run \`build\` first`);
   }
   const cache = JSON.parse(readFileSync4(cachePath, "utf8"));
-  const ruleSet = filters.rule && filters.rule.length > 0 ? new Set(filters.rule) : null;
-  const fileNeedle = filters.file && filters.file.length > 0 ? filters.file : null;
-  const fileMatcher = fileNeedle && isGlobPattern(fileNeedle) ? globToRegExp2(fileNeedle) : null;
-  const messageNeedle = filters.message && filters.message.length > 0 ? filters.message.toLowerCase() : null;
-  const severity = filters.severity;
-  const matched = [];
-  for (const m of cache.messages) {
-    if (ruleSet && (m.ruleId == null || !ruleSet.has(m.ruleId))) continue;
-    if (severity && m.severity !== severity) continue;
-    if (fileNeedle) {
-      if (fileMatcher) {
-        if (!fileMatcher.test(m.filePath)) continue;
-      } else if (!m.filePath.includes(fileNeedle)) {
-        continue;
-      }
-    }
-    if (messageNeedle && !m.message.toLowerCase().includes(messageNeedle)) continue;
-    matched.push(m);
-  }
+  const compiled = compileFilters(filters);
+  const matched = cache.messages.filter((m) => matchesFilters(m, compiled));
   const totalMatched = matched.length;
   const truncated = filters.limit != null && totalMatched > filters.limit;
   const limited = filters.limit == null ? matched : matched.slice(0, filters.limit);
   return { cache, matched: limited, totalMatched, truncated };
 }
+function compileFilters(filters) {
+  const ruleSet = filters.rule && filters.rule.length > 0 ? new Set(filters.rule) : null;
+  const fileNeedle = filters.file && filters.file.length > 0 ? filters.file : null;
+  const fileMatcher = fileNeedle && isGlobPattern(fileNeedle) ? globToRegExp2(fileNeedle) : null;
+  const messageNeedle = filters.message && filters.message.length > 0 ? filters.message.toLowerCase() : null;
+  return { ruleSet, severity: filters.severity ?? void 0, fileNeedle, fileMatcher, messageNeedle };
+}
+function matchesFilters(m, c) {
+  if (c.ruleSet && (m.ruleId == null || !c.ruleSet.has(m.ruleId))) return false;
+  if (c.severity && m.severity !== c.severity) return false;
+  if (c.fileNeedle && !matchesFile(m.filePath, c.fileNeedle, c.fileMatcher)) return false;
+  if (c.messageNeedle && !m.message.toLowerCase().includes(c.messageNeedle)) return false;
+  return true;
+}
+function matchesFile(filePath, needle, matcher) {
+  return matcher ? matcher.test(filePath) : filePath.includes(needle);
+}
 function isGlobPattern(s) {
   return s.includes("*") || s.includes("?");
 }

package/lint-cache/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dereekb/dbx-cli-lint-cache",
-  "version": "13.11.17",
+  "version": "13.12.0",
   "private": true,
   "type": "module",
   "devDependencies": {
-    "@dereekb/util": "13.11.17",
+    "@dereekb/util": "13.12.0",
     "eslint": "10.4.0",
     "yargs": "^18.0.0",
     "@types/yargs": "^17.0.35"

package/manifest-extract/index.cjs.js

@@ -7,7 +7,8 @@ var SUPPORTED_VERBS = new Set([
     'read',
     'update',
     'delete',
-    'query'
+    'query',
+    'invoke'
 ]);
 /**
  * Walks a `<model>.api.ts` source and returns one {@link CrudEntry} per
@@ -500,6 +501,14 @@ function _object_spread(target) {
     }
     return target;
 }
+var READ_LEVEL_VALUES = new Set([
+    'system',
+    'owner',
+    'admin-only',
+    'permissions'
+]);
+var SERVICE_FACTORY_TAG = 'dbxModelServiceFactory';
+var MODEL_TYPE_VALUE_PATTERN = /^[a-z][A-Za-z0-9_$]*$/;
 /**
  * TS utility/structural wrappers that don't change the field surface for
  * inheritance walks — `Partial<T>`, `Required<T>`, `Readonly<T>`,
@@ -552,12 +561,14 @@ var OBJECT_FIELD_KEY = 'objectField';
     var converters = readConverters(sourceFile);
     var enums = readEnums(sourceFile);
     var modelGroups = readModelGroups(sourceFile);
+    var serviceFactories = readServiceFactories(sourceFile);
     return {
         identities: identities,
         interfaces: interfaces,
         converters: converters,
         enums: enums,
-        modelGroups: modelGroups
+        modelGroups: modelGroups,
+        serviceFactories: serviceFactories
     };
 }
 function readIdentities(sourceFile) {
@@ -682,6 +693,7 @@ function readInterfaces(sourceFile) {
 function buildInterface(decl) {
     var jsDocs = decl.getJsDocs();
     var hasDbxModelTag = jsDocsHaveTag(jsDocs, 'dbxModel');
+    var dbxModelRead = readDbxModelReadTag(jsDocs);
     var extendsNames = decl.getExtends().map(resolveExtendsName);
     var props = [];
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
@@ -718,13 +730,166 @@ function buildInterface(decl) {
             }
         }
     }
-    return {
+    return _object_spread({
         name: decl.getName(),
         description: readJsDocDescription(jsDocs),
         hasDbxModelTag: hasDbxModelTag,
         extendsNames: extendsNames,
         props: props
-    };
+    }, dbxModelRead === undefined ? {} : {
+        dbxModelRead: dbxModelRead
+    });
+}
+function readDbxModelReadTag(jsDocs) {
+    var result;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = jsDocs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var doc = _step.value;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = doc.getTags()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var tag = _step1.value;
+                    var _tag_getCommentText;
+                    if (tag.getTagName() !== 'dbxModelRead') continue;
+                    if (result !== undefined) continue;
+                    var raw = (_tag_getCommentText = tag.getCommentText()) === null || _tag_getCommentText === void 0 ? void 0 : _tag_getCommentText.trim();
+                    if (raw === undefined || raw.length === 0) continue;
+                    var firstToken = raw.split(/\s+/)[0];
+                    if (READ_LEVEL_VALUES.has(firstToken)) {
+                        result = firstToken;
+                    }
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return result;
+}
+function readServiceFactories(sourceFile) {
+    var out = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = sourceFile.getVariableStatements()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var statement = _step.value;
+            if (!statement.isExported()) continue;
+            var modelType = readServiceFactoryModelType(statement.getJsDocs());
+            if (modelType === undefined) continue;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = statement.getDeclarations()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var decl = _step1.value;
+                    out.push({
+                        modelType: modelType,
+                        exportName: decl.getName()
+                    });
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return out;
+}
+function readServiceFactoryModelType(jsDocs) {
+    var result;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = jsDocs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var doc = _step.value;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = doc.getTags()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var tag = _step1.value;
+                    var _tag_getCommentText;
+                    if (tag.getTagName() !== SERVICE_FACTORY_TAG) continue;
+                    if (result !== undefined) continue;
+                    var raw = (_tag_getCommentText = tag.getCommentText()) === null || _tag_getCommentText === void 0 ? void 0 : _tag_getCommentText.trim();
+                    if (raw === undefined || raw.length === 0) continue;
+                    var firstToken = raw.split(/\s+/)[0];
+                    if (MODEL_TYPE_VALUE_PATTERN.test(firstToken)) {
+                        result = firstToken;
+                    }
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return result;
 }
 /**
  * Resolves an `extends` clause to the concrete ancestor interface name,

package/manifest-extract/index.esm.js

@@ -5,7 +5,8 @@ var SUPPORTED_VERBS = new Set([
     'read',
     'update',
     'delete',
-    'query'
+    'query',
+    'invoke'
 ]);
 /**
  * Walks a `<model>.api.ts` source and returns one {@link CrudEntry} per
@@ -498,6 +499,14 @@ function _object_spread(target) {
     }
     return target;
 }
+var READ_LEVEL_VALUES = new Set([
+    'system',
+    'owner',
+    'admin-only',
+    'permissions'
+]);
+var SERVICE_FACTORY_TAG = 'dbxModelServiceFactory';
+var MODEL_TYPE_VALUE_PATTERN = /^[a-z][A-Za-z0-9_$]*$/;
 /**
  * TS utility/structural wrappers that don't change the field surface for
  * inheritance walks — `Partial<T>`, `Required<T>`, `Readonly<T>`,
@@ -550,12 +559,14 @@ var OBJECT_FIELD_KEY = 'objectField';
     var converters = readConverters(sourceFile);
     var enums = readEnums(sourceFile);
     var modelGroups = readModelGroups(sourceFile);
+    var serviceFactories = readServiceFactories(sourceFile);
     return {
         identities: identities,
         interfaces: interfaces,
         converters: converters,
         enums: enums,
-        modelGroups: modelGroups
+        modelGroups: modelGroups,
+        serviceFactories: serviceFactories
     };
 }
 function readIdentities(sourceFile) {
@@ -680,6 +691,7 @@ function readInterfaces(sourceFile) {
 function buildInterface(decl) {
     var jsDocs = decl.getJsDocs();
     var hasDbxModelTag = jsDocsHaveTag(jsDocs, 'dbxModel');
+    var dbxModelRead = readDbxModelReadTag(jsDocs);
     var extendsNames = decl.getExtends().map(resolveExtendsName);
     var props = [];
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
@@ -716,13 +728,166 @@ function buildInterface(decl) {
             }
         }
     }
-    return {
+    return _object_spread({
         name: decl.getName(),
         description: readJsDocDescription(jsDocs),
         hasDbxModelTag: hasDbxModelTag,
         extendsNames: extendsNames,
         props: props
-    };
+    }, dbxModelRead === undefined ? {} : {
+        dbxModelRead: dbxModelRead
+    });
+}
+function readDbxModelReadTag(jsDocs) {
+    var result;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = jsDocs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var doc = _step.value;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = doc.getTags()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var tag = _step1.value;
+                    var _tag_getCommentText;
+                    if (tag.getTagName() !== 'dbxModelRead') continue;
+                    if (result !== undefined) continue;
+                    var raw = (_tag_getCommentText = tag.getCommentText()) === null || _tag_getCommentText === void 0 ? void 0 : _tag_getCommentText.trim();
+                    if (raw === undefined || raw.length === 0) continue;
+                    var firstToken = raw.split(/\s+/)[0];
+                    if (READ_LEVEL_VALUES.has(firstToken)) {
+                        result = firstToken;
+                    }
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return result;
+}
+function readServiceFactories(sourceFile) {
+    var out = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = sourceFile.getVariableStatements()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var statement = _step.value;
+            if (!statement.isExported()) continue;
+            var modelType = readServiceFactoryModelType(statement.getJsDocs());
+            if (modelType === undefined) continue;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = statement.getDeclarations()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var decl = _step1.value;
+                    out.push({
+                        modelType: modelType,
+                        exportName: decl.getName()
+                    });
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return out;
+}
+function readServiceFactoryModelType(jsDocs) {
+    var result;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = jsDocs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var doc = _step.value;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = doc.getTags()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var tag = _step1.value;
+                    var _tag_getCommentText;
+                    if (tag.getTagName() !== SERVICE_FACTORY_TAG) continue;
+                    if (result !== undefined) continue;
+                    var raw = (_tag_getCommentText = tag.getCommentText()) === null || _tag_getCommentText === void 0 ? void 0 : _tag_getCommentText.trim();
+                    if (raw === undefined || raw.length === 0) continue;
+                    var firstToken = raw.split(/\s+/)[0];
+                    if (MODEL_TYPE_VALUE_PATTERN.test(firstToken)) {
+                        result = firstToken;
+                    }
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return result;
 }
 /**
  * Resolves an `extends` clause to the concrete ancestor interface name,

package/manifest-extract/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-cli/manifest-extract",
-  "version": "13.11.17",
+  "version": "13.12.0",
   "sideEffects": false,
   "peerDependencies": {
     "ts-morph": "^21.0.0"

package/manifest-extract/src/lib/types.d.ts

@@ -9,7 +9,7 @@
  * `dbx-cli-firebase-api-manifest` build CLI. Re-exported under
  * `@dereekb/dbx-cli/manifest-extract`.
  */
-export type CrudVerb = 'create' | 'read' | 'update' | 'delete' | 'query' | 'standalone';
+export type CrudVerb = 'create' | 'read' | 'update' | 'delete' | 'query' | 'invoke' | 'standalone';
 export interface CrudEntryDocField {
     readonly name: string;
     readonly typeText: string;
@@ -125,6 +125,11 @@ export interface ModelExtractionInterface {
     readonly hasDbxModelTag: boolean;
     readonly extendsNames: readonly string[];
     readonly props: readonly ModelExtractionInterfaceProp[];
+    /**
+     * Closed-enum read posture from `@dbxModelRead <level>` (`system` / `owner` / `admin-only`
+     * / `permissions`). Absent when the interface omits the tag or declares an invalid value.
+     */
+    readonly dbxModelRead?: 'system' | 'owner' | 'admin-only' | 'permissions';
 }
 /**
  * One field inside a converter's `fields` map.
@@ -231,4 +236,24 @@ export interface ModelExtraction {
     readonly converters: readonly ModelExtractionConverter[];
     readonly enums: readonly ModelExtractionEnum[];
     readonly modelGroups: readonly ModelExtractionGroup[];
+    /**
+     * `@dbxModelServiceFactory <modelType>`-tagged variable exports found in this file. The
+     * orchestrator joins these onto matching model entries by `modelType` so the runtime
+     * manifest can surface the implementing factory alongside each model.
+     */
+    readonly serviceFactories: readonly ModelExtractionServiceFactory[];
+}
+/**
+ * One `@dbxModelServiceFactory <modelType>`-tagged variable export.
+ */
+export interface ModelExtractionServiceFactory {
+    /**
+     * Canonical model-type string from the tag value (camelCase, e.g. `guestbook`).
+     * Invalid values are silently dropped at scan time.
+     */
+    readonly modelType: string;
+    /**
+     * Name of the exported binding (e.g. `guestbookFirebaseModelServiceFactory`).
+     */
+    readonly exportName: string;
 }

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@dereekb/dbx-cli",
-  "version": "13.11.17",
+  "version": "13.12.0",
+  "type": "module",
   "sideEffects": false,
   "bin": {
     "dbx-cli-generate-firebase-api-manifest": "firebase-api-manifest/main.js",
     "dbx-cli-generate-firestore-indexes": "generate-firestore-indexes/main.js",
+    "dbx-cli-generate-mcp-manifest": "generate-mcp-manifest/main.js",
     "dbx-cli-lint-cache": "lint-cache/main.js"
   },
   "exports": {
@@ -14,6 +16,9 @@
     "./generate-firestore-indexes": {
       "default": "./generate-firestore-indexes/main.js"
     },
+    "./generate-mcp-manifest": {
+      "default": "./generate-mcp-manifest/main.js"
+    },
     "./lint-cache": {
       "default": "./lint-cache/main.js"
     },
@@ -31,18 +36,17 @@
     },
     "./package.json": "./package.json",
     ".": {
-      "module": "./index.esm.js",
-      "types": "./index.d.ts",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
+      "import": "./index.esm.js",
+      "types": "./index.d.ts"
     }
   },
   "peerDependencies": {
-    "@dereekb/date": "13.11.17",
-    "@dereekb/firebase": "13.11.17",
-    "@dereekb/nestjs": "13.11.17",
-    "@dereekb/util": "13.11.17",
+    "@dereekb/date": "13.12.0",
+    "@dereekb/firebase": "13.12.0",
+    "@dereekb/nestjs": "13.12.0",
+    "@dereekb/util": "13.12.0",
     "arktype": "^2.2.0",
+    "ts-morph": "^21.0.0",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
@@ -50,6 +54,6 @@
     "eslint": "10.4.0"
   },
   "module": "./index.esm.js",
-  "main": "./index.cjs.js",
+  "main": "./index.esm.js",
   "types": "./index.d.ts"
 }

package/src/lib/index.d.ts

@@ -6,7 +6,10 @@ export * from './context';
 export * from './doctor';
 export * from './env';
 export * from './manifest';
+export * from './mcp-scan';
 export * from './middleware';
+export * from './scan-helpers/scan-io.js';
+export * from './scan-helpers/scan-extract-utils.js';
 export * from './output';
 export * from './runner';
 export * from './util';