openc3 6.10.4 → 7.0.0.pre.rc2

data/lib/openc3/utilities/cli_generator.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2025 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.
@@ -200,8 +195,8 @@ module OpenC3
         abort("Target #{target_path} already exists!")
       end
       target_lib_filename = "#{target_name.downcase}.#{@@language}"
-      target_class = target_lib_filename.filename_to_class_name # NOSONAR
-      target_object = target_name.downcase # NOSONAR
+      target_class = target_lib_filename.filename_to_class_name
+      target_object = target_name.downcase
 
       process_template("#{TEMPLATES_DIR}/target", binding) do |filename|
         # Rename the template TARGET to our actual target named after the plugin
@@ -228,7 +223,7 @@ module OpenC3
   else
     'requirements.txt'
   end
-  s.files = Dir.glob("{targets,lib,public,tools,microservices}/**/*") + %w(Rakefile README.md LICENSE.txt plugin.txt) + [python_dep_file]
+  s.files = Dir.glob("{targets,lib,public,tools,microservices}/**/*") + %w(Rakefile README.md LICENSE.md plugin.txt) + [python_dep_file]
 RUBY
         end
         File.write(gemspec_filename, gemspec)
@@ -296,7 +291,7 @@ RUBY
         abort("Microservice #{microservice_path} already exists!")
       end
       microservice_filename = "#{microservice_name.downcase}.#{@@language}"
-      microservice_class = microservice_filename.filename_to_class_name # NOSONAR
+      microservice_class = microservice_filename.filename_to_class_name
 
       process_template("#{TEMPLATES_DIR}/microservice", binding) do |filename|
         # Rename the template MICROSERVICE to our actual microservice name
@@ -551,7 +546,7 @@ RUBY
       end
       conversion_name = "#{args[2].upcase.gsub(/_+|-+/, '_')}_CONVERSION"
       conversion_basename = "#{conversion_name.downcase}.#{@@language}"
-      conversion_class = conversion_basename.filename_to_class_name # NOSONAR
+      conversion_class = conversion_basename.filename_to_class_name
       conversion_filename = "targets/#{target_name}/lib/#{conversion_basename}"
       if File.exist?(conversion_filename)
         abort("Conversion #{conversion_filename} already exists!")
@@ -605,7 +600,7 @@ RUBY
       end
       processor_name = "#{args[2].upcase.gsub(/_+|-+/, '_')}_PROCESSOR"
       processor_basename = "#{processor_name.downcase}.#{@@language}"
-      processor_class = processor_basename.filename_to_class_name # NOSONAR
+      processor_class = processor_basename.filename_to_class_name
       processor_filename = "targets/#{target_name}/lib/#{processor_basename}"
       if File.exist?(processor_filename)
         abort("Processor #{processor_filename} already exists!")
@@ -660,7 +655,7 @@ RUBY
       response_name = "#{args[2].upcase.gsub(/_+|-+/, '_')}_LIMITS_RESPONSE"
       response_basename = "#{response_name.downcase}.#{@@language}"
       response_filename = "targets/#{target_name}/lib/#{response_basename}"
-      response_class = response_basename.filename_to_class_name # NOSONAR
+      response_class = response_basename.filename_to_class_name
       if File.exist?(response_filename)
         abort("response #{response_filename} already exists!")
       end
@@ -713,7 +708,7 @@ RUBY
       end
       validator_name = "#{args[2].upcase.gsub(/_+|-+/, '_')}_COMMAND_VALIDATOR"
       validator_basename = "#{validator_name.downcase}.#{@@language}"
-      validator_class = validator_basename.filename_to_class_name # NOSONAR
+      validator_class = validator_basename.filename_to_class_name
       validator_filename = "targets/#{target_name}/lib/#{validator_basename}"
       if File.exist?(validator_filename)
         abort("Command validator #{validator_filename} already exists!")

data/lib/openc3/utilities/cmd_log.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2025 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.

data/lib/openc3/utilities/crc.rb

@@ -3,18 +3,13 @@
 # Copyright 2022 Ball Aerospace & Technologies Corp.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2022, OpenC3, Inc.
+# All changes Copyright 2026, OpenC3, Inc.
 # All Rights Reserved
 #
 # This file may also be used under the terms of a commercial license

data/lib/openc3/utilities/csv.rb

@@ -3,21 +3,16 @@
 # Copyright 2022 Ball Aerospace & Technologies Corp.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2022, OpenC3, Inc.
+# All changes Copyright 2026, OpenC3, Inc.
 # All Rights Reserved
 #
-# This file may also be used under the terms of a commercial license 
+# This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.
 
 require 'csv'

data/lib/openc3/utilities/local_bucket.rb

@@ -1,19 +1,14 @@
 # encoding: ascii-8bit
 
-# Copyright 2022 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
-# This file may also be used under the terms of a commercial license 
+# This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.
 
 require 'openc3/utilities/aws_bucket'
@@ -22,7 +17,7 @@ module OpenC3
   # This class exists simply to enable the following code in bucket.rb
   #   bucket_class = ENV['OPENC3_CLOUD'].capitalize + 'Bucket'
   # So when the OPENC3_CLOUD var is set to 'local' this file is used
-  # The local code uses Minio which is identical to the Aws APIs
+  # The local code uses versitygw which is identical to the Aws APIs
   class LocalBucket < AwsBucket
   end
 end

data/lib/openc3/utilities/local_mode.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2024 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.
@@ -26,13 +21,13 @@ require 'openc3/utilities/bucket'
 module OpenC3
   module LocalMode
     OPENC3_LOCAL_MODE_PATH = ENV['OPENC3_LOCAL_MODE_PATH'] || "/plugins"
-    # When updating update local_mode.py, PluginsTab.vue, plugins.spec.ts
+    # When updating update local_mode.py, PluginsTab.vue, plugins.p.spec.ts
     DEFAULT_PLUGINS = [
       'openc3-cosmos-tool-admin',
       'openc3-cosmos-tool-bucketexplorer',
       'openc3-cosmos-tool-cmdsender',
-      'openc3-cosmos-tool-cmdqueue',
-      'openc3-cosmos-tool-cmdhistory',
+      'openc3-cosmos-tool-cmdqueue', # Enterprise only
+      'openc3-cosmos-tool-cmdhistory', # Enterprise only
       'openc3-cosmos-tool-cmdtlmserver',
       'openc3-cosmos-tool-dataextractor',
       'openc3-cosmos-tool-dataviewer',
@@ -45,13 +40,14 @@ module OpenC3
       'openc3-cosmos-tool-tablemanager',
       'openc3-cosmos-tool-tlmgrapher',
       'openc3-cosmos-tool-tlmviewer',
-      'openc3-cosmos-enterprise-tool-admin',
-      'openc3-enterprise-tool-base',
-      'openc3-cosmos-tool-autonomic',
-      'openc3-cosmos-tool-calendar',
-      'openc3-cosmos-tool-grafana',
-      'openc3-cosmos-tool-systemhealth',
-      'openc3-cosmos-tool-logexplorer',
+      'openc3-cosmos-enterprise-tool-admin', # Enterprise only
+      'openc3-cosmos-tool-autonomic', # Enterprise only
+      'openc3-cosmos-tool-calendar', # Enterprise only
+      'openc3-cosmos-tool-grafana', # Enterprise only
+      'openc3-cosmos-tool-logexplorer', # Enterprise only
+      'openc3-cosmos-tool-notebooks', # Enterprise only
+      'openc3-cosmos-tool-systemhealth', # Enterprise only
+      'openc3-enterprise-tool-base', # Enterprise only
       'openc3-tool-base',
     ]
 

data/lib/openc3/utilities/logger.rb

@@ -3,18 +3,13 @@
 # Copyright 2022 Ball Aerospace & Technologies Corp.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2023, OpenC3, Inc.
+# All changes Copyright 2026, OpenC3, Inc.
 # All Rights Reserved
 #
 # This file may also be used under the terms of a commercial license

data/lib/openc3/utilities/message_log.rb

@@ -3,18 +3,13 @@
 # Copyright 2022 Ball Aerospace & Technologies Corp.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2022, OpenC3, Inc.
+# All changes Copyright 2026, OpenC3, Inc.
 # All Rights Reserved
 #
 # This file may also be used under the terms of a commercial license

data/lib/openc3/utilities/metric.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2023 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.

data/lib/openc3/utilities/migration.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2022 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.

data/lib/openc3/utilities/open_telemetry.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2023 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.

data/lib/openc3/utilities/process_manager.rb

@@ -3,18 +3,13 @@
 # Copyright 2022 Ball Aerospace & Technologies Corp.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2022, OpenC3, Inc.
+# All changes Copyright 2026, OpenC3, Inc.
 # All Rights Reserved
 #
 # This file may also be used under the terms of a commercial license

data/lib/openc3/utilities/python_proxy.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2024 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.

data/lib/openc3/utilities/quaternion.rb

@@ -3,18 +3,13 @@
 # Copyright 2022 Ball Aerospace & Technologies Corp.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 
 # Modified by OpenC3, Inc.
-# All changes Copyright 2022, OpenC3, Inc.
+# All changes Copyright 2026, OpenC3, Inc.
 # All Rights Reserved
 #
 # This file may also be used under the terms of a commercial license

data/lib/openc3/utilities/questdb_client.rb

@@ -0,0 +1,210 @@
+# encoding: ascii-8bit
+
+# Copyright 2026 OpenC3, Inc.
+# All Rights Reserved.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
+#
+# This file may also be used under the terms of a commercial license
+# if purchased from OpenC3, Inc.
+
+require 'json'
+require 'base64'
+require 'bigdecimal'
+
+module OpenC3
+  # Utility class for QuestDB data encoding and decoding.
+  # This provides a common interface for serializing/deserializing COSMOS data types
+  # when writing to and reading from QuestDB.
+  class QuestDBClient
+    # Special timestamp items that are calculated from PACKET_TIMESECONDS/RECEIVED_TIMESECONDS columns
+    # rather than stored as separate columns. PACKET_TIMESECONDS and RECEIVED_TIMESECONDS are stored
+    # as timestamp_ns columns and need conversion to float seconds on read. The TIMEFORMATTED items
+    # are derived from these timestamp columns.
+    TIMESTAMP_ITEMS = {
+      'PACKET_TIMEFORMATTED' => { source: 'PACKET_TIMESECONDS', format: :formatted },
+      'RECEIVED_TIMEFORMATTED' => { source: 'RECEIVED_TIMESECONDS', format: :formatted }
+    }.freeze
+
+    # Sentinel values for storing float special values (inf, -inf, nan) in QuestDB.
+    # QuestDB stores these as NULL, so we use sentinel values near float max instead.
+
+    # 64-bit double sentinels (for FLOAT 64-bit columns)
+    FLOAT64_POS_INF_SENTINEL = 1.7976931348623155e308
+    FLOAT64_NEG_INF_SENTINEL = -1.7976931348623155e308
+    FLOAT64_NAN_SENTINEL = -1.7976931348623153e308
+
+    # 32-bit float sentinels (what we read back after 32-bit storage)
+    FLOAT32_POS_INF_STORED = 3.4028232635611926e38
+    FLOAT32_NEG_INF_STORED = -3.4028232635611926e38
+    FLOAT32_NAN_STORED = -3.4028230607370965e38
+
+    # Decode sentinel values back to float special values (inf, -inf, nan).
+    # Checks against both 32-bit and 64-bit sentinel values since we may not
+    # know the original column type at read time.
+    #
+    # @param value [Float] The float value to potentially decode
+    # @return [Float] The value with sentinels replaced by special values
+    def self.decode_float_special_values(value)
+      return value unless value.is_a?(Float)
+
+      # Check 64-bit sentinels
+      return Float::INFINITY if value == FLOAT64_POS_INF_SENTINEL
+      return -Float::INFINITY if value == FLOAT64_NEG_INF_SENTINEL
+      return Float::NAN if value == FLOAT64_NAN_SENTINEL
+
+      # Check 32-bit sentinels (stored values after precision loss)
+      return Float::INFINITY if value == FLOAT32_POS_INF_STORED
+      return -Float::INFINITY if value == FLOAT32_NEG_INF_STORED
+      return Float::NAN if value == FLOAT32_NAN_STORED
+
+      value
+    end
+
+    # Decode a value retrieved from QuestDB back to its original Ruby type.
+    #
+    # QuestDB stores certain COSMOS types as encoded strings:
+    # - Arrays are JSON-encoded: "[1, 2, 3]" or '["a", "b"]'
+    # - Objects/Hashes are JSON-encoded: '{"key": "value"}'
+    # - Binary data (BLOCK) is base64-encoded
+    # - Large integers (64-bit) are stored as DECIMAL
+    #
+    # @param value [Object] The value to decode
+    # @param data_type [String] COSMOS data type (INT, UINT, FLOAT, STRING, BLOCK, DERIVED, etc.)
+    # @param array_size [Integer, nil] If not nil, indicates this is an array item
+    # @return [Object] The decoded value
+    def self.decode_value(value, data_type: nil, array_size: nil)
+      # Handle BigDecimal values from QuestDB DECIMAL columns (used for 64-bit integers)
+      if value.is_a?(BigDecimal)
+        return value.to_i if data_type == 'INT' || data_type == 'UINT'
+        return value
+      end
+
+      # Decode float sentinel values back to inf/nan
+      return decode_float_special_values(value) if value.is_a?(Float)
+
+      # Non-strings don't need decoding (already handled by PG type mapping)
+      return value unless value.is_a?(String)
+
+      # Empty strings stay as empty strings
+      return value if value.empty?
+
+      # Handle based on data type if provided
+      if data_type == 'BLOCK'
+        begin
+          return Base64.strict_decode64(value)
+        rescue ArgumentError
+          return value
+        end
+      end
+
+      # Arrays are JSON-encoded
+      if array_size
+        begin
+          return JSON.parse(value, allow_nan: true, create_additions: true)
+        rescue JSON::ParserError
+          return value
+        end
+      end
+
+      # Integer values stored as strings (fallback path, normally DECIMAL)
+      if data_type == 'INT' || data_type == 'UINT'
+        begin
+          return Integer(value)
+        rescue ArgumentError
+          return value
+        end
+      end
+
+      # DERIVED items with declared converted_type are stored as typed columns
+      # (float, int, etc.) and will be returned as non-strings, handled above.
+      # DERIVED items without declared type or with complex types (ARRAY, OBJECT, ANY)
+      # are stored as VARCHAR and JSON-encoded.
+      if data_type == 'DERIVED'
+        begin
+          return JSON.parse(value, allow_nan: true, create_additions: true)
+        rescue JSON::ParserError
+          # Could be a plain string from DERIVED with converted_type=STRING
+          return value
+        end
+      end
+
+      # No data_type provided - fall back to heuristic decoding
+      if data_type.nil?
+        first_char = value[0]
+        # Try JSON for arrays/objects
+        if first_char == '[' || first_char == '{'
+          begin
+            return JSON.parse(value, allow_nan: true, create_additions: true)
+          rescue JSON::ParserError
+            # Not valid JSON
+          end
+        # Try integer conversion for numeric strings
+        elsif value =~ /\A-?\d+\z/
+          begin
+            return Integer(value)
+          rescue ArgumentError
+            # Not a valid integer
+          end
+        end
+      end
+
+      # Return as-is (STRING type or unknown)
+      value
+    end
+
+    # Sanitize a table name for QuestDB.
+    # See https://questdb.com/docs/reference/api/ilp/advanced-settings/#name-restrictions
+    #
+    # @param target_name [String] Target name
+    # @param packet_name [String] Packet name
+    # @param cmd_or_tlm [String, Symbol] "CMD" or "TLM" prefix (default "TLM")
+    # @param scope [String] Scope name (default "DEFAULT")
+    # @return [String] Sanitized table name
+    def self.sanitize_table_name(target_name, packet_name, cmd_or_tlm = "TLM", scope: "DEFAULT")
+      "#{scope}__#{cmd_or_tlm}__#{target_name}__#{packet_name}".gsub(/[?,'"\\\/:\)\(\+\*\%~]/, '_')
+    end
+
+    # Sanitize a column name for QuestDB.
+    # See https://questdb.com/docs/reference/api/ilp/advanced-settings/#name-restrictions
+    #
+    # @param item_name [String] Item name
+    # @return [String] Sanitized column name
+    # ILP protocol special characters that must be sanitized in column names
+    def self.sanitize_column_name(item_name)
+      item_name.to_s.gsub(/[?\.,'"\\\/:\)\(\+=\-\*\%~;!@#\$\^&]/, '_')
+    end
+
+    # Convert a PG timestamp to UTC.
+    # PG driver returns timestamps as naive Time objects that need UTC treatment.
+    # QuestDB stores timestamps in UTC, but the PG driver applies local timezone.
+    #
+    # @param pg_time [Time] Timestamp from PG query result
+    # @return [Time] UTC timestamp
+    def self.pg_timestamp_to_utc(pg_time)
+      return nil unless pg_time
+      Time.utc(pg_time.year, pg_time.month, pg_time.day,
+               pg_time.hour, pg_time.min, pg_time.sec, pg_time.usec)
+    end
+
+    # Format a UTC timestamp according to the specified format.
+    #
+    # @param utc_time [Time] UTC timestamp
+    # @param format [Symbol] :seconds for Unix seconds (float), :formatted for ISO 8601
+    # @return [Float, String, nil] Formatted timestamp or nil if utc_time is nil
+    def self.format_timestamp(utc_time, format)
+      return nil unless utc_time
+      case format
+      when :seconds
+        utc_time.to_f
+      when :formatted
+        utc_time.strftime('%Y-%m-%dT%H:%M:%S.%6NZ')
+      else
+        nil
+      end
+    end
+  end
+end

data/lib/openc3/utilities/redis_secrets.rb

@@ -1,17 +1,12 @@
 # encoding: ascii-8bit
 
-# Copyright 2022 OpenC3, Inc.
+# Copyright 2026 OpenC3, Inc.
 # All Rights Reserved.
 #
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU Affero General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-#
 # This program is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU Affero General Public License for more details.
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+# See LICENSE.md for more details.
 #
 # This file may also be used under the terms of a commercial license
 # if purchased from OpenC3, Inc.