@back23/promptly-sdk 1.2.0 → 1.3.0

package/dist/index.d.mts

@@ -620,6 +620,110 @@ interface UpdateEntityRecordData {
     status?: 'active' | 'archived' | 'draft';
 }
 
+/**
+ * Reservation types for Promptly SDK
+ */
+interface ReservationService {
+    id: number;
+    name: string;
+    slug: string;
+    description: string | null;
+    thumbnail: string | null;
+    duration: number;
+    price: number;
+    requires_staff: boolean;
+    requires_payment: boolean;
+    deposit: number;
+    staffs: ReservationStaffSummary[];
+}
+interface ReservationStaff {
+    id: number;
+    name: string;
+    avatar: string | null;
+    bio: string | null;
+}
+interface ReservationStaffSummary {
+    id: number;
+    name: string;
+    avatar: string | null;
+}
+interface ReservationSlot {
+    time: string;
+    available: boolean;
+    staff_id?: number;
+}
+interface ReservationSettings {
+    timezone: string;
+    slot_interval: number;
+    min_notice_hours: number;
+    max_advance_days: number;
+    cancellation_hours: number;
+    allow_online_payment: boolean;
+    bookable_date_range: {
+        start: string;
+        end: string;
+    };
+}
+interface Reservation {
+    id: number;
+    reservation_number: string;
+    status: 'pending' | 'confirmed' | 'completed' | 'cancelled' | 'no_show';
+    status_label: string;
+    reservation_date: string;
+    start_time: string;
+    end_time: string;
+    time_range: string;
+    customer_name: string;
+    customer_phone: string | null;
+    customer_email: string | null;
+    price: number;
+    deposit: number;
+    payment_status: 'pending' | 'paid' | 'refunded' | 'partial';
+    payment_status_label: string;
+    customer_memo: string | null;
+    can_cancel: boolean;
+    service: {
+        id: number;
+        name: string;
+        duration: number;
+    } | null;
+    staff: ReservationStaffSummary | null;
+    created_at: string;
+}
+interface CreateReservationData {
+    service_id: number;
+    staff_id?: number;
+    reservation_date: string;
+    start_time: string;
+    customer_name: string;
+    customer_phone?: string;
+    customer_email?: string;
+    customer_memo?: string;
+}
+interface CreateReservationResult {
+    reservation: Reservation;
+    requires_payment: boolean;
+    deposit: number;
+}
+interface AvailableDatesParams {
+    service_id: number;
+    staff_id?: number;
+    start_date?: string;
+    end_date?: string;
+}
+interface AvailableSlotsParams {
+    service_id: number;
+    date: string;
+    staff_id?: number;
+}
+interface ReservationListParams {
+    status?: string;
+    upcoming?: boolean;
+    past?: boolean;
+    per_page?: number;
+    page?: number;
+}
+
 /**
  * HTTP Client for Promptly SDK
  */
@@ -1181,6 +1285,71 @@ declare class EntitiesResource {
     };
 }
 
+/**
+ * Reservation Resource for Promptly SDK
+ */
+
+declare class ReservationResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get reservation settings
+     * @returns Reservation settings for the tenant
+     */
+    getSettings(): Promise<ReservationSettings>;
+    /**
+     * List available services
+     * @returns Array of services (always an array)
+     */
+    listServices(): Promise<ReservationService[]>;
+    /**
+     * List available staff members
+     * @param serviceId - Optional: filter staff by service
+     * @returns Array of staff members (always an array)
+     */
+    listStaff(serviceId?: number): Promise<ReservationStaff[]>;
+    /**
+     * Get available dates for booking
+     * @returns Array of available date strings (YYYY-MM-DD)
+     */
+    getAvailableDates(params: AvailableDatesParams): Promise<string[]>;
+    /**
+     * Get available time slots for a specific date
+     * @returns Array of available slots (always an array)
+     */
+    getAvailableSlots(params: AvailableSlotsParams): Promise<ReservationSlot[]>;
+    /**
+     * Create a new reservation
+     * @returns Created reservation with payment info
+     */
+    create(data: CreateReservationData): Promise<CreateReservationResult>;
+    /**
+     * List my reservations
+     * @returns ListResponse with reservations and pagination meta
+     */
+    list(params?: ReservationListParams): Promise<ListResponse<Reservation>>;
+    /**
+     * Get upcoming reservations
+     * @returns Array of upcoming reservations
+     */
+    upcoming(limit?: number): Promise<Reservation[]>;
+    /**
+     * Get past reservations
+     * @returns Array of past reservations
+     */
+    past(limit?: number): Promise<Reservation[]>;
+    /**
+     * Get reservation by reservation number
+     */
+    get(reservationNumber: string): Promise<Reservation>;
+    /**
+     * Cancel a reservation
+     * @param reservationNumber - Reservation number to cancel
+     * @param reason - Optional cancellation reason
+     */
+    cancel(reservationNumber: string, reason?: string): Promise<Reservation>;
+}
+
 /**
  * Promptly SDK
  *
@@ -1223,6 +1392,8 @@ declare class Promptly {
     readonly media: MediaResource;
     /** Custom entities - dynamic data structures created by AI */
     readonly entities: EntitiesResource;
+    /** Reservations - booking services and time slots */
+    readonly reservation: ReservationResource;
     constructor(config: PromptlyConfig);
     /**
      * Get site theme settings
@@ -1250,4 +1421,4 @@ declare class Promptly {
     getToken(): string | null;
 }
 
-export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, 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 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 ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };
+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

@@ -620,6 +620,110 @@ interface UpdateEntityRecordData {
     status?: 'active' | 'archived' | 'draft';
 }
 
+/**
+ * Reservation types for Promptly SDK
+ */
+interface ReservationService {
+    id: number;
+    name: string;
+    slug: string;
+    description: string | null;
+    thumbnail: string | null;
+    duration: number;
+    price: number;
+    requires_staff: boolean;
+    requires_payment: boolean;
+    deposit: number;
+    staffs: ReservationStaffSummary[];
+}
+interface ReservationStaff {
+    id: number;
+    name: string;
+    avatar: string | null;
+    bio: string | null;
+}
+interface ReservationStaffSummary {
+    id: number;
+    name: string;
+    avatar: string | null;
+}
+interface ReservationSlot {
+    time: string;
+    available: boolean;
+    staff_id?: number;
+}
+interface ReservationSettings {
+    timezone: string;
+    slot_interval: number;
+    min_notice_hours: number;
+    max_advance_days: number;
+    cancellation_hours: number;
+    allow_online_payment: boolean;
+    bookable_date_range: {
+        start: string;
+        end: string;
+    };
+}
+interface Reservation {
+    id: number;
+    reservation_number: string;
+    status: 'pending' | 'confirmed' | 'completed' | 'cancelled' | 'no_show';
+    status_label: string;
+    reservation_date: string;
+    start_time: string;
+    end_time: string;
+    time_range: string;
+    customer_name: string;
+    customer_phone: string | null;
+    customer_email: string | null;
+    price: number;
+    deposit: number;
+    payment_status: 'pending' | 'paid' | 'refunded' | 'partial';
+    payment_status_label: string;
+    customer_memo: string | null;
+    can_cancel: boolean;
+    service: {
+        id: number;
+        name: string;
+        duration: number;
+    } | null;
+    staff: ReservationStaffSummary | null;
+    created_at: string;
+}
+interface CreateReservationData {
+    service_id: number;
+    staff_id?: number;
+    reservation_date: string;
+    start_time: string;
+    customer_name: string;
+    customer_phone?: string;
+    customer_email?: string;
+    customer_memo?: string;
+}
+interface CreateReservationResult {
+    reservation: Reservation;
+    requires_payment: boolean;
+    deposit: number;
+}
+interface AvailableDatesParams {
+    service_id: number;
+    staff_id?: number;
+    start_date?: string;
+    end_date?: string;
+}
+interface AvailableSlotsParams {
+    service_id: number;
+    date: string;
+    staff_id?: number;
+}
+interface ReservationListParams {
+    status?: string;
+    upcoming?: boolean;
+    past?: boolean;
+    per_page?: number;
+    page?: number;
+}
+
 /**
  * HTTP Client for Promptly SDK
  */
@@ -1181,6 +1285,71 @@ declare class EntitiesResource {
     };
 }
 
+/**
+ * Reservation Resource for Promptly SDK
+ */
+
+declare class ReservationResource {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get reservation settings
+     * @returns Reservation settings for the tenant
+     */
+    getSettings(): Promise<ReservationSettings>;
+    /**
+     * List available services
+     * @returns Array of services (always an array)
+     */
+    listServices(): Promise<ReservationService[]>;
+    /**
+     * List available staff members
+     * @param serviceId - Optional: filter staff by service
+     * @returns Array of staff members (always an array)
+     */
+    listStaff(serviceId?: number): Promise<ReservationStaff[]>;
+    /**
+     * Get available dates for booking
+     * @returns Array of available date strings (YYYY-MM-DD)
+     */
+    getAvailableDates(params: AvailableDatesParams): Promise<string[]>;
+    /**
+     * Get available time slots for a specific date
+     * @returns Array of available slots (always an array)
+     */
+    getAvailableSlots(params: AvailableSlotsParams): Promise<ReservationSlot[]>;
+    /**
+     * Create a new reservation
+     * @returns Created reservation with payment info
+     */
+    create(data: CreateReservationData): Promise<CreateReservationResult>;
+    /**
+     * List my reservations
+     * @returns ListResponse with reservations and pagination meta
+     */
+    list(params?: ReservationListParams): Promise<ListResponse<Reservation>>;
+    /**
+     * Get upcoming reservations
+     * @returns Array of upcoming reservations
+     */
+    upcoming(limit?: number): Promise<Reservation[]>;
+    /**
+     * Get past reservations
+     * @returns Array of past reservations
+     */
+    past(limit?: number): Promise<Reservation[]>;
+    /**
+     * Get reservation by reservation number
+     */
+    get(reservationNumber: string): Promise<Reservation>;
+    /**
+     * Cancel a reservation
+     * @param reservationNumber - Reservation number to cancel
+     * @param reason - Optional cancellation reason
+     */
+    cancel(reservationNumber: string, reason?: string): Promise<Reservation>;
+}
+
 /**
  * Promptly SDK
  *
@@ -1223,6 +1392,8 @@ declare class Promptly {
     readonly media: MediaResource;
     /** Custom entities - dynamic data structures created by AI */
     readonly entities: EntitiesResource;
+    /** Reservations - booking services and time slots */
+    readonly reservation: ReservationResource;
     constructor(config: PromptlyConfig);
     /**
      * Get site theme settings
@@ -1250,4 +1421,4 @@ declare class Promptly {
     getToken(): string | null;
 }
 
-export { type AddToCartData, type ApiError, type ApiResponse, type ApplyCouponData, type AuthResponse, 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 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 ResetPasswordData, type SocialAuthUrl, type SocialProvider, type SubmissionListParams, type SubmitFormData, type UpdateCartItemData, type UpdateCommentData, type UpdateEntityRecordData, type UpdatePostData, type UpdateProfileData, Promptly as default };
+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

@@ -958,6 +958,110 @@ var EntitiesResource = class {
   }
 };
 
+// src/resources/reservation.ts
+var ReservationResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // ============================================
+  // Public Endpoints
+  // ============================================
+  /**
+   * Get reservation settings
+   * @returns Reservation settings for the tenant
+   */
+  async getSettings() {
+    return this.http.get("/public/reservations/settings");
+  }
+  /**
+   * List available services
+   * @returns Array of services (always an array)
+   */
+  async listServices() {
+    const response = await this.http.getList("/public/reservations/services");
+    return response.data;
+  }
+  /**
+   * List available staff members
+   * @param serviceId - Optional: filter staff by service
+   * @returns Array of staff members (always an array)
+   */
+  async listStaff(serviceId) {
+    const params = serviceId ? { service_id: serviceId } : void 0;
+    const response = await this.http.getList("/public/reservations/staffs", params);
+    return response.data;
+  }
+  /**
+   * Get available dates for booking
+   * @returns Array of available date strings (YYYY-MM-DD)
+   */
+  async getAvailableDates(params) {
+    const response = await this.http.get("/public/reservations/dates", params);
+    return Array.isArray(response) ? response : response?.data ?? [];
+  }
+  /**
+   * Get available time slots for a specific date
+   * @returns Array of available slots (always an array)
+   */
+  async getAvailableSlots(params) {
+    const response = await this.http.get("/public/reservations/slots", params);
+    return Array.isArray(response) ? response : response?.data ?? [];
+  }
+  // ============================================
+  // Protected Endpoints (requires auth)
+  // ============================================
+  /**
+   * Create a new reservation
+   * @returns Created reservation with payment info
+   */
+  async create(data) {
+    return this.http.post("/reservations", data);
+  }
+  /**
+   * List my reservations
+   * @returns ListResponse with reservations and pagination meta
+   */
+  async list(params) {
+    return this.http.getList("/reservations", params);
+  }
+  /**
+   * Get upcoming reservations
+   * @returns Array of upcoming reservations
+   */
+  async upcoming(limit = 10) {
+    const response = await this.http.getList("/reservations", {
+      upcoming: true,
+      per_page: limit
+    });
+    return response.data;
+  }
+  /**
+   * Get past reservations
+   * @returns Array of past reservations
+   */
+  async past(limit = 10) {
+    const response = await this.http.getList("/reservations", {
+      past: true,
+      per_page: limit
+    });
+    return response.data;
+  }
+  /**
+   * Get reservation by reservation number
+   */
+  async get(reservationNumber) {
+    return this.http.get(`/reservations/${reservationNumber}`);
+  }
+  /**
+   * Cancel a reservation
+   * @param reservationNumber - Reservation number to cancel
+   * @param reason - Optional cancellation reason
+   */
+  async cancel(reservationNumber, reason) {
+    return this.http.post(`/reservations/${reservationNumber}/cancel`, { reason });
+  }
+};
+
 // src/index.ts
 var Promptly = class {
   constructor(config) {
@@ -969,6 +1073,7 @@ var Promptly = class {
     this.shop = new ShopResource(this.http);
     this.media = new MediaResource(this.http);
     this.entities = new EntitiesResource(this.http);
+    this.reservation = new ReservationResource(this.http);
   }
   /**
    * Get site theme settings

package/dist/index.mjs

@@ -930,6 +930,110 @@ var EntitiesResource = class {
   }
 };
 
+// src/resources/reservation.ts
+var ReservationResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // ============================================
+  // Public Endpoints
+  // ============================================
+  /**
+   * Get reservation settings
+   * @returns Reservation settings for the tenant
+   */
+  async getSettings() {
+    return this.http.get("/public/reservations/settings");
+  }
+  /**
+   * List available services
+   * @returns Array of services (always an array)
+   */
+  async listServices() {
+    const response = await this.http.getList("/public/reservations/services");
+    return response.data;
+  }
+  /**
+   * List available staff members
+   * @param serviceId - Optional: filter staff by service
+   * @returns Array of staff members (always an array)
+   */
+  async listStaff(serviceId) {
+    const params = serviceId ? { service_id: serviceId } : void 0;
+    const response = await this.http.getList("/public/reservations/staffs", params);
+    return response.data;
+  }
+  /**
+   * Get available dates for booking
+   * @returns Array of available date strings (YYYY-MM-DD)
+   */
+  async getAvailableDates(params) {
+    const response = await this.http.get("/public/reservations/dates", params);
+    return Array.isArray(response) ? response : response?.data ?? [];
+  }
+  /**
+   * Get available time slots for a specific date
+   * @returns Array of available slots (always an array)
+   */
+  async getAvailableSlots(params) {
+    const response = await this.http.get("/public/reservations/slots", params);
+    return Array.isArray(response) ? response : response?.data ?? [];
+  }
+  // ============================================
+  // Protected Endpoints (requires auth)
+  // ============================================
+  /**
+   * Create a new reservation
+   * @returns Created reservation with payment info
+   */
+  async create(data) {
+    return this.http.post("/reservations", data);
+  }
+  /**
+   * List my reservations
+   * @returns ListResponse with reservations and pagination meta
+   */
+  async list(params) {
+    return this.http.getList("/reservations", params);
+  }
+  /**
+   * Get upcoming reservations
+   * @returns Array of upcoming reservations
+   */
+  async upcoming(limit = 10) {
+    const response = await this.http.getList("/reservations", {
+      upcoming: true,
+      per_page: limit
+    });
+    return response.data;
+  }
+  /**
+   * Get past reservations
+   * @returns Array of past reservations
+   */
+  async past(limit = 10) {
+    const response = await this.http.getList("/reservations", {
+      past: true,
+      per_page: limit
+    });
+    return response.data;
+  }
+  /**
+   * Get reservation by reservation number
+   */
+  async get(reservationNumber) {
+    return this.http.get(`/reservations/${reservationNumber}`);
+  }
+  /**
+   * Cancel a reservation
+   * @param reservationNumber - Reservation number to cancel
+   * @param reason - Optional cancellation reason
+   */
+  async cancel(reservationNumber, reason) {
+    return this.http.post(`/reservations/${reservationNumber}/cancel`, { reason });
+  }
+};
+
 // src/index.ts
 var Promptly = class {
   constructor(config) {
@@ -941,6 +1045,7 @@ var Promptly = class {
     this.shop = new ShopResource(this.http);
     this.media = new MediaResource(this.http);
     this.entities = new EntitiesResource(this.http);
+    this.reservation = new ReservationResource(this.http);
   }
   /**
    * Get site theme settings

package/package.json

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