@contrail/documents 2.5.0-alpha.fe0fdf8 → 2.5.0

package/CHANGELOG.md

@@ -5,14 +5,16 @@ All notable changes to `@contrail/documents` are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.5.0] - 2026-10-07
+## [2.5.0] - 2026-10-10
 
 Also shipped on the 1.x line as 1.22.0.
 
 ### Added
 
-- `DocumentChange.keepSortIndex`: set on an add to keep the sortIndex its element carries when no
-  element holds it, instead of appending it on top.
+- `clientCreatedOn` on `WriteTransactionRequest`, `DocumentTransactionPayload`, and
+  `DocumentTransactionMessage`: when the writing client created the transaction (ISO 8601, client
+  clock). The server stores it with the transaction and passes it through in the broadcast, so a
+  receiver can measure how long the edit took to reach it.
 
 ## [2.4.0] - 2026-09-26
 

package/lib/types/document-change.d.ts

@@ -19,5 +19,4 @@ export interface DocumentChange {
     targetSortIndex?: number;
     skipUndo?: boolean;
     gestureId?: string;
-    keepSortIndex?: boolean;
 }

package/lib/types/document-transaction.d.ts

@@ -13,6 +13,7 @@ export type DocumentOperation = {
 export type DocumentElementPatch = Partial<Omit<DocumentElement, 'id' | 'documentId'>>;
 interface WriteTransactionRequestBase {
     clientTransactionId?: string;
+    clientCreatedOn?: string;
 }
 export interface InlineWriteTransactionRequest extends WriteTransactionRequestBase {
     operations: DocumentOperation[];
@@ -53,6 +54,7 @@ interface DocumentTransactionMessageBase {
     sequenceNumber: number;
     createdOn: string;
     clientTransactionId?: string;
+    clientCreatedOn?: string;
 }
 export type DocumentTransactionMessage = (DocumentTransactionMessageBase & {
     operations: DocumentOperation[];
@@ -68,6 +70,7 @@ export interface TransactionUploadTarget {
 }
 export type DocumentTransactionPayload = {
     clientTransactionId?: string;
+    clientCreatedOn?: string;
 } & ({
     operations: DocumentOperation[];
     operationsS3Key?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/documents",
-  "version": "2.5.0-alpha.fe0fdf8",
+  "version": "2.5.0",
   "description": "Documents library for contrail platform",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",