axhub-sdk 0.11.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd37ef91e2470cae879f3befc575c05691fad1e8f9e6a5f0d97c3d11474792ca
-  data.tar.gz: d03168424435151b5a03b9f86bb5217aaaf45cf61b2b7f57182bc9b5d0dfdd09
+  metadata.gz: 67bbfecc3f9ceab5a20c5e35920623899eaf38d5acf54808cc846dee778a6bcc
+  data.tar.gz: '08d6f4a290545f52c5e7e4e27e62343964b5578f2aa3ebb287d58f3ce308bb9a'
 SHA512:
-  metadata.gz: c05eaa6f32beb81585f4993f7dafd06f18dd7d24bb555216ffeba5987bfa989093ebf0b2e750e261221fef964b0daf77b3e691fe82fa04c17a2d4780d4ccbd03
-  data.tar.gz: d3f605c4df1f365a9e9aea32a42de6aad1517c899a6e78a488969935d57263d71c888d5f3c94ee262834b636dca184d6588578f596dc39b0cc4e1812037c87cf
+  metadata.gz: 7c15edfcf2ba43df4ca9c25a101646dd79132263ce67b4cc194825ef16564c752ce71cc2e13f7dffa096942126265e59be5af30cf77a4e34e726ba29d3372c81
+  data.tar.gz: c04c21e280784aef401205493e2c69e844c6ddc0378f87f964fbaf6a6a2d3737cbad7af7e0c0b1f38fc97fc4e0cf84920d903b7744332a5426a2afe77552a33f

data/lib/axhub_sdk/operations.rb

@@ -16,7 +16,7 @@ module AxHub
   end
 
   class Client
-    attr_reader :identity, :tenants, :authz, :audit, :gateway, :data, :deployments
+    attr_reader :identity, :tenants, :authz, :audit, :gateway, :data, :deployments, :notifications
     alias __axhub_original_initialize initialize unless method_defined?(:__axhub_original_initialize)
     def initialize(*args, **kwargs)
       __axhub_original_initialize(*args, **kwargs)
@@ -27,6 +27,7 @@ module AxHub
       @gateway = OperationClient.new(self)
       @data = OperationClient.new(self)
       @deployments = OperationClient.new(self)
+      @notifications = OperationClient.new(self)
     end
   end
 

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.14.0'
 end

data/lib/axhub_sdk.rb

@@ -19,6 +19,12 @@ module AxHub
     { 'method' => "GET", 'path' => "/.well-known/jwks.json", 'tag' => "Auth", 'operationId' => "authGetWellKnownJwksJson" },
     { 'method' => "GET", 'path' => "/.well-known/oauth-authorization-server", 'tag' => "Auth", 'operationId' => "authGetWellKnownOauthAuthorizationServer" },
     { 'method' => "GET", 'path' => "/.well-known/openid-configuration", 'tag' => "Auth", 'operationId' => "authGetWellKnownOpenidConfiguration" },
+    { 'method' => "GET", 'path' => "/api/v1/access-requests", 'tag' => "Apps", 'operationId' => "appsGetApiV1AccessRequests" },
+    { 'method' => "POST", 'path' => "/api/v1/access-requests", 'tag' => "Apps", 'operationId' => "appsPostApiV1AccessRequests" },
+    { 'method' => "PATCH", 'path' => "/api/v1/access-requests/{id}/approve", 'tag' => "Apps", 'operationId' => "appsPatchApiV1AccessRequestsByIdApprove" },
+    { 'method' => "PATCH", 'path' => "/api/v1/access-requests/{id}/reject", 'tag' => "Apps", 'operationId' => "appsPatchApiV1AccessRequestsByIdReject" },
+    { 'method' => "POST", 'path' => "/api/v1/app/mails", 'tag' => "Notifications", 'operationId' => "notificationsPostApiV1AppMails" },
+    { 'method' => "POST", 'path' => "/api/v1/app/notifications", 'tag' => "Notifications", 'operationId' => "notificationsPostApiV1AppNotifications" },
     { 'method' => "DELETE", 'path' => "/api/v1/apps/{appID}", 'tag' => "Apps", 'operationId' => "appsDeleteApiV1AppsByAppID" },
     { 'method' => "GET", 'path' => "/api/v1/apps/{appID}", 'tag' => "Apps", 'operationId' => "appsGetApiV1AppsByAppID" },
     { 'method' => "PATCH", 'path' => "/api/v1/apps/{appID}", 'tag' => "Apps", 'operationId' => "appsPatchApiV1AppsByAppID" },
@@ -34,6 +40,7 @@ module AxHub
     { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/deployments", 'tag' => "Deploy", 'operationId' => "deployPostApiV1AppsByAppIDDeployments" },
     { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/deployments/{did}", 'tag' => "Deploy", 'operationId' => "deployGetApiV1AppsByAppIDDeploymentsByDid" },
     { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/deployments/{did}/cancel", 'tag' => "Deploy", 'operationId' => "deployPostApiV1AppsByAppIDDeploymentsByDidCancel" },
+    { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/deployments/{did}/diagnoses", 'tag' => "Deploy", 'operationId' => "deployGetApiV1AppsByAppIDDeploymentsByDidDiagnoses" },
     { 'method' => "POST", 'path' => "/api/v1/apps/{appID}/deployments/{did}/rollback", 'tag' => "Deploy", 'operationId' => "deployPostApiV1AppsByAppIDDeploymentsByDidRollback" },
     { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/diagnosis", 'tag' => "Deploy", 'operationId' => "deployGetApiV1AppsByAppIDDiagnosis" },
     { 'method' => "GET", 'path' => "/api/v1/apps/{appID}/env-vars", 'tag' => "Apps", 'operationId' => "appsGetApiV1AppsByAppIDEnvVars" },
@@ -67,6 +74,9 @@ module AxHub
     { 'method' => "GET", 'path' => "/api/v1/me/apps/owned", 'tag' => "Apps", 'operationId' => "appsGetApiV1MeAppsOwned" },
     { 'method' => "GET", 'path' => "/api/v1/me/apps/received", 'tag' => "Apps", 'operationId' => "appsGetApiV1MeAppsReceived" },
     { 'method' => "GET", 'path' => "/api/v1/me/apps/workspace", 'tag' => "Apps", 'operationId' => "appsGetApiV1MeAppsWorkspace" },
+    { 'method' => "GET", 'path' => "/api/v1/me/notifications", 'tag' => "Notifications", 'operationId' => "notificationsGetApiV1MeNotifications" },
+    { 'method' => "POST", 'path' => "/api/v1/me/notifications/{notificationID}/read", 'tag' => "Notifications", 'operationId' => "notificationsPostApiV1MeNotificationsByNotificationIDRead" },
+    { 'method' => "POST", 'path' => "/api/v1/me/notifications/read-all", 'tag' => "Notifications", 'operationId' => "notificationsPostApiV1MeNotificationsReadAll" },
     { 'method' => "GET", 'path' => "/api/v1/me/personal-access-tokens", 'tag' => "Schema", 'operationId' => "schemaGetApiV1MePersonalAccessTokens" },
     { 'method' => "POST", 'path' => "/api/v1/me/personal-access-tokens", 'tag' => "Schema", 'operationId' => "schemaPostApiV1MePersonalAccessTokens" },
     { 'method' => "DELETE", 'path' => "/api/v1/me/personal-access-tokens/{patID}", 'tag' => "Schema", 'operationId' => "schemaDeleteApiV1MePersonalAccessTokensByPatID" },
@@ -120,31 +130,43 @@ 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),
-    "charge_failed" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "charge_failed" => ErrorInfo.new("payment_required", 402, false),
     "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),
+    "egress_blocked" => ErrorInfo.new("validation", 400, false),
     "empty" => ErrorInfo.new("validation", 400, false),
     "exceeds_max" => ErrorInfo.new("conflict", 409, false),
     "expiry_in_past" => ErrorInfo.new("validation", 400, false),
+    "feature_disabled" => ErrorInfo.new("permission_denied", 403, false),
     "feature_not_in_plan" => ErrorInfo.new("permission_denied", 403, false),
     "final_visibility_too_wide" => ErrorInfo.new("validation", 400, false),
     "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),
@@ -155,15 +177,18 @@ module AxHub
     "invalid_seat_count" => ErrorInfo.new("validation", 400, false),
     "invalid_state_transition" => ErrorInfo.new("conflict", 409, false),
     "invalid_target" => ErrorInfo.new("conflict", 409, false),
+    "invalid_tls_mode" => ErrorInfo.new("validation", 400, false),
+    "invalid_token" => ErrorInfo.new("unauthenticated", 401, false),
     "invalid_value" => ErrorInfo.new("validation", 400, false),
     "invitation_expired" => ErrorInfo.new("not_found", 410, false),
     "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),
-    "no_payment_method" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "no_billing_key" => ErrorInfo.new("payment_required", 402, false),
+    "no_payment_method" => ErrorInfo.new("payment_required", 402, false),
     "not_admin" => ErrorInfo.new("permission_denied", 403, false),
     "not_allowed" => ErrorInfo.new("validation", 400, false),
     "not_deleted" => ErrorInfo.new("conflict", 409, false),
@@ -173,8 +198,8 @@ module AxHub
     "not_promotable" => ErrorInfo.new("precondition_failed", 412, false),
     "not_suspended" => ErrorInfo.new("conflict", 409, false),
     "oauth_denied" => ErrorInfo.new("validation", 400, false),
-    "payment_failed" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
-    "payment_required" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "payment_failed" => ErrorInfo.new("payment_required", 402, false),
+    "payment_required" => ErrorInfo.new("payment_required", 402, false),
     "pending_exists" => ErrorInfo.new("conflict", 409, false),
     "pending_review_exists" => ErrorInfo.new("precondition_failed", 412, false),
     "permanently_deleted" => ErrorInfo.new("not_found", 410, false),
@@ -182,33 +207,45 @@ module AxHub
     "precondition_failed" => ErrorInfo.new("precondition_failed", 412, false),
     "preset_in_use" => ErrorInfo.new("conflict", 409, false),
     "preset_mismatch" => ErrorInfo.new("validation", 400, false),
-    "preset_not_in_plan" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "preset_not_in_plan" => ErrorInfo.new("payment_required", 402, false),
     "prod_deploy_required" => ErrorInfo.new("precondition_failed", 412, false),
     "promote_in_progress" => ErrorInfo.new("precondition_failed", 412, true),
-    "quota_exceeded" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "promote_snapshot_missing" => ErrorInfo.new("precondition_failed", 412, false),
+    "quota_exceeded" => ErrorInfo.new("payment_required", 402, false),
+    "rate_limited" => ErrorInfo.new("rate_limited", 429, true),
+    "raw_db_not_enabled" => ErrorInfo.new("conflict", 409, false),
     "required" => ErrorInfo.new("validation", 400, false),
-    "resource_quota_exceeded" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "resource_quota_exceeded" => ErrorInfo.new("payment_required", 402, false),
     "schema_name_taken" => ErrorInfo.new("conflict", 409, false),
     "seat_in_use" => ErrorInfo.new("conflict", 409, false),
-    "seat_unassigned" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "seat_unassigned" => ErrorInfo.new("payment_required", 402, false),
     "seats_not_supported" => ErrorInfo.new("conflict", 409, false),
     "session_ended" => ErrorInfo.new("unauthenticated", 401, true),
     "session_expired" => ErrorInfo.new("unauthenticated", 401, true),
+    "site_has_connectors" => ErrorInfo.new("conflict", 409, false),
+    "site_offline" => ErrorInfo.new("unavailable", 502, true),
+    "slug_brand_protected" => ErrorInfo.new("permission_denied", 403, false),
+    "slug_reserved" => ErrorInfo.new("validation", 400, false),
     "slug_taken" => ErrorInfo.new("conflict", 409, false),
     "staging_already_enabled" => ErrorInfo.new("conflict", 409, false),
     "staging_mismatch" => ErrorInfo.new("precondition_failed", 412, false),
+    "staging_namespace_too_long" => ErrorInfo.new("precondition_failed", 412, false),
     "staging_not_enabled" => ErrorInfo.new("precondition_failed", 412, false),
     "staging_required" => ErrorInfo.new("precondition_failed", 412, false),
     "static_release_in_use" => ErrorInfo.new("conflict", 409, false),
     "static_release_not_ready" => ErrorInfo.new("precondition_failed", 412, false),
     "subdomain_not_configured" => ErrorInfo.new("precondition_failed", 412, false),
+    "synology_invalid_credential" => ErrorInfo.new("validation", 400, false),
+    "synology_probe_failed" => ErrorInfo.new("unavailable", 502, true),
+    "synology_relay_unreachable" => ErrorInfo.new("validation", 502, false),
     "temporarily_unavailable" => ErrorInfo.new("unavailable", 429, true),
     "token_expired" => ErrorInfo.new("unauthenticated", 401, true),
     "token_invalid" => ErrorInfo.new("unauthenticated", 401, true),
     "token_missing" => ErrorInfo.new("unauthenticated", 401, true),
     "too_long" => ErrorInfo.new("validation", 400, false),
+    "unknown_feature_key" => ErrorInfo.new("validation", 400, false),
     "unknown_plan" => ErrorInfo.new("not_found", 404, false),
-    "unpaid_balance" => ErrorInfo.new("CategoryPaymentRequired", 402, false),
+    "unpaid_balance" => ErrorInfo.new("payment_required", 402, false),
     "unsupported_for_static_app" => ErrorInfo.new("conflict", 409, false),
     "version_not_approved" => ErrorInfo.new("permission_denied", 403, false),
     "visibility_widen_not_allowed" => ErrorInfo.new("conflict", 409, false),
@@ -305,9 +342,11 @@ module AxHub
     return 'gateway' if ['Gateway', 'Config'].include?(tag)
     return 'data' if tag == 'Schema'
     return 'deployments' if ['Deploy', 'deploy'].include?(tag)
+    return 'notifications' if tag == 'Notifications'
     raise ArgumentError, "unmapped route tag: #{tag}"
   end
-  CONTEXT_ROUTES = %w[apps identity tenants authz audit gateway data deployments].map { |name| [name, ROUTES.select { |route| context_name(route) == name }] }.to_h
+  CONTEXT_ROUTES = %w[apps identity tenants authz audit gateway data deployments notifications].map { |name| [name, ROUTES.select { |route| context_name(route) == name }] }.to_h
 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.14.0
 platform: ruby
 authors:
 - Jocoding AX Partners
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-03 00:00:00.000000000 Z
+date: 2026-07-21 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: