@proxima-io/storefront-core 0.3.0 → 0.8.2

package/dist/buyer/auth.js

@@ -0,0 +1,215 @@
+import { StorefrontEndpoints, createStorefrontClient } from '../api/index.js';
+import { MissingFieldsError, } from '../types/buyer.js';
+function tenant(config, website) {
+    return {
+        client: createStorefrontClient(config),
+        businessId: website.business_id,
+    };
+}
+/**
+ * Fetch the merchant-configured registration form schema.
+ * Call this server-side in your /register page to know which fields to render
+ * and which are required. `email` and `password` are always prepended by the API.
+ *
+ * @example
+ * // src/pages/register.astro
+ * const form = await fetchRegistrationForm({ baseUrl: env.apiUrl }, website);
+ * // Pass `form` as a prop to a client component that renders the dynamic form
+ */
+export async function fetchRegistrationForm(config, website) {
+    const { client, businessId } = tenant(config, website);
+    return client.get(StorefrontEndpoints.auth.registrationForm(), { businessId });
+}
+// ---------------------------------------------------------------------------
+// Buyer Auth — client-side functions
+// ---------------------------------------------------------------------------
+/**
+ * Register a new customer. The merchant decides which fields are required —
+ * call fetchRegistrationForm() first to know what to collect.
+ *
+ * Throws MissingFieldsError when the merchant marked fields as required but
+ * they were omitted, so you can mark exactly which inputs are invalid.
+ *
+ * @example
+ * try {
+ *   const session = await registerBuyer(config, website, { email, password, fullName });
+ * } catch (e) {
+ *   if (e instanceof MissingFieldsError) {
+ *     e.missingFields.forEach(({ field }) => markError(field));
+ *   }
+ * }
+ */
+export async function registerBuyer(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    const body = {
+        email: params.email,
+        password: params.password,
+    };
+    if (params.fullName !== undefined)
+        body.full_name = params.fullName;
+    if (params.phone !== undefined)
+        body.phone = params.phone;
+    if (params.docType !== undefined)
+        body.doc_type = params.docType;
+    if (params.docNumber !== undefined)
+        body.doc_number = params.docNumber;
+    if (params.birthDate !== undefined)
+        body.birth_date = params.birthDate;
+    if (params.newsletterSubscribed !== undefined)
+        body.newsletter_subscribed = params.newsletterSubscribed;
+    if (params.registrationSource !== undefined)
+        body.registration_source = params.registrationSource;
+    if (params.metadata !== undefined)
+        body.metadata = params.metadata;
+    if (params.address !== undefined)
+        body.address = params.address;
+    if (params.captchaToken)
+        body.captcha_token = params.captchaToken;
+    try {
+        return await client.post(StorefrontEndpoints.auth.register(), body, { businessId });
+    }
+    catch (e) {
+        const err = e;
+        if (err.status === 422 && typeof err.data?.detail === "string" && err.data.detail.startsWith("MISSING_REQUIRED_FIELDS:")) {
+            try {
+                const raw = err.data.detail.replace("MISSING_REQUIRED_FIELDS:", "").trim();
+                const normalized = raw.replace(/'/g, '"');
+                const missingFields = JSON.parse(normalized);
+                throw new MissingFieldsError(missingFields);
+            }
+            catch (parseErr) {
+                if (parseErr instanceof MissingFieldsError)
+                    throw parseErr;
+            }
+        }
+        throw e;
+    }
+}
+/**
+ * Authenticate a customer with email and password.
+ * Returns a BuyerSession with access_token and refresh_token.
+ * Throws { status: 401 } on wrong credentials.
+ */
+export async function loginBuyer(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    const body = { email: params.email, password: params.password };
+    if (params.captchaToken)
+        body.captcha_token = params.captchaToken;
+    return client.post(StorefrontEndpoints.auth.login(), body, { businessId });
+}
+/** Invalidate the current session server-side. Best-effort — always clear the cookie too. */
+export async function logoutBuyer(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    await client.post(StorefrontEndpoints.auth.logout(), undefined, {
+        businessId,
+        token: params.token,
+        ignoreErrors: true,
+    });
+}
+/**
+ * Exchange a refresh token for a new access token.
+ * Call this when you get a 401 on any authenticated request.
+ * Throws { status: 401 } if the refresh token is expired or revoked.
+ *
+ * @example
+ * // In Astro middleware:
+ * try {
+ *   const session = await refreshBuyerToken(config, website, { refreshToken });
+ *   // Set new access_token cookie
+ * } catch {
+ *   // Clear both cookies, redirect to login
+ * }
+ */
+export async function refreshBuyerToken(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    return client.post(StorefrontEndpoints.auth.refresh(), undefined, {
+        businessId,
+        query: { refresh_token: params.refreshToken },
+    });
+}
+/** Fetch the authenticated customer's full profile. */
+export async function fetchBuyerProfile(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    return client.get(StorefrontEndpoints.buyer.me(), {
+        businessId,
+        token: params.token,
+    });
+}
+/**
+ * Update the authenticated customer's profile. Only the fields you include
+ * in `params` are changed — it's a partial update.
+ */
+export async function updateBuyerProfile(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    const body = {};
+    if (params.fullName !== undefined)
+        body.full_name = params.fullName;
+    if (params.phone !== undefined)
+        body.phone = params.phone;
+    if (params.docType !== undefined)
+        body.doc_type = params.docType;
+    if (params.docNumber !== undefined)
+        body.doc_number = params.docNumber;
+    if (params.birthDate !== undefined)
+        body.birth_date = params.birthDate;
+    if (params.newsletterSubscribed !== undefined)
+        body.newsletter_subscribed = params.newsletterSubscribed;
+    if (params.avatarUrl !== undefined)
+        body.avatar_url = params.avatarUrl;
+    if (params.password !== undefined)
+        body.password = params.password;
+    return client.patch(StorefrontEndpoints.buyer.profile(), body, {
+        businessId,
+        token: params.token,
+    });
+}
+// ---------------------------------------------------------------------------
+// Password recovery & email verification
+// ---------------------------------------------------------------------------
+/**
+ * Send a password reset email. Always resolves — even if the email doesn't exist.
+ * Always show: "Si el email existe, recibirás un enlace para restablecer tu contraseña."
+ */
+export async function forgotPassword(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    const body = { email: params.email };
+    if (params.captchaToken)
+        body.captcha_token = params.captchaToken;
+    await client.post(StorefrontEndpoints.auth.forgotPassword(), body, {
+        businessId,
+        ignoreErrors: true,
+    });
+}
+/**
+ * Reset the customer's password using the token from the reset email link.
+ * The token is the `?token=` query param in the reset URL.
+ * On success, all active sessions are revoked — redirect to login.
+ * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID } on bad token.
+ */
+export async function resetPassword(config, params) {
+    const client = createStorefrontClient(config);
+    await client.post(StorefrontEndpoints.auth.resetPassword(), {
+        token: params.token,
+        new_password: params.newPassword,
+    });
+}
+/**
+ * Verify the customer's email using the token from the verification email link.
+ * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.VERIFY_TOKEN_INVALID } on bad token.
+ */
+export async function verifyEmail(config, params) {
+    const client = createStorefrontClient(config);
+    await client.post(StorefrontEndpoints.auth.verifyEmail(), { token: params.token });
+}
+/**
+ * Re-send the email verification link. Requires the customer to be authenticated.
+ * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.EMAIL_ALREADY_VERIFIED } if already verified.
+ */
+export async function resendVerification(config, website, params) {
+    const { client, businessId } = tenant(config, website);
+    await client.post(StorefrontEndpoints.auth.resendVerification(), undefined, {
+        businessId,
+        token: params.token,
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/buyer/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/buyer/auth.ts"],"names":[],"mappings":"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"}

package/dist/cache/cache.d.ts

@@ -0,0 +1,31 @@
+import type { ProximaCompositionResponse, ProximaWebsiteResponse } from '../types/cms.js';
+declare class _TtlCache<T> {
+    private readonly ttlMs;
+    private readonly store;
+    constructor(ttlMs: number);
+    get(key: string): T | null;
+    set(key: string, data: T): void;
+    delete(key: string): void;
+    clear(): void;
+}
+/** In-process cache for website config (shell, theme, capabilities). TTL: 5 min. */
+export declare const websiteCache: _TtlCache<ProximaWebsiteResponse>;
+/** In-process cache for CMS compositions (page sections). TTL: 60 s. */
+export declare const compositionCache: _TtlCache<ProximaCompositionResponse>;
+/**
+ * Flush cache entries by scope — mirrors the payload sent by `StorefrontWebhookNotifier`:
+ *   "composition" + path  → flush that page's composition
+ *   "website"             → flush website config + all compositions (they depend on it)
+ *   "all"                 → flush everything
+ */
+export declare function invalidateByScope(scope: string, path?: string): void;
+/**
+ * Handle the POST /api/cache/invalidate webhook from the Proxima API.
+ * Drop this into your Astro route:
+ *
+ *   export const POST: APIRoute = ({ request }) =>
+ *     handleCacheInvalidateWebhook(request, import.meta.env.PROXIMA_WEBHOOK_SECRET);
+ */
+export declare function handleCacheInvalidateWebhook(request: Request, secret?: string): Promise<Response>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAoB1F,cAAM,SAAS,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;gBAC9B,KAAK,EAAE,MAAM;IAE1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAO1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAI/B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IACzB,KAAK,IAAI,IAAI;CACd;AAED,oFAAoF;AACpF,eAAO,MAAM,YAAY,mCAAoD,CAAC;AAE9E,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,uCAAoD,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAUpE;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,CAAC,CAiBnB"}

package/dist/cache/cache.js

@@ -0,0 +1,71 @@
+class _TtlCache {
+    ttlMs;
+    store = new Map();
+    constructor(ttlMs) {
+        this.ttlMs = ttlMs;
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+    set(key, data) {
+        this.store.set(key, { data, expiresAt: Date.now() + this.ttlMs });
+    }
+    delete(key) { this.store.delete(key); }
+    clear() { this.store.clear(); }
+}
+/** In-process cache for website config (shell, theme, capabilities). TTL: 5 min. */
+export const websiteCache = new _TtlCache(5 * 60_000);
+/** In-process cache for CMS compositions (page sections). TTL: 60 s. */
+export const compositionCache = new _TtlCache(60_000);
+/**
+ * Flush cache entries by scope — mirrors the payload sent by `StorefrontWebhookNotifier`:
+ *   "composition" + path  → flush that page's composition
+ *   "website"             → flush website config + all compositions (they depend on it)
+ *   "all"                 → flush everything
+ */
+export function invalidateByScope(scope, path) {
+    if (scope === "composition" && path) {
+        compositionCache.delete(path);
+    }
+    else if (scope === "website") {
+        websiteCache.clear();
+        compositionCache.clear();
+    }
+    else {
+        websiteCache.clear();
+        compositionCache.clear();
+    }
+}
+/**
+ * Handle the POST /api/cache/invalidate webhook from the Proxima API.
+ * Drop this into your Astro route:
+ *
+ *   export const POST: APIRoute = ({ request }) =>
+ *     handleCacheInvalidateWebhook(request, import.meta.env.PROXIMA_WEBHOOK_SECRET);
+ */
+export async function handleCacheInvalidateWebhook(request, secret) {
+    if (secret) {
+        const auth = request.headers.get("Authorization") ?? "";
+        if (auth !== `Bearer ${secret}`) {
+            return new Response("Unauthorized", { status: 401 });
+        }
+    }
+    let body = {};
+    try {
+        body = await request.json();
+    }
+    catch { /* empty body → treat as "all" */ }
+    invalidateByScope(body.scope ?? "all", body.path);
+    return new Response(JSON.stringify({ ok: true }), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+    });
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAoBA,MAAM,SAAS;IAEgB;IADZ,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC3D,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,IAAO;QACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,GAAW,IAAU,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,KAAK,KAAW,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CACtC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,SAAS,CAAyB,CAAC,GAAG,MAAM,CAAC,CAAC;AAE9E,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,SAAS,CAA6B,MAAM,CAAC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,IAAa;IAC5D,IAAI,KAAK,KAAK,aAAa,IAAI,IAAI,EAAE,CAAC;QACpC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,YAAY,CAAC,KAAK,EAAE,CAAC;QACrB,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,YAAY,CAAC,KAAK,EAAE,CAAC;QACrB,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAgB,EAChB,MAAe;IAEf,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACxD,IAAI,IAAI,KAAK,UAAU,MAAM,EAAE,EAAE,CAAC;YAChC,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,GAAsC,EAAE,CAAC;IACjD,IAAI,CAAC;QAAC,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,iCAAiC,CAAC,CAAC;IAEhF,iBAAiB,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAElD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;QAChD,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/campaign/countdown.d.ts

@@ -0,0 +1,40 @@
+import type { CampaignCountdownState, ResolvedSmartCollectionInfo } from '../types/campaign.js';
+/**
+ * Returns a single countdown snapshot for the given ISO UTC target.
+ * Safe to call server-side — no timers.
+ */
+export declare function getCampaignCountdown(targetAt: string | null): CampaignCountdownState;
+/**
+ * Creates a client-side ticker that calls `onTick` every second until expiry.
+ * Fires immediately on creation. Returns a cleanup function that cancels the
+ * interval — call it in cleanup / on component unmount.
+ *
+ * ```ts
+ * const stop = createCampaignTicker(targetAt, (state) => {
+ *   renderCountdown(state);
+ *   if (state.expired) stop();
+ * });
+ * ```
+ */
+export declare function createCampaignTicker(targetAt: string, onTick: (state: CampaignCountdownState) => void): () => void;
+/**
+ * Extracts the countdown target from `attributes_meta` for a `datetime`-type
+ * attribute. Returns null if the attribute has no schedule metadata.
+ *
+ * ```ts
+ * // In section frontmatter:
+ * const targetAt = resolveCampaignTarget(props.attributesMeta, "campaign_end_date");
+ * ```
+ */
+export declare function resolveCampaignTarget(attributesMeta: Record<string, any> | null | undefined, attrName: string): string | null;
+/**
+ * Extracts the countdown target from a resolved Smart Collection's `schedule`
+ * block. Returns null if the SC is missing or has no countdown target.
+ *
+ * ```ts
+ * // sc comes from section.attributes.products_sc or similar:
+ * const targetAt = resolveSmartCollectionTarget(sc);
+ * ```
+ */
+export declare function resolveSmartCollectionTarget(sc: ResolvedSmartCollectionInfo | Record<string, any> | null | undefined): string | null;
+//# sourceMappingURL=countdown.d.ts.map

package/dist/campaign/countdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.d.ts","sourceRoot":"","sources":["../../src/campaign/countdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAEtB,2BAA2B,EAC5B,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,sBAAsB,CAiBpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,GAC9C,MAAM,IAAI,CASZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAGf;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,GACvE,MAAM,GAAG,IAAI,CAEf"}

package/dist/campaign/countdown.js

@@ -0,0 +1,71 @@
+/**
+ * Returns a single countdown snapshot for the given ISO UTC target.
+ * Safe to call server-side — no timers.
+ */
+export function getCampaignCountdown(targetAt) {
+    if (!targetAt) {
+        return { days: 0, hours: 0, minutes: 0, seconds: 0, expired: true, targetAt };
+    }
+    const diffMs = new Date(targetAt).getTime() - Date.now();
+    if (diffMs <= 0) {
+        return { days: 0, hours: 0, minutes: 0, seconds: 0, expired: true, targetAt };
+    }
+    const s = Math.floor(diffMs / 1000);
+    return {
+        days: Math.floor(s / 86400),
+        hours: Math.floor((s % 86400) / 3600),
+        minutes: Math.floor((s % 3600) / 60),
+        seconds: s % 60,
+        expired: false,
+        targetAt,
+    };
+}
+/**
+ * Creates a client-side ticker that calls `onTick` every second until expiry.
+ * Fires immediately on creation. Returns a cleanup function that cancels the
+ * interval — call it in cleanup / on component unmount.
+ *
+ * ```ts
+ * const stop = createCampaignTicker(targetAt, (state) => {
+ *   renderCountdown(state);
+ *   if (state.expired) stop();
+ * });
+ * ```
+ */
+export function createCampaignTicker(targetAt, onTick) {
+    const tick = () => {
+        const state = getCampaignCountdown(targetAt);
+        onTick(state);
+        if (state.expired)
+            clearInterval(handle);
+    };
+    tick();
+    const handle = setInterval(tick, 1000);
+    return () => clearInterval(handle);
+}
+/**
+ * Extracts the countdown target from `attributes_meta` for a `datetime`-type
+ * attribute. Returns null if the attribute has no schedule metadata.
+ *
+ * ```ts
+ * // In section frontmatter:
+ * const targetAt = resolveCampaignTarget(props.attributesMeta, "campaign_end_date");
+ * ```
+ */
+export function resolveCampaignTarget(attributesMeta, attrName) {
+    const schedule = attributesMeta?.[attrName]?.schedule;
+    return schedule?.countdown_target_at ?? null;
+}
+/**
+ * Extracts the countdown target from a resolved Smart Collection's `schedule`
+ * block. Returns null if the SC is missing or has no countdown target.
+ *
+ * ```ts
+ * // sc comes from section.attributes.products_sc or similar:
+ * const targetAt = resolveSmartCollectionTarget(sc);
+ * ```
+ */
+export function resolveSmartCollectionTarget(sc) {
+    return sc?.schedule?.countdown_target_at ?? null;
+}
+//# sourceMappingURL=countdown.js.map

package/dist/campaign/countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.js","sourceRoot":"","sources":["../../src/campaign/countdown.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzD,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;QACrC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC,GAAG,EAAE;QACf,OAAO,EAAE,KAAK;QACd,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,MAA+C;IAE/C,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,IAAI,KAAK,CAAC,OAAO;YAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC;IACF,IAAI,EAAE,CAAC;IACP,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,cAAsD,EACtD,QAAgB;IAEhB,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAmD,CAAC;IACjG,OAAO,QAAQ,EAAE,mBAAmB,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAwE;IAExE,OAAQ,EAAkC,EAAE,QAAQ,EAAE,mBAAmB,IAAI,IAAI,CAAC;AACpF,CAAC"}

package/dist/cart/cart.d.ts

@@ -0,0 +1,57 @@
+import type { ProximaApiConfig, ProximaWebsiteResponse } from '../types/cms.js';
+import type { Cart } from '../types/cart.js';
+import type { CouponValidationResult } from '../types/catalog.js';
+/** Fetch the current cart. Works for both guest sessions and authenticated customers. */
+export declare function fetchCart(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
+    token?: string | null;
+    sessionId?: string | null;
+}): Promise<Cart>;
+/**
+ * Add a product variant to the cart. Use `StorefrontProductSummary.default_variant_id`
+ * as `variantId` when adding from a listing card.
+ */
+export declare function addToCart(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
+    token?: string | null;
+    sessionId?: string | null;
+    variantId: number;
+    quantity: number;
+}): Promise<Cart>;
+/** Update the quantity of an existing cart item. Set `quantity` to 0 to remove it. */
+export declare function updateCartItem(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
+    token?: string | null;
+    sessionId?: string | null;
+    variantId: number;
+    quantity: number;
+}): Promise<Cart>;
+/** Remove a product variant from the cart entirely. */
+export declare function removeCartItem(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
+    token?: string | null;
+    sessionId?: string | null;
+    variantId: number;
+}): Promise<Cart>;
+/**
+ * Merge a guest cart (identified by session ID) into the authenticated customer's cart.
+ * Call this immediately after a successful login if there is an active guest session.
+ *
+ * @example
+ * const sessionId = localStorage.getItem('proxima_session_id');
+ * if (sessionId) await mergeGuestCart(config, website, { token, sessionId });
+ */
+export declare function mergeGuestCart(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
+    token: string;
+    sessionId: string;
+}): Promise<Cart>;
+/**
+ * Validate a coupon code before checkout. Always resolves — check `result.valid`.
+ * Use the `discount_amount` from the result to preview the discount in the UI.
+ *
+ * @example
+ * const result = await validateCoupon(config, website, { code: 'PROMO10', amount: 150.00 });
+ * if (result.valid) showDiscount(result.discount_amount);
+ * else showError(result.error);
+ */
+export declare function validateCoupon(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
+    code: string;
+    amount: number;
+}): Promise<CouponValidationResult>;
+//# sourceMappingURL=cart.d.ts.map

package/dist/cart/cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/cart/cart.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAalE,yFAAyF;AACzF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChG,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,sFAAsF;AACtF,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChG,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,uDAAuD;AACvD,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9E,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,EACpD,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAMjC"}

package/dist/cart/cart.js

@@ -0,0 +1,64 @@
+import { StorefrontEndpoints, createStorefrontClient } from '../api/index.js';
+function cartContext(website, params) {
+    return {
+        businessId: website.business_id,
+        token: params.token,
+        sessionId: params.sessionId,
+    };
+}
+/** Fetch the current cart. Works for both guest sessions and authenticated customers. */
+export async function fetchCart(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.cart.root(), cartContext(website, params));
+}
+/**
+ * Add a product variant to the cart. Use `StorefrontProductSummary.default_variant_id`
+ * as `variantId` when adding from a listing card.
+ */
+export async function addToCart(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.post(StorefrontEndpoints.cart.items(), { product_variant_id: params.variantId, quantity: params.quantity }, cartContext(website, params));
+}
+/** Update the quantity of an existing cart item. Set `quantity` to 0 to remove it. */
+export async function updateCartItem(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.patch(StorefrontEndpoints.cart.item(params.variantId), { quantity: params.quantity }, cartContext(website, params));
+}
+/** Remove a product variant from the cart entirely. */
+export async function removeCartItem(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.delete(StorefrontEndpoints.cart.item(params.variantId), cartContext(website, params));
+}
+/**
+ * Merge a guest cart (identified by session ID) into the authenticated customer's cart.
+ * Call this immediately after a successful login if there is an active guest session.
+ *
+ * @example
+ * const sessionId = localStorage.getItem('proxima_session_id');
+ * if (sessionId) await mergeGuestCart(config, website, { token, sessionId });
+ */
+export async function mergeGuestCart(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.post(StorefrontEndpoints.cart.merge(), undefined, {
+        businessId: website.business_id,
+        token: params.token,
+        headers: { 'X-Session-ID': params.sessionId },
+    });
+}
+/**
+ * Validate a coupon code before checkout. Always resolves — check `result.valid`.
+ * Use the `discount_amount` from the result to preview the discount in the UI.
+ *
+ * @example
+ * const result = await validateCoupon(config, website, { code: 'PROMO10', amount: 150.00 });
+ * if (result.valid) showDiscount(result.discount_amount);
+ * else showError(result.error);
+ */
+export async function validateCoupon(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.commerce.validateCoupon(), {
+        businessId: website.business_id,
+        query: { code: params.code, amount: params.amount },
+    });
+}
+//# sourceMappingURL=cart.js.map

package/dist/cart/cart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/cart/cart.ts"],"names":[],"mappings":"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"}