@taktoria/sdk 0.1.0 → 0.1.3

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

@@ -36,7 +36,7 @@ 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.steps = exports.search = exports.process = exports.posts = exports.platform = exports.partnerDomains = exports.organization = exports.okr = exports.memegen = exports.mcpConnections = exports.links = exports.launchOverview = exports.launches = exports.launchAnalytics = exports.insights = exports.holidays = exports.golinks = exports.dory = exports.domains = exports.commons = exports.billing = exports.auditLogs = exports.artifacts = exports.appDomains = void 0;
+exports.steps = exports.slackConnections = exports.search = exports.process = exports.posts = exports.platform = exports.partnerDomains = exports.organization = exports.okr = exports.memegen = exports.mcpConnections = exports.links = exports.launchOverview = exports.launches = exports.launchAnalytics = exports.insights = exports.holidays = exports.golinks = exports.dory = exports.domains = exports.commons = exports.billing = exports.auditLogs = exports.artifacts = exports.appDomains = void 0;
 exports.appDomains = __importStar(require("./appDomains/index.js"));
 __exportStar(require("./appDomains/types/index.js"), exports);
 __exportStar(require("./artifacts/client/requests/index.js"), exports);
@@ -100,6 +100,9 @@ __exportStar(require("./process/types/index.js"), exports);
 __exportStar(require("./search/client/requests/index.js"), exports);
 exports.search = __importStar(require("./search/index.js"));
 __exportStar(require("./search/types/index.js"), exports);
+__exportStar(require("./slackConnections/client/requests/index.js"), exports);
+exports.slackConnections = __importStar(require("./slackConnections/index.js"));
+__exportStar(require("./slackConnections/types/index.js"), exports);
 __exportStar(require("./steps/client/requests/index.js"), exports);
 exports.steps = __importStar(require("./steps/index.js"));
 __exportStar(require("./steps/types/index.js"), exports);

package/dist/cjs/api/resources/insights/client/Client.js

@@ -77,7 +77,7 @@ class InsightsClient {
     __listAll() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { sentiment, year, quarter, limit, cursor } = request;
+            const { sentiment, period, year, quarter, limit, cursor } = request;
             const _queryParams = {
                 sentiment: sentiment != null
                     ? serializers.Sentiment.jsonOrThrow(sentiment, {
@@ -85,6 +85,7 @@ class InsightsClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                period,
                 year,
                 quarter,
                 limit,
@@ -169,7 +170,7 @@ class InsightsClient {
             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, `launches/${core.url.encodePathParam(launchId)}/insights`),
+                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, `launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/insights`),
                 method: "GET",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
@@ -246,7 +247,7 @@ class InsightsClient {
             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, `launches/${core.url.encodePathParam(launchId)}/insights`),
+                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, `launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/insights`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",

package/dist/cjs/api/resources/insights/client/requests/ListInsightsRequest.d.ts

@@ -5,7 +5,18 @@ import type * as Taktoria from "../../../../index.js";
  */
 export interface ListInsightsRequest {
     sentiment?: Taktoria.Sentiment;
-    /** A fiscal year, as the workspace's fiscal year start names it. Narrows by when each was recorded; 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 when each was recorded in the
+     * workspace's fiscal years. 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 when each was recorded; 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/launches/client/Client.d.ts

@@ -13,8 +13,11 @@ export declare class LaunchesClient {
     /**
      * List the launches in your organization, or with `mine=true` your own,
      * the ones the app's My launches page counts as yours. Drafts included,
-     * by planned launch date. Every period unless `year` narrows it, where
-     * the app's lists open on this quarter and later. Needs `launches:read`.
+     * by planned launch date. Every period unless `period` (or `year`)
+     * narrows it, where the app's lists open on this quarter and later:
+     * `period=upcoming` lists what they do. With `launched=true` it is the
+     * Launched page instead: launches that have launched, newest first,
+     * with the periods going by when each launched. Needs `launches:read`.
      *
      * @param {Taktoria.ListLaunchesRequest} request
      * @param {LaunchesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -38,7 +41,8 @@ export declare class LaunchesClient {
      * Add a launch. With a `plannedLaunchDate` it gets its launch template's
      * steps at once, which is what fills each reviewer's queue; pass
      * `generateSteps: false` to leave them off. Pass `draft: true` to save it
-     * without telling anybody.
+     * without telling anybody. A draft with `status: LAUNCHED` is
+     * `409 draft`: publish it, then launch it.
      *
      * @param {Taktoria.CreateLaunchRequest} request
      * @param {LaunchesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -46,6 +50,7 @@ export declare class LaunchesClient {
      * @throws {@link Taktoria.UnauthorizedError}
      * @throws {@link Taktoria.SubscriptionRequiredError}
      * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.ConflictError}
      * @throws {@link Taktoria.ValidationError}
      * @throws {@link Taktoria.TooManyRequestsError}
      * @throws {@link errors.TaktoriaError}
@@ -77,7 +82,9 @@ export declare class LaunchesClient {
      * and from what, about ten minutes after the edits stop, in one message
      * that leaves out each owner's own edits (`launchUpdates` in their
      * notification preferences). Its artifacts and links count too; its
-     * steps do not, and nothing is sent about a draft.
+     * steps do not, and nothing is sent about a draft. `409 launched` when
+     * `draft: true` would take a launched launch back to being a draft, and
+     * `409 draft` when the change would leave a draft `LAUNCHED`.
      *
      * @param {string} launchId
      * @param {Taktoria.UpdateLaunchRequest} request
@@ -86,6 +93,7 @@ export declare class LaunchesClient {
      * @throws {@link Taktoria.BadRequestError}
      * @throws {@link Taktoria.ForbiddenError}
      * @throws {@link Taktoria.NotFoundError}
+     * @throws {@link Taktoria.ConflictError}
      * @throws {@link Taktoria.ValidationError}
      * @throws {@link Taktoria.TooManyRequestsError}
      * @throws {@link errors.TaktoriaError}
@@ -142,9 +150,15 @@ export declare class LaunchesClient {
      * sites, in the GitHub organization the app is installed on, or in its
      * Asana or ClickUp workspaces), and syncs at once: the answer's
      * `ticketingProject` says how that went. Any other address, a whole
-     * Jira project or a GitHub repository included, is kept as a link and
-     * does not sync. It reads the system, so it shares the `ticketing-sync`
-     * budget with a sync. Needs `launches:write`.
+     * Jira project, a GitHub repository, or a ClickUp folder or space
+     * included, is kept as a link and does not sync. It reads the system,
+     * so it shares the `ticketing-sync` budget with a sync. `404 not_found`
+     * when the connection cannot find or see the project, `409 conflict`
+     * for one in another workspace or site of the system than the one
+     * connected, `409 ticketing_reconnect` when the system turned the
+     * connection down (a workspace admin connects it again in Settings →
+     * Integrations), and `502 upstream_error` when it did not answer.
+     * Needs `launches:write`.
      *
      * @param {string} launchId
      * @param {Taktoria.LinkTicketingProjectRequest} request
@@ -187,10 +201,12 @@ export declare class LaunchesClient {
     private __unlinkTicketingProject;
     /**
      * Sync now, as the daily sync does, for this launch: its status,
-     * progress, and new status updates (Linear, GitHub projects, Asana) or
-     * comments (Jira, ClickUp). `404 not_found` when the launch follows
-     * nothing; `409 conflict` for a link that cannot sync (a whole Jira
-     * project, a GitHub repository, or a system Taktoria does not sync);
+     * progress, and new status updates (Linear, GitHub projects) or
+     * comments (Jira, ClickUp); an Asana project brings its completion and
+     * progress, not its status updates. `404 not_found` when the launch
+     * follows nothing; `409 conflict` for a link that cannot sync (a whole
+     * Jira project, a GitHub repository, a ClickUp folder or space, or a
+     * system Taktoria does not sync);
      * `409 ticketing_not_connected` or `409 ticketing_reconnect` when a
      * workspace admin must connect its system in Settings → Integrations.
      * Needs `launches:write`.
@@ -216,8 +232,8 @@ export declare class LaunchesClient {
      * What has happened to a launch, newest first, as its activity feed
      * shows it: added, changed, published, taken back to draft, launched,
      * its steps decided and reasons given for them, comments and updates
-     * posted, and its ticketing project linked, unlinked and synced. Each
-     * entry says it in a sentence. The comments and updates
+     * posted, its ticketing project linked, unlinked and synced, and its
+     * artifacts exported to a docs tool. Each entry says it in a sentence. The comments and updates
      * themselves are at `/launches/{launchId}/posts`. Needs `launches:read`.
      *
      * @param {string} launchId

package/dist/cjs/api/resources/launches/client/Client.js

@@ -60,8 +60,11 @@ class LaunchesClient {
     /**
      * List the launches in your organization, or with `mine=true` your own,
      * the ones the app's My launches page counts as yours. Drafts included,
-     * by planned launch date. Every period unless `year` narrows it, where
-     * the app's lists open on this quarter and later. Needs `launches:read`.
+     * by planned launch date. Every period unless `period` (or `year`)
+     * narrows it, where the app's lists open on this quarter and later:
+     * `period=upcoming` lists what they do. With `launched=true` it is the
+     * Launched page instead: launches that have launched, newest first,
+     * with the periods going by when each launched. Needs `launches:read`.
      *
      * @param {Taktoria.ListLaunchesRequest} request
      * @param {LaunchesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -85,7 +88,7 @@ class LaunchesClient {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { status, ownerUserId, pmUserId, orgTeamId, q, search, launchTemplateId, draft, health, year, quarter, mine, includeTeams, limit, cursor, } = request;
+            const { status, ownerUserId, pmUserId, orgTeamId, q, search, launchTemplateId, draft, health, period, year, quarter, mine, includeTeams, launched, limit, cursor, } = request;
             const _queryParams = {
                 status: status != null
                     ? serializers.LaunchStatus.jsonOrThrow(status, {
@@ -101,10 +104,12 @@ class LaunchesClient {
                 launchTemplateId,
                 draft,
                 health,
+                period,
                 year,
                 quarter,
                 mine,
                 includeTeams,
+                launched,
                 limit,
                 cursor,
             };
@@ -194,7 +199,8 @@ class LaunchesClient {
      * Add a launch. With a `plannedLaunchDate` it gets its launch template's
      * steps at once, which is what fills each reviewer's queue; pass
      * `generateSteps: false` to leave them off. Pass `draft: true` to save it
-     * without telling anybody.
+     * without telling anybody. A draft with `status: LAUNCHED` is
+     * `409 draft`: publish it, then launch it.
      *
      * @param {Taktoria.CreateLaunchRequest} request
      * @param {LaunchesClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -202,6 +208,7 @@ class LaunchesClient {
      * @throws {@link Taktoria.UnauthorizedError}
      * @throws {@link Taktoria.SubscriptionRequiredError}
      * @throws {@link Taktoria.ForbiddenError}
+     * @throws {@link Taktoria.ConflictError}
      * @throws {@link Taktoria.ValidationError}
      * @throws {@link Taktoria.TooManyRequestsError}
      * @throws {@link errors.TaktoriaError}
@@ -275,6 +282,14 @@ class LaunchesClient {
                             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",
@@ -323,7 +338,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}`),
                 method: "GET",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
@@ -379,7 +394,9 @@ class LaunchesClient {
      * and from what, about ten minutes after the edits stop, in one message
      * that leaves out each owner's own edits (`launchUpdates` in their
      * notification preferences). Its artifacts and links count too; its
-     * steps do not, and nothing is sent about a draft.
+     * steps do not, and nothing is sent about a draft. `409 launched` when
+     * `draft: true` would take a launched launch back to being a draft, and
+     * `409 draft` when the change would leave a draft `LAUNCHED`.
      *
      * @param {string} launchId
      * @param {Taktoria.UpdateLaunchRequest} request
@@ -388,6 +405,7 @@ class LaunchesClient {
      * @throws {@link Taktoria.BadRequestError}
      * @throws {@link Taktoria.ForbiddenError}
      * @throws {@link Taktoria.NotFoundError}
+     * @throws {@link Taktoria.ConflictError}
      * @throws {@link Taktoria.ValidationError}
      * @throws {@link Taktoria.TooManyRequestsError}
      * @throws {@link errors.TaktoriaError}
@@ -405,7 +423,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}`),
                 method: "PATCH",
                 headers: _headers,
                 contentType: "application/json",
@@ -459,6 +477,14 @@ class LaunchesClient {
                             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",
@@ -508,7 +534,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
@@ -586,7 +612,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/launch`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/launch`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -669,9 +695,15 @@ class LaunchesClient {
      * sites, in the GitHub organization the app is installed on, or in its
      * Asana or ClickUp workspaces), and syncs at once: the answer's
      * `ticketingProject` says how that went. Any other address, a whole
-     * Jira project or a GitHub repository included, is kept as a link and
-     * does not sync. It reads the system, so it shares the `ticketing-sync`
-     * budget with a sync. Needs `launches:write`.
+     * Jira project, a GitHub repository, or a ClickUp folder or space
+     * included, is kept as a link and does not sync. It reads the system,
+     * so it shares the `ticketing-sync` budget with a sync. `404 not_found`
+     * when the connection cannot find or see the project, `409 conflict`
+     * for one in another workspace or site of the system than the one
+     * connected, `409 ticketing_reconnect` when the system turned the
+     * connection down (a workspace admin connects it again in Settings →
+     * Integrations), and `502 upstream_error` when it did not answer.
+     * Needs `launches:write`.
      *
      * @param {string} launchId
      * @param {Taktoria.LinkTicketingProjectRequest} request
@@ -701,7 +733,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/ticketing-project`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/ticketing-project`),
                 method: "PUT",
                 headers: _headers,
                 contentType: "application/json",
@@ -815,7 +847,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/ticketing-project`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/ticketing-project`),
                 method: "DELETE",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
@@ -867,10 +899,12 @@ class LaunchesClient {
     }
     /**
      * Sync now, as the daily sync does, for this launch: its status,
-     * progress, and new status updates (Linear, GitHub projects, Asana) or
-     * comments (Jira, ClickUp). `404 not_found` when the launch follows
-     * nothing; `409 conflict` for a link that cannot sync (a whole Jira
-     * project, a GitHub repository, or a system Taktoria does not sync);
+     * progress, and new status updates (Linear, GitHub projects) or
+     * comments (Jira, ClickUp); an Asana project brings its completion and
+     * progress, not its status updates. `404 not_found` when the launch
+     * follows nothing; `409 conflict` for a link that cannot sync (a whole
+     * Jira project, a GitHub repository, a ClickUp folder or space, or a
+     * system Taktoria does not sync);
      * `409 ticketing_not_connected` or `409 ticketing_reconnect` when a
      * workspace admin must connect its system in Settings → Integrations.
      * Needs `launches:write`.
@@ -899,7 +933,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/ticketing-project/sync`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/ticketing-project/sync`),
                 method: "POST",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
@@ -978,8 +1012,8 @@ class LaunchesClient {
      * What has happened to a launch, newest first, as its activity feed
      * shows it: added, changed, published, taken back to draft, launched,
      * its steps decided and reasons given for them, comments and updates
-     * posted, and its ticketing project linked, unlinked and synced. Each
-     * entry says it in a sentence. The comments and updates
+     * posted, its ticketing project linked, unlinked and synced, and its
+     * artifacts exported to a docs tool. Each entry says it in a sentence. The comments and updates
      * themselves are at `/launches/{launchId}/posts`. Needs `launches:read`.
      *
      * @param {string} launchId
@@ -1008,7 +1042,7 @@ class LaunchesClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/activity`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/activity`),
                 method: "GET",
                 headers: _headers,
                 queryString: core.url

package/dist/cjs/api/resources/launches/client/requests/ListLaunchesRequest.d.ts

@@ -23,7 +23,20 @@ export interface ListLaunchesRequest {
     draft?: boolean;
     /** `ON_TRACK`, `AT_RISK` or `OFF_TRACK`, as the newest update says (never a launched launch), or `NONE` for launches with no health to show. */
     health?: string;
-    /** A fiscal year, as the workspace's fiscal year start names it. Narrows by planned launch 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 planned launch date in the
+     * workspace's fiscal years, `upcoming` keeping launches with no
+     * date yet, as the app's lists do; with `launched=true`, by when
+     * each launched. 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 planned launch date (actual with `launched=true`); 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;
@@ -40,6 +53,17 @@ export interface ListLaunchesRequest {
     mine?: boolean;
     /** With `mine=true`, `false` leaves out launches that are yours only through a team. Left out, `true`. */
     includeTeams?: boolean;
+    /**
+     * `true` lists what the Launched page does: only launches that
+     * have launched (`status` `LAUNCHED`), newest first by
+     * `actualLaunchDate`, with `period`, `year` and `quarter` going
+     * by when each launched rather than when it was planned. That is
+     * how the Overview counts `launchedThisQuarter`: a launch planned
+     * for last quarter that went out in this one is this quarter's.
+     * `launched=true&period=2026-Q4` is what shipped in that quarter.
+     * Left out, by planned launch date.
+     */
+    launched?: boolean;
     limit?: number;
     cursor?: string;
 }

package/dist/cjs/api/resources/launches/types/LaunchActivityVerb.d.ts

@@ -38,5 +38,8 @@ export declare const LaunchActivityVerb: {
      * project done and flagged it ready to launch. Nobody did it, so
      * `actor` is null. */
     readonly Synced: "synced";
+    /**
+     * One of its artifacts was exported to a docs tool (Notion, Confluence or Google Docs). */
+    readonly Exported: "exported";
 };
 export type LaunchActivityVerb = (typeof LaunchActivityVerb)[keyof typeof LaunchActivityVerb];

package/dist/cjs/api/resources/launches/types/LaunchActivityVerb.js

@@ -42,4 +42,7 @@ exports.LaunchActivityVerb = {
      * project done and flagged it ready to launch. Nobody did it, so
      * `actor` is null. */
     Synced: "synced",
+    /**
+     * One of its artifacts was exported to a docs tool (Notion, Confluence or Google Docs). */
+    Exported: "exported",
 };

package/dist/cjs/api/resources/launches/types/LinkTicketingProjectRequest.d.ts

@@ -8,8 +8,8 @@ export interface LinkTicketingProjectRequest {
      * milestone (`https://github.com/acme/web/milestone/3`), an Asana
      * project (`https://app.asana.com/1/<workspace>/project/<project>`),
      * or a ClickUp list (`https://app.clickup.com/<workspace>/v/li/<list>`)
-     * or task (`https://app.clickup.com/t/<task>`). Anything else is kept
-     * as a link.
+     * or task (`https://app.clickup.com/t/<task>`). Anything else, a
+     * ClickUp folder or space included, is kept as a link.
      */
     url: string;
 }

package/dist/cjs/api/resources/launches/types/SyncTicketingProjectResponse.d.ts

@@ -2,7 +2,7 @@ import type * as Taktoria from "../../../index.js";
 export interface SyncTicketingProjectResponse {
     /** Whether the project's status moved the launch's. */
     statusChanged: boolean;
-    /** How many of the project's status updates (Linear, GitHub projects, Asana) or comments (Jira, ClickUp) became the launch's. */
+    /** How many of the project's status updates (Linear, GitHub projects) or comments (Jira, ClickUp) became the launch's. Always 0 for an Asana project, whose status updates Taktoria's connection cannot read. */
     updatesAdded: number;
     /** Whether this sync found the project newly done, flagging the launch ready to launch. */
     completed: boolean;

package/dist/cjs/api/resources/launches/types/TicketingProject.d.ts

@@ -6,11 +6,17 @@ import type * as Taktoria from "../../../index.js";
  * milestone; an Asana project; or a ClickUp list or task. Once its system
  * is connected to the workspace (Settings → Integrations), each day, and
  * on a sync, its status moves the launch's; the status updates of a
- * Linear, GitHub or Asana project become the launch's updates, and the
- * comments on a Jira issue or a ClickUp list or task its comments
- * (`source` on a LaunchPost; a Jira comment restricted to some people is
- * never brought in). Marked done, it flags the launch ready to launch; it
- * never launches it.
+ * Linear or GitHub project become the launch's updates, and the comments
+ * on a Jira issue or a ClickUp list or task its comments (`source` on a
+ * LaunchPost; a Jira comment restricted to some people is never brought
+ * in). An Asana project's status updates need a permission Asana's OAuth
+ * does not offer Taktoria's read-only connection, so none come in. It is
+ * followed by its tasks instead: its status kind is `PLANNED` until one
+ * is done, then `STARTED`, and `COMPLETED` once the project is marked
+ * complete, and its progress is the share of them done. A whole Jira
+ * project, a GitHub repository, and a ClickUp folder or space are kept
+ * as links. Marked done, it flags the launch ready to launch; it never
+ * launches it.
  */
 export interface TicketingProject {
     /** Null for a system Taktoria has no connector for. Such a link is kept as a link and never synced. */
@@ -37,8 +43,8 @@ export interface TicketingProject {
      * to the workspace), `notFound`, `unauthorized` (a workspace admin must
      * connect the system again), `unavailable` or `unsupported` (a system
      * Taktoria cannot sync, or a link to something it cannot follow, such
-     * as a whole Jira project or a GitHub repository). Null when it
-     * worked.
+     * as a whole Jira project, a GitHub repository, or a ClickUp folder
+     * or space). Null when it worked.
      */
     syncError?: string;
 }

package/dist/cjs/api/resources/links/client/Client.js

@@ -80,7 +80,7 @@ class LinksClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/links`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/links`),
                 method: "GET",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
@@ -161,7 +161,7 @@ class LinksClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/links`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/links`),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -259,7 +259,7 @@ class LinksClient {
             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, `/launches/${core.url.encodePathParam(launchId)}/links/${core.url.encodePathParam(linkId)}`),
+                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, `/launches/${core.url.encodePathParam(launchId, errors.TaktoriaError)}/links/${core.url.encodePathParam(linkId, errors.TaktoriaError)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),

package/dist/cjs/api/resources/mcpConnections/client/Client.js

@@ -183,7 +183,7 @@ class McpConnectionsClient {
             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, `/mcp-connections/${core.url.encodePathParam(connectionId)}`),
+                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, `/mcp-connections/${core.url.encodePathParam(connectionId, errors.TaktoriaError)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),