@lukoweb/apitogo 0.1.85 → 0.1.87

package/dist/declarations/cli/platform/helpers/dev-portal-manifest.d.ts

@@ -0,0 +1,167 @@
+import { type LandingManifestInput } from "./dev-portal-landing.js";
+export declare const APITOGO_CONFIG_FILENAME = "apitogo.config.json";
+export declare const DEV_PORTAL_MANIFEST_FILENAME = "apitogo.local.json";
+export declare const PLACEHOLDER_DEV_PORTAL_API_URL = "https://dp-example.azurecontainerapps.io";
+export interface ManifestPlanInput {
+    sku: string;
+    displayName: string;
+    priceAmount?: number;
+    priceCurrency?: string;
+    billingPeriod?: "month" | "year" | "monthly" | "annual";
+    limitsJson?: string;
+    includedActionKeys?: string[];
+}
+export declare function isPlanFree(plan: {
+    priceAmount?: number;
+}): boolean;
+export interface DevPortalLocalManifest {
+    siteName?: string;
+    branding?: {
+        title?: string;
+        logoUrl?: string;
+    };
+    pricing?: {
+        enabled?: boolean;
+    };
+    authentication?: {
+        enabled?: boolean;
+        apiBaseUrl?: string;
+        native?: {
+            enabled?: boolean;
+        };
+        email?: {
+            provider?: string;
+            from?: string;
+        };
+        providers?: Array<{
+            id: string;
+            displayName?: string;
+            authority?: string;
+            clientId?: string;
+            scopes?: string;
+        }>;
+    };
+    plans?: ManifestPlanInput[];
+    backend?: {
+        sourceDirectory?: string;
+        publishDirectory?: string;
+        openApiPath?: string;
+        runtime?: string;
+        runtimeVersion?: string;
+        deployed?: boolean;
+    };
+    gateway?: {
+        authMode?: "platformManagedEntra" | "bringYourOwnOidc";
+        oidcMetadataUrl?: string;
+        oidcAllowedIssuers?: string[];
+        oidcAudiences?: string[];
+        limitsJson?: string;
+        publicHealthActionKey?: string;
+        publicRoutes?: string[];
+    };
+    projectId?: string;
+    landing?: LandingManifestInput;
+}
+export declare function manifestFilePath(siteDirectory: string): string;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function normalizeBillingPeriod(period?: string): string;
+export declare const DEFAULT_PLANS: ManifestPlanInput[];
+export type DevPortalJourneyPhaseId = "shape" | "publish" | "postPublish";
+export interface DevPortalSuggestedNextStep {
+    id: string;
+    phase: DevPortalJourneyPhaseId;
+    prompt: string;
+    tool: string;
+    optional?: boolean;
+    note?: string;
+}
+export interface DevPortalLocalCapability {
+    id: string;
+    label: string;
+    availableLocally: boolean;
+    requiresPublish?: boolean;
+}
+export interface DevPortalPublishPrerequisites {
+    nativeAuthRequired: boolean;
+    stripeRequired: boolean;
+    missingFields: string[];
+    manifestFieldIssues?: string[];
+    readyToPublish: boolean;
+}
+export interface DevPortalJourneyPhase {
+    id: DevPortalJourneyPhaseId;
+    title: string;
+    steps: DevPortalSuggestedNextStep[];
+}
+export declare const SCAFFOLD_LOCAL_CAPABILITIES: DevPortalLocalCapability[];
+export interface DevPortalShapeGuideEntry {
+    target: string;
+    purpose: string;
+    tool?: string;
+}
+export declare const SCAFFOLD_SHAPE_GUIDE: DevPortalShapeGuideEntry[];
+export declare const SCAFFOLD_OPENAPI_MISSING_NEXT_STEP: DevPortalSuggestedNextStep;
+export declare const SCAFFOLD_SUGGESTED_NEXT_STEPS: DevPortalSuggestedNextStep[];
+export declare function buildScaffoldJourneyPhases(steps?: DevPortalSuggestedNextStep[]): DevPortalJourneyPhase[];
+export declare const SCAFFOLD_JOURNEY_PHASES: DevPortalJourneyPhase[];
+export declare const SCAFFOLD_AGENT_INSTRUCTION = "Scaffold only \u2014 dependencies are installed but the dev server is not started. Tell the user the site is ready and to run npm run dev in outputDirectory. The home page lives in landing/LandingPage.tsx (starter hero + features). After npm run dev, ask if they want to customize the home page. When they do, always ask for their real content first (what the API does, key endpoints, audience, tone, desired sections) before editing \u2014 never invent placeholder copy unless they explicitly ask for placeholders \u2014 then edit that TSX file directly or call get_dev_portal_landing_guide for the component catalog. Do not write home page content to apitogo.config.json. Then ask what else they want (OpenAPI, plans, bootstrap API ToGo, or go live). Do not mention missing plans, null projectId, skipped bootstrap, publishPrerequisites, or other absent setup unless the user asks about publish or platform provisioning. One user intent \u2192 one MCP tool. When preview is running, shape-phase file edits hot-reload. Never pass restartPreview: true on update_dev_portal_manifest or set_dev_portal_theme (ignored; used to time out against npm run dev). For publish, the user saves OIDC (+ Stripe if paid) in .env using APITOGO_CONFIG_AUTHENTICATION__* keys \u2014 never collect secrets in chat. Call check_dev_portal_publish_readiness after they confirm, then publish_dev_portal. Do not call sync_gateway_plans_from_manifest before publish.";
+export declare function manifestRequiresStripe(plans: ManifestPlanInput[] | undefined): boolean;
+export declare function isNativeAuthEnabledInManifest(manifest: DevPortalLocalManifest): boolean;
+export declare function readManifestAuthProviders(manifest: DevPortalLocalManifest): NonNullable<DevPortalLocalManifest["authentication"]>["providers"];
+export declare function getPublishPrerequisites(manifest: DevPortalLocalManifest, secrets?: {
+    email?: {
+        connectionString?: string;
+    };
+    providers?: Record<string, {
+        clientSecret?: string;
+    }>;
+    stripe?: {
+        secretKey?: string;
+        webhookSecret?: string;
+    };
+}, emailOptions?: {
+    platformManagedEmail?: boolean;
+    emailDomainStatus?: string;
+}): DevPortalPublishPrerequisites;
+export declare function resolveManifestNextStep(manifest: DevPortalLocalManifest, secrets?: {
+    email?: {
+        connectionString?: string;
+    };
+    providers?: Record<string, {
+        clientSecret?: string;
+    }>;
+    stripe?: {
+        secretKey?: string;
+        webhookSecret?: string;
+    };
+}): string;
+export declare function createScaffoldManifest(siteName?: string): DevPortalLocalManifest;
+export declare function resolveProjectDisplayName(manifest: DevPortalLocalManifest, config?: Record<string, unknown>): string;
+export declare function createDefaultManifest(siteName?: string): DevPortalLocalManifest;
+export declare function applyScaffoldManifestPolicy(manifest: DevPortalLocalManifest, options: {
+    siteName?: string;
+    includeDefaultPlans?: boolean;
+}): DevPortalLocalManifest;
+export declare function mergePlansBySku(existing: ManifestPlanInput[] | undefined, patch: ManifestPlanInput[]): ManifestPlanInput[];
+export declare function resolveBackendOpenApiPath(openApiPath: string | undefined, options: {
+    siteDirectory: string;
+    backendSourceDirectory?: string;
+}): string | undefined;
+export declare function toSiteRelativeOpenApiInput(siteDirectory: string, openApiAbsolutePath: string): string;
+export declare function formatIgnoredManifestPatchWarning(ignoredKeys: string[]): string | undefined;
+export interface NormalizedManifestPatch {
+    patch: Partial<DevPortalLocalManifest>;
+    ignoredKeys: string[];
+}
+export declare function normalizeManifestPatch(raw: Record<string, unknown>): NormalizedManifestPatch;
+export declare function mergePublishPrerequisitesWithPlatformValidation(prerequisites: DevPortalPublishPrerequisites, manifestFieldIssues: string[]): DevPortalPublishPrerequisites;
+export declare function mergeManifest(existing: DevPortalLocalManifest, patch: Partial<DevPortalLocalManifest>): DevPortalLocalManifest;
+export declare function applyOpenApiToSiteConfig(config: Record<string, unknown>, options: {
+    input: string;
+    apiPath: string;
+    navLabel?: string;
+}): Record<string, unknown>;
+export declare function readManifest(siteDirectory: string): Promise<DevPortalLocalManifest | null>;
+export declare function writeManifest(siteDirectory: string, manifest: DevPortalLocalManifest): Promise<string>;
+export declare function plansToMockEnvValue(plans: ManifestPlanInput[] | undefined): string | null;
+export declare function mockPlansPreviewChanged(before: ManifestPlanInput[] | undefined, after: ManifestPlanInput[] | undefined): boolean;

package/dist/declarations/cli/platform/helpers/dev-portal-plan-sync.d.ts

@@ -0,0 +1,20 @@
+export interface DevPortalPlanCatalogItem {
+    sku: string;
+    displayName: string;
+    priceAmount?: number;
+    priceCurrency?: string;
+    billingPeriod?: string;
+    syncedAtUtc?: string;
+}
+export interface DevPortalPlanCatalogResponse {
+    plans: DevPortalPlanCatalogItem[];
+    lastSyncedAtUtc?: string;
+}
+export interface SyncDevPortalPlanCatalogOptions {
+    backendApiBaseUrl: string;
+    expectedPlanCount?: number;
+    retries?: number;
+    retryDelayMs?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare function syncDevPortalPlanCatalog(options: SyncDevPortalPlanCatalogOptions): Promise<DevPortalPlanCatalogResponse>;

package/dist/declarations/cli/platform/helpers/dev-portal-secrets.d.ts

@@ -0,0 +1,61 @@
+import { type DevPortalLocalManifest, type DevPortalPublishPrerequisites } from "./dev-portal-manifest.js";
+export declare const ENV_FILENAME = ".env";
+export declare const ENV_EXAMPLE_FILENAME = ".env";
+declare const AUTHENTICATION_SECRET_ENV_KEYS: readonly ["APITOGO_CONFIG_AUTHENTICATION__PROVIDERS__{providerId}__CLIENT_SECRET", "APITOGO_CONFIG_AUTHENTICATION__STRIPE__SECRET_KEY", "APITOGO_CONFIG_AUTHENTICATION__STRIPE__WEBHOOK_SECRET"];
+export interface DevPortalLocalSecrets {
+    email?: {
+        connectionString?: string;
+    };
+    providers?: Record<string, {
+        clientSecret?: string;
+    }>;
+    stripe?: {
+        secretKey?: string;
+        webhookSecret?: string;
+    };
+}
+export interface DevPortalSecretsStatus {
+    envPath: string;
+    envExamplePath: string;
+    envExists: boolean;
+    envLocalExists: boolean;
+    hasEmailConnectionString: boolean;
+    providerSecretStatus: Record<string, boolean>;
+    hasStripeSecretKey: boolean;
+    hasStripeWebhookSecret: boolean;
+}
+export interface DevPortalPublishConfig {
+    manifest: DevPortalLocalManifest;
+    secrets: DevPortalLocalSecrets;
+    publishPrerequisites: DevPortalPublishPrerequisites;
+    secretsStatus: DevPortalSecretsStatus;
+}
+export declare function normalizeEnvPathSegment(segment: string): string;
+export declare function readSecretsFile(siteDirectory: string): Promise<DevPortalLocalSecrets | null>;
+export declare function loadSiteEnv(siteDirectory: string): Promise<NodeJS.ProcessEnv>;
+export declare function readAuthenticationSecretsFromEnv(env: NodeJS.ProcessEnv): DevPortalLocalSecrets;
+export declare function buildAuthConfigJson(manifest: DevPortalLocalManifest): Record<string, unknown>;
+export declare function buildAuthSecretsJson(secrets: DevPortalLocalSecrets, options?: {
+    platformManagedEmail?: boolean;
+}): Record<string, unknown>;
+export declare function envFilePath(siteDirectory: string): string;
+export declare function envExampleFilePath(siteDirectory: string): string;
+export declare function createEnvContent(): string;
+export declare const createEnvExampleContent: typeof createEnvContent;
+export declare function getSecretsStatus(siteDirectory: string, manifest: DevPortalLocalManifest, secrets: DevPortalLocalSecrets | null, envExists: boolean): DevPortalSecretsStatus;
+export declare function patchContainsSecrets(patch: Record<string, unknown>): boolean;
+export declare function assertPatchHasNoSecrets(patch: Record<string, unknown>): void;
+export declare function validateSecretsForPublish(manifest: DevPortalLocalManifest, secrets: DevPortalLocalSecrets, emailOptions?: {
+    platformManagedEmail?: boolean;
+    emailDomainStatus?: string;
+}): void;
+export declare function resolvePublishConfig(siteDirectory: string, emailOptions?: {
+    platformManagedEmail?: boolean;
+    emailDomainStatus?: string;
+}): Promise<DevPortalPublishConfig>;
+export declare function writeScaffoldEnv(siteDirectory: string): Promise<string[]>;
+export declare const writeScaffoldEnvExample: typeof writeScaffoldEnv;
+export declare const writeScaffoldSecretsArtifacts: typeof writeScaffoldEnv;
+export declare const SECRETS_COLLECTION_INSTRUCTION: string;
+export declare const PAID_PLAN_SETUP_INSTRUCTION: string;
+export { AUTHENTICATION_SECRET_ENV_KEYS };

package/dist/declarations/cli/platform/helpers/dev-portal-settings-kinds.d.ts

@@ -0,0 +1,8 @@
+export declare function resolveLogoSettings(logoUrl?: string): {
+    logoKind: string;
+    logoValue?: string;
+};
+export declare function resolveOpenApiSettings(openApiPath?: string): {
+    openApiSourceKind: string;
+    openApiValue?: string;
+};

package/dist/declarations/cli/platform/helpers/dev-portal-site-api-url.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformApiClient } from "../client/platform-api.js";
+import type { ApitogoConfig } from "../config.js";
+export declare const SITE_API_BASE_URL_ENV_KEY = "VITE_APITOGO_AUTHENTICATION_API_BASE_URL";
+export declare function isPlaceholderDevPortalApiUrl(apiBaseUrl: string | undefined | null): boolean;
+export declare function readSiteApiBaseUrl(sourceDirectory: string): Promise<string | null>;
+export declare function patchSiteApiBaseUrl(sourceDirectory: string, apiBaseUrl: string): Promise<void>;
+export declare function ensureLiveSiteApiBaseUrlForBuild(_client: PlatformApiClient, config: ApitogoConfig, args: {
+    sourceDirectory: string;
+    projectId?: string;
+    apiBaseUrl?: string;
+}, resolveFromProject: (projectId: string, apiBaseUrl?: string) => Promise<string>): Promise<string>;
+export declare function assertDeployableDistHasLiveApiBaseUrl(distDirectory: string, expectedApiBaseUrl?: string | null): Promise<void>;

package/dist/declarations/cli/platform/helpers/dev-portal-site-validation.d.ts

@@ -0,0 +1,22 @@
+import type * as TS from "typescript";
+export interface SiteValidationIssue {
+    file: string;
+    message: string;
+}
+export interface SiteValidationResult {
+    valid: boolean;
+    checkedFiles: string[];
+    issues: SiteValidationIssue[];
+    skippedChecks: string[];
+}
+type TypeScriptModule = typeof TS;
+export declare function loadTypeScriptForSite(sourceDirectory: string): Promise<TypeScriptModule | null>;
+export declare function checkTsxSyntax(ts: TypeScriptModule, fileName: string, content: string): string[];
+export declare function validateSiteConfigStructure(config: unknown, sourceDirectory: string): Promise<string[]>;
+export interface ValidateSiteOptions {
+    extraTsxFiles?: string[];
+}
+export declare function validateDevPortalSiteConfig(sourceDirectory: string, options?: ValidateSiteOptions): Promise<SiteValidationResult>;
+export declare function formatSiteValidationErrors(result: SiteValidationResult): string;
+export declare function buildSiteValidationResponseFields(result: SiteValidationResult): Record<string, unknown>;
+export {};

package/dist/declarations/cli/platform/helpers/dev-portal-urls.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectDto } from "../client/platform-api.js";
+export interface DevPortalUrls {
+    swaUrl: string;
+    swaOrigin: string;
+    stripeSuccessUrl: string;
+    stripeCancelUrl: string;
+    oidcRedirectUris: Array<{
+        providerId: string;
+        redirectUri: string;
+    }>;
+    stripeWebhookUrl: string;
+    backendApiBaseUrl: string;
+}
+export declare function resolveSwaHostname(project: ProjectDto): string | null;
+export declare function resolveSwaHostnameWithFallback(project: ProjectDto, platformSiteUrl?: string | null): string | null;
+export declare function resolveSwaUrl(project: ProjectDto): string | null;
+export declare function resolveDevPortalUrls(project: ProjectDto, backendFqdn: string, providerIds?: string[], platformSiteUrl?: string | null): DevPortalUrls;

package/dist/declarations/cli/platform/helpers/fetch-retry.d.ts

@@ -0,0 +1,17 @@
+export declare const RETRIABLE_HTTP_STATUSES: Set<number>;
+export interface FetchRetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    retryMutatingOnServerError?: boolean;
+    method?: string;
+}
+export declare function isRetriableHttpStatus(status: number): boolean;
+export declare function isNetworkError(error: unknown): boolean;
+export declare function withFetchRetry<T>(operation: () => Promise<T>, options?: FetchRetryOptions & {
+    shouldRetryResult?: (result: T) => {
+        retry: boolean;
+        retryAfterMs?: number;
+    };
+}): Promise<T>;
+export declare function fetchWithRetry(input: string | URL, init?: RequestInit, options?: FetchRetryOptions): Promise<Response>;

package/dist/declarations/cli/platform/helpers/free-projects-quota.d.ts

@@ -0,0 +1,14 @@
+export interface FreeProjectsQuota {
+    allowance: number;
+    used: number;
+    remaining: number;
+}
+export declare function freeProjectsQuotaFromTenant(tenant: {
+    freeProjectsAllowance?: number;
+    freeProjectsUsed?: number;
+    freeProjectsRemaining?: number;
+}): FreeProjectsQuota | null;
+export declare function isFreeProjectQuotaError(message: string): boolean;
+export declare function parseToolJsonResult(result: string): {
+    status?: string;
+};

package/dist/declarations/cli/platform/helpers/gateway-plan-sync.d.ts

@@ -0,0 +1,26 @@
+import type { GatewayPlanDto, PlatformApiClient } from "../client/platform-api.js";
+import type { ApitogoConfig } from "../config.js";
+import { type ManifestPlanInput } from "./dev-portal-manifest.js";
+export declare function mergeActionKeys(existing: string[], additions: string[]): string[];
+export declare function subtractActionKeys(existing: string[], removals: string[]): string[];
+export interface GatewayPlanSortTarget {
+    planId: string;
+    sku: string;
+    sortOrder: number;
+}
+export interface UpsertGatewayPlansOptions {
+    syncActionsOnly?: boolean;
+    deferActionKeys?: boolean;
+}
+export declare function resolveSiteLinkedProjectId(manifestProjectId?: string | null, explicitProjectId?: string | null): string | undefined;
+export declare function skippedNoProjectIdPlanSync(tool: string): {
+    status: "skipped";
+    reason: "no_project_id";
+    tool: string;
+    message: string;
+};
+export declare const GATEWAY_PLAN_SORT_TEMP_OFFSET = 1000;
+export declare function buildGatewayPlanSortTargets(manifestPlans: ManifestPlanInput[], existingPlans: GatewayPlanDto[]): GatewayPlanSortTarget[];
+export declare function buildGatewayPlanSortTargetsFromIds(manifestPlans: ManifestPlanInput[], planIdsBySku: Map<string, string>, skuById?: Map<string, GatewayPlanDto>): GatewayPlanSortTarget[];
+export declare function applyGatewayPlanSortOrders(client: PlatformApiClient, config: ApitogoConfig, projectId: string, targets: GatewayPlanSortTarget[]): Promise<unknown[]>;
+export declare function upsertGatewayPlansFromManifest(client: PlatformApiClient, config: ApitogoConfig, projectId: string, plans: ManifestPlanInput[], options?: UpsertGatewayPlansOptions): Promise<unknown[]>;

package/dist/declarations/cli/platform/helpers/gateway-readiness.d.ts

@@ -0,0 +1,11 @@
+import type { BackendSummaryDto } from "../client/platform-api.js";
+export type GatewayRecommendedAction = "deploy_backend" | "sync_plan_actions" | "ready";
+export declare function resolveApimDirectGatewayUrl(projectId: string, backendSummary: Pick<BackendSummaryDto, "backendUrl">): string;
+export declare function buildApimDirectGatewayUrl(projectId: string): string;
+export declare function probeCustomDomainTls(url: string): Promise<boolean>;
+export declare function resolveGatewayRecommendedAction(options: {
+    backendSummary: BackendSummaryDto;
+    actionCount: number;
+    hasBackendSource?: boolean;
+}): GatewayRecommendedAction;
+export declare function buildGatewayReadinessRecoveryHint(action: GatewayRecommendedAction, customDomainTlsReady: boolean): string | undefined;

package/dist/declarations/cli/platform/helpers/job-status.d.ts

@@ -0,0 +1,12 @@
+import { type JobLogMessage } from "./progress.js";
+import { type AgentStatus } from "./status.js";
+export declare function formatJobStatusResponse(options: {
+    agentStatus: AgentStatus;
+    platformStatus: string;
+    messages: JobLogMessage[];
+    stepLabel?: string;
+    resourceType?: string | null;
+    terminal: boolean;
+    message?: string;
+    extra?: Record<string, unknown>;
+}): Record<string, unknown>;

package/dist/declarations/cli/platform/helpers/merge-dev-portal-settings.d.ts

@@ -0,0 +1,26 @@
+import type { DevPortalSettingsDto, UpsertDevPortalSettingsRequest } from "../client/platform-api.js";
+export declare const LOCAL_DEV_PORTAL_SETTINGS_DEFAULTS: {
+    readonly gitHubOwner: "local";
+    readonly gitHubRepo: "dev-portal-site";
+    readonly pagesPath: "pages";
+    readonly logoKind: "RepoRelative";
+    readonly openApiSourceKind: "RepoRelative";
+};
+export type PatchDevPortalSettingsInput = {
+    gitHubOwner?: string;
+    gitHubRepo?: string;
+    defaultBranch?: string;
+    pagesPath?: string;
+    logoValue?: string;
+    logoDarkValue?: string;
+    logoKind?: string;
+    openApiSourceKind?: string;
+    openApiValue?: string;
+    authConfigJson?: string;
+    authSecretsJson?: string;
+    stripeSecretKey?: string;
+    stripeWebhookSecret?: string;
+    stripeSuccessUrl?: string;
+    stripeCancelUrl?: string;
+};
+export declare function mergeDevPortalSettingsPatch(current: DevPortalSettingsDto | null, patch: PatchDevPortalSettingsInput): UpsertDevPortalSettingsRequest;

package/dist/declarations/cli/platform/helpers/npm-build.d.ts

@@ -0,0 +1,34 @@
+export declare class NpmBuildError extends Error {
+    readonly buildLog: string;
+    readonly exitCode: number | null;
+    constructor(message: string, buildLog: string, exitCode: number | null);
+}
+export interface NpmBuildResult {
+    distPath: string;
+    durationMs: number;
+    buildLog: string;
+}
+export interface NpmInstallResult {
+    durationMs: number;
+    installLog: string;
+}
+export declare function runNpmInstall(sourceDirectory: string, options?: {
+    nodeVersion?: string;
+}): Promise<NpmInstallResult>;
+export declare function runNpmBuild(sourceDirectory: string, options?: {
+    nodeVersion?: string;
+    env?: Record<string, string>;
+}): Promise<NpmBuildResult>;
+export declare function readPackageName(sourceDirectory: string): Promise<string | null>;
+export interface NpmDevResult {
+    localUrl: string;
+    pid: number;
+    durationMs: number;
+    devLog: string;
+}
+export declare function runNpmDev(sourceDirectory: string, options?: {
+    nodeVersion?: string;
+    port?: number;
+    host?: boolean;
+    skipInstall?: boolean;
+}): Promise<NpmDevResult>;

package/dist/declarations/cli/platform/helpers/openapi-gateway-servers.d.ts

@@ -0,0 +1,23 @@
+import type { PlatformApiClient } from "../client/platform-api.js";
+import { type DevPortalLocalManifest } from "./dev-portal-manifest.js";
+export declare const GATEWAY_URL_ENV_KEY = "APITOGO_GATEWAY_URL";
+export declare const PUBLISH_OPENAPI_RELATIVE = ".apitogo/openapi-publish.json";
+export declare function normalizeGatewayUrl(gatewayUrl: string): string;
+export declare function withGatewayServers(doc: Record<string, unknown>, gatewayUrl: string): Record<string, unknown>;
+export declare function resolveProjectGatewayUrl(client: PlatformApiClient, projectId: string): Promise<string | null>;
+export declare function materializePublishOpenApiWithGateway(siteDirectory: string, sourceOpenApiPath: string, gatewayUrl: string): Promise<{
+    outputPath: string;
+    relativeInput: string;
+}>;
+export declare function pointSiteApisAtPublishOpenApi(siteDirectory: string, relativeInput: string): Promise<{
+    restore: () => Promise<void>;
+}>;
+export declare function prepareOpenApiServersForGatewayBuild(options: {
+    siteDirectory: string;
+    manifest: DevPortalLocalManifest | null;
+    gatewayUrl: string;
+}): Promise<{
+    relativeInput: string;
+    outputPath: string;
+    restore: () => Promise<void>;
+} | null>;

package/dist/declarations/cli/platform/helpers/openapi.d.ts

@@ -0,0 +1,24 @@
+export interface ValidateOpenApiResult {
+    valid: boolean;
+    errors: string[];
+    version?: string;
+    title?: string;
+}
+export declare const OPENAPI_BASENAMES: readonly ["openapi.yaml", "openapi.yml", "openapi.json", "swagger.yaml", "swagger.yml", "swagger.json"];
+export interface NearbyOpenApiDiscovery {
+    status: "found" | "not_found" | "invalid";
+    selectedPath?: string;
+    version?: string;
+    title?: string;
+    candidates: string[];
+    searchedDirectories: string[];
+    invalidCandidates?: Array<{
+        path: string;
+        errors: string[];
+    }>;
+}
+export declare function discoverNearbyOpenApi(siteDirectory: string): Promise<NearbyOpenApiDiscovery>;
+export declare const OPENAPI_NOT_FOUND_SUGGESTION = "No OpenAPI file found near the site (checked parent, sibling folders, and the site directory for openapi.yaml|yml|json / swagger.yaml|yml|json). Ask the user for a path, or offer to draft a starter OpenAPI 3 spec from their API description, write it next to the site (e.g. ../openapi.yaml), then call set_dev_portal_openapi.";
+export declare const OPENAPI_NOT_FOUND_AGENT_INSTRUCTION = "No OpenAPI was auto-discovered. Ask if they already have a spec path; if not, offer to create a starter OpenAPI 3 file for them from a short description of their API (paths/operations), write it beside the site, then call set_dev_portal_openapi. Do not invent a large fake API unless they ask for placeholders.";
+export declare const OPENAPI_WIRED_AGENT_INSTRUCTION = "OpenAPI was auto-discovered and wired to /api. Do not ask to add OpenAPI unless the user wants a different spec. Restart local preview after create so /api registers.";
+export declare function validateOpenApiFile(filePath: string): Promise<ValidateOpenApiResult>;

package/dist/declarations/cli/platform/helpers/package-files.d.ts

@@ -0,0 +1 @@
+export declare function collectPackageableFiles(sourceDirectory: string): Promise<string[]>;

package/dist/declarations/cli/platform/helpers/paid-gateway-platform-compat.d.ts

@@ -0,0 +1,22 @@
+import { type ManifestPlanInput } from "./dev-portal-manifest.js";
+export interface PaidManifestPlanSummary {
+    sku: string;
+    displayName: string;
+    priceAmount: number;
+    priceCurrency?: string;
+}
+export declare function listPaidManifestPlans(plans: ManifestPlanInput[] | undefined): PaidManifestPlanSummary[];
+export declare function isFreePlatformTier(planTier: string | undefined | null): boolean;
+export declare function formatPaidPlanList(plans: PaidManifestPlanSummary[]): string;
+export interface PaidGatewayOnFreeConflict {
+    reason: "paid_gateway_plans_require_starter";
+    paidPlans: PaidManifestPlanSummary[];
+    userMessage: string;
+    agentInstruction: string;
+    options: Array<{
+        id: "upgrade_platform_plan" | "remove_paid_gateway_plans";
+        label: string;
+        nextStep: string;
+    }>;
+}
+export declare function buildPaidGatewayOnFreeConflict(plans: ManifestPlanInput[] | undefined): PaidGatewayOnFreeConflict | null;

package/dist/declarations/cli/platform/helpers/platform-plan-catalog.d.ts

@@ -0,0 +1,27 @@
+import type { FreeProjectsQuota } from "./free-projects-quota.js";
+export type PlatformPlanId = "free" | "starter" | "professional";
+export interface PlatformPlanOption {
+    id: PlatformPlanId;
+    displayName: string;
+    priceLabel: string;
+    priceAmountUsd: number | null;
+    billingPeriod: "month";
+    summary: string;
+    infrastructure: string;
+    features: string[];
+    limitations: string[];
+}
+export declare const PLATFORM_PLAN_CATALOG: PlatformPlanOption[];
+export declare const PLATFORM_PLAN_USER_PROMPT = "Which API ToGo platform plan do you want for this project \u2014 Free, Starter, or Professional?";
+export declare function formatFreeProjectsQuotaHint(quota: FreeProjectsQuota): string;
+export declare function buildPlatformPlanSelectionAgentInstruction(quota?: FreeProjectsQuota | null): string;
+export declare const PLATFORM_PLAN_SELECTION_AGENT_INSTRUCTION: string;
+export declare function getPlatformPlanCatalogPayload(quota?: FreeProjectsQuota | null): {
+    note: string;
+    freeProjectsQuota?: FreeProjectsQuota | undefined;
+    freeProjectsQuotaHint?: string | undefined;
+    freePlanAvailable?: boolean | undefined;
+    platformPlanCatalog: PlatformPlanOption[];
+    platformPlanUserPrompt: string;
+    platformPlanSelectionAgentInstruction: string;
+};

package/dist/declarations/cli/platform/helpers/platform-plan.d.ts

@@ -0,0 +1,17 @@
+import type { PlatformApiClient, ProjectSubscriptionDto } from "../client/platform-api.js";
+import type { ProgressReporter } from "./progress.js";
+export declare function isPlatformPlanUnselected(planTier: string | undefined | null): boolean;
+export declare function isPlatformPlanSelected(subscription: ProjectSubscriptionDto): boolean;
+export declare function isPaidPlanTier(planTier: string): boolean;
+export declare function isPaidPlanActive(subscription: ProjectSubscriptionDto): boolean;
+export declare function isPlatformPlanReady(subscription: ProjectSubscriptionDto): boolean;
+export interface PlatformPlanWaitResult {
+    status: "succeeded" | "timeout" | "failed";
+    subscription: ProjectSubscriptionDto;
+    timedOut: boolean;
+}
+export declare function waitForPlatformPlan(client: PlatformApiClient, projectId: string, options?: {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    progress?: ProgressReporter;
+}): Promise<PlatformPlanWaitResult>;

package/dist/declarations/cli/platform/helpers/poll.d.ts

@@ -0,0 +1,21 @@
+import { type ProgressReporter } from "./progress.js";
+import { type AgentStatus } from "./status.js";
+export interface PollOptions<T> {
+    poll: () => Promise<T>;
+    isTerminal: (value: T) => boolean;
+    getStatus: (value: T) => AgentStatus;
+    timeoutMs?: number;
+    intervalMs?: number;
+    onPoll?: (value: T) => void;
+    onPollError?: (error: unknown, last: T | undefined) => PollResult<T> | undefined;
+    progress?: ProgressReporter;
+    stepLabel?: string;
+}
+export interface PollResult<T> {
+    status: AgentStatus;
+    value: T;
+    timedOut: boolean;
+    cancelled?: boolean;
+    completedViaNotFound?: boolean;
+}
+export declare function pollUntilTerminal<T>(options: PollOptions<T>): Promise<PollResult<T>>;

package/dist/declarations/cli/platform/helpers/progress.d.ts

@@ -0,0 +1,45 @@
+export interface JobLogMessage {
+    timestamp: string;
+    level: string;
+    message: string;
+}
+export interface ProgressReporter {
+    onStep(step: string, detail?: {
+        platformStatus?: string;
+        message?: string;
+    }): Promise<void>;
+    onNewMessages(messages: JobLogMessage[]): Promise<void>;
+    isCancelled(): boolean;
+    child(stepLabel: string): ProgressReporter;
+}
+export interface McpToolExtra {
+    _meta?: {
+        progressToken?: string | number;
+    };
+    sendNotification?: (notification: {
+        method: string;
+        params: Record<string, unknown>;
+    }) => Promise<void>;
+    signal?: AbortSignal;
+}
+export declare const RECENT_JOB_MESSAGE_LIMIT = 5;
+export declare function recentJobMessages(messages: JobLogMessage[] | undefined): JobLogMessage[];
+export declare function newMessagesSince(previousCount: number, messages: JobLogMessage[] | undefined): JobLogMessage[];
+export declare function deriveCurrentStep(platformStatus: string, messages: JobLogMessage[] | undefined, stepLabel?: string): string;
+export declare function buildProgressSummary(options: {
+    stepLabel: string;
+    messages: JobLogMessage[] | undefined;
+    startedAtMs: number;
+    terminalStatus: string;
+}): {
+    stepsCompleted: string;
+    lastMessage: string | null;
+    elapsedMs: number;
+    terminalStatus: string;
+};
+export declare function createMcpProgressReporter(extra?: McpToolExtra): ProgressReporter;
+export interface PollableJobValue {
+    status: string;
+    messages?: JobLogMessage[];
+}
+export declare function reportPollProgress(progress: ProgressReporter | undefined, stepLabel: string, value: PollableJobValue): Promise<void>;