@persql/sdk 1.1.0 → 1.2.0

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PerSQL
-} from "./chunk-YZEQFTCX.js";
+} from "./chunk-GH75ERQ6.js";
 
 // src/cli.ts
 import { writeFile } from "fs/promises";

package/dist/index.cjs

@@ -26,6 +26,7 @@ __export(index_exports, {
   PerSQLApprovals: () => PerSQLApprovals,
   PerSQLBranches: () => PerSQLBranches,
   PerSQLDatabase: () => PerSQLDatabase,
+  PerSQLDatabases: () => PerSQLDatabases,
   PerSQLError: () => PerSQLError,
   PerSQLProposals: () => PerSQLProposals,
   RateLimitError: () => RateLimitError,
@@ -316,8 +317,23 @@ var PerSQL = class _PerSQL {
     }
     return new PerSQLDatabase(this, ns, slug);
   }
+  /**
+   * Provision and list databases in the token's namespace. `create`
+   * needs an unscoped admin token; `database()` then gives you a handle
+   * to query the result.
+   */
+  get databases() {
+    return new PerSQLDatabases(this);
+  }
   /** @internal */
   async request(method, path, body, headers) {
+    return (await this.requestWithMeta(method, path, body, headers)).data;
+  }
+  /**
+   * @internal — like `request`, but also surfaces the response `meta`
+   * envelope (usage + `costUsd`) that the data-only `request` drops.
+   */
+  async requestWithMeta(method, path, body, headers) {
     const res = await this._fetch(`${this.baseURL}${path}`, {
       method,
       headers: {
@@ -349,7 +365,7 @@ var PerSQL = class _PerSQL {
       }
       throw new PerSQLError(res.status, message, envelope?.errorDetail);
     }
-    return envelope.data;
+    return { data: envelope.data, meta: envelope.meta };
   }
   /** @internal — raw fetch returning the underlying Response. */
   fetchRaw(method, path) {
@@ -420,6 +436,44 @@ var SupportClient = class {
     );
   }
 };
+var PerSQLDatabases = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Provision a new isolated database and return its metadata. Requires
+   * an unscoped admin token (scoped tokens can't create databases).
+   */
+  async create(opts) {
+    if (this.client.local) {
+      throw new Error(
+        "PerSQL: databases.create() needs a server-mode token. Pass a real token to `new PerSQL({ token })` to provision databases."
+      );
+    }
+    return this.client.request("POST", "/v1/databases", {
+      name: opts.name,
+      slug: opts.slug,
+      region: opts.region,
+      ttlDays: opts.ttlDays
+    });
+  }
+  /** List databases in the token's namespace, newest first (paginated). */
+  async list(opts = {}) {
+    if (this.client.local) {
+      throw new Error("PerSQL: databases.list() needs a server-mode token.");
+    }
+    const qs = new URLSearchParams();
+    if (opts.cursor) qs.set("cursor", opts.cursor);
+    if (opts.pageSize) qs.set("pageSize", String(opts.pageSize));
+    const tail = qs.toString() ? `?${qs.toString()}` : "";
+    const res = await this.client.fetchRaw("GET", `/v1/databases${tail}`);
+    const body = await res.json();
+    if (!res.ok || !body.success) {
+      throw new PerSQLError(res.status, body.error ?? `Request failed (${res.status})`);
+    }
+    return { data: body.data ?? [], nextCursor: body.nextCursor ?? null };
+  }
+};
 var PerSQLDatabase = class {
   constructor(client, namespace, slug) {
     this.client = client;
@@ -436,7 +490,7 @@ var PerSQLDatabase = class {
     if (options.idempotencyKey) headers["Idempotency-Key"] = options.idempotencyKey;
     if (options.planKey) headers["Plan-Key"] = options.planKey;
     if (options.planStep) headers["Plan-Step"] = options.planStep;
-    const raw = await this.client.request(
+    const { data: raw, meta } = await this.client.requestWithMeta(
       "POST",
       `/v1/db/${this.namespace}/${this.slug}/query`,
       { sql, params },
@@ -444,7 +498,8 @@ var PerSQLDatabase = class {
     );
     return {
       ...raw,
-      data: rowsToObjects(raw.columns, raw.rows)
+      data: rowsToObjects(raw.columns, raw.rows),
+      meta
     };
   }
   /** Run multiple statements in one round-trip, optionally in a transaction. */
@@ -2019,6 +2074,7 @@ function rowsToObjects(columns, rows) {
   PerSQLApprovals,
   PerSQLBranches,
   PerSQLDatabase,
+  PerSQLDatabases,
   PerSQLError,
   PerSQLProposals,
   RateLimitError,