@tinycloud/node-sdk 3.2.0-beta.2 → 3.2.0-beta.3

package/dist/replication/runtime.cjs

@@ -0,0 +1,224 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/replication/runtime.ts
+var runtime_exports = {};
+__export(runtime_exports, {
+  ReplicationRuntime: () => ReplicationRuntime
+});
+module.exports = __toCommonJS(runtime_exports);
+var import_sdk_core = require("@tinycloud/sdk-core");
+var scheduler = {
+  now: () => Date.now(),
+  setTimeout(fn, ms) {
+    const timer = setTimeout(fn, ms);
+    timer.unref?.();
+    return () => clearTimeout(timer);
+  }
+};
+function resolvedOptions(options) {
+  return {
+    ...options,
+    syncIntervalMs: options.syncIntervalMs ?? 6e4,
+    maxStalenessMs: options.maxStalenessMs ?? 12e4,
+    staleSyncTimeoutMs: options.staleSyncTimeoutMs ?? 5e3,
+    allowSecrets: options.allowSecrets === true,
+    verify: options.verify === true
+  };
+}
+var ReplicationRuntime = class {
+  constructor(options, clock = scheduler) {
+    this.options = options;
+    this.clock = clock;
+    this.pending = /* @__PURE__ */ new Map();
+    this.attached = /* @__PURE__ */ new Map();
+    this.previous = Promise.resolve();
+    this.binding = Promise.resolve();
+    this.generation = 0;
+    this.bindingActive = false;
+    this.pendingPurgeSet = false;
+    this.closed = false;
+    this.control = {
+      status: async () => {
+        await this.binding;
+        return this.current ? this.current.status() : [];
+      },
+      sync: async (input) => {
+        await this.binding;
+        if (this.purgedGeneration === this.generation) return;
+        if (this.current) await this.current.sync(input);
+      },
+      purge: (input) => {
+        if (this.bindingActive) {
+          this.pendingPurge = input;
+          this.pendingPurgeSet = true;
+          const existing = this.current ?? this.lastController;
+          if (existing) {
+            this.pendingPurgeResult = existing.purge(input);
+            this.purgedGeneration = this.generation;
+          }
+          return this.binding.then(() => this.pendingPurgeResult ?? { purged: [], failed: [] });
+        }
+        const controller = this.current ?? this.lastController;
+        if (!controller) return Promise.resolve({ purged: [], failed: [] });
+        this.purgedGeneration = this.generation;
+        return controller.purge(input);
+      },
+      clearPending: async () => {
+        await this.binding;
+        if (this.current) return this.current.clearPending();
+        const pending = this.lastPending;
+        if (!pending) return 0;
+        return pending.update((state) => {
+          const before = state.records.length;
+          state.records = state.records.filter(
+            (record) => record.state === "committed" || record.state === "in_flight" && this.clock.now() - Date.parse(record.at) <= 10 * 6e4
+          );
+          return before - state.records.length;
+        });
+      },
+      close: async () => {
+        this.closed = true;
+        this.unbind();
+        await this.binding.catch(() => void 0);
+        await this.previous;
+      }
+    };
+  }
+  loadServices() {
+    return this.services ?? (this.services = import("@tinycloud/sdk-services/kv/replication"));
+  }
+  detachAll() {
+    for (const kv of this.attached.keys()) kv.setReadThrough(null);
+    this.attached.clear();
+  }
+  bind(input) {
+    if (this.closed || !this.options.enabled) return Promise.resolve();
+    this.bindingActive = true;
+    const generation = ++this.generation;
+    this.purgedGeneration = void 0;
+    const { context, session } = input;
+    const emit = (event) => {
+      try {
+        this.options.onEvent?.(event);
+      } catch {
+      }
+      const { type, ...data } = event;
+      context.emit(type, data);
+    };
+    const previous = this.current;
+    this.current = void 0;
+    for (const kv of this.attached.keys()) kv.setReadThrough(null);
+    this.primarySpace = session.spaceId;
+    const close = previous ? previous.close().catch(() => void 0) : Promise.resolve();
+    this.previous = this.previous.then(() => close);
+    const previousClose = this.previous;
+    this.binding = this.loadServices().then((services) => {
+      if (generation !== this.generation || this.closed) return;
+      let identity;
+      try {
+        identity = services.canonicalReplicationIdentity({
+          host: context.hosts[0],
+          space: session.spaceId,
+          principal: input.principal ?? (0, import_sdk_core.pkhDid)(input.address, input.chainId)
+        });
+      } catch {
+        for (const prefix of this.options.prefixes) {
+          emit({ type: "replication.state", at: new Date(this.clock.now()).toISOString(), space: session.spaceId, replica: prefix, state: "unavailable", code: "CONFIG_INVALID" });
+        }
+        return;
+      }
+      const key = services.replicationIdentityKey(identity);
+      let pending = this.pending.get(key);
+      if (!pending) {
+        pending = this.options.storage.pendingWrites?.(identity) ?? services.createMemoryPendingStore(identity);
+        this.pending.set(key, pending);
+      }
+      this.lastPending = pending;
+      const controller = services.createKVReplication({
+        options: resolvedOptions(this.options),
+        mode: this.options.mode ?? "background",
+        storage: this.options.storage,
+        identity,
+        session: { id: session.delegationCid, did: session.verificationMethod, space: session.spaceId },
+        authority: input.authority,
+        pending,
+        scheduler: this.clock,
+        emit,
+        fetch: context.fetch,
+        previous: previousClose
+      });
+      this.current = controller;
+      this.lastController = controller;
+      this.lastIdentity = identity;
+      for (const [kv, space] of this.attached) {
+        kv.setReadThrough(space === this.primarySpace ? controller : null);
+      }
+      for (const scoped of input.primaryKV) this.attach(scoped.space, scoped.kv);
+      if (this.pendingPurgeSet) {
+        this.pendingPurgeResult = controller.purge(this.pendingPurge);
+        this.purgedGeneration = generation;
+        this.pendingPurge = void 0;
+        this.pendingPurgeSet = false;
+      }
+    }).finally(() => {
+      if (generation === this.generation) this.bindingActive = false;
+    });
+    for (const kv of this.attached.keys()) kv.setReadThroughReady?.(this.binding);
+    return this.binding;
+  }
+  attach(space, kv) {
+    this.attached.set(kv, space);
+    kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);
+    return this.binding.then(() => {
+      kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);
+    });
+  }
+  unbind() {
+    this.generation++;
+    this.bindingActive = false;
+    this.pendingPurgeSet = false;
+    const controller = this.current;
+    this.current = void 0;
+    this.primarySpace = void 0;
+    this.detachAll();
+    const binding = this.binding;
+    const close = binding.then(() => controller?.close()).catch(() => void 0);
+    this.previous = this.previous.then(() => close);
+    return this.previous;
+  }
+  get boundIdentity() {
+    return this.lastIdentity;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReplicationRuntime
+});
+//# sourceMappingURL=runtime.cjs.map

package/dist/replication/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/replication/runtime.ts"],"sourcesContent":["import { pkhDid } from \"@tinycloud/sdk-core\";\nimport type { FetchFunction, ServiceContext, ServiceSession } from \"@tinycloud/sdk-core\";\nimport type {\n  KVReadThrough,\n  KVReplicaStorage,\n  KVReplicationController,\n  PendingWriteStore,\n  ReplicationAuthority,\n  ReplicationControl,\n  ReplicationEvent,\n  ReplicationIdentity,\n  ReplicationOptions,\n  ReplicationScheduler,\n} from \"@tinycloud/sdk-services\";\ntype ReplicationServices = typeof import(\"@tinycloud/sdk-services/kv/replication\");\n\nexport interface ReplicationRuntimeOptions extends ReplicationOptions {\n  storage: KVReplicaStorage;\n  mode?: \"background\" | \"foreground\";\n}\n\nexport interface ReplicationRuntimeBinding {\n  context: ServiceContext;\n  session: ServiceSession;\n  address?: string;\n  chainId?: number;\n  principal?: string;\n  authority: ReplicationAuthority;\n  primaryKV: Array<{ space: string; kv: { setReadThrough(readThrough: KVReadThrough | null): void } }>;\n}\n\nconst scheduler: ReplicationScheduler = {\n  now: () => Date.now(),\n  setTimeout(fn, ms) {\n    const timer = setTimeout(fn, ms);\n    timer.unref?.();\n    return () => clearTimeout(timer);\n  },\n};\n\nfunction resolvedOptions(options: ReplicationRuntimeOptions) {\n  return {\n    ...options,\n    syncIntervalMs: options.syncIntervalMs ?? 60_000,\n    maxStalenessMs: options.maxStalenessMs ?? 120_000,\n    staleSyncTimeoutMs: options.staleSyncTimeoutMs ?? 5_000,\n    allowSecrets: options.allowSecrets === true,\n    verify: options.verify === true,\n  };\n}\ntype ReadThroughKV = {\n  setReadThrough(readThrough: KVReadThrough | null): void;\n  setReadThroughReady?(ready: Promise<unknown>): void;\n};\n\nexport class ReplicationRuntime {\n  readonly control: ReplicationControl;\n  private readonly pending = new Map<string, PendingWriteStore>();\n  private readonly attached = new Map<ReadThroughKV, string>();\n  private current?: KVReplicationController;\n  private lastController?: KVReplicationController;\n  private previous: Promise<void> = Promise.resolve();\n  private binding: Promise<void> = Promise.resolve();\n  private services?: Promise<ReplicationServices>;\n  private generation = 0;\n  private lastIdentity?: ReplicationIdentity;\n  private lastPending?: PendingWriteStore;\n  private primarySpace?: string;\n  private pendingPurge?: Parameters<KVReplicationController[\"purge\"]>[0];\n  private pendingPurgeResult?: ReturnType<KVReplicationController[\"purge\"]>;\n  private bindingActive = false;\n  private pendingPurgeSet = false;\n  private purgedGeneration?: number;\n  private closed = false;\n  constructor(\n    private readonly options: ReplicationRuntimeOptions,\n    private readonly clock: ReplicationScheduler = scheduler,\n  ) {\n    this.control = {\n      status: async () => {\n        await this.binding;\n        return this.current ? this.current.status() : [];\n      },\n      sync: async (input) => {\n        await this.binding;\n        if (this.purgedGeneration === this.generation) return;\n        if (this.current) await this.current.sync(input);\n      },\n      purge: (input) => {\n        if (this.bindingActive) {\n          this.pendingPurge = input;\n          this.pendingPurgeSet = true;\n          const existing = this.current ?? this.lastController;\n          if (existing) {\n            this.pendingPurgeResult = existing.purge(input);\n            this.purgedGeneration = this.generation;\n          }\n          return this.binding.then(() => this.pendingPurgeResult ?? { purged: [], failed: [] });\n        }\n        const controller = this.current ?? this.lastController;\n        if (!controller) return Promise.resolve({ purged: [], failed: [] });\n        this.purgedGeneration = this.generation;\n        return controller.purge(input);\n      },\n      clearPending: async () => {\n        await this.binding;\n        if (this.current) return this.current.clearPending();\n        const pending = this.lastPending;\n        if (!pending) return 0;\n        return pending.update((state) => {\n          const before = state.records.length;\n          state.records = state.records.filter((record) =>\n            record.state === \"committed\" ||\n            (record.state === \"in_flight\" && this.clock.now() - Date.parse(record.at) <= 10 * 60_000),\n          );\n          return before - state.records.length;\n        });\n      },\n      close: async () => {\n        this.closed = true;\n        this.unbind();\n        await this.binding.catch(() => undefined);\n        await this.previous;\n      },\n    };\n  }\n\n  private loadServices(): Promise<ReplicationServices> {\n    return (this.services ??= import(\"@tinycloud/sdk-services/kv/replication\"));\n  }\n\n  private detachAll(): void {\n    for (const kv of this.attached.keys()) kv.setReadThrough(null);\n    this.attached.clear();\n  }\n\n  bind(input: ReplicationRuntimeBinding): Promise<void> {\n    if (this.closed || !this.options.enabled) return Promise.resolve();\n    this.bindingActive = true;\n    const generation = ++this.generation;\n    this.purgedGeneration = undefined;\n    const { context, session } = input;\n    const emit = (event: ReplicationEvent): void => {\n      try { this.options.onEvent?.(event); } catch { /* Observability must not affect KV behavior. */ }\n      const { type, ...data } = event;\n      context.emit(type, data);\n    };\n    const previous = this.current;\n    this.current = undefined;\n    for (const kv of this.attached.keys()) kv.setReadThrough(null);\n    this.primarySpace = session.spaceId;\n    const close = previous ? previous.close().catch(() => undefined) : Promise.resolve();\n    this.previous = this.previous.then(() => close);\n    const previousClose = this.previous;\n    this.binding = this.loadServices().then((services) => {\n      if (generation !== this.generation || this.closed) return;\n      let identity: ReplicationIdentity;\n      try {\n        identity = services.canonicalReplicationIdentity({\n          host: context.hosts[0]!,\n          space: session.spaceId,\n          principal: input.principal ?? pkhDid(input.address!, input.chainId!),\n        });\n      } catch {\n        for (const prefix of this.options.prefixes) {\n          emit({ type: \"replication.state\", at: new Date(this.clock.now()).toISOString(), space: session.spaceId, replica: prefix, state: \"unavailable\", code: \"CONFIG_INVALID\" });\n        }\n        return;\n      }\n      const key = services.replicationIdentityKey(identity);\n      let pending = this.pending.get(key);\n      if (!pending) {\n        pending = this.options.storage.pendingWrites?.(identity) ?? services.createMemoryPendingStore(identity);\n        this.pending.set(key, pending);\n      }\n      this.lastPending = pending;\n      const controller = services.createKVReplication({\n        options: resolvedOptions(this.options),\n        mode: this.options.mode ?? \"background\",\n        storage: this.options.storage,\n        identity,\n        session: { id: session.delegationCid, did: session.verificationMethod, space: session.spaceId },\n        authority: input.authority,\n        pending,\n        scheduler: this.clock,\n        emit,\n        fetch: context.fetch as FetchFunction,\n        previous: previousClose,\n      });\n      this.current = controller;\n      this.lastController = controller;\n      this.lastIdentity = identity;\n      for (const [kv, space] of this.attached) {\n        kv.setReadThrough(space === this.primarySpace ? controller : null);\n      }\n      for (const scoped of input.primaryKV) this.attach(scoped.space, scoped.kv);\n      if (this.pendingPurgeSet) {\n        this.pendingPurgeResult = controller.purge(this.pendingPurge);\n        this.purgedGeneration = generation;\n        this.pendingPurge = undefined;\n        this.pendingPurgeSet = false;\n      }\n    }).finally(() => {\n      if (generation === this.generation) this.bindingActive = false;\n    });\n    for (const kv of this.attached.keys()) kv.setReadThroughReady?.(this.binding);\n    return this.binding;\n  }\n\n  attach(space: string, kv: ReadThroughKV): Promise<void> {\n    this.attached.set(kv, space);\n    kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);\n    return this.binding.then(() => {\n      kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);\n    });\n  }\n\n  unbind(): Promise<void> {\n    this.generation++;\n    this.bindingActive = false;\n    this.pendingPurgeSet = false;\n    const controller = this.current;\n    this.current = undefined;\n    this.primarySpace = undefined;\n    this.detachAll();\n    const binding = this.binding;\n    const close = binding.then(() => controller?.close()).catch(() => undefined);\n    this.previous = this.previous.then(() => close);\n    return this.previous;\n  }\n\n  get boundIdentity(): ReplicationIdentity | undefined {\n    return this.lastIdentity;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/replication/runtime.d.cts

@@ -0,0 +1,3 @@
+import '@tinycloud/sdk-core';
+import '@tinycloud/sdk-services';
+export { R as ReplicationRuntime, a as ReplicationRuntimeBinding, b as ReplicationRuntimeOptions } from '../runtime-DyYwHW8j.cjs';

package/dist/replication/runtime.d.ts

@@ -0,0 +1,3 @@
+import '@tinycloud/sdk-core';
+import '@tinycloud/sdk-services';
+export { R as ReplicationRuntime, a as ReplicationRuntimeBinding, b as ReplicationRuntimeOptions } from '../runtime-DyYwHW8j.js';

package/dist/replication/runtime.js

@@ -0,0 +1,189 @@
+// src/replication/runtime.ts
+import { pkhDid } from "@tinycloud/sdk-core";
+var scheduler = {
+  now: () => Date.now(),
+  setTimeout(fn, ms) {
+    const timer = setTimeout(fn, ms);
+    timer.unref?.();
+    return () => clearTimeout(timer);
+  }
+};
+function resolvedOptions(options) {
+  return {
+    ...options,
+    syncIntervalMs: options.syncIntervalMs ?? 6e4,
+    maxStalenessMs: options.maxStalenessMs ?? 12e4,
+    staleSyncTimeoutMs: options.staleSyncTimeoutMs ?? 5e3,
+    allowSecrets: options.allowSecrets === true,
+    verify: options.verify === true
+  };
+}
+var ReplicationRuntime = class {
+  constructor(options, clock = scheduler) {
+    this.options = options;
+    this.clock = clock;
+    this.pending = /* @__PURE__ */ new Map();
+    this.attached = /* @__PURE__ */ new Map();
+    this.previous = Promise.resolve();
+    this.binding = Promise.resolve();
+    this.generation = 0;
+    this.bindingActive = false;
+    this.pendingPurgeSet = false;
+    this.closed = false;
+    this.control = {
+      status: async () => {
+        await this.binding;
+        return this.current ? this.current.status() : [];
+      },
+      sync: async (input) => {
+        await this.binding;
+        if (this.purgedGeneration === this.generation) return;
+        if (this.current) await this.current.sync(input);
+      },
+      purge: (input) => {
+        if (this.bindingActive) {
+          this.pendingPurge = input;
+          this.pendingPurgeSet = true;
+          const existing = this.current ?? this.lastController;
+          if (existing) {
+            this.pendingPurgeResult = existing.purge(input);
+            this.purgedGeneration = this.generation;
+          }
+          return this.binding.then(() => this.pendingPurgeResult ?? { purged: [], failed: [] });
+        }
+        const controller = this.current ?? this.lastController;
+        if (!controller) return Promise.resolve({ purged: [], failed: [] });
+        this.purgedGeneration = this.generation;
+        return controller.purge(input);
+      },
+      clearPending: async () => {
+        await this.binding;
+        if (this.current) return this.current.clearPending();
+        const pending = this.lastPending;
+        if (!pending) return 0;
+        return pending.update((state) => {
+          const before = state.records.length;
+          state.records = state.records.filter(
+            (record) => record.state === "committed" || record.state === "in_flight" && this.clock.now() - Date.parse(record.at) <= 10 * 6e4
+          );
+          return before - state.records.length;
+        });
+      },
+      close: async () => {
+        this.closed = true;
+        this.unbind();
+        await this.binding.catch(() => void 0);
+        await this.previous;
+      }
+    };
+  }
+  loadServices() {
+    return this.services ?? (this.services = import("@tinycloud/sdk-services/kv/replication"));
+  }
+  detachAll() {
+    for (const kv of this.attached.keys()) kv.setReadThrough(null);
+    this.attached.clear();
+  }
+  bind(input) {
+    if (this.closed || !this.options.enabled) return Promise.resolve();
+    this.bindingActive = true;
+    const generation = ++this.generation;
+    this.purgedGeneration = void 0;
+    const { context, session } = input;
+    const emit = (event) => {
+      try {
+        this.options.onEvent?.(event);
+      } catch {
+      }
+      const { type, ...data } = event;
+      context.emit(type, data);
+    };
+    const previous = this.current;
+    this.current = void 0;
+    for (const kv of this.attached.keys()) kv.setReadThrough(null);
+    this.primarySpace = session.spaceId;
+    const close = previous ? previous.close().catch(() => void 0) : Promise.resolve();
+    this.previous = this.previous.then(() => close);
+    const previousClose = this.previous;
+    this.binding = this.loadServices().then((services) => {
+      if (generation !== this.generation || this.closed) return;
+      let identity;
+      try {
+        identity = services.canonicalReplicationIdentity({
+          host: context.hosts[0],
+          space: session.spaceId,
+          principal: input.principal ?? pkhDid(input.address, input.chainId)
+        });
+      } catch {
+        for (const prefix of this.options.prefixes) {
+          emit({ type: "replication.state", at: new Date(this.clock.now()).toISOString(), space: session.spaceId, replica: prefix, state: "unavailable", code: "CONFIG_INVALID" });
+        }
+        return;
+      }
+      const key = services.replicationIdentityKey(identity);
+      let pending = this.pending.get(key);
+      if (!pending) {
+        pending = this.options.storage.pendingWrites?.(identity) ?? services.createMemoryPendingStore(identity);
+        this.pending.set(key, pending);
+      }
+      this.lastPending = pending;
+      const controller = services.createKVReplication({
+        options: resolvedOptions(this.options),
+        mode: this.options.mode ?? "background",
+        storage: this.options.storage,
+        identity,
+        session: { id: session.delegationCid, did: session.verificationMethod, space: session.spaceId },
+        authority: input.authority,
+        pending,
+        scheduler: this.clock,
+        emit,
+        fetch: context.fetch,
+        previous: previousClose
+      });
+      this.current = controller;
+      this.lastController = controller;
+      this.lastIdentity = identity;
+      for (const [kv, space] of this.attached) {
+        kv.setReadThrough(space === this.primarySpace ? controller : null);
+      }
+      for (const scoped of input.primaryKV) this.attach(scoped.space, scoped.kv);
+      if (this.pendingPurgeSet) {
+        this.pendingPurgeResult = controller.purge(this.pendingPurge);
+        this.purgedGeneration = generation;
+        this.pendingPurge = void 0;
+        this.pendingPurgeSet = false;
+      }
+    }).finally(() => {
+      if (generation === this.generation) this.bindingActive = false;
+    });
+    for (const kv of this.attached.keys()) kv.setReadThroughReady?.(this.binding);
+    return this.binding;
+  }
+  attach(space, kv) {
+    this.attached.set(kv, space);
+    kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);
+    return this.binding.then(() => {
+      kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);
+    });
+  }
+  unbind() {
+    this.generation++;
+    this.bindingActive = false;
+    this.pendingPurgeSet = false;
+    const controller = this.current;
+    this.current = void 0;
+    this.primarySpace = void 0;
+    this.detachAll();
+    const binding = this.binding;
+    const close = binding.then(() => controller?.close()).catch(() => void 0);
+    this.previous = this.previous.then(() => close);
+    return this.previous;
+  }
+  get boundIdentity() {
+    return this.lastIdentity;
+  }
+};
+export {
+  ReplicationRuntime
+};
+//# sourceMappingURL=runtime.js.map

package/dist/replication/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/replication/runtime.ts"],"sourcesContent":["import { pkhDid } from \"@tinycloud/sdk-core\";\nimport type { FetchFunction, ServiceContext, ServiceSession } from \"@tinycloud/sdk-core\";\nimport type {\n  KVReadThrough,\n  KVReplicaStorage,\n  KVReplicationController,\n  PendingWriteStore,\n  ReplicationAuthority,\n  ReplicationControl,\n  ReplicationEvent,\n  ReplicationIdentity,\n  ReplicationOptions,\n  ReplicationScheduler,\n} from \"@tinycloud/sdk-services\";\ntype ReplicationServices = typeof import(\"@tinycloud/sdk-services/kv/replication\");\n\nexport interface ReplicationRuntimeOptions extends ReplicationOptions {\n  storage: KVReplicaStorage;\n  mode?: \"background\" | \"foreground\";\n}\n\nexport interface ReplicationRuntimeBinding {\n  context: ServiceContext;\n  session: ServiceSession;\n  address?: string;\n  chainId?: number;\n  principal?: string;\n  authority: ReplicationAuthority;\n  primaryKV: Array<{ space: string; kv: { setReadThrough(readThrough: KVReadThrough | null): void } }>;\n}\n\nconst scheduler: ReplicationScheduler = {\n  now: () => Date.now(),\n  setTimeout(fn, ms) {\n    const timer = setTimeout(fn, ms);\n    timer.unref?.();\n    return () => clearTimeout(timer);\n  },\n};\n\nfunction resolvedOptions(options: ReplicationRuntimeOptions) {\n  return {\n    ...options,\n    syncIntervalMs: options.syncIntervalMs ?? 60_000,\n    maxStalenessMs: options.maxStalenessMs ?? 120_000,\n    staleSyncTimeoutMs: options.staleSyncTimeoutMs ?? 5_000,\n    allowSecrets: options.allowSecrets === true,\n    verify: options.verify === true,\n  };\n}\ntype ReadThroughKV = {\n  setReadThrough(readThrough: KVReadThrough | null): void;\n  setReadThroughReady?(ready: Promise<unknown>): void;\n};\n\nexport class ReplicationRuntime {\n  readonly control: ReplicationControl;\n  private readonly pending = new Map<string, PendingWriteStore>();\n  private readonly attached = new Map<ReadThroughKV, string>();\n  private current?: KVReplicationController;\n  private lastController?: KVReplicationController;\n  private previous: Promise<void> = Promise.resolve();\n  private binding: Promise<void> = Promise.resolve();\n  private services?: Promise<ReplicationServices>;\n  private generation = 0;\n  private lastIdentity?: ReplicationIdentity;\n  private lastPending?: PendingWriteStore;\n  private primarySpace?: string;\n  private pendingPurge?: Parameters<KVReplicationController[\"purge\"]>[0];\n  private pendingPurgeResult?: ReturnType<KVReplicationController[\"purge\"]>;\n  private bindingActive = false;\n  private pendingPurgeSet = false;\n  private purgedGeneration?: number;\n  private closed = false;\n  constructor(\n    private readonly options: ReplicationRuntimeOptions,\n    private readonly clock: ReplicationScheduler = scheduler,\n  ) {\n    this.control = {\n      status: async () => {\n        await this.binding;\n        return this.current ? this.current.status() : [];\n      },\n      sync: async (input) => {\n        await this.binding;\n        if (this.purgedGeneration === this.generation) return;\n        if (this.current) await this.current.sync(input);\n      },\n      purge: (input) => {\n        if (this.bindingActive) {\n          this.pendingPurge = input;\n          this.pendingPurgeSet = true;\n          const existing = this.current ?? this.lastController;\n          if (existing) {\n            this.pendingPurgeResult = existing.purge(input);\n            this.purgedGeneration = this.generation;\n          }\n          return this.binding.then(() => this.pendingPurgeResult ?? { purged: [], failed: [] });\n        }\n        const controller = this.current ?? this.lastController;\n        if (!controller) return Promise.resolve({ purged: [], failed: [] });\n        this.purgedGeneration = this.generation;\n        return controller.purge(input);\n      },\n      clearPending: async () => {\n        await this.binding;\n        if (this.current) return this.current.clearPending();\n        const pending = this.lastPending;\n        if (!pending) return 0;\n        return pending.update((state) => {\n          const before = state.records.length;\n          state.records = state.records.filter((record) =>\n            record.state === \"committed\" ||\n            (record.state === \"in_flight\" && this.clock.now() - Date.parse(record.at) <= 10 * 60_000),\n          );\n          return before - state.records.length;\n        });\n      },\n      close: async () => {\n        this.closed = true;\n        this.unbind();\n        await this.binding.catch(() => undefined);\n        await this.previous;\n      },\n    };\n  }\n\n  private loadServices(): Promise<ReplicationServices> {\n    return (this.services ??= import(\"@tinycloud/sdk-services/kv/replication\"));\n  }\n\n  private detachAll(): void {\n    for (const kv of this.attached.keys()) kv.setReadThrough(null);\n    this.attached.clear();\n  }\n\n  bind(input: ReplicationRuntimeBinding): Promise<void> {\n    if (this.closed || !this.options.enabled) return Promise.resolve();\n    this.bindingActive = true;\n    const generation = ++this.generation;\n    this.purgedGeneration = undefined;\n    const { context, session } = input;\n    const emit = (event: ReplicationEvent): void => {\n      try { this.options.onEvent?.(event); } catch { /* Observability must not affect KV behavior. */ }\n      const { type, ...data } = event;\n      context.emit(type, data);\n    };\n    const previous = this.current;\n    this.current = undefined;\n    for (const kv of this.attached.keys()) kv.setReadThrough(null);\n    this.primarySpace = session.spaceId;\n    const close = previous ? previous.close().catch(() => undefined) : Promise.resolve();\n    this.previous = this.previous.then(() => close);\n    const previousClose = this.previous;\n    this.binding = this.loadServices().then((services) => {\n      if (generation !== this.generation || this.closed) return;\n      let identity: ReplicationIdentity;\n      try {\n        identity = services.canonicalReplicationIdentity({\n          host: context.hosts[0]!,\n          space: session.spaceId,\n          principal: input.principal ?? pkhDid(input.address!, input.chainId!),\n        });\n      } catch {\n        for (const prefix of this.options.prefixes) {\n          emit({ type: \"replication.state\", at: new Date(this.clock.now()).toISOString(), space: session.spaceId, replica: prefix, state: \"unavailable\", code: \"CONFIG_INVALID\" });\n        }\n        return;\n      }\n      const key = services.replicationIdentityKey(identity);\n      let pending = this.pending.get(key);\n      if (!pending) {\n        pending = this.options.storage.pendingWrites?.(identity) ?? services.createMemoryPendingStore(identity);\n        this.pending.set(key, pending);\n      }\n      this.lastPending = pending;\n      const controller = services.createKVReplication({\n        options: resolvedOptions(this.options),\n        mode: this.options.mode ?? \"background\",\n        storage: this.options.storage,\n        identity,\n        session: { id: session.delegationCid, did: session.verificationMethod, space: session.spaceId },\n        authority: input.authority,\n        pending,\n        scheduler: this.clock,\n        emit,\n        fetch: context.fetch as FetchFunction,\n        previous: previousClose,\n      });\n      this.current = controller;\n      this.lastController = controller;\n      this.lastIdentity = identity;\n      for (const [kv, space] of this.attached) {\n        kv.setReadThrough(space === this.primarySpace ? controller : null);\n      }\n      for (const scoped of input.primaryKV) this.attach(scoped.space, scoped.kv);\n      if (this.pendingPurgeSet) {\n        this.pendingPurgeResult = controller.purge(this.pendingPurge);\n        this.purgedGeneration = generation;\n        this.pendingPurge = undefined;\n        this.pendingPurgeSet = false;\n      }\n    }).finally(() => {\n      if (generation === this.generation) this.bindingActive = false;\n    });\n    for (const kv of this.attached.keys()) kv.setReadThroughReady?.(this.binding);\n    return this.binding;\n  }\n\n  attach(space: string, kv: ReadThroughKV): Promise<void> {\n    this.attached.set(kv, space);\n    kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);\n    return this.binding.then(() => {\n      kv.setReadThrough(space === this.primarySpace ? this.current ?? null : null);\n    });\n  }\n\n  unbind(): Promise<void> {\n    this.generation++;\n    this.bindingActive = false;\n    this.pendingPurgeSet = false;\n    const controller = this.current;\n    this.current = undefined;\n    this.primarySpace = undefined;\n    this.detachAll();\n    const binding = this.binding;\n    const close = binding.then(() => controller?.close()).catch(() => undefined);\n    this.previous = this.previous.then(() => close);\n    return this.previous;\n  }\n\n  get boundIdentity(): ReplicationIdentity | undefined {\n    return this.lastIdentity;\n  }\n}\n"],"mappings":";AAAA,SAAS,cAAc;AA+BvB,IAAM,YAAkC;AAAA,EACtC,KAAK,MAAM,KAAK,IAAI;AAAA,EACpB,WAAW,IAAI,IAAI;AACjB,UAAM,QAAQ,WAAW,IAAI,EAAE;AAC/B,UAAM,QAAQ;AACd,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC;AACF;AAEA,SAAS,gBAAgB,SAAoC;AAC3D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,gBAAgB,QAAQ,kBAAkB;AAAA,IAC1C,gBAAgB,QAAQ,kBAAkB;AAAA,IAC1C,oBAAoB,QAAQ,sBAAsB;AAAA,IAClD,cAAc,QAAQ,iBAAiB;AAAA,IACvC,QAAQ,QAAQ,WAAW;AAAA,EAC7B;AACF;AAMO,IAAM,qBAAN,MAAyB;AAAA,EAmB9B,YACmB,SACA,QAA8B,WAC/C;AAFiB;AACA;AAnBnB,SAAiB,UAAU,oBAAI,IAA+B;AAC9D,SAAiB,WAAW,oBAAI,IAA2B;AAG3D,SAAQ,WAA0B,QAAQ,QAAQ;AAClD,SAAQ,UAAyB,QAAQ,QAAQ;AAEjD,SAAQ,aAAa;AAMrB,SAAQ,gBAAgB;AACxB,SAAQ,kBAAkB;AAE1B,SAAQ,SAAS;AAKf,SAAK,UAAU;AAAA,MACb,QAAQ,YAAY;AAClB,cAAM,KAAK;AACX,eAAO,KAAK,UAAU,KAAK,QAAQ,OAAO,IAAI,CAAC;AAAA,MACjD;AAAA,MACA,MAAM,OAAO,UAAU;AACrB,cAAM,KAAK;AACX,YAAI,KAAK,qBAAqB,KAAK,WAAY;AAC/C,YAAI,KAAK,QAAS,OAAM,KAAK,QAAQ,KAAK,KAAK;AAAA,MACjD;AAAA,MACA,OAAO,CAAC,UAAU;AAChB,YAAI,KAAK,eAAe;AACtB,eAAK,eAAe;AACpB,eAAK,kBAAkB;AACvB,gBAAM,WAAW,KAAK,WAAW,KAAK;AACtC,cAAI,UAAU;AACZ,iBAAK,qBAAqB,SAAS,MAAM,KAAK;AAC9C,iBAAK,mBAAmB,KAAK;AAAA,UAC/B;AACA,iBAAO,KAAK,QAAQ,KAAK,MAAM,KAAK,sBAAsB,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;AAAA,QACtF;AACA,cAAM,aAAa,KAAK,WAAW,KAAK;AACxC,YAAI,CAAC,WAAY,QAAO,QAAQ,QAAQ,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;AAClE,aAAK,mBAAmB,KAAK;AAC7B,eAAO,WAAW,MAAM,KAAK;AAAA,MAC/B;AAAA,MACA,cAAc,YAAY;AACxB,cAAM,KAAK;AACX,YAAI,KAAK,QAAS,QAAO,KAAK,QAAQ,aAAa;AACnD,cAAM,UAAU,KAAK;AACrB,YAAI,CAAC,QAAS,QAAO;AACrB,eAAO,QAAQ,OAAO,CAAC,UAAU;AAC/B,gBAAM,SAAS,MAAM,QAAQ;AAC7B,gBAAM,UAAU,MAAM,QAAQ;AAAA,YAAO,CAAC,WACpC,OAAO,UAAU,eAChB,OAAO,UAAU,eAAe,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,OAAO,EAAE,KAAK,KAAK;AAAA,UACpF;AACA,iBAAO,SAAS,MAAM,QAAQ;AAAA,QAChC,CAAC;AAAA,MACH;AAAA,MACA,OAAO,YAAY;AACjB,aAAK,SAAS;AACd,aAAK,OAAO;AACZ,cAAM,KAAK,QAAQ,MAAM,MAAM,MAAS;AACxC,cAAM,KAAK;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,eAA6C;AACnD,WAAQ,KAAK,aAAL,KAAK,WAAa,OAAO,wCAAwC;AAAA,EAC3E;AAAA,EAEQ,YAAkB;AACxB,eAAW,MAAM,KAAK,SAAS,KAAK,EAAG,IAAG,eAAe,IAAI;AAC7D,SAAK,SAAS,MAAM;AAAA,EACtB;AAAA,EAEA,KAAK,OAAiD;AACpD,QAAI,KAAK,UAAU,CAAC,KAAK,QAAQ,QAAS,QAAO,QAAQ,QAAQ;AACjE,SAAK,gBAAgB;AACrB,UAAM,aAAa,EAAE,KAAK;AAC1B,SAAK,mBAAmB;AACxB,UAAM,EAAE,SAAS,QAAQ,IAAI;AAC7B,UAAM,OAAO,CAAC,UAAkC;AAC9C,UAAI;AAAE,aAAK,QAAQ,UAAU,KAAK;AAAA,MAAG,QAAQ;AAAA,MAAmD;AAChG,YAAM,EAAE,MAAM,GAAG,KAAK,IAAI;AAC1B,cAAQ,KAAK,MAAM,IAAI;AAAA,IACzB;AACA,UAAM,WAAW,KAAK;AACtB,SAAK,UAAU;AACf,eAAW,MAAM,KAAK,SAAS,KAAK,EAAG,IAAG,eAAe,IAAI;AAC7D,SAAK,eAAe,QAAQ;AAC5B,UAAM,QAAQ,WAAW,SAAS,MAAM,EAAE,MAAM,MAAM,MAAS,IAAI,QAAQ,QAAQ;AACnF,SAAK,WAAW,KAAK,SAAS,KAAK,MAAM,KAAK;AAC9C,UAAM,gBAAgB,KAAK;AAC3B,SAAK,UAAU,KAAK,aAAa,EAAE,KAAK,CAAC,aAAa;AACpD,UAAI,eAAe,KAAK,cAAc,KAAK,OAAQ;AACnD,UAAI;AACJ,UAAI;AACF,mBAAW,SAAS,6BAA6B;AAAA,UAC/C,MAAM,QAAQ,MAAM,CAAC;AAAA,UACrB,OAAO,QAAQ;AAAA,UACf,WAAW,MAAM,aAAa,OAAO,MAAM,SAAU,MAAM,OAAQ;AAAA,QACrE,CAAC;AAAA,MACH,QAAQ;AACN,mBAAW,UAAU,KAAK,QAAQ,UAAU;AAC1C,eAAK,EAAE,MAAM,qBAAqB,IAAI,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,QAAQ,SAAS,SAAS,QAAQ,OAAO,eAAe,MAAM,iBAAiB,CAAC;AAAA,QACzK;AACA;AAAA,MACF;AACA,YAAM,MAAM,SAAS,uBAAuB,QAAQ;AACpD,UAAI,UAAU,KAAK,QAAQ,IAAI,GAAG;AAClC,UAAI,CAAC,SAAS;AACZ,kBAAU,KAAK,QAAQ,QAAQ,gBAAgB,QAAQ,KAAK,SAAS,yBAAyB,QAAQ;AACtG,aAAK,QAAQ,IAAI,KAAK,OAAO;AAAA,MAC/B;AACA,WAAK,cAAc;AACnB,YAAM,aAAa,SAAS,oBAAoB;AAAA,QAC9C,SAAS,gBAAgB,KAAK,OAAO;AAAA,QACrC,MAAM,KAAK,QAAQ,QAAQ;AAAA,QAC3B,SAAS,KAAK,QAAQ;AAAA,QACtB;AAAA,QACA,SAAS,EAAE,IAAI,QAAQ,eAAe,KAAK,QAAQ,oBAAoB,OAAO,QAAQ,QAAQ;AAAA,QAC9F,WAAW,MAAM;AAAA,QACjB;AAAA,QACA,WAAW,KAAK;AAAA,QAChB;AAAA,QACA,OAAO,QAAQ;AAAA,QACf,UAAU;AAAA,MACZ,CAAC;AACD,WAAK,UAAU;AACf,WAAK,iBAAiB;AACtB,WAAK,eAAe;AACpB,iBAAW,CAAC,IAAI,KAAK,KAAK,KAAK,UAAU;AACvC,WAAG,eAAe,UAAU,KAAK,eAAe,aAAa,IAAI;AAAA,MACnE;AACA,iBAAW,UAAU,MAAM,UAAW,MAAK,OAAO,OAAO,OAAO,OAAO,EAAE;AACzE,UAAI,KAAK,iBAAiB;AACxB,aAAK,qBAAqB,WAAW,MAAM,KAAK,YAAY;AAC5D,aAAK,mBAAmB;AACxB,aAAK,eAAe;AACpB,aAAK,kBAAkB;AAAA,MACzB;AAAA,IACF,CAAC,EAAE,QAAQ,MAAM;AACf,UAAI,eAAe,KAAK,WAAY,MAAK,gBAAgB;AAAA,IAC3D,CAAC;AACD,eAAW,MAAM,KAAK,SAAS,KAAK,EAAG,IAAG,sBAAsB,KAAK,OAAO;AAC5E,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,OAAO,OAAe,IAAkC;AACtD,SAAK,SAAS,IAAI,IAAI,KAAK;AAC3B,OAAG,eAAe,UAAU,KAAK,eAAe,KAAK,WAAW,OAAO,IAAI;AAC3E,WAAO,KAAK,QAAQ,KAAK,MAAM;AAC7B,SAAG,eAAe,UAAU,KAAK,eAAe,KAAK,WAAW,OAAO,IAAI;AAAA,IAC7E,CAAC;AAAA,EACH;AAAA,EAEA,SAAwB;AACtB,SAAK;AACL,SAAK,gBAAgB;AACrB,SAAK,kBAAkB;AACvB,UAAM,aAAa,KAAK;AACxB,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,UAAU;AACf,UAAM,UAAU,KAAK;AACrB,UAAM,QAAQ,QAAQ,KAAK,MAAM,YAAY,MAAM,CAAC,EAAE,MAAM,MAAM,MAAS;AAC3E,SAAK,WAAW,KAAK,SAAS,KAAK,MAAM,KAAK;AAC9C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,gBAAiD;AACnD,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}

package/dist/runtime-DyYwHW8j.d.cts

@@ -0,0 +1,64 @@
+import { ServiceContext, ServiceSession } from '@tinycloud/sdk-core';
+import { ReplicationControl, ReplicationOptions, KVReplicaStorage, ReplicationScheduler, ReplicationAuthority, KVReadThrough, ReplicationIdentity } from '@tinycloud/sdk-services';
+
+interface ReplicationRuntimeOptions extends ReplicationOptions {
+    storage: KVReplicaStorage;
+    mode?: "background" | "foreground";
+}
+interface ReplicationRuntimeBinding {
+    context: ServiceContext;
+    session: ServiceSession;
+    address?: string;
+    chainId?: number;
+    principal?: string;
+    authority: ReplicationAuthority;
+    primaryKV: Array<{
+        space: string;
+        kv: {
+            setReadThrough(readThrough: KVReadThrough | null): void;
+        };
+    }>;
+}
+type ReadThroughKV = {
+    setReadThrough(readThrough: KVReadThrough | null): void;
+    setReadThroughReady?(ready: Promise<unknown>): void;
+};
+declare class ReplicationRuntime {
+    private readonly options;
+    private readonly clock;
+    readonly control: ReplicationControl;
+    private readonly pending;
+    private readonly attached;
+    private current?;
+    private lastController?;
+    private previous;
+    private binding;
+    private services?;
+    private generation;
+    private lastIdentity?;
+    private lastPending?;
+    private primarySpace?;
+    private pendingPurge?;
+    private pendingPurgeResult?;
+    private bindingActive;
+    private pendingPurgeSet;
+    private purgedGeneration?;
+    private closed;
+    constructor(options: ReplicationRuntimeOptions, clock?: ReplicationScheduler);
+    private loadServices;
+    private detachAll;
+    bind(input: ReplicationRuntimeBinding): Promise<void>;
+    attach(space: string, kv: ReadThroughKV): Promise<void>;
+    unbind(): Promise<void>;
+    get boundIdentity(): ReplicationIdentity | undefined;
+}
+
+type __runtime_ReplicationRuntime = ReplicationRuntime;
+declare const __runtime_ReplicationRuntime: typeof ReplicationRuntime;
+type __runtime_ReplicationRuntimeBinding = ReplicationRuntimeBinding;
+type __runtime_ReplicationRuntimeOptions = ReplicationRuntimeOptions;
+declare namespace __runtime {
+  export { __runtime_ReplicationRuntime as ReplicationRuntime, type __runtime_ReplicationRuntimeBinding as ReplicationRuntimeBinding, type __runtime_ReplicationRuntimeOptions as ReplicationRuntimeOptions };
+}
+
+export { ReplicationRuntime as R, __runtime as _, type ReplicationRuntimeBinding as a, type ReplicationRuntimeOptions as b };

package/dist/runtime-DyYwHW8j.d.ts

@@ -0,0 +1,64 @@
+import { ServiceContext, ServiceSession } from '@tinycloud/sdk-core';
+import { ReplicationControl, ReplicationOptions, KVReplicaStorage, ReplicationScheduler, ReplicationAuthority, KVReadThrough, ReplicationIdentity } from '@tinycloud/sdk-services';
+
+interface ReplicationRuntimeOptions extends ReplicationOptions {
+    storage: KVReplicaStorage;
+    mode?: "background" | "foreground";
+}
+interface ReplicationRuntimeBinding {
+    context: ServiceContext;
+    session: ServiceSession;
+    address?: string;
+    chainId?: number;
+    principal?: string;
+    authority: ReplicationAuthority;
+    primaryKV: Array<{
+        space: string;
+        kv: {
+            setReadThrough(readThrough: KVReadThrough | null): void;
+        };
+    }>;
+}
+type ReadThroughKV = {
+    setReadThrough(readThrough: KVReadThrough | null): void;
+    setReadThroughReady?(ready: Promise<unknown>): void;
+};
+declare class ReplicationRuntime {
+    private readonly options;
+    private readonly clock;
+    readonly control: ReplicationControl;
+    private readonly pending;
+    private readonly attached;
+    private current?;
+    private lastController?;
+    private previous;
+    private binding;
+    private services?;
+    private generation;
+    private lastIdentity?;
+    private lastPending?;
+    private primarySpace?;
+    private pendingPurge?;
+    private pendingPurgeResult?;
+    private bindingActive;
+    private pendingPurgeSet;
+    private purgedGeneration?;
+    private closed;
+    constructor(options: ReplicationRuntimeOptions, clock?: ReplicationScheduler);
+    private loadServices;
+    private detachAll;
+    bind(input: ReplicationRuntimeBinding): Promise<void>;
+    attach(space: string, kv: ReadThroughKV): Promise<void>;
+    unbind(): Promise<void>;
+    get boundIdentity(): ReplicationIdentity | undefined;
+}
+
+type __runtime_ReplicationRuntime = ReplicationRuntime;
+declare const __runtime_ReplicationRuntime: typeof ReplicationRuntime;
+type __runtime_ReplicationRuntimeBinding = ReplicationRuntimeBinding;
+type __runtime_ReplicationRuntimeOptions = ReplicationRuntimeOptions;
+declare namespace __runtime {
+  export { __runtime_ReplicationRuntime as ReplicationRuntime, type __runtime_ReplicationRuntimeBinding as ReplicationRuntimeBinding, type __runtime_ReplicationRuntimeOptions as ReplicationRuntimeOptions };
+}
+
+export { ReplicationRuntime as R, __runtime as _, type ReplicationRuntimeBinding as a, type ReplicationRuntimeOptions as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinycloud/node-sdk",
-  "version": "3.2.0-beta.2",
+  "version": "3.2.0-beta.3",
   "description": "TinyCloud SDK for Node.js with configurable authorization strategies",
   "author": "TinyCloud, Inc.",
   "license": "EGPL",
@@ -18,6 +18,26 @@
       "types": "./dist/core.d.ts",
       "import": "./dist/core.js",
       "require": "./dist/core.cjs"
+    },
+    "./replication/runtime": {
+      "import": {
+        "types": "./dist/replication/runtime.d.ts",
+        "default": "./dist/replication/runtime.js"
+      },
+      "require": {
+        "types": "./dist/replication/runtime.d.cts",
+        "default": "./dist/replication/runtime.cjs"
+      }
+    },
+    "./replication/authority": {
+      "import": {
+        "types": "./dist/replication/authority.d.ts",
+        "default": "./dist/replication/authority.js"
+      },
+      "require": {
+        "types": "./dist/replication/authority.d.cts",
+        "default": "./dist/replication/authority.cjs"
+      }
     }
   },
   "engines": {
@@ -30,11 +50,13 @@
     "build": "tsup",
     "clean": "rm -rf dist",
     "test": "bun test src/",
+    "typecheck:replica-contract": "tsc --noEmit -p tsconfig.replica-contract.json",
     "test:integration": "echo 'Integration tests live in tests/node-sdk workspace'"
   },
   "dependencies": {
-    "@tinycloud/sdk-services": "3.2.0-beta.2",
-    "@tinycloud/sdk-core": "3.2.0-beta.2",
+    "@tinycloud/replica": "0.1.1-beta.0",
+    "@tinycloud/sdk-services": "3.2.0-beta.3",
+    "@tinycloud/sdk-core": "3.2.0-beta.3",
     "@tinycloud/node-sdk-wasm": "1.7.7",
     "siwe": "^3.0.0"
   },