@wocart/storefront 0.0.0-stage → 1.0.0

package/dist/client/shipping.js

@@ -0,0 +1,48 @@
+/**
+ * Shipping Namespace - Delivery Pricing
+ *
+ * Deep module: hides URL construction and the per-wilaya lookup behind two
+ * calls. The server always returns the full per-wilaya map; `rate()` extracts
+ * a single wilaya's pair when the caller only needs one.
+ *
+ * Fetched fresh every request (merchants adjust delivery pricing and expect
+ * the next render to show it); parallel identical calls coalesce into one
+ * request.
+ *
+ * Failure contract: resolves to `{}` /
+ * `null` on any failure — never throws. Absent wilayas have no rule and are
+ * treated as unsupported.
+ */
+import { ShippingRatesSchema } from "../schemas.js";
+import { STOREFRONT_OPERATIONS } from "../domain.js";
+import { reportDegradedRead } from "./core.js";
+/**
+ * Create shipping namespace
+ */
+export function createShippingNamespace(core) {
+    return {
+        async rates() {
+            try {
+                return ((await core.get("/store/shipping-rates", ShippingRatesSchema.nullable(), {
+                    operation: STOREFRONT_OPERATIONS.shippingRates,
+                })) ?? {});
+            }
+            catch (error) {
+                reportDegradedRead(core.config, error, "shipping.rates");
+                return {};
+            }
+        },
+        async rate(wilayaId) {
+            try {
+                const rates = (await core.get("/store/shipping-rates", ShippingRatesSchema.nullable(), {
+                    operation: STOREFRONT_OPERATIONS.shippingRate,
+                })) ?? {};
+                return rates[String(wilayaId)] ?? null;
+            }
+            catch (error) {
+                reportDegradedRead(core.config, error, "shipping.rate");
+                return null;
+            }
+        },
+    };
+}

package/dist/data/communes.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Algeria's 1,551 communes across all 58 wilayas — the reference dataset the
+ * checkout's locality field resolves against.
+ *
+ * Bundled, not fetched: a shopper picking a wilaya gets its communes in the
+ * same tick, with no round-trip to fail on a bad mobile connection. The
+ * server's rows stay reachable through `geo.communes()`; the two are checked
+ * against each other before every release (count, id, wilaya, name, Arabic
+ * name).
+ *
+ * Compact tuple structure: [id, nameFr, nameAr]. Ids are `c-<wilaya>-<n>`, so
+ * the wilaya is part of the identity the server returns.
+ */
+import type { Commune } from "../types.js";
+export type CommuneTuple = readonly [id: string, name: string, nameAr: string];
+export declare const ALGERIA_COMMUNES: Readonly<Record<number, readonly CommuneTuple[]>>;
+/**
+ * The communes of one wilaya, shaped as the wire model: `Commune[]`.
+ *
+ * Answers `[]` for a wilaya the bundle does not know — the caller then decides
+ * whether that is "no localities to show" or "ask the server" (`geo.communes()`
+ * asks). Accepts the string form an `<input>`/`<select>` hands over, so a
+ * browser caller never has to parse first.
+ */
+export declare function communesForWilaya(wilayaId: number | string): Commune[];