typespec_from_serializers 0.5.4 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e442eede2713d04dc58848c414f8c97fb3131ec16aff96c33b31fc2b9bfe248b
-  data.tar.gz: 88424e945a35538e356adceaf9abdcb2ceb5997469a94efe9d661c31b228050a
+  metadata.gz: 80df92c4cd5814bc352130e1d4eb56d648c7efbb46158a99bf98a100f55cc186
+  data.tar.gz: f1d3027b282117a49be85a929cf85183ce22a08e39a6a8390d7f3be1363c85cb
 SHA512:
-  metadata.gz: 960f08588e534643e0ecdb2cf4f3129d351995330f4474748c10ee8f7e844e202614c3e8ae391753c5b45b555831398aff2ffa3474af080ef9e5767b86f2f706
-  data.tar.gz: 32cd0ff2d5b1e339829a78f7150b3870a4ef954d61d12c8738b3ebe5f0d04b31ea7ba1988fc4efd7f5c46e436f56e96d52b2719f77b29a95231fdfaf13d07777
+  metadata.gz: 99f22f4f43af8b642d4e69e81b089f472e252b9075df4975a34e392226fea6c5b9e01b39bd8cb555a3f03c1bac0cb8b113a04ea2daa68e0ea87a4b40c6f0a5d7
+  data.tar.gz: 38fc2e2f89bc1e8933de619f8573806bb562e907fc71a46c66c58d4411f25299c6f96d6507440542c8b1ebe841bfe3d2538c1eaa2a0ceaea9c556a1edeb771ef

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # TypeSpec From Serializers Changelog
 
+## [0.6.0] - 2026-03-03
+
+### Added
+- Automatic route namespace/interface disambiguation: names that collide with model names are suffixed (e.g., `namespace Task` → `namespace TaskRoutes` when `TaskSerializer` exists)
+- New `route_namespace_suffix` config option (default: `"Routes"`) to control the disambiguation suffix
+- Content-based cache keys: files are only rewritten when generated output actually changes, eliminating unnecessary diffs from internal representation changes
+
 ## [0.5.4] - 2025-12-23
 
 ### Fixed

data/lib/typespec_from_serializers/generator.rb

@@ -213,6 +213,7 @@ module TypeSpecFromSerializers
     :custom_typespec_dir,
     :name_from_serializer,
     :controller_suffix,
+    :route_namespace_suffix,
     :param_method_suffix,
     :global_types,
     :sort_properties_by,
@@ -653,9 +654,10 @@ module TypeSpecFromSerializers
     # Internal: Defines a TypeSpec model for the serializer.
     def generate_model_for(serializer)
       model = serializer.tsp_model
+      content = serializer_model_content(model)
 
-      write_if_changed(filename: "models/#{model.filename}", cache_key: model.inspect, extension: "tsp") {
-        serializer_model_content(model)
+      write_if_changed(filename: "models/#{model.filename}", cache_key: content, extension: "tsp") {
+        content
       }
     rescue => e
       $stderr.puts "ERROR in generate_model_for(#{serializer.name}): #{e.class}: #{e.message}"
@@ -665,10 +667,10 @@ module TypeSpecFromSerializers
 
     # Internal: Allows to import all serializer types from a single file.
     def generate_index_file
-      cache_key = all_serializer_files.map { |file| file.delete_prefix(root.to_s) }.join
-      write_if_changed(filename: "index", cache_key: cache_key) {
-        load_serializers(all_serializer_files)
-        serializers_index_content(loaded_serializers)
+      load_serializers(all_serializer_files)
+      content = serializers_index_content(loaded_serializers)
+      write_if_changed(filename: "index", cache_key: content) {
+        content
       }
     end
 
@@ -677,9 +679,9 @@ module TypeSpecFromSerializers
       return [] unless defined?(Rails) && Rails.application
 
       routes, controllers = collect_rails_routes
-      cache_key = routes.map(&:inspect).join
-      write_if_changed(filename: "routes", cache_key: cache_key) {
-        routes_content(routes)
+      content = routes_content(routes)
+      write_if_changed(filename: "routes", cache_key: content) {
+        content
       }
 
       # Return list of controller class names
@@ -811,8 +813,10 @@ module TypeSpecFromSerializers
       operations = ns_routes.map { |route| build_operation(controller, route) }
       operations = make_operation_names_unique(operations)
 
+      interface_name = disambiguate_route_name(controller.tr("/", "_").camelize)
+
       Resource.new(
-        name: controller.tr("/", "_").camelize,
+        name: interface_name,
         path: base_path.start_with?("/") ? base_path : "/#{base_path}",
         operations: operations,
         parent_namespace: parent_namespace,
@@ -915,11 +919,21 @@ module TypeSpecFromSerializers
     end
 
     # Internal: Extracts parent namespace from nested route paths
-    # E.g., "/lands/{land_id}/comments" → "Land"
-    #       "/tasks/{task_id}/comments" → "Task"
+    # E.g., "/lands/{land_id}/comments" → "LandRoutes" (suffixed to avoid model collision)
+    #       "/tasks/{task_id}/comments" → "TaskRoutes"
     def extract_parent_namespace(path)
       # Match pattern like /resource/:resource_id/nested (Rails uses : notation)
-      path[%r{^/([^/]+)/:[^/]+_id/}, 1]&.singularize&.camelize
+      name = path[%r{^/([^/]+)/:[^/]+_id/}, 1]&.singularize&.camelize
+      return unless name
+
+      disambiguate_route_name(name)
+    end
+
+    # Internal: Suffixes a route namespace/interface name if it collides with a model name.
+    # E.g., "Task" → "TaskRoutes" when TaskSerializer exists.
+    def disambiguate_route_name(name)
+      model_names = loaded_serializers.map { |s| s.tsp_name }
+      model_names.include?(name) ? "#{name}#{config.route_namespace_suffix}" : name
     end
 
     # Internal: Simplifies operation name using REST conventions
@@ -1368,6 +1382,9 @@ module TypeSpecFromSerializers
         # Controller suffix for route generation reporting
         controller_suffix: "Controller",
 
+        # Suffix for route namespaces/interfaces that collide with model names
+        route_namespace_suffix: "Routes",
+
         # Types that don't need to be imported in TypeSpec.
         global_types: [
           "Array",

data/lib/typespec_from_serializers/version.rb

@@ -2,5 +2,5 @@
 
 module TypeSpecFromSerializers
   # Public: This library adheres to semantic versioning.
-  VERSION = "0.5.4"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: typespec_from_serializers
 version: !ruby/object:Gem::Version
-  version: 0.5.4
+  version: 0.6.0
 platform: ruby
 authors:
 - Danila Poyarkov
 - Máximo Mussini
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-23 00:00:00.000000000 Z
+date: 2026-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -328,7 +327,6 @@ homepage: https://github.com/dannote/typespec_from_serializers
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -343,8 +341,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Generate TypeSpec descriptions from your JSON serializers.
 test_files: []