Support nil parameter serialization behavior in Rails 8.1

- Introduced `DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR` to handle nil query parameters based on Rails version.
- Updated `default_serializer` method in `routes.js` and `routes.ts` to accommodate the new behavior.
- Ensured backward compatibility with Rails versions below 8.1.0.

Author: bogdan

lib/js_routes/instance.rb

@@ -94,6 +94,7 @@ def js_variables
       {
         'ROUTES_OBJECT'       => routes_object,
         'DEPRECATED_FALSE_PARAMETER_BEHAVIOR' => Rails.version < '7.0.0',
+        'DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR' => Rails.version < '8.1.0',
         'DEFAULT_URL_OPTIONS' => json(@configuration.default_url_options),
         'PREFIX'              => json(prefix),
         'SPECIAL_OPTIONS_KEY' => json(@configuration.special_options_key),

lib/routes.d.ts

@@ -62,6 +62,7 @@ declare type ModuleType = "CJS" | "AMD" | "UMD" | "ESM" | "DTS" | "NIL";
 declare const RubyVariables: {
     PREFIX: string;
     DEPRECATED_FALSE_PARAMETER_BEHAVIOR: boolean;
+    DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR: boolean;
     SPECIAL_OPTIONS_KEY: string;
     DEFAULT_URL_OPTIONS: RouteParameters;
     SERIALIZER: Serializer;

lib/routes.js

@@ -122,9 +122,6 @@ RubyVariables.WRAPPER(
             };
         }
         default_serializer(value, prefix) {
-            if (this.is_nullable(value)) {
-                return "";
-            }
             if (!prefix && !this.is_object(value)) {
                 throw new Error("Url parameters should be a javascript hash");
             }
@@ -140,21 +137,19 @@ RubyVariables.WRAPPER(
                     if (!hasProp(value, key))
                         continue;
                     let prop = value[key];
-                    if (this.is_nullable(prop) && prefix) {
-                        prop = "";
-                    }
-                    if (this.is_not_nullable(prop)) {
-                        if (prefix) {
-                            key = prefix + "[" + key + "]";
-                        }
-                        result.push(this.default_serializer(prop, key));
+                    if (prefix) {
+                        key = prefix + "[" + key + "]";
                     }
+                    result.push(this.default_serializer(prop, key));
                 }
             }
             else {
-                if (this.is_not_nullable(value)) {
-                    result.push(encodeURIComponent(prefix) + "=" + encodeURIComponent("" + value));
-                }
+                result.push(this.is_not_nullable(value) ||
+                    RubyVariables.DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR
+                    ? encodeURIComponent(prefix) +
+                        "=" +
+                        encodeURIComponent("" + (value !== null && value !== void 0 ? value : ""))
+                    : encodeURIComponent(prefix));
             }
             return result.join("&");
         }

lib/routes.ts

@@ -79,6 +79,7 @@ type ModuleType = "CJS" | "AMD" | "UMD" | "ESM" | "DTS" | "NIL";
 declare const RubyVariables: {
   PREFIX: string;
   DEPRECATED_FALSE_PARAMETER_BEHAVIOR: boolean;
+  DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR: boolean;
   SPECIAL_OPTIONS_KEY: string;
   DEFAULT_URL_OPTIONS: RouteParameters;
   SERIALIZER: Serializer;
@@ -246,9 +247,6 @@ RubyVariables.WRAPPER(
       };
 
       default_serializer(value: unknown, prefix?: string | null): string {
-        if (this.is_nullable(value)) {
-          return "";
-        }
         if (!prefix && !this.is_object(value)) {
           throw new Error("Url parameters should be a javascript hash");
         }
@@ -262,22 +260,20 @@ RubyVariables.WRAPPER(
           for (let key in value) {
             if (!hasProp(value, key)) continue;
             let prop = value[key];
-            if (this.is_nullable(prop) && prefix) {
-              prop = "";
-            }
-            if (this.is_not_nullable(prop)) {
-              if (prefix) {
-                key = prefix + "[" + key + "]";
-              }
-              result.push(this.default_serializer(prop, key));
+            if (prefix) {
+              key = prefix + "[" + key + "]";
             }
+            result.push(this.default_serializer(prop, key));
           }
         } else {
-          if (this.is_not_nullable(value)) {
-            result.push(
-              encodeURIComponent(prefix) + "=" + encodeURIComponent("" + value)
-            );
-          }
+          result.push(
+            this.is_not_nullable(value) ||
+              RubyVariables.DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR
+              ? encodeURIComponent(prefix) +
+                  "=" +
+                  encodeURIComponent("" + (value ?? ""))
+              : encodeURIComponent(prefix)
+          );
         }
         return result.join("&");
       }

spec/js_routes/module_types/dts/routes.spec.d.ts

@@ -62,6 +62,7 @@ declare type ModuleType = "CJS" | "AMD" | "UMD" | "ESM" | "DTS" | "NIL";
 declare const RubyVariables: {
     PREFIX: string;
     DEPRECATED_FALSE_PARAMETER_BEHAVIOR: boolean;
+    DEPRECATED_NIL_QUERY_PARAMETER_BEHAVIOR: boolean;
     SPECIAL_OPTIONS_KEY: string;
     DEFAULT_URL_OPTIONS: RouteParameters;
     SERIALIZER: Serializer;