fix: hide persistent cache behind flag

.changeset/sharp-socks-dress.md

@@ -0,0 +1,5 @@
+---
+"@callstack/repack": patch
+---
+
+Hide persistent cache behind `REPACK_EXPERIMENTAL_CACHE` flag

packages/repack/src/commands/common/config/getCommandConfig.ts

@@ -1,14 +1,24 @@
+import { EXPERIMENTAL_CACHE_ENV_KEY } from '../../../env.js';
 import { DEFAULT_HOSTNAME, DEFAULT_PORT } from '../../consts.js';
 
+function isExperimentalCacheEnabled() {
+  return (
+    process.env[EXPERIMENTAL_CACHE_ENV_KEY] === 'true' ||
+    process.env[EXPERIMENTAL_CACHE_ENV_KEY] === '1'
+  );
+}
+
 function getCacheConfig(bundler: 'rspack' | 'webpack') {
-  if (bundler === 'rspack') {
-    return {
-      cache: true,
-      experiments: { cache: { type: 'persistent' } },
-    };
+  if (isExperimentalCacheEnabled()) {
+    if (bundler === 'rspack') {
+      return {
+        cache: true,
+        experiments: { cache: { type: 'persistent' } },
+      };
+    }
+    return { cache: { type: 'filesystem' } };
   }
-
-  return { cache: { type: 'filesystem' } };
+  return {};
 }
 
 function getStartCommandDefaults(bundler: 'rspack' | 'webpack') {

packages/repack/src/env.ts

@@ -4,3 +4,5 @@ export const WORKER_ENV_KEY = 'REPACK_WORKER';
 export const BUNDLE_FILENAME_ENV_KEY = 'REPACK_BUNDLE_FILENAME';
 export const SOURCEMAP_FILENAME_ENV_KEY = 'REPACK_SOURCEMAP_FILENAME';
 export const ASSETS_DEST_ENV_KEY = 'REPACK_ASSETS_DEST';
+
+export const EXPERIMENTAL_CACHE_ENV_KEY = 'REPACK_EXPERIMENTAL_CACHE';