@medusajs/http-types-generator 2.13.6-preview-20260402101111

package/dist/utils/file-merger.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileMerger = void 0;
+const fs_1 = require("fs");
+const formatter_1 = require("./formatter");
+const type_emitter_1 = require("../core/type-emitter");
+/**
+ * Decides whether to create, merge, or overwrite a type file.
+ */
+class FileMerger {
+    /**
+     * Decides whether to create, merge, or overwrite a type file.
+     *
+     * - File does not exist → create (write all interfaces)
+     * - File exists + `force` → overwrite (write all interfaces, replacing existing)
+     * - File exists, not `force` → merge: add only interfaces not already declared
+     *
+     * Returns the final file content plus a status code.
+     */
+    async resolveFileContent(file, interfaces, importTracker, force) {
+        const raw = type_emitter_1.TypeEmitter.assembleFile(interfaces, importTracker, file);
+        const generated = raw;
+        const { existsSync } = await import("fs");
+        if (!existsSync(file)) {
+            const content = await formatter_1.Formatter.format(generated, file);
+            return { content, status: "created", added: interfaces.length };
+        }
+        if (force) {
+            const content = await formatter_1.Formatter.format(generated, file);
+            return { content, status: "overwritten", added: interfaces.length };
+        }
+        const existingContent = (0, fs_1.readFileSync)(file, "utf-8");
+        const existingBlocks = this.extractInterfaceBlocks(existingContent);
+        const newInterfaces = interfaces.filter(({ name }) => !existingBlocks.has(name));
+        if (newInterfaces.length === 0) {
+            return { content: existingContent, status: "skipped", added: 0 };
+        }
+        const generatedBlocks = this.extractInterfaceBlocks(generated);
+        const existingBodyLines = existingContent
+            .split("\n")
+            .filter((l) => !l.trim().startsWith("import "));
+        const newBlocks = newInterfaces
+            .map(({ name }) => generatedBlocks.get(name) ?? "")
+            .filter(Boolean);
+        const existingImportLines = this.extractImportLines(existingContent);
+        const generatedImportLines = this.extractImportLines(generated);
+        const mergedImports = this.mergeImportLines(existingImportLines, generatedImportLines);
+        const parts = [];
+        if (mergedImports.length > 0) {
+            parts.push(mergedImports.join("\n"));
+            parts.push("");
+        }
+        parts.push(existingBodyLines.join("\n").trimStart());
+        parts.push("");
+        parts.push(newBlocks.join("\n\n"));
+        const merged = parts.join("\n");
+        const content = await formatter_1.Formatter.format(merged, file);
+        return { content, status: "updated", added: newInterfaces.length };
+    }
+    /**
+     * Parses a named import line of the form:
+     *   `import { A, B } from "source"`
+     *   `import type { A, B } from "source"`
+     *
+     * Returns null for default imports, side-effect imports, or anything else.
+     */
+    parseImportLine(line) {
+        const typeRe = /^import\s+type\s+\{\s*([^}]+)\}\s+from\s+["']([^"']+)["']/;
+        const normalRe = /^import\s+\{\s*([^}]+)\}\s+from\s+["']([^"']+)["']/;
+        const typeMatch = line.trim().match(typeRe);
+        const normalMatch = line.trim().match(normalRe);
+        const m = typeMatch ?? normalMatch;
+        if (!m)
+            return null;
+        return {
+            isType: !!typeMatch,
+            names: m[1]
+                .split(",")
+                .map((n) => n.trim())
+                .filter(Boolean),
+            source: m[2],
+        };
+    }
+    /**
+     * Merges two sets of import lines, combining named imports for the same
+     * source so we never emit duplicate import statements.
+     */
+    mergeImportLines(existingLines, newLines) {
+        const map = new Map();
+        const unparseable = [];
+        const process = (line) => {
+            const t = line.trim();
+            if (!t)
+                return;
+            const parsed = this.parseImportLine(t);
+            if (!parsed) {
+                if (t.startsWith("import ") && !unparseable.includes(t)) {
+                    unparseable.push(t);
+                }
+                return;
+            }
+            const key = `${parsed.isType ? "type:" : ""}${parsed.source}`;
+            if (!map.has(key)) {
+                map.set(key, { isType: parsed.isType, names: new Set() });
+            }
+            for (const name of parsed.names) {
+                map.get(key).names.add(name);
+            }
+        };
+        for (const l of existingLines)
+            process(l);
+        for (const l of newLines)
+            process(l);
+        const result = [];
+        for (const [key, { isType, names }] of map) {
+            const source = key.replace(/^type:/, "");
+            const namesList = [...names].sort().join(", ");
+            result.push(`${isType ? "import type" : "import"} { ${namesList} } from "${source}"`);
+        }
+        result.push(...unparseable);
+        return result;
+    }
+    /**
+     * Scans `content` for `export interface Name ...` blocks and returns a map
+     * from interface name to the full block text.
+     */
+    extractInterfaceBlocks(content) {
+        const blocks = new Map();
+        const lines = content.split("\n");
+        let i = 0;
+        while (i < lines.length) {
+            const m = lines[i].match(/^export\s+interface\s+(\w+)/);
+            if (m) {
+                const name = m[1];
+                let block = "";
+                let depth = 0;
+                while (i < lines.length) {
+                    const line = lines[i];
+                    block += line + "\n";
+                    depth +=
+                        (line.match(/\{/g) ?? []).length - (line.match(/\}/g) ?? []).length;
+                    i++;
+                    if (depth === 0 && block.trim())
+                        break;
+                }
+                blocks.set(name, block.trimEnd());
+            }
+            else {
+                i++;
+            }
+        }
+        return blocks;
+    }
+    /**
+     * Extracts all `import ...` lines from the file content.
+     */
+    extractImportLines(content) {
+        return content
+            .split("\n")
+            .filter((l) => l.trim().startsWith("import "));
+    }
+}
+exports.FileMerger = FileMerger;
+//# sourceMappingURL=file-merger.js.map

package/dist/utils/file-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-merger.js","sourceRoot":"","sources":["../../src/utils/file-merger.ts"],"names":[],"mappings":"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"}

package/dist/utils/formatter.d.ts

@@ -0,0 +1,12 @@
+export declare class Formatter {
+    /**
+     * Formats `content` using the Prettier config resolved for `filePath`.
+     * The `filePath` is used both to resolve the nearest `.prettierrc` and
+     * to let Prettier pick the correct parser (e.g. `typescript` for `.ts`).
+     *
+     * Returns the formatted content, or the original content if Prettier
+     * cannot parse or format it.
+     */
+    static format(content: string, filePath: string): Promise<string>;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/utils/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAS;IACpB;;;;;;;OAOG;WACU,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAWxE"}

package/dist/utils/formatter.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Formatter = void 0;
+const prettier_1 = __importDefault(require("prettier"));
+class Formatter {
+    /**
+     * Formats `content` using the Prettier config resolved for `filePath`.
+     * The `filePath` is used both to resolve the nearest `.prettierrc` and
+     * to let Prettier pick the correct parser (e.g. `typescript` for `.ts`).
+     *
+     * Returns the formatted content, or the original content if Prettier
+     * cannot parse or format it.
+     */
+    static async format(content, filePath) {
+        try {
+            const config = (await prettier_1.default.resolveConfig(filePath)) || undefined;
+            if (config && !config.parser) {
+                config.parser = "babel-ts";
+            }
+            return await prettier_1.default.format(content, config);
+        }
+        catch {
+            return content;
+        }
+    }
+}
+exports.Formatter = Formatter;
+//# sourceMappingURL=formatter.js.map

package/dist/utils/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":";;;;;;AAAA,wDAA+B;AAE/B,MAAa,SAAS;IACpB;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,QAAgB;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAM,kBAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAA;YACpE,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,GAAG,UAAU,CAAA;YAC5B,CAAC;YACD,OAAO,MAAM,kBAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAA;QAChB,CAAC;IACH,CAAC;CACF;AApBD,8BAoBC"}

package/dist/utils/fs-helpers.d.ts

@@ -0,0 +1,21 @@
+export declare class FsHelpers {
+    /**
+     * Returns the absolute path to the project root.
+     * Determined by searching upward for `http-types.config.json`; falls back
+     * to `process.cwd()` when no config file is found.
+     */
+    static getProjectRoot(): string;
+    /**
+     * Ensures a directory exists, creating it recursively if needed.
+     */
+    static ensureDir(dirPath: string): void;
+    /**
+     * Writes content to a file, creating intermediate directories as needed.
+     */
+    static writeFile(filePath: string, content: string): void;
+    /**
+     * Resolves a path relative to the project root.
+     */
+    static fromRoot(...segments: string[]): string;
+}
+//# sourceMappingURL=fs-helpers.d.ts.map

package/dist/utils/fs-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/fs-helpers.ts"],"names":[],"mappings":"AAIA,qBAAa,SAAS;IACpB;;;;OAIG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM;IAI/B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKzD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;CAG/C"}

package/dist/utils/fs-helpers.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsHelpers = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../config");
+class FsHelpers {
+    /**
+     * Returns the absolute path to the project root.
+     * Determined by searching upward for `http-types.config.json`; falls back
+     * to `process.cwd()` when no config file is found.
+     */
+    static getProjectRoot() {
+        return config_1.Config.get().projectRoot;
+    }
+    /**
+     * Ensures a directory exists, creating it recursively if needed.
+     */
+    static ensureDir(dirPath) {
+        if (!(0, fs_1.existsSync)(dirPath)) {
+            (0, fs_1.mkdirSync)(dirPath, { recursive: true });
+        }
+    }
+    /**
+     * Writes content to a file, creating intermediate directories as needed.
+     */
+    static writeFile(filePath, content) {
+        FsHelpers.ensureDir(path_1.default.dirname(filePath));
+        (0, fs_1.writeFileSync)(filePath, content, "utf-8");
+    }
+    /**
+     * Resolves a path relative to the project root.
+     */
+    static fromRoot(...segments) {
+        return path_1.default.join(FsHelpers.getProjectRoot(), ...segments);
+    }
+}
+exports.FsHelpers = FsHelpers;
+//# sourceMappingURL=fs-helpers.js.map

package/dist/utils/fs-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.js","sourceRoot":"","sources":["../../src/utils/fs-helpers.ts"],"names":[],"mappings":";;;;;;AAAA,2BAAyD;AACzD,gDAAuB;AACvB,sCAAkC;AAElC,MAAa,SAAS;IACpB;;;;OAIG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO,eAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAe;QAC9B,IAAI,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACzB,IAAA,cAAS,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAgB,EAAE,OAAe;QAChD,SAAS,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC3C,IAAA,kBAAa,EAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAkB;QACnC,OAAO,cAAI,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAA;IAC3D,CAAC;CACF;AAjCD,8BAiCC"}

package/dist/utils/index-manager.d.ts

@@ -0,0 +1,24 @@
+import type { PathMapping } from "../mapping/path-mapper";
+/**
+ * Manages barrel export index files for the HTTP types package.
+ */
+export declare class IndexManager {
+    /**
+     * After a payloads.ts or queries.ts file is written, ensures all index files
+     * in the chain are up to date:
+     *
+     * 1. `{domain}/{area}/index.ts`  — exports the written file stem
+     * 2. `{domain}/index.ts`         — exports `./{area}`
+     * 3. `packages/core/types/src/http/index.ts` — exports `./{domain}`
+     *
+     * In dry-run mode nothing is written; changes are only logged.
+     */
+    updateIndexFiles(mapping: PathMapping, writtenLabel: string, dryRun: boolean): Promise<void>;
+    /**
+     * Ensures `export * from "./{stem}"` is present in `indexFile`.
+     * Creates the file if it doesn't exist; appends the line if it's missing.
+     * Returns true if a change was made (or would be made in dry-run).
+     */
+    private ensureExport;
+}
+//# sourceMappingURL=index-manager.d.ts.map

package/dist/utils/index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../../src/utils/index-manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;OASG;IACG,gBAAgB,CACpB,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IA+DhB;;;;OAIG;YACW,YAAY;CA+B3B"}

package/dist/utils/index-manager.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexManager = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const fs_helpers_1 = require("./fs-helpers");
+const formatter_1 = require("./formatter");
+const config_1 = require("../config");
+/**
+ * Manages barrel export index files for the HTTP types package.
+ */
+class IndexManager {
+    /**
+     * After a payloads.ts or queries.ts file is written, ensures all index files
+     * in the chain are up to date:
+     *
+     * 1. `{domain}/{area}/index.ts`  — exports the written file stem
+     * 2. `{domain}/index.ts`         — exports `./{area}`
+     * 3. `packages/core/types/src/http/index.ts` — exports `./{domain}`
+     *
+     * In dry-run mode nothing is written; changes are only logged.
+     */
+    async updateIndexFiles(mapping, writtenLabel, dryRun) {
+        const HTTP_ROOT_INDEX = fs_helpers_1.FsHelpers.fromRoot(config_1.Config.get().outputBase, "index.ts");
+        const { outputDir, area, domain } = mapping;
+        const domainDir = path_1.default.dirname(outputDir);
+        const areaIndexFile = path_1.default.join(outputDir, "index.ts");
+        const domainIndexFile = path_1.default.join(domainDir, "index.ts");
+        const relArea = path_1.default.relative(process.cwd(), areaIndexFile);
+        const relDomain = path_1.default.relative(process.cwd(), domainIndexFile);
+        const relRoot = path_1.default.relative(process.cwd(), HTTP_ROOT_INDEX);
+        const areaChanged = await this.ensureExport(areaIndexFile, writtenLabel, dryRun);
+        if (areaChanged) {
+            if (dryRun) {
+                console.log(chalk_1.default.cyan(`  [dry-run] ${relArea}`) +
+                    chalk_1.default.gray(` ← add export * from "./${writtenLabel}"`));
+            }
+            else {
+                console.log(chalk_1.default.green(`  Update  ${relArea}`));
+            }
+        }
+        const domainChanged = await this.ensureExport(domainIndexFile, area, dryRun);
+        if (domainChanged) {
+            if (dryRun) {
+                console.log(chalk_1.default.cyan(`  [dry-run] ${relDomain}`) +
+                    chalk_1.default.gray(` ← add export * from "./${area}"`));
+            }
+            else {
+                console.log(chalk_1.default.green(`  Update  ${relDomain}`));
+            }
+        }
+        const rootChanged = await this.ensureExport(HTTP_ROOT_INDEX, domain, dryRun);
+        if (rootChanged) {
+            if (dryRun) {
+                console.log(chalk_1.default.cyan(`  [dry-run] ${relRoot}`) +
+                    chalk_1.default.gray(` ← add export * from "./${domain}"`));
+            }
+            else {
+                console.log(chalk_1.default.green(`  Update  ${relRoot}`));
+            }
+        }
+    }
+    /**
+     * Ensures `export * from "./{stem}"` is present in `indexFile`.
+     * Creates the file if it doesn't exist; appends the line if it's missing.
+     * Returns true if a change was made (or would be made in dry-run).
+     */
+    async ensureExport(indexFile, stem, dryRun) {
+        const exportLine = `export * from "./${stem}"`;
+        if (!(0, fs_1.existsSync)(indexFile)) {
+            const content = await formatter_1.Formatter.format(`${exportLine}\n`, indexFile);
+            if (!dryRun) {
+                fs_helpers_1.FsHelpers.writeFile(indexFile, content);
+            }
+            return true;
+        }
+        const existing = (0, fs_1.readFileSync)(indexFile, "utf-8");
+        const alreadyPresent = new RegExp(`export\\s+\\*\\s+from\\s+["']\\.\/${stem}["']`).test(existing);
+        if (alreadyPresent) {
+            return false;
+        }
+        const updated = existing.trimEnd() + "\n" + exportLine + "\n";
+        const content = await formatter_1.Formatter.format(updated, indexFile);
+        if (!dryRun) {
+            (0, fs_1.writeFileSync)(indexFile, content, "utf-8");
+        }
+        return true;
+    }
+}
+exports.IndexManager = IndexManager;
+//# sourceMappingURL=index-manager.js.map

package/dist/utils/index-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.js","sourceRoot":"","sources":["../../src/utils/index-manager.ts"],"names":[],"mappings":"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"}

package/dist/utils/ts-helpers.d.ts

@@ -0,0 +1,87 @@
+import ts from "typescript";
+export declare class TsHelpers {
+    private static readonly OPERATOR_MAP_PROPS;
+    /**
+     * Returns true if the given TypeScript type looks like a Zod schema,
+     * by checking for the presence of the `_input` and `_output` branded properties
+     * that all Zod types expose.
+     */
+    static isZodType(type: ts.Type): boolean;
+    /**
+     * Returns true if the top-level Zod type IS a ZodEffects (i.e., has a `.transform()`
+     * applied at the outermost level). This is different from checking if the type string
+     * _contains_ "ZodEffects", which would also match ZodObject schemas whose shape
+     * contains ZodEffects-wrapped fields (e.g., via `z.preprocess()`).
+     */
+    static isZodEffects(checker: ts.TypeChecker, type: ts.Type): boolean;
+    /**
+     * Resolves the `_input` type of a Zod schema — i.e. the pre-transform shape,
+     * which represents what a caller would send in an HTTP request.
+     */
+    static getZodInputType(checker: ts.TypeChecker, zodType: ts.Type): ts.Type | undefined;
+    /**
+     * Resolves the `_output` type of a Zod schema — the post-transform inferred type,
+     * equivalent to `z.infer<typeof schema>`.
+     */
+    static getZodOutputType(checker: ts.TypeChecker, zodType: ts.Type): ts.Type | undefined;
+    /**
+     * Returns true if a type has OperatorMap member properties ($eq, $ne, $in, etc.).
+     */
+    private static isOperatorMapMember;
+    /**
+     * Detects if a resolved type looks like an `OperatorMap` — a union that
+     * includes an object with filter operator properties ($eq, $ne, $in, etc.).
+     */
+    static isOperatorMapType(type: ts.Type): boolean;
+    /**
+     * Returns a simplified display string for a TypeScript type, suitable for
+     * use in error messages and diagnostics.
+     */
+    static typeToDisplayString(checker: ts.TypeChecker, type: ts.Type): string;
+    /**
+     * Recursively walks a call expression chain to check if any call in the chain
+     * uses the given function name.
+     */
+    static callChainIncludes(node: ts.Node, funcName: string): boolean;
+    /**
+     * Returns true if the given type is plain `string` (not a literal or union).
+     */
+    static isPlainString(type: ts.Type): boolean;
+    /**
+     * Returns true if the type is a string literal or a union of string literals.
+     */
+    static isStringLiteralOrUnion(type: ts.Type): boolean;
+    /**
+     * Returns true if the type is a TypeScript string enum or a union of string
+     * enum literals.
+     */
+    static isStringEnumType(type: ts.Type): boolean;
+    /**
+     * Returns the set of string values from a string literal type or a union of
+     * string literals.
+     */
+    static getStringLiteralValues(type: ts.Type): Set<string>;
+    /**
+     * Checks whether the given node has an `export` modifier.
+     */
+    static isExported(node: ts.Node): boolean;
+    /**
+     * Returns the first VariableDeclaration inside a VariableStatement.
+     */
+    static getVariableDeclaration(stmt: ts.VariableStatement): ts.VariableDeclaration | undefined;
+    /**
+     * Reads the `@http-type-name` JSDoc tag value from the leading comments
+     * of a VariableStatement node, if present.
+     */
+    static readHttpTypeNameTag(node: ts.VariableStatement, sourceFile: ts.SourceFile): string | undefined;
+    /**
+     * Given a call expression like `WithAdditionalData(CreateCustomer)`,
+     * returns the text of the first argument identifier ("CreateCustomer").
+     */
+    static getFirstCallArgName(node: ts.VariableDeclaration): string | undefined;
+    /**
+     * Checks whether a TypeScript type is a function type (as opposed to an object/Zod type).
+     */
+    static isFunctionType(type: ts.Type): boolean;
+}
+//# sourceMappingURL=ts-helpers.d.ts.map

package/dist/utils/ts-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/ts-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CASzC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IAMxC;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IASpE;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,EAAE,EAAE,CAAC,IAAI,GACf,EAAE,CAAC,IAAI,GAAG,SAAS;IAQtB;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CACrB,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,EAAE,EAAE,CAAC,IAAI,GACf,EAAE,CAAC,IAAI,GAAG,SAAS;IAQtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IAOhD;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,IAAI,EAAE,EAAE,CAAC,IAAI,GACZ,MAAM;IAST;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAoBlE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IAI5C;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IAUrD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IAiB/C;;;OAGG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;IAczD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;IASzC;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,IAAI,EAAE,EAAE,CAAC,iBAAiB,GACzB,EAAE,CAAC,mBAAmB,GAAG,SAAS;IAIrC;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,IAAI,EAAE,EAAE,CAAC,iBAAiB,EAC1B,UAAU,EAAE,EAAE,CAAC,UAAU,GACxB,MAAM,GAAG,SAAS;IAarB;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAC3B,MAAM,GAAG,SAAS;IAYrB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;CAI9C"}