npm - @warp-drive/core - Versions diffs - 5.6.0-alpha.14 → 5.6.0-alpha.15 - Mend

@warp-drive/core 5.6.0-alpha.14 → 5.6.0-alpha.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (54) hide show

package/dist/{handler-cHghx9Y9.js.map → handler-D1C3Innj.js.map} RENAMED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"handler-cHghx9Y9.js","sources":["../src/store/-private/cache-handler/utils.ts","../src/store/-private/cache-handler/handler.ts"],"sourcesContent":["import type { StableDocumentIdentifier } from '../../../types/identifier.ts';\nimport type {\n ImmutableCreateRequestOptions,\n ImmutableDeleteRequestOptions,\n ImmutableRequestInfo,\n ImmutableUpdateRequestOptions,\n StructuredDataDocument,\n} from '../../../types/request.ts';\nimport type { ResourceDataDocument, ResourceErrorDocument } from '../../../types/spec/document.ts';\nimport type { ApiError } from '../../../types/spec/error.ts';\nimport type { Store } from '../store-service.ts';\n\nexport const MUTATION_OPS = new Set(['createRecord', 'updateRecord', 'deleteRecord']);\n\nexport function calcShouldFetch(\n store: Store,\n request: ImmutableRequestInfo,\n hasCachedValue: boolean,\n identifier: StableDocumentIdentifier \| null\n): boolean {\n const { cacheOptions } = request;\n return (\n (request.op && MUTATION_OPS.has(request.op)) \|\|\n cacheOptions?.reload \|\|\n !hasCachedValue \|\|\n (store.lifetimes && identifier ? store.lifetimes.isHardExpired(identifier, store) : false)\n );\n}\n\nexport function calcShouldBackgroundFetch(\n store: Store,\n request: ImmutableRequestInfo,\n willFetch: boolean,\n identifier: StableDocumentIdentifier \| null\n): boolean {\n const { cacheOptions } = request;\n return (\n !willFetch &&\n (cacheOptions?.backgroundReload \|\|\n (store.lifetimes && identifier ? store.lifetimes.isSoftExpired(identifier, store) : false))\n );\n}\n\nexport function isMutation(\n request: Partial<ImmutableRequestInfo>\n): request is ImmutableUpdateRequestOptions \| ImmutableCreateRequestOptions \| ImmutableDeleteRequestOptions {\n return Boolean(request.op && MUTATION_OPS.has(request.op));\n}\n\nexport function isCacheAffecting<T>(document: StructuredDataDocument<T>): boolean {\n if (!isMutation(document.request)) {\n return true;\n }\n // a mutation combined with a 204 has no cache impact when no known records were involved\n // a createRecord with a 201 with an empty response and no known records should similarly\n // have no cache impact\n\n if (document.request.op === 'createRecord' && document.response?.status === 201) {\n return document.content ? Object.keys(document.content).length > 0 : false;\n }\n\n return document.response?.status !== 204;\n}\n\nexport function isAggregateError(\n error: Error & { errors?: ApiError[] }\n): error is AggregateError & { errors: ApiError[] } {\n return error instanceof AggregateError \|\| (error.name === 'AggregateError' && Array.isArray(error.errors));\n}\n\nexport type RobustError = Error & { error: string \| object; errors?: ApiError[]; content?: unknown };\n\n// TODO @runspired, consider if we should deep freeze errors (potentially only in debug) vs cloning them\nexport function cloneError(error: RobustError) {\n const isAggregate = isAggregateError(error);\n\n const cloned = (\n isAggregate ? new AggregateError(structuredClone(error.errors), error.message) : new Error(error.message)\n ) as RobustError;\n cloned.stack = error.stack!;\n cloned.error = error.error;\n\n // copy over enumerable properties\n Object.assign(cloned, error);\n\n return cloned;\n}\n\nexport function isErrorDocument(\n document: ResourceDataDocument \| ResourceErrorDocument\n): document is ResourceErrorDocument {\n return 'errors' in document;\n}\n\nexport function getPriority(\n identifier: StableDocumentIdentifier \| null,\n deduped: Map<StableDocumentIdentifier, { priority: { blocking: boolean } }>,\n priority: { blocking: boolean }\n) {\n if (identifier) {\n const existing = deduped.get(identifier);\n if (existing) {\n return existing.priority;\n }\n }\n return priority;\n}\n","import { assert } from '@warp-drive/core/build-config/macros';\n\nimport { ReactiveDocument } from '../../../reactive/-private/document.ts';\nimport type { CacheHandler as CacheHandlerType, Future, ManagedRequestPriority, NextFn } from '../../../request.ts';\nimport type { StableDocumentIdentifier } from '../../../types/identifier.ts';\nimport type {\n ImmutableRequestInfo,\n RequestContext,\n StructuredDataDocument,\n StructuredErrorDocument,\n} from '../../../types/request.ts';\nimport { EnableHydration, SkipCache } from '../../../types/request.ts';\nimport type { ResourceDataDocument, ResourceDocument, ResourceErrorDocument } from '../../../types/spec/document.ts';\nimport type { ApiError } from '../../../types/spec/error.ts';\nimport type { ResourceIdentifierObject } from '../../../types/spec/json-api-raw.ts';\nimport type { RequestSignature } from '../../../types/symbols.ts';\nimport type { Store } from '../store-service.ts';\nimport {\n calcShouldBackgroundFetch,\n calcShouldFetch,\n cloneError,\n getPriority,\n isCacheAffecting,\n isMutation,\n} from './utils.ts';\n\nexport type LooseStoreRequestInfo<RT = unknown, T = unknown> = Omit<\n ImmutableRequestInfo<RT, T>,\n 'records' \| 'headers' \| typeof RequestSignature\n> & {\n records?: ResourceIdentifierObject[];\n headers?: Headers;\n};\n\nexport type StoreRequestInput<RT = unknown, T = unknown> = ImmutableRequestInfo<RT, T> \| LooseStoreRequestInfo<RT, T>;\n\nexport interface StoreRequestContext extends RequestContext {\n request: ImmutableRequestInfo & { store: Store };\n}\n\n/*\n A CacheHandler that adds support for using an WarpDrive Cache with a RequestManager.\n \n This handler will only run when a request has supplied a `store` instance. Requests\n * issued by the store via `store.request()` will automatically have the `store` instance\n * attached to the request.\n \n ```ts\n * requestManager.request({\n * store: store,\n * url: '/api/posts',\n * method: 'GET'\n * });\n * ```\n \n When this handler elects to handle a request, it will return the raw `StructuredDocument`\n * unless the request has `[EnableHydration]` set to `true`. In this case, the handler will\n * return a `Document` instance that will automatically update the UI when the cache is updated\n * in the future and will hydrate any identifiers in the StructuredDocument into Record instances.\n \n When issuing a request via the store, [EnableHydration] is automatically set to `true`. This\n * means that if desired you can issue requests that utilize the cache without needing to also\n * utilize Record instances if desired.\n \n Said differently, you could elect to issue all requests via a RequestManager, without ever using\n * the store directly, by setting [EnableHydration] to `true` and providing a store instance. Not\n * necessarily the most useful thing, but the decoupled nature of the RequestManager and incremental-feature\n * approach of WarpDrive allows for this flexibility.\n \n ```ts\n * import { EnableHydration } from '@warp-drive/core/types/request';\n \n requestManager.request({\n * store: store,\n * url: '/api/posts',\n * method: 'GET',\n * [EnableHydration]: true\n * });\n \n /\nexport const CacheHandler: CacheHandlerType = {\n request<T>(\n context: StoreRequestContext & { setIdentifier(identifier: StableDocumentIdentifier): void },\n next: NextFn<T>\n ): Promise<T \| StructuredDataDocument<T>> \| Future<T> \| T {\n // if we have no cache or no cache-key skip cache handling\n if (!context.request.store \|\| context.request.cacheOptions?.[SkipCache]) {\n return next(context.request);\n }\n\n const { store } = context.request;\n const identifier = store.identifierCache.getOrCreateDocumentIdentifier(context.request);\n\n if (identifier) {\n context.setIdentifier(identifier);\n }\n\n // used to dedupe existing requests that match\n const DEDUPE = store.requestManager._deduped;\n const activeRequest = identifier && DEDUPE.get(identifier);\n const peeked = identifier ? store.cache.peekRequest(identifier) : null;\n\n // determine if we should skip cache\n if (calcShouldFetch(store, context.request, !!peeked, identifier)) {\n if (activeRequest) {\n activeRequest.priority = { blocking: true };\n return activeRequest.promise as Promise<T>;\n }\n let promise = fetchContentAndHydrate(next, context, identifier, { blocking: true });\n if (identifier) {\n promise = promise.finally(() => {\n DEDUPE.delete(identifier);\n store.notifications.notify(identifier, 'state');\n });\n DEDUPE.set(identifier, { priority: { blocking: true }, promise });\n store.notifications.notify(identifier, 'state');\n }\n return promise;\n }\n\n // if we have not skipped cache, determine if we should update behind the scenes\n if (calcShouldBackgroundFetch(store, context.request, false, identifier)) {\n let promise = activeRequest?.promise \|\| fetchContentAndHydrate(next, context, identifier, { blocking: false });\n if (identifier && !activeRequest) {\n promise = promise.finally(() => {\n DEDUPE.delete(identifier);\n store.notifications.notify(identifier, 'state');\n });\n DEDUPE.set(identifier, { priority: { blocking: false }, promise });\n store.notifications.notify(identifier, 'state');\n }\n store.requestManager._pending.set(context.id, promise);\n }\n\n assert(`Expected a peeked request to be present`, peeked);\n\n const shouldHydrate: boolean = context.request[EnableHydration] \|\| false;\n context.setResponse(peeked.response);\n\n if ('error' in peeked) {\n const content = shouldHydrate\n ? maybeUpdateUiObjects<T>(store, context.request, { shouldHydrate, identifier }, peeked.content)\n : peeked.content;\n const newError = cloneError(peeked);\n newError.content = content as object;\n throw newError;\n }\n\n const result = shouldHydrate\n ? (maybeUpdateUiObjects<T>(store, context.request, { shouldHydrate, identifier }, peeked.content) as T)\n : (peeked.content as T);\n\n return result;\n },\n};\n\ntype HydrationOptions = {\n shouldHydrate?: boolean;\n identifier: StableDocumentIdentifier \| null;\n};\n\ntype UpdateOptions = HydrationOptions & {\n priority: ManagedRequestPriority;\n};\n\nfunction maybeUpdateUiObjects<T>(\n store: Store,\n request: ImmutableRequestInfo,\n options: HydrationOptions,\n document: ResourceDocument \| null \| undefined\n): ReactiveDocument<T> \| ResourceDocument \| null {\n const { identifier } = options;\n\n if (!document \|\| !options.shouldHydrate) {\n assert(`The CacheHandler expected response content but none was found`, !options.shouldHydrate);\n return document ?? null;\n }\n\n if (identifier) {\n return store._instanceCache.getDocument<T>(identifier);\n }\n\n // if we don't have an identifier, we give the document\n // its own local cache\n return new ReactiveDocument<T>(store, null, {\n request,\n document,\n });\n}\n\nfunction updateCacheForSuccess<T>(\n store: Store,\n request: StoreRequestContext['request'],\n options: HydrationOptions,\n document: StructuredDataDocument<T>\n) {\n let response: ResourceDataDocument \| null = null;\n if (isMutation(request)) {\n const record = request.data?.record \|\| request.records?.[0];\n if (record) {\n response = store.cache.didCommit(record, document) as ResourceDataDocument;\n\n // a mutation combined with a 204 has no cache impact when no known records were involved\n // a createRecord with a 201 with an empty response and no known records should similarly\n // have no cache impact\n } else if (isCacheAffecting(document)) {\n response = store.cache.put(document) as ResourceDataDocument;\n }\n } else {\n response = store.cache.put(document) as ResourceDataDocument;\n }\n return maybeUpdateUiObjects(store, request, options, response);\n}\n\nfunction handleFetchSuccess<T>(\n store: Store,\n context: StoreRequestContext,\n options: UpdateOptions,\n document: StructuredDataDocument<T>\n): ResourceDataDocument \| void {\n const { request } = context;\n store.requestManager._pending.delete(context.id);\n store._enableAsyncFlush = true;\n let response: ResourceDataDocument;\n store._join(() => {\n response = updateCacheForSuccess<T>(store, request, options, document) as ResourceDataDocument;\n });\n store._enableAsyncFlush = null;\n\n if (store.lifetimes?.didRequest) {\n store.lifetimes.didRequest(context.request, document.response, options.identifier, store);\n }\n\n const finalPriority = getPriority(options.identifier, store.requestManager._deduped, options.priority);\n if (finalPriority.blocking) {\n return response!;\n } else {\n store.notifications._flush();\n }\n}\n\nfunction updateCacheForError<T>(\n store: Store,\n context: StoreRequestContext,\n options: HydrationOptions,\n error: StructuredErrorDocument<T>\n) {\n let response: ResourceErrorDocument \| undefined;\n if (isMutation(context.request)) {\n // TODO similar to didCommit we should spec this to be similar to cache.put for handling full response\n // currently we let the response remain undefiend.\n const errors =\n error &&\n error.content &&\n typeof error.content === 'object' &&\n 'errors' in error.content &&\n Array.isArray(error.content.errors)\n ? (error.content.errors as ApiError[])\n : undefined;\n\n const record = context.request.data?.record \|\| context.request.records?.[0];\n\n store.cache.commitWasRejected(record, errors);\n } else {\n response = store.cache.put(error) as ResourceErrorDocument;\n return maybeUpdateUiObjects(store, context.request, options, response);\n }\n}\n\nfunction handleFetchError<T>(\n store: Store,\n context: StoreRequestContext,\n options: UpdateOptions,\n error: StructuredErrorDocument<T>\n): ResourceErrorDocument \| void {\n store.requestManager._pending.delete(context.id);\n if (context.request.signal?.aborted) {\n throw error;\n }\n store._enableAsyncFlush = true;\n let response: ResourceErrorDocument \| undefined;\n store._join(() => {\n response = updateCacheForError(store, context, options, error) as ResourceErrorDocument;\n });\n store._enableAsyncFlush = null;\n\n if (options.identifier && store.lifetimes?.didRequest) {\n store.lifetimes.didRequest(context.request, error.response, options.identifier, store);\n }\n\n if (isMutation(context.request)) {\n throw error;\n }\n\n const finalPriority = getPriority(options.identifier, store.requestManager._deduped, options.priority);\n if (finalPriority.blocking) {\n const newError = cloneError(error);\n newError.content = response!;\n throw newError;\n } else {\n store.notifications._flush();\n }\n}\n\nfunction fetchContentAndHydrate<T>(\n next: NextFn<T>,\n context: StoreRequestContext,\n identifier: StableDocumentIdentifier \| null,\n priority: { blocking: boolean }\n): Promise<T> {\n const { store } = context.request;\n const shouldHydrate: boolean = context.request[EnableHydration] \|\| false;\n const options = { shouldHydrate, identifier, priority };\n\n let isMut = false;\n if (isMutation(context.request)) {\n isMut = true;\n // TODO should we handle multiple records in request.records by iteratively calling willCommit for each\n const record = context.request.data?.record \|\| context.request.records?.[0];\n assert(\n `Expected to receive a list of records included in the ${context.request.op} request`,\n record \|\| !shouldHydrate\n );\n if (record) {\n store.cache.willCommit(record, context);\n }\n }\n\n if (store.lifetimes?.willRequest) {\n store.lifetimes.willRequest(context.request, identifier, store);\n }\n\n const promise = next(context.request).then(\n (document) => {\n return handleFetchSuccess(store, context, options, document);\n },\n (error: StructuredErrorDocument<T>) => {\n return handleFetchError(store, context, options, error);\n }\n ) as Promise<T>;\n\n if (!isMut) {\n return promise;\n }\n assert(`Expected a mutation`, isMutation(context.request));\n\n // for mutations we need to enqueue the promise with the requestStateService\n // TODO should we enque a request per record in records?\n const record = context.request.data?.record \|\| context.request.records?.[0];\n\n return store._requestCache._enqueue(promise, {\n data: [{ op: 'saveRecord', recordIdentifier: record, options: undefined }],\n });\n}\n"],"names":["MUTATION_OPS","Set","calcShouldFetch","store","request","hasCachedValue","identifier","cacheOptions","op","has","reload","lifetimes","isHardExpired","calcShouldBackgroundFetch","willFetch","backgroundReload","isSoftExpired","isMutation","Boolean","isCacheAffecting","document","response","status","content","Object","keys","length","isAggregateError","error","AggregateError","name","Array","isArray","errors","cloneError","isAggregate","cloned","structuredClone","message","Error","stack","assign","getPriority","deduped","priority","existing","get","CacheHandler","context","next","SkipCache","identifierCache","getOrCreateDocumentIdentifier","setIdentifier","DEDUPE","requestManager","_deduped","activeRequest","peeked","cache","peekRequest","blocking","promise","fetchContentAndHydrate","finally","delete","notifications","notify","set","_pending","id","macroCondition","getGlobalConfig","WarpDrive","env","DEBUG","test","shouldHydrate","EnableHydration","setResponse","maybeUpdateUiObjects","newError","result","options","_instanceCache","getDocument","ReactiveDocument","updateCacheForSuccess","record","data","records","didCommit","put","handleFetchSuccess","_enableAsyncFlush","_join","didRequest","finalPriority","_flush","updateCacheForError","undefined","commitWasRejected","handleFetchError","signal","aborted","isMut","willCommit","willRequest","then","_requestCache","_enqueue","recordIdentifier"],"mappings":"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"}
1	+ {"version":3,"file":"handler-D1C3Innj.js","sources":["../src/store/-private/cache-handler/utils.ts","../src/store/-private/cache-handler/handler.ts"],"sourcesContent":["import type { StableDocumentIdentifier } from '../../../types/identifier.ts';\nimport type {\n ImmutableCreateRequestOptions,\n ImmutableDeleteRequestOptions,\n ImmutableRequestInfo,\n ImmutableUpdateRequestOptions,\n StructuredDataDocument,\n} from '../../../types/request.ts';\nimport type { ResourceDataDocument, ResourceErrorDocument } from '../../../types/spec/document.ts';\nimport type { ApiError } from '../../../types/spec/error.ts';\nimport type { Store } from '../store-service.ts';\n\nexport const MUTATION_OPS = new Set(['createRecord', 'updateRecord', 'deleteRecord']);\n\nexport function calcShouldFetch(\n store: Store,\n request: ImmutableRequestInfo,\n hasCachedValue: boolean,\n identifier: StableDocumentIdentifier \| null\n): boolean {\n const { cacheOptions } = request;\n return (\n (request.op && MUTATION_OPS.has(request.op)) \|\|\n cacheOptions?.reload \|\|\n !hasCachedValue \|\|\n (store.lifetimes && identifier ? store.lifetimes.isHardExpired(identifier, store) : false)\n );\n}\n\nexport function calcShouldBackgroundFetch(\n store: Store,\n request: ImmutableRequestInfo,\n willFetch: boolean,\n identifier: StableDocumentIdentifier \| null\n): boolean {\n const { cacheOptions } = request;\n return (\n !willFetch &&\n (cacheOptions?.backgroundReload \|\|\n (store.lifetimes && identifier ? store.lifetimes.isSoftExpired(identifier, store) : false))\n );\n}\n\nexport function isMutation(\n request: Partial<ImmutableRequestInfo>\n): request is ImmutableUpdateRequestOptions \| ImmutableCreateRequestOptions \| ImmutableDeleteRequestOptions {\n return Boolean(request.op && MUTATION_OPS.has(request.op));\n}\n\nexport function isCacheAffecting<T>(document: StructuredDataDocument<T>): boolean {\n if (!isMutation(document.request)) {\n return true;\n }\n // a mutation combined with a 204 has no cache impact when no known records were involved\n // a createRecord with a 201 with an empty response and no known records should similarly\n // have no cache impact\n\n if (document.request.op === 'createRecord' && document.response?.status === 201) {\n return document.content ? Object.keys(document.content).length > 0 : false;\n }\n\n return document.response?.status !== 204;\n}\n\nexport function isAggregateError(\n error: Error & { errors?: ApiError[] }\n): error is AggregateError & { errors: ApiError[] } {\n return error instanceof AggregateError \|\| (error.name === 'AggregateError' && Array.isArray(error.errors));\n}\n\nexport type RobustError = Error & { error: string \| object; errors?: ApiError[]; content?: unknown };\n\n// TODO @runspired, consider if we should deep freeze errors (potentially only in debug) vs cloning them\nexport function cloneError(error: RobustError) {\n const isAggregate = isAggregateError(error);\n\n const cloned = (\n isAggregate ? new AggregateError(structuredClone(error.errors), error.message) : new Error(error.message)\n ) as RobustError;\n cloned.stack = error.stack!;\n cloned.error = error.error;\n\n // copy over enumerable properties\n Object.assign(cloned, error);\n\n return cloned;\n}\n\nexport function isErrorDocument(\n document: ResourceDataDocument \| ResourceErrorDocument\n): document is ResourceErrorDocument {\n return 'errors' in document;\n}\n\nexport function getPriority(\n identifier: StableDocumentIdentifier \| null,\n deduped: Map<StableDocumentIdentifier, { priority: { blocking: boolean } }>,\n priority: { blocking: boolean }\n) {\n if (identifier) {\n const existing = deduped.get(identifier);\n if (existing) {\n return existing.priority;\n }\n }\n return priority;\n}\n","import { assert } from '@warp-drive/core/build-config/macros';\n\nimport { ReactiveDocument } from '../../../reactive/-private/document.ts';\nimport type { CacheHandler as CacheHandlerType, Future, ManagedRequestPriority, NextFn } from '../../../request.ts';\nimport type { StableDocumentIdentifier } from '../../../types/identifier.ts';\nimport type {\n ImmutableRequestInfo,\n RequestContext,\n StructuredDataDocument,\n StructuredErrorDocument,\n} from '../../../types/request.ts';\nimport { EnableHydration, SkipCache } from '../../../types/request.ts';\nimport type { ResourceDataDocument, ResourceDocument, ResourceErrorDocument } from '../../../types/spec/document.ts';\nimport type { ApiError } from '../../../types/spec/error.ts';\nimport type { ResourceIdentifierObject } from '../../../types/spec/json-api-raw.ts';\nimport type { RequestSignature } from '../../../types/symbols.ts';\nimport type { Store } from '../store-service.ts';\nimport {\n calcShouldBackgroundFetch,\n calcShouldFetch,\n cloneError,\n getPriority,\n isCacheAffecting,\n isMutation,\n} from './utils.ts';\n\nexport type LooseStoreRequestInfo<RT = unknown, T = unknown> = Omit<\n ImmutableRequestInfo<RT, T>,\n 'records' \| 'headers' \| typeof RequestSignature\n> & {\n records?: ResourceIdentifierObject[];\n headers?: Headers;\n};\n\nexport type StoreRequestInput<RT = unknown, T = unknown> = ImmutableRequestInfo<RT, T> \| LooseStoreRequestInfo<RT, T>;\n\nexport interface StoreRequestContext extends RequestContext {\n request: ImmutableRequestInfo & { store: Store };\n}\n\n/*\n A CacheHandler that adds support for using an WarpDrive Cache with a RequestManager.\n \n This handler will only run when a request has supplied a `store` instance. Requests\n * issued by the store via `store.request()` will automatically have the `store` instance\n * attached to the request.\n \n ```ts\n * requestManager.request({\n * store: store,\n * url: '/api/posts',\n * method: 'GET'\n * });\n * ```\n \n When this handler elects to handle a request, it will return the raw `StructuredDocument`\n * unless the request has `[EnableHydration]` set to `true`. In this case, the handler will\n * return a `Document` instance that will automatically update the UI when the cache is updated\n * in the future and will hydrate any identifiers in the StructuredDocument into Record instances.\n \n When issuing a request via the store, [EnableHydration] is automatically set to `true`. This\n * means that if desired you can issue requests that utilize the cache without needing to also\n * utilize Record instances if desired.\n \n Said differently, you could elect to issue all requests via a RequestManager, without ever using\n * the store directly, by setting [EnableHydration] to `true` and providing a store instance. Not\n * necessarily the most useful thing, but the decoupled nature of the RequestManager and incremental-feature\n * approach of WarpDrive allows for this flexibility.\n \n ```ts\n * import { EnableHydration } from '@warp-drive/core/types/request';\n \n requestManager.request({\n * store: store,\n * url: '/api/posts',\n * method: 'GET',\n * [EnableHydration]: true\n * });\n \n /\nexport const CacheHandler: CacheHandlerType = {\n request<T>(\n context: StoreRequestContext & { setIdentifier(identifier: StableDocumentIdentifier): void },\n next: NextFn<T>\n ): Promise<T \| StructuredDataDocument<T>> \| Future<T> \| T {\n // if we have no cache or no cache-key skip cache handling\n if (!context.request.store \|\| context.request.cacheOptions?.[SkipCache]) {\n return next(context.request);\n }\n\n const { store } = context.request;\n const identifier = store.identifierCache.getOrCreateDocumentIdentifier(context.request);\n\n if (identifier) {\n context.setIdentifier(identifier);\n }\n\n // used to dedupe existing requests that match\n const DEDUPE = store.requestManager._deduped;\n const activeRequest = identifier && DEDUPE.get(identifier);\n const peeked = identifier ? store.cache.peekRequest(identifier) : null;\n\n // determine if we should skip cache\n if (calcShouldFetch(store, context.request, !!peeked, identifier)) {\n if (activeRequest) {\n activeRequest.priority = { blocking: true };\n return activeRequest.promise as Promise<T>;\n }\n let promise = fetchContentAndHydrate(next, context, identifier, { blocking: true });\n if (identifier) {\n promise = promise.finally(() => {\n DEDUPE.delete(identifier);\n store.notifications.notify(identifier, 'state');\n });\n DEDUPE.set(identifier, { priority: { blocking: true }, promise });\n store.notifications.notify(identifier, 'state');\n }\n return promise;\n }\n\n // if we have not skipped cache, determine if we should update behind the scenes\n if (calcShouldBackgroundFetch(store, context.request, false, identifier)) {\n let promise = activeRequest?.promise \|\| fetchContentAndHydrate(next, context, identifier, { blocking: false });\n if (identifier && !activeRequest) {\n promise = promise.finally(() => {\n DEDUPE.delete(identifier);\n store.notifications.notify(identifier, 'state');\n });\n DEDUPE.set(identifier, { priority: { blocking: false }, promise });\n store.notifications.notify(identifier, 'state');\n }\n store.requestManager._pending.set(context.id, promise);\n }\n\n assert(`Expected a peeked request to be present`, peeked);\n\n const shouldHydrate: boolean = context.request[EnableHydration] \|\| false;\n context.setResponse(peeked.response);\n\n if ('error' in peeked) {\n const content = shouldHydrate\n ? maybeUpdateUiObjects<T>(store, context.request, { shouldHydrate, identifier }, peeked.content)\n : peeked.content;\n const newError = cloneError(peeked);\n newError.content = content as object;\n throw newError;\n }\n\n const result = shouldHydrate\n ? (maybeUpdateUiObjects<T>(store, context.request, { shouldHydrate, identifier }, peeked.content) as T)\n : (peeked.content as T);\n\n return result;\n },\n};\n\ntype HydrationOptions = {\n shouldHydrate?: boolean;\n identifier: StableDocumentIdentifier \| null;\n};\n\ntype UpdateOptions = HydrationOptions & {\n priority: ManagedRequestPriority;\n};\n\nfunction maybeUpdateUiObjects<T>(\n store: Store,\n request: ImmutableRequestInfo,\n options: HydrationOptions,\n document: ResourceDocument \| null \| undefined\n): ReactiveDocument<T> \| ResourceDocument \| null {\n const { identifier } = options;\n\n if (!document \|\| !options.shouldHydrate) {\n assert(`The CacheHandler expected response content but none was found`, !options.shouldHydrate);\n return document ?? null;\n }\n\n if (identifier) {\n return store._instanceCache.getDocument<T>(identifier);\n }\n\n // if we don't have an identifier, we give the document\n // its own local cache\n return new ReactiveDocument<T>(store, null, {\n request,\n document,\n });\n}\n\nfunction updateCacheForSuccess<T>(\n store: Store,\n request: StoreRequestContext['request'],\n options: HydrationOptions,\n document: StructuredDataDocument<T>\n) {\n let response: ResourceDataDocument \| null = null;\n if (isMutation(request)) {\n const record = request.data?.record \|\| request.records?.[0];\n if (record) {\n response = store.cache.didCommit(record, document) as ResourceDataDocument;\n\n // a mutation combined with a 204 has no cache impact when no known records were involved\n // a createRecord with a 201 with an empty response and no known records should similarly\n // have no cache impact\n } else if (isCacheAffecting(document)) {\n response = store.cache.put(document) as ResourceDataDocument;\n }\n } else {\n response = store.cache.put(document) as ResourceDataDocument;\n }\n return maybeUpdateUiObjects(store, request, options, response);\n}\n\nfunction handleFetchSuccess<T>(\n store: Store,\n context: StoreRequestContext,\n options: UpdateOptions,\n document: StructuredDataDocument<T>\n): ResourceDataDocument \| void {\n const { request } = context;\n store.requestManager._pending.delete(context.id);\n store._enableAsyncFlush = true;\n let response: ResourceDataDocument;\n store._join(() => {\n response = updateCacheForSuccess<T>(store, request, options, document) as ResourceDataDocument;\n });\n store._enableAsyncFlush = null;\n\n if (store.lifetimes?.didRequest) {\n store.lifetimes.didRequest(context.request, document.response, options.identifier, store);\n }\n\n const finalPriority = getPriority(options.identifier, store.requestManager._deduped, options.priority);\n if (finalPriority.blocking) {\n return response!;\n } else {\n store.notifications._flush();\n }\n}\n\nfunction updateCacheForError<T>(\n store: Store,\n context: StoreRequestContext,\n options: HydrationOptions,\n error: StructuredErrorDocument<T>\n) {\n let response: ResourceErrorDocument \| undefined;\n if (isMutation(context.request)) {\n // TODO similar to didCommit we should spec this to be similar to cache.put for handling full response\n // currently we let the response remain undefiend.\n const errors =\n error &&\n error.content &&\n typeof error.content === 'object' &&\n 'errors' in error.content &&\n Array.isArray(error.content.errors)\n ? (error.content.errors as ApiError[])\n : undefined;\n\n const record = context.request.data?.record \|\| context.request.records?.[0];\n\n store.cache.commitWasRejected(record, errors);\n } else {\n response = store.cache.put(error) as ResourceErrorDocument;\n return maybeUpdateUiObjects(store, context.request, options, response);\n }\n}\n\nfunction handleFetchError<T>(\n store: Store,\n context: StoreRequestContext,\n options: UpdateOptions,\n error: StructuredErrorDocument<T>\n): ResourceErrorDocument \| void {\n store.requestManager._pending.delete(context.id);\n if (context.request.signal?.aborted) {\n throw error;\n }\n store._enableAsyncFlush = true;\n let response: ResourceErrorDocument \| undefined;\n store._join(() => {\n response = updateCacheForError(store, context, options, error) as ResourceErrorDocument;\n });\n store._enableAsyncFlush = null;\n\n if (options.identifier && store.lifetimes?.didRequest) {\n store.lifetimes.didRequest(context.request, error.response, options.identifier, store);\n }\n\n if (isMutation(context.request)) {\n throw error;\n }\n\n const finalPriority = getPriority(options.identifier, store.requestManager._deduped, options.priority);\n if (finalPriority.blocking) {\n const newError = cloneError(error);\n newError.content = response!;\n throw newError;\n } else {\n store.notifications._flush();\n }\n}\n\nfunction fetchContentAndHydrate<T>(\n next: NextFn<T>,\n context: StoreRequestContext,\n identifier: StableDocumentIdentifier \| null,\n priority: { blocking: boolean }\n): Promise<T> {\n const { store } = context.request;\n const shouldHydrate: boolean = context.request[EnableHydration] \|\| false;\n const options = { shouldHydrate, identifier, priority };\n\n let isMut = false;\n if (isMutation(context.request)) {\n isMut = true;\n // TODO should we handle multiple records in request.records by iteratively calling willCommit for each\n const record = context.request.data?.record \|\| context.request.records?.[0];\n assert(\n `Expected to receive a list of records included in the ${context.request.op} request`,\n record \|\| !shouldHydrate\n );\n if (record) {\n store.cache.willCommit(record, context);\n }\n }\n\n if (store.lifetimes?.willRequest) {\n store.lifetimes.willRequest(context.request, identifier, store);\n }\n\n const promise = next(context.request).then(\n (document) => {\n return handleFetchSuccess(store, context, options, document);\n },\n (error: StructuredErrorDocument<T>) => {\n return handleFetchError(store, context, options, error);\n }\n ) as Promise<T>;\n\n if (!isMut) {\n return promise;\n }\n assert(`Expected a mutation`, isMutation(context.request));\n\n // for mutations we need to enqueue the promise with the requestStateService\n // TODO should we enque a request per record in records?\n const record = context.request.data?.record \|\| context.request.records?.[0];\n\n return store._requestCache._enqueue(promise, {\n data: [{ op: 'saveRecord', recordIdentifier: record, options: undefined }],\n });\n}\n"],"names":["MUTATION_OPS","Set","calcShouldFetch","store","request","hasCachedValue","identifier","cacheOptions","op","has","reload","lifetimes","isHardExpired","calcShouldBackgroundFetch","willFetch","backgroundReload","isSoftExpired","isMutation","Boolean","isCacheAffecting","document","response","status","content","Object","keys","length","isAggregateError","error","AggregateError","name","Array","isArray","errors","cloneError","isAggregate","cloned","structuredClone","message","Error","stack","assign","getPriority","deduped","priority","existing","get","CacheHandler","context","next","SkipCache","identifierCache","getOrCreateDocumentIdentifier","setIdentifier","DEDUPE","requestManager","_deduped","activeRequest","peeked","cache","peekRequest","blocking","promise","fetchContentAndHydrate","finally","delete","notifications","notify","set","_pending","id","macroCondition","getGlobalConfig","WarpDrive","env","DEBUG","test","shouldHydrate","EnableHydration","setResponse","maybeUpdateUiObjects","newError","result","options","_instanceCache","getDocument","ReactiveDocument","updateCacheForSuccess","record","data","records","didCommit","put","handleFetchSuccess","_enableAsyncFlush","_join","didRequest","finalPriority","_flush","updateCacheForError","undefined","commitWasRejected","handleFetchError","signal","aborted","isMut","willCommit","willRequest","then","_requestCache","_enqueue","recordIdentifier"],"mappings":"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"}

package/dist/index.js CHANGED Viewed

@@ -1,10 +1,10 @@
 import { setLogging, getRuntimeConfig } from './types/runtime.js';
 import { a as cloneResponseProperties, I as IS_CACHE_HANDLER, b as assertValidRequest, e as executeNextHandler, d as getRequestResult, u as upgradePromise, s as setPromiseResult, f as clearRequestResult } from "./context-COmAnXUQ.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
-import { w as waitFor } from "./configure-BgaZESRo.js";
+import { w as waitFor } from "./configure-B48bFHOl.js";
 import { peekUniversalTransient, setUniversalTransient } from './types/-private.js';
-export { S as Store, r as recordIdentifierFor, K as setIdentifierForgetMethod, H as setIdentifierGenerationMethod, L as setIdentifierResetMethod, J as setIdentifierUpdateMethod, N as setKeyInfoForResource, s as storeFor } from "./request-state-DgwTEXLU.js";
-export { C as CacheHandler } from "./handler-cHghx9Y9.js";
+export { S as Store, r as recordIdentifierFor, N as setIdentifierForgetMethod, K as setIdentifierGenerationMethod, O as setIdentifierResetMethod, L as setIdentifierUpdateMethod, P as setKeyInfoForResource, s as storeFor } from "./request-state-CCOJIj5i.js";
+export { C as CacheHandler } from "./handler-D1C3Innj.js";
 import '@ember/debug';
 import './utils/string.js';

package/dist/reactive/-private.js CHANGED Viewed

	@@ -1 +1 @@
1	- export { E as Editable, L as Legacy } from "../symbols-~~BmDcn6hS~~.js";
1	+ export { E as Editable, L as Legacy } from "../symbols-epHW0Vm9.js";

package/dist/reactive.js CHANGED Viewed

@@ -1,13 +1,13 @@
 import { isResourceSchema } from './types/schema/fields.js';
-import { B as withSignalStore, w as entangleSignal, E as consumeInternalSignal, d as SOURCE$1, f as fastPush, x as defineSignal, l as RelatedCollection, F as getOrCreateInternalSignal, D as notifyInternalSignal, z as Signals, h as setRecordIdentifier, r as recordIdentifierFor } from "./request-state-DgwTEXLU.js";
+import { E as withSignalStore, Q as isExtensionProp, T as performExtensionSet, G as consumeInternalSignal, U as performArrayExtensionGet, x as entangleSignal, V as performObjectExtensionGet, d as SOURCE$1, f as fastPush, y as defineSignal, l as RelatedCollection, H as getOrCreateInternalSignal, F as notifyInternalSignal, A as Signals, h as setRecordIdentifier, r as recordIdentifierFor } from "./request-state-CCOJIj5i.js";
 import { EnableHydration, STRUCTURED } from './types/request.js';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import { deprecate } from '@ember/debug';
 import './utils/string.js';
-import { A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, c as createMemo } from "./configure-BgaZESRo.js";
+import { A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, c as createMemo } from "./configure-B48bFHOl.js";
 import { RecordStore, Type } from './types/symbols.js';
 import { getOrSetGlobal } from './types/-private.js';
-import { S as SOURCE, E as Editable, L as Legacy, I as Identifier, P as Parent, a as EmbeddedPath, D as Destroy, C as Checkout, b as EmbeddedType } from "./symbols-BmDcn6hS.js";
+import { S as SOURCE, E as Editable, L as Legacy, I as Identifier, P as Parent, a as EmbeddedPath, D as Destroy, C as Checkout, b as EmbeddedField } from "./symbols-epHW0Vm9.js";
 import './index.js';
 const ARRAY_GETTER_METHODS = new Set([Symbol.iterator, 'concat', 'entries', 'every', 'fill', 'filter', 'find', 'findIndex', 'flat', 'flatMap', 'forEach', 'includes', 'indexOf', 'join', 'keys', 'lastIndexOf', 'map', 'reduce', 'reduceRight', 'slice', 'some', 'values']);
 // const ARRAY_SETTER_METHODS = new Set<KeyType>(['push', 'pop', 'unshift', 'shift', 'splice', 'sort']);
@@ -61,11 +61,8 @@ class ManagedArray {
     this[SOURCE] = data?.slice();
     const IS_EDITABLE = this[Editable] = editable ?? false;
     this[Legacy] = legacy;
-    // FIXME probably can get rid of the manual ARRAY_SIGNAL storage
-    // FIXME probably the storage should be on the proxy/receiver not this class
     const signals = withSignalStore(this);
-    const _SIGNAL = this[ARRAY_SIGNAL] = entangleSignal(signals, this, ARRAY_SIGNAL, undefined);
+    let _SIGNAL = null;
     const boundFns = new Map();
     this.identifier = identifier;
     this.path = path;
@@ -81,6 +78,7 @@ class ManagedArray {
     // into two separate methods.
     Map;
     const ManagedRecordRefs = isSchemaArray ? new RefStorage() : null;
+    const extensions = legacy ? schema.CAUTION_MEGA_DANGER_ZONE_arrayExtensions(field) : null;
     const proxy = new Proxy(this[SOURCE], {
       get(target, prop, receiver) {
         if (prop === ARRAY_SIGNAL) {
@@ -101,6 +99,10 @@ class ManagedArray {
             self[SOURCE].push(...newData);
           }
         }
+        if (prop === 'length') {
+          return consumeInternalSignal(_SIGNAL), target.length;
+        }
+        if (prop === '[]') return consumeInternalSignal(_SIGNAL), receiver;
         if (index !== null) {
           let val;
           if (mode === '@hash') {
@@ -159,7 +161,7 @@ class ManagedArray {
                 record = new ReactiveResource(store, recordIdentifier, {
                   [Editable]: self.owner[Editable],
                   [Legacy]: self.owner[Legacy]
-                }, true, field.type, recordPath);
+                }, true, field, recordPath);
                 // if mode is not @identity or @index, then access the key path now
                 // to determine the key value.
                 // chris says we can implement this as a special kind `@hash` which
@@ -224,6 +226,9 @@ class ManagedArray {
           }
           return fn;
         }
+        if (isExtensionProp(extensions, prop)) {
+          return performArrayExtensionGet(receiver, extensions, signals, prop, _SIGNAL, boundFns, v => void (transaction = v));
+        }
         return Reflect.get(target, prop, receiver);
       },
       set(target, prop, value, receiver) {
@@ -235,15 +240,16 @@ class ManagedArray {
           throw new Error(`Cannot set ${String(prop)} on ${errorPath} because the record is not editable`);
         }
         if (prop === 'identifier') {
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           self.identifier = value;
           return true;
         }
         if (prop === 'owner') {
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           self.owner = value;
           return true;
         }
+        if (isExtensionProp(extensions, prop)) {
+          return performExtensionSet(receiver, extensions, signals, prop, value);
+        }
         const reflect = Reflect.set(target, prop, value, receiver);
         if (reflect) {
           if (!field.type) {
@@ -271,9 +277,31 @@ class ManagedArray {
         return Reflect.has(target, prop);
       }
     });
+    // we entangle the signal on the returned proxy since that is
+    // the object that other code will be interfacing with.
+    _SIGNAL = entangleSignal(signals, proxy, ARRAY_SIGNAL, undefined);
     return proxy;
   }
 }
+// this will error if someone tries to call
+// A(identifierArray) since it is not configurable
+// which is preferable to the `meta` override we used
+// before which required importing all of Ember
+const desc = {
+  enumerable: true,
+  configurable: false,
+  get: function () {
+    // here to support computed chains
+    // and {{#each}}
+    if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_COMPUTED_CHAINS)) {
+      return this;
+    }
+  }
+};
+// compat(desc);
+Object.defineProperty(ManagedArray.prototype, '[]', desc);
 const ObjectSymbols = new Set([OBJECT_SIGNAL, Parent, SOURCE, Editable, EmbeddedPath]);
 // const ignoredGlobalFields = new Set<string>(['setInterval', 'nodeType', 'nodeName', 'length', 'document', STRUCTURED]);
@@ -291,6 +319,9 @@ class ManagedObject {
     this[Legacy] = legacy;
     this[Parent] = identifier;
     this[EmbeddedPath] = path;
+    // prettier-ignore
+    const extensions = !legacy ? null : schema.CAUTION_MEGA_DANGER_ZONE_objectExtensions(field);
     const proxy = new Proxy(this[SOURCE], {
       ownKeys() {
         return Object.keys(self[SOURCE]);
@@ -328,11 +359,6 @@ class ManagedObject {
             return '<span>ManagedObject</span>';
           };
         }
-        if (prop === 'toJSON') {
-          return function () {
-            return structuredClone(self[SOURCE]);
-          };
-        }
         if (_SIGNAL.isStale) {
           _SIGNAL.isStale = false;
           let newData = cache.getAttr(identifier, path);
@@ -346,10 +372,22 @@ class ManagedObject {
             }; // Add type assertion for newData
           }
         }
+        // toJSON and extensions need to come after we update data if stale
+        if (prop === 'toJSON') {
+          return function () {
+            return structuredClone(self[SOURCE]);
+          };
+        }
+        // we always defer to data before extensions
         if (prop in self[SOURCE]) {
           consumeInternalSignal(_SIGNAL);
           return self[SOURCE][prop];
         }
+        if (isExtensionProp(extensions, prop)) {
+          return performObjectExtensionGet(receiver, extensions, signals, prop);
+        }
         return Reflect.get(target, prop, receiver);
       },
       set(target, prop, value, receiver) {
@@ -358,6 +396,12 @@ class ManagedObject {
             throw new Error(`Cannot set read-only property '${String(prop)}' on ManagedObject`);
           }
         })(editable) : {};
+        // since objects function as dictionaries, we can't defer to schema/data before extensions
+        // unless the prop is in the existing data.
+        if (!(prop in self[SOURCE]) && isExtensionProp(extensions, prop)) {
+          return performExtensionSet(receiver, extensions, signals, prop, value);
+        }
         const reflect = Reflect.set(target, prop, value, receiver);
         if (!reflect) {
           return false;
@@ -553,7 +597,7 @@ function computeSchemaObject(store, cache, record, identifier, field, path, lega
     schemaObject = new ReactiveResource(store, identifier, {
       [Editable]: editable,
       [Legacy]: legacy
-    }, true, field.type, embeddedPath);
+    }, true, field, embeddedPath);
   }
   if (!schemaObjectMapForRecord) {
     ManagedObjectMap.set(record, new Map([[field.name, schemaObject]]));
@@ -645,6 +689,7 @@ function computeHasMany(store, schema, cache, record, identifier, field, path, e
       type: field.type,
       identifier,
       cache,
+      field: legacy ? field : undefined,
       // we divorce the reference here because ManyArray mutates the target directly
       // before sending the mutation op to the cache. We may be able to avoid this in the future
       identifiers: rawValue.data?.slice(),
@@ -669,7 +714,7 @@ function computeHasMany(store, schema, cache, record, identifier, field, path, e
   return managedArray;
 }
 const IgnoredGlobalFields = new Set(['length', 'nodeType', 'then', 'setInterval', 'document', STRUCTURED]);
-const symbolList = [Destroy, RecordStore, Identifier, Editable, Parent, Checkout, Legacy, EmbeddedPath, EmbeddedType];
+const symbolList = [Destroy, RecordStore, Identifier, Editable, Parent, Checkout, Legacy, EmbeddedPath, EmbeddedField];
 const RecordSymbols = new Set(symbolList);
 function isPathMatch(a, b) {
   return a.length === b.length && a.every((v, i) => v === b[i]);
@@ -707,7 +752,7 @@ class ReactiveResource {
   /** @internal */
-  constructor(store, identifier, Mode, isEmbedded = false, embeddedType = null, embeddedPath = null) {
+  constructor(store, identifier, Mode, isEmbedded = false, embeddedField = null, embeddedPath = null) {
     // eslint-disable-next-line @typescript-eslint/no-this-alias
     const self = this;
     this[RecordStore] = store;
@@ -720,15 +765,14 @@ class ReactiveResource {
     this[Legacy] = Mode[Legacy] ?? false;
     const schema = store.schema;
     const cache = store.cache;
-    const identityField = schema.resource(isEmbedded ? {
-      type: embeddedType
-    } : identifier).identity;
+    const identityField = schema.resource(isEmbedded ? embeddedField : identifier).identity;
     const BoundFns = new Map();
-    this[EmbeddedType] = embeddedType;
+    // prettier-ignore
+    const extensions = !Mode[Legacy] ? null : isEmbedded ? schema.CAUTION_MEGA_DANGER_ZONE_objectExtensions(embeddedField) : schema.CAUTION_MEGA_DANGER_ZONE_resourceExtensions(identifier);
+    this[EmbeddedField] = embeddedField;
     this[EmbeddedPath] = embeddedPath;
-    const fields = isEmbedded ? schema.fields({
-      type: embeddedType
-    }) : schema.fields(identifier);
+    const fields = isEmbedded ? schema.fields(embeddedField) : schema.fields(identifier);
     const signals = withSignalStore(this);
     const proxy = new Proxy(this, {
       ownKeys() {
@@ -880,11 +924,15 @@ class ReactiveResource {
           if (prop === 'constructor') {
             return ReactiveResource;
           }
+          if (isExtensionProp(extensions, prop)) {
+            return performObjectExtensionGet(receiver, extensions, signals, prop);
+          }
           // too many things check for random symbols
           if (typeof prop === 'symbol') return undefined;
           macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
             {
-              throw new Error(`No field named ${String(prop)} on ${isEmbedded ? embeddedType : identifier.type}`);
+              throw new Error(`No field named ${String(prop)} on ${isEmbedded ? embeddedField.type : identifier.type}`);
             }
           })() : {};
           return undefined;
@@ -967,13 +1015,21 @@ class ReactiveResource {
       },
       set(target, prop, value, receiver) {
         if (!IS_EDITABLE) {
-          const type = isEmbedded ? embeddedType : identifier.type;
+          const type = isEmbedded ? embeddedField.type : identifier.type;
           throw new Error(`Cannot set ${String(prop)} on ${type} because the record is not editable`);
         }
         const maybeField = prop === identityField?.name ? identityField : fields.get(prop);
         if (!maybeField) {
-          const type = isEmbedded ? embeddedType : identifier.type;
-          throw new Error(`There is no field named ${String(prop)} on ${type}`);
+          const type = isEmbedded ? embeddedField.type : identifier.type;
+          if (isExtensionProp(extensions, prop)) {
+            return performExtensionSet(receiver, extensions, signals, prop, value);
+          }
+          macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+            {
+              throw new Error(`There is no settable field named ${String(prop)} on ${type}`);
+            }
+          })() : {};
+          return false;
         }
         const field = maybeField.kind === 'alias' ? maybeField.options : maybeField;
         macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -1356,7 +1412,7 @@ class ReactiveResource {
     if (editable) {
       return Promise.resolve(editable);
     }
-    const embeddedType = this[EmbeddedType];
+    const embeddedType = this[EmbeddedField];
     const embeddedPath = this[EmbeddedPath];
     const isEmbedded = embeddedType !== null && embeddedPath !== null;
     if (isEmbedded) {
@@ -1438,6 +1494,139 @@ function _constructor(record) {
 }
 _constructor[Type] = '@constructor';
+/**
+ * Extensions allow providing non-schema driven behaviors to
+ * reactive resources and arrays.
+ */
+const BannedKeys = ['constructor', '__proto__'];
+function processExtension(extension) {
+  const {
+    kind,
+    name
+  } = extension;
+  const features = new Map();
+  const baseFeatures = typeof extension.features === 'function' ? extension.features.prototype : extension.features;
+  for (const key of Object.getOwnPropertyNames(baseFeatures)) {
+    if (BannedKeys.includes(key)) continue;
+    const decl = Object.getOwnPropertyDescriptor(baseFeatures, key);
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      if (!test) {
+        throw new Error(`Expected to find a declaration for ${key} on extension ${name}`);
+      }
+    })(decl) : {};
+    if (decl.value) {
+      const {
+        value
+      } = decl;
+      features.set(key, typeof value === 'function' ? {
+        kind: 'method',
+        fn: value
+      } : decl.writable ? {
+        kind: 'mutable-value',
+        value
+      } : {
+        kind: 'readonly-value',
+        value
+      });
+      continue;
+    }
+    if (decl.get || decl.set) {
+      const {
+        get,
+        set
+      } = decl;
+      features.set(key,
+      // prettier-ignore
+      get && set ? {
+        kind: 'mutable-field',
+        get,
+        set
+      } : get ? {
+        kind: 'readonly-field',
+        get
+      } : {
+        kind: 'writeonly-field',
+        set: set
+      });
+      continue;
+    }
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      {
+        throw new Error(`The feature ${key} on extension ${name} is of an unknown variety.`);
+      }
+    })() : {};
+  }
+  return {
+    kind,
+    name,
+    features
+  };
+}
+function getExt(extCache, type, extName) {
+  const ext = extCache[type].get(extName);
+  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+    if (!test) {
+      throw new Error(`expected to have an extension named ${String(extName)} available for ${type}s`);
+    }
+  })(ext) : {};
+  return ext?.features ?? null;
+}
+function hasObjectSchema(field) {
+  return 'kind' in field && (field.kind === 'schema-array' || field.kind === 'schema-object');
+}
+function processExtensions(schema, field, scenario) {
+  // if we're looking up extensions for a resource, there is no
+  // merging required so if we have no objectExtensions
+  // we are done.
+  if (scenario === 'resource') {
+    if (!('objectExtensions' in field || !field.objectExtensions?.length)) {
+      return null;
+    }
+  }
+  const type = scenario === 'resource' ? 'object' : scenario;
+  const extCache = schema._extensions;
+  const fieldCache = schema._cachedFieldExtensionsByField;
+  if (fieldCache[type].has(field)) {
+    return fieldCache[type].get(field);
+  }
+  // prettier-ignore
+  const extensions = (scenario === 'resource' ? field.objectExtensions : scenario === 'object' ? field.options?.objectExtensions : field.options?.arrayExtensions) || null;
+  // if we are a resource scenario, we know from the first check we do have extensions
+  // if we are an object scenario, we can now return the resource scenario.
+  // if we are an array scenario, there is nothing more to process.
+  if (!extensions) {
+    if (scenario === 'array') return null;
+    if (!hasObjectSchema(field)) {
+      return null;
+    }
+    return schema.CAUTION_MEGA_DANGER_ZONE_resourceExtensions(field);
+  }
+  // if we have made it here, we have extensions, lets check if there's
+  // a cached version we can use
+  const baseExtensions = scenario === 'resource' && hasObjectSchema(field) ? schema.CAUTION_MEGA_DANGER_ZONE_resourceExtensions(field) : scenario === 'object' && hasObjectSchema(field) ? schema.CAUTION_MEGA_DANGER_ZONE_resourceExtensions(field) : null;
+  if (!baseExtensions && extensions.length === 1) {
+    const value = getExt(extCache, type, extensions[0]);
+    fieldCache[type].set(field, value);
+    return value;
+  }
+  const features = new Map(baseExtensions);
+  for (const extName of extensions) {
+    const value = getExt(extCache, type, extName);
+    if (value) {
+      for (const [feature, desc] of value) {
+        features.set(feature, desc);
+      }
+    }
+  }
+  const value = features.size ? features : null;
+  fieldCache[type].set(field, value);
+  return value;
+}
 /**
  * Utility for constructing a ResourceSchema with the recommended
  * fields for the PolarisMode experience.
@@ -1559,6 +1748,8 @@ class SchemaService {
   /** @internal */
+  /** @internal */
   constructor() {
     this._schemas = new Map();
     this._transforms = new Map();
@@ -1566,6 +1757,14 @@ class SchemaService {
     this._derivations = new Map();
     this._traits = new Set();
     this._modes = new Map();
+    this._extensions = {
+      object: new Map(),
+      array: new Map()
+    };
+    this._cachedFieldExtensionsByField = {
+      object: new Map(),
+      array: new Map()
+    };
   }
   resourceTypes() {
     return Array.from(this._schemas.keys());
@@ -1687,6 +1886,24 @@ class SchemaService {
   registerDerivation(derivation) {
     this._derivations.set(derivation[Type], makeCachedDerivation(derivation));
   }
+  CAUTION_MEGA_DANGER_ZONE_registerExtension(extension) {
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      if (!test) {
+        throw new Error(`an extension named ${extension.name} for ${extension.kind} already exists!`);
+      }
+    })(!this._extensions[extension.kind].has(extension.name)) : {};
+    this._extensions[extension.kind].set(extension.name, processExtension(extension));
+  }
+  CAUTION_MEGA_DANGER_ZONE_resourceExtensions(resource) {
+    const schema = this.resource(resource);
+    return processExtensions(this, schema, 'resource');
+  }
+  CAUTION_MEGA_DANGER_ZONE_objectExtensions(field) {
+    return processExtensions(this, field, 'object');
+  }
+  CAUTION_MEGA_DANGER_ZONE_arrayExtensions(field) {
+    return processExtensions(this, field, 'array');
+  }
   /**
    * This is an internal method used to register behaviors for legacy mode.
@@ -1704,7 +1921,7 @@ class SchemaService {
       if (!test) {
         throw new Error(`Mode '${mode}' is already registered`);
       }
-    })(!this._traits.has(mode)) : {};
+    })(!this._modes.has(mode)) : {};
     this._modes.set(mode, kinds);
   }