@ragable/sdk 0.6.0 → 0.6.2

package/dist/index.d.mts

@@ -90,6 +90,7 @@ type RequestOptions = Omit<RequestInit, "body"> & {
 declare abstract class RagableSdkError extends Error {
     abstract readonly __type: string;
     constructor(message: string);
+    toJSON(): Record<string, unknown>;
 }
 declare class RagableError extends RagableSdkError {
     readonly __type: "RagableError";
@@ -98,11 +99,13 @@ declare class RagableError extends RagableSdkError {
     readonly code: string | undefined;
     readonly details: string | undefined;
     constructor(message: string, status: number, body: unknown);
+    toJSON(): Record<string, unknown>;
 }
 declare class RagableNetworkError extends RagableSdkError {
     readonly __type: "RagableNetworkError";
     readonly cause: unknown;
     constructor(message: string, cause?: unknown);
+    toJSON(): Record<string, unknown>;
 }
 declare class RagableAbortError extends RagableSdkError {
     readonly __type: "RagableAbortError";
@@ -112,6 +115,7 @@ declare class RagableTimeoutError extends RagableSdkError {
     readonly __type: "RagableTimeoutError";
     readonly timeoutMs: number;
     constructor(timeoutMs: number);
+    toJSON(): Record<string, unknown>;
 }
 declare function extractErrorMessage(payload: unknown, fallback: string): string;
 declare class RagableRequestClient {
@@ -859,11 +863,17 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     truncated: boolean;
     rows: Row[];
 }
-declare class RagableBrowserDatabaseClient<_Schema extends RagableDatabase = DefaultRagableDatabase> {
+declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = DefaultRagableDatabase> {
     private readonly options;
     private readonly ragableAuth;
+    private readonly postgrestFrom?;
     private readonly fetchImpl;
-    constructor(options: RagableBrowserClientOptions, ragableAuth?: RagableAuth | null);
+    constructor(options: RagableBrowserClientOptions, ragableAuth?: RagableAuth | null, postgrestFrom?: (<T extends RagableTableNames<Database>>(table: T, databaseInstanceId?: string) => PostgrestTableApi<Database, T>) | undefined);
+    /**
+     * PostgREST fluent API — same as `client.from('table')`.
+     * Use either the root client or `database` for Supabase-style table access; `database.query()` is raw SQL only.
+     */
+    from<TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string): PostgrestTableApi<Database, TableName>;
     private toUrl;
     query<Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams): Promise<BrowserSqlQueryResult<Row>>;
     private baseHeaders;

package/dist/index.d.ts

@@ -90,6 +90,7 @@ type RequestOptions = Omit<RequestInit, "body"> & {
 declare abstract class RagableSdkError extends Error {
     abstract readonly __type: string;
     constructor(message: string);
+    toJSON(): Record<string, unknown>;
 }
 declare class RagableError extends RagableSdkError {
     readonly __type: "RagableError";
@@ -98,11 +99,13 @@ declare class RagableError extends RagableSdkError {
     readonly code: string | undefined;
     readonly details: string | undefined;
     constructor(message: string, status: number, body: unknown);
+    toJSON(): Record<string, unknown>;
 }
 declare class RagableNetworkError extends RagableSdkError {
     readonly __type: "RagableNetworkError";
     readonly cause: unknown;
     constructor(message: string, cause?: unknown);
+    toJSON(): Record<string, unknown>;
 }
 declare class RagableAbortError extends RagableSdkError {
     readonly __type: "RagableAbortError";
@@ -112,6 +115,7 @@ declare class RagableTimeoutError extends RagableSdkError {
     readonly __type: "RagableTimeoutError";
     readonly timeoutMs: number;
     constructor(timeoutMs: number);
+    toJSON(): Record<string, unknown>;
 }
 declare function extractErrorMessage(payload: unknown, fallback: string): string;
 declare class RagableRequestClient {
@@ -859,11 +863,17 @@ interface BrowserSqlQueryResult<Row extends Record<string, unknown> = Record<str
     truncated: boolean;
     rows: Row[];
 }
-declare class RagableBrowserDatabaseClient<_Schema extends RagableDatabase = DefaultRagableDatabase> {
+declare class RagableBrowserDatabaseClient<Database extends RagableDatabase = DefaultRagableDatabase> {
     private readonly options;
     private readonly ragableAuth;
+    private readonly postgrestFrom?;
     private readonly fetchImpl;
-    constructor(options: RagableBrowserClientOptions, ragableAuth?: RagableAuth | null);
+    constructor(options: RagableBrowserClientOptions, ragableAuth?: RagableAuth | null, postgrestFrom?: (<T extends RagableTableNames<Database>>(table: T, databaseInstanceId?: string) => PostgrestTableApi<Database, T>) | undefined);
+    /**
+     * PostgREST fluent API — same as `client.from('table')`.
+     * Use either the root client or `database` for Supabase-style table access; `database.query()` is raw SQL only.
+     */
+    from<TableName extends RagableTableNames<Database>>(table: TableName, databaseInstanceId?: string): PostgrestTableApi<Database, TableName>;
     private toUrl;
     query<Row extends Record<string, unknown> = Record<string, unknown>>(params: BrowserSqlQueryParams): Promise<BrowserSqlQueryResult<Row>>;
     private baseHeaders;

package/dist/index.js

@@ -84,6 +84,13 @@ var RagableSdkError = class extends Error {
     super(message);
     this.name = this.constructor.name;
   }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      __type: this.__type
+    };
+  }
 };
 var RagableError = class extends RagableSdkError {
   constructor(message, status, body) {
@@ -95,11 +102,17 @@ var RagableError = class extends RagableSdkError {
     __publicField(this, "details");
     this.status = status;
     this.body = body;
-    if (body && typeof body === "object") {
-      const b = body;
-      this.code = typeof b.code === "string" ? b.code : void 0;
-      this.details = typeof b.details === "string" ? b.details : void 0;
-    }
+    this.code = body && typeof body === "object" ? typeof body.code === "string" ? body.code : void 0 : void 0;
+    this.details = body && typeof body === "object" ? typeof body.details === "string" ? body.details : void 0 : void 0;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      status: this.status,
+      body: this.body,
+      code: this.code,
+      details: this.details
+    };
   }
 };
 var RagableNetworkError = class extends RagableSdkError {
@@ -109,6 +122,12 @@ var RagableNetworkError = class extends RagableSdkError {
     __publicField(this, "cause");
     this.cause = cause;
   }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      cause: this.cause instanceof Error ? this.cause.message : this.cause
+    };
+  }
 };
 var RagableAbortError = class extends RagableSdkError {
   constructor(message = "Request aborted") {
@@ -123,6 +142,12 @@ var RagableTimeoutError = class extends RagableSdkError {
     __publicField(this, "timeoutMs");
     this.timeoutMs = timeoutMs;
   }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      timeoutMs: this.timeoutMs
+    };
+  }
 };
 function extractErrorMessage(payload, fallback) {
   if (payload && typeof payload === "object") {
@@ -639,7 +664,15 @@ async function asPostgrestResponse(fn) {
     const data = await fn();
     return { data, error: null };
   } catch (e) {
-    const err = e instanceof RagableError ? e : new RagableError(e.message, 500, null);
+    let err;
+    if (e instanceof RagableError) {
+      err = e;
+    } else if (e instanceof RagableSdkError) {
+      err = new RagableError(e.message, 0, { originalError: e.__type, cause: e.message });
+    } else {
+      const message = e instanceof Error ? e.message : typeof e === "string" ? e : "Unknown error";
+      err = new RagableError(message, 0, null);
+    }
     return { data: null, error: err };
   }
 }
@@ -1986,8 +2019,10 @@ function normalizeBrowserApiBase(baseUrl) {
 function requireAuthGroupId(options) {
   const id = options.authGroupId?.trim();
   if (!id) {
-    throw new Error(
-      "authGroupId is required for auth and database methods on the browser client"
+    throw new RagableError(
+      "authGroupId is required for auth and database methods on the browser client",
+      400,
+      { code: "SDK_MISSING_AUTH_GROUP_ID" }
     );
   }
   return id;
@@ -2002,8 +2037,10 @@ async function requireAccessToken(options, ragableAuth) {
     const token = await getter();
     if (token?.trim()) return token.trim();
   }
-  throw new Error(
-    "No access token available (sign in or provide getAccessToken)"
+  throw new RagableError(
+    "No access token available. Sign in first with auth.signInWithPassword() or provide getAccessToken callback.",
+    401,
+    { code: "SDK_NO_ACCESS_TOKEN" }
   );
 }
 async function resolveDatabaseAuthBearer(options, ragableAuth) {
@@ -2014,8 +2051,10 @@ async function resolveDatabaseAuthBearer(options, ragableAuth) {
   const fromGetter = options.getDataStaticKey ? await options.getDataStaticKey() : null;
   const key = (fromGetter?.trim() || options.dataStaticKey?.trim()) ?? "";
   if (!key) {
-    throw new Error(
-      mode === "publicAnon" ? "dataAuth publicAnon requires getDataStaticKey or dataStaticKey" : "dataAuth admin requires getDataStaticKey or dataStaticKey"
+    throw new RagableError(
+      mode === "publicAnon" ? "dataAuth publicAnon requires getDataStaticKey or dataStaticKey" : "dataAuth admin requires getDataStaticKey or dataStaticKey",
+      400,
+      { code: "SDK_MISSING_STATIC_KEY" }
     );
   }
   return key;
@@ -2124,12 +2163,27 @@ var RagableBrowserAuthClient = class {
   }
 };
 var RagableBrowserDatabaseClient = class {
-  constructor(options, ragableAuth = null) {
+  constructor(options, ragableAuth = null, postgrestFrom) {
     this.options = options;
     this.ragableAuth = ragableAuth;
+    this.postgrestFrom = postgrestFrom;
     __publicField(this, "fetchImpl");
     this.fetchImpl = bindFetch(options.fetch);
   }
+  /**
+   * PostgREST fluent API — same as `client.from('table')`.
+   * Use either the root client or `database` for Supabase-style table access; `database.query()` is raw SQL only.
+   */
+  from(table, databaseInstanceId) {
+    if (!this.postgrestFrom) {
+      throw new RagableError(
+        "database.from() is only available on the client from createBrowserClient().",
+        500,
+        { code: "SDK_DATABASE_FROM_UNAVAILABLE" }
+      );
+    }
+    return this.postgrestFrom(table, databaseInstanceId);
+  }
   toUrl(path) {
     return `${normalizeBrowserApiBase(this.options.baseUrl)}${path.startsWith("/") ? path : `/${path}`}`;
   }
@@ -2243,18 +2297,25 @@ var RagableBrowser = class {
     }
     this.agents = new RagableBrowserAgentsClient(options);
     this.auth = new RagableBrowserAuthClient(options, this._ragableAuth);
-    this.database = new RagableBrowserDatabaseClient(options, this._ragableAuth);
+    this.database = new RagableBrowserDatabaseClient(
+      options,
+      this._ragableAuth,
+      (table, databaseInstanceId) => this.from(table, databaseInstanceId)
+    );
   }
   from(table, databaseInstanceId) {
     const id = databaseInstanceId?.trim() || this.options.databaseInstanceId?.trim();
     if (!id) {
-      throw new Error(
-        "RagableBrowser.from() requires databaseInstanceId in client options or as the second argument"
+      throw new RagableError(
+        "RagableBrowser.from() requires databaseInstanceId in client options or as the second argument",
+        400,
+        { code: "SDK_MISSING_DATABASE_INSTANCE_ID" }
       );
     }
     const gid = requireAuthGroupId(this.options);
     const ragableAuth = this._ragableAuth;
     const opts = this.options;
+    const transport = this.transport;
     const pgFetch = async (params) => {
       const token = await resolveDatabaseAuthBearer(opts, ragableAuth);
       const baseUrl = normalizeBrowserApiBase(opts.baseUrl);
@@ -2271,15 +2332,13 @@ var RagableBrowser = class {
           headers.set(k, v);
         }
       }
-      if (params.idempotencyKey) {
-        headers.set("Idempotency-Key", params.idempotencyKey);
-      }
-      const fetchImpl = bindFetch(opts.fetch);
-      return fetchImpl(url, {
+      return transport.execute({
+        url,
         method: params.method,
         headers,
         body: params.body !== void 0 ? JSON.stringify(params.body) : void 0,
-        signal: params.signal
+        signal: params.signal,
+        idempotencyKey: params.idempotencyKey
       });
     };
     return new PostgrestTableApi(pgFetch, id, table);