@aouda/client 0.1.10 → 0.1.12

package/dist/index.cjs

@@ -86,7 +86,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.10",
+  version: "0.1.12",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -357,6 +357,7 @@ var AuthHandler = class {
     this._tokenExpiry = null;
     this._authenticated = false;
     this._refreshPromise = null;
+    this._onAccessTokenRefreshed = null;
     this._serverUrl = serverUrl.replace(/\/+$/, "");
     this._timeout = timeout;
     this._authBasePath = config.basePath;
@@ -606,10 +607,16 @@ var AuthHandler = class {
     const thresholdSeconds = this._refreshThresholdMs / 1e3;
     return this._tokenExpiry <= nowSeconds + thresholdSeconds;
   }
+  setOnAccessTokenRefreshed(handler) {
+    this._onAccessTokenRefreshed = handler;
+  }
   async _doRefresh() {
     try {
       const result = await this.callRefreshEndpoint();
       this.handleSignInResult(result);
+      if (result.accessToken) {
+        this._onAccessTokenRefreshed?.(result.accessToken);
+      }
       return true;
     } catch {
       return false;
@@ -2105,20 +2112,22 @@ var AsyncEventQueue = class {
   }
 };
 var TableSubscription = class {
-  constructor(transport, tableName, options = {}, baseFilter) {
+  constructor(transport, identity, options = {}, onWarnings) {
     this._queue = new AsyncEventQueue();
     this._active = true;
     this._started = false;
     this._startPromise = null;
     this._lastVersion = 0;
     this._pendingSnapshotRows = [];
+    this._forceFreshSubscribe = false;
     this.id = createStreamingId("sub");
     this._transport = transport;
-    this._tableName = tableName;
-    this._baseFilter = baseFilter;
+    this._identity = identity;
     this._onSnapshot = options.onSnapshot;
     this._onChange = options.onChange;
     this._onError = options.onError;
+    this._onWarnings = onWarnings;
+    this._conflate = options.conflate;
     this._reconnectHandlerKey = `${this.id}::reconnect`;
   }
   get lastVersion() {
@@ -2169,7 +2178,8 @@ var TableSubscription = class {
     }
     try {
       this._pendingSnapshotRows = [];
-      const resumeFrom = this._lastVersion > 0 ? this._lastVersion : void 0;
+      const resumeFrom = this._forceFreshSubscribe || this._lastVersion <= 0 ? void 0 : this._lastVersion;
+      this._forceFreshSubscribe = false;
       await this._sendSubscribe(resumeFrom);
     } catch (error) {
       const wrapped = error instanceof Error ? error : new AoudaConnectionError("Subscription reconnect failed");
@@ -2179,16 +2189,25 @@ var TableSubscription = class {
   async _sendSubscribe(resumeFrom) {
     const message = {
       type: "subscribe",
-      id: this.id,
-      target: this._tableName
+      id: this.id
     };
-    const filter = this._baseFilter;
-    if (filter !== void 0) {
-      message.filter = filter;
+    if (this._identity.kind === "named") {
+      message.hash = this._identity.hash;
+      if (this._identity.args !== void 0) {
+        message.args = this._identity.args;
+      }
+    } else {
+      message.target = this._identity.target;
+      if (this._identity.filter !== void 0) {
+        message.filter = this._identity.filter;
+      }
     }
     if (resumeFrom !== void 0) {
       message.resume_from = resumeFrom;
     }
+    if (this._conflate !== void 0) {
+      message.conflate = this._conflate;
+    }
     await this._transport.send(message);
   }
   _handleMessage(message) {
@@ -2220,6 +2239,9 @@ var TableSubscription = class {
   }
   _handleSnapshotComplete(message) {
     this._lastVersion = message.version;
+    if (message.warnings != null && message.warnings.length > 0) {
+      this._onWarnings?.(message.warnings);
+    }
     const rows = this._pendingSnapshotRows;
     this._pendingSnapshotRows = [];
     this._onSnapshot?.(rows, message.version);
@@ -2249,10 +2271,19 @@ var TableSubscription = class {
       key: message.key,
       version: message.version
     };
+    if (message.values_skipped !== void 0) {
+      event.values_skipped = message.values_skipped;
+    }
     this._onChange?.(event);
     this._queue.push(event);
   }
   _handleServerError(message) {
+    if (message.code === "SLOW_CONSUMER") {
+      this._pendingSnapshotRows = [];
+      this._lastVersion = 0;
+      this._forceFreshSubscribe = true;
+      return;
+    }
     this._pendingSnapshotRows = [];
     const error = new AoudaConnectionError(
       `Subscription error (${message.code}): ${message.message}`
@@ -2960,16 +2991,16 @@ var TableQuery = class _TableQuery {
     const whereClause = this.buildWhereClause();
     const queryFilter = buildSubscriptionFilter(whereClause);
     const mergedFilter = mergeFilterObjects(queryFilter, options.filter);
-    const subscription = new TableSubscription(
-      wsTransport,
-      this.tableName,
-      {
-        onSnapshot: options.onSnapshot,
-        onChange: options.onChange,
-        onError: options.onError
-      },
-      mergedFilter
-    );
+    const subscription = new TableSubscription(wsTransport, {
+      kind: "table",
+      target: this.tableName,
+      filter: mergedFilter
+    }, {
+      onSnapshot: options.onSnapshot,
+      onChange: options.onChange,
+      onError: options.onError,
+      conflate: options.conflate
+    });
     subscription.start();
     return subscription;
   }
@@ -3555,10 +3586,84 @@ function serializeUpdateValue(col, val) {
       else: toNode(cond.else)
     };
   }
+  if ("$upper" in val) {
+    return { type: "call", fn: "upper", args: [unaryCallArg(col, val.$upper)] };
+  }
+  if ("$lower" in val) {
+    return { type: "call", fn: "lower", args: [unaryCallArg(col, val.$lower)] };
+  }
+  if ("$trim" in val) {
+    return { type: "call", fn: "trim", args: [unaryCallArg(col, val.$trim)] };
+  }
+  if ("$concat" in val) {
+    const parts = val.$concat;
+    return {
+      type: "call",
+      fn: "concat",
+      args: parts.map((p) => valueToExprNode(p))
+    };
+  }
+  if ("$substring" in val) {
+    const spec = val.$substring;
+    if (Array.isArray(spec)) {
+      return {
+        type: "call",
+        fn: "substring",
+        args: [{ type: "colRef", col }, ...spec.map((p) => valueToExprNode(p))]
+      };
+    }
+    return {
+      type: "call",
+      fn: "substring",
+      args: [{ type: "colRef", col }, { type: "literal", value: spec }]
+    };
+  }
+  if ("$round" in val) {
+    return {
+      type: "call",
+      fn: "round",
+      args: [
+        { type: "colRef", col },
+        { type: "literal", value: val.$round }
+      ]
+    };
+  }
+  if ("$roundTo" in val) {
+    return {
+      type: "call",
+      fn: "roundTo",
+      args: [
+        { type: "colRef", col },
+        { type: "literal", value: val.$roundTo }
+      ]
+    };
+  }
+  if ("$cast" in val) {
+    return {
+      type: "call",
+      fn: "cast",
+      args: [
+        { type: "colRef", col },
+        { type: "literal", value: val.$cast }
+      ]
+    };
+  }
   throw new Error(
     `Unknown expression operator in update() for column '${col}': ${JSON.stringify(val)}`
   );
 }
+function unaryCallArg(col, operand) {
+  if (operand === true || operand === 1) {
+    return { type: "colRef", col };
+  }
+  return valueToExprNode(operand);
+}
+function valueToExprNode(v) {
+  if (typeof v === "string" && v.startsWith("$")) {
+    return { type: "colRef", col: v.slice(1) };
+  }
+  return { type: "literal", value: v };
+}
 
 // src/tables.ts
 function validateNonEmptyString(value, name) {
@@ -4719,10 +4824,11 @@ function emptyStats() {
   };
 }
 var NamedQueriesApi = class {
-  constructor(transport, database, onWarning) {
+  constructor(transport, database, onWarning, getStreamingTransport) {
     this.transport = transport;
     this.database = database;
     this.onWarning = onWarning;
+    this.getStreamingTransport = getStreamingTransport;
   }
   async execute(hash, args, options) {
     if (typeof hash !== "string" || hash.trim().length === 0) {
@@ -4790,6 +4896,26 @@ var NamedQueriesApi = class {
       return { isError: false, result };
     });
   }
+  subscribe(hash, args, options = {}) {
+    if (typeof hash !== "string" || hash.trim().length === 0) {
+      throw new Error("Named query hash must be a non-empty string");
+    }
+    const subscription = new TableSubscription(
+      this.getStreamingTransport(),
+      { kind: "named", hash, args },
+      {
+        onSnapshot: options.onSnapshot,
+        onChange: options.onChange,
+        onError: options.onError,
+        conflate: options.conflate
+      },
+      (warnings) => {
+        raiseDeprecationWarnings(this.onWarning, warnings);
+      }
+    );
+    subscription.start();
+    return subscription;
+  }
 };
 var NamedMutationsApi = class {
   constructor(transport, database, onWarning) {
@@ -4857,6 +4983,7 @@ var WebSocketTransport = class {
     // Resolved/rejected when the auth handshake completes.
     this._authResolve = null;
     this._authReject = null;
+    this._handshakeComplete = false;
     this._serverUrl = serverUrl;
     this._database = database;
     this._authHandler = options.authHandler;
@@ -4866,6 +4993,11 @@ var WebSocketTransport = class {
     this._maxMissedHeartbeats = options.maxMissedHeartbeats ?? DEFAULT_MAX_MISSED_HEARTBEATS;
     this._enableCompression = options.enableCompression ?? true;
     this._wireMode = options.wireMode ?? "json";
+    this._authHandler?.setOnAccessTokenRefreshed((token) => {
+      if (this._handshakeComplete && this._ws?.readyState === WS_READY_STATE_OPEN) {
+        void this.send({ type: "re_auth", token });
+      }
+    });
   }
   // ─── Public API ────────────────────────────────────────────────────────────
   /** Latest version number from the most recent server `heartbeat` message. */
@@ -5038,6 +5170,7 @@ var WebSocketTransport = class {
         const resolve = this._authResolve;
         this._authResolve = null;
         this._authReject = null;
+        this._handshakeComplete = true;
         if (resolve) resolve();
         break;
       }
@@ -5064,10 +5197,15 @@ var WebSocketTransport = class {
         break;
     }
     const id = "id" in msg ? msg.id : void 0;
-    if (id !== void 0 && id !== null) {
+    if (id !== void 0 && id !== null && id !== "") {
       this._handlers.get(id)?.(msg);
     } else {
       this._handlers.get("__global__")?.(msg);
+      for (const [key, handler] of this._handlers) {
+        if (key !== "__global__") {
+          handler(msg);
+        }
+      }
     }
   }
   // ─── Internal: reconnect ──────────────────────────────────────────────────
@@ -5601,7 +5739,8 @@ var AoudaClient = class {
     this._namedQueries = new NamedQueriesApi(
       this.transport,
       this.database,
-      onNamedArtifactWarning
+      onNamedArtifactWarning,
+      () => this._getOrCreateWebSocketTransport()
     );
     this._namedMutations = new NamedMutationsApi(
       this.transport,