@meeovi/layer-commerce 1.0.0

package/README.md

@@ -0,0 +1,66 @@
+# @meeovi/commerce
+
+A backend‑agnostic commerce domain module for the Meeovi ecosystem.  
+This package provides a unified interface for products, categories, carts, and other commerce operations — regardless of the underlying backend (Directus, Medusa, Shopify, custom APIs, etc.).
+
+## ✨ Features
+
+- Pluggable provider architecture  
+- Unified composables (`useProducts`, `useCart`, `useCategories`)  
+- Backend‑agnostic types  
+- Runtime configuration  
+- Zero Nuxt dependency  
+- Works in any JS/TS environment  
+
+## 📦 Installation
+
+```sh
+npm install @meeovi/commerce
+
+⚙️ Configuration
+Configure the active providers at runtime:
+
+
+import { setCommerceConfig } from '@meeovi/commerce'
+
+setCommerceConfig({
+  productProvider: 'directus',
+  cartProvider: 'directus',
+  categoryProvider: 'directus'
+})
+
+🧩 Usage
+
+import { useProducts } from '@meeovi/commerce'
+
+const { listProducts, getProduct } = useProducts()
+
+const products = await listProducts()
+const product = await getProduct('123')
+🔌 Providers
+A provider implements one or more domain interfaces:
+
+
+export interface ProductProvider {
+  getProduct(id: string): Promise<Product>
+  listProducts(params?: any): Promise<Product[]>
+}
+Register a provider:
+
+
+import { registerProductProvider } from '@meeovi/commerce'
+
+registerProductProvider('directus', {
+  getProduct: async (id) => { ... },
+  listProducts: async () => { ... }
+})
+
+🧱 Folder Structure
+Code
+src/
+  products/
+  cart/
+  categories/
+  config.
+  registry.
+  useCommerce.

package/dist/app/composables/cart/registry.d.ts

@@ -0,0 +1,3 @@
+import { CartProvider } from "./types";
+export declare function registerCartProvider(name: string, provider: CartProvider): void;
+export declare function getCartProvider(name: string): CartProvider;

package/dist/app/composables/cart/registry.js

@@ -0,0 +1,10 @@
+const providers = {};
+export function registerCartProvider(name, provider) {
+    providers[name] = provider;
+}
+export function getCartProvider(name) {
+    const provider = providers[name];
+    if (!provider)
+        throw new Error(`Cart provider "${name}" not found`);
+    return provider;
+}

package/dist/app/composables/cart/types.d.ts

@@ -0,0 +1,16 @@
+export interface CartItem {
+    id: string;
+    quantity: number;
+    product: any;
+}
+export interface Cart {
+    id: string;
+    items: CartItem[];
+    total: number;
+}
+export interface CartProvider {
+    getCart(): Promise<Cart>;
+    addItem(productId: string, quantity?: number): Promise<Cart>;
+    removeItem(productId: string): Promise<Cart>;
+    clearCart(): Promise<Cart>;
+}

package/dist/app/composables/cart/types.js

@@ -0,0 +1 @@
+export {};

package/dist/app/composables/cart/useCart.d.ts

@@ -0,0 +1,6 @@
+export declare function useCart(): {
+    getCart: () => Promise<import("./types").Cart>;
+    addItem: (productId: string, quantity?: number) => Promise<import("./types").Cart>;
+    removeItem: (productId: string) => Promise<import("./types").Cart>;
+    clearCart: () => Promise<import("./types").Cart>;
+};

package/dist/app/composables/cart/useCart.js

@@ -0,0 +1,13 @@
+import { getCartProvider } from './registry';
+import { useRuntimeConfig } from '#imports';
+export function useCart() {
+    const config = useRuntimeConfig();
+    const providerName = config.public.cartProvider || 'directus';
+    const provider = getCartProvider(providerName);
+    return {
+        getCart: provider.getCart,
+        addItem: provider.addItem,
+        removeItem: provider.removeItem,
+        clearCart: provider.clearCart
+    };
+}

package/dist/app/composables/config.d.ts

@@ -0,0 +1,7 @@
+export interface CommerceConfig {
+    productProvider: string;
+    cartProvider: string;
+    categoryProvider: string;
+}
+export declare function setCommerceConfig(newConfig: Partial<CommerceConfig>): void;
+export declare function getCommerceConfig(): CommerceConfig;

package/dist/app/composables/config.js

@@ -0,0 +1,11 @@
+let config = {
+    productProvider: 'directus',
+    cartProvider: 'directus',
+    categoryProvider: 'directus'
+};
+export function setCommerceConfig(newConfig) {
+    config = { ...config, ...newConfig };
+}
+export function getCommerceConfig() {
+    return config;
+}

package/dist/app/composables/products/registry.d.ts

@@ -0,0 +1,3 @@
+import { ProductProvider } from "./types";
+export declare function registerProductProvider(name: string, provider: ProductProvider): void;
+export declare function getProductProvider(name: string): ProductProvider;

package/dist/app/composables/products/registry.js

@@ -0,0 +1,10 @@
+const providers = {};
+export function registerProductProvider(name, provider) {
+    providers[name] = provider;
+}
+export function getProductProvider(name) {
+    const provider = providers[name];
+    if (!provider)
+        throw new Error(`Product provider "${name}" not found`);
+    return provider;
+}

package/dist/app/composables/products/types.d.ts

@@ -0,0 +1,12 @@
+export interface Product {
+    id: string;
+    title: string;
+    description?: string;
+    price: number;
+    images: string[];
+    [key: string]: any;
+}
+export interface ProductProvider {
+    getProduct(id: string): Promise<Product>;
+    listProducts(params?: Record<string, any>): Promise<Product[]>;
+}

package/dist/app/composables/products/types.js

@@ -0,0 +1 @@
+export {};

package/dist/app/composables/products/useProducts.d.ts

@@ -0,0 +1,4 @@
+export declare function useProducts(): {
+    getProduct: (id: string) => Promise<import("./types").Product>;
+    listProducts: (params?: Record<string, any>) => Promise<import("./types").Product[]>;
+};

package/dist/app/composables/products/useProducts.js

@@ -0,0 +1,10 @@
+import { getCommerceConfig } from '../config';
+import { getProductProvider } from './registry';
+export function useProducts() {
+    const { productProvider } = getCommerceConfig();
+    const provider = getProductProvider(productProvider);
+    return {
+        getProduct: provider.getProduct,
+        listProducts: provider.listProducts
+    };
+}

package/dist/app/utils/client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns a commerce client. Prefer `@meeovi/commerce` client creation APIs
+ * when available, otherwise fall back to `sdk.commerce`.
+ */
+export declare function getCommerceClient(provider?: string, providerConfig?: any): any;
+export default getCommerceClient;

package/dist/app/utils/client.js

@@ -0,0 +1,23 @@
+import * as CommercePkg from '#imports';
+import { sdk } from '@meeovi/sdk';
+const CommerceAny = CommercePkg;
+/**
+ * Returns a commerce client. Prefer `@meeovi/commerce` client creation APIs
+ * when available, otherwise fall back to `sdk.commerce`.
+ */
+export function getCommerceClient(provider, providerConfig) {
+    try {
+        if (typeof CommerceAny.createClient === 'function') {
+            return CommerceAny.createClient(provider, providerConfig);
+        }
+        if (typeof CommerceAny.init === 'function') {
+            return CommerceAny.init(providerConfig);
+        }
+    }
+    catch (e) {
+        // swallow and fallback to sdk
+    }
+    // fallback: return the SDK's commerce helper (already used in many composables)
+    return sdk.commerce;
+}
+export default getCommerceClient;

package/dist/app/utils/normalizer.d.ts

@@ -0,0 +1,12 @@
+export interface CommerceNormalizer {
+    normalizeProduct(data: any): any;
+    normalizeCategory?(data: any): any;
+    normalizeCart?(data: any): any;
+}
+export declare class NormalizerRegistry {
+    private registry;
+    register(name: string, normalizer: CommerceNormalizer): void;
+    get(name: string): CommerceNormalizer | undefined;
+    list(): string[];
+}
+export default NormalizerRegistry;

package/dist/app/utils/normalizer.js

@@ -0,0 +1,13 @@
+export class NormalizerRegistry {
+    registry = new Map();
+    register(name, normalizer) {
+        this.registry.set(name, normalizer);
+    }
+    get(name) {
+        return this.registry.get(name);
+    }
+    list() {
+        return Array.from(this.registry.keys());
+    }
+}
+export default NormalizerRegistry;

package/dist/app/utils/normalizers/magento.d.ts

@@ -0,0 +1,3 @@
+import { CommerceNormalizer } from "../normalizer";
+export declare const magentoNormalizer: CommerceNormalizer;
+export default magentoNormalizer;

package/dist/app/utils/normalizers/magento.js

@@ -0,0 +1,23 @@
+export const magentoNormalizer = {
+    normalizeProduct(data) {
+        return {
+            id: data?.id ?? data?.sku ?? data?.item_id,
+            title: data?.name ?? data?.title,
+            price: data?.price ?? data?.price_range?.minimum_price?.final_price?.value,
+            description: data?.description ?? data?.short_description,
+            images: (data?.media_gallery_entries ?? []).map((m) => m.file || m.url),
+            raw: data,
+        };
+    },
+    normalizeCategory(data) {
+        return {
+            id: data?.id,
+            name: data?.name,
+            raw: data,
+        };
+    },
+    normalizeCart(data) {
+        return { raw: data };
+    },
+};
+export default magentoNormalizer;

package/dist/app/utils/normalizers/shopify.d.ts

@@ -0,0 +1,3 @@
+import { CommerceNormalizer } from "../normalizer";
+export declare const shopifyNormalizer: CommerceNormalizer;
+export default shopifyNormalizer;

package/dist/app/utils/normalizers/shopify.js

@@ -0,0 +1,24 @@
+export const shopifyNormalizer = {
+    normalizeProduct(data) {
+        // Shopify payloads vary depending on SDK; this maps common fields
+        return {
+            id: data?.id ?? data?.variants?.[0]?.id,
+            title: data?.title ?? data?.name,
+            price: data?.variants?.[0]?.price ?? data?.price,
+            description: data?.body_html ?? data?.description,
+            images: (data?.images ?? []).map((i) => i?.src || i?.url),
+            raw: data,
+        };
+    },
+    normalizeCategory(data) {
+        return {
+            id: data?.id,
+            name: data?.title ?? data?.name,
+            raw: data,
+        };
+    },
+    normalizeCart(data) {
+        return { raw: data };
+    },
+};
+export default shopifyNormalizer;

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns a commerce client. Prefer `@meeovi/commerce` client creation APIs
+ * when available, otherwise fall back to `sdk.commerce`.
+ */
+export declare function getCommerceClient(provider?: string, providerConfig?: any): any;
+export default getCommerceClient;

package/dist/client.js

@@ -0,0 +1,23 @@
+import * as CommercePkg from '@meeovi/commerce';
+import { sdk } from '@meeovi/sdk';
+const CommerceAny = CommercePkg;
+/**
+ * Returns a commerce client. Prefer `@meeovi/commerce` client creation APIs
+ * when available, otherwise fall back to `sdk.commerce`.
+ */
+export function getCommerceClient(provider, providerConfig) {
+    try {
+        if (typeof CommerceAny.createClient === 'function') {
+            return CommerceAny.createClient(provider, providerConfig);
+        }
+        if (typeof CommerceAny.init === 'function') {
+            return CommerceAny.init(providerConfig);
+        }
+    }
+    catch (e) {
+        // swallow and fallback to sdk
+    }
+    // fallback: return the SDK's commerce helper (already used in many composables)
+    return sdk.commerce;
+}
+export default getCommerceClient;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './app/composables/products/types';
+export * from './app/composables/products/registry';
+export * from './app/composables/products/useProducts';
+export * from './app/composables/cart/types';
+export * from './app/composables/cart/registry';
+export * from './app/composables/cart/useCart';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './app/composables/products/types';
+export * from './app/composables/products/registry';
+export * from './app/composables/products/useProducts';
+export * from './app/composables/cart/types';
+export * from './app/composables/cart/registry';
+export * from './app/composables/cart/useCart';

package/dist/normalizer.d.ts

@@ -0,0 +1,12 @@
+export interface CommerceNormalizer {
+    normalizeProduct(data: any): any;
+    normalizeCategory?(data: any): any;
+    normalizeCart?(data: any): any;
+}
+export declare class NormalizerRegistry {
+    private registry;
+    register(name: string, normalizer: CommerceNormalizer): void;
+    get(name: string): CommerceNormalizer | undefined;
+    list(): string[];
+}
+export default NormalizerRegistry;

package/dist/normalizer.js

@@ -0,0 +1,13 @@
+export class NormalizerRegistry {
+    registry = new Map();
+    register(name, normalizer) {
+        this.registry.set(name, normalizer);
+    }
+    get(name) {
+        return this.registry.get(name);
+    }
+    list() {
+        return Array.from(this.registry.keys());
+    }
+}
+export default NormalizerRegistry;

package/dist/normalizers/magento.d.ts

@@ -0,0 +1,3 @@
+import { CommerceNormalizer } from "../normalizer";
+export declare const magentoNormalizer: CommerceNormalizer;
+export default magentoNormalizer;

package/dist/normalizers/magento.js

@@ -0,0 +1,23 @@
+export const magentoNormalizer = {
+    normalizeProduct(data) {
+        return {
+            id: data?.id ?? data?.sku ?? data?.item_id,
+            title: data?.name ?? data?.title,
+            price: data?.price ?? data?.price_range?.minimum_price?.final_price?.value,
+            description: data?.description ?? data?.short_description,
+            images: (data?.media_gallery_entries ?? []).map((m) => m.file || m.url),
+            raw: data,
+        };
+    },
+    normalizeCategory(data) {
+        return {
+            id: data?.id,
+            name: data?.name,
+            raw: data,
+        };
+    },
+    normalizeCart(data) {
+        return { raw: data };
+    },
+};
+export default magentoNormalizer;

package/dist/normalizers/shopify.d.ts

@@ -0,0 +1,3 @@
+import { CommerceNormalizer } from "../normalizer";
+export declare const shopifyNormalizer: CommerceNormalizer;
+export default shopifyNormalizer;

package/dist/normalizers/shopify.js

@@ -0,0 +1,24 @@
+export const shopifyNormalizer = {
+    normalizeProduct(data) {
+        // Shopify payloads vary depending on SDK; this maps common fields
+        return {
+            id: data?.id ?? data?.variants?.[0]?.id,
+            title: data?.title ?? data?.name,
+            price: data?.variants?.[0]?.price ?? data?.price,
+            description: data?.body_html ?? data?.description,
+            images: (data?.images ?? []).map((i) => i?.src || i?.url),
+            raw: data,
+        };
+    },
+    normalizeCategory(data) {
+        return {
+            id: data?.id,
+            name: data?.title ?? data?.name,
+            raw: data,
+        };
+    },
+    normalizeCart(data) {
+        return { raw: data };
+    },
+};
+export default shopifyNormalizer;

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@meeovi/layer-commerce",
+  "version": "1.0.0",
+  "description": "Commerce Layer for the Alternate Framework",
+  "keywords": [
+    "commerce",
+    "alternate-framework",
+    "nuxt",
+    "layer"
+  ],
+  "license": "MIT",
+  "author": "Meeovi",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "test": "vitest",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint 'src/**/*.{ts,tsx}' || true",
+    "clean": "rimraf dist",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "codegen": "npx graphql-codegen --config ./node_modules/@meeovi/adapter-magento/codegen.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@meeovi/types": "^1.0.0"
+  },
+  "dependencies": {
+    "@meeovi/adapter-magento": "^1.0.2",
+    "@meeovi/api": "^1.0.1",
+    "@meeovi/sdk": "^1.0.2",
+    "@meeovi/types": "^1.0.0",
+    "@better-auth/stripe": "^1.4.15",
+    "@meeovi/core": "^1.0.1",
+    "@polar-sh/better-auth": "^1.6.4",
+    "@polar-sh/sdk": "^0.42.2",
+    "@storefront-ui/nuxt": "^3.1.1",
+    "ramda": "^0.32.0",
+    "type-fest": "^5.4.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@types/ramda": "^0.31.1",
+    "@vitest/coverage-v8": "^4.0.17",
+    "jest-cucumber": "^4.5.0",
+    "vitest": "^4.0.17",
+    "@types/node": "^20.0.0",
+    "eslint": "^8.0.0",
+    "nuxt": "^4.2.2",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.8.2"
+  }
+}