ifeelgoods 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bf7c17becb1a3e9ce87618976d81669828e2bb2cbe0eefd09ebfacf091da4e52
+  data.tar.gz: 10a653a3ad91245f88084ef75db810d01d1170b2b4ef6d1b4d5f06de57264d6c
+SHA512:
+  metadata.gz: df76494d42d616a4c614794bd7bd3031709dce119ccdc1bb6ed6bda63d091d33a8b816501fa80e8921adbf692438033a0ff02c4efe8bfd4eea74e24c827d3946
+  data.tar.gz: ea3ec73481d398d5fe7c4ba7da01fd8930432b0e8edad8a7f2f653c25eaf505ac6e7dc89cd4a542f0225c86d8e651160e82ab32e313e8818bdcbdd39e698c564

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0.1'
+  gem 'pry-byebug'
+  gem 'rubocop', '~> 0.66.0'
+end

data/Gemfile.lock

@@ -0,0 +1,81 @@
+PATH
+  remote: .
+  specs:
+    ifeelgoods (0.0.1)
+      typhoeus (~> 1.0, >= 1.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    byebug (13.0.0)
+      reline (>= 0.6.0)
+    coderay (1.1.3)
+    date (3.5.1)
+    diff-lcs (1.6.2)
+    ethon (0.18.0)
+      ffi (>= 1.15.0)
+      logger
+    ffi (1.17.4-x86_64-linux-gnu)
+    io-console (0.8.2)
+    jaro_winkler (1.5.6)
+    logger (1.7.0)
+    method_source (1.1.0)
+    parallel (1.28.0)
+    parser (3.3.12.0)
+      ast (~> 2.4.1)
+      racc
+    pry (0.16.0)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+      reline (>= 0.6.0)
+    pry-byebug (3.12.0)
+      byebug (~> 13.0)
+      pry (>= 0.13, < 0.17)
+    psych (5.4.0)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (0.66.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      psych (>= 3.1.0)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.6)
+    ruby-progressbar (1.13.0)
+    stringio (3.2.0)
+    typhoeus (1.6.0)
+      ethon (>= 0.18.0)
+    unicode-display_width (1.5.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  ifeelgoods!
+  pry-byebug
+  rake (~> 13.0.1)
+  rspec (~> 3.6, >= 3.6.0)
+  rubocop (~> 0.66.0)
+
+BUNDLED WITH
+   2.4.19

data/README.md

@@ -0,0 +1,167 @@
+# ifeelgoods
+
+Official Ruby SDK for IFeelGoods Fulfillment API
+
+**Package name:** `ifeelgoods`  
+**Module namespace:** `Ifeelgoods::`
+
+## Authentication
+
+The Fulfillment API supports two authentication methods:
+
+### Option 1: API Key + API Secret (Simple, Direct)
+Use this for simple scripts or when you prefer direct authentication:
+
+```ruby
+require 'ifeelgoods'
+
+# Configure the SDK globally
+Ifeelgoods.configure do |config|
+  config.scheme = 'https' # http for testing only [not recommended for production]
+  config.host = 'api.ifeelgoods.com'
+  # Sandbox: config.host = 'api-sandbox.ifeelgoods.com'
+  config.api_key['Api-Key'] = 'YOUR_API_KEY'
+  config.api_key['Api-Secret'] = 'YOUR_API_SECRET'
+  config.debugging = ENV['IFEELGOODS_DEBUG'] == 'true' # Optional: Enable debugging
+end
+
+# All API instances use the configured settings
+accounts_api = Ifeelgoods::AccountsApi.new
+result = accounts_api.get_current_account
+
+puts result.inspect
+```
+
+### Option 2: Bearer Token (Recommended for Production)
+
+Use OAuth2 to exchange API Key + Secret for a bearer token, then cache it to avoid repeated token requests.
+
+**Environment Setup:**
+```bash
+# Set your API credentials
+export IFEELGOODS_API_KEY='your-api-key'
+export IFEELGOODS_API_SECRET='your-api-secret'
+
+# Set OAuth endpoint (defaults to production)
+export IFEELGOODS_OAUTH_URL='https://oauth.ifeelgoods.com'
+# Or for sandbox:
+# export IFEELGOODS_OAUTH_URL='https://oauth-sandbox.ifeelgoods.com'
+```
+
+```ruby
+require 'ifeelgoods'
+require 'net/http'
+require 'json'
+
+class OAuthTokenManager
+  # Default to production OAuth endpoint. Override with IFEELGOODS_OAUTH_URL environment variable.
+  # Production: https://oauth.ifeelgoods.com
+  # Sandbox:    https://oauth-sandbox.ifeelgoods.com
+  DEFAULT_OAUTH_URL = 'https://oauth.ifeelgoods.com'
+
+  def initialize(api_key = nil, api_secret = nil, oauth_url = nil)
+    @api_key = api_key || ENV['IFEELGOODS_API_KEY']
+    @api_secret = api_secret || ENV['IFEELGOODS_API_SECRET']
+    @oauth_url = oauth_url || ENV['IFEELGOODS_OAUTH_URL'] || DEFAULT_OAUTH_URL
+
+    raise 'IFEELGOODS_API_KEY environment variable not set' if @api_key.nil?
+    raise 'IFEELGOODS_API_SECRET environment variable not set' if @api_secret.nil?
+    @token = nil
+    @token_expires_at = nil
+  end
+
+  def access_token
+    # Return cached token if still valid
+    return @token if @token && Time.now < @token_expires_at
+
+    # Fetch new token
+    fetch_new_token
+  end
+
+  private
+
+  def fetch_new_token
+    uri = URI("#{@oauth_url}/oauth/token")
+    
+    request = Net::HTTP::Post.new(uri)
+    request.basic_auth(@api_key, @api_secret)
+    request['Content-Type'] = 'application/x-www-form-urlencoded'
+    request.body = 'grant_type=client_credentials'
+
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = uri.scheme == 'https'
+    response = http.request(request)
+
+    if response.code.to_i == 200
+      data = JSON.parse(response.body)
+      @token = data['access_token']
+      @token_expires_at = Time.now + data['expires_in'] - 60 # Refresh 60s before expiry
+      @token
+    else
+      raise "Failed to get access token: #{response.body}"
+    end
+  end
+end
+
+# Usage
+token_manager = OAuthTokenManager.new  # Reads from environment variables
+
+api_client = Ifeelgoods::ApiClient.new
+api_client.config.host = 'https://api.ifeelgoods.com'
+api_client.config.access_token_getter = -> { token_manager.access_token }
+
+accounts_api = Ifeelgoods::AccountsApi.new(api_client)  # Uses custom API client with token auth
+result = accounts_api.get_current_account
+```
+
+**Benefits of Option 2:**
+- ✅ Token is cached and reused (fewer network requests)
+- ✅ Automatic refresh before expiry
+- ✅ Recommended for production environments
+- ✅ More secure (API credentials stay server-side)
+
+## Installation & Usage
+
+### Install from RubyGems
+
+```shell
+gem install ifeelgoods
+```
+
+Then require it in your code:
+
+```shell
+ruby -e "require 'ifeelgoods'; puts 'SDK loaded successfully'"
+```
+
+### Development: Build & Install Locally
+
+To build and test the SDK from source:
+
+```shell
+cd ruby/generated/fulfillment-sdk
+gem build ifeelgoods.gemspec
+gem install ./ifeelgoods-VERSION.gem
+```
+
+
+## Documentation
+
+Full API documentation is available at:
+
+- **RubyGems:** [ifeelgoods](https://rubygems.org/gems/ifeelgoods)
+- **GitHub Repository:** [ifeelgoods-api-sdks](https://github.com/ifeelgoods/ifeelgoods-api-sdks)
+
+### Explore the SDK Locally
+
+Use IRB to explore available classes and methods:
+
+```ruby
+require 'ifeelgoods'
+
+# List all available API classes
+Ifeelgoods.constants.grep(/Api$/).sort
+
+# Explore a specific API
+Ifeelgoods::AccountsApi.instance_methods(false)
+```

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/docs/Account.md

@@ -0,0 +1,34 @@
+# Ifeelgoods::Account
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  | [optional] |
+| **login** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **email** | **String** |  | [optional] |
+| **phone_number** | **String** |  | [optional] |
+| **roles** | **Array<String>** |  | [optional] |
+| **locale** | **String** |  | [optional] |
+| **timezone** | **String** |  | [optional] |
+| **access_type** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::Account.new(
+  id: 42,
+  login: john.doe@example.com,
+  name: John Doe,
+  email: john.doe@example.com,
+  phone_number: +33612345678,
+  roles: ["fulfillment_api"],
+  locale: fr,
+  timezone: Europe/Paris,
+  access_type: service
+)
+```
+

data/docs/AccountsApi.md

@@ -0,0 +1,84 @@
+# Ifeelgoods::AccountsApi
+
+All URIs are relative to *https://api-sandbox.ifeelgoods.com*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**get_current_account**](AccountsApi.md#get_current_account) | **GET** /fulfillment/v2/accounts/me | Get current account |
+
+
+## get_current_account
+
+> <GetCurrentAccount200Response> get_current_account
+
+Get current account
+
+Use this function to get the details of your current account
+
+### Examples
+
+```ruby
+require 'time'
+require 'ifeelgoods'
+# setup authorization
+Ifeelgoods.configure do |config|
+  # Configure API key authorization: api_key
+  config.api_key['Api-Key'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['Api-Key'] = 'Bearer'
+
+  # Configure Bearer authorization: bearer_auth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure API key authorization: api_secret
+  config.api_key['Api-Secret'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['Api-Secret'] = 'Bearer'
+end
+
+api_instance = Ifeelgoods::AccountsApi.new
+
+begin
+  # Get current account
+  result = api_instance.get_current_account
+  p result
+rescue Ifeelgoods::ApiError => e
+  puts "Error when calling AccountsApi->get_current_account: #{e}"
+end
+```
+
+#### Using the get_current_account_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetCurrentAccount200Response>, Integer, Hash)> get_current_account_with_http_info
+
+```ruby
+begin
+  # Get current account
+  data, status_code, headers = api_instance.get_current_account_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetCurrentAccount200Response>
+rescue Ifeelgoods::ApiError => e
+  puts "Error when calling AccountsApi->get_current_account_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetCurrentAccount200Response**](GetCurrentAccount200Response.md)
+
+### Authorization
+
+[api_key](../README.md#api_key), [bearer_auth](../README.md#bearer_auth), [api_secret](../README.md#api_secret)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/ActivateRedemptionRequest.md

@@ -0,0 +1,18 @@
+# Ifeelgoods::ActivateRedemptionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**ActivateRedemptionRequestData**](ActivateRedemptionRequestData.md) |  |  |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::ActivateRedemptionRequest.new(
+  data: null
+)
+```
+

data/docs/ActivateRedemptionRequestData.md

@@ -0,0 +1,18 @@
+# Ifeelgoods::ActivateRedemptionRequestData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **user** | [**User**](User.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::ActivateRedemptionRequestData.new(
+  user: null
+)
+```
+

data/docs/Address.md

@@ -0,0 +1,32 @@
+# Ifeelgoods::Address
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **line_1** | **String** |  | [optional] |
+| **line_2** | **String** |  | [optional] |
+| **line_3** | **String** |  | [optional] |
+| **line_4** | **String** |  | [optional] |
+| **zipcode** | **String** |  | [optional] |
+| **city** | **String** |  | [optional] |
+| **state** | **String** |  | [optional] |
+| **country** | **String** | ISO-3166 country code (eg. US, FR, GB) | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::Address.new(
+  line_1: Ifeelgoods, Inc,
+  line_2: 550 Hamilton Avenue,
+  line_3: Suite 226,
+  line_4: null,
+  zipcode: 94301,
+  city: Palo Alto,
+  state: California,
+  country: US
+)
+```
+

data/docs/BrandSummary.md

@@ -0,0 +1,24 @@
+# Ifeelgoods::BrandSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Unique identifier that represents the brand (eg. `APP`). | [optional] |
+| **name** | **String** | Brand name (eg. `iTunes`). | [optional] |
+| **status** | **String** |  | [optional] |
+| **url** | **String** | Brand URL (eg. `https://www.ifeelgoods.com`). | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::BrandSummary.new(
+  id: APP,
+  name: iTunes,
+  status: null,
+  url: null
+)
+```
+

data/docs/BudgetLineItem.md

@@ -0,0 +1,30 @@
+# Ifeelgoods::BudgetLineItem
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  | [optional] |
+| **amount** | **String** |  | [optional] |
+| **type** | **String** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **external_id** | **String** |  | [optional] |
+| **description** | **String** |  | [optional] |
+| **creation_datetime** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::BudgetLineItem.new(
+  id: null,
+  amount: null,
+  type: null,
+  status: null,
+  external_id: null,
+  description: null,
+  creation_datetime: null
+)
+```
+

data/docs/CardConsultRedemption200Response.md

@@ -0,0 +1,18 @@
+# Ifeelgoods::CardConsultRedemption200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**CardConsultRedemption200ResponseData**](CardConsultRedemption200ResponseData.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::CardConsultRedemption200Response.new(
+  data: null
+)
+```
+

data/docs/CardConsultRedemption200ResponseData.md

@@ -0,0 +1,20 @@
+# Ifeelgoods::CardConsultRedemption200ResponseData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **card_balance** | **Float** |  | [optional] |
+| **card_currency** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::CardConsultRedemption200ResponseData.new(
+  card_balance: null,
+  card_currency: null
+)
+```
+

data/docs/CardConsultRedemption422Response.md

@@ -0,0 +1,20 @@
+# Ifeelgoods::CardConsultRedemption422Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **error_name** | **String** |  | [optional] |
+| **error_message** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::CardConsultRedemption422Response.new(
+  error_name: unprocessable_entity,
+  error_message: null
+)
+```
+

data/docs/ClientDetails.md

@@ -0,0 +1,40 @@
+# Ifeelgoods::ClientDetails
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **ui_id** | **String** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **billing_location** | **String** |  | [optional] |
+| **contact_email** | **String** |  | [optional] |
+| **contact_phone** | **String** |  | [optional] |
+| **locale** | **String** |  | [optional] |
+| **logo_url** | **String** |  | [optional] |
+| **balance** | **String** | Advertiser remaining budget | [optional] |
+| **balance_currency** | **String** | Advertiser remaining budget currency | [optional] |
+| **budget_alerts** | [**ClientSummaryBudgetAlerts**](ClientSummaryBudgetAlerts.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::ClientDetails.new(
+  id: 237,
+  name: Ifeelgoods, Inc.,
+  ui_id: ifeelgoods-inc,
+  status: enabled,
+  billing_location: US,
+  contact_email: joe@ifeelgoods.com,
+  contact_phone: +33612345678,
+  locale: en,
+  logo_url: //cdn.ifeelgoods.com/media/a308a55a5b865ca43d4eda67dffa188a.png,
+  balance: 1000.00,
+  balance_currency: EUR,
+  budget_alerts: null
+)
+```
+

data/docs/ClientSummary.md

@@ -0,0 +1,40 @@
+# Ifeelgoods::ClientSummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **ui_id** | **String** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **billing_location** | **String** |  | [optional] |
+| **contact_email** | **String** |  | [optional] |
+| **contact_phone** | **String** |  | [optional] |
+| **locale** | **String** |  | [optional] |
+| **logo_url** | **String** |  | [optional] |
+| **balance** | **String** | Advertiser remaining budget | [optional] |
+| **balance_currency** | **String** | Advertiser remaining budget currency | [optional] |
+| **budget_alerts** | [**ClientSummaryBudgetAlerts**](ClientSummaryBudgetAlerts.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::ClientSummary.new(
+  id: 237,
+  name: Ifeelgoods, Inc.,
+  ui_id: ifeelgoods-inc,
+  status: enabled,
+  billing_location: US,
+  contact_email: joe@ifeelgoods.com,
+  contact_phone: +33612345678,
+  locale: en,
+  logo_url: //cdn.ifeelgoods.com/media/a308a55a5b865ca43d4eda67dffa188a.png,
+  balance: 1000.00,
+  balance_currency: EUR,
+  budget_alerts: null
+)
+```
+

data/docs/ClientSummaryBudgetAlerts.md

@@ -0,0 +1,20 @@
+# Ifeelgoods::ClientSummaryBudgetAlerts
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **alert_1** | **Integer** |  | [optional] |
+| **alert_2** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'ifeelgoods'
+
+instance = Ifeelgoods::ClientSummaryBudgetAlerts.new(
+  alert_1: null,
+  alert_2: null
+)
+```
+