@apimatic/cli 1.2.1 → 1.3.0-beta.2

package/lib/prompts/sdk/publish.js

@@ -1,6 +1,7 @@
-import { log } from '@clack/prompts';
+import { log, spinner } from '@clack/prompts';
 import { PublishType } from '../../types/publish-api/publishing-profile-item.js';
-import { withSpinner } from '../prompt.js';
+import { noteWrapped, withSpinner } from '../prompt.js';
+import { format as f } from '../format.js';
 export class SdkPublishPrompts {
     publishSdk(fn) {
         return withSpinner('Publishing SDK', 'Publishing initiated.', 'SDK Publishing failed.', fn);
@@ -8,9 +9,74 @@ export class SdkPublishPrompts {
     sdkPublishingServiceError(serviceError) {
         log.error(serviceError.errorMessage);
     }
-    dryRunNotice(publishingProfile, language, version, publishType) {
-        const targets = publishType.map((t) => (t === PublishType.PackagePublishing ? 'Package' : 'Source Code')).join(' + ');
-        log.info(`You can publish this SDK by removing the --dry-run flag. It will be published for the following:\n\n  Profile:   ${publishingProfile}\n  Language:  ${language}\n  Version:   ${version}\n  Targets:   ${targets}`);
+    dryRunNotice(publishingSummary) {
+        log.info(`You can publish this SDK by removing the --dry-run flag. It will be published for the following:` +
+            publishingSummary);
     }
+    publishingRunningNotice(publishingSummary) {
+        log.info(`Publishing is running for the following:` + publishingSummary);
+    }
+    publishingLogsMessage(publishingLogUrl) {
+        const message = `To track progress and view publishing logs, please visit:
+${f.link(publishingLogUrl)}`;
+        noteWrapped(message, 'Publishing Logs');
+    }
+    async pollPublishingStatus(getSdkPublishingLogFn) {
+        const TERMINAL_STATES = new Set(['Succeeded', 'Failed', 'Exception', 'InternalError']);
+        const POLL_INTERVAL_MS = 10000; // poll after every 10 seconds.
+        let abortWait;
+        const spin = spinner({
+            onCancel: () => {
+                abortWait === null || abortWait === void 0 ? void 0 : abortWait();
+            },
+            cancelMessage: 'Publishing is still running on APIMatic and will continue without the CLI.'
+        });
+        spin.start('Waiting for publishing status...');
+        while (!spin.isCancelled) {
+            const publishingLogResult = await getSdkPublishingLogFn();
+            if (publishingLogResult.isErr()) {
+                spin.stop('Failed to fetch publishing status.', 1);
+                return 'failed';
+            }
+            const { events } = publishingLogResult.value;
+            const executionCompleted = events.every((event) => TERMINAL_STATES.has(event.eventType));
+            const statusMessage = [...events]
+                .sort((a, b) => (a.publishType === 'SourceCode' ? -1 : b.publishType === 'SourceCode' ? 1 : 0))
+                .map((event) => {
+                var _a;
+                const target = event.publishType === 'SourceCode' ? 'Source Code' : 'Package';
+                const eventLabels = {
+                    Queued: 'Queued',
+                    InProgress: 'In Progress',
+                    Succeeded: 'Published'
+                };
+                const label = (_a = eventLabels[event.eventType]) !== null && _a !== void 0 ? _a : 'Failed';
+                return `${target}: [${label}]`;
+            })
+                .join(' | ');
+            if (executionCompleted) {
+                const isExecutionSuccessful = events.every((event) => event.eventType === 'Succeeded');
+                spin.stop(statusMessage, isExecutionSuccessful ? 0 : 1);
+                return isExecutionSuccessful ? 'succeeded' : 'failed';
+            }
+            spin.message(statusMessage);
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, POLL_INTERVAL_MS);
+                abortWait = () => {
+                    clearTimeout(timer);
+                    resolve();
+                };
+            });
+            abortWait = undefined;
+        }
+        return 'cancelled';
+    }
+}
+export function formatPublishingDetails({ profile, language, version, publishType, codegenOption }) {
+    const targets = [...publishType]
+        .map((t) => (t === PublishType.PackagePublishing ? "Package" : "Source Code"))
+        .join(" + ");
+    const generator = codegenOption ? `\n  Generator: ${codegenOption}` : "";
+    return `\n\n  Profile:   ${profile}\n  Language:  ${language}\n  Version:   ${version}\n  Targets:   ${targets}${generator}`;
 }
 //# sourceMappingURL=publish.js.map

package/lib/prompts/sdk/publish.js.map

@@ -1 +1 @@
-{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/prompts/sdk/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAIrC,OAAO,EAAE,WAAW,EAAE,MAAM,oDAAoD,CAAC;AAGjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,OAAO,iBAAiB;IACrB,UAAU,CAAC,EAAiD;QACjE,OAAO,WAAW,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAEM,yBAAyB,CAAC,YAA0B;QACzD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAEM,YAAY,CAAC,iBAAoC,EAAE,QAAkB,EAAE,OAAmB,EAAE,WAA0B;QAC3H,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtH,GAAG,CAAC,IAAI,CACN,oHAAoH,iBAAiB,kBAAkB,QAAQ,kBAAkB,OAAO,kBAAkB,OAAO,EAAE,CACpN,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/prompts/sdk/publish.ts"],"names":[],"mappings":"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"}

package/lib/types/file/directory.d.ts

@@ -18,6 +18,9 @@ export declare class Directory {
     toTreeNode(): TreeNode;
     mapFilesInDirectory(map: (rootDir: DirectoryPath, fileItem: FileItem) => Promise<FileItem | undefined>): Promise<Directory>;
     isEmpty(): boolean;
+    excluding(names: FileName[]): Directory;
+    countFiles(): number;
+    countDirectories(): number;
     getAllFiles(): FilePath[];
     parseContentFolder(baseContentPath: DirectoryPath): Promise<TocGroup[]>;
     private getPageName;

package/lib/types/file/directory.js

@@ -48,6 +48,19 @@ export class Directory {
     isEmpty() {
         return this.items.length === 0;
     }
+    excluding(names) {
+        const excluded = names.map((name) => name.toString());
+        const kept = this.items.filter((item) => item instanceof Directory
+            ? !excluded.includes(item.directoryPath.leafName())
+            : !excluded.includes(item.fileName.toString()));
+        return new Directory(this.directoryPath, kept);
+    }
+    countFiles() {
+        return this.items.reduce((total, item) => total + (item instanceof Directory ? item.countFiles() : 1), 0);
+    }
+    countDirectories() {
+        return this.items.reduce((total, item) => total + (item instanceof Directory ? 1 + item.countDirectories() : 0), 0);
+    }
     getAllFiles() {
         const files = [];
         for (const item of this.items) {

package/lib/types/file/directory.js.map

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

package/lib/types/plugin/generation-status.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Context plugin generation reports its own status vocabulary, which does not match the
+ * shared `Status` enum in `@apimatic/sdk`: there is no `SubscriptionError` (entitlement is
+ * a 403 on the generate call instead), and the in-flight values below have no equivalent.
+ * `Completed` is not sent on the wire — as with portal generation, a finished run is a 302
+ * to the download endpoint, which `getGenerationStatus` maps onto it.
+ */
+export declare enum PluginGenerationStatus {
+    Queued = "Queued",
+    ExecutionStarted = "ExecutionStarted",
+    GeneratingArtifacts = "GeneratingArtifacts",
+    Completed = "Completed",
+    Failed = "Failed",
+    ValidationError = "ValidationError",
+    Unknown = "Unknown"
+}
+export interface PluginGenerationStatusResponse {
+    status: PluginGenerationStatus;
+    errors?: Record<string, string[]>;
+}
+export interface PluginGenerationInitiatedResponse {
+    id: string;
+}

package/lib/types/plugin/generation-status.js

@@ -0,0 +1,18 @@
+/**
+ * Context plugin generation reports its own status vocabulary, which does not match the
+ * shared `Status` enum in `@apimatic/sdk`: there is no `SubscriptionError` (entitlement is
+ * a 403 on the generate call instead), and the in-flight values below have no equivalent.
+ * `Completed` is not sent on the wire — as with portal generation, a finished run is a 302
+ * to the download endpoint, which `getGenerationStatus` maps onto it.
+ */
+export var PluginGenerationStatus;
+(function (PluginGenerationStatus) {
+    PluginGenerationStatus["Queued"] = "Queued";
+    PluginGenerationStatus["ExecutionStarted"] = "ExecutionStarted";
+    PluginGenerationStatus["GeneratingArtifacts"] = "GeneratingArtifacts";
+    PluginGenerationStatus["Completed"] = "Completed";
+    PluginGenerationStatus["Failed"] = "Failed";
+    PluginGenerationStatus["ValidationError"] = "ValidationError";
+    PluginGenerationStatus["Unknown"] = "Unknown";
+})(PluginGenerationStatus || (PluginGenerationStatus = {}));
+//# sourceMappingURL=generation-status.js.map

package/lib/types/plugin/generation-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-status.js","sourceRoot":"","sources":["../../../src/types/plugin/generation-status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,sBAQX;AARD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,+DAAqC,CAAA;IACrC,qEAA2C,CAAA;IAC3C,iDAAuB,CAAA;IACvB,2CAAiB,CAAA;IACjB,6DAAmC,CAAA;IACnC,6CAAmB,CAAA;AACrB,CAAC,EARW,sBAAsB,KAAtB,sBAAsB,QAQjC"}

package/lib/types/plugin/language-entry.d.ts

@@ -0,0 +1,9 @@
+import { GitConfiguration, PackageConfigurationForLanguage } from '../publish/package-settings-configuration.js';
+import { SemVersion } from '../publish/version.js';
+import { CodeGenerationVersion, Language } from '../sdk/generate.js';
+import { PluginLanguageEntry } from './plugin-config.js';
+/**
+ * The version rides inside the package block, so a source-only publish records no version at all —
+ * there is no package for it to describe.
+ */
+export declare function buildLanguageEntry<L extends Language>(language: L, gitConfiguration: GitConfiguration | undefined, packageConfiguration: PackageConfigurationForLanguage[L] | undefined, packageVersion: SemVersion, codegenVersion: CodeGenerationVersion): PluginLanguageEntry<L>;

package/lib/types/plugin/language-entry.js

@@ -0,0 +1,64 @@
+import { Language } from '../sdk/generate.js';
+const GITHUB_BASE_URL = 'https://github.com';
+/**
+ * One builder per language, each checked against that language's own profile fields and its own
+ * entry shape. A single builder taking every language's configuration at once can only reach those
+ * fields through a cast, which is what let a mismatched pair compile.
+ */
+const languageEntryBuilders = {
+    [Language.CSHARP]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.packageId) ? { packageId: configuration.packageId, version } : undefined,
+        codegenVersion
+    }),
+    [Language.JAVA]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.groupId) && configuration.artifactId
+            ? { groupId: configuration.groupId, artifactId: configuration.artifactId, version }
+            : undefined,
+        codegenVersion
+    }),
+    [Language.PHP]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.vendorName) && configuration.projectName
+            ? { vendorName: configuration.vendorName, projectName: configuration.projectName, version }
+            : undefined,
+        codegenVersion
+    }),
+    [Language.PYTHON]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.name) ? { name: configuration.name, version } : undefined,
+        codegenVersion
+    }),
+    [Language.RUBY]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.name) ? { name: configuration.name, version } : undefined,
+        codegenVersion
+    }),
+    [Language.TYPESCRIPT]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.name) ? { name: configuration.name, version } : undefined,
+        codegenVersion
+    }),
+    [Language.GO]: (source, configuration, version, codegenVersion) => ({
+        source,
+        package: (configuration === null || configuration === void 0 ? void 0 : configuration.packageName) ? { packageName: configuration.packageName, version } : undefined,
+        codegenVersion
+    })
+};
+/**
+ * The version rides inside the package block, so a source-only publish records no version at all —
+ * there is no package for it to describe.
+ */
+export function buildLanguageEntry(language, gitConfiguration, packageConfiguration, packageVersion, codegenVersion) {
+    var _a;
+    const repositoryName = (_a = gitConfiguration === null || gitConfiguration === void 0 ? void 0 : gitConfiguration.repositoryName) === null || _a === void 0 ? void 0 : _a.trim();
+    const source = repositoryName
+        ? {
+            repositoryUrl: `${GITHUB_BASE_URL}/${repositoryName}`,
+            branch: (gitConfiguration === null || gitConfiguration === void 0 ? void 0 : gitConfiguration.branch) ? gitConfiguration.branch : undefined
+        }
+        : undefined;
+    return languageEntryBuilders[language](source, packageConfiguration, packageVersion.toString(), codegenVersion);
+}
+//# sourceMappingURL=language-entry.js.map

package/lib/types/plugin/language-entry.js.map

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

package/lib/types/plugin/plugin-config.d.ts

@@ -0,0 +1,72 @@
+import { SemVersionString } from '../publish/version.js';
+import { CodeGenerationVersion, Language } from '../sdk/generate.js';
+/** Written unprompted: the backend consumes it, and nothing in the CLI asks for it. */
+export declare const DEFAULT_PLUGIN_LICENSE = "MIT";
+export interface PluginAuthor {
+    name: string;
+    email?: string;
+}
+export interface LanguageSource {
+    repositoryUrl: string;
+    branch?: string;
+}
+interface CSharpPackageConfig {
+    packageId: string;
+    version: SemVersionString;
+}
+interface JavaPackageConfig {
+    groupId: string;
+    artifactId: string;
+    version: SemVersionString;
+}
+interface PhpPackageConfig {
+    vendorName: string;
+    projectName: string;
+    version: SemVersionString;
+}
+interface NamedPackageConfig {
+    name: string;
+    version: SemVersionString;
+}
+type PythonPackageConfig = NamedPackageConfig;
+type RubyPackageConfig = NamedPackageConfig;
+type TypeScriptPackageConfig = NamedPackageConfig;
+interface GoPackageConfig {
+    packageName: string;
+    version: SemVersionString;
+}
+interface PluginConfig<TPackage> {
+    source?: LanguageSource;
+    package?: TPackage;
+    codegenVersion: CodeGenerationVersion;
+}
+interface PluginConfigForLanguage {
+    [Language.CSHARP]: PluginConfig<CSharpPackageConfig>;
+    [Language.JAVA]: PluginConfig<JavaPackageConfig>;
+    [Language.PHP]: PluginConfig<PhpPackageConfig>;
+    [Language.PYTHON]: PluginConfig<PythonPackageConfig>;
+    [Language.RUBY]: PluginConfig<RubyPackageConfig>;
+    [Language.TYPESCRIPT]: PluginConfig<TypeScriptPackageConfig>;
+    [Language.GO]: PluginConfig<GoPackageConfig>;
+}
+export type PluginLanguageEntry<L extends Language> = PluginConfigForLanguage[L];
+export type PluginLanguages = Partial<PluginConfigForLanguage>;
+export interface PluginConfigData {
+    pluginId?: string;
+    pluginName?: string;
+    pluginVersion?: string;
+    pluginKey?: string;
+    author?: PluginAuthor;
+    license?: string;
+    homepage?: string;
+    repository?: string;
+    languages: PluginLanguages;
+    [key: string]: unknown;
+}
+/** The fields the CLI asks for; everything else is derived, resolved or constant. */
+export interface PluginMetadata {
+    pluginId: string;
+    pluginName: string;
+    pluginVersion: string;
+}
+export {};

package/lib/types/plugin/plugin-config.js

@@ -0,0 +1,4 @@
+import { Language } from '../sdk/generate.js';
+/** Written unprompted: the backend consumes it, and nothing in the CLI asks for it. */
+export const DEFAULT_PLUGIN_LICENSE = 'MIT';
+//# sourceMappingURL=plugin-config.js.map

package/lib/types/plugin/plugin-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-config.js","sourceRoot":"","sources":["../../../src/types/plugin/plugin-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAErE,uFAAuF;AACvF,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC"}

package/lib/types/plugin/plugin-contents.d.ts

@@ -0,0 +1,5 @@
+/** What a publish is about to expose, counted recursively and excluding the repository itself. */
+export interface PluginContents {
+    fileCount: number;
+    directoryCount: number;
+}

package/lib/types/plugin/plugin-contents.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-contents.js.map

package/lib/types/plugin/plugin-contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contents.js","sourceRoot":"","sources":["../../../src/types/plugin/plugin-contents.ts"],"names":[],"mappings":""}

package/lib/types/plugin-config-context.d.ts

@@ -0,0 +1,63 @@
+import { DirectoryPath } from './file/directoryPath.js';
+import { FilePath } from './file/filePath.js';
+import { CodeGenerationVersion, Language } from './sdk/generate.js';
+import { PluginAuthor, PluginConfigData, PluginLanguageEntry, PluginMetadata } from './plugin/plugin-config.js';
+import { SemVersion } from './publish/version.js';
+import { Result } from 'neverthrow';
+/** Also the rule the metadata prompt validates against, so a plugin ID is legal as a repository name. */
+export declare const PLUGIN_ID_PATTERN: RegExp;
+export type PluginReleaseData = {
+    pluginId: string;
+    version: SemVersion;
+};
+/**
+ * What a caller needs to know before generating. Metadata and languages are written by different
+ * commands — `plugin generate` owns the first, `sdk publish` the second — so they are reported
+ * separately. `path` rides on `unreadable` purely so the prompt can say where to fix the file.
+ */
+export type PluginConfigState = {
+    state: 'missing';
+} | {
+    state: 'unreadable';
+    reason: string;
+    path: FilePath;
+} | PluginConfigPresent;
+export declare class PluginConfigPresent {
+    private readonly config;
+    readonly state: "present";
+    private constructor();
+    static create(config: PluginConfigData): PluginConfigPresent;
+    hasPublishedSdks(): boolean;
+    hasMetadata(): boolean;
+    /**
+     * Absent until `plugin generate` records the identity. The fields are checked rather than trusted:
+     * they reach this class through a cast of parsed JSON, so a hand-edited config can hold a number
+     * where the type promises a string.
+     */
+    getRelease(): PluginReleaseData | undefined;
+    hasNoSourceRepository(language: Language): boolean;
+    assertNoCodegenVersionMismatch(codegenVersion: CodeGenerationVersion, language: Language, entry: PluginLanguageEntry<Language>): Result<void, {
+        expected: CodeGenerationVersion;
+        actual: CodeGenerationVersion;
+    }>;
+}
+export type PluginConfigWriteFailure = 'unreadable' | 'unwritable';
+export declare class PluginConfigContext {
+    private readonly buildDirectory;
+    private readonly fileService;
+    constructor(buildDirectory: DirectoryPath);
+    private get configPath();
+    getPluginConfigState(): Promise<PluginConfigState>;
+    upsertMetadata(metadata: PluginMetadata, author?: PluginAuthor): Promise<Result<PluginConfigPresent, PluginConfigWriteFailure>>;
+    upsertLanguage<L extends Language>(language: L, entry: PluginLanguageEntry<L>): Promise<Result<PluginConfigPresent, PluginConfigWriteFailure>>;
+    /**
+     * A file that exists but cannot be parsed is left alone rather than overwritten, and a write
+     * fault is reported rather than thrown: this runs after a publish that already succeeded, and
+     * nothing here may turn that into a crash. A success carries the config as it now stands, so a
+     * caller that has to decide something after writing does not have to read the file back.
+     */
+    private merge;
+    private read;
+    private parse;
+    private write;
+}

package/lib/types/plugin-config-context.js

@@ -0,0 +1,179 @@
+import { FileService } from '../infrastructure/file-service.js';
+import { FileName } from './file/fileName.js';
+import { FilePath } from './file/filePath.js';
+import { DEFAULT_PLUGIN_LICENSE } from './plugin/plugin-config.js';
+import { SemVersion } from './publish/version.js';
+import { err, ok } from 'neverthrow';
+/** Also the rule the metadata prompt validates against, so a plugin ID is legal as a repository name. */
+export const PLUGIN_ID_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const MALFORMED_PLUGIN_ID = `its 'pluginId' must be lower-case alphanumeric words separated by single dashes, ` +
+    `for example 'acme-payments'`;
+const MALFORMED_PLUGIN_VERSION = `its 'pluginVersion' must be a version in the format major.minor.patch, for example '0.1.0'`;
+export class PluginConfigPresent {
+    constructor(config) {
+        this.config = config;
+        this.state = 'present';
+    }
+    static create(config) {
+        return new PluginConfigPresent(config);
+    }
+    hasPublishedSdks() {
+        const languages = this.config.languages;
+        if (typeof languages !== 'object' || languages === null) {
+            return false;
+        }
+        return Object.values(languages).some((entry) => (entry === null || entry === void 0 ? void 0 : entry.source) || (entry === null || entry === void 0 ? void 0 : entry.package));
+    }
+    hasMetadata() {
+        const isNonBlankString = (value) => typeof value === 'string' && value.trim() !== '';
+        return isNonBlankString(this.config.pluginId) && isNonBlankString(this.config.pluginName);
+    }
+    /**
+     * Absent until `plugin generate` records the identity. The fields are checked rather than trusted:
+     * they reach this class through a cast of parsed JSON, so a hand-edited config can hold a number
+     * where the type promises a string.
+     */
+    getRelease() {
+        const pluginId = typeof this.config.pluginId === 'string' ? this.config.pluginId.trim() : '';
+        const rawVersion = typeof this.config.pluginVersion === 'string' ? this.config.pluginVersion.trim() : '';
+        if (pluginId === '' || rawVersion === '') {
+            return undefined;
+        }
+        return SemVersion.tryCreate(rawVersion).match((version) => ({ pluginId, version }), () => undefined);
+    }
+    hasNoSourceRepository(language) {
+        var _a, _b;
+        return !((_b = (_a = this.config.languages) === null || _a === void 0 ? void 0 : _a[language]) === null || _b === void 0 ? void 0 : _b.source);
+    }
+    assertNoCodegenVersionMismatch(codegenVersion, language, entry) {
+        var _a, _b, _c;
+        if (entry.package && entry.source) {
+            return ok(); // if both package and source are given, there is no possible mismatch
+        }
+        const existingEntry = (_a = this.config.languages) === null || _a === void 0 ? void 0 : _a[language];
+        if (!existingEntry) {
+            return ok();
+        }
+        if (!existingEntry.package && !existingEntry.source) {
+            return ok();
+        }
+        const extractedVersion = (_c = (_b = this.config.languages) === null || _b === void 0 ? void 0 : _b[language]) === null || _c === void 0 ? void 0 : _c.codegenVersion;
+        if (!extractedVersion) {
+            return ok();
+        }
+        if (extractedVersion === codegenVersion) {
+            return ok();
+        }
+        return err({ expected: codegenVersion, actual: extractedVersion });
+    }
+}
+function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export class PluginConfigContext {
+    constructor(buildDirectory) {
+        this.buildDirectory = buildDirectory;
+        this.fileService = new FileService();
+    }
+    get configPath() {
+        return new FilePath(this.buildDirectory, new FileName('plugin-config.json'));
+    }
+    async getPluginConfigState() {
+        if (!(await this.fileService.fileExists(this.configPath))) {
+            return { state: 'missing' };
+        }
+        const parsed = await this.parse();
+        if ('reason' in parsed) {
+            return { state: 'unreadable', reason: parsed.reason, path: this.configPath };
+        }
+        return PluginConfigPresent.create(parsed.config);
+    }
+    async upsertMetadata(metadata, author) {
+        return await this.merge((config) => {
+            var _a;
+            return (Object.assign(Object.assign(Object.assign(Object.assign({}, config), { pluginId: metadata.pluginId, pluginName: metadata.pluginName, pluginVersion: metadata.pluginVersion }), (!config.author && author && { author })), { license: (_a = config.license) !== null && _a !== void 0 ? _a : DEFAULT_PLUGIN_LICENSE }));
+        });
+    }
+    async upsertLanguage(language, entry) {
+        return await this.merge((config) => {
+            var _a, _b, _c;
+            const languages = Object.assign({}, config.languages);
+            const existingEntry = (_a = config.languages) === null || _a === void 0 ? void 0 : _a[language];
+            languages[language] = Object.assign(Object.assign(Object.assign({}, existingEntry), entry), { source: (_b = entry.source) !== null && _b !== void 0 ? _b : existingEntry === null || existingEntry === void 0 ? void 0 : existingEntry.source, package: (_c = entry.package) !== null && _c !== void 0 ? _c : existingEntry === null || existingEntry === void 0 ? void 0 : existingEntry.package });
+            return Object.assign(Object.assign({}, config), { languages });
+        });
+    }
+    /**
+     * A file that exists but cannot be parsed is left alone rather than overwritten, and a write
+     * fault is reported rather than thrown: this runs after a publish that already succeeded, and
+     * nothing here may turn that into a crash. A success carries the config as it now stands, so a
+     * caller that has to decide something after writing does not have to read the file back.
+     */
+    async merge(apply) {
+        const existing = await this.read();
+        if ('reason' in existing) {
+            return err('unreadable');
+        }
+        const merged = apply(existing.config);
+        try {
+            await this.write(merged);
+        }
+        catch (_a) {
+            return err('unwritable');
+        }
+        return ok(PluginConfigPresent.create(merged));
+    }
+    async read() {
+        if (!(await this.fileService.fileExists(this.configPath))) {
+            return { config: { languages: {} } };
+        }
+        return await this.parse();
+    }
+    async parse() {
+        const BYTE_ORDER_MARK = 0xfeff; // Notepad and PowerShell redirection can write it
+        try {
+            // TODO: JSON Parsing/Stringify should be in a dedicated JSON infra layer which preferably uses zod
+            const contents = await this.fileService.getContents(this.configPath);
+            if (contents.trim() === '') {
+                return { reason: 'it is empty' };
+            }
+            if (contents.codePointAt(0) === BYTE_ORDER_MARK) {
+                return { reason: 'it starts with a byte-order mark, which JSON does not allow' };
+            }
+            const parsed = JSON.parse(contents);
+            if (!isJsonObject(parsed)) {
+                return { reason: 'it is not a JSON object' };
+            }
+            // Every write merges these by spreading them, which turns a string into `{"0":"a"}` and a
+            // number into nothing, so a wrong shape has to be refused before it can corrupt the file.
+            const languages = parsed.languages;
+            if (languages !== undefined) {
+                if (!isJsonObject(languages)) {
+                    return { reason: `its 'languages' field is not a JSON object` };
+                }
+                for (const [language, entry] of Object.entries(languages)) {
+                    if (!isJsonObject(entry)) {
+                        return { reason: `its 'languages.${language}' entry is not a JSON object` };
+                    }
+                }
+            }
+            const id = parsed.pluginId;
+            if (typeof id === 'string' && (id.trim() === '' || !PLUGIN_ID_PATTERN.test(id))) {
+                return { reason: MALFORMED_PLUGIN_ID };
+            }
+            const rawVersion = parsed.pluginVersion;
+            if (typeof rawVersion === 'string' && (rawVersion.trim() === '' || SemVersion.tryCreate(rawVersion).isErr())) {
+                return { reason: MALFORMED_PLUGIN_VERSION };
+            }
+            return { config: parsed };
+        }
+        catch (error) {
+            return { reason: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async write(config) {
+        await this.fileService.ensurePathExists(this.configPath);
+        await this.fileService.writeContents(this.configPath, JSON.stringify(config, null, 2));
+    }
+}
+//# sourceMappingURL=plugin-config-context.js.map