notion_ruby_mapping 4.0.0 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9dad5c3579a84ff3dd64c56a20d58e1c8bdcd605d6d956b7a97f3a6120bee28a
-  data.tar.gz: fffec11062ce3e152350cda495ad33b13baf2697abb7db308b4755e66710654e
+  metadata.gz: 60caedd2da9ab654284cb0d15f93fdef648e3d93b85e73a2d8e0b074657b6658
+  data.tar.gz: 5b2474e262b7ed381d6ab266a898df26b736d5990c2cb441391c730615b40b8d
 SHA512:
-  metadata.gz: bc60d84f2634660338b0ffee697539e9063b4e46e079c5a107724f1acd782e466bbc27b80561b710dcaf2a9878194a5b0a77bcf52edf4028e142d3b24a636767
-  data.tar.gz: d7e39e143665cd7c51ebd8008e727aacdaee9ee936f043017c7e163b4db078c253a189dc391baead83061b1ae0656a9c33c5d278e5269e6f2b871a774c061c16
+  metadata.gz: '0785e9cd53092787c84aedeba453559934d4501cc73f75ffed2be447d939dc817ee69ee05696af03025d21184d495fdd2c699336e756bca3d84511cc6595d7b0'
+  data.tar.gz: 69e57b27cfa5d4ff92e1c71b1de13ab44f6706fe2c83cde73aa82f65d24e02788898e8deafe8ed240ef9f752a3e919998d367aa099cd0efca87a226cc8ba93a6

data/README.md

@@ -15,10 +15,11 @@ Development note is here.
 - [notion\_ruby\_mapping](#notion_ruby_mapping)
   - [Table of Contents](#table-of-contents)
   - [0. History of Major Changes / 主な変更履歴](#0-history-of-major-changes--主な変更履歴)
-    - [0.1 Changes in v3.0.0](#01-changes-in-v300)
-    - [0.2 Changes in v0.7.0](#02-changes-in-v070)
-    - [0.3 Changes in v0.6.0](#03-changes-in-v060)
-    - [0.4 Changes in v0.5.0](#04-changes-in-v050)
+    - [0.1 Changes in v4.0.0](#01-changes-in-v400)
+    - [0.2 Changes in v3.0.0](#02-changes-in-v300)
+    - [0.3 Changes in v0.7.0](#03-changes-in-v070)
+    - [0.4 Changes in v0.6.0](#04-changes-in-v060)
+    - [0.5 Changes in v0.5.0](#05-changes-in-v050)
   - [1. Installation / インストール方法](#1-installation--インストール方法)
   - [2. How to use / 利用方法](#2-how-to-use--利用方法)
     - [2.1 Create a New Integration / インテグレーションの作成](#21-create-a-new-integration--インテグレーションの作成)
@@ -33,7 +34,13 @@ Development note is here.
 
 ## 0. History of Major Changes / 主な変更履歴
 
-### 0.1 Changes in v3.0.0
+### 0.1 Changes in v4.0.0
+
+NotionRubyMapping v4.0.0 now supports Notion-Version 2026-03-11.
+
+NotionRubyMapping v4.0.0 は、Notion-Version 2026-03-11 に対応しました。
+
+### 0.2 Changes in v3.0.0
 
 NotionRubyMapping v3.0.0 now supports Notion-Version 2025-09-03.
 
@@ -41,13 +48,13 @@ NotionRubyMapping v3.0.0 は、Notion-Version 2025-09-03 に対応しました
 これまで Database で実行していた API は、ほとんど DataSource の API に変更になりました。
 そのため、NotionRubyMapping でも新規に DataSource クラスを追加しました。
 
-### 0.2 Changes in v0.7.0
+### 0.3 Changes in v0.7.0
 
 Since the number of Japanese users has increased, we decided to include Japanese as well.  In addition, we have simplified the method of setting up integration tokens.
 
 日本のユーザが増えたので、日本語も併記することにしました。また、インテグレーショントークンの設定方法を簡単にしました。
 
-### 0.3 Changes in v0.6.0
+### 0.4 Changes in v0.6.0
 
 NotionRubyMapping v0.6.0 now supports Notion-Version 2022-06-28.
 ~~In 2022-06-28, property values are no longer returned when retrieving pages.  NotionRubyMapping temporarily creates a Property Object and calls the retrieve a property item API when a value is needed.  Therefore, users do not need to be aware of any differences, and existing scripts should work as they are.~~
@@ -55,7 +62,7 @@ NotionRubyMapping v0.6.0 now supports Notion-Version 2022-06-28.
 NotionRubyMapping v0.6.0 は、Notion-Version 2022-06-28 に対応しました。
 ~~ 2022-06-28 では、ページを取得する際にプロパティ値を返さなくなりました。NotionRubyMapping は、一時的に Property Object を作成し、値が必要なときにプロパティ項目を取得する API を呼び出します。そのため、ユーザーはこの違いを意識する必要はなく、既存のスクリプトはそのまま動作するはずです。~~
 
-### 0.4 Changes in v0.5.0
+### 0.5 Changes in v0.5.0
 
 NotionRubyMapping v0.5.0 now supports block updates.
 For efficiency, subclasses are provided under Block class. As a result, they are no longer compatible with the scripts used in v0.4.0.
@@ -136,6 +143,8 @@ NotionRubyMapping.configuration { |c| c.notion_token = ENV["NOTION_API_TOKEN"] }
 
 ## 3. ChangeLog
 
+- 2027/5/4 [v4.0.1] Add retrieve / update / delete a comment
+- 2027/3/23 [v4.0.0] Add markdown support, headnig_4, toggle_heading_4, and position support for appending blocks
 - 2026/1/25 [v3.0.6] add move page, list templates, and create child page to page
 - 2025/12/15 [v3.0.5] add AudioBlock
 - 2025/12/9 [v3.0.4] Fix the issue where page.parent could not be executed for pages with a data source as parent

data/lib/notion_ruby_mapping/controllers/notion_cache.rb

@@ -101,6 +101,14 @@ module NotionRubyMapping
       "v1/comments"
     end
 
+    def comment_path(comment_id)
+      "v1/comments/#{comment_id}"
+    end
+
+    def comment_request(comment_id)
+      request :get, comment_path(comment_id)
+    end
+
     def complete_a_file_upload_path(file_id)
       "v1/file_uploads/#{file_id}/complete"
     end
@@ -213,6 +221,12 @@ module NotionRubyMapping
       request :delete, block_path(id)
     end
 
+    # @param [String] id
+    # @return [Hash]
+    def destroy_comment_request(id)
+      request :delete, comment_path(id)
+    end
+
     # @param [String] fname
     # @param [String] id
     # @param [Hash] options
@@ -428,6 +442,14 @@ module NotionRubyMapping
       request :patch, block_path(block_id), payload
     end
 
+    def update_comment_request(comment_id, rich_text: nil, markdown: nil)
+      if rich_text
+        request :patch, comment_path(comment_id), {"rich_text" => rich_text}
+      else
+        request :patch, comment_path(comment_id), {"markdown" => markdown}
+      end
+    end
+
     # @param [String] id page_id (with or without "-")
     # @param [Hash] payload
     # def update_database(id, payload)

data/lib/notion_ruby_mapping/objects/comment_object.rb

@@ -4,19 +4,36 @@ module NotionRubyMapping
   # CommentObject
   class CommentObject
     # @param [String] text_objects
-    def initialize(text_objects: nil, json: {})
+    def initialize(id: nil, text_objects: nil, json: {})
+      nc = NotionCache.instance
       if text_objects
+        @id = nc.hex_id id
         @text_objects = RichTextArray.new "rich_text", text_objects: text_objects
         @json = {}
       elsif json
         @json = json
+        @id = nc.hex_id json["id"]
         @text_objects = RichTextArray.new "rich_text", json: json["rich_text"]
       else
         raise StandardError, "Either text_objects or json is required CommentObject"
       end
       @will_update = false
     end
-    attr_reader :will_update, :text_objects, :json
+    attr_reader :will_update, :text_objects, :json, :id
+
+    def self.find(comment_id)
+      new json: NotionCache.instance.comment_request(comment_id)
+    end
+
+    def destroy(dry_run: false)
+      if dry_run
+        Base.dry_run_script :delete, NotionCache.instance.comment_path(id)
+      else
+        json = NotionCache.instance.destroy_comment_request id
+        @text_objects = RichTextArray.new "rich_text", json: json["rich_text"]
+        self
+      end
+    end
 
     def discussion_id
       NotionCache.instance.hex_id @json["discussion_id"]
@@ -26,5 +43,34 @@ module NotionRubyMapping
     def full_text
       @text_objects.full_text
     end
+
+    def markdown=(markdown)
+      @markdown = markdown
+      @will_update = true
+    end
+
+    def rich_text_objects=(text_objects)
+      @text_objects.rich_text_objects = text_objects
+      @will_update = true
+    end
+
+    def save(dry_run: false)
+      return unless @will_update
+
+      if dry_run
+        json = @markdown ? {"markdown" => @markdown} : {"rich_text" => @text_objects.property_values_json}
+        @markdown = nil
+        Base.dry_run_script :patch, NotionCache.instance.comment_path(id), json
+      else
+        json = if @markdown
+                 NotionCache.instance.update_comment_request id, markdown: @markdown
+               else
+                 NotionCache.instance.update_comment_request id, rich_text: @text_objects.property_values_json
+               end
+        @markdown = nil
+        @text_objects = RichTextArray.new "rich_text", json: json["rich_text"]
+        @will_update = false
+      end
+    end
   end
 end

data/lib/notion_ruby_mapping/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module NotionRubyMapping
-  VERSION = "4.0.0"
+  VERSION = "4.0.1"
   NOTION_VERSION = "2026-03-11"
 end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "4.0.3"

data/notion_ruby_mapping.gemspec

@@ -38,6 +38,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "faraday-multipart"
   spec.add_dependency "mime-types"
 
+  spec.add_development_dependency "ostruct"
   spec.add_development_dependency "pry"
   spec.add_development_dependency "pry-byebug"
   spec.add_development_dependency "rb-readline"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: notion_ruby_mapping
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.0.1
 platform: ruby
 authors:
 - Hiroyuki KOBAYASHI
@@ -51,6 +51,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -314,6 +328,7 @@ files:
 - lib/notion_ruby_mapping/properties/url_property.rb
 - lib/notion_ruby_mapping/properties/verification_property.rb
 - lib/notion_ruby_mapping/version.rb
+- mise.toml
 - notion_ruby_mapping.gemspec
 - tools/an
 homepage: https://github.com/hkob/notion_ruby_mapping.git