@innet/server 2.0.0-alpha.3 → 2.0.0-alpha.30

package/plugins/main/api/api.es6.js

@@ -1,52 +1,58 @@
 import { __rest, __awaiter } from 'tslib';
 import innet, { useNewHandler, useApp } from 'innet';
-import { onDestroy } from 'watch-state';
 import '../../../hooks/index.es6.js';
 import '../../../utils/index.es6.js';
 import '../../../utils/rules/index.es6.js';
-import { useServer } from '../../../hooks/useServer/useServer.es6.js';
+import { serverPlugins } from '../../../hooks/useServerPlugins/useServerPlugins.es6.js';
 import { apiContext } from '../../../hooks/useApi/useApi.es6.js';
-import { Action } from '../../../utils/action/Action.es6.js';
+import { useServerPlugin } from '../../../hooks/useServerPlugin/useServerPlugin.es6.js';
+import { useAction, actionContext } from '../../../hooks/useAction/useAction.es6.js';
 import { JSONString } from '../../../utils/JSONString/JSONString.es6.js';
 import { RulesError } from '../../../utils/rules/helpers.es6.js';
-import { responseContext } from '../../../hooks/useResponse/useResponse.es6.js';
-import { requestContext } from '../../../hooks/useRequest/useRequest.es6.js';
 import { paramsContext } from '../../../hooks/useParams/useParams.es6.js';
-import { actionContext } from '../../../hooks/useAction/useAction.es6.js';
 
 const api = () => {
-    var _a;
     const handler = useNewHandler();
-    const { props = {}, children } = useApp();
-    const { server } = useServer();
-    const { prefix = '', title = '' } = props, rest = __rest(props, ["prefix", "title"]);
-    const info = Object.assign(Object.assign({}, rest), { version: (_a = rest.version) !== null && _a !== void 0 ? _a : '0.0.0', title });
+    const { children, props = {}, } = useApp();
+    const { exclude, include, prefix = process.env.INNET_API_PREFIX || '', title = '', version = process.env.INNET_API_VERSION || '0.0.0' } = props, rest = __rest(props, ["exclude", "include", "prefix", "title", "version"]);
+    const info = Object.assign(Object.assign({}, rest), { title, version });
     const endpoints = {};
     const docs = {
-        openapi: '3.1.0',
         info,
+        openapi: '3.1.0',
         paths: {},
     };
-    const requestPlugins = new Set();
-    const context = { docs, endpoints, prefix, requestPlugins, refRules: {} };
+    const plugins = new Set();
+    const context = { docs, endpoints, prefix, refRules: {} };
+    const condition = (action) => {
+        const path = action.parsedUrl.path;
+        const url = path.endsWith('/') ? path.slice(0, -1) : path;
+        if (!url.startsWith(prefix) || (exclude === null || exclude === void 0 ? void 0 : exclude.test(url))) {
+            return false;
+        }
+        if (include && !include.test(url)) {
+            return false;
+        }
+        return true;
+    };
+    serverPlugins.set(handler, plugins);
     apiContext.set(handler, context);
-    const listener = (req, res) => __awaiter(void 0, void 0, void 0, function* () {
-        var _b, _c, _d, _e, _f, _g;
-        if (res.writableEnded)
+    useServerPlugin(() => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const action = useAction();
+        if (!condition(action))
             return;
-        const action = new Action(req);
+        const actionHandler = useNewHandler();
         const path = action.parsedUrl.path;
         const url = path.endsWith('/') ? path.slice(0, -1) : path;
+        const { req, res, } = action;
         if (url === (prefix || '')) {
             res.setHeader('Content-Type', 'application/json');
             res.write(JSONString(docs));
             res.end();
-            return;
-        }
-        if (!url.startsWith(prefix)) {
-            return;
+            return null;
         }
-        const method = ((_c = (_b = req.method) === null || _b === void 0 ? void 0 : _b.toLowerCase()) !== null && _c !== void 0 ? _c : 'get');
+        const method = ((_b = (_a = req.method) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : 'get');
         const rawSplitPath = url.slice(prefix.length).split('/').slice(1);
         const splitPath = rawSplitPath.at(-1) ? rawSplitPath : rawSplitPath.slice(0, -1);
         const endpoint = endpoints[method];
@@ -81,8 +87,8 @@ const api = () => {
                                     if (e instanceof RulesError) {
                                         res.statusCode = 400;
                                         res.write(JSONString({
-                                            error: 'requestValidation',
                                             data: Object.assign(Object.assign({}, e.data), { in: key }),
+                                            error: 'requestValidation',
                                         }));
                                         res.end();
                                     }
@@ -90,8 +96,8 @@ const api = () => {
                                         console.error(e);
                                         res.statusCode = 500;
                                         res.write(JSONString({
-                                            error: 'unknown',
                                             data: { in: key },
+                                            error: 'unknown',
                                         }));
                                         res.end();
                                     }
@@ -120,32 +126,34 @@ const api = () => {
                             if (checkActionRules(bodyRules, 'body'))
                                 return true;
                         }
-                        const newHandler = Object.create(runEndpoint.handler);
-                        responseContext.set(newHandler, res);
-                        requestContext.set(newHandler, req);
-                        paramsContext.set(newHandler, params);
-                        actionContext.set(newHandler, action);
-                        innet(runEndpoint.content, newHandler);
+                        paramsContext.set(actionHandler, params);
+                        for (const plugin of runEndpoint.plugins) {
+                            const result = yield plugin();
+                            if (result === undefined)
+                                continue;
+                            innet(result, actionHandler);
+                            return true;
+                        }
                         return true;
                     });
                 }
-                if ((_e = (_d = currentEndpoint.static) === null || _d === void 0 ? void 0 : _d[key]) === null || _e === void 0 ? void 0 : _e.content) {
-                    if (!(yield run((_f = currentEndpoint.static) === null || _f === void 0 ? void 0 : _f[key], params)))
+                if ((_d = (_c = currentEndpoint.static) === null || _c === void 0 ? void 0 : _c[key]) === null || _d === void 0 ? void 0 : _d.plugins) {
+                    if (!(yield run((_e = currentEndpoint.static) === null || _e === void 0 ? void 0 : _e[key], params)))
                         continue;
-                    return;
+                    return null;
                 }
                 if (currentEndpoint.dynamic) {
                     for (const dynamicEndpoint of currentEndpoint.dynamic) {
-                        if (dynamicEndpoint.content) {
+                        if (dynamicEndpoint.plugins) {
                             if (!(yield run(dynamicEndpoint, Object.assign(Object.assign({}, params), { [dynamicEndpoint.key.slice(1, -1)]: key }))))
                                 continue;
-                            return;
+                            return null;
                         }
                     }
                 }
                 break;
             }
-            if ((_g = currentEndpoint.static) === null || _g === void 0 ? void 0 : _g[key]) {
+            if ((_f = currentEndpoint.static) === null || _f === void 0 ? void 0 : _f[key]) {
                 endpointQueue.push([deep + 1, currentEndpoint.static[key], params]);
             }
             if (currentEndpoint.dynamic) {
@@ -154,26 +162,16 @@ const api = () => {
                 }
             }
         }
-        for (const requestPlugin of requestPlugins) {
-            if (requestPlugin(req, res))
-                return;
-        }
-        if (context.fallback) {
-            const newHandler = Object.create(context.fallback.handler);
-            responseContext.set(newHandler, res);
-            requestContext.set(newHandler, req);
+        for (const plugin of plugins) {
+            const result = yield plugin();
+            if (result === undefined)
+                continue;
+            const newHandler = Object.create(handler);
             actionContext.set(newHandler, action);
-            innet(context.fallback.children, newHandler);
-        }
-        else {
-            res.statusCode = 404;
-            res.end();
+            innet(result, newHandler);
+            return null;
         }
-    });
-    server.on('request', listener);
-    onDestroy(() => {
-        server.off('request', listener);
-    });
+    }));
     innet(children, handler);
 };
 

package/plugins/main/api/api.js

@@ -4,57 +4,63 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var tslib = require('tslib');
 var innet = require('innet');
-var watchState = require('watch-state');
 require('../../../hooks/index.js');
 require('../../../utils/index.js');
 require('../../../utils/rules/index.js');
-var useServer = require('../../../hooks/useServer/useServer.js');
+var useServerPlugins = require('../../../hooks/useServerPlugins/useServerPlugins.js');
 var useApi = require('../../../hooks/useApi/useApi.js');
-var Action = require('../../../utils/action/Action.js');
+var useServerPlugin = require('../../../hooks/useServerPlugin/useServerPlugin.js');
+var useAction = require('../../../hooks/useAction/useAction.js');
 var JSONString = require('../../../utils/JSONString/JSONString.js');
 var helpers = require('../../../utils/rules/helpers.js');
-var useResponse = require('../../../hooks/useResponse/useResponse.js');
-var useRequest = require('../../../hooks/useRequest/useRequest.js');
 var useParams = require('../../../hooks/useParams/useParams.js');
-var useAction = require('../../../hooks/useAction/useAction.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
 var innet__default = /*#__PURE__*/_interopDefaultLegacy(innet);
 
 const api = () => {
-    var _a;
     const handler = innet.useNewHandler();
-    const { props = {}, children } = innet.useApp();
-    const { server } = useServer.useServer();
-    const { prefix = '', title = '' } = props, rest = tslib.__rest(props, ["prefix", "title"]);
-    const info = Object.assign(Object.assign({}, rest), { version: (_a = rest.version) !== null && _a !== void 0 ? _a : '0.0.0', title });
+    const { children, props = {}, } = innet.useApp();
+    const { exclude, include, prefix = process.env.INNET_API_PREFIX || '', title = '', version = process.env.INNET_API_VERSION || '0.0.0' } = props, rest = tslib.__rest(props, ["exclude", "include", "prefix", "title", "version"]);
+    const info = Object.assign(Object.assign({}, rest), { title, version });
     const endpoints = {};
     const docs = {
-        openapi: '3.1.0',
         info,
+        openapi: '3.1.0',
         paths: {},
     };
-    const requestPlugins = new Set();
-    const context = { docs, endpoints, prefix, requestPlugins, refRules: {} };
+    const plugins = new Set();
+    const context = { docs, endpoints, prefix, refRules: {} };
+    const condition = (action) => {
+        const path = action.parsedUrl.path;
+        const url = path.endsWith('/') ? path.slice(0, -1) : path;
+        if (!url.startsWith(prefix) || (exclude === null || exclude === void 0 ? void 0 : exclude.test(url))) {
+            return false;
+        }
+        if (include && !include.test(url)) {
+            return false;
+        }
+        return true;
+    };
+    useServerPlugins.serverPlugins.set(handler, plugins);
     useApi.apiContext.set(handler, context);
-    const listener = (req, res) => tslib.__awaiter(void 0, void 0, void 0, function* () {
-        var _b, _c, _d, _e, _f, _g;
-        if (res.writableEnded)
+    useServerPlugin.useServerPlugin(() => tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const action = useAction.useAction();
+        if (!condition(action))
             return;
-        const action = new Action.Action(req);
+        const actionHandler = innet.useNewHandler();
         const path = action.parsedUrl.path;
         const url = path.endsWith('/') ? path.slice(0, -1) : path;
+        const { req, res, } = action;
         if (url === (prefix || '')) {
             res.setHeader('Content-Type', 'application/json');
             res.write(JSONString.JSONString(docs));
             res.end();
-            return;
-        }
-        if (!url.startsWith(prefix)) {
-            return;
+            return null;
         }
-        const method = ((_c = (_b = req.method) === null || _b === void 0 ? void 0 : _b.toLowerCase()) !== null && _c !== void 0 ? _c : 'get');
+        const method = ((_b = (_a = req.method) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : 'get');
         const rawSplitPath = url.slice(prefix.length).split('/').slice(1);
         const splitPath = rawSplitPath.at(-1) ? rawSplitPath : rawSplitPath.slice(0, -1);
         const endpoint = endpoints[method];
@@ -89,8 +95,8 @@ const api = () => {
                                     if (e instanceof helpers.RulesError) {
                                         res.statusCode = 400;
                                         res.write(JSONString.JSONString({
-                                            error: 'requestValidation',
                                             data: Object.assign(Object.assign({}, e.data), { in: key }),
+                                            error: 'requestValidation',
                                         }));
                                         res.end();
                                     }
@@ -98,8 +104,8 @@ const api = () => {
                                         console.error(e);
                                         res.statusCode = 500;
                                         res.write(JSONString.JSONString({
-                                            error: 'unknown',
                                             data: { in: key },
+                                            error: 'unknown',
                                         }));
                                         res.end();
                                     }
@@ -128,32 +134,34 @@ const api = () => {
                             if (checkActionRules(bodyRules, 'body'))
                                 return true;
                         }
-                        const newHandler = Object.create(runEndpoint.handler);
-                        useResponse.responseContext.set(newHandler, res);
-                        useRequest.requestContext.set(newHandler, req);
-                        useParams.paramsContext.set(newHandler, params);
-                        useAction.actionContext.set(newHandler, action);
-                        innet__default["default"](runEndpoint.content, newHandler);
+                        useParams.paramsContext.set(actionHandler, params);
+                        for (const plugin of runEndpoint.plugins) {
+                            const result = yield plugin();
+                            if (result === undefined)
+                                continue;
+                            innet__default["default"](result, actionHandler);
+                            return true;
+                        }
                         return true;
                     });
                 }
-                if ((_e = (_d = currentEndpoint.static) === null || _d === void 0 ? void 0 : _d[key]) === null || _e === void 0 ? void 0 : _e.content) {
-                    if (!(yield run((_f = currentEndpoint.static) === null || _f === void 0 ? void 0 : _f[key], params)))
+                if ((_d = (_c = currentEndpoint.static) === null || _c === void 0 ? void 0 : _c[key]) === null || _d === void 0 ? void 0 : _d.plugins) {
+                    if (!(yield run((_e = currentEndpoint.static) === null || _e === void 0 ? void 0 : _e[key], params)))
                         continue;
-                    return;
+                    return null;
                 }
                 if (currentEndpoint.dynamic) {
                     for (const dynamicEndpoint of currentEndpoint.dynamic) {
-                        if (dynamicEndpoint.content) {
+                        if (dynamicEndpoint.plugins) {
                             if (!(yield run(dynamicEndpoint, Object.assign(Object.assign({}, params), { [dynamicEndpoint.key.slice(1, -1)]: key }))))
                                 continue;
-                            return;
+                            return null;
                         }
                     }
                 }
                 break;
             }
-            if ((_g = currentEndpoint.static) === null || _g === void 0 ? void 0 : _g[key]) {
+            if ((_f = currentEndpoint.static) === null || _f === void 0 ? void 0 : _f[key]) {
                 endpointQueue.push([deep + 1, currentEndpoint.static[key], params]);
             }
             if (currentEndpoint.dynamic) {
@@ -162,26 +170,16 @@ const api = () => {
                 }
             }
         }
-        for (const requestPlugin of requestPlugins) {
-            if (requestPlugin(req, res))
-                return;
-        }
-        if (context.fallback) {
-            const newHandler = Object.create(context.fallback.handler);
-            useResponse.responseContext.set(newHandler, res);
-            useRequest.requestContext.set(newHandler, req);
+        for (const plugin of plugins) {
+            const result = yield plugin();
+            if (result === undefined)
+                continue;
+            const newHandler = Object.create(handler);
             useAction.actionContext.set(newHandler, action);
-            innet__default["default"](context.fallback.children, newHandler);
-        }
-        else {
-            res.statusCode = 404;
-            res.end();
+            innet__default["default"](result, newHandler);
+            return null;
         }
-    });
-    server.on('request', listener);
-    watchState.onDestroy(() => {
-        server.off('request', listener);
-    });
+    }));
     innet__default["default"](children, handler);
 };
 

package/plugins/main/contact/contact.d.ts

@@ -1,10 +1,10 @@
 import { type HandlerPlugin } from 'innet';
 export interface ContactProps {
+    /** The email address of the contact person/organization. This MUST be in the form of an email address. */
+    email?: string;
     /** The identifying name of the contact person/organization. */
     name?: string;
     /** The URL pointing to the contact information. This MUST be in the form of a URL. */
     url?: string;
-    /** The email address of the contact person/organization. This MUST be in the form of an email address. */
-    email?: string;
 }
 export declare const contact: HandlerPlugin;

package/plugins/main/endpoint/endpoint.d.ts

@@ -1,6 +1,17 @@
 import { type HandlerPlugin } from 'innet';
 import { type EndpointsMethods } from '../../../types';
 export interface EndpointProps {
+    /**
+     * Declares this operation to be deprecated.
+     * Consumers SHOULD refrain from usage of the declared operation.
+     * Default value is false.
+     * */
+    deprecated?: boolean;
+    /**
+     * An optional, string description, intended to apply to all operations in this path.
+     * [CommonMark syntax](https://spec.commonmark.org) MAY be used for rich text representation.
+     * */
+    description?: string;
     /**
      * A method of the endpoint.
      * */
@@ -13,25 +24,14 @@ export interface EndpointProps {
      * Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical.
      * */
     path: string;
-    /**
-     * An optional, string summary, intended to apply to all operations in this path.
-     * */
-    summary?: string;
-    /**
-     * An optional, string description, intended to apply to all operations in this path.
-     * [CommonMark syntax](https://spec.commonmark.org) MAY be used for rich text representation.
-     * */
-    description?: string;
-    /**
-     * Declares this operation to be deprecated.
-     * Consumers SHOULD refrain from usage of the declared operation.
-     * Default value is false.
-     * */
-    deprecated?: boolean;
     /**
      * Declares this operation to make an endpoint private.
      * That means the endpoint should not be described and will not be shown in the Open API documentation.
      * */
     private?: boolean;
+    /**
+     * An optional, string summary, intended to apply to all operations in this path.
+     * */
+    summary?: string;
 }
 export declare const endpoint: HandlerPlugin;

package/plugins/main/endpoint/endpoint.es6.js

@@ -6,13 +6,14 @@ import { useTag } from '../../../hooks/useTag/useTag.es6.js';
 import { useApi } from '../../../hooks/useApi/useApi.es6.js';
 import { getEndpoint } from '../../../utils/getEndpoint/getEndpoint.es6.js';
 import { endpointContext } from '../../../hooks/useEndpoint/useEndpoint.es6.js';
+import { serverPlugins } from '../../../hooks/useServerPlugins/useServerPlugins.es6.js';
 
 const endpoint = () => {
     const handler = useNewHandler();
     const tag = useTag();
-    const { docs, endpoints } = useApi();
+    const { docs, endpoints, } = useApi();
     const props = useProps();
-    const { path, summary, description, deprecated, method, private: privateMode } = props;
+    const { deprecated, description, method, path, private: privateMode, summary, } = props;
     const children = useChildren();
     const { paths } = docs;
     if (!paths)
@@ -42,12 +43,14 @@ const endpoint = () => {
         paths[path][method] = operation;
     }
     if (!endpoints[method]) {
-        endpoints[method] = { key: '' };
+        endpoints[method] = { key: '', plugins: new Set() };
     }
     // @ts-expect-error: it's always an object
     const endpoint = getEndpoint(path, endpoints[method]);
     // @ts-expect-error: it's always an object
-    endpointContext.set(handler, { operation, props, endpoint });
+    endpointContext.set(handler, { endpoint, operation, props });
+    // @ts-expect-error: it's always an object
+    serverPlugins.set(handler, endpoint.plugins);
     innet(children, handler);
 };
 

package/plugins/main/endpoint/endpoint.js

@@ -10,6 +10,7 @@ var useTag = require('../../../hooks/useTag/useTag.js');
 var useApi = require('../../../hooks/useApi/useApi.js');
 var getEndpoint = require('../../../utils/getEndpoint/getEndpoint.js');
 var useEndpoint = require('../../../hooks/useEndpoint/useEndpoint.js');
+var useServerPlugins = require('../../../hooks/useServerPlugins/useServerPlugins.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -18,9 +19,9 @@ var innet__default = /*#__PURE__*/_interopDefaultLegacy(innet);
 const endpoint = () => {
     const handler = innet.useNewHandler();
     const tag = useTag.useTag();
-    const { docs, endpoints } = useApi.useApi();
+    const { docs, endpoints, } = useApi.useApi();
     const props = jsx.useProps();
-    const { path, summary, description, deprecated, method, private: privateMode } = props;
+    const { deprecated, description, method, path, private: privateMode, summary, } = props;
     const children = jsx.useChildren();
     const { paths } = docs;
     if (!paths)
@@ -50,12 +51,14 @@ const endpoint = () => {
         paths[path][method] = operation;
     }
     if (!endpoints[method]) {
-        endpoints[method] = { key: '' };
+        endpoints[method] = { key: '', plugins: new Set() };
     }
     // @ts-expect-error: it's always an object
     const endpoint = getEndpoint.getEndpoint(path, endpoints[method]);
     // @ts-expect-error: it's always an object
-    useEndpoint.endpointContext.set(handler, { operation, props, endpoint });
+    useEndpoint.endpointContext.set(handler, { endpoint, operation, props });
+    // @ts-expect-error: it's always an object
+    useServerPlugins.serverPlugins.set(handler, endpoint.plugins);
     innet__default["default"](children, handler);
 };
 

package/plugins/main/host/host.d.ts

@@ -1,5 +1,10 @@
 import { type HandlerPlugin } from 'innet';
 export interface HostProps {
+    /**
+     * An optional string describing the host designated by the URL.
+     * [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation.
+     * */
+    description?: string;
     /**
      * A URL to the target host.
      * This URL supports Server Variables and MAY be relative,
@@ -7,10 +12,5 @@ export interface HostProps {
      * Variable substitutions will be made when a variable is named in {brackets}.
      * */
     url: string;
-    /**
-     * An optional string describing the host designated by the URL.
-     * [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text representation.
-     * */
-    description?: string;
 }
 export declare const host: HandlerPlugin;

package/plugins/main/index.d.ts

@@ -7,7 +7,7 @@ export * from './variable';
 export * from './tag';
 export * from './endpoint';
 export * from './response';
-export * from './request';
+export * from './return';
 export * from './param';
 export * from './body';
-export * from './fallback';
+export * from './preset';

package/plugins/main/index.es6.js

@@ -7,7 +7,7 @@ import './variable/index.es6.js';
 import './tag/index.es6.js';
 import './endpoint/index.es6.js';
 import './response/index.es6.js';
-import './request/index.es6.js';
+import './return/index.es6.js';
 import './param/index.es6.js';
 import './body/index.es6.js';
-import './fallback/index.es6.js';
+import './preset/index.es6.js';

package/plugins/main/index.js

@@ -9,8 +9,8 @@ require('./variable/index.js');
 require('./tag/index.js');
 require('./endpoint/index.js');
 require('./response/index.js');
-require('./request/index.js');
+require('./return/index.js');
 require('./param/index.js');
 require('./body/index.js');
-require('./fallback/index.js');
+require('./preset/index.js');
 

package/plugins/main/license/license.d.ts

@@ -1,16 +1,16 @@
 import { type HandlerPlugin } from 'innet';
 export interface LicenseProps {
-    /**
-     * The license name used for the API.
-     * @example: Apache 2.0
-     * */
-    name: string;
     /**
      * An [SPDX](https://spdx.org/spdx-specification-21-web-version#h.jxpfx0ykyb60) license expression for the API.
      * The `identifier` field is mutually exclusive of the `url` field.
      * @example: Apache-2.0
      * */
     identifier?: string;
+    /**
+     * The license name used for the API.
+     * @example: Apache 2.0
+     * */
+    name: string;
     /**
      * A URL to the license used for the API.
      * This MUST be in the form of a URL.

package/plugins/main/param/param.d.ts

@@ -1,6 +1,17 @@
 import { type HandlerPlugin } from 'innet';
 import { type InParam } from '../../../types';
 export interface ParamProps {
+    /**
+     * Specifies that a parameter is deprecated and SHOULD be transitioned out of usage.
+     * Default value is `false`.
+     * */
+    deprecated?: boolean;
+    /**
+     * A brief description of the parameter.
+     * This could contain examples of use.
+     * [CommonMark syntax](https://spec.commonmark.org) MAY be used for rich text representation.
+     * */
+    description?: string;
     /**
      * The location of the parameter.
      * Possible values are "query", "header", "path" or "cookie".
@@ -14,22 +25,11 @@ export interface ParamProps {
      * - For all other cases, the `name` corresponds to the parameter name used by the `in` property.
      * */
     name: string;
-    /**
-     * A brief description of the parameter.
-     * This could contain examples of use.
-     * [CommonMark syntax](https://spec.commonmark.org) MAY be used for rich text representation.
-     * */
-    description?: string;
     /**
      * Determines whether this parameter is mandatory.
      * If the parameter location is "path", this property is `true` and its value MUST be `true`.
      * Otherwise, the property MAY be included and its default value is `false`.
      * */
     required?: boolean;
-    /**
-     * Specifies that a parameter is deprecated and SHOULD be transitioned out of usage.
-     * Default value is `false`.
-     * */
-    deprecated?: boolean;
 }
 export declare const param: HandlerPlugin;

package/plugins/main/param/param.es6.js

@@ -13,14 +13,14 @@ import { required } from '../../../utils/rules/required/required.es6.js';
 import { oneOf } from '../../../utils/rules/oneOf/oneOf.es6.js';
 
 const inMap = {
-    query: 'search',
-    path: 'path',
     cookie: 'cookie',
     header: 'header',
+    path: 'path',
+    query: 'search',
 };
 const param = () => {
     var _a;
-    const { operation, endpoint } = useEndpoint();
+    const { endpoint, operation, } = useEndpoint();
     if (!operation.parameters) {
         operation.parameters = [];
     }