axhub-sdk 0.2.0 → 0.3.0

data/lib/axhub_sdk/data.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+# Ergonomic data layer for the AX Hub Ruby SDK.
+#
+# Public surface (mirrors the node `resources/data` layer):
+#
+#   client.tenant(tenant_slug).app(app_slug).data.table(name_or_schema)
+#   client.tenant(tenant_slug).app(app_slug).data.discover(table)
+#
+# returns a DataTableClient with list / list_all / count / get / insert /
+# insert_many / update / delete, plus the predicate DSL (where(col).eq(v) /
+# and_(...) / block form), define_schema(...), and offset-only pagination.
+require_relative 'data/errors'
+require_relative 'data/dsl/schema'
+require_relative 'data/dsl/ops'
+require_relative 'data/dsl/validation'
+require_relative 'data/pagination'
+require_relative 'data/projection'
+require_relative 'data/where_serializer'
+require_relative 'data/schema_cache'
+require_relative 'data/discover'
+require_relative 'data/client'
+
+module AxHub
+  module Data
+    # Fluent scope wrappers so the public chain reads `client.tenant(t).app(a).data`
+    # (mirrors node/python, where `.data` on the app scope yields the ergonomic
+    # AppDataFactory). `client.data` itself stays the operation-id OperationClient.
+    class AppScope
+      attr_reader :data
+
+      def initialize(ergo_data, tenant_slug, app_slug)
+        # `ergo_data` is the single per-client DataClient (memoized on Client), so
+        # its schema cache persists across every tenant().app() chain — node parity.
+        @data = ergo_data.scoped(tenant_slug).app(app_slug)
+      end
+    end
+
+    class TenantScope
+      def initialize(ergo_data, tenant_slug)
+        @ergo_data = ergo_data
+        @tenant_slug = tenant_slug
+      end
+
+      def app(app_slug)
+        AppScope.new(@ergo_data, @tenant_slug, app_slug)
+      end
+    end
+  end
+
+  # --- Ergonomic data layer fluent surface (mirrors node client.tenant().app().data) ---
+  # `client.data` stays the operation-id route-table OperationClient (the
+  # conformance vectors + e2e tests depend on it). The ergonomic data layer is
+  # reached only through the tenant/app fluent chain, exactly as in node/python.
+  class Client
+    # The single per-client ergonomic DataClient, lazily memoized so the schema
+    # cache (TTL/negative-TTL/LRU) survives across tenant().app() chains (mirrors
+    # node, where `data` is one per-SDK DataClient).
+    def ergo_data
+      @ergo_data ||= AxHub::Data::DataClient.new(self, schema_cache: @schema_cache_opt)
+    end
+
+    def tenant(tenant_slug)
+      AxHub::Data::TenantScope.new(ergo_data, tenant_slug)
+    end
+  end
+end

data/lib/axhub_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AxHub
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/axhub_sdk.rb

@@ -290,6 +290,30 @@ module AxHub
           req.body = JSON.generate(body)
         end
       end
+      _send(req, uri, camelize: true)
+    end
+
+    # Raw-path transport for endpoints with no generated operation-id facade
+    # (the ergonomic data ring: dynamic CRUD + runtime schema discover). `path`
+    # is already fully substituted; `query` keys may be array-valued so repeated
+    # filter params (e.g. `tag=eq.a&tag=eq.b`) serialize via URI.encode_www_form.
+    # Defaults to `camelize: false` to mirror the node data transport: row bodies
+    # and list envelopes (`has_more`/`per_page`) are returned verbatim.
+    def request_raw(method, path, query: {}, body: nil, camelize: false)
+      uri = URI(@base_url + path); uri.query = URI.encode_www_form(query) unless query.nil? || query.empty?
+      req_class = Net::HTTP.const_get(method.to_s.capitalize); req = req_class.new(uri); req['X-Request-ID'] = request_id
+      unless body.nil?
+        req['Content-Type'] = 'application/json'; req.body = JSON.generate(body)
+      end
+      _send(req, uri, camelize: camelize)
+    end
+
+    private
+
+    # Shared auth + send + redirect policy + response/error normalization tail.
+    # `camelize: true` mirrors the operation-id `request` path (snake->camel
+    # rewriting); `camelize: false` returns parsed JSON verbatim (data ring).
+    def _send(req, uri, camelize:)
       if @token
         case @token_type
         when :pat then req['X-Api-Key'] = @token
@@ -319,9 +343,9 @@ module AxHub
         retryable = err.key?('retryable') ? !!err['retryable'] : !!info&.retryable
         raise Error.new(category: err['category'] || info&.category || 'unknown', code: err['code'] || "http_#{res.code}", message: err['message'], status: res.code.to_i, retryable: retryable, request_id: err['request_id'] || err['requestId'])
       end
-      AxHub.camelize(parsed)
+      camelize ? AxHub.camelize(parsed) : parsed
     end
-    private
+
     def request_id
       (Time.now.to_i.to_s + SecureRandom.hex(16))[0, 26]
     end
@@ -352,3 +376,4 @@ module AxHub
 end
 
 require_relative 'axhub_sdk/operations'
+require_relative 'axhub_sdk/data'

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: axhub-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Jocoding AX Partners
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
-dependencies: []
+date: 2026-06-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !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: Ruby SDK for AX Hub API route facades, error metadata, and conformance-tested
   client behavior.
 email:
@@ -22,6 +50,17 @@ files:
 - README.md
 - axhub-sdk.gemspec
 - lib/axhub_sdk.rb
+- lib/axhub_sdk/data.rb
+- lib/axhub_sdk/data/client.rb
+- lib/axhub_sdk/data/discover.rb
+- lib/axhub_sdk/data/dsl/ops.rb
+- lib/axhub_sdk/data/dsl/schema.rb
+- lib/axhub_sdk/data/dsl/validation.rb
+- lib/axhub_sdk/data/errors.rb
+- lib/axhub_sdk/data/pagination.rb
+- lib/axhub_sdk/data/projection.rb
+- lib/axhub_sdk/data/schema_cache.rb
+- lib/axhub_sdk/data/where_serializer.rb
 - lib/axhub_sdk/operations.rb
 - lib/axhub_sdk/version.rb
 homepage: https://github.com/jocoding-ax-partners/axhub-sdk-ruby