feat: add cache-save-if input to control cache saving

Allow users to disable cache saving while still restoring caches.
This is useful for matrix jobs or limiting cache writes to specific branches.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Boshen

action.yml

@@ -24,6 +24,10 @@ inputs:
   cache-dependency-path:
     description: "Path to lock file for cache key generation. Auto-detected if not specified."
     required: false
+  cache-save-if:
+    description: "Whether to save the cache. If false, cache is only restored. Useful for limiting cache writes to specific branches."
+    required: false
+    default: "true"
 
 outputs:
   version:

dist/index.mjs

@@ -54,7 +54,7 @@ async function printViteVersion(): Promise<void> {
 
 async function runPost(inputs: Inputs): Promise<void> {
   // Save cache if enabled
-  if (inputs.cache) {
+  if (inputs.cache && inputs.cacheSaveIf) {
     await saveCache();
   }
 }

src/index.ts

@@ -28,6 +28,7 @@ describe("getInputs", () => {
       runInstall: [],
       cache: false,
       cacheDependencyPath: undefined,
+      cacheSaveIf: false,
     });
   });
 

src/inputs.test.ts

@@ -11,6 +11,7 @@ export function getInputs(): Inputs {
     runInstall: parseRunInstall(getInput("run-install")),
     cache: getBooleanInput("cache"),
     cacheDependencyPath: getInput("cache-dependency-path") || undefined,
+    cacheSaveIf: getBooleanInput("cache-save-if"),
   };
 }
 

src/inputs.ts

@@ -23,6 +23,7 @@ export interface Inputs {
   readonly runInstall: RunInstall[];
   readonly cache: boolean;
   readonly cacheDependencyPath?: string;
+  readonly cacheSaveIf: boolean;
 }
 
 // Lock file types