@slotchain/sdk 1.4.0 → 1.6.0

package/dist/index.d.mts

@@ -66,6 +66,10 @@ interface ServiceItem {
     sort_order?: number;
     created_at: string;
     updated_at: string;
+    /** Set when the item has been soft-deleted. Filtered out by the SDK. */
+    deleted_at?: string | null;
+    /** Set when the item was withdrawn by the publisher (syndication). Filtered out by the SDK. */
+    withdrawn_at?: string | null;
 }
 /**
  * Enhanced Service type with nested service items (for tenant endpoint)
@@ -159,6 +163,8 @@ interface Service {
     price?: number;
     created_at: string;
     updated_at: string;
+    /** Set when the service has been soft-deleted. Filtered out by the SDK. */
+    deleted_at?: string | null;
 }
 /**
  * Metadata bag for a slot — open-ended key/value store, with well-known
@@ -388,7 +394,7 @@ interface GetOrganizationOptions {
 /**
  * Artifact / document attached to a customer or booking
  */
-type ArtifactEntityType = 'customer' | 'booking' | 'slot' | 'service' | 'tenant';
+type ArtifactEntityType = 'customer' | 'booking' | 'slot' | 'service' | 'tenant' | 'slot_moment';
 type ArtifactMimeCategory = 'pdf' | 'document' | 'image' | 'spreadsheet' | 'video' | 'audio' | 'other';
 interface Artifact {
     id: string;
@@ -446,6 +452,59 @@ interface UploadArtifactOptions {
     mime_type?: string;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Slot-scoped operational notice (early closure, venue change, general alert).
+ * Backed by a `slot_moment` — see NOTICES_PLAN.md in slotly-admin.
+ */
+type NoticeMomentType = 'general_notice' | 'early_closure' | 'closure_notice' | 'venue_change';
+/**
+ * Optional call-to-action button attached to a notice.
+ * `url` is either an absolute http(s) URL or a site-relative path ('/contact-us').
+ * Only returned when both halves are present — a partial CTA is dropped server-side.
+ */
+interface NoticeCta {
+    label: string;
+    url: string;
+    /** Open the link in a new tab. Defaults to true for notices created without the flag. */
+    newTab: boolean;
+}
+interface SlotNotice {
+    id: string;
+    slotId: string;
+    tenantId: string;
+    momentType: NoticeMomentType;
+    createdAt: string;
+    createdBy: string | null;
+    notice: {
+        type: string;
+        title: string;
+        message: string;
+        /** YYYY-MM-DD — the day the notice applies to */
+        affectedDate: string;
+        /** HH:MM — only present for early_closure notices */
+        closesAt?: string;
+        severity: 'info' | 'warning' | 'urgent';
+        visibleFrom: string;
+        visibleUntil: string;
+        dismissible: boolean;
+        /** Signed URL for the notice's attached graphic, if one was uploaded */
+        imageUrl?: string | null;
+        /** Staff-picked display treatment — 'banner' (compact, stacks) or 'modal' (full-screen, one at a time) */
+        presentation: 'banner' | 'modal';
+        /** Call-to-action button, or null when the notice has none */
+        cta?: NoticeCta | null;
+    };
+    affectedBookingIds: string[];
+}
+interface ListNoticesOptions {
+    tenantId: string;
+    /** Filter to notices active at this ISO timestamp. Defaults to now. */
+    activeAt?: string;
+    /** Filter to a specific slot */
+    slotId?: string;
+    /** Specific notice types to include. Defaults to all notice types. */
+    types?: NoticeMomentType[];
+}
 /**
  * Full tenant configuration including branding, services, and service items
  * Service items are nested within each service object (not as a separate top-level array)
@@ -1565,6 +1624,34 @@ declare class DocumentClient {
     }): Promise<Artifact>;
 }
 
+/**
+ * NoticesClient — read active slot-scoped operational notices.
+ *
+ * Notices are a product concept (early closure, venue change, general alert)
+ * backed by `slot_moments` internally — the SDK surface reflects the product,
+ * not the storage model. Each notice's attached graphic (if any) is already
+ * resolved to a signed `imageUrl` server-side.
+ *
+ * @example List active notices for a tenant
+ * ```ts
+ * const { data } = await slotly.notices.list({ tenantId });
+ * ```
+ */
+declare class NoticesClient {
+    private readonly client;
+    private readonly base;
+    constructor(client: AxiosInstance);
+    /**
+     * List active notices for a tenant.
+     * Returns only notices where visible_until > activeAt (default: now).
+     */
+    list(options: ListNoticesOptions): Promise<ApiResponse<SlotNotice[]>>;
+    /**
+     * Get a single notice by its slot_moment id.
+     */
+    getById(id: string, tenantId: string): Promise<SlotNotice>;
+}
+
 /**
  * Custom error classes for Slotly SDK
  */
@@ -1729,6 +1816,8 @@ interface SlotlyApi {
     organization: OrganizationClient;
     /** Upload and retrieve file artifacts (CVs, invoices, images) linked to any Slotly entity */
     document: DocumentClient;
+    /** List slot-scoped operational notices (early closure, venue change, general alerts) */
+    notices: NoticesClient;
 }
 /**
  * Initialize and configure a new Slotly API client with dual authentication.
@@ -1793,4 +1882,4 @@ interface SlotlyApi {
  */
 declare const useSlotly: (options: SlotlyClientOptions) => SlotlyApi;
 
-export { type ApiResponse, type Artifact, type ArtifactEntityType, type ArtifactMimeCategory, type ArtifactWithUrl, type Booking, type BookingWithSlot, type Category, type CreateSlotInput, type Customer, type CustomerIdentity, type CustomerWithBookings, type CustomerWithIdentities, type DataQualityIssue, type FindOrCreateCustomerOptions, type Flow, type FlowStep, type GetOrganizationOptions, type ListArtifactsOptions, type ListBookingsOptions, type Notification, type NotificationPreferences, type Organization, type OrganizationFullConfig, type ResolveCustomerOptions, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotMetadata, type SlotServiceWithItems, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, type UpdateSlotInput, type UploadArtifactOptions, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };
+export { type ApiResponse, type Artifact, type ArtifactEntityType, type ArtifactMimeCategory, type ArtifactWithUrl, type Booking, type BookingWithSlot, type Category, type CreateSlotInput, type Customer, type CustomerIdentity, type CustomerWithBookings, type CustomerWithIdentities, type DataQualityIssue, type FindOrCreateCustomerOptions, type Flow, type FlowStep, type GetOrganizationOptions, type ListArtifactsOptions, type ListBookingsOptions, type ListNoticesOptions, type NoticeCta, type NoticeMomentType, type Notification, type NotificationPreferences, type Organization, type OrganizationFullConfig, type ResolveCustomerOptions, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotMetadata, type SlotNotice, type SlotServiceWithItems, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, type UpdateSlotInput, type UploadArtifactOptions, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };

package/dist/index.d.ts

@@ -66,6 +66,10 @@ interface ServiceItem {
     sort_order?: number;
     created_at: string;
     updated_at: string;
+    /** Set when the item has been soft-deleted. Filtered out by the SDK. */
+    deleted_at?: string | null;
+    /** Set when the item was withdrawn by the publisher (syndication). Filtered out by the SDK. */
+    withdrawn_at?: string | null;
 }
 /**
  * Enhanced Service type with nested service items (for tenant endpoint)
@@ -159,6 +163,8 @@ interface Service {
     price?: number;
     created_at: string;
     updated_at: string;
+    /** Set when the service has been soft-deleted. Filtered out by the SDK. */
+    deleted_at?: string | null;
 }
 /**
  * Metadata bag for a slot — open-ended key/value store, with well-known
@@ -388,7 +394,7 @@ interface GetOrganizationOptions {
 /**
  * Artifact / document attached to a customer or booking
  */
-type ArtifactEntityType = 'customer' | 'booking' | 'slot' | 'service' | 'tenant';
+type ArtifactEntityType = 'customer' | 'booking' | 'slot' | 'service' | 'tenant' | 'slot_moment';
 type ArtifactMimeCategory = 'pdf' | 'document' | 'image' | 'spreadsheet' | 'video' | 'audio' | 'other';
 interface Artifact {
     id: string;
@@ -446,6 +452,59 @@ interface UploadArtifactOptions {
     mime_type?: string;
     metadata?: Record<string, unknown>;
 }
+/**
+ * Slot-scoped operational notice (early closure, venue change, general alert).
+ * Backed by a `slot_moment` — see NOTICES_PLAN.md in slotly-admin.
+ */
+type NoticeMomentType = 'general_notice' | 'early_closure' | 'closure_notice' | 'venue_change';
+/**
+ * Optional call-to-action button attached to a notice.
+ * `url` is either an absolute http(s) URL or a site-relative path ('/contact-us').
+ * Only returned when both halves are present — a partial CTA is dropped server-side.
+ */
+interface NoticeCta {
+    label: string;
+    url: string;
+    /** Open the link in a new tab. Defaults to true for notices created without the flag. */
+    newTab: boolean;
+}
+interface SlotNotice {
+    id: string;
+    slotId: string;
+    tenantId: string;
+    momentType: NoticeMomentType;
+    createdAt: string;
+    createdBy: string | null;
+    notice: {
+        type: string;
+        title: string;
+        message: string;
+        /** YYYY-MM-DD — the day the notice applies to */
+        affectedDate: string;
+        /** HH:MM — only present for early_closure notices */
+        closesAt?: string;
+        severity: 'info' | 'warning' | 'urgent';
+        visibleFrom: string;
+        visibleUntil: string;
+        dismissible: boolean;
+        /** Signed URL for the notice's attached graphic, if one was uploaded */
+        imageUrl?: string | null;
+        /** Staff-picked display treatment — 'banner' (compact, stacks) or 'modal' (full-screen, one at a time) */
+        presentation: 'banner' | 'modal';
+        /** Call-to-action button, or null when the notice has none */
+        cta?: NoticeCta | null;
+    };
+    affectedBookingIds: string[];
+}
+interface ListNoticesOptions {
+    tenantId: string;
+    /** Filter to notices active at this ISO timestamp. Defaults to now. */
+    activeAt?: string;
+    /** Filter to a specific slot */
+    slotId?: string;
+    /** Specific notice types to include. Defaults to all notice types. */
+    types?: NoticeMomentType[];
+}
 /**
  * Full tenant configuration including branding, services, and service items
  * Service items are nested within each service object (not as a separate top-level array)
@@ -1565,6 +1624,34 @@ declare class DocumentClient {
     }): Promise<Artifact>;
 }
 
+/**
+ * NoticesClient — read active slot-scoped operational notices.
+ *
+ * Notices are a product concept (early closure, venue change, general alert)
+ * backed by `slot_moments` internally — the SDK surface reflects the product,
+ * not the storage model. Each notice's attached graphic (if any) is already
+ * resolved to a signed `imageUrl` server-side.
+ *
+ * @example List active notices for a tenant
+ * ```ts
+ * const { data } = await slotly.notices.list({ tenantId });
+ * ```
+ */
+declare class NoticesClient {
+    private readonly client;
+    private readonly base;
+    constructor(client: AxiosInstance);
+    /**
+     * List active notices for a tenant.
+     * Returns only notices where visible_until > activeAt (default: now).
+     */
+    list(options: ListNoticesOptions): Promise<ApiResponse<SlotNotice[]>>;
+    /**
+     * Get a single notice by its slot_moment id.
+     */
+    getById(id: string, tenantId: string): Promise<SlotNotice>;
+}
+
 /**
  * Custom error classes for Slotly SDK
  */
@@ -1729,6 +1816,8 @@ interface SlotlyApi {
     organization: OrganizationClient;
     /** Upload and retrieve file artifacts (CVs, invoices, images) linked to any Slotly entity */
     document: DocumentClient;
+    /** List slot-scoped operational notices (early closure, venue change, general alerts) */
+    notices: NoticesClient;
 }
 /**
  * Initialize and configure a new Slotly API client with dual authentication.
@@ -1793,4 +1882,4 @@ interface SlotlyApi {
  */
 declare const useSlotly: (options: SlotlyClientOptions) => SlotlyApi;
 
-export { type ApiResponse, type Artifact, type ArtifactEntityType, type ArtifactMimeCategory, type ArtifactWithUrl, type Booking, type BookingWithSlot, type Category, type CreateSlotInput, type Customer, type CustomerIdentity, type CustomerWithBookings, type CustomerWithIdentities, type DataQualityIssue, type FindOrCreateCustomerOptions, type Flow, type FlowStep, type GetOrganizationOptions, type ListArtifactsOptions, type ListBookingsOptions, type Notification, type NotificationPreferences, type Organization, type OrganizationFullConfig, type ResolveCustomerOptions, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotMetadata, type SlotServiceWithItems, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, type UpdateSlotInput, type UploadArtifactOptions, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };
+export { type ApiResponse, type Artifact, type ArtifactEntityType, type ArtifactMimeCategory, type ArtifactWithUrl, type Booking, type BookingWithSlot, type Category, type CreateSlotInput, type Customer, type CustomerIdentity, type CustomerWithBookings, type CustomerWithIdentities, type DataQualityIssue, type FindOrCreateCustomerOptions, type Flow, type FlowStep, type GetOrganizationOptions, type ListArtifactsOptions, type ListBookingsOptions, type ListNoticesOptions, type NoticeCta, type NoticeMomentType, type Notification, type NotificationPreferences, type Organization, type OrganizationFullConfig, type ResolveCustomerOptions, type Service, type ServiceItem, type ServiceItemWithService, type ServiceWithItems, type Slot, type SlotMetadata, type SlotNotice, type SlotServiceWithItems, type SlotlyApi, SlotlyApiError, type SlotlyAuthContext, SlotlyAuthError, type SlotlyClientOptions, SlotlyConfigurationError, SlotlyNetworkError, type SlotlyRequest, type Studio, type Tenant, type TenantBranding, type TenantFullConfig, type UpdateSlotInput, type UploadArtifactOptions, useSlotly as default, getSlotlyContext, useSlotly, validateSlotlyRequest };

package/dist/index.esm.js

@@ -157,7 +157,16 @@ var TenantClient = class {
       `/api/v1/tenants/${slug}`,
       { params: { includeServices } }
     );
-    return response.data;
+    const data = response.data;
+    if (data?.data?.services) {
+      data.data.services = data.data.services.filter((s) => !s.deleted_at).map((s) => ({
+        ...s,
+        serviceItems: (s.serviceItems ?? []).filter(
+          (item) => !item.deleted_at && !item.withdrawn_at
+        )
+      }));
+    }
+    return data;
   }
 };
 
@@ -1553,6 +1562,40 @@ var DocumentClient = class {
   }
 };
 
+// src/clients/notices-client.ts
+var NoticesClient = class {
+  constructor(client) {
+    this.base = "/api/v1/notices";
+    this.client = client;
+  }
+  /**
+   * List active notices for a tenant.
+   * Returns only notices where visible_until > activeAt (default: now).
+   */
+  async list(options) {
+    const response = await this.client.get(this.base, {
+      params: {
+        tenant_id: options.tenantId,
+        active_at: options.activeAt,
+        slot_id: options.slotId,
+        types: options.types?.join(",")
+      }
+    });
+    return response.data;
+  }
+  /**
+   * Get a single notice by its slot_moment id.
+   */
+  async getById(id, tenantId) {
+    const response = await this.client.get(`${this.base}/${id}`, {
+      params: { tenant_id: tenantId }
+    });
+    const { data } = response.data;
+    if (!data) throw new Error(`Notice ${id} not found`);
+    return data;
+  }
+};
+
 // src/errors.ts
 var SlotlyApiError = class _SlotlyApiError extends Error {
   constructor(code, message, statusCode, details) {
@@ -1886,7 +1929,8 @@ var useSlotly = (options) => {
     notification: new NotificationClient(client),
     dataQuality: new DataQualityClient(client),
     organization: new OrganizationClient(client),
-    document: new DocumentClient(client)
+    document: new DocumentClient(client),
+    notices: new NoticesClient(client)
   };
 };
 var index_default = useSlotly;