@yaasl/core 0.11.0-alpha.1 → 0.11.0-alpha.2

package/dist/@types/effects/EffectDispatcher.d.ts

@@ -1,9 +1,10 @@
-import type { ActionType, EffectAtomCallback } from "./createEffect";
+import type { ActionType, EffectAtomCallback, EffectMeta } from "./createEffect";
 import type { Atom } from "../base/createAtom";
 export declare class EffectActions<Value> {
     private readonly atom;
-    private options;
-    private actions;
+    readonly meta?: EffectMeta;
+    private readonly options;
+    private readonly actions;
     constructor(atom: Atom<Value>, effectCreator: EffectAtomCallback<unknown, Value>);
     createAction(action: ActionType): ((prev: Value) => Value | PromiseLike<Value>) | undefined;
 }

package/dist/@types/effects/createEffect.d.ts

@@ -23,9 +23,14 @@ interface EffectSetupProps<Options, AtomValue> {
     atom: Atom<AtomValue>;
     options: Options;
 }
+export interface EffectMeta {
+    /** Enforce a position of the effect in the execution order */
+    sort?: "pre" | "post";
+}
 export type EffectAtomCallback<Options = unknown, AtomValue = unknown> = (atom: Atom<AtomValue>) => Effect<Options, AtomValue>;
-type EffectSetup<Options, AtomValue> = EffectActions<Options, AtomValue> | ((props: EffectSetupProps<Options, AtomValue>) => EffectActions<Options, AtomValue>);
+type EffectSetup<Options, AtomValue> = (EffectMeta & EffectActions<Options, AtomValue>) | ((props: EffectSetupProps<Options, AtomValue>) => EffectMeta & EffectActions<Options, AtomValue>);
 export interface Effect<Options = unknown, AtomValue = unknown> {
+    meta: EffectMeta;
     options: Options;
     actions: EffectActions<Options, AtomValue>;
 }
@@ -41,6 +46,8 @@ export interface Effect<Options = unknown, AtomValue = unknown> {
  *
  * @param setup Effect actions or function to create effect actions.
  *   Effect actions are fired in the atom lifecycle, alongside to the subscriptions.
+ *   Additionally, you can pass a `sort` option, which will enforce a position of the
+ *   effect in the execution order.
  *
  * @returns The effect to be used on atoms.
  **/

package/dist/cjs/effects/EffectDispatcher.js

@@ -7,7 +7,8 @@ const isTruthy = (value) => !!value;
 class EffectActions {
     constructor(atom, effectCreator) {
         this.atom = atom;
-        const { actions, options } = effectCreator(atom);
+        const { meta, actions, options } = effectCreator(atom);
+        this.meta = meta;
         this.options = options;
         this.actions = actions;
     }
@@ -35,7 +36,16 @@ class EffectDispatcher {
     constructor(atom, effects) {
         this.effects = [];
         this.queue = new Queue_1.Queue();
-        this.effects = effects.map(create => new EffectActions(atom, create));
+        this.effects = effects
+            .map(create => new EffectActions(atom, create))
+            .sort((a, b) => {
+            var _a, _b, _c, _d;
+            return ((_a = a.meta) === null || _a === void 0 ? void 0 : _a.sort) === "pre" || ((_b = b.meta) === null || _b === void 0 ? void 0 : _b.sort) === "post"
+                ? -1
+                : ((_c = a.meta) === null || _c === void 0 ? void 0 : _c.sort) === "post" || ((_d = b.meta) === null || _d === void 0 ? void 0 : _d.sort) === "pre"
+                    ? 1
+                    : 0;
+        });
     }
     dispatch(action, startValue) {
         const tasks = this.effects

package/dist/cjs/effects/createEffect.js

@@ -1,4 +1,15 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEffect = void 0;
 /** Create effects to be used in combination with atoms.
@@ -13,13 +24,17 @@ exports.createEffect = void 0;
  *
  * @param setup Effect actions or function to create effect actions.
  *   Effect actions are fired in the atom lifecycle, alongside to the subscriptions.
+ *   Additionally, you can pass a `sort` option, which will enforce a position of the
+ *   effect in the execution order.
  *
  * @returns The effect to be used on atoms.
  **/
 const createEffect = (setup) => (...[optionsArg]) => (atom) => {
     const options = optionsArg;
-    const actions = setup instanceof Function ? setup({ options, atom }) : setup;
+    const _a = setup instanceof Function ? setup({ options, atom }) : setup, { sort } = _a, actions = __rest(_a, ["sort"]);
+    const meta = { sort };
     return {
+        meta,
         options,
         actions,
     };

package/dist/cjs/effects/indexedDb.js

@@ -28,6 +28,7 @@ exports.indexedDb = (0, createEffect_1.createEffect)(({ atom, options }) => {
     var _a;
     const key = (_a = options === null || options === void 0 ? void 0 : options.key) !== null && _a !== void 0 ? _a : atom.name;
     return {
+        sort: "pre",
         init: (_a) => __awaiter(void 0, [_a], void 0, function* ({ atom, set }) {
             var _b;
             if (!atomDb) {

package/dist/cjs/effects/localStorage.js

@@ -22,6 +22,7 @@ exports.localStorage = (0, createEffect_1.createEffect)(({ atom, options = {} })
         onTabSync: noTabSync ? undefined : value => atom.set(value),
     });
     return {
+        sort: "pre",
         init: ({ set }) => {
             const existing = storage.get();
             if (existing != null) {

package/dist/esm/effects/EffectDispatcher.js

@@ -3,11 +3,13 @@ import { Queue } from "../utils/Queue";
 const isTruthy = (value) => !!value;
 export class EffectActions {
     atom;
+    meta;
     options;
     actions;
     constructor(atom, effectCreator) {
         this.atom = atom;
-        const { actions, options } = effectCreator(atom);
+        const { meta, actions, options } = effectCreator(atom);
+        this.meta = meta;
         this.options = options;
         this.actions = actions;
     }
@@ -34,7 +36,13 @@ export class EffectDispatcher {
     effects = [];
     queue = new Queue();
     constructor(atom, effects) {
-        this.effects = effects.map(create => new EffectActions(atom, create));
+        this.effects = effects
+            .map(create => new EffectActions(atom, create))
+            .sort((a, b) => a.meta?.sort === "pre" || b.meta?.sort === "post"
+            ? -1
+            : a.meta?.sort === "post" || b.meta?.sort === "pre"
+                ? 1
+                : 0);
     }
     dispatch(action, startValue) {
         const tasks = this.effects

package/dist/esm/effects/createEffect.js

@@ -10,13 +10,17 @@
  *
  * @param setup Effect actions or function to create effect actions.
  *   Effect actions are fired in the atom lifecycle, alongside to the subscriptions.
+ *   Additionally, you can pass a `sort` option, which will enforce a position of the
+ *   effect in the execution order.
  *
  * @returns The effect to be used on atoms.
  **/
 export const createEffect = (setup) => (...[optionsArg]) => (atom) => {
     const options = optionsArg;
-    const actions = setup instanceof Function ? setup({ options, atom }) : setup;
+    const { sort, ...actions } = setup instanceof Function ? setup({ options, atom }) : setup;
+    const meta = { sort };
     return {
+        meta,
         options,
         actions,
     };

package/dist/esm/effects/indexedDb.js

@@ -15,6 +15,7 @@ let atomDb = null;
 export const indexedDb = createEffect(({ atom, options }) => {
     const key = options?.key ?? atom.name;
     return {
+        sort: "pre",
         init: async ({ atom, set }) => {
             if (!atomDb) {
                 atomDb = new Store(CONFIG.name ?? "yaasl");

package/dist/esm/effects/localStorage.js

@@ -19,6 +19,7 @@ export const localStorage = createEffect(({ atom, options = {} }) => {
         onTabSync: noTabSync ? undefined : value => atom.set(value),
     });
     return {
+        sort: "pre",
         init: ({ set }) => {
             const existing = storage.get();
             if (existing != null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaasl/core",
-  "version": "0.11.0-alpha.1",
+  "version": "0.11.0-alpha.2",
   "description": "yet another atomic store library (vanilla-js)",
   "author": "PrettyCoffee",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "validate": "run-s lint test build"
   },
   "dependencies": {
-    "@yaasl/utils": "0.11.0-alpha.1"
+    "@yaasl/utils": "0.11.0-alpha.2"
   },
   "eslintConfig": {
     "extends": [