@stripe/extensibility-dev-tools 0.23.5 → 0.24.2

package/dist/extensibility-dev-tools-internal.d.ts

@@ -1,1722 +0,0 @@
-/**
- * `@stripe/extensibility-dev-tools`
- *
- * Development tools for Stripe Apps extension projects:
- * - Template system for code generation
- * - Dependency management
- * - Manifest parsing (stripe-app.yaml)
- * - Workspace regeneration
- *
- * @packageDocumentation
- */
-
-import { z } from 'zod';
-
-/**
- * Shows an advanced diff viewer with scrolling and colorized output.
- * Falls back to basic prompt if not in a TTY or on error.
- *
- * @param filePath - Relative path to the file (for display)
- * @param cwd - Working directory to resolve the path from
- * @param newContent - New content that would be written
- * @returns User's decision about overwriting
- * @internal
- */
-export declare function _advancedDiffPrompt(filePath: string, cwd: string, newContent: string): Promise<_OverwriteDecision>;
-
-/**
- * Result of checking whether a dependency is satisfied.
- * @internal
- */
-export declare interface _CheckResult {
-    /** Whether the dependency requirement is currently satisfied. */
-    satisfied: boolean;
-    /** The currently installed version, if any. */
-    currentVersion?: string;
-    /** Human-readable message describing the check result. */
-    message: string;
-}
-
-/**
- * Shared context threaded through CLI operations.
- *
- * Carry this through call chains so that output can be redirected in tests
- * without patching global `process.stdout`/`process.stderr`.
- *
- * @internal
- */
-export declare interface _CliContext {
-    /** Output abstraction for writing to stdout/stderr. */
-    readonly ux: _CliUx;
-}
-
-/**
- * Thin output abstraction used by CLI entry points and the functions they call.
- *
- * Inject a `_CliUx` constructed with `PassThrough` streams in tests to capture
- * output without spying on `process.stdout`/`process.stderr`.
- *
- * @internal
- */
-export declare class _CliUx {
-    #private;
-    constructor(options?: {
-        readonly stderr?: NodeJS.WritableStream;
-        readonly stdout?: NodeJS.WritableStream;
-    });
-    /** Write a product output line to stdout (or the configured stream). */
-    print(message: string): void;
-    /** Write a status/progress line to stderr (or the configured stream). */
-    log(message: string): void;
-    /**
-     * Error message to **stderr** (or the configured stderr stream).
-     *
-     * Behaviorally identical to {@link _CliUx.log} today. Use `error()` for failures
-     * and `log()` for progress/status — the distinction supports future
-     * formatting differentiation (color, prefixes, severity filtering).
-     */
-    error(message: string): void;
-}
-
-/**
- * Options for committing accumulated dependency changes.
- * @internal
- */
-export declare interface _CommitOptions {
-    /** If true, run package manager install for npm deps. Default: true */
-    runInstall?: boolean;
-}
-
-/**
- * Summary of changes applied by a dependency manager commit.
- * @internal
- */
-export declare interface _CommitResult {
-    /** Number of new dependencies added. */
-    added: number;
-    /** Number of existing dependencies updated. */
-    updated: number;
-}
-
-/**
- * Result of checking whether a dependency version conflicts with an existing installation.
- * @internal
- */
-export declare interface _ConflictResult {
-    /** Whether a version conflict exists. */
-    hasConflict: boolean;
-    /** The version currently installed, if any. */
-    existingVersion?: string;
-    /** The version being requested, if applicable. */
-    requestedVersion?: string;
-    /** Human-readable message describing the conflict, if any. */
-    message?: string;
-}
-
-/**
- * Create a `_CliContext` with default or injected collaborators.
- *
- * @param options - Optional options. Pass a pre-constructed `_CliUx` to redirect output
- *   streams (e.g., for testing or RPC transports that must not write to stdout).
- * @internal
- */
-export declare function _createCliContext(options?: { ux?: _CliUx }): _CliContext;
-
-/**
- * Generate the ESLint config file for an extension workspace.
- * @internal
- */
-export declare function _createExtensionEslintConfigFile(params: { extensionInterfaceId: string } & Pick<_ExtensionParams, 'id'>, context: _TemplateContext): _GeneratedFile;
-
-/**
- * Helper for creating a SingleTemplateManager with simple single-file generation
- *
- * @param generateContent - Function that generates file content from parameters
- * @param pathTemplate - Function that generates file path from parameters
- * @returns SingleTemplateManager ready to use
- *
- * @example
- * ```typescript
- * interface MyParams {
- *   name: string
- * }
- *
- * // Simple template that generates content from parameters
- * const templateManager = createSimpleSingleFileTemplate<MyParams>(
- *   (params) => `export class ${params.name} { ... }`,
- *   (params) => `src/${snakeCase(params.name)}.ts`
- * )
- *
- * const output = await templateManager.generate({ name: 'MyClass' })
- * // output.files[0] = { path: 'src/my_class.ts', content: '...' }
- * ```
- * @internal
- */
-export declare function _createSimpleSingleFileTemplate<TParams>(generateContent: (params: TParams) => string, pathTemplate: (params: TParams) => string): _SingleTemplateManager<TParams>;
-
-/**
- * Convert a simple content generator to a full Template
- * @param generateContent - Function that generates file content from parameters
- * @param pathTemplate - Function that generates file path from parameters
- * @returns Full Template implementation
- *
- * @example
- * ```typescript
- * interface MyParams {
- *   name: string
- *   version: string
- * }
- *
- * const template = createSimpleTemplate<MyParams>(
- *   (params) => `export const ${params.name} = "${params.version}";`,
- *   (params) => `src/${snakeCase(params.name)}.ts`
- * )
- * ```
- * @internal
- */
-export declare function _createSimpleTemplate<TParams>(generateContent: (params: TParams) => string, pathTemplate: (params: TParams) => string): _Template<TParams>;
-
-/**
- * Custom object definition (internal representation with separate fields)
- * @internal
- */
-export declare interface _CustomObjectDefinition {
-    /** Object identifier (e.g., "device", "loyalty_card") */
-    id: string;
-    /** Specification type (e.g., "typescript") */
-    type: string;
-    /** Path to the definition file */
-    path: string;
-    /** Export name derived from id via PascalCase (e.g., "Device", "LoyaltyCard") */
-    name: string;
-}
-
-/**
- * Wrapper for custom_object_definitions in the manifest.
- * @internal
- */
-export declare interface _CustomObjectDefinitionsBlock {
-    /** List of custom object definition entries. */
-    definitions?: _CustomObjectDefinitionYaml[];
-}
-
-/**
- * Custom object definition as stored in YAML (nested under definitions).
- *
- * `id` is the source of truth for identity. The export name used at build time
- * is derived via `_toPascalCase(id)`, so `id` must be valid snake_case that
- * round-trips cleanly (e.g., `device`, `loyalty_card`, `http_request`).
- * Consecutive-uppercase class names like `MyHTTPClient` are NOT round-trip safe
- * (`my_http_client` → `MyHttpClient`). A future `export_name` field may address
- * this; for now, avoid ids that would produce ambiguous PascalCase names.
- *
- * @example
- * ```yaml
- * custom_object_definitions:
- *   definitions:
- *     - id: device
- *       specification:
- *         type: typescript
- *         content: src/device.object.ts
- * ```
- *
- * @internal
- */
-export declare interface _CustomObjectDefinitionYaml {
-    /** Object identifier (e.g., `device`, `loyalty_card`). */
-    id: string;
-    /** Specification describing the type and source file for the definition. */
-    specification: {
-        content: string;
-        type: string;
-    };
-}
-
-/**
- * A parsed custom object entry referencing a file path and export class name.
- * @internal
- */
-export declare interface _CustomObjectEntry {
-    /** Relative path to the type definition file (e.g., `src/device.d.ts`). */
-    filePath: string;
-    /** Name of the exported class in the definition file. */
-    className: string;
-}
-
-/**
- * Default workspace services using real filesystem and dependency implementations.
- * @internal
- */
-export declare const _defaultServices: _WorkspaceServices;
-
-/**
- * A dependency that the workspace needs: npm runtime, npm dev, or Stripe CLI plugin.
- * @internal
- */
-export declare type _Dependency = _DevNpmDependency | _NpmDependency | _StripeCliPluginDependency;
-
-/**
- * The action to take for a dependency: add new, update existing, no-op, or flag a conflict.
- * @internal
- */
-export declare type _DependencyAction = 'add' | 'already-satisfied' | 'conflict' | 'update';
-
-/**
- * Handler interface for a specific dependency type (npm or Stripe CLI plugin).
- * @internal
- */
-export declare interface _DependencyHandler<T extends _Dependency> {
-    /** Check if dependency is satisfied */
-    check(dep: T): Promise<_CheckResult>;
-    /** Check for conflicts with existing state */
-    checkConflict(dep: T): Promise<_ConflictResult>;
-    /** Add the dependency (update package.json for npm, noop for stripe cli) */
-    add(dep: T): Promise<{
-        action: 'add' | 'update';
-        message: string;
-    }>;
-    /** Run actual install (npm install for npm deps, stripe plugin install for cli) */
-    install(deps: T[]): Promise<void>;
-}
-
-/**
- * Orchestrates dependency analysis and installation across all dependency types.
- * @internal
- */
-export declare class _DependencyManager {
-    private readonly cwd;
-    private readonly stripeConfigDir;
-    private readonly quiet;
-    private readonly context;
-    private readonly npmHandler;
-    private readonly devNpmHandler;
-    private readonly stripeCliPluginHandler;
-    /** Internal state: pending changes indexed by dependency key */
-    private pendingChanges;
-    /** Whether commit() has been called */
-    private committed;
-    constructor(options?: _DependencyManagerOptions);
-    /**
-     * Analyze dependencies and accumulate changes.
-     * Can be called multiple times before commit().
-     * Returns the changes for this specific call.
-     */
-    ensureDependencies(input: _EnsureDependenciesInput): Promise<_PendingChange[]>;
-    /**
-     * Resolve a conflict by marking it for force install.
-     * Throws if the dependency is not in conflict state.
-     */
-    resolveConflict(dep: _Dependency): void;
-    /**
-     * Get all pending changes (accumulated across all ensureDependencies calls).
-     */
-    getPendingChanges(): _PendingChange[];
-    /**
-     * Commit all accumulated changes.
-     * - For npm deps: updates package.json, optionally runs package manager install
-     * - For Stripe CLI deps: always installs (no separate add step)
-     *
-     * @param options - Commit options. `options.runInstall`: if true, run package manager install for npm deps (default: true)
-     * @returns Summary of changes made
-     * @throws If called more than once
-     */
-    commit(options?: _CommitOptions): Promise<_CommitResult>;
-    private analyzeDependency;
-    private getHandler;
-}
-
-/**
- * Options for constructing a dependency manager.
- * @internal
- */
-export declare interface _DependencyManagerOptions {
-    /** Working directory (defaults to process.cwd()) */
-    cwd?: string;
-    /** Path to Stripe config directory (defaults to ~/.config/stripe) */
-    stripeConfigDir?: string;
-    /** Whether to suppress console output */
-    quiet?: boolean;
-    /** CLI context for user-facing output */
-    context?: _CliContext;
-}
-
-/**
- * Detect the package manager used in the workspace by looking for lockfiles.
- * @internal
- */
-export declare function _detectPackageManager(cwd: string): _PackageManager;
-
-/**
- * Create a dev npm dependency descriptor.
- * @internal
- */
-export declare function _devNpmDep(name: string, version: string): _DevNpmDependency;
-
-/**
- * A dev npm dependency to add to `devDependencies` in package.json.
- * @internal
- */
-export declare interface _DevNpmDependency {
-    /** Discriminant tag identifying this as a dev npm dependency. */
-    type: 'dev-npm';
-    /** npm package name. */
-    name: string;
-    /** Semver version range. */
-    version: string;
-}
-
-/**
- * Authentication configuration for an endpoint.
- * @internal
- */
-export declare interface _EndpointAuth {
-    /** The type of authentication. */
-    type: 'bearer_token' | 'header';
-    /** The name of the secret containing the authentication credential. */
-    secret_name: string;
-    /** The name of the header to use for authentication (required when type is 'header'). */
-    header_name?: string;
-}
-
-/**
- * Configuration for a single endpoint environment (live, test, managed_sandbox).
- * @internal
- */
-export declare interface _EndpointDefinition {
-    /** The HTTPS URL of the endpoint. */
-    url?: string;
-    /** The purpose of the endpoint. */
-    purpose?: string;
-    /** Authentication configuration. */
-    auth?: _EndpointAuth;
-}
-
-/**
- * Input for requesting dependency installation.
- * @internal
- */
-export declare interface _EnsureDependenciesInput {
-    /** Dependencies that must be present. */
-    required: _Dependency[];
-    /** Dependencies that are preferred but not required. */
-    optional?: _Dependency[];
-}
-
-/**
- * Extension configuration for stripe-app.yaml
- * @internal
- */
-export declare interface _ExtensionConfig {
-    /** Extension identifier (e.g., `username.my-ext`). */
-    id: string;
-    /** Human-readable extension name. */
-    name: string;
-    /** Extension interface ID (e.g., `com.stripe.billing.bill`). */
-    interface_id: string;
-    /** Extension version string. */
-    version: string;
-    /** Developer-defined description for the extension (max 300 chars). */
-    description?: string;
-    /** Stripe API version to use for this extension (e.g., `2024-06-05`). */
-    stripe_version?: string;
-    /** Entry point script path, used by legacy script format. */
-    script_entry_point?: string;
-    /** Inline script definition (type + content path). */
-    script?: {
-        content: string;
-        type: string;
-    };
-    /** Required permissions for the extension. */
-    permissions: string[];
-    /** Method implementations keyed by method name. */
-    methods: Record<string, unknown>;
-    /** Optional configuration schemas for the extension. */
-    configuration?: _ExtensionConfiguration;
-    /** Remote function endpoints for the extension. */
-    endpoints?: {
-        id: string;
-        live?: _EndpointDefinition;
-        managed_sandbox?: _EndpointDefinition;
-        test?: _EndpointDefinition;
-        type: 'custom_http' | 'remote_function';
-    }[];
-}
-
-/**
- * Extension configuration schemas (JSON Schema for validation, UI Schema for rendering).
- * @internal
- */
-export declare interface _ExtensionConfiguration {
-    /** JSON Schema file for validating extension configuration. */
-    input_schema: _SchemaReference;
-    /** UI Schema file for rendering the configuration form. */
-    ui_schema: _SchemaReference;
-}
-
-/**
- * Static metadata for a single method on an extension template
- * @internal
- */
-export declare interface _ExtensionMethodInfo {
-    /** Implementation types supported by this method (e.g. 'script', 'remote-function') */
-    implementation_types: string[];
-}
-
-/**
- * Parameters for extension template generation
- * @internal
- */
-export declare interface _ExtensionParams extends Record<string, unknown> {
-    /** Extension ID (validated to be safe for file paths and IDs) */
-    id: string;
-    /** Human-readable name for the extension */
-    name: string;
-    /** Package version (preserved from existing package.json, defaults to 0.0.1) */
-    version: string;
-}
-
-/**
- * Extension template - specialization of generic Template with a description
- * @internal
- */
-export declare interface _ExtensionTemplate extends _Template<_ExtensionParams, _ExtensionTemplateOutput> {
-    /** Short human-readable description of the extension interface */
-    description: string;
-    /** Whether this template is deprecated and should not be offered for new extensions */
-    deprecated?: boolean;
-    /** Whether this template is hidden from `stripe generate` (used only by the build pipeline) */
-    hidden?: boolean;
-    /** Static metadata for each method — implementation types supported per method */
-    methods: Record<string, _ExtensionMethodInfo>;
-}
-
-/**
- * Summary info for a registered extension template
- * @internal
- */
-export declare interface _ExtensionTemplateInfo {
-    /** Template key (the extension interface ID) */
-    key: string;
-    /** Short human-readable description */
-    description: string;
-    /** Whether this template is deprecated */
-    deprecated: boolean;
-    /** Whether this template is hidden from user-facing generators */
-    hidden: boolean;
-    /** Static metadata for each method — implementation types supported per method */
-    methods: Record<string, _ExtensionMethodInfo>;
-}
-
-/**
- * Extension template manager
- * Specialized TemplateManager for extension generation
- * @internal
- */
-export declare class _ExtensionTemplateManager extends _TemplateManager<_ExtensionParams, _ExtensionTemplateOutput, _ExtensionTemplate> {
-    /**
-     * Get summary info for all registered extension templates
-     */
-    getTemplateInfo(): _ExtensionTemplateInfo[];
-}
-
-/**
- * Output from extension template generation
- * @internal
- */
-export declare interface _ExtensionTemplateOutput extends _TemplateOutput {
-    /** Methods configuration for stripe-app.yaml */
-    methods: Record<string, unknown>;
-    /** Dependencies required by the extension */
-    dependencies?: {
-        dev?: _DevNpmDependency[];
-        runtime?: _NpmDependency[];
-    };
-    /** Post-generation hooks to run after files are generated and dependencies installed */
-    postGenerationHooks?: _PostGenerationHook[];
-}
-
-/**
- * Result of writing files
- * @internal
- */
-export declare interface _FileWriteResult {
-    /**
-     * Paths of files that were successfully written (relative to cwd)
-     * Includes both newly created files and overwritten files
-     */
-    written: string[];
-    /**
-     * Paths of all files that already existed before the operation (relative to cwd)
-     * Always populated when files exist, regardless of whether they were overwritten
-     */
-    existing: string[];
-    /**
-     * Whether the entire operation was skipped due to overwrite='abort-if-existing' with existing files
-     * True only when overwrite='abort-if-existing' and files exist (all-or-nothing behavior)
-     * False for all other modes including interactive (even if user skips all files)
-     */
-    skipped: boolean;
-    /**
-     * Whether the user aborted the operation during interactive prompting
-     * True only when user chose 'quit' during interactive mode
-     * Caller should stop further processing (dependencies, hooks, etc.)
-     */
-    aborted: boolean;
-}
-
-/**
- * Options for writing generated files
- * @internal
- */
-export declare interface _FileWriterOptions {
-    /**
-     * Working directory to write files relative to
-     * Defaults to process.cwd()
-     */
-    cwd?: string;
-    /**
-     * How to handle existing files:
-     * - 'overwrite-all': Overwrite all existing files
-     * - 'abort-if-existing': Refuse to write ANY files if ANY already exist (all-or-nothing)
-     * - 'if-missing': Skip individual files that exist, write only missing files
-     * - function: Prompt before overwriting each file (interactive ask mode)
-     * Defaults to 'abort-if-existing'
-     */
-    write?: _WriteMode;
-    /**
-     * Callback invoked after a file is successfully written
-     * @param file - The file that was written
-     * @param wasOverwrite - True if file existed and was overwritten, false if newly created
-     */
-    onFileWritten?: (file: _GeneratedFile, wasOverwrite: boolean) => void;
-    /**
-     * Callback invoked when a file already exists and is skipped
-     * @param file - The file that was skipped
-     */
-    onFileSkipped?: (file: _GeneratedFile) => void;
-    /**
-     * Callback invoked when a file already exists with identical content
-     * @param file - The file that is identical
-     */
-    onFileIdentical?: (file: _GeneratedFile) => void;
-}
-
-/**
- * Default TemplateFS instance rooted at templates/
- *
- * ESM: Uses filesystem implementation (reads from templates/ directory)
- * CJS: This entire file is replaced with in-memory implementation
- * @internal
- */
-export declare const _fs: _TemplateFS;
-
-/**
- * Core generic types for the template system
- *
- * This module provides the foundation for a flexible, type-safe template system
- * that can be specialized for different use cases (extensions, custom objects, etc.)
- */
-/**
- * Represents a single generated file
- * @internal
- */
-export declare interface _GeneratedFile {
-    /**
-     * Path to the file relative to project root
-     * Example: "extensions/my-extension/src/index.ts"
-     */
-    path: string;
-    /**
-     * Content of the file
-     */
-    content: string;
-    /**
-     * Never overwrite this file, even if --force specified.
-     */
-    precious?: boolean;
-}
-
-/**
- * Manages stripe-app.json (V1) manifest file operations
- *
- * Capabilities:
- * - Custom objects (add, remove, has, get)
- * - App metadata (id, name)
- *
- * @example
- * ```ts
- * const manifest = await ManifestV1.load('./stripe-app.json')
- * manifest.addCustomObject({ filePath: 'src/device.d.ts', className: 'Device' })
- * await manifest.save()
- * ```
- * @internal
- */
-export declare class _ManifestV1 {
-    private readonly filePath;
-    private data;
-    private constructor();
-    /**
-     * Load stripe-app.json from disk
-     * @param filePath - Path to stripe-app.json
-     * @throws Error if file is invalid or cannot be read
-     */
-    static load(filePath: string): _ManifestV1;
-    /**
-     * Get the app ID from the manifest
-     */
-    getAppId(): string;
-    /**
-     * Get the app name from the manifest
-     */
-    getAppName(): string;
-    /**
-     * Get all custom objects as structured entries
-     */
-    getCustomObjects(): _CustomObjectEntry[];
-    /**
-     * Check if a custom object entry exists in the manifest
-     */
-    hasCustomObject(entry: _CustomObjectEntry): boolean;
-    /**
-     * Add a custom object entry to the manifest
-     * Does nothing if entry already exists
-     * @returns true if entry was added, false if it already existed
-     */
-    addCustomObject(entry: _CustomObjectEntry): boolean;
-    /**
-     * Remove a custom object entry from the manifest
-     * @returns true if entry was removed, false if it didn't exist
-     */
-    removeCustomObject(entry: _CustomObjectEntry): boolean;
-    /**
-     * Get the raw manifest data (for reading other fields)
-     */
-    getRawData(): Readonly<_ManifestV1Data>;
-    /**
-     * Save changes back to disk
-     */
-    save(): void;
-}
-
-/**
- * V1 manifest structure (stripe-app.json)
- * @internal
- */
-export declare interface _ManifestV1Data {
-    /** The app identifier. */
-    id: string;
-    /** The app version string. */
-    version: string;
-    /** The app display name. */
-    name: string;
-    /** List of custom object entries in `path#ClassName` format. */
-    exported_custom_objects?: string[];
-    /** Additional manifest fields. */
-    [key: string]: unknown;
-}
-
-/**
- * Manages stripe-app.yaml (V2) manifest file operations
- *
- * Capabilities:
- * - Extensions (add, update, get)
- * - App metadata (id, name)
- *
- * @example
- * ```ts
- * const manifest = await _ManifestV2.load('./stripe-app.yaml')
- * manifest.addOrUpdateExtension({
- *   id: 'username.my-ext',
- *   name: 'my-ext',
- *   interfaceId: 'com.stripe.test',
- *   version: '0.0.1',
- *   scriptEntryPoint: 'scripts/my-ext/index.ts',
- *   permissions: [],
- *   methods: { my_run: { implementation_type: 'script' } }
- * })
- * await manifest.save()
- * ```
- * @internal
- */
-export declare class _ManifestV2 {
-    private readonly filePath;
-    private data;
-    private constructor();
-    /**
-     * Load stripe-app.yaml from disk
-     * @param filePath - Path to stripe-app.yaml
-     * @throws Error if file is invalid or cannot be read
-     */
-    static load(filePath: string): Promise<_ManifestV2>;
-    /**
-     * Get the app ID from the manifest
-     */
-    getAppId(): string | undefined;
-    /**
-     * Get the app name from the manifest
-     */
-    getAppName(): string | undefined;
-    /**
-     * Get all custom object definitions, parsed into internal format.
-     * Entries are guaranteed structurally valid by load-time validation.
-     */
-    getCustomObjects(): _CustomObjectDefinition[];
-    /**
-     * Check if a custom object exists by id
-     */
-    hasCustomObject(id: string): boolean;
-    /**
-     * Add a custom object definition.
-     *
-     * Identity is keyed on `id` alone. The export name is derived via
-     * `_toPascalCase(id)` at read time, so `id` should be valid snake_case
-     * (e.g., "device", "loyalty_card", "http_request").
-     *
-     * @param id - Object identifier (e.g., "device", "loyalty_card")
-     * @param content - Path to the definition file (e.g., "src/device.object.ts")
-     * @param type - Specification type, defaults to "typescript"
-     * @returns true if added, false if already exists
-     */
-    addCustomObject(id: string, content: string, type?: string): boolean;
-    /**
-     * Remove a custom object definition by id
-     * @param id - Object identifier to remove
-     * @returns true if removed, false if not found
-     */
-    removeCustomObject(id: string): boolean;
-    /**
-     * Add a new extension or update an existing one by ID
-     * If an extension with the provided ID exists, it will be replaced entirely
-     * @param extension - Extension configuration with all required fields including id
-     * @returns The extension ID
-     */
-    addOrUpdateExtension(extension: _ExtensionConfig): string;
-    /**
-     * Get a read-only view of all extensions
-     */
-    getExtensions(): readonly Readonly<_ExtensionConfig>[];
-    /**
-     * Get the raw manifest data (for reading other fields)
-     */
-    getRawData(): Readonly<_ManifestV2Data>;
-    /**
-     * Save changes back to disk
-     * @throws Error if file cannot be written
-     */
-    save(): Promise<void>;
-}
-
-/**
- * V2 manifest structure (stripe-app.yaml)
- * @internal
- */
-export declare interface _ManifestV2Data {
-    /** The app identifier. */
-    id: string;
-    /** The app display name. */
-    name: string;
-    /** The app version string. */
-    version: string;
-    /** Registered extension configurations. */
-    extensions?: _ExtensionConfig[];
-    /** Custom object definitions block. */
-    custom_object_definitions?: _CustomObjectDefinitionsBlock;
-    /** Additional manifest fields. */
-    [key: string]: unknown;
-}
-
-/**
- * Manifest version types
- * @internal
- */
-export declare type _ManifestVersion = 'v1' | 'v2';
-
-/**
- * Create a runtime npm dependency descriptor.
- * @internal
- */
-export declare function _npmDep(name: string, version: string): _NpmDependency;
-
-/**
- * A runtime npm dependency to add to `dependencies` in package.json.
- * @internal
- */
-export declare interface _NpmDependency {
-    /** Discriminant tag identifying this as a runtime npm dependency. */
-    type: 'npm';
-    /** npm package name. */
-    name: string;
-    /** Semver version range. */
-    version: string;
-}
-
-/**
- * Handles npm and dev-npm dependency installation via package.json updates.
- * @internal
- */
-export declare class _NpmDependencyHandler implements _DependencyHandler<_NpmDependency | _DevNpmDependency> {
-    private readonly cwd;
-    private readonly quiet;
-    private readonly devDependencies;
-    private readonly context;
-    constructor(options: _NpmHandlerOptions);
-    private get dependencyKey();
-    private get dependencyLabel();
-    /** Check whether the npm dependency is already present in package.json. */
-    check(dep: _DevNpmDependency | _NpmDependency): Promise<_CheckResult>;
-    /** Check whether the requested version conflicts with the currently installed version. */
-    checkConflict(dep: _DevNpmDependency | _NpmDependency): Promise<_ConflictResult>;
-    /** Add or update the npm dependency in package.json. */
-    add(dep: _DevNpmDependency | _NpmDependency): Promise<{
-        action: 'add' | 'update';
-        message: string;
-    }>;
-    /** Run the package manager install command in the working directory. */
-    install(_deps: (_DevNpmDependency | _NpmDependency)[]): Promise<void>;
-    private versionsCompatible;
-    private extractMajorVersion;
-}
-
-/**
- * Options for constructing an npm dependency handler.
- * @internal
- */
-export declare interface _NpmHandlerOptions {
-    /** Working directory containing the target package.json. */
-    cwd: string;
-    /** Whether to suppress console output. */
-    quiet: boolean;
-    /** If true, manage devDependencies; otherwise manage dependencies. */
-    devDependencies?: boolean;
-    /** CLI context for user-facing output. */
-    context?: _CliContext;
-}
-
-/**
- * User decision when prompted about overwriting a file
- * @internal
- */
-export declare type _OverwriteDecision = 'abort' | 'overwrite-all' | 'overwrite' | 'skip';
-
-/**
- * Callback function for prompting about file overwrites
- * @param path - Relative path to the file that would be overwritten
- * @param cwd - Working directory (for resolving the path)
- * @param newContent - Content of the file that would be written
- * @returns Promise resolving to user's decision
- * @internal
- */
-export declare type _OverwritePromptCallback = (path: string, cwd: string, newContent: string) => Promise<_OverwriteDecision>;
-
-/**
- * Package manager detected in the workspace.
- * @internal
- */
-export declare type _PackageManager = 'npm' | 'pnpm' | 'yarn';
-
-/**
- * Package metadata (id, name, version)
- * @internal - Exported for testing only
- */
-export declare interface _PackageMetadata {
-    /** The package identifier (from package.json `name`). */
-    id: string;
-    /** Human-readable display name (from package.json `description`). */
-    name: string;
-    /** Package version string (from package.json `version`). */
-    version: string;
-}
-
-/**
- * A pending dependency change accumulated by the dependency manager before commit.
- * @internal
- */
-export declare interface _PendingChange {
-    /** The dependency this change applies to. */
-    dependency: _Dependency;
-    /** The action that will be taken for this dependency. */
-    action: _DependencyAction;
-    /** Human-readable message describing the pending change. */
-    message: string;
-    /** The previously installed version, if an update is involved. */
-    previousVersion?: string;
-    /** Conflict details when action is 'conflict'. */
-    conflict?: _ConflictResult;
-    /** Whether conflict has been resolved (force install) */
-    conflictResolved?: boolean;
-}
-
-/**
- * Post-generation hook configuration
- * Either `script` (run via `pnpm run`) or `exec` (run via `pnpm exec`)
- * @internal
- */
-export declare type _PostGenerationHook = {
-    description?: string;
-    exec: string;
-} | {
-    description?: string;
-    script: string;
-};
-
-/**
- * Simple text-based prompt for overwrite decisions
- * Uses single-keypress input in interactive terminals (no Enter required)
- * Falls back to line-based input in non-interactive environments (tests, CI)
- *
- * @param filePath - Path to the file that would be overwritten
- * @returns Promise resolving to user's decision
- * @internal
- */
-export declare function _promptOverwrite(filePath: string): Promise<_OverwriteDecision>;
-
-/**
- * Regenerate workspace files from templates
- *
- * @param options - Regeneration options
- * @param services - Injectable collaborators (defaults to real implementations)
- * @param context - CLI context for user-facing output. Defaults to a new context with standard stdout/stderr streams.
- *
- * @example
- * ```typescript
- * // Regenerate root workspace (scenario 1)
- * await regenAppProjectWorkspace({ packageDir: '.' });
- *
- * // Create new extension (scenario 2)
- * await regenAppProjectWorkspace({
- *   templateId: 'core.workflows.custom_action',
- *   workspaceId: 'my-ext',
- * });
- *
- * // Regenerate extension from its directory (scenario 3)
- * await regenAppProjectWorkspace({
- *   root: '../..',
- *   packageDir: '.',
- *   templateId: 'core.workflows.custom_action',
- * });
- *
- * // Regenerate extension from project root (scenario 4)
- * await regenAppProjectWorkspace({
- *   packageDir: 'extensions/my-ext',
- *   templateId: 'core.workflows.custom_action',
- * });
- *
- * // Ensure custom-objects workspace (scenario 5)
- * await regenAppProjectWorkspace({
- *   templateId: 'custom-objects',
- *   workspaceId: 'custom-objects',
- * });
- * ```
- * @internal
- */
-export declare function _regenAppProjectWorkspace(options: _RegenWorkspaceOptions, services?: _WorkspaceServices, context?: _CliContext): Promise<void>;
-
-/**
- * Options for regenerating a workspace from templates.
- * @internal
- */
-export declare type _RegenWorkspaceOptions = z.infer<typeof _regenWorkspaceOptionsSchema>;
-
-/**
- * Options for workspace regeneration
- * @internal
- */
-export declare const _regenWorkspaceOptionsSchema: z.ZodObject<{
-    force: z.ZodOptional<z.ZodBoolean>;
-    implementationType: z.ZodOptional<z.ZodEnum<{
-        "remote-function": "remote-function";
-        script: "script";
-    }>>;
-    name: z.ZodOptional<z.ZodString>;
-    packageDir: z.ZodOptional<z.ZodString>;
-    root: z.ZodOptional<z.ZodString>;
-    skipDependencies: z.ZodOptional<z.ZodBoolean>;
-    skipHooks: z.ZodOptional<z.ZodBoolean>;
-    templateId: z.ZodOptional<z.ZodString>;
-    workspaceId: z.ZodOptional<z.ZodString>;
-    workspaceName: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-
-/**
- * Resolve package ID, name, and version from options or package.json
- *
- * @param providedId - ID from options
- * @param providedName - Name from options (overrides package.json)
- * @param packageDir - Directory containing package.json, or undefined to skip reading
- * @returns Object with id, name, and version
- * @throws Error if ID cannot be determined, or if both providedId and package.json ID
- *         exist and differ
- * @internal - Exported for testing only
- */
-export declare function _resolvePackageMetadata(providedId: string | undefined, providedName: string | undefined, packageDir: string | undefined): Promise<_PackageMetadata>;
-
-/**
- * Root workspace template manager
- * Automatically selects filesystem or in-memory implementation
- * @internal
- */
-export declare const _rootTemplateManager: _SingleTemplateManager<_RootWorkspaceParams, _RootWorkspaceOutput>;
-
-/**
- * Output from root workspace template generation
- * @internal
- */
-export declare interface _RootWorkspaceOutput extends _TemplateOutput {
-    /** Dependencies to install after file generation. */
-    dependencies?: {
-        dev?: _DevNpmDependency[];
-        runtime?: _NpmDependency[];
-    };
-    /** Hooks to run after dependencies are installed. */
-    postGenerationHooks?: _PostGenerationHook[];
-}
-
-/**
- * Parameters for root workspace template generation
- * @internal
- */
-export declare interface _RootWorkspaceParams extends Record<string, unknown> {
-    /** The app identifier (package.json `name`). */
-    appId: string;
-    /** The app display name (package.json `description`). */
-    appName: string;
-    /** The app version string. */
-    version: string;
-}
-
-/**
- * Root workspace template generator.
- *
- * Generates common configuration files for the monorepo root:
- * - .prettierrc (code formatting config)
- * - .prettierignore (files to ignore in formatting)
- *
- * @example
- * ```typescript
- * const output = rootWorkspaceTemplate.generate({}, context);
- * await writeFiles(output.files, '.', true);
- * ```
- * @internal
- */
-export declare const _rootWorkspaceTemplate: _Template<_RootWorkspaceParams, _RootWorkspaceOutput>;
-
-/**
- * A reference to a schema file in the project (type + relative path).
- *
- * Note: stripe-cli-apps-plugin is the authoritative representation of the
- * Stripe App manifest. Types here are a best-effort mirror.
- * @internal
- */
-export declare interface _SchemaReference {
-    /** The schema format. */
-    type: 'json_schema' | 'jsonforms';
-    /** Relative path to the schema file. Named `content` to match the manifest field. */
-    content: string;
-}
-
-/**
- * Single template manager - no registry lookup needed
- * For commands that only have one template
- * @internal
- */
-export declare class _SingleTemplateManager<TParams, TOutput extends _TemplateOutput = _TemplateOutput> {
-    private readonly template;
-    private readonly fs;
-    /**
-     * Create a new SingleTemplateManager
-     * @param template - The single template to use
-     * @param fs - Filesystem for template file reading
-     */
-    constructor(template: _Template<TParams, TOutput>, fs: _TemplateFS);
-    /**
-     * Generate output from the template
-     * @param params - Template parameters
-     * @returns Template output
-     */
-    generate(params: TParams): Promise<TOutput>;
-}
-
-/**
- * Unified interface for Stripe App manifest operations.
- *
- * This class provides an abstraction over both V1 (stripe-app.json) and V2 (stripe-app.yaml)
- * manifest formats, automatically detecting the version and delegating to the appropriate reader.
- *
- * Capabilities by version:
- * - V1 (JSON): Custom objects, app metadata
- * - V2 (YAML): Extensions, custom objects, app metadata
- *
- * @example
- * ```ts
- * const manifest = await _StripeAppManifest.load('./stripe-app.yaml')
- * manifest.addOrUpdateExtension({ ... })
- * await manifest.save()
- * ```
- * @internal
- */
-export declare class _StripeAppManifest {
-    private readonly manifestPath;
-    private readonly version;
-    private readonly v1;
-    private readonly v2;
-    private constructor();
-    /**
-     * Load a manifest file, automatically detecting the version.
-     * @param manifestPath - Path to stripe-app.json or stripe-app.yaml
-     * @returns Loaded manifest instance
-     */
-    static load(manifestPath: string): Promise<_StripeAppManifest>;
-    /**
-     * Detect manifest version from file path.
-     * TODO: Add content-based detection if needed.
-     */
-    private static detectVersion;
-    /**
-     * Get the detected manifest version
-     */
-    getVersion(): _ManifestVersion;
-    /**
-     * Get the manifest file path
-     */
-    getManifestPath(): string;
-    /**
-     * Get the app ID from the manifest
-     */
-    getAppId(): string | undefined;
-    /**
-     * Get the app name from the manifest
-     */
-    getAppName(): string | undefined;
-    /**
-     * Get all custom objects from the manifest
-     */
-    getCustomObjects(): _CustomObjectEntry[];
-    /**
-     * Check if a custom object entry exists in the manifest.
-     *
-     * **V2 note:** Identity is keyed on `_toSnakeCase(className)` alone — `filePath`
-     * is not considered. Two entries with the same class name but different file
-     * paths are treated as the same object. The `_toSnakeCase` → `_toPascalCase`
-     * round-trip is lossless for typical class names but lossy for consecutive
-     * uppercase (e.g., `HTTPClient` → `http_client` → `HttpClient`). The manifest
-     * `id` field is the source of truth; see `_CustomObjectDefinitionYaml` docs.
-     */
-    hasCustomObject(entry: _CustomObjectEntry): boolean;
-    /**
-     * Add a custom object entry to the manifest.
-     *
-     * **V2 note:** The manifest `id` is derived as `_toSnakeCase(className)` and
-     * `filePath` is stored as the specification `content` path. Identity/dedup
-     * is based on `id` alone — see `hasCustomObject` for details.
-     *
-     * @param entry - The custom object entry to add
-     * @returns true if entry was added, false if it already existed
-     */
-    addCustomObject(entry: _CustomObjectEntry): boolean;
-    /**
-     * Remove a custom object entry from the manifest.
-     *
-     * **V2 note:** Removal is keyed on `_toSnakeCase(className)` — `filePath` is
-     * not considered. See `hasCustomObject` for identity semantics.
-     *
-     * @param entry - The custom object entry to remove
-     * @returns true if entry was removed, false if it didn't exist
-     */
-    removeCustomObject(entry: _CustomObjectEntry): boolean;
-    /**
-     * Get all extensions from the manifest
-     * @throws Error if manifest version doesn't support extensions
-     */
-    getExtensions(): readonly Readonly<_ExtensionConfig>[];
-    /**
-     * Add or update an extension in the manifest.
-     * If an extension with the same ID exists, it will be replaced.
-     *
-     * @param config - Full extension configuration
-     * @returns The extension ID
-     * @throws Error if manifest version doesn't support extensions
-     */
-    addOrUpdateExtension(config: _ExtensionConfig): string;
-    /**
-     * Save changes back to disk
-     */
-    save(): Promise<void>;
-}
-
-/**
- * Create a Stripe CLI plugin dependency descriptor.
- * @internal
- */
-export declare function _stripeCliPluginDep(name: string, minVersion?: string): _StripeCliPluginDependency;
-
-/**
- * A Stripe CLI plugin dependency that must be installed via `stripe plugin install`.
- * @internal
- */
-export declare interface _StripeCliPluginDependency {
-    /** Discriminant tag identifying this as a Stripe CLI plugin dependency. */
-    type: 'stripe-cli-plugin';
-    /** Plugin shortname (e.g., `extensibility`). */
-    name: string;
-    /** Minimum required semver version of the plugin. */
-    minVersion?: string;
-}
-
-/**
- * Handles Stripe CLI plugin installation via `stripe plugin install`.
- * @internal
- */
-export declare class _StripeCliPluginHandler implements _DependencyHandler<_StripeCliPluginDependency> {
-    private readonly stripeConfigDir;
-    private readonly quiet;
-    private readonly context;
-    constructor(options: _StripeCliPluginHandlerOptions);
-    /** Check whether the Stripe CLI plugin is installed and meets the minimum version. */
-    check(dep: _StripeCliPluginDependency): Promise<_CheckResult>;
-    /** Check whether the installed plugin version conflicts with the requested minimum. */
-    checkConflict(dep: _StripeCliPluginDependency): Promise<_ConflictResult>;
-    /** Stage a Stripe CLI plugin for installation; the actual install happens in `install`. */
-    add(dep: _StripeCliPluginDependency): Promise<{
-        action: 'add' | 'update';
-        message: string;
-    }>;
-    /** Install Stripe CLI plugins using `stripe plugin install`. */
-    install(deps: _StripeCliPluginDependency[]): Promise<void>;
-    private findPluginInToml;
-    /**
-     * Check if installed version satisfies the required minimum version.
-     *
-     * Permissive policy: Non-semver versions (e.g., "local.build.dev", "dev", "canary-abc123")
-     * always satisfy version requirements. This avoids forcing upgrades during local development
-     * when developers are using locally built plugins.
-     *
-     * For valid semver versions, uses the semver library for proper semantic version comparison.
-     *
-     * @param installed - The installed version string
-     * @param required - The required minimum version string
-     * @returns true if installed version satisfies requirement
-     */
-    private isVersionSatisfied;
-}
-
-/**
- * Options for constructing a Stripe CLI plugin dependency handler.
- * @internal
- */
-export declare interface _StripeCliPluginHandlerOptions {
-    /** Path to the Stripe CLI config directory (e.g., `~/.config/stripe`). */
-    stripeConfigDir: string;
-    /** Whether to suppress console output. */
-    quiet: boolean;
-    /** CLI context for user-facing output. */
-    context?: _CliContext;
-}
-
-/**
- * Template definition
- * Wraps a generate function with any associated metadata
- *
- * @typeParam TParams - Parameters for template generation
- * @typeParam TOutput - Output type (must extend TemplateOutput)
- * @internal
- */
-export declare interface _Template<TParams, TOutput extends _TemplateOutput = _TemplateOutput> {
-    /**
-     * Generate files and other output from the template
-     */
-    generate(params: TParams, context: _TemplateContext): Promise<TOutput> | TOutput;
-}
-
-/**
- * Context for template generation
- * Provides optional capabilities like file reading and user prompts
- * Templates can ignore this parameter if they don't need these features
- * @internal
- */
-export declare interface _TemplateContext {
-    /**
-     * Filesystem abstraction for reading template files
-     */
-    fs: _TemplateFS;
-}
-
-/**
- * Filesystem abstraction for template factories
- * @internal
- */
-export declare interface _TemplateFS {
-    /**
-     * Read a text file relative to the templates directory
-     *
-     * Note: Only supports text files. Binary files are not supported by the
-     * current implementation (template content is embedded as strings during
-     * CJS bundling, which doesn't work for binary data).
-     */
-    textFile(...segments: string[]): string;
-    /**
-     * Read a file and process it with Mustache template engine
-     * @param params - Parameters to pass to the template
-     * @param segments - Path segments to the template file
-     */
-    mustache(params: Record<string, unknown>, ...segments: string[]): string;
-    /**
-     * Create a scoped TemplateFS with an implicit path prefix
-     * @param prefix - Path segment to prepend to all operations
-     * @returns New TemplateFS instance with the prefix applied
-     */
-    scope(prefix: string): _TemplateFS;
-}
-
-/**
- * Generic template manager
- * Manages template selection and generation with full type safety
- *
- * @typeParam TParams - Template parameters type
- * @typeParam TOutput - Template output type (must extend TemplateOutput)
- * @typeParam TTemplate - Concrete template type (defaults to Template; specify to preserve extra fields in getTemplateEntries)
- * @internal
- */
-export declare class _TemplateManager<TParams, TOutput extends _TemplateOutput = _TemplateOutput, TTemplate extends _Template<TParams, TOutput> = _Template<TParams, TOutput>> {
-    private readonly templates;
-    private readonly fs;
-    /**
-     * Create a new TemplateManager
-     * @param templates - Object mapping string keys to templates
-     * @param fs - Filesystem abstraction for template file reading
-     *
-     * @example
-     * ```typescript
-     * import { fs } from './fs/index.js';
-     *
-     * const manager = new TemplateManager({
-     *   foo: fooTemplate,
-     *   bar: barTemplate,
-     * }, fs)
-     *
-     * await manager.generate('foo', params)
-     * ```
-     */
-    constructor(templates: Record<string, TTemplate>, fs: _TemplateFS);
-    /**
-     * Generate output from a template
-     * @param key - Template key to generate from
-     * @param params - Template-specific parameters
-     * @returns Template output with files and any additional fields
-     * @throws Error if template key is not found
-     */
-    generate(key: string, params: TParams): Promise<TOutput>;
-    /**
-     * Get all template entries as [key, template] pairs
-     */
-    protected getTemplateEntries(): [string, TTemplate][];
-    /**
-     * Get list of all supported template keys
-     */
-    getSupportedKeys(): string[];
-}
-
-/**
- * ExtensionTemplateManager configured with built-in templates
- * Automatically selects filesystem or in-memory implementation
- * @internal
- */
-export declare const _templateManager: _ExtensionTemplateManager;
-
-/**
- * Base template output - always includes files array
- * Extend this interface to add additional output fields
- * @internal
- */
-export declare interface _TemplateOutput {
-    /** Files to write to disk. */
-    files: _GeneratedFile[];
-}
-
-/**
- * A dependency required by a workspace: runtime npm, dev npm, or Stripe CLI plugin.
- * @internal
- */
-export declare type _WorkspaceDependency = {
-    minVersion?: string;
-    name: string;
-    type: 'stripe-cli-plugin';
-} | {
-    name: string;
-    type: 'dev-npm';
-    version: string;
-} | {
-    name: string;
-    type: 'npm';
-    version: string;
-};
-
-/**
- * Interface for managing workspace dependency installation.
- * @internal
- */
-export declare interface _WorkspaceDependencyManager {
-    /** Analyze and queue the given dependencies for installation. */
-    ensureDependencies(input: {
-        optional?: _WorkspaceDependency[];
-        required: _WorkspaceDependency[];
-    }): Promise<_WorkspacePendingChange[]>;
-    /** Mark a conflicting dependency as resolved so it will be force-installed. */
-    resolveConflict(dep: _WorkspaceDependency): void;
-    /** Apply all queued dependency changes. */
-    commit(): Promise<unknown>;
-}
-
-/**
- * Extension configuration used by the workspace manifest interface.
- * @internal
- */
-export declare interface _WorkspaceExtensionConfig {
-    /** Extension identifier. */
-    id: string;
-    /** Human-readable extension name. */
-    name: string;
-    /** Extension interface ID. */
-    interface_id: string;
-    /** Extension version string. */
-    version: string;
-    /** Legacy entry point script path. */
-    script_entry_point?: string;
-    /** Inline script definition. */
-    script?: {
-        content: string;
-        type: string;
-    };
-    /** Required permissions for the extension. */
-    permissions: string[];
-    /** Method implementations keyed by method name. */
-    methods: Record<string, unknown>;
-    /** Optional configuration schemas. */
-    configuration?: {
-        input_schema: {
-            content: string;
-            type: 'json_schema' | 'jsonforms';
-        };
-        ui_schema: {
-            content: string;
-            type: 'json_schema' | 'jsonforms';
-        };
-    };
-    /** Remote function endpoints. */
-    endpoints?: {
-        id: string;
-        live?: _EndpointDefinition;
-        managed_sandbox?: _EndpointDefinition;
-        test?: _EndpointDefinition;
-        type: 'custom_http' | 'remote_function';
-    }[];
-}
-
-/**
- * Result of writing workspace files to disk.
- * @internal
- */
-export declare interface _WorkspaceFileWriteResult {
-    /** Paths of files that were written or overwritten. */
-    written: string[];
-    /** Paths of files that already existed and were not overwritten. */
-    existing: string[];
-    /** Whether all remaining files were skipped. */
-    skipped: boolean;
-    /** Whether the write operation was aborted by the user. */
-    aborted: boolean;
-}
-
-/**
- * Options for writing workspace generated files to disk.
- * @internal
- */
-export declare interface _WorkspaceFileWriterOptions {
-    /** Working directory to resolve file paths against. */
-    cwd?: string;
-    /** Controls how existing files are handled. */
-    write?: _WorkspaceWriteMode;
-    /** Called after a file is written or overwritten. */
-    onFileWritten?: (file: _WorkspaceGeneratedFile, wasOverwrite: boolean) => void;
-    /** Called when a file is skipped due to the write mode. */
-    onFileSkipped?: (file: _WorkspaceGeneratedFile) => void;
-    /** Called when a file is identical to the existing one on disk. */
-    onFileIdentical?: (file: _WorkspaceGeneratedFile) => void;
-}
-
-/**
- * A file generated by a workspace template.
- * @internal
- */
-export declare interface _WorkspaceGeneratedFile {
-    /** Path to the file, relative to the project root. */
-    path: string;
-    /** File content as a string. */
-    content: string;
-    /** If true, the file will never be overwritten even with `--force`. */
-    precious?: boolean;
-}
-
-/**
- * Result returned by a workspace template generator.
- * @internal
- */
-export declare interface _WorkspaceGenerateResult {
-    /** Files to write to disk. */
-    files: _WorkspaceGeneratedFile[];
-    /** Dependencies to install after file generation. */
-    dependencies?: {
-        dev?: _WorkspaceDependency[];
-        runtime?: _WorkspaceDependency[];
-    };
-    /** Hooks to run after dependencies are installed. */
-    postGenerationHooks?: _WorkspacePostGenerationHook[];
-    /** Methods configuration for the stripe-app.yaml extension entry. */
-    methods?: Record<string, unknown>;
-}
-
-/**
- * Interface for reading and writing the stripe-app.yaml manifest.
- * @internal
- */
-export declare interface _WorkspaceManifest {
-    /** Add a new extension or replace an existing one by ID; returns the extension ID. */
-    addOrUpdateExtension(config: _WorkspaceExtensionConfig): string;
-    /** Get a read-only view of all registered extensions. */
-    getExtensions(): readonly Readonly<_WorkspaceExtensionConfig>[];
-    /** Check whether a custom object entry is already registered in the manifest. */
-    hasCustomObject(entry: {
-        className: string;
-        filePath: string;
-    }): boolean;
-    /** Add a custom object entry to the manifest; returns true if added, false if already present. */
-    addCustomObject(entry: {
-        className: string;
-        filePath: string;
-    }): boolean;
-    /** Persist the manifest to disk. */
-    save(): Promise<void>;
-}
-
-/**
- * Decision returned by an overwrite prompt callback when a file already exists.
- * @internal
- */
-export declare type _WorkspaceOverwriteDecision = 'abort' | 'overwrite-all' | 'overwrite' | 'skip';
-
-/**
- * Callback invoked when a file to be written already exists, prompting for an overwrite decision.
- * @internal
- */
-export declare type _WorkspaceOverwritePromptCallback = (path: string, cwd: string, newContent: string) => Promise<_WorkspaceOverwriteDecision>;
-
-/**
- * A pending dependency change in the workspace dependency manager.
- * @internal
- */
-export declare interface _WorkspacePendingChange {
-    /** The dependency this change applies to. */
-    dependency: _WorkspaceDependency;
-    /** The action that will be taken. */
-    action: 'add' | 'already-satisfied' | 'conflict' | 'update';
-}
-
-/**
- * A post-generation hook to run after files are written: either a pnpm script or a direct exec.
- * @internal
- */
-export declare type _WorkspacePostGenerationHook = {
-    description?: string;
-    exec: string;
-} | {
-    description?: string;
-    script: string;
-};
-
-/**
- * Injectable collaborators for _regenAppProjectWorkspace.
- * Defaults to real implementations; override individual fields for testing.
- * @internal
- */
-export declare interface _WorkspaceServices {
-    /** Generate root workspace files from template variables. */
-    generateRoot: (vars: {
-        appId: string;
-        appName: string;
-        version: string;
-    }) => Promise<_WorkspaceGenerateResult>;
-    /** Generate extension workspace files for the given template key and variables. */
-    generateExtension: (key: string, vars: {
-        id: string;
-        name: string;
-        version: string;
-    }) => Promise<_WorkspaceGenerateResult>;
-    /** Write generated files to disk with the given options. */
-    writeFiles: (files: _WorkspaceGeneratedFile[], options?: _WorkspaceFileWriterOptions) => Promise<_WorkspaceFileWriteResult>;
-    /** Create a dependency manager scoped to the given working directory. */
-    createDepManager: (opts: {
-        context?: _CliContext;
-        cwd: string;
-    }) => _WorkspaceDependencyManager;
-    /** Generate custom object files (definition and test) from a name. */
-    generateCustomObject: (vars: { name: string }) => Promise<_WorkspaceGenerateResult>;
-    /** Generate the custom-objects workspace scaffolding (package.json, tsconfig.json). */
-    generateCustomObjectsWorkspace: (vars: { packagesSubfolder?: string }) => Promise<_WorkspaceGenerateResult>;
-    /** Load the stripe-app.yaml manifest from the given path. */
-    loadManifest: (manifestPath: string) => Promise<_WorkspaceManifest>;
-    /** Run post-generation hooks in the given working directory. */
-    runHooks: (hooks: _WorkspacePostGenerationHook[] | undefined, workingDir: string, disabled?: boolean, context?: _CliContext) => Promise<void>;
-}
-
-/**
- * Controls how the file writer handles existing files.
- * @internal
- */
-export declare type _WorkspaceWriteMode = _WorkspaceOverwritePromptCallback | 'abort-if-existing' | 'if-missing' | 'overwrite-all';
-
-/**
- * Write generated files to disk with configurable write behavior
- *
- * Write modes:
- * - 'overwrite-all': Overwrite all existing files without prompting
- * - 'abort-if-existing': Refuse to write ANY files if ANY exist (all-or-nothing, sets skipped=true)
- * - 'if-missing': Write only files that don't exist, skip existing ones individually
- * - function: Prompt for each existing file (y/n/a/q), allows selective overwriting
- *
- * Always creates parent directories as needed (mkdir -p behavior)
- *
- * @param files - Files to write
- * @param options - Write options (cwd, write mode, callbacks)
- * @returns Result with written files, existing files, and skip status
- *
- * @example
- * ```typescript
- * // All-or-nothing mode
- * const result = await _writeGeneratedFiles(files, {
- *   cwd: process.cwd(),
- *   write: 'abort-if-existing'
- * })
- * if (result.skipped) {
- *   throw new Error(`Files exist: ${result.existing.join(', ')}`)
- * }
- *
- * // Interactive mode
- * await _writeGeneratedFiles(files, {
- *   cwd: process.cwd(),
- *   write: async (path, newContent) => await _promptOverwrite(path)
- * })
- * ```
- * @internal
- */
-export declare function _writeGeneratedFiles(files: _GeneratedFile[], options?: _FileWriterOptions): Promise<_FileWriteResult>;
-
-/**
- * File write behavior modes
- * - 'overwrite-all': Overwrite all existing files
- * - 'abort-if-existing': Refuse to write ANY files if ANY already exist (all-or-nothing)
- * - 'if-missing': Skip individual files that exist, write only missing files
- * - function: Prompt before overwriting each file (interactive ask mode)
- * @internal
- */
-export declare type _WriteMode = _OverwritePromptCallback | 'abort-if-existing' | 'if-missing' | 'overwrite-all';
-
-export { }