activestorage_saas 7.0.4 → 7.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2582d10000f7aae9780b0d273c172c4a76cb08c97bf092126979ce4110d00d8
-  data.tar.gz: 7f88a5f75a7a18bf1587d114e2b87d7d9888afd633d88488868910b495b2c72a
+  metadata.gz: 422aa00826004eda3168829ac76146aa61a20934de7e41cd05ec8f4eccd4c6eb
+  data.tar.gz: 8ff8749becec2ae3ed721ee1cfe1fe1e2dcaa3e1658c06364c4304d452f131b7
 SHA512:
-  metadata.gz: f7d76f176c4a9c6ed75544f7008d874363c0cd9b80a372af94d93c8d24800835644fc18ed62e96546e4ea924491b789e8ec07e676e3aaa9bbc1e7b19bff4aad0
-  data.tar.gz: 5d9ed9018b5a423dc66ed88bec3b93e34abd12d060c11ca245767a9eb91aa22bf2115bbef8e73e1c5fdedf17a698c139303a641dd1da81ddbc617a30ce7fb998
+  metadata.gz: d4d504753d8951ad1d8e932d417590b3bf8d916f84ceb3ec09438203158a59192c8e183a943b8d9d3c07a98db38803f9d55579da9079b0861b9dd17cf832cb02
+  data.tar.gz: 66e2ce4a52e23ebf32dcddbb3046e8e51cd3c8b8580d1c94d4713605de2e9f9863d5150c445a801900c993f11bbb8868c0d398b70604ec6b6fd5467996e88118

data/AGENTS.md

@@ -0,0 +1,260 @@
+# ActiveStorageSaas - AI 助手指南
+
+本文档用于指导 AI 助手理解 ActiveStorageSaas gem 的代码结构、依赖关系和升级流程。
+
+## 项目概述
+
+ActiveStorageSaas 是一个 Rails gem，为 ActiveStorage 提供多租户存储服务支持。它通过扩展 ActiveStorage 的核心类来实现动态存储服务加载。
+
+## 核心架构
+
+### 1. 主要组件
+
+#### SaasService (`lib/active_storage/service/saas_service.rb`)
+- **作用**：包装器服务，动态委托方法调用到实际的存储服务
+- **关键特性**：
+  - 通过 `Service.public_instance_methods(false)` 动态定义所有 Service 方法
+  - 使用 `method_missing` 处理未定义的方法
+  - 通过 `service_resolver` 根据 blob 动态解析实际服务
+- **依赖的 Rails API**：
+  - `ActiveStorage::Service` 基类
+  - `Service.public_instance_methods` 方法
+  - `url_for_direct_upload` 和 `headers_for_direct_upload` 方法（需要支持 `custom_metadata` 参数）
+
+#### BlobModelMixin (`lib/active_storage_saas/blob_model_mixin.rb`)
+- **作用**：扩展 `ActiveStorage::Blob`，重写 `service` 方法以支持动态服务解析
+- **关键方法**：
+  - `service`：重写以支持动态服务解析
+  - `analyzer_class`：支持服务级别的 analyzers
+  - `validate_service_name_in_services`：验证服务名称
+- **依赖的 Rails API**：
+  - `ActiveStorage::Blob#service` 方法
+  - `ActiveStorage::Blob#service_name` 属性
+  - `ActiveSupport.on_load(:active_storage_blob)` 钩子
+  - `redefine_method` (ActiveSupport 扩展)
+
+#### DirectUploadsControllerMixin (`lib/active_storage_saas/direct_uploads_controller_mixin.rb`)
+- **作用**：扩展 `ActiveStorage::DirectUploadsController`，支持动态服务名称
+- **关键方法**：
+  - `create`：重写以使用 `create_before_direct_upload!` 并传递 `service_name`
+  - `blob_args`：合并额外的 blob 参数和服务名称
+- **依赖的 Rails API**：
+  - `ActiveStorage::DirectUploadsController#create` 方法
+  - `ActiveStorage::Blob.create_before_direct_upload!` 方法
+  - `blob_args` 方法签名
+
+#### StorageServiceConfigurationMixin (`lib/active_storage_saas/storage_service_configuration_model_mixin.rb`)
+- **作用**：为存储服务配置模型提供方法
+- **关键方法**：
+  - `to_service`：根据配置创建存储服务实例
+  - `to_service_name`：生成格式为 `ClassName:ID` 的服务名称
+  - `from_service_name`：从服务名称解析配置记录
+- **依赖的 Rails API**：
+  - `ActiveStorage::Blob.services` 和 `services.fetch`
+  - `ActiveStorage::Blob.services.send(:configurations)`
+
+#### Engine (`lib/active_storage_saas/engine.rb`)
+- **作用**：Rails Engine，负责加载 mixins 和配置
+- **关键初始化**：
+  - 使用 `ActiveSupport.on_load(:active_storage_blob)` 加载 BlobModelMixin
+  - 使用 `config.to_prepare` 加载 DirectUploadsControllerMixin
+  - 配置默认的服务解析器、转换器等
+
+## 依赖的 Rails 版本和 API
+
+### 当前版本
+- **Rails**: 7.2.3
+- **ActiveStorage**: 7.2.3
+- **Ruby**: >= 2.6.0
+
+### 关键依赖的 Rails API
+
+在升级时需要检查以下 API 是否发生变化：
+
+1. **ActiveStorage::Service**
+   - `public_instance_methods(false)` - 用于动态方法定义
+   - `url_for_direct_upload(key, expires_in:, content_type:, content_length:, checksum:, custom_metadata: {})`
+   - `headers_for_direct_upload(key, filename:, content_type:, content_length:, checksum:, custom_metadata: {})`
+   - `name=` 和 `name` 方法
+
+2. **ActiveStorage::Blob**
+   - `service` 方法（返回服务实例）
+   - `service_name` 属性
+   - `create_before_direct_upload!` 方法签名
+   - `services` 类属性（Registry 对象）
+   - `services.fetch(service_name)` 方法
+   - `services.send(:configurations)` 方法
+
+3. **ActiveStorage::DirectUploadsController**
+   - `create` 方法
+   - `blob_args` 方法（返回 Hash）
+   - `direct_upload_json` 方法
+
+4. **ActiveSupport**
+   - `on_load(:active_storage_blob)` 钩子
+   - `redefine_method` 方法（Module 扩展）
+   - `ruby2_keywords`（Ruby 2.x 兼容性，Ruby 3.x 会忽略）
+
+## 升级检查清单
+
+当需要升级 Rails 版本时，AI 助手应该执行以下检查：
+
+### 1. 更新依赖版本
+
+```ruby
+# activestorage_saas.gemspec
+spec.version = "X.Y.Z"  # 更新为新版本
+spec.add_dependency "activestorage", 'X.Y.Z'  # 更新为对应的 Rails 版本
+
+# Gemfile
+gem "rails", "X.Y.Z"  # 更新为新版本
+```
+
+### 2. 检查 Service 类变更
+
+**文件**: `/Users/xiaohui/Codes/rails/activestorage/lib/active_storage/service.rb`
+
+检查点：
+- `url_for_direct_upload` 方法签名是否变化（特别是 `custom_metadata` 参数）
+- `headers_for_direct_upload` 方法签名是否变化
+- `public_instance_methods(false)` 是否仍然可用
+- 是否有新的公共方法需要委托
+
+**影响文件**:
+- `lib/active_storage/service/saas_service.rb`
+
+### 3. 检查 Blob 类变更
+
+**文件**: `/Users/xiaohui/Codes/rails/activestorage/app/models/active_storage/blob.rb`
+
+检查点：
+- `service` 方法实现是否变化
+- `create_before_direct_upload!` 方法签名是否变化
+- `services` 类属性的类型和接口是否变化
+- `services.fetch` 和 `services.send(:configurations)` 是否仍然可用
+- 验证逻辑是否变化（`validate do` 块）
+
+**影响文件**:
+- `lib/active_storage_saas/blob_model_mixin.rb`
+
+### 4. 检查 DirectUploadsController 变更
+
+**文件**: `/Users/xiaohui/Codes/rails/activestorage/app/controllers/active_storage/direct_uploads_controller.rb`
+
+检查点：
+- `create` 方法实现是否变化
+- `blob_args` 方法返回格式是否变化
+- `create_before_direct_upload!` 调用方式是否变化（是否使用 `**blob_args` 展开）
+
+**影响文件**:
+- `lib/active_storage_saas/direct_uploads_controller_mixin.rb`
+
+### 5. 检查 ActiveSupport 钩子
+
+**文件**: `/Users/xiaohui/Codes/rails/activestorage/lib/active_storage/engine.rb`
+
+检查点：
+- `ActiveSupport.on_load(:active_storage_blob)` 是否仍然可用
+- 钩子触发时机是否变化
+
+**影响文件**:
+- `lib/active_storage_saas/engine.rb`
+
+### 6. 检查 ActiveSupport 扩展
+
+**文件**: `/Users/xiaohui/Codes/rails/activesupport/lib/active_support/core_ext/module/redefine_method.rb`
+
+检查点：
+- `redefine_method` 是否仍然可用
+- 方法签名是否变化
+
+**影响文件**:
+- `lib/active_storage_saas/blob_model_mixin.rb`
+- `lib/active_storage/service/saas_service.rb`
+
+### 7. 检查方法委托机制
+
+检查 `ruby2_keywords` 的使用：
+- Ruby 3.x 会自动忽略 `ruby2_keywords`，但保留它不会造成问题
+- 如果 Rails 移除了对 Ruby 2.x 的支持，可以考虑移除
+
+**影响文件**:
+- `lib/active_storage/service/saas_service.rb`
+
+## 升级工作流程
+
+### 步骤 1: 定位 Rails 源码
+
+```bash
+# 假设 Rails 源码在 /Users/xiaohui/Codes/rails
+cd /Users/xiaohui/Codes/rails
+git checkout v7.2.3  # 切换到目标版本
+```
+
+### 步骤 2: 对比关键文件
+
+使用 `grep` 和 `read_file` 工具检查关键文件：
+
+1. 读取 Rails 源码中的相关文件
+2. 对比当前 gem 代码
+3. 识别变更点
+
+### 步骤 3: 更新代码
+
+根据检查结果更新：
+
+1. **SaasService**: 如果 Service 类有新方法，动态委托会自动处理；如果方法签名变化，需要更新
+2. **BlobModelMixin**: 如果 `service` 方法实现变化，需要更新重写逻辑
+3. **DirectUploadsControllerMixin**: 如果 `create` 或 `blob_args` 变化，需要更新
+4. **Engine**: 如果钩子机制变化，需要更新初始化逻辑
+
+### 步骤 4: 测试兼容性
+
+运行测试套件：
+
+```bash
+bundle exec rspec
+```
+
+### 步骤 5: 更新文档
+
+更新 `README.md` 和 `CHANGELOG.md` 中的版本信息。
+
+## 常见问题
+
+### Q: 如何知道 Rails 版本是否兼容？
+
+A: 检查以下关键点：
+1. `ActiveStorage::Service` 的公共方法列表
+2. `ActiveStorage::Blob#service` 方法实现
+3. `ActiveStorage::DirectUploadsController#create` 方法实现
+4. ActiveSupport 钩子是否仍然可用
+
+### Q: 如果 Rails 移除了某个方法怎么办？
+
+A: 
+1. 检查是否有替代方法
+2. 如果必须保留功能，考虑在 gem 中实现兼容层
+3. 更新文档说明兼容性要求
+
+### Q: 如何测试升级后的兼容性？
+
+A:
+1. 运行完整的测试套件
+2. 在测试应用中创建 blob 并验证服务解析
+3. 测试直接上传功能
+4. 测试多租户场景
+
+## 代码修改原则
+
+1. **最小侵入**：尽量使用 mixin 和 prepend，避免直接修改 Rails 代码
+2. **向后兼容**：保留对旧版本 Ruby/Rails 的支持（如果可能）
+3. **委托优先**：通过方法委托实现功能，而不是复制代码
+4. **测试覆盖**：确保所有关键功能都有测试覆盖
+
+## 参考资源
+
+- Rails ActiveStorage 文档: https://guides.rubyonrails.org/active_storage_overview.html
+- Rails 源码: `/Users/xiaohui/Codes/rails`
+- 当前 gem 版本: 7.2.3
+

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [7.2.3] - 2024-XX-XX
+
+### Changed
+- 升级支持 Rails 7.2.3
+- 更新 `DirectUploadsControllerMixin` 使用 `create_before_direct_upload!` 方法，与 Rails 7.2.3 保持一致
+- 更新依赖版本：activestorage 7.2.3
+
+### Compatibility
+- Rails: 7.2.3
+- ActiveStorage: 7.2.3
+- Ruby: >= 2.6.0
+
 ## [0.1.0] - 2022-08-09
 
 - Initial release

data/COVERAGE.md

@@ -0,0 +1,64 @@
+# 代码覆盖率
+
+本项目使用 [SimpleCov](https://github.com/simplecov-ruby/simplecov) 来跟踪代码覆盖率。
+
+## 覆盖率要求
+
+- **最小行覆盖率**: 90%
+- **最小文件覆盖率**: 80%
+
+## 运行覆盖率测试
+
+### 使用环境变量
+
+```bash
+COVERAGE=true bundle exec rspec
+```
+
+### 使用 Rake 任务
+
+```bash
+# 运行测试并生成覆盖率报告
+bundle exec rake spec:coverage
+
+# 运行测试并验证覆盖率（如果低于 90% 会失败）
+bundle exec rake spec:coverage:verify
+```
+
+### 使用脚本
+
+```bash
+./script/check_coverage
+```
+
+## 查看覆盖率报告
+
+运行测试后，覆盖率报告会生成在 `coverage/index.html`。在浏览器中打开该文件即可查看详细的覆盖率报告。
+
+## 覆盖率统计范围
+
+覆盖率统计只包括 `lib/` 目录下的代码，排除：
+- 测试文件 (`spec/`)
+- 配置文件 (`config/`)
+- 生成器代码 (`generators/`)
+- 测试应用代码 (`spec/dummy/`)
+- 其他非核心代码
+
+## CI/CD 集成
+
+项目已配置 GitHub Actions 工作流 (`.github/workflows/coverage.yml`)，在每次推送或创建 Pull Request 时会：
+1. 运行测试套件
+2. 生成覆盖率报告
+3. 验证覆盖率是否达到 90%
+4. 上传覆盖率报告作为构建产物
+
+## 提高覆盖率
+
+如果覆盖率低于 90%，请：
+1. 查看 `coverage/index.html` 了解哪些代码未被覆盖
+2. 为未覆盖的代码添加测试用例
+3. 特别关注边界情况和错误处理路径
+
+## 当前覆盖率
+
+运行 `COVERAGE=true bundle exec rspec` 后，会在终端显示当前覆盖率。

data/Gemfile

@@ -5,11 +5,12 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in activestorage_saas.gemspec
 gemspec
 
-gem "rails", "~> 7.0"
+gem "rails", "7.2.3"
 gem "sqlite3"
 gem "propshaft"
-gem "rspec-rails", "~> 5.1"
+gem 'rspec-rails', '~> 8.0', '>= 8.0.2'
+gem 'aws-sdk-s3', '~> 1.206'
 
-gem "guard-rspec", "~> 4.7"
-
-gem "aws-sdk-s3", "~> 1.114"
+group :development, :test do
+  gem 'simplecov', '~> 0.22', require: false
+end

data/README.md

@@ -1,33 +1,222 @@
-# ActivestorageSaas
+# ActiveStorageSaas
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/activestorage_saas`. To experiment with that code, run `bin/console` for an interactive prompt.
+ActiveStorageSaas 是一个 Rails gem，为 ActiveStorage 提供多租户存储服务支持。它允许每个租户配置自己的存储服务，并支持动态加载不同的存储服务。
 
-TODO: Delete this and the text above, and describe your gem
+## 功能特性
 
-## Installation
+- 🏢 **多租户支持**：每个租户可以配置独立的存储服务
+- 🔄 **动态服务加载**：根据 blob 的 service_name 动态解析并加载对应的存储服务
+- 🔌 **灵活配置**：支持通过数据库配置存储服务选项
+- 📦 **完全兼容**：与 Rails ActiveStorage API 完全兼容，无需修改现有代码
+- 🚀 **直接上传支持**：支持 ActiveStorage 的直接上传功能
 
-Install the gem and add to the application's Gemfile by executing:
+## 安装
 
-    $ bundle add activestorage_saas
+在 Gemfile 中添加：
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+```ruby
+gem 'activestorage_saas', '~> 7.2.3'
+```
 
-    $ gem install activestorage_saas
+然后运行：
 
-## Usage
+```bash
+bundle install
+```
 
-TODO: Write usage instructions here
+运行安装生成器：
 
-## Development
+```bash
+rails generate active_storage_saas:install
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+这将创建必要的迁移文件。运行迁移：
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```bash
+rails db:migrate
+```
 
-## Contributing
+## 配置
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/activestorage_saas.
+### 1. 数据库迁移
 
-## License
+安装生成器会创建一个 `storage_service_configurations` 表，用于存储每个租户的存储服务配置。
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+### 2. 存储配置 (config/storage.yml)
+
+在 `config/storage.yml` 中配置一个 `saas` 服务作为包装器：
+
+```yaml
+saas:
+  service: Saas
+  default_service: local  # 默认使用的存储服务
+
+local:
+  service: Disk
+  root: <%= Rails.root.join("storage") %>
+
+amazon:
+  service: S3
+  access_key_id: <%= ENV['AWS_ACCESS_KEY_ID'] %>
+  secret_access_key: <%= ENV['AWS_SECRET_ACCESS_KEY'] %>
+  region: us-east-1
+  bucket: my-bucket
+```
+
+### 3. 应用配置 (config/application.rb 或 config/environments/*.rb)
+
+```ruby
+Rails.application.configure do
+  # 可选：自定义服务解析器
+  # config.active_storage_saas.service_resolver = ->(blob) {
+  #   StorageServiceConfiguration.from_service_name(blob.service_name)&.to_service
+  # }
+
+  # 可选：自定义服务名称转换器（用于直接上传）
+  # config.active_storage_saas.service_name_converter = ->(controller) {
+  #   controller.send(:current_tenant).storage_service&.to_service_name
+  # }
+
+  # 可选：自定义服务名称验证器
+  # config.active_storage_saas.service_name_validator = ->(service_name) {
+  #   StorageServiceConfiguration.valid_service_name?(service_name)
+  # }
+
+  # 可选：直接上传时额外的 blob 参数
+  # config.active_storage_saas.direct_upload_extra_blob_args = ->(controller) {
+  #   { tenant: controller.send(:current_tenant) }
+  # }
+end
+```
+
+## 使用方法
+
+### 创建存储服务配置
+
+```ruby
+# 为租户创建存储服务配置
+config = StorageServiceConfiguration.create!(
+  service_name: 'amazon',  # 基础服务名称（在 storage.yml 中定义）
+  service_options: {
+    bucket: 'tenant-specific-bucket',
+    region: 'us-west-2'
+  }
+)
+
+# 获取服务名称（格式：StorageServiceConfiguration:123）
+service_name = config.to_service_name
+```
+
+### 使用存储服务
+
+```ruby
+# 创建 blob 时指定服务名称
+blob = ActiveStorage::Blob.create!(
+  filename: 'example.jpg',
+  byte_size: 1024,
+  checksum: 'abc123',
+  content_type: 'image/jpeg',
+  service_name: config.to_service_name  # 使用动态服务名称
+)
+
+# blob.service 会自动解析为对应的存储服务实例
+blob.service  # => 返回配置的 S3 服务实例
+```
+
+### 在模型中关联文件
+
+```ruby
+class User < ApplicationRecord
+  has_one_attached :avatar
+end
+
+# 上传文件时指定服务
+user.avatar.attach(
+  io: file,
+  filename: 'avatar.jpg',
+  service_name: current_tenant.storage_config.to_service_name
+)
+```
+
+## 工作原理
+
+### SaasService
+
+`SaasService` 是一个包装器服务，它：
+
+1. 接收一个 `blob` 对象
+2. 根据 `blob.service_name` 动态解析对应的存储服务
+3. 将所有方法调用委托给实际的存储服务
+
+### 服务解析流程
+
+1. 当访问 `blob.service` 时，会调用 `ActiveStorageSaas.service_resolver`
+2. 解析器根据 `service_name` 查找对应的 `StorageServiceConfiguration`
+3. 配置对象通过 `to_service` 方法创建实际的存储服务实例
+4. 如果解析失败，回退到默认服务
+
+### 服务名称格式
+
+动态服务的名称格式为：`ClassName:ID`，例如：
+- `StorageServiceConfiguration:1`
+- `StorageServiceConfiguration:42`
+
+这种格式允许从服务名称中提取配置记录的 ID。
+
+## 高级用法
+
+### 自定义服务解析器
+
+```ruby
+config.active_storage_saas.service_resolver = ->(blob) {
+  tenant = blob.record&.tenant
+  tenant&.storage_config&.to_service
+}
+```
+
+### 多租户集成示例
+
+```ruby
+class Tenant < ApplicationRecord
+  has_one :storage_service_configuration, class_name: 'StorageServiceConfiguration'
+end
+
+class ApplicationController < ActionController::Base
+  def current_tenant
+    @current_tenant ||= Tenant.find(session[:tenant_id])
+  end
+end
+
+# 在配置中
+config.active_storage_saas.service_name_converter = ->(controller) {
+  controller.current_tenant.storage_service_configuration.to_service_name
+}
+```
+
+## 兼容性
+
+- **Rails 版本**：7.2.3
+- **Ruby 版本**：>= 2.6.0
+- **ActiveStorage 版本**：7.2.3
+
+## 开发
+
+运行测试：
+
+```bash
+bundle exec rspec
+```
+
+运行控制台：
+
+```bash
+bin/console
+```
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 许可证
+
+MIT License

data/lib/active_storage_saas/direct_uploads_controller_mixin.rb

@@ -12,7 +12,7 @@ module ActiveStorageSaas
 
     module InstanceMethods
       def create
-        blob = ActiveStorage::Blob.create!(blob_args)
+        blob = ActiveStorage::Blob.create_before_direct_upload!(**blob_args)
         render json: direct_upload_json(blob)
       end
 

data/lib/active_storage_saas/storage_service_configuration_model_mixin.rb

@@ -30,7 +30,8 @@ module ActiveStorageSaas
       def to_service
         defined_service = ActiveStorage::Blob.services.fetch(service_name)
         klass = defined_service.class
-        options = ActiveStorage::Blob.services.send(:configurations).fetch(service_name.to_sym)
+        options = ActiveStorage::Blob.services.send(:configurations).fetch(service_name.to_sym).deep_dup
+        options.delete(:service) if service_name == 'amazon'
         options.deep_merge! service_options.deep_symbolize_keys
         klass.new(**options).tap do |instance|
           instance.instance_eval <<~RUBY

metadata

@@ -1,35 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: activestorage_saas
 version: !ruby/object:Gem::Version
-  version: 7.0.4
+  version: 7.2.3
 platform: ruby
 authors:
 - xiaohui
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-11-22 00:00:00.000000000 Z
+date: 2025-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activestorage
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.3.1
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 7.0.4
+        version: 7.2.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 7.0.3.1
-    - - "<="
+    - - '='
       - !ruby/object:Gem::Version
-        version: 7.0.4
+        version: 7.2.3
 description: Each tenant can set its own storage service, ActiveStorage service can
   be dynamically loaded.
 email:
@@ -38,17 +32,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
-- ".rubocop.yml"
+- AGENTS.md
 - CHANGELOG.md
+- COVERAGE.md
 - Gemfile
-- Gemfile.lock
-- Guardfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- activestorage_saas.gemspec
-- config/initializers/active_storage_saas.rb
 - lib/active_storage/service/saas_service.rb
 - lib/active_storage_saas.rb
 - lib/active_storage_saas/blob_model_mixin.rb
@@ -60,7 +49,6 @@ files:
 - lib/generators/active_storage_saas/install/USAGE
 - lib/generators/active_storage_saas/install/install_generator.rb
 - lib/generators/active_storage_saas/install/templates/config/initializers/active_storage_saas.rb
-- sig/activestorage_saas.rbs
 homepage: https://github.com/xiaohui-zhangxh/activestorage_saas
 licenses:
 - MIT
@@ -83,7 +71,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: Wraps multi-tenant storage services as ActiveStorage service

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.rubocop.yml

@@ -1,17 +0,0 @@
-AllCops:
-  TargetRubyVersion: 2.6
-  NewCops: enable
-Style/StringLiterals:
-  Enabled: true
-  EnforcedStyle: single_quotes
-
-Style/StringLiteralsInInterpolation:
-  Enabled: true
-  EnforcedStyle: double_quotes
-
-Layout/LineLength:
-  Max: 120
-
-Layout/IndentationConsistency:
-  Enabled: true
-  EnforcedStyle: indented_internal_methods

data/Gemfile.lock

@@ -1,236 +0,0 @@
-PATH
-  remote: .
-  specs:
-    activestorage_saas (7.0.4)
-      activestorage (>= 7.0.3.1, <= 7.0.4)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    actioncable (7.0.4)
-      actionpack (= 7.0.4)
-      activesupport (= 7.0.4)
-      nio4r (~> 2.0)
-      websocket-driver (>= 0.6.1)
-    actionmailbox (7.0.4)
-      actionpack (= 7.0.4)
-      activejob (= 7.0.4)
-      activerecord (= 7.0.4)
-      activestorage (= 7.0.4)
-      activesupport (= 7.0.4)
-      mail (>= 2.7.1)
-      net-imap
-      net-pop
-      net-smtp
-    actionmailer (7.0.4)
-      actionpack (= 7.0.4)
-      actionview (= 7.0.4)
-      activejob (= 7.0.4)
-      activesupport (= 7.0.4)
-      mail (~> 2.5, >= 2.5.4)
-      net-imap
-      net-pop
-      net-smtp
-      rails-dom-testing (~> 2.0)
-    actionpack (7.0.4)
-      actionview (= 7.0.4)
-      activesupport (= 7.0.4)
-      rack (~> 2.0, >= 2.2.0)
-      rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (7.0.4)
-      actionpack (= 7.0.4)
-      activerecord (= 7.0.4)
-      activestorage (= 7.0.4)
-      activesupport (= 7.0.4)
-      globalid (>= 0.6.0)
-      nokogiri (>= 1.8.5)
-    actionview (7.0.4)
-      activesupport (= 7.0.4)
-      builder (~> 3.1)
-      erubi (~> 1.4)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (7.0.4)
-      activesupport (= 7.0.4)
-      globalid (>= 0.3.6)
-    activemodel (7.0.4)
-      activesupport (= 7.0.4)
-    activerecord (7.0.4)
-      activemodel (= 7.0.4)
-      activesupport (= 7.0.4)
-    activestorage (7.0.4)
-      actionpack (= 7.0.4)
-      activejob (= 7.0.4)
-      activerecord (= 7.0.4)
-      activesupport (= 7.0.4)
-      marcel (~> 1.0)
-      mini_mime (>= 1.1.0)
-    activesupport (7.0.4)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      tzinfo (~> 2.0)
-    aws-eventstream (1.2.0)
-    aws-partitions (1.664.0)
-    aws-sdk-core (3.168.1)
-      aws-eventstream (~> 1, >= 1.0.2)
-      aws-partitions (~> 1, >= 1.651.0)
-      aws-sigv4 (~> 1.5)
-      jmespath (~> 1, >= 1.6.1)
-    aws-sdk-kms (1.59.0)
-      aws-sdk-core (~> 3, >= 3.165.0)
-      aws-sigv4 (~> 1.1)
-    aws-sdk-s3 (1.117.1)
-      aws-sdk-core (~> 3, >= 3.165.0)
-      aws-sdk-kms (~> 1)
-      aws-sigv4 (~> 1.4)
-    aws-sigv4 (1.5.2)
-      aws-eventstream (~> 1, >= 1.0.2)
-    builder (3.2.4)
-    coderay (1.1.3)
-    concurrent-ruby (1.1.10)
-    crass (1.0.6)
-    diff-lcs (1.5.0)
-    erubi (1.11.0)
-    ffi (1.15.5)
-    formatador (1.1.0)
-    globalid (1.0.0)
-      activesupport (>= 5.0)
-    guard (2.18.0)
-      formatador (>= 0.2.4)
-      listen (>= 2.7, < 4.0)
-      lumberjack (>= 1.0.12, < 2.0)
-      nenv (~> 0.1)
-      notiffany (~> 0.0)
-      pry (>= 0.13.0)
-      shellany (~> 0.0)
-      thor (>= 0.18.1)
-    guard-compat (1.2.1)
-    guard-rspec (4.7.3)
-      guard (~> 2.1)
-      guard-compat (~> 1.1)
-      rspec (>= 2.99.0, < 4.0)
-    i18n (1.12.0)
-      concurrent-ruby (~> 1.0)
-    jmespath (1.6.1)
-    listen (3.7.1)
-      rb-fsevent (~> 0.10, >= 0.10.3)
-      rb-inotify (~> 0.9, >= 0.9.10)
-    loofah (2.19.0)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.5.9)
-    lumberjack (1.2.8)
-    mail (2.7.1)
-      mini_mime (>= 0.1.1)
-    marcel (1.0.2)
-    method_source (1.0.0)
-    mini_mime (1.1.2)
-    mini_portile2 (2.8.0)
-    minitest (5.16.3)
-    nenv (0.3.0)
-    net-imap (0.3.1)
-      net-protocol
-    net-pop (0.1.2)
-      net-protocol
-    net-protocol (0.1.3)
-      timeout
-    net-smtp (0.3.3)
-      net-protocol
-    nio4r (2.5.8)
-    nokogiri (1.13.9)
-      mini_portile2 (~> 2.8.0)
-      racc (~> 1.4)
-    notiffany (0.1.3)
-      nenv (~> 0.1)
-      shellany (~> 0.0)
-    propshaft (0.6.4)
-      actionpack (>= 7.0.0)
-      activesupport (>= 7.0.0)
-      rack
-      railties (>= 7.0.0)
-    pry (0.14.1)
-      coderay (~> 1.1)
-      method_source (~> 1.0)
-    racc (1.6.0)
-    rack (2.2.4)
-    rack-test (2.0.2)
-      rack (>= 1.3)
-    rails (7.0.4)
-      actioncable (= 7.0.4)
-      actionmailbox (= 7.0.4)
-      actionmailer (= 7.0.4)
-      actionpack (= 7.0.4)
-      actiontext (= 7.0.4)
-      actionview (= 7.0.4)
-      activejob (= 7.0.4)
-      activemodel (= 7.0.4)
-      activerecord (= 7.0.4)
-      activestorage (= 7.0.4)
-      activesupport (= 7.0.4)
-      bundler (>= 1.15.0)
-      railties (= 7.0.4)
-    rails-dom-testing (2.0.3)
-      activesupport (>= 4.2.0)
-      nokogiri (>= 1.6)
-    rails-html-sanitizer (1.4.3)
-      loofah (~> 2.3)
-    railties (7.0.4)
-      actionpack (= 7.0.4)
-      activesupport (= 7.0.4)
-      method_source
-      rake (>= 12.2)
-      thor (~> 1.0)
-      zeitwerk (~> 2.5)
-    rake (13.0.6)
-    rb-fsevent (0.11.2)
-    rb-inotify (0.10.1)
-      ffi (~> 1.0)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.0)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-rails (5.1.2)
-      actionpack (>= 5.2)
-      activesupport (>= 5.2)
-      railties (>= 5.2)
-      rspec-core (~> 3.10)
-      rspec-expectations (~> 3.10)
-      rspec-mocks (~> 3.10)
-      rspec-support (~> 3.10)
-    rspec-support (3.12.0)
-    shellany (0.0.1)
-    sqlite3 (1.5.4)
-      mini_portile2 (~> 2.8.0)
-    thor (1.2.1)
-    timeout (0.3.0)
-    tzinfo (2.0.5)
-      concurrent-ruby (~> 1.0)
-    websocket-driver (0.7.5)
-      websocket-extensions (>= 0.1.0)
-    websocket-extensions (0.1.5)
-    zeitwerk (2.6.6)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activestorage_saas!
-  aws-sdk-s3 (~> 1.114)
-  guard-rspec (~> 4.7)
-  propshaft
-  rails (~> 7.0)
-  rspec-rails (~> 5.1)
-  sqlite3
-
-BUNDLED WITH
-   2.3.17

data/Guardfile

@@ -1,42 +0,0 @@
-# A sample Guardfile
-# More info at https://github.com/guard/guard#readme
-
-## Uncomment and set this to only include directories you want to watch
-# directories %w(app lib config test spec features) \
-#  .select{|d| Dir.exist?(d) ? d : UI.warning("Directory #{d} does not exist")}
-
-## Note: if you are using the `directories` clause above and you are not
-## watching the project directory ('.'), then you will want to move
-## the Guardfile to a watched dir and symlink it back, e.g.
-#
-#  $ mkdir config
-#  $ mv Guardfile config/
-#  $ ln -s config/Guardfile .
-#
-# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
-
-# Note: The cmd option is now required due to the increasing number of ways
-#       rspec may be run, below are examples of the most common uses.
-#  * bundler: 'bundle exec rspec'
-#  * bundler binstubs: 'bin/rspec'
-#  * spring: 'bin/rspec' (This will use spring if running and you have
-#                          installed the spring binstubs per the docs)
-#  * zeus: 'zeus rspec' (requires the server to be started separately)
-#  * 'just' rspec: 'rspec'
-
-guard :rspec, cmd: "bundle exec rspec" do
-  require "guard/rspec/dsl"
-  dsl = Guard::RSpec::Dsl.new(self)
-
-  # Feel free to open issues for suggestions and improvements
-
-  # RSpec files
-  rspec = dsl.rspec
-  watch(rspec.spec_helper) { rspec.spec_dir }
-  watch(rspec.spec_support) { rspec.spec_dir }
-  watch(rspec.spec_files)
-
-  # Ruby files
-  ruby = dsl.ruby
-  dsl.watch_spec_files_for(ruby.lib_files)
-end

data/Rakefile

@@ -1,8 +0,0 @@
-require "bundler/setup"
-
-APP_RAKEFILE = File.expand_path("spec/dummy/Rakefile", __dir__)
-load "rails/tasks/engine.rake"
-
-load "rails/tasks/statistics.rake"
-
-require "bundler/gem_tasks"

data/activestorage_saas.gemspec

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-Gem::Specification.new do |spec|
-  spec.name = "activestorage_saas"
-  spec.version = "7.0.4"
-  spec.authors = ["xiaohui"]
-  spec.email = ["xiaohui@tanmer.com"]
-
-  spec.summary = "Wraps multi-tenant storage services as ActiveStorage service"
-  spec.description = "Each tenant can set its own storage service, ActiveStorage service can be dynamically loaded."
-  spec.homepage = "https://github.com/xiaohui-zhangxh/activestorage_saas"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end
-
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency "activestorage", '>=7.0.3.1', '<= 7.0.4'
-end

data/config/initializers/active_storage_saas.rb

@@ -1,6 +0,0 @@
-Rails.application.configure do
-  # config.active_storage_saas.service_resolver = ->(blob) { StorageServiceConfiguration.from_service_name(blob.service_name)&.to_service }
-  # config.active_storage_saas.service_name_converter = ->(controller) { controller.send(:current_tenant).storage_service&.to_service_name }
-  # config.active_storage_saas.service_name_validator = ->(service_name) { StorageServiceConfiguration.valid_service_name?(service_name) }
-  # config.active_storage_saas.direct_upload_extra_blob_args = ->(controller) { { tenant: controller.send(:current_tenant) } }
-end

data/sig/activestorage_saas.rbs

@@ -1,4 +0,0 @@
-module ActivestorageSaas
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end