adapty 0.8.3-beta.1 → 0.8.4-beta.1

package/dist/commands/flows/config/get.js

@@ -6,7 +6,8 @@ export default class FlowsConfigGet extends Command {
     static args = {
         flow_id: Args.string({ description: 'Flow ID (UUID)', required: true }),
     };
-    static description = 'Read the flow builder config (404 until the config has been written at least once)';
+    static description = 'Read the flow builder config (404 until the config has been written at least once). ' +
+        'On a failed publish, `publication_status`, `transform_error` and `publication_error` show why.';
     static enableJsonFlag = true;
     static examples = ['<%= config.bin %> flows config get --app UUID 550e8400-e29b-41d4-a716-446655440000'];
     static flags = {

package/dist/commands/flows/publish.js

@@ -3,12 +3,14 @@ import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { confirmFlags, confirmMutation } from '../../lib/confirm.js';
 import { ApiError } from '../../lib/errors.js';
 import { appFlag, isValidUuid } from '../../lib/flags.js';
+import { flowFixLinks } from '../../lib/flow-help.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 description = 'Publish a flow (async — publication completes in the background). ' +
+        'Publishing is async: returns status `publishing`. Poll `adapty flows get <flow_id>` for `published`/`publication_failed`; on failure, `adapty flows config get <flow_id>` shows why.';
     static enableJsonFlag = true;
     static examples = ['<%= config.bin %> flows publish --app UUID 550e8400-e29b-41d4-a716-446655440000'];
     static flags = {
@@ -35,12 +37,15 @@ export default class FlowsPublish extends Command {
             if (error instanceof ApiError && (error.statusCode === 400 || error.errorCode === 'validation_error')) {
                 this.error(`Flow publish failed: ${error.message}\n` +
                     'Publishing needs a flow with a valid config. Fix it, then run `adapty flows publish` again:\n' +
-                    `  • Builder UI: https://app.adapty.io/flows/${args.flow_id}/builder\n` +
-                    '  • Adapty flows agent skill: https://adapty.io/docs/flow-generator-skill', { exit: 1 });
+                    flowFixLinks(args.flow_id), { exit: 1 });
             }
             throw error;
         }
-        this.log('Publishing started — status: publishing. Publication completes asynchronously.');
+        if (!this.jsonEnabled()) {
+            this.log('Publishing started — status: publishing. This is asynchronous; the flow is NOT published yet.');
+            this.log(`Check progress:  adapty flows get --app ${flags.app} ${args.flow_id}   (wait for status 'published' or 'publication_failed')`);
+            this.log(`If it fails:     adapty flows config get --app ${flags.app} ${args.flow_id}   (shows why)`);
+        }
         printResponse(result, this.log.bind(this));
         return result;
     }

package/dist/commands/placements/create.js

@@ -1,6 +1,7 @@
 import { Command, Flags } from '@oclif/core';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { appFlag } from '../../lib/flags.js';
+import { draftFlowError } from '../../lib/flow-help.js';
 import { printResponse } from '../../lib/output.js';
 import { audienceEntryProblem } from '../../lib/placement-audiences.js';
 export default class PlacementsCreate extends Command {
@@ -59,7 +60,16 @@ export default class PlacementsCreate extends Command {
             body.audiences = parsed;
         }
         const client = await createAuthenticatedClient(this.config);
-        const result = await client.post(`/apps/${flags.app}/placements`, body);
+        let result;
+        try {
+            result = await client.post(`/apps/${flags.app}/placements`, body);
+        }
+        catch (error) {
+            const message = draftFlowError(error, flags.app, body.audiences);
+            if (message)
+                this.error(message, { exit: 2 });
+            throw error;
+        }
         this.log('Placement created!');
         printResponse(result, this.log.bind(this));
         return result;

package/dist/commands/placements/update.js

@@ -1,6 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { appFlag, isValidUuid } from '../../lib/flags.js';
+import { draftFlowError } from '../../lib/flow-help.js';
 import { printResponse } from '../../lib/output.js';
 import { audienceEntryProblem } from '../../lib/placement-audiences.js';
 export default class PlacementsUpdate extends Command {
@@ -68,7 +69,16 @@ export default class PlacementsUpdate extends Command {
             body.audiences = parsed;
         }
         const client = await createAuthenticatedClient(this.config);
-        const result = await client.put(`/apps/${flags.app}/placements/${args.placement_id}`, body);
+        let result;
+        try {
+            result = await client.put(`/apps/${flags.app}/placements/${args.placement_id}`, body);
+        }
+        catch (error) {
+            const message = draftFlowError(error, flags.app, body.audiences);
+            if (message)
+                this.error(message, { exit: 2 });
+            throw error;
+        }
         this.log('Placement updated!');
         printResponse(result, this.log.bind(this));
         return result;

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

@@ -87,8 +87,14 @@ export interface FlowRemoteConfigDTO {
 }
 export interface FlowConfigDTO {
     config: Record<string, unknown>;
+    /** Human message for a failed publication (raw passthrough from the flow version). */
+    publication_error?: null | string;
+    /** Publication lifecycle of the flow version: transforming|transformed|uploading|uploaded|published|failed. */
+    publication_status?: string;
     remote_configs: FlowRemoteConfigDTO[];
     status: FlowStatus;
+    /** Raw transform failure: a JSON issues payload or a summary string. Parse with `parseFlowPublicationError`. */
+    transform_error?: null | string;
     /** Millisecond timestamp of the last content change; the value `expected_updated_at` is compared against on write. */
     updated_at: number;
 }
@@ -146,12 +152,16 @@ export type PlacementAudienceEntryDTO = PlacementFlowAudienceEntryDTO | Placemen
 export interface PlacementSummaryDTO {
     developer_id: string;
     id: string;
+    /** Placement activation state: true = Live, false = Inactive. */
+    is_active: boolean;
     title: string;
 }
 export interface PlacementDetailDTO {
     audiences?: PlacementAudienceEntryDTO[];
     developer_id: string;
     id: string;
+    /** Placement activation state: true = Live, false = Inactive. */
+    is_active: boolean;
     title: string;
 }
 export interface PlacementWriteRequestDTO {

package/dist/lib/flow-help.d.ts

@@ -0,0 +1,12 @@
+export declare function builderUrl(flowId: string): string;
+/** The two "• …" footer lines pointing at the Builder UI and the flows agent skill. */
+export declare function flowFixLinks(flowId: string): string;
+/**
+ * When `error` is the backend's draft-flow rejection, returns an enriched message with the
+ * publish command and fix links; otherwise returns null so the caller rethrows unchanged.
+ * `flowId` is taken from the single flow audience, or `<FLOW_ID>` when it is ambiguous.
+ */
+export declare function draftFlowError(error: unknown, app: string, audiences: null | {
+    content_type?: string;
+    flow_id?: string;
+}[]): null | string;

package/dist/lib/flow-help.js

@@ -0,0 +1,27 @@
+// Shared "how to fix a flow" links, used by `flows publish` (config-error message)
+// and by `placements create`/`update` (draft-attach error). One source for both URLs.
+import { ApiError } from './errors.js';
+export function builderUrl(flowId) {
+    return `https://app.adapty.io/flows/${flowId}/builder`;
+}
+/** The two "• …" footer lines pointing at the Builder UI and the flows agent skill. */
+export function flowFixLinks(flowId) {
+    return `  • Builder UI: ${builderUrl(flowId)}\n  • Adapty flows agent skill: https://adapty.io/docs/flow-generator-skill`;
+}
+// The backend message when a placement tries to attach an unpublished flow. There is no
+// distinct error_code (it comes back as generic validation_error), so match on the text.
+const DRAFT_FLOW_MARKER = 'Flow must be published before placing in a placement';
+/**
+ * When `error` is the backend's draft-flow rejection, returns an enriched message with the
+ * publish command and fix links; otherwise returns null so the caller rethrows unchanged.
+ * `flowId` is taken from the single flow audience, or `<FLOW_ID>` when it is ambiguous.
+ */
+export function draftFlowError(error, app, audiences) {
+    if (!(error instanceof ApiError) || !error.message.includes(DRAFT_FLOW_MARKER))
+        return null;
+    const flows = (audiences ?? []).filter((a) => a.content_type === 'flow' && typeof a.flow_id === 'string');
+    const flowId = flows.length === 1 ? flows[0].flow_id : '<FLOW_ID>';
+    return ('Cannot attach a draft flow to a placement — publish it first.\n' +
+        `Publish:  adapty flows publish --app ${app} ${flowId}\n` +
+        flowFixLinks(flowId));
+}