adapty 0.7.0 → 0.8.0-beta.0

package/dist/commands/flows/config/validate.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+import type { FlowConfigValidationDTO } from '../../../lib/api-schemas.js';
+export default class FlowsConfigValidate 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: {
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'config-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<FlowConfigValidationDTO>;
+    private parseJson;
+    private readConfig;
+    private readStdin;
+}

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

@@ -0,0 +1,77 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { createAuthenticatedClient } from '../../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+export default class FlowsConfigValidate extends Command {
+    static args = {
+        flow_id: Args.string({ description: 'Flow ID (UUID)', required: true }),
+    };
+    static description = 'Check whether a builder config is publishable (advisory; does not save). Exits non-zero when the config is not publishable.';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file config.json',
+        'cat config.json | <%= config.bin %> flows config validate --app UUID FLOW_UUID --config-file -',
+        '<%= config.bin %> flows config validate --app UUID FLOW_UUID --config \'{"screens":[],"locales":[]}\'',
+    ];
+    static flags = {
+        ...appFlag,
+        config: Flags.string({
+            description: 'Builder config as a JSON string',
+            exactlyOne: ['config', 'config-file'],
+        }),
+        'config-file': Flags.string({
+            description: 'JSON file with the builder config, or - to read stdin',
+            exactlyOne: ['config', 'config-file'],
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsConfigValidate);
+        if (!isValidUuid(args.flow_id)) {
+            this.error('Invalid flow ID format.', { exit: 2 });
+        }
+        const config = await this.readConfig(flags);
+        const body = { config };
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.post(`/apps/${flags.app}/flows/${args.flow_id}/config/validate`, body);
+        this.log(result.valid ? 'Config is publishable.' : 'Config is NOT publishable.');
+        printResponse(result, this.log.bind(this));
+        // Advisory endpoint always returns HTTP 200; surface the verdict as an exit code so scripts and agents
+        // can gate on it. The JSON/`valid` field stays the source of truth for programmatic consumers.
+        if (!result.valid) {
+            process.exitCode = 1;
+        }
+        return result;
+    }
+    parseJson(raw, label) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            this.error(`Invalid ${label} JSON: ${error instanceof Error ? error.message : String(error)}`, { exit: 2 });
+        }
+    }
+    async readConfig(flags) {
+        if (flags.config !== undefined) {
+            return this.parseJson(flags.config, '--config');
+        }
+        const path = flags['config-file'];
+        if (path === undefined) {
+            this.error('Provide --config or --config-file.', { exit: 2 });
+        }
+        let raw;
+        try {
+            raw = path === '-' ? await this.readStdin() : await readFile(path, 'utf8');
+        }
+        catch {
+            this.error(`Could not read ${path}.`, { exit: 2 });
+        }
+        return this.parseJson(raw, path);
+    }
+    async readStdin() {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        return Buffer.concat(chunks).toString('utf8');
+    }
+}

package/dist/commands/flows/media/upload.d.ts

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

package/dist/commands/flows/media/upload.js

@@ -0,0 +1,46 @@
+import { Args, Command } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { createAuthenticatedClient } from '../../../lib/client-from-config.js';
+import { appFlag } from '../../../lib/flags.js';
+import { printResponse } from '../../../lib/output.js';
+const IMAGE_MIME_TYPES = {
+    '.gif': 'image/gif',
+    '.heic': 'image/heic',
+    '.jpeg': 'image/jpeg',
+    '.jpg': 'image/jpeg',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+};
+export default class FlowsMediaUpload extends Command {
+    static args = {
+        file: Args.string({ description: 'Path to the image file to upload', required: true }),
+    };
+    static description = 'Upload an image as a flow builder asset; prints the CDN URL to reference from a flow config';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> flows media upload --app UUID ./onboarding-hero.png'];
+    static flags = {
+        ...appFlag,
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsMediaUpload);
+        let content;
+        try {
+            content = await readFile(args.file);
+        }
+        catch {
+            this.error(`Cannot read file: ${args.file}`, { exit: 2 });
+        }
+        const name = basename(args.file);
+        const type = IMAGE_MIME_TYPES[extname(name).toLowerCase()] ?? 'application/octet-stream';
+        const form = new FormData();
+        form.append('file', new Blob([new Uint8Array(content)], { type }), name);
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.postForm(`/apps/${flags.app}/flows/media/images`, form);
+        this.log('Image uploaded!');
+        // `preview_base64` is a long data blob with no value in human output; --json still returns it in full.
+        printResponse({ id: result.id, name: result.name, url: result.url }, this.log.bind(this));
+        return result;
+    }
+}

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

@@ -101,6 +101,29 @@ export interface FlowConfigWriteRequestDTO {
     expected_updated_at?: null | number;
     remote_configs?: FlowRemoteConfigDTO[];
 }
+export interface FlowConfigValidateRequestDTO {
+    config: Record<string, unknown>;
+}
+export interface FlowConfigIssueDTO {
+    /** Machine code, relayed from the transformer; absent until it reports path-level diagnostics. */
+    code?: null | string;
+    message: string;
+    /** Location of the issue; absent until the transformer reports path-level diagnostics. */
+    path?: null | string;
+    severity: string;
+}
+export interface FlowConfigValidationDTO {
+    issues: FlowConfigIssueDTO[];
+    valid: boolean;
+}
+export interface MediaDTO {
+    id: number;
+    name: string;
+    /** Base64-encoded preview thumbnail; absent when no preview was generated. */
+    preview_base64?: null | string;
+    /** CDN URL to reference from a flow config. */
+    url: string;
+}
 export interface SegmentDTO {
     description: null | string;
     id: string;