adapty 0.1.4 → 0.2.0

package/README.md

@@ -1,11 +1,15 @@
-# adapty-cli
+<a href="https://adapty.io/?utm_source=github&utm_medium=referral&utm_campaign=adapty-cli">
+    <img src="https://adapty-portal-media-production.s3.amazonaws.com/github/logo-adapty-new.svg">
+</a>
 
-CLI for the [Adapty Developer API](https://docs.adapty.io/docs/developer-api). Manage apps, products, paywalls, placements, and access levels from your terminal.
+# Adapty CLI
+
+[Adapty Developer CLI](https://adapty.io/docs/developer-cli). Manage apps, products, paywalls, placements, and access levels from your terminal.
 
 ## Installation
 
 ```sh
-npm install -g adapty-cli
+npm install -g adapty
 ```
 
 Requires Node.js >= 18.
@@ -84,19 +88,27 @@ adapty access-levels update --app UUID ACCESS_LEVEL_ID [flags]
 
 ### Global Flags
 
-| Flag | Description |
-|------|-------------|
-| `--json` | Output as JSON |
-| `--help` | Show help |
-| `--page` | Page number (default: 1) |
+| Flag          | Description                            |
+| ------------- | -------------------------------------- |
+| `--json`      | Output as JSON                         |
+| `--help`      | Show help                              |
+| `--page`      | Page number (default: 1)               |
 | `--page-size` | Items per page (default: 20, max: 100) |
 
 ## Environment Variables
 
-| Variable | Description |
-|----------|-------------|
-| `ADAPTY_TOKEN` | Override stored auth token |
-| `ADAPTY_API_URL` | Override API base URL (default: `https://api.adapty.io/api/v1/developer`) |
+| Variable         | Description                                                                     |
+| ---------------- | ------------------------------------------------------------------------------- |
+| `ADAPTY_TOKEN`   | Override stored auth token                                                      |
+| `ADAPTY_API_URL` | Override API base URL (default: `https://api-admin.adapty.io/api/v1/developer`) |
+
+## Claude Code Skill
+
+Install the Adapty CLI skill for Claude Code:
+
+```sh
+npx skills add adaptyteam/adapty-cli --skill adapty-cli
+```
 
 ## Development
 

package/dist/commands/access-levels/create.d.ts

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { AccessLevelDTO } from '../../lib/api-schemas.js';
 export default class AccessLevelsCreate extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -8,5 +9,5 @@ export default class AccessLevelsCreate extends Command {
         title: 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<Record<string, unknown>>;
+    run(): Promise<AccessLevelDTO>;
 }

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

@@ -16,10 +16,11 @@ export default class AccessLevelsCreate extends Command {
     async run() {
         const { flags } = await this.parse(AccessLevelsCreate);
         const client = await createAuthenticatedClient(this.config);
-        const result = await client.post(`/apps/${flags.app}/access-levels`, {
+        const body = {
             sdk_id: flags['sdk-id'],
             title: flags.title,
-        });
+        };
+        const result = await client.post(`/apps/${flags.app}/access-levels`, body);
         this.log('Access level created!');
         printResponse(result, this.log.bind(this));
         return result;

package/dist/commands/access-levels/get.d.ts

@@ -1,9 +1,5 @@
 import { Command } from '@oclif/core';
-interface AccessLevelDetailResponse {
-    id: string;
-    sdk_id: string;
-    title: string;
-}
+import type { AccessLevelDTO } from '../../lib/api-schemas.js';
 export default class AccessLevelsGet extends Command {
     static args: {
         access_level_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -14,6 +10,5 @@ export default class AccessLevelsGet extends Command {
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<AccessLevelDetailResponse>;
+    run(): Promise<AccessLevelDTO>;
 }
-export {};

package/dist/commands/access-levels/list.d.ts

@@ -1,10 +1,6 @@
 import { Command } from '@oclif/core';
+import type { AccessLevelDTO } from '../../lib/api-schemas.js';
 import { type PaginatedResponse } from '../../lib/flags.js';
-interface AccessLevelItem {
-    id: string;
-    sdk_id: string;
-    title: string;
-}
 export default class AccessLevelsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -14,6 +10,5 @@ export default class AccessLevelsList extends Command {
         'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<PaginatedResponse<AccessLevelItem>>;
+    run(): Promise<PaginatedResponse<AccessLevelDTO>>;
 }
-export {};

package/dist/commands/access-levels/update.d.ts

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { AccessLevelDTO } from '../../lib/api-schemas.js';
 export default class AccessLevelsUpdate extends Command {
     static args: {
         access_level_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -10,5 +11,5 @@ export default class AccessLevelsUpdate extends Command {
         title: 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<Record<string, unknown>>;
+    run(): Promise<AccessLevelDTO>;
 }

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

@@ -21,9 +21,10 @@ export default class AccessLevelsUpdate extends Command {
             this.error('Invalid access level ID format.', { exit: 2 });
         }
         const client = await createAuthenticatedClient(this.config);
-        const result = await client.put(`/apps/${flags.app}/access-levels/${args.access_level_id}`, {
+        const body = {
             title: flags.title,
-        });
+        };
+        const result = await client.put(`/apps/${flags.app}/access-levels/${args.access_level_id}`, body);
         this.log('Access level updated!');
         printResponse(result, this.log.bind(this));
         return result;

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

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { AppSummaryDTO } from '../../lib/api-schemas.js';
 export default class AppsCreate extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -9,5 +10,5 @@ export default class AppsCreate extends Command {
         platform: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
         title: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<Record<string, unknown>>;
+    run(): Promise<AppSummaryDTO>;
 }

package/dist/commands/apps/create.js

@@ -39,10 +39,9 @@ export default class AppsCreate extends Command {
         const result = await client.post('/apps', body);
         this.log('App created!');
         printResponse(result, this.log.bind(this));
-        // Fetch default access level for the new app
         try {
             const accessLevels = await client.get(`/apps/${result.id}/access-levels`);
-            if (accessLevels.items?.length > 0) {
+            if (accessLevels.items?.length) {
                 this.log('\nDefault access level:');
                 printResponse(accessLevels.items[0], this.log.bind(this));
             }

package/dist/commands/apps/get.d.ts

@@ -1,13 +1,5 @@
 import { Command } from '@oclif/core';
-interface AppDetailResponse {
-    apple_bundle_id?: string;
-    google_bundle_id?: string;
-    id: string;
-    platforms: string[];
-    sdk_key: string;
-    secret_key: string;
-    title: string;
-}
+import type { AppDetailDTO } from '../../lib/api-schemas.js';
 export default class AppsGet extends Command {
     static args: {
         app_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -15,6 +7,5 @@ export default class AppsGet extends Command {
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
-    run(): Promise<AppDetailResponse>;
+    run(): Promise<AppDetailDTO>;
 }
-export {};

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

@@ -1,10 +1,6 @@
 import { Command } from '@oclif/core';
+import type { AppSummaryDTO } from '../../lib/api-schemas.js';
 import { type PaginatedResponse } from '../../lib/flags.js';
-interface AppItem {
-    id: string;
-    sdk_key: string;
-    title: string;
-}
 export default class AppsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -13,6 +9,5 @@ export default class AppsList extends Command {
         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>;
     };
-    run(): Promise<PaginatedResponse<AppItem>>;
+    run(): Promise<PaginatedResponse<AppSummaryDTO>>;
 }
-export {};

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

@@ -1,10 +1,5 @@
 import { Command } from '@oclif/core';
-interface AppResponse {
-    apple_bundle_id?: string;
-    google_bundle_id?: string;
-    id: string;
-    title: string;
-}
+import type { AppDetailDTO } from '../../lib/api-schemas.js';
 export default class AppsUpdate extends Command {
     static args: {
         app_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -17,6 +12,5 @@ export default class AppsUpdate extends Command {
         'google-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<AppResponse>;
+    run(): Promise<AppDetailDTO>;
 }
-export {};

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

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { PaywallDTO } from '../../lib/api-schemas.js';
 export default class PaywallsCreate extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -8,5 +9,5 @@ export default class PaywallsCreate extends Command {
         title: 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<Record<string, unknown>>;
+    run(): Promise<PaywallDTO>;
 }

package/dist/commands/paywalls/create.js

@@ -20,10 +20,11 @@ export default class PaywallsCreate extends Command {
     async run() {
         const { flags } = await this.parse(PaywallsCreate);
         const client = await createAuthenticatedClient(this.config);
-        const result = await client.post(`/apps/${flags.app}/paywalls`, {
+        const body = {
             product_ids: flags['product-id'],
             title: flags.title,
-        });
+        };
+        const result = await client.post(`/apps/${flags.app}/paywalls`, body);
         this.log('Paywall created!');
         printResponse(result, this.log.bind(this));
         return result;

package/dist/commands/paywalls/get.d.ts

@@ -1,9 +1,5 @@
 import { Command } from '@oclif/core';
-interface PaywallDetailResponse {
-    id: string;
-    product_ids: string[];
-    title: string;
-}
+import type { PaywallDTO } from '../../lib/api-schemas.js';
 export default class PaywallsGet extends Command {
     static args: {
         paywall_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -14,6 +10,5 @@ export default class PaywallsGet extends Command {
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<PaywallDetailResponse>;
+    run(): Promise<PaywallDTO>;
 }
-export {};

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

@@ -1,9 +1,6 @@
 import { Command } from '@oclif/core';
+import type { PaywallDTO } from '../../lib/api-schemas.js';
 import { type PaginatedResponse } from '../../lib/flags.js';
-interface PaywallItem {
-    id: string;
-    title: string;
-}
 export default class PaywallsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -13,6 +10,5 @@ export default class PaywallsList extends Command {
         'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<PaginatedResponse<PaywallItem>>;
+    run(): Promise<PaginatedResponse<PaywallDTO>>;
 }
-export {};

package/dist/commands/paywalls/placements.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import type { PlacementSummaryDTO } from '../../lib/api-schemas.js';
+interface PlacementsByPaywallResponse {
+    data: PlacementSummaryDTO[];
+}
+export default class PaywallsPlacements extends Command {
+    static args: {
+        paywall_id: 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<PlacementsByPaywallResponse>;
+}
+export {};

package/dist/commands/paywalls/placements.js

@@ -0,0 +1,25 @@
+import { Args, Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+import { printList } from '../../lib/output.js';
+export default class PaywallsPlacements extends Command {
+    static args = {
+        paywall_id: Args.string({ description: 'Paywall ID (UUID)', required: true }),
+    };
+    static description = 'List placements that currently use this paywall';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002'];
+    static flags = {
+        ...appFlag,
+    };
+    async run() {
+        const { args, flags } = await this.parse(PaywallsPlacements);
+        if (!isValidUuid(args.paywall_id)) {
+            this.error('Invalid paywall ID format.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/paywalls/${args.paywall_id}/placements`);
+        printList(result.data, this.log.bind(this));
+        return result;
+    }
+}

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

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { PaywallDTO } from '../../lib/api-schemas.js';
 export default class PaywallsUpdate extends Command {
     static args: {
         paywall_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -11,5 +12,5 @@ export default class PaywallsUpdate extends Command {
         title: 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<Record<string, unknown>>;
+    run(): Promise<PaywallDTO>;
 }

package/dist/commands/paywalls/update.js

@@ -26,10 +26,11 @@ export default class PaywallsUpdate extends Command {
             this.error('Invalid paywall ID format.', { exit: 2 });
         }
         const client = await createAuthenticatedClient(this.config);
-        const result = await client.put(`/apps/${flags.app}/paywalls/${args.paywall_id}`, {
+        const body = {
             product_ids: flags['product-id'],
             title: flags.title,
-        });
+        };
+        const result = await client.put(`/apps/${flags.app}/paywalls/${args.paywall_id}`, body);
         this.log('Paywall updated!');
         printResponse(result, this.log.bind(this));
         return result;

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

@@ -1,13 +1,15 @@
 import { Command } from '@oclif/core';
+import type { PlacementDetailDTO } from '../../lib/api-schemas.js';
 export default class PlacementsCreate extends Command {
     static description: string;
     static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
+        audiences: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'developer-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'paywall-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'paywall-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         title: 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<Record<string, unknown>>;
+    run(): Promise<PlacementDetailDTO>;
 }

package/dist/commands/placements/create.js

@@ -6,22 +6,45 @@ 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 --paywall-id UUID',
+        '<%= 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 --paywall-id PAYWALL_UUID',
     ];
     static flags = {
         ...appFlag,
+        audiences: Flags.string({
+            description: 'JSON array of audience entries: [{segment_ids, paywall_id, priority}]',
+            exactlyOne: ['paywall-id', 'audiences'],
+        }),
         'developer-id': Flags.string({ description: 'Developer ID for the placement', required: true }),
-        'paywall-id': Flags.string({ description: 'Paywall ID (UUID)', required: true }),
+        'paywall-id': Flags.string({
+            description: 'Paywall ID (UUID). DEPRECATED: use --audiences.',
+            exactlyOne: ['paywall-id', 'audiences'],
+        }),
         title: Flags.string({ description: 'Placement title', required: true }),
     };
     async run() {
         const { flags } = await this.parse(PlacementsCreate);
-        const client = await createAuthenticatedClient(this.config);
-        const result = await client.post(`/apps/${flags.app}/placements`, {
+        const body = {
+            audiences: null,
             developer_id: flags['developer-id'],
-            paywall_id: flags['paywall-id'],
+            paywall_id: null,
             title: flags.title,
-        });
+        };
+        if (flags['paywall-id']) {
+            process.stderr.write('⚠️  --paywall-id is deprecated. Use --audiences instead.\n' +
+                '    `paywall_id` will be removed from the API in a future release.\n');
+            body.paywall_id = flags['paywall-id'];
+        }
+        else {
+            try {
+                body.audiences = JSON.parse(flags.audiences);
+            }
+            catch (error) {
+                this.error(`Invalid --audiences JSON: ${error instanceof Error ? error.message : String(error)}`, { exit: 2 });
+            }
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.post(`/apps/${flags.app}/placements`, body);
         this.log('Placement created!');
         printResponse(result, this.log.bind(this));
         return result;

package/dist/commands/placements/get.d.ts

@@ -1,10 +1,5 @@
 import { Command } from '@oclif/core';
-interface PlacementDetailResponse {
-    developer_id: string;
-    id: string;
-    paywall_id: string;
-    title: string;
-}
+import type { PlacementDetailDTO } from '../../lib/api-schemas.js';
 export default class PlacementsGet extends Command {
     static args: {
         placement_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -15,6 +10,5 @@ export default class PlacementsGet extends Command {
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<PlacementDetailResponse>;
+    run(): Promise<PlacementDetailDTO>;
 }
-export {};

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

@@ -1,10 +1,6 @@
 import { Command } from '@oclif/core';
+import type { PlacementSummaryDTO } from '../../lib/api-schemas.js';
 import { type PaginatedResponse } from '../../lib/flags.js';
-interface PlacementItem {
-    developer_id: string;
-    id: string;
-    title: string;
-}
 export default class PlacementsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -14,6 +10,5 @@ export default class PlacementsList extends Command {
         'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<PaginatedResponse<PlacementItem>>;
+    run(): Promise<PaginatedResponse<PlacementSummaryDTO>>;
 }
-export {};

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

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { PlacementDetailDTO } from '../../lib/api-schemas.js';
 export default class PlacementsUpdate extends Command {
     static args: {
         placement_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -7,10 +8,11 @@ export default class PlacementsUpdate extends Command {
     static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
+        audiences: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'developer-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'paywall-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'paywall-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         title: 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<Record<string, unknown>>;
+    run(): Promise<PlacementDetailDTO>;
 }

package/dist/commands/placements/update.js

@@ -9,12 +9,20 @@ 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 --paywall-id UUID',
+        '<%= 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 --paywall-id PAYWALL_UUID',
     ];
     static flags = {
         ...appFlag,
+        audiences: Flags.string({
+            description: 'JSON array of audience entries: [{segment_ids, paywall_id, priority}]',
+            exactlyOne: ['paywall-id', 'audiences'],
+        }),
         'developer-id': Flags.string({ description: 'Developer ID for the placement', required: true }),
-        'paywall-id': Flags.string({ description: 'Paywall ID (UUID)', required: true }),
+        'paywall-id': Flags.string({
+            description: 'Paywall ID (UUID). DEPRECATED: use --audiences.',
+            exactlyOne: ['paywall-id', 'audiences'],
+        }),
         title: Flags.string({ description: 'Placement title', required: true }),
     };
     async run() {
@@ -22,12 +30,30 @@ export default class PlacementsUpdate extends Command {
         if (!isValidUuid(args.placement_id)) {
             this.error('Invalid placement ID format.', { exit: 2 });
         }
-        const client = await createAuthenticatedClient(this.config);
-        const result = await client.put(`/apps/${flags.app}/placements/${args.placement_id}`, {
+        const body = {
+            audiences: null,
             developer_id: flags['developer-id'],
-            paywall_id: flags['paywall-id'],
+            paywall_id: null,
             title: flags.title,
-        });
+        };
+        if (flags['paywall-id']) {
+            process.stderr.write('⚠️  --paywall-id is deprecated. Use --audiences instead.\n' +
+                '    `paywall_id` will be removed from the API in a future release.\n');
+            process.stderr.write('⚠️  --paywall-id will rewrite all audiences on this placement.\n' +
+                '    If the placement has segment-specific paywalls, they will be replaced\n' +
+                '    by a single default audience. Use --audiences to preserve them.\n');
+            body.paywall_id = flags['paywall-id'];
+        }
+        else {
+            try {
+                body.audiences = JSON.parse(flags.audiences);
+            }
+            catch (error) {
+                this.error(`Invalid --audiences JSON: ${error instanceof Error ? error.message : String(error)}`, { exit: 2 });
+            }
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.put(`/apps/${flags.app}/placements/${args.placement_id}`, body);
         this.log('Placement updated!');
         printResponse(result, this.log.bind(this));
         return result;

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

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { ProductDTO } from '../../lib/api-schemas.js';
 export default class ProductsCreate extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -12,5 +13,5 @@ export default class ProductsCreate extends Command {
         title: 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<Record<string, unknown>>;
+    run(): Promise<ProductDTO>;
 }

package/dist/commands/products/create.js

@@ -2,7 +2,15 @@ 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';
-const VALID_PERIODS = ['weekly', 'monthly', 'two_months', 'trimonthly', 'semiannual', 'annual', 'lifetime'];
+const VALID_PERIODS = [
+    'weekly',
+    'monthly',
+    'two_months',
+    'trimonthly',
+    'semiannual',
+    'annual',
+    'lifetime',
+];
 export default class ProductsCreate extends Command {
     static description = 'Create a product with vendor products per platform';
     static enableJsonFlag = true;

package/dist/commands/products/get.d.ts

@@ -1,11 +1,5 @@
 import { Command } from '@oclif/core';
-interface ProductDetailResponse {
-    access_level_id: string;
-    id: string;
-    period: string;
-    title: string;
-    vendor_products: Record<string, unknown>;
-}
+import type { ProductDTO } from '../../lib/api-schemas.js';
 export default class ProductsGet extends Command {
     static args: {
         product_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -16,6 +10,5 @@ export default class ProductsGet extends Command {
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<ProductDetailResponse>;
+    run(): Promise<ProductDTO>;
 }
-export {};

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

@@ -1,10 +1,6 @@
 import { Command } from '@oclif/core';
+import type { ProductDTO } from '../../lib/api-schemas.js';
 import { type PaginatedResponse } from '../../lib/flags.js';
-interface ProductItem {
-    id: string;
-    title: string;
-    vendor_products: Record<string, unknown>;
-}
 export default class ProductsList extends Command {
     static description: string;
     static enableJsonFlag: boolean;
@@ -14,6 +10,5 @@ export default class ProductsList extends Command {
         'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<PaginatedResponse<ProductItem>>;
+    run(): Promise<PaginatedResponse<ProductDTO>>;
 }
-export {};

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

@@ -1,4 +1,5 @@
 import { Command } from '@oclif/core';
+import type { ProductDTO } from '../../lib/api-schemas.js';
 export default class ProductsUpdate extends Command {
     static args: {
         product_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
@@ -11,5 +12,5 @@ export default class ProductsUpdate extends Command {
         title: 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<Record<string, unknown>>;
+    run(): Promise<ProductDTO>;
 }

package/dist/commands/segments/get.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+import type { SegmentDTO } from '../../lib/api-schemas.js';
+export default class SegmentsGet extends Command {
+    static args: {
+        segment_id: 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<SegmentDTO>;
+}

package/dist/commands/segments/get.js

@@ -0,0 +1,25 @@
+import { Args, Command } 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 SegmentsGet extends Command {
+    static args = {
+        segment_id: Args.string({ description: 'Segment ID (UUID)', required: true }),
+    };
+    static description = 'Get segment details';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = {
+        ...appFlag,
+    };
+    async run() {
+        const { args, flags } = await this.parse(SegmentsGet);
+        if (!isValidUuid(args.segment_id)) {
+            this.error('Invalid segment ID format.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/segments/${args.segment_id}`);
+        printResponse(result, this.log.bind(this));
+        return result;
+    }
+}

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

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+import type { SegmentDTO } from '../../lib/api-schemas.js';
+import { type PaginatedResponse } from '../../lib/flags.js';
+export default class SegmentsList extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        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>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<PaginatedResponse<SegmentDTO>>;
+}

package/dist/commands/segments/list.js

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, paginationFlags, paginationParams } from '../../lib/flags.js';
+import { printList } from '../../lib/output.js';
+export default class SegmentsList extends Command {
+    static description = 'List segments for an app';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> segments list --app 550e8400-...'];
+    static flags = {
+        ...appFlag,
+        ...paginationFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(SegmentsList);
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/segments`, paginationParams(flags));
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

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

@@ -0,0 +1,99 @@
+export type ProductPeriod = 'annual' | 'consumable' | 'lifetime' | 'monthly' | 'nonsubscriptions' | 'semiannual' | 'trimonthly' | 'two_months' | 'uncategorised' | 'weekly';
+export interface VendorProductDTO {
+    base_plan_id: null | string;
+    id: null | string;
+    product_id: null | string;
+}
+export interface AppSummaryDTO {
+    id: string;
+    sdk_key: null | string;
+    title: string;
+}
+export interface AppDetailDTO {
+    apple_bundle_id: null | string;
+    google_bundle_id: null | string;
+    id: string;
+    platforms: string[];
+    sdk_key: null | string;
+    secret_key: null | string;
+    title: string;
+}
+export interface AppCreateRequestDTO {
+    apple_bundle_id?: null | string;
+    google_bundle_id?: null | string;
+    title: string;
+}
+export interface AppUpdateRequestDTO {
+    apple_bundle_id?: null | string;
+    google_bundle_id?: null | string;
+    title?: null | string;
+}
+export interface AccessLevelDTO {
+    id: string;
+    sdk_id: string;
+    title: null | string;
+}
+export interface AccessLevelCreateRequestDTO {
+    sdk_id: string;
+    title?: null | string;
+}
+export interface AccessLevelUpdateRequestDTO {
+    title?: null | string;
+}
+export interface ProductDTO {
+    access_level_id: string;
+    id: string;
+    period: ProductPeriod;
+    title: string;
+    vendor_products: Record<string, VendorProductDTO>;
+}
+export interface ProductCreateRequestDTO {
+    access_level_id: string;
+    android_base_plan_id?: null | string;
+    android_product_id?: null | string;
+    ios_product_id?: null | string;
+    period: ProductPeriod;
+    price_usd?: null | number;
+    title: string;
+}
+export interface ProductUpdateRequestDTO {
+    access_level_id: string;
+    title: string;
+}
+export interface PaywallDTO {
+    id: string;
+    product_ids: string[];
+    title: string;
+}
+export interface PaywallWriteRequestDTO {
+    product_ids?: string[];
+    title: string;
+}
+export interface SegmentDTO {
+    description: null | string;
+    id: string;
+    title: string;
+}
+export interface PlacementAudienceEntryDTO {
+    paywall_id: string;
+    priority: number;
+    segment_ids?: string[];
+}
+export interface PlacementSummaryDTO {
+    developer_id: string;
+    id: string;
+    title: string;
+}
+export interface PlacementDetailDTO {
+    audiences?: PlacementAudienceEntryDTO[];
+    developer_id: string;
+    id: string;
+    title: string;
+}
+export interface PlacementWriteRequestDTO {
+    audiences: null | PlacementAudienceEntryDTO[];
+    developer_id: string;
+    /** @deprecated use `audiences` */
+    paywall_id: null | string;
+    title: string;
+}

package/dist/lib/api-schemas.js

@@ -0,0 +1,7 @@
+// Hand-picked DTOs from the Adapty Developer API OpenAPI schema. Kept in
+// lockstep with the server-side `portal.developer_api_context.domains.data_transfer_objects.resource_data.*` types.
+//
+// To refresh after a backend change, fetch the spec with:
+//   curl -H 'Referer: /api/v1/developer/' http://localhost:8000/api/v1/swagger/schema/
+// and update the affected definitions here.
+export {};

package/oclif.manifest.json

@@ -735,6 +735,52 @@
         "list.js"
       ]
     },
+    "paywalls:placements": {
+      "aliases": [],
+      "args": {
+        "paywall_id": {
+          "description": "Paywall ID (UUID)",
+          "name": "paywall_id",
+          "required": true
+        }
+      },
+      "description": "List placements that currently use this paywall",
+      "examples": [
+        "<%= config.bin %> paywalls placements --app UUID 770e8400-e29b-41d4-a716-446655440002"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "paywalls:placements",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "paywalls",
+        "placements.js"
+      ]
+    },
     "paywalls:update": {
       "aliases": [],
       "args": {
@@ -802,7 +848,8 @@
       "args": {},
       "description": "Create a placement with a paywall",
       "examples": [
-        "<%= config.bin %> placements create --app UUID --title \"Default\" --developer-id default --paywall-id UUID"
+        "<%= 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 --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -820,6 +867,13 @@
           "multiple": false,
           "type": "option"
         },
+        "audiences": {
+          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
+          "name": "audiences",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "developer-id": {
           "description": "Developer ID for the placement",
           "name": "developer-id",
@@ -829,9 +883,8 @@
           "type": "option"
         },
         "paywall-id": {
-          "description": "Paywall ID (UUID)",
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
           "name": "paywall-id",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -974,7 +1027,8 @@
       },
       "description": "Update a placement",
       "examples": [
-        "<%= config.bin %> placements update --app UUID 550e8400-... --title \"Default\" --developer-id default --paywall-id UUID"
+        "<%= 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 --paywall-id PAYWALL_UUID"
       ],
       "flags": {
         "json": {
@@ -992,6 +1046,13 @@
           "multiple": false,
           "type": "option"
         },
+        "audiences": {
+          "description": "JSON array of audience entries: [{segment_ids, paywall_id, priority}]",
+          "name": "audiences",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "developer-id": {
           "description": "Developer ID for the placement",
           "name": "developer-id",
@@ -1001,9 +1062,8 @@
           "type": "option"
         },
         "paywall-id": {
-          "description": "Paywall ID (UUID)",
+          "description": "Paywall ID (UUID). DEPRECATED: use --audiences.",
           "name": "paywall-id",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1281,7 +1341,109 @@
         "products",
         "update.js"
       ]
+    },
+    "segments:get": {
+      "aliases": [],
+      "args": {
+        "segment_id": {
+          "description": "Segment ID (UUID)",
+          "name": "segment_id",
+          "required": true
+        }
+      },
+      "description": "Get segment details",
+      "examples": [
+        "<%= config.bin %> segments get --app UUID 550e8400-e29b-41d4-a716-446655440000"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "get.js"
+      ]
+    },
+    "segments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List segments for an app",
+      "examples": [
+        "<%= config.bin %> segments list --app 550e8400-..."
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app": {
+          "description": "App ID (UUID)",
+          "name": "app",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 100)",
+          "name": "page-size",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "segments:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "segments",
+        "list.js"
+      ]
     }
   },
-  "version": "0.1.4"
+  "version": "0.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adapty",
   "description": "Adapty command line interface",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "author": "Adapty team <support@adapty.io>",
   "bin": {
     "adapty": "./bin/run.js"
@@ -42,7 +42,7 @@
     "./dist",
     "./oclif.manifest.json"
   ],
-  "homepage": "https://github.com/adaptyteam/adapty-cli",
+  "homepage": "https://adapty.io/docs/developer-cli",
   "keywords": [
     "adapty",
     "cli",
@@ -79,6 +79,9 @@
       },
       "placements": {
         "description": "Manage placements"
+      },
+      "segments": {
+        "description": "List segments"
       }
     }
   },