lua-cli 2.2.8-alpha.1 → 2.3.0-alpha.1

package/dist/common/http.client.js

@@ -0,0 +1,133 @@
+/**
+ * Generic HTTP client with common error handling
+ * Provides a base class for all API service classes with standardized HTTP methods
+ */
+export class HttpClient {
+    /**
+     * Creates an instance of HttpClient
+     * @param baseUrl - The base URL for all API requests
+     */
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Makes an HTTP request with standardized error handling
+     * @param url - The full URL to request
+     * @param options - Fetch API request options
+     * @returns Promise resolving to an ApiResponse with typed data
+     * @private
+     */
+    async request(url, options = {}) {
+        try {
+            const response = await fetch(url, {
+                ...options,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...options.headers,
+                },
+            });
+            // Check if response is ok (status 200-299)
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: {
+                        message: `HTTP ${response.status}: ${response.statusText}`,
+                        statusCode: response.status,
+                    },
+                };
+            }
+            // Try to parse JSON response
+            let data;
+            try {
+                data = await response.json();
+            }
+            catch (jsonError) {
+                data = {};
+            }
+            // If the response already has the ApiResponse structure, return it
+            if (typeof data === 'object' && data !== null && 'success' in data) {
+                return data;
+            }
+            // Otherwise, wrap the data in a successful ApiResponse
+            return {
+                success: true,
+                data,
+            };
+        }
+        catch (error) {
+            // Handle network errors, timeouts, etc.
+            return {
+                success: false,
+                error: {
+                    message: error instanceof Error ? error.message : 'Network request failed',
+                    statusCode: 0, // Use 0 to indicate network/connection error
+                },
+            };
+        }
+    }
+    /**
+     * Performs an HTTP GET request
+     * @param url - The relative URL path to request (will be appended to baseUrl)
+     * @param headers - Optional HTTP headers to include in the request
+     * @returns Promise resolving to an ApiResponse with typed data
+     * @protected
+     */
+    async httpGet(url, headers) {
+        return this.request(this.baseUrl + url, { method: 'GET', headers });
+    }
+    /**
+     * Performs an HTTP POST request
+     * @param url - The relative URL path to request (will be appended to baseUrl)
+     * @param data - Optional request body data (will be JSON stringified)
+     * @param headers - Optional HTTP headers to include in the request
+     * @returns Promise resolving to an ApiResponse with typed data
+     * @protected
+     */
+    async httpPost(url, data, headers) {
+        return this.request(this.baseUrl + url, {
+            method: 'POST',
+            body: data ? JSON.stringify(data) : undefined,
+            headers,
+        });
+    }
+    /**
+     * Performs an HTTP PUT request
+     * @param url - The relative URL path to request (will be appended to baseUrl)
+     * @param data - Optional request body data (will be JSON stringified)
+     * @param headers - Optional HTTP headers to include in the request
+     * @returns Promise resolving to an ApiResponse with typed data
+     * @protected
+     */
+    async httpPut(url, data, headers) {
+        return this.request(this.baseUrl + url, {
+            method: 'PUT',
+            body: data ? JSON.stringify(data) : undefined,
+            headers,
+        });
+    }
+    /**
+     * Performs an HTTP DELETE request
+     * @param url - The relative URL path to request (will be appended to baseUrl)
+     * @param headers - Optional HTTP headers to include in the request
+     * @returns Promise resolving to an ApiResponse with typed data
+     * @protected
+     */
+    async httpDelete(url, headers) {
+        return this.request(this.baseUrl + url, { method: 'DELETE', headers });
+    }
+    /**
+     * Performs an HTTP PATCH request
+     * @param url - The relative URL path to request (will be appended to baseUrl)
+     * @param data - Optional request body data (will be JSON stringified)
+     * @param headers - Optional HTTP headers to include in the request
+     * @returns Promise resolving to an ApiResponse with typed data
+     * @protected
+     */
+    async httpPatch(url, data, headers) {
+        return this.request(this.baseUrl + url, {
+            method: 'PATCH',
+            body: data ? JSON.stringify(data) : undefined,
+            headers,
+        });
+    }
+}

package/dist/common/order.instance.d.ts

@@ -0,0 +1,40 @@
+import OrderApi from "../api/order.api.service.js";
+import { OrderResponse, OrderStatus } from "../interfaces/orders.js";
+/**
+ * Order instance class providing a fluent API for managing orders
+ * Provides methods for updating order status and order data
+ */
+export default class OrderInstance {
+    private data;
+    private common;
+    private id;
+    private userId;
+    private agentId;
+    private orderId;
+    private orderAPI;
+    /**
+     * Creates a new OrderInstance
+     * @param api - The OrderApi instance for making API calls
+     * @param order - The order response data from the API
+     */
+    constructor(api: OrderApi, order: OrderResponse);
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized order data combining data and common fields
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Updates the order's status
+     * @param status - The new order status (e.g., 'pending', 'processing', 'shipped', 'delivered', 'cancelled')
+     * @returns Promise resolving to the updated order data
+     * @throws Error if the status update fails
+     */
+    updateStatus(status: OrderStatus): Promise<any>;
+    /**
+     * Updates the order's data
+     * @param data - The data fields to update (e.g., shipping info, notes, metadata)
+     * @returns Promise resolving to the updated order data
+     * @throws Error if the data update fails
+     */
+    update(data: Record<string, any>): Promise<any>;
+}

package/dist/common/order.instance.js

@@ -0,0 +1,79 @@
+/**
+ * Order instance class providing a fluent API for managing orders
+ * Provides methods for updating order status and order data
+ */
+export default class OrderInstance {
+    /**
+     * Creates a new OrderInstance
+     * @param api - The OrderApi instance for making API calls
+     * @param order - The order response data from the API
+     */
+    constructor(api, order) {
+        this.data = order.data;
+        this.common = order.common;
+        this.id = order.id;
+        this.userId = order.userId;
+        this.agentId = order.agentId;
+        this.orderId = order.orderId;
+        // Make orderAPI non-enumerable so it doesn't show up in console.log
+        Object.defineProperty(this, 'orderAPI', {
+            value: api,
+            writable: true,
+            enumerable: false,
+            configurable: true
+        });
+    }
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized order data combining data and common fields
+     */
+    toJSON() {
+        return {
+            ...this.data,
+            ...this.common,
+            id: this.id
+        };
+    }
+    /**
+     * Custom inspect method for Node.js console.log
+     * @returns Formatted order data for console output
+     */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return {
+            ...this.data,
+            ...this.common,
+            id: this.id
+        };
+    }
+    /**
+     * Updates the order's status
+     * @param status - The new order status (e.g., 'pending', 'processing', 'shipped', 'delivered', 'cancelled')
+     * @returns Promise resolving to the updated order data
+     * @throws Error if the status update fails
+     */
+    async updateStatus(status) {
+        const response = await this.orderAPI.updateStatus(status, this.id);
+        this.common = response.common;
+        return {
+            ...this.data,
+            ...this.common,
+            id: this.id
+        };
+    }
+    /**
+     * Updates the order's data
+     * @param data - The data fields to update (e.g., shipping info, notes, metadata)
+     * @returns Promise resolving to the updated order data
+     * @throws Error if the data update fails
+     */
+    async update(data) {
+        const response = await this.orderAPI.updateData(data, this.id);
+        this.data = response.data;
+        this.common = response.common;
+        return {
+            ...this.data,
+            ...this.common,
+            id: this.id
+        };
+    }
+}

package/dist/common/product.instance.d.ts

@@ -0,0 +1,33 @@
+import { Product } from "../interfaces/product.js";
+/**
+ * Product instance class providing a fluent API for managing individual products
+ * Provides methods for updating and deleting products
+ */
+export default class ProductInstance {
+    data: Product;
+    private productAPI;
+    /**
+     * Creates a new ProductInstance
+     * @param api - The ProductAPI instance for making API calls
+     * @param product - The product data from the API
+     */
+    constructor(api: any, product: Product);
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized product data
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Updates the product's data
+     * @param data - The product fields to update (partial update supported)
+     * @returns Promise resolving to the updated Product
+     * @throws Error if the update fails or the product is not found
+     */
+    update(data: Record<string, any>): Promise<Product>;
+    /**
+     * Deletes the product from the catalog
+     * @returns Promise resolving to an empty Product object if deletion was successful
+     * @throws Error if the deletion fails or the product is not found
+     */
+    delete(): Promise<Product>;
+}

package/dist/common/product.instance.js

@@ -0,0 +1,63 @@
+/**
+ * Product instance class providing a fluent API for managing individual products
+ * Provides methods for updating and deleting products
+ */
+export default class ProductInstance {
+    /**
+     * Creates a new ProductInstance
+     * @param api - The ProductAPI instance for making API calls
+     * @param product - The product data from the API
+     */
+    constructor(api, product) {
+        this.data = product;
+        // Make productAPI non-enumerable so it doesn't show up in console.log
+        Object.defineProperty(this, 'productAPI', {
+            value: api,
+            writable: true,
+            enumerable: false,
+            configurable: true
+        });
+    }
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized product data
+     */
+    toJSON() {
+        return this.data;
+    }
+    /**
+     * Custom inspect method for Node.js console.log
+     * @returns Formatted product data for console output
+     */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return this.data;
+    }
+    /**
+     * Updates the product's data
+     * @param data - The product fields to update (partial update supported)
+     * @returns Promise resolving to the updated Product
+     * @throws Error if the update fails or the product is not found
+     */
+    async update(data) {
+        const response = await this.productAPI.update(data, this.data.id);
+        if (response.updated) {
+            this.data = response.product;
+            return this.data;
+        }
+        else {
+            throw new Error('Failed to update product');
+        }
+    }
+    /**
+     * Deletes the product from the catalog
+     * @returns Promise resolving to an empty Product object if deletion was successful
+     * @throws Error if the deletion fails or the product is not found
+     */
+    async delete() {
+        const response = await this.productAPI.delete(this.data.id);
+        if (response.deleted) {
+            this.data = {};
+        }
+        return this.data;
+    }
+}

package/dist/common/product.pagination.instance.d.ts

@@ -0,0 +1,43 @@
+import { ProductsResponse } from "../interfaces/product.js";
+import ProductInstance from "./product.instance.js";
+/**
+ * Product pagination instance class providing a fluent API for paginated product results
+ * Provides methods for navigating through pages of products
+ */
+export default class ProductPaginationInstance {
+    products: ProductInstance[];
+    pagination: {
+        currentPage: number;
+        totalPages: number;
+        totalCount: number;
+        limit: number;
+        hasNextPage: boolean;
+        hasPrevPage: boolean;
+        nextPage: number | null;
+        prevPage: number | null;
+    };
+    private productAPI;
+    /**
+     * Creates a new ProductPaginationInstance
+     * @param api - The ProductAPI instance for making API calls
+     * @param results - The paginated product results from the API
+     */
+    constructor(api: any, results: ProductsResponse);
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized products and pagination data
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Fetches the next page of products
+     * @returns Promise resolving to a new ProductPaginationInstance for the next page
+     * @throws Error if there is no next page available
+     */
+    nextPage(): Promise<ProductPaginationInstance>;
+    /**
+     * Fetches the previous page of products
+     * @returns Promise resolving to a new ProductPaginationInstance for the previous page
+     * @throws Error if there is no previous page available
+     */
+    prevPage(): Promise<ProductPaginationInstance>;
+}

package/dist/common/product.pagination.instance.js

@@ -0,0 +1,74 @@
+import ProductInstance from "./product.instance.js";
+/**
+ * Product pagination instance class providing a fluent API for paginated product results
+ * Provides methods for navigating through pages of products
+ */
+export default class ProductPaginationInstance {
+    /**
+     * Creates a new ProductPaginationInstance
+     * @param api - The ProductAPI instance for making API calls
+     * @param results - The paginated product results from the API
+     */
+    constructor(api, results) {
+        this.products = results.data?.map(product => new ProductInstance(api, product)) || [];
+        this.pagination = results.pagination || {
+            currentPage: 1,
+            totalPages: 1,
+            totalCount: 0,
+            limit: 10,
+            hasNextPage: false,
+            hasPrevPage: false,
+            nextPage: null,
+            prevPage: null
+        };
+        // Make productAPI non-enumerable so it doesn't show up in console.log
+        Object.defineProperty(this, 'productAPI', {
+            value: api,
+            writable: true,
+            enumerable: false,
+            configurable: true
+        });
+    }
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized products and pagination data
+     */
+    toJSON() {
+        return {
+            products: this.products,
+            pagination: this.pagination
+        };
+    }
+    /**
+     * Custom inspect method for Node.js console.log
+     * @returns Formatted products and pagination data for console output
+     */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return {
+            products: this.products,
+            pagination: this.pagination
+        };
+    }
+    /**
+     * Fetches the next page of products
+     * @returns Promise resolving to a new ProductPaginationInstance for the next page
+     * @throws Error if there is no next page available
+     */
+    async nextPage() {
+        if (!this.pagination.nextPage) {
+            throw new Error('No next page');
+        }
+        return await this.productAPI.get(this.pagination.nextPage, this.pagination.limit);
+    }
+    /**
+     * Fetches the previous page of products
+     * @returns Promise resolving to a new ProductPaginationInstance for the previous page
+     * @throws Error if there is no previous page available
+     */
+    async prevPage() {
+        if (!this.pagination.prevPage) {
+            throw new Error('No previous page');
+        }
+        return await this.productAPI.get(this.pagination.prevPage, this.pagination.limit);
+    }
+}

package/dist/common/product.search.instance.d.ts

@@ -0,0 +1,22 @@
+import { SearchProductsResponse } from "../interfaces/product.js";
+import { ProductAPI } from "../types/index.js";
+import ProductInstance from "./product.instance.js";
+/**
+ * Product search instance class providing a fluent API for product search results
+ * Contains an array of ProductInstance objects matching the search query
+ */
+export default class ProductSearchInstance {
+    products: ProductInstance[];
+    private productAPI;
+    /**
+     * Creates a new ProductSearchInstance
+     * @param api - The ProductAPI instance for making API calls
+     * @param results - The product search results from the API
+     */
+    constructor(api: ProductAPI, results: SearchProductsResponse);
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized search results with product data
+     */
+    toJSON(): Record<string, any>;
+}

package/dist/common/product.search.instance.js

@@ -0,0 +1,40 @@
+import ProductInstance from "./product.instance.js";
+/**
+ * Product search instance class providing a fluent API for product search results
+ * Contains an array of ProductInstance objects matching the search query
+ */
+export default class ProductSearchInstance {
+    /**
+     * Creates a new ProductSearchInstance
+     * @param api - The ProductAPI instance for making API calls
+     * @param results - The product search results from the API
+     */
+    constructor(api, results) {
+        this.products = results.data?.map(product => new ProductInstance(api, product)) || [];
+        // Make productAPI non-enumerable so it doesn't show up in console.log
+        Object.defineProperty(this, 'productAPI', {
+            value: api,
+            writable: true,
+            enumerable: false,
+            configurable: true
+        });
+    }
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized search results with product data
+     */
+    toJSON() {
+        return {
+            products: this.products,
+        };
+    }
+    /**
+     * Custom inspect method for Node.js console.log
+     * @returns Formatted search results for console output
+     */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return {
+            products: this.products,
+        };
+    }
+}

package/dist/common/user.instance.d.ts

@@ -0,0 +1,41 @@
+import { UserData } from "../interfaces/admin.js";
+import { UserDataAPI } from "../types/index.js";
+/**
+ * User data instance class providing a fluent API for managing user data
+ * Automatically sanitizes sensitive fields and provides methods for updating and clearing data
+ */
+export default class UserDataInstance {
+    data: Record<string, any>;
+    private userAPI;
+    /**
+     * Creates a new UserDataInstance
+     * @param api - The UserDataAPI instance for making API calls
+     * @param data - The user data from the API (will be sanitized automatically)
+     */
+    constructor(api: UserDataAPI, data: UserData);
+    /**
+     * Removes sensitive fields from the data before storing
+     * @param data - The raw user data to sanitize
+     * @returns Sanitized data with sensitive fields removed
+     * @private
+     */
+    private sanitizeData;
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized user data
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Updates the user's data
+     * @param data - The data fields to update or add to user data
+     * @returns Promise resolving to the updated sanitized user data
+     * @throws Error if the update fails
+     */
+    update(data: Record<string, any>): Promise<any>;
+    /**
+     * Clears all user data for the current user
+     * @returns Promise resolving to true if clearing was successful
+     * @throws Error if the clear operation fails
+     */
+    clear(): Promise<boolean>;
+}

package/dist/common/user.instance.js

@@ -0,0 +1,84 @@
+/**
+ * User data instance class providing a fluent API for managing user data
+ * Automatically sanitizes sensitive fields and provides methods for updating and clearing data
+ */
+export default class UserDataInstance {
+    /**
+     * Creates a new UserDataInstance
+     * @param api - The UserDataAPI instance for making API calls
+     * @param data - The user data from the API (will be sanitized automatically)
+     */
+    constructor(api, data) {
+        this.data = this.sanitizeData(data);
+        // Make userAPI non-enumerable so it doesn't show up in console.log
+        Object.defineProperty(this, 'userAPI', {
+            value: api,
+            writable: true,
+            enumerable: false,
+            configurable: true
+        });
+    }
+    /**
+     * Removes sensitive fields from the data before storing
+     * @param data - The raw user data to sanitize
+     * @returns Sanitized data with sensitive fields removed
+     * @private
+     */
+    sanitizeData(data) {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        // Create a copy of the data to avoid mutating the original
+        const sanitized = { ...data };
+        // Remove sensitive fields
+        const sensitiveFields = ['apiKey', 'agentId', 'userId', 'token', 'secret', 'key'];
+        sensitiveFields.forEach(field => {
+            delete sanitized[field];
+        });
+        return sanitized;
+    }
+    /**
+     * Custom toJSON method to control what gets serialized when logging
+     * @returns Serialized user data
+     */
+    toJSON() {
+        return this.data;
+    }
+    /**
+     * Custom inspect method for Node.js console.log
+     * @returns Formatted user data for console output
+     */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return this.data;
+    }
+    /**
+     * Updates the user's data
+     * @param data - The data fields to update or add to user data
+     * @returns Promise resolving to the updated sanitized user data
+     * @throws Error if the update fails
+     */
+    async update(data) {
+        try {
+            const response = await this.userAPI.update(data);
+            this.data = this.sanitizeData(response.data);
+            return this.data;
+        }
+        catch (error) {
+            throw new Error('Failed to update user data');
+        }
+    }
+    /**
+     * Clears all user data for the current user
+     * @returns Promise resolving to true if clearing was successful
+     * @throws Error if the clear operation fails
+     */
+    async clear() {
+        try {
+            await this.userAPI.clear();
+            return true;
+        }
+        catch (error) {
+            throw new Error('Failed to clear user data');
+        }
+    }
+}

package/dist/config/auth.constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Constants for authentication service
+ */
+/**
+ * Keytar service name for secure credential storage
+ */
+export declare const KEYTAR_SERVICE = "lua-cli";
+/**
+ * Keytar account name for API key storage
+ */
+export declare const KEYTAR_ACCOUNT = "api-key";

package/dist/config/auth.constants.js

@@ -0,0 +1,11 @@
+/**
+ * Constants for authentication service
+ */
+/**
+ * Keytar service name for secure credential storage
+ */
+export const KEYTAR_SERVICE = "lua-cli";
+/**
+ * Keytar account name for API key storage
+ */
+export const KEYTAR_ACCOUNT = "api-key";