skapi-js 2.2.5 → 2.2.6-beta.1

package/dist/skapi.d.mts

@@ -296,6 +296,13 @@ type Newsletter = {
      * A number for the 0 ~ 99 groups, the group name for a named newsletter group.
      */
     group: number | string;
+    /**
+     * true: mailed to the group's dry address, so it is stored and was sent to nobody. The
+     * Newsletters page's Send button, or a ticket's Send newsletter action, sends it later.
+     */
+    dry?: boolean;
+    /** When the Send button or a ticket's Send newsletter action sent it, in ms. Absent on a newsletter that went out by e-mail. */
+    sent?: number;
 };
 type NewsletterGroup = {
     /** Name of the newsletter group. */
@@ -864,43 +871,55 @@ type TicketResponseCondition = Pick<TicketCondition, 'headers' | 'data' | 'user'
  * | `${user}`, `${user[key]}` | The signed-in user's attributes. Signed requests only. |
  * | `${ip}`, `${user_agent}`, `${method}` | The caller's IP address, User-Agent and HTTP method. |
  * | `${record_access}` | The record ID the condition's `record_access` names. Signed requests only. |
- * | `${response}`, `${response[key]}` | The parsed body of the enclosing req action's response. Only in that req's nested `actions` and their `err` chains. |
- * | `${result}`, `${result[key]}` | The result of the previous action in the same chain. A nested chain and an `err` chain start without one. |
+ * | `${response}`, `${response[key]}` | The answer of the enclosing action, in its Then chain (`actions`) and the `err` chains inside it: the record a pstr posted, the parsed body of a req's response, the SUCCESS text of acsg and acsr. |
  * | `${error}`, `${error[key]}` | In an `err` chain, the failure: `code`, `message`, `detail`, `action` (the act) and `path`. |
- * | `${ticket}`, `${ticket[key]}` | This consumption: `id`, `service`, `owner`, `consume_id` and `timestamp`. |
+ * | `${ticket}`, `${ticket[key]}` | This consumption: `id`, `service`, `owner`, `consume_id`, `timestamp` and `hash`. |
  * | `${CLIENT_SECRET}` | Reserved. See `secretName` on the req action. |
  *
  * Registration refuses anything else inside `${ }` (an unknown root such as `${id}`, keys under
  * a root that takes none such as `${ip[x]}`, `${placeholder}` or `${headers}` without a key,
- * broken brackets) with a message listing these forms, and a reference written where it can
- * never resolve (`${response}` outside a req's nested actions, `${error}` outside an `err`
+ * broken brackets) with a message listing these forms, `${result}` (gone: an answer is read as
+ * `${response}` in the action's Then chain, or captured there by a Condition action), and a reference written
+ * where it can never resolve (`${response}` outside a Then chain, `${error}` outside an `err`
  * chain, `${record_access}` when the condition names no record). When the action runs, a
  * reference that does not resolve fails it before it does anything: PATH_NOT_FOUND,
  * PLACEHOLDER_MISSING for a placeholder that was never captured, or AUTH_REQUIRED for `${user}`
  * on a request that is not signed in. Its `err` chain runs and the consumption stops.
+ *
+ * Every action but resp and cond answers something (the record, the response body, a SUCCESS
+ * text) and may carry a Then chain (`actions`, reading the answer as `${response}`). A Condition
+ * action in that chain checks the answer: its `response` rows read it whole (key "") or by key,
+ * whatever its shape. `retry: true` on acsg, acsr, pstr, req, mail and nlsd tries a failure again,
+ * up to 3 more times, 1, 2 and 4 seconds apart, while the time budget holds them; never for a
+ * failure inside Then.
  */
 type TicketAction = {
-    /** Set the access group of a user. */
+    /** Set the access group of a user. Answers the SUCCESS text the grant returns. */
     act: 'acsg';
     exe: {
         /** 1 ~ 99, or "admin", or a reference that gives one when the action runs, such as "${placeholder[GROUP]}". */
         group: number | 'admin' | `${string}\${${string}}${string}`;
         /** Blank = the consumer (signed-in consumption only). The project owner cannot be a target. */
         user_id?: string;
+        /** The Then chain, reading the answer as `${response}`. */
+        actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
 } | {
-    /** Grant private access to a record. */
+    /** Grant private access to a record. Answers the SUCCESS text the grant returns. */
     act: 'acsr';
     exe: {
         /** A record ID, not a unique ID. */
         record_id: string;
         /** Blank = the consumer. */
         user_id?: string | string[];
+        actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
 } | {
-    /** Post a record. Everything but `user_id` is the payload postRecord() sends, so the same rules apply. A `unique_id` makes a retried webhook update the same record instead of adding one. */
+    /** Post a record. Everything but `user_id` is the payload postRecord() sends, so the same rules apply. A `unique_id` makes a retried webhook update the same record instead of adding one. Answers the record (RecordData). */
     act: 'pstr';
     exe: {
         table: string | {
@@ -922,10 +941,13 @@ type TicketAction = {
         source?: PostRecordConfig['source'];
         /** Post as this user instead of the project owner. */
         user_id?: string;
+        /** The Then chain, reading the record as `${response}` (`${response[record_id]}`). */
+        actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
 } | {
-    /** HTTP request with its own response condition and nested chain. Result: the parsed response body. */
+    /** HTTP request with its own response condition and nested chain. Answers the parsed response body. */
     act: 'req';
     exe: {
         /**
@@ -990,7 +1012,7 @@ type TicketAction = {
         };
         /** Legacy. Registration moves these rows to the end of `condition.data`. */
         match?: TicketConditionRow[];
-        /** Checked against the response. Captures land in the shared placeholder pool. See TicketResponseCondition. */
+        /** Skapi's own billing rows only. A response check is a Condition action in `actions`, whose `response` rows read the answer. */
         condition?: TicketResponseCondition;
         /**
          * Nested chain, run when the response passes `condition`. It reads the response body
@@ -1000,6 +1022,112 @@ type TicketAction = {
         actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
+} | {
+    /**
+     * Send e-mail: one e-mail from a CUSTOM template of the project (the Custom tab of the
+     * Automated Emails page) to one address, from the project's alias. Counts as one e-mail
+     * send (the plan's monthly sends, the Free owner cap and the complaint shutoff apply; a
+     * refusal is QUOTA_EXCEEDED). Answers "SUCCESS: E-mail sent to <address>."
+     */
+    act: 'mail';
+    exe: {
+        /** The template's ID, as the Custom tab and the upload reply show it. Literal; it must be stored when the ticket is registered. */
+        template: string;
+        /** The recipient: one address, or a reference that gives one, such as "${user[email]}" or "${data[email]}". */
+        to: string;
+        /**
+         * Values for the placeholders the template carries, by name: { "order": "${data[order][id]}" } fills
+         * ${order}. Templated. "service_name" and "email" (the recipient) are filled by default and may be
+         * overwritten here. Up to 30.
+         */
+        placeholders?: {
+            [name: string]: string | number | boolean;
+        };
+        actions?: TicketAction[];
+    };
+    err?: TicketAction[];
+    retry?: boolean;
+} | {
+    /**
+     * Send newsletter: a stored newsletter of a group, dry or already sent, to every subscriber of the
+     * group, the way an e-mailed newsletter goes out (one e-mail send per subscriber, same gates).
+     * Answers "SUCCESS: Newsletter sent to the subscribers of <group>."
+     */
+    act: 'nlsd';
+    exe: {
+        /** "public", "authorized", a number from 2 to 99, or a named group. Literal. */
+        group: 'public' | 'authorized' | number | string;
+        /** The newsletter's message_id (getNewsletters()). Literal; it must be stored under the group when the ticket is registered. */
+        newsletter: string;
+        actions?: TicketAction[];
+    };
+    err?: TicketAction[];
+    retry?: boolean;
+} | {
+    /**
+     * Respond: answers the consumer now, then stops or goes on. One per run: a second Respond
+     * on a path that already answered is refused at registration, and ALREADY_RESPONDED when
+     * it runs. consumeTicket() resolves with the body (or the receipt), whatever the status.
+     */
+    act: 'resp';
+    exe: {
+        /** The HTTP status, 100 to 599, or a reference. Default 200. An error status is still an answer, not a failure. */
+        status?: number | string;
+        /** Any JSON, templated; absent: the receipt { tkid, hash }. A `stage` key is refused (that is how an error is told apart). */
+        body?: any;
+        /**
+         * What happens after the answer. Absent or "stop": the rest of the chain does not run.
+         * "0m": goes on at once, in the background. "<n>m" | "<n>h" | "<n>d" (n >= 1): goes on
+         * after that delay, to the minute. A number: a time in ms since the epoch, to the second
+         * (a literal in the past is refused at registration; a templated one goes on at once).
+         * A run that goes on counts toward the plan's queued ticket runs for the month; Free and
+         * Standard stop at theirs (QUOTA_EXCEEDED), Premium is billed past it.
+         */
+        resume?: 'stop' | '0m' | `${number}m` | `${number}h` | `${number}d` | number | string;
+    };
+    err?: TicketAction[];
+} | {
+    /**
+     * Condition: rows inside a chain, under the rules of the ticket's own condition. A part
+     * that fails fails the chain here with CONDITION_FAILED (the action's `err` chain runs).
+     * Answers nothing. `response` rows only inside a Then chain, `error` rows only inside an
+     * `err` chain, `placeholder` rows name placeholders (and may compare with null).
+     */
+    act: 'cond';
+    exe: {
+        data?: TicketConditionRow[];
+        params?: TicketConditionRow[];
+        headers?: TicketCondition['headers'];
+        ip?: TicketCondition['ip'];
+        user_agent?: TicketCondition['user_agent'];
+        user?: TicketCondition['user'];
+        record_access?: string;
+        placeholder?: {
+            key: string;
+            operator: TicketConditionOperator;
+            value: any;
+        }[];
+        /** Rows on the enclosing action's answer, inside a Then chain only: a key reads a field, "" the whole answer as text. */
+        response?: TicketConditionRow[];
+        /** Rows on the failure, inside an err chain only: code, message, detail, action, path, or "" for the whole error as text. */
+        error?: TicketConditionRow[];
+    };
+    err?: TicketAction[];
+};
+/** What a consumption answers when no Respond action composes the answer. */
+type TicketReceipt = {
+    ticket_id: string;
+    /** Id of this consumption: base62 of the timestamp in milliseconds, followed by 4 random characters. */
+    consume_id: string;
+    /** The consumer. The user id on the signed-in endpoint, else "<ip>(<user agent>)". */
+    user_id: string;
+    /** Always false here: dry runs go through the check URL, which consumeTicket() never calls. */
+    is_test: boolean;
+    /** When the consumption happened, in milliseconds. Decoded from consume_id. */
+    timestamp: number;
+    /** Proof string of the consumption. */
+    hash: string;
 };
 /** An issued ticket as getTickets() and registerTicket() return it. */
 type Ticket = {
@@ -1026,7 +1154,7 @@ type Ticket = {
      */
     legacy?: boolean;
 };
-type TicketErrorCode = 'INVALID_SERVICE' | 'SERVICE_DISABLED' | 'TICKET_NOT_FOUND' | 'TICKET_EXPIRED' | 'TICKET_EXHAUSTED' | 'USER_LIMIT_REACHED' | 'ISSUER_CANNOT_CONSUME' | 'AUTH_REQUIRED' | 'METHOD_NOT_ALLOWED' | 'CONDITION_FAILED' | 'PATH_NOT_FOUND' | 'PLACEHOLDER_MISSING' | 'REQUEST_FAILED' | 'TIMEOUT' | 'ACTION_FAILED' | 'ACTION_FORBIDDEN' | 'INTERNAL_ERROR';
+type TicketErrorCode = 'INVALID_SERVICE' | 'SERVICE_DISABLED' | 'TICKET_NOT_FOUND' | 'TICKET_EXPIRED' | 'TICKET_EXHAUSTED' | 'USER_LIMIT_REACHED' | 'ISSUER_CANNOT_CONSUME' | 'AUTH_REQUIRED' | 'METHOD_NOT_ALLOWED' | 'CONDITION_FAILED' | 'PATH_NOT_FOUND' | 'PLACEHOLDER_MISSING' | 'REQUEST_FAILED' | 'TIMEOUT' | 'ACTION_FAILED' | 'ACTION_FORBIDDEN' | 'QUOTA_EXCEEDED' | 'ALREADY_RESPONDED' | 'INTERNAL_ERROR';
 /**
  * The body a consume endpoint answers with when the consumption fails, and the `cause` of the
  * SkapiError consumeTicket() rejects with. A success body never has `stage`; an error body
@@ -1095,6 +1223,7 @@ type Types_TicketConditionOperator = TicketConditionOperator;
 type Types_TicketConditionRow = TicketConditionRow;
 type Types_TicketError = TicketError;
 type Types_TicketErrorCode = TicketErrorCode;
+type Types_TicketReceipt = TicketReceipt;
 type Types_TicketResponseCondition = TicketResponseCondition;
 type Types_TicketSignatureCondition = TicketSignatureCondition;
 type Types_UniqueId = UniqueId;
@@ -1103,7 +1232,7 @@ type Types_UserProfile = UserProfile;
 type Types_UserPublic = UserPublic;
 type Types_WebSocketMessage = WebSocketMessage;
 declare namespace Types {
-  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_ProgressCallback as ProgressCallback, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEvent as RTCEvent, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_WebSocketMessage as WebSocketMessage };
+  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_ProgressCallback as ProgressCallback, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEvent as RTCEvent, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketReceipt as TicketReceipt, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_WebSocketMessage as WebSocketMessage };
 }
 
 declare function terminatePendingRequests(): void;
@@ -1818,13 +1947,16 @@ declare class Skapi {
      * its actions run. An anonymous POST goes to `/tp/`, an anonymous GET to `/tg/` with `data`
      * as the query string, and a signed-in consumption (`auth: true`) to `/tpa/`, which is POST only.
      *
+     * Resolves with the receipt (TicketReceipt: ticket_id, consume_id, user_id, is_test, timestamp, hash),
+     * or with the body a Respond action of the ticket answered, as sent and whatever its status. `T` names that body.
+     *
      * A failed consumption rejects with a SkapiError: `err.code` is the ticket error code and
      * `err.cause` the flat TicketError body (`err.cause.stage`, `err.cause.action`, `err.cause.detail`).
      * This holds when the ticket answers HTTP 200 as well (`return200`): the body is inspected, not the status.
      * @param params Request parameters.
-     * @returns A promise that resolves to Promise<{ ticket_id: string; consume_id: string; user_id: string; is_test: boolean; timestamp: number; hash: string; }>.
+     * @returns A promise that resolves to Promise<T>, the receipt or the Respond body.
      */
-    consumeTicket(params: {
+    consumeTicket<T = TicketReceipt>(params: {
         /** ID of the ticket to consume. */
         ticket_id: string;
         /** "GET" or "POST". */
@@ -1835,14 +1967,7 @@ declare class Skapi {
         data?: {
             [key: string]: any;
         };
-    }): Promise<{
-        ticket_id: string;
-        consume_id: string;
-        user_id: string;
-        is_test: boolean;
-        timestamp: number;
-        hash: string;
-    }>;
+    }): Promise<T>;
     /**
      * Lists the tickets the signed-in user has consumed, with optional filters and pagination.
      * @param params Request parameters.
@@ -1861,9 +1986,29 @@ declare class Skapi {
      * @returns A promise that resolves to Promise<DatabaseResponse<any>>.
      */
     getTickets(params: {
-        /** Absent = every ticket. "<id>" = that ticket. "#<id>#" = the consumption log of that ticket (project owner only). */
+        /** Absent = every ticket. "<id>" = that ticket. "#<id>#" = the consumption log of that ticket, "@<id>#<consume id>#" the action rows of one consumption (project owner only). */
         ticket_id?: string;
+        /** A log listing only: rows from this time on, in milliseconds since the epoch. */
+        from?: number;
+        /** A log listing only: rows up to this time, in milliseconds since the epoch. */
+        to?: number;
     }, fetchOptions?: FetchOptions): Promise<DatabaseResponse<any>>;
+    /**
+     * Deletes a ticket's log rows before a time, in the background over the next minutes. The ticket's
+     * remaining count and its per-user limits are unchanged. Project owner only.
+     * @param params Request parameters.
+     * @returns A promise that resolves to Promise<{ message: string; ticket_id: string; before: number }>, `before` being the time applied (later than now is clipped to now).
+     */
+    clearTicketLog(params: {
+        /** The ticket whose log rows go. */
+        ticket_id: string;
+        /** Rows before this time, in milliseconds since the epoch. Default: now. */
+        before?: number;
+    }): Promise<{
+        message: string;
+        ticket_id: string;
+        before: number;
+    }>;
     /**
      * Closes the active realtime WebSocket connection.
      * @returns A promise that resolves to Promise<void>.
@@ -3010,4 +3155,4 @@ declare class SkapiError extends Error {
     });
 }
 
-export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCConnector, type RTCConnectorParams, type RTCEvent, type RTCReceiverParams, type RTCResolved, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };
+export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCConnector, type RTCConnectorParams, type RTCEvent, type RTCReceiverParams, type RTCResolved, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketReceipt, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };

package/dist/skapi.d.ts

@@ -296,6 +296,13 @@ type Newsletter = {
      * A number for the 0 ~ 99 groups, the group name for a named newsletter group.
      */
     group: number | string;
+    /**
+     * true: mailed to the group's dry address, so it is stored and was sent to nobody. The
+     * Newsletters page's Send button, or a ticket's Send newsletter action, sends it later.
+     */
+    dry?: boolean;
+    /** When the Send button or a ticket's Send newsletter action sent it, in ms. Absent on a newsletter that went out by e-mail. */
+    sent?: number;
 };
 type NewsletterGroup = {
     /** Name of the newsletter group. */
@@ -864,43 +871,55 @@ type TicketResponseCondition = Pick<TicketCondition, 'headers' | 'data' | 'user'
  * | `${user}`, `${user[key]}` | The signed-in user's attributes. Signed requests only. |
  * | `${ip}`, `${user_agent}`, `${method}` | The caller's IP address, User-Agent and HTTP method. |
  * | `${record_access}` | The record ID the condition's `record_access` names. Signed requests only. |
- * | `${response}`, `${response[key]}` | The parsed body of the enclosing req action's response. Only in that req's nested `actions` and their `err` chains. |
- * | `${result}`, `${result[key]}` | The result of the previous action in the same chain. A nested chain and an `err` chain start without one. |
+ * | `${response}`, `${response[key]}` | The answer of the enclosing action, in its Then chain (`actions`) and the `err` chains inside it: the record a pstr posted, the parsed body of a req's response, the SUCCESS text of acsg and acsr. |
  * | `${error}`, `${error[key]}` | In an `err` chain, the failure: `code`, `message`, `detail`, `action` (the act) and `path`. |
- * | `${ticket}`, `${ticket[key]}` | This consumption: `id`, `service`, `owner`, `consume_id` and `timestamp`. |
+ * | `${ticket}`, `${ticket[key]}` | This consumption: `id`, `service`, `owner`, `consume_id`, `timestamp` and `hash`. |
  * | `${CLIENT_SECRET}` | Reserved. See `secretName` on the req action. |
  *
  * Registration refuses anything else inside `${ }` (an unknown root such as `${id}`, keys under
  * a root that takes none such as `${ip[x]}`, `${placeholder}` or `${headers}` without a key,
- * broken brackets) with a message listing these forms, and a reference written where it can
- * never resolve (`${response}` outside a req's nested actions, `${error}` outside an `err`
+ * broken brackets) with a message listing these forms, `${result}` (gone: an answer is read as
+ * `${response}` in the action's Then chain, or captured there by a Condition action), and a reference written
+ * where it can never resolve (`${response}` outside a Then chain, `${error}` outside an `err`
  * chain, `${record_access}` when the condition names no record). When the action runs, a
  * reference that does not resolve fails it before it does anything: PATH_NOT_FOUND,
  * PLACEHOLDER_MISSING for a placeholder that was never captured, or AUTH_REQUIRED for `${user}`
  * on a request that is not signed in. Its `err` chain runs and the consumption stops.
+ *
+ * Every action but resp and cond answers something (the record, the response body, a SUCCESS
+ * text) and may carry a Then chain (`actions`, reading the answer as `${response}`). A Condition
+ * action in that chain checks the answer: its `response` rows read it whole (key "") or by key,
+ * whatever its shape. `retry: true` on acsg, acsr, pstr, req, mail and nlsd tries a failure again,
+ * up to 3 more times, 1, 2 and 4 seconds apart, while the time budget holds them; never for a
+ * failure inside Then.
  */
 type TicketAction = {
-    /** Set the access group of a user. */
+    /** Set the access group of a user. Answers the SUCCESS text the grant returns. */
     act: 'acsg';
     exe: {
         /** 1 ~ 99, or "admin", or a reference that gives one when the action runs, such as "${placeholder[GROUP]}". */
         group: number | 'admin' | `${string}\${${string}}${string}`;
         /** Blank = the consumer (signed-in consumption only). The project owner cannot be a target. */
         user_id?: string;
+        /** The Then chain, reading the answer as `${response}`. */
+        actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
 } | {
-    /** Grant private access to a record. */
+    /** Grant private access to a record. Answers the SUCCESS text the grant returns. */
     act: 'acsr';
     exe: {
         /** A record ID, not a unique ID. */
         record_id: string;
         /** Blank = the consumer. */
         user_id?: string | string[];
+        actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
 } | {
-    /** Post a record. Everything but `user_id` is the payload postRecord() sends, so the same rules apply. A `unique_id` makes a retried webhook update the same record instead of adding one. */
+    /** Post a record. Everything but `user_id` is the payload postRecord() sends, so the same rules apply. A `unique_id` makes a retried webhook update the same record instead of adding one. Answers the record (RecordData). */
     act: 'pstr';
     exe: {
         table: string | {
@@ -922,10 +941,13 @@ type TicketAction = {
         source?: PostRecordConfig['source'];
         /** Post as this user instead of the project owner. */
         user_id?: string;
+        /** The Then chain, reading the record as `${response}` (`${response[record_id]}`). */
+        actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
 } | {
-    /** HTTP request with its own response condition and nested chain. Result: the parsed response body. */
+    /** HTTP request with its own response condition and nested chain. Answers the parsed response body. */
     act: 'req';
     exe: {
         /**
@@ -990,7 +1012,7 @@ type TicketAction = {
         };
         /** Legacy. Registration moves these rows to the end of `condition.data`. */
         match?: TicketConditionRow[];
-        /** Checked against the response. Captures land in the shared placeholder pool. See TicketResponseCondition. */
+        /** Skapi's own billing rows only. A response check is a Condition action in `actions`, whose `response` rows read the answer. */
         condition?: TicketResponseCondition;
         /**
          * Nested chain, run when the response passes `condition`. It reads the response body
@@ -1000,6 +1022,112 @@ type TicketAction = {
         actions?: TicketAction[];
     };
     err?: TicketAction[];
+    retry?: boolean;
+} | {
+    /**
+     * Send e-mail: one e-mail from a CUSTOM template of the project (the Custom tab of the
+     * Automated Emails page) to one address, from the project's alias. Counts as one e-mail
+     * send (the plan's monthly sends, the Free owner cap and the complaint shutoff apply; a
+     * refusal is QUOTA_EXCEEDED). Answers "SUCCESS: E-mail sent to <address>."
+     */
+    act: 'mail';
+    exe: {
+        /** The template's ID, as the Custom tab and the upload reply show it. Literal; it must be stored when the ticket is registered. */
+        template: string;
+        /** The recipient: one address, or a reference that gives one, such as "${user[email]}" or "${data[email]}". */
+        to: string;
+        /**
+         * Values for the placeholders the template carries, by name: { "order": "${data[order][id]}" } fills
+         * ${order}. Templated. "service_name" and "email" (the recipient) are filled by default and may be
+         * overwritten here. Up to 30.
+         */
+        placeholders?: {
+            [name: string]: string | number | boolean;
+        };
+        actions?: TicketAction[];
+    };
+    err?: TicketAction[];
+    retry?: boolean;
+} | {
+    /**
+     * Send newsletter: a stored newsletter of a group, dry or already sent, to every subscriber of the
+     * group, the way an e-mailed newsletter goes out (one e-mail send per subscriber, same gates).
+     * Answers "SUCCESS: Newsletter sent to the subscribers of <group>."
+     */
+    act: 'nlsd';
+    exe: {
+        /** "public", "authorized", a number from 2 to 99, or a named group. Literal. */
+        group: 'public' | 'authorized' | number | string;
+        /** The newsletter's message_id (getNewsletters()). Literal; it must be stored under the group when the ticket is registered. */
+        newsletter: string;
+        actions?: TicketAction[];
+    };
+    err?: TicketAction[];
+    retry?: boolean;
+} | {
+    /**
+     * Respond: answers the consumer now, then stops or goes on. One per run: a second Respond
+     * on a path that already answered is refused at registration, and ALREADY_RESPONDED when
+     * it runs. consumeTicket() resolves with the body (or the receipt), whatever the status.
+     */
+    act: 'resp';
+    exe: {
+        /** The HTTP status, 100 to 599, or a reference. Default 200. An error status is still an answer, not a failure. */
+        status?: number | string;
+        /** Any JSON, templated; absent: the receipt { tkid, hash }. A `stage` key is refused (that is how an error is told apart). */
+        body?: any;
+        /**
+         * What happens after the answer. Absent or "stop": the rest of the chain does not run.
+         * "0m": goes on at once, in the background. "<n>m" | "<n>h" | "<n>d" (n >= 1): goes on
+         * after that delay, to the minute. A number: a time in ms since the epoch, to the second
+         * (a literal in the past is refused at registration; a templated one goes on at once).
+         * A run that goes on counts toward the plan's queued ticket runs for the month; Free and
+         * Standard stop at theirs (QUOTA_EXCEEDED), Premium is billed past it.
+         */
+        resume?: 'stop' | '0m' | `${number}m` | `${number}h` | `${number}d` | number | string;
+    };
+    err?: TicketAction[];
+} | {
+    /**
+     * Condition: rows inside a chain, under the rules of the ticket's own condition. A part
+     * that fails fails the chain here with CONDITION_FAILED (the action's `err` chain runs).
+     * Answers nothing. `response` rows only inside a Then chain, `error` rows only inside an
+     * `err` chain, `placeholder` rows name placeholders (and may compare with null).
+     */
+    act: 'cond';
+    exe: {
+        data?: TicketConditionRow[];
+        params?: TicketConditionRow[];
+        headers?: TicketCondition['headers'];
+        ip?: TicketCondition['ip'];
+        user_agent?: TicketCondition['user_agent'];
+        user?: TicketCondition['user'];
+        record_access?: string;
+        placeholder?: {
+            key: string;
+            operator: TicketConditionOperator;
+            value: any;
+        }[];
+        /** Rows on the enclosing action's answer, inside a Then chain only: a key reads a field, "" the whole answer as text. */
+        response?: TicketConditionRow[];
+        /** Rows on the failure, inside an err chain only: code, message, detail, action, path, or "" for the whole error as text. */
+        error?: TicketConditionRow[];
+    };
+    err?: TicketAction[];
+};
+/** What a consumption answers when no Respond action composes the answer. */
+type TicketReceipt = {
+    ticket_id: string;
+    /** Id of this consumption: base62 of the timestamp in milliseconds, followed by 4 random characters. */
+    consume_id: string;
+    /** The consumer. The user id on the signed-in endpoint, else "<ip>(<user agent>)". */
+    user_id: string;
+    /** Always false here: dry runs go through the check URL, which consumeTicket() never calls. */
+    is_test: boolean;
+    /** When the consumption happened, in milliseconds. Decoded from consume_id. */
+    timestamp: number;
+    /** Proof string of the consumption. */
+    hash: string;
 };
 /** An issued ticket as getTickets() and registerTicket() return it. */
 type Ticket = {
@@ -1026,7 +1154,7 @@ type Ticket = {
      */
     legacy?: boolean;
 };
-type TicketErrorCode = 'INVALID_SERVICE' | 'SERVICE_DISABLED' | 'TICKET_NOT_FOUND' | 'TICKET_EXPIRED' | 'TICKET_EXHAUSTED' | 'USER_LIMIT_REACHED' | 'ISSUER_CANNOT_CONSUME' | 'AUTH_REQUIRED' | 'METHOD_NOT_ALLOWED' | 'CONDITION_FAILED' | 'PATH_NOT_FOUND' | 'PLACEHOLDER_MISSING' | 'REQUEST_FAILED' | 'TIMEOUT' | 'ACTION_FAILED' | 'ACTION_FORBIDDEN' | 'INTERNAL_ERROR';
+type TicketErrorCode = 'INVALID_SERVICE' | 'SERVICE_DISABLED' | 'TICKET_NOT_FOUND' | 'TICKET_EXPIRED' | 'TICKET_EXHAUSTED' | 'USER_LIMIT_REACHED' | 'ISSUER_CANNOT_CONSUME' | 'AUTH_REQUIRED' | 'METHOD_NOT_ALLOWED' | 'CONDITION_FAILED' | 'PATH_NOT_FOUND' | 'PLACEHOLDER_MISSING' | 'REQUEST_FAILED' | 'TIMEOUT' | 'ACTION_FAILED' | 'ACTION_FORBIDDEN' | 'QUOTA_EXCEEDED' | 'ALREADY_RESPONDED' | 'INTERNAL_ERROR';
 /**
  * The body a consume endpoint answers with when the consumption fails, and the `cause` of the
  * SkapiError consumeTicket() rejects with. A success body never has `stage`; an error body
@@ -1095,6 +1223,7 @@ type Types_TicketConditionOperator = TicketConditionOperator;
 type Types_TicketConditionRow = TicketConditionRow;
 type Types_TicketError = TicketError;
 type Types_TicketErrorCode = TicketErrorCode;
+type Types_TicketReceipt = TicketReceipt;
 type Types_TicketResponseCondition = TicketResponseCondition;
 type Types_TicketSignatureCondition = TicketSignatureCondition;
 type Types_UniqueId = UniqueId;
@@ -1103,7 +1232,7 @@ type Types_UserProfile = UserProfile;
 type Types_UserPublic = UserPublic;
 type Types_WebSocketMessage = WebSocketMessage;
 declare namespace Types {
-  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_ProgressCallback as ProgressCallback, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEvent as RTCEvent, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_WebSocketMessage as WebSocketMessage };
+  export type { Types_BinaryFile as BinaryFile, Types_Condition as Condition, Types_Connection as Connection, Types_ConnectionInfo as ConnectionInfo, Types_DatabaseResponse as DatabaseResponse, Types_DelRecordQuery as DelRecordQuery, Types_EncryptionOptions as EncryptionOptions, Types_FetchOptions as FetchOptions, Types_FileInfo as FileInfo, Types_Form as Form, Types_GetRecordQuery as GetRecordQuery, Types_Index as Index, Types_Newsletter as Newsletter, Types_NewsletterGroup as NewsletterGroup, Types_PostRecordConfig as PostRecordConfig, Types_ProgressCallback as ProgressCallback, Types_RTCConnector as RTCConnector, Types_RTCConnectorParams as RTCConnectorParams, Types_RTCEvent as RTCEvent, Types_RTCReceiverParams as RTCReceiverParams, Types_RTCResolved as RTCResolved, Types_RealtimeCallback as RealtimeCallback, Types_RecordData as RecordData, Types_RecordEncryptionInfo as RecordEncryptionInfo, Types_RequestHistory as RequestHistory, Types_Subscription as Subscription, Types_Table as Table, Types_Tag as Tag, Types_Ticket as Ticket, Types_TicketAction as TicketAction, Types_TicketCondition as TicketCondition, Types_TicketConditionOperator as TicketConditionOperator, Types_TicketConditionRow as TicketConditionRow, Types_TicketError as TicketError, Types_TicketErrorCode as TicketErrorCode, Types_TicketReceipt as TicketReceipt, Types_TicketResponseCondition as TicketResponseCondition, Types_TicketSignatureCondition as TicketSignatureCondition, Types_UniqueId as UniqueId, Types_UserAttributes as UserAttributes, Types_UserProfile as UserProfile, Types_UserPublic as UserPublic, Types_WebSocketMessage as WebSocketMessage };
 }
 
 declare function terminatePendingRequests(): void;
@@ -1818,13 +1947,16 @@ declare class Skapi {
      * its actions run. An anonymous POST goes to `/tp/`, an anonymous GET to `/tg/` with `data`
      * as the query string, and a signed-in consumption (`auth: true`) to `/tpa/`, which is POST only.
      *
+     * Resolves with the receipt (TicketReceipt: ticket_id, consume_id, user_id, is_test, timestamp, hash),
+     * or with the body a Respond action of the ticket answered, as sent and whatever its status. `T` names that body.
+     *
      * A failed consumption rejects with a SkapiError: `err.code` is the ticket error code and
      * `err.cause` the flat TicketError body (`err.cause.stage`, `err.cause.action`, `err.cause.detail`).
      * This holds when the ticket answers HTTP 200 as well (`return200`): the body is inspected, not the status.
      * @param params Request parameters.
-     * @returns A promise that resolves to Promise<{ ticket_id: string; consume_id: string; user_id: string; is_test: boolean; timestamp: number; hash: string; }>.
+     * @returns A promise that resolves to Promise<T>, the receipt or the Respond body.
      */
-    consumeTicket(params: {
+    consumeTicket<T = TicketReceipt>(params: {
         /** ID of the ticket to consume. */
         ticket_id: string;
         /** "GET" or "POST". */
@@ -1835,14 +1967,7 @@ declare class Skapi {
         data?: {
             [key: string]: any;
         };
-    }): Promise<{
-        ticket_id: string;
-        consume_id: string;
-        user_id: string;
-        is_test: boolean;
-        timestamp: number;
-        hash: string;
-    }>;
+    }): Promise<T>;
     /**
      * Lists the tickets the signed-in user has consumed, with optional filters and pagination.
      * @param params Request parameters.
@@ -1861,9 +1986,29 @@ declare class Skapi {
      * @returns A promise that resolves to Promise<DatabaseResponse<any>>.
      */
     getTickets(params: {
-        /** Absent = every ticket. "<id>" = that ticket. "#<id>#" = the consumption log of that ticket (project owner only). */
+        /** Absent = every ticket. "<id>" = that ticket. "#<id>#" = the consumption log of that ticket, "@<id>#<consume id>#" the action rows of one consumption (project owner only). */
         ticket_id?: string;
+        /** A log listing only: rows from this time on, in milliseconds since the epoch. */
+        from?: number;
+        /** A log listing only: rows up to this time, in milliseconds since the epoch. */
+        to?: number;
     }, fetchOptions?: FetchOptions): Promise<DatabaseResponse<any>>;
+    /**
+     * Deletes a ticket's log rows before a time, in the background over the next minutes. The ticket's
+     * remaining count and its per-user limits are unchanged. Project owner only.
+     * @param params Request parameters.
+     * @returns A promise that resolves to Promise<{ message: string; ticket_id: string; before: number }>, `before` being the time applied (later than now is clipped to now).
+     */
+    clearTicketLog(params: {
+        /** The ticket whose log rows go. */
+        ticket_id: string;
+        /** Rows before this time, in milliseconds since the epoch. Default: now. */
+        before?: number;
+    }): Promise<{
+        message: string;
+        ticket_id: string;
+        before: number;
+    }>;
     /**
      * Closes the active realtime WebSocket connection.
      * @returns A promise that resolves to Promise<void>.
@@ -3010,4 +3155,4 @@ declare class SkapiError extends Error {
     });
 }
 
-export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCConnector, type RTCConnectorParams, type RTCEvent, type RTCReceiverParams, type RTCResolved, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };
+export { type BinaryFile, type Condition, type Connection, type ConnectionInfo, type DatabaseResponse, type DelRecordQuery, type FetchOptions, type FileInfo, type Form, type GetRecordQuery, type Index, type Newsletter, type NewsletterGroup, type PostRecordConfig, type ProgressCallback, type RTCConnector, type RTCConnectorParams, type RTCEvent, type RTCReceiverParams, type RTCResolved, type RealtimeCallback, type RecordData, Skapi, SkapiError, type Subscription, type Table, type Tag, type Ticket, type TicketAction, type TicketCondition, type TicketConditionOperator, type TicketConditionRow, type TicketError, type TicketErrorCode, type TicketReceipt, type TicketResponseCondition, type TicketSignatureCondition, Types, type UniqueId, type UserAttributes, type UserProfile, type UserPublic, type WebSocketMessage };