zero-com 1.13.1 → 1.13.3

package/README.md

@@ -212,6 +212,40 @@ When `getFullName` is called from the client:
 4. `getFirstName` executes directly (no transport) with the same context
 5. Both functions can access `context()` with the same data
 
+## Calling server functions outside handle()
+
+Server functions can be called from any server-side code, not only through the RPC path. This is useful for server-side-only integrations like authentication callbacks, cron jobs, or webhook handlers.
+
+```typescript
+// pages/api/auth/[...nextauth].ts  (Next.js example)
+import { getUserByCredentials } from '../../../server/auth/funcs'
+
+const user = await getUserByCredentials(email, password)
+```
+
+When called outside `handle()`, the function executes directly with no context. If the function calls `context()` internally, it throws:
+
+```
+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
 
 Any file that contains `func()` exports is treated as a **server-only module**. On the client build the plugin replaces the **entire file** with lightweight RPC stubs — only the `func()` exports survive, everything else in that file is discarded.

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)
@@ -36,7 +36,11 @@ function context() {
     return ctx;
 }
 // Default server-side implementation: call directly from registry
-// This enables server functions to call other server functions without transport
+// This enables server functions to call other server functions without transport.
+// If a request context exists (set by handle()), it is propagated automatically.
+// If there is no context (e.g. called from NextAuth or other server-only code that
+// does not go through handle()), the function is called directly — context() will
+// throw inside the function only if the function actually tries to use it.
 if (typeof globalThis.ZERO_COM_CLIENT_CALL === 'undefined') {
     globalThis.ZERO_COM_CLIENT_CALL = (funcId, args) => {
         var _a;
@@ -44,13 +48,13 @@ if (typeof globalThis.ZERO_COM_CLIENT_CALL === 'undefined') {
         if (!storage) {
             throw new Error('Server function called on client without transport configured. Call call() first.');
         }
-        const ctx = storage.getStore();
-        if (ctx === undefined) {
-            throw new Error('Server function called outside of request context');
-        }
         const fn = (_a = globalThis.ZERO_COM_SERVER_REGISTRY) === null || _a === void 0 ? void 0 : _a[funcId];
         if (!fn)
             throw new Error(`Function not found: ${funcId}`);
+        const ctx = storage.getStore();
+        if (ctx !== undefined) {
+            return storage.run(ctx, () => fn(...args));
+        }
         return fn(...args);
     };
 }
@@ -74,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.1",
+  "version": "1.13.3",
   "main": "index.js",
   "repository": "https://github.com/yosbelms/zero-com",
   "keywords": [