notion_to_md 3.0.0.beta1 → 3.0.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2671f75f28373209f1846e06ed528f7adcc9d857da3fde4d1b0a5e43144c5850
-  data.tar.gz: 39c65f58ff9432277667c0c5c2597561d1b28d9252a7868ec2b8885d0e94e07a
+  metadata.gz: 3892953f8ab81cb3c4ff219452e8daf615997b27b41aedcd64984d127fcc2d6e
+  data.tar.gz: d85c49651c090a1fbd47d0fd57584b71ec7e76955147c9a4526b60ffd496c354
 SHA512:
-  metadata.gz: 3c1571b5b93eb39bccb66032db2296d84b1d02313a6098e3d0e0f03022bfbea5eb0d46b54ae20b7bed6a9a5d6e79721922623491b5b1b829060e08b09cb67114
-  data.tar.gz: 5eea9bf71539d0d6c66880c89a39950c42da4c67767d651b1e218ebb380539b27c5b3ed5f00c18c77a13f547db9edc21f3645bb66e4c3e6204d08b59085da0fa
+  metadata.gz: 7414f7b60612f7dbf9565b4e5d97d0f6c96c389abd5f0c0d46906711621d99e5e617fcf94e2809e483f244438f9184dacc4ba043bc52d6129909a93ae05229cc
+  data.tar.gz: 6a4520688e495502e140e170f69ff78fa55ead84021e0bb8e2cbc99615fd30d87be3bb613ee18a253a0c41403567b0786f44f78f6654c9c272f690aeddb1c176

data/lib/notion_to_md/database.rb

@@ -35,16 +35,7 @@ class NotionToMd
       #
       # @see .build
       def call(id:, notion_client:, filter: nil, sorts: nil, frontmatter: false)
-        metadata = notion_client.database(database_id: id)
-        pages = Builder.call(
-          database_id: id,
-          notion_client: notion_client,
-          filter: filter,
-          sorts: sorts,
-          frontmatter: frontmatter
-        )
-
-        new(metadata: metadata, children: pages)
+        new(id: id, notion_client: notion_client, filter: filter, sorts: sorts, frontmatter: frontmatter).call
       end
 
       # @!method build(...)
@@ -52,6 +43,15 @@ class NotionToMd
       alias build call
     end
 
+    # @return [String] The Notion id database.
+    attr_reader :id
+
+    # @param jNotion::Client] The Notion API client.
+    attr_reader :notion_client
+
+    # @return [Hash] The database configuration options.
+    attr_reader :config
+
     # @return [Object] The metadata associated with the database.
     attr_reader :metadata
 
@@ -64,13 +64,42 @@ class NotionToMd
 
     # Initialize a new database representation.
     #
-    # @param metadata [Object] The Notion database metadata.
-    # @param children [Array<NotionToMd::Page>] The pages belonging to the database.
-    def initialize(metadata:, children:)
-      @metadata = metadata
-      @children = children
+    # @param id [String] The Notion database ID.
+    # @param notion_client [Notion::Client] The Notion API client.
+    # @param filter [Hash, nil] Optional filter criteria to pass to the Notion API.
+    # @param sorts [Array<Hash>, nil] Optional sort criteria.
+    # @param frontmatter [Boolean] Whether to include frontmatter in each page’s Markdown output.
+    def initialize(id:, notion_client:, filter:, sorts:, frontmatter: false)
+      @id = id
+      @notion_client = notion_client
+      @config = {
+        frontmatter: frontmatter,
+        filter: filter,
+        sorts: sorts
+      }
     end
 
+    # Fetch database metadata and contained pages from the Notion API.
+    #
+    # This method populates the database's metadata and children by making API calls
+    # to retrieve the database structure and all pages contained within it, applying
+    # any configured filters and sorting criteria.
+    #
+    # @return [NotionToMd::Database] returns self to allow method chaining.
+    def call
+      @metadata = notion_client.database(database_id: id)
+      @children = Builder.call(
+        database_id: id,
+        notion_client: notion_client,
+        filter: config[:filter],
+        sorts: config[:sorts],
+        frontmatter: config[:frontmatter]
+      )
+      self
+    end
+
+    alias build call
+
     # Convert all database pages into Markdown.
     #
     # @return [Array<String>] Markdown documents for each page in the database.

data/lib/notion_to_md/page.rb

@@ -28,10 +28,7 @@ class NotionToMd
       #
       # @see .build
       def call(id:, notion_client:, frontmatter: false)
-        metadata = notion_client.page(page_id: id)
-        blocks = Builder.call(block_id: id, notion_client: notion_client)
-
-        new(metadata: metadata, children: blocks, frontmatter: frontmatter)
+        new(id: id, notion_client: notion_client, frontmatter: frontmatter).call
       end
 
       # @!method build(...)
@@ -39,6 +36,15 @@ class NotionToMd
       alias build call
     end
 
+    # @return [String] The Notion id page.
+    attr_reader :id
+
+    # @param jNotion::Client] The Notion API client.
+    attr_reader :notion_client
+
+    # @param [Hash] The page configuration options.
+    attr_reader :config
+
     # @return [Object] The metadata associated with the page.
     attr_reader :metadata
 
@@ -51,15 +57,29 @@ class NotionToMd
 
     # Initialize a new Page.
     #
-    # @param metadata [Object] The Notion page metadata.
-    # @param children [Array<#to_md>] The block children belonging to the page.
+    # @param id [String] The Notion page ID.
+    # @param notion_client [Notion::Client] The Notion API client.
     # @param frontmatter [Boolean] Whether to include frontmatter in the Markdown output.
-    def initialize(metadata:, children:, frontmatter: false)
-      @metadata = metadata
-      @children = children
+    def initialize(id:, notion_client:, frontmatter: false)
+      @id = id
+      @notion_client = notion_client
       @config = { frontmatter: frontmatter }
     end
 
+    # Fetch page data and child blocks from the Notion API.
+    #
+    # This method populates the page's metadata and children by making API calls
+    # to retrieve the page content and its nested blocks.
+    #
+    # @return [NotionToMd::Page] returns self to allow method chaining.
+    def call
+      @metadata = notion_client.page(page_id: id)
+      @children = Builder.call(block_id: id, notion_client: notion_client)
+      self
+    end
+
+    alias build call
+
     # Render the body of the page (Markdown representation of its blocks).
     #
     # @return [String] The Markdown content of the page.
@@ -71,7 +91,7 @@ class NotionToMd
     #
     # @return [Boolean]
     def frontmatter?
-      @config[:frontmatter]
+      config[:frontmatter]
     end
 
     # Render the page as a Markdown string, including optional frontmatter.

data/lib/notion_to_md/support/frontmatter.rb

@@ -43,8 +43,6 @@ class NotionToMd
         CONTENT
       end
 
-      private
-
       # Merge custom and default properties into the final set of frontmatter properties.
       #
       # @return [Hash{String => Object}]
@@ -52,6 +50,8 @@ class NotionToMd
         @frontmatter_properties ||= frontmatter_custom_properties.deep_merge(frontmatter_default_properties)
       end
 
+      private
+
       # Retrieve sanitized custom properties.
       #
       # @return [Hash{String => Object}]
@@ -101,7 +101,7 @@ class NotionToMd
       # @return [Hash{String => Object}]
       def frontmatter_default_properties
         @frontmatter_default_properties ||= {
-          'id' => id,
+          'id' => metadata['id'],
           'title' => escape_frontmatter_value(title),
           'created_time' => created_time,
           'cover' => cover,

data/lib/notion_to_md/support/metadata_properties.rb

@@ -27,11 +27,6 @@ class NotionToMd
         base.def_delegators :metadata, :properties
       end
 
-      # @return [String] The Notion record ID.
-      def id
-        metadata[:id]
-      end
-
       # Extract the page or database title.
       #
       # @return [String] Plain text concatenated from `title` property.

data/lib/notion_to_md/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class NotionToMd
-  VERSION = '3.0.0.beta1'
+  VERSION = '3.0.0.beta2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: notion_to_md
 version: !ruby/object:Gem::Version
-  version: 3.0.0.beta1
+  version: 3.0.0.beta2
 platform: ruby
 authors:
 - Enrique Arias
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-31 00:00:00.000000000 Z
+date: 2025-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport