@apimatic/cli 1.5.0 → 2.0.0-beta.2

package/lib/types/sdk/generate.js

@@ -8,9 +8,9 @@ export var Language;
     Language["TYPESCRIPT"] = "typescript";
     Language["GO"] = "go";
 })(Language || (Language = {}));
+/** An enum, not a constant, so the next generator is a line here and nothing else. */
 export var CodeGenerationVersion;
 (function (CodeGenerationVersion) {
-    CodeGenerationVersion["V3"] = "v3";
     CodeGenerationVersion["V4"] = "v4";
 })(CodeGenerationVersion || (CodeGenerationVersion = {}));
 export var Stability;
@@ -25,70 +25,93 @@ const languageMap = {
     8: Language.PHP,
     16: Language.PYTHON,
     32: Language.RUBY,
-    128: Language.TYPESCRIPT,
+    128: Language.TYPESCRIPT
 };
 export function mapLanguages(languageFlag) {
     return Object.entries(languageMap)
         .filter(([flag]) => (languageFlag & parseInt(flag)) !== 0)
         .map(([, language]) => language);
 }
-/**
- * The languages offered in the quickstart prompts, in display order.
- * Shared by the portal (multi-select) and SDK (single-select) flows so both
- * present the same list; the subscription's allowed languages decide which
- * are selectable.
- */
+export const LANGUAGE_NAMES = {
+    [Language.CSHARP]: 'C#',
+    [Language.GO]: 'Go',
+    [Language.JAVA]: 'Java',
+    [Language.PHP]: 'PHP',
+    [Language.PYTHON]: 'Python',
+    [Language.RUBY]: 'Ruby',
+    [Language.TYPESCRIPT]: 'TypeScript'
+};
+/** In display order, which `UPCOMING_LANGUAGES` inherits. */
 export const LANGUAGE_CHOICES = [
-    { label: "Typescript", value: Language.TYPESCRIPT },
-    { label: "Ruby", value: Language.RUBY },
-    { label: "Python", value: Language.PYTHON },
-    { label: "Java", value: Language.JAVA },
-    { label: "C#", value: Language.CSHARP },
-    { label: "PHP", value: Language.PHP },
-    { label: "Go", value: Language.GO }
-];
+    Language.TYPESCRIPT,
+    Language.RUBY,
+    Language.PYTHON,
+    Language.JAVA,
+    Language.CSHARP,
+    Language.PHP,
+    Language.GO
+].map((value) => ({ label: LANGUAGE_NAMES[value], value }));
+/** What each generator offers for a language. A language absent from it cannot be generated. */
 export class CodegenOption {
+    version;
+    stability;
     constructor(version, stability) {
         this.version = version;
         this.stability = stability;
     }
     static create(version, stability) {
-        if (version === CodeGenerationVersion.V3) {
-            return CodegenOption.v3;
-        }
         return new CodegenOption(version, stability);
     }
-    isV3() {
-        return this.version === CodeGenerationVersion.V3;
-    }
-    isV4() {
-        return this.version === CodeGenerationVersion.V4;
+    codeGenerationVersion() {
+        return this.version;
     }
     stabilityLevel() {
         return this.stability;
     }
-    codeGenerationVersion() {
-        return this.version;
-    }
     toString() {
         return `${this.version.toUpperCase()} (${this.stability})`;
     }
 }
-CodegenOption.v3 = new CodegenOption(CodeGenerationVersion.V3, Stability.STABLE);
-/**
- * For validating only interactive `sdk publish/generate` commands.
- * Non-interactive validation is handled server-side by codegen API.
- */
+/** The generator and level together, because neither is a choice the other can be made without. */
 export const CODEGEN_OPTIONS = {
-    [Language.CSHARP]: [CodegenOption.v3, CodegenOption.create(CodeGenerationVersion.V4, Stability.BETA)],
-    [Language.GO]: [CodegenOption.v3],
-    [Language.JAVA]: [CodegenOption.v3],
-    [Language.PHP]: [CodegenOption.v3],
-    [Language.PYTHON]: [CodegenOption.v3, CodegenOption.create(CodeGenerationVersion.V4, Stability.BETA)],
-    [Language.RUBY]: [CodegenOption.v3],
-    [Language.TYPESCRIPT]: [CodegenOption.v3, CodegenOption.create(CodeGenerationVersion.V4, Stability.BETA)]
+    [Language.CSHARP]: [
+        CodegenOption.create(CodeGenerationVersion.V4, Stability.STABLE),
+        CodegenOption.create(CodeGenerationVersion.V4, Stability.BETA)
+    ],
+    [Language.TYPESCRIPT]: [
+        CodegenOption.create(CodeGenerationVersion.V4, Stability.STABLE),
+        CodegenOption.create(CodeGenerationVersion.V4, Stability.BETA)
+    ],
+    [Language.PYTHON]: [
+        CodegenOption.create(CodeGenerationVersion.V4, Stability.STABLE),
+        CodegenOption.create(CodeGenerationVersion.V4, Stability.BETA)
+    ]
 };
-export function getCodegenOptions(language) {
-    return CODEGEN_OPTIONS[language];
+/** The keys of the table above: a language is available exactly when something can generate it. */
+export const AVAILABLE_LANGUAGES = Object.keys(CODEGEN_OPTIONS);
+/** The rest of the enum, so a language cannot be named by both lists or by neither. */
+export const UPCOMING_LANGUAGES = LANGUAGE_CHOICES.map((choice) => choice.value).filter((language) => !AVAILABLE_LANGUAGES.includes(language));
+/** Takes a string because a config file names its own languages, and may name anything. */
+export function isAvailableLanguage(language) {
+    return AVAILABLE_LANGUAGES.includes(language);
+}
+// The portal artifacts can be generated for these today; the rest of `Language` comes later.
+export const PORTAL_LANGUAGES = [Language.CSHARP, Language.TYPESCRIPT, Language.PYTHON];
+export function codegenOptionsFor(language) {
+    return CODEGEN_OPTIONS[language] ?? [];
+}
+export function stabilityLevelsFor(language) {
+    return codegenOptionsFor(language).map((option) => option.stabilityLevel());
+}
+/** What a flow that never asks sends: the first level a language offers. */
+export function defaultStability(language) {
+    return stabilityLevelsFor(language)[0] ?? Stability.STABLE;
+}
+/**
+ * The name a language is shown under everywhere, so one reads the same in every message.
+ * Takes a string because a config file names its own languages, and may name anything.
+ */
+export function languageLabel(language) {
+    return LANGUAGE_NAMES[language] ?? language;
 }
 //# sourceMappingURL=generate.js.map

package/lib/types/sdk/generate.js.map

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

package/lib/types/sdk/stability-choice.d.ts

@@ -0,0 +1,12 @@
+import { Language, Stability } from './generate.js';
+/** The level a run generates at, and whether the caller named it or took what the language offers. */
+export declare class StabilityChoice {
+    private readonly level;
+    private readonly chosen;
+    private constructor();
+    /** An absent flag is not a level: what the language offers first is what an unasked run sends. */
+    static for(language: Language, flagValue: string | undefined): StabilityChoice;
+    stabilityLevel(): Stability;
+    /** The publishing summary names the level only when it was asked for. */
+    chosenLevel(): Stability | undefined;
+}

package/lib/types/sdk/stability-choice.js

@@ -0,0 +1,24 @@
+import { defaultStability } from './generate.js';
+/** The level a run generates at, and whether the caller named it or took what the language offers. */
+export class StabilityChoice {
+    level;
+    chosen;
+    constructor(level, chosen) {
+        this.level = level;
+        this.chosen = chosen;
+    }
+    /** An absent flag is not a level: what the language offers first is what an unasked run sends. */
+    static for(language, flagValue) {
+        return flagValue === undefined
+            ? new StabilityChoice(defaultStability(language), false)
+            : new StabilityChoice(flagValue, true);
+    }
+    stabilityLevel() {
+        return this.level;
+    }
+    /** The publishing summary names the level only when it was asked for. */
+    chosenLevel() {
+        return this.chosen ? this.level : undefined;
+    }
+}
+//# sourceMappingURL=stability-choice.js.map

package/lib/types/sdk/stability-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stability-choice.js","sourceRoot":"","sources":["../../../src/types/sdk/stability-choice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAuB,MAAM,eAAe,CAAC;AAEtE,sGAAsG;AACtG,MAAM,OAAO,eAAe;IACW,KAAK;IAA8B,MAAM;IAA9E,YAAqC,KAAgB,EAAmB,MAAe;qBAAlD,KAAK;sBAA8B,MAAM;IAAY,CAAC;IAE3F,kGAAkG;IAC3F,MAAM,CAAC,GAAG,CAAC,QAAkB,EAAE,SAA6B;QACjE,OAAO,SAAS,KAAK,SAAS;YAC5B,CAAC,CAAC,IAAI,eAAe,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;YACxD,CAAC,CAAC,IAAI,eAAe,CAAC,SAAsB,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,yEAAyE;IAClE,WAAW;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,CAAC;CACF"}

package/lib/types/sdk-context.d.ts

@@ -1,15 +1,14 @@
-import { DirectoryPath } from "./file/directoryPath.js";
-import { FilePath } from "./file/filePath.js";
-import { Language } from "./sdk/generate.js";
+import { DirectoryPath } from './file/directoryPath.js';
+import { FilePath } from './file/filePath.js';
+import { Language } from './sdk/generate.js';
 export declare class SdkContext {
     private readonly language;
     private readonly fileService;
     private readonly zipService;
     private readonly sdkDirectory;
-    constructor(language: Language, sdkDirectory: DirectoryPath, requireUncustomizedDir: boolean, version?: string);
+    constructor(language: Language, sdkDirectory: DirectoryPath, version?: string);
     private get zipPath();
     exists(): Promise<boolean>;
     save(tempSdkDirectory: DirectoryPath, zipSdk: boolean): Promise<DirectoryPath>;
     loadSdkInTempDirectory(tempDirectory: DirectoryPath, tempSdk: FilePath): Promise<DirectoryPath>;
-    loadSdkWithSourceTreeInTempDirectory(tempDirectory: DirectoryPath, tempSdk: FilePath, tempSdkSourceTree: FilePath): Promise<DirectoryPath>;
 }

package/lib/types/sdk-context.js

@@ -1,14 +1,15 @@
-import { FileService } from "../infrastructure/file-service.js";
-import { FilePath } from "./file/filePath.js";
-import { FileName } from "./file/fileName.js";
-import { ZipService } from "../infrastructure/zip-service.js";
+import { FileService } from '../infrastructure/file-service.js';
+import { FilePath } from './file/filePath.js';
+import { FileName } from './file/fileName.js';
+import { ZipService } from '../infrastructure/zip-service.js';
 export class SdkContext {
-    constructor(language, sdkDirectory, requireUncustomizedDir, version) {
+    language;
+    fileService = new FileService();
+    zipService = new ZipService();
+    sdkDirectory;
+    constructor(language, sdkDirectory, version) {
         this.language = language;
-        this.fileService = new FileService();
-        this.zipService = new ZipService();
-        const baseDirectory = requireUncustomizedDir ? sdkDirectory.join('uncustomized') : sdkDirectory;
-        this.sdkDirectory = version ? baseDirectory.join(version).join(language) : baseDirectory.join(language);
+        this.sdkDirectory = version ? sdkDirectory.join(version).join(language) : sdkDirectory.join(language);
     }
     get zipPath() {
         return new FilePath(this.sdkDirectory, new FileName(`${this.language}.zip`));
@@ -32,14 +33,5 @@ export class SdkContext {
         await this.zipService.unArchive(tempSdk, tempSdkDirectory);
         return tempSdkDirectory;
     }
-    async loadSdkWithSourceTreeInTempDirectory(tempDirectory, tempSdk, tempSdkSourceTree) {
-        const tempSdkDirectory = tempDirectory.join('sdk');
-        await this.fileService.createDirectoryIfNotExists(tempSdkDirectory);
-        await this.zipService.unArchive(tempSdk, tempSdkDirectory);
-        const gitSourceTreeDir = tempSdkDirectory.join('.git');
-        await this.fileService.createDirectoryIfNotExists(gitSourceTreeDir);
-        await this.zipService.unArchive(tempSdkSourceTree, gitSourceTreeDir);
-        return tempSdkDirectory;
-    }
 }
 //# sourceMappingURL=sdk-context.js.map

package/lib/types/sdk-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-context.js","sourceRoot":"","sources":["../../src/types/sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,OAAO,UAAU;IAKrB,YACmB,QAAkB,EACnC,YAA2B,EAC3B,sBAA+B,EAC/B,OAAgB;QAHC,aAAQ,GAAR,QAAQ,CAAU;QALpB,gBAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,eAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QAS7C,MAAM,aAAa,GAAG,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAEhG,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1G,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC;IAC/E,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACrE,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,gBAA+B,EAAE,MAAe;QAChE,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,sBAAsB,CAAC,aAA4B,EAAE,OAAiB;QACjF,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC3D,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,oCAAoC,CAC/C,aAA4B,EAC5B,OAAiB,EACjB,iBAA2B;QAE3B,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC3D,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QACrE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF"}
+{"version":3,"file":"sdk-context.js","sourceRoot":"","sources":["../../src/types/sdk-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,OAAO,UAAU;IAKQ,QAAQ;IAJpB,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAC9B,YAAY,CAAgB;IAE7C,YAA6B,QAAkB,EAAE,YAA2B,EAAE,OAAgB;wBAAjE,QAAQ;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxG,CAAC;IAED,IAAY,OAAO;QACjB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC;IAC/E,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACrE,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,gBAA+B,EAAE,MAAe;QAChE,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,sBAAsB,CAAC,aAA4B,EAAE,OAAiB;QACjF,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC3D,OAAO,gBAAgB,CAAC;IAC1B,CAAC;CACF"}

package/lib/types/spec-context.d.ts

@@ -1,12 +1,13 @@
-import { DirectoryPath } from "./file/directoryPath.js";
-import { FilePath } from "./file/filePath.js";
-import { FileName } from "./file/fileName.js";
+import { DirectoryPath } from './file/directoryPath.js';
+import { FilePath } from './file/filePath.js';
+import { FileName } from './file/fileName.js';
 export declare class SpecContext {
     private readonly fileService;
     private readonly zipService;
     private readonly specDirectory;
     constructor(specDirectory: DirectoryPath);
     validate(): Promise<boolean>;
-    replaceDefaultSpec(specPath: FilePath): Promise<void>;
+    /** Adds a specification to this directory, unpacking it when it is a split-spec archive. */
+    install(specPath: FilePath): Promise<void>;
     save(stream: NodeJS.ReadableStream, fileName: FileName): Promise<FilePath>;
 }

package/lib/types/spec-context.js

@@ -1,18 +1,19 @@
-import { FileService } from "../infrastructure/file-service.js";
-import { FilePath } from "./file/filePath.js";
-import { FileName } from "./file/fileName.js";
-import { ZipService } from "../infrastructure/zip-service.js";
+import { FileService } from '../infrastructure/file-service.js';
+import { FilePath } from './file/filePath.js';
+import { ZipService } from '../infrastructure/zip-service.js';
 export class SpecContext {
+    fileService = new FileService();
+    zipService = new ZipService();
+    specDirectory;
     constructor(specDirectory) {
-        this.fileService = new FileService();
-        this.zipService = new ZipService();
         this.specDirectory = specDirectory;
     }
     async validate() {
         return !(await this.fileService.directoryEmpty(this.specDirectory));
     }
-    async replaceDefaultSpec(specPath) {
-        await this.fileService.deleteFile(new FilePath(this.specDirectory, new FileName("openapi.json")));
+    /** Adds a specification to this directory, unpacking it when it is a split-spec archive. */
+    async install(specPath) {
+        await this.fileService.createDirectoryIfNotExists(this.specDirectory);
         if (await this.fileService.isZipFile(specPath)) {
             await this.zipService.unArchive(specPath, this.specDirectory);
         }

package/lib/types/spec-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec-context.js","sourceRoot":"","sources":["../../src/types/spec-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,OAAO,WAAW;IAMtB,YAAY,aAA4B;QALvB,gBAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,eAAU,GAAG,IAAI,UAAU,EAAE,CAAC;QAK7C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAAC,QAAkB;QAChD,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAClG,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAA6B,EAAE,QAAkB;QACjE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"spec-context.js","sourceRoot":"","sources":["../../src/types/spec-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,OAAO,WAAW;IACL,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAC9B,aAAa,CAAgB;IAE9C,YAAY,aAA4B;QACtC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,4FAA4F;IACrF,KAAK,CAAC,OAAO,CAAC,QAAkB;QACrC,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtE,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAA6B,EAAE,QAAkB;QACjE,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/lib/types/temp-context.d.ts

@@ -6,6 +6,6 @@ export declare class TempContext {
     private readonly zipService;
     constructor(tempDirectory: DirectoryPath);
     private get getTempFileName();
-    zip(buildDirectory: DirectoryPath): Promise<FilePath>;
+    zip(directory: DirectoryPath): Promise<FilePath>;
     save(portalStream: NodeJS.ReadableStream): Promise<FilePath>;
 }

package/lib/types/temp-context.js

@@ -4,18 +4,19 @@ import { FilePath } from "./file/filePath.js";
 import { FileName } from "./file/fileName.js";
 import { randomUUID } from "crypto";
 export class TempContext {
+    tempDirectory;
+    fileService = new FileService();
+    zipService = new ZipService();
     constructor(tempDirectory) {
         this.tempDirectory = tempDirectory;
-        this.fileService = new FileService();
-        this.zipService = new ZipService();
     }
     get getTempFileName() {
         const uuid = randomUUID();
         return new FilePath(this.tempDirectory, new FileName(`${uuid}`));
     }
-    async zip(buildDirectory) {
+    async zip(directory) {
         const tempFile = this.getTempFileName;
-        await this.zipService.archive(buildDirectory, tempFile);
+        await this.zipService.archive(directory, tempFile);
         return tempFile;
     }
     async save(portalStream) {

package/lib/types/temp-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"temp-context.js","sourceRoot":"","sources":["../../src/types/temp-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,OAAO,WAAW;IAItB,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QAHxC,gBAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAChC,eAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAEc,CAAC;IAE9D,IAAY,eAAe;QACzB,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC1B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,cAA6B;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QACtC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,YAAmC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QACtC,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"temp-context.js","sourceRoot":"","sources":["../../src/types/temp-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,OAAO,WAAW;IAIO,aAAa;IAHzB,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAChC,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAE/C,YAA6B,aAA4B;6BAA5B,aAAa;IAAmB,CAAC;IAE9D,IAAY,eAAe;QACzB,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC1B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,SAAwB;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QACtC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,YAAmC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;QACtC,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/lib/types/transform-context.d.ts

@@ -1,13 +1,17 @@
-import { ExportFormats } from "@apimatic/sdk";
-import { DirectoryPath } from "./file/directoryPath.js";
-import { FilePath } from "./file/filePath.js";
+import { ExportFormats } from '@apimatic/sdk';
+import { DirectoryPath } from './file/directoryPath.js';
+import { FileName } from './file/fileName.js';
+import { FilePath } from './file/filePath.js';
+/** Where `api transform` writes, inside the `--destination` it is given. */
+export declare const TRANSFORMATIONS_DIRECTORY_NAME = "transformations";
+/** What `api transform` names its output: the input's name, then the format and its extension. */
+export declare function transformedFileName(file: FilePath, format: ExportFormats): FileName;
 export declare class TransformContext {
     private readonly destinationDirectory;
     private readonly fileService;
     private readonly transformedApi;
     constructor(specFilePath: FilePath, format: ExportFormats, destinationDirectory: DirectoryPath);
-    private get specPath();
     exists(): Promise<boolean>;
     save(stream: NodeJS.ReadableStream): Promise<FilePath>;
-    private parseFileName;
+    private transformedFile;
 }

package/lib/types/transform-context.js

@@ -1,30 +1,33 @@
-import { FileService } from "../infrastructure/file-service.js";
-import { getFileNameFromPath } from "../utils/utils.js";
-import { DestinationFormats } from "./api/transform.js";
-import { FileName } from "./file/fileName.js";
-import { FilePath } from "./file/filePath.js";
+import { FileService } from '../infrastructure/file-service.js';
+import { getFileNameFromPath } from '../utils/utils.js';
+import { DestinationFormats } from './api/transform.js';
+import { FileName } from './file/fileName.js';
+import { FilePath } from './file/filePath.js';
+/** Where `api transform` writes, inside the `--destination` it is given. */
+export const TRANSFORMATIONS_DIRECTORY_NAME = 'transformations';
+/** What `api transform` names its output: the input's name, then the format and its extension. */
+export function transformedFileName(file, format) {
+    const extension = DestinationFormats[format];
+    return new FileName(`${getFileNameFromPath(file.toString())}_${format}.${extension}`);
+}
 export class TransformContext {
+    destinationDirectory;
+    fileService = new FileService();
+    transformedApi;
     constructor(specFilePath, format, destinationDirectory) {
         this.destinationDirectory = destinationDirectory;
-        this.fileService = new FileService();
-        this.transformedApi = this.parseFileName(format, specFilePath);
-    }
-    get specPath() {
-        return new FilePath(this.destinationDirectory, this.transformedApi);
+        this.transformedApi = transformedFileName(specFilePath, format);
     }
     async exists() {
-        const transformedApiPath = new FilePath(this.destinationDirectory, this.transformedApi);
-        return await this.fileService.fileExists(transformedApiPath);
+        return await this.fileService.fileExists(this.transformedFile());
     }
     async save(stream) {
         await this.fileService.createDirectoryIfNotExists(this.destinationDirectory);
-        await this.fileService.writeFile(this.specPath, stream);
-        return this.specPath;
+        await this.fileService.writeFile(this.transformedFile(), stream);
+        return this.transformedFile();
     }
-    parseFileName(format, file) {
-        const destinationFileExt = DestinationFormats[format];
-        const destinationFilePrefix = getFileNameFromPath(file.toString());
-        return new FileName(`${destinationFilePrefix}_${format}.${destinationFileExt}`);
+    transformedFile() {
+        return new FilePath(this.destinationDirectory, this.transformedApi);
     }
 }
 //# sourceMappingURL=transform-context.js.map

package/lib/types/transform-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform-context.js","sourceRoot":"","sources":["../../src/types/transform-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,OAAO,gBAAgB;IAK3B,YAAY,YAAsB,EACtB,MAAqB,EACJ,oBAAmC;QAAnC,yBAAoB,GAApB,oBAAoB,CAAe;QAN/C,gBAAW,GAAG,IAAI,WAAW,EAAE,CAAC;QAO/C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjE,CAAC;IAED,IAAY,QAAQ;QAClB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACtE,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,MAAM,kBAAkB,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACxF,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAE/D,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAA6B;QAC7C,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC7E,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,aAAa,CAAC,MAAc,EAAE,IAAc;QAClD,MAAM,kBAAkB,GAAW,kBAAkB,CAAC,MAAyC,CAAC,CAAC;QACjG,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,OAAO,IAAI,QAAQ,CAAC,GAAG,qBAAqB,IAAI,MAAM,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAClF,CAAC;CACF"}
+{"version":3,"file":"transform-context.js","sourceRoot":"","sources":["../../src/types/transform-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,8BAA8B,GAAG,iBAAiB,CAAC;AAEhE,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,MAAqB;IACvE,MAAM,SAAS,GAAW,kBAAkB,CAAC,MAAyC,CAAC,CAAC;IACxF,OAAO,IAAI,QAAQ,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,OAAO,gBAAgB;IAKiD,oBAAoB;IAJ/E,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAEhC,cAAc,CAAW;IAE1C,YAAY,YAAsB,EAAE,MAAqB,EAAmB,oBAAmC;oCAAnC,oBAAoB;QAC9F,IAAI,CAAC,cAAc,GAAG,mBAAmB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAA6B;QAC7C,MAAM,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC7E,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACtE,CAAC;CACF"}

package/lib/utils/error-utils.d.ts

@@ -0,0 +1,2 @@
+/** The message of a caught value, which need not be an `Error`. */
+export declare function errorMessage(error: unknown): string;

package/lib/utils/error-utils.js

@@ -0,0 +1,5 @@
+/** The message of a caught value, which need not be an `Error`. */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=error-utils.js.map

package/lib/utils/error-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.js","sourceRoot":"","sources":["../../src/utils/error-utils.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/lib/utils/json-utils.d.ts

@@ -0,0 +1,2 @@
+export type JsonObject = Record<string, unknown>;
+export declare function isJsonObject(value: unknown): value is JsonObject;

package/lib/utils/json-utils.js

@@ -0,0 +1,4 @@
+export function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=json-utils.js.map

package/lib/utils/json-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.js","sourceRoot":"","sources":["../../src/utils/json-utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/lib/utils/string-utils.d.ts

@@ -1,2 +1,9 @@
 export declare const removeQuotes: (input: string) => string;
-export declare function stripAnsi(str: string): string;
+export declare function stripByteOrderMark(contents: string): string;
+declare const PROSE_LISTS: {
+    and: Intl.ListFormat;
+    or: Intl.ListFormat;
+};
+/** The items as a sentence lists them: `a`, `a and b`, `a, b and c`, or with `or` when they are choices. */
+export declare function listedInProse(items: readonly string[], joiner?: keyof typeof PROSE_LISTS): string;
+export {};

package/lib/utils/string-utils.js

@@ -7,31 +7,18 @@ export const removeQuotes = (input) => {
     }
     return input;
 };
-export function stripAnsi(str) {
-    let result = '';
-    let i = 0;
-    while (i < str.length) {
-        const char = str[i];
-        // Detect ESC (0x1B)
-        if (char === '\x1B' && str[i + 1] === '[') {
-            // We’re at the start of an ANSI sequence. Skip until 'm' or end.
-            i += 2; // skip ESC[
-            while (i < str.length && str[i] !== 'm') {
-                i++;
-            }
-            // Skip the 'm' itself
-            i++;
-        }
-        else if (char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127) {
-            // Skip other control chars (optional)
-            i++;
-        }
-        else {
-            // Normal printable char — keep it
-            result += char;
-            i++;
-        }
-    }
-    return result;
+// Editors on Windows, and PowerShell redirection, write a byte-order mark. `JSON.parse`
+// rejects it while the YAML parser strips it, so without this the same document is accepted
+// as `.yaml` and refused as `.json`.
+export function stripByteOrderMark(contents) {
+    return contents.codePointAt(0) === 0xfeff ? contents.slice(1) : contents;
+}
+const PROSE_LISTS = {
+    and: new Intl.ListFormat('en-GB', { type: 'conjunction' }),
+    or: new Intl.ListFormat('en-GB', { type: 'disjunction' })
+};
+/** The items as a sentence lists them: `a`, `a and b`, `a, b and c`, or with `or` when they are choices. */
+export function listedInProse(items, joiner = 'and') {
+    return PROSE_LISTS[joiner].format(items);
 }
 //# sourceMappingURL=string-utils.js.map

package/lib/utils/string-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE;IACpD,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzE,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,oBAAoB;QACpB,IAAI,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC1C,iEAAiE;YACjE,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;YACpB,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACxC,CAAC,EAAE,CAAC;YACN,CAAC;YACD,sBAAsB;YACtB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACjE,sCAAsC;YACtC,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,kCAAkC;YAClC,MAAM,IAAI,IAAI,CAAC;YACf,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE;IACpD,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzE,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,wFAAwF;AACxF,4FAA4F;AAC5F,qCAAqC;AACrC,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3E,CAAC;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC1D,EAAE,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;CAC1D,CAAC;AAEF,4GAA4G;AAC5G,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAAM,GAA6B,KAAK;IAC9F,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/lib/utils/utils.d.ts

@@ -1,5 +1,3 @@
-export declare const replaceHTML: (string: string) => string;
+export declare const replaceHTML: (html: string) => string;
 export declare const getFileNameFromPath: (filePath: string) => string;
-export declare function parseStreamBodyToJson(body: NodeJS.ReadableStream): Promise<unknown>;
 export declare function discardStreamBody(body: unknown): void;
-export declare const toPascalCase: (str: string) => string;