@warp-drive/legacy 5.9.0-beta.0 → 5.9.0-beta.2

package/dist/unpkg/dev/index.js

@@ -1,197 +1,277 @@
-import { Store, RequestManager, Fetch, CacheHandler, recordIdentifierFor } from '@warp-drive/core';
-import { SchemaService, registerDerivations, instantiateRecord as instantiateRecord$1, teardownRecord as teardownRecord$1 } from '@warp-drive/core/reactive';
-import { DefaultCachePolicy } from '@warp-drive/core/store';
-import { LegacyNetworkHandler, adapterFor, serializerFor, pushPayload, normalize, serializeRecord, cleanup } from './compat.js';
-import { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension } from './compat/extensions.js';
-import '@ember/object';
-import '@warp-drive/core/types/symbols';
-import '@warp-drive/utilities/string';
-import '@warp-drive/core/store/-private';
-import "./errors-DmGGJr3T.js";
-import "./schema-provider-DDVYxmUV.js";
-import { i as instantiateRecord, t as teardownRecord, m as modelFor } from "./hooks-CkYiE6Ud.js";
-import '@ember/application';
-import { registerDerivations as registerDerivations$1, DelegatingSchemaService } from './model/migration-support.js';
-import { F as FragmentExtension, a as FragmentArrayExtension, f as fragmentsModelFor } from "./model-for-CqXsIKws.js";
-import { restoreDeprecatedStoreBehaviors } from './store.js';
+import { a as serializeRecord, i as pushPayload, n as cleanup, o as serializerFor, r as normalize, s as LegacyNetworkHandler, t as adapterFor } from "./compat-D48B8sXv.js";
+import { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension } from "./compat/extensions.js";
+import { n as modelFor, r as teardownRecord$1, t as instantiateRecord$1 } from "./model-LK7ethC5.js";
+import { a as FragmentExtension, s as FragmentArrayExtension, t as fragmentsModelFor } from "./model-fragments-DSqu0ptR.js";
+import { DelegatingSchemaService, registerDerivations as registerDerivations$1 } from "./model/migration-support.js";
+import { t as restoreDeprecatedStoreBehaviors } from "./store-D_V8-HQl.js";
+import { CacheHandler, Fetch, RequestManager, Store, recordIdentifierFor } from "@warp-drive/core";
+import { SchemaService, instantiateRecord, registerDerivations, teardownRecord } from "@warp-drive/core/reactive";
+import { DefaultCachePolicy } from "@warp-drive/core/store";
 
+//#region src/index.ts
 /**
- * @module
- * @mergeModuleWith <project>
- */
-
-//export type ConfiguredStore<T = unknown> = typeof Store;
-
+* @module
+* @mergeModuleWith <project>
+*/
 /**
- * Use the legacy store with the given options.
- */
-
+* Setup options for a legacy store configured to use `Model` with `linksMode`
+* enabled, meaning no legacy adapter/serializer request infrastructure is required.
+*
+* @public
+*/
+/**
+* Setup options for a legacy store configured to use `Model` along with the
+* legacy adapter/serializer network layer, but without the deprecated
+* `store.findRecord`/`findAll`/`query`/etc. request methods.
+*
+* @public
+*/
+/**
+* Setup options for a legacy store configured to use `Model` along with the
+* legacy adapter/serializer network layer and the deprecated
+* `store.findRecord`/`findAll`/`query`/etc. request methods.
+*
+* @public
+*/
+/**
+* The available options when setting up the legacy store,
+* one of:
+*
+* - {@link LegacyModelStoreSetupOptions}
+* - {@link LegacyModelAndNetworkStoreSetupOptions}
+* - {@link LegacyModelAndNetworkAndRequestStoreSetupOptions}
+*/
+/**
+* Use the legacy store with the given options.
+*
+* See {@link LegacyStoreSetupOptions} for details on the available options.
+*
+* ```ts
+* import { useLegacyStore } from '@warp-drive/legacy';
+* import { JSONAPICache } from '@warp-drive/json-api';
+*
+* export default useLegacyStore({
+*   linksMode: false,
+*   legacyRequests: true,
+*   cache: JSONAPICache,
+*   schemas: [],
+* });
+* ```
+*
+* ### Adding Stateful Handlers
+*
+* A request {@link Handler} is sometimes more than a plain object or class
+* with a `request` method — it may need access to a stateful dependency such
+* as an Ember service (an auth token, a feature-flags service, an i18n
+* helper, etc.).
+*
+* A plain class handler that only relies on Ember's `@service` decorator will
+* not work here on its own: the handler is never instantiated *through*
+* Ember's container (it's just `new`'d up), so it has no owner and its
+* `@service` injections would fail to resolve.
+*
+* Instead, give `handlers` a function. It receives the {@link Store} instance
+* being configured, which by the time the function runs already has an owner
+* assigned. Use `getOwner`/`setOwner` from `@ember/owner` to transfer that
+* owner onto your handler instance before returning it, exactly as you would
+* when constructing any other DI-aware object outside of the container:
+*
+* ```ts
+* import { getOwner, setOwner } from '@ember/owner';
+* import { service } from '@ember/service';
+* import { useLegacyStore } from '@warp-drive/legacy';
+* import type { NextFn } from '@warp-drive/core/request';
+* import type { RequestContext } from '@warp-drive/core/types/request';
+* import { JSONAPICache } from '@warp-drive/json-api';
+*
+* class AuthHandler {
+*   @service session;
+*
+*   request<T>(context: RequestContext, next: NextFn<T>) {
+*     const headers = new Headers(context.request.headers);
+*     headers.append('Authorization', `Bearer ${this.session.accessToken}`);
+*     return next(Object.assign({}, context.request, { headers }));
+*   }
+* }
+*
+* export default useLegacyStore({
+*   linksMode: false,
+*   legacyRequests: true,
+*   cache: JSONAPICache,
+*   handlers: (store) => {
+*     const authHandler = new AuthHandler();
+*     setOwner(authHandler, getOwner(store)!);
+*     return [authHandler];
+*   },
+* });
+* ```
+*
+* The `handlers` function is invoked lazily and only once per store instance,
+* the first time `store.requestManager` is accessed, so it is safe to do
+* owner-dependent setup like this inside of it.
+*
+* ### Accessing the Store from a Handler's Context
+*
+* If a handler only needs to read something *off of the store itself*
+* (its cache, or a property/service you've attached to a custom store
+* subclass) rather than an unrelated Ember service, there is a second,
+* simpler option that requires no DI/`setOwner` wiring at all.
+*
+* Every request issued via {@link Store.request | store.request(...)}
+* automatically carries the originating store along as
+* {@link RequestInfo.store | context.request.store}. Any handler — a plain
+* object, a function-built handler, or a class — can read it directly,
+* without needing the `handlers` callback form shown above:
+*
+* ```ts
+* import { useLegacyStore } from '@warp-drive/legacy';
+* import type { NextFn } from '@warp-drive/core/request';
+* import type { RequestContext } from '@warp-drive/core/types/request';
+* import { JSONAPICache } from '@warp-drive/json-api';
+*
+* const LoggingHandler = {
+*   request<T>(context: RequestContext, next: NextFn<T>) {
+*     // only present when the request was made via `store.request(...)`
+*     const store = context.request.store;
+*     if (store) {
+*       console.log(`[${store.constructor.name}] ${context.request.url ?? ''}`);
+*     }
+*     return next(context.request);
+*   },
+* };
+*
+* export default useLegacyStore({
+*   linksMode: false,
+*   legacyRequests: true,
+*   cache: JSONAPICache,
+*   handlers: [LoggingHandler],
+* });
+* ```
+*
+* The trade-off versus the `getOwner`/`setOwner` pattern above is that
+* `context.request.store` is only populated for requests issued via
+* `store.request(...)`; a request made directly against a
+* {@link RequestManager} won't have it set unless the caller supplies it
+* explicitly, so a handler relying on it should treat it as optional (as
+* `LoggingHandler` does above).
+*/
 function useLegacyStore(options, StoreKlass = Store) {
-  (test => {
-    if (!test) {
-      throw new Error(`If legacyRequests is true, linksMode must be false`);
-    }
-  })(!(options.linksMode && options.legacyRequests));
-  // we extend the store to ensure we don't leak our prototype overrides to other stores below.
-  class BaseKlass extends StoreKlass {}
-  class LegacyConfiguredStore extends BaseKlass {
-    requestManager = new RequestManager().use([options.linksMode ? null : LegacyNetworkHandler, ...(options.handlers ?? []), Fetch].filter(Boolean)).useCache(CacheHandler);
-    lifetimes = options.policy ?? new DefaultCachePolicy({
-      apiCacheHardExpires: 15 * 60 * 1000,
-      // 15 minutes
-      apiCacheSoftExpires: 1 * 30 * 1000,
-      // 30 seconds
-      constraints: {
-        headers: {
-          'X-WarpDrive-Expires': true,
-          'Cache-Control': true,
-          Expires: true
-        }
-      }
-    });
-    createSchemaService() {
-      // prepare for PolarisMode
-      const schema = new SchemaService();
-      registerDerivations(schema);
-      if (options.schemas) schema.registerResources(options.schemas);
-      if (options.traits) {
-        for (const trait of options.traits) {
-          schema.registerTrait(trait);
-        }
-      }
-      if (options.derivations) {
-        for (const derivation of options.derivations) {
-          schema.registerDerivation(derivation);
-        }
-      }
-      if (options.transformations) {
-        for (const transformation of options.transformations) {
-          schema.registerTransformation(transformation);
-        }
-      }
-      if (options.hashFns) {
-        for (const hashFn of options.hashFns) {
-          schema.registerHashFn(hashFn);
-        }
-      }
-      if (options.CAUTION_MEGA_DANGER_ZONE_extensions) {
-        for (const extension of options.CAUTION_MEGA_DANGER_ZONE_extensions) {
-          schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(extension);
-        }
-      }
-
-      // Add support for LegacyMode ReactiveResource with Maximal coverage
-      // for upgrading from 4.x
-      registerDerivations$1(schema);
-      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberArrayLikeExtension);
-      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectArrayExtension);
-      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectExtension);
-
-      // add support for fragments
-      if (options.modelFragments) {
-        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentExtension);
-        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentArrayExtension);
-      }
-
-      // Add fallback for Models
-      return new DelegatingSchemaService(this, schema);
-    }
-    createCache(capabilities) {
-      // eslint-disable-next-line new-cap
-      return new options.cache(capabilities);
-    }
-    instantiateRecord(key, createArgs) {
-      if (this.schema.isDelegated(key)) {
-        return instantiateRecord.call(this, key, createArgs);
-      }
-      return instantiateRecord$1(this, key, createArgs);
-    }
-    teardownRecord(record) {
-      const key = recordIdentifierFor(record);
-      if (this.schema.isDelegated(key)) {
-        return teardownRecord.call(this, record);
-      }
-      return teardownRecord$1(record);
-    }
-    modelFor(type) {
-      assertType(this.schema, type);
-      // TODO I'm not sure this is right
-      (test => {
-        if (!test) {
-          throw new Error(`modelFor should only be used to lookup legacy models when in linksMode: false`);
-        }
-      })(!options.linksMode || !this.schema.isDelegated({
-        type
-      }));
-      const klass =
-      // prefer real models if present
-      modelFor.call(this, type) || (
-      // fallback to ShimModelClass specific to fragments if fragments support in use
-      options.modelFragments ? fragmentsModelFor.call(this, type) : false) ||
-      // fallback to ShimModelClass
-      super.modelFor(type);
-      return klass;
-    }
-    adapterFor(modelName, _allowMissing) {
-      (test => {
-        if (!test) {
-          throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
-        }
-      })(!options.linksMode);
-      // @ts-expect-error
-      return adapterFor.call(this, modelName, _allowMissing);
-    }
-    serializerFor(...args) {
-      (test => {
-        if (!test) {
-          throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
-        }
-      })(!options.linksMode);
-      return serializerFor.call(this, ...args);
-    }
-    pushPayload(...args) {
-      (test => {
-        if (!test) {
-          throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
-        }
-      })(!options.linksMode);
-      return pushPayload.call(this, ...args);
-    }
-    normalize(...args) {
-      (test => {
-        if (!test) {
-          throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
-        }
-      })(!options.linksMode);
-      return normalize.call(this, ...args);
-    }
-    serializeRecord(...args) {
-      (test => {
-        if (!test) {
-          throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
-        }
-      })(!options.linksMode);
-      return serializeRecord.call(this, ...args);
-    }
-    destroy() {
-      if (!options.linksMode) {
-        cleanup.call(this);
-      }
-      super.destroy();
-    }
-  }
-  if (options.legacyRequests) {
-    restoreDeprecatedStoreBehaviors(BaseKlass);
-  }
-  return LegacyConfiguredStore;
+	((test) => {
+		if (!test) throw new Error(`If legacyRequests is true, linksMode must be false`);
+	})(!(options.linksMode && options.legacyRequests));
+	class BaseKlass extends StoreKlass {}
+	class LegacyConfiguredStore extends BaseKlass {
+		constructor(createArgs) {
+			super(createArgs);
+			let requestManager;
+			Object.defineProperty(this, "requestManager", {
+				configurable: true,
+				enumerable: true,
+				get: () => {
+					if (!requestManager) {
+						const handlersOption = options.handlers;
+						const handlers = typeof handlersOption === "function" ? handlersOption(this) : handlersOption ?? [];
+						requestManager = new RequestManager().use([
+							options.linksMode ? null : LegacyNetworkHandler,
+							...handlers,
+							Fetch
+						].filter(Boolean)).useCache(CacheHandler);
+					}
+					return requestManager;
+				},
+				set: (value) => {
+					requestManager = value;
+				}
+			});
+		}
+		lifetimes = options.policy ?? new DefaultCachePolicy({
+			apiCacheHardExpires: 9e5,
+			apiCacheSoftExpires: 3e4,
+			constraints: { headers: {
+				"X-WarpDrive-Expires": true,
+				"Cache-Control": true,
+				Expires: true
+			} }
+		});
+		createSchemaService() {
+			const schema = new SchemaService();
+			registerDerivations(schema);
+			if (options.schemas) schema.registerResources(options.schemas);
+			if (options.traits) for (const trait of options.traits) schema.registerTrait(trait);
+			if (options.derivations) for (const derivation of options.derivations) schema.registerDerivation(derivation);
+			if (options.transformations) for (const transformation of options.transformations) schema.registerTransformation(transformation);
+			if (options.hashFns) for (const hashFn of options.hashFns) schema.registerHashFn(hashFn);
+			if (options.CAUTION_MEGA_DANGER_ZONE_extensions) for (const extension of options.CAUTION_MEGA_DANGER_ZONE_extensions) schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(extension);
+			registerDerivations$1(schema);
+			schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberArrayLikeExtension);
+			schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectArrayExtension);
+			schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectExtension);
+			if (options.modelFragments) {
+				schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentExtension);
+				schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentArrayExtension);
+			}
+			return new DelegatingSchemaService(this, schema);
+		}
+		createCache(capabilities) {
+			return new options.cache(capabilities);
+		}
+		instantiateRecord(key, createArgs) {
+			if (this.schema.isDelegated(key)) return instantiateRecord$1.call(this, key, createArgs);
+			return instantiateRecord(this, key, createArgs);
+		}
+		teardownRecord(record) {
+			const key = recordIdentifierFor(record);
+			if (this.schema.isDelegated(key)) return teardownRecord$1.call(this, record);
+			return teardownRecord(record);
+		}
+		modelFor(type) {
+			assertType(this.schema, type);
+			return modelFor.call(this, type) || (options.modelFragments ? fragmentsModelFor.call(this, type) : false) || super.modelFor(type);
+		}
+		adapterFor(modelName, _allowMissing) {
+			((test) => {
+				if (!test) throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
+			})(!options.linksMode);
+			return adapterFor.call(this, modelName, _allowMissing);
+		}
+		serializerFor(...args) {
+			((test) => {
+				if (!test) throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
+			})(!options.linksMode);
+			return serializerFor.call(this, ...args);
+		}
+		pushPayload(...args) {
+			((test) => {
+				if (!test) throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
+			})(!options.linksMode);
+			return pushPayload.call(this, ...args);
+		}
+		normalize(...args) {
+			((test) => {
+				if (!test) throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
+			})(!options.linksMode);
+			return normalize.call(this, ...args);
+		}
+		serializeRecord(...args) {
+			((test) => {
+				if (!test) throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
+			})(!options.linksMode);
+			return serializeRecord.call(this, ...args);
+		}
+		destroy() {
+			if (!options.linksMode) cleanup.call(this);
+			super.destroy();
+		}
+	}
+	if (options.legacyRequests) restoreDeprecatedStoreBehaviors(BaseKlass);
+	return LegacyConfiguredStore;
 }
 function assertType(schema, type) {
-  (test => {
-    if (!test) {
-      throw new Error(`Expected type ${type} to be a valid ResourceType`);
-    }
-  })(schema.hasResource({
-    type
-  }));
+	((test) => {
+		if (!test) throw new Error(`Expected type ${type} to be a valid ResourceType`);
+	})(schema.hasResource({ type }));
 }
-export { useLegacyStore };
+
+//#endregion
+export { useLegacyStore };
+//# sourceMappingURL=index.js.map

package/dist/unpkg/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["CacheHandler","Fetch","recordIdentifierFor","RequestManager","Store","instantiateRecord","registerDerivations","SchemaService","teardownRecord","DefaultCachePolicy","adapterFor","cleanup","LegacyNetworkHandler","normalize","pushPayload","serializeRecord","serializerFor","EmberArrayLikeExtension","EmberObjectArrayExtension","EmberObjectExtension","instantiateModel","modelFor","teardownModel","FragmentArrayExtension","FragmentExtension","fragmentsModelFor","DelegatingSchemaService","registerLegacyDerivations","restoreDeprecatedStoreBehaviors","useLegacyStore","options","StoreKlass","test","Error","linksMode","legacyRequests","BaseKlass","LegacyConfiguredStore","constructor","createArgs","requestManager","Object","defineProperty","configurable","enumerable","get","handlersOption","handlers","use","filter","Boolean","useCache","set","value","lifetimes","policy","apiCacheHardExpires","apiCacheSoftExpires","constraints","headers","Expires","createSchemaService","schema","schemas","registerResources","traits","trait","registerTrait","derivations","derivation","registerDerivation","transformations","transformation","registerTransformation","hashFns","hashFn","registerHashFn","CAUTION_MEGA_DANGER_ZONE_extensions","extension","CAUTION_MEGA_DANGER_ZONE_registerExtension","modelFragments","createCache","capabilities","cache","key","isDelegated","call","record","type","assertType","klass","modelName","_allowMissing","args","destroy","hasResource"],"sources":["../../../src/index.ts"],"sourcesContent":["/**\n * @module\n * @mergeModuleWith <project>\n */\n\nimport {\n  CacheHandler,\n  Fetch,\n  recordIdentifierFor,\n  RequestManager,\n  Store,\n  type StoreSetupOptions,\n} from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { instantiateRecord, registerDerivations, SchemaService, teardownRecord } from '@warp-drive/core/reactive';\nimport type { Handler } from '@warp-drive/core/request';\nimport { DefaultCachePolicy } from '@warp-drive/core/store';\nimport type { CacheCapabilitiesManager, ModelSchema, ResourceKey } from '@warp-drive/core/types';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { TypeFromInstance } from '@warp-drive/core/types/record';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestInfo } from '@warp-drive/core/types/request';\nimport type { ObjectSchema, ResourceSchema } from '@warp-drive/core/types/schema/fields';\n\nimport type { MinimumAdapterInterface } from './compat';\nimport {\n  adapterFor,\n  cleanup,\n  LegacyNetworkHandler,\n  normalize,\n  pushPayload,\n  serializeRecord,\n  serializerFor,\n} from './compat';\nimport { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension } from './compat/extensions';\nimport type Model from './model';\nimport { instantiateRecord as instantiateModel, modelFor, teardownRecord as teardownModel } from './model';\nimport { FragmentArrayExtension, FragmentExtension } from './model-fragments';\nimport { fragmentsModelFor } from './model-fragments/hooks/model-for';\nimport { DelegatingSchemaService, registerDerivations as registerLegacyDerivations } from './model/migration-support';\nimport { restoreDeprecatedStoreBehaviors } from './store';\n\ninterface _LegacyStoreSetupOptions<T extends Cache> extends Omit<StoreSetupOptions<T>, 'schemas'> {\n  /**\n   * The {@link ResourceSchema | ResourceSchemas} or {@link ObjectSchema | ObjectSchemas} of entities\n   * migrated to no longer use {@link Model}.\n   *\n   * :::caution\n   * {@link Model} is still able to be used directly as a source of schema when using {@link useLegacyStore},\n   * however, its reliance on EmberObject, classic computeds and resolver behaviors mean that Model\n   * will stop working when these things are deprecated in Ember.\n   * :::\n   */\n  schemas?: Array<ResourceSchema | ObjectSchema>;\n\n  /**\n   * Whether to include support for ModelFragments migrations.\n   *\n   * @default false\n   */\n  modelFragments?: boolean;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` with `linksMode`\n * enabled, meaning no legacy adapter/serializer request infrastructure is required.\n *\n * @public\n */\nexport interface LegacyModelStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  linksMode: true;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests?: false;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` along with the\n * legacy adapter/serializer network layer, but without the deprecated\n * `store.findRecord`/`findAll`/`query`/etc. request methods.\n *\n * @public\n */\nexport interface LegacyModelAndNetworkStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * @default false\n   */\n  linksMode: false;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests?: false;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` along with the\n * legacy adapter/serializer network layer and the deprecated\n * `store.findRecord`/`findAll`/`query`/etc. request methods.\n *\n * @public\n */\nexport interface LegacyModelAndNetworkAndRequestStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * @default false\n   */\n  linksMode: false;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests: true;\n}\n\n//export type ConfiguredStore<T = unknown> = typeof Store;\n\n/**\n * The available options when setting up the legacy store,\n * one of:\n *\n * - {@link LegacyModelStoreSetupOptions}\n * - {@link LegacyModelAndNetworkStoreSetupOptions}\n * - {@link LegacyModelAndNetworkAndRequestStoreSetupOptions}\n */\nexport type LegacyStoreSetupOptions<T extends Cache = Cache> =\n  | LegacyModelStoreSetupOptions<T>\n  | LegacyModelAndNetworkStoreSetupOptions<T>\n  | LegacyModelAndNetworkAndRequestStoreSetupOptions<T>;\n\nexport declare class ConfiguredStore<\n  T extends {\n    /**\n     * The {@link Cache} implementation this store was configured with.\n     */\n    cache: Cache;\n  },\n> extends Store {\n  // get cache(): T extends OptionsWithCache<infer R> ? R : never;\n  createCache(capabilities: CacheCapabilitiesManager): T['cache'];\n}\n\n/**\n * Use the legacy store with the given options.\n *\n * See {@link LegacyStoreSetupOptions} for details on the available options.\n *\n * ```ts\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   schemas: [],\n * });\n * ```\n *\n * ### Adding Stateful Handlers\n *\n * A request {@link Handler} is sometimes more than a plain object or class\n * with a `request` method — it may need access to a stateful dependency such\n * as an Ember service (an auth token, a feature-flags service, an i18n\n * helper, etc.).\n *\n * A plain class handler that only relies on Ember's `@service` decorator will\n * not work here on its own: the handler is never instantiated *through*\n * Ember's container (it's just `new`'d up), so it has no owner and its\n * `@service` injections would fail to resolve.\n *\n * Instead, give `handlers` a function. It receives the {@link Store} instance\n * being configured, which by the time the function runs already has an owner\n * assigned. Use `getOwner`/`setOwner` from `@ember/owner` to transfer that\n * owner onto your handler instance before returning it, exactly as you would\n * when constructing any other DI-aware object outside of the container:\n *\n * ```ts\n * import { getOwner, setOwner } from '@ember/owner';\n * import { service } from '@ember/service';\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import type { NextFn } from '@warp-drive/core/request';\n * import type { RequestContext } from '@warp-drive/core/types/request';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * class AuthHandler {\n *   @service session;\n *\n *   request<T>(context: RequestContext, next: NextFn<T>) {\n *     const headers = new Headers(context.request.headers);\n *     headers.append('Authorization', `Bearer ${this.session.accessToken}`);\n *     return next(Object.assign({}, context.request, { headers }));\n *   }\n * }\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   handlers: (store) => {\n *     const authHandler = new AuthHandler();\n *     setOwner(authHandler, getOwner(store)!);\n *     return [authHandler];\n *   },\n * });\n * ```\n *\n * The `handlers` function is invoked lazily and only once per store instance,\n * the first time `store.requestManager` is accessed, so it is safe to do\n * owner-dependent setup like this inside of it.\n *\n * ### Accessing the Store from a Handler's Context\n *\n * If a handler only needs to read something *off of the store itself*\n * (its cache, or a property/service you've attached to a custom store\n * subclass) rather than an unrelated Ember service, there is a second,\n * simpler option that requires no DI/`setOwner` wiring at all.\n *\n * Every request issued via {@link Store.request | store.request(...)}\n * automatically carries the originating store along as\n * {@link RequestInfo.store | context.request.store}. Any handler — a plain\n * object, a function-built handler, or a class — can read it directly,\n * without needing the `handlers` callback form shown above:\n *\n * ```ts\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import type { NextFn } from '@warp-drive/core/request';\n * import type { RequestContext } from '@warp-drive/core/types/request';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * const LoggingHandler = {\n *   request<T>(context: RequestContext, next: NextFn<T>) {\n *     // only present when the request was made via `store.request(...)`\n *     const store = context.request.store;\n *     if (store) {\n *       console.log(`[${store.constructor.name}] ${context.request.url ?? ''}`);\n *     }\n *     return next(context.request);\n *   },\n * };\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   handlers: [LoggingHandler],\n * });\n * ```\n *\n * The trade-off versus the `getOwner`/`setOwner` pattern above is that\n * `context.request.store` is only populated for requests issued via\n * `store.request(...)`; a request made directly against a\n * {@link RequestManager} won't have it set unless the caller supplies it\n * explicitly, so a handler relying on it should treat it as optional (as\n * `LoggingHandler` does above).\n */\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelAndNetworkStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelAndNetworkAndRequestStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyStoreSetupOptions<T>,\n  StoreKlass: typeof Store = Store\n): typeof ConfiguredStore<{ cache: T }> {\n  assert(`If legacyRequests is true, linksMode must be false`, !(options.linksMode && options.legacyRequests));\n  // we extend the store to ensure we don't leak our prototype overrides to other stores below.\n  class BaseKlass extends StoreKlass {}\n  class LegacyConfiguredStore extends BaseKlass {\n    constructor(createArgs?: unknown) {\n      super(createArgs);\n      // installed via defineProperty (rather than a class field/accessor) so that\n      // this lazy override of the inherited `requestManager` field does not\n      // conflict with the documented pattern of assigning it directly on\n      // consumer-authored Store subclasses. The setter preserves the ability\n      // to replace `requestManager` outright after construction.\n      let requestManager: RequestManager | undefined;\n      Object.defineProperty(this, 'requestManager', {\n        configurable: true,\n        enumerable: true,\n        get: (): RequestManager => {\n          if (!requestManager) {\n            const handlersOption = options.handlers;\n            const handlers = typeof handlersOption === 'function' ? handlersOption(this) : (handlersOption ?? []);\n            requestManager = new RequestManager()\n              .use([options.linksMode ? null : LegacyNetworkHandler, ...handlers, Fetch].filter(Boolean) as Handler[])\n              .useCache(CacheHandler);\n          }\n          return requestManager;\n        },\n        set: (value: RequestManager): void => {\n          requestManager = value;\n        },\n      });\n    }\n\n    lifetimes =\n      options.policy ??\n      new DefaultCachePolicy({\n        apiCacheHardExpires: 15 * 60 * 1000, // 15 minutes\n        apiCacheSoftExpires: 1 * 30 * 1000, // 30 seconds\n        constraints: {\n          headers: {\n            'X-WarpDrive-Expires': true,\n            'Cache-Control': true,\n            Expires: true,\n          },\n        },\n      });\n\n    createSchemaService(): DelegatingSchemaService {\n      // prepare for PolarisMode\n      const schema = new SchemaService();\n      registerDerivations(schema);\n      if (options.schemas) schema.registerResources(options.schemas);\n\n      if (options.traits) {\n        for (const trait of options.traits) {\n          schema.registerTrait(trait);\n        }\n      }\n\n      if (options.derivations) {\n        for (const derivation of options.derivations) {\n          schema.registerDerivation(derivation);\n        }\n      }\n\n      if (options.transformations) {\n        for (const transformation of options.transformations) {\n          schema.registerTransformation(transformation);\n        }\n      }\n\n      if (options.hashFns) {\n        for (const hashFn of options.hashFns) {\n          schema.registerHashFn(hashFn);\n        }\n      }\n\n      if (options.CAUTION_MEGA_DANGER_ZONE_extensions) {\n        for (const extension of options.CAUTION_MEGA_DANGER_ZONE_extensions) {\n          schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(extension);\n        }\n      }\n\n      // Add support for LegacyMode ReactiveResource with Maximal coverage\n      // for upgrading from 4.x\n      registerLegacyDerivations(schema);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberArrayLikeExtension);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectArrayExtension);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectExtension);\n\n      // add support for fragments\n      if (options.modelFragments) {\n        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentExtension);\n        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentArrayExtension);\n      }\n\n      // Add fallback for Models\n      return new DelegatingSchemaService(this, schema);\n    }\n\n    createCache(capabilities: CacheCapabilitiesManager) {\n      // oxlint-disable-next-line new-cap\n      return new options.cache(capabilities);\n    }\n\n    instantiateRecord(key: ResourceKey, createArgs?: Record<string, unknown>) {\n      if (this.schema.isDelegated(key)) {\n        return instantiateModel.call(this, key, createArgs);\n      }\n      return instantiateRecord(this, key, createArgs);\n    }\n\n    teardownRecord(record: unknown): void {\n      const key = recordIdentifierFor(record);\n      if (this.schema.isDelegated(key)) {\n        return teardownModel.call(this, record as Model);\n      }\n      return teardownRecord(record);\n    }\n\n    modelFor<InstanceType>(type: TypeFromInstance<InstanceType>): ModelSchema<InstanceType>;\n    modelFor(type: string): ModelSchema;\n    modelFor(type: string): ModelSchema {\n      assertType(this.schema, type);\n\n      const klass =\n        // prefer real models if present\n        (modelFor.call(this, type) as ModelSchema) ||\n        // fallback to ShimModelClass specific to fragments if fragments support in use\n        (options.modelFragments ? (fragmentsModelFor.call(this, type) as ModelSchema) : false) ||\n        // fallback to ShimModelClass\n        super.modelFor(type);\n\n      return klass;\n    }\n\n    adapterFor(this: Store, modelName: string): MinimumAdapterInterface;\n    adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;\n    adapterFor(this: Store, modelName: string, _allowMissing?: true): MinimumAdapterInterface | undefined {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      // @ts-expect-error\n      return adapterFor.call(this, modelName, _allowMissing);\n    }\n\n    serializerFor(this: Store, ...args: Parameters<typeof serializerFor>): ReturnType<typeof serializerFor> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return serializerFor.call(this, ...args);\n    }\n\n    pushPayload(this: Store, ...args: Parameters<typeof pushPayload>): ReturnType<typeof pushPayload> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return pushPayload.call(this, ...args);\n    }\n\n    normalize(this: Store, ...args: Parameters<typeof normalize>): ReturnType<typeof normalize> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return normalize.call(this, ...args);\n    }\n\n    serializeRecord(this: Store, ...args: Parameters<typeof serializeRecord>): ReturnType<typeof serializeRecord> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return serializeRecord.call(this, ...args);\n    }\n\n    destroy() {\n      if (!options.linksMode) {\n        cleanup.call(this);\n      }\n      super.destroy();\n    }\n  }\n\n  if (options.legacyRequests) {\n    restoreDeprecatedStoreBehaviors(BaseKlass);\n  }\n\n  return LegacyConfiguredStore;\n}\n\nfunction assertType(schema: DelegatingSchemaService, type: string) {\n  assert(`Expected type ${type} to be a valid ResourceType`, schema.hasResource({ type }));\n}\n"],"mappings":"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"}