parse-stack 1.4.3 → 1.5.1

data/bin/console

@@ -6,17 +6,8 @@ require 'dotenv'
 require 'byebug'
 Dotenv.load
 
-
 Parse.setup
 
-class Song < Parse::Object
-  property :name
-
-  before_save do
-    self.name = self.name.truncate(60)
-  end
-
-end
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
 

data/lib/parse/api/all.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require_relative '../client'
 require_relative "analytics"
 require_relative "apps"

data/lib/parse/api/analytics.rb

@@ -1,5 +1,5 @@
-
-
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 

data/lib/parse/api/apps.rb

@@ -1,3 +1,5 @@
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 
@@ -5,29 +7,25 @@ module Parse
 
     module Apps
 
-
-      def fetch_app_keys(appid, email, password)
-        headers = {}
-        headers.merge!( { 'X-Parse-Email' => email, 'X-Parse-Password' => password } )
-        request :get, "apps/#{appid}", headers: headers
+      APPS_PATH = "apps"
+      def fetch_app_keys(appid, email, password, headers: {})
+        headers.merge!( { Parse::Protocol::EMAIL => email, Parse::Protocol::PASSWORD => password } )
+        request :get, "#{APPS_PATH}/#{appid}", headers: headers
       end
 
-      def fetch_apps(email, password)
-        headers = {}
-        headers.merge!( { 'X-Parse-Email' => email, 'X-Parse-Password' => password } )
-        request :get, "apps", headers: headers
+      def fetch_apps(email, password, headers: {})
+        headers.merge!( { Parse::Protocol::EMAIL => email, Parse::Protocol::PASSWORD => password } )
+        request :get, APPS_PATH, headers: headers
       end
 
-      def create_app(opts, email, password)
-        headers = {}
-        headers.merge!( { 'X-Parse-Email' => email, 'X-Parse-Password' => password } )
-        request :post, "apps", body: opts, headers: headers
+      def create_app(body, email, password, headers: {})
+        headers.merge!( { Parse::Protocol::EMAIL => email, Parse::Protocol::PASSWORD => password } )
+        request :post, APPS_PATH, body: body, headers: headers
       end
 
-      def update_app(appid, opts, email, password)
-        headers = {}
-        headers.merge!( { 'X-Parse-Email' => email, 'X-Parse-Password' => password } )
-        request :put, "apps/#{appid}", body: opts, headers: headers
+      def update_app(appid, body, email, password, headers: {})
+        headers.merge!( { Parse::Protocol::EMAIL => email, Parse::Protocol::PASSWORD => password } )
+        request :put, "#{APPS_PATH}/#{appid}", body: body, headers: headers
       end
 
 

data/lib/parse/api/batch.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'parallel'
 require 'active_support'
 require 'active_support/core_ext'
@@ -53,7 +56,7 @@ module Parse
     include Enumerable
 
     def client
-      @client ||= Parse::Client.session
+      @client ||= Parse::Client.client
     end
 
     def initialize(reqs = nil)

data/lib/parse/api/cloud_functions.rb

@@ -1,3 +1,5 @@
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 

data/lib/parse/api/config.rb

@@ -1,3 +1,5 @@
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 
@@ -5,7 +7,7 @@ module Parse
     #object fetch methods
     module Config
       attr_accessor :config
-      
+      CONFIG_PATH = "config"
       def config!
         @config = nil
         self.config
@@ -13,13 +15,23 @@ module Parse
 
       def config
         if @config.nil?
-          response = request :get, "config"
+          response = request :get, CONFIG_PATH
           unless response.error?
             @config = response.result["params"]
           end
         end
         @config
       end
+
+      def update_config(params)
+        body = { params: params }
+        response = request :put, CONFIG_PATH, body: body
+        return false if response.error?
+        result = response.result["result"]
+        @config.merge!(params) if result && @config.present?
+        result
+      end
+
     end
 
   end

data/lib/parse/api/files.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'active_support'
 require 'active_support/core_ext'
 
@@ -6,13 +9,13 @@ module Parse
   module API
     #object fetch methods
     module Files
-
+      FILES_PATH = "files"
       # /1/classes/<className>	POST	Creating Objects
       def create_file(fileName, data = {}, content_type = nil)
         headers = {}
         headers.merge!( { Parse::Protocol::CONTENT_TYPE => content_type.to_s } ) if content_type.present?
-        response = request :post, "files/#{fileName}", body: data, headers: headers
-        response.parse_class = "_File".freeze
+        response = request :post, "#{FILES_PATH}/#{fileName}", body: data, headers: headers
+        response.parse_class = Parse::Model::TYPE_FILE
         response
       end
 

data/lib/parse/api/hooks.rb

@@ -1,16 +1,16 @@
-
-
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 
 
   module API
     module Hooks
-      HOOKS_PREFIX = "hooks/".freeze
+      HOOKS_PREFIX = "hooks/"
       TRIGGER_NAMES = [:beforeSave, :afterSave, :beforeDelete, :afterDelete].freeze
       def _verify_trigger(triggerName)
         triggerName = triggerName.to_s.camelize(:lower).to_sym
-        raise "Invalid trigger name #{triggerName}" unless TRIGGER_NAMES.include?(triggerName)
+        raise ArgumentError, "Invalid trigger name #{triggerName}" unless TRIGGER_NAMES.include?(triggerName)
         triggerName
       end
 

data/lib/parse/api/objects.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'active_support'
 require 'active_support/core_ext'
 
@@ -7,7 +10,7 @@ module Parse
     #object fetch methods
     module Objects
 
-      CLASS_PATH_PREFIX = "classes/".freeze
+      CLASS_PATH_PREFIX = "classes/"
       PREFIX_MAP = { installation: "installations", _installation: "installations",
         user: "users", _user: "users",
         role: "roles", _role: "roles",
@@ -39,36 +42,36 @@ module Parse
       end
 
       # /1/classes/<className>	POST	Creating Objects
-      def create_object(className, data = {})
-        response = request :post, uri_path(className) , body: data
+      def create_object(className, body = {}, headers: {}, **opts)
+        response = request :post, uri_path(className) , body: body, headers: headers, opts: opts
         response.parse_class = className if response.present?
         response
       end
 
       # /1/classes/<className>/<objectId>	DELETE	Deleting Objects
-      def delete_object(className, id)
-        response = request :delete, uri_path(className, id)
+      def delete_object(className, id, headers: {}, **opts)
+        response = request :delete, uri_path(className, id), headers: headers, opts: opts
         response.parse_class = className if response.present?
         response
       end
 
       # /1/classes/<className>/<objectId>	GET	Retrieving Objects
-      def fetch_object(className, id, opts = {})
-        response = request :get, uri_path(className, id), opts: opts
+      def fetch_object(className, id, headers: {}, **opts)
+        response = request :get, uri_path(className, id), headers: headers, opts: opts
         response.parse_class = className if response.present?
         response
       end
 
       # /1/classes/<className>	GET	Queries
-      def find_objects(className, query = {}, opts = {})
-        response = request :get, uri_path(className), query: query, opts: opts
+      def find_objects(className, query = {}, headers: {}, **opts)
+        response = request :get, uri_path(className), query: query, headers: headers, opts: opts
         response.parse_class = className if response.present?
         response
       end
 
       # /1/classes/<className>/<objectId>	PUT	Updating Objects
-      def update_object(className, id, data = {})
-        response = request :put, uri_path(className,id) , body: data
+      def update_object(className, id, body = {}, headers: {}, **opts)
+        response = request :put, uri_path(className,id) , body: body, headers: headers, opts: opts
         response.parse_class = className if response.present?
         response
       end

data/lib/parse/api/push.rb

@@ -1,12 +1,14 @@
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 
   module API
     #object fetch methods
     module Push
-
+      PUSH_PATH = "push"
       def push(payload = {})
-        request :post, "push".freeze, body: payload.as_json
+        request :post, PUSH_PATH, body: payload.as_json
       end
 
     end

data/lib/parse/api/schemas.rb

@@ -1,21 +1,22 @@
-
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 
   module API
     #object fetch methods
     module Schema
-      SCHEMA_PREFIX = "schemas/".freeze
+      SCHEMAS_PATH = "schemas"
       def schema(className)
-        request :get, "#{SCHEMA_PREFIX}#{className}"
+        request :get, "#{SCHEMAS_PATH}/#{className}"
       end
 
       def create_schema(className, schema)
-        request :post, "#{SCHEMA_PREFIX}#{className}", body: schema
+        request :post, "#{SCHEMAS_PATH}/#{className}", body: schema
       end
 
       def update_schema(className, schema)
-        request :put, "#{SCHEMA_PREFIX}#{className}", body: schema
+        request :put, "#{SCHEMAS_PATH}/#{className}", body: schema
       end
 
     end #Schema

data/lib/parse/api/sessions.rb

@@ -1,9 +1,19 @@
-
+# encoding: UTF-8
+# frozen_string_literal: true
 
 module Parse
 
   module API
     module Sessions
+      SESSION_PATH_PREFIX = "sessions"
+
+      def fetch_session(session_token, **opts)
+        opts.merge!({use_master_key: false, cache: false})
+        headers = {Parse::Protocol::SESSION_TOKEN => session_token}
+        response = request :get, "#{SESSION_PATH_PREFIX}/me", headers: headers, opts: opts
+        response.parse_class = Parse::Model::CLASS_SESSION
+        response
+      end
 
     end
   end

data/lib/parse/api/users.rb

@@ -1,4 +1,7 @@
+# encoding: UTF-8
+# frozen_string_literal: true
 
+require 'open-uri'
 
 module Parse
 
@@ -6,34 +9,81 @@ module Parse
     module Users
       # Note that Parse::Objects mainly use the objects.rb API since we can
       # detect class names to proper URI handlers
-      USER_PATH_PREFIX = "users".freeze
-      USER_CLASS = "_User".freeze
-      def fetch_user(id)
-        request :get, "#{USER_PATH_PREFIX}/#{id}"
+      USER_PATH_PREFIX = "users"
+      LOGOUT_PATH = "logout"
+      LOGIN_PATH = "login"
+      REQUEST_PASSWORD_RESET = "requestPasswordReset"
+
+      def fetch_user(id, headers: {}, **opts)
+        request :get, "#{USER_PATH_PREFIX}/#{id}", headers: headers, opts: opts
+      end
+
+      def find_users(query = {}, headers: {}, **opts)
+        response = request :get, USER_PATH_PREFIX, query: query, headers: headers, opts: opts
+        response.parse_class = Parse::Model::CLASS_USER
+        response
+      end
+
+      def current_user(session_token, headers: {}, **opts)
+        headers.merge!({Parse::Protocol::SESSION_TOKEN => session_token})
+        response = request :get, "#{USER_PATH_PREFIX}/me", headers: headers, opts: opts
+        response.parse_class = Parse::Model::CLASS_USER
+        response
       end
 
-      def find_users(query = {})
-        response = request :get, "#{USER_PATH_PREFIX}", query: query
-        response.parse_class = USER_CLASS
+      def create_user(body, headers: {}, **opts)
+        headers.merge!({ Parse::Protocol::REVOCABLE_SESSION => '1'})
+        if opts[:session_token].present?
+          headers.merge!({ Parse::Protocol::SESSION_TOKEN => opts[:session_token]})
+        end
+        response = request :post, USER_PATH_PREFIX, body: body, headers: headers, opts: opts
+        response.parse_class = Parse::Model::CLASS_USER
         response
       end
 
-      def fetch_me(query = {})
-        response = request :get, "#{USER_PATH_PREFIX}/me", query: query
-        response.parse_class = USER_CLASS
+      def update_user(id, body = {}, headers: {}, **opts)
+        response = request :put, "#{USER_PATH_PREFIX}/#{id}", body: body, opts: opts
+        response.parse_class = Parse::Model::CLASS_USER
         response
       end
 
-      def update_user(id, body = {})
-        response = request :put, "#{USER_PATH_PREFIX}/#{id}", body: body
-        response.parse_class = USER_CLASS
+      # deleting or unlinking is done by setting the authData of the service name to nil
+      def set_service_auth_data(id, service_name, auth_data, headers: {}, **opts)
+        body = { authData: { service_name => auth_data } }
+        update_user(id, body, opts)
+      end
+
+      def delete_user(id, headers: {}, **opts)
+        request :delete, "#{USER_PATH_PREFIX}/#{id}", headers: headers, opts: opts
+      end
+
+      def request_password_reset(email, **opts)
+        body = {email: email}
+        request :post, REQUEST_PASSWORD_RESET, body: body, opts: opts
+      end
+
+      def login(username, password, headers: {}, **opts)
+        # Probably pass Installation-ID as header
+        query = { username: username, password: password }
+        headers.merge!({ Parse::Protocol::REVOCABLE_SESSION => '1'})
+        # headers.merge!( { Parse::Protocol::INSTALLATION_ID => ''} )
+        response = request :get, LOGIN_PATH, query: query, headers: headers, opts: opts
+        response.parse_class = Parse::Model::CLASS_USER
         response
       end
 
-      def delete_user(id)
-        request :delete, "#{USER_PATH_PREFIX}/#{id}"
+      def logout(session_token, headers: {}, **opts)
+        headers.merge!({ Parse::Protocol::SESSION_TOKEN => session_token})
+        opts.merge!({use_master_key: false, session_token: session_token})
+        request :post, LOGOUT_PATH, headers: headers, opts: opts
       end
 
+      # {username: "", password: "", email: nil} # minimum
+      def signup(username, password, email = nil, body: {}, **opts)
+        body = body.merge({ username: username, password: password })
+        body[:email] = email || body[:email]
+        create_user(body, opts)
+      end
 
 
     end # Users

data/lib/parse/client/authentication.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'faraday'
 require 'faraday_middleware'
 require 'active_support'
@@ -34,10 +37,9 @@ module Parse
       def call!(env)
           # We add the main Parse protocol headers
           headers = {}
-          raise "No Parse Application Id specified for authentication." unless @application_id.present?
+          raise ArgumentError, "No Parse Application Id specified for authentication." unless @application_id.present?
           headers[APP_ID] = @application_id
           headers[API_KEY] = @api_key unless @api_key.blank?
-
           unless @master_key.blank? || env[:request_headers][DISABLE_MASTER_KEY].present?
             headers[MASTER_KEY] = @master_key
           end

data/lib/parse/client/body_builder.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'faraday'
 require 'faraday_middleware'
 require_relative 'response'
@@ -15,7 +18,7 @@ module Parse
       end
 
       include Parse::Protocol
-      HTTP_OVERRIDE = 'X-Http-Method-Override'.freeze
+      HTTP_OVERRIDE = 'X-Http-Method-Override'
 
       # thread-safety
       def call(env)
@@ -29,7 +32,7 @@ module Parse
         # The standard maximum POST request (which is a server setting), is usually set to 20MBs
         if env[:method] == :get && env[:url].to_s.length > 2_000
           env[:request_headers][HTTP_OVERRIDE] = 'GET'
-          env[:request_headers][CONTENT_TYPE] = 'application/x-www-form-urlencoded'.freeze
+          env[:request_headers][CONTENT_TYPE] = 'application/x-www-form-urlencoded'
           env[:body] = env[:url].query
           env[:url].query = nil
           #override
@@ -42,6 +45,11 @@ module Parse
 
         if self.class.logging
             puts "[Request #{env.method.upcase}] #{env[:url]}"
+            env[:request_headers].each do |k,v|
+              next if k == Parse::Protocol::MASTER_KEY
+              puts "[Header] #{k} : #{v}"
+            end
+
             puts "[Request Body] #{env[:body]}"
         end
         @app.call(env).on_complete do |response_env|
@@ -56,7 +64,7 @@ module Parse
 
           begin
             r = Parse::Response.new(response_env.body)
-          rescue Exception => e
+          rescue => e
             r = Parse::Response.new
             r.code = response_env.status
             r.error = "Invalid response for #{env[:method]} #{env[:url]}: #{e}"

data/lib/parse/client/caching.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'faraday'
 require 'faraday_middleware'
 require 'moneta'
@@ -5,7 +8,7 @@ require_relative 'protocol'
 # This is a caching middleware for Parse queries using Moneta.
 module Parse
   module Middleware
-    class CachingError < Exception; end;
+    class CachingError < StandardError; end;
     class Caching < Faraday::Middleware
       include Parse::Protocol
       # Cache-Control: no-cache
@@ -17,9 +20,9 @@ module Parse
          # * 302 - 'Found'
          # * 404 - 'Not Found' - removed
          # * 410 - 'Gone' - removed
-      CACHEABLE_HTTP_CODES = [200, 203, 300, 301, 302].freeze
-      CACHE_CONTROL = 'Cache-Control'.freeze
-      CACHE_EXPIRES_DURATION = 'X-Parse-Stack-Cache-Expires'.freeze
+      CACHEABLE_HTTP_CODES = [200, 203, 300, 301, 302]
+      CACHE_CONTROL = 'Cache-Control'
+      CACHE_EXPIRES_DURATION = 'X-Parse-Stack-Cache-Expires'
 
       class << self
         attr_accessor :enabled, :logging
@@ -60,7 +63,7 @@ module Parse
         # get default caching state
         @enabled = self.class.enabled
         # disable cache for this request if "no-cache" was passed
-        if @request_headers[CACHE_CONTROL] == "no-cache".freeze
+        if @request_headers[CACHE_CONTROL] == "no-cache"
           @enabled = false
         end
 
@@ -80,6 +83,14 @@ module Parse
         url = env.url
         method = env.method
         @cache_key = url.to_s
+
+        if @request_headers.key?(SESSION_TOKEN)
+          session_token = @request_headers[SESSION_TOKEN]
+          @cache_key = "#{session_token}#{@cache_key}" # prefix tokens
+        elsif @request_headers.key?(MASTER_KEY)
+          @cache_key = "mk:#{@cache_key}" # prefix for master key requests
+        end
+
         begin
           if method == :get && @cache_key.present? && @store.key?(@cache_key)
             puts("[Parse::Cache::Hit] >> #{url}") if self.class.logging.present?
@@ -111,7 +122,7 @@ module Parse
           # Only cache GET requests with valid HTTP status codes whose content-length
           # is greater than 20. Otherwise they could be errors, successes and empty result sets.
           if @enabled && method == :get &&  CACHEABLE_HTTP_CODES.include?(response_env.status) &&
-             response_env.present? && response_env.response_headers["content-length".freeze].to_i > 20
+             response_env.present? && response_env.response_headers["content-length"].to_i > 20
                 @store.store(@cache_key, response_env, expires: @expires) # ||= response_env.body
           end # if
           # do something with the response

data/lib/parse/client/protocol.rb

@@ -1,16 +1,22 @@
+# encoding: UTF-8
+# frozen_string_literal: true
 
 # A module to contain all the main constants.
 module Parse
 
   module Protocol
-      HOST          = "api.parse.com".freeze
-      SERVER_URL    = "https://api.parse.com/1/".freeze
-      APP_ID        = 'X-Parse-Application-Id'.freeze
-      API_KEY       = 'X-Parse-REST-API-Key'.freeze
-      MASTER_KEY    = 'X-Parse-Master-Key'.freeze
-      SESSION_TOKEN = 'X-Parse-Session-Token'.freeze
-      CONTENT_TYPE = "Content-Type".freeze
-      CONTENT_TYPE_FORMAT = "application/json; charset=utf-8".freeze
+      HOST              = 'api.parse.com'
+      SERVER_URL        = 'https://api.parse.com/1/'
+      APP_ID            = 'X-Parse-Application-Id'
+      API_KEY           = 'X-Parse-REST-API-Key'
+      MASTER_KEY        = 'X-Parse-Master-Key'
+      SESSION_TOKEN     = 'X-Parse-Session-Token'
+      REVOCABLE_SESSION = 'X-Parse-Revocable-Session'
+      EMAIL             = 'X-Parse-Email'
+      PASSWORD          = 'X-Parse-Password'
+      INSTALLATION_ID   = 'Parse-Installation-Id'
+      CONTENT_TYPE      = 'Content-Type'
+      CONTENT_TYPE_FORMAT = 'application/json; charset=utf-8'
   end
 
 end

data/lib/parse/client/request.rb

@@ -1,3 +1,6 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
 require 'active_support'
 require 'active_support/json'
 
@@ -11,7 +14,7 @@ module Parse
         @tag = 0
         method = method.downcase.to_sym
         unless method == :get || method == :put || method == :post || method == :delete
-          raise "Invalid method #{method} for request : '#{uri}'"
+          raise ArgumentError, "Invalid method #{method} for request : '#{uri}'"
         end
         self.method = method
         self.path = uri