@aouda/client 0.1.9 → 0.1.10

package/dist/cli/index.cjs

@@ -421,7 +421,7 @@ var import_node_url = require("url");
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.9",
+  version: "0.1.10",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -1512,7 +1512,15 @@ var ERROR_CODE_MAP = {
   AUTH_TOKEN_INVALID: AoudaAuthenticationError,
   AUTH_TOKEN_REVOKED: AoudaAuthenticationError,
   AUTH_API_KEY_INVALID: AoudaAuthenticationError,
-  AUTH_REQUIRED: AoudaAuthenticationError
+  AUTH_REQUIRED: AoudaAuthenticationError,
+  NAMED_QUERY_NOT_FOUND: AoudaNotFoundError,
+  NAMED_MUTATION_NOT_FOUND: AoudaNotFoundError,
+  NAMED_QUERY_BATCH_EMPTY: AoudaValidationError,
+  NAMED_QUERY_BATCH_TOO_LARGE: AoudaValidationError,
+  NAMED_QUERY_BATCH_MUTATION: AoudaValidationError,
+  NAMED_QUERY_BIND_FAILED: AoudaValidationError,
+  NAMED_QUERY_PARAM_REQUIRED: AoudaValidationError,
+  NAMED_MUTATION_BIND_FAILED: AoudaValidationError
 };
 function createComposedAbortController(...signals) {
   const controller = new AbortController();
@@ -2405,6 +2413,7 @@ var TableSubscription = class {
     this._started = false;
     this._startPromise = null;
     this._lastVersion = 0;
+    this._pendingSnapshotRows = [];
     this.id = createStreamingId("sub");
     this._transport = transport;
     this._tableName = tableName;
@@ -2461,6 +2470,7 @@ var TableSubscription = class {
       return;
     }
     try {
+      this._pendingSnapshotRows = [];
       const resumeFrom = this._lastVersion > 0 ? this._lastVersion : void 0;
       await this._sendSubscribe(resumeFrom);
     } catch (error) {
@@ -2489,7 +2499,13 @@ var TableSubscription = class {
     }
     switch (message.type) {
       case "snapshot":
-        this._handleSnapshot(message);
+        this._handleSnapshotPage(message);
+        return;
+      case "snapshot_complete":
+        this._handleSnapshotComplete(message);
+        return;
+      case "gap":
+        void this._handleGap(message);
         return;
       case "change":
         this._handleChange(message);
@@ -2501,9 +2517,13 @@ var TableSubscription = class {
         return;
     }
   }
-  _handleSnapshot(message) {
+  _handleSnapshotPage(message) {
+    this._pendingSnapshotRows.push(...message.rows);
+  }
+  _handleSnapshotComplete(message) {
     this._lastVersion = message.version;
-    const rows = message.rows;
+    const rows = this._pendingSnapshotRows;
+    this._pendingSnapshotRows = [];
     this._onSnapshot?.(rows, message.version);
     this._queue.push({
       type: "snapshot",
@@ -2511,6 +2531,16 @@ var TableSubscription = class {
       version: message.version
     });
   }
+  async _handleGap(message) {
+    this._pendingSnapshotRows = [];
+    this._lastVersion = message.last_seq;
+    try {
+      await this._sendSubscribe(message.last_seq);
+    } catch (error) {
+      const wrapped = error instanceof Error ? error : new AoudaConnectionError("Subscription gap resume failed");
+      this._notifyError(wrapped);
+    }
+  }
   _handleChange(message) {
     this._lastVersion = message.version;
     const event = {
@@ -2525,6 +2555,7 @@ var TableSubscription = class {
     this._queue.push(event);
   }
   _handleServerError(message) {
+    this._pendingSnapshotRows = [];
     const error = new AoudaConnectionError(
       `Subscription error (${message.code}): ${message.message}`
     );
@@ -4932,6 +4963,147 @@ var MaterializedQueriesApi = class {
   }
 };
 
+// src/named-queries.ts
+var MAX_NAMED_QUERY_BATCH_SIZE = 32;
+function raiseDeprecationWarnings(sink, warnings) {
+  if (warnings == null) return;
+  for (const warning of warnings) {
+    if (warning.code !== "NAMED_QUERY_DEPRECATED" && warning.code !== "NAMED_MUTATION_DEPRECATED") {
+      continue;
+    }
+    const sunset = warning.sunsetAt != null ? ` sunsetAt=${warning.sunsetAt}` : "";
+    const hash = warning.hash != null && warning.hash.length > 0 ? ` hash=${warning.hash}` : "";
+    sink({
+      code: warning.code,
+      hash: warning.hash,
+      sunsetAt: warning.sunsetAt,
+      message: `${warning.code}:${hash}${sunset}`.trim()
+    });
+  }
+}
+function emptyStats() {
+  return {
+    rowsScanned: 0,
+    rowsReturned: 0,
+    segmentsAccessed: 0,
+    executionMs: 0
+  };
+}
+var NamedQueriesApi = class {
+  constructor(transport, database, onWarning) {
+    this.transport = transport;
+    this.database = database;
+    this.onWarning = onWarning;
+  }
+  async execute(hash, args, options) {
+    if (typeof hash !== "string" || hash.trim().length === 0) {
+      throw new Error("Named query hash must be a non-empty string");
+    }
+    const prefix = databasePath2(this.database);
+    const path4 = `${prefix}/named-queries/${encodeURIComponent(hash)}/query?format=columnar`;
+    const response = await this.transport.post(
+      path4,
+      { args: args ?? {} },
+      { signal: options?.signal }
+    );
+    const rows = columnarToRows(response);
+    raiseDeprecationWarnings(this.onWarning, response.warnings);
+    return {
+      rows,
+      stats: response.stats,
+      warnings: response.warnings
+    };
+  }
+  async batch(items, options) {
+    if (items.length === 0) {
+      throw new AoudaValidationError(
+        "Named query batch requires a non-empty queries array.",
+        "NAMED_QUERY_BATCH_EMPTY",
+        400
+      );
+    }
+    if (items.length > MAX_NAMED_QUERY_BATCH_SIZE) {
+      throw new AoudaValidationError(
+        `Named query batch exceeds ${MAX_NAMED_QUERY_BATCH_SIZE} elements.`,
+        "NAMED_QUERY_BATCH_TOO_LARGE",
+        400
+      );
+    }
+    const prefix = databasePath2(this.database);
+    const path4 = `${prefix}/named-queries/batch?format=columnar`;
+    const envelope = await this.transport.post(
+      path4,
+      { queries: items },
+      { signal: options?.signal }
+    );
+    return (envelope.results ?? []).map((slot) => {
+      if (slot.code != null && slot.code.length > 0) {
+        return {
+          isError: true,
+          code: slot.code,
+          error: slot.error
+        };
+      }
+      const columnar = {
+        columns: slot.columns ?? [],
+        types: slot.types ?? [],
+        data: slot.data ?? [],
+        rowCount: slot.rowCount ?? 0,
+        stats: slot.stats ?? emptyStats(),
+        warnings: slot.warnings
+      };
+      const result = {
+        rows: columnarToRows(columnar),
+        stats: columnar.stats,
+        warnings: slot.warnings
+      };
+      raiseDeprecationWarnings(this.onWarning, slot.warnings);
+      return { isError: false, result };
+    });
+  }
+};
+var NamedMutationsApi = class {
+  constructor(transport, database, onWarning) {
+    this.transport = transport;
+    this.database = database;
+    this.onWarning = onWarning;
+  }
+  async execute(hash, args) {
+    if (typeof hash !== "string" || hash.trim().length === 0) {
+      throw new Error("Named mutation hash must be a non-empty string");
+    }
+    const prefix = databasePath2(this.database);
+    const path4 = `${prefix}/named-mutations/${encodeURIComponent(hash)}/execute`;
+    const wire = await this.transport.post(path4, {
+      args: args ?? {}
+    });
+    let op = "unknown";
+    let rowsAffected = 0;
+    if (wire.rowsInserted != null) {
+      op = "insert";
+      rowsAffected = wire.rowsInserted;
+    } else if (wire.rowsUpdated != null) {
+      op = "update";
+      rowsAffected = wire.rowsUpdated;
+    } else if (wire.rowsDeleted != null) {
+      op = "delete";
+      rowsAffected = wire.rowsDeleted;
+    }
+    raiseDeprecationWarnings(this.onWarning, wire.warnings);
+    const returning = wire.rows == null ? void 0 : {
+      rows: columnarToRows(wire.rows),
+      stats: wire.rows.stats,
+      warnings: wire.rows.warnings
+    };
+    return {
+      op,
+      rowsAffected,
+      returning,
+      warnings: wire.warnings
+    };
+  }
+};
+
 // src/streaming/websocket-transport.ts
 var import_msgpack = require("@msgpack/msgpack");
 var DEFAULT_PING_INTERVAL_MS = 2e4;
@@ -5694,6 +5866,19 @@ var AoudaClient = class {
       this.transport,
       this.database
     );
+    const onNamedArtifactWarning = options.onNamedArtifactWarning ?? ((warning) => {
+      console.warn(warning.message);
+    });
+    this._namedQueries = new NamedQueriesApi(
+      this.transport,
+      this.database,
+      onNamedArtifactWarning
+    );
+    this._namedMutations = new NamedMutationsApi(
+      this.transport,
+      this.database,
+      onNamedArtifactWarning
+    );
   }
   /**
    * Connects to the Aouda server.
@@ -5836,6 +6021,18 @@ var AoudaClient = class {
   get materializedQueries() {
     return this._materializedQueries;
   }
+  /**
+   * Hash-only named-query execute and batch. Names are codegen aliases (D-5).
+   */
+  get namedQueries() {
+    return this._namedQueries;
+  }
+  /**
+   * Hash-only named-mutation execute. No batch.
+   */
+  get namedMutations() {
+    return this._namedMutations;
+  }
   /**
    * Access auth operations (signUp, signIn, signOut, refresh, me, changePassword).
    * @returns The auth API.
@@ -5984,7 +6181,7 @@ Usage:
   npx @aouda/client schema <command> [options]
 
 Commands:
-  generate    Fetch schema from Aouda server and output TypeScript types
+  generate    Fetch schema from Aouda server and output TypeScript types (tables + named query/mutation hashes)
   schema      Schema management (diff, apply, export, validate, history, seed)
     diff      Show migration plan (desired vs current)
     apply    Apply schema (use --allow-destructive for drops; --dry-run to preview)