adapty 0.1.0

package/README.md

@@ -0,0 +1,110 @@
+# adapty-cli
+
+CLI for the [Adapty Developer API](https://docs.adapty.io/docs/developer-api). Manage apps, products, paywalls, placements, and access levels from your terminal.
+
+## Installation
+
+```sh
+npm install -g adapty-cli
+```
+
+Requires Node.js >= 18.
+
+## Authentication
+
+```sh
+adapty auth login
+```
+
+Opens browser for OAuth device flow. Token is stored in `~/.config/adapty/config.json`.
+
+Override with `ADAPTY_TOKEN` environment variable:
+
+```sh
+ADAPTY_TOKEN=your-token adapty apps list
+```
+
+Other auth commands:
+
+```sh
+adapty auth whoami     # verify token, show user info
+adapty auth status     # show local auth state
+adapty auth logout     # clear stored token
+```
+
+## Commands
+
+All resource commands require `--app APP_ID` (UUID). Use `adapty apps list` to find your app ID.
+
+### Apps
+
+```sh
+adapty apps list [--page N] [--page-size N]
+adapty apps get APP_ID
+adapty apps create --name "My App" --platform ios --ios-bundle-id com.example.app
+adapty apps update APP_ID [flags]
+```
+
+### Products
+
+```sh
+adapty products list --app UUID [--page N] [--page-size N]
+adapty products get --app UUID PRODUCT_ID
+adapty products create --app UUID [flags]
+adapty products update --app UUID PRODUCT_ID [flags]
+```
+
+### Paywalls
+
+```sh
+adapty paywalls list --app UUID [--page N] [--page-size N]
+adapty paywalls get --app UUID PAYWALL_ID
+adapty paywalls create --app UUID --name "Name" --product-id UUID1 [--product-id UUID2]
+adapty paywalls update --app UUID PAYWALL_ID [flags]
+```
+
+### Placements
+
+```sh
+adapty placements list --app UUID [--page N] [--page-size N]
+adapty placements get --app UUID PLACEMENT_ID
+adapty placements create --app UUID [flags]
+adapty placements update --app UUID PLACEMENT_ID [flags]
+```
+
+### Access Levels
+
+```sh
+adapty access-levels list --app UUID [--page N] [--page-size N]
+adapty access-levels get --app UUID ACCESS_LEVEL_ID
+adapty access-levels create --app UUID [flags]
+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) |
+| `--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`) |
+
+## Development
+
+```sh
+pnpm install
+pnpm build
+./bin/run.js apps list
+```
+
+## License
+
+MIT

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

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

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+interface AccessLevelResponse {
+    id: string;
+    sdk_id: string;
+    title: string;
+}
+export default class AccessLevelsCreate extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'sdk-id': import("@oclif/core/interfaces").OptionFlag<string, 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<AccessLevelResponse>;
+}
+export {};

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

@@ -0,0 +1,28 @@
+import { Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag } from '../../lib/flags.js';
+export default class AccessLevelsCreate extends Command {
+    static description = 'Create a custom access level';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> access-levels create --app 550e8400-... --sdk-id vip --title "VIP Access"',
+    ];
+    static flags = {
+        ...appFlag,
+        'sdk-id': Flags.string({ description: 'Access level SDK identifier', required: true }),
+        title: Flags.string({ description: 'Access level title', required: true }),
+    };
+    async run() {
+        const { flags } = await this.parse(AccessLevelsCreate);
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.post(`/apps/${flags.app}/access-levels`, {
+            sdk_id: flags['sdk-id'],
+            title: flags.title,
+        });
+        this.log('Access level created!');
+        this.log(`ID: ${result.id}`);
+        this.log(`SDK ID: ${result.sdk_id}`);
+        this.log(`Title: ${result.title}`);
+        return result;
+    }
+}

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

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+interface AccessLevelDetailResponse {
+    id: string;
+    sdk_id: string;
+    title: string;
+}
+export default class AccessLevelsGet extends Command {
+    static args: {
+        access_level_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<AccessLevelDetailResponse>;
+}
+export {};

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

@@ -0,0 +1,26 @@
+import { Args, Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+export default class AccessLevelsGet extends Command {
+    static args = {
+        access_level_id: Args.string({ description: 'Access Level ID (UUID)', required: true }),
+    };
+    static description = 'Get access level details';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> access-levels get --app UUID 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = {
+        ...appFlag,
+    };
+    async run() {
+        const { args, flags } = await this.parse(AccessLevelsGet);
+        if (!isValidUuid(args.access_level_id)) {
+            this.error('Invalid access level ID format.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/access-levels/${args.access_level_id}`);
+        this.log(`ID: ${result.id}`);
+        this.log(`SDK ID: ${result.sdk_id}`);
+        this.log(`Title: ${result.title}`);
+        return result;
+    }
+}

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

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+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;
+    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<AccessLevelItem>>;
+}
+export {};

package/dist/commands/access-levels/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 AccessLevelsList extends Command {
+    static description = 'List access levels for an app';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> access-levels list --app 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = {
+        ...appFlag,
+        ...paginationFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(AccessLevelsList);
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/access-levels`, paginationParams(flags));
+        printList(result.data.map((al) => ({ ID: al.id, 'SDK ID': al.sdk_id, Title: al.title })), this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

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

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+interface AccessLevelResponse {
+    id: string;
+    sdk_id: string;
+    title: string;
+}
+export default class AccessLevelsUpdate extends Command {
+    static args: {
+        access_level_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        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<AccessLevelResponse>;
+}
+export {};

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

@@ -0,0 +1,32 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+export default class AccessLevelsUpdate extends Command {
+    static args = {
+        access_level_id: Args.string({ description: 'Access Level ID (UUID)', required: true }),
+    };
+    static description = 'Update an access level';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> access-levels update --app UUID 550e8400-... --title "VIP Access"',
+    ];
+    static flags = {
+        ...appFlag,
+        title: Flags.string({ description: 'Access level title', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AccessLevelsUpdate);
+        if (!isValidUuid(args.access_level_id)) {
+            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}`, {
+            title: flags.title,
+        });
+        this.log('Access level updated!');
+        this.log(`ID: ${result.id}`);
+        this.log(`SDK ID: ${result.sdk_id}`);
+        this.log(`Title: ${result.title}`);
+        return result;
+    }
+}

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

@@ -0,0 +1,25 @@
+import { Command } from '@oclif/core';
+interface AppCreateResponse {
+    app: {
+        id: string;
+        name: string;
+        sdk_key: string;
+    };
+    default_access_level: {
+        id: string;
+        sdk_id: string;
+    };
+}
+export default class AppsCreate extends Command {
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'android-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ios-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        platform: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AppCreateResponse>;
+}
+export {};

package/dist/commands/apps/create.js

@@ -0,0 +1,47 @@
+import { Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+export default class AppsCreate extends Command {
+    static description = 'Create a new Adapty app';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> apps create --name "My App" --platform ios --ios-bundle-id com.example.app',
+        '<%= config.bin %> apps create --name "My App" --platform ios --platform android --ios-bundle-id com.example.app --android-bundle-id com.example.app',
+    ];
+    static flags = {
+        'android-bundle-id': Flags.string({ description: 'Android bundle ID (required with --platform android)' }),
+        'ios-bundle-id': Flags.string({ description: 'iOS bundle ID (required with --platform ios)' }),
+        name: Flags.string({ description: 'App name', required: true }),
+        platform: Flags.string({
+            description: 'Platform (ios, android). Repeat for multiple.',
+            multiple: true,
+            options: ['ios', 'android'],
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AppsCreate);
+        if (flags.platform.includes('ios') && !flags['ios-bundle-id']) {
+            this.error('--ios-bundle-id is required when --platform ios is specified', { exit: 2 });
+        }
+        if (flags.platform.includes('android') && !flags['android-bundle-id']) {
+            this.error('--android-bundle-id is required when --platform android is specified', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const body = {
+            app_name: flags.name,
+            platforms: flags.platform,
+        };
+        if (flags['ios-bundle-id'])
+            body.ios_bundle_id = flags['ios-bundle-id'];
+        if (flags['android-bundle-id'])
+            body.android_bundle_id = flags['android-bundle-id'];
+        const result = await client.post('/apps', body);
+        this.log('App created!');
+        this.log(`ID: ${result.app.id}`);
+        this.log(`Name: ${result.app.name}`);
+        this.log(`SDK Key: ${result.app.sdk_key}`);
+        this.log(`Default Access Level ID: ${result.default_access_level.id}`);
+        this.log(`Default Access Level SDK ID: ${result.default_access_level.sdk_id}`);
+        return result;
+    }
+}

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

@@ -0,0 +1,20 @@
+import { Command } from '@oclif/core';
+interface AppDetailResponse {
+    android_bundle_id?: string;
+    id: string;
+    ios_bundle_id?: string;
+    name: string;
+    platforms: string[];
+    sdk_key: string;
+    secret_key: string;
+}
+export default class AppsGet extends Command {
+    static args: {
+        app_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    run(): Promise<AppDetailResponse>;
+}
+export {};

package/dist/commands/apps/get.js

@@ -0,0 +1,29 @@
+import { Args, Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { isValidUuid } from '../../lib/flags.js';
+export default class AppsGet extends Command {
+    static args = {
+        app_id: Args.string({ description: 'App ID (UUID)', required: true }),
+    };
+    static description = 'Get app details';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> apps get 550e8400-e29b-41d4-a716-446655440000'];
+    async run() {
+        const { args } = await this.parse(AppsGet);
+        if (!isValidUuid(args.app_id)) {
+            this.error('Invalid app ID format. Run `adapty apps list` to find your app ID.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${args.app_id}`);
+        this.log(`ID: ${result.id}`);
+        this.log(`Name: ${result.name}`);
+        this.log(`SDK Key: ${result.sdk_key}`);
+        this.log(`Secret Key: ${result.secret_key}`);
+        this.log(`Platforms: ${result.platforms.join(', ')}`);
+        if (result.ios_bundle_id)
+            this.log(`iOS Bundle ID: ${result.ios_bundle_id}`);
+        if (result.android_bundle_id)
+            this.log(`Android Bundle ID: ${result.android_bundle_id}`);
+        return result;
+    }
+}

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

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+import { type PaginatedResponse } from '../../lib/flags.js';
+interface AppItem {
+    id: string;
+    name: string;
+    sdk_key: string;
+}
+export default class AppsList 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>;
+    };
+    run(): Promise<PaginatedResponse<AppItem>>;
+}
+export {};

package/dist/commands/apps/list.js

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { paginationFlags, paginationParams } from '../../lib/flags.js';
+import { printList } from '../../lib/output.js';
+export default class AppsList extends Command {
+    static description = 'List Adapty apps';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> apps list', '<%= config.bin %> apps list --page 2 --page-size 10'];
+    static flags = {
+        ...paginationFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(AppsList);
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get('/apps', paginationParams(flags));
+        printList(result.data.map((app) => ({ ID: app.id, Name: app.name, 'SDK Key': app.sdk_key })), this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

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

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+interface AppResponse {
+    android_bundle_id?: string;
+    id: string;
+    ios_bundle_id?: string;
+    name: string;
+}
+export default class AppsUpdate extends Command {
+    static args: {
+        app_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'android-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ios-bundle-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<AppResponse>;
+}
+export {};

package/dist/commands/apps/update.js

@@ -0,0 +1,42 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { isValidUuid } from '../../lib/flags.js';
+export default class AppsUpdate extends Command {
+    static args = {
+        app_id: Args.string({ description: 'App ID (UUID)', required: true }),
+    };
+    static description = 'Update an app';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> apps update 550e8400-... --name "My App"'];
+    static flags = {
+        'android-bundle-id': Flags.string({ description: 'Android bundle ID' }),
+        'ios-bundle-id': Flags.string({ description: 'iOS bundle ID' }),
+        name: Flags.string({ description: 'App name' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AppsUpdate);
+        if (!isValidUuid(args.app_id)) {
+            this.error('Invalid app ID format. Run `adapty apps list` to find your app ID.', { exit: 2 });
+        }
+        if (!flags.name && !flags['ios-bundle-id'] && !flags['android-bundle-id']) {
+            this.error('At least one of --name, --ios-bundle-id, or --android-bundle-id is required', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const body = {};
+        if (flags.name)
+            body.name = flags.name;
+        if (flags['ios-bundle-id'])
+            body.ios_bundle_id = flags['ios-bundle-id'];
+        if (flags['android-bundle-id'])
+            body.android_bundle_id = flags['android-bundle-id'];
+        const result = await client.put(`/apps/${args.app_id}`, body);
+        this.log('App updated!');
+        this.log(`ID: ${result.id}`);
+        this.log(`Name: ${result.name}`);
+        if (result.ios_bundle_id)
+            this.log(`iOS Bundle ID: ${result.ios_bundle_id}`);
+        if (result.android_bundle_id)
+            this.log(`Android Bundle ID: ${result.android_bundle_id}`);
+        return result;
+    }
+}

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

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class AuthLogin extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}