adapty 0.9.2 → 0.9.4

package/dist/commands/asa/change-history/list.js

@@ -0,0 +1,102 @@
+import { Command, Flags } from '@oclif/core';
+import { createAsaClient } from '../../../lib/asa-client.js';
+import { asaPaginationFlags, parseDate, periodParams } from '../../../lib/asa-flags.js';
+import { isValidUuid, paginationParams } from '../../../lib/flags.js';
+import { printList } from '../../../lib/output.js';
+const FIELDS_MAX_PAGE_SIZE = 10;
+const MAX_SPAN_DAYS = 14;
+const MS_PER_DAY = 86_400_000;
+export default class AsaChangeHistoryList extends Command {
+    static description = 'Apple Ads change history of one organization, read live from Apple (proxied from the Apple Ads Platform API)';
+    static enableJsonFlag = true;
+    static examples = [
+        '<%= config.bin %> asa change-history list --campaign-group <uuid>',
+        '<%= config.bin %> asa change-history list --campaign-group <uuid> --date-from 2026-09-01 --entity-type Campaign --event-type UPDATE',
+        '<%= config.bin %> asa change-history list --campaign-group <uuid> --fields',
+    ];
+    static flags = {
+        ...asaPaginationFlags,
+        'ad-group': Flags.string({
+            description: 'Keep only changes inside these Apple ad group ids (not UUIDs); repeatable',
+            multiple: true,
+        }),
+        'campaign': Flags.string({
+            description: 'Keep only changes inside these Apple campaign ids (not UUIDs); repeatable',
+            multiple: true,
+        }),
+        'campaign-group': Flags.string({
+            description: 'Organization to read (UUID from asa orgs list); one organization per call',
+            required: true,
+        }),
+        'date-from': Flags.string({
+            description: 'Start of the period (YYYY-MM-DD), defaults to 7 days ago; at most 14 days per call, Apple keeps 6 months',
+            parse: parseDate,
+        }),
+        'date-to': Flags.string({
+            description: 'End of the period (YYYY-MM-DD), defaults to today',
+            parse: parseDate,
+        }),
+        'entity-id': Flags.string({
+            description: 'Keep only changes of these Apple entity ids (not UUIDs); repeatable',
+            multiple: true,
+        }),
+        'entity-type': Flags.string({
+            description: 'Keep only changes of this entity type; repeatable. Default is the campaign domain (Campaign, AdGroup, Keyword, NegativeKeyword, Ad, Creative, LocationGroup); Org and AdAccount cannot be mixed with it',
+            multiple: true,
+            options: ['Ad', 'AdAccount', 'AdGroup', 'Campaign', 'Creative', 'Keyword', 'LocationGroup', 'NegativeKeyword', 'Org'],
+        }),
+        'event-type': Flags.string({
+            description: 'Keep only this operation; repeatable',
+            multiple: true,
+            options: ['CREATE', 'DELETE', 'UPDATE'],
+        }),
+        'fields': Flags.boolean({
+            description: `Expand into flat field-level rows (field, old values, new values); page size defaults to ${FIELDS_MAX_PAGE_SIZE} and may not exceed it`,
+        }),
+        'txn': Flags.string({ description: 'Keep only these Apple transaction ids; repeatable', multiple: true }),
+        'user': Flags.string({
+            description: 'Keep only changes made by these Apple user ids (not emails); repeatable',
+            multiple: true,
+        }),
+        'user-type': Flags.string({
+            description: 'Keep only changes by this actor category; repeatable',
+            multiple: true,
+            options: ['APPLE_SUPPORT', 'CUSTOMER', 'CUSTOMER_API'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AsaChangeHistoryList);
+        const isPageSizeGiven = this.argv.some(arg => arg === '--page-size' || arg.startsWith('--page-size='));
+        if (flags.fields && isPageSizeGiven && flags['page-size'] > FIELDS_MAX_PAGE_SIZE) {
+            this.error(`--fields allows --page-size up to ${FIELDS_MAX_PAGE_SIZE}.`, { exit: 2 });
+        }
+        if (!isValidUuid(flags['campaign-group'])) {
+            this.error('Invalid campaign group ID format. Run `adapty asa orgs list` to find it.', { exit: 2 });
+        }
+        const dateFrom = flags['date-from'];
+        const dateTo = flags['date-to'];
+        if (dateFrom !== undefined
+            && dateTo !== undefined
+            && (Date.parse(dateTo) - Date.parse(dateFrom)) / MS_PER_DAY >= MAX_SPAN_DAYS) {
+            this.error(`--date-from/--date-to may span at most ${MAX_SPAN_DAYS} days.`, { exit: 2 });
+        }
+        const client = await createAsaClient(this);
+        const result = await client.get('/change-history', {
+            ...paginationParams(flags),
+            ...(flags.fields && !isPageSizeGiven ? { 'page[size]': String(FIELDS_MAX_PAGE_SIZE) } : {}),
+            ...periodParams(flags),
+            ad_group_id: flags['ad-group'],
+            campaign_group_id: flags['campaign-group'],
+            campaign_id: flags.campaign,
+            entity_id: flags['entity-id'],
+            entity_type: flags['entity-type'],
+            event_type: flags['event-type'],
+            fields: flags.fields ? 'true' : undefined,
+            txn_id: flags.txn,
+            user_id: flags.user,
+            user_type: flags['user-type'],
+        });
+        printList(result.data, this.log.bind(this), result.meta.pagination);
+        return result;
+    }
+}

package/dist/commands/skills/install.d.ts

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

package/dist/commands/skills/install.js

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

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

@@ -424,3 +424,50 @@ export type AsaCompetitorBrandKeywordPoolDTO = {
 export type AsaCompetitorBrandKeywordPoolsDTO = {
     pools: AsaCompetitorBrandKeywordPoolDTO[];
 };
+export type AsaChangeHistoryEntityRefDTO = {
+    detail_id: string;
+    entity_id: string;
+    entity_name: null | string;
+};
+export type AsaChangeHistoryEventDTO = {
+    campaign_group_id: string;
+    changes_count: number;
+    entities: AsaChangeHistoryEntityRefDTO[];
+    entity_type: string;
+    event_time: string;
+    event_type: string;
+    modified_by: null | string;
+    transaction_id: string;
+    user_type: string;
+};
+export type AsaFieldChangeDTO = {
+    field: string;
+    new_values: string[];
+    old_values: string[];
+};
+export type AsaChangeHistoryDetailDTO = {
+    campaign_group_id: string;
+    changes: AsaFieldChangeDTO[];
+    detail_id: string;
+    entity_id: string;
+    entity_metadata: Record<string, unknown>;
+    entity_type: string;
+    event_time: string;
+    event_type: string;
+    modified_by: null | string;
+    user_type: string;
+};
+export type AsaChangeHistoryFieldEventDTO = {
+    campaign_group_id: string;
+    entity_id: string;
+    entity_name: null | string;
+    entity_type: string;
+    event_time: string;
+    event_type: string;
+    field: string;
+    modified_by: null | string;
+    new_values: string[];
+    old_values: string[];
+    transaction_id: string;
+    user_type: string;
+};

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

@@ -1,5 +1,5 @@
 export type MigrationState = 'running' | 'action_required' | 'completed' | 'failed' | 'canceled';
-export type ActionKind = 'input' | 'upload' | 'external';
+export type ActionKind = 'input' | 'upload' | 'external' | 'agent';
 export type StepStatus = 'locked' | 'active' | 'done';
 export type JsonSchema = Record<string, unknown>;
 export type Envelope<TResult = unknown> = {
@@ -74,6 +74,9 @@ export type Action = ActionBase & ({
 } | {
     kind: 'external';
     href: string;
+} | {
+    kind: 'agent';
+    input_schema: JsonSchema | null;
 } | {
     kind: string;
     href?: string;