@inglorious/store 5.4.1 → 5.5.0

package/README.md

@@ -424,6 +424,52 @@ const cartItemType = [
 ]
 ```
 
+### Behavior Composition with Functions
+
+Behaviors can also be functions that wrap and extend other behaviors. This enables decorator-like patterns and middleware:
+
+```javascript
+// Base behaviors
+const baseHandlers = {
+  formSubmit(entity, value) {
+    entity.value = value
+  },
+}
+
+// Function that adds validation
+const validated = (behavior) => ({
+  formSubmit(entity, value, api) {
+    if (!value.trim()) return // Validate first
+    behavior.formSubmit?.(entity, value, api)
+  },
+})
+
+// Function that adds loading state to async handlers
+const withLoading = (behavior) => ({
+  async fetchData(entity, payload, api) {
+    entity.loading = true
+    try {
+      await behavior.fetchData?.(entity, payload, api)
+    } finally {
+      entity.loading = false
+    }
+  },
+})
+
+// Compose behaviors
+const types = {
+  form: [baseHandlers, validated(baseHandlers), withLoading(baseHandlers)],
+}
+```
+
+**Why function composition for behaviors:**
+
+- ✅ Add cross-cutting concerns (validation, logging, error handling)
+- ✅ Reuse behavior logic across entities
+- ✅ Create middleware-like wrappers
+- ✅ Cleaner than deep inheritance hierarchies
+- ✅ Works for both apps and games
+
 ### Events
 
 Events are broadcast to all relevant handlers in a pub/sub pattern.
@@ -580,7 +626,6 @@ Creates a convenience wrapper with utility methods.
 
 **Returns:**
 
-- `createSelector(inputSelectors, resultFunc)`: Memoized selectors
 - `getTypes()`, `getEntities()`, `getEntity(id)`: State accessors
 - `notify(type, payload)`: Dispatch events
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/store",
-  "version": "5.4.1",
+  "version": "5.5.0",
   "description": "A state manager for real-time, collaborative apps, inspired by game development patterns and compatible with Redux.",
   "author": "IceOnFire <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
   "license": "MIT",

package/src/api.js

@@ -1,11 +1,4 @@
-import { createSelector as _createSelector } from "./select.js"
-
 export function createApi(store, extras) {
-  const createSelector = (inputSelectors, resultFunc) => {
-    const selector = _createSelector(inputSelectors, resultFunc)
-    return () => selector(store.getState())
-  }
-
   const getTypes = () => store.getTypes()
 
   const getEntities = () => store.getState()
@@ -13,7 +6,6 @@ export function createApi(store, extras) {
   const getEntity = (id) => getEntities()[id]
 
   return {
-    createSelector,
     getTypes,
     getEntities,
     getEntity,

package/src/types.js

@@ -12,8 +12,9 @@ import { pipe } from "@inglorious/utils/functions/functions.js"
  * @returns {Type} The fully composed and augmented type object.
  */
 export function augmentType(type) {
-  const behaviors = ensureArray(type).map((fn) =>
-    typeof fn !== "function" ? (type) => extend(type, fn) : fn,
+  const behaviors = ensureArray(type).map(
+    (behavior) => (type) =>
+      extend(type, typeof behavior === "function" ? behavior(type) : behavior),
   )
 
   return pipe(...behaviors)({})