axhub-sdk 0.10.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b774b0d97f8976d6bc3fb143e3b5c9101b71e01bc987d6a21e24595dfbc2a7d6
-  data.tar.gz: a13dd621de01d1fac54c954b136d9c04c0fe686ca7599ae58120d1651d9a2ab5
+  metadata.gz: 3b10c1b25b0ef95ade74bac6aaf17b6e261a49b0232d7463a8c939d8ad8b7a55
+  data.tar.gz: 18491817e76cc76de8b227abbf88910d0fbac1b598c027785b65f6c171e907ba
 SHA512:
-  metadata.gz: c2e1cba9886d561fdf0df10cedc27bda37e5921b4ec43df87a64718a66ccb1164d7ad6f896d1cb0cba66926c397b93e3aeb9799884de6810dca31ed4a832b482
-  data.tar.gz: 0d5213ed092b214cd1f1081be2ca7d16c4fe155aee8bbd24fc7ad64f5adad98e7d7399104c48d6b9cf2aae1c83919f7aeaa3f23962e00bde8074be4b81878a81
+  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.10.0'
+  VERSION = '0.13.0'
 end

data/lib/axhub_sdk.rb

@@ -95,6 +95,7 @@ module AxHub
     { 'method' => "GET", 'path' => "/api/v1/tenants/{tenantID}/me/connectors", 'tag' => "Gateway", 'operationId' => "gatewayGetApiV1TenantsByTenantIDMeConnectors" },
     { 'method' => "GET", 'path' => "/api/v1/tenants/{tenantID}/me/connectors/{connectorID}/resources", 'tag' => "Gateway", 'operationId' => "gatewayGetApiV1TenantsByTenantIDMeConnectorsByConnectorIDResources" },
     { 'method' => "GET", 'path' => "/api/v1/tenants/{tenantID}/me/grants", 'tag' => "Authorization", 'operationId' => "authorizationGetApiV1TenantsByTenantIDMeGrants" },
+    { 'method' => "GET", 'path' => "/api/v1/tenants/{tenantID}/members/directory", 'tag' => "Tenants", 'operationId' => "tenantsGetApiV1TenantsByTenantIDMembersDirectory" },
     { 'method' => "GET", 'path' => "/api/v1/tenants/{tenantID}/org-directory", 'tag' => "Tenants", 'operationId' => "tenantsGetApiV1TenantsByTenantIDOrgDirectory" },
     { 'method' => "GET", 'path' => "/api/v1/users/me/apps", 'tag' => "Apps", 'operationId' => "appsGetApiV1UsersMeApps" },
     { 'method' => "POST", 'path' => "/auth/logout", 'tag' => "Auth", 'operationId' => "authPostAuthLogout" },
@@ -119,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),
@@ -128,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),
@@ -140,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),
@@ -159,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),
@@ -310,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.10.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: