@taktoria/sdk 0.1.0 → 0.1.2

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",
@@ -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}
@@ -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",
@@ -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
@@ -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`.
@@ -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

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/okr/client/Client.d.ts

@@ -238,6 +238,9 @@ export declare class OkrClient {
     private __deleteKeyResult;
     /**
      * The history behind a key result's current grade, most recent first.
+     * On a key result a connected metric drives (`metric` on the key
+     * result), the metric's own check-ins carry `metric`, and a person's
+     * stands only until the metric next moves.
      *
      * @param {string} keyResultId
      * @param {Taktoria.ListCheckInsRequest} request
@@ -271,6 +274,11 @@ export declare class OkrClient {
      * With `checkpoint`, it is also the key result's grade at that
      * scorecard checkpoint, as the dashboard's check-in form makes it.
      *
+     * On a key result a connected metric drives (`metric` on the key
+     * result), a check-in stands only until the metric next moves: the
+     * metric's next check-in is then the latest. A **Final** grade on the
+     * scorecard is the score whatever the metric does.
+     *
      * @param {string} keyResultId
      * @param {Taktoria.CreateCheckInRequest} request
      * @param {OkrClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -989,6 +989,9 @@ class OkrClient {
     }
     /**
      * The history behind a key result's current grade, most recent first.
+     * On a key result a connected metric drives (`metric` on the key
+     * result), the metric's own check-ins carry `metric`, and a person's
+     * stands only until the metric next moves.
      *
      * @param {string} keyResultId
      * @param {Taktoria.ListCheckInsRequest} request
@@ -1089,6 +1092,11 @@ class OkrClient {
      * With `checkpoint`, it is also the key result's grade at that
      * scorecard checkpoint, as the dashboard's check-in form makes it.
      *
+     * On a key result a connected metric drives (`metric` on the key
+     * result), a check-in stands only until the metric next moves: the
+     * metric's next check-in is then the latest. A **Final** grade on the
+     * scorecard is the score whatever the metric does.
+     *
      * @param {string} keyResultId
      * @param {Taktoria.CreateCheckInRequest} request
      * @param {OkrClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/okr/types/KeyResult.d.ts

@@ -35,6 +35,19 @@ export interface KeyResult {
     ownerUserIds: string[];
     /** Teams of the workspace that own it; their members count as owners. */
     ownerTeamIds: string[];
+    /**
+     * When it was last checked in on: its newest check-in's `recordedAt`,
+     * so a check-in recorded late counts at its date. Absent if it has
+     * never been checked in on. How long it has gone quiet.
+     */
+    lastCheckInAt?: Date;
+    /**
+     * The connected metric that drives its score, absent if none. Each
+     * number the metric hears becomes a check-in, and a person's own
+     * check-in stands only until the metric next moves. Sources are set
+     * up on the key result's page in the app, not through the API.
+     */
+    metric?: Taktoria.KeyResultMetric;
     createdAt: Date;
     updatedAt: Date;
 }

package/dist/cjs/api/resources/okr/types/KeyResultMetric.d.ts

@@ -0,0 +1,12 @@
+import type * as Taktoria from "../../../index.js";
+/**
+ * The metric a key result follows, as anybody who may see the key result
+ * sees it. Never its secret, token or address.
+ */
+export interface KeyResultMetric {
+    /** What the number is, as the history names it, such as "Weekly active teams". */
+    name: string;
+    kind: Taktoria.MetricSourceKind;
+    /** Paused, it records nothing until somebody resumes it. */
+    paused: boolean;
+}

package/dist/cjs/api/resources/okr/types/KeyResultMetric.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/okr/types/MetricSourceKind.d.ts

@@ -0,0 +1,10 @@
+/** How a metric hears its number. */
+export declare const MetricSourceKind: {
+    /**
+     * A system posts it to the metric's own address, with its secret. */
+    readonly Webhook: "WEBHOOK";
+    /**
+     * OKR Hub fetches it from an https address on a schedule. */
+    readonly Pull: "PULL";
+};
+export type MetricSourceKind = (typeof MetricSourceKind)[keyof typeof MetricSourceKind];

package/dist/cjs/api/resources/okr/types/MetricSourceKind.js

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricSourceKind = void 0;
+/** How a metric hears its number. */
+exports.MetricSourceKind = {
+    /**
+     * A system posts it to the metric's own address, with its secret. */
+    Webhook: "WEBHOOK",
+    /**
+     * OKR Hub fetches it from an https address on a schedule. */
+    Pull: "PULL",
+};

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

@@ -19,6 +19,8 @@ export * from "./KeyResultDetail.js";
 export * from "./KeyResultGrade.js";
 export * from "./KeyResultGradeList.js";
 export * from "./KeyResultList.js";
+export * from "./KeyResultMetric.js";
+export * from "./MetricSourceKind.js";
 export * from "./Objective.js";
 export * from "./ObjectiveDetail.js";
 export * from "./ObjectivePage.js";

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

@@ -35,6 +35,8 @@ __exportStar(require("./KeyResultDetail.js"), exports);
 __exportStar(require("./KeyResultGrade.js"), exports);
 __exportStar(require("./KeyResultGradeList.js"), exports);
 __exportStar(require("./KeyResultList.js"), exports);
+__exportStar(require("./KeyResultMetric.js"), exports);
+__exportStar(require("./MetricSourceKind.js"), exports);
 __exportStar(require("./Objective.js"), exports);
 __exportStar(require("./ObjectiveDetail.js"), exports);
 __exportStar(require("./ObjectivePage.js"), exports);

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

@@ -28,8 +28,11 @@ export declare class OrganizationClient {
     private __get;
     /**
      * Rename the workspace, move its slug, set its fiscal year, the years
-     * OKR Hub offers, the default time zone, LaunchCal's holiday markets or
-     * whether seats grow as people join (`autoGrowSeats`). Requires
+     * OKR Hub offers, the default time zone, LaunchCal's holiday markets,
+     * whether seats grow as people join (`autoGrowSeats`), whether
+     * LaunchCal's calendar feeds are allowed (`allowCalendarFeeds`) or
+     * whether Slack commands take Slack's word while Google is required
+     * (`slackCommandsWithoutGoogle`). Requires
      * `organization:write`, which a signed-in session never has: this takes
      * a key. Everything is checked before anything is written.
      *

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

@@ -141,8 +141,11 @@ class OrganizationClient {
     }
     /**
      * Rename the workspace, move its slug, set its fiscal year, the years
-     * OKR Hub offers, the default time zone, LaunchCal's holiday markets or
-     * whether seats grow as people join (`autoGrowSeats`). Requires
+     * OKR Hub offers, the default time zone, LaunchCal's holiday markets,
+     * whether seats grow as people join (`autoGrowSeats`), whether
+     * LaunchCal's calendar feeds are allowed (`allowCalendarFeeds`) or
+     * whether Slack commands take Slack's word while Google is required
+     * (`slackCommandsWithoutGoogle`). Requires
      * `organization:write`, which a signed-in session never has: this takes
      * a key. Everything is checked before anything is written.
      *

package/dist/cjs/api/resources/organization/types/Organization.d.ts

@@ -44,6 +44,17 @@ export interface Organization {
      * reads true.
      */
     requireGoogleSignIn: boolean;
+    /**
+     * **Allow Slack commands without Google sign-in**, under **Require
+     * sign-in with Google** in Settings → Workspace. Slack cannot sign in
+     * with Google, so while Google is required, Taktoria's Slack commands
+     * act only for somebody who has connected their Slack account by
+     * signing in with Google once (see `GET /slack-connections`). On,
+     * they take the address Slack has confirmed instead, as in a
+     * workspace that does not require Google. It means nothing while
+     * `requireGoogleSignIn` is false. Off by default.
+     */
+    slackCommandsWithoutGoogle: boolean;
     /** Whether Google sign-in is set up on this installation, so it can be required. */
     googleSignInAvailable: boolean;
     /**
@@ -57,4 +68,14 @@ export interface Organization {
      * `autoJoin` on. On by default.
      */
     autoGrowSeats: boolean;
+    /**
+     * **Allow calendar feeds**, in Settings → Workspace: whether members
+     * may subscribe to LaunchCal from Google Calendar, Outlook or Apple
+     * Calendar. A feed is a private address read with no sign-in, around
+     * **Require Google sign-in** and single sign-on, so a workspace that
+     * holds every way in to those turns it off: every feed then answers
+     * 404 and none can be made, until it is on again. On by default.
+     * Feeds themselves have no API: each address is a person's secret.
+     */
+    allowCalendarFeeds: boolean;
 }

package/dist/cjs/api/resources/organization/types/UpdateOrganizationRequest.d.ts

@@ -34,4 +34,19 @@ export interface UpdateOrganizationRequest {
      * Settings → Domains.
      */
     autoGrowSeats?: boolean;
+    /**
+     * Whether members may subscribe to LaunchCal from a calendar app.
+     * Turned off, every feed stops answering at once, and none is
+     * deleted: turned on again, they work as before. Each change is in
+     * the audit log, as it is from Settings → Workspace.
+     */
+    allowCalendarFeeds?: boolean;
+    /**
+     * Whether Taktoria's Slack commands take Slack's confirmed address
+     * while Google is required, rather than asking each person to connect
+     * with Google. Turned off, everybody who has not connected is asked
+     * to at their next command; connections already made keep working.
+     * Each change is in the audit log, as it is from Settings → Workspace.
+     */
+    slackCommandsWithoutGoogle?: boolean;
 }

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

@@ -29,8 +29,8 @@ export declare class PlatformClient {
     getNotificationPreferences(requestOptions?: PlatformClient.RequestOptions): core.HttpResponsePromise<Taktoria.NotificationPreferences>;
     private __getNotificationPreferences;
     /**
-     * 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/cjs/api/resources/platform/client/Client.js

@@ -142,8 +142,8 @@ 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/cjs/api/resources/platform/types/NotificationChannels.d.ts

@@ -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/cjs/api/resources/platform/types/UpdateNotificationChannels.d.ts

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

package/dist/cjs/api/resources/platform/types/UpdateNotificationPreferencesRequest.d.ts

@@ -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/cjs/api/resources/platform/types/WaitingForSeat.d.ts

@@ -4,8 +4,8 @@ import type * as Taktoria from "../../../index.js";
  * 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/cjs/api/resources/posts/client/Client.d.ts

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

@@ -252,8 +252,10 @@ 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
@@ -262,6 +264,7 @@ 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}
@@ -327,6 +330,14 @@ 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/cjs/api/resources/posts/types/LaunchPost.d.ts

@@ -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.
      */