create-colonel 0.1.5 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-colonel",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "files": [
     "src",

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "colonel-app",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "private": true,
   "scripts": {
@@ -8,7 +8,7 @@
     "upgrade:colonel": "bun add @coloneldev/framework@latest"
   },
   "dependencies": {
-    "@coloneldev/framework": "^0.1.4",
+    "@coloneldev/framework": "^0.1.5",
     "ejs": "^5.0.1"
   },
   "devDependencies": {

package/template/resources/views/base/index.ejs

@@ -134,7 +134,7 @@
 		</p>
 		<div class="cta">
 			<a class="btn btn-primary" href="/users">View User Route</a>
-			<a class="btn btn-secondary" href="https://github.com" target="_blank" rel="noreferrer">Open Documentation</a>
+			<a class="btn btn-secondary" href="<%= docsUrl || 'https://gwhitdev.github.io/colonel-framework/' %>" target="_blank" rel="noreferrer">Open Documentation</a>
 		</div>
 
 		<div class="grid">

package/template/src/app/Http/Controllers/AppController.ts

@@ -1,3 +1,4 @@
+import type { HttpRequest } from "@coloneldev/framework";
 import Controller from './Controller';
 import { AppInfoService } from '../../Services/AppInfoService';
 
@@ -8,12 +9,17 @@ export class AppController extends Controller {
         super();
     }
 
-    index(): Record<string, any> {
+    index(req: HttpRequest): Record<string, any> {
+        const previousVisits = this.sessionGet<number>(req, "visits") ?? 0;
+        const visits = previousVisits + 1;
+        this.sessionPut(req, "visits", visits);
+
         return [
             'base/index',
             {
                 "titleData": this.appInfoService.welcomeTitle(),
-                
+                "docsUrl": this.appInfoService.documentationUrl(),
+                "footerData": `Session visits: ${visits}`,
             },
         ]
     }

package/template/src/app/Http/Controllers/Controller.ts

@@ -1,3 +1,5 @@
+import type { HttpRequest, Session } from "@coloneldev/framework";
+
 export default class Controller {
     constructor() {
         // Base constructor logic can be added here if needed
@@ -6,4 +8,24 @@ export default class Controller {
     health(): Record<string, string> {
         return { status: "ok" };
     }
+
+    protected requireSession(req: HttpRequest): Session {
+        if (!req.session) {
+            throw new Error("Session is not enabled for this request");
+        }
+
+        return req.session;
+    }
+
+    protected sessionGet<T = unknown>(req: HttpRequest, key: string): T | undefined {
+        return this.requireSession(req).get<T>(key);
+    }
+
+    protected sessionPut(req: HttpRequest, key: string, value: unknown): void {
+        this.requireSession(req).set(key, value);
+    }
+
+    protected sessionForget(req: HttpRequest, key: string): void {
+        this.requireSession(req).forget(key);
+    }
 }

package/template/src/app/Services/AppInfoService.ts

@@ -1,7 +1,14 @@
 export class AppInfoService {
-    constructor(private appName: string) {}
+    constructor(
+        private appName: string,
+        private docsUrl: string = "https://gwhitdev.github.io/colonel-framework/"
+    ) {}
 
     welcomeTitle(): string {
         return `Welcome to ${this.appName}`;
     }
+
+    documentationUrl(): string {
+        return this.docsUrl;
+    }
 }

package/template/src/bootstrap/server.ts

@@ -13,11 +13,20 @@ const publicRoot = path.resolve(import.meta.dir, "..", "..", "public");
 const controllerRoot = path.resolve(import.meta.dir, "..", "app", "Http", "Controllers");
 const container = new Container();
 
-container.singleton(AppInfoService, () => new AppInfoService(process.env.appName ?? "Colonel"));
+container.singleton(
+    AppInfoService,
+    () => new AppInfoService(
+        process.env.appName ?? "Colonel",
+        process.env.COLONEL_DOCS_URL ?? "https://gwhitdev.github.io/colonel-framework/"
+    )
+);
 
 export const server = () => {
     const Colonel = new Kernel(webRouter, [], {
         viewsRoot,
+        session: {
+            enabled: true,
+        },
         controllerResolver: async (name: string) => {
             const modulePath = `${controllerRoot}/${name}.ts`;
             const mod = await import(modulePath);