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

package/dist/interfaces/orders.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Order Interfaces
+ * Order management and fulfillment
+ */
+import { BasketItem } from "./baskets.js";
+/**
+ * Order status enumeration.
+ * Represents the lifecycle states of an order.
+ */
+export declare enum OrderStatus {
+    /** Order created but not yet confirmed */
+    PENDING = "pending",
+    /** Order confirmed and being processed */
+    CONFIRMED = "confirmed",
+    /** Order completed and delivered */
+    FULFILLED = "fulfilled",
+    /** Order cancelled */
+    CANCELLED = "cancelled"
+}
+/**
+ * Order data container.
+ * Contains the order details, items, and metadata.
+ */
+export interface OrderData {
+    currency: string;
+    items: BasketItem[];
+    createdAt: string;
+    basketId: string;
+    orderDate: string;
+    orderId: string;
+    [key: string]: any;
+}
+/**
+ * Common order properties.
+ * Calculated/derived properties maintained by the system.
+ */
+export interface OrderCommon {
+    status: 'pending' | 'confirmed' | 'fulfilled' | 'cancelled';
+    totalAmount: string | number;
+    currency: string;
+    itemCount: number;
+}
+/**
+ * Complete order entity.
+ * Full order object as stored in the database.
+ */
+export interface OrderResponse {
+    id: string;
+    userId: string;
+    agentId: string;
+    orderId: string;
+    data: OrderData;
+    common: OrderCommon;
+    createdAt: string;
+    updatedAt: string;
+    __v: number;
+}
+/**
+ * Request to create a new order.
+ * Typically created from a basket.
+ */
+export interface CreateOrderRequest {
+    basketId: string;
+    data: {
+        [key: string]: any;
+    };
+}
+/**
+ * Response from order creation.
+ */
+export interface CreateOrderResponse {
+    success: boolean;
+    message: string;
+    data: OrderResponse;
+}
+/**
+ * Response from updating order status.
+ */
+export interface UpdateOrderStatusResponse {
+    success: boolean;
+    message: string;
+    data: OrderResponse;
+}
+/**
+ * Response from getting user orders.
+ */
+export interface GetUserOrdersResponse {
+    success: boolean;
+    message: string;
+    data: OrderResponse[];
+}

package/dist/interfaces/orders.js

@@ -0,0 +1,19 @@
+/**
+ * Order Interfaces
+ * Order management and fulfillment
+ */
+/**
+ * Order status enumeration.
+ * Represents the lifecycle states of an order.
+ */
+export var OrderStatus;
+(function (OrderStatus) {
+    /** Order created but not yet confirmed */
+    OrderStatus["PENDING"] = "pending";
+    /** Order confirmed and being processed */
+    OrderStatus["CONFIRMED"] = "confirmed";
+    /** Order completed and delivered */
+    OrderStatus["FULFILLED"] = "fulfilled";
+    /** Order cancelled */
+    OrderStatus["CANCELLED"] = "cancelled";
+})(OrderStatus || (OrderStatus = {}));

package/dist/interfaces/product.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Product Interfaces
+ * Product catalog management
+ */
+import { Pagination } from './common.js';
+/**
+ * Product entity.
+ * Flexible schema allows any properties to be stored.
+ *
+ * @example
+ * ```typescript
+ * const product: Product = {
+ *   id: '123',
+ *   name: 'Laptop',
+ *   price: 999.99,
+ *   category: 'Electronics',
+ *   inStock: true
+ * };
+ * ```
+ */
+export interface Product {
+    id: string;
+    [key: string]: any;
+}
+/**
+ * Response from get products API.
+ * Includes pagination for large catalogs.
+ */
+export interface ProductsResponse {
+    success: boolean;
+    data?: Product[];
+    message?: string;
+    pagination?: Pagination;
+}
+/**
+ * Response from product creation.
+ * Indicates if product was newly created or updated existing.
+ */
+export interface CreateProductResponse {
+    updated: boolean;
+    isNew: boolean;
+    product: Product;
+}
+/**
+ * Response from product update.
+ */
+export interface UpdateProductResponse {
+    updated: boolean;
+    isNew: boolean;
+    product: Product;
+}
+/**
+ * Response from product deletion.
+ */
+export interface DeleteProductResponse {
+    deleted: boolean;
+}
+/**
+ * Response from product search.
+ */
+export interface SearchProductsResponse {
+    success: boolean;
+    message: string;
+    data: Product[];
+}

package/dist/interfaces/product.js

@@ -0,0 +1,5 @@
+/**
+ * Product Interfaces
+ * Product catalog management
+ */
+export {};

package/dist/interfaces/push.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Interface definitions for push command
+ */
+/**
+ * Response from push version API endpoint
+ */
+export interface PushVersionResponse {
+    success: boolean;
+    data?: {
+        skillsId: string;
+        version: string;
+        context: string;
+        description: string;
+        tools: any[];
+        _id: string;
+        id: string;
+        createdAt: string;
+        updatedAt: string;
+        __v: number;
+    };
+    error?: {
+        message: string;
+        error: string;
+        statusCode: number;
+    };
+}

package/dist/interfaces/push.js

@@ -0,0 +1,4 @@
+/**
+ * Interface definitions for push command
+ */
+export {};

package/dist/interfaces/test.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Interface definitions for test command
+ */
+/**
+ * Tool information from deploy.json
+ */
+export interface ToolData {
+    name: string;
+    description: string;
+    inputSchema: any;
+    execute: string;
+    skillName?: string;
+}
+/**
+ * Tool choice for inquirer prompt
+ */
+export interface ToolChoice {
+    name: string;
+    value: ToolData;
+}
+/**
+ * Schema property definition
+ */
+export interface SchemaProperty {
+    type: string;
+    properties?: Record<string, SchemaProperty>;
+    required?: string[];
+    description?: string;
+}
+/**
+ * Input schema structure
+ */
+export interface InputSchema {
+    properties?: Record<string, SchemaProperty>;
+    required?: string[];
+}

package/dist/interfaces/test.js

@@ -0,0 +1,4 @@
+/**
+ * Interface definitions for test command
+ */
+export {};

package/dist/services/auth.d.ts

@@ -1,106 +1,61 @@
-import { UserData } from "../types/index.js";
+/**
+ * Authentication Service
+ * Handles all authentication operations including API key management and OTP flows
+ */
+import { UserData } from "../interfaces/admin.js";
+/**
+ * Saves API key to secure system keychain.
+ * Uses the system's native credential storage (Keychain on macOS,
+ * Credential Vault on Windows, libsecret on Linux).
+ *
+ * @param apiKey - The API key to store securely
+ * @returns Promise that resolves when key is saved
+ */
 export declare function saveApiKey(apiKey: string): Promise<void>;
+/**
+ * Loads API key from secure system keychain.
+ *
+ * @returns Promise resolving to API key or null if not found
+ */
 export declare function loadApiKey(): Promise<string | null>;
+/**
+ * Deletes API key from secure system keychain.
+ * This is used for logout functionality.
+ *
+ * @returns Promise resolving to true if deleted, false if not found
+ */
 export declare function deleteApiKey(): Promise<boolean>;
+/**
+ * Validates an API key with the server and retrieves user data.
+ * This function will exit the process if the API key is invalid.
+ *
+ * @param apiKey - The API key to validate
+ * @returns Promise resolving to user data including admin info and organizations
+ * @throws Exits process with code 1 if API key is invalid
+ */
 export declare function checkApiKey(apiKey: string): Promise<UserData>;
+/**
+ * Requests an OTP (One-Time Password) to be sent to the specified email.
+ * The OTP will be valid for a limited time and can be used once.
+ *
+ * @param email - Email address to send OTP to
+ * @returns Promise resolving to true if OTP sent successfully, false otherwise
+ */
 export declare function requestEmailOTP(email: string): Promise<boolean>;
+/**
+ * Verifies an OTP code and retrieves a sign-in token.
+ * The sign-in token can be used to generate an API key.
+ *
+ * @param email - Email address the OTP was sent to
+ * @param pin - The OTP code received via email
+ * @returns Promise resolving to sign-in token or null if verification failed
+ */
 export declare function verifyOTPAndGetToken(email: string, pin: string): Promise<string | null>;
+/**
+ * Generates a permanent API key using a sign-in token.
+ * The sign-in token is obtained from successful OTP verification.
+ *
+ * @param signInToken - Token obtained from OTP verification
+ * @returns Promise resolving to API key or null if generation failed
+ */
 export declare function generateApiKey(signInToken: string): Promise<string | null>;
-export interface CreateSkillResponse {
-    success: boolean;
-    data?: {
-        name: string;
-        public: boolean;
-        agentId: string;
-        active: boolean;
-        _id: string;
-        id: string;
-        createdAt: string;
-        updatedAt: string;
-        __v: number;
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
-    };
-}
-export interface AgentType {
-    id: string;
-    name: string;
-    features: Record<string, any>;
-    requiredSubAgentMetadata?: string[];
-}
-export interface CreateAgentRequest {
-    id: string;
-    type: string;
-    metadata: Record<string, any>;
-    persona: {
-        agentName: string;
-        businessType: string;
-        brandPersonality: string;
-        brandTraits: string;
-    };
-    features: Record<string, boolean>;
-    channels: any[];
-    org: {
-        registeredName: string;
-    };
-}
-export interface CreateAgentResponse {
-    success: boolean;
-    data?: {
-        agentId: string;
-        name: string;
-        baseAgentId: string;
-        persona: string;
-        createdAt: string;
-        welcomeMessage: string;
-        featuresOverride: Record<string, any>;
-        _id: string;
-        updatedAt: string;
-        __v: number;
-        org: {
-            registeredName: string;
-            type: string;
-            agents: string[];
-            paymentMethods: any[];
-            _id: string;
-            id: string;
-            createdAt: number;
-            __v: number;
-        };
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
-    };
-}
-export interface AgentDetailsResponse {
-    success: boolean;
-    data?: {
-        _id: string;
-        agentId: string;
-        name: string;
-        baseAgentId: string;
-        persona: string;
-        createdAt: string;
-        welcomeMessage: string;
-        featuresOverride: Record<string, any>;
-        updatedAt: string;
-        __v: number;
-        personaConfig: {
-            agentName: string;
-            businessType: string;
-            brandPersonality: string;
-            brandTraits: string;
-        };
-        skills: any[];
-    };
-    error?: {
-        message: string;
-        error: string;
-        statusCode: number;
-    };
-}

package/dist/services/auth.js

@@ -1,27 +1,76 @@
+/**
+ * Authentication Service
+ * Handles all authentication operations including API key management and OTP flows
+ */
 import keytar from "keytar";
-import { ApiService } from "./api.js";
-const SERVICE = "lua-cli";
-const ACCOUNT = "api-key";
+import AuthApi from "../api/auth.api.service.js";
+import { BASE_URLS } from "../config/constants.js";
+import { KEYTAR_SERVICE, KEYTAR_ACCOUNT } from "../config/auth.constants.js";
+// ============================================================================
+// KEYTAR OPERATIONS (Secure Local Storage)
+// ============================================================================
+/**
+ * Saves API key to secure system keychain.
+ * Uses the system's native credential storage (Keychain on macOS,
+ * Credential Vault on Windows, libsecret on Linux).
+ *
+ * @param apiKey - The API key to store securely
+ * @returns Promise that resolves when key is saved
+ */
 export async function saveApiKey(apiKey) {
-    await keytar.setPassword(SERVICE, ACCOUNT, apiKey);
+    await keytar.setPassword(KEYTAR_SERVICE, KEYTAR_ACCOUNT, apiKey);
 }
+/**
+ * Loads API key from secure system keychain.
+ *
+ * @returns Promise resolving to API key or null if not found
+ */
 export async function loadApiKey() {
-    return keytar.getPassword(SERVICE, ACCOUNT);
+    return keytar.getPassword(KEYTAR_SERVICE, KEYTAR_ACCOUNT);
 }
+/**
+ * Deletes API key from secure system keychain.
+ * This is used for logout functionality.
+ *
+ * @returns Promise resolving to true if deleted, false if not found
+ */
 export async function deleteApiKey() {
-    return keytar.deletePassword(SERVICE, ACCOUNT);
+    return keytar.deletePassword(KEYTAR_SERVICE, KEYTAR_ACCOUNT);
 }
+// ============================================================================
+// API OPERATIONS (Server Authentication)
+// ============================================================================
+/**
+ * Validates an API key with the server and retrieves user data.
+ * This function will exit the process if the API key is invalid.
+ *
+ * @param apiKey - The API key to validate
+ * @returns Promise resolving to user data including admin info and organizations
+ * @throws Exits process with code 1 if API key is invalid
+ */
 export async function checkApiKey(apiKey) {
-    const result = await ApiService.Auth.checkApiKey(apiKey);
+    const authApi = new AuthApi(BASE_URLS.API);
+    const result = await authApi.checkApiKey(apiKey);
     if (!result.success) {
         console.error(`❌ Invalid API key`);
         process.exit(1);
     }
     return result.data;
 }
+// ============================================================================
+// EMAIL OTP AUTHENTICATION FLOW
+// ============================================================================
+/**
+ * Requests an OTP (One-Time Password) to be sent to the specified email.
+ * The OTP will be valid for a limited time and can be used once.
+ *
+ * @param email - Email address to send OTP to
+ * @returns Promise resolving to true if OTP sent successfully, false otherwise
+ */
 export async function requestEmailOTP(email) {
     try {
-        const result = await ApiService.Auth.sendOtp(email);
+        const authApi = new AuthApi(BASE_URLS.AUTH);
+        const result = await authApi.sendOtp(email);
         return result.success;
     }
     catch (error) {
@@ -29,9 +78,18 @@ export async function requestEmailOTP(email) {
         return false;
     }
 }
+/**
+ * Verifies an OTP code and retrieves a sign-in token.
+ * The sign-in token can be used to generate an API key.
+ *
+ * @param email - Email address the OTP was sent to
+ * @param pin - The OTP code received via email
+ * @returns Promise resolving to sign-in token or null if verification failed
+ */
 export async function verifyOTPAndGetToken(email, pin) {
     try {
-        const result = await ApiService.Auth.verifyOtp(email, pin);
+        const authApi = new AuthApi(BASE_URLS.AUTH);
+        const result = await authApi.verifyOtp(email, pin);
         return result.success ? result.data.signInToken : null;
     }
     catch (error) {
@@ -39,9 +97,17 @@ export async function verifyOTPAndGetToken(email, pin) {
         return null;
     }
 }
+/**
+ * Generates a permanent API key using a sign-in token.
+ * The sign-in token is obtained from successful OTP verification.
+ *
+ * @param signInToken - Token obtained from OTP verification
+ * @returns Promise resolving to API key or null if generation failed
+ */
 export async function generateApiKey(signInToken) {
     try {
-        const result = await ApiService.Auth.getApiKey(signInToken);
+        const authApi = new AuthApi(BASE_URLS.AUTH);
+        const result = await authApi.getApiKey(signInToken);
         return result.success ? result.data.apiKey : null;
     }
     catch (error) {
@@ -49,5 +115,3 @@ export async function generateApiKey(signInToken) {
         return null;
     }
 }
-// API functions moved to centralized ApiService and api.ts
-// Use ApiService.getAgentTypes(), ApiService.createAgent(), ApiService.getAgentDetails() instead