@ecommaps/client 1.1.0

package/dist/index.d.mts

@@ -0,0 +1,168 @@
+interface EcommapsSite {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    logo_url: string | null;
+    custom_domain: string | null;
+    theme: any | null;
+    theme_settings: any | null;
+    settings: any | null;
+    contact_info: any | null;
+    social_links: any | null;
+}
+interface EcommapsProductVariant {
+    title: string;
+    prices: any[];
+    options: any[];
+    inventory_quantity: number;
+    sku: string | null;
+    id?: string;
+}
+interface EcommapsProduct {
+    id: string;
+    site_id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    price: number;
+    compare_at_price: number | null;
+    currency: string | null;
+    images: any | null;
+    category: string | null;
+    tags: string[] | null;
+    inventory_quantity: number | null;
+    is_active: boolean | null;
+    created_at: string | null;
+    updated_at: string | null;
+    sku: string | null;
+    barcode: string | null;
+    cost_per_item: number | null;
+    track_quantity: boolean | null;
+    continue_selling_when_out_of_stock: boolean | null;
+    weight: number | null;
+    weight_unit: string | null;
+    vendor: string | null;
+    product_type: string | null;
+    options: any | null;
+    variants: any | null;
+    charge_tax: boolean | null;
+    is_physical: boolean | null;
+}
+interface EcommapsCollection {
+    id: string;
+    site_id: string;
+    title: string;
+    description: string | null;
+    slug: string;
+    image_url: string | null;
+    is_active: boolean | null;
+    sort_order: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface PaginationMeta {
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+interface EcommapsCartItem {
+    id: string;
+    product_id: string;
+    variant_id: string | null;
+    product_name: string;
+    product_price: number;
+    product_image: string | null;
+    quantity: number;
+    subtotal: number;
+}
+interface EcommapsCart {
+    id: string;
+    site_id: string;
+    items: EcommapsCartItem[];
+    items_count: number;
+    subtotal: number;
+    created_at: string | null;
+}
+interface EcommapsCustomer {
+    id: string;
+    store_id: string;
+    email: string;
+    full_name: string;
+    phone: string | null;
+    addresses: any[];
+    created_at: string;
+}
+interface EcommapsAuthResponse {
+    token: string;
+    user: EcommapsCustomer;
+}
+
+declare class EcommapsAPIError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+declare const ecommapsClient: {
+    store: {
+        retrieve: (options?: RequestInit) => Promise<EcommapsSite>;
+        menus: (options?: RequestInit) => Promise<any>;
+    };
+    products: {
+        list: (params?: Record<string, string | number>, options?: RequestInit) => Promise<PaginatedResponse<EcommapsProduct>>;
+        retrieve: (slug: string, options?: RequestInit) => Promise<EcommapsProduct>;
+    };
+    collections: {
+        list: (options?: RequestInit) => Promise<{
+            data: EcommapsCollection[];
+        }>;
+        retrieve: (slug: string, limit?: number, offset?: number, options?: RequestInit) => Promise<{
+            collection: EcommapsCollection;
+            products: EcommapsProduct[];
+            pagination: any;
+        }>;
+    };
+    cart: {
+        create: (options?: RequestInit) => Promise<EcommapsCart>;
+        retrieve: (cartId: string, options?: RequestInit) => Promise<EcommapsCart>;
+        addItem: (cartId: string, body: {
+            product_id: string;
+            variant_id?: string;
+            quantity: number;
+        }, options?: RequestInit) => Promise<EcommapsCart>;
+        updateItem: (cartId: string, itemId: string, body: {
+            quantity: number;
+        }, options?: RequestInit) => Promise<EcommapsCart>;
+        removeItem: (cartId: string, itemId: string, options?: RequestInit) => Promise<EcommapsCart>;
+    };
+    orders: {
+        create: (body: any, options?: RequestInit) => Promise<any>;
+        retrieve: (orderNumber: string, options?: RequestInit) => Promise<any>;
+        list: (options?: RequestInit & {
+            params?: {
+                limit?: number;
+                offset?: number;
+            };
+        }) => Promise<{
+            data: any[];
+            pagination: any;
+        }>;
+    };
+    auth: {
+        login: (body: any, options?: RequestInit) => Promise<EcommapsAuthResponse>;
+        signup: (body: any, options?: RequestInit) => Promise<EcommapsAuthResponse>;
+        me: (options?: RequestInit) => Promise<{
+            customer: EcommapsCustomer;
+        }>;
+        addAddress: (body: any, options?: RequestInit) => Promise<{
+            success: boolean;
+            address: any;
+        }>;
+    };
+};
+
+export { EcommapsAPIError, type EcommapsAuthResponse, type EcommapsCart, type EcommapsCartItem, type EcommapsCollection, type EcommapsCustomer, type EcommapsProduct, type EcommapsProductVariant, type EcommapsSite, type PaginatedResponse, type PaginationMeta, ecommapsClient };

package/dist/index.d.ts

@@ -0,0 +1,168 @@
+interface EcommapsSite {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    logo_url: string | null;
+    custom_domain: string | null;
+    theme: any | null;
+    theme_settings: any | null;
+    settings: any | null;
+    contact_info: any | null;
+    social_links: any | null;
+}
+interface EcommapsProductVariant {
+    title: string;
+    prices: any[];
+    options: any[];
+    inventory_quantity: number;
+    sku: string | null;
+    id?: string;
+}
+interface EcommapsProduct {
+    id: string;
+    site_id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    price: number;
+    compare_at_price: number | null;
+    currency: string | null;
+    images: any | null;
+    category: string | null;
+    tags: string[] | null;
+    inventory_quantity: number | null;
+    is_active: boolean | null;
+    created_at: string | null;
+    updated_at: string | null;
+    sku: string | null;
+    barcode: string | null;
+    cost_per_item: number | null;
+    track_quantity: boolean | null;
+    continue_selling_when_out_of_stock: boolean | null;
+    weight: number | null;
+    weight_unit: string | null;
+    vendor: string | null;
+    product_type: string | null;
+    options: any | null;
+    variants: any | null;
+    charge_tax: boolean | null;
+    is_physical: boolean | null;
+}
+interface EcommapsCollection {
+    id: string;
+    site_id: string;
+    title: string;
+    description: string | null;
+    slug: string;
+    image_url: string | null;
+    is_active: boolean | null;
+    sort_order: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface PaginationMeta {
+    total: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+interface EcommapsCartItem {
+    id: string;
+    product_id: string;
+    variant_id: string | null;
+    product_name: string;
+    product_price: number;
+    product_image: string | null;
+    quantity: number;
+    subtotal: number;
+}
+interface EcommapsCart {
+    id: string;
+    site_id: string;
+    items: EcommapsCartItem[];
+    items_count: number;
+    subtotal: number;
+    created_at: string | null;
+}
+interface EcommapsCustomer {
+    id: string;
+    store_id: string;
+    email: string;
+    full_name: string;
+    phone: string | null;
+    addresses: any[];
+    created_at: string;
+}
+interface EcommapsAuthResponse {
+    token: string;
+    user: EcommapsCustomer;
+}
+
+declare class EcommapsAPIError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+declare const ecommapsClient: {
+    store: {
+        retrieve: (options?: RequestInit) => Promise<EcommapsSite>;
+        menus: (options?: RequestInit) => Promise<any>;
+    };
+    products: {
+        list: (params?: Record<string, string | number>, options?: RequestInit) => Promise<PaginatedResponse<EcommapsProduct>>;
+        retrieve: (slug: string, options?: RequestInit) => Promise<EcommapsProduct>;
+    };
+    collections: {
+        list: (options?: RequestInit) => Promise<{
+            data: EcommapsCollection[];
+        }>;
+        retrieve: (slug: string, limit?: number, offset?: number, options?: RequestInit) => Promise<{
+            collection: EcommapsCollection;
+            products: EcommapsProduct[];
+            pagination: any;
+        }>;
+    };
+    cart: {
+        create: (options?: RequestInit) => Promise<EcommapsCart>;
+        retrieve: (cartId: string, options?: RequestInit) => Promise<EcommapsCart>;
+        addItem: (cartId: string, body: {
+            product_id: string;
+            variant_id?: string;
+            quantity: number;
+        }, options?: RequestInit) => Promise<EcommapsCart>;
+        updateItem: (cartId: string, itemId: string, body: {
+            quantity: number;
+        }, options?: RequestInit) => Promise<EcommapsCart>;
+        removeItem: (cartId: string, itemId: string, options?: RequestInit) => Promise<EcommapsCart>;
+    };
+    orders: {
+        create: (body: any, options?: RequestInit) => Promise<any>;
+        retrieve: (orderNumber: string, options?: RequestInit) => Promise<any>;
+        list: (options?: RequestInit & {
+            params?: {
+                limit?: number;
+                offset?: number;
+            };
+        }) => Promise<{
+            data: any[];
+            pagination: any;
+        }>;
+    };
+    auth: {
+        login: (body: any, options?: RequestInit) => Promise<EcommapsAuthResponse>;
+        signup: (body: any, options?: RequestInit) => Promise<EcommapsAuthResponse>;
+        me: (options?: RequestInit) => Promise<{
+            customer: EcommapsCustomer;
+        }>;
+        addAddress: (body: any, options?: RequestInit) => Promise<{
+            success: boolean;
+            address: any;
+        }>;
+    };
+};
+
+export { EcommapsAPIError, type EcommapsAuthResponse, type EcommapsCart, type EcommapsCartItem, type EcommapsCollection, type EcommapsCustomer, type EcommapsProduct, type EcommapsProductVariant, type EcommapsSite, type PaginatedResponse, type PaginationMeta, ecommapsClient };

package/dist/index.js

@@ -0,0 +1,144 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EcommapsAPIError: () => EcommapsAPIError,
+  ecommapsClient: () => ecommapsClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var API_URL = process.env.NEXT_PUBLIC_ECOMMAPS_API_URL || "http://127.0.0.1:8001/api/v1/storefront";
+var API_KEY = process.env.ECOMMAPS_API_KEY || "";
+var EcommapsAPIError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "EcommapsAPIError";
+    this.status = status;
+  }
+};
+async function ecommapsFetch(endpoint, options) {
+  const url = `${API_URL}${endpoint}`;
+  const headers = {
+    "Content-Type": "application/json",
+    "x-api-key": API_KEY,
+    ...options?.headers || {}
+  };
+  const response = await fetch(url, {
+    ...options,
+    headers
+  });
+  if (!response.ok) {
+    let errorMessage = response.statusText;
+    try {
+      const errorData = await response.json();
+      errorMessage = errorData.detail || errorMessage;
+    } catch (e) {
+    }
+    console.error(`[EcommapsClient] ${response.status} error fetching ${url} - ${errorMessage}`);
+    throw new EcommapsAPIError(errorMessage, response.status);
+  }
+  return response.json();
+}
+var ecommapsClient = {
+  store: {
+    retrieve: (options) => ecommapsFetch("/store", options),
+    menus: (options) => ecommapsFetch("/store/menus", options)
+  },
+  products: {
+    list: (params, options) => {
+      const query = new URLSearchParams();
+      if (params) {
+        Object.entries(params).forEach(([key, value]) => {
+          if (value !== void 0 && value !== null) {
+            query.append(key, String(value));
+          }
+        });
+      }
+      return ecommapsFetch(
+        `/products?${query.toString()}`,
+        options
+      );
+    },
+    retrieve: (slug, options) => ecommapsFetch(`/products/${slug}`, options)
+  },
+  collections: {
+    list: (options) => ecommapsFetch("/collections", options),
+    retrieve: (slug, limit = 20, offset = 0, options) => ecommapsFetch(`/collections/${slug}?limit=${limit}&offset=${offset}`, options)
+  },
+  cart: {
+    create: (options) => ecommapsFetch("/cart", { ...options, method: "POST" }),
+    retrieve: (cartId, options) => ecommapsFetch(`/cart/${cartId}`, options),
+    addItem: (cartId, body, options) => ecommapsFetch(`/cart/${cartId}/items`, {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    updateItem: (cartId, itemId, body, options) => ecommapsFetch(`/cart/${cartId}/items/${itemId}`, {
+      ...options,
+      method: "PATCH",
+      body: JSON.stringify(body)
+    }),
+    removeItem: (cartId, itemId, options) => ecommapsFetch(`/cart/${cartId}/items/${itemId}`, {
+      ...options,
+      method: "DELETE"
+    })
+  },
+  orders: {
+    create: (body, options) => ecommapsFetch("/orders", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    retrieve: (orderNumber, options) => ecommapsFetch(`/orders/${orderNumber}`, options),
+    list: (options) => {
+      const searchParams = new URLSearchParams();
+      if (options?.params?.limit) searchParams.append("limit", options.params.limit.toString());
+      if (options?.params?.offset) searchParams.append("offset", options.params.offset.toString());
+      const qs = searchParams.toString() ? `?${searchParams.toString()}` : "";
+      return ecommapsFetch(`/orders${qs}`, options);
+    }
+  },
+  auth: {
+    login: (body, options) => ecommapsFetch("/auth/login", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    signup: (body, options) => ecommapsFetch("/auth/signup", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    me: (options) => ecommapsFetch("/auth/me", options),
+    addAddress: (body, options) => ecommapsFetch("/auth/me/addresses", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    })
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EcommapsAPIError,
+  ecommapsClient
+});

package/dist/index.mjs

@@ -0,0 +1,116 @@
+// src/client.ts
+var API_URL = process.env.NEXT_PUBLIC_ECOMMAPS_API_URL || "http://127.0.0.1:8001/api/v1/storefront";
+var API_KEY = process.env.ECOMMAPS_API_KEY || "";
+var EcommapsAPIError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "EcommapsAPIError";
+    this.status = status;
+  }
+};
+async function ecommapsFetch(endpoint, options) {
+  const url = `${API_URL}${endpoint}`;
+  const headers = {
+    "Content-Type": "application/json",
+    "x-api-key": API_KEY,
+    ...options?.headers || {}
+  };
+  const response = await fetch(url, {
+    ...options,
+    headers
+  });
+  if (!response.ok) {
+    let errorMessage = response.statusText;
+    try {
+      const errorData = await response.json();
+      errorMessage = errorData.detail || errorMessage;
+    } catch (e) {
+    }
+    console.error(`[EcommapsClient] ${response.status} error fetching ${url} - ${errorMessage}`);
+    throw new EcommapsAPIError(errorMessage, response.status);
+  }
+  return response.json();
+}
+var ecommapsClient = {
+  store: {
+    retrieve: (options) => ecommapsFetch("/store", options),
+    menus: (options) => ecommapsFetch("/store/menus", options)
+  },
+  products: {
+    list: (params, options) => {
+      const query = new URLSearchParams();
+      if (params) {
+        Object.entries(params).forEach(([key, value]) => {
+          if (value !== void 0 && value !== null) {
+            query.append(key, String(value));
+          }
+        });
+      }
+      return ecommapsFetch(
+        `/products?${query.toString()}`,
+        options
+      );
+    },
+    retrieve: (slug, options) => ecommapsFetch(`/products/${slug}`, options)
+  },
+  collections: {
+    list: (options) => ecommapsFetch("/collections", options),
+    retrieve: (slug, limit = 20, offset = 0, options) => ecommapsFetch(`/collections/${slug}?limit=${limit}&offset=${offset}`, options)
+  },
+  cart: {
+    create: (options) => ecommapsFetch("/cart", { ...options, method: "POST" }),
+    retrieve: (cartId, options) => ecommapsFetch(`/cart/${cartId}`, options),
+    addItem: (cartId, body, options) => ecommapsFetch(`/cart/${cartId}/items`, {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    updateItem: (cartId, itemId, body, options) => ecommapsFetch(`/cart/${cartId}/items/${itemId}`, {
+      ...options,
+      method: "PATCH",
+      body: JSON.stringify(body)
+    }),
+    removeItem: (cartId, itemId, options) => ecommapsFetch(`/cart/${cartId}/items/${itemId}`, {
+      ...options,
+      method: "DELETE"
+    })
+  },
+  orders: {
+    create: (body, options) => ecommapsFetch("/orders", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    retrieve: (orderNumber, options) => ecommapsFetch(`/orders/${orderNumber}`, options),
+    list: (options) => {
+      const searchParams = new URLSearchParams();
+      if (options?.params?.limit) searchParams.append("limit", options.params.limit.toString());
+      if (options?.params?.offset) searchParams.append("offset", options.params.offset.toString());
+      const qs = searchParams.toString() ? `?${searchParams.toString()}` : "";
+      return ecommapsFetch(`/orders${qs}`, options);
+    }
+  },
+  auth: {
+    login: (body, options) => ecommapsFetch("/auth/login", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    signup: (body, options) => ecommapsFetch("/auth/signup", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    }),
+    me: (options) => ecommapsFetch("/auth/me", options),
+    addAddress: (body, options) => ecommapsFetch("/auth/me/addresses", {
+      ...options,
+      method: "POST",
+      body: JSON.stringify(body)
+    })
+  }
+};
+export {
+  EcommapsAPIError,
+  ecommapsClient
+};

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@ecommaps/client",
+  "version": "1.1.0",
+  "description": "The official JS SDK for Ecommaps Headless Storefronts.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist node_modules"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.5"
+  },
+  "author": "EcoBaseAI",
+  "license": "ISC"
+}

package/package.json.bak

@@ -0,0 +1,13 @@
+{
+  "name": "ecommaps-client",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.24.0"
+}

package/src/client.ts

@@ -0,0 +1,149 @@
+import {
+    EcommapsProduct,
+    EcommapsCollection,
+    EcommapsSite,
+    EcommapsCart,
+    PaginatedResponse,
+} from "./types"
+
+const API_URL =
+    process.env.NEXT_PUBLIC_ECOMMAPS_API_URL ||
+    "http://127.0.0.1:8001/api/v1/storefront"
+const API_KEY = process.env.ECOMMAPS_API_KEY || ""
+
+export class EcommapsAPIError extends Error {
+    public status: number
+    constructor(message: string, status: number) {
+        super(message)
+        this.name = "EcommapsAPIError"
+        this.status = status
+    }
+}
+
+async function ecommapsFetch<T>(
+    endpoint: string,
+    options?: RequestInit
+): Promise<T> {
+    const url = `${API_URL}${endpoint}`
+
+    const headers: HeadersInit = {
+        "Content-Type": "application/json",
+        "x-api-key": API_KEY,
+        ...(options?.headers || {}),
+    }
+
+    const response = await fetch(url, {
+        ...options,
+        headers,
+    })
+
+    if (!response.ok) {
+        let errorMessage = response.statusText
+        try {
+            const errorData = await response.json()
+            errorMessage = errorData.detail || errorMessage
+        } catch (e) {
+            // Ignore
+        }
+        console.error(`[EcommapsClient] ${response.status} error fetching ${url} - ${errorMessage}`);
+        throw new EcommapsAPIError(errorMessage, response.status)
+    }
+
+    return response.json()
+}
+
+export const ecommapsClient = {
+    store: {
+        retrieve: (options?: RequestInit) => ecommapsFetch<EcommapsSite>("/store", options),
+        menus: (options?: RequestInit) => ecommapsFetch<any>("/store/menus", options),
+    },
+    products: {
+        list: (params?: Record<string, string | number>, options?: RequestInit) => {
+            const query = new URLSearchParams()
+            if (params) {
+                Object.entries(params).forEach(([key, value]) => {
+                    if (value !== undefined && value !== null) {
+                        query.append(key, String(value))
+                    }
+                })
+            }
+            return ecommapsFetch<PaginatedResponse<EcommapsProduct>>(
+                `/products?${query.toString()}`,
+                options
+            )
+        },
+        retrieve: (slug: string, options?: RequestInit) =>
+            ecommapsFetch<EcommapsProduct>(`/products/${slug}`, options),
+    },
+    collections: {
+        list: (options?: RequestInit) => ecommapsFetch<{ data: EcommapsCollection[] }>("/collections", options),
+        retrieve: (slug: string, limit = 20, offset = 0, options?: RequestInit) =>
+            ecommapsFetch<{
+                collection: EcommapsCollection
+                products: EcommapsProduct[]
+                pagination: any
+            }>(`/collections/${slug}?limit=${limit}&offset=${offset}`, options),
+    },
+    cart: {
+        create: (options?: RequestInit) =>
+            ecommapsFetch<EcommapsCart>("/cart", { ...options, method: "POST" }),
+        retrieve: (cartId: string, options?: RequestInit) =>
+            ecommapsFetch<EcommapsCart>(`/cart/${cartId}`, options),
+        addItem: (cartId: string, body: { product_id: string; variant_id?: string; quantity: number }, options?: RequestInit) =>
+            ecommapsFetch<EcommapsCart>(`/cart/${cartId}/items`, {
+                ...options,
+                method: "POST",
+                body: JSON.stringify(body),
+            }),
+        updateItem: (cartId: string, itemId: string, body: { quantity: number }, options?: RequestInit) =>
+            ecommapsFetch<EcommapsCart>(`/cart/${cartId}/items/${itemId}`, {
+                ...options,
+                method: "PATCH",
+                body: JSON.stringify(body),
+            }),
+        removeItem: (cartId: string, itemId: string, options?: RequestInit) =>
+            ecommapsFetch<EcommapsCart>(`/cart/${cartId}/items/${itemId}`, {
+                ...options,
+                method: "DELETE",
+            }),
+    },
+    orders: {
+        create: (body: any, options?: RequestInit) =>
+            ecommapsFetch<any>("/orders", {
+                ...options,
+                method: "POST",
+                body: JSON.stringify(body),
+            }),
+        retrieve: (orderNumber: string, options?: RequestInit) =>
+            ecommapsFetch<any>(`/orders/${orderNumber}`, options),
+        list: (options?: RequestInit & { params?: { limit?: number; offset?: number } }) => {
+            const searchParams = new URLSearchParams()
+            if (options?.params?.limit) searchParams.append("limit", options.params.limit.toString())
+            if (options?.params?.offset) searchParams.append("offset", options.params.offset.toString())
+            const qs = searchParams.toString() ? `?${searchParams.toString()}` : ""
+            return ecommapsFetch<{ data: any[]; pagination: any }>(`/orders${qs}`, options)
+        },
+    },
+    auth: {
+        login: (body: any, options?: RequestInit) =>
+            ecommapsFetch<import("./types").EcommapsAuthResponse>("/auth/login", {
+                ...options,
+                method: "POST",
+                body: JSON.stringify(body),
+            }),
+        signup: (body: any, options?: RequestInit) =>
+            ecommapsFetch<import("./types").EcommapsAuthResponse>("/auth/signup", {
+                ...options,
+                method: "POST",
+                body: JSON.stringify(body),
+            }),
+        me: (options?: RequestInit) =>
+            ecommapsFetch<{ customer: import("./types").EcommapsCustomer }>("/auth/me", options),
+        addAddress: (body: any, options?: RequestInit) =>
+            ecommapsFetch<{ success: boolean; address: any }>("/auth/me/addresses", {
+                ...options,
+                method: "POST",
+                body: JSON.stringify(body),
+            }),
+    },
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./client";

package/src/types.ts

@@ -0,0 +1,113 @@
+export interface EcommapsSite {
+    id: string
+    name: string
+    slug: string
+    description: string | null
+    logo_url: string | null
+    custom_domain: string | null
+    theme: any | null
+    theme_settings: any | null
+    settings: any | null
+    contact_info: any | null
+    social_links: any | null
+}
+
+export interface EcommapsProductVariant {
+    title: string
+    prices: any[]
+    options: any[]
+    inventory_quantity: number
+    sku: string | null
+    id?: string
+}
+
+export interface EcommapsProduct {
+    id: string
+    site_id: string
+    name: string
+    slug: string
+    description: string | null
+    price: number
+    compare_at_price: number | null
+    currency: string | null
+    images: any | null
+    category: string | null
+    tags: string[] | null
+    inventory_quantity: number | null
+    is_active: boolean | null
+    created_at: string | null
+    updated_at: string | null
+    sku: string | null
+    barcode: string | null
+    cost_per_item: number | null
+    track_quantity: boolean | null
+    continue_selling_when_out_of_stock: boolean | null
+    weight: number | null
+    weight_unit: string | null
+    vendor: string | null
+    product_type: string | null
+    options: any | null
+    variants: any | null
+    charge_tax: boolean | null
+    is_physical: boolean | null
+}
+
+export interface EcommapsCollection {
+    id: string
+    site_id: string
+    title: string
+    description: string | null
+    slug: string
+    image_url: string | null
+    is_active: boolean | null
+    sort_order: string | null
+    created_at: string
+    updated_at: string
+}
+
+export interface PaginationMeta {
+    total: number
+    limit: number
+    offset: number
+    has_more: boolean
+}
+
+export interface PaginatedResponse<T> {
+    data: T[]
+    pagination: PaginationMeta
+}
+
+export interface EcommapsCartItem {
+    id: string
+    product_id: string
+    variant_id: string | null
+    product_name: string
+    product_price: number
+    product_image: string | null
+    quantity: number
+    subtotal: number
+}
+
+export interface EcommapsCart {
+    id: string
+    site_id: string
+    items: EcommapsCartItem[]
+    items_count: number
+    subtotal: number
+    created_at: string | null
+}
+
+export interface EcommapsCustomer {
+    id: string
+    store_id: string
+    email: string
+    full_name: string
+    phone: string | null
+    addresses: any[]
+    created_at: string
+}
+
+export interface EcommapsAuthResponse {
+    token: string
+    user: EcommapsCustomer
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true
+  },
+  "include": [
+    "src/**/*"
+  ]
+}