@wix/auto_sdk_app-management_billing 1.0.29 → 1.0.31

package/build/cjs/index.d.ts

@@ -7,8 +7,10 @@ interface GetUrlSignature {
     /**
      * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.
      *
+     * Call this method when initiating the purchase flow from your pricing page.
+     * The returned checkout URL redirects to Wix to complete payment.
      *
-     * This call succeeds only in case you have previously
+     * This call succeeds only if you have previously
      * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).
      *
      * The returned checkout URL is valid for 48 hours.
@@ -23,7 +25,7 @@ interface GetUrlSignature {
 declare function getPurchaseHistory$1(httpClient: HttpClient): GetPurchaseHistorySignature;
 interface GetPurchaseHistorySignature {
     /**
-     * Retrieves a list of the site owner's past purchases for your app.
+     * Retrieves a list of past purchases for your app on this site.
      *
      *
      * You don't have to explicitly pass an identifier for the Wix site as part of
@@ -39,7 +41,7 @@ declare const getUrl: MaybeContext<BuildRESTFunction<typeof getUrl$1> & typeof g
 declare const getPurchaseHistory: MaybeContext<BuildRESTFunction<typeof getPurchaseHistory$1> & typeof getPurchaseHistory$1>;
 /**
  * Triggered when there is an update to the payment status of an invoice.
- * Charges made using the [Custom Charges SPI](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.
+ * Charges made using the [Custom Charges service plugin](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.
  * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).
  */
 declare const onPurchasedItemInvoiceStatusUpdated: BuildEventDefinition<typeof onPurchasedItemInvoiceStatusUpdated$1> & typeof onPurchasedItemInvoiceStatusUpdated$1;

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../index.ts","../../src/devcenter-checkout-v1-purchased-item-billing.public.ts","../../src/devcenter-checkout-v1-purchased-item-billing.universal.ts","../../src/devcenter-checkout-v1-purchased-item-billing.http.ts","../../src/devcenter-checkout-v1-purchased-item-billing.context.ts"],"sourcesContent":["export * from './src/devcenter-checkout-v1-purchased-item-billing.context.js';\n","import { renameKeysFromRESTResponseToSDKResponse } from '@wix/sdk-runtime/rename-all-nested-keys';\nimport { EventDefinition, HttpClient, NonNullablePaths } from '@wix/sdk-types';\nimport {\n  GetMeteredBillingChargesOptions,\n  GetMeteredBillingChargesResponse,\n  GetPurchaseHistoryResponse,\n  GetUrlOptions,\n  GetUrlResponse,\n  PurchasedItemInvoiceStatusUpdatedEnvelope,\n  getMeteredBillingCharges as universalGetMeteredBillingCharges,\n  getPurchaseHistory as universalGetPurchaseHistory,\n  getUrl as universalGetUrl,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\n\nexport const __metadata = { PACKAGE_NAME: '@wix/app-management' };\n\nexport function getUrl(httpClient: HttpClient): GetUrlSignature {\n  return (productId: string, options?: GetUrlOptions) =>\n    universalGetUrl(\n      productId,\n      options,\n      // @ts-ignore\n      { httpClient }\n    );\n}\n\ninterface GetUrlSignature {\n  /**\n   * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n   *\n   *\n   * This call succeeds only in case you have previously\n   * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n   *\n   * The returned checkout URL is valid for 48 hours.\n   *\n   * This API allows your app to manage your pricing page outside of Wix while\n   * still using the standard Wix checkout flow.\n   * @param - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n   * for a list of your app's supported product IDs.\n   */\n  (productId: string, options?: GetUrlOptions): Promise<\n    NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>\n  >;\n}\n\nexport function getPurchaseHistory(\n  httpClient: HttpClient\n): GetPurchaseHistorySignature {\n  return () =>\n    universalGetPurchaseHistory(\n      // @ts-ignore\n      { httpClient }\n    );\n}\n\ninterface GetPurchaseHistorySignature {\n  /**\n   * Retrieves a list of the site owner's past purchases for your app.\n   *\n   *\n   * You don't have to explicitly pass an identifier for the Wix site as part of\n   * the request, since this information is taken automatically from the context.\n   *\n   * The response doesn't include any details about cancellations.\n   */\n  (): Promise<\n    NonNullablePaths<\n      GetPurchaseHistoryResponse,\n      | `purchases`\n      | `purchases.${number}.productId`\n      | `purchases.${number}.price`\n      | `purchases.${number}.currency`\n      | `purchases.${number}.billingCycle`,\n      4\n    >\n  >;\n}\n\n/** @internal */\nexport function getMeteredBillingCharges(\n  httpClient: HttpClient\n): GetMeteredBillingChargesSignature {\n  return (options?: GetMeteredBillingChargesOptions) =>\n    universalGetMeteredBillingCharges(\n      options,\n      // @ts-ignore\n      { httpClient }\n    );\n}\n\ninterface GetMeteredBillingChargesSignature {\n  /**\n   * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n   *\n   * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n   *\n   * > **Important:**\n   * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n   */\n  (options?: GetMeteredBillingChargesOptions): Promise<\n    NonNullablePaths<\n      GetMeteredBillingChargesResponse,\n      `charges` | `charges.${number}.description` | `charges.${number}.amount`,\n      4\n    >\n  >;\n}\n\nexport const onPurchasedItemInvoiceStatusUpdated = EventDefinition(\n  'InvoiceStatusUpdated',\n  false,\n  (event: PurchasedItemInvoiceStatusUpdatedEnvelope) =>\n    renameKeysFromRESTResponseToSDKResponse(event)\n)<PurchasedItemInvoiceStatusUpdatedEnvelope>();\n\nexport {\n  BaseEventMetadata,\n  Charge,\n  ChargeOverride,\n  GetMeteredBillingChargesOptions,\n  GetMeteredBillingChargesRequest,\n  GetMeteredBillingChargesResponse,\n  GetPurchaseHistoryRequest,\n  GetPurchaseHistoryResponse,\n  GetSitePaymentMethodsStatusRequest,\n  GetSitePaymentMethodsStatusResponse,\n  GetUrlOptions,\n  GetUrlRequest,\n  GetUrlResponse,\n  IdentificationData,\n  IdentificationDataIdOneOf,\n  InvoiceStatus,\n  InvoiceStatusUpdated,\n  MessageEnvelope,\n  PaymentCycle,\n  PurchasedItem,\n  PurchasedItemInvoiceStatusUpdatedEnvelope,\n  WebhookIdentityType,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\n","import { transformError as sdkTransformError } from '@wix/sdk-runtime/transform-error';\nimport {\n  renameKeysFromSDKRequestToRESTRequest,\n  renameKeysFromRESTResponseToSDKResponse,\n} from '@wix/sdk-runtime/rename-all-nested-keys';\nimport { HttpClient, NonNullablePaths } from '@wix/sdk-types';\nimport * as ambassadorWixDevcenterCheckoutV1PurchasedItem from './devcenter-checkout-v1-purchased-item-billing.http.js';\n\nexport interface PurchasedItem {\n  /** ID of your app's paid plan. */\n  productId?: string;\n  /** Price of your app's paid plan. For example, `9.95`. */\n  price?: string;\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n  /** Information about the billing cycle for your app's paid plan. */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * Date and time the site onwers have purchased your app's paid plan in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  dateCreated?: Date | null;\n}\n\nexport enum PaymentCycle {\n  NO_CYCLE = 'NO_CYCLE',\n  MONTHLY = 'MONTHLY',\n  YEARLY = 'YEARLY',\n  ONE_TIME = 'ONE_TIME',\n  TWO_YEARS = 'TWO_YEARS',\n  THREE_YEARS = 'THREE_YEARS',\n  FOUR_YEARS = 'FOUR_YEARS',\n  FIVE_YEARS = 'FIVE_YEARS',\n}\n\n/** @enumType */\nexport type PaymentCycleWithLiterals =\n  | PaymentCycle\n  | 'NO_CYCLE'\n  | 'MONTHLY'\n  | 'YEARLY'\n  | 'ONE_TIME'\n  | 'TWO_YEARS'\n  | 'THREE_YEARS'\n  | 'FOUR_YEARS'\n  | 'FIVE_YEARS';\n\nexport interface InvoiceStatusUpdated {\n  /** Invoice payment status. */\n  status?: InvoiceStatusWithLiterals;\n  /**\n   * Wix Premium invoice ID.\n   * @maxLength 50\n   */\n  invoiceId?: string;\n  /**\n   * App instance ID - a unique ID assigned to each app in each site.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /** Whether the invoice is for a single payment or for multiple, recurring payments. */\n  recurring?: boolean;\n}\n\nexport enum InvoiceStatus {\n  UNKNOWN_INVOICE_STATUS = 'UNKNOWN_INVOICE_STATUS',\n  PAYMENT_FAILED = 'PAYMENT_FAILED',\n  PAID = 'PAID',\n  REFUNDED = 'REFUNDED',\n  VOIDED = 'VOIDED',\n  CHARGEDBACK = 'CHARGEDBACK',\n}\n\n/** @enumType */\nexport type InvoiceStatusWithLiterals =\n  | InvoiceStatus\n  | 'UNKNOWN_INVOICE_STATUS'\n  | 'PAYMENT_FAILED'\n  | 'PAID'\n  | 'REFUNDED'\n  | 'VOIDED'\n  | 'CHARGEDBACK';\n\nexport interface GetUrlRequest {\n  /**\n   * ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n   * for a list of your app's supported product IDs.\n   */\n  productId: string;\n  /**\n   * URL for the Wix checkout page. Redirect site owners to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\nexport interface ChargeOverride {\n  /**\n   * Override price. In case you omit the override price, Wix charges site\n   * owners the app's default price that's configured in the Pricing page of your app's dashboard.\n   */\n  price?: number;\n  /**\n   * Override 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n}\n\nexport interface GetUrlResponse {\n  /**\n   * URL for the Wix checkout page.\n   * @format WEB_URL\n   */\n  checkoutUrl?: string;\n  /**\n   * Token for the Wix checkout page. The token holds all data about the order\n   * you're creating a checkout for.  It is [signed](),\n   * so you can verify that it comes from Wix.\n   */\n  token?: string | null;\n}\n\nexport interface GetPurchaseHistoryRequest {}\n\nexport interface GetPurchaseHistoryResponse {\n  /** Retrieved purchases the site owners have completed for you app. */\n  purchases?: PurchasedItem[];\n}\n\nexport interface GetSitePaymentMethodsStatusRequest {}\n\nexport interface GetSitePaymentMethodsStatusResponse {\n  /**\n   * Whether the site owners have enabled at least a single online payment method.\n   * Online payment methods include Wix Payments, Stripe, PayPal, and credit\n   * cards.\n   */\n  onlineProviderEnabled?: boolean;\n  /** Whether the site owners accept offline payments. */\n  offlineProviderEnabled?: boolean;\n  /**\n   * Whether the site owners have enabled the\n   * [Wix Point of Sale](https://www.wix.com/pos).\n   * This allows their customers to make electronic payments in person.\n   */\n  wixPosProviderEnabled?: boolean;\n  /**\n   * Whether the site owners have enabled at least one 3rd-party point-of-sale\n   * provider. This allows their customers to make electronic payments in person.\n   */\n  thirdPartyPosProviderEnabled?: boolean;\n}\n\nexport interface GetMeteredBillingChargesRequest {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n\nexport interface GetMeteredBillingChargesResponse {\n  /** List of retrieved custom charges. */\n  charges?: Charge[];\n}\n\nexport interface Charge {\n  /** ID of the custom charge. The ID consists of 64 characters. */\n  _id?: string | null;\n  /** Description of the custom charge. */\n  description?: string;\n  /**\n   * Charge amount.\n   *\n   * Min: `0.50`\n   * @format DECIMAL_VALUE\n   * @decimalValue options { gt:0.00 }\n   */\n  amount?: string;\n}\n\nexport interface MessageEnvelope {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n  /** Stringify payload. */\n  data?: string;\n}\n\nexport interface IdentificationData extends IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n  /** @readonly */\n  identityType?: WebhookIdentityTypeWithLiterals;\n}\n\n/** @oneof */\nexport interface IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n}\n\nexport enum WebhookIdentityType {\n  UNKNOWN = 'UNKNOWN',\n  ANONYMOUS_VISITOR = 'ANONYMOUS_VISITOR',\n  MEMBER = 'MEMBER',\n  WIX_USER = 'WIX_USER',\n  APP = 'APP',\n}\n\n/** @enumType */\nexport type WebhookIdentityTypeWithLiterals =\n  | WebhookIdentityType\n  | 'UNKNOWN'\n  | 'ANONYMOUS_VISITOR'\n  | 'MEMBER'\n  | 'WIX_USER'\n  | 'APP';\n\nexport interface BaseEventMetadata {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n}\n\nexport interface PurchasedItemInvoiceStatusUpdatedEnvelope {\n  data: InvoiceStatusUpdated;\n  metadata: BaseEventMetadata;\n}\n\n/**\n * Triggered when there is an update to the payment status of an invoice.\n * Charges made using the [Custom Charges SPI](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.\n * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).\n * @permissionScope Manage Your App\n * @permissionScopeId SCOPE.DC.MANAGE-YOUR-APP\n * @permissionScope Read site, business, and email details\n * @permissionScopeId SCOPE.DEV_CENTER.APP-INSTANCE-READ-BASIC-INFO\n * @permissionId WIX_DEVELOPERS.MANAGE_APP_INSTANCE\n * @webhook\n * @eventType InvoiceStatusUpdated\n * @serviceIdentifier com.wixpress.market.aim.api.Checkout\n * @slug invoice_status_updated\n */\nexport declare function onPurchasedItemInvoiceStatusUpdated(\n  handler: (\n    event: PurchasedItemInvoiceStatusUpdatedEnvelope\n  ) => void | Promise<void>\n): void;\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n *\n * This call succeeds only in case you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n * @param productId - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n * for a list of your app's supported product IDs.\n * @public\n * @requiredField productId\n * @permissionId WIX_DEVELOPERS.CREATE_CHECKOUT\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetUrl\n */\nexport async function getUrl(\n  productId: string,\n  options?: GetUrlOptions\n): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[2] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    productId: productId,\n    successUrl: options?.successUrl,\n    testCheckout: options?.testCheckout,\n    billingCycle: options?.billingCycle,\n    countryCode: options?.countryCode,\n    languageCode: options?.languageCode,\n    couponCode: options?.couponCode,\n  });\n\n  const reqOpts = ambassadorWixDevcenterCheckoutV1PurchasedItem.getUrl(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          productId: '$[0]',\n          successUrl: '$[1].successUrl',\n          testCheckout: '$[1].testCheckout',\n          billingCycle: '$[1].billingCycle',\n          countryCode: '$[1].countryCode',\n          languageCode: '$[1].languageCode',\n          couponCode: '$[1].couponCode',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['productId', 'options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetUrlOptions {\n  /**\n   * URL for the Wix checkout page. Redirect site owners to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\n/**\n * Retrieves a list of the site owner's past purchases for your app.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n * @public\n * @permissionId WIX_DEVELOPERS.APP_PURCHASE_HISTORY\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetPurchaseHistory\n */\nexport async function getPurchaseHistory(): Promise<\n  NonNullablePaths<\n    GetPurchaseHistoryResponse,\n    | `purchases`\n    | `purchases.${number}.productId`\n    | `purchases.${number}.price`\n    | `purchases.${number}.currency`\n    | `purchases.${number}.billingCycle`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[0] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({});\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getPurchaseHistory(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {},\n        singleArgumentUnchanged: false,\n      },\n      []\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n * @internal\n * @documentationMaturity preview\n * @permissionId WIX_DEVELOPERS.METERED_BILLING_CHARGES_READ\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges\n */\nexport async function getMeteredBillingCharges(\n  options?: GetMeteredBillingChargesOptions\n): Promise<\n  NonNullablePaths<\n    GetMeteredBillingChargesResponse,\n    `charges` | `charges.${number}.description` | `charges.${number}.amount`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[1] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    currency: options?.currency,\n    startDate: options?.startDate,\n    endDate: options?.endDate,\n  });\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getMeteredBillingCharges(\n      payload\n    );\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          currency: '$[0].currency',\n          startDate: '$[0].startDate',\n          endDate: '$[0].endDate',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetMeteredBillingChargesOptions {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n","import { toURLSearchParams } from '@wix/sdk-runtime/rest-modules';\nimport { transformSDKFloatToRESTFloat } from '@wix/sdk-runtime/transformations/float';\nimport { transformSDKTimestampToRESTTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformRESTTimestampToSDKTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformPaths } from '@wix/sdk-runtime/transformations/transform-paths';\nimport { resolveUrl } from '@wix/sdk-runtime/rest-modules';\nimport { ResolveUrlOpts } from '@wix/sdk-runtime/rest-modules';\nimport { RequestOptionsFactory } from '@wix/sdk-types';\n\nfunction resolveComWixpressMarketAimApiCheckoutUrl(\n  opts: Omit<ResolveUrlOpts, 'domainToMappings'>\n) {\n  const domainToMappings = {\n    'api._api_base_domain_': [\n      {\n        srcPath: '/app-instance-manager-webapp',\n        destPath: '',\n      },\n    ],\n    'www.wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'dev._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n      {\n        srcPath: '/api/v1/instance',\n        destPath: '/v1/instance',\n      },\n      {\n        srcPath: '/api/v1/scripts',\n        destPath: '/v1/scripts',\n      },\n    ],\n    'manage._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'www._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'editor._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'blocks._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'create.editorx': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    '*.dev.wix-code.com': [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n    _: [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n  };\n\n  return resolveUrl(Object.assign(opts, { domainToMappings }));\n}\n\nconst PACKAGE_NAME = '@wix/auto_sdk_app-management_billing';\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n *\n * This call succeeds only in case you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n */\nexport function getUrl(payload: object): RequestOptionsFactory<any> {\n  function __getUrl({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKFloatToRESTFloat,\n        paths: [{ path: 'chargeOverride.price' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'POST' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetUrl',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout',\n        data: serializedData,\n        host,\n      }),\n      data: serializedData,\n    };\n\n    return metadata;\n  }\n\n  return __getUrl;\n}\n\n/**\n * Retrieves a list of the site owner's past purchases for your app.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n */\nexport function getPurchaseHistory(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getPurchaseHistory({ host }: any) {\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetPurchaseHistory',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout/history',\n        data: payload,\n        host,\n      }),\n      params: toURLSearchParams(payload),\n      transformResponse: (payload: any) =>\n        transformPaths(payload, [\n          {\n            transformFn: transformRESTTimestampToSDKTimestamp,\n            paths: [{ path: 'purchases.dateCreated' }],\n          },\n        ]),\n    };\n\n    return metadata;\n  }\n\n  return __getPurchaseHistory;\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n */\nexport function getMeteredBillingCharges(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getMeteredBillingCharges({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKTimestampToRESTTimestamp,\n        paths: [{ path: 'startDate' }, { path: 'endDate' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn:\n        'com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/metered-billing-charges',\n        data: serializedData,\n        host,\n      }),\n      params: toURLSearchParams(serializedData),\n    };\n\n    return metadata;\n  }\n\n  return __getMeteredBillingCharges;\n}\n","import {\n  getUrl as publicGetUrl,\n  getPurchaseHistory as publicGetPurchaseHistory,\n  getMeteredBillingCharges as publicGetMeteredBillingCharges,\n} from './devcenter-checkout-v1-purchased-item-billing.public.js';\nimport { createRESTModule } from '@wix/sdk-runtime/rest-modules';\nimport { createEventModule } from '@wix/sdk-runtime/event-definition-modules';\nimport {\n  BuildRESTFunction,\n  MaybeContext,\n  BuildEventDefinition,\n} from '@wix/sdk-types';\nimport { onPurchasedItemInvoiceStatusUpdated as publicOnPurchasedItemInvoiceStatusUpdated } from './devcenter-checkout-v1-purchased-item-billing.public.js';\n\nexport const getUrl: MaybeContext<\n  BuildRESTFunction<typeof publicGetUrl> & typeof publicGetUrl\n> = /*#__PURE__*/ createRESTModule(publicGetUrl);\nexport const getPurchaseHistory: MaybeContext<\n  BuildRESTFunction<typeof publicGetPurchaseHistory> &\n    typeof publicGetPurchaseHistory\n> = /*#__PURE__*/ createRESTModule(publicGetPurchaseHistory);\n/** @internal */\nexport const getMeteredBillingCharges: MaybeContext<\n  BuildRESTFunction<typeof publicGetMeteredBillingCharges> &\n    typeof publicGetMeteredBillingCharges\n> = /*#__PURE__*/ createRESTModule(publicGetMeteredBillingCharges);\n/**\n * Triggered when there is an update to the payment status of an invoice.\n * Charges made using the [Custom Charges SPI](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.\n * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).\n */\nexport const onPurchasedItemInvoiceStatusUpdated: BuildEventDefinition<\n  typeof publicOnPurchasedItemInvoiceStatusUpdated\n> &\n  typeof publicOnPurchasedItemInvoiceStatusUpdated = createEventModule(\n  publicOnPurchasedItemInvoiceStatusUpdated\n);\n\nexport {\n  PaymentCycle,\n  InvoiceStatus,\n  WebhookIdentityType,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\nexport {\n  PurchasedItem,\n  InvoiceStatusUpdated,\n  GetUrlRequest,\n  ChargeOverride,\n  GetUrlResponse,\n  GetPurchaseHistoryRequest,\n  GetPurchaseHistoryResponse,\n  GetSitePaymentMethodsStatusRequest,\n  GetSitePaymentMethodsStatusResponse,\n  GetMeteredBillingChargesRequest,\n  GetMeteredBillingChargesResponse,\n  Charge,\n  MessageEnvelope,\n  IdentificationData,\n  IdentificationDataIdOneOf,\n  BaseEventMetadata,\n  PurchasedItemInvoiceStatusUpdatedEnvelope,\n  GetUrlOptions,\n  GetMeteredBillingChargesOptions,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\nexport {\n  PaymentCycleWithLiterals,\n  InvoiceStatusWithLiterals,\n  WebhookIdentityTypeWithLiterals,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\n"],"mappings":"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","names":["getMeteredBillingCharges","getPurchaseHistory","getUrl","onPurchasedItemInvoiceStatusUpdated","import_rename_all_nested_keys","import_timestamp","import_rest_modules","payload","PaymentCycle","InvoiceStatus","WebhookIdentityType","getUrl","sdkTransformError","getPurchaseHistory","getMeteredBillingCharges","getUrl","getPurchaseHistory","getMeteredBillingCharges","import_rest_modules","getUrl","getPurchaseHistory","getMeteredBillingCharges","onPurchasedItemInvoiceStatusUpdated"]}
+{"version":3,"sources":["../../index.ts","../../src/devcenter-checkout-v1-purchased-item-billing.public.ts","../../src/devcenter-checkout-v1-purchased-item-billing.universal.ts","../../src/devcenter-checkout-v1-purchased-item-billing.http.ts","../../src/devcenter-checkout-v1-purchased-item-billing.context.ts"],"sourcesContent":["export * from './src/devcenter-checkout-v1-purchased-item-billing.context.js';\n","import { renameKeysFromRESTResponseToSDKResponse } from '@wix/sdk-runtime/rename-all-nested-keys';\nimport { EventDefinition, HttpClient, NonNullablePaths } from '@wix/sdk-types';\nimport {\n  GetMeteredBillingChargesOptions,\n  GetMeteredBillingChargesResponse,\n  GetPurchaseHistoryResponse,\n  GetUrlOptions,\n  GetUrlResponse,\n  PurchasedItemInvoiceStatusUpdatedEnvelope,\n  getMeteredBillingCharges as universalGetMeteredBillingCharges,\n  getPurchaseHistory as universalGetPurchaseHistory,\n  getUrl as universalGetUrl,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\n\nexport const __metadata = { PACKAGE_NAME: '@wix/app-management' };\n\nexport function getUrl(httpClient: HttpClient): GetUrlSignature {\n  return (productId: string, options?: GetUrlOptions) =>\n    universalGetUrl(\n      productId,\n      options,\n      // @ts-ignore\n      { httpClient }\n    );\n}\n\ninterface GetUrlSignature {\n  /**\n   * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n   *\n   * Call this method when initiating the purchase flow from your pricing page.\n   * The returned checkout URL redirects to Wix to complete payment.\n   *\n   * This call succeeds only if you have previously\n   * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n   *\n   * The returned checkout URL is valid for 48 hours.\n   *\n   * This API allows your app to manage your pricing page outside of Wix while\n   * still using the standard Wix checkout flow.\n   * @param - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n   * for a list of your app's supported product IDs.\n   */\n  (productId: string, options?: GetUrlOptions): Promise<\n    NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>\n  >;\n}\n\nexport function getPurchaseHistory(\n  httpClient: HttpClient\n): GetPurchaseHistorySignature {\n  return () =>\n    universalGetPurchaseHistory(\n      // @ts-ignore\n      { httpClient }\n    );\n}\n\ninterface GetPurchaseHistorySignature {\n  /**\n   * Retrieves a list of past purchases for your app on this site.\n   *\n   *\n   * You don't have to explicitly pass an identifier for the Wix site as part of\n   * the request, since this information is taken automatically from the context.\n   *\n   * The response doesn't include any details about cancellations.\n   */\n  (): Promise<\n    NonNullablePaths<\n      GetPurchaseHistoryResponse,\n      | `purchases`\n      | `purchases.${number}.productId`\n      | `purchases.${number}.price`\n      | `purchases.${number}.currency`\n      | `purchases.${number}.billingCycle`,\n      4\n    >\n  >;\n}\n\n/** @internal */\nexport function getMeteredBillingCharges(\n  httpClient: HttpClient\n): GetMeteredBillingChargesSignature {\n  return (options?: GetMeteredBillingChargesOptions) =>\n    universalGetMeteredBillingCharges(\n      options,\n      // @ts-ignore\n      { httpClient }\n    );\n}\n\ninterface GetMeteredBillingChargesSignature {\n  /**\n   * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n   *\n   * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n   *\n   * > **Important:**\n   * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n   */\n  (options?: GetMeteredBillingChargesOptions): Promise<\n    NonNullablePaths<\n      GetMeteredBillingChargesResponse,\n      `charges` | `charges.${number}.description` | `charges.${number}.amount`,\n      4\n    >\n  >;\n}\n\nexport const onPurchasedItemInvoiceStatusUpdated = EventDefinition(\n  'InvoiceStatusUpdated',\n  false,\n  (event: PurchasedItemInvoiceStatusUpdatedEnvelope) =>\n    renameKeysFromRESTResponseToSDKResponse(event)\n)<PurchasedItemInvoiceStatusUpdatedEnvelope>();\n\nexport {\n  BaseEventMetadata,\n  Charge,\n  ChargeOverride,\n  GetMeteredBillingChargesOptions,\n  GetMeteredBillingChargesRequest,\n  GetMeteredBillingChargesResponse,\n  GetPurchaseHistoryRequest,\n  GetPurchaseHistoryResponse,\n  GetSitePaymentMethodsStatusRequest,\n  GetSitePaymentMethodsStatusResponse,\n  GetUrlOptions,\n  GetUrlRequest,\n  GetUrlResponse,\n  IdentificationData,\n  IdentificationDataIdOneOf,\n  InvoiceStatus,\n  InvoiceStatusUpdated,\n  MessageEnvelope,\n  PaymentCycle,\n  PurchasedItem,\n  PurchasedItemInvoiceStatusUpdatedEnvelope,\n  WebhookIdentityType,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\n","import { transformError as sdkTransformError } from '@wix/sdk-runtime/transform-error';\nimport {\n  renameKeysFromSDKRequestToRESTRequest,\n  renameKeysFromRESTResponseToSDKResponse,\n} from '@wix/sdk-runtime/rename-all-nested-keys';\nimport { HttpClient, NonNullablePaths } from '@wix/sdk-types';\nimport * as ambassadorWixDevcenterCheckoutV1PurchasedItem from './devcenter-checkout-v1-purchased-item-billing.http.js';\n\nexport interface PurchasedItem {\n  /** ID of your app's paid plan. */\n  productId?: string;\n  /** Price of your app's paid plan. For example, `9.95`. */\n  price?: string;\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n  /** Information about the billing cycle for your app's paid plan. */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * Date and time the site purchased your app's paid plan in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  dateCreated?: Date | null;\n}\n\nexport enum PaymentCycle {\n  NO_CYCLE = 'NO_CYCLE',\n  MONTHLY = 'MONTHLY',\n  YEARLY = 'YEARLY',\n  ONE_TIME = 'ONE_TIME',\n  TWO_YEARS = 'TWO_YEARS',\n  THREE_YEARS = 'THREE_YEARS',\n  FOUR_YEARS = 'FOUR_YEARS',\n  FIVE_YEARS = 'FIVE_YEARS',\n}\n\n/** @enumType */\nexport type PaymentCycleWithLiterals =\n  | PaymentCycle\n  | 'NO_CYCLE'\n  | 'MONTHLY'\n  | 'YEARLY'\n  | 'ONE_TIME'\n  | 'TWO_YEARS'\n  | 'THREE_YEARS'\n  | 'FOUR_YEARS'\n  | 'FIVE_YEARS';\n\nexport interface InvoiceStatusUpdated {\n  /** Invoice payment status. */\n  status?: InvoiceStatusWithLiterals;\n  /**\n   * Wix Premium invoice ID.\n   * @maxLength 50\n   */\n  invoiceId?: string;\n  /**\n   * App instance ID - a unique ID assigned to each app in each site.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /** Whether the invoice is for a single payment or for multiple, recurring payments. */\n  recurring?: boolean;\n}\n\nexport enum InvoiceStatus {\n  UNKNOWN_INVOICE_STATUS = 'UNKNOWN_INVOICE_STATUS',\n  PAYMENT_FAILED = 'PAYMENT_FAILED',\n  PAID = 'PAID',\n  REFUNDED = 'REFUNDED',\n  VOIDED = 'VOIDED',\n  CHARGEDBACK = 'CHARGEDBACK',\n}\n\n/** @enumType */\nexport type InvoiceStatusWithLiterals =\n  | InvoiceStatus\n  | 'UNKNOWN_INVOICE_STATUS'\n  | 'PAYMENT_FAILED'\n  | 'PAID'\n  | 'REFUNDED'\n  | 'VOIDED'\n  | 'CHARGEDBACK';\n\nexport interface GetUrlRequest {\n  /**\n   * ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n   * for a list of your app's supported product IDs.\n   */\n  productId: string;\n  /**\n   * URL for the Wix checkout page. Redirect Wix users to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\nexport interface ChargeOverride {\n  /**\n   * Override price. If you omit the override price, the default price\n   * configured in the **Pricing** page of your app's dashboard is used.\n   */\n  price?: number;\n  /**\n   * Override 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n}\n\nexport interface GetUrlResponse {\n  /**\n   * URL for the Wix checkout page.\n   * @format WEB_URL\n   */\n  checkoutUrl?: string;\n  /**\n   * Token for the Wix checkout page. The token holds all data about the order\n   * you're creating a checkout for. It's [signed](https://dev.wix.com/docs/api-reference/articles),\n   * so you can verify that it comes from Wix.\n   */\n  token?: string | null;\n}\n\nexport interface GetPurchaseHistoryRequest {}\n\nexport interface GetPurchaseHistoryResponse {\n  /** Retrieved purchases the Wix user has completed for you app. */\n  purchases?: PurchasedItem[];\n}\n\nexport interface GetSitePaymentMethodsStatusRequest {}\n\nexport interface GetSitePaymentMethodsStatusResponse {\n  /**\n   * Whether at least 1 online payment method is enabled for the site.\n   * Online payment methods include Wix Payments, Stripe, PayPal, and credit\n   * cards.\n   */\n  onlineProviderEnabled?: boolean;\n  /** Whether the site accepts offline payments. */\n  offlineProviderEnabled?: boolean;\n  /**\n   * Whether [Wix Point of Sale](https://www.wix.com/pos) is enabled for the site.\n   * This allows electronic payments to be made in person.\n   */\n  wixPosProviderEnabled?: boolean;\n  /**\n   * Whether the site has enabled at least 1 3rd-party point-of-sale\n   * provider. This allows electronic payments to be made in person.\n   */\n  thirdPartyPosProviderEnabled?: boolean;\n}\n\nexport interface GetMeteredBillingChargesRequest {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n\nexport interface GetMeteredBillingChargesResponse {\n  /** List of retrieved custom charges. */\n  charges?: Charge[];\n}\n\nexport interface Charge {\n  /** ID of the custom charge. The ID consists of 64 characters. */\n  _id?: string | null;\n  /** Description of the custom charge. */\n  description?: string;\n  /**\n   * Charge amount.\n   *\n   * Min: `0.50`\n   * @format DECIMAL_VALUE\n   * @decimalValue options { gt:0.00 }\n   */\n  amount?: string;\n}\n\nexport interface MessageEnvelope {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n  /** Stringify payload. */\n  data?: string;\n}\n\nexport interface IdentificationData extends IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n  /** @readonly */\n  identityType?: WebhookIdentityTypeWithLiterals;\n}\n\n/** @oneof */\nexport interface IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n}\n\nexport enum WebhookIdentityType {\n  UNKNOWN = 'UNKNOWN',\n  ANONYMOUS_VISITOR = 'ANONYMOUS_VISITOR',\n  MEMBER = 'MEMBER',\n  WIX_USER = 'WIX_USER',\n  APP = 'APP',\n}\n\n/** @enumType */\nexport type WebhookIdentityTypeWithLiterals =\n  | WebhookIdentityType\n  | 'UNKNOWN'\n  | 'ANONYMOUS_VISITOR'\n  | 'MEMBER'\n  | 'WIX_USER'\n  | 'APP';\n\nexport interface BaseEventMetadata {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n}\n\nexport interface PurchasedItemInvoiceStatusUpdatedEnvelope {\n  data: InvoiceStatusUpdated;\n  metadata: BaseEventMetadata;\n}\n\n/**\n * Triggered when there is an update to the payment status of an invoice.\n * Charges made using the [Custom Charges service plugin](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.\n * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).\n * @permissionScope Manage Your App\n * @permissionScopeId SCOPE.DC.MANAGE-YOUR-APP\n * @permissionScope Read site, business, and email details\n * @permissionScopeId SCOPE.DEV_CENTER.APP-INSTANCE-READ-BASIC-INFO\n * @permissionId WIX_DEVELOPERS.MANAGE_APP_INSTANCE\n * @webhook\n * @eventType InvoiceStatusUpdated\n * @serviceIdentifier com.wixpress.market.aim.api.Checkout\n * @slug invoice_status_updated\n */\nexport declare function onPurchasedItemInvoiceStatusUpdated(\n  handler: (\n    event: PurchasedItemInvoiceStatusUpdatedEnvelope\n  ) => void | Promise<void>\n): void;\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n * Call this method when initiating the purchase flow from your pricing page.\n * The returned checkout URL redirects to Wix to complete payment.\n *\n * This call succeeds only if you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n * @param productId - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n * for a list of your app's supported product IDs.\n * @public\n * @requiredField productId\n * @permissionId WIX_DEVELOPERS.CREATE_CHECKOUT\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetUrl\n */\nexport async function getUrl(\n  productId: string,\n  options?: GetUrlOptions\n): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[2] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    productId: productId,\n    successUrl: options?.successUrl,\n    testCheckout: options?.testCheckout,\n    billingCycle: options?.billingCycle,\n    countryCode: options?.countryCode,\n    languageCode: options?.languageCode,\n    couponCode: options?.couponCode,\n  });\n\n  const reqOpts = ambassadorWixDevcenterCheckoutV1PurchasedItem.getUrl(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          productId: '$[0]',\n          successUrl: '$[1].successUrl',\n          testCheckout: '$[1].testCheckout',\n          billingCycle: '$[1].billingCycle',\n          countryCode: '$[1].countryCode',\n          languageCode: '$[1].languageCode',\n          couponCode: '$[1].couponCode',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['productId', 'options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetUrlOptions {\n  /**\n   * URL for the Wix checkout page. Redirect Wix users to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\n/**\n * Retrieves a list of past purchases for your app on this site.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n * @public\n * @permissionId WIX_DEVELOPERS.APP_PURCHASE_HISTORY\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetPurchaseHistory\n */\nexport async function getPurchaseHistory(): Promise<\n  NonNullablePaths<\n    GetPurchaseHistoryResponse,\n    | `purchases`\n    | `purchases.${number}.productId`\n    | `purchases.${number}.price`\n    | `purchases.${number}.currency`\n    | `purchases.${number}.billingCycle`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[0] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({});\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getPurchaseHistory(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {},\n        singleArgumentUnchanged: false,\n      },\n      []\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n * @internal\n * @documentationMaturity preview\n * @permissionId WIX_DEVELOPERS.METERED_BILLING_CHARGES_READ\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges\n */\nexport async function getMeteredBillingCharges(\n  options?: GetMeteredBillingChargesOptions\n): Promise<\n  NonNullablePaths<\n    GetMeteredBillingChargesResponse,\n    `charges` | `charges.${number}.description` | `charges.${number}.amount`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[1] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    currency: options?.currency,\n    startDate: options?.startDate,\n    endDate: options?.endDate,\n  });\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getMeteredBillingCharges(\n      payload\n    );\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          currency: '$[0].currency',\n          startDate: '$[0].startDate',\n          endDate: '$[0].endDate',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetMeteredBillingChargesOptions {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n","import { toURLSearchParams } from '@wix/sdk-runtime/rest-modules';\nimport { transformSDKFloatToRESTFloat } from '@wix/sdk-runtime/transformations/float';\nimport { transformSDKTimestampToRESTTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformRESTTimestampToSDKTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformPaths } from '@wix/sdk-runtime/transformations/transform-paths';\nimport { resolveUrl } from '@wix/sdk-runtime/rest-modules';\nimport { ResolveUrlOpts } from '@wix/sdk-runtime/rest-modules';\nimport { RequestOptionsFactory } from '@wix/sdk-types';\n\nfunction resolveComWixpressMarketAimApiCheckoutUrl(\n  opts: Omit<ResolveUrlOpts, 'domainToMappings'>\n) {\n  const domainToMappings = {\n    'api._api_base_domain_': [\n      {\n        srcPath: '/app-instance-manager-webapp',\n        destPath: '',\n      },\n    ],\n    'www.wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'dev._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n      {\n        srcPath: '/api/v1/instance',\n        destPath: '/v1/instance',\n      },\n      {\n        srcPath: '/api/v1/scripts',\n        destPath: '/v1/scripts',\n      },\n    ],\n    'manage._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'www._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'editor._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'blocks._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'create.editorx': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    '*.dev.wix-code.com': [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n    _: [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n  };\n\n  return resolveUrl(Object.assign(opts, { domainToMappings }));\n}\n\nconst PACKAGE_NAME = '@wix/auto_sdk_app-management_billing';\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n * Call this method when initiating the purchase flow from your pricing page.\n * The returned checkout URL redirects to Wix to complete payment.\n *\n * This call succeeds only if you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n */\nexport function getUrl(payload: object): RequestOptionsFactory<any> {\n  function __getUrl({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKFloatToRESTFloat,\n        paths: [{ path: 'chargeOverride.price' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'POST' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetUrl',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout',\n        data: serializedData,\n        host,\n      }),\n      data: serializedData,\n    };\n\n    return metadata;\n  }\n\n  return __getUrl;\n}\n\n/**\n * Retrieves a list of past purchases for your app on this site.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n */\nexport function getPurchaseHistory(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getPurchaseHistory({ host }: any) {\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetPurchaseHistory',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout/history',\n        data: payload,\n        host,\n      }),\n      params: toURLSearchParams(payload),\n      transformResponse: (payload: any) =>\n        transformPaths(payload, [\n          {\n            transformFn: transformRESTTimestampToSDKTimestamp,\n            paths: [{ path: 'purchases.dateCreated' }],\n          },\n        ]),\n    };\n\n    return metadata;\n  }\n\n  return __getPurchaseHistory;\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n */\nexport function getMeteredBillingCharges(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getMeteredBillingCharges({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKTimestampToRESTTimestamp,\n        paths: [{ path: 'startDate' }, { path: 'endDate' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn:\n        'com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/metered-billing-charges',\n        data: serializedData,\n        host,\n      }),\n      params: toURLSearchParams(serializedData),\n    };\n\n    return metadata;\n  }\n\n  return __getMeteredBillingCharges;\n}\n","import {\n  getUrl as publicGetUrl,\n  getPurchaseHistory as publicGetPurchaseHistory,\n  getMeteredBillingCharges as publicGetMeteredBillingCharges,\n} from './devcenter-checkout-v1-purchased-item-billing.public.js';\nimport { createRESTModule } from '@wix/sdk-runtime/rest-modules';\nimport { createEventModule } from '@wix/sdk-runtime/event-definition-modules';\nimport {\n  BuildRESTFunction,\n  MaybeContext,\n  BuildEventDefinition,\n} from '@wix/sdk-types';\nimport { onPurchasedItemInvoiceStatusUpdated as publicOnPurchasedItemInvoiceStatusUpdated } from './devcenter-checkout-v1-purchased-item-billing.public.js';\n\nexport const getUrl: MaybeContext<\n  BuildRESTFunction<typeof publicGetUrl> & typeof publicGetUrl\n> = /*#__PURE__*/ createRESTModule(publicGetUrl);\nexport const getPurchaseHistory: MaybeContext<\n  BuildRESTFunction<typeof publicGetPurchaseHistory> &\n    typeof publicGetPurchaseHistory\n> = /*#__PURE__*/ createRESTModule(publicGetPurchaseHistory);\n/** @internal */\nexport const getMeteredBillingCharges: MaybeContext<\n  BuildRESTFunction<typeof publicGetMeteredBillingCharges> &\n    typeof publicGetMeteredBillingCharges\n> = /*#__PURE__*/ createRESTModule(publicGetMeteredBillingCharges);\n/**\n * Triggered when there is an update to the payment status of an invoice.\n * Charges made using the [Custom Charges service plugin](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.\n * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).\n */\nexport const onPurchasedItemInvoiceStatusUpdated: BuildEventDefinition<\n  typeof publicOnPurchasedItemInvoiceStatusUpdated\n> &\n  typeof publicOnPurchasedItemInvoiceStatusUpdated = createEventModule(\n  publicOnPurchasedItemInvoiceStatusUpdated\n);\n\nexport {\n  PaymentCycle,\n  InvoiceStatus,\n  WebhookIdentityType,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\nexport {\n  PurchasedItem,\n  InvoiceStatusUpdated,\n  GetUrlRequest,\n  ChargeOverride,\n  GetUrlResponse,\n  GetPurchaseHistoryRequest,\n  GetPurchaseHistoryResponse,\n  GetSitePaymentMethodsStatusRequest,\n  GetSitePaymentMethodsStatusResponse,\n  GetMeteredBillingChargesRequest,\n  GetMeteredBillingChargesResponse,\n  Charge,\n  MessageEnvelope,\n  IdentificationData,\n  IdentificationDataIdOneOf,\n  BaseEventMetadata,\n  PurchasedItemInvoiceStatusUpdatedEnvelope,\n  GetUrlOptions,\n  GetMeteredBillingChargesOptions,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\nexport {\n  PaymentCycleWithLiterals,\n  InvoiceStatusWithLiterals,\n  WebhookIdentityTypeWithLiterals,\n} from './devcenter-checkout-v1-purchased-item-billing.universal.js';\n"],"mappings":"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","names":["getMeteredBillingCharges","getPurchaseHistory","getUrl","onPurchasedItemInvoiceStatusUpdated","import_rename_all_nested_keys","import_timestamp","import_rest_modules","payload","PaymentCycle","InvoiceStatus","WebhookIdentityType","getUrl","sdkTransformError","getPurchaseHistory","getMeteredBillingCharges","getUrl","getPurchaseHistory","getMeteredBillingCharges","import_rest_modules","getUrl","getPurchaseHistory","getMeteredBillingCharges","onPurchasedItemInvoiceStatusUpdated"]}

package/build/cjs/index.typings.d.ts

@@ -13,7 +13,7 @@ interface PurchasedItem {
     /** Information about the billing cycle for your app's paid plan. */
     billingCycle?: PaymentCycleWithLiterals;
     /**
-     * Date and time the site onwers have purchased your app's paid plan in
+     * Date and time the site purchased your app's paid plan in
      * `YYYY-MM-DDThh:mm:ss.sssZ` format.
      */
     dateCreated?: Date | null;
@@ -63,7 +63,7 @@ interface GetUrlRequest {
      */
     productId: string;
     /**
-     * URL for the Wix checkout page. Redirect site owners to this URL after
+     * URL for the Wix checkout page. Redirect Wix users to this URL after
      * they've successfully purchased a paid plan for your app.
      * @format WEB_URL
      */
@@ -102,8 +102,8 @@ interface GetUrlRequest {
 }
 interface ChargeOverride {
     /**
-     * Override price. In case you omit the override price, Wix charges site
-     * owners the app's default price that's configured in the Pricing page of your app's dashboard.
+     * Override price. If you omit the override price, the default price
+     * configured in the **Pricing** page of your app's dashboard is used.
      */
     price?: number;
     /**
@@ -120,7 +120,7 @@ interface GetUrlResponse {
     checkoutUrl?: string;
     /**
      * Token for the Wix checkout page. The token holds all data about the order
-     * you're creating a checkout for.  It is [signed](),
+     * you're creating a checkout for. It's [signed](https://dev.wix.com/docs/api-reference/articles),
      * so you can verify that it comes from Wix.
      */
     token?: string | null;
@@ -128,29 +128,28 @@ interface GetUrlResponse {
 interface GetPurchaseHistoryRequest {
 }
 interface GetPurchaseHistoryResponse {
-    /** Retrieved purchases the site owners have completed for you app. */
+    /** Retrieved purchases the Wix user has completed for you app. */
     purchases?: PurchasedItem[];
 }
 interface GetSitePaymentMethodsStatusRequest {
 }
 interface GetSitePaymentMethodsStatusResponse {
     /**
-     * Whether the site owners have enabled at least a single online payment method.
+     * Whether at least 1 online payment method is enabled for the site.
      * Online payment methods include Wix Payments, Stripe, PayPal, and credit
      * cards.
      */
     onlineProviderEnabled?: boolean;
-    /** Whether the site owners accept offline payments. */
+    /** Whether the site accepts offline payments. */
     offlineProviderEnabled?: boolean;
     /**
-     * Whether the site owners have enabled the
-     * [Wix Point of Sale](https://www.wix.com/pos).
-     * This allows their customers to make electronic payments in person.
+     * Whether [Wix Point of Sale](https://www.wix.com/pos) is enabled for the site.
+     * This allows electronic payments to be made in person.
      */
     wixPosProviderEnabled?: boolean;
     /**
-     * Whether the site owners have enabled at least one 3rd-party point-of-sale
-     * provider. This allows their customers to make electronic payments in person.
+     * Whether the site has enabled at least 1 3rd-party point-of-sale
+     * provider. This allows electronic payments to be made in person.
      */
     thirdPartyPosProviderEnabled?: boolean;
 }
@@ -282,7 +281,7 @@ interface PurchasedItemInvoiceStatusUpdatedEnvelope {
 }
 /**
  * Triggered when there is an update to the payment status of an invoice.
- * Charges made using the [Custom Charges SPI](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.
+ * Charges made using the [Custom Charges service plugin](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.
  * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).
  * @permissionScope Manage Your App
  * @permissionScopeId SCOPE.DC.MANAGE-YOUR-APP
@@ -298,8 +297,10 @@ declare function onPurchasedItemInvoiceStatusUpdated(handler: (event: PurchasedI
 /**
  * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.
  *
+ * Call this method when initiating the purchase flow from your pricing page.
+ * The returned checkout URL redirects to Wix to complete payment.
  *
- * This call succeeds only in case you have previously
+ * This call succeeds only if you have previously
  * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).
  *
  * The returned checkout URL is valid for 48 hours.
@@ -317,7 +318,7 @@ declare function onPurchasedItemInvoiceStatusUpdated(handler: (event: PurchasedI
 declare function getUrl(productId: string, options?: GetUrlOptions): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>>;
 interface GetUrlOptions {
     /**
-     * URL for the Wix checkout page. Redirect site owners to this URL after
+     * URL for the Wix checkout page. Redirect Wix users to this URL after
      * they've successfully purchased a paid plan for your app.
      * @format WEB_URL
      */
@@ -355,7 +356,7 @@ interface GetUrlOptions {
     couponCode?: string | null;
 }
 /**
- * Retrieves a list of the site owner's past purchases for your app.
+ * Retrieves a list of past purchases for your app on this site.
  *
  *
  * You don't have to explicitly pass an identifier for the Wix site as part of

package/build/cjs/index.typings.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../index.typings.ts","../../src/devcenter-checkout-v1-purchased-item-billing.universal.ts","../../src/devcenter-checkout-v1-purchased-item-billing.http.ts"],"sourcesContent":["export * from './src/devcenter-checkout-v1-purchased-item-billing.universal.js';\n","import { transformError as sdkTransformError } from '@wix/sdk-runtime/transform-error';\nimport {\n  renameKeysFromSDKRequestToRESTRequest,\n  renameKeysFromRESTResponseToSDKResponse,\n} from '@wix/sdk-runtime/rename-all-nested-keys';\nimport { HttpClient, NonNullablePaths } from '@wix/sdk-types';\nimport * as ambassadorWixDevcenterCheckoutV1PurchasedItem from './devcenter-checkout-v1-purchased-item-billing.http.js';\n\nexport interface PurchasedItem {\n  /** ID of your app's paid plan. */\n  productId?: string;\n  /** Price of your app's paid plan. For example, `9.95`. */\n  price?: string;\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n  /** Information about the billing cycle for your app's paid plan. */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * Date and time the site onwers have purchased your app's paid plan in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  dateCreated?: Date | null;\n}\n\nexport enum PaymentCycle {\n  NO_CYCLE = 'NO_CYCLE',\n  MONTHLY = 'MONTHLY',\n  YEARLY = 'YEARLY',\n  ONE_TIME = 'ONE_TIME',\n  TWO_YEARS = 'TWO_YEARS',\n  THREE_YEARS = 'THREE_YEARS',\n  FOUR_YEARS = 'FOUR_YEARS',\n  FIVE_YEARS = 'FIVE_YEARS',\n}\n\n/** @enumType */\nexport type PaymentCycleWithLiterals =\n  | PaymentCycle\n  | 'NO_CYCLE'\n  | 'MONTHLY'\n  | 'YEARLY'\n  | 'ONE_TIME'\n  | 'TWO_YEARS'\n  | 'THREE_YEARS'\n  | 'FOUR_YEARS'\n  | 'FIVE_YEARS';\n\nexport interface InvoiceStatusUpdated {\n  /** Invoice payment status. */\n  status?: InvoiceStatusWithLiterals;\n  /**\n   * Wix Premium invoice ID.\n   * @maxLength 50\n   */\n  invoiceId?: string;\n  /**\n   * App instance ID - a unique ID assigned to each app in each site.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /** Whether the invoice is for a single payment or for multiple, recurring payments. */\n  recurring?: boolean;\n}\n\nexport enum InvoiceStatus {\n  UNKNOWN_INVOICE_STATUS = 'UNKNOWN_INVOICE_STATUS',\n  PAYMENT_FAILED = 'PAYMENT_FAILED',\n  PAID = 'PAID',\n  REFUNDED = 'REFUNDED',\n  VOIDED = 'VOIDED',\n  CHARGEDBACK = 'CHARGEDBACK',\n}\n\n/** @enumType */\nexport type InvoiceStatusWithLiterals =\n  | InvoiceStatus\n  | 'UNKNOWN_INVOICE_STATUS'\n  | 'PAYMENT_FAILED'\n  | 'PAID'\n  | 'REFUNDED'\n  | 'VOIDED'\n  | 'CHARGEDBACK';\n\nexport interface GetUrlRequest {\n  /**\n   * ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n   * for a list of your app's supported product IDs.\n   */\n  productId: string;\n  /**\n   * URL for the Wix checkout page. Redirect site owners to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\nexport interface ChargeOverride {\n  /**\n   * Override price. In case you omit the override price, Wix charges site\n   * owners the app's default price that's configured in the Pricing page of your app's dashboard.\n   */\n  price?: number;\n  /**\n   * Override 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n}\n\nexport interface GetUrlResponse {\n  /**\n   * URL for the Wix checkout page.\n   * @format WEB_URL\n   */\n  checkoutUrl?: string;\n  /**\n   * Token for the Wix checkout page. The token holds all data about the order\n   * you're creating a checkout for.  It is [signed](),\n   * so you can verify that it comes from Wix.\n   */\n  token?: string | null;\n}\n\nexport interface GetPurchaseHistoryRequest {}\n\nexport interface GetPurchaseHistoryResponse {\n  /** Retrieved purchases the site owners have completed for you app. */\n  purchases?: PurchasedItem[];\n}\n\nexport interface GetSitePaymentMethodsStatusRequest {}\n\nexport interface GetSitePaymentMethodsStatusResponse {\n  /**\n   * Whether the site owners have enabled at least a single online payment method.\n   * Online payment methods include Wix Payments, Stripe, PayPal, and credit\n   * cards.\n   */\n  onlineProviderEnabled?: boolean;\n  /** Whether the site owners accept offline payments. */\n  offlineProviderEnabled?: boolean;\n  /**\n   * Whether the site owners have enabled the\n   * [Wix Point of Sale](https://www.wix.com/pos).\n   * This allows their customers to make electronic payments in person.\n   */\n  wixPosProviderEnabled?: boolean;\n  /**\n   * Whether the site owners have enabled at least one 3rd-party point-of-sale\n   * provider. This allows their customers to make electronic payments in person.\n   */\n  thirdPartyPosProviderEnabled?: boolean;\n}\n\nexport interface GetMeteredBillingChargesRequest {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n\nexport interface GetMeteredBillingChargesResponse {\n  /** List of retrieved custom charges. */\n  charges?: Charge[];\n}\n\nexport interface Charge {\n  /** ID of the custom charge. The ID consists of 64 characters. */\n  _id?: string | null;\n  /** Description of the custom charge. */\n  description?: string;\n  /**\n   * Charge amount.\n   *\n   * Min: `0.50`\n   * @format DECIMAL_VALUE\n   * @decimalValue options { gt:0.00 }\n   */\n  amount?: string;\n}\n\nexport interface MessageEnvelope {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n  /** Stringify payload. */\n  data?: string;\n}\n\nexport interface IdentificationData extends IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n  /** @readonly */\n  identityType?: WebhookIdentityTypeWithLiterals;\n}\n\n/** @oneof */\nexport interface IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n}\n\nexport enum WebhookIdentityType {\n  UNKNOWN = 'UNKNOWN',\n  ANONYMOUS_VISITOR = 'ANONYMOUS_VISITOR',\n  MEMBER = 'MEMBER',\n  WIX_USER = 'WIX_USER',\n  APP = 'APP',\n}\n\n/** @enumType */\nexport type WebhookIdentityTypeWithLiterals =\n  | WebhookIdentityType\n  | 'UNKNOWN'\n  | 'ANONYMOUS_VISITOR'\n  | 'MEMBER'\n  | 'WIX_USER'\n  | 'APP';\n\nexport interface BaseEventMetadata {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n}\n\nexport interface PurchasedItemInvoiceStatusUpdatedEnvelope {\n  data: InvoiceStatusUpdated;\n  metadata: BaseEventMetadata;\n}\n\n/**\n * Triggered when there is an update to the payment status of an invoice.\n * Charges made using the [Custom Charges SPI](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.\n * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).\n * @permissionScope Manage Your App\n * @permissionScopeId SCOPE.DC.MANAGE-YOUR-APP\n * @permissionScope Read site, business, and email details\n * @permissionScopeId SCOPE.DEV_CENTER.APP-INSTANCE-READ-BASIC-INFO\n * @permissionId WIX_DEVELOPERS.MANAGE_APP_INSTANCE\n * @webhook\n * @eventType InvoiceStatusUpdated\n * @serviceIdentifier com.wixpress.market.aim.api.Checkout\n * @slug invoice_status_updated\n */\nexport declare function onPurchasedItemInvoiceStatusUpdated(\n  handler: (\n    event: PurchasedItemInvoiceStatusUpdatedEnvelope\n  ) => void | Promise<void>\n): void;\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n *\n * This call succeeds only in case you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n * @param productId - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n * for a list of your app's supported product IDs.\n * @public\n * @requiredField productId\n * @permissionId WIX_DEVELOPERS.CREATE_CHECKOUT\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetUrl\n */\nexport async function getUrl(\n  productId: string,\n  options?: GetUrlOptions\n): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[2] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    productId: productId,\n    successUrl: options?.successUrl,\n    testCheckout: options?.testCheckout,\n    billingCycle: options?.billingCycle,\n    countryCode: options?.countryCode,\n    languageCode: options?.languageCode,\n    couponCode: options?.couponCode,\n  });\n\n  const reqOpts = ambassadorWixDevcenterCheckoutV1PurchasedItem.getUrl(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          productId: '$[0]',\n          successUrl: '$[1].successUrl',\n          testCheckout: '$[1].testCheckout',\n          billingCycle: '$[1].billingCycle',\n          countryCode: '$[1].countryCode',\n          languageCode: '$[1].languageCode',\n          couponCode: '$[1].couponCode',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['productId', 'options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetUrlOptions {\n  /**\n   * URL for the Wix checkout page. Redirect site owners to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\n/**\n * Retrieves a list of the site owner's past purchases for your app.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n * @public\n * @permissionId WIX_DEVELOPERS.APP_PURCHASE_HISTORY\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetPurchaseHistory\n */\nexport async function getPurchaseHistory(): Promise<\n  NonNullablePaths<\n    GetPurchaseHistoryResponse,\n    | `purchases`\n    | `purchases.${number}.productId`\n    | `purchases.${number}.price`\n    | `purchases.${number}.currency`\n    | `purchases.${number}.billingCycle`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[0] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({});\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getPurchaseHistory(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {},\n        singleArgumentUnchanged: false,\n      },\n      []\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n * @internal\n * @documentationMaturity preview\n * @permissionId WIX_DEVELOPERS.METERED_BILLING_CHARGES_READ\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges\n */\nexport async function getMeteredBillingCharges(\n  options?: GetMeteredBillingChargesOptions\n): Promise<\n  NonNullablePaths<\n    GetMeteredBillingChargesResponse,\n    `charges` | `charges.${number}.description` | `charges.${number}.amount`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[1] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    currency: options?.currency,\n    startDate: options?.startDate,\n    endDate: options?.endDate,\n  });\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getMeteredBillingCharges(\n      payload\n    );\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          currency: '$[0].currency',\n          startDate: '$[0].startDate',\n          endDate: '$[0].endDate',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetMeteredBillingChargesOptions {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n","import { toURLSearchParams } from '@wix/sdk-runtime/rest-modules';\nimport { transformSDKFloatToRESTFloat } from '@wix/sdk-runtime/transformations/float';\nimport { transformSDKTimestampToRESTTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformRESTTimestampToSDKTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformPaths } from '@wix/sdk-runtime/transformations/transform-paths';\nimport { resolveUrl } from '@wix/sdk-runtime/rest-modules';\nimport { ResolveUrlOpts } from '@wix/sdk-runtime/rest-modules';\nimport { RequestOptionsFactory } from '@wix/sdk-types';\n\nfunction resolveComWixpressMarketAimApiCheckoutUrl(\n  opts: Omit<ResolveUrlOpts, 'domainToMappings'>\n) {\n  const domainToMappings = {\n    'api._api_base_domain_': [\n      {\n        srcPath: '/app-instance-manager-webapp',\n        destPath: '',\n      },\n    ],\n    'www.wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'dev._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n      {\n        srcPath: '/api/v1/instance',\n        destPath: '/v1/instance',\n      },\n      {\n        srcPath: '/api/v1/scripts',\n        destPath: '/v1/scripts',\n      },\n    ],\n    'manage._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'www._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'editor._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'blocks._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'create.editorx': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    '*.dev.wix-code.com': [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n    _: [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n  };\n\n  return resolveUrl(Object.assign(opts, { domainToMappings }));\n}\n\nconst PACKAGE_NAME = '@wix/auto_sdk_app-management_billing';\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n *\n * This call succeeds only in case you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n */\nexport function getUrl(payload: object): RequestOptionsFactory<any> {\n  function __getUrl({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKFloatToRESTFloat,\n        paths: [{ path: 'chargeOverride.price' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'POST' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetUrl',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout',\n        data: serializedData,\n        host,\n      }),\n      data: serializedData,\n    };\n\n    return metadata;\n  }\n\n  return __getUrl;\n}\n\n/**\n * Retrieves a list of the site owner's past purchases for your app.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n */\nexport function getPurchaseHistory(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getPurchaseHistory({ host }: any) {\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetPurchaseHistory',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout/history',\n        data: payload,\n        host,\n      }),\n      params: toURLSearchParams(payload),\n      transformResponse: (payload: any) =>\n        transformPaths(payload, [\n          {\n            transformFn: transformRESTTimestampToSDKTimestamp,\n            paths: [{ path: 'purchases.dateCreated' }],\n          },\n        ]),\n    };\n\n    return metadata;\n  }\n\n  return __getPurchaseHistory;\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n */\nexport function getMeteredBillingCharges(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getMeteredBillingCharges({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKTimestampToRESTTimestamp,\n        paths: [{ path: 'startDate' }, { path: 'endDate' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn:\n        'com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/metered-billing-charges',\n        data: serializedData,\n        host,\n      }),\n      params: toURLSearchParams(serializedData),\n    };\n\n    return metadata;\n  }\n\n  return __getMeteredBillingCharges;\n}\n"],"mappings":"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","names":["getMeteredBillingCharges","getPurchaseHistory","getUrl","import_timestamp","import_rest_modules","payload","PaymentCycle","InvoiceStatus","WebhookIdentityType","getUrl","sdkTransformError","getPurchaseHistory","getMeteredBillingCharges"]}
+{"version":3,"sources":["../../index.typings.ts","../../src/devcenter-checkout-v1-purchased-item-billing.universal.ts","../../src/devcenter-checkout-v1-purchased-item-billing.http.ts"],"sourcesContent":["export * from './src/devcenter-checkout-v1-purchased-item-billing.universal.js';\n","import { transformError as sdkTransformError } from '@wix/sdk-runtime/transform-error';\nimport {\n  renameKeysFromSDKRequestToRESTRequest,\n  renameKeysFromRESTResponseToSDKResponse,\n} from '@wix/sdk-runtime/rename-all-nested-keys';\nimport { HttpClient, NonNullablePaths } from '@wix/sdk-types';\nimport * as ambassadorWixDevcenterCheckoutV1PurchasedItem from './devcenter-checkout-v1-purchased-item-billing.http.js';\n\nexport interface PurchasedItem {\n  /** ID of your app's paid plan. */\n  productId?: string;\n  /** Price of your app's paid plan. For example, `9.95`. */\n  price?: string;\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n  /** Information about the billing cycle for your app's paid plan. */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * Date and time the site purchased your app's paid plan in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  dateCreated?: Date | null;\n}\n\nexport enum PaymentCycle {\n  NO_CYCLE = 'NO_CYCLE',\n  MONTHLY = 'MONTHLY',\n  YEARLY = 'YEARLY',\n  ONE_TIME = 'ONE_TIME',\n  TWO_YEARS = 'TWO_YEARS',\n  THREE_YEARS = 'THREE_YEARS',\n  FOUR_YEARS = 'FOUR_YEARS',\n  FIVE_YEARS = 'FIVE_YEARS',\n}\n\n/** @enumType */\nexport type PaymentCycleWithLiterals =\n  | PaymentCycle\n  | 'NO_CYCLE'\n  | 'MONTHLY'\n  | 'YEARLY'\n  | 'ONE_TIME'\n  | 'TWO_YEARS'\n  | 'THREE_YEARS'\n  | 'FOUR_YEARS'\n  | 'FIVE_YEARS';\n\nexport interface InvoiceStatusUpdated {\n  /** Invoice payment status. */\n  status?: InvoiceStatusWithLiterals;\n  /**\n   * Wix Premium invoice ID.\n   * @maxLength 50\n   */\n  invoiceId?: string;\n  /**\n   * App instance ID - a unique ID assigned to each app in each site.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /** Whether the invoice is for a single payment or for multiple, recurring payments. */\n  recurring?: boolean;\n}\n\nexport enum InvoiceStatus {\n  UNKNOWN_INVOICE_STATUS = 'UNKNOWN_INVOICE_STATUS',\n  PAYMENT_FAILED = 'PAYMENT_FAILED',\n  PAID = 'PAID',\n  REFUNDED = 'REFUNDED',\n  VOIDED = 'VOIDED',\n  CHARGEDBACK = 'CHARGEDBACK',\n}\n\n/** @enumType */\nexport type InvoiceStatusWithLiterals =\n  | InvoiceStatus\n  | 'UNKNOWN_INVOICE_STATUS'\n  | 'PAYMENT_FAILED'\n  | 'PAID'\n  | 'REFUNDED'\n  | 'VOIDED'\n  | 'CHARGEDBACK';\n\nexport interface GetUrlRequest {\n  /**\n   * ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n   * for a list of your app's supported product IDs.\n   */\n  productId: string;\n  /**\n   * URL for the Wix checkout page. Redirect Wix users to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\nexport interface ChargeOverride {\n  /**\n   * Override price. If you omit the override price, the default price\n   * configured in the **Pricing** page of your app's dashboard is used.\n   */\n  price?: number;\n  /**\n   * Override 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   */\n  currency?: string;\n}\n\nexport interface GetUrlResponse {\n  /**\n   * URL for the Wix checkout page.\n   * @format WEB_URL\n   */\n  checkoutUrl?: string;\n  /**\n   * Token for the Wix checkout page. The token holds all data about the order\n   * you're creating a checkout for. It's [signed](https://dev.wix.com/docs/api-reference/articles),\n   * so you can verify that it comes from Wix.\n   */\n  token?: string | null;\n}\n\nexport interface GetPurchaseHistoryRequest {}\n\nexport interface GetPurchaseHistoryResponse {\n  /** Retrieved purchases the Wix user has completed for you app. */\n  purchases?: PurchasedItem[];\n}\n\nexport interface GetSitePaymentMethodsStatusRequest {}\n\nexport interface GetSitePaymentMethodsStatusResponse {\n  /**\n   * Whether at least 1 online payment method is enabled for the site.\n   * Online payment methods include Wix Payments, Stripe, PayPal, and credit\n   * cards.\n   */\n  onlineProviderEnabled?: boolean;\n  /** Whether the site accepts offline payments. */\n  offlineProviderEnabled?: boolean;\n  /**\n   * Whether [Wix Point of Sale](https://www.wix.com/pos) is enabled for the site.\n   * This allows electronic payments to be made in person.\n   */\n  wixPosProviderEnabled?: boolean;\n  /**\n   * Whether the site has enabled at least 1 3rd-party point-of-sale\n   * provider. This allows electronic payments to be made in person.\n   */\n  thirdPartyPosProviderEnabled?: boolean;\n}\n\nexport interface GetMeteredBillingChargesRequest {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n\nexport interface GetMeteredBillingChargesResponse {\n  /** List of retrieved custom charges. */\n  charges?: Charge[];\n}\n\nexport interface Charge {\n  /** ID of the custom charge. The ID consists of 64 characters. */\n  _id?: string | null;\n  /** Description of the custom charge. */\n  description?: string;\n  /**\n   * Charge amount.\n   *\n   * Min: `0.50`\n   * @format DECIMAL_VALUE\n   * @decimalValue options { gt:0.00 }\n   */\n  amount?: string;\n}\n\nexport interface MessageEnvelope {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n  /** Stringify payload. */\n  data?: string;\n}\n\nexport interface IdentificationData extends IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n  /** @readonly */\n  identityType?: WebhookIdentityTypeWithLiterals;\n}\n\n/** @oneof */\nexport interface IdentificationDataIdOneOf {\n  /**\n   * ID of a site visitor that has not logged in to the site.\n   * @format GUID\n   */\n  anonymousVisitorId?: string;\n  /**\n   * ID of a site visitor that has logged in to the site.\n   * @format GUID\n   */\n  memberId?: string;\n  /**\n   * ID of a Wix user (site owner, contributor, etc.).\n   * @format GUID\n   */\n  wixUserId?: string;\n  /**\n   * ID of an app.\n   * @format GUID\n   */\n  appId?: string;\n}\n\nexport enum WebhookIdentityType {\n  UNKNOWN = 'UNKNOWN',\n  ANONYMOUS_VISITOR = 'ANONYMOUS_VISITOR',\n  MEMBER = 'MEMBER',\n  WIX_USER = 'WIX_USER',\n  APP = 'APP',\n}\n\n/** @enumType */\nexport type WebhookIdentityTypeWithLiterals =\n  | WebhookIdentityType\n  | 'UNKNOWN'\n  | 'ANONYMOUS_VISITOR'\n  | 'MEMBER'\n  | 'WIX_USER'\n  | 'APP';\n\nexport interface BaseEventMetadata {\n  /**\n   * App instance ID.\n   * @format GUID\n   */\n  instanceId?: string | null;\n  /**\n   * Event type.\n   * @maxLength 150\n   */\n  eventType?: string;\n  /** The identification type and identity data. */\n  identity?: IdentificationData;\n}\n\nexport interface PurchasedItemInvoiceStatusUpdatedEnvelope {\n  data: InvoiceStatusUpdated;\n  metadata: BaseEventMetadata;\n}\n\n/**\n * Triggered when there is an update to the payment status of an invoice.\n * Charges made using the [Custom Charges service plugin](https://dev.wix.com/docs/rest/app-management/app-billing/custom-charges-service-plugin/introduction) may be based on usage.\n * Learn more about [usage-based charges](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model).\n * @permissionScope Manage Your App\n * @permissionScopeId SCOPE.DC.MANAGE-YOUR-APP\n * @permissionScope Read site, business, and email details\n * @permissionScopeId SCOPE.DEV_CENTER.APP-INSTANCE-READ-BASIC-INFO\n * @permissionId WIX_DEVELOPERS.MANAGE_APP_INSTANCE\n * @webhook\n * @eventType InvoiceStatusUpdated\n * @serviceIdentifier com.wixpress.market.aim.api.Checkout\n * @slug invoice_status_updated\n */\nexport declare function onPurchasedItemInvoiceStatusUpdated(\n  handler: (\n    event: PurchasedItemInvoiceStatusUpdatedEnvelope\n  ) => void | Promise<void>\n): void;\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n * Call this method when initiating the purchase flow from your pricing page.\n * The returned checkout URL redirects to Wix to complete payment.\n *\n * This call succeeds only if you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n * @param productId - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard\n * for a list of your app's supported product IDs.\n * @public\n * @requiredField productId\n * @permissionId WIX_DEVELOPERS.CREATE_CHECKOUT\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetUrl\n */\nexport async function getUrl(\n  productId: string,\n  options?: GetUrlOptions\n): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`, 2>> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[2] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    productId: productId,\n    successUrl: options?.successUrl,\n    testCheckout: options?.testCheckout,\n    billingCycle: options?.billingCycle,\n    countryCode: options?.countryCode,\n    languageCode: options?.languageCode,\n    couponCode: options?.couponCode,\n  });\n\n  const reqOpts = ambassadorWixDevcenterCheckoutV1PurchasedItem.getUrl(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          productId: '$[0]',\n          successUrl: '$[1].successUrl',\n          testCheckout: '$[1].testCheckout',\n          billingCycle: '$[1].billingCycle',\n          countryCode: '$[1].countryCode',\n          languageCode: '$[1].languageCode',\n          couponCode: '$[1].couponCode',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['productId', 'options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetUrlOptions {\n  /**\n   * URL for the Wix checkout page. Redirect Wix users to this URL after\n   * they've successfully purchased a paid plan for your app.\n   * @format WEB_URL\n   */\n  successUrl?: string | null;\n  /**\n   * Whether the checkout is for testing purposes only. Testing is mainly\n   * relevant for in-app purchase flows. When `true`, Wix charges the site\n   * owners an amount of `0.00`.\n   *\n   * Not supported for usage-based plans.\n   */\n  testCheckout?: boolean;\n  /**\n   * Information about the paid plan's billing cycle.\n   *\n   * Set to `MONTHLY` for usage-based plans.\n   */\n  billingCycle?: PaymentCycleWithLiterals;\n  /**\n   * 2-letter country code in\n   * [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)\n   * format.\n   *\n   * Default: `\"US\"`\n   */\n  countryCode?: string | null;\n  /**\n   * 2-letter language code in\n   * [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.\n   *\n   * Default: `\"EN\"`\n   */\n  languageCode?: string | null;\n  /** Coupon code for the paid plan. Available only in case there is a discount. */\n  couponCode?: string | null;\n}\n\n/**\n * Retrieves a list of past purchases for your app on this site.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n * @public\n * @permissionId WIX_DEVELOPERS.APP_PURCHASE_HISTORY\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetPurchaseHistory\n */\nexport async function getPurchaseHistory(): Promise<\n  NonNullablePaths<\n    GetPurchaseHistoryResponse,\n    | `purchases`\n    | `purchases.${number}.productId`\n    | `purchases.${number}.price`\n    | `purchases.${number}.currency`\n    | `purchases.${number}.billingCycle`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[0] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({});\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getPurchaseHistory(payload);\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {},\n        singleArgumentUnchanged: false,\n      },\n      []\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n * @internal\n * @documentationMaturity preview\n * @permissionId WIX_DEVELOPERS.METERED_BILLING_CHARGES_READ\n * @applicableIdentity APP\n * @fqn com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges\n */\nexport async function getMeteredBillingCharges(\n  options?: GetMeteredBillingChargesOptions\n): Promise<\n  NonNullablePaths<\n    GetMeteredBillingChargesResponse,\n    `charges` | `charges.${number}.description` | `charges.${number}.amount`,\n    4\n  >\n> {\n  // @ts-ignore\n  const { httpClient, sideEffects } = arguments[1] as {\n    httpClient: HttpClient;\n    sideEffects?: any;\n  };\n\n  const payload = renameKeysFromSDKRequestToRESTRequest({\n    currency: options?.currency,\n    startDate: options?.startDate,\n    endDate: options?.endDate,\n  });\n\n  const reqOpts =\n    ambassadorWixDevcenterCheckoutV1PurchasedItem.getMeteredBillingCharges(\n      payload\n    );\n\n  sideEffects?.onSiteCall?.();\n  try {\n    const result = await httpClient.request(reqOpts);\n    sideEffects?.onSuccess?.(result);\n\n    return renameKeysFromRESTResponseToSDKResponse(result.data)!;\n  } catch (err: any) {\n    const transformedError = sdkTransformError(\n      err,\n      {\n        spreadPathsToArguments: {},\n        explicitPathsToArguments: {\n          currency: '$[0].currency',\n          startDate: '$[0].startDate',\n          endDate: '$[0].endDate',\n        },\n        singleArgumentUnchanged: false,\n      },\n      ['options']\n    );\n    sideEffects?.onError?.(err);\n\n    throw transformedError;\n  }\n}\n\nexport interface GetMeteredBillingChargesOptions {\n  /**\n   * 3-letter currency code in\n   * [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.\n   * @format CURRENCY\n   */\n  currency?: string | null;\n  /**\n   * Start of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  startDate?: Date | null;\n  /**\n   * End of the period you want to retrieve the custom charges for in\n   * `YYYY-MM-DDThh:mm:ss.sssZ` format.\n   */\n  endDate?: Date | null;\n}\n","import { toURLSearchParams } from '@wix/sdk-runtime/rest-modules';\nimport { transformSDKFloatToRESTFloat } from '@wix/sdk-runtime/transformations/float';\nimport { transformSDKTimestampToRESTTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformRESTTimestampToSDKTimestamp } from '@wix/sdk-runtime/transformations/timestamp';\nimport { transformPaths } from '@wix/sdk-runtime/transformations/transform-paths';\nimport { resolveUrl } from '@wix/sdk-runtime/rest-modules';\nimport { ResolveUrlOpts } from '@wix/sdk-runtime/rest-modules';\nimport { RequestOptionsFactory } from '@wix/sdk-types';\n\nfunction resolveComWixpressMarketAimApiCheckoutUrl(\n  opts: Omit<ResolveUrlOpts, 'domainToMappings'>\n) {\n  const domainToMappings = {\n    'api._api_base_domain_': [\n      {\n        srcPath: '/app-instance-manager-webapp',\n        destPath: '',\n      },\n    ],\n    'www.wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'wixapis.com': [\n      {\n        srcPath: '/apps',\n        destPath: '',\n      },\n    ],\n    'dev._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n      {\n        srcPath: '/api/v1/instance',\n        destPath: '/v1/instance',\n      },\n      {\n        srcPath: '/api/v1/scripts',\n        destPath: '/v1/scripts',\n      },\n    ],\n    'manage._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'www._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'editor._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'blocks._base_domain_': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    'create.editorx': [\n      {\n        srcPath: '/_api/app-instance-manager',\n        destPath: '',\n      },\n    ],\n    '*.dev.wix-code.com': [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n    _: [\n      {\n        srcPath: '/devcenter/app-instance/v1/instance',\n        destPath: '/v1/instance',\n      },\n    ],\n  };\n\n  return resolveUrl(Object.assign(opts, { domainToMappings }));\n}\n\nconst PACKAGE_NAME = '@wix/auto_sdk_app-management_billing';\n\n/**\n * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.\n *\n * Call this method when initiating the purchase flow from your pricing page.\n * The returned checkout URL redirects to Wix to complete payment.\n *\n * This call succeeds only if you have previously\n * [set up an external pricing page in your app's dashboard](https://dev.wix.com/docs/build-apps/build-your-app/pricing-plans/set-up-an-external-pricing-page).\n *\n * The returned checkout URL is valid for 48 hours.\n *\n * This API allows your app to manage your pricing page outside of Wix while\n * still using the standard Wix checkout flow.\n */\nexport function getUrl(payload: object): RequestOptionsFactory<any> {\n  function __getUrl({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKFloatToRESTFloat,\n        paths: [{ path: 'chargeOverride.price' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'POST' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetUrl',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout',\n        data: serializedData,\n        host,\n      }),\n      data: serializedData,\n    };\n\n    return metadata;\n  }\n\n  return __getUrl;\n}\n\n/**\n * Retrieves a list of past purchases for your app on this site.\n *\n *\n * You don't have to explicitly pass an identifier for the Wix site as part of\n * the request, since this information is taken automatically from the context.\n *\n * The response doesn't include any details about cancellations.\n */\nexport function getPurchaseHistory(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getPurchaseHistory({ host }: any) {\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn: 'com.wixpress.market.aim.api.Checkout.GetPurchaseHistory',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/checkout/history',\n        data: payload,\n        host,\n      }),\n      params: toURLSearchParams(payload),\n      transformResponse: (payload: any) =>\n        transformPaths(payload, [\n          {\n            transformFn: transformRESTTimestampToSDKTimestamp,\n            paths: [{ path: 'purchases.dateCreated' }],\n          },\n        ]),\n    };\n\n    return metadata;\n  }\n\n  return __getPurchaseHistory;\n}\n\n/**\n * Retrieves a preview of charges for a site's [usage-based billing](https://dev.wix.com/docs/build-apps/launch-your-app/pricing-and-billing/set-up-a-usage-based-business-model#set-up-a-usage-based-business-model).\n *\n * When you call this method, Wix triggers your app's [List Custom Charges service plugin](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges) and returns the charges you provide. Use this method to verify that your service plugin is working correctly and returning the expected charges.\n *\n * > **Important:**\n * > This method only retrieves charge information for testing purposes. It doesn't create an invoice or charge the customer. Wix creates actual invoices by calling your List Custom Charges service plugin directly.\n */\nexport function getMeteredBillingCharges(\n  payload: object\n): RequestOptionsFactory<any> {\n  function __getMeteredBillingCharges({ host }: any) {\n    const serializedData = transformPaths(payload, [\n      {\n        transformFn: transformSDKTimestampToRESTTimestamp,\n        paths: [{ path: 'startDate' }, { path: 'endDate' }],\n      },\n    ]);\n    const metadata = {\n      entityFqdn: 'wix.devcenter.checkout.v1.purchased_item',\n      method: 'GET' as any,\n      methodFqn:\n        'com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges',\n      packageName: PACKAGE_NAME,\n      migrationOptions: {\n        optInTransformResponse: true,\n      },\n      url: resolveComWixpressMarketAimApiCheckoutUrl({\n        protoPath: '/v1/metered-billing-charges',\n        data: serializedData,\n        host,\n      }),\n      params: toURLSearchParams(serializedData),\n    };\n\n    return metadata;\n  }\n\n  return __getMeteredBillingCharges;\n}\n"],"mappings":"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","names":["getMeteredBillingCharges","getPurchaseHistory","getUrl","import_timestamp","import_rest_modules","payload","PaymentCycle","InvoiceStatus","WebhookIdentityType","getUrl","sdkTransformError","getPurchaseHistory","getMeteredBillingCharges"]}

package/build/cjs/meta.d.ts

@@ -14,7 +14,7 @@ interface PurchasedItem {
     /** Information about the billing cycle for your app's paid plan. */
     billingCycle?: PaymentCycleWithLiterals;
     /**
-     * Date and time the site onwers have purchased your app's paid plan in
+     * Date and time the site purchased your app's paid plan in
      * `YYYY-MM-DDThh:mm:ss.sssZ` format.
      */
     dateCreated?: Date | null;
@@ -64,7 +64,7 @@ interface GetUrlRequest {
      */
     productId: string;
     /**
-     * URL for the Wix checkout page. Redirect site owners to this URL after
+     * URL for the Wix checkout page. Redirect Wix users to this URL after
      * they've successfully purchased a paid plan for your app.
      * @format WEB_URL
      */
@@ -103,8 +103,8 @@ interface GetUrlRequest {
 }
 interface ChargeOverride {
     /**
-     * Override price. In case you omit the override price, Wix charges site
-     * owners the app's default price that's configured in the Pricing page of your app's dashboard.
+     * Override price. If you omit the override price, the default price
+     * configured in the **Pricing** page of your app's dashboard is used.
      */
     price?: number;
     /**
@@ -121,7 +121,7 @@ interface GetUrlResponse {
     checkoutUrl?: string;
     /**
      * Token for the Wix checkout page. The token holds all data about the order
-     * you're creating a checkout for.  It is [signed](),
+     * you're creating a checkout for. It's [signed](https://dev.wix.com/docs/api-reference/articles),
      * so you can verify that it comes from Wix.
      */
     token?: string | null;
@@ -129,29 +129,28 @@ interface GetUrlResponse {
 interface GetPurchaseHistoryRequest {
 }
 interface GetPurchaseHistoryResponse {
-    /** Retrieved purchases the site owners have completed for you app. */
+    /** Retrieved purchases the Wix user has completed for you app. */
     purchases?: PurchasedItem[];
 }
 interface GetSitePaymentMethodsStatusRequest {
 }
 interface GetSitePaymentMethodsStatusResponse {
     /**
-     * Whether the site owners have enabled at least a single online payment method.
+     * Whether at least 1 online payment method is enabled for the site.
      * Online payment methods include Wix Payments, Stripe, PayPal, and credit
      * cards.
      */
     onlineProviderEnabled?: boolean;
-    /** Whether the site owners accept offline payments. */
+    /** Whether the site accepts offline payments. */
     offlineProviderEnabled?: boolean;
     /**
-     * Whether the site owners have enabled the
-     * [Wix Point of Sale](https://www.wix.com/pos).
-     * This allows their customers to make electronic payments in person.
+     * Whether [Wix Point of Sale](https://www.wix.com/pos) is enabled for the site.
+     * This allows electronic payments to be made in person.
      */
     wixPosProviderEnabled?: boolean;
     /**
-     * Whether the site owners have enabled at least one 3rd-party point-of-sale
-     * provider. This allows their customers to make electronic payments in person.
+     * Whether the site has enabled at least 1 3rd-party point-of-sale
+     * provider. This allows electronic payments to be made in person.
      */
     thirdPartyPosProviderEnabled?: boolean;
 }