@homespunapps/core 1.6.57 → 1.6.58

package/dist/client.d.ts

@@ -676,6 +676,19 @@ export declare class HomespunClient {
         where?: ListWhereCondition[];
         sort?: ListSortSpec[];
     }): Promise<AppRowsPage>;
+    /**
+     * GET /v1/apps/:id/collections/:name/count: live row count (spec B4,
+     * issue #1056), the same aggregate the browser `/_hs/count/:name` door and
+     * the `count` MCP tool / CLI verb call through. Gated by the collection's
+     * `countRead` opt-in, INDEPENDENT of `read`: a caller who cannot list the
+     * rows can still get the count when the manifest opted the collection in,
+     * and a collection that never declared `countRead` refuses with
+     * `collection_count_forbidden` even for a caller who could otherwise list.
+     * No filter and no paging: it is a whole-scope total.
+     */
+    countAppRows(appId: string, collection: string): Promise<{
+        count: number;
+    }>;
     /**
      * GET /v1/apps/:id/collections/:name/:key — read one row. A dedicated
      * route (not a client-side scan like v1's `getRecord`) — spec-cli §8

package/dist/client.js

@@ -1144,6 +1144,22 @@ export class HomespunClient {
             this.fail(r);
         return this.asObject(r);
     }
+    /**
+     * GET /v1/apps/:id/collections/:name/count: live row count (spec B4,
+     * issue #1056), the same aggregate the browser `/_hs/count/:name` door and
+     * the `count` MCP tool / CLI verb call through. Gated by the collection's
+     * `countRead` opt-in, INDEPENDENT of `read`: a caller who cannot list the
+     * rows can still get the count when the manifest opted the collection in,
+     * and a collection that never declared `countRead` refuses with
+     * `collection_count_forbidden` even for a caller who could otherwise list.
+     * No filter and no paging: it is a whole-scope total.
+     */
+    async countAppRows(appId, collection) {
+        const r = await this.call("GET", `/v1/apps/${encodeURIComponent(appId)}/collections/${encodeURIComponent(collection)}/count`);
+        if (!r.ok)
+            this.fail(r);
+        return this.asObject(r);
+    }
     /**
      * GET /v1/apps/:id/collections/:name/:key — read one row. A dedicated
      * route (not a client-side scan like v1's `getRecord`) — spec-cli §8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/core",
-  "version": "1.6.57",
+  "version": "1.6.58",
   "description": "Homespun relay client: typed HTTP + WebSocket operations against a Homespun relay. Framework-free.",
   "license": "MIT",
   "type": "module",