pushwork 2.0.0-preview.2 → 2.0.0-preview.4

package/dist/utils/text-diff.d.ts

@@ -0,0 +1,37 @@
+import * as A from "@automerge/automerge";
+/**
+ * Read content from an Automerge document, normalizing legacy ImmutableString
+ * values to plain strings for backwards compatibility.
+ *
+ * Old documents may store text as ImmutableString. This helper ensures callers
+ * always get back `string | Uint8Array | null`.
+ */
+export declare function readDocContent(content: unknown): string | Uint8Array | null;
+/**
+ * Update text content on an Automerge document property inside a change
+ * callback.
+ *
+ * If the existing value is already a collaborative text string, we diff and
+ * splice for minimal CRDT operations.  If the existing value is a legacy
+ * ImmutableString we can't splice into it, so we assign the whole string
+ * which converts the field to a collaborative text CRDT going forward.
+ *
+ * @param doc  - The mutable Automerge document (inside a change callback)
+ * @param path - Property path to the text field, e.g. ["content"]
+ * @param newContent - The desired new text value
+ */
+export declare function updateTextContent(doc: any, path: A.Prop[], newContent: string): void;
+/**
+ * Apply a text diff between oldContent and newContent as Automerge splice
+ * operations on the given document property path.
+ *
+ * This preserves the collaborative text CRDT structure by making minimal
+ * character-level edits rather than replacing the entire string.
+ *
+ * @param doc - The Automerge document (inside a change callback)
+ * @param path - The property path to the text field, e.g. ["content"]
+ * @param oldContent - The previous text content
+ * @param newContent - The desired new text content
+ */
+export declare function spliceText(doc: any, path: A.Prop[], oldContent: string, newContent: string): void;
+//# sourceMappingURL=text-diff.d.ts.map

package/dist/utils/text-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-diff.d.ts","sourceRoot":"","sources":["../../src/utils/text-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,sBAAsB,CAAA;AAGzC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAO3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EACd,UAAU,EAAE,MAAM,GAChB,IAAI,CAeN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAChB,IAAI,CA8BN"}

package/dist/utils/text-diff.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDocContent = readDocContent;
+exports.updateTextContent = updateTextContent;
+exports.spliceText = spliceText;
+const A = __importStar(require("@automerge/automerge"));
+const diffLib = __importStar(require("diff"));
+/**
+ * Read content from an Automerge document, normalizing legacy ImmutableString
+ * values to plain strings for backwards compatibility.
+ *
+ * Old documents may store text as ImmutableString. This helper ensures callers
+ * always get back `string | Uint8Array | null`.
+ */
+function readDocContent(content) {
+    if (content == null)
+        return null;
+    if (typeof content === "string")
+        return content;
+    if (content instanceof Uint8Array)
+        return content;
+    // Legacy ImmutableString — convert to plain string
+    if (A.isImmutableString(content))
+        return content.toString();
+    return null;
+}
+/**
+ * Update text content on an Automerge document property inside a change
+ * callback.
+ *
+ * If the existing value is already a collaborative text string, we diff and
+ * splice for minimal CRDT operations.  If the existing value is a legacy
+ * ImmutableString we can't splice into it, so we assign the whole string
+ * which converts the field to a collaborative text CRDT going forward.
+ *
+ * @param doc  - The mutable Automerge document (inside a change callback)
+ * @param path - Property path to the text field, e.g. ["content"]
+ * @param newContent - The desired new text value
+ */
+function updateTextContent(doc, path, newContent) {
+    const target = path.reduce((obj, key) => obj?.[key], doc);
+    if (typeof target === "string") {
+        // Already a collaborative text string — diff and splice
+        spliceText(doc, path, target, newContent);
+    }
+    else {
+        // Legacy ImmutableString, undefined, or other — assign directly.
+        // This converts the field to a collaborative text CRDT.
+        let obj = doc;
+        for (let i = 0; i < path.length - 1; i++) {
+            obj = obj[path[i]];
+        }
+        obj[path[path.length - 1]] = newContent;
+    }
+}
+/**
+ * Apply a text diff between oldContent and newContent as Automerge splice
+ * operations on the given document property path.
+ *
+ * This preserves the collaborative text CRDT structure by making minimal
+ * character-level edits rather than replacing the entire string.
+ *
+ * @param doc - The Automerge document (inside a change callback)
+ * @param path - The property path to the text field, e.g. ["content"]
+ * @param oldContent - The previous text content
+ * @param newContent - The desired new text content
+ */
+function spliceText(doc, path, oldContent, newContent) {
+    if (oldContent === newContent)
+        return;
+    // Fast path: if old is empty, just insert everything
+    if (oldContent === "") {
+        A.splice(doc, path, 0, 0, newContent);
+        return;
+    }
+    // Fast path: if new is empty, just delete everything
+    if (newContent === "") {
+        A.splice(doc, path, 0, oldContent.length);
+        return;
+    }
+    const changes = diffLib.diffChars(oldContent, newContent);
+    let pos = 0;
+    for (const part of changes) {
+        if (part.removed) {
+            A.splice(doc, path, pos, part.value.length);
+            // Don't advance pos — text shifted left after deletion
+        }
+        else if (part.added) {
+            A.splice(doc, path, pos, 0, part.value);
+            pos += part.value.length;
+        }
+        else {
+            // Unchanged text — just advance the cursor
+            pos += part.value.length;
+        }
+    }
+}
+//# sourceMappingURL=text-diff.js.map

package/dist/utils/text-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-diff.js","sourceRoot":"","sources":["../../src/utils/text-diff.ts"],"names":[],"mappings":"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"}

package/dist/utils/trace.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Enable or disable tracing
+ */
+export declare function setTracingEnabled(enabled: boolean): void;
+/**
+ * Check if tracing is enabled
+ */
+export declare function isTracingEnabled(): boolean;
+/**
+ * Trace a span of work by outputting to console
+ * Works for both sync and async functions
+ * Only outputs if tracing is enabled
+ *
+ * Usage:
+ *   await span("operation", async () => { ... })
+ *   span("operation", () => { ... })
+ */
+export declare function span<T>(name: string, fn: () => T | Promise<T>): T | Promise<T>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/utils/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBhB"}

package/dist/utils/trace.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTracingEnabled = setTracingEnabled;
+exports.isTracingEnabled = isTracingEnabled;
+exports.span = span;
+const output_1 = require("./output");
+/**
+ * Global tracing state
+ */
+let tracingEnabled = false;
+/**
+ * Enable or disable tracing
+ */
+function setTracingEnabled(enabled) {
+    tracingEnabled = enabled;
+}
+/**
+ * Check if tracing is enabled
+ */
+function isTracingEnabled() {
+    return tracingEnabled;
+}
+/**
+ * Trace a span of work by outputting to console
+ * Works for both sync and async functions
+ * Only outputs if tracing is enabled
+ *
+ * Usage:
+ *   await span("operation", async () => { ... })
+ *   span("operation", () => { ... })
+ */
+function span(name, fn) {
+    if (!tracingEnabled) {
+        return fn();
+    }
+    const start = performance.now();
+    const result = fn();
+    // Check if it's a promise (async)
+    if (result instanceof Promise) {
+        return result.then((value) => {
+            const duration = performance.now() - start;
+            output_1.out.taskLine(`${name} (${formatDuration(duration)})`, true);
+            return value;
+        });
+    }
+    // Sync case
+    const duration = performance.now() - start;
+    output_1.out.taskLine(`${name} (${formatDuration(duration)})`, true);
+    return result;
+}
+/**
+ * Format duration for display
+ */
+function formatDuration(ms) {
+    if (ms < 1) {
+        return `${ms.toFixed(2)}ms`;
+    }
+    else if (ms < 1000) {
+        return `${Math.round(ms)}ms`;
+    }
+    else if (ms < 2000) {
+        return `${(ms / 1000).toFixed(2)}s`;
+    }
+    else {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+}
+//# sourceMappingURL=trace.js.map

package/dist/utils/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/utils/trace.ts"],"names":[],"mappings":";;AAUA,8CAEC;AAKD,4CAEC;AAWD,oBAwBC;AAtDD,qCAA+B;AAE/B;;GAEG;AACH,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B;;GAEG;AACH,SAAgB,iBAAiB,CAAC,OAAgB;IAChD,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,IAAI,CAClB,IAAY,EACZ,EAAwB;IAExB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;IAEpB,kCAAkC;IAClC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAC3C,YAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,cAAc,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC,CAAM,CAAC;IACV,CAAC;IAED,YAAY;IACZ,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAC3C,YAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,cAAc,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACX,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9B,CAAC;SAAM,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACrB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IAC/B,CAAC;SAAM,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pushwork",
-  "version": "2.0.0-preview.2",
+  "version": "2.0.0-preview.4",
   "description": "Bidirectional directory synchronization using Automerge CRDTs",
   "main": "dist/index.js",
   "exports": {