@back23/promptly-sdk 1.3.1 → 2.0.0

package/dist/index.d.mts

@@ -4,6 +4,8 @@
 interface PromptlyConfig {
     /** Tenant ID (subdomain) */
     tenantId: string;
+    /** API key (required) - Get from Dashboard > Settings > API Tokens */
+    apiKey: string;
     /** Base URL of Promptly API */
     baseUrl?: string;
     /** Request timeout in milliseconds */
@@ -744,6 +746,7 @@ declare class HttpClient {
     private tenantId;
     private timeout;
     private token;
+    private apiKey;
     constructor(config: PromptlyConfig);
     /**
      * Set authentication token
@@ -757,12 +760,21 @@ declare class HttpClient {
      * Check if authenticated
      */
     isAuthenticated(): boolean;
+    /**
+     * Set API key for server-to-server authentication
+     */
+    setApiKey(apiKey: string | null): void;
+    /**
+     * Get current API key
+     */
+    getApiKey(): string | null;
     /**
      * Build full URL with query params
      */
     private buildUrl;
     /**
      * Build request headers
+     * API key takes precedence over bearer token for server-to-server auth
      */
     private buildHeaders;
     /**
@@ -1354,6 +1366,7 @@ declare class ReservationResource {
  * Promptly SDK
  *
  * A TypeScript/JavaScript SDK for the Promptly AI CMS platform.
+ * API Key is required for all API requests.
  *
  * @example
  * ```typescript
@@ -1361,18 +1374,12 @@ declare class ReservationResource {
  *
  * const client = new Promptly({
  *   tenantId: 'my-site',
- *   baseUrl: 'https://promptly.webbyon.com',
+ *   apiKey: 'pky_your_api_key_here',  // Required
  * });
  *
- * // Public API
+ * // All APIs require API key
  * const posts = await client.blog.list();
  * const products = await client.shop.listProducts();
- *
- * // Authentication
- * await client.auth.login({ email: 'user@example.com', password: 'password' });
- *
- * // Protected API
- * const orders = await client.shop.listOrders();
  * ```
  */
 
@@ -1419,6 +1426,26 @@ declare class Promptly {
      * Get current authentication token
      */
     getToken(): string | null;
+    /**
+     * Set API key for server-to-server authentication
+     * Alternative to user token authentication
+     *
+     * @example
+     * ```typescript
+     * const client = new Promptly({
+     *   tenantId: 'my-site',
+     *   apiKey: 'pky_your_api_key_here',
+     * });
+     *
+     * // Or set later
+     * client.setApiKey('pky_your_api_key_here');
+     * ```
+     */
+    setApiKey(apiKey: string | null): void;
+    /**
+     * Get current API key
+     */
+    getApiKey(): string | null;
 }
 
 export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type BoardSettings, type Cart, type CartItem, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };

package/dist/index.d.ts

@@ -4,6 +4,8 @@
 interface PromptlyConfig {
     /** Tenant ID (subdomain) */
     tenantId: string;
+    /** API key (required) - Get from Dashboard > Settings > API Tokens */
+    apiKey: string;
     /** Base URL of Promptly API */
     baseUrl?: string;
     /** Request timeout in milliseconds */
@@ -744,6 +746,7 @@ declare class HttpClient {
     private tenantId;
     private timeout;
     private token;
+    private apiKey;
     constructor(config: PromptlyConfig);
     /**
      * Set authentication token
@@ -757,12 +760,21 @@ declare class HttpClient {
      * Check if authenticated
      */
     isAuthenticated(): boolean;
+    /**
+     * Set API key for server-to-server authentication
+     */
+    setApiKey(apiKey: string | null): void;
+    /**
+     * Get current API key
+     */
+    getApiKey(): string | null;
     /**
      * Build full URL with query params
      */
     private buildUrl;
     /**
      * Build request headers
+     * API key takes precedence over bearer token for server-to-server auth
      */
     private buildHeaders;
     /**
@@ -1354,6 +1366,7 @@ declare class ReservationResource {
  * Promptly SDK
  *
  * A TypeScript/JavaScript SDK for the Promptly AI CMS platform.
+ * API Key is required for all API requests.
  *
  * @example
  * ```typescript
@@ -1361,18 +1374,12 @@ declare class ReservationResource {
  *
  * const client = new Promptly({
  *   tenantId: 'my-site',
- *   baseUrl: 'https://promptly.webbyon.com',
+ *   apiKey: 'pky_your_api_key_here',  // Required
  * });
  *
- * // Public API
+ * // All APIs require API key
  * const posts = await client.blog.list();
  * const products = await client.shop.listProducts();
- *
- * // Authentication
- * await client.auth.login({ email: 'user@example.com', password: 'password' });
- *
- * // Protected API
- * const orders = await client.shop.listOrders();
  * ```
  */
 
@@ -1419,6 +1426,26 @@ declare class Promptly {
      * Get current authentication token
      */
     getToken(): string | null;
+    /**
+     * Set API key for server-to-server authentication
+     * Alternative to user token authentication
+     *
+     * @example
+     * ```typescript
+     * const client = new Promptly({
+     *   tenantId: 'my-site',
+     *   apiKey: 'pky_your_api_key_here',
+     * });
+     *
+     * // Or set later
+     * client.setApiKey('pky_your_api_key_here');
+     * ```
+     */
+    setApiKey(apiKey: string | null): void;
+    /**
+     * Get current API key
+     */
+    getApiKey(): string | null;
 }
 
 export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, type AvailableDatesParams, type AvailableSlotsParams, type BlogListParams, type BlogPost, type Board, type BoardComment, type BoardListParams, type BoardPost, type BoardSettings, type Cart, type CartItem, type Coupon, type CouponType, type CouponValidation, type CreateCommentData, type CreateEntityRecordData, type CreateOrderData, type CreatePostData, type CreateReservationData, type CreateReservationResult, type CustomEntity, type EntityField, type EntityListParams, type EntityRecord, type EntitySchema, type ForgotPasswordData, type Form, type FormField, type FormFieldOption, type FormFieldType, type FormFieldValidation, type FormListParams, type FormSettings, type FormSubmission, type ListParams, type ListResponse, type LoginCredentials, type Media, type Member, type Order, type OrderItem, type OrderListParams, type OrderStatus, type PaginatedResponse, type PaginationMeta, type Payment, type PaymentCancelData, type PaymentConfirmData, type PaymentMethod, type PaymentReadyData, type PaymentStatus, type PostListParams, type Product, type ProductCategory, type ProductListParams, type ProductOption, type ProductOptionValue, type ProductStatus, type ProductVariant, Promptly, type PromptlyConfig, PromptlyError, type RegisterData, type Reservation, type ReservationListParams, type ReservationService, type ReservationSettings, type ReservationSlot, type ReservationStaff, type ReservationStaffSummary, type ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };

package/dist/index.js

@@ -70,9 +70,11 @@ var PromptlyError = class extends Error {
 var HttpClient = class {
   constructor(config) {
     this.token = null;
+    this.apiKey = null;
     this.tenantId = config.tenantId;
     this.baseUrl = (config.baseUrl || "https://promptly.webbyon.com").replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
+    this.apiKey = config.apiKey || null;
   }
   /**
    * Set authentication token
@@ -90,7 +92,19 @@ var HttpClient = class {
    * Check if authenticated
    */
   isAuthenticated() {
-    return this.token !== null;
+    return this.token !== null || this.apiKey !== null;
+  }
+  /**
+   * Set API key for server-to-server authentication
+   */
+  setApiKey(apiKey) {
+    this.apiKey = apiKey;
+  }
+  /**
+   * Get current API key
+   */
+  getApiKey() {
+    return this.apiKey;
   }
   /**
    * Build full URL with query params
@@ -108,6 +122,7 @@ var HttpClient = class {
   }
   /**
    * Build request headers
+   * API key takes precedence over bearer token for server-to-server auth
    */
   buildHeaders(customHeaders) {
     const headers = {
@@ -115,7 +130,9 @@ var HttpClient = class {
       "Accept": "application/json",
       ...customHeaders
     };
-    if (this.token) {
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    } else if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     return headers;
@@ -208,7 +225,9 @@ var HttpClient = class {
     const headers = {
       "Accept": "application/json"
     };
-    if (this.token) {
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    } else if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     const controller = new AbortController();
@@ -971,14 +990,14 @@ var ReservationResource = class {
    * @returns Reservation settings for the tenant
    */
   async getSettings() {
-    return this.http.get("/public/reservations/settings");
+    return this.http.get("/public/reservation/settings");
   }
   /**
    * List available services
    * @returns Array of services (always an array)
    */
   async listServices() {
-    const response = await this.http.getList("/public/reservations/services");
+    const response = await this.http.getList("/public/reservation/services");
     return response.data;
   }
   /**
@@ -988,7 +1007,7 @@ var ReservationResource = class {
    */
   async listStaff(serviceId) {
     const params = serviceId ? { service_id: serviceId } : void 0;
-    const response = await this.http.getList("/public/reservations/staffs", params);
+    const response = await this.http.getList("/public/reservation/staffs", params);
     return response.data;
   }
   /**
@@ -996,7 +1015,7 @@ var ReservationResource = class {
    * @returns Array of available date strings (YYYY-MM-DD)
    */
   async getAvailableDates(params) {
-    const response = await this.http.get("/public/reservations/dates", params);
+    const response = await this.http.get("/public/reservation/available-dates", params);
     return Array.isArray(response) ? response : response?.data ?? [];
   }
   /**
@@ -1004,7 +1023,7 @@ var ReservationResource = class {
    * @returns Array of available slots (always an array)
    */
   async getAvailableSlots(params) {
-    const response = await this.http.get("/public/reservations/slots", params);
+    const response = await this.http.get("/public/reservation/available-slots", params);
     return Array.isArray(response) ? response : response?.data ?? [];
   }
   // ============================================
@@ -1065,6 +1084,9 @@ var ReservationResource = class {
 // src/index.ts
 var Promptly = class {
   constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required. Get your API key from Dashboard > Settings > API Tokens");
+    }
     this.http = new HttpClient(config);
     this.auth = new AuthResource(this.http);
     this.boards = new BoardsResource(this.http);
@@ -1105,6 +1127,30 @@ var Promptly = class {
   getToken() {
     return this.auth.getToken();
   }
+  /**
+   * Set API key for server-to-server authentication
+   * Alternative to user token authentication
+   *
+   * @example
+   * ```typescript
+   * const client = new Promptly({
+   *   tenantId: 'my-site',
+   *   apiKey: 'pky_your_api_key_here',
+   * });
+   *
+   * // Or set later
+   * client.setApiKey('pky_your_api_key_here');
+   * ```
+   */
+  setApiKey(apiKey) {
+    this.http.setApiKey(apiKey);
+  }
+  /**
+   * Get current API key
+   */
+  getApiKey() {
+    return this.http.getApiKey();
+  }
 };
 var index_default = Promptly;
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -42,9 +42,11 @@ var PromptlyError = class extends Error {
 var HttpClient = class {
   constructor(config) {
     this.token = null;
+    this.apiKey = null;
     this.tenantId = config.tenantId;
     this.baseUrl = (config.baseUrl || "https://promptly.webbyon.com").replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
+    this.apiKey = config.apiKey || null;
   }
   /**
    * Set authentication token
@@ -62,7 +64,19 @@ var HttpClient = class {
    * Check if authenticated
    */
   isAuthenticated() {
-    return this.token !== null;
+    return this.token !== null || this.apiKey !== null;
+  }
+  /**
+   * Set API key for server-to-server authentication
+   */
+  setApiKey(apiKey) {
+    this.apiKey = apiKey;
+  }
+  /**
+   * Get current API key
+   */
+  getApiKey() {
+    return this.apiKey;
   }
   /**
    * Build full URL with query params
@@ -80,6 +94,7 @@ var HttpClient = class {
   }
   /**
    * Build request headers
+   * API key takes precedence over bearer token for server-to-server auth
    */
   buildHeaders(customHeaders) {
     const headers = {
@@ -87,7 +102,9 @@ var HttpClient = class {
       "Accept": "application/json",
       ...customHeaders
     };
-    if (this.token) {
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    } else if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     return headers;
@@ -180,7 +197,9 @@ var HttpClient = class {
     const headers = {
       "Accept": "application/json"
     };
-    if (this.token) {
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    } else if (this.token) {
       headers["Authorization"] = `Bearer ${this.token}`;
     }
     const controller = new AbortController();
@@ -943,14 +962,14 @@ var ReservationResource = class {
    * @returns Reservation settings for the tenant
    */
   async getSettings() {
-    return this.http.get("/public/reservations/settings");
+    return this.http.get("/public/reservation/settings");
   }
   /**
    * List available services
    * @returns Array of services (always an array)
    */
   async listServices() {
-    const response = await this.http.getList("/public/reservations/services");
+    const response = await this.http.getList("/public/reservation/services");
     return response.data;
   }
   /**
@@ -960,7 +979,7 @@ var ReservationResource = class {
    */
   async listStaff(serviceId) {
     const params = serviceId ? { service_id: serviceId } : void 0;
-    const response = await this.http.getList("/public/reservations/staffs", params);
+    const response = await this.http.getList("/public/reservation/staffs", params);
     return response.data;
   }
   /**
@@ -968,7 +987,7 @@ var ReservationResource = class {
    * @returns Array of available date strings (YYYY-MM-DD)
    */
   async getAvailableDates(params) {
-    const response = await this.http.get("/public/reservations/dates", params);
+    const response = await this.http.get("/public/reservation/available-dates", params);
     return Array.isArray(response) ? response : response?.data ?? [];
   }
   /**
@@ -976,7 +995,7 @@ var ReservationResource = class {
    * @returns Array of available slots (always an array)
    */
   async getAvailableSlots(params) {
-    const response = await this.http.get("/public/reservations/slots", params);
+    const response = await this.http.get("/public/reservation/available-slots", params);
     return Array.isArray(response) ? response : response?.data ?? [];
   }
   // ============================================
@@ -1037,6 +1056,9 @@ var ReservationResource = class {
 // src/index.ts
 var Promptly = class {
   constructor(config) {
+    if (!config.apiKey) {
+      throw new Error("API key is required. Get your API key from Dashboard > Settings > API Tokens");
+    }
     this.http = new HttpClient(config);
     this.auth = new AuthResource(this.http);
     this.boards = new BoardsResource(this.http);
@@ -1077,6 +1099,30 @@ var Promptly = class {
   getToken() {
     return this.auth.getToken();
   }
+  /**
+   * Set API key for server-to-server authentication
+   * Alternative to user token authentication
+   *
+   * @example
+   * ```typescript
+   * const client = new Promptly({
+   *   tenantId: 'my-site',
+   *   apiKey: 'pky_your_api_key_here',
+   * });
+   *
+   * // Or set later
+   * client.setApiKey('pky_your_api_key_here');
+   * ```
+   */
+  setApiKey(apiKey) {
+    this.http.setApiKey(apiKey);
+  }
+  /**
+   * Get current API key
+   */
+  getApiKey() {
+    return this.http.getApiKey();
+  }
 };
 var index_default = Promptly;
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@back23/promptly-sdk",
-  "version": "1.3.1",
+  "version": "2.0.0",
   "description": "Promptly AI CMS SDK for JavaScript/TypeScript",
   "main": "dist/index.js",
   "module": "dist/index.mjs",