@dereekb/dbx-cli 13.37.0 → 13.39.0

package/manifest-extract/index.cjs.js

@@ -1,1592 +0,0 @@
-'use strict';
-
-var tsMorph = require('ts-morph');
-var dbxCli = require('@dereekb/dbx-cli');
-
-function _define_property$1(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _object_spread$1(target) {
-    for(var i = 1; i < arguments.length; i++){
-        var source = arguments[i] != null ? arguments[i] : {};
-        var ownKeys = Object.keys(source);
-        if (typeof Object.getOwnPropertySymbols === "function") {
-            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
-                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
-            }));
-        }
-        ownKeys.forEach(function(key) {
-            _define_property$1(target, key, source[key]);
-        });
-    }
-    return target;
-}
-function ownKeys$1(object, enumerableOnly) {
-    var keys = Object.keys(object);
-    if (Object.getOwnPropertySymbols) {
-        var symbols = Object.getOwnPropertySymbols(object);
-        keys.push.apply(keys, symbols);
-    }
-    return keys;
-}
-function _object_spread_props$1(target, source) {
-    source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
-        ownKeys$1(Object(source)).forEach(function(key) {
-            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-        });
-    }
-    return target;
-}
-var SUPPORTED_VERBS = new Set([
-    'create',
-    'read',
-    'update',
-    'delete',
-    'query',
-    'invoke'
-]);
-/**
- * JSDoc tag (without leading `@`) on a CRUD leaf naming the interface that a handler's
- * `mapSuccessfulResult` produces for MCP. When present, the MCP manifest output schema is
- * synthesized from this type instead of the raw result type.
- */ var DBX_MODEL_API_MCP_RESULT_MARKER = 'dbxModelApiMcpResult';
-/**
- * Walks a `<model>.api.ts` source and returns one {@link CrudEntry} per
- * callable leaf (CRUD or standalone). Best-effort: malformed configs return
- * fewer entries rather than throwing.
- *
- * @param source - In-memory source name + text pair to extract.
- * @returns The CRUD extraction with group name, model keys, entries, and
- *   `*Functions` class name (when present).
- */ // eslint-disable-next-line sonarjs/cognitive-complexity
-function extractCrudEntries(source) {
-    var project = new tsMorph.Project({
-        useInMemoryFileSystem: true,
-        skipAddingFilesFromTsConfig: true
-    });
-    var sourceFile = project.createSourceFile(source.name, source.text, {
-        overwrite: true
-    });
-    var entries = [];
-    var modelKeys = [];
-    var crudConfigType = findTypeAliasByEnding(sourceFile, 'ModelCrudFunctionsConfig');
-    var groupName = inferGroupName(sourceFile);
-    var functionsClassName = findFunctionsClassName(sourceFile);
-    var typeDocsCache = new Map();
-    var resolveTypeDocs = function resolveTypeDocs(typeName) {
-        var result;
-        if (typeName) {
-            if (typeDocsCache.has(typeName)) {
-                result = typeDocsCache.get(typeName);
-            } else {
-                result = readTypeDocs(sourceFile, typeName);
-                if (result) {
-                    typeDocsCache.set(typeName, result);
-                }
-            }
-        }
-        return result;
-    };
-    if (crudConfigType) {
-        var literal = crudConfigType.getTypeNode();
-        if (literal && tsMorph.Node.isTypeLiteral(literal)) {
-            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-            try {
-                for(var _iterator = literal.getMembers()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                    var member = _step.value;
-                    if (!tsMorph.Node.isPropertySignature(member)) {
-                        continue;
-                    }
-                    var modelName = member.getName();
-                    modelKeys.push(modelName);
-                    var valueNode = member.getTypeNode();
-                    if (!valueNode) {
-                        continue;
-                    }
-                    if (isNullLiteralType(valueNode)) {
-                        continue;
-                    }
-                    if (tsMorph.Node.isTypeLiteral(valueNode)) {
-                        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-                        try {
-                            for(var _iterator1 = valueNode.getMembers()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                                var verbMember = _step1.value;
-                                if (!tsMorph.Node.isPropertySignature(verbMember)) {
-                                    continue;
-                                }
-                                var verbName = verbMember.getName();
-                                if (!SUPPORTED_VERBS.has(verbName)) {
-                                    continue;
-                                }
-                                var verb = verbName;
-                                var verbValueNode = verbMember.getTypeNode();
-                                if (!verbValueNode) {
-                                    continue;
-                                }
-                                collectVerbEntries({
-                                    modelName: modelName,
-                                    verb: verb,
-                                    valueNode: verbValueNode,
-                                    entries: entries,
-                                    fallbackDescription: readJsDocSummary(verbMember),
-                                    fallbackMcpResultTypeName: readJsDocTagValue(verbMember, DBX_MODEL_API_MCP_RESULT_MARKER),
-                                    resolveTypeDocs: resolveTypeDocs
-                                });
-                            }
-                        } 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;
-                    }
-                }
-            }
-        }
-    }
-    var functionTypeMap = findTypeAliasByEnding(sourceFile, 'FunctionTypeMap');
-    if (functionTypeMap) {
-        var literal1 = functionTypeMap.getTypeNode();
-        if (literal1 && tsMorph.Node.isTypeLiteral(literal1)) {
-            var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
-            try {
-                for(var _iterator2 = literal1.getMembers()[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
-                    var member1 = _step2.value;
-                    if (!tsMorph.Node.isPropertySignature(member1)) {
-                        continue;
-                    }
-                    var key = member1.getName();
-                    var valueNode1 = member1.getTypeNode();
-                    var tuple = valueNode1 ? readTupleParamsResult(valueNode1) : undefined;
-                    var paramsDocs = resolveTypeDocs(tuple === null || tuple === void 0 ? void 0 : tuple.params);
-                    var resultDocs = resolveTypeDocs(tuple === null || tuple === void 0 ? void 0 : tuple.result);
-                    var mcpResultTypeName = readJsDocTagValue(member1, DBX_MODEL_API_MCP_RESULT_MARKER);
-                    var mcpResultDocs = resolveTypeDocs(mcpResultTypeName);
-                    entries.push({
-                        model: key,
-                        verb: 'standalone',
-                        specifier: undefined,
-                        paramsTypeName: tuple === null || tuple === void 0 ? void 0 : tuple.params,
-                        resultTypeName: tuple === null || tuple === void 0 ? void 0 : tuple.result,
-                        line: member1.getStartLineNumber(),
-                        description: readJsDocSummary(member1),
-                        paramsTypeDescription: paramsDocs === null || paramsDocs === void 0 ? void 0 : paramsDocs.typeDescription,
-                        paramsFields: paramsDocs === null || paramsDocs === void 0 ? void 0 : paramsDocs.fields,
-                        paramsHasApiParamsTag: paramsDocs === null || paramsDocs === void 0 ? void 0 : paramsDocs.hasApiParamsTag,
-                        resultTypeDescription: resultDocs === null || resultDocs === void 0 ? void 0 : resultDocs.typeDescription,
-                        resultFields: resultDocs === null || resultDocs === void 0 ? void 0 : resultDocs.fields,
-                        mcpResultTypeName: mcpResultTypeName,
-                        mcpResultTypeDescription: mcpResultDocs === null || mcpResultDocs === void 0 ? void 0 : mcpResultDocs.typeDescription,
-                        mcpResultFields: mcpResultDocs === null || mcpResultDocs === void 0 ? void 0 : mcpResultDocs.fields
-                    });
-                }
-            } catch (err) {
-                _didIteratorError2 = true;
-                _iteratorError2 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
-                        _iterator2.return();
-                    }
-                } finally{
-                    if (_didIteratorError2) {
-                        throw _iteratorError2;
-                    }
-                }
-            }
-        }
-    }
-    return {
-        groupName: groupName,
-        modelKeys: modelKeys,
-        entries: entries,
-        functionsClassName: functionsClassName
-    };
-}
-function findTypeAliasByEnding(sourceFile, ending) {
-    var result;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = sourceFile.getTypeAliases()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var alias = _step.value;
-            if (alias.getName().endsWith(ending) && alias.getTypeNode()) {
-                result = alias;
-                break;
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return result;
-}
-function findFunctionsClassName(sourceFile) {
-    var result;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = sourceFile.getClasses()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var cls = _step.value;
-            if (!cls.isAbstract()) {
-                continue;
-            }
-            var name = cls.getName();
-            if (name === null || name === void 0 ? void 0 : name.endsWith('Functions')) {
-                result = name;
-                break;
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return result;
-}
-function inferGroupName(sourceFile) {
-    var _findTypeAliasStem;
-    return (_findTypeAliasStem = findTypeAliasStem(sourceFile, 'ModelCrudFunctionsConfig')) !== null && _findTypeAliasStem !== void 0 ? _findTypeAliasStem : findTypeAliasStem(sourceFile, 'FunctionTypeMap');
-}
-/**
- * Finds the first type alias whose name ends with `ending` and returns the
- * non-empty stem (the name with `ending` stripped).
- *
- * @param sourceFile - The parsed `<model>.api.ts` source.
- * @param ending - The type-alias name suffix to match.
- * @returns The stem preceding `ending`, or `undefined` when no alias matches with a non-empty stem.
- */ function findTypeAliasStem(sourceFile, ending) {
-    var result;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = sourceFile.getTypeAliases()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var alias = _step.value;
-            var name = alias.getName();
-            if (name.endsWith(ending)) {
-                var stem = name.slice(0, -ending.length);
-                if (stem.length > 0) {
-                    result = stem;
-                    break;
-                }
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return result;
-}
-function isNullLiteralType(node) {
-    var result = false;
-    if (tsMorph.Node.isLiteralTypeNode(node)) {
-        var literal = node.getLiteral();
-        if (tsMorph.Node.isNullLiteral(literal)) {
-            result = true;
-        }
-    }
-    return result;
-}
-function collectVerbEntries(input) {
-    var _readTupleParamsResult;
-    var modelName = input.modelName, verb = input.verb, valueNode = input.valueNode, entries = input.entries, fallbackDescription = input.fallbackDescription, fallbackMcpResultTypeName = input.fallbackMcpResultTypeName, resolveTypeDocs = input.resolveTypeDocs;
-    if (tsMorph.Node.isTypeLiteral(valueNode)) {
-        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-        try {
-            for(var _iterator = valueNode.getMembers()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                var specMember = _step.value;
-                var _readTupleParamsResult1;
-                if (!tsMorph.Node.isPropertySignature(specMember)) {
-                    continue;
-                }
-                var specifier = specMember.getName();
-                var leafNode = specMember.getTypeNode();
-                var leaf = leafNode ? (_readTupleParamsResult1 = readTupleParamsResult(leafNode)) !== null && _readTupleParamsResult1 !== void 0 ? _readTupleParamsResult1 : readBareParams(leafNode) : undefined;
-                var paramsDocs = resolveTypeDocs(leaf === null || leaf === void 0 ? void 0 : leaf.params);
-                var resultDocs = resolveTypeDocs(leaf === null || leaf === void 0 ? void 0 : leaf.result);
-                var mcpResultTypeName = readJsDocTagValue(specMember, DBX_MODEL_API_MCP_RESULT_MARKER);
-                var mcpResultDocs = resolveTypeDocs(mcpResultTypeName);
-                entries.push({
-                    model: modelName,
-                    verb: verb,
-                    specifier: specifier,
-                    paramsTypeName: leaf === null || leaf === void 0 ? void 0 : leaf.params,
-                    resultTypeName: leaf === null || leaf === void 0 ? void 0 : leaf.result,
-                    line: specMember.getStartLineNumber(),
-                    description: readJsDocSummary(specMember),
-                    paramsTypeDescription: paramsDocs === null || paramsDocs === void 0 ? void 0 : paramsDocs.typeDescription,
-                    paramsFields: paramsDocs === null || paramsDocs === void 0 ? void 0 : paramsDocs.fields,
-                    paramsHasApiParamsTag: paramsDocs === null || paramsDocs === void 0 ? void 0 : paramsDocs.hasApiParamsTag,
-                    resultTypeDescription: resultDocs === null || resultDocs === void 0 ? void 0 : resultDocs.typeDescription,
-                    resultFields: resultDocs === null || resultDocs === void 0 ? void 0 : resultDocs.fields,
-                    mcpResultTypeName: mcpResultTypeName,
-                    mcpResultTypeDescription: mcpResultDocs === null || mcpResultDocs === void 0 ? void 0 : mcpResultDocs.typeDescription,
-                    mcpResultFields: mcpResultDocs === null || mcpResultDocs === void 0 ? void 0 : mcpResultDocs.fields
-                });
-            }
-        } catch (err) {
-            _didIteratorError = true;
-            _iteratorError = err;
-        } finally{
-            try {
-                if (!_iteratorNormalCompletion && _iterator.return != null) {
-                    _iterator.return();
-                }
-            } finally{
-                if (_didIteratorError) {
-                    throw _iteratorError;
-                }
-            }
-        }
-        return;
-    }
-    var leaf1 = (_readTupleParamsResult = readTupleParamsResult(valueNode)) !== null && _readTupleParamsResult !== void 0 ? _readTupleParamsResult : readBareParams(valueNode);
-    var paramsDocs1 = resolveTypeDocs(leaf1 === null || leaf1 === void 0 ? void 0 : leaf1.params);
-    var resultDocs1 = resolveTypeDocs(leaf1 === null || leaf1 === void 0 ? void 0 : leaf1.result);
-    var mcpResultDocs1 = resolveTypeDocs(fallbackMcpResultTypeName);
-    entries.push({
-        model: modelName,
-        verb: verb,
-        specifier: undefined,
-        paramsTypeName: leaf1 === null || leaf1 === void 0 ? void 0 : leaf1.params,
-        resultTypeName: leaf1 === null || leaf1 === void 0 ? void 0 : leaf1.result,
-        line: valueNode.getStartLineNumber(),
-        description: fallbackDescription,
-        paramsTypeDescription: paramsDocs1 === null || paramsDocs1 === void 0 ? void 0 : paramsDocs1.typeDescription,
-        paramsFields: paramsDocs1 === null || paramsDocs1 === void 0 ? void 0 : paramsDocs1.fields,
-        paramsHasApiParamsTag: paramsDocs1 === null || paramsDocs1 === void 0 ? void 0 : paramsDocs1.hasApiParamsTag,
-        resultTypeDescription: resultDocs1 === null || resultDocs1 === void 0 ? void 0 : resultDocs1.typeDescription,
-        resultFields: resultDocs1 === null || resultDocs1 === void 0 ? void 0 : resultDocs1.fields,
-        mcpResultTypeName: fallbackMcpResultTypeName,
-        mcpResultTypeDescription: mcpResultDocs1 === null || mcpResultDocs1 === void 0 ? void 0 : mcpResultDocs1.typeDescription,
-        mcpResultFields: mcpResultDocs1 === null || mcpResultDocs1 === void 0 ? void 0 : mcpResultDocs1.fields
-    });
-}
-function readTupleParamsResult(node) {
-    var pair;
-    if (tsMorph.Node.isTupleTypeNode(node)) {
-        var elements = node.getElements();
-        if (elements.length > 0) {
-            var params = elements[0] ? typeNodeName(elements[0]) : undefined;
-            var result = elements[1] ? typeNodeName(elements[1]) : undefined;
-            pair = {
-                params: params,
-                result: result
-            };
-        }
-    }
-    return pair;
-}
-function readBareParams(node) {
-    var params = typeNodeName(node);
-    return params ? {
-        params: params,
-        result: undefined
-    } : undefined;
-}
-function typeNodeName(node) {
-    var result;
-    if (tsMorph.Node.isTypeReference(node)) {
-        result = node.getTypeName().getText();
-    } else {
-        // Fall back to the raw text for primitive / inline types like `boolean`.
-        var text = node.getText().trim();
-        result = text.length > 0 ? text : undefined;
-    }
-    return result;
-}
-function readTypeDocs(sourceFile, typeName) {
-    var interfaceDecl = sourceFile.getInterface(typeName);
-    var result;
-    if (interfaceDecl) {
-        result = readInterfaceTypeDocs(interfaceDecl);
-    } else {
-        var typeAlias = sourceFile.getTypeAlias(typeName);
-        result = typeAlias ? readTypeAliasDocs(typeAlias) : undefined;
-    }
-    return result;
-}
-/**
- * Reads the type-level JSDoc (summary, fields, `@dbxModelApiParams` flag) of a
- * resolved interface declaration.
- *
- * @param interfaceDecl - The interface naming a params/result type.
- * @returns The collected docs, or `undefined` when the interface has no description, fields, or marker.
- */ function readInterfaceTypeDocs(interfaceDecl) {
-    var typeDescription = readJsDocSummary(interfaceDecl);
-    var hasApiParamsTag = hasJsDocFlag(interfaceDecl, 'dbxModelApiParams');
-    var fields = interfaceDecl.getProperties().map(function(property) {
-        return readInterfaceField(property);
-    });
-    var result;
-    if (typeDescription || fields.length > 0 || hasApiParamsTag) {
-        result = _object_spread_props$1(_object_spread$1({}, typeDescription ? {
-            typeDescription: typeDescription
-        } : {}, fields.length > 0 ? {
-            fields: fields
-        } : {}), {
-            hasApiParamsTag: hasApiParamsTag
-        });
-    }
-    return result;
-}
-/**
- * Reads one interface property into a {@link CrudEntryDocField}, capturing its
- * type text, JSDoc summary, and `@dbxModelApiAdminOnly` access level.
- *
- * @param property - The interface property signature.
- * @returns The doc field for the property.
- */ function readInterfaceField(property) {
-    var _ref;
-    var _property_getTypeNode;
-    var description = readJsDocSummary(property);
-    var adminOnly = hasJsDocFlag(property, 'dbxModelApiAdminOnly');
-    return _object_spread$1({
-        name: property.getName(),
-        typeText: (_ref = (_property_getTypeNode = property.getTypeNode()) === null || _property_getTypeNode === void 0 ? void 0 : _property_getTypeNode.getText().trim()) !== null && _ref !== void 0 ? _ref : ''
-    }, description ? {
-        description: description
-    } : {}, adminOnly ? {
-        accessLevel: 'adminOnly'
-    } : {});
-}
-/**
- * Reads the type-level JSDoc summary of a resolved type alias.
- *
- * @param typeAlias - The type alias naming a params/result type.
- * @returns The collected docs, or `undefined` when the alias has no description.
- */ function readTypeAliasDocs(typeAlias) {
-    var typeDescription = readJsDocSummary(typeAlias);
-    return typeDescription ? {
-        typeDescription: typeDescription
-    } : undefined;
-}
-/**
- * Returns `true` when any JSDoc block on `node` carries the bare `@<tagName>` flag.
- *
- * Used for boolean marker tags like `@dbxModelApiParams` and `@dbxModelApiAdminOnly`
- * where the presence of the tag is the entire signal (no value parsing needed).
- *
- * @param node - Any JSDocable ts-morph node (interface, property, etc.).
- * @param tagName - Tag name without the leading `@` (e.g. `'dbxModelApiAdminOnly'`).
- * @returns `true` when at least one JSDoc tag with `tagName` is present.
- */ function hasJsDocFlag(node, tagName) {
-    var result = false;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = node.getJsDocs()[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;
-                    if (tag.getTagName() === tagName) {
-                        result = true;
-                    }
-                }
-            } 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;
-}
-/**
- * Reads the value token of a JSDoc tag (e.g. the `Foo` in `@dbxModelApiMcpResult Foo`).
- *
- * Used for value-carrying tags like `@dbxModelApiMcpResult` where the first token after the tag
- * name names a type. Returns the first whitespace-delimited token of the tag's comment text.
- *
- * @param node - Any JSDocable ts-morph node (property signature, etc.).
- * @param tagName - Tag name without the leading `@` (e.g. `'dbxModelApiMcpResult'`).
- * @returns The first token of the tag's value, or `undefined` when the tag is absent or empty.
- */ function readJsDocTagValue(node, tagName) {
-    var result;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = node.getJsDocs()[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;
-                    if (tag.getTagName() === tagName) {
-                        var _tag_getCommentText;
-                        var token = (_tag_getCommentText = tag.getCommentText()) === null || _tag_getCommentText === void 0 ? void 0 : _tag_getCommentText.trim().split(/\s+/)[0];
-                        if (token) {
-                            result = token;
-                        }
-                    }
-                }
-            } 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 readJsDocSummary(node) {
-    var result;
-    var docs = node.getJsDocs();
-    var last = docs.at(-1);
-    if (last) {
-        var description = last.getDescription().trim();
-        if (description.length > 0) {
-            result = description;
-        }
-    }
-    return result;
-}
-
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _object_spread(target) {
-    for(var i = 1; i < arguments.length; i++){
-        var source = arguments[i] != null ? arguments[i] : {};
-        var ownKeys = Object.keys(source);
-        if (typeof Object.getOwnPropertySymbols === "function") {
-            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
-                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
-            }));
-        }
-        ownKeys.forEach(function(key) {
-            _define_property(target, key, source[key]);
-        });
-    }
-    return target;
-}
-function ownKeys(object, enumerableOnly) {
-    var keys = Object.keys(object);
-    if (Object.getOwnPropertySymbols) {
-        var symbols = Object.getOwnPropertySymbols(object);
-        keys.push.apply(keys, symbols);
-    }
-    return keys;
-}
-function _object_spread_props(target, source) {
-    source = source != null ? source : {};
-    if (Object.getOwnPropertyDescriptors) {
-        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
-    } else {
-        ownKeys(Object(source)).forEach(function(key) {
-            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
-        });
-    }
-    return target;
-}
-var READ_LEVEL_VALUES = 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 IDENTITY_FN = 'firestoreModelIdentity';
-var CONVERTER_FN_NAMES = [
-    'snapshotConverterFunctions',
-    'firestoreSubObject',
-    'firestoreObjectArray'
-];
-var SUB_OBJECT_FN = 'firestoreSubObject';
-var OBJECT_ARRAY_FN = 'firestoreObjectArray';
-var SNAPSHOT_FN = 'snapshotConverterFunctions';
-var FIELDS_LITERAL_KEY = 'fields';
-var OBJECT_FIELD_KEY = 'objectField';
-var FIRESTORE_FIELD_KEY = 'firestoreField';
-/**
- * Walks a single source file and reports raw model-extraction artifacts.
- * Best-effort: a malformed call shape leaves the corresponding entry out
- * rather than throwing.
- *
- * @param input - In-memory `{ name, text }` source pair.
- * @returns The per-file extraction. Aggregation across files happens in the
- *   firebase-api-manifest orchestrator so cross-file converter consts can be
- *   resolved against a global registry.
- */ function extractModelsFromSource(input) {
-    var project = new tsMorph.Project({
-        useInMemoryFileSystem: true,
-        skipAddingFilesFromTsConfig: true
-    });
-    var sourceFile = project.createSourceFile(input.name, input.text, {
-        overwrite: true
-    });
-    var identities = readIdentities(sourceFile);
-    var interfaces = readInterfaces(sourceFile);
-    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,
-        serviceFactories: serviceFactories
-    };
-}
-function readIdentities(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 _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;
-                    var initializer = decl.getInitializer();
-                    if (!initializer || !tsMorph.Node.isCallExpression(initializer)) continue;
-                    if (initializer.getExpression().getText() !== IDENTITY_FN) continue;
-                    var parsed = dbxCli.parseFirestoreModelIdentityArgs(initializer.getArguments());
-                    if (parsed) {
-                        out.push(_object_spread({
-                            identityConst: decl.getName()
-                        }, parsed));
-                    }
-                }
-            } 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 readInterfaces(sourceFile) {
-    var out = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = sourceFile.getInterfaces()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var decl = _step.value;
-            if (!decl.isExported()) continue;
-            out.push(buildInterface(decl));
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return out;
-}
-function buildInterface(decl) {
-    var jsDocs = decl.getJsDocs();
-    var hasDbxModelTag = jsDocsHaveTag(jsDocs, 'dbxModel');
-    var dbxModelRead = readDbxModelReadTag(jsDocs);
-    var mcpToolNameSegment = readMcpToolNameSegmentTag(jsDocs);
-    var extendsNames = decl.getExtends().map(dbxCli.resolveExtendsName);
-    var props = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = decl.getProperties()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var prop = _step.value;
-            var _ref;
-            var _prop_getTypeNode;
-            var propJsDocs = prop.getJsDocs();
-            var longName = readJsDocTagText(propJsDocs, 'dbxModelVariable');
-            var syncFlag = readJsDocTagText(propJsDocs, 'dbxModelVariableSyncFlag');
-            var tsType = ((_ref = (_prop_getTypeNode = prop.getTypeNode()) === null || _prop_getTypeNode === void 0 ? void 0 : _prop_getTypeNode.getText()) !== null && _ref !== void 0 ? _ref : '').replaceAll(/\s+/g, ' ').trim();
-            var optional = prop.hasQuestionToken() || tsType.startsWith('Maybe<');
-            props.push({
-                name: prop.getName(),
-                tsType: tsType,
-                optional: optional,
-                description: readJsDocDescription(propJsDocs),
-                longName: longName,
-                syncFlag: syncFlag
-            });
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return _object_spread({
-        name: decl.getName(),
-        description: readJsDocDescription(jsDocs),
-        hasDbxModelTag: hasDbxModelTag,
-        extendsNames: extendsNames,
-        props: props
-    }, dbxModelRead === undefined ? {} : {
-        dbxModelRead: dbxModelRead
-    }, mcpToolNameSegment === undefined ? {} : {
-        mcpToolNameSegment: mcpToolNameSegment
-    });
-}
-function readMcpToolNameSegmentTag(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() !== MCP_TOOL_NAME_SEGMENT_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 (TOOL_NAME_SEGMENT_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;
-}
-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;
-}
-function readConverters(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 _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;
-                    var initializer = decl.getInitializer();
-                    if (!initializer || !tsMorph.Node.isCallExpression(initializer)) continue;
-                    var factory = initializer.getExpression().getText();
-                    if (!isConverterFactoryName(factory)) continue;
-                    var interfaceName = readGenericInterfaceName(initializer);
-                    var fields = readConverterFields(initializer);
-                    if (!fields) continue;
-                    out.push({
-                        converterConst: decl.getName(),
-                        factory: factory,
-                        interfaceName: interfaceName,
-                        fields: fields,
-                        line: decl.getStartLineNumber()
-                    });
-                }
-            } 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 isConverterFactoryName(name) {
-    return CONVERTER_FN_NAMES.includes(name);
-}
-function readGenericInterfaceName(call) {
-    var typeArgs = call.getTypeArguments();
-    var result;
-    if (typeArgs.length > 0) {
-        result = typeArgs[0].getText().replaceAll(/<[^>]*>/g, '').trim();
-    }
-    return result;
-}
-function readConverterFields(call) {
-    var fnName = call.getExpression().getText();
-    var args = call.getArguments();
-    var result;
-    if (args.length > 0) {
-        var config = args[0];
-        if (tsMorph.Node.isObjectLiteralExpression(config)) {
-            var fieldsLiteral;
-            if (fnName === SNAPSHOT_FN) {
-                fieldsLiteral = readObjectProperty(config, FIELDS_LITERAL_KEY);
-            } else {
-                var objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
-                if (objectField && tsMorph.Node.isObjectLiteralExpression(objectField)) {
-                    fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
-                }
-            }
-            if (fieldsLiteral) {
-                result = readFieldEntries(fieldsLiteral);
-            }
-        }
-    }
-    return result;
-}
-function readFieldEntries(fields) {
-    var out = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = fields.getProperties()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var property = _step.value;
-            if (tsMorph.Node.isPropertyAssignment(property)) {
-                var initializer = property.getInitializer();
-                var converterText = initializer ? initializer.getText().replaceAll(/\s+/g, ' ').trim() : '';
-                var nested = initializer ? readNestedFromExpression(initializer) : undefined;
-                out.push({
-                    key: property.getName(),
-                    converter: converterText,
-                    nestedConverterRef: nested === null || nested === void 0 ? void 0 : nested.ref,
-                    nestedConverterInline: nested === null || nested === void 0 ? void 0 : nested.inline,
-                    nestedIsArray: nested === null || nested === void 0 ? void 0 : nested.isArray
-                });
-            } else if (tsMorph.Node.isShorthandPropertyAssignment(property)) {
-                var name = property.getName();
-                out.push({
-                    key: name,
-                    converter: name
-                });
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return out;
-}
-function readNestedFromExpression(expr) {
-    var result;
-    if (tsMorph.Node.isCallExpression(expr)) {
-        var fnName = expr.getExpression().getText();
-        if (fnName === SUB_OBJECT_FN || fnName === OBJECT_ARRAY_FN) {
-            result = readNestedConverterCall(expr, fnName);
-        }
-    }
-    return result;
-}
-/**
- * Reads the `objectField` (or `firestoreField`) argument of a
- * `firestoreSubObject` / `firestoreObjectArray` call into a
- * {@link NestedConverterMatch}.
- *
- * `firestoreObjectArray`'s config is a union: `{ objectField }` describes the
- * element shape directly, while `{ firestoreField }` points the element decode
- * at another field converter (a sub-object const or an inline
- * `firestoreSubObject(...)`). Both carriers resolve through the same nested path
- * — the `firestoreField` variant is what the timesheet day-level form uses.
- *
- * @param call - The nested-converter call expression.
- * @param fnName - The resolved factory name (`firestoreSubObject` or `firestoreObjectArray`).
- * @returns The nested-converter match, or `undefined` when the call shape is malformed.
- */ function readNestedConverterCall(call, fnName) {
-    var result;
-    var args = call.getArguments();
-    if (args.length > 0) {
-        var config = args[0];
-        if (tsMorph.Node.isObjectLiteralExpression(config)) {
-            var _readPropertyValue;
-            var valueNode = (_readPropertyValue = readPropertyValue(config, OBJECT_FIELD_KEY)) !== null && _readPropertyValue !== void 0 ? _readPropertyValue : readPropertyValue(config, FIRESTORE_FIELD_KEY);
-            if (valueNode) {
-                result = buildNestedConverterMatch({
-                    objectField: valueNode,
-                    call: call,
-                    fnName: fnName
-                });
-            }
-        }
-    }
-    return result;
-}
-/**
- * Builds a {@link NestedConverterMatch} from a resolved value node:
- * an identifier yields a converter `ref`, an object literal yields an `inline`
- * converter parsed from its `fields`, and a nested
- * `firestoreSubObject(...)` / `firestoreObjectArray(...)` call (the inline
- * `firestoreField: firestoreSubObject<T>({...})` form) is resolved recursively —
- * the outer factory still decides array-ness.
- *
- * @param input - The resolved value node, owning call expression, and factory name.
- * @returns The nested-converter match, or `undefined` when no shape applies.
- */ function buildNestedConverterMatch(input) {
-    var objectField = input.objectField, call = input.call, fnName = input.fnName;
-    var isArray = fnName === OBJECT_ARRAY_FN;
-    var result;
-    if (tsMorph.Node.isIdentifier(objectField)) {
-        result = {
-            ref: objectField.getText(),
-            isArray: isArray
-        };
-    } else if (tsMorph.Node.isObjectLiteralExpression(objectField)) {
-        var fieldsLiteral = readObjectProperty(objectField, FIELDS_LITERAL_KEY);
-        if (fieldsLiteral) {
-            result = {
-                inline: {
-                    converterConst: undefined,
-                    factory: fnName,
-                    interfaceName: readGenericInterfaceName(call),
-                    fields: readFieldEntries(fieldsLiteral),
-                    line: call.getStartLineNumber()
-                },
-                isArray: isArray
-            };
-        }
-    } else if (tsMorph.Node.isCallExpression(objectField)) {
-        var nested = readNestedFromExpression(objectField);
-        if (nested) {
-            result = _object_spread_props(_object_spread({}, nested), {
-                isArray: isArray
-            });
-        }
-    }
-    return result;
-}
-function readPropertyValue(literal, key) {
-    var property = literal.getProperty(key);
-    var result;
-    if (property && tsMorph.Node.isPropertyAssignment(property)) {
-        result = property.getInitializer();
-    } else if (property && tsMorph.Node.isShorthandPropertyAssignment(property)) {
-        result = property.getNameNode();
-    }
-    return result;
-}
-function readObjectProperty(literal, key) {
-    var value = readPropertyValue(literal, key);
-    return value && tsMorph.Node.isObjectLiteralExpression(value) ? value : undefined;
-}
-function readEnums(sourceFile) {
-    var out = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = sourceFile.getEnums()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var decl = _step.value;
-            if (!decl.isExported()) continue;
-            var values = [];
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = decl.getMembers()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var member = _step1.value;
-                    var value = member.getValue();
-                    var description = readJsDocDescription(member.getJsDocs());
-                    if (typeof value === 'string' || typeof value === 'number') {
-                        values.push({
-                            name: member.getName(),
-                            value: value,
-                            description: description
-                        });
-                    }
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-            out.push({
-                name: decl.getName(),
-                values: values,
-                description: readJsDocDescription(decl.getJsDocs())
-            });
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return out;
-}
-function readModelGroups(sourceFile) {
-    var out = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = sourceFile.getInterfaces()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var iface = _step.value;
-            if (!iface.isExported()) continue;
-            var groupTag = readJsDocTagText(iface.getJsDocs(), 'dbxModelGroup');
-            if (!groupTag) continue;
-            var containerName = iface.getName();
-            if (!containerName.endsWith('FirestoreCollections')) continue;
-            var modelNames = [];
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = iface.getProperties()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var prop = _step1.value;
-                    var _ref;
-                    var _prop_getTypeNode;
-                    var tsType = (_ref = (_prop_getTypeNode = prop.getTypeNode()) === null || _prop_getTypeNode === void 0 ? void 0 : _prop_getTypeNode.getText()) !== null && _ref !== void 0 ? _ref : '';
-                    var match = /([A-Z]\w*)FirestoreCollection(?:Factory)?(?:\b|<)/.exec(tsType);
-                    if (match) modelNames.push(match[1]);
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-            out.push({
-                name: groupTag,
-                containerName: containerName,
-                description: readJsDocDescription(iface.getJsDocs()),
-                modelNames: modelNames
-            });
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return out;
-}
-function jsDocsHaveTag(jsDocs, tagName) {
-    var found = false;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = jsDocs[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var jsDoc = _step.value;
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = jsDoc.getTags()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var tag = _step1.value;
-                    if (tag.getTagName() === tagName) {
-                        found = true;
-                        break;
-                    }
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-            if (found) break;
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return found;
-}
-function readJsDocTagText(jsDocs, tagName) {
-    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 jsDoc = _step.value;
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = jsDoc.getTags()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var tag = _step1.value;
-                    var _tag_getCommentText;
-                    if (tag.getTagName() !== tagName) continue;
-                    var text = (_tag_getCommentText = tag.getCommentText()) === null || _tag_getCommentText === void 0 ? void 0 : _tag_getCommentText.trim();
-                    if (text !== undefined && text.length > 0) {
-                        result = text;
-                        break;
-                    }
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-            if (result !== undefined) break;
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return result;
-}
-function readJsDocDescription(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 jsDoc = _step.value;
-            var description = jsDoc.getDescription().trim();
-            if (description.length === 0) continue;
-            var paragraph = firstParagraph(description);
-            if (paragraph.length > 0) {
-                result = paragraph;
-                break;
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return result;
-}
-function firstParagraph(text) {
-    var lines = text.split('\n').map(function(line) {
-        return line.trim();
-    });
-    var collected = [];
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = lines[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var line = _step.value;
-            if (line.startsWith('@')) break;
-            if (line.length === 0) {
-                if (collected.length > 0) break;
-                continue;
-            }
-            collected.push(line);
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return collected.join(' ').trim();
-}
-
-exports.extractCrudEntries = extractCrudEntries;
-exports.extractModelsFromSource = extractModelsFromSource;