@withaevum/sdk 1.3.0 → 1.3.3

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,22 @@ export class AevumClient {
             throw new Error('API key is required');
         }
         this.apiKey = config.apiKey;
-        this.baseUrl = config.baseUrl || 'https://api.withaevum.com';
+        // Default baseUrl: use provided, or check env var (Node.js only), or use production
+        if (config.baseUrl) {
+            this.baseUrl = config.baseUrl;
+        }
+        else if (typeof process !== 'undefined' && process.env?.AEVUM_API_BASE_URL) {
+            // Check environment variable if in Node.js
+            this.baseUrl = process.env.AEVUM_API_BASE_URL;
+        }
+        else if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'development') {
+            // Default to localhost in development
+            this.baseUrl = 'http://localhost:3000';
+        }
+        else {
+            // Production default
+            this.baseUrl = 'https://withaevum.com';
+        }
         // Set orgId if provided in config (avoids extra API call)
         if (config.orgId) {
             this.orgId = config.orgId;
@@ -29,8 +46,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 +141,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.js

@@ -136,6 +136,8 @@ export class OfferingsAPI {
             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)

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,6 +277,7 @@ export interface CreateOfferingParams {
     window_end_time?: string;
     cadence_minutes?: number | null;
     slot_days?: string;
+    auto_confirm?: boolean;
     providerIds?: string[];
     hours?: any;
     weekly_hours?: any;
@@ -386,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.3.0",
+  "version": "1.3.3",
   "description": "TypeScript SDK for the Aevum API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -46,6 +46,7 @@
     "access": "public"
   },
   "devDependencies": {
+    "@types/node": "^25.2.1",
     "typescript": "^5.6.3"
   }
 }