@povio/openapi-codegen-cli 2.0.7 → 2.0.8-rc.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@povio/openapi-codegen-cli",
-  "version": "2.0.7",
+  "version": "2.0.8-rc.2",
   "keywords": [
     "codegen",
     "openapi",
@@ -63,39 +63,39 @@
     "dev:check": "yarn start check --config ./test/config.ts"
   },
   "dependencies": {
-    "i18next": "^25.7.3",
+    "i18next": "^25.8.10",
     "import-fresh": "^3.3.1"
   },
   "devDependencies": {
     "@apidevtools/swagger-parser": "^10.1.0",
-    "@casl/ability": "^6.7.3",
-    "@casl/react": "^5.0.0",
+    "@casl/ability": "^6.8.0",
+    "@casl/react": "^5.0.1",
     "@tanstack/react-query": "~5.90.21",
-    "@types/node": "^20.12.12",
+    "@types/node": "^20.19.33",
     "@types/prompt-sync": "^4.2.3",
-    "@types/react": "^19.1.0",
-    "@types/yargs": "^17.0.32",
-    "@vitejs/plugin-react": "^5.1.3",
-    "axios": "^1.13.1",
-    "esbuild": "0.25.0",
+    "@types/react": "^19.2.14",
+    "@types/yargs": "^17.0.35",
+    "@vitejs/plugin-react": "^5.1.4",
+    "axios": "^1.13.5",
+    "esbuild": "0.25.12",
     "handlebars": "^4.7.8",
     "openapi-types": "^12.1.3",
-    "oxfmt": "^0.27.0",
-    "oxlint": "^1.41.0",
-    "oxlint-tsgolint": "^0.11.4",
+    "oxfmt": "^0.33.0",
+    "oxlint": "^1.48.0",
+    "oxlint-tsgolint": "^0.14.0",
     "prompt-sync": "^4.2.0",
-    "react": "^19.1.0",
+    "react": "^19.2.4",
     "reflect-metadata": "^0.2.2",
     "ts-node": "^10.9.2",
-    "ts-pattern": "^5.3.1",
-    "tsx": "^4.10.5",
-    "type-fest": "^4.26.0",
+    "ts-pattern": "^5.9.0",
+    "tsx": "^4.21.0",
+    "type-fest": "^4.41.0",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^2.0.5",
+    "vitest": "3.2.4",
     "yargs": "^17.7.2",
-    "zod": "^4.1.12"
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "@casl/ability": "^6.7.3",

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

@@ -1,12 +1,14 @@
-import { useCallback } from "react";
+import { useCallback, useEffect } from "react";
 
-import { OpenApiQueryConfig } from "@povio/openapi-codegen-cli";
 import { QueryKey, useQueryClient } from "@tanstack/react-query";
 
-import { QueryModule } from "./queryModules";
+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;
@@ -20,9 +22,25 @@ 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>(data: TData, options: MutationEffectsOptions = {}, updateKeys?: QueryKey[]) => {
-      const { invalidateCurrentModule = true, invalidateModules, invalidateKeys, preferUpdate } = options;
+    async <TData, TVariables>(
+      data: TData,
+      variables: TVariables,
+      options: MutationEffectsOptions = {},
+      updateKeys?: QueryKey[],
+    ) => {
+      const {
+        invalidateCurrentModule = true,
+        invalidateModules,
+        invalidateKeys,
+        preferUpdate,
+        invalidationMap,
+      } = options;
       const shouldUpdate = preferUpdate || (preferUpdate === undefined && config.preferUpdate);
       const shouldInvalidateCurrentModule =
         invalidateCurrentModule || (invalidateCurrentModule === undefined && config.invalidateCurrentModule);
@@ -30,6 +48,8 @@ export function useMutationEffects({ currentModule }: UseMutationEffectsProps) {
       const isQueryKeyEqual = (keyA: QueryKey, keyB: QueryKey) =>
         keyA.length === keyB.length && keyA.every((item, index) => item === keyB[index]);
 
+      const invalidatedQueryKeys: QueryKey[] = [];
+
       queryClient.invalidateQueries({
         predicate: ({ queryKey }) => {
           const isUpdateKey = updateKeys?.some((key) => isQueryKeyEqual(queryKey, key));
@@ -40,15 +60,29 @@ export function useMutationEffects({ currentModule }: UseMutationEffectsProps) {
           const isCurrentModule = shouldInvalidateCurrentModule && queryKey[0] === currentModule;
           const isInvalidateModule = !!invalidateModules && invalidateModules.some((module) => queryKey[0] === module);
           const isInvalidateKey = !!invalidateKeys && invalidateKeys.some((key) => isQueryKeyEqual(queryKey, key));
-          return isCurrentModule || isInvalidateModule || isInvalidateKey;
+
+          const map = (invalidationMap || config.invalidationMap)?.[currentModule]?.(data, variables);
+          const isMappedKey = !!map && map.some((key) => isQueryKeyEqual(queryKey, key));
+
+          const shouldInvalidate = isCurrentModule || isInvalidateModule || isInvalidateKey || isMappedKey;
+
+          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],
+    [queryClient, currentModule, config.preferUpdate, config.invalidationMap, config.crossTabInvalidation],
   );
 
   return { runMutationEffects };

package/src/generators/templates/partials/query-use-mutation.hbs

@@ -47,7 +47,7 @@ export const {{queryName endpoint mutation=true}} = (options?: AppMutationOption
       {{#if destructuredVariables}}const { {{commaSeparated destructuredVariables }} } = variables;{{/if}}
       const updateKeys = [{{#each updateQueryEndpoints as | endpoint |}}keys.{{endpointName endpoint}}({{{endpointArgs endpoint includeOnlyRequiredParams=true}}}), {{/each}}];
       {{/if}}
-      await runMutationEffects(resData, options{{#if updateQueryEndpoints}}, updateKeys{{/if}});
+      await runMutationEffects(resData, variables, options{{#if updateQueryEndpoints}}, updateKeys{{/if}});
       options?.onSuccess?.(resData, variables, onMutateResult, context);
     },{{/if}}
   });

package/src/generators/templates/query-modules.hbs

@@ -1,5 +1,9 @@
+import { QueryModule as BaseQueryModule } from "../lib/config/queryConfig.context";
+
 export const enum QueryModule {
    {{#each modules as | module |}}
    {{module.tag}} = "{{module.namespace}}",
    {{/each}}
-}
+}
+
+export type QueryModuleType = QueryModule | BaseQueryModule;