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

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

@@ -0,0 +1,54 @@
+/**
+ * Static map of Zod validator export names → HTTP type interface names,
+ * for cases where the naming convention differs between the two.
+ *
+ * Most schemas follow the same name (AdminCreateProduct → AdminCreateProduct),
+ * but query/filter schemas often differ (AdminGetProductsParams → AdminProductListParams).
+ *
+ * When adding new validator schemas, prefer adding a `@http-type-name` JSDoc
+ * tag in the validator file instead of adding to this registry. This registry
+ * is only meant to remain backward-compatible with existing schemas that predate this tool.
+ *
+ * @example
+ * ```typescript
+ * // packages/medusa/src/api/admin/products/validators.ts
+ * /** @http-type-name AdminProductListParams *\/
+ * export const AdminGetProductsParams = createFindParams(...)
+ * ```
+ */
+export declare const VALIDATOR_TO_HTTP_TYPE_NAME: Record<string, string>;
+/**
+ * Domain-scoped name overrides: used when the same Zod export name appears
+ * in multiple validator files with different schemas. This is only
+ * meant to remain backward-compatible with existing schemas that predate this tool.
+ *
+ * Key format: routeDirName (as it appears in the API path, e.g. "exchanges")
+ * Value: map of Zod export name → HTTP type name (or "skip" to skip entirely)
+ */
+export declare const DOMAIN_SCOPED_OVERRIDES: Record<string, Record<string, string>>;
+/**
+ * Reverse lookup: HTTP type name → validator export name.
+ * Used by the validate command to find the Zod schema for a given HTTP type.
+ */
+export declare const HTTP_TYPE_TO_VALIDATOR_NAME: Record<string, string>;
+/**
+ * Resolves HTTP type names for validator export names and vice versa.
+ */
+export declare class NameRegistry {
+    /**
+     * Resolves the HTTP type name for a given validator export name.
+     * Falls back to the export name itself if no override is registered.
+     *
+     * @param exportName - The Zod validator export name.
+     * @param domain - Optional route directory name (e.g. "exchanges", "claims").
+     *   When provided, domain-scoped overrides take precedence over global mappings.
+     *   Returns "skip" if the export should be excluded from validation in this domain.
+     */
+    static resolveHttpTypeName(exportName: string, domain?: string): string;
+    /**
+     * Resolves the validator export name for a given HTTP type name.
+     * Falls back to the HTTP type name itself if no mapping is registered.
+     */
+    static resolveValidatorName(httpTypeName: string): string;
+}
+//# sourceMappingURL=name-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"name-registry.d.ts","sourceRoot":"","sources":["../../src/mapping/name-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4N9D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB1E,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG5D,CAAA;AAEH;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;;OAQG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAUvE;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAG1D"}

package/dist/mapping/name-registry.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NameRegistry = exports.HTTP_TYPE_TO_VALIDATOR_NAME = exports.DOMAIN_SCOPED_OVERRIDES = exports.VALIDATOR_TO_HTTP_TYPE_NAME = void 0;
+/**
+ * Static map of Zod validator export names → HTTP type interface names,
+ * for cases where the naming convention differs between the two.
+ *
+ * Most schemas follow the same name (AdminCreateProduct → AdminCreateProduct),
+ * but query/filter schemas often differ (AdminGetProductsParams → AdminProductListParams).
+ *
+ * When adding new validator schemas, prefer adding a `@http-type-name` JSDoc
+ * tag in the validator file instead of adding to this registry. This registry
+ * is only meant to remain backward-compatible with existing schemas that predate this tool.
+ *
+ * @example
+ * ```typescript
+ * // packages/medusa/src/api/admin/products/validators.ts
+ * /** @http-type-name AdminProductListParams *\/
+ * export const AdminGetProductsParams = createFindParams(...)
+ * ```
+ */
+exports.VALIDATOR_TO_HTTP_TYPE_NAME = {
+    // ----------- customers -----------
+    AdminCustomersParams: "AdminCustomerFilters",
+    AdminCustomerAddressesParams: "AdminCustomerAddressFilters",
+    // ----------- products -----------
+    AdminGetProductsParams: "AdminProductListParams",
+    AdminGetProductOptionsParams: "AdminProductOptionParams",
+    AdminGetProductVariantsParams: "AdminProductVariantParams",
+    // Singular GET params (createSelectParams) for single-item fetches
+    AdminGetProductVariantParams: "AdminProductVariantParams",
+    AdminGetProductOptionParams: "AdminProductOptionParams",
+    // Payload schemas with different HTTP type names
+    AdminCreateVariantPrice: "AdminCreateProductVariantPrice",
+    AdminBatchImageVariant: "AdminBatchImageVariantRequest",
+    AdminBatchVariantImages: "AdminBatchVariantImagesRequest",
+    AdminImportProducts: "AdminImportProductsRequest",
+    // ----------- orders -----------
+    AdminGetOrdersParams: "AdminOrderFilters",
+    AdminGetOrdersOrderParams: "AdminGetOrderParams",
+    AdminGetOrdersOrderItemsParams: "AdminOrderItemsFilters",
+    AdminOrderChangesParams: "AdminOrderChangesFilters",
+    // Order action payloads with different HTTP type names
+    AdminOrderCreateFulfillment: "AdminCreateOrderFulfillment",
+    AdminOrderCreateShipment: "AdminCreateOrderShipment",
+    AdminOrderCancelFulfillment: "AdminCancelOrderFulfillment",
+    AdminTransferOrder: "AdminRequestOrderTransfer",
+    AdminCreateOrderCreditLines: "AdminCreateOrderCreditLine",
+    // ----------- returns -----------
+    AdminGetReturnParams: "AdminReturnFilters",
+    // ----------- return-reasons -----------
+    AdminGetReturnReasonsReturnReasonParams: "AdminReturnReasonParams",
+    AdminGetReturnReasonsParams: "AdminReturnReasonListParams",
+    // ----------- refund-reasons -----------
+    AdminCreatePaymentRefundReason: "AdminCreateRefundReason",
+    AdminUpdatePaymentRefundReason: "AdminUpdateRefundReason",
+    AdminGetRefundReasonsParams: "AdminRefundReasonListParams",
+    AdminGetRefundReasonParams: "AdminRefundReasonParams",
+    // ----------- carts -----------
+    StoreGetCartParams: "StoreCartParams",
+    // ----------- regions -----------
+    AdminGetRegionsParams: "AdminRegionFilters",
+    // ----------- shipping options -----------
+    AdminGetShippingOptionsParams: "AdminShippingOptionListParams",
+    AdminGetShippingOptionTypesParams: "AdminShippingOptionTypeListParams",
+    AdminCreateShippingOptionTypeObject: "AdminCreateShippingOptionType",
+    // ----------- shipping-profiles -----------
+    AdminGetShippingProfilesParams: "AdminShippingProfileListParams",
+    // ----------- collections -----------
+    AdminGetCollectionsParams: "AdminCollectionListParams",
+    StoreGetCollectionsParams: "StoreCollectionListParams",
+    StoreGetCollectionParams: "StoreCollectionParams",
+    // ----------- currencies -----------
+    AdminGetCurrenciesParams: "AdminCurrencyListParams",
+    StoreGetCurrenciesParams: "StoreGetCurrencyListParams",
+    // ----------- locales -----------
+    AdminGetLocalesParams: "AdminLocaleListParams",
+    // ----------- notifications -----------
+    AdminGetNotificationsParams: "AdminNotificationListParams",
+    // ----------- payments -----------
+    AdminGetPaymentsParams: "AdminPaymentFilters",
+    // ----------- product-categories -----------
+    AdminProductCategoriesParams: "AdminProductCategoryListParams",
+    StoreProductCategoriesParams: "StoreProductCategoryListParams",
+    // ----------- product-tags -----------
+    AdminGetProductTagsParams: "AdminProductTagListParams",
+    StoreProductTagsParams: "StoreProductTagListParams",
+    // ----------- product-types -----------
+    AdminGetProductTypesParams: "AdminProductTypeListParams",
+    StoreProductTypesParams: "StoreProductTypeListParams",
+    // ----------- product-variants -----------
+    StoreGetProductVariantsParams: "StoreProductVariantParams",
+    // ----------- price-preferences -----------
+    AdminGetPricePreferencesParams: "AdminPricePreferenceListParams",
+    // ----------- products -----------
+    StoreGetProductsParams: "StoreProductListParams",
+    // ----------- regions -----------
+    StoreGetRegionsParams: "StoreRegionFilters",
+    // ----------- shipping-options -----------
+    StoreGetShippingOptions: "StoreGetShippingOptionList",
+    // ----------- orders -----------
+    StoreGetOrdersParams: "StoreOrderFilters",
+    // ----------- customers (store) -----------
+    StoreGetCustomerAddressesParams: "StoreCustomerAddressFilters",
+    // ----------- price lists -----------
+    AdminGetPriceListsParams: "AdminPriceListListParams",
+    AdminGetPriceListParams: "AdminPriceListParams",
+    AdminGetPriceListPricesParams: "AdminPriceListPriceListParams",
+    // ----------- inventory items -----------
+    AdminGetInventoryItemsParams: "AdminInventoryItemsParams",
+    // ----------- sales-channels -----------
+    AdminGetSalesChannelsParams: "AdminSalesChannelListParams",
+    // ----------- stock-locations -----------
+    AdminGetStockLocationsParams: "AdminStockLocationListParams",
+    // ----------- reservations -----------
+    AdminGetReservationParams: "AdminReservationParams",
+    // ----------- stores -----------
+    AdminGetStoreParams: "AdminStoreParams",
+    AdminGetStoresParams: "AdminStoreListParams",
+    // ----------- tax-rates -----------
+    AdminGetTaxRatesParams: "AdminTaxRateListParams",
+    // ----------- tax-regions -----------
+    AdminGetTaxRegionParams: "AdminTaxRegionParams",
+    AdminGetTaxRegionsParams: "AdminTaxRegionListParams",
+    // ----------- users -----------
+    AdminGetUserParams: "AdminUserParams",
+    AdminGetUsersParams: "AdminUserListParams",
+    // ----------- file/uploads -----------
+    AdminUploadPreSignedUrl: "AdminUploadPreSignedUrlRequest",
+    // ----------- translations -----------
+    AdminGetTranslationsParams: "AdminTranslationsListParams",
+    AdminTranslationStatistics: "AdminTranslationStatisticsParams",
+    // ----------- draft-orders -----------
+    AdminGetDraftOrdersParams: "AdminDraftOrderListParams",
+    AdminGetDraftOrderParams: "AdminDraftOrderParams",
+    // ----------- exchanges -----------
+    AdminGetExchangeParams: "AdminExchangeListParams",
+    // ----------- fulfillment-providers -----------
+    AdminFulfillmentProvidersParams: "AdminGetFulfillmentProvidersParams",
+    // ----------- fulfillment-sets -----------
+    AdminFulfillmentSetParams: "AdminFulfillmentSetListParams",
+    // ----------- inventory-levels -----------
+    AdminGetInventoryLocationLevelsParams: "AdminInventoryLevelFilters",
+    // ----------- locales -----------
+    AdminGetLocaleParams: "AdminLocaleParams",
+    // ----------- payment-providers (store) -----------
+    StoreGetPaymentProvidersParams: "StorePaymentProviderFilters",
+    // ----------- currencies (admin) -----------
+    AdminGetCurrencyParams: "AdminCurrencyParams",
+    // ----------- products (store) -----------
+    StoreGetProductParams: "StoreProductParams",
+    // ----------- collections (single-item GET params) -----------
+    AdminGetCollectionParams: "AdminCollectionParams",
+    // ----------- notifications (single-item GET params) -----------
+    AdminGetNotificationParams: "AdminNotificationParams",
+    // ----------- product-tags (single-item GET params) -----------
+    AdminGetProductTagParams: "AdminProductTagParams",
+    // ----------- product-types (single-item GET params) -----------
+    AdminGetProductTypeParams: "AdminProductTypeParams",
+    // ----------- payment payloads with different HTTP type names -----------
+    AdminCreatePaymentCapture: "AdminCapturePayment",
+    AdminCreatePaymentRefund: "AdminRefundPayment",
+    AdminMarkPaymentCollectionPaid: "AdminMarkPaymentCollectionAsPaid",
+    // ----------- fulfillment payloads -----------
+    AdminCreateShipment: "AdminCreateFulfillmentShipment",
+    // ----------- invite payloads -----------
+    AdminInviteAccept: "AdminAcceptInvite",
+    // ----------- inventory level payloads -----------
+    AdminUpdateInventoryLocationLevel: "AdminUpdateInventoryLevel",
+    AdminCreateInventoryLocationLevel: "AdminBatchCreateInventoryItemLocationLevels",
+    AdminUpdateInventoryLocationLevelBatch: "AdminBatchUpdateInventoryItemLocationLevels",
+    AdminBatchInventoryItemLocationsLevel: "AdminBatchInventoryItemLocationLevels",
+    AdminBatchInventoryItemLevels: "AdminBatchInventoryItemsLocationLevels",
+    // ----------- cart (store) payloads -----------
+    StoreAddCartPromotions: "StoreCartAddPromotion",
+    StoreRemoveCartPromotions: "StoreCartRemovePromotion",
+    // ----------- order (store) payloads -----------
+    StoreDeclineOrderTransferRequest: "StoreDeclineOrderTransfer",
+    // ----------- payment (store) queries -----------
+    StoreGetPaymentCollectionParams: "StorePaymentCollectionFilters",
+    // ----------- payment-session (store) payloads -----------
+    StoreCreatePaymentSession: "StoreInitializePaymentSession",
+    // ----------- shipping-options (store) -----------
+    StoreGetShippingOptionsParams: "StoreGetShippingOptionList",
+};
+/**
+ * Domain-scoped name overrides: used when the same Zod export name appears
+ * in multiple validator files with different schemas. This is only
+ * meant to remain backward-compatible with existing schemas that predate this tool.
+ *
+ * Key format: routeDirName (as it appears in the API path, e.g. "exchanges")
+ * Value: map of Zod export name → HTTP type name (or "skip" to skip entirely)
+ */
+exports.DOMAIN_SCOPED_OVERRIDES = {
+    // The exchange, claim, and return validator files re-export AdminGetOrdersOrderParams
+    // and AdminGetOrdersParams with domain-specific filter fields. These must be mapped
+    // to the correct domain HTTP types, not the global order types.
+    // Note: domain keys here are the MAPPED names from path-mapper (singular/normalized).
+    exchange: {
+        AdminGetOrdersOrderParams: "AdminOrderExchangeListParams",
+        AdminGetOrdersParams: "AdminExchangeListParams",
+    },
+    claim: {
+        AdminGetOrdersOrderParams: "AdminClaimActionsParams",
+        AdminGetOrdersParams: "AdminClaimListParams",
+    },
+    return: {
+        // No matching single-select HTTP type for returns; skip it.
+        AdminGetOrdersOrderParams: "skip",
+        // Returns list uses AdminReturnFilters (already in global registry, but
+        // listing here explicitly to document the domain context).
+        AdminGetOrdersParams: "AdminReturnFilters",
+    },
+};
+/**
+ * Reverse lookup: HTTP type name → validator export name.
+ * Used by the validate command to find the Zod schema for a given HTTP type.
+ */
+exports.HTTP_TYPE_TO_VALIDATOR_NAME = Object.fromEntries(Object.entries(exports.VALIDATOR_TO_HTTP_TYPE_NAME).map(([k, v]) => [v, k]));
+/**
+ * Resolves HTTP type names for validator export names and vice versa.
+ */
+class NameRegistry {
+    /**
+     * Resolves the HTTP type name for a given validator export name.
+     * Falls back to the export name itself if no override is registered.
+     *
+     * @param exportName - The Zod validator export name.
+     * @param domain - Optional route directory name (e.g. "exchanges", "claims").
+     *   When provided, domain-scoped overrides take precedence over global mappings.
+     *   Returns "skip" if the export should be excluded from validation in this domain.
+     */
+    static resolveHttpTypeName(exportName, domain) {
+        if (domain) {
+            const domainOverride = exports.DOMAIN_SCOPED_OVERRIDES[domain]?.[exportName];
+            if (domainOverride !== undefined) {
+                return domainOverride;
+            }
+        }
+        return exports.VALIDATOR_TO_HTTP_TYPE_NAME[exportName] ?? exportName;
+    }
+    /**
+     * Resolves the validator export name for a given HTTP type name.
+     * Falls back to the HTTP type name itself if no mapping is registered.
+     */
+    static resolveValidatorName(httpTypeName) {
+        return exports.HTTP_TYPE_TO_VALIDATOR_NAME[httpTypeName] ?? httpTypeName;
+    }
+}
+exports.NameRegistry = NameRegistry;
+//# sourceMappingURL=name-registry.js.map

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

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

package/dist/mapping/path-mapper.d.ts

@@ -0,0 +1,62 @@
+export interface PathMapping {
+    /** The API area (e.g. "admin", "store") */
+    area: string;
+    /** Domain name in kebab-case as it appears in the HTTP types directory. e.g. "product" */
+    domain: string;
+    /** Absolute path to the HTTP types directory for this domain+area */
+    outputDir: string;
+    /** Absolute path to the output payloads.ts file */
+    payloadsFile: string;
+    /** Absolute path to the output queries.ts file */
+    queriesFile: string;
+}
+/**
+ * Maps validator file paths to HTTP types output paths and resolves domain names.
+ */
+export declare class PathMapper {
+    /**
+     * Maps route directory names to HTTP types domain names only when the mapping
+     * cannot be derived by singularizing the last hyphen-segment.
+     *
+     * Most route dirs (e.g. "products" → "product", "sales-channels" → "sales-channel")
+     * are handled automatically by `singularizeRouteName`. Only entries with a
+     * fundamentally different domain belong here.
+     *
+     * This list is only meant to remain backward-compatible with existing schemas that predate this tool.
+     * When adding new validator schemas, prefer structuring the route and domain names
+     * to fit the automatic singularization logic and avoid adding to this registry.
+     */
+    private static readonly ENTITY_NAME_OVERRIDES;
+    /**
+     * Derives the domain name from a route directory name by singularizing its
+     * last hyphen-separated segment (e.g. "sales-channels" → "sales-channel",
+     * "product-categories" → "product-category").
+     */
+    private static singularizeRouteName;
+    /**
+     * Computes the PathMapping for a given validator file path.
+     *
+     * @param validatorFilePath - Absolute path to the validators.ts file.
+     * @returns PathMapping or undefined if the path cannot be mapped.
+     */
+    static mapValidatorToHttpTypes(validatorFilePath: string): PathMapping | undefined;
+    /**
+     * Returns glob patterns for all validator files in the given area(s).
+     * Pass `"all"` to get globs for every configured area.
+     */
+    static getValidatorGlobs(area: string): string[];
+    /**
+     * Returns the absolute path to the HTTP types directory for a given domain.
+     */
+    static getHttpTypesDir(domain: string): string;
+    /**
+     * Resolves the HTTP types domain name for a given validator route directory name,
+     * applying overrides and singularization as needed.
+     */
+    static resolveHttpDomain(routeDirName: string): string;
+    /**
+     * Filters a list of validator file paths to only those matching the given domain name.
+     */
+    static filterValidatorsByDomain(files: string[], domain: string): string[];
+}
+//# sourceMappingURL=path-mapper.d.ts.map

package/dist/mapping/path-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-mapper.d.ts","sourceRoot":"","sources":["../../src/mapping/path-mapper.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAW5C;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAMnC;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAC5B,iBAAiB,EAAE,MAAM,GACxB,WAAW,GAAG,SAAS;IAuB1B;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAehD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9C;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAOtD;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;CAO3E"}

package/dist/mapping/path-mapper.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathMapper = void 0;
+const path_1 = __importDefault(require("path"));
+const pluralize_1 = __importDefault(require("pluralize"));
+const fs_helpers_1 = require("../utils/fs-helpers");
+const config_1 = require("../config");
+/**
+ * Maps validator file paths to HTTP types output paths and resolves domain names.
+ */
+class PathMapper {
+    /**
+     * Derives the domain name from a route directory name by singularizing its
+     * last hyphen-separated segment (e.g. "sales-channels" → "sales-channel",
+     * "product-categories" → "product-category").
+     */
+    static singularizeRouteName(routeDirName) {
+        const parts = routeDirName.split("-");
+        parts[parts.length - 1] = pluralize_1.default.singular(parts[parts.length - 1]);
+        return parts.join("-");
+    }
+    /**
+     * Computes the PathMapping for a given validator file path.
+     *
+     * @param validatorFilePath - Absolute path to the validators.ts file.
+     * @returns PathMapping or undefined if the path cannot be mapped.
+     */
+    static mapValidatorToHttpTypes(validatorFilePath) {
+        const normalized = validatorFilePath.replace(/\\/g, "/");
+        const pattern = new RegExp(config_1.Config.get().validatorPathPattern);
+        const match = normalized.match(pattern);
+        if (!match || !match[1] || !match[2]) {
+            return undefined;
+        }
+        const area = match[1];
+        const routeDirName = match[2];
+        const domain = PathMapper.resolveHttpDomain(routeDirName);
+        const outputDir = fs_helpers_1.FsHelpers.fromRoot(config_1.Config.get().outputBase, domain, area);
+        return {
+            area,
+            domain,
+            outputDir,
+            payloadsFile: path_1.default.join(outputDir, "payloads.ts"),
+            queriesFile: path_1.default.join(outputDir, "queries.ts"),
+        };
+    }
+    /**
+     * Returns glob patterns for all validator files in the given area(s).
+     * Pass `"all"` to get globs for every configured area.
+     */
+    static getValidatorGlobs(area) {
+        const globs = config_1.Config.get().validatorGlobs;
+        const root = fs_helpers_1.FsHelpers.fromRoot();
+        if (area === "all") {
+            return Object.values(globs).map((g) => path_1.default.join(root, g));
+        }
+        const pattern = globs[area];
+        if (!pattern) {
+            return [];
+        }
+        return [path_1.default.join(root, pattern)];
+    }
+    /**
+     * Returns the absolute path to the HTTP types directory for a given domain.
+     */
+    static getHttpTypesDir(domain) {
+        return fs_helpers_1.FsHelpers.fromRoot(config_1.Config.get().outputBase, domain);
+    }
+    /**
+     * Resolves the HTTP types domain name for a given validator route directory name,
+     * applying overrides and singularization as needed.
+     */
+    static resolveHttpDomain(routeDirName) {
+        return (PathMapper.ENTITY_NAME_OVERRIDES[routeDirName] ??
+            PathMapper.singularizeRouteName(routeDirName));
+    }
+    /**
+     * Filters a list of validator file paths to only those matching the given domain name.
+     */
+    static filterValidatorsByDomain(files, domain) {
+        const pattern = new RegExp(config_1.Config.get().validatorPathPattern);
+        return files.filter((f) => {
+            const match = f.replace(/\\/g, "/").match(pattern);
+            return match && match[2] === domain;
+        });
+    }
+}
+exports.PathMapper = PathMapper;
+/**
+ * Maps route directory names to HTTP types domain names only when the mapping
+ * cannot be derived by singularizing the last hyphen-segment.
+ *
+ * Most route dirs (e.g. "products" → "product", "sales-channels" → "sales-channel")
+ * are handled automatically by `singularizeRouteName`. Only entries with a
+ * fundamentally different domain belong here.
+ *
+ * This list is only meant to remain backward-compatible with existing schemas that predate this tool.
+ * When adding new validator schemas, prefer structuring the route and domain names
+ * to fit the automatic singularization logic and avoid adding to this registry.
+ */
+PathMapper.ENTITY_NAME_OVERRIDES = {
+    addresses: "customer", // part of customer
+    "auth-providers": "auth",
+    "inventory-items": "inventory",
+    "order-changes": "order", // part of order
+    "payment-collections": "payment",
+    plugins: "plugins", // intentionally stays plural
+    "product-variants": "product", // variants live under product
+    "stock-locations": "stock-locations", // intentionally stays plural
+    uploads: "file",
+    "workflows-executions": "workflow-execution", // both segments are plural
+};
+//# sourceMappingURL=path-mapper.js.map

package/dist/mapping/path-mapper.js.map

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

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/index.ts","../src/__tests__/compatibility-checker.spec.ts","../src/__tests__/config.spec.ts","../src/__tests__/import-tracker.spec.ts","../src/__tests__/name-classifier.spec.ts","../src/__tests__/name-registry.spec.ts","../src/__tests__/path-mapper.spec.ts","../src/__tests__/type-emitter.spec.ts","../src/__tests__/type-pipeline.spec.ts","../src/__tests__/utils/ts-utils.ts","../src/commands/generate.ts","../src/commands/validate.ts","../src/config/index.ts","../src/core/compatibility-checker.ts","../src/core/import-tracker.ts","../src/core/program-factory.ts","../src/core/schema-extractor.ts","../src/core/type-emitter.ts","../src/core/type-resolver.ts","../src/mapping/name-classifier.ts","../src/mapping/name-registry.ts","../src/mapping/path-mapper.ts","../src/utils/file-merger.ts","../src/utils/formatter.ts","../src/utils/fs-helpers.ts","../src/utils/index-manager.ts","../src/utils/ts-helpers.ts"],"version":"5.9.3"}

package/dist/utils/file-merger.d.ts

@@ -0,0 +1,47 @@
+import type { EmittedInterface } from "../core/type-emitter";
+import type { ImportTracker } from "../core/import-tracker";
+export type MergeStatus = "created" | "updated" | "skipped" | "overwritten";
+export interface MergeResult {
+    content: string;
+    status: MergeStatus;
+    /** Number of interfaces added (0 for skipped/overwritten) */
+    added: number;
+}
+/**
+ * Decides whether to create, merge, or overwrite a type file.
+ */
+export declare 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.
+     */
+    resolveFileContent(file: string, interfaces: EmittedInterface[], importTracker: ImportTracker, force: boolean): Promise<MergeResult>;
+    /**
+     * 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.
+     */
+    private parseImportLine;
+    /**
+     * Merges two sets of import lines, combining named imports for the same
+     * source so we never emit duplicate import statements.
+     */
+    private mergeImportLines;
+    /**
+     * Scans `content` for `export interface Name ...` blocks and returns a map
+     * from interface name to the full block text.
+     */
+    private extractInterfaceBlocks;
+    /**
+     * Extracts all `import ...` lines from the file content.
+     */
+    private extractImportLines;
+}
+//# sourceMappingURL=file-merger.d.ts.map

package/dist/utils/file-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-merger.d.ts","sourceRoot":"","sources":["../../src/utils/file-merger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAQ3D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAA;AAE3E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB;;;;;;;;OAQG;IACG,kBAAkB,CACtB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAAE,EAC9B,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,WAAW,CAAC;IAyDvB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAmBvB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA8B9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK3B"}