@slotchain/sdk 1.1.3 → 1.2.0

package/dist/index.esm.js

@@ -324,10 +324,79 @@ var ServiceClient = class {
     );
     return response.data;
   }
+  /**
+   * Get services for a tenant (full list with optional filters)
+   * GET /api/v1/services
+   * 
+   * @param options - Query options
+   * @param options.tenantId - Tenant ID (UUID) - required if tenantSlug not provided
+   * @param options.tenantSlug - Tenant slug - required if tenantId not provided
+   * @param options.slotId - Slot ID (DEPRECATED - accepted but ignored for API compatibility)
+   * @param options.isActive - Filter by active status
+   * @param options.includeItems - Include nested service items (default: false)
+   * @param options.page - Page number (default: 1)
+   * @param options.limit - Items per page (default: 20, max: 100)
+   * @returns Services with optional pagination metadata
+   */
+  async getServicesByTenant(options) {
+    if (!options.tenantId && !options.tenantSlug) {
+      return {
+        success: false,
+        error: {
+          code: "MISSING_TENANT_ID",
+          message: "tenantId or tenantSlug is required"
+        }
+      };
+    }
+    const params = {};
+    if (options.tenantId) {
+      params.tenant_id = options.tenantId;
+    }
+    if (options.tenantSlug) {
+      params.tenantSlug = options.tenantSlug;
+    }
+    if (options.slotId) {
+      params.slot_id = options.slotId;
+    }
+    if (options.isActive !== void 0) {
+      params.is_active = options.isActive;
+    }
+    if (options.includeItems) {
+      params.includeItems = true;
+    }
+    if (options.page !== void 0) {
+      params.page = options.page;
+    }
+    if (options.limit !== void 0) {
+      params.limit = Math.min(options.limit, 100);
+    }
+    const response = await this.client.get(
+      "/api/v1/services",
+      { params }
+    );
+    return response.data;
+  }
+  /**
+   * Get services for a specific slot
+   * GET /api/v1/slots/:id/services
+   * 
+   * Note: Services are tenant-level entities. This endpoint returns all active services
+   * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+   * 
+   * @param slotId - Slot ID (UUID)
+   * @returns Services with nested items (always includes items, only active services)
+   */
+  async getServicesBySlot(slotId) {
+    const response = await this.client.get(
+      `/api/v1/slots/${slotId}/services`
+    );
+    return response.data;
+  }
   /**
    * List services by tenant slug
    * GET /api/v1/services?tenantSlug=:slug
    * 
+   * @deprecated Consider using getServicesByTenant() for better type safety and validation
    * @param slug - Tenant slug (or use tenant_id in list() method)
    * @param params - Optional parameters (includeItems, page, limit, is_active)
    * @returns List of services for the tenant
@@ -343,6 +412,7 @@ var ServiceClient = class {
    * List services with optional filters
    * GET /api/v1/services
    * 
+   * @deprecated Consider using getServicesByTenant() for better type safety and validation
    * @param params - Query parameters (tenant_id, tenantSlug, slot_id, page, limit, is_active, includeItems)
    * @returns Paginated list of services
    */
@@ -659,8 +729,11 @@ var SlotClient = class {
    * Get all active services for a slot with their items
    * GET /api/v1/slots/:id/services
    * 
-   * @param id - Slot ID
-   * @returns Services with nested service items
+   * Note: Services are tenant-level entities. This endpoint returns all active services
+   * for the slot's tenant with items included. The response uses 'items' property (not 'serviceItems').
+   * 
+   * @param id - Slot ID (UUID)
+   * @returns Services with nested items (always includes items, only active services)
    */
   async getServices(id) {
     const response = await this.client.get(
@@ -733,9 +806,6 @@ var CustomerClient = class {
   /**
    * Create a new customer
    * POST /api/v1/customers
-   * 
-   * @param data - Customer creation data (tenant_id, name, email required)
-   * @returns Created customer
    */
   async create(data) {
     const response = await this.client.post(
@@ -787,11 +857,8 @@ var CustomerClient = class {
     return response.data;
   }
   /**
-   * Get autocomplete data from existing customers and bookings
-   * GET /api/v1/customers/autocomplete
-   * 
-   * @param tenantId - Tenant ID (required)
-   * @returns Autocomplete data
+   * Get autocomplete data from existing customers and bookings.
+   * GET /api/v1/customers/autocomplete?tenantId=:tenantId
    */
   async autocomplete(tenantId) {
     const response = await this.client.get(
@@ -801,11 +868,8 @@ var CustomerClient = class {
     return response.data;
   }
   /**
-   * Get all bookings for a customer
-   * GET /api/v1/customers/bookings
-   * 
-   * @param params - Query parameters (email optional, userId optional, tenantId required)
-   * @returns Customer bookings data
+   * Get all bookings for a customer, grouped by slot.
+   * GET /api/v1/customers/bookings?tenantId=:id
    */
   async getBookings(params) {
     const response = await this.client.get(
@@ -814,6 +878,85 @@ var CustomerClient = class {
     );
     return response.data;
   }
+  // ─── Atomic upsert ────────────────────────────────────────────────────────
+  /**
+   * Atomic upsert: find an existing customer by email within a tenant, or create one.
+   * POST /api/v1/customers/find-or-create
+   */
+  async findOrCreate(options) {
+    const response = await this.client.post(
+      "/api/v1/customers/find-or-create",
+      options
+    );
+    return response.data;
+  }
+  /**
+   * Resolve a customer from an IDP identity or email.
+   * Tries idpId lookup (customer_users) first, then falls back to email.
+   * POST /api/v1/customers/resolve
+   */
+  async resolve(options) {
+    const response = await this.client.post(
+      "/api/v1/customers/resolve",
+      options
+    );
+    return response.data;
+  }
+  // ─── IDP Identity Management ─────────────────────────────────────────────
+  /**
+   * Get a customer with their linked IDP identities (customer_users rows).
+   * GET /api/v1/customers/:id?include_identities=true
+   */
+  async getWithIdentities(id) {
+    const response = await this.client.get(
+      `/api/v1/customers/${id}`,
+      { params: { include_identities: true } }
+    );
+    return response.data;
+  }
+  /**
+   * Link an IDP user ID to a customer (creates a customer_users row).
+   * POST /api/v1/customers/:id/users
+   */
+  async linkUser(customerId, idpId, options) {
+    const response = await this.client.post(
+      `/api/v1/customers/${customerId}/users`,
+      { idp_id: idpId, role: options?.role ?? "member", is_primary: options?.is_primary ?? false }
+    );
+    return response.data;
+  }
+  /**
+   * Unlink an IDP user from a customer (deletes the customer_users row).
+   * DELETE /api/v1/customers/:id/users/:idpId
+   */
+  async unlinkUser(customerId, idpId) {
+    const response = await this.client.delete(
+      `/api/v1/customers/${customerId}/users/${encodeURIComponent(idpId)}`
+    );
+    return response.data;
+  }
+  // ─── Notification Preferences ────────────────────────────────────────────
+  /**
+   * Get notification preferences for a customer.
+   * GET /api/v1/customers/:id/preferences/notifications
+   */
+  async getNotificationPreferences(customerId) {
+    const response = await this.client.get(
+      `/api/v1/customers/${customerId}/preferences/notifications`
+    );
+    return response.data;
+  }
+  /**
+   * Update notification preferences for a customer (partial merge).
+   * PATCH /api/v1/customers/:id/preferences/notifications
+   */
+  async updateNotificationPreferences(customerId, preferences) {
+    const response = await this.client.patch(
+      `/api/v1/customers/${customerId}/preferences/notifications`,
+      preferences
+    );
+    return response.data;
+  }
 };
 
 // src/clients/flow-client.ts
@@ -1244,6 +1387,103 @@ var OrganizationClient = class {
   }
 };
 
+// src/clients/document-client.ts
+var DocumentClient = class {
+  constructor(client) {
+    this.base = "/api/v1/artifacts";
+    this.client = client;
+  }
+  /**
+   * Upload a file artifact.
+   * Sends as multipart/form-data.
+   */
+  async upload(options) {
+    const form = new FormData();
+    let blob;
+    if (options.file instanceof Blob) {
+      blob = options.file;
+    } else {
+      blob = new Blob([options.file], { type: options.mime_type ?? "application/octet-stream" });
+    }
+    form.append("file", blob, options.filename);
+    form.append("related_entity_type", options.related_entity_type);
+    form.append("related_entity_id", options.related_entity_id);
+    if (options.label) form.append("label", options.label);
+    if (options.mime_type) form.append("mime_type", options.mime_type);
+    if (options.metadata) form.append("metadata", JSON.stringify(options.metadata));
+    const response = await this.client.post(this.base, form, {
+      headers: { "Content-Type": "multipart/form-data" }
+    });
+    const { data } = response.data;
+    if (!data) throw new Error("No artifact returned from upload");
+    return data;
+  }
+  /**
+   * List artifacts for a specific entity.
+   * Pass `signed: true` to get download URLs in each result.
+   */
+  async listByEntity(entityType, entityId, options) {
+    const response = await this.client.get(
+      this.base,
+      {
+        params: {
+          related_entity_type: entityType,
+          related_entity_id: entityId,
+          ...options
+        }
+      }
+    );
+    return response.data;
+  }
+  /**
+   * List artifacts with full filter options.
+   */
+  async list(options) {
+    const response = await this.client.get(
+      this.base,
+      { params: options }
+    );
+    return response.data;
+  }
+  /**
+   * Get a single artifact by ID.
+   */
+  async get(id, signed = false) {
+    const response = await this.client.get(
+      `${this.base}/${id}`,
+      { params: signed ? { signed: true } : void 0 }
+    );
+    const { data } = response.data;
+    if (!data) throw new Error(`Artifact ${id} not found`);
+    return data;
+  }
+  /**
+   * Get a signed download URL for an artifact.
+   * Returns the full ArtifactWithUrl including `signed_url` and `signed_url_expires_at`.
+   */
+  async getUrl(id) {
+    return this.get(id, true);
+  }
+  /**
+   * Delete an artifact and its stored file.
+   */
+  async delete(id) {
+    await this.client.delete(`${this.base}/${id}`);
+  }
+  /**
+   * Update artifact label or metadata.
+   */
+  async update(id, patch) {
+    const response = await this.client.patch(
+      `${this.base}/${id}`,
+      patch
+    );
+    const { data } = response.data;
+    if (!data) throw new Error(`Artifact ${id} not found`);
+    return data;
+  }
+};
+
 // src/errors.ts
 var SlotlyApiError = class _SlotlyApiError extends Error {
   constructor(code, message, statusCode, details) {
@@ -1576,7 +1816,8 @@ var useSlotly = (options) => {
     studio: new StudioClient(client),
     notification: new NotificationClient(client),
     dataQuality: new DataQualityClient(client),
-    organization: new OrganizationClient(client)
+    organization: new OrganizationClient(client),
+    document: new DocumentClient(client)
   };
 };
 var index_default = useSlotly;