notion 1.0.6 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04355fc0473c8f446e79ec4904105c0fb4fcb8a436032099e59d41ce6abbc9fc
-  data.tar.gz: df7cf2d629fcd8c9dcf076a3186c2d49deef0f73454c051a2ad5530ffa98501d
+  metadata.gz: a6dfa3bb58bd4850c061ed6cf0efbb11ad3548f9dbcfb773b04fdb36d99cf356
+  data.tar.gz: 1be5e4c8dc4975fc2de62bc802b296b283cff406a943d3f5fa88980ecfa07b65
 SHA512:
-  metadata.gz: 2359d17e2408b50b04a3ae1c9b4015de93b4e7d92b06a5b64d6cc8af48380e2affa7e4eb17d20e35def404116bdecef838bd9ec19c9c39867c05116de02eca40
-  data.tar.gz: febb7a95cc0bd70c59e921a6479b4e4f7c80b6ad1443366aef0658358877876a04b37f9993827e15fe6d9eb0386efb7fa082063b0e6758e8ddeead1bb9dd5aa2
+  metadata.gz: 6291929f81e39755067265260f3ff94d4e691f420713af7cb7a1b7505a9ab097bdd78720bcc2d344df555cc20b106203aae0bd09eea52a041e8c4a8057b9b4a8
+  data.tar.gz: de33fa730ee063bb6e54877ce959e1ca7f8bde1345ae90db9c1a368e8c08ad37dec54f473d99c38c6bc26f3e97e17741bba92e3b09cd1d6cb64b5fdce629723b

data/README.md

@@ -310,8 +310,12 @@ From here, you can instantiate the Notion Client with the following code:
 )
 ```
 ### Retrieve a full-page Collection View
-Currently, either a "normal" Page URL or the Page Block ID is accepted to the `get_page` method. Therefore, if you pass the full URL to the CV Table, it will raise an error:
-```text
-the URL or ID passed to the get_page method must be that of a Page Block.
+A full-page collection view must have a URL that follows the below pattern:
+https://www.notion.so/danmurphy/[page-id]?v=[view-id]
+Then, it can be retrieved with the following code:
+```ruby
+>>> @client = NotionAPI::Client.new(
+  "<insert_v2_token_here>"
+)
+>>> @client.get_page("https://www.notion.so/danmurphy/[page-id]?v=[view-id]")
 ```
-To avoid this, you must pass only the ID of the full-page collection-view to the `get_page` method. This is next up on the features list, so passing the full URL will be supported soon:smile:

data/lib/notion_api/core.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-require_relative 'utils'
-require 'httparty'
+require_relative "utils"
+require "httparty"
 
 module NotionAPI
   # the initial methods available to an instantiated Cloent object are defined
   class Core
     include Utils
-    @options = { 'cookies' => { :token_v2 => nil, 'x-active-user-header' => nil }, 'headers' => { 'Content-Type' => 'application/json' } }
-    @type_whitelist = 'divider'
+    @options = { "cookies" => { :token_v2 => nil, "x-active-user-header" => nil }, "headers" => { "Content-Type" => "application/json" } }
+    @type_whitelist = "divider"
 
     class << self
       attr_reader :options, :type_whitelist, :token_v2, :active_user_header
@@ -30,39 +30,16 @@ module NotionAPI
         pageId: clean_id,
         chunkNumber: 0,
         limit: 100,
-        verticalColumns: false
+        verticalColumns: false,
       }
-      jsonified_record_response = get_all_block_info(clean_id, request_body)
-      i = 0
-      while jsonified_record_response.empty? || jsonified_record_response['block'].empty?
-        return {} if i >= 10
+      jsonified_record_response = get_all_block_info(request_body)
 
-        jsonified_record_response = get_all_block_info(clean_id, request_body)
-        i += 1
-      end
-
-      block_id = clean_id
       block_type = extract_type(clean_id, jsonified_record_response)
       block_parent_id = extract_parent_id(clean_id, jsonified_record_response)
 
-      raise 'the URL or ID passed to the get_page method must be that of a Page Block.' if !['collection_view_page', 'page'].include?(block_type)
-
-      if block_type == "page"
-        block_title = extract_title(clean_id, jsonified_record_response)
-        PageBlock.new(block_id, block_title, block_parent_id)
-      elsif block_type == "collection_view_page"
-        collection_id = extract_collection_id(block_id, jsonified_record_response)
-        block_title = extract_collection_title(clean_id, collection_id, jsonified_record_response)
-        view_id = extract_view_ids(block_id, jsonified_record_response)[0]
-        schema = extract_collection_schema(collection_id, view_id, jsonified_record_response)
-        column_mappings = schema.keys
-        column_names = column_mappings.map { |mapping| schema[mapping]['name']}
-
-        collection_view_page = CollectionViewPage.new(block_id, block_title, block_parent_id, collection_id, view_id)
-        collection_view_page.instance_variable_set(:@column_names, column_names)
-        CollectionView.class_eval{attr_reader :column_names}
-        collection_view_page
-      end
+      raise ArgumentError, "the URL or ID passed to the get_page method must be that of a Page Block." if !["collection_view_page", "page"].include?(block_type)
+
+      get_instantiated_instance_for(block_type, clean_id, block_parent_id, jsonified_record_response)
     end
 
     def children(url_or_id = @id)
@@ -87,18 +64,12 @@ module NotionAPI
         pageId: clean_id,
         chunkNumber: 0,
         limit: 100,
-        verticalColumns: false
+        verticalColumns: false,
       }
-      jsonified_record_response = get_all_block_info(clean_id, request_body)
-      i = 0
-      while jsonified_record_response.empty?
-        return {} if i >= 10
+      jsonified_record_response = get_all_block_info(request_body)
 
-        jsonified_record_response = get_all_block_info(clean_id, request_body)
-        i += 1
-      end
-
-      jsonified_record_response['block'][clean_id]['value']['content'] || []
+      # if no content, returns empty list
+      jsonified_record_response["block"][clean_id]["value"]["content"] || []
     end
 
     private
@@ -106,19 +77,19 @@ module NotionAPI
     def get_notion_id(body)
       # ! retrieves a users ID from the headers of a Notion response object.
       # ! body -> the body to send in the request : ``Hash``
-      Core.options['cookies'][:token_v2] = @@token_v2
-      Core.options['headers']['x-notion-active-user-header'] = @@active_user_header
-      cookies = Core.options['cookies']
-      headers = Core.options['headers']
+      Core.options["cookies"][:token_v2] = @@token_v2
+      Core.options["headers"]["x-notion-active-user-header"] = @@active_user_header
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
       request_url = URLS[:GET_BLOCK]
 
       response = HTTParty.post(
         request_url,
         body: body.to_json,
         cookies: cookies,
-        headers: headers
+        headers: headers,
       )
-      response.headers['x-notion-user-id']
+      response.headers["x-notion-user-id"]
     end
 
     def get_last_page_block_id(url_or_id)
@@ -132,48 +103,53 @@ module NotionAPI
         pageId: clean_id,
         chunkNumber: 0,
         limit: 100,
-        verticalColumns: false
+        verticalColumns: false,
       }
-      jsonified_record_response = get_all_block_info(clean_id, request_body)
-      i = 0
-      while jsonified_record_response.empty?
-        return {:properties => {title: [[block_title]]}, :format => {}} if i >= 10
+      jsonified_record_response = get_all_block_info(request_body)
 
-        jsonified_record_response = get_all_block_info(clean_id, request_body)
-        i += 1
-      end
-      properties = jsonified_record_response['block'][clean_id]['value']['properties']
-      formats = jsonified_record_response['block'][clean_id]['value']['format']
+      properties = jsonified_record_response["block"][clean_id]["value"]["properties"]
+      formats = jsonified_record_response["block"][clean_id]["value"]["format"]
       return {
-        :properties => properties,
-        :format => formats
-      }
+               :properties => properties,
+               :format => formats,
+             }
     end
 
-    def get_all_block_info(_clean_id, body)
+    def get_all_block_info(body, i = 0)
       # ! retrieves all info pertaining to a block Id.
       # ! clean_id -> the block ID or URL cleaned : ``str``
-      Core.options['cookies'][:token_v2] = @@token_v2
-      Core.options['headers']['x-notion-active-user-header'] = @@active_user_header
-      cookies = Core.options['cookies']
-      headers = Core.options['headers']
-
+      Core.options["cookies"][:token_v2] = @@token_v2
+      Core.options["headers"]["x-notion-active-user-header"] = @@active_user_header
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
       request_url = URLS[:GET_BLOCK]
 
       response = HTTParty.post(
         request_url,
         body: body.to_json,
         cookies: cookies,
-        headers: headers
+        headers: headers,
       )
 
-      JSON.parse(response.body)['recordMap']
+      jsonified_record_response = JSON.parse(response.body)["recordMap"]
+      response_invalid = (!jsonified_record_response || jsonified_record_response.empty? || jsonified_record_response["block"].empty?)
+
+      if i < 10 && response_invalid
+        i = i + 1
+        return get_all_block_info(body, i)
+      else
+        if i == 10 && response_invalid
+          raise InvalidClientInstantiationError, "Attempted to retrieve block 10 times and received an empty response each time. Please make sure you have a valid token_v2 value set. If you do, then try setting the 'active_user_header' variable as well."
+        else
+          return jsonified_record_response
+        end
+      end
     end
 
     def filter_nil_blocks(jsonified_record_response)
       # ! removes any blocks that are empty [i.e. have no title / content]
       # ! jsonified_record_responses -> parsed JSON representation of a notion response object : ``Json``
-      jsonified_record_response.empty? || jsonified_record_response['block'].empty? ? nil : jsonified_record_response['block']
+      jsonified_record_response.empty? || jsonified_record_response["block"].empty? ? nil : jsonified_record_response["block"]
     end
 
     def extract_title(clean_id, jsonified_record_response)
@@ -181,14 +157,13 @@ module NotionAPI
       # ! clean_id -> the cleaned block ID: ``str``
       # ! jsonified_record_response -> parsed JSON representation of a notion response object : ``Json``
       filter_nil_blocks = filter_nil_blocks(jsonified_record_response)
-      if filter_nil_blocks.nil? || filter_nil_blocks[clean_id].nil? || filter_nil_blocks[clean_id]['value']['properties'].nil?
+      if filter_nil_blocks.nil? || filter_nil_blocks[clean_id].nil? || filter_nil_blocks[clean_id]["value"]["properties"].nil?
         nil
       else
         # titles for images are called source, while titles for text-based blocks are called title, so lets dynamically grab it
         # https://stackoverflow.com/questions/23765996/get-all-keys-from-ruby-hash/23766007
-        title_value = filter_nil_blocks[clean_id]['value']['properties'].keys[0]
-        Core.type_whitelist.include?(filter_nil_blocks[clean_id]['value']['type']) ? nil : jsonified_record_response['block'][clean_id]['value']['properties'][title_value].flatten[0] 
-
+        title_value = filter_nil_blocks[clean_id]["value"]["properties"].keys[0]
+        Core.type_whitelist.include?(filter_nil_blocks[clean_id]["value"]["type"]) ? nil : jsonified_record_response["block"][clean_id]["value"]["properties"][title_value].flatten[0]
       end
     end
 
@@ -197,7 +172,7 @@ module NotionAPI
       # ! clean_id -> the cleaned block ID: ``str``
       # ! collection_id -> the collection ID: ``str``
       # ! jsonified_record_response -> parsed JSON representation of a notion response object : ``Json``
-      jsonified_record_response['collection'][collection_id]['value']['name'].flatten.join if jsonified_record_response['collection'] and jsonified_record_response['collection'][collection_id]['value']['name']
+      jsonified_record_response["collection"][collection_id]["value"]["name"].flatten.join if jsonified_record_response["collection"] and jsonified_record_response["collection"][collection_id]["value"]["name"]
     end
 
     def extract_type(clean_id, jsonified_record_response)
@@ -208,8 +183,7 @@ module NotionAPI
       if filter_nil_blocks.nil?
         nil
       else
-        filter_nil_blocks[clean_id]['value']['type']
-
+        filter_nil_blocks[clean_id]["value"]["type"]
       end
     end
 
@@ -217,37 +191,46 @@ module NotionAPI
       # ! extract parent ID from core JSON response object.
       # ! clean_id -> the block ID or URL cleaned : ``str``
       # ! jsonified_record_response -> parsed JSON representation of a notion response object : ``Json``
-      jsonified_record_response.empty? || jsonified_record_response['block'].empty? ? {} : jsonified_record_response['block'][clean_id]['value']['parent_id']
+      jsonified_record_response.empty? || jsonified_record_response["block"].empty? ? {} : jsonified_record_response["block"][clean_id]["value"]["parent_id"]
     end
 
     def extract_collection_id(clean_id, jsonified_record_response)
       # ! extract the collection ID
       # ! clean_id -> the block ID or URL cleaned : ``str``
       # ! jsonified_record_response -> parsed JSON representation of a notion response object : ``Json``
-      jsonified_record_response['block'][clean_id]['value']['collection_id']
+      jsonified_record_response["block"][clean_id]["value"]["collection_id"]
     end
 
     def extract_view_ids(clean_id, jsonified_record_response)
-      jsonified_record_response['block'][clean_id]['value']['view_ids'] || []
+      jsonified_record_response["block"][clean_id]["value"]["view_ids"] || []
     end
-    
+
     def extract_id(url_or_id)
       # ! parse and clean the URL or ID object provided.
       # ! url_or_id -> the block ID or URL : ``str``
       http_or_https = url_or_id.match(/^(http|https)/) # true if http or https in url_or_id...
-      if (url_or_id.length == 36) && ((url_or_id.split('-').length == 5) && !http_or_https)
+      collection_view_match = url_or_id.match(/(\?v=)/)
+
+      if (url_or_id.length == 36) && ((url_or_id.split("-").length == 5) && !http_or_https)
         # passes if url_or_id is perfectly formatted already...
         url_or_id
-      elsif (http_or_https && (url_or_id.split('-').last.length == 32)) || (!http_or_https && (url_or_id.length == 32))
+      elsif (http_or_https && (url_or_id.split("-").last.length == 32)) || (!http_or_https && (url_or_id.length == 32)) || (collection_view_match)
         # passes if either:
         # 1. a URL is passed as url_or_id and the ID at the end is 32 characters long or
         # 2. a URL is not passed and the ID length is 32 [aka unformatted]
         pattern = [8, 13, 18, 23]
-        id = url_or_id.split('-').last
-        pattern.each { |index| id.insert(index, '-') }
-        id
+        if collection_view_match
+          id_without_view = url_or_id.split("?")[0]
+          clean_id = id_without_view.split("/").last
+          pattern.each { |index| clean_id.insert(index, "-") }
+          clean_id
+        else
+          id = url_or_id.split("-").last
+          pattern.each { |index| id.insert(index, "-") }
+          id
+        end
       else
-        raise ArgumentError, 'Expected a Notion page URL or a page ID. Please consult the documentation for further information.'
+        raise ArgumentError, "Expected a Notion page URL or a page ID. Please consult the documentation for further information."
       end
     end
 
@@ -255,42 +238,88 @@ module NotionAPI
       # ! retrieve the collection scehma. Useful for 'building' the backbone for a table.
       # ! collection_id -> the collection ID : ``str``
       # ! view_id -> the view ID : ``str``
-      cookies = Core.options['cookies']
-      headers = Core.options['headers']
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
 
       if response.empty?
-        query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, '')
+        query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, "")
 
         request_url = URLS[:GET_COLLECTION]
         response = HTTParty.post(
           request_url,
           body: query_collection_hash.to_json,
           cookies: cookies,
-          headers: headers
+          headers: headers,
         )
-        response['recordMap']['collection'][collection_id]['value']['schema']
+        response["recordMap"]["collection"][collection_id]["value"]["schema"]
       else
-        response['collection'][collection_id]['value']['schema']
+        response["collection"][collection_id]["value"]["schema"]
       end
     end
-    
+
     def extract_collection_data(collection_id, view_id)
       # ! retrieve the collection scehma. Useful for 'building' the backbone for a table.
       # ! collection_id -> the collection ID : ``str``
       # ! view_id -> the view ID : ``str``
-      cookies = Core.options['cookies']
-      headers = Core.options['headers']
+      cookies = Core.options["cookies"]
+      headers = Core.options["headers"]
 
-      query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, '')
+      query_collection_hash = Utils::CollectionViewComponents.query_collection(collection_id, view_id, "")
 
       request_url = URLS[:GET_COLLECTION]
       response = HTTParty.post(
         request_url,
         body: query_collection_hash.to_json,
         cookies: cookies,
-        headers: headers
+        headers: headers,
       )
-      response['recordMap']
+      response["recordMap"]
+    end
+
+    def extract_page_information(page_meta = {})
+      # ! helper method for extracting information about a page block
+      # ! page_meta -> hash containing data points useful for the extraction of a page blocks information.
+      # !           This should include clean_id, jsonified_record_response, and parent_id
+      clean_id = page_meta.fetch(:clean_id)
+      jsonified_record_response = page_meta.fetch(:jsonified_record_response)
+      block_parent_id = page_meta.fetch(:parent_id)
+
+      block_title = extract_title(clean_id, jsonified_record_response)
+      PageBlock.new(clean_id, block_title, block_parent_id)
+    end
+
+    def extract_collection_view_page_information(page_meta = {})
+      # ! helper method for extracting information about a Collection View page block
+      # ! page_meta -> hash containing data points useful for the extraction of a page blocks information.
+      # !           This should include clean_id, jsonified_record_response, and parent_id
+      clean_id = page_meta.fetch(:clean_id)
+      jsonified_record_response = page_meta.fetch(:jsonified_record_response)
+      block_parent_id = page_meta.fetch(:parent_id)
+
+      collection_id = extract_collection_id(clean_id, jsonified_record_response)
+      block_title = extract_collection_title(clean_id, collection_id, jsonified_record_response)
+      view_id = extract_view_ids(clean_id, jsonified_record_response)[0]
+      schema = extract_collection_schema(collection_id, view_id, jsonified_record_response)
+      column_names = NotionAPI::CollectionView.extract_collection_view_column_names(schema)
+
+      collection_view_page = CollectionViewPage.new(clean_id, block_title, block_parent_id, collection_id, view_id)
+      collection_view_page.instance_variable_set(:@column_names, column_names)
+      CollectionView.class_eval { attr_reader :column_names }
+      collection_view_page
+    end
+
+    def get_instantiated_instance_for(block_type, clean_id, parent_id, jsonified_record_response)
+      case block_type
+      when "page" then extract_page_information(clean_id: clean_id, parent_id: parent_id, jsonified_record_response: jsonified_record_response)
+      when "collection_view_page" then extract_collection_view_page_information(clean_id: clean_id, parent_id: parent_id, jsonified_record_response: jsonified_record_response)
+      end
+    end
+
+    class InvalidClientInstantiationError < StandardError
+      def initialize(msg = "Custom exception that is raised when an invalid property type is passed as a mapping.", exception_type = "instantiation_type")
+        @exception_type = exception_type
+        super(msg)
+      end
     end
   end
 end

data/lib/notion_api/notion_types/code_block.rb

@@ -1,16 +1,16 @@
 module NotionAPI
 
-    # Code block: used to store code, should be assigned a coding language.
-    class CodeBlock < BlockTemplate
-      @notion_type = 'code'
-      @type = 'code'
-  
-      def type
-        NotionAPI::CodeBlock.notion_type
-      end
-  
-      class << self
-        attr_reader :notion_type, :type
-      end
+  # Code block: used to store code, should be assigned a coding language.
+  class CodeBlock < BlockTemplate
+    @notion_type = "code"
+    @type = "code"
+
+    def type
+      NotionAPI::CodeBlock.notion_type
+    end
+
+    class << self
+      attr_reader :notion_type, :type
     end
-end
+  end
+end

data/lib/notion_api/notion_types/collection_view_blocks.rb

@@ -33,7 +33,9 @@ module NotionAPI
       transaction_id = extract_id(SecureRandom.hex(16))
       space_id = extract_id(SecureRandom.hex(16))
       new_block_id = extract_id(SecureRandom.hex(16))
-      schema = extract_collection_schema(@collection_id, @view_id)
+      collection_data = extract_collection_data(collection_id, view_id)
+      last_row_id = collection_data["collection_view"][@view_id]["value"]["page_sort"][-1]
+      schema = collection_data["collection"][collection_id]["value"]["schema"]
       keys = schema.keys
       col_map = {}
       keys.map { |key| col_map[schema[key]["name"]] = key }
@@ -47,17 +49,27 @@ module NotionAPI
       instantiate_row = Utils::CollectionViewComponents.add_new_row(new_block_id)
       set_block_alive = Utils::CollectionViewComponents.set_collection_blocks_alive(new_block_id, @collection_id)
       new_block_edited_time = Utils::BlockComponents.last_edited_time(new_block_id)
-      parent_edited_time = Utils::BlockComponents.last_edited_time(@parent_id)
+      page_sort = Utils::BlockComponents.row_location_add(last_row_id, new_block_id, @view_id)
 
       operations = [
         instantiate_row,
         set_block_alive,
         new_block_edited_time,
-        parent_edited_time,
+        page_sort,
       ]
 
       data.keys.each_with_index do |col_name, j|
         unless col_map.keys.include?(col_name.to_s); raise ArgumentError, "Column '#{col_name.to_s}' does not exist." end
+        if %q[select multi_select].include?(schema[col_map[col_name.to_s]]["type"])
+          options = schema[col_map[col_name.to_s]]["options"].nil? ? [] : schema[col_map[col_name.to_s]]["options"].map { |option| option["value"] }
+          multi_select_multi_options = data[col_name].split(",")
+          multi_select_multi_options.each do |option|
+            if !options.include?(option.strip)
+              create_new_option = Utils::CollectionViewComponents.add_new_option(col_map[col_name.to_s], option.strip, @collection_id)
+              operations.push(create_new_option)
+            end
+          end
+        end
         child_component = Utils::CollectionViewComponents.insert_data(new_block_id, col_map[col_name.to_s], data[col_name], schema[col_map[col_name.to_s]]["type"])
         operations.push(child_component)
       end
@@ -74,7 +86,18 @@ module NotionAPI
       unless response.code == 200; raise "There was an issue completing your request. Here is the response from Notion: #{response.body}, and here is the payload that was sent: #{operations}.
            Please try again, and if issues persist open an issue in GitHub.";       end
 
-      NotionAPI::CollectionViewRow.new(new_block_id, @parent_id, @collection_id, @view_id)
+      collection_row = NotionAPI::CollectionViewRow.new(new_block_id, @parent_id, @collection_id, @view_id)
+
+      properties = {}
+      data.keys.each do |col|
+        properties[col_map[col.to_s]] = [[data[col]]]
+      end
+
+      collection_data["block"][collection_row.id] = { "role" => "editor", "value" => { "id" => collection_row.id, "version" => 12, "type" => "page", "properties" => properties, "created_time" => 1607253360000, "last_edited_time" => 1607253360000, "parent_id" => "dde513c6-2428-4a5d-a830-7a67fdbf6b48", "parent_table" => "collection", "alive" => true, "created_by_table" => "notion_user", "created_by_id" => "0c5f02f3-495d-4b73-b1c5-9f6fe03a8c26", "last_edited_by_table" => "notion_user", "last_edited_by_id" => "0c5f02f3-495d-4b73-b1c5-9f6fe03a8c26", "shard_id" => 955090, "space_id" => "f687f7de-7f4c-4a86-b109-941a8dae92d2" } }
+      row_data = collection_data["block"][collection_row.id]
+      create_singleton_methods_and_instance_variables(collection_row, row_data)
+
+      collection_row
     end
 
     def add_property(name, type)
@@ -135,20 +158,11 @@ module NotionAPI
         limit: 100,
         verticalColumns: false,
       }
-      jsonified_record_response = get_all_block_info(clean_id, request_body)
-
-      i = 0
-      while jsonified_record_response.empty? || jsonified_record_response["block"].empty?
-        return {} if i >= 10
-
-        jsonified_record_response = get_all_block_info(clean_id, request_body)
-        i += 1
-      end
+      jsonified_record_response = get_all_block_info(request_body)
 
       collection_data = extract_collection_data(@collection_id, @view_id)
       schema = collection_data["collection"][collection_id]["value"]["schema"]
-      column_mappings = schema.keys
-      column_names = column_mappings.map { |mapping| schema[mapping]["name"] }
+      column_names = NotionAPI::CollectionView.extract_collection_view_column_names(schema)
 
       collection_row = CollectionViewRow.new(row_id, @parent_id, @collection_id, @view_id)
       collection_row.instance_variable_set(:@column_names, column_names)
@@ -171,29 +185,20 @@ module NotionAPI
         verticalColumns: false,
       }
 
-      jsonified_record_response = get_all_block_info(clean_id, request_body)
-      i = 0
-      while jsonified_record_response.empty? || jsonified_record_response["block"].empty?
-        return {} if i >= 10
-
-        jsonified_record_response = get_all_block_info(clean_id, request_body)
-        i += 1
-      end
+      jsonified_record_response = get_all_block_info(request_body)
 
       jsonified_record_response["collection_view"][@view_id]["value"]["page_sort"]
     end
 
     def rows
       # ! returns all rows as instantiated class instances.
-      row_id_array = row_ids
+      row_id_array = row_ids()
       parent_id = @parent_id
       collection_id = @collection_id
       view_id = @view_id
       collection_data = extract_collection_data(@collection_id, @view_id)
       schema = collection_data["collection"][collection_id]["value"]["schema"]
-      column_mappings = schema.keys
-      column_names = column_mappings.map { |mapping| schema[mapping]["name"] }
-
+      column_names = NotionAPI::CollectionView.extract_collection_view_column_names(schema)
       row_instances = row_id_array.map { |row_id| NotionAPI::CollectionViewRow.new(row_id, parent_id, collection_id, view_id) }
       clean_row_instances = row_instances.filter { |row| collection_data["block"][row.id] }
       clean_row_instances.each { |row| row.instance_variable_set(:@column_names, column_names) }
@@ -205,6 +210,7 @@ module NotionAPI
       end
       clean_row_instances
     end
+
     def create_singleton_methods_and_instance_variables(row, row_data)
       # ! creates singleton methods for each property in a CollectionView.
       # ! row -> the block ID of the 'row' to retrieve: ``str``
@@ -214,22 +220,24 @@ module NotionAPI
       column_mappings = schema.keys
       column_hash = {}
       column_names = column_mappings.map { |mapping| column_hash[mapping] = schema[mapping]["name"].downcase }
-      
+
       column_hash.keys.each_with_index do |column, i|
         # loop over the column names...
         # set instance variables for each column, allowing the dev to 'read' the column value
-        cleaned_column = column_hash[column].split(" ").join("_").downcase.to_sym
+        cleaned_column = clean_property_names(column_hash, column)
 
-        # p row_data["value"]["properties"][column_mappings[i]], !(row_data["value"]["properties"][column] or row_data["value"]["properties"][column_mappings[i]])
         if row_data["value"]["properties"].nil? or row_data["value"]["properties"][column].nil?
           value = ""
         else
-          value = row_data["value"]["properties"][column][0][0]  
+          value = row_data["value"]["properties"][column][0][0]
+          if ["‣"].include?(value.to_s)
+            value = row_data["value"]["properties"][column][0][1].flatten[-1]
+          end
         end
 
         row.instance_variable_set("@#{cleaned_column}", value)
         CollectionViewRow.class_eval { attr_reader cleaned_column }
-        # then, define singleton methods for each column that are used to update the table cell 
+        # then, define singleton methods for each column that are used to update the table cell
         row.define_singleton_method("#{cleaned_column}=") do |new_value|
           # neat way to get the name of the currently invoked method...
           parsed_method = __method__.to_s[0...-1].split("_").join(" ")
@@ -246,12 +254,23 @@ module NotionAPI
             space_id: space_id,
           }
 
-          update_property_value = Utils::CollectionViewComponents.update_property_value(@id, column_hash.key(parsed_method), new_value)
+          update_property_value_hash = Utils::CollectionViewComponents.update_property_value(@id, column_hash.key(parsed_method), new_value, schema[column_hash.key(parsed_method)]["type"])
 
           operations = [
-            update_property_value,
+            update_property_value_hash,
           ]
 
+          if %q[select multi_select].include?(schema[column_hash.key(parsed_method)]["type"])
+            options = schema[column_hash.key(parsed_method)]["options"].nil? ? [] : schema[column_hash.key(parsed_method)]["options"].map { |option| option["value"] }
+            multi_select_multi_options = new_value.split(",")
+            multi_select_multi_options.each do |option|
+              if !options.include?(option.strip)
+                create_new_option = Utils::CollectionViewComponents.add_new_option(column_hash.key(parsed_method), option.strip, @collection_id)
+                operations.push(create_new_option)
+              end
+            end
+          end
+
           request_url = URLS[:UPDATE_BLOCK]
           request_body = build_payload(operations, request_ids)
           response = HTTParty.post(
@@ -261,14 +280,31 @@ module NotionAPI
             headers: headers,
           )
           unless response.code == 200; raise "There was an issue completing your request. Here is the response from Notion: #{response.body}, and here is the payload that was sent: #{operations}.
-               Please try again, and if issues persist open an issue in GitHub.";end
-          
+               Please try again, and if issues persist open an issue in GitHub.";           end
+
           # set the instance variable to the updated value!
           _ = row.instance_variable_set("@#{__method__.to_s[0...-1]}", new_value)
           row
         end
       end
     end
+
+    def clean_property_names(prop_hash, prop_notion_name)
+      # ! standardize property names by splitting the words in the property name into an array, removing non-alphanumeric
+      # ! characters, downcasing, and then re-joining the array with underscores.
+      # ! prop_hash -> hash of property notion names  and property textual names: ``str``
+      # ! prop_notion_name -> the four-character long name of the notion property: ``str``
+
+      prop_hash[prop_notion_name].split(" ").map { |word| word.gsub(/[^a-z0-9]/i, "").downcase }.join("_").to_sym
+    end
+
+    def self.extract_collection_view_column_names(schema)
+      # ! extract the column names of a Collection View
+      # ! schema: the schema of the collection view
+      column_mappings = column_mappings = schema.keys
+      column_names = column_mappings.map { |mapping| schema[mapping]["name"] }
+      column_names
+    end
   end
 
   # class that represents each row in a CollectionView