@rovela-ai/sdk 0.19.8 → 0.20.0

package/dist/shipping/colissimo.js

@@ -0,0 +1,424 @@
+/**
+ * @rovela/sdk/shipping/colissimo
+ *
+ * La Poste Colissimo integration (France-first carrier):
+ * - SLS (Simple Label Solution) label generation — home delivery (DOM/DOS)
+ *   and pickup-point relay delivery (A2P/BPR).
+ * - Point Retrait pickup-point search (findRDVPointRetraitAcheminement).
+ *
+ * Uses direct fetch calls — no SDK dependency. Credentials (contract number +
+ * password) are store-level secrets read server-side from store_settings;
+ * they are BODY-borne on Colissimo's APIs and must never reach the client.
+ *
+ * Load-bearing protocol notes (verified against the official SLS spec):
+ * - generateLabel responds with `multipart/mixed` (MTOM-style): a JSON part
+ *   (Content-ID <jsonInfos>) + the raw label bytes (Content-ID <label>).
+ *   The body MUST be read as a Buffer (label bytes are binary) and the JSON
+ *   part must be parsed EVEN ON HTTP 4xx — Colissimo returns its error
+ *   catalog inside the same multipart wrapper.
+ * - Colissimo has NO rate-quoting API: checkout prices stay on the store's
+ *   manual zone rates; this module only does labels + pickup points.
+ * - There is no sandbox: `checkGenerateLabel` validates without creating a
+ *   parcel, and real labels are free until physically scanned.
+ * - Parcel-number ranges recycle after ~18 months — the order reference is
+ *   always stamped on the label (senderParcelRef/orderNumber) and the order
+ *   row remains the durable key.
+ * - Point Retrait: empty-valued params break the call — omit unused params
+ *   entirely. `shippingDate` is dd/MM/yyyy there while SLS `depositDate` is
+ *   yyyy-MM-dd.
+ *
+ * API docs: https://www.colissimo.entreprise.laposte.fr/en/system-integration
+ */
+import { findSettings } from '../core/db/queries';
+const SLS_BASE_URL = 'https://ws.colissimo.fr/sls-ws/SlsServiceWSRest/2.0';
+const PDR_BASE_URL = 'https://ws.colissimo.fr/pointretrait-ws-cxf/rest/v2/pointretrait';
+/** Thrown when Colissimo returns an ERROR message or the call fails. */
+export class ColissimoError extends Error {
+    messages;
+    constructor(message, messages = []) {
+        super(message);
+        this.name = 'ColissimoError';
+        this.messages = messages;
+    }
+}
+// =============================================================================
+// Credentials
+// =============================================================================
+/**
+ * Get Colissimo credentials from store settings (DB only — the contract is
+ * merchant-specific, there is no platform fallback).
+ */
+export async function getColissimoCredentials() {
+    const settings = await findSettings().catch(() => null);
+    const contractNumber = settings?.colissimoContractNumber;
+    const password = settings?.colissimoPassword;
+    if (!contractNumber || !password) {
+        throw new ColissimoError('Colissimo is not configured. Add your contract number and password in Settings > Shipping.');
+    }
+    return { contractNumber, password };
+}
+// =============================================================================
+// Error catalog — friendly messages for the codes merchants actually hit
+// =============================================================================
+const FRIENDLY_ERRORS = {
+    '30000': 'Invalid Colissimo contract number or password.',
+    '30001': 'Invalid Colissimo contract number or password.',
+    '30007': 'This Colissimo account is inactive. Contact Colissimo support.',
+    '30015': 'This shipping product is not valid for this parcel.',
+    '30109': 'The recipient mobile number is missing or invalid (required for pickup-point delivery).',
+    '30220': 'The recipient phone number is required for this destination.',
+    '30300': 'The parcel weight is missing.',
+    '30301': 'The parcel weight is invalid (0.01–30 kg, 2 decimals).',
+    '30700': 'This shipping product is not enabled on your Colissimo contract.',
+    '30008': 'This shipping product is not enabled on your Colissimo contract.',
+    '30009': 'This shipping product is not enabled on your Colissimo contract.',
+    '30002': 'The deposit date must be today or later.',
+};
+function friendlyError(messages) {
+    const firstError = messages.find((m) => m.type === 'ERROR');
+    if (!firstError)
+        return 'Colissimo request failed';
+    const friendly = FRIENDLY_ERRORS[firstError.id];
+    return friendly
+        ? `${friendly} (Colissimo ${firstError.id})`
+        : `Colissimo error ${firstError.id}: ${firstError.messageContent}`;
+}
+/**
+ * Parse an SLS response body. Handles both `multipart/mixed` (success — JSON
+ * infos part + binary label part) and plain JSON (checkGenerateLabel, some
+ * errors). Exported for tests.
+ *
+ * Buffer↔latin1 round-trips are byte-exact (1 char = 1 byte), so the parts
+ * are located on a latin1 view and the label bytes recovered losslessly.
+ */
+export function parseSlsResponse(body, contentType) {
+    const result = { messages: [], parcelNumber: null, labelBytes: null };
+    const readJsonPart = (jsonText) => {
+        try {
+            const parsed = JSON.parse(jsonText);
+            result.messages = parsed.messages ?? [];
+            result.parcelNumber = parsed.labelV2Response?.parcelNumber ?? null;
+        }
+        catch {
+            // Leave messages empty — the caller surfaces a generic error.
+        }
+    };
+    const boundaryMatch = /boundary="?([^";]+)"?/i.exec(contentType);
+    if (!boundaryMatch) {
+        readJsonPart(body.toString('utf8'));
+        return result;
+    }
+    const text = body.toString('latin1');
+    const parts = text.split(`--${boundaryMatch[1]}`);
+    for (const part of parts) {
+        const headerEnd = part.indexOf('\r\n\r\n');
+        if (headerEnd === -1)
+            continue;
+        const headers = part.slice(0, headerEnd).toLowerCase();
+        let content = part.slice(headerEnd + 4);
+        // Strip the trailing CRLF that precedes the next boundary marker.
+        if (content.endsWith('\r\n'))
+            content = content.slice(0, -2);
+        if (headers.includes('application/json') || headers.includes('<jsoninfos>')) {
+            // Reinterpret as UTF-8 (French accented messages).
+            readJsonPart(Buffer.from(content, 'latin1').toString('utf8'));
+        }
+        else if (headers.includes('<label>') || headers.includes('octet-stream')) {
+            result.labelBytes = Buffer.from(content, 'latin1');
+        }
+    }
+    return result;
+}
+// =============================================================================
+// SLS letter construction
+// =============================================================================
+function buildLetter(params) {
+    const { credentials, productCode, weightKg, orderRef, commercialName, sender, addressee, pickupLocationId, format, } = params;
+    const isRelay = productCode === 'A2P' || productCode === 'BPR';
+    const today = new Date();
+    const depositDate = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, '0')}-${String(today.getDate()).padStart(2, '0')}`;
+    // Omit optional fields entirely rather than sending them empty.
+    const compact = (obj) => {
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            if (v !== undefined && v !== null && v !== '')
+                out[k] = v;
+        }
+        return out;
+    };
+    return {
+        contractNumber: credentials.contractNumber,
+        password: credentials.password,
+        outputFormat: { x: 0, y: 0, outputPrintingType: format },
+        letter: {
+            service: compact({
+                productCode,
+                depositDate,
+                orderNumber: orderRef,
+                // Shown in customer SMS/email notifications — mandatory for relay.
+                commercialName,
+            }),
+            parcel: compact({
+                // 2 decimals max per the SLS spec.
+                weight: Math.round(weightKg * 100) / 100,
+                // Must be present for relay products and ABSENT for home delivery.
+                pickupLocationId: isRelay ? pickupLocationId : undefined,
+            }),
+            sender: {
+                senderParcelRef: orderRef,
+                address: compact({
+                    companyName: sender.companyName,
+                    line2: sender.line2,
+                    line3: sender.line3,
+                    zipCode: sender.zipCode,
+                    city: sender.city,
+                    countryCode: sender.countryCode,
+                    email: sender.email,
+                    phoneNumber: sender.phoneNumber,
+                }),
+            },
+            addressee: {
+                addresseeParcelRef: orderRef,
+                address: compact({
+                    firstName: addressee.firstName,
+                    lastName: addressee.lastName,
+                    line2: addressee.line2,
+                    line3: addressee.line3,
+                    zipCode: addressee.zipCode,
+                    city: addressee.city,
+                    countryCode: addressee.countryCode,
+                    phoneNumber: addressee.phoneNumber,
+                    mobileNumber: addressee.mobileNumber,
+                    email: addressee.email,
+                }),
+            },
+        },
+    };
+}
+// =============================================================================
+// Public API — validation
+// =============================================================================
+/**
+ * Validate Colissimo credentials via `checkGenerateLabel` (pure validation —
+ * no parcel is created, nothing is billed). Never throws.
+ */
+export async function validateColissimoCredentials(contractNumber, password) {
+    try {
+        const body = buildLetter({
+            credentials: { contractNumber, password },
+            check: true,
+            productCode: 'DOM',
+            weightKg: 1,
+            orderRef: 'ROVELA-VALIDATE',
+            commercialName: 'Validation',
+            sender: {
+                companyName: 'Validation', line2: '10 rue de Rivoli',
+                zipCode: '75004', city: 'Paris', countryCode: 'FR',
+            },
+            addressee: {
+                firstName: 'Jean', lastName: 'Dupont', line2: '5 avenue Jean Jaures',
+                zipCode: '69007', city: 'Lyon', countryCode: 'FR', mobileNumber: '0612345678',
+            },
+            format: 'PDF_A4_300dpi',
+        });
+        const response = await fetch(`${SLS_BASE_URL}/checkGenerateLabel`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        const parsed = parseSlsResponse(Buffer.from(await response.arrayBuffer()), response.headers.get('content-type') || '');
+        const hasError = parsed.messages.some((m) => m.type === 'ERROR');
+        if (!hasError && response.ok)
+            return { valid: true };
+        return { valid: false, error: friendlyError(parsed.messages) };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: error instanceof Error ? error.message : 'Network error contacting Colissimo',
+        };
+    }
+}
+// =============================================================================
+// Public API — label generation
+// =============================================================================
+/**
+ * Generate a Colissimo shipping label (SLS `generateLabel`).
+ *
+ * IMPORTANT: every successful call creates a REAL parcel number on the
+ * merchant's contract (free until physically scanned). Labels cannot be
+ * re-downloaded from Colissimo — the caller MUST persist `labelBytes`.
+ */
+export async function generateColissimoLabel(params) {
+    const credentials = await getColissimoCredentials();
+    const format = params.format || 'PDF_A4_300dpi';
+    const isRelay = params.productCode === 'A2P' || params.productCode === 'BPR';
+    if (isRelay && !params.pickupLocationId) {
+        throw new ColissimoError('A pickup point is required for relay delivery.');
+    }
+    if (isRelay && !params.addressee.mobileNumber) {
+        throw new ColissimoError('A French mobile number is required for pickup-point delivery (Colissimo sends the customer an SMS).');
+    }
+    if (!(params.weightKg >= 0.01 && params.weightKg <= 30)) {
+        throw new ColissimoError(`Parcel weight must be between 0.01 and 30 kg (got ${params.weightKg} kg). Split heavier orders into multiple parcels.`);
+    }
+    const body = buildLetter({ credentials, check: false, format, ...params });
+    const response = await fetch(`${SLS_BASE_URL}/generateLabel`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    // Parse the body even on 4xx — the error catalog rides the same wrapper.
+    const parsed = parseSlsResponse(Buffer.from(await response.arrayBuffer()), response.headers.get('content-type') || '');
+    const hasError = parsed.messages.some((m) => m.type === 'ERROR');
+    if (hasError || !response.ok) {
+        throw new ColissimoError(friendlyError(parsed.messages), parsed.messages);
+    }
+    if (!parsed.parcelNumber || !parsed.labelBytes || parsed.labelBytes.length === 0) {
+        throw new ColissimoError('Colissimo returned no label. Please try again.', parsed.messages);
+    }
+    return {
+        parcelNumber: parsed.parcelNumber,
+        labelBytes: parsed.labelBytes,
+        format,
+        warnings: parsed.messages.filter((m) => m.type !== 'ERROR'),
+    };
+}
+/** Public tracking page for a Colissimo parcel (no API key needed). */
+export function colissimoTrackingUrl(parcelNumber) {
+    return `https://www.laposte.fr/outils/suivre-vos-envois?code=${encodeURIComponent(parcelNumber)}`;
+}
+function toRelayPoint(raw) {
+    const closed = (h) => !h || h === '00:00-00:00';
+    const hours = [
+        raw.horairesOuvertureLundi,
+        raw.horairesOuvertureMardi,
+        raw.horairesOuvertureMercredi,
+        raw.horairesOuvertureJeudi,
+        raw.horairesOuvertureVendredi,
+        raw.horairesOuvertureSamedi,
+        raw.horairesOuvertureDimanche,
+    ].map((h) => (closed(h) ? null : h));
+    return {
+        id: raw.identifiant,
+        name: raw.nom,
+        type: raw.typeDePoint,
+        line1: raw.adresse1 || '',
+        line2: [raw.adresse2, raw.adresse3].filter(Boolean).join(' ') || null,
+        postalCode: raw.codePostal || '',
+        city: raw.localite || '',
+        country: (raw.codePays || 'FR').toUpperCase(),
+        distanceMeters: typeof raw.distanceEnMetre === 'number' ? raw.distanceEnMetre : null,
+        latitude: raw.coordGeolocalisationLatitude || null,
+        longitude: raw.coordGeolocalisationLongitude || null,
+        maxWeightGrams: typeof raw.poidsMaxi === 'number' ? raw.poidsMaxi : null,
+        /** Mon..Sun; null = closed that day. */
+        openingHours: hours,
+    };
+}
+/** Relay point types we support in v1 (map cleanly to A2P/BPR products). */
+const SUPPORTED_RELAY_TYPES = new Set(['A2P', 'BPR', 'CDI', 'ACP', 'CMT', 'PCS', 'BDP']);
+/** Map a relay point's type to the SLS product code for label generation. */
+export function relayTypeToProductCode(type) {
+    // Post-office family (bureau de poste / centre de distribution / agence).
+    if (type === 'BPR' || type === 'CDI' || type === 'ACP')
+        return 'BPR';
+    // Merchant relays + lockers.
+    return 'A2P';
+}
+/**
+ * Search pickup points around an address (findRDVPointRetraitAcheminement).
+ * Weight is passed in GRAMS (points enforce per-point maximums).
+ */
+export async function searchRelayPoints(params) {
+    const credentials = await getColissimoCredentials();
+    const d = new Date(Date.now() + 24 * 3600 * 1000);
+    const shippingDate = `${String(d.getDate()).padStart(2, '0')}/${String(d.getMonth() + 1).padStart(2, '0')}/${d.getFullYear()}`;
+    // Empty-valued params break the call — build the body without them.
+    const body = {
+        accountNumber: credentials.contractNumber,
+        password: credentials.password,
+        zipCode: params.zipCode,
+        city: params.city,
+        countryCode: (params.countryCode || 'FR').toUpperCase(),
+        weight: String(Math.max(1, Math.round(params.weightGrams ?? 1000))),
+        shippingDate,
+        filterRelay: '1',
+        requestId: `rovela-${Date.now()}`,
+        lang: 'FR',
+    };
+    if (params.address)
+        body.address = params.address;
+    const response = await fetch(`${PDR_BASE_URL}/findRDVPointRetraitAcheminement`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        throw new ColissimoError(`Colissimo pickup-point search failed (${response.status})`);
+    }
+    const data = (await response.json());
+    if (data.errorCode && data.errorCode !== 0) {
+        throw new ColissimoError(`Colissimo pickup-point search failed: ${data.errorMessage || data.errorCode}`);
+    }
+    return (data.listePointRetraitAcheminement ?? [])
+        .filter((p) => p?.identifiant && SUPPORTED_RELAY_TYPES.has(p.typeDePoint))
+        .map(toRelayPoint);
+}
+/**
+ * Fetch one pickup point by id (findPointRetraitAcheminementByID) — the
+ * server-side re-verification used by the pricing core at quote time.
+ * Returns null when the point is unknown/unavailable.
+ */
+export async function getRelayPointById(id) {
+    try {
+        const credentials = await getColissimoCredentials();
+        const d = new Date(Date.now() + 24 * 3600 * 1000);
+        const date = `${String(d.getDate()).padStart(2, '0')}/${String(d.getMonth() + 1).padStart(2, '0')}/${d.getFullYear()}`;
+        // NOTE: this endpoint REQUIRES `date` (error 106 without it) and takes
+        // `langue` — its sibling search endpoint takes `lang`; `lang` here → 500.
+        const body = {
+            accountNumber: credentials.contractNumber,
+            password: credentials.password,
+            id,
+            date,
+            langue: 'FR',
+        };
+        const response = await fetch(`${PDR_BASE_URL}/findPointRetraitAcheminementByID`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        if (data.errorCode && data.errorCode !== 0)
+            return null;
+        const raw = data.pointRetraitAcheminement;
+        if (!raw?.identifiant)
+            return null;
+        return toRelayPoint(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Helpers shared with the admin fulfillment surface
+// =============================================================================
+/** French mobile check (Colissimo requires 06/07 mobiles for relay SMS). */
+export function isFrenchMobile(phone) {
+    if (!phone)
+        return false;
+    const digits = phone.replace(/[\s.\-()]/g, '');
+    return /^(?:\+33|0033|0)[67]\d{8}$/.test(digits);
+}
+/** Normalize a French mobile to the 10-digit national form Colissimo expects. */
+export function normalizeFrenchMobile(phone) {
+    const digits = phone.replace(/[\s.\-()]/g, '');
+    const m = /^(?:\+33|0033)([67]\d{8})$/.exec(digits);
+    if (m)
+        return `0${m[1]}`;
+    return digits;
+}
+//# sourceMappingURL=colissimo.js.map

package/dist/shipping/colissimo.js.map

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

package/dist/shipping/index.d.ts

@@ -2,7 +2,10 @@
  * @rovela/sdk/shipping
  *
  * Shipping module for carrier integrations.
- * Currently supports Shippo for real-time carrier rates and label purchases.
+ * - Shippo: real-time carrier rates and label purchases.
+ * - Colissimo (La Poste): label generation + pickup-point (relay) delivery.
  */
 export { validateShippoKey, getShippoRates, purchaseShippoLabel, shippoRatesToStripeOptions, } from './shippo';
+export { validateColissimoCredentials, generateColissimoLabel, searchRelayPoints, getRelayPointById, relayTypeToProductCode, colissimoTrackingUrl, isFrenchMobile, normalizeFrenchMobile, parseSlsResponse, ColissimoError, } from './colissimo';
+export type { ColissimoCredentials, ColissimoSenderAddress, ColissimoAddressee, ColissimoProductCode, ColissimoLabelFormat, ColissimoLabelResult, ColissimoValidationResult, ColissimoMessage, } from './colissimo';
 //# sourceMappingURL=index.d.ts.map

package/dist/shipping/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shipping/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shipping/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,aAAa,CAAA"}

package/dist/shipping/index.js

@@ -2,7 +2,9 @@
  * @rovela/sdk/shipping
  *
  * Shipping module for carrier integrations.
- * Currently supports Shippo for real-time carrier rates and label purchases.
+ * - Shippo: real-time carrier rates and label purchases.
+ * - Colissimo (La Poste): label generation + pickup-point (relay) delivery.
  */
 export { validateShippoKey, getShippoRates, purchaseShippoLabel, shippoRatesToStripeOptions, } from './shippo';
+export { validateColissimoCredentials, generateColissimoLabel, searchRelayPoints, getRelayPointById, relayTypeToProductCode, colissimoTrackingUrl, isFrenchMobile, normalizeFrenchMobile, parseSlsResponse, ColissimoError, } from './colissimo';
 //# sourceMappingURL=index.js.map

package/dist/shipping/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shipping/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shipping/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAA"}

package/docs/changelog/epoch-07-shipping-carriers.md

@@ -0,0 +1,125 @@
+# E7 Shipping carriers — 0.20.0..0.20.0
+
+## What landed
+Shipping became a carrier REGISTRY (the payments-registry model): multiple
+carriers coexist, each with its own zones + rates, and the global
+`store_settings.shipping_mode` either/or is retired (column kept, ignored).
+Colissimo (La Poste) is the first integrated carrier: label generation from
+the admin order page (home + point relais products), pickup-point (relay)
+delivery at checkout with a nested point picker, tracking links, and the
+order-shipped email carrying the tracking number. Relay offers are ordinary
+`shipping_rates` rows (`fulfillment='relay'`) — zones, cart thresholds and
+customer-group gating apply to every carrier through the one rate engine.
+
+## SDK-internal (free via pin bump)
+- Checkout `ShippingOptions` renders carrier groups as contained parent
+  cards (identity header w/ provider badge or merchant `logo_url`, child
+  option cards at full width) and sorts groups + options by price
+  descending. `renderOptionDetail` slot nests content under an option.
+- Quote API degrades gracefully: a Shippo outage drops its live quotes but
+  no longer blanks the other carriers' options.
+- `sendStatusNotification` logs shipped-email failures honestly (was an
+  unconditional "sent" log).
+- Order confirmation + shipped emails label relay orders' address block
+  "Point relais — {name}" instead of presenting the relay street as the
+  customer's home address.
+
+## Template contract
+- `app/api/checkout/colissimo-relays/route.ts` (NEW) — re-export of
+  `@rovela-ai/sdk/checkout/api/colissimo-relays`; the checkout relay picker
+  POSTs here. Without it, selecting a relay rate shows a permanent
+  "search failed" state.
+- `app/api/admin/shipping/colissimo/route.ts` (NEW) — GET/POST/DELETE
+  re-exports (`getColissimoConfig`/`saveColissimoSettings`/
+  `deleteColissimoSettings`); the ShippingSettings Colissimo panel reads and
+  writes through it.
+- `app/api/admin/orders/[id]/ship-with-colissimo/route.ts` (NEW) — POST
+  `shipWithColissimo`; `app/api/admin/orders/[id]/colissimo-defaults/route.ts`
+  (NEW) — GET `getColissimoDefaults`; `app/api/admin/orders/[id]/label/route.ts`
+  (NEW) — GET `downloadOrderLabel` (admin-gated label bytes; `orders.label_url`
+  points at this path for Colissimo labels).
+
+## Behavior contracts
+- `checkout/api/shipping` (quote) now UNIONS all active carriers' DB rates
+  with Shippo live quotes when a `provider='shippo'` carrier is active —
+  `store_settings.shipping_mode` no longer selects a path. A legacy
+  `shipping_mode='shippo'` store self-heals a shippo carrier row
+  (`ensureLegacyShippoCarrier`) on the first quote/admin-carriers read.
+  Response `mode` field is now the constant `'manual'` (legacy shape only).
+- `resolveShippingSelection` manual branch: rates from provider-bound
+  carriers stamp `orders.carrier` with the PROVIDER (`'colissimo'`), not the
+  carrier's slug. Rates with `fulfillment='relay'` REQUIRE
+  `selection.relayPointId`; the point is re-verified with the carrier and a
+  French mobile is required on the shipping address (PricingError
+  otherwise). The relay's address becomes the order's `shippingAddress`
+  snapshot ("Point relais — {name}" convention, mirroring §59 pickup); the
+  customer's own entered address is preserved as `billingAddress` when no
+  separate billing was given.
+- `ShippingOption.source` union is unchanged (`manual|shippo|pickup`) but
+  options gained `provider?`/`fulfillment?`/`relayPointId?` — custom
+  checkout code switching on `source` keeps working.
+- Admin `ShippingSettings` is carriers-first: the manual/shippo mode toggle
+  is GONE; Shippo config renders inside its carrier card (own transactional
+  Save), the AdminSaveBar document now tracks only `shippingCountries`.
+
+## Custom-code hazards
+- grep `shippingMode` in store code: any UI/logic branching on
+  `'manual' | 'shippo'` is dead — the quote response's `mode` is now a
+  constant. Replace with capability checks on the options themselves.
+- grep `source === 'relay'` (stores that adopted 0.20.0 pre-releases only):
+  the relay discriminator is `fulfillment === 'relay'`; `'relay'` was never
+  a published `source` value.
+- Stores with a custom checkout that forked `ShippingOptions`: the fork
+  misses the carrier-group containers and the `renderOptionDetail` slot —
+  relay rates will render without a point picker. Replace the fork or port
+  the slot.
+
+## DB
+- `shipping_carriers.provider varchar(20) NOT NULL DEFAULT 'manual'`,
+  `shipping_carriers.logo_url varchar(500)`,
+  `shipping_rates.fulfillment varchar(20) NOT NULL DEFAULT 'home'` — all
+  self-heal via `ensureShippingCarrierSchema()` at every carrier/zone/rate
+  chokepoint. Defaults make existing data behave identically.
+- `orders.relay jsonb` (`{provider,id,type,name}`) — rides
+  `ensurePaymentMethodsSchema()`.
+- `shipping_labels` (NEW table: order_id FK cascade, carrier, format,
+  data base64) — self-heals whole via `ensureShippingLabelsSchema()`.
+  Deliberately not a column on orders (drizzle full-row selects).
+- `store_settings`: `colissimo_contract_number varchar(20)`,
+  `colissimo_password varchar(64)` (SERVER-ONLY secret — stripped from the
+  admin settings GET; never `NEXT_PUBLIC_`, never client-side),
+  `colissimo_enabled boolean`, `colissimo_sender_address jsonb`,
+  `colissimo_default_weight_kg decimal` — ride `ensureStoreSettingsSchema()`.
+
+## New surfaces
+- The five routes in Template contract above. No new admin PAGES — the
+  Colissimo panel lives inside `/admin/shipping`'s carrier card and the
+  "Ship with Colissimo" card inside the existing order detail page.
+
+## MERCHANT-DATA HAZARD
+- A store that ran `shipping_mode='shippo'`: its Shippo config keeps working
+  through the self-healed carrier row, but the row is created ACTIVE — if
+  the merchant had abandoned Shippo (mode set but key removed), the quote
+  path silently skips it (no key → degraded, no options added). Audit: does
+  the store have `shippo_api_key` set AND `shipping_mode='shippo'`? If mode
+  is shippo but the key is gone, deactivate the self-healed carrier row.
+- Parcel weight for Colissimo labels reads the product `weight` METAFIELD
+  (kg, PrestaShop-import convention) with `colissimo_default_weight_kg` as
+  the per-item fallback — stores without weight metafields ship at the
+  default weight unless the admin overrides per label.
+
+## Verify
+- `/admin/shipping`: carriers list renders (no mode toggle); "Add carrier"
+  offers Manual/Colissimo/Shippo with duplicates disabled; a Colissimo
+  carrier card shows the Connection panel and its zones/rates; the rate
+  editor on a Colissimo carrier shows "Delivery type: Home / Pickup point".
+- Checkout with a FR address: carrier groups render with badges, sorted by
+  price desc; selecting a relay rate opens the nested point picker; continue
+  is blocked until a point is picked and the address has a FR mobile.
+- Place a relay order (manual payment path is fine): `orders.relay` set,
+  `shipping_address` = the relay's address, `carrier='colissimo'`.
+- Admin: mark paid → "Ship with Colissimo" (weight prefilled from
+  metafields) → Generate Label & Ship → tracking number appears (`6M`/`6H`
+  prefix for relay, `6A`/`6C` for home), label downloads from
+  `/api/admin/orders/{id}/label`, shipped email sent with tracking.
+- `npm run build` green.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rovela-ai/sdk",
-  "version": "0.19.8",
+  "version": "0.20.0",
   "description": "Rovela SDK - Pre-built e-commerce components for AI-powered store generation",
   "type": "module",
   "license": "MIT",
@@ -90,6 +90,10 @@
       "types": "./dist/checkout/api/pickup-locations.d.ts",
       "import": "./dist/checkout/api/pickup-locations.js"
     },
+    "./checkout/api/colissimo-relays": {
+      "types": "./dist/checkout/api/colissimo-relays.d.ts",
+      "import": "./dist/checkout/api/colissimo-relays.js"
+    },
     "./checkout/server": {
       "types": "./dist/checkout/server/index.d.ts",
       "import": "./dist/checkout/server/index.js"
@@ -292,6 +296,7 @@
   },
   "scripts": {
     "build": "tsc && cp -r src/admin/styles dist/admin/",
+    "prepublishOnly": "npm run build && cd ../.. && bash scripts/check-prompts.sh",
     "dev": "tsc --watch",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
     "db:push": "drizzle-kit push",

package/templates/store-template/.claude/skills/manage-products/SKILL.md

@@ -33,7 +33,7 @@ Usage: `nextjs_call` with `port="3000"` and `toolName="execute_sql"`
 | `orders` | id, customerId, email, status, total, currency (ISO snapshot — display orders in THIS currency), refundAmount, returnReason, shippingAddress (JSONB) |
 | `order_items` | id, orderId (CASCADE), productId, variantId, name, price, quantity |
 | `customers` | id, email (unique), name, passwordHash, phone, groupId, locale, stripeCustomerId, emailVerified |
-| `store_settings` | id, storeName, storeEmail, storeCurrency, storeTimezone, storeCountry, defaultLocale, enabledLocales, taxIncludedInPrices, shippingMode |
+| `store_settings` | id, storeName, storeEmail, storeCurrency, storeTimezone, storeCountry, defaultLocale, enabledLocales, taxIncludedInPrices, shippingMode (retired — the shipping_carriers registry decides; carriers have provider manual/shippo/colissimo, rates have fulfillment home/relay) |
 
 **Money contract (load-bearing)**: `price`, `total` etc. are DECIMAL CURRENCY UNITS — `29.99`, NEVER cents (`2999`). No ×100/÷100 anywhere except the Stripe API boundary. On multilingual stores (`enabled_locales`), catalog content can carry per-locale `translations` — when editing names/descriptions, keep every enabled locale in sync (CLAUDE.md §5.5).