@arrai-innovations/reactive-helpers 18.0.2 → 18.1.0

package/types/use/listInstance.d.ts

@@ -72,7 +72,7 @@
  * @property {(objectId: string) => void} deleteListObject - Deletes an object from the list by pk.
  * @property {() => void} clearList - Clears all objects and errors from the list.
  * @property {() => string} getFakePk - Generates a unique fake pk for use within the list.
- * @property {() => Promise<boolean>} list - Initiates a fetch to retrieve objects according to the CRUD configuration, returning a promise to a boolean indicating success.
+ * @property {() => import('../utils/cancellablePromise.js').MaybeCancellablePromise<boolean|never>} list - Initiates a fetch to retrieve objects according to the CRUD configuration, returning a promise to a boolean indicating success.
  * @property {() => Promise<boolean>} bulkDelete - Initiates a bulk delete operation on all objects in the list, returning a promise to a boolean indicating success.
  * @property {() => Promise<object|string|false>} executeAction - Initiates an action on all objects in the list, returning the response, or false if the action failed.
  */
@@ -326,7 +326,7 @@ export type ListInstanceFunctions = {
     /**
      * - Initiates a fetch to retrieve objects according to the CRUD configuration, returning a promise to a boolean indicating success.
      */
-    list: () => Promise<boolean>;
+    list: () => import("../utils/cancellablePromise.js").MaybeCancellablePromise<boolean | never>;
     /**
      * - Initiates a bulk delete operation on all objects in the list, returning a promise to a boolean indicating success.
      */

package/types/use/listInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listInstance.d.ts","sourceRoot":"","sources":["../../use/listInstance.js"],"names":[],"mappings":"AAsCA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AACH,mDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAC,GAClC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAC,CASzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,oEALW,mBAAmB,GAEjB,YAAY,CAwTxB;AA5fD;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;;;;;;;;WAMa,MAAM;;;;kBACN,MAAM;;;;cACN,MAAM;;;;cACN,MAAM;;;;;;;;;WAON,OAAO,KAAK,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;gBAE5D;QAA8D,IAAI,GAAvD,OAAO,uBAAuB,EAAE,MAAM;QAEoB,UAAU,GAAnE,OAAO,uBAAuB,EAAE,YAAY;QAEiB,aAAa,GAAzE,OAAO,uBAAuB,EAAE,eAAe;QAEO,SAAS,GAAjE,OAAO,uBAAuB,EAAE,WAAW;KAEtD;;;;kBAAW,OAAO;;;;;0BAMR;IAAC,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAA;CAAC;;;;6BAM1B,OAAO,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;;;;wBAMvC,OAAO,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;;;;;;;;UAQ7C;QAAwB,IAAI,EAAjB,MAAM;QACU,IAAI;KAC/B;;;;WAAW,MAAM;;;;kBACN,MAAM;;;;cACN,MAAM;;;;aACN,WAAW;;;;aACX,OAAO;;;;cACP,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;aACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;WACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC,CAAC;;;;WACvC,SAAS;;;;oBACT,cAAc;;;;;gCAMf,OAAO,KAAK,EAAE,gBAAgB,CAAC,oBAAoB,CAAC;;;;;;;;yBAOnD,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;kBAClC,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;mBAClC,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI;;;;eAC1B,MAAM,IAAI;;;;eACV,MAAM,MAAM;;;;UACZ,MAAM,OAAO,CAAC,OAAO,CAAC;;;;gBACtB,MAAM,OAAO,CAAC,OAAO,CAAC;;;;mBACtB,MAAM,OAAO,CAAC,MAAM,GAAC,MAAM,GAAC,KAAK,CAAC;;;;;qCAMnC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAC;;;;2BAM1B,sBAAsB,GAAG,qBAAqB;;;;;yBApH9C;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC"}
+{"version":3,"file":"listInstance.d.ts","sourceRoot":"","sources":["../../use/listInstance.js"],"names":[],"mappings":"AAuCA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AACH,mDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAC,GAClC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAC,CASzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,oEALW,mBAAmB,GAEjB,YAAY,CAsTxB;AA1fD;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;;;;;;;;WAMa,MAAM;;;;kBACN,MAAM;;;;cACN,MAAM;;;;cACN,MAAM;;;;;;;;;WAON,OAAO,KAAK,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;gBAE5D;QAA8D,IAAI,GAAvD,OAAO,uBAAuB,EAAE,MAAM;QAEoB,UAAU,GAAnE,OAAO,uBAAuB,EAAE,YAAY;QAEiB,aAAa,GAAzE,OAAO,uBAAuB,EAAE,eAAe;QAEO,SAAS,GAAjE,OAAO,uBAAuB,EAAE,WAAW;KAEtD;;;;kBAAW,OAAO;;;;;0BAMR;IAAC,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAA;CAAC;;;;6BAM1B,OAAO,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;;;;wBAMvC,OAAO,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;;;;;;;;UAQ7C;QAAwB,IAAI,EAAjB,MAAM;QACU,IAAI;KAC/B;;;;WAAW,MAAM;;;;kBACN,MAAM;;;;cACN,MAAM;;;;aACN,WAAW;;;;aACX,OAAO;;;;cACP,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;aACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;WACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC,CAAC;;;;WACvC,SAAS;;;;oBACT,cAAc;;;;;gCAMf,OAAO,KAAK,EAAE,gBAAgB,CAAC,oBAAoB,CAAC;;;;;;;;yBAOnD,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;kBAClC,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,IAAI;;;;mBAClC,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI;;;;sBAC5B,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI;;;;eAC1B,MAAM,IAAI;;;;eACV,MAAM,MAAM;;;;UACZ,MAAM,OAAO,gCAAgC,EAAE,uBAAuB,CAAC,OAAO,GAAC,KAAK,CAAC;;;;gBACrF,MAAM,OAAO,CAAC,OAAO,CAAC;;;;mBACtB,MAAM,OAAO,CAAC,MAAM,GAAC,MAAM,GAAC,KAAK,CAAC;;;;;qCAMnC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAC;;;;2BAM1B,sBAAsB,GAAG,qBAAqB;;;;;yBApH9C;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC"}

package/types/use/loadingError.d.ts

@@ -4,13 +4,31 @@
 /**
  * @typedef {() => void} ClearErrorFn - Clear the error state.
  */
+/**
+ * @typedef {import("vue").Ref<boolean|undefined>} LoadingRef
+ */
+/**
+ * @typedef {import("vue").Ref<Error|null>} ErrorRef
+ */
+/**
+ * @typedef {import("vue").Ref<boolean>} ErroredRef
+ */
+/**
+ * @typedef {Readonly<LoadingRef>} LoadingReadonlyRef
+ */
+/**
+ * @typedef {Readonly<ErrorRef>} ErrorReadonlyRef
+ */
+/**
+ * @typedef {Readonly<ErroredRef>} ErroredReadonlyRef
+ */
 /**
  * The common API for loading and error states.
  *
  * @typedef {object} LoadingErrorStatus
- * @property {Readonly<import("vue").Ref<boolean|undefined>>} loading - Whether the component is loading.
- * @property {Readonly<import("vue").Ref<Error|null>>} error - The error that occurred.
- * @property {Readonly<import("vue").Ref<boolean>>} errored - Whether an error has occurred.
+ * @property {LoadingReadonlyRef} loading - Whether the component is loading.
+ * @property {ErrorReadonlyRef} error - The error that occurred.
+ * @property {ErroredReadonlyRef} errored - Whether an error has occurred.
  * @property {ClearErrorFn} clearError - Clear the error state.
  */
 /**
@@ -36,6 +54,12 @@ export function useLoadingError(): LoadingError;
  * - Clear the error state.
  */
 export type ClearErrorFn = () => void;
+export type LoadingRef = import("vue").Ref<boolean | undefined>;
+export type ErrorRef = import("vue").Ref<Error | null>;
+export type ErroredRef = import("vue").Ref<boolean>;
+export type LoadingReadonlyRef = Readonly<LoadingRef>;
+export type ErrorReadonlyRef = Readonly<ErrorRef>;
+export type ErroredReadonlyRef = Readonly<ErroredRef>;
 /**
  * The common API for loading and error states.
  */
@@ -43,15 +67,15 @@ export type LoadingErrorStatus = {
     /**
      * - Whether the component is loading.
      */
-    loading: Readonly<import("vue").Ref<boolean | undefined>>;
+    loading: LoadingReadonlyRef;
     /**
      * - The error that occurred.
      */
-    error: Readonly<import("vue").Ref<Error | null>>;
+    error: ErrorReadonlyRef;
     /**
      * - Whether an error has occurred.
      */
-    errored: Readonly<import("vue").Ref<boolean>>;
+    errored: ErroredReadonlyRef;
     /**
      * - Clear the error state.
      */

package/types/use/loadingError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadingError.d.ts","sourceRoot":"","sources":["../../use/loadingError.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;GAIG;AAEH;;;;GAIG;AACH,mCAFa,YAAY,CA6BxB;;;;2BA5DY,MAAM,IAAI;;;;;;;;aAOT,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,GAAC,SAAS,CAAC,CAAC;;;;WAC9C,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC,CAAC;;;;aACvC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;gBACpC,YAAY;;;;;;;;;gBAOZ,MAAM,IAAI;;;;kBACV,MAAM,IAAI;;;;cACV,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;;;;;2BAMvB,kBAAkB,GAAG,qBAAqB"}
+{"version":3,"file":"loadingError.d.ts","sourceRoot":"","sources":["../../use/loadingError.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;GAIG;AAEH;;;;GAIG;AACH,mCAFa,YAAY,CA6BxB;;;;2BApFY,MAAM,IAAI;yBAIV,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,GAAC,SAAS,CAAC;uBAIpC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC;yBAI7B,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;iCAI1B,QAAQ,CAAC,UAAU,CAAC;+BAIpB,QAAQ,CAAC,QAAQ,CAAC;iCAIlB,QAAQ,CAAC,UAAU,CAAC;;;;;;;;aAOnB,kBAAkB;;;;WAClB,gBAAgB;;;;aAChB,kBAAkB;;;;gBAClB,YAAY;;;;;;;;;gBAOZ,MAAM,IAAI;;;;kBACV,MAAM,IAAI;;;;cACV,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;;;;;2BAMvB,kBAAkB,GAAG,qBAAqB"}

package/types/use/objectInstance.d.ts

@@ -70,14 +70,20 @@ export function useObjectInstance({ props, functions }: ObjectInstanceOptions):
 /**
  * The object being managed by the instance. Empty object is the default.
  *
- * @typedef {{pkKey: string, [key: string]: any}|{}} CrudObject
+ * @typedef {{pkKey: string, [key: string]: any}} ExistingCrudObject
+ */
+/**
+ * @typedef {{[key: string]: any}} NewCrudObject
+ */
+/**
+ * @typedef {ExistingCrudObject|NewCrudObject} CrudObject
  */
 /**
  * Arguments to be passed to the object instance.
  *
  * @typedef {object} ObjectInstanceOptions
  * @property {import('vue').UnwrapNestedRefs<ObjectInstanceRawProps>} props - The reactive configuration object.
- * @property {import('../config/objectCrud.js').ObjectCrudFunctions} functions - An object of custom crud functions to use instead of the defaults.
+ * @property {import('../config/objectCrud.js').ObjectCrudFunctions} [functions] - An object of custom crud functions to use instead of the defaults.
  */
 /**
  * Reactive arguments to be passed to the object instance.
@@ -88,35 +94,45 @@ export function useObjectInstance({ props, functions }: ObjectInstanceOptions):
  * @property {object} retrieveArgs - The arguments to be passed to the retrieve function.
  * @property {import('../config/objectCrud.js').ObjectCrudArgs} crudArgs - The arguments to be passed to the crud functions.
  */
+/**
+ * @typedef {object} ObjectInstanceRawStateCrud
+ * @property {import('vue').Reactive<import('../config/objectCrud.js').ObjectCrudArgsArgs|{}>} args - The arguments to be passed to the crud functions.
+ * @property {import('../config/objectCrud.js').CrudCreateFn} create - The create function.
+ * @property {import('../config/objectCrud.js').CrudRetrieveFn} retrieve - The retrieve function.
+ * @property {import('../config/objectCrud.js').CrudUpdateFn} update - The update function.
+ * @property {import('../config/objectCrud.js').CrudPatchFn} patch - The patch function.
+ * @property {import('../config/objectCrud.js').CrudDeleteFn} delete - The delete function.
+ * @property {import('../config/objectCrud.js').CrudSubscribeFn} subscribe - The subscribe function.
+ */
 /**
  * The raw state of the object instance.
  *
  * @typedef {object} ObjectInstanceRawState
- * @property {import('../config/objectCrud.js').ObjectCrudArgs} crud - The crud functions.
- * @property {string} pk - The pk of the object.
- * @property {string} pkKey - The pk key of the object.
- * @property {object} retrieveArgs - The arguments to be passed to the retrieve function.
- * @property {CrudObject} object - The object.
+ * @property {import('vue').ShallowReactive<ObjectInstanceRawStateCrud>} crud - The crud functions.
+ * @property {import('vue').Ref<string|undefined>} pk - The pk of the object.
+ * @property {import('vue').Ref<string|undefined>} pkKey - The pk key of the object.
+ * @property {import('vue').Ref<{[key:string]: any}>} retrieveArgs - The arguments to be passed to the retrieve function.
+ * @property {import('vue').Reactive<CrudObject>} object - The object.
  * @property {Readonly<import('vue').Ref<boolean>>} loading - Whether the object is loading.
  * @property {Readonly<import('vue').Ref<boolean>>} errored - Whether the object errored.
  * @property {Readonly<import('vue').Ref<Error|null>>} error - The error.
- * @property {Readonly<import('vue').Ref<boolean>>} deleted - Whether the object is deleted.
+ * @property {boolean} deleted - Whether the object is deleted.
  */
 /**
  * Manages a reactive state of an object including its CRUD status, loading states, and any operational errors.
  * Reactivity ensures that any changes in state immediately reflect in the UI components that depend on this state.
  *
- * @typedef {import('vue').UnwrapNestedRefs<ObjectInstanceRawState>} ObjectInstanceState
+ * @typedef {import('vue').Reactive<ObjectInstanceRawState>} ObjectInstanceState
  */
 /**
  * The functions available on the object instance.
  *
  * @typedef {object} ObjectInstanceFunctions
- * @property {(args: { object: object }) => Promise<boolean>} create - Called to turn the current object into a new object on the server.
- * @property {() => Promise<boolean>} retrieve - Called to retrieve the current object by pk from the server.
- * @property {(args: { object: CrudObject }) => Promise<boolean>} update - Called to update the current object on the server.
- * @property {() => Promise<boolean>} delete - Called to delete the current object on the server.
- * @property {(args: { partialObject: CrudObject }) => Promise<boolean>} patch - Called to patch the current object on the server.
+ * @property {(args: { object: object }) => import('../utils/cancellablePromise.js').MaybeCancellablePromise<boolean>} create - Called to turn the current object into a new object on the server.
+ * @property {() => import('../utils/cancellablePromise.js').MaybeCancellablePromise<boolean>} retrieve - Called to retrieve the current object by pk from the server.
+ * @property {(args: { object: ExistingCrudObject }) => import('../utils/cancellablePromise.js').MaybeCancellablePromise<boolean>} update - Called to update the current object on the server.
+ * @property {() => import('../utils/cancellablePromise.js').MaybeCancellablePromise<boolean>} delete - Called to delete the current object on the server.
+ * @property {(args: { partialObject: ExistingCrudObject }) => import('../utils/cancellablePromise.js').MaybeCancellablePromise<boolean>} patch - Called to patch the current object on the server.
  * @property {import('./loadingError.js').ClearErrorFn} clearError - Called to clear the error state.
  * @property {() => void} clear - Called to clear the object state.
  */
@@ -150,10 +166,14 @@ export const objectInstanceFunctions: string[];
 /**
  * The object being managed by the instance. Empty object is the default.
  */
-export type CrudObject = {
+export type ExistingCrudObject = {
     pkKey: string;
     [key: string]: any;
-} | {};
+};
+export type NewCrudObject = {
+    [key: string]: any;
+};
+export type CrudObject = ExistingCrudObject | NewCrudObject;
 /**
  * Arguments to be passed to the object instance.
  */
@@ -165,7 +185,7 @@ export type ObjectInstanceOptions = {
     /**
      * - An object of custom crud functions to use instead of the defaults.
      */
-    functions: import("../config/objectCrud.js").ObjectCrudFunctions;
+    functions?: import("../config/objectCrud.js").ObjectCrudFunctions;
 };
 /**
  * Reactive arguments to be passed to the object instance.
@@ -188,6 +208,36 @@ export type ObjectInstanceRawProps = {
      */
     crudArgs: import("../config/objectCrud.js").ObjectCrudArgs;
 };
+export type ObjectInstanceRawStateCrud = {
+    /**
+     * - The arguments to be passed to the crud functions.
+     */
+    args: import("vue").Reactive<import("../config/objectCrud.js").ObjectCrudArgsArgs | {}>;
+    /**
+     * - The create function.
+     */
+    create: import("../config/objectCrud.js").CrudCreateFn;
+    /**
+     * - The retrieve function.
+     */
+    retrieve: import("../config/objectCrud.js").CrudRetrieveFn;
+    /**
+     * - The update function.
+     */
+    update: import("../config/objectCrud.js").CrudUpdateFn;
+    /**
+     * - The patch function.
+     */
+    patch: import("../config/objectCrud.js").CrudPatchFn;
+    /**
+     * - The delete function.
+     */
+    delete: import("../config/objectCrud.js").CrudDeleteFn;
+    /**
+     * - The subscribe function.
+     */
+    subscribe: import("../config/objectCrud.js").CrudSubscribeFn;
+};
 /**
  * The raw state of the object instance.
  */
@@ -195,23 +245,25 @@ export type ObjectInstanceRawState = {
     /**
      * - The crud functions.
      */
-    crud: import("../config/objectCrud.js").ObjectCrudArgs;
+    crud: import("vue").ShallowReactive<ObjectInstanceRawStateCrud>;
     /**
      * - The pk of the object.
      */
-    pk: string;
+    pk: import("vue").Ref<string | undefined>;
     /**
      * - The pk key of the object.
      */
-    pkKey: string;
+    pkKey: import("vue").Ref<string | undefined>;
     /**
      * - The arguments to be passed to the retrieve function.
      */
-    retrieveArgs: object;
+    retrieveArgs: import("vue").Ref<{
+        [key: string]: any;
+    }>;
     /**
      * - The object.
      */
-    object: CrudObject;
+    object: import("vue").Reactive<CrudObject>;
     /**
      * - Whether the object is loading.
      */
@@ -227,13 +279,13 @@ export type ObjectInstanceRawState = {
     /**
      * - Whether the object is deleted.
      */
-    deleted: Readonly<import("vue").Ref<boolean>>;
+    deleted: boolean;
 };
 /**
  * Manages a reactive state of an object including its CRUD status, loading states, and any operational errors.
  * Reactivity ensures that any changes in state immediately reflect in the UI components that depend on this state.
  */
-export type ObjectInstanceState = import("vue").UnwrapNestedRefs<ObjectInstanceRawState>;
+export type ObjectInstanceState = import("vue").Reactive<ObjectInstanceRawState>;
 /**
  * The functions available on the object instance.
  */
@@ -243,27 +295,27 @@ export type ObjectInstanceFunctions = {
      */
     create: (args: {
         object: object;
-    }) => Promise<boolean>;
+    }) => import("../utils/cancellablePromise.js").MaybeCancellablePromise<boolean>;
     /**
      * - Called to retrieve the current object by pk from the server.
      */
-    retrieve: () => Promise<boolean>;
+    retrieve: () => import("../utils/cancellablePromise.js").MaybeCancellablePromise<boolean>;
     /**
      * - Called to update the current object on the server.
      */
     update: (args: {
-        object: CrudObject;
-    }) => Promise<boolean>;
+        object: ExistingCrudObject;
+    }) => import("../utils/cancellablePromise.js").MaybeCancellablePromise<boolean>;
     /**
      * - Called to delete the current object on the server.
      */
-    delete: () => Promise<boolean>;
+    delete: () => import("../utils/cancellablePromise.js").MaybeCancellablePromise<boolean>;
     /**
      * - Called to patch the current object on the server.
      */
     patch: (args: {
-        partialObject: CrudObject;
-    }) => Promise<boolean>;
+        partialObject: ExistingCrudObject;
+    }) => import("../utils/cancellablePromise.js").MaybeCancellablePromise<boolean>;
     /**
      * - Called to clear the error state.
      */

package/types/use/objectInstance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectInstance.d.ts","sourceRoot":"","sources":["../../use/objectInstance.js"],"names":[],"mappings":"AAmHA;;;;;GAKG;AACH,iDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAA;CAAC,GACpC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;CAAC,CAS3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wDAHW,qBAAqB,GACnB,cAAc,CAkM1B;AAjXD;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH;;;;GAIG;AAEH;;;GAGG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;AAED,+CAUE;AAEF,+CAAkH;;;;yBAnGrG;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,GAAC,EAAE;;;;;;;;WAOrC,OAAO,KAAK,EAAE,gBAAgB,CAAC,sBAAsB,CAAC;;;;eACtD,OAAO,yBAAyB,EAAE,mBAAmB;;;;;;;;;SAOrD,MAAM;;;;WACN,MAAM;;;;kBACN,MAAM;;;;cACN,OAAO,yBAAyB,EAAE,cAAc;;;;;;;;;UAOhD,OAAO,yBAAyB,EAAE,cAAc;;;;QAChD,MAAM;;;;WACN,MAAM;;;;kBACN,MAAM;;;;YACN,UAAU;;;;aACV,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;aACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;WACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,GAAC,IAAI,CAAC,CAAC;;;;aACvC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;;;kCAOrC,OAAO,KAAK,EAAE,gBAAgB,CAAC,sBAAsB,CAAC;;;;;;;;YAOrD,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC;;;;cAC9C,MAAM,OAAO,CAAC,OAAO,CAAC;;;;YACtB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC;;;;YAClD,MAAM,OAAO,CAAC,OAAO,CAAC;;;;WACtB,CAAC,IAAI,EAAE;QAAE,aAAa,EAAE,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC;;;;gBACzD,OAAO,mBAAmB,EAAE,YAAY;;;;WACxC,MAAM,IAAI;;;;;;;;;WAOV,mBAAmB;;;;;6BAMpB,uBAAuB,GAAG,wBAAwB"}
+{"version":3,"file":"objectInstance.d.ts","sourceRoot":"","sources":["../../use/objectInstance.js"],"names":[],"mappings":"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"}

package/types/use/objectSubscription.d.ts

@@ -2,17 +2,17 @@
  * The raw state of the object subscription.
  *
  * @typedef {object} ObjectSubscriptionRawState
- * @property {Readonly<import('vue').Ref<boolean>>} subscriptionLoading - Whether the subscription is loading.
- * @property {Readonly<import('vue').Ref<boolean>>} subscriptionErrored - Whether the subscription has errored.
- * @property {Readonly<import('vue').Ref<Error>>} subscriptionError - The error that occurred.
- * @property {boolean} intendToRetrieve - Whether the object intends to retrieve.
- * @property {boolean} intendToSubscribe - Whether the object intends to subscribe.
- * @property {boolean} subscribed - Whether the object is subscribed.
+ * @property {import('./loadingError.js').LoadingReadonlyRef} subscriptionLoading - Whether the subscription is loading.
+ * @property {import('./loadingError.js').ErroredReadonlyRef} subscriptionErrored - Whether the subscription has errored.
+ * @property {import('./loadingError.js').ErrorReadonlyRef} subscriptionError - The error that occurred.
+ * @property {import('vue').Ref<boolean>} intendToRetrieve - Whether the object intends to retrieve.
+ * @property {import('vue').Ref<boolean>} intendToSubscribe - Whether the object intends to subscribe.
+ * @property {import('vue').Ref<boolean|undefined>} subscribed - Whether the object is subscribed.
  */
 /**
  * The state of the object subscription, including both subscription and object instance states.
  *
- * @typedef {import('vue').UnwrapNestedRefs<
+ * @typedef {import('vue').Reactive<
  *     ObjectSubscriptionRawState &
  *     import('./objectInstance.js').ObjectInstanceRawState
  * >} ObjectSubscriptionState
@@ -21,12 +21,15 @@
  * Functions available for object subscription management.
  *
  * @typedef {object} ObjectSubscriptionFunctions
- * @property {({ retrieve }?: { retrieve?: boolean }) => boolean} subscribe - Subscribes to updates from an object, managing subscription state and
- *  handling errors internally. Ensures that only one active subscription can exist at a time to prevent duplicate
- *  calls. Returns a promise that resolves to true if the subscription was successful, and false if it failed.
+ * @property {(
+ *     (options?: { retrieve?: boolean }) => boolean
+ * )} subscribe - Subscribes to updates from an object, managing subscription state and handling errors internally.
+ *  Ensures that only one active subscription can exist at a time to prevent duplicate calls. Returns a promise that
+ *  resolves to true if the subscription was successful, and false if it failed.
  * @property {() => boolean} unsubscribe - Unsubscribes from the object, resetting related state flags. Returns
  *  true if the object was unsubscribed, and false if it was not subscribed.
- * @property {(data: import('./objectInstance.js').CrudObject) => void} updateFromSubscription - Update the object from a subscription.
+ * @property {(data: import('./objectInstance.js').ExistingCrudObject) => void} updateFromSubscription - Update the
+ *  object from a subscription.
  * @property {() => void} deleteFromSubscription - Delete the object from a subscription.
  * @property {() => void} clearError - Clears any errors related to the subscription, and resets the loading state.
  */
@@ -49,8 +52,8 @@
  * Raw props for the object subscription.
  *
  * @typedef {object} ObjectSubscriptionRawProps
- * @property {boolean} [intendToRetrieve] - Whether the object intends to retrieve.
- * @property {boolean} [intendToSubscribe] - Whether the object intends to subscribe.
+ * @property {boolean|undefined} intendToRetrieve - Whether the object intends to retrieve.
+ * @property {boolean|undefined} intendToSubscribe - Whether the object intends to subscribe.
  */
 /**
  * Options for initializing an object subscription, including reactive props and non-reactive functions.
@@ -144,53 +147,54 @@ export type ObjectSubscriptionRawState = {
     /**
      * - Whether the subscription is loading.
      */
-    subscriptionLoading: Readonly<import("vue").Ref<boolean>>;
+    subscriptionLoading: import("./loadingError.js").LoadingReadonlyRef;
     /**
      * - Whether the subscription has errored.
      */
-    subscriptionErrored: Readonly<import("vue").Ref<boolean>>;
+    subscriptionErrored: import("./loadingError.js").ErroredReadonlyRef;
     /**
      * - The error that occurred.
      */
-    subscriptionError: Readonly<import("vue").Ref<Error>>;
+    subscriptionError: import("./loadingError.js").ErrorReadonlyRef;
     /**
      * - Whether the object intends to retrieve.
      */
-    intendToRetrieve: boolean;
+    intendToRetrieve: import("vue").Ref<boolean>;
     /**
      * - Whether the object intends to subscribe.
      */
-    intendToSubscribe: boolean;
+    intendToSubscribe: import("vue").Ref<boolean>;
     /**
      * - Whether the object is subscribed.
      */
-    subscribed: boolean;
+    subscribed: import("vue").Ref<boolean | undefined>;
 };
 /**
  * The state of the object subscription, including both subscription and object instance states.
  */
-export type ObjectSubscriptionState = import("vue").UnwrapNestedRefs<ObjectSubscriptionRawState & import("./objectInstance.js").ObjectInstanceRawState>;
+export type ObjectSubscriptionState = import("vue").Reactive<ObjectSubscriptionRawState & import("./objectInstance.js").ObjectInstanceRawState>;
 /**
  * Functions available for object subscription management.
  */
 export type ObjectSubscriptionFunctions = {
     /**
-     * - Subscribes to updates from an object, managing subscription state and
-     * handling errors internally. Ensures that only one active subscription can exist at a time to prevent duplicate
-     * calls. Returns a promise that resolves to true if the subscription was successful, and false if it failed.
+     * - Subscribes to updates from an object, managing subscription state and handling errors internally.
+     * Ensures that only one active subscription can exist at a time to prevent duplicate calls. Returns a promise that
+     * resolves to true if the subscription was successful, and false if it failed.
      */
-    subscribe: ({ retrieve }?: {
+    subscribe: ((options?: {
         retrieve?: boolean;
-    }) => boolean;
+    }) => boolean);
     /**
      * - Unsubscribes from the object, resetting related state flags. Returns
      * true if the object was unsubscribed, and false if it was not subscribed.
      */
     unsubscribe: () => boolean;
     /**
-     * - Update the object from a subscription.
+     * - Update the
+     * object from a subscription.
      */
-    updateFromSubscription: (data: import("./objectInstance.js").CrudObject) => void;
+    updateFromSubscription: (data: import("./objectInstance.js").ExistingCrudObject) => void;
     /**
      * - Delete the object from a subscription.
      */
@@ -236,11 +240,11 @@ export type ObjectSubscriptionRawProps = {
     /**
      * - Whether the object intends to retrieve.
      */
-    intendToRetrieve?: boolean;
+    intendToRetrieve: boolean | undefined;
     /**
      * - Whether the object intends to subscribe.
      */
-    intendToSubscribe?: boolean;
+    intendToSubscribe: boolean | undefined;
 };
 /**
  * Options for initializing an object subscription, including reactive props and non-reactive functions.

package/types/use/objectSubscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectSubscription.d.ts","sourceRoot":"","sources":["../../use/objectSubscription.js"],"names":[],"mappings":"AA+CA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AAGH;;;;;;;;;;;;GAYG;AAGH;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,yDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAA;CAAC,GACxC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAC,CAS/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,4EAHW,yBAAyB,GACvB,kBAAkB,CA6M9B;AAtXD;;;;GAIG;AAEH;;GAEG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;AAED,mDAOE;AAEF,mDAME;;;;;;;;yBAMY,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;yBACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;;;;uBACpC,QAAQ,CAAC,OAAO,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;;;;sBAClC,OAAO;;;;uBACP,OAAO;;;;gBACP,OAAO;;;;;sCAMR,OAAO,KAAK,EAAE,gBAAgB,CACpC,0BAA0B,GAChC,OAAa,qBAAqB,EAAE,sBAAsB,CACvD;;;;;;;;;;eAQU,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO;;;;;iBAGlD,MAAM,OAAO;;;;4BAEb,CAAC,IAAI,EAAE,OAAO,qBAAqB,EAAE,UAAU,KAAK,IAAI;;;;4BACxD,MAAM,IAAI;;;;gBACV,MAAM,IAAI;;;;;;;;;WAQV,uBAAuB;;;;oBACvB,OAAO,qBAAqB,EAAE,cAAc;;;;qBAC5C,OAAO,wBAAwB,EAAE,iBAAiB;;;;oBAClD,OAAO,wBAAwB,EAAE,iBAAiB;;;;iBAClD,OAAO,KAAK,EAAE,WAAW;;;;;iCAM1B,4BAA4B,GAAG,2BAA2B;;;;;;;;uBAOzD,OAAO;;;;wBACP,OAAO;;;;;wCAMR,MAAM,GAAG,OAAO,qBAAqB,EAAE,qBAAqB"}
+{"version":3,"file":"objectSubscription.d.ts","sourceRoot":"","sources":["../../use/objectSubscription.js"],"names":[],"mappings":"AAgDA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,yDAHW;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAA;CAAC,GACxC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAC,CAS/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,4EAHW,yBAAyB,GACvB,kBAAkB,CA0M9B;AApXD;;;;GAIG;AAEH;;GAEG;AACH;IACI;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IADG,aAAgB;CAEvB;AAED,mDAOE;AAEF,mDAME;;;;;;;;yBAMY,OAAO,mBAAmB,EAAE,kBAAkB;;;;yBAC9C,OAAO,mBAAmB,EAAE,kBAAkB;;;;uBAC9C,OAAO,mBAAmB,EAAE,gBAAgB;;;;sBAC5C,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;;;;uBAC1B,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;;;;gBAC1B,OAAO,KAAK,EAAE,GAAG,CAAC,OAAO,GAAC,SAAS,CAAC;;;;;sCAMrC,OAAO,KAAK,EAAE,QAAQ,CAC5B,0BAA0B,GAChC,OAAa,qBAAqB,EAAE,sBAAsB,CACvD;;;;;;;;;;eAOU,CACb,CAAO,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAChD;;;;;iBAGU,MAAM,OAAO;;;;;4BAEb,CAAC,IAAI,EAAE,OAAO,qBAAqB,EAAE,kBAAkB,KAAK,IAAI;;;;4BAEhE,MAAM,IAAI;;;;gBACV,MAAM,IAAI;;;;;;;;;WAOV,uBAAuB;;;;oBACvB,OAAO,qBAAqB,EAAE,cAAc;;;;qBAC5C,OAAO,wBAAwB,EAAE,iBAAiB;;;;oBAClD,OAAO,wBAAwB,EAAE,iBAAiB;;;;iBAClD,OAAO,KAAK,EAAE,WAAW;;;;;iCAM1B,4BAA4B,GAAG,2BAA2B;;;;;;;;sBAOzD,OAAO,GAAC,SAAS;;;;uBACjB,OAAO,GAAC,SAAS;;;;;wCAMlB,MAAM,GAAG,OAAO,qBAAqB,EAAE,qBAAqB"}

package/types/use/proxyLoadingError.d.ts

@@ -1,36 +1,21 @@
-/**
- * @typedef {(
- *     import('./loadingError.js').LoadingErrorStatus[]
- * )} WatchableLoadingErrorsRaw
- */
 /**
  * A watchable collection of loading errors.
  *
  * @typedef {(
- *     import('vue').UnwrapNestedRefs<WatchableLoadingErrorsRaw> |
- *     import('vue').Ref<WatchableLoadingErrorsRaw> |
- *     WatchableLoadingErrorsRaw
- * )} WatchableLoadingErrors
- */
-/**
- * The instance of useProxyLoadingError.
- *
- * @typedef {import('./loadingError.js').LoadingErrorStatus} ProxyLoadingError
+ *     import('vue').UnwrapNestedRefs<import('./loadingError.js').LoadingErrorStatus> |
+ *     import('vue').Ref<import('./loadingError.js').LoadingErrorStatus> |
+ *     import('./loadingError.js').LoadingErrorStatus
+ * )} WatchableLoadingError
  */
 /**
  * A composable function for managing aggregated loading and error states across multiple sources.
  *
- * @param {WatchableLoadingErrors} loadingErrors - A collection of loading error statuses to monitor and aggregate.
- * @returns {ProxyLoadingError} An object containing aggregated reactive fields and actions for loading and error states.
+ * @param {WatchableLoadingError[]} loadingErrors - A collection of loading error statuses to monitor and aggregate.
+ * @returns {import('./loadingError.js').LoadingErrorStatus} An object containing aggregated reactive fields and actions for loading and error states.
  */
-export function useProxyLoadingError(loadingErrors: WatchableLoadingErrors): ProxyLoadingError;
-export type WatchableLoadingErrorsRaw = (import("./loadingError.js").LoadingErrorStatus[]);
+export function useProxyLoadingError(loadingErrors: WatchableLoadingError[]): import("./loadingError.js").LoadingErrorStatus;
 /**
  * A watchable collection of loading errors.
  */
-export type WatchableLoadingErrors = (import("vue").UnwrapNestedRefs<WatchableLoadingErrorsRaw> | import("vue").Ref<WatchableLoadingErrorsRaw> | WatchableLoadingErrorsRaw);
-/**
- * The instance of useProxyLoadingError.
- */
-export type ProxyLoadingError = import("./loadingError.js").LoadingErrorStatus;
+export type WatchableLoadingError = (import("vue").UnwrapNestedRefs<import("./loadingError.js").LoadingErrorStatus> | import("vue").Ref<import("./loadingError.js").LoadingErrorStatus> | import("./loadingError.js").LoadingErrorStatus);
 //# sourceMappingURL=proxyLoadingError.d.ts.map

package/types/use/proxyLoadingError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxyLoadingError.d.ts","sourceRoot":"","sources":["../../use/proxyLoadingError.js"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH;;;;;GAKG;AACH,oDAHW,sBAAsB,GACpB,iBAAiB,CA6B7B;wCAtDY,CACZ,OAAa,mBAAmB,EAAE,kBAAkB,EAAE,CACnD;;;;qCAMS,CACZ,OAAa,KAAK,EAAE,gBAAgB,CAAC,yBAAyB,CAAC,GAC/D,OAAa,KAAK,EAAE,GAAG,CAAC,yBAAyB,CAAC,GAC5C,yBAAyB,CAC5B;;;;gCAMS,OAAO,mBAAmB,EAAE,kBAAkB"}
+{"version":3,"file":"proxyLoadingError.d.ts","sourceRoot":"","sources":["../../use/proxyLoadingError.js"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,oDAHW,qBAAqB,EAAE,GACrB,OAAO,mBAAmB,EAAE,kBAAkB,CA2B1D;;;;oCAtCY,CACZ,OAAa,KAAK,EAAE,gBAAgB,CAAC,OAAO,mBAAmB,EAAE,kBAAkB,CAAC,GACpF,OAAa,KAAK,EAAE,GAAG,CAAC,OAAO,mBAAmB,EAAE,kBAAkB,CAAC,GACvE,OAAa,mBAAmB,EAAE,kBAAkB,CACjD"}

package/types/utils/cancellableFetch.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A wrapper around fetch that adds cancellation via AbortController and returns a CancellablePromise.
+ *
+ * @template T
+ * @param {RequestInfo} input - The URL or Request object to fetch.
+ * @param {RequestInit} init - The options for the fetch request.
+ * @param {(response: Response) => Promise<T>} transform - A function to transform the response.
+ * @returns {CancellablePromise<T>} A cancellable promise that resolves to the transformed response.
+ */
+export function cancellableFetch<T>(input: RequestInfo, init: RequestInit, transform: (response: Response) => Promise<T>): CancellablePromise<T>;
+import { CancellablePromise } from "./cancellablePromise.js";
+//# sourceMappingURL=cancellableFetch.d.ts.map

package/types/utils/cancellableFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellableFetch.d.ts","sourceRoot":"","sources":["../../utils/cancellableFetch.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,iCANa,CAAC,SACH,WAAW,QACX,WAAW,aACX,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAChC,kBAAkB,CAAC,CAAC,CAAC,CAYjC;mCArBkC,yBAAyB"}

package/types/utils/cancellablePromise.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Wraps a promise and optionally adds a cancel method if provided.
+ *
+ * @template T
+ * @param {Promise<T>} inner - The inner promise to wrap.
+ * @param {(() => Promise<void> | void)=} cancel - Optional cancel function.
+ * @returns {MaybeCancellablePromise<T>} The wrapped promise with an optional cancel method.
+ */
+export function wrapMaybeCancellable<T>(inner: Promise<T>, cancel?: (() => Promise<void> | void) | undefined): MaybeCancellablePromise<T>;
+export function CancellablePromise<T>(promise: Promise<T>, cancel: () => (Promise<void> | void)): CancellablePromise<T>;
+/**
+ * A Promise that can be cancelled.
+ */
+export type CancellablePromise<T> = Promise<T> & {
+    cancel: (reason?: any) => Promise<void> | void;
+};
+export namespace CancellablePromise {
+    /**
+     * Creates a rejected 'cancellable' promise.
+     *
+     * @param {any} reason - The reason for the rejection.
+     * @returns {MaybeCancellablePromise<never>} A rejected 'cancellable' promise.
+     */
+    function reject(reason: any): MaybeCancellablePromise<never>;
+    /**
+     * Creates a resolved 'cancellable' promise.
+     *
+     * @template T
+     * @param {T} value - The value to resolve the promise with.
+     * @returns {MaybeCancellablePromise<T>} A resolved 'cancellable' promise.
+     */
+    function resolve<T_1>(value: T_1): MaybeCancellablePromise<T_1>;
+}
+/**
+ * A possibly cancellable promise.
+ */
+export type MaybeCancellablePromise<T> = Promise<T> & {
+    cancel?: (reason?: any) => Promise<void> | void;
+};
+//# sourceMappingURL=cancellablePromise.d.ts.map

package/types/utils/cancellablePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellablePromise.d.ts","sourceRoot":"","sources":["../../utils/cancellablePromise.js"],"names":[],"mappings":"AAiDA;;;;;;;GAOG;AACH,qCALa,CAAC,SACH,OAAO,CAAC,CAAC,CAAC,WACV,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,YAAC,GAC3B,uBAAuB,CAAC,CAAC,CAAC,CActC;AA/CM,mCALM,CAAC,WACH,OAAO,CAAC,CAAC,CAAC,UACV,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,CAAC,GACxB,kBAAkB,CAAC,CAAC,CAAC,CAMjC;;;;+BAvBY,CAAC,IACD,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE;;IAwB5E;;;;;OAKG;IACH,wBAHW,GAAG,GACD,uBAAuB,CAAC,KAAK,CAAC,CAI1C;IAED;;;;;;OAMG;IACH,6BAHW,GAAC,GACC,uBAAuB,CAAC,GAAC,CAAC,CAItC;;;;;oCArCY,CAAC,IACD,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE"}

package/types/utils/deepUnref.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Recursively unwraps refs from a nested object, array, or primitive.
+ *
+ * @template T
+ * @typedef {T extends import('vue').Ref<infer U>
+ *   ? DeepUnwrap<U>
+ *   : T extends Array<infer V>
+ *     ? Array<DeepUnwrap<V>>
+ *     : T extends object
+ *       ? { [K in keyof T]: DeepUnwrap<T[K]> }
+ *       : T
+ * } DeepUnwrap
+ */
+/**
+ * Safe, recursively-typed deep unref.
+ *
+ * @template T
+ * @param {T} val - The value to deeply unwrap.
+ * @returns {DeepUnwrap<T>} - The deeply unwrapped value.
+ */
+export const deepUnref: any;
+/**
+ * Recursively unwraps refs from a nested object, array, or primitive.
+ */
+export type DeepUnwrap<T_1> = T_1 extends import("vue").Ref<infer U> ? DeepUnwrap<U> : T_1 extends Array<infer V> ? Array<DeepUnwrap<V>> : T_1 extends object ? { [K in keyof T_1]: DeepUnwrap<T_1[K]>; } : T_1;
+//# sourceMappingURL=deepUnref.d.ts.map