@rechargeapps/storefront-client 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -335,6 +335,9 @@ interface Charge {
     /** The date time at which the Charge was most recently updated. */
     updated_at: IsoDateString;
 }
+interface ChargeResponse {
+    charge: Charge;
+}
 interface ChargeListResponse {
     next_cursor: null | string;
     previous_cursor: null | string;
@@ -503,6 +506,12 @@ interface Address {
     /** The date and time when the address was last updated. */
     updated_at: IsoDateString;
 }
+interface SkipFutureChargeAddressResponse {
+    charge: Charge;
+}
+interface AddressResponse {
+    address: Address;
+}
 interface AddressListResponse {
     next_cursor: null | string;
     previous_cursor: null | string;
@@ -519,7 +528,7 @@ interface AddressListParams extends ListParams<AddressSortBy> {
 
 interface Session {
     apiToken: string;
-    customerId: string;
+    customerId?: string;
 }
 
 /** Returns all addresses from the store, or addresses for the customer given in the parameter. */
@@ -541,7 +550,7 @@ declare function mergeAddresses(session: Session, mergeRequest: MergeAddressesRe
  */
 declare function skipFutureCharge(session: Session, id: string | number, skipRequest: SkipFutureChargeAddressRequest): Promise<Charge>;
 
-declare function loginShopifyAppProxy(): Promise<Session | null>;
+declare function loginShopifyAppProxy(): Promise<Session>;
 declare function loginShopifyApi(customerAccessToken: string, storefrontAccessToken: string): Promise<Session | null>;
 
 declare function getCharge(session: Session, id: number | string): Promise<Charge>;
@@ -586,6 +595,11 @@ interface RequestOptionsHeaders {
 }
 declare type RequestOptions = GetRequestOptions & CRUDRequestOptions & RequestOptionsHeaders;
 
+interface LoginResponse {
+    api_token: string;
+    customer_id?: string;
+}
+
 interface BundleSelection {
     collectionId: string;
     externalProductId: string;
@@ -946,24 +960,56 @@ interface CDNBundleSettings {
     variants: CDNBundleVariant[];
 }
 
-declare type StorefrontEnvironment = 'stage' | 'prod';
-interface StorefrontOptions {
-    storeIdentifier: string;
-    /** This is only for internal use. Sets the environment where data is fetched from. */
-    environment: StorefrontEnvironment;
+interface Customer {
+    /** Unique numeric identifier for the Customer. */
+    id: number;
+    /** An object containing analytics data associated with the customer. */
+    analytics_data: AnalyticsData;
+    /** The date and time when the customer was created. */
+    created_at: IsoDateString;
+    /** The email address of the customer. */
+    email: string;
+    /** An object containing external ids for the customer record. */
+    external_customer_id: ExternalId;
+    /** Date when first charge was processed for the customer. */
+    first_charge_processed_at: IsoDateString;
+    /** The customer’s first name. */
+    first_name: string;
+    /** A boolean that indicates if the customer has a payment method that is in dunning (failed charge). */
+    has_payment_method_in_dunning: boolean;
+    /** Is the payment method valid or not. */
+    has_valid_payment_method: boolean;
+    /** The unique string identifier used in a customers portal link. */
+    hash: string;
+    /** The customer’s last name. */
+    last_name: string;
+    /** The number of active subscriptions on addresses associated with the customer. */
+    subscriptions_active_count: number;
+    /** The total number of subscriptions created on addresses associated with the customer. */
+    subscriptions_total_count: number;
+    /** The date and time when the customer was last updated. */
+    updated_at: IsoDateString;
+}
+declare type OptionalUpdateProps$2 = 'email' | 'first_name' | 'last_name' | 'external_customer_id';
+declare type UpdateCustomerRequest = Partial<Pick<Customer, OptionalUpdateProps$2>>;
+interface CustomerDeliveryScheduleParams {
+    delivery_count_future?: number;
+    future_internal?: number;
+    date_max?: IsoDateString;
+}
+interface Delivery {
+    date: IsoDateString;
+    orders: Order[];
+}
+interface CustomerDeliveryScheduleResponse {
+    customer: {
+        id: number;
+        email: string;
+        first_name: string;
+        last_name: string;
+    };
+    deliveries: Delivery[];
 }
-
-declare function getCDNProduct(externalProductId: string | number): Promise<CDNProduct>;
-declare function getCDNStoreSettings(): Promise<CDNStoreSettings>;
-declare function getCDNWidgetSettings(): Promise<CDNWidgetSettings>;
-declare function getCDNProductsAndSettings(): Promise<CDNProductsAndSettings>;
-declare function getCDNProducts(): Promise<CDNProductKeyObject[]>;
-declare function getCDNProductAndSettings(externalProductId: string | number): Promise<CDNProductAndSettings>;
-declare function getCDNBundleSettings(externalProductId: string | number): Promise<CDNBundleSettings | null | undefined>;
-declare function resetCDNCache(): Promise<void>;
-
-declare function getBundleId(bundle: Bundle): Promise<string>;
-declare function validateBundle(bundle: Bundle): Promise<boolean>;
 
 declare type MembershipStatus = 'active' | 'inactive';
 interface Membership {
@@ -979,6 +1025,9 @@ interface Membership {
     subscription_cancelled_at: IsoDateString | null;
     image?: string;
 }
+interface MembershipResponse {
+    membership: Membership;
+}
 interface MembershipListResponse {
     next_cursor: null | string;
     previous_cursor: null | string;
@@ -1011,15 +1060,6 @@ interface CancelMembershipRequest {
     expires_at: IsoDateString;
 }
 
-/** Retrieves membership information for passed in id */
-declare function getMembership(session: Session, id: string | number): Promise<Membership>;
-/** Retrieves a list of memberships  */
-declare function listMemberships(session: Session, query?: MembershipListParams): Promise<MembershipListResponse>;
-/** Cancels a membership  */
-declare function cancelMembership(session: Session, id: string | number, cancelRequest: CancelMembershipRequest): Promise<Membership>;
-/** Activates a membership  */
-declare function activateMembership(session: Session, id: string | number, activateRequest: ActivateMembershipRequest): Promise<Membership>;
-
 interface Onetime {
     /** Unique numeric identifier for the Onetime purchase. */
     id: number;
@@ -1066,8 +1106,8 @@ interface CreateProps {
     add_to_next_charge?: boolean;
 }
 declare type CreateOnetimeRequest = SubType<Onetime, RequiredCreateProps$1, OptionalCreateProps$1> & CreateProps;
-declare type OptionalUpdateProps$2 = 'address_id' | 'next_charge_scheduled_at' | 'properties' | 'quantity' | 'external_variant_id' | 'sku';
-declare type UpdateOnetimeRequest = Partial<Pick<Onetime, OptionalUpdateProps$2>>;
+declare type OptionalUpdateProps$1 = 'address_id' | 'next_charge_scheduled_at' | 'properties' | 'quantity' | 'external_variant_id' | 'sku';
+declare type UpdateOnetimeRequest = Partial<Pick<Onetime, OptionalUpdateProps$1>>;
 interface OnetimesResponse {
     next_cursor: null | string;
     previous_cursor: null | string;
@@ -1076,14 +1116,21 @@ interface OnetimesResponse {
 declare type OnetimesSortBy = 'id-asc' | 'id-desc' | 'created_at-asc' | 'created_at-desc' | 'updated_at-asc' | 'updated_at-desc';
 declare type OnetimeListParams = ListParams<OnetimesSortBy>;
 
-declare function getOnetime(session: Session, id: string | number): Promise<Onetime>;
-declare function listOnetimes(session: Session, query?: OnetimeListParams): Promise<OnetimesResponse>;
-declare function createOnetime(session: Session, createRequest: CreateOnetimeRequest): Promise<Onetime>;
-declare function updateOnetime(session: Session, id: string | number, updateRequest: UpdateOnetimeRequest): Promise<Onetime>;
-declare function deleteOnetime(session: Session, id: string | number): Promise<void>;
-
-declare function getOrder(session: Session, id: string | number): Promise<Order>;
-declare function listOrders(session: Session, query?: OrderListParams): Promise<OrdersResponse>;
+/** @internal */
+declare type StorefrontEnvironment = 'stage' | 'prod';
+/** @internal */
+interface StorefrontOptions {
+    storeIdentifier: string;
+    /** Recharge storefront access token */
+    storefrontAccessToken?: string;
+    /** This is only for internal use. Sets the environment where data is fetched from. */
+    environment: StorefrontEnvironment;
+}
+interface InitOptions {
+    storeIdentifier?: string;
+    /** Recharge storefront access token */
+    storefrontAccessToken?: string;
+}
 
 interface ChannelSettings {
     api: {
@@ -1149,9 +1196,6 @@ interface PlanListParams extends ListParams<PlanSortBy> {
     type?: PlanType;
 }
 
-declare function getPlan(session: Session, id: string | number): Promise<Plan>;
-declare function listPlans(session: Session, query?: PlanListParams): Promise<PlansResponse>;
-
 interface Subscription {
     /** Unique numeric identifier for the subscription. */
     id: number;
@@ -1248,8 +1292,8 @@ interface SubscriptionListParams extends ListParams<SubscriptionSortBy> {
 declare type RequiredCreateProps = 'address_id' | 'charge_interval_frequency' | 'external_variant_id' | 'next_charge_scheduled_at' | 'order_interval_frequency' | 'order_interval_unit' | 'quantity';
 declare type OptionalCreateProps = 'expire_after_specific_number_of_charges' | 'order_day_of_month' | 'order_day_of_week' | 'external_product_id' | 'product_title' | 'properties' | 'status';
 declare type CreateSubscriptionRequest = SubType<Subscription, RequiredCreateProps, OptionalCreateProps>;
-declare type OptionalUpdateProps$1 = 'charge_interval_frequency' | 'expire_after_specific_number_of_charges' | 'order_day_of_month' | 'order_day_of_week' | 'order_interval_frequency' | 'order_interval_unit' | 'quantity' | 'external_product_id' | 'external_variant_id' | 'properties' | 'sku' | 'sku_override';
-declare type UpdateSubscriptionRequest = Partial<Pick<Subscription, OptionalUpdateProps$1>>;
+declare type OptionalUpdateProps = 'charge_interval_frequency' | 'expire_after_specific_number_of_charges' | 'order_day_of_month' | 'order_day_of_week' | 'order_interval_frequency' | 'order_interval_unit' | 'quantity' | 'external_product_id' | 'external_variant_id' | 'properties' | 'sku' | 'sku_override';
+declare type UpdateSubscriptionRequest = Partial<Pick<Subscription, OptionalUpdateProps>>;
 interface UpdateSubscriptionParams {
     /** Controls whether the QUEUED charges linked to the subscription should be regenerated upon subscription update. By default the flag is set to false which will delay charge regeneration 5 seconds. This enables running multiple calls to perform changes and receive responses much faster since the API won’t wait for a charge regeneration to complete. Setting this parameter to true will cause charge regeneration to complete before returning a response. */
     commit?: boolean;
@@ -1260,6 +1304,39 @@ interface CancelSubscriptionRequest {
     send_email?: boolean;
 }
 
+declare function getCDNProduct(externalProductId: string | number): Promise<CDNProduct>;
+declare function getCDNStoreSettings(): Promise<CDNStoreSettings>;
+declare function getCDNWidgetSettings(): Promise<CDNWidgetSettings>;
+declare function getCDNProductsAndSettings(): Promise<CDNProductsAndSettings>;
+declare function getCDNProducts(): Promise<CDNProductKeyObject[]>;
+declare function getCDNProductAndSettings(externalProductId: string | number): Promise<CDNProductAndSettings>;
+declare function getCDNBundleSettings(externalProductId: string | number): Promise<CDNBundleSettings | null | undefined>;
+declare function resetCDNCache(): Promise<void>;
+
+declare function getBundleId(bundle: Bundle): Promise<string>;
+declare function validateBundle(bundle: Bundle): Promise<boolean>;
+
+/** Retrieves membership information for passed in id */
+declare function getMembership(session: Session, id: string | number): Promise<Membership>;
+/** Retrieves a list of memberships */
+declare function listMemberships(session: Session, query?: MembershipListParams): Promise<MembershipListResponse>;
+/** Cancels a membership */
+declare function cancelMembership(session: Session, id: string | number, cancelRequest: CancelMembershipRequest): Promise<Membership>;
+/** Activates a membership */
+declare function activateMembership(session: Session, id: string | number, activateRequest: ActivateMembershipRequest): Promise<Membership>;
+
+declare function getOnetime(session: Session, id: string | number): Promise<Onetime>;
+declare function listOnetimes(session: Session, query?: OnetimeListParams): Promise<OnetimesResponse>;
+declare function createOnetime(session: Session, createRequest: CreateOnetimeRequest): Promise<Onetime>;
+declare function updateOnetime(session: Session, id: string | number, updateRequest: UpdateOnetimeRequest): Promise<Onetime>;
+declare function deleteOnetime(session: Session, id: string | number): Promise<void>;
+
+declare function getOrder(session: Session, id: string | number): Promise<Order>;
+declare function listOrders(session: Session, query?: OrderListParams): Promise<OrdersResponse>;
+
+declare function getPlan(session: Session, id: string | number): Promise<Plan>;
+declare function listPlans(session: Session, query?: PlanListParams): Promise<PlansResponse>;
+
 declare function getSubscription(session: Session, id: string | number): Promise<Subscription>;
 declare function listSubscriptions(session: Session, query?: SubscriptionListParams): Promise<SubscriptionsResponse>;
 /**
@@ -1293,54 +1370,12 @@ declare function cancelSubscription(session: Session, id: string | number, cance
  * and cancellation_reason_comments.
  */
 declare function activateSubscription(session: Session, id: string | number): Promise<Subscription>;
-
-interface Customer {
-    /** Unique numeric identifier for the Customer. */
-    id: number;
-    /** An object containing analytics data associated with the customer. */
-    analytics_data: AnalyticsData;
-    /** The date and time when the customer was created. */
-    created_at: IsoDateString;
-    /** The email address of the customer. */
-    email: string;
-    /** An object containing external ids for the customer record. */
-    external_customer_id: ExternalId;
-    /** Date when first charge was processed for the customer. */
-    first_charge_processed_at: IsoDateString;
-    /** The customer’s first name. */
-    first_name: string;
-    /** A boolean that indicates if the customer has a payment method that is in dunning (failed charge). */
-    has_payment_method_in_dunning: boolean;
-    /** Is the payment method valid or not. */
-    has_valid_payment_method: boolean;
-    /** The unique string identifier used in a customers portal link. */
-    hash: string;
-    /** The customer’s last name. */
-    last_name: string;
-    /** The number of active subscriptions on addresses associated with the customer. */
-    subscriptions_active_count: number;
-    /** The total number of subscriptions created on addresses associated with the customer. */
-    subscriptions_total_count: number;
-    /** The date and time when the customer was last updated. */
-    updated_at: IsoDateString;
-}
-declare type OptionalUpdateProps = 'email' | 'first_name' | 'last_name' | 'external_customer_id';
-declare type UpdateCustomerRequest = Partial<Pick<Customer, OptionalUpdateProps>>;
-interface CustomerDeliveryScheduleParams {
-    delivery_count_future?: number;
-    future_internal?: number;
-    date_max?: IsoDateString;
-}
-interface Delivery {
-    date: IsoDateString;
-    orders: Order[];
-}
+declare function skipSubscriptionCharge(session: Session, id: number | string, date: IsoDateString): Promise<Charge>;
 
 declare function getCustomer(session: Session): Promise<Customer>;
 declare function updateCustomer(session: Session, updateRequest: UpdateCustomerRequest): Promise<Customer>;
 declare function getDeliverySchedule(session: Session, query?: CustomerDeliveryScheduleParams): Promise<Delivery[]>;
 
-declare type InitOptions = Omit<Partial<StorefrontOptions>, 'environment'>;
 declare const api: {
     get<T>(url: string, requestOptions?: GetRequestOptions): Promise<T>;
     post<T_1>(url: string, requestOptions?: CRUDRequestOptions): Promise<T_1>;
@@ -1349,4 +1384,4 @@ declare const api: {
 };
 declare function initRecharge(opt?: InitOptions): void;
 
-export { Bundle, BundleSelection, BundleTranslations, CDNBaseWidgetSettings, CDNBundleLayoutSettings, CDNBundleSettings, CDNBundleStep, CDNBundleStepOption, CDNBundleVariant, CDNBundleVariantOptionSource, CDNBundleVariantSelectionDefault, CDNPrices, CDNProduct, CDNProductAndSettings, CDNProductKeyObject, CDNProductOption, CDNProductOptionValue, CDNProductRaw, CDNProductResource, CDNProductsAndSettings, CDNProductsAndSettingsResource, CDNSellingPlan, CDNSellingPlanAllocations, CDNSellingPlanGroup, CDNStoreSettings, CDNSubscriptionOption, CDNVariant, CDNVariantOptionValue, CDNWidgetSettings, CDNWidgetSettingsRaw, CDNWidgetSettingsResource, CRUDRequestOptions, FirstOption, GetRequestOptions, InitOptions, IntervalUnit, Method, PriceAdjustmentsType, Request, RequestHeaders, RequestOptions, RequestOptionsHeaders, StorefrontEnvironment, StorefrontOptions, StorefrontPurchaseOption, Translations, WidgetIconColor, WidgetTemplateType, activateMembership, activateSubscription, api, applyDiscount, cancelMembership, cancelSubscription, createAddress, createOnetime, createSubscription, deleteAddress, deleteOnetime, getAddress, getBundleId, getCDNBundleSettings, getCDNProduct, getCDNProductAndSettings, getCDNProducts, getCDNProductsAndSettings, getCDNStoreSettings, getCDNWidgetSettings, getCharge, getCustomer, getDeliverySchedule, getMembership, getOnetime, getOrder, getPlan, getSubscription, initRecharge, listAddresses, listCharges, listMemberships, listOnetimes, listOrders, listPlans, listSubscriptions, loginShopifyApi, loginShopifyAppProxy, mergeAddresses, removeDiscount, resetCDNCache, skipCharge, skipFutureCharge, unskipCharge, updateAddress, updateCustomer, updateOnetime, updateSubscription, updateSubscriptionAddress, updateSubscriptionChargeDate, validateBundle };
+export { ActivateMembershipRequest, Address, AddressListParams, AddressListResponse, AddressResponse, AddressSortBy, AnalyticsData, ApplyDiscountRequest, AssociatedAddress, Bundle, BundleSelection, BundleTranslations, CDNBaseWidgetSettings, CDNBundleLayoutSettings, CDNBundleSettings, CDNBundleStep, CDNBundleStepOption, CDNBundleVariant, CDNBundleVariantOptionSource, CDNBundleVariantSelectionDefault, CDNPrices, CDNProduct, CDNProductAndSettings, CDNProductKeyObject, CDNProductOption, CDNProductOptionValue, CDNProductRaw, CDNProductResource, CDNProductsAndSettings, CDNProductsAndSettingsResource, CDNSellingPlan, CDNSellingPlanAllocations, CDNSellingPlanGroup, CDNStoreSettings, CDNSubscriptionOption, CDNVariant, CDNVariantOptionValue, CDNWidgetSettings, CDNWidgetSettingsRaw, CDNWidgetSettingsResource, CRUDRequestOptions, CancelMembershipRequest, CancelSubscriptionRequest, ChannelSettings, Charge, ChargeListParams, ChargeListResponse, ChargeResponse, ChargeSortBy, ChargeStatus, ColorString, CreateAddressRequest, CreateOnetimeRequest, CreateSubscriptionRequest, Customer, CustomerDeliveryScheduleParams, CustomerDeliveryScheduleResponse, Delivery, Discount, ExternalId, ExternalTransactionId, FirstOption, GetRequestOptions, HTMLString, InitOptions, IntervalUnit, IsoDateString, LineItem, ListParams, LoginResponse, Membership, MembershipListParams, MembershipListResponse, MembershipResponse, MembershipStatus, MembershipsSortBy, MergeAddressesRequest, Method, Onetime, OnetimeListParams, OnetimesResponse, OnetimesSortBy, Order, OrderListParams, OrderSortBy, OrderStatus, OrderType, OrdersResponse, Plan, PlanListParams, PlanSortBy, PlanType, PlansResponse, PriceAdjustmentsType, ProductImage, Property, Request, RequestHeaders, RequestOptions, RequestOptionsHeaders, Session, ShippingLine, SkipFutureChargeAddressRequest, SkipFutureChargeAddressResponse, StorefrontEnvironment, StorefrontOptions, StorefrontPurchaseOption, SubType, Subscription, SubscriptionListParams, SubscriptionPreferences, SubscriptionSortBy, SubscriptionsResponse, TaxLine, Translations, UpdateAddressRequest, UpdateCustomerRequest, UpdateOnetimeRequest, UpdateSubscriptionParams, UpdateSubscriptionRequest, WidgetIconColor, WidgetTemplateType, activateMembership, activateSubscription, api, applyDiscount, cancelMembership, cancelSubscription, createAddress, createOnetime, createSubscription, deleteAddress, deleteOnetime, getAddress, getBundleId, getCDNBundleSettings, getCDNProduct, getCDNProductAndSettings, getCDNProducts, getCDNProductsAndSettings, getCDNStoreSettings, getCDNWidgetSettings, getCharge, getCustomer, getDeliverySchedule, getMembership, getOnetime, getOrder, getPlan, getSubscription, initRecharge, listAddresses, listCharges, listMemberships, listOnetimes, listOrders, listPlans, listSubscriptions, loginShopifyApi, loginShopifyAppProxy, mergeAddresses, removeDiscount, resetCDNCache, skipCharge, skipFutureCharge, skipSubscriptionCharge, unskipCharge, updateAddress, updateCustomer, updateOnetime, updateSubscription, updateSubscriptionAddress, updateSubscriptionChargeDate, validateBundle };