adapty 0.12.0 → 0.13.0

package/README.md

@@ -72,6 +72,19 @@ adapty products create --app UUID [flags]
 adapty products update --app UUID PRODUCT_ID [flags]
 ```
 
+### Product offers
+
+```sh
+adapty product-offers list --app UUID --product UUID
+adapty product-offers get OFFER_ID --app UUID
+adapty product-offers create --app UUID --product UUID --title "Spring" --type promotional|win_back [--ios-offer-id ID] [--android-offer-id ID]
+adapty product-offers update OFFER_ID --app UUID [--title ...] [--type ...] [--ios-offer-id ID | --clear-ios-offer-id] [--android-offer-id ID | --clear-android-offer-id]
+```
+
+`list` returns every offer on one page. `create` needs at least one store offer id; `win_back` is App Store only.
+`update` reads the offer and writes it back whole: it keeps every field you leave out, overwrites a dashboard edit made
+in between, and refuses to clear the last store side. Introductory offers are read-only. Offers are deleted in the dashboard.
+
 ### Paywalls
 
 ```sh

package/dist/cli/commands/product-offers/create.d.ts

@@ -0,0 +1,15 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersCreate extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<"promotional" | "win_back", import("@oclif/core/interfaces").CustomOptions>;
+        'ios-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'android-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        product: 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<ProductOffer>;
+}

package/dist/cli/commands/product-offers/create.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { offerTypes } from '../../../sdk/adapty/index.js';
+import { validateCreateProductOffer } from '../../../sdk/adapty/product-offers/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { productFlag } from '../../input/product.js';
+import { renderRecord } from '../../views/record.js';
+export default class ProductOffersCreate extends AdaptyCommand {
+    static description = 'Create an offer for a product';
+    static examples = [
+        '<%= config.bin %> product-offers create --app 550e8400-... --product 660e8400-... --title "Spring" --type promotional --ios-offer-id spring_ios --android-offer-id spring-android',
+        '<%= config.bin %> product-offers create --app 550e8400-... --product 660e8400-... --title "Come back" --type win_back --ios-offer-id winback_ios',
+    ];
+    static flags = {
+        ...appIdFlag,
+        ...productFlag,
+        'title': Flags.string({ description: 'Offer title', required: true }),
+        'type': Flags.option({
+            description: 'Offer type (win_back is App Store only)',
+            options: offerTypes,
+            required: true,
+        })(),
+        'ios-offer-id': Flags.string({ description: 'App Store offer ID' }),
+        'android-offer-id': Flags.string({ description: 'Google Play offer ID' }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProductOffersCreate);
+        const input = {
+            androidOfferId: flags['android-offer-id'],
+            iosOfferId: flags['ios-offer-id'],
+            offerType: flags.type,
+            title: flags.title,
+        };
+        assertValid(validateCreateProductOffer(input));
+        const offer = await this.adapty.productOffers.create(flags.app, flags.product, input);
+        this.log('Offer created!');
+        this.render(offer, renderRecord);
+        return offer;
+    }
+}

package/dist/cli/commands/product-offers/get.d.ts

@@ -0,0 +1,13 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersGet extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        offer_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ProductOffer>;
+}

package/dist/cli/commands/product-offers/get.js

@@ -0,0 +1,16 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { offerIdArg } from '../../input/offer.js';
+import { renderRecord } from '../../views/record.js';
+export default class ProductOffersGet extends AdaptyCommand {
+    static description = 'Get a product offer';
+    static examples = ['<%= config.bin %> product-offers get 770e8400-... --app 550e8400-...'];
+    static args = { ...offerIdArg };
+    static flags = { ...appIdFlag };
+    async run() {
+        const { args, flags } = await this.parse(ProductOffersGet);
+        const offer = await this.adapty.productOffers.get(flags.app, args.offer_id);
+        this.render(offer, renderRecord);
+        return offer;
+    }
+}

package/dist/cli/commands/product-offers/list.d.ts

@@ -0,0 +1,11 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { Paginated, ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersList extends AdaptyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        product: 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<Paginated<ProductOffer>>;
+}

package/dist/cli/commands/product-offers/list.js

@@ -0,0 +1,15 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { productFlag } from '../../input/product.js';
+import { renderPage } from '../../views/list.js';
+export default class ProductOffersList extends AdaptyCommand {
+    static description = 'List the offers of a product (all on one page)';
+    static examples = ['<%= config.bin %> product-offers list --app 550e8400-... --product 660e8400-...'];
+    static flags = { ...appIdFlag, ...productFlag };
+    async run() {
+        const { flags } = await this.parse(ProductOffersList);
+        const page = await this.adapty.productOffers.list(flags.app, flags.product);
+        this.render(page, renderPage);
+        return page;
+    }
+}

package/dist/cli/commands/product-offers/update.d.ts

@@ -0,0 +1,20 @@
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import type { ProductOffer } from '../../../sdk/adapty/index.js';
+export default class ProductOffersUpdate extends AdaptyCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        offer_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<"promotional" | "win_back" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'ios-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'android-offer-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'clear-ios-offer-id': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'clear-android-offer-id': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ProductOffer>;
+}

package/dist/cli/commands/product-offers/update.js

@@ -0,0 +1,41 @@
+import { Flags } from '@oclif/core';
+import { offerTypes } from '../../../sdk/adapty/index.js';
+import { validateUpdateProductOffer } from '../../../sdk/adapty/product-offers/index.js';
+import { assertValid } from '../../../sdk/core/validation.js';
+import { AdaptyCommand } from '../../base/adapty/index.js';
+import { appIdFlag } from '../../input/app.js';
+import { offerIdArg } from '../../input/offer.js';
+import { renderRecord } from '../../views/record.js';
+export default class ProductOffersUpdate extends AdaptyCommand {
+    static summary = 'Update a product offer';
+    static description = 'Reads the offer and writes it back whole: fields you leave out keep their stored value, a change made in the '
+        + 'dashboard in between is overwritten, and at least one store offer id must remain.';
+    static examples = [
+        '<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --title "Spring 2"',
+        '<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --clear-android-offer-id',
+    ];
+    static args = { ...offerIdArg };
+    static flags = {
+        ...appIdFlag,
+        'title': Flags.string({ description: 'Offer title' }),
+        'type': Flags.option({ description: 'Offer type (win_back is App Store only: clear the Google Play side too)', options: offerTypes })(),
+        'ios-offer-id': Flags.string({ description: 'App Store offer ID', exclusive: ['clear-ios-offer-id'] }),
+        'android-offer-id': Flags.string({ description: 'Google Play offer ID', exclusive: ['clear-android-offer-id'] }),
+        'clear-ios-offer-id': Flags.boolean({ description: 'Remove the App Store side of the offer' }),
+        'clear-android-offer-id': Flags.boolean({ description: 'Remove the Google Play side of the offer' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProductOffersUpdate);
+        const input = {
+            androidOfferId: flags['clear-android-offer-id'] ? null : flags['android-offer-id'],
+            iosOfferId: flags['clear-ios-offer-id'] ? null : flags['ios-offer-id'],
+            offerType: flags.type,
+            title: flags.title,
+        };
+        assertValid(validateUpdateProductOffer(input));
+        const offer = await this.adapty.productOffers.update(flags.app, args.offer_id, input);
+        this.log('Offer updated!');
+        this.render(offer, renderRecord);
+        return offer;
+    }
+}

package/dist/cli/input/app.js

@@ -1,17 +1,7 @@
 import { Args, Flags } from '@oclif/core';
-import { usageError } from '../errors.js';
-const UUID_PATTERN = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+import { uuidParser } from './uuid.js';
 /** The published wording of both the `app_id` arg and the `--app` flag. */
 const APP_ID_HINT = 'Invalid app ID format. Run `adapty apps list` to find your app ID.';
-const isUuid = (value) => UUID_PATTERN.test(value);
-/**
- * Checking the shape of a value is the parser's job, so a run() never starts with one. oclif turns
- * a *flag* parser's failure into exit 2 itself but passes an *arg* parser's error through, hence
- * the explicit code. The hint is per resource: `adapty apps list` only helps for an app id.
- */
-const uuidParser = (hint) => (input) => (isUuid(input)
-    ? Promise.resolve(input)
-    : Promise.reject(usageError(hint)));
 /** Spread into a command: `static args = { ...appIdArg }`. Texts kept as published. */
 export const appIdArg = {
     app_id: Args.string({

package/dist/cli/input/offer.d.ts

@@ -0,0 +1,3 @@
+export declare const offerIdArg: {
+    offer_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+};

package/dist/cli/input/offer.js

@@ -0,0 +1,9 @@
+import { Args } from '@oclif/core';
+import { uuidParser } from './uuid.js';
+export const offerIdArg = {
+    offer_id: Args.string({
+        description: 'Offer ID (UUID)',
+        parse: uuidParser('Invalid offer ID format.'),
+        required: true,
+    }),
+};

package/dist/cli/input/product.d.ts

@@ -0,0 +1,3 @@
+export declare const productFlag: {
+    product: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+};

package/dist/cli/input/product.js

@@ -0,0 +1,9 @@
+import { Flags } from '@oclif/core';
+import { uuidParser } from './uuid.js';
+export const productFlag = {
+    product: Flags.string({
+        description: 'Product ID (UUID)',
+        parse: uuidParser('Invalid product ID format.'),
+        required: true,
+    }),
+};

package/dist/cli/input/uuid.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Checking the shape of a value is the parser's job, so a run() never starts with one. oclif turns
+ * a *flag* parser's failure into exit 2 itself but passes an *arg* parser's error through, hence
+ * the explicit code. The hint is per resource: `adapty apps list` only helps for an app id.
+ */
+export declare const uuidParser: (hint: string) => (input: string) => Promise<string>;

package/dist/cli/input/uuid.js

@@ -0,0 +1,11 @@
+import { usageError } from '../errors.js';
+const UUID_PATTERN = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
+const isUuid = (value) => UUID_PATTERN.test(value);
+/**
+ * Checking the shape of a value is the parser's job, so a run() never starts with one. oclif turns
+ * a *flag* parser's failure into exit 2 itself but passes an *arg* parser's error through, hence
+ * the explicit code. The hint is per resource: `adapty apps list` only helps for an app id.
+ */
+export const uuidParser = (hint) => (input) => (isUuid(input)
+    ? Promise.resolve(input)
+    : Promise.reject(usageError(hint)));

package/dist/cli/views/analytics/segments.d.ts

@@ -37,8 +37,8 @@ export declare const formatValue: (value: Cell) => string;
 /** A point is found by its `x`. */
 export declare const pointId: (point: object) => string;
 /**
- * How the human view names a point: its `x`, and for a funnel step or a retention period also its title, the
- * number once (`-2 Install`, `1 Paid`, `2 Period`).
+ * How the human view names a point: its `x` (a period start as its date, `2026-09-22`), and for a funnel step or a
+ * retention period also its title, the number once (`-2 Install`, `1 Paid`, `2 Period`). The CSV keeps the raw `x`.
  */
 export declare const pointLabel: (point: object) => string;
 /**

package/dist/cli/views/analytics/segments.js

@@ -29,13 +29,17 @@ const fieldsOf = (value, skip) => leaves(Object.fromEntries(Object.entries(value
 const totalFirst = (segments) => [...segments.filter(segment => segment.is_total), ...segments.filter(segment => !segment.is_total)];
 /** A point is found by its `x`. */
 export const pointId = (point) => String(point.x);
+/** A period start as the backend gives it: a date, a time and an offset, as in `2026-09-22T00:00:00.000000+0200`. */
+const TIMESTAMP = /^(\d{4}-\d{2}-\d{2})T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}(?::?\d{2})?)?$/;
+/** The date of a period start in the period's own time zone: the date part as given, with no conversion. */
+const dateOf = (id) => TIMESTAMP.exec(id)?.[1] ?? id;
 /**
- * How the human view names a point: its `x`, and for a funnel step or a retention period also its title, the
- * number once (`-2 Install`, `1 Paid`, `2 Period`).
+ * How the human view names a point: its `x` (a period start as its date, `2026-09-22`), and for a funnel step or a
+ * retention period also its title, the number once (`-2 Install`, `1 Paid`, `2 Period`). The CSV keeps the raw `x`.
  */
 export const pointLabel = (point) => {
     const { title } = point;
-    const id = pointId(point);
+    const id = dateOf(pointId(point));
     if (typeof title !== 'string') {
         return id;
     }

package/dist/commands/product-offers/create.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/product-offers/create.js';

package/dist/commands/product-offers/create.js

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

package/dist/commands/product-offers/get.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/product-offers/get.js';

package/dist/commands/product-offers/get.js

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

package/dist/commands/product-offers/list.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/product-offers/list.js';

package/dist/commands/product-offers/list.js

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

package/dist/commands/product-offers/update.d.ts

@@ -0,0 +1 @@
+export { default } from '../../cli/commands/product-offers/update.js';

package/dist/commands/product-offers/update.js

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

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

@@ -43,6 +43,7 @@ export type AccessLevelUpdateRequestDTO = {
 export type ProductDTO = {
     access_level_id: string;
     id: string;
+    offers_count: number;
     period: ProductPeriod;
     title: string;
     vendor_products: Record<string, VendorProductDTO>;

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

@@ -4,10 +4,12 @@ import type { AppsApi } from './apps/index.js';
 import type { AuthApi } from './auth/index.js';
 import type { FeedbackApi } from './feedback/index.js';
 import type { MigrationApi } from './migrations/index.js';
+import type { ProductOffersApi } from './product-offers/index.js';
 import type { Clock } from '../core/clock.js';
 import type { RetryAttempt } from '../core/http/index.js';
 export { periodTypes, periodUnits, revenueBases, validateChart, validateCohort, validateConversion, validateFilterValues, validateFunnel, validateLtv, validateRetention, } from './analytics/index.js';
 export { platforms } from './apps/index.js';
+export { offerTypes } from './product-offers/index.js';
 export { developerErrorParser } from './errors.js';
 export { sentiments } from './feedback/index.js';
 export type { AccessLevel, AccessLevelList, AccessLevelsApi } from './access-levels.js';
@@ -16,6 +18,7 @@ export type { AppDetail, AppsApi, AppSummary, CreateAppInput, UpdateAppInput } f
 export type { AuthApi, AuthUser, IssuedToken } from './auth/index.js';
 export type { FeedbackApi, SendFeedbackInput, Sentiment } from './feedback/index.js';
 export type { Action, ActionKind, AvailableFlow, CreateMigrationInput, Envelope, Issue, JsonSchema, Migration, MigrationApi, MigrationList, MigrationState, Progress, ResourceRef, Step, StepStatus, WaitOptions, WizardError, } from './migrations/index.js';
+export type { CreateProductOfferInput, OfferType, ProductOffer, ProductOffersApi, StoreOffer, UpdateProductOfferInput, } from './product-offers/index.js';
 export type { PageParams, Paginated, Pagination } from './pagination.js';
 /** Exported because the adapter compares the resolved URL with it and warns when they differ. */
 export declare const DEFAULT_ADAPTY_API_URL = "https://api-admin.adapty.io/api/v1/developer";
@@ -44,6 +47,7 @@ export type Adapty = {
     auth: AuthApi;
     feedback: FeedbackApi;
     migrations: MigrationApi;
+    productOffers: ProductOffersApi;
 };
 /** The assembly point of the developer API: one transport, resources on top of it. */
 export declare const createAdapty: (options?: AdaptyOptions) => Adapty;

package/dist/sdk/adapty/index.js

@@ -7,8 +7,10 @@ import { auth } from './auth/index.js';
 import { developerErrorParser } from './errors.js';
 import { feedback } from './feedback/index.js';
 import { migrations } from './migrations/index.js';
+import { productOffers } from './product-offers/index.js';
 export { periodTypes, periodUnits, revenueBases, validateChart, validateCohort, validateConversion, validateFilterValues, validateFunnel, validateLtv, validateRetention, } from './analytics/index.js';
 export { platforms } from './apps/index.js';
+export { offerTypes } from './product-offers/index.js';
 export { developerErrorParser } from './errors.js';
 export { sentiments } from './feedback/index.js';
 /** Exported because the adapter compares the resolved URL with it and warns when they differ. */
@@ -55,5 +57,6 @@ export const createAdapty = (options = {}) => {
         // The clock is a dependency here too, not only in the transport: `waitFor` sleeps
         // between polls, and a test must be able to do that instantly.
         migrations: migrations(wizard, options.clock ?? systemClock),
+        productOffers: productOffers(http),
     };
 };

package/dist/sdk/adapty/product-offers/create.d.ts

@@ -0,0 +1,5 @@
+import type { OfferWrite } from './model.js';
+import type { Issue } from '../../core/errors.js';
+export type CreateProductOfferInput = OfferWrite;
+/** A list of problems, knowing nothing about flags or the network. A path names an input field. */
+export declare const validateCreateProductOffer: (input: CreateProductOfferInput) => Issue[];

package/dist/sdk/adapty/product-offers/create.js

@@ -0,0 +1,12 @@
+import { hasStoreId, winBackIssues } from './model.js';
+/** A list of problems, knowing nothing about flags or the network. A path names an input field. */
+export const validateCreateProductOffer = (input) => {
+    const issues = [];
+    if (input.title.trim() === '') {
+        issues.push({ message: 'must not be empty', path: 'title' });
+    }
+    if (!hasStoreId(input)) {
+        issues.push({ fields: ['iosOfferId', 'androidOfferId'], message: 'pass {iosOfferId}, {androidOfferId} or both' });
+    }
+    return [...issues, ...winBackIssues(input)];
+};

package/dist/sdk/adapty/product-offers/index.d.ts

@@ -0,0 +1,9 @@
+/** The door of the product-offers resource: re-exports only, no code of its own. */
+export { offerTypes } from './model.js';
+export { validateCreateProductOffer } from './create.js';
+export { productOffers } from './resource.js';
+export { validateUpdateProductOffer } from './update.js';
+export type { OfferType, ProductOffer, StoreOffer } from './model.js';
+export type { CreateProductOfferInput } from './create.js';
+export type { ProductOffersApi } from './resource.js';
+export type { UpdateProductOfferInput } from './update.js';

package/dist/sdk/adapty/product-offers/index.js

@@ -0,0 +1,5 @@
+/** The door of the product-offers resource: re-exports only, no code of its own. */
+export { offerTypes } from './model.js';
+export { validateCreateProductOffer } from './create.js';
+export { productOffers } from './resource.js';
+export { validateUpdateProductOffer } from './update.js';

package/dist/sdk/adapty/product-offers/model.d.ts

@@ -0,0 +1,48 @@
+/**
+ * What every operation of the resource shares: the offer as the server sends it, and the type
+ * vocabulary. Answers pass through exactly as they arrive, in snake_case, which is what --json prints.
+ */
+import type { Issue } from '../../core/errors.js';
+/** The types a write accepts, as the server names them. */
+export declare const offerTypes: readonly ["promotional", "win_back"];
+export type OfferType = (typeof offerTypes)[number];
+export type StoreOffer = {
+    offer_id: string;
+};
+export type ProductOffer = {
+    /** Null when the offer has no fixed duration. */
+    duration: null | string;
+    id: string;
+    /** Not the OfferType union: the server also answers `introductory`, which a write refuses. */
+    offer_type: string;
+    product_id: string;
+    /** Keyed as the server stored it: `app_store`, `play_store`, and any other key it may hold. */
+    store_offers: Record<string, StoreOffer>;
+    title: string;
+};
+/** The fields of a write. */
+export type OfferWrite = {
+    androidOfferId?: string | undefined;
+    iosOfferId?: string | undefined;
+    offerType: OfferType;
+    title: string;
+};
+/** An update merged onto the stored offer, before the rules have checked its type. */
+export type OfferDraft = Omit<OfferWrite, 'offerType'> & {
+    offerType: string;
+};
+export declare const isOfferType: (value: string) => value is OfferType;
+/** Trimmed, and a blank id is not an id: `--ios-offer-id ""` counts as absent. */
+export declare const storeId: (value: string | undefined) => string | undefined;
+export declare const hasStoreId: (write: OfferDraft) => boolean;
+/** Google Play has no win-back offers: the server refuses a win_back with an android id. */
+export declare const winBackIssues: (write: OfferDraft) => Issue[];
+type OfferWriteRequest = {
+    android_offer_id?: string;
+    ios_offer_id?: string;
+    offer_type: string;
+    title: string;
+};
+/** The body of create and update alike: the server replaces the whole offer. Blank ids are left out. */
+export declare const toWriteRequest: (write: OfferDraft) => OfferWriteRequest;
+export {};

package/dist/sdk/adapty/product-offers/model.js

@@ -0,0 +1,30 @@
+/**
+ * What every operation of the resource shares: the offer as the server sends it, and the type
+ * vocabulary. Answers pass through exactly as they arrive, in snake_case, which is what --json prints.
+ */
+/** The types a write accepts, as the server names them. */
+export const offerTypes = ['promotional', 'win_back'];
+export const isOfferType = (value) => offerTypes.includes(value);
+/** Trimmed, and a blank id is not an id: `--ios-offer-id ""` counts as absent. */
+export const storeId = (value) => {
+    const trimmed = value?.trim();
+    return trimmed === '' ? undefined : trimmed;
+};
+export const hasStoreId = (write) => storeId(write.iosOfferId) !== undefined || storeId(write.androidOfferId) !== undefined;
+/** Google Play has no win-back offers: the server refuses a win_back with an android id. */
+export const winBackIssues = (write) => (write.offerType === 'win_back' && storeId(write.androidOfferId) !== undefined
+    ? [{ message: 'a win_back offer takes only an App Store offer id', path: 'androidOfferId' }]
+    : []);
+/** The body of create and update alike: the server replaces the whole offer. Blank ids are left out. */
+export const toWriteRequest = (write) => {
+    const body = { offer_type: write.offerType, title: write.title };
+    const ios = storeId(write.iosOfferId);
+    const android = storeId(write.androidOfferId);
+    if (ios !== undefined) {
+        body.ios_offer_id = ios;
+    }
+    if (android !== undefined) {
+        body.android_offer_id = android;
+    }
+    return body;
+};

package/dist/sdk/adapty/product-offers/resource.d.ts

@@ -0,0 +1,21 @@
+import type { CreateProductOfferInput } from './create.js';
+import type { ProductOffer } from './model.js';
+import type { UpdateProductOfferInput } from './update.js';
+import type { Http } from '../../core/http/index.js';
+import type { Paginated } from '../pagination.js';
+/**
+ * Offers are listed and created under a product and read and changed by their own id under the app:
+ * the two path shapes the server routes. There is no delete: offers are deleted in the dashboard only.
+ *
+ * The validating methods are async on purpose: a broken rule arrives as a rejected promise, like a
+ * network failure.
+ */
+export declare const productOffers: (http: Http) => {
+    get: (appId: string, offerId: string) => Promise<ProductOffer>;
+    /** The server answers every offer of the product on one page. */
+    list: (appId: string, productId: string) => Promise<Paginated<ProductOffer>>;
+    create: (appId: string, productId: string, input: CreateProductOfferInput) => Promise<ProductOffer>;
+    /** A full replace on the server, so this reads the stored offer and sends it back merged. */
+    update: (appId: string, offerId: string, input: UpdateProductOfferInput) => Promise<ProductOffer>;
+};
+export type ProductOffersApi = ReturnType<typeof productOffers>;

package/dist/sdk/adapty/product-offers/resource.js

@@ -0,0 +1,28 @@
+import { assertValid } from '../../core/validation.js';
+import { validateCreateProductOffer } from './create.js';
+import { toWriteRequest } from './model.js';
+import { mergeProductOffer, validateMergedProductOffer, validateUpdateProductOffer } from './update.js';
+/**
+ * Offers are listed and created under a product and read and changed by their own id under the app:
+ * the two path shapes the server routes. There is no delete: offers are deleted in the dashboard only.
+ *
+ * The validating methods are async on purpose: a broken rule arrives as a rejected promise, like a
+ * network failure.
+ */
+export const productOffers = (http) => ({
+    get: (appId, offerId) => http.get(`/apps/${appId}/offers/${offerId}`),
+    /** The server answers every offer of the product on one page. */
+    list: (appId, productId) => http.get(`/apps/${appId}/products/${productId}/offers`),
+    create: async (appId, productId, input) => {
+        assertValid(validateCreateProductOffer(input));
+        return http.post(`/apps/${appId}/products/${productId}/offers`, toWriteRequest(input));
+    },
+    /** A full replace on the server, so this reads the stored offer and sends it back merged. */
+    update: async (appId, offerId, input) => {
+        assertValid(validateUpdateProductOffer(input));
+        const stored = await http.get(`/apps/${appId}/offers/${offerId}`);
+        const merged = mergeProductOffer(stored, input);
+        assertValid(validateMergedProductOffer(stored, input, merged));
+        return http.put(`/apps/${appId}/offers/${offerId}`, toWriteRequest(merged));
+    },
+});

package/dist/sdk/adapty/product-offers/update.d.ts

@@ -0,0 +1,19 @@
+import type { OfferDraft, OfferType, ProductOffer } from './model.js';
+import type { Issue } from '../../core/errors.js';
+/** A store id is replaced by a string and removed by null; undefined or blank keeps what is stored. */
+export type UpdateProductOfferInput = {
+    androidOfferId?: null | string | undefined;
+    iosOfferId?: null | string | undefined;
+    offerType?: OfferType | undefined;
+    title?: string | undefined;
+};
+/** Rules that need no stored offer, so they run before the first request. */
+export declare const validateUpdateProductOffer: (input: UpdateProductOfferInput) => Issue[];
+/** The offer after the update: the server replaces the whole offer, so untouched fields come from the stored one. */
+export declare const mergeProductOffer: (offer: ProductOffer, input: UpdateProductOfferInput) => OfferDraft;
+/**
+ * Rules on the stored offer and the merged one, so they run after the read and before the write. The
+ * write carries only `app_store` and `play_store`, so an offer with any other store key is refused
+ * rather than losing that side to the replace.
+ */
+export declare const validateMergedProductOffer: (offer: ProductOffer, input: UpdateProductOfferInput, merged: OfferDraft) => Issue[];

package/dist/sdk/adapty/product-offers/update.js

@@ -0,0 +1,42 @@
+import { hasStoreId, isOfferType, storeId, winBackIssues } from './model.js';
+const given = (value) => (value === null ? null : storeId(value));
+/** Rules that need no stored offer, so they run before the first request. */
+export const validateUpdateProductOffer = (input) => {
+    const fields = [input.title, input.offerType, given(input.iosOfferId), given(input.androidOfferId)];
+    if (fields.every(value => value === undefined)) {
+        return [{ message: 'nothing to update: pass a title, a type or a store offer id' }];
+    }
+    if (input.title?.trim() === '') {
+        return [{ message: 'must not be empty', path: 'title' }];
+    }
+    return [];
+};
+const pick = (value, stored) => (value === undefined ? stored : (value ?? undefined));
+/** The offer after the update: the server replaces the whole offer, so untouched fields come from the stored one. */
+export const mergeProductOffer = (offer, input) => ({
+    androidOfferId: pick(given(input.androidOfferId), storeId(offer.store_offers.play_store?.offer_id)),
+    iosOfferId: pick(given(input.iosOfferId), storeId(offer.store_offers.app_store?.offer_id)),
+    offerType: input.offerType ?? offer.offer_type,
+    title: input.title ?? offer.title,
+});
+/**
+ * Rules on the stored offer and the merged one, so they run after the read and before the write. The
+ * write carries only `app_store` and `play_store`, so an offer with any other store key is refused
+ * rather than losing that side to the replace.
+ */
+export const validateMergedProductOffer = (offer, input, merged) => {
+    if (!isOfferType(offer.offer_type)) {
+        return [{ message: `${offer.offer_type} offers are read-only` }];
+    }
+    const otherKeys = Object.keys(offer.store_offers).filter(key => key !== 'app_store' && key !== 'play_store');
+    if (otherKeys.length > 0) {
+        return [{ message: `this offer has store sides the update would drop (${otherKeys.join(', ')}): edit it in the dashboard` }];
+    }
+    if (!hasStoreId(merged)) {
+        return [{ message: 'an offer needs at least one store offer id: delete it in the dashboard instead of clearing both' }];
+    }
+    if (given(input.androidOfferId) === undefined && winBackIssues(merged).length > 0) {
+        return [{ message: 'a win_back offer takes only an App Store offer id: clear the stored Google Play one' }];
+    }
+    return winBackIssues(merged);
+};

package/oclif.manifest.json

@@ -3135,6 +3135,277 @@
         "update.js"
       ]
     },
+    "product-offers:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create an offer for a product",
+      "examples": [
+        "<%= config.bin %> product-offers create --app 550e8400-... --product 660e8400-... --title \"Spring\" --type promotional --ios-offer-id spring_ios --android-offer-id spring-android",
+        "<%= config.bin %> product-offers create --app 550e8400-... --product 660e8400-... --title \"Come back\" --type win_back --ios-offer-id winback_ios"
+      ],
+      "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"
+        },
+        "product": {
+          "description": "Product ID (UUID)",
+          "name": "product",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "title": {
+          "description": "Offer title",
+          "name": "title",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Offer type (win_back is App Store only)",
+          "name": "type",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "promotional",
+            "win_back"
+          ],
+          "type": "option"
+        },
+        "ios-offer-id": {
+          "description": "App Store offer ID",
+          "name": "ios-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "android-offer-id": {
+          "description": "Google Play offer ID",
+          "name": "android-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:create",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "create.js"
+      ]
+    },
+    "product-offers:get": {
+      "aliases": [],
+      "args": {
+        "offer_id": {
+          "description": "Offer ID (UUID)",
+          "name": "offer_id",
+          "required": true
+        }
+      },
+      "description": "Get a product offer",
+      "examples": [
+        "<%= config.bin %> product-offers get 770e8400-... --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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:get",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "get.js"
+      ]
+    },
+    "product-offers:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the offers of a product (all on one page)",
+      "examples": [
+        "<%= config.bin %> product-offers list --app 550e8400-... --product 660e8400-..."
+      ],
+      "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"
+        },
+        "product": {
+          "description": "Product ID (UUID)",
+          "name": "product",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "list.js"
+      ]
+    },
+    "product-offers:update": {
+      "aliases": [],
+      "args": {
+        "offer_id": {
+          "description": "Offer ID (UUID)",
+          "name": "offer_id",
+          "required": true
+        }
+      },
+      "description": "Reads the offer and writes it back whole: fields you leave out keep their stored value, a change made in the dashboard in between is overwritten, and at least one store offer id must remain.",
+      "examples": [
+        "<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --title \"Spring 2\"",
+        "<%= config.bin %> product-offers update 770e8400-... --app 550e8400-... --clear-android-offer-id"
+      ],
+      "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"
+        },
+        "title": {
+          "description": "Offer title",
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Offer type (win_back is App Store only: clear the Google Play side too)",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "promotional",
+            "win_back"
+          ],
+          "type": "option"
+        },
+        "ios-offer-id": {
+          "description": "App Store offer ID",
+          "exclusive": [
+            "clear-ios-offer-id"
+          ],
+          "name": "ios-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "android-offer-id": {
+          "description": "Google Play offer ID",
+          "exclusive": [
+            "clear-android-offer-id"
+          ],
+          "name": "android-offer-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "clear-ios-offer-id": {
+          "description": "Remove the App Store side of the offer",
+          "name": "clear-ios-offer-id",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "clear-android-offer-id": {
+          "description": "Remove the Google Play side of the offer",
+          "name": "clear-android-offer-id",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "product-offers:update",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Update a product offer",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "product-offers",
+        "update.js"
+      ]
+    },
     "products:create": {
       "aliases": [],
       "args": {},
@@ -6752,55 +7023,6 @@
         "list.js"
       ]
     },
-    "asa:orgs:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List the Apple Search Ads organizations this company can spend from",
-      "examples": [
-        "<%= config.bin %> asa orgs list"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
-          "name": "page-size",
-          "default": 100,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "asa:orgs:list",
-      "pluginAlias": "adapty",
-      "pluginName": "adapty",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "asa",
-        "orgs",
-        "list.js"
-      ]
-    },
     "asa:product-pages:list": {
       "aliases": [],
       "args": {},
@@ -7019,6 +7241,55 @@
         "list.js"
       ]
     },
+    "asa:orgs:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List the Apple Search Ads organizations this company can spend from",
+      "examples": [
+        "<%= config.bin %> asa orgs list"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page-size": {
+          "description": "Items per page (max 1000); prefer one big page over a pagination loop",
+          "name": "page-size",
+          "default": 100,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "asa:orgs:list",
+      "pluginAlias": "adapty",
+      "pluginName": "adapty",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "asa",
+        "orgs",
+        "list.js"
+      ]
+    },
     "asa:segments:create": {
       "aliases": [],
       "args": {},
@@ -7554,5 +7825,5 @@
       ]
     }
   },
-  "version": "0.12.0"
+  "version": "0.13.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adapty",
   "description": "Adapty command line interface",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "author": "Adapty team <support@adapty.io>",
   "bin": {
     "adapty": "./bin/run.js"
@@ -81,6 +81,9 @@
       "products": {
         "description": "Manage products"
       },
+      "product-offers": {
+        "description": "Manage product offers"
+      },
       "access-levels": {
         "description": "Manage access levels"
       },