appstoreserverapi

type AppError = *appError

type Client interface {

	// ApiGetAllSubscriptionStatuses 获取所有的订阅状态
	// Get All Subscription Statuses
	// doc: https://developer.apple.com/documentation/appstoreserverapi/get_all_subscription_statuses
	ApiGetAllSubscriptionStatuses(transactionId string) (*StatusResponse, error)

	// ApiLookUpOrderId 查找订单 ID
	// Look Up Order ID
	// doc: https://developer.apple.com/documentation/appstoreserverapi/look_up_order_id
	ApiLookUpOrderId(orderId string) (*OrderLookupResponse, error)

	// ApiGetTransactionHistory 获取历史交易记录
	// Get Transaction History
	// doc: https://developer.apple.com/documentation/appstoreserverapi/get_transaction_history
	// desc: true then signedTransactions order by webOrderLineItemId desc
	ApiGetTransactionHistory(transactionId string, desc bool) (*HistoryResponse, error)

	// ApiGetRefundHistory 获取退款历史
	// Get Refund History
	// doc: https://developer.apple.com/documentation/appstoreserverapi/get_refund_history
	// desc: true then signedTransactions order by webOrderLineItemId desc
	ApiGetRefundHistory(transactionId string, desc bool) (*RefundLookupResponse, error)

	// ApiExtendAsubscriptionRenewalDate 延长订阅续订日期
	// Extend a Subscription Renewal Date
	// doc: https://developer.apple.com/documentation/appstoreserverapi/extend_a_subscription_renewal_date
	ApiExtendAsubscriptionRenewalDate(transactionId string, req ExtendRenewalDateRequest) (*ExtendRenewalDateResponse, error)

	// ApiSendConsumptionInformation 发送消费信息
	// Send Consumption Information
	// doc: https://developer.apple.com/documentation/appstoreserverapi/send_consumption_information
	ApiSendConsumptionInformation(transactionId string, req ConsumptionRequest) error
}

type Config struct {
	// 发行人: 您在 App Store Connect 中的密钥页面中的发行者 ID（例如：" 57246542-96fe-1a63-e053-0824d011072a"）
	// Issuer: Your issuer ID from the Keys page in App Store Connect (Ex: "57246542-96fe-1a63-e053-0824d011072a")
	Iss string
	// 秘钥：您在 App Store Connect 中的私钥 ID（例如2X9R4HXF34：）
	// Key ID: Your private key ID from App Store Connect (Ex: 2X9R4HXF34)
	Kid string
	// 应用的BundleID（例如：“com.example.testbundleid2021”)
	// Bundle ID: Your app’s bundle ID (Ex: “com.example.testbundleid2021”)
	Bid string
	// 签名的秘钥
	// sign private key, eg:
	/*
		-----BEGIN PRIVATE KEY-----
		MIGTAg23kjjh2h3uhuhfduhJHAKJ23JASjhaskjj234hjHKJHS31hkjj
		-----END PRIVATE KEY-----`
	*/
	Pk string
	// 受众：appstoreconnect-v1
	// Audience: appstoreconnect-v1
	Aud string
	// 有效期：默认是10分钟
	ExpiryIn time.Duration
	// 环境：默认正式环境
	Evn env
	// 重试次数：默认10次
	TryCount uint
	// contains filtered or unexported fields
}

type ConsumptionRequest struct {
	AccountTenure            uint8  `json:"accountTenure"`
	AppAccountToken          string `json:"appAccountToken"`
	ConsumptionStatus        uint8  `json:"consumptionStatus"`
	CustomerConsented        bool   `json:"customerConsented"`
	DeliveryStatus           uint8  `json:"deliveryStatus"`
	LifetimeDollarsPurchased uint8  `json:"lifetimeDollarsPurchased"`
	LifetimeDollarsRefunded  uint8  `json:"lifetimeDollarsRefunded"`
	Platform                 uint8  `json:"platform"`
	PlayTime                 uint8  `json:"playTime"`
	SampleContentProvided    bool   `json:"sampleContentProvided"`
	UserStatus               uint8  `json:"userStatus"`
}

type ExtendRenewalDateRequest struct {
	// 必填。延长订阅续订日期的天数。最大值为 90 天。
	// Required.
	// The number of days to extend the subscription renewal date.
	// The maximum value is 90 days.
	ExtendByDays uint8 `json:"extendByDays"`
	// 必填。订阅日期延长的原因代码。
	// Required.
	// The reason code for the subscription date extension.
	ExtendReasonCode uint8 `json:"extendReasonCode"`
	// 必填。一个字符串，其中包含您提供的用于唯一标识此续订日期扩展请求的值。
	// 字符串的最大长度为 128 个字符。
	// Required.
	// A string that contains a value you provide to uniquely identify this renewal-date-extension request.
	// The maximum length of the string is 128 characters.
	RequestIdentifier string `json:"requestIdentifier"`
}

type ExtendRenewalDateResponse struct {
	EffectiveDate         int64  `json:"effectiveDate"`
	OriginalTransactionId string `json:"originalTransactionId"`
	Success               bool   `json:"success"`
	WebOrderLineItemId    string `json:"webOrderLineItemId"`
	// contains filtered or unexported fields
}

type HistoryResponse struct {
	Revision           string                         `json:"revision"`
	BundleId           string                         `json:"bundleId"`
	AppAppleId         int64                          `json:"appAppleId"`
	Environment        string                         `json:"environment"`
	HasMore            bool                           `json:"hasMore"`
	SignedTransactions []JWSTransactionDecodedPayload `json:"signedTransactions"`
	// contains filtered or unexported fields
}

type JWSRenewalInfoDecodedPayload struct {
	AutoRenewProductId     string `json:"autoRenewProductId,omitempty"`
	AutoRenewStatus        int64  `json:"autoRenewStatus,omitempty"`
	Environment            string `json:"environment,omitempty"`
	ExpirationIntent       int64  `json:"expirationIntent,omitempty"`
	GracePeriodExpiresDate int64  `json:"gracePeriodExpiresDate,omitempty"`
	IsInBillingRetryPeriod bool   `json:"isInBillingRetryPeriod,omitempty"`
	OfferIdentifier        string `json:"offerIdentifier,omitempty"`
	OfferType              int64  `json:"offerType,omitempty"`
	OriginalTransactionId  string `json:"originalTransactionId,omitempty"`
	PriceIncreaseStatus    int64  `json:"priceIncreaseStatus,omitempty"`
	ProductId              string `json:"productId,omitempty"`
	SignedDate             int64  `json:"signedDate,omitempty"`
}

type JWSTransactionDecodedPayload struct {
	AppAccountToken             string `json:"appAccountToken,omitempty"`
	BundleId                    string `json:"bundleId,omitempty"`
	Environment                 string `json:"environment,omitempty"`
	ExpiresDate                 int64  `json:"expiresDate,omitempty"`
	InAppOwnershipType          string `json:"inAppOwnershipType,omitempty"`
	IsUpgraded                  bool   `json:"isUpgraded"`
	OfferIdentifier             string `json:"offerIdentifier"`
	OfferType                   int64  `json:"offerType,omitempty"`
	OriginalPurchaseDate        int64  `json:"originalPurchaseDate,omitempty"`
	OriginalTransactionId       string `json:"originalTransactionId,omitempty"`
	ProductId                   string `json:"productId,omitempty"`
	PurchaseDate                int64  `json:"purchaseDate,omitempty"`
	Quantity                    int64  `json:"quantity,omitempty"`
	RevocationDate              int64  `json:"revocationDate,omitempty"`
	RevocationReason            int64  `json:"revocationReason,omitempty"`
	SignedDate                  int64  `json:"signedDate,omitempty"`
	SubscriptionGroupIdentifier string `json:"subscriptionGroupIdentifier"`
	TransactionId               string `json:"transactionId,omitempty"`
	Type                        string `json:"type,omitempty"`
	WebOrderLineItemId          string `json:"webOrderLineItemId,omitempty"`
}

type LastTransaction struct {
	OriginalTransactionId string                       `json:"originalTransactionId"`
	Status                int64                        `json:"status"`
	SignedTransactionInfo JWSTransactionDecodedPayload `json:"signedTransactionInfo"`
	SignedRenewalInfo     JWSRenewalInfoDecodedPayload `json:"signedRenewalInfo"`
}

type OrderLookupResponse struct {
	Status int64 `json:"status"`
	// 原始数据
	SignedTransactions []JWSTransactionDecodedPayload `json:"signedTransactions"`
	// contains filtered or unexported fields
}

type RefundLookupResponse struct {
	SignedTransactions []JWSTransactionDecodedPayload `json:"signedTransactions"`
	// contains filtered or unexported fields
}

type StatusData struct {
	SubscriptionGroupIdentifier string            `json:"subscriptionGroupIdentifier"`
	LastTransactions            []LastTransaction `json:"lastTransactions"`
}

type StatusResponse struct {
	Environment string       `json:"environment"`
	BundleId    string       `json:"bundleId"`
	AppAppleId  int64        `json:"appAppleId"`
	Data        []StatusData `json:"data"`
	// contains filtered or unexported fields
}