@rovela-ai/sdk 0.19.7 → 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-02-platform-commerce.md

@@ -41,6 +41,17 @@ the NEW SURFACES below make it reachable.
 2. **Native discounts replace Stripe coupons as the merchant surface.**
    Legacy Stripe-coupon helpers still exist (feature-card usage) but the
    admin Discounts manager + `/api/checkout/discount` are the system now.
+   MERCHANT-DATA HAZARD: codes issued as Stripe promotion codes (newsletter
+   welcome flows, coupon feature cards) do NOT validate in the native
+   discount box — customers holding them get "invalid code". Audit for a
+   Stripe-code issuer (grep for `createCouponWithCode` /
+   `createBulkPromotionCodes` / promotion-code inserts) and, if found, emit a
+   merchant follow-up: backfill outstanding codes into the `discounts` table
+   (idempotent INSERTs mirroring the issuer's terms) or keep
+   `store_settings.promotion_codes_enabled = true` so Stripe's own field
+   still accepts them during the transition. Rewire the issuer itself to the
+   native engine (`createDiscount` from `@rovela-ai/sdk/core/server`,
+   0.19.7+).
 3. **`orders.payment_provider`** (default 'stripe') exists — custom order
    readers must not assume every order is a Stripe order (manual methods
    create `pending` orders with `manual_*` idempotency keys).

package/docs/changelog/epoch-06-mobile-integrity.md

@@ -1,4 +1,4 @@
-# E6 Mobile + integrity — 0.19.0..0.19.7
+# E6 Mobile + integrity — 0.19.0..0.19.8
 
 ## What landed
 The save-grammar completion across every admin manager, full mobile
@@ -146,7 +146,35 @@ store code that mints codes programmatically (newsletter welcome flows).
   `OrderTimeline` and `invoice.shipTo`.
 - Cart/checkout pages follow the hydration contract above.
 
+## 0.19.8 — Users row-actions menu portal
+
+### SDK-internal (free via pin bump)
+The `/admin/users` row-actions (⋯) menu portals to `<body>` — it was the one
+menu still rendered in place inside the table's `overflow-x-auto` wrapper,
+which clips vertically too (per CSS spec, auto on one axis forces auto on the
+other), so the LAST rows' menus were cut off at the table edge. It now uses
+the same mechanics AdminSelect adopted in 0.19.7 (`.admin-select-portal`
+fixed positioning, flip-above near the viewport bottom, scroll/resize
+re-anchoring, Escape closes). No API change, no new exports.
+
+Same pass fixed the menu's dead hover states: items referenced
+`--admin-background-hover`, a variable the theme never defined (invalid CSS,
+so hovering did nothing except on destructive items). They now use
+`--admin-background-subtle` — the item-hover token AdminSelect,
+DiscountsManager and RecentOrders already use. There is no
+`--admin-background-hover`; never reference it.
+
+RULE for custom admin code: any menu or dropdown anchored inside a table
+wrapper or any `overflow` ancestor MUST portal to `<body>` — AdminSelect and
+the UsersTable RowActions menu are the two reference implementations. An
+in-place `position: absolute` menu inside a scroller is always a latent
+clipping bug.
+
 ## Verify
+- `/admin/users` with enough rows to reach the viewport bottom: the LAST
+  row's ⋯ menu opens fully visible (flipped above the trigger), actions
+  fire, click-outside and Escape close it, and it tracks the row while
+  scrolling.
 - Resize the admin to 375px: drawer opens from the hamburger, closes on
   scrim/Escape; a delete dialog docks as a bottom sheet; Products table
   scrolls itself (page never scrolls horizontally); Recent Orders shows