@yorkie-js/sdk 0.7.6 → 0.7.8

package/README.md

@@ -10,7 +10,7 @@ To get started using Yorkie JavaScript SDK, see: https://yorkie.dev/docs/js-sdk
 
 ## Contributing
 
-See [CONTRIBUTING](CONTRIBUTING.md) for details on submitting patches and the contribution workflow.
+See [CONTRIBUTING](../../CONTRIBUTING.md) for details on submitting patches and the contribution workflow.
 
 ## Contributors ✨
 

package/dist/yorkie-js-sdk.d.ts

@@ -93,20 +93,30 @@ declare interface Attachable {
 /**
  * `AttachChannelOptions` are user-settable options used when attaching channels.
  */
-declare interface AttachChannelOptions {
+export declare interface AttachChannelOptions {
     /**
-     * `isRealtime` determines whether to automatically watch channel changes
-     * and send heartbeats. If false (manual mode), the client must call sync()
-     * explicitly to refresh the TTL.
-     * Default is true for backward compatibility.
+     * `syncMode` selects how the channel keeps presence in sync with the server.
+     * Default is `SyncMode.Realtime`.
+     * - `SyncMode.Realtime`: open a watch stream and run the heartbeat. Required
+     *   to receive broadcast events.
+     * - `SyncMode.Polling`: heartbeat-only. No watch stream is opened. The
+     *   heartbeat refreshes TTL and brings the latest sessionCount. Recommended
+     *   for large channels where broadcast is not needed.
+     * - `SyncMode.Manual`: no automatic activity. Caller must invoke `sync()`.
      */
-    isRealtime?: boolean;
+    syncMode?: SyncMode;
+    /**
+     * `channelHeartbeatInterval` overrides the heartbeat interval (ms) for this
+     * attachment. If unset, mode-specific defaults apply: Polling=3000,
+     * Realtime=30000.
+     */
+    channelHeartbeatInterval?: number;
 }
 
 /**
  * `AttachOptions` are user-settable options used when attaching documents.
  */
-declare interface AttachOptions<R, P> {
+export declare interface AttachOptions<R, P> {
     /**
      * `initialRoot` is the initial root of the document. It is used to
      * initialize the document. It is used when the fields are not set in the
@@ -121,6 +131,11 @@ declare interface AttachOptions<R, P> {
      * `syncMode` defines the synchronization mode of the document.
      */
     syncMode?: SyncMode;
+    /**
+     * `documentPollInterval` (ms) — only used when `syncMode` is `Polling`.
+     * Default: 3000.
+     */
+    documentPollInterval?: number;
     /**
      * `schema` is the schema of the document. It is used to validate the
      * document.
@@ -1039,6 +1054,17 @@ export declare class Client {
      * `changeSyncMode` changes the synchronization mode of the given document.
      */
     changeSyncMode<R, P extends Indexable>(doc: Document_2<R, P>, syncMode: SyncMode): Promise<Document_2<R, P>>;
+    /**
+     * `changeSyncMode` changes the synchronization mode of the given channel.
+     */
+    changeSyncMode(channel: Channel, syncMode: SyncMode): Promise<Channel>;
+    private changeDocumentSyncMode;
+    /**
+     * `assertValidChannelSyncMode` rejects sync modes that are not valid for
+     * channels. `RealtimePushOnly` and `RealtimeSyncOff` are document-only.
+     */
+    private assertValidChannelSyncMode;
+    private changeChannelSyncMode;
     /**
      * `sync` pushes local changes of the attached documents to the server and
      * receives changes of the remote replica from the server then apply them to
@@ -1997,12 +2023,28 @@ declare class CRDTTree extends CRDTElement implements GCParent {
      * `edit` edits the tree with the given range and content.
      * If the content is undefined, the range will be removed.
      */
-    edit(range: [CRDTTreePos, CRDTTreePos], contents: Array<CRDTTreeNode> | undefined, splitLevel: number, editedAt: TimeTicket, issueTimeTicket: (() => TimeTicket) | undefined, versionVector?: VersionVector): [Array<TreeChange>, Array<GCPair>, DataSize, Array<CRDTTreeNode>, number];
+    edit(range: [CRDTTreePos, CRDTTreePos], contents: Array<CRDTTreeNode> | undefined, splitLevel: number, editedAt: TimeTicket, issueTimeTicket: (() => TimeTicket) | undefined, versionVector?: VersionVector): [
+    Array<TreeChange>,
+    Array<GCPair>,
+    DataSize,
+    Array<CRDTTreeNode>,
+    number,
+    number,
+    Set<string>
+    ];
     /**
      * `editT` edits the given range with the given value.
      * This method uses indexes instead of a pair of TreePos for testing.
      */
-    editT(range: [number, number], contents: Array<CRDTTreeNode> | undefined, splitLevel: number, editedAt: TimeTicket, issueTimeTicket: () => TimeTicket): [Array<TreeChange>, Array<GCPair>, DataSize, Array<CRDTTreeNode>, number];
+    editT(range: [number, number], contents: Array<CRDTTreeNode> | undefined, splitLevel: number, editedAt: TimeTicket, issueTimeTicket: () => TimeTicket): [
+    Array<TreeChange>,
+    Array<GCPair>,
+    DataSize,
+    Array<CRDTTreeNode>,
+    number,
+    number,
+    Set<string>
+    ];
     /**
      * `move` move the given source range to the given target range.
      */
@@ -3035,7 +3077,12 @@ declare class Document_2<R, P extends Indexable = Indexable> implements Attachab
      * `applySnapshot` applies the given snapshot into this document.
      */
     applySnapshot(serverSeq: bigint, snapshotVector: VersionVector, snapshot?: Uint8Array, clientSeq?: number): void;
-    private clearHistory;
+    /**
+     * `clearHistory` flushes both undo and redo stacks. This is used
+     * after applying a snapshot or initialRoot so that setup operations
+     * are not reachable via undo.
+     */
+    clearHistory(): void;
     /**
      * `applyChanges` applies the given changes into this document.
      */
@@ -3716,6 +3763,19 @@ declare function isDate(value: any): value is YSONDate {
     );
 }
 
+/**
+ * `isDedupCounter` checks if a value is a YSONDedupCounter object.
+ */
+declare function isDedupCounter(value: any): value is YSONDedupCounter {
+    return (
+    typeof value === 'object' &&
+    value !== null &&
+    value.type === 'DedupCounter' &&
+    typeof value.value === 'object' &&
+    typeof value.registers === 'string'
+    );
+}
+
 /**
  * `isDocEventForReplay` checks if an event can be used to replay a document.
  */
@@ -3783,7 +3843,8 @@ declare function isObject(value: any): value is { [key: string]: YSONValue } {
     !isLong(value) &&
     !isDate(value) &&
     !isBinData(value) &&
-    !isCounter(value)
+    !isCounter(value) &&
+    !isDedupCounter(value)
     );
 }
 
@@ -5991,7 +6052,8 @@ declare interface SubscribeFn<T> {
 }
 
 /**
- * `SyncMode` defines synchronization modes for the PushPullChanges API.
+ * `SyncMode` defines synchronization modes for the PushPullChanges API
+ * (documents) and the RefreshChannel heartbeat (channels).
  */
 export declare enum SyncMode {
     /**
@@ -6010,7 +6072,15 @@ export declare enum SyncMode {
      * `RealtimeSyncOff` mode indicates that changes are not automatically pushed or pulled,
      * but the watch stream is kept active.
      */
-    RealtimeSyncOff = "realtime-syncoff"
+    RealtimeSyncOff = "realtime-syncoff",
+    /**
+     * `Polling` mode runs the sync loop without opening a watch stream.
+     * - For Channel: heartbeat refreshes TTL and brings sessionCount.
+     * - For Document: PushPullChanges runs at the polling interval. Remote
+     *   changes arrive on the next tick (latency = interval). Not suitable
+     *   for collaborative editing — use Realtime for that.
+     */
+    Polling = "polling"
 }
 
 /**
@@ -7019,6 +7089,7 @@ declare namespace YSON {
         YSONDate as Date,
         YSONBinData as BinData,
         YSONCounter as Counter,
+        YSONDedupCounter as DedupCounter,
         isText,
         isTree,
         isInt,
@@ -7026,6 +7097,7 @@ declare namespace YSON {
         isDate,
         isBinData,
         isCounter,
+        isDedupCounter,
         isObject,
         parse,
         textToString,
@@ -7073,6 +7145,21 @@ declare interface YSONDate {
     value: string;
 }
 
+/**
+ * `YSONDedupCounter` represents a DedupCounter CRDT that uses HyperLogLog
+ * to count unique actors.
+ *
+ * @example
+ * ```typescript
+ * { type: 'DedupCounter', value: { type: 'Int', value: 15 }, registers: 'AQID...' }
+ * ```
+ */
+declare interface YSONDedupCounter {
+    type: 'DedupCounter';
+    value: YSONInt;
+    registers: string;
+}
+
 /**
  * `YSONInt` represents a 32-bit integer.
  *
@@ -7209,6 +7296,7 @@ declare type YSONValue =
 | YSONDate
 | YSONBinData
 | YSONCounter
+| YSONDedupCounter
 | { [key: string]: YSONValue }
 | Array<YSONValue>;