orionplace-react 0.1.0 → 0.2.0

package/templates/interfaces/orionplace/index.ts

@@ -1,30 +1,64 @@
-export * from './apiBase/TMethod';
-export * from './appBase/IAppLoad';
-export * from './appBase/IAppLoadCommon';
-export * from './appBase/IApploadUserProfile';
-export * from './appBase/IForm';
-export * from './appBase/ISEO';
-export * from './appBase/appLoadCommon/IAppLoadCommonBanner';
-export * from './appBase/appLoadCommon/IAppLoadCommonContact';
-export * from './appBase/appLoadCommon/IAppLoadCommonCurrency';
-export * from './appBase/appLoadCommon/IAppLoadCommonEvents';
-export * from './appBase/appLoadCommon/IAppLoadCommonLocale';
-export * from './appBase/appLoadCommon/IAppLoadCommonLogos';
-export * from './appBase/appLoadCommon/IAppLoadCommonPath';
-export * from './appBase/appLoadCommon/IAppLoadCommonSEO';
-export * from './appBase/appLoadCommon/IAppLoadCommonSocial';
-export * from './appBase/appLoadCommon/IAppLoadCommonTariff';
-export * from './appBase/appLoadCommon/IAppLoadCommonUnit';
-export * from './appBase/appLoadCommon/IAppLoadCommonVariables';
-export * from './appBase/appLoadCommon/IAppLoadCommonVisualSettings';
-export * from './appBase/appLoadCommon/IAppLoadCommonWalletValue';
-export * from './category/ICategory';
-export * from './domains/IDomain';
-export * from './products/IProduct';
-export * from './shared/IGeoCoordinates';
-export * from './shared/ITransformValue';
-export * from './subscribeOptions/ISubscribeOption';
-export * from './subscribeTariff/ISubscribeTariff';
-export * from './subscribes/ISubscribe';
-export * from './transport';
-export * from './state';
+export * from '@/interfaces/orionplace/apiBase/TMethod';
+export * from '@/interfaces/orionplace/appBase/IAppLoad';
+export * from '@/interfaces/orionplace/appBase/IAppLoadCommon';
+export * from '@/interfaces/orionplace/appBase/IApploadUserProfile';
+export * from '@/interfaces/orionplace/appBase/IForm';
+export * from '@/interfaces/orionplace/appBase/ISEO';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonBanner';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonContact';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonCurrency';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonEvents';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonLocale';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonLogos';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonPath';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonSEO';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonSocial';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonTariff';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonUnit';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonVariables';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonVisualSettings';
+export * from '@/interfaces/orionplace/appBase/appLoadCommon/IAppLoadCommonWalletValue';
+export * from '@/interfaces/orionplace/category/ICategory';
+export * from '@/interfaces/orionplace/domains/IDomain';
+export * from '@/interfaces/orionplace/products/IProduct';
+export * from '@/interfaces/orionplace/shared/IGeoCoordinates';
+export * from '@/interfaces/orionplace/shared/IBreadcrumb';
+export * from '@/interfaces/orionplace/shared/ITransformValue';
+export * from '@/interfaces/orionplace/shared/IStorefrontControls';
+export * from '@/interfaces/orionplace/subscribeOptions/ISubscribeOption';
+export * from '@/interfaces/orionplace/subscribeTariff/ISubscribeTariff';
+export * from '@/interfaces/orionplace/subscribes/ISubscribe';
+export * from '@/interfaces/orionplace/transport';
+export * from '@/interfaces/orionplace/state';
+export * from '@/interfaces/orionplace/address/IAddressRegionSearch';
+export * from '@/interfaces/orionplace/address/IAddressCitySuggestion';
+export * from '@/interfaces/orionplace/address/IAddressSuggestion';
+export * from '@/interfaces/orionplace/address/IAddressLocationSuggestion';
+export * from '@/interfaces/orionplace/address/IAddressEditor';
+export * from '@/interfaces/orionplace/address/IUserAddress';
+export * from '@/interfaces/orionplace/accounts/IEmailVerification';
+export * from '@/interfaces/orionplace/accounts/IProfileActions';
+export * from '@/interfaces/orionplace/accounts/IProfileData';
+export * from '@/interfaces/orionplace/accounts/IProfileMedia';
+export * from '@/interfaces/orionplace/accounts/IEmailNotificationLocale';
+export * from '@/interfaces/orionplace/catalog/ICatalogDirectory';
+export * from '@/interfaces/orionplace/stores/IStoreDirectory';
+export * from '@/interfaces/orionplace/accounts/IContact';
+export * from '@/interfaces/orionplace/sellers/ISellerDirectory';
+export * from '@/interfaces/orionplace/products/IWishlist';
+export * from '@/interfaces/orionplace/cart/ICartActions';
+export * from '@/interfaces/orionplace/cart/ICartModal';
+export * from '@/interfaces/orionplace/cart/ICartData';
+export * from '@/interfaces/orionplace/cart/ICartDeliveryActions';
+export * from '@/interfaces/orionplace/cart/IDeliveryMap';
+export * from '@/interfaces/orionplace/marketing/IPromoActions';
+export * from '@/interfaces/orionplace/payments/IInvoice';
+export * from '@/interfaces/orionplace/subscribes/ISubscriptionApi';
+export * from '@/interfaces/orionplace/blog/IBlogApi';
+export * from '@/interfaces/orionplace/blog/IBlogPostPreview';
+export * from '@/interfaces/orionplace/products/IProductFeedbackApi';
+export * from '@/interfaces/orionplace/products/IProductSearchApi';
+export * from '@/interfaces/orionplace/orders/IProductPreorder';
+export * from '@/interfaces/orionplace/orders/IOrderActions';
+export * from '@/interfaces/orionplace/orders/IOrderHistory';
+export * from '@/interfaces/orionplace/tickets/ICustomerTicketApi';

package/templates/interfaces/orionplace/marketing/IPromoActions.ts

@@ -0,0 +1,51 @@
+import type { ApiFormError } from '@/interfaces/orionplace/transport';
+import type {
+  IApiPagination,
+  IApiPaginationRequest,
+} from '@/interfaces/orionplace/accounts/IProfileData';
+import type {
+  ICartPromoNotice,
+  IPromoDefinition,
+} from '@/interfaces/orionplace/cart/ICartData';
+
+export const EPromoUsageLimit = {
+  UNLIMITED_USAGE: -1,
+} as const;
+export type EPromoUsageLimit =
+  (typeof EPromoUsageLimit)[keyof typeof EPromoUsageLimit];
+
+export interface ICartPromoRequest {
+  promocode: string;
+}
+
+/**
+ * `page_data` of a refused `marketing_promo_promo_apply`: the code is valid
+ * but gives this cart nothing. `form_errors.__all__` holds the same reason.
+ */
+export interface ICartPromoApplyRefusal {
+  promo_notice?: ICartPromoNotice;
+}
+
+export interface IPromoIssue {
+  id: number;
+  code_value: string;
+  is_code_active: boolean;
+  maximum_usages: number;
+  current_usages: number;
+  promo_type: IPromoDefinition | null;
+  applyed_to_cart: boolean;
+}
+
+export interface IPromoIssuesRequest {
+  filters?: Record<string, never>;
+  paginate?: IApiPaginationRequest;
+}
+
+export interface IPromoIssuesResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: {
+    data: IPromoIssue[];
+    rpag: IApiPagination;
+  } | null;
+}

package/templates/interfaces/orionplace/orders/IOrderActions.ts

@@ -0,0 +1,99 @@
+import type { ApiFormError } from '@/interfaces/orionplace/transport';
+import type { IPaymentMethod } from '@/interfaces/orionplace/cart/ICartData';
+import type { EPaymentLinkType } from '@/interfaces/orionplace/payments/IInvoice';
+
+export const EOrderStatus        = {
+  CANCELED: 0,
+  CREATED: 1,
+  SENT: 2,
+  FINISHED: 3,
+  REFUND: 4,
+} as const;
+export type EOrderStatus = (typeof EOrderStatus)[keyof typeof EOrderStatus];
+
+export const EOrderPaymentStatus = {
+  NOT_PAID: 0,
+  PAID: 1,
+  LATE_PAID: 2,
+} as const;
+export type EOrderPaymentStatus =
+  (typeof EOrderPaymentStatus)[keyof typeof EOrderPaymentStatus];
+
+export const EOrderTab           = {
+  IN_WORK: 0,
+  CANCELED: 1,
+  FINISHED: 2,
+  REFUND: 3,
+} as const;
+export type EOrderTab = (typeof EOrderTab)[keyof typeof EOrderTab];
+
+export interface IOrderCreated {
+  order_id: number;
+  link: string;
+  link_type: EPaymentLinkType | null;
+  promo_value?: string;
+  // The order exists, but the payment provider gave no link (`link` is
+  // empty): the customer pays later from the order.
+  payment_error?: string;
+}
+
+export interface IOrderCreateFailure {
+  reboot?: boolean;
+  retryable?: boolean;
+  orders_allowed?: false;
+  promo_error?: boolean;
+  orders_temporary_disabled?: boolean;
+  balance_usd?: number | string;
+  min_usd?: number | string;
+  dlf_item?: number;
+  option_group?: number;
+  option?: number;
+  dlf?: number;
+  cart_delivery_id?: number;
+}
+
+export interface IOrderCreateResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: IOrderCreated | IOrderCreateFailure | null;
+}
+
+export interface IOrderPaymentMethodsResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: Record<string, IPaymentMethod> | null;
+}
+
+export interface IOrderPaymentRequest {
+  order: number;
+  payment: number;
+}
+
+export interface IOrderPaymentResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: {
+    link: string;
+    link_type: EPaymentLinkType | null;
+  } | null;
+}
+
+export interface IOrderRepeatRequest {
+  order: number;
+}
+
+export interface IOrderOptionFileRequest {
+  option_group: number;
+}
+
+export interface IOrderDigitalFileRequest {
+  attached_stock: number;
+}
+
+export interface IOrderFileErrorResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: null;
+}
+
+export type IOrderFileResponse = Blob | IOrderFileErrorResponse;

package/templates/interfaces/orionplace/orders/IOrderHistory.ts

@@ -0,0 +1,259 @@
+import type { ApiFormError } from '@/interfaces/orionplace/transport';
+import type {
+  IApiPagination,
+  IApiPaginationRequest,
+  IApiDateTime,
+} from '@/interfaces/orionplace/accounts/IProfileData';
+import type { IAddressCountry } from '@/interfaces/orionplace/address/IUserAddress';
+import type { IAddressRegion } from '@/interfaces/orionplace/address/IAddressRegionSearch';
+import type { IPhysicalStore } from '@/interfaces/orionplace/stores/IStoreDirectory';
+import type { IProduct } from '@/interfaces/orionplace/products/IProduct';
+import type { ICustomerTicket } from '@/interfaces/orionplace/tickets/ICustomerTicketApi';
+import type {
+  ICurrencyAmounts,
+  IUnitValues,
+  IPaymentMethod,
+  IPromoDefinition,
+  IDeliveryType,
+  ICartOptionType,
+  ICartOptionGroup,
+  ICartAddress,
+  ICartDeliveryPrices,
+} from '@/interfaces/orionplace/cart/ICartData';
+import type {
+  EOrderStatus,
+  EOrderPaymentStatus,
+  EOrderTab,
+} from '@/interfaces/orionplace/orders/IOrderActions';
+
+export interface IOrderHistoryRequest {
+  filters?: {
+    id?: number;
+    id__in?: number[] | string;
+    order_status?: EOrderStatus[];
+    order_tab?: EOrderTab;
+    ordering?: 'id' | '-id';
+  };
+  paginate?: IApiPaginationRequest;
+}
+
+export interface IOrderRefundStats {
+  c_total_refund_wait: number;
+  c_total_refund_delivered: number;
+  c_total_refund_to_pay: number;
+}
+
+export interface IOrderItemRefundStats {
+  c_refund_wait: number;
+  c_refund_delivered: number;
+  c_refund_to_pay: number;
+  // Units received or approved that were returned as defective.
+  c_refund_defect?: number;
+}
+
+// The return request a delivered line accepts today: any request inside the
+// regular return period, only a request marked as a defect after it.
+export type OrderRefundWindow = 'regular' | 'defect';
+
+export interface IOrderDigitalAttachment {
+  attachment_id: number;
+  filename: string;
+  text: string;
+}
+
+export interface IOrderPrices {
+  total_price_no_discount: ICurrencyAmounts;
+  discount_value: ICurrencyAmounts;
+  total_price_before_promo: ICurrencyAmounts;
+  promo_value: ICurrencyAmounts;
+  total_price_after_promo: ICurrencyAmounts;
+  discount_total: ICurrencyAmounts;
+  total_delivery_price_before_promo: ICurrencyAmounts;
+  total_delivery_price_after_promo: ICurrencyAmounts;
+  delivery_discount: ICurrencyAmounts;
+  order_total: ICurrencyAmounts;
+  order_total_paid: ICurrencyAmounts;
+  order_total_paid_left: ICurrencyAmounts;
+  delivery_price_is_estimate: boolean;
+  total_refund_price_to_pay: ICurrencyAmounts;
+  total_refund_price_paid: ICurrencyAmounts;
+}
+
+export interface IOrderShipmentPrices extends ICartDeliveryPrices {
+  delivery_from_total: ICurrencyAmounts;
+  products_refund_price_to_pay: ICurrencyAmounts;
+  options_refund_price_to_pay: ICurrencyAmounts;
+  total_refund_price_to_pay: ICurrencyAmounts;
+}
+
+export interface IOrderLinePrices {
+  products_price_no_discount: ICurrencyAmounts;
+  products_price_before_promo: ICurrencyAmounts;
+  products_price_after_promo: ICurrencyAmounts;
+  options_price_no_discount: ICurrencyAmounts;
+  options_price_before_promo: ICurrencyAmounts;
+  options_price_after_promo: ICurrencyAmounts;
+  total_price_no_discount: ICurrencyAmounts;
+  total_price_before_promo: ICurrencyAmounts;
+  total_price_after_promo: ICurrencyAmounts;
+  products_refund_price_to_pay: ICurrencyAmounts;
+  options_refund_price_to_pay: ICurrencyAmounts;
+  total_refund_price_to_pay: ICurrencyAmounts;
+}
+
+export interface IOrderOptionPrices {
+  options_price_no_discount: ICurrencyAmounts;
+  option_regular_discount_value: ICurrencyAmounts;
+  options_price_before_promo: ICurrencyAmounts;
+  option_promo_discount_value: ICurrencyAmounts;
+  options_price_after_promo: ICurrencyAmounts;
+  options_discount_total: ICurrencyAmounts;
+  refund_price_to_pay: ICurrencyAmounts;
+}
+
+export interface IOrderOption {
+  id: number;
+  quantity: number;
+  product: IProduct | null;
+  refund_allowed: boolean;
+  // null: no return request now. Older backends send `refund_allowed` only.
+  refund_window?: OrderRefundWindow | null;
+  refund_stats: IOrderItemRefundStats;
+  ticket?: ICustomerTicket;
+  prices: IOrderOptionPrices;
+  digital_stock: IOrderDigitalAttachment[];
+}
+
+export interface IOrderOptionGroup {
+  id: number;
+  option_id: number;
+  option_text_data: string;
+  option_file_data: string;
+  option_name: ICartOptionGroup['option_name'];
+  option_type: ICartOptionType | null;
+  option_group_required: boolean;
+  image_url: string | null;
+  option_image: string | null;
+  options: IOrderOption[];
+}
+
+export interface IOrderShipmentItem {
+  id: number;
+  dlf_id: number;
+  order_id: number;
+  quantity: number;
+  prices: IOrderLinePrices;
+  product: IProduct | null;
+  refund_allowed: boolean;
+  // null: no return request now. Older backends send `refund_allowed` only.
+  refund_window?: OrderRefundWindow | null;
+  refund_stats: IOrderItemRefundStats;
+  ticket?: ICustomerTicket;
+  option_groups: IOrderOptionGroup[];
+  digital_stock: IOrderDigitalAttachment[];
+}
+
+export interface IOrderShipmentAddress extends Omit<
+  ICartAddress,
+  'country' | 'state' | 'location'
+> {
+  country: IAddressCountry[] | null;
+  state: IAddressRegion[] | null;
+}
+
+export interface IOrderDeliveryMethod extends IDeliveryType {
+  from_code: string;
+  carrier_code_address: string;
+  carrier_code_hint: string;
+  connection_id: number | '';
+}
+
+export interface IOrderShipment {
+  id: number;
+  order_id: number;
+  delivery_price_is_estimate: boolean;
+  delivery_method: IOrderDeliveryMethod | null;
+  delivery_data:
+    | IOrderShipmentAddress
+    | {
+      delivery_to_code: string;
+      delivery_to_city_code: string;
+      delivery_to_code_full_address: string;
+    }
+    | Record<string, never>;
+  estimate: {
+    delivery_date_from: IApiDateTime | null;
+    delivery_date_to: IApiDateTime | null;
+  };
+  refund_stats: IOrderRefundStats;
+  dates: {
+    sent: IApiDateTime | null;
+    delivery_date_real: IApiDateTime | null;
+    returned_by_carrier?: IApiDateTime | null;
+  };
+  measures: {
+    package_weight: IUnitValues;
+    package_volume: IUnitValues;
+  };
+  store:
+    (Omit<IPhysicalStore, 'virtual_goods'> & {
+      virtual_goods: boolean;
+    }) | null;
+  prices: IOrderShipmentPrices;
+  track: {
+    id: number;
+    track: string;
+    internal_track: string;
+    status: string;
+    date_status_updated: IApiDateTime | null;
+  } | null;
+  shipment_items: IOrderShipmentItem[] | null;
+}
+
+export interface IOrder {
+  id: number;
+  payment: IPaymentMethod | null;
+  prices: IOrderPrices;
+  currency: {
+    id: number | null;
+    rate: number | null;
+  };
+  status: {
+    int: EOrderStatus;
+    text: string;
+  };
+  payment_status: {
+    int: EOrderPaymentStatus;
+    text: string;
+  };
+  refund_stats: IOrderRefundStats;
+  pay_on_delivery: boolean;
+  main_address: Omit<ICartAddress, 'location'>;
+  contact: {
+    full_name: string;
+    phone: string;
+    email: string;
+    id: number;
+    reciever_name?: string;
+    reciever_phone?: string;
+  };
+  delivery_froms: IOrderShipment[] | null;
+  order_self_canceled: boolean;
+  attached_promo?: IPromoDefinition | null;
+  promocode?: string;
+  c_delivery_from_sent: number;
+  c_delivery_from_delivered: number;
+  c_delivery_from: number;
+  cancel_in_minutes: number | null;
+  time_submited: IApiDateTime | null;
+  user_comment: string;
+}
+
+export interface IOrderHistoryResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: {
+    data: IOrder[];
+    rpag: IApiPagination;
+  } | null;
+}

package/templates/interfaces/orionplace/orders/IProductPreorder.ts

@@ -0,0 +1,31 @@
+import type { ApiFormError } from '@/interfaces/orionplace/transport';
+
+export const EPreorderState = {
+  CREATED: 0,
+  PROCESSING: 1,
+  CANCELED: 2,
+  ORDER_CREATED: 3,
+} as const;
+export type EPreorderState =
+  (typeof EPreorderState)[keyof typeof EPreorderState];
+
+export interface IProductPreorderRequest {
+  product: number;
+  email?: string | null;
+  phone?: string | null;
+  currency?: number | null;
+}
+
+export interface IProductPreorderResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: {
+    id: number;
+    product: number;
+    preorder_usd_price: number | string;
+    state: {
+      int: EPreorderState;
+      text: string;
+    };
+  } | null;
+}

package/templates/interfaces/orionplace/payments/IInvoice.ts

@@ -0,0 +1,147 @@
+import type { ApiFormError } from '@/interfaces/orionplace/transport';
+import type {
+  IApiDateTime,
+  IApiPagination,
+  IApiPaginationRequest,
+} from '@/interfaces/orionplace/accounts/IProfileData';
+import type {
+  ICurrencyAmounts,
+  IPaymentMethod,
+} from '@/interfaces/orionplace/cart/ICartData';
+
+export const EInvoiceStatus   = {
+  CANCELED: -4,
+  EXPIRED: -3,
+  FRAUD: -2,
+  FAILED: -1,
+  CREATED: 0,
+  COMPLETED: 1,
+} as const;
+export type EInvoiceStatus =
+  (typeof EInvoiceStatus)[keyof typeof EInvoiceStatus];
+
+export const EPaymentLinkType = {
+  IFRAME: 0,
+  REDIRECT: 1,
+} as const;
+export type EPaymentLinkType =
+  (typeof EPaymentLinkType)[keyof typeof EPaymentLinkType];
+
+export interface IInvoicePaymentMethodsRequest {
+  filters?: {
+    id?: number;
+    payment_name?: string;
+    is_payment_on_delivery?: boolean;
+    is_from_balance_payment?: boolean;
+  };
+}
+
+export interface IInvoicePaymentMethodsResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: IPaymentMethod[] | null;
+}
+
+export interface IInvoiceCreateRequest {
+  payment: number;
+  currency?: number;
+  amount?: number | string;
+}
+
+export interface IInvoiceCreateResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: {
+    link: string;
+    link_type: EPaymentLinkType;
+  } | null;
+}
+
+export interface IInvoiceDirection {
+  from: string;
+  to: string;
+  related_id?: number | null;
+  parent_type?: string;
+  parent_related_id?: number | {
+    id: number;
+    is_staff: boolean;
+    is_admin: boolean;
+  } | null;
+  sub_id?: number;
+  writer_id?: number;
+  manager_id?: number;
+  domain_id?: number;
+}
+
+export interface IInvoiceRefund {
+  id: number;
+  amount: ICurrencyAmounts;
+  status: {
+    int: EInvoiceStatus;
+    text: string;
+  };
+  dates: {
+    created: IApiDateTime;
+  };
+  to_balance: boolean;
+  merchant_transaction_id: string;
+  comment: string;
+}
+
+export interface IInvoice {
+  id: number;
+  order_id: number | null;
+  payment_method: IPaymentMethod | null;
+  merchant_transaction_id: string;
+  comment: string;
+  dates: {
+    created: IApiDateTime;
+    updated: IApiDateTime | null;
+    expiration: IApiDateTime | null;
+  };
+  payment_generated_link: string;
+  link_type: EPaymentLinkType | null;
+  to_refund_account?: string;
+  refund_relations?: {
+    is_refund_for: number | null;
+    has_refund: number | null;
+  };
+  refunds?: IInvoiceRefund[];
+  transaction_direction: IInvoiceDirection | null;
+  transaction_type: string;
+  amount: ICurrencyAmounts;
+  status: {
+    int: EInvoiceStatus;
+    text: string;
+  };
+}
+
+export interface IInvoicesRequest {
+  filters?: {
+    id?: number;
+    invoice_type?: 'wallet' | 'orders' | 'paid_subs' | 'writer_earning';
+    order?: number;
+  };
+  paginate?: IApiPaginationRequest;
+}
+
+export interface IInvoicesResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: {
+    data: IInvoice[];
+    rpag: IApiPagination;
+    counts?: {
+      c_wallet: number;
+      c_order: number;
+      c_paid_sub: number;
+      c_writer_earnings: number;
+    };
+  } | null;
+}
+
+export interface IInvoiceResponse {
+  form_errors: Record<string, ApiFormError[]> | null;
+  success_message: string | null;
+  page_data: IInvoice | null;
+}