@aouda/client 0.1.15 → 0.1.17

package/README.md

@@ -75,7 +75,7 @@ Generate TypeScript types from your Aouda schema (B.8 CLI):
 npx @aouda/client generate --server http://localhost:5000 --output ./types/
 ```
 
-The generated file (e.g. `schema.ts`) exports a `Schema` interface, a `TableName` union, and one interface per table. That shape is compatible with the typed client: use it as the generic for `createAoudaClient<Schema>(options)`.
+The generated file (e.g. `schema.ts`) exports a `Schema` interface, a `TableName` union, and one interface per table. Named-query `*Row` interfaces include `selectExpr` aliases with server-inferred TypeScript types (`Int32` → `number`, uninferable → `unknown`) after generate against a post-S08 server. That shape is compatible with the typed client: use it as the generic for `createAoudaClient<Schema>(options)`.
 
 ```typescript
 import { createAoudaClient } from '@aouda/client';

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.15",
+  version: "0.1.17",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -514,9 +514,10 @@ var AoudaError = class extends Error {
   }
 };
 var AoudaConnectionError = class extends AoudaError {
-  constructor(message, cause) {
+  constructor(message, cause, rowErrors) {
     super(message);
     this.cause = cause;
+    this.rowErrors = rowErrors;
     this.name = "AoudaConnectionError";
   }
 };
@@ -536,7 +537,7 @@ var AoudaResponseError = class extends AoudaError {
   }
 };
 var AoudaApiError = class extends AoudaError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
     super(message);
     this.code = code;
     this.statusCode = statusCode;
@@ -544,36 +545,37 @@ var AoudaApiError = class extends AoudaError {
     this.requestId = requestId;
     this.retryAfterSeconds = retryAfterSeconds;
     this.token = token;
+    this.rowErrors = rowErrors;
     this.name = "AoudaApiError";
   }
 };
 var AoudaNotFoundError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaNotFoundError";
   }
 };
 var AoudaConflictError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaConflictError";
   }
 };
 var AoudaValidationError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaValidationError";
   }
 };
 var AoudaServerError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaServerError";
   }
 };
 var AoudaAuthenticationError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token) {
-    super(message, code, statusCode, details, requestId, retryAfterSeconds, token);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds, token, rowErrors);
     this.name = "AoudaAuthenticationError";
   }
 };
@@ -1510,6 +1512,10 @@ var ERROR_CODE_MAP = {
   INVALID_OPERATOR: AoudaValidationError,
   INVALID_COLUMN: AoudaValidationError,
   INVALID_VALUE: AoudaValidationError,
+  CONSTRAINT_CHECK_VIOLATION: AoudaValidationError,
+  TRANSFORM_DERIVED_READONLY: AoudaValidationError,
+  TRANSFORM_ROUTE_UNMATCHED: AoudaValidationError,
+  TRANSFORM_ROUTE_AMBIGUOUS: AoudaValidationError,
   UNSUPPORTED_VERSION: AoudaValidationError,
   MALFORMED_REQUEST: AoudaValidationError,
   INTERNAL_ERROR: AoudaServerError,
@@ -1570,6 +1576,9 @@ function parseRetryAfterSeconds(header) {
   if (!Number.isFinite(n) || n < 0) return void 0;
   return n;
 }
+function nonEmptyRowErrors(rowErrors) {
+  return Array.isArray(rowErrors) && rowErrors.length > 0 ? rowErrors : void 0;
+}
 function createApiError(statusCode, statusText, body, retryAfterHeader) {
   const message = body.error ?? `${statusCode} ${statusText}`;
   const code = body.code ?? "UNKNOWN";
@@ -1577,7 +1586,16 @@ function createApiError(statusCode, statusText, body, retryAfterHeader) {
   const requestId = body.requestId;
   const retryAfterSeconds = parseRetryAfterSeconds(retryAfterHeader ?? null);
   const Ctor = ERROR_CODE_MAP[code] ?? AoudaApiError;
-  return new Ctor(message, code, statusCode, details, requestId, retryAfterSeconds, body.token);
+  return new Ctor(
+    message,
+    code,
+    statusCode,
+    details,
+    requestId,
+    retryAfterSeconds,
+    body.token,
+    nonEmptyRowErrors(body.rowErrors)
+  );
 }
 var HttpTransport = class {
   constructor(options) {
@@ -1691,7 +1709,8 @@ var HttpTransport = class {
             errorBody?.details,
             errorBody?.requestId,
             void 0,
-            errorBody?.token
+            errorBody?.token,
+            nonEmptyRowErrors(errorBody?.rowErrors)
           );
         }
         if (errorBody?.code != null) {
@@ -1810,7 +1829,8 @@ var HttpTransport = class {
           errorBody?.details,
           errorBody?.requestId,
           void 0,
-          errorBody?.token
+          errorBody?.token,
+          nonEmptyRowErrors(errorBody?.rowErrors)
         );
       }
       if (errorBody?.code != null) {
@@ -2900,8 +2920,11 @@ var TableWriteStream = class {
     resolve4?.();
   }
   _handleServerError(message) {
+    const rowErrors = Array.isArray(message.errors) && message.errors.length > 0 ? message.errors : void 0;
     const error = new AoudaConnectionError(
-      `Write stream error (${message.code}): ${message.message}`
+      `Write stream error (${message.code}): ${message.message}`,
+      void 0,
+      rowErrors
     );
     const openReject = this._openReject;
     this._openResolve = null;
@@ -3353,6 +3376,12 @@ var TableQuery = class _TableQuery {
    * evaluated per row on the server. Computed columns are appended after any physical-column
    * `select()` projection.
    *
+   * Result types are inferred by the server where the expression permits
+   * (e.g. Int32 → `number`). Uninferable expressions use wire `"Unknown"` /
+   * codegen `unknown`. Computed columns are always nullable. Named-query
+   * `*Row` properties pick this up when regenerated against a post-S08 server.
+   * See aouda-docs/guides/browser-tier-read-limits.md#selectexpr-result-types
+   *
    * @param projections - One or more `{ alias, expr }` pairs.
    * @returns A new TableQuery with computed columns set.
    *
@@ -4925,14 +4954,21 @@ var BackupAdminApi = class {
     return this.transport.get(`${BASE_PATH4}/list`);
   }
   /**
-   * Restore a backup by id.
-   * POST /admin/backup/restore/{id}
+   * Restore a backup. The string form is an exact restore of that id
+   * (`POST /admin/backup/restore/{id}` with `{}`). The object form posts the body to
+   * `POST /admin/backup/restore` and may carry `targetTime` for point-in-time recovery.
    */
-  async restore(backupId) {
-    const encoded = encodeURIComponent(backupId);
+  async restore(input) {
+    if (typeof input === "string") {
+      const encoded = encodeURIComponent(input);
+      return this.transport.post(
+        `${BASE_PATH4}/restore/${encoded}`,
+        {}
+      );
+    }
     return this.transport.post(
-      `${BASE_PATH4}/restore/${encoded}`,
-      {}
+      `${BASE_PATH4}/restore`,
+      input
     );
   }
   /**