@salesforce/b2c-tooling-sdk 1.24.2 → 2.0.0

package/dist/esm/clients/slas-shopper.generated.d.ts

@@ -0,0 +1,165 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/oauth2/authorize": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: {
+            parameters: {
+                query: {
+                    client_id: string;
+                    response_type: "code";
+                    redirect_uri: string;
+                    hint: "guest";
+                    code_challenge: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                303: components["responses"]["AuthorizationRedirect"];
+                default: components["responses"]["Error"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/oauth2/login": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/x-www-form-urlencoded": {
+                        client_id: string;
+                        channel_id: string;
+                        code_challenge: string;
+                        redirect_uri: string;
+                    };
+                };
+            };
+            responses: {
+                303: components["responses"]["AuthorizationRedirect"];
+                default: components["responses"]["Error"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/oauth2/token": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/x-www-form-urlencoded": {
+                        /** @enum {string} */
+                        grant_type: "client_credentials" | "authorization_code_pkce";
+                        channel_id: string;
+                        client_id?: string;
+                        code?: string;
+                        code_verifier?: string;
+                        redirect_uri?: string;
+                        usid?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Shopper access token */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            access_token: string;
+                            refresh_token: string;
+                            expires_in: number;
+                            token_type: string;
+                            usid: string;
+                            customer_id: string;
+                            id_token?: string;
+                        };
+                    };
+                };
+                default: components["responses"]["Error"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: never;
+    responses: {
+        /** @description Authorization code returned in the Location header */
+        AuthorizationRedirect: {
+            headers: {
+                Location: string;
+                [name: string]: unknown;
+            };
+            content?: never;
+        };
+        /** @description SLAS error response */
+        Error: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": {
+                    [key: string]: unknown;
+                };
+            };
+        };
+    };
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type operations = Record<string, never>;

package/dist/esm/clients/slas-shopper.generated.js

@@ -0,0 +1,6 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};
+//# sourceMappingURL=slas-shopper.generated.js.map

package/dist/esm/clients/slas-shopper.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slas-shopper.generated.js","sourceRoot":"","sources":["../../../src/clients/slas-shopper.generated.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/esm/clients/slas-shopper.js

@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import createClient, {} from 'openapi-fetch';
+import { wrapNetworkError } from '../errors/network-error.js';
+import { createLoggingMiddleware } from './middleware.js';
+import { globalMiddlewareRegistry } from './middleware-registry.js';
+/**
+ * Creates a client for the shopper authorization, login, and token endpoints.
+ * Authentication is supplied per request: shopper credentials for login,
+ * client credentials for private token exchanges, and PKCE for public clients.
+ */
+export function createSlasShopperClient(config) {
+    const registry = config.middlewareRegistry ?? globalMiddlewareRegistry;
+    const client = createClient({
+        baseUrl: `https://${config.shortCode}.api.commercecloud.salesforce.com/shopper/auth/v1/organizations/${config.organizationId}`,
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        bodySerializer: (body) => new URLSearchParams(body).toString(),
+        redirect: 'manual',
+        signal: config.signal,
+    });
+    client.use({
+        onError({ error, request }) {
+            throw wrapNetworkError(error, { operation: 'SLAS token request', host: new URL(request.url).host });
+        },
+    });
+    for (const middleware of registry.getMiddleware('slas')) {
+        client.use(middleware);
+    }
+    client.use(createLoggingMiddleware({ prefix: 'SLAS', logDetails: false }));
+    return client;
+}
+//# sourceMappingURL=slas-shopper.js.map

package/dist/esm/clients/slas-shopper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slas-shopper.js","sourceRoot":"","sources":["../../../src/clients/slas-shopper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,YAAY,EAAE,EAAa,MAAM,eAAe,CAAC;AACxD,OAAO,EAAC,gBAAgB,EAAC,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAC,uBAAuB,EAAC,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAC,wBAAwB,EAA0B,MAAM,0BAA0B,CAAC;AAe3F;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,IAAI,wBAAwB,CAAC;IACvE,MAAM,MAAM,GAAG,YAAY,CAAQ;QACjC,OAAO,EAAE,WAAW,MAAM,CAAC,SAAS,mEAAmE,MAAM,CAAC,cAAc,EAAE;QAC9H,OAAO,EAAE,EAAC,cAAc,EAAE,mCAAmC,EAAC;QAC9D,cAAc,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,IAA8B,CAAC,CAAC,QAAQ,EAAE;QACjG,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC;QACT,OAAO,CAAC,EAAC,KAAK,EAAE,OAAO,EAAC;YACtB,MAAM,gBAAgB,CAAC,KAAK,EAAE,EAAC,SAAS,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAC,CAAC,CAAC;QACpG,CAAC;KACF,CAAC,CAAC;IACH,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAC,CAAC,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/clients/storefront-deployments.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SCAPI Storefront Deployments API client.
+ *
+ * The modern (OAuth / Account Manager) backend for Managed Runtime deployment
+ * operations, replacing the legacy MRT Cloud API (`cloud.mobify.com`, per-user
+ * API key). Authenticated with a stateless OAuth flow (client-credentials or
+ * JWT Bearer) requesting the `sfcc.storefront.deployments[.rw]` scopes.
+ *
+ * This is one of the SCAPI `Storefront` API family (`storefront/<api>/v1`): a
+ * dedicated client per API, each with its own path segment, spec, and scope
+ * family. This client covers the Deployments API (bundles + deployments);
+ * sibling clients (`storefront-environments`, `storefront-storefronts`) follow
+ * the same pattern. The MRT-level composition of these clients lives in
+ * `operations/mrt`.
+ *
+ * ID mapping for B2C Commerce MRT:
+ *   - `organizationId` = `f_ecom_<tenant>`
+ *   - `storefrontId`   = MRT project slug
+ *   - `environmentId`  = MRT environment/target slug
+ *
+ * @module clients/storefront-deployments
+ */
+import type { Client } from 'openapi-fetch';
+import type { AuthStrategy } from '../auth/types.js';
+import type { paths, components } from './storefront-deployments.generated.js';
+import { type ScapiClientConfig } from './scapi-client-factory.js';
+import { buildTenantScope, toOrganizationId, normalizeTenantId } from './custom-apis.js';
+import type { ScopeCascade } from './middleware.js';
+export { toOrganizationId, normalizeTenantId, buildTenantScope };
+export type { paths, components };
+export type StorefrontDeploymentsClient = Client<paths>;
+export type StorefrontDeploymentsResponse<T> = T extends {
+    content: {
+        'application/json': infer R;
+    };
+} ? R : never;
+export type StorefrontDeploymentsError = components['schemas']['ErrorResponse'];
+export type Bundle = components['schemas']['Bundle'];
+export type BundleResult = components['schemas']['BundleResult'];
+export type BundleUploadResponse = components['schemas']['BundleUploadResponse'];
+export type Deployment = components['schemas']['Deployment'];
+export type DeploymentResult = components['schemas']['DeploymentResult'];
+export type DeploymentCreateRequest = components['schemas']['DeploymentCreateRequest'];
+/** Deployment lifecycle status. */
+export type DeploymentStatus = NonNullable<Deployment['status']>;
+/**
+ * Per-operation scope cascade for the SCAPI Storefront Deployments API.
+ *
+ * Reads accept either rw or ro; writes require rw. The auth middleware tries
+ * each candidate against AM in order, caches the first that survives, and lets
+ * a broader cached token satisfy a later narrower request without an extra
+ * round trip.
+ */
+export declare const STOREFRONT_DEPLOYMENTS_CASCADE: ScopeCascade;
+export type StorefrontDeploymentsClientConfig = ScapiClientConfig;
+export declare function createStorefrontDeploymentsClient(config: StorefrontDeploymentsClientConfig, auth: AuthStrategy): StorefrontDeploymentsClient;