@povio/openapi-codegen-cli 2.0.8-rc.37 → 2.0.8-rc.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@povio/openapi-codegen-cli",
-  "version": "2.0.8-rc.37",
+  "version": "2.0.8-rc.39",
   "keywords": [
     "codegen",
     "openapi",
@@ -16,72 +16,58 @@
     "url": "git+https://github.com/povio/openapi-codegen-cli.git"
   },
   "bin": {
-    "openapi-codegen": "./dist/sh.mjs"
+    "openapi-codegen": "./dist/sh.js"
   },
   "files": [
     "README.md",
     "dist/*",
-    "src/assets/**"
+    "src/assets/**",
+    "src/generators/templates/**"
   ],
-  "type": "module",
   "main": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs"
-    },
-    "./vite": {
-      "types": "./dist/vite.d.mts",
-      "import": "./dist/vite.mjs"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.mjs"
     },
     "./generator": {
-      "types": "./dist/generator.d.mts",
-      "import": "./dist/generator.mjs"
+      "types": "./dist/generator.d.ts",
+      "import": "./dist/generator.js",
+      "require": "./dist/generator.js"
     },
     "./acl": {
-      "types": "./dist/acl.d.mts",
-      "import": "./dist/acl.mjs"
-    },
-    "./zod": {
-      "types": "./dist/zod.d.mts",
-      "import": "./dist/zod.mjs"
+      "types": "./dist/acl.d.ts",
+      "import": "./dist/acl.mjs",
+      "require": "./dist/acl.mjs"
     }
   },
   "scripts": {
     "start": "node --import tsx ./src/sh.ts",
     "test": "vitest run",
     "test:watch": "vitest",
-    "build": "tsdown",
-    "start:dist": "node ./dist/sh.mjs",
-    "gen:base": "rm -rf ./test/generated/base && mkdir -p ./test/generated/base && pnpm start generate --config ./test/config.mjs --output ./test/generated/base --no-prettier",
-    "gen:next": "rm -rf ./test/generated/next && mkdir -p ./test/generated/next && pnpm start generate --config ./test/config.mjs --output ./test/generated/next --no-prettier",
-    "test:generated-eq": "vitest run ./src/generators/generated-output-eq.test.ts",
-    "gen:verify": "pnpm gen:base && pnpm gen:next && pnpm test:generated-eq",
+    "build:clean": "rm -rf ./dist",
+    "build:client": "vite build",
+    "build:cli": "node ./esbuild.mjs && chmod +x ./dist/sh.js",
+    "build": "yarn build:clean && yarn build:cli && yarn build:client",
+    "start:dist": "node ./dist/sh.js",
     "typecheck": "tsc --noEmit",
     "lint": "oxlint --type-aware --fix",
     "lint:check": "oxlint --type-aware",
     "format": "oxfmt",
     "format:check": "oxfmt --check",
-    "check": "pnpm typecheck && pnpm lint && pnpm test",
-    "push": "node ./scripts/publish.mjs",
-    "dev:generate": "rm -rf ./output && pnpm start generate --config ./test/config.mjs",
-    "dev:check": "pnpm start check --config ./test/config.mjs",
-    "snapshot:openapi-localhost": "node ./scripts/snapshot-openapi-localhost.mjs",
-    "bench:vite-codegen": "node ./scripts/benchmark-vite-codegen.mjs"
+    "check": "yarn typecheck && yarn lint && yarn test",
+    "push": "yarn exec ./scripts/publish.sh",
+    "dev:generate": "rm -rf ./output && yarn start generate --config ./test/config.ts",
+    "dev:check": "yarn start check --config ./test/config.ts"
   },
   "dependencies": {
-    "@apidevtools/swagger-parser": "^10.1.0",
-    "i18next": "^25.8.13",
-    "import-fresh": "^3.3.1",
-    "openapi-types": "^12.1.3",
-    "prompt-sync": "^4.2.0",
-    "reflect-metadata": "^0.2.2",
-    "ts-pattern": "^5.9.0",
-    "typescript": "^5.9.3",
-    "yargs": "^18.0.0"
+    "i18next": "^25.8.11",
+    "import-fresh": "^3.3.1"
   },
   "devDependencies": {
+    "@apidevtools/swagger-parser": "^10.1.0",
     "@casl/ability": "^6.8.0",
     "@casl/react": "^5.0.1",
     "@tanstack/react-query": "~5.90.21",
@@ -90,16 +76,25 @@
     "@types/react": "^19.2.14",
     "@types/yargs": "^17.0.35",
     "@vitejs/plugin-react": "^5.1.4",
+    "axios": "^1.13.5",
+    "esbuild": "0.27.3",
+    "handlebars": "^4.7.8",
+    "openapi-types": "^12.1.3",
     "oxfmt": "^0.34.0",
-    "oxlint": "^1.50.0",
-    "oxlint-tsgolint": "^0.15.0",
+    "oxlint": "^1.49.0",
+    "oxlint-tsgolint": "^0.14.1",
+    "prompt-sync": "^4.2.0",
     "react": "^19.2.4",
-    "tsdown": "^0.21.0-beta.1",
+    "reflect-metadata": "^0.2.2",
+    "ts-pattern": "^5.9.0",
     "tsx": "^4.21.0",
     "type-fest": "^5.4.4",
-    "vite": "npm:rolldown-vite@^7.3.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "4.0.18"
+    "vitest": "4.0.18",
+    "yargs": "^18.0.0",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "@casl/ability": "^6.7.3",
@@ -107,7 +102,6 @@
     "@tanstack/react-query": "^5.90.21",
     "axios": "^1.13.1",
     "react": "^19.1.0",
-    "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
     "zod": "^4.1.12"
   },
   "peerDependenciesMeta": {
@@ -116,14 +110,12 @@
     },
     "@casl/react": {
       "optional": true
-    },
-    "vite": {
-      "optional": true
     }
   },
   "engines": {
     "node": ">= 14",
-    "pnpm": ">= 9"
+    "npm": ">= 8",
+    "yarn": ">= 3.2"
   },
-  "packageManager": "pnpm@10.4.0"
+  "packageManager": "yarn@4.2.2"
 }

package/src/assets/useCrossTabQueryInvalidation.ts

@@ -0,0 +1,40 @@
+import type { QueryClient, QueryKey } from "@tanstack/react-query";
+
+const CROSS_TAB_INVALIDATE_KEY = "__rq_invalidate__";
+
+/**
+ * Broadcasts a query invalidation event to all other open tabs via localStorage.
+ *
+ * @param queryKeys - An array of query keys to invalidate (array of arrays).
+ *
+ * NOTE: The `storage` event only fires in *other* tabs — the calling tab
+ * must invalidate its own queryClient separately if needed.
+ */
+export const broadcastQueryInvalidation = (queryKeys: QueryKey[]) => {
+  localStorage.setItem(CROSS_TAB_INVALIDATE_KEY, JSON.stringify({ keys: queryKeys, timestamp: Date.now() }));
+};
+
+/**
+ * Registers a one-time global `storage` event listener that reacts to
+ * cross-tab invalidation broadcasts. Safe to call from multiple hooks —
+ * only the first call sets up the listener.
+ */
+let isListenerSetUp = false;
+
+export const setupCrossTabListener = (queryClient: QueryClient) => {
+  if (isListenerSetUp) return;
+  isListenerSetUp = true;
+
+  window.addEventListener("storage", (e: StorageEvent) => {
+    if (e.key !== CROSS_TAB_INVALIDATE_KEY || !e.newValue) return;
+
+    try {
+      const { keys } = JSON.parse(e.newValue) as { keys: QueryKey[] };
+      for (const queryKey of keys) {
+        queryClient.invalidateQueries({ queryKey });
+      }
+    } catch {
+      // Ignore malformed payloads
+    }
+  });
+};

package/src/assets/useMutationEffects.ts

@@ -0,0 +1,94 @@
+import { useCallback, useEffect } from "react";
+
+import { QueryKey, useQueryClient } from "@tanstack/react-query";
+import { OpenApiQueryConfig, QueryModule, InvalidationMap } from "../lib/config/queryConfig.context";
+import { broadcastQueryInvalidation, setupCrossTabListener } from "./useCrossTabQueryInvalidation";
+
+export interface MutationEffectsOptions {
+  invalidateCurrentModule?: boolean;
+  crossTabInvalidation?: boolean;
+  invalidationMap?: InvalidationMap;
+  invalidateModules?: QueryModule[];
+  invalidateKeys?: QueryKey[];
+  preferUpdate?: boolean;
+}
+
+export interface UseMutationEffectsProps {
+  currentModule: QueryModule;
+}
+
+export function useMutationEffects({ currentModule }: UseMutationEffectsProps) {
+  const queryClient = useQueryClient();
+  const config = OpenApiQueryConfig.useConfig();
+
+  useEffect(() => {
+    if (!config.crossTabInvalidation) return;
+    setupCrossTabListener(queryClient);
+  }, [queryClient, config.crossTabInvalidation]);
+
+  const runMutationEffects = useCallback(
+    async <TData, TVariables>(
+      data: TData,
+      variables: TVariables,
+      options: MutationEffectsOptions = {},
+      updateKeys?: QueryKey[],
+    ) => {
+      const { invalidateCurrentModule, invalidateModules, invalidateKeys, preferUpdate } = options;
+      const shouldUpdate = preferUpdate ?? config.preferUpdate ?? false;
+      const shouldInvalidateCurrentModule = invalidateCurrentModule ?? config.invalidateCurrentModule ?? true;
+
+      const isQueryKeyEqual = (keyA: QueryKey, keyB: QueryKey) =>
+        keyA.length === keyB.length && keyA.every((item, index) => item === keyB[index]);
+      const isQueryKeyPrefix = (queryKey: QueryKey, prefixKey: QueryKey) =>
+        prefixKey.length <= queryKey.length && prefixKey.every((item, index) => item === queryKey[index]);
+      const mappedInvalidationKeys = config.invalidationMap?.[currentModule]?.(data, variables);
+
+      const shouldInvalidateQuery = (queryKey: QueryKey) => {
+        const isUpdateKey = updateKeys?.some((key) => isQueryKeyEqual(queryKey, key));
+        if (shouldUpdate && isUpdateKey) {
+          return false;
+        }
+
+        const isCurrentModule = shouldInvalidateCurrentModule && queryKey[0] === currentModule;
+        const isInvalidateModule = !!invalidateModules && invalidateModules.some((module) => queryKey[0] === module);
+        const isInvalidateKey = !!invalidateKeys && invalidateKeys.some((key) => isQueryKeyPrefix(queryKey, key));
+        const isMappedKey =
+          !!mappedInvalidationKeys && mappedInvalidationKeys.some((key) => isQueryKeyPrefix(queryKey, key));
+
+        return isCurrentModule || isInvalidateModule || isInvalidateKey || isMappedKey;
+      };
+
+      const invalidatedQueryKeys: QueryKey[] = [];
+
+      queryClient.invalidateQueries({
+        predicate: ({ queryKey }) => {
+          const shouldInvalidate = shouldInvalidateQuery(queryKey);
+
+          if (shouldInvalidate && config.crossTabInvalidation) {
+            invalidatedQueryKeys.push([...queryKey]);
+          }
+
+          return shouldInvalidate;
+        },
+      });
+
+      if (config.crossTabInvalidation && invalidatedQueryKeys.length > 0) {
+        broadcastQueryInvalidation(invalidatedQueryKeys);
+      }
+
+      if (shouldUpdate && updateKeys) {
+        updateKeys.map((queryKey) => queryClient.setQueryData(queryKey, data));
+      }
+    },
+    [
+      queryClient,
+      currentModule,
+      config.preferUpdate,
+      config.invalidateCurrentModule,
+      config.invalidationMap,
+      config.crossTabInvalidation,
+    ],
+  );
+
+  return { runMutationEffects };
+}

package/src/generators/templates/acl-check.hbs

@@ -0,0 +1,29 @@
+{{! CASL ability import }}
+{{{genImport abilityTupleImport}}}
+{{! Error handling import }}
+{{{genImport errorHandlingImport}}}
+{{! Ability context import }}
+{{{genImport abilityContextImport}}}
+import { useCallback } from "react";
+
+{{! App abilities import }}
+{{{genImport appAbilitiesImport}}}
+
+interface UseAclCheckProps {
+  errorHandler?: {{errorHandler}}<never>;
+}
+
+export function {{aclCheckHook}}({ errorHandler }: UseAclCheckProps = {}) {
+  const ability = {{abilityContext}}.useAbility{{#if hasGenericAppAbilities}}<{{appAbilities}}>{{/if}}();
+
+  const checkAcl = useCallback(
+    (appAbility: {{appAbilities}}) => {
+      if (!ability.can(...(appAbility as {{abilityTuple}}))) {
+        (errorHandler ?? {{sharedErrorHandler}}).rethrowError(new Error("ACL check failed"));
+      }
+    },
+    [ability, errorHandler],
+  );
+
+  return { checkAcl };
+}

package/src/generators/templates/acl.hbs

@@ -0,0 +1,19 @@
+{{! Casl AbilityTuple import}}
+{{{genImport caslAbilityTupleImport}}}
+{{! Models import }}
+{{#each modelsImports as | modelsImport |}}
+{{{genImport modelsImport}}}
+{{/each}}
+
+{{#if includeNamespace}}
+export namespace {{namespace}} {
+{{/if}}
+
+{{! Ability functions }}
+{{#each endpoints as | endpoint |}}
+{{{genCaslAbilityFunction endpoint}}}
+
+{{/each}}
+{{#if includeNamespace}}
+}
+{{/if}}

package/src/generators/templates/app-acl.hbs

@@ -0,0 +1,17 @@
+{{! Casl AbilityTuple import}}
+{{{genImport caslAbilityTupleImport}}}
+{{! Models import }}
+{{#each modelsImports as | modelsImport |}}
+{{{genImport modelsImport}}}
+{{/each}}
+
+{{! AppAbilities union type }}
+export type {{appAbilities}} = {{#if appAbilitiesType}} 
+{{#each appAbilitiesType as | appAbilityType |}}
+| {{../abilityTuple}}<"{{@key}}", {{{union appAbilityType}}}>
+{{/each}}
+{{else}}
+{{abilityTuple}}<string, {{subjectType}}>;
+{{/if}}
+
+export type AppAbility = PureAbility<{{appAbilities}}>;

package/src/generators/templates/app-rest-client.hbs

@@ -0,0 +1,7 @@
+import { RestClient } from "{{restClientImportPath}}";
+
+export const {{appRestClientName}} = new RestClient({
+  config: {
+    baseURL: "{{baseUrl}}"
+  },
+});

package/src/generators/templates/configs.hbs

@@ -0,0 +1,80 @@
+{{! Zod import }}
+{{#if hasZodImport}}
+{{{genImport zodImport}}}
+{{/if}}
+{{! Dynamic inputs import }}
+{{#if hasDynamicInputsImport}}
+{{{genImport dynamicInputsImport}}}
+{{/if}}
+{{! Dynamic columns import }}
+{{#if hasDynamicColumnsImport}}
+{{{genImport dynamicColumnsImport}}}
+{{/if}}
+{{! Models import }}
+{{#each modelsImports as | modelsImport |}}
+{{{genImport modelsImport}}}
+{{/each}}
+{{! Queries import }}
+{{#each queriesImports as | queriesImport |}}
+{{{genImport queriesImport}}}
+{{/each}}
+{{! Acl import }}
+{{#each aclImports as | aclImport |}}
+{{{genImport aclImport}}}
+{{/each}}
+
+{{#if includeNamespace}}
+export namespace {{namespace}} {
+{{/if}}
+{{! Configs export }}
+{{#each configs as |config|}}
+export const {{config.name}} = {
+    meta: {
+        title: "{{{config.title}}}",
+    },
+    readAll: { 
+        {{#if config.readAll.acl}} acl: {{{config.readAll.acl}}}, 
+        {{/if}} schema: {{{config.readAll.columns.schema}}},
+        paginated: {{{config.readAll.paginated}}}, {{#if config.readAll.infinite}}
+        infinite: {{{config.readAll.infinite}}}, 
+        {{/if}} {{#if config.readAll.filters}} filters: {
+            schema: {{{config.readAll.filters.schema}}},
+            filterDefs: {{../dynamicInputs}}({{{genInputsConfig config.readAll.filters}}})
+        },
+        {{/if}} columns: {{../dynamicColumns}}({{{genColumnsConfig config.readAll.columns}}}),
+    }, {{#if config.read}}
+    read: {
+        {{#if config.read.acl}} acl: {{{config.read.acl}}}, 
+        {{/if}} schema: {{{config.read.schema}}},
+        query: {{{config.read.query}}},
+    },{{/if}} {{#if config.create}}
+    create: {
+        {{#if config.create.acl}} acl: {{{config.create.acl}}}, 
+        {{/if}} {{#if config.create.inputDefs}} schema: {{{config.create.inputDefs.schema}}},
+        {{/if}} mutation: {{{config.create.mutation}}}, 
+        {{#if config.create.inputDefs}} inputDefs: {{../dynamicInputs}}({{{genInputsConfig config.create.inputDefs}}}) 
+        {{/if}}
+    },{{/if}} {{#if config.update}}
+    update: {
+        {{#if config.update.acl}} acl: {{{config.update.acl}}}, 
+        {{/if}} {{#if config.update.inputDefs}} schema: {{{config.update.inputDefs.schema}}},
+        {{/if}} mutation: {{{config.update.mutation}}}, 
+        {{#if config.update.inputDefs}} inputDefs: {{../dynamicInputs}}({{{genInputsConfig config.update.inputDefs}}}) 
+        {{/if}}
+    },{{/if}} {{#if config.delete}}
+    delete: {
+        {{#if config.delete.acl}} acl: {{{config.delete.acl}}}, 
+        {{/if}} mutation: {{{config.delete.mutation}}},
+    },{{/if}} {{!-- {{#if config.bulkDelete}}
+    bulkDelete: {
+        {{#if config.bulkDelete.acl}} acl: {{{config.bulkDelete.acl}}}, 
+        {{/if}} mutation: {{{config.bulkDelete.mutation}}}, 
+        {{#if config.bulkDelete.inputDefs}} inputDefs: {{../dynamicInputs}}({{{genInputsConfig config.bulkDelete.inputDefs}}}) 
+        {{/if}}
+    },{{/if}} --}}
+};
+
+{{/each}}
+{{#if includeNamespace}}
+}
+{{/if}}

package/src/generators/templates/endpoints.hbs

@@ -0,0 +1,44 @@
+{{! App rest client import}}
+{{{genImport appRestClientImport}}}
+{{! Axios import }}
+{{#if hasAxiosImport}}
+{{{genImport axiosImport}}}
+{{/if}}
+{{! Zod import }}
+{{#if hasZodImport}}
+{{{genImport zodImport}}}
+{{/if}}
+{{! Zod extended import }}
+{{#if hasZodExtendedImport}}
+{{{genImport zodExtendedImport}}}
+{{/if}}
+{{! Models import }}
+{{#each modelsImports as | modelsImport |}}
+{{{genImport modelsImport}}}
+{{/each}}
+
+{{#if includeNamespace}}
+export namespace {{namespace}} {
+{{/if}}
+{{! Endpoints export }}
+{{#each endpoints as | endpoint |}}
+export const {{endpointName endpoint}} = ({{{genEndpointParams endpoint}}}{{#if ../hasAxiosRequestConfig}}{{../axiosRequestConfigName}}?: {{../axiosRequestConfigType}}{{/if}}) => { 
+    return {{../restClientName}}.{{endpoint.method}}( 
+        {{! Response }}
+        { resSchema: {{importedZodSchemaName endpoint.response}} }, 
+        {{! Path }}
+        `{{endpointPath endpoint}}`,
+        {{! Body }}
+        {{#with (endpointBody endpoint) as | endpointBody |}}
+        {{#if endpointBody}}{{#if ../../generateParse}}{{{genEndpointParamParse endpointBody endpointBody.name}}}{{else}}{{endpointBody.name}}{{/if}}, {{/if}}
+        {{/with}}
+        {{#if (hasUndefinedEndpointBody endpoint)}} undefined, 
+        {{! Config }}
+        {{/if}}{{{genEndpointConfig endpoint}}}
+    )
+};
+
+{{/each}}
+{{#if includeNamespace}}
+}
+{{/if}}

package/src/generators/templates/models.hbs

@@ -0,0 +1,23 @@
+{{! Zod import}}
+{{{genImport zodImport}}}
+{{! Models import }}
+{{#each modelsImports as | modelsImport |}}
+{{{genImport modelsImport}}}
+{{/each}}
+
+{{#if includeNamespace}}
+export namespace {{namespace}} {
+{{/if}}
+{{#each zodSchemasData as | zodSchema |}}
+{{! Js docs }}
+{{{genModelJsDocs @key zodSchema ../tag}}}
+{{! Zod schema export }}
+export const {{@key}} = {{{zodSchema.code}}};
+{{! Zod schema infered type export }}
+export type {{zodInferedType @key}} = z.infer<typeof {{@key}}>;
+{{#if zodSchema.isEnum}}export const {{zodInferedType @key}} = {{@key}}.enum;{{/if}}
+
+{{/each}}
+{{#if includeNamespace}}
+}
+{{/if}}

package/src/generators/templates/partials/acl-check-call.hbs

@@ -0,0 +1 @@
+checkAcl({{importedAbilityFunctionName endpoint}}({{#if generateAclCheckParams}}{ {{#each (abilityConditionsTypes endpoint) as | propertyType |}}{{propertyType.name}}, {{/each}} } {{/if}}));

package/src/generators/templates/partials/casl-ability-function.hbs

@@ -0,0 +1,12 @@
+/**
+ * Use for {{{genCaslAbilityQuery endpoint}}} ability. {{#if (hasAbilityConditions endpoint)}}For global ability, omit the object parameter.{{/if}}{{#if (abilityDescription endpoint)}}
+ * @description {{abilityDescription endpoint}}{{/if}} 
+{{#if (hasAbilityConditions endpoint)}}{{#each (abilityConditionsTypes endpoint) as | propertyType |}} * @param { {{propertyType.type}}{{propertyType.zodSchemaName}} } object.{{propertyType.name}} {{propertyType.name}} from {{propertyType.info}}
+{{/each}}{{/if}} * @returns { AbilityTuple } An ability tuple indicating the user's ability to use {{{genCaslAbilityQuery endpoint}}}
+ */
+export const {{abilityFunctionName endpoint}} = (
+  {{#if (hasAbilityConditions endpoint)}}object?: { {{#each (abilityConditionsTypes endpoint) as | propertyType |}}{{propertyType.name}}{{#unless propertyType.required}}?{{/unless}}: {{propertyType.type}}{{propertyType.zodSchemaName}}, {{/each}} } {{/if}}
+) => [
+  "{{ablityAction endpoint}}", 
+  {{#if (hasAbilityConditions endpoint)}}object ? subject("{{ablitySubject endpoint}}", object) : "{{ablitySubject endpoint}}"{{else}}"{{ablitySubject endpoint}}"{{/if}}
+] as {{{genCaslAbilityType endpoint}}};

package/src/generators/templates/partials/casl-ability-query.hbs

@@ -0,0 +1 @@
+{{#if (isQuery endpoint)}}{{#if (isMutation endpoint)}}`{{queryName endpoint}}` query or `{{queryName endpoint mutation=true}}` mutation{{else}}`{{queryName endpoint}}` query{{/if}}{{else}}`{{queryName endpoint}}` mutation{{/if}}

package/src/generators/templates/partials/casl-ability-type.hbs

@@ -0,0 +1 @@
+{{abilityTuple}}<"{{ablityAction endpoint}}", {{{union (abilitySubjectTypes endpoint)}}}>

package/src/generators/templates/partials/columns-config.hbs

@@ -0,0 +1,11 @@
+{ 
+    schema: {{columnsConfig.schema}},
+    options: {
+        columns: {
+            {{#each columnsConfig.options.columns}}
+                {{@key}}: true,
+            {{/each}}
+        }, {{#if columnsConfig.options.sortable}}
+        sortable: {{columnsConfig.options.sortable}}, {{/if}}
+    }
+}

package/src/generators/templates/partials/endpoint-config.hbs

@@ -0,0 +1,31 @@
+{
+    {{! Query params}}
+    {{#if hasAxiosRequestConfig}}
+    ...{{axiosRequestConfigName}},
+    {{/if}}
+    {{#if endpointConfig.params}}
+    params: {
+        {{#each endpointConfig.params as | param |}}
+        {{#if (isEqual param.name param.value) }}
+        {{{param.name}}}{{#if ../generateParse}}: {{{genEndpointParamParse param param.name}}}{{/if}}, 
+        {{else}}
+        {{{param.name}}}: {{#if ../generateParse}}{{{genEndpointParamParse param param.value}}}{{else}}{{param.value}}{{/if}},
+        {{/if}}
+        {{/each}}
+    },
+    {{/if}}
+    {{! Headers}}
+    {{#if endpointConfig.headers}}
+    headers: {
+        {{#each endpointConfig.headers as | header |}}
+        '{{@key}}': {{{header}}},
+        {{/each}}
+    },
+    {{/if}}
+    {{#if hasBlobResponse}}
+    responseType: "blob",
+    {{/if}}
+    {{#if hasFileDownload}}
+    rawResponse: true,
+    {{/if}}
+}

package/src/generators/templates/partials/endpoint-param-parse.hbs

@@ -0,0 +1 @@
+{{zodExtendedNamespace}}.{{parse}}({{#if param.parameterSortingEnumSchemaName}}{{zodExtendedNamespace}}.{{sortExp}}({{{importedZodSchemaName param.parameterSortingEnumSchemaName}}}){{#if addOptional}}.optional(){{/if}}{{else}}{{{importedZodSchemaName param.zodSchema}}}{{#if addOptional}}.optional(){{/if}}{{/if}}, {{paramName}}{{#if isQuery}}, { type: "query", name: "{{paramName}}" }{{/if}})

package/src/generators/templates/partials/endpoint-params.hbs

@@ -0,0 +1 @@
+{{#each (endpointParams endpoint options) as | endpointParam |}}{{endpointParam.name}}{{#unless endpointParam.required}}?{{/unless}}: {{endpointParam.type}}, {{/each}}

package/src/generators/templates/partials/import.hbs

@@ -0,0 +1 @@
+import {{importNames import.bindings import.defaultImport}} from "{{import.from}}";

package/src/generators/templates/partials/inputs-config.hbs

@@ -0,0 +1,10 @@
+{ 
+    schema: {{inputsConfig.schema}},
+    options: {
+        inputs: {
+            {{#each inputsConfig.options.inputs}}
+                {{@key}}: true,
+            {{/each}}
+        }
+    }
+}

package/src/generators/templates/partials/model-js-docs.hbs

@@ -0,0 +1,6 @@
+/** 
+ * {{name}} 
+ * @type { {{zodSchemaType zodSchema}} }{{#if (zodSchemaDescription zodSchema)}}
+ * @description {{{zodSchemaDescription zodSchema}}}{{/if}}
+{{#if (zodSchemaPropertyDescriptions zodSchema tag)}}{{#each (zodSchemaPropertyDescriptions zodSchema tag) as | property |}} * @property { {{property.type}} } {{@key}} {{{addAsteriskAfterNewLine property.description}}} 
+{{/each}}{{/if}} */

package/src/generators/templates/partials/query-js-docs.hbs

@@ -0,0 +1,31 @@
+{{#if infiniteQuery}}
+/** 
+ * Infinite query `{{infiniteQueryName endpoint}}{{#if endpoint.summary}}
+ * @summary {{addAsteriskAfterNewLine endpoint.summary}}{{/if}}{{#if endpoint.description}} 
+ * @description {{addAsteriskAfterNewLine endpoint.description}}{{/if}}{{#if endpoint.acl}}
+ * @permission Requires `{{abilityFunctionName endpoint}}` ability {{/if}}
+{{#if (endpointParams endpoint)}}{{#each (endpointParams endpoint infiniteQuery excludePageParam=true) as | endpointParam |}} * @param { {{{endpointParam.type}}} } object.{{endpointParam.name}} {{{endpointParamDescription endpointParam}}}
+{{/each}}{{/if}} * @param { AppInfiniteQueryOptions } options Infinite query options
+ * @returns { UseInfiniteQueryResult<{{{importedZodSchemaInferedType endpoint.response}}}> } {{endpoint.responseDescription}}
+ * @statusCodes [{{commaSeparated endpoint.responseStatusCodes}}]
+ */{{else if query}}
+ /** 
+ * Query `{{queryName endpoint}}`{{#if endpoint.summary}}{{#if endpoint.mediaDownload}} - recommended when file should be cached{{/if}}
+ * @summary {{addAsteriskAfterNewLine endpoint.summary}}{{/if}}{{#if endpoint.description}} 
+ * @description {{addAsteriskAfterNewLine endpoint.description}}{{/if}}{{#if endpoint.acl}}
+ * @permission Requires `{{abilityFunctionName endpoint}}` ability {{/if}}
+{{#if (endpointParams endpoint includeFileParam=true)}}{{#each (endpointParams endpoint includeFileParam=true) as | endpointParam |}} * @param { {{{endpointParam.type}}} } object.{{endpointParam.name}} {{{endpointParamDescription endpointParam}}}
+{{/each}}{{/if}} * @param { AppQueryOptions } options Query options
+ * @returns { UseQueryResult<{{#if endpoint.mediaDownload}}AxiosResponse<{{/if}}{{{importedZodSchemaInferedType endpoint.response}}}{{#if endpoint.mediaDownload}}>{{/if}}> } {{endpoint.responseDescription}}
+ * @statusCodes [{{commaSeparated endpoint.responseStatusCodes}}]
+ */{{else if mutation}}
+ /** 
+ * Mutation `{{queryName endpoint mutation=true}}`{{#if endpoint.summary}}{{#if endpoint.mediaDownload}} - recommended when file should not be cached{{/if}}
+ * @summary {{addAsteriskAfterNewLine endpoint.summary}}{{/if}}{{#if endpoint.description}} 
+ * @description {{addAsteriskAfterNewLine endpoint.description}}{{/if}}{{#if endpoint.acl}}
+ * @permission Requires `{{abilityFunctionName endpoint}}` ability {{/if}}
+{{#if (endpointParams endpoint includeFileParam=true)}}{{#each (endpointParams endpoint includeFileParam=true) as | endpointParam |}} * @param { {{{endpointParam.type}}} } mutation.{{endpointParam.name}} {{{endpointParamDescription endpointParam}}}
+{{/each}}{{/if}} * @param { AppMutationOptions{{#if hasMutationEffects}} & {{mutationEffectsType}}{{/if}} } options Mutation options
+ * @returns { UseMutationResult<{{#if endpoint.mediaDownload}}AxiosResponse<{{/if}}{{{importedZodSchemaInferedType endpoint.response}}}{{#if endpoint.mediaDownload}}>{{/if}}> } {{endpoint.responseDescription}}
+ * @statusCodes [{{commaSeparated endpoint.responseStatusCodes}}]
+ */{{/if}}