@innet/server 2.0.0-alpha.9 → 2.0.0-beta.2

package/plugins/main/api/api.js

@@ -2,63 +2,65 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var tslib = require('tslib');
 var innet = require('innet');
-var watchState = require('watch-state');
+var jsx = require('@innet/jsx');
 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 props = jsx.useProps();
+    const { children, exclude, include, prefix = process.env.INNET_API_PREFIX || '', title = '', version = process.env.INNET_API_VERSION || '0.0.0', ...rest } = props;
+    const info = { ...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(async () => {
+        var _a, _b, _c, _d, _e, _f;
+        const action = useAction.useAction();
+        if (!condition(action))
             return;
-        const action = new Action.Action(req, res);
+        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;
+            return null;
         }
-        if (!url.startsWith(prefix)) {
-            return;
-        }
-        for (const requestPlugin of requestPlugins) {
-            if (requestPlugin(action))
-                return;
-        }
-        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];
@@ -67,121 +69,118 @@ const api = () => {
             const [deep, currentEndpoint, params] = endpointQueue.shift();
             const key = splitPath[deep];
             if (deep + 1 === splitPath.length) {
-                function run(runEndpoint, params) {
+                async function run(runEndpoint, params) {
                     var _a, _b, _c, _d, _e;
-                    return tslib.__awaiter(this, void 0, void 0, function* () {
-                        const pathRules = (_a = runEndpoint.rules) === null || _a === void 0 ? void 0 : _a.path;
-                        const headerRules = (_b = runEndpoint.rules) === null || _b === void 0 ? void 0 : _b.header;
-                        const cookieRules = (_c = runEndpoint.rules) === null || _c === void 0 ? void 0 : _c.cookie;
-                        const searchRules = (_d = runEndpoint.rules) === null || _d === void 0 ? void 0 : _d.search;
-                        const bodyRules = (_e = runEndpoint.rules) === null || _e === void 0 ? void 0 : _e.body;
-                        if (pathRules) {
+                    const pathRules = (_a = runEndpoint.rules) === null || _a === void 0 ? void 0 : _a.path;
+                    const headerRules = (_b = runEndpoint.rules) === null || _b === void 0 ? void 0 : _b.header;
+                    const cookieRules = (_c = runEndpoint.rules) === null || _c === void 0 ? void 0 : _c.cookie;
+                    const searchRules = (_d = runEndpoint.rules) === null || _d === void 0 ? void 0 : _d.search;
+                    const bodyRules = (_e = runEndpoint.rules) === null || _e === void 0 ? void 0 : _e.body;
+                    if (pathRules) {
+                        try {
+                            Object.assign(params, pathRules(params, { in: 'path' }));
+                        }
+                        catch (_f) {
+                            return false;
+                        }
+                    }
+                    function checkActionRules(rules, key = 'search') {
+                        if (rules) {
                             try {
-                                Object.assign(params, pathRules(params, { in: 'path' }));
+                                action[key] = rules(action[key]);
                             }
-                            catch (_f) {
-                                return false;
-                            }
-                        }
-                        function checkActionRules(rules, key = 'search') {
-                            if (rules) {
-                                try {
-                                    action[key] = rules(action[key]);
+                            catch (e) {
+                                res.setHeader('Content-Type', 'application/json');
+                                if (e instanceof helpers.RulesError) {
+                                    res.statusCode = 400;
+                                    res.write(JSONString.JSONString({
+                                        data: {
+                                            ...e.data,
+                                            in: key,
+                                        },
+                                        error: 'requestValidation',
+                                    }));
+                                    res.end();
                                 }
-                                catch (e) {
-                                    res.setHeader('Content-Type', 'application/json');
-                                    if (e instanceof helpers.RulesError) {
-                                        res.statusCode = 400;
-                                        res.write(JSONString.JSONString({
-                                            error: 'requestValidation',
-                                            data: Object.assign(Object.assign({}, e.data), { in: key }),
-                                        }));
-                                        res.end();
-                                    }
-                                    else {
-                                        console.error(e);
-                                        res.statusCode = 500;
-                                        res.write(JSONString.JSONString({
-                                            error: 'unknown',
-                                            data: { in: key },
-                                        }));
-                                        res.end();
-                                    }
-                                    return true;
+                                else {
+                                    console.error(e);
+                                    res.statusCode = 500;
+                                    res.write(JSONString.JSONString({
+                                        data: { in: key },
+                                        error: 'unknown',
+                                    }));
+                                    res.end();
                                 }
+                                return true;
                             }
-                            return false;
                         }
-                        if (checkActionRules(headerRules, 'headers'))
-                            return true;
-                        if (checkActionRules(cookieRules, 'cookies'))
-                            return true;
-                        if (checkActionRules(searchRules, 'search'))
+                        return false;
+                    }
+                    if (checkActionRules(headerRules, 'headers'))
+                        return true;
+                    if (checkActionRules(cookieRules, 'cookies'))
+                        return true;
+                    if (checkActionRules(searchRules, 'search'))
+                        return true;
+                    if (bodyRules) {
+                        await action.parseBody();
+                        if (!action.body) {
+                            res.statusCode = 400;
+                            res.setHeader('Content-Type', 'application/json');
+                            res.write(JSONString.JSONString({
+                                error: 'requestBodyContentType',
+                            }));
+                            res.end();
                             return true;
-                        if (bodyRules) {
-                            yield action.parseBody();
-                            if (!action.body) {
-                                res.statusCode = 400;
-                                res.setHeader('Content-Type', 'application/json');
-                                res.write(JSONString.JSONString({
-                                    error: 'requestBodyContentType',
-                                }));
-                                res.end();
-                                return true;
-                            }
-                            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);
+                        if (checkActionRules(bodyRules, 'body'))
+                            return true;
+                    }
+                    useParams.paramsContext.set(actionHandler, params);
+                    for (const plugin of runEndpoint.plugins) {
+                        const result = await 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 (!await 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 (!(yield run(dynamicEndpoint, Object.assign(Object.assign({}, params), { [dynamicEndpoint.key.slice(1, -1)]: key }))))
+                        if (dynamicEndpoint.plugins) {
+                            if (!await run(dynamicEndpoint, { ...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) {
                 for (const dynamicEndpoint of currentEndpoint.dynamic) {
-                    endpointQueue.push([deep + 1, dynamicEndpoint, Object.assign(Object.assign({}, params), { [dynamicEndpoint.key.slice(1, -1)]: key })]);
+                    endpointQueue.push([deep + 1, dynamicEndpoint, { ...params, [dynamicEndpoint.key.slice(1, -1)]: key }]);
                 }
             }
         }
-        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 = await 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/body/body.d.ts

@@ -1,4 +1,5 @@
 import { type HandlerPlugin } from 'innet';
 export interface BodyProps {
+    children?: any;
 }
 export declare const body: HandlerPlugin;

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,10 +1,27 @@
 import { type HandlerPlugin } from 'innet';
 import { type EndpointsMethods } from '../../../types';
 export interface EndpointProps {
+    children?: any;
+    /**
+     * 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.
      * */
     method: EndpointsMethods;
+    /**
+     * `operationId` is an optional unique string used to identify an operation.
+     * If provided, these IDs must be unique among all operations described in your API.
+     * */
+    operationId?: string;
     /**
      * A relative path to an individual endpoint.
      * The property MUST begin with a forward slash (/).
@@ -13,25 +30,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

@@ -1,26 +1,25 @@
 import innet, { useNewHandler } from 'innet';
-import { useProps, useChildren } from '@innet/jsx';
+import { useProps } from '@innet/jsx';
 import '../../../hooks/index.es6.js';
 import '../../../utils/index.es6.js';
 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 props = useProps();
-    const { path, summary, description, deprecated, method, private: privateMode } = props;
-    const children = useChildren();
+    const { docs, endpoints, } = useApi();
+    const { children, deprecated, description, method, operationId, path, private: privateMode, summary, } = props;
     const { paths } = docs;
     if (!paths)
         throw Error('cannot find paths in docs');
     if (!paths[path]) {
         paths[path] = {};
     }
-    // @ts-expect-error: it's always an object
     if (paths[path][method]) {
         throw Error(`You cannot use the same endpoints ${method}:${path}`);
     }
@@ -28,6 +27,9 @@ const endpoint = () => {
     if (summary) {
         operation.summary = summary;
     }
+    if (operationId) {
+        operation.operationId = operationId;
+    }
     if (description) {
         operation.description = description;
     }
@@ -38,16 +40,16 @@ const endpoint = () => {
         operation.tags = [tag.name];
     }
     if (!privateMode) {
-        // @ts-expect-error: it's always an object
         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,17 +19,15 @@ var innet__default = /*#__PURE__*/_interopDefaultLegacy(innet);
 const endpoint = () => {
     const handler = innet.useNewHandler();
     const tag = useTag.useTag();
-    const { docs, endpoints } = useApi.useApi();
     const props = jsx.useProps();
-    const { path, summary, description, deprecated, method, private: privateMode } = props;
-    const children = jsx.useChildren();
+    const { docs, endpoints, } = useApi.useApi();
+    const { children, deprecated, description, method, operationId, path, private: privateMode, summary, } = props;
     const { paths } = docs;
     if (!paths)
         throw Error('cannot find paths in docs');
     if (!paths[path]) {
         paths[path] = {};
     }
-    // @ts-expect-error: it's always an object
     if (paths[path][method]) {
         throw Error(`You cannot use the same endpoints ${method}:${path}`);
     }
@@ -36,6 +35,9 @@ const endpoint = () => {
     if (summary) {
         operation.summary = summary;
     }
+    if (operationId) {
+        operation.operationId = operationId;
+    }
     if (description) {
         operation.description = description;
     }
@@ -46,16 +48,16 @@ const endpoint = () => {
         operation.tags = [tag.name];
     }
     if (!privateMode) {
-        // @ts-expect-error: it's always an object
         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/host/host.es6.js

@@ -16,7 +16,9 @@ const host = () => {
         target.servers = [];
     }
     const { servers } = operation || docs;
-    const server = Object.assign({}, props);
+    const server = {
+        ...props,
+    };
     // @ts-expect-error: FIXME
     servers.push(server);
     handler[hostContext.key] = { server };

package/plugins/main/host/host.js

@@ -24,7 +24,9 @@ const host = () => {
         target.servers = [];
     }
     const { servers } = operation || docs;
-    const server = Object.assign({}, props);
+    const server = {
+        ...props,
+    };
     // @ts-expect-error: FIXME
     servers.push(server);
     handler[useHost.hostContext.key] = { server };

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,18 @@
 import { type HandlerPlugin } from 'innet';
 import { type InParam } from '../../../types';
 export interface ParamProps {
+    children?: any;
+    /**
+     * 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 +26,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;