@skmtc/core 0.0.367 → 0.0.369

package/esm/context/GenerateContext.d.ts

@@ -3,7 +3,7 @@ import { Definition } from '../dsl/Definition.js';
 import type { OasDocument } from '../oas/document/Document.js';
 import type { OasSchema } from '../oas/schema/Schema.js';
 import type { OasRef } from '../oas/ref/Ref.js';
-import type { FileContents, GetFileOptions } from './types.js';
+import type { FileContents } from './types.js';
 import type { BaseSettings, ClientSettings } from '../types/Settings.js';
 import type { Method } from '../types/Method.js';
 import type { OperationInsertable, OperationGateway } from '../dsl/operation/OperationInsertable.js';
@@ -85,18 +85,93 @@ export declare class GenerateContext {
     callback: (generatorKey: GeneratorKey) => void;
     captureCurrentResult: (result: SuccessWarningError) => void;
     constructor({ oasDocument, settings, logger, callback, captureCurrentResult, stackTrail }: ConstructorArgs);
+    /**
+     * @internal
+     */
     generate(generatorsMap: Record<string, OperationGateway | ModelGateway>): Map<string, FileContents>;
     trace<T>(token: string | string[], fn: () => T): T;
-    getFile(filePath: string, { throwIfNotFound }?: GetFileOptions): FileContents;
+    /**
+     * Converts schema to value using `schemaToValueFn` and creates definition
+     * with the given `identifier` at `destinationPath`.
+     *
+     * If a definition with the same name already exists, it will be returned
+     * instead of creating a new one.
+     *
+     * @param schema - The schema to create the definition for.
+     * @param identifier - The identifier for the definition.
+     * @param destinationPath - The path to the file where the definition will be registered.
+     * @param schemaToValueFn - A function that converts the schema to a value.
+     * @returns The created definition or cached definition if it already exists.
+     */
     createAndRegisterDefinition<Schema extends SchemaType>({ schema, identifier, destinationPath, schemaToValueFn }: CreateAndRegisterDefinition<Schema>): Definition<TypeSystemOutput<Schema['type']>>;
+    /**
+     * Insert supplied `imports` and `definitions` into file at `destinationPath`.
+     *
+     * If an import from a specified module already exists in the file, the
+     * import names are appended to the existing import.
+     *
+     * Definitions will only be added if there is not already a definition with
+     * the same name in the file.
+     *
+     * @mutates this.files
+     */
     register({ imports, definitions, destinationPath }: RegisterArgs): void;
+    /**
+     * Insert operation or model into the output file with path `destinationPath`.
+     *
+     * Insert will perform the following steps:
+     * 1. Generate content settings for the supplied operation or model
+     * 2. Look up definition in file with path `destinationPath`
+     * 3. If definition is not found, it will create a new one and register it
+     * 4. If the definition is defined at a location that is different from
+     *    the current file, it will add an import to the current file from
+     *    that location
+     * 5. Use the content settings to generate the operation/model using the
+     *    insertable's driver
+     * @mutates this.files
+     */
     insert<V extends GeneratedValue, T extends GenerationType>({ generation, destinationPath, ...rest }: InsertArgs<V, T>): Inserted<V, T>;
+    /**
+     * Generate and return content settings for operation insertable and
+     * operation.
+     *
+     * Content settings are produced by passing base settings and operation
+     * through toIdentifier, toExportPath and isSelected static methods on the
+     * insertable.
+     * @param { operation, insertable }
+     * @returns
+     */
     toOperationContentSettings<V>({ operation, insertable }: ToOperationSettingsArgs<V>): ContentSettings;
+    /**
+     * Generate and return content settings for model insertable and refName.
+     *
+     * Content settings are produced by passing base settings and refName
+     * through toIdentifier, toExportPath and isSelected static methods on the
+     * insertable.
+     * @param { refName, insertable }
+     * @returns Content settings for model
+     */
     toModelContentSettings<V>({ refName, insertable }: BuildModelSettingsArgs<V>): ContentSettings;
+    /**
+     * Look up operation settings for a given generatorId, path and method.
+     * @param { generatorId, path, method }
+     * @returns Base settings for operation
+     */
     toOperationBaseSettings({ generatorId, path, method }: GetOperationSettingsArgs): BaseSettings;
-    addFile(normalisedPath: string): FileContents;
+    /**
+     * Perform one lookup of schema by `refName`.
+     * @param refName
+     * @returns Matching schema or ref
+     * @throws if schema is not found
+     */
     resolveSchemaRefOnce(refName: RefName): OasSchema | OasRef<'schema'>;
-    /** Produce external instance and return its name */
+    /**
+     * Check if definition name `name` in file with path `exportPath`
+     * has already been created and registered.
+     *
+     * @param { name, exportPath }
+     * @returns Matching definition if found or `undefined` otherwise
+     */
     findDefinition({ name, exportPath }: PickArgs): Definition | undefined;
 }
 export {};

package/esm/context/GenerateContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GenerateContext.d.ts","sourceRoot":"","sources":["../../src/context/GenerateContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GenerateContext.d.ts","sourceRoot":"","sources":["../../src/context/GenerateContext.ts"],"names":[],"mappings":"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"}

package/esm/context/GenerateContext.js

@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _GenerateContext_instances, _GenerateContext_files, _GenerateContext_stackTrail, _GenerateContext_runOperationGenerator, _GenerateContext_runModelGenerator, _GenerateContext_toModelBaseSettings;
+var _GenerateContext_instances, _GenerateContext_files, _GenerateContext_stackTrail, _GenerateContext_runOperationGenerator, _GenerateContext_runModelGenerator, _GenerateContext_getFile, _GenerateContext_toModelBaseSettings, _GenerateContext_addFile;
 import { join, normalize } from '../deps/jsr.io/@std/path/1.0.0/mod.js';
 import { Import } from '../dsl/Import.js';
 import { Definition } from '../dsl/Definition.js';
@@ -63,6 +63,9 @@ export class GenerateContext {
         __classPrivateFieldSet(this, _GenerateContext_stackTrail, stackTrail, "f");
         this.captureCurrentResult = captureCurrentResult;
     }
+    /**
+     * @internal
+     */
     generate(generatorsMap) {
         Sentry.startSpan({ name: 'Generate operations' }, () => Object.values(generatorsMap)
             .filter(generator => generator.type === 'operation')
@@ -89,19 +92,19 @@ export class GenerateContext {
     trace(token, fn) {
         return tracer(__classPrivateFieldGet(this, _GenerateContext_stackTrail, "f"), token, fn);
     }
-    getFile(filePath, { throwIfNotFound = false } = {}) {
-        const normalisedPath = normalize(filePath);
-        const currentFile = __classPrivateFieldGet(this, _GenerateContext_files, "f").get(normalisedPath);
-        if (!currentFile) {
-            if (throwIfNotFound) {
-                throw new Error(`File not found: '${normalisedPath}'`);
-            }
-            else {
-                return this.addFile(normalisedPath);
-            }
-        }
-        return currentFile;
-    }
+    /**
+     * Converts schema to value using `schemaToValueFn` and creates definition
+     * with the given `identifier` at `destinationPath`.
+     *
+     * If a definition with the same name already exists, it will be returned
+     * instead of creating a new one.
+     *
+     * @param schema - The schema to create the definition for.
+     * @param identifier - The identifier for the definition.
+     * @param destinationPath - The path to the file where the definition will be registered.
+     * @param schemaToValueFn - A function that converts the schema to a value.
+     * @returns The created definition or cached definition if it already exists.
+     */
     createAndRegisterDefinition({ schema, identifier, destinationPath, schemaToValueFn }) {
         const cachedDefinition = this.findDefinition({
             name: identifier.name,
@@ -129,8 +132,20 @@ export class GenerateContext {
         });
         return responseDefinition;
     }
+    /**
+     * Insert supplied `imports` and `definitions` into file at `destinationPath`.
+     *
+     * If an import from a specified module already exists in the file, the
+     * import names are appended to the existing import.
+     *
+     * Definitions will only be added if there is not already a definition with
+     * the same name in the file.
+     *
+     * @mutates this.files
+     */
     register({ imports = {}, definitions, destinationPath }) {
-        const currentFile = this.getFile(destinationPath);
+        // TODO deduplicate import names and definition names against each other
+        const currentFile = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_getFile).call(this, destinationPath);
         Object.entries(imports).forEach(([importModule, importNames]) => {
             const module = currentFile.imports.get(importModule);
             const importItem = new Import({ module: importModule, importNames });
@@ -141,12 +156,30 @@ export class GenerateContext {
                 currentFile.imports.set(importModule, new Set(importItem.importNames.map(n => `${n}`)));
             }
         });
-        definitions
-            ?.filter((definition) => Boolean(definition))
-            .forEach(definition => {
-            currentFile.definitions.set(`${definition.identifier}`, definition);
+        definitions?.forEach(definition => {
+            if (!definition) {
+                return;
+            }
+            const { name } = definition.identifier;
+            if (!currentFile.definitions.has(name)) {
+                currentFile.definitions.set(name, definition);
+            }
         });
     }
+    /**
+     * Insert operation or model into the output file with path `destinationPath`.
+     *
+     * Insert will perform the following steps:
+     * 1. Generate content settings for the supplied operation or model
+     * 2. Look up definition in file with path `destinationPath`
+     * 3. If definition is not found, it will create a new one and register it
+     * 4. If the definition is defined at a location that is different from
+     *    the current file, it will add an import to the current file from
+     *    that location
+     * 5. Use the content settings to generate the operation/model using the
+     *    insertable's driver
+     * @mutates this.files
+     */
     insert({ generation, destinationPath, ...rest }) {
         const { settings, definition } = match(rest)
             .with({ operation: P.nonNullable }, ({ insertable, operation }) => {
@@ -170,6 +203,16 @@ export class GenerateContext {
             .exhaustive();
         return new Inserted({ settings, definition });
     }
+    /**
+     * Generate and return content settings for operation insertable and
+     * operation.
+     *
+     * Content settings are produced by passing base settings and operation
+     * through toIdentifier, toExportPath and isSelected static methods on the
+     * insertable.
+     * @param { operation, insertable }
+     * @returns
+     */
     toOperationContentSettings({ operation, insertable }) {
         const baseSettings = this.toOperationBaseSettings({
             generatorId: insertable.id,
@@ -184,6 +227,15 @@ export class GenerateContext {
             importFrom: baseSettings.importFrom ?? e
         });
     }
+    /**
+     * Generate and return content settings for model insertable and refName.
+     *
+     * Content settings are produced by passing base settings and refName
+     * through toIdentifier, toExportPath and isSelected static methods on the
+     * insertable.
+     * @param { refName, insertable }
+     * @returns Content settings for model
+     */
     toModelContentSettings({ refName, insertable }) {
         const baseSettings = __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_toModelBaseSettings).call(this, {
             generatorId: insertable.id,
@@ -197,6 +249,11 @@ export class GenerateContext {
             importFrom: baseSettings.importFrom ?? e
         });
     }
+    /**
+     * Look up operation settings for a given generatorId, path and method.
+     * @param { generatorId, path, method }
+     * @returns Base settings for operation
+     */
     toOperationBaseSettings({ generatorId, path, method }) {
         const generatorSettings = this.settings?.generators?.find(({ id }) => id === generatorId);
         const operationSettings = generatorSettings && 'operations' in generatorSettings
@@ -213,18 +270,12 @@ export class GenerateContext {
         };
         return baseSettings;
     }
-    addFile(normalisedPath) {
-        if (__classPrivateFieldGet(this, _GenerateContext_files, "f").has(normalisedPath)) {
-            throw new Error(`File already exists: ${normalisedPath}`);
-        }
-        const newFile = {
-            imports: new Map(),
-            definitions: new Map(),
-            generatorKeys: new Set()
-        };
-        __classPrivateFieldGet(this, _GenerateContext_files, "f").set(normalisedPath, newFile);
-        return newFile;
-    }
+    /**
+     * Perform one lookup of schema by `refName`.
+     * @param refName
+     * @returns Matching schema or ref
+     * @throws if schema is not found
+     */
     resolveSchemaRefOnce(refName) {
         const schema = this.oasDocument.components?.schemas?.[refName]?.resolveOnce();
         if (!schema) {
@@ -232,9 +283,15 @@ export class GenerateContext {
         }
         return schema;
     }
-    /** Produce external instance and return its name */
+    /**
+     * Check if definition name `name` in file with path `exportPath`
+     * has already been created and registered.
+     *
+     * @param { name, exportPath }
+     * @returns Matching definition if found or `undefined` otherwise
+     */
     findDefinition({ name, exportPath }) {
-        return this.getFile(exportPath).definitions.get(name);
+        return __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_getFile).call(this, exportPath).definitions.get(name);
     }
 }
 _GenerateContext_files = new WeakMap(), _GenerateContext_stackTrail = new WeakMap(), _GenerateContext_instances = new WeakSet(), _GenerateContext_runOperationGenerator = function _GenerateContext_runOperationGenerator({ oasDocument, generator }) {
@@ -296,6 +353,18 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_stackTrail = new WeakMa
             });
         });
     }
+}, _GenerateContext_getFile = function _GenerateContext_getFile(filePath, { throwIfNotFound = false } = {}) {
+    const normalisedPath = normalize(filePath);
+    const currentFile = __classPrivateFieldGet(this, _GenerateContext_files, "f").get(normalisedPath);
+    if (!currentFile) {
+        if (throwIfNotFound) {
+            throw new Error(`File not found: '${normalisedPath}'`);
+        }
+        else {
+            return __classPrivateFieldGet(this, _GenerateContext_instances, "m", _GenerateContext_addFile).call(this, normalisedPath);
+        }
+    }
+    return currentFile;
 }, _GenerateContext_toModelBaseSettings = function _GenerateContext_toModelBaseSettings({ generatorId, refName }) {
     const generatorSettings = this.settings?.generators?.find(({ id }) => id === generatorId);
     const modelSettings = generatorSettings && 'models' in generatorSettings
@@ -311,4 +380,15 @@ _GenerateContext_files = new WeakMap(), _GenerateContext_stackTrail = new WeakMa
         importFrom: modelSettings?.importFrom
     };
     return baseSettings;
+}, _GenerateContext_addFile = function _GenerateContext_addFile(normalisedPath) {
+    if (__classPrivateFieldGet(this, _GenerateContext_files, "f").has(normalisedPath)) {
+        throw new Error(`File already exists: ${normalisedPath}`);
+    }
+    const newFile = {
+        imports: new Map(),
+        definitions: new Map(),
+        generatorKeys: new Set()
+    };
+    __classPrivateFieldGet(this, _GenerateContext_files, "f").set(normalisedPath, newFile);
+    return newFile;
 };

package/esm/oas/array/Array.d.ts

@@ -7,16 +7,40 @@ export type ArrayFields = {
     nullable?: boolean;
     uniqueItems?: boolean;
 };
+/**
+ * Object representing an array in the OpenAPI Specification.
+ */
 export declare class OasArray {
-    #private;
-    oasType: 'schema';
-    type: 'array';
+    /**
+     * Object is part the 'schema' set which is used
+     * to define data types in an OpenAPI document.
+     */
+    oasType: "schema";
+    /**
+     * Constant value 'array' useful for type narrowing and tagged unions.
+     */
+    type: "array";
+    /**
+     * Defines the type of items in the array.
+     */
+    items: OasSchema | OasRef<'schema'>;
+    /**
+     * A short summary of the array.
+     */
+    title: string | undefined;
+    /**
+     * A description of the array.
+     */
+    description: string | undefined;
+    /**
+     * Indicates whether value can be null.
+     */
+    nullable: boolean | undefined;
+    /**
+     * Indicates whether the array items must be unique.
+     */
+    uniqueItems: boolean | undefined;
     constructor(fields: ArrayFields);
-    get items(): OasSchema | OasRef<'schema'>;
-    get title(): string | undefined;
-    get description(): string | undefined;
-    get nullable(): boolean | undefined;
-    get uniqueItems(): boolean | undefined;
     isRef(): this is OasRef<'schema'>;
     resolve(): OasArray;
     resolveOnce(): OasArray;

package/esm/oas/array/Array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../src/oas/array/Array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,qBAAa,QAAQ;;IACnB,OAAO,EAAE,QAAQ,CAAW;IAC5B,IAAI,EAAE,OAAO,CAAU;gBAGX,MAAM,EAAE,WAAW;IAI/B,IAAI,KAAK,IAAI,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAExC;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;IAED,IAAI,WAAW,IAAI,OAAO,GAAG,SAAS,CAErC;IAED,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,QAAQ;IAInB,WAAW,IAAI,QAAQ;CAGxB"}
+{"version":3,"file":"Array.d.ts","sourceRoot":"","sources":["../../../src/oas/array/Array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB;;;OAGG;IACH,OAAO,WAAoB;IAC3B;;OAEG;IACH,IAAI,UAAmB;IACvB;;OAEG;IACH,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,SAAS,CAAA;gBAEpB,MAAM,EAAE,WAAW;IAQ/B,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,QAAQ;IAInB,WAAW,IAAI,QAAQ;CAGxB"}

package/esm/oas/array/Array.js

@@ -1,46 +1,77 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _OasArray_fields;
+/**
+ * Object representing an array in the OpenAPI Specification.
+ */
 export class OasArray {
     constructor(fields) {
+        /**
+         * Object is part the 'schema' set which is used
+         * to define data types in an OpenAPI document.
+         */
         Object.defineProperty(this, "oasType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'schema'
         });
+        /**
+         * Constant value 'array' useful for type narrowing and tagged unions.
+         */
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'array'
         });
-        _OasArray_fields.set(this, void 0);
-        __classPrivateFieldSet(this, _OasArray_fields, fields, "f");
-    }
-    get items() {
-        return __classPrivateFieldGet(this, _OasArray_fields, "f").items;
-    }
-    get title() {
-        return __classPrivateFieldGet(this, _OasArray_fields, "f").title;
-    }
-    get description() {
-        return __classPrivateFieldGet(this, _OasArray_fields, "f").description;
-    }
-    get nullable() {
-        return __classPrivateFieldGet(this, _OasArray_fields, "f").nullable;
-    }
-    get uniqueItems() {
-        return __classPrivateFieldGet(this, _OasArray_fields, "f").uniqueItems;
+        /**
+         * Defines the type of items in the array.
+         */
+        Object.defineProperty(this, "items", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * A short summary of the array.
+         */
+        Object.defineProperty(this, "title", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * A description of the array.
+         */
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Indicates whether value can be null.
+         */
+        Object.defineProperty(this, "nullable", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Indicates whether the array items must be unique.
+         */
+        Object.defineProperty(this, "uniqueItems", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.items = fields.items;
+        this.title = fields.title;
+        this.description = fields.description;
+        this.nullable = fields.nullable;
+        this.uniqueItems = fields.uniqueItems;
     }
     isRef() {
         return false;
@@ -52,4 +83,3 @@ export class OasArray {
         return this;
     }
 }
-_OasArray_fields = new WeakMap();

package/esm/oas/boolean/Boolean.d.ts

@@ -4,14 +4,32 @@ export type BooleanFields = {
     description?: string;
     nullable?: boolean;
 };
+/**
+ * Object representing a boolean in the OpenAPI Specification.
+ */
 export declare class OasBoolean {
-    #private;
-    oasType: 'schema';
-    type: 'boolean';
+    /**
+     * Object is part the 'schema' set which is used
+     * to define data types in an OpenAPI document.
+     */
+    oasType: "schema";
+    /**
+     * Constant value 'boolean' useful for type narrowing and tagged unions.
+     */
+    type: "boolean";
+    /**
+     * A short summary of the boolean.
+     */
+    title: string | undefined;
+    /**
+     * A description of the boolean.
+     */
+    description: string | undefined;
+    /**
+     * Indicates whether value can be null.
+     */
+    nullable: boolean | undefined;
     constructor(fields: BooleanFields);
-    get title(): string | undefined;
-    get description(): string | undefined;
-    get nullable(): boolean | undefined;
     isRef(): this is OasRef<'schema'>;
     resolve(): OasBoolean;
     resolveOnce(): OasBoolean;

package/esm/oas/boolean/Boolean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Boolean.d.ts","sourceRoot":"","sources":["../../../src/oas/boolean/Boolean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qBAAa,UAAU;;IACrB,OAAO,EAAE,QAAQ,CAAW;IAC5B,IAAI,EAAE,SAAS,CAAY;gBAGf,MAAM,EAAE,aAAa;IAIjC,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;IAED,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,UAAU;CAG1B"}
+{"version":3,"file":"Boolean.d.ts","sourceRoot":"","sources":["../../../src/oas/boolean/Boolean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACH,OAAO,WAAoB;IAC3B;;OAEG;IACH,IAAI,YAAqB;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;gBAEjB,MAAM,EAAE,aAAa;IAMjC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,UAAU;CAG1B"}

package/esm/oas/boolean/Boolean.js

@@ -1,40 +1,57 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _OasBoolean_fields;
+/**
+ * Object representing a boolean in the OpenAPI Specification.
+ */
 export class OasBoolean {
     constructor(fields) {
+        /**
+         * Object is part the 'schema' set which is used
+         * to define data types in an OpenAPI document.
+         */
         Object.defineProperty(this, "oasType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'schema'
         });
+        /**
+         * Constant value 'boolean' useful for type narrowing and tagged unions.
+         */
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'boolean'
         });
-        _OasBoolean_fields.set(this, void 0);
-        __classPrivateFieldSet(this, _OasBoolean_fields, fields, "f");
-    }
-    get title() {
-        return __classPrivateFieldGet(this, _OasBoolean_fields, "f").title;
-    }
-    get description() {
-        return __classPrivateFieldGet(this, _OasBoolean_fields, "f").description;
-    }
-    get nullable() {
-        return __classPrivateFieldGet(this, _OasBoolean_fields, "f").nullable;
+        /**
+         * A short summary of the boolean.
+         */
+        Object.defineProperty(this, "title", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * A description of the boolean.
+         */
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Indicates whether value can be null.
+         */
+        Object.defineProperty(this, "nullable", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.title = fields.title;
+        this.description = fields.description;
+        this.nullable = fields.nullable;
     }
     isRef() {
         return false;
@@ -46,4 +63,3 @@ export class OasBoolean {
         return this;
     }
 }
-_OasBoolean_fields = new WeakMap();