@inglorious/store 9.5.3 → 9.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/store",
-  "version": "9.5.3",
+  "version": "9.6.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

@@ -19,10 +19,22 @@ export function createApi(store, extras) {
      */
     setType: store.setType,
     /**
-     * Retrieves the full entities state.
-     * @returns {Object}
+     * Retrieves entities.
+     * If `typeName` is omitted, returns the full entities state object.
+     * If `typeName` is provided, returns an array of entities of that type.
+     * @param {string} [typeName]
+     * @returns {Object|Object[]}
      */
-    getEntities: store.getState,
+    getEntities: (typeName) => {
+      const entities = store.getState()
+      if (typeName == null) {
+        return entities
+      }
+
+      return Object.values(entities).filter(
+        (entity) => entity.type === typeName,
+      )
+    },
     /**
      * Retrieves a single entity by ID.
      * @param {string} id

package/src/test.js

@@ -12,6 +12,7 @@ import { create } from "mutative"
  *
  * @returns {Object} A mock API object with methods:
  *   - `getEntities()`: Returns all entities (frozen)
+ *   - `getEntities(typeName)`: Returns entities matching that type (frozen array)
  *   - `getEntity(id)`: Returns a specific entity by ID (frozen)
  *   - `select(selector)`: Runs a selector against the entities
  *   - `dispatch(event)`: Records an event (for assertions)
@@ -37,8 +38,14 @@ export function createMockApi(entities) {
   const events = []
 
   return {
-    getEntities() {
-      return frozenEntities
+    getEntities(typeName) {
+      if (typeName == null) {
+        return frozenEntities
+      }
+
+      return Object.values(frozenEntities).filter(
+        (entity) => entity.type === typeName,
+      )
     },
     getEntity(id) {
       return frozenEntities[id]

package/types/api.d.ts

@@ -17,7 +17,10 @@ export interface Api<
   getTypes: () => TypesConfig<TEntity>
   getType: (typeName: string) => EntityType<TEntity>
   setType: (typeName: string, type: EntityType<TEntity>) => void
-  getEntities: () => TState
+  getEntities: {
+    (): TState
+    (typeName: string): TEntity[]
+  }
   getEntity: (id: string) => TEntity | undefined
   select: <TResult>(selector: (state: TState) => TResult) => TResult
   dispatch: (event: Event) => void

package/types/test.d.ts

@@ -7,7 +7,10 @@ export interface MockApi<
   TEntity extends BaseEntity = BaseEntity,
   TState extends EntitiesState<TEntity> = EntitiesState<TEntity>,
 > {
-  getEntities: () => TState
+  getEntities: {
+    (): TState
+    (typeName: string): TEntity[]
+  }
   getEntity: (id: string) => TEntity | undefined
   select: <TResult>(selector: (state: TState) => TResult) => TResult
   dispatch: (event: Event) => void