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

package/dist/core/type-emitter.js

@@ -0,0 +1,246 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeEmitter = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const type_resolver_1 = require("./type-resolver");
+const fs_helpers_1 = require("../utils/fs-helpers");
+const config_1 = require("../config");
+/**
+ * Emits TypeScript interface declarations from resolved Zod schema types and
+ * assembles complete output files with the correct import statements.
+ */
+class TypeEmitter {
+    constructor(checker) {
+        this.checker = checker;
+    }
+    /**
+     * Emits a TypeScript interface declaration as a string from a resolved schema type.
+     *
+     * @param interfaceName - The name for the generated interface
+     * @param resolved - The resolved schema type info
+     * @param importTracker - Mutable tracker that records which imports are needed
+     */
+    emitInterface(interfaceName, resolved, importTracker) {
+        const { type, hasFindParams, hasSelectParams, hasBaseFilterable } = resolved;
+        if (hasFindParams) {
+            importTracker.needsFindParams = true;
+        }
+        if (hasSelectParams) {
+            importTracker.needsSelectParams = true;
+        }
+        if (hasBaseFilterable) {
+            importTracker.needsBaseFilterable = true;
+        }
+        const resolver = new type_resolver_1.TypeResolver(this.checker);
+        const properties = resolver.resolveProperties(type, hasFindParams, hasSelectParams);
+        const hasOperatorMapProp = properties.some((p) => p.isOperatorMap);
+        if (hasOperatorMapProp) {
+            importTracker.needsOperatorMap = true;
+        }
+        const members = [];
+        for (const prop of properties) {
+            if (prop.isFindParamsField) {
+                continue;
+            }
+            members.push(this.createPropertySignature(prop));
+        }
+        const heritageClauses = TypeEmitter.createHeritageClauses(interfaceName, hasFindParams, hasSelectParams, hasBaseFilterable);
+        const interfaceDecl = typescript_1.default.factory.createInterfaceDeclaration([typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.ExportKeyword)], typescript_1.default.factory.createIdentifier(interfaceName), undefined, heritageClauses, members);
+        const printer = TypeEmitter.createPrinter();
+        const dummyFile = TypeEmitter.createDummySourceFile();
+        return printer.printNode(typescript_1.default.EmitHint.Unspecified, interfaceDecl, dummyFile);
+    }
+    /**
+     * Assembles a complete TypeScript file from a list of emitted interfaces.
+     *
+     * @param interfaces - The interfaces to include
+     * @param importTracker - What imports are needed
+     * @param outputFile - Absolute path to the file being written (used to compute relative imports)
+     */
+    static assembleFile(interfaces, importTracker, outputFile) {
+        const bodyParts = [];
+        for (const iface of interfaces) {
+            bodyParts.push(iface.code);
+            bodyParts.push("");
+        }
+        const { content: cleanedBody, imports: hoistedImports } = TypeEmitter.hoistInlineImports(bodyParts.join("\n"), outputFile);
+        const parts = [];
+        const trackerImports = TypeEmitter.generateImports(importTracker, outputFile);
+        if (trackerImports) {
+            parts.push(trackerImports);
+        }
+        for (const [source, typeNames] of hoistedImports) {
+            const names = [...typeNames].sort().join(", ");
+            parts.push(`import type { ${names} } from "${source}"`);
+        }
+        if (parts.length > 0) {
+            parts.push("");
+        }
+        parts.push(cleanedBody);
+        return parts.join("\n");
+    }
+    /**
+     * Creates a `ts.PropertySignature` for an interface member from a `PropertyInfo`.
+     */
+    createPropertySignature(prop, enclosingNode) {
+        let typeNode;
+        if (prop.isOperatorMap) {
+            typeNode = TypeEmitter.makeOperatorMapTypeNode();
+        }
+        else {
+            typeNode = this.typeToTypeNode(prop.type, enclosingNode);
+        }
+        return typescript_1.default.factory.createPropertySignature(undefined, typescript_1.default.factory.createIdentifier(prop.name), prop.isOptional
+            ? typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.QuestionToken)
+            : undefined, typeNode);
+    }
+    /**
+     * Converts a TypeScript `ts.Type` to a `ts.TypeNode` using the type checker.
+     * Falls back to `any` if conversion fails.
+     */
+    typeToTypeNode(type, enclosingNode) {
+        const typeNode = this.checker.typeToTypeNode(type, enclosingNode, typescript_1.default.NodeBuilderFlags.NoTruncation |
+            typescript_1.default.NodeBuilderFlags.UseFullyQualifiedType |
+            typescript_1.default.NodeBuilderFlags.AllowThisInObjectLiteral);
+        if (!typeNode) {
+            return typescript_1.default.factory.createKeywordTypeNode(typescript_1.default.SyntaxKind.AnyKeyword);
+        }
+        return typeNode;
+    }
+    /**
+     * Resolves an import source to an import specifier string.
+     * If `target` is a bare package name (starts with `@` or contains no `/` after
+     * stripping scope), it is returned as-is. Otherwise it is treated as a
+     * project-root-relative path and converted to a relative import path.
+     */
+    static resolveImportPath(outputFile, target) {
+        // Package specifier: starts with "@" (scoped) or has no path separators
+        const isPackageSpecifier = target.startsWith("@") || !target.includes("/");
+        if (isPackageSpecifier) {
+            return target;
+        }
+        const fromDir = path_1.default.dirname(outputFile);
+        const toDir = fs_helpers_1.FsHelpers.fromRoot(target);
+        const rel = path_1.default.relative(fromDir, toDir).replace(/\\/g, "/");
+        return rel.startsWith(".") ? rel : "./" + rel;
+    }
+    static createPrinter() {
+        return typescript_1.default.createPrinter({
+            newLine: typescript_1.default.NewLineKind.LineFeed,
+            removeComments: false,
+        });
+    }
+    static createDummySourceFile() {
+        return typescript_1.default.createSourceFile("output.ts", "", typescript_1.default.ScriptTarget.Latest, false, typescript_1.default.ScriptKind.TS);
+    }
+    /**
+     * Generates a `ts.TypeNode` for an OperatorMap field.
+     */
+    static makeOperatorMapTypeNode() {
+        return typescript_1.default.factory.createTypeReferenceNode(typescript_1.default.factory.createIdentifier("OperatorMap"), [typescript_1.default.factory.createKeywordTypeNode(typescript_1.default.SyntaxKind.StringKeyword)]);
+    }
+    /**
+     * Creates heritage clauses (extends ...) for an interface declaration.
+     */
+    static createHeritageClauses(interfaceName, hasFindParams, hasSelectParams, hasBaseFilterable) {
+        const expressions = [];
+        if (hasFindParams) {
+            expressions.push(typescript_1.default.factory.createExpressionWithTypeArguments(typescript_1.default.factory.createIdentifier("FindParams"), undefined));
+        }
+        if (hasSelectParams) {
+            expressions.push(typescript_1.default.factory.createExpressionWithTypeArguments(typescript_1.default.factory.createIdentifier("SelectParams"), undefined));
+        }
+        if (hasBaseFilterable) {
+            expressions.push(typescript_1.default.factory.createExpressionWithTypeArguments(typescript_1.default.factory.createIdentifier("BaseFilterable"), [
+                typescript_1.default.factory.createTypeReferenceNode(typescript_1.default.factory.createIdentifier(interfaceName), undefined),
+            ]));
+        }
+        if (expressions.length === 0) {
+            return [];
+        }
+        return [
+            typescript_1.default.factory.createHeritageClause(typescript_1.default.SyntaxKind.ExtendsKeyword, expressions),
+        ];
+    }
+    /**
+     * Generates the import statements for a file based on what types were referenced.
+     */
+    static generateImports(tracker, outputFile) {
+        const lines = [];
+        const commonTypes = [];
+        if (tracker.needsFindParams)
+            commonTypes.push("FindParams");
+        if (tracker.needsSelectParams)
+            commonTypes.push("SelectParams");
+        if (commonTypes.length > 0) {
+            lines.push(`import { ${commonTypes.join(", ")} } from "${TypeEmitter.resolveImportPath(outputFile, config_1.Config.get().importSources.commonRequest)}"`);
+        }
+        const dalTypes = [];
+        if (tracker.needsBaseFilterable)
+            dalTypes.push("BaseFilterable");
+        if (tracker.needsOperatorMap)
+            dalTypes.push("OperatorMap");
+        if (dalTypes.length > 0) {
+            lines.push(`import { ${dalTypes.join(", ")} } from "${TypeEmitter.resolveImportPath(outputFile, config_1.Config.get().importSources.dal)}"`);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Walks up the directory tree from `startPath` to find the nearest `package.json`
+     * and returns its `name` field, or `undefined` if none is found.
+     */
+    static findPackageName(startPath) {
+        const monorepoRoot = fs_helpers_1.FsHelpers.fromRoot();
+        let dir = startPath;
+        while (dir !== monorepoRoot) {
+            const parent = path_1.default.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+            const pkgPath = path_1.default.join(dir, "package.json");
+            if ((0, fs_1.existsSync)(pkgPath)) {
+                try {
+                    const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, "utf8"));
+                    if (pkg.name)
+                        return pkg.name;
+                }
+                catch {
+                    // ignore malformed package.json
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Scans `content` for inline TypeScript import expressions, extracts them,
+     * and replaces each with just the type name. Returns the cleaned content plus
+     * a map of importSource → Set<typeName> for import statements to prepend.
+     */
+    static hoistInlineImports(content, outputFile) {
+        const imports = new Map();
+        const INLINE_IMPORT_RE = /import\("([^"]+)"\)\.(\w+)/g;
+        const cleaned = content.replace(INLINE_IMPORT_RE, (_match, absolutePath, typeName) => {
+            const packageName = TypeEmitter.findPackageName(absolutePath);
+            const importSource = packageName ??
+                (() => {
+                    const rel = path_1.default
+                        .relative(path_1.default.dirname(outputFile), absolutePath)
+                        .replace(/\\/g, "/");
+                    return rel.startsWith(".") ? rel : "./" + rel;
+                })();
+            if (!imports.has(importSource)) {
+                imports.set(importSource, new Set());
+            }
+            imports.get(importSource).add(typeName);
+            return typeName;
+        });
+        return { content: cleaned, imports };
+    }
+}
+exports.TypeEmitter = TypeEmitter;
+//# sourceMappingURL=type-emitter.js.map

package/dist/core/type-emitter.js.map

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

package/dist/core/type-resolver.d.ts

@@ -0,0 +1,64 @@
+import ts from "typescript";
+import type { ExtractedSchema } from "./schema-extractor";
+export interface ResolvedSchemaType {
+    /** The resolved TypeScript type representing the HTTP interface shape */
+    type: ts.Type;
+    /** Whether this type has special fields that need `FindParams` as a base */
+    hasFindParams: boolean;
+    /** Whether this type only has the `fields` property from `SelectParams` */
+    hasSelectParams: boolean;
+    /** Whether this type has `$and`/`$or` operators (BaseFilterable) */
+    hasBaseFilterable: boolean;
+    /** The schema name for diagnostic reporting */
+    schemaName: string;
+}
+/** Property names that belong to `FindParams` (superset of SelectParams) */
+export declare const FIND_PARAMS_FIELDS: Set<string>;
+/** Property names that belong to `SelectParams` only */
+export declare const SELECT_PARAMS_FIELDS: Set<string>;
+export interface PropertyInfo {
+    name: string;
+    type: ts.Type;
+    isOptional: boolean;
+    isOperatorMap: boolean;
+    /** True for fields that come from FindParams and should be omitted when extending it */
+    isFindParamsField: boolean;
+}
+/**
+ * Resolves TypeScript types from Zod schemas for HTTP interface generation.
+ */
+export declare class TypeResolver {
+    private readonly checker;
+    constructor(checker: ts.TypeChecker);
+    /**
+     * Resolves the TypeScript type that should be used to generate the HTTP
+     * interface for a given Zod schema.
+     *
+     * Decision logic:
+     * - For `WithAdditionalData` wrappers (innerSchemaType present): use `_output`
+     *   of the inner schema (no transforms on payloads).
+     * - For schemas with `.transform()` (ZodEffects): use `_input` type, which
+     *   represents what the HTTP client sends (pre-transform).
+     * - For plain ZodObjects without transforms: use `_output` type.
+     * - `createFindParams()` fields (limit, offset, etc.) use `_output` because
+     *   `z.preprocess()` has `unknown` as input but `number` as output.
+     */
+    resolveSchemaType(schema: ExtractedSchema): ResolvedSchemaType | undefined;
+    /**
+     * For each property in the resolved type, determines the appropriate
+     * TypeScript type to emit. Applies special-case mappings for:
+     * - OperatorMap fields (complex union with $eq, $ne, etc.)
+     * - booleanString fields (string | boolean → boolean)
+     * - FindParams fields (omit from flat interface if using extends FindParams)
+     */
+    resolveProperties(resolvedType: ts.Type, hasFindParams: boolean, hasSelectParams?: boolean): PropertyInfo[];
+    /**
+     * Attempts to resolve schema properties directly from the ZodObject's first type
+     * argument (the raw shape `T` in `ZodObject<T, ...>`).
+     *
+     * This is a fallback for schemas where the overall `_output` type can't be fully
+     * resolved by TypeScript due to circular `z.lazy()` references.
+     */
+    private resolveFromZodObjectShapeArg;
+}
+//# sourceMappingURL=type-resolver.d.ts.map

package/dist/core/type-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-resolver.d.ts","sourceRoot":"","sources":["../../src/core/type-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAA;IACb,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAA;IACtB,2EAA2E;IAC3E,eAAe,EAAE,OAAO,CAAA;IACxB,oEAAoE;IACpE,iBAAiB,EAAE,OAAO,CAAA;IAC1B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,aAM7B,CAAA;AAEF,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,aAAsB,CAAA;AAEvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,EAAE,CAAC,IAAI,CAAA;IACb,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;IACtB,wFAAwF;IACxF,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAQD;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,EAAE,CAAC,WAAW;IAEpD;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS;IA0E1E;;;;;;OAMG;IACH,iBAAiB,CACf,YAAY,EAAE,EAAE,CAAC,IAAI,EACrB,aAAa,EAAE,OAAO,EACtB,eAAe,UAAQ,GACtB,YAAY,EAAE;IA6CjB;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;CAmBrC"}

package/dist/core/type-resolver.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeResolver = exports.SELECT_PARAMS_FIELDS = exports.FIND_PARAMS_FIELDS = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+const ts_helpers_1 = require("../utils/ts-helpers");
+/** Property names that belong to `FindParams` (superset of SelectParams) */
+exports.FIND_PARAMS_FIELDS = new Set([
+    "fields",
+    "limit",
+    "offset",
+    "order",
+    "with_deleted",
+]);
+/** Property names that belong to `SelectParams` only */
+exports.SELECT_PARAMS_FIELDS = new Set(["fields"]);
+/**
+ * Minimum number of FindParams fields that must be present to consider
+ * a type as a `FindParams`-based type.
+ */
+const FIND_PARAMS_THRESHOLD = 3;
+/**
+ * Resolves TypeScript types from Zod schemas for HTTP interface generation.
+ */
+class TypeResolver {
+    constructor(checker) {
+        this.checker = checker;
+    }
+    /**
+     * Resolves the TypeScript type that should be used to generate the HTTP
+     * interface for a given Zod schema.
+     *
+     * Decision logic:
+     * - For `WithAdditionalData` wrappers (innerSchemaType present): use `_output`
+     *   of the inner schema (no transforms on payloads).
+     * - For schemas with `.transform()` (ZodEffects): use `_input` type, which
+     *   represents what the HTTP client sends (pre-transform).
+     * - For plain ZodObjects without transforms: use `_output` type.
+     * - `createFindParams()` fields (limit, offset, etc.) use `_output` because
+     *   `z.preprocess()` has `unknown` as input but `number` as output.
+     */
+    resolveSchemaType(schema) {
+        const { zodType, hasTransform, httpTypeName, baseFieldsType, hasFindParamsInChain, hasSelectParamsInChain, } = schema;
+        let resolvedType;
+        if (hasTransform) {
+            resolvedType = ts_helpers_1.TsHelpers.getZodInputType(this.checker, zodType);
+        }
+        else {
+            resolvedType = ts_helpers_1.TsHelpers.getZodOutputType(this.checker, zodType);
+        }
+        if (!resolvedType) {
+            return undefined;
+        }
+        let properties = resolvedType.getProperties();
+        const initialPropNames = new Set(properties.map((p) => p.name));
+        const hasZodSchemaLeak = initialPropNames.has("parse") &&
+            initialPropNames.has("safeParse") &&
+            initialPropNames.has("_output");
+        const hasCircularLazyIssue = hasZodSchemaLeak ||
+            (properties.length > 0 &&
+                properties.every((p) => p.name === "$and" || p.name === "$or"));
+        let hasBaseFilterable = initialPropNames.has("$and");
+        if (hasCircularLazyIssue && baseFieldsType) {
+            const baseFieldsOutput = ts_helpers_1.TsHelpers.getZodOutputType(this.checker, baseFieldsType);
+            if (baseFieldsOutput) {
+                resolvedType = baseFieldsOutput;
+                properties = resolvedType.getProperties();
+                hasBaseFilterable = true;
+            }
+        }
+        else if (hasCircularLazyIssue) {
+            const shapeResolved = this.resolveFromZodObjectShapeArg(zodType);
+            if (shapeResolved) {
+                resolvedType = shapeResolved;
+                properties = resolvedType.getProperties();
+                hasBaseFilterable = true;
+            }
+        }
+        const propNames = new Set(properties.map((p) => p.name));
+        let findParamsFieldCount = 0;
+        for (const f of exports.FIND_PARAMS_FIELDS) {
+            if (propNames.has(f))
+                findParamsFieldCount++;
+        }
+        const hasFindParams = findParamsFieldCount >= FIND_PARAMS_THRESHOLD || hasFindParamsInChain;
+        const hasSelectParams = !hasFindParams && hasSelectParamsInChain;
+        return {
+            type: resolvedType,
+            hasFindParams,
+            hasSelectParams,
+            hasBaseFilterable,
+            schemaName: httpTypeName,
+        };
+    }
+    /**
+     * For each property in the resolved type, determines the appropriate
+     * TypeScript type to emit. Applies special-case mappings for:
+     * - OperatorMap fields (complex union with $eq, $ne, etc.)
+     * - booleanString fields (string | boolean → boolean)
+     * - FindParams fields (omit from flat interface if using extends FindParams)
+     */
+    resolveProperties(resolvedType, hasFindParams, hasSelectParams = false) {
+        const properties = resolvedType.getProperties();
+        const result = [];
+        for (const prop of properties) {
+            const propName = prop.name;
+            if (propName === "$and" || propName === "$or") {
+                continue;
+            }
+            const rawPropType = this.checker.getTypeOfSymbol(prop);
+            const zodOutput = ts_helpers_1.TsHelpers.getZodOutputType(this.checker, rawPropType);
+            const propType = zodOutput ?? rawPropType;
+            let isOptional = !!(prop.flags & typescript_1.default.SymbolFlags.Optional);
+            if (zodOutput) {
+                const zodSymbolName = rawPropType.getSymbol()?.getName() ?? "";
+                isOptional =
+                    zodSymbolName === "ZodOptional" ||
+                        zodSymbolName === "ZodNullable" ||
+                        zodSymbolName === "ZodDefault" ||
+                        zodSymbolName === "ZodEffects";
+            }
+            const nonNullableType = this.checker.getNonNullableType(propType);
+            const isOperatorMap = ts_helpers_1.TsHelpers.isOperatorMapType(nonNullableType);
+            const isFindParamsField = (hasFindParams && exports.FIND_PARAMS_FIELDS.has(propName)) ||
+                (hasSelectParams && exports.SELECT_PARAMS_FIELDS.has(propName));
+            result.push({
+                name: propName,
+                type: propType,
+                isOptional,
+                isOperatorMap,
+                isFindParamsField,
+            });
+        }
+        return result;
+    }
+    /**
+     * Attempts to resolve schema properties directly from the ZodObject's first type
+     * argument (the raw shape `T` in `ZodObject<T, ...>`).
+     *
+     * This is a fallback for schemas where the overall `_output` type can't be fully
+     * resolved by TypeScript due to circular `z.lazy()` references.
+     */
+    resolveFromZodObjectShapeArg(zodType) {
+        const typeRef = zodType;
+        const typeArgs = this.checker.getTypeArguments(typeRef);
+        if (!typeArgs || typeArgs.length === 0) {
+            return undefined;
+        }
+        const shapeType = typeArgs[0];
+        if (!shapeType) {
+            return undefined;
+        }
+        const shapeProps = shapeType.getProperties();
+        if (shapeProps.length === 0) {
+            return undefined;
+        }
+        return shapeType;
+    }
+}
+exports.TypeResolver = TypeResolver;
+//# sourceMappingURL=type-resolver.js.map

package/dist/core/type-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-resolver.js","sourceRoot":"","sources":["../../src/core/type-resolver.ts"],"names":[],"mappings":";;;;;;AAAA,4DAA2B;AAC3B,oDAA+C;AAgB/C,4EAA4E;AAC/D,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,cAAc;CACf,CAAC,CAAA;AAEF,wDAAwD;AAC3C,QAAA,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;AAWvD;;;GAGG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B;;GAEG;AACH,MAAa,YAAY;IACvB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,MAAuB;QACvC,MAAM,EACJ,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,sBAAsB,GACvB,GAAG,MAAM,CAAA;QAEV,IAAI,YAAiC,CAAA;QAErC,IAAI,YAAY,EAAE,CAAC;YACjB,YAAY,GAAG,sBAAS,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACjE,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,sBAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,IAAI,UAAU,GAAG,YAAY,CAAC,aAAa,EAAE,CAAA;QAE7C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC/D,MAAM,gBAAgB,GACpB,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;YAC7B,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC;YACjC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACjC,MAAM,oBAAoB,GACxB,gBAAgB;YAChB,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBACpB,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAA;QAEnE,IAAI,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAEpD,IAAI,oBAAoB,IAAI,cAAc,EAAE,CAAC;YAC3C,MAAM,gBAAgB,GAAG,sBAAS,CAAC,gBAAgB,CACjD,IAAI,CAAC,OAAO,EACZ,cAAc,CACf,CAAA;YACD,IAAI,gBAAgB,EAAE,CAAC;gBACrB,YAAY,GAAG,gBAAgB,CAAA;gBAC/B,UAAU,GAAG,YAAY,CAAC,aAAa,EAAE,CAAA;gBACzC,iBAAiB,GAAG,IAAI,CAAA;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,oBAAoB,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAA;YAChE,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,GAAG,aAAa,CAAA;gBAC5B,UAAU,GAAG,YAAY,CAAC,aAAa,EAAE,CAAA;gBACzC,iBAAiB,GAAG,IAAI,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAExD,IAAI,oBAAoB,GAAG,CAAC,CAAA;QAC5B,KAAK,MAAM,CAAC,IAAI,0BAAkB,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,oBAAoB,EAAE,CAAA;QAC9C,CAAC;QACD,MAAM,aAAa,GACjB,oBAAoB,IAAI,qBAAqB,IAAI,oBAAoB,CAAA;QACvE,MAAM,eAAe,GAAG,CAAC,aAAa,IAAI,sBAAsB,CAAA;QAEhE,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,aAAa;YACb,eAAe;YACf,iBAAiB;YACjB,UAAU,EAAE,YAAY;SACzB,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CACf,YAAqB,EACrB,aAAsB,EACtB,eAAe,GAAG,KAAK;QAEvB,MAAM,UAAU,GAAG,YAAY,CAAC,aAAa,EAAE,CAAA;QAC/C,MAAM,MAAM,GAAmB,EAAE,CAAA;QAEjC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAA;YAE1B,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBAC9C,SAAQ;YACV,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YAEtD,MAAM,SAAS,GAAG,sBAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YACvE,MAAM,QAAQ,GAAG,SAAS,IAAI,WAAW,CAAA;YAEzC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,oBAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;gBAC9D,UAAU;oBACR,aAAa,KAAK,aAAa;wBAC/B,aAAa,KAAK,aAAa;wBAC/B,aAAa,KAAK,YAAY;wBAC9B,aAAa,KAAK,YAAY,CAAA;YAClC,CAAC;YAED,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;YACjE,MAAM,aAAa,GAAG,sBAAS,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAA;YAElE,MAAM,iBAAiB,GACrB,CAAC,aAAa,IAAI,0BAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnD,CAAC,eAAe,IAAI,4BAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;YAEzD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,aAAa;gBACb,iBAAiB;aAClB,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;OAMG;IACK,4BAA4B,CAAC,OAAgB;QACnD,MAAM,OAAO,GAAG,OAA2B,CAAA;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,EAAE,CAAA;QAC5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;CACF;AA5KD,oCA4KC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const generate_1 = require("./commands/generate");
+const validate_1 = require("./commands/validate");
+const program = new commander_1.Command();
+program
+    .name("medusa-http-types")
+    .description("Generate and validate HTTP TypeScript types from Zod validator schemas.\n\n" +
+    "Use `generate` to create TypeScript interfaces from Zod schemas, and\n" +
+    "`validate` to check that existing interfaces match their Zod schemas.")
+    .version("0.0.1");
+program.addCommand((0, generate_1.generateCommand)());
+program.addCommand((0, validate_1.validateCommand)());
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,yCAAmC;AACnC,kDAAqD;AACrD,kDAAqD;AAErD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,mBAAmB,CAAC;KACzB,WAAW,CACV,6EAA6E;IAC3E,wEAAwE;IACxE,uEAAuE,CAC1E;KACA,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,OAAO,CAAC,UAAU,CAAC,IAAA,0BAAe,GAAE,CAAC,CAAA;AACrC,OAAO,CAAC,UAAU,CAAC,IAAA,0BAAe,GAAE,CAAC,CAAA;AAErC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/mapping/name-classifier.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Target file categories for schema outputs.
+ * - `payloads` → `payloads.ts` (request body types: create, update, batch, etc.)
+ * - `queries`  → `queries.ts` (query parameter types: list, filter, select params)
+ * - `skip`     → do not generate a type for this schema
+ */
+export type FileTarget = "payloads" | "queries" | "skip";
+/**
+ * Classifies Zod schema export names into the appropriate output file category.
+ */
+export declare class NameClassifier {
+    /**
+     * Patterns in the schema name that indicate a query/filter type.
+     * These go into `queries.ts`.
+     */
+    private static readonly QUERY_PATTERNS;
+    /**
+     * Patterns in the schema name that indicate a payload type.
+     * These go into `payloads.ts`.
+     */
+    private static readonly PAYLOAD_PATTERNS;
+    /**
+     * These intermediate/internal helper schemas should not generate HTTP types.
+     */
+    private static readonly SKIP_PATTERNS;
+    /**
+     * Classifies a Zod schema export name into the appropriate output file category.
+     *
+     * @param name - The exported variable name from the validator file.
+     * @returns The target file category. Returns "skip" if no type should be generated for this schema.
+     */
+    static classify(name: string): FileTarget;
+}
+//# sourceMappingURL=name-classifier.d.ts.map

package/dist/mapping/name-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-classifier.d.ts","sourceRoot":"","sources":["../../src/mapping/name-classifier.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAA;AAExD;;GAEG;AACH,qBAAa,cAAc;IACzB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAKrC;IAED;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CASvC;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAMpC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;CAyB1C"}

package/dist/mapping/name-classifier.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NameClassifier = void 0;
+const config_1 = require("../config");
+/**
+ * Classifies Zod schema export names into the appropriate output file category.
+ */
+class NameClassifier {
+    /**
+     * Classifies a Zod schema export name into the appropriate output file category.
+     *
+     * @param name - The exported variable name from the validator file.
+     * @returns The target file category. Returns "skip" if no type should be generated for this schema.
+     */
+    static classify(name) {
+        // Must have one of the configured public prefixes to be an HTTP type
+        const prefixes = config_1.Config.get().publicPrefixes;
+        if (!prefixes.some((prefix) => name.startsWith(prefix))) {
+            return "skip";
+        }
+        // Skip intermediate/helper schemas
+        if (NameClassifier.SKIP_PATTERNS.some((p) => p.test(name))) {
+            return "skip";
+        }
+        // Check if it's a query/filter type
+        if (NameClassifier.QUERY_PATTERNS.some((p) => p.test(name))) {
+            return "queries";
+        }
+        // Check if it's a payload type
+        if (NameClassifier.PAYLOAD_PATTERNS.some((p) => p.test(name))) {
+            return "payloads";
+        }
+        // Default: treat as a payload type
+        return "payloads";
+    }
+}
+exports.NameClassifier = NameClassifier;
+/**
+ * Patterns in the schema name that indicate a query/filter type.
+ * These go into `queries.ts`.
+ */
+NameClassifier.QUERY_PATTERNS = [
+    /Params$/,
+    /Filters?$/,
+    /ListParams$/,
+    /FilterFields$/,
+];
+/**
+ * Patterns in the schema name that indicate a payload type.
+ * These go into `payloads.ts`.
+ */
+NameClassifier.PAYLOAD_PATTERNS = [
+    /Create[A-Z]/,
+    /Update[A-Z]/,
+    /Batch[A-Z]/,
+    /Import[A-Z]/,
+    /Export[A-Z]/,
+    /Link[A-Z]/,
+    /[A-Z]Request$/,
+    /[A-Z]Payload$/,
+];
+/**
+ * These intermediate/internal helper schemas should not generate HTTP types.
+ */
+NameClassifier.SKIP_PATTERNS = [
+    /ParamsFields$/,
+    /ParamsDirectFields$/,
+    /ParamsBase$/,
+    /ParamsTransform$/,
+    /Schema$/,
+];
+//# sourceMappingURL=name-classifier.js.map

package/dist/mapping/name-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-classifier.js","sourceRoot":"","sources":["../../src/mapping/name-classifier.ts"],"names":[],"mappings":";;;AAAA,sCAAkC;AAUlC;;GAEG;AACH,MAAa,cAAc;IAsCzB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,qEAAqE;QACrE,MAAM,QAAQ,GAAG,eAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAA;QAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,mCAAmC;QACnC,IAAI,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,MAAM,CAAA;QACf,CAAC;QAED,oCAAoC;QACpC,IAAI,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC5D,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,+BAA+B;QAC/B,IAAI,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9D,OAAO,UAAU,CAAA;QACnB,CAAC;QAED,mCAAmC;QACnC,OAAO,UAAU,CAAA;IACnB,CAAC;;AApEH,wCAqEC;AApEC;;;GAGG;AACqB,6BAAc,GAAG;IACvC,SAAS;IACT,WAAW;IACX,aAAa;IACb,eAAe;CAChB,CAAA;AAED;;;GAGG;AACqB,+BAAgB,GAAG;IACzC,aAAa;IACb,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;IACb,WAAW;IACX,eAAe;IACf,eAAe;CAChB,CAAA;AAED;;GAEG;AACqB,4BAAa,GAAG;IACtC,eAAe;IACf,qBAAqB;IACrB,aAAa;IACb,kBAAkB;IAClB,SAAS;CACV,CAAA"}