@funnelsgrove/cli 0.1.15 → 0.1.18

package/dist/cli.d.ts

@@ -1,8 +1,133 @@
 #!/usr/bin/env node
+import { Command } from 'commander';
 import { type ActiveContext } from './authStore.js';
 import { type SourceFile, type SyncManifest } from './localSync.js';
 import { type GitHubStatusResponse } from './githubOutput.js';
-import { type AnalyticsOutputFormat } from './analyticsOutput.js';
+import { type DocsExitCode } from './docsOutput.js';
+import { type DocsDiagnostic, type DocsStatus } from './docsTransaction.js';
+import { type FunnelValidationExitCode, type FunnelValidationResult } from './diagnosticOutput.js';
+import { type StepContractMigrationApplyResult, type StepContractMigrationCheckResult, type StepContractMigrationTargetVersion, type StepContractMigrationValidationResult } from './stepContractMigration.js';
+import { type AnalyticsOutputFormat, type AnalyticsStepDropoffResponse, type PublishedFunnelFlowResponse } from './analyticsOutput.js';
+export declare const CANONICAL_CREATE_TEMPLATE_SLUG = "template";
+export declare const SCAFFOLD_TRANSIENT_PATHS: readonly ["node_modules", ".next", "out", "tsconfig.tsbuildinfo", ".funnelsgrove-scaffold.json"];
+export declare class CliContractError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare const assertCanonicalCreateTemplateSlug: (slug: string) => void;
+export declare const resolveCreateTemplatePath: (slug?: string) => string;
+export type DocsCommandOptions = {
+    check?: boolean;
+    diff?: boolean;
+    json?: boolean;
+    replaceManaged?: boolean;
+    resolve?: string;
+};
+export type DocsCommandMode = {
+    mode: 'apply';
+    json: boolean;
+} | {
+    mode: 'check';
+    json: boolean;
+} | {
+    mode: 'diff';
+    json: boolean;
+} | {
+    mode: 'resolve';
+    json: boolean;
+    path: string;
+};
+export declare function resolveDocsCommandMode(options: DocsCommandOptions): DocsCommandMode;
+export type DocsCommandBackend = {
+    recover: (targetDir: string) => Promise<void>;
+    inspect: (targetDir: string) => Promise<DocsStatus>;
+    apply: (targetDir: string, status: DocsStatus) => Promise<void>;
+    resolve: (targetDir: string, relativePath: string) => Promise<void>;
+};
+export type DocsCommandResult = {
+    exitCode: DocsExitCode;
+    output: string;
+};
+export declare const docsResolveConfirmation: (relativePath: string) => string;
+export declare function executeDocsCommand(input: {
+    targetDir: string;
+    options: DocsCommandOptions;
+    backend?: DocsCommandBackend;
+    auditLegacy?: (targetDir: string) => Promise<DocsDiagnostic | null>;
+    isTTY?: boolean;
+    prompt?: (question: string) => Promise<string>;
+}): Promise<DocsCommandResult>;
+type FunnelValidator = (targetDir: string) => Promise<FunnelValidationResult>;
+export type ValidateCommandResult = {
+    exitCode: FunnelValidationExitCode;
+    output: string;
+};
+export declare function executeValidateCommand(input: {
+    targetDir: string;
+    json?: boolean;
+    validate?: FunnelValidator;
+}): Promise<ValidateCommandResult>;
+export declare function auditLegacyFunnel(targetDir: string, validate?: FunnelValidator): Promise<DocsDiagnostic | null>;
+export declare class FunnelValidationError extends CliContractError {
+    readonly result: FunnelValidationResult;
+    constructor(result: FunnelValidationResult);
+}
+export declare function runValidatedFunnelMutation<T>(input: {
+    targetDir: string;
+    validate?: FunnelValidator;
+    mutate: () => Promise<T>;
+}): Promise<T>;
+export declare const toMigrationValidationResult: (result: FunnelValidationResult) => StepContractMigrationValidationResult;
+export type StepContractMigrationCommandOptions = {
+    check?: boolean;
+    apply?: boolean;
+    json?: boolean;
+};
+export type StepContractMigrationBackend = {
+    recoverMigration: (targetDir: string, targetVersion: StepContractMigrationTargetVersion) => Promise<unknown>;
+    recoverDocs: (targetDir: string) => Promise<unknown>;
+    check: (targetDir: string, targetVersion: StepContractMigrationTargetVersion) => Promise<StepContractMigrationCheckResult>;
+    apply: (targetDir: string, targetVersion: StepContractMigrationTargetVersion) => Promise<StepContractMigrationApplyResult>;
+};
+export type StepContractMigrationCommandResult = {
+    exitCode: 0 | 1 | 2;
+    output: string;
+};
+export declare const copyManagedValidationFiles: (targetDir: string, sourceDir?: string) => Promise<void>;
+export type BoundedNpmCommandOptions = {
+    timeoutMs?: number;
+    terminationGraceMs?: number;
+    finalizationGraceMs?: number;
+};
+export declare const runBoundedNpmCommand: (targetDir: string, args: readonly string[], options?: BoundedNpmCommandOptions) => Promise<void>;
+export declare function executeStepContractMigrationCommand(input: {
+    targetDir: string;
+    to: string | number;
+    options: StepContractMigrationCommandOptions;
+    backend?: StepContractMigrationBackend;
+}): Promise<StepContractMigrationCommandResult>;
+export type CreateFunnelHooks = {
+    verifyScaffold: (templatePath: string) => Promise<void>;
+    materializeAliases: (stageDir: string) => Promise<void>;
+    reskin: (stageDir: string, appName: string) => Promise<string[]>;
+    installManagedFiles: (stageDir: string) => Promise<void>;
+    installDependencies: (stageDir: string) => Promise<void>;
+    validate: FunnelValidator;
+    beforeCommit?: (outputPath: string) => Promise<void>;
+};
+export type CreateFunnelResult = {
+    outputPath: string;
+    updatedFiles: string[];
+};
+export declare const verifyPackagedScaffold: (templatePath: string) => Promise<void>;
+export declare const materializePackagedScaffoldAliases: (stageDir: string) => Promise<void>;
+export declare function executeCreateFunnel(input: {
+    templateSlug: string;
+    templatePath?: string;
+    outputPath: string;
+    appName: string;
+    hooks?: CreateFunnelHooks;
+}): Promise<CreateFunnelResult>;
 type AnalyticsCommandInput = {
     date: string;
     from: string;
@@ -44,6 +169,11 @@ export declare function buildPatchSourceInput(input: {
     files: SourceFile[];
     deletedPaths: string[];
 };
+export declare function formatSourceCandidateSyncSuccess(input: {
+    syncedFileCount: number;
+    deletedFileCount: number;
+    versionId: string;
+}): string;
 export declare function buildSyncOfferSetPlansInput(input: {
     workspaceId: string;
     funnelId: string;
@@ -65,4 +195,22 @@ export declare function buildGeneratedConfigSyncInput(input: {
 };
 export declare function selectGeneratedConfigFiles(files: SourceFile[], kinds: GeneratedConfigKind[]): SourceFile[];
 export declare function assertCanDraftSyncSource(status: GitHubStatusResponse): void;
+export declare const program: Command;
+type AnalyticsApiCall = (input: {
+    path: string;
+    type: 'query' | 'mutation';
+    data?: unknown;
+    token?: string | null;
+}) => Promise<unknown>;
+type FunnelPathAnalyticsInput = {
+    token: string;
+    workspaceId: string;
+    projectId: string;
+    funnelId: string;
+    commandInput: AnalyticsCommandInput;
+};
+export declare const fetchFunnelPathAnalytics: (input: FunnelPathAnalyticsInput, apiCall?: AnalyticsApiCall) => Promise<{
+    stepDropoff: AnalyticsStepDropoffResponse;
+    publishedFunnelFlow: PublishedFunnelFlowResponse;
+}>;
 export {};