@livetemplate/client 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAUtE,UAAU,QAAQ;IAChB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,KAAK,EAAE,QAAQ,EACf,KAAK,GAAE,MAAM,EAAO,EACpB,IAAI,GAAE,OAAiB;IAG1C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,QAAQ,IAAI,QAAQ;IAIpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,cAAc,IAAI,OAAO;IAIzB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,OAAO,CAAC,GAAG;IAYX,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;CAOrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAYhE"}

package/dist/utils/logger.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+exports.createLogger = createLogger;
+const levelPriority = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+const DEFAULT_SCOPE = "LiveTemplate";
+/**
+ * Lightweight console logger with support for log levels and scoped prefixes.
+ */
+class Logger {
+    constructor(state, scope = [], sink = console) {
+        this.state = state;
+        this.scope = scope;
+        this.sink = sink;
+    }
+    setLevel(level) {
+        this.state.level = level;
+    }
+    getLevel() {
+        return this.state.level;
+    }
+    child(scope) {
+        return new Logger(this.state, [...this.scope, scope], this.sink);
+    }
+    isDebugEnabled() {
+        return this.shouldLog("debug");
+    }
+    error(...args) {
+        this.log("error", "error", args);
+    }
+    warn(...args) {
+        this.log("warn", "warn", args);
+    }
+    info(...args) {
+        this.log("info", "info", args);
+    }
+    debug(...args) {
+        this.log("debug", "debug", args);
+    }
+    log(level, method, args) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const target = this.sink[method] ||
+            console[method] ||
+            console.log;
+        target.apply(this.sink, [this.formatPrefix(), ...args]);
+    }
+    shouldLog(level) {
+        return levelPriority[level] <= levelPriority[this.state.level];
+    }
+    formatPrefix() {
+        if (this.scope.length === 0) {
+            return `[${DEFAULT_SCOPE}]`;
+        }
+        return `[${DEFAULT_SCOPE}:${this.scope.join(":")}]`;
+    }
+}
+exports.Logger = Logger;
+function createLogger(options = {}) {
+    const state = {
+        level: options.level ?? "info",
+    };
+    const scope = Array.isArray(options.scope)
+        ? options.scope
+        : options.scope
+            ? [options.scope]
+            : [];
+    return new Logger(state, scope, options.sink ?? console);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/rate-limit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Debounce function: delays execution until after a pause in calls
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function: limits execution to at most once per time period
+ * First call executes immediately, subsequent calls are delayed
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/utils/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../utils/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAclC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAelC"}

package/dist/utils/rate-limit.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debounce = debounce;
+exports.throttle = throttle;
+/**
+ * Debounce function: delays execution until after a pause in calls
+ */
+function debounce(func, wait) {
+    let timeout = null;
+    return function debounceWrapper(...args) {
+        const context = this;
+        if (timeout !== null) {
+            clearTimeout(timeout);
+        }
+        timeout = window.setTimeout(() => {
+            func.apply(context, args);
+        }, wait);
+    };
+}
+/**
+ * Throttle function: limits execution to at most once per time period
+ * First call executes immediately, subsequent calls are delayed
+ */
+function throttle(func, limit) {
+    let inThrottle = false;
+    return function throttleWrapper(...args) {
+        const context = this;
+        if (!inThrottle) {
+            func.apply(context, args);
+            inThrottle = true;
+            setTimeout(() => {
+                inThrottle = false;
+            }, limit);
+        }
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/utils/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../utils/rate-limit.ts"],"names":[],"mappings":";;AAGA,4BAiBC;AAMD,4BAkBC;AA5CD;;GAEG;AACH,SAAgB,QAAQ,CACtB,IAAO,EACP,IAAY;IAEZ,IAAI,OAAO,GAAkB,IAAI,CAAC;IAElC,OAAO,SAAS,eAAe,CAAgB,GAAG,IAAmB;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC;QAErB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,QAAQ,CACtB,IAAO,EACP,KAAa;IAEb,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,OAAO,SAAS,eAAe,CAAgB,GAAG,IAAmB;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC;QAErB,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1B,UAAU,GAAG,IAAI,CAAC;YAElB,UAAU,CAAC,GAAG,EAAE;gBACd,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/testing.d.ts

@@ -0,0 +1,14 @@
+import type { LiveTemplateClient } from "../livetemplate-client";
+import type { UpdateResult } from "../types";
+/**
+ * Utility function to load and apply updates from JSON files.
+ */
+export declare function loadAndApplyUpdate(client: LiveTemplateClient, updatePath: string): Promise<UpdateResult>;
+/**
+ * Compare two HTML strings, ignoring whitespace differences.
+ */
+export declare function compareHTML(expected: string, actual: string): {
+    match: boolean;
+    differences: string[];
+};
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../utils/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAevB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IACD,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CA8BA"}

package/dist/utils/testing.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAndApplyUpdate = loadAndApplyUpdate;
+exports.compareHTML = compareHTML;
+/**
+ * Utility function to load and apply updates from JSON files.
+ */
+async function loadAndApplyUpdate(client, updatePath) {
+    try {
+        const nodeRequire = globalThis?.require;
+        if (typeof nodeRequire === "function") {
+            const fs = nodeRequire("fs");
+            const updateData = JSON.parse(fs.readFileSync(updatePath, "utf8"));
+            return client.applyUpdate(updateData);
+        }
+        const response = await fetch(updatePath);
+        const updateData = await response.json();
+        return client.applyUpdate(updateData);
+    }
+    catch (error) {
+        throw new Error(`Failed to load update from ${updatePath}: ${error}`);
+    }
+}
+/**
+ * Compare two HTML strings, ignoring whitespace differences.
+ */
+function compareHTML(expected, actual) {
+    const differences = [];
+    const normalizeHTML = (html) => {
+        return html.replace(/\s+/g, " ").replace(/>\s+</g, "><").trim();
+    };
+    const normalizedExpected = normalizeHTML(expected);
+    const normalizedActual = normalizeHTML(actual);
+    if (normalizedExpected === normalizedActual) {
+        return { match: true, differences: [] };
+    }
+    const expectedLines = normalizedExpected.split("\n");
+    const actualLines = normalizedActual.split("\n");
+    const maxLines = Math.max(expectedLines.length, actualLines.length);
+    for (let i = 0; i < maxLines; i++) {
+        const expectedLine = expectedLines[i] || "";
+        const actualLine = actualLines[i] || "";
+        if (expectedLine !== actualLine) {
+            differences.push(`Line ${i + 1}:`);
+            differences.push(`  Expected: ${expectedLine}`);
+            differences.push(`  Actual:   ${actualLine}`);
+        }
+    }
+    return { match: false, differences };
+}
+//# sourceMappingURL=testing.js.map

package/dist/utils/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../utils/testing.ts"],"names":[],"mappings":";;AAMA,gDAkBC;AAKD,kCAoCC;AA9DD;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,MAA0B,EAC1B,UAAkB;IAElB,IAAI,CAAC;QACH,MAAM,WAAW,GAAI,UAAkB,EAAE,OAAO,CAAC;QACjD,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;YACnE,OAAO,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CACzB,QAAgB,EAChB,MAAc;IAKd,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,kBAAkB,KAAK,gBAAgB,EAAE,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAExC,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,WAAW,CAAC,IAAI,CAAC,eAAe,YAAY,EAAE,CAAC,CAAC;YAChD,WAAW,CAAC,IAAI,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@livetemplate/client",
+  "version": "0.1.0",
+  "description": "TypeScript client for LiveTemplate tree-based updates",
+  "main": "dist/livetemplate-client.js",
+  "browser": "dist/livetemplate-client.browser.js",
+  "types": "dist/livetemplate-client.d.ts",
+  "scripts": {
+    "build": "tsc && npm run build:browser",
+    "build:browser": "esbuild livetemplate-client.ts --bundle --format=iife --global-name=LiveTemplateClient --outfile=dist/livetemplate-client.browser.js --sourcemap --minify --target=es2018 --legal-comments=none",
+    "test": "jest --no-cache",
+    "test:reconstruction": "jest test-reconstruction",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "livetemplate",
+    "html",
+    "tree-updates",
+    "phoenix-liveview",
+    "htmx",
+    "websocket",
+    "client"
+  ],
+  "author": "Adnaan Badr",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/livetemplate/livetemplate.git",
+    "directory": "client"
+  },
+  "homepage": "https://github.com/livetemplate/livetemplate#readme",
+  "bugs": {
+    "url": "https://github.com/livetemplate/livetemplate/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.25.10",
+    "jest": "^30.1.3",
+    "jest-environment-jsdom": "^30.2.0",
+    "ts-jest": "^29.4.4",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@types/morphdom": "^2.3.0",
+    "morphdom": "^2.7.7"
+  }
+}