@classytic/commerce-sdk 0.1.1 → 0.2.1

package/dist/content/types/cms.d.ts

@@ -0,0 +1,390 @@
+//#region src/content/types/cms.d.ts
+/**
+ * CMS Types - Aligned with lib/cms-data.ts structure
+ */
+type CMSPageStatus = "draft" | "published" | "archived";
+interface CMSMetadata {
+  title: string;
+  description: string;
+  keywords: string[];
+  ogImage?: string;
+}
+interface CMSPage<T = Record<string, unknown>> {
+  _id?: string;
+  name: string;
+  slug: string;
+  status: CMSPageStatus;
+  content: T;
+  metadata?: CMSMetadata;
+  publishedAt?: string;
+  createdAt?: string;
+  updatedAt?: string;
+}
+interface CMSPagePayload {
+  name?: string;
+  status?: CMSPageStatus;
+  content?: Record<string, unknown>;
+  metadata?: Partial<CMSMetadata>;
+}
+interface CTA {
+  label: string;
+  href: string;
+}
+interface ContactInfo {
+  email?: string;
+  phone?: string;
+  address?: string;
+}
+/**
+ * Home Page Content
+ */
+interface HomePageContent {
+  hero: {
+    badge: string;
+    headline: string[];
+    highlightedWord?: string;
+    description: string;
+    primaryCTA: CTA;
+    secondaryCTA?: CTA;
+    image?: string;
+    floatingBadge?: {
+      value: string;
+      label: string;
+    };
+  };
+  marquee: {
+    items: string[];
+  };
+  brandStory: {
+    badge: string;
+    headline: string[];
+    paragraphs: string[];
+    stats: Array<{
+      value: string;
+      label: string;
+    }>;
+    images: string[];
+    cta: CTA;
+  };
+  featuredProducts: {
+    badge: string;
+    headline: string;
+    description: string;
+    cta: CTA;
+  };
+  testimonials: {
+    badge: string;
+    headline: string;
+    items: Array<{
+      id: number;
+      name: string;
+      location: string;
+      rating: number;
+      text: string;
+      avatar: string;
+    }>;
+  };
+  instagramFeed: {
+    badge: string;
+    headline: string;
+    description: string;
+    images: string[];
+    cta: CTA;
+  };
+  features?: {
+    items: Array<{
+      icon: string;
+      title: string;
+      description: string;
+    }>;
+  };
+  promoBanner?: {
+    headline: string;
+    subheadline: string;
+    description: string;
+    cta: CTA;
+    backgroundImage: string;
+  };
+  lookbook?: {
+    badge: string;
+    headline: string;
+    description: string;
+    items: Array<{
+      id: number;
+      title: string;
+      image: string;
+      href: string;
+    }>;
+  };
+  newsletter?: {
+    headline: string;
+    description: string;
+    placeholder: string;
+    buttonText: string;
+    disclaimer: string;
+  };
+}
+/**
+ * Privacy/Terms/Cookies Page Content (Text pages with sections)
+ */
+interface PolicyPageContent {
+  title: string;
+  lastUpdated: string;
+  intro?: string;
+  sections: Array<{
+    title: string;
+    content?: string;
+    list?: string[];
+    subsections?: Array<{
+      title: string;
+      content: string;
+    }>;
+    contact?: ContactInfo;
+  }>;
+}
+/**
+ * Returns Page Content
+ */
+interface ReturnsPageContent {
+  title: string;
+  subtitle: string;
+  steps: Array<{
+    icon: string;
+    title: string;
+    description: string;
+  }>;
+  sections: Array<{
+    type: "policy" | "grid" | "text";
+    title: string;
+    highlight?: {
+      title: string;
+      content: string;
+    };
+    columns?: Array<{
+      title: string;
+      variant: "success" | "destructive";
+      items: string[];
+    }>;
+    content?: string;
+    paragraphs?: Array<string | {
+      text: string;
+      bold?: boolean;
+      suffix?: string;
+    }>;
+    list?: string[];
+    footer?: string;
+  }>;
+  contactSection: {
+    title: string;
+    content: string;
+    email: string;
+    phone: string;
+    hours: string;
+  };
+}
+/**
+ * FAQ Page Content
+ */
+interface FAQPageContent {
+  title: string;
+  subtitle: string;
+  categories: Array<{
+    title: string;
+    items: Array<{
+      question: string;
+      answer: string;
+    }>;
+  }>;
+  contactSection: {
+    title: string;
+    description: string;
+    email: string;
+    phone: string;
+    hours: string;
+  };
+}
+/**
+ * About Page Content
+ */
+interface AboutPageContent {
+  hero: {
+    badge: string;
+    headline: string;
+    description: string;
+    image: string;
+  };
+  story: {
+    title: string;
+    paragraphs: string[];
+  };
+  values: {
+    title: string;
+    items: Array<{
+      icon: string;
+      title: string;
+      description: string;
+    }>;
+  };
+  stats: Array<{
+    value: string;
+    label: string;
+  }>;
+  team: {
+    title: string;
+    description: string;
+    members: Array<{
+      name: string;
+      role: string;
+      image: string;
+      bio: string;
+    }>;
+  };
+  cta: {
+    title: string;
+    description: string;
+    buttonText: string;
+    buttonLink: string;
+  };
+}
+/**
+ * Contact Page Content
+ * Note: contactInfo icons are static (MapPin, Phone, Mail) - no icon field needed
+ */
+interface ContactPageContent {
+  title: string;
+  subtitle: string;
+  contactInfo: Array<{
+    title: string;
+    lines: string[];
+  }>;
+  form: {
+    title: string;
+    description: string;
+    fields: Array<{
+      name: string;
+      label: string;
+      type: string;
+      placeholder?: string;
+      required: boolean;
+      options?: string[];
+    }>;
+    submitText: string;
+  };
+  faq?: {
+    title: string;
+    description: string;
+    link: string;
+    linkText: string;
+  };
+  socialTitle?: string;
+  socials: Array<{
+    platform: string;
+    handle: string;
+    url: string;
+  }>;
+  map?: {
+    title: string;
+    embedUrl: string;
+  };
+}
+/**
+ * Size Guide Page Content
+ */
+interface SizeGuidePageContent {
+  title: string;
+  subtitle: string;
+  howToMeasure: {
+    title: string;
+    description: string;
+    measurements: Array<{
+      name: string;
+      icon: string;
+      instruction: string;
+    }>;
+  };
+  sizeTables: Array<{
+    category: string;
+    description: string;
+    headers: string[];
+    rows: string[][];
+  }>;
+  fitTypes: {
+    title: string;
+    types: Array<{
+      name: string;
+      description: string;
+      recommendation: string;
+    }>;
+  };
+  tips: {
+    title: string;
+    items: string[];
+  };
+  helpSection: {
+    title: string;
+    description: string;
+    email: string;
+    phone: string;
+  };
+}
+/**
+ * Shipping & Delivery Page Content
+ */
+interface ShippingPageContent {
+  title: string;
+  subtitle: string;
+  deliveryMethods: Array<{
+    icon: string;
+    name: string;
+    duration: string;
+    price: string;
+    description: string;
+  }>;
+  deliveryAreas: {
+    title: string;
+    areas: Array<{
+      name: string;
+      duration: string;
+      cost: string;
+    }>;
+  };
+  orderTracking: {
+    title: string;
+    description: string;
+    steps: Array<{
+      title: string;
+      description: string;
+    }>;
+  };
+  policies: Array<{
+    title: string;
+    content: string;
+    list?: string[];
+  }>;
+  faq: Array<{
+    question: string;
+    answer: string;
+  }>;
+  contactSection: {
+    title: string;
+    description: string;
+    email: string;
+    phone: string;
+    hours: string;
+  };
+}
+type CMSContentBySlug = {
+  home: HomePageContent;
+  "privacy-policy": PolicyPageContent;
+  "terms-conditions": PolicyPageContent;
+  cookies: PolicyPageContent;
+  "returns-refunds": ReturnsPageContent;
+  faqs: FAQPageContent;
+  "about-us": AboutPageContent;
+  contact: ContactPageContent;
+  "size-guide": SizeGuidePageContent;
+  "shipping-delivery": ShippingPageContent;
+};
+type CMSSlug = keyof CMSContentBySlug;
+//#endregion
+export { AboutPageContent, CMSContentBySlug, CMSMetadata, CMSPage, CMSPagePayload, CMSPageStatus, CMSSlug, ContactPageContent, FAQPageContent, HomePageContent, PolicyPageContent, ReturnsPageContent, ShippingPageContent, SizeGuidePageContent };

package/dist/content/types/media.d.ts

@@ -0,0 +1,110 @@
+//#region src/content/types/media.d.ts
+/**
+ * Media Types
+ * Simple types for media upload, management, and retrieval
+ */
+/**
+ * Allowed media folders
+ */
+type MediaFolder = "general" | "products" | "categories" | "blog" | "users" | "banners" | "brands";
+/**
+ * Image variant names (auto-generated on upload)
+ * - thumbnail: 150x200 (for grids, lists)
+ * - medium: 600x800 (for detail views)
+ */
+type VariantName = "thumbnail" | "medium";
+/**
+ * Image dimensions
+ */
+interface MediaDimensions {
+  width: number;
+  height: number;
+}
+/**
+ * Image variant (resized version)
+ */
+interface MediaVariant {
+  name: VariantName;
+  url: string;
+  width: number;
+  height: number;
+}
+/**
+ * Media document (image file with metadata)
+ */
+interface Media {
+  _id: string;
+  url: string;
+  filename: string;
+  folder: MediaFolder;
+  alt?: string;
+  title?: string;
+  size: number;
+  dimensions: MediaDimensions;
+  variants?: MediaVariant[];
+  contentType?: string;
+  createdAt: string;
+  updatedAt?: string;
+}
+/**
+ * Upload single file payload
+ */
+interface UploadPayload {
+  file: File | Blob;
+  folder?: MediaFolder;
+  alt?: string;
+  title?: string;
+}
+/**
+ * Upload multiple files payload
+ */
+interface UploadMultiplePayload {
+  files: (File | Blob)[];
+  folder?: MediaFolder;
+}
+/**
+ * Update media payload
+ */
+interface UpdateMediaPayload {
+  alt?: string;
+  title?: string;
+}
+/**
+ * Bulk delete payload
+ */
+interface BulkDeletePayload {
+  ids: string[];
+}
+/**
+ * Move files payload
+ */
+interface MoveFilesPayload {
+  ids: string[];
+  targetFolder: MediaFolder;
+}
+/**
+ * Query parameters for media listing
+ */
+interface MediaQueryParams {
+  page?: number;
+  limit?: number;
+  folder?: MediaFolder;
+  search?: string;
+  sort?: string;
+  [key: string]: unknown;
+}
+/**
+ * Bulk delete result
+ */
+interface BulkDeleteResult {
+  success: string[];
+  failed: string[];
+}
+/**
+ * Move files result
+ */
+interface MoveFilesResult {
+  modifiedCount: number;
+}
+//#endregion
+export { BulkDeletePayload, BulkDeleteResult, Media, MediaDimensions, MediaFolder, MediaQueryParams, MediaVariant, MoveFilesPayload, MoveFilesResult, UpdateMediaPayload, UploadMultiplePayload, UploadPayload, VariantName };

package/dist/core/api-factory.d.ts

@@ -0,0 +1,17 @@
+import { AggregatePaginationResponse, ApiResponse, BaseApi, BaseApiConfig, BaseApiConfig as BaseApiConfig$1, DeleteResponse, ExtractDoc, FilterOperator, KeysetPaginationResponse, OffsetPaginationResponse, PaginatedResponse, PopulateOption, QueryParams, RequestOptions, SortDirection, SortSpec, isAggregatePagination, isKeysetPagination, isOffsetPagination } from "@classytic/arc-next/api";
+
+//#region src/core/api-factory.d.ts
+/**
+ * Commerce BaseApi — wraps arc-next's BaseApi with auto auth injection.
+ *
+ * arc-next's handleApiRequest does NOT read from configureAuth().
+ * commerce-sdk's handleApiRequest DOES (see api-handler.ts lines 132-148).
+ * By passing it as the client.request, every BaseApi.request() / getAll() etc.
+ * automatically gets the bearer token and x-organization-id header.
+ */
+declare class BaseApi$1<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, TUpdate = Partial<TDoc>> extends BaseApi<TDoc, TCreate, TUpdate> {
+  constructor(entity: string, config?: BaseApiConfig);
+}
+declare function createCrudApi<TDoc = Record<string, unknown>, TCreate = Partial<TDoc>, TUpdate = Partial<TDoc>>(entity: string, config?: BaseApiConfig): BaseApi$1<TDoc, TCreate, TUpdate>;
+//#endregion
+export { type AggregatePaginationResponse, type ApiResponse, BaseApi$1 as BaseApi, type BaseApiConfig$1 as BaseApiConfig, type DeleteResponse, type ExtractDoc, type FilterOperator, type KeysetPaginationResponse, type OffsetPaginationResponse, type PaginatedResponse, type PopulateOption, type QueryParams, type RequestOptions, type SortDirection, type SortSpec, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination };

package/dist/core/api-factory.js

@@ -0,0 +1,39 @@
+import { handleApiRequest } from "./api-handler.js";
+import { BaseApi, isAggregatePagination, isKeysetPagination, isOffsetPagination } from "@classytic/arc-next/api";
+
+//#region src/core/api-factory.ts
+/**
+* API Factory — Re-exports from @classytic/arc-next
+*
+* All CRUD API implementations now live in arc-next.
+* This file maintains backwards-compatible exports for domain modules.
+*
+* BaseApi is wrapped so that every request auto-injects auth (token + orgId)
+* from configureAuth() when not explicitly provided. arc-next's BaseApi is a
+* dumb transport — auth injection is the SDK consumer's responsibility.
+*/
+/**
+* Commerce BaseApi — wraps arc-next's BaseApi with auto auth injection.
+*
+* arc-next's handleApiRequest does NOT read from configureAuth().
+* commerce-sdk's handleApiRequest DOES (see api-handler.ts lines 132-148).
+* By passing it as the client.request, every BaseApi.request() / getAll() etc.
+* automatically gets the bearer token and x-organization-id header.
+*/
+var BaseApi$1 = class extends BaseApi {
+	constructor(entity, config = {}) {
+		super(entity, {
+			...config,
+			client: config.client ?? {
+				request: handleApiRequest,
+				config: { baseUrl: "" }
+			}
+		});
+	}
+};
+function createCrudApi(entity, config = {}) {
+	return new BaseApi$1(entity, config);
+}
+
+//#endregion
+export { BaseApi$1 as BaseApi, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination };

package/dist/core/api-handler.d.ts

@@ -0,0 +1,53 @@
+import { ApiRequestOptions, ArcApiError, ArcClient, ArcClientConfig, BlobResponse, HttpMethod, TextResponse, createClient, createQueryString, getAuthContext, isArcApiError } from "@classytic/arc-next/client";
+
+//#region src/core/api-handler.d.ts
+type HttpMethod$1 = HttpMethod;
+type ApiRequestOptions$1 = ApiRequestOptions;
+type BlobResponse$1 = BlobResponse;
+type TextResponse$1 = TextResponse;
+interface SDKConfig {
+  baseUrl: string;
+  organizationId?: string;
+  getToken?: () => string | null | Promise<string | null>;
+  cache?: RequestCache;
+  headers?: Record<string, string>;
+  credentials?: RequestCredentials;
+}
+/**
+ * Configure the Commerce SDK.
+ * Wraps arc-next's configureClient + configureAuth.
+ */
+declare function configureSDK(config: SDKConfig): void;
+declare function getSDKConfig(): SDKConfig;
+declare function getBaseUrl(): string;
+declare function setSDKConfigProvider(provider: () => SDKConfig): void;
+/**
+ * Commerce-specific API error.
+ * Wraps arc-next's ArcApiError with backwards-compatible interface.
+ */
+declare class ApiError extends Error {
+  readonly status: number;
+  readonly statusText: string;
+  readonly body: unknown;
+  readonly endpoint: string;
+  readonly method: HttpMethod$1;
+  constructor(options: {
+    message: string;
+    status: number;
+    statusText: string;
+    body: unknown;
+    endpoint: string;
+    method: HttpMethod$1;
+  });
+  isClientError(): boolean;
+  isServerError(): boolean;
+}
+/**
+ * Wrapped handleApiRequest that auto-injects auth token from configureAuth
+ * when not explicitly provided. This ensures all SDK API calls (including
+ * media uploads, POS, inventory) send the bearer token automatically.
+ */
+declare function handleApiRequest$1<T = unknown>(method: HttpMethod, endpoint: string, options?: ApiRequestOptions): Promise<T>;
+declare const createQueryString$1: typeof createQueryString;
+//#endregion
+export { ApiError, ApiRequestOptions$1 as ApiRequestOptions, ArcApiError, type ArcClient, type ArcClientConfig, BlobResponse$1 as BlobResponse, HttpMethod$1 as HttpMethod, SDKConfig, TextResponse$1 as TextResponse, configureSDK, createClient, createQueryString$1 as createQueryString, getAuthContext, getBaseUrl, getSDKConfig, handleApiRequest$1 as handleApiRequest, isArcApiError, setSDKConfigProvider };

package/dist/core/api-handler.js

@@ -0,0 +1,89 @@
+import { ArcApiError, configureAuth, configureClient, createClient, createQueryString, getAuthContext, handleApiRequest, isArcApiError } from "@classytic/arc-next/client";
+
+//#region src/core/api-handler.ts
+/**
+* API Handler — Commerce-specific config adapter for arc-next
+*
+* Provides configureSDK() which wraps arc-next's configureClient/configureAuth.
+* Re-exports request handler and utilities from arc-next for backwards compat.
+*/
+let _sdkConfig = null;
+let _configProvider = null;
+/**
+* Configure the Commerce SDK.
+* Wraps arc-next's configureClient + configureAuth.
+*/
+function configureSDK(config) {
+	_sdkConfig = config;
+	configureClient({
+		baseUrl: config.baseUrl,
+		defaultHeaders: config.headers,
+		authMode: "bearer",
+		credentials: config.credentials
+	});
+	configureAuth({
+		getToken: config.getToken ? () => {
+			const result = config.getToken();
+			if (result instanceof Promise) return null;
+			return result;
+		} : () => null,
+		getOrgId: () => config.organizationId || null
+	});
+}
+function getSDKConfig() {
+	if (_configProvider) return _configProvider();
+	if (!_sdkConfig) throw new Error("SDK not configured. Call configureSDK() first.");
+	return _sdkConfig;
+}
+function getBaseUrl() {
+	return getSDKConfig().baseUrl;
+}
+function setSDKConfigProvider(provider) {
+	_configProvider = provider;
+	const config = provider();
+	if (config) configureSDK(config);
+}
+/**
+* Commerce-specific API error.
+* Wraps arc-next's ArcApiError with backwards-compatible interface.
+*/
+var ApiError = class extends Error {
+	constructor(options) {
+		super(options.message);
+		this.name = "ApiError";
+		this.status = options.status;
+		this.statusText = options.statusText;
+		this.body = options.body;
+		this.endpoint = options.endpoint;
+		this.method = options.method;
+	}
+	isClientError() {
+		return this.status >= 400 && this.status < 500;
+	}
+	isServerError() {
+		return this.status >= 500;
+	}
+};
+/**
+* Wrapped handleApiRequest that auto-injects auth token from configureAuth
+* when not explicitly provided. This ensures all SDK API calls (including
+* media uploads, POS, inventory) send the bearer token automatically.
+*/
+function handleApiRequest$1(method, endpoint, options = {}) {
+	if (!options.token) {
+		const auth = getAuthContext();
+		if (auth.token) options = {
+			...options,
+			token: auth.token
+		};
+		if (!options.organizationId && auth.organizationId) options = {
+			...options,
+			organizationId: auth.organizationId
+		};
+	}
+	return handleApiRequest(method, endpoint, options);
+}
+const createQueryString$1 = createQueryString;
+
+//#endregion
+export { ApiError, ArcApiError, configureSDK, createClient, createQueryString$1 as createQueryString, getAuthContext, getBaseUrl, getSDKConfig, handleApiRequest$1 as handleApiRequest, isArcApiError, setSDKConfigProvider };