@aouda/client 0.0.3 → 0.1.0

package/dist/{client-Bvs1yerF.d.cts → client-Dttx8D7c.d.cts}

@@ -923,6 +923,23 @@ interface DatabaseInfo {
     state: string;
     createdAt: string;
     options: DatabaseOptionsInfo;
+    /**
+     * True if this is an Aouda-owned infrastructure database (e.g. `_serverauth`, `_settings`).
+     * Internal databases are hidden from the default catalog list.
+     * Clients should not use internal databases as data-explorer targets.
+     */
+    isInternal: boolean;
+    /**
+     * True if this database contains auth system tables (_users, _roles, etc.).
+     * Application auth databases have isInternal=false and remain in the default list.
+     */
+    isAuthDatabase: boolean;
+    /**
+     * Auth database classification: "none" | "server" | "application".
+     * "server" databases are managed via /api/auth/admin/... (never in data explorer).
+     * "application" databases are end-user auth stores browsable via the data explorer.
+     */
+    authDatabaseKind: "none" | "server" | "application";
 }
 /**
  * Options when creating a database (camelCase, matches server request).
@@ -2927,12 +2944,19 @@ declare class DatabasesApi {
     private readonly transport;
     constructor(transport: Transport);
     /**
-     * Lists all databases on the server.
+     * Lists databases on the server.
      * GET /api/databases
      *
-     * @returns Array of database info (name, state, createdAt, options).
+     * By default only operator-facing databases (isInternal === false) are returned.
+     * Pass `{ includeInternal: true }` to receive the full catalog including internal
+     * infrastructure databases such as `_serverauth` and `_settings`.
+     *
+     * @param options.includeInternal - When true, appends `?include=internal` to the request.
+     * @returns Array of database info.
      */
-    list(): Promise<DatabaseInfo[]>;
+    list(options?: {
+        includeInternal?: boolean;
+    }): Promise<DatabaseInfo[]>;
     /**
      * Creates a new database.
      * POST /api/databases

package/dist/{client-Bvs1yerF.d.ts → client-Dttx8D7c.d.ts}

@@ -923,6 +923,23 @@ interface DatabaseInfo {
     state: string;
     createdAt: string;
     options: DatabaseOptionsInfo;
+    /**
+     * True if this is an Aouda-owned infrastructure database (e.g. `_serverauth`, `_settings`).
+     * Internal databases are hidden from the default catalog list.
+     * Clients should not use internal databases as data-explorer targets.
+     */
+    isInternal: boolean;
+    /**
+     * True if this database contains auth system tables (_users, _roles, etc.).
+     * Application auth databases have isInternal=false and remain in the default list.
+     */
+    isAuthDatabase: boolean;
+    /**
+     * Auth database classification: "none" | "server" | "application".
+     * "server" databases are managed via /api/auth/admin/... (never in data explorer).
+     * "application" databases are end-user auth stores browsable via the data explorer.
+     */
+    authDatabaseKind: "none" | "server" | "application";
 }
 /**
  * Options when creating a database (camelCase, matches server request).
@@ -2927,12 +2944,19 @@ declare class DatabasesApi {
     private readonly transport;
     constructor(transport: Transport);
     /**
-     * Lists all databases on the server.
+     * Lists databases on the server.
      * GET /api/databases
      *
-     * @returns Array of database info (name, state, createdAt, options).
+     * By default only operator-facing databases (isInternal === false) are returned.
+     * Pass `{ includeInternal: true }` to receive the full catalog including internal
+     * infrastructure databases such as `_serverauth` and `_settings`.
+     *
+     * @param options.includeInternal - When true, appends `?include=internal` to the request.
+     * @returns Array of database info.
      */
-    list(): Promise<DatabaseInfo[]>;
+    list(options?: {
+        includeInternal?: boolean;
+    }): Promise<DatabaseInfo[]>;
     /**
      * Creates a new database.
      * POST /api/databases

package/dist/index.cjs

@@ -79,7 +79,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.0.3",
+  version: "0.1.0",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -3641,13 +3641,19 @@ var DatabasesApi = class {
     this.transport = transport;
   }
   /**
-   * Lists all databases on the server.
+   * Lists databases on the server.
    * GET /api/databases
    *
-   * @returns Array of database info (name, state, createdAt, options).
+   * By default only operator-facing databases (isInternal === false) are returned.
+   * Pass `{ includeInternal: true }` to receive the full catalog including internal
+   * infrastructure databases such as `_serverauth` and `_settings`.
+   *
+   * @param options.includeInternal - When true, appends `?include=internal` to the request.
+   * @returns Array of database info.
    */
-  async list() {
-    const response = await this.transport.get("/api/databases");
+  async list(options) {
+    const path = options?.includeInternal ? "/api/databases?include=internal" : "/api/databases";
+    const response = await this.transport.get(path);
     return response.databases;
   }
   /**