@apimatic/cli 1.1.0-beta.9 → 1.2.0

package/lib/prompts/sdk/publish.js

@@ -0,0 +1,16 @@
+import { log } from '@clack/prompts';
+import { PublishType } from '../../types/publish-api/publishing-profile-item.js';
+import { withSpinner } from '../prompt.js';
+export class SdkPublishPrompts {
+    publishSdk(fn) {
+        return withSpinner('Publishing SDK', 'Publishing initiated.', 'SDK Publishing failed.', fn);
+    }
+    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}`);
+    }
+}
+//# sourceMappingURL=publish.js.map

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

@@ -0,0 +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"}

package/lib/prompts/sdk/quickstart.d.ts

@@ -21,8 +21,11 @@ export declare class SdkQuickstartPrompts {
     useDefaultSpecPrompt(): Promise<boolean>;
     fixYourSpec(): void;
     selectLanguageStep(): void;
-    selectLanguagePrompt(): Promise<Language | undefined>;
+    selectLanguagePrompt(allowedLanguages: Language[]): Promise<Language | undefined>;
+    noLanguagesAvailableOnPlan(): void;
+    private languagesNotOnPlanNote;
     noLanguageSelected(): void;
+    accountInfoFetchFailed(serviceError: ServiceError): void;
     selectInputDirectoryStep(): void;
     inputDirectoryPathPrompt(): Promise<DirectoryPath | undefined>;
     noInputDirectoryProvided(): void;

package/lib/prompts/sdk/quickstart.js

@@ -4,9 +4,10 @@ import { noteWrapped, withSpinner } from "../prompt.js";
 import { createResourceInputFromInput } from "../../types/file/resource-input.js";
 import { DirectoryPath } from "../../types/file/directoryPath.js";
 import { removeQuotes } from "../../utils/string-utils.js";
-import { Language } from "../../types/sdk/generate.js";
+import { LANGUAGE_CHOICES } from "../../types/sdk/generate.js";
 const vscodeExtensionUrl = "https://marketplace.visualstudio.com/items?itemName=apimatic-developers.apimatic-for-vscode";
 const sdkCustomizationUrl = "https://docs.apimatic.io/generate-sdks/codegen-settings/codegen-settings-overview/";
+const pricingUrl = "https://www.apimatic.io/pricing";
 export class SdkQuickstartPrompts {
     importSpecStep() {
         log.info(`Step 1 of 4: Import your OpenAPI Definition`);
@@ -41,7 +42,7 @@ export class SdkQuickstartPrompts {
             "To continue:",
             "- Remove these components from your API Specification and re-run this command.",
             "- Combine your split API Specification files into a single file. We can automatically remove unsupported components from single-file specs.",
-            "- Upgrade your subscription to unlock additional features: https://www.apimatic.io/pricing"
+            `- Upgrade your subscription to unlock additional features: ${f.link(pricingUrl)}`
         ].join("\n");
         log.info(message);
     }
@@ -59,7 +60,7 @@ export class SdkQuickstartPrompts {
             endpointMessage,
             "",
             "You won't see these components in the generated SDKs or documentation.",
-            "Want to keep them? Upgrade your subscription to unlock additional features: https://www.apimatic.io/pricing"
+            `Want to keep them? Upgrade your subscription to unlock additional features: ${f.link(pricingUrl)}`
         ].join("\n");
         log.info(message);
     }
@@ -104,27 +105,43 @@ export class SdkQuickstartPrompts {
     selectLanguageStep() {
         log.info(`Step 3 of 4: Select programming language`);
     }
-    async selectLanguagePrompt() {
+    async selectLanguagePrompt(allowedLanguages) {
+        const allowed = new Set(allowedLanguages);
+        const available = LANGUAGE_CHOICES.filter(({ value }) => allowed.has(value));
+        const excluded = LANGUAGE_CHOICES.filter(({ value }) => !allowed.has(value));
+        if (excluded.length > 0) {
+            log.info(this.languagesNotOnPlanNote(excluded.map(({ label }) => label)));
+        }
         const language = await select({
             message: "Choose the programming language for your SDK:",
-            options: [
-                { 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 }
-            ]
+            options: available.map(({ label, value }) => ({ label, value }))
         });
         if (isCancel(language)) {
             return undefined;
         }
         return language;
     }
+    noLanguagesAvailableOnPlan() {
+        const message = [
+            "You're on the Free plan.",
+            `Upgrade your subscription to get started: ${f.link(pricingUrl)}`
+        ].join("\n");
+        log.warn(message);
+    }
+    languagesNotOnPlanNote(languages) {
+        return [
+            `The following languages aren't included in your current subscription plan:`,
+            ...languages.map((language) => `  • ${language}`),
+            "",
+            `Upgrade your subscription to unlock them: ${f.link(pricingUrl)}`
+        ].join("\n");
+    }
     noLanguageSelected() {
         log.error("No programming language was selected.");
     }
+    accountInfoFetchFailed(serviceError) {
+        log.error(`Failed to fetch your account information. ${serviceError.errorMessage}`);
+    }
     selectInputDirectoryStep() {
         log.info(`Step 4 of 4: Setup directory for SDK Generation`);
     }

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

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

package/lib/prompts/sdk/save-changes.d.ts

@@ -0,0 +1,21 @@
+import { DirectoryPath } from "../../types/file/directoryPath.js";
+import { FilePath } from "../../types/file/filePath.js";
+import { Directory } from "../../types/file/directory.js";
+export declare class SaveChangesPrompts {
+    srcDirectoryEmpty(directory: DirectoryPath): void;
+    invalidSdkDirectory(directory: DirectoryPath): void;
+    invalidVersionedDocsDirectory(directory: DirectoryPath): void;
+    apiVersionOnlyApplicableWithVersionedBuild(): void;
+    versionNotFound(): void;
+    selectVersion(versions: string[]): Promise<string | undefined>;
+    sdkSourceTreeNotFound(language: string): void;
+    operationCancelled(): void;
+    directoryStillOpen(directory: DirectoryPath): Promise<void>;
+    modifiedFilesDetected(directory: Directory): void;
+    confirmReviewChanges(): Promise<boolean>;
+    noChangesDetected(): void;
+    openingDirectoryToReviewChanges(): void;
+    reviewChangesManually(tempDirectory: DirectoryPath): Promise<void>;
+    confirmSaveChanges(): Promise<boolean>;
+    changesSaved(sourceTreePath: FilePath): void;
+}

package/lib/prompts/sdk/save-changes.js

@@ -0,0 +1,84 @@
+import { log, isCancel, select, confirm } from "@clack/prompts";
+import { format as f, getTree } from "../format.js";
+import { noteWrapped } from "../prompt.js";
+export class SaveChangesPrompts {
+    srcDirectoryEmpty(directory) {
+        const message = `The ${f.var("src")} directory is either empty or invalid: ${f.path(directory)}`;
+        log.error(message);
+    }
+    invalidSdkDirectory(directory) {
+        const message = `SDK directory does not exist: ${f.path(directory)}`;
+        log.error(message);
+    }
+    invalidVersionedDocsDirectory(directory) {
+        const message = `The ${f.var("versioned_docs")} directory is either empty or invalid: ${f.path(directory)}`;
+        log.error(message);
+    }
+    apiVersionOnlyApplicableWithVersionedBuild() {
+        log.warn(`The ${f.flag("api-version")} is only applicable with a versioned build.`);
+    }
+    versionNotFound() {
+        log.error(`The selected API version is invalid.`);
+    }
+    async selectVersion(versions) {
+        const version = await select({
+            message: "Select an API version to save SDK changes into:",
+            options: versions.map((v) => ({ label: v, value: v }))
+        });
+        if (isCancel(version)) {
+            return undefined;
+        }
+        return version;
+    }
+    sdkSourceTreeNotFound(language) {
+        log.error(`No 'sdk-source-tree' found for ${f.var(language)}. You need to generate the SDK with change tracking enabled before you can save changes.`);
+        const message = `Generate the SDK with change tracking by running:
+'${f.cmdAlt("apimatic", "sdk", "generate")} ${f.flag("language", language)} ${f.flag("track-changes")}'
+Then customize your SDK and run ${f.cmdAlt("apimatic", "sdk", "save-changes")} again.`;
+        noteWrapped(message, "Next Steps");
+    }
+    operationCancelled() {
+        log.warn("Exiting without saving any changes.");
+    }
+    async directoryStillOpen(directory) {
+        log.info(`Please close all applications using the directory ${f.path(directory)} to allow cleanup of temporary files.`);
+    }
+    modifiedFilesDetected(directory) {
+        log.info(`Detected changes in the following file(s):
+  ${getTree(directory.toTreeNode())}`);
+    }
+    async confirmReviewChanges() {
+        const confirmed = await confirm({
+            message: `Do you want to review these changes?`,
+            initialValue: false
+        });
+        if (isCancel(confirmed)) {
+            return false;
+        }
+        return confirmed;
+    }
+    noChangesDetected() {
+        log.info("No changes detected in the SDK.");
+    }
+    openingDirectoryToReviewChanges() {
+        log.info(`Opening the changed files in VS Code for review. Close the editor to proceed.`);
+    }
+    async reviewChangesManually(tempDirectory) {
+        log.info(`Review the changes at ${f.path(tempDirectory)} to proceed.`);
+    }
+    async confirmSaveChanges() {
+        const confirmed = await confirm({
+            message: `Do you want to save these changes?`,
+            initialValue: true
+        });
+        if (isCancel(confirmed)) {
+            return false;
+        }
+        return confirmed;
+    }
+    changesSaved(sourceTreePath) {
+        log.success(`Changes saved successfully at ${f.path(sourceTreePath)}.`);
+        log.info(`Your saved changes will reapply automatically the next time you generate this SDK.`);
+    }
+}
+//# sourceMappingURL=save-changes.js.map

package/lib/prompts/sdk/save-changes.js.map

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

package/lib/types/api/account.d.ts

@@ -6,5 +6,6 @@ export interface SubscriptionInfo {
     tenantId: string;
     allowedLanguages: number;
     isPackagePublishingAllowed: boolean;
+    isOnPremGenerationAllowed: boolean;
     ApiCopilotKeys: string[];
 }

package/lib/types/build/build.d.ts

@@ -1,7 +1,11 @@
 import { DirectoryPath } from "../file/directoryPath.js";
-export interface BuildConfig {
+import { UrlPath } from "../file/urlPath.js";
+export interface BuildConfigData {
     generatePortal?: PortalConfig;
+    generateVersionedPortal?: object;
+    versionsPath?: string;
     apiCopilotConfig?: CopilotConfig;
+    recipes?: RecipesConfig;
     [key: string]: unknown;
 }
 export interface PortalConfig {
@@ -9,14 +13,90 @@ export interface PortalConfig {
     languageConfig: {
         [key: string]: object;
     };
-    [key: string]: unknown;
+    /** URL where the portal will be hosted. Mirrors `generatePortal.baseUrl` in codegen. */
+    baseUrl?: string;
+    /** Portal UI settings. Mirrors `generatePortal.portalSettings` in codegen. */
+    portalSettings?: PortalSettingsData;
     apiSpecPath?: DirectoryPath;
+    [key: string]: unknown;
+}
+export interface PortalSettingsData {
+    /** Base URL for the API calls made by the portal. Preferred over `generatePortal.baseUrl` for portal artifacts. */
+    baseUrl?: string;
+    /** Language/template id the portal opens on first load. */
+    initialPlatform?: string;
+    /** Per-language portal settings, keyed by language/template id. */
+    languageSettings?: {
+        [language: string]: LanguageSettingData;
+    };
+    [key: string]: unknown;
+}
+export interface LanguageSettingData {
+    aiIntegration?: AiIntegration;
+    [key: string]: unknown;
+}
+export interface AiIntegration {
+    cursor?: AiIntegrationSetting;
+    claudeCode?: AiIntegrationSetting;
+    vscode?: AiIntegrationSetting;
+}
+export interface AiIntegrationSetting {
+    isEnabled: boolean;
+    stabilityLevelTag?: string;
 }
 export interface CopilotConfig {
     isEnabled: boolean;
     key: string;
     welcomeMessage: string;
 }
+export interface RecipesConfig {
+    workflows?: RecipeWorkflow[];
+}
+export interface RecipeWorkflow {
+    name: string;
+    permalink: string;
+    functionName: string;
+    scriptPath: string;
+}
 export declare function getLanguagesConfig(selectedLanguages: string[]): {
     [key: string]: object;
 };
+export declare class LanguageSetting {
+    private readonly data;
+    private constructor();
+    static from(data?: LanguageSettingData): LanguageSetting;
+    /** Returns a copy with all AI editor integrations (Cursor/Claude Code/VS Code) enabled. */
+    withAiIntegrationsEnabled(): LanguageSetting;
+    toLanguageSettingData(): LanguageSettingData;
+}
+export declare class PortalSettings {
+    private readonly data;
+    private constructor();
+    static from(data?: PortalSettingsData): PortalSettings;
+    /** Returns a copy with the API-call base URL set. */
+    withBaseUrl(baseUrl: UrlPath): PortalSettings;
+    withAiIntegrations(languages: string[]): PortalSettings;
+    toPortalSettingsData(): PortalSettingsData;
+}
+export declare class BuildConfig {
+    private readonly data;
+    private constructor();
+    static parse(json: string): BuildConfig;
+    static from(data: BuildConfigData): BuildConfig;
+    toJSON(): BuildConfigData;
+    /** Content directory for the portal, relative to the build directory. Defaults to "content". */
+    contentFolder(): string;
+    /** True when this build produces a multi-versioned portal. */
+    isVersioned(): boolean;
+    /** Directory holding the versioned portals, relative to the build directory. Defaults to "versioned_docs". */
+    versionsPath(): string;
+    /** True when API Copilot is already configured for this build. */
+    hasApiCopilot(): boolean;
+    /** Returns a copy with the portal's languageConfig set from the selected friendly language ids. */
+    withPortalLanguages(languages: string[]): BuildConfig;
+    /** Returns a copy with the API Copilot configuration set (or overwritten). */
+    withApiCopilotConfig(config: CopilotConfig): BuildConfig;
+    withApiCopilotForPortal(key: string, welcomeMessage: string, baseUrl: UrlPath): BuildConfig;
+    updateBuildConfigBaseUrl(serveUrl: UrlPath): BuildConfig;
+    withRecipeWorkflow(name: string, functionName: string, scriptPath: string): BuildConfig;
+}

package/lib/types/build/build.js

@@ -1,7 +1,168 @@
+import { UrlPath } from "../file/urlPath.js";
 export function getLanguagesConfig(selectedLanguages) {
     return selectedLanguages.reduce((config, lang) => {
         config[lang] = {};
         return config;
     }, {});
 }
+// Maps the CLI's friendly language identifiers (used as languageConfig keys) to
+// codegen's SupportedTemplates ids, which is what portalSettings.languageSettings
+// must be keyed by (codegen resolves these via SdkLanguage.FromSupportedTemplate).
+// These ids are version-specific in codegen (e.g. php_generic_lib_v2) — keep in sync
+// with APIMatic.CodeGen.Common.SdkLanguage.
+const CODEGEN_TEMPLATE_ID_BY_LANGUAGE = {
+    typescript: "ts_generic_lib",
+    csharp: "cs_net_standard_lib",
+    java: "java_eclipse_jre_lib",
+    php: "php_generic_lib_v2",
+    python: "python_generic_lib",
+    ruby: "ruby_generic_lib",
+    go: "go_generic_lib"
+};
+// codegen derives initialPlatform from languageConfig (http is always first), so a
+// languageSettings entry for http must exist or the portal widget fails to render.
+const HTTP_TEMPLATE_ID = "http_curl_v1";
+// Immutable per-language portal setting. Build new values via the static factory and
+// the with* transforms; the wrapped data is never mutated after construction.
+export class LanguageSetting {
+    constructor(data) {
+        this.data = data;
+    }
+    static from(data = {}) {
+        return new LanguageSetting(data);
+    }
+    /** Returns a copy with all AI editor integrations (Cursor/Claude Code/VS Code) enabled. */
+    withAiIntegrationsEnabled() {
+        return new LanguageSetting(Object.assign(Object.assign({}, this.data), { aiIntegration: {
+                cursor: { isEnabled: true },
+                claudeCode: { isEnabled: true },
+                vscode: { isEnabled: true }
+            } }));
+    }
+    toLanguageSettingData() {
+        return this.data;
+    }
+}
+// Immutable portal UI settings. Build new values via the static factory and the with*
+// transforms; the wrapped data is never mutated after construction.
+export class PortalSettings {
+    constructor(data) {
+        this.data = data;
+    }
+    static from(data = {}) {
+        return new PortalSettings(data);
+    }
+    /** Returns a copy with the API-call base URL set. */
+    withBaseUrl(baseUrl) {
+        return new PortalSettings(Object.assign(Object.assign({}, this.data), { baseUrl: baseUrl.toString() }));
+    }
+    // Returns a copy with AI editor integrations enabled for the given SDK languages
+    // (friendly ids). Always adds the http entry the portal needs to render and opens the
+    // portal on the first SDK language. Languages without a codegen template id are skipped.
+    withAiIntegrations(languages) {
+        var _a;
+        const languageSettings = Object.assign({}, this.data.languageSettings);
+        languageSettings[HTTP_TEMPLATE_ID] = (_a = languageSettings[HTTP_TEMPLATE_ID]) !== null && _a !== void 0 ? _a : {};
+        let firstSdkTemplateId;
+        for (const language of languages) {
+            const templateId = CODEGEN_TEMPLATE_ID_BY_LANGUAGE[language];
+            if (!templateId) {
+                continue;
+            }
+            firstSdkTemplateId !== null && firstSdkTemplateId !== void 0 ? firstSdkTemplateId : (firstSdkTemplateId = templateId);
+            languageSettings[templateId] = LanguageSetting.from(languageSettings[templateId]).withAiIntegrationsEnabled().toLanguageSettingData();
+        }
+        return new PortalSettings(Object.assign(Object.assign(Object.assign({}, this.data), { languageSettings }), (firstSdkTemplateId ? { initialPlatform: firstSdkTemplateId } : {})));
+    }
+    toPortalSettingsData() {
+        return this.data;
+    }
+}
+// Immutable wrapper around the parsed APIMATIC-BUILD.json. All build-config reads go
+// through accessor methods and all changes go through with*/update methods that
+// return a NEW BuildConfig — the wrapped data is never mutated after construction.
+// Construct via `BuildConfig.parse`; persist via `BuildContext`.
+export class BuildConfig {
+    constructor(data) {
+        this.data = data;
+    }
+    static parse(json) {
+        return BuildConfig.from(JSON.parse(json));
+    }
+    static from(data) {
+        return new BuildConfig(data);
+    }
+    // Called implicitly by JSON.stringify when the config is written back to disk.
+    toJSON() {
+        return this.data;
+    }
+    /** Content directory for the portal, relative to the build directory. Defaults to "content". */
+    contentFolder() {
+        var _a, _b;
+        return (_b = (_a = this.data.generatePortal) === null || _a === void 0 ? void 0 : _a.contentFolder) !== null && _b !== void 0 ? _b : "content";
+    }
+    /** True when this build produces a multi-versioned portal. */
+    isVersioned() {
+        return this.data.generateVersionedPortal != null;
+    }
+    /** Directory holding the versioned portals, relative to the build directory. Defaults to "versioned_docs". */
+    versionsPath() {
+        var _a;
+        return (_a = this.data.versionsPath) !== null && _a !== void 0 ? _a : "versioned_docs";
+    }
+    /** True when API Copilot is already configured for this build. */
+    hasApiCopilot() {
+        return this.data.apiCopilotConfig != null;
+    }
+    /** Returns a copy with the portal's languageConfig set from the selected friendly language ids. */
+    withPortalLanguages(languages) {
+        const portal = this.data.generatePortal;
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { generatePortal: Object.assign(Object.assign({}, portal), { languageConfig: getLanguagesConfig(languages) }) }));
+    }
+    /** Returns a copy with the API Copilot configuration set (or overwritten). */
+    withApiCopilotConfig(config) {
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { apiCopilotConfig: Object.assign({}, config) }));
+    }
+    // Returns a copy with API Copilot enabled for a locally-served portal: stores the
+    // Copilot config, points the portal base URL at the local serve URL, and turns on AI
+    // editor integrations for the configured SDK languages.
+    withApiCopilotForPortal(key, welcomeMessage, baseUrl) {
+        const portal = this.data.generatePortal;
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { apiCopilotConfig: { isEnabled: true, key, welcomeMessage }, generatePortal: Object.assign(Object.assign({}, portal), { baseUrl: baseUrl.toString(), portalSettings: PortalSettings.from(portal.portalSettings)
+                    .withAiIntegrations(Object.keys(portal.languageConfig))
+                    .toPortalSettingsData() }) }));
+    }
+    // Returns a copy with the portal base URL repointed at the serve URL, or `this`
+    // unchanged when there's no localhost base URL to rewrite (or it already matches the
+    // serve URL). Callers detect a change via reference identity: `result !== original`.
+    updateBuildConfigBaseUrl(serveUrl) {
+        var _a, _b, _c, _d;
+        // `portalSettings.baseUrl` is preferred for portal artifacts; otherwise fall back
+        // to `generatePortal.baseUrl`. Mirrors how codegen resolves the base URL.
+        const portalSettings = (_a = this.data.generatePortal) === null || _a === void 0 ? void 0 : _a.portalSettings;
+        const baseUrl = (_b = portalSettings === null || portalSettings === void 0 ? void 0 : portalSettings.baseUrl) !== null && _b !== void 0 ? _b : (_c = this.data.generatePortal) === null || _c === void 0 ? void 0 : _c.baseUrl;
+        if (!baseUrl) {
+            return this;
+        }
+        const parsedUrl = UrlPath.create(baseUrl);
+        if (!(parsedUrl === null || parsedUrl === void 0 ? void 0 : parsedUrl.isLocalhost()) || parsedUrl.isEqual(serveUrl)) {
+            return this;
+        }
+        const portal = this.data.generatePortal;
+        const updatedPortal = ((_d = portal.portalSettings) === null || _d === void 0 ? void 0 : _d.baseUrl)
+            ? Object.assign(Object.assign({}, portal), { portalSettings: PortalSettings.from(portal.portalSettings).withBaseUrl(serveUrl).toPortalSettingsData() }) : Object.assign(Object.assign({}, portal), { baseUrl: serveUrl.toString() });
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { generatePortal: updatedPortal }));
+    }
+    // Returns a copy with a recipe workflow added (or replaced, matched by permalink).
+    withRecipeWorkflow(name, functionName, scriptPath) {
+        var _a, _b;
+        const recipes = (_a = this.data.recipes) !== null && _a !== void 0 ? _a : {};
+        const workflows = (_b = recipes.workflows) !== null && _b !== void 0 ? _b : [];
+        const permalink = `page:recipes/${functionName}`;
+        const workflow = { name, permalink, functionName, scriptPath };
+        const existingIndex = workflows.findIndex((w) => w.permalink === permalink);
+        const updatedWorkflows = existingIndex === -1 ? [...workflows, workflow] : workflows.map((w, index) => (index === existingIndex ? workflow : w));
+        return new BuildConfig(Object.assign(Object.assign({}, this.data), { recipes: Object.assign(Object.assign({}, recipes), { workflows: updatedWorkflows }) }));
+    }
+}
 //# sourceMappingURL=build.js.map

package/lib/types/build/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/types/build/build.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,kBAAkB,CAAC,iBAA2B;IAC5D,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,EAA+B,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/types/build/build.ts"],"names":[],"mappings":"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"}

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

@@ -1,13 +1,26 @@
 import { DirectoryPath } from "./file/directoryPath.js";
+import { FilePath } from "./file/filePath.js";
 import { BuildConfig } from "./build/build.js";
+import { SpecContext } from "./spec-context.js";
 export declare class BuildContext {
     private readonly fileService;
     private readonly buildDirectory;
     constructor(buildDirectory: DirectoryPath);
     private get buildFile();
+    /** The APIMATIC-BUILD.json path within this build directory, for callers that hand it to a service. */
+    buildConfigFilePath(): FilePath;
     validate(): Promise<boolean>;
     exists(): Promise<boolean>;
+    existsSync(): boolean;
     getBuildFileContents(): Promise<BuildConfig>;
-    updateBuildFileContents(buildJson: BuildConfig): Promise<void>;
+    updateBuildFileContents(buildConfig: BuildConfig): Promise<void>;
     deleteWorkflowDir(): Promise<void>;
+    getBuildZipPath(tempDir: DirectoryPath, packageSettingsDirectory?: DirectoryPath): Promise<FilePath>;
+    getSpecContext(): SpecContext;
+    hasSdkSourceTree(language: string): Promise<boolean>;
+    getSdkSourceTree(language: string): FilePath;
+    isVersionedBuild(): Promise<boolean>;
+    getVersionedBuildDirectory(): Promise<DirectoryPath | undefined>;
+    getSingleVersionedBuildDirectory(): Promise<DirectoryPath | undefined>;
+    getSelectedVersionedBuildDirectory(versionSelector: (versions: string[]) => Promise<string | undefined>): Promise<DirectoryPath | undefined>;
 }