@korajs/server 1.0.0-beta.11 → 1.0.0-beta.12

package/dist/index.d.cts

@@ -314,6 +314,10 @@ interface ServerMetricsSnapshot {
     peakConnections: number;
     connectionsTotal: number;
     operationsReceived: number;
+    batchesReceived: number;
+    uniqueOperationsReceived: number;
+    duplicateOperationsReceived: number;
+    rejectedOperations: number;
     operationsSent: number;
     bytesReceived: number;
     bytesSent: number;
@@ -332,6 +336,10 @@ interface ClientMetrics {
     state: SessionState$1;
     connectedAt: number;
     operationsReceived: number;
+    batchesReceived: number;
+    uniqueOperationsReceived: number;
+    duplicateOperationsReceived: number;
+    rejectedOperations: number;
     operationsSent: number;
     authContext: AuthContext | null;
 }
@@ -340,6 +348,10 @@ declare class ServerMetricsCollector {
     private peakConnections;
     private connectionsTotal;
     private operationsReceived;
+    private batchesReceived;
+    private uniqueOperationsReceived;
+    private duplicateOperationsReceived;
+    private rejectedOperations;
     private operationsSent;
     private bytesReceived;
     private bytesSent;
@@ -357,7 +369,11 @@ declare class ServerMetricsCollector {
     /** Record authentication context for a session. */
     recordAuth(sessionId: string, authContext: AuthContext | null): void;
     /** Record operations received from a client. */
-    recordReceived(sessionId: string, count: number, byteSize: number): void;
+    recordReceived(sessionId: string, count: number, byteSize: number, outcomes?: {
+        unique: number;
+        duplicates: number;
+        rejected: number;
+    }): void;
     /** Record operations sent to a client. */
     recordSent(sessionId: string, count: number, byteSize: number): void;
     /** Record an error. */
@@ -798,6 +814,10 @@ interface AuthContext {
     userId: string;
     /** Per-collection sync scopes (optional) */
     scopes?: Record<string, Record<string, unknown>>;
+    /** Server-authoritative records this session may receive. Overrides `scopes`. */
+    downlinkScopes?: Record<string, Record<string, unknown>>;
+    /** Server-authoritative records this session may upload. Overrides `scopes`. */
+    uplinkScopes?: Record<string, Record<string, unknown>>;
     /** Arbitrary metadata about the authenticated user */
     metadata?: Record<string, unknown>;
 }
@@ -1169,6 +1189,7 @@ declare class ClientSession {
     private clientNodeId;
     private authContext;
     private syncQuerySubsets;
+    private scopeExitPolicy;
     private resumeDeltaCursor;
     /**
      * The delivery watermark the client reported at handshake, or null when the client
@@ -1193,7 +1214,7 @@ declare class ClientSession {
      * batches every server tick while the first batch is still being applied.
      */
     private lastDeliveryPushAttemptAtMs;
-    private deliveryStallRepeatCount;
+    private outstandingDelivery;
     /** Serializes incremental delivery pushes so their batches never interleave. */
     private deliveryPushChain;
     /**
@@ -1264,6 +1285,7 @@ declare class ClientSession {
      */
     pushDeliveryStreamIfSupported(staleMs?: number, options?: {
         trackStall?: boolean;
+        serverFrontier?: number;
     }): void;
     /**
      * Close this session.
@@ -1322,6 +1344,9 @@ declare class ClientSession {
     /** Build, track, and send one chained delivery-stream batch. */
     private sendDeliveryBatch;
     private operationVisibleToClient;
+    /** Upload authorization is independent from the client's downloaded/query view. */
+    private operationAllowedFromClient;
+    private scopeRetractionFor;
     /**
      * Read a record's current field values from the materialized store for scope /
      * query-subset backfill. Includes soft-deleted rows so a relayed delete (whose op

package/dist/index.d.ts

@@ -314,6 +314,10 @@ interface ServerMetricsSnapshot {
     peakConnections: number;
     connectionsTotal: number;
     operationsReceived: number;
+    batchesReceived: number;
+    uniqueOperationsReceived: number;
+    duplicateOperationsReceived: number;
+    rejectedOperations: number;
     operationsSent: number;
     bytesReceived: number;
     bytesSent: number;
@@ -332,6 +336,10 @@ interface ClientMetrics {
     state: SessionState$1;
     connectedAt: number;
     operationsReceived: number;
+    batchesReceived: number;
+    uniqueOperationsReceived: number;
+    duplicateOperationsReceived: number;
+    rejectedOperations: number;
     operationsSent: number;
     authContext: AuthContext | null;
 }
@@ -340,6 +348,10 @@ declare class ServerMetricsCollector {
     private peakConnections;
     private connectionsTotal;
     private operationsReceived;
+    private batchesReceived;
+    private uniqueOperationsReceived;
+    private duplicateOperationsReceived;
+    private rejectedOperations;
     private operationsSent;
     private bytesReceived;
     private bytesSent;
@@ -357,7 +369,11 @@ declare class ServerMetricsCollector {
     /** Record authentication context for a session. */
     recordAuth(sessionId: string, authContext: AuthContext | null): void;
     /** Record operations received from a client. */
-    recordReceived(sessionId: string, count: number, byteSize: number): void;
+    recordReceived(sessionId: string, count: number, byteSize: number, outcomes?: {
+        unique: number;
+        duplicates: number;
+        rejected: number;
+    }): void;
     /** Record operations sent to a client. */
     recordSent(sessionId: string, count: number, byteSize: number): void;
     /** Record an error. */
@@ -798,6 +814,10 @@ interface AuthContext {
     userId: string;
     /** Per-collection sync scopes (optional) */
     scopes?: Record<string, Record<string, unknown>>;
+    /** Server-authoritative records this session may receive. Overrides `scopes`. */
+    downlinkScopes?: Record<string, Record<string, unknown>>;
+    /** Server-authoritative records this session may upload. Overrides `scopes`. */
+    uplinkScopes?: Record<string, Record<string, unknown>>;
     /** Arbitrary metadata about the authenticated user */
     metadata?: Record<string, unknown>;
 }
@@ -1169,6 +1189,7 @@ declare class ClientSession {
     private clientNodeId;
     private authContext;
     private syncQuerySubsets;
+    private scopeExitPolicy;
     private resumeDeltaCursor;
     /**
      * The delivery watermark the client reported at handshake, or null when the client
@@ -1193,7 +1214,7 @@ declare class ClientSession {
      * batches every server tick while the first batch is still being applied.
      */
     private lastDeliveryPushAttemptAtMs;
-    private deliveryStallRepeatCount;
+    private outstandingDelivery;
     /** Serializes incremental delivery pushes so their batches never interleave. */
     private deliveryPushChain;
     /**
@@ -1264,6 +1285,7 @@ declare class ClientSession {
      */
     pushDeliveryStreamIfSupported(staleMs?: number, options?: {
         trackStall?: boolean;
+        serverFrontier?: number;
     }): void;
     /**
      * Close this session.
@@ -1322,6 +1344,9 @@ declare class ClientSession {
     /** Build, track, and send one chained delivery-stream batch. */
     private sendDeliveryBatch;
     private operationVisibleToClient;
+    /** Upload authorization is independent from the client's downloaded/query view. */
+    private operationAllowedFromClient;
+    private scopeRetractionFor;
     /**
      * Read a record's current field values from the materialized store for scope /
      * query-subset backfill. Includes soft-deleted rows so a relayed delete (whose op