lunartools-sdk 1.0.1 → 1.0.3

package/README.md

@@ -3,22 +3,36 @@
 Official TypeScript/JavaScript SDK for the Lunar Tools API.
 
 ## Installation
-```bash
+
+```
 npm install @lunartools/sdk
 ```
 
+## Getting Started
+
+### 1. Obtain Your API Key
+Visit the [Lunar Tools Developer Portal](https://www.lunartools.co/developers) to generate your API key.
+
+### 2. Get User Access Tokens
+Each API call requires a user's access token. Users can find their access token in the Lunar Tools application under Settings > Developer.
+
 ## Usage
-```typescript
+
+### Initialize the Client
+
+```
 import { Client } from '@lunartools/sdk';
 
-// Initialize with your client credentials
 const client = new Client({
-    clientId: 'your-client-id',
-    accessToken: 'your-access-token'
+    apiKey: 'your-api-key-here'
 });
+```
 
-// Add product to inventory
+### Add Product to Inventory
+
+```
 await client.addProduct({
+    token: 'user-access-token',
     name: 'Charizard VMAX',
     sku: 'SWSH-074',
     qty: 5,
@@ -27,19 +41,66 @@ await client.addProduct({
     size: 'Standard',
     store: 'TCGPlayer'
 });
+```
 
+### Add Order
+
+```
 await client.addOrder({
+    token: 'user-access-token',
     name: 'Pokemon Booster Box',
     status: 'shipped',
     orderNumber: 'ORD-12345',
     price: '120.00',
     orderTotal: '132.00',
     retailer: 'Amazon',
-    tracking: '1Z999AA10123456784'
+    tracking: '1Z999AA10123456784',
+    qty: '1'
 });
+```
 
-// Forward webhook to Discord
-const response = await client.webhook('https://www.lunartools.co/api/webhooks/YOUR_TOKEN_HERE',
+### Add Profile Analytics
+
+```
+await client.addProfile({
+    token: 'user-access-token',
+    success: true,
+    billing: {
+        name: 'John Doe',
+        phone: '5551234567',
+        line1: '123 Main St',
+        line2: 'Apt 4B',
+        postCode: '10001',
+        city: 'New York',
+        state: 'NY',
+        country: 'United States'
+    },
+    shipping: {
+        name: 'John Doe',
+        phone: '5551234567',
+        line1: '123 Main St',
+        line2: 'Apt 4B',
+        postCode: '10001',
+        city: 'New York',
+        state: 'NY',
+        country: 'United States'
+    },
+    payment: {
+        name: 'John Doe',
+        type: 'Visa',
+        lastFour: '4242',
+        expMonth: '12',
+        expYear: '2025',
+        cvv: '123'
+    }
+});
+```
+
+### Forward Webhook to Discord
+
+```
+const response = await client.webhook(
+    'https://www.lunartools.co/api/webhooks/YOUR_TOKEN_HERE',
     {
         content: 'New product in stock!',
         embeds: [{
@@ -61,22 +122,23 @@ console.log(response); // { status: 'queued', queueLength: 1 }
 ## API Reference
 
 ### Constructor
-```typescript
+
+```
 new Client(config: Config)
 ```
 
 **Config:**
-- `clientId` (string, required) - Your client ID from Lunar Tools
-- `accessToken` (string, required) - Your access token from Lunar Tools
+- `apiKey` (string, required) - Your API key from the Lunar Tools Developer Portal
 - `baseUrl` (string, optional) - Custom API base URL (defaults to https://www.lunartools.co)
 
 ### Methods
 
-#### `addProduct(product: AddProduct): Promise<void>`
+#### addProduct(product: AddProduct): Promise<void>
 
-Add a new product to inventory.
+Add a new product to a user's inventory.
 
 **Required fields:**
+- `token` (string) - User's access token
 - `name` (string) - Product name
 - `sku` (string) - Product SKU
 - `qty` (number) - Quantity
@@ -88,20 +150,23 @@ Add a new product to inventory.
 - `spent` (number) - Amount spent
 
 **Example:**
-```typescript
-    await client.addProduct({
-        name: 'Product Name',
-        sku: 'SKU-123',
-        qty: 10,
-        value: 50.00
-    });
+
+```
+await client.addProduct({
+    token: 'user-access-token',
+    name: 'Product Name',
+    sku: 'SKU-123',
+    qty: 10,
+    value: 50.00
+});
 ```
 
-#### `addOrder(order: AddOrder): Promise<void>`
+#### addOrder(order: AddOrder): Promise<void>
 
-Add a new order.
+Add a new order to a user's orders.
 
 **Required fields:**
+- `token` (string) - User's access token
 - `name` (string) - Order name
 - `status` (string) - Order status
 - `orderNumber` (string) - Order number
@@ -109,7 +174,7 @@ Add a new order.
 **Optional fields:**
 - `image` (string) - Product image URL
 - `tracking` (string) - Tracking number
-- `date` (string) - Order date
+- `date` (string) - Order date (format: MM/DD/YYYY, HH:MM:SS AM/PM)
 - `qty` (string) - Quantity
 - `price` (string) - Item price
 - `orderTotal` (string) - Total order amount
@@ -118,23 +183,88 @@ Add a new order.
 - `tags` (string) - Order tags
 
 **Example:**
-```typescript
-    await client.addOrder({
-        name: 'Pokemon Cards',
-        status: 'delivered',
-        orderNumber: 'ORD-456',
-        price: '99.99',
-        retailer: 'eBay'
-    });
+
+```
+await client.addOrder({
+    token: 'user-access-token',
+    name: 'Pokemon Cards',
+    status: 'delivered',
+    orderNumber: 'ORD-456',
+    price: '99.99',
+    retailer: 'eBay'
+});
+```
+
+#### addProfile(profile: AddProfile): Promise<void>
+
+Add profile analytics data for tracking successful/declined checkouts.
+
+**Required fields:**
+- `token` (string) - User's access token
+- `success` (boolean) - Whether the checkout was successful
+- `billing` (Address) - Billing address information
+- `shipping` (Address) - Shipping address information
+- `payment` (Payment) - Payment information
+
+**Address fields (all required):**
+- `name` (string) - Full name
+- `phone` (string) - Phone number
+- `line1` (string) - Address line 1
+- `line2` (string, optional) - Address line 2
+- `postCode` (string) - Postal/ZIP code
+- `city` (string) - City
+- `state` (string) - State/province
+- `country` (string) - Country
+
+**Payment fields (all required):**
+- `name` (string) - Name on card
+- `type` (string) - Card type (e.g., Visa, Mastercard)
+- `lastFour` (string) - Last 4 digits of card
+- `expMonth` (string) - Expiration month (MM)
+- `expYear` (string) - Expiration year (YYYY)
+- `cvv` (string, optional) - CVV code
+
+**Example:**
+
+```
+await client.addProfile({
+    token: 'user-access-token',
+    success: true,
+    billing: {
+        name: 'John Doe',
+        phone: '5551234567',
+        line1: '123 Main St',
+        postCode: '10001',
+        city: 'New York',
+        state: 'NY',
+        country: 'United States'
+    },
+    shipping: {
+        name: 'John Doe',
+        phone: '5551234567',
+        line1: '456 Oak Ave',
+        postCode: '10002',
+        city: 'Brooklyn',
+        state: 'NY',
+        country: 'United States'
+    },
+    payment: {
+        name: 'John Doe',
+        type: 'Visa',
+        lastFour: '4242',
+        expMonth: '12',
+        expYear: '2025'
+    }
+});
 ```
 
-#### `forwardWebhook(webhookUrl: string, payload: DiscordWebhookPayload): Promise<WebhookResponse>`
+#### webhook(webhookUrl: string, payload: Webhook): Promise<WebhookResponse>
 
-Forward a webhook payload to Discord.
+Forward a webhook payload to Discord via Lunar Tools.
 
 **Parameters:**
 - `webhookUrl` (string) - Full Lunar Tools webhook URL
-- `payload` (DiscordWebhookPayload) - Discord webhook payload
+- `payload` (Webhook) - Discord webhook payload
 
 **Payload structure:**
 - `content` (string, optional) - Message content
@@ -143,37 +273,120 @@ Forward a webhook payload to Discord.
 - `embeds` (Embed[], optional) - Array of embeds (max 10)
 
 **Example:**
-```typescript
-    const response = await client.webhook('https://www.lunartools.co/api/webhooks/TOKEN',
-        {
-            content: 'Hello!',
-            embeds: [{
-                title: 'Alert',
-                description: 'Something happened',
-                color: 0xFF0000,
-                fields: [
-                    { name: 'Field 1', value: 'Value 1', inline: true }
-                ]
-            }]
-        }
-    );
+
 ```
+const response = await client.webhook(
+    'https://www.lunartools.co/api/webhooks/TOKEN',
+    {
+        content: 'Hello!',
+        embeds: [{
+            title: 'Alert',
+            description: 'Something happened',
+            color: 0xFF0000,
+            fields: [
+                { name: 'Field 1', value: 'Value 1', inline: true }
+            ]
+        }]
+    }
+);
+```
+
+## Authentication
+
+The SDK uses two-level authentication:
+
+1. **API Key**: Your developer API key (passed in constructor)
+   - Obtain from: [Developer Portal](https://www.lunartools.co/developers)
+   - Used in `x-api-key` header for all requests
+
+2. **User Access Token**: Individual user's access token (passed per request)
+   - Users find this in: Lunar Tools App > Settings > Developer
+   - Identifies which user's data to modify
 
 ## Error Handling
 
 The SDK validates all inputs and throws descriptive errors:
-```typescript
-    try {
-        await client.addProduct({
-            name: '',
-            sku: 'SKU-123',
-            qty: 5
-        });
-    } catch (error) {
-        console.error(error.message);
-    }
+
+```
+try {
+    await client.addProduct({
+        token: 'user-access-token',
+        name: '',
+        sku: 'SKU-123',
+        qty: 5
+    });
+} catch (error) {
+    console.error(error.message); // "Product name is required"
+}
 ```
 
+## Common Use Cases
+
+### E-commerce Bot Integration
+
+```
+// After successful checkout
+await client.addOrder({
+    token: userAccessToken,
+    name: productName,
+    status: 'confirmed',
+    orderNumber: orderNumber,
+    price: price,
+    orderTotal: total,
+    retailer: 'Nike',
+    tracking: trackingNumber
+});
+
+// Track profile analytics
+await client.addProfile({
+    token: userAccessToken,
+    success: checkoutSuccessful,
+    billing: billingInfo,
+    shipping: shippingInfo,
+    payment: paymentInfo
+});
+```
+
+### Inventory Management
+
+```
+// Add new inventory
+await client.addProduct({
+    token: userAccessToken,
+    name: 'Limited Edition Sneakers',
+    sku: 'SNKR-001',
+    qty: 10,
+    value: 200.00,
+    spent: 150.00,
+    store: 'Footlocker'
+});
+```
+
+### Discord Notifications
+
+```
+// Send success notification
+await client.webhook(webhookUrl, {
+    embeds: [{
+        title: '✅ Checkout Success',
+        description: `Successfully checked out ${productName}`,
+        color: 0x00FF00,
+        fields: [
+            { name: 'Order Number', value: orderNumber, inline: true },
+            { name: 'Total', value: `$${total}`, inline: true }
+        ],
+        timestamp: new Date().toISOString()
+    }]
+});
+```
+
+## Support
+
+For issues, questions, or feature requests:
+- Discord: [Join our server](https://discord.gg/lunartools)
+- Email: support@lunartools.co
+- Documentation: [docs.lunartools.co](https://docs.lunartools.co)
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 interface Config {
-    clientId: string;
-    accessToken: string;
+    apiKey: string;
     baseUrl?: string;
 }
 interface Thumbnail {
@@ -46,6 +45,7 @@ interface WebhookResponse {
     queueLength: number;
 }
 interface AddProduct {
+    token: string;
     name: string;
     sku: string;
     qty: number;
@@ -55,6 +55,7 @@ interface AddProduct {
     spent?: number;
 }
 interface AddOrder {
+    token: string;
     name: string;
     status: string;
     orderNumber: string;
@@ -68,5 +69,46 @@ interface AddOrder {
     retailer?: string;
     tags?: string;
 }
+interface Address {
+    name: string;
+    phone: string;
+    line1: string;
+    line2?: string;
+    postCode: string;
+    city: string;
+    country: string;
+    state: string;
+}
+interface Payment {
+    name: string;
+    type: string;
+    lastFour: string;
+    expMonth: string;
+    expYear: string;
+    cvv?: string;
+}
+interface AddProfile {
+    token: string;
+    success: boolean;
+    billing: Address;
+    shipping: Address;
+    payment: Payment;
+}
+
+declare class Client {
+    private apiKey;
+    private api;
+    constructor(config: Config);
+    addProduct(product: AddProduct): Promise<void>;
+    addOrder(order: AddOrder): Promise<void>;
+    addProfile(profile: AddProfile): Promise<void>;
+    webhook(webhookUrl: string, payload: Webhook): Promise<WebhookResponse>;
+    private validateAddProduct;
+    private validateAddOrder;
+    private validateAddProfile;
+    private validateAddress;
+    private validatePayment;
+    private validateWebhookPayload;
+}
 
-export type { AddOrder, AddProduct, Author, Config, Embed, Field, Footer, Image, Thumbnail, Webhook, WebhookResponse };
+export { type AddOrder, type AddProduct, type AddProfile, type Address, type Author, Client, type Config, type Embed, type Field, type Footer, type Image, type Payment, type Thumbnail, type Webhook, type WebhookResponse };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 interface Config {
-    clientId: string;
-    accessToken: string;
+    apiKey: string;
     baseUrl?: string;
 }
 interface Thumbnail {
@@ -46,6 +45,7 @@ interface WebhookResponse {
     queueLength: number;
 }
 interface AddProduct {
+    token: string;
     name: string;
     sku: string;
     qty: number;
@@ -55,6 +55,7 @@ interface AddProduct {
     spent?: number;
 }
 interface AddOrder {
+    token: string;
     name: string;
     status: string;
     orderNumber: string;
@@ -68,5 +69,46 @@ interface AddOrder {
     retailer?: string;
     tags?: string;
 }
+interface Address {
+    name: string;
+    phone: string;
+    line1: string;
+    line2?: string;
+    postCode: string;
+    city: string;
+    country: string;
+    state: string;
+}
+interface Payment {
+    name: string;
+    type: string;
+    lastFour: string;
+    expMonth: string;
+    expYear: string;
+    cvv?: string;
+}
+interface AddProfile {
+    token: string;
+    success: boolean;
+    billing: Address;
+    shipping: Address;
+    payment: Payment;
+}
+
+declare class Client {
+    private apiKey;
+    private api;
+    constructor(config: Config);
+    addProduct(product: AddProduct): Promise<void>;
+    addOrder(order: AddOrder): Promise<void>;
+    addProfile(profile: AddProfile): Promise<void>;
+    webhook(webhookUrl: string, payload: Webhook): Promise<WebhookResponse>;
+    private validateAddProduct;
+    private validateAddOrder;
+    private validateAddProfile;
+    private validateAddress;
+    private validatePayment;
+    private validateWebhookPayload;
+}
 
-export type { AddOrder, AddProduct, Author, Config, Embed, Field, Footer, Image, Thumbnail, Webhook, WebhookResponse };
+export { type AddOrder, type AddProduct, type AddProfile, type Address, type Author, Client, type Config, type Embed, type Field, type Footer, type Image, type Payment, type Thumbnail, type Webhook, type WebhookResponse };

package/dist/index.js

@@ -1,8 +1,14 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 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))
@@ -11,8 +17,149 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
+__export(index_exports, {
+  Client: () => Client
+});
 module.exports = __toCommonJS(index_exports);
+
+// src/client/client.ts
+var import_axios = __toESM(require("axios"));
+var Client = class {
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    const baseUrl = config.baseUrl || "https://www.lunartools.co";
+    this.api = import_axios.default.create({
+      baseURL: baseUrl,
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey
+      }
+    });
+  }
+  async addProduct(product) {
+    this.validateAddProduct(product);
+    await this.api.post("/api/sdk/add-product", product);
+  }
+  async addOrder(order) {
+    this.validateAddOrder(order);
+    await this.api.post("/api/sdk/add-order", order);
+  }
+  async addProfile(profile) {
+    this.validateAddProfile(profile);
+    await this.api.post("/api/sdk/add-profile", profile);
+  }
+  async webhook(webhookUrl, payload) {
+    this.validateWebhookPayload(payload);
+    const response = await import_axios.default.post(webhookUrl, payload, {
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    return response.data;
+  }
+  validateAddProduct(product) {
+    if (!product.token || product.token.trim() === "") {
+      throw new Error("User access token is required");
+    }
+    if (!product.name || product.name.trim() === "") {
+      throw new Error("Product name is required");
+    }
+    if (!product.sku || product.sku.trim() === "") {
+      throw new Error("Product SKU is required");
+    }
+    if (product.qty === void 0 || product.qty === null) {
+      throw new Error("Product quantity is required");
+    }
+    if (typeof product.qty !== "number" || product.qty < 0) {
+      throw new Error("Product quantity must be a non-negative number");
+    }
+    if (product.value !== void 0 && (typeof product.value !== "number" || product.value < 0)) {
+      throw new Error("Product value must be a non-negative number");
+    }
+    if (product.spent !== void 0 && (typeof product.spent !== "number" || product.spent < 0)) {
+      throw new Error("Product spent must be a non-negative number");
+    }
+  }
+  validateAddOrder(order) {
+    if (!order.token || order.token.trim() === "") {
+      throw new Error("User access token is required");
+    }
+    if (!order.name || order.name.trim() === "") {
+      throw new Error("Order name is required");
+    }
+    if (!order.status || order.status.trim() === "") {
+      throw new Error("Order status is required");
+    }
+    if (!order.orderNumber || order.orderNumber.trim() === "") {
+      throw new Error("Order number is required");
+    }
+  }
+  validateAddProfile(profile) {
+    if (!profile.token || profile.token.trim() === "") {
+      throw new Error("User access token is required");
+    }
+    if (!profile.billing || !profile.shipping || !profile.payment) {
+      throw new Error("Billing, shipping, and payment information are required");
+    }
+    this.validateAddress(profile.billing, "Billing");
+    this.validateAddress(profile.shipping, "Shipping");
+    this.validatePayment(profile.payment);
+  }
+  validateAddress(address, type) {
+    const required = ["name", "phone", "line1", "postCode", "city", "country", "state"];
+    for (const field of required) {
+      if (!address[field] || address[field].trim() === "") {
+        throw new Error(`${type} ${field} is required`);
+      }
+    }
+  }
+  validatePayment(payment) {
+    const required = ["name", "type", "lastFour", "expMonth", "expYear"];
+    for (const field of required) {
+      if (!payment[field] || payment[field].toString().trim() === "") {
+        throw new Error(`Payment ${field} is required`);
+      }
+    }
+  }
+  validateWebhookPayload(payload) {
+    if (!payload.content && (!payload.embeds || payload.embeds.length === 0)) {
+      throw new Error("Webhook payload must contain either content or at least one embed");
+    }
+    if (payload.embeds && payload.embeds.length > 10) {
+      throw new Error("Discord webhooks support a maximum of 10 embeds");
+    }
+    if (payload.embeds) {
+      payload.embeds.forEach((embed, index) => {
+        if (embed.fields && embed.fields.length > 25) {
+          throw new Error(`Embed ${index} exceeds the maximum of 25 fields`);
+        }
+        if (embed.fields) {
+          embed.fields.forEach((field, fieldIndex) => {
+            if (!field.name || field.name.trim() === "") {
+              throw new Error(`Embed ${index}, field ${fieldIndex}: name is required`);
+            }
+            if (!field.value || field.value.trim() === "") {
+              throw new Error(`Embed ${index}, field ${fieldIndex}: value is required`);
+            }
+          });
+        }
+      });
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Client
+});

package/dist/index.mjs

@@ -0,0 +1,128 @@
+// src/client/client.ts
+import axios from "axios";
+var Client = class {
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    const baseUrl = config.baseUrl || "https://www.lunartools.co";
+    this.api = axios.create({
+      baseURL: baseUrl,
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey
+      }
+    });
+  }
+  async addProduct(product) {
+    this.validateAddProduct(product);
+    await this.api.post("/api/sdk/add-product", product);
+  }
+  async addOrder(order) {
+    this.validateAddOrder(order);
+    await this.api.post("/api/sdk/add-order", order);
+  }
+  async addProfile(profile) {
+    this.validateAddProfile(profile);
+    await this.api.post("/api/sdk/add-profile", profile);
+  }
+  async webhook(webhookUrl, payload) {
+    this.validateWebhookPayload(payload);
+    const response = await axios.post(webhookUrl, payload, {
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    return response.data;
+  }
+  validateAddProduct(product) {
+    if (!product.token || product.token.trim() === "") {
+      throw new Error("User access token is required");
+    }
+    if (!product.name || product.name.trim() === "") {
+      throw new Error("Product name is required");
+    }
+    if (!product.sku || product.sku.trim() === "") {
+      throw new Error("Product SKU is required");
+    }
+    if (product.qty === void 0 || product.qty === null) {
+      throw new Error("Product quantity is required");
+    }
+    if (typeof product.qty !== "number" || product.qty < 0) {
+      throw new Error("Product quantity must be a non-negative number");
+    }
+    if (product.value !== void 0 && (typeof product.value !== "number" || product.value < 0)) {
+      throw new Error("Product value must be a non-negative number");
+    }
+    if (product.spent !== void 0 && (typeof product.spent !== "number" || product.spent < 0)) {
+      throw new Error("Product spent must be a non-negative number");
+    }
+  }
+  validateAddOrder(order) {
+    if (!order.token || order.token.trim() === "") {
+      throw new Error("User access token is required");
+    }
+    if (!order.name || order.name.trim() === "") {
+      throw new Error("Order name is required");
+    }
+    if (!order.status || order.status.trim() === "") {
+      throw new Error("Order status is required");
+    }
+    if (!order.orderNumber || order.orderNumber.trim() === "") {
+      throw new Error("Order number is required");
+    }
+  }
+  validateAddProfile(profile) {
+    if (!profile.token || profile.token.trim() === "") {
+      throw new Error("User access token is required");
+    }
+    if (!profile.billing || !profile.shipping || !profile.payment) {
+      throw new Error("Billing, shipping, and payment information are required");
+    }
+    this.validateAddress(profile.billing, "Billing");
+    this.validateAddress(profile.shipping, "Shipping");
+    this.validatePayment(profile.payment);
+  }
+  validateAddress(address, type) {
+    const required = ["name", "phone", "line1", "postCode", "city", "country", "state"];
+    for (const field of required) {
+      if (!address[field] || address[field].trim() === "") {
+        throw new Error(`${type} ${field} is required`);
+      }
+    }
+  }
+  validatePayment(payment) {
+    const required = ["name", "type", "lastFour", "expMonth", "expYear"];
+    for (const field of required) {
+      if (!payment[field] || payment[field].toString().trim() === "") {
+        throw new Error(`Payment ${field} is required`);
+      }
+    }
+  }
+  validateWebhookPayload(payload) {
+    if (!payload.content && (!payload.embeds || payload.embeds.length === 0)) {
+      throw new Error("Webhook payload must contain either content or at least one embed");
+    }
+    if (payload.embeds && payload.embeds.length > 10) {
+      throw new Error("Discord webhooks support a maximum of 10 embeds");
+    }
+    if (payload.embeds) {
+      payload.embeds.forEach((embed, index) => {
+        if (embed.fields && embed.fields.length > 25) {
+          throw new Error(`Embed ${index} exceeds the maximum of 25 fields`);
+        }
+        if (embed.fields) {
+          embed.fields.forEach((field, fieldIndex) => {
+            if (!field.name || field.name.trim() === "") {
+              throw new Error(`Embed ${index}, field ${fieldIndex}: name is required`);
+            }
+            if (!field.value || field.value.trim() === "") {
+              throw new Error(`Embed ${index}, field ${fieldIndex}: value is required`);
+            }
+          });
+        }
+      });
+    }
+  }
+};
+export {
+  Client
+};

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "lunartools-sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Official SDK for Lunar Tools API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/senpai0807/lunartools-sdk-js.git"
@@ -35,7 +35,7 @@
     "axios": "^1.6.0"
   },
   "devDependencies": {
-    "@types/node": "^24.10.0",
+    "@types/node": "25.0.10",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   },