storefront-layouts-staging 1.0.0-staging.0

package/dist/lib/shipping-address.util.js

@@ -0,0 +1,149 @@
+/**
+ * ShipBubble address helpers (client-side).
+ * Docs: address string should include street, city, state, and country
+ * e.g. "123 Main St, Victoria Island, Lagos, Nigeria"
+ */
+export const EMPTY_SHIPPING_QUOTE_ADDRESS = {
+    country: '',
+    city: '',
+    street: '',
+    state: '',
+    zipCode: '',
+    phone: '',
+};
+const NIGERIA_CITY_TO_STATE = {
+    lagos: 'Lagos',
+    ikeja: 'Lagos',
+    'victoria island': 'Lagos',
+    lekki: 'Lagos',
+    ikorodu: 'Lagos',
+    surulere: 'Lagos',
+    yaba: 'Lagos',
+    apapa: 'Lagos',
+    ikoyi: 'Lagos',
+    ajah: 'Lagos',
+    abuja: 'FCT',
+    ibadan: 'Oyo',
+    abeokuta: 'Ogun',
+    kano: 'Kano',
+    'port harcourt': 'Rivers',
+    portharcourt: 'Rivers',
+    enugu: 'Enugu',
+    benin: 'Edo',
+    'benin city': 'Edo',
+    warri: 'Delta',
+    asaba: 'Delta',
+    calabar: 'Cross River',
+    owerri: 'Imo',
+    onitsha: 'Anambra',
+    awka: 'Anambra',
+    kaduna: 'Kaduna',
+    jos: 'Plateau',
+};
+export const NIGERIAN_STATES = [
+    'Abia', 'Adamawa', 'Akwa Ibom', 'Anambra', 'Bauchi', 'Bayelsa', 'Benue', 'Borno',
+    'Cross River', 'Delta', 'Ebonyi', 'Edo', 'Ekiti', 'Enugu', 'FCT', 'Gombe', 'Imo',
+    'Jigawa', 'Kaduna', 'Kano', 'Katsina', 'Kebbi', 'Kogi', 'Kwara', 'Lagos', 'Nasarawa',
+    'Niger', 'Ogun', 'Ondo', 'Osun', 'Oyo', 'Plateau', 'Rivers', 'Sokoto', 'Taraba',
+    'Yobe', 'Zamfara',
+];
+export function isNigeria(country) {
+    if (!country)
+        return false;
+    const c = country.trim().toLowerCase();
+    return c === 'nigeria' || c === 'ng';
+}
+export function deriveNigerianStateFromCity(city) {
+    if (!city)
+        return null;
+    return NIGERIA_CITY_TO_STATE[city.trim().toLowerCase()] || null;
+}
+/** Normalize country code and derive Nigerian state when missing. */
+export function enrichShippingQuoteAddress(address) {
+    const country = address.country?.trim() || '';
+    const city = address.city?.trim() || '';
+    const street = (address.street || address.address1 || '').trim();
+    let state = (address.state || '').trim();
+    if (isNigeria(country) && !state && city) {
+        state = deriveNigerianStateFromCity(city) || city;
+    }
+    return {
+        ...address,
+        country,
+        city,
+        street,
+        address1: street || address.address1,
+        state,
+        zipCode: address.zipCode?.trim() || '',
+        phone: address.phone?.trim() || '',
+        email: address.email?.trim() || '',
+    };
+}
+/** ShipBubble validate API address string: "street, city, state, country" */
+export function formatShipBubbleAddressString(address) {
+    const enriched = enrichShippingQuoteAddress(address);
+    const countryName = isNigeria(enriched.country) ? 'Nigeria' : enriched.country;
+    return [enriched.street || enriched.city, enriched.city, enriched.state, countryName]
+        .filter((part) => part && String(part).trim())
+        .join(', ');
+}
+/** Minimum fields required before requesting a ShipBubble-backed quote. */
+export function canRequestShippingQuote(address) {
+    const enriched = enrichShippingQuoteAddress(address);
+    if (!enriched.country || !enriched.city)
+        return false;
+    // ShipBubble needs a deliverable street; fall back to city for rough product-page estimates.
+    const hasLocation = Boolean((enriched.street || enriched.city).trim());
+    if (isNigeria(enriched.country) && !enriched.state)
+        return false;
+    return hasLocation;
+}
+export function buildShippingCalculatePayload(params) {
+    const enriched = enrichShippingQuoteAddress(params.address);
+    const streetForQuote = enriched.street || enriched.city;
+    return {
+        storeId: params.storeId,
+        address: {
+            street: streetForQuote,
+            address1: streetForQuote,
+            city: enriched.city,
+            state: enriched.state || enriched.city,
+            zipCode: enriched.zipCode,
+            country: enriched.country,
+        },
+        customerInfo: {
+            firstName: params.customerInfo?.firstName || 'Customer',
+            lastName: params.customerInfo?.lastName || '',
+            phone: params.customerInfo?.phone || enriched.phone || '+2348000000000',
+            email: params.customerInfo?.email || enriched.email || 'customer@example.com',
+        },
+        items: params.items,
+        subtotal: params.subtotal,
+        currency: params.currency,
+    };
+}
+export function buildDeliveryQuotePayload(params) {
+    const enriched = enrichShippingQuoteAddress(params.address);
+    const streetForQuote = enriched.street || enriched.city;
+    return {
+        storeId: params.storeId,
+        shippingAddress: {
+            firstName: params.customerInfo?.firstName || 'Customer',
+            lastName: params.customerInfo?.lastName || '',
+            street: streetForQuote,
+            address1: streetForQuote,
+            city: enriched.city,
+            state: enriched.state || enriched.city,
+            zipCode: enriched.zipCode,
+            country: isNigeria(enriched.country) ? 'NG' : enriched.country,
+            phone: params.customerInfo?.phone || enriched.phone || '+2348000000000',
+            email: params.customerInfo?.email || enriched.email || 'customer@example.com',
+        },
+        items: params.packages.map((pkg) => ({
+            name: pkg.name || 'Item',
+            quantity: pkg.quantity || 1,
+            weight: pkg.weight,
+            price: pkg.value,
+        })),
+    };
+}

package/dist/lib/shipping-settings.util.d.ts

@@ -0,0 +1,4 @@
+import type { StoreConfig } from './store-types';
+/** True when the store uses automated shipping quotes at checkout / on product pages. */
+export declare function isAutomatedShippingEnabled(storeConfig: Pick<StoreConfig, 'features' | 'settings'>): boolean;
+//# sourceMappingURL=shipping-settings.util.d.ts.map

package/dist/lib/shipping-settings.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping-settings.util.d.ts","sourceRoot":"","sources":["../../src/lib/shipping-settings.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,yFAAyF;AACzF,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,UAAU,CAAC,GACtD,OAAO,CAGT"}

package/dist/lib/shipping-settings.util.js

@@ -0,0 +1,6 @@
+/** True when the store uses automated shipping quotes at checkout / on product pages. */
+export function isAutomatedShippingEnabled(storeConfig) {
+    if (storeConfig.features?.delivery === false)
+        return false;
+    return storeConfig.settings?.shippingEnabled !== false;
+}

package/dist/lib/store-config-utils.d.ts

@@ -0,0 +1,50 @@
+import { type StoreResponse } from './services/store.service';
+import { type Category } from './services/category.service';
+import { type Product } from './services/product.service';
+import { type Service } from './services/service.service';
+import type { StoreConfig, StoreCategory, StoreProduct, StoreService } from './store-types';
+/**
+ * Comprehensive function to extract and validate image URLs from any format
+ * Handles: strings, objects, arrays, JSON-encoded, comma-separated, fragmented JSON
+ * @param input - Can be string, object, array, or any combination
+ * @returns Array of valid absolute image URLs
+ */
+export declare function extractImageUrls(input: any): string[];
+/**
+ * Transforms API Category to StoreCategory format
+ * Uses dedicated category image extraction function for independent validation
+ */
+export declare function transformCategoryToStoreCategory(apiCategory: Category): StoreCategory;
+/**
+ * Transforms API Product to StoreProduct format
+ * Calculates inStock based on trackInventory and inventory data
+ */
+export interface TransformProductOptions {
+    /** When mapping cart line items, preserves cart-aware availableStock from the API. */
+    cartLineQty?: number;
+}
+export declare function transformProductToStoreProduct(apiProduct: Product, options?: TransformProductOptions): StoreProduct;
+/**
+ * Transforms API Service to StoreService format
+ */
+export declare function transformServiceToStoreService(apiService: Service): StoreService;
+/**
+ * Transforms API StoreResponse to StoreConfig format
+ */
+export declare function transformStoreResponseToConfig(apiStore: StoreResponse): StoreConfig;
+/**
+ * Result type for getStoreConfigAsync
+ */
+export interface StoreConfigResult {
+    storeConfig: StoreConfig | null;
+    maintenanceMode: boolean;
+}
+/**
+ * Async function to get store configuration
+ * - For demo stores: uses mock data from mock-stores
+ * - For real stores: fetches from API and transforms to StoreConfig
+ * - Returns null storeConfig if store not found (for 404 handling)
+ * - Returns maintenanceMode flag when store exists but is not published/active
+ */
+export declare function getStoreConfigAsync(storeSlug: string): Promise<StoreConfigResult>;
+//# sourceMappingURL=store-config-utils.d.ts.map

package/dist/lib/store-config-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-config-utils.d.ts","sourceRoot":"","sources":["../../src/lib/store-config-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAmB,aAAa,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,eAAe,CAAC;AAoBhI;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,CAgGrD;AAgVD;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAarF;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,YAAY,CAgMd;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,OAAO,GAAG,YAAY,CA6DhF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,CAyFnF;AA6yBD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyHvF"}