lunartools-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2025 Lunar Tools. All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to Lunar Tools.
+
+Unauthorized copying, modification, distribution, or use of this Software,
+via any medium, is strictly prohibited without the express written permission
+of Lunar Tools.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# Lunar Tools SDK
+
+Official TypeScript/JavaScript SDK for the Lunar Tools API.
+
+## Installation
+```bash
+npm install @lunartools/sdk
+```
+
+## Usage
+```typescript
+import { Client } from '@lunartools/sdk';
+
+// Initialize with your client credentials
+const client = new Client({
+    clientId: 'your-client-id',
+    accessToken: 'your-access-token'
+});
+
+// Add product to inventory
+await client.addProduct({
+    name: 'Charizard VMAX',
+    sku: 'SWSH-074',
+    qty: 5,
+    value: 150.00,
+    spent: 120.00,
+    size: 'Standard',
+    store: 'TCGPlayer'
+});
+
+await client.addOrder({
+    name: 'Pokemon Booster Box',
+    status: 'shipped',
+    orderNumber: 'ORD-12345',
+    price: '120.00',
+    orderTotal: '132.00',
+    retailer: 'Amazon',
+    tracking: '1Z999AA10123456784'
+});
+
+// Forward webhook to Discord
+const response = await client.webhook('https://www.lunartools.co/api/webhooks/YOUR_TOKEN_HERE',
+    {
+        content: 'New product in stock!',
+        embeds: [{
+            title: 'Product Alert',
+            description: 'Charizard VMAX is now available',
+            color: 0x5865F2,
+            fields: [
+                { name: 'Price', value: '$150.00', inline: true },
+                { name: 'Quantity', value: '5', inline: true }
+            ],
+            timestamp: new Date().toISOString()
+        }]
+    }
+);
+
+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
+- `baseUrl` (string, optional) - Custom API base URL (defaults to https://www.lunartools.co)
+
+### Methods
+
+#### `addProduct(product: AddProduct): Promise<void>`
+
+Add a new product to inventory.
+
+**Required fields:**
+- `name` (string) - Product name
+- `sku` (string) - Product SKU
+- `qty` (number) - Quantity
+
+**Optional fields:**
+- `size` (string) - Product size
+- `store` (string) - Store name
+- `value` (number) - Product value
+- `spent` (number) - Amount spent
+
+**Example:**
+```typescript
+    await client.addProduct({
+        name: 'Product Name',
+        sku: 'SKU-123',
+        qty: 10,
+        value: 50.00
+    });
+```
+
+#### `addOrder(order: AddOrder): Promise<void>`
+
+Add a new order.
+
+**Required fields:**
+- `name` (string) - Order name
+- `status` (string) - Order status
+- `orderNumber` (string) - Order number
+
+**Optional fields:**
+- `image` (string) - Product image URL
+- `tracking` (string) - Tracking number
+- `date` (string) - Order date
+- `qty` (string) - Quantity
+- `price` (string) - Item price
+- `orderTotal` (string) - Total order amount
+- `account` (string) - Account name
+- `retailer` (string) - Retailer name
+- `tags` (string) - Order tags
+
+**Example:**
+```typescript
+    await client.addOrder({
+        name: 'Pokemon Cards',
+        status: 'delivered',
+        orderNumber: 'ORD-456',
+        price: '99.99',
+        retailer: 'eBay'
+    });
+```
+
+#### `forwardWebhook(webhookUrl: string, payload: DiscordWebhookPayload): Promise<WebhookResponse>`
+
+Forward a webhook payload to Discord.
+
+**Parameters:**
+- `webhookUrl` (string) - Full Lunar Tools webhook URL
+- `payload` (DiscordWebhookPayload) - Discord webhook payload
+
+**Payload structure:**
+- `content` (string, optional) - Message content
+- `username` (string, optional) - Override webhook username
+- `avatarUrl` (string, optional) - Override webhook avatar
+- `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 }
+                ]
+            }]
+        }
+    );
+```
+
+## 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);
+    }
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,72 @@
+interface Config {
+    clientId: string;
+    accessToken: string;
+    baseUrl?: string;
+}
+interface Thumbnail {
+    url?: string;
+}
+interface Image {
+    url?: string;
+}
+interface Footer {
+    text?: string;
+    iconUrl?: string;
+}
+interface Author {
+    name?: string;
+    url?: string;
+    iconUrl?: string;
+}
+interface Field {
+    name: string;
+    value: string;
+    inline?: boolean;
+}
+interface Embed {
+    author?: Author;
+    title?: string;
+    url?: string;
+    description?: string;
+    color?: number;
+    fields?: Field[];
+    thumbnail?: Thumbnail;
+    image?: Image;
+    footer?: Footer;
+    timestamp?: string;
+}
+interface Webhook {
+    username?: string;
+    avatarUrl?: string;
+    content?: string;
+    embeds?: Embed[];
+}
+interface WebhookResponse {
+    status: string;
+    queueLength: number;
+}
+interface AddProduct {
+    name: string;
+    sku: string;
+    qty: number;
+    size?: string;
+    store?: string;
+    value?: number;
+    spent?: number;
+}
+interface AddOrder {
+    name: string;
+    status: string;
+    orderNumber: string;
+    image?: string;
+    tracking?: string;
+    date?: string;
+    qty?: string;
+    price?: string;
+    orderTotal?: string;
+    account?: string;
+    retailer?: string;
+    tags?: string;
+}
+
+export type { AddOrder, AddProduct, Author, Config, Embed, Field, Footer, Image, Thumbnail, Webhook, WebhookResponse };

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+interface Config {
+    clientId: string;
+    accessToken: string;
+    baseUrl?: string;
+}
+interface Thumbnail {
+    url?: string;
+}
+interface Image {
+    url?: string;
+}
+interface Footer {
+    text?: string;
+    iconUrl?: string;
+}
+interface Author {
+    name?: string;
+    url?: string;
+    iconUrl?: string;
+}
+interface Field {
+    name: string;
+    value: string;
+    inline?: boolean;
+}
+interface Embed {
+    author?: Author;
+    title?: string;
+    url?: string;
+    description?: string;
+    color?: number;
+    fields?: Field[];
+    thumbnail?: Thumbnail;
+    image?: Image;
+    footer?: Footer;
+    timestamp?: string;
+}
+interface Webhook {
+    username?: string;
+    avatarUrl?: string;
+    content?: string;
+    embeds?: Embed[];
+}
+interface WebhookResponse {
+    status: string;
+    queueLength: number;
+}
+interface AddProduct {
+    name: string;
+    sku: string;
+    qty: number;
+    size?: string;
+    store?: string;
+    value?: number;
+    spent?: number;
+}
+interface AddOrder {
+    name: string;
+    status: string;
+    orderNumber: string;
+    image?: string;
+    tracking?: string;
+    date?: string;
+    qty?: string;
+    price?: string;
+    orderTotal?: string;
+    account?: string;
+    retailer?: string;
+    tags?: string;
+}
+
+export type { AddOrder, AddProduct, Author, Config, Embed, Field, Footer, Image, Thumbnail, Webhook, WebhookResponse };

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 = {};
+module.exports = __toCommonJS(index_exports);

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "lunartools-sdk",
+  "version": "1.0.0",
+  "description": "Official SDK for Lunar Tools API",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/senpai0807/lunartools-sdk-js.git"
+  },
+  "author": "Lunar Tools",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "lunar",
+    "tools",
+    "sdk",
+    "api",
+    "inventory",
+    "orders"
+  ],
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}