@funnelsgrove/cli 0.1.12 → 0.1.14

package/dist/cli.d.ts

@@ -17,6 +17,8 @@ type SyncTargetIdInput = {
     active?: Pick<ActiveContext, 'workspaceId' | 'funnelId'> | null;
     defaultWorkspaceId?: string;
 };
+type GeneratedConfigKind = 'offerSets' | 'experiments';
+export declare const SYNC_DOWN_GENERATED_CONFIG_KINDS: GeneratedConfigKind[];
 export declare function resolveSyncTargetIds(input: SyncTargetIdInput): {
     workspaceId: string;
     funnelId?: string;
@@ -42,5 +44,25 @@ export declare function buildPatchSourceInput(input: {
     files: SourceFile[];
     deletedPaths: string[];
 };
+export declare function buildSyncOfferSetPlansInput(input: {
+    workspaceId: string;
+    funnelId: string;
+    offerSet: string;
+}): {
+    workspaceId: string;
+    funnelId: string;
+    offerSetId?: string;
+    offerSetKey?: string;
+};
+export declare function buildGeneratedConfigSyncInput(input: {
+    workspaceId: string;
+    funnelId: string;
+    kinds: GeneratedConfigKind[];
+}): {
+    workspaceId: string;
+    funnelId: string;
+    kinds: GeneratedConfigKind[];
+};
+export declare function selectGeneratedConfigFiles(files: SourceFile[], kinds: GeneratedConfigKind[]): SourceFile[];
 export declare function assertCanDraftSyncSource(status: GitHubStatusResponse): void;
 export {};

package/dist/cli.js

@@ -38,6 +38,11 @@ const DEFAULT_API_URL = 'https://api.funnelsgrove.com/trpc';
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const PUBLISH_POLL_INTERVAL_MS = 2_000;
 const PUBLISH_WAIT_TIMEOUT_MS = 30 * 60_000;
+const GENERATED_CONFIG_PATH_BY_KIND = {
+    offerSets: 'src/config/offer-sets.generated.ts',
+    experiments: 'src/config/experiments.generated.ts',
+};
+export const SYNC_DOWN_GENERATED_CONFIG_KINDS = ['offerSets', 'experiments'];
 export function resolveSyncTargetIds(input) {
     const workspaceId = input.explicitWorkspaceId ||
         input.manifest?.workspaceId ||
@@ -83,6 +88,28 @@ export function buildPatchSourceInput(input) {
         deletedPaths: input.deletedPaths,
     };
 }
+export function buildSyncOfferSetPlansInput(input) {
+    const offerSet = input.offerSet.trim();
+    if (!offerSet) {
+        throw new Error('--offer-set is required');
+    }
+    return {
+        workspaceId: input.workspaceId,
+        funnelId: input.funnelId,
+        ...(UUID_PATTERN.test(offerSet) ? { offerSetId: offerSet } : { offerSetKey: offerSet }),
+    };
+}
+export function buildGeneratedConfigSyncInput(input) {
+    return {
+        workspaceId: input.workspaceId,
+        funnelId: input.funnelId,
+        kinds: input.kinds,
+    };
+}
+export function selectGeneratedConfigFiles(files, kinds) {
+    const allowedPaths = new Set(kinds.map((kind) => GENERATED_CONFIG_PATH_BY_KIND[kind]));
+    return files.filter((file) => allowedPaths.has(file.path));
+}
 export function assertCanDraftSyncSource(status) {
     if (status.connection && status.connection.status !== 'disconnected') {
         throw new Error('This funnel is connected to GitHub. Commit and push changes with git, then run `fgrove github pull` to sync the hosted draft. Do not use `fgrove sync up` for the same change.');
@@ -352,6 +379,22 @@ const syncGitHubDraftForCli = async (input) => {
         console.log(summary);
     }
 };
+const formatGeneratedFileCount = (count) => `${count} generated config ${count === 1 ? 'file' : 'files'}`;
+const syncGeneratedConfigFilesForCli = async (input) => {
+    const result = await callApi({
+        path: 'funnels.generatedConfigFiles',
+        type: 'query',
+        token: input.token,
+        data: buildGeneratedConfigSyncInput({
+            workspaceId: input.target.workspaceId,
+            funnelId: input.target.funnelId,
+            kinds: input.kinds,
+        }),
+    });
+    const files = selectGeneratedConfigFiles(result.files, input.kinds);
+    await writeSourceFiles(input.target.sourceDir, files);
+    return files;
+};
 const addExamples = (command, examples) => command.addHelpText('after', `\nExamples:\n${examples.map((example) => `  $ ${example}`).join('\n')}`);
 const program = new Command();
 program
@@ -525,6 +568,80 @@ addExamples(funnelsCommand
     });
     console.log(`${result.funnel.id}\t${result.funnel.name}\t${result.funnel.slug}`);
 });
+const offerSetsCommand = addExamples(program.command('offer-sets').alias('offers').description('Manage project offer sets'), [
+    'fgrove offer-sets sync --offer-set default-paywall',
+    'fgrove offers sync --funnel claimbee-ios --offer-set three-month-test',
+]);
+addExamples(offerSetsCommand
+    .command('sync')
+    .description('Apply an offer set to a funnel draft billing snapshot')
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--funnel <id-or-slug>', 'Funnel id or slug')
+    .option('--dir <path>', 'Local source directory for reading sync manifest', '.')
+    .requiredOption('--offer-set <key-or-id>', 'Offer set key or id'), [
+    'fgrove offer-sets sync --offer-set default-paywall',
+    'fgrove offers sync --funnel claimbee-ios --offer-set quarterly-test',
+])
+    .action(async (options) => {
+    const token = await readAuthToken();
+    const target = await resolveSyncTarget({
+        token,
+        workspace: options.workspace,
+        funnel: options.funnel,
+        dir: options.dir,
+    });
+    const result = await callApi({
+        path: 'funnels.syncOfferSetPlans',
+        type: 'mutation',
+        token,
+        data: buildSyncOfferSetPlansInput({
+            workspaceId: target.workspaceId,
+            funnelId: target.funnelId,
+            offerSet: options.offerSet,
+        }),
+    });
+    const generatedFiles = await syncGeneratedConfigFilesForCli({
+        token,
+        target,
+        kinds: ['offerSets'],
+    });
+    await syncGitHubDraftForCli({
+        token,
+        workspaceId: target.workspaceId,
+        funnelId: target.funnelId,
+    });
+    const offerSetLabel = result.offerSet?.key || result.offerSet?.display_name || options.offerSet.trim();
+    console.log(`Synced offer set ${offerSetLabel} to funnel draft`);
+    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
+});
+const experimentsCommand = addExamples(program.command('experiments').description('Manage funnel experiments'), [
+    'fgrove experiments sync',
+    'fgrove experiments sync --funnel claimbee-ios',
+]);
+addExamples(experimentsCommand
+    .command('sync')
+    .description('Write generated experiment config for a funnel')
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--funnel <id-or-slug>', 'Funnel id or slug')
+    .option('--dir <path>', 'Local source directory for reading sync manifest', '.'), [
+    'fgrove experiments sync',
+    'fgrove experiments sync --funnel claimbee-ios --dir ./claimbee-ios',
+])
+    .action(async (options) => {
+    const token = await readAuthToken();
+    const target = await resolveSyncTarget({
+        token,
+        workspace: options.workspace,
+        funnel: options.funnel,
+        dir: options.dir,
+    });
+    const generatedFiles = await syncGeneratedConfigFilesForCli({
+        token,
+        target,
+        kinds: ['experiments'],
+    });
+    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
+});
 const analyticsCommand = addExamples(program.command('analytics').description('Download and inspect project analytics'), [
     'fgrove analytics conversions --project claimbee --funnel claimbee-ios --date 2026-06-11 --format json --out analytics.json',
     'fgrove analytics funnel-path --project claimbee --funnel claimbee-ios --date 2026-06-11',
@@ -794,6 +911,11 @@ addExamples(syncCommand
     });
     await mkdir(target.sourceDir, { recursive: true });
     await writeSourceFiles(target.sourceDir, result.files);
+    const generatedFiles = await syncGeneratedConfigFilesForCli({
+        token,
+        target,
+        kinds: SYNC_DOWN_GENERATED_CONFIG_KINDS,
+    });
     await writeLocalEnvFile(target.sourceDir, result.envFile);
     await ensureGitignore(target.sourceDir);
     await writeSyncManifest(target.sourceDir, await buildSyncManifest(target.sourceDir, {
@@ -802,6 +924,7 @@ addExamples(syncCommand
         draftVersionId: result.draftVersionId,
     }));
     console.log(`Synced ${result.files.length} files to ${target.sourceDir}`);
+    console.log(`Wrote ${formatGeneratedFileCount(generatedFiles.length)}`);
 });
 const envCommand = addExamples(program.command('env').description('Manage local funnel environment files'), [
     'fgrove env pull --dir ./claimbee-ios',

package/dist/localSync.d.ts

@@ -15,6 +15,7 @@ export type SourceFile = {
     path: string;
     content: string;
     contentType?: string;
+    contentEncoding?: 'base64';
 };
 export type ChangedSourceFiles = {
     currentManifest: SyncManifest;

package/dist/localSync.js

@@ -213,7 +213,8 @@ export async function writeSourceFiles(rootDir, files) {
         const relativePath = assertSafeSyncPath(file.path);
         const absolutePath = path.join(rootDir, relativePath);
         await mkdir(path.dirname(absolutePath), { recursive: true });
-        await writeFile(absolutePath, decodeDataUrl(file.content) || file.content, decodeDataUrl(file.content) ? undefined : 'utf8');
+        const decodedContent = decodeBinarySourceContent(file);
+        await writeFile(absolutePath, decodedContent || file.content, decodedContent ? undefined : 'utf8');
     }
 }
 async function collectSyncFiles(rootDir, dir) {
@@ -270,3 +271,16 @@ function decodeDataUrl(content) {
     }
     return Buffer.from(match[2].replace(/\s+/g, '').replace(/-/g, '+').replace(/_/g, '/'), 'base64');
 }
+function decodeBase64Content(content) {
+    const normalized = content.trim().replace(/\s+/g, '').replace(/-/g, '+').replace(/_/g, '/');
+    if (!normalized || !/^[A-Za-z0-9+/=]+$/.test(normalized)) {
+        return null;
+    }
+    return Buffer.from(normalized, 'base64');
+}
+function decodeBinarySourceContent(file) {
+    if (file.contentEncoding === 'base64') {
+        return decodeBase64Content(file.content);
+    }
+    return decodeDataUrl(file.content);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "type": "module",
   "bin": {

package/template_docs/docs/ab-experiments.md

@@ -29,6 +29,8 @@ That's it — `toManifestExperiments(experiments)` in the same file feeds the ma
 
 When a visitor opens the source step, the runtime suspends rendering until the assignment from `@funnelsgrove/analytics` is ready, then routes to the assigned `stepId` and syncs the URL. After assignment, navigation continues through the assigned step's normal edges — the experiment is not re-evaluated mid-flow. Assignments are sticky per visitor.
 
+Feature-flag evaluation is scoped by the public project and funnel ids (`NEXT_PUBLIC_PROJECT_ID` and `NEXT_PUBLIC_FUNNEL_ID`). The shared runtime bootstrap fills that scope from public env when callers omit it; if a local funnel owns a custom controller, keep those ids wired into PostHog flag bootstrap or verify the runtime fallback is still in place.
+
 The paywall runtime is experiment-ready out of the box: paywall variants can differ in copy, layout, plan presentation, or pricing source, and checkout/discount state stays scoped per funnel.
 
 ## Verify (part of the < 1 min setup)