@wix/auto_sdk_app-management_billing 1.0.18 → 1.0.20

package/build/cjs/index.d.ts

@@ -1,7 +1,8 @@
-import { HttpClient, EventDefinition, MaybeContext, BuildRESTFunction, BuildEventDefinition } from '@wix/sdk-types';
-import { G as GetUrlOptions, a as GetUrlResponse, b as GetPurchaseHistoryResponse, P as PurchasedItemInvoiceStatusUpdatedEnvelope } from './devcenter-checkout-v1-purchased-item-billing.universal-BOJl75V0.js';
-export { B as BaseEventMetadata, l as Charge, C as ChargeOverride, o as GetMeteredBillingChargesOptions, j as GetMeteredBillingChargesRequest, k as GetMeteredBillingChargesResponse, g as GetPurchaseHistoryRequest, h as GetSitePaymentMethodsStatusRequest, i as GetSitePaymentMethodsStatusResponse, f as GetUrlRequest, m as IdentificationData, n as IdentificationDataIdOneOf, I as InvoiceStatus, e as InvoiceStatusUpdated, M as MessageEnvelope, c as PaymentCycle, d as PurchasedItem, W as WebhookIdentityType } from './devcenter-checkout-v1-purchased-item-billing.universal-BOJl75V0.js';
+import { HttpClient, NonNullablePaths, EventDefinition, MaybeContext, BuildRESTFunction, BuildEventDefinition } from '@wix/sdk-types';
+import { GetUrlOptions, GetUrlResponse, GetPurchaseHistoryResponse, PurchasedItemInvoiceStatusUpdatedEnvelope } from './index.typings.js';
+export { BaseEventMetadata, Charge, ChargeOverride, GetMeteredBillingChargesOptions, GetMeteredBillingChargesRequest, GetMeteredBillingChargesResponse, GetPurchaseHistoryRequest, GetSitePaymentMethodsStatusRequest, GetSitePaymentMethodsStatusResponse, GetUrlRequest, IdentificationData, IdentificationDataIdOneOf, InvoiceStatus, InvoiceStatusUpdated, MessageEnvelope, PaymentCycle, PurchasedItem, WebhookIdentityType } from './index.typings.js';
 
+type PurchasedItemNonNullablePaths = `productId` | `price` | `currency` | `billingCycle`;
 declare function getUrl$1(httpClient: HttpClient): GetUrlSignature;
 interface GetUrlSignature {
     /**
@@ -18,7 +19,7 @@ interface GetUrlSignature {
      * @param - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard
      * for a list of your app's supported product IDs.
      */
-    (productId: string, options?: GetUrlOptions | undefined): Promise<GetUrlResponse>;
+    (productId: string, options?: GetUrlOptions): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`>>;
 }
 declare function getPurchaseHistory$1(httpClient: HttpClient): GetPurchaseHistorySignature;
 interface GetPurchaseHistorySignature {
@@ -31,7 +32,9 @@ interface GetPurchaseHistorySignature {
      *
      * The response doesn't include any details about cancellations.
      */
-    (): Promise<GetPurchaseHistoryResponse>;
+    (): Promise<NonNullablePaths<GetPurchaseHistoryResponse, {
+        [P in PurchasedItemNonNullablePaths]: `purchases.${number}.${P}`;
+    }[PurchasedItemNonNullablePaths]>>;
 }
 declare const onPurchasedItemInvoiceStatusUpdated$1: EventDefinition<PurchasedItemInvoiceStatusUpdatedEnvelope, "InvoiceStatusUpdated">;
 

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 } 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  (\n    productId: string,\n    options?: GetUrlOptions | undefined\n  ): Promise<GetUrlResponse>;\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<GetPurchaseHistoryResponse>;\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   * Triggers Wix to call the\n   * [List Custom Charges SPI](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges).\n   *\n   *\n   * Wix doesn't use the response from _List Charges_ SPI to actually create an\n   * invoice that's sent to the customer. Instead, calling _Get Metered Billing Charges_\n   * allows you confirm that your integration with the Custom Charges SPI is\n   * working as intended.\n   */\n  (\n    options?: GetMeteredBillingChargesOptions | undefined\n  ): Promise<GetMeteredBillingChargesResponse>;\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  testCheckout?: boolean;\n  /** Information about the paid plan's billing cycle. */\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\ntype PurchasedItemNonNullablePaths =\n  | `productId`\n  | `price`\n  | `currency`\n  | `billingCycle`;\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`>> {\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  testCheckout?: boolean;\n  /** Information about the paid plan's billing cycle. */\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    {\n      [P in PurchasedItemNonNullablePaths]: `purchases.${number}.${P}`;\n    }[PurchasedItemNonNullablePaths]\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 * Triggers Wix to call the\n * [List Custom Charges SPI](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges).\n *\n *\n * Wix doesn't use the response from _List Charges_ SPI to actually create an\n * invoice that's sent to the customer. Instead, calling _Get Metered Billing Charges_\n * allows you confirm that your integration with the Custom Charges SPI is\n * working as intended.\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  >\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  };\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      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      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 * Triggers Wix to call the\n * [List Custom Charges SPI](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges).\n *\n *\n * Wix doesn't use the response from _List Charges_ SPI to actually create an\n * invoice that's sent to the customer. Instead, calling _Get Metered Billing Charges_\n * allows you confirm that your integration with the Custom Charges SPI is\n * working as intended.\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      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> = createEventModule(publicOnPurchasedItemInvoiceStatusUpdated);\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';\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\ntype PurchasedItemNonNullablePaths =\n  | `productId`\n  | `price`\n  | `currency`\n  | `billingCycle`;\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`>\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      {\n        [P in PurchasedItemNonNullablePaths]: `purchases.${number}.${P}`;\n      }[PurchasedItemNonNullablePaths]\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   * Triggers Wix to call the\n   * [List Custom Charges SPI](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges).\n   *\n   *\n   * Wix doesn't use the response from _List Charges_ SPI to actually create an\n   * invoice that's sent to the customer. Instead, calling _Get Metered Billing Charges_\n   * allows you confirm that your integration with the Custom Charges SPI is\n   * working as intended.\n   */\n  (options?: GetMeteredBillingChargesOptions): Promise<\n    NonNullablePaths<\n      GetMeteredBillingChargesResponse,\n      `charges` | `charges.${number}.description` | `charges.${number}.amount`\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  testCheckout?: boolean;\n  /** Information about the paid plan's billing cycle. */\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\ntype PurchasedItemNonNullablePaths =\n  | `productId`\n  | `price`\n  | `currency`\n  | `billingCycle`;\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`>> {\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  testCheckout?: boolean;\n  /** Information about the paid plan's billing cycle. */\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    {\n      [P in PurchasedItemNonNullablePaths]: `purchases.${number}.${P}`;\n    }[PurchasedItemNonNullablePaths]\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 * Triggers Wix to call the\n * [List Custom Charges SPI](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges).\n *\n *\n * Wix doesn't use the response from _List Charges_ SPI to actually create an\n * invoice that's sent to the customer. Instead, calling _Get Metered Billing Charges_\n * allows you confirm that your integration with the Custom Charges SPI is\n * working as intended.\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  >\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  };\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      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      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 * Triggers Wix to call the\n * [List Custom Charges SPI](https://dev.wix.com/docs/rest/internal-only/premium/custom-charges-spi/custom-charges-provider-v1/list-charges).\n *\n *\n * Wix doesn't use the response from _List Charges_ SPI to actually create an\n * invoice that's sent to the customer. Instead, calling _Get Metered Billing Charges_\n * allows you confirm that your integration with the Custom Charges SPI is\n * working as intended.\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      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> = createEventModule(publicOnPurchasedItemInvoiceStatusUpdated);\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';\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/{devcenter-checkout-v1-purchased-item-billing.universal-BOJl75V0.d.ts → index.typings.d.ts}

@@ -1,3 +1,5 @@
+import { NonNullablePaths } from '@wix/sdk-types';
+
 interface PurchasedItem {
     /** ID of your app's paid plan. */
     productId?: string;
@@ -272,6 +274,42 @@ interface PurchasedItemInvoiceStatusUpdatedEnvelope {
     data: InvoiceStatusUpdated;
     metadata: BaseEventMetadata;
 }
+/**
+ * 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.
+ * 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
+ * @permissionScope Read site, business, and email details
+ * @permissionScopeId SCOPE.DEV_CENTER.APP-INSTANCE-READ-BASIC-INFO
+ * @permissionId WIX_DEVELOPERS.MANAGE_APP_INSTANCE
+ * @webhook
+ * @eventType InvoiceStatusUpdated
+ * @serviceIdentifier com.wixpress.market.aim.api.Checkout
+ * @slug invoice_status_updated
+ */
+declare function onPurchasedItemInvoiceStatusUpdated(handler: (event: PurchasedItemInvoiceStatusUpdatedEnvelope) => void | Promise<void>): void;
+type PurchasedItemNonNullablePaths = `productId` | `price` | `currency` | `billingCycle`;
+/**
+ * Retrieves the URL for a Wix checkout page for the specified paid plan of your app.
+ *
+ *
+ * This call succeeds only in case 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.
+ *
+ * This API allows your app to manage your pricing page outside of Wix while
+ * still using the standard Wix checkout flow.
+ * @param productId - ID of your app's paid plan to retrieve the Wix checkout URL for. Check your app's dashboard
+ * for a list of your app's supported product IDs.
+ * @public
+ * @requiredField productId
+ * @permissionId WIX_DEVELOPERS.CREATE_CHECKOUT
+ * @applicableIdentity APP
+ * @fqn com.wixpress.market.aim.api.Checkout.GetUrl
+ */
+declare function getUrl(productId: string, options?: GetUrlOptions): Promise<NonNullablePaths<GetUrlResponse, `checkoutUrl`>>;
 interface GetUrlOptions {
     /**
      * URL for the Wix checkout page. Redirect site owners to this URL after
@@ -305,6 +343,22 @@ interface GetUrlOptions {
     /** Coupon code for the paid plan. Available only in case there is a discount. */
     couponCode?: string | null;
 }
+/**
+ * Retrieves a list of the site owner's past purchases for your app.
+ *
+ *
+ * You don't have to explicitly pass an identifier for the Wix site as part of
+ * the request, since this information is taken automatically from the context.
+ *
+ * The response doesn't include any details about cancellations.
+ * @public
+ * @permissionId WIX_DEVELOPERS.APP_PURCHASE_HISTORY
+ * @applicableIdentity APP
+ * @fqn com.wixpress.market.aim.api.Checkout.GetPurchaseHistory
+ */
+declare function getPurchaseHistory(): Promise<NonNullablePaths<GetPurchaseHistoryResponse, {
+    [P in PurchasedItemNonNullablePaths]: `purchases.${number}.${P}`;
+}[PurchasedItemNonNullablePaths]>>;
 interface GetMeteredBillingChargesOptions {
     /**
      * 3-letter currency code in
@@ -324,4 +378,4 @@ interface GetMeteredBillingChargesOptions {
     endDate?: Date | null;
 }
 
-export { type BaseEventMetadata as B, type ChargeOverride as C, type GetUrlOptions as G, InvoiceStatus as I, type MessageEnvelope as M, type PurchasedItemInvoiceStatusUpdatedEnvelope as P, WebhookIdentityType as W, type GetUrlResponse as a, type GetPurchaseHistoryResponse as b, PaymentCycle as c, type PurchasedItem as d, type InvoiceStatusUpdated as e, type GetUrlRequest as f, type GetPurchaseHistoryRequest as g, type GetSitePaymentMethodsStatusRequest as h, type GetSitePaymentMethodsStatusResponse as i, type GetMeteredBillingChargesRequest as j, type GetMeteredBillingChargesResponse as k, type Charge as l, type IdentificationData as m, type IdentificationDataIdOneOf as n, type GetMeteredBillingChargesOptions as o };
+export { type BaseEventMetadata, type Charge, type ChargeOverride, type GetMeteredBillingChargesOptions, type GetMeteredBillingChargesRequest, type GetMeteredBillingChargesResponse, type GetPurchaseHistoryRequest, type GetPurchaseHistoryResponse, type GetSitePaymentMethodsStatusRequest, type GetSitePaymentMethodsStatusResponse, type GetUrlOptions, type GetUrlRequest, type GetUrlResponse, type IdentificationData, type IdentificationDataIdOneOf, InvoiceStatus, type InvoiceStatusUpdated, type InvoiceStatusWithLiterals, type MessageEnvelope, PaymentCycle, type PaymentCycleWithLiterals, type PurchasedItem, type PurchasedItemInvoiceStatusUpdatedEnvelope, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, getPurchaseHistory, getUrl, onPurchasedItemInvoiceStatusUpdated };

package/build/cjs/index.typings.js

@@ -0,0 +1,317 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.typings.ts
+var index_typings_exports = {};
+__export(index_typings_exports, {
+  InvoiceStatus: () => InvoiceStatus,
+  PaymentCycle: () => PaymentCycle,
+  WebhookIdentityType: () => WebhookIdentityType,
+  getMeteredBillingCharges: () => getMeteredBillingCharges2,
+  getPurchaseHistory: () => getPurchaseHistory2,
+  getUrl: () => getUrl2
+});
+module.exports = __toCommonJS(index_typings_exports);
+
+// src/devcenter-checkout-v1-purchased-item-billing.universal.ts
+var import_transform_error = require("@wix/sdk-runtime/transform-error");
+var import_rename_all_nested_keys = require("@wix/sdk-runtime/rename-all-nested-keys");
+
+// src/devcenter-checkout-v1-purchased-item-billing.http.ts
+var import_rest_modules = require("@wix/sdk-runtime/rest-modules");
+var import_float = require("@wix/sdk-runtime/transformations/float");
+var import_timestamp = require("@wix/sdk-runtime/transformations/timestamp");
+var import_timestamp2 = require("@wix/sdk-runtime/transformations/timestamp");
+var import_transform_paths = require("@wix/sdk-runtime/transformations/transform-paths");
+var import_rest_modules2 = require("@wix/sdk-runtime/rest-modules");
+function resolveComWixpressMarketAimApiCheckoutUrl(opts) {
+  const domainToMappings = {
+    "api._api_base_domain_": [
+      {
+        srcPath: "/app-instance-manager-webapp",
+        destPath: ""
+      }
+    ],
+    "www.wixapis.com": [
+      {
+        srcPath: "/apps",
+        destPath: ""
+      }
+    ],
+    "wixapis.com": [
+      {
+        srcPath: "/apps",
+        destPath: ""
+      }
+    ],
+    "dev._base_domain_": [
+      {
+        srcPath: "/_api/app-instance-manager",
+        destPath: ""
+      },
+      {
+        srcPath: "/api/v1/instance",
+        destPath: "/v1/instance"
+      },
+      {
+        srcPath: "/api/v1/scripts",
+        destPath: "/v1/scripts"
+      }
+    ],
+    "manage._base_domain_": [
+      {
+        srcPath: "/_api/app-instance-manager",
+        destPath: ""
+      }
+    ],
+    "www._base_domain_": [
+      {
+        srcPath: "/_api/app-instance-manager",
+        destPath: ""
+      }
+    ],
+    "editor._base_domain_": [
+      {
+        srcPath: "/_api/app-instance-manager",
+        destPath: ""
+      }
+    ],
+    "blocks._base_domain_": [
+      {
+        srcPath: "/_api/app-instance-manager",
+        destPath: ""
+      }
+    ],
+    "create.editorx": [
+      {
+        srcPath: "/_api/app-instance-manager",
+        destPath: ""
+      }
+    ]
+  };
+  return (0, import_rest_modules2.resolveUrl)(Object.assign(opts, { domainToMappings }));
+}
+var PACKAGE_NAME = "@wix/auto_sdk_app-management_billing";
+function getUrl(payload) {
+  function __getUrl({ host }) {
+    const serializedData = (0, import_transform_paths.transformPaths)(payload, [
+      {
+        transformFn: import_float.transformSDKFloatToRESTFloat,
+        paths: [{ path: "chargeOverride.price" }]
+      }
+    ]);
+    const metadata = {
+      entityFqdn: "wix.devcenter.checkout.v1.purchased_item",
+      method: "POST",
+      methodFqn: "com.wixpress.market.aim.api.Checkout.GetUrl",
+      packageName: PACKAGE_NAME,
+      url: resolveComWixpressMarketAimApiCheckoutUrl({
+        protoPath: "/v1/checkout",
+        data: serializedData,
+        host
+      }),
+      data: serializedData
+    };
+    return metadata;
+  }
+  return __getUrl;
+}
+function getPurchaseHistory(payload) {
+  function __getPurchaseHistory({ host }) {
+    const metadata = {
+      entityFqdn: "wix.devcenter.checkout.v1.purchased_item",
+      method: "GET",
+      methodFqn: "com.wixpress.market.aim.api.Checkout.GetPurchaseHistory",
+      packageName: PACKAGE_NAME,
+      url: resolveComWixpressMarketAimApiCheckoutUrl({
+        protoPath: "/v1/checkout/history",
+        data: payload,
+        host
+      }),
+      params: (0, import_rest_modules.toURLSearchParams)(payload),
+      transformResponse: (payload2) => (0, import_transform_paths.transformPaths)(payload2, [
+        {
+          transformFn: import_timestamp2.transformRESTTimestampToSDKTimestamp,
+          paths: [{ path: "purchases.dateCreated" }]
+        }
+      ])
+    };
+    return metadata;
+  }
+  return __getPurchaseHistory;
+}
+function getMeteredBillingCharges(payload) {
+  function __getMeteredBillingCharges({ host }) {
+    const serializedData = (0, import_transform_paths.transformPaths)(payload, [
+      {
+        transformFn: import_timestamp.transformSDKTimestampToRESTTimestamp,
+        paths: [{ path: "startDate" }, { path: "endDate" }]
+      }
+    ]);
+    const metadata = {
+      entityFqdn: "wix.devcenter.checkout.v1.purchased_item",
+      method: "GET",
+      methodFqn: "com.wixpress.market.aim.api.Checkout.GetMeteredBillingCharges",
+      packageName: PACKAGE_NAME,
+      url: resolveComWixpressMarketAimApiCheckoutUrl({
+        protoPath: "/v1/metered-billing-charges",
+        data: serializedData,
+        host
+      }),
+      params: (0, import_rest_modules.toURLSearchParams)(serializedData)
+    };
+    return metadata;
+  }
+  return __getMeteredBillingCharges;
+}
+
+// src/devcenter-checkout-v1-purchased-item-billing.universal.ts
+var PaymentCycle = /* @__PURE__ */ ((PaymentCycle2) => {
+  PaymentCycle2["NO_CYCLE"] = "NO_CYCLE";
+  PaymentCycle2["MONTHLY"] = "MONTHLY";
+  PaymentCycle2["YEARLY"] = "YEARLY";
+  PaymentCycle2["ONE_TIME"] = "ONE_TIME";
+  PaymentCycle2["TWO_YEARS"] = "TWO_YEARS";
+  PaymentCycle2["THREE_YEARS"] = "THREE_YEARS";
+  PaymentCycle2["FOUR_YEARS"] = "FOUR_YEARS";
+  PaymentCycle2["FIVE_YEARS"] = "FIVE_YEARS";
+  return PaymentCycle2;
+})(PaymentCycle || {});
+var InvoiceStatus = /* @__PURE__ */ ((InvoiceStatus2) => {
+  InvoiceStatus2["UNKNOWN_INVOICE_STATUS"] = "UNKNOWN_INVOICE_STATUS";
+  InvoiceStatus2["PAYMENT_FAILED"] = "PAYMENT_FAILED";
+  InvoiceStatus2["PAID"] = "PAID";
+  InvoiceStatus2["REFUNDED"] = "REFUNDED";
+  InvoiceStatus2["VOIDED"] = "VOIDED";
+  InvoiceStatus2["CHARGEDBACK"] = "CHARGEDBACK";
+  return InvoiceStatus2;
+})(InvoiceStatus || {});
+var WebhookIdentityType = /* @__PURE__ */ ((WebhookIdentityType2) => {
+  WebhookIdentityType2["UNKNOWN"] = "UNKNOWN";
+  WebhookIdentityType2["ANONYMOUS_VISITOR"] = "ANONYMOUS_VISITOR";
+  WebhookIdentityType2["MEMBER"] = "MEMBER";
+  WebhookIdentityType2["WIX_USER"] = "WIX_USER";
+  WebhookIdentityType2["APP"] = "APP";
+  return WebhookIdentityType2;
+})(WebhookIdentityType || {});
+async function getUrl2(productId, options) {
+  const { httpClient, sideEffects } = arguments[2];
+  const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({
+    productId,
+    successUrl: options?.successUrl,
+    testCheckout: options?.testCheckout,
+    billingCycle: options?.billingCycle,
+    countryCode: options?.countryCode,
+    languageCode: options?.languageCode,
+    couponCode: options?.couponCode
+  });
+  const reqOpts = getUrl(payload);
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return (0, import_rename_all_nested_keys.renameKeysFromRESTResponseToSDKResponse)(result.data);
+  } catch (err) {
+    const transformedError = (0, import_transform_error.transformError)(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          productId: "$[0]",
+          successUrl: "$[1].successUrl",
+          testCheckout: "$[1].testCheckout",
+          billingCycle: "$[1].billingCycle",
+          countryCode: "$[1].countryCode",
+          languageCode: "$[1].languageCode",
+          couponCode: "$[1].couponCode"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["productId", "options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
+async function getPurchaseHistory2() {
+  const { httpClient, sideEffects } = arguments[0];
+  const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({});
+  const reqOpts = getPurchaseHistory(payload);
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return (0, import_rename_all_nested_keys.renameKeysFromRESTResponseToSDKResponse)(result.data);
+  } catch (err) {
+    const transformedError = (0, import_transform_error.transformError)(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {},
+        singleArgumentUnchanged: false
+      },
+      []
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
+async function getMeteredBillingCharges2(options) {
+  const { httpClient, sideEffects } = arguments[1];
+  const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({
+    currency: options?.currency,
+    startDate: options?.startDate,
+    endDate: options?.endDate
+  });
+  const reqOpts = getMeteredBillingCharges(
+    payload
+  );
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return (0, import_rename_all_nested_keys.renameKeysFromRESTResponseToSDKResponse)(result.data);
+  } catch (err) {
+    const transformedError = (0, import_transform_error.transformError)(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          currency: "$[0].currency",
+          startDate: "$[0].startDate",
+          endDate: "$[0].endDate"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InvoiceStatus,
+  PaymentCycle,
+  WebhookIdentityType,
+  getMeteredBillingCharges,
+  getPurchaseHistory,
+  getUrl
+});
+//# sourceMappingURL=index.typings.js.map