zero-com 1.13.0 → 1.13.2

package/README.md

@@ -212,6 +212,56 @@ 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
+```
+
+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.
+
+This means you must not mix `func()` declarations with client-side code (state, UI utilities, etc.) in the same file. The pattern is the same as Next.js `"use server"` files: one side of the boundary per file.
+
+**Wrong** — `connect` will be `undefined` on the client because the whole file is replaced:
+
+```ts
+// store.ts  ❌
+import { func } from 'zero-com'
+import { createStore } from './create-store'
+
+export const { connect, useStore } = createStore(...)  // lost on client
+
+export const getPhones = func(async () => { ... })
+```
+
+**Right** — separate the RPC calls from client state:
+
+```ts
+// funcs.ts  ✅  (replaced with stubs on client)
+import { func } from 'zero-com'
+export const getPhones = func(async () => { ... })
+
+// store.ts  ✅  (untouched on client)
+import { createStore } from './create-store'
+export const { connect, useStore } = createStore(...)
+export * from './funcs'
+```
+
 ## Plugin options
 
 | Option      | Type      | Description                                                                 |
@@ -301,7 +351,8 @@ export const getPhones = func(async (name: string) => {
 // server.ts
 import express from 'express';
 import { handle } from 'zero-com';
-import './src/server/api/phones.js'; // Make sure to import the server-side modules
+// No manual imports needed — the plugin automatically registers all func() files
+// when it transforms any file that calls handle()
 
 const app = express();
 app.use(express.json());

package/lib/runtime.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);
     };
 }

package/package.json

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