rsf-zero 0.3.4 → 0.3.6

package/README.md

@@ -40,9 +40,6 @@ See [/example/src/App.tsx](https://github.com/IgorNadj/rsf-zero/tree/main/exampl
 - [React Server Functions](https://react.dev/reference/rsc/server-functions)
 - Note: only the top-level `'use server'` is implemented by this framework.
 
-## Configuring
-See [configuring](https://github.com/IgorNadj/rsf-zero/tree/main/docs/configuring.md)
-
 ## Motivation
 
 **RSF Zero** is designed to be a dead simple micro-framework.
@@ -51,4 +48,4 @@ Read the [blog post](https://igornadj.io/blog/2025-08-02-rsf-is-all-you-need/) f
 
 🕊 **Minimal**: Add whatever you want on top, nothing bundled that you don't use\
 🕊 **Simple**: Add `'use server'` to run something on the server, and you're done, nothing new to learn\
-🕊️ **Done**: Instead, spend your spare time sipping a nice coffee or looking at a bird
+🕊️ **Done**: Instead, spend your spare time sipping a tea or looking at a nice bird

package/dist/cli/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AAMvB,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAGvD,eAAO,MAAM,GAAG,GAAU,SAAS,aAAa,kBAiC/C,CAAA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AAMvB,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAIvD,eAAO,MAAM,GAAG,GAAU,SAAS,aAAa,kBAqC/C,CAAA"}

package/dist/cli/dev.js

@@ -6,9 +6,12 @@ import { createActionRoute } from "./start/createActionRoute.js";
 import { debug } from "../utils/debug.js";
 import { customRoutesHook } from "../utils/customRoutesHook.js";
 import { onStartHook } from "../utils/onStartHook.js";
+import { onBeforeStartHook } from "../utils/onBeforeStartHook.js";
 export const dev = async (options) => {
     const app = express();
     const port = 3000;
+    // onBeforeStart hook
+    await onBeforeStartHook(options, app);
     app.use(morgan("dev"));
     app.use(express.json());
     // Dev RSF handler
@@ -28,6 +31,7 @@ export const dev = async (options) => {
     // - transform any actions found for the frontend
     // - and inform the onActionFound callback above
     const vite = await startVite({ app, onActionFound });
+    // onStart hook
     await onStartHook(options, app);
     app.listen(port, () => {
         console.log(`Server is running at http://localhost:${port}`);

package/dist/cli/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAIA,OAAO,eAAe,CAAC;AAGvB,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAMvD,eAAO,MAAM,KAAK,GAAU,SAAS,aAAa,kBAoCjD,CAAA"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAIA,OAAO,eAAe,CAAC;AAGvB,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAMvD,eAAO,MAAM,KAAK,GAAU,SAAS,aAAa,kBAwCjD,CAAA"}

package/dist/cli/start.js

@@ -13,10 +13,13 @@ import "dotenv/config";
 import { createActionRoute } from "./start/createActionRoute.js";
 import { debug } from "../utils/debug.js";
 import { customRoutesHook } from "../utils/customRoutesHook.js";
+import { onBeforeStartHook } from "../utils/onBeforeStartHook.js";
 import { onStartHook } from "../utils/onStartHook.js";
 export const start = async (options) => {
     const app = express();
     const port = 3000;
+    // onBeforeStart hook
+    await onBeforeStartHook(options, app);
     app.use(morgan("dev"));
     app.use(express.json());
     // Server
@@ -40,6 +43,7 @@ export const start = async (options) => {
             res.sendFile(path.join(process.cwd(), 'dist/client/index.html'));
         }
     });
+    // onStart hook
     await onStartHook(options, app);
     app.listen(port, () => {
         console.log(`Server is running at http://localhost:${port}`);

package/dist/utils/export-types.d.ts

@@ -4,5 +4,6 @@ export type RsfZeroConfig = {
     startStatic?: serveStatic.ServeStaticOptions;
     routes?: string[];
     onStart?: string;
+    onBeforeStart?: string;
 };
 //# sourceMappingURL=export-types.d.ts.map

package/dist/utils/export-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-types.d.ts","sourceRoot":"","sources":["../../src/utils/export-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAE5C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAA"}
+{"version":3,"file":"export-types.d.ts","sourceRoot":"","sources":["../../src/utils/export-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAE5C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAA"}

package/dist/utils/onBeforeStartHook.d.ts

@@ -0,0 +1,4 @@
+import { Express } from "express";
+import { RsfZeroConfig } from "./export-types.js";
+export declare const onBeforeStartHook: (options: RsfZeroConfig, app: Express) => Promise<void>;
+//# sourceMappingURL=onBeforeStartHook.d.ts.map

package/dist/utils/onBeforeStartHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onBeforeStartHook.d.ts","sourceRoot":"","sources":["../../src/utils/onBeforeStartHook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAGhD,eAAO,MAAM,iBAAiB,GAAU,SAAS,aAAa,EAAE,KAAK,OAAO,kBA+B3E,CAAA"}

package/dist/utils/onBeforeStartHook.js

@@ -0,0 +1,35 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import path from 'path';
+import { debug } from "./debug.js";
+export const onBeforeStartHook = async (options, app) => {
+    const { onBeforeStart } = options;
+    if (onBeforeStart) {
+        debug(`onBeforeStart config option found`);
+        if (typeof onBeforeStart !== 'string') {
+            throw new Error('Invalid onBeforeStart option. Must be a string.');
+        }
+        const absolutePath = path.isAbsolute(onBeforeStart)
+            ? onBeforeStart
+            : path.join(process.cwd(), onBeforeStart);
+        debug(`Loading onBeforeStart from: ${absolutePath}`);
+        const module = await import(__rewriteRelativeImportExtension(absolutePath));
+        const exportNames = Object.keys(module);
+        if (exportNames.length !== 1) {
+            throw new Error(`File ${absolutePath} must contain a single export.`);
+        }
+        const [firstExportName] = exportNames;
+        const firstExport = module[firstExportName];
+        if (!(typeof firstExport === 'function')) {
+            throw new Error(`File ${absolutePath} must export a function`);
+        }
+        firstExport(app);
+        debug(`onBeforeStart loaded successfully: ${absolutePath}`);
+    }
+};

package/package.json

@@ -3,7 +3,7 @@
   "description": "A minimal micro-framework with React Server Functions support",
   "author": "Igor Nadj",
   "type": "module",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "repository": {
     "type": "git",
     "url": "https://github.com/IgorNadj/rsf-zero.git",