@atscript/moost-validator 0.1.83 → 0.1.85

package/dist/index.cjs

@@ -26,6 +26,37 @@ const __atscript_typescript_utils = __toESM(require("@atscript/typescript/utils"
 const moost = __toESM(require("moost"));
 const __moostjs_event_http = __toESM(require("@moostjs/event-http"));
 
+//#region packages/moost-validator/src/as-coercion.pipe.ts
+/**
+* Param sources that arrive as strings over the wire and are safe to coerce
+* by default. `BODY` is deliberately excluded — coercing JSON bodies silently
+* loosens the API contract; opt in via {@link TCoercionOptions.sources}.
+*/ const DEFAULT_SOURCES = [
+	"ROUTE",
+	"QUERY",
+	"QUERY_ITEM"
+];
+const coercionPipe = (opts) => {
+	const sources = new Set(opts?.sources ?? DEFAULT_SOURCES);
+	return (0, moost.definePipeFn)((value, metas) => {
+		const source = metas?.targetMeta?.paramSource;
+		if (!source || !sources.has(source)) return value;
+		const t = metas?.targetMeta?.type;
+		if ((0, __atscript_typescript_utils.isAnnotatedType)(t)) return (0, __atscript_typescript_utils.coerceForType)(t, value);
+		if (t === Number) return (0, __atscript_typescript_utils.coerceScalar)("number", value);
+		if (t === Boolean) return (0, __atscript_typescript_utils.coerceScalar)("boolean", value);
+		if (t === Date) return coerceDate(value);
+		return value;
+	}, moost.TPipePriority.TRANSFORM);
+};
+const UseCoercionPipe = (opts) => (0, moost.Pipe)(coercionPipe(opts));
+function coerceDate(value) {
+	if (typeof value !== "string" || value.trim().length === 0) return value;
+	const parsed = new Date(value);
+	return Number.isNaN(parsed.getTime()) ? value : parsed;
+}
+
+//#endregion
 //#region packages/moost-validator/src/as-validator.pipe.ts
 const validatorPipe = (opts) => (0, moost.definePipeFn)((value, metas, level) => {
 	if (metas?.targetMeta?.optional && (value === undefined || value === null)) return value;
@@ -56,7 +87,9 @@ const validationErrorTransform = () => (0, moost.defineInterceptor)({
 const UseValidationErrorTransform = () => (0, moost.Intercept)(validationErrorTransform());
 
 //#endregion
+exports.UseCoercionPipe = UseCoercionPipe
 exports.UseValidationErrorTransform = UseValidationErrorTransform
 exports.UseValidatorPipe = UseValidatorPipe
+exports.coercionPipe = coercionPipe
 exports.validationErrorTransform = validationErrorTransform
 exports.validatorPipe = validatorPipe

package/dist/index.d.ts

@@ -1,6 +1,63 @@
 import * as moost from 'moost';
 import { TValidatorOptions } from '@atscript/typescript/utils';
 
+/** Options for configuring {@link coercionPipe} behavior. */
+interface TCoercionOptions {
+    /**
+     * Param sources (`paramSource` metadata stamped by Moost resolvers) the
+     * pipe coerces. Defaults to `['ROUTE', 'QUERY', 'QUERY_ITEM']` — the
+     * string-transport sources. Add `'BODY'` to opt in to body coercion.
+     */
+    sources?: string[];
+}
+/**
+ * **coercionPipe** ─ Creates a Moost *pipe* that coerces string-transport
+ * input (route params, query strings) toward the parameter's declared type
+ * before validation runs.
+ *
+ * For atscript-annotated types it delegates to `coerceForType` from
+ * `@atscript/typescript/utils` (scalars, unions, `@Query()` DTOs, arrays).
+ * For plain design types (`offset: number`, `flag: boolean`, `since: Date`)
+ * it falls back to direct constructor-based coercion — this also covers
+ * scalar `.as` aliases under tsc's `emitDecoratorMetadata`, where the alias
+ * identity collapses to `Number`.
+ *
+ * Coercion never throws and never validates — unparsable input passes
+ * through unchanged for {@link validatorPipe} to report. The pipe is
+ * registered at {@link TPipePriority.TRANSFORM}, so it composes ahead of
+ * `validatorPipe` (VALIDATE):
+ *
+ * @example
+ * ```ts
+ * const app = new Moost()
+ * app.applyGlobalPipes(coercionPipe(), validatorPipe())
+ *
+ * // KafkaOffset: @expect.int @expect.min 0 → export type KafkaOffset = number
+ * ‎@Get('topics/:topic')
+ * read(@Param('offset') offset: KafkaOffset) {
+ *   // offset is a validated number — no manual Number.parseInt
+ * }
+ * ```
+ *
+ * @param opts {@link TCoercionOptions}.
+ * @returns A ready‑to‑use `PipeFn` instance.
+ */
+declare const coercionPipe: (opts?: TCoercionOptions) => moost.TPipeFn<any>;
+/**
+ * Syntactic sugar decorator that applies {@link coercionPipe} to a handler or
+ * an entire controller class.
+ *
+ * @param opts {@link TCoercionOptions}.
+ *
+ * @example
+ * ```ts
+ * ‎@Get('items')
+ * ‎@UseCoercionPipe()
+ * list(@Query() query: SearchQuery) {}
+ * ```
+ */
+declare const UseCoercionPipe: (opts?: TCoercionOptions) => ClassDecorator & MethodDecorator & ParameterDecorator;
+
 /**
  * **validatorPipe** ─ Creates a Moost *pipe* that runs atscript validation on
  * handler parameters (body, params, query, etc.).
@@ -71,4 +128,5 @@ declare const validationErrorTransform: () => moost.TInterceptorDef;
  */
 declare const UseValidationErrorTransform: () => ClassDecorator & MethodDecorator;
 
-export { UseValidationErrorTransform, UseValidatorPipe, validationErrorTransform, validatorPipe };
+export { UseCoercionPipe, UseValidationErrorTransform, UseValidatorPipe, coercionPipe, validationErrorTransform, validatorPipe };
+export type { TCoercionOptions };

package/dist/index.mjs

@@ -1,7 +1,38 @@
-import { ValidatorError, isAnnotatedType } from "@atscript/typescript/utils";
+import { ValidatorError, coerceForType, coerceScalar, isAnnotatedType } from "@atscript/typescript/utils";
 import { Intercept, Pipe, TInterceptorPriority, TPipePriority, defineInterceptor, definePipeFn } from "moost";
 import { HttpError } from "@moostjs/event-http";
 
+//#region packages/moost-validator/src/as-coercion.pipe.ts
+/**
+* Param sources that arrive as strings over the wire and are safe to coerce
+* by default. `BODY` is deliberately excluded — coercing JSON bodies silently
+* loosens the API contract; opt in via {@link TCoercionOptions.sources}.
+*/ const DEFAULT_SOURCES = [
+	"ROUTE",
+	"QUERY",
+	"QUERY_ITEM"
+];
+const coercionPipe = (opts) => {
+	const sources = new Set(opts?.sources ?? DEFAULT_SOURCES);
+	return definePipeFn((value, metas) => {
+		const source = metas?.targetMeta?.paramSource;
+		if (!source || !sources.has(source)) return value;
+		const t = metas?.targetMeta?.type;
+		if (isAnnotatedType(t)) return coerceForType(t, value);
+		if (t === Number) return coerceScalar("number", value);
+		if (t === Boolean) return coerceScalar("boolean", value);
+		if (t === Date) return coerceDate(value);
+		return value;
+	}, TPipePriority.TRANSFORM);
+};
+const UseCoercionPipe = (opts) => Pipe(coercionPipe(opts));
+function coerceDate(value) {
+	if (typeof value !== "string" || value.trim().length === 0) return value;
+	const parsed = new Date(value);
+	return Number.isNaN(parsed.getTime()) ? value : parsed;
+}
+
+//#endregion
 //#region packages/moost-validator/src/as-validator.pipe.ts
 const validatorPipe = (opts) => definePipeFn((value, metas, level) => {
 	if (metas?.targetMeta?.optional && (value === undefined || value === null)) return value;
@@ -32,4 +63,4 @@ const validationErrorTransform = () => defineInterceptor({
 const UseValidationErrorTransform = () => Intercept(validationErrorTransform());
 
 //#endregion
-export { UseValidationErrorTransform, UseValidatorPipe, validationErrorTransform, validatorPipe };
+export { UseCoercionPipe, UseValidationErrorTransform, UseValidatorPipe, coercionPipe, validationErrorTransform, validatorPipe };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-validator",
-  "version": "0.1.83",
+  "version": "0.1.85",
   "description": "Validator pipe and utils for Moost.",
   "keywords": [
     "annotations",
@@ -36,15 +36,15 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@moostjs/event-http": "^0.6.31",
-    "moost": "^0.6.31",
+    "@moostjs/event-http": "^0.6.33",
+    "moost": "^0.6.33",
     "vitest": "3.2.4"
   },
   "peerDependencies": {
-    "@moostjs/event-http": "^0.6.31",
-    "moost": "^0.6.31",
-    "@atscript/core": "^0.1.83",
-    "@atscript/typescript": "^0.1.83"
+    "@moostjs/event-http": "^0.6.33",
+    "moost": "^0.6.33",
+    "@atscript/core": "^0.1.85",
+    "@atscript/typescript": "^0.1.85"
   },
   "scripts": {
     "pub": "pnpm publish --access public",