@tappify/extension-sdk 2.1.0-beta.2 → 2.1.0-beta.4

package/dist/{work-events-BlOVpK0k.d.ts → work-events-BYU25wmX.d.ts}

@@ -1,11 +1,30 @@
 import { JSONWebKeySet } from 'jose';
-import { K as TapPlatformFilter, a as TapFilters, w as TapCredentialValues, $ as TapSettingsValues, ab as ToolId, ac as ToolInput, A as ActionId, k as ActionInput, f as TapProcedureName, g as TapProcedureInput, h as TapProcedureOutput, c as TapHostEvents } from './types-uGHrRaOj.js';
-import { a9 as WorkContribution } from './constants-Bh759FUI.js';
+import { K as TapPlatformFilter, a as TapFilters, w as TapCredentialValues, $ as TapSettingsValues, ab as ToolId, ac as ToolInput, A as ActionId, k as ActionInput, f as TapProcedureName, g as TapProcedureInput, h as TapProcedureOutput, c as TapHostEvents } from './types-DBpDxGlT.js';
+import { a9 as WorkContribution } from './constants-CvHbO3ia.js';
 
 /** The provider stage used by the manifest's legacy status mapping. */
 type WorkStage = keyof NonNullable<NonNullable<WorkContribution['status']>['map']>;
 /** JSON-safe values supplied for provider create fields. */
 type WorkCreateFieldValues = Record<string, string | number | boolean | string[] | null>;
+/** A person in the sending system; email is optional when unavailable. */
+interface WorkPerson {
+    id: string;
+    displayName: string;
+    email?: string;
+}
+/** A structured person mention supplied with a Review comment. */
+interface WorkMention {
+    person: WorkPerson;
+}
+/** Ordered provider comment content, including portable person mentions. */
+type WorkRichTextSegment = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'user_mention';
+    person: WorkPerson;
+    fallback: string;
+};
 /** Logical mutation identity, stable across transport retries. */
 interface WorkMutationInput {
     idempotencyKey: string;
@@ -122,6 +141,9 @@ interface ReviewThreadSource {
     firstComment: {
         id: string;
         body: string;
+        author: WorkPerson;
+        mentions: WorkMention[];
+        /** @deprecated Use author.displayName instead. */
         authorDisplayName: string;
         createdAt: string;
     };
@@ -164,6 +186,9 @@ interface WorkAttachResult {
 interface WorkCommentInput extends WorkMutationInput, WorkLinkedItemInput {
     commentId: string;
     body: string;
+    author: WorkPerson;
+    mentions: WorkMention[];
+    /** @deprecated Use author.displayName instead. */
     authorDisplayName: string;
     createdAt: string;
 }
@@ -198,13 +223,20 @@ interface WorkHydratedCommentCreatedEvent extends WorkHydratedEventBase {
     type: 'comment.created';
     comment: {
         externalCommentId: string;
+        /** Compatibility text; segment concatenation is authoritative when present. */
         body: string;
-        author: {
-            id: string;
-            displayName: string;
-        };
         createdAt: string;
-    };
+    } & ({
+        author: WorkPerson;
+        /** Concatenate text and mention fallback values in order. */
+        segments: WorkRichTextSegment[];
+    } | {
+        /** Legacy authors cannot carry rich person data without segments. */
+        author: WorkPerson & {
+            email?: never;
+        };
+        segments?: never;
+    });
 }
 /** A complete provider status-change signal. */
 interface WorkHydratedStatusChangedEvent extends WorkHydratedEventBase {
@@ -544,4 +576,4 @@ interface SendWorkEventOptions {
  */
 declare function sendWorkEvent(event: WorkEvent, options: SendWorkEventOptions): Promise<void>;
 
-export { type WorkSetStatusResult as $, type WorkDisconnectResult as A, type WorkEvent as B, type ContextBlock as C, type WorkHydrateEventInput as D, type WorkHydrateEventResult as E, type WorkHydratedCommentCreatedEvent as F, type WorkHydratedEvent as G, type WorkHydratedEventBase as H, type WorkHydratedItemDeletedEvent as I, type WorkHydratedStatusChangedEvent as J, type WorkHydrationReferenceEvent as K, type LegacyWorkHandlers as L, type MentionItems as M, type WorkItemLinkResult as N, type WorkItemType as O, type WorkLinkedItemInput as P, type WorkListContainersInput as Q, type ReviewAttachmentDescriptor as R, type SendWorkEventOptions as S, type TappifyFetchHandler as T, type WorkListContainersResult as U, type VerifyTokenOptions as V, type WorkAttachInput as W, type WorkMutationInput as X, type WorkOperation as Y, type WorkOperationMap as Z, type WorkSetStatusInput as _, type TappifyClaims as a, type WorkStage as a0, type WorkStatus as a1, createTappifyHandler as a2, sendWorkEvent as a3, type MetricsInput as b, type MetricsResponse as c, type MetricsSeries as d, type ReviewImageAttachmentDescriptor as e, type ReviewLinkAttachmentDescriptor as f, type ReviewThreadSource as g, type TappifyCallContext as h, type TappifyDocuments as i, type TappifyHandlerOptions as j, type TappifyHealth as k, type TappifyInstall as l, type TappifyRequest as m, type TappifyRouteHandler as n, type WorkAttachResult as o, type WorkCommentInput as p, type WorkCommentResult as q, type WorkConfigureInput as r, type WorkConfigureResult as s, type WorkContainer as t, type WorkCreateField as u, type WorkCreateFieldValues as v, type WorkCreateInput as w, type WorkDescribeContainerInput as x, type WorkDescribeContainerResult as y, type WorkDisconnectInput as z };
+export { type WorkPerson as $, type WorkDisconnectResult as A, type WorkEvent as B, type ContextBlock as C, type WorkHydrateEventInput as D, type WorkHydrateEventResult as E, type WorkHydratedCommentCreatedEvent as F, type WorkHydratedEvent as G, type WorkHydratedEventBase as H, type WorkHydratedItemDeletedEvent as I, type WorkHydratedStatusChangedEvent as J, type WorkHydrationReferenceEvent as K, type LegacyWorkHandlers as L, type MentionItems as M, type WorkItemLinkResult as N, type WorkItemType as O, type WorkLinkedItemInput as P, type WorkListContainersInput as Q, type ReviewAttachmentDescriptor as R, type SendWorkEventOptions as S, type TappifyFetchHandler as T, type WorkListContainersResult as U, type VerifyTokenOptions as V, type WorkAttachInput as W, type WorkMention as X, type WorkMutationInput as Y, type WorkOperation as Z, type WorkOperationMap as _, type TappifyClaims as a, type WorkRichTextSegment as a0, type WorkSetStatusInput as a1, type WorkSetStatusResult as a2, type WorkStage as a3, type WorkStatus as a4, createTappifyHandler as a5, sendWorkEvent as a6, type MetricsInput as b, type MetricsResponse as c, type MetricsSeries as d, type ReviewImageAttachmentDescriptor as e, type ReviewLinkAttachmentDescriptor as f, type ReviewThreadSource as g, type TappifyCallContext as h, type TappifyDocuments as i, type TappifyHandlerOptions as j, type TappifyHealth as k, type TappifyInstall as l, type TappifyRequest as m, type TappifyRouteHandler as n, type WorkAttachResult as o, type WorkCommentInput as p, type WorkCommentResult as q, type WorkConfigureInput as r, type WorkConfigureResult as s, type WorkContainer as t, type WorkCreateField as u, type WorkCreateFieldValues as v, type WorkCreateInput as w, type WorkDescribeContainerInput as x, type WorkDescribeContainerResult as y, type WorkDisconnectInput as z };

package/dist/{work-events-D97EoqvS.d.cts → work-events-CxFu-YZE.d.cts}

@@ -1,11 +1,30 @@
 import { JSONWebKeySet } from 'jose';
-import { K as TapPlatformFilter, a as TapFilters, w as TapCredentialValues, $ as TapSettingsValues, ab as ToolId, ac as ToolInput, A as ActionId, k as ActionInput, f as TapProcedureName, g as TapProcedureInput, h as TapProcedureOutput, c as TapHostEvents } from './types-BdDaLnqs.cjs';
-import { a9 as WorkContribution } from './constants-Bh759FUI.cjs';
+import { K as TapPlatformFilter, a as TapFilters, w as TapCredentialValues, $ as TapSettingsValues, ab as ToolId, ac as ToolInput, A as ActionId, k as ActionInput, f as TapProcedureName, g as TapProcedureInput, h as TapProcedureOutput, c as TapHostEvents } from './types-C5k8VwaA.cjs';
+import { a9 as WorkContribution } from './constants-CvHbO3ia.cjs';
 
 /** The provider stage used by the manifest's legacy status mapping. */
 type WorkStage = keyof NonNullable<NonNullable<WorkContribution['status']>['map']>;
 /** JSON-safe values supplied for provider create fields. */
 type WorkCreateFieldValues = Record<string, string | number | boolean | string[] | null>;
+/** A person in the sending system; email is optional when unavailable. */
+interface WorkPerson {
+    id: string;
+    displayName: string;
+    email?: string;
+}
+/** A structured person mention supplied with a Review comment. */
+interface WorkMention {
+    person: WorkPerson;
+}
+/** Ordered provider comment content, including portable person mentions. */
+type WorkRichTextSegment = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'user_mention';
+    person: WorkPerson;
+    fallback: string;
+};
 /** Logical mutation identity, stable across transport retries. */
 interface WorkMutationInput {
     idempotencyKey: string;
@@ -122,6 +141,9 @@ interface ReviewThreadSource {
     firstComment: {
         id: string;
         body: string;
+        author: WorkPerson;
+        mentions: WorkMention[];
+        /** @deprecated Use author.displayName instead. */
         authorDisplayName: string;
         createdAt: string;
     };
@@ -164,6 +186,9 @@ interface WorkAttachResult {
 interface WorkCommentInput extends WorkMutationInput, WorkLinkedItemInput {
     commentId: string;
     body: string;
+    author: WorkPerson;
+    mentions: WorkMention[];
+    /** @deprecated Use author.displayName instead. */
     authorDisplayName: string;
     createdAt: string;
 }
@@ -198,13 +223,20 @@ interface WorkHydratedCommentCreatedEvent extends WorkHydratedEventBase {
     type: 'comment.created';
     comment: {
         externalCommentId: string;
+        /** Compatibility text; segment concatenation is authoritative when present. */
         body: string;
-        author: {
-            id: string;
-            displayName: string;
-        };
         createdAt: string;
-    };
+    } & ({
+        author: WorkPerson;
+        /** Concatenate text and mention fallback values in order. */
+        segments: WorkRichTextSegment[];
+    } | {
+        /** Legacy authors cannot carry rich person data without segments. */
+        author: WorkPerson & {
+            email?: never;
+        };
+        segments?: never;
+    });
 }
 /** A complete provider status-change signal. */
 interface WorkHydratedStatusChangedEvent extends WorkHydratedEventBase {
@@ -544,4 +576,4 @@ interface SendWorkEventOptions {
  */
 declare function sendWorkEvent(event: WorkEvent, options: SendWorkEventOptions): Promise<void>;
 
-export { type WorkSetStatusResult as $, type WorkDisconnectResult as A, type WorkEvent as B, type ContextBlock as C, type WorkHydrateEventInput as D, type WorkHydrateEventResult as E, type WorkHydratedCommentCreatedEvent as F, type WorkHydratedEvent as G, type WorkHydratedEventBase as H, type WorkHydratedItemDeletedEvent as I, type WorkHydratedStatusChangedEvent as J, type WorkHydrationReferenceEvent as K, type LegacyWorkHandlers as L, type MentionItems as M, type WorkItemLinkResult as N, type WorkItemType as O, type WorkLinkedItemInput as P, type WorkListContainersInput as Q, type ReviewAttachmentDescriptor as R, type SendWorkEventOptions as S, type TappifyFetchHandler as T, type WorkListContainersResult as U, type VerifyTokenOptions as V, type WorkAttachInput as W, type WorkMutationInput as X, type WorkOperation as Y, type WorkOperationMap as Z, type WorkSetStatusInput as _, type TappifyClaims as a, type WorkStage as a0, type WorkStatus as a1, createTappifyHandler as a2, sendWorkEvent as a3, type MetricsInput as b, type MetricsResponse as c, type MetricsSeries as d, type ReviewImageAttachmentDescriptor as e, type ReviewLinkAttachmentDescriptor as f, type ReviewThreadSource as g, type TappifyCallContext as h, type TappifyDocuments as i, type TappifyHandlerOptions as j, type TappifyHealth as k, type TappifyInstall as l, type TappifyRequest as m, type TappifyRouteHandler as n, type WorkAttachResult as o, type WorkCommentInput as p, type WorkCommentResult as q, type WorkConfigureInput as r, type WorkConfigureResult as s, type WorkContainer as t, type WorkCreateField as u, type WorkCreateFieldValues as v, type WorkCreateInput as w, type WorkDescribeContainerInput as x, type WorkDescribeContainerResult as y, type WorkDisconnectInput as z };
+export { type WorkPerson as $, type WorkDisconnectResult as A, type WorkEvent as B, type ContextBlock as C, type WorkHydrateEventInput as D, type WorkHydrateEventResult as E, type WorkHydratedCommentCreatedEvent as F, type WorkHydratedEvent as G, type WorkHydratedEventBase as H, type WorkHydratedItemDeletedEvent as I, type WorkHydratedStatusChangedEvent as J, type WorkHydrationReferenceEvent as K, type LegacyWorkHandlers as L, type MentionItems as M, type WorkItemLinkResult as N, type WorkItemType as O, type WorkLinkedItemInput as P, type WorkListContainersInput as Q, type ReviewAttachmentDescriptor as R, type SendWorkEventOptions as S, type TappifyFetchHandler as T, type WorkListContainersResult as U, type VerifyTokenOptions as V, type WorkAttachInput as W, type WorkMention as X, type WorkMutationInput as Y, type WorkOperation as Z, type WorkOperationMap as _, type TappifyClaims as a, type WorkRichTextSegment as a0, type WorkSetStatusInput as a1, type WorkSetStatusResult as a2, type WorkStage as a3, type WorkStatus as a4, createTappifyHandler as a5, sendWorkEvent as a6, type MetricsInput as b, type MetricsResponse as c, type MetricsSeries as d, type ReviewImageAttachmentDescriptor as e, type ReviewLinkAttachmentDescriptor as f, type ReviewThreadSource as g, type TappifyCallContext as h, type TappifyDocuments as i, type TappifyHandlerOptions as j, type TappifyHealth as k, type TappifyInstall as l, type TappifyRequest as m, type TappifyRouteHandler as n, type WorkAttachResult as o, type WorkCommentInput as p, type WorkCommentResult as q, type WorkConfigureInput as r, type WorkConfigureResult as s, type WorkContainer as t, type WorkCreateField as u, type WorkCreateFieldValues as v, type WorkCreateInput as w, type WorkDescribeContainerInput as x, type WorkDescribeContainerResult as y, type WorkDisconnectInput as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tappify/extension-sdk",
-  "version": "2.1.0-beta.2",
+  "version": "2.1.0-beta.4",
   "description": "Build extensions that run inside Tappify",
   "author": "Tappify Team",
   "license": "MIT",