@dereekb/dbx-cli 13.11.4 → 13.11.6

package/manifest-extract/index.cjs.js

@@ -456,4 +456,768 @@ function readJsDocSummary(node) {
     return description.length > 0 ? description : undefined;
 }
 
+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;
+}
+/**
+ * TS utility/structural wrappers that don't change the field surface for
+ * inheritance walks — `Partial<T>`, `Required<T>`, `Readonly<T>`,
+ * `NonNullable<T>` preserve every property, and `Pick<T, K>` / `Omit<T, K>`
+ * leave the original `T` reachable for long-name resolution. `MaybeMap<T>` is
+ * the workspace's own pass-through that decorates each prop with `Maybe<…>`
+ * without renaming. `extends` walks need to see through these to find the
+ * concrete ancestor interface — `getExpression()` alone returns just the
+ * leftmost identifier (`Partial`, `Pick`, …) and silently drops the inner
+ * model, leaving every inherited `@dbxModelVariable` tag unreachable.
+ */ var PASSTHROUGH_TYPE_WRAPPERS = new Set([
+    'Partial',
+    'Required',
+    'Readonly',
+    'NonNullable',
+    'MaybeMap',
+    'Pick',
+    'Omit'
+]);
+var IDENTITY_FN = 'firestoreModelIdentity';
+var CONVERTER_FN_NAMES = [
+    'snapshotConverterFunctions',
+    'firestoreSubObject',
+    'firestoreObjectArray'
+];
+var SUB_OBJECT_FN = 'firestoreSubObject';
+var OBJECT_ARRAY_FN = 'firestoreObjectArray';
+var SNAPSHOT_FN = 'snapshotConverterFunctions';
+var FIELDS_LITERAL_KEY = 'fields';
+var OBJECT_FIELD_KEY = 'objectField';
+/**
+ * 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);
+    return {
+        identities: identities,
+        interfaces: interfaces,
+        converters: converters,
+        enums: enums,
+        modelGroups: modelGroups
+    };
+}
+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 = parseIdentityArgs(initializer);
+                    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 parseIdentityArgs(call) {
+    var args = call.getArguments();
+    var result;
+    if (args.length === 1) {
+        var modelType = stringLiteralValue(args[0]);
+        if (modelType !== undefined) {
+            result = {
+                modelType: modelType,
+                collectionPrefix: undefined,
+                parentIdentityConst: undefined
+            };
+        }
+    } else if (args.length === 2) {
+        var first = stringLiteralValue(args[0]);
+        if (first === undefined) {
+            var modelType1 = stringLiteralValue(args[1]);
+            if (modelType1 !== undefined) {
+                result = {
+                    modelType: modelType1,
+                    collectionPrefix: undefined,
+                    parentIdentityConst: identifierName(args[0])
+                };
+            }
+        } else {
+            result = {
+                modelType: first,
+                collectionPrefix: stringLiteralValue(args[1]),
+                parentIdentityConst: undefined
+            };
+        }
+    } else if (args.length >= 3) {
+        var modelType2 = stringLiteralValue(args[1]);
+        if (modelType2 !== undefined) {
+            result = {
+                modelType: modelType2,
+                collectionPrefix: stringLiteralValue(args[2]),
+                parentIdentityConst: identifierName(args[0])
+            };
+        }
+    }
+    return result;
+}
+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 extendsNames = decl.getExtends().map(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 {
+        name: decl.getName(),
+        description: readJsDocDescription(jsDocs),
+        hasDbxModelTag: hasDbxModelTag,
+        extendsNames: extendsNames,
+        props: props
+    };
+}
+/**
+ * Resolves an `extends` clause to the concrete ancestor interface name,
+ * peeling any leading {@link PASSTHROUGH_TYPE_WRAPPERS}. Returns the leftmost
+ * identifier of the unwrapped expression so the inheritance walker can chain
+ * through utility-wrapped declarations like
+ * `extends Partial<MaybeMap<Omit<Base, '…'>>>`.
+ *
+ * @param expr - the `ExpressionWithTypeArguments` produced by `getExtends()`
+ * @returns the resolved interface name, or the original leftmost identifier when no inner reference is reachable
+ */ function resolveExtendsName(expr) {
+    var head = expr.getExpression().getText();
+    var result = head;
+    if (PASSTHROUGH_TYPE_WRAPPERS.has(head)) {
+        var typeArgs = expr.getTypeArguments();
+        if (typeArgs.length > 0) {
+            var peeled = peelTypeNode(typeArgs[0]);
+            if (peeled !== undefined) {
+                result = peeled;
+            }
+        }
+    }
+    return result;
+}
+function peelTypeNode(node) {
+    var current = node;
+    while(tsMorph.Node.isParenthesizedTypeNode(current)){
+        current = current.getTypeNode();
+    }
+    var result;
+    if (tsMorph.Node.isTypeReference(current)) {
+        var name = current.getTypeName().getText();
+        if (PASSTHROUGH_TYPE_WRAPPERS.has(name)) {
+            var inner = current.getTypeArguments();
+            if (inner.length > 0) {
+                result = peelTypeNode(inner[0]);
+            }
+        } else {
+            result = name;
+        }
+    }
+    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();
+    if (args.length === 0) return undefined;
+    var config = args[0];
+    if (!tsMorph.Node.isObjectLiteralExpression(config)) return undefined;
+    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) return undefined;
+    return readFieldEntries(fieldsLiteral);
+}
+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) {
+    if (!tsMorph.Node.isCallExpression(expr)) return undefined;
+    var fnName = expr.getExpression().getText();
+    if (fnName !== SUB_OBJECT_FN && fnName !== OBJECT_ARRAY_FN) return undefined;
+    var args = expr.getArguments();
+    if (args.length === 0) return undefined;
+    var config = args[0];
+    if (!tsMorph.Node.isObjectLiteralExpression(config)) return undefined;
+    var objectField = readPropertyValue(config, OBJECT_FIELD_KEY);
+    if (!objectField) return undefined;
+    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) {
+            var inlineFields = readFieldEntries(fieldsLiteral);
+            result = {
+                inline: {
+                    converterConst: undefined,
+                    factory: fnName,
+                    interfaceName: readGenericInterfaceName(expr),
+                    fields: inlineFields,
+                    line: expr.getStartLineNumber()
+                },
+                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();
+}
+function stringLiteralValue(node) {
+    var result;
+    if (tsMorph.Node.isStringLiteral(node) || tsMorph.Node.isNoSubstitutionTemplateLiteral(node)) {
+        result = node.getLiteralText();
+    }
+    return result;
+}
+function identifierName(node) {
+    var result;
+    if (tsMorph.Node.isIdentifier(node)) {
+        result = node.getText();
+    }
+    return result;
+}
+
 exports.extractCrudEntries = extractCrudEntries;
+exports.extractModelsFromSource = extractModelsFromSource;