@veltdev/sdk-dev 5.0.2-beta.68 → 5.0.2-beta.7

package/app/models/data/activity-resolver.data.model.d.ts

@@ -1,27 +0,0 @@
-import { BaseMetadata } from './base-metadata.data.model';
-import { ActivityChanges } from './activity.data.model';
-import { ResolverConfig, ResolverResponse } from './resolver.data.model';
-export interface PartialActivityRecord {
-    id: string;
-    metadata?: BaseMetadata;
-    changes?: ActivityChanges;
-    entityData?: unknown;
-    entityTargetData?: unknown;
-    displayMessageTemplateData?: Record<string, unknown>;
-    [key: string]: any;
-}
-export interface ActivityAnnotationDataProvider {
-    get?: (request: GetActivityResolverRequest) => Promise<ResolverResponse<Record<string, PartialActivityRecord>>>;
-    save?: (request: SaveActivityResolverRequest) => Promise<ResolverResponse<undefined>>;
-    config?: ResolverConfig;
-}
-export interface GetActivityResolverRequest {
-    activityIds?: string[];
-    documentIds?: string[];
-    organizationId?: string;
-}
-export interface SaveActivityResolverRequest {
-    activity: Record<string, PartialActivityRecord>;
-    event?: string;
-    metadata?: BaseMetadata;
-}

package/app/models/data/activity.data.model.d.ts

@@ -1,179 +0,0 @@
-import { Observable } from 'rxjs';
-import { BaseMetadata } from './base-metadata.data.model';
-import { User } from './user.data.model';
-/**
- * Feature types that can generate activities.
- */
-export type ActivityFeatureType = 'comment' | 'reaction' | 'recorder' | 'crdt' | 'custom';
-/**
- * Comment action type constants following the `entity_type.action` naming pattern.
- * Annotation-level actions use `comment_annotation.*`, comment-level use `comment.*`.
- */
-export declare const CommentActivityActionTypes: {
-    readonly ANNOTATION_ADD: "comment_annotation.add";
-    readonly ANNOTATION_DELETE: "comment_annotation.delete";
-    readonly COMMENT_ADD: "comment.add";
-    readonly COMMENT_UPDATE: "comment.update";
-    readonly COMMENT_DELETE: "comment.delete";
-    readonly STATUS_CHANGE: "comment_annotation.status_change";
-    readonly PRIORITY_CHANGE: "comment_annotation.priority_change";
-    readonly ASSIGN: "comment_annotation.assign";
-    readonly ACCESS_MODE_CHANGE: "comment_annotation.access_mode_change";
-    readonly CUSTOM_LIST_CHANGE: "comment_annotation.custom_list_change";
-    readonly APPROVE: "comment_annotation.approve";
-    readonly ACCEPT: "comment.accept";
-    readonly REJECT: "comment.reject";
-    readonly REACTION_ADD: "comment.reaction_add";
-    readonly REACTION_DELETE: "comment.reaction_delete";
-    readonly SUBSCRIBE: "comment_annotation.subscribe";
-    readonly UNSUBSCRIBE: "comment_annotation.unsubscribe";
-};
-export type CommentActivityActionType = typeof CommentActivityActionTypes[keyof typeof CommentActivityActionTypes];
-/**
- * Recorder action type constants following the `recording.*` naming pattern.
- */
-export declare const RecorderActivityActionTypes: {
-    readonly RECORDING_ADD: "recording.add";
-    readonly RECORDING_DELETE: "recording.delete";
-};
-export type RecorderActivityActionType = typeof RecorderActivityActionTypes[keyof typeof RecorderActivityActionTypes];
-/**
- * Reaction action type constants following the `reaction.*` naming pattern.
- */
-export declare const ReactionActivityActionTypes: {
-    readonly REACTION_ADD: "reaction.add";
-    readonly REACTION_DELETE: "reaction.delete";
-};
-export type ReactionActivityActionType = typeof ReactionActivityActionTypes[keyof typeof ReactionActivityActionTypes];
-/**
- * CRDT action type constants following the `crdt.*` naming pattern.
- */
-export declare const CrdtActivityActionTypes: {
-    readonly EDITOR_EDIT: "crdt.editor_edit";
-};
-export type CrdtActivityActionType = typeof CrdtActivityActionTypes[keyof typeof CrdtActivityActionTypes];
-/**
- * Represents a single from/to change pair.
- * `from` is always present (null for 'added' events) for uniform structure.
- */
-export interface ActivityChange<T = unknown> {
-    from?: T | null;
-    to?: T | null;
-}
-/**
- * Dynamic change tracking. Keys are domain-specific (e.g., 'status', 'commentText', 'assignedTo').
- * No fixed keys — activities span multiple features.
- */
-export interface ActivityChanges {
-    [key: string]: ActivityChange | undefined;
-}
-/**
- * Metadata for activity records. Extends BaseMetadata with denormalized IDs
- * for efficient querying at the organization level.
- */
-export declare class ActivityMetadata extends BaseMetadata {
-    [key: string]: any;
-}
-/**
- * Core activity record representing a single activity event.
- *
- * @typeParam TEntity - Type of the parent entity snapshot (e.g., CommentAnnotation)
- * @typeParam TTarget - Type of the sub-entity snapshot (e.g., Comment)
- */
-export declare class ActivityRecord<TEntity = unknown, TTarget = unknown> {
-    /** Auto-generated unique ID */
-    id: string;
-    /** Feature that generated this activity */
-    featureType: ActivityFeatureType;
-    /** Action that occurred, following `entity_type.action` pattern */
-    actionType: string;
-    /** Event type that occurred */
-    eventType?: string;
-    /** User who performed the action */
-    actionUser: User;
-    /** Server timestamp (set by backend) */
-    timestamp: number;
-    /** Denormalized IDs for querying */
-    metadata: ActivityMetadata;
-    /** ID of the parent entity (annotationId, recordingId, etc.) */
-    targetEntityId: string;
-    /** ID of the sub-entity acted on (commentId within annotation, null for entity-level actions) */
-    targetSubEntityId?: string | null;
-    /** Linear-style from/to change pairs */
-    changes?: ActivityChanges;
-    /** Full parent entity snapshot at time of action */
-    entityData?: TEntity;
-    /** Sub-entity snapshot (or user-provided data for custom activities) */
-    entityTargetData?: TTarget;
-    /** Display message template — ONLY for custom activities */
-    displayMessageTemplate?: string;
-    /** Template variable values — ONLY for custom activities */
-    displayMessageTemplateData?: Record<string, unknown>;
-    /** Computed display message (generated client-side, never stored in Firestore) */
-    displayMessage?: string;
-    /** Icon URL or identifier for display */
-    actionIcon?: string;
-    /** If true, this activity cannot be updated or deleted via REST API */
-    immutable?: boolean;
-    /** If true, this activity was stripped by the activity resolver (for UI loading states) */
-    isActivityResolverUsed?: boolean;
-}
-/**
- * Configuration for subscribing to activities.
- * Behavior is determined by the props passed:
- * - No config → org-wide
- * - documentIds → specific documents
- * - currentDocumentOnly → current document only
- */
-export interface ActivitySubscribeConfig {
-    /** Subscribe to activities for a specific organization (defaults to current org) */
-    organizationId?: string;
-    /** Subscribe to activities for specific document IDs */
-    documentIds?: string[];
-    /** Subscribe to activities for the current document only (auto-switches on setDocument) */
-    currentDocumentOnly?: boolean;
-    /** Only fetch activities from the last N days (default: 30) */
-    maxDays?: number;
-    /** Allowlist: only include activities with these feature types */
-    featureTypes?: ActivityFeatureType[];
-    /** Disallowlist: exclude activities with these feature types (ignored if featureTypes is set) */
-    excludeFeatureTypes?: ActivityFeatureType[];
-    /** Allowlist: only include activities with these action types */
-    actionTypes?: string[];
-    /** Disallowlist: exclude activities with these action types (ignored if actionTypes is set) */
-    excludeActionTypes?: string[];
-    /** Allowlist: only include activities by these user IDs */
-    userIds?: string[];
-    /** Disallowlist: exclude activities by these user IDs (ignored if userIds is set) */
-    excludeUserIds?: string[];
-}
-/**
- * Represents an active activity subscription.
- * Returned by `activityService.subscribe()`.
- */
-export interface ActivitySubscription {
-    /** Observable stream of activities for this subscription's scope. null = not yet loaded. */
-    getActivities$(): Observable<ActivityRecord[] | null>;
-    /** Unsubscribe and clean up this subscription */
-    unsubscribe(): void;
-}
-/**
- * Data required to create an activity.
- * Used for all activity types: comment, reaction, recorder, custom, etc.
- */
-export interface CreateActivityData<TEntity = unknown, TTarget = unknown> {
-    featureType: ActivityFeatureType;
-    actionType: string;
-    eventType?: string;
-    targetEntityId: string;
-    targetSubEntityId?: string | null;
-    changes?: ActivityChanges;
-    entityData?: TEntity;
-    entityTargetData?: TTarget;
-    /** Icon URL or identifier — typically used for custom activities */
-    actionIcon?: string;
-    /** Display message template — only for custom activities */
-    displayMessageTemplate?: string;
-    /** Template variable values — only for custom activities */
-    displayMessageTemplateData?: Record<string, unknown>;
-}

package/app/models/data/notification-resolver.data.model.d.ts

@@ -1,39 +0,0 @@
-import { ResolverEndpointConfig, ResolverResponse, RetryConfig } from "./resolver.data.model";
-import { User } from "./user.data.model";
-export interface NotificationDataProvider {
-    get?: (request: GetNotificationResolverRequest) => Promise<ResolverResponse<Record<string, PartialNotification>>>;
-    delete?: (request: DeleteNotificationResolverRequest) => Promise<ResolverResponse<undefined>>;
-    config?: NotificationResolverConfig;
-}
-export interface NotificationResolverConfig {
-    resolveTimeout?: number;
-    getRetryConfig?: RetryConfig;
-    deleteRetryConfig?: RetryConfig;
-    getConfig?: ResolverEndpointConfig;
-    deleteConfig?: ResolverEndpointConfig;
-}
-export interface GetNotificationResolverRequest {
-    organizationId: string;
-    notificationIds: string[];
-}
-export interface DeleteNotificationResolverRequest {
-    notificationId: string;
-    organizationId: string;
-}
-export interface PartialNotification {
-    notificationId: string;
-    displayHeadlineMessageTemplate?: string;
-    displayHeadlineMessageTemplateData?: {
-        actionUser?: User;
-        recipientUser?: User;
-        actionMessage?: string;
-        [key: string]: any;
-    };
-    displayBodyMessage?: string;
-    displayBodyMessageTemplate?: string;
-    displayBodyMessageTemplateData?: {
-        [key: string]: any;
-    };
-    notificationSourceData?: any;
-    [key: string]: any;
-}

package/app/models/data/recorder-resolver.data.model.d.ts

@@ -1,58 +0,0 @@
-import { ResolverActions } from "../../utils/enums";
-import { AttachmentDataProvider } from "./attachment-resolver.data.model";
-import { BaseMetadata } from "./base-metadata.data.model";
-import { RecorderAnnotation } from "./recorder-annotation.data.model";
-import { ResolverConfig, ResolverResponse } from "./resolver.data.model";
-import { Attachment } from "./attachment.model";
-import { Transcription } from "./transcription.data.model";
-import { User } from "./user.data.model";
-export interface RecorderAnnotationDataProvider {
-    get?: (request: GetRecorderResolverRequest) => Promise<ResolverResponse<Record<string, PartialRecorderAnnotation>>>;
-    save?: (request: SaveRecorderResolverRequest) => Promise<ResolverResponse<SaveRecorderResolverData | undefined>>;
-    delete?: (request: DeleteRecorderResolverRequest) => Promise<ResolverResponse<undefined>>;
-    config?: ResolverConfig;
-    uploadChunks?: boolean;
-    storage?: AttachmentDataProvider;
-}
-export interface GetRecorderResolverRequest {
-    organizationId: string;
-    recorderAnnotationIds?: string[];
-    documentIds?: string[];
-}
-export interface SaveRecorderResolverRequest {
-    recorderAnnotation: Record<string, PartialRecorderAnnotation>;
-    event?: ResolverActions;
-    metadata?: BaseMetadata;
-}
-export interface SaveRecorderResolverData {
-    transcription?: Transcription;
-    attachment?: Attachment | null;
-    attachments?: Attachment[];
-}
-export interface DeleteRecorderResolverRequest {
-    recorderAnnotationId: string;
-    metadata?: BaseMetadata;
-    event?: ResolverActions;
-}
-export interface PartialRecorderAnnotation {
-    annotationId: string;
-    metadata?: BaseMetadata;
-    from?: User;
-    transcription?: Transcription;
-    attachment?: Attachment | null;
-    attachments?: Attachment[];
-    chunkUrls?: Record<number, string>;
-    recordingEditVersions?: Record<number, PartialRecorderAnnotationEditVersion>;
-    [key: string]: any;
-}
-export interface PartialRecorderAnnotationEditVersion {
-    from?: User;
-    attachment?: Attachment | null;
-    attachments?: Attachment[];
-    transcription?: Transcription;
-}
-export interface PartialRecorderAnnotationResult {
-    strippedData: Record<string, PartialRecorderAnnotation> | null;
-    originalData: RecorderAnnotation | null;
-    eventType?: ResolverActions;
-}

package/app/models/data/rewriter-events.data.model.d.ts

@@ -1,44 +0,0 @@
-import { TargetTextRange } from './target-text-range.data.model';
-import { RewriterEventTypes } from '../../utils/enums';
-export type OpenAiModel = 'gpt-5.4' | 'gpt-5.4-pro' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4-turbo' | 'o3-pro' | 'o3' | 'o3-mini' | 'o4-mini';
-export type AnthropicModel = 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-sonnet-4-5' | 'claude-opus-4-5' | 'claude-opus-4-1' | 'claude-sonnet-4-0' | 'claude-opus-4-0';
-export type GeminiModel = 'gemini-3.1-pro-preview' | 'gemini-3-flash-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-2.5-pro';
-export type AiModel = OpenAiModel | AnthropicModel | GeminiModel | (string & NonNullable<unknown>);
-export interface TextSelectedEvent {
-    selectionId: string;
-    text: string;
-    targetTextRange: TargetTextRange;
-}
-export interface RewriterAskAiRequest {
-    model: AiModel;
-    prompt: string;
-    selectedText: string;
-}
-export interface RewriterReplaceTextRequest {
-    text: string;
-    event: TextSelectedEvent;
-}
-export interface RewriterAddCommentRequest {
-    text: string;
-    event: TextSelectedEvent;
-}
-export interface RewriterAskAiResponse {
-    text: string;
-    success: boolean;
-    error?: string;
-}
-export interface RewriterReplaceTextResponse {
-    success: boolean;
-    originalText: string;
-    replacedText: string;
-    error?: string;
-}
-export interface RewriterAddCommentResponse {
-    success: boolean;
-    annotationId?: string;
-    commentText?: string;
-    error?: string;
-}
-export type RewriterEventTypesMap = {
-    [RewriterEventTypes.TEXT_SELECTED]: TextSelectedEvent;
-};

package/app/models/data/suggestion-events.data.model.d.ts

@@ -1,57 +0,0 @@
-import { SuggestionEventTypes } from '../../utils/enums';
-import { ApprovedSuggestion, PendingSuggestion, RejectedSuggestion, StaleSuggestion, TargetEditCommitBuilder, TargetEditDetails } from './suggestion.data.model';
-/**
- * Public payload types for the v1 Suggestions feature. Mirrors the layout of
- * `comment-events.data.model.ts` and `recorder-events.data.model.ts`:
- *
- *   - One named interface per event payload.
- *   - One `SuggestionEventTypesMap` keyed by `SuggestionEventTypes` enum values.
- *
- * Customers pass an event-name string (or the enum constant — they're
- * equivalent) to `velt.getSuggestionElement().on(...)` and receive an
- * `Observable<SuggestionEventTypesMap[T]>`.
- *
- * No separate `actor`/`user` field on the payloads: the user info is on
- * `suggestion.createdBy` (for created) and `suggestion.resolvedBy` (for
- * approved/rejected/stale). Matches the comment-event shape.
- */
-export interface SuggestionCreatedEvent {
-    suggestion: PendingSuggestion;
-    timestamp: number;
-}
-export interface SuggestionApprovedEvent {
-    suggestion: ApprovedSuggestion;
-    timestamp: number;
-}
-export interface SuggestionRejectedEvent {
-    suggestion: RejectedSuggestion;
-    timestamp: number;
-}
-export interface SuggestionStaleEvent {
-    suggestion: StaleSuggestion;
-    timestamp: number;
-}
-export interface TargetEditStartEvent {
-    details: TargetEditDetails;
-    timestamp: number;
-}
-export interface TargetEditCommitEvent {
-    details: TargetEditDetails;
-    /**
-     * Pre-bound builder. Calling it commits the suggestion using the SDK's
-     * default summary/metadata, optionally overridden by `result`. If the
-     * customer's `onTargetEditCommit` handler already returned a non-null
-     * result for this edit, this builder is a no-op so subscribers can't
-     * double-commit.
-     */
-    commitSuggestion: TargetEditCommitBuilder;
-    timestamp: number;
-}
-export type SuggestionEventTypesMap = {
-    [SuggestionEventTypes.SUGGESTION_CREATED]: SuggestionCreatedEvent;
-    [SuggestionEventTypes.SUGGESTION_APPROVED]: SuggestionApprovedEvent;
-    [SuggestionEventTypes.SUGGESTION_REJECTED]: SuggestionRejectedEvent;
-    [SuggestionEventTypes.SUGGESTION_STALE]: SuggestionStaleEvent;
-    [SuggestionEventTypes.TARGET_EDIT_START]: TargetEditStartEvent;
-    [SuggestionEventTypes.TARGET_EDIT_COMMIT]: TargetEditCommitEvent;
-};

package/app/models/data/suggestion.data.model.d.ts

@@ -1,262 +0,0 @@
-/**
- * Suggestions feature — public type surface for v1.
- *
- * Source contract: docs/suggestions-api-contract.md
- * Source flows:    docs/suggestions-implementation-flows.md
- *
- * Types are exported from the SDK's public barrel. Customer code interacts
- * with these via Snippyly.getSuggestionElement(); the SDK constructs all
- * Suggestion objects internally and customers do not build them directly.
- */
-import { User } from './user.data.model';
-/**
- * Lifecycle state machine for a Suggestion.
- *
- * - pending:      Just created, awaiting owner action.
- * - approved:     Owner clicked Approve. Customer apply handler ran successfully.
- * - rejected:     Owner clicked Reject (with optional reason).
- * - stale:        Target was unresolvable at approve time. Owner can dismiss.
- * - apply_failed: Customer apply handler threw during a suggestionApproved event.
- *                 Status set by the SDK after the throw was caught.
- */
-export type SuggestionStatus = 'pending' | 'approved' | 'rejected' | 'stale' | 'apply_failed';
-/**
- * Global per-user-per-session suggestion mode. Not persisted; reload returns to 'editing'.
- */
-export type SuggestionMode = 'editing' | 'suggesting';
-/**
- * Discriminator for the substrate that produced a suggestion. v1: always 'custom'.
- * Wrapper libraries (e.g. tiptap-velt-comments) widen this union when they integrate.
- *
- * Customers should treat unknown values as opaque; the field exists so customer code
- * can differentiate substrate when domain-specific rendering matters.
- */
-export type SuggestionTargetType = 'custom';
-/**
- * Single-arg config passed to `SuggestionElement.registerTarget(config)`.
- * Carrying both `targetId` and `getter` in one object so the API can grow
- * (e.g., metadata, target-specific options) without breaking customers.
- */
-export interface RegisterTargetConfig<T = unknown> {
-    targetId: string;
-    getter: TargetGetter<T>;
-}
-/**
- * Function the customer registers via SuggestionElement.registerTarget(config).
- * Required for any non-primitive (wrapper) target.
- *
- * The SDK calls this getter twice in a typical edit cycle:
- *   1. On focus of the tagged element — to snapshot the pre-edit value.
- *   2. On commit (focusout / change) — to read the current value for the diff.
- *
- * IMPORTANT — edit-time state, not persisted state: the getter must reflect
- * what the user is currently editing, not what's persisted in the customer's
- * app store. If the customer's state is only updated on commit/approve (as
- * is typical when suggesting mode is on), reading from that state would
- * return the snapshot value at commit time, the diff check would short-
- * circuit, and no suggestion would ever fire.
- *
- * Recommended: read from the DOM (controlled or uncontrolled inputs) so the
- * getter always returns what's visible to the user.
- *
- *   el.registerTarget('row.123', () => ({
- *     qty:   parseInt(qtyInput.value, 10),
- *     price: parseInt(priceInput.value, 10),
- *   }));
- *
- * For controlled inputs (state updates on every keystroke), reading from
- * the customer state is fine: `() => myState.row123`. The contract is
- * "edit-time state" — whichever source of truth has it.
- */
-export type TargetGetter<T = unknown> = () => T;
-/**
- * Returned from SuggestionElement.on(...). Calling it removes the handler.
- */
-export type Unsubscribe = () => void;
-/**
- * Details about a target edit, passed to the customer's resolver handler and
- * to subscribers of `targetEditStart` / `targetEditCommit` events.
- *
- * `element` is the DOM element that produced the edit. It's the tagged
- * descendant — or, for wrappers that nest interactive controls inside a
- * tagged container, the inner element that actually fired the event. In
- * either case the SDK walks up to the nearest ancestor carrying
- * `data-velt-suggestion-target` to resolve `targetId`.
- *
- * `element` is provided for read access only — customers should not retain
- * the reference past the synchronous handler call.
- */
-export interface TargetEditDetails<T = unknown> {
-    targetId: string;
-    oldValue: T;
-    newValue: T;
-    element: Element | null;
-}
-/**
- * Return type of `onTargetEditCommit`. Returning a value auto-commits the
- * suggestion using the (optional) overrides; returning null skips the
- * auto-commit so a subscriber to `targetEditCommit` can drive it explicitly.
- */
-export interface TargetEditCommitResult {
-    /** Override the SDK's default `${targetId}: ${old} → ${new}` summary. */
-    summary?: string;
-    /** Customer metadata persisted on the resulting Suggestion. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Return type of `onTargetEditStart`. Reserved for future fields; v1 has
- * no behavior-bearing return values, so customers may omit a return.
- *
- * Roadmap: future versions may accept `{ oldValue }` here so customers can
- * override the SDK's auto-snapshot with a domain-canonical value.
- */
-export interface TargetEditStartResult {
-}
-export type TargetEditStartHandler<T = unknown> = (details: TargetEditDetails<T>) => TargetEditStartResult | void | null;
-export type TargetEditCommitHandler<T = unknown> = (details: TargetEditDetails<T>) => TargetEditCommitResult | null;
-/**
- * Config passed to `SuggestionElement.enableSuggestionMode(config?)`.
- * Both callbacks are optional. If `onTargetEditCommit` is omitted, customers
- * can still drive auto-commit by subscribing to the `targetEditCommit` event
- * and calling the pre-bound `commitSuggestion` builder on the payload.
- */
-export interface EnableSuggestionModeConfig {
-    /**
-     * Invoked on focus of a tagged element, after the SDK captures the
-     * snapshot. v1: informational — return value is reserved for future
-     * use (e.g. `{ oldValue }` to override the SDK's auto-snapshot).
-     */
-    onTargetEditStart?: TargetEditStartHandler;
-    /**
-     * Invoked once per detected commit (on `change` for atomic inputs, on
-     * `focusout` for text-like inputs). Returning a `TargetEditCommitResult`
-     * auto-commits with the supplied summary/metadata; returning null defers
-     * to event subscribers.
-     */
-    onTargetEditCommit?: TargetEditCommitHandler;
-}
-/**
- * SDK-managed suggestion data persisted on a CommentAnnotation.
- * Present iff annotation.type === 'suggestion'.
- *
- * Customer code must not write to this directly — use the SuggestionElement API.
- */
-export interface SuggestionData {
-    /** Lifecycle state machine. */
-    status: SuggestionStatus;
-    /** Stable, customer-owned target identifier. */
-    targetId: string;
-    /** v1: always 'custom'. Wrappers widen later. */
-    targetType: SuggestionTargetType;
-    /** Snapshot taken at startSuggestion / focus time. Frozen via structuredClone. */
-    oldValue: any;
-    /** Value submitted via commitSuggestion. */
-    newValue: any;
-    /** Optional human-readable description for logs / notifications. */
-    summary: string | null;
-    /**
-     * True if the live value at approve time differed from oldValue.
-     * v1 records flag only; v1.1 will surface a confirmation prompt.
-     */
-    driftDetected: boolean;
-    /** Populated only when status === 'rejected'. */
-    rejectReason: string | null;
-    /**
-     * Full User snapshot of the resolver, populated when status moves to
-     * approved | rejected | stale | apply_failed. Snapshot rather than userId
-     * so customer code can render name/email/photoUrl without an extra lookup,
-     * and so historical suggestions retain their resolver record even if the
-     * user later updates their profile.
-     */
-    resolvedBy: User | null;
-    resolvedAt: number | null;
-}
-/**
- * Fields shared across every Suggestion regardless of status.
- * Internal — used to build the per-status discriminated types below.
- */
-interface SuggestionBase<T = unknown> {
-    /** Annotation document id (same as the underlying CommentAnnotation.annotationId). */
-    annotationId: string;
-    /** Stable, customer-owned target identifier. */
-    targetId: string;
-    /** v1: always 'custom'. */
-    targetType: SuggestionTargetType;
-    /** Snapshot taken at startSuggestion / focus time. */
-    oldValue: T;
-    /** Value submitted via commitSuggestion. */
-    newValue: T;
-    /** Optional human-readable description. */
-    summary: string | null;
-    /** Customer-defined metadata supplied via CommitSuggestionConfig.metadata. */
-    metadata: Record<string, any>;
-    /** True iff the live value at approve time differed from oldValue. */
-    driftDetected: boolean;
-    /**
-     * User of the suggestion's creator (sourced from annotation.from).
-     */
-    createdBy?: User;
-    createdAt: number;
-}
-/** A suggestion in the 'pending' state — newly created, no owner action yet. */
-export interface PendingSuggestion<T = unknown> extends SuggestionBase<T> {
-    status: 'pending';
-    rejectReason: null;
-    resolvedBy: null;
-    resolvedAt: null;
-}
-/** A suggestion that has been approved (apply handler success or pending invocation). */
-export interface ApprovedSuggestion<T = unknown> extends SuggestionBase<T> {
-    status: 'approved' | 'apply_failed';
-    rejectReason: null;
-    resolvedBy: User;
-    resolvedAt: number;
-}
-/** A suggestion that has been rejected. rejectReason is non-null. */
-export interface RejectedSuggestion<T = unknown> extends SuggestionBase<T> {
-    status: 'rejected';
-    rejectReason: string;
-    resolvedBy: User;
-    resolvedAt: number;
-}
-/** A suggestion whose target was unresolvable at approve time. */
-export interface StaleSuggestion<T = unknown> extends SuggestionBase<T> {
-    status: 'stale';
-    rejectReason: null;
-    resolvedBy: User | null;
-    resolvedAt: number | null;
-}
-/**
- * Public Suggestion — discriminated union keyed by `status`. TypeScript narrows
- * field types per status so handlers can rely on rejectReason: string when they've
- * checked status === 'rejected'.
- */
-export type Suggestion<T = unknown> = PendingSuggestion<T> | ApprovedSuggestion<T> | RejectedSuggestion<T> | StaleSuggestion<T>;
-export interface CommitSuggestionConfig<T = unknown> {
-    /**
-     * Must be registered (via data-velt-target attribute or registerTarget call)
-     * before commit, otherwise the suggestion is rejected with a dev-mode warning.
-     */
-    targetId: string;
-    /** Any JSON-serializable value. Customer's apply handler interprets it. */
-    newValue: T;
-    /** Optional human-readable string for logs and notifications. */
-    summary?: string;
-    /** Optional customer-defined metadata. Stored on Suggestion.metadata. */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Pre-bound builder attached to `targetEditCommit` payloads. Calling it
- * commits the suggestion with the SDK's default summary/metadata, optionally
- * overridden by `result`. If the customer's `onTargetEditCommit` handler
- * already returned a non-null result for this edit, this builder is a no-op
- * (resolves immediately) so subscribers can't double-commit.
- */
-export type TargetEditCommitBuilder = (result?: TargetEditCommitResult) => Promise<{
-    id: string;
-} | null>;
-export interface SuggestionGetSuggestionsFilter {
-    targetId?: string;
-    status?: SuggestionStatus | SuggestionStatus[];
-}
-export {};