@objectstack/spec 0.6.1 → 0.7.2

package/dist/system/collaboration.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration.zod.d.ts","sourceRoot":"","sources":["../../src/system/collaboration.zod.ts"],"names":[],"mappings":"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"}

package/dist/system/collaboration.zod.js

@@ -0,0 +1,392 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollaborationSessionSchema = exports.CollaborationSessionConfigSchema = exports.CollaborationMode = exports.AwarenessEventSchema = exports.AwarenessUpdateSchema = exports.AwarenessSessionSchema = exports.AwarenessUserStateSchema = exports.UserActivityStatus = exports.CursorUpdateSchema = exports.CollaborativeCursorSchema = exports.CursorSelectionSchema = exports.CursorStyleSchema = exports.CursorColorPreset = exports.CRDTMergeResultSchema = exports.CRDTStateSchema = exports.TextCRDTStateSchema = exports.TextCRDTOperationSchema = exports.ORSetSchema = exports.ORSetElementSchema = exports.PNCounterSchema = exports.GCounterSchema = exports.CounterOperationSchema = exports.LWWRegisterSchema = exports.VectorClockSchema = exports.CRDTType = exports.OTTransformResultSchema = exports.OTOperationSchema = exports.OTComponentSchema = exports.OTOperationType = void 0;
+const zod_1 = require("zod");
+/**
+ * Real-Time Collaboration Protocol
+ *
+ * Defines schemas for real-time collaborative editing in ObjectStack.
+ * Supports Operational Transformation (OT), CRDT (Conflict-free Replicated Data Types),
+ * cursor sharing, and awareness state for collaborative applications.
+ *
+ * Industry alignment: Google Docs, Figma, VSCode Live Share, Yjs
+ */
+// ==========================================
+// Operational Transformation (OT)
+// ==========================================
+/**
+ * OT Operation Type Enum
+ * Types of operations in Operational Transformation
+ */
+exports.OTOperationType = zod_1.z.enum([
+    'insert', // Insert characters at position
+    'delete', // Delete characters at position
+    'retain', // Keep characters (used for composing operations)
+]);
+/**
+ * OT Operation Component
+ * Single component of an OT operation
+ */
+exports.OTComponentSchema = zod_1.z.discriminatedUnion('type', [
+    zod_1.z.object({
+        type: zod_1.z.literal('insert'),
+        text: zod_1.z.string().describe('Text to insert'),
+        attributes: zod_1.z.record(zod_1.z.any()).optional().describe('Text formatting attributes (e.g., bold, italic)'),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal('delete'),
+        count: zod_1.z.number().int().positive().describe('Number of characters to delete'),
+    }),
+    zod_1.z.object({
+        type: zod_1.z.literal('retain'),
+        count: zod_1.z.number().int().positive().describe('Number of characters to retain'),
+        attributes: zod_1.z.record(zod_1.z.any()).optional().describe('Attribute changes to apply'),
+    }),
+]);
+/**
+ * OT Operation Schema
+ * Represents a complete OT operation
+ * Based on the OT algorithm used by Google Docs and other collaborative editors
+ */
+exports.OTOperationSchema = zod_1.z.object({
+    operationId: zod_1.z.string().uuid().describe('Unique operation identifier'),
+    documentId: zod_1.z.string().describe('Document identifier'),
+    userId: zod_1.z.string().describe('User who created the operation'),
+    sessionId: zod_1.z.string().uuid().describe('Session identifier'),
+    components: zod_1.z.array(exports.OTComponentSchema).describe('Operation components'),
+    baseVersion: zod_1.z.number().int().nonnegative().describe('Document version this operation is based on'),
+    timestamp: zod_1.z.string().datetime().describe('ISO 8601 datetime when operation was created'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Additional operation metadata'),
+});
+/**
+ * OT Transform Result
+ * Result of transforming one operation against another
+ */
+exports.OTTransformResultSchema = zod_1.z.object({
+    operation: exports.OTOperationSchema.describe('Transformed operation'),
+    transformed: zod_1.z.boolean().describe('Whether transformation was applied'),
+    conflicts: zod_1.z.array(zod_1.z.string()).optional().describe('Conflict descriptions if any'),
+});
+// ==========================================
+// CRDT (Conflict-free Replicated Data Types)
+// ==========================================
+/**
+ * CRDT Type Enum
+ * Types of CRDTs supported
+ */
+exports.CRDTType = zod_1.z.enum([
+    'lww-register', // Last-Write-Wins Register
+    'g-counter', // Grow-only Counter
+    'pn-counter', // Positive-Negative Counter
+    'g-set', // Grow-only Set
+    'or-set', // Observed-Remove Set
+    'lww-map', // Last-Write-Wins Map
+    'text', // CRDT-based Text (e.g., Yjs, Automerge)
+    'tree', // CRDT-based Tree structure
+    'json', // CRDT-based JSON (e.g., Automerge)
+]);
+/**
+ * Vector Clock Schema
+ * Tracks causality in distributed systems
+ */
+exports.VectorClockSchema = zod_1.z.object({
+    clock: zod_1.z.record(zod_1.z.number().int().nonnegative()).describe('Map of replica ID to logical timestamp'),
+});
+/**
+ * LWW-Register Schema
+ * Last-Write-Wins Register CRDT
+ */
+exports.LWWRegisterSchema = zod_1.z.object({
+    type: zod_1.z.literal('lww-register'),
+    value: zod_1.z.any().describe('Current register value'),
+    timestamp: zod_1.z.string().datetime().describe('ISO 8601 datetime of last write'),
+    replicaId: zod_1.z.string().describe('ID of replica that performed last write'),
+    vectorClock: exports.VectorClockSchema.optional().describe('Optional vector clock for causality tracking'),
+});
+/**
+ * Counter Operation Schema
+ * Operations for Counter CRDTs
+ */
+exports.CounterOperationSchema = zod_1.z.object({
+    replicaId: zod_1.z.string().describe('Replica identifier'),
+    delta: zod_1.z.number().int().describe('Change amount (positive for increment, negative for decrement)'),
+    timestamp: zod_1.z.string().datetime().describe('ISO 8601 datetime of operation'),
+});
+/**
+ * G-Counter Schema
+ * Grow-only Counter CRDT
+ */
+exports.GCounterSchema = zod_1.z.object({
+    type: zod_1.z.literal('g-counter'),
+    counts: zod_1.z.record(zod_1.z.number().int().nonnegative()).describe('Map of replica ID to count'),
+});
+/**
+ * PN-Counter Schema
+ * Positive-Negative Counter CRDT (supports increment and decrement)
+ */
+exports.PNCounterSchema = zod_1.z.object({
+    type: zod_1.z.literal('pn-counter'),
+    positive: zod_1.z.record(zod_1.z.number().int().nonnegative()).describe('Positive increments per replica'),
+    negative: zod_1.z.record(zod_1.z.number().int().nonnegative()).describe('Negative increments per replica'),
+});
+/**
+ * OR-Set Element Schema
+ * Element in an Observed-Remove Set
+ */
+exports.ORSetElementSchema = zod_1.z.object({
+    value: zod_1.z.any().describe('Element value'),
+    timestamp: zod_1.z.string().datetime().describe('Addition timestamp'),
+    replicaId: zod_1.z.string().describe('Replica that added the element'),
+    uid: zod_1.z.string().uuid().describe('Unique identifier for this addition'),
+    removed: zod_1.z.boolean().optional().default(false).describe('Whether element has been removed'),
+});
+/**
+ * OR-Set Schema
+ * Observed-Remove Set CRDT
+ */
+exports.ORSetSchema = zod_1.z.object({
+    type: zod_1.z.literal('or-set'),
+    elements: zod_1.z.array(exports.ORSetElementSchema).describe('Set elements with metadata'),
+});
+/**
+ * Text CRDT Operation Schema
+ * Operations for text-based CRDTs (e.g., Yjs, Automerge)
+ */
+exports.TextCRDTOperationSchema = zod_1.z.object({
+    operationId: zod_1.z.string().uuid().describe('Unique operation identifier'),
+    replicaId: zod_1.z.string().describe('Replica identifier'),
+    position: zod_1.z.number().int().nonnegative().describe('Position in document'),
+    insert: zod_1.z.string().optional().describe('Text to insert'),
+    delete: zod_1.z.number().int().positive().optional().describe('Number of characters to delete'),
+    timestamp: zod_1.z.string().datetime().describe('ISO 8601 datetime of operation'),
+    lamportTimestamp: zod_1.z.number().int().nonnegative().describe('Lamport timestamp for ordering'),
+});
+/**
+ * Text CRDT State Schema
+ * State of a text-based CRDT document
+ */
+exports.TextCRDTStateSchema = zod_1.z.object({
+    type: zod_1.z.literal('text'),
+    documentId: zod_1.z.string().describe('Document identifier'),
+    content: zod_1.z.string().describe('Current text content'),
+    operations: zod_1.z.array(exports.TextCRDTOperationSchema).describe('History of operations'),
+    lamportClock: zod_1.z.number().int().nonnegative().describe('Current Lamport clock value'),
+    vectorClock: exports.VectorClockSchema.describe('Vector clock for causality'),
+});
+/**
+ * CRDT State Union
+ * Discriminated union of all CRDT types
+ */
+exports.CRDTStateSchema = zod_1.z.discriminatedUnion('type', [
+    exports.LWWRegisterSchema,
+    exports.GCounterSchema,
+    exports.PNCounterSchema,
+    exports.ORSetSchema,
+    exports.TextCRDTStateSchema,
+]);
+/**
+ * CRDT Merge Schema
+ * Result of merging two CRDT states
+ */
+exports.CRDTMergeResultSchema = zod_1.z.object({
+    state: exports.CRDTStateSchema.describe('Merged CRDT state'),
+    conflicts: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.string().describe('Conflict type'),
+        description: zod_1.z.string().describe('Conflict description'),
+        resolved: zod_1.z.boolean().describe('Whether conflict was automatically resolved'),
+    })).optional().describe('Conflicts encountered during merge'),
+});
+// ==========================================
+// Cursor Sharing
+// ==========================================
+/**
+ * Cursor Color Preset Enum
+ * Standard color presets for cursor visualization
+ */
+exports.CursorColorPreset = zod_1.z.enum([
+    'blue',
+    'green',
+    'red',
+    'yellow',
+    'purple',
+    'orange',
+    'pink',
+    'teal',
+    'indigo',
+    'cyan',
+]);
+/**
+ * Cursor Style Schema
+ * Visual styling for collaborative cursors
+ */
+exports.CursorStyleSchema = zod_1.z.object({
+    color: zod_1.z.union([exports.CursorColorPreset, zod_1.z.string()]).describe('Cursor color (preset or custom hex)'),
+    opacity: zod_1.z.number().min(0).max(1).optional().default(1).describe('Cursor opacity (0-1)'),
+    label: zod_1.z.string().optional().describe('Label to display with cursor (usually username)'),
+    showLabel: zod_1.z.boolean().optional().default(true).describe('Whether to show label'),
+    pulseOnUpdate: zod_1.z.boolean().optional().default(true).describe('Whether to pulse when cursor moves'),
+});
+/**
+ * Cursor Selection Schema
+ * Represents a text selection in collaborative editing
+ */
+exports.CursorSelectionSchema = zod_1.z.object({
+    anchor: zod_1.z.object({
+        line: zod_1.z.number().int().nonnegative().describe('Anchor line number'),
+        column: zod_1.z.number().int().nonnegative().describe('Anchor column number'),
+    }).describe('Selection anchor (start point)'),
+    focus: zod_1.z.object({
+        line: zod_1.z.number().int().nonnegative().describe('Focus line number'),
+        column: zod_1.z.number().int().nonnegative().describe('Focus column number'),
+    }).describe('Selection focus (end point)'),
+    direction: zod_1.z.enum(['forward', 'backward']).optional().describe('Selection direction'),
+});
+/**
+ * Collaborative Cursor Schema
+ * Complete cursor state for a collaborative user
+ */
+exports.CollaborativeCursorSchema = zod_1.z.object({
+    userId: zod_1.z.string().describe('User identifier'),
+    sessionId: zod_1.z.string().uuid().describe('Session identifier'),
+    documentId: zod_1.z.string().describe('Document identifier'),
+    userName: zod_1.z.string().describe('Display name of user'),
+    position: zod_1.z.object({
+        line: zod_1.z.number().int().nonnegative().describe('Cursor line number (0-indexed)'),
+        column: zod_1.z.number().int().nonnegative().describe('Cursor column number (0-indexed)'),
+    }).describe('Current cursor position'),
+    selection: exports.CursorSelectionSchema.optional().describe('Current text selection'),
+    style: exports.CursorStyleSchema.describe('Visual style for this cursor'),
+    isTyping: zod_1.z.boolean().optional().default(false).describe('Whether user is currently typing'),
+    lastUpdate: zod_1.z.string().datetime().describe('ISO 8601 datetime of last cursor update'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Additional cursor metadata'),
+});
+/**
+ * Cursor Update Schema
+ * Update to a collaborative cursor
+ */
+exports.CursorUpdateSchema = zod_1.z.object({
+    position: zod_1.z.object({
+        line: zod_1.z.number().int().nonnegative(),
+        column: zod_1.z.number().int().nonnegative(),
+    }).optional().describe('Updated cursor position'),
+    selection: exports.CursorSelectionSchema.optional().describe('Updated selection'),
+    isTyping: zod_1.z.boolean().optional().describe('Updated typing state'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Updated metadata'),
+});
+// ==========================================
+// Awareness State
+// ==========================================
+/**
+ * User Activity Status Enum
+ * User activity status for awareness
+ */
+exports.UserActivityStatus = zod_1.z.enum([
+    'active', // User is actively editing
+    'idle', // User is idle but connected
+    'viewing', // User is viewing but not editing
+    'disconnected', // User is disconnected
+]);
+/**
+ * Awareness User State Schema
+ * Tracks what a user is doing in the collaborative session
+ */
+exports.AwarenessUserStateSchema = zod_1.z.object({
+    userId: zod_1.z.string().describe('User identifier'),
+    sessionId: zod_1.z.string().uuid().describe('Session identifier'),
+    userName: zod_1.z.string().describe('Display name'),
+    userAvatar: zod_1.z.string().optional().describe('User avatar URL'),
+    status: exports.UserActivityStatus.describe('Current activity status'),
+    currentDocument: zod_1.z.string().optional().describe('Document ID user is currently editing'),
+    currentView: zod_1.z.string().optional().describe('Current view/page user is on'),
+    lastActivity: zod_1.z.string().datetime().describe('ISO 8601 datetime of last activity'),
+    joinedAt: zod_1.z.string().datetime().describe('ISO 8601 datetime when user joined session'),
+    permissions: zod_1.z.array(zod_1.z.string()).optional().describe('User permissions in this session'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Additional user state metadata'),
+});
+/**
+ * Awareness Session Schema
+ * Represents the complete awareness state for a collaboration session
+ */
+exports.AwarenessSessionSchema = zod_1.z.object({
+    sessionId: zod_1.z.string().uuid().describe('Session identifier'),
+    documentId: zod_1.z.string().optional().describe('Document ID this session is for'),
+    users: zod_1.z.array(exports.AwarenessUserStateSchema).describe('Active users in session'),
+    startedAt: zod_1.z.string().datetime().describe('ISO 8601 datetime when session started'),
+    lastUpdate: zod_1.z.string().datetime().describe('ISO 8601 datetime of last update'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Session metadata'),
+});
+/**
+ * Awareness Update Schema
+ * Update to awareness state
+ */
+exports.AwarenessUpdateSchema = zod_1.z.object({
+    status: exports.UserActivityStatus.optional().describe('Updated status'),
+    currentDocument: zod_1.z.string().optional().describe('Updated current document'),
+    currentView: zod_1.z.string().optional().describe('Updated current view'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Updated metadata'),
+});
+/**
+ * Awareness Event Schema
+ * Events that occur in awareness tracking
+ */
+exports.AwarenessEventSchema = zod_1.z.object({
+    eventId: zod_1.z.string().uuid().describe('Event identifier'),
+    sessionId: zod_1.z.string().uuid().describe('Session identifier'),
+    eventType: zod_1.z.enum([
+        'user.joined',
+        'user.left',
+        'user.updated',
+        'session.created',
+        'session.ended',
+    ]).describe('Type of awareness event'),
+    userId: zod_1.z.string().optional().describe('User involved in event'),
+    timestamp: zod_1.z.string().datetime().describe('ISO 8601 datetime of event'),
+    payload: zod_1.z.any().describe('Event payload'),
+});
+// ==========================================
+// Collaboration Session Management
+// ==========================================
+/**
+ * Collaboration Mode Enum
+ * Types of collaboration modes
+ */
+exports.CollaborationMode = zod_1.z.enum([
+    'ot', // Operational Transformation
+    'crdt', // CRDT-based
+    'lock', // Pessimistic locking (turn-based)
+    'hybrid', // Hybrid approach
+]);
+/**
+ * Collaboration Session Config
+ * Configuration for a collaboration session
+ */
+exports.CollaborationSessionConfigSchema = zod_1.z.object({
+    mode: exports.CollaborationMode.describe('Collaboration mode to use'),
+    enableCursorSharing: zod_1.z.boolean().optional().default(true).describe('Enable cursor sharing'),
+    enablePresence: zod_1.z.boolean().optional().default(true).describe('Enable presence tracking'),
+    enableAwareness: zod_1.z.boolean().optional().default(true).describe('Enable awareness state'),
+    maxUsers: zod_1.z.number().int().positive().optional().describe('Maximum concurrent users'),
+    idleTimeout: zod_1.z.number().int().positive().optional().default(300000).describe('Idle timeout in milliseconds'),
+    conflictResolution: zod_1.z.enum(['ot', 'crdt', 'manual']).optional().default('ot').describe('Conflict resolution strategy'),
+    persistence: zod_1.z.boolean().optional().default(true).describe('Enable operation persistence'),
+    snapshot: zod_1.z.object({
+        enabled: zod_1.z.boolean().describe('Enable periodic snapshots'),
+        interval: zod_1.z.number().int().positive().describe('Snapshot interval in milliseconds'),
+    }).optional().describe('Snapshot configuration'),
+});
+/**
+ * Collaboration Session Schema
+ * Complete collaboration session state
+ */
+exports.CollaborationSessionSchema = zod_1.z.object({
+    sessionId: zod_1.z.string().uuid().describe('Session identifier'),
+    documentId: zod_1.z.string().describe('Document identifier'),
+    config: exports.CollaborationSessionConfigSchema.describe('Session configuration'),
+    users: zod_1.z.array(exports.AwarenessUserStateSchema).describe('Active users'),
+    cursors: zod_1.z.array(exports.CollaborativeCursorSchema).describe('Active cursors'),
+    version: zod_1.z.number().int().nonnegative().describe('Current document version'),
+    operations: zod_1.z.array(zod_1.z.union([exports.OTOperationSchema, exports.TextCRDTOperationSchema])).optional().describe('Recent operations'),
+    createdAt: zod_1.z.string().datetime().describe('ISO 8601 datetime when session was created'),
+    lastActivity: zod_1.z.string().datetime().describe('ISO 8601 datetime of last activity'),
+    status: zod_1.z.enum(['active', 'idle', 'ended']).describe('Session status'),
+});