axhub-sdk 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86b1b04e5aef262ab07bdb552bb11e590488b9c1377e3f94f5bc76f736426fa5
-  data.tar.gz: 5ceef20e46b9480a9787347cd329e2cfd85410f30795ba6cb3f975d60b49c288
+  metadata.gz: b05fc409d0332a6e77331fa9b8d893fde93d99b022b6209f9159faabf3d2d38e
+  data.tar.gz: a8fcbda4d4ec7be14156c3f70e605100e0d372f267826e77d7fe969f986661cf
 SHA512:
-  metadata.gz: 5225e19be9f9a0204e1a3368180a2df7bfced437ac4538799aad4fcbee3e282e268e40086ad3fcfbd937d540c3b17f7086c8c34cd330d87d7d8d3f71602df1a2
-  data.tar.gz: 906db2bde2bc9d6a652aefa9a0b62e70161989705e47056e3a50aa28768be079e7083ce183b65e127eece32d9b684af2f924f08ebc2cf0edf9fd83c22be36116
+  metadata.gz: 1b8e7c144ad7949bbb4eef4453e67f6786b21d5596e2a432aeef7455eee6f6d8424587a971ac1f930718684a1bf0cb1f6d14153b137042fe174dd97b4c1af5a9
+  data.tar.gz: 74b8bca75475ba90f5fb9aed68a1151633dab2a3981990abbd5cff81a41d979b0c79db912e3a63158851aa292b5a4135f2b3884986a821275a1a6b4cc2f7a86e

data/README.md

@@ -25,7 +25,7 @@ export AXHUB_TENANT_SLUG="test"
 
 PAT mode is explicit: `token_type: :pat` sends `X-Api-Key`. JWT mode is `token_type: :jwt` and sends `Authorization: Bearer`.
 
-## Agent quickstart: create a disposable app and table
+## Agent quickstart: create a disposable app and enable its database
 
 ```ruby
 require 'axhub_sdk'
@@ -44,7 +44,6 @@ raise 'authGetApiV1Me did not return a user id' if user_id.nil? || user_id.empty
 
 suffix = (Time.now.to_f * 1000).to_i.to_s[-8, 8]
 slug = "agent-rb-#{suffix}"
-table = "items#{suffix[-6, 6]}"
 
 app = client.apps.create(
   slug: slug,
@@ -57,28 +56,22 @@ app = client.apps.create(
 )
 app_id = app['id']
 
-client.request(
-  'schemaPostApiV1AppsByAppIDTables',
-  path_params: { appID: app_id },
-  body: {
-    table_name: table,
-    owner_column: 'owner_id',
-    columns: [
-      { name: 'owner_id', type: 'uuid', nullable: false },
-      { name: 'title', type: 'text', nullable: false },
-      { name: 'status', type: 'text', nullable: false }
-    ]
-  }
-)
+# Enable raw DB mode: a dedicated Postgres role is issued and DATABASE_URL is
+# injected into the app on its next deploy. The app then does row CRUD over
+# direct SQL with its own pg driver.
+client.request('appsPostApiV1AppsByAppIDRawDb', path_params: { appID: app_id }, body: {})
+
+# Admin introspection/browse of the physical DB.
+tables = client.request('schemaGetApiV1AppsByAppIDDbTables', path_params: { appID: app_id })
 
-puts "created #{app_id} #{table}"
+puts "created #{app_id} #{tables}"
 ```
 
 ## How to call the full API surface
 
 - High-level app create: `client.apps.create(**body)` uses `default_tenant_id`.
 - Any route by operation id: `client.request(operation_id, path_params: {}, query: {}, body: nil)`.
-- Generated facade: `client.data.schema_post_api_v1_apps_by_app_id_tables(path_params: {}, body: {...})`.
+- Generated facade: `client.data.schema_get_api_v1_apps_by_app_id_db_tables(path_params: {})`.
 - Route inventory: `AxHub::ROUTES`, `AxHub::CONTEXT_ROUTES`, `AxHub::ERROR_CODES`, and `AxHub::OPERATION_METHODS`.
 - Errors: catch `AxHub::Error` and branch on `code`, `category`, `status`, and `retryable`.
 
@@ -90,21 +83,15 @@ Use the high-level `apps.create` helper for the first app, then use generated op
 |------|--------------|----------------------|-------------------|
 | Create env var | `appsPostApiV1AppsByAppIDEnvVars` | `appID` | `env.list` includes `key` |
 | Delete env var | `appsDeleteApiV1AppsByAppIDEnvVarsByKey` | `appID`, `key` | `env.list` no longer includes `key` |
-| Create table | `schemaPostApiV1AppsByAppIDTables` | `appID` | response `tableName` equals requested name |
-| Inspect table | `schemaGetApiV1AppsByAppIDTablesByTableName` | `appID`, `tableName` | response `id` and `tableName` match |
-| Add column | `schemaPostApiV1AppsByAppIDTablesByTableNameColumns` | `appID`, `tableName` | inspect contains column name |
-| Drop column | `schemaDeleteApiV1AppsByAppIDTablesByTableNameColumnsByColumnName` | `appID`, `tableName`, `columnName` | inspect no longer contains column name |
-| Add table grant | `schemaPostApiV1AppsByAppIDTablesByTableNameGrants` | `appID`, `tableName` | response has grant `id` |
-| List grants | `schemaGetApiV1AppsByAppIDTablesByTableNameGrants` | `appID`, `tableName` | list contains grant `id` |
-| Revoke/delete grant | `schemaDeleteApiV1AppsByAppIDTablesByTableNameGrantsByGrantID` | `appID`, `tableName`, `grantID` | list still contains grant with `revokedAt` set |
-| Browse admin rows | `schemaGetApiV1AppsByAppIDTablesByTableNameRows` | `appID`, `tableName` | response has `rows` and `columns` arrays |
-| Delete table | `schemaDeleteApiV1AppsByAppIDTablesByTableName` | `appID`, `tableName` | follow-up inspect returns `404` or `410` |
+| Enable raw DB | `appsPostApiV1AppsByAppIDRawDb` | `appID` | dedicated Postgres role issued; `DATABASE_URL` injected on next deploy |
+| Disable raw DB | `appsDeleteApiV1AppsByAppIDRawDb` | `appID` | raw DB mode turned off (data preserved) |
+| List DB tables | `schemaGetApiV1AppsByAppIDDbTables` | `appID` | response lists physical `information_schema` tables |
+| Browse DB rows | `schemaGetApiV1AppsByAppIDDbTablesByTableRows` | `appID`, `table` | response has `rows` array |
 | Delete app | `appsDeleteApiV1AppsByAppID`, then `appsDeleteApiV1AppsByAppIDPermanent` | `appID` | app is soft-deleted, then permanently deleted |
 
 Important semantics from live QA:
 
-- Table delete is hard enough for client assertions: a follow-up table inspect returns `404 not_found` or `410`.
-- Table grant delete is a soft revoke: the grant can remain in `listGrants`, but the same grant id must have `revokedAt` set. Do not assert disappearance.
+- App database access is raw: `appsPostApiV1AppsByAppIDRawDb` issues a dedicated Postgres role and injects `DATABASE_URL` on the next deploy (the connection string is never returned). The app does its own row CRUD via direct SQL; the SDK exposes admin introspection/browse only (`schemaGetApiV1AppsByAppIDDbTables` / `...DbTablesByTableRows`).
 - Deployment creation without a connected git/bootstrap source can return a precondition-style 4xx. That verifies SDK error handling, not a deploy bug.
 
 
@@ -114,7 +101,7 @@ The SDK behavior documented here reflects live production QA against the AX Hub
 
 - Tenant used for destructive QA: slug `test`, id `cc1e58f1-8e46-4ac7-96c1-190c4cdd5b70`.
 - Go, Java, Kotlin, Python, and Ruby each ran the generated all-operation sweep against 189 backend routes: SDK exceptions `0`, backend 5xx `0`.
-- Go, Java, Kotlin, Python, and Ruby each passed strict destructive DB QA: 22 live steps, 17 assertions, 7 cleanup calls. The flow created an app, env var, table, column, table grant, row, then updated, listed, counted, browsed, deleted, and re-read to prove deletion semantics.
+- Go, Java, Kotlin, Python, and Ruby each passed strict destructive DB QA: the flow exercised the raw-DB enable/reset lifecycle (instead of the removed dynamic-table flow), then deleted the app and re-read to prove deletion semantics.
 - Node ran the full production mutation suite and a real app bootstrap/deploy wait. Deployment id `d3a48ce3-0f9c-4bab-aa07-863c31c44460` finished `succeeded`, then the app was deleted permanently.
 
 Do not print tokens. Use short-lived PATs for agent QA and revoke them after the run.

data/lib/axhub_sdk/version.rb

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

data/lib/axhub_sdk.rb

@@ -74,21 +74,6 @@ module AxHub
     { 'method' => "DELETE", 'path' => "/api/v1/apps/{appID}/staging", 'tag' => "Deploy", 'operationId' => "deployDeleteApiV1AppsByAppIDStaging" },
     { 'method' => "PUT", 'path' => "/api/v1/apps/{appID}/staging", 'tag' => "Deploy", 'operationId' => "deployPutApiV1AppsByAppIDStaging" },
     { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/suspend", 'tag' => "Apps", 'operationId' => "appsPostApiV1AppsByAppIDSuspend" },
-    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/tables", 'tag' => "Schema", 'operationId' => "schemaGetApiV1AppsByAppIDTables" },
-    { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/tables", 'tag' => "Schema", 'operationId' => "schemaPostApiV1AppsByAppIDTables" },
-    { 'method' => "DELETE", 'path' => "/api/v1/apps/{appID}/tables/{tableName}", 'tag' => "Schema", 'operationId' => "schemaDeleteApiV1AppsByAppIDTablesByTableName" },
-    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/tables/{tableName}", 'tag' => "Schema", 'operationId' => "schemaGetApiV1AppsByAppIDTablesByTableName" },
-    { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/columns", 'tag' => "Schema", 'operationId' => "schemaPostApiV1AppsByAppIDTablesByTableNameColumns" },
-    { 'method' => "DELETE", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/columns/{columnName}", 'tag' => "Schema", 'operationId' => "schemaDeleteApiV1AppsByAppIDTablesByTableNameColumnsByColumnName" },
-    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/grants", 'tag' => "Schema", 'operationId' => "schemaGetApiV1AppsByAppIDTablesByTableNameGrants" },
-    { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/grants", 'tag' => "Schema", 'operationId' => "schemaPostApiV1AppsByAppIDTablesByTableNameGrants" },
-    { 'method' => "DELETE", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/grants/{grantID}", 'tag' => "Schema", 'operationId' => "schemaDeleteApiV1AppsByAppIDTablesByTableNameGrantsByGrantID" },
-    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/rows", 'tag' => "Schema", 'operationId' => "schemaGetApiV1AppsByAppIDTablesByTableNameRows" },
-    { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/rows", 'tag' => "Schema", 'operationId' => "schemaPostApiV1AppsByAppIDTablesByTableNameRows" },
-    { 'method' => "DELETE", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/rows/{id}", 'tag' => "Schema", 'operationId' => "schemaDeleteApiV1AppsByAppIDTablesByTableNameRowsById" },
-    { 'method' => "PATCH", 'path' => "/api/v1/apps/{appID}/tables/{tableName}/rows/{id}", 'tag' => "Schema", 'operationId' => "schemaPatchApiV1AppsByAppIDTablesByTableNameRowsById" },
-    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/tables/check-availability", 'tag' => "Schema", 'operationId' => "schemaGetApiV1AppsByAppIDTablesCheckAvailability" },
-    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/tables/column-types", 'tag' => "Schema", 'operationId' => "schemaGetApiV1AppsByAppIDTablesColumnTypes" },
     { 'method' => "GET", 'path' => "/api/v1/apps/discover", 'tag' => "Apps", 'operationId' => "appsGetApiV1AppsDiscover" },
     { 'method' => "GET", 'path' => "/api/v1/apps/search", 'tag' => "Apps", 'operationId' => "appsGetApiV1AppsSearch" },
     { 'method' => "DELETE", 'path' => "/api/v1/comments/{commentID}", 'tag' => "Apps", 'operationId' => "appsDeleteApiV1CommentsByCommentID" },
@@ -370,6 +355,22 @@ module AxHub
     authPostOauthRevoke
     authPostOauthToken
   ].freeze
+  # Token-style OAuth responses keep RFC 6749/8628 standard keys in snake_case.
+  # Must match the python SDK's _OAUTH_RESPONSE_SNAKE_CASE_OPERATIONS / _OAUTH_RESPONSE_SNAKE_KEYS.
+  OAUTH_RESPONSE_SNAKE_CASE_OPERATIONS = %w[
+    authPostOauthDeviceAuthorization
+    authPostOauthToken
+  ].freeze
+  OAUTH_RESPONSE_SNAKE_KEYS = %w[
+    access_token token_type expires_in refresh_token id_token scope resource tenant
+  ].freeze
+  def self.camelize_oauth_response(value)
+    case value
+    when Hash then value.map { |k, v| [OAUTH_RESPONSE_SNAKE_KEYS.include?(k.to_s) ? k.to_s : camel(k), camelize_oauth_response(v)] }.to_h
+    when Array then value.map { |v| camelize_oauth_response(v) }
+    else value
+    end
+  end
   class Client
     attr_reader :base_url, :apps
     def initialize(base_url: DEFAULT_BASE_URL, token: nil, token_type: nil, default_tenant_id: nil, default_tenant_slug: nil, timeout_seconds: 30)
@@ -391,7 +392,7 @@ module AxHub
           req.body = JSON.generate(body)
         end
       end
-      _send(req, uri, camelize: true)
+      _send(req, uri, camelize: OAUTH_RESPONSE_SNAKE_CASE_OPERATIONS.include?(operation_id) ? :oauth_snake : true)
     end
 
     private
@@ -429,7 +430,11 @@ 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
-      camelize ? AxHub.camelize(parsed) : parsed
+      case camelize
+      when :oauth_snake then AxHub.camelize_oauth_response(parsed)
+      when true then AxHub.camelize(parsed)
+      else parsed
+      end
     end
 
     def request_id

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: axhub-sdk
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Jocoding AX Partners
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-01 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest