@nestia/sdk 4.2.0 → 4.3.0-dev.20241215-2

package/src/structures/IReflectOperationError.ts

@@ -1,26 +1,26 @@
-import { IComparable } from "tstl";
-
-import { IOperationMetadata } from "../transformers/IOperationMetadata";
-
-export interface IReflectOperationError {
-  file: string;
-  class: string;
-  function: string | null;
-  from: string | null;
-  contents: Array<string | IOperationMetadata.IError>;
-}
-export namespace IReflectOperationError {
-  export class Key implements Pick<IComparable<Key>, "less"> {
-    public constructor(public readonly error: IReflectOperationError) {}
-
-    public less(obj: Key): boolean {
-      if (this.error.file !== obj.error.file)
-        return this.error.file < obj.error.file;
-      else if (this.error.class !== obj.error.class)
-        return this.error.class < obj.error.class;
-      else if (this.error.function !== obj.error.function)
-        return (this.error.function ?? "") < (obj.error.function ?? "");
-      return (this.error.from ?? "") < (obj.error.from ?? "");
-    }
-  }
-}
+import { IComparable } from "tstl";
+
+import { IOperationMetadata } from "../transformers/IOperationMetadata";
+
+export interface IReflectOperationError {
+  file: string;
+  class: string;
+  function: string | null;
+  from: string | null;
+  contents: Array<string | IOperationMetadata.IError>;
+}
+export namespace IReflectOperationError {
+  export class Key implements Pick<IComparable<Key>, "less"> {
+    public constructor(public readonly error: IReflectOperationError) {}
+
+    public less(obj: Key): boolean {
+      if (this.error.file !== obj.error.file)
+        return this.error.file < obj.error.file;
+      else if (this.error.class !== obj.error.class)
+        return this.error.class < obj.error.class;
+      else if (this.error.function !== obj.error.function)
+        return (this.error.function ?? "") < (obj.error.function ?? "");
+      return (this.error.from ?? "") < (obj.error.from ?? "");
+    }
+  }
+}

package/src/structures/IReflectType.ts

@@ -1,4 +1,4 @@
-export interface IReflectType {
-  name: string;
-  typeArguments?: IReflectType[];
-}
+export interface IReflectType {
+  name: string;
+  typeArguments?: IReflectType[];
+}

package/src/structures/IReflectTypeImport.ts

@@ -1,4 +1,4 @@
-export interface IReflectTypeImport {
-  file: string;
-  instances: string[];
-}
+export interface IReflectTypeImport {
+  file: string;
+  instances: string[];
+}

package/src/structures/IReflectWebSocketOperation.ts

@@ -1,17 +1,17 @@
-import { VERSION_NEUTRAL } from "@nestjs/common";
-import ts from "typescript";
-
-import { IReflectTypeImport } from "./IReflectTypeImport";
-import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
-
-export interface IReflectWebSocketOperation {
-  protocol: "websocket";
-  name: string;
-  paths: string[];
-  function: Function;
-  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-  parameters: IReflectWebSocketOperationParameter[];
-  imports: IReflectTypeImport[];
-  description: string | null;
-  jsDocTags: ts.JSDocTagInfo[];
-}
+import { VERSION_NEUTRAL } from "@nestjs/common";
+import ts from "typescript";
+
+import { IReflectTypeImport } from "./IReflectTypeImport";
+import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
+
+export interface IReflectWebSocketOperation {
+  protocol: "websocket";
+  name: string;
+  paths: string[];
+  function: Function;
+  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
+  parameters: IReflectWebSocketOperationParameter[];
+  imports: IReflectTypeImport[];
+  description: string | null;
+  jsDocTags: ts.JSDocTagInfo[];
+}

package/src/structures/IReflectWebSocketOperationParameter.ts

@@ -1,38 +1,38 @@
-import { IJsDocTagInfo } from "typia";
-
-import { IReflectType } from "./IReflectType";
-import { IReflectTypeImport } from "./IReflectTypeImport";
-
-export type IReflectWebSocketOperationParameter =
-  | IReflectWebSocketOperationParameter.IAcceptor
-  | IReflectWebSocketOperationParameter.IDriver
-  | IReflectWebSocketOperationParameter.IHeader
-  | IReflectWebSocketOperationParameter.IParam
-  | IReflectWebSocketOperationParameter.IQuery;
-export namespace IReflectWebSocketOperationParameter {
-  export type IAcceptor = IBase<"acceptor">;
-  export type IDriver = IBase<"driver">;
-  export type IHeader = IBase<"header">;
-  export type IQuery = IBase<"query">;
-  export interface IParam extends IBase<"param"> {
-    field: string;
-  }
-  interface IBase<Category extends string> {
-    category: Category;
-    name: string;
-    index: number;
-    type: IReflectType;
-    imports: IReflectTypeImport[];
-    description: string | null;
-    jsDocTags: IJsDocTagInfo[];
-  }
-
-  /**
-   * @internal
-   */
-  export interface IPreconfigured {
-    category: "acceptor" | "driver" | "header" | "param" | "query";
-    index: number;
-    field?: string;
-  }
-}
+import { IJsDocTagInfo } from "typia";
+
+import { IReflectType } from "./IReflectType";
+import { IReflectTypeImport } from "./IReflectTypeImport";
+
+export type IReflectWebSocketOperationParameter =
+  | IReflectWebSocketOperationParameter.IAcceptor
+  | IReflectWebSocketOperationParameter.IDriver
+  | IReflectWebSocketOperationParameter.IHeader
+  | IReflectWebSocketOperationParameter.IParam
+  | IReflectWebSocketOperationParameter.IQuery;
+export namespace IReflectWebSocketOperationParameter {
+  export type IAcceptor = IBase<"acceptor">;
+  export type IDriver = IBase<"driver">;
+  export type IHeader = IBase<"header">;
+  export type IQuery = IBase<"query">;
+  export interface IParam extends IBase<"param"> {
+    field: string;
+  }
+  interface IBase<Category extends string> {
+    category: Category;
+    name: string;
+    index: number;
+    type: IReflectType;
+    imports: IReflectTypeImport[];
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+  }
+
+  /**
+   * @internal
+   */
+  export interface IPreconfigured {
+    category: "acceptor" | "driver" | "header" | "param" | "query";
+    index: number;
+    field?: string;
+  }
+}

package/src/structures/ITypedApplication.ts

@@ -1,11 +1,11 @@
-import { IMetadataDictionary } from "typia/lib/schemas/metadata/IMetadataDictionary";
-
-import { INestiaProject } from "./INestiaProject";
-import { ITypedHttpRoute } from "./ITypedHttpRoute";
-import { ITypedWebSocketRoute } from "./ITypedWebSocketRoute";
-
-export interface ITypedApplication {
-  project: INestiaProject;
-  collection: IMetadataDictionary;
-  routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>;
-}
+import { IMetadataDictionary } from "typia/lib/schemas/metadata/IMetadataDictionary";
+
+import { INestiaProject } from "./INestiaProject";
+import { ITypedHttpRoute } from "./ITypedHttpRoute";
+import { ITypedWebSocketRoute } from "./ITypedWebSocketRoute";
+
+export interface ITypedApplication {
+  project: INestiaProject;
+  collection: IMetadataDictionary;
+  routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>;
+}

package/src/structures/ITypedHttpRoute.ts

@@ -1,30 +1,30 @@
-import { IJsDocTagInfo } from "typia";
-
-import { IReflectController } from "./IReflectController";
-import { IReflectTypeImport } from "./IReflectTypeImport";
-import { ITypedHttpRouteException } from "./ITypedHttpRouteException";
-import { ITypedHttpRouteParameter } from "./ITypedHttpRouteParameter";
-import { ITypedHttpRouteSuccess } from "./ITypedHttpRouteSuccess";
-
-export interface ITypedHttpRoute {
-  protocol: "http";
-  function: Function;
-  controller: IReflectController;
-  name: string;
-  method: string;
-  path: string;
-  accessors: string[];
-  parameters: ITypedHttpRouteParameter[];
-  success: ITypedHttpRouteSuccess;
-  exceptions: Record<
-    number | "2XX" | "3XX" | "4XX" | "5XX",
-    ITypedHttpRouteException
-  >;
-  security: Record<string, string[]>[];
-  tags: string[];
-  imports: IReflectTypeImport[];
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-  operationId: string | undefined;
-  extensions?: Record<string, any>;
-}
+import { IJsDocTagInfo } from "typia";
+
+import { IReflectController } from "./IReflectController";
+import { IReflectTypeImport } from "./IReflectTypeImport";
+import { ITypedHttpRouteException } from "./ITypedHttpRouteException";
+import { ITypedHttpRouteParameter } from "./ITypedHttpRouteParameter";
+import { ITypedHttpRouteSuccess } from "./ITypedHttpRouteSuccess";
+
+export interface ITypedHttpRoute {
+  protocol: "http";
+  function: Function;
+  controller: IReflectController;
+  name: string;
+  method: string;
+  path: string;
+  accessors: string[];
+  parameters: ITypedHttpRouteParameter[];
+  success: ITypedHttpRouteSuccess;
+  exceptions: Record<
+    number | "2XX" | "3XX" | "4XX" | "5XX",
+    ITypedHttpRouteException
+  >;
+  security: Record<string, string[]>[];
+  tags: string[];
+  imports: IReflectTypeImport[];
+  description: string | null;
+  jsDocTags: IJsDocTagInfo[];
+  operationId: string | undefined;
+  extensions?: Record<string, any>;
+}

package/src/structures/ITypedHttpRouteException.ts

@@ -1,15 +1,15 @@
-import { Metadata } from "typia/lib/schemas/metadata/Metadata";
-
-import { IReflectType } from "./IReflectType";
-
-export interface ITypedHttpRouteException {
-  // BASIC PROPERTIES
-  status: number | "2XX" | "3XX" | "4XX" | "5XX";
-  description: string | null;
-  example: any;
-  examples: Record<string, any>;
-
-  // REFLECTED PROPERTIES
-  type: IReflectType;
-  metadata: Metadata;
-}
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+
+import { IReflectType } from "./IReflectType";
+
+export interface ITypedHttpRouteException {
+  // BASIC PROPERTIES
+  status: number | "2XX" | "3XX" | "4XX" | "5XX";
+  description: string | null;
+  example: any;
+  examples: Record<string, any>;
+
+  // REFLECTED PROPERTIES
+  type: IReflectType;
+  metadata: Metadata;
+}

package/src/structures/ITypedHttpRouteParameter.ts

@@ -1,41 +1,41 @@
-import { IJsDocTagInfo } from "typia";
-import { Metadata } from "typia/lib/schemas/metadata/Metadata";
-
-import { IReflectType } from "./IReflectType";
-
-export type ITypedHttpRouteParameter =
-  | ITypedHttpRouteParameter.IBody
-  | ITypedHttpRouteParameter.IHeaders
-  | ITypedHttpRouteParameter.IParam
-  | ITypedHttpRouteParameter.IQuery;
-export namespace ITypedHttpRouteParameter {
-  export interface IBody extends IBase<"body"> {
-    contentType:
-      | "application/json"
-      | "application/x-www-form-urlencoded"
-      | "multipart/form-data"
-      | "text/plain";
-    encrypted: boolean;
-  }
-  export interface IHeaders extends IBase<"headers"> {
-    field: string | null;
-  }
-  export interface IParam extends IBase<"param"> {
-    field: string;
-  }
-  export interface IQuery extends IBase<"query"> {
-    field: string | null;
-  }
-
-  interface IBase<Category extends string> {
-    category: Category;
-    name: string;
-    index: number;
-    type: IReflectType;
-    metadata: Metadata;
-    example?: any;
-    examples?: Record<string, any>;
-    description: string | null;
-    jsDocTags: IJsDocTagInfo[];
-  }
-}
+import { IJsDocTagInfo } from "typia";
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+
+import { IReflectType } from "./IReflectType";
+
+export type ITypedHttpRouteParameter =
+  | ITypedHttpRouteParameter.IBody
+  | ITypedHttpRouteParameter.IHeaders
+  | ITypedHttpRouteParameter.IParam
+  | ITypedHttpRouteParameter.IQuery;
+export namespace ITypedHttpRouteParameter {
+  export interface IBody extends IBase<"body"> {
+    contentType:
+      | "application/json"
+      | "application/x-www-form-urlencoded"
+      | "multipart/form-data"
+      | "text/plain";
+    encrypted: boolean;
+  }
+  export interface IHeaders extends IBase<"headers"> {
+    field: string | null;
+  }
+  export interface IParam extends IBase<"param"> {
+    field: string;
+  }
+  export interface IQuery extends IBase<"query"> {
+    field: string | null;
+  }
+
+  interface IBase<Category extends string> {
+    category: Category;
+    name: string;
+    index: number;
+    type: IReflectType;
+    metadata: Metadata;
+    example?: any;
+    examples?: Record<string, any>;
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+  }
+}

package/src/structures/ITypedHttpRouteSuccess.ts

@@ -1,22 +1,22 @@
-import { Metadata } from "typia/lib/schemas/metadata/Metadata";
-
-import { IReflectType } from "./IReflectType";
-
-export interface ITypedHttpRouteSuccess {
-  type: IReflectType;
-  status: number | null;
-  contentType:
-    | "application/json"
-    | "text/plain"
-    | "application/x-www-form-urlencoded"
-    | "application/json"
-    | null;
-  encrypted: boolean;
-  metadata: Metadata;
-  example?: any;
-  examples?: Record<string, any>;
-  setHeaders: Array<
-    | { type: "setter"; source: string; target?: string }
-    | { type: "assigner"; source: string }
-  >;
-}
+import { Metadata } from "typia/lib/schemas/metadata/Metadata";
+
+import { IReflectType } from "./IReflectType";
+
+export interface ITypedHttpRouteSuccess {
+  type: IReflectType;
+  status: number | null;
+  contentType:
+    | "application/json"
+    | "text/plain"
+    | "application/x-www-form-urlencoded"
+    | "application/json"
+    | null;
+  encrypted: boolean;
+  metadata: Metadata;
+  example?: any;
+  examples?: Record<string, any>;
+  setHeaders: Array<
+    | { type: "setter"; source: string; target?: string }
+    | { type: "assigner"; source: string }
+  >;
+}

package/src/structures/ITypedWebSocketRoute.ts

@@ -1,20 +1,20 @@
-import { VERSION_NEUTRAL } from "@nestjs/common";
-import ts from "typescript";
-
-import { IReflectController } from "./IReflectController";
-import { IReflectTypeImport } from "./IReflectTypeImport";
-import { ITypedWebSocketRouteParameter } from "./ITypedWebSocketRouteParameter";
-
-export interface ITypedWebSocketRoute {
-  protocol: "websocket";
-  controller: IReflectController;
-  name: string;
-  path: string;
-  accessors: string[];
-  function: Function;
-  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-  parameters: ITypedWebSocketRouteParameter[];
-  imports: IReflectTypeImport[];
-  description: string | null;
-  jsDocTags: ts.JSDocTagInfo[];
-}
+import { VERSION_NEUTRAL } from "@nestjs/common";
+import ts from "typescript";
+
+import { IReflectController } from "./IReflectController";
+import { IReflectTypeImport } from "./IReflectTypeImport";
+import { ITypedWebSocketRouteParameter } from "./ITypedWebSocketRouteParameter";
+
+export interface ITypedWebSocketRoute {
+  protocol: "websocket";
+  controller: IReflectController;
+  name: string;
+  path: string;
+  accessors: string[];
+  function: Function;
+  versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
+  parameters: ITypedWebSocketRouteParameter[];
+  imports: IReflectTypeImport[];
+  description: string | null;
+  jsDocTags: ts.JSDocTagInfo[];
+}

package/src/structures/ITypedWebSocketRouteParameter.ts

@@ -1,3 +1,3 @@
-import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
-
-export import ITypedWebSocketRouteParameter = IReflectWebSocketOperationParameter;
+import { IReflectWebSocketOperationParameter } from "./IReflectWebSocketOperationParameter";
+
+export import ITypedWebSocketRouteParameter = IReflectWebSocketOperationParameter;

package/src/structures/MethodType.ts

@@ -1,5 +1,5 @@
-export type MethodType = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-
-export namespace MethodType {
-  export const VALUES: MethodType[] = ["GET", "POST", "PUT", "PATCH", "DELETE"];
-}
+export type MethodType = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+
+export namespace MethodType {
+  export const VALUES: MethodType[] = ["GET", "POST", "PUT", "PATCH", "DELETE"];
+}

package/src/structures/ParamCategory.ts

@@ -1 +1 @@
-export type ParamCategory = "param" | "query" | "body" | "rawBody" | "headers";
+export type ParamCategory = "param" | "query" | "body" | "rawBody" | "headers";

package/src/structures/TypeEntry.ts

@@ -1,22 +1,22 @@
-import { hash } from "tstl";
-import ts from "typescript";
-
-export class TypeEntry {
-  public constructor(
-    public readonly type: ts.Type,
-    public readonly nullable: boolean,
-    public readonly required: boolean,
-  ) {}
-
-  public equals(obj: TypeEntry): boolean {
-    return (
-      this.type === obj.type &&
-      this.nullable === obj.nullable &&
-      this.required === obj.required
-    );
-  }
-
-  public hashCode(): number {
-    return hash(this.type, this.nullable, this.required);
-  }
-}
+import { hash } from "tstl";
+import ts from "typescript";
+
+export class TypeEntry {
+  public constructor(
+    public readonly type: ts.Type,
+    public readonly nullable: boolean,
+    public readonly required: boolean,
+  ) {}
+
+  public equals(obj: TypeEntry): boolean {
+    return (
+      this.type === obj.type &&
+      this.nullable === obj.nullable &&
+      this.required === obj.required
+    );
+  }
+
+  public hashCode(): number {
+    return hash(this.type, this.nullable, this.required);
+  }
+}

package/src/transform.ts

@@ -1,9 +1,9 @@
-import ts from "typescript";
-
-import { SdkOperationTransformer } from "./transformers/SdkOperationTransformer";
-
-export const transform = (
-  program: ts.Program,
-): ts.TransformerFactory<ts.SourceFile> =>
-  SdkOperationTransformer.iterateFile(program.getTypeChecker());
-export default transform;
+import ts from "typescript";
+
+import { SdkOperationTransformer } from "./transformers/SdkOperationTransformer";
+
+export const transform = (
+  program: ts.Program,
+): ts.TransformerFactory<ts.SourceFile> =>
+  SdkOperationTransformer.iterateFile(program.getTypeChecker());
+export default transform;

package/src/transformers/IOperationMetadata.ts

@@ -1,44 +1,44 @@
-import { IJsDocTagInfo } from "typia";
-import { IMetadata } from "typia/lib/schemas/metadata/IMetadata";
-import { IMetadataComponents } from "typia/lib/schemas/metadata/IMetadataComponents";
-import { ValidationPipe } from "typia/lib/typings/ValidationPipe";
-
-import { IReflectType } from "../structures/IReflectType";
-import { IReflectTypeImport } from "../structures/IReflectTypeImport";
-
-export interface IOperationMetadata {
-  parameters: IOperationMetadata.IParameter[];
-  success: IOperationMetadata.IResponse;
-  exceptions: IOperationMetadata.IResponse[];
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-}
-export namespace IOperationMetadata {
-  export interface IParameter extends IResponse {
-    name: string;
-    index: number;
-    description: string | null;
-    jsDocTags: IJsDocTagInfo[];
-  }
-  export interface IResponse {
-    type: IReflectType | null;
-    imports: IReflectTypeImport[];
-    primitive: ValidationPipe<ISchema, IError>;
-    resolved: ValidationPipe<ISchema, IError>;
-  }
-  export interface IException {
-    type: IReflectType | null;
-    imports: IReflectTypeImport[];
-    primitive: ValidationPipe<ISchema, IError>;
-  }
-
-  export interface ISchema {
-    components: IMetadataComponents;
-    metadata: IMetadata;
-  }
-  export interface IError {
-    name: string;
-    accessor: string | null;
-    messages: string[];
-  }
-}
+import { IJsDocTagInfo } from "typia";
+import { IMetadata } from "typia/lib/schemas/metadata/IMetadata";
+import { IMetadataComponents } from "typia/lib/schemas/metadata/IMetadataComponents";
+import { ValidationPipe } from "typia/lib/typings/ValidationPipe";
+
+import { IReflectType } from "../structures/IReflectType";
+import { IReflectTypeImport } from "../structures/IReflectTypeImport";
+
+export interface IOperationMetadata {
+  parameters: IOperationMetadata.IParameter[];
+  success: IOperationMetadata.IResponse;
+  exceptions: IOperationMetadata.IResponse[];
+  description: string | null;
+  jsDocTags: IJsDocTagInfo[];
+}
+export namespace IOperationMetadata {
+  export interface IParameter extends IResponse {
+    name: string;
+    index: number;
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+  }
+  export interface IResponse {
+    type: IReflectType | null;
+    imports: IReflectTypeImport[];
+    primitive: ValidationPipe<ISchema, IError>;
+    resolved: ValidationPipe<ISchema, IError>;
+  }
+  export interface IException {
+    type: IReflectType | null;
+    imports: IReflectTypeImport[];
+    primitive: ValidationPipe<ISchema, IError>;
+  }
+
+  export interface ISchema {
+    components: IMetadataComponents;
+    metadata: IMetadata;
+  }
+  export interface IError {
+    name: string;
+    accessor: string | null;
+    messages: string[];
+  }
+}