@salesforce/storefront-next-runtime 0.1.1-alpha.0 → 0.2.0-alpha.0

package/dist/routing-app-wrapper.d.ts

@@ -0,0 +1,18 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/routing/app-wrapper.d.ts
+
+/**
+ * A pass-through wrapper component that renders an `<Outlet />`.
+ *
+ * Used as the parent route component when URL configuration wraps routes under
+ * a prefix (e.g. `/:siteId/:localeId`). React Router requires a component for
+ * every route entry — this satisfies that requirement without adding any UI.
+ *
+ * Customers re-export this from their own `routes/app-wrapper.tsx` so the file
+ * lives inside `appDirectory` and React Router generates correct type references.
+ */
+declare function AppWrapper(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AppWrapper as default };
+//# sourceMappingURL=routing-app-wrapper.d.ts.map

package/dist/routing-app-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-app-wrapper.d.ts","names":[],"sources":["../src/routing/app-wrapper.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA2BkC;;;;;;;iBAAV,UAAA,CAAA,GAAU,kBAAA,CAAA,GAAA,CAAA"}

package/dist/routing-app-wrapper.js

@@ -0,0 +1,21 @@
+import { jsx } from "react/jsx-runtime";
+import { Outlet } from "react-router";
+
+//#region src/routing/app-wrapper.tsx
+/**
+* A pass-through wrapper component that renders an `<Outlet />`.
+*
+* Used as the parent route component when URL configuration wraps routes under
+* a prefix (e.g. `/:siteId/:localeId`). React Router requires a component for
+* every route entry — this satisfies that requirement without adding any UI.
+*
+* Customers re-export this from their own `routes/app-wrapper.tsx` so the file
+* lives inside `appDirectory` and React Router generates correct type references.
+*/
+function AppWrapper() {
+	return /* @__PURE__ */ jsx(Outlet, {});
+}
+
+//#endregion
+export { AppWrapper as default };
+//# sourceMappingURL=routing-app-wrapper.js.map

package/dist/routing-app-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-app-wrapper.js","names":[],"sources":["../src/routing/app-wrapper.tsx"],"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 */\nimport { Outlet } from 'react-router';\n\n/**\n * A pass-through wrapper component that renders an `<Outlet />`.\n *\n * Used as the parent route component when URL configuration wraps routes under\n * a prefix (e.g. `/:siteId/:localeId`). React Router requires a component for\n * every route entry — this satisfies that requirement without adding any UI.\n *\n * Customers re-export this from their own `routes/app-wrapper.tsx` so the file\n * lives inside `appDirectory` and React Router generates correct type references.\n */\nexport default function AppWrapper() {\n    return <Outlet />;\n}\n"],"mappings":";;;;;;;;;;;;;;AA2BA,SAAwB,aAAa;AACjC,QAAO,oBAAC,WAAS"}

package/dist/routing.d.ts

@@ -0,0 +1,42 @@
+import { RouteConfigEntry } from "@react-router/dev/routes";
+
+//#region src/routing/flat-routes.d.ts
+
+/**
+ * Discovers all file-based routes, merges extension routes, and applies multi-site
+ * URL configuration if defined in the project's `config.server.ts`.
+ *
+ * 1. Discover routes from the filesystem using React Router's `flatRoutes`.
+ * 2. Scans `src/extensions/` for extension routes and merges them into the route tree.
+ * 3. Load `config.server.ts` from the project root and, if `app.url` is configured,
+ *    wraps routes under the URL prefix (e.g. `/:siteId/:localeId`).
+ *
+ * @param options.ignoredRouteFiles - Glob patterns for files to ignore. Defaults to test files.
+ * @param options.rootDirectory - Root directory for route discovery, relative to appDirectory.
+ * @returns The final route config entries for React Router.
+ */
+declare function flatRoutes(options?: {
+  ignoredRouteFiles?: string[];
+  rootDirectory?: string;
+}): Promise<RouteConfigEntry[]>;
+//#endregion
+//#region src/routing/merge-routes.d.ts
+
+/**
+ * Merges extension routes into the main routes array, handling route nesting.
+ * Routes without IDs are added directly to the routes array. Routes with IDs are processed
+ * to remove the extension prefix and are either:
+ * - Added as children of existing routes (if a nearest route is found via prefix matching)
+ * - Replace existing routes (if an exact match is found)
+ * - Added directly to the routes array (if no matching route exists)
+ *
+ * When adding as a child, the parent route's path is clipped from the child route's path.
+ *
+ * @param routes - The main routes array to merge into (mutated in place)
+ * @param extensionRoutes - The extension routes to merge
+ * @param extensionIdPrefix - The prefix to remove from extension route IDs (e.g., "extensions/store-locator/")
+ */
+declare function mergeRoutes(routes: RouteConfigEntry[], extensionRoutes: RouteConfigEntry[], extensionIdPrefix: string): void;
+//#endregion
+export { flatRoutes, mergeRoutes };
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","names":[],"sources":["../src/routing/flat-routes.ts","../src/routing/merge-routes.ts"],"sourcesContent":[],"mappings":";;;;;;AAwEA;;;;ACTA;;;;;;;iBDSsB,UAAA;;;IAGlB,QAAQ;;;;;;;;;;;;;;;;;;iBCZI,WAAA,SACJ,qCACS"}

package/dist/routing.js

@@ -0,0 +1,171 @@
+import { t as applyUrlConfig } from "./apply-url-config.js";
+import { flatRoutes as flatRoutes$1 } from "@react-router/fs-routes";
+import fs from "node:fs/promises";
+import path from "node:path";
+import fs$1 from "node:fs";
+import { pathToFileURL } from "node:url";
+
+//#region src/routing/merge-routes.ts
+/**
+* Find the nearest route by its ID in the route tree
+* @param routes - The route subtree to search
+* @param layoutId - The route ID to find (e.g., "routes/_app" or "routes/_app.account")
+* @param rootPath - The full route path from the root to the current route (default: '')
+* @returns An object with routes array, routeIndex, and path, or null if not found. Returns exact match if found, otherwise returns route where route.id is a prefix of layoutId
+*/
+function findNearestRoute(routes, layoutId, rootPath = "") {
+	for (let i = 0; i < routes.length; i++) {
+		const route = routes[i];
+		const path$1 = route.path ? `${rootPath}/${route.path}` : rootPath;
+		if (route.id === layoutId) return {
+			routes,
+			routeIndex: i,
+			path: path$1
+		};
+		if (route.children) {
+			const found = findNearestRoute(route.children, layoutId, path$1);
+			if (found) return found;
+		}
+		if (route.id && layoutId.startsWith(route.id)) return {
+			routes,
+			routeIndex: i,
+			path: path$1
+		};
+	}
+	return null;
+}
+/**
+* Merges extension routes into the main routes array, handling route nesting.
+* Routes without IDs are added directly to the routes array. Routes with IDs are processed
+* to remove the extension prefix and are either:
+* - Added as children of existing routes (if a nearest route is found via prefix matching)
+* - Replace existing routes (if an exact match is found)
+* - Added directly to the routes array (if no matching route exists)
+*
+* When adding as a child, the parent route's path is clipped from the child route's path.
+*
+* @param routes - The main routes array to merge into (mutated in place)
+* @param extensionRoutes - The extension routes to merge
+* @param extensionIdPrefix - The prefix to remove from extension route IDs (e.g., "extensions/store-locator/")
+*/
+function mergeRoutes(routes, extensionRoutes, extensionIdPrefix) {
+	for (const route of extensionRoutes) {
+		if (!route.id) {
+			routes.unshift(route);
+			continue;
+		}
+		const routeId = route.id.replace(extensionIdPrefix, "");
+		const nearestRouteResult = findNearestRoute(routes, routeId);
+		if (nearestRouteResult) {
+			const nearestRoute = nearestRouteResult.routes[nearestRouteResult.routeIndex];
+			if (nearestRoute.id === routeId) nearestRouteResult.routes[nearestRouteResult.routeIndex].file = route.file;
+			else {
+				let path$1 = route.path?.slice(nearestRouteResult.path.length);
+				if (path$1?.startsWith("/")) path$1 = path$1.slice(1);
+				path$1 = path$1 ? path$1 : void 0;
+				if (!nearestRoute.children) nearestRoute.children = [];
+				nearestRoute.children.unshift({
+					...route,
+					id: routeId,
+					path: path$1
+				});
+			}
+		} else routes.unshift({
+			...route,
+			id: routeId
+		});
+	}
+}
+
+//#endregion
+//#region src/config/load-config.ts
+/**
+* Dynamically imports `config.server.ts` from the project root (CWD) and returns
+* the `app` configuration object. This runs at route discovery time under vite-node
+* (typegen, dev, build), which handles the TS transformation.
+*
+* - If the config file is missing, warns and returns an empty config.
+* - If the config file exists but fails to import, throws with the original error as cause.
+*
+* @returns The `app` configuration object, or an empty object if not available.
+*/
+async function loadConfig() {
+	const configPath = path.resolve(process.cwd(), "config.server.ts");
+	if (!fs$1.existsSync(configPath)) {
+		console.warn(`[storefront-next-runtime] config.server.ts not found at ${configPath}. Returning empty config.`);
+		return {};
+	}
+	try {
+		const mod = await import(
+			/* @vite-ignore */
+			pathToFileURL(configPath).href
+);
+		return (mod.default ?? mod)?.app ?? {};
+	} catch (error) {
+		throw new Error(`[storefront-next-runtime] Found config.server.ts at ${configPath} but failed to import it.`, { cause: error });
+	}
+}
+
+//#endregion
+//#region src/routing/flat-routes.ts
+const APP_SRC_DIR = "src";
+const EXTENSIONS_DIR = "extensions";
+const APP_WRAPPER_FILE = "app-wrapper.tsx";
+/**
+* Scans `src/extensions/` for extension route directories and merges any discovered
+* routes into the base route tree. Mutates `routes` in place via `mergeRoutes`.
+*/
+async function discoverExtensionRoutes(ignoredRouteFiles, routes) {
+	const extensionsDir = path.join(".", APP_SRC_DIR, EXTENSIONS_DIR);
+	const extensions = await fs.readdir(extensionsDir).then((entries) => entries.sort(), () => []);
+	for (const ext of extensions) {
+		const routesDir = `${EXTENSIONS_DIR}/${ext}/routes`;
+		const routesDirFull = path.join(".", APP_SRC_DIR, EXTENSIONS_DIR, ext, "routes");
+		try {
+			await fs.access(routesDirFull);
+			mergeRoutes(routes, await flatRoutes$1({
+				ignoredRouteFiles,
+				rootDirectory: routesDir
+			}), `${EXTENSIONS_DIR}/${ext}/`);
+		} catch {}
+	}
+}
+/**
+* Discovers all file-based routes, merges extension routes, and applies multi-site
+* URL configuration if defined in the project's `config.server.ts`.
+*
+* 1. Discover routes from the filesystem using React Router's `flatRoutes`.
+* 2. Scans `src/extensions/` for extension routes and merges them into the route tree.
+* 3. Load `config.server.ts` from the project root and, if `app.url` is configured,
+*    wraps routes under the URL prefix (e.g. `/:siteId/:localeId`).
+*
+* @param options.ignoredRouteFiles - Glob patterns for files to ignore. Defaults to test files.
+* @param options.rootDirectory - Root directory for route discovery, relative to appDirectory.
+* @returns The final route config entries for React Router.
+*/
+async function flatRoutes(options) {
+	const { ignoredRouteFiles = ["**/*.test.{ts,tsx}"], rootDirectory } = options ?? {};
+	const routes = await flatRoutes$1({
+		ignoredRouteFiles,
+		rootDirectory
+	});
+	await discoverExtensionRoutes(ignoredRouteFiles, routes);
+	const { url: urlConfig } = await loadConfig();
+	if (urlConfig?.prefix) {
+		try {
+			await fs.access(path.join(".", APP_SRC_DIR, APP_WRAPPER_FILE));
+		} catch {
+			throw new Error(`[storefront-next-runtime] URL prefix "${urlConfig.prefix}" is configured but "${APP_SRC_DIR}/${APP_WRAPPER_FILE}" does not exist. Create this file with: export { default } from '@salesforce/storefront-next-runtime/routing/app-wrapper';`);
+		}
+		return applyUrlConfig({
+			routes,
+			urlConfig,
+			wrapperFile: APP_WRAPPER_FILE
+		});
+	}
+	return routes;
+}
+
+//#endregion
+export { flatRoutes, mergeRoutes };
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","names":["path","fs","_flatRoutes"],"sources":["../src/routing/merge-routes.ts","../src/config/load-config.ts","../src/routing/flat-routes.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 */\nimport { type RouteConfigEntry } from '@react-router/dev/routes';\n\n/**\n * Find the nearest route by its ID in the route tree\n * @param routes - The route subtree to search\n * @param layoutId - The route ID to find (e.g., \"routes/_app\" or \"routes/_app.account\")\n * @param rootPath - The full route path from the root to the current route (default: '')\n * @returns An object with routes array, routeIndex, and path, or null if not found. Returns exact match if found, otherwise returns route where route.id is a prefix of layoutId\n */\nfunction findNearestRoute(\n    routes: RouteConfigEntry[],\n    layoutId: string,\n    rootPath: string = ''\n): { routes: RouteConfigEntry[]; routeIndex: number; path: string } | null {\n    for (let i = 0; i < routes.length; i++) {\n        const route = routes[i];\n        const path = route.path ? `${rootPath}/${route.path}` : rootPath;\n        if (route.id === layoutId) {\n            return { routes, routeIndex: i, path };\n        }\n        if (route.children) {\n            const found = findNearestRoute(route.children, layoutId, path);\n            if (found) {\n                return found;\n            }\n        }\n        // Check if route.id is a prefix of layoutId, indicating a nested route\n        if (route.id && layoutId.startsWith(route.id)) {\n            return { routes, routeIndex: i, path };\n        }\n    }\n    return null;\n}\n\n/**\n * Merges extension routes into the main routes array, handling route nesting.\n * Routes without IDs are added directly to the routes array. Routes with IDs are processed\n * to remove the extension prefix and are either:\n * - Added as children of existing routes (if a nearest route is found via prefix matching)\n * - Replace existing routes (if an exact match is found)\n * - Added directly to the routes array (if no matching route exists)\n *\n * When adding as a child, the parent route's path is clipped from the child route's path.\n *\n * @param routes - The main routes array to merge into (mutated in place)\n * @param extensionRoutes - The extension routes to merge\n * @param extensionIdPrefix - The prefix to remove from extension route IDs (e.g., \"extensions/store-locator/\")\n */\nexport function mergeRoutes(\n    routes: RouteConfigEntry[],\n    extensionRoutes: RouteConfigEntry[],\n    extensionIdPrefix: string\n): void {\n    for (const route of extensionRoutes) {\n        if (!route.id) {\n            routes.unshift(route);\n            continue;\n        }\n        const routeId = route.id.replace(extensionIdPrefix, '');\n        const nearestRouteResult = findNearestRoute(routes, routeId);\n        if (nearestRouteResult) {\n            const nearestRoute = nearestRouteResult.routes[nearestRouteResult.routeIndex];\n            if (nearestRoute.id === routeId) {\n                // Replacing an existing route, we assume we can just swap out the implementation\n                nearestRouteResult.routes[nearestRouteResult.routeIndex].file = route.file;\n            } else {\n                // This is a new child of an existing route, insert it at the beginning of the children array\n                // and clip out the parent path from the route path\n                let path = route.path?.slice(nearestRouteResult.path.length);\n                if (path?.startsWith('/')) {\n                    path = path.slice(1);\n                }\n                path = path ? path : undefined;\n                if (!nearestRoute.children) {\n                    nearestRoute.children = [];\n                }\n                nearestRoute.children.unshift({\n                    ...route,\n                    id: routeId,\n                    path,\n                });\n            }\n        } else {\n            // This is a new route, insert it at the beginning of the routes array\n            routes.unshift({\n                ...route,\n                id: routeId,\n            });\n        }\n    }\n}\n","/**\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 */\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\n/**\n * Dynamically imports `config.server.ts` from the project root (CWD) and returns\n * the `app` configuration object. This runs at route discovery time under vite-node\n * (typegen, dev, build), which handles the TS transformation.\n *\n * - If the config file is missing, warns and returns an empty config.\n * - If the config file exists but fails to import, throws with the original error as cause.\n *\n * @returns The `app` configuration object, or an empty object if not available.\n */\n// TODO: add a proper type when config schema is moved to runtime from the template\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function loadConfig(): Promise<Record<string, any>> {\n    const configPath = path.resolve(process.cwd(), 'config.server.ts');\n\n    if (!fs.existsSync(configPath)) {\n        console.warn(\n            `[storefront-next-runtime] config.server.ts not found at ${configPath}. ` + `Returning empty config.`\n        );\n        return {};\n    }\n\n    try {\n        // The @vite-ignore comment suppresses Vite's \"dynamic import cannot be analyzed\" warning.\n        // It must be placed on the variable value (not inside import()) so that rolldown's\n        // single-use variable inlining carries it into the import() expression in the built output.\n        // See: https://github.com/nicolo-ribaudo/rolldown/issues/6263\n        const importPath = /* @vite-ignore */ pathToFileURL(configPath).href;\n\n        const mod = await import(importPath);\n        const config = mod.default ?? mod;\n        return config?.app ?? {};\n    } catch (error) {\n        throw new Error(`[storefront-next-runtime] Found config.server.ts at ${configPath} but failed to import it.`, {\n            cause: error,\n        });\n    }\n}\n","/**\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 */\nimport { flatRoutes as _flatRoutes } from '@react-router/fs-routes';\nimport type { RouteConfigEntry } from '@react-router/dev/routes';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { mergeRoutes } from './merge-routes';\nimport { applyUrlConfig } from '../multi-site/apply-url-config';\nimport { loadConfig } from '../config/load-config';\n\nconst APP_SRC_DIR = 'src';\nconst EXTENSIONS_DIR = 'extensions';\n// This file must live at the root of `appDirectory` (src/app-wrapper.tsx) and must NOT\n// be moved into a subdirectory. React Router's typegen resolves route module types using\n// paths relative to `appDirectory` — placing it elsewhere breaks generated type references.\nconst APP_WRAPPER_FILE = 'app-wrapper.tsx';\n\n/**\n * Scans `src/extensions/` for extension route directories and merges any discovered\n * routes into the base route tree. Mutates `routes` in place via `mergeRoutes`.\n */\nasync function discoverExtensionRoutes(ignoredRouteFiles: string[], routes: RouteConfigEntry[]): Promise<void> {\n    const extensionsDir = path.join('.', APP_SRC_DIR, EXTENSIONS_DIR);\n\n    // Sort to ensure deterministic route order across platforms (readdir order is filesystem-dependent)\n    const extensions = await fs.readdir(extensionsDir).then(\n        (entries) => entries.sort(),\n        () => []\n    );\n    for (const ext of extensions) {\n        // React Router rootDirectory uses forward slashes regardless of OS\n        const routesDir = `${EXTENSIONS_DIR}/${ext}/routes`;\n        const routesDirFull = path.join('.', APP_SRC_DIR, EXTENSIONS_DIR, ext, 'routes');\n        try {\n            await fs.access(routesDirFull);\n            const extensionRoutes = await _flatRoutes({\n                ignoredRouteFiles,\n                rootDirectory: routesDir,\n            });\n            mergeRoutes(routes, extensionRoutes, `${EXTENSIONS_DIR}/${ext}/`);\n        } catch {\n            // Extension has no routes directory — skip\n        }\n    }\n}\n\n/**\n * Discovers all file-based routes, merges extension routes, and applies multi-site\n * URL configuration if defined in the project's `config.server.ts`.\n *\n * 1. Discover routes from the filesystem using React Router's `flatRoutes`.\n * 2. Scans `src/extensions/` for extension routes and merges them into the route tree.\n * 3. Load `config.server.ts` from the project root and, if `app.url` is configured,\n *    wraps routes under the URL prefix (e.g. `/:siteId/:localeId`).\n *\n * @param options.ignoredRouteFiles - Glob patterns for files to ignore. Defaults to test files.\n * @param options.rootDirectory - Root directory for route discovery, relative to appDirectory.\n * @returns The final route config entries for React Router.\n */\nexport async function flatRoutes(options?: {\n    ignoredRouteFiles?: string[];\n    rootDirectory?: string;\n}): Promise<RouteConfigEntry[]> {\n    const { ignoredRouteFiles = ['**/*.test.{ts,tsx}'], rootDirectory } = options ?? {};\n\n    // 1. Discover base routes from filesystem\n    const routes = await _flatRoutes({ ignoredRouteFiles, rootDirectory });\n\n    // 2. Discover and merge extension routes\n    await discoverExtensionRoutes(ignoredRouteFiles, routes);\n\n    // 3. Try to load URL config from template's config file\n    const { url: urlConfig } = await loadConfig();\n    if (urlConfig?.prefix) {\n        try {\n            await fs.access(path.join('.', APP_SRC_DIR, APP_WRAPPER_FILE));\n        } catch {\n            throw new Error(\n                `[storefront-next-runtime] URL prefix \"${urlConfig.prefix}\" is configured but ` +\n                    `\"${APP_SRC_DIR}/${APP_WRAPPER_FILE}\" does not exist. ` +\n                    `Create this file with: export { default } from '@salesforce/storefront-next-runtime/routing/app-wrapper';`\n            );\n        }\n\n        return applyUrlConfig({\n            routes,\n            urlConfig,\n            wrapperFile: APP_WRAPPER_FILE,\n        });\n    }\n\n    return routes;\n}\n"],"mappings":"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"}

package/dist/scapi.d.ts

@@ -27805,6 +27805,8 @@ interface AuthConfig {
   siteId: string;
   /** Base URL for Commerce API (e.g., 'https://{shortCode}.api.commercecloud.salesforce.com') */
   baseUrl: string;
+  /** Direct SCAPI proxy URL for workspace environments. When set, guest login uses client_credentials grant directly. */
+  proxyHost?: string;
 }
 /**
  * Options for guest login.
@@ -27846,6 +27848,13 @@ interface LogoutOptions {
   /** The current refresh token */
   refreshToken: string;
 }
+/**
+ * Delivery modes for passwordless login and password reset.
+ * - 'callback': SLAS calls your callback URL with the token (requires Marketing Cloud for email)
+ * - 'sms': SLAS sends an SMS with the code directly
+ * - 'email': SLAS sends an email with the OTP code directly (no Marketing Cloud needed)
+ */
+type PasswordActionMode = 'callback' | 'sms' | 'email';
 /**
  * Options for initiating passwordless login.
  */
@@ -27856,8 +27865,22 @@ interface PasswordlessAuthorizeOptions {
   callbackUri?: string;
   /** Unique Shopper Identifier to link to a previous session */
   usid?: string;
-  /** Login mode: 'callback' for magic link, 'sms' for SMS code */
-  mode?: 'callback' | 'sms';
+  /** Method to receive OTP */
+  mode: PasswordActionMode;
+  /** Locale of the template */
+  locale?: string;
+  /** When true, creates a new customer profile if one doesn't exist */
+  registerCustomer?: boolean;
+  /** User's last name (required when registerCustomer is true) */
+  lastName?: string;
+  /** User's email address (required when registerCustomer is true and userId is not an email) */
+  email?: string;
+  /** User's first name (optional when registerCustomer is true) */
+  firstName?: string;
+  /** User's phone number (optional when registerCustomer is true) */
+  phoneNumber?: string;
+  /** Customer number to assign (optional when registerCustomer is true) */
+  customerNo?: string;
 }
 /**
  * Options for exchanging a passwordless login token for access tokens.
@@ -27877,7 +27900,11 @@ interface PasswordRequestResetOptions {
   /** User's email address */
   userId: string;
   /** Callback URI for the password reset link */
-  callbackUri: string;
+  callbackUri?: string;
+  /** Locale of the template */
+  locale?: string;
+  /** Method to receive OTP */
+  mode: PasswordActionMode;
 }
 /**
  * Options for resetting a password with a token.
@@ -29016,6 +29043,16 @@ interface CommerceApiClientConfig extends ClientOptions {
   clientSecret?: string;
   /** OAuth redirect URI - must be registered in SLAS configuration */
   redirectUri: string;
+  /** Optional callback when access token is invalidated */
+  onAuthTokenInvalid?: (response: Response) => void;
+  /**
+   * Direct SCAPI proxy URL for workspace environments (e.g., 'https://scw:25010').
+   * When set, the SDK automatically:
+   * - Strips 'f_ecom_' prefix from organizationId for SLAS auth endpoints
+   * - Rewrites org IDs back to full form for product/search API endpoints
+   * - Uses client_credentials grant for guest login (no PKCE)
+   */
+  proxyHost?: string;
 }
 type Clients = {
   shopperBasketsV1: ProxyClient<Client<ShopperBasketsV1.endpoints>, typeof operations>;
@@ -29043,6 +29080,13 @@ type Clients = {
 declare function createCommerceApiClients(config: CommerceApiClientConfig): Clients;
 //#endregion
 //#region src/scapi-client/createClient.d.ts
+/**
+ * Optional hooks for client behavior.
+ */
+interface CreateClientOptions {
+  /** Callback invoked when an auth token is deemed invalid */
+  onAuthTokenInvalid?: (response: Response) => void;
+}
 /**
  * Global request parameters that are automatically merged into every API call.
  *
@@ -29109,7 +29153,7 @@ interface GlobalRequestParameters {
  * });
  * ```
  */
-declare function createClient<TClient extends Client<any, any>, TOperations extends OperationMap>(client: TClient, operations: TOperations, globalParams?: GlobalRequestParameters): ProxyClient<TClient, TOperations>;
+declare function createClient<TClient extends Client<any, any>, TOperations extends OperationMap>(client: TClient, operations: TOperations, globalParams?: GlobalRequestParameters, options?: CreateClientOptions): ProxyClient<TClient, TOperations>;
 //#endregion
 //#region src/scapi-client/ApiError.d.ts
 /**
@@ -29240,6 +29284,26 @@ declare class ApiError extends Error {
   };
 }
 //#endregion
+//#region src/scapi-client/AuthTokenInvalidError.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.
+ */
+declare class AuthTokenInvalidError extends Error {
+  constructor(message?: string);
+}
+//#endregion
 //#region src/scapi-client/constants.d.ts
 /**
  * Copyright 2026 Salesforce, Inc.
@@ -29274,5 +29338,5 @@ declare class ApiError extends Error {
  */
 declare const SLAS_AUTH_ENDPOINTS: readonly ["/oauth2/token", "/oauth2/authorize", "/oauth2/logout", "/oauth2/login", "/oauth2/passwordless", "/oauth2/password", "/oauth2/session-bridge", "/oauth2/trusted-agent", "/oauth2/trusted-system", "/oauth2/revoke", "/oauth2/introspect"];
 //#endregion
-export { ApiError, type AuthConfig, type AuthNamespace, type AuthResponse, type Basket, type BasketHelpersConfig, type BasketHelpersNamespace, Clients, CommerceApiClientConfig, type ErrorDetail, type GetOrCreateBasketOptions, GlobalRequestParameters, type LoginAsGuestOptions, type LoginWithCredentialsOptions, type LogoutOptions, type OperationMethodsOnly, type PasswordRequestResetOptions, type PasswordResetOptions, type PasswordlessAuthorizeOptions, type PasswordlessExchangeTokenOptions, type RefreshTokenOptions, SLAS_AUTH_ENDPOINTS, ShopperBasketsV1, ShopperBasketsV2, type ShopperBasketsV2Client, ShopperConfigurations, ShopperConsents, ShopperContext, ShopperCustomers, ShopperExperience, ShopperGiftCertificates, ShopperLogin, ShopperOrders, ShopperPayments, ShopperProducts, ShopperPromotions, ShopperSearch, ShopperSeo, ShopperStores, type SocialAuthorizationUrlResult, type SocialExchangeCodeOptions, type SocialGetAuthorizationUrlOptions, type TokenResponse, createBasketHelpers, createClient, createCommerceApiClients };
+export { ApiError, type AuthConfig, type AuthNamespace, type AuthResponse, AuthTokenInvalidError, type Basket, type BasketHelpersConfig, type BasketHelpersNamespace, Clients, CommerceApiClientConfig, CreateClientOptions, type ErrorDetail, type GetOrCreateBasketOptions, GlobalRequestParameters, type LoginAsGuestOptions, type LoginWithCredentialsOptions, type LogoutOptions, type OperationMethodsOnly, type PasswordRequestResetOptions, type PasswordResetOptions, type PasswordlessAuthorizeOptions, type PasswordlessExchangeTokenOptions, type RefreshTokenOptions, SLAS_AUTH_ENDPOINTS, ShopperBasketsV1, ShopperBasketsV2, type ShopperBasketsV2Client, ShopperConfigurations, ShopperConsents, ShopperContext, ShopperCustomers, ShopperExperience, ShopperGiftCertificates, ShopperLogin, ShopperOrders, ShopperPayments, ShopperProducts, ShopperPromotions, ShopperSearch, ShopperSeo, ShopperStores, type SocialAuthorizationUrlResult, type SocialExchangeCodeOptions, type SocialGetAuthorizationUrlOptions, type TokenResponse, createBasketHelpers, createClient, createCommerceApiClients };
 //# sourceMappingURL=scapi.d.ts.map