feat!: deprecate gem

Author: hannahramadan

helpers/sql-obfuscation/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Release History: opentelemetry-helpers-sql-obfuscation
 
+### 💥 Deprecation Notice / 2025-09-23
+
+* **DEPRECATED:** This gem, `opentelemetry-helpers-sql-obfuscation`, has been renamed to `opentelemetry-helpers-sql-processor`. This version (`1.0.0`) is the final release and serves as a transitional package.
+* **ACTION REQUIRED:** Users must update their `Gemfile` to use `gem 'opentelemetry-helpers-sql-processor'` instead.
+* **SUPPORT ENDING:** `opentelemetry-helpers-sql-obfuscation` will no longer receive updates. We plan to remove it from RubyGems entirely after a transition period (approximately 3-6 months).
+
 ### v0.3.0 / 2025-01-16
 
 * BREAKING CHANGE: Set minimum supported version to Ruby 3.1

helpers/sql-obfuscation/README.md

@@ -1,3 +1,11 @@
+# Deprecation Notice
+
+**⚠️ This gem (`opentelemetry-helpers-sql-obfuscation`) is deprecated and no longer maintained.**
+
+It has been renamed to **`opentelemetry-helpers-sql-processor`**.
+
+All future development, bug fixes, and feature releases will occur in the new gem.
+
 # OpenTelemetry Instrumentation Helpers: SQL Obfuscation
 
 This Ruby gem contains logic to obfuscate SQL. It's intended for use by by gem authors instrumenting SQL adapter libraries, such as mysql2, pg, and trilogy.

helpers/sql-obfuscation/lib/opentelemetry-helpers-sql-obfuscation.rb

@@ -5,3 +5,8 @@
 # SPDX-License-Identifier: Apache-2.0
 
 require_relative 'opentelemetry/helpers'
+
+OpenTelemetry.logger.warn <<~WARNING
+  [DEPRECATION] The 'opentelemetry-helpers-sql-obfuscation' is deprecated and has been replaced by 'opentelemetry-helpers-sql-processor'.
+  Please update your Gemfile to use 'opentelemetry-helpers-sql-processor' instead.
+WARNING

helpers/sql-obfuscation/lib/opentelemetry/helpers/sql_obfuscation/version.rb

@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Helpers
     module SqlObfuscation
-      VERSION = '0.3.0'
+      VERSION = '1.0.0'
     end
   end
 end