@funnelsgrove/cli 0.1.295 → 0.1.297

package/README.md

@@ -205,6 +205,25 @@ Publishing creates new rows and updates rows already present in the file. It nev
 deletes remote expenses that are absent from the file, and it refuses to overwrite
 rows changed since the last pull. Pull again to resolve a concurrent edit.
 
+Edit Offer Sets the same way. For discounted intro prices and two-stage discounts,
+see the repository guide
+`docs/guides/edit-offer-sets.md`:
+
+```bash
+fgrove offer-sets pull --project claimbee            # writes offer-sets.json
+fgrove offer-sets prices --project claimbee --env live
+# edit offer-sets.json; for a new set omit id/updatedAt, keep paymentProfileId
+fgrove offer-sets publish --project claimbee --dry-run
+fgrove offer-sets publish --project claimbee
+```
+
+Only changed sets are sent. Set `isActive` to `false` to archive a set, which
+fails while a funnel, route, domain or experiment still uses it. Sets absent
+from the file are never deleted, and publishing refuses sets changed since the
+last pull. Item `paymentProfileBindings` (for example a PayPal binding) are not
+in the file; existing ones are kept, and a new set copied from another starts
+without them.
+
 Use `--api-url` or `FUNNELSGROVE_API_URL` for non-production APIs.
 Use `--config` or `FUNNELSGROVE_CONFIG` to keep test credentials separate from the default `~/.funnelsgrove/config.json`.
 

package/dist/cli.js

@@ -19,6 +19,7 @@ import { pullEnvFile } from './envSync.js';
 import { executeFastDraftPatchSync, uploadDirectAssetWithFetch } from './draftPatchSync.js';
 import { updateCliInstallations } from './selfUpdate.js';
 import { executeExpensePublish, executeExpensePull } from './expenseCommands.js';
+import { executeOfferSetPrices, executeOfferSetPublish, executeOfferSetPull, formatOfferSetPriceCatalogs, } from './offerSetCommands.js';
 import { executeEmailPull, executeEmailPush, executeEmailSend, executeEmailUpdateVariables, executeEmailSequenceAddStep, executeEmailSequenceCancel, executeEmailSequenceCreate, executeEmailSequencePublish, executeEmailSequenceSetActive, executeEmailLibraryAdd, executeEmailLibraryList, executeEmailTemplatePublish, executeEmailValidate, parseEmailVariablesJson, } from './emailCommands.js';
 import { formatGitHubConnectRows, formatGitHubJobRows, formatGitHubStatusRows, } from './githubOutput.js';
 import { GitHubSyncTimeoutError, syncGitHubDraftIfConnected, } from './githubSyncFlow.js';
@@ -2160,6 +2161,58 @@ templatesCommand.command('show <slug>')
         ? `${JSON.stringify(template)}\n`
         : `${renderFunnelTemplate(template)}\n`);
 });
+const offerSetsCommand = addExamples(program.command('offer-sets').alias('offers').description('Edit project offer sets'), [
+    'fgrove offer-sets pull --project claimbee',
+    'fgrove offer-sets prices --project claimbee --env live',
+    'fgrove offer-sets publish --project claimbee --dry-run',
+    'fgrove offer-sets publish --project claimbee',
+]);
+const addOfferSetScopeOptions = (command) => command
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--project <id-or-slug-or-name>', 'Project id, slug, or name')
+    .option('--file <path>', 'Offer set JSON file', 'offer-sets.json');
+addOfferSetScopeOptions(offerSetsCommand
+    .command('pull')
+    .description('Download every offer set, including archived ones, to an editable JSON file'))
+    .action(async (options) => {
+    const scope = await resolveExpenseCommandScope(options);
+    const count = await executeOfferSetPull(scope);
+    console.log(`Pulled ${count} offer set${count === 1 ? '' : 's'} to ${scope.filePath}.`);
+});
+addOfferSetScopeOptions(offerSetsCommand
+    .command('publish')
+    .description('Create, update, archive, and reactivate offer sets from an edited JSON file')
+    .option('--dry-run', 'Print the changes without saving them'))
+    .action(async (options) => {
+    const scope = await resolveExpenseCommandScope(options);
+    const changes = await executeOfferSetPublish({ ...scope, dryRun: options.dryRun });
+    if (changes.length === 0) {
+        console.log('No offer set changes to publish.');
+        return;
+    }
+    console.log(options.dryRun ? 'Would publish:' : 'Published:');
+    for (const change of changes)
+        console.log(`  ${change}`);
+});
+offerSetsCommand
+    .command('prices')
+    .description('List provider prices and coupons to map into offer set items (Stripe is read live)')
+    .option('--workspace <id-or-slug-or-name>', 'Workspace id, slug, or name')
+    .option('--project <id-or-slug-or-name>', 'Project id, slug, or name')
+    .option('--payment-profile <id-or-name>', 'Only this payment profile')
+    .option('--env <environment>', 'test or live (default: both)')
+    .option('--json', 'Print machine-readable JSON')
+    .action(async (options) => {
+    if (options.env && options.env !== 'test' && options.env !== 'live')
+        throw new Error('--env must be test or live.');
+    const scope = await resolveExpenseCommandScope({ ...options, file: '.' });
+    const catalogs = await executeOfferSetPrices({
+        ...scope,
+        paymentProfile: options.paymentProfile,
+        environment: options.env,
+    });
+    console.log(options.json ? JSON.stringify({ catalogs }, null, 2) : formatOfferSetPriceCatalogs(catalogs).join('\n'));
+});
 const funnelsCommand = addExamples(program.command('funnels').description('Manage funnels'), [
     'fgrove funnels list',
     'fgrove funnels clone --funnel claimbee --name claimbee-ios',

package/dist/offerSetCommands.d.ts

@@ -0,0 +1,133 @@
+type CallApi = <T>(input: {
+    path: string;
+    type: 'query' | 'mutation';
+    data?: unknown;
+    token?: string | null;
+}) => Promise<T>;
+export type OfferSetApiItem = {
+    id?: string;
+    funnel_plan_key: string;
+    title: string | null;
+    test_provider_plan_id: string | null;
+    live_provider_plan_id: string | null;
+    follow_up_test_provider_plan_id?: string | null;
+    follow_up_live_provider_plan_id?: string | null;
+    follow_up_title?: string | null;
+    follow_up_billing_interval?: string | null;
+    follow_up_billing_interval_count?: number | null;
+    intro_iterations?: number | null;
+    analytics_purchase_value: number | null;
+    is_default: boolean;
+    display_name_override: string | null;
+    featured_tag: string | null;
+    old_price_label: string | null;
+    metadata: Record<string, unknown>;
+};
+export type OfferSetApiRow = {
+    id: string;
+    key: string;
+    display_name: string;
+    description: string | null;
+    is_active: boolean;
+    payment_profile_id: string | null;
+    items: OfferSetApiItem[];
+    metadata: Record<string, unknown>;
+    updated_at: string;
+};
+type PaymentProfileApiRow = {
+    id: string;
+    name: string;
+    provider: string;
+};
+export type OfferSetFileItem = {
+    id?: string;
+    funnelPlanKey: string;
+    title: string | null;
+    testProviderPlanId: string | null;
+    liveProviderPlanId: string | null;
+    followUpTestProviderPlanId: string | null;
+    followUpLiveProviderPlanId: string | null;
+    followUpTitle: string | null;
+    followUpBillingInterval: string | null;
+    followUpBillingIntervalCount: number | null;
+    introIterations: number | null;
+    analyticsPurchaseValue: number | null;
+    isDefault: boolean;
+    displayNameOverride: string | null;
+    featuredTag: string | null;
+    oldPriceLabel: string | null;
+    metadata: Record<string, unknown>;
+};
+export type OfferSetFileEntry = {
+    id?: string;
+    updatedAt?: string;
+    key?: string;
+    paymentProfileId: string;
+    displayName: string;
+    description: string | null;
+    isActive: boolean;
+    metadata: Record<string, unknown>;
+    items: OfferSetFileItem[];
+};
+export type OfferSetFile = {
+    schemaVersion: 1;
+    projectId: string;
+    paymentProfiles?: PaymentProfileApiRow[];
+    offerSets: OfferSetFileEntry[];
+};
+type OfferSetCommandScope = {
+    callApi: CallApi;
+    token: string;
+    workspaceId: string;
+    projectId: string;
+};
+export declare const parseOfferSetFile: (contents: string, expectedProjectId: string) => OfferSetFile;
+export declare const executeOfferSetPull: (input: OfferSetCommandScope & {
+    filePath: string;
+}) => Promise<number>;
+export type OfferSetPublishPlan = {
+    replace: Map<string, number[]>;
+    archive: number[];
+    reactivate: number[];
+};
+export declare const planOfferSetPublish: (file: OfferSetFile, remote: OfferSetApiRow[]) => OfferSetPublishPlan;
+export declare const describeOfferSetPublishPlan: (file: OfferSetFile, plan: OfferSetPublishPlan) => string[];
+export declare const executeOfferSetPublish: (input: OfferSetCommandScope & {
+    filePath: string;
+    dryRun?: boolean;
+}) => Promise<string[]>;
+export type OfferSetPrice = {
+    providerPlanId: string;
+    displayName: string | null;
+    amountMinor: number | null;
+    currency: string | null;
+    interval: string | null;
+    intervalCount: number | null;
+    trialPeriodDays: number | null;
+    active: boolean;
+};
+export type OfferSetCoupon = {
+    providerCouponId: string;
+    displayName: string | null;
+    percentOff: number | null;
+    amountOffMinor: number | null;
+    currency: string | null;
+    duration: string | null;
+    active: boolean;
+};
+export type OfferSetPriceCatalog = {
+    paymentProfileId: string;
+    paymentProfileName: string;
+    provider: string;
+    environment: 'test' | 'live';
+    source: 'live' | 'synced' | 'unavailable';
+    reason: string | null;
+    prices: OfferSetPrice[];
+    coupons: OfferSetCoupon[];
+};
+export declare const executeOfferSetPrices: (input: OfferSetCommandScope & {
+    paymentProfile?: string;
+    environment?: "test" | "live";
+}) => Promise<OfferSetPriceCatalog[]>;
+export declare const formatOfferSetPriceCatalogs: (catalogs: OfferSetPriceCatalog[]) => string[];
+export {};

package/dist/offerSetCommands.js

@@ -0,0 +1,405 @@
+import { readFile, writeFile } from 'node:fs/promises';
+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 asObject = (value, label) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object.`);
+    }
+    return value;
+};
+const requiredString = (value, label) => {
+    if (typeof value !== 'string' || !value.trim())
+        throw new Error(`${label} must be a non-empty string.`);
+    return value.trim();
+};
+const nullableString = (value, label) => {
+    if (value === null || value === undefined || value === '')
+        return null;
+    if (typeof value !== 'string')
+        throw new Error(`${label} must be a string or null.`);
+    return value.trim() || null;
+};
+const nullableNumber = (value, label, integer) => {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < (integer ? 1 : 0) || (integer && !Number.isInteger(value))) {
+        throw new Error(`${label} must be ${integer ? 'a positive integer' : 'a non-negative number'} or null.`);
+    }
+    return value;
+};
+const optionalUuid = (value, label) => {
+    if (value === undefined)
+        return undefined;
+    const id = requiredString(value, label);
+    if (!UUID_PATTERN.test(id))
+        throw new Error(`${label} must be a UUID.`);
+    return id;
+};
+const optionalMetadata = (value, label) => (value === undefined ? {} : asObject(value, label));
+const itemToFile = (item) => ({
+    ...(item.id ? { id: item.id } : {}),
+    funnelPlanKey: item.funnel_plan_key,
+    title: item.title ?? null,
+    testProviderPlanId: item.test_provider_plan_id ?? null,
+    liveProviderPlanId: item.live_provider_plan_id ?? null,
+    followUpTestProviderPlanId: item.follow_up_test_provider_plan_id ?? null,
+    followUpLiveProviderPlanId: item.follow_up_live_provider_plan_id ?? null,
+    followUpTitle: item.follow_up_title ?? null,
+    followUpBillingInterval: item.follow_up_billing_interval ?? null,
+    followUpBillingIntervalCount: item.follow_up_billing_interval_count ?? null,
+    introIterations: item.intro_iterations ?? null,
+    analyticsPurchaseValue: item.analytics_purchase_value ?? null,
+    isDefault: item.is_default === true,
+    displayNameOverride: item.display_name_override ?? null,
+    featuredTag: item.featured_tag ?? null,
+    oldPriceLabel: item.old_price_label ?? null,
+    metadata: item.metadata || {},
+});
+const rowToFileEntry = (row) => ({
+    id: row.id,
+    updatedAt: row.updated_at,
+    key: row.key,
+    paymentProfileId: row.payment_profile_id,
+    displayName: row.display_name,
+    description: row.description,
+    isActive: row.is_active,
+    metadata: row.metadata || {},
+    items: row.items.map(itemToFile),
+});
+const parseItem = (value, label) => {
+    const item = asObject(value, label);
+    const id = optionalUuid(item.id, `${label}.id`);
+    return {
+        ...(id ? { id } : {}),
+        funnelPlanKey: requiredString(item.funnelPlanKey, `${label}.funnelPlanKey`),
+        title: nullableString(item.title, `${label}.title`),
+        testProviderPlanId: nullableString(item.testProviderPlanId, `${label}.testProviderPlanId`),
+        liveProviderPlanId: nullableString(item.liveProviderPlanId, `${label}.liveProviderPlanId`),
+        followUpTestProviderPlanId: nullableString(item.followUpTestProviderPlanId, `${label}.followUpTestProviderPlanId`),
+        followUpLiveProviderPlanId: nullableString(item.followUpLiveProviderPlanId, `${label}.followUpLiveProviderPlanId`),
+        followUpTitle: nullableString(item.followUpTitle, `${label}.followUpTitle`),
+        followUpBillingInterval: nullableString(item.followUpBillingInterval, `${label}.followUpBillingInterval`),
+        followUpBillingIntervalCount: nullableNumber(item.followUpBillingIntervalCount, `${label}.followUpBillingIntervalCount`, true),
+        introIterations: nullableNumber(item.introIterations, `${label}.introIterations`, true),
+        analyticsPurchaseValue: nullableNumber(item.analyticsPurchaseValue, `${label}.analyticsPurchaseValue`, false),
+        isDefault: item.isDefault === true,
+        displayNameOverride: nullableString(item.displayNameOverride, `${label}.displayNameOverride`),
+        featuredTag: nullableString(item.featuredTag, `${label}.featuredTag`),
+        oldPriceLabel: nullableString(item.oldPriceLabel, `${label}.oldPriceLabel`),
+        metadata: optionalMetadata(item.metadata, `${label}.metadata`),
+    };
+};
+export const parseOfferSetFile = (contents, expectedProjectId) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch {
+        throw new Error('Offer set file is not valid JSON.');
+    }
+    const root = asObject(parsed, 'Offer set file');
+    if (root.schemaVersion !== 1)
+        throw new Error('Offer set file schemaVersion must be 1.');
+    const projectId = requiredString(root.projectId, 'projectId');
+    if (projectId !== expectedProjectId) {
+        throw new Error(`Offer set file belongs to project ${projectId}, not ${expectedProjectId}.`);
+    }
+    if (!Array.isArray(root.offerSets))
+        throw new Error('offerSets must be an array.');
+    const seenIds = new Set();
+    const offerSets = root.offerSets.map((value, index) => {
+        const label = `offerSets[${index}]`;
+        const entry = asObject(value, label);
+        const id = optionalUuid(entry.id, `${label}.id`);
+        if (id && seenIds.has(id))
+            throw new Error(`Duplicate offer set id ${id}.`);
+        if (id)
+            seenIds.add(id);
+        const updatedAt = entry.updatedAt === undefined ? undefined : requiredString(entry.updatedAt, `${label}.updatedAt`);
+        if (id && !updatedAt)
+            throw new Error(`${label}.updatedAt is required when id is present.`);
+        if (!id && updatedAt)
+            throw new Error(`${label}.updatedAt is only valid when id is present.`);
+        const paymentProfileId = optionalUuid(entry.paymentProfileId, `${label}.paymentProfileId`);
+        if (!paymentProfileId)
+            throw new Error(`${label}.paymentProfileId is required.`);
+        if (!Array.isArray(entry.items) || entry.items.length === 0)
+            throw new Error(`${label}.items must be a non-empty array.`);
+        const key = entry.key === undefined ? undefined : requiredString(entry.key, `${label}.key`);
+        return {
+            ...(id ? { id, updatedAt } : {}),
+            ...(key ? { key } : {}),
+            paymentProfileId,
+            displayName: requiredString(entry.displayName, `${label}.displayName`),
+            description: nullableString(entry.description, `${label}.description`),
+            isActive: entry.isActive !== false,
+            metadata: optionalMetadata(entry.metadata, `${label}.metadata`),
+            items: entry.items.map((item, itemIndex) => parseItem(item, `${label}.items[${itemIndex}]`)),
+        };
+    });
+    return {
+        schemaVersion: 1,
+        projectId,
+        ...(Array.isArray(root.paymentProfiles) ? { paymentProfiles: root.paymentProfiles } : {}),
+        offerSets,
+    };
+};
+const listOfferSets = async (scope) => {
+    const result = await scope.callApi({
+        path: 'projects.listOfferSets',
+        type: 'query',
+        token: scope.token,
+        data: { workspaceId: scope.workspaceId, projectId: scope.projectId, includeArchived: true },
+    });
+    return result.offerSets;
+};
+const listPaymentProfiles = async (scope) => {
+    const result = await scope.callApi({
+        path: 'projects.listPaymentProfiles',
+        type: 'query',
+        token: scope.token,
+        data: { workspaceId: scope.workspaceId, projectId: scope.projectId },
+    });
+    return result.profiles.map(({ id, name, provider }) => ({ id, name, provider }));
+};
+const serializeOfferSetFile = (file) => `${JSON.stringify(file, null, 2)}\n`;
+export const executeOfferSetPull = async (input) => {
+    const [remote, paymentProfiles] = await Promise.all([listOfferSets(input), listPaymentProfiles(input)]);
+    // Legacy sets without a payment profile cannot be saved through replaceOfferSets.
+    const offerSets = remote.filter((row) => row.payment_profile_id);
+    await writeFile(input.filePath, serializeOfferSetFile({
+        schemaVersion: 1,
+        projectId: input.projectId,
+        paymentProfiles,
+        offerSets: offerSets.map(rowToFileEntry),
+    }), 'utf8');
+    return offerSets.length;
+};
+// Key order in hand-edited JSON must not count as a change.
+const canonical = (value) => JSON.stringify(value, (_key, nested) => (nested && typeof nested === 'object' && !Array.isArray(nested)
+    ? Object.fromEntries(Object.entries(nested).sort(([a], [b]) => a.localeCompare(b)))
+    : nested));
+const editableContent = (entry) => ({
+    displayName: entry.displayName,
+    description: entry.description,
+    metadata: entry.metadata,
+    items: entry.items,
+});
+// Mirrors the server's key normalization so a new set's key is known before it is saved.
+const toOfferSetKey = (value) => (value.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').replace(/-{2,}/g, '-') || 'offer-set');
+const toReplaceInput = (entry, isActive) => ({
+    ...(entry.id ? { id: entry.id } : {}),
+    ...(entry.key ? { key: entry.key } : {}),
+    displayName: entry.displayName,
+    description: entry.description,
+    isActive,
+    metadata: entry.metadata,
+    // Provider and position are derived server-side from the payment profile and item order.
+    // A new set is often a copy of an existing one, so its item ids are dropped.
+    items: entry.id ? entry.items : entry.items.map(({ id: _id, ...item }) => item),
+});
+export const planOfferSetPublish = (file, remote) => {
+    const remoteById = new Map(remote.map((row) => [row.id, row]));
+    const takenKeys = new Set(remote.map((row) => row.key));
+    const plan = { replace: new Map(), archive: [], reactivate: [] };
+    for (const [index, entry] of file.offerSets.entries()) {
+        const current = entry.id ? remoteById.get(entry.id) : undefined;
+        if (entry.id && !current)
+            throw new Error(`Offer set ${entry.id} no longer exists. Pull offer sets again before publishing.`);
+        if (current) {
+            if (current.updated_at !== entry.updatedAt) {
+                throw new Error(`Offer set "${current.display_name}" changed remotely. Pull offer sets again before publishing.`);
+            }
+            if (current.payment_profile_id !== entry.paymentProfileId) {
+                throw new Error(`Offer set "${current.display_name}" cannot move to another payment profile; create a new offer set instead.`);
+            }
+            if (entry.key && entry.key !== current.key) {
+                throw new Error(`Offer set "${current.display_name}" key cannot be changed.`);
+            }
+            if (current.is_active !== entry.isActive) {
+                (entry.isActive ? plan.reactivate : plan.archive).push(index);
+            }
+            if (canonical(editableContent(entry)) === canonical(editableContent(rowToFileEntry(current))))
+                continue;
+        }
+        else {
+            // The server treats a known key as an update of that set, so a new entry must not reuse one.
+            entry.key = toOfferSetKey(entry.key || entry.displayName);
+            if (takenKeys.has(entry.key)) {
+                throw new Error(`Offer set key "${entry.key}" already exists. Set a unique "key" for new offer set "${entry.displayName}".`);
+            }
+            takenKeys.add(entry.key);
+        }
+        const group = plan.replace.get(entry.paymentProfileId) || [];
+        group.push(index);
+        plan.replace.set(entry.paymentProfileId, group);
+    }
+    return plan;
+};
+export const describeOfferSetPublishPlan = (file, plan) => {
+    const name = (index) => file.offerSets[index].displayName;
+    return [
+        ...plan.reactivate.map((index) => `reactivate ${name(index)}`),
+        ...[...plan.replace.values()].flat().map((index) => `${file.offerSets[index].id ? 'update' : 'create'} ${name(index)}`),
+        ...plan.archive.map((index) => `archive ${name(index)}`),
+    ];
+};
+export const executeOfferSetPublish = async (input) => {
+    const file = parseOfferSetFile(await readFile(input.filePath, 'utf8'), input.projectId);
+    const plan = planOfferSetPublish(file, await listOfferSets(input));
+    const changes = describeOfferSetPublishPlan(file, plan);
+    if (input.dryRun || changes.length === 0)
+        return changes;
+    // After each write, record the saved id and updatedAt so a later failure leaves a file that
+    // can be published again without losing the remaining edits.
+    const markSaved = async (indexes) => {
+        const latest = await listOfferSets(input);
+        for (const index of indexes) {
+            const entry = file.offerSets[index];
+            const row = latest.find((candidate) => (entry.id ? candidate.id === entry.id : candidate.key === entry.key));
+            if (row)
+                file.offerSets[index] = { ...entry, id: row.id, key: row.key, updatedAt: row.updated_at };
+        }
+        await writeFile(input.filePath, serializeOfferSetFile(file), 'utf8');
+        return latest;
+    };
+    const setLifecycle = async (path, index) => {
+        await input.callApi({
+            path,
+            type: 'mutation',
+            token: input.token,
+            data: { workspaceId: input.workspaceId, projectId: input.projectId, offerSetId: file.offerSets[index].id },
+        });
+        return markSaved([index]);
+    };
+    // Reactivate before editing and archive after editing; archiveOfferSet keeps the in-use guard.
+    for (const index of plan.reactivate)
+        await setLifecycle('projects.reactivateOfferSet', index);
+    for (const [paymentProfileId, indexes] of plan.replace) {
+        await input.callApi({
+            path: 'projects.replaceOfferSets',
+            type: 'mutation',
+            token: input.token,
+            data: {
+                workspaceId: input.workspaceId,
+                projectId: input.projectId,
+                paymentProfileId,
+                offerSets: indexes.map((index) => toReplaceInput(file.offerSets[index], file.offerSets[index].isActive || plan.archive.includes(index))),
+            },
+        });
+        await markSaved(indexes);
+    }
+    let latest = null;
+    for (const index of plan.archive)
+        latest = await setLifecycle('projects.archiveOfferSet', index);
+    // Everything succeeded: store the server-normalized content.
+    const byId = new Map((latest || await listOfferSets(input)).map((row) => [row.id, row]));
+    file.offerSets = file.offerSets.map((entry) => {
+        const row = entry.id ? byId.get(entry.id) : undefined;
+        return row ? rowToFileEntry(row) : entry;
+    });
+    await writeFile(input.filePath, serializeOfferSetFile(file), 'utf8');
+    return changes;
+};
+const formatMoney = (amountMinor, currency) => {
+    if (amountMinor === null || !currency)
+        return '-';
+    const code = currency.toUpperCase();
+    const digits = new Intl.NumberFormat('en', { style: 'currency', currency: code }).resolvedOptions().maximumFractionDigits ?? 2;
+    return `${(amountMinor / 10 ** digits).toFixed(digits)} ${code}`;
+};
+const formatInterval = (price) => {
+    if (!price.interval)
+        return 'one-time';
+    const count = price.intervalCount || 1;
+    const interval = count === 1 ? `/${price.interval}` : `/${count} ${price.interval}s`;
+    return price.trialPeriodDays ? `${interval}, ${price.trialPeriodDays}d trial` : interval;
+};
+const formatCoupon = (coupon) => (coupon.percentOff !== null ? `${coupon.percentOff}% off` : `${formatMoney(coupon.amountOffMinor, coupon.currency)} off`);
+// Stripe prices come live from Stripe, exactly as the dashboard price picker shows them;
+// other providers only expose the last synced catalog.
+const loadPriceCatalogs = async (input, profile, environments) => {
+    const base = { paymentProfileId: profile.id, paymentProfileName: profile.name, provider: profile.provider };
+    const scopeData = { workspaceId: input.workspaceId, projectId: input.projectId, paymentProfileId: profile.id };
+    if (profile.provider === 'stripe') {
+        const { results } = await input.callApi({
+            path: 'projects.listStripeCatalog',
+            type: 'query',
+            token: input.token,
+            data: { ...scopeData, modes: environments },
+        });
+        return results.map((group) => ({
+            ...base,
+            environment: group.environment,
+            source: group.status === 'ready' ? 'live' : 'unavailable',
+            reason: group.reason,
+            prices: group.plans.map((plan) => ({
+                providerPlanId: plan.providerPlanId,
+                displayName: plan.displayName || null,
+                amountMinor: plan.amountMinor,
+                currency: plan.currency?.toUpperCase() || null,
+                interval: plan.interval,
+                intervalCount: plan.interval ? plan.intervalCount || 1 : null,
+                trialPeriodDays: plan.trialPeriodDays,
+                active: plan.isActive && plan.isProductActive,
+            })),
+            coupons: group.discounts.map((discount) => ({
+                providerCouponId: discount.providerCouponId,
+                displayName: discount.displayName || null,
+                percentOff: discount.percentOff,
+                amountOffMinor: discount.amountOffMinor,
+                currency: discount.currency?.toUpperCase() || null,
+                duration: discount.duration,
+                active: discount.isActive,
+            })),
+        }));
+    }
+    return Promise.all(environments.map(async (environment) => {
+        const catalog = await input.callApi({
+            path: 'projects.getLatestPaymentProviderCatalog',
+            type: 'query',
+            token: input.token,
+            data: { ...scopeData, environment },
+        });
+        return {
+            ...base,
+            environment,
+            source: catalog ? 'synced' : 'unavailable',
+            reason: catalog ? null : 'Catalog not synced yet; open the payment profile in the dashboard to sync it.',
+            prices: (catalog?.resources || []).filter((resource) => resource.resource_type === 'price').map((resource) => ({
+                providerPlanId: resource.provider_resource_id,
+                displayName: resource.display_name,
+                amountMinor: resource.amount_minor,
+                currency: resource.currency?.toUpperCase() || null,
+                interval: resource.product_type === 'one_time' ? null : resource.billing_interval,
+                intervalCount: resource.product_type === 'one_time' || !resource.billing_interval ? null : resource.billing_interval_count || 1,
+                trialPeriodDays: resource.trial_period_days,
+                active: resource.status === 'active',
+            })),
+            coupons: [],
+        };
+    }));
+};
+export const executeOfferSetPrices = async (input) => {
+    const profiles = (await listPaymentProfiles(input)).filter((profile) => (!input.paymentProfile || profile.id === input.paymentProfile || profile.name === input.paymentProfile));
+    if (input.paymentProfile && profiles.length === 0)
+        throw new Error(`Payment profile "${input.paymentProfile}" was not found.`);
+    const environments = input.environment ? [input.environment] : ['test', 'live'];
+    const catalogs = await Promise.all(profiles.map((profile) => loadPriceCatalogs(input, profile, environments)));
+    return catalogs.flat();
+};
+export const formatOfferSetPriceCatalogs = (catalogs) => catalogs.flatMap((catalog) => {
+    const lines = [`${catalog.paymentProfileName} (${catalog.provider}, ${catalog.paymentProfileId}) ${catalog.environment}`];
+    if (catalog.source === 'unavailable')
+        return [...lines, `  unavailable: ${catalog.reason || 'unknown reason'}`];
+    if (catalog.prices.length === 0)
+        lines.push('  no prices');
+    for (const price of catalog.prices) {
+        const label = [price.displayName, price.active ? null : '[inactive]'].filter(Boolean).join(' ');
+        lines.push(`  ${price.providerPlanId}  ${formatMoney(price.amountMinor, price.currency)} ${formatInterval(price)}  ${label}`.trimEnd());
+    }
+    for (const coupon of catalog.coupons) {
+        const label = [coupon.displayName, coupon.active ? null : '[inactive]'].filter(Boolean).join(' ');
+        lines.push(`  coupon ${coupon.providerCouponId}  ${formatCoupon(coupon)}${coupon.duration ? `, ${coupon.duration}` : ''}  ${label}`.trimEnd());
+    }
+    return lines;
+});

package/funnel-contract-compatibility.json

@@ -4,10 +4,10 @@
   "minimumCliVersion": "0.1.20",
   "entries": [
     {
-      "repositoryCliVersion": "0.1.295",
+      "repositoryCliVersion": "0.1.297",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.288",
+        "bundleVersion": "2.0.290",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -45,7 +45,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "93b18e9d64291582895c0236b6dfb95c8b261f7fce375ed4163598891d2504e5"
+            "sha256": "7bc1a8807979f1804f27ec95c049ea18c8637438c5e4c7f8cfb502a856f1d7fe"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -145,16 +145,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "af0ab4eb198669c6a97291986a6f17b80ea93294f8e15633cfe58e71f6b172ed"
+            "sha256": "75d2fc9faa26a9f5eb31048efd086908d75c0dfcad3a9cd91d79a738dff74127"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.294",
+      "repositoryCliVersion": "0.1.296",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.287",
+        "bundleVersion": "2.0.289",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -192,7 +192,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "1f7f3d76856b2096ebde3bb0dd83dfabd131823476c8be151849e3bf57c91c28"
+            "sha256": "f822b4943245eed41a35a42ec4e88712213d4f456d6bfeba73138168b292acb8"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -292,16 +292,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "8470d2655720e6c3bb6e210b98d61fb7222deeef9607db6d03cca40e3b06fec7"
+            "sha256": "3e3cdfabee902dfdb2fe31dc439d71c9b3a2137ea4222fcc1a7169b431ab8680"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.293",
+      "repositoryCliVersion": "0.1.295",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.286",
+        "bundleVersion": "2.0.288",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -339,7 +339,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "f1831876670eae6a6029f8f48d12038de408d4fb31a3332f7cec5cb3c7e4ff1d"
+            "sha256": "93b18e9d64291582895c0236b6dfb95c8b261f7fce375ed4163598891d2504e5"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -439,16 +439,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "53e951dfdadfc634fa7bbd53615a5e2e3019cd1bce24b3a4d667e50557268dd7"
+            "sha256": "af0ab4eb198669c6a97291986a6f17b80ea93294f8e15633cfe58e71f6b172ed"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.292",
+      "repositoryCliVersion": "0.1.294",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.285",
+        "bundleVersion": "2.0.287",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -486,7 +486,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "9f91fab6b6af7456e614811d75fc4007e35b0c26086135ddd6dbf5d0491253e7"
+            "sha256": "1f7f3d76856b2096ebde3bb0dd83dfabd131823476c8be151849e3bf57c91c28"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -586,16 +586,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "2c4bd0e6e5677772fcb6889d63833d9fcdd9d66da167571219aa5145567b335f"
+            "sha256": "8470d2655720e6c3bb6e210b98d61fb7222deeef9607db6d03cca40e3b06fec7"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.291",
+      "repositoryCliVersion": "0.1.293",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.284",
+        "bundleVersion": "2.0.286",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -633,7 +633,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "32c4dc6493b9195c1d0c601e593975bfbd029eb348e986c87f9823b7d390e406"
+            "sha256": "f1831876670eae6a6029f8f48d12038de408d4fb31a3332f7cec5cb3c7e4ff1d"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -733,16 +733,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "bac474b7e4180ebc96f0b0ed2f1391b291d7065e3c626f90a7dac4aed4c567d8"
+            "sha256": "53e951dfdadfc634fa7bbd53615a5e2e3019cd1bce24b3a4d667e50557268dd7"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.290",
+      "repositoryCliVersion": "0.1.292",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.283",
+        "bundleVersion": "2.0.285",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -780,7 +780,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "ca5a4836a51320df2216d317108e39384aa732dd92bd8f9085b41d88e4cfcc9d"
+            "sha256": "9f91fab6b6af7456e614811d75fc4007e35b0c26086135ddd6dbf5d0491253e7"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -880,16 +880,16 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "f999b566c6188943f384dc6fac60fcbb26ffc071d316c78bd264ef0f04319e5b"
+            "sha256": "2c4bd0e6e5677772fcb6889d63833d9fcdd9d66da167571219aa5145567b335f"
           }
         ]
       }
     },
     {
-      "repositoryCliVersion": "0.1.289",
+      "repositoryCliVersion": "0.1.291",
       "manifest": {
         "schemaVersion": 1,
-        "bundleVersion": "2.0.282",
+        "bundleVersion": "2.0.284",
         "stepContractVersion": 3,
         "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
         "managedFiles": [
@@ -927,7 +927,7 @@
           },
           {
             "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-            "sha256": "474e05021e90bef7f781a96542c45c409e04b97d13fb8027d3d4b760d90ae336"
+            "sha256": "32c4dc6493b9195c1d0c601e593975bfbd029eb348e986c87f9823b7d390e406"
           },
           {
             "path": "docs/funnelsgrove/qa/analytics.md",
@@ -1027,7 +1027,7 @@
           },
           {
             "path": "funnel-docs.config.json",
-            "sha256": "7b8e363b1ad3d48aebcfa1d4c2606a61d8e18a809b42ff19ceffcb800bc6e3fd"
+            "sha256": "bac474b7e4180ebc96f0b0ed2f1391b291d7065e3c626f90a7dac4aed4c567d8"
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@funnelsgrove/cli",
-  "version": "0.1.295",
+  "version": "0.1.297",
   "description": "FunnelsGrove command-line tools for editing, syncing, and publishing funnels",
   "repository": {
     "type": "git",

package/template_docs/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.288",
+  "bundleVersion": "2.0.290",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "93b18e9d64291582895c0236b6dfb95c8b261f7fce375ed4163598891d2504e5"
+      "sha256": "7bc1a8807979f1804f27ec95c049ea18c8637438c5e4c7f8cfb502a856f1d7fe"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "af0ab4eb198669c6a97291986a6f17b80ea93294f8e15633cfe58e71f6b172ed"
+      "sha256": "75d2fc9faa26a9f5eb31048efd086908d75c0dfcad3a9cd91d79a738dff74127"
     }
   ]
 }

package/template_docs/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.34.0`, then `@funnelsgrove/analytics` `0.16.0`, then `@funnelsgrove/payments` `0.43.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.295`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.34.0`, then `@funnelsgrove/analytics` `0.16.0`, then `@funnelsgrove/payments` `0.44.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.297`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_docs/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.288",
+  "bundleVersion": "2.0.290",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",

package/template_scaffold/.funnelsgrove-docs.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.288",
+  "bundleVersion": "2.0.290",
   "stepContractVersion": 3,
   "contractHash": "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf",
   "managedFiles": [
@@ -38,7 +38,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "93b18e9d64291582895c0236b6dfb95c8b261f7fce375ed4163598891d2504e5"
+      "sha256": "7bc1a8807979f1804f27ec95c049ea18c8637438c5e4c7f8cfb502a856f1d7fe"
     },
     {
       "path": "docs/funnelsgrove/qa/analytics.md",
@@ -138,7 +138,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "af0ab4eb198669c6a97291986a6f17b80ea93294f8e15633cfe58e71f6b172ed"
+      "sha256": "75d2fc9faa26a9f5eb31048efd086908d75c0dfcad3a9cd91d79a738dff74127"
     }
   ]
 }

package/template_scaffold/.funnelsgrove-scaffold.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "sourceTreeHash": "416e96ed59ec0b03db635d42d7e4d0e993d60d34dd34d08a6b2a8643a62a31a3",
+  "sourceTreeHash": "7bcc09edcbb3204ab62980750096b26e3e13269b288b259e04b7cb053849983d",
   "stepContractVersion": 3,
-  "docsBundleVersion": "2.0.288",
+  "docsBundleVersion": "2.0.290",
   "files": [
     {
       "path": ".env.example",
@@ -16,7 +16,7 @@
     },
     {
       "path": ".funnelsgrove-docs.json",
-      "sha256": "f522d9f6419ca6136e15235d04c07349b772511895a0b9e2a1e71fc4003a0b87",
+      "sha256": "7f1b703dc48736009d4a16af7de6b233284b9ae5e5fb99ed502262f4c921afe4",
       "mode": "100644"
     },
     {
@@ -76,7 +76,7 @@
     },
     {
       "path": "docs/funnelsgrove/migrations/step-contract-v3.md",
-      "sha256": "93b18e9d64291582895c0236b6dfb95c8b261f7fce375ed4163598891d2504e5",
+      "sha256": "7bc1a8807979f1804f27ec95c049ea18c8637438c5e4c7f8cfb502a856f1d7fe",
       "mode": "100644"
     },
     {
@@ -206,7 +206,7 @@
     },
     {
       "path": "funnel-docs.config.json",
-      "sha256": "af0ab4eb198669c6a97291986a6f17b80ea93294f8e15633cfe58e71f6b172ed",
+      "sha256": "75d2fc9faa26a9f5eb31048efd086908d75c0dfcad3a9cd91d79a738dff74127",
       "mode": "100644"
     },
     {

package/template_scaffold/docs/funnelsgrove/migrations/step-contract-v3.md

@@ -17,7 +17,7 @@ Supported read versions: `1`, `2`, `3`. Authoring and publish target version `3`
 
 ### Package release order
 
-Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.34.0`, then `@funnelsgrove/analytics` `0.16.0`, then `@funnelsgrove/payments` `0.43.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.295`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
+Release `@funnelsgrove/sdk` `0.4.0` first, then `@funnelsgrove/runtime` `0.34.0`, then `@funnelsgrove/analytics` `0.16.0`, then `@funnelsgrove/payments` `0.44.0`. The production deploy verifies the zero-traffic API candidate, publishes and verifies `@funnelsgrove/cli` `0.1.297`, and only then promotes the candidate to production traffic. The serving API must never advertise an unpublished preferred CLI. Publishing packages and deploying production remain separately approved operational actions.
 <!-- funnelsgrove:generated:end contract-v3/migration/step-contract-v3 -->
 
 ## Version-last policy

package/template_scaffold/funnel-docs.config.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "bundleVersion": "2.0.288",
+  "bundleVersion": "2.0.290",
   "contractSource": "funnelsgrove-repository://apps/funnel-runtime/contracts/step-contract-v2.json",
   "fullyGenerated": [
     ".funnelsgrove-docs.json",