@xnetjs/runtime 0.1.8 → 0.2.0

package/dist/index.d.ts

@@ -973,6 +973,14 @@ type NodeSyncResponse = {
  * Listener for unknown change type events.
  */
 type UnknownChangeTypeListener = (change: NodeChange, peerId: string) => void;
+/**
+ * The hub is refusing further writes for a capacity reason (exploration 0291):
+ * `QUOTA_EXCEEDED` — this identity is over the hub's per-user cap (demo mode);
+ * `STORAGE_FULL` — the hub's volume is full and it is shedding writes.
+ * Local data is untouched; outbound sync pauses until the next reconnect.
+ */
+type SyncBlockedReason = 'QUOTA_EXCEEDED' | 'STORAGE_FULL';
+type SyncBlockedListener = (reason: SyncBlockedReason, detail: string) => void;
 declare class NodeStoreSyncProvider {
     private store;
     private room;
@@ -987,6 +995,7 @@ declare class NodeStoreSyncProvider {
     private messageCleanup;
     private storeCleanup;
     private unknownChangeTypeListeners;
+    private syncBlockedListeners;
     private sendQueue;
     private queuedHashes;
     private sendTimer;
@@ -1048,6 +1057,20 @@ declare class NodeStoreSyncProvider {
      * counter so sparse one-off rejections never accumulate to a false trip.
      */
     private recordStructuralRejection;
+    /**
+     * Halt outbound sync on a capacity rejection (exploration 0291). Unlike the
+     * structural breaker, one rejection is enough: while the account is over
+     * quota (or the hub's disk is full) every further change is rejected too, so
+     * resending only floods the hub. Local data is untouched — the store keeps
+     * accepting writes and the un-pushed changes replay on the next reconnect
+     * (the demo hub's daily reset / freed disk clears the condition server-side).
+     */
+    private recordCapacityRejection;
+    /**
+     * Subscribe to capacity-blocked events (hub over quota / disk full) so the
+     * app can surface a "storage full" notice. Returns an unsubscribe function.
+     */
+    onSyncBlocked(listener: SyncBlockedListener): () => void;
     private requestSync;
     private handleRemoteChange;
     private handleSyncResponse;
@@ -1290,4 +1313,4 @@ declare function negotiateProtocolVersion(ours: readonly string[], theirs: reado
  */
 declare function isProtocolCompatible(theirs: readonly string[]): boolean;
 
-export { type AdapterConformanceCheck, AdapterConformanceError, type AdapterConformanceResult, type BlobStoreForSync, type ConformanceClientFactory, type ConnectionManager, type ConnectionManagerConfig, type ConnectionStatus, type CreateXNetClientOptions, type HubConnection, type HubTransport, type InitialSyncManager, type InitialSyncMessage, type LiveQuery, type LiveQueryValue, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, type MetaBridge, type MultiHubConnectionManagerConfig, type MultiHubSyncManager, type MultiHubSyncManagerConfig, type NodePool, type NodePoolConfig, NodeStoreSyncProvider, type NodeSyncResponse, type OfflineQueue, type OfflineQueueConfig, type PlannedHub, type PoolEntryState, type ProgressListener, type QueueEntry, type Registry, type RegistryConfig, type RegistryStorage, type ReplicaTrust, type ReplicationDestinationSpec, type ReplicationScopeNode, type ScopedRoomHandle, type SerializedNodeChange, type SpaceReplicationPolicy, type SyncManager, type SyncManagerConfig, type SyncPhase, type SyncProgress, type SyncReconciliationOptions, type SyncReconciliationReport, type SyncStatus, type TrackedNode, WebSocketSyncProvider, type WebSocketSyncProviderOptions, XNET_AWARENESS_VERSION, XNET_DATA_MODEL_VERSION, XNET_PROTOCOL_VERSION, XNET_SCHEMA_VERSION, XNET_SUPPORTED_PROTOCOL_VERSIONS, XNET_SYNC_ENVELOPE_VERSION, XNET_UCAN_PROFILE, type XNetClient, type XNetClientBridgeMode, type XNetClientPluginOptions, type XNetClientRuntimePhase, type XNetClientRuntimeStatus, type XNetClientSyncOptions, type XNetClientTelemetry, type XNetClientUndoOptions, type XNetProtocolBundle, createConnectionManager, createInitialSyncManager, createMetaBridge, createMultiHubConnectionManager, createMultiHubSyncManager, createNodePool, createOfflineQueue, createRegistry, createSyncManager, createXNetClient, isProtocolCompatible, liveQuery, namespaceForNode, negotiateProtocolVersion, replicationConfigFromPolicies, runAdapterConformance, spaceNamespace, systemNamespace };
+export { type AdapterConformanceCheck, AdapterConformanceError, type AdapterConformanceResult, type BlobStoreForSync, type ConformanceClientFactory, type ConnectionManager, type ConnectionManagerConfig, type ConnectionStatus, type CreateXNetClientOptions, type HubConnection, type HubTransport, type InitialSyncManager, type InitialSyncMessage, type LiveQuery, type LiveQueryValue, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, type MetaBridge, type MultiHubConnectionManagerConfig, type MultiHubSyncManager, type MultiHubSyncManagerConfig, type NodePool, type NodePoolConfig, NodeStoreSyncProvider, type NodeSyncResponse, type OfflineQueue, type OfflineQueueConfig, type PlannedHub, type PoolEntryState, type ProgressListener, type QueueEntry, type Registry, type RegistryConfig, type RegistryStorage, type ReplicaTrust, type ReplicationDestinationSpec, type ReplicationScopeNode, type ScopedRoomHandle, type SerializedNodeChange, type SpaceReplicationPolicy, type SyncBlockedListener, type SyncBlockedReason, type SyncManager, type SyncManagerConfig, type SyncPhase, type SyncProgress, type SyncReconciliationOptions, type SyncReconciliationReport, type SyncStatus, type TrackedNode, WebSocketSyncProvider, type WebSocketSyncProviderOptions, XNET_AWARENESS_VERSION, XNET_DATA_MODEL_VERSION, XNET_PROTOCOL_VERSION, XNET_SCHEMA_VERSION, XNET_SUPPORTED_PROTOCOL_VERSIONS, XNET_SYNC_ENVELOPE_VERSION, XNET_UCAN_PROFILE, type XNetClient, type XNetClientBridgeMode, type XNetClientPluginOptions, type XNetClientRuntimePhase, type XNetClientRuntimeStatus, type XNetClientSyncOptions, type XNetClientTelemetry, type XNetClientUndoOptions, type XNetProtocolBundle, createConnectionManager, createInitialSyncManager, createMetaBridge, createMultiHubConnectionManager, createMultiHubSyncManager, createNodePool, createOfflineQueue, createRegistry, createSyncManager, createXNetClient, isProtocolCompatible, liveQuery, namespaceForNode, negotiateProtocolVersion, replicationConfigFromPolicies, runAdapterConformance, spaceNamespace, systemNamespace };

package/dist/index.js

@@ -901,6 +901,7 @@ function nowMs2() {
 function yieldToEventLoop() {
   return new Promise((resolve) => setTimeout(resolve, 0));
 }
+var CAPACITY_REJECTION_CODES = /* @__PURE__ */ new Set(["QUOTA_EXCEEDED", "STORAGE_FULL"]);
 var NodeStoreSyncProvider = class {
   constructor(store, room) {
     this.store = store;
@@ -917,6 +918,7 @@ var NodeStoreSyncProvider = class {
   messageCleanup = null;
   storeCleanup = null;
   unknownChangeTypeListeners = /* @__PURE__ */ new Set();
+  syncBlockedListeners = /* @__PURE__ */ new Set();
   // Throttled send queue.
   sendQueue = [];
   queuedHashes = /* @__PURE__ */ new Set();
@@ -1103,6 +1105,9 @@ var NodeStoreSyncProvider = class {
       if (STRUCTURAL_REJECTION_CODES.has(code)) {
         this.recordStructuralRejection(code, message);
       }
+      if (CAPACITY_REJECTION_CODES.has(code)) {
+        this.recordCapacityRejection(code, message);
+      }
       return;
     }
     if (message.type !== "node-sync-response") return;
@@ -1130,6 +1135,41 @@ var NodeStoreSyncProvider = class {
       `[NodeStoreSync] Pausing outbound sync after ${this.structuralRejections} consecutive "${code}" rejections. Local changes are valid but the hub keeps rejecting them \u2014 this usually means the hub is on an incompatible @xnetjs/sync build (protocol/hash skew). Outbound sync resumes on reconnect. Hub said: ${message.error ?? message.message ?? "(no detail)"}`
     );
   }
+  /**
+   * Halt outbound sync on a capacity rejection (exploration 0291). Unlike the
+   * structural breaker, one rejection is enough: while the account is over
+   * quota (or the hub's disk is full) every further change is rejected too, so
+   * resending only floods the hub. Local data is untouched — the store keeps
+   * accepting writes and the un-pushed changes replay on the next reconnect
+   * (the demo hub's daily reset / freed disk clears the condition server-side).
+   */
+  recordCapacityRejection(reason, message) {
+    const detail = String(message.error ?? message.message ?? "");
+    if (!this.outboundHalted) {
+      this.outboundHalted = true;
+      this.clearSendQueue();
+      console.error(
+        reason === "QUOTA_EXCEEDED" ? `[NodeStoreSync] Hub storage limit reached \u2014 pausing outbound sync. Your data is safe locally; syncing resumes when space frees up (demo hubs reset daily). Hub said: ${detail}` : `[NodeStoreSync] Hub disk is full \u2014 pausing outbound sync. Your data is safe locally; syncing resumes automatically. Hub said: ${detail}`
+      );
+    }
+    for (const listener of this.syncBlockedListeners) {
+      try {
+        listener(reason, detail);
+      } catch (err) {
+        console.error("Error in sync-blocked listener:", err);
+      }
+    }
+  }
+  /**
+   * Subscribe to capacity-blocked events (hub over quota / disk full) so the
+   * app can surface a "storage full" notice. Returns an unsubscribe function.
+   */
+  onSyncBlocked(listener) {
+    this.syncBlockedListeners.add(listener);
+    return () => {
+      this.syncBlockedListeners.delete(listener);
+    };
+  }
   requestSync() {
     if (!this.connection) return;
     this.connection.sendRaw({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/runtime",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Framework-agnostic xNet runtime: createXNetClient() and sync orchestration, usable from any framework, a CLI, a worker, or a Node service",
   "license": "MIT",
   "repository": {
@@ -28,15 +28,15 @@
   "dependencies": {
     "y-protocols": "^1.0.6",
     "yjs": "^13.6.24",
-    "@xnetjs/core": "0.7.0",
-    "@xnetjs/crypto": "0.7.0",
-    "@xnetjs/data": "0.7.0",
-    "@xnetjs/data-bridge": "0.7.0",
-    "@xnetjs/history": "0.7.0",
-    "@xnetjs/identity": "0.7.0",
-    "@xnetjs/plugins": "0.7.0",
-    "@xnetjs/storage": "0.7.0",
-    "@xnetjs/sync": "0.7.0"
+    "@xnetjs/core": "0.8.0",
+    "@xnetjs/crypto": "0.8.0",
+    "@xnetjs/data": "0.8.0",
+    "@xnetjs/data-bridge": "0.8.0",
+    "@xnetjs/history": "0.8.0",
+    "@xnetjs/identity": "0.8.0",
+    "@xnetjs/plugins": "0.8.0",
+    "@xnetjs/storage": "0.8.0",
+    "@xnetjs/sync": "0.8.0"
   },
   "devDependencies": {
     "jsdom": "^26.0.0",