content_block_tools 1.5.1 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c915d105c0d5c7ec20f90a8e697bdbfa6fcc1b0379eb13ff03cc1185e49e326d
-  data.tar.gz: 4cd037fefbf68fbfff42a6149b159b8a1054b3ca1d396c291390f8b4b0b72806
+  metadata.gz: ada84776869d31e963dd84b2c81e612641e4f9d89725525fcce126f5d30c83ca
+  data.tar.gz: 0a02bda2f0661cbd056aca4fe97d0c9bfe5db1ea8ba6d08086192d4eceadf55c
 SHA512:
-  metadata.gz: a590e3fbbdbe0a8d1fa23971bf6db5f6eb02fee0b7dd372df143fa2d17991612c42d5f98364c5ceb137d240c5efb23da63cc863828b47ed38c0637403890f974
-  data.tar.gz: 97c88d5c7773b6cc8672b6f48ebf71f7acf3f9d3b79c96b0fa4a2064ed404c5ecd4b75064edc70776ad845c3a3c18bdefc5a51f95cc9a3ac9b8500d04ee9bb5e
+  metadata.gz: 753f49592ddd8c25daafcb90ff7eea44b378e815a1fc9b363f9ca91de98543605d967966f5801a9472759f5105824f9d1000cad59e1ab638c1f5edd512418ea1
+  data.tar.gz: 0e96c19771c1708e12abeca733fd5ba39c3061266b76e2ea285bddb9a30e57c01b47bbee416dc45f7cbf97c117ff0beeaa49cea4dbfac94e59eb652dbe790c0d

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.1"
 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.1
 platform: ruby
 authors:
 - GOV.UK Dev
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 13.3.0
+        version: 13.3.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 13.3.0
+        version: 13.3.1
 - !ruby/object:Gem::Dependency
   name: rspec-html-matchers
   requirement: !ruby/object:Gem::Requirement
@@ -88,7 +88,7 @@ dependencies:
         version: '6'
     - - "<"
       - !ruby/object:Gem::Version
-        version: 8.0.4
+        version: 8.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -98,7 +98,21 @@ dependencies:
         version: '6'
     - - "<"
       - !ruby/object:Gem::Version
-        version: 8.0.4
+        version: 8.1.2
+- !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
@@ -122,7 +136,7 @@ dependencies:
         version: '6'
     - - "<"
       - !ruby/object:Gem::Version
-        version: 8.0.4
+        version: 8.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -132,7 +146,7 @@ dependencies:
         version: '6'
     - - "<"
       - !ruby/object:Gem::Version
-        version: 8.0.4
+        version: 8.1.2
 - !ruby/object:Gem::Dependency
   name: view_component
   requirement: !ruby/object:Gem::Requirement