@warp-drive-mirror/utilities 5.8.0-alpha.37 → 5.8.0-alpha.40

package/dist/unpkg/dev/declarations/-private/handlers/meta-doc.d.ts

@@ -1,47 +0,0 @@
-import type { Handler } from "@warp-drive-mirror/core/request";
-/**
-* MetaDocHandler processes requests that are marked as meta requests.
-*
-* It treats the response body as "entirely meta" transforming
-*
-* ```ts
-* {
-*   some: "key",
-*   another: "thing"
-* }
-* ```
-*
-* into
-*
-* ```ts
-* {
-* 	 meta: {
-*     some: "key",
-*     another: "thing"
-*   }
-* }
-* ```
-*
-* To activate this handler, a request should specify
-*
-* ```ts
-* options.isMetaRequest = true
-* ```
-*
-* For instance
-*
-* ```ts
-* store.request({
-*   url: '/example',
-*   options: {
-*     isMetaRequest: true
-*   }
-* });
-* ```
-*
-* Errors are not processed by this handler, so if the request fails and the error response
-* is not in {json:api} format additional processing may be needed.
-*
-* @group Handlers
-*/
-export declare const MetaDocHandler: Handler;

package/dist/unpkg/dev/declarations/-private/handlers/utils.d.ts

@@ -1,41 +0,0 @@
-/**
-* A unique identifier for the current browser tab
-* useful for observability/tracing and deduping
-* across multiple tabs.
-*
-* @group Constants
-*/
-export declare const TAB_ID: string;
-/**
-* The epoch seconds at which the tab id was generated
-*
-* @group Constants
-*/
-export declare const TAB_ASSIGNED: number;
-/**
-* Adds the `X-Amzn-Trace-Id` header to support observability
-* tooling around request routing.
-*
-* This makes use of the {@link TAB_ID} and {@link TAB_ASSIGNED}
-* to enable tracking the browser tab of origin across multiple requests.
-*
-* Follows the template: `Root=1-${now}-${uuidv4};TabId=1-${epochSeconds}-${tab-uuid}`
-*
-* @group Utility Functions
-*/
-export declare function addTraceHeader(headers: Headers): Headers;
-/**
-* Source: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html
-* As of 2024-12-05 the maximum URL length is 8192 bytes.
-*
-* @group Constants
-*/
-export declare const MAX_URL_LENGTH = 8192;
-/**
-* This assertion takes a URL and throws an error if the URL is longer than the maximum URL length.
-*
-* See also {@link MAX_URL_LENGTH}
-*
-* @group Utility Functions
-*/
-export declare function assertInvalidUrlLength(url: string | undefined): void;

package/dist/unpkg/dev/declarations/-private/json-api/-utils.d.ts

@@ -1,109 +0,0 @@
-import type { QueryParamsSource } from "@warp-drive-mirror/core/types/params";
-import type { BuildURLConfig } from "../../index.js";
-export interface JSONAPIConfig extends BuildURLConfig {
-	profiles?: {
-		pagination?: string;
-		[key: string]: string | undefined;
-	};
-	extensions?: {
-		atomic?: string;
-		[key: string]: string | undefined;
-	};
-}
-export declare let CONFIG: JSONAPIConfig;
-export declare let ACCEPT_HEADER_VALUE: string;
-/**
-* Allows setting extensions and profiles to be used in the `Accept` header.
-*
-* Extensions and profiles are keyed by their namespace with the value being
-* their URI.
-*
-* Example:
-*
-* ```ts
-* setBuildURLConfig({
-*   extensions: {
-*     atomic: 'https://jsonapi.org/ext/atomic'
-*   },
-*   profiles: {
-*     pagination: 'https://jsonapi.org/profiles/ethanresnick/cursor-pagination'
-*   }
-* });
-* ```
-*
-* This also sets the global configuration for `buildBaseURL`
-* for host and namespace values for the global coniguration
-* done via `import { setBuildURLConfig } from '@warp-drive-mirror/utilities';`
-*
-* These values may still be overridden by passing
-* them to buildBaseURL directly.
-*
-* This method may be called as many times as needed
-*
-* ```ts
-* type BuildURLConfig = {
-*   host: string;
-*   namespace: string'
-* }
-* ```
-*
-* @public
-* @param {BuildURLConfig} config
-* @return {void}
-*/
-export declare function setBuildURLConfig(config: JSONAPIConfig): void;
-interface RelatedObject {
-	[key: string]: string | string[] | RelatedObject;
-}
-export type JsonApiQuery = {
-	include?: string | string[] | RelatedObject;
-	fields?: Record<string, string | string[]>;
-	page?: {
-		size?: number;
-		after?: string;
-		before?: string;
-	};
-};
-/**
-* Sorts query params by both key and value, returning a query params string
-*
-* Treats `included` specially, splicing it into an array if it is a string and sorting the array.
-*   - If `included` is an object we build paths dynamically for you
-* Treats `fields` specially, building JSON:API partial fields params from an object
-* Treats `page` specially, building cursor-pagination profile page params from an object
-*
-* ```ts
-* const params = buildQueryParams({
-*  include: {
-*    company: {
-*      locations: 'address'
-*    }
-*  },
-*   fields: {
-*     company: ['name', 'ticker'],
-*     person: 'name'
-*   },
-*   page: {
-*     size: 10,
-*     after: 'abc',
-*   }
-* });
-*
-* // => 'fields[company]=name,ticker&fields[person]=name&include=company.locations,company.locations.address&page[after]=abc&page[size]=10'
-* ```
-*
-* Options:
-* - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
-*
-* 'bracket': appends [] to the key for every value e.g. `ids[]=1&ids[]=2`
-* 'indices': appends [i] to the key for every value e.g. `ids[0]=1&ids[1]=2`
-* 'repeat': appends the key for every value e.g. `ids=1&ids=2`
-* 'comma' (default): appends the key once with a comma separated list of values e.g. `ids=1,2`
-*
-* @public
-* @param {URLSearchParams | Object} params
-* @param {Object} [options]
-* @return {String} A sorted query params string without the leading `?`
-*/
-export declare function buildQueryParams(query: JsonApiQuery | QueryParamsSource): string;
-export {};

package/dist/unpkg/dev/declarations/-private/json-api/find-record.d.ts

@@ -1,84 +0,0 @@
-import type { ReactiveDataDocument } from "@warp-drive-mirror/core/reactive";
-import type { TypeFromInstance } from "@warp-drive-mirror/core/types/record";
-import type { FindRecordOptions, FindRecordRequestOptions, RemotelyAccessibleIdentifier } from "@warp-drive-mirror/core/types/request";
-/**
-* Builds request options to fetch a single resource by a known id or identifier
-* configured for the url and header expectations of most JSON:API APIs.
-*
-* :::tabs
-*
-* == Basic Usage
-*
-* ```ts
-* import { findRecord } from '@warp-drive-mirror/utilities/json-api';
-* import type { Person } from '#/data/types';
-*
-* const result = await store.request(
-*   findRecord<Person>('person', '1')
-* );
-* ```
-*
-* == With Options
-*
-* ```ts
-* import { findRecord } from '@warp-drive-mirror/utilities/json-api';
-* import type { Person } from '#/data/types';
-*
-* const data = await store.request(
-*   findRecord<Person>(
-*     'person', '1',
-*     { include: ['pets', 'friends'] }
-*   )
-* );
-* ```
-*
-* == With an Identifier
-*
-* ```ts
-* import { findRecord } from '@warp-drive-mirror/utilities/json-api';
-* import type { Person } from '#/data/types';
-*
-* const data = await store.request(
-*   findRecord<Person>(
-*     { type: 'person', id: '1' },
-*     { include: ['pets', 'friends'] }
-*   )
-* );
-* ```
-*
-* :::
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { findRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const data = await store.request(
-*   findRecord(
-*     'person', '1',
-*     { include: ['pets', 'friends'] },
-*     { namespace: 'api/v2' }
-*   )
-* );
-* ```
-*
-* @public
-*/
-export declare function findRecord<T>(identifier: RemotelyAccessibleIdentifier<TypeFromInstance<T>>, options?: FindRecordOptions): FindRecordRequestOptions<ReactiveDataDocument<T>, T>;
-export declare function findRecord(identifier: RemotelyAccessibleIdentifier, options?: FindRecordOptions): FindRecordRequestOptions;
-export declare function findRecord<T>(type: TypeFromInstance<T>, id: string, options?: FindRecordOptions): FindRecordRequestOptions<ReactiveDataDocument<T>, T>;
-export declare function findRecord(type: string, id: string, options?: FindRecordOptions): FindRecordRequestOptions;
-/** @deprecated use {@link ReactiveDataDocument} */
-export type FindRecordResultDocument<T> = ReactiveDataDocument<T>;

package/dist/unpkg/dev/declarations/-private/json-api/query.d.ts

@@ -1,100 +0,0 @@
-import type { ReactiveDataDocument } from "@warp-drive-mirror/core/reactive";
-import type { QueryParamsSource } from "@warp-drive-mirror/core/types/params";
-import type { TypedRecordInstance, TypeFromInstance } from "@warp-drive-mirror/core/types/record";
-import type { ConstrainedRequestOptions, PostQueryRequestOptions, QueryRequestOptions } from "@warp-drive-mirror/core/types/request";
-/**
-* Builds request options to query for resources, usually by a primary
-* type, configured for the url and header expectations of most JSON:API APIs.
-*
-* The key difference between this and `postQuery` is that this method will send the query
-* as query params in the url of a "GET" request instead of as the JSON body of a "POST"
-* request.
-*
-* **Basic Usage**
-*
-* ```ts
-* import { query } from '@warp-drive-mirror/utilities/json-api';
-*
-* const data = await store.request(query('person'));
-* ```
-*
-* **With Query Params**
-*
-* ```ts
-* import { query } from '@warp-drive-mirror/utilities/json-api';
-*
-* const options = query('person', { include: ['pets', 'friends'] });
-* const data = await store.request(options);
-* ```
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { query } from '@warp-drive-mirror/utilities/json-api';
-*
-* const options = query('person', { include: ['pets', 'friends'] }, { reload: true });
-* const data = await store.request(options);
-* ```
-*
-* @public
-*/
-export declare function query<T extends TypedRecordInstance>(type: TypeFromInstance<T>, query?: QueryParamsSource, options?: ConstrainedRequestOptions): QueryRequestOptions<ReactiveDataDocument<T[]>>;
-export declare function query(type: string, query?: QueryParamsSource, options?: ConstrainedRequestOptions): QueryRequestOptions;
-/**
-* Builds request options to query for resources, usually by a primary
-* type, configured for the url and header expectations of most JSON:API APIs.
-*
-* The key difference between this and `query` is that this method will send the query
-* as the JSON body of a "POST" request instead of as query params in the url of a "GET"
-* request.
-*
-* A CacheKey is generated from the url and query params, and used to cache the response
-* in the store.
-*
-* ```ts
-* import { postQuery } from '@warp-drive-mirror/utilities/json-api';
-*
-* const options = postQuery('person', { include: ['pets', 'friends'] });
-* const data = await store.request(options);
-* ```
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { postQuery } from '@warp-drive-mirror/utilities/json-api';
-*
-* const options = postQuery('person', { include: ['pets', 'friends'] }, { reload: true });
-* const data = await store.request(options);
-* ```
-*
-* @public
-* @param identifier
-* @param query
-* @param options
-*/
-export declare function postQuery<T>(type: TypeFromInstance<T>, query?: QueryParamsSource, options?: ConstrainedRequestOptions): PostQueryRequestOptions<ReactiveDataDocument<T[]>>;
-export declare function postQuery(type: string, query?: QueryParamsSource, options?: ConstrainedRequestOptions): PostQueryRequestOptions;

package/dist/unpkg/dev/declarations/-private/json-api/save-record.d.ts

@@ -1,228 +0,0 @@
-import type { ReactiveDataDocument } from "@warp-drive-mirror/core/reactive.js";
-import type { TypedRecordInstance } from "@warp-drive-mirror/core/types/record";
-import type { ConstrainedRequestOptions, CreateRequestOptions, DeleteRequestOptions, UpdateRequestOptions } from "@warp-drive-mirror/core/types/request";
-/**
-* :::warning ⚠️ **These Mutation Builders DO NOT Set The Request Body**
-* While this may come as a surprise, the app providing the body ensures that only
-* desired and correctly formatted data is sent with the request.
-* :::
-*
-* Builds request options to delete record for resources,
-* configured for the url, method and header expectations of most JSON:API APIs.
-*
-* **Basic Usage**
-*
-* ```ts
-* import { deleteRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const person = store.peekRecord('person', '1');
-*
-* // mark record as deleted
-* store.deleteRecord(person);
-*
-* // persist deletion
-* const data = await store.request(deleteRecord(person));
-* ```
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { deleteRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const person = store.peekRecord('person', '1');
-*
-* // mark record as deleted
-* store.deleteRecord(person);
-*
-* // persist deletion
-* const options = deleteRecord(person, { namespace: 'api/v1' });
-* const data = await store.request(options);
-* ```
-*
-* @public
-* @param record
-* @param options
-*/
-export declare function deleteRecord<T>(record: T, options?: ConstrainedRequestOptions): DeleteRequestOptions<T>;
-export declare function deleteRecord(record: unknown, options?: ConstrainedRequestOptions): DeleteRequestOptions;
-/**
-* :::warning ⚠️ **These Mutation Builders DO NOT Set The Necessary Request Body**
-* While this may come as a surprise, the app providing the body ensures that only
-* desired and correctly formatted data is sent with the request.
-* :::
-*
-* Builds request options to create new record for resources,
-* configured for the url, method and header expectations of most JSON:API APIs.
-*
-* **Basic Usage**
-*
-* ```ts
-* import { cacheKeyFor } from '@warp-drive-mirror/core';
-* import { createRecord } from '@warp-drive-mirror/utilities/json-api';
-* import type { Person } from '#/data/types';
-*
-* const person = store.createRecord<Person>('person', { name: 'Ted' });
-* const init = createRecord(person);
-* init.body = JSON.stringify(
-*  {
-*    // it's likely you will want to transform this data
-*    // somewhat
-*    data: store.cache.peek(cacheKeyFor(person))
-*  }
-* );
-* const data = await store.request(init);
-* ```
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { createRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const person = store.createRecord('person', { name: 'Ted' });
-* const options = createRecord(person, { namespace: 'api/v1' });
-* const data = await store.request(options);
-* ```
-*
-* @public
-* @param record
-* @param options
-*/
-export declare function createRecord<T>(record: T, options?: ConstrainedRequestOptions): CreateRequestOptions<T>;
-export declare function createRecord(record: unknown, options?: ConstrainedRequestOptions): CreateRequestOptions;
-/**
-* :::warning ⚠️ **These Mutation Builders DO NOT Set The Necessary Request Body**
-* While this may come as a surprise, the app providing the body ensures that only
-* desired and correctly formatted data is sent with the request.
-* :::
-*
-* Builds request options to update existing record for resources,
-* configured for the url, method and header expectations of most JSON:API APIs.
-*
-* **Example Usage**
-*
-* ```ts
-* import { cacheKeyFor } from '@warp-drive-mirror/core';
-* import { updateRecord } from '@warp-drive-mirror/utilities/json-api';
-* import type { EditablePerson } from '#/data/types';
-*
-* const mutable = await checkout<EditablePerson>(person);
-* mutable.name = 'Chris';
-* const init = updateRecord(mutable);
-*
-* init.body = JSON.stringify(
-*  // it's likely you will want to transform this data
-*  // somewhat, or serialize only specific properties instead
-*  serializePatch(store.cache, cacheKeyFor(mutable))
-* );
-* const data = await store.request(init);
-* ```
-*
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `patch` - Allows caller to specify whether to use a PATCH request instead of a PUT request, defaults to `false`.
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { updateRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const person = store.peekRecord('person', '1');
-* person.name = 'Chris';
-* const options = updateRecord(person, { patch: true });
-* const data = await store.request(options);
-* ```
-*
-* @public
-* @param record
-* @param options
-*/
-export declare function updateRecord<
-	T extends TypedRecordInstance,
-	RT extends TypedRecordInstance = T
->(record: T, options?: ConstrainedRequestOptions & {
-	patch?: boolean;
-}): UpdateRequestOptions<ReactiveDataDocument<RT>, T>;
-export declare function updateRecord(record: unknown, options?: ConstrainedRequestOptions & {
-	patch?: boolean;
-}): UpdateRequestOptions;
-/**
-* Builds request options to update existing record for resources,
-* configured for the url and header expectations of most JSON:API APIs
-* for a PATCH request.
-*
-* Note: This is a convenience method that calls `updateRecord` with the
-* supplied request with the `patch` option set to `true`.
-*
-* **Basic Usage**
-*
-* ```ts
-* import { patchRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const person = store.peekRecord('person', '1');
-* person.name = 'Chris';
-* const data = await store.request(patchRecord(person));
-* ```
-*
-* **Supplying Options to Modify the Request Behavior**
-*
-* The following options are supported:
-*
-* - `host` - The host to use for the request, defaults to the `host` configured with `setBuildURLConfig`.
-* - `namespace` - The namespace to use for the request, defaults to the `namespace` configured with `setBuildURLConfig`.
-* - `resourcePath` - The resource path to use for the request, defaults to pluralizing the supplied type
-* - `reload` - Whether to forcibly reload the request if it is already in the store, not supplying this
-*      option will delegate to the store's CachePolicy, defaulting to `false` if none is configured.
-* - `backgroundReload` - Whether to reload the request if it is already in the store, but to also resolve the
-*      promise with the cached value, not supplying this option will delegate to the store's CachePolicy,
-*      defaulting to `false` if none is configured.
-* - `urlParamsSetting` - an object containing options for how to serialize the query params (see `buildQueryParams`)
-*
-* ```ts
-* import { patchRecord } from '@warp-drive-mirror/utilities/json-api';
-*
-* const person = store.peekRecord('person', '1');
-* person.name = 'Chris';
-* const options = patchRecord(person);
-* const data = await store.request(options);
-* ```
-*
-* @public
-* @param record
-* @param options
-*/
-export declare function patchRecord<T>(record: T, options?: ConstrainedRequestOptions): UpdateRequestOptions<T>;
-export declare function patchRecord(record: unknown, options?: ConstrainedRequestOptions): UpdateRequestOptions;

package/dist/unpkg/dev/declarations/-private/json-api/serialize.d.ts

@@ -1,70 +0,0 @@
-import type { Cache } from "@warp-drive-mirror/core/types/cache";
-import type { ResourceKey } from "@warp-drive-mirror/core/types/identifier";
-import type { Value } from "@warp-drive-mirror/core/types/json/raw";
-import type { InnerRelationshipDocument, ResourceObject } from "@warp-drive-mirror/core/types/spec/json-api-raw";
-type ChangedRelationshipData = InnerRelationshipDocument;
-export type JsonApiResourcePatch = {
-	type: string;
-	id: string;
-	attributes?: Record<string, Value>;
-	relationships?: Record<string, ChangedRelationshipData>;
-} | {
-	type: string;
-	id: null;
-	lid: string;
-	attributes?: Record<string, Value>;
-	relationships?: Record<string, ChangedRelationshipData>;
-};
-/**
-* :::warning ⚠️ **This util often won't produce the necessary body for a {json:api} request**
-*
-* While this may come as a surprise, they are intended to serialize cache state for more
-* generalized usage. {json:api} has a large variance in acceptable shapes, and only your
-* app can ensure that the body is correctly formatted and contains all necessary data.
-* :::
-*
-* Serializes the current state of a resource or array of resources for use with POST or PUT requests.
-*
-* @public
-* @param {Cache} cache}
-* @param {ResourceKey} identifier
-* @return {Object} An object with a `data` property containing the serialized resource patch
-*/
-export declare function serializeResources(cache: Cache, identifiers: ResourceKey): {
-	data: ResourceObject;
-};
-export declare function serializeResources(cache: Cache, identifiers: ResourceKey[]): {
-	data: ResourceObject[];
-};
-/**
-* :::warning ⚠️ **This util often won't produce the necessary body for a {json:api} request**
-*
-* While this may come as a surprise, they are intended to serialize cache state for more
-* generalized usage. {json:api} has a large variance in acceptable shapes, and only your
-* app can ensure that the body is correctly formatted and contains all necessary data.
-* :::
-*
-* Serializes changes to a resource. Useful for use with building bodies for PATCH requests.
-*
-* Only attributes which are changed are serialized.
-* Only relationships which are changed are serialized.
-*
-* Collection relationships serialize the collection as a whole.
-*
-* If you would like to serialize updates to a collection more granularly
-* (for instance, as operations) request the diff from the store and
-* serialize as desired:
-*
-* ```ts
-* const relationshipDiffMap = cache.changedRelationships(identifier);
-* ```
-*
-* @public
-* @param {Cache} cache}
-* @param {ResourceKey} identifier
-* @return {Object} An object with a `data` property containing the serialized resource patch
-*/
-export declare function serializePatch(cache: Cache, identifier: ResourceKey): {
-	data: JsonApiResourcePatch;
-};
-export {};