zero-com 1.13.2 → 1.13.3

package/README.md

@@ -229,6 +229,21 @@ When called outside `handle()`, the function executes directly with no context.
 Error: context() called outside of a server function
 ```
 
+Use `runWithContext` to provide a context in those cases:
+
+```typescript
+import { runWithContext } from 'zero-com'
+
+const authorize = async (credentials) => {
+  return runWithContext({}, async () => {
+    const user = await getUserByCredentials(credentials.email, credentials.password)
+    return user ?? null
+  })
+}
+```
+
+`runWithContext` accepts any object as the context value, which will be returned by `context()` inside any server function called within the callback.
+
 When called inside `handle()`, context is propagated automatically to the function and any nested `func()` calls, same as the normal RPC path.
 
 ## File boundary rule

package/lib/runtime.d.ts

@@ -11,4 +11,5 @@ declare global {
 export declare function context<T = unknown>(): T;
 export declare function func<F extends (...args: any[]) => any>(fn: F): F;
 export declare const handle: (funcId: string, ctx: any, args: any[]) => any;
+export declare const runWithContext: <T>(ctx: any, fn: () => T) => T;
 export declare const call: (fn: (funcId: string, args: any[]) => any) => void;

package/lib/runtime.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.call = exports.handle = void 0;
+exports.call = exports.runWithContext = exports.handle = void 0;
 exports.context = context;
 exports.func = func;
 // Context storage - only available on server (Node.js)
@@ -78,6 +78,15 @@ const handle = (funcId, ctx, args) => {
     return storage.run(ctx, () => fn(...args));
 };
 exports.handle = handle;
+// Run a callback within a context, making context() available inside it.
+// Use this in server-only code that does not go through handle() (e.g. auth callbacks).
+const runWithContext = (ctx, fn) => {
+    const storage = getContextStorage();
+    if (!storage)
+        throw new Error('runWithContext() is only available on the server');
+    return storage.run(ctx, fn);
+};
+exports.runWithContext = runWithContext;
 // Client calls this to set up transport (overrides default server-side behavior)
 // In production mode: transformed by plugin to assignment
 const call = (fn) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zero-com",
-  "version": "1.13.2",
+  "version": "1.13.3",
   "main": "index.js",
   "repository": "https://github.com/yosbelms/zero-com",
   "keywords": [