@xylabs/object 4.11.2 → 4.11.4

package/dist/neutral/index.mjs

@@ -77,6 +77,38 @@ var isObject = (value) => {
 // src/asObject.ts
 var asAnyObject = (() => AsObjectFactory.create((obj) => isObject(obj)))();
 
+// src/deepMerge.ts
+var isUnsafeKey = (key) => key === "__proto__" || key === "constructor" || key === "prototype";
+function merge(target, source, options) {
+  if (!source || typeof source !== "object") return target;
+  for (const key of Reflect.ownKeys(source)) {
+    const value = source[key];
+    if (isUnsafeKey(key)) {
+      continue;
+    } else if (Array.isArray(value)) {
+      target[key] = options?.arrayStrategy === "concat" && Array.isArray(target[key]) ? [...target[key], ...value] : value;
+    } else if (value !== null && typeof value === "object") {
+      if (!target[key] || typeof target[key] !== "object") {
+        target[key] = {};
+      }
+      merge(target[key], value, options);
+    } else {
+      target[key] = value;
+    }
+  }
+  return target;
+}
+function createDeepMerge(options) {
+  return function deepMerge2(...objects) {
+    const result = options.mutate ? objects[0] ?? {} : {};
+    for (const obj of objects) {
+      merge(result, obj, options);
+    }
+    return result;
+  };
+}
+var deepMerge = createDeepMerge({ arrayStrategy: "overwrite", mutate: false });
+
 // src/IsObjectFactory.ts
 import {
   isObject as isObject2,
@@ -267,6 +299,8 @@ export {
   ObjectWrapper,
   ValidatorBase,
   asAnyObject,
+  createDeepMerge,
+  deepMerge,
   isJsonArray,
   isJsonObject,
   isJsonValue,

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/AsTypeFactory.ts","../../src/AsObjectFactory.ts","../../src/isType.ts","../../src/isObject.ts","../../src/asObject.ts","../../src/IsObjectFactory.ts","../../src/JsonObject.ts","../../src/ObjectWrapper.ts","../../src/omitBy.ts","../../src/pickBy.ts","../../src/removeFields.ts","../../src/toJson.ts","../../src/Validator.ts"],"sourcesContent":["import type { AssertExMessageFunc } from '@xylabs/assert'\nimport { assertEx } from '@xylabs/assert'\nimport type { Logger } from '@xylabs/logger'\nimport type { AnyNonPromise } from '@xylabs/promise'\nimport { isPromise } from '@xylabs/promise'\nimport type { TypedValue } from '@xylabs/typeof'\n\nexport interface TypeCheckConfig {\n  log?: boolean | Logger\n}\n\nexport type StringOrAlertFunction<T extends AnyNonPromise> = string | AssertExMessageFunc<T>\n\nexport type TypeCheck<T extends TypedValue> = (obj: AnyNonPromise, config?: TypeCheckConfig) => obj is T\n\nexport const AsTypeFactory = {\n  create: <T extends AnyNonPromise>(typeCheck: TypeCheck<T>) => {\n    function func<TType extends T>(value: AnyNonPromise, config?: TypeCheckConfig): TType | undefined\n    function func<TType extends T>(value: AnyNonPromise, assert: StringOrAlertFunction<T>, config?: TypeCheckConfig): TType\n    function func<TType extends T>(\n      value: AnyNonPromise,\n      assertOrConfig?: StringOrAlertFunction<T> | TypeCheckConfig,\n      config?: TypeCheckConfig,\n    ): TType | undefined {\n      if (value === undefined || value === null) return undefined\n      if (isPromise(value)) {\n        throw new TypeError('un-awaited promises may not be sent to \"as\" functions')\n      }\n\n      const resolvedAssert = (typeof assertOrConfig === 'object' ? undefined : assertOrConfig) as StringOrAlertFunction<T> | undefined\n      const resolvedConfig = typeof assertOrConfig === 'object' ? assertOrConfig : config\n      const result = typeCheck(value, resolvedConfig) ? (value as TType) : undefined\n\n      if (resolvedAssert !== undefined) {\n        if (typeof resolvedAssert === 'function') {\n          assertEx<T>(result, resolvedAssert)\n        } else {\n          assertEx<T>(result, () => resolvedAssert)\n        }\n      }\n      return result\n    }\n    return func\n  },\n  createOptional: <T extends AnyNonPromise>(typeCheck: TypeCheck<T>) => {\n    function func<TType extends T>(value: AnyNonPromise): TType | undefined {\n      if (value === undefined || value === null) return undefined\n      if (isPromise(value)) {\n        throw new TypeError('un-awaited promises may not be sent to \"as\" functions')\n      }\n      return typeCheck(value) ? (value as TType) : undefined\n    }\n    return func\n  },\n}\n","import type { TypedObject } from '@xylabs/typeof'\n\nimport type { TypeCheck } from './AsTypeFactory.ts'\nimport { AsTypeFactory } from './AsTypeFactory.ts'\n\nexport const AsObjectFactory = {\n  create: <T extends TypedObject>(typeCheck: TypeCheck<T>) => {\n    return AsTypeFactory.create<T>(typeCheck)\n  },\n  createOptional: <T extends TypedObject>(typeCheck: TypeCheck<T>) => {\n    return AsTypeFactory.createOptional<T>(typeCheck)\n  },\n}\n","import type { FieldType } from '@xylabs/typeof'\n\nexport const isType = (value: unknown, expectedType: FieldType) => {\n  const typeofValue = typeof value\n  switch (expectedType) {\n    case 'array': {\n      return Array.isArray(value)\n    }\n    case 'null': {\n      return value === null\n    }\n    case 'undefined': {\n      return value === undefined\n    }\n    case 'object': {\n      // nulls resolve to objects, so exclude them\n      if (value === null) {\n        return false\n      }\n      // arrays resolve to objects, so exclude them\n      return typeofValue === 'object' && !Array.isArray(value)\n    }\n    default: {\n      return typeofValue === expectedType\n    }\n  }\n}\n","import type { AnyObject } from './AnyObject.ts'\nimport { isType } from './isType.ts'\n\nexport const isObject = (value: unknown): value is AnyObject => {\n  return isType(value, 'object')\n}\n","import type { AnyObject } from './AnyObject.ts'\nimport { AsObjectFactory } from './AsObjectFactory.ts'\nimport { isObject } from './isObject.ts'\n\nexport const asAnyObject = (() => AsObjectFactory.create<AnyObject>(<T extends AnyObject>(obj: unknown): obj is T => isObject(obj)))()\n","import {\n  isObject, isTruthy,\n  type ObjectTypeShape, type TypedObject,\n} from '@xylabs/typeof'\n\nimport type { TypeCheck, TypeCheckConfig } from './AsTypeFactory.ts'\nimport { isType } from './isType.ts'\n\nexport interface ObjectTypeConfig extends TypeCheckConfig {}\n\nexport class IsObjectFactory<T extends TypedObject> {\n  create(shape?: ObjectTypeShape, additionalChecks?: TypeCheck<TypedObject>[]): TypeCheck<T> {\n    return (obj, { log } = {}): obj is T => {\n      if (!isObject(obj)) {\n        return false\n      }\n      return (\n        // do primary check\n        Object.entries(shape ?? {}).filter(([key, type]) => {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const result = isType((obj as any)[key], type)\n          if (!result && isTruthy(log)) {\n            const logger = typeof log === 'object' ? log : console\n            logger.warn(`isType Failed: ${key}: ${type}`)\n          }\n          return !result\n        }).length === 0\n        // perform additional checks\n        && (additionalChecks?.reduce((prev, check) => prev && check(obj, { log }), true) ?? true)\n      )\n    }\n  }\n}\n","import { isObject } from '@xylabs/typeof'\n\nexport type JsonValue = string | number | boolean | null | JsonObject | JsonArray\nexport type JsonObject = { [key: string]: JsonValue }\nexport type JsonArray = JsonValue[]\n\nexport const isJsonValue = (value: unknown): value is JsonValue => {\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean': {\n      return true\n    }\n    default: {\n      return value === null || isJsonObject(value) || isJsonArray(value)\n    }\n  }\n}\n\nexport const isJsonArray = (value: unknown): value is JsonArray => {\n  return Array.isArray(value) && !value.some(item => !isJsonValue(item))\n}\n\nexport const isValidJsonFieldPair = ([key, value]: [key: unknown, value: unknown]) => {\n  return typeof key === 'string' && isJsonValue(value)\n}\n\nexport const isJsonObject = (value: unknown): value is JsonObject => {\n  return (\n    isObject(value)\n    // check if all keys are strings\n    && !Object.entries(value).some(item => !isValidJsonFieldPair(item))\n  )\n}\n","import type { EmptyObject } from './EmptyObject.ts'\nimport type { StringKeyObject } from './StringKeyObject.ts'\n\nexport abstract class ObjectWrapper<T extends EmptyObject = EmptyObject> {\n  readonly obj: T\n  constructor(obj: T) {\n    this.obj = obj\n  }\n\n  protected get stringKeyObj() {\n    return this.obj as StringKeyObject\n  }\n}\n","import { assertEx } from '@xylabs/assert'\n\nimport type { EmptyObject } from './EmptyObject.ts'\nimport type { JsonObject } from './JsonObject.ts'\nimport type { DeepOmitStartsWith } from './OmitStartsWith.ts'\n\nexport type OmitByPredicate<T extends EmptyObject = Record<string, unknown>> = (value: T[keyof T], key: keyof T) => boolean\n\nconst omitByArray = <T>(\n  obj: T[],\n  predicate: OmitByPredicate,\n  maxDepth: number,\n): T[] => {\n  return obj.map((value) => {\n    return (value !== null && typeof value === 'object') ? omitBy(value, predicate, maxDepth) : value\n  }) as T[]\n}\n\nconst omitByObject = <T extends EmptyObject>(\n  obj: T,\n  predicate: OmitByPredicate,\n  maxDepth: number,\n): Partial<T> => {\n  const result: JsonObject = {}\n\n  for (const key in obj) {\n    if (Object.hasOwn(obj, key)) {\n      const value = obj[key]\n      if (!predicate(value, key)) {\n        result[key] = ((value !== null && typeof value === 'object') ? omitBy(value, predicate, maxDepth - 1) : value) as JsonObject\n      }\n    }\n  }\n\n  return result as T\n}\n\nexport const omitBy = <T extends EmptyObject>(\n  obj: T,\n  predicate: OmitByPredicate,\n  maxDepth = 1,\n): Partial<T> => {\n  if (maxDepth <= 0) {\n    return obj\n  }\n\n  return Array.isArray(obj) ? omitByArray(obj, predicate, maxDepth - 1) as T : omitByObject(obj, predicate, maxDepth - 1) as T\n}\n\nconst omitByPrefixPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport const omitByPrefix = <T extends EmptyObject, P extends string>(payload: T, prefix: P, maxDepth = 100): DeepOmitStartsWith<T, P> => {\n  return omitBy(payload, omitByPrefixPredicate(prefix), maxDepth) as unknown as DeepOmitStartsWith<T, P>\n}\n","import { assertEx } from '@xylabs/assert'\n\nimport type { EmptyObject } from './EmptyObject.ts'\nimport type { JsonObject } from './JsonObject.ts'\nimport type { DeepPickStartsWith } from './PickStartsWith.ts'\n\nexport type PickByPredicate<T extends EmptyObject = Record<string, unknown>> = (value: T[keyof T], key: keyof T) => boolean\n\nconst pickByArray = <T>(\n  obj: T[],\n  predicate: PickByPredicate,\n  maxDepth: number,\n): T[] => {\n  return obj.map((value) => {\n    return (value !== null && typeof value === 'object') ? pickBy(value, predicate, maxDepth) : value\n  }) as T[]\n}\n\nconst pickByObject = <T extends EmptyObject>(\n  obj: T,\n  predicate: PickByPredicate,\n  maxDepth: number,\n): Partial<T> => {\n  const result: JsonObject = {}\n\n  for (const key in obj) {\n    if (Object.hasOwn(obj, key)) {\n      const value = obj[key]\n      if (predicate(value, key)) {\n        result[key] = ((value !== null && typeof value === 'object') ? pickBy(value, predicate, maxDepth - 1) : value) as JsonObject\n      }\n    }\n  }\n\n  return result as T\n}\n\nexport const pickBy = <T extends EmptyObject>(\n  obj: T,\n  predicate: PickByPredicate,\n  maxDepth = 1,\n): Partial<T> => {\n  if (maxDepth <= 0) {\n    return obj\n  }\n\n  return Array.isArray(obj) ? pickByArray(obj, predicate, maxDepth - 1) as T : pickByObject(obj, predicate, maxDepth - 1) as T\n}\n\nconst pickByPrefixPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport const pickByPrefix = <T extends EmptyObject, P extends string>(payload: T, prefix: P, maxDepth = 100): DeepPickStartsWith<T, P> => {\n  return pickBy(payload, pickByPrefixPredicate(prefix), maxDepth) as unknown as DeepPickStartsWith<T, P>\n}\n","import type { EmptyObject } from './EmptyObject.ts'\n\nexport const removeFields = <T extends EmptyObject, K extends keyof T>(obj: T, fields: K[]): Omit<T, K> => {\n  const clone = { ...obj }\n  for (const field of fields) {\n    delete clone[field]\n  }\n  return clone\n}\n","import type {\n  JsonArray, JsonObject, JsonValue,\n} from './JsonObject.ts'\n\nexport const toJsonArray = (value: unknown[], cycleList?: unknown[], maxDepth = 3): JsonArray => {\n  return value.map(item => toJsonValue(item, cycleList, maxDepth))\n}\n\nexport const toJsonObject = (value: object, cycleList?: unknown[], maxDepth = 3): JsonObject => {\n  const result: JsonObject = {}\n  for (const [key, entry] of Object.entries(value)) {\n    result[key] = value === undefined ? '[Undefined]' : toJsonValue(entry, cycleList, maxDepth)\n  }\n  return result\n}\n\nexport const toJsonValue = (value: unknown, cycleList?: unknown[], maxDepth = 3): JsonValue => {\n  if (maxDepth <= 0 && typeof value === 'object') {\n    return '[MaxDepth]'\n  }\n  if (cycleList?.includes(value)) {\n    return '[Circular]'\n  }\n  switch (typeof value) {\n    case 'string':\n    case 'boolean':\n    case 'number': {\n      return value\n    }\n    case 'object': {\n      if (value === null) {\n        return null\n      }\n      const newCycleList = cycleList ?? []\n      newCycleList.push(value)\n      return Array.isArray(value) ? toJsonArray(value, newCycleList, maxDepth - 1) : toJsonObject(value, newCycleList, maxDepth - 1)\n    }\n    default: {\n      return `[${typeof value}]`\n    }\n  }\n}\n\nexport const toJsonString = (value: unknown, maxDepth = 3) => {\n  return JSON.stringify(toJson(value, maxDepth), null, 2)\n}\n\nexport const toJson = (value: unknown, maxDepth = 3): JsonValue => {\n  return toJsonValue(value, undefined, maxDepth)\n}\n","import type { Promisable } from '@xylabs/promise'\n\nimport type { AnyObject } from './AnyObject.ts'\nimport type { EmptyObject } from './EmptyObject.ts'\nimport { ObjectWrapper } from './ObjectWrapper.ts'\n\nexport interface Validator<T extends EmptyObject = AnyObject> {\n  validate(payload: T): Promisable<Error[]>\n}\n\nexport abstract class ValidatorBase<T extends EmptyObject = AnyObject> extends ObjectWrapper<Partial<T>> implements Validator<T> {\n  abstract validate(payload: T): Promisable<Error[]>\n}\n"],"mappings":"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","names":["isObject","isObject","isObject","assertEx","assertEx"]}
+{"version":3,"sources":["../../src/AsTypeFactory.ts","../../src/AsObjectFactory.ts","../../src/isType.ts","../../src/isObject.ts","../../src/asObject.ts","../../src/deepMerge.ts","../../src/IsObjectFactory.ts","../../src/JsonObject.ts","../../src/ObjectWrapper.ts","../../src/omitBy.ts","../../src/pickBy.ts","../../src/removeFields.ts","../../src/toJson.ts","../../src/Validator.ts"],"sourcesContent":["import type { AssertExMessageFunc } from '@xylabs/assert'\nimport { assertEx } from '@xylabs/assert'\nimport type { Logger } from '@xylabs/logger'\nimport type { AnyNonPromise } from '@xylabs/promise'\nimport { isPromise } from '@xylabs/promise'\nimport type { TypedValue } from '@xylabs/typeof'\n\nexport interface TypeCheckConfig {\n  log?: boolean | Logger\n}\n\nexport type StringOrAlertFunction<T extends AnyNonPromise> = string | AssertExMessageFunc<T>\n\nexport type TypeCheck<T extends TypedValue> = (obj: AnyNonPromise, config?: TypeCheckConfig) => obj is T\n\nexport const AsTypeFactory = {\n  create: <T extends AnyNonPromise>(typeCheck: TypeCheck<T>) => {\n    function func<TType extends T>(value: AnyNonPromise, config?: TypeCheckConfig): TType | undefined\n    function func<TType extends T>(value: AnyNonPromise, assert: StringOrAlertFunction<T>, config?: TypeCheckConfig): TType\n    function func<TType extends T>(\n      value: AnyNonPromise,\n      assertOrConfig?: StringOrAlertFunction<T> | TypeCheckConfig,\n      config?: TypeCheckConfig,\n    ): TType | undefined {\n      if (value === undefined || value === null) return undefined\n      if (isPromise(value)) {\n        throw new TypeError('un-awaited promises may not be sent to \"as\" functions')\n      }\n\n      const resolvedAssert = (typeof assertOrConfig === 'object' ? undefined : assertOrConfig) as StringOrAlertFunction<T> | undefined\n      const resolvedConfig = typeof assertOrConfig === 'object' ? assertOrConfig : config\n      const result = typeCheck(value, resolvedConfig) ? (value as TType) : undefined\n\n      if (resolvedAssert !== undefined) {\n        if (typeof resolvedAssert === 'function') {\n          assertEx<T>(result, resolvedAssert)\n        } else {\n          assertEx<T>(result, () => resolvedAssert)\n        }\n      }\n      return result\n    }\n    return func\n  },\n  createOptional: <T extends AnyNonPromise>(typeCheck: TypeCheck<T>) => {\n    function func<TType extends T>(value: AnyNonPromise): TType | undefined {\n      if (value === undefined || value === null) return undefined\n      if (isPromise(value)) {\n        throw new TypeError('un-awaited promises may not be sent to \"as\" functions')\n      }\n      return typeCheck(value) ? (value as TType) : undefined\n    }\n    return func\n  },\n}\n","import type { TypedObject } from '@xylabs/typeof'\n\nimport type { TypeCheck } from './AsTypeFactory.ts'\nimport { AsTypeFactory } from './AsTypeFactory.ts'\n\nexport const AsObjectFactory = {\n  create: <T extends TypedObject>(typeCheck: TypeCheck<T>) => {\n    return AsTypeFactory.create<T>(typeCheck)\n  },\n  createOptional: <T extends TypedObject>(typeCheck: TypeCheck<T>) => {\n    return AsTypeFactory.createOptional<T>(typeCheck)\n  },\n}\n","import type { FieldType } from '@xylabs/typeof'\n\nexport const isType = (value: unknown, expectedType: FieldType) => {\n  const typeofValue = typeof value\n  switch (expectedType) {\n    case 'array': {\n      return Array.isArray(value)\n    }\n    case 'null': {\n      return value === null\n    }\n    case 'undefined': {\n      return value === undefined\n    }\n    case 'object': {\n      // nulls resolve to objects, so exclude them\n      if (value === null) {\n        return false\n      }\n      // arrays resolve to objects, so exclude them\n      return typeofValue === 'object' && !Array.isArray(value)\n    }\n    default: {\n      return typeofValue === expectedType\n    }\n  }\n}\n","import type { AnyObject } from './AnyObject.ts'\nimport { isType } from './isType.ts'\n\nexport const isObject = (value: unknown): value is AnyObject => {\n  return isType(value, 'object')\n}\n","import type { AnyObject } from './AnyObject.ts'\nimport { AsObjectFactory } from './AsObjectFactory.ts'\nimport { isObject } from './isObject.ts'\n\nexport const asAnyObject = (() => AsObjectFactory.create<AnyObject>(<T extends AnyObject>(obj: unknown): obj is T => isObject(obj)))()\n","import type { AnyObject } from './AnyObject.ts'\n\n/**\n * Deeply merges two types into a new type.\n */\ntype DeepMerge<A, B> = {\n  [K in keyof A | keyof B]:\n  K extends keyof B\n    ? K extends keyof A\n      ? A[K] extends object\n        ? B[K] extends object\n          ? DeepMerge<A[K], B[K]>\n          : B[K]\n        : B[K]\n      : B[K]\n    : K extends keyof A\n      ? A[K]\n      : never;\n}\n\n/**\n * Merges multiple types into a new type.\n */\ntype MergeAll<T extends object[], R = {}> =\n  T extends [infer First extends object, ...infer Rest extends object[]]\n    ? MergeAll<Rest, DeepMerge<R, First>>\n    : R\n\n/**\n * Options for merging objects in the deep merge function.\n */\ntype MergeOptions = {\n  /**\n   * Strategy for merging arrays.\n   * - 'overwrite': Overwrites the array with the last object's value.\n   * - 'concat': Concatenates arrays from all objects.\n   * @default 'overwrite'\n   */\n  arrayStrategy?: 'overwrite' | 'concat'\n  /**\n   * Mutate the first object in the list instead of creating a new one.\n   * @default false\n   */\n  mutate?: boolean\n}\n\nconst isUnsafeKey = (key: string | symbol): boolean =>\n  key === '__proto__' || key === 'constructor' || key === 'prototype'\n\nfunction merge<T extends AnyObject>(target: AnyObject, source?: AnyObject, options?: MergeOptions): T {\n  if (!source || typeof source !== 'object') return target as T\n\n  for (const key of Reflect.ownKeys(source)) {\n    const value = source[key]\n    if (isUnsafeKey(key)) {\n      continue\n    } else if (Array.isArray(value)) {\n      target[key]\n      // If the value is an array, handle it based on the configured array strategy\n        = options?.arrayStrategy === 'concat' && Array.isArray(target[key])\n          ? [...target[key], ...value]\n          : value\n    } else if (value !== null && typeof value === 'object') {\n      // Recursively merge nested objects\n      if (!target[key] || typeof target[key] !== 'object') {\n        target[key] = {}\n      }\n      merge(target[key] as AnyObject, value as AnyObject, options)\n    } else {\n      // Overwrite with non-object values\n      target[key] = value\n    }\n  }\n\n  return target as T\n}\n\n/**\n * Creates a deep merge function with the specified options.\n * @param options Options for merging.\n * @returns A deep merge function configured for the specified options.\n */\nexport function createDeepMerge(options: MergeOptions) {\n  return function deepMerge<T extends AnyObject[]>(...objects: T): MergeAll<T> {\n    const result = (options.mutate ? objects[0] ?? {} : {}) as MergeAll<T>\n    for (const obj of objects) {\n      merge(result, obj, options)\n    }\n    return result\n  }\n}\n\n/**\n * Deeply merges multiple objects into a new object.\n * @param objects Multiple objects to merge deeply.\n * The function merges properties from all objects into a new object.\n * If a property exists in multiple objects, the last object's value will be used.\n * If a property is an object, it will be merged recursively.\n * If a property is an array, it will be overwritten by the last object's value.\n * If a property is a primitive value, it will be overwritten by the last object's value.\n * If a property is undefined or null in the source, it will be skipped.\n * If a property is a symbol, it will be merged as well.\n * @returns A new object with the merged properties.\n */\nexport const deepMerge = createDeepMerge({ arrayStrategy: 'overwrite', mutate: false })\n","import {\n  isObject, isTruthy,\n  type ObjectTypeShape, type TypedObject,\n} from '@xylabs/typeof'\n\nimport type { TypeCheck, TypeCheckConfig } from './AsTypeFactory.ts'\nimport { isType } from './isType.ts'\n\nexport interface ObjectTypeConfig extends TypeCheckConfig {}\n\nexport class IsObjectFactory<T extends TypedObject> {\n  create(shape?: ObjectTypeShape, additionalChecks?: TypeCheck<TypedObject>[]): TypeCheck<T> {\n    return (obj, { log } = {}): obj is T => {\n      if (!isObject(obj)) {\n        return false\n      }\n      return (\n        // do primary check\n        Object.entries(shape ?? {}).filter(([key, type]) => {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const result = isType((obj as any)[key], type)\n          if (!result && isTruthy(log)) {\n            const logger = typeof log === 'object' ? log : console\n            logger.warn(`isType Failed: ${key}: ${type}`)\n          }\n          return !result\n        }).length === 0\n        // perform additional checks\n        && (additionalChecks?.reduce((prev, check) => prev && check(obj, { log }), true) ?? true)\n      )\n    }\n  }\n}\n","import { isObject } from '@xylabs/typeof'\n\nexport type JsonValue = string | number | boolean | null | JsonObject | JsonArray\nexport type JsonObject = { [key: string]: JsonValue }\nexport type JsonArray = JsonValue[]\n\nexport const isJsonValue = (value: unknown): value is JsonValue => {\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean': {\n      return true\n    }\n    default: {\n      return value === null || isJsonObject(value) || isJsonArray(value)\n    }\n  }\n}\n\nexport const isJsonArray = (value: unknown): value is JsonArray => {\n  return Array.isArray(value) && !value.some(item => !isJsonValue(item))\n}\n\nexport const isValidJsonFieldPair = ([key, value]: [key: unknown, value: unknown]) => {\n  return typeof key === 'string' && isJsonValue(value)\n}\n\nexport const isJsonObject = (value: unknown): value is JsonObject => {\n  return (\n    isObject(value)\n    // check if all keys are strings\n    && !Object.entries(value).some(item => !isValidJsonFieldPair(item))\n  )\n}\n","import type { EmptyObject } from './EmptyObject.ts'\nimport type { StringKeyObject } from './StringKeyObject.ts'\n\nexport abstract class ObjectWrapper<T extends EmptyObject = EmptyObject> {\n  readonly obj: T\n  constructor(obj: T) {\n    this.obj = obj\n  }\n\n  protected get stringKeyObj() {\n    return this.obj as StringKeyObject\n  }\n}\n","import { assertEx } from '@xylabs/assert'\n\nimport type { EmptyObject } from './EmptyObject.ts'\nimport type { JsonObject } from './JsonObject.ts'\nimport type { DeepOmitStartsWith } from './OmitStartsWith.ts'\n\nexport type OmitByPredicate<T extends EmptyObject = Record<string, unknown>> = (value: T[keyof T], key: keyof T) => boolean\n\nconst omitByArray = <T>(\n  obj: T[],\n  predicate: OmitByPredicate,\n  maxDepth: number,\n): T[] => {\n  return obj.map((value) => {\n    return (value !== null && typeof value === 'object') ? omitBy(value, predicate, maxDepth) : value\n  }) as T[]\n}\n\nconst omitByObject = <T extends EmptyObject>(\n  obj: T,\n  predicate: OmitByPredicate,\n  maxDepth: number,\n): Partial<T> => {\n  const result: JsonObject = {}\n\n  for (const key in obj) {\n    if (Object.hasOwn(obj, key)) {\n      const value = obj[key]\n      if (!predicate(value, key)) {\n        result[key] = ((value !== null && typeof value === 'object') ? omitBy(value, predicate, maxDepth - 1) : value) as JsonObject\n      }\n    }\n  }\n\n  return result as T\n}\n\nexport const omitBy = <T extends EmptyObject>(\n  obj: T,\n  predicate: OmitByPredicate,\n  maxDepth = 1,\n): Partial<T> => {\n  if (maxDepth <= 0) {\n    return obj\n  }\n\n  return Array.isArray(obj) ? omitByArray(obj, predicate, maxDepth - 1) as T : omitByObject(obj, predicate, maxDepth - 1) as T\n}\n\nconst omitByPrefixPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport const omitByPrefix = <T extends EmptyObject, P extends string>(payload: T, prefix: P, maxDepth = 100): DeepOmitStartsWith<T, P> => {\n  return omitBy(payload, omitByPrefixPredicate(prefix), maxDepth) as unknown as DeepOmitStartsWith<T, P>\n}\n","import { assertEx } from '@xylabs/assert'\n\nimport type { EmptyObject } from './EmptyObject.ts'\nimport type { JsonObject } from './JsonObject.ts'\nimport type { DeepPickStartsWith } from './PickStartsWith.ts'\n\nexport type PickByPredicate<T extends EmptyObject = Record<string, unknown>> = (value: T[keyof T], key: keyof T) => boolean\n\nconst pickByArray = <T>(\n  obj: T[],\n  predicate: PickByPredicate,\n  maxDepth: number,\n): T[] => {\n  return obj.map((value) => {\n    return (value !== null && typeof value === 'object') ? pickBy(value, predicate, maxDepth) : value\n  }) as T[]\n}\n\nconst pickByObject = <T extends EmptyObject>(\n  obj: T,\n  predicate: PickByPredicate,\n  maxDepth: number,\n): Partial<T> => {\n  const result: JsonObject = {}\n\n  for (const key in obj) {\n    if (Object.hasOwn(obj, key)) {\n      const value = obj[key]\n      if (predicate(value, key)) {\n        result[key] = ((value !== null && typeof value === 'object') ? pickBy(value, predicate, maxDepth - 1) : value) as JsonObject\n      }\n    }\n  }\n\n  return result as T\n}\n\nexport const pickBy = <T extends EmptyObject>(\n  obj: T,\n  predicate: PickByPredicate,\n  maxDepth = 1,\n): Partial<T> => {\n  if (maxDepth <= 0) {\n    return obj\n  }\n\n  return Array.isArray(obj) ? pickByArray(obj, predicate, maxDepth - 1) as T : pickByObject(obj, predicate, maxDepth - 1) as T\n}\n\nconst pickByPrefixPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport const pickByPrefix = <T extends EmptyObject, P extends string>(payload: T, prefix: P, maxDepth = 100): DeepPickStartsWith<T, P> => {\n  return pickBy(payload, pickByPrefixPredicate(prefix), maxDepth) as unknown as DeepPickStartsWith<T, P>\n}\n","import type { EmptyObject } from './EmptyObject.ts'\n\nexport const removeFields = <T extends EmptyObject, K extends keyof T>(obj: T, fields: K[]): Omit<T, K> => {\n  const clone = { ...obj }\n  for (const field of fields) {\n    delete clone[field]\n  }\n  return clone\n}\n","import type {\n  JsonArray, JsonObject, JsonValue,\n} from './JsonObject.ts'\n\nexport const toJsonArray = (value: unknown[], cycleList?: unknown[], maxDepth = 3): JsonArray => {\n  return value.map(item => toJsonValue(item, cycleList, maxDepth))\n}\n\nexport const toJsonObject = (value: object, cycleList?: unknown[], maxDepth = 3): JsonObject => {\n  const result: JsonObject = {}\n  for (const [key, entry] of Object.entries(value)) {\n    result[key] = value === undefined ? '[Undefined]' : toJsonValue(entry, cycleList, maxDepth)\n  }\n  return result\n}\n\nexport const toJsonValue = (value: unknown, cycleList?: unknown[], maxDepth = 3): JsonValue => {\n  if (maxDepth <= 0 && typeof value === 'object') {\n    return '[MaxDepth]'\n  }\n  if (cycleList?.includes(value)) {\n    return '[Circular]'\n  }\n  switch (typeof value) {\n    case 'string':\n    case 'boolean':\n    case 'number': {\n      return value\n    }\n    case 'object': {\n      if (value === null) {\n        return null\n      }\n      const newCycleList = cycleList ?? []\n      newCycleList.push(value)\n      return Array.isArray(value) ? toJsonArray(value, newCycleList, maxDepth - 1) : toJsonObject(value, newCycleList, maxDepth - 1)\n    }\n    default: {\n      return `[${typeof value}]`\n    }\n  }\n}\n\nexport const toJsonString = (value: unknown, maxDepth = 3) => {\n  return JSON.stringify(toJson(value, maxDepth), null, 2)\n}\n\nexport const toJson = (value: unknown, maxDepth = 3): JsonValue => {\n  return toJsonValue(value, undefined, maxDepth)\n}\n","import type { Promisable } from '@xylabs/promise'\n\nimport type { AnyObject } from './AnyObject.ts'\nimport type { EmptyObject } from './EmptyObject.ts'\nimport { ObjectWrapper } from './ObjectWrapper.ts'\n\nexport interface Validator<T extends EmptyObject = AnyObject> {\n  validate(payload: T): Promisable<Error[]>\n}\n\nexport abstract class ValidatorBase<T extends EmptyObject = AnyObject> extends ObjectWrapper<Partial<T>> implements Validator<T> {\n  abstract validate(payload: T): Promisable<Error[]>\n}\n"],"mappings":";AACA,SAAS,gBAAgB;AAGzB,SAAS,iBAAiB;AAWnB,IAAM,gBAAgB;AAAA,EAC3B,QAAQ,CAA0B,cAA4B;AAG5D,aAAS,KACP,OACA,gBACA,QACmB;AACnB,UAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,UAAI,UAAU,KAAK,GAAG;AACpB,cAAM,IAAI,UAAU,uDAAuD;AAAA,MAC7E;AAEA,YAAM,iBAAkB,OAAO,mBAAmB,WAAW,SAAY;AACzE,YAAM,iBAAiB,OAAO,mBAAmB,WAAW,iBAAiB;AAC7E,YAAM,SAAS,UAAU,OAAO,cAAc,IAAK,QAAkB;AAErE,UAAI,mBAAmB,QAAW;AAChC,YAAI,OAAO,mBAAmB,YAAY;AACxC,mBAAY,QAAQ,cAAc;AAAA,QACpC,OAAO;AACL,mBAAY,QAAQ,MAAM,cAAc;AAAA,QAC1C;AAAA,MACF;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA,EACA,gBAAgB,CAA0B,cAA4B;AACpE,aAAS,KAAsB,OAAyC;AACtE,UAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,UAAI,UAAU,KAAK,GAAG;AACpB,cAAM,IAAI,UAAU,uDAAuD;AAAA,MAC7E;AACA,aAAO,UAAU,KAAK,IAAK,QAAkB;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AACF;;;ACjDO,IAAM,kBAAkB;AAAA,EAC7B,QAAQ,CAAwB,cAA4B;AAC1D,WAAO,cAAc,OAAU,SAAS;AAAA,EAC1C;AAAA,EACA,gBAAgB,CAAwB,cAA4B;AAClE,WAAO,cAAc,eAAkB,SAAS;AAAA,EAClD;AACF;;;ACVO,IAAM,SAAS,CAAC,OAAgB,iBAA4B;AACjE,QAAM,cAAc,OAAO;AAC3B,UAAQ,cAAc;AAAA,IACpB,KAAK,SAAS;AACZ,aAAO,MAAM,QAAQ,KAAK;AAAA,IAC5B;AAAA,IACA,KAAK,QAAQ;AACX,aAAO,UAAU;AAAA,IACnB;AAAA,IACA,KAAK,aAAa;AAChB,aAAO,UAAU;AAAA,IACnB;AAAA,IACA,KAAK,UAAU;AAEb,UAAI,UAAU,MAAM;AAClB,eAAO;AAAA,MACT;AAEA,aAAO,gBAAgB,YAAY,CAAC,MAAM,QAAQ,KAAK;AAAA,IACzD;AAAA,IACA,SAAS;AACP,aAAO,gBAAgB;AAAA,IACzB;AAAA,EACF;AACF;;;ACvBO,IAAM,WAAW,CAAC,UAAuC;AAC9D,SAAO,OAAO,OAAO,QAAQ;AAC/B;;;ACDO,IAAM,eAAe,MAAM,gBAAgB,OAAkB,CAAsB,QAA2B,SAAS,GAAG,CAAC,GAAG;;;AC0CrI,IAAM,cAAc,CAAC,QACnB,QAAQ,eAAe,QAAQ,iBAAiB,QAAQ;AAE1D,SAAS,MAA2B,QAAmB,QAAoB,SAA2B;AACpG,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAElD,aAAW,OAAO,QAAQ,QAAQ,MAAM,GAAG;AACzC,UAAM,QAAQ,OAAO,GAAG;AACxB,QAAI,YAAY,GAAG,GAAG;AACpB;AAAA,IACF,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,aAAO,GAAG,IAEN,SAAS,kBAAkB,YAAY,MAAM,QAAQ,OAAO,GAAG,CAAC,IAC9D,CAAC,GAAG,OAAO,GAAG,GAAG,GAAG,KAAK,IACzB;AAAA,IACR,WAAW,UAAU,QAAQ,OAAO,UAAU,UAAU;AAEtD,UAAI,CAAC,OAAO,GAAG,KAAK,OAAO,OAAO,GAAG,MAAM,UAAU;AACnD,eAAO,GAAG,IAAI,CAAC;AAAA,MACjB;AACA,YAAM,OAAO,GAAG,GAAgB,OAAoB,OAAO;AAAA,IAC7D,OAAO;AAEL,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AAEA,SAAO;AACT;AAOO,SAAS,gBAAgB,SAAuB;AACrD,SAAO,SAASA,cAAoC,SAAyB;AAC3E,UAAM,SAAU,QAAQ,SAAS,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;AACrD,eAAW,OAAO,SAAS;AACzB,YAAM,QAAQ,KAAK,OAAO;AAAA,IAC5B;AACA,WAAO;AAAA,EACT;AACF;AAcO,IAAM,YAAY,gBAAgB,EAAE,eAAe,aAAa,QAAQ,MAAM,CAAC;;;ACxGtF;AAAA,EACE,YAAAC;AAAA,EAAU;AAAA,OAEL;AAOA,IAAM,kBAAN,MAA6C;AAAA,EAClD,OAAO,OAAyB,kBAA2D;AACzF,WAAO,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,MAAgB;AACtC,UAAI,CAACC,UAAS,GAAG,GAAG;AAClB,eAAO;AAAA,MACT;AACA;AAAA;AAAA,QAEE,OAAO,QAAQ,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,MAAM;AAElD,gBAAM,SAAS,OAAQ,IAAY,GAAG,GAAG,IAAI;AAC7C,cAAI,CAAC,UAAU,SAAS,GAAG,GAAG;AAC5B,kBAAM,SAAS,OAAO,QAAQ,WAAW,MAAM;AAC/C,mBAAO,KAAK,kBAAkB,GAAG,KAAK,IAAI,EAAE;AAAA,UAC9C;AACA,iBAAO,CAAC;AAAA,QACV,CAAC,EAAE,WAAW,MAEV,kBAAkB,OAAO,CAAC,MAAM,UAAU,QAAQ,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;AAAA;AAAA,IAExF;AAAA,EACF;AACF;;;AChCA,SAAS,YAAAC,iBAAgB;AAMlB,IAAM,cAAc,CAAC,UAAuC;AACjE,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,WAAW;AACd,aAAO;AAAA,IACT;AAAA,IACA,SAAS;AACP,aAAO,UAAU,QAAQ,aAAa,KAAK,KAAK,YAAY,KAAK;AAAA,IACnE;AAAA,EACF;AACF;AAEO,IAAM,cAAc,CAAC,UAAuC;AACjE,SAAO,MAAM,QAAQ,KAAK,KAAK,CAAC,MAAM,KAAK,UAAQ,CAAC,YAAY,IAAI,CAAC;AACvE;AAEO,IAAM,uBAAuB,CAAC,CAAC,KAAK,KAAK,MAAsC;AACpF,SAAO,OAAO,QAAQ,YAAY,YAAY,KAAK;AACrD;AAEO,IAAM,eAAe,CAAC,UAAwC;AACnE,SACEA,UAAS,KAAK,KAEX,CAAC,OAAO,QAAQ,KAAK,EAAE,KAAK,UAAQ,CAAC,qBAAqB,IAAI,CAAC;AAEtE;;;AC9BO,IAAe,gBAAf,MAAkE;AAAA,EAC9D;AAAA,EACT,YAAY,KAAQ;AAClB,SAAK,MAAM;AAAA,EACb;AAAA,EAEA,IAAc,eAAe;AAC3B,WAAO,KAAK;AAAA,EACd;AACF;;;ACZA,SAAS,YAAAC,iBAAgB;AAQzB,IAAM,cAAc,CAClB,KACA,WACA,aACQ;AACR,SAAO,IAAI,IAAI,CAAC,UAAU;AACxB,WAAQ,UAAU,QAAQ,OAAO,UAAU,WAAY,OAAO,OAAO,WAAW,QAAQ,IAAI;AAAA,EAC9F,CAAC;AACH;AAEA,IAAM,eAAe,CACnB,KACA,WACA,aACe;AACf,QAAM,SAAqB,CAAC;AAE5B,aAAW,OAAO,KAAK;AACrB,QAAI,OAAO,OAAO,KAAK,GAAG,GAAG;AAC3B,YAAM,QAAQ,IAAI,GAAG;AACrB,UAAI,CAAC,UAAU,OAAO,GAAG,GAAG;AAC1B,eAAO,GAAG,IAAM,UAAU,QAAQ,OAAO,UAAU,WAAY,OAAO,OAAO,WAAW,WAAW,CAAC,IAAI;AAAA,MAC1G;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,IAAM,SAAS,CACpB,KACA,WACA,WAAW,MACI;AACf,MAAI,YAAY,GAAG;AACjB,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,QAAQ,GAAG,IAAI,YAAY,KAAK,WAAW,WAAW,CAAC,IAAS,aAAa,KAAK,WAAW,WAAW,CAAC;AACxH;AAEA,IAAM,wBAAwB,CAAC,WAAmB,CAAC,GAAY,QAAgB;AAC7E,EAAAA,UAAS,OAAO,QAAQ,UAAU,MAAM,qBAAqB,GAAG,KAAK,OAAO,GAAG,GAAG;AAClF,SAAO,IAAI,WAAW,MAAM;AAC9B;AAEO,IAAM,eAAe,CAA0C,SAAY,QAAW,WAAW,QAAkC;AACxI,SAAO,OAAO,SAAS,sBAAsB,MAAM,GAAG,QAAQ;AAChE;;;ACxDA,SAAS,YAAAC,iBAAgB;AAQzB,IAAM,cAAc,CAClB,KACA,WACA,aACQ;AACR,SAAO,IAAI,IAAI,CAAC,UAAU;AACxB,WAAQ,UAAU,QAAQ,OAAO,UAAU,WAAY,OAAO,OAAO,WAAW,QAAQ,IAAI;AAAA,EAC9F,CAAC;AACH;AAEA,IAAM,eAAe,CACnB,KACA,WACA,aACe;AACf,QAAM,SAAqB,CAAC;AAE5B,aAAW,OAAO,KAAK;AACrB,QAAI,OAAO,OAAO,KAAK,GAAG,GAAG;AAC3B,YAAM,QAAQ,IAAI,GAAG;AACrB,UAAI,UAAU,OAAO,GAAG,GAAG;AACzB,eAAO,GAAG,IAAM,UAAU,QAAQ,OAAO,UAAU,WAAY,OAAO,OAAO,WAAW,WAAW,CAAC,IAAI;AAAA,MAC1G;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,IAAM,SAAS,CACpB,KACA,WACA,WAAW,MACI;AACf,MAAI,YAAY,GAAG;AACjB,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,QAAQ,GAAG,IAAI,YAAY,KAAK,WAAW,WAAW,CAAC,IAAS,aAAa,KAAK,WAAW,WAAW,CAAC;AACxH;AAEA,IAAM,wBAAwB,CAAC,WAAmB,CAAC,GAAY,QAAgB;AAC7E,EAAAA,UAAS,OAAO,QAAQ,UAAU,MAAM,qBAAqB,GAAG,KAAK,OAAO,GAAG,GAAG;AAClF,SAAO,IAAI,WAAW,MAAM;AAC9B;AAEO,IAAM,eAAe,CAA0C,SAAY,QAAW,WAAW,QAAkC;AACxI,SAAO,OAAO,SAAS,sBAAsB,MAAM,GAAG,QAAQ;AAChE;;;ACtDO,IAAM,eAAe,CAA2C,KAAQ,WAA4B;AACzG,QAAM,QAAQ,EAAE,GAAG,IAAI;AACvB,aAAW,SAAS,QAAQ;AAC1B,WAAO,MAAM,KAAK;AAAA,EACpB;AACA,SAAO;AACT;;;ACJO,IAAM,cAAc,CAAC,OAAkB,WAAuB,WAAW,MAAiB;AAC/F,SAAO,MAAM,IAAI,UAAQ,YAAY,MAAM,WAAW,QAAQ,CAAC;AACjE;AAEO,IAAM,eAAe,CAAC,OAAe,WAAuB,WAAW,MAAkB;AAC9F,QAAM,SAAqB,CAAC;AAC5B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,WAAO,GAAG,IAAI,UAAU,SAAY,gBAAgB,YAAY,OAAO,WAAW,QAAQ;AAAA,EAC5F;AACA,SAAO;AACT;AAEO,IAAM,cAAc,CAAC,OAAgB,WAAuB,WAAW,MAAiB;AAC7F,MAAI,YAAY,KAAK,OAAO,UAAU,UAAU;AAC9C,WAAO;AAAA,EACT;AACA,MAAI,WAAW,SAAS,KAAK,GAAG;AAC9B,WAAO;AAAA,EACT;AACA,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK,UAAU;AACb,aAAO;AAAA,IACT;AAAA,IACA,KAAK,UAAU;AACb,UAAI,UAAU,MAAM;AAClB,eAAO;AAAA,MACT;AACA,YAAM,eAAe,aAAa,CAAC;AACnC,mBAAa,KAAK,KAAK;AACvB,aAAO,MAAM,QAAQ,KAAK,IAAI,YAAY,OAAO,cAAc,WAAW,CAAC,IAAI,aAAa,OAAO,cAAc,WAAW,CAAC;AAAA,IAC/H;AAAA,IACA,SAAS;AACP,aAAO,IAAI,OAAO,KAAK;AAAA,IACzB;AAAA,EACF;AACF;AAEO,IAAM,eAAe,CAAC,OAAgB,WAAW,MAAM;AAC5D,SAAO,KAAK,UAAU,OAAO,OAAO,QAAQ,GAAG,MAAM,CAAC;AACxD;AAEO,IAAM,SAAS,CAAC,OAAgB,WAAW,MAAiB;AACjE,SAAO,YAAY,OAAO,QAAW,QAAQ;AAC/C;;;ACvCO,IAAe,gBAAf,cAAwE,cAAkD;AAEjI;","names":["deepMerge","isObject","isObject","isObject","assertEx","assertEx"]}

package/dist/types/deepMerge.d.ts

@@ -0,0 +1,49 @@
+import type { AnyObject } from './AnyObject.ts';
+/**
+ * Deeply merges two types into a new type.
+ */
+type DeepMerge<A, B> = {
+    [K in keyof A | keyof B]: K extends keyof B ? K extends keyof A ? A[K] extends object ? B[K] extends object ? DeepMerge<A[K], B[K]> : B[K] : B[K] : B[K] : K extends keyof A ? A[K] : never;
+};
+/**
+ * Merges multiple types into a new type.
+ */
+type MergeAll<T extends object[], R = {}> = T extends [infer First extends object, ...infer Rest extends object[]] ? MergeAll<Rest, DeepMerge<R, First>> : R;
+/**
+ * Options for merging objects in the deep merge function.
+ */
+type MergeOptions = {
+    /**
+     * Strategy for merging arrays.
+     * - 'overwrite': Overwrites the array with the last object's value.
+     * - 'concat': Concatenates arrays from all objects.
+     * @default 'overwrite'
+     */
+    arrayStrategy?: 'overwrite' | 'concat';
+    /**
+     * Mutate the first object in the list instead of creating a new one.
+     * @default false
+     */
+    mutate?: boolean;
+};
+/**
+ * Creates a deep merge function with the specified options.
+ * @param options Options for merging.
+ * @returns A deep merge function configured for the specified options.
+ */
+export declare function createDeepMerge(options: MergeOptions): <T extends AnyObject[]>(...objects: T) => MergeAll<T>;
+/**
+ * Deeply merges multiple objects into a new object.
+ * @param objects Multiple objects to merge deeply.
+ * The function merges properties from all objects into a new object.
+ * If a property exists in multiple objects, the last object's value will be used.
+ * If a property is an object, it will be merged recursively.
+ * If a property is an array, it will be overwritten by the last object's value.
+ * If a property is a primitive value, it will be overwritten by the last object's value.
+ * If a property is undefined or null in the source, it will be skipped.
+ * If a property is a symbol, it will be merged as well.
+ * @returns A new object with the merged properties.
+ */
+export declare const deepMerge: <T extends AnyObject[]>(...objects: T) => MergeAll<T>;
+export {};
+//# sourceMappingURL=deepMerge.d.ts.map

package/dist/types/deepMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../src/deepMerge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI;KACpB,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,GACvB,CAAC,SAAS,MAAM,CAAC,GACb,CAAC,SAAS,MAAM,CAAC,GACf,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,GACN,CAAC,CAAC,CAAC,CAAC,GACN,CAAC,CAAC,CAAC,CAAC,GACN,CAAC,SAAS,MAAM,CAAC,GACf,CAAC,CAAC,CAAC,CAAC,GACJ,KAAK;CACZ,CAAA;AAED;;GAEG;AACH,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,IACtC,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,SAAS,MAAM,EAAE,CAAC,GAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GACnC,CAAC,CAAA;AAEP;;GAEG;AACH,KAAK,YAAY,GAAG;IAClB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAA;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAiCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,IACzB,CAAC,SAAS,SAAS,EAAE,EAAE,GAAG,SAAS,CAAC,KAAG,QAAQ,CAAC,CAAC,CAAC,CAO7E;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GArBM,CAAC,SAAS,SAAS,EAAE,cAAc,CAAC,KAAG,QAAQ,CAAC,CAAC,CAqBU,CAAA"}

package/dist/types/index.d.ts

@@ -3,6 +3,7 @@ export * from './asObject.ts';
 export * from './AsObjectFactory.ts';
 export * from './AsTypeFactory.ts';
 export * from './Compare.ts';
+export * from './deepMerge.ts';
 export * from './EmptyObject.ts';
 export * from './isObject.ts';
 export * from './IsObjectFactory.ts';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/object",
-  "version": "4.11.2",
+  "version": "4.11.4",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -29,10 +29,10 @@
   "module": "dist/neutral/index.mjs",
   "types": "dist/types/index.d.ts",
   "dependencies": {
-    "@xylabs/assert": "^4.11.2",
-    "@xylabs/logger": "^4.11.2",
-    "@xylabs/promise": "^4.11.2",
-    "@xylabs/typeof": "^4.11.2"
+    "@xylabs/assert": "^4.11.4",
+    "@xylabs/logger": "^4.11.4",
+    "@xylabs/promise": "^4.11.4",
+    "@xylabs/typeof": "^4.11.4"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "^6.5.7",

package/src/deepMerge.ts

@@ -0,0 +1,105 @@
+import type { AnyObject } from './AnyObject.ts'
+
+/**
+ * Deeply merges two types into a new type.
+ */
+type DeepMerge<A, B> = {
+  [K in keyof A | keyof B]:
+  K extends keyof B
+    ? K extends keyof A
+      ? A[K] extends object
+        ? B[K] extends object
+          ? DeepMerge<A[K], B[K]>
+          : B[K]
+        : B[K]
+      : B[K]
+    : K extends keyof A
+      ? A[K]
+      : never;
+}
+
+/**
+ * Merges multiple types into a new type.
+ */
+type MergeAll<T extends object[], R = {}> =
+  T extends [infer First extends object, ...infer Rest extends object[]]
+    ? MergeAll<Rest, DeepMerge<R, First>>
+    : R
+
+/**
+ * Options for merging objects in the deep merge function.
+ */
+type MergeOptions = {
+  /**
+   * Strategy for merging arrays.
+   * - 'overwrite': Overwrites the array with the last object's value.
+   * - 'concat': Concatenates arrays from all objects.
+   * @default 'overwrite'
+   */
+  arrayStrategy?: 'overwrite' | 'concat'
+  /**
+   * Mutate the first object in the list instead of creating a new one.
+   * @default false
+   */
+  mutate?: boolean
+}
+
+const isUnsafeKey = (key: string | symbol): boolean =>
+  key === '__proto__' || key === 'constructor' || key === 'prototype'
+
+function merge<T extends AnyObject>(target: AnyObject, source?: AnyObject, options?: MergeOptions): T {
+  if (!source || typeof source !== 'object') return target as T
+
+  for (const key of Reflect.ownKeys(source)) {
+    const value = source[key]
+    if (isUnsafeKey(key)) {
+      continue
+    } else if (Array.isArray(value)) {
+      target[key]
+      // If the value is an array, handle it based on the configured array strategy
+        = options?.arrayStrategy === 'concat' && Array.isArray(target[key])
+          ? [...target[key], ...value]
+          : value
+    } else if (value !== null && typeof value === 'object') {
+      // Recursively merge nested objects
+      if (!target[key] || typeof target[key] !== 'object') {
+        target[key] = {}
+      }
+      merge(target[key] as AnyObject, value as AnyObject, options)
+    } else {
+      // Overwrite with non-object values
+      target[key] = value
+    }
+  }
+
+  return target as T
+}
+
+/**
+ * Creates a deep merge function with the specified options.
+ * @param options Options for merging.
+ * @returns A deep merge function configured for the specified options.
+ */
+export function createDeepMerge(options: MergeOptions) {
+  return function deepMerge<T extends AnyObject[]>(...objects: T): MergeAll<T> {
+    const result = (options.mutate ? objects[0] ?? {} : {}) as MergeAll<T>
+    for (const obj of objects) {
+      merge(result, obj, options)
+    }
+    return result
+  }
+}
+
+/**
+ * Deeply merges multiple objects into a new object.
+ * @param objects Multiple objects to merge deeply.
+ * The function merges properties from all objects into a new object.
+ * If a property exists in multiple objects, the last object's value will be used.
+ * If a property is an object, it will be merged recursively.
+ * If a property is an array, it will be overwritten by the last object's value.
+ * If a property is a primitive value, it will be overwritten by the last object's value.
+ * If a property is undefined or null in the source, it will be skipped.
+ * If a property is a symbol, it will be merged as well.
+ * @returns A new object with the merged properties.
+ */
+export const deepMerge = createDeepMerge({ arrayStrategy: 'overwrite', mutate: false })

package/src/index.ts

@@ -3,6 +3,7 @@ export * from './asObject.ts'
 export * from './AsObjectFactory.ts'
 export * from './AsTypeFactory.ts'
 export * from './Compare.ts'
+export * from './deepMerge.ts'
 export * from './EmptyObject.ts'
 export * from './isObject.ts'
 export * from './IsObjectFactory.ts'