capi_param_builder_ruby 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8525b1ab84c2d04fa5557b0aaba420e7963136503d972a09bdb616f99a18711e
-  data.tar.gz: 5810250eddcd721a5051e678b23b0165b2b4d84e2683bbf860dd2f9e54751324
+  metadata.gz: 8acc5a9893deeb3ac84eb9973c23fe5bf498d86ac00c3afcee5320ffd18a50e9
+  data.tar.gz: 5dd4b0017743d2a06b2c8a6c4c8b04d77052a2e642d2d9912895002e220bb62a
 SHA512:
-  metadata.gz: 8aaa07d83a623a1f10cd4d34c73c55e6056fc20048006a0c263bd4fe372bb5ae6d2f476a91bd75db02a4a4b103a7d376793c16ae2474b476efb8d670de45166d
-  data.tar.gz: 9919b3befd095f7bf7cbd88d8ccac7cc6c09ce86a60f8dbcf163beb2af1b22ad876ac5c82b80e03c89d41efdb518de27408ba6cba73d64e1055a9cdc1167c966
+  metadata.gz: 2ae3b35cc6ddf7b8cce4a0a1a12ebbe57befeb3cfd3e0f546c78468ec0684253a5ee68c2fbc92eda827fbb1dbb3e0cd829c2327ce9afbd5f8c1f9b15eef8253c
+  data.tar.gz: fd12cf81cda06e7b2a72e38e46d68371fff2e0debdc5238fe8bd16ee04b9ca9396af40d0b2f3393370db29565907c76623d6caea369eec9eb29e5eb237ff9798

data/lib/capi_param_builder.rb

@@ -7,23 +7,32 @@
 require_relative 'model/fbc_param_configs'
 require_relative 'model/cookie_settings'
 require_relative 'model/etld_plus_one_resolver'
+require_relative 'release_config'
 require 'set'
 require 'uri'
 require 'cgi'
+require 'base64'
 
 class ParamBuilder
   FBC_NAME = "_fbc"
   FBP_NAME = "_fbp"
   DEFAULT_1PC_AGE = 90 * 24 * 3600
-  LANGUAGE_TOKEN = "BQ"
+  LANGUAGE_TOKEN = "BQ"  # Original Ruby language token
   SUPPORTED_LANGUAGE_TOKENS = ["AQ", "Ag", "Aw", "BA", "BQ", "Bg"]
   MIN_PAYLOAD_SPLIT_LENGTH = 4
   MAX_PAYLOAD_WITH_LANGUAGE_TOKEN_LENGTH = 5
   IPV4_REGEX = /\A(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\z/
   IPV6_REGEX = /\A(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\z|\A(?:[0-9a-fA-F]{1,4}:){1,7}:\z|\A(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}\z|\A(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}\z|\A(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}\z|\A(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}\z|\A(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}\z|\A[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}\z|\A:(?::[0-9a-fA-F]{1,4}){1,7}\z|\A::\z|\A(?:[0-9a-fA-F]{1,4}:){6}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\z/
+  # Appendix constants
+  DEFAULT_FORMAT = 0x01
+  LANGUAGE_TOKEN_INDEX = 0x05  # Ruby language token index
+  APPENDIX_LENGTH_V1 = 2
+  APPENDIX_LENGTH_V2 = 8
 
   def initialize(input = nil)
     @fbc_params_configs = [FbcParamConfigs.new("fbclid", "", "clickID")]
+    @appendix_new = get_appendix(true)
+    @appendix_normal = get_appendix(false)
 
     if input.nil?
       return
@@ -39,6 +48,39 @@ class ParamBuilder
     end
   end
 
+  private def get_appendix(is_new)
+    begin
+      version = ReleaseConfig::VERSION
+      version_parts = version.split(".")
+      major = version_parts[0].to_i
+      minor = version_parts[1].to_i
+      patch = version_parts[2].to_i
+
+      is_new_byte = is_new ? 0x01 : 0x00
+
+      # Create byte array
+      bytes_array = [
+        DEFAULT_FORMAT,        # 0x01 = 1
+        LANGUAGE_TOKEN_INDEX,  # 0x05 = 5
+        is_new_byte,          # 0x01 when is_new=true, 0x00 when is_new=false
+        major,                # Major version number
+        minor,                # Minor version number
+        patch                 # Patch version number
+      ]
+
+      # Convert to bytes and then to base64url-safe string
+      byte_data = bytes_array.pack("C*")  # Pack as unsigned chars (bytes)
+      base64_encoded = Base64.encode64(byte_data).strip  # Remove newlines
+      # Make it URL-safe by replacing characters
+      base64url_safe = base64_encoded.tr('+/', '-_').gsub(/=+$/, '')
+      return base64url_safe
+    rescue Exception => e
+      puts "Failed to parse version in appendix: #{e}"
+      return LANGUAGE_TOKEN # Fall back to original Ruby language token
+    end
+  end
+
+
   private def pre_process_cookies(cookies, cookie_name)
     # Sanity check
     if cookies.nil? || cookies[cookie_name].nil?
@@ -50,13 +92,19 @@ class ParamBuilder
       parts.size > MAX_PAYLOAD_WITH_LANGUAGE_TOKEN_LENGTH
       return nil
     end
-    if parts.size == MAX_PAYLOAD_WITH_LANGUAGE_TOKEN_LENGTH && \
-      !SUPPORTED_LANGUAGE_TOKENS.include?(parts[MAX_PAYLOAD_WITH_LANGUAGE_TOKEN_LENGTH - 1])
-      return nil
+    if parts.size == MAX_PAYLOAD_WITH_LANGUAGE_TOKEN_LENGTH
+      appendix = parts[MAX_PAYLOAD_WITH_LANGUAGE_TOKEN_LENGTH - 1]
+      if appendix.size == APPENDIX_LENGTH_V1
+        if !SUPPORTED_LANGUAGE_TOKENS.include?(appendix)
+          return nil
+        end
+      elsif appendix.size != APPENDIX_LENGTH_V2
+        return nil
+      end
     end
     # Append language token if not present
     if parts.size == MIN_PAYLOAD_SPLIT_LENGTH
-      updated_cookie_value = cookie_value + "." + LANGUAGE_TOKEN
+      updated_cookie_value = cookie_value + "." + @appendix_normal
       @cookie_to_set_dict[cookie_name] = CookieSettings.new(
         cookie_name, updated_cookie_value, @etld_plus_one, DEFAULT_1PC_AGE)
       return updated_cookie_value
@@ -252,7 +300,7 @@ class ParamBuilder
       "." +
       new_fbc_payload +
       "." +
-      LANGUAGE_TOKEN
+      @appendix_new
     updated_cookie_setting = CookieSettings.new(
       FBC_NAME, new_fbc, @etld_plus_one, DEFAULT_1PC_AGE)
     return updated_cookie_setting
@@ -271,7 +319,7 @@ class ParamBuilder
       "." +
       new_fbp_payload +
       "." +
-      LANGUAGE_TOKEN
+      @appendix_new
     updated_cookie_setting = CookieSettings.new(
       FBP_NAME, new_fbp, @etld_plus_one, DEFAULT_1PC_AGE)
     return updated_cookie_setting

data/lib/release_config.rb

@@ -0,0 +1,3 @@
+module ReleaseConfig
+  VERSION = "1.1.0"
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capi_param_builder_ruby
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Facebook
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-07 00:00:00.000000000 Z
+date: 2025-10-13 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -20,6 +20,7 @@ files:
 - lib/model/cookie_settings.rb
 - lib/model/etld_plus_one_resolver.rb
 - lib/model/fbc_param_configs.rb
+- lib/release_config.rb
 homepage:
 licenses:
 - Nonstandard