@pylonsync/functions 0.3.362 → 0.3.363

package/dist/types.d.ts

@@ -449,6 +449,13 @@ export interface QueryCtx<R extends AuthRequirement = "optional"> {
     auth: AuthInfo<R>;
     /** Environment variables / secrets. */
     env: Record<string, string>;
+    /**
+     * Create a typed error. Unlike the mutation version there's no
+     * transaction to roll back — this exists so a query can answer with a
+     * code the caller can branch on (`AUCTION_NOT_FOUND`) instead of a bare
+     * `throw new Error(...)`, which reaches the client as `UNKNOWN`.
+     */
+    error(code: string, message: string): Error;
     /** Assert org membership (optionally a role) — see {@link RequireMember}. */
     requireMember: RequireMember;
 }

package/package.json

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

package/src/runtime.ts

@@ -920,6 +920,13 @@ async function handleCall(msg: CallMessage): Promise<void> {
         db: reader,
         auth,
         env,
+        // No transaction to roll back here — this is purely so a query
+        // can fail with a code the caller can branch on.
+        error(code, message) {
+          const err = new Error(message);
+          (err as any).code = code;
+          return err;
+        },
         requireMember: makeRequireMember(auth.userId, (entity, filter) =>
           reader.query(entity, { ...filter, $limit: 1 }),
         ),

package/src/types.ts

@@ -542,6 +542,13 @@ export interface QueryCtx<R extends AuthRequirement = "optional"> {
   auth: AuthInfo<R>;
   /** Environment variables / secrets. */
   env: Record<string, string>;
+  /**
+   * Create a typed error. Unlike the mutation version there's no
+   * transaction to roll back — this exists so a query can answer with a
+   * code the caller can branch on (`AUCTION_NOT_FOUND`) instead of a bare
+   * `throw new Error(...)`, which reaches the client as `UNKNOWN`.
+   */
+  error(code: string, message: string): Error;
   /** Assert org membership (optionally a role) — see {@link RequireMember}. */
   requireMember: RequireMember;
 }