inky-email 2.0.0.pre.beta.9 → 2.0.0.pre.beta.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c6202164d9e88762cab5c068f5c542908866e5fa2375a9499d52508bcfeb021
-  data.tar.gz: b6d8408457bcce8a404b31ae2c787e07a0dc7575ca33a55ba80624c3abfcf128
+  metadata.gz: 76d1dace37c6af57ebca01bac83c7e33b933ecda3613fb191c0497fdbcc1c209
+  data.tar.gz: 9a047eb4f1b366b81dda1211ee1cf51edf242246f0e7ebfd25dfd1cb995cf3cc
 SHA512:
-  metadata.gz: ed93da1c0e7be40dfaa63919e9645e839d56582ab4d917619408491232f4f3db7ea9553414926a4d5d566e52bd248144ce1672037e8a1a00a0ef1b69ff69b43c
-  data.tar.gz: 3cd33fb5254c38a777c4560697161a7d07935e04eb362c9ecabccbf85e5a1c6c643e7eb98fedad60acf9b66252cf75bc036d9d4068c22433bedae7462339c2a6
+  metadata.gz: 8308281ee9453b803f43c8bab17a68d00b39d3c0d21d8832908d266f774de356b394f28161c53c60d167bbcd5a6ad1333d90882124157eab7361ce26a2f191a7
+  data.tar.gz: d206d052d716c9aa6169cbcc1f9dfb186e5485aea790bcad14c20523967c72bd6fdf0b38b7fa8f0cb248ca37d6abd62a60bf5c2cfc13c09d5947365e0ccfb2b2

data/lib/inky.rb

@@ -10,6 +10,23 @@ require "json"
 module Inky
   VERSION = "2.0.0"
 
+  # Raised when the native inky library reports an error.
+  class Error < StandardError; end
+
+  # Raised when the full build pipeline fails.
+  class BuildError < Error
+    # @return [Array<String>] Non-fatal notes collected before the failure.
+    attr_reader :warnings
+
+    def initialize(message, warnings = [])
+      super(message)
+      @warnings = warnings
+    end
+  end
+
+  # Result of a full pipeline build.
+  BuildResult = Struct.new(:html, :text, :warnings, keyword_init: true)
+
   module Native
     extend Fiddle::Importer
 
@@ -52,20 +69,41 @@ module Inky
     extern "char* inky_migrate_with_details(const char*)"
     extern "char* inky_validate(const char*)"
     extern "char* inky_version()"
+    extern "char* inky_build(const char*, const char*, const char*)"
     extern "void inky_free(char*)"
   end
 
+  # Copy and free a char* result from libinky. A null pointer signals an
+  # internal engine error (or null input).
+  def self.string_result(ptr)
+    raise Error, "inky native call failed (null result)" if ptr.null?
+
+    begin
+      ptr.to_s
+    ensure
+      Native.inky_free(ptr)
+    end
+  end
+  private_class_method :string_result
+
+  def self.check_html!(html)
+    raise TypeError, "html must be a String, got #{html.class}" unless html.is_a?(String)
+  end
+  private_class_method :check_html!
+
   # Transform Inky HTML into email-safe table markup.
   #
   # @param html [String] Inky template HTML
   # @param columns [Integer] Number of grid columns (default: 12)
   # @return [String] Transformed HTML
   def self.transform(html, columns: 12)
-    if columns != 12
-      Native.inky_transform_with_columns(html, columns).to_s
-    else
-      Native.inky_transform(html).to_s
-    end
+    check_html!(html)
+    ptr = if columns != 12
+            Native.inky_transform_with_columns(html, columns)
+          else
+            Native.inky_transform(html)
+          end
+    string_result(ptr)
   end
 
   # Transform Inky HTML and inline CSS from <style> blocks.
@@ -73,7 +111,8 @@ module Inky
   # @param html [String] Inky template HTML with <style> blocks
   # @return [String] Transformed HTML with CSS inlined
   def self.transform_inline(html)
-    Native.inky_transform_inline(html).to_s
+    check_html!(html)
+    string_result(Native.inky_transform_inline(html))
   end
 
   # Migrate v1 Inky syntax to v2.
@@ -81,7 +120,8 @@ module Inky
   # @param html [String] v1 Inky template HTML
   # @return [String] Migrated v2 HTML
   def self.migrate(html)
-    Native.inky_migrate(html).to_s
+    check_html!(html)
+    string_result(Native.inky_migrate(html))
   end
 
   # Migrate v1 syntax and return detailed results.
@@ -89,7 +129,8 @@ module Inky
   # @param html [String] v1 Inky template HTML
   # @return [Hash] Hash with :html and :changes keys
   def self.migrate_with_details(html)
-    json = Native.inky_migrate_with_details(html).to_s
+    check_html!(html)
+    json = string_result(Native.inky_migrate_with_details(html))
     JSON.parse(json, symbolize_names: true)
   end
 
@@ -98,7 +139,8 @@ module Inky
   # @param html [String] Inky template HTML
   # @return [Array<Hash>] Array of hashes with :severity, :rule, :message keys
   def self.validate(html)
-    json = Native.inky_validate(html).to_s
+    check_html!(html)
+    json = string_result(Native.inky_validate(html))
     JSON.parse(json, symbolize_names: true)
   end
 
@@ -106,6 +148,33 @@ module Inky
   #
   # @return [String] Version string
   def self.version
-    Native.inky_version().to_s
+    string_result(Native.inky_version())
+  end
+
+  # Run the full build pipeline: layouts, includes, custom components,
+  # data merge, framework SCSS, component transform, CSS inlining, and
+  # output cleanup — identical to `inky build`.
+  #
+  # @param html [String] Inky template HTML
+  # @param base_path [String, nil] Directory used to resolve layouts,
+  #   includes, custom components, and linked SCSS/CSS
+  # @param options [Hash] inline_css, framework_css, components_dir,
+  #   columns, hybrid, bulletproof_buttons, plain_text, data (Hash of
+  #   merge variables)
+  # @return [BuildResult]
+  # @raise [BuildError] if the pipeline fails; carries #warnings
+  def self.build(html, base_path: nil, **options)
+    check_html!(html)
+    options_json = JSON.generate(options)
+
+    json = string_result(Native.inky_build(html, base_path, options_json))
+    envelope = JSON.parse(json, symbolize_names: true)
+
+    warnings = envelope[:warnings] || []
+    unless envelope[:ok]
+      raise BuildError.new(envelope[:error] || "unknown build error", warnings)
+    end
+
+    BuildResult.new(html: envelope[:html], text: envelope[:text], warnings: warnings)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inky-email
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.beta.9
+  version: 2.0.0.pre.beta.10
 platform: ruby
 authors:
 - ZURB
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-24 00:00:00.000000000 Z
+date: 2026-07-14 00:00:00.000000000 Z
 dependencies: []
 description: Inky converts simple HTML with custom components into email-safe table
   markup. Powered by Rust via Fiddle.