client

type AGSError struct {
	StatusCode int
	Message    string
}

type AuthenticationError struct {
	Message string
}

type BadRequestError struct {
	Message string
}

type DevMockRewardClient struct{}

type ForbiddenError struct {
	Message string
}

type HTTPStatusCodeError interface {
	error
	HTTPStatusCode() int
}

type MockRewardClient struct {
	mock.Mock
}

type NotFoundError struct {
	Resource string
}

type RewardClient interface {
	// GrantItemReward grants an item entitlement to a user.
	// This is used for rewards of type "ITEM".
	//
	// Parameters:
	//   - ctx: Context for cancellation and timeout
	//   - namespace: AGS namespace
	//   - userID: User's unique identifier
	//   - itemID: Item code from AGS inventory
	//   - quantity: Number of items to grant
	//
	// Returns error if grant fails after retries.
	GrantItemReward(ctx context.Context, namespace, userID, itemID string, quantity int) error

	// GrantWalletReward credits a user's wallet with virtual currency.
	// This is used for rewards of type "WALLET".
	//
	// Parameters:
	//   - ctx: Context for cancellation and timeout
	//   - namespace: AGS namespace
	//   - userID: User's unique identifier
	//   - currencyCode: Currency code from AGS wallet (e.g., "GOLD", "GEMS")
	//   - amount: Amount of currency to credit
	//
	// Returns error if grant fails after retries.
	GrantWalletReward(ctx context.Context, namespace, userID, currencyCode string, amount int) error

	// GrantReward is a convenience method that dispatches to the appropriate grant method
	// based on the reward type (ITEM or WALLET).
	//
	// Parameters:
	//   - ctx: Context for cancellation and timeout
	//   - namespace: AGS namespace
	//   - userID: User's unique identifier
	//   - reward: Reward configuration from goal
	//
	// Returns error if reward type is unsupported or grant fails after retries.
	GrantReward(ctx context.Context, namespace, userID string, reward domain.Reward) error
}