js-routes 2.3.1 → 2.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97421ede18a16a1cb38ede32268ea60e79dc3aeee2dbe419cbbc4f117848cebb
-  data.tar.gz: d65a56e1026ef6551a7e0c30f90278245dfed8b4ceca460c285b16855586709c
+  metadata.gz: 771e5ddecccbde6b5b78778d456fe9602a4ae4b2aaa89e821cd6bda24be95565
+  data.tar.gz: b0ac96fe4273cc21fa616614429e270a393c7bcd11f15b5b79e1b14e56ec579f
 SHA512:
-  metadata.gz: 13c8299991c8821aff0aa09f4b90ce3a38a9881b780688a6aabadf4871ab79948a095feb0fc9c76b4cc51c84f00aa758f5276838234e963efa1bb641db526984
-  data.tar.gz: 651ae1108a3845a1b948c0b9a1bb9475a2374d6178bd0cf35a7da2dca990081b2bfd40fb2beb92301a4efa3cdef143e83e04a7c39afb7394a685383d9a6b8a91
+  metadata.gz: 150bccfe350126ca0db67d03a8a7bbc22884edd63ef2e86c1cecd4ac2d0d72b941d7f1133cadbe64d19f99332be22db9891ca42f2f4ccfbec7e77447b741fb71
+  data.tar.gz: 2a51b7337560e055a21ff96be1b6f89d40d88bc6b541c56129a5f99823436a7c31027cc6e029f6b33b00a42805cd7986d805a30fc8a8ce5cc4e9bd5be20e2757

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## v2.3.2
+
+* Add `banner` option that allow to control JSDoc on top of generated file. [#324](https://github.com/bogdan/repo/issues/324).
+
+``` ruby
+JsRoutes.configure do |c|
+c.banner = -> {
+  commit_hash = `git rev-parse --short HEAD`.strip
+
+  <<~DOC
+  @file Javascript Route helpers of my magic pony app.
+  @author Bogdan Gusiev
+  @license MIT
+  @version #{commit_hash}
+  DOC
+}
+end
+```
+
 ## v2.3.1
 
 * Add timestamp on when routes.js was generated into banner.

data/Readme.md

@@ -331,6 +331,19 @@ Options to configure JavaScript file generator. These options are only available
 * `optional_definition_params` - make all route paramters in definition optional
   * See [related compatibility issue](#optional-definition-params)
   * Default: `false`
+* `banner` - specify a JSDoc comment on top of the file.
+  * It is not stripped by minifiers by default and helps to originate the content when debugging the build.
+  * You may want to control how much information from backend is exposed to potential attacker at the cost of your own comfort.
+  * See [JSDoc Guide](https://github.com/shri/JSDoc-Style-Guide/blob/master/README.md#files)
+  * Supports a lazy generation with `Proc`.
+  * Default: A string that generates the following:
+
+```
+/**
+ * File generated by js-routes 2.3.1 on 2024-12-04 09:45:59 +0100
+ * Based on Rails 7.2.0 routes of App
+ */
+```
 
 <div id="formatter-options"></div>
 
@@ -421,7 +434,10 @@ user_path.requiredParams() // => ['id']
 
 ## Rails Compatibility
 
-JsRoutes tries to replicate the Rails routing API as closely as possible. If you find any incompatibilities (outside of what is described below), please [open an issue](https://github.com/railsware/js-routes/issues/new).
+JsRoutes tries to replicate the Rails routing API as closely as possible. 
+There are only 2 known issues with compatibility that happen very rarely and have their workarounds.
+
+If you find any incompatibilities outside of ones below, please [open an issue](https://github.com/railsware/js-routes/issues/new).
 
 ### Object and Hash distinction issue
 

data/lib/js_routes/configuration.rb

@@ -3,6 +3,7 @@
 require "pathname"
 require "js_routes/types"
 require 'js_routes/utils'
+require 'js_routes/version'
 
 module JsRoutes
   class Configuration
@@ -39,6 +40,8 @@ module JsRoutes
     attr_accessor :module_type
     sig { returns(T::Boolean) }
     attr_accessor :optional_definition_params
+    sig { returns(BannerCaller) }
+    attr_accessor :banner
 
     sig {params(attributes: T.nilable(Options)).void }
     def initialize(attributes = nil)
@@ -53,10 +56,11 @@ module JsRoutes
       @compact = T.let(false, T::Boolean)
       @serializer = T.let(nil, T.nilable(String))
       @special_options_key = T.let("_options", Literal)
-      @application = T.let(-> { Rails.application }, ApplicationCaller)
+      @application = T.let(T.unsafe(-> { Rails.application }), ApplicationCaller)
       @module_type = T.let('ESM', T.nilable(String))
       @documentation = T.let(true, T::Boolean)
       @optional_definition_params = T.let(false, T::Boolean)
+      @banner = T.let(default_banner, BannerCaller)
 
       return unless attributes
       assign(attributes)
@@ -158,5 +162,17 @@ module JsRoutes
         raise "JsRoutes namespace option can only be used if module_type is nil"
       end
     end
+
+    sig { returns(T.proc.returns(String)) }
+    def default_banner
+      -> () {
+        app = application.is_a?(Proc) ? T.unsafe(application).call : application
+        <<~TXT
+          File generated by js-routes #{JsRoutes::VERSION} on #{Time.now}
+          Based on Rails #{Rails.version} routes of #{app.class}
+        TXT
+
+      }
+    end
   end
 end

data/lib/js_routes/instance.rb

@@ -29,9 +29,9 @@ module JsRoutes
       if named_routes.empty?
         if application.is_a?(Rails::Application)
           if Rails.version >= "8.0.0"
-            application.reload_routes_unless_loaded
+            T.unsafe(application).reload_routes_unless_loaded
           else
-            application.reload_routes!
+            T.unsafe(application).reload_routes!
           end
         end
       end
@@ -43,7 +43,20 @@ module JsRoutes
           raise("Missing key #{key} in JS template")
         end
       end
-      content + routes_export + prevent_types_export
+      banner + content + routes_export + prevent_types_export
+    end
+
+    sig { returns(String) }
+    def banner
+      banner = @configuration.banner
+      banner = banner.call if banner.is_a?(Proc)
+      return "" if banner.blank?
+      [
+        "/**",
+        *banner.split("\n").map { |line| " * #{line}" },
+        " */",
+        "",
+      ].join("\n")
     end
 
     sig { void }
@@ -79,12 +92,8 @@ module JsRoutes
       prefix = @configuration.prefix
       prefix = prefix.call if prefix.is_a?(Proc)
       {
-        'GEM_VERSION'         => JsRoutes::VERSION,
-        'TIMESTAMP'           => Time.now.to_s,
         'ROUTES_OBJECT'       => routes_object,
-        'RAILS_VERSION'       => ::Rails.version,
         'DEPRECATED_FALSE_PARAMETER_BEHAVIOR' => Rails.version < '7.0.0',
-        'APP_CLASS'           => application.class.to_s,
         'DEFAULT_URL_OPTIONS' => json(@configuration.default_url_options),
         'PREFIX'              => json(prefix),
         'SPECIAL_OPTIONS_KEY' => json(@configuration.special_options_key),
@@ -187,7 +196,7 @@ export {};
       rails_engine_app = T.unsafe(app_from_route(route))
       if rails_engine_app.is_a?(Class) &&
           rails_engine_app < Rails::Engine && !route.path.anchored
-        rails_engine_app.routes.named_routes.flat_map do |_, engine_route|
+        T.unsafe(rails_engine_app).routes.named_routes.flat_map do |_, engine_route|
           route_helpers_if_match(engine_route, route)
         end
       else
@@ -200,7 +209,7 @@ export {};
       app = route.app
       # Rails Engine can use additional
       # ActionDispatch::Routing::Mapper::Constraints, which contain app
-      if app.is_a?(ActionDispatch::Routing::Mapper::Constraints)
+      if app.is_a?(T.unsafe(ActionDispatch::Routing::Mapper::Constraints))
         app.app
       else
         app

data/lib/js_routes/middleware.rb

@@ -6,7 +6,7 @@ module JsRoutes
   # whenever routes.rb is modified
   #
   # Inspired by
-  # https://github.com/fnando/i18n-js/blob/main/lib/i18n/js/middleware.rb
+  # https://github.com/fnando/i18n-js/blob/v3/lib/i18n/js/middleware.rb
   class Middleware
     include JsRoutes::Types
     include RackApp

data/lib/js_routes/types.rb

@@ -16,11 +16,20 @@ module JsRoutes
     Literal = T.type_alias { T.any(String, Symbol) }
     JourneyRoute = T.type_alias{ActionDispatch::Journey::Route}
     RouteSpec = T.type_alias {T.untyped}
-    Application = T.type_alias { T.any(T::Class[Rails::Engine], Rails::Application) }
-    ApplicationCaller = T.type_alias { T.any(Application, T.proc.returns(Application)) }
+    Application = T.type_alias do
+      T.any(T::Class[Rails::Engine], Rails::Application)
+    end
+    ApplicationCaller = T.type_alias do
+      T.any(Application, T.proc.returns(Application))
+    end
+    BannerCaller = T.type_alias do
+      T.any(String, NilClass, T.proc.returns(T.any(String, NilClass)))
+    end
     Clusivity = T.type_alias { T.any(Regexp, T::Array[Regexp]) }
     FileName = T.type_alias { T.any(String, Pathname, NilClass) }
-    ConfigurationBlock = T.type_alias { T.proc.params(arg0: JsRoutes::Configuration).void }
+    ConfigurationBlock = T.type_alias do
+      T.proc.params(arg0: JsRoutes::Configuration).void
+    end
     Prefix = T.type_alias do
       T.any(T.proc.returns(String), String, NilClass)
     end

data/lib/js_routes/version.rb

@@ -1,4 +1,4 @@
 # typed: strict
 module JsRoutes
-  VERSION = "2.3.1"
+  VERSION = "2.3.2"
 end

data/lib/routes.d.ts

@@ -1,7 +1,3 @@
-/**
- * File generated by js-routes RubyVariables.GEM_VERSION on RubyVariables.TIMESTAMP
- * Based on Rails RubyVariables.RAILS_VERSION routes of RubyVariables.APP_CLASS
- */
 declare type Optional<T> = {
     [P in keyof T]?: T[P] | null;
 };

data/lib/routes.js

@@ -1,7 +1,3 @@
-/**
- * File generated by js-routes RubyVariables.GEM_VERSION on RubyVariables.TIMESTAMP
- * Based on Rails RubyVariables.RAILS_VERSION routes of RubyVariables.APP_CLASS
- */
 // eslint-disable-next-line
 RubyVariables.WRAPPER(
 // eslint-disable-next-line

data/lib/routes.ts

@@ -1,8 +1,3 @@
-/**
- * File generated by js-routes RubyVariables.GEM_VERSION on RubyVariables.TIMESTAMP
- * Based on Rails RubyVariables.RAILS_VERSION routes of RubyVariables.APP_CLASS
- */
-
 type Optional<T> = { [P in keyof T]?: T[P] | null };
 type Collection<T> = Record<string, T>;
 

data/lib/templates/initializer.rb

@@ -1,5 +1,27 @@
 JsRoutes.setup do |c|
   # Setup your JS module system:
-  # ESM, CJS, AMD, UMD or nil
+  # ESM, CJS, AMD, UMD or nil.
   # c.module_type = "ESM"
+
+  # Legacy setup for no modules system.
+  # Sets up a global variable `Routes`
+  # that holds route helpers.
+  # c.module_type = nil
+  # c.namespace = "Routes"
+
+  # Follow javascript naming convention
+  # but lose the ability to match helper name
+  # on backend and frontend consistently.
+  # c.camel_case = true
+
+  # Generate only helpers that match specific pattern.
+  # c.exclude = /^api_/
+  # c.include = /^admin_/
+
+  # Generate `*_url` helpers besides `*_path`
+  # for apps that work on multiple domains.
+  # c.url_links = true
+
+  # More options:
+  # @see https://github.com/railsware/js-routes#available-options
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: js-routes
 version: !ruby/object:Gem::Version
-  version: 2.3.1
+  version: 2.3.2
 platform: ruby
 authors:
 - Bogdan Gusiev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-27 00:00:00.000000000 Z
+date: 2024-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -144,9 +144,9 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/railsware/js-routes/issues
-  changelog_uri: https://github.com/railsware/js-routes/blob/v2.3.1/CHANGELOG.md
+  changelog_uri: https://github.com/railsware/js-routes/blob/v2.3.2/CHANGELOG.md
   documentation_uri: https://github.com/railsware/js-routes
-  source_code_uri: https://github.com/railsware/js-routes/tree/v2.3.1/activerecord
+  source_code_uri: https://github.com/railsware/js-routes/tree/v2.3.2/activerecord
   rubygems_mfa_required: 'true'
   github_repo: ssh://github.com/railsware/js-routes
 post_install_message:
@@ -164,7 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
+rubygems_version: 3.5.14
 signing_key:
 specification_version: 4
 summary: Brings Rails named routes to javascript