elixir_proto

defmodule ElixirProto do
  @moduledoc """
  A compact serialization library for Elixir that stores field indices instead of field names.

  ElixirProto combines the robustness of Erlang's term serialization with the space efficiency
  of index-based field storage. Instead of serializing field names repeatedly, it stores only
  field indices and uses schema information during deserialization.
  """

  alias ElixirProto.Schema.Registry
  alias ElixirProto.SchemaRegistry

  @doc """
  Encode a struct to compressed binary format.

  The encoding process:
  1. Extract struct module and fields
  2. Get or create schema index for ultra-compact storage
  3. Convert to fixed tuple format (most efficient)
  4. Skip nil fields for space efficiency
  5. Serialize with Erlang terms
  6. Compress with zlib

  ## Examples

      iex> defmodule TestUser do
      ...>   use ElixirProto.Schema, name: "test.user"
      ...>   defschema TestUser, [:id, :name]
      ...> end
      iex> user = %TestUser{id: 1, name: "Alice"}
      iex> encoded = ElixirProto.encode(user)
      iex> is_binary(encoded)
      true

  """
  def encode(%module{} = struct) do
    schema = Registry.get_schema_by_module(module)

    if schema == nil do
      raise ArgumentError, "Schema not found for module #{inspect(module)}. Make sure the module uses ElixirProto.Schema."
    end

    schema_name = schema.module.__schema__(:name)
    max_fields = length(schema.fields)

    # Get or create schema index (2 bytes vs potentially 20+ bytes for name)
    {schema_index, _is_new} = SchemaRegistry.get_or_create_index(schema_name)

    # Convert to fixed tuple format (most space efficient)
    values = Enum.map(1..max_fields, fn i ->
      field_name = Map.get(schema.index_fields, i)
      if field_name do
        Map.get(Map.from_struct(struct), field_name)
      else
        nil
      end
    end)

    # Create ultra-compact format: {schema_index, tuple_of_values}
    serializable_data = {schema_index, List.to_tuple(values)}

    # Serialize and compress
    serializable_data
    |> :erlang.term_to_binary()
    |> :zlib.compress()
  end

  @doc """
  Decode compressed binary back to struct.

  The decoding process:
  1. Decompress with zlib
  2. Convert to terms
  3. Extract schema index
  4. Look up schema name by index
  5. Reconstruct struct from fixed tuple

  ## Examples

      iex> defmodule TestUser do
      ...>   use ElixirProto.Schema, name: "test.user"
      ...>   defschema TestUser, [:id, :name]
      ...> end
      iex> encoded = ElixirProto.encode(%TestUser{id: 1, name: "Alice"})
      iex> decoded = ElixirProto.decode(encoded)
      iex> decoded.id
      1
      iex> decoded.name
      "Alice"

  """
  def decode(encoded_binary) when is_binary(encoded_binary) do
    # Decompress and deserialize
    {schema_index, values_tuple} =
      encoded_binary
      |> :zlib.uncompress()
      |> :erlang.binary_to_term()

    # Look up schema name by index
    schema_name = SchemaRegistry.get_name(schema_index)

    if schema_name == nil do
      raise ArgumentError, "Schema index #{schema_index} not found in registry. Schema may have been registered after encoding."
    end

    # Look up schema by name
    schema = Registry.get_schema(schema_name)

    if schema == nil do
      raise ArgumentError, "Schema '#{schema_name}' not found in registry. Make sure all required modules are loaded."
    end

    module = schema.module
    fields = schema.fields

    # Convert tuple back to field map
    values_list = Tuple.to_list(values_tuple)

    field_map = fields
    |> Enum.with_index()
    |> Enum.reduce(%{}, fn {field_name, index}, acc ->
      value = Enum.at(values_list, index)
      Map.put(acc, field_name, value)
    end)

    struct(module, field_map)
  end
end