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

package/dist/utils/ts-helpers.js

@@ -0,0 +1,216 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsHelpers = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+class TsHelpers {
+    /**
+     * 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) {
+        const inputProp = type.getProperty("_input");
+        const outputProp = type.getProperty("_output");
+        return !!(inputProp && outputProp);
+    }
+    /**
+     * 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, type) {
+        const symbol = type.getSymbol();
+        if (symbol) {
+            return symbol.getName() === "ZodEffects";
+        }
+        const typeStr = checker.typeToString(type);
+        return typeStr.trimStart().startsWith("ZodEffects<");
+    }
+    /**
+     * 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, zodType) {
+        const inputSymbol = zodType.getProperty("_input");
+        if (!inputSymbol) {
+            return undefined;
+        }
+        return checker.getTypeOfSymbol(inputSymbol);
+    }
+    /**
+     * Resolves the `_output` type of a Zod schema — the post-transform inferred type,
+     * equivalent to `z.infer<typeof schema>`.
+     */
+    static getZodOutputType(checker, zodType) {
+        const outputSymbol = zodType.getProperty("_output");
+        if (!outputSymbol) {
+            return undefined;
+        }
+        return checker.getTypeOfSymbol(outputSymbol);
+    }
+    /**
+     * Returns true if a type has OperatorMap member properties ($eq, $ne, $in, etc.).
+     */
+    static isOperatorMapMember(type) {
+        const props = type.getProperties().map((p) => p.name);
+        const matchCount = TsHelpers.OPERATOR_MAP_PROPS.filter((op) => props.includes(op)).length;
+        return matchCount >= 4;
+    }
+    /**
+     * 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) {
+        if (type.isUnion()) {
+            return type.types.some((t) => TsHelpers.isOperatorMapMember(t));
+        }
+        return TsHelpers.isOperatorMapMember(type);
+    }
+    /**
+     * Returns a simplified display string for a TypeScript type, suitable for
+     * use in error messages and diagnostics.
+     */
+    static typeToDisplayString(checker, type) {
+        return checker.typeToString(type, undefined, typescript_1.default.TypeFormatFlags.NoTruncation |
+            typescript_1.default.TypeFormatFlags.UseFullyQualifiedType);
+    }
+    /**
+     * Recursively walks a call expression chain to check if any call in the chain
+     * uses the given function name.
+     */
+    static callChainIncludes(node, funcName) {
+        if (typescript_1.default.isCallExpression(node)) {
+            const expr = node.expression;
+            if (typescript_1.default.isIdentifier(expr) && expr.text === funcName) {
+                return true;
+            }
+            if (typescript_1.default.isPropertyAccessExpression(expr) &&
+                expr.name.text === funcName) {
+                return true;
+            }
+            return TsHelpers.callChainIncludes(expr, funcName);
+        }
+        if (typescript_1.default.isPropertyAccessExpression(node)) {
+            return TsHelpers.callChainIncludes(node.expression, funcName);
+        }
+        return false;
+    }
+    /**
+     * Returns true if the given type is plain `string` (not a literal or union).
+     */
+    static isPlainString(type) {
+        return !!(type.flags & typescript_1.default.TypeFlags.String);
+    }
+    /**
+     * Returns true if the type is a string literal or a union of string literals.
+     */
+    static isStringLiteralOrUnion(type) {
+        if (type.flags & typescript_1.default.TypeFlags.StringLiteral) {
+            return true;
+        }
+        if (type.isUnion()) {
+            return type.types.every((t) => !!(t.flags & typescript_1.default.TypeFlags.StringLiteral));
+        }
+        return false;
+    }
+    /**
+     * Returns true if the type is a TypeScript string enum or a union of string
+     * enum literals.
+     */
+    static isStringEnumType(type) {
+        if (type.flags & typescript_1.default.TypeFlags.EnumLiteral &&
+            type.flags & typescript_1.default.TypeFlags.StringLiteral) {
+            return true;
+        }
+        if (type.isUnion()) {
+            return type.types.every((t) => t.flags & typescript_1.default.TypeFlags.EnumLiteral &&
+                t.flags & typescript_1.default.TypeFlags.StringLiteral);
+        }
+        return false;
+    }
+    /**
+     * Returns the set of string values from a string literal type or a union of
+     * string literals.
+     */
+    static getStringLiteralValues(type) {
+        const values = new Set();
+        if (type.flags & typescript_1.default.TypeFlags.StringLiteral) {
+            values.add(type.value);
+        }
+        else if (type.isUnion()) {
+            for (const t of type.types) {
+                if (t.flags & typescript_1.default.TypeFlags.StringLiteral) {
+                    values.add(t.value);
+                }
+            }
+        }
+        return values;
+    }
+    /**
+     * Checks whether the given node has an `export` modifier.
+     */
+    static isExported(node) {
+        return (typescript_1.default.canHaveModifiers(node) &&
+            (typescript_1.default.getModifiers(node) ?? []).some((mod) => mod.kind === typescript_1.default.SyntaxKind.ExportKeyword));
+    }
+    /**
+     * Returns the first VariableDeclaration inside a VariableStatement.
+     */
+    static getVariableDeclaration(stmt) {
+        return stmt.declarationList.declarations[0];
+    }
+    /**
+     * Reads the `@http-type-name` JSDoc tag value from the leading comments
+     * of a VariableStatement node, if present.
+     */
+    static readHttpTypeNameTag(node, sourceFile) {
+        const jsDocTags = typescript_1.default.getJSDocTags(node);
+        for (const tag of jsDocTags) {
+            if (tag.tagName.text === "http-type-name") {
+                const comment = tag.comment;
+                if (typeof comment === "string") {
+                    return comment.trim();
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Given a call expression like `WithAdditionalData(CreateCustomer)`,
+     * returns the text of the first argument identifier ("CreateCustomer").
+     */
+    static getFirstCallArgName(node) {
+        const initializer = node.initializer;
+        if (!initializer || !typescript_1.default.isCallExpression(initializer)) {
+            return undefined;
+        }
+        const firstArg = initializer.arguments[0];
+        if (!firstArg || !typescript_1.default.isIdentifier(firstArg)) {
+            return undefined;
+        }
+        return firstArg.text;
+    }
+    /**
+     * Checks whether a TypeScript type is a function type (as opposed to an object/Zod type).
+     */
+    static isFunctionType(type) {
+        const callSignatures = type.getCallSignatures();
+        return callSignatures.length > 0;
+    }
+}
+exports.TsHelpers = TsHelpers;
+TsHelpers.OPERATOR_MAP_PROPS = [
+    "$eq",
+    "$ne",
+    "$in",
+    "$nin",
+    "$gt",
+    "$gte",
+    "$lt",
+    "$lte",
+];
+//# sourceMappingURL=ts-helpers.js.map

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

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@medusajs/http-types-generator",
+  "version": "2.13.6-preview-20260402101111",
+  "description": "Generate and validate HTTP TypeScript types",
+  "main": "dist/index.js",
+  "bin": {
+    "medusa-http-types": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/medusajs/medusa",
+    "directory": "packages/cli/http-types-generator"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Medusa",
+  "license": "MIT",
+  "scripts": {
+    "build": "yarn run -T tsc --build",
+    "watch": "yarn run -T tsc --watch",
+    "test": "../../../node_modules/.bin/jest --passWithNoTests --bail --forceExit --testPathPattern=src",
+    "generate:http-types": "node dist/index.js generate",
+    "validate:http-types": "node dist/index.js validate --ci"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "glob": "11.1.0",
+    "pluralize": "^8.0.0",
+    "prettier": "^2.8.8",
+    "typescript": "^5.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.11",
+    "@types/pluralize": "^0.0.33"
+  }
+}