@ragable/sdk 0.6.20 → 0.6.21

package/dist/index.mjs

@@ -627,6 +627,17 @@ async function parseTransportResponse(response) {
 }
 
 // src/browser-postgrest.ts
+function toRagableResult(r) {
+  if (r.error) return { ok: false, error: r.error };
+  return { ok: true, value: r.data };
+}
+function assertPostgrestSuccess(r) {
+  if (r.error) throw r.error;
+}
+function unwrapPostgrest(r) {
+  if (r.error) throw r.error;
+  return r.data;
+}
 async function asPostgrestResponse(fn) {
   try {
     const data = await fn();
@@ -2212,24 +2223,71 @@ var RagableBrowserAuthClient = class {
     return this.auth.getSession();
   }
 };
+function collectionRecordToRowWithMeta(record) {
+  const { data, id, createdAt, updatedAt } = record;
+  return { ...data, meta: { id, createdAt, updatedAt } };
+}
+function collectionRecordsToRowWithMeta(records) {
+  return records.map(collectionRecordToRowWithMeta);
+}
+var FIND_QUERY_KEYS = [
+  "where",
+  "filters",
+  "limit",
+  "offset",
+  "orderBy",
+  "orderDirection",
+  "return"
+];
 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, "requestFind", (body) => asPostgrestResponse(
+      () => this.database._requestCollection(
+        "POST",
+        `/${encodeURIComponent(this.name)}/find`,
+        body,
+        this.databaseInstanceId
+      )
+    ));
+    /**
+     * Query collection rows. Prefer this over the deprecated `find` alias.
+     * Use `return: "flat"` to get {@link CollectionRowWithMeta} without nested `.data`.
+     */
+    __publicField(this, "findMany", async (whereOrParams = {}) => {
+      const { returnMode, body } = this.normalizeFindArgs(whereOrParams);
+      const res = await this.requestFind(body);
+      if (res.error) return res;
+      if (returnMode === "flat") {
+        return {
+          data: collectionRecordsToRowWithMeta(res.data),
+          error: null
+        };
+      }
+      return res;
+    });
+    /**
+     * @deprecated Use {@link BrowserCollectionApi.findMany} — same behavior.
+     */
+    __publicField(this, "find", (whereOrParams = {}) => this.findMany(whereOrParams));
+    /**
+     * At most one row, `data` is the record or `null` if none match (not an error).
+     */
+    __publicField(this, "findFirst", async (whereOrParams = {}) => {
+      const { body } = this.normalizeFindArgs(whereOrParams);
+      const withCap = { ...body, limit: 1, offset: body["offset"] ?? 0 };
+      const res = await this.requestFind(withCap);
+      if (res.error) return res;
+      return { data: res.data[0] ?? null, error: null };
+    });
+    /**
+     * Lookup by primary key `id` (envelope). Equivalent to
+     * `findFirst({ where: { id }, limit: 1 })` with a typed `where.id`.
+     */
+    __publicField(this, "findUnique", async (args) => {
+      return this.findFirst({ where: args.where });
     });
     __publicField(this, "insert", (data) => asPostgrestResponse(
       () => this.database._requestCollection(
@@ -2239,6 +2297,9 @@ var BrowserCollectionApi = class {
         this.databaseInstanceId
       )
     ));
+    /**
+     * Update rows matching `where` (JSON fields, plus envelope `id` / `createdAt` / `updatedAt`).
+     */
     __publicField(this, "update", (where, patch, options) => asPostgrestResponse(
       () => this.database._requestCollection(
         "PATCH",
@@ -2247,6 +2308,15 @@ var BrowserCollectionApi = class {
         this.databaseInstanceId
       )
     ));
+    /**
+     * Like {@link BrowserCollectionApi.update} but the success payload includes
+     * `meta.count` (number of rows returned from the update, bounded by `limit`).
+     */
+    __publicField(this, "updateMany", async (where, patch, options) => {
+      const r = await this.update(where, patch, options);
+      if (r.error) return r;
+      return { data: { records: r.data, meta: { count: r.data.length } }, error: null };
+    });
     __publicField(this, "delete", (where, options) => asPostgrestResponse(
       () => this.database._requestCollection(
         "DELETE",
@@ -2256,6 +2326,15 @@ var BrowserCollectionApi = class {
       )
     ));
   }
+  normalizeFindArgs(whereOrParams) {
+    const hasQueryKeys = typeof whereOrParams === "object" && whereOrParams !== null && FIND_QUERY_KEYS.some(
+      (key) => Object.prototype.hasOwnProperty.call(whereOrParams, key)
+    );
+    const raw = hasQueryKeys ? { ...whereOrParams } : { where: whereOrParams };
+    const returnMode = raw["return"] === "flat" ? "flat" : "envelope";
+    delete raw["return"];
+    return { returnMode, body: raw };
+  }
 };
 var RagableBrowserDatabaseClient = class {
   constructor(options, ragableAuth = null) {
@@ -2848,7 +2927,10 @@ export {
   ShiftClient,
   Transport,
   asPostgrestResponse,
+  assertPostgrestSuccess,
   bindFetch,
+  collectionRecordToRowWithMeta,
+  collectionRecordsToRowWithMeta,
   createBrowserClient,
   createClient,
   createRagPipeline,
@@ -2864,6 +2946,8 @@ export {
   normalizeBrowserApiBase,
   parseSseDataLine,
   parseTransportResponse,
-  readSseStream
+  readSseStream,
+  toRagableResult,
+  unwrapPostgrest
 };
 //# sourceMappingURL=index.mjs.map