stackshift-assets 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdfe2efcf2a51f4c4bf71a687718adb1e79afc2e3a18f4366eda886635b1bd72
-  data.tar.gz: 1c59b7c238b084196e80849fccfcfae8ef4430f88ae93af07d3999c679c36b01
+  metadata.gz: 2607cf398ae181f6643e452898d4a915770388274d566ff2beb5341c7221eaa7
+  data.tar.gz: 86acd19ea277884c2fd3fe8d3066d43511410e16fbf723818ee2f37fb0f6e335
 SHA512:
-  metadata.gz: f3abe3f0304c97a80727e4ac7d362f0f33f7f6c76dc69ab2a64df9ed6c00ade142dbd4596056730b82cafb50a233adbc027dadb0de98bea8969ab13b5f55cb2e
-  data.tar.gz: 55d9c68193000c748b9ddfd5adb86cfbebf7cfea41a80c83d36903947616d76ec1d9e912b91c94c3a537ef55d4efb0dda5fc85470d1b6757648bdae23e5f6880
+  metadata.gz: ff2f67172dbe00e43faac345fdff3f0aa5af0eddb0c7543475f964481e25d6aec018ec5709d719fc3da1844dedba1f17c7f6e2ae606fd0ac232a4856590dbd68
+  data.tar.gz: 10e3c6aad19b00999c0d7d6a341de658500494e1c7911afa9fe99f96e4dab4a57fea07d5bf3a040081596706f1c85dbe3e8f092c28b1a6e2ff67eb4e4776616c

data/README.md

@@ -1,3 +1,12 @@
 # StackShift Assets for Ruby
 
 Require \`stackshift/assets_client\`. Rails applications can inject the client and use resumable upload sessions for direct uploads. Every mutating call takes the current revision and sends \`If-Match\`.
+
+For Cloudinary or S3 imports, use `client.for_space(space_id)` to scope connection, storage, and migration calls. Run a dry inventory before transfer:
+
+```ruby
+platform = client.for_space(space_id)
+preview = platform.start_asset_migration({ source_connection_id: connection_id,
+  destination_bucket_id: bucket_id, source_prefix: "campaigns/2026", dry_run: true })
+report = platform.asset_migration_report(preview.fetch("id"))
+```

data/lib/stackshift/assets_client.rb

@@ -5,9 +5,11 @@ require "digest"
 require "net/http"
 require "securerandom"
 require "uri"
+require_relative "assets_platform"
 
 module StackShift
   class AssetsClient
+    include AssetsPlatform
     def initialize(api_key:, base_url: "https://api.stackshift.cloud/api/v1", cdn_base_url: "https://cdn.stackshift.cloud")
       raise ArgumentError, "StackShift SDK requires an API key" if api_key.to_s.strip.empty?
 

data/lib/stackshift/assets_platform.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module StackShift
+  module AssetsPlatform
+    def for_space(space_id)
+      scoped = dup
+      scoped.instance_variable_set(:@asset_platform_space_id, space_id)
+      scoped
+    end
+
+    def list_asset_connections
+      platform_request(:get, "/assets/connections")
+    end
+
+    def get_asset_connection(id)
+      platform_request(:get, "/assets/connections/#{escape(id)}")
+    end
+
+    def create_asset_connection(input)
+      platform_request(:post, "/assets/connections", body: input)
+    end
+
+    def update_asset_connection(id, input)
+      platform_request(:patch, "/assets/connections/#{escape(id)}", body: input)
+    end
+
+    def verify_asset_connection(id)
+      platform_request(:post, "/assets/connections/#{escape(id)}/verify")
+    end
+
+    def delete_asset_connection(id)
+      platform_request(:delete, "/assets/connections/#{escape(id)}")
+    end
+
+    def configure_asset_storage(bucket_id, revision:, **input)
+      platform_request(:put, "/assets/buckets/#{escape(bucket_id)}/storage", body: input, headers: if_match(revision))
+    end
+
+    def list_asset_s2_buckets
+      platform_request(:get, "/assets/s2-buckets")
+    end
+
+    def create_asset_s2_bucket(input)
+      platform_request(:post, "/assets/s2-buckets", body: input)
+    end
+
+    def relocate_asset_bucket(bucket_id, input = {})
+      platform_request(:post, "/assets/buckets/#{escape(bucket_id)}/relocations", body: input)
+    end
+
+    def start_asset_migration(input)
+      platform_request(:post, "/assets/migrations", body: input)
+    end
+
+    def list_asset_migrations(limit: nil)
+      platform_request(:get, "/assets/migrations", query: limit ? { limit: limit } : nil)
+    end
+
+    def get_asset_migration(id)
+      platform_request(:get, "/assets/migrations/#{escape(id)}")
+    end
+
+    def cancel_asset_migration(id)
+      platform_request(:post, "/assets/migrations/#{escape(id)}/cancel")
+    end
+
+    def retry_asset_migration_item(migration_id, item_id)
+      platform_request(:post, "/assets/migrations/#{escape(migration_id)}/items/#{escape(item_id)}/retry")
+    end
+
+    def asset_migration_report(id)
+      platform_request(:get, "/assets/migrations/#{escape(id)}/report", query: { format: "json" })
+    end
+
+    private
+
+    def platform_request(method, path, body: nil, query: nil, headers: {})
+      headers = headers.merge("X-Asset-Space-ID" => @asset_platform_space_id) if @asset_platform_space_id && !@asset_platform_space_id.empty?
+      request(method, path, body: body, query: query, headers: headers)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stackshift-assets
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - StackShift
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-09-05 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies: []
 description: 
 email:
@@ -20,6 +20,7 @@ files:
 - README.md
 - lib/stackshift/assets.rb
 - lib/stackshift/assets_client.rb
+- lib/stackshift/assets_platform.rb
 - lib/stackshift/rails.rb
 homepage: 
 licenses: []