@funnelsgrove/cli 0.1.262 → 0.1.264

package/README.md

@@ -123,6 +123,7 @@ Analytics workflow:
 fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11
 fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --date 2026-06-11
 fgrove analytics transitions --project claimbee --funnel claimbee-ios --date 2026-06-11
+fgrove analytics versions --project claimbee --funnel claimbee-ios
 fgrove analytics cohort --project claimbee --date 2026-06-11
 ```
 
@@ -132,7 +133,16 @@ Each analytics command accepts `--format table|json`, `--out <path>`, `--workspa
 fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json --out conversions.json
 ```
 
-`conversions` downloads the one-day conversion totals, primary conversion metrics, full funnel path rows, and step transitions. `funnel-path` focuses on the ordered path report. `transitions` focuses on step-by-step advanced/drop-off counts. `cohort` downloads synced marketing cohort economics for the day. If the requested day has no synced data, or cohort source data is incomplete, the CLI exits non-zero with a human-readable explanation.
+`conversions` downloads conversion totals, primary conversion metrics, full funnel path rows, and step transitions. `funnel-path` focuses on the ordered path report. `transitions` focuses on step-by-step advanced/drop-off counts. `cohort` downloads synced marketing cohort economics for the day. If the requested period has no synced data, or cohort source data is incomplete, the CLI exits non-zero with a human-readable explanation.
+
+`conversions`, `funnel-path`, and `transitions` report one day with `--date`, or a range with `--from` and `--to` (inclusive, totals for the whole range). They report the current Journey Version by default, like Funnel Analytics in the console. Traffic from before the last structural change belongs to an older Journey Version: list the versions with `versions`, then pass `--journey-version <id>`:
+
+```bash
+fgrove analytics versions --project claimbee --funnel claimbee-ios
+fgrove analytics transitions --project claimbee --funnel claimbee-ios --from 2026-06-01 --to 2026-06-14 --journey-version <journey-version-id>
+```
+
+`versions` lists each Journey Version newest first with its id, start time, active days, and visitors on those days. Active days are dates in `--timezone` (the API default, America/Los_Angeles, when omitted); the day a version replaced its predecessor belongs to both, and each version counts only its own visitors. An explicit version reports its own metrics and its own step structure. `--journey-version all` counts every version and orders `funnel-path` by the current published flow, so steps that exist only in older versions appear in `transitions` but not in `funnel-path`. JSON reports include `from`, `to`, and a `journeyVersion` object (`id`, `seq`, `label`, `startedAt`, `isCurrent`); `date` is set only for a one-day report. Table titles end with the reported version, for example `Journey 2 (current)`. The `overview` block of `conversions` always covers all Journey Versions.
 
 The package also keeps the longer `funnelsgrove` command as a compatibility alias.
 

package/dist/analyticsOutput.d.ts

@@ -53,20 +53,8 @@ export type AnalyticsStepDropoffResponse = {
         slug: string;
     };
     version: {
-        selected: {
-            id: string;
-            seq: number;
-            message: string | null;
-            publishedAt: string | null;
-            isCurrent: boolean;
-        } | null;
-        options: Array<{
-            id: string;
-            seq: number;
-            message: string | null;
-            publishedAt: string | null;
-            isCurrent: boolean;
-        }>;
+        selected: AnalyticsJourneyVersionOption | null;
+        options: AnalyticsJourneyVersionOption[];
     };
     totals: Record<string, number>;
     metrics: Array<{
@@ -83,6 +71,30 @@ export type AnalyticsStepDropoffResponse = {
     steps: AnalyticsStepTransition[];
     flow: AnalyticsFunnelFlow | null;
 };
+export type AnalyticsJourneyVersionOption = {
+    id: string;
+    seq: number;
+    message: string | null;
+    publishedAt: string | null;
+    isCurrent: boolean;
+};
+export type AnalyticsReportJourneyVersion = {
+    id: string;
+    seq: number | null;
+    label: string;
+    startedAt: string | null;
+    isCurrent: boolean;
+};
+export type AnalyticsJourneyVersionRow = {
+    id: string;
+    seq: number;
+    label: string;
+    isCurrent: boolean;
+    startedAt: string | null;
+    activeFrom: string | null;
+    activeTo: string | null;
+    visitors: number | null;
+};
 export type AnalyticsStepTransition = {
     stepId: string;
     stepName: string | null;
@@ -153,11 +165,32 @@ type ReportContext = {
     workspaceId: string;
     project: AnalyticsProjectSummary;
 };
-export declare const parseAnalyticsDate: (value: string) => ParsedAnalyticsDate;
+type FunnelReportContext = {
+    period: AnalyticsPeriod;
+    journeyVersion: string;
+    workspaceId: string;
+    project: AnalyticsProjectSummary;
+    stepDropoff: AnalyticsStepDropoffResponse;
+};
+export declare const parseAnalyticsDate: (value: string, flag?: string) => ParsedAnalyticsDate;
+export type AnalyticsPeriod = {
+    date: string | null;
+    from: string;
+    to: string;
+    label: string;
+};
+export declare const parseAnalyticsPeriod: (input: {
+    date?: string;
+    from?: string;
+    to?: string;
+}) => AnalyticsPeriod & {
+    fromIso: string;
+    toIso: string;
+};
 export declare const normalizeAnalyticsOutputFormat: (value: string | undefined) => AnalyticsOutputFormat;
 export declare const assertHasConversionData: (date: string, overview: AnalyticsOverviewResponse, stepDropoff: AnalyticsStepDropoffResponse) => void;
 export declare const assertHasTransitionData: (date: string, stepDropoff: AnalyticsStepDropoffResponse) => void;
-export declare const assertHasFunnelPathData: (date: string, stepDropoff: AnalyticsStepDropoffResponse, publishedFunnelFlow: PublishedFunnelFlowResponse) => void;
+export declare const assertHasFunnelPathData: (date: string, stepDropoff: AnalyticsStepDropoffResponse, pathFlow: AnalyticsFunnelFlow | null) => void;
 export declare const assertHasCohortData: (date: string, report: MarketingCohortPerformanceReport) => void;
 export declare const buildTransitionRows: (stepDropoff: AnalyticsStepDropoffResponse) => {
     stepId: string;
@@ -168,7 +201,7 @@ export declare const buildTransitionRows: (stepDropoff: AnalyticsStepDropoffResp
     dropoffs: number;
     dropoffRate: number;
 }[];
-export declare const buildFunnelPathRows: (stepDropoff: AnalyticsStepDropoffResponse, publishedFunnelFlow: PublishedFunnelFlowResponse) => {
+export declare const buildFunnelPathRows: (stepDropoff: AnalyticsStepDropoffResponse, pathFlow: AnalyticsFunnelFlow | null) => {
     stepId: string;
     path: string;
     label: string;
@@ -178,20 +211,11 @@ export declare const buildFunnelPathRows: (stepDropoff: AnalyticsStepDropoffResp
     dropoffs: number;
     dropoffRate: number;
 }[];
-export declare const buildConversionReportPayload: (input: ReportContext & {
+export declare const journeyVersionLabel: (version: Pick<AnalyticsJourneyVersionOption, "seq">) => string;
+export declare const buildConversionReportPayload: (input: FunnelReportContext & {
     overview: AnalyticsOverviewResponse;
-    stepDropoff: AnalyticsStepDropoffResponse;
-    publishedFunnelFlow: PublishedFunnelFlowResponse;
+    pathFlow: AnalyticsFunnelFlow | null;
 }) => {
-    generatedAt: string;
-    date: string;
-    workspaceId: string;
-    project: AnalyticsProjectSummary;
-    funnel: {
-        id: string;
-        name: string;
-        slug: string;
-    };
     overview: AnalyticsOverviewResponse;
     totals: Record<string, number>;
     metrics: {
@@ -224,13 +248,10 @@ export declare const buildConversionReportPayload: (input: ReportContext & {
         dropoffs: number;
         dropoffRate: number;
     }[];
-};
-export declare const buildFunnelPathReportPayload: (input: ReportContext & {
-    stepDropoff: AnalyticsStepDropoffResponse;
-    publishedFunnelFlow: PublishedFunnelFlowResponse;
-}) => {
     generatedAt: string;
-    date: string;
+    date: string | null;
+    from: string;
+    to: string;
     workspaceId: string;
     project: AnalyticsProjectSummary;
     funnel: {
@@ -238,6 +259,11 @@ export declare const buildFunnelPathReportPayload: (input: ReportContext & {
         name: string;
         slug: string;
     };
+    journeyVersion: AnalyticsReportJourneyVersion | null;
+};
+export declare const buildFunnelPathReportPayload: (input: FunnelReportContext & {
+    pathFlow: AnalyticsFunnelFlow | null;
+}) => {
     funnelPath: {
         stepId: string;
         path: string;
@@ -248,12 +274,10 @@ export declare const buildFunnelPathReportPayload: (input: ReportContext & {
         dropoffs: number;
         dropoffRate: number;
     }[];
-};
-export declare const buildTransitionReportPayload: (input: ReportContext & {
-    stepDropoff: AnalyticsStepDropoffResponse;
-}) => {
     generatedAt: string;
-    date: string;
+    date: string | null;
+    from: string;
+    to: string;
     workspaceId: string;
     project: AnalyticsProjectSummary;
     funnel: {
@@ -261,6 +285,9 @@ export declare const buildTransitionReportPayload: (input: ReportContext & {
         name: string;
         slug: string;
     };
+    journeyVersion: AnalyticsReportJourneyVersion | null;
+};
+export declare const buildTransitionReportPayload: (input: FunnelReportContext) => {
     transitions: {
         stepId: string;
         step: string;
@@ -270,6 +297,18 @@ export declare const buildTransitionReportPayload: (input: ReportContext & {
         dropoffs: number;
         dropoffRate: number;
     }[];
+    generatedAt: string;
+    date: string | null;
+    from: string;
+    to: string;
+    workspaceId: string;
+    project: AnalyticsProjectSummary;
+    funnel: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    journeyVersion: AnalyticsReportJourneyVersion | null;
 };
 export declare const buildCohortReportPayload: (input: ReportContext & {
     cohort: MarketingCohortPerformanceReport;
@@ -285,21 +324,34 @@ export declare const buildCohortReportPayload: (input: ReportContext & {
     } | null;
 };
 export declare const formatAnalyticsJson: (payload: unknown) => string;
-export declare const formatTransitionsTable: (input: {
-    date: string;
-    stepDropoff: AnalyticsStepDropoffResponse;
+type FunnelReportTableInput = Pick<FunnelReportContext, 'period' | 'journeyVersion' | 'stepDropoff'>;
+export declare const formatTransitionsTable: (input: FunnelReportTableInput) => string;
+export declare const formatFunnelPathTable: (input: FunnelReportTableInput & {
+    pathFlow: AnalyticsFunnelFlow | null;
 }) => string;
-export declare const formatFunnelPathTable: (input: {
-    date: string;
-    stepDropoff: AnalyticsStepDropoffResponse;
-    publishedFunnelFlow: PublishedFunnelFlowResponse;
-}) => string;
-export declare const formatConversionsTable: (input: {
-    date: string;
+export declare const formatConversionsTable: (input: FunnelReportTableInput & {
     overview: AnalyticsOverviewResponse;
-    stepDropoff: AnalyticsStepDropoffResponse;
-    publishedFunnelFlow: PublishedFunnelFlowResponse;
+    pathFlow: AnalyticsFunnelFlow | null;
 }) => string;
+type JourneyVersionsReport = {
+    funnel: AnalyticsStepDropoffResponse['funnel'];
+    versions: AnalyticsJourneyVersionRow[];
+};
+export declare const buildJourneyVersionsReportPayload: (input: JourneyVersionsReport & {
+    workspaceId: string;
+    project: AnalyticsProjectSummary;
+}) => {
+    generatedAt: string;
+    workspaceId: string;
+    project: AnalyticsProjectSummary;
+    funnel: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    versions: AnalyticsJourneyVersionRow[];
+};
+export declare const formatJourneyVersionsTable: (input: JourneyVersionsReport) => string;
 export declare const formatCohortTable: (input: {
     date: string;
     cohort: MarketingCohortPerformanceReport;

package/dist/analyticsOutput.js

@@ -1,8 +1,8 @@
-export const parseAnalyticsDate = (value) => {
+export const parseAnalyticsDate = (value, flag = '--date') => {
     const trimmed = value.trim();
     const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(trimmed);
     if (!match) {
-        throw new Error('Expected --date in YYYY-MM-DD format.');
+        throw new Error(`Expected ${flag} in YYYY-MM-DD format.`);
     }
     const year = Number(match[1]);
     const month = Number(match[2]);
@@ -13,7 +13,7 @@ export const parseAnalyticsDate = (value) => {
         parsed.getUTCMonth() + 1 === month &&
         parsed.getUTCDate() === day;
     if (!isRealDate) {
-        throw new Error('Expected --date to be a real calendar date.');
+        throw new Error(`Expected ${flag} to be a real calendar date.`);
     }
     return {
         date: trimmed,
@@ -21,6 +21,32 @@ export const parseAnalyticsDate = (value) => {
         toIso: `${trimmed}T23:59:59.999Z`,
     };
 };
+export const parseAnalyticsPeriod = (input) => {
+    if (input.date !== undefined) {
+        if (input.from !== undefined || input.to !== undefined) {
+            throw new Error('Use either --date or --from with --to, not both.');
+        }
+        const day = parseAnalyticsDate(input.date);
+        return { date: day.date, from: day.date, to: day.date, label: day.date, fromIso: day.fromIso, toIso: day.toIso };
+    }
+    if (input.from === undefined || input.to === undefined) {
+        throw new Error('Pass --date, or --from together with --to.');
+    }
+    const from = parseAnalyticsDate(input.from, '--from');
+    const to = parseAnalyticsDate(input.to, '--to');
+    if (from.date > to.date) {
+        throw new Error('--from must be on or before --to.');
+    }
+    const date = from.date === to.date ? from.date : null;
+    return {
+        date,
+        from: from.date,
+        to: to.date,
+        label: date ?? `${from.date}..${to.date}`,
+        fromIso: from.fromIso,
+        toIso: to.toIso,
+    };
+};
 export const normalizeAnalyticsOutputFormat = (value) => {
     const normalized = (value || 'table').trim().toLowerCase();
     if (normalized === 'table' || normalized === 'json') {
@@ -40,6 +66,9 @@ const hasPositiveNumber = (value) => {
     }
     return false;
 };
+const olderJourneyVersionHint = (stepDropoff) => (stepDropoff.version.selected?.isCurrent && stepDropoff.version.options.length > 1
+    ? ' Traffic on these dates may belong to an older journey version: list them with `fgrove analytics versions` and pass --journey-version.'
+    : '');
 export const assertHasConversionData = (date, overview, stepDropoff) => {
     if (hasPositiveNumber(overview.totals) ||
         hasPositiveNumber(overview.byDay) ||
@@ -47,19 +76,19 @@ export const assertHasConversionData = (date, overview, stepDropoff) => {
         hasPositiveNumber(stepDropoff.steps)) {
         return;
     }
-    throw new Error(`No synced conversion data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked traffic that day.`);
+    throw new Error(`No synced conversion data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked traffic in that period.${olderJourneyVersionHint(stepDropoff)}`);
 };
 export const assertHasTransitionData = (date, stepDropoff) => {
     if (stepDropoff.steps.length > 0 && hasPositiveNumber(stepDropoff.steps)) {
         return;
     }
-    throw new Error(`No synced step transition data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked step traffic that day.`);
+    throw new Error(`No synced step transition data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked step traffic in that period.${olderJourneyVersionHint(stepDropoff)}`);
 };
-export const assertHasFunnelPathData = (date, stepDropoff, publishedFunnelFlow) => {
-    if (buildFunnelPathRows(stepDropoff, publishedFunnelFlow).length > 0) {
+export const assertHasFunnelPathData = (date, stepDropoff, pathFlow) => {
+    if (buildFunnelPathRows(stepDropoff, pathFlow).length > 0) {
         return;
     }
-    throw new Error(`No synced full funnel path data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked path traffic that day.`);
+    throw new Error(`No synced full funnel path data found for ${date}. Analytics may not have synced yet, or the funnel had no tracked path traffic in that period.${olderJourneyVersionHint(stepDropoff)}`);
 };
 export const assertHasCohortData = (date, report) => {
     if (report.sourceHealth && !report.sourceHealth.complete) {
@@ -96,12 +125,12 @@ export const buildTransitionRows = (stepDropoff) => [...stepDropoff.steps]
     dropoffs: step.dropoffs,
     dropoffRate: step.dropoffRate,
 }));
-export const buildFunnelPathRows = (stepDropoff, publishedFunnelFlow) => {
-    if (publishedFunnelFlow.status !== 'ready' || !publishedFunnelFlow.flow) {
+export const buildFunnelPathRows = (stepDropoff, pathFlow) => {
+    if (!pathFlow) {
         return [];
     }
     const transitionsByStepId = new Map(stepDropoff.steps.map((step) => [step.stepId, step]));
-    return [...publishedFunnelFlow.flow.steps]
+    return [...pathFlow.steps]
         .sort((left, right) => left.stepOrder - right.stepOrder || left.stepId.localeCompare(right.stepId))
         .map((flowStep) => {
         const step = transitionsByStepId.get(flowStep.stepId);
@@ -118,32 +147,55 @@ export const buildFunnelPathRows = (stepDropoff, publishedFunnelFlow) => {
         };
     });
 };
-export const buildConversionReportPayload = (input) => ({
+export const journeyVersionLabel = (version) => `Journey ${version.seq}`;
+const describeReportJourneyVersion = (input) => {
+    if (input.journeyVersion === 'all') {
+        return { id: 'all', seq: null, label: 'All journey versions', startedAt: null, isCurrent: false };
+    }
+    const selected = input.stepDropoff.version.selected;
+    return selected
+        ? {
+            id: selected.id,
+            seq: selected.seq,
+            label: journeyVersionLabel(selected),
+            startedAt: selected.publishedAt,
+            isCurrent: selected.isCurrent,
+        }
+        : null;
+};
+const buildFunnelReportHeader = (input) => ({
     generatedAt: new Date().toISOString(),
-    date: input.date,
+    date: input.period.date,
+    from: input.period.from,
+    to: input.period.to,
     workspaceId: input.workspaceId,
     project: input.project,
     funnel: input.stepDropoff.funnel,
+    journeyVersion: describeReportJourneyVersion(input),
+});
+const formatFunnelReportTitle = (title, input) => {
+    const version = describeReportJourneyVersion(input);
+    return [
+        title,
+        input.period.label,
+        input.stepDropoff.funnel.name,
+        ...(version ? [version.isCurrent ? `${version.label} (current)` : version.label] : []),
+    ].join('\t');
+};
+export const buildConversionReportPayload = (input) => ({
+    ...buildFunnelReportHeader(input),
     overview: input.overview,
     totals: input.stepDropoff.totals,
     metrics: input.stepDropoff.metrics,
-    funnelPath: buildFunnelPathRows(input.stepDropoff, input.publishedFunnelFlow),
+    funnelPath: buildFunnelPathRows(input.stepDropoff, input.pathFlow),
     transitions: buildTransitionRows(input.stepDropoff),
 });
 export const buildFunnelPathReportPayload = (input) => ({
-    generatedAt: new Date().toISOString(),
-    date: input.date,
-    workspaceId: input.workspaceId,
-    project: input.project,
-    funnel: input.stepDropoff.funnel,
-    funnelPath: buildFunnelPathRows(input.stepDropoff, input.publishedFunnelFlow),
+    ...buildFunnelReportHeader(input),
+    funnelPath: buildFunnelPathRows(input.stepDropoff, input.pathFlow),
 });
 export const buildTransitionReportPayload = (input) => ({
-    generatedAt: new Date().toISOString(),
-    date: input.date,
-    workspaceId: input.workspaceId,
-    project: input.project,
-    funnel: input.stepDropoff.funnel,
+    ...buildFunnelReportHeader(input),
     transitions: buildTransitionRows(input.stepDropoff),
 });
 export const buildCohortReportPayload = (input) => ({
@@ -157,7 +209,7 @@ export const buildCohortReportPayload = (input) => ({
 export const formatAnalyticsJson = (payload) => `${JSON.stringify(payload, null, 2)}\n`;
 export const formatTransitionsTable = (input) => {
     const lines = [
-        `Step transitions\t${input.date}\t${input.stepDropoff.funnel.name}`,
+        formatFunnelReportTitle('Step transitions', input),
         'step\tnextStep\tentrants\tadvanced\tdropoffs\tdropoffRate',
     ];
     for (const row of buildTransitionRows(input.stepDropoff)) {
@@ -174,10 +226,10 @@ export const formatTransitionsTable = (input) => {
 };
 export const formatFunnelPathTable = (input) => {
     const lines = [
-        `Full funnel path\t${input.date}\t${input.stepDropoff.funnel.name}`,
+        formatFunnelReportTitle('Full funnel path', input),
         'step\tpath\tusers\tadvanced\tconversionToNext\tdropoffs\tdropoffRate',
     ];
-    for (const row of buildFunnelPathRows(input.stepDropoff, input.publishedFunnelFlow)) {
+    for (const row of buildFunnelPathRows(input.stepDropoff, input.pathFlow)) {
         lines.push([
             row.label,
             row.path,
@@ -194,7 +246,7 @@ export const formatConversionsTable = (input) => {
     const totals = input.stepDropoff.totals;
     const overviewTotals = input.overview.totals;
     const lines = [
-        `Conversions\t${input.date}\t${input.stepDropoff.funnel.name}`,
+        formatFunnelReportTitle('Conversions', input),
         'metric\tvalue',
         ['visitors', formatNumber(totals.visitors ?? overviewTotals.visitors ?? 0)].join('\t'),
         ['quizEntries', formatNumber(totals.quizEntries ?? 0)].join('\t'),
@@ -217,11 +269,31 @@ export const formatConversionsTable = (input) => {
             formatPercent(metric.rate),
         ].join('\t'));
     }
-    lines.push('', formatFunnelPathTable({
-        date: input.date,
-        stepDropoff: input.stepDropoff,
-        publishedFunnelFlow: input.publishedFunnelFlow,
-    }).trimEnd());
+    lines.push('', formatFunnelPathTable(input).trimEnd());
+    return `${lines.join('\n')}\n`;
+};
+export const buildJourneyVersionsReportPayload = (input) => ({
+    generatedAt: new Date().toISOString(),
+    workspaceId: input.workspaceId,
+    project: input.project,
+    funnel: input.funnel,
+    versions: input.versions,
+});
+export const formatJourneyVersionsTable = (input) => {
+    const lines = [
+        `Journey versions\t${input.funnel.name}`,
+        'version\tid\tstartedAt\tactiveFrom\tactiveTo\tvisitors',
+    ];
+    for (const version of input.versions) {
+        lines.push([
+            version.isCurrent ? `${version.label} (current)` : version.label,
+            version.id,
+            version.startedAt || '',
+            version.activeFrom || '',
+            version.activeTo || '',
+            version.visitors === null ? '' : formatNumber(version.visitors),
+        ].join('\t'));
+    }
     return `${lines.join('\n')}\n`;
 };
 const flattenCohortRows = (rows) => rows.flatMap((row) => [row, ...(row.segments || []), ...(row.children || [])]);

package/dist/cli.d.ts

@@ -8,7 +8,7 @@ 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';
+import { type AnalyticsFunnelFlow, type AnalyticsJourneyVersionRow, type AnalyticsPeriod, type AnalyticsOutputFormat, type AnalyticsStepDropoffResponse } 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 {
@@ -142,6 +142,15 @@ type AnalyticsCommandInput = {
     format: AnalyticsOutputFormat;
     timezone?: string;
 };
+type FunnelAnalyticsCommandInput = {
+    period: AnalyticsPeriod & {
+        fromIso: string;
+        toIso: string;
+    };
+    format: AnalyticsOutputFormat;
+    timezone?: string;
+    journeyVersion: string;
+};
 type SyncTargetIdInput = {
     explicitWorkspaceId?: string;
     explicitFunnelId?: string;
@@ -161,6 +170,14 @@ export declare function buildAnalyticsCommandInput(options: {
     format?: string;
     timezone?: string;
 }): AnalyticsCommandInput;
+export declare function buildFunnelAnalyticsCommandInput(options: {
+    date?: string;
+    from?: string;
+    to?: string;
+    journeyVersion?: string;
+    format?: string;
+    timezone?: string;
+}): FunnelAnalyticsCommandInput;
 export declare function buildPatchSourceInput(input: {
     workspaceId: string;
     funnelId: string;
@@ -289,10 +306,18 @@ type FunnelPathAnalyticsInput = {
     workspaceId: string;
     projectId: string;
     funnelId: string;
-    commandInput: AnalyticsCommandInput;
+    commandInput: FunnelAnalyticsCommandInput;
 };
 export declare const fetchFunnelPathAnalytics: (input: FunnelPathAnalyticsInput, apiCall?: AnalyticsApiCall) => Promise<{
     stepDropoff: AnalyticsStepDropoffResponse;
-    publishedFunnelFlow: PublishedFunnelFlowResponse;
+    pathFlow: AnalyticsFunnelFlow | null;
+}>;
+type JourneyVersionsInput = Pick<FunnelPathAnalyticsInput, 'token' | 'workspaceId' | 'projectId' | 'funnelId'> & {
+    timezone?: string;
+    today: string;
+};
+export declare const fetchJourneyVersions: (input: JourneyVersionsInput, apiCall?: AnalyticsApiCall) => Promise<{
+    funnel: AnalyticsStepDropoffResponse["funnel"];
+    versions: AnalyticsJourneyVersionRow[];
 }>;
 export {};