@pnpm/store.controller 1101.0.13 → 1102.0.0

package/lib/storeController/index.d.ts

@@ -22,6 +22,7 @@ export interface CreatePackageStoreOptions {
     strictStorePkgContentCheck?: boolean;
     clearResolutionCache: () => void;
     customFetchers?: CustomFetcher[];
+    frozenStore?: boolean;
     storeIndex: StoreIndex;
 }
 export declare function createPackageStore(resolve: ResolveFunction, fetchers: Fetchers, initOpts: CreatePackageStoreOptions): StoreController;

package/lib/storeController/index.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { PnpmError } from '@pnpm/error';
 import { createPackageRequester } from '@pnpm/installing.package-requester';
 import { createCafsStore, createPackageImporterAsync } from '@pnpm/store.create-cafs-store';
 import { addFilesFromDir, importPackage, initStoreDir } from '@pnpm/worker';
@@ -8,6 +9,13 @@ export {};
 export function createPackageStore(resolve, fetchers, initOpts) {
     const storeDir = initOpts.storeDir;
     if (!fs.existsSync(path.join(storeDir, 'files'))) {
+        // A missing `{storeDir}/files` means the store has no content directory yet.
+        // Under frozenStore the store is meant to be a complete, read-only seed, so
+        // this is a setup error: initializing it would be a write into a read-only
+        // store. Fail fast with actionable guidance instead of swallowing the write.
+        if (initOpts.frozenStore) {
+            throw new PnpmError('FROZEN_STORE_INCOMPLETE', `frozenStore is enabled but the store at ${storeDir} is missing its content directory (${path.join(storeDir, 'files')}). The store must be fully seeded before it can be used read-only.`);
+        }
         initStoreDir(storeDir).catch(() => { });
     }
     const cafs = createCafsStore(storeDir, {
@@ -29,6 +37,7 @@ export function createPackageStore(resolve, fetchers, initOpts) {
         virtualStoreDirMaxLength: initOpts.virtualStoreDirMaxLength,
         strictStorePkgContentCheck: initOpts.strictStorePkgContentCheck,
         customFetchers: initOpts.customFetchers,
+        frozenStore: initOpts.frozenStore,
     });
     return {
         close: async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/store.controller",
-  "version": "1101.0.13",
+  "version": "1102.0.0",
   "description": "A storage for packages",
   "keywords": [
     "pnpm",
@@ -43,31 +43,31 @@
     "ramda": "npm:@pnpm/ramda@0.28.1",
     "ssri": "13.0.1",
     "symlink-dir": "^10.0.1",
-    "@pnpm/crypto.hash": "1100.0.1",
     "@pnpm/error": "1100.0.0",
-    "@pnpm/fetching.fetcher-base": "1100.1.8",
-    "@pnpm/installing.package-requester": "1101.1.0",
-    "@pnpm/resolving.resolver-base": "1100.4.1",
-    "@pnpm/hooks.types": "1100.0.11",
-    "@pnpm/store.cafs": "1100.1.9",
-    "@pnpm/store.create-cafs-store": "1100.0.13",
-    "@pnpm/store.index": "1100.1.0",
-    "@pnpm/store.controller-types": "1100.1.4",
-    "@pnpm/types": "1101.3.1"
+    "@pnpm/crypto.hash": "1100.0.1",
+    "@pnpm/fetching.fetcher-base": "1100.1.9",
+    "@pnpm/hooks.types": "1100.0.12",
+    "@pnpm/resolving.resolver-base": "1100.4.2",
+    "@pnpm/store.cafs": "1100.1.10",
+    "@pnpm/installing.package-requester": "1102.0.0",
+    "@pnpm/store.controller-types": "1100.1.5",
+    "@pnpm/store.index": "1100.2.0",
+    "@pnpm/store.create-cafs-store": "1100.0.14",
+    "@pnpm/types": "1101.3.2"
   },
   "peerDependencies": {
-    "@pnpm/logger": "^1001.0.1",
-    "@pnpm/worker": "^1100.1.11"
+    "@pnpm/logger": "^1100.0.0",
+    "@pnpm/worker": "^1100.2.0"
   },
   "devDependencies": {
-    "@jest/globals": "30.3.0",
+    "@jest/globals": "30.4.1",
     "@types/ramda": "0.31.1",
     "@types/ssri": "^7.1.5",
     "tempy": "3.0.0",
     "@pnpm/logger": "1100.0.0",
-    "@pnpm/installing.client": "1100.2.7",
-    "@pnpm/prepare": "1100.0.15",
-    "@pnpm/store.controller": "1101.0.13"
+    "@pnpm/prepare": "1100.0.16",
+    "@pnpm/installing.client": "1100.2.8",
+    "@pnpm/store.controller": "1102.0.0"
   },
   "engines": {
     "node": ">=22.13"