@asstio-dev/storefront 0.7.0 → 0.11.0

package/dist/checkout/server.js

@@ -0,0 +1,68 @@
+import { localProblem, retryAfterSeconds } from "./types.js";
+const defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** `POST /v1/checkout`: creates the cart's attempt or converges on the live one (spec §5.3). Call it from a Server Action or route handler, never during render. */
+export async function startCheckout(client, cartToken, opts = {}) {
+    const { data, error, response } = await client.POST("/v1/checkout", {
+        body: { option: opts.option ?? null, returnOrigin: opts.returnOrigin ?? null },
+        headers: { "X-Cart-Token": cartToken },
+    });
+    const retryAfter = retryAfterSeconds(response);
+    if (error || !data)
+        return { ok: false, status: response.status, problem: (error ?? localProblem("SDK_EMPTY_ANSWER", "no body")), retryAfter };
+    return { ok: true, data, retryAfter };
+}
+/** The same `POST /v1/checkout`, retrying `CHECKOUT_IN_PROGRESS` per `Retry-After`, twice (spec §10.3) — or
+ * `retries` times; `{ retries: 0 }` is the single-attempt call to put behind `mountCheckout` *(plan review 3 #5)*.
+ * Never repeats a cart mutation: it only syncs. */
+export async function syncCheckout(client, cartToken, opts = {}, retry = {}) {
+    const sleep = retry.sleep ?? defaultSleep;
+    const retries = retry.retries ?? 2; // *(plan review 3 #5)*
+    let result = await startCheckout(client, cartToken, opts);
+    for (let attempt = 0; attempt < retries && !result.ok && result.problem.code === "CHECKOUT_IN_PROGRESS"; attempt++) {
+        await sleep((result.retryAfter ?? 1) * 1000);
+        result = await startCheckout(client, cartToken, opts);
+    }
+    return result;
+}
+/** `POST /v1/checkout/{attemptId}/complete`: the confirmation page's call; with the cart token the answer carries the order's access token (spec §8.3). */
+export async function completeCheckout(client, attemptId, cartToken) {
+    const { data, error, response } = await client.POST("/v1/checkout/{attemptId}/complete", {
+        params: { path: { attemptId } },
+        headers: cartToken ? { "X-Cart-Token": cartToken } : {},
+    });
+    if (error || !data)
+        return { ok: false, status: response.status, problem: (error ?? localProblem("SDK_EMPTY_ANSWER", "no body")), retryAfter: retryAfterSeconds(response) };
+    return { ok: true, data };
+}
+/** `GET /v1/checkout/{attemptId}`: the non-mutating status read the browser module polls with. */
+export async function getCheckoutStatus(client, attemptId, cartToken) {
+    const { data, error, response } = await client.GET("/v1/checkout/{attemptId}", { params: { path: { attemptId } }, headers: { "X-Cart-Token": cartToken } });
+    if (error || !data)
+        return { ok: false, status: response.status, problem: (error ?? localProblem("SDK_EMPTY_ANSWER", "no body")), retryAfter: retryAfterSeconds(response) };
+    return { ok: true, data };
+}
+/** `GET /v1/orders/{orderId}` with `X-Order-Token` — a header only, never a query string (spec §8.3). */
+export async function getOrder(client, orderId, token) {
+    const { data, error, response } = await client.GET("/v1/orders/{orderId}", { params: { path: { orderId } }, headers: { "X-Order-Token": token } });
+    if (error || !data)
+        return { ok: false, status: response.status, problem: (error ?? localProblem("SDK_EMPTY_ANSWER", "no body")) };
+    return { ok: true, data };
+}
+const FINAL = new Set(["completed", "pending", "declined", "expired"]);
+/** Polls `complete` with doubling backoff until the attempt has an order or is closed, or the timeout passes (the last answer is returned either way). */
+export async function awaitCompletion(complete, opts = {}) {
+    const first = opts.firstDelayMs ?? 1000;
+    const max = opts.maxDelayMs ?? 10_000;
+    const timeout = opts.timeoutMs ?? 120_000;
+    const sleep = opts.sleep ?? defaultSleep;
+    let delay = first;
+    let waited = 0;
+    let last = await complete();
+    while (last.ok && !FINAL.has(last.data.status) && waited + delay <= timeout) {
+        await sleep(delay);
+        waited += delay;
+        delay = Math.min(delay * 2, max);
+        last = await complete();
+    }
+    return last;
+}

package/dist/checkout/types.d.ts

@@ -0,0 +1,42 @@
+import type { components } from "../schema";
+export type CheckoutDto = components["schemas"]["CheckoutDto"];
+export type CheckoutStatusDto = components["schemas"]["CheckoutStatusDto"];
+export type CheckoutOrderRefDto = components["schemas"]["CheckoutOrderRefDto"];
+export type CheckoutWidgetDto = components["schemas"]["CheckoutWidgetDto"];
+export type OrderDto = components["schemas"]["OrderDto"];
+export type StartCheckoutRequest = components["schemas"]["StartCheckoutRequest"];
+/** The problem body; `cart` is the corrected cart on 409 CHECKOUT_CART_CHANGED (an extension, so it is typed loosely here). */
+export type StorefrontProblem = components["schemas"]["StorefrontProblem"] & {
+    cart?: unknown;
+};
+export type CheckoutResult = {
+    ok: true;
+    data: CheckoutDto;
+    retryAfter?: number;
+} | {
+    ok: false;
+    status: number;
+    problem: StorefrontProblem;
+    retryAfter?: number;
+};
+export type StatusResult = {
+    ok: true;
+    data: CheckoutStatusDto;
+} | {
+    ok: false;
+    status: number;
+    problem: StorefrontProblem;
+    retryAfter?: number;
+};
+export type OrderResult = {
+    ok: true;
+    data: OrderDto;
+} | {
+    ok: false;
+    status: number;
+    problem: StorefrontProblem;
+};
+/** `Retry-After` in seconds: a delay, or an HTTP-date turned into one; garbage is 1 s, absence is undefined. */
+export declare function retryAfterSeconds(response: Response, now?: () => number): number | undefined;
+/** A problem shaped like the API's, for failures that never reached it (a thrown fetch, a timeout). */
+export declare function localProblem(code: string, detail: string): StorefrontProblem;

package/dist/checkout/types.js

@@ -0,0 +1,17 @@
+/** `Retry-After` in seconds: a delay, or an HTTP-date turned into one; garbage is 1 s, absence is undefined. */
+export function retryAfterSeconds(response, now = Date.now) {
+    const raw = response.headers.get("Retry-After");
+    if (raw === null || raw === "")
+        return undefined;
+    const seconds = Number(raw);
+    if (Number.isFinite(seconds))
+        return Math.max(0, Math.ceil(seconds));
+    const date = Date.parse(raw);
+    if (Number.isFinite(date))
+        return Math.max(0, Math.ceil((date - now()) / 1000));
+    return 1;
+}
+/** A problem shaped like the API's, for failures that never reached it (a thrown fetch, a timeout). */
+export function localProblem(code, detail) {
+    return { type: "https://docs.asstio.com/storefront/errors#" + code, title: code, status: 0, detail, code };
+}

package/dist/index.d.ts

@@ -47,3 +47,12 @@ export type FilterSelection = NonNullable<NonNullable<paths["/v1/products"]["get
 export declare function filterQuery(selection: Record<string, string | string[] | undefined>): FilterSelection;
 export { decodeFilterValues, encodeFilterValues } from "./filters.js";
 export { coverOffset, fileUrl, fillFactor, formatFactor, formatImage, imageRect, mediaHash, mediaUrl, MediaUrlError, pickWidth, pictureSources, posterUrl, scaledSizes, srcSet, styleToCss, videoSources, type FormatFit, type FormattedImage, type MediaConfig, type MediaDescriptor, type MediaFormat, type PictureSources, type SlotSize, type VideoSource, } from "./media.js";
+export { awaitCompletion, completeCheckout, getCheckoutStatus, getOrder, startCheckout, syncCheckout, type CheckoutClient, type StartCheckoutOptions, type SyncRetryOptions, type AwaitCompletionOptions } from "./checkout/server.js";
+export { retryAfterSeconds, type CheckoutDto, type CheckoutOrderRefDto, type CheckoutResult, type CheckoutStatusDto, type CheckoutWidgetDto, type OrderDto, type OrderResult, type StatusResult, type StorefrontProblem } from "./checkout/types.js";
+export { mountCheckout, type CheckoutHandle, type MountOptions, type MinimalDocument, type MinimalElement, type MinimalScript } from "./checkout/browser.js";
+export { controllers, type CheckoutController, type ProviderWindow } from "./checkout/controllers.js";
+export { breadcrumbJsonLd } from "./seo/breadcrumb.js";
+export { brandHead, collectionHead, productHead, toNextMetadata } from "./seo/head.js";
+export { productJsonLd } from "./seo/product.js";
+export { jsonLdScript } from "./seo/serialize.js";
+export { SeoError, type BreadcrumbLink, type CollectionHeadOptions, type HeadOptions, type JsonLd, type NextMetadataLike, type ProductJsonLdOptions, type SchemaProperty, type SeoContext, type SeoHead, type SeoMeta, } from "./seo/types.js";

package/dist/index.js

@@ -36,3 +36,12 @@ export function filterQuery(selection) {
 }
 export { decodeFilterValues, encodeFilterValues } from "./filters.js";
 export { coverOffset, fileUrl, fillFactor, formatFactor, formatImage, imageRect, mediaHash, mediaUrl, MediaUrlError, pickWidth, pictureSources, posterUrl, scaledSizes, srcSet, styleToCss, videoSources, } from "./media.js";
+export { awaitCompletion, completeCheckout, getCheckoutStatus, getOrder, startCheckout, syncCheckout } from "./checkout/server.js"; // SyncRetryOptions *(plan review 3 #5)*
+export { retryAfterSeconds } from "./checkout/types.js";
+export { mountCheckout } from "./checkout/browser.js";
+export { controllers } from "./checkout/controllers.js";
+export { breadcrumbJsonLd } from "./seo/breadcrumb.js";
+export { brandHead, collectionHead, productHead, toNextMetadata } from "./seo/head.js";
+export { productJsonLd } from "./seo/product.js";
+export { jsonLdScript } from "./seo/serialize.js";
+export { SeoError, } from "./seo/types.js";