@taktoria/sdk 0.1.0 → 0.1.2

package/dist/cjs/api/resources/slackConnections/client/Client.d.ts

@@ -0,0 +1,56 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as Taktoria from "../../../index.js";
+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/cjs/api/resources/slackConnections/client/Client.js

@@ -0,0 +1,243 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlackConnectionsClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const serializers = __importStar(require("../../../../serialization/index.js"));
+const Taktoria = __importStar(require("../../../index.js"));
+class SlackConnectionsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.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 = (0, headers_js_1.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 (0, handleNonStatusCodeError_js_1.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 = (0, headers_js_1.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 (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/slack-connections/{connectionId}");
+        });
+    }
+}
+exports.SlackConnectionsClient = SlackConnectionsClient;

package/dist/cjs/api/resources/slackConnections/client/index.d.ts

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

package/dist/cjs/api/resources/slackConnections/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/slackConnections/client/requests/ListSlackConnectionsRequest.d.ts

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

package/dist/cjs/api/resources/slackConnections/client/requests/ListSlackConnectionsRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/slackConnections/client/requests/index.d.ts

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

package/dist/cjs/api/resources/slackConnections/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/slackConnections/exports.d.ts

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

package/dist/cjs/api/resources/slackConnections/exports.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlackConnectionsClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "SlackConnectionsClient", { enumerable: true, get: function () { return Client_js_1.SlackConnectionsClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/api/resources/slackConnections/index.d.ts

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

package/dist/cjs/api/resources/slackConnections/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/slackConnections/types/SlackConnection.d.ts

@@ -0,0 +1,16 @@
+import type * as Taktoria from "../../../index.js";
+/**
+ * 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/cjs/api/resources/slackConnections/types/SlackConnection.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/slackConnections/types/SlackConnectionAccount.d.ts

@@ -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/cjs/api/resources/slackConnections/types/SlackConnectionAccount.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/slackConnections/types/SlackConnectionPage.d.ts

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

package/dist/cjs/api/resources/slackConnections/types/SlackConnectionPage.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/slackConnections/types/SlackConnectionPerson.d.ts

@@ -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/cjs/api/resources/slackConnections/types/SlackConnectionPerson.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/slackConnections/types/index.d.ts

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

package/dist/cjs/api/resources/slackConnections/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SlackConnection.js"), exports);
+__exportStar(require("./SlackConnectionAccount.js"), exports);
+__exportStar(require("./SlackConnectionPage.js"), exports);
+__exportStar(require("./SlackConnectionPerson.js"), exports);

package/dist/cjs/api/resources/steps/client/Client.d.ts

@@ -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/cjs/api/resources/steps/client/Client.js

@@ -232,10 +232,14 @@ 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
@@ -779,12 +783,14 @@ 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
@@ -798,7 +804,7 @@ 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));
@@ -899,7 +905,7 @@ 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,
@@ -911,6 +917,7 @@ class StepsClient {
                     : undefined,
                 reviewerUserId,
                 q,
+                period,
                 year,
                 quarter,
                 limit,

package/dist/cjs/api/resources/steps/client/requests/ListReviewsRequest.d.ts

@@ -12,7 +12,18 @@ export interface ListReviewsRequest {
     reviewerUserId?: string;
     /** Search steps by their own name and their launch's name. Every word must appear in one of those fields; case and accents are ignored; at most 100 characters and 8 words. See Searching under Errors and pagination. */
     q?: string;
-    /** A fiscal year, as the workspace's fiscal year start names it. Narrows by due date; left out, every year. */
+    /**
+     * A fiscal period, as the app's period picker and its URL name them:
+     * a quarter (`2026-Q4`), a whole year (`2027`), `upcoming` for this
+     * quarter and every one after it, or `all`. Repeat it for several
+     * (`period=2026-Q4&period=2027-Q1`); `upcoming` or `all` among them
+     * wins over the rest. Narrows by due date in the workspace's fiscal
+     * years. With `upcoming` it keeps those with no date yet, as the
+     * app's lists do. Left out, with no `year`, every period. Wins over
+     * `year` and `quarter`; anything else is a `422 validation_error`.
+     */
+    period?: string | string[];
+    /** One fiscal year, as the workspace's fiscal year start names it. Narrows by due date; left out, every year. `period` takes several. */
     year?: number;
     /** A fiscal quarter, 1 to 4, of `year`. Needs `year`; left out, the whole year. */
     quarter?: number;

package/dist/cjs/api/resources/steps/types/NudgeReason.d.ts

@@ -0,0 +1,10 @@
+/** Why a nudge was not sent. */
+export declare const NudgeReason: {
+    /**
+     * The reviewer was nudged on this step within the hour. */
+    readonly Throttled: "throttled";
+    /**
+     * The launch is a draft, so its reviewers hear nothing until it is published. */
+    readonly Draft: "draft";
+};
+export type NudgeReason = (typeof NudgeReason)[keyof typeof NudgeReason];