@bunbase-ae/js 2.2.1-next.91.0a68695 → 2.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "2.2.1-next.91.0a68695",
+  "version": "2.3.1",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
   "license": "UNLICENSED",

package/src/admin.ts

@@ -966,6 +966,97 @@ class AdminMigrationsClient {
   }
 }
 
+// ─── Named queries ────────────────────────────────────────────────────────────
+
+export type NamedQueryParamType = "string" | "number" | "boolean" | "timestamp";
+
+export interface NamedQueryParamDef {
+  type: NamedQueryParamType;
+  required?: boolean;
+}
+
+export interface NamedQuery {
+  name: string;
+  description: string | null;
+  sql: string;
+  params: Record<string, NamedQueryParamDef>;
+  access: AccessRule;
+  row_limit: number;
+  timeout_ms: number;
+  result_cache_ttl_s: number;
+  created_at: number;
+  updated_at: number;
+}
+
+export interface NamedQueryExecuteResult {
+  rows: Record<string, unknown>[];
+  row_count: number;
+  cached: boolean;
+  elapsed_ms: number;
+}
+
+export interface CreateNamedQueryInput {
+  name: string;
+  description?: string | null;
+  sql: string;
+  params?: Record<string, NamedQueryParamDef>;
+  access?: AccessRule;
+  row_limit?: number;
+  timeout_ms?: number;
+  result_cache_ttl_s?: number;
+}
+
+export type UpdateNamedQueryInput = Partial<Omit<CreateNamedQueryInput, "name">>;
+
+class AdminNamedQueriesClient {
+  constructor(private readonly http: HttpClient) {}
+
+  async list(): Promise<NamedQuery[]> {
+    return this.http.request<NamedQuery[]>("GET", "/api/v1/admin/queries");
+  }
+
+  async get(name: string): Promise<NamedQuery | null> {
+    try {
+      return await this.http.request<NamedQuery>(
+        "GET",
+        `/api/v1/admin/queries/${encodeURIComponent(name)}`,
+      );
+    } catch (err) {
+      if (err instanceof Error && "status" in err && (err as { status: number }).status === 404) {
+        return null;
+      }
+      throw err;
+    }
+  }
+
+  async create(input: CreateNamedQueryInput): Promise<NamedQuery> {
+    return this.http.request<NamedQuery>("POST", "/api/v1/admin/queries", { body: input });
+  }
+
+  async update(name: string, input: UpdateNamedQueryInput): Promise<NamedQuery> {
+    return this.http.request<NamedQuery>(
+      "PATCH",
+      `/api/v1/admin/queries/${encodeURIComponent(name)}`,
+      { body: input },
+    );
+  }
+
+  async delete(name: string): Promise<void> {
+    await this.http.request("DELETE", `/api/v1/admin/queries/${encodeURIComponent(name)}`);
+  }
+
+  async execute(
+    name: string,
+    params: Record<string, unknown> = {},
+  ): Promise<NamedQueryExecuteResult> {
+    return this.http.request<NamedQueryExecuteResult>(
+      "POST",
+      `/api/v1/queries/${encodeURIComponent(name)}/execute`,
+      { body: params },
+    );
+  }
+}
+
 // ─── Main AdminClient ─────────────────────────────────────────────────────────
 
 export class AdminClient {
@@ -977,6 +1068,7 @@ export class AdminClient {
   readonly settings: AdminSettingsClient;
   readonly backups: AdminBackupsClient;
   readonly migrations: AdminMigrationsClient;
+  readonly queries: AdminNamedQueriesClient;
   readonly logs: AdminLogsClient;
   readonly system: AdminSystemClient;
 
@@ -989,6 +1081,7 @@ export class AdminClient {
     this.settings = new AdminSettingsClient(http);
     this.backups = new AdminBackupsClient(http);
     this.migrations = new AdminMigrationsClient(http);
+    this.queries = new AdminNamedQueriesClient(http);
     this.logs = new AdminLogsClient(http);
     this.system = new AdminSystemClient(http);
   }

package/src/index.ts

@@ -16,6 +16,7 @@ export {
   type CollectionStats,
   type ColumnInfo,
   type ConfigResponse,
+  type CreateNamedQueryInput,
   type CreateRelationParams,
   type EmailTemplate,
   type HealthResponse,
@@ -23,6 +24,10 @@ export {
   type IndexInfo,
   type MigrationStatus,
   type MinuteBucket,
+  type NamedQuery,
+  type NamedQueryExecuteResult,
+  type NamedQueryParamDef,
+  type NamedQueryParamType,
   type Relation,
   type RelationOnDelete,
   type RelationType,
@@ -31,6 +36,7 @@ export {
   type StatsResponse,
   type StorageBucket,
   type TemplateName,
+  type UpdateNamedQueryInput,
   type UpdateUserParams,
   type WebhookLogRow,
 } from "./admin";