adapty 0.8.2 → 0.8.3-beta.0

package/dist/commands/asa/ad-groups/create.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { currencyFlag, idempotencyFlags, money, moneyFlag, pricingModelFlag, scheduleFlags, startOfDayUtc, todayUtc, } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdGroupsCreate extends Command {

package/dist/commands/asa/ad-groups/update.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { currencyFlag, idempotencyFlags, money, moneyFlag, scheduleFlags, startOfDayUtc } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdGroupsUpdate extends Command {

package/dist/commands/asa/ads/create.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdsCreate extends Command {

package/dist/commands/asa/ads/update.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAdsUpdate extends Command {

package/dist/commands/asa/automations/create.js

@@ -1,8 +1,8 @@
 import { Command, Flags } from '@oclif/core';
 import { readFile } from 'node:fs/promises';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAutomationsCreate extends Command {
     static description = 'Create an automation rule from a JSON rule file';

package/dist/commands/asa/automations/run.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaAutomationsRun extends Command {
     static args = {

package/dist/commands/asa/automations/update.js

@@ -1,8 +1,8 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { readFile } from 'node:fs/promises';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaAutomationsUpdate extends Command {

package/dist/commands/asa/campaigns/bulk-create.js

@@ -2,8 +2,8 @@ import { Command, Flags } from '@oclif/core';
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { printResponse } from '../../../lib/output.js';
 const TERMINAL_STATUSES = new Set(['failed', 'partial', 'success']);
 export default class AsaCampaignsBulkCreate extends Command {

package/dist/commands/asa/campaigns/create.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { currencyFlag, idempotencyFlags, invoiceFlags, locInvoiceDetails, money, moneyFlag, reportServingState, } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaCampaignsCreate extends Command {

package/dist/commands/asa/campaigns/update.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { currencyFlag, idempotencyFlags, invoiceFlags, locInvoiceDetails, money, moneyFlag, reportServingState, } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaCampaignsUpdate extends Command {

package/dist/commands/asa/keywords/add.js

@@ -1,8 +1,8 @@
 import { Command, Flags } from '@oclif/core';
 import { readFile } from 'node:fs/promises';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { currencyFlag, idempotencyFlags, MAX_BULK_ITEMS, money, moneyFlag, reportBulkOutcome } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaKeywordsAdd extends Command {
     static description = 'Add targeting keywords to an ad group';

package/dist/commands/asa/keywords/update.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { currencyFlag, idempotencyFlags, money, moneyFlag, reportBulkOutcome } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaKeywordsUpdate extends Command {
     static args = {

package/dist/commands/asa/negative-keywords/add.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient, noteReplay } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags, MAX_BULK_ITEMS, reportBulkOutcome } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { isValidUuid } from '../../../lib/flags.js';
 export default class AsaNegativeKeywordsAdd extends Command {
     static description = 'Add negative keywords to an ad group or across a campaign';

package/dist/commands/asa/product-pages/sync.js

@@ -1,7 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { asaWrite, createAsaClient } from '../../../lib/asa-client.js';
-import { confirmFlags, confirmMutation } from '../../../lib/asa-confirm.js';
 import { idempotencyFlags } from '../../../lib/asa-flags.js';
+import { confirmFlags, confirmMutation } from '../../../lib/confirm.js';
 import { printResponse } from '../../../lib/output.js';
 export default class AsaProductPagesSync extends Command {
     static description = 'Refresh custom product pages from Apple';

package/dist/commands/flows/publish.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import type { FlowDTO } from '../../lib/api-schemas.js';
+export default class FlowsPublish extends Command {
+    static args: {
+        flow_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<FlowDTO>;
+}

package/dist/commands/flows/publish.js

@@ -0,0 +1,34 @@
+import { Args, Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { confirmFlags, confirmMutation } from '../../lib/confirm.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+import { printResponse } from '../../lib/output.js';
+export default class FlowsPublish extends Command {
+    static args = {
+        flow_id: Args.string({ description: 'Flow ID (UUID)', required: true }),
+    };
+    static description = 'Publish a flow (async — publication completes in the background)';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = {
+        ...appFlag,
+        ...confirmFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsPublish);
+        if (!isValidUuid(args.flow_id)) {
+            this.error('Invalid flow ID format.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const flow = await client.get(`/apps/${flags.app}/flows/${args.flow_id}/`);
+        await confirmMutation(this, {
+            method: 'POST',
+            path: `/apps/${flags.app}/flows/${args.flow_id}/publish/`,
+            summary: `Publish flow "${flow.name}" live to end users`,
+        }, flags.yes);
+        const result = await client.post(`/apps/${flags.app}/flows/${args.flow_id}/publish/`);
+        this.log('Publishing started — status: publishing. Publication completes asynchronously.');
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

package/dist/commands/flows/update.d.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import type { FlowDTO } from '../../lib/api-schemas.js';
+export default class FlowsUpdate extends Command {
+    static args: {
+        flow_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<FlowDTO>;
+}

package/dist/commands/flows/update.js

@@ -0,0 +1,28 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+import { printResponse } from '../../lib/output.js';
+export default class FlowsUpdate extends Command {
+    static args = {
+        flow_id: Args.string({ description: 'Flow ID (UUID)', required: true }),
+    };
+    static description = 'Rename a flow';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> flows update --app UUID 550e8400-e29b-41d4-a716-446655440000 --name "Onboarding v2"'];
+    static flags = {
+        ...appFlag,
+        name: Flags.string({ description: 'New flow name', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsUpdate);
+        if (!isValidUuid(args.flow_id)) {
+            this.error('Invalid flow ID format.', { exit: 2 });
+        }
+        const body = { name: flags.name };
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.put(`/apps/${flags.app}/flows/${args.flow_id}/`, body);
+        this.log('Flow updated!');
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

package/dist/commands/placements/create.js

@@ -2,17 +2,22 @@ import { Command, Flags } from '@oclif/core';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { appFlag } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';
+import { audienceEntryProblem } from '../../lib/placement-audiences.js';
 export default class PlacementsCreate extends Command {
     static description = 'Create a placement with a paywall';
     static enableJsonFlag = true;
     static examples = [
-        '<%= config.bin %> placements create --app UUID --title "Default" --developer-id default --audiences \'[{"segment_ids":[],"paywall_id":"PAYWALL_UUID","priority":0}]\'',
+        '<%= config.bin %> placements create --app UUID --title "Default" --developer-id default --audiences \'[{"content_type":"paywall","segment_ids":[],"paywall_id":"PAYWALL_UUID","priority":0}]\'',
+        '<%= config.bin %> placements create --app UUID --title "Default" --developer-id default --audiences \'[{"content_type":"flow","segment_ids":[],"flow_id":"FLOW_UUID","priority":0}]\'',
         '<%= config.bin %> placements create --app UUID --title "Default" --developer-id default --paywall-id PAYWALL_UUID',
     ];
     static flags = {
         ...appFlag,
         audiences: Flags.string({
-            description: 'JSON array of audience entries: [{segment_ids, paywall_id, priority}]',
+            description: 'JSON array of audience entries. Every entry needs an explicit content_type. ' +
+                'Paywall: {content_type:"paywall", segment_ids, paywall_id, priority}. ' +
+                'Flow: {content_type:"flow", segment_ids, flow_id, priority}. ' +
+                'A flow must be published first (flows publish) — attaching a draft flow returns 400.',
             exactlyOne: ['paywall-id', 'audiences'],
         }),
         'developer-id': Flags.string({ description: 'Developer ID for the placement', required: true }),
@@ -36,12 +41,22 @@ export default class PlacementsCreate extends Command {
             body.paywall_id = flags['paywall-id'];
         }
         else {
+            let parsed;
             try {
-                body.audiences = JSON.parse(flags.audiences);
+                parsed = JSON.parse(flags.audiences);
             }
             catch (error) {
                 this.error(`Invalid --audiences JSON: ${error instanceof Error ? error.message : String(error)}`, { exit: 2 });
             }
+            if (!Array.isArray(parsed)) {
+                this.error('--audiences must be a JSON array of audience entries.', { exit: 2 });
+            }
+            for (const [index, entry] of parsed.entries()) {
+                const problem = audienceEntryProblem(entry);
+                if (problem)
+                    this.error(`--audiences[${index}]: ${problem}`, { exit: 2 });
+            }
+            body.audiences = parsed;
         }
         const client = await createAuthenticatedClient(this.config);
         const result = await client.post(`/apps/${flags.app}/placements`, body);

package/dist/commands/placements/update.js

@@ -2,6 +2,7 @@ import { Args, Command, Flags } from '@oclif/core';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { appFlag, isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';
+import { audienceEntryProblem } from '../../lib/placement-audiences.js';
 export default class PlacementsUpdate extends Command {
     static args = {
         placement_id: Args.string({ description: 'Placement ID (UUID)', required: true }),
@@ -9,13 +10,17 @@ export default class PlacementsUpdate extends Command {
     static description = 'Update a placement';
     static enableJsonFlag = true;
     static examples = [
-        '<%= config.bin %> placements update --app UUID 550e8400-... --title "Default" --developer-id default --audiences \'[{"segment_ids":[],"paywall_id":"PAYWALL_UUID","priority":0}]\'',
+        '<%= config.bin %> placements update --app UUID 550e8400-... --title "Default" --developer-id default --audiences \'[{"content_type":"paywall","segment_ids":[],"paywall_id":"PAYWALL_UUID","priority":0}]\'',
+        '<%= config.bin %> placements update --app UUID 550e8400-... --title "Default" --developer-id default --audiences \'[{"content_type":"flow","segment_ids":[],"flow_id":"FLOW_UUID","priority":0}]\'',
         '<%= config.bin %> placements update --app UUID 550e8400-... --title "Default" --developer-id default --paywall-id PAYWALL_UUID',
     ];
     static flags = {
         ...appFlag,
         audiences: Flags.string({
-            description: 'JSON array of audience entries: [{segment_ids, paywall_id, priority}]',
+            description: 'JSON array of audience entries. Every entry needs an explicit content_type. ' +
+                'Paywall: {content_type:"paywall", segment_ids, paywall_id, priority}. ' +
+                'Flow: {content_type:"flow", segment_ids, flow_id, priority}. ' +
+                'A flow must be published first (flows publish) — attaching a draft flow returns 400.',
             exactlyOne: ['paywall-id', 'audiences'],
         }),
         'developer-id': Flags.string({ description: 'Developer ID for the placement', required: true }),
@@ -45,12 +50,22 @@ export default class PlacementsUpdate extends Command {
             body.paywall_id = flags['paywall-id'];
         }
         else {
+            let parsed;
             try {
-                body.audiences = JSON.parse(flags.audiences);
+                parsed = JSON.parse(flags.audiences);
             }
             catch (error) {
                 this.error(`Invalid --audiences JSON: ${error instanceof Error ? error.message : String(error)}`, { exit: 2 });
             }
+            if (!Array.isArray(parsed)) {
+                this.error('--audiences must be a JSON array of audience entries.', { exit: 2 });
+            }
+            for (const [index, entry] of parsed.entries()) {
+                const problem = audienceEntryProblem(entry);
+                if (problem)
+                    this.error(`--audiences[${index}]: ${problem}`, { exit: 2 });
+            }
+            body.audiences = parsed;
         }
         const client = await createAuthenticatedClient(this.config);
         const result = await client.put(`/apps/${flags.app}/placements/${args.placement_id}`, body);

package/dist/lib/api-schemas.d.ts

@@ -129,11 +129,20 @@ export interface SegmentDTO {
     id: string;
     title: string;
 }
-export interface PlacementAudienceEntryDTO {
+export interface PlacementPaywallAudienceEntryDTO {
+    content_type: 'paywall';
     paywall_id: string;
     priority: number;
     segment_ids?: string[];
 }
+export interface PlacementFlowAudienceEntryDTO {
+    content_type: 'flow';
+    /** The flow must be `published` (not draft) — the backend returns 400 otherwise. */
+    flow_id: string;
+    priority: number;
+    segment_ids?: string[];
+}
+export type PlacementAudienceEntryDTO = PlacementFlowAudienceEntryDTO | PlacementPaywallAudienceEntryDTO;
 export interface PlacementSummaryDTO {
     developer_id: string;
     id: string;

package/dist/lib/placement-audiences.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns a human-readable problem string when `entry` is not a valid placement
+ * audience entry, or `null` when it is well-formed. Every entry must carry an
+ * explicit `content_type` ('paywall' | 'flow'); there is no implicit paywall.
+ */
+export declare function audienceEntryProblem(entry: unknown): null | string;

package/dist/lib/placement-audiences.js

@@ -0,0 +1,25 @@
+// Runtime guard for --audiences entries parsed from user/agent-supplied JSON.
+// The DTO union in api-schemas.ts requires content_type, but a JSON.parse gives
+// back `unknown`, so the type alone cannot enforce it — this does, the same way
+// for humans and agents (no prompting).
+/**
+ * Returns a human-readable problem string when `entry` is not a valid placement
+ * audience entry, or `null` when it is well-formed. Every entry must carry an
+ * explicit `content_type` ('paywall' | 'flow'); there is no implicit paywall.
+ */
+export function audienceEntryProblem(entry) {
+    if (typeof entry !== 'object' || entry === null) {
+        return 'each entry must be a JSON object';
+    }
+    const { content_type: contentType, flow_id: flowId, paywall_id: paywallId } = entry;
+    if (contentType !== 'flow' && contentType !== 'paywall') {
+        return 'content_type is required and must be "paywall" or "flow"';
+    }
+    if (contentType === 'paywall' && typeof paywallId !== 'string') {
+        return 'a paywall entry requires paywall_id';
+    }
+    if (contentType === 'flow' && typeof flowId !== 'string') {
+        return 'a flow entry requires flow_id';
+    }
+    return null;
+}