@ragable/sdk 0.6.15 → 0.6.16

package/dist/index.d.mts

@@ -927,6 +927,48 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     truncated: boolean;
     rows: Row[];
 }
+interface BrowserCollectionRecord<Row extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    data: Row;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BrowserCollectionDefinition {
+    id: string;
+    name: string;
+    schema: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BrowserCollectionFindParams {
+    where?: Record<string, unknown>;
+    filters?: Array<{
+        field: string;
+        op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
+        value: unknown;
+    }>;
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDirection?: "asc" | "desc";
+}
+declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly database;
+    private readonly name;
+    private readonly databaseInstanceId?;
+    constructor(database: RagableBrowserDatabaseClient<any>, name: string, databaseInstanceId?: string | undefined);
+    find: (whereOrParams?: Record<string, unknown> | BrowserCollectionFindParams) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
+    insert: (data: Row) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
+    update: (where: Record<string, unknown>, patch: Partial<Row>, options?: {
+        limit?: number;
+    }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
+    delete: (where: Record<string, unknown>, options?: {
+        limit?: number;
+    }) => Promise<PostgrestResult<{
+        deleted: number;
+        records: BrowserCollectionRecord<Row>[];
+    }>>;
+}
 declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = DefaultRagableDatabase> {
     private readonly options;
     private readonly ragableAuth;
@@ -941,6 +983,10 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
      */
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     private toUrl;
+    collection: <Row extends Record<string, unknown> = Record<string, unknown>>(name: string, databaseInstanceId?: string) => BrowserCollectionApi<Row>;
+    defineCollection: (name: string, schema?: Record<string, unknown>, databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition>>;
+    listCollections: (databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition[]>>;
+    _requestCollection<T>(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body?: unknown, databaseInstanceId?: string): Promise<T>;
     query: <Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams) => Promise<PostgrestResult<BrowserSqlQueryResult<Row>>>;
     private baseHeaders;
     /**
@@ -1043,6 +1089,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly agents: RagableBrowserAgentsClient;
     readonly auth: RagableBrowserAuthClient<AuthUser>;
     readonly database: RagableBrowserDatabaseClient<Database>;
+    readonly db: RagableBrowserDatabaseClient<Database>;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);

package/dist/index.d.ts

@@ -927,6 +927,48 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     truncated: boolean;
     rows: Row[];
 }
+interface BrowserCollectionRecord<Row extends Record<string, unknown> = Record<string, unknown>> {
+    id: string;
+    data: Row;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BrowserCollectionDefinition {
+    id: string;
+    name: string;
+    schema: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BrowserCollectionFindParams {
+    where?: Record<string, unknown>;
+    filters?: Array<{
+        field: string;
+        op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "contains";
+        value: unknown;
+    }>;
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDirection?: "asc" | "desc";
+}
+declare class BrowserCollectionApi<Row extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly database;
+    private readonly name;
+    private readonly databaseInstanceId?;
+    constructor(database: RagableBrowserDatabaseClient<any>, name: string, databaseInstanceId?: string | undefined);
+    find: (whereOrParams?: Record<string, unknown> | BrowserCollectionFindParams) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
+    insert: (data: Row) => Promise<PostgrestResult<BrowserCollectionRecord<Row>>>;
+    update: (where: Record<string, unknown>, patch: Partial<Row>, options?: {
+        limit?: number;
+    }) => Promise<PostgrestResult<BrowserCollectionRecord<Row>[]>>;
+    delete: (where: Record<string, unknown>, options?: {
+        limit?: number;
+    }) => Promise<PostgrestResult<{
+        deleted: number;
+        records: BrowserCollectionRecord<Row>[];
+    }>>;
+}
 declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = DefaultRagableDatabase> {
     private readonly options;
     private readonly ragableAuth;
@@ -941,6 +983,10 @@ declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = De
      */
     from: <TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string) => PostgrestTableApi<Database, TableName>;
     private toUrl;
+    collection: <Row extends Record<string, unknown> = Record<string, unknown>>(name: string, databaseInstanceId?: string) => BrowserCollectionApi<Row>;
+    defineCollection: (name: string, schema?: Record<string, unknown>, databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition>>;
+    listCollections: (databaseInstanceId?: string) => Promise<PostgrestResult<BrowserCollectionDefinition[]>>;
+    _requestCollection<T>(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body?: unknown, databaseInstanceId?: string): Promise<T>;
     query: <Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams) => Promise<PostgrestResult<BrowserSqlQueryResult<Row>>>;
     private baseHeaders;
     /**
@@ -1043,6 +1089,7 @@ declare class RagableBrowser<Database extends RagableDatabase = DefaultRagableDa
     readonly agents: RagableBrowserAgentsClient;
     readonly auth: RagableBrowserAuthClient<AuthUser>;
     readonly database: RagableBrowserDatabaseClient<Database>;
+    readonly db: RagableBrowserDatabaseClient<Database>;
     readonly transport: Transport;
     private readonly _ragableAuth;
     constructor(options: RagableBrowserClientOptions);

package/dist/index.js

@@ -2270,6 +2270,51 @@ var RagableBrowserAuthClient = class {
     return this.auth.getSession();
   }
 };
+var BrowserCollectionApi = class {
+  constructor(database, name, databaseInstanceId) {
+    this.database = database;
+    this.name = name;
+    this.databaseInstanceId = databaseInstanceId;
+    __publicField(this, "find", (whereOrParams = {}) => {
+      const hasQueryKeys = ["where", "filters", "limit", "offset", "orderBy", "orderDirection"].some(
+        (key) => Object.prototype.hasOwnProperty.call(whereOrParams, key)
+      );
+      const body = hasQueryKeys ? whereOrParams : { where: whereOrParams };
+      return asPostgrestResponse(
+        () => this.database._requestCollection(
+          "POST",
+          `/${encodeURIComponent(this.name)}/find`,
+          body,
+          this.databaseInstanceId
+        )
+      );
+    });
+    __publicField(this, "insert", (data) => asPostgrestResponse(
+      () => this.database._requestCollection(
+        "POST",
+        `/${encodeURIComponent(this.name)}/records`,
+        { data },
+        this.databaseInstanceId
+      )
+    ));
+    __publicField(this, "update", (where, patch, options) => asPostgrestResponse(
+      () => this.database._requestCollection(
+        "PATCH",
+        `/${encodeURIComponent(this.name)}/records`,
+        { where, patch, ...options?.limit ? { limit: options.limit } : {} },
+        this.databaseInstanceId
+      )
+    ));
+    __publicField(this, "delete", (where, options) => asPostgrestResponse(
+      () => this.database._requestCollection(
+        "DELETE",
+        `/${encodeURIComponent(this.name)}/records`,
+        { where, ...options?.limit ? { limit: options.limit } : {} },
+        this.databaseInstanceId
+      )
+    ));
+  }
+};
 var RagableBrowserDatabaseClient = class {
   constructor(options, ragableAuth = null) {
     this.options = options;
@@ -2329,6 +2374,25 @@ var RagableBrowserDatabaseClient = class {
       };
       return new PostgrestTableApi(pgFetch, id, table);
     });
+    __publicField(this, "collection", (name, databaseInstanceId) => {
+      return new BrowserCollectionApi(this, name, databaseInstanceId);
+    });
+    __publicField(this, "defineCollection", (name, schema, databaseInstanceId) => asPostgrestResponse(
+      () => this._requestCollection(
+        "POST",
+        "/",
+        { name, ...schema ? { schema } : {} },
+        databaseInstanceId
+      )
+    ));
+    __publicField(this, "listCollections", (databaseInstanceId) => asPostgrestResponse(
+      () => this._requestCollection(
+        "GET",
+        "/",
+        void 0,
+        databaseInstanceId
+      )
+    ));
     __publicField(this, "query", async (params) => {
       return asPostgrestResponse(async () => {
         const gid = requireAuthGroupId(this.options);
@@ -2403,6 +2467,36 @@ var RagableBrowserDatabaseClient = class {
   toUrl(path) {
     return `${normalizeBrowserApiBase()}${path.startsWith("/") ? path : `/${path}`}`;
   }
+  async _requestCollection(method, path, body, databaseInstanceId) {
+    const gid = requireAuthGroupId(this.options);
+    const token = await resolveDatabaseAuthBearer(this.options, this.ragableAuth);
+    const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
+    if (!id) {
+      throw new RagableError(
+        "db.collection() requires databaseInstanceId in client options or as an argument",
+        400,
+        { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
+      );
+    }
+    const headers = this.baseHeaders();
+    headers.set("Authorization", `Bearer ${token}`);
+    headers.set("X-Database-Instance-Id", id);
+    if (body !== void 0) headers.set("Content-Type", "application/json");
+    const response = await this.fetchImpl(
+      this.toUrl(`/auth-groups/${gid}/data/collections${path}`),
+      {
+        method,
+        headers,
+        body: body !== void 0 ? JSON.stringify(body) : void 0
+      }
+    );
+    const payload = await parseMaybeJsonBody(response);
+    if (!response.ok) {
+      const message = extractErrorMessage(payload, response.statusText);
+      throw new RagableError(message, response.status, payload);
+    }
+    return payload;
+  }
   baseHeaders() {
     return new Headers(this.options.headers);
   }
@@ -2635,6 +2729,7 @@ var RagableBrowser = class {
     __publicField(this, "agents");
     __publicField(this, "auth");
     __publicField(this, "database");
+    __publicField(this, "db");
     __publicField(this, "transport");
     __publicField(this, "_ragableAuth");
     /** Delegates to `database.from()`. Kept for back-compat — prefer `database.from()`. */
@@ -2674,6 +2769,7 @@ var RagableBrowser = class {
       this._ragableAuth
     );
     this.database._setTransport(this.transport);
+    this.db = this.database;
   }
   destroy() {
     this._ragableAuth?.destroy();
@@ -2747,7 +2843,7 @@ function createClient(options) {
   if (isServerClientOptions(options)) {
     if (typeof options === "object" && options !== null && "organizationId" in options && typeof options.organizationId === "string") {
       console.warn(
-        "[@ragable/sdk] createClient: `apiKey` is set, so the server client is returned. It has no `database` or `auth` \u2014 only `agents` and `shift`. For `database.from()` / `auth.*`, use the browser client without `apiKey` (e.g. createClient({ organizationId, authGroupId, databaseInstanceId, ... }))."
+        "[@ragable/sdk] createClient: `apiKey` is set, so the server client is returned. It has no `database` or `auth` \u2014 only `agents` and `shift`. For `db.collection()` / `database.from()` / `auth.*`, use the browser client without `apiKey` (e.g. createClient({ organizationId, authGroupId, databaseInstanceId, ... }))."
       );
     }
     return new Ragable(options);