@innet/server 2.0.0-alpha.23 → 2.0.0-alpha.25

package/handler/handler.d.ts

@@ -35,12 +35,12 @@ export declare const JSXPlugins: {
     redirect: import("innet").HandlerPlugin;
     response: import("innet").HandlerPlugin;
     return: import("innet").HandlerPlugin;
+    server: import("innet").HandlerPlugin;
     slot: typeof slot;
     slots: typeof slots;
-    server: import("innet").HandlerPlugin;
-    swagger: import("innet").HandlerPlugin;
     string: import("innet").HandlerPlugin;
     success: import("innet").HandlerPlugin;
+    swagger: import("innet").HandlerPlugin;
     tag: import("innet").HandlerPlugin;
     tuple: import("innet").HandlerPlugin;
     uuid: import("innet").HandlerPlugin;
@@ -84,14 +84,14 @@ declare global {
             protection: ProtectionProps;
             proxy: ProxyProps;
             redirect: RedirectProps;
-            return: ReturnProps;
             response: ResponseProps;
+            return: ReturnProps;
+            server: ServerProps;
             slot: SlotProps;
             slots: SlotsProps;
-            server: ServerProps;
-            swagger: SwaggerProps;
             string: StringProps;
             success: SuccessProps;
+            swagger: SwaggerProps;
             tag: TagProps;
             tuple: TupleProps;
             uuid: UuidProps;

package/handler/handler.es6.js

@@ -34,9 +34,9 @@ import { redirect } from '../plugins/request/redirect/redirect.es6.js';
 import { response } from '../plugins/main/response/response.es6.js';
 import { returnPlugin } from '../plugins/main/return/return.es6.js';
 import { server } from '../plugins/main/server/server.es6.js';
-import { swagger } from '../plugins/utils/swagger/swagger.es6.js';
 import { string } from '../plugins/schema/string/string.es6.js';
 import { success } from '../plugins/request/success/success.es6.js';
+import { swagger } from '../plugins/utils/swagger/swagger.es6.js';
 import { tag } from '../plugins/main/tag/tag.es6.js';
 import { tuple } from '../plugins/schema/tuple/tuple.es6.js';
 import { uuid } from '../plugins/schema/uuid/uuid.es6.js';
@@ -80,12 +80,12 @@ const JSXPlugins = {
     redirect,
     response,
     return: returnPlugin,
+    server,
     slot,
     slots,
-    server,
-    swagger,
     string,
     success,
+    swagger,
     tag,
     tuple,
     uuid,

package/handler/handler.js

@@ -38,9 +38,9 @@ var redirect = require('../plugins/request/redirect/redirect.js');
 var response = require('../plugins/main/response/response.js');
 var _return = require('../plugins/main/return/return.js');
 var server = require('../plugins/main/server/server.js');
-var swagger = require('../plugins/utils/swagger/swagger.js');
 var string = require('../plugins/schema/string/string.js');
 var success = require('../plugins/request/success/success.js');
+var swagger = require('../plugins/utils/swagger/swagger.js');
 var tag = require('../plugins/main/tag/tag.js');
 var tuple = require('../plugins/schema/tuple/tuple.js');
 var uuid = require('../plugins/schema/uuid/uuid.js');
@@ -84,12 +84,12 @@ const JSXPlugins = {
     redirect: redirect.redirect,
     response: response.response,
     return: _return.returnPlugin,
+    server: server.server,
     slot: jsx.slot,
     slots: jsx.slots,
-    server: server.server,
-    swagger: swagger.swagger,
     string: string.string,
     success: success.success,
+    swagger: swagger.swagger,
     tag: tag.tag,
     tuple: tuple.tuple,
     uuid: uuid.uuid,

package/hooks/index.d.ts

@@ -27,3 +27,4 @@ export * from './useServerPlugin';
 export * from './useClientIp';
 export * from './useServerPlugins';
 export * from './useObjectSchemaContext';
+export * from './useServerPort';

package/hooks/index.es6.js

@@ -27,3 +27,4 @@ import './useServerPlugin/index.es6.js';
 import './useClientIp/index.es6.js';
 import './useServerPlugins/index.es6.js';
 import './useObjectSchemaContext/index.es6.js';
+import './useServerPort/index.es6.js';

package/hooks/index.js

@@ -29,4 +29,5 @@ require('./useServerPlugin/index.js');
 require('./useClientIp/index.js');
 require('./useServerPlugins/index.js');
 require('./useObjectSchemaContext/index.js');
+require('./useServerPort/index.js');
 

package/hooks/useClientIp/useClientIp.d.ts

@@ -1 +1 @@
-export declare function useClientIp(): string | null;
+export declare function useClientIp(): null | string;

package/hooks/useEndpoint/useEndpoint.d.ts

@@ -2,9 +2,9 @@ import { Context } from '@innet/jsx';
 import { type EndpointProps } from '../../plugins';
 import type { Endpoint, OperationObject } from '../../types';
 export interface EndpointContext {
+    endpoint: Endpoint;
     operation: OperationObject;
     props: EndpointProps;
-    endpoint: Endpoint;
 }
 export declare const endpointContext: Context<EndpointContext, EndpointContext | undefined>;
 export declare function useEndpoint(): EndpointContext;

package/hooks/useSchemaType/useSchemaType.d.ts

@@ -1,5 +1,5 @@
 import { type ObjectType, type SchemaObject, type ValuesSchemaProps } from '../../types';
-export type SchemaType = ObjectType | 'any';
-type TypeMap<T extends SchemaType> = T extends 'number' | 'integer' ? number : T extends 'string' ? string : T extends 'object' ? object : T extends 'array' ? any[] : T extends 'boolean' ? boolean : T extends 'null' ? null : T extends 'any' ? any : unknown;
-export declare function useSchemaType<T extends SchemaType>(type: T, { values, ref, example, examples, ...options }?: undefined | ValuesSchemaProps<TypeMap<T>>): SchemaObject | undefined;
+export type SchemaType = 'any' | ObjectType;
+type TypeMap<T extends SchemaType> = T extends 'integer' | 'number' ? number : T extends 'string' ? string : T extends 'object' ? object : T extends 'array' ? any[] : T extends 'boolean' ? boolean : T extends 'null' ? null : T extends 'any' ? any : unknown;
+export declare function useSchemaType<T extends SchemaType>(type: T, { example, examples, ref, values, ...options }?: ValuesSchemaProps<TypeMap<T>> | undefined): SchemaObject | undefined;
 export {};

package/hooks/useSchemaType/useSchemaType.es6.js

@@ -6,7 +6,7 @@ import { useNewSchema } from '../useNewSchema/useNewSchema.es6.js';
 
 function useSchemaType(type, _a = {}) {
     var _b;
-    var { values, ref, example, examples } = _a, options = __rest(_a, ["values", "ref", "example", "examples"]);
+    var { example, examples, ref, values } = _a, options = __rest(_a, ["example", "examples", "ref", "values"]);
     if (ref) {
         const { docs } = useApi();
         if (!docs.components) {
@@ -21,11 +21,11 @@ function useSchemaType(type, _a = {}) {
         if ((_b = docs.components.schemas) === null || _b === void 0 ? void 0 : _b[ref]) {
             return;
         }
-        return (docs.components.schemas[ref] = Object.assign(Object.assign({}, options), { example,
-            examples, type: type === 'any' ? undefined : type, enum: values }));
+        return (docs.components.schemas[ref] = Object.assign(Object.assign({}, options), { enum: values, example,
+            examples, type: type === 'any' ? undefined : type }));
     }
-    return useNewSchema(Object.assign(Object.assign({}, options), { example,
-        examples, enum: values, type: type === 'any' ? undefined : type }));
+    return useNewSchema(Object.assign(Object.assign({}, options), { enum: values, example,
+        examples, type: type === 'any' ? undefined : type }));
 }
 
 export { useSchemaType };

package/hooks/useSchemaType/useSchemaType.js

@@ -10,7 +10,7 @@ var useNewSchema = require('../useNewSchema/useNewSchema.js');
 
 function useSchemaType(type, _a = {}) {
     var _b;
-    var { values, ref, example, examples } = _a, options = tslib.__rest(_a, ["values", "ref", "example", "examples"]);
+    var { example, examples, ref, values } = _a, options = tslib.__rest(_a, ["example", "examples", "ref", "values"]);
     if (ref) {
         const { docs } = useApi.useApi();
         if (!docs.components) {
@@ -25,11 +25,11 @@ function useSchemaType(type, _a = {}) {
         if ((_b = docs.components.schemas) === null || _b === void 0 ? void 0 : _b[ref]) {
             return;
         }
-        return (docs.components.schemas[ref] = Object.assign(Object.assign({}, options), { example,
-            examples, type: type === 'any' ? undefined : type, enum: values }));
+        return (docs.components.schemas[ref] = Object.assign(Object.assign({}, options), { enum: values, example,
+            examples, type: type === 'any' ? undefined : type }));
     }
-    return useNewSchema.useNewSchema(Object.assign(Object.assign({}, options), { example,
-        examples, enum: values, type: type === 'any' ? undefined : type }));
+    return useNewSchema.useNewSchema(Object.assign(Object.assign({}, options), { enum: values, example,
+        examples, type: type === 'any' ? undefined : type }));
 }
 
 exports.useSchemaType = useSchemaType;

package/hooks/useServer/useServer.d.ts

@@ -5,8 +5,8 @@ import { type Server as HttpServer } from 'http';
 import { type Server as HttpsServer } from 'https';
 export type ServerPlugin = () => any;
 export interface ServerContext {
-    server: HttpServer | HttpsServer;
     port: number;
+    server: HttpServer | HttpsServer;
 }
 export declare const serverContext: Context<ServerContext, ServerContext | undefined>;
 export declare function useServer(): ServerContext;

package/hooks/useServerPort/index.d.ts

@@ -0,0 +1 @@
+export * from './useServerPort';

package/hooks/useServerPort/index.es6.js

@@ -0,0 +1 @@
+export { serverPortContext, useServerPort } from './useServerPort.es6.js';

package/hooks/useServerPort/index.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var useServerPort = require('./useServerPort.js');
+
+
+
+exports.serverPortContext = useServerPort.serverPortContext;
+exports.useServerPort = useServerPort.useServerPort;

package/hooks/useServerPort/useServerPort.d.ts

@@ -0,0 +1,3 @@
+import { Context } from '@innet/jsx';
+export declare const serverPortContext: Context<number, number | undefined>;
+export declare function useServerPort(): number;

package/hooks/useServerPort/useServerPort.es6.js

@@ -0,0 +1,14 @@
+import { Context, useContext } from '@innet/jsx';
+import '../useThrow/index.es6.js';
+import { useThrow } from '../useThrow/useThrow.es6.js';
+
+const serverPortContext = new Context();
+function useServerPort() {
+    const port = useContext(serverPortContext);
+    if (!port) {
+        useThrow('{type} MUST BE in <server>');
+    }
+    return port;
+}
+
+export { serverPortContext, useServerPort };

package/hooks/useServerPort/useServerPort.js

@@ -0,0 +1,19 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var jsx = require('@innet/jsx');
+require('../useThrow/index.js');
+var useThrow = require('../useThrow/useThrow.js');
+
+const serverPortContext = new jsx.Context();
+function useServerPort() {
+    const port = jsx.useContext(serverPortContext);
+    if (!port) {
+        useThrow.useThrow('{type} MUST BE in <server>');
+    }
+    return port;
+}
+
+exports.serverPortContext = serverPortContext;
+exports.useServerPort = useServerPort;

package/index.es6.js

@@ -113,3 +113,4 @@ export { useServerPlugin } from './hooks/useServerPlugin/useServerPlugin.es6.js'
 export { useClientIp } from './hooks/useClientIp/useClientIp.es6.js';
 export { serverPlugins, useServerPlugins } from './hooks/useServerPlugins/useServerPlugins.es6.js';
 export { objectSchemaContext, useObjectSchemaContext } from './hooks/useObjectSchemaContext/useObjectSchemaContext.es6.js';
+export { serverPortContext, useServerPort } from './hooks/useServerPort/useServerPort.es6.js';

package/index.js

@@ -117,6 +117,7 @@ var useServerPlugin = require('./hooks/useServerPlugin/useServerPlugin.js');
 var useClientIp = require('./hooks/useClientIp/useClientIp.js');
 var useServerPlugins = require('./hooks/useServerPlugins/useServerPlugins.js');
 var useObjectSchemaContext = require('./hooks/useObjectSchemaContext/useObjectSchemaContext.js');
+var useServerPort = require('./hooks/useServerPort/useServerPort.js');
 
 
 
@@ -259,3 +260,5 @@ exports.serverPlugins = useServerPlugins.serverPlugins;
 exports.useServerPlugins = useServerPlugins.useServerPlugins;
 exports.objectSchemaContext = useObjectSchemaContext.objectSchemaContext;
 exports.useObjectSchemaContext = useObjectSchemaContext.useObjectSchemaContext;
+exports.serverPortContext = useServerPort.serverPortContext;
+exports.useServerPort = useServerPort.useServerPort;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@innet/server",
-  "version": "2.0.0-alpha.23",
+  "version": "2.0.0-alpha.25",
   "description": "Create server-side application with innet",
   "main": "index.js",
   "module": "index.es6.js",

package/plugins/main/api/api.d.ts

@@ -1,5 +1,15 @@
 import { type HandlerPlugin } from 'innet';
 export interface ApiProps {
+    /** A description of the API. [CommonMark syntax](https://spec.commonmark.or.org) MAY be used for rich text representation. */
+    description?: string;
+    exclude?: RegExp;
+    include?: RegExp;
+    /** URL path prefix scopes the API. */
+    prefix?: string;
+    /** A short summary of the API. */
+    summary?: string;
+    /** A URL to the Terms of Service for the API. This MUST be in the form of a URL. */
+    termsOfService?: string;
     /** The title of the API. */
     title?: string;
     /**
@@ -10,15 +20,5 @@ export interface ApiProps {
      * @default: 0.0.0
      * */
     version?: string;
-    /** A short summary of the API. */
-    summary?: string;
-    /** A description of the API. [CommonMark syntax](https://spec.commonmark.or.org) MAY be used for rich text representation. */
-    description?: string;
-    /** A URL to the Terms of Service for the API. This MUST be in the form of a URL. */
-    termsOfService?: string;
-    /** URL path prefix scopes the API. */
-    prefix?: string;
-    include?: RegExp;
-    exclude?: RegExp;
 }
 export declare const api: HandlerPlugin;

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

@@ -13,13 +13,13 @@ import { paramsContext } from '../../../hooks/useParams/useParams.es6.js';
 
 const api = () => {
     const handler = useNewHandler();
-    const { props = {}, children } = useApp();
-    const { prefix = '', title = '', include, exclude, version = process.env.INNET_API_VERSION || '0.0.0' } = props, rest = __rest(props, ["prefix", "title", "include", "exclude", "version"]);
-    const info = Object.assign(Object.assign({}, rest), { version, title });
+    const { children, props = {}, } = useApp();
+    const { exclude, include, 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 plugins = new Set();
@@ -45,7 +45,7 @@ const api = () => {
         const actionHandler = useNewHandler();
         const path = action.parsedUrl.path;
         const url = path.endsWith('/') ? path.slice(0, -1) : path;
-        const { req, res } = action;
+        const { req, res, } = action;
         if (url === (prefix || '')) {
             res.setHeader('Content-Type', 'application/json');
             res.write(JSONString(docs));
@@ -87,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();
                                     }
@@ -96,8 +96,8 @@ const api = () => {
                                         console.error(e);
                                         res.statusCode = 500;
                                         res.write(JSONString({
-                                            error: 'unknown',
                                             data: { in: key },
+                                            error: 'unknown',
                                         }));
                                         res.end();
                                     }

package/plugins/main/api/api.js

@@ -21,13 +21,13 @@ var innet__default = /*#__PURE__*/_interopDefaultLegacy(innet);
 
 const api = () => {
     const handler = innet.useNewHandler();
-    const { props = {}, children } = innet.useApp();
-    const { prefix = '', title = '', include, exclude, version = process.env.INNET_API_VERSION || '0.0.0' } = props, rest = tslib.__rest(props, ["prefix", "title", "include", "exclude", "version"]);
-    const info = Object.assign(Object.assign({}, rest), { version, title });
+    const { children, props = {}, } = innet.useApp();
+    const { exclude, include, 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 plugins = new Set();
@@ -53,7 +53,7 @@ const api = () => {
         const actionHandler = innet.useNewHandler();
         const path = action.parsedUrl.path;
         const url = path.endsWith('/') ? path.slice(0, -1) : path;
-        const { req, res } = action;
+        const { req, res, } = action;
         if (url === (prefix || '')) {
             res.setHeader('Content-Type', 'application/json');
             res.write(JSONString.JSONString(docs));
@@ -95,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();
                                     }
@@ -104,8 +104,8 @@ const api = () => {
                                         console.error(e);
                                         res.statusCode = 500;
                                         res.write(JSONString.JSONString({
-                                            error: 'unknown',
                                             data: { in: key },
+                                            error: 'unknown',
                                         }));
                                         res.end();
                                     }

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

@@ -11,9 +11,9 @@ import { serverPlugins } from '../../../hooks/useServerPlugins/useServerPlugins.
 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)
@@ -48,7 +48,7 @@ const endpoint = () => {
     // @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

@@ -19,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)
@@ -56,7 +56,7 @@ const endpoint = () => {
     // @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/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 = [];
     }

package/plugins/main/param/param.js

@@ -21,14 +21,14 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var innet__default = /*#__PURE__*/_interopDefaultLegacy(innet);
 
 const inMap = {
-    query: 'search',
-    path: 'path',
     cookie: 'cookie',
     header: 'header',
+    path: 'path',
+    query: 'search',
 };
 const param = () => {
     var _a;
-    const { operation, endpoint } = useEndpoint.useEndpoint();
+    const { endpoint, operation, } = useEndpoint.useEndpoint();
     if (!operation.parameters) {
         operation.parameters = [];
     }