lazypock 0.1.2 → 0.1.5

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   fieldTypeScriptType,
   generateTypes,
   schemaFieldType
-} from "./chunk-3MZJ5HCD.js";
+} from "./chunk-Y6PMBL2S.js";
 
 // src/types.ts
 var ApiError = class extends Error {
@@ -321,17 +321,62 @@ var CollectionService = class {
     return encodeURIComponent(id);
   }
   /**
-   * List records with optional filter/sort/pagination.
-   * @param params Query parameters including `filter`, `sort`, `page`, `perPage`, `expand`.
-   * @param options Optional request options.
+   * Fetch a paginated list of records (PocketBase `getList`).
+   *
+   * @param page Page number (default 1).
+   * @param perPage Records per page (default 30).
+   * @param options Query params (`filter`, `sort`, `expand`, `fields`) + request options.
    */
-  list(params, options) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
+  getList(page = 1, perPage = 30, options) {
+    const { ...rest } = options ?? {};
+    const qs = new URLSearchParams(
+      Object.fromEntries(
+        Object.entries({ page: String(page), perPage: String(perPage), ...rest }).map(
+          ([k, v]) => [k, String(v)]
+        )
+      )
+    ).toString();
     return this.http.get(
-      "/" + this.encodeId(this.collectionName) + qs,
+      "/" + this.encodeId(this.collectionName) + "?" + qs,
       options
     );
   }
+  /**
+   * Fetch all records at once (auto-paginates). Mirrors PocketBase's
+   * `pb.collection(name).getFullList()`.
+   *
+   * @param options Query params (`sort`, `filter`, `batch`, etc.) + request options.
+   */
+  async getFullList(options) {
+    const { batch = 1e3, ...rest } = options ?? {};
+    const items = [];
+    let page = 1;
+    for (; ; ) {
+      const res = await this.getList(
+        page,
+        batch,
+        rest
+      );
+      if (!res || !res.items || res.items.length === 0) break;
+      items.push(...res.items);
+      if (page >= (res.totalPages ?? page)) break;
+      page += 1;
+    }
+    return items;
+  }
+  /**
+   * Fetch the first record matching a filter (PocketBase `getFirstListItem`).
+   *
+   * @param filter Filter expression (e.g. `title = 'x'`).
+   * @param options Optional request options.
+   */
+  async getFirstListItem(filter, options) {
+    const res = await this.getList(1, 1, {
+      ...options,
+      filter
+    });
+    return res?.items?.[0] ?? null;
+  }
   /**
    * Get a single record by ID.
    * @param id Record ID.
@@ -776,6 +821,135 @@ var FilesService = class {
   }
 };
 
+// src/collections.ts
+var REGISTRY_TOPIC = "collections";
+var CollectionsService = class {
+  /** @internal */
+  constructor(http, realtime) {
+    this.http = http;
+    this.realtime = realtime;
+  }
+  /**
+   * Fetch a paginated list of collections (admin).
+   *
+   * @param params Optional query params (`page`, `perPage`, `filter`, `sort`).
+   * @param options Optional request options.
+   */
+  async getList(params, options) {
+    const qs = params ? "?" + new URLSearchParams(
+      Object.fromEntries(
+        Object.entries(params).map(([k, v]) => [k, String(v)])
+      )
+    ).toString() : "";
+    return this.http?.get("/collections" + qs, options) ?? null;
+  }
+  /**
+   * Fetch all collections at once (auto-paginates). Mirrors PocketBase's
+   * `pb.collections.getFullList()` — defaults to listing everything.
+   *
+   * @param options Query params (`sort`, `batch`, etc.) or request options.
+   */
+  async getFullList(options) {
+    if (!this.http) return [];
+    const { batch = 1e3, ...rest } = options ?? {};
+    const items = [];
+    let page = 1;
+    for (; ; ) {
+      const res = await this.getList({
+        ...rest,
+        page,
+        perPage: batch
+      });
+      if (!res || !res.items || res.items.length === 0) break;
+      items.push(...res.items);
+      if (page >= (res.totalPages ?? page)) break;
+      page += 1;
+    }
+    return items;
+  }
+  /**
+   * Get a single collection by ID or name (admin).
+   *
+   * @param id Collection ID or name.
+   * @param options Optional request options.
+   */
+  async getOne(id, options) {
+    return this.http?.get("/collections/" + encodeURIComponent(id), options) ?? null;
+  }
+  /**
+   * Create a new collection (admin).
+   *
+   * @param data Collection definition (name, type, fields, options, rules, etc.).
+   * @param options Optional request options.
+   */
+  async create(data, options) {
+    return this.http?.post("/collections", data, options) ?? null;
+  }
+  /**
+   * Update an existing collection (admin).
+   *
+   * @param id Collection ID or name.
+   * @param data Updated collection fields.
+   * @param options Optional request options.
+   */
+  async update(id, data, options) {
+    return this.http?.patch(
+      "/collections/" + encodeURIComponent(id),
+      data,
+      options
+    ) ?? null;
+  }
+  /**
+   * Delete a collection (admin).
+   *
+   * @param id Collection ID or name.
+   * @param options Optional request options.
+   */
+  async delete(id, options) {
+    const res = this.http?.delete(
+      "/collections/" + encodeURIComponent(id),
+      options
+    );
+    return res == null ? false : true;
+  }
+  /**
+   * Subscribe to collection registry changes.
+   *
+   * @param callback Received on every collection create/update/delete.
+   * @returns A function that unsubscribes this callback.
+   */
+  subscribe(callback) {
+    if (!this.realtime) {
+      console.warn("[lazypock] No realtime service configured.");
+      return () => {
+      };
+    }
+    const handler = (raw) => {
+      callback({
+        action: normalizeAction2(raw.event),
+        collection: raw.payload ?? {},
+        topic: raw.topic
+      });
+    };
+    this.realtime.ensureConnected();
+    this.realtime.subscribe(REGISTRY_TOPIC, handler);
+    return () => this.realtime?.unsubscribe(REGISTRY_TOPIC, handler);
+  }
+  /**
+   * Unsubscribe all callbacks from the registry channel.
+   */
+  unsubscribe() {
+    this.realtime?.unsubscribe(REGISTRY_TOPIC);
+  }
+};
+function normalizeAction2(event) {
+  const e = event.toLowerCase();
+  if (e === "create") return "create";
+  if (e === "update") return "update";
+  if (e === "delete") return "delete";
+  return "update";
+}
+
 // src/lazypock.ts
 var LazypockClient = class {
   /**
@@ -792,6 +966,7 @@ var LazypockClient = class {
       this.realtime.setUrl(wsUrlFromBaseUrl(baseUrl));
     }
     this.files = new FilesService(this.http);
+    this.collections = new CollectionsService(this.http, this.realtime);
     if (options.types?.schemas) {
       this.schemaByName = new Map(
         options.types.schemas.map((s) => [s.name, s])
@@ -952,129 +1127,6 @@ var LazypockClient = class {
   health(options) {
     return this.http.get("/health", options);
   }
-  // ── Collection Management (admin) ──
-  /**
-   * List all collections (admin).
-   * @param q URL query string (e.g. `page=1&perPage=200`).
-   * @param options Optional request options.
-   */
-  listCollections(q, options) {
-    return this.http.get(
-      "/collections" + (q ? "?" + q : ""),
-      options
-    );
-  }
-  /**
-   * Get a single collection by ID or name.
-   * @param id Collection ID or name.
-   * @param options Optional request options.
-   */
-  getCollection(id, options) {
-    return this.http.get(
-      "/collections/" + encodeURIComponent(id),
-      options
-    );
-  }
-  /**
-   * Create a new collection (admin).
-   * @param data Collection definition (name, type, fields, options, rules, etc.).
-   * @param options Optional request options.
-   */
-  createCollection(data, options) {
-    return this.http.post("/collections", data, options);
-  }
-  /**
-   * Update an existing collection (admin).
-   * @param id Collection ID or name.
-   * @param data Updated collection fields.
-   * @param options Optional request options.
-   */
-  updateCollection(id, data, options) {
-    return this.http.patch(
-      "/collections/" + encodeURIComponent(id),
-      data,
-      options
-    );
-  }
-  /**
-   * Delete a collection (admin).
-   * @param id Collection ID or name.
-   * @param options Optional request options.
-   */
-  deleteCollection(id, options) {
-    return this.http.delete("/collections/" + encodeURIComponent(id), options);
-  }
-  // ── Records (dynamic collection) ──
-  /**
-   * List records from a dynamic collection with optional filter/sort/pagination.
-   *
-   * @param coll Collection name.
-   * @param params Query parameters including:
-   *   - `filter` — PocketBase filter syntax (e.g. `title~'hello' && published=true`)
-   *   - `sort` — Comma-separated, `-` prefix for DESC (e.g. `-created,title`)
-   *   - `page` — Page number (default: 1)
-   *   - `perPage` — Items per page (default: 30, max: 200)
-   *   - `expand` — Comma-separated relation fields (e.g. `author,category`)
-   * @param options Optional request options.
-   */
-  listRecords(coll, params, options) {
-    const qs = params ? "?" + new URLSearchParams(params).toString() : "";
-    return this.http.get(
-      "/" + encodeURIComponent(coll) + qs,
-      options
-    );
-  }
-  /**
-   * Get a single record by ID.
-   * @param coll Collection name.
-   * @param id Record ID.
-   * @param options Optional request options.
-   */
-  getRecord(coll, id, options) {
-    return this.http.get(
-      "/" + encodeURIComponent(coll) + "/" + encodeURIComponent(id),
-      options
-    );
-  }
-  /**
-   * Create a record in a dynamic collection.
-   * @param coll Collection name.
-   * @param data Record fields.
-   * @param options Optional request options.
-   */
-  createRecord(coll, data, options) {
-    return this.http.post(
-      "/" + encodeURIComponent(coll),
-      data,
-      options
-    );
-  }
-  /**
-   * Update a record in a dynamic collection.
-   * @param coll Collection name.
-   * @param id Record ID.
-   * @param data Updated record fields.
-   * @param options Optional request options.
-   */
-  updateRecord(coll, id, data, options) {
-    return this.http.patch(
-      "/" + encodeURIComponent(coll) + "/" + encodeURIComponent(id),
-      data,
-      options
-    );
-  }
-  /**
-   * Delete a record from a dynamic collection.
-   * @param coll Collection name.
-   * @param id Record ID.
-   * @param options Optional request options.
-   */
-  deleteRecord(coll, id, options) {
-    return this.http.delete(
-      "/" + encodeURIComponent(coll) + "/" + encodeURIComponent(id),
-      options
-    );
-  }
 };
 
 // src/client.ts
@@ -1090,6 +1142,7 @@ export {
   ApiError,
   AuthStore,
   CollectionService,
+  CollectionsService,
   FilesService,
   LazypockClient,
   RealtimeService,