@withaevum/sdk 1.2.0 → 1.3.2

package/dist/client.d.ts

@@ -3,8 +3,10 @@ import { BookingsAPI } from './bookings';
 import { OfferingsAPI } from './offerings';
 import { CustomersAPI } from './customers';
 import { ProvidersAPI } from './providers';
+import { OrgsAPI } from './orgs';
 import { CalendarAPI } from './calendar';
 import { AnalyticsAPI } from './analytics';
+import { PaymentsAPI } from './payments';
 import type { AevumClientConfig } from './types';
 /**
  * Main client class for interacting with the Aevum API
@@ -19,8 +21,10 @@ export declare class AevumClient {
     readonly offerings: OfferingsAPI;
     readonly customers: CustomersAPI;
     readonly providers: ProvidersAPI;
+    readonly orgs: OrgsAPI;
     readonly calendar: CalendarAPI;
     readonly analytics: AnalyticsAPI;
+    readonly payments: PaymentsAPI;
     constructor(config: AevumClientConfig);
     /**
      * Resolve organization ID from API key (cached after first call)

package/dist/client.js

@@ -4,8 +4,10 @@ import { BookingsAPI } from './bookings';
 import { OfferingsAPI } from './offerings';
 import { CustomersAPI } from './customers';
 import { ProvidersAPI } from './providers';
+import { OrgsAPI } from './orgs';
 import { CalendarAPI } from './calendar';
 import { AnalyticsAPI } from './analytics';
+import { PaymentsAPI } from './payments';
 import { AevumAPIError, AevumAuthenticationError, AevumNotFoundError, AevumValidationError, } from './errors';
 /**
  * Main client class for interacting with the Aevum API
@@ -18,7 +20,7 @@ export class AevumClient {
             throw new Error('API key is required');
         }
         this.apiKey = config.apiKey;
-        this.baseUrl = config.baseUrl || 'https://api.withaevum.com';
+        this.baseUrl = config.baseUrl || 'https://withaevum.com';
         // Set orgId if provided in config (avoids extra API call)
         if (config.orgId) {
             this.orgId = config.orgId;
@@ -29,8 +31,10 @@ export class AevumClient {
         this.offerings = new OfferingsAPI(this);
         this.customers = new CustomersAPI(this);
         this.providers = new ProvidersAPI(this);
+        this.orgs = new OrgsAPI(this);
         this.calendar = new CalendarAPI(this);
         this.analytics = new AnalyticsAPI(this);
+        this.payments = new PaymentsAPI(this);
     }
     /**
      * Resolve organization ID from API key (cached after first call)
@@ -122,17 +126,21 @@ export class AevumClient {
         }
         // Handle errors
         if (!response.ok) {
-            const errorData = data;
+            // Safely extract error data, handling null/undefined cases
+            const errorData = (data && typeof data === 'object') ? data : null;
+            const errorMessage = errorData?.error || `API request failed with status ${response.status}`;
+            const errorCode = errorData?.code;
+            const errorIssues = errorData?.issues;
             if (response.status === 401 || response.status === 403) {
-                throw new AevumAuthenticationError(errorData.error || 'Authentication failed', response.status);
+                throw new AevumAuthenticationError(errorMessage, response.status);
             }
             if (response.status === 404) {
-                throw new AevumNotFoundError(errorData.error || 'Resource not found');
+                throw new AevumNotFoundError(errorMessage);
             }
             if (response.status === 400) {
-                throw new AevumValidationError(errorData.error || 'Validation error', errorData.issues);
+                throw new AevumValidationError(errorMessage, errorIssues);
             }
-            throw new AevumAPIError(errorData.error || `API request failed with status ${response.status}`, response.status, errorData.code, errorData.issues);
+            throw new AevumAPIError(errorMessage, response.status, errorCode, errorIssues);
         }
         return data;
     }

package/dist/customers.d.ts

@@ -1,5 +1,5 @@
 import { AevumClient } from './client';
-import type { Customer, CreateCustomerParams, ListCustomersParams, ListCustomersResponse, CustomerHistoryResponse } from './types';
+import type { Customer, CreateCustomerParams, UpdateCustomerParams, ListCustomersParams, ListCustomersResponse, CustomerHistoryResponse } from './types';
 /**
  * Customers API methods
  */
@@ -18,6 +18,10 @@ export declare class CustomersAPI {
      * Create a new customer (or merge if email exists)
      */
     create(params: CreateCustomerParams): Promise<Customer>;
+    /**
+     * Update an existing customer
+     */
+    update(customerId: string, params: UpdateCustomerParams): Promise<Customer>;
     /**
      * Get customer booking history with analytics
      */

package/dist/customers.js

@@ -51,6 +51,23 @@ export class CustomersAPI {
         const response = await this.client.request('POST', '/api/v1/orgs/{orgId}/customers', { body });
         return response.customer;
     }
+    /**
+     * Update an existing customer
+     */
+    async update(customerId, params) {
+        const body = {};
+        if (params.name !== undefined) {
+            body.name = params.name;
+        }
+        if (params.email !== undefined) {
+            body.email = params.email;
+        }
+        if (params.phone !== undefined) {
+            body.phone = params.phone;
+        }
+        const response = await this.client.request('PATCH', `/api/v1/orgs/{orgId}/customers/${customerId}`, { body });
+        return response.customer;
+    }
     /**
      * Get customer booking history with analytics
      */

package/dist/index.d.ts

@@ -3,8 +3,10 @@ export { BookingsAPI } from './bookings';
 export { OfferingsAPI } from './offerings';
 export { CustomersAPI } from './customers';
 export { ProvidersAPI } from './providers';
+export { OrgsAPI } from './orgs';
 export { CalendarAPI } from './calendar';
 export { AnalyticsAPI } from './analytics';
 export { AvailabilityAPI } from './availability';
+export { PaymentsAPI } from './payments';
 export * from './types';
 export * from './errors';

package/dist/index.js

@@ -4,8 +4,10 @@ export { BookingsAPI } from './bookings';
 export { OfferingsAPI } from './offerings';
 export { CustomersAPI } from './customers';
 export { ProvidersAPI } from './providers';
+export { OrgsAPI } from './orgs';
 export { CalendarAPI } from './calendar';
 export { AnalyticsAPI } from './analytics';
 export { AvailabilityAPI } from './availability';
+export { PaymentsAPI } from './payments';
 export * from './types';
 export * from './errors';

package/dist/offerings.d.ts

@@ -1,5 +1,5 @@
 import { AevumClient } from './client';
-import type { Offering, CreateOfferingParams, ListOfferingsParams, CreateSimpleOfferingParams, CreateRecurringWeeklyOfferingParams, CreateRecurringDailyOfferingParams, CreateSimpleOfferingEndpointParams } from './types';
+import type { Offering, CreateOfferingParams, UpdateOfferingParams, ListOfferingsParams, CreateSimpleOfferingParams, CreateRecurringWeeklyOfferingParams, CreateRecurringDailyOfferingParams, CreateSimpleOfferingEndpointParams } from './types';
 /**
  * Offerings API methods
  */
@@ -14,6 +14,14 @@ export declare class OfferingsAPI {
      * Get a single offering by ID
      */
     get(offeringId: string): Promise<Offering>;
+    /**
+     * Update an existing offering
+     */
+    update(offeringId: string, params: UpdateOfferingParams): Promise<Offering>;
+    /**
+     * Delete an offering
+     */
+    delete(offeringId: string): Promise<void>;
     /**
      * Create a new offering
      */

package/dist/offerings.js

@@ -73,6 +73,88 @@ export class OfferingsAPI {
         const response = await this.client.request('GET', `/api/v1/orgs/{orgId}/offerings/${offeringId}`);
         return response.offering;
     }
+    /**
+     * Update an existing offering
+     */
+    async update(offeringId, params) {
+        const body = {};
+        if (params.name !== undefined)
+            body.name = params.name;
+        if (params.description !== undefined)
+            body.description = params.description;
+        if (params.price_cents !== undefined)
+            body.price_cents = params.price_cents;
+        if (params.duration_minutes !== undefined)
+            body.duration_minutes = params.duration_minutes;
+        if (params.timezone !== undefined)
+            body.timezone = params.timezone;
+        if (params.is_all_day !== undefined)
+            body.is_all_day = params.is_all_day;
+        if (params.attendee_mode !== undefined)
+            body.attendee_mode = params.attendee_mode;
+        if (params.attendee_limit !== undefined)
+            body.attendee_limit = params.attendee_limit;
+        if (params.customer !== undefined)
+            body.customer = params.customer;
+        if (params.status !== undefined)
+            body.status = params.status;
+        if (params.type !== undefined)
+            body.type = params.type;
+        if (params.time_mode !== undefined)
+            body.time_mode = params.time_mode;
+        if (params.start_time !== undefined)
+            body.start_time = params.start_time;
+        if (params.end_time !== undefined)
+            body.end_time = params.end_time;
+        if (params.session_count !== undefined)
+            body.session_count = params.session_count;
+        if (params.recurrence_preset !== undefined)
+            body.recurrence_preset = params.recurrence_preset;
+        if (params.recurrence_interval_count !== undefined)
+            body.recurrence_interval_count = params.recurrence_interval_count;
+        if (params.recurrence_interval_unit !== undefined)
+            body.recurrence_interval_unit = params.recurrence_interval_unit;
+        if (params.recurrence_repeat_on !== undefined)
+            body.recurrence_repeat_on = params.recurrence_repeat_on;
+        if (params.recurrence_end_mode !== undefined)
+            body.recurrence_end_mode = params.recurrence_end_mode;
+        if (params.recurrence_end_date !== undefined)
+            body.recurrence_end_date = params.recurrence_end_date;
+        if (params.recurrence_end_count !== undefined)
+            body.recurrence_end_count = params.recurrence_end_count;
+        if (params.override_price_cents !== undefined)
+            body.override_price_cents = params.override_price_cents;
+        if (params.min_age !== undefined)
+            body.min_age = params.min_age;
+        if (params.max_age !== undefined)
+            body.max_age = params.max_age;
+        if (params.window_start_time !== undefined)
+            body.window_start_time = params.window_start_time;
+        if (params.window_end_time !== undefined)
+            body.window_end_time = params.window_end_time;
+        if (params.cadence_minutes !== undefined)
+            body.cadence_minutes = params.cadence_minutes;
+        if (params.slot_days !== undefined)
+            body.slot_days = params.slot_days;
+        if (params.auto_confirm !== undefined)
+            body.auto_confirm = params.auto_confirm;
+        if (params.providerIds !== undefined)
+            body.providerIds = params.providerIds;
+        if (params.hours !== undefined)
+            body.hours = params.hours;
+        if (params.weekly_hours !== undefined)
+            body.weekly_hours = params.weekly_hours;
+        if (params.monthly_recurrence !== undefined)
+            body.monthly_recurrence = params.monthly_recurrence;
+        const response = await this.client.request('PATCH', `/api/v1/orgs/{orgId}/offerings/${offeringId}`, { body });
+        return response.offering;
+    }
+    /**
+     * Delete an offering
+     */
+    async delete(offeringId) {
+        await this.client.request('DELETE', `/api/v1/orgs/{orgId}/offerings/${offeringId}`);
+    }
     /**
      * Create a new offering
      */

package/dist/orgs.d.ts

@@ -0,0 +1,24 @@
+import { AevumClient } from './client';
+import type { Org, BookingSettings, UpdateBookingSettingsParams } from './types';
+/**
+ * Organization API – org details for embedding, booking config, etc.
+ */
+export declare class OrgsAPI {
+    private client;
+    constructor(client: AevumClient);
+    /**
+     * Get organization by ID (requires API key auth).
+     * Returns org details including slug for public booking URLs.
+     */
+    get(): Promise<Org>;
+    /**
+     * Get booking settings for the organization
+     * Returns booking configuration including safe period hours
+     */
+    getBookingSettings(): Promise<BookingSettings>;
+    /**
+     * Update booking settings for the organization
+     * Allows updating the safe period hours (minimum time before bookings can be made)
+     */
+    updateBookingSettings(params: UpdateBookingSettingsParams): Promise<BookingSettings>;
+}

package/dist/orgs.js

@@ -0,0 +1,30 @@
+/**
+ * Organization API – org details for embedding, booking config, etc.
+ */
+export class OrgsAPI {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get organization by ID (requires API key auth).
+     * Returns org details including slug for public booking URLs.
+     */
+    async get() {
+        const response = await this.client.request('GET', '/api/v1/orgs/{orgId}');
+        return response;
+    }
+    /**
+     * Get booking settings for the organization
+     * Returns booking configuration including safe period hours
+     */
+    async getBookingSettings() {
+        return this.client.request('GET', '/api/v1/orgs/{orgId}/settings/booking');
+    }
+    /**
+     * Update booking settings for the organization
+     * Allows updating the safe period hours (minimum time before bookings can be made)
+     */
+    async updateBookingSettings(params) {
+        return this.client.request('PATCH', '/api/v1/orgs/{orgId}/settings/booking', { body: params });
+    }
+}

package/dist/payments.d.ts

@@ -0,0 +1,33 @@
+import type { AevumClient } from './client';
+export interface PaymentIntentDetails {
+    paymentIntentId: string;
+    clientSecret: string | null;
+    amount: number;
+    status: string;
+}
+export interface UpdatePaymentIntentParams {
+    paymentIntentId: string;
+    tipAmountCents: number;
+    bookingId?: string;
+}
+export interface UpdatePaymentIntentResult {
+    success: boolean;
+    paymentIntentId: string;
+    amount: number;
+    clientSecret: string | null;
+}
+/**
+ * Payments API for managing payment intents
+ */
+export declare class PaymentsAPI {
+    private readonly client;
+    constructor(client: AevumClient);
+    /**
+     * Get payment intent details including client secret
+     */
+    getIntent(paymentIntentId: string): Promise<PaymentIntentDetails>;
+    /**
+     * Update payment intent with tip amount
+     */
+    updateIntent(params: UpdatePaymentIntentParams): Promise<UpdatePaymentIntentResult>;
+}

package/dist/payments.js

@@ -0,0 +1,26 @@
+/**
+ * Payments API for managing payment intents
+ */
+export class PaymentsAPI {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get payment intent details including client secret
+     */
+    async getIntent(paymentIntentId) {
+        return this.client.request('GET', '/api/payments/intent', {
+            query: {
+                payment_intent_id: paymentIntentId,
+            },
+        });
+    }
+    /**
+     * Update payment intent with tip amount
+     */
+    async updateIntent(params) {
+        return this.client.request('POST', '/api/payments/update-intent', {
+            body: params,
+        });
+    }
+}

package/dist/types.d.ts

@@ -9,6 +9,30 @@ export interface AevumClientConfig {
     /** Organization ID (optional, will be resolved from API key if not provided) */
     orgId?: string;
 }
+/**
+ * Organization (from GET /api/v1/orgs/:orgId)
+ */
+export interface Org {
+    id: string;
+    name: string | null;
+    slug: string | null;
+    timezone: string | null;
+    clerk_org_id: string | null;
+}
+/**
+ * Booking settings for an organization
+ */
+export interface BookingSettings {
+    /** Safe period in hours - no bookings allowed within this period (default: 24) */
+    safePeriodHours: number;
+}
+/**
+ * Parameters for updating booking settings
+ */
+export interface UpdateBookingSettingsParams {
+    /** Safe period in hours (0-168, default: 24) */
+    safePeriodHours?: number;
+}
 /**
  * Customer information
  */
@@ -211,6 +235,7 @@ export interface Offering {
     window_end_time?: string | null;
     cadence_minutes?: number | null;
     slot_days?: string | null;
+    auto_confirm?: boolean;
     hours?: any;
     weekly_hours?: any;
     monthly_recurrence?: any;
@@ -252,11 +277,18 @@ export interface CreateOfferingParams {
     window_end_time?: string;
     cadence_minutes?: number | null;
     slot_days?: string;
+    auto_confirm?: boolean;
     providerIds?: string[];
     hours?: any;
     weekly_hours?: any;
     monthly_recurrence?: any;
 }
+/**
+ * Parameters for updating an offering (all fields optional)
+ */
+export type UpdateOfferingParams = Partial<Omit<CreateOfferingParams, 'name'>> & {
+    name?: string;
+};
 /**
  * Parameters for listing offerings
  */
@@ -380,6 +412,14 @@ export interface CreateCustomerParams {
     phone?: string | null;
     userId?: string | null;
 }
+/**
+ * Parameters for updating a customer
+ */
+export interface UpdateCustomerParams {
+    name?: string | null;
+    email?: string | null;
+    phone?: string | null;
+}
 /**
  * Parameters for listing customers
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withaevum/sdk",
-  "version": "1.2.0",
+  "version": "1.3.2",
   "description": "TypeScript SDK for the Aevum API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",