@fayz-ai/shop 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,345 @@
+export type ProductStatus = 'draft' | 'active' | 'archived';
+export interface Product {
+    id: string;
+    tenantId: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    price: number;
+    compareAtPrice: number | null;
+    currency: string;
+    status: ProductStatus;
+    inventoryCount: number;
+    sku: string | null;
+    sortOrder: number;
+    metadata: Record<string, unknown>;
+    images: ProductImage[];
+    categoryId: string | null;
+    categoryName: string | null;
+    isPhysical: boolean;
+    weight: number | null;
+    weightUnit: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ProductImage {
+    id: string;
+    productId: string;
+    url: string;
+    altText: string | null;
+    sortOrder: number;
+    isPrimary: boolean;
+    createdAt: string;
+}
+export interface CreateProductInput {
+    name: string;
+    slug?: string;
+    description?: string;
+    price: number;
+    compareAtPrice?: number;
+    currency?: string;
+    status?: ProductStatus;
+    inventoryCount?: number;
+    sku?: string;
+    sortOrder?: number;
+    metadata?: Record<string, unknown>;
+    categoryId?: string;
+    isPhysical?: boolean;
+    weight?: number;
+    weightUnit?: string;
+}
+export interface UpdateProductInput {
+    name?: string;
+    slug?: string;
+    description?: string;
+    price?: number;
+    compareAtPrice?: number | null;
+    currency?: string;
+    status?: ProductStatus;
+    inventoryCount?: number;
+    sku?: string | null;
+    sortOrder?: number;
+    metadata?: Record<string, unknown>;
+    categoryId?: string | null;
+    isPhysical?: boolean;
+    weight?: number | null;
+    weightUnit?: string;
+}
+export interface ListProductsOptions {
+    status?: ProductStatus;
+    categoryId?: string;
+    search?: string;
+    /** Exact-match slug lookup (storefront product-detail routing) */
+    slug?: string;
+    limit?: number;
+    offset?: number;
+    orderBy?: 'name' | 'price' | 'created_at' | 'sort_order';
+    order?: 'asc' | 'desc';
+}
+export interface Category {
+    id: string;
+    tenantId: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    parentId: string | null;
+    sortOrder: number;
+    /** Showcase image (storefront category tiles). Not yet a shop_categories column. */
+    imageUrl?: string | null;
+    children?: Category[];
+    createdAt: string;
+}
+export interface CreateCategoryInput {
+    name: string;
+    slug?: string;
+    description?: string;
+    parentId?: string;
+    sortOrder?: number;
+}
+export interface UpdateCategoryInput {
+    name?: string;
+    slug?: string;
+    description?: string | null;
+    parentId?: string | null;
+    sortOrder?: number;
+}
+export type OrderStatus = 'open' | 'archived' | 'cancelled';
+export type FinancialStatus = 'pending' | 'paid' | 'partially_paid' | 'refunded' | 'partially_refunded' | 'voided';
+export type FulfillmentStatus = 'unfulfilled' | 'partially_fulfilled' | 'fulfilled';
+export interface Order {
+    id: string;
+    tenantId: string;
+    orderNumber: number;
+    status: OrderStatus;
+    financialStatus: FinancialStatus;
+    fulfillmentStatus: FulfillmentStatus;
+    currency: string;
+    subtotal: number;
+    taxTotal: number;
+    discountTotal: number;
+    shippingTotal: number;
+    total: number;
+    customerId: string | null;
+    customerName: string | null;
+    customerEmail: string | null;
+    discountCode: string | null;
+    notes: string | null;
+    items: OrderItem[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface OrderItem {
+    id: string;
+    orderId: string;
+    productId: string | null;
+    name: string;
+    sku: string | null;
+    quantity: number;
+    unitPrice: number;
+    total: number;
+    imageUrl: string | null;
+}
+export interface CreateOrderInput {
+    customerId?: string;
+    customerName?: string;
+    customerEmail?: string;
+    currency?: string;
+    notes?: string;
+    discountCode?: string;
+    discountTotal?: number;
+    shippingTotal?: number;
+    items: Array<{
+        productId?: string;
+        name: string;
+        sku?: string;
+        quantity: number;
+        unitPrice: number;
+        imageUrl?: string;
+    }>;
+}
+export interface UpdateOrderInput {
+    status?: OrderStatus;
+    financialStatus?: FinancialStatus;
+    fulfillmentStatus?: FulfillmentStatus;
+    notes?: string;
+}
+export interface ListOrdersOptions {
+    status?: OrderStatus;
+    financialStatus?: FinancialStatus;
+    fulfillmentStatus?: FulfillmentStatus;
+    customerId?: string;
+    customerEmail?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * A single line in a trusted order-placement request. Carries NO price — the
+ * server re-reads the product price from the catalog so the browser can never
+ * set what it pays.
+ */
+export interface PlaceOrderLine {
+    productId: string;
+    quantity: number;
+    /** Variant/options label appended to the stored item name (display only). */
+    optionsLabel?: string;
+}
+/**
+ * Input for {@link ShopProvider.placeOrder} — the only trusted path to create a
+ * storefront order. Prices, discount math, and inventory are resolved
+ * server-side; the client supplies product ids, quantities, and intent only.
+ */
+export interface PlaceOrderInput {
+    /** Tenant/store id. The Supabase provider falls back to the resolved shop tenant. */
+    tenantId?: string;
+    /** Existing customer id (preferred when the session already resolved one). */
+    customerId?: string;
+    /** Customer identity for find-or-create when {@link PlaceOrderInput.customerId} is absent. */
+    customer?: {
+        name?: string;
+        email?: string;
+    };
+    currency?: string;
+    notes?: string;
+    /** Discount code to validate + apply server-side (never trust a client total). */
+    discountCode?: string;
+    /** Shipping cost from the store's shipping policy. Clamped to >= 0 server-side. */
+    shippingTotal?: number;
+    items: PlaceOrderLine[];
+}
+export interface ShopCustomer {
+    id: string;
+    tenantId: string;
+    firstName: string;
+    lastName: string;
+    email: string | null;
+    phone: string | null;
+    notes: string | null;
+    ordersCount: number;
+    totalSpent: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCustomerInput {
+    firstName: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    notes?: string;
+}
+export interface UpdateCustomerInput {
+    firstName?: string;
+    lastName?: string;
+    email?: string | null;
+    phone?: string | null;
+    notes?: string | null;
+}
+export interface ListCustomersOptions {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Input for {@link ShopProvider.resolveCustomer} — find-or-create a customer by
+ * email and (on Supabase) link it to the authenticated user (auth.uid) so
+ * "my orders" can be enforced by RLS. Runs server-side; the browser never
+ * supplies the auth id.
+ */
+export interface ResolveCustomerInput {
+    email: string;
+    name?: string;
+    /** Tenant/store id. The Supabase provider falls back to the resolved shop tenant. */
+    tenantId?: string;
+}
+export type DiscountType = 'percentage' | 'fixed_amount' | 'free_shipping' | 'buy_x_get_y';
+export type DiscountMethod = 'code' | 'automatic';
+export type DiscountStatus = 'active' | 'expired' | 'scheduled' | 'draft';
+export interface Discount {
+    id: string;
+    tenantId: string;
+    title: string;
+    code: string | null;
+    type: DiscountType;
+    method: DiscountMethod;
+    value: number;
+    usageLimit: number | null;
+    oncePerCustomer: boolean;
+    startsAt: string;
+    endsAt: string | null;
+    status: DiscountStatus;
+    timesUsed: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateDiscountInput {
+    title: string;
+    code?: string;
+    type: DiscountType;
+    method?: DiscountMethod;
+    value: number;
+    usageLimit?: number;
+    oncePerCustomer?: boolean;
+    startsAt?: string;
+    endsAt?: string;
+    status?: DiscountStatus;
+}
+export interface UpdateDiscountInput {
+    title?: string;
+    code?: string | null;
+    type?: DiscountType;
+    method?: DiscountMethod;
+    value?: number;
+    usageLimit?: number | null;
+    oncePerCustomer?: boolean;
+    startsAt?: string;
+    endsAt?: string | null;
+    status?: DiscountStatus;
+}
+export interface ListDiscountsOptions {
+    status?: DiscountStatus;
+    type?: DiscountType;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface DiscountValidation {
+    valid: boolean;
+    code: string | null;
+    type: DiscountType | null;
+    /** Percentage points for 'percentage'; absolute amount for 'fixed_amount'. */
+    value: number;
+    /** Machine-readable reason when invalid: not_found | expired | not_started | usage_limit | unsupported | empty */
+    reason?: string;
+}
+export interface InventoryLine {
+    productId: string;
+    quantity: number;
+}
+export interface InventoryIssue {
+    productId: string;
+    name: string;
+    requested: number;
+    available: number;
+}
+export interface InventoryCheck {
+    ok: boolean;
+    issues: InventoryIssue[];
+}
+export interface CartTotalLine {
+    productId: string;
+    name: string;
+    sku: string | null;
+    unitPrice: number;
+    quantity: number;
+    lineTotal: number;
+}
+export interface CartTotals {
+    lines: CartTotalLine[];
+    subtotal: number;
+    discountTotal: number;
+    discountCode: string | null;
+    taxTotal: number;
+    shippingTotal: number;
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@fayz-ai/shop",
+  "version": "0.2.0",
+  "description": "Fayz SDK ecommerce layer — products, orders, customers, discounts, shipping",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./client": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./admin": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./runtime": {
+      "source": "./src/runtime.ts",
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js",
+      "require": "./dist/runtime.cjs"
+    },
+    "./provider": {
+      "source": "./src/provider.ts",
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js",
+      "require": "./dist/provider.cjs"
+    },
+    "./types": {
+      "source": "./src/types.ts",
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    },
+    "./catalog": {
+      "source": "./src/catalog.ts",
+      "types": "./dist/catalog.d.ts",
+      "import": "./dist/catalog.js",
+      "require": "./dist/catalog.cjs"
+    },
+    "./mock": {
+      "source": "./src/mock.ts",
+      "types": "./dist/mock.d.ts",
+      "import": "./dist/mock.js",
+      "require": "./dist/mock.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "lucide-react": "^0.400.0",
+    "@supabase/supabase-js": "^2.45.0",
+    "zustand": "^4.5.0",
+    "@fayz-ai/ui": "^0.2.0",
+    "@fayz-ai/auth": "^0.2.0",
+    "@fayz-ai/core": "^0.2.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0"
+  },
+  "keywords": [
+    "fayz",
+    "ecommerce",
+    "shop",
+    "supabase"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/catalog.ts

@@ -0,0 +1,3 @@
+export { MOCK_PRODUCTS, MOCK_CATEGORIES, MOCK_DISCOUNTS, svgPlaceholder } from './mock-catalog'
+export { buildMockCatalog } from './mock-catalog'
+export type { CatalogInput, CatalogProductInput, CatalogCategoryInput } from './mock-catalog'

package/src/commerce.ts

@@ -0,0 +1,120 @@
+import { getShopProvider } from './runtime'
+import type { ShopProvider } from './provider'
+import type {
+  CartTotals, DiscountValidation, InventoryCheck, InventoryIssue, InventoryLine, Order,
+} from './types'
+
+// ---------------------------------------------------------------------------
+// Commerce primitive APIs (FAY-1193)
+//
+// Provider-agnostic helpers that custom app workflows call instead of re-deriving
+// discount/inventory/total logic. They take an explicit ShopProvider (default:
+// the configured runtime provider) so they work the same against mock or Supabase.
+//
+// NOTE: when run in the browser these compute the *advisory* answer (UI preview).
+// The authoritative values are recomputed server-side in the shop_place_order RPC
+// — the browser can never set what it pays.
+// ---------------------------------------------------------------------------
+
+function round2(n: number): number {
+  return Math.round(n * 100) / 100
+}
+
+/** Validate a discount code against the provider: existence, status, date window, usage limit, supported type. */
+export async function validateDiscount(
+  input: { code: string; subtotal?: number; customerId?: string },
+  provider: ShopProvider = getShopProvider(),
+): Promise<DiscountValidation> {
+  const code = input.code.trim()
+  if (!code) return { valid: false, code: null, type: null, value: 0, reason: 'empty' }
+
+  const list = await provider.listDiscounts({ status: 'active' })
+  const discount = list.find((d) => (d.code ?? '').toUpperCase() === code.toUpperCase())
+  if (!discount) return { valid: false, code: null, type: null, value: 0, reason: 'not_found' }
+
+  const now = new Date().toISOString()
+  if (discount.startsAt > now) return { valid: false, code: discount.code, type: discount.type, value: 0, reason: 'not_started' }
+  if (discount.endsAt && discount.endsAt < now) return { valid: false, code: discount.code, type: discount.type, value: 0, reason: 'expired' }
+  if (discount.usageLimit != null && discount.timesUsed >= discount.usageLimit) {
+    return { valid: false, code: discount.code, type: discount.type, value: 0, reason: 'usage_limit' }
+  }
+  if (discount.type !== 'percentage' && discount.type !== 'fixed_amount') {
+    return { valid: false, code: discount.code, type: discount.type, value: 0, reason: 'unsupported' }
+  }
+  return { valid: true, code: discount.code, type: discount.type, value: discount.value }
+}
+
+/** Apply a validated discount to a subtotal, clamped to [0, subtotal]. Pure. */
+export function applyDiscount(validation: DiscountValidation, subtotal: number): { discountTotal: number; code: string | null } {
+  if (!validation.valid) return { discountTotal: 0, code: null }
+  if (validation.type === 'percentage') {
+    return { discountTotal: round2(Math.min(subtotal, (subtotal * validation.value) / 100)), code: validation.code }
+  }
+  if (validation.type === 'fixed_amount') {
+    return { discountTotal: round2(Math.min(subtotal, validation.value)), code: validation.code }
+  }
+  return { discountTotal: 0, code: validation.code }
+}
+
+/** Report out-of-stock / unavailable lines against current catalog inventory. No mutation. */
+export async function checkInventory(
+  lines: InventoryLine[],
+  provider: ShopProvider = getShopProvider(),
+): Promise<InventoryCheck> {
+  const issues: InventoryIssue[] = []
+  for (const line of lines) {
+    const product = await provider.getProduct(line.productId)
+    if (!product || product.status !== 'active') {
+      issues.push({ productId: line.productId, name: product?.name ?? line.productId, requested: line.quantity, available: 0 })
+      continue
+    }
+    if (product.inventoryCount < line.quantity) {
+      issues.push({ productId: line.productId, name: product.name, requested: line.quantity, available: product.inventoryCount })
+    }
+  }
+  return { ok: issues.length === 0, issues }
+}
+
+/**
+ * Recompute cart totals from authoritative catalog prices (ignores any client
+ * unitPrice), applying a validated discount and shipping. Tax is 0 in v1 (hook).
+ */
+export async function computeCartTotals(
+  input: { lines: InventoryLine[]; discountCode?: string; customerId?: string; shipping?: number },
+  provider: ShopProvider = getShopProvider(),
+): Promise<CartTotals> {
+  const lines: CartTotals['lines'] = []
+  let subtotal = 0
+  for (const line of input.lines) {
+    const product = await provider.getProduct(line.productId)
+    if (!product) continue
+    const lineTotal = round2(product.price * line.quantity)
+    subtotal += lineTotal
+    lines.push({ productId: product.id, name: product.name, sku: product.sku, unitPrice: product.price, quantity: line.quantity, lineTotal })
+  }
+  subtotal = round2(subtotal)
+
+  let discountTotal = 0
+  let discountCode: string | null = null
+  if (input.discountCode) {
+    const applied = applyDiscount(
+      await validateDiscount({ code: input.discountCode, subtotal, customerId: input.customerId }, provider),
+      subtotal,
+    )
+    discountTotal = applied.discountTotal
+    discountCode = applied.code
+  }
+
+  const shippingTotal = round2(Math.max(input.shipping ?? 0, 0))
+  const taxTotal = 0
+  const total = round2(Math.max(subtotal - discountTotal + shippingTotal + taxTotal, 0))
+  return { lines, subtotal, discountTotal, discountCode, taxTotal, shippingTotal, total }
+}
+
+/** A customer's orders (scoped by id; RLS-enforced to the owner on Supabase). */
+export async function getCustomerOrders(
+  customerId: string,
+  provider: ShopProvider = getShopProvider(),
+): Promise<Order[]> {
+  return provider.listOrders({ customerId, limit: 100 })
+}

package/src/index.ts

@@ -0,0 +1,34 @@
+export type {
+  Product, ProductImage, Category,
+  Order, OrderItem, OrderStatus, FinancialStatus, FulfillmentStatus,
+  ShopCustomer, Discount, DiscountType, DiscountMethod, DiscountStatus,
+  ProductStatus,
+  CreateProductInput, UpdateProductInput, ListProductsOptions,
+  CreateCategoryInput, UpdateCategoryInput,
+  CreateOrderInput, UpdateOrderInput, ListOrdersOptions,
+  CreateCustomerInput, UpdateCustomerInput, ListCustomersOptions, ResolveCustomerInput,
+  CreateDiscountInput, UpdateDiscountInput, ListDiscountsOptions,
+  PlaceOrderInput, PlaceOrderLine,
+  DiscountValidation, InventoryLine, InventoryIssue, InventoryCheck, CartTotalLine, CartTotals,
+} from './types'
+
+export type { ShopProvider } from './provider'
+export {
+  validateDiscount, applyDiscount, checkInventory, computeCartTotals, getCustomerOrders,
+} from './commerce'
+export { SupabaseShopProvider, createSupabaseShopProvider } from './supabase-provider'
+export { MockShopProvider, createMockShopProvider } from './mock-provider'
+export type { MockShopSeed } from './mock-provider'
+export { setShopTenantResolver, getShopTenantId } from './tenant'
+export type { TenantResolver } from './tenant'
+export { getShopProvider, setShopProvider, resetShopProvider } from './runtime'
+
+// Deterministic mock catalog (also useful for seeding real databases and tests)
+export {
+  MOCK_PRODUCTS,
+  MOCK_CATEGORIES,
+  MOCK_DISCOUNTS,
+  svgPlaceholder,
+  buildMockCatalog,
+} from './catalog'
+export type { CatalogInput, CatalogProductInput, CatalogCategoryInput } from './catalog'