@craft-ts/core 0.7.0-beta.13

package/src/lib/resource-by-id.js

@@ -0,0 +1,294 @@
+import { inject, signal, effect, untracked, Injector, InjectionToken, computed, } from './host/craft-compat';
+import { craftLinkedSignal as linkedSignal } from './host/craft-linked-signal';
+import { preservedResource } from './preserved-resource';
+import { resourceByIdChangesTracker, } from './util/resource-by-id-changes-tracker.util';
+export function resourceById(config) {
+    const injector = inject(Injector);
+    const { identifier, params, loader, stream, equalParams, ssrSourceName } = config;
+    const fromResourceById = 'fromResourceById' in config ? config.fromResourceById : undefined;
+    // maybe create a linkedSignal to enable to reset
+    const resourceByGroup = signal({});
+    const linkedParamsByGroup = new Map();
+    const rememberLinkedParams = (group, linked) => {
+        linkedParamsByGroup.get(group)?.destroy();
+        linkedParamsByGroup.set(group, linked);
+    };
+    const destroyLinkedParams = (group) => {
+        linkedParamsByGroup.get(group)?.destroy();
+        linkedParamsByGroup.delete(group);
+    };
+    const destroyAllLinkedParams = () => {
+        linkedParamsByGroup.forEach((linked) => linked.destroy());
+        linkedParamsByGroup.clear();
+    };
+    const resourceEqualParams = equalParams === 'useIdentifier'
+        ? (a, b) => a && b && identifier(a) === identifier(b)
+        : equalParams;
+    // this effect is used to create a mapped CraftResourceRef instance
+    if (!fromResourceById) {
+        effect(() => {
+            //@ts-expect-error TypeScript misinterpreting, params here has no parameter
+            const requestValue = params();
+            if (!requestValue) {
+                return;
+            }
+            const group = identifier(requestValue);
+            // The effect should only trigger when the request change
+            const resourceByGroupValue = untracked(() => resourceByGroup());
+            const groupCraftResourceRefExist = resourceByGroupValue[group];
+            if (groupCraftResourceRefExist) {
+                // nothing to do, the resource is already bind with the request
+                return;
+            }
+            const filteredRequestByGroup = linkedSignal({
+                source: params,
+                injector,
+                computation: (incomingRequestValue, previousGroupRequestData) => {
+                    if (!incomingRequestValue) {
+                        return incomingRequestValue;
+                    }
+                    // filter the request push a value by comparing with the current group
+                    if (identifier(incomingRequestValue) !== group) {
+                        return previousGroupRequestData?.value;
+                    }
+                    // The request push a value that concerns the current group
+                    return incomingRequestValue;
+                },
+            });
+            rememberLinkedParams(group, filteredRequestByGroup);
+            const paramsWithEqualRule = computed(() => filteredRequestByGroup(), {
+                ...(equalParams !== 'default' && {
+                    equal: resourceEqualParams,
+                }),
+            });
+            const CraftResourceRef = createDynamicResource(injector, {
+                group,
+                resourceOptions: {
+                    loader,
+                    params: paramsWithEqualRule,
+                    stream,
+                    ssrSourceName,
+                },
+            });
+            // attach a new instance of CraftResourceRef to the resourceByGroup
+            resourceByGroup.update((state) => ({
+                ...state,
+                [group]: CraftResourceRef,
+            }));
+        });
+    }
+    const changesTracker = resourceByIdChangesTracker(resourceByGroup);
+    const stateSignal = computed(() => {
+        const resources = resourceByGroup();
+        const stateRecord = {};
+        for (const [key, resource] of Object.entries(resources)) {
+            if (resource) {
+                const craftResource = resource;
+                if (craftResource.hasValue()) {
+                    stateRecord[key] = craftResource.value();
+                }
+            }
+        }
+        return stateRecord;
+    });
+    const resourcesHandler = {
+        changes: changesTracker,
+        state: stateSignal,
+        reset: () => {
+            destroyAllLinkedParams();
+            Object.values(resourceByGroup()).forEach((resource) => resource.destroy());
+            resourceByGroup.set({});
+        },
+        resetResource: (id) => {
+            destroyLinkedParams(id);
+            resourceByGroup.update((state) => {
+                const newState = { ...state };
+                newState[id]?.destroy();
+                delete newState[id];
+                return newState;
+            });
+        },
+        set: (payload) => {
+            // Remove existing keys that are not in the payload
+            const currentResources = resourceByGroup();
+            Object.keys(currentResources).forEach((id) => {
+                if (!(id in payload)) {
+                    resourcesHandler.resetResource(id);
+                }
+            });
+            // Set or create resources from the payload
+            Object.entries(payload).forEach(([id, value]) => {
+                const existingResource = resourceByGroup()[id];
+                if (existingResource) {
+                    existingResource.set(value);
+                }
+                else {
+                    // If the resource doesn't exist, create it with the provided value as default
+                    resourcesHandler.addById(id, {
+                        defaultValue: value,
+                    });
+                }
+            });
+        },
+        update: (payload) => {
+            const nextState = payload(stateSignal());
+            resourcesHandler.set(nextState);
+        },
+        add: (resourceParams, options) => {
+            const group = identifier(resourceParams);
+            if (resourceByGroup()[group]) {
+                return resourceByGroup()[group];
+            }
+            //@ts-expect-error ! It does not handle the case when fromResourceById is provided
+            const computedParam = computed(() => params() ?? resourceParams);
+            const filteredGlobalParamsByGroup = linkedSignal({
+                source: computedParam,
+                injector,
+                computation: (incomingParamsValue, previousGroupParamsData) => {
+                    if (!incomingParamsValue) {
+                        return incomingParamsValue;
+                    }
+                    // filter the request push a value by comparing with the current group
+                    if (identifier(incomingParamsValue) !== group) {
+                        return (previousGroupParamsData?.value ??
+                            resourceParams);
+                    }
+                    // The request push a value that concerns the current group
+                    return incomingParamsValue;
+                },
+            });
+            rememberLinkedParams(group, filteredGlobalParamsByGroup);
+            // ! without pulling the signal here, it is not possible to load multiples resources in the same cycle
+            const _pull_filteredGlobalParamsByGroup = filteredGlobalParamsByGroup();
+            const paramsWithEqualRule = computed(filteredGlobalParamsByGroup, 
+            //@ts-expect-error TypeScript misinterpreting
+            {
+                ...(equalParams !== 'default' && {
+                    equal: resourceEqualParams,
+                }),
+            });
+            const CraftResourceRef = createDynamicResource(injector, {
+                group,
+                resourceOptions: {
+                    loader,
+                    params: paramsWithEqualRule,
+                    stream,
+                    defaultValue: options?.defaultValue,
+                },
+            });
+            resourceByGroup.update((state) => ({
+                ...state,
+                [group]: CraftResourceRef,
+            }));
+            return CraftResourceRef;
+        },
+        addById: (group, options) => {
+            // Check if the resource already exist
+            const existing = resourceByGroup()[group];
+            if (existing) {
+                // A global params watch may have created this entry just before a
+                // persister restores its cached value. Apply that value to the
+                // existing ref as well; otherwise the restore is silently discarded
+                // and the in-flight request wins with a loading status.
+                if (options?.defaultValue !== undefined && !existing.hasValue()) {
+                    existing.set(options.defaultValue);
+                }
+                return existing;
+            }
+            const filteredGlobalParamsByGroup = linkedSignal({
+                source: () => params(options?.paramsFromResourceById),
+                injector,
+                computation: (incomingParamsValue, previousGroupParamsData) => {
+                    if (!incomingParamsValue) {
+                        return incomingParamsValue ?? options?.defaultParam;
+                    }
+                    // filter the request push a value by comparing with the current group
+                    if (identifier(incomingParamsValue) !== group) {
+                        return (previousGroupParamsData?.value ??
+                            options?.defaultParam);
+                    }
+                    // The request push a value that concerns the current group
+                    return incomingParamsValue;
+                },
+            });
+            rememberLinkedParams(group, filteredGlobalParamsByGroup);
+            // ! without pulling the signal here, it is not possible to load multiples resources in the same cycle
+            const _pull_filteredGlobalParamsByGroup = filteredGlobalParamsByGroup();
+            const paramsWithEqualRule = computed(filteredGlobalParamsByGroup, 
+            //@ts-expect-error TypeScript misinterpreting
+            {
+                ...(equalParams !== 'default' && {
+                    equal: resourceEqualParams,
+                }),
+            });
+            const CraftResourceRef = createDynamicResource(injector, {
+                group,
+                resourceOptions: {
+                    loader,
+                    params: paramsWithEqualRule,
+                    stream,
+                    defaultValue: options?.defaultValue,
+                },
+            });
+            if (options?.defaultValue !== undefined) {
+                CraftResourceRef.set(options.defaultValue);
+            }
+            resourceByGroup.update((state) => ({
+                ...state,
+                [group]: CraftResourceRef,
+            }));
+            return CraftResourceRef;
+        },
+    };
+    if (!fromResourceById) {
+        return Object.assign(resourceByGroup.asReadonly(), resourcesHandler);
+    }
+    effect(() => {
+        const fromResourceByIdValue = fromResourceById?.();
+        if (!fromResourceByIdValue) {
+            return;
+        }
+        const resourceByGroupValue = resourceByGroup();
+        Object.entries(fromResourceByIdValue).forEach(([key, resource]) => {
+            const currentParams = params(resource);
+            if (!currentParams) {
+                return;
+            }
+            untracked(() => {
+                const group = identifier(currentParams);
+                const existingCraftResourceRef = resourceByGroupValue[group];
+                if (existingCraftResourceRef) {
+                    return;
+                }
+                resourcesHandler.addById(group, {
+                    paramsFromResourceById: resource,
+                });
+            });
+        });
+    });
+    return Object.assign(resourceByGroup.asReadonly(), resourcesHandler);
+}
+const RESOURCE_INSTANCE_TOKEN = new InjectionToken('Injection token used to provide a dynamically created CraftResourceRef instance.');
+/**
+ * It is not possible to instantiate a resource from within an effect directly:
+ * NG0602: effect() cannot be called from within a reactive context.
+ *
+ * The workaround is to create a dynamic injection token using a factory function,
+ * which instantiates the resource using the provided configuration.
+ *
+ * Maybe their is a better way to instantiate a resource dynamically.
+ */
+function createDynamicResource(parentInjector, resourceConfig) {
+    const injector = Injector.create({
+        providers: [
+            {
+                provide: RESOURCE_INSTANCE_TOKEN,
+                useFactory: () => preservedResource(resourceConfig.resourceOptions),
+            },
+        ],
+        parent: parentInjector,
+    });
+    const CraftResourceRef = injector.get(RESOURCE_INSTANCE_TOKEN);
+    return CraftResourceRef;
+}
+//# sourceMappingURL=resource-by-id.js.map

package/src/lib/resource-by-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-by-id.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/resource-by-id.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  inject,\n  signal,\n  ResourceOptions,\n  effect,\n  untracked,\n  Injector,\n  InjectionToken,\n  WritableSignal,\n  computed,\n  Signal,\n} from './host/craft-compat';\nimport { craftLinkedSignal as linkedSignal } from './host/craft-linked-signal';\nimport { preservedResource } from './preserved-resource';\nimport { Prettify } from './util/util.type';\nimport { CraftResourceRef } from './util/craft-resource-ref';\nimport {\n  resourceByIdChangesTracker,\n  resourceByIdChangesTrackerResult,\n} from './util/resource-by-id-changes-tracker.util';\n\nexport type ResourceByIdHandler<\n  GroupIdentifier extends string,\n  State,\n  ResourceParams,\n> = {\n  /**\n   * Reset all the CraftResourceRef instance stored in the ResourceByIdRef\n   */\n  reset: () => void;\n  /**\n   * Reset the CraftResourceRef instance associated with the provided id\n   */\n  resetResource: (id: GroupIdentifier) => void;\n  /**\n   * Add a new CraftResourceRef instance\n   */\n  add: (\n    // todo pass params instead of id and create the id from the params using the identifier function\n    params: ResourceParams,\n    options?: {\n      defaultValue?: State;\n    },\n  ) => CraftResourceRef<State, ResourceParams>;\n  /**\n   * ! The added resource may not load immediately if the global params do not match the identifier function.\n   * Useful at the app initialization when the resource value is retrieved from a persister for example.\n   */\n  addById: (\n    id: GroupIdentifier,\n    options?: {\n      defaultParam?: ResourceParams;\n      defaultValue?: State;\n      paramsFromResourceById?: CraftResourceRef<unknown, unknown>;\n    },\n  ) => CraftResourceRef<State, ResourceParams>;\n  /**\n   * Set the values of multiple resources. If a resource doesn't exist, it will be created.\n   */\n  set: (payload: Partial<Record<GroupIdentifier, State>>) => void;\n  /**\n   * Update values of multiple resources without removing existing ones.\n   * If a resource doesn't exist, it will be created.\n   */\n  update: (\n    payload: (\n      state: Partial<Record<GroupIdentifier, State>>,\n    ) => Partial<Record<GroupIdentifier, State>>,\n  ) => void;\n  /**\n   * Tracks the status and value changes of resources.\n   * Provides signals for hasChange, ids, resolved, loading, reloading, error, and onlyValueChange.\n   */\n  changes: resourceByIdChangesTrackerResult<GroupIdentifier>;\n  /**\n   * A computed signal that returns a record of all resource states by their group identifier.\n   */\n  state: Signal<Partial<Record<GroupIdentifier, State>>>;\n};\n\nexport type Identifier<ResourceParams, GroupIdentifier> = (\n  request: NonNullable<ResourceParams>,\n) => GroupIdentifier;\n\nexport type ResourceByIdRef<\n  GroupIdentifier extends string,\n  State,\n  ResourceParams,\n> = Signal<\n  // expose a signal instead of a writableSignal to avoid typing conflicts\n  Prettify<\n    Partial<Record<GroupIdentifier, CraftResourceRef<State, ResourceParams>>>\n  >\n> &\n  ResourceByIdHandler<GroupIdentifier, State, ResourceParams>;\n\nexport type EqualParams<ResourceParams, GroupIdentifier extends string> =\n  | 'default'\n  | 'useIdentifier'\n  | ((\n      a: ResourceParams,\n      b: ResourceParams,\n      identifierFn: (params: ResourceParams) => GroupIdentifier,\n    ) => boolean);\n\ntype ResourceByIdConfig<\n  State,\n  ResourceParams,\n  GroupIdentifier extends string,\n  FromObjectGroupIdentifier extends string,\n  FromObjectState,\n  FromObjectResourceParams,\n> = Omit<ResourceOptions<State, ResourceParams>, 'params'> & {\n  /** @internal Shared source name used by the server policy gate. */\n  ssrSourceName?: string;\n} & (\n    | {\n        fromResourceById?: never;\n        params: () => ResourceParams;\n        identifier: Identifier<NoInfer<ResourceParams>, GroupIdentifier>;\n        equalParams?: EqualParams<ResourceParams, GroupIdentifier>;\n      }\n    | {\n        /**\n         * Use it, when you need to bind a ResourceByIdRef to another ResourceByIdRef.\n         * It will kill the fromObject keys syncing when the fromObject resource change.\n         */\n        fromResourceById: ResourceByIdRef<\n          FromObjectGroupIdentifier,\n          FromObjectState,\n          FromObjectResourceParams\n        >;\n        params: (\n          entity: CraftResourceRef<\n            NoInfer<FromObjectState>,\n            NoInfer<FromObjectResourceParams>\n          >,\n        ) => ResourceParams;\n        identifier: Identifier<NoInfer<ResourceParams>, GroupIdentifier>;\n        equalParams?: EqualParams<ResourceParams, GroupIdentifier>;\n      }\n  );\n\nexport function resourceById<\n  State,\n  ResourceParams,\n  GroupIdentifier extends string,\n  FromObjectGroupIdentifier extends string,\n  FromObjectState,\n  FromObjectResourceParams,\n>(\n  config: ResourceByIdConfig<\n    State,\n    ResourceParams,\n    GroupIdentifier,\n    FromObjectGroupIdentifier,\n    FromObjectState,\n    FromObjectResourceParams\n  >,\n): ResourceByIdRef<GroupIdentifier, State, ResourceParams> {\n  const injector = inject(Injector);\n  const { identifier, params, loader, stream, equalParams, ssrSourceName } =\n    config;\n  const fromResourceById =\n    'fromResourceById' in config ? config.fromResourceById : undefined;\n\n  // maybe create a linkedSignal to enable to reset\n  const resourceByGroup = signal<\n    Partial<Record<GroupIdentifier, CraftResourceRef<State, ResourceParams>>>\n  >({});\n  const linkedParamsByGroup = new Map<GroupIdentifier, { destroy(): void }>();\n  const rememberLinkedParams = (\n    group: GroupIdentifier,\n    linked: { destroy(): void },\n  ): void => {\n    linkedParamsByGroup.get(group)?.destroy();\n    linkedParamsByGroup.set(group, linked);\n  };\n  const destroyLinkedParams = (group: GroupIdentifier): void => {\n    linkedParamsByGroup.get(group)?.destroy();\n    linkedParamsByGroup.delete(group);\n  };\n  const destroyAllLinkedParams = (): void => {\n    linkedParamsByGroup.forEach((linked) => linked.destroy());\n    linkedParamsByGroup.clear();\n  };\n\n  const resourceEqualParams =\n    equalParams === 'useIdentifier'\n      ? (a: NonNullable<ResourceParams>, b: NonNullable<ResourceParams>) =>\n          a && b && identifier(a) === identifier(b)\n      : equalParams;\n\n  // this effect is used to create a mapped CraftResourceRef instance\n  if (!fromResourceById) {\n    effect(() => {\n      //@ts-expect-error TypeScript misinterpreting, params here has no parameter\n      const requestValue = params();\n      if (!requestValue) {\n        return;\n      }\n      const group = identifier(requestValue);\n\n      // The effect should only trigger when the request change\n      const resourceByGroupValue = untracked(() => resourceByGroup());\n      const groupCraftResourceRefExist = resourceByGroupValue[group];\n      if (groupCraftResourceRefExist) {\n        // nothing to do, the resource is already bind with the request\n        return;\n      }\n\n      const filteredRequestByGroup = linkedSignal({\n        source: params as () => ResourceParams,\n        injector,\n        computation: (incomingRequestValue, previousGroupRequestData) => {\n          if (!incomingRequestValue) {\n            return incomingRequestValue;\n          }\n          // filter the request push a value by comparing with the current group\n          if (identifier(incomingRequestValue) !== group) {\n            return previousGroupRequestData?.value;\n          }\n          // The request push a value that concerns the current group\n          return incomingRequestValue;\n        },\n      });\n      rememberLinkedParams(group, filteredRequestByGroup);\n\n      const paramsWithEqualRule = computed(() => filteredRequestByGroup(), {\n        ...(equalParams !== 'default' && {\n          equal: resourceEqualParams as (\n            a: ReturnType<typeof filteredRequestByGroup>,\n            b: ReturnType<typeof filteredRequestByGroup>,\n          ) => boolean,\n        }),\n      });\n\n      const CraftResourceRef = createDynamicResource(injector, {\n        group,\n        resourceOptions: {\n          loader,\n          params: paramsWithEqualRule as () => ResourceParams,\n          stream,\n          ssrSourceName,\n        },\n      });\n\n      // attach a new instance of CraftResourceRef to the resourceByGroup\n      resourceByGroup.update((state) => ({\n        ...state,\n        [group]: CraftResourceRef,\n      }));\n    });\n  }\n\n  const changesTracker = resourceByIdChangesTracker(resourceByGroup);\n\n  const stateSignal = computed(() => {\n    const resources = resourceByGroup();\n    const stateRecord: Partial<Record<GroupIdentifier, State>> = {};\n    for (const [key, resource] of Object.entries(resources)) {\n      if (resource) {\n        const craftResource = resource as CraftResourceRef<\n          State,\n          ResourceParams\n        >;\n        if (craftResource.hasValue()) {\n          stateRecord[key as GroupIdentifier] = craftResource.value();\n        }\n      }\n    }\n    return stateRecord;\n  });\n\n  const resourcesHandler: ResourceByIdHandler<\n    GroupIdentifier,\n    State,\n    ResourceParams\n  > = {\n    changes: changesTracker,\n    state: stateSignal,\n    reset: () => {\n      destroyAllLinkedParams();\n      Object.values(resourceByGroup()).forEach((resource) =>\n        (resource as CraftResourceRef<State, ResourceParams>).destroy(),\n      );\n      resourceByGroup.set({});\n    },\n    resetResource: (id: GroupIdentifier) => {\n      destroyLinkedParams(id);\n      resourceByGroup.update((state) => {\n        const newState = { ...state };\n        newState[id]?.destroy();\n        delete newState[id];\n        return newState;\n      });\n    },\n    set: (payload: Partial<Record<GroupIdentifier, State>>) => {\n      // Remove existing keys that are not in the payload\n      const currentResources = resourceByGroup();\n      Object.keys(currentResources).forEach((id) => {\n        if (!(id in payload)) {\n          resourcesHandler.resetResource(id as GroupIdentifier);\n        }\n      });\n\n      // Set or create resources from the payload\n      Object.entries(payload).forEach(([id, value]) => {\n        const existingResource = resourceByGroup()[id as GroupIdentifier];\n        if (existingResource) {\n          existingResource.set(value as State);\n        } else {\n          // If the resource doesn't exist, create it with the provided value as default\n          resourcesHandler.addById(id as GroupIdentifier, {\n            defaultValue: value as State,\n          });\n        }\n      });\n    },\n    update: (\n      payload: (\n        state: Partial<Record<GroupIdentifier, State>>,\n      ) => Partial<Record<GroupIdentifier, State>>,\n    ) => {\n      const nextState = payload(stateSignal());\n      resourcesHandler.set(nextState);\n    },\n    add: (resourceParams, options?: { defaultValue?: State }) => {\n      const group = identifier(resourceParams as any);\n      if (resourceByGroup()[group]) {\n        return resourceByGroup()[group] as CraftResourceRef<\n          State,\n          ResourceParams\n        >;\n      }\n\n      //@ts-expect-error ! It does not handle the case when fromResourceById is provided\n      const computedParam = computed(() => params() ?? resourceParams);\n      const filteredGlobalParamsByGroup = linkedSignal({\n        source: computedParam as () => ResourceParams,\n        injector,\n        computation: (incomingParamsValue, previousGroupParamsData) => {\n          if (!incomingParamsValue) {\n            return incomingParamsValue;\n          }\n          // filter the request push a value by comparing with the current group\n          if (identifier(incomingParamsValue) !== group) {\n            return (\n              (previousGroupParamsData?.value as ResourceParams) ??\n              resourceParams\n            );\n          }\n          // The request push a value that concerns the current group\n          return incomingParamsValue;\n        },\n      });\n      rememberLinkedParams(group, filteredGlobalParamsByGroup);\n      // ! without pulling the signal here, it is not possible to load multiples resources in the same cycle\n      const _pull_filteredGlobalParamsByGroup = filteredGlobalParamsByGroup();\n      const paramsWithEqualRule = computed(\n        filteredGlobalParamsByGroup as Signal<NonNullable<ResourceParams>>,\n        //@ts-expect-error TypeScript misinterpreting\n        {\n          ...(equalParams !== 'default' && {\n            equal: resourceEqualParams,\n          }),\n        },\n      );\n      const CraftResourceRef = createDynamicResource(injector, {\n        group,\n        resourceOptions: {\n          loader,\n          params: paramsWithEqualRule,\n          stream,\n          defaultValue: options?.defaultValue,\n        } as ResourceOptions<State, ResourceParams>,\n      });\n      resourceByGroup.update((state) => ({\n        ...state,\n        [group]: CraftResourceRef,\n      }));\n      return CraftResourceRef;\n    },\n    addById: (\n      group,\n      options?: {\n        defaultValue?: State;\n        defaultParam?: ResourceParams;\n        paramsFromResourceById?: CraftResourceRef<unknown, unknown>;\n      },\n    ) => {\n      // Check if the resource already exist\n      const existing = resourceByGroup()[group];\n      if (existing) {\n        // A global params watch may have created this entry just before a\n        // persister restores its cached value. Apply that value to the\n        // existing ref as well; otherwise the restore is silently discarded\n        // and the in-flight request wins with a loading status.\n        if (options?.defaultValue !== undefined && !existing.hasValue()) {\n          existing.set(options.defaultValue);\n        }\n        return existing as CraftResourceRef<State, ResourceParams>;\n      }\n      const filteredGlobalParamsByGroup = linkedSignal({\n        source: () =>\n          params(\n            options?.paramsFromResourceById as CraftResourceRef<\n              FromObjectState,\n              FromObjectResourceParams\n            >,\n          ),\n        injector,\n        computation: (incomingParamsValue, previousGroupParamsData) => {\n          if (!incomingParamsValue) {\n            return incomingParamsValue ?? options?.defaultParam;\n          }\n          // filter the request push a value by comparing with the current group\n          if (identifier(incomingParamsValue) !== group) {\n            return (\n              (previousGroupParamsData?.value as ResourceParams) ??\n              options?.defaultParam\n            );\n          }\n          // The request push a value that concerns the current group\n          return incomingParamsValue;\n        },\n      });\n      rememberLinkedParams(group, filteredGlobalParamsByGroup);\n\n      // ! without pulling the signal here, it is not possible to load multiples resources in the same cycle\n      const _pull_filteredGlobalParamsByGroup = filteredGlobalParamsByGroup();\n      const paramsWithEqualRule = computed(\n        filteredGlobalParamsByGroup as Signal<NonNullable<ResourceParams>>,\n        //@ts-expect-error TypeScript misinterpreting\n        {\n          ...(equalParams !== 'default' && {\n            equal: resourceEqualParams,\n          }),\n        },\n      );\n      const CraftResourceRef = createDynamicResource(injector, {\n        group,\n        resourceOptions: {\n          loader,\n          params: paramsWithEqualRule,\n          stream,\n          defaultValue: options?.defaultValue,\n        } as ResourceOptions<State, ResourceParams>,\n      });\n      if (options?.defaultValue !== undefined) {\n        CraftResourceRef.set(options.defaultValue);\n      }\n      resourceByGroup.update((state) => ({\n        ...state,\n        [group]: CraftResourceRef,\n      }));\n      return CraftResourceRef;\n    },\n  };\n\n  if (!fromResourceById) {\n    return Object.assign(resourceByGroup.asReadonly(), resourcesHandler);\n  }\n\n  effect(() => {\n    const fromResourceByIdValue = fromResourceById?.();\n    if (!fromResourceByIdValue) {\n      return;\n    }\n    const resourceByGroupValue = resourceByGroup();\n    Object.entries(fromResourceByIdValue).forEach(([key, resource]) => {\n      const currentParams = params(\n        resource as CraftResourceRef<FromObjectState, FromObjectResourceParams>,\n      );\n      if (!currentParams) {\n        return;\n      }\n\n      untracked(() => {\n        const group = identifier(currentParams as any);\n        const existingCraftResourceRef = resourceByGroupValue[group];\n        if (existingCraftResourceRef) {\n          return;\n        }\n        resourcesHandler.addById(group, {\n          paramsFromResourceById: resource as CraftResourceRef<\n            FromObjectState,\n            FromObjectResourceParams\n          >,\n        });\n      });\n    });\n  });\n\n  return Object.assign(resourceByGroup.asReadonly(), resourcesHandler);\n}\n\nconst RESOURCE_INSTANCE_TOKEN = new InjectionToken<\n  CraftResourceRef<unknown, unknown>\n>(\n  'Injection token used to provide a dynamically created CraftResourceRef instance.',\n);\n\ninterface DynamicResourceConfig<T, R, GroupIdentifier extends string> {\n  resourceOptions: ResourceOptions<T, R> & { ssrSourceName?: string };\n  group: GroupIdentifier;\n}\n\n/**\n * It is not possible to instantiate a resource from within an effect directly:\n * NG0602: effect() cannot be called from within a reactive context.\n *\n * The workaround is to create a dynamic injection token using a factory function,\n * which instantiates the resource using the provided configuration.\n *\n * Maybe their is a better way to instantiate a resource dynamically.\n */\nfunction createDynamicResource<T, R, GroupIdentifier extends string>(\n  parentInjector: Injector,\n  resourceConfig: DynamicResourceConfig<T, R, GroupIdentifier>,\n) {\n  const injector = Injector.create({\n    providers: [\n      {\n        provide: RESOURCE_INSTANCE_TOKEN,\n        useFactory: () => preservedResource(resourceConfig.resourceOptions),\n      },\n    ],\n    parent: parentInjector,\n  });\n\n  const CraftResourceRef = injector.get(RESOURCE_INSTANCE_TOKEN);\n  return CraftResourceRef as CraftResourceRef<T, R>;\n}\n"]}

package/src/lib/resource-exception.d.ts

@@ -0,0 +1,30 @@
+import { Signal } from './host/craft-compat';
+import { AnyCraftException } from './craft-exception';
+type ResourceExceptionScope = 'params' | 'loader';
+type ResourceExceptionsNoId = {
+    list: AnyCraftException[];
+    params: AnyCraftException | {};
+    loader: AnyCraftException | {};
+};
+type ResourceExceptionsById = {
+    list: AnyCraftException[];
+    params: AnyCraftException | {};
+    loader: Record<string, AnyCraftException>;
+};
+export declare function enrichResourceException(exception: AnyCraftException, meta: {
+    scope: ResourceExceptionScope;
+    identifier?: string;
+}): AnyCraftException;
+export declare function removeResourceExceptionById(state: Record<string, AnyCraftException>, id: string): Record<string, AnyCraftException>;
+export declare function createResourceExceptionsRuntime({ isUsingIdentifier, paramsException, }: {
+    isUsingIdentifier: boolean;
+    paramsException: Signal<AnyCraftException | undefined>;
+}): {
+    setLoaderException: (exception: AnyCraftException | undefined, id?: string) => void;
+    exceptions: import("..").ɵCraftSignal<ResourceExceptionsNoId | ResourceExceptionsById>;
+    hasException: import("..").ɵCraftSignal<boolean>;
+    createSelectExceptions: (id: string) => import("..").ɵCraftSignal<ResourceExceptionsNoId>;
+    createSelectHasException: (id: string) => import("..").ɵCraftSignal<true>;
+};
+export {};
+//# sourceMappingURL=resource-exception.d.ts.map

package/src/lib/resource-exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-exception.d.ts","sourceRoot":"","sources":["../../../../../libs/core/src/lib/resource-exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAU,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,KAAK,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,MAAM,EAAE,iBAAiB,GAAG,EAAE,CAAC;IAC/B,MAAM,EAAE,iBAAiB,GAAG,EAAE,CAAC;CAChC,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,MAAM,EAAE,iBAAiB,GAAG,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE;IACJ,KAAK,EAAE,sBAAsB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,iBAAiB,CAiBnB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACxC,EAAE,EAAE,MAAM,GACT,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAQnC;AAED,wBAAgB,+BAA+B,CAAC,EAC9C,iBAAiB,EACjB,eAAe,GAChB,EAAE;IACD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;CACxD;oCAKc,iBAAiB,GAAG,SAAS,OACnC,MAAM;;;iCAwDuB,MAAM;mCAcJ,MAAM;EAU7C"}

package/src/lib/resource-exception.js

@@ -0,0 +1,86 @@
+import { computed, signal } from './host/craft-compat';
+export function enrichResourceException(exception, meta) {
+    const nextException = {
+        ...exception,
+        scope: meta.scope,
+        [exception._tag]: exception.payload,
+    };
+    if (meta.identifier !== undefined) {
+        nextException.identifier = meta.identifier;
+    }
+    else {
+        delete nextException.identifier;
+    }
+    return nextException;
+}
+export function removeResourceExceptionById(state, id) {
+    if (!(id in state)) {
+        return state;
+    }
+    const nextState = { ...state };
+    delete nextState[id];
+    return nextState;
+}
+export function createResourceExceptionsRuntime({ isUsingIdentifier, paramsException, }) {
+    const loaderException = signal(undefined);
+    const loaderExceptionsById = signal({});
+    const setLoaderException = (exception, id) => {
+        if (isUsingIdentifier) {
+            if (!id) {
+                return;
+            }
+            loaderExceptionsById.update((state) => exception
+                ? { ...state, [id]: exception }
+                : removeResourceExceptionById(state, id));
+            return;
+        }
+        loaderException.set(exception);
+    };
+    const exceptions = computed(() => {
+        const paramsExceptionValue = paramsException();
+        if (isUsingIdentifier) {
+            const loaderExceptionsByIdValue = loaderExceptionsById();
+            return {
+                list: [
+                    ...(paramsExceptionValue ? [paramsExceptionValue] : []),
+                    ...Object.values(loaderExceptionsByIdValue),
+                ],
+                params: (paramsExceptionValue ?? {}),
+                loader: loaderExceptionsByIdValue,
+            };
+        }
+        const loaderExceptionValue = loaderException();
+        return {
+            list: [paramsExceptionValue, loaderExceptionValue].filter(Boolean),
+            params: (paramsExceptionValue ?? {}),
+            loader: (loaderExceptionValue ?? {}),
+        };
+    });
+    const hasException = computed(() => {
+        if (paramsException()) {
+            return true;
+        }
+        if (isUsingIdentifier) {
+            return Object.keys(loaderExceptionsById()).length > 0;
+        }
+        return !!loaderException();
+    });
+    const createSelectExceptions = (id) => computed(() => {
+        const paramsExceptionValue = paramsException();
+        const loaderExceptionValue = loaderExceptionsById()?.[id];
+        return {
+            list: [paramsExceptionValue, loaderExceptionValue].filter(Boolean),
+            params: (paramsExceptionValue ?? {}),
+            loader: (loaderExceptionValue ?? {}),
+        };
+    });
+    const createSelectHasException = (id) => computed(() => !!paramsException() || !!loaderExceptionsById()[id]);
+    return {
+        setLoaderException,
+        exceptions,
+        hasException,
+        createSelectExceptions,
+        createSelectHasException,
+    };
+}
+//# sourceMappingURL=resource-exception.js.map

package/src/lib/resource-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-exception.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/resource-exception.ts"],"names":[],"mappings":"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","sourcesContent":["import { computed, Signal, signal } from './host/craft-compat';\nimport { AnyCraftException } from './craft-exception';\n\ntype ResourceExceptionScope = 'params' | 'loader';\n\ntype ResourceExceptionsNoId = {\n  list: AnyCraftException[];\n  params: AnyCraftException | {};\n  loader: AnyCraftException | {};\n};\n\ntype ResourceExceptionsById = {\n  list: AnyCraftException[];\n  params: AnyCraftException | {};\n  loader: Record<string, AnyCraftException>;\n};\n\nexport function enrichResourceException(\n  exception: AnyCraftException,\n  meta: {\n    scope: ResourceExceptionScope;\n    identifier?: string;\n  },\n): AnyCraftException {\n  const nextException = {\n    ...exception,\n    scope: meta.scope,\n    [exception._tag]: exception.payload,\n  } as AnyCraftException & {\n    scope: ResourceExceptionScope;\n    identifier?: string;\n  };\n\n  if (meta.identifier !== undefined) {\n    nextException.identifier = meta.identifier;\n  } else {\n    delete nextException.identifier;\n  }\n\n  return nextException;\n}\n\nexport function removeResourceExceptionById(\n  state: Record<string, AnyCraftException>,\n  id: string,\n): Record<string, AnyCraftException> {\n  if (!(id in state)) {\n    return state;\n  }\n\n  const nextState = { ...state };\n  delete nextState[id];\n  return nextState;\n}\n\nexport function createResourceExceptionsRuntime({\n  isUsingIdentifier,\n  paramsException,\n}: {\n  isUsingIdentifier: boolean;\n  paramsException: Signal<AnyCraftException | undefined>;\n}) {\n  const loaderException = signal<AnyCraftException | undefined>(undefined);\n  const loaderExceptionsById = signal<Record<string, AnyCraftException>>({});\n\n  const setLoaderException = (\n    exception: AnyCraftException | undefined,\n    id?: string,\n  ) => {\n    if (isUsingIdentifier) {\n      if (!id) {\n        return;\n      }\n      loaderExceptionsById.update((state) =>\n        exception\n          ? { ...state, [id]: exception }\n          : removeResourceExceptionById(state, id),\n      );\n      return;\n    }\n\n    loaderException.set(exception);\n  };\n\n  const exceptions = computed<ResourceExceptionsNoId | ResourceExceptionsById>(\n    () => {\n      const paramsExceptionValue = paramsException();\n\n      if (isUsingIdentifier) {\n        const loaderExceptionsByIdValue = loaderExceptionsById();\n        return {\n          list: [\n            ...(paramsExceptionValue ? [paramsExceptionValue] : []),\n            ...Object.values(loaderExceptionsByIdValue),\n          ],\n          params: (paramsExceptionValue ?? {}) as AnyCraftException | {},\n          loader: loaderExceptionsByIdValue,\n        };\n      }\n\n      const loaderExceptionValue = loaderException();\n      return {\n        list: [paramsExceptionValue, loaderExceptionValue].filter(\n          Boolean,\n        ) as AnyCraftException[],\n        params: (paramsExceptionValue ?? {}) as AnyCraftException | {},\n        loader: (loaderExceptionValue ?? {}) as AnyCraftException | {},\n      };\n    },\n  );\n\n  const hasException = computed(() => {\n    if (paramsException()) {\n      return true;\n    }\n\n    if (isUsingIdentifier) {\n      return Object.keys(loaderExceptionsById()).length > 0;\n    }\n\n    return !!loaderException();\n  });\n\n  const createSelectExceptions = (id: string) =>\n    computed<ResourceExceptionsNoId>(() => {\n      const paramsExceptionValue = paramsException();\n      const loaderExceptionValue = loaderExceptionsById()?.[id];\n\n      return {\n        list: [paramsExceptionValue, loaderExceptionValue].filter(\n          Boolean,\n        ) as AnyCraftException[],\n        params: (paramsExceptionValue ?? {}) as AnyCraftException | {},\n        loader: (loaderExceptionValue ?? {}) as AnyCraftException | {},\n      };\n    });\n\n  const createSelectHasException = (id: string) =>\n    computed(() => !!paramsException() || !!loaderExceptionsById()[id]);\n\n  return {\n    setLoaderException,\n    exceptions,\n    hasException,\n    createSelectExceptions,\n    createSelectHasException,\n  };\n}\n"]}