axhub-sdk 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd37ef91e2470cae879f3befc575c05691fad1e8f9e6a5f0d97c3d11474792ca
-  data.tar.gz: d03168424435151b5a03b9f86bb5217aaaf45cf61b2b7f57182bc9b5d0dfdd09
+  metadata.gz: 3b10c1b25b0ef95ade74bac6aaf17b6e261a49b0232d7463a8c939d8ad8b7a55
+  data.tar.gz: 18491817e76cc76de8b227abbf88910d0fbac1b598c027785b65f6c171e907ba
 SHA512:
-  metadata.gz: c05eaa6f32beb81585f4993f7dafd06f18dd7d24bb555216ffeba5987bfa989093ebf0b2e750e261221fef964b0daf77b3e691fe82fa04c17a2d4780d4ccbd03
-  data.tar.gz: d3f605c4df1f365a9e9aea32a42de6aad1517c899a6e78a488969935d57263d71c888d5f3c94ee262834b636dca184d6588578f596dc39b0cc4e1812037c87cf
+  metadata.gz: 00b0df6aa064e8d803e1a9d12638ba0333b8808d2fe74be33bd4377bdce2c354e30bda6fcd88bfbc823cf3088e4064eb62c72db2ff0a6eaa9acf48558bb6ced8
+  data.tar.gz: 312dfad9ce25d9b4a1511c792cfa519967f14fb2f2874709e472ec661ee2d4d7d771c293df6e17f84ca7052a7b3baca0f7e3fbbda105b241167c0852dafc5476

data/lib/axhub_sdk/raw_db.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module AxHub
+  # Typed, read-only DTOs + facade for an app's raw (physical Postgres) DB,
+  # mirroring the Go SDK's client.Apps.RawDb() and the Node SDK's sdk.apps.rawDb.
+  #
+  # Read-only: table introspection + row reads. Enabling raw DB and writing rows
+  # are separate concerns (writes go through the deployed app's DATABASE_URL,
+  # not this SDK).
+  RawDbColumn = Struct.new(:name, :data_type, :nullable)
+  RawDbTable = Struct.new(:name, :managed, :columns)
+  RawDbTableRows = Struct.new(:rows, :page, :per_page, :has_more)
+
+  # RawDbClient is the typed raw-DB read facade. Reach it via client.apps.raw_db.
+  # It wraps the generic transport (Client#request), which camelCases response
+  # keys, so the DTOs read camelCase wire keys (dataType/perPage/hasMore) and map
+  # them onto snake_case Struct fields.
+  class RawDbClient
+    def initialize(client)
+      @client = client
+    end
+
+    # Lists the raw DB tables for an app, with typed column metadata.
+    #
+    # F-3 empty semantics: a successful 2xx call that returns an empty array
+    # means the app genuinely has no raw DB tables (raw DB is not enabled, or it
+    # has zero tables). A 4xx authentication/permission failure raises
+    # AxHub::Error instead — so an empty array WITHOUT a raised error means
+    # "empty", not "auth failed" (resolving the ambiguity the raw response
+    # leaves).
+    def tables(app_id)
+      raise Error.new(category: 'validation', code: 'required', message: 'appID is required') if app_id.nil? || app_id.empty?
+
+      resp = @client.request('schemaGetApiV1AppsByAppIDDbTables', path_params: { appID: app_id })
+      (field(resp, 'tables') || []).map { |t| parse_table(t) }
+    end
+
+    # Reads one page of rows from a raw DB table. per_page/page are forwarded as
+    # query params only when set (non-nil); nil uses the backend default page
+    # size.
+    def table_rows(app_id, table, per_page: nil, page: nil)
+      raise Error.new(category: 'validation', code: 'required', message: 'appID and table are required') if app_id.nil? || app_id.empty? || table.nil? || table.empty?
+
+      query = {}
+      query['per_page'] = per_page unless per_page.nil?
+      query['page'] = page unless page.nil?
+      resp = @client.request('schemaGetApiV1AppsByAppIDDbTablesByTableRows', path_params: { appID: app_id, table: table }, query: query)
+      RawDbTableRows.new(
+        field(resp, 'rows') || [],
+        field(resp, 'page'),
+        field(resp, 'perPage'),
+        field(resp, 'hasMore')
+      )
+    end
+
+    private
+
+    # Read a camelCase response key, tolerating string or symbol keys and
+    # preserving false/absent values (no ||-defaulting, so `false` survives).
+    def field(hash, key)
+      return nil unless hash.is_a?(Hash)
+      return hash[key] if hash.key?(key)
+
+      sym = key.to_sym
+      hash.key?(sym) ? hash[sym] : nil
+    end
+
+    def parse_table(raw)
+      RawDbTable.new(
+        field(raw, 'name'),
+        field(raw, 'managed'),
+        (field(raw, 'columns') || []).map { |c| parse_column(c) }
+      )
+    end
+
+    def parse_column(raw)
+      RawDbColumn.new(field(raw, 'name'), field(raw, 'dataType'), field(raw, 'nullable'))
+    end
+  end
+
+  class AppsClient
+    # Typed, read-only raw-DB facade (client.apps.raw_db). Mirrors Go's
+    # client.Apps.RawDb() / Node's sdk.apps.rawDb.
+    def raw_db
+      @raw_db ||= RawDbClient.new(@client)
+    end
+  end
+end

data/lib/axhub_sdk/version.rb

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

data/lib/axhub_sdk.rb

@@ -120,8 +120,10 @@ module AxHub
     "already_suspended" => ErrorInfo.new("conflict", 409, false),
     "already_terminal" => ErrorInfo.new("conflict", 409, false),
     "app_archived" => ErrorInfo.new("precondition_failed", 412, false),
+    "app_suspended" => ErrorInfo.new("precondition_failed", 412, false),
     "app_unavailable" => ErrorInfo.new("conflict", 409, false),
     "auth_expired" => ErrorInfo.new("unavailable", 503, false),
+    "axrouter_disabled" => ErrorInfo.new("conflict", 409, false),
     "bad_request" => ErrorInfo.new("validation", 400, false),
     "build_env_no_override" => ErrorInfo.new("validation", 400, false),
     "cannot_reactivate" => ErrorInfo.new("conflict", 409, false),
@@ -129,7 +131,10 @@ module AxHub
     "confirm_required" => ErrorInfo.new("precondition_failed", 412, false),
     "conflict" => ErrorInfo.new("conflict", 409, false),
     "connector_inactive" => ErrorInfo.new("permission_denied", 403, false),
+    "consent_required" => ErrorInfo.new("precondition_failed", 412, false),
     "cross_tenant" => ErrorInfo.new("validation", 400, false),
+    "directory_not_ready" => ErrorInfo.new("conflict", 409, true),
+    "directory_source_conflict" => ErrorInfo.new("conflict", 409, false),
     "domain_blocked" => ErrorInfo.new("precondition_failed", 422, false),
     "domain_taken" => ErrorInfo.new("conflict", 409, false),
     "duplicate" => ErrorInfo.new("validation", 400, false),
@@ -141,10 +146,15 @@ module AxHub
     "forbidden" => ErrorInfo.new("permission_denied", 403, false),
     "git_connection_required" => ErrorInfo.new("precondition_failed", 412, false),
     "github_device_flow_disabled" => ErrorInfo.new("unavailable", 503, false),
+    "google_access_denied" => ErrorInfo.new("validation", 400, false),
+    "google_domain_taken" => ErrorInfo.new("conflict", 409, false),
+    "google_membership_required" => ErrorInfo.new("validation", 400, false),
+    "google_not_registered" => ErrorInfo.new("validation", 400, false),
     "grant_already_terminal" => ErrorInfo.new("conflict", 409, false),
     "grant_conflict" => ErrorInfo.new("conflict", 409, false),
     "grant_expired" => ErrorInfo.new("permission_denied", 403, false),
     "grant_revoked" => ErrorInfo.new("permission_denied", 403, false),
+    "group_scim_managed" => ErrorInfo.new("conflict", 409, false),
     "internal_error" => ErrorInfo.new("internal", 500, false),
     "invalid_drive" => ErrorInfo.new("validation", 400, false),
     "invalid_entitlement" => ErrorInfo.new("validation", 400, false),
@@ -160,6 +170,7 @@ module AxHub
     "kind_engine_mismatch" => ErrorInfo.new("validation", 400, false),
     "last_admin" => ErrorInfo.new("conflict", 409, false),
     "link_invalid" => ErrorInfo.new("not_found", 404, false),
+    "member_inactive" => ErrorInfo.new("permission_denied", 403, false),
     "no_active_grant" => ErrorInfo.new("not_found", 404, false),
     "no_available_seat" => ErrorInfo.new("conflict", 409, false),
     "no_billing_key" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
@@ -311,3 +322,4 @@ module AxHub
 end
 
 require_relative 'axhub_sdk/operations'
+require_relative 'axhub_sdk/raw_db'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: axhub-sdk
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Jocoding AX Partners
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-03 00:00:00.000000000 Z
+date: 2026-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -51,6 +51,7 @@ files:
 - axhub-sdk.gemspec
 - lib/axhub_sdk.rb
 - lib/axhub_sdk/operations.rb
+- lib/axhub_sdk/raw_db.rb
 - lib/axhub_sdk/version.rb
 homepage: https://github.com/jocoding-ax-partners/axhub-sdk-ruby
 licenses: