@duplojs/utils 1.4.43 → 1.4.44

package/dist/clean/entity.cjs

@@ -116,6 +116,15 @@ function createEntity(name, getPropertiesDefinition) {
     function is$1(input) {
         return entityKind.has(input) && entityKind.getValue(input) === name;
     }
+    function update(entity, newProperties) {
+        const updatedEntity = {};
+        for (const key in propertiesDefinition) {
+            updatedEntity[key] = newProperties[key] !== undefined
+                ? newProperties[key]
+                : entity[key];
+        }
+        return entityKind.setTo(updatedEntity, name);
+    }
     return entityHandlerKind.setTo({
         name,
         propertiesDefinition,
@@ -124,6 +133,7 @@ function createEntity(name, getPropertiesDefinition) {
         map: map$1,
         mapOrThrow,
         is: is$1,
+        update,
     });
 }
 

package/dist/clean/entity.d.ts

@@ -1,4 +1,4 @@
-import { type SimplifyTopLevel, type Kind, type Unwrap, type IsEqual, type IsExtends, type Or, type NeverCoalescing } from "../common";
+import { type SimplifyTopLevel, type Kind, type Unwrap, type IsEqual, type IsExtends, type Or, type NeverCoalescing, type RemoveKind } from "../common";
 import { type GetNewType, type NewTypeHandler } from "./newType";
 import * as DEither from "../either";
 import * as DDataParser from "../dataParser";
@@ -112,6 +112,18 @@ export interface EntityHandler<GenericName extends string = string, GenericPrope
     * 
     */
     is<GenericInput extends unknown>(input: GenericInput): input is Extract<GenericInput, Entity<GenericName>>;
+    /**
+     * Updates an entity by merging typed properties into an existing entity.
+     * 
+     * ```ts
+     * const updated = User.Entity.update(mapped, {
+     * 	name: User.Name.createOrThrow("Bobby"),
+     * 	nick: null,
+     * });
+     * ```
+     * 
+     */
+    update<const GenericEntity extends Entity<GenericName>, const GenericProperties extends Partial<EntityProperties<GenericPropertiesDefinition>>>(entity: GenericEntity, properties: GenericProperties): Entity<GenericName> & DObject.AssignObjects<RemoveKind<GenericEntity>, GenericProperties>;
 }
 declare const CreateEntityError_base: new (params: {
     "@DuplojsUtilsError/create-entity-error"?: unknown;

package/dist/clean/entity.mjs

@@ -114,6 +114,15 @@ function createEntity(name, getPropertiesDefinition) {
     function is(input) {
         return entityKind.has(input) && entityKind.getValue(input) === name;
     }
+    function update(entity, newProperties) {
+        const updatedEntity = {};
+        for (const key in propertiesDefinition) {
+            updatedEntity[key] = newProperties[key] !== undefined
+                ? newProperties[key]
+                : entity[key];
+        }
+        return entityKind.setTo(updatedEntity, name);
+    }
     return entityHandlerKind.setTo({
         name,
         propertiesDefinition,
@@ -122,6 +131,7 @@ function createEntity(name, getPropertiesDefinition) {
         map: map$1,
         mapOrThrow,
         is,
+        update,
     });
 }
 

package/dist/common/types/maybeArray.d.ts

@@ -1 +1 @@
-export type MaybeArray<GenericValue extends unknown> = GenericValue | GenericValue[];
+export type MaybeArray<GenericValue extends unknown> = GenericValue | readonly GenericValue[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duplojs/utils",
-  "version": "1.4.43",
+  "version": "1.4.44",
   "author": {
     "name": "mathcovax",
     "url": "https://github.com/mathcovax"