mobx-tanstack-query-api 0.41.0 → 0.42.0

package/cli.d.ts

@@ -206,8 +206,9 @@ interface GenerateQueryApiParams {
      * - **string**: expression inserted as-is → `contract: <expr> ? <contractVar> : undefined`. E.g. `"process.env.NODE_ENV === \"development\""`.
      * - **function** (contractName, routeInfo) => boolean: at codegen time, if true → `contract: <contractVar>`, if false → `contract: undefined`.
      *
-     * Optional `suffix`: suffix for generated Zod contract variables.
-     * Default: `"Contract"`.
+     * Optional `suffix`: suffix for generated shared Zod schema variables.
+     * Shared schema names are based on data contract names in camelCase, e.g. `DispatchReceiptDC` -> `dispatchReceiptDc`.
+     * Default: `""`.
      */
     zodContracts?: boolean | {
         validate: MaybeFn<RuntimeExpressionOrBoolean | {
@@ -229,7 +230,7 @@ interface GenerateQueryApiParams {
             contractName: string,
             routeInfo: ZodContractsRouteInfo
         ]>;
-        /** Suffix for all generated Zod contract variables. Default: "Contract". */
+        /** Suffix for generated shared Zod schema variables. Default: "". */
         suffix?: string;
     };
 }

package/cli.js

@@ -216,10 +216,15 @@ const createShortModelType = (shortModelType) => {
     description: shortModelType.description || ""
   };
 };
-const DEFAULT_ZOD_CONTRACT_SUFFIX = "Contract";
+const DEFAULT_DATA_CONTRACT_TYPE_SUFFIX = "DC";
+const DEFAULT_ZOD_CONTRACT_SUFFIX = "";
+const DEFAULT_ENDPOINT_ZOD_CONTRACT_SUFFIX = "Contract";
 function getZodContractSuffix(zodContracts) {
   return (typeof zodContracts === "object" && zodContracts !== null && typeof zodContracts.suffix === "string" ? zodContracts.suffix : void 0) ?? DEFAULT_ZOD_CONTRACT_SUFFIX;
 }
+function getEndpointZodContractSuffix(zodContracts) {
+  return (typeof zodContracts === "object" && zodContracts !== null && typeof zodContracts.suffix === "string" ? zodContracts.suffix : void 0) ?? DEFAULT_ENDPOINT_ZOD_CONTRACT_SUFFIX;
+}
 const REF_PREFIX = "#/components/schemas/";
 const REF_PREFIX_PARAMS = "#/components/parameters/";
 function parseRef(ref) {
@@ -248,7 +253,7 @@ function getResponseSchemaKeyFromOperation(rawOperation) {
   if (typeof ref !== "string") return null;
   return parseRef(ref);
 }
-function typeNameToSchemaKey(typeName, typeSuffix = "DC") {
+function typeNameToSchemaKey(typeName, typeSuffix = DEFAULT_DATA_CONTRACT_TYPE_SUFFIX) {
   const t = typeName.trim();
   if (typeSuffix && t.endsWith(typeSuffix))
     return t.slice(0, -typeSuffix.length);
@@ -375,9 +380,16 @@ function collectRefs(schema, schemas, out) {
     collectRefs(schema.additionalProperties, schemas, out);
   }
 }
-function schemaKeyToContractVarName(key, utils, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX) {
+function dataContractTypeNameToZodVarName(typeName, utils, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX) {
   const _ = utils._;
-  return `${_.camelCase(key)}${contractSuffix}`;
+  return `${_.camelCase(typeName)}${contractSuffix}`;
+}
+function schemaKeyToContractVarName(key, utils, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX, typeSuffix = DEFAULT_DATA_CONTRACT_TYPE_SUFFIX) {
+  return dataContractTypeNameToZodVarName(
+    `${key}${typeSuffix}`,
+    utils,
+    contractSuffix
+  );
 }
 function resolveQueryParameters(operation, componentsParameters) {
   const list = [];
@@ -445,9 +457,10 @@ function buildCentralZodContractsFile(params) {
   const {
     componentsSchemas,
     utils,
-    contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX
+    contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX,
+    typeSuffix = DEFAULT_DATA_CONTRACT_TYPE_SUFFIX
   } = params;
-  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix);
+  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix, typeSuffix);
   const lines = generateAuxiliarySchemas(
     Object.keys(componentsSchemas),
     componentsSchemas,
@@ -473,7 +486,7 @@ function typeToZodSchemaFallback(typeStr) {
   if (t === "unknown") return "z.unknown()";
   return "z.any()";
 }
-function typeToZodSchemaWithSchema(typeStr, schemas, utils, typeSuffix, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX) {
+function typeToZodSchemaWithSchema(typeStr, schemas, utils, typeSuffix = DEFAULT_DATA_CONTRACT_TYPE_SUFFIX, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX) {
   const t = typeStr.trim();
   if (!schemas || Object.keys(schemas).length === 0) {
     return { expr: typeToZodSchemaFallback(t), refs: [] };
@@ -486,7 +499,7 @@ function typeToZodSchemaWithSchema(typeStr, schemas, utils, typeSuffix, contract
   }
   const refs = /* @__PURE__ */ new Set();
   collectRefs(schema, schemas, refs);
-  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix);
+  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix, typeSuffix);
   const expr = schemaToZodExpr(
     schema,
     schemas,
@@ -495,12 +508,12 @@ function typeToZodSchemaWithSchema(typeStr, schemas, utils, typeSuffix, contract
   );
   return { expr, refs: [...refs] };
 }
-function schemaKeyToZod(schemaKey, schemas, utils, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX) {
+function schemaKeyToZod(schemaKey, schemas, utils, typeSuffix = DEFAULT_DATA_CONTRACT_TYPE_SUFFIX, contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX) {
   const schema = schemas[schemaKey];
   if (!schema) return { expr: "z.any()", refs: [] };
   const refs = /* @__PURE__ */ new Set();
   collectRefs(schema, schemas, refs);
-  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix);
+  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix, typeSuffix);
   const expr = schemaToZodExpr(
     schema,
     schemas,
@@ -517,7 +530,7 @@ function buildEndpointZodContractsCode(params) {
     utils,
     contractSuffix = DEFAULT_ZOD_CONTRACT_SUFFIX,
     componentsSchemas = null,
-    typeSuffix = "DC",
+    typeSuffix = DEFAULT_DATA_CONTRACT_TYPE_SUFFIX,
     responseSchemaKey,
     useExternalZodSchemas = false,
     openApiOperation = null,
@@ -528,7 +541,7 @@ function buildEndpointZodContractsCode(params) {
   const allAuxiliaryKeys = /* @__PURE__ */ new Set();
   const paramParts = [];
   const resolvedQueryParams = openApiOperation && (openApiComponentsParameters || openApiOperation.parameters?.length) ? resolveQueryParameters(openApiOperation, openApiComponentsParameters) : [];
-  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix);
+  const schemaKeyToContractVarNameFn = (key) => schemaKeyToContractVarName(key, utils, contractSuffix, typeSuffix);
   for (const p of inputParams) {
     let expr;
     let refKeys = [];
@@ -557,6 +570,7 @@ function buildEndpointZodContractsCode(params) {
     responseSchemaKey,
     componentsSchemas,
     utils,
+    typeSuffix,
     contractSuffix
   ) : typeToZodSchemaWithSchema(
     responseDataTypeName,
@@ -751,7 +765,8 @@ const newEndpointTmpl = ({
 }) => {
   const zodContractsIsObject = typeof zodContracts === "object" && zodContracts !== null;
   const hasZodContracts = zodContracts === true || zodContractsIsObject;
-  const contractSuffix = getZodContractSuffix(zodContracts);
+  const sharedContractSuffix = getZodContractSuffix(zodContracts);
+  const endpointContractSuffix = getEndpointZodContractSuffix(zodContracts);
   const { _ } = utils;
   const positiveResponseTypes = route.raw.responsesTypes?.filter(
     (it) => +it.status >= 200 && +it.status < 300 && (!it.typeData || filterTypes(it.typeData))
@@ -865,7 +880,7 @@ const newEndpointTmpl = ({
   });
   const isAllowedInputType = filterTypes(requestInputTypeDc);
   const defaultOkResponseType = positiveResponseTypes?.[0]?.type ?? "unknown";
-  const contractVarName = hasZodContracts ? `${_.camelCase(route.routeName.usage)}${contractSuffix}` : null;
+  const contractVarName = hasZodContracts ? `${_.camelCase(route.routeName.usage)}${endpointContractSuffix}` : null;
   const routeInfoForContracts = contractVarName != null ? {
     operationId: raw.operationId ?? "",
     path: path2,
@@ -908,7 +923,10 @@ const newEndpointTmpl = ({
       (m) => m.name === defaultOkResponseType
     );
     if (aliasType?.typeIdentifier === "type" && typeof aliasType.content === "string" && /^[A-Za-z0-9_]+$/.test(aliasType.content.trim())) {
-      const resolved = typeNameToSchemaKey(aliasType.content.trim(), "DC");
+      const resolved = typeNameToSchemaKey(
+        aliasType.content.trim(),
+        DEFAULT_DATA_CONTRACT_TYPE_SUFFIX
+      );
       if (resolved in componentsSchemas) responseSchemaKey = resolved;
     }
   }
@@ -926,10 +944,10 @@ const newEndpointTmpl = ({
     contractVarName,
     utils,
     componentsSchemas: componentsSchemas ?? void 0,
-    typeSuffix: "DC",
+    typeSuffix: DEFAULT_DATA_CONTRACT_TYPE_SUFFIX,
     responseSchemaKey: responseSchemaKey ?? void 0,
     useExternalZodSchemas: Boolean(relativePathZodSchemas),
-    contractSuffix,
+    contractSuffix: sharedContractSuffix,
     openApiOperation: operationFromSpec ?? void 0,
     openApiComponentsParameters: swaggerSchema?.components?.parameters ?? void 0,
     queryParamName: queryName
@@ -1506,7 +1524,7 @@ const generateApi = async (params) => {
     cleanOutput: params.cleanOutput ?? true,
     modular: true,
     patch: true,
-    typeSuffix: "DC",
+    typeSuffix: DEFAULT_DATA_CONTRACT_TYPE_SUFFIX,
     disableStrictSSL: false,
     singleHttpClient: true,
     extractRequestBody: true,