typespec_from_serializers 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1f7f17073b80dd99f290b8f40ddc843abca595efe3609e937717238068820a0
-  data.tar.gz: 57efeb77eb954a5a2dbcd6adf2752296673f3bee488bbbea47b26cbd6e4fadc4
+  metadata.gz: 86e41505961e13ef72df62124721ae6d1c929104726378b893c2c785dcec7da0
+  data.tar.gz: 985c5514cdc77c02ee25a4257c8c3fc7d3c8adb7d7ea7585d1d64c3f3af1f732
 SHA512:
-  metadata.gz: 03df9644da15df1f324c5054363d8dd95423427f90ae33859e50bfaeaa69f45542f0fff5d3c99c93c7bb8058dd4ce7d2d0f55e42107428a4b7c6cc0927338538
-  data.tar.gz: 61dc21244c335793da7228f310c530b2c65e81433ed62d20983b9ab720423ed91d6f72a4032221eb3431e29b73a1d8010acb91cb44e2706173595b7dc6c62215
+  metadata.gz: d51adab2df0d34f587eb375950cafd6231fd5e94b8e1359086d8b7fd5745c6c200900217c7e95edab0a855a07029aaf5147fde3f89639c9843770298d03ab031
+  data.tar.gz: 06fd0b0629657ae60d101bca4ed879cb5134801ce91097e87acc8e14825f7f2a290211dd282801bcd8154b4d7f1514ab2f24e83cfd5fd4f22be18db711bb6399

data/CHANGELOG.md

@@ -1,4 +1,49 @@
-# [2.3.0](https://github.com/ElMassimo/types_from_serializers/compare/types_from_serializers@2.2.0...types_from_serializers@2.3.0) (2024-08-23)
+# TypeSpec From Serializers Changelog
+
+## [0.2.1] - 2025-12-19
+
+### Fixed
+- Correct `@service` decorator syntax to use `#{}` for object literals
+- Add newline after `@service` decorator for better readability
+
+## [0.2.0] - 2025-12-19
+
+Initial release - fork of `types_from_serializers` adapted to generate TypeSpec instead of TypeScript.
+
+### Features
+
+**Routes Generation**
+- Generate TypeSpec HTTP interfaces from Rails routes automatically
+- Type path parameters in `routes.rb`: `type: { id: Integer }`
+- Type request body in controllers with `type` DSL
+- Nested routes organized in namespaces
+- Filter exported routes with `export_if` configuration
+
+**Sorbet Integration**
+- Automatic type inference from Sorbet signatures
+- Support for `T.nilable`, `T::Array`, unions, and complex shapes
+- Works with RBI files (Tapioca-generated)
+
+**Type System**
+- Simple `type:` syntax for explicit types
+- Union types: `type: "string | int32"`
+- Automatic inference from SQL schema and ActiveRecord enums
+- Custom TypeSpec model references
+
+**OpenAPI**
+- Compile TypeSpec to OpenAPI 3.0: `rake typespec_from_serializers:compile_openapi`
+- Setup dependencies: `rake typespec_from_serializers:setup`
+
+**Developer Experience**
+- Automatic regeneration in development mode
+- Vite live reload support
+- Incremental generation for modified files only
+
+---
+
+# Previous versions (types_from_serializers)
+
+## [2.3.0](https://github.com/ElMassimo/types_from_serializers/compare/types_from_serializers@2.2.0...types_from_serializers@2.3.0) (2024-08-23)
 
 
 ### Features

data/README.md

@@ -1,20 +1,15 @@
 <h1 align="center">
 TypeSpec From Serializers
 <p align="center">
-<a href="https://travis-ci.org/dannote/typespec_from_serializers"><img alt="Build Status" src="https://travis-ci.org/dannote/typespec_from_serializers.svg"/></a>
-<a href="http://inch-ci.org/github/dannote/typespec_from_serializers"><img alt="Inline docs" src="http://inch-ci.org/github/dannote/typespec_from_serializers.svg"/></a>
+<a href="https://github.com/dannote/typespec_from_serializers/actions"><img alt="Build Status" src="https://github.com/dannote/typespec_from_serializers/workflows/build/badge.svg"/></a>
 <a href="https://rubygems.org/gems/typespec_from_serializers"><img alt="Gem Version" src="https://img.shields.io/gem/v/typespec_from_serializers.svg?colorB=e9573f"/></a>
 <a href="https://github.com/dannote/typespec_from_serializers/blob/main/LICENSE.txt"><img alt="License" src="https://img.shields.io/badge/license-MIT-428F7E.svg"/></a>
 </p>
 </h1>
 
-[aliases]: https://vite-ruby.netlify.app/guide/development.html#import-aliases-%F0%9F%91%89
-[config options]: https://github.com/dannote/typespec_from_serializers/blob/main/lib/typespec_from_serializers/generator.rb#L82-L85
-[readme]: https://github.com/dannote/typespec_from_serializers
+Automatically generate [TypeSpec](https://typespec.io) definitions from Ruby serializers and Rails routes.
 
-**TypeSpec From Serializers** is a Ruby gem that automatically generates [TypeSpec](https://typespec.io) definitions from Ruby serializers and Rails routes. It is a derivative work of [`types_from_serializers`][types_from_serializers] by ElMassimo, originally designed to generate TypeScript definitions. This fork adapts the core functionality to produce TypeSpec descriptions, enabling Rails developers to define APIs compatible with TypeSpec’s ecosystem, including OpenAPI generation and client/server code scaffolding.
-
-For more information, check the main [README].
+For full documentation, see the [main README](https://github.com/dannote/typespec_from_serializers).
 
 ### Installation 💿
 

data/lib/typespec_from_serializers/dsl/controller.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module TypeSpecFromSerializers
+  module DSL
+    # DSL for Rails controllers to declare parameter types
+    module Controller
+      extend ActiveSupport::Concern
+
+      module ClassMethods
+        # DSL for declaring method return types (same as serializer DSL)
+        # Usage:
+        #   type id: Integer, title: String
+        #   def video_params
+        #     # ...
+        #   end
+        def type(type_definition)
+          @_pending_return_type = type_definition
+        end
+
+        # Internal: Captures pending type declaration when method is defined
+        def method_added(method_name)
+          super
+          if (pending_type = @_pending_return_type)
+            return_type_registry[method_name] = pending_type
+            @_pending_return_type = nil
+          end
+        end
+
+        # Internal: Registry storing method return type declarations
+        def return_type_registry
+          @return_type_registry ||= {}
+        end
+
+        # Public: Retrieve declared return type for a method
+        def type_for_method(method_name)
+          return_type_registry[method_name.to_sym]
+        end
+      end
+    end
+  end
+end

data/lib/typespec_from_serializers/dsl/serializer.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+# Internal: A DSL to specify types for serializer attributes.
+module TypeSpecFromSerializers
+  module DSL
+    module Serializer
+      extend ActiveSupport::Concern
+
+      module ClassMethods
+        # Override: Capture the name of the model related to the serializer.
+        #
+        # name - An alias for the internal object in the serializer.
+        # model - The name of an ActiveRecord model to infer types from the schema.
+        # typespec_from - The name of a TypeScript model to infer types from.
+        def object_as(name, model: nil, typespec_from: nil)
+          # NOTE: Avoid taking memory for type information that won't be used.
+          if Rails.env.development?
+            model ||= name.is_a?(Symbol) ? name : try(:_serializer_model_name) || name
+            define_singleton_method(:_serializer_model_name) { model }
+            define_singleton_method(:_serializer_typespec_from) { typespec_from } if typespec_from
+          end
+
+          super(name)
+        end
+
+        # Public: Declare type for an attribute or method return value.
+        #
+        # type    - Symbol for attribute type, or Class/Sorbet type for method return
+        # options - Additional options passed to `attribute` when type is a Symbol
+        #
+        # Examples
+        #
+        #   type :string           # Attribute type
+        #   type String            # Method return type
+        #   type T.nilable(String) # Sorbet type
+        #
+        def type(type, **options)
+          type.is_a?(Symbol) ? attribute(type: type, **options) : @_pending_return_type = type
+        end
+
+        # Internal: Captures pending type declaration when method is defined.
+        def method_added(method_name)
+          super
+          if (pending_type = @_pending_return_type)
+            return_type_registry[method_name] = pending_type
+            @_pending_return_type = nil
+          end
+        end
+
+        # Internal: Registry storing method return type declarations.
+        def return_type_registry
+          @return_type_registry ||= {}
+        end
+
+        # Public: Retrieve declared return type for a method.
+        def type_for_method(method_name)
+          return_type_registry[method_name.to_sym]
+        end
+
+      private
+
+        # Override: Remove unnecessary options in production, types are only
+        # used when generating code in development.
+        unless Rails.env.development?
+          def add_attribute(name, type: nil, optional: nil, **options)
+            super(name, **options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/typespec_from_serializers/dsl.rb

@@ -1,46 +1,4 @@
 # frozen_string_literal: true
 
-require "active_support/concern"
-
-# Internal: A DSL to specify types for serializer attributes.
-module TypeSpecFromSerializers
-  module DSL
-    extend ActiveSupport::Concern
-
-    module ClassMethods
-      # Override: Capture the name of the model related to the serializer.
-      #
-      # name - An alias for the internal object in the serializer.
-      # model - The name of an ActiveRecord model to infer types from the schema.
-      # typespec_from - The name of a TypeScript model to infer types from.
-      def object_as(name, model: nil, typespec_from: nil)
-        # NOTE: Avoid taking memory for type information that won't be used.
-        if Rails.env.development?
-          model ||= name.is_a?(Symbol) ? name : try(:_serializer_model_name) || name
-          define_singleton_method(:_serializer_model_name) { model }
-          define_singleton_method(:_serializer_typespec_from) { typespec_from } if typespec_from
-        end
-
-        super(name)
-      end
-
-      # Public: Shortcut for typing a serializer attribute.
-      #
-      # It specifies the type for a serializer method that will be defined
-      # immediately after calling this method.
-      def type(type, **options)
-        attribute type: type, **options
-      end
-
-    private
-
-      # Override: Remove unnecessary options in production, types are only
-      # used when generating code in development.
-      unless Rails.env.development?
-        def add_attribute(name, type: nil, optional: nil, **options)
-          super(name, **options)
-        end
-      end
-    end
-  end
-end
+require_relative "dsl/serializer"
+require_relative "dsl/controller"