@lessly/sdk-app 30.4.0 → 30.6.0

package/src/gen/types.gen.ts

@@ -15139,13 +15139,21 @@ export interface SupportMessageListInput {
  */
 limit?: number
 /**
- * Number of messages to skip
+ * ISO-8601 timestamp. Only messages created strictly after it — pass the createdAt of the last message you already have
+ */
+since?: string
+/**
+ * Opaque position from a previous nextCursor. Resumes exactly where that page ended, with no gap and no repeat even when messages share a timestamp. Never construct one, and do not combine it with offset
+ */
+cursor?: string
+/**
+ * Number of messages to skip. The older pagination, kept for callers that already use it; prefer cursor, which cannot drift as messages arrive
  */
 offset?: number
 /**
- * Thread whose messages to list. Messages exist only inside a thread
+ * Thread whose messages to list. Omit to list the messages of every thread of this product — the catch-up read
  */
-threadId: string
+threadId?: string
 /**
  * Only messages in this direction
  */
@@ -15231,6 +15239,10 @@ authorAgentId: (string | null)
  */
 authorExternalId: (string | null)
 }[]
+/**
+ * Position to resume from: pass it back as cursor for the next page. Null when this page is the last one
+ */
+nextCursor: (string | null)
 }
 
 export interface SupportStatusArchiveInput {
@@ -16171,6 +16183,434 @@ assignedAgentId: (string | null)
 authorExternalId: string
 }
 
+export interface SupportWebhookCreateInput {
+/**
+ * HTTPS endpoint the event is POSTed to. Plain http:// is rejected
+ */
+url: string
+/**
+ * Event types this endpoint subscribes to. One or more of support.message.created, support.thread.status-changed, support.thread.assigned
+ * 
+ * @minItems 1
+ */
+eventTypes: [("support.message.created" | "support.thread.status-changed" | "support.thread.assigned"), ...(("support.message.created" | "support.thread.status-changed" | "support.thread.assigned"))[]]
+/**
+ * Free-form note about what this endpoint is for, up to 1000 characters
+ */
+description?: string
+}
+
+export interface SupportWebhookCreateOutput {
+/**
+ * Webhook id
+ */
+id: string
+/**
+ * HTTPS endpoint events are POSTed to
+ */
+url: string
+/**
+ * The signing secret in clear. Shown exactly once, here — store it now; it cannot be read back and can only be replaced by rotating it
+ */
+secret: string
+/**
+ * active or disabled
+ */
+status: ("active" | "disabled")
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-update timestamp
+ */
+updatedAt: string
+/**
+ * Event types this endpoint subscribes to
+ */
+eventTypes: string[]
+/**
+ * Free-form note, or null
+ */
+description: (string | null)
+/**
+ * First characters of the signing secret, to tell endpoints apart. Never the whole secret
+ */
+secretPrefix: string
+}
+
+export interface SupportWebhookDeleteInput {
+/**
+ * Webhook id
+ */
+id: string
+}
+
+export interface SupportWebhookDeleteOutput {
+/**
+ * Id of the endpoint that was removed
+ */
+id: string
+/**
+ * Always true — the endpoint is gone
+ */
+deleted: true
+}
+
+export interface SupportWebhookDeliveriesListInput {
+/**
+ * Page size, 1..200 (default 50)
+ */
+limit?: number
+/**
+ * Only deliveries in this state: pending, delivered or failed
+ */
+state?: ("pending" | "delivered" | "failed")
+/**
+ * Number of deliveries to skip
+ */
+offset?: number
+/**
+ * Only deliveries opened at or before this ISO-8601 time
+ */
+createdTo?: string
+/**
+ * Only deliveries of this event type
+ */
+eventType?: ("support.message.created" | "support.thread.status-changed" | "support.thread.assigned")
+/**
+ * Only deliveries for this endpoint
+ */
+webhookId?: string
+/**
+ * Only deliveries opened at or after this ISO-8601 time
+ */
+createdFrom?: string
+}
+
+export interface SupportWebhookDeliveriesListOutput {
+/**
+ * Page size that was applied
+ */
+limit: number
+/**
+ * Offset that was applied
+ */
+offset: number
+/**
+ * The requested page, newest first
+ */
+deliveries: {
+/**
+ * Delivery id — the value in the X-Support-Delivery-Id header
+ */
+id: string
+/**
+ * Why the last attempt failed, or null. Never carries the signing key
+ */
+error: (string | null)
+/**
+ * pending while attempts remain, delivered once the endpoint answered 2xx, failed when every attempt was used up
+ */
+state: ("pending" | "delivered" | "failed")
+/**
+ * How many attempts have been made, 0 before the first
+ */
+attempt: number
+/**
+ * The JSON body that was sent. Identifiers and metadata only — never message text
+ */
+payload: {
+[k: string]: unknown
+}
+/**
+ * ISO-8601 time the delivery was opened
+ */
+createdAt: string
+/**
+ * Event type that was delivered
+ */
+eventType: string
+/**
+ * The endpoint this delivery was for
+ */
+webhookId: string
+/**
+ * ISO-8601 time of the successful attempt, or null
+ */
+deliveredAt: (string | null)
+/**
+ * ISO-8601 time the next attempt is due, or null when there is none
+ */
+nextRetryAt: (string | null)
+/**
+ * The key the receiver deduplicates on. A redelivery of this event carries the same value
+ */
+idempotencyKey: string
+/**
+ * HTTP status of the last attempt, or null if the request never got an answer
+ */
+responseStatus: (number | null)
+}[]
+}
+
+export interface SupportWebhookGetInput {
+/**
+ * Webhook id
+ */
+id: string
+}
+
+export interface SupportWebhookGetOutput {
+/**
+ * Webhook id
+ */
+id: string
+/**
+ * HTTPS endpoint events are POSTed to
+ */
+url: string
+/**
+ * active or disabled
+ */
+status: ("active" | "disabled")
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-update timestamp
+ */
+updatedAt: string
+/**
+ * Event types this endpoint subscribes to
+ */
+eventTypes: string[]
+/**
+ * Free-form note, or null
+ */
+description: (string | null)
+/**
+ * First characters of the signing secret, to tell endpoints apart. Never the whole secret
+ */
+secretPrefix: string
+}
+
+export interface SupportWebhookListInput {
+
+}
+
+export interface SupportWebhookListOutput {
+/**
+ * The endpoints this product has registered, oldest first
+ */
+webhooks: {
+/**
+ * Webhook id
+ */
+id: string
+/**
+ * HTTPS endpoint events are POSTed to
+ */
+url: string
+/**
+ * active or disabled
+ */
+status: ("active" | "disabled")
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-update timestamp
+ */
+updatedAt: string
+/**
+ * Event types this endpoint subscribes to
+ */
+eventTypes: string[]
+/**
+ * Free-form note, or null
+ */
+description: (string | null)
+/**
+ * First characters of the signing secret, to tell endpoints apart. Never the whole secret
+ */
+secretPrefix: string
+}[]
+}
+
+export interface SupportWebhookRedeliverInput {
+/**
+ * Id of the delivery to send again
+ */
+id: string
+}
+
+export interface SupportWebhookRedeliverOutput {
+/**
+ * The new delivery, opened in pending state. It carries the original idempotencyKey, so a receiver that already processed the first one can ignore it
+ */
+delivery: {
+/**
+ * Delivery id — the value in the X-Support-Delivery-Id header
+ */
+id: string
+/**
+ * Why the last attempt failed, or null. Never carries the signing key
+ */
+error: (string | null)
+/**
+ * pending while attempts remain, delivered once the endpoint answered 2xx, failed when every attempt was used up
+ */
+state: ("pending" | "delivered" | "failed")
+/**
+ * How many attempts have been made, 0 before the first
+ */
+attempt: number
+/**
+ * The JSON body that was sent. Identifiers and metadata only — never message text
+ */
+payload: {
+[k: string]: unknown
+}
+/**
+ * ISO-8601 time the delivery was opened
+ */
+createdAt: string
+/**
+ * Event type that was delivered
+ */
+eventType: string
+/**
+ * The endpoint this delivery was for
+ */
+webhookId: string
+/**
+ * ISO-8601 time of the successful attempt, or null
+ */
+deliveredAt: (string | null)
+/**
+ * ISO-8601 time the next attempt is due, or null when there is none
+ */
+nextRetryAt: (string | null)
+/**
+ * The key the receiver deduplicates on. A redelivery of this event carries the same value
+ */
+idempotencyKey: string
+/**
+ * HTTP status of the last attempt, or null if the request never got an answer
+ */
+responseStatus: (number | null)
+}
+}
+
+export interface SupportWebhookRotateSecretInput {
+/**
+ * Webhook id
+ */
+id: string
+}
+
+export interface SupportWebhookRotateSecretOutput {
+/**
+ * Webhook id
+ */
+id: string
+/**
+ * HTTPS endpoint events are POSTed to
+ */
+url: string
+/**
+ * The signing secret in clear. Shown exactly once, here — store it now; it cannot be read back and can only be replaced by rotating it
+ */
+secret: string
+/**
+ * active or disabled
+ */
+status: ("active" | "disabled")
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-update timestamp
+ */
+updatedAt: string
+/**
+ * Event types this endpoint subscribes to
+ */
+eventTypes: string[]
+/**
+ * Free-form note, or null
+ */
+description: (string | null)
+/**
+ * First characters of the signing secret, to tell endpoints apart. Never the whole secret
+ */
+secretPrefix: string
+}
+
+export interface SupportWebhookUpdateInput {
+/**
+ * Webhook id
+ */
+id: string
+/**
+ * HTTPS endpoint the event is POSTed to. Plain http:// is rejected
+ */
+url?: string
+/**
+ * active delivers events; disabled keeps the registration and stops delivery
+ */
+status?: ("active" | "disabled")
+/**
+ * Event types this endpoint subscribes to. One or more of support.message.created, support.thread.status-changed, support.thread.assigned
+ * 
+ * @minItems 1
+ */
+eventTypes?: [("support.message.created" | "support.thread.status-changed" | "support.thread.assigned"), ...(("support.message.created" | "support.thread.status-changed" | "support.thread.assigned"))[]]
+/**
+ * Free-form note about what this endpoint is for, up to 1000 characters
+ */
+description?: (string | null)
+}
+
+export interface SupportWebhookUpdateOutput {
+/**
+ * Webhook id
+ */
+id: string
+/**
+ * HTTPS endpoint events are POSTed to
+ */
+url: string
+/**
+ * active or disabled
+ */
+status: ("active" | "disabled")
+/**
+ * ISO-8601 creation timestamp
+ */
+createdAt: string
+/**
+ * ISO-8601 last-update timestamp
+ */
+updatedAt: string
+/**
+ * Event types this endpoint subscribes to
+ */
+eventTypes: string[]
+/**
+ * Free-form note, or null
+ */
+description: (string | null)
+/**
+ * First characters of the signing secret, to tell endpoints apart. Never the whole secret
+ */
+secretPrefix: string
+}
+
 export interface TrackingDomainsCreateInput {
 host?: string
 records?: {