@agence-zef/astro 0.1.0 → 0.3.0

package/dist/shop.js

@@ -0,0 +1,384 @@
+import { safePath, visitorOf } from "./accounts.js";
+import { getClient } from "./helpers.js";
+/*
+ * Boutique côté site (§ 7 M, lot 14e2) : panier, ajout au panier, paiement. Compte obligatoire :
+ * tout passe par la session du compte connecté. Les formulaires (`<AddToCart>`, `<Cart>`,
+ * `<Checkout>`) s'envoient sans JavaScript à `/__zef/shop/<action>` ; seul le paiement Stripe
+ * (Payment Element) demande JavaScript. Montants en centimes TTC, recalculés par le CMS.
+ */
+export const SHOP_ACTIONS = [
+    "add",
+    "update",
+    "remove",
+    "promo",
+    "giftcard",
+    "buy-gift-card",
+    "remove-gift-card",
+    "play",
+    "address",
+    "checkout",
+    "simulate",
+    "cancel-subscription",
+    "subscription-card",
+];
+export const isShopAction = (v) => SHOP_ACTIONS.includes(v);
+/** Cookie d'une heure qui porte le paiement en cours (secret du Payment Element) jusqu'à sa page. */
+export const PAYMENT_COOKIE = "zef_payment";
+/** Cookie (7 jours) du code promo saisi dans le panier (lot 14e4a). */
+export const PROMO_COOKIE = "zef_promo";
+/** Code promo gardé pour le panier et le paiement. */
+export function promoCode(ctx) {
+    return ctx.cookies.get(PROMO_COOKIE)?.value || null;
+}
+/** Cookie (7 jours) de la carte cadeau saisie dans le panier (lot 14e4b1). */
+export const GIFT_CARD_COOKIE = "zef_gift_card";
+export function giftCardCode(ctx) {
+    return ctx.cookies.get(GIFT_CARD_COOKIE)?.value || null;
+}
+/** Cookie d'une heure qui porte l'adresse saisie jusqu'à l'étape Livraison (lot 14e3b). */
+export const ADDRESS_COOKIE = "zef_checkout_address";
+/** Messages affichés après une erreur (`?zef_shop_error=<code>`). */
+export const SHOP_ERRORS = {
+    invalid: "Vérifiez les champs du formulaire.",
+    unavailable: "Ce produit n'est plus disponible.",
+    out_of_stock: "Il n'y en a plus assez en stock.",
+    empty_cart: "Votre panier est vide.",
+    email_unverified: "Confirmez votre adresse email avant de commander.",
+    terms: "La boutique ne peut pas encore vendre.",
+    payment_unavailable: "Le paiement n'est pas disponible pour le moment.",
+    shipping_unavailable: "La livraison n'est pas disponible pour le moment.",
+    shipping: "Choisissez un mode de livraison (et un point relais s'il en demande un).",
+    promo_invalid: "Le code promo ne s'applique plus : retirez-le ou modifiez le panier.",
+    gift_card_invalid: "La carte cadeau ne peut plus servir : retirez-la du panier.",
+    address: "Saisissez d'abord votre adresse de livraison.",
+    unauthenticated: "Connectez-vous pour commander.",
+    no_portal: "Le changement de carte n'est pas disponible pour le moment.",
+    unknown: "Une erreur est survenue. Réessayez dans un instant.",
+};
+/** « 36 € », « 4,50 € ». */
+export function formatPrice(cents) {
+    if (cents === null || cents === undefined)
+        return "";
+    return new Intl.NumberFormat("fr-FR", {
+        style: "currency",
+        currency: "EUR",
+        minimumFractionDigits: cents % 100 === 0 ? 0 : 2,
+    }).format(cents / 100);
+}
+/** Panier du compte connecté, ou `null` sans session. */
+export async function getCart(ctx, locale) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return null;
+    try {
+        return await getClient().shop.cart(visitor, locale, {
+            promoCode: promoCode(ctx),
+            giftCard: giftCardCode(ctx),
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** Commande du compte connecté (page de confirmation), ou `null`. */
+export async function getOrder(ctx, id) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session || !id)
+        return null;
+    try {
+        return await getClient().shop.order(id, visitor);
+    }
+    catch {
+        return null;
+    }
+}
+export async function getOrders(ctx) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return [];
+    return getClient()
+        .shop.orders(visitor)
+        .catch(() => []);
+}
+/** Adresse saisie à la première étape du paiement. */
+export function checkoutAddress(ctx) {
+    const raw = ctx.cookies.get(ADDRESS_COOKIE)?.value;
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Modes de livraison proposés pour le panier du compte, selon le pays de l'adresse. */
+export async function getShippingOptions(ctx, country = "FR") {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return [];
+    return getClient()
+        .shop.shippingOptions(visitor, country, promoCode(ctx))
+        .catch(() => []);
+}
+/** Points relais proches d'un code postal, pour un mode à point relais. */
+export async function getServicePoints(ctx, input) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return [];
+    return getClient()
+        .shop.servicePoints(input, visitor)
+        .catch(() => []);
+}
+/** Accès du compte connecté aux vidéos (vide sans session). */
+export async function getAccess(ctx) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return [];
+    return getClient()
+        .shop.access(visitor)
+        .catch(() => []);
+}
+/** Abonnements du compte connecté (vide sans session), lot 14e6b. */
+export async function getSubscriptions(ctx) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return [];
+    return getClient()
+        .shop.subscriptions(visitor)
+        .catch(() => []);
+}
+/**
+ * Liens de lecture d'une vidéo dont l'accès est en cours (une location pas encore commencée
+ * n'est démarrée que par le bouton de `<VideoPlayer>`), ou `null`.
+ */
+export async function getPlayback(ctx, videoId) {
+    const visitor = visitorOf(ctx);
+    if (!visitor.session)
+        return null;
+    const access = await getAccess(ctx);
+    if (!access.some((a) => a.videoId === videoId && a.state === "active"))
+        return null;
+    return getClient()
+        .shop.play(videoId, visitor)
+        .catch(() => null);
+}
+/** Paiement en cours posé par `checkout` (page de paiement). */
+export function pendingPayment(ctx) {
+    const raw = ctx.cookies.get(PAYMENT_COOKIE)?.value;
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+const text = (form, name) => {
+    const value = form.get(name);
+    return typeof value === "string" ? value.trim() : "";
+};
+function codeOf(error) {
+    if (error && typeof error === "object" && "code" in error)
+        return String(error.code);
+    console.error("[@agence-zef/astro] boutique :", error);
+    return "unknown";
+}
+/**
+ * Traite un formulaire de la boutique et renvoie l'adresse où rediriger : la page du formulaire
+ * (`?zef_shop_ok=` ou `?zef_shop_error=`), la page de paiement, ou la confirmation.
+ */
+export async function handleShopForm(ctx, action, form, paths) {
+    const referer = ctx.request.headers.get("referer");
+    const page = safePath(form.get("zef_page"), referer ? new URL(referer).pathname : paths.cart);
+    const back = (key, value) => {
+        const url = new URL(page, ctx.url.origin);
+        url.searchParams.set(key, value);
+        return `${url.pathname}${url.search}`;
+    };
+    const visitor = visitorOf(ctx);
+    if (!visitor.session) {
+        const to = new URL(paths.signIn, ctx.url.origin);
+        to.searchParams.set("redirect", page);
+        return `${to.pathname}${to.search}`;
+    }
+    const shop = getClient().shop;
+    const locale = text(form, "zef_locale") || undefined;
+    const quantity = Math.max(0, Number.parseInt(text(form, "quantity") || "1", 10) || 0);
+    try {
+        switch (action) {
+            case "add": {
+                // La fiche produit est souvent statique : le résultat s'affiche sur le panier.
+                const to = new URL(paths.cart, ctx.url.origin);
+                try {
+                    await shop.addToCart(text(form, "variantId"), Math.max(1, quantity), visitor, locale);
+                    to.searchParams.set("zef_shop_ok", "add");
+                }
+                catch (error) {
+                    to.searchParams.set("zef_shop_error", codeOf(error));
+                }
+                return `${to.pathname}${to.search}`;
+            }
+            case "update":
+                await shop.setCartLine(text(form, "variantId"), quantity, visitor, locale);
+                return back("zef_shop_ok", "update");
+            case "remove":
+                await shop.setCartLine(text(form, "variantId"), 0, visitor, locale);
+                return back("zef_shop_ok", "remove");
+            case "promo": {
+                // Code saisi (ou retiré) : gardé dans un cookie, vérifié à chaque affichage du panier.
+                const code = text(form, "code").toUpperCase();
+                if (form.get("remove") || !code)
+                    ctx.cookies.delete(PROMO_COOKIE, { path: "/" });
+                else
+                    ctx.cookies.set(PROMO_COOKIE, code, {
+                        path: "/",
+                        httpOnly: true,
+                        sameSite: "lax",
+                        secure: ctx.url.protocol === "https:",
+                        maxAge: 7 * 86400,
+                    });
+                return back("zef_shop_ok", "promo");
+            }
+            case "giftcard": {
+                // Carte cadeau saisie (ou retirée) : son solde est déduit au paiement.
+                const code = text(form, "code").toUpperCase();
+                if (form.get("remove") || !code)
+                    ctx.cookies.delete(GIFT_CARD_COOKIE, { path: "/" });
+                else
+                    ctx.cookies.set(GIFT_CARD_COOKIE, code, {
+                        path: "/",
+                        httpOnly: true,
+                        sameSite: "lax",
+                        secure: ctx.url.protocol === "https:",
+                        maxAge: 7 * 86400,
+                    });
+                return back("zef_shop_ok", "giftcard");
+            }
+            case "buy-gift-card": {
+                // Carte cadeau achetée : montant proposé (`amount`) ou libre (`customAmount`, en euros).
+                const to = new URL(paths.cart, ctx.url.origin);
+                const custom = text(form, "customAmount").replace(",", ".");
+                const amount = custom ? Math.round(Number(custom) * 100) : Number(text(form, "amount"));
+                try {
+                    await shop.addGiftCard({
+                        productId: text(form, "productId"),
+                        amountCents: Number.isFinite(amount) ? amount : 0,
+                        recipientName: text(form, "recipientName"),
+                        recipientEmail: text(form, "recipientEmail"),
+                        message: text(form, "message"),
+                        sendOn: text(form, "sendOn") || null,
+                    }, visitor, locale);
+                    to.searchParams.set("zef_shop_ok", "add");
+                }
+                catch (error) {
+                    to.searchParams.set("zef_shop_error", codeOf(error));
+                }
+                return `${to.pathname}${to.search}`;
+            }
+            case "play":
+                // « Commencer la location » : le premier visionnage démarre le droit.
+                await shop.play(text(form, "videoId"), visitor);
+                return back("zef_shop_ok", "play");
+            case "remove-gift-card":
+                await shop.removeGiftCard(text(form, "lineId"), visitor, locale);
+                return back("zef_shop_ok", "remove");
+            case "address": {
+                // Étape 1 : l'adresse est gardée jusqu'au choix de la livraison.
+                const address = {
+                    name: text(form, "name"),
+                    line1: text(form, "line1"),
+                    line2: text(form, "line2") || null,
+                    postalCode: text(form, "postalCode"),
+                    city: text(form, "city"),
+                    country: text(form, "country") || "FR",
+                    phone: text(form, "phone") || null,
+                };
+                if (!address.name || !address.line1 || !address.postalCode || !address.city) {
+                    return back("zef_shop_error", "invalid");
+                }
+                ctx.cookies.set(ADDRESS_COOKIE, JSON.stringify(address), {
+                    path: "/",
+                    httpOnly: true,
+                    sameSite: "lax",
+                    secure: ctx.url.protocol === "https:",
+                    maxAge: 3600,
+                });
+                const to = new URL(page, ctx.url.origin);
+                to.search = "";
+                to.searchParams.set("etape", "livraison");
+                return `${to.pathname}${to.search}`;
+            }
+            case "checkout": {
+                // Panier de cartes cadeaux seulement : ni adresse ni livraison.
+                const giftsOnly = form.get("giftsOnly") === "1";
+                const address = giftsOnly ? null : checkoutAddress(ctx);
+                if (!address && !giftsOnly) {
+                    const to = new URL(page, ctx.url.origin);
+                    to.search = "";
+                    to.searchParams.set("zef_shop_error", "address");
+                    return `${to.pathname}${to.search}`;
+                }
+                const option = text(form, "shippingOption");
+                if (!option && !giftsOnly)
+                    return back("zef_shop_error", "shipping");
+                const point = Number.parseInt(text(form, `servicePoint_${option}`), 10);
+                const started = await shop.checkout({
+                    shippingAddress: address,
+                    shipping: giftsOnly
+                        ? null
+                        : { option, servicePoint: Number.isFinite(point) ? point : null },
+                    promoCode: promoCode(ctx),
+                    giftCardCode: giftCardCode(ctx),
+                    acceptTerms: form.get("acceptTerms") === "on" ? true : false,
+                }, visitor, locale);
+                ctx.cookies.delete(ADDRESS_COOKIE, { path: "/" });
+                ctx.cookies.delete(PROMO_COOKIE, { path: "/" });
+                ctx.cookies.delete(GIFT_CARD_COOKIE, { path: "/" });
+                if (started.payment.paid) {
+                    // Tout est réglé par la carte cadeau : directement à la confirmation.
+                    const done = new URL(paths.confirmation, ctx.url.origin);
+                    done.searchParams.set("commande", started.order.id);
+                    return `${done.pathname}${done.search}`;
+                }
+                const payment = {
+                    ...started.payment,
+                    orderId: started.order.id,
+                    number: started.order.number,
+                    total: started.order.due,
+                };
+                ctx.cookies.set(PAYMENT_COOKIE, JSON.stringify(payment), {
+                    path: "/",
+                    httpOnly: true,
+                    sameSite: "lax",
+                    secure: ctx.url.protocol === "https:",
+                    maxAge: 3600,
+                });
+                const to = new URL(paths.checkout, ctx.url.origin);
+                to.searchParams.set("etape", "paiement");
+                return `${to.pathname}${to.search}`;
+            }
+            case "cancel-subscription":
+                // Résiliation par l'abonné : à la fin de la période payée, accès gardés jusque-là.
+                await shop.cancelSubscription(text(form, "subscriptionId"), visitor);
+                return back("zef_shop_ok", "cancel-subscription");
+            case "subscription-card": {
+                // « Changer de carte » : portail Stripe, qui ramène sur la page de l'abonné.
+                const { url } = await shop.paymentMethod(text(form, "subscriptionId"), new URL(page, ctx.url.origin).toString(), visitor);
+                return url ?? back("zef_shop_error", "no_portal");
+            }
+            case "simulate": {
+                const orderId = text(form, "orderId");
+                await shop.simulatePayment(orderId, visitor);
+                ctx.cookies.delete(PAYMENT_COOKIE, { path: "/" });
+                const to = new URL(paths.confirmation, ctx.url.origin);
+                to.searchParams.set("commande", orderId);
+                return `${to.pathname}${to.search}`;
+            }
+        }
+    }
+    catch (error) {
+        return back("zef_shop_error", codeOf(error));
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agence-zef/astro",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Intégration Astro du CMS ZEF : routes, rendu des sections, aperçu, composants réutilisables sans style.",
   "license": "MIT",
   "type": "module",
@@ -11,6 +11,7 @@
     },
     "./ZefSections.astro": "./components/ZefSections.astro",
     "./routes/page.astro": "./components/routes/page.astro",
+    "./routes/reserved.astro": "./components/routes/reserved.astro",
     "./routes/robots.ts": "./components/routes/robots.ts",
     "./Button.astro": "./components/Button.astro",
     "./Image.astro": "./components/Image.astro",
@@ -25,7 +26,28 @@
     "./routes/preview-thumbnail.astro": "./components/routes/preview-thumbnail.astro",
     "./Form.astro": "./components/Form.astro",
     "./Popups.astro": "./components/Popups.astro",
-    "./CookieBanner.astro": "./components/CookieBanner.astro"
+    "./CookieBanner.astro": "./components/CookieBanner.astro",
+    "./accounts": {
+      "types": "./dist/accounts.d.ts",
+      "import": "./dist/accounts.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js"
+    },
+    "./AccountForm.astro": "./components/AccountForm.astro",
+    "./routes/account.ts": "./components/routes/account.ts",
+    "./shop": {
+      "types": "./dist/shop.d.ts",
+      "import": "./dist/shop.js"
+    },
+    "./AddToCart.astro": "./components/AddToCart.astro",
+    "./Cart.astro": "./components/Cart.astro",
+    "./Checkout.astro": "./components/Checkout.astro",
+    "./VideoPlayer.astro": "./components/VideoPlayer.astro",
+    "./Subscriptions.astro": "./components/Subscriptions.astro",
+    "./ReservedNotice.astro": "./components/ReservedNotice.astro",
+    "./routes/shop.ts": "./components/routes/shop.ts"
   },
   "files": [
     "dist",
@@ -42,8 +64,8 @@
     "@types/node": "^24.0.0"
   },
   "dependencies": {
-    "@agence-zef/schema": "0.1.0",
-    "@agence-zef/sdk": "0.1.0"
+    "@agence-zef/schema": "0.3.0",
+    "@agence-zef/sdk": "0.3.0"
   },
   "homepage": "https://agence-zef.fr",
   "scripts": {