@caldik/client 0.0.1 → 0.0.2

package/dist/index.d.mts

@@ -5,8 +5,8 @@ interface Category {
   slug: string;
   description: string;
   price: string;
-  logo: string;
-  banner: string;
+  logo: string | null;
+  banner: string | null;
 }
 interface CategoriesResponse {
   success: boolean;
@@ -21,8 +21,8 @@ interface CategoryProduct {
     color: string;
   }[];
   price: string;
-  logo: string;
-  banner: string;
+  logo: string | null;
+  banner: string | null;
 }
 interface CategoryDetails {
   id: string;
@@ -56,7 +56,120 @@ interface ReviewsResponse {
 interface Product {
   id: string;
   name: string;
-  price: number;
+  type: string;
+  slug: string;
+  description: string;
+  price: string;
+  logo: string | null;
+  banner: string | null;
+  videoUrl: string | null;
+  deliveryType: string;
+  minimumQuantity: number | null;
+  maximumQuantity: number | null;
+  variants: ProductVariant[];
+  tags: ProductTag[];
+}
+interface ProductVariant {
+  id: string;
+  name: string;
+  price: string;
+  compareAtPrice: string | null;
+}
+interface ProductTag {
+  label: string;
+  color: string;
+}
+interface ProductsResponse {
+  success: boolean;
+  products: Product[];
+}
+interface ProductResponse {
+  success: boolean;
+  product: Product;
+}
+interface ManualCommerceItem {
+  name: string;
+  description?: string;
+  quantity?: number;
+  unitAmount: string | number;
+}
+interface ProductCommerceItem {
+  productId: string;
+  productVariantId?: string;
+  quantity?: number;
+}
+type CommerceItem = ManualCommerceItem | ProductCommerceItem;
+interface CreateOrderInput {
+  customerId?: string;
+  email?: string;
+  paymentMethod: "customer_balance" | "stripe" | "ovgc";
+  items: CommerceItem[];
+  successUrl?: string;
+  cancelUrl?: string;
+}
+interface StorefrontOrder {
+  id: string;
+  shortId: string;
+  displayId: string;
+  customerId: string | null;
+  paymentStatus: string;
+  fulfillmentStatus: string;
+  amount: string;
+  currency: string;
+}
+interface CheckoutPayment {
+  type: "customer_balance" | "stripe" | "ovgc";
+  checkoutUrl?: string | null;
+  checkoutSessionId?: string | null;
+  balanceAfter?: string;
+}
+interface OrderResponse {
+  success: boolean;
+  order: StorefrontOrder;
+  payment: CheckoutPayment | null;
+}
+interface CreateSubscriptionInput {
+  customerId?: string;
+  email?: string;
+  items: CommerceItem[];
+  billingInterval: "day" | "week" | "month" | "year";
+  billingIntervalCount?: number;
+  trialDays?: number;
+  successUrl: string;
+  cancelUrl: string;
+}
+interface SubscriptionResponse {
+  success: boolean;
+  subscription: {
+    id: string;
+    shortId: string;
+    displayId: string;
+    customerId: string;
+    status: string;
+    billingInterval: string;
+    billingIntervalCount: number;
+    amount: string;
+    currency: string;
+  };
+  payment: {
+    type: "stripe";
+    checkoutUrl: string;
+    checkoutSessionId: string;
+  };
+}
+interface CustomerLoginResponse {
+  success: boolean;
+  message: string;
+}
+interface CustomerLoginVerifyResponse {
+  success: boolean;
+  customer: {
+    id: string;
+    shortId: string;
+    displayId: string;
+    email: string;
+    status: string;
+  };
 }
 //#endregion
 //#region src/internal/types.d.ts
@@ -65,11 +178,21 @@ interface RequestOptions {
 }
 //#endregion
 //#region src/internal/client.d.ts
+type CaldikTransport = "auto" | "browser" | "worker";
+type HttpClientOptions = {
+  apiKey?: string;
+  apiUrl?: string;
+  transport?: CaldikTransport;
+};
 declare class CaldikHttpClient {
-  private publicKey?;
-  private apiUrl;
-  constructor(publicKey?: string | undefined, apiUrl?: string);
+  private readonly apiKey?;
+  private readonly apiUrl;
+  private readonly transport;
+  constructor(options?: HttpClientOptions);
+  private baseUrl;
+  private request;
   get<T>(path: string, params?: Record<string, string | number>, options?: RequestOptions): Promise<T>;
+  post<T>(path: string, input?: unknown, options?: RequestOptions): Promise<T>;
 }
 //#endregion
 //#region src/categories.d.ts
@@ -84,8 +207,8 @@ declare class CategoriesApi {
 declare class ProductsApi {
   private client;
   constructor(client: CaldikHttpClient);
-  list(): Promise<Product[]>;
-  get(productId: string): Promise<Product>;
+  list(): Promise<ProductsResponse>;
+  get(productId: string): Promise<ProductResponse>;
 }
 //#endregion
 //#region src/reviews.d.ts
@@ -102,17 +225,48 @@ declare class StoreApi {
   get(): Promise<StoreResponse>;
 }
 //#endregion
+//#region src/checkout.d.ts
+declare class CheckoutApi {
+  private client;
+  constructor(client: CaldikHttpClient);
+  create(input: CreateOrderInput): Promise<OrderResponse>;
+  payWithBalance(orderId: string): Promise<OrderResponse>;
+}
+//#endregion
+//#region src/customer.d.ts
+declare class CustomerApi {
+  private client;
+  constructor(client: CaldikHttpClient);
+  requestLogin(email: string): Promise<CustomerLoginResponse>;
+  verifyLogin(code: string): Promise<CustomerLoginVerifyResponse>;
+}
+//#endregion
+//#region src/subscriptions.d.ts
+declare class SubscriptionsApi {
+  private client;
+  constructor(client: CaldikHttpClient);
+  create(input: CreateSubscriptionInput): Promise<SubscriptionResponse>;
+}
+//#endregion
 //#region src/index.d.ts
 interface CaldikClientOptions {
+  /** API key for explicit external/browser integrations. */
+  apiKey?: string;
+  /** @deprecated Use apiKey. Retained for backwards compatibility. */
   publicApiKey?: string;
   apiUrl?: string;
+  /** Override automatic browser/Cloudflare Worker transport detection. */
+  transport?: CaldikTransport;
 }
 declare class CaldikClient {
   readonly categories: CategoriesApi;
   readonly products: ProductsApi;
   readonly reviews: ReviewsApi;
   readonly store: StoreApi;
+  readonly checkout: CheckoutApi;
+  readonly customer: CustomerApi;
+  readonly subscriptions: SubscriptionsApi;
   constructor(options?: CaldikClientOptions);
 }
 //#endregion
-export { CaldikClient, CaldikClientOptions };
+export { CaldikClient, CaldikClientOptions, type CaldikTransport, CategoriesResponse, Category, CategoryDetails, CategoryProduct, CategoryResponse, CheckoutPayment, CommerceItem, CreateOrderInput, CreateSubscriptionInput, CustomerLoginResponse, CustomerLoginVerifyResponse, ManualCommerceItem, OrderResponse, Product, ProductCommerceItem, ProductResponse, ProductTag, ProductVariant, ProductsResponse, Review, ReviewsResponse, Store, StoreResponse, StorefrontOrder, SubscriptionResponse };

package/dist/index.mjs

@@ -2,29 +2,58 @@
 const defaultApiUrl = typeof API_URL !== "undefined" ? API_URL : "https://api.caldik.com";
 //#endregion
 //#region src/internal/client.ts
+function isBrowserRuntime() {
+	return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function isCloudflareWorkerRuntime() {
+	return typeof navigator !== "undefined" && navigator.userAgent === "Cloudflare-Workers";
+}
 var CaldikHttpClient = class {
-	publicKey;
+	apiKey;
 	apiUrl;
-	constructor(publicKey, apiUrl = defaultApiUrl) {
-		this.publicKey = publicKey;
-		this.apiUrl = apiUrl;
+	transport;
+	constructor(options = {}) {
+		this.apiKey = options.apiKey;
+		this.apiUrl = options.apiUrl || defaultApiUrl;
+		this.transport = options.transport || "auto";
+	}
+	baseUrl() {
+		if (this.apiKey) return `${this.apiUrl.replace(/\/+$/, "")}/v1/storefront`;
+		if (this.transport === "browser" || this.transport === "auto" && isBrowserRuntime()) {
+			if (typeof location === "undefined") throw new Error("Caldik browser transport requires a browser origin");
+			return new URL("/__caldik/api", location.origin).toString().replace(/\/+$/, "");
+		}
+		if (this.transport === "worker" || this.transport === "auto" && isCloudflareWorkerRuntime()) return `${this.apiUrl.replace(/\/+$/, "")}/v1/storefront`;
+		throw new Error("Caldik authentication is unavailable in this environment. Provide apiKey for an external integration, or set transport to \"browser\" or \"worker\" when environment detection is unavailable.");
 	}
-	async get(path, params, options) {
-		const baseUrl = this.apiUrl.replace(/\/+$/, "");
-		const url = new URL(`${baseUrl}/v1${path}`);
+	async request(method, path, input, params, options) {
+		const url = new URL(`${this.baseUrl()}${path}`);
 		if (params) for (const [key, value] of Object.entries(params)) url.searchParams.set(key, String(value));
-		const headers = {
-			"User-Agent": "CaldikClient/0.0.1",
-			...this.publicKey && { Authorization: `Bearer ${this.publicKey}` }
-		};
+		const headers = {};
+		if (!isBrowserRuntime()) headers["User-Agent"] = "CaldikClient/0.0.1";
+		if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`;
+		if (input !== void 0) headers["Content-Type"] = "application/json";
 		if (options?.edgeCache) headers["X-Cache-Policy"] = "public";
 		const response = await fetch(url, {
+			method,
 			headers,
-			cache: "default"
+			...input !== void 0 ? { body: JSON.stringify(input) } : {},
+			cache: "default",
+			credentials: "include"
 		});
-		if (!response.ok) throw new Error(response.statusText);
+		if (!response.ok) {
+			const error = await response.clone().json().catch(() => null);
+			const message = typeof error?.message === "string" && error.message ? error.message : `${response.status} ${response.statusText}`.trim();
+			throw new Error(message);
+		}
 		return response.json();
 	}
+	get(path, params, options) {
+		return this.request("GET", path, void 0, params, options);
+	}
+	post(path, input, options) {
+		return this.request("POST", path, input, void 0, options);
+	}
 };
 //#endregion
 //#region src/categories.ts
@@ -77,18 +106,67 @@ var StoreApi = class {
 	}
 };
 //#endregion
+//#region src/checkout.ts
+var CheckoutApi = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	create(input) {
+		return this.client.post("/checkout", input);
+	}
+	payWithBalance(orderId) {
+		return this.client.post(`/checkout/${encodeURIComponent(orderId)}/balance-payment`);
+	}
+};
+//#endregion
+//#region src/customer.ts
+var CustomerApi = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	requestLogin(email) {
+		return this.client.post("/customer/login", { email });
+	}
+	verifyLogin(code) {
+		return this.client.post("/customer/login/verify", { code });
+	}
+};
+//#endregion
+//#region src/subscriptions.ts
+var SubscriptionsApi = class {
+	client;
+	constructor(client) {
+		this.client = client;
+	}
+	create(input) {
+		return this.client.post("/subscriptions", input);
+	}
+};
+//#endregion
 //#region src/index.ts
 var CaldikClient = class {
 	categories;
 	products;
 	reviews;
 	store;
+	checkout;
+	customer;
+	subscriptions;
 	constructor(options = {}) {
-		const client = new CaldikHttpClient(options.publicApiKey, options.apiUrl);
+		const client = new CaldikHttpClient({
+			apiKey: options.apiKey ?? options.publicApiKey,
+			apiUrl: options.apiUrl,
+			transport: options.transport
+		});
 		this.categories = new CategoriesApi(client);
 		this.products = new ProductsApi(client);
 		this.reviews = new ReviewsApi(client);
 		this.store = new StoreApi(client);
+		this.checkout = new CheckoutApi(client);
+		this.customer = new CustomerApi(client);
+		this.subscriptions = new SubscriptionsApi(client);
 	}
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caldik/client",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -17,7 +17,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsdown"
+    "build": "tsdown",
+    "test": "bun test"
   },
   "devDependencies": {
     "tsdown": "^0.22.3",