adapty 0.8.9 → 0.9.0

package/dist/cli/input/migration.js

@@ -0,0 +1,17 @@
+import { Args, Flags } from '@oclif/core';
+import { validateMigrationId } from '../context/migration/index.js';
+export const migrationArgs = {
+    id: Args.string({
+        description: 'Migration ID from `adapty migrations list`',
+        required: true,
+        parse: value => Promise.resolve(validateMigrationId(value)),
+    }),
+};
+/** Explicit ID wins over the environment and the saved selection, resolved after parsing. */
+export const migrationFlags = {
+    migration: Flags.string({
+        char: 'm',
+        description: 'Migration ID; overrides ADAPTY_MIGRATION and the saved selection from migrations use/create',
+        helpValue: 'ID',
+    }),
+};

package/dist/cli/input/pagination.d.ts

@@ -0,0 +1,11 @@
+import type { PageParams } from '../../sdk/adapty/index.js';
+/** The published defaults, so a migrated `list` asks for the same page as an untouched one. */
+export declare const paginationFlags: {
+    page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+};
+/** The one place where flag names meet sdk field names. */
+export declare const pageParams: (flags: {
+    "page": number;
+    "page-size": number;
+}) => PageParams;

package/dist/cli/input/pagination.js

@@ -0,0 +1,8 @@
+import { Flags } from '@oclif/core';
+/** The published defaults, so a migrated `list` asks for the same page as an untouched one. */
+export const paginationFlags = {
+    'page': Flags.integer({ default: 1, description: 'Page number', min: 1 }),
+    'page-size': Flags.integer({ default: 20, description: 'Items per page (max 100)', max: 100, min: 1 }),
+};
+/** The one place where flag names meet sdk field names. */
+export const pageParams = (flags) => ({ page: flags.page, pageSize: flags['page-size'] });

package/dist/cli/views/migrations/envelope/action-block.d.ts

@@ -0,0 +1,2 @@
+import type { Action } from '../../../../sdk/adapty/index.js';
+export declare const actionBlock: (action: Action, migrationId: string) => string[];

package/dist/cli/views/migrations/envelope/action-block.js

@@ -0,0 +1,32 @@
+const knownKinds = new Set(['external', 'input', 'upload']);
+const indent = (text, pad) => {
+    return text.split('\n').map(line => `${pad}${line}`).join('\n');
+};
+export const actionBlock = (action, migrationId) => {
+    const lines = [`  ${action.action_id}  (${action.kind})  ${action.title}`];
+    const href = 'href' in action ? action.href : undefined;
+    if (action.detail !== null) {
+        lines.push(indent(action.detail, '    '));
+    }
+    if (href !== undefined) {
+        lines.push(`    ${href}`);
+    }
+    if (action.reads.length > 0) {
+        const commands = action.reads.map(name => `adapty migrations show ${name} -m ${migrationId}`);
+        lines.push(`    Read first: ${commands.join(', ')}`);
+    }
+    if (action.confirm !== null) {
+        lines.push('    Confirmation:', indent(action.confirm, '      '));
+        if (action.kind === 'input') {
+            lines.push('    Review this text before passing --yes.');
+        }
+    }
+    if (action.kind === 'upload') {
+        lines.push('    File uploads are not supported by this CLI.');
+        lines.push('    Use the dashboard or an offered Cloud Export action.');
+    }
+    if (!knownKinds.has(action.kind)) {
+        lines.push('    This action needs a newer adapty-cli');
+    }
+    return lines;
+};

package/dist/cli/views/migrations/envelope/envelope.d.ts

@@ -0,0 +1,3 @@
+import type { Envelope } from '../../../../sdk/adapty/index.js';
+/** Preserve server wording so new steps and actions need no CLI update. */
+export declare const renderEnvelope: (envelope: Envelope) => string;

package/dist/cli/views/migrations/envelope/envelope.js

@@ -0,0 +1,40 @@
+import { actionBlock } from './action-block.js';
+import { issueBlock } from './issue-block.js';
+const knownStates = new Set([
+    'running', 'action_required', 'completed', 'failed', 'canceled',
+]);
+const appLine = (app) => {
+    return app === null ? 'App: not created yet' : `App: ${app.name} (${app.id})`;
+};
+const progressLine = (progress) => {
+    const done = progress.total === null ? String(progress.done) : `${progress.done} of ${progress.total}`;
+    return `Progress: ${done} ${progress.unit}`;
+};
+/** Preserve server wording so new steps and actions need no CLI update. */
+export const renderEnvelope = (envelope) => {
+    const { migration } = envelope;
+    const lines = [
+        `${migration.id}  ${migration.flow}  ${migration.state}`,
+        appLine(migration.app),
+        migration.summary,
+    ];
+    if (!knownStates.has(migration.state)) {
+        lines.push('This migration state needs a newer adapty-cli');
+    }
+    if (migration.progress !== null) {
+        lines.push(progressLine(migration.progress));
+    }
+    if (envelope.issues.length > 0) {
+        lines.push('', 'Issues:', ...envelope.issues.flatMap(issue => issueBlock(issue, migration.id)));
+    }
+    if (envelope.next_actions.length > 0) {
+        lines.push('', 'Do next:', ...envelope.next_actions.flatMap(action => actionBlock(action, migration.id)));
+    }
+    if (envelope.available_actions.length > 0) {
+        lines.push('', 'Also available:', ...envelope.available_actions.flatMap(action => actionBlock(action, migration.id)));
+    }
+    if (envelope.resources.length > 0) {
+        lines.push('', `Readable now: ${envelope.resources.map(resource => resource.name).join(', ')}`);
+    }
+    return lines.join('\n');
+};

package/dist/cli/views/migrations/envelope/issue-block.d.ts

@@ -0,0 +1,2 @@
+import type { Issue } from '../../../../sdk/adapty/index.js';
+export declare const issueBlock: (issue: Issue, migrationId: string) => string[];

package/dist/cli/views/migrations/envelope/issue-block.js

@@ -0,0 +1,13 @@
+const indent = (text, pad) => {
+    return text.split('\n').map(line => `${pad}${line}`).join('\n');
+};
+export const issueBlock = (issue, migrationId) => {
+    const lines = [`  ${issue.title}  (${issue.code})`];
+    if (issue.detail !== null) {
+        lines.push(indent(issue.detail, '    '));
+    }
+    if (issue.action_id !== null) {
+        lines.push(`    Fix with: adapty migrations run ${issue.action_id} -m ${migrationId}`);
+    }
+    return lines;
+};

package/dist/cli/views/migrations/notices.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ADAPTY_MIGRATION outlives both a save and a clear, so "saved" or "cleared" alone would be a lie.
+ * Commands write these to stderr rather than through `warn()`, which oclif silences under --json:
+ * a selection that is not in effect is exactly what a script has to be told about.
+ */
+export declare const envOverridesSelection = "Warning: ADAPTY_MIGRATION still overrides the saved selection. Unset it in your shell to use this ID.\n";
+export declare const envSuppliesMigration = "Warning: ADAPTY_MIGRATION still supplies a migration ID. Unset it in your shell.\n";

package/dist/cli/views/migrations/notices.js

@@ -0,0 +1,7 @@
+/**
+ * ADAPTY_MIGRATION outlives both a save and a clear, so "saved" or "cleared" alone would be a lie.
+ * Commands write these to stderr rather than through `warn()`, which oclif silences under --json:
+ * a selection that is not in effect is exactly what a script has to be told about.
+ */
+export const envOverridesSelection = 'Warning: ADAPTY_MIGRATION still overrides the saved selection. Unset it in your shell to use this ID.\n';
+export const envSuppliesMigration = 'Warning: ADAPTY_MIGRATION still supplies a migration ID. Unset it in your shell.\n';

package/dist/commands/access-levels/create.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { printResponse } from '../../lib/output.js';
 export default class AccessLevelsCreate extends Command {

package/dist/commands/access-levels/get.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/access-levels/list.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { paginationFlags, paginationParams } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

package/dist/commands/access-levels/update.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/auth/logout.d.ts

@@ -1 +1 @@
-export { default } from '../../cli/commands/auth/logout.js';
+export { default } from '../../cli/commands/auth/logout/index.js';

package/dist/commands/auth/logout.js

@@ -1,2 +1,2 @@
 // Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
-export { default } from '../../cli/commands/auth/logout.js';
+export { default } from '../../cli/commands/auth/logout/index.js';

package/dist/commands/auth/revoke.d.ts

@@ -1 +1 @@
-export { default } from '../../cli/commands/auth/revoke.js';
+export { default } from '../../cli/commands/auth/revoke/index.js';

package/dist/commands/auth/revoke.js

@@ -1,2 +1,2 @@
 // Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
-export { default } from '../../cli/commands/auth/revoke.js';
+export { default } from '../../cli/commands/auth/revoke/index.js';

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

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../../cli/flags.js';
+import { appIdFlag } from '../../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../../lib/client-from-config.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';

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

@@ -1,6 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../../cli/flags.js';
+import { appIdFlag } from '../../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../../lib/client-from-config.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';

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

@@ -1,6 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../../cli/flags.js';
+import { appIdFlag } from '../../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../../lib/client-from-config.js';
 import { isValidUuid } from '../../../lib/flags.js';
 import { printResponse } from '../../../lib/output.js';

package/dist/commands/flows/create.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { printResponse } from '../../lib/output.js';
 export default class FlowsCreate extends Command {

package/dist/commands/flows/get.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/flows/list.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { paginationFlags, paginationParams } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

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

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { basename, extname } from 'node:path';
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../../cli/flags.js';
+import { appIdFlag } from '../../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../../lib/client-from-config.js';
 import { printResponse } from '../../../lib/output.js';
 const IMAGE_MIME_TYPES = {

package/dist/commands/flows/publish.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { confirmFlags, confirmMutation } from '../../lib/confirm.js';
 import { ApiError } from '../../lib/errors.js';

package/dist/commands/flows/update.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/migrations/close.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/close/index.js';

package/dist/commands/migrations/close.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/close/index.js';

package/dist/commands/migrations/create.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/create/index.js';

package/dist/commands/migrations/create.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/create/index.js';

package/dist/commands/migrations/current.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/current/index.js';

package/dist/commands/migrations/current.js

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/current/index.js';

package/dist/commands/migrations/list.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/list/index.js';

package/dist/commands/migrations/list.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/list/index.js';

package/dist/commands/migrations/run.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/run/index.js';

package/dist/commands/migrations/run.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/run/index.js';

package/dist/commands/migrations/show.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/show/index.js';

package/dist/commands/migrations/show.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/show/index.js';

package/dist/commands/migrations/status.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/status/index.js';

package/dist/commands/migrations/status.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/status/index.js';

package/dist/commands/migrations/steps.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/steps/index.js';

package/dist/commands/migrations/steps.js

@@ -0,0 +1,2 @@
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/migrations/steps/index.js';

package/dist/commands/migrations/unuse.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/unuse/index.js';

package/dist/commands/migrations/unuse.js

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/unuse/index.js';

package/dist/commands/migrations/use.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/use/index.js';

package/dist/commands/migrations/use.js

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/migrations/use/index.js';

package/dist/commands/paywalls/create.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { printResponse } from '../../lib/output.js';
 export default class PaywallsCreate extends Command {

package/dist/commands/paywalls/get.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/paywalls/list.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { paginationFlags, paginationParams } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

package/dist/commands/paywalls/placements.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

package/dist/commands/paywalls/update.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/placements/create.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { draftFlowError } from '../../lib/flow-help.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/placements/get.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/placements/list.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { paginationFlags, paginationParams } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

package/dist/commands/placements/update.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { draftFlowError } from '../../lib/flow-help.js';

package/dist/commands/products/create.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { printResponse } from '../../lib/output.js';
 const VALID_PERIODS = [

package/dist/commands/products/get.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/products/list.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { paginationFlags, paginationParams } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

package/dist/commands/products/update.js

@@ -1,5 +1,5 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/segments/get.js

@@ -1,5 +1,5 @@
 import { Args, Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { isValidUuid } from '../../lib/flags.js';
 import { printResponse } from '../../lib/output.js';

package/dist/commands/segments/list.js

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { appIdFlag } from '../../cli/flags.js';
+import { appIdFlag } from '../../cli/input/app.js';
 import { createAuthenticatedClient } from '../../lib/client-from-config.js';
 import { paginationFlags, paginationParams } from '../../lib/flags.js';
 import { printList } from '../../lib/output.js';

package/dist/sdk/adapty/errors.d.ts

@@ -6,5 +6,9 @@ import type { ErrorParser } from '../core/http/index.js';
  *
  * Wired once in createAdapty: which shapes a service speaks is product knowledge, and ASA speaks
  * another — which is why the transport takes the parser as a parameter.
+ *
+ * The Wizard Service sits behind the same transport (section 4.5 of the CLI–WS contract) and
+ * words its rejection as `{ error: { code, message } }` (`WizardError`) — one shape this parser
+ * now reads too, alongside the ones the developer API sends.
  */
 export declare const developerErrorParser: ErrorParser;

package/dist/sdk/adapty/errors.js

@@ -5,6 +5,10 @@
  *
  * Wired once in createAdapty: which shapes a service speaks is product knowledge, and ASA speaks
  * another — which is why the transport takes the parser as a parameter.
+ *
+ * The Wizard Service sits behind the same transport (section 4.5 of the CLI–WS contract) and
+ * words its rejection as `{ error: { code, message } }` (`WizardError`) — one shape this parser
+ * now reads too, alongside the ones the developer API sends.
  */
 export const developerErrorParser = (_status, body) => {
     if (typeof body !== 'object' || body === null) {
@@ -16,11 +20,32 @@ export const developerErrorParser = (_status, body) => {
         // than an HTTP status when the server sends no field errors
         return { code: errorCode, message: fieldMessages(errors) ?? errorCode };
     }
+    if (typeof error === 'object' && error !== null) {
+        const { code, message } = error;
+        if (typeof code === 'string' && code !== '') {
+            return { code, message: typeof message === 'string' && message !== '' ? message : code };
+        }
+    }
     if (typeof error === 'string' && error !== '') {
         return { code: error, message: error };
     }
+    if (Array.isArray(errors)) {
+        return listedErrors(errors);
+    }
     return {};
 };
+/** `{ errors: [{ detail, code, status }] }`: how the API turns a token away, `not_authenticated` on a 403. */
+const listedErrors = (errors) => {
+    const items = errors.filter(item => typeof item === 'object' && item !== null);
+    const details = items.map(item => item.detail).filter(isText);
+    const code = items.map(item => item.code).find(isText);
+    const message = details.length > 0 ? details.join('; ') : code;
+    if (message === undefined) {
+        return {};
+    }
+    return code === undefined ? { message } : { code, message };
+};
+const isText = (value) => typeof value === 'string' && value !== '';
 /** `non_field_errors` is the server's name for "about the request as a whole": printed bare. */
 const fieldMessages = (errors) => {
     if (typeof errors !== 'object' || errors === null) {

package/dist/sdk/adapty/index.d.ts

@@ -1,6 +1,7 @@
 import type { AccessLevelsApi } from './access-levels.js';
 import type { AppsApi } from './apps/index.js';
 import type { AuthApi } from './auth/index.js';
+import type { MigrationApi } from './migrations/index.js';
 import type { Clock } from '../core/clock.js';
 import type { RetryAttempt } from '../core/http/index.js';
 export { platforms } from './apps/index.js';
@@ -8,6 +9,7 @@ export { developerErrorParser } from './errors.js';
 export type { AccessLevel, AccessLevelList, AccessLevelsApi } from './access-levels.js';
 export type { AppDetail, AppsApi, AppSummary, CreateAppInput, UpdateAppInput } from './apps/index.js';
 export type { AuthApi, AuthUser, IssuedToken } from './auth/index.js';
+export type { Action, ActionKind, AvailableFlow, CreateMigrationInput, Envelope, Issue, JsonSchema, Migration, MigrationApi, MigrationList, MigrationState, Progress, ResourceRef, Step, StepStatus, WaitOptions, WizardError, } from './migrations/index.js';
 export type { PageParams, Paginated, Pagination } from './pagination.js';
 /** Exported because the adapter compares the resolved URL with it and warns when they differ. */
 export declare const DEFAULT_ADAPTY_API_URL = "https://api-admin.adapty.io/api/v1/developer";
@@ -20,6 +22,8 @@ export type AdaptyOptions = {
     baseUrl?: string | undefined;
     clock?: Clock | undefined;
     fetch?: typeof globalThis.fetch | undefined;
+    /** Whether a person is watching the caller, for the server's audit trail. */
+    interactive?: boolean | undefined;
     onRetry?: ((info: RetryAttempt) => void) | undefined;
     signal?: AbortSignal | undefined;
     /** Without a token only auth is usable — that is how login builds the sdk. */
@@ -31,6 +35,7 @@ export type Adapty = {
     accessLevels: AccessLevelsApi;
     apps: AppsApi;
     auth: AuthApi;
+    migrations: MigrationApi;
 };
 /** The assembly point of the developer API: one transport, resources on top of it. */
 export declare const createAdapty: (options?: AdaptyOptions) => Adapty;