@extk/expressive 0.7.1 → 0.9.0

package/dist/index.d.mts

@@ -4,6 +4,7 @@ import * as express_serve_static_core from 'express-serve-static-core';
 import { RouteParameters } from 'express-serve-static-core';
 import { HelmetOptions } from 'helmet';
 import morgan from 'morgan';
+import { SwaggerUiOptions, SwaggerOptions } from 'swagger-ui-express';
 
 type ExpressRoute = string;
 type ExpressLocalsObj = Record<string, any>;
@@ -33,61 +34,85 @@ type Container = {
     alertHandler?: AlertHandler;
 };
 
+type Nullable<T extends string> = T | [T, 'null'] | ['null', T];
 type NumericConfigs = {
     minimum?: number;
     maximum?: number;
-    exclusiveMinimum?: boolean;
-    exclusiveMaximum?: boolean;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
     multipleOf?: number;
 };
 type NumberSchema = {
-    type: 'number';
+    type: Nullable<'number'>;
     format?: 'float' | 'double';
 } & NumericConfigs;
 type IntegerSchema = {
-    type: 'integer';
+    type: Nullable<'integer'>;
     format?: 'int32' | 'int64';
 } & NumericConfigs;
 type StringSchema = {
-    type: 'string';
+    type: Nullable<'string'>;
     minLength?: number;
     maxLength?: number;
     format?: 'date' | 'date-time' | 'password' | 'byte' | 'binary' | 'email' | 'uuid' | 'uri' | 'hostname' | 'ipv4' | 'ipv6' | OtherString;
     pattern?: string;
 };
 type BooleanSchema = {
-    type: 'boolean';
+    type: Nullable<'boolean'>;
+};
+type NullSchema = {
+    type: 'null';
 };
 type ArraySchema = {
-    type: 'array';
-    items: Partial<Schema>;
+    type: Nullable<'array'>;
+    items?: Schema;
     minItems?: number;
     maxItems?: number;
     uniqueItems?: boolean;
 };
 type ObjectSchema = {
-    type: 'object';
+    type: Nullable<'object'>;
     properties?: Record<string, Schema>;
     required?: string[];
     additionalProperties?: boolean | Schema;
     minProperties?: number;
     maxProperties?: number;
 };
-type BaseSchema = ({
-    nullable?: boolean;
-    enum?: unknown[];
+type Discriminator = {
+    propertyName: string;
+    mapping?: Record<string, string>;
+};
+type CommonSchemaProps = {
+    title?: string;
     description?: string;
+    example?: unknown;
     default?: unknown;
-} & (StringSchema | NumberSchema | IntegerSchema | BooleanSchema | ArraySchema | ObjectSchema)) | {
-    $ref: string;
+    enum?: unknown[];
+    const?: unknown;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    deprecated?: boolean;
 };
-type Schema = BaseSchema | {
+type BaseSchema = CommonSchemaProps & (StringSchema | NumberSchema | IntegerSchema | BooleanSchema | NullSchema | ArraySchema | ObjectSchema | {
+    $ref: string;
+});
+type Schema = // circular
+BaseSchema | (CommonSchemaProps & {
     allOf: Schema[];
-} | {
+    discriminator?: Discriminator;
+}) | (CommonSchemaProps & {
     anyOf: Schema[];
-} | {
+    discriminator?: Discriminator;
+}) | (CommonSchemaProps & {
     oneOf: Schema[];
-} | OtherUnknown;
+    discriminator?: Discriminator;
+}) | (CommonSchemaProps & {
+    not: Schema;
+}) | (CommonSchemaProps & {
+    if: Schema;
+    then?: Schema;
+    else?: Schema;
+}) | OtherUnknown;
 type Content = {
     description?: string;
     content?: Partial<Record<ContentType, {
@@ -95,7 +120,7 @@ type Content = {
     }>>;
 };
 type Param = {
-    in: 'path' | 'query' | 'headers';
+    in: 'path' | 'query' | 'header' | 'cookie';
     name: string;
     description: string;
     required: boolean;
@@ -107,6 +132,7 @@ type Servers = {
 }[];
 type PathItem = {
     summary?: string;
+    description?: string;
     requestBody?: Content;
     parameters?: Param[];
     servers?: Servers;
@@ -116,13 +142,14 @@ type PathItem = {
     deprecated?: boolean;
     security?: AuthMethod[];
 };
+/** { BearerAuth: [] } | { OAuth2: ['read', 'write'] } */
 type AuthMethod = Record<string, string[]>;
 type SecurityScheme = {
     type: 'http';
     scheme: 'basic' | 'bearer';
 } | {
     type: 'apiKey';
-    in: 'header';
+    in: 'header' | 'query' | 'cookie';
     name: string;
 } | {
     type: 'openIdConnect';
@@ -161,14 +188,59 @@ type SwaggerConfig = {
     security?: AuthMethod[];
 };
 
-type SwaggerOptions = {
-    path?: ExpressRoute;
-    config: SwaggerConfig;
+declare class SwaggerBuilder {
+    private swaggerDoc;
+    constructor(swaggerDoc: SwaggerConfig);
+    withInfo(info: SwaggerConfig['info']): this;
+    withServers(servers: Servers): this;
+    withSecuritySchemes(schemes: Record<string, SecurityScheme>): this;
+    withSchemas(schemas: Record<string, Schema>): this;
+    withDefaultSecurity(globalAuthMethods: AuthMethod[]): this;
+}
+declare function singleFileSchema(field?: string, required?: boolean): Content;
+declare function formDataSchema(schema: Schema): Content;
+declare function jsonSchema(schema: Schema): Content;
+declare function jsonSchemaRef(name: string): Content;
+declare function param(inP: Param['in'], id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare function pathParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare function queryParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare function headerParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare const SWG: {
+    param: typeof param;
+    pathParam: typeof pathParam;
+    queryParam: typeof queryParam;
+    headerParam: typeof headerParam;
+    formDataSchema: typeof formDataSchema;
+    jsonSchema: typeof jsonSchema;
+    jsonSchemaRef: typeof jsonSchemaRef;
+    singleFileSchema: typeof singleFileSchema;
+    security: (name: string) => AuthMethod;
+    securitySchemes: {
+        readonly BasicAuth: () => SecurityScheme;
+        readonly BearerAuth: () => SecurityScheme;
+        readonly ApiKeyAuth: (headerName: string) => SecurityScheme;
+        readonly OpenID: (openIdConnectUrl: string) => SecurityScheme;
+        readonly OAuth2: (authorizationUrl: string, tokenUrl: string, scopes: Record<string, string>) => SecurityScheme;
+    };
+};
+
+type SwaggerRef = {
+    doc: SwaggerConfig | null;
+};
+type ExpressiveSwaggerOptions = {
+    path: ExpressRoute;
+    uiOpts?: SwaggerUiOptions;
+    options?: SwaggerOptions;
+    customCss?: string;
+    customfavIcon?: string;
+    swaggerUrl?: string;
+    customSiteTitle?: string;
 };
 declare class ServerBuilder {
     private app;
     private container;
-    constructor(app: express__default.Express, container: Container);
+    private swaggerRef;
+    constructor(app: express__default.Express, container: Container, swaggerRef: SwaggerRef);
     build(): express__default.Express;
     withHelmet(options?: Readonly<HelmetOptions>): this;
     withQs(): this;
@@ -179,7 +251,7 @@ declare class ServerBuilder {
      * Helper function for fluent design
      */
     with(fn: (app: express__default.Express, container: Container) => void): this;
-    withSwagger(swagger: SwaggerOptions, ...handlers: ExpressHandler[]): this;
+    withSwagger(configure: (builder: SwaggerBuilder) => void, opts: ExpressiveSwaggerOptions, ...handlers: ExpressHandler[]): this;
 }
 
 declare class ApiError extends Error {
@@ -226,41 +298,6 @@ declare class UserUnauthorizedError extends ApiError {
     constructor(message?: string);
 }
 
-declare class SwaggerBuilder {
-    private swaggerDoc;
-    constructor(swaggerDoc: SwaggerConfig);
-    withInfo(info: SwaggerConfig['info']): this;
-    withServers(servers: Servers): this;
-    withSecuritySchemes(schemes: Record<string, SecurityScheme>): this;
-    withSchemas(schemas: Record<string, Schema>): this;
-    withDefaultSecurity(globalAuthMethods: AuthMethod[]): this;
-    get(): SwaggerConfig;
-}
-declare function formDataSchema(schema: Schema): Content;
-declare function jsonSchema(schema: Schema): Content;
-declare function jsonSchemaRef(name: string): Content;
-declare function param(inP: Param['in'], id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare function pathParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare function queryParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare function headerParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare const SWG: {
-    param: typeof param;
-    pathParam: typeof pathParam;
-    queryParam: typeof queryParam;
-    headerParam: typeof headerParam;
-    formDataSchema: typeof formDataSchema;
-    jsonSchema: typeof jsonSchema;
-    jsonSchemaRef: typeof jsonSchemaRef;
-    security: (name: string) => AuthMethod;
-    securitySchemes: {
-        readonly BasicAuth: () => SecurityScheme;
-        readonly BearerAuth: () => SecurityScheme;
-        readonly ApiKeyAuth: (headerName: string) => SecurityScheme;
-        readonly OpenID: (openIdConnectUrl: string) => SecurityScheme;
-        readonly OAuth2: (authorizationUrl: string, tokenUrl: string, scopes: Record<string, string>) => SecurityScheme;
-    };
-};
-
 declare function parsePositiveInteger<T>(v: T, defaultValue: number, max?: number): number;
 declare function parseIdOrFail(v: unknown): number;
 declare function slugify(text: string): string;
@@ -289,7 +326,6 @@ declare class ApiResponse<T = undefined> {
 }
 
 declare function bootstrap(container: Container): {
-    swaggerBuilder: () => SwaggerBuilder;
     silently: (fn: () => Promise<void> | void) => Promise<void>;
     getGlobalNotFoundMiddleware: (content?: string) => (_req: express.Request, res: express.Response, _next: express.NextFunction) => void;
     getApiNotFoundMiddleware: () => (req: express.Request, res: express.Response, _next: express.NextFunction) => void;
@@ -320,4 +356,4 @@ declare function bootstrap(container: Container): {
     };
 };
 
-export { type AlertHandler, ApiError, ApiErrorResponse, ApiResponse, type AuthMethod, BadRequestError, type Container, type Content, type ContentType, DuplicateError, type Env, type ExpressHandler, type ExpressLocalsObj, type ExpressRoute, FileTooBigError, ForbiddenError, type HttpMethod, InternalError, InvalidCredentialsError, InvalidFileTypeError, type Logger, NotFoundError, type OtherString, type OtherUnknown, type Pagination, type PaginationQuery, type Param, type PathItem, SWG, type Schema, SchemaValidationError, type SecurityScheme, type Servers, type SwaggerConfig, TokenExpiredError, TooManyRequestsError, UserUnauthorizedError, bootstrap, getEnvVar, getTmpDir, getTmpPath, isDev, isProd, parseDefaultPagination, parseIdOrFail, parsePositiveInteger, slugify };
+export { type AlertHandler, ApiError, ApiErrorResponse, ApiResponse, type AuthMethod, BadRequestError, type Container, type Content, type ContentType, DuplicateError, type Env, type ExpressHandler, type ExpressLocalsObj, type ExpressRoute, FileTooBigError, ForbiddenError, type HttpMethod, InternalError, InvalidCredentialsError, InvalidFileTypeError, type Logger, NotFoundError, type OtherString, type OtherUnknown, type Pagination, type PaginationQuery, type Param, type PathItem, SWG, type Schema, SchemaValidationError, type SecurityScheme, type Servers, SwaggerBuilder, type SwaggerConfig, TokenExpiredError, TooManyRequestsError, UserUnauthorizedError, bootstrap, getEnvVar, getTmpDir, getTmpPath, isDev, isProd, parseDefaultPagination, parseIdOrFail, parsePositiveInteger, slugify };

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import * as express_serve_static_core from 'express-serve-static-core';
 import { RouteParameters } from 'express-serve-static-core';
 import { HelmetOptions } from 'helmet';
 import morgan from 'morgan';
+import { SwaggerUiOptions, SwaggerOptions } from 'swagger-ui-express';
 
 type ExpressRoute = string;
 type ExpressLocalsObj = Record<string, any>;
@@ -33,61 +34,85 @@ type Container = {
     alertHandler?: AlertHandler;
 };
 
+type Nullable<T extends string> = T | [T, 'null'] | ['null', T];
 type NumericConfigs = {
     minimum?: number;
     maximum?: number;
-    exclusiveMinimum?: boolean;
-    exclusiveMaximum?: boolean;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
     multipleOf?: number;
 };
 type NumberSchema = {
-    type: 'number';
+    type: Nullable<'number'>;
     format?: 'float' | 'double';
 } & NumericConfigs;
 type IntegerSchema = {
-    type: 'integer';
+    type: Nullable<'integer'>;
     format?: 'int32' | 'int64';
 } & NumericConfigs;
 type StringSchema = {
-    type: 'string';
+    type: Nullable<'string'>;
     minLength?: number;
     maxLength?: number;
     format?: 'date' | 'date-time' | 'password' | 'byte' | 'binary' | 'email' | 'uuid' | 'uri' | 'hostname' | 'ipv4' | 'ipv6' | OtherString;
     pattern?: string;
 };
 type BooleanSchema = {
-    type: 'boolean';
+    type: Nullable<'boolean'>;
+};
+type NullSchema = {
+    type: 'null';
 };
 type ArraySchema = {
-    type: 'array';
-    items: Partial<Schema>;
+    type: Nullable<'array'>;
+    items?: Schema;
     minItems?: number;
     maxItems?: number;
     uniqueItems?: boolean;
 };
 type ObjectSchema = {
-    type: 'object';
+    type: Nullable<'object'>;
     properties?: Record<string, Schema>;
     required?: string[];
     additionalProperties?: boolean | Schema;
     minProperties?: number;
     maxProperties?: number;
 };
-type BaseSchema = ({
-    nullable?: boolean;
-    enum?: unknown[];
+type Discriminator = {
+    propertyName: string;
+    mapping?: Record<string, string>;
+};
+type CommonSchemaProps = {
+    title?: string;
     description?: string;
+    example?: unknown;
     default?: unknown;
-} & (StringSchema | NumberSchema | IntegerSchema | BooleanSchema | ArraySchema | ObjectSchema)) | {
-    $ref: string;
+    enum?: unknown[];
+    const?: unknown;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    deprecated?: boolean;
 };
-type Schema = BaseSchema | {
+type BaseSchema = CommonSchemaProps & (StringSchema | NumberSchema | IntegerSchema | BooleanSchema | NullSchema | ArraySchema | ObjectSchema | {
+    $ref: string;
+});
+type Schema = // circular
+BaseSchema | (CommonSchemaProps & {
     allOf: Schema[];
-} | {
+    discriminator?: Discriminator;
+}) | (CommonSchemaProps & {
     anyOf: Schema[];
-} | {
+    discriminator?: Discriminator;
+}) | (CommonSchemaProps & {
     oneOf: Schema[];
-} | OtherUnknown;
+    discriminator?: Discriminator;
+}) | (CommonSchemaProps & {
+    not: Schema;
+}) | (CommonSchemaProps & {
+    if: Schema;
+    then?: Schema;
+    else?: Schema;
+}) | OtherUnknown;
 type Content = {
     description?: string;
     content?: Partial<Record<ContentType, {
@@ -95,7 +120,7 @@ type Content = {
     }>>;
 };
 type Param = {
-    in: 'path' | 'query' | 'headers';
+    in: 'path' | 'query' | 'header' | 'cookie';
     name: string;
     description: string;
     required: boolean;
@@ -107,6 +132,7 @@ type Servers = {
 }[];
 type PathItem = {
     summary?: string;
+    description?: string;
     requestBody?: Content;
     parameters?: Param[];
     servers?: Servers;
@@ -116,13 +142,14 @@ type PathItem = {
     deprecated?: boolean;
     security?: AuthMethod[];
 };
+/** { BearerAuth: [] } | { OAuth2: ['read', 'write'] } */
 type AuthMethod = Record<string, string[]>;
 type SecurityScheme = {
     type: 'http';
     scheme: 'basic' | 'bearer';
 } | {
     type: 'apiKey';
-    in: 'header';
+    in: 'header' | 'query' | 'cookie';
     name: string;
 } | {
     type: 'openIdConnect';
@@ -161,14 +188,59 @@ type SwaggerConfig = {
     security?: AuthMethod[];
 };
 
-type SwaggerOptions = {
-    path?: ExpressRoute;
-    config: SwaggerConfig;
+declare class SwaggerBuilder {
+    private swaggerDoc;
+    constructor(swaggerDoc: SwaggerConfig);
+    withInfo(info: SwaggerConfig['info']): this;
+    withServers(servers: Servers): this;
+    withSecuritySchemes(schemes: Record<string, SecurityScheme>): this;
+    withSchemas(schemas: Record<string, Schema>): this;
+    withDefaultSecurity(globalAuthMethods: AuthMethod[]): this;
+}
+declare function singleFileSchema(field?: string, required?: boolean): Content;
+declare function formDataSchema(schema: Schema): Content;
+declare function jsonSchema(schema: Schema): Content;
+declare function jsonSchemaRef(name: string): Content;
+declare function param(inP: Param['in'], id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare function pathParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare function queryParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare function headerParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
+declare const SWG: {
+    param: typeof param;
+    pathParam: typeof pathParam;
+    queryParam: typeof queryParam;
+    headerParam: typeof headerParam;
+    formDataSchema: typeof formDataSchema;
+    jsonSchema: typeof jsonSchema;
+    jsonSchemaRef: typeof jsonSchemaRef;
+    singleFileSchema: typeof singleFileSchema;
+    security: (name: string) => AuthMethod;
+    securitySchemes: {
+        readonly BasicAuth: () => SecurityScheme;
+        readonly BearerAuth: () => SecurityScheme;
+        readonly ApiKeyAuth: (headerName: string) => SecurityScheme;
+        readonly OpenID: (openIdConnectUrl: string) => SecurityScheme;
+        readonly OAuth2: (authorizationUrl: string, tokenUrl: string, scopes: Record<string, string>) => SecurityScheme;
+    };
+};
+
+type SwaggerRef = {
+    doc: SwaggerConfig | null;
+};
+type ExpressiveSwaggerOptions = {
+    path: ExpressRoute;
+    uiOpts?: SwaggerUiOptions;
+    options?: SwaggerOptions;
+    customCss?: string;
+    customfavIcon?: string;
+    swaggerUrl?: string;
+    customSiteTitle?: string;
 };
 declare class ServerBuilder {
     private app;
     private container;
-    constructor(app: express__default.Express, container: Container);
+    private swaggerRef;
+    constructor(app: express__default.Express, container: Container, swaggerRef: SwaggerRef);
     build(): express__default.Express;
     withHelmet(options?: Readonly<HelmetOptions>): this;
     withQs(): this;
@@ -179,7 +251,7 @@ declare class ServerBuilder {
      * Helper function for fluent design
      */
     with(fn: (app: express__default.Express, container: Container) => void): this;
-    withSwagger(swagger: SwaggerOptions, ...handlers: ExpressHandler[]): this;
+    withSwagger(configure: (builder: SwaggerBuilder) => void, opts: ExpressiveSwaggerOptions, ...handlers: ExpressHandler[]): this;
 }
 
 declare class ApiError extends Error {
@@ -226,41 +298,6 @@ declare class UserUnauthorizedError extends ApiError {
     constructor(message?: string);
 }
 
-declare class SwaggerBuilder {
-    private swaggerDoc;
-    constructor(swaggerDoc: SwaggerConfig);
-    withInfo(info: SwaggerConfig['info']): this;
-    withServers(servers: Servers): this;
-    withSecuritySchemes(schemes: Record<string, SecurityScheme>): this;
-    withSchemas(schemas: Record<string, Schema>): this;
-    withDefaultSecurity(globalAuthMethods: AuthMethod[]): this;
-    get(): SwaggerConfig;
-}
-declare function formDataSchema(schema: Schema): Content;
-declare function jsonSchema(schema: Schema): Content;
-declare function jsonSchemaRef(name: string): Content;
-declare function param(inP: Param['in'], id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare function pathParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare function queryParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare function headerParam(id: string, schema: Schema, required?: boolean, description?: string, name?: string): Param;
-declare const SWG: {
-    param: typeof param;
-    pathParam: typeof pathParam;
-    queryParam: typeof queryParam;
-    headerParam: typeof headerParam;
-    formDataSchema: typeof formDataSchema;
-    jsonSchema: typeof jsonSchema;
-    jsonSchemaRef: typeof jsonSchemaRef;
-    security: (name: string) => AuthMethod;
-    securitySchemes: {
-        readonly BasicAuth: () => SecurityScheme;
-        readonly BearerAuth: () => SecurityScheme;
-        readonly ApiKeyAuth: (headerName: string) => SecurityScheme;
-        readonly OpenID: (openIdConnectUrl: string) => SecurityScheme;
-        readonly OAuth2: (authorizationUrl: string, tokenUrl: string, scopes: Record<string, string>) => SecurityScheme;
-    };
-};
-
 declare function parsePositiveInteger<T>(v: T, defaultValue: number, max?: number): number;
 declare function parseIdOrFail(v: unknown): number;
 declare function slugify(text: string): string;
@@ -289,7 +326,6 @@ declare class ApiResponse<T = undefined> {
 }
 
 declare function bootstrap(container: Container): {
-    swaggerBuilder: () => SwaggerBuilder;
     silently: (fn: () => Promise<void> | void) => Promise<void>;
     getGlobalNotFoundMiddleware: (content?: string) => (_req: express.Request, res: express.Response, _next: express.NextFunction) => void;
     getApiNotFoundMiddleware: () => (req: express.Request, res: express.Response, _next: express.NextFunction) => void;
@@ -320,4 +356,4 @@ declare function bootstrap(container: Container): {
     };
 };
 
-export { type AlertHandler, ApiError, ApiErrorResponse, ApiResponse, type AuthMethod, BadRequestError, type Container, type Content, type ContentType, DuplicateError, type Env, type ExpressHandler, type ExpressLocalsObj, type ExpressRoute, FileTooBigError, ForbiddenError, type HttpMethod, InternalError, InvalidCredentialsError, InvalidFileTypeError, type Logger, NotFoundError, type OtherString, type OtherUnknown, type Pagination, type PaginationQuery, type Param, type PathItem, SWG, type Schema, SchemaValidationError, type SecurityScheme, type Servers, type SwaggerConfig, TokenExpiredError, TooManyRequestsError, UserUnauthorizedError, bootstrap, getEnvVar, getTmpDir, getTmpPath, isDev, isProd, parseDefaultPagination, parseIdOrFail, parsePositiveInteger, slugify };
+export { type AlertHandler, ApiError, ApiErrorResponse, ApiResponse, type AuthMethod, BadRequestError, type Container, type Content, type ContentType, DuplicateError, type Env, type ExpressHandler, type ExpressLocalsObj, type ExpressRoute, FileTooBigError, ForbiddenError, type HttpMethod, InternalError, InvalidCredentialsError, InvalidFileTypeError, type Logger, NotFoundError, type OtherString, type OtherUnknown, type Pagination, type PaginationQuery, type Param, type PathItem, SWG, type Schema, SchemaValidationError, type SecurityScheme, type Servers, SwaggerBuilder, type SwaggerConfig, TokenExpiredError, TooManyRequestsError, UserUnauthorizedError, bootstrap, getEnvVar, getTmpDir, getTmpPath, isDev, isProd, parseDefaultPagination, parseIdOrFail, parsePositiveInteger, slugify };