adapty 0.8.5 → 0.8.7

package/dist/commands/asa/keywords/recommend.js

@@ -0,0 +1,102 @@
+import { Command, Flags } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { printList, printResponse } from '../../../lib/output.js';
+const TYPES = ['brand', 'generic', 'competitor'];
+const PATHS = {
+    brand: '/keyword-recommendations/brand',
+    competitor: '/keyword-recommendations/competitor-brand',
+    generic: '/keyword-recommendations/generic',
+};
+export default class AsaKeywordsRecommend extends Command {
+    static description = 'Keyword recommendations for one of your apps: its brand terms, generic terms, or the brand terms of its selected competitors';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type brand',
+        '<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type generic --country US',
+        '<%= config.bin %> asa keywords recommend --adam-id 1668337467 --type competitor',
+    ];
+    static flags = {
+        'adam-id': Flags.integer({
+            description: 'Apple App Store ID (adam_id) of your app, from `asa apps list`',
+            required: true,
+        }),
+        'country': Flags.string({
+            description: 'ISO country code (e.g. US); repeatable, default every country in the pool',
+            multiple: true,
+        }),
+        'type': Flags.string({ description: 'Which pool to read', options: [...TYPES], required: true }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaKeywordsRecommend);
+        const countries = (flags.country ?? []).map(code => code.trim().toUpperCase());
+        if (countries.some(code => !/^[A-Z]{2}$/.test(code))) {
+            this.error('--country takes two-letter ISO codes, e.g. --country US.', { exit: 2 });
+        }
+        const type = flags.type;
+        const client = await createAsaClient(this);
+        const params = { adam_id: String(flags['adam-id']), country: countries.length > 0 ? countries : undefined };
+        if (type === 'competitor') {
+            const pools = await client.get(PATHS.competitor, params);
+            this.printCompetitorPools(pools);
+            return pools;
+        }
+        const pool = await client.get(PATHS[type], params);
+        this.printPool(pool, type);
+        return pool;
+    }
+    printCompetitorPools(result) {
+        if (result.pools.length === 0) {
+            this.log('No competitors selected for this app yet — select them in the Adapty dashboard (Autopilot setup).');
+            return;
+        }
+        for (const [i, pool] of result.pools.entries()) {
+            printResponse({
+                competitor_adam_id: pool.competitor_adam_id,
+                status: pool.status,
+                keywords_count: pool.keywords.length,
+            }, this.log.bind(this));
+            const hint = this.statusHint(pool.status);
+            if (hint !== undefined) {
+                this.log(hint);
+            }
+            if (pool.keywords.length > 0) {
+                this.log('');
+                printList(pool.keywords.map(keyword => this.omitAdamId(keyword)), this.log.bind(this));
+            }
+            if (i < result.pools.length - 1) {
+                this.log('===');
+            }
+        }
+    }
+    printPool(pool, type) {
+        const header = { status: pool.status, keywords_count: pool.keywords.length };
+        if (type === 'brand') {
+            header.brand_terms = pool.brand?.brand_terms ?? [];
+        }
+        printResponse(header, this.log.bind(this));
+        const hint = this.statusHint(pool.status);
+        if (hint !== undefined) {
+            this.log(hint);
+        }
+        if (pool.keywords.length > 0) {
+            this.log('');
+            const keywords = type === 'brand'
+                ? pool.keywords.map(keyword => this.omitAdamId(keyword))
+                : pool.keywords;
+            printList(keywords, this.log.bind(this));
+        }
+    }
+    omitAdamId(keyword) {
+        const { adam_id: _adamId, ...rest } = keyword;
+        return rest;
+    }
+    statusHint(status) {
+        if (status === 'building') {
+            return 'Still building — retry in about a minute.';
+        }
+        if (status === 'failed') {
+            return 'The pool build failed — retry later or contact support.';
+        }
+        return undefined;
+    }
+}

package/dist/commands/asa/whoami.js

@@ -19,8 +19,12 @@ grouped page may project to before it is refused.`;
             this.log('\nApple Ads is not connected. Run `adapty asa connect` to link an account.');
         }
         if (result.access_source === 'none') {
-            this.log('\nNo active Ads Manager subscription for this company: connecting an account works, but every');
-            this.log('data command answers 402 until the subscription is in place.');
+            this.log('\nNo Ads Manager access for this company: connecting an account works, but every data command');
+            this.log('answers 402 until the Ads Manager trial is started or a subscription is in place.');
+        }
+        if (result.access_source === 'trial') {
+            this.log('\nAccess comes from the Ads Manager trial: every command works, and they stop working when');
+            this.log('the trial ends without a subscription.');
         }
         return result;
     }

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

@@ -1,8 +1 @@
-import { Command } from '@oclif/core';
-export default class AuthLogin extends Command {
-    static description: string;
-    static examples: string[];
-    run(): Promise<void>;
-    /** Keeps the browser on the configured dashboard host, when ADAPTY_APP_URL asks for one. */
-    private verificationUrl;
-}
+export { default } from '../../cli/commands/auth/login.js';

package/dist/commands/auth/login.js

@@ -1,122 +1,2 @@
-import { Command } from '@oclif/core';
-import open from 'open';
-import { ApiClient } from '../../lib/api-client.js';
-import { onAppHost } from '../../lib/app-url.js';
-import { buildUserAgent } from '../../lib/client-from-config.js';
-import { readConfig, writeConfig } from '../../lib/config.js';
-import { ApiError } from '../../lib/errors.js';
-function sleep(ms) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}
-export default class AuthLogin extends Command {
-    static description = 'Authenticate with Adapty via browser';
-    static examples = ['<%= config.bin %> auth login'];
-    async run() {
-        await this.parse(AuthLogin);
-        const config = await readConfig(this.config.configDir);
-        if (config.access_token && config.user) {
-            this.log(`Already authenticated as ${config.user.email}. Re-authenticating...`);
-        }
-        const client = new ApiClient({
-            userAgent: buildUserAgent(this.config),
-        });
-        let device;
-        try {
-            device = await client.post('/auth/device', { client_id: 'adapty-cli' });
-        }
-        catch (error) {
-            this.error(error instanceof Error ? error.message : 'Failed to initiate auth flow', { exit: 1 });
-        }
-        const verificationUrl = this.verificationUrl(device.verification_uri_complete);
-        this.log(`\nYour code: ${device.user_code}\n`);
-        this.log(`If browser doesn't open, visit: ${verificationUrl}\n`);
-        if (process.stdin.isTTY) {
-            try {
-                await open(verificationUrl);
-            }
-            catch {
-                // browser open failed silently — URL already printed
-            }
-        }
-        this.log('Waiting for authorization...');
-        let interval = Math.max((device.interval_seconds || 5) * 1000, 5000);
-        const deadline = Date.now() + device.expires_in * 1000;
-        let consecutiveErrors = 0;
-        // Handle Ctrl+C
-        const onSignal = () => {
-            this.log('\nLogin cancelled.');
-            // eslint-disable-next-line n/no-process-exit -- FIXME if you see this
-            process.exit(0);
-        };
-        process.on('SIGINT', onSignal);
-        try {
-            while (Date.now() < deadline) {
-                await sleep(interval);
-                let result;
-                try {
-                    result = await client.post('/auth/token', {
-                        client_id: 'adapty-cli',
-                        device_code: device.device_code,
-                        grant_type: 'urn:ietf:params:oauth:grant-type:device_code',
-                    });
-                }
-                catch (error) {
-                    if (error instanceof ApiError) {
-                        switch (error.errorCode) {
-                            case 'authorization_pending': {
-                                continue;
-                            }
-                            case 'slow_down': {
-                                interval += 5000;
-                                continue;
-                            }
-                            case 'access_denied': {
-                                this.error('Authorization denied.', { exit: 1 });
-                                break;
-                            }
-                            case 'expired_token': {
-                                this.error('Code expired. Run `adapty auth login` again.', { exit: 1 });
-                                break;
-                            }
-                            default:
-                            // unexpected API error — fall through to network error handling
-                        }
-                    }
-                    consecutiveErrors++;
-                    if (consecutiveErrors >= 10) {
-                        this.error('Too many consecutive network errors. Check your connection and try again.', { exit: 1 });
-                    }
-                    if (consecutiveErrors >= 3) {
-                        process.stderr.write(`Warning: ${consecutiveErrors} consecutive network errors (${error instanceof Error ? error.message : 'unknown'})\n`);
-                    }
-                    continue;
-                }
-                consecutiveErrors = 0;
-                if ('access_token' in result) {
-                    await writeConfig({
-                        access_token: result.access_token,
-                        user: result.user,
-                    }, this.config.configDir);
-                    this.log(`\nAuthenticated as ${result.user.email}`);
-                    this.log(`Token saved to ${this.config.configDir}/config.json`);
-                    return;
-                }
-            }
-            this.error('Code expired. Run `adapty auth login` again.', { exit: 1 });
-        }
-        finally {
-            process.removeListener('SIGINT', onSignal);
-        }
-    }
-    /** Keeps the browser on the configured dashboard host, when ADAPTY_APP_URL asks for one. */
-    verificationUrl(issuedUrl) {
-        try {
-            return onAppHost(issuedUrl);
-        }
-        catch (error) {
-            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
-        }
-    }
-}
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/auth/login.js';

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

@@ -1,9 +1 @@
-import { Command } from '@oclif/core';
-export default class AuthLogout extends Command {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    run(): Promise<{
-        status: string;
-    }>;
-}
+export { default } from '../../cli/commands/auth/logout.js';

package/dist/commands/auth/logout.js

@@ -1,18 +1,2 @@
-import { Command } from '@oclif/core';
-import { readConfig, writeConfig } from '../../lib/config.js';
-export default class AuthLogout extends Command {
-    static description = 'Remove stored authentication token';
-    static enableJsonFlag = true;
-    static examples = ['<%= config.bin %> auth logout'];
-    async run() {
-        await this.parse(AuthLogout);
-        const config = await readConfig(this.config.configDir);
-        if (!config.access_token) {
-            this.log('Not currently authenticated.');
-            return { status: 'not_authenticated' };
-        }
-        await writeConfig({}, this.config.configDir);
-        this.log('Logged out. Note: token remains valid server-side until expiry.');
-        return { status: 'logged_out' };
-    }
-}
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/auth/logout.js';

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

@@ -1,9 +1 @@
-import { Command } from '@oclif/core';
-export default class AuthRevoke extends Command {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    run(): Promise<{
-        status: string;
-    }>;
-}
+export { default } from '../../cli/commands/auth/revoke.js';

package/dist/commands/auth/revoke.js

@@ -1,21 +1,2 @@
-import { Command } from '@oclif/core';
-import { createAuthenticatedClient } from '../../lib/client-from-config.js';
-import { readConfig, writeConfig } from '../../lib/config.js';
-export default class AuthRevoke extends Command {
-    static description = 'Revoke the current authentication token';
-    static enableJsonFlag = true;
-    static examples = ['<%= config.bin %> auth revoke'];
-    async run() {
-        await this.parse(AuthRevoke);
-        const config = await readConfig(this.config.configDir);
-        if (!config.access_token) {
-            this.log('Not currently authenticated.');
-            return { status: 'not_authenticated' };
-        }
-        const client = await createAuthenticatedClient(this.config);
-        await client.post('/auth/tokens/revoke', { token: config.access_token });
-        await writeConfig({}, this.config.configDir);
-        this.log('Token revoked and logged out.');
-        return { status: 'revoked' };
-    }
-}
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/auth/revoke.js';

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

@@ -1,7 +1 @@
-import { Command } from '@oclif/core';
-export default class AuthStatus extends Command {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    run(): Promise<Record<string, unknown>>;
-}
+export { default } from '../../cli/commands/auth/status/index.js';

package/dist/commands/auth/status.js

@@ -1,26 +1,2 @@
-import { Command } from '@oclif/core';
-import { readConfig } from '../../lib/config.js';
-export default class AuthStatus extends Command {
-    static description = 'Show current authentication state (local only)';
-    static enableJsonFlag = true;
-    static examples = ['<%= config.bin %> auth status'];
-    async run() {
-        await this.parse(AuthStatus);
-        const config = await readConfig(this.config.configDir);
-        if (!config.access_token || !config.user) {
-            this.log('Not authenticated. Run `adapty auth login`.');
-            return { authenticated: false };
-        }
-        const masked = config.access_token.slice(0, 8) + '****';
-        const configPath = `${this.config.configDir}/config.json`;
-        this.log(`Email: ${config.user.email}`);
-        this.log(`Token: ${masked}`);
-        this.log(`Config: ${configPath}`);
-        return {
-            authenticated: true,
-            config_path: configPath,
-            email: config.user.email,
-            token_prefix: config.access_token.slice(0, 8),
-        };
-    }
-}
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/auth/status/index.js';

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

@@ -1,7 +1 @@
-import { Command } from '@oclif/core';
-export default class AuthWhoami extends Command {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    run(): Promise<Record<string, unknown>>;
-}
+export { default } from '../../cli/commands/auth/whoami.js';

package/dist/commands/auth/whoami.js

@@ -1,15 +1,2 @@
-import { Command } from '@oclif/core';
-import { createAuthenticatedClient } from '../../lib/client-from-config.js';
-import { printResponse } from '../../lib/output.js';
-export default class AuthWhoami extends Command {
-    static description = 'Show current user info from server (verifies token)';
-    static enableJsonFlag = true;
-    static examples = ['<%= config.bin %> auth whoami'];
-    async run() {
-        await this.parse(AuthWhoami);
-        const client = await createAuthenticatedClient(this.config);
-        const me = await client.get('/me');
-        printResponse(me, this.log.bind(this));
-        return me;
-    }
-}
+// Implementation lives in the new cli layer; oclif discovers commands only under src/commands.
+export { default } from '../../cli/commands/auth/whoami.js';

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

@@ -78,7 +78,8 @@ export type FlowStatus = string;
 export type FlowDTO = {
     id: string;
     name: string;
-    status: FlowStatus;
+    /** Optional: the flows-update (rename) response leaves status out. Read it from flows get. */
+    status?: FlowStatus;
     updated_at: string;
 };
 export type FlowRemoteConfigDTO = {
@@ -152,8 +153,11 @@ export type PlacementAudienceEntryDTO = PlacementFlowAudienceEntryDTO | Placemen
 export type PlacementSummaryDTO = {
     developer_id: string;
     id: string;
-    /** Placement activation state: true = Live, false = Inactive. */
-    is_active: boolean;
+    /**
+     * Placement activation state: true = Live, false = Inactive.
+     * Optional — the paywall placements list leaves it out.
+     */
+    is_active?: boolean;
     title: string;
 };
 export type PlacementDetailDTO = {

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

@@ -1,4 +1,4 @@
-export type AsaAccessSource = 'allowlist' | 'legacy' | 'none' | 'payg';
+export type AsaAccessSource = 'allowlist' | 'legacy' | 'none' | 'payg' | 'trial';
 export type AsaAppleCredentialsStatus = 'active' | 'expired' | 'invalid' | 'unset';
 export type AsaKeywordMatchType = 'BROAD' | 'EXACT';
 export type AsaKeywordStatus = 'ACTIVE' | 'PAUSED';
@@ -379,3 +379,43 @@ export type AsaBulkConvertResultDTO = {
     request: null | Record<string, unknown>;
     warnings: AsaTemplateIssueDTO[];
 };
+export type AsaKeywordPoolStatus = 'building' | 'empty' | 'failed' | 'missing' | 'ready';
+export type AsaBrandKeywordDTO = {
+    adam_id: number;
+    country: string;
+    median_organic_rank: null | number;
+    popularity: null | number;
+    score: null | number;
+    source: 'llm' | 'name' | 'organic';
+    text: string;
+};
+export type AsaAppBrandDTO = {
+    adam_id: number;
+    brand_terms: string[];
+    source: 'llm' | 'manual';
+};
+export type AsaBrandKeywordPoolDTO = {
+    brand: AsaAppBrandDTO | null;
+    keywords: AsaBrandKeywordDTO[];
+    status: AsaKeywordPoolStatus;
+};
+export type AsaGenericKeywordDTO = {
+    country: string;
+    median_organic_rank: null | number;
+    popularity: null | number;
+    relevance_tier: 'other' | 'top_organic';
+    score: null | number;
+    text: string;
+};
+export type AsaGenericKeywordPoolDTO = {
+    keywords: AsaGenericKeywordDTO[];
+    status: AsaKeywordPoolStatus;
+};
+export type AsaCompetitorBrandKeywordPoolDTO = {
+    competitor_adam_id: number;
+    keywords: AsaBrandKeywordDTO[];
+    status: AsaKeywordPoolStatus;
+};
+export type AsaCompetitorBrandKeywordPoolsDTO = {
+    pools: AsaCompetitorBrandKeywordPoolDTO[];
+};

package/dist/sdk/adapty/access-levels.d.ts

@@ -0,0 +1,15 @@
+import type { Http } from '../core/http/index.js';
+export type AccessLevel = {
+    id: string;
+    sdk_id: string;
+    title: null | string;
+};
+/** Not paginated: this endpoint answers with a bare `items` list, and may omit it entirely. */
+export type AccessLevelList = {
+    items?: AccessLevel[];
+};
+/** Only the read `apps create` needs; the rest arrives with the access-levels commands. */
+export declare const accessLevels: (http: Http) => {
+    list: (appId: string) => Promise<AccessLevelList>;
+};
+export type AccessLevelsApi = ReturnType<typeof accessLevels>;

package/dist/sdk/adapty/access-levels.js

@@ -0,0 +1,4 @@
+/** Only the read `apps create` needs; the rest arrives with the access-levels commands. */
+export const accessLevels = (http) => ({
+    list: (appId) => http.get(`/apps/${appId}/access-levels`),
+});

package/dist/sdk/adapty/apps/create.d.ts

@@ -0,0 +1,26 @@
+import type { Platform } from './model.js';
+import type { Issue } from '../../core/errors.js';
+export type CreateAppInput = {
+    appleBundleId?: string | undefined;
+    googleBundleId?: string | undefined;
+    platforms: readonly Platform[];
+    title: string;
+};
+type CreateAppRequest = {
+    apple_bundle_id?: string;
+    google_bundle_id?: string;
+    platforms: Platform[];
+    title: string;
+};
+/**
+ * The business rules of creating an app: a pure function returning a list of problems, knowing
+ * nothing about flags or the network. An Issue path names an input field (camelCase) and the
+ * adapter turns it into the flag the user typed (src/cli/errors.ts).
+ *
+ * A list instead of a throw, so a table test walks the rules without an environment and the user
+ * sees every problem at once.
+ */
+export declare const validateCreateApp: (input: CreateAppInput) => Issue[];
+/** An absent field is left out of the body: the server tells "not given" from "set to empty". */
+export declare const toCreateRequest: (input: CreateAppInput) => CreateAppRequest;
+export {};

package/dist/sdk/adapty/apps/create.js

@@ -0,0 +1,36 @@
+/**
+ * The business rules of creating an app: a pure function returning a list of problems, knowing
+ * nothing about flags or the network. An Issue path names an input field (camelCase) and the
+ * adapter turns it into the flag the user typed (src/cli/errors.ts).
+ *
+ * A list instead of a throw, so a table test walks the rules without an environment and the user
+ * sees every problem at once.
+ */
+export const validateCreateApp = (input) => {
+    const issues = [];
+    if (input.title.trim() === '') {
+        issues.push({ message: 'must not be empty', path: 'title' });
+    }
+    if (input.platforms.length === 0) {
+        issues.push({ message: 'at least one platform is required', path: 'platform' });
+    }
+    // An empty string counts as missing: `--apple-bundle-id ""` is not a bundle id
+    if (input.platforms.includes('ios') && (input.appleBundleId ?? '') === '') {
+        issues.push({ message: 'required when platforms include ios', path: 'appleBundleId' });
+    }
+    if (input.platforms.includes('android') && (input.googleBundleId ?? '') === '') {
+        issues.push({ message: 'required when platforms include android', path: 'googleBundleId' });
+    }
+    return issues;
+};
+/** An absent field is left out of the body: the server tells "not given" from "set to empty". */
+export const toCreateRequest = (input) => {
+    const body = { platforms: [...input.platforms], title: input.title };
+    if (input.appleBundleId !== undefined) {
+        body.apple_bundle_id = input.appleBundleId;
+    }
+    if (input.googleBundleId !== undefined) {
+        body.google_bundle_id = input.googleBundleId;
+    }
+    return body;
+};

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

@@ -0,0 +1,13 @@
+/**
+ * The door of the apps resource: re-exports only, no code of its own. Everything outside the
+ * directory imports from here, which is what lets the files behind it be rearranged. Only what a
+ * consumer uses passes through — the request builders stay private to their operation.
+ */
+export { platforms } from './model.js';
+export { validateCreateApp } from './create.js';
+export { apps } from './resource.js';
+export { validateUpdateApp } from './update.js';
+export type { AppDetail, AppSummary } from './model.js';
+export type { CreateAppInput } from './create.js';
+export type { AppsApi } from './resource.js';
+export type { UpdateAppInput } from './update.js';

package/dist/sdk/adapty/apps/index.js

@@ -0,0 +1,9 @@
+/**
+ * The door of the apps resource: re-exports only, no code of its own. Everything outside the
+ * directory imports from here, which is what lets the files behind it be rearranged. Only what a
+ * consumer uses passes through — the request builders stay private to their operation.
+ */
+export { platforms } from './model.js';
+export { validateCreateApp } from './create.js';
+export { apps } from './resource.js';
+export { validateUpdateApp } from './update.js';

package/dist/sdk/adapty/apps/model.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What every operation of the resource shares: the entity as the server sends it, and the
+ * platform vocabulary. Answers pass through exactly as they arrive, in snake_case — that is what
+ * --json has printed since the first release.
+ *
+ * An input shape is not shared and does not belong here: it is camelCase, it is our API rather
+ * than the server's, and it lives in the file of the operation that takes it.
+ */
+/** In the order the published help lists them, so `--platform` keeps reading `(ios|android)`. */
+export declare const platforms: readonly ["ios", "android"];
+export type Platform = (typeof platforms)[number];
+export type AppSummary = {
+    id: string;
+    sdk_key: null | string;
+    title: string;
+};
+/** What get and update answer with: the summary plus the fields only the detail view carries. */
+export type AppDetail = AppSummary & {
+    apple_bundle_id: null | string;
+    google_bundle_id: null | string;
+    /** Not the Platform union: the server owns this list and may grow it without asking us. */
+    platforms: string[];
+    secret_key: null | string;
+};

package/dist/sdk/adapty/apps/model.js

@@ -0,0 +1,10 @@
+/**
+ * What every operation of the resource shares: the entity as the server sends it, and the
+ * platform vocabulary. Answers pass through exactly as they arrive, in snake_case — that is what
+ * --json has printed since the first release.
+ *
+ * An input shape is not shared and does not belong here: it is camelCase, it is our API rather
+ * than the server's, and it lives in the file of the operation that takes it.
+ */
+/** In the order the published help lists them, so `--platform` keeps reading `(ios|android)`. */
+export const platforms = ['ios', 'android'];

package/dist/sdk/adapty/apps/resource.d.ts

@@ -0,0 +1,19 @@
+import type { CreateAppInput } from './create.js';
+import type { AppDetail, AppSummary } from './model.js';
+import type { UpdateAppInput } from './update.js';
+import type { Http } from '../../core/http/index.js';
+import type { PageParams, Paginated } from '../pagination.js';
+/**
+ * Every path of the apps resource in one place, so the endpoints can be read as a list. What each
+ * operation needs of its own — input shape, rules, request body — lives in its own file.
+ *
+ * The validating methods are async on purpose — a broken rule then arrives as a rejected promise,
+ * like a network failure, and one await covers both.
+ */
+export declare const apps: (http: Http) => {
+    get: (appId: string) => Promise<AppDetail>;
+    list: (params?: PageParams) => Promise<Paginated<AppSummary>>;
+    create: (input: CreateAppInput) => Promise<AppSummary>;
+    update: (appId: string, input: UpdateAppInput) => Promise<AppDetail>;
+};
+export type AppsApi = ReturnType<typeof apps>;