capi_param_builder_ruby 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8acc5a9893deeb3ac84eb9973c23fe5bf498d86ac00c3afcee5320ffd18a50e9
-  data.tar.gz: 5dd4b0017743d2a06b2c8a6c4c8b04d77052a2e642d2d9912895002e220bb62a
+  metadata.gz: 4a33297523bdd07b142d4a946e4b3134675aec7d95d3479dad27647e566e36e4
+  data.tar.gz: e62d98b35b46fd27adb878d736f8640c8cb589d437f94a7a19ab9d986eb2d38c
 SHA512:
-  metadata.gz: 2ae3b35cc6ddf7b8cce4a0a1a12ebbe57befeb3cfd3e0f546c78468ec0684253a5ee68c2fbc92eda827fbb1dbb3e0cd829c2327ce9afbd5f8c1f9b15eef8253c
-  data.tar.gz: fd12cf81cda06e7b2a72e38e46d68371fff2e0debdc5238fe8bd16ee04b9ca9396af40d0b2f3393370db29565907c76623d6caea369eec9eb29e5eb237ff9798
+  metadata.gz: 0c0a171eb5f541ca08f7a08c23f7505bdc5a00818668126698b440ea2268670f17bedefeadf10f2b6b89a9c504111a55b1050a2988180a12165c28e5e3cd5498
+  data.tar.gz: a44149e6a88bddb67c82239b9f680668fc54f73e4ed6fcc16c6748b541110c1086e9f639cfca24aca7ac701ec11568e45cb2a5e8dae92f5fd3c0c1fd5dc071ea

data/lib/capi_param_builder.rb

@@ -29,10 +29,17 @@ class ParamBuilder
   APPENDIX_LENGTH_V1 = 2
   APPENDIX_LENGTH_V2 = 8
 
+  # Appendix type constants
+  APPENDIX_NO_CHANGE = 0x00
+  APPENDIX_GENERAL_NEW = 0x01
+  APPENDIX_NET_NEW = 0x02
+  APPENDIX_MODIFIED_NEW = 0x03
+
   def initialize(input = nil)
     @fbc_params_configs = [FbcParamConfigs.new("fbclid", "", "clickID")]
-    @appendix_new = get_appendix(true)
-    @appendix_normal = get_appendix(false)
+    @appendix_net_new = get_appendix(APPENDIX_NET_NEW)
+    @appendix_modified_new = get_appendix(APPENDIX_MODIFIED_NEW)
+    @appendix_no_change = get_appendix(APPENDIX_NO_CHANGE)
 
     if input.nil?
       return
@@ -48,7 +55,7 @@ class ParamBuilder
     end
   end
 
-  private def get_appendix(is_new)
+  private def get_appendix(appendix_type)
     begin
       version = ReleaseConfig::VERSION
       version_parts = version.split(".")
@@ -56,13 +63,19 @@ class ParamBuilder
       minor = version_parts[1].to_i
       patch = version_parts[2].to_i
 
-      is_new_byte = is_new ? 0x01 : 0x00
+      # Validate appendix type
+      valid_types = [APPENDIX_NET_NEW, APPENDIX_GENERAL_NEW, APPENDIX_MODIFIED_NEW]
+      if valid_types.include?(appendix_type)
+        type_byte = appendix_type
+      else
+        type_byte = APPENDIX_NO_CHANGE
+      end
 
       # 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
+        type_byte,            # appendix type
         major,                # Major version number
         minor,                # Minor version number
         patch                 # Patch version number
@@ -104,7 +117,7 @@ class ParamBuilder
     end
     # Append language token if not present
     if parts.size == MIN_PAYLOAD_SPLIT_LENGTH
-      updated_cookie_value = cookie_value + "." + @appendix_normal
+      updated_cookie_value = cookie_value + "." + @appendix_no_change
       @cookie_to_set_dict[cookie_name] = CookieSettings.new(
         cookie_name, updated_cookie_value, @etld_plus_one, DEFAULT_1PC_AGE)
       return updated_cookie_value
@@ -282,17 +295,26 @@ class ParamBuilder
       return nil
     end
 
+    cookie_update = false
+    is_net_new = false
     if existing_fbc.nil?
       cookie_update = true
+      is_net_new = true
     else
       parts = existing_fbc.split(/\./)
-      cookie_update = new_fbc_payload != parts[3]
+      if parts.size < MIN_PAYLOAD_SPLIT_LENGTH
+        cookie_update = true
+        is_net_new = true
+      else
+        cookie_update = new_fbc_payload != parts[3]
+      end
     end
     if cookie_update == false
       return nil
     end
 
     current_ms = (Time.now.to_f * 1000).to_i.to_s
+    appendix = is_net_new ? @appendix_net_new : @appendix_modified_new
     new_fbc = "fb." +
       @sub_domain_index.to_s +
       "." +
@@ -300,7 +322,7 @@ class ParamBuilder
       "." +
       new_fbc_payload +
       "." +
-      @appendix_new
+      appendix
     updated_cookie_setting = CookieSettings.new(
       FBC_NAME, new_fbc, @etld_plus_one, DEFAULT_1PC_AGE)
     return updated_cookie_setting
@@ -319,7 +341,7 @@ class ParamBuilder
       "." +
       new_fbp_payload +
       "." +
-      @appendix_new
+      @appendix_net_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

@@ -1,3 +1,8 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+
+# This source code is licensed under the license found in the
+# LICENSE file in the root directory of this source tree.
 module ReleaseConfig
-  VERSION = "1.1.0"
+  VERSION = "1.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capi_param_builder_ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Facebook
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-13 00:00:00.000000000 Z
+date: 2026-01-30 00:00:00.000000000 Z
 dependencies: []
 description:
 email: