@buiducnhat/ritel-sdk 0.1.0

package/README.md

@@ -0,0 +1,185 @@
+# @ritel/sdk
+
+TypeScript SDK for Ritel Mini ERP external APIs.
+
+## Installation
+
+```bash
+npm install @ritel/sdk
+# or
+bun add @ritel/sdk
+# or
+pnpm add @ritel/sdk
+```
+
+## Quick Start
+
+```typescript
+import { RitelClient } from "@ritel/sdk";
+
+const client = new RitelClient({
+  baseUrl: "https://your-ritel-server.com",
+  apiKey: "your-api-key",
+});
+
+// List products
+const products = await client.products.list({
+  limit: 20,
+  stockStatus: "in_stock",
+});
+
+// Create an order
+const order = await client.orders.create({
+  customerName: "John Doe",
+  customerPhone: "+84901234567",
+  items: [
+    { productId: "prod_123", quantity: 2, unitPrice: 50000 },
+  ],
+  paymentMethod: "bank_transfer",
+});
+
+console.log(order.vietQrUrl); // QR code for payment
+```
+
+## API Reference
+
+### RitelClient
+
+```typescript
+const client = new RitelClient({
+  baseUrl: string;    // Required: API base URL
+  apiKey: string;     // Required: Your API key
+  timeout?: number;   // Optional: Request timeout in ms (default: 30000)
+});
+```
+
+### Products
+
+#### `client.products.list(params?)`
+
+List products with optional filters.
+
+```typescript
+const response = await client.products.list({
+  limit: 20,           // 1-100, default 20
+  offset: 0,           // Pagination offset
+  search: "shirt",     // Search by name or SKU
+  categoryId: "cat_1", // Filter by category
+  stockStatus: "in_stock", // "in_stock" | "out_of_stock" | "all"
+  minPrice: 10000,     // Min price filter
+  maxPrice: 100000,    // Max price filter
+  sortBy: "price",     // "name" | "price" | "created_at"
+  sortOrder: "asc",    // "asc" | "desc"
+});
+
+// Response
+{
+  data: Product[],
+  pagination: { total, limit, offset, hasMore }
+}
+```
+
+### Orders
+
+#### `client.orders.create(input)`
+
+Create a new order.
+
+```typescript
+const order = await client.orders.create({
+  customerName: "John Doe",
+  customerPhone: "+84901234567",
+  customerEmail: "john@example.com",  // Optional
+  customerAddress: "123 Main St",     // Optional
+  items: [
+    { productId: "prod_123", quantity: 2, unitPrice: 50000 },
+  ],
+  paymentMethod: "cash" | "bank_transfer" | "sepay_pg",
+  notes: "Gift wrap please",          // Optional
+  expectedDeliveryDate: "2024-01-20", // Optional
+});
+
+// Response includes vietQrUrl for bank_transfer
+```
+
+#### `client.orders.list(params?)`
+
+List orders with optional filters.
+
+```typescript
+const response = await client.orders.list({
+  limit: 20,
+  offset: 0,
+  status: "pending",        // "pending" | "completed" | "cancelled"
+  paymentStatus: "pending", // "pending" | "paid" | "failed"
+  orderNumber: "ORD-001",   // Exact match
+});
+```
+
+#### `client.orders.get(id)`
+
+Get order by ID.
+
+```typescript
+const order = await client.orders.get("order_abc123");
+```
+
+#### `client.orders.update(id, input)`
+
+Update an order.
+
+```typescript
+const order = await client.orders.update("order_abc123", {
+  notes: "Updated notes",
+  deliveryInfo: {
+    name: "Jane Doe",
+    phone: "+84909876543",
+    address: "456 Other St",
+  },
+});
+```
+
+#### `client.orders.cancel(id)`
+
+Cancel an order.
+
+```typescript
+const order = await client.orders.cancel("order_abc123");
+```
+
+## Error Handling
+
+```typescript
+import { RitelApiError, RitelNetworkError } from "@ritel/sdk";
+
+try {
+  await client.orders.create(input);
+} catch (error) {
+  if (error instanceof RitelApiError) {
+    console.error(`API Error ${error.status}: ${error.message}`);
+    // error.status - HTTP status code
+    // error.code - Error code from API
+    // error.message - Error message
+  } else if (error instanceof RitelNetworkError) {
+    console.error(`Network Error: ${error.message}`);
+  }
+}
+```
+
+## TypeScript
+
+All types are exported:
+
+```typescript
+import type {
+  Product,
+  Order,
+  CreateOrderInput,
+  GetProductsParams,
+  // ... more
+} from "@ritel/sdk";
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,135 @@
+
+//#region src/errors.ts
+var RitelError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "RitelError";
+	}
+};
+var RitelApiError = class extends RitelError {
+	status;
+	code;
+	constructor(status, code, message) {
+		super(message);
+		this.name = "RitelApiError";
+		this.status = status;
+		this.code = code;
+	}
+};
+var RitelNetworkError = class extends RitelError {
+	cause;
+	constructor(message, cause) {
+		super(message);
+		this.name = "RitelNetworkError";
+		this.cause = cause;
+	}
+};
+
+//#endregion
+//#region src/resources/orders.ts
+var OrdersResource = class {
+	request;
+	constructor(request) {
+		this.request = request;
+	}
+	async create(input) {
+		return this.request("POST", "/orders", input);
+	}
+	async list(params = {}) {
+		return this.request("GET", "/orders", void 0, params);
+	}
+	async get(id) {
+		return this.request("GET", `/orders/${id}`);
+	}
+	async update(id, input) {
+		return this.request("PATCH", `/orders/${id}`, input);
+	}
+	async cancel(id) {
+		return this.request("POST", `/orders/${id}/cancel`);
+	}
+};
+
+//#endregion
+//#region src/resources/products.ts
+var ProductsResource = class {
+	request;
+	constructor(request) {
+		this.request = request;
+	}
+	async list(params = {}) {
+		return this.request("GET", "/products", void 0, params);
+	}
+};
+
+//#endregion
+//#region src/utils/query-string.ts
+function buildQueryString(params) {
+	const searchParams = new URLSearchParams();
+	for (const [key, value] of Object.entries(params)) {
+		if (value === void 0 || value === null) continue;
+		if (value instanceof Date) searchParams.set(key, value.toISOString());
+		else searchParams.set(key, String(value));
+	}
+	const qs = searchParams.toString();
+	return qs ? `?${qs}` : "";
+}
+
+//#endregion
+//#region src/client.ts
+var RitelClient = class {
+	baseUrl;
+	apiKey;
+	timeout;
+	products;
+	orders;
+	constructor(config) {
+		this.baseUrl = config.baseUrl.replace(/\/$/, "");
+		this.apiKey = config.apiKey;
+		this.timeout = config.timeout ?? 3e4;
+		const boundRequest = this.request.bind(this);
+		this.products = new ProductsResource(boundRequest);
+		this.orders = new OrdersResource(boundRequest);
+	}
+	async request(method, path, body, params) {
+		const url = `${this.baseUrl}/external${path}${params ? buildQueryString(params) : ""}`;
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+		try {
+			const response = await fetch(url, {
+				method,
+				headers: {
+					"Content-Type": "application/json",
+					"X-API-Key": this.apiKey
+				},
+				body: body ? JSON.stringify(body) : void 0,
+				signal: controller.signal
+			});
+			clearTimeout(timeoutId);
+			if (!response.ok) {
+				const errorBody = await response.json().catch(() => ({
+					error: "Unknown",
+					message: response.statusText
+				}));
+				throw new RitelApiError(response.status, errorBody.error, errorBody.message);
+			}
+			return response.json();
+		} catch (error) {
+			clearTimeout(timeoutId);
+			if (error instanceof RitelApiError) throw error;
+			if (error instanceof Error) {
+				if (error.name === "AbortError") throw new RitelNetworkError("Request timeout", error);
+				throw new RitelNetworkError(error.message, error);
+			}
+			throw new RitelNetworkError("Unknown network error");
+		}
+	}
+};
+
+//#endregion
+exports.OrdersResource = OrdersResource;
+exports.ProductsResource = ProductsResource;
+exports.RitelApiError = RitelApiError;
+exports.RitelClient = RitelClient;
+exports.RitelError = RitelError;
+exports.RitelNetworkError = RitelNetworkError;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/errors.ts","../src/resources/orders.ts","../src/resources/products.ts","../src/utils/query-string.ts","../src/client.ts"],"sourcesContent":["export class RitelError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"RitelError\";\n  }\n}\n\nexport class RitelApiError extends RitelError {\n  readonly status: number;\n  readonly code: string;\n\n  constructor(status: number, code: string, message: string) {\n    super(message);\n    this.name = \"RitelApiError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class RitelNetworkError extends RitelError {\n  readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"RitelNetworkError\";\n    this.cause = cause;\n  }\n}\n","import type {\n  CreateOrderInput,\n  ListOrdersParams,\n  Order,\n  OrderCreateResponse,\n  OrdersListResponse,\n  UpdateOrderInput,\n} from \"../types\";\n\nexport type RequestFn = <T>(\n  method: string,\n  path: string,\n  body?: unknown,\n  params?: Record<string, unknown>\n) => Promise<T>;\n\nexport class OrdersResource {\n  private readonly request: RequestFn;\n\n  constructor(request: RequestFn) {\n    this.request = request;\n  }\n\n  async create(input: CreateOrderInput): Promise<OrderCreateResponse> {\n    return this.request<OrderCreateResponse>(\"POST\", \"/orders\", input);\n  }\n\n  async list(params: ListOrdersParams = {}): Promise<OrdersListResponse> {\n    return this.request<OrdersListResponse>(\n      \"GET\",\n      \"/orders\",\n      undefined,\n      params as Record<string, unknown>\n    );\n  }\n\n  async get(id: string): Promise<Order> {\n    return this.request<Order>(\"GET\", `/orders/${id}`);\n  }\n\n  async update(id: string, input: UpdateOrderInput): Promise<Order> {\n    return this.request<Order>(\"PATCH\", `/orders/${id}`, input);\n  }\n\n  async cancel(id: string): Promise<Order> {\n    return this.request<Order>(\"POST\", `/orders/${id}/cancel`);\n  }\n}\n","import type { GetProductsParams, ProductsListResponse } from \"../types\";\n\nexport type RequestFn = <T>(\n  method: string,\n  path: string,\n  body?: unknown,\n  params?: Record<string, unknown>\n) => Promise<T>;\n\nexport class ProductsResource {\n  private readonly request: RequestFn;\n\n  constructor(request: RequestFn) {\n    this.request = request;\n  }\n\n  async list(params: GetProductsParams = {}): Promise<ProductsListResponse> {\n    return this.request<ProductsListResponse>(\n      \"GET\",\n      \"/products\",\n      undefined,\n      params as Record<string, unknown>\n    );\n  }\n}\n","export function buildQueryString(params: Record<string, unknown>): string {\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    if (value instanceof Date) {\n      searchParams.set(key, value.toISOString());\n    } else {\n      searchParams.set(key, String(value));\n    }\n  }\n\n  const qs = searchParams.toString();\n  return qs ? `?${qs}` : \"\";\n}\n","import { RitelApiError, RitelNetworkError } from \"./errors\";\nimport { OrdersResource } from \"./resources/orders\";\nimport { ProductsResource } from \"./resources/products\";\nimport type { ApiErrorResponse, RitelClientConfig } from \"./types\";\nimport { buildQueryString } from \"./utils/query-string\";\n\nexport class RitelClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n\n  readonly products: ProductsResource;\n  readonly orders: OrdersResource;\n\n  constructor(config: RitelClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout ?? 30_000;\n\n    // Bind request method for resources\n    const boundRequest = this.request.bind(this);\n    this.products = new ProductsResource(boundRequest);\n    this.orders = new OrdersResource(boundRequest);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    params?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `${this.baseUrl}/external${path}${params ? buildQueryString(params) : \"\"}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.apiKey,\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        const errorBody = (await response.json().catch(() => ({\n          error: \"Unknown\",\n          message: response.statusText,\n        }))) as ApiErrorResponse;\n\n        throw new RitelApiError(\n          response.status,\n          errorBody.error,\n          errorBody.message\n        );\n      }\n\n      return response.json() as Promise<T>;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof RitelApiError) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        if (error.name === \"AbortError\") {\n          throw new RitelNetworkError(\"Request timeout\", error);\n        }\n        throw new RitelNetworkError(error.message, error);\n      }\n\n      throw new RitelNetworkError(\"Unknown network error\");\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,172 @@
+//#region src/types.d.ts
+interface GetProductsParams {
+  limit?: number;
+  offset?: number;
+  search?: string;
+  categoryId?: string;
+  stockStatus?: "in_stock" | "out_of_stock" | "all";
+  minPrice?: number;
+  maxPrice?: number;
+  sortBy?: "name" | "price" | "created_at";
+  sortOrder?: "asc" | "desc";
+}
+interface ProductCategory {
+  id: string;
+  name: string;
+}
+interface Product {
+  id: string;
+  name: string;
+  sku: string | null;
+  salePrice: number;
+  currentSalePrice: number | null;
+  imageUrl: string | null;
+  description: string | null;
+  unit: string | null;
+  category: ProductCategory | null;
+  customProperties: Record<string, unknown> | null;
+  stockQuantity: number;
+}
+interface ProductsListResponse {
+  data: Product[];
+  pagination: Pagination;
+}
+interface CreateOrderInput {
+  customerName: string;
+  customerPhone: string;
+  customerEmail?: string;
+  customerAddress?: string;
+  items: OrderItemInput[];
+  paymentMethod: "cash" | "bank_transfer" | "sepay_pg";
+  notes?: string;
+  expectedDeliveryDate?: Date | string;
+}
+interface OrderItemInput {
+  productId: string;
+  quantity: number;
+  unitPrice: number;
+}
+interface ListOrdersParams {
+  limit?: number;
+  offset?: number;
+  status?: "pending" | "completed" | "cancelled";
+  paymentStatus?: "pending" | "paid" | "failed";
+  orderNumber?: string;
+}
+interface UpdateOrderInput {
+  notes?: string;
+  expectedDeliveryDate?: Date | string | null;
+  deliveryInfo?: DeliveryInfo;
+}
+interface DeliveryInfo {
+  name: string;
+  phone: string;
+  email?: string | null;
+  address?: string | null;
+}
+interface OrderItem {
+  id: string;
+  productId: string;
+  productName: string;
+  productSku: string | null;
+  quantity: number;
+  unitPrice: number;
+  subtotal: number;
+}
+interface Order {
+  id: string;
+  orderNumber: string;
+  status: string;
+  paymentMethod: string | null;
+  paymentStatus: string | null;
+  subtotal: number;
+  discountAmount: number;
+  taxAmount: number;
+  total: number;
+  notes: string | null;
+  expectedDeliveryDate: string | null;
+  deliveryInfo: DeliveryInfo | null;
+  items?: OrderItem[];
+  createdAt: string;
+  updatedAt: string;
+}
+interface OrderCreateResponse {
+  id: string;
+  orderNumber: string;
+  total: number;
+  paymentMethod: string;
+  paymentStatus: string;
+  vietQrUrl: string | null;
+  bankInfo: {
+    bankBin: string | null;
+    bankAccountNumber: string | null;
+    bankAccountName: string | null;
+  } | null;
+}
+interface OrdersListResponse {
+  data: Order[];
+  pagination: Pagination;
+}
+interface Pagination {
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+}
+interface RitelClientConfig {
+  baseUrl: string;
+  apiKey: string;
+  timeout?: number;
+}
+interface ApiErrorResponse {
+  error: string;
+  message: string;
+}
+//#endregion
+//#region src/resources/orders.d.ts
+type RequestFn$1 = <T>(method: string, path: string, body?: unknown, params?: Record<string, unknown>) => Promise<T>;
+declare class OrdersResource {
+  private readonly request;
+  constructor(request: RequestFn$1);
+  create(input: CreateOrderInput): Promise<OrderCreateResponse>;
+  list(params?: ListOrdersParams): Promise<OrdersListResponse>;
+  get(id: string): Promise<Order>;
+  update(id: string, input: UpdateOrderInput): Promise<Order>;
+  cancel(id: string): Promise<Order>;
+}
+//#endregion
+//#region src/resources/products.d.ts
+type RequestFn = <T>(method: string, path: string, body?: unknown, params?: Record<string, unknown>) => Promise<T>;
+declare class ProductsResource {
+  private readonly request;
+  constructor(request: RequestFn);
+  list(params?: GetProductsParams): Promise<ProductsListResponse>;
+}
+//#endregion
+//#region src/client.d.ts
+declare class RitelClient {
+  private readonly baseUrl;
+  private readonly apiKey;
+  private readonly timeout;
+  readonly products: ProductsResource;
+  readonly orders: OrdersResource;
+  constructor(config: RitelClientConfig);
+  private request;
+}
+//#endregion
+//#region src/errors.d.ts
+declare class RitelError extends Error {
+  constructor(message: string);
+}
+declare class RitelApiError extends RitelError {
+  readonly status: number;
+  readonly code: string;
+  constructor(status: number, code: string, message: string);
+}
+declare class RitelNetworkError extends RitelError {
+  readonly cause?: Error;
+  constructor(message: string, cause?: Error);
+}
+//#endregion
+export { type ApiErrorResponse, type CreateOrderInput, type DeliveryInfo, type GetProductsParams, type ListOrdersParams, type Order, type OrderCreateResponse, type OrderItem, type OrderItemInput, type OrdersListResponse, OrdersResource, type Pagination, type Product, type ProductCategory, type ProductsListResponse, ProductsResource, RitelApiError, RitelClient, type RitelClientConfig, RitelError, RitelNetworkError, type UpdateOrderInput };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/resources/orders.ts","../src/resources/products.ts","../src/client.ts","../src/errors.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,172 @@
+//#region src/types.d.ts
+interface GetProductsParams {
+  limit?: number;
+  offset?: number;
+  search?: string;
+  categoryId?: string;
+  stockStatus?: "in_stock" | "out_of_stock" | "all";
+  minPrice?: number;
+  maxPrice?: number;
+  sortBy?: "name" | "price" | "created_at";
+  sortOrder?: "asc" | "desc";
+}
+interface ProductCategory {
+  id: string;
+  name: string;
+}
+interface Product {
+  id: string;
+  name: string;
+  sku: string | null;
+  salePrice: number;
+  currentSalePrice: number | null;
+  imageUrl: string | null;
+  description: string | null;
+  unit: string | null;
+  category: ProductCategory | null;
+  customProperties: Record<string, unknown> | null;
+  stockQuantity: number;
+}
+interface ProductsListResponse {
+  data: Product[];
+  pagination: Pagination;
+}
+interface CreateOrderInput {
+  customerName: string;
+  customerPhone: string;
+  customerEmail?: string;
+  customerAddress?: string;
+  items: OrderItemInput[];
+  paymentMethod: "cash" | "bank_transfer" | "sepay_pg";
+  notes?: string;
+  expectedDeliveryDate?: Date | string;
+}
+interface OrderItemInput {
+  productId: string;
+  quantity: number;
+  unitPrice: number;
+}
+interface ListOrdersParams {
+  limit?: number;
+  offset?: number;
+  status?: "pending" | "completed" | "cancelled";
+  paymentStatus?: "pending" | "paid" | "failed";
+  orderNumber?: string;
+}
+interface UpdateOrderInput {
+  notes?: string;
+  expectedDeliveryDate?: Date | string | null;
+  deliveryInfo?: DeliveryInfo;
+}
+interface DeliveryInfo {
+  name: string;
+  phone: string;
+  email?: string | null;
+  address?: string | null;
+}
+interface OrderItem {
+  id: string;
+  productId: string;
+  productName: string;
+  productSku: string | null;
+  quantity: number;
+  unitPrice: number;
+  subtotal: number;
+}
+interface Order {
+  id: string;
+  orderNumber: string;
+  status: string;
+  paymentMethod: string | null;
+  paymentStatus: string | null;
+  subtotal: number;
+  discountAmount: number;
+  taxAmount: number;
+  total: number;
+  notes: string | null;
+  expectedDeliveryDate: string | null;
+  deliveryInfo: DeliveryInfo | null;
+  items?: OrderItem[];
+  createdAt: string;
+  updatedAt: string;
+}
+interface OrderCreateResponse {
+  id: string;
+  orderNumber: string;
+  total: number;
+  paymentMethod: string;
+  paymentStatus: string;
+  vietQrUrl: string | null;
+  bankInfo: {
+    bankBin: string | null;
+    bankAccountNumber: string | null;
+    bankAccountName: string | null;
+  } | null;
+}
+interface OrdersListResponse {
+  data: Order[];
+  pagination: Pagination;
+}
+interface Pagination {
+  total: number;
+  limit: number;
+  offset: number;
+  hasMore: boolean;
+}
+interface RitelClientConfig {
+  baseUrl: string;
+  apiKey: string;
+  timeout?: number;
+}
+interface ApiErrorResponse {
+  error: string;
+  message: string;
+}
+//#endregion
+//#region src/resources/orders.d.ts
+type RequestFn$1 = <T>(method: string, path: string, body?: unknown, params?: Record<string, unknown>) => Promise<T>;
+declare class OrdersResource {
+  private readonly request;
+  constructor(request: RequestFn$1);
+  create(input: CreateOrderInput): Promise<OrderCreateResponse>;
+  list(params?: ListOrdersParams): Promise<OrdersListResponse>;
+  get(id: string): Promise<Order>;
+  update(id: string, input: UpdateOrderInput): Promise<Order>;
+  cancel(id: string): Promise<Order>;
+}
+//#endregion
+//#region src/resources/products.d.ts
+type RequestFn = <T>(method: string, path: string, body?: unknown, params?: Record<string, unknown>) => Promise<T>;
+declare class ProductsResource {
+  private readonly request;
+  constructor(request: RequestFn);
+  list(params?: GetProductsParams): Promise<ProductsListResponse>;
+}
+//#endregion
+//#region src/client.d.ts
+declare class RitelClient {
+  private readonly baseUrl;
+  private readonly apiKey;
+  private readonly timeout;
+  readonly products: ProductsResource;
+  readonly orders: OrdersResource;
+  constructor(config: RitelClientConfig);
+  private request;
+}
+//#endregion
+//#region src/errors.d.ts
+declare class RitelError extends Error {
+  constructor(message: string);
+}
+declare class RitelApiError extends RitelError {
+  readonly status: number;
+  readonly code: string;
+  constructor(status: number, code: string, message: string);
+}
+declare class RitelNetworkError extends RitelError {
+  readonly cause?: Error;
+  constructor(message: string, cause?: Error);
+}
+//#endregion
+export { type ApiErrorResponse, type CreateOrderInput, type DeliveryInfo, type GetProductsParams, type ListOrdersParams, type Order, type OrderCreateResponse, type OrderItem, type OrderItemInput, type OrdersListResponse, OrdersResource, type Pagination, type Product, type ProductCategory, type ProductsListResponse, ProductsResource, RitelApiError, RitelClient, type RitelClientConfig, RitelError, RitelNetworkError, type UpdateOrderInput };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/resources/orders.ts","../src/resources/products.ts","../src/client.ts","../src/errors.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,129 @@
+//#region src/errors.ts
+var RitelError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "RitelError";
+	}
+};
+var RitelApiError = class extends RitelError {
+	status;
+	code;
+	constructor(status, code, message) {
+		super(message);
+		this.name = "RitelApiError";
+		this.status = status;
+		this.code = code;
+	}
+};
+var RitelNetworkError = class extends RitelError {
+	cause;
+	constructor(message, cause) {
+		super(message);
+		this.name = "RitelNetworkError";
+		this.cause = cause;
+	}
+};
+
+//#endregion
+//#region src/resources/orders.ts
+var OrdersResource = class {
+	request;
+	constructor(request) {
+		this.request = request;
+	}
+	async create(input) {
+		return this.request("POST", "/orders", input);
+	}
+	async list(params = {}) {
+		return this.request("GET", "/orders", void 0, params);
+	}
+	async get(id) {
+		return this.request("GET", `/orders/${id}`);
+	}
+	async update(id, input) {
+		return this.request("PATCH", `/orders/${id}`, input);
+	}
+	async cancel(id) {
+		return this.request("POST", `/orders/${id}/cancel`);
+	}
+};
+
+//#endregion
+//#region src/resources/products.ts
+var ProductsResource = class {
+	request;
+	constructor(request) {
+		this.request = request;
+	}
+	async list(params = {}) {
+		return this.request("GET", "/products", void 0, params);
+	}
+};
+
+//#endregion
+//#region src/utils/query-string.ts
+function buildQueryString(params) {
+	const searchParams = new URLSearchParams();
+	for (const [key, value] of Object.entries(params)) {
+		if (value === void 0 || value === null) continue;
+		if (value instanceof Date) searchParams.set(key, value.toISOString());
+		else searchParams.set(key, String(value));
+	}
+	const qs = searchParams.toString();
+	return qs ? `?${qs}` : "";
+}
+
+//#endregion
+//#region src/client.ts
+var RitelClient = class {
+	baseUrl;
+	apiKey;
+	timeout;
+	products;
+	orders;
+	constructor(config) {
+		this.baseUrl = config.baseUrl.replace(/\/$/, "");
+		this.apiKey = config.apiKey;
+		this.timeout = config.timeout ?? 3e4;
+		const boundRequest = this.request.bind(this);
+		this.products = new ProductsResource(boundRequest);
+		this.orders = new OrdersResource(boundRequest);
+	}
+	async request(method, path, body, params) {
+		const url = `${this.baseUrl}/external${path}${params ? buildQueryString(params) : ""}`;
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+		try {
+			const response = await fetch(url, {
+				method,
+				headers: {
+					"Content-Type": "application/json",
+					"X-API-Key": this.apiKey
+				},
+				body: body ? JSON.stringify(body) : void 0,
+				signal: controller.signal
+			});
+			clearTimeout(timeoutId);
+			if (!response.ok) {
+				const errorBody = await response.json().catch(() => ({
+					error: "Unknown",
+					message: response.statusText
+				}));
+				throw new RitelApiError(response.status, errorBody.error, errorBody.message);
+			}
+			return response.json();
+		} catch (error) {
+			clearTimeout(timeoutId);
+			if (error instanceof RitelApiError) throw error;
+			if (error instanceof Error) {
+				if (error.name === "AbortError") throw new RitelNetworkError("Request timeout", error);
+				throw new RitelNetworkError(error.message, error);
+			}
+			throw new RitelNetworkError("Unknown network error");
+		}
+	}
+};
+
+//#endregion
+export { OrdersResource, ProductsResource, RitelApiError, RitelClient, RitelError, RitelNetworkError };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/resources/orders.ts","../src/resources/products.ts","../src/utils/query-string.ts","../src/client.ts"],"sourcesContent":["export class RitelError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"RitelError\";\n  }\n}\n\nexport class RitelApiError extends RitelError {\n  readonly status: number;\n  readonly code: string;\n\n  constructor(status: number, code: string, message: string) {\n    super(message);\n    this.name = \"RitelApiError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\nexport class RitelNetworkError extends RitelError {\n  readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"RitelNetworkError\";\n    this.cause = cause;\n  }\n}\n","import type {\n  CreateOrderInput,\n  ListOrdersParams,\n  Order,\n  OrderCreateResponse,\n  OrdersListResponse,\n  UpdateOrderInput,\n} from \"../types\";\n\nexport type RequestFn = <T>(\n  method: string,\n  path: string,\n  body?: unknown,\n  params?: Record<string, unknown>\n) => Promise<T>;\n\nexport class OrdersResource {\n  private readonly request: RequestFn;\n\n  constructor(request: RequestFn) {\n    this.request = request;\n  }\n\n  async create(input: CreateOrderInput): Promise<OrderCreateResponse> {\n    return this.request<OrderCreateResponse>(\"POST\", \"/orders\", input);\n  }\n\n  async list(params: ListOrdersParams = {}): Promise<OrdersListResponse> {\n    return this.request<OrdersListResponse>(\n      \"GET\",\n      \"/orders\",\n      undefined,\n      params as Record<string, unknown>\n    );\n  }\n\n  async get(id: string): Promise<Order> {\n    return this.request<Order>(\"GET\", `/orders/${id}`);\n  }\n\n  async update(id: string, input: UpdateOrderInput): Promise<Order> {\n    return this.request<Order>(\"PATCH\", `/orders/${id}`, input);\n  }\n\n  async cancel(id: string): Promise<Order> {\n    return this.request<Order>(\"POST\", `/orders/${id}/cancel`);\n  }\n}\n","import type { GetProductsParams, ProductsListResponse } from \"../types\";\n\nexport type RequestFn = <T>(\n  method: string,\n  path: string,\n  body?: unknown,\n  params?: Record<string, unknown>\n) => Promise<T>;\n\nexport class ProductsResource {\n  private readonly request: RequestFn;\n\n  constructor(request: RequestFn) {\n    this.request = request;\n  }\n\n  async list(params: GetProductsParams = {}): Promise<ProductsListResponse> {\n    return this.request<ProductsListResponse>(\n      \"GET\",\n      \"/products\",\n      undefined,\n      params as Record<string, unknown>\n    );\n  }\n}\n","export function buildQueryString(params: Record<string, unknown>): string {\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) {\n      continue;\n    }\n\n    if (value instanceof Date) {\n      searchParams.set(key, value.toISOString());\n    } else {\n      searchParams.set(key, String(value));\n    }\n  }\n\n  const qs = searchParams.toString();\n  return qs ? `?${qs}` : \"\";\n}\n","import { RitelApiError, RitelNetworkError } from \"./errors\";\nimport { OrdersResource } from \"./resources/orders\";\nimport { ProductsResource } from \"./resources/products\";\nimport type { ApiErrorResponse, RitelClientConfig } from \"./types\";\nimport { buildQueryString } from \"./utils/query-string\";\n\nexport class RitelClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly timeout: number;\n\n  readonly products: ProductsResource;\n  readonly orders: OrdersResource;\n\n  constructor(config: RitelClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.apiKey = config.apiKey;\n    this.timeout = config.timeout ?? 30_000;\n\n    // Bind request method for resources\n    const boundRequest = this.request.bind(this);\n    this.products = new ProductsResource(boundRequest);\n    this.orders = new OrdersResource(boundRequest);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    params?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `${this.baseUrl}/external${path}${params ? buildQueryString(params) : \"\"}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-API-Key\": this.apiKey,\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        const errorBody = (await response.json().catch(() => ({\n          error: \"Unknown\",\n          message: response.statusText,\n        }))) as ApiErrorResponse;\n\n        throw new RitelApiError(\n          response.status,\n          errorBody.error,\n          errorBody.message\n        );\n      }\n\n      return response.json() as Promise<T>;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof RitelApiError) {\n        throw error;\n      }\n\n      if (error instanceof Error) {\n        if (error.name === \"AbortError\") {\n          throw new RitelNetworkError(\"Request timeout\", error);\n        }\n        throw new RitelNetworkError(error.message, error);\n      }\n\n      throw new RitelNetworkError(\"Unknown network error\");\n    }\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@buiducnhat/ritel-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Ritel Mini ERP external APIs",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "ritel",
+    "sdk",
+    "api",
+    "erp",
+    "typescript"
+  ],
+  "author": "Bui Duc Nhat",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/buiducnhat/ritel.git",
+    "directory": "packages/sdk"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "devDependencies": {
+    "@ritel/config": "workspace:*",
+    "tsdown": "^0.19.0",
+    "typescript": "^5"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  }
+}