adapty 0.1.0

package/dist/commands/products/create.js

@@ -0,0 +1,59 @@
+import { Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag } from '../../lib/flags.js';
+const VALID_PERIODS = ['weekly', 'monthly', '2_months', '3_months', '6_months', 'yearly', 'lifetime'];
+export default class ProductsCreate extends Command {
+    static description = 'Create a product with vendor products per platform';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> products create --app UUID --name "Monthly" --access-level-id UUID --period monthly --ios-product-id com.example.monthly',
+    ];
+    static flags = {
+        ...appFlag,
+        'access-level-id': Flags.string({ description: 'Access level ID (UUID)', required: true }),
+        'android-base-plan-id': Flags.string({ description: 'Android base plan ID' }),
+        'android-product-id': Flags.string({ description: 'Android product ID' }),
+        'ios-product-id': Flags.string({ description: 'iOS product ID' }),
+        name: Flags.string({ description: 'Product name', required: true }),
+        period: Flags.string({
+            description: 'Subscription period (weekly, monthly, 2_months, 3_months, 6_months, yearly, lifetime)',
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProductsCreate);
+        if (!VALID_PERIODS.includes(flags.period)) {
+            this.error(`Invalid period. Must be one of: ${VALID_PERIODS.join(', ')}`, { exit: 2 });
+        }
+        if (!flags['ios-product-id'] && !flags['android-product-id']) {
+            this.error('At least one of --ios-product-id or --android-product-id is required', { exit: 2 });
+        }
+        if (flags['android-product-id'] && !flags['android-base-plan-id'] && flags.period !== 'lifetime') {
+            this.error('--android-base-plan-id is required with --android-product-id for subscriptions', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const body = {
+            access_level_id: flags['access-level-id'],
+            name: flags.name,
+            period: flags.period,
+        };
+        if (flags['ios-product-id'])
+            body.ios_product_id = flags['ios-product-id'];
+        if (flags['android-product-id'])
+            body.android_product_id = flags['android-product-id'];
+        if (flags['android-base-plan-id'])
+            body.android_base_plan_id = flags['android-base-plan-id'];
+        const result = await client.post(`/apps/${flags.app}/products`, body);
+        this.log('Product created!');
+        this.log(`ID: ${result.id}`);
+        this.log(`Name: ${result.name}`);
+        if (result.vendor_products.ios) {
+            this.log(`iOS Product: ${result.vendor_products.ios.product_id}`);
+        }
+        if (result.vendor_products.android) {
+            const bp = result.vendor_products.android.base_plan_id;
+            this.log(`Android Product: ${result.vendor_products.android.product_id}${bp ? ` (base plan: ${bp})` : ''}`);
+        }
+        return result;
+    }
+}

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

@@ -0,0 +1,32 @@
+import { Command } from '@oclif/core';
+interface VendorProducts {
+    android?: {
+        base_plan_id?: string;
+        id: string;
+        product_id: string;
+    };
+    ios?: {
+        id: string;
+        product_id: string;
+    };
+}
+interface ProductDetailResponse {
+    access_level_id: string;
+    id: string;
+    name: string;
+    period: string;
+    vendor_products: VendorProducts;
+}
+export default class ProductsGet extends Command {
+    static args: {
+        product_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<ProductDetailResponse>;
+}
+export {};

package/dist/commands/products/get.js

@@ -0,0 +1,34 @@
+import { Args, Command } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+export default class ProductsGet extends Command {
+    static args = {
+        product_id: Args.string({ description: 'Product ID (UUID)', required: true }),
+    };
+    static description = 'Get product details';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> products get --app UUID 550e8400-e29b-41d4-a716-446655440000'];
+    static flags = {
+        ...appFlag,
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProductsGet);
+        if (!isValidUuid(args.product_id)) {
+            this.error('Invalid product ID format.', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/products/${args.product_id}`);
+        this.log(`ID: ${result.id}`);
+        this.log(`Name: ${result.name}`);
+        this.log(`Period: ${result.period}`);
+        this.log(`Access Level ID: ${result.access_level_id}`);
+        if (result.vendor_products.ios) {
+            this.log(`iOS Product: ${result.vendor_products.ios.product_id}`);
+        }
+        if (result.vendor_products.android) {
+            const bp = result.vendor_products.android.base_plan_id;
+            this.log(`Android Product: ${result.vendor_products.android.product_id}${bp ? ` (base plan: ${bp})` : ''}`);
+        }
+        return result;
+    }
+}

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

@@ -0,0 +1,30 @@
+import { Command } from '@oclif/core';
+import { type PaginatedResponse } from '../../lib/flags.js';
+interface VendorProducts {
+    android?: {
+        base_plan_id?: string;
+        id: string;
+        product_id: string;
+    };
+    ios?: {
+        id: string;
+        product_id: string;
+    };
+}
+interface ProductItem {
+    id: string;
+    name: string;
+    vendor_products: VendorProducts;
+}
+export default class ProductsList 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<ProductItem>>;
+}
+export {};

package/dist/commands/products/list.js

@@ -0,0 +1,31 @@
+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 ProductsList extends Command {
+    static description = 'List products for an app';
+    static enableJsonFlag = true;
+    static examples = ['<%= config.bin %> products list --app 550e8400-...'];
+    static flags = {
+        ...appFlag,
+        ...paginationFlags,
+    };
+    async run() {
+        const { flags } = await this.parse(ProductsList);
+        const client = await createAuthenticatedClient(this.config);
+        const result = await client.get(`/apps/${flags.app}/products`, paginationParams(flags));
+        printList(result.data.map((p) => {
+            const row = { ID: p.id, Name: p.name };
+            if (p.vendor_products.ios)
+                row['iOS Product'] = p.vendor_products.ios.product_id;
+            if (p.vendor_products.android) {
+                const bp = p.vendor_products.android.base_plan_id;
+                row['Android Product'] = bp
+                    ? `${p.vendor_products.android.product_id} (base plan: ${bp})`
+                    : p.vendor_products.android.product_id;
+            }
+            return row;
+        }), this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

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

@@ -0,0 +1,36 @@
+import { Command } from '@oclif/core';
+interface VendorProducts {
+    android?: {
+        base_plan_id?: string;
+        id: string;
+        product_id: string;
+    };
+    ios?: {
+        id: string;
+        product_id: string;
+    };
+}
+interface ProductResponse {
+    id: string;
+    name: string;
+    vendor_products: VendorProducts;
+}
+export default class ProductsUpdate extends Command {
+    static args: {
+        product_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static enableJsonFlag: boolean;
+    static examples: string[];
+    static flags: {
+        'access-level-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'android-base-plan-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'android-product-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ios-product-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>;
+        period: 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<ProductResponse>;
+}
+export {};

package/dist/commands/products/update.js

@@ -0,0 +1,65 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { createAuthenticatedClient } from '../../lib/client-from-config.js';
+import { appFlag, isValidUuid } from '../../lib/flags.js';
+const VALID_PERIODS = ['weekly', 'monthly', '2_months', '3_months', '6_months', 'yearly', 'lifetime'];
+export default class ProductsUpdate extends Command {
+    static args = {
+        product_id: Args.string({ description: 'Product ID (UUID)', required: true }),
+    };
+    static description = 'Update a product';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> products update --app UUID 550e8400-... --name "Monthly" --access-level-id UUID --period monthly --ios-product-id com.example.monthly',
+    ];
+    static flags = {
+        ...appFlag,
+        'access-level-id': Flags.string({ description: 'Access level ID (UUID)', required: true }),
+        'android-base-plan-id': Flags.string({ description: 'Android base plan ID' }),
+        'android-product-id': Flags.string({ description: 'Android product ID' }),
+        'ios-product-id': Flags.string({ description: 'iOS product ID' }),
+        name: Flags.string({ description: 'Product name', required: true }),
+        period: Flags.string({
+            description: 'Subscription period (weekly, monthly, 2_months, 3_months, 6_months, yearly, lifetime)',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProductsUpdate);
+        if (!isValidUuid(args.product_id)) {
+            this.error('Invalid product ID format.', { exit: 2 });
+        }
+        if (!VALID_PERIODS.includes(flags.period)) {
+            this.error(`Invalid period. Must be one of: ${VALID_PERIODS.join(', ')}`, { exit: 2 });
+        }
+        if (!flags['ios-product-id'] && !flags['android-product-id']) {
+            this.error('At least one of --ios-product-id or --android-product-id is required', { exit: 2 });
+        }
+        if (flags['android-product-id'] && !flags['android-base-plan-id'] && flags.period !== 'lifetime') {
+            this.error('--android-base-plan-id is required with --android-product-id for subscriptions', { exit: 2 });
+        }
+        const client = await createAuthenticatedClient(this.config);
+        const body = {
+            access_level_id: flags['access-level-id'],
+            name: flags.name,
+            period: flags.period,
+        };
+        if (flags['ios-product-id'])
+            body.ios_product_id = flags['ios-product-id'];
+        if (flags['android-product-id'])
+            body.android_product_id = flags['android-product-id'];
+        if (flags['android-base-plan-id'])
+            body.android_base_plan_id = flags['android-base-plan-id'];
+        const result = await client.put(`/apps/${flags.app}/products/${args.product_id}`, body);
+        this.log('Product updated!');
+        this.log(`ID: ${result.id}`);
+        this.log(`Name: ${result.name}`);
+        if (result.vendor_products.ios) {
+            this.log(`iOS Product: ${result.vendor_products.ios.product_id}`);
+        }
+        if (result.vendor_products.android) {
+            const bp = result.vendor_products.android.base_plan_id;
+            this.log(`Android Product: ${result.vendor_products.android.product_id}${bp ? ` (base plan: ${bp})` : ''}`);
+        }
+        return result;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

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

@@ -0,0 +1,15 @@
+export interface ApiClientOptions {
+    baseUrl?: string;
+    token?: null | string;
+    userAgent?: string;
+}
+export declare class ApiClient {
+    private baseUrl;
+    private token;
+    private userAgent;
+    constructor(opts?: ApiClientOptions);
+    get<T = unknown>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    private request;
+}

package/dist/lib/api-client.js

@@ -0,0 +1,75 @@
+import { ApiError, NetworkError, parseApiError } from './errors.js';
+const DEFAULT_API_URL = 'https://api.adapty.io/api/v1/developer';
+export class ApiClient {
+    baseUrl;
+    token;
+    userAgent;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? process.env.ADAPTY_API_URL ?? DEFAULT_API_URL).replace(/\/$/, '');
+        if (this.baseUrl !== DEFAULT_API_URL) {
+            process.stderr.write(`Warning: using non-default API URL: ${this.baseUrl}\n`);
+        }
+        this.token = opts.token ?? null;
+        this.userAgent = opts.userAgent ?? 'adapty-cli';
+    }
+    async get(path, params) {
+        let url = `${this.baseUrl}${path}`;
+        if (params) {
+            const qs = new URLSearchParams(params);
+            url += `?${qs.toString()}`;
+        }
+        return this.request(url, { method: 'GET' });
+    }
+    async post(path, body) {
+        return this.request(`${this.baseUrl}${path}`, {
+            body: body ? JSON.stringify(body) : undefined,
+            method: 'POST',
+        });
+    }
+    async put(path, body) {
+        return this.request(`${this.baseUrl}${path}`, {
+            body: body ? JSON.stringify(body) : undefined,
+            method: 'PUT',
+        });
+    }
+    // eslint-disable-next-line no-undef
+    async request(url, init) {
+        const headers = {
+            'User-Agent': this.userAgent,
+        };
+        if (init.body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        if (this.token) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        let response;
+        try {
+            response = await fetch(url, { ...init, headers });
+        }
+        catch (error) {
+            throw new NetworkError(error instanceof Error ? error.message : 'Connection failed');
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            if (!response.ok) {
+                throw new ApiError(response.status, `http_${response.status}`, {});
+            }
+            return undefined;
+        }
+        if (!response.ok) {
+            const error = parseApiError(response.status, body);
+            if (response.status === 401) {
+                error.message = 'Token expired or invalid. Run `adapty auth login`.';
+            }
+            throw error;
+        }
+        return body;
+    }
+}

package/dist/lib/auth.d.ts

@@ -0,0 +1 @@
+export declare function resolveToken(configDir?: string): Promise<null | string>;

package/dist/lib/auth.js

@@ -0,0 +1,8 @@
+import { readConfig } from './config.js';
+export async function resolveToken(configDir) {
+    const envToken = process.env.ADAPTY_TOKEN;
+    if (envToken)
+        return envToken;
+    const config = await readConfig(configDir);
+    return config.access_token ?? null;
+}

package/dist/lib/client-from-config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from '@oclif/core';
+import { ApiClient } from './api-client.js';
+export declare function buildUserAgent(config: Config): string;
+export declare function createAuthenticatedClient(config: Config): Promise<ApiClient>;

package/dist/lib/client-from-config.js

@@ -0,0 +1,15 @@
+import { ApiClient } from './api-client.js';
+import { resolveToken } from './auth.js';
+import { AuthRequiredError } from './errors.js';
+export function buildUserAgent(config) {
+    return `adapty-cli/${config.version} node/${process.version} ${process.platform}/${process.arch}`;
+}
+export async function createAuthenticatedClient(config) {
+    const token = await resolveToken(config.configDir);
+    if (!token)
+        throw new AuthRequiredError();
+    return new ApiClient({
+        token,
+        userAgent: buildUserAgent(config),
+    });
+}

package/dist/lib/config.d.ts

@@ -0,0 +1,9 @@
+export interface AdaptyConfig {
+    access_token?: string;
+    user?: {
+        email: string;
+        name: string;
+    };
+}
+export declare function readConfig(configDir?: string): Promise<AdaptyConfig>;
+export declare function writeConfig(config: AdaptyConfig, configDir?: string): Promise<void>;

package/dist/lib/config.js

@@ -0,0 +1,22 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const CONFIG_DIR = join(homedir(), '.config', 'adapty');
+const CONFIG_FILE = 'config.json';
+function configPath(configDir) {
+    return join(configDir ?? CONFIG_DIR, CONFIG_FILE);
+}
+export async function readConfig(configDir) {
+    try {
+        const raw = await readFile(configPath(configDir), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeConfig(config, configDir) {
+    const path = configPath(configDir);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(config, null, 2) + '\n', { encoding: 'utf8', mode: 0o600 });
+}

package/dist/lib/errors.d.ts

@@ -0,0 +1,23 @@
+export interface ApiErrorBody {
+    error?: string;
+    error_code?: string;
+    errors?: Record<string, string[]>;
+    status_code?: number;
+}
+export declare class ApiError extends Error {
+    statusCode: number;
+    errorCode: string;
+    fieldErrors: Record<string, string[]>;
+    constructor(statusCode: number, errorCode: string, fieldErrors: Record<string, string[]>);
+    toHuman(): string;
+    toJSON(): ApiErrorBody;
+}
+export declare class NetworkError extends Error {
+    constructor(message: string);
+    toHuman(): string;
+    toJSON(): ApiErrorBody;
+}
+export declare class AuthRequiredError extends Error {
+    constructor();
+}
+export declare function parseApiError(statusCode: number, body: unknown): ApiError;

package/dist/lib/errors.js

@@ -0,0 +1,63 @@
+export class ApiError extends Error {
+    statusCode;
+    errorCode;
+    fieldErrors;
+    constructor(statusCode, errorCode, fieldErrors) {
+        super(errorCode);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.fieldErrors = fieldErrors;
+        this.name = 'ApiError';
+    }
+    toHuman() {
+        const lines = [`Error: ${this.errorCode}`];
+        const entries = Object.entries(this.fieldErrors);
+        if (entries.length > 0) {
+            lines.push('Field errors:');
+            for (const [field, msgs] of entries) {
+                for (const msg of msgs) {
+                    lines.push(`  ${field}: ${msg}`);
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+    toJSON() {
+        return {
+            error_code: this.errorCode,
+            errors: Object.keys(this.fieldErrors).length > 0 ? this.fieldErrors : undefined,
+            status_code: this.statusCode,
+        };
+    }
+}
+export class NetworkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NetworkError';
+    }
+    toHuman() {
+        return `Error: Could not reach Adapty API. ${this.message}`;
+    }
+    toJSON() {
+        return { error_code: 'network_error', errors: { connection: [this.message] }, status_code: 0 };
+    }
+}
+export class AuthRequiredError extends Error {
+    constructor() {
+        super('Not authenticated. Run `adapty auth login`.');
+        this.name = 'AuthRequiredError';
+    }
+}
+export function parseApiError(statusCode, body) {
+    if (!body || typeof body !== 'object') {
+        return new ApiError(statusCode, `http_${statusCode}`, {});
+    }
+    const parsed = body;
+    if (parsed.error_code) {
+        return new ApiError(statusCode, parsed.error_code, parsed.errors ?? {});
+    }
+    if (parsed.error) {
+        return new ApiError(statusCode, parsed.error, {});
+    }
+    return new ApiError(statusCode, `http_${statusCode}`, {});
+}

package/dist/lib/flags.d.ts

@@ -0,0 +1,22 @@
+export declare function isValidUuid(value: string): boolean;
+export declare const appFlag: {
+    app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};
+export interface PaginatedResponse<T> {
+    data: T[];
+    meta: {
+        pagination: {
+            count: number;
+            page: number;
+            pages: number;
+        };
+    };
+}
+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>;
+};
+export declare function paginationParams(flags: {
+    page: number;
+    'page-size': number;
+}): Record<string, string>;

package/dist/lib/flags.js

@@ -0,0 +1,36 @@
+import { Flags } from '@oclif/core';
+const UUID_REGEX = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+export function isValidUuid(value) {
+    return UUID_REGEX.test(value);
+}
+export const appFlag = {
+    app: Flags.string({
+        description: 'App ID (UUID)',
+        async parse(input) {
+            if (!isValidUuid(input)) {
+                throw new Error('Invalid app ID format. Run `adapty apps list` to find your app ID.');
+            }
+            return input;
+        },
+        required: true,
+    }),
+};
+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,
+    }),
+};
+export function paginationParams(flags) {
+    return {
+        'page[number]': String(flags.page),
+        'page[size]': String(flags['page-size']),
+    };
+}

package/dist/lib/output.d.ts

@@ -0,0 +1,6 @@
+export declare function printKeyValue(data: Record<string, unknown>, log: (msg: string) => void): void;
+export declare function printList(items: Record<string, unknown>[], log: (msg: string) => void, pagination?: {
+    count: number;
+    page: number;
+    pages: number;
+}): void;

package/dist/lib/output.js

@@ -0,0 +1,18 @@
+export function printKeyValue(data, log) {
+    for (const [key, value] of Object.entries(data)) {
+        if (value !== undefined && value !== null) {
+            log(`${key}: ${String(value)}`);
+        }
+    }
+}
+export function printList(items, log, pagination) {
+    for (const [i, item] of items.entries()) {
+        printKeyValue(item, log);
+        if (i < items.length - 1)
+            log('---');
+    }
+    if (pagination) {
+        log('');
+        log(`Page ${pagination.page} of ${pagination.pages} (${pagination.count} total)`);
+    }
+}