@commercejs/adapter-salla 0.1.0

package/dist/mappers/order.js

@@ -0,0 +1,141 @@
+// ---------------------------------------------------------------------------
+// Salla → Order mapper
+// ---------------------------------------------------------------------------
+import { mapSallaAddress } from './customer.js';
+function toLocalized(value, locale = 'ar') {
+    if (locale === 'en')
+        return { ar: '', en: value ?? '' };
+    return { ar: value ?? '', en: '' };
+}
+function toPrice(amount, currency) {
+    return { amount, currency, formatted: `${amount.toFixed(2)} ${currency}` };
+}
+/** Extract a date string from Salla's date object or ISO string */
+function extractDate(date) {
+    if (!date)
+        return new Date().toISOString();
+    if (typeof date === 'string')
+        return date;
+    return date.date;
+}
+/** Map Salla order status slug → our OrderStatus */
+function mapOrderStatus(slug) {
+    switch (slug) {
+        case 'under_review':
+        case 'in_progress':
+            return 'processing';
+        case 'completed':
+        case 'delivered':
+            return 'delivered';
+        case 'shipped':
+        case 'in_transit':
+            return 'shipped';
+        case 'cancelled':
+            return 'cancelled';
+        case 'refunded':
+            return 'refunded';
+        case 'restoring':
+        case 'restored':
+            return 'returned';
+        default:
+            return 'pending';
+    }
+}
+/** Map Salla raw order → unified Order */
+export function mapSallaOrder(raw, locale = 'ar') {
+    const currency = raw.currency || 'SAR';
+    const items = raw.items.map((item) => mapSallaOrderItem(item, currency, locale));
+    const requiresShipping = raw.shipping !== null;
+    // Listing endpoint may not include `amounts` — use top-level `total` as fallback
+    const amounts = raw.amounts;
+    const fallbackTotal = raw.total;
+    let subtotal = 0, shippingCost = 0, taxAmount = 0, discountTotal = 0, total = 0;
+    if (amounts) {
+        subtotal = amounts.sub_total?.amount ?? 0;
+        shippingCost = amounts.shipping_cost?.amount ?? 0;
+        // discounts is an array in the real API — sum them up
+        discountTotal = Array.isArray(amounts.discounts)
+            ? amounts.discounts.reduce((sum, d) => sum + (d.amount ?? 0), 0)
+            : amounts.discounts?.amount ?? 0;
+        // tax.amount is nested: { percent, amount: { amount, currency } }
+        taxAmount = typeof amounts.tax?.amount === 'object'
+            ? amounts.tax.amount.amount
+            : amounts.tax?.amount ?? 0;
+        total = amounts.total?.amount ?? 0;
+    }
+    else if (fallbackTotal) {
+        total = fallbackTotal.amount;
+        subtotal = total;
+    }
+    return {
+        id: String(raw.id),
+        orderNumber: String(raw.reference_id),
+        status: mapOrderStatus(raw.status.slug),
+        items,
+        totals: {
+            subtotal: toPrice(subtotal, currency),
+            shipping: toPrice(shippingCost, currency),
+            tax: toPrice(taxAmount, currency),
+            discount: toPrice(discountTotal, currency),
+            total: toPrice(total, currency),
+        },
+        shippingAddress: raw.shipping?.address ? mapSallaAddress(raw.shipping.address) : null,
+        billingAddress: null,
+        shippingMethod: raw.shipping?.company
+            ? {
+                id: 'salla-shipping',
+                name: toLocalized(raw.shipping.company, locale),
+                provider: 'custom',
+                estimatedDays: { min: 0, max: 0 },
+                price: toPrice(shippingCost, currency),
+                cashOnDelivery: false,
+            }
+            : null,
+        paymentMethod: raw.payment_method
+            ? {
+                id: 'salla-payment',
+                name: toLocalized(raw.payment_method, locale),
+                type: 'custom',
+                provider: raw.payment_method,
+                icon: null,
+                installments: null,
+            }
+            : null,
+        trackingNumber: raw.shipping?.shipment?.tracking_number ?? null,
+        trackingUrl: raw.shipping?.shipment?.tracking_link ?? null,
+        note: raw.note,
+        customerId: raw.customer ? String(raw.customer.id) : null,
+        requiresShipping,
+        createdAt: extractDate(raw.created_at),
+        updatedAt: extractDate(raw.updated_at),
+        // B2B fields
+        paymentTerms: null,
+        purchaseOrderNumber: null,
+        companyName: null,
+        giftCardCodesApplied: [],
+        giftCardAmountApplied: null,
+    };
+}
+/** Map Salla raw order item → unified OrderItem */
+function mapSallaOrderItem(raw, currency, locale) {
+    const image = raw.image
+        ? { url: raw.image.url, alt: raw.image.alt ?? '' }
+        : raw.thumbnail
+            ? { url: raw.thumbnail, alt: '' }
+            : null;
+    return {
+        id: String(raw.id ?? raw.name),
+        productId: String(raw.product_id ?? ''),
+        variantId: null,
+        name: toLocalized(raw.name, locale),
+        image,
+        quantity: raw.quantity,
+        price: raw.price ? toPrice(raw.price.amount, currency) : toPrice(0, currency),
+        totalPrice: raw.total ? toPrice(raw.total.amount, currency) : toPrice(0, currency),
+        fulfillmentStatus: 'unfulfilled',
+        productType: 'physical',
+        digital: null,
+        event: null,
+    };
+}
+//# sourceMappingURL=order.js.map

package/dist/mappers/order.js.map

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

package/dist/mappers/payment.d.ts

@@ -0,0 +1,5 @@
+import type { PaymentMethod } from '@commercejs/types';
+import type { SallaRawPaymentMethod } from '../types.js';
+/** Map Salla raw payment method → unified PaymentMethod */
+export declare function mapSallaPayment(raw: SallaRawPaymentMethod, locale?: string): PaymentMethod;
+//# sourceMappingURL=payment.d.ts.map

package/dist/mappers/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/mappers/payment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,mBAAmB,CAAA;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAOxD,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,GAAG,EAAE,qBAAqB,EAAE,MAAM,GAAE,MAAa,GAAG,aAAa,CAShG"}

package/dist/mappers/payment.js

@@ -0,0 +1,20 @@
+// ---------------------------------------------------------------------------
+// Salla → Payment mapper
+// ---------------------------------------------------------------------------
+function toLocalized(value, locale = 'ar') {
+    if (locale === 'en')
+        return { ar: '', en: value };
+    return { ar: value, en: '' };
+}
+/** Map Salla raw payment method → unified PaymentMethod */
+export function mapSallaPayment(raw, locale = 'ar') {
+    return {
+        id: String(raw.id),
+        name: toLocalized(raw.name, locale),
+        type: raw.slug ?? 'custom',
+        provider: raw.slug ?? 'salla',
+        icon: raw.logo ?? null,
+        installments: null,
+    };
+}
+//# sourceMappingURL=payment.js.map

package/dist/mappers/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/mappers/payment.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAK9E,SAAS,WAAW,CAAC,KAAa,EAAE,SAAiB,IAAI;IACvD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;IACjD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;AAC9B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,eAAe,CAAC,GAA0B,EAAE,SAAiB,IAAI;IAC/E,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;QACnC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,QAAQ;QAC1B,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,OAAO;QAC7B,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI;QACtB,YAAY,EAAE,IAAI;KACnB,CAAA;AACH,CAAC"}

package/dist/mappers/product.d.ts

@@ -0,0 +1,5 @@
+import type { Product } from '@commercejs/types';
+import type { SallaRawProduct } from '../types.js';
+/** Map Salla raw product → unified Product */
+export declare function mapSallaProduct(raw: SallaRawProduct, locale?: string): Product;
+//# sourceMappingURL=product.d.ts.map

package/dist/mappers/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/mappers/product.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,OAAO,EAUR,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,eAAe,EAA8C,MAAM,aAAa,CAAA;AA4C9F,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,GAAE,MAAa,GAAG,OAAO,CAsFpF"}

package/dist/mappers/product.js

@@ -0,0 +1,143 @@
+// ---------------------------------------------------------------------------
+// Salla → Product mapper
+// ---------------------------------------------------------------------------
+/** Map Salla product type string → our ProductType discriminator */
+function mapProductType(type) {
+    switch (type) {
+        case 'digital':
+        case 'codes':
+            return 'digital';
+        case 'service':
+            return 'service';
+        case 'food':
+        case 'group_products':
+        case 'product':
+        default:
+            return 'physical';
+    }
+}
+/** Format a price amount as a human-readable string */
+function formatAmount(amount, currency) {
+    return `${amount.toFixed(2)} ${currency}`;
+}
+/** Build a Price object from amount + currency */
+function toPrice(amount, currency) {
+    return { amount, currency, formatted: formatAmount(amount, currency) };
+}
+/** Map a Salla raw image → our Image type */
+function mapImage(img) {
+    return {
+        url: img.url,
+        alt: img.alt ?? '',
+    };
+}
+/** Build a bilingual LocalizedString from Salla (API returns single-locale) */
+function toLocalized(value, locale = 'ar') {
+    if (locale === 'en') {
+        return { ar: '', en: value ?? '' };
+    }
+    return { ar: value ?? '', en: '' };
+}
+/** Map Salla raw product → unified Product */
+export function mapSallaProduct(raw, locale = 'ar') {
+    const productType = mapProductType(raw.type);
+    const price = {
+        amount: raw.price.amount,
+        currency: raw.price.currency,
+        formatted: formatAmount(raw.price.amount, raw.price.currency),
+        originalAmount: raw.regular_price.amount !== raw.price.amount ? raw.regular_price.amount : undefined,
+        discountPercent: raw.sale_price
+            ? Math.round(((raw.regular_price.amount - raw.sale_price.amount) / raw.regular_price.amount) * 100)
+            : undefined,
+    };
+    const primaryImage = raw.images.find((img) => img.main) ? mapImage(raw.images.find((img) => img.main)) : raw.images[0] ? mapImage(raw.images[0]) : null;
+    const gallery = raw.images.map(mapImage);
+    const variants = raw.skus.map((sku) => mapSallaSku(sku, raw, locale));
+    // Only show options as specifications when there are no SKU variants,
+    // otherwise they are already represented in the Variants section
+    const attributes = raw.skus.length > 0
+        ? []
+        : raw.options.flatMap((opt) => opt.values.map((v) => ({
+            code: String(opt.id),
+            name: toLocalized(opt.name, locale),
+            value: toLocalized(v.name, locale),
+        })));
+    return {
+        id: String(raw.id),
+        sku: raw.sku,
+        name: toLocalized(raw.name, locale),
+        slug: raw.slug,
+        description: raw.description ? toLocalized(raw.description, locale) : null,
+        shortDescription: raw.short_description ? toLocalized(raw.short_description, locale) : null,
+        price,
+        primaryImage,
+        gallery,
+        rating: raw.rating ? { average: raw.rating.average, count: raw.rating.count } : null,
+        variants,
+        options: raw.options.map((opt) => ({
+            id: String(opt.id),
+            name: toLocalized(opt.name, locale),
+            values: opt.values.map((v) => ({
+                id: String(v.id),
+                name: toLocalized(v.name, locale),
+            })),
+        })),
+        attributes,
+        quantityLimit: raw.max_quantity_per_order,
+        categories: raw.categories.map((cat) => ({
+            id: String(cat.id),
+            name: toLocalized(cat.name, locale),
+            slug: cat.slug,
+            description: null,
+            image: null,
+            parentId: null,
+            children: [],
+            productCount: null,
+        })),
+        inStock: raw.is_available,
+        vatIncluded: true,
+        vatRate: 0.15,
+        tags: raw.tags.map((t) => t.name),
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+        // Product type metadata
+        productType,
+        digital: productType === 'digital' ? { downloadUrl: null, fileSize: null, fileType: null, licenseKey: null, maxDownloads: null, expiresInHours: null } : null,
+        service: productType === 'service' ? { durationMinutes: null, requiresBooking: false, deliveryMode: 'in_person' } : null,
+        event: null,
+        subscription: null,
+        auction: null,
+        rental: null,
+        preOrder: null,
+        requiresShipping: raw.require_shipping,
+        minOrderQuantity: raw.min_quantity_per_order,
+        priceTiers: null,
+        customerGroupPricing: null,
+        isDropshipped: false,
+    };
+}
+/** Map Salla SKU → ProductVariant */
+function mapSallaSku(sku, product, locale) {
+    // Note: In Salla, SKU resolution is done server-side when adding to cart.
+    // The frontend sends selected option value IDs (e.g. { optionId: valueId })
+    // and Salla resolves the correct SKU + price. We don't map variant attributes
+    // because `related_option_values` is unreliable for client-side matching.
+    return {
+        id: String(sku.id),
+        sku: sku.sku,
+        name: null,
+        price: {
+            amount: sku.price.amount,
+            currency: sku.price.currency,
+            formatted: formatAmount(sku.price.amount, sku.price.currency),
+            originalAmount: sku.regular_price.amount !== sku.price.amount ? sku.regular_price.amount : undefined,
+            discountPercent: sku.sale_price
+                ? Math.round(((sku.regular_price.amount - sku.sale_price.amount) / sku.regular_price.amount) * 100)
+                : undefined,
+        },
+        inStock: sku.is_available ?? product.is_available,
+        inventoryQuantity: sku.stock_quantity,
+        attributes: [],
+    };
+}
+//# sourceMappingURL=product.js.map

package/dist/mappers/product.js.map

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

package/dist/mappers/review.d.ts

@@ -0,0 +1,5 @@
+import type { Review } from '@commercejs/types';
+import type { SallaRawReview } from '../types.js';
+/** Map Salla raw review → unified Review */
+export declare function mapSallaReview(raw: SallaRawReview): Review;
+//# sourceMappingURL=review.d.ts.map

package/dist/mappers/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/mappers/review.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAW1D"}

package/dist/mappers/review.js

@@ -0,0 +1,17 @@
+// ---------------------------------------------------------------------------
+// Salla → Review mapper
+// ---------------------------------------------------------------------------
+/** Map Salla raw review → unified Review */
+export function mapSallaReview(raw) {
+    return {
+        id: String(raw.id),
+        productId: String(raw.product_id),
+        rating: raw.rating,
+        title: null, // Salla reviews don't have titles
+        body: raw.content,
+        authorName: raw.customer?.name ?? 'Anonymous',
+        verified: true, // Salla only allows verified purchase reviews
+        createdAt: raw.created_at,
+    };
+}
+//# sourceMappingURL=review.js.map

package/dist/mappers/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/mappers/review.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAK9E,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,GAAmB;IAChD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACjC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,IAAI,EAAE,kCAAkC;QAC/C,IAAI,EAAE,GAAG,CAAC,OAAO;QACjB,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,WAAW;QAC7C,QAAQ,EAAE,IAAI,EAAE,8CAA8C;QAC9D,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAA;AACH,CAAC"}

package/dist/mappers/shipping.d.ts

@@ -0,0 +1,5 @@
+import type { ShippingMethod } from '@commercejs/types';
+import type { SallaRawShippingCompany } from '../types.js';
+/** Map Salla raw shipping company → unified ShippingMethod */
+export declare function mapSallaShipping(raw: SallaRawShippingCompany, locale?: string): ShippingMethod;
+//# sourceMappingURL=shipping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.d.ts","sourceRoot":"","sources":["../../src/mappers/shipping.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,mBAAmB,CAAA;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAO1D,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,EAAE,MAAM,GAAE,MAAa,GAAG,cAAc,CASpG"}

package/dist/mappers/shipping.js

@@ -0,0 +1,20 @@
+// ---------------------------------------------------------------------------
+// Salla → Shipping mapper
+// ---------------------------------------------------------------------------
+function toLocalized(value, locale = 'ar') {
+    if (locale === 'en')
+        return { ar: '', en: value ?? '' };
+    return { ar: value ?? '', en: '' };
+}
+/** Map Salla raw shipping company → unified ShippingMethod */
+export function mapSallaShipping(raw, locale = 'ar') {
+    return {
+        id: String(raw.id),
+        name: toLocalized(raw.name, locale),
+        provider: 'custom',
+        estimatedDays: { min: 0, max: 0 }, // Salla doesn't expose this
+        price: { amount: 0, currency: 'SAR', formatted: '0.00 SAR' },
+        cashOnDelivery: false,
+    };
+}
+//# sourceMappingURL=shipping.js.map

package/dist/mappers/shipping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.js","sourceRoot":"","sources":["../../src/mappers/shipping.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAK9E,SAAS,WAAW,CAAC,KAAoB,EAAE,SAAiB,IAAI;IAC9D,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,EAAE,CAAA;IACvD,OAAO,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;AACpC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,GAA4B,EAAE,SAAiB,IAAI;IAClF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;QACnC,QAAQ,EAAE,QAAQ;QAClB,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,4BAA4B;QAC/D,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE;QAC5D,cAAc,EAAE,KAAK;KACtB,CAAA;AACH,CAAC"}