@asterflow/router 2.0.2 → 2.2.0

package/dist/cjs/index.cjs

@@ -1,38 +1,39 @@
 "use strict";
-var i = Object.defineProperty;
+var h = Object.defineProperty;
 var x = Object.getOwnPropertyDescriptor;
-var M = Object.getOwnPropertyNames;
+var R = Object.getOwnPropertyNames;
 var w = Object.prototype.hasOwnProperty;
 var f = (r, e) => {
   for (var t in e)
-    i(r, t, { get: e[t], enumerable: !0 });
-}, g = (r, e, t, s) => {
+    h(r, t, { get: e[t], enumerable: !0 });
+}, g = (r, e, t, o) => {
   if (e && typeof e == "object" || typeof e == "function")
-    for (let n of M(e))
-      !w.call(r, n) && n !== t && i(r, n, { get: () => e[n], enumerable: !(s = x(e, n)) || s.enumerable });
+    for (let n of R(e))
+      !w.call(r, n) && n !== t && h(r, n, { get: () => e[n], enumerable: !(o = x(e, n)) || o.enumerable });
   return r;
 };
-var A = (r) => g(i({}, "__esModule", { value: !0 }), r);
+var A = (r) => g(h({}, "__esModule", { value: !0 }), r);
 // packages/router/src/index.ts
-var E = {};
-f(E, {
-  Method: () => u,
-  MethodType: () => c,
-  Middleware: () => l,
+var O = {};
+f(O, {
+  Method: () => E,
+  MethodClass: () => i,
+  MethodType: () => m,
+  Middleware: () => u,
   RouteMethodBuilder: () => a,
   Router: () => d,
   RouterBuilder: () => p,
   getRouteExtensions: () => S,
-  setRouteExtensions: () => h
+  setRouteExtensions: () => l
 });
-module.exports = A(E);
+module.exports = A(O);
 // packages/router/src/controllers/extensionRegistry.ts
-var m =  new WeakMap();
-function h(r, e) {
-  Object.keys(e).length !== 0 && m.set(r, e);
+var c =  new WeakMap();
+function l(r, e) {
+  Object.keys(e).length !== 0 && c.set(r, e);
 }
 function S(r) {
-  return m.get(r);
+  return c.get(r);
 }
 // packages/router/src/controllers/Router.ts
 var d = class r {
@@ -44,8 +45,8 @@ var d = class r {
   methods;
   use;
   constructor(e) {
-    let { name: t, path: s, param: n, schema: y, description: P, methods: R } = e;
-    this.name = t, this.path = s ?? n, this.schema = y, this.description = P, this.methods = R, this.use = e.use;
+    let { name: t, path: o, param: n, schema: y, description: P, methods: M } = e;
+    this.name = t, this.path = o ?? n, this.schema = y, this.description = P, this.methods = M, this.use = e.use;
   }
   static create() {
     return (e) => new r(e);
@@ -67,12 +68,12 @@ var d = class r {
     super({ ...e, methods: {} });
   }
   method(e, t) {
-    let s = t(new a());
-    return this.methods[e] = s.handler, Object.keys(s.registrations).length > 0 && (this.perMethodRegistrations[e] = s.registrations, h(this, this.perMethodRegistrations)), this;
+    let o = t(new a());
+    return this.methods[e] = o.handler, Object.keys(o.registrations).length > 0 && (this.perMethodRegistrations[e] = o.registrations, l(this, this.perMethodRegistrations)), this;
   }
 };
 // packages/router/src/controllers/Middleware.ts
-var l = class {
+var u = class {
   name;
   onRun;
   constructor(e) {
@@ -80,7 +81,7 @@ var l = class {
   }
 };
 // packages/router/src/controllers/Method.ts
-var u = class r {
+var i = class r {
   static ALL = "all";
   static GET = "get";
   static POST = "post";
@@ -98,10 +99,10 @@ var u = class r {
   handler;
   extensions = {};
   constructor(e, t) {
-    this.path = t.path ?? t.param, this.method = e, this.schema = t.schema, this.use = t.use, this.handler = t.handler ?? ((s) => {
-      if (typeof s != "function")
+    this.path = t.path ?? t.param, this.method = e, this.schema = t.schema, this.use = t.use, this.handler = t.handler ?? ((o) => {
+      if (typeof o != "function")
         throw new TypeError("This route was built with Method.create(...) but never finished with a terminal .handler(...) call before being used.");
-      return this.handler = s, this;
+      return this.handler = o, this;
     });
   }
   static create(e, t = {}) {
@@ -113,11 +114,12 @@ var u = class r {
   extend(e, t) {
     return t && Object.assign(this.extensions, t), this;
   }
-};
+}, E = i;
 // packages/router/src/types/method.ts
-var c =  ((o) => (o.all = "all", o.get = "get", o.post = "post", o.put = "put", o.delete = "delete", o.options = "options", o.head = "head", o.patch = "patch", o))(c || {});
+var m =  ((s) => (s.all = "all", s.get = "get", s.post = "post", s.put = "put", s.delete = "delete", s.options = "options", s.head = "head", s.patch = "patch", s))(m || {});
 0 && (module.exports = {
   Method,
+  MethodClass,
   MethodType,
   Middleware,
   RouteMethodBuilder,

package/dist/mjs/index.js

@@ -1,10 +1,10 @@
 // packages/router/src/controllers/extensionRegistry.ts
-var p =  new WeakMap();
-function i(r, e) {
-  Object.keys(e).length !== 0 && p.set(r, e);
+var i =  new WeakMap();
+function h(r, e) {
+  Object.keys(e).length !== 0 && i.set(r, e);
 }
-function R(r) {
-  return p.get(r);
+function M(r) {
+  return i.get(r);
 }
 // packages/router/src/controllers/Router.ts
 var n = class r {
@@ -16,8 +16,8 @@ var n = class r {
   methods;
   use;
   constructor(e) {
-    let { name: t, path: s, param: u, schema: m, description: c, methods: y } = e;
-    this.name = t, this.path = s ?? u, this.schema = m, this.description = c, this.methods = y, this.use = e.use;
+    let { name: t, path: o, param: u, schema: c, description: m, methods: y } = e;
+    this.name = t, this.path = o ?? u, this.schema = c, this.description = m, this.methods = y, this.use = e.use;
   }
   static create() {
     return (e) => new r(e);
@@ -39,12 +39,12 @@ var n = class r {
     super({ ...e, methods: {} });
   }
   method(e, t) {
-    let s = t(new d());
-    return this.methods[e] = s.handler, Object.keys(s.registrations).length > 0 && (this.perMethodRegistrations[e] = s.registrations, i(this, this.perMethodRegistrations)), this;
+    let o = t(new d());
+    return this.methods[e] = o.handler, Object.keys(o.registrations).length > 0 && (this.perMethodRegistrations[e] = o.registrations, h(this, this.perMethodRegistrations)), this;
   }
 };
 // packages/router/src/controllers/Middleware.ts
-var h = class {
+var l = class {
   name;
   onRun;
   constructor(e) {
@@ -52,7 +52,7 @@ var h = class {
   }
 };
 // packages/router/src/controllers/Method.ts
-var l = class r {
+var p = class r {
   static ALL = "all";
   static GET = "get";
   static POST = "post";
@@ -70,10 +70,10 @@ var l = class r {
   handler;
   extensions = {};
   constructor(e, t) {
-    this.path = t.path ?? t.param, this.method = e, this.schema = t.schema, this.use = t.use, this.handler = t.handler ?? ((s) => {
-      if (typeof s != "function")
+    this.path = t.path ?? t.param, this.method = e, this.schema = t.schema, this.use = t.use, this.handler = t.handler ?? ((o) => {
+      if (typeof o != "function")
         throw new TypeError("This route was built with Method.create(...) but never finished with a terminal .handler(...) call before being used.");
-      return this.handler = s, this;
+      return this.handler = o, this;
     });
   }
   static create(e, t = {}) {
@@ -85,16 +85,17 @@ var l = class r {
   extend(e, t) {
     return t && Object.assign(this.extensions, t), this;
   }
-};
+}, g = p;
 // packages/router/src/types/method.ts
-var P =  ((o) => (o.all = "all", o.get = "get", o.post = "post", o.put = "put", o.delete = "delete", o.options = "options", o.head = "head", o.patch = "patch", o))(P || {});
+var P =  ((s) => (s.all = "all", s.get = "get", s.post = "post", s.put = "put", s.delete = "delete", s.options = "options", s.head = "head", s.patch = "patch", s))(P || {});
 export {
-  l as Method,
+  g as Method,
+  p as MethodClass,
   P as MethodType,
-  h as Middleware,
+  l as Middleware,
   d as RouteMethodBuilder,
   n as Router,
   a as RouterBuilder,
-  R as getRouteExtensions,
-  i as setRouteExtensions
+  M as getRouteExtensions,
+  h as setRouteExtensions
 };

package/dist/types/controllers/Method.d.ts

@@ -6,6 +6,20 @@ import type { MiddlewareOutput } from '../types/mindleware';
 import type { AnySchema } from '../types/schema';
 import type { MergeProps } from '../types/utils';
 import type { Middleware } from './Middleware';
+export interface MethodConstructor {
+    new <Responder extends Responders, const Path extends string = string, const Drive extends Runtime = Runtime, const MethodKey extends MethodKeys = MethodKeys, const Schema extends AnySchema = AnySchema, const Middlewares extends readonly Middleware<Responder, Schema, string, Record<string, unknown>>[] = [], const Context = MiddlewareOutput<Middlewares>, const Instance extends AnyAsterflow = AnyAsterflow, const Handler extends MethodHandler<Path, Drive, Responder, Schema, Middlewares, Context, Instance, {}> = MethodHandler<Path, Drive, Responder, Schema, Middlewares, Context, Instance, {}>>(method: MethodKey, options: MethodConstructorOptions<MethodCallProps<Responder, Path, Drive, MethodKey, Schema, Middlewares, Context, Instance, {}, Handler>>): Method<MethodCallProps<Responder, Path, Drive, MethodKey, Schema, Middlewares, Context, Instance, {}, Handler>>;
+    /** Convenience constants for `new Method(Method.POST, {...})` / `Method.create(Method.POST)` - a plain `'post'` string works just as well. */
+    readonly ALL: 'all';
+    readonly GET: 'get';
+    readonly POST: 'post';
+    readonly PUT: 'put';
+    readonly DELETE: 'delete';
+    readonly OPTIONS: 'options';
+    readonly HEAD: 'head';
+    readonly PATCH: 'patch';
+    create: typeof MethodClass.create;
+    readonly prototype: MethodClass<any>;
+}
 /**
  * `handler`'s field type: a concrete `MethodHandler<...>` once finished, or
  * - while `Handler` is `undefined` (pending) - the terminal chain call
@@ -14,7 +28,7 @@ import type { Middleware } from './Middleware';
 export type MethodHandlerSlot<Props extends MethodProps> = Props['handler'] extends undefined ? <H extends MethodHandler<Props['path'], Props['drive'], Props['responder'], Props['schema'], Props['middlewares'], Props['context'], Props['instance'], Props['requestExt']>>(fn: H) => Method<MergeProps<Props, {
     handler: H;
 }>> : Props['handler'];
-export declare class Method<const Props extends MethodProps = DefaultMethodProps> {
+export declare class MethodClass<const Props extends MethodProps = DefaultMethodProps> {
     /** Convenience constants for `new Method(Method.POST, {...})` / `Method.create(Method.POST)` - a plain `'post'` string works just as well. */
     static readonly ALL: 'all';
     static readonly GET: 'get';
@@ -58,8 +72,8 @@ export declare class Method<const Props extends MethodProps = DefaultMethodProps
      * each its own.
      *
      * Plugins add their own chain method via `declare module '@asterflow/router'
-     * { interface Method<...> { theirMethod(...): Method<...> } }` plus a real
-     * `Method.prototype.theirMethod = ...` implementation calling `extend`.
+     * { interface MethodClass<...> { theirMethod(...): Method<...> } }` plus a real
+     * `MethodClass.prototype.theirMethod = ...` implementation calling `extend`.
      */
     static create<Responder extends Responders, const Path extends string = string, const Drive extends Runtime = Runtime, const MethodKey extends MethodKeys = MethodKeys, const Schema extends AnySchema = AnySchema, const Middlewares extends readonly Middleware<Responder, Schema, string, Record<string, unknown>>[] = []>(method: MethodKey, options?: MethodBuilderOptions<MethodCallProps<Responder, Path, Drive, MethodKey, Schema, Middlewares, MiddlewareOutput<Middlewares>, AnyAsterflow, {}, undefined>>): Method<MethodCallProps<Responder, Path, Drive, MethodKey, Schema, Middlewares, MiddlewareOutput<Middlewares>, AnyAsterflow, {}, undefined>>;
     /**
@@ -73,3 +87,5 @@ export declare class Method<const Props extends MethodProps = DefaultMethodProps
         handler: Props['handler'] extends undefined ? undefined : any;
     }>>;
 }
+export type Method<Props extends MethodProps = DefaultMethodProps> = MethodClass<Props>;
+export declare const Method: MethodConstructor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asterflow/router",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "Typed route and middleware definitions (Method, Router, Middleware) for AsterFlow applications.",
   "keywords": [
     "asterflow",
@@ -36,10 +36,10 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@asterflow/request": "^2.0.2",
-    "@asterflow/response": "^2.0.2",
+    "@asterflow/request": "^2.2.0",
+    "@asterflow/response": "^2.2.0",
     "@asterflow/url-parser": "^4.1.1",
-    "asterflow": "^2.0.2"
+    "asterflow": "^2.2.0"
   },
   "peerDependencies": {
     "@caeljs/tsh": "^1.1.3",