notion_ruby_mapping 0.3.3 → 0.5.0

data/lib/notion_ruby_mapping/objects/equation_object.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module NotionRubyMapping
+  # EquationObject
+  class EquationObject < RichTextObject
+    # @param [String] expression
+    # @return [TextObject]
+    def initialize(expression, options = {})
+      super "equation", {"plain_text" => expression}.merge(options)
+      @expression = expression
+      @will_update = false
+    end
+    attr_reader :will_update, :expression
+
+    # @param [EquationObject, String] uo
+    # @return [EquationObject] self or created EquationObject
+    # @see https://www.notion.so/hkob/EquationObject-cd50126fce544ad5bb76463a4269859b#45b0b0810d8647a1968a5e4293920aeb
+    def self.equation_object(expression_or_eo)
+      if expression_or_eo.is_a? EquationObject
+        expression_or_eo
+      else
+        EquationObject.new expression_or_eo
+      end
+    end
+
+    # @param [String] expression
+    # @see https://www.notion.so/hkob/EquationObject-cd50126fce544ad5bb76463a4269859b#155800e2c69d4676a2d74572ed8f0de8
+    def expression=(expression)
+      @expression = expression
+      @options["plain_text"] = expression
+      @will_update = true
+    end
+
+    protected
+
+    # @return [Hash{String (frozen)->String}]
+    def partial_property_values_json
+      {
+        "expression" => @expression,
+      }
+    end
+  end
+end

data/lib/notion_ruby_mapping/objects/file_object.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module NotionRubyMapping
+  # TextObject
+  class FileObject
+    # @param [String] url
+    # @return [TextObject]
+    def initialize(url: nil, json: {})
+      if url
+        @type = "external"
+        @url = url
+      elsif json
+        @type = json["type"]
+        @url = json[@type]["url"]
+        @expiry_time = json[@type]["expiry_time"]
+      else
+        raise StandardError, "FileObject requires url: or json:"
+      end
+      @will_update = false
+    end
+    attr_reader :will_update, :url, :type
+
+    # @param [FileObject, String] uo
+    # @return [FileObject] self or created FileObject
+    # @see https://www.notion.so/hkob/FileObject-6218c354e985423a90904f47a985be33#54b37c567e1d4dfcab06f6d8f8fd412e
+    def self.file_object(url_or_fo)
+      if url_or_fo.is_a? FileObject
+        url_or_fo
+      else
+        FileObject.new url: url_or_fo
+      end
+    end
+
+    # @return [TrueClass, FalseClass] true if "type" is "external"
+    def external?
+      @type == "external"
+    end
+
+    # @param [String] url
+    # @see https://www.notion.so/hkob/FileObject-6218c354e985423a90904f47a985be33#6b841f75d0234a1aac93fb54348abb96
+    def url=(url)
+      raise StandardError "internal file url can't change." if @type == "file"
+
+      @url = url
+      @will_update = true
+    end
+
+    # @return [Hash]
+    def property_values_json
+      ans = {
+        "type" => @type,
+        @type => {
+          "url" => @url,
+        },
+      }
+      ans[@type]["expiry_time"] = @expiry_time if @expiry_time
+      ans
+    end
+  end
+end

data/lib/notion_ruby_mapping/{mention_object.rb → objects/mention_object.rb}

@@ -6,6 +6,10 @@ module NotionRubyMapping
     # @return [MentionObject]
     def initialize(options = {})
       super "mention", options
+      return unless (url = options["link_preview"])
+
+      @options["href"] = url
+      @options["plain_text"] = url
     end
 
     # @return [String (frozen)]
@@ -66,6 +70,13 @@ module NotionRubyMapping
           "type" => "template_mention",
           "template_mention" => sub,
         }
+      elsif @options.key? "link_preview"
+        {
+          "type" => "link_preview",
+          "link_preview" => {
+            "url" => @options["link_preview"],
+          },
+        }
       else
         raise StandardError, "Irregular mention type: #{@options.keys}"
       end

data/lib/notion_ruby_mapping/{rich_text_object.rb → objects/rich_text_object.rb}

@@ -14,7 +14,7 @@ module NotionRubyMapping
       @type = type
       @options = options
     end
-    attr_reader :will_update
+    attr_reader :will_update, :options
 
     def self.create_from_json(json)
       type = json["type"]
@@ -22,6 +22,8 @@ module NotionRubyMapping
       case type
       when "text"
         TextObject.new json["plain_text"], options
+      when "equation"
+        EquationObject.new json["equation"]["expression"], options
       when "mention"
         mention = json["mention"]
         case mention["type"]
@@ -41,6 +43,8 @@ module NotionRubyMapping
           else
             MentionObject.new options.merge({"template_mention" => template_mention["template_mention_user"]})
           end
+        when "link_preview"
+          MentionObject.new options.merge({"link_preview" => mention["link_preview"]["url"]})
         else
           raise StandardError, "Unknown mention type: #{mention["type"]}"
         end
@@ -69,6 +73,13 @@ module NotionRubyMapping
       }.merge annotations_json
     end
 
+    # @param [String] url
+    # @return [String] input text
+    def href=(url)
+      @will_update = true
+      @options["href"] = url
+    end
+
     # @param [String, RichTextObject] value
     # @return [String] input text
     def plain_text=(value)
@@ -119,9 +130,6 @@ module NotionRubyMapping
 
     protected
 
-    # @return [Hash] options
-    attr_reader :options
-
     # @return [Hash, Hash{String (frozen)->Hash}]
     def annotations_json
       annotations = @options.slice(*%w[bold italic strikethrough underline code color])

data/lib/notion_ruby_mapping/{text_object.rb → objects/text_object.rb}

@@ -8,7 +8,6 @@ module NotionRubyMapping
     def initialize(text, options = {})
       super "text", {"plain_text" => text}.merge(options)
       @text = text
-      @type = "text"
       @will_update = false
     end
     attr_reader :text, :will_update

data/lib/notion_ruby_mapping/{user_object.rb → objects/user_object.rb}

@@ -14,11 +14,11 @@ module NotionRubyMapping
 
     # @param [UserObject, String] uo
     # @return [UserObject] self or created UserObject
-    def self.user_object(user_id_or_user)
-      if user_id_or_user.is_a? UserObject
-        user_id_or_user
+    def self.user_object(user_id_or_uo)
+      if user_id_or_uo.is_a? UserObject
+        user_id_or_uo
       else
-        UserObject.new user_id: user_id_or_user
+        UserObject.new user_id: user_id_or_uo
       end
     end
 
@@ -34,5 +34,10 @@ module NotionRubyMapping
         "id" => @user_id,
       }
     end
+
+    def user_id=(new_user_id)
+      @user_id = new_user_id
+      @will_update = true
+    end
   end
 end

data/lib/notion_ruby_mapping/{checkbox_property.rb → properties/checkbox_property.rb}

@@ -11,6 +11,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [Boolean, Hash]
+    # @see https://www.notion.so/hkob/CheckboxProperty-ac1edbdb8e264af5ad1432b522b429fd#20da1bf0cbcc4d4eb22d9125386522c2
     def checkbox
       @json
     end
@@ -19,7 +20,9 @@ module NotionRubyMapping
 
     # @param [Boolean] flag
     # @return [TrueClass, FalseClass] settled value
+    # @see https://www.notion.so/hkob/CheckboxProperty-ac1edbdb8e264af5ad1432b522b429fd#f167c85c1d2d40dfb8b3b6ce582e0f15
     def checkbox=(flag)
+      assert_page_property __method__
       @will_update = true
       @json = flag
     end

data/lib/notion_ruby_mapping/{created_by_property.rb → properties/created_by_property.rb}

@@ -10,6 +10,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [NotionRubyMapping::UserObject, Hash]
+    # @see https://www.notion.so/hkob/CreatedByProperty-945fa6be1c014da2b7e55a2b76e37b57#d9c4a8d19b9b4ec5952dc86c9e4a25a8
     def created_by
       @json
     end

data/lib/notion_ruby_mapping/{created_time_property.rb → properties/created_time_property.rb}

@@ -10,6 +10,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [Date, Hash]
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#f1e80400878346c3a9ba8e32b824ed2b
     def created_time
       @json
     end

data/lib/notion_ruby_mapping/properties/date_base_property.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require "date"
+
+module NotionRubyMapping
+  # Date base property (date, created_time, last_edited_time, formula)
+  class DateBaseProperty < Property
+    include IsEmptyIsNotEmpty
+
+    # @param [Date, Time, DateTime, String, nil] obj
+    # @return [String, nil] iso8601 format string
+    def self.value_str(obj)
+      case obj
+      when Date
+        obj.iso8601
+      when Time
+        obj.strftime("%Y-%m-%dT%H:%M:%S%:z")
+      when DateTime
+        obj.iso8601
+      else
+        obj
+      end
+    end
+
+    # @param [Date, Time, DateTime, String, nil] obj
+    # @return [Date, nil] iso8601 format string
+    def self.date_from_obj(obj)
+      str = value_str obj
+      Date.parse str if str
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CheckboxProperty-ac1edbdb8e264af5ad1432b522b429fd#5f07c4ebc4744986bfc99a43827349fc
+    def filter_equals(date, rollup = nil, rollup_type = nil)
+      make_filter_query "equals", value_str(date), rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    def filter_does_not_equal(date, rollup = nil, rollup_type = nil)
+      make_filter_query "does_not_equal", value_str(date), rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#841815bfaf684964bebf3fa6712ae26c
+    def filter_before(date, rollup = nil, rollup_type = nil)
+      make_filter_query "before", value_str(date), rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#c0ea140866ea46f9a746b24773dc821c
+    def filter_after(date, rollup = nil, rollup_type = nil)
+      make_filter_query "after", value_str(date), rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#6a20ade0ee964aad81aae4c08ea29d6b
+    def filter_on_or_before(date, rollup = nil, rollup_type = nil)
+      make_filter_query "on_or_before", value_str(date), rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#1469e3fb3068426a8ea8492d191d1563
+    def filter_on_or_after(date, rollup = nil, rollup_type = nil)
+      make_filter_query "on_or_after", value_str(date), rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#707e7e848dc9417998420b65024542db
+    def filter_past_week(rollup = nil, rollup_type = nil)
+      make_filter_query "past_week", {}, rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#7b2d05c549204c2eb68d95020d7b97c5
+    def filter_past_month(rollup = nil, rollup_type = nil)
+      make_filter_query "past_month", {}, rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#9c8bf0a2398a41c8a0714a62afca3aa8
+    def filter_past_year(rollup = nil, rollup_type = nil)
+      make_filter_query "past_year", {}, rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#d9dc189ee8244ba8a6c863259eaa9984
+    def filter_next_week(rollup = nil, rollup_type = nil)
+      make_filter_query "next_week", {}, rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#0edb4dffbe6b403882255e870cc71066
+    def filter_next_month(rollup = nil, rollup_type = nil)
+      make_filter_query "next_month", {}, rollup, rollup_type
+    end
+
+    # @param [String] rollup Rollup name
+    # @param [String] rollup_type Rollup type
+    # @return [NotionRubyMapping::Query] generated Query object
+    # @see https://www.notion.so/hkob/CreatedTimeProperty-bb979ff02dc04efa9733da1003efa871#b59c73dd4b1a488f95d3e8cd19853709
+    def filter_next_year(rollup = nil, rollup_type = nil)
+      make_filter_query "next_year", {}, rollup, rollup_type
+    end
+
+    protected
+
+    # @param [Date, Time, DateTime, String, nil] obj
+    # @return [String, nil] iso8601 format string
+    def value_str(obj)
+      self.class.value_str(obj)
+    end
+  end
+end

data/lib/notion_ruby_mapping/{date_property.rb → properties/date_property.rb}

@@ -10,6 +10,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [Hash]
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#e64792d3d35c439e8123f108987becc3
     def date
       @json
     end
@@ -17,12 +18,16 @@ module NotionRubyMapping
     ## Page property only methods
 
     # @return [Date, Time, DateTime, String]
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#15f2088e012549cbae93de14ce14d352
     def end_date
+      assert_page_property __method__
       @json["end"]
     end
 
     # @param [Date, Time, DateTime, String] edt
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#944c02096101429084527c22155683bf
     def end_date=(edt)
+      assert_page_property __method__
       @will_update = true
       sdt = start_date
       edt = nil if sdt.class != edt.class || sdt > edt
@@ -30,12 +35,16 @@ module NotionRubyMapping
     end
 
     # @return [Date, Time, DateTime, String]
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#d37097c7a3f7481e9b33a7aaae783888
     def start_date
+      assert_page_property __method__
       @json["start"]
     end
 
     # @param [Date, Time, DateTime, String] sdt
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#4f5931f1588a43f7857af8ab2d73df74
     def start_date=(sdt)
+      assert_page_property __method__
       @will_update = true
       edt = end_date
       @json["end"] = nil if sdt.class != edt.class || sdt > edt
@@ -43,12 +52,16 @@ module NotionRubyMapping
     end
 
     # @return [String]
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#f892cde82d9a44a0850d69878e31b216
     def time_zone
+      assert_page_property __method__
       @json["time_zone"]
     end
 
     # @param [String] tzone
+    # @see https://www.notion.so/hkob/DateProperty-c6e815c060cb430889dbb33b697f00c6#2529a5ac7982466f9f19299fc51e02a8
     def time_zone=(tzone)
+      assert_page_property __method__
       @will_update = true
       @json["time_zone"] = tzone
     end

data/lib/notion_ruby_mapping/{email_property.rb → properties/email_property.rb}

@@ -20,8 +20,9 @@ module NotionRubyMapping
 
     ## Page property only methods
 
-    # @param [String] str
+    # @param [String] email
     def email=(email)
+      assert_page_property __method__
       @will_update = true
       @json = email
     end
@@ -31,7 +32,6 @@ module NotionRubyMapping
     ## Common methods
 
     # @param [String] name Property name
-    # @param [String] email email value (optional)
     def initialize(name, will_update: false, base_type: :page, json: nil)
       super name, will_update: will_update, base_type: base_type
       @json = json || {}

data/lib/notion_ruby_mapping/{files_property.rb → properties/files_property.rb}

@@ -6,20 +6,17 @@ module NotionRubyMapping
     include IsEmptyIsNotEmpty
     TYPE = "files"
 
-    ### Public announced methods
-
-    ## Common methods
+    attr_reader :files
 
-    # @return [Hash]
-    def files
-      @json
-    end
+    ### Public announced methods
 
     ## Page property only methods
 
     def files=(files = [])
+      assert_page_property __method__
       @will_update = true
-      @json = Array(files).map { |url| url_to_hash url }
+      @files = Array(files).map { |url| FileObject.file_object url }
+      @file_names = Array(files)
     end
 
     ### Not public announced methods
@@ -31,23 +28,39 @@ module NotionRubyMapping
     def initialize(name, will_update: false, base_type: :page, json: nil, files: [])
       super name, will_update: will_update, base_type: base_type
       if database?
-        @json = json || {}
+        @files = json || {}
+      elsif json
+        @files = json.map { |sub_json| FileObject.new json: sub_json }
+        @file_names = json.map { |sub_json| sub_json["name"] }
+      elsif !files.empty?
+        @files = Array(files).map { |url| FileObject.file_object url }
+        @file_names = Array(files)
       else
-        @json = json || []
-        @json = Array(files).map { |url| url_to_hash url } unless files.empty?
+        @files = []
       end
     end
 
     # @return [Hash]
     def property_values_json
       assert_page_property __method__
-      if @json.map { |f| f["type"] }.include? "file"
+      if @files.map(&:type).include? "file"
         {}
       else
-        {@name => {"files" => @json, "type" => "files"}}
+        files = @files.map(&:property_values_json)
+        @file_names&.each_with_index { |name, i| files[i]["name"] = name }
+        {@name => {"files" => files, "type" => "files"}}
       end
     end
 
+    def update_from_json(json)
+      return if database?
+
+      @files = json["files"].map { |sub_json| FileObject.new json: sub_json }
+      @file_names = json["files"].map { |sub_json| sub_json["name"] }
+      @will_update = false
+      p self
+    end
+
     protected
 
     # @param [String] url

data/lib/notion_ruby_mapping/{formula_property.rb → properties/formula_property.rb}

@@ -13,18 +13,22 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [Hash]
+    # @see https://www.notion.so/hkob/FormulaProperty-d6b22ca70822407a9fef0bac8925cd0d#4fda982987a141ec962e4cd76cb81f76
     def formula
       @json
     end
 
     ## Database property only methods
 
+    # @return [String] formula_expression
+    # @see https://www.notion.so/hkob/FormulaProperty-d6b22ca70822407a9fef0bac8925cd0d#a24d2a7b99254d2a9226c00153f1d516
     def formula_expression
       assert_database_property __method__
       @json["expression"]
     end
 
-    # @param [String] formula
+    # @param [String] f_e
+    # @see https://www.notion.so/hkob/FormulaProperty-d6b22ca70822407a9fef0bac8925cd0d#fdb3aaa8d0474440b7ed941673ee13b7
     def formula_expression=(f_e)
       assert_database_property __method__
       @will_update = true

data/lib/notion_ruby_mapping/{last_edited_by_property.rb → properties/last_edited_by_property.rb}

@@ -10,6 +10,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [NotionRubyMapping::UserObject, Hash]
+    # @see https://www.notion.so/hkob/LastEditedByProperty-18379cbaebda495393445e4152076d66#278312b8cece457aa1f4bdbb9a7af063
     def last_edited_by
       @json
     end

data/lib/notion_ruby_mapping/{last_edited_time_property.rb → properties/last_edited_time_property.rb}

@@ -10,6 +10,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [Date, Hash]
+    # @see https://www.notion.so/hkob/LastEditedTimeProperty-5058fd594f6748a48fd4db52535f4c18#a7b568bf997c44d49cdbe4bfbf29824e
     def last_edited_time
       @json
     end

data/lib/notion_ruby_mapping/{multi_select_property.rb → properties/multi_select_property.rb}

@@ -3,8 +3,6 @@
 module NotionRubyMapping
   # MultiSelect property
   class MultiSelectProperty < MultiProperty
-    include ContainsDoesNotContain
-    include IsEmptyIsNotEmpty
     TYPE = "multi_select"
 
     ### Public announced methods
@@ -27,7 +25,8 @@ module NotionRubyMapping
     # @param [String] name
     # @param [String] color
     # @return [Array] added array
-    def add_multi_select_options(name:, color:)
+    # @see https://www.notion.so/hkob/MultiSelectProperty-b90bba1c55d540ba97131bb013d4ca74#bcac830b00e04cb6bf7dbbb110d95667
+    def add_multi_select_option(name:, color:)
       edit_multi_select_options << {"name" => name, "color" => color}
     end
 
@@ -39,6 +38,7 @@ module NotionRubyMapping
     end
 
     # @return [Array]
+    # @see https://www.notion.so/hkob/MultiSelectProperty-b90bba1c55d540ba97131bb013d4ca74#5ff6ec299cf64049bde2416f61b30fa9
     def multi_select_options
       assert_database_property __method__
       @json["options"] || []
@@ -49,6 +49,7 @@ module NotionRubyMapping
     # @param [Hash] multi_select
     # @return [Array, nil] settled array
     def multi_select=(multi_select)
+      assert_page_property __method__
       @will_update = true
       @json = multi_select ? Array(multi_select).map { |ms| {"name" => ms} } : []
     end

data/lib/notion_ruby_mapping/{number_property.rb → properties/number_property.rb}

@@ -13,6 +13,7 @@ module NotionRubyMapping
     ## Common methods
 
     # @return [Numeric, Hash]
+    # @see https://www.notion.so/hkob/NumberProperty-964ebc1948074d7ca8340187aa352d40#571b41dd33ae42039e6b982a502b7ac7
     def number
       @json
     end
@@ -20,6 +21,7 @@ module NotionRubyMapping
     ## Database property only methods
 
     # @return [String] new or settled format
+    # @see https://www.notion.so/hkob/NumberProperty-964ebc1948074d7ca8340187aa352d40#5e3682ed9e124d518f735b236787d7a7
     def format
       assert_database_property __method__
       @json["format"]
@@ -27,6 +29,7 @@ module NotionRubyMapping
 
     # @param [String] format
     # @return [String] settled format
+    # @see https://www.notion.so/hkob/NumberProperty-964ebc1948074d7ca8340187aa352d40#89695432078643e48307c348e2983456
     def format=(format)
       assert_database_property __method__
       @will_update = true
@@ -37,6 +40,7 @@ module NotionRubyMapping
 
     # @param [Numeric] num
     # @return [Numeric] settled number
+    # @see https://www.notion.so/hkob/NumberProperty-964ebc1948074d7ca8340187aa352d40#a3f28cc7029046878dfd694b5b33e8d8
     def number=(num)
       assert_page_property __method__
       @will_update = true