devchain-cli 0.20.3 → 0.22.0

package/dist/server/modules/external-integrations/models/external-provider.models.d.ts

@@ -0,0 +1,341 @@
+import type { IntegrationCredentials, IntegrationProvider } from '../../storage/models/domain.models';
+import type { ExternalRichDocumentV1 } from './external-rich-document';
+export declare const MAX_REMOTE_TASK_ID_LENGTH = 256;
+export declare const MAX_STATUS_LENGTH = 256;
+export declare const MAX_COMMENT_LENGTH = 10000;
+export declare const MAX_TIME_ENTRY_NOTE_LENGTH = 10000;
+export declare const MAX_TIME_ENTRY_DURATION_MS: number;
+export declare const MAX_TASK_DETAIL_TEXT_LENGTH = 65536;
+export declare const MAX_TASK_DETAIL_SUBTASKS = 100;
+export declare const MAX_TASK_COMMENT_BODY_LENGTH = 8000;
+export declare const MAX_TASK_COMMENT_AUTHOR_LENGTH = 256;
+export declare const MAX_TASK_COMMENT_ID_LENGTH = 256;
+export declare const MAX_TASK_COMMENT_CURSOR_LENGTH = 1024;
+export declare const MAX_EXTERNAL_SUBTASK_TITLE_LENGTH = 255;
+export declare const MAX_EXTERNAL_SUBTASK_DESCRIPTION_LENGTH = 65536;
+export declare const MAX_EXTERNAL_SUBTASK_OWNERSHIP_TOKEN_LENGTH = 256;
+export declare const EXTERNAL_SUBTASK_MANAGEMENT_NOTE = "Managed by DevChain. Update or delete this subtask in DevChain; remote changes are not imported.";
+export declare const TIME_ENTRY_HISTORY_WINDOW_DAYS = 30;
+export declare const MAX_TIME_ENTRY_HISTORY_ENTRIES = 100;
+export interface ExternalProviderAccount {
+    provider: IntegrationProvider;
+    remoteId: string;
+    displayName: string;
+}
+export interface ExternalProviderDescriptor {
+    provider: IntegrationProvider;
+    displayName: string;
+    capabilities: {
+        myWork: boolean;
+    };
+}
+export type ExternalTaskStatusCategory = 'active' | 'completed' | 'unknown';
+export interface ExternalTaskStatus {
+    remoteId?: string | null;
+    name: string;
+    category: ExternalTaskStatusCategory;
+}
+export type ExternalWorkAreaKind = 'list' | 'board' | 'project';
+export type ExternalWorkAreaLocationKind = 'workspace' | 'space' | 'folder' | 'project' | 'board';
+export interface ExternalWorkAreaLocation {
+    kind: ExternalWorkAreaLocationKind;
+    remoteId: string;
+    name: string;
+}
+export interface ExternalWorkAreaColumn {
+    remoteId: string | null;
+    remoteStatusIds?: string[];
+    name: string;
+    color: string;
+    category: ExternalTaskStatusCategory;
+    position: number;
+}
+export interface ExternalWorkAreaWorkflow {
+    isOverridden: boolean;
+    columns: ExternalWorkAreaColumn[];
+}
+export interface ExternalTaskStatusOption extends ExternalWorkAreaColumn {
+    actionValue: string;
+    actionLabel?: string;
+}
+export type ExternalWorkAreaRefreshState = 'fresh' | 'stale' | 'error';
+export interface ExternalWorkAreaRefresh {
+    state: ExternalWorkAreaRefreshState;
+    refreshedAt: string | null;
+    retryable: boolean;
+    retryAt: string | null;
+}
+export interface ExternalWorkArea {
+    remoteId: string;
+    scopeKey: string;
+    name: string;
+    kind: ExternalWorkAreaKind;
+    description: string | null;
+    assignedTaskCount: number;
+    hierarchy: ExternalWorkAreaLocation[];
+    workflow: ExternalWorkAreaWorkflow;
+    refresh: ExternalWorkAreaRefresh;
+}
+export interface ExternalTaskSummary {
+    remoteId: string;
+    parentRemoteTaskId: string | null;
+    title: string;
+    status: ExternalTaskStatus;
+    updatedAt: string;
+    dueAt: string | null;
+    completedAt: string | null;
+    webUrl: string | null;
+}
+export interface ExternalTaskSubtaskSummary {
+    remoteId: string;
+    remoteKey: string;
+    title: string;
+    status: ExternalTaskStatus;
+    webUrl: string | null;
+}
+export interface ExternalWorkAreaTask {
+    workArea: ExternalWorkArea;
+    task: ExternalTaskSummary;
+}
+export type ExternalTaskAction = 'change_status' | 'add_comment' | 'log_time';
+export interface ExternalTaskActionCapability {
+    action: ExternalTaskAction;
+    supported: boolean;
+}
+export interface ExternalTaskPriority {
+    name: string;
+    color: string;
+}
+export interface ExternalTaskLocation {
+    scopeKey: string;
+    workAreaId: string;
+    workAreaName: string;
+}
+export interface ExternalTaskLinkState {
+    linked: boolean;
+    epicId: string | null;
+}
+export interface ExternalProviderTaskDetail {
+    remoteId: string;
+    remoteKey: string;
+    title: string;
+    description: string | null;
+    descriptionTruncated: boolean;
+    status: ExternalWorkAreaColumn;
+    dueAt: string | null;
+    priority: ExternalTaskPriority | null;
+    subtasks: ExternalTaskSubtaskSummary[];
+    subtasksTruncated: boolean;
+    taskTotalDurationMs: number | null;
+    webUrl: string;
+    location: ExternalTaskLocation;
+    allowedStatuses: ExternalTaskStatusOption[];
+    actions: ExternalTaskActionCapability[];
+}
+export interface ExternalTaskDetail extends ExternalProviderTaskDetail {
+    linkState: ExternalTaskLinkState;
+}
+export interface ExternalTaskStatusInput {
+    status: string;
+}
+export interface ExternalTaskCommentInput {
+    text: string;
+    notifyAll: boolean;
+}
+export interface ExternalTaskCommentAuthor {
+    remoteId: string | null;
+    displayName: string;
+}
+export interface ExternalTaskCommentRich {
+    document: ExternalRichDocumentV1;
+    supported: true;
+}
+export type ExternalTaskCommentRichResult = ExternalTaskCommentRich | {
+    supported: false;
+    readOnlyReason: string;
+};
+export interface ExternalTaskComment {
+    remoteId: string;
+    author: ExternalTaskCommentAuthor;
+    body: string;
+    bodyTruncated: boolean;
+    rich: ExternalTaskCommentRichResult | null;
+    lookupToken: string | null;
+    owned: boolean;
+    createdAt: string;
+    updatedAt: string | null;
+}
+export interface ExternalTaskCommentPage {
+    comments: ExternalTaskComment[];
+    nextCursor: string | null;
+}
+export interface ExternalTaskTimeEntryInput {
+    startedAt: string;
+    durationMs: number;
+    note: string | null;
+}
+export interface ExternalTaskTimeEntry {
+    remoteId: string;
+    durationMs: number;
+    startedAt: string;
+    note: string | null;
+    noteTruncated: boolean;
+    canDelete: boolean;
+}
+export interface ExternalTaskTimeEntryHistory {
+    windowDays: 30;
+    entries: ExternalTaskTimeEntry[];
+    truncated: boolean;
+    hasRunningTimer: boolean;
+}
+export interface ExternalTaskActionResult {
+    remoteTaskId: string;
+    action: ExternalTaskAction;
+    succeeded: true;
+    refresh: Array<'my_work' | 'task_detail'>;
+}
+export interface ExternalTaskLinkLookupInput {
+    scopeKey: string;
+    taskId: string;
+}
+export interface ExternalTaskLinkStateSummary extends ExternalTaskLinkLookupInput {
+    linked: boolean;
+    epicId: string | null;
+    projectId: string | null;
+    projectName: string | null;
+}
+export interface ExternalTaskSourceSummary {
+    provider: IntegrationProvider;
+    remoteTaskId: string;
+    remoteKey: string;
+    title: string;
+    workAreaName: string;
+    statusName: string;
+    webUrl: string | null;
+    linkedAt: string;
+}
+export interface ExternalTaskImportResponse {
+    epic: {
+        id: string;
+        projectId: string;
+    };
+    created: boolean;
+}
+export interface ExternalMyWorkRequestOptions {
+    includeCompleted: boolean;
+}
+export interface ExternalProviderConnectionContext {
+    connectionId: string;
+    connectionGeneration: number;
+}
+export interface ExternalMyWorkOptions extends ExternalMyWorkRequestOptions, ExternalProviderConnectionContext {
+}
+export interface ExternalMyWorkCapabilities {
+    timeTrackingEnabled: boolean;
+}
+export interface ExternalMyWorkSnapshot {
+    capabilities: ExternalMyWorkCapabilities;
+    workAreas: ExternalWorkArea[];
+    tasks: ExternalWorkAreaTask[];
+    refreshedAt: string;
+}
+export interface ExternalMyWorkCapability {
+    discover(credentials: IntegrationCredentials, options: ExternalMyWorkOptions): Promise<ExternalMyWorkSnapshot>;
+    getTaskDetail(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string): Promise<ExternalProviderTaskDetail>;
+    listComments(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, cursor: string | null): Promise<ExternalTaskCommentPage>;
+    changeStatus(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, input: ExternalTaskStatusInput): Promise<void>;
+    addComment(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, input: ExternalTaskCommentInput): Promise<void>;
+    getTimeEntryHistory(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string): Promise<ExternalTaskTimeEntryHistory>;
+}
+export interface ExternalTimeEntryExactRead {
+    remoteId: string;
+    startedAt: string;
+    durationMs: number;
+    owned: boolean;
+}
+export interface ExternalTimeEntryRangeIds {
+    ids: string[];
+    complete: boolean;
+}
+export interface ExternalTimeEntryCreateProof {
+    remoteEntryId: string | null;
+}
+export interface ExternalTimeEntryMutationsCapability {
+    createTimeEntry(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, input: ExternalTaskTimeEntryInput): Promise<ExternalTimeEntryCreateProof>;
+    deleteTimeEntry(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, remoteEntryId: string): Promise<void>;
+    readTimeEntryExact(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, remoteEntryId: string): Promise<ExternalTimeEntryExactRead | null>;
+    listOwnTimeEntryIdsInRange(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, startedAfterMs: number, startedBeforeMs: number): Promise<ExternalTimeEntryRangeIds>;
+    assertTimeEntryDeletable(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, remoteEntryId: string): Promise<void>;
+}
+export interface ExternalSubtaskOwnershipProof {
+    remoteTaskId: string;
+    expectedParentRemoteTaskId: string;
+    ownershipToken: string;
+}
+export interface ExternalSubtaskCreateInput {
+    parentRemoteTaskId: string;
+    ownershipToken: string;
+    title: string;
+    description: string | null;
+}
+export interface ExternalSubtaskUpdateInput extends ExternalSubtaskOwnershipProof {
+    title?: string;
+    description?: string | null;
+}
+export interface ExternalSubtaskSnapshot {
+    remoteTaskId: string;
+    remoteKey: string;
+    parentRemoteTaskId: string | null;
+    workAreaRemoteId: string;
+    ownershipToken: string | null;
+    title: string;
+    description: string | null;
+}
+export interface ExternalSubtaskChildrenResult {
+    items: ExternalSubtaskSnapshot[];
+    complete: boolean;
+}
+export type ExternalSubtaskDeleteResult = {
+    outcome: 'deleted';
+} | {
+    outcome: 'already_absent';
+};
+export interface ExternalSubtaskSyncCapability {
+    create(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, input: ExternalSubtaskCreateInput): Promise<ExternalSubtaskSnapshot>;
+    readExact(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string): Promise<ExternalSubtaskSnapshot | null>;
+    update(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, input: ExternalSubtaskUpdateInput): Promise<void>;
+    delete(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, proof: ExternalSubtaskOwnershipProof): Promise<ExternalSubtaskDeleteResult>;
+    listOwnedDirectChildren(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, parentRemoteTaskId: string, ownershipToken: string): Promise<ExternalSubtaskChildrenResult>;
+    assertOwned(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, proof: ExternalSubtaskOwnershipProof): Promise<ExternalSubtaskSnapshot>;
+}
+export interface ExternalOwnedCommentSnapshot {
+    remoteId: string;
+    authorRemoteId: string | null;
+    createdAt: string;
+    raw: unknown;
+    metadata: {
+        assignee: number | null;
+        resolved: boolean | null;
+        groupAssignee: string | null;
+    };
+}
+export interface ExternalOwnedMutationsCapability {
+    getCurrentOwnerRemoteId(credentials: IntegrationCredentials): Promise<string>;
+    findComment(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, commentId: string, pageProof: string | null): Promise<ExternalOwnedCommentSnapshot | null>;
+    deleteComment(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, commentId: string): Promise<void>;
+    updateOwnedComment(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, commentId: string, document: ExternalRichDocumentV1, metadata: ExternalOwnedCommentSnapshot['metadata']): Promise<void>;
+}
+export interface ExternalDescriptionEditCapability {
+    readDescription(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string): Promise<unknown>;
+    writeDescription(credentials: IntegrationCredentials, context: ExternalProviderConnectionContext, remoteTaskId: string, raw: unknown): Promise<void>;
+}
+export type ExternalMyWorkResult = {
+    provider: IntegrationProvider;
+    descriptor: ExternalProviderDescriptor;
+    supported: false;
+    reason: 'unsupported';
+} | ({
+    provider: IntegrationProvider;
+    descriptor: ExternalProviderDescriptor;
+    supported: true;
+} & ExternalMyWorkSnapshot);

package/dist/server/modules/external-integrations/models/external-provider.models.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TIME_ENTRY_HISTORY_ENTRIES = exports.TIME_ENTRY_HISTORY_WINDOW_DAYS = exports.EXTERNAL_SUBTASK_MANAGEMENT_NOTE = exports.MAX_EXTERNAL_SUBTASK_OWNERSHIP_TOKEN_LENGTH = exports.MAX_EXTERNAL_SUBTASK_DESCRIPTION_LENGTH = exports.MAX_EXTERNAL_SUBTASK_TITLE_LENGTH = exports.MAX_TASK_COMMENT_CURSOR_LENGTH = exports.MAX_TASK_COMMENT_ID_LENGTH = exports.MAX_TASK_COMMENT_AUTHOR_LENGTH = exports.MAX_TASK_COMMENT_BODY_LENGTH = exports.MAX_TASK_DETAIL_SUBTASKS = exports.MAX_TASK_DETAIL_TEXT_LENGTH = exports.MAX_TIME_ENTRY_DURATION_MS = exports.MAX_TIME_ENTRY_NOTE_LENGTH = exports.MAX_COMMENT_LENGTH = exports.MAX_STATUS_LENGTH = exports.MAX_REMOTE_TASK_ID_LENGTH = void 0;
+exports.MAX_REMOTE_TASK_ID_LENGTH = 256;
+exports.MAX_STATUS_LENGTH = 256;
+exports.MAX_COMMENT_LENGTH = 10_000;
+exports.MAX_TIME_ENTRY_NOTE_LENGTH = 10_000;
+exports.MAX_TIME_ENTRY_DURATION_MS = 7 * 24 * 60 * 60 * 1_000;
+exports.MAX_TASK_DETAIL_TEXT_LENGTH = 65_536;
+exports.MAX_TASK_DETAIL_SUBTASKS = 100;
+exports.MAX_TASK_COMMENT_BODY_LENGTH = 8_000;
+exports.MAX_TASK_COMMENT_AUTHOR_LENGTH = 256;
+exports.MAX_TASK_COMMENT_ID_LENGTH = 256;
+exports.MAX_TASK_COMMENT_CURSOR_LENGTH = 1_024;
+exports.MAX_EXTERNAL_SUBTASK_TITLE_LENGTH = 255;
+exports.MAX_EXTERNAL_SUBTASK_DESCRIPTION_LENGTH = 65_536;
+exports.MAX_EXTERNAL_SUBTASK_OWNERSHIP_TOKEN_LENGTH = 256;
+exports.EXTERNAL_SUBTASK_MANAGEMENT_NOTE = 'Managed by DevChain. Update or delete this subtask in DevChain; remote changes are not imported.';
+exports.TIME_ENTRY_HISTORY_WINDOW_DAYS = 30;
+exports.MAX_TIME_ENTRY_HISTORY_ENTRIES = 100;
+//# sourceMappingURL=external-provider.models.js.map

package/dist/server/modules/external-integrations/models/external-provider.models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-provider.models.js","sourceRoot":"","sources":["../../../../src/modules/external-integrations/models/external-provider.models.ts"],"names":[],"mappings":";;;AAMa,QAAA,yBAAyB,GAAG,GAAG,CAAC;AAChC,QAAA,iBAAiB,GAAG,GAAG,CAAC;AACxB,QAAA,kBAAkB,GAAG,MAAM,CAAC;AAC5B,QAAA,0BAA0B,GAAG,MAAM,CAAC;AACpC,QAAA,0BAA0B,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AACtD,QAAA,2BAA2B,GAAG,MAAM,CAAC;AACrC,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAC/B,QAAA,4BAA4B,GAAG,KAAK,CAAC;AACrC,QAAA,8BAA8B,GAAG,GAAG,CAAC;AACrC,QAAA,0BAA0B,GAAG,GAAG,CAAC;AACjC,QAAA,8BAA8B,GAAG,KAAK,CAAC;AACvC,QAAA,iCAAiC,GAAG,GAAG,CAAC;AACxC,QAAA,uCAAuC,GAAG,MAAM,CAAC;AACjD,QAAA,2CAA2C,GAAG,GAAG,CAAC;AAClD,QAAA,gCAAgC,GAC3C,kGAAkG,CAAC;AACxF,QAAA,8BAA8B,GAAG,EAAE,CAAC;AACpC,QAAA,8BAA8B,GAAG,GAAG,CAAC"}

package/dist/server/modules/external-integrations/models/external-rich-capabilities.d.ts

@@ -0,0 +1,6 @@
+export declare const EXTERNAL_RICH_CAPABILITIES: {
+    readonly richEdit: true;
+    readonly ownedDelete: true;
+};
+export type ExternalRichCapabilityFlags = typeof EXTERNAL_RICH_CAPABILITIES;
+export declare const EXTERNAL_RICH_CAPABILITIES_TOKEN: unique symbol;

package/dist/server/modules/external-integrations/models/external-rich-capabilities.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXTERNAL_RICH_CAPABILITIES_TOKEN = exports.EXTERNAL_RICH_CAPABILITIES = void 0;
+exports.EXTERNAL_RICH_CAPABILITIES = {
+    richEdit: true,
+    ownedDelete: true,
+};
+exports.EXTERNAL_RICH_CAPABILITIES_TOKEN = Symbol('EXTERNAL_RICH_CAPABILITIES_TOKEN');
+//# sourceMappingURL=external-rich-capabilities.js.map

package/dist/server/modules/external-integrations/models/external-rich-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-rich-capabilities.js","sourceRoot":"","sources":["../../../../src/modules/external-integrations/models/external-rich-capabilities.ts"],"names":[],"mappings":";;;AAOa,QAAA,0BAA0B,GAAG;IAExC,QAAQ,EAAE,IAAI;IAEd,WAAW,EAAE,IAAI;CACT,CAAC;AAIE,QAAA,gCAAgC,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAC"}

package/dist/server/modules/external-integrations/models/external-rich-document.d.ts

@@ -0,0 +1,59 @@
+export declare const RICH_DOCUMENT_VERSION = 1;
+export declare const RICH_MAX_DEPTH = 16;
+export declare const RICH_MAX_BLOCK_COUNT = 1000;
+export declare const RICH_MAX_NODE_COUNT = 10000;
+export declare const RICH_MAX_TEXT_RUN_LENGTH = 8000;
+export declare const RICH_MAX_TOTAL_TEXT_LENGTH = 65536;
+export declare const RICH_COMMENT_MAX_SEGMENT_COUNT = 1000;
+export type ExternalRichMark = {
+    type: 'bold';
+} | {
+    type: 'italic';
+} | {
+    type: 'code';
+} | {
+    type: 'link';
+    href: string;
+};
+export interface ExternalRichTextRun {
+    type: 'text';
+    text: string;
+    marks: ExternalRichMark[];
+}
+export interface ExternalRichHardBreak {
+    type: 'hardBreak';
+}
+export type ExternalRichInline = ExternalRichTextRun | ExternalRichHardBreak;
+export interface ExternalRichParagraph {
+    type: 'paragraph';
+    content: ExternalRichInline[];
+}
+export interface ExternalRichHeading {
+    type: 'heading';
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    content: ExternalRichInline[];
+}
+export interface ExternalRichBulletList {
+    type: 'bulletList';
+    items: ExternalRichInline[][];
+}
+export interface ExternalRichBlockquote {
+    type: 'blockquote';
+    paragraphs: ExternalRichInline[][];
+}
+export type ExternalRichBlock = ExternalRichParagraph | ExternalRichHeading | ExternalRichBulletList | ExternalRichBlockquote;
+export interface ExternalRichDocumentV1 {
+    version: typeof RICH_DOCUMENT_VERSION;
+    blocks: ExternalRichBlock[];
+}
+export type ExternalRichUnsupportedReason = 'unsupported_node' | 'unsupported_mark' | 'limit_exceeded' | 'invalid_input';
+export type ExternalRichDocumentResult = {
+    supported: true;
+    document: ExternalRichDocumentV1;
+} | {
+    supported: false;
+    reason: ExternalRichUnsupportedReason;
+};
+export declare function isSafeRichLinkHref(value: unknown): value is string;
+export declare function canonicalizeRichDocument(value: unknown): ExternalRichDocumentV1 | null;
+export declare function richDocumentFingerprint(document: ExternalRichDocumentV1): string | null;

package/dist/server/modules/external-integrations/models/external-rich-document.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RICH_COMMENT_MAX_SEGMENT_COUNT = exports.RICH_MAX_TOTAL_TEXT_LENGTH = exports.RICH_MAX_TEXT_RUN_LENGTH = exports.RICH_MAX_NODE_COUNT = exports.RICH_MAX_BLOCK_COUNT = exports.RICH_MAX_DEPTH = exports.RICH_DOCUMENT_VERSION = void 0;
+exports.isSafeRichLinkHref = isSafeRichLinkHref;
+exports.canonicalizeRichDocument = canonicalizeRichDocument;
+exports.richDocumentFingerprint = richDocumentFingerprint;
+exports.RICH_DOCUMENT_VERSION = 1;
+exports.RICH_MAX_DEPTH = 16;
+exports.RICH_MAX_BLOCK_COUNT = 1_000;
+exports.RICH_MAX_NODE_COUNT = 10_000;
+exports.RICH_MAX_TEXT_RUN_LENGTH = 8_000;
+exports.RICH_MAX_TOTAL_TEXT_LENGTH = 65_536;
+exports.RICH_COMMENT_MAX_SEGMENT_COUNT = 1_000;
+const MARK_TYPE_ORDER = {
+    bold: 0,
+    italic: 1,
+    code: 2,
+    link: 3,
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isSafeRichLinkHref(value) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return false;
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    return ((url.protocol === 'https:' || url.protocol === 'http:') &&
+        url.hostname !== '' &&
+        url.username === '' &&
+        url.password === '');
+}
+function markCompare(left, right) {
+    const leftKey = MARK_TYPE_ORDER[left.type];
+    const rightKey = MARK_TYPE_ORDER[right.type];
+    if (leftKey !== rightKey) {
+        return leftKey - rightKey;
+    }
+    return left.type === 'link' && right.type === 'link'
+        ? left.href < right.href
+            ? -1
+            : left.href > right.href
+                ? 1
+                : 0
+        : 0;
+}
+function markEqual(left, right) {
+    if (left.type !== right.type) {
+        return false;
+    }
+    return left.type === 'link' && right.type === 'link' ? left.href === right.href : true;
+}
+function normalizeMarks(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    const marks = [];
+    for (const item of value) {
+        if (!isRecord(item) || typeof item.type !== 'string') {
+            return null;
+        }
+        if (item.type === 'bold' || item.type === 'italic' || item.type === 'code') {
+            marks.push({ type: item.type });
+            continue;
+        }
+        if (item.type === 'link') {
+            const href = item.href;
+            if (!isSafeRichLinkHref(href)) {
+                return null;
+            }
+            marks.push({ type: 'link', href });
+            continue;
+        }
+        return null;
+    }
+    const deduped = [];
+    for (const mark of marks) {
+        if (!deduped.some((existing) => markEqual(existing, mark))) {
+            deduped.push(mark);
+        }
+    }
+    return deduped.sort(markCompare);
+}
+function normalizeInline(value, limits) {
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    const runs = [];
+    const pushText = (text, marks) => {
+        const previous = runs[runs.length - 1];
+        if (previous !== undefined &&
+            previous.type === 'text' &&
+            previous.marks.length === marks.length &&
+            previous.marks.every((mark, index) => markEqual(mark, marks[index]))) {
+            const merged = `${previous.text}${text}`.replace(/\s+/g, ' ');
+            runs[runs.length - 1] = { type: 'text', text: merged, marks };
+            return;
+        }
+        runs.push({ type: 'text', text, marks });
+    };
+    for (const item of value) {
+        limits.nodes += 1;
+        if (limits.nodes > exports.RICH_MAX_NODE_COUNT) {
+            return null;
+        }
+        if (isRecord(item) && item.type === 'hardBreak') {
+            runs.push({ type: 'hardBreak' });
+            continue;
+        }
+        if (!isRecord(item) || item.type !== 'text' || typeof item.text !== 'string') {
+            return null;
+        }
+        const marks = normalizeMarks(item.marks);
+        if (marks === null) {
+            return null;
+        }
+        const collapsed = item.text.replace(/\s+/g, ' ');
+        limits.totalText += collapsed.length;
+        if (collapsed.trim().length > exports.RICH_MAX_TEXT_RUN_LENGTH ||
+            limits.totalText > exports.RICH_MAX_TOTAL_TEXT_LENGTH) {
+            return null;
+        }
+        if (collapsed !== '') {
+            pushText(collapsed, marks);
+        }
+    }
+    const first = runs[0];
+    if (first !== undefined && first.type === 'text') {
+        runs[0] = { ...first, text: first.text.replace(/^ +/, '') };
+    }
+    const last = runs[runs.length - 1];
+    if (last !== undefined && last.type === 'text') {
+        runs[runs.length - 1] = { ...last, text: last.text.replace(/ +$/, '') };
+    }
+    return runs.filter((run) => run.type !== 'text' || run.text !== '');
+}
+function normalizeInlineList(value, limits) {
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    const items = [];
+    for (const item of value) {
+        const inline = normalizeInline(item, limits);
+        if (inline === null) {
+            return null;
+        }
+        items.push(inline);
+    }
+    return items;
+}
+function normalizeBlock(value, depth, limits) {
+    if (depth > exports.RICH_MAX_DEPTH) {
+        return null;
+    }
+    if (!isRecord(value) || typeof value.type !== 'string') {
+        return null;
+    }
+    limits.nodes += 1;
+    if (limits.nodes > exports.RICH_MAX_NODE_COUNT) {
+        return null;
+    }
+    switch (value.type) {
+        case 'paragraph': {
+            const content = normalizeInline(value.content, limits);
+            return content === null || content.length === 0 ? null : { type: 'paragraph', content };
+        }
+        case 'heading': {
+            const level = value.level;
+            if (typeof level !== 'number' || !Number.isInteger(level) || level < 1 || level > 6) {
+                return null;
+            }
+            const content = normalizeInline(value.content, limits);
+            return content === null || content.length === 0
+                ? null
+                : { type: 'heading', level: level, content };
+        }
+        case 'bulletList': {
+            const items = normalizeInlineList(value.items, limits);
+            return items === null || items.length === 0 ? null : { type: 'bulletList', items };
+        }
+        case 'blockquote': {
+            if (!Array.isArray(value.paragraphs)) {
+                return null;
+            }
+            const paragraphs = [];
+            for (const paragraph of value.paragraphs) {
+                const inline = normalizeInline(paragraph, limits);
+                if (inline === null || inline.length === 0) {
+                    return null;
+                }
+                paragraphs.push(inline);
+            }
+            return paragraphs.length === 0 ? null : { type: 'blockquote', paragraphs };
+        }
+        default:
+            return null;
+    }
+}
+function canonicalizeRichDocument(value) {
+    if (!isRecord(value) || value.version !== exports.RICH_DOCUMENT_VERSION || !Array.isArray(value.blocks)) {
+        return null;
+    }
+    if (value.blocks.length > exports.RICH_MAX_BLOCK_COUNT) {
+        return null;
+    }
+    const limits = { nodes: 0, totalText: 0 };
+    const blocks = [];
+    for (const block of value.blocks) {
+        const normalized = normalizeBlock(block, 1, limits);
+        if (normalized === null) {
+            return null;
+        }
+        blocks.push(normalized);
+    }
+    if (blocks.length === 0) {
+        return null;
+    }
+    return { version: exports.RICH_DOCUMENT_VERSION, blocks };
+}
+function richDocumentFingerprint(document) {
+    const canonical = canonicalizeRichDocument(document);
+    return canonical === null ? null : JSON.stringify(canonical);
+}
+//# sourceMappingURL=external-rich-document.js.map