@craft-ts/core 0.7.0-beta.13

package/src/lib/util/types/resource-by-id-config.type.d.ts

@@ -0,0 +1,115 @@
+import { ResourceLoaderParams, ResourceOptions, ResourceRef, ResourceStreamingLoader } from '../../host/craft-compat';
+import { ResourceMethod } from './shared.type';
+import { ResourceByIdRef } from '../../resource-by-id';
+export type ResourceByIdConfig<ResourceState, Params, ParamsArgs, GroupIdentifier extends string, FromObjectGroupIdentifier extends string, FromObjectState, FromObjectResourceParams> = (Omit<ResourceOptions<NoInfer<ResourceState>, Params>, 'params' | 'loader'> & ({
+    /**
+     * A reactive function which determines the request to be made. Whenever the request changes, the
+     * loader will be triggered to fetch a new value for the resource.
+     *
+     * If a request function isn't provided, the loader won't rerun unless the resource is reloaded.
+     */
+    params: () => Params;
+    loader: (param: NoInfer<ResourceLoaderParams<Params>>) => Promise<ResourceState>;
+    method?: never;
+    fromResourceById?: never;
+    stream?: never;
+    /**
+     * Each the query load, the value will return undefined.
+     * To avoid flickering display and also enable to the data to be retrieved from cache, use () => true
+     * default value: false
+     */
+    preservePreviousValue?: () => boolean;
+} | {
+    /**
+     * Used to generate a method in the store, when called will trigger the resource loader/stream.
+     *
+     * Only support one parameter which can be an object to pass multiple parameters.
+     */
+    method: (args: ParamsArgs) => Params;
+    loader: (param: NoInfer<ResourceLoaderParams<Params>>) => Promise<ResourceState>;
+    params?: never;
+    fromResourceById?: never;
+    stream?: never;
+    preservePreviousValue?: () => boolean;
+} | {
+    method?: never;
+    loader?: never;
+    params?: () => Params;
+    fromResourceById?: never;
+    /**
+     * Loading function which returns a `Promise` of a signal of the resource's value for a given
+     * request, which can change over time as new values are received from a stream.
+     */
+    stream: ResourceStreamingLoader<ResourceState, Params>;
+    preservePreviousValue?: () => boolean;
+} | {
+    method: ResourceMethod<ParamsArgs, Params>;
+    loader?: never;
+    params?: never;
+    fromResourceById?: never;
+    /**
+     * Loading function which returns a `Promise` of a signal of the resource's value for a given
+     * request, which can change over time as new values are received from a stream.
+     */
+    stream: ResourceStreamingLoader<ResourceState, Params>;
+    preservePreviousValue?: () => boolean;
+} | {
+    /**
+     * Use it, when you need to bind a ResourceByIdRef to another ResourceByIdRef.
+     * It will enforce the fromObject keys syncing when the fromObject resource change.
+     */
+    fromResourceById: ResourceByIdRef<FromObjectGroupIdentifier, FromObjectState, FromObjectResourceParams>;
+    /**
+     * A reactive function which determines the request to be made. Whenever the request changes, the
+     * loader will be triggered to fetch a new value for the resource.
+     *
+     * If a request function isn't provided, the loader won't rerun unless the resource is reloaded.
+     */
+    params: (entity: ResourceRef<NoInfer<FromObjectState>>) => Params;
+    loader: (param: NoInfer<ResourceLoaderParams<Params>>) => Promise<ResourceState>;
+    method?: never;
+    stream?: never;
+    /**
+     * Each the query load, the value will return undefined.
+     * To avoid flickering display and also enable to the data to be retrieved from cache, use () => true
+     * default value: false
+     */
+    preservePreviousValue?: () => boolean;
+} | {
+    method?: never;
+    loader?: never;
+    params?: () => Params;
+    fromResourceById?: never;
+    /**
+     * Loading function which returns a `Promise` of a signal of the resource's value for a given
+     * request, which can change over time as new values are received from a stream.
+     */
+    stream: ResourceStreamingLoader<ResourceState, Params>;
+    preservePreviousValue?: () => boolean;
+}) & {
+    /**
+     * A unique identifier for the resource, derived from the params.
+     * It should be a string that uniquely identifies the resource based on the params.
+     */
+    identifier: (params: NoInfer<NonNullable<Params>>) => GroupIdentifier;
+    /**
+     * Under the hood, a resource is generated for each new identifier generated when the params source change.
+     *
+     * If the source change, and their is an existing resource with the same identifier, it will be re-used.
+     *
+     * In this case, when the source is an object, an existing resource can be retrieved by the matching his record key with identifier function, but as the reference change it will trigger the loading of the resource again.
+     *
+     * To avoid this, you can use this option to tell how to compare the incoming params with the existing params of the resource.
+     * - 'useIdentifier': will use the identifier function to compare the previous params and the incoming params. This very useful when using pagination.
+     * - 'default' (default value): will use a strict equality check (===) between the previous params and the incoming params.
+     * - (a: Params, b: Params) => boolean: you can provide your own comparison function to compare the previous params and the incoming params. This is useful when you want to compare specific fields of the params.
+     *
+     * Note: if your params is a primitive (string, number, boolean, etc.), you don't need to use this option since the strict equality check will work as expected.
+     *
+     * For **queries** the default value is 'useIdentifier'
+     *
+     * For **mutations** the default value is 'default'
+     */
+    equalParams?: Params extends object ? 'default' | 'useIdentifier' | ((a: Params, b: Params, identifierFn: (params: Params) => GroupIdentifier) => boolean) : never;
+});
+//# sourceMappingURL=resource-by-id-config.type.d.ts.map

package/src/lib/util/types/resource-by-id-config.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-by-id-config.type.d.ts","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/resource-by-id-config.type.ts"],"names":[],"mappings":"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"}

package/src/lib/util/types/resource-by-id-config.type.js

@@ -0,0 +1 @@
+//# sourceMappingURL=resource-by-id-config.type.js.map

package/src/lib/util/types/resource-by-id-config.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-by-id-config.type.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/resource-by-id-config.type.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  ResourceLoaderParams,\n  ResourceOptions,\n  ResourceRef,\n  ResourceStreamingLoader,\n} from '../../host/craft-compat';\nimport { ResourceMethod } from './shared.type';\nimport { ResourceByIdRef } from '../../resource-by-id';\n\nexport type ResourceByIdConfig<\n  ResourceState,\n  Params,\n  ParamsArgs,\n  GroupIdentifier extends string,\n  FromObjectGroupIdentifier extends string,\n  FromObjectState,\n  FromObjectResourceParams\n> =\n  | Omit<ResourceOptions<NoInfer<ResourceState>, Params>, 'params' | 'loader'> &\n      (\n        | {\n            /**\n             * A reactive function which determines the request to be made. Whenever the request changes, the\n             * loader will be triggered to fetch a new value for the resource.\n             *\n             * If a request function isn't provided, the loader won't rerun unless the resource is reloaded.\n             */\n            params: () => Params;\n            loader: (\n              param: NoInfer<ResourceLoaderParams<Params>>\n            ) => Promise<ResourceState>;\n            method?: never;\n            fromResourceById?: never;\n            stream?: never;\n            /**\n             * Each the query load, the value will return undefined.\n             * To avoid flickering display and also enable to the data to be retrieved from cache, use () => true\n             * default value: false\n             */\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            /**\n             * Used to generate a method in the store, when called will trigger the resource loader/stream.\n             *\n             * Only support one parameter which can be an object to pass multiple parameters.\n             */\n            method: (args: ParamsArgs) => Params;\n            loader: (\n              param: NoInfer<ResourceLoaderParams<Params>>\n            ) => Promise<ResourceState>;\n            params?: never;\n            fromResourceById?: never;\n            stream?: never;\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            method?: never;\n            loader?: never;\n            params?: () => Params;\n            fromResourceById?: never;\n            /**\n             * Loading function which returns a `Promise` of a signal of the resource's value for a given\n             * request, which can change over time as new values are received from a stream.\n             */\n            stream: ResourceStreamingLoader<ResourceState, Params>;\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            method: ResourceMethod<ParamsArgs, Params>;\n            loader?: never;\n            params?: never;\n            fromResourceById?: never;\n            /**\n             * Loading function which returns a `Promise` of a signal of the resource's value for a given\n             * request, which can change over time as new values are received from a stream.\n             */\n            stream: ResourceStreamingLoader<ResourceState, Params>;\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            /**\n             * Use it, when you need to bind a ResourceByIdRef to another ResourceByIdRef.\n             * It will enforce the fromObject keys syncing when the fromObject resource change.\n             */\n            fromResourceById: ResourceByIdRef<\n              FromObjectGroupIdentifier,\n              FromObjectState,\n              FromObjectResourceParams\n            >;\n            /**\n             * A reactive function which determines the request to be made. Whenever the request changes, the\n             * loader will be triggered to fetch a new value for the resource.\n             *\n             * If a request function isn't provided, the loader won't rerun unless the resource is reloaded.\n             */\n            params: (entity: ResourceRef<NoInfer<FromObjectState>>) => Params;\n            loader: (\n              param: NoInfer<ResourceLoaderParams<Params>>\n            ) => Promise<ResourceState>;\n            method?: never;\n            stream?: never;\n            /**\n             * Each the query load, the value will return undefined.\n             * To avoid flickering display and also enable to the data to be retrieved from cache, use () => true\n             * default value: false\n             */\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            method?: never;\n            loader?: never;\n            params?: () => Params;\n            fromResourceById?: never;\n            /**\n             * Loading function which returns a `Promise` of a signal of the resource's value for a given\n             * request, which can change over time as new values are received from a stream.\n             */\n            stream: ResourceStreamingLoader<ResourceState, Params>;\n            preservePreviousValue?: () => boolean;\n          }\n      ) & {\n        /**\n         * A unique identifier for the resource, derived from the params.\n         * It should be a string that uniquely identifies the resource based on the params.\n         */\n        identifier: (params: NoInfer<NonNullable<Params>>) => GroupIdentifier;\n        /**\n         * Under the hood, a resource is generated for each new identifier generated when the params source change.\n         *\n         * If the source change, and their is an existing resource with the same identifier, it will be re-used.\n         *\n         * In this case, when the source is an object, an existing resource can be retrieved by the matching his record key with identifier function, but as the reference change it will trigger the loading of the resource again.\n         *\n         * To avoid this, you can use this option to tell how to compare the incoming params with the existing params of the resource.\n         * - 'useIdentifier': will use the identifier function to compare the previous params and the incoming params. This very useful when using pagination.\n         * - 'default' (default value): will use a strict equality check (===) between the previous params and the incoming params.\n         * - (a: Params, b: Params) => boolean: you can provide your own comparison function to compare the previous params and the incoming params. This is useful when you want to compare specific fields of the params.\n         *\n         * Note: if your params is a primitive (string, number, boolean, etc.), you don't need to use this option since the strict equality check will work as expected.\n         *\n         * For **queries** the default value is 'useIdentifier'\n         *\n         * For **mutations** the default value is 'default'\n         */\n        equalParams?: Params extends object\n          ?\n              | 'default'\n              | 'useIdentifier'\n              | ((\n                  a: Params,\n                  b: Params,\n                  identifierFn: (params: Params) => GroupIdentifier\n                ) => boolean)\n          : never;\n      };\n"]}

package/src/lib/util/types/resource-with-params-or-params-fn.type.d.ts

@@ -0,0 +1,52 @@
+import { ResourceLoaderParams, ResourceOptions, ResourceStreamingLoader } from '../../host/craft-compat';
+import { ResourceMethod } from './shared.type';
+export type ResourceWithParamsOrParamsFn<ResourceState, Params, ParamsArgs> = (Omit<ResourceOptions<NoInfer<ResourceState>, Params>, 'params' | 'loader'> & ({
+    /**
+     * A reactive function which determines the request to be made. Whenever the request changes, the
+     * loader will be triggered to fetch a new value for the resource.
+     *
+     * If a request function isn't provided, the loader won't rerun unless the resource is reloaded.
+     */
+    params: () => Params;
+    loader: (param: NoInfer<ResourceLoaderParams<Params>>) => Promise<ResourceState>;
+    method?: never;
+    stream?: never;
+    /**
+     * Each the query load, the value will return undefined.
+     * To avoid flickering display and also enable to the data to be retrieved from cache, use () => true
+     * default value: false
+     */
+    preservePreviousValue?: () => boolean;
+} | {
+    /**
+     * Used to generate a method in the store, when called will trigger the resource loader/stream.
+     *
+     * Only support one parameter which can be an object to pass multiple parameters.
+     */
+    method: (args: ParamsArgs) => Params;
+    loader: (param: NoInfer<ResourceLoaderParams<Params>>) => Promise<ResourceState>;
+    params?: never;
+    stream?: never;
+    preservePreviousValue?: () => boolean;
+} | {
+    method?: never;
+    loader?: never;
+    params?: () => Params;
+    /**
+     * Loading function which returns a `Promise` of a signal of the resource's value for a given
+     * request, which can change over time as new values are received from a stream.
+     */
+    stream: ResourceStreamingLoader<ResourceState, Params>;
+    preservePreviousValue?: () => boolean;
+} | {
+    method: ResourceMethod<ParamsArgs, Params>;
+    loader?: never;
+    params?: never;
+    /**
+     * Loading function which returns a `Promise` of a signal of the resource's value for a given
+     * request, which can change over time as new values are received from a stream.
+     */
+    stream: ResourceStreamingLoader<ResourceState, Params>;
+    preservePreviousValue?: () => boolean;
+}));
+//# sourceMappingURL=resource-with-params-or-params-fn.type.d.ts.map

package/src/lib/util/types/resource-with-params-or-params-fn.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-with-params-or-params-fn.type.d.ts","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/resource-with-params-or-params-fn.type.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,IACxE,CAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,GACxE,CACI;IACE;;;;;OAKG;IACH,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,MAAM,EAAE,CACN,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,KACzC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;CACvC,GACD;IACE;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC;IACrC,MAAM,EAAE,CACN,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,KACzC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;CACvC,GACD;IACE,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,EAAE,uBAAuB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvD,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;CACvC,GACD;IACE,MAAM,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,uBAAuB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvD,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;CACvC,CACJ,CAAA,CAAC"}

package/src/lib/util/types/resource-with-params-or-params-fn.type.js

@@ -0,0 +1 @@
+//# sourceMappingURL=resource-with-params-or-params-fn.type.js.map

package/src/lib/util/types/resource-with-params-or-params-fn.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-with-params-or-params-fn.type.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/resource-with-params-or-params-fn.type.ts"],"names":[],"mappings":"","sourcesContent":["import {\n  ResourceLoaderParams,\n  ResourceOptions,\n  ResourceStreamingLoader,\n} from '../../host/craft-compat';\nimport { ResourceMethod } from './shared.type';\n\nexport type ResourceWithParamsOrParamsFn<ResourceState, Params, ParamsArgs> =\n  | Omit<ResourceOptions<NoInfer<ResourceState>, Params>, 'params' | 'loader'> &\n      (\n        | {\n            /**\n             * A reactive function which determines the request to be made. Whenever the request changes, the\n             * loader will be triggered to fetch a new value for the resource.\n             *\n             * If a request function isn't provided, the loader won't rerun unless the resource is reloaded.\n             */\n            params: () => Params;\n            loader: (\n              param: NoInfer<ResourceLoaderParams<Params>>\n            ) => Promise<ResourceState>;\n            method?: never;\n            stream?: never;\n            /**\n             * Each the query load, the value will return undefined.\n             * To avoid flickering display and also enable to the data to be retrieved from cache, use () => true\n             * default value: false\n             */\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            /**\n             * Used to generate a method in the store, when called will trigger the resource loader/stream.\n             *\n             * Only support one parameter which can be an object to pass multiple parameters.\n             */\n            method: (args: ParamsArgs) => Params;\n            loader: (\n              param: NoInfer<ResourceLoaderParams<Params>>\n            ) => Promise<ResourceState>;\n            params?: never;\n            stream?: never;\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            method?: never;\n            loader?: never;\n            params?: () => Params;\n            /**\n             * Loading function which returns a `Promise` of a signal of the resource's value for a given\n             * request, which can change over time as new values are received from a stream.\n             */\n            stream: ResourceStreamingLoader<ResourceState, Params>;\n            preservePreviousValue?: () => boolean;\n          }\n        | {\n            method: ResourceMethod<ParamsArgs, Params>;\n            loader?: never;\n            params?: never;\n            /**\n             * Loading function which returns a `Promise` of a signal of the resource's value for a given\n             * request, which can change over time as new values are received from a stream.\n             */\n            stream: ResourceStreamingLoader<ResourceState, Params>;\n            preservePreviousValue?: () => boolean;\n          }\n      );\n"]}

package/src/lib/util/types/shared.type.d.ts

@@ -0,0 +1,66 @@
+import { ObjectDeepPath } from './object-deep-path-mapper.type';
+import { AccessTypeObjectPropertyByDottedPath, DottedPathPathToTuple } from './access-type-object-property-by-dotted-path.type';
+import { InternalType, MergeObjects } from './util.type';
+import { ResourceByIdRef } from '../../resource-by-id';
+import { MutationResourceByIdRefHelper, ResourceExceptionConstraints } from '../../query.core';
+import { CraftResourceRef } from '../craft-resource-ref';
+export type QueryAndMutationRecordConstraints = {
+    query: InternalType<unknown, unknown, unknown, unknown, boolean, unknown, unknown, unknown, ResourceExceptionConstraints>;
+    mutation: InternalType<unknown, unknown, unknown, unknown, unknown, unknown, unknown, unknown, ResourceExceptionConstraints>;
+};
+export type CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = (data: MergeObjects<[
+    {
+        queryResource: CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+        mutationResource: CraftResourceRef<QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']>;
+        mutationParams: NonNullable<QueryAndMutationRecord['mutation']['params']>;
+    },
+    QueryAndMutationRecord['query']['isGroupedResource'] extends true ? {
+        queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];
+        queryResources: ResourceByIdRef<string, QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    } : {},
+    QueryAndMutationRecord['mutation']['isGroupedResource'] extends true ? {
+        mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];
+        mutationResources: ResourceByIdRef<string, QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']>;
+    } : {}
+]>) => boolean;
+export type ReloadQueriesConfig<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = false | {
+    onMutationException?: boolean | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;
+    onMutationResolved?: boolean | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;
+    onMutationLoading?: boolean | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;
+};
+export type PatchMutationQuery<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = QueryAndMutationRecord['query']['state'] extends object ? {
+    [queryPatchPath in ObjectDeepPath<QueryAndMutationRecord['query']['state']>]?: AccessTypeObjectPropertyByDottedPath<QueryAndMutationRecord['query']['state'], DottedPathPathToTuple<queryPatchPath>> extends infer TargetedType ? PatchQueryFn<QueryAndMutationRecord, TargetedType> : never;
+} : never;
+export type PatchQueryFn<QueryAndMutationRecord extends QueryAndMutationRecordConstraints, TargetedType> = (data: MergeObjects<[
+    {
+        queryResource: NoInfer<CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>>;
+        mutationResource: NoInfer<CraftResourceRef<QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']>>;
+        mutationParams: NonNullable<NoInfer<QueryAndMutationRecord['mutation']['params']>>;
+        targetedState: TargetedType | undefined;
+    },
+    QueryAndMutationRecord['query']['groupIdentifier'] extends string ? {
+        queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];
+        queryResources: ResourceByIdRef<QueryAndMutationRecord['query']['groupIdentifier'], QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    } : {},
+    QueryAndMutationRecord['mutation']['groupIdentifier'] extends string ? {
+        mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];
+        mutationResources: MutationResourceByIdRefHelper<QueryAndMutationRecord>;
+    } : {}
+]>) => TargetedType;
+export type FilterQueryById<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = (data: MergeObjects<[
+    {
+        queryResource: CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+        mutationResource: CraftResourceRef<NoInfer<QueryAndMutationRecord['mutation']['state']>, NoInfer<QueryAndMutationRecord['mutation']['params']>>;
+        mutationParams: NonNullable<NoInfer<QueryAndMutationRecord['mutation']['params']>>;
+    },
+    QueryAndMutationRecord['query']['groupIdentifier'] extends string ? {
+        queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];
+        queryResources: ResourceByIdRef<QueryAndMutationRecord['query']['groupIdentifier'], QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    } : {},
+    QueryAndMutationRecord['mutation']['groupIdentifier'] extends string ? {
+        mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];
+        mutationResources: ResourceByIdRef<QueryAndMutationRecord['mutation']['groupIdentifier'], QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']>;
+    } : {}
+]>) => boolean;
+export type ResourceMethod<ParamsArgs, ResourceParams> = (args: ParamsArgs) => ResourceParams;
+//# sourceMappingURL=shared.type.d.ts.map

package/src/lib/util/types/shared.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.type.d.ts","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/shared.type.ts"],"names":[],"mappings":"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"}

package/src/lib/util/types/shared.type.js

@@ -0,0 +1 @@
+//# sourceMappingURL=shared.type.js.map

package/src/lib/util/types/shared.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.type.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/shared.type.ts"],"names":[],"mappings":"","sourcesContent":["import { ObjectDeepPath } from './object-deep-path-mapper.type';\nimport {\n  AccessTypeObjectPropertyByDottedPath,\n  DottedPathPathToTuple,\n} from './access-type-object-property-by-dotted-path.type';\nimport { InternalType, MergeObjects } from './util.type';\nimport { ResourceByIdRef } from '../../resource-by-id';\nimport {\n  MutationResourceByIdRefHelper,\n  ResourceExceptionConstraints,\n} from '../../query.core';\nimport { CraftResourceRef } from '../craft-resource-ref';\n\n// todo rename, and rename server state constraints\nexport type QueryAndMutationRecordConstraints = {\n  query: InternalType<\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    boolean,\n    unknown,\n    unknown,\n    unknown,\n    ResourceExceptionConstraints\n  >;\n  mutation: InternalType<\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    unknown,\n    ResourceExceptionConstraints\n  >;\n};\n\nexport type CustomReloadOnSpecificMutationStatus<\n  QueryAndMutationRecord extends QueryAndMutationRecordConstraints,\n> = (\n  data: MergeObjects<\n    [\n      {\n        queryResource: CraftResourceRef<\n          QueryAndMutationRecord['query']['state'],\n          QueryAndMutationRecord['query']['params']\n        >;\n        mutationResource: CraftResourceRef<\n          QueryAndMutationRecord['mutation']['state'],\n          QueryAndMutationRecord['mutation']['params']\n        >;\n        mutationParams: NonNullable<\n          QueryAndMutationRecord['mutation']['params']\n        >;\n      },\n      QueryAndMutationRecord['query']['isGroupedResource'] extends true\n        ? {\n            queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];\n            queryResources: ResourceByIdRef<\n              string,\n              QueryAndMutationRecord['query']['state'],\n              QueryAndMutationRecord['query']['params']\n            >;\n          }\n        : {},\n      QueryAndMutationRecord['mutation']['isGroupedResource'] extends true\n        ? {\n            mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];\n            mutationResources: ResourceByIdRef<\n              string,\n              QueryAndMutationRecord['mutation']['state'],\n              QueryAndMutationRecord['mutation']['params']\n            >;\n          }\n        : {},\n    ]\n  >,\n) => boolean;\n\nexport type ReloadQueriesConfig<\n  QueryAndMutationRecord extends QueryAndMutationRecordConstraints,\n> =\n  | false\n  | {\n      onMutationException?:\n        | boolean\n        | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;\n      onMutationResolved?:\n        | boolean\n        | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;\n      onMutationLoading?:\n        | boolean\n        | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;\n    };\n\nexport type PatchMutationQuery<\n  QueryAndMutationRecord extends QueryAndMutationRecordConstraints,\n> = QueryAndMutationRecord['query']['state'] extends object\n  ? {\n      [queryPatchPath in ObjectDeepPath<\n        QueryAndMutationRecord['query']['state']\n      >]?: AccessTypeObjectPropertyByDottedPath<\n        QueryAndMutationRecord['query']['state'],\n        DottedPathPathToTuple<queryPatchPath>\n      > extends infer TargetedType\n        ? PatchQueryFn<QueryAndMutationRecord, TargetedType>\n        : never;\n    }\n  : never;\n\nexport type PatchQueryFn<\n  QueryAndMutationRecord extends QueryAndMutationRecordConstraints,\n  TargetedType,\n> = (\n  data: MergeObjects<\n    [\n      {\n        queryResource: NoInfer<\n          CraftResourceRef<\n            QueryAndMutationRecord['query']['state'],\n            QueryAndMutationRecord['query']['params']\n          >\n        >;\n        mutationResource: NoInfer<\n          CraftResourceRef<\n            QueryAndMutationRecord['mutation']['state'],\n            QueryAndMutationRecord['mutation']['params']\n          >\n        >;\n        mutationParams: NonNullable<\n          NoInfer<QueryAndMutationRecord['mutation']['params']>\n        >;\n        targetedState: TargetedType | undefined;\n      },\n      QueryAndMutationRecord['query']['groupIdentifier'] extends string\n        ? {\n            queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];\n            queryResources: ResourceByIdRef<\n              QueryAndMutationRecord['query']['groupIdentifier'],\n              QueryAndMutationRecord['query']['state'],\n              QueryAndMutationRecord['query']['params']\n            >;\n          }\n        : {},\n      QueryAndMutationRecord['mutation']['groupIdentifier'] extends string\n        ? {\n            mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];\n            mutationResources: MutationResourceByIdRefHelper<QueryAndMutationRecord>;\n          }\n        : {},\n    ]\n  >,\n) => TargetedType;\n\nexport type FilterQueryById<\n  QueryAndMutationRecord extends QueryAndMutationRecordConstraints,\n> = (\n  data: MergeObjects<\n    [\n      {\n        queryResource: CraftResourceRef<\n          QueryAndMutationRecord['query']['state'],\n          QueryAndMutationRecord['query']['params']\n        >;\n        mutationResource: CraftResourceRef<\n          NoInfer<QueryAndMutationRecord['mutation']['state']>,\n          NoInfer<QueryAndMutationRecord['mutation']['params']>\n        >;\n        mutationParams: NonNullable<\n          NoInfer<QueryAndMutationRecord['mutation']['params']>\n        >;\n      },\n      QueryAndMutationRecord['query']['groupIdentifier'] extends string\n        ? {\n            queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];\n            queryResources: ResourceByIdRef<\n              QueryAndMutationRecord['query']['groupIdentifier'],\n              QueryAndMutationRecord['query']['state'],\n              QueryAndMutationRecord['query']['params']\n            >;\n          }\n        : {},\n      QueryAndMutationRecord['mutation']['groupIdentifier'] extends string\n        ? {\n            mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];\n            mutationResources: ResourceByIdRef<\n              QueryAndMutationRecord['mutation']['groupIdentifier'],\n              QueryAndMutationRecord['mutation']['state'],\n              QueryAndMutationRecord['mutation']['params']\n            >;\n          }\n        : {},\n    ]\n  >,\n) => boolean;\n\nexport type ResourceMethod<ParamsArgs, ResourceParams> = (\n  args: ParamsArgs,\n) => ResourceParams;\n"]}

package/src/lib/util/types/util.d.ts

@@ -0,0 +1,16 @@
+import { EffectCleanupRegisterFn, EffectRef, InjectionToken, Injector } from '../../host/craft-compat';
+import { ExplicitEffectValues } from '../explicit-effect';
+export declare const DYNAMIC_EFFECT_REF_INSTANCE_TOKEN: InjectionToken<EffectRef>;
+export declare function nestedEffect<T, R, GroupIdentifier extends string>(parentInjector: Injector, effectFn: (onCleanup: EffectCleanupRegisterFn) => void): EffectRef;
+/**
+ * A {@link nestedEffect} that can stop itself from inside its own body.
+ *
+ * Effects run their first pass synchronously, so the body cannot close over the
+ * `EffectRef` the call is about to return — reaching for it during that first
+ * pass is a temporal-dead-zone error. The body is handed a `stop` callback
+ * instead, and a stop requested before the ref exists is honoured as soon as it
+ * does.
+ */
+export declare function selfStoppingNestedEffect(parentInjector: Injector, effectFn: (stop: () => void, onCleanup: EffectCleanupRegisterFn) => void): EffectRef;
+export declare function explicitNestedEffect<T, R, GroupIdentifier extends string, Input extends readonly unknown[], Params = Input>(parentInjector: Injector, deps: readonly [...ExplicitEffectValues<Input>], fn: (deps: Params, onCleanup: EffectCleanupRegisterFn) => void): EffectRef;
+//# sourceMappingURL=util.d.ts.map

package/src/lib/util/types/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,EACvB,SAAS,EACT,cAAc,EACd,QAAQ,EACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAkB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,eAAO,MAAM,iCAAiC,2BAE7C,CAAC;AAEF,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,eAAe,SAAS,MAAM,EAC/D,cAAc,EAAE,QAAQ,EACxB,QAAQ,EAAE,CAAC,SAAS,EAAE,uBAAuB,KAAK,IAAI,aAiBvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,QAAQ,EACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,uBAAuB,KAAK,IAAI,GACvE,SAAS,CAYX;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EACD,CAAC,EACD,eAAe,SAAS,MAAM,EAC9B,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,MAAM,GAAG,KAAK,EAEd,cAAc,EAAE,QAAQ,EACxB,IAAI,EAAE,SAAS,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAC/C,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,KAAK,IAAI,aAiB/D"}

package/src/lib/util/types/util.js

@@ -0,0 +1,60 @@
+import { effect, InjectionToken, Injector, } from '../../host/craft-compat';
+import { explicitEffect } from '../explicit-effect';
+export const DYNAMIC_EFFECT_REF_INSTANCE_TOKEN = new InjectionToken('Injection token used to provide a dynamically created effectRef instance.');
+export function nestedEffect(parentInjector, effectFn) {
+    const injector = Injector.create({
+        providers: [
+            {
+                provide: DYNAMIC_EFFECT_REF_INSTANCE_TOKEN,
+                useFactory: () => {
+                    return effect(effectFn, {
+                        injector: parentInjector,
+                    });
+                },
+            },
+        ],
+        parent: parentInjector,
+    });
+    const effectRef = injector.get(DYNAMIC_EFFECT_REF_INSTANCE_TOKEN);
+    return effectRef;
+}
+/**
+ * A {@link nestedEffect} that can stop itself from inside its own body.
+ *
+ * Effects run their first pass synchronously, so the body cannot close over the
+ * `EffectRef` the call is about to return — reaching for it during that first
+ * pass is a temporal-dead-zone error. The body is handed a `stop` callback
+ * instead, and a stop requested before the ref exists is honoured as soon as it
+ * does.
+ */
+export function selfStoppingNestedEffect(parentInjector, effectFn) {
+    let ref;
+    let stopped = false;
+    const stop = () => {
+        stopped = true;
+        ref?.destroy();
+    };
+    ref = nestedEffect(parentInjector, (onCleanup) => effectFn(stop, onCleanup));
+    if (stopped) {
+        ref.destroy();
+    }
+    return ref;
+}
+export function explicitNestedEffect(parentInjector, deps, fn) {
+    const injector = Injector.create({
+        providers: [
+            {
+                provide: DYNAMIC_EFFECT_REF_INSTANCE_TOKEN,
+                useFactory: () => {
+                    return explicitEffect(deps, fn, {
+                        injector: parentInjector,
+                    });
+                },
+            },
+        ],
+        parent: parentInjector,
+    });
+    const effectRef = injector.get(DYNAMIC_EFFECT_REF_INSTANCE_TOKEN);
+    return effectRef;
+}
+//# sourceMappingURL=util.js.map

package/src/lib/util/types/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAGN,cAAc,EACd,QAAQ,GACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAwB,MAAM,oBAAoB,CAAC;AAE1E,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,cAAc,CACjE,2EAA2E,CAC5E,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,cAAwB,EACxB,QAAsD;IAEtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,iCAAiC;gBAC1C,UAAU,EAAE,GAAG,EAAE;oBACf,OAAO,MAAM,CAAC,QAAQ,EAAE;wBACtB,QAAQ,EAAE,cAAc;qBACzB,CAAC,CAAC;gBACL,CAAC;aACF;SACF;QACD,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAClE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,cAAwB,EACxB,QAAwE;IAExE,IAAI,GAA0B,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,OAAO,GAAG,IAAI,CAAC;QACf,GAAG,EAAE,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC;IACF,GAAG,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7E,IAAI,OAAO,EAAE,CAAC;QACZ,GAAG,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAOlC,cAAwB,EACxB,IAA+C,EAC/C,EAA8D;IAE9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC/B,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,iCAAiC;gBAC1C,UAAU,EAAE,GAAG,EAAE;oBACf,OAAO,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE;wBAC9B,QAAQ,EAAE,cAAc;qBACzB,CAAC,CAAC;gBACL,CAAC;aACF;SACF;QACD,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAClE,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import {\n  effect,\n  EffectCleanupRegisterFn,\n  EffectRef,\n  InjectionToken,\n  Injector,\n} from '../../host/craft-compat';\nimport { explicitEffect, ExplicitEffectValues } from '../explicit-effect';\n\nexport const DYNAMIC_EFFECT_REF_INSTANCE_TOKEN = new InjectionToken<EffectRef>(\n  'Injection token used to provide a dynamically created effectRef instance.',\n);\n\nexport function nestedEffect<T, R, GroupIdentifier extends string>(\n  parentInjector: Injector,\n  effectFn: (onCleanup: EffectCleanupRegisterFn) => void,\n) {\n  const injector = Injector.create({\n    providers: [\n      {\n        provide: DYNAMIC_EFFECT_REF_INSTANCE_TOKEN,\n        useFactory: () => {\n          return effect(effectFn, {\n            injector: parentInjector,\n          });\n        },\n      },\n    ],\n    parent: parentInjector,\n  });\n  const effectRef = injector.get(DYNAMIC_EFFECT_REF_INSTANCE_TOKEN);\n  return effectRef;\n}\n\n/**\n * A {@link nestedEffect} that can stop itself from inside its own body.\n *\n * Effects run their first pass synchronously, so the body cannot close over the\n * `EffectRef` the call is about to return — reaching for it during that first\n * pass is a temporal-dead-zone error. The body is handed a `stop` callback\n * instead, and a stop requested before the ref exists is honoured as soon as it\n * does.\n */\nexport function selfStoppingNestedEffect(\n  parentInjector: Injector,\n  effectFn: (stop: () => void, onCleanup: EffectCleanupRegisterFn) => void,\n): EffectRef {\n  let ref: EffectRef | undefined;\n  let stopped = false;\n  const stop = () => {\n    stopped = true;\n    ref?.destroy();\n  };\n  ref = nestedEffect(parentInjector, (onCleanup) => effectFn(stop, onCleanup));\n  if (stopped) {\n    ref.destroy();\n  }\n  return ref;\n}\n\nexport function explicitNestedEffect<\n  T,\n  R,\n  GroupIdentifier extends string,\n  Input extends readonly unknown[],\n  Params = Input,\n>(\n  parentInjector: Injector,\n  deps: readonly [...ExplicitEffectValues<Input>],\n  fn: (deps: Params, onCleanup: EffectCleanupRegisterFn) => void,\n) {\n  const injector = Injector.create({\n    providers: [\n      {\n        provide: DYNAMIC_EFFECT_REF_INSTANCE_TOKEN,\n        useFactory: () => {\n          return explicitEffect(deps, fn, {\n            injector: parentInjector,\n          });\n        },\n      },\n    ],\n    parent: parentInjector,\n  });\n  const effectRef = injector.get(DYNAMIC_EFFECT_REF_INSTANCE_TOKEN);\n  return effectRef;\n}\n"]}

package/src/lib/util/types/util.type.d.ts

@@ -0,0 +1,67 @@
+import { Type } from '../../host/craft-compat';
+import { Prettify } from '../util.type';
+import { ResourceExceptionConstraints } from '../../query.core';
+export type MakeOptionalPropertiesRequired<T, K extends keyof T = keyof T> = T & {
+    [P in K]-?: T[P];
+};
+export type MergeObject<A, B> = A & B;
+export type MergeObjects<F extends unknown[], Acc = {}> = F extends [
+    infer First,
+    ...infer Rest
+] ? First extends object ? MergeObjects<Rest, MergeObject<Acc, First>> : Prettify<Acc> : Prettify<Acc>;
+export type InternalType<State, Params, Args, IsGroupedResource, IsMethod, Insertions, GroupIdentifier, SourceParams, Exceptions extends ResourceExceptionConstraints> = {
+    state: State;
+    params: Params;
+    args: Args;
+    isGroupedResource: IsGroupedResource;
+    groupIdentifier: GroupIdentifier;
+    isMethod?: IsMethod;
+    insertions?: Insertions;
+    sourceParams?: SourceParams;
+    exceptions: Exceptions;
+};
+/**
+ * trick to combine multiple unions of objects into a single object
+ * only works with objects not primitives
+ * @param union - Union of objects
+ * @returns Intersection of objects
+ */
+export type UnionToIntersection<union> = (union extends any ? (k: union) => void : never) extends (k: infer intersection) => void ? intersection : never;
+/**
+ * get last element of union
+ * @param Union - Union of any types
+ * @returns Last element of union
+ */
+type GetUnionLast<Union> = UnionToIntersection<Union extends any ? () => Union : never> extends () => infer Last ? Last : never;
+/**
+ * Convert union to tuple
+ * @param Union - Union of any types, can be union of complex, composed or primitive types
+ * @returns Tuple of each elements in the union
+ */
+export type UnionToTuple<Union, Tuple extends unknown[] = []> = [
+    Union
+] extends [never] ? Tuple : UnionToTuple<Exclude<Union, GetUnionLast<Union>>, [
+    GetUnionLast<Union>,
+    ...Tuple
+]>;
+export type HasChild<T> = T extends any[] ? false : T extends object ? true : false;
+/**
+ * Negates a boolean type.
+ */
+export type Not<T extends boolean> = T extends true ? false : true;
+/**
+ * @internal
+ */
+declare const secret: unique symbol;
+/**
+ * @internal
+ */
+type Secret = typeof secret;
+/**
+ * Checks if the given type is `never`.
+ */
+export type IsNever<T> = [T] extends [never] ? true : false;
+export type IsAny<T> = [T] extends [Secret] ? Not<IsNever<T>> : false;
+export type InferInjectedType<T extends Type<unknown>> = T extends Type<infer U> ? U : never;
+export {};
+//# sourceMappingURL=util.type.d.ts.map

package/src/lib/util/types/util.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.type.d.ts","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/util.type.ts"],"names":[],"mappings":"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"}

package/src/lib/util/types/util.type.js

@@ -0,0 +1,5 @@
+/**
+ * @internal
+ */
+const secret = Symbol('secret');
+//# sourceMappingURL=util.type.js.map

package/src/lib/util/types/util.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.type.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/util/types/util.type.ts"],"names":[],"mappings":"AA+FA;;GAEG;AACH,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC","sourcesContent":["import { Type } from '../../host/craft-compat';\nimport { Prettify } from '../util.type';\nimport { ResourceExceptionConstraints } from '../../query.core';\n\n// It is not possible to get all the properties key of an optional object, so make the optional properties required\nexport type MakeOptionalPropertiesRequired<\n  T,\n  K extends keyof T = keyof T,\n> = T & {\n  [P in K]-?: T[P];\n};\n\nexport type MergeObject<A, B> = A & B;\n\nexport type MergeObjects<F extends unknown[], Acc = {}> = F extends [\n  infer First,\n  ...infer Rest,\n]\n  ? First extends object\n    ? MergeObjects<Rest, MergeObject<Acc, First>>\n    : Prettify<Acc>\n  : Prettify<Acc>;\n\nexport type InternalType<\n  State,\n  Params,\n  Args,\n  IsGroupedResource,\n  IsMethod,\n  Insertions,\n  GroupIdentifier,\n  SourceParams,\n  Exceptions extends ResourceExceptionConstraints,\n> = {\n  state: State;\n  params: Params;\n  args: Args;\n  isGroupedResource: IsGroupedResource;\n  groupIdentifier: GroupIdentifier;\n  isMethod?: IsMethod;\n  insertions?: Insertions;\n  sourceParams?: SourceParams;\n  exceptions: Exceptions;\n};\n\n// from https://github.com/ecyrbe/zodios/blob/main/src/utils.types.ts\n/**\n * trick to combine multiple unions of objects into a single object\n * only works with objects not primitives\n * @param union - Union of objects\n * @returns Intersection of objects\n */\nexport type UnionToIntersection<union> = (\n  union extends any ? (k: union) => void : never\n) extends (k: infer intersection) => void\n  ? intersection\n  : never;\n\n/**\n * get last element of union\n * @param Union - Union of any types\n * @returns Last element of union\n */\ntype GetUnionLast<Union> =\n  UnionToIntersection<\n    Union extends any ? () => Union : never\n  > extends () => infer Last\n    ? Last\n    : never;\n\n/**\n * Convert union to tuple\n * @param Union - Union of any types, can be union of complex, composed or primitive types\n * @returns Tuple of each elements in the union\n */\nexport type UnionToTuple<Union, Tuple extends unknown[] = []> = [\n  Union,\n] extends [never]\n  ? Tuple\n  : UnionToTuple<\n      Exclude<Union, GetUnionLast<Union>>,\n      [GetUnionLast<Union>, ...Tuple]\n    >;\n\nexport type HasChild<T> = T extends any[]\n  ? false\n  : T extends object\n    ? true\n    : false;\n\n/**\n * Negates a boolean type.\n */\nexport type Not<T extends boolean> = T extends true ? false : true;\n\n/**\n * @internal\n */\nconst secret = Symbol('secret');\n\n/**\n * @internal\n */\ntype Secret = typeof secret;\n\n/**\n * Checks if the given type is `never`.\n */\nexport type IsNever<T> = [T] extends [never] ? true : false;\n\nexport type IsAny<T> = [T] extends [Secret] ? Not<IsNever<T>> : false;\n\nexport type InferInjectedType<T extends Type<unknown>> =\n  T extends Type<infer U> ? U : never;\n"]}

package/src/lib/util/update-state.util.d.ts

@@ -0,0 +1,10 @@
+export declare function createNestedStateUpdate({ state, keysPath, value, }: {
+    state: any;
+    keysPath: string[];
+    value: any;
+}): any;
+export declare function getNestedStateValue({ state, keysPath, }: {
+    state: any;
+    keysPath: string[];
+}): any;
+//# sourceMappingURL=update-state.util.d.ts.map

package/src/lib/util/update-state.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-state.util.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/update-state.util.ts"],"names":[],"mappings":"AACA,wBAAgB,uBAAuB,CAAC,EACtC,KAAK,EACL,QAAQ,EACR,KAAK,GACN,EAAE;IACD,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,GAAG,CAAC;CACZ,GAAG,GAAG,CAuBN;AACD,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GAAG,GAAG,CAON"}

package/src/lib/util/update-state.util.js

@@ -0,0 +1,31 @@
+// todo handle update of array of objects
+export function createNestedStateUpdate({ state, keysPath, value, }) {
+    if (keysPath.length === 0) {
+        return value;
+    }
+    const [currentKey, ...remainingKeys] = keysPath;
+    const currentState = state[currentKey] || {};
+    return {
+        ...state,
+        [currentKey]: remainingKeys.length === 0
+            ? Array.isArray(currentState)
+                ? value
+                : typeof value === 'object' && value !== null && !Array.isArray(value)
+                    ? { ...currentState, ...value }
+                    : value
+            : createNestedStateUpdate({
+                state: currentState,
+                keysPath: remainingKeys,
+                value,
+            }),
+    };
+}
+export function getNestedStateValue({ state, keysPath, }) {
+    return keysPath.reduce((currentState, key) => {
+        if (currentState && typeof currentState === 'object') {
+            return currentState[key];
+        }
+        return undefined;
+    }, state);
+}
+//# sourceMappingURL=update-state.util.js.map

package/src/lib/util/update-state.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-state.util.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/update-state.util.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,UAAU,uBAAuB,CAAC,EACtC,KAAK,EACL,QAAQ,EACR,KAAK,GAKN;IACC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,UAAU,EAAE,GAAG,aAAa,CAAC,GAAG,QAAQ,CAAC;IAChD,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAE7C,OAAO;QACL,GAAG,KAAK;QACR,CAAC,UAAU,CAAC,EACV,aAAa,CAAC,MAAM,KAAK,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC3B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBACtE,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,KAAK,EAAE;oBAC/B,CAAC,CAAC,KAAK;YACT,CAAC,CAAC,uBAAuB,CAAC;gBACtB,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,aAAa;gBACvB,KAAK;aACN,CAAC;KACT,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,GAAG,EAAE,EAAE;QAC3C,IAAI,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,EAAE,KAAK,CAAC,CAAC;AACZ,CAAC","sourcesContent":["// todo handle update of array of objects\nexport function createNestedStateUpdate({\n  state,\n  keysPath,\n  value,\n}: {\n  state: any;\n  keysPath: string[];\n  value: any;\n}): any {\n  if (keysPath.length === 0) {\n    return value;\n  }\n\n  const [currentKey, ...remainingKeys] = keysPath;\n  const currentState = state[currentKey] || {};\n\n  return {\n    ...state,\n    [currentKey]:\n      remainingKeys.length === 0\n        ? Array.isArray(currentState)\n          ? value\n          : typeof value === 'object' && value !== null && !Array.isArray(value)\n          ? { ...currentState, ...value }\n          : value\n        : createNestedStateUpdate({\n            state: currentState,\n            keysPath: remainingKeys,\n            value,\n          }),\n  };\n}\nexport function getNestedStateValue({\n  state,\n  keysPath,\n}: {\n  state: any;\n  keysPath: string[];\n}): any {\n  return keysPath.reduce((currentState, key) => {\n    if (currentState && typeof currentState === 'object') {\n      return currentState[key];\n    }\n    return undefined;\n  }, state);\n}\n"]}

package/src/lib/util/util.d.ts

@@ -0,0 +1,19 @@
+import { WritableSignal } from '../host/craft-compat';
+import { ReadonlySource } from './source.type';
+export declare const SourceBrand: unique symbol;
+export declare const SourceBranded: {
+    [SourceBrand]: true;
+};
+export type SourceBranded = {
+    [SourceBrand]: true;
+};
+/**
+ * Works for Source and ReadonlySource
+ */
+export declare function isSource(value: any): boolean;
+export type SourceBrand = typeof SourceBrand;
+export declare function capitalize<S extends string>(str: S): Capitalize<S>;
+export declare function createMethodHandlers<State>(methodsData: Record<string, ((...args: any[]) => NoInfer<State>) | ReadonlySource<State>> | undefined, state: WritableSignal<State>, options?: {
+    onStateChange?: (newValue: State) => void;
+}): Record<string, Function>;
+//# sourceMappingURL=util.d.ts.map

package/src/lib/util/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,WAAW,eAAwB,CAAC;AAEjD,eAAO,MAAM,aAAa;;CAEzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAK5C;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAE7C,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAElE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EACxC,WAAW,EACP,MAAM,CACJ,MAAM,EACN,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAC7D,GACD,SAAS,EACb,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAC5B,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC;CAC3C,4BA+CF"}