@slotchain/sdk 1.1.4 → 1.2.0

package/dist/index.esm.js

@@ -806,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(
@@ -860,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(
@@ -874,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(
@@ -887,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
@@ -1317,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) {
@@ -1649,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;