loops_sdk 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85549597f27cc413d5ebafb39a9974172a8f2dfc613e6190c8c1a664f964006b
-  data.tar.gz: cd13f142b86862541207dfb9c1ef2531b3712474de3f9320c2649f2fea697fa9
+  metadata.gz: e5cbc02e88853c1dfb986f2d18fc113badcc569865c83c21a58d42809651245c
+  data.tar.gz: d38a4ff09a27e949dcae803cbd9c4f143f32b8dfb7100e6e3cbdc9323d61ccb9
 SHA512:
-  metadata.gz: aae6977f6e8664bb8fb716a28f90be6a6a6ddc5a35a14bb3c9fc9cb0ba54b91847989b36911d03d299e07b04c2e55494f07fb387ccc8bffc494d954c19194c39
-  data.tar.gz: f156ba183d35d9825d85ff949cda127d702f84b7a878a6efae3edc73c901235c89731cdb1435f72623131c42c463ecd0ced1475674a3741c80ab1e8ca4d002db
+  metadata.gz: e9298ac3c8a13c8e207a1c621bd74a5370881537e11a520a85dc2b9ac7a302ece4d2b13a3997c8726b825a474391624d8f5127610823f4dbb5bb75c3bde7b90f
+  data.tar.gz: c3b0de412fea85c5635880c5bdf962164fac8884cd25344b46ad975125dacd89809c541ce4cc921c0e2b304b6204b12fe15455b905479b0593d093126a70c175

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## v0.2.0 - Oct 29, 2024
+
+Added rate limit handling with `RateLimitError`.
+
 ## v0.1.2 - Aug 16, 2024
 
 Support for resetting contact properties with `nil`.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to Loops Ruby SDK
+
+Thank you for your interest in contributing to Loops Ruby SDK. We welcome contributions from the community and are excited to see what you'll bring to the project.
+
+## Getting Started
+
+1. Fork the repository on GitHub.
+2. Clone your fork locally: `git clone <https://github.com/Loops-so/loops-rb.git`>
+3. Create a new branch for your feature or bug fix: `git checkout -b your-branch-name`
+
+## Making Changes
+
+1. Make your changes in your branch.
+2. Follow the coding style and conventions used in the project.
+3. Write clear, concise commit messages.
+4. Test your changes thoroughly.
+
+## Submitting a Pull Request
+
+1. Push your changes to your fork on GitHub.
+2. From your fork, open a pull request in the correct branch of the main repository.
+3. Provide a clear title and description for your pull request using our PR template.
+4. Link any relevant issues in the pull request description.
+
+## Code of Conduct
+
+Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project, you agree to abide by its terms.
+
+## Reporting Bugs
+
+If you find a bug, please open an issue on GitHub. Include as much detail as possible:
+
+- A clear and descriptive title
+- Steps to reproduce the issue
+- Expected behavior
+- Actual behavior
+- Any error messages or screenshots
+
+## Suggesting Enhancements
+
+We welcome suggestions for enhancements! Please open an issue on GitHub with:
+
+- A clear and descriptive title
+- A detailed description of the proposed enhancement
+- Any examples or mock-ups if applicable
+
+## Questions?
+
+If you have any questions, feel free to open an issue or contact the maintainers directly.
+
+Thank you for contributing!

data/README.md

@@ -56,6 +56,29 @@ rescue LoopsSdk::APIError => e
 end
 ```
 
+## Handling rate limits
+
+You can use the check for rate limit issues with your requests.
+
+You can access details about the rate limits from the `limit` and `remaining` attributes.
+
+```ruby
+begin
+
+  response = LoopsSdk::Contacts.update(
+    email: "dan@loops.so"
+  )
+
+  render json: response
+
+rescue LoopsSdk::RateLimitError => e
+  Rails.logger.error("Rate limit exceeded (#{e.limit} requests per second)")
+  # Code here to re-try this request
+rescue LoopsSdk::APIError => e
+  # Handle other errors
+end
+```
+
 ## Default contact properties
 
 Each contact in Loops has a set of default properties. These will always be returned in API results.
@@ -146,8 +169,8 @@ contact_properties = {
   favoriteColor: "Red" /* Custom property */,
 };
 mailing_lists = {
-  list_123: true,
-  list_456: false,
+  cm06f5v0e45nf0ml5754o9cix: true,
+  cm16k73gq014h0mmj5b6jdi9r: false,
 };
 response = LoopsSdk::Contacts.create(
   email: "hello@gmail.com",
@@ -252,7 +275,7 @@ You must use one parameter in the request.
 ```ruby
 response = LoopsSdk::Contacts.find(email: "hello@gmail.com")
 
-response = LoopsSdk::Contacts.find(userId: "12345")
+response = LoopsSdk::Contacts.find(user_id: "12345")
 ```
 
 #### Response
@@ -272,6 +295,9 @@ If no contact is found, an empty list will be returned.
     "subscribed": true,
     "userGroup": "",
     "userId": "12345",
+    "mailingLists": {
+      "cm06f5v0e45nf0ml5754o9cix": true
+    },
     "favoriteColor": "Blue" /* Custom property */
   }
 ]
@@ -281,7 +307,7 @@ If no contact is found, an empty list will be returned.
 
 ### Contacts.delete()
 
-Delete a contact, either by email address or `userId`.
+Delete a contact.
 
 [API Reference](https://loops.so/docs/api-reference/delete-contact)
 
@@ -299,7 +325,7 @@ You must use one parameter in the request.
 ```ruby
 response = LoopsSdk::Contacts.delete(email: "hello@gmail.com")
 
-response = LoopsSdk::Contacts.delete(userId: "12345")
+response = LoopsSdk::Contacts.delete(user_id: "12345")
 ```
 
 #### Response
@@ -340,19 +366,21 @@ response = LoopsSdk::MailingLists.list
 
 #### Response
 
-This method will return a list of mailing list objects containing `id` and `name` attributes.
+This method will return a list of mailing list objects containing `id`, `name` and `isPublic` attributes.
 
 If your account has no mailing lists, an empty list will be returned.
 
 ```json
 [
   {
-    "id": "list_123",
-    "name": "Main list"
+    "id": "cm06f5v0e45nf0ml5754o9cix",
+    "name": "Main list",
+    "isPublic": true
   },
   {
-    "id": "list_456",
-    "name": "Investors"
+    "id": "cm16k73gq014h0mmj5b6jdi9r",
+    "name": "Investors",
+    "isPublic": false
   }
 ]
 ```
@@ -392,8 +420,8 @@ response = LoopsSdk::Events.send(
     signupDate: "2024-03-21T10:09:23Z",
   },
   mailing_lists: {
-    list_123: true,
-    list_456: false,
+    cm06f5v0e45nf0ml5754o9cix: true,
+    cm16k73gq014h0mmj5b6jdi9r: false,
   },
 })
 
@@ -553,4 +581,4 @@ If your account has no custom fields, an empty list will be returned.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/Loops-so/loops-rb.
+Bug reports and pull requests are welcome. Please read our [Contributing Guidelines](CONTRIBUTING.md).

data/lib/loops_sdk/base.rb

@@ -9,6 +9,10 @@ module LoopsSdk
         case response.status
         when 200
           JSON.parse(response.body)
+        when 429
+          limit = response.headers["x-ratelimit-limit"]
+          remaining = response.headers["x-ratelimit-remaining"]
+          raise RateLimitError.new(limit, remaining)
         when 400, 404, 405, 409, 500
           raise APIError.new(response.status, response.body)
         else
@@ -25,8 +29,16 @@ module LoopsSdk
     end
   end
 
-  # The `APIError` class in Ruby represents an error that occurs during an API request with specific
-  # status and response body information.
+  class RateLimitError < StandardError
+    attr_reader :limit, :remaining
+
+    def initialize(limit, remaining)
+      @limit = limit
+      @remaining = remaining
+      super("Rate limit of #{limit} requests per second exceeded.")
+    end
+  end
+
   class APIError < StandardError
     attr_reader :status, :body
 

data/lib/loops_sdk/contacts.rb

@@ -16,7 +16,6 @@ module LoopsSdk
           email: email,
           mailingLists: mailing_lists
         }.merge(properties)
-        puts "Contact Data: #{contact_data.inspect}"
         make_request(:put, "v1/contacts/update", {}, contact_data)
       end
 

data/lib/loops_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LoopsSdk
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loops_sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Dan Rowden
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-08-16 00:00:00.000000000 Z
+date: 2024-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -33,6 +33,8 @@ extra_rdoc_files: []
 files:
 - ".rubocop.yml"
 - CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
 - LICENSE.txt
 - README.md
 - Rakefile