Skip to main content
Version: 5.0

Highlights

Deprecated networking definitions were removed from rest-hooks exports, and moved to @rest-hooks/legacy.

FlatEntity, SimpleRecord, NestedEntity, schemas, isEntity, Entity, Resource, SimpleResource, SchemaDetail, SchemaList, Method

These are still supported! They are simply moved to @rest-hooks/legacy. This allows smooth incremental migrations.

  1. yarn add @rest-hooks/legacy@2.2.0
  • has all of these, and is compatible with both rest-hooks 5 and 6.
  1. Upgrade rest-hooks & @rest-hooks/legacy to 6.
  2. Gradually migrate to @rest-hooks/rest

@rest-hooks/endpoint changes

SimpleRecord -> [Object](https://resthooks.io/docs/api/Object)

SimpleRecord was removed (though available in @rest-hooks/legacy)

export class Address extends SimpleRecord {
readonly street: string = '';
readonly suite: string = '';
readonly city: string = '';
readonly zipcode: string = '';
readonly createdAt: Date = new Date(0);

static schema = {
createdAt: Date,
};
}

@rest-hooks/rest changes from 2 -> 3

These add on to the existing changes of @rest-hooks/rest from @rest-hooks/legacy

  • If Resource.fromJS() was used to customize normalization process, use process() instead.

    • class MyResource extends Resource {
      static process(input: any, parent: any, key: string | undefined): any {
      return {
      ...input,
      extraThing: 5,
      };
      }
      }
  • New default error behavior

    • To keep existing:
      class MyResource extends Resource {
      static getEndpointExtra(): EndpointExtraOptions | undefined {
      return {
      errorPolicy: error => 'soft' as const,
      };
      }
      }

Full list of changes

@rest-hooks/endpoint

Entity

  • fromJS() -> process() to customize init
  • normalize results in POJO rather than instances
    • This is only meaningful for those inspecting the rest hooks state directly
  • FlatEntity, SimpleRecord removed (use @rest-hooks/legacy)

@rest-hooks/rest

  • peerDep @rest-hooks/endpoint > 2

@rest-hooks/core

  • buildInferredResult -> inferResults

  • Error behavior

    • useError() will no longer create synthetic errors for missing entities

    • useError() errorPolicy

      EndpointExtraOptions

      interface EndpointExtraOptions {
      //...rest
      errorPolicy?: (error: any) => 'soft' | undefined;
      }

      'soft' vs undefined

      • 'soft' avoids errors if existing results are still available (even if stale)
      • undefined (hard error) means any error always falls

      @rest-hooks/rest

      New default policy: 5xx are soft, else hard.

      @rest-hooks/rest is where errors have 'status' members. This concept does not exist in base Endpoints.

        static getEndpointExtra(): EndpointExtraOptions | undefined {
      return;
      return {
      errorPolicy: error =>
      error.status >= 500 ? ('soft' as const) : undefined,
      };
      }

      PollingSubscription

                // never break when data already exists
      errorPolicy: () => 'soft' as const,

      @rest-hooks/legacy - Resource

      Existing policy was to always be 'soft' no matter what. This maintains that behavior.

        /** @deprecated */
      /** Get the request options for this SimpleResource */
      static getFetchOptions(): FetchOptions | undefined {
      return {
      errorPolicy: () => 'soft' as const,
      };
      }

      https://github.com/data-client/rest-hooks/pull/971

    • polled fetch errors are always 'soft'

    • @rest-hooks/rest

      • 5xx: 'soft'
      • 4xx, 3xx, etc: 'hard'
  • peerDep @rest-hooks/endpoint > 2

rest-hooks

Removed exports from 'rest-hooks': NestedEntity, schemas, isEntity, Entity, Resource, SimpleResource, SchemaDetail, SchemaList, Method

  • use @rest-hooks/legacy, or @rest-hooks/rest instead

@rest-hooks/legacy

  • peerDep @rest-hooks/endpoint > 2

Full Release notes