hecks 0.2.0 → 1.0.0

data/lib/hecks/ports/query.rb

@@ -0,0 +1,36 @@
+module Hecks
+  module Ports
+    # Common query execution boundary. Adapters expose one optional native
+    # hook; all other query behavior remains in the shared interpreter.
+    # Ordering (the meaning of an ask's answer order) and InMemory (the
+    # fallback engine for stores with no query engine of their own) are
+    # its collaborators — query/ordering.rb and query/in_memory.rb.
+    module Query
+      class Unsupported < StandardError; end
+
+      module_function
+
+      def execute(repository, specification, args = {}, context: {})
+        adapter = repository.respond_to?(:adapter) ? repository.adapter : repository
+        return nil unless adapter.respond_to?(:query)
+
+        validate!(specification, adapter)
+        adapter.query(specification, args, context: context)
+      end
+
+      def validate!(specification, adapter)
+        if specification.cursor && specification.offset
+          raise Unsupported, "a query cannot combine cursor and offset pagination"
+        end
+
+        return if specification.inspection.nil? || adapter.respond_to?(:inspect_query)
+        return if specification.inspection.mode.to_s == "sql" && adapter.respond_to?(:query)
+
+        raise Unsupported, "#{adapter.class} cannot inspect generated queries"
+      end
+    end
+  end
+end
+
+require_relative "query/ordering"
+require_relative "query/in_memory"

data/lib/hecks/ports.rb

@@ -0,0 +1,27 @@
+# Hecks::Ports
+#
+# The runtime's named boundaries. Each port is a file beside this one —
+# `ports/persistence.rb`, `ports/query.rb`, … — and a port with supporting
+# cast keeps it in a same-named directory (`ports/persistence/` holds the
+# binding policy, the journal-translation lineage, the repository factory).
+# The `.port` files beside them are the DSL declarations the meta-validator
+# and the Folder adapter load as data.
+
+module Hecks
+  module Ports
+  end
+end
+
+require_relative "ports/loading"
+require_relative "ports/persistence"
+require_relative "ports/query"
+require_relative "ports/projection"
+require_relative "ports/extraction"
+require_relative "ports/identity_generation"
+require_relative "ports/authorization"
+require_relative "ports/identity_resolution"
+require_relative "ports/authentication"
+require_relative "ports/access_control"
+require_relative "ports/identity_assignment"
+require_relative "ports/agent"
+require_relative "ports/clock"