@taktoria/sdk 0.1.0 → 0.1.2

package/dist/esm/api/resources/platform/client/Client.mjs

@@ -106,8 +106,8 @@ export class PlatformClient {
         });
     }
     /**
-     * Turn kinds of notification on or off, by email and by Slack, for the
-     * person behind this key or session; anything not named keeps its
+     * Turn kinds of notification on or off, by email, by Slack and by
+     * Microsoft Teams, for the person behind this key or session; anything not named keeps its
      * value. Like reading them, it needs no scope, and a signed-in session
      * may change its own. `404` for a key whose maker has left.
      *

package/dist/esm/api/resources/platform/types/NotificationChannels.d.mts

@@ -1,10 +1,15 @@
 /**
  * How one kind of notification reaches you. Each is on until turned off.
- * Slack is a direct message, sent only in a workspace that has connected
- * Slack, whatever this says.
+ * Slack and Microsoft Teams are direct messages, each sent only in a
+ * workspace that has connected it, whatever this says.
  */
 export interface NotificationChannels {
     email: boolean;
     /** Always `false` for `productTips`, which come by email only. */
     slack: boolean;
+    /**
+     * A Microsoft Teams chat with Taktoria's bot. Always `false` for
+     * `productTips`, which come by email only.
+     */
+    teams: boolean;
 }

package/dist/esm/api/resources/platform/types/UpdateNotificationChannels.d.mts

@@ -1,4 +1,5 @@
 export interface UpdateNotificationChannels {
     email?: boolean;
     slack?: boolean;
+    teams?: boolean;
 }

package/dist/esm/api/resources/platform/types/UpdateNotificationPreferencesRequest.d.mts

@@ -13,7 +13,7 @@ export interface UpdateNotificationPreferencesRequest {
     doryHostReminder?: Taktoria.UpdateNotificationChannels;
     trialEnding?: Taktoria.UpdateNotificationChannels;
     seatsAddedSummary?: Taktoria.UpdateNotificationChannels;
-    /** `slack` is refused here: tips come by email only. */
+    /** `slack` and `teams` are refused here: tips come by email only. */
     productTips?: Taktoria.UpdateNotificationChannels;
     waitingListSeats?: Taktoria.UpdateNotificationChannels;
 }

package/dist/esm/api/resources/platform/types/WaitingForSeat.d.mts

@@ -4,8 +4,8 @@ import type * as Taktoria from "../../../index.mjs";
  * was taken, and seats were not growing as people join. Seats freed (one
  * taken away, somebody leaving) or bought (more seats, a trial starting)
  * go to the first on the list by themselves, never past the seats paid
- * for; they are told, by email and Slack as they choose, as
- * `waitingListSeats`. Taking somebody's seat away never puts them on it.
+ * for; they are told, by email, Slack or Microsoft Teams as they choose,
+ * as `waitingListSeats`. Taking somebody's seat away never puts them on it.
  */
 export interface WaitingForSeat {
     appSlug: string;

package/dist/esm/api/resources/posts/client/Client.d.mts

@@ -52,8 +52,10 @@ export declare class PostsClient {
     private __create;
     /**
      * Change a post's body, and an update's health. Only its author may:
-     * through an API key, the person the key belongs to. Needs
-     * `launches:write`.
+     * through an API key, the person the key belongs to. A post a ticketing
+     * sync brought in (one with a `source`) is that system's: changing it
+     * here is a `409 conflict`; change it there, and the next sync brings
+     * it across. Needs `launches:write`.
      *
      * @param {string} launchId
      * @param {string} postId
@@ -62,6 +64,7 @@ export declare class PostsClient {
      *
      * @throws {@link Taktoria.NotFoundError}
      * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.ConflictError}
      * @throws {@link Taktoria.ValidationError}
      * @throws {@link Taktoria.TooManyRequestsError}
      * @throws {@link errors.TaktoriaError}

package/dist/esm/api/resources/posts/client/Client.mjs

@@ -216,8 +216,10 @@ export class PostsClient {
     }
     /**
      * Change a post's body, and an update's health. Only its author may:
-     * through an API key, the person the key belongs to. Needs
-     * `launches:write`.
+     * through an API key, the person the key belongs to. A post a ticketing
+     * sync brought in (one with a `source`) is that system's: changing it
+     * here is a `409 conflict`; change it there, and the next sync brings
+     * it across. Needs `launches:write`.
      *
      * @param {string} launchId
      * @param {string} postId
@@ -226,6 +228,7 @@ export class PostsClient {
      *
      * @throws {@link Taktoria.NotFoundError}
      * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.ConflictError}
      * @throws {@link Taktoria.ValidationError}
      * @throws {@link Taktoria.TooManyRequestsError}
      * @throws {@link errors.TaktoriaError}
@@ -291,6 +294,14 @@ export class PostsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 409:
+                        throw new Taktoria.ConflictError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     case 422:
                         throw new Taktoria.ValidationError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",

package/dist/esm/api/resources/posts/types/LaunchPost.d.mts

@@ -18,9 +18,10 @@ export interface LaunchPost {
     editedAt?: Date;
     /**
      * The ticketing system a post came from, when a sync brought it in
-     * from the launch's ticketing project (a status update from Linear,
-     * GitHub or Asana, or a comment from Jira or ClickUp); null for one
-     * written here. Such a post is changed in
+     * from the launch's ticketing project (a status update from Linear or
+     * GitHub, or a comment from Jira or ClickUp); null for one written
+     * here. Asana's status updates are not brought in: Taktoria's
+     * read-only connection cannot read them. Such a post is changed in
      * that system, not here: editing it is a `409 conflict`, and the next
      * sync brings the change across.
      */

package/dist/esm/api/resources/slackConnections/client/Client.d.mts

@@ -0,0 +1,56 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Taktoria from "../../../index.mjs";
+export declare namespace SlackConnectionsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class SlackConnectionsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<SlackConnectionsClient.Options>;
+    constructor(options: SlackConnectionsClient.Options);
+    /**
+     * The workspace's Slack connections, newest first. A key, or a
+     * workspace admin's session, sees every one; anybody else's session
+     * sees their own, as the connect page lists them. Requires
+     * `slackConnections:read`.
+     *
+     * @param {Taktoria.ListSlackConnectionsRequest} request
+     * @param {SlackConnectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Taktoria.UnauthorizedError}
+     * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.TooManyRequestsError}
+     * @throws {@link errors.TaktoriaError}
+     * @throws {@link errors.TaktoriaTimeoutError}
+     *
+     * @example
+     *     await client.slackConnections.list()
+     */
+    list(request?: Taktoria.ListSlackConnectionsRequest, requestOptions?: SlackConnectionsClient.RequestOptions): core.HttpResponsePromise<Taktoria.SlackConnectionPage>;
+    private __list;
+    /**
+     * Disconnect a Slack account, as the connect page's **Disconnect**
+     * does: where Google is required, its commands are refused from the
+     * next one, with a link to connect again. In the audit log as
+     * `slack_user_link.deleted`. Requires `slackConnections:write`. A
+     * person's session disconnects their own; a key or a workspace admin's
+     * session, anybody's. One the caller may not see is `404 not_found`.
+     *
+     * @param {string} connectionId
+     * @param {SlackConnectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Taktoria.UnauthorizedError}
+     * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.NotFoundError}
+     * @throws {@link Taktoria.TooManyRequestsError}
+     * @throws {@link errors.TaktoriaError}
+     * @throws {@link errors.TaktoriaTimeoutError}
+     *
+     * @example
+     *     await client.slackConnections.disconnect("slk_4b1e")
+     */
+    disconnect(connectionId: string, requestOptions?: SlackConnectionsClient.RequestOptions): core.HttpResponsePromise<void>;
+    private __disconnect;
+}

package/dist/esm/api/resources/slackConnections/client/Client.mjs

@@ -0,0 +1,206 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as serializers from "../../../../serialization/index.mjs";
+import * as Taktoria from "../../../index.mjs";
+export class SlackConnectionsClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * The workspace's Slack connections, newest first. A key, or a
+     * workspace admin's session, sees every one; anybody else's session
+     * sees their own, as the connect page lists them. Requires
+     * `slackConnections:read`.
+     *
+     * @param {Taktoria.ListSlackConnectionsRequest} request
+     * @param {SlackConnectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Taktoria.UnauthorizedError}
+     * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.TooManyRequestsError}
+     * @throws {@link errors.TaktoriaError}
+     * @throws {@link errors.TaktoriaTimeoutError}
+     *
+     * @example
+     *     await client.slackConnections.list()
+     */
+    list(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    __list() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { limit, cursor } = request;
+            const _queryParams = {
+                limit,
+                cursor,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.TaktoriaEnvironment.Production, "/slack-connections"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.SlackConnectionPage.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Taktoria.UnauthorizedError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new Taktoria.ForbiddenError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 429:
+                        throw new Taktoria.TooManyRequestsError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TaktoriaError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/slack-connections");
+        });
+    }
+    /**
+     * Disconnect a Slack account, as the connect page's **Disconnect**
+     * does: where Google is required, its commands are refused from the
+     * next one, with a link to connect again. In the audit log as
+     * `slack_user_link.deleted`. Requires `slackConnections:write`. A
+     * person's session disconnects their own; a key or a workspace admin's
+     * session, anybody's. One the caller may not see is `404 not_found`.
+     *
+     * @param {string} connectionId
+     * @param {SlackConnectionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Taktoria.UnauthorizedError}
+     * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.NotFoundError}
+     * @throws {@link Taktoria.TooManyRequestsError}
+     * @throws {@link errors.TaktoriaError}
+     * @throws {@link errors.TaktoriaTimeoutError}
+     *
+     * @example
+     *     await client.slackConnections.disconnect("slk_4b1e")
+     */
+    disconnect(connectionId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__disconnect(connectionId, requestOptions));
+    }
+    __disconnect(connectionId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.TaktoriaEnvironment.Production, `/slack-connections/${core.url.encodePathParam(connectionId)}`),
+                method: "DELETE",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Taktoria.UnauthorizedError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new Taktoria.ForbiddenError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 404:
+                        throw new Taktoria.NotFoundError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 429:
+                        throw new Taktoria.TooManyRequestsError(serializers.ErrorBody.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TaktoriaError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/slack-connections/{connectionId}");
+        });
+    }
+}

package/dist/esm/api/resources/slackConnections/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/slackConnections/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/slackConnections/client/requests/ListSlackConnectionsRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListSlackConnectionsRequest {
+    /** 1 to 200; 50 by default. */
+    limit?: number;
+    cursor?: string;
+}

package/dist/esm/api/resources/slackConnections/client/requests/ListSlackConnectionsRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/slackConnections/client/requests/index.d.mts

@@ -0,0 +1 @@
+export type { ListSlackConnectionsRequest } from "./ListSlackConnectionsRequest.mjs";

package/dist/esm/api/resources/slackConnections/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/slackConnections/exports.d.mts

@@ -0,0 +1,2 @@
+export { SlackConnectionsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/slackConnections/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { SlackConnectionsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/slackConnections/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/slackConnections/index.mjs

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/slackConnections/types/SlackConnection.d.mts

@@ -0,0 +1,16 @@
+import type * as Taktoria from "../../../index.mjs";
+/**
+ * A Slack account its owner connected by signing in with Google, on the
+ * page a Slack command links to. In a workspace that requires Google
+ * sign-in and does not take Slack's word for who typed a command
+ * (`slackCommandsWithoutGoogle` false on `GET /organization`), only a
+ * connected account's commands are acted on: as its owner, with their
+ * seats and rights. A connection counts only while Slack still gives the
+ * address of the member who made it.
+ */
+export interface SlackConnection {
+    id: string;
+    person: Taktoria.SlackConnectionPerson;
+    slack: Taktoria.SlackConnectionAccount;
+    createdAt: Date;
+}

package/dist/esm/api/resources/slackConnections/types/SlackConnection.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/slackConnections/types/SlackConnectionAccount.d.mts

@@ -0,0 +1,15 @@
+/**
+ * The Slack account connected.
+ */
+export interface SlackConnectionAccount {
+    /** The Slack workspace's id, such as `T0123ABCD`. */
+    teamId: string;
+    /**
+     * The Slack workspace's name, while Taktoria is still connected to
+     * it. A connection to a Slack workspace since disconnected keeps its
+     * id, and does nothing.
+     */
+    teamName?: string;
+    /** The person's Slack user id, such as `U0123ABCD`. */
+    userId: string;
+}

package/dist/esm/api/resources/slackConnections/types/SlackConnectionAccount.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/slackConnections/types/SlackConnectionPage.d.mts

@@ -0,0 +1,7 @@
+import type * as Taktoria from "../../../index.mjs";
+export interface SlackConnectionPage {
+    data: Taktoria.SlackConnection[];
+    /** Pass as `cursor` for the next page; null on the last. */
+    nextCursor?: string;
+    hasMore: boolean;
+}

package/dist/esm/api/resources/slackConnections/types/SlackConnectionPage.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/slackConnections/types/SlackConnectionPerson.d.mts

@@ -0,0 +1,7 @@
+/**
+ * The member whose Slack account it is, and whom Slack commands act as.
+ */
+export interface SlackConnectionPerson {
+    id: string;
+    name: string;
+}

package/dist/esm/api/resources/slackConnections/types/SlackConnectionPerson.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/slackConnections/types/index.d.mts

@@ -0,0 +1,4 @@
+export * from "./SlackConnection.mjs";
+export * from "./SlackConnectionAccount.mjs";
+export * from "./SlackConnectionPage.mjs";
+export * from "./SlackConnectionPerson.mjs";

package/dist/esm/api/resources/slackConnections/types/index.mjs

@@ -0,0 +1,4 @@
+export * from "./SlackConnection.mjs";
+export * from "./SlackConnectionAccount.mjs";
+export * from "./SlackConnectionPage.mjs";
+export * from "./SlackConnectionPerson.mjs";

package/dist/esm/api/resources/steps/client/Client.d.mts

@@ -47,10 +47,14 @@ export declare class StepsClient {
     createForLaunch(launchId: string, request: Taktoria.CreateStepRequest, requestOptions?: StepsClient.RequestOptions): core.HttpResponsePromise<Taktoria.LaunchStep>;
     private __createForLaunch;
     /**
-     * "Add Launch Steps" copies the steps of the launch's own launch template
+     * "Add launch steps" copies the steps of the launch's own launch template
      * (`launchTemplateId`, the workspace's default when it has none) onto
      * the launch, back-scheduling each step from the planned launch date, and
-     * creates the press release, dashboard and learnings artifacts. Run again,
+     * creates the press release, dashboard and learnings artifacts. A step
+     * starts with its template step's default reviewer
+     * (`defaultReviewer` on the step template) when that is still a member
+     * of the workspace, who is told as anybody given a step is: once the
+     * launch is published, if it is a draft. Run again,
      * say after the launch switches template, it adds only the steps the
      * launch lacks: a step it already has, or the same review (the same name
      * for the same functional team) from another template, is left out, and
@@ -165,12 +169,14 @@ export declare class StepsClient {
     setReason(stepId: string, request: Taktoria.SetDecisionReasonRequest, requestOptions?: StepsClient.RequestOptions): core.HttpResponsePromise<Taktoria.LaunchStep>;
     private __setReason;
     /**
-     * Nudge the assigned reviewer over email and Slack. Throttled to one
-     * nudge per step per hour however many times it is called; `queued`
-     * is true either way, and `lastNudgedAt` on the step says when the
-     * last one went. A draft's reviewer hears nothing until it is
-     * published. A step with no reviewer is `409 no_reviewer`, and a key
-     * whose maker has left the workspace is `403 forbidden`: a nudge
+     * Nudge the assigned reviewer over email and Slack, as the step's bell
+     * does in the app. One nudge per step goes out an hour however many
+     * times it is called, and none on a draft, whose reviewers hear
+     * nothing until it is published: `sent` says whether this one went
+     * out and, when not, `reason` says why (`throttled`, with
+     * `retryInMinutes`, or `draft`). `lastNudgedAt` on the step says when
+     * the last one went. A step with no reviewer is `409 no_reviewer`, and
+     * a key whose maker has left the workspace is `403 forbidden`: a nudge
      * comes from a person.
      *
      * @param {string} stepId
@@ -184,7 +190,7 @@ export declare class StepsClient {
      * @throws {@link errors.TaktoriaTimeoutError}
      *
      * @example
-     *     await client.steps.nudge("stepId")
+     *     await client.steps.nudge("stp_1")
      */
     nudge(stepId: string, requestOptions?: StepsClient.RequestOptions): core.HttpResponsePromise<Taktoria.NudgeResponse>;
     private __nudge;

package/dist/esm/api/resources/steps/client/Client.mjs

@@ -196,10 +196,14 @@ export class StepsClient {
         });
     }
     /**
-     * "Add Launch Steps" copies the steps of the launch's own launch template
+     * "Add launch steps" copies the steps of the launch's own launch template
      * (`launchTemplateId`, the workspace's default when it has none) onto
      * the launch, back-scheduling each step from the planned launch date, and
-     * creates the press release, dashboard and learnings artifacts. Run again,
+     * creates the press release, dashboard and learnings artifacts. A step
+     * starts with its template step's default reviewer
+     * (`defaultReviewer` on the step template) when that is still a member
+     * of the workspace, who is told as anybody given a step is: once the
+     * launch is published, if it is a draft. Run again,
      * say after the launch switches template, it adds only the steps the
      * launch lacks: a step it already has, or the same review (the same name
      * for the same functional team) from another template, is left out, and
@@ -743,12 +747,14 @@ export class StepsClient {
         });
     }
     /**
-     * Nudge the assigned reviewer over email and Slack. Throttled to one
-     * nudge per step per hour however many times it is called; `queued`
-     * is true either way, and `lastNudgedAt` on the step says when the
-     * last one went. A draft's reviewer hears nothing until it is
-     * published. A step with no reviewer is `409 no_reviewer`, and a key
-     * whose maker has left the workspace is `403 forbidden`: a nudge
+     * Nudge the assigned reviewer over email and Slack, as the step's bell
+     * does in the app. One nudge per step goes out an hour however many
+     * times it is called, and none on a draft, whose reviewers hear
+     * nothing until it is published: `sent` says whether this one went
+     * out and, when not, `reason` says why (`throttled`, with
+     * `retryInMinutes`, or `draft`). `lastNudgedAt` on the step says when
+     * the last one went. A step with no reviewer is `409 no_reviewer`, and
+     * a key whose maker has left the workspace is `403 forbidden`: a nudge
      * comes from a person.
      *
      * @param {string} stepId
@@ -762,7 +768,7 @@ export class StepsClient {
      * @throws {@link errors.TaktoriaTimeoutError}
      *
      * @example
-     *     await client.steps.nudge("stepId")
+     *     await client.steps.nudge("stp_1")
      */
     nudge(stepId, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__nudge(stepId, requestOptions));
@@ -863,7 +869,7 @@ export class StepsClient {
     __reviewQueue() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { team, mine, status, reviewerUserId, q, year, quarter, limit, cursor } = request;
+            const { team, mine, status, reviewerUserId, q, period, year, quarter, limit, cursor } = request;
             const _queryParams = {
                 team,
                 mine,
@@ -875,6 +881,7 @@ export class StepsClient {
                     : undefined,
                 reviewerUserId,
                 q,
+                period,
                 year,
                 quarter,
                 limit,