draftgo-cli 4.0.1 → 4.0.23

package/resources/custom-service-sdk/auth_test.go

@@ -0,0 +1,56 @@
+package sdk
+
+import (
+	"context"
+	"errors"
+	"testing"
+)
+
+type authRecordingClient struct {
+	operation string
+	args      map[string]any
+	err       error
+}
+
+func (client *authRecordingClient) Call(_ context.Context, operation string, args any) (any, error) {
+	client.operation = operation
+	client.args, _ = args.(map[string]any)
+	return true, client.err
+}
+
+func TestAuthAssertionsUseHostAuthorization(t *testing.T) {
+	client := &authRecordingClient{}
+	draftgo := NewContext(context.Background(), nil, map[string]any{
+		"id": float64(7), "is_admin": false, "role_code": "member",
+	}, nil, client)
+
+	if err := draftgo.Auth.RequireAdmin(); err != nil {
+		t.Fatal(err)
+	}
+	if client.operation != "auth.require_admin" {
+		t.Fatalf("operation = %q", client.operation)
+	}
+	if err := draftgo.Auth.RequireRole(" workspace_owner "); err != nil {
+		t.Fatal(err)
+	}
+	if client.operation != "auth.require_role" || client.args["role"] != "workspace_owner" {
+		t.Fatalf("operation=%q args=%#v", client.operation, client.args)
+	}
+
+	client.err = errors.New("denied by host")
+	if err := draftgo.Auth.RequireAdmin(); err == nil || err.Error() != "denied by host" {
+		t.Fatalf("host denial was not returned: %v", err)
+	}
+}
+
+func TestAdminAuthCallCarriesScopedElevation(t *testing.T) {
+	client := &authRecordingClient{}
+	draftgo := NewContext(context.Background(), nil, nil, nil, client)
+
+	if err := draftgo.Admin.Auth.RequireAdmin(); err != nil {
+		t.Fatal(err)
+	}
+	if client.operation != "auth.require_admin" || client.args["__draftgo_admin"] != true {
+		t.Fatalf("operation=%q args=%#v", client.operation, client.args)
+	}
+}

package/resources/custom-service-sdk/billing.go

@@ -0,0 +1,596 @@
+package sdk
+
+import (
+	"context"
+)
+
+// BillingAPI is the stable money/payment/entitlement and AI usage boundary
+// for custom services. Product catalog and checkout rules remain service-owned.
+type BillingAPI interface {
+	CreatePaymentOrder(context.Context, PaymentOrderRequest) (PaymentIntent, error)
+	QueryPaymentOrder(context.Context, string) (PaymentOrder, error)
+	ClosePaymentOrder(context.Context, string) error
+	RefundPaymentOrder(context.Context, RefundRequest) (map[string]any, error)
+	ListPaymentRefunds(context.Context, string) (map[string]any, error)
+	ListPaymentOrders(context.Context, map[string]any) (map[string]any, error)
+	GetAccount(context.Context) (Account, error)
+	ListJournal(context.Context, map[string]any) (map[string]any, error)
+	CreditAccount(context.Context, MoneyOperationRequest) (JournalResult, error)
+	DebitAccount(context.Context, MoneyOperationRequest) (JournalResult, error)
+	HoldFunds(context.Context, MoneyOperationRequest) (HoldResult, error)
+	SettleHold(context.Context, HoldOperationRequest) (JournalResult, error)
+	ReleaseHold(context.Context, HoldOperationRequest) error
+	ReverseJournal(context.Context, ReversalRequest) (JournalResult, error)
+	GrantEntitlement(context.Context, EntitlementGrantRequest) (map[string]any, error)
+	ConsumeEntitlement(context.Context, EntitlementConsumeRequest) (map[string]any, error)
+	RevokeEntitlement(context.Context, EntitlementRevokeRequest) error
+	ListEntitlements(context.Context, BillingSubject, map[string]any) (map[string]any, error)
+	CreatePlan(context.Context, PlanRequest) (Plan, error)
+	GetPlan(context.Context, int64) (Plan, error)
+	ListPlans(context.Context, PlanQuery) ([]Plan, error)
+	UpdatePlan(context.Context, int64, PlanUpdateRequest) (Plan, error)
+	SetPlanStatus(context.Context, int64, string) (Plan, error)
+	CreateSubscription(context.Context, SubscriptionRequest) (Subscription, error)
+	GetSubscription(context.Context, int64) (Subscription, error)
+	ListSubscriptions(context.Context, SubscriptionQuery) ([]Subscription, error)
+	ChangeSubscriptionPlan(context.Context, int64, SubscriptionChangeRequest) (Subscription, error)
+	PauseSubscription(context.Context, int64) (Subscription, error)
+	ResumeSubscription(context.Context, int64) (Subscription, error)
+	CancelSubscription(context.Context, int64) (Subscription, error)
+	FulfillSubscriptionPayment(context.Context, SubscriptionPaymentFulfillmentRequest) (Subscription, error)
+	GetAIPricing(context.Context, map[string]any) (map[string]any, error)
+	ListAIPriceVersions(context.Context, map[string]any) (map[string]any, error)
+	CreateAIPriceVersion(context.Context, AIPriceVersionRequest) (AIPriceVersion, error)
+	EstimateAI(context.Context, AIEstimateRequest) (AIEstimate, error)
+	StartAIBilling(context.Context, AIBillingStartRequest) (AIBillingSession, error)
+	SettleAIBilling(context.Context, AISettlementRequest) (AIBillingSession, error)
+	CancelAIBilling(context.Context, string, string) error
+	GetAIUsage(context.Context, map[string]any) (map[string]any, error)
+	GetAICosts(context.Context, map[string]any) (map[string]any, error)
+}
+
+var _ BillingAPI = billingClient{}
+
+type PaymentOrderRequest struct {
+	BusinessOrderID string         `json:"business_order_id"`
+	ProductRef      string         `json:"product_ref,omitempty"`
+	FulfillmentRef  string         `json:"fulfillment_ref,omitempty"`
+	AmountMinor     int64          `json:"amount_minor"`
+	Provider        string         `json:"provider,omitempty"`
+	Description     string         `json:"description,omitempty"`
+	ReturnURL       string         `json:"return_url,omitempty"`
+	NotifyURL       string         `json:"notify_url,omitempty"`
+	IdempotencyKey  string         `json:"idempotency_key"`
+	Metadata        map[string]any `json:"metadata,omitempty"`
+}
+
+type PaymentIntent struct {
+	OrderID     string         `json:"order_id"`
+	Provider    string         `json:"provider"`
+	Status      string         `json:"status"`
+	AmountMinor int64          `json:"amount_minor"`
+	PayURL      string         `json:"pay_url,omitempty"`
+	QRCode      string         `json:"qr_code,omitempty"`
+	Params      map[string]any `json:"params,omitempty"`
+}
+type PaymentOrder struct {
+	ID              string            `json:"id"`
+	BusinessOrderID string            `json:"business_order_id"`
+	Ownership       ResourceOwnership `json:"ownership"`
+	PayerUserID     int64             `json:"payer_user_id"`
+	CreatedBy       int64             `json:"created_by"`
+	Provider        string            `json:"provider"`
+	ProviderTradeNo string            `json:"provider_trade_no,omitempty"`
+	Status          string            `json:"status"`
+	AmountMinor     int64             `json:"amount_minor"`
+	ProductRef      string            `json:"product_ref,omitempty"`
+	FulfillmentRef  string            `json:"fulfillment_ref,omitempty"`
+	Metadata        map[string]any    `json:"metadata,omitempty"`
+	ExpiresAt       string            `json:"expires_at,omitempty"`
+	PaidAt          string            `json:"paid_at,omitempty"`
+	CreatedAt       string            `json:"created_at,omitempty"`
+	UpdatedAt       string            `json:"updated_at,omitempty"`
+}
+type RefundRequest struct {
+	PaymentOrderID string `json:"payment_order_id"`
+	AmountMinor    int64  `json:"amount_minor,omitempty"`
+	Reason         string `json:"reason,omitempty"`
+	IdempotencyKey string `json:"idempotency_key"`
+}
+type Account struct {
+	BalanceMinor   int64 `json:"balance_minor"`
+	AvailableMinor int64 `json:"available_minor"`
+}
+type MoneyOperationRequest struct {
+	AmountMinor    int64          `json:"amount_minor"`
+	Reference      string         `json:"reference,omitempty"`
+	Reason         string         `json:"reason,omitempty"`
+	IdempotencyKey string         `json:"idempotency_key"`
+	RequestID      string         `json:"request_id,omitempty"`
+	ExpiresAt      string         `json:"expires_at,omitempty"`
+	Metadata       map[string]any `json:"metadata,omitempty"`
+}
+type JournalResult struct {
+	JournalID    string `json:"journal_id"`
+	BalanceMinor int64  `json:"balance_minor"`
+}
+type HoldResult struct {
+	HoldID         string `json:"hold_id"`
+	AmountMinor    int64  `json:"amount_minor"`
+	AvailableMinor int64  `json:"available_minor"`
+}
+type HoldOperationRequest struct {
+	HoldID         string         `json:"hold_id"`
+	AmountMinor    int64          `json:"amount_minor,omitempty"`
+	Reason         string         `json:"reason,omitempty"`
+	IdempotencyKey string         `json:"idempotency_key"`
+	Metadata       map[string]any `json:"metadata,omitempty"`
+}
+type ReversalRequest struct {
+	JournalID      string         `json:"journal_id"`
+	Reason         string         `json:"reason"`
+	IdempotencyKey string         `json:"idempotency_key"`
+	Metadata       map[string]any `json:"metadata,omitempty"`
+}
+type EntitlementGrantRequest struct {
+	Subject        BillingSubject `json:"subject"`
+	Code           string         `json:"code"`
+	Quantity       int64          `json:"quantity"`
+	ExpiresAt      string         `json:"expires_at,omitempty"`
+	SourceRef      string         `json:"source_ref,omitempty"`
+	IdempotencyKey string         `json:"idempotency_key"`
+}
+type EntitlementConsumeRequest struct {
+	Subject        BillingSubject `json:"subject"`
+	Code           string         `json:"code"`
+	Quantity       int64          `json:"quantity"`
+	Reference      string         `json:"reference,omitempty"`
+	IdempotencyKey string         `json:"idempotency_key"`
+}
+type EntitlementRevokeRequest struct {
+	Subject        BillingSubject `json:"subject"`
+	Code           string         `json:"code"`
+	Quantity       int64          `json:"quantity,omitempty"`
+	Reference      string         `json:"reference,omitempty"`
+	IdempotencyKey string         `json:"idempotency_key"`
+}
+
+type BillingSubject struct {
+	Type string `json:"subject_type"`
+	ID   string `json:"subject_id"`
+}
+
+type PlanRequest struct {
+	Code         string         `json:"code"`
+	Name         string         `json:"name"`
+	Status       string         `json:"status,omitempty"`
+	PriceMinor   int64          `json:"price_minor"`
+	BillingCycle string         `json:"billing_cycle"`
+	Entitlements map[string]any `json:"entitlements,omitempty"`
+}
+
+type PlanUpdateRequest struct {
+	Name         *string         `json:"name,omitempty"`
+	Status       *string         `json:"status,omitempty"`
+	PriceMinor   *int64          `json:"price_minor,omitempty"`
+	BillingCycle *string         `json:"billing_cycle,omitempty"`
+	Entitlements *map[string]any `json:"entitlements,omitempty"`
+}
+
+type PlanQuery struct {
+	Status string `json:"status,omitempty"`
+	Search string `json:"search,omitempty"`
+}
+
+type Plan struct {
+	ID           int64          `json:"id"`
+	Code         string         `json:"code"`
+	Name         string         `json:"name"`
+	Status       string         `json:"status"`
+	PriceMinor   int64          `json:"price_minor"`
+	BillingCycle string         `json:"billing_cycle"`
+	Entitlements map[string]any `json:"entitlements"`
+	CreatedAt    string         `json:"created_at"`
+	UpdatedAt    string         `json:"updated_at"`
+}
+
+type SubscriptionRequest struct {
+	PlanID             int64          `json:"plan_id"`
+	Subject            BillingSubject `json:"subject"`
+	CurrentPeriodStart string         `json:"current_period_start,omitempty"`
+	CurrentPeriodEnd   string         `json:"current_period_end,omitempty"`
+	SourceType         string         `json:"source_type,omitempty"`
+	SourceID           string         `json:"source_id,omitempty"`
+	IdempotencyKey     string         `json:"idempotency_key"`
+}
+
+type SubscriptionChangeRequest struct {
+	PlanID             int64  `json:"plan_id"`
+	CurrentPeriodStart string `json:"current_period_start,omitempty"`
+	CurrentPeriodEnd   string `json:"current_period_end,omitempty"`
+}
+
+type SubscriptionPaymentFulfillmentRequest struct {
+	PaymentOrderID string `json:"payment_order_id"`
+	PlanID         int64  `json:"plan_id"`
+}
+
+type SubscriptionQuery struct {
+	PlanID      int64  `json:"plan_id,omitempty"`
+	Status      string `json:"status,omitempty"`
+	SubjectType string `json:"subject_type,omitempty"`
+	SubjectID   string `json:"subject_id,omitempty"`
+}
+
+type Subscription struct {
+	ID                 int64          `json:"id"`
+	PlanID             int64          `json:"plan_id"`
+	Subject            BillingSubject `json:"subject"`
+	CreatedBy          int64          `json:"created_by"`
+	Status             string         `json:"status"`
+	CurrentPeriodStart string         `json:"current_period_start"`
+	CurrentPeriodEnd   string         `json:"current_period_end"`
+	SourceType         string         `json:"source_type"`
+	SourceID           string         `json:"source_id"`
+	IdempotencyKey     string         `json:"idempotency_key"`
+	CreatedAt          string         `json:"created_at"`
+	UpdatedAt          string         `json:"updated_at"`
+}
+
+type AIEstimateRequest struct {
+	ModelID      int64  `json:"model_id,omitempty"`
+	Model        string `json:"model,omitempty"`
+	AgentID      int64  `json:"agent_id,omitempty"`
+	Mode         string `json:"mode,omitempty"`
+	InputTokens  int64  `json:"input_tokens,omitempty"`
+	OutputTokens int64  `json:"output_tokens,omitempty"`
+	Requests     int64  `json:"requests,omitempty"`
+	ImageUnits   int64  `json:"image_units,omitempty"`
+	AudioSeconds int64  `json:"audio_seconds,omitempty"`
+}
+type AIPriceVersionRequest struct {
+	Model                                    string `json:"model_key,omitempty"`
+	Agent                                    string `json:"agent_key,omitempty"`
+	Version                                  string `json:"version"`
+	BillingMode                              string `json:"billing_mode"`
+	BillingEnabled                           bool   `json:"billing_enabled"`
+	InputPriceMinorPerMillion                int64  `json:"input_price_minor_per_million,omitempty"`
+	OutputPriceMinorPerMillion               int64  `json:"output_price_minor_per_million,omitempty"`
+	CachedInputPriceMinorPerMillion          int64  `json:"cached_input_price_minor_per_million,omitempty"`
+	CacheCreationPriceMinorPerMillion        int64  `json:"cache_creation_price_minor_per_million,omitempty"`
+	ImagePriceMinor                          int64  `json:"image_price_minor,omitempty"`
+	AudioPriceMinor                          int64  `json:"audio_price_minor,omitempty"`
+	AudioOutputPriceMinor                    int64  `json:"audio_output_price_minor,omitempty"`
+	RequestPriceMinor                        int64  `json:"request_price_minor,omitempty"`
+	ProviderCostMode                         string `json:"provider_cost_mode,omitempty"`
+	ProviderInputCostMinorPerMillion         int64  `json:"provider_input_cost_minor_per_million,omitempty"`
+	ProviderOutputCostMinorPerMillion        int64  `json:"provider_output_cost_minor_per_million,omitempty"`
+	ProviderCachedInputCostMinorPerMillion   int64  `json:"provider_cached_input_cost_minor_per_million,omitempty"`
+	ProviderCacheCreationCostMinorPerMillion int64  `json:"provider_cache_creation_cost_minor_per_million,omitempty"`
+	ProviderImageCostMinor                   int64  `json:"provider_image_cost_minor,omitempty"`
+	ProviderAudioCostMinor                   int64  `json:"provider_audio_cost_minor,omitempty"`
+	ProviderAudioOutputCostMinor             int64  `json:"provider_audio_output_cost_minor,omitempty"`
+	ProviderRequestCostMinor                 int64  `json:"provider_request_cost_minor,omitempty"`
+}
+type AIPriceVersion struct {
+	ID                                       string `json:"id"`
+	Model                                    string `json:"model_key"`
+	Agent                                    string `json:"agent_key"`
+	Version                                  string `json:"version"`
+	BillingMode                              string `json:"billing_mode"`
+	BillingEnabled                           bool   `json:"billing_enabled"`
+	InputPriceMinorPerMillion                int64  `json:"input_price_minor_per_million"`
+	OutputPriceMinorPerMillion               int64  `json:"output_price_minor_per_million"`
+	CachedInputPriceMinorPerMillion          int64  `json:"cached_input_price_minor_per_million"`
+	CacheCreationPriceMinorPerMillion        int64  `json:"cache_creation_price_minor_per_million"`
+	ImagePriceMinor                          int64  `json:"image_price_minor"`
+	AudioPriceMinor                          int64  `json:"audio_price_minor"`
+	AudioOutputPriceMinor                    int64  `json:"audio_output_price_minor"`
+	RequestPriceMinor                        int64  `json:"request_price_minor"`
+	ProviderCostMode                         string `json:"provider_cost_mode"`
+	ProviderInputCostMinorPerMillion         int64  `json:"provider_input_cost_minor_per_million"`
+	ProviderOutputCostMinorPerMillion        int64  `json:"provider_output_cost_minor_per_million"`
+	ProviderCachedInputCostMinorPerMillion   int64  `json:"provider_cached_input_cost_minor_per_million"`
+	ProviderCacheCreationCostMinorPerMillion int64  `json:"provider_cache_creation_cost_minor_per_million"`
+	ProviderImageCostMinor                   int64  `json:"provider_image_cost_minor"`
+	ProviderAudioCostMinor                   int64  `json:"provider_audio_cost_minor"`
+	ProviderAudioOutputCostMinor             int64  `json:"provider_audio_output_cost_minor"`
+	ProviderRequestCostMinor                 int64  `json:"provider_request_cost_minor"`
+	Status                                   string `json:"status"`
+	EffectiveFrom                            string `json:"effective_from,omitempty"`
+}
+
+type AIEstimate struct {
+	AmountMinor  int64          `json:"amount_minor"`
+	PriceVersion string         `json:"price_version"`
+	Breakdown    map[string]any `json:"breakdown,omitempty"`
+}
+type AIBillingStartRequest struct {
+	IdempotencyKey string         `json:"idempotency_key"`
+	RequestID      string         `json:"request_id,omitempty"`
+	AgentID        int64          `json:"agent_id,omitempty"`
+	ModelID        int64          `json:"model_id,omitempty"`
+	Model          string         `json:"model,omitempty"`
+	EstimatedMinor int64          `json:"estimated_minor,omitempty"`
+	Metadata       map[string]any `json:"metadata,omitempty"`
+}
+type AIBillingSession struct {
+	ID            string `json:"id"`
+	Status        string `json:"status"`
+	ReservedMinor int64  `json:"reserved_minor"`
+	SettledMinor  int64  `json:"settled_minor"`
+	PriceVersion  string `json:"price_version"`
+}
+type AISettlementRequest struct {
+	SessionID      string         `json:"session_id"`
+	Usage          map[string]any `json:"usage"`
+	ActualMinor    int64          `json:"actual_minor,omitempty"`
+	Status         string         `json:"status,omitempty"`
+	IdempotencyKey string         `json:"idempotency_key"`
+	Metadata       map[string]any `json:"metadata,omitempty"`
+}
+
+type billingClient struct{ platformClient }
+
+func (p billingClient) request(ctx context.Context, operation string, args any) (map[string]any, error) {
+	value, err := p.call(ctx, operation, args)
+	return mapResult(value), err
+}
+func (p billingClient) CreatePaymentOrder(ctx context.Context, in PaymentOrderRequest) (PaymentIntent, error) {
+	value, err := p.request(ctx, "billing.payment.create", in)
+	return paymentIntent(value), err
+}
+func (p billingClient) QueryPaymentOrder(ctx context.Context, id string) (PaymentOrder, error) {
+	value, err := p.request(ctx, "billing.payment.query", map[string]any{"order_id": id})
+	return paymentOrder(value), err
+}
+func (p billingClient) ClosePaymentOrder(ctx context.Context, id string) error {
+	_, err := p.request(ctx, "billing.payment.close", map[string]any{"order_id": id})
+	return err
+}
+func (p billingClient) RefundPaymentOrder(ctx context.Context, in RefundRequest) (map[string]any, error) {
+	return p.request(ctx, "billing.payment.refund", in)
+}
+func (p billingClient) ListPaymentRefunds(ctx context.Context, orderID string) (map[string]any, error) {
+	return p.request(ctx, "billing.payment.refunds.list", map[string]any{"payment_order_id": orderID})
+}
+func (p billingClient) ListPaymentOrders(ctx context.Context, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.payment.list", map[string]any{"query": query})
+}
+func (p billingClient) GetAccount(ctx context.Context) (Account, error) {
+	value, err := p.request(ctx, "billing.account.get", map[string]any{})
+	return account(value), err
+}
+func (p billingClient) ListJournal(ctx context.Context, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.journal.list", map[string]any{"query": query})
+}
+func (p billingClient) CreditAccount(ctx context.Context, in MoneyOperationRequest) (JournalResult, error) {
+	value, err := p.request(ctx, "billing.account.credit", in)
+	return journalResult(value), err
+}
+func (p billingClient) DebitAccount(ctx context.Context, in MoneyOperationRequest) (JournalResult, error) {
+	value, err := p.request(ctx, "billing.account.debit", in)
+	return journalResult(value), err
+}
+func (p billingClient) HoldFunds(ctx context.Context, in MoneyOperationRequest) (HoldResult, error) {
+	value, err := p.request(ctx, "billing.account.hold", in)
+	return holdResult(value), err
+}
+func (p billingClient) SettleHold(ctx context.Context, in HoldOperationRequest) (JournalResult, error) {
+	value, err := p.request(ctx, "billing.account.hold.settle", in)
+	return journalResult(value), err
+}
+func (p billingClient) ReleaseHold(ctx context.Context, in HoldOperationRequest) error {
+	_, err := p.request(ctx, "billing.account.hold.release", in)
+	return err
+}
+func (p billingClient) ReverseJournal(ctx context.Context, in ReversalRequest) (JournalResult, error) {
+	value, err := p.request(ctx, "billing.journal.reverse", in)
+	return journalResult(value), err
+}
+func (p billingClient) GrantEntitlement(ctx context.Context, in EntitlementGrantRequest) (map[string]any, error) {
+	return p.request(ctx, "billing.entitlement.grant", in)
+}
+func (p billingClient) ConsumeEntitlement(ctx context.Context, in EntitlementConsumeRequest) (map[string]any, error) {
+	return p.request(ctx, "billing.entitlement.consume", in)
+}
+func (p billingClient) RevokeEntitlement(ctx context.Context, in EntitlementRevokeRequest) error {
+	_, err := p.request(ctx, "billing.entitlement.revoke", in)
+	return err
+}
+func (p billingClient) ListEntitlements(ctx context.Context, subject BillingSubject, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.entitlement.list", map[string]any{"subject_type": subject.Type, "subject_id": subject.ID, "query": query})
+}
+func (p billingClient) CreatePlan(ctx context.Context, in PlanRequest) (Plan, error) {
+	value, err := p.request(ctx, "billing.plan.create", in)
+	return billingPlan(value), err
+}
+func (p billingClient) GetPlan(ctx context.Context, id int64) (Plan, error) {
+	value, err := p.request(ctx, "billing.plan.get", map[string]any{"id": id})
+	return billingPlan(value), err
+}
+func (p billingClient) ListPlans(ctx context.Context, query PlanQuery) ([]Plan, error) {
+	value, err := p.request(ctx, "billing.plan.list", map[string]any{"query": query})
+	return billingPlans(value), err
+}
+func (p billingClient) UpdatePlan(ctx context.Context, id int64, in PlanUpdateRequest) (Plan, error) {
+	value, err := p.request(ctx, "billing.plan.update", map[string]any{"id": id, "data": in})
+	return billingPlan(value), err
+}
+func (p billingClient) SetPlanStatus(ctx context.Context, id int64, status string) (Plan, error) {
+	value, err := p.request(ctx, "billing.plan.status", map[string]any{"id": id, "status": status})
+	return billingPlan(value), err
+}
+func (p billingClient) CreateSubscription(ctx context.Context, in SubscriptionRequest) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.create", in)
+	return billingSubscription(value), err
+}
+func (p billingClient) GetSubscription(ctx context.Context, id int64) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.get", map[string]any{"id": id})
+	return billingSubscription(value), err
+}
+func (p billingClient) ListSubscriptions(ctx context.Context, query SubscriptionQuery) ([]Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.list", map[string]any{"query": query})
+	return billingSubscriptions(value), err
+}
+func (p billingClient) ChangeSubscriptionPlan(ctx context.Context, id int64, in SubscriptionChangeRequest) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.change_plan", map[string]any{"id": id, "data": in})
+	return billingSubscription(value), err
+}
+func (p billingClient) PauseSubscription(ctx context.Context, id int64) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.pause", map[string]any{"id": id})
+	return billingSubscription(value), err
+}
+func (p billingClient) ResumeSubscription(ctx context.Context, id int64) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.resume", map[string]any{"id": id})
+	return billingSubscription(value), err
+}
+func (p billingClient) CancelSubscription(ctx context.Context, id int64) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.cancel", map[string]any{"id": id})
+	return billingSubscription(value), err
+}
+func (p billingClient) FulfillSubscriptionPayment(ctx context.Context, in SubscriptionPaymentFulfillmentRequest) (Subscription, error) {
+	value, err := p.request(ctx, "billing.subscription.fulfill_payment", in)
+	return billingSubscription(value), err
+}
+func (p billingClient) GetAIPricing(ctx context.Context, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.ai.pricing.get", map[string]any{"query": query})
+}
+func (p billingClient) ListAIPriceVersions(ctx context.Context, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.ai.pricing.list", map[string]any{"query": query})
+}
+func (p billingClient) CreateAIPriceVersion(ctx context.Context, in AIPriceVersionRequest) (AIPriceVersion, error) {
+	value, err := p.request(ctx, "billing.ai.pricing.create", in)
+	return aiPriceVersion(value), err
+}
+func (p billingClient) EstimateAI(ctx context.Context, in AIEstimateRequest) (AIEstimate, error) {
+	value, err := p.request(ctx, "billing.ai.estimate", in)
+	return aiEstimate(value), err
+}
+func (p billingClient) StartAIBilling(ctx context.Context, in AIBillingStartRequest) (AIBillingSession, error) {
+	value, err := p.request(ctx, "billing.ai.session.start", in)
+	return aiSession(value), err
+}
+func (p billingClient) SettleAIBilling(ctx context.Context, in AISettlementRequest) (AIBillingSession, error) {
+	value, err := p.request(ctx, "billing.ai.session.settle", in)
+	return aiSession(value), err
+}
+func (p billingClient) CancelAIBilling(ctx context.Context, id, key string) error {
+	_, err := p.request(ctx, "billing.ai.session.cancel", map[string]any{"session_id": id, "idempotency_key": key})
+	return err
+}
+func (p billingClient) GetAIUsage(ctx context.Context, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.ai.usage.list", map[string]any{"query": query})
+}
+func (p billingClient) GetAICosts(ctx context.Context, query map[string]any) (map[string]any, error) {
+	return p.request(ctx, "billing.ai.costs.list", map[string]any{"query": query})
+}
+
+func paymentIntent(v map[string]any) PaymentIntent {
+	return PaymentIntent{OrderID: fmtString(v["order_id"]), Provider: fmtString(v["provider"]), Status: fmtString(v["status"]), AmountMinor: asInt64(v["amount_minor"]), PayURL: fmtString(v["pay_url"]), QRCode: fmtString(v["qr_code"]), Params: mapResult(v["params"])}
+}
+func paymentOrder(v map[string]any) PaymentOrder {
+	return PaymentOrder{
+		ID: fmtString(v["id"]), BusinessOrderID: fmtString(v["business_order_id"]),
+		Ownership: resourceOwnership(v), PayerUserID: asInt64(v["payer_user_id"]), CreatedBy: asInt64(v["created_by"]),
+		Provider: fmtString(v["provider"]), ProviderTradeNo: fmtString(v["provider_trade_no"]),
+		Status: fmtString(v["status"]), AmountMinor: asInt64(v["amount_minor"]),
+		ProductRef: fmtString(v["product_ref"]), FulfillmentRef: fmtString(v["fulfillment_ref"]), Metadata: mapResult(v["metadata"]),
+		ExpiresAt: fmtString(v["expires_at"]), PaidAt: fmtString(v["paid_at"]), CreatedAt: fmtString(v["created_at"]), UpdatedAt: fmtString(v["updated_at"]),
+	}
+}
+func account(v map[string]any) Account {
+	return Account{BalanceMinor: asInt64(v["balance_minor"]), AvailableMinor: asInt64(v["available_minor"])}
+}
+func journalResult(v map[string]any) JournalResult {
+	return JournalResult{JournalID: fmtString(v["journal_id"]), BalanceMinor: asInt64(v["balance_minor"])}
+}
+func holdResult(v map[string]any) HoldResult {
+	return HoldResult{HoldID: fmtString(v["hold_id"]), AmountMinor: asInt64(v["amount_minor"]), AvailableMinor: asInt64(v["available_minor"])}
+}
+func billingPlan(v map[string]any) Plan {
+	return Plan{
+		ID:           asInt64(v["id"]),
+		Code:         fmtString(v["code"]),
+		Name:         fmtString(v["name"]),
+		Status:       fmtString(v["status"]),
+		PriceMinor:   asInt64(v["price_minor"]),
+		BillingCycle: fmtString(v["billing_cycle"]),
+		Entitlements: mapResult(v["entitlements"]),
+		CreatedAt:    fmtString(v["created_at"]),
+		UpdatedAt:    fmtString(v["updated_at"]),
+	}
+}
+func billingPlans(v map[string]any) []Plan {
+	items := mapSlice(v["items"])
+	result := make([]Plan, 0, len(items))
+	for _, item := range items {
+		result = append(result, billingPlan(item))
+	}
+	return result
+}
+func billingSubscription(v map[string]any) Subscription {
+	return Subscription{
+		ID:                 asInt64(v["id"]),
+		PlanID:             asInt64(v["plan_id"]),
+		Subject:            BillingSubject{Type: fmtString(v["subject_type"]), ID: fmtString(v["subject_id"])},
+		CreatedBy:          asInt64(v["created_by"]),
+		Status:             fmtString(v["status"]),
+		CurrentPeriodStart: fmtString(v["current_period_start"]),
+		CurrentPeriodEnd:   fmtString(v["current_period_end"]),
+		SourceType:         fmtString(v["source_type"]),
+		SourceID:           fmtString(v["source_id"]),
+		IdempotencyKey:     fmtString(v["idempotency_key"]),
+		CreatedAt:          fmtString(v["created_at"]),
+		UpdatedAt:          fmtString(v["updated_at"]),
+	}
+}
+func billingSubscriptions(v map[string]any) []Subscription {
+	items := mapSlice(v["items"])
+	result := make([]Subscription, 0, len(items))
+	for _, item := range items {
+		result = append(result, billingSubscription(item))
+	}
+	return result
+}
+func int64Slice(value any) []int64 {
+	switch items := value.(type) {
+	case []int64:
+		return append([]int64(nil), items...)
+	case []any:
+		result := make([]int64, 0, len(items))
+		for _, item := range items {
+			result = append(result, asInt64(item))
+		}
+		return result
+	default:
+		return nil
+	}
+}
+func aiEstimate(v map[string]any) AIEstimate {
+	return AIEstimate{AmountMinor: asInt64(v["amount_minor"]), PriceVersion: fmtString(v["price_version"]), Breakdown: mapResult(v["breakdown"])}
+}
+func aiPriceVersion(v map[string]any) AIPriceVersion {
+	return AIPriceVersion{ID: fmtString(v["id"]), Model: fmtString(v["model_key"]), Agent: fmtString(v["agent_key"]), Version: fmtString(v["version"]), BillingMode: fmtString(v["billing_mode"]), BillingEnabled: asBool(v["billing_enabled"]), InputPriceMinorPerMillion: asInt64(v["input_price_minor_per_million"]), OutputPriceMinorPerMillion: asInt64(v["output_price_minor_per_million"]), CachedInputPriceMinorPerMillion: asInt64(v["cached_input_price_minor_per_million"]), CacheCreationPriceMinorPerMillion: asInt64(v["cache_creation_price_minor_per_million"]), ImagePriceMinor: asInt64(v["image_price_minor"]), AudioPriceMinor: asInt64(v["audio_price_minor"]), AudioOutputPriceMinor: asInt64(v["audio_output_price_minor"]), RequestPriceMinor: asInt64(v["request_price_minor"]), ProviderCostMode: fmtString(v["provider_cost_mode"]), ProviderInputCostMinorPerMillion: asInt64(v["provider_input_cost_minor_per_million"]), ProviderOutputCostMinorPerMillion: asInt64(v["provider_output_cost_minor_per_million"]), ProviderCachedInputCostMinorPerMillion: asInt64(v["provider_cached_input_cost_minor_per_million"]), ProviderCacheCreationCostMinorPerMillion: asInt64(v["provider_cache_creation_cost_minor_per_million"]), ProviderImageCostMinor: asInt64(v["provider_image_cost_minor"]), ProviderAudioCostMinor: asInt64(v["provider_audio_cost_minor"]), ProviderAudioOutputCostMinor: asInt64(v["provider_audio_output_cost_minor"]), ProviderRequestCostMinor: asInt64(v["provider_request_cost_minor"]), Status: fmtString(v["status"]), EffectiveFrom: fmtString(v["effective_from"])}
+}
+func aiSession(v map[string]any) AIBillingSession {
+	return AIBillingSession{ID: fmtString(v["id"]), Status: fmtString(v["status"]), ReservedMinor: asInt64(v["reserved_minor"]), SettledMinor: asInt64(v["settled_minor"]), PriceVersion: fmtString(v["price_version"])}
+}
+func asInt64(v any) int64 {
+	switch n := v.(type) {
+	case int64:
+		return n
+	case int:
+		return int64(n)
+	case float64:
+		return int64(n)
+	case float32:
+		return int64(n)
+	default:
+		return 0
+	}
+}
+func asBool(v any) bool {
+	value, _ := v.(bool)
+	return value
+}