@classytic/commerce-sdk 0.1.2 → 0.2.1

package/dist/sales/api/order.d.ts

@@ -0,0 +1,147 @@
+import { BaseApi as BaseApi$1 } from "../../core/api-factory.js";
+import { CreateOrderPayload, FulfillOrderPayload, GuestCheckoutPayload, Order, OrderShipping, RefundOrderPayload, RequestShippingPayload, UpdateShippingPayload, UpdateStatusPayload } from "../types/order.js";
+import * as _classytic_arc_next_api0 from "@classytic/arc-next/api";
+
+//#region src/sales/api/order.d.ts
+declare class OrderApi extends BaseApi$1<Order, CreateOrderPayload, Partial<Order>> {
+  /**
+   * Checkout - create order from cart
+   * POST /api/v1/orders
+   */
+  checkout: ({
+    token,
+    organizationId,
+    data
+  }: {
+    token: string;
+    organizationId?: string | null;
+    data: CreateOrderPayload;
+  }) => Promise<_classytic_arc_next_api0.ApiResponse<Order>>;
+  /**
+   * Guest checkout - create order without authentication
+   * POST /api/v1/orders/guest
+   *
+   * Items are sent in the request body (from FE localStorage).
+   * Guest identity is provided via { name, phone, email }.
+   */
+  guestCheckout: ({
+    data,
+    organizationId
+  }: {
+    data: GuestCheckoutPayload;
+    organizationId?: string | null;
+  }) => Promise<Order>;
+  /** Get my orders */
+  getMyOrders: ({
+    token,
+    params
+  }: {
+    token: string;
+    params?: Record<string, unknown>;
+  }) => Promise<Order[]>;
+  /** Get my order detail */
+  getMyOrder: ({
+    token,
+    id
+  }: {
+    token: string;
+    id: string;
+  }) => Promise<Order>;
+  /** Cancel order */
+  cancel: ({
+    token,
+    id,
+    reason,
+    refund
+  }: {
+    token: string;
+    id: string;
+    reason?: string;
+    refund?: boolean;
+  }) => Promise<Order>;
+  /** Request cancellation (awaits admin review) */
+  requestCancellation: ({
+    token,
+    id,
+    reason
+  }: {
+    token: string;
+    id: string;
+    reason?: string;
+  }) => Promise<Order>;
+  /** Update order status */
+  updateStatus: ({
+    token,
+    organizationId,
+    id,
+    data
+  }: {
+    token: string;
+    organizationId?: string | null;
+    id: string;
+    data: UpdateStatusPayload;
+  }) => Promise<Order>;
+  /**
+   * Fulfill order (ship)
+   * - Decrements inventory from branch
+   * - recordCogs: true -> also creates COGS expense transaction
+   */
+  fulfill: ({
+    token,
+    organizationId,
+    id,
+    data
+  }: {
+    token: string;
+    organizationId?: string | null;
+    id: string;
+    data?: FulfillOrderPayload;
+  }) => Promise<Order>;
+  /** Refund order */
+  refund: ({
+    token,
+    organizationId,
+    id,
+    data
+  }: {
+    token: string;
+    organizationId?: string | null;
+    id: string;
+    data?: RefundOrderPayload;
+  }) => Promise<Order>;
+  /** Get shipping info */
+  getShipping: ({
+    token,
+    id
+  }: {
+    token: string;
+    id: string;
+  }) => Promise<OrderShipping>;
+  /** Request shipping pickup */
+  requestShipping: ({
+    token,
+    organizationId,
+    id,
+    data
+  }: {
+    token: string;
+    organizationId?: string | null;
+    id: string;
+    data: RequestShippingPayload;
+  }) => Promise<OrderShipping>;
+  /** Update shipping status */
+  updateShipping: ({
+    token,
+    organizationId,
+    id,
+    data
+  }: {
+    token: string;
+    organizationId?: string | null;
+    id: string;
+    data: UpdateShippingPayload;
+  }) => Promise<OrderShipping>;
+}
+declare const orderApi: OrderApi;
+//#endregion
+export { orderApi };

package/dist/sales/api/order.js

@@ -0,0 +1,69 @@
+import { BaseApi } from "../../core/api-factory.js";
+
+//#region src/sales/api/order.ts
+/**
+* Order API Client
+*
+* Customer: checkout, getMyOrders, getMyOrder, cancel, requestCancellation
+* Admin: updateStatus, fulfill, refund, requestShipping, updateShipping
+*/
+var OrderApi = class extends BaseApi {
+	constructor(..._args) {
+		super(..._args);
+		this.checkout = ({ token, organizationId, data }) => this.create({
+			token,
+			organizationId,
+			data
+		});
+		this.guestCheckout = ({ data, organizationId }) => this.request("POST", `${this.baseUrl}/guest`, {
+			organizationId,
+			data
+		});
+		this.getMyOrders = ({ token, params = {} }) => this.request("GET", `${this.baseUrl}/my`, {
+			token,
+			params
+		});
+		this.getMyOrder = ({ token, id }) => this.request("GET", `${this.baseUrl}/my/${id}`, { token });
+		this.cancel = ({ token, id, reason, refund = false }) => this.request("POST", `${this.baseUrl}/${id}/cancel`, {
+			token,
+			data: {
+				reason,
+				refund
+			}
+		});
+		this.requestCancellation = ({ token, id, reason }) => this.request("POST", `${this.baseUrl}/${id}/cancel-request`, {
+			token,
+			data: { reason }
+		});
+		this.updateStatus = ({ token, organizationId, id, data }) => this.request("PATCH", `${this.baseUrl}/${id}/status`, {
+			token,
+			organizationId,
+			data
+		});
+		this.fulfill = ({ token, organizationId, id, data = {} }) => this.request("POST", `${this.baseUrl}/${id}/fulfill`, {
+			token,
+			organizationId,
+			data
+		});
+		this.refund = ({ token, organizationId, id, data = {} }) => this.request("POST", `${this.baseUrl}/${id}/refund`, {
+			token,
+			organizationId,
+			data
+		});
+		this.getShipping = ({ token, id }) => this.request("GET", `${this.baseUrl}/${id}/shipping`, { token });
+		this.requestShipping = ({ token, organizationId, id, data }) => this.request("POST", `${this.baseUrl}/${id}/shipping`, {
+			token,
+			organizationId,
+			data
+		});
+		this.updateShipping = ({ token, organizationId, id, data }) => this.request("PATCH", `${this.baseUrl}/${id}/shipping`, {
+			token,
+			organizationId,
+			data
+		});
+	}
+};
+const orderApi = new OrderApi("orders");
+
+//#endregion
+export { orderApi as default };

package/dist/sales/api/pos.d.ts

@@ -0,0 +1,81 @@
+import { BaseApi } from "../../core/api-factory.js";
+import { PosLookupResponse, PosOrderPayload, PosProductsResponse } from "../types/pos.js";
+import { BulkAdjustmentPayload, CreateAdjustmentPayload } from "../../inventory/types/inventory.js";
+//#region src/sales/api/pos.d.ts
+declare class PosApi extends BaseApi {
+  /**
+   * Browse products with branch-specific stock
+   * GET /api/v1/pos/products
+   */
+  getProducts(options: {
+    token: string;
+    branchId?: string; /** Filter by category slug (matches both parent and child categories) */
+    category?: string;
+    search?: string;
+    inStockOnly?: boolean;
+    lowStockOnly?: boolean;
+    sort?: string;
+    page?: number;
+    after?: string;
+    limit?: number;
+  }): Promise<PosProductsResponse>;
+  /**
+   * Fast Lookup by Barcode/SKU
+   * GET /api/v1/pos/lookup
+   */
+  lookup(options: {
+    token: string;
+    code: string;
+    branchId?: string;
+  }): Promise<PosLookupResponse>;
+  /**
+   * Create POS Order
+   * POST /api/v1/pos/orders
+   */
+  createOrder(options: {
+    token: string;
+    data: PosOrderPayload;
+  }): Promise<unknown>;
+  /**
+   * Get Receipt Data
+   * GET /api/v1/pos/orders/:orderId/receipt
+   */
+  getReceipt(options: {
+    token: string;
+    orderId: string;
+  }): Promise<unknown>;
+  /**
+   * Adjust Stock (Quick Adjustment from POS)
+   * POST /api/v1/pos/stock/adjust
+   */
+  adjustStock(options: {
+    token: string;
+    data: CreateAdjustmentPayload;
+  }): Promise<unknown>;
+  /**
+   * Set stock level directly (POS adjustment alias)
+   * POST /api/v1/pos/stock/adjust
+   */
+  setStock(options: {
+    token: string;
+    productId: string;
+    data: {
+      quantity: number;
+      branchId?: string;
+      variantSku?: string;
+      reason?: string;
+      notes?: string;
+    };
+  }): Promise<unknown>;
+  /**
+   * Bulk adjustments (POS adjustment alias)
+   * POST /api/v1/pos/stock/adjust
+   */
+  bulkAdjust(options: {
+    token: string;
+    data: BulkAdjustmentPayload;
+  }): Promise<unknown>;
+}
+declare const posApi: PosApi;
+//#endregion
+export { posApi };

package/dist/sales/api/pos.js

@@ -0,0 +1,95 @@
+import { BaseApi } from "../../core/api-factory.js";
+
+//#region src/sales/api/pos.ts
+/**
+* POS API Client
+*
+* Follows BaseApi pattern: all methods accept { token, ...params/data }
+*/
+var PosApi = class extends BaseApi {
+	/**
+	* Browse products with branch-specific stock
+	* GET /api/v1/pos/products
+	*/
+	async getProducts(options) {
+		const { token, ...params } = options;
+		return this.request("GET", `${this.config.basePath}/pos/products`, {
+			params,
+			token
+		});
+	}
+	/**
+	* Fast Lookup by Barcode/SKU
+	* GET /api/v1/pos/lookup
+	*/
+	async lookup(options) {
+		const { token, ...params } = options;
+		return this.request("GET", `${this.config.basePath}/pos/lookup`, {
+			params,
+			token
+		});
+	}
+	/**
+	* Create POS Order
+	* POST /api/v1/pos/orders
+	*/
+	async createOrder(options) {
+		const { token, data } = options;
+		return this.request("POST", `${this.config.basePath}/pos/orders`, {
+			data,
+			token
+		});
+	}
+	/**
+	* Get Receipt Data
+	* GET /api/v1/pos/orders/:orderId/receipt
+	*/
+	async getReceipt(options) {
+		const { token, orderId } = options;
+		return this.request("GET", `${this.config.basePath}/pos/orders/${orderId}/receipt`, { token });
+	}
+	/**
+	* Adjust Stock (Quick Adjustment from POS)
+	* POST /api/v1/pos/stock/adjust
+	*/
+	async adjustStock(options) {
+		const { token, data } = options;
+		return this.request("POST", `${this.config.basePath}/pos/stock/adjust`, {
+			data,
+			token
+		});
+	}
+	/**
+	* Set stock level directly (POS adjustment alias)
+	* POST /api/v1/pos/stock/adjust
+	*/
+	async setStock(options) {
+		const { token, productId, data } = options;
+		return this.request("POST", `${this.config.basePath}/pos/stock/adjust`, {
+			data: {
+				productId,
+				quantity: data.quantity,
+				variantSku: data.variantSku,
+				branchId: data.branchId,
+				mode: "set",
+				reason: data.reason ?? data.notes
+			},
+			token
+		});
+	}
+	/**
+	* Bulk adjustments (POS adjustment alias)
+	* POST /api/v1/pos/stock/adjust
+	*/
+	async bulkAdjust(options) {
+		const { token, data } = options;
+		return this.request("POST", `${this.config.basePath}/pos/stock/adjust`, {
+			data,
+			token
+		});
+	}
+};
+const posApi = new PosApi("pos");
+
+//#endregion
+export { posApi as default };

package/dist/sales/api/referrals.d.ts

@@ -0,0 +1,63 @@
+import { RecordReferralPayload, ReferralListParams, ReferralListResponse, ReferralLookupResponse, ReferralResponse, RejectReferralPayload, SelfReferralPayload } from "../types/referrals.js";
+
+//#region src/sales/api/referrals.d.ts
+type RequestOptions = {
+  cache?: RequestCache;
+  next?: Record<string, unknown>;
+};
+declare class ReferralsApi {
+  private get baseUrl();
+  record({
+    token,
+    data
+  }: {
+    token: string;
+    data: RecordReferralPayload;
+  }): Promise<ReferralResponse>;
+  approve({
+    token,
+    referralId
+  }: {
+    token: string;
+    referralId: string;
+  }): Promise<ReferralResponse>;
+  reject({
+    token,
+    referralId,
+    data
+  }: {
+    token: string;
+    referralId: string;
+    data: RejectReferralPayload;
+  }): Promise<ReferralResponse>;
+  getMemberReferrals({
+    token,
+    customerId,
+    params,
+    options
+  }: {
+    token: string;
+    customerId: string;
+    params?: ReferralListParams;
+    options?: RequestOptions;
+  }): Promise<ReferralListResponse>;
+  lookupCode({
+    token,
+    code,
+    options
+  }: {
+    token: string;
+    code: string;
+    options?: RequestOptions;
+  }): Promise<ReferralLookupResponse>;
+  selfRecord({
+    token,
+    data
+  }: {
+    token: string;
+    data: SelfReferralPayload;
+  }): Promise<ReferralResponse>;
+}
+declare const referralsApi: ReferralsApi;
+//#endregion
+export { ReferralsApi, referralsApi };

package/dist/sales/api/referrals.js

@@ -0,0 +1,62 @@
+import { getBaseUrl, handleApiRequest } from "../../core/api-handler.js";
+
+//#region src/sales/api/referrals.ts
+/**
+* Referrals API
+*
+* API client for loyalty referral endpoints.
+*
+* Endpoints:
+* - POST   /loyalty/referrals                       — record
+* - POST   /loyalty/referrals/:referralId/approve   — approve
+* - POST   /loyalty/referrals/:referralId/reject    — reject
+* - GET    /loyalty/members/:customerId/referrals   — list by member
+* - GET    /loyalty/referrals/lookup/:code           — lookup code
+* - POST   /loyalty/me/referral                     — self-service
+*/
+var ReferralsApi = class {
+	get baseUrl() {
+		return `${getBaseUrl()}/loyalty`;
+	}
+	async record({ token, data }) {
+		return handleApiRequest("POST", `${this.baseUrl}/referrals`, {
+			token,
+			body: data
+		});
+	}
+	async approve({ token, referralId }) {
+		return handleApiRequest("POST", `${this.baseUrl}/referrals/${referralId}/approve`, { token });
+	}
+	async reject({ token, referralId, data }) {
+		return handleApiRequest("POST", `${this.baseUrl}/referrals/${referralId}/reject`, {
+			token,
+			body: data
+		});
+	}
+	async getMemberReferrals({ token, customerId, params = {}, options = {} }) {
+		const searchParams = new URLSearchParams();
+		if (params.page) searchParams.set("page", String(params.page));
+		if (params.limit) searchParams.set("limit", String(params.limit));
+		const qs = searchParams.toString();
+		return handleApiRequest("GET", `${this.baseUrl}/members/${customerId}/referrals${qs ? `?${qs}` : ""}`, {
+			token,
+			...options
+		});
+	}
+	async lookupCode({ token, code, options = {} }) {
+		return handleApiRequest("GET", `${this.baseUrl}/referrals/lookup/${code}`, {
+			token,
+			...options
+		});
+	}
+	async selfRecord({ token, data }) {
+		return handleApiRequest("POST", `${this.baseUrl}/me/referral`, {
+			token,
+			body: data
+		});
+	}
+};
+const referralsApi = new ReferralsApi();
+
+//#endregion
+export { ReferralsApi, referralsApi };

package/dist/sales/api/tiers.d.ts

@@ -0,0 +1,66 @@
+import { CreateTierPayload, TierEvaluationResponse, TierListResponse, TierResponse, UpdateTierPayload } from "../types/tiers.js";
+
+//#region src/sales/api/tiers.d.ts
+declare class TiersApi {
+  private get baseUrl();
+  list({
+    token,
+    options
+  }: {
+    token: string;
+    options?: {
+      cache?: RequestCache;
+      next?: Record<string, unknown>;
+    };
+  }): Promise<TierListResponse>;
+  create({
+    token,
+    data
+  }: {
+    token: string;
+    data: CreateTierPayload;
+  }): Promise<TierResponse>;
+  update({
+    token,
+    tierId,
+    data
+  }: {
+    token: string;
+    tierId: string;
+    data: UpdateTierPayload;
+  }): Promise<TierResponse>;
+  remove({
+    token,
+    tierId
+  }: {
+    token: string;
+    tierId: string;
+  }): Promise<void>;
+  evaluateAll({
+    token
+  }: {
+    token: string;
+  }): Promise<TierEvaluationResponse>;
+  setOverride({
+    token,
+    customerId,
+    data
+  }: {
+    token: string;
+    customerId: string;
+    data: {
+      tier: string;
+      reason: string;
+    };
+  }): Promise<TierResponse>;
+  clearOverride({
+    token,
+    customerId
+  }: {
+    token: string;
+    customerId: string;
+  }): Promise<TierResponse>;
+}
+declare const tiersApi: TiersApi;
+//#endregion
+export { TiersApi, tiersApi };

package/dist/sales/api/tiers.js

@@ -0,0 +1,59 @@
+import { getBaseUrl, handleApiRequest } from "../../core/api-handler.js";
+
+//#region src/sales/api/tiers.ts
+/**
+* Tiers API
+*
+* API client for loyalty tier management endpoints.
+*
+* Endpoints:
+* - GET    /loyalty/tiers                              — list
+* - POST   /loyalty/tiers                              — create
+* - PUT    /loyalty/tiers/:tierId                      — update
+* - DELETE /loyalty/tiers/:tierId                      — delete
+* - POST   /loyalty/tiers/evaluate                     — evaluate all
+* - POST   /loyalty/members/:customerId/tier-override  — set override
+* - DELETE /loyalty/members/:customerId/tier-override  — clear override
+*/
+var TiersApi = class {
+	get baseUrl() {
+		return `${getBaseUrl()}/loyalty`;
+	}
+	async list({ token, options = {} }) {
+		return handleApiRequest("GET", `${this.baseUrl}/tiers`, {
+			token,
+			...options
+		});
+	}
+	async create({ token, data }) {
+		return handleApiRequest("POST", `${this.baseUrl}/tiers`, {
+			token,
+			body: data
+		});
+	}
+	async update({ token, tierId, data }) {
+		return handleApiRequest("PUT", `${this.baseUrl}/tiers/${tierId}`, {
+			token,
+			body: data
+		});
+	}
+	async remove({ token, tierId }) {
+		return handleApiRequest("DELETE", `${this.baseUrl}/tiers/${tierId}`, { token });
+	}
+	async evaluateAll({ token }) {
+		return handleApiRequest("POST", `${this.baseUrl}/tiers/evaluate`, { token });
+	}
+	async setOverride({ token, customerId, data }) {
+		return handleApiRequest("POST", `${this.baseUrl}/members/${customerId}/tier-override`, {
+			token,
+			body: data
+		});
+	}
+	async clearOverride({ token, customerId }) {
+		return handleApiRequest("DELETE", `${this.baseUrl}/members/${customerId}/tier-override`, { token });
+	}
+};
+const tiersApi = new TiersApi();
+
+//#endregion
+export { TiersApi, tiersApi };

package/dist/sales/hooks/cart.d.ts

@@ -0,0 +1,50 @@
+import { QueryKeys } from "../../core/react/query.factory.js";
+import { ProductVariant } from "../../catalog/types/product.js";
+import { AddCartItemPayload, Cart, CartItem, UpdateCartItemPayload } from "../types/cart.js";
+//#region src/sales/hooks/cart.d.ts
+declare const CART_KEYS: QueryKeys;
+declare function calculateItemPrice(item: CartItem): number;
+declare function calculateItemTotal(item: CartItem): number;
+declare function calculateCartSubtotal(items: CartItem[]): number;
+declare function getCartItemCount(items: CartItem[]): number;
+declare function getCartItemVariant(item: CartItem): ProductVariant | null;
+declare function formatVariantAttributes(attributes?: Record<string, string> | null): string;
+interface UseCartReturn {
+  cart: Cart | null | undefined;
+  items: CartItem[];
+  itemCount: number;
+  subtotal: number;
+  isLoading: boolean;
+  isFetching: boolean;
+  isUpdating: boolean;
+  error: Error | null;
+  addToCart: (data: AddCartItemPayload) => void;
+  addToCartAsync: (data: AddCartItemPayload) => Promise<Cart>;
+  updateCartItem: (data: UpdateCartItemPayload) => void;
+  updateCartItemAsync: (data: UpdateCartItemPayload) => Promise<Cart>;
+  removeCartItem: (itemId: string) => void;
+  removeCartItemAsync: (itemId: string) => Promise<Cart>;
+  clearCart: () => void;
+  clearCartAsync: () => Promise<Cart>;
+  refetch: () => void;
+  getItemPrice: typeof calculateItemPrice;
+}
+interface UseCartCountReturn {
+  count: number;
+  isLoading: boolean;
+}
+interface CartOptions {
+  enabled?: boolean;
+  staleTime?: number;
+  gcTime?: number;
+}
+/**
+ * Full cart hook with optimistic updates.
+ */
+declare function useCart(options?: CartOptions): UseCartReturn;
+/**
+ * Lightweight hook for cart count (header badge).
+ */
+declare function useCartCount(options?: CartOptions): UseCartCountReturn;
+//#endregion
+export { CART_KEYS, CartOptions, UseCartCountReturn, UseCartReturn, calculateCartSubtotal, calculateItemPrice, calculateItemTotal, formatVariantAttributes, getCartItemCount, getCartItemVariant, useCart, useCartCount };