moost 0.6.25 → 0.6.27

package/README.md

@@ -1,66 +1,43 @@
 # moost
 
 <p align="center">
-<img src="../../moost-logo.png" width="450px"><br>
+<img src="https://raw.githubusercontent.com/moostjs/moostjs/main/moost-logo.png" width="450px"><br>
 <a  href="https://github.com/moostjs/moostjs/blob/main/LICENSE">
     <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" />
 </a>
 </p>
 
-Welcome to Moostjs, a metadata-driven Event Processing Framework inspired by [NestJS](https://nestjs.com/) and powered by [Wooks](https://wooks.moost.org).
+`moost` is the core of [Moostjs](https://github.com/moostjs/moostjs) — a metadata-driven Event Processing Framework inspired by [NestJS](https://nestjs.com/) and powered by [Wooks](https://wooks.moost.org). This package provides the `Moost` application class, the decorator system (`@Controller`, `@Injectable`, `@Intercept`, `@Pipe`, ...), dependency injection, interceptors, and pipes shared by every event adapter (`@moostjs/event-http`, `@moostjs/event-cli`, `@moostjs/event-ws`, `@moostjs/event-wf`).
 
-## Motivation
+## Quick Start
 
-Moostjs emerged from the belief that TypeScript decorators could significantly simplify application design. By employing the robust event processing capabilities of Wooks, the efficiency of dependency injections, and minimizing external dependencies, Moostjs aims to provide a streamlined, intuitive framework for web app development.
+```ts
+import { Moost, Controller, Param } from 'moost'
+import { MoostHttp, Get } from '@moostjs/event-http'
 
-Here's what sets Moost apart from NestJS:
+@Controller()
+class AppController {
+  @Get('hello/:name')
+  greet(@Param('name') name: string) {
+    return `Hello, ${name}!`
+  }
+}
 
-1. Abstraction of `modules` is not used, promoting a simpler architecture.
-2. Utilizes the reusable dependency injection framework [@prostojs/infact](https://github.com/prostojs/infact).
-3. Uses a metadata layer powered by [@prostojs/mate](https://github.com/prostojs/mate).
-4. Supports DTOs and validations powered by [@prostojs/valido](https://github.com/prostojs/valido).
-5. Does not use Express or Fastify, but these can be employed with an adapter.
-6. Currently, Moost does not support additional techniques like ORMs, Queues, etc.
+const app = new Moost()
+void app.adapter(new MoostHttp()).listen(3000)
+void app.registerControllers(AppController).init()
+```
 
 ## [Official Documentation](https://moost.org/)
 
-## AI Agent Skills
+## AI Agent Skill
 
-This package ships with AI agent skills that provide context-aware documentation to AI coding assistants (Claude Code, Cursor, Windsurf, Codex, OpenCode).
+A unified AI agent skill with framework guidance across all Moost packages is available for AI coding assistants (Claude Code, Cursor, Windsurf, Codex, OpenCode):
 
 ```bash
-# Project-local (recommended — version-locked, commits with your repo)
-npx moost-skill
-
-# Global (available across all your projects)
-npx moost-skill --global
-```
-
-To auto-install on `npm install`, add to your `package.json`:
-```json
-{
-  "scripts": {
-    "postinstall": "moost-skill --postinstall"
-  }
-}
+npx skills add moostjs/moostjs
 ```
 
 ## Contributing
 
-We are excited to welcome contributors who are passionate about improving Moostjs. No matter your level of experience, your unique perspective and skills can make valuable contributions to our growing community.
-
-Here are some basic steps to get you started:
-
-1. **Fork the Repo:** Navigate to [moostjs](https://github.com/moostjs/moostjs) and fork the repository to your own GitHub account.
-
-2. **Clone the Repo:** Clone the forked repository to your local machine.
-
-3. **Create a Branch:** Make a new branch for your feature or bug fix.
-
-4. **Make your Changes:** Implement your feature or fix the bug and commit the changes to your branch.
-
-5. **Make a Pull Request:** Navigate back to your forked repo and press the "New pull request" button.
-
-Don't hesitate to ask for help if you need it. We believe in fostering a friendly and respectful environment for all contributors.
-
-Thank you for your interest in Moostjs. We look forward to building something amazing together!
+See the [repository README](https://github.com/moostjs/moostjs#contributing) for motivation and contribution guidelines.

package/dist/index.cjs

@@ -175,10 +175,8 @@ const scopeVarsMap = /* @__PURE__ */ new Map();
 			}
 			let logger;
 			try {
-				const ctxLogger = event === "error" ? getDefaultLogger(INFACT_BANNER) : (0, _wooksjs_event_core.useLogger)();
-				const withTopic = ctxLogger;
-				logger = typeof withTopic.topic === "function" ? withTopic.topic(INFACT_BANNER) : ctxLogger;
-			} catch (error) {
+				logger = event === "error" ? getDefaultLogger(INFACT_BANNER) : (0, _wooksjs_event_core.useLogger)(INFACT_BANNER);
+			} catch {
 				logger = getDefaultLogger(INFACT_BANNER);
 			}
 			const instance = `${targetClass.name}`;
@@ -325,8 +323,7 @@ function nextScopeId() {
 	return () => {
 		const ctx = (0, _wooksjs_event_core.current)();
 		const scopeId = useScopeId(ctx);
-		const ctxLogger = (0, _wooksjs_event_core.useLogger)(ctx);
-		const logger = typeof ctxLogger.topic === "function" ? ctxLogger.topic(options.loggerTitle) : ctxLogger;
+		const logger = (0, _wooksjs_event_core.useLogger)(options.loggerTitle, ctx);
 		const unscope = registerEventScope(scopeId);
 		let response;
 		let hookOptions;
@@ -426,9 +423,11 @@ function nextScopeId() {
 		}
 		function cleanup() {
 			if (interceptorHandler?.countAfter || interceptorHandler?.countOnError) {
+				const raisedResponse = response;
 				const afterResult = ci ? ci.with("Interceptors:after", () => interceptorHandler?.fireAfter(response)) : interceptorHandler?.fireAfter(response);
 				if (isThenable(afterResult)) return afterResult.then((r) => {
 					response = r;
+					if (raise && response !== raisedResponse) raise = false;
 					return finalize();
 				}, (error) => {
 					if (options.logErrors) logger.error(String(error));
@@ -436,6 +435,7 @@ function nextScopeId() {
 					throw error;
 				});
 				response = afterResult;
+				if (raise && response !== raisedResponse) raise = false;
 			}
 			return finalize();
 		}
@@ -854,20 +854,17 @@ var TInterceptorPriority = /* @__PURE__ */ function(TInterceptorPriority) {
 * @param topic
 * @returns Resolver to '@wooksjs/event-core' (Logger)
 */ function InjectEventLogger(topic) {
-	return Resolve(() => {
-		const l = (0, _wooksjs_event_core.useLogger)();
-		return topic && typeof l.topic === "function" ? l.topic(topic) : l;
-	});
+	return Resolve(() => topic ? (0, _wooksjs_event_core.useLogger)(topic) : (0, _wooksjs_event_core.useLogger)());
 }
 /**
 * Resolves app-level logger
-* @param topic - logger topic (can be overrided by @LoggerTopic)
+* @param topic - logger topic (falls back to @LoggerTopic, then to class @Id)
 * @returns
 */ function InjectMoostLogger(topic) {
 	return Resolve(async (metas) => {
 		const moostApp = await resolveMoost();
 		const meta = metas.classMeta;
-		return moostApp.getLogger(meta?.loggerTopic || topic || meta?.id);
+		return moostApp.getLogger(topic || meta?.loggerTopic || meta?.id);
 	});
 }
 /**
@@ -945,7 +942,8 @@ var TInterceptorPriority = /* @__PURE__ */ function(TInterceptorPriority) {
 * (For optional values use with @Optional())
 * @param type - string or class constructor
 */ function Inject(type) {
-	return getMoostMate().decorate("inject", type);
+	const key = typeof type === "string" ? type : Symbol.for(String(type));
+	return getMoostMate().decorate("inject", key);
 }
 /**
 * Injects instance from scope

package/dist/index.d.ts

@@ -710,7 +710,7 @@ declare function Response(): ParameterDecorator;
 declare function InjectEventLogger(topic?: string): ParameterDecorator & PropertyDecorator;
 /**
  * Resolves app-level logger
- * @param topic - logger topic (can be overrided by @LoggerTopic)
+ * @param topic - logger topic (falls back to @LoggerTopic, then to class @Id)
  * @returns
  */
 declare function InjectMoostLogger(topic?: string): ParameterDecorator & PropertyDecorator;
@@ -860,6 +860,7 @@ interface TMoostEventHandlerHookOptions<T> {
 }
 /** Configuration for `defineMoostEventHandler`, describing how to resolve and invoke a handler. */
 interface TMoostEventHandlerOptions<T> {
+    /** @deprecated unused since wooks v0.7 — the event kind comes from the wooks adapter */
     contextType?: string | string[];
     loggerTitle: string;
     getIterceptorHandler: () => InterceptorHandler | undefined;

package/dist/index.mjs

@@ -174,10 +174,8 @@ const scopeVarsMap = /* @__PURE__ */ new Map();
 			}
 			let logger;
 			try {
-				const ctxLogger = event === "error" ? getDefaultLogger(INFACT_BANNER) : useLogger$1();
-				const withTopic = ctxLogger;
-				logger = typeof withTopic.topic === "function" ? withTopic.topic(INFACT_BANNER) : ctxLogger;
-			} catch (error) {
+				logger = event === "error" ? getDefaultLogger(INFACT_BANNER) : useLogger$1(INFACT_BANNER);
+			} catch {
 				logger = getDefaultLogger(INFACT_BANNER);
 			}
 			const instance = `${targetClass.name}`;
@@ -324,8 +322,7 @@ function nextScopeId() {
 	return () => {
 		const ctx = current$1();
 		const scopeId = useScopeId(ctx);
-		const ctxLogger = useLogger$1(ctx);
-		const logger = typeof ctxLogger.topic === "function" ? ctxLogger.topic(options.loggerTitle) : ctxLogger;
+		const logger = useLogger$1(options.loggerTitle, ctx);
 		const unscope = registerEventScope(scopeId);
 		let response;
 		let hookOptions;
@@ -425,9 +422,11 @@ function nextScopeId() {
 		}
 		function cleanup() {
 			if (interceptorHandler?.countAfter || interceptorHandler?.countOnError) {
+				const raisedResponse = response;
 				const afterResult = ci ? ci.with("Interceptors:after", () => interceptorHandler?.fireAfter(response)) : interceptorHandler?.fireAfter(response);
 				if (isThenable(afterResult)) return afterResult.then((r) => {
 					response = r;
+					if (raise && response !== raisedResponse) raise = false;
 					return finalize();
 				}, (error) => {
 					if (options.logErrors) logger.error(String(error));
@@ -435,6 +434,7 @@ function nextScopeId() {
 					throw error;
 				});
 				response = afterResult;
+				if (raise && response !== raisedResponse) raise = false;
 			}
 			return finalize();
 		}
@@ -853,20 +853,17 @@ var TInterceptorPriority = /* @__PURE__ */ function(TInterceptorPriority) {
 * @param topic
 * @returns Resolver to '@wooksjs/event-core' (Logger)
 */ function InjectEventLogger(topic) {
-	return Resolve(() => {
-		const l = useLogger$1();
-		return topic && typeof l.topic === "function" ? l.topic(topic) : l;
-	});
+	return Resolve(() => topic ? useLogger$1(topic) : useLogger$1());
 }
 /**
 * Resolves app-level logger
-* @param topic - logger topic (can be overrided by @LoggerTopic)
+* @param topic - logger topic (falls back to @LoggerTopic, then to class @Id)
 * @returns
 */ function InjectMoostLogger(topic) {
 	return Resolve(async (metas) => {
 		const moostApp = await resolveMoost();
 		const meta = metas.classMeta;
-		return moostApp.getLogger(meta?.loggerTopic || topic || meta?.id);
+		return moostApp.getLogger(topic || meta?.loggerTopic || meta?.id);
 	});
 }
 /**
@@ -944,7 +941,8 @@ var TInterceptorPriority = /* @__PURE__ */ function(TInterceptorPriority) {
 * (For optional values use with @Optional())
 * @param type - string or class constructor
 */ function Inject(type) {
-	return getMoostMate().decorate("inject", type);
+	const key = typeof type === "string" ? type : Symbol.for(String(type));
+	return getMoostMate().decorate("inject", key);
 }
 /**
 * Injects instance from scope

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moost",
-  "version": "0.6.25",
+  "version": "0.6.27",
   "description": "moost",
   "keywords": [
     "composables",
@@ -41,15 +41,15 @@
     "@prostojs/infact": "^0.4.1",
     "@prostojs/logger": "^0.4.3",
     "@prostojs/mate": "^0.4.0",
-    "@wooksjs/event-core": "^0.7.17",
+    "@wooksjs/event-core": "^0.7.19",
     "hookable": "^5.5.3",
-    "wooks": "^0.7.17"
+    "wooks": "^0.7.19"
   },
   "devDependencies": {
-    "@wooksjs/event-http": "^0.7.17",
-    "@wooksjs/http-body": "^0.7.17",
+    "@wooksjs/event-http": "^0.7.19",
+    "@wooksjs/http-body": "^0.7.19",
     "vitest": "3.2.4",
-    "@moostjs/event-http": "^0.6.25"
+    "@moostjs/event-http": "^0.6.27"
   },
   "scripts": {
     "pub": "pnpm publish --access public",