@commercejs/platform 0.1.0

package/README.md

@@ -0,0 +1,156 @@
+# @commercejs/platform
+
+The built-in CommerceJS commerce engine — a fully functional eCommerce backend powered by SQLite. Zero external APIs, zero configuration, batteries included.
+
+## When to Use
+
+- **Development and testing** — instant local commerce backend without external services
+- **Prototyping** — build and demo storefronts with real data flows
+- **Embedded commerce** — self-contained eCommerce for desktop apps, edge deployments, or single-tenant setups
+- **Reference implementation** — see how a `CommerceAdapter` is built end-to-end
+
+## Installation
+
+```bash
+pnpm add @commercejs/platform @commercejs/types
+```
+
+## Quick Start
+
+```typescript
+import { initDatabase, createPlatformAdapter, seedDrizzle } from '@commercejs/platform'
+
+// 1. Initialize the database (auto-creates all tables)
+initDatabase({ driver: 'drizzle' })
+
+// 2. Optionally seed with demo data
+seedDrizzle()
+
+// 3. Create the adapter
+const adapter = createPlatformAdapter({ currency: 'SAR' })
+
+// 4. Use it — same interface as any CommerceAdapter
+const products = await adapter.getProducts({ limit: 10 })
+const cart = await adapter.createCart()
+const brands = await adapter.getBrands()
+const summary = await adapter.getReviewSummary('prod-1')
+```
+
+### With the orchestration engine
+
+```typescript
+import { createCommerce } from '@commercejs/core'
+import { initDatabase, createPlatformAdapter, seedDrizzle } from '@commercejs/platform'
+
+initDatabase({ driver: 'drizzle' })
+seedDrizzle()
+
+const commerce = createCommerce({
+  adapter: createPlatformAdapter({ currency: 'SAR' }),
+})
+
+const products = await commerce.getProducts({ query: 'shirt' })
+```
+
+## Implemented Domains
+
+| Domain | Methods | Status |
+|---|---|---|
+| **Catalog** | `getProduct`, `getProducts`, `getCategories` | ✅ |
+| **Cart** | `createCart`, `getCart`, `addToCart`, `updateCartItem`, `removeFromCart`, `applyCoupon`, `removeCoupon` | ✅ |
+| **Checkout** | `getShippingMethods`, `setShippingAddress`, `setBillingAddress`, `setShippingMethod`, `getPaymentMethods`, `setPaymentMethod`, `placeOrder` | ✅ |
+| **Orders** | `createOrder`, `getOrder`, `getCustomerOrders`, `getOrderStatuses`, `updateOrderStatus`, `cancelOrder`, `duplicateOrder`, `getOrderHistory` | ✅ |
+| **Customers** | `login`, `register`, `getCustomer`, `updateCustomer`, `logout`, `forgotPassword`, `resetPassword`, `getAddresses`, `addAddress`, `updateAddress`, `deleteAddress` | ✅ |
+| **Store** | `getStoreInfo` | ✅ |
+| **Brands** | `getBrands` | ✅ |
+| **Countries** | `getCountries` | ✅ |
+| **Wishlist** | `getWishlist`, `addToWishlist`, `removeFromWishlist` | ✅ |
+| **Reviews** | `getProductReviews`, `getReviewSummary`, `submitReview` | ✅ |
+| **Promotions** | `getActivePromotions`, `validateCoupon` | ✅ |
+| **Returns** | `createReturn`, `getReturn`, `getReturns`, `getOrderReturns`, `cancelReturn` | ✅ |
+
+### Not Yet Implemented
+
+These domains throw `NOT_SUPPORTED` errors:
+
+`wholesale` · `auctions` · `rentals` · `gift-cards` · `locations`
+
+## Database Drivers
+
+The platform supports two database drivers, both backed by SQLite:
+
+| Driver | ORM | Best For |
+|---|---|---|
+| `drizzle` (default) | Drizzle ORM | Lightweight, zero-codegen, fast startup |
+| `prisma` | Prisma Client | Teams already using Prisma, migration tooling |
+
+```typescript
+// Drizzle (default) — synchronous, file-based
+initDatabase({ driver: 'drizzle' })
+
+// Prisma — async, requires prisma generate
+await initDatabase({ driver: 'prisma' })
+```
+
+Both drivers share identical query interfaces and produce identical results — the test suite runs against both.
+
+## Seed Data
+
+The `seedDrizzle()` and `seedPrisma()` functions populate the database with demo data:
+
+| Data | Records |
+|---|---|
+| Store info | 1 (CommerceJS Demo Store, SAR, en/ar) |
+| Categories | 3 (Clothing, Electronics, Accessories) |
+| Products | 3 (T-Shirt, Earbuds, Leather Bag) |
+| Product images | 3 |
+| Product variants | 3 (S/M/L for T-Shirt) |
+| Brands | 3 (CommerceJS Essentials, TechWave, Artisan Leather) |
+| Countries | 6 (SA, AE, KW, BH, OM, QA) |
+| Reviews | 6 (across all 3 products, ratings 3–5) |
+
+## Architecture
+
+```
+platform/
+├── src/
+│   ├── adapter.ts              # createPlatformAdapter() entry point
+│   ├── domains/                # Domain implementations
+│   │   ├── catalog.ts          # Products, categories, search
+│   │   ├── cart.ts             # Cart CRUD, coupon application
+│   │   ├── checkout.ts         # Shipping, payment, order placement
+│   │   ├── orders.ts           # Order management and status
+│   │   ├── customers.ts        # Auth, profiles, addresses
+│   │   ├── store.ts            # Store metadata
+│   │   ├── brands.ts           # Brand listing
+│   │   ├── countries.ts        # Country listing
+│   │   ├── wishlist.ts         # Favorites
+│   │   ├── reviews.ts          # Ratings and reviews
+│   │   ├── promotions.ts       # Discounts and coupons
+│   │   ├── returns.ts          # Return requests
+│   │   └── not-supported.ts    # Stub domains (501)
+│   ├── database/
+│   │   ├── drizzle/            # Drizzle ORM driver
+│   │   │   ├── schema/         # Table definitions
+│   │   │   ├── queries/        # Query functions
+│   │   │   ├── migrate.ts      # Auto-migration
+│   │   │   └── seed.ts         # Demo data
+│   │   └── prisma/             # Prisma driver (mirrors Drizzle)
+│   └── __tests__/              # Test suite (runs against both drivers)
+```
+
+## Testing
+
+```bash
+# Run all platform tests
+pnpm vitest run
+
+# Watch mode
+pnpm vitest
+```
+
+The test suite runs 46 tests against each driver (92 total), covering all implemented domains including seed data validation, CRUD operations, pagination, and error handling.
+
+## License
+
+[MIT](../../LICENSE)

package/dist/__tests__/platform.drizzle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform.drizzle.test.d.ts.map

package/dist/__tests__/platform.drizzle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.drizzle.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/platform.drizzle.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/platform.drizzle.test.js

@@ -0,0 +1,27 @@
+// ---------------------------------------------------------------------------
+// @commercejs/platform — Drizzle driver tests
+// ---------------------------------------------------------------------------
+import { vi } from 'vitest';
+// Mock the barrel to directly use Drizzle queries
+vi.mock('../database/index.js', async () => {
+    return await import('../database/drizzle/queries/index.js');
+});
+import { describe } from 'vitest';
+import { initDrizzle } from '../database/drizzle/client.js';
+import { migrateDrizzle } from '../database/drizzle/migrate.js';
+import { seedDrizzle } from '../database/drizzle/seed.js';
+import { platformTestSuite } from './platform.suite.js';
+describe('@commercejs/platform [drizzle]', () => {
+    platformTestSuite({
+        setup: () => {
+            const db = initDrizzle(':memory:');
+            migrateDrizzle(db);
+            seedDrizzle(db);
+        },
+        setupEmpty: () => {
+            const db = initDrizzle(':memory:');
+            migrateDrizzle(db);
+        },
+    });
+});
+//# sourceMappingURL=platform.drizzle.test.js.map

package/dist/__tests__/platform.drizzle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.drizzle.test.js","sourceRoot":"","sources":["../../src/__tests__/platform.drizzle.test.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE3B,kDAAkD;AAClD,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IACzC,OAAO,MAAM,MAAM,CAAC,sCAAsC,CAAC,CAAA;AAC7D,CAAC,CAAC,CAAA;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,iBAAiB,CAAC;QAChB,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;YAClC,cAAc,CAAC,EAAE,CAAC,CAAA;YAClB,WAAW,CAAC,EAAE,CAAC,CAAA;QACjB,CAAC;QACD,UAAU,EAAE,GAAG,EAAE;YACf,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;YAClC,cAAc,CAAC,EAAE,CAAC,CAAA;QACpB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/platform.prisma.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform.prisma.test.d.ts.map

package/dist/__tests__/platform.prisma.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.prisma.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/platform.prisma.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/platform.prisma.test.js

@@ -0,0 +1,27 @@
+// ---------------------------------------------------------------------------
+// @commercejs/platform — Prisma driver tests
+// ---------------------------------------------------------------------------
+import { vi } from 'vitest';
+// Mock the barrel to directly use Prisma queries
+vi.mock('../database/index.js', async () => {
+    return await import('../database/prisma/queries/index.js');
+});
+import { describe } from 'vitest';
+import { initPrisma } from '../database/prisma/client.js';
+import { migratePrisma } from '../database/prisma/migrate.js';
+import { seedPrisma } from '../database/prisma/seed.js';
+import { platformTestSuite } from './platform.suite.js';
+describe('@commercejs/platform [prisma]', () => {
+    platformTestSuite({
+        setup: async () => {
+            initPrisma(':memory:');
+            await migratePrisma();
+            await seedPrisma();
+        },
+        setupEmpty: async () => {
+            initPrisma(':memory:');
+            await migratePrisma();
+        },
+    });
+});
+//# sourceMappingURL=platform.prisma.test.js.map

package/dist/__tests__/platform.prisma.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.prisma.test.js","sourceRoot":"","sources":["../../src/__tests__/platform.prisma.test.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE3B,iDAAiD;AACjD,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IACzC,OAAO,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,iBAAiB,CAAC;QAChB,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,UAAU,CAAC,UAAU,CAAC,CAAA;YACtB,MAAM,aAAa,EAAE,CAAA;YACrB,MAAM,UAAU,EAAE,CAAA;QACpB,CAAC;QACD,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,UAAU,CAAC,UAAU,CAAC,CAAA;YACtB,MAAM,aAAa,EAAE,CAAA;QACvB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/platform.suite.d.ts

@@ -0,0 +1,8 @@
+export interface SuiteOptions {
+    /** Called in beforeEach to init the DB, migrate, and seed */
+    setup: () => void | Promise<void>;
+    /** Called in beforeEach (without seed) for auto-seed tests */
+    setupEmpty: () => void | Promise<void>;
+}
+export declare function platformTestSuite(opts: SuiteOptions): void;
+//# sourceMappingURL=platform.suite.d.ts.map

package/dist/__tests__/platform.suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.suite.d.ts","sourceRoot":"","sources":["../../src/__tests__/platform.suite.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,QAqcnD"}

package/dist/__tests__/platform.suite.js

@@ -0,0 +1,406 @@
+// ---------------------------------------------------------------------------
+// @commercejs/platform — shared test suite
+// ---------------------------------------------------------------------------
+// All adapter tests. Each driver test file calls this with its own setup.
+import { it, expect, beforeEach } from 'vitest';
+import { createPlatformAdapter } from '../adapter.js';
+/** Helper: create a full Address with all required fields */
+function fullAddress(overrides = {}) {
+    return {
+        firstName: 'Ali',
+        lastName: 'Ahmed',
+        phone: null,
+        street: '123 King Fahd Road',
+        street2: null,
+        city: 'Riyadh',
+        state: null,
+        country: 'SA',
+        postalCode: '12345',
+        district: null,
+        nationalAddress: null,
+        additionalNumber: null,
+        ...overrides,
+    };
+}
+export function platformTestSuite(opts) {
+    let adapter;
+    beforeEach(async () => {
+        await opts.setup();
+        adapter = createPlatformAdapter();
+    });
+    // ---- Catalog ----
+    it('should list seeded products', async () => {
+        const result = await adapter.getProducts({ page: 1, perPage: 10 });
+        expect(result.products.items.length).toBe(3);
+        expect(result.products.total).toBe(3);
+    });
+    it('should get a product by id', async () => {
+        const result = await adapter.getProducts({ page: 1, perPage: 1 });
+        const product = await adapter.getProduct({ id: result.products.items[0].id });
+        expect(product.name.en).toBeTruthy();
+    });
+    it('should get a product by slug', async () => {
+        const product = await adapter.getProduct({ slug: 'premium-cotton-t-shirt' });
+        expect(product.id).toBe('prod-1');
+    });
+    it('should include product variants', async () => {
+        const product = await adapter.getProduct({ id: 'prod-1' });
+        expect(product.variants?.length).toBeGreaterThan(0);
+    });
+    it('should include product images', async () => {
+        const product = await adapter.getProduct({ id: 'prod-1' });
+        expect(product.gallery?.length).toBeGreaterThan(0);
+    });
+    it('should search products by query', async () => {
+        const result = await adapter.getProducts({ query: 'cotton', page: 1, perPage: 10 });
+        expect(result.products.items.length).toBe(1);
+        expect(result.products.items[0].slug).toBe('premium-cotton-t-shirt');
+    });
+    it('should filter by category', async () => {
+        const result = await adapter.getProducts({ categoryId: 'cat-clothing', page: 1, perPage: 10 });
+        expect(result.products.items.length).toBe(1);
+    });
+    it('should paginate', async () => {
+        const page1 = await adapter.getProducts({ page: 1, perPage: 2 });
+        const page2 = await adapter.getProducts({ page: 2, perPage: 2 });
+        expect(page1.products.items.length).toBe(2);
+        expect(page2.products.items.length).toBe(1);
+    });
+    it('should sort by price', async () => {
+        const result = await adapter.getProducts({ page: 1, perPage: 10, sort: { field: 'price', direction: 'asc' } });
+        const prices = result.products.items.map((p) => p.price.amount);
+        expect(prices).toEqual([...prices].sort((a, b) => a - b));
+    });
+    it('should list categories', async () => {
+        const categories = await adapter.getCategories({});
+        expect(categories.length).toBe(3);
+    });
+    it('should throw for missing product', async () => {
+        await expect(adapter.getProduct({ id: 'does-not-exist' })).rejects.toThrow();
+    });
+    // ---- Cart ----
+    it('should create an empty cart', async () => {
+        const cart = await adapter.createCart();
+        expect(cart.id).toBeTruthy();
+        expect(cart.items).toHaveLength(0);
+        expect(cart.totals.subtotal.amount).toBe(0);
+    });
+    it('should add item to cart', async () => {
+        const cart = await adapter.createCart();
+        const updatedCart = await adapter.addToCart(cart.id, { productId: 'prod-1', quantity: 2 });
+        expect(updatedCart.items).toHaveLength(1);
+        expect(updatedCart.items[0].quantity).toBe(2);
+        expect(updatedCart.totals.subtotal.amount).toBeGreaterThan(0);
+    });
+    it('should deduplicate items on add', async () => {
+        const cart = await adapter.createCart();
+        await adapter.addToCart(cart.id, { productId: 'prod-1', quantity: 1 });
+        const updatedCart = await adapter.addToCart(cart.id, { productId: 'prod-1', quantity: 3 });
+        expect(updatedCart.items).toHaveLength(1);
+        expect(updatedCart.items[0].quantity).toBe(4);
+    });
+    it('should update cart item quantity', async () => {
+        const cart = await adapter.createCart();
+        const added = await adapter.addToCart(cart.id, { productId: 'prod-1', quantity: 1 });
+        const updatedCart = await adapter.updateCartItem(cart.id, added.items[0].id, 5);
+        expect(updatedCart.items[0].quantity).toBe(5);
+    });
+    it('should remove cart item', async () => {
+        const cart = await adapter.createCart();
+        const added = await adapter.addToCart(cart.id, { productId: 'prod-1', quantity: 1 });
+        const updatedCart = await adapter.removeFromCart(cart.id, added.items[0].id);
+        expect(updatedCart.items).toHaveLength(0);
+    });
+    it('should apply and remove coupon', async () => {
+        const cart = await adapter.createCart();
+        const withCoupon = await adapter.applyCoupon(cart.id, 'SAVE10');
+        expect(withCoupon.couponCode).toBe('SAVE10');
+        const noCoupon = await adapter.removeCoupon(cart.id);
+        expect(noCoupon.couponCode).toBeNull();
+    });
+    it('should use variant price when variant is specified', async () => {
+        const product = await adapter.getProduct({ id: 'prod-1' });
+        const variant = product.variants?.find((v) => v.name?.en === 'Large');
+        expect(variant).toBeTruthy();
+        const cart = await adapter.createCart();
+        const updatedCart = await adapter.addToCart(cart.id, {
+            productId: 'prod-1',
+            variantId: variant.id,
+            quantity: 1,
+        });
+        expect(updatedCart.items[0].price.amount).toBe(variant.price.amount);
+    });
+    // ---- Checkout ----
+    it('should list shipping methods', async () => {
+        const methods = await adapter.getShippingMethods('dummy-cart');
+        expect(methods.length).toBeGreaterThan(0);
+    });
+    it('should list payment methods', async () => {
+        const methods = await adapter.getPaymentMethods('dummy-cart');
+        expect(methods.length).toBeGreaterThan(0);
+    });
+    it('should set shipping address', async () => {
+        const cart = await adapter.createCart();
+        const updatedCart = await adapter.setShippingAddress(cart.id, fullAddress());
+        expect(updatedCart.id).toBe(cart.id);
+    });
+    it('should place an order from cart', async () => {
+        const cart = await adapter.createCart();
+        await adapter.addToCart(cart.id, { productId: 'prod-2', quantity: 1 });
+        await adapter.setShippingAddress(cart.id, fullAddress());
+        const order = await adapter.placeOrder(cart.id);
+        expect(order.id).toBeTruthy();
+        expect(order.orderNumber).toBeTruthy();
+        expect(order.status).toBe('pending');
+        expect(order.items.length).toBe(1);
+        expect(order.totals.total.amount).toBeGreaterThan(0);
+    });
+    it('should reject placing order with empty cart', async () => {
+        const cart = await adapter.createCart();
+        await expect(adapter.placeOrder(cart.id)).rejects.toThrow();
+    });
+    // ---- Orders ----
+    it('should create an order directly', async () => {
+        const order = await adapter.createOrder({
+            items: [{ productId: 'prod-1', quantity: 2, unitPrice: { amount: 100, currency: 'SAR', formatted: '100 SAR' } }],
+            shippingAddress: fullAddress(),
+        });
+        expect(order.id).toBeTruthy();
+        expect(order.status).toBe('pending');
+    });
+    it('should get an order by id', async () => {
+        const created = await adapter.createOrder({
+            items: [{ productId: 'prod-1', quantity: 1, unitPrice: { amount: 100, currency: 'SAR', formatted: '100 SAR' } }],
+            shippingAddress: fullAddress(),
+        });
+        const order = await adapter.getOrder(created.id);
+        expect(order.id).toBe(created.id);
+    });
+    it('should list order statuses', async () => {
+        const statuses = await adapter.getOrderStatuses();
+        expect(statuses.length).toBeGreaterThan(0);
+        expect(statuses.find((s) => s.id === 'pending')).toBeTruthy();
+    });
+    it('should update order status', async () => {
+        const order = await adapter.createOrder({
+            items: [{ productId: 'prod-1', quantity: 1, unitPrice: { amount: 100, currency: 'SAR', formatted: '100 SAR' } }],
+            shippingAddress: fullAddress(),
+        });
+        await adapter.updateOrderStatus(order.id, { status: 'processing' });
+        const updated = await adapter.getOrder(order.id);
+        expect(updated.status).toBe('processing');
+    });
+    it('should track order history', async () => {
+        const order = await adapter.createOrder({
+            items: [{ productId: 'prod-1', quantity: 1, unitPrice: { amount: 100, currency: 'SAR', formatted: '100 SAR' } }],
+            shippingAddress: fullAddress(),
+        });
+        await adapter.updateOrderStatus(order.id, { status: 'processing' });
+        const history = await adapter.getOrderHistory(order.id);
+        expect(history.length).toBeGreaterThanOrEqual(2);
+    });
+    it('should cancel an order', async () => {
+        const order = await adapter.createOrder({
+            items: [{ productId: 'prod-1', quantity: 1, unitPrice: { amount: 100, currency: 'SAR', formatted: '100 SAR' } }],
+            shippingAddress: fullAddress(),
+        });
+        await adapter.cancelOrder(order.id, 'Changed my mind');
+        const cancelled = await adapter.getOrder(order.id);
+        expect(cancelled.status).toBe('cancelled');
+    });
+    it('should duplicate an order', async () => {
+        const order = await adapter.createOrder({
+            items: [{ productId: 'prod-1', quantity: 2, unitPrice: { amount: 100, currency: 'SAR', formatted: '100 SAR' } }],
+            shippingAddress: fullAddress(),
+        });
+        const dup = await adapter.duplicateOrder(order.id);
+        expect(dup.id).not.toBe(order.id);
+        expect(dup.items.length).toBe(order.items.length);
+    });
+    // ---- Store ----
+    it('should return store info', async () => {
+        const info = await adapter.getStoreInfo();
+        expect(info.name.en).toBeTruthy();
+        expect(info.currencies.length).toBeGreaterThan(0);
+        expect(info.locales.length).toBeGreaterThan(0);
+        expect(info.country).toBe('SA');
+    });
+    it('should auto-seed default store info when none exists', async () => {
+        // Create fresh DB without seed
+        await opts.setupEmpty();
+        const freshAdapter = createPlatformAdapter();
+        const info = await freshAdapter.getStoreInfo();
+        expect(info.name.en).toBe('My Store');
+    });
+    // ---- Customers ----
+    it('should register a new customer', async () => {
+        const customer = await adapter.register({
+            email: 'test@example.com',
+            password: 'Password123!',
+            firstName: 'Test',
+            lastName: 'User',
+        });
+        expect(customer.email).toBe('test@example.com');
+        expect(customer.firstName).toBe('Test');
+        expect(customer.id).toBeTruthy();
+    });
+    it('should login an existing customer', async () => {
+        await adapter.register({
+            email: 'login@example.com',
+            password: 'Password123!',
+            firstName: 'Login',
+            lastName: 'User',
+        });
+        const customer = await adapter.login('login@example.com', 'Password123!');
+        expect(customer.email).toBe('login@example.com');
+    });
+    it('should reject invalid credentials', async () => {
+        await adapter.register({
+            email: 'wrong@example.com',
+            password: 'Password123!',
+            firstName: 'Wrong',
+            lastName: 'User',
+        });
+        await expect(adapter.login('wrong@example.com', 'WrongPassword!')).rejects.toThrow();
+    });
+    it('should reject duplicate registration', async () => {
+        await adapter.register({
+            email: 'dup@example.com',
+            password: 'Password123!',
+            firstName: 'Dup',
+            lastName: 'User',
+        });
+        await expect(adapter.register({
+            email: 'dup@example.com',
+            password: 'Password123!',
+            firstName: 'Dup2',
+            lastName: 'User2',
+        })).rejects.toThrow();
+    });
+    it('should manage addresses', async () => {
+        await adapter.register({
+            email: 'addr@example.com',
+            password: 'Password123!',
+            firstName: 'Addr',
+            lastName: 'User',
+        });
+        // Login so the domain tracks currentCustomerId
+        await adapter.login('addr@example.com', 'Password123!');
+        // Add
+        const addr = await adapter.addAddress(fullAddress());
+        expect(addr.id).toBeTruthy();
+        expect(addr.city).toBe('Riyadh');
+        // List
+        const list = await adapter.getAddresses();
+        expect(list.length).toBe(1);
+        // Update
+        const updated = await adapter.updateAddress(addr.id, { city: 'Jeddah' });
+        expect(updated.city).toBe('Jeddah');
+        // Delete
+        await adapter.deleteAddress(addr.id);
+        const afterDelete = await adapter.getAddresses();
+        expect(afterDelete.length).toBe(0);
+    });
+    // ---- Not-supported domains ----
+    // ---- Promotions ----
+    it('should return empty promotions list', async () => {
+        const promos = await adapter.getActivePromotions();
+        expect(Array.isArray(promos)).toBe(true);
+        expect(promos.length).toBe(0);
+    });
+    it('should return null for unknown coupon', async () => {
+        const coupon = await adapter.validateCoupon('FAKE');
+        expect(coupon).toBeNull();
+    });
+    // ---- Returns ----
+    it('should return empty returns list', async () => {
+        const result = await adapter.getReturns();
+        expect(result.items.length).toBe(0);
+        expect(result.total).toBe(0);
+    });
+    // ---- Reviews ----
+    it('should submit and retrieve reviews', async () => {
+        const review = await adapter.submitReview({
+            productId: 'prod-1',
+            authorName: 'Ali',
+            rating: 5,
+            title: 'Great product',
+            body: 'Really liked it',
+        });
+        expect(review.rating).toBe(5);
+        expect(review.authorName).toBe('Ali');
+        const result = await adapter.getProductReviews('prod-1');
+        // 3 seeded reviews + 1 submitted
+        expect(result.items.length).toBe(4);
+        expect(result.total).toBe(4);
+        const summary = await adapter.getReviewSummary('prod-1');
+        // (5+4+5+5)/4 = 4.75 → 4.8
+        expect(summary.averageRating).toBe(4.8);
+        expect(summary.totalCount).toBe(4);
+        // distribution[4] (5-star) should be 3 (Ahmed, Omar, Ali), distribution[3] (4-star) = 1 (Sara)
+        expect(summary.distribution[4]).toBe(3);
+        expect(summary.distribution[3]).toBe(1);
+    });
+    // ---- Wishlist ----
+    it('should add and remove wishlist items', async () => {
+        // Register and login
+        await adapter.register({
+            email: 'wish@example.com',
+            password: 'Password123!',
+            firstName: 'Wish',
+            lastName: 'User',
+        });
+        const customer = await adapter.login('wish@example.com', 'Password123!');
+        // Get wishlist (auto-created, empty)
+        const wl = await adapter.getWishlist(customer.id);
+        expect(wl.items).toHaveLength(0);
+        expect(wl.itemCount).toBe(0);
+        // Add item
+        const updated = await adapter.addToWishlist('prod-1', undefined, customer.id);
+        expect(updated.items).toHaveLength(1);
+        expect(updated.itemCount).toBe(1);
+        // Dedup — adding same product again should not duplicate
+        const dedup = await adapter.addToWishlist('prod-1', undefined, customer.id);
+        expect(dedup.items).toHaveLength(1);
+        // Remove
+        const removed = await adapter.removeFromWishlist('prod-1', customer.id);
+        expect(removed.items).toHaveLength(0);
+    });
+    // ---- Brands ----
+    it('should return seeded brands', async () => {
+        const brands = await adapter.getBrands();
+        expect(Array.isArray(brands)).toBe(true);
+        expect(brands.length).toBe(3);
+        const names = brands.map((b) => b.name.en);
+        expect(names).toContain('CommerceJS Essentials');
+        expect(names).toContain('TechWave');
+        expect(names).toContain('Artisan Leather');
+    });
+    // ---- Countries ----
+    it('should return seeded countries', async () => {
+        const countries = await adapter.getCountries();
+        expect(Array.isArray(countries)).toBe(true);
+        expect(countries.length).toBe(6);
+        const codes = countries.map((c) => c.code);
+        expect(codes).toContain('SA');
+        expect(codes).toContain('AE');
+        expect(codes).toContain('KW');
+    });
+    // ---- Capabilities ----
+    it('should report supported domains', async () => {
+        const caps = adapter.capabilities;
+        expect(caps).toContain('catalog');
+        expect(caps).toContain('cart');
+        expect(caps).toContain('checkout');
+        expect(caps).toContain('brands');
+        expect(caps).toContain('countries');
+        expect(caps).toContain('wishlist');
+        expect(caps).toContain('reviews');
+        expect(caps).toContain('promotions');
+        expect(caps).toContain('returns');
+    });
+    it('should have correct adapter name', async () => {
+        expect(adapter.name).toBe('commercejs');
+    });
+}
+//# sourceMappingURL=platform.suite.js.map