@pylonsync/functions 0.3.289 → 0.3.291

package/package.json

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

package/src/define.ts

@@ -52,6 +52,21 @@ interface CommonDef {
    * own gate.
    */
   internal?: boolean;
+  /**
+   * Max wall-clock SECONDS this function may run before the runtime
+   * recycles its worker as wedged. Defaults to `PYLON_FN_CALL_TIMEOUT`
+   * (30s). Raise it for legitimately long-running work — heavy renders,
+   * big batch jobs, slow external calls — so the call isn't force-killed
+   * mid-flight. This also lifts the runtime's wedge backstop for the
+   * worker while such a call is in flight, so a busy-but-progressing
+   * worker (e.g. one doing synchronous canvas/image work that blocks the
+   * event loop) isn't respawned out from under the work.
+   *
+   * Keep it as small as the work honestly needs: a genuinely stuck call
+   * still ties up its worker until this deadline. Prefer offloading very
+   * heavy CPU work to a dedicated service over setting a huge timeout.
+   */
+  timeout?: number;
 }
 
 interface QueryDefRequired<TArgs, TReturn> extends CommonDef {
@@ -152,6 +167,7 @@ export function query<TArgs, TReturn>(
     handler: def.handler as FnDefinition<TArgs, TReturn>["handler"],
     internal: def.internal,
     auth: def.auth ?? DEFAULT_AUTH,
+    timeout: def.timeout,
   };
 }
 
@@ -201,6 +217,7 @@ export function mutation<TArgs, TReturn>(
     handler: def.handler as FnDefinition<TArgs, TReturn>["handler"],
     internal: def.internal,
     auth: def.auth ?? DEFAULT_AUTH,
+    timeout: def.timeout,
   };
 }
 
@@ -265,5 +282,6 @@ export function action<TArgs, TReturn>(
     handler: def.handler as FnDefinition<TArgs, TReturn>["handler"],
     internal: def.internal,
     auth: def.auth ?? DEFAULT_AUTH,
+    timeout: def.timeout,
   };
 }

package/src/runtime.ts

@@ -1046,6 +1046,13 @@ async function main() {
     // it — secure by default. See `packages/functions/src/define.ts`
     // for the developer-facing AuthMode docs.
     auth: def.auth ?? "user",
+    // Per-function call deadline in seconds. Null → the host uses its
+    // global PYLON_FN_CALL_TIMEOUT default. Drives both the call deadline
+    // and the wedge backstop for this function's worker.
+    timeout_secs:
+      typeof def.timeout === "number" && def.timeout > 0
+        ? Math.floor(def.timeout)
+        : null,
   }));
   send({ type: "ready", functions });
 

package/src/types.ts

@@ -645,6 +645,13 @@ export interface FnDefinition<TArgs = unknown, TReturn = unknown> {
    * unless explicitly opted out via `auth: "public"`. See [`AuthMode`].
    */
   auth?: AuthMode;
+  /**
+   * Max wall-clock seconds this function may run before the runtime
+   * recycles its worker. Defaults to `PYLON_FN_CALL_TIMEOUT` (30s).
+   * Raise for legitimately long-running work; also lifts the wedge
+   * backstop while the call is in flight. See the `timeout` option docs.
+   */
+  timeout?: number;
 }
 
 // ---------------------------------------------------------------------------