@salesforce/storefront-next-dev 0.4.0-alpha.1 → 0.4.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/storefront-next-dev",
-  "version": "0.4.0-alpha.1",
+  "version": "0.4.0-alpha.2",
   "description": "Dev and build tools for SFCC Storefront Next",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,12 +13,6 @@
         "default": "./dist/index.js"
       }
     },
-    "./data-store/local-provider": {
-      "import": {
-        "types": "./dist/data-store/local-provider.d.ts",
-        "default": "./dist/data-store/local-provider.js"
-      }
-    },
     "./logger": {
       "import": {
         "types": "./dist/logger/index.d.ts",

package/dist/data-store/local-provider.d.ts

@@ -1,42 +0,0 @@
-//#region src/data-store/local-provider.d.ts
-/**
- * Copyright 2026 Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-type DataStoreEntry = {
-  value?: unknown;
-};
-type LocalDataStoreProvider = {
-  kind: 'local';
-  getEntry: (key: string) => Promise<DataStoreEntry | null>;
-};
-type LocalDataStoreProviderOptions = {
-  defaults?: Record<string, Record<string, unknown>>;
-  warnOnMissing?: boolean;
-};
-/**
- * Create a local data-store provider for development environments.
- *
- * Environment variables:
- * - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.
- *   Example: {"custom-global-preferences":{"featureFlag":true}}
- * - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to "false" to silence warnings.
- *
- * @param options - Optional defaults and warning controls for local entries.
- * @returns Local provider that supplies preferences from defaults or empty values.
- */
-declare function createLocalDataStoreProvider(options?: LocalDataStoreProviderOptions): LocalDataStoreProvider;
-//#endregion
-export { LocalDataStoreProvider, createLocalDataStoreProvider };
-//# sourceMappingURL=local-provider.d.ts.map

package/dist/data-store/local-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-provider.d.ts","names":[],"sources":["../../src/data-store/local-provider.ts"],"sourcesContent":[],"mappings":";;;AAoBA;AAGE;AAkBF;;;;;;;;;;;KAzBK,cAAA;;;KAIO,sBAAA;;6BAEmB,QAAQ;;KAGlC,6BAAA;aACU,eAAe;;;;;;;;;;;;;;iBAed,4BAAA,WAAsC,gCAAqC"}

package/dist/data-store/local-provider.js

@@ -1,66 +0,0 @@
-//#region src/data-store/local-provider.ts
-/**
-* Create a local data-store provider for development environments.
-*
-* Environment variables:
-* - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.
-*   Example: {"custom-global-preferences":{"featureFlag":true}}
-* - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to "false" to silence warnings.
-*
-* @param options - Optional defaults and warning controls for local entries.
-* @returns Local provider that supplies preferences from defaults or empty values.
-*/
-function createLocalDataStoreProvider(options = {}) {
-	const defaults = options.defaults ?? readDefaultsFromEnv();
-	const warnOnMissing = options.warnOnMissing ?? readWarnOnMissingFromEnv();
-	const warnedKeys = /* @__PURE__ */ new Set();
-	return {
-		kind: "local",
-		getEntry(key) {
-			const value = defaults[key];
-			if (value && typeof value === "object") return Promise.resolve({ value });
-			if (warnOnMissing && !warnedKeys.has(key)) {
-				warnedKeys.add(key);
-				console.warn(`Local data-store provider did not find '${key}'. Returning an empty object for development.`);
-			}
-			return Promise.resolve({ value: {} });
-		}
-	};
-}
-/**
-* Read default data-store entries from the environment.
-*
-* Environment variables:
-* - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.
-*   Example: {"custom-global-preferences":{"featureFlag":true}}
-*
-* @returns Parsed defaults map or an empty object.
-*/
-function readDefaultsFromEnv() {
-	const raw = process.env.SFNEXT_DATA_STORE_DEFAULTS;
-	if (!raw) return {};
-	try {
-		const parsed = JSON.parse(raw);
-		if (parsed && typeof parsed === "object") return parsed;
-	} catch (error) {
-		console.warn("Failed to parse SFNEXT_DATA_STORE_DEFAULTS JSON.", error);
-	}
-	return {};
-}
-/**
-* Read warn-on-missing behavior from the environment.
-*
-* Environment variables:
-* - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to "false" to silence warnings.
-*
-* @returns True when warnings should be emitted for missing entries.
-*/
-function readWarnOnMissingFromEnv() {
-	const raw = process.env.SFNEXT_DATA_STORE_WARN_ON_MISSING;
-	if (!raw) return true;
-	return raw.toLowerCase() !== "false";
-}
-
-//#endregion
-export { createLocalDataStoreProvider };
-//# sourceMappingURL=local-provider.js.map

package/dist/data-store/local-provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-provider.js","names":[],"sources":["../../src/data-store/local-provider.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\ntype DataStoreEntry = {\n    value?: unknown;\n};\n\nexport type LocalDataStoreProvider = {\n    kind: 'local';\n    getEntry: (key: string) => Promise<DataStoreEntry | null>;\n};\n\ntype LocalDataStoreProviderOptions = {\n    defaults?: Record<string, Record<string, unknown>>;\n    warnOnMissing?: boolean;\n};\n\n/**\n * Create a local data-store provider for development environments.\n *\n * Environment variables:\n * - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.\n *   Example: {\"custom-global-preferences\":{\"featureFlag\":true}}\n * - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to \"false\" to silence warnings.\n *\n * @param options - Optional defaults and warning controls for local entries.\n * @returns Local provider that supplies preferences from defaults or empty values.\n */\nexport function createLocalDataStoreProvider(options: LocalDataStoreProviderOptions = {}): LocalDataStoreProvider {\n    const defaults = options.defaults ?? readDefaultsFromEnv();\n    const warnOnMissing = options.warnOnMissing ?? readWarnOnMissingFromEnv();\n    const warnedKeys = new Set<string>();\n\n    return {\n        kind: 'local',\n        getEntry(key: string) {\n            const value = defaults[key];\n            if (value && typeof value === 'object') {\n                return Promise.resolve({ value });\n            }\n\n            if (warnOnMissing && !warnedKeys.has(key)) {\n                warnedKeys.add(key);\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `Local data-store provider did not find '${key}'. Returning an empty object for development.`\n                );\n            }\n\n            return Promise.resolve({ value: {} });\n        },\n    };\n}\n\n/**\n * Read default data-store entries from the environment.\n *\n * Environment variables:\n * - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.\n *   Example: {\"custom-global-preferences\":{\"featureFlag\":true}}\n *\n * @returns Parsed defaults map or an empty object.\n */\nfunction readDefaultsFromEnv(): Record<string, Record<string, unknown>> {\n    const raw = process.env.SFNEXT_DATA_STORE_DEFAULTS;\n    if (!raw) {\n        return {};\n    }\n\n    try {\n        const parsed = JSON.parse(raw);\n        if (parsed && typeof parsed === 'object') {\n            return parsed as Record<string, Record<string, unknown>>;\n        }\n    } catch (error) {\n        // eslint-disable-next-line no-console\n        console.warn('Failed to parse SFNEXT_DATA_STORE_DEFAULTS JSON.', error);\n    }\n\n    return {};\n}\n\n/**\n * Read warn-on-missing behavior from the environment.\n *\n * Environment variables:\n * - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to \"false\" to silence warnings.\n *\n * @returns True when warnings should be emitted for missing entries.\n */\nfunction readWarnOnMissingFromEnv(): boolean {\n    const raw = process.env.SFNEXT_DATA_STORE_WARN_ON_MISSING;\n    if (!raw) {\n        return true;\n    }\n    return raw.toLowerCase() !== 'false';\n}\n"],"mappings":";;;;;;;;;;;;AAyCA,SAAgB,6BAA6B,UAAyC,EAAE,EAA0B;CAC9G,MAAM,WAAW,QAAQ,YAAY,qBAAqB;CAC1D,MAAM,gBAAgB,QAAQ,iBAAiB,0BAA0B;CACzE,MAAM,6BAAa,IAAI,KAAa;AAEpC,QAAO;EACH,MAAM;EACN,SAAS,KAAa;GAClB,MAAM,QAAQ,SAAS;AACvB,OAAI,SAAS,OAAO,UAAU,SAC1B,QAAO,QAAQ,QAAQ,EAAE,OAAO,CAAC;AAGrC,OAAI,iBAAiB,CAAC,WAAW,IAAI,IAAI,EAAE;AACvC,eAAW,IAAI,IAAI;AAEnB,YAAQ,KACJ,2CAA2C,IAAI,+CAClD;;AAGL,UAAO,QAAQ,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;;EAE5C;;;;;;;;;;;AAYL,SAAS,sBAA+D;CACpE,MAAM,MAAM,QAAQ,IAAI;AACxB,KAAI,CAAC,IACD,QAAO,EAAE;AAGb,KAAI;EACA,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,SAC5B,QAAO;UAEN,OAAO;AAEZ,UAAQ,KAAK,oDAAoD,MAAM;;AAG3E,QAAO,EAAE;;;;;;;;;;AAWb,SAAS,2BAAoC;CACzC,MAAM,MAAM,QAAQ,IAAI;AACxB,KAAI,CAAC,IACD,QAAO;AAEX,QAAO,IAAI,aAAa,KAAK"}