content_block_tools 1.5.1 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c915d105c0d5c7ec20f90a8e697bdbfa6fcc1b0379eb13ff03cc1185e49e326d
-  data.tar.gz: 4cd037fefbf68fbfff42a6149b159b8a1054b3ca1d396c291390f8b4b0b72806
+  metadata.gz: 90a58c8f62e62d8a410f3f55b4a9cdb2d754aa4184c1903015604764da38e9af
+  data.tar.gz: ee205849804c1203a1c09d92dfaf09f0c2b1251adff21a987786a947901795c4
 SHA512:
-  metadata.gz: a590e3fbbdbe0a8d1fa23971bf6db5f6eb02fee0b7dd372df143fa2d17991612c42d5f98364c5ceb137d240c5efb23da63cc863828b47ed38c0637403890f974
-  data.tar.gz: 97c88d5c7773b6cc8672b6f48ebf71f7acf3f9d3b79c96b0fa4a2064ed404c5ecd4b75064edc70776ad845c3a3c18bdefc5a51f95cc9a3ac9b8500d04ee9bb5e
+  metadata.gz: 5a44364c60ea81ea57088c0834382c679e3b30d6edc0c50123204992b6c4ab02df72fc56f1a910cf6a385d5b284b7c146d8e04864e5a5c72c2bec3ff159cc356
+  data.tar.gz: 682b1b92a8164c3e1ed07dbb8f3124d9b233bbcc7c1aee7f71db1e82cd0c68adb45012efc7a6305eb59cb773022b2114407c1a4c3628da226322486e940dafe8

data/lib/content_block_tools/content_block.rb

@@ -46,6 +46,38 @@ module ContentBlockTools
 
     attr_reader :content_id, :title, :embed_code
 
+    # Creates a ContentBlock instance from an embed code string by fetching
+    # the content item data from the Content Store API.
+    #
+    # @param embed_code [String] The embed code string to parse and fetch content for
+    #   @example
+    #     ContentBlock.from_embed_code("{{embed:content_block_pension:2b92cade-549c-4449-9796-e7a3957f3a86}}")
+    #
+    # @return [ContentBlock] A new ContentBlock instance populated with data from the Content Store
+    #
+    # @raise [ContentBlockTools::InvalidEmbedCodeError] if the embed code format is invalid
+    # @raise [GdsApi::HTTPErrorResponse] if the API request fails
+    #
+    # @example Create a ContentBlock from an embed code
+    #   embed_code = "{{embed:content_block_email:123e4567-e89b-12d3-a456-426614174000}}"
+    #   content_block = ContentBlock.from_embed_code(embed_code)
+    #   content_block.title #=> "Contact Email"
+    #   content_block.document_type #=> "email"
+    #
+    # @see ContentBlockReference.from_string
+    # @see GdsApi.content_store
+    def self.from_embed_code(embed_code)
+      reference = ContentBlockReference.from_string(embed_code)
+      api_response = GdsApi.content_store.content_item(reference.content_store_identifier)
+      new(
+        content_id: api_response["content_id"],
+        title: api_response["title"],
+        document_type: api_response["document_type"],
+        details: api_response["details"],
+        embed_code:,
+      )
+    end
+
     def initialize(content_id:, title:, document_type:, details:, embed_code:)
       @content_id = content_id
       @title = title

data/lib/content_block_tools/content_block_reference.rb

@@ -45,6 +45,21 @@ module ContentBlockTools
       !identifier.match?(UUID_REGEX)
     end
 
+    # Returns the content store path for this content block reference
+    #
+    # Constructs a path used to identify and retrieve the content block from the content store.
+    # The path follows the format `/content-blocks/{document_type}/{identifier}`.
+    #
+    # @example
+    #   reference = ContentBlockReference.new(document_type: "content_block_contact", identifier: "some-slug", embed_code: "...")
+    #   reference.content_store_identifier
+    #   #=> "/content-blocks/content_block_contact/some-slug"
+    #
+    # @return [String] the content store path for this content block
+    def content_store_identifier
+      "/content-blocks/#{document_type}/#{identifier}"
+    end
+
     class << self
       # Finds all content block references within a document, using `ContentBlockReference::EMBED_REGEX`
       # to scan through the document

data/lib/content_block_tools/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContentBlockTools
-  VERSION = "1.5.1"
+  VERSION = "1.6.0"
 end

data/lib/content_block_tools.rb

@@ -2,6 +2,7 @@
 
 require "action_view"
 require "uri"
+require "gds-api-adapters"
 require "govspeak"
 
 require "content_block_tools/helpers/govspeak"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: content_block_tools
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.6.0
 platform: ruby
 authors:
 - GOV.UK Dev
@@ -99,6 +99,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 8.0.4
+- !ruby/object:Gem::Dependency
+  name: gds-api-adapters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 101.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 101.0.0
 - !ruby/object:Gem::Dependency
   name: govspeak
   requirement: !ruby/object:Gem::Requirement