lark-sdk 1.0.4 → 1.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75301a8b5a85b0e4e9f5d8909b174c2d73aedaa31dc0bc0c701282e26658bd3e
-  data.tar.gz: b565c4f3ec287f3337f9daa5019a839ace9a77b6cb47a1274bef5f1cc7fc39a2
+  metadata.gz: a82be7af90cd299952cb37cca92382748d3d01f4e51c2c5feece94044336e265
+  data.tar.gz: 48d5996a439d6edf9b223643752c37e7b4b91426efdb24c736a8826ec8c09ef8
 SHA512:
-  metadata.gz: 8fe5eece689c738d309b647198f326097f6e627253e933d02ecfd3bc137e22defa1e23b366f00e44f487b5f0e690016504f0bfdf3fc9f9d04b938552bca4ab90
-  data.tar.gz: 709a52fa965eece80b44f088737e7e1877cedb094e3e8b2ee93dc2092451001d2effd06bd505fa8ec85dc9d24876d8689cf1ff29255edc145c0644263254d4e1
+  metadata.gz: 0cba05e3b6e79e88709904978b5d4adfa337dbeb70bdd12ed5477d232a321a28a6db71b3615ed224e94c56c4d6f141db8c2e00c53cd7e0f3575b6264bc8300d3
+  data.tar.gz: e0b8f6e09949bdba969e15b05d63b822467ca7071266f757924c8860cdeabed67425bc4b39396eab60ed41de54f090ea06bb2ac8df903a37b2fd46413593b005

data/.gitignore

@@ -8,4 +8,5 @@
 /tmp/
 *.gem
 Gemfile.lock
-.DS_Store
+.DS_Store
+/.vscode/

data/README.md

@@ -29,6 +29,9 @@ Or install it yourself as:
 
 Lark.configure do |config|
   config.redis = Redis.new(url: 'redis://127.0.0.1:6379/1')
+  config.default_app_id = 'xxx'       # 应用 app ID
+  config.default_app_secret = 'xxx'   # 应用 app secret
+  config.default_isv = true           # 自建应用: false, 应用商店应用: true
   # ...
 end
 ```
@@ -37,10 +40,10 @@ end
 
 ```ruby
 api = Lark::Api.new(
-	app_id: 'xxx',
-	app_secret: 'xxx',
-	tenant_key: 'xxx',
-	isv: false/true, # 自建应用: false, 应用商店应用: true
+	app_id: 'xxx',        # default: Lark.config.default_app_id
+	app_secret: 'xxx',    # default: Lark.config.default_app_secret
+	isv: false/true,      # default: Lark.config.default_app_secret
+	tenant_key: 'xxx'     # required while internal app
 )
 ```
 

data/lib/lark.rb

@@ -5,8 +5,8 @@ require 'lark/config'
 require 'lark/cipher'
 require 'lark/helper'
 
-LIB_PATH = "#{File.dirname(__FILE__)}/lark"
-Dir["#{LIB_PATH}/apis/*.rb",  "#{LIB_PATH}/token_store/*.rb"].each { |path| require path }
+lib_path = "#{File.dirname(__FILE__)}/lark"
+Dir["#{lib_path}/apis/**/*.rb",  "#{lib_path}/token_store/*.rb"].each { |path| require path }
 
 require 'lark/api'
 
@@ -15,6 +15,7 @@ module Lark
 
   # Exceptions
   class RedisNotConfigException < RuntimeError; end
+  class AppNotConfigException < RuntimeError; end
   class AccessTokenExpiredError < RuntimeError; end
   class ResultErrorException < RuntimeError; end
   class ResponseError < StandardError

data/lib/lark/api.rb

@@ -3,8 +3,6 @@ require 'lark/request'
 module Lark
   class Api
     include Helper
-    include Apis::Message
-    include Apis::Chat
 
     api_mount :auth
     api_mount :authen
@@ -16,14 +14,22 @@ module Lark
     api_mount :bot
     api_mount :message
     api_mount :image
+    api_mount :mina
+    api_mount :notify
+    api_mount :interactive
+    api_mount :'drive/file'
+    api_mount :'drive/folder'
+    api_mount :'drive/platform'
 
     attr_reader :app_id, :app_secret, :tenant_key, :isv, :options
 
     def initialize options={}
-      @app_id = options.delete(:app_id) || Lark.default_app_id
-      @app_secret = options.delete(:app_secret) || Lark.default_app_secret
+      @app_id = options.delete(:app_id) || Lark.config.default_app_id
+      @app_secret = options.delete(:app_secret) || Lark.config.default_app_secret
+      raise AppNotConfigException if @app_id.nil? || @app_id.empty?
+
       @tenant_key = options.delete(:tenant_key)
-      @isv = options.delete(:isv) || Lark.default_isv
+      @isv = options.delete(:isv) || Lark.config.default_isv
       @options = options
     end
 
@@ -73,12 +79,14 @@ module Lark
 
     def app_token_store
       return @app_token_store if defined?(@app_token_store)
+
       klass = isv ? TokenStore::IsvAppToken : TokenStore::AppToken
       @app_token_store = klass.new(self)
     end
 
     def tenant_token_store
       return @tenant_token_store if defined?(@tenant_token_store)
+
       klass = isv ? TokenStore::IsvTenantToken : TokenStore::TenantToken
       @tenant_token_store = klass.new(self)
     end
@@ -94,5 +102,15 @@ module Lark
       send("#{via}_token_store").fetch_token
       retry unless (tries -= 1).zero?
     end
+
+    class << self
+      def default
+        @default ||= new(
+          app_id: Lark.config.default_app_id,
+          app_secret: Lark.config.default_app_secret,
+          isv: Lark.config.default_isv
+        )
+      end
+    end
   end
-end
+end

data/lib/lark/apis/application.rb

@@ -1,6 +1,10 @@
 module Lark
   module Apis
     module Application
+      def app_admin_user_list
+        get '/user/v4/app_admin_user/list'
+      end
+
       def is_user_admin(params={})
         get 'application/v3/is_user_admin', params: params
       end

data/lib/lark/apis/chat.rb

@@ -39,7 +39,7 @@ module Lark
       end
 
       def update(payload={})
-        get 'chat/v4/update/', payload
+        post 'chat/v4/update/', payload
       end
 
       def chatter_add(chat_id:, user_ids: nil, open_ids: nil)
@@ -63,4 +63,4 @@ module Lark
       end
     end
   end
-end
+end

data/lib/lark/apis/contact.rb

@@ -42,19 +42,21 @@ module Lark
         get 'contact/v1/department/detail/batch_get', params: {department_ids: department_ids}
       end
 
-      def department_user_list(department_id:, offset:, page_size:, fetch_child: false)
+      def department_user_list(department_id:, offset: nil, page_token: nil, page_size:, fetch_child: false)
         get 'contact/v1/department/user/list', params: {
           department_id: department_id,
-          offset: offset,
+          offset: offset, # deprecation
+          page_token: page_token,
           page_size: page_size,
           fetch_child: fetch_child
         }.compact
       end
 
-      def department_user_detail_list(department_id:, offset:, page_size:, fetch_child: false)
+      def department_user_detail_list(department_id:, offset: nil, page_token: nil, page_size:, fetch_child: false)
         get 'contact/v1/department/user/detail/list', params: {
           department_id: department_id,
-          offset: offset,
+          offset: offset, # deprecation
+          page_token: page_token,
           page_size: page_size,
           fetch_child: fetch_child
         }.compact

data/lib/lark/apis/drive/file.rb

@@ -0,0 +1,29 @@
+module Lark
+  module Apis
+    module Drive
+      module File
+        def create(user_access_token:, folder_token:, title:, type:)
+          post "drive/explorer/v2/file/#{folder_token}",
+               { title: title, type: type },
+               access_token: user_access_token
+        end
+
+        def copy(user_access_token:, file_token:, payload:)
+          post "drive/explorer/v2/file/copy/files/#{file_token}",
+               payload,
+               access_token: user_access_token
+        end
+
+        def delete_doc(user_access_token:, token:)
+          delete "drive/explorer/v2/file/docs/#{token}",
+                 access_token: user_access_token
+        end
+
+        def delete_sheet(user_access_token:, token:)
+          delete "drive/explorer/v2/file/spreadsheets/#{token}",
+                 access_token: user_access_token
+        end
+      end
+    end
+  end
+end

data/lib/lark/apis/drive/folder.rb

@@ -0,0 +1,29 @@
+module Lark
+  module Apis
+    module Drive
+      module Folder
+        def create(user_access_token:, folder_token:, title:)
+          post "drive/explorer/v2/folder/#{folder_token}",
+               { title: title },
+               access_token: user_access_token
+        end
+
+        def meta(user_access_token:, folder_token:)
+          get "drive/explorer/v2/folder/#{folder_token}/meta",
+              access_token: user_access_token
+        end
+
+        def root_meta(user_access_token:)
+          get 'drive/explorer/v2/root_folder/meta',
+              access_token: user_access_token
+        end
+
+        def children(user_access_token:, folder_token:, types: nil)
+          get "drive/explorer/v2/folder/#{folder_token}/children",
+              access_token: user_access_token,
+              params: { types: types }.compact
+        end
+      end
+    end
+  end
+end

data/lib/lark/apis/drive/platform.rb

@@ -0,0 +1,19 @@
+module Lark
+  module Apis
+    module Drive
+      module Platform
+        def meta(user_access_token:, request_docs:)
+          post 'suite/docs-api/meta',
+               { request_docs: request_docs },
+               access_token: user_access_token
+        end
+
+        def search(user_access_token:, payload: {})
+          post 'suite/docs-api/search/object',
+               payload,
+               access_token: user_access_token
+        end
+      end
+    end
+  end
+end

data/lib/lark/apis/interactive.rb

@@ -0,0 +1,12 @@
+module Lark
+  module Apis
+    module Interactive
+      def card_update(token:, card:)
+        post 'interactive/v1/card/update', {
+          token: token,
+          card: card
+        }
+      end
+    end
+  end
+end

data/lib/lark/apis/message.rb

@@ -8,6 +8,10 @@ module Lark
       def direct_send(payload)
         post 'message/v4/send/', payload
       end
+
+      def ephemeral_send(payload)
+        post 'ephemeral/v1/send/', payload
+      end
     end
   end
-end
+end

data/lib/lark/apis/mina.rb

@@ -0,0 +1,12 @@
+module Lark
+  module Apis
+    module Mina
+      def token_login_validate(code)
+        request.post 'mina/v2/tokenLoginValidate', {
+          code: code,
+          token: app_access_token
+        }
+      end
+    end
+  end
+end

data/lib/lark/apis/notify.rb

@@ -0,0 +1,9 @@
+module Lark
+  module Apis
+    module Notify
+      def app_notify(payload)
+        post 'notify/v4/appnotify', payload
+      end
+    end
+  end
+end

data/lib/lark/apis/pay.rb

@@ -9,19 +9,11 @@ module Lark
       end
 
       def order_list(params={})
-        get 'pay/v1/order/list', {
-          via: 'app',
-          params: params
-        }
+        get 'pay/v1/order/list', via: 'app', params: params
       end
 
       def order_get(order_id)
-        get 'pay/v1/order/get', {
-          via: 'app',
-          params: {
-            order_id: order_id
-          }
-        }
+        get 'pay/v1/order/get', via: 'app', params: {order_id: order_id}
       end
     end
   end

data/lib/lark/helper.rb

@@ -5,13 +5,13 @@ module Lark
     module ClassMethods
       def api_mount(name)
         class_eval <<-CODE, __FILE__, __LINE__ + 1
-          def #{name}
-            @#{name} ||= Class.new(SimpleDelegator) do
-              include Apis::#{name.to_s.classify}
+          def #{name.to_s.gsub('/', '_')}
+            @#{name.to_s.gsub('/', '_')} ||= Class.new(SimpleDelegator) do
+              include ::Lark::Apis::#{name.to_s.classify}
             end.new(self)
           end
         CODE
       end
     end
   end
-end
+end

data/lib/lark/request.rb

@@ -17,6 +17,7 @@ module Lark
         http.headers(header).get(url, params: params, ssl_context: ssl_context)
       end
     end
+    alias delete get
 
     def post(path, post_body, post_header={})
       request(path, post_header) do |url, header|
@@ -101,4 +102,4 @@ module Lark
       code == 0
     end
   end
-end
+end

data/lib/lark/version.rb

@@ -1,3 +1,3 @@
 module Lark
-  VERSION = '1.0.4'.freeze
+  VERSION = '1.0.16'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lark-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.16
 platform: ruby
 authors:
 - Sean Dong
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-02-22 00:00:00.000000000 Z
+date: 2020-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -119,8 +119,14 @@ files:
 - lib/lark/apis/bot.rb
 - lib/lark/apis/chat.rb
 - lib/lark/apis/contact.rb
+- lib/lark/apis/drive/file.rb
+- lib/lark/apis/drive/folder.rb
+- lib/lark/apis/drive/platform.rb
 - lib/lark/apis/image.rb
+- lib/lark/apis/interactive.rb
 - lib/lark/apis/message.rb
+- lib/lark/apis/mina.rb
+- lib/lark/apis/notify.rb
 - lib/lark/apis/pay.rb
 - lib/lark/apis/user.rb
 - lib/lark/cipher.rb