@itrocks/framework 0.6.0 → 0.6.1

package/README.md

@@ -59,15 +59,21 @@ framework once at startup. It will:
 // index.ts
 import '@itrocks/framework'
 
-// Import your application modules so that their configuration, actions
-// and templates are discovered during composition.
-import '@itrocks/home'
-import './src/domain'
 ```
 
 When this file is executed with Node (after TypeScript compilation), the
 framework starts automatically and exposes your routes and actions.
 
+Application code that must run after module composition but before the HTTP
+server starts can register an initializer without loading domain decorators
+during bootstrap:
+
+```ts
+import { beforeFrameworkRun } from '@itrocks/framework'
+
+beforeFrameworkRun(() => import('./src/dependencies'))
+```
+
 ### Using framework reflection helpers
 
 `ReflectClass` and `ReflectProperty` behave like their counterparts from
@@ -119,7 +125,7 @@ In this example:
 
 ## API
 
-`@itrocks/framework` exposes two main public symbols and the side‑effect
+`@itrocks/framework` exposes its bootstrap initializer, two reflection helpers and the side‑effect
 of bootstrapping the framework when its main module is imported.
 
 ### Framework bootstrap (side‑effect of importing `@itrocks/framework`)
@@ -145,6 +151,13 @@ You normally do not call any of these functions directly. Importing the
 module once at startup is enough to run your application, provided that
 you have configured your routes and modules.
 
+### `beforeFrameworkRun(initializer)`
+
+Registers application wiring that must load after it.rocks composition and dependency binding,
+but before routes are loaded and the HTTP server starts. Initializers run sequentially in their
+registration order and may be asynchronous. Use this for application-specific dependency hooks;
+keep domain imports inside the callback.
+
 ### `class ReflectClass<T extends object = object> extends RC<T>`
 
 Enhanced reflection class that extends

package/cjs/framework.d.ts

@@ -1,4 +1,6 @@
 import '@itrocks/class-file/automation';
+export type FrameworkInitializer = () => Promise<void> | void;
 export { servers } from './main';
 export { ReflectClass } from './reflect-class';
 export { ReflectProperty } from './reflect-property';
+export declare function beforeFrameworkRun(initializer: FrameworkInitializer): void;

package/cjs/framework.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReflectProperty = exports.ReflectClass = exports.servers = void 0;
+exports.beforeFrameworkRun = beforeFrameworkRun;
 require("@itrocks/class-file/automation");
 const compose_1 = require("@itrocks/compose");
 const config_1 = require("@itrocks/config");
@@ -11,13 +12,19 @@ var reflect_class_1 = require("./reflect-class");
 Object.defineProperty(exports, "ReflectClass", { enumerable: true, get: function () { return reflect_class_1.ReflectClass; } });
 var reflect_property_1 = require("./reflect-property");
 Object.defineProperty(exports, "ReflectProperty", { enumerable: true, get: function () { return reflect_property_1.ReflectProperty; } });
-(0, config_2.scanConfigFiles)().then(() => {
+const initializers = new Array();
+function beforeFrameworkRun(initializer) {
+    initializers.push(initializer);
+}
+(0, config_2.scanConfigFiles)().then(async () => {
     const frameworkCompose = {
         '@itrocks/store:Store': '/store-representative:Store'
     };
     (0, compose_1.compose)(__dirname, Object.assign(frameworkCompose, config_1.config.compose));
     require('@itrocks/default-action-workflow').build();
     require('./dependencies').bind();
-    require('./main').run();
+    for (const initializer of initializers)
+        await initializer();
+    await require('./main').run();
 });
 //# sourceMappingURL=framework.js.map

package/cjs/main.d.ts

@@ -1,4 +1,4 @@
-export declare function run(): Promise<void>;
 export declare const servers: {
     stop: () => void;
 }[];
+export declare function run(): Promise<void>;

package/cjs/main.js

@@ -2,23 +2,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.servers = void 0;
 exports.run = run;
-const action_1 = require("@itrocks/action");
-const action_2 = require("@itrocks/action");
 const action_request_1 = require("@itrocks/action-request");
 const action_request_2 = require("@itrocks/action-request");
+const action_1 = require("@itrocks/action");
+const action_2 = require("@itrocks/action");
 const app_dir_1 = require("@itrocks/app-dir");
 const class_type_1 = require("@itrocks/class-type");
 const config_1 = require("@itrocks/config");
-const fastify_1 = require("@itrocks/fastify");
 const fastify_file_session_store_1 = require("@itrocks/fastify-file-session-store");
+const fastify_1 = require("@itrocks/fastify");
 const request_response_1 = require("@itrocks/request-response");
 const route_1 = require("@itrocks/route");
+const session_1 = require("@itrocks/session");
 const store_1 = require("@itrocks/store");
 const template_1 = require("@itrocks/template");
 const node_crypto_1 = require("node:crypto");
 const node_path_1 = require("node:path");
 const node_path_2 = require("node:path");
 const ephemeralSessionSecret = (0, node_crypto_1.randomBytes)(32).toString('base64url');
+exports.servers = new Array();
 template_1.frontScripts.push('/lib/air-datepicker/locale/en.js', '/lib/air-datepicker/locale/fr.js');
 async function execute(request) {
     // Access control
@@ -63,6 +65,8 @@ async function run() {
         getModule: route_1.routes.resolve.bind(route_1.routes),
         isDomainObject: object => (0, class_type_1.isAnyType)(object) && !(object.prototype instanceof action_1.Action)
     });
+    const sessionStore = new fastify_file_session_store_1.FileStore((0, node_path_2.normalize)((0, node_path_1.join)(app_dir_1.appDir, config_1.config.session.path)));
+    (0, session_1.sessionDependsOn)({ store: sessionStore });
     const server = new fastify_1.FastifyServer({
         assetPath: app_dir_1.appDir,
         cookie: config_1.config.session.cookie,
@@ -76,12 +80,11 @@ async function run() {
         scriptCalls: ['loadCss', 'loadScript'],
         secret: config_1.config.session.secret ?? config_1.config.secret ?? ephemeralSessionSecret,
         secure: config_1.config.server.secure ?? 'auto',
-        store: new fastify_file_session_store_1.FileStore((0, node_path_2.normalize)((0, node_path_1.join)(app_dir_1.appDir, config_1.config.session.path)))
+        store: sessionStore
     });
     server.run();
     exports.servers.push(server);
 }
-exports.servers = new Array();
 function toResponse(mixedResponse) {
     return (typeof mixedResponse === 'string')
         ? new request_response_1.Response(mixedResponse)

package/package.json

@@ -44,6 +44,7 @@
 		"@itrocks/request-response": "latest",
 		"@itrocks/required": "latest",
 		"@itrocks/route": "latest",
+		"@itrocks/session": "latest",
 		"@itrocks/sql-build": "latest",
 		"@itrocks/sql-functions": "latest",
 		"@itrocks/sql-join": "latest",
@@ -101,5 +102,5 @@
 		"build:back": "tsc",
 		"build:front": "tsc -p src/front/tsconfig.json && node -e \"const fs=require('node:fs');for(const file of fs.readdirSync('.').filter(file=>file.endsWith('.js')||file.endsWith('.d.ts')))fs.writeFileSync(file,fs.readFileSync(file,'utf8').replaceAll('../../',''))\""
 	},
-	"version": "0.6.0"
+	"version": "0.6.1"
 }