@pylonsync/functions 0.3.10 → 0.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pylonsync/functions",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "TypeScript function runtime for pylon — defines server-side queries, mutations, and actions.",
   "type": "module",
   "main": "src/index.ts",

package/src/runtime.ts

@@ -316,6 +316,14 @@ function buildDbReader(callId: string): DbReader {
         limit: numItems,
       })) as any;
     },
+    async search(entity, query) {
+      return (await rpcDb(callId, {
+        type: "db",
+        op: "search",
+        entity,
+        data: query,
+      })) as any;
+    },
   };
 }
 

package/src/types.ts

@@ -43,6 +43,29 @@ export interface DbReader {
     query: Record<string, unknown>
   ): Promise<Record<string, unknown>>;
 
+  /**
+   * Faceted full-text search against an entity that declares a
+   * `search:` config. Mirrors the typed-client `client.search()` /
+   * the HTTP `/api/search/<entity>` shape.
+   *
+   * ```ts
+   * const result = await ctx.db.search("Product", {
+   *   query: "rust async",
+   *   filters: { brand: "Atlas" },
+   *   facets: ["category"],
+   *   page: 0,
+   *   pageSize: 20,
+   * });
+   * ```
+   *
+   * Returns `{ hits, facetCounts, total, tookMs }`. Throws on
+   * entities without a `search:` config (`SEARCH_NOT_CONFIGURED`).
+   */
+  search(
+    entity: string,
+    query: Record<string, unknown>
+  ): Promise<SearchResult>;
+
   /**
    * Cursor-paginated list. Pass `cursor` from a previous page's `nextCursor`
    * to continue; pass `null` for the first page.
@@ -70,6 +93,19 @@ export interface PaginationResult<T = Record<string, unknown>> {
   isDone: boolean;
 }
 
+/** Result shape for [`DbReader.search`]. */
+export interface SearchResult<T = Record<string, unknown>> {
+  /** Ranked (or sorted) hit rows. */
+  hits: T[];
+  /** `{facet_name: {value: count}}` — counts excluded for the
+   *  active filter on the same facet (standard exclusion pattern). */
+  facetCounts: Record<string, Record<string, number>>;
+  /** Total hit count before pagination. */
+  total: number;
+  /** Milliseconds spent in the search engine. */
+  tookMs: number;
+}
+
 // ---------------------------------------------------------------------------
 // Database — write operations (extends read)
 // ---------------------------------------------------------------------------