@praxisjs/store 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @praxisjs/store
 
+## 0.2.2
+
+### Patch Changes
+
+- fe39901: fix(store): fix `TypeError` when assigning symbol keys on the store Proxy
+
+  The Proxy `set` trap returned `false` for non-string keys (symbols). In ES modules with strict mode, returning `false` from a `set` trap throws `TypeError: 'set' on proxy: trap returned falsish`. This broke internal JavaScript operations that use symbol keys (e.g. `Symbol.toPrimitive`, `Symbol.iterator`).
+
+  The fix returns `true` in those cases, silently ignoring the assignment — the correct behaviour, since the store only manages string keys.
+
+- Updated dependencies [fe39901]
+  - @praxisjs/core@0.4.1
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/__tests__/create-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-store.test.d.ts.map

package/dist/__tests__/create-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-store.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/create-store.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/create-store.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect } from "vitest";
+import { createStore } from "../create-store";
+function makeCounter() {
+    return createStore({
+        count: 0,
+        step: 1,
+        increment() {
+            this.count +=
+                this.step;
+        },
+        decrement() {
+            this.count--;
+        },
+    })();
+}
+describe("createStore", () => {
+    it("returns a factory that provides the store proxy", () => {
+        const store = makeCounter();
+        expect(store).toBeDefined();
+    });
+    it("reads signal state via property access", () => {
+        const store = makeCounter();
+        expect(store.count).toBe(0);
+    });
+    it("sets signal state via property assignment", () => {
+        const store = makeCounter();
+        store.count = 5;
+        expect(store.count).toBe(5);
+    });
+    it("calls methods bound to the store proxy", () => {
+        const store = makeCounter();
+        store.increment();
+        expect(store.count).toBe(1);
+    });
+    it("$state returns a plain snapshot of all state", () => {
+        const store = makeCounter();
+        const state = store.$state();
+        expect(state).toEqual({ count: 0, step: 1 });
+    });
+    it("$patch updates multiple keys at once", () => {
+        const store = makeCounter();
+        store.$patch({ count: 10, step: 5 });
+        expect(store.count).toBe(10);
+        expect(store.step).toBe(5);
+    });
+    it("$reset restores initial values", () => {
+        const store = makeCounter();
+        store.count = 99;
+        store.$reset();
+        expect(store.count).toBe(0);
+    });
+    it("$subscribe calls listener with state snapshot on each change", () => {
+        const store = makeCounter();
+        const snapshots = [];
+        store.$subscribe((s) => snapshots.push(s.count));
+        store.count = 42;
+        store.count = 99;
+        expect(snapshots).toEqual([0, 42, 99]);
+    });
+    it("definition getters are exposed on the store proxy", () => {
+        const definition = {
+            a: 2,
+            b: 3,
+            get sum() { return this.a + this.b; },
+        };
+        const store = createStore(definition)();
+        expect(store.sum).toBe(5);
+    });
+    it("setting a non-signal key via proxy returns false silently", () => {
+        const store = makeCounter();
+        // symbol keys are skipped — should not throw
+        expect(() => {
+            store[Symbol("noop")] = 1;
+        }).not.toThrow();
+    });
+    it("$patch ignores unknown keys", () => {
+        const store = makeCounter();
+        expect(() => { store.$patch({ unknownKey: 123 }); }).not.toThrow();
+        expect(store.count).toBe(0);
+    });
+});
+//# sourceMappingURL=create-store.test.js.map

package/dist/__tests__/create-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-store.test.js","sourceRoot":"","sources":["../../src/__tests__/create-store.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/decorators.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decorators.test.d.ts.map

package/dist/__tests__/decorators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/decorators.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/decorators.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from "vitest";
+import { Store, UseStore } from "../decorators";
+describe("Store decorator", () => {
+    it("registers the class without throwing", () => {
+        class CounterStore {
+            value = 0;
+        }
+        expect(() => { Store()(CounterStore, {}); }).not.toThrow();
+    });
+});
+describe("UseStore decorator", () => {
+    it("injects a singleton store instance via getter", () => {
+        class AppStore {
+            name = "app";
+        }
+        Store()(AppStore, {});
+        const initializers = [];
+        const ctx = {
+            name: "store",
+            kind: "field",
+            addInitializer(fn) { initializers.push(fn); },
+        };
+        UseStore(AppStore)(undefined, ctx);
+        const instance = {};
+        initializers.forEach((fn) => { fn.call(instance); });
+        expect(instance.store).toBeInstanceOf(AppStore);
+        expect(instance.store.name).toBe("app");
+    });
+    it("returns the same instance on repeated access (singleton)", () => {
+        class SharedStore {
+        }
+        Store()(SharedStore, {});
+        const initializers = [];
+        const ctx = {
+            name: "sharedStore",
+            kind: "field",
+            addInitializer(fn) { initializers.push(fn); },
+        };
+        UseStore(SharedStore)(undefined, ctx);
+        const a = {};
+        const b = {};
+        initializers.forEach((fn) => { fn.call(a); });
+        initializers.forEach((fn) => { fn.call(b); });
+        expect(a.sharedStore).toBe(b.sharedStore);
+    });
+});
+//# sourceMappingURL=decorators.test.js.map

package/dist/__tests__/decorators.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.test.js","sourceRoot":"","sources":["../../src/__tests__/decorators.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEhD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,YAAY;YAChB,KAAK,GAAG,CAAC,CAAC;SACX;QACD,MAAM,CAAC,GAAG,EAAE,GACR,KAAK,EAAE,CAAC,YAAY,EAAE,EAA2B,CAAC,CAAC,CAAC,CAAC,CACxD,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ;YACZ,IAAI,GAAG,KAAK,CAAC;SACd;QACD,KAAK,EAAE,CAAC,QAAQ,EAAE,EAA2B,CAAC,CAAC;QAE/C,MAAM,YAAY,GAAmC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAgB;YACtB,cAAc,CAAC,EAA2B,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACzC,CAAC;QAEhC,QAAQ,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAE,QAAQ,CAAC,KAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,WAAW;SAAG;QACpB,KAAK,EAAE,CAAC,WAAW,EAAE,EAA2B,CAAC,CAAC;QAElD,MAAM,YAAY,GAAmC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,OAAgB;YACtB,cAAc,CAAC,EAA2B,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACzC,CAAC;QAEhC,QAAQ,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAEtC,MAAM,CAAC,GAA4B,EAAE,CAAC;QACtC,MAAM,CAAC,GAA4B,EAAE,CAAC;QACtC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9C,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/create-store.js

@@ -35,7 +35,7 @@ export function createStore(definition) {
         },
         set(_t, key, value) {
             if (typeof key !== "string")
-                return false;
+                return true;
             if (key in signals) {
                 signals[key].set(value);
                 return true;

package/dist/create-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../src/create-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-store.js","sourceRoot":"","sources":["../src/create-store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/store",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,7 +14,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@praxisjs/core": "0.4.0"
+    "@praxisjs/core": "0.4.1"
   },
   "scripts": {
     "build": "tsc",

package/src/__tests__/create-store.test.ts

@@ -0,0 +1,98 @@
+import { describe, it, expect } from "vitest";
+
+import { createStore } from "../create-store";
+
+function makeCounter() {
+  return createStore({
+    count: 0,
+    step: 1,
+    increment() {
+      (this as unknown as { count: number; step: number }).count +=
+        (this as unknown as { count: number; step: number }).step;
+    },
+    decrement() {
+      (this as unknown as { count: number }).count--;
+    },
+  })();
+}
+
+describe("createStore", () => {
+  it("returns a factory that provides the store proxy", () => {
+    const store = makeCounter();
+    expect(store).toBeDefined();
+  });
+
+  it("reads signal state via property access", () => {
+    const store = makeCounter();
+    expect(store.count).toBe(0);
+  });
+
+  it("sets signal state via property assignment", () => {
+    const store = makeCounter();
+    (store as unknown as { count: number }).count = 5;
+    expect(store.count).toBe(5);
+  });
+
+  it("calls methods bound to the store proxy", () => {
+    const store = makeCounter();
+    (store as unknown as { increment: () => void }).increment();
+    expect(store.count).toBe(1);
+  });
+
+  it("$state returns a plain snapshot of all state", () => {
+    const store = makeCounter();
+    const state = (store as unknown as { $state: () => Record<string, unknown> }).$state();
+    expect(state).toEqual({ count: 0, step: 1 });
+  });
+
+  it("$patch updates multiple keys at once", () => {
+    const store = makeCounter();
+    (store as unknown as { $patch: (p: Record<string, unknown>) => void }).$patch({ count: 10, step: 5 });
+    expect(store.count).toBe(10);
+    expect(store.step).toBe(5);
+  });
+
+  it("$reset restores initial values", () => {
+    const store = makeCounter();
+    (store as unknown as { count: number }).count = 99;
+    (store as unknown as { $reset: () => void }).$reset();
+    expect(store.count).toBe(0);
+  });
+
+  it("$subscribe calls listener with state snapshot on each change", () => {
+    const store = makeCounter();
+    const snapshots: number[] = [];
+    (store as unknown as { $subscribe: (fn: (s: Record<string, unknown>) => void) => () => void }).$subscribe(
+      (s) => snapshots.push(s.count as number),
+    );
+    (store as unknown as { count: number }).count = 42;
+    (store as unknown as { count: number }).count = 99;
+    expect(snapshots).toEqual([0, 42, 99]);
+  });
+
+  it("definition getters are exposed on the store proxy", () => {
+    const definition = {
+      a: 2,
+      b: 3,
+      get sum() { return (this as unknown as { a: number; b: number }).a + (this as unknown as { a: number; b: number }).b; },
+    };
+    const store = createStore(definition)();
+    expect((store as unknown as { sum: number }).sum).toBe(5);
+  });
+
+  it("setting a non-signal key via proxy returns false silently", () => {
+    const store = makeCounter();
+    // symbol keys are skipped — should not throw
+    expect(() => {
+      (store as unknown as Record<symbol, unknown>)[Symbol("noop")] = 1;
+    }).not.toThrow();
+  });
+
+  it("$patch ignores unknown keys", () => {
+    const store = makeCounter();
+    expect(() =>
+      { (store as unknown as { $patch: (p: Record<string, unknown>) => void }).$patch({ unknownKey: 123 }); },
+    ).not.toThrow();
+    expect(store.count).toBe(0);
+  });
+});

package/src/__tests__/decorators.test.ts

@@ -0,0 +1,59 @@
+import { describe, it, expect } from "vitest";
+
+import { Store, UseStore } from "../decorators";
+
+describe("Store decorator", () => {
+  it("registers the class without throwing", () => {
+    class CounterStore {
+      value = 0;
+    }
+    expect(() =>
+      { Store()(CounterStore, {} as ClassDecoratorContext); },
+    ).not.toThrow();
+  });
+});
+
+describe("UseStore decorator", () => {
+  it("injects a singleton store instance via getter", () => {
+    class AppStore {
+      name = "app";
+    }
+    Store()(AppStore, {} as ClassDecoratorContext);
+
+    const initializers: Array<(this: unknown) => void> = [];
+    const ctx = {
+      name: "store",
+      kind: "field" as const,
+      addInitializer(fn: (this: unknown) => void) { initializers.push(fn); },
+    } as ClassFieldDecoratorContext;
+
+    UseStore(AppStore)(undefined, ctx);
+
+    const instance: Record<string, unknown> = {};
+    initializers.forEach((fn) => { fn.call(instance); });
+
+    expect(instance.store).toBeInstanceOf(AppStore);
+    expect((instance.store as AppStore).name).toBe("app");
+  });
+
+  it("returns the same instance on repeated access (singleton)", () => {
+    class SharedStore {}
+    Store()(SharedStore, {} as ClassDecoratorContext);
+
+    const initializers: Array<(this: unknown) => void> = [];
+    const ctx = {
+      name: "sharedStore",
+      kind: "field" as const,
+      addInitializer(fn: (this: unknown) => void) { initializers.push(fn); },
+    } as ClassFieldDecoratorContext;
+
+    UseStore(SharedStore)(undefined, ctx);
+
+    const a: Record<string, unknown> = {};
+    const b: Record<string, unknown> = {};
+    initializers.forEach((fn) => { fn.call(a); });
+    initializers.forEach((fn) => { fn.call(b); });
+
+    expect(a.sharedStore).toBe(b.sharedStore);
+  });
+});

package/src/create-store.ts

@@ -33,7 +33,7 @@ export function createStore<T extends Record<string, unknown>>(
       return undefined;
     },
     set(_t, key: string | symbol, value: unknown) {
-      if (typeof key !== "string") return false;
+      if (typeof key !== "string") return true;
       if (key in signals) {
         signals[key].set(value);
         return true;