lcp-sdk 1.0.0

data/lib/schema_validator.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "json"
+
+module LcpSdk
+  class SchemaValidationError < StandardError; end
+
+  class SchemaValidator
+    def initialize(schema_documents)
+      require "json_schemer"
+      # Keep a private copy so self-references in core.json can be made
+      # fragment-local without mutating the caller's canonical documents.
+      @documents = schema_documents.transform_values do |document|
+        JSON.parse(JSON.generate(document))
+      end
+      @documents.each_value do |document|
+        rewrite_core_refs(document) if document["$id"] == "https://lcp.dev/schemas/core.json"
+      end
+      @ids = {}
+      @documents.each do |name, document|
+        id = document.fetch("$id", name)
+        @ids[normalize(name)] = id
+        @ids[normalize(id)] = id
+      end
+    end
+
+    def self.from_directory(root)
+      documents = {}
+      Dir.glob(File.join(root, "**", "*.json")).each do |path|
+        name = path.delete_prefix("#{root}/")
+        documents[name] = JSON.parse(File.read(path))
+      end
+      new(documents)
+    end
+
+    def validate(schema_name, instance)
+      id = @ids.fetch(normalize(schema_name)) { raise KeyError, "unknown LCP schema: #{schema_name}" }
+      schema = @documents.values.find { |candidate| candidate["$id"] == id } || @documents.fetch(schema_name)
+      errors = JSONSchemer.schema(schema, ref_resolver: lambda do |uri|
+        reference = uri.to_s
+        @documents.values.find { |candidate| candidate["$id"].to_s == reference } ||
+          @documents[reference] ||
+          @documents[reference.sub(%r{.*/}, "")]
+      end).validate(instance).to_a
+      raise SchemaValidationError, "LCP schema validation failed for #{schema_name}: #{errors.first}" unless errors.empty?
+      true
+    end
+
+    def validate_envelope(envelope)
+      validate("schemas/envelope.json", envelope)
+      type = envelope.dig("lcp", "message", "type")
+      raise SchemaValidationError, "missing lcp.message.type" unless type.is_a?(String)
+      validate("schemas/#{type}.json", envelope.dig("lcp", "payload"))
+    end
+
+    def validate_offer(offer)
+      validate("schemas/offer.json", offer)
+    end
+
+    def validate_vertical(vertical, attributes)
+      validate("verticals/#{vertical}.json", attributes)
+    end
+
+    private
+
+    def rewrite_core_refs(value)
+      case value
+      when Hash
+        if value["$ref"].is_a?(String)
+          value["$ref"] = value["$ref"].sub(/\Acore\.json(?=#)/, "")
+        end
+        value.each_value { |child| rewrite_core_refs(child) }
+      when Array
+        value.each { |child| rewrite_core_refs(child) }
+      end
+    end
+
+    def normalize(name)
+      name.to_s.tr("\\", "/").sub(%r{^/}, "").sub(%r{^(schemas|verticals)/}, "").sub(/\.json$/, "")
+    end
+  end
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: lcp-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Spear Systems
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Signing, envelopes, webhooks, and HTTP helpers for LCP.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/generated_models.rb
+- lib/lcp_sdk.rb
+- lib/schema-bundle.json
+- lib/schema_validator.rb
+licenses:
+- Apache-2.0
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: LCP Lead Context Protocol SDK
+test_files: []