fastnode-cli 0.3.0 → 0.5.0

package/README.md

@@ -1,3 +1,11 @@
+<p align="center">
+  <img
+    src="https://res.cloudinary.com/dlvcthd0a/image/upload/v1773121010/fast_cgma5m.png"
+    alt="FastNode logo"
+    width="220"
+  />
+</p>
+
 # fastnode-cli
 
 `fastnode-cli` scaffolds FastNode applications and works with `fastnode-core`.
@@ -51,6 +59,7 @@ The generated app now includes a minimal HTTP + Socket.IO setup:
 
 - app-level default execution policy in `createApp(...)`
 - controller-level policy with `@ExecutionPolicy(...)`
+- request-scoped execution helpers with `@Context()`
 - FastAPI-style path placeholders like `/{item_id}`
 - parameter decorators like `@Param()` and `@Query()`
 - one Socket.IO namespace controller with `@Subscribe()` and `@EmitToClient()`
@@ -63,6 +72,7 @@ Example generated shape:
 import "reflect-metadata";
 import {
   Body,
+  Context,
   Controller,
   EmitToClient,
   ExecutionPolicy,
@@ -79,9 +89,12 @@ import {
 @ExecutionPolicy({ timeout: 5000 })
 class HelloController {
   @Get("/")
-  hello(@Query("name") name?: string) {
+  async hello(@Query("name") name?: string, @Context() ctx?: any) {
+    await ctx?.sleep(25);
+
     return {
       message: `Hello from hello${name ? `, ${name}` : ""}`,
+      deadline: ctx?.snapshot?.().deadline,
     };
   }
 
@@ -125,6 +138,8 @@ See `packages/core/README.md` for the full framework guide, including:
 
 - `@ExecutionPolicy()`
 - `@UseExecutionPolicy()`
+- `@Context()`
+- `@IsolatedInput()`
 - `@IsolatedHandler()`
 - `@SocketController()`
 - `@Subscribe()`

package/dist/index.js

@@ -90,6 +90,7 @@ function buildMainTemplate(projectName) {
     return `import "reflect-metadata";
 import {
   Body,
+  Context,
   Controller,
   EmitToClient,
   ExecutionPolicy,
@@ -107,9 +108,15 @@ import {
 @ExecutionPolicy({ timeout: 5000 })
 class ${className} {
   @Get("/")
-  hello(@Query("name") name?: string) {
+  async hello(
+    @Query("name") name?: string,
+    @Context() ctx?: any
+  ) {
+    await ctx?.sleep(25);
+
     return {
       message: \`Hello from ${projectName}\${name ? \`, \${name}\` : ""}\`,
+      deadline: ctx?.snapshot?.().deadline,
     };
   }
 
@@ -146,6 +153,7 @@ class ${toPascalCase(projectName)}SocketController {
 @Module({ controllers: [${className}, ${toPascalCase(projectName)}SocketController] })
 class ${moduleName} {}
 
+// Drop files into ./static to serve them automatically, for example static/logo.png -> /logo.png.
 createApp([${moduleName}], {
   executionPolicy: {
     timeout: 30000,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fastnode-cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "The official CLI for scaffolding and serving FastNode applications.",
   "bin": {
     "fastnode": "dist/index.js"
@@ -19,23 +19,23 @@
     "scaffolding",
     "generator",
     "fastnode"
-  ],
-  "author": "Valentine Emmanuel Ikechukwu",
-  "license": "MIT",
+  ],
+  "author": "Valentine Emmanuel Ikechukwu",
+  "license": "MIT",
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^11.0.0",
-    "fastnode-core": "^0.3.0",
+    "fastnode-core": "^0.5.0",
     "reflect-metadata": "^0.1.13"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",
     "typescript": "^5.0.0"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "publishConfig": {
     "access": "public"
   }
-}
+}