postgrest/releases/v8.0.0.rst

.. |br| raw:: html

   <br />

v8.0.0
======

You can download this release at the `PostgREST v8.0.0 release page <https://github.com/PostgREST/postgrest/releases/tag/v8.0.0>`_.

Added
-----

* Allow HTTP status override through the :ref:`response.status <guc_resp_status>` GUC.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Allow :ref:`s_procs_variadic`.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Allow :ref:`embedding_view_chains` recursively to any depth.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* No downtime when reloading the schema cache. See :ref:`schema_reloading`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Allow schema cache reloading using PostgreSQL :ref:`NOTIFY <schema_reloading_notify>` command. This enables :ref:`auto_schema_reloading`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Allow sending the header ``Prefer: headers-only`` to get a response with a ``Location`` header. See :ref:`insert_update`.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

* Allow :ref:`connection_poolers` such as PgBouncer in transaction pooling mode.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

* Allow :ref:`config_reloading` by sending a SIGUSR2 signal.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Allow ``Bearer`` with and without capitalization as authentication schema. See :ref:`client_auth`.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* :ref:`in_db_config` that can be :ref:`reloaded with NOTIFY <in_db_config_reloading>`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Allow OPTIONS to generate HTTP methods based on views triggers. See :ref:`OPTIONS requests <options_requests>`.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

* Show timestamps for server diagnostic information. See :ref:`pgrst_logging`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Config options for showing a full OpenAPI output regardless of the JWT role privileges and for disabling it altogether. See :ref:`openapi-mode`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Config option for logging level. See :ref:`log-level`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Config option for enabling or disabling prepared statements. See :ref:`db-prepared-statements`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Config option for specifying how to terminate the transactions (allowing rollbacks, useful for testing). See :ref:`db-tx-end`.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Documentation improvements

  + Added the :ref:`schema_cache` page.
  + Moved the :ref:`schema_reloading` reference from :ref:`admin` to :ref:`schema_cache`

Changed
-------

* Docker images are now optimized to be built from the scratch image. This reduces the compressed image size from over 30 MB to about 4 MB.
  For more details, see `Docker image built with Nix <https://github.com/PostgREST/postgrest/tree/main/nix/tools/docker#user-content-docker-image-built-with-nix>`_.
  |br| -- `@monacoremo <https://github.com/monacoremo>`_

* The Docker image no longer has an internal ``/etc/postgrest.conf`` file, you must use :ref:`env_variables_config` to configure it.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* The ``pg_listen`` `utility <https://github.com/begriffs/pg_listen>`_ is no longer needed to automatically reload the schema cache
  and it's replaced entirely by database notifications. See :ref:`auto_schema_reloading`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* POST requests for insertions no longer include a ``Location`` header in the response by default and behave the same way as having a
  ``Prefer: return=minimal`` header in the request. This prevents permissions errors when having a write-only table. See :ref:`insert_update`.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

* Modified the default logging level from ``info`` to ``error``. See :ref:`log-level`.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Changed the error message for a not found RPC on a stale schema (see :ref:`stale_function_signature`) and for the unsupported case of
  overloaded functions with the same argument names but different types.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

* Changed the error message for the no relationship found error. See :ref:`stale_fk_relationships`.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

Fixed
-----

* Fix showing UNKNOWN on ``postgrest --help`` invocation.
  |br| -- `@monacoremo <https://github.com/monacoremo>`_

* Removed single column restriction to allow composite foreign keys in join tables.
  |br| -- `@goteguru <https://github.com/goteguru>`_

* Fix expired JWTs starting an empty transaction on the db.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Fix location header for POST request with ``select=`` without PK.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix error messages on connection failure for localized PostgreSQL on Windows.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix ``application/octet-stream`` appending ``charset=utf-8``.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Fix overloading of functions with unnamed arguments.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Return ``405 Method not Allowed`` for GET of volatile RPC instead of 500.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix RPC return type handling and embedding for domains with composite base type.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix embedding through views that have COALESCE with subselect.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix parsing of boolean config values for Docker environment variables, now it accepts double quoted truth values ``("true", "false")`` and numbers ``("1", "0")``.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix using ``app.settings.xxx`` config options in Docker, now they can be used as ``PGRST_APP_SETTINGS_xxx``.
  |br| -- `@wolfgangwalther <https://github.com/wolfgangwalther>`_

* Fix panic when attempting to run with unix socket on non-unix host and properly close unix domain socket on exit.
  |br| -- `@monacoremo <https://github.com/monacoremo>`_

* Disregard internal junction (in non-exposed schema) when embedding.
  |br| -- `@steve-chavez <https://github.com/steve-chavez>`_

* Fix requests for overloaded functions from HTML forms to no longer hang.
  |br| -- `@laurenceisla <https://github.com/laurenceisla>`_

Thanks
------

Big thanks from the `PostgREST team <https://github.com/orgs/PostgREST/people>`_ to our sponsors!

.. container:: image-container

  .. image:: ../_static/cybertec-new.png
    :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest
    :width:  13em

  .. image:: ../_static/2ndquadrant.png
    :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo
    :width:  13em

  .. image:: ../_static/retool.png
    :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest
    :width:  13em

  .. image:: ../_static/gnuhost.png
    :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest
    :width:  13em

  .. image:: ../_static/supabase.png
    :target: https://supabase.io/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage
    :width:  13em

  .. image:: ../_static/oblivious.jpg
    :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest
    :width:  13em

* Evans Fernandes
* `Jan Sommer <https://github.com/nerfpops>`_
* `Franz Gusenbauer <https://www.igutech.at/>`_
* `Daniel Babiak <https://github.com/dbabiak>`_
* Tsingson Qin
* Michel Pelletier
* Jay Hannah
* Robert Stolarz
* Nicholas DiBiase
* Christopher Reid
* Nathan Bouscal
* Daniel Rafaj
* David Fenko
* Remo Rechkemmer
* Severin Ibarluzea
* Tom Saleeba
* Pawel Tyll

If you like to join them please consider `supporting PostgREST development <https://github.com/PostgREST/postgrest#user-content-supporting-development>`_.