calendly 0.1.2 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f21bb676098bf2f9d6f6e3ea600f7c4017d48207834646b185dbd459a6a8a531
-  data.tar.gz: e5e2accd3cc7145d99b3457f7ed87d79223b3b9fc18e0d49abdeb3a6b75b094f
+  metadata.gz: 7eb04cc45dc6c81f18994d5d821e3afc4013467c58fbebc22e39810b6fccee91
+  data.tar.gz: 5135a1f761cd6e85d24359e80a3e658e640f0834ac5bd3a1169cb96b15e8c256
 SHA512:
-  metadata.gz: ad14b69a614f2f3d39ff993f58b2b5c6f2e5c3a3d74a41b24ac5b17a9a6e915a84f0b99a7282695827d73009019d7ab9c6209a60c1ce8063609f5ab4a1cf5ba1
-  data.tar.gz: 5c5418b39536db9b1d88247e963e9277ae0964eaa64fdd7aabaef9edc29024aa6afed84e4df9b542fd93bf65fd0f311bdc467365bb7ac3097cc2a1a371dd5774
+  metadata.gz: abdc8ba4475063741397bafd3b7bcbba08935817b0c0532d38d3f2b59f87673afd66bf0da99980cacf37f7e1383ac633bb835d710856f16841b656d706ed27d8
+  data.tar.gz: 65d4cc6e0e23e239bd5e3c2cdc65f6cd10bbdc0410d4be146ae3d228e0fb21ed22cd0172c67f18a6e50a42df19da31a88d0e795a580a2e07db2abad23121a68a

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # CHANGELOG
 
+## 0.4.1
+
+- support API
+  - `GET /event_types/{uuid}`
+
+## 0.4.0
+
+- fix changed Location fields such as `kind` to `type`. (refs #18)
+
+## 0.3.0
+
+- remove zeitwerk dependency. (refs #16)
+
+## 0.2.0
+
+- save fetched data in cache. (refs #14)
+
+## 0.1.3
+
+- support webhook APIs (refs #9)
+  - `GET /webhook_subscriptions`
+  - `GET /webhook_subscriptions/{webhook_uuid}`
+  - `POST /webhook_subscriptions`
+  - `DELETE /webhook_subscriptions/{webhook_uuid}`
+
 ## 0.1.2
 
 - fix rubocop warnings.

data/README.md

@@ -5,37 +5,7 @@
 [![Gem Version](https://badge.fury.io/rb/calendly.svg)](http://badge.fury.io/rb/calendly)
 [![license](https://img.shields.io/github/license/koshilife/calendly-api-ruby-client)](https://github.com/koshilife/calendly-api-ruby-client/blob/master/LICENSE.txt)
 
-## About
-
-These client libraries are created for [Calendly v2 APIs](https://calendly.stoplight.io/docs/gh/calendly/api-docs).
-
-As of August 2020, Calendly v2 API is currently undergoing an upgrade.
-This library is trying to follow and support for the upgrade.
-
-As of now the supported statuses each Calendly API are as below.
-
-## Supported statuses each Calendly API
-
-- User
-  - [x] Get basic information about a user
-- EventType
-  - [ ] Get Event Type (This endpoint hasn't been released yet.)
-  - [x] User Event Types
-- Organization
-  - [x] Get Organization Invitation
-  - [x] Get Organization Invitations
-  - [x] Get Organization Membership
-  - [x] Get a list of Organization Memberships
-  - [x] Invite a person to Organization
-  - [x] Remove a User from an Organization
-  - [x] Revoke Organization Invitation
-- ScheduledEvent
-  - [x] Get Event
-  - [x] Get Invitee of an Event
-  - [x] Get List of Event Invitees
-  - [x] Get List of User Events
-- Webhook V2
-  - These endpoints havn't been released yet.
+These client libraries are created for [Calendly v2 APIs](https://calendly.stoplight.io/).
 
 ## Installation
 
@@ -55,6 +25,8 @@ Or install it yourself as:
 
 ## Usage
 
+### Basic
+
 The APIs client needs access token.
 This client setup step is below.
 
@@ -116,7 +88,50 @@ invitation.status
 
 # cancel the invitation
 invitation.delete
+```
+
+### Webhook
+
+The webhook usage is below.
+
+```ruby
+events = ['invitee.created', 'invitee.canceled']
+own_member = client.me.organization_membership
+org = own_member.organization
+
+# create user scope webhook
+url = 'https://example.com/received_event'
+user_webhook = own_member.create_user_scope_webhook(url, events)
+# => #<Calendly::WebhookSubscription uuid:USER_WEBHOOK_001>
+
+# list of user scope webhooks
+own_member.user_scope_webhooks
+# => [#<Calendly::WebhookSubscription uuid:USER_WEBHOOK_001>]
+
+# delete the webhook
+user_webhook.delete
+# => true
 
+
+# create organization scope webhook
+url = 'https://example.com/received_event'
+org_webhook = org.create_webhook(url, events)
+# => #<Calendly::WebhookSubscription uuid:ORG_WEBHOOK_001>
+
+# list of organization scope webhooks
+org.webhooks
+# => [#<Calendly::WebhookSubscription uuid:ORG_WEBHOOK_001>]
+
+# delete the webhook
+org_webhook.delete
+# => true
+```
+
+### Logging
+
+This library supports a configurable logger.
+
+```ruby
 # if the log level set :debug, you can get the request/response information.
 Calendly.configuration.logger.level = :debug
 invitation = my_org.create_invitation('foobar@example.com')
@@ -124,6 +139,8 @@ invitation = my_org.create_invitation('foobar@example.com')
 # D, [2020-08-10T10:48:16] DEBUG -- : Response status:201, body:{"resource":{"created_at":"2020-08-10T10:48:16.051159Z","email":"foobar@example.com","last_sent_at":"2020-08-10T10:48:16.096518Z","organization":"https://api.calendly.com/organizations/ORG001","status":"pending","updated_at":"2020-08-10T10:48:16.051159Z","uri":"https://api.calendly.com/organizations/ORG001/invitations/INV001"}}
 ```
 
+More in-depth method documentation can be found at [RubyDoc.info](https://www.rubydoc.info/gems/calendly/).
+
 ## Contributing
 
 Bug reports and pull requests are welcome on [GitHub](https://github.com/koshilife/calendly-api-ruby-client). This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

data/calendly.gemspec

@@ -29,7 +29,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_runtime_dependency 'oauth2', '>= 1.4.4'
-  spec.add_runtime_dependency 'zeitwerk', '>= 2.3.0'
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'codecov'

data/lib/calendly.rb

@@ -1,9 +1,17 @@
 # frozen_string_literal: true
 
-require 'zeitwerk'
-loader = Zeitwerk::Loader.for_gem
-loader.collapse('**/models')
-loader.setup
+Dir[
+  File.join(
+    File.dirname(__FILE__),
+    'calendly',
+    '**',
+    '*'
+  )
+].sort.each do |f|
+  next if File.directory? f
+
+  require f
+end
 
 # module for Calendly apis client
 module Calendly

data/lib/calendly/api_error.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
+require 'calendly/error'
+
 module Calendly
   # Calendly apis client error object.
-  class ApiError < Calendly::Error
+  class ApiError < Error
     # @return [Faraday::Response]
     attr_reader :response
     # @return [Integer]

data/lib/calendly/client.rb

@@ -59,11 +59,21 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.0.1
     def current_user
-      user
+      return @cached_current_user if @cached_current_user
+
+      @cached_current_user = user
     end
 
     alias me current_user
 
+    # @since 0.2.0
+    def current_user!
+      @cached_current_user = nil
+      current_user
+    end
+
+    alias me! current_user!
+
     #
     # Get basic information about a user
     #
@@ -78,6 +88,20 @@ module Calendly
       User.new body[:resource], self
     end
 
+    #
+    # Returns a single Event Type by its UUID.
+    #
+    # @param [String] uuid the specified event type (event type's uuid).
+    # @return [Calendly::EventType]
+    # @raise [Calendly::Error] if the uuid arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.4.1
+    def event_type(uuid)
+      check_not_empty uuid, 'uuid'
+      body = request :get, "event_types/#{uuid}"
+      EventType.new body[:resource], self
+    end
+
     #
     # Returns all Event Types associated with a specified User.
     #
@@ -125,12 +149,12 @@ module Calendly
     # @param [String] user_uri the specified user (user's uri).
     # @param [Hash] opts the optional request parameters.
     # @option opts [Integer] :count Number of rows to return.
-    # @option opts [String] :invitee_email Return events scheduled with the specified invitee email
+    # @option opts [String] :invitee_email Return events scheduled with the specified invitee email.
     # @option opts [String] :max_start_time Upper bound (inclusive) for an event's start time to filter by.
     # @option opts [String] :min_start_time Lower bound (inclusive) for an event's start time to filter by.
     # @option opts [String] :page_token Pass this to get the next portion of collection.
     # @option opts [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
-    # @option opts [String] :status Whether the scheduled event is active or canceled
+    # @option opts [String] :status Whether the scheduled event is active or canceled.
     # @return [Array<Array<Calendly::Event>, Hash>]
     #  - [Array<Calendly::Event>] events
     #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
@@ -362,6 +386,118 @@ module Calendly
       true
     end
 
+    #
+    # Get a webhook subscription for an organization or user with a specified UUID.
+    #
+    # @param [String] uuid the specified webhook (webhook's uuid).
+    # @return [Calendly::WebhookSubscription]
+    # @raise [Calendly::Error] if the uuid arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def webhook(uuid)
+      check_not_empty uuid, 'uuid'
+      body = request :get, "webhook_subscriptions/#{uuid}"
+      WebhookSubscription.new body[:resource], self
+    end
+
+    #
+    # Get List of organization scope Webhooks.
+    #
+    # @param [String] org_uri the specified organization (organization's uri).
+    # @param [Hash] opts the optional request parameters.
+    # @option opts [Integer] :count Number of rows to return.
+    # @option opts [String] :page_token Pass this to get the next portion of collection.
+    # @option opts [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Array<Calendly::WebhookSubscription>, Hash>]
+    #  - [Array<Calendly::WebhookSubscription>] webhooks
+    #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
+    # @raise [Calendly::Error] if the org_uri arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def webhooks(org_uri, opts = {})
+      check_not_empty org_uri, 'org_uri'
+
+      opts_keys = %i[count page_token sort]
+      params = {organization: org_uri, scope: 'organization'}
+      params = merge_options opts, opts_keys, params
+      body = request :get, 'webhook_subscriptions', params: params
+      items = body[:collection] || []
+      evs = items.map { |item| WebhookSubscription.new item, self }
+      [evs, next_page_params(body)]
+    end
+
+    #
+    # Get List of user scope Webhooks.
+    #
+    # @param [String] org_uri the specified organization (organization's uri).
+    # @param [String] user_uri the specified user (user's uri).
+    # @param [Hash] opts the optional request parameters.
+    # @option opts [Integer] :count Number of rows to return.
+    # @option opts [String] :page_token Pass this to get the next portion of collection.
+    # @option opts [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Array<Calendly::WebhookSubscription>, Hash>]
+    #  - [Array<Calendly::WebhookSubscription>] webhooks
+    #  - [Hash] next_params the parameters to get next data. if thre is no next it returns nil.
+    # @raise [Calendly::Error] if the org_uri arg is empty.
+    # @raise [Calendly::Error] if the user_uri arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def user_scope_webhooks(org_uri, user_uri, opts = {})
+      check_not_empty org_uri, 'org_uri'
+      check_not_empty user_uri, 'user_uri'
+
+      opts_keys = %i[count page_token sort]
+      params = {organization: org_uri, user: user_uri, scope: 'user'}
+      params = merge_options opts, opts_keys, params
+      body = request :get, 'webhook_subscriptions', params: params
+      items = body[:collection] || []
+      evs = items.map { |item| WebhookSubscription.new item, self }
+      [evs, next_page_params(body)]
+    end
+
+    #
+    # Create a webhook subscription for an organization or user.
+    #
+    # @param [String] url Canonical reference (unique identifier) for the resource.
+    # @param [Array<String>] events List of user events to subscribe to. options: invitee.created or invitee.canceled
+    # @param [String] org_uri The unique reference to the organization that the webhook will be tied to.
+    # @param [String] user_uri The unique reference to the user that the webhook will be tied to.
+    # @return [Calendly::WebhookSubscription]
+    # @raise [Calendly::Error] if the url arg is empty.
+    # @raise [Calendly::Error] if the events arg is empty.
+    # @raise [Calendly::Error] if the org_uri arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def create_webhook(url, events, org_uri, user_uri = nil)
+      check_not_empty url, 'url'
+      check_not_empty events, 'events'
+      check_not_empty org_uri, 'org_uri'
+
+      params = {url: url, events: events, organization: org_uri}
+      if user_uri
+        params[:scope] = 'user'
+        params[:user] = user_uri
+      else
+        params[:scope] = 'organization'
+      end
+      body = request(:post, 'webhook_subscriptions', body: params)
+      WebhookSubscription.new body[:resource], self
+    end
+
+    #
+    # Delete a webhook subscription for an organization or user with a specified UUID.
+    #
+    # @param [String] uuid the specified webhook (webhook's uuid).
+    # @return [true]
+    # @raise [Calendly::Error] if the uuid arg is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def delete_webhook(uuid)
+      check_not_empty uuid, 'uuid'
+      request :delete, "webhook_subscriptions/#{uuid}"
+      true
+    end
+
   private
 
     def request(method, path, params: nil, body: nil)
@@ -383,12 +519,13 @@ module Calendly
     end
 
     def check_not_empty(value, name)
-      raise Calendly::Error.new("#{name} is required.") if blank? value
+      raise Error.new("#{name} is required.") if blank? value
     end
 
     def blank?(value)
       return true if value.nil?
       return true if value.to_s.empty?
+      return true if value.is_a?(Array) && value.empty?
 
       false
     end

data/lib/calendly/error.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'calendly/loggable'
+
 module Calendly
   # calendly module's base error object
   class Error < StandardError

data/lib/calendly/loggable.rb

@@ -19,7 +19,7 @@ module Calendly
       log msg, :debug
     end
 
-    private
+  private
 
     def log(msg, level = :info)
       logger = Calendly.configuration.logger

data/lib/calendly/models/event.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+require 'calendly/models/event_type'
+
 module Calendly
   # Calendly's event model.
   # A meeting that has been scheduled
@@ -79,8 +83,16 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.0
     def invitees(opts = {})
+      return @cached_invitees if @cached_invitees
+
       request_proc = proc { |options| client.event_invitees uuid, options }
-      auto_pagination request_proc, opts
+      @cached_invitees = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def invitees!(opts = {})
+      @cached_invitees = nil
+      invitees opts
     end
 
   private

data/lib/calendly/models/event_type.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+
 module Calendly
   # Calendly's event type model.
   # A configuration for a schedulable event

data/lib/calendly/models/invitee.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+require 'calendly/models/event'
+
 module Calendly
   # Calendly's Invitee model.
   # An individual who has been invited to meet with a Calendly member.

data/lib/calendly/models/invitee_question_and_answer.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'calendly/models/model_utils'
+
 module Calendly
   # Calendly's InviteeQuestionAndAnswer model.
   # An individual form question and response.

data/lib/calendly/models/invitee_tracking.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'calendly/models/model_utils'
+
 module Calendly
   # Calendly's InviteeTracking model.
   # Object that represents UTM and Salesforce tracking parameters associated with the invitee.

data/lib/calendly/models/location.rb

@@ -1,52 +1,70 @@
 # frozen_string_literal: true
 
+require 'calendly/models/model_utils'
+
 module Calendly
   # Calendly's location model.
-  # Polymorphic base type for the various supported meeting locations.
+  # The polymorphic base type for an event location that Calendly supports
   class Location
     include ModelUtils
 
+    #
     # data patterns is below:
-    # - 1. A meeting at a pre-specified physical location
-    #  - [String] :kind
-    #  - [String] :location A physical location specified by the meeting publisher.
-    # - 2. Meeting publisher will call the invitee
-    #  - [String] :kind
-    # - 3. Invitee will call meeting publisher at the specified phone number.
-    #  - [String] :kind
-    #  - [String] :phone_number Phone number invitee should use to reach meeting publisher.
-    # - 4. Meeting will take place in a Google Meet / Hangout conference.
-    #  - [String] :kind
-    # - 5. Meeting will take place in a Zoom conference.
-    #  - [String] :kind
-    # - 6. Meeting will take place in a GotoMeeting conference.
-    #  - [String] :kind
-    #  - [String] :external_id Zoom-supplied conference id.
-    #  - [String] :state Current state of the conference in Zoom.
-    #  - [Hash] :data Arbitrary conference metadata supplied by Zoom.
-    # - 7. Arbitrary conference metadata supplied by GotoMeeting.
-    #  - [String] :kind
-    #  - [String] :external_id GotoMeeting-supplied conference id.
-    #  - [String] :state Current state of the conference in GotoMeeting.
-    #  - [String] :data Arbitrary conference metadata supplied by GotoMeeting.
-    # - 8. Meeting location does not fall in a standard category, and is as described by the meeting publisher.
-    #  - [String] :kind
-    #  - [String] :location Location description provided by meeting publisher.
-    # - 9. Meeting location was specified by invitee.
-    #  - [String] :kind
-    #  - [String] :location Meeting location was specified by invitee.
+    #
+    # 1. In-Person Meeting: Information about the physical (in-person) event location.
+    # @param [String] type Indicates that the event host (publisher) will call the invitee.
+    # @param [String] location The physical location specified by the event host (publisher).
+    #
+    # 2. Outbound Call: Meeting publisher will call the Invitee
+    # @param [String] type Indicates that the event host (publisher) will call the invitee.
+    # @param [String] location The phone number the event host (publisher) will use to call the invitee.
+    #
+    # 3. Inbound Call: Invitee will call meeting publisher at the specified phone number.
+    # @param [String] type Indicates that the invitee will call the event host.
+    # @param [String] location The phone number the invitee will use to call the event host (publisher).
+    #
+    # 4. Google Conference: Details about an Event that will take place using a Google Meet / Hangout conference.
+    # @param [String] type The event location is a Google Meet or Hangouts conference.
+    # @param [String] status Indicates the current status of the Google conference.
+    # @param [String] join_url Google conference meeting url.
+    #
+    # 5. Zoom Conference: Meeting will take place in a Zoom conference.
+    # @param [String] type The event location is a Zoom conference
+    # @param [String] status Indicates the current status of the Zoom conference.
+    # @param [String] join_url Zoom meeting url.
+    # @param [Hash] data The conference metadata supplied by Zoom.
+    #
+    # 6. GoToMeeting Conference: Details about an Event that will take place using a GotoMeeting conference
+    # @param [String] type The event location is a GoToMeeting conference.
+    # @param [String] status Indicates the current status of the GoToMeeting conference.
+    # @param [String] join_url GoToMeeting conference meeting url.
+    # @param [Hash] data The conference metadata supplied by GoToMeeting.
+    #
+    # 7. Microsoft Teams Conference:
+    # @param [String] type The event location is a Zoom conference.
+    # @param [String] status Indicates the current status of the Microsoft Teams conference.
+    # @param [String] join_url Microsoft Teams meeting url.
+    # @param [Hash] data The conference metadata supplied by Microsoft Teams.
+    #
+    # 8. Custom Location:
+    # Use this to describe an existing Calendly-supported event location.
+    # @param [String] type The event location doesn't fall into a standard category defined by the event host (publisher).
+    # @param [String] location The event location description provided by the invitee.
+    #
+    # 9. Invitee Specified Location:
+    # Information about an event location that’s specified by the invitee.
+    # @param [String] type The event location selected by the invitee.
+    # @param [String] location The event location description provided by the invitee.
     #
 
     # @return [String]
-    attr_accessor :kind
+    attr_accessor :type
     # @return [String]
     attr_accessor :location
     # @return [String]
-    attr_accessor :phone_number
-    # @return [String]
-    attr_accessor :external_id
+    attr_accessor :status
     # @return [String]
-    attr_accessor :state
+    attr_accessor :join_url
     # @return [Hash]
     attr_accessor :data
   end

data/lib/calendly/models/model_utils.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'time'
+require 'calendly/error'
 
 module Calendly
   # Calendly model utility.
@@ -68,10 +69,10 @@ module Calendly
       attrs.each do |key, value|
         next unless respond_to? "#{key}=".to_sym
 
-        if defined?(self.class::ASSOCIATION) && self.class::ASSOCIATION.key?(key)
+        if value && defined?(self.class::ASSOCIATION) && self.class::ASSOCIATION.key?(key)
           associated_attrs = value.is_a?(Hash) ? value : {uri: value}
           value = self.class::ASSOCIATION[key].new associated_attrs, @client
-        elsif defined?(self.class::TIME_FIELDS) && self.class::TIME_FIELDS.include?(key)
+        elsif value && defined?(self.class::TIME_FIELDS) && self.class::TIME_FIELDS.include?(key)
           value = Time.parse value
         end
         instance_variable_set "@#{key}", value

data/lib/calendly/models/organization.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+
 module Calendly
   # Calendly's organization model.
   class Organization
@@ -25,8 +28,16 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.0
     def memberships(opts = {})
+      return @cached_memberships if @cached_memberships
+
       request_proc = proc { |options| client.memberships uri, options }
-      auto_pagination request_proc, opts
+      @cached_memberships = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def memberships!(opts = {})
+      @cached_memberships = nil
+      memberships opts
     end
 
     #
@@ -44,8 +55,16 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.0
     def invitations(opts = {})
+      return @cached_invitations if @cached_invitations
+
       request_proc = proc { |options| client.invitations uuid, options }
-      auto_pagination request_proc, opts
+      @cached_invitations = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def invitations!(opts = {})
+      @cached_invitations = nil
+      invitations opts
     end
 
     #
@@ -60,5 +79,45 @@ module Calendly
     def create_invitation(email)
       client.create_invitation uuid, email
     end
+
+    #
+    # Get List of organization scope Webhooks associated with self.
+    #
+    # @param [Hash] opts the optional request parameters.
+    # @option opts [Integer] :count Number of rows to return.
+    # @option opts [String] :page_token Pass this to get the next portion of collection.
+    # @option opts [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Calendly::WebhookSubscription>]
+    # @raise [Calendly::Error] if the uri is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def webhooks(opts = {})
+      return @cached_webhooks if @cached_webhooks
+
+      request_proc = proc { |options| client.webhooks uri, options }
+      @cached_webhooks = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def webhooks!(opts = {})
+      @cached_webhooks = nil
+      webhooks opts
+    end
+
+    #
+    # Create a user scope webhook associated with self.
+    #
+    # @param [String] url Canonical reference (unique identifier) for the resource.
+    # @param [Array<String>] events List of user events to subscribe to. options: invitee.created or invitee.canceled
+    # @return [Calendly::WebhookSubscription]
+    # @raise [Calendly::Error] if the url arg is empty.
+    # @raise [Calendly::Error] if the events arg is empty.
+    # @raise [Calendly::Error] if the uri is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def create_webhook(url, events)
+      client.create_webhook url, events, uri
+    end
   end
 end

data/lib/calendly/models/organization_invitation.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+require 'calendly/models/organization'
+require 'calendly/models/user'
+
 module Calendly
   # Calendly's organization invitation model.
   class OrganizationInvitation

data/lib/calendly/models/organization_membership.rb

@@ -1,5 +1,10 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+require 'calendly/models/organization'
+require 'calendly/models/user'
+
 module Calendly
   # Calendly's organization membership model.
   class OrganizationMembership
@@ -52,5 +57,50 @@ module Calendly
     def delete
       client.delete_membership uuid
     end
+
+    #
+    # Get List of user scope Webhooks associated with self.
+    #
+    # @param [Hash] opts the optional request parameters.
+    # @option opts [Integer] :count Number of rows to return.
+    # @option opts [String] :page_token Pass this to get the next portion of collection.
+    # @option opts [String] :sort Order results by the specified field and directin. Accepts comma-separated list of {field}:{direction} values.
+    # Accepts comma-separated list of {field}:{direction} values.
+    # @return [Array<Calendly::WebhookSubscription>]
+    # @raise [Calendly::Error] if the organization.uri is empty.
+    # @raise [Calendly::Error] if the user.uri is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def user_scope_webhooks(opts = {})
+      return @cached_user_scope_webhooks if @cached_user_scope_webhooks
+
+      org_uri = organization.uri if organization
+      user_uri = user.uri if user
+      request_proc = proc { |options| client.user_scope_webhooks org_uri, user_uri, options }
+      @cached_user_scope_webhooks = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def user_scope_webhooks!(opts = {})
+      @cached_user_scope_webhooks = nil
+      user_scope_webhooks opts
+    end
+
+    #
+    # Create a user scope webhook associated with self.
+    #
+    # @param [String] url Canonical reference (unique identifier) for the resource.
+    # @param [Array<String>] events List of user events to subscribe to. options: invitee.created or invitee.canceled
+    # @return [Calendly::WebhookSubscription]
+    # @raise [Calendly::Error] if the url arg is empty.
+    # @raise [Calendly::Error] if the events arg is empty.
+    # @raise [Calendly::Error] if the organization.uri is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def create_user_scope_webhook(url, events)
+      org_uri = organization.uri if organization
+      user_uri = user.uri if user
+      client.create_webhook url, events, org_uri, user_uri
+    end
   end
 end

data/lib/calendly/models/user.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'calendly/client'
+require 'calendly/models/model_utils'
+
 module Calendly
   # Calendly's user model.
   # Primary account details of a specific user.
@@ -57,8 +60,16 @@ module Calendly
     # @raise [Calendly::Error] if the uri is empty.
     # @since 0.1.0
     def organization_membership
+      return @cached_organization_membership if @cached_organization_membership
+
       mems, = client.memberships_by_user uri
-      mems.first
+      @cached_organization_membership = mems.first
+    end
+
+    # @since 0.2.0
+    def organization_membership!
+      @cached_organization_membership = nil
+      organization_membership
     end
 
     #
@@ -74,8 +85,16 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.0
     def event_types(opts = {})
+      return @cached_event_types if @cached_event_types
+
       request_proc = proc { |options| client.event_types uri, options }
-      auto_pagination request_proc, opts
+      @cached_event_types = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def event_types!(opts = {})
+      @cached_event_types = nil
+      event_types opts
     end
 
     #
@@ -95,8 +114,16 @@ module Calendly
     # @raise [Calendly::ApiError] if the api returns error code.
     # @since 0.1.0
     def scheduled_events(opts = {})
+      return @cached_scheduled_events if @cached_scheduled_events
+
       request_proc = proc { |options| client.scheduled_events uri, options }
-      auto_pagination request_proc, opts
+      @cached_scheduled_events = auto_pagination request_proc, opts
+    end
+
+    # @since 0.2.0
+    def scheduled_events!(opts = {})
+      @cached_scheduled_events = nil
+      scheduled_events opts
     end
   end
 end

data/lib/calendly/models/webhook_subscription.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'calendly/client'
+require 'calendly/models/model_utils'
+require 'calendly/models/organization'
+require 'calendly/models/user'
+
+module Calendly
+  # Calendly's webhook model.
+  class WebhookSubscription
+    include ModelUtils
+    UUID_RE = %r{\A#{Client::API_HOST}/webhook_subscriptions/(\w+)\z}.freeze
+    TIME_FIELDS = %i[created_at updated_at retry_started_at].freeze
+    ASSOCIATION = {organization: Organization, user: User, creator: User}.freeze
+
+    # @return [String]
+    # unique id of the WebhookSubscription object.
+    attr_accessor :uuid
+    # @return [String]
+    # Canonical reference (unique identifier) for the webhook.
+    attr_accessor :uri
+    # @return [String]
+    # The callback URL to use when the event is triggered.
+    attr_accessor :callback_url
+    # @return [Time]
+    # The moment when the webhook subscription was created.
+    attr_accessor :created_at
+    # @return [Time]
+    # The moment when the webhook subscription was last updated.
+    attr_accessor :updated_at
+    # @return [Time]
+    # The date and time the webhook subscription is retried.
+    attr_accessor :retry_started_at
+    # @return [String]
+    # Indicates if the webhook subscription is "active" or "disabled".
+    attr_accessor :state
+    # @return [Array<String>]
+    # A list of events to which the webhook is subscribed.
+    attr_accessor :events
+    # @return [String]
+    # The scope of the webhook subscription.
+    attr_accessor :scope
+    # @return [Calendly::Organization]
+    # The organization that's associated with the webhook subscription.
+    attr_accessor :organization
+    # @return [Calendly::User]
+    # The user that's associated with the webhook subscription.
+    attr_accessor :user
+    # @return [Calendly::User]
+    # The user who created the webhook subscription.
+    attr_accessor :creator
+
+    #
+    # Get a webhook subscription associated with self.
+    #
+    # @return [Calendly::WebhookSubscription]
+    # @raise [Calendly::Error] if the uuid is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.3
+    def fetch
+      client.webhook uuid
+    end
+
+    #
+    # Delete a webhook subscription associated with self.
+    #
+    # @return [true]
+    # @raise [Calendly::Error] if the uuid is empty.
+    # @raise [Calendly::ApiError] if the api returns error code.
+    # @since 0.1.0
+    def delete
+      client.delete_webhook uuid
+    end
+  end
+end

data/lib/calendly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Calendly
-  VERSION = '0.1.2'
+  VERSION = '0.4.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: calendly
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.4.1
 platform: ruby
 authors:
 - Kenji Koshikawa
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-09-03 00:00:00.000000000 Z
+date: 2020-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth2
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.4.4
-- !ruby/object:Gem::Dependency
-  name: zeitwerk
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.3.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.3.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -159,6 +145,7 @@ files:
 - lib/calendly/models/organization_invitation.rb
 - lib/calendly/models/organization_membership.rb
 - lib/calendly/models/user.rb
+- lib/calendly/models/webhook_subscription.rb
 - lib/calendly/version.rb
 homepage: https://github.com/koshilife/calendly-api-ruby-client
 licenses:
@@ -167,7 +154,7 @@ metadata:
   homepage_uri: https://github.com/koshilife/calendly-api-ruby-client
   source_code_uri: https://github.com/koshilife/calendly-api-ruby-client
   changelog_uri: https://github.com/koshilife/calendly-api-ruby-client/blob/master/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/calendly/0.1.2
+  documentation_uri: https://www.rubydoc.info/gems/calendly/0.4.1
 post_install_message: 
 rdoc_options: []
 require_paths: