@aouda/client 0.1.11 → 0.1.13

package/dist/index.cjs

@@ -64,6 +64,7 @@ __export(index_exports, {
   NamedMutationsApi: () => NamedMutationsApi,
   NamedQueriesApi: () => NamedQueriesApi,
   NodeAdminApi: () => NodeAdminApi,
+  PolicyApi: () => PolicyApi,
   ReplicationAdminApi: () => ReplicationAdminApi,
   RetryPolicy: () => RetryPolicy,
   ServerAdminApi: () => ServerAdminApi,
@@ -86,7 +87,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.11",
+  version: "0.1.13",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -1132,7 +1133,9 @@ var BulkLoadCoordinator = class {
         replicationMode: options.replicationMode,
         forceSingleNodeReplicationBypass: options.forceSingleNodeReplicationBypass,
         postLoadMqBehavior: options.postLoadMqBehavior,
-        ...options.identityInsert === true ? { identityInsert: true } : {}
+        ...options.identityInsert === true ? { identityInsert: true } : {},
+        ...options.applyTransforms === true ? { applyTransforms: true } : {},
+        ...options.preTransformed === true ? { preTransformed: true } : {}
       }
     };
     const beginResp = await this.transport.post(
@@ -1225,7 +1228,11 @@ var ERROR_CODE_MAP = {
   NAMED_QUERY_BATCH_MUTATION: AoudaValidationError,
   NAMED_QUERY_BIND_FAILED: AoudaValidationError,
   NAMED_QUERY_PARAM_REQUIRED: AoudaValidationError,
-  NAMED_MUTATION_BIND_FAILED: AoudaValidationError
+  NAMED_MUTATION_BIND_FAILED: AoudaValidationError,
+  AUTH_IDENTITY_INVALID: AoudaValidationError,
+  AUTH_IDENTITY_NOT_FOUND: AoudaValidationError,
+  BULK_LOAD_TRANSFORM_INTENT_REQUIRED: AoudaValidationError,
+  BULK_LOAD_TRANSFORM_INTENT_CONFLICT: AoudaValidationError
 };
 function createComposedAbortController(...signals) {
   const controller = new AbortController();
@@ -2112,7 +2119,7 @@ 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;
@@ -2122,11 +2129,11 @@ var TableSubscription = class {
     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`;
   }
@@ -2189,12 +2196,18 @@ 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;
@@ -2233,6 +2246,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);
@@ -2982,17 +2998,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,
-        conflate: options.conflate
-      },
-      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;
   }
@@ -3578,10 +3593,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) {
@@ -4742,10 +4831,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) {
@@ -4813,6 +4903,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) {
@@ -4856,6 +4966,20 @@ var NamedMutationsApi = class {
   }
 };
 
+// src/policy.ts
+var PolicyApi = class {
+  constructor(transport, database) {
+    this.transport = transport;
+    this.database = database;
+  }
+  inspect(body, options) {
+    const path = `${databasePath2(this.database)}/policy/inspect`;
+    return this.transport.post(path, body, {
+      signal: options?.signal
+    });
+  }
+};
+
 // src/streaming/websocket-transport.ts
 var import_msgpack = require("@msgpack/msgpack");
 var DEFAULT_PING_INTERVAL_MS = 2e4;
@@ -5636,13 +5760,15 @@ var AoudaClient = class {
     this._namedQueries = new NamedQueriesApi(
       this.transport,
       this.database,
-      onNamedArtifactWarning
+      onNamedArtifactWarning,
+      () => this._getOrCreateWebSocketTransport()
     );
     this._namedMutations = new NamedMutationsApi(
       this.transport,
       this.database,
       onNamedArtifactWarning
     );
+    this._policy = new PolicyApi(this.transport, this.database);
   }
   /**
    * Connects to the Aouda server.
@@ -5797,6 +5923,12 @@ var AoudaClient = class {
   get namedMutations() {
     return this._namedMutations;
   }
+  /**
+   * Policy inspect (`POST …/policy/inspect`). Admin on the data DB.
+   */
+  get policy() {
+    return this._policy;
+  }
   /**
    * Access auth operations (signUp, signIn, signOut, refresh, me, changePassword).
    * @returns The auth API.
@@ -6221,6 +6353,7 @@ var version = package_default.version;
   NamedMutationsApi,
   NamedQueriesApi,
   NodeAdminApi,
+  PolicyApi,
   ReplicationAdminApi,
   RetryPolicy,
   ServerAdminApi,