@xyo-network/payload-builder 2.110.19 → 2.111.1

package/dist/browser/index.cjs

@@ -84,7 +84,7 @@ var PayloadBuilderBase = class _PayloadBuilderBase {
       this._fields
     );
   }
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields) {
     if (fields) {
       const { $meta, $hash, schema, ...fieldsOnly } = fields;

package/dist/browser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder.ts'\nexport * from './BuilderBase.ts'\nexport * from './Options.ts'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map((payload) => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      //check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads ?\n        await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload, options)\n            return built.$hash\n          }),\n        )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map((payload) => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["import_assert","import_lodash","import_object","import_hash","omitByPredicate","payload"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder.ts'\nexport * from './BuilderBase.ts'\nexport * from './Options.ts'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map(payload => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      // check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n        payloads.map(async (payload) => {\n          const built = await PayloadBuilder.build(payload, options)\n          return built.$hash\n        }),\n      )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map(payload => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  // we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["import_assert","import_lodash","import_object","import_hash","omitByPredicate","payload"]}

package/dist/browser/{index.js → index.mjs}

@@ -56,7 +56,7 @@ var PayloadBuilderBase = class _PayloadBuilderBase {
       this._fields
     );
   }
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields) {
     if (fields) {
       const { $meta, $hash, schema, ...fieldsOnly } = fields;
@@ -237,4 +237,4 @@ export {
   PayloadBuilderBase,
   removeMetaAndSchema
 };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/browser/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map(payload => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      // check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n        payloads.map(async (payload) => {\n          const built = await PayloadBuilder.build(payload, options)\n          return built.$hash\n        }),\n      )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map(payload => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  // we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["assertEx","omitBy","isJsonObject","omitByPredicate","assertEx","payload","isJsonObject","omitBy"]}

package/dist/neutral/index.cjs

@@ -84,7 +84,7 @@ var PayloadBuilderBase = class _PayloadBuilderBase {
       this._fields
     );
   }
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields) {
     if (fields) {
       const { $meta, $hash, schema, ...fieldsOnly } = fields;

package/dist/neutral/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder.ts'\nexport * from './BuilderBase.ts'\nexport * from './Options.ts'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map((payload) => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      //check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads ?\n        await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload, options)\n            return built.$hash\n          }),\n        )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map((payload) => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["import_assert","import_lodash","import_object","import_hash","omitByPredicate","payload"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder.ts'\nexport * from './BuilderBase.ts'\nexport * from './Options.ts'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map(payload => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      // check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n        payloads.map(async (payload) => {\n          const built = await PayloadBuilder.build(payload, options)\n          return built.$hash\n        }),\n      )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map(payload => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  // we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["import_assert","import_lodash","import_object","import_hash","omitByPredicate","payload"]}

package/dist/neutral/{index.js → index.mjs}

@@ -56,7 +56,7 @@ var PayloadBuilderBase = class _PayloadBuilderBase {
       this._fields
     );
   }
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields) {
     if (fields) {
       const { $meta, $hash, schema, ...fieldsOnly } = fields;
@@ -237,4 +237,4 @@ export {
   PayloadBuilderBase,
   removeMetaAndSchema
 };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map(payload => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      // check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n        payloads.map(async (payload) => {\n          const built = await PayloadBuilder.build(payload, options)\n          return built.$hash\n        }),\n      )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map(payload => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  // we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["assertEx","omitBy","isJsonObject","omitByPredicate","assertEx","payload","isJsonObject","omitBy"]}

package/dist/node/index.cjs

@@ -84,7 +84,7 @@ var PayloadBuilderBase = class _PayloadBuilderBase {
       this._fields
     );
   }
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields) {
     if (fields) {
       const { $meta, $hash, schema, ...fieldsOnly } = fields;

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder.ts'\nexport * from './BuilderBase.ts'\nexport * from './Options.ts'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map((payload) => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      //check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads ?\n        await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload, options)\n            return built.$hash\n          }),\n        )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map((payload) => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["import_assert","import_lodash","import_object","import_hash","omitByPredicate","payload"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder.ts'\nexport * from './BuilderBase.ts'\nexport * from './Options.ts'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map(payload => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      // check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n        payloads.map(async (payload) => {\n          const built = await PayloadBuilder.build(payload, options)\n          return built.$hash\n        }),\n      )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map(payload => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  // we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["import_assert","import_lodash","import_object","import_hash","omitByPredicate","payload"]}

package/dist/node/{index.js → index.mjs}

@@ -56,7 +56,7 @@ var PayloadBuilderBase = class _PayloadBuilderBase {
       this._fields
     );
   }
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields) {
     if (fields) {
       const { $meta, $hash, schema, ...fieldsOnly } = fields;
@@ -240,4 +240,4 @@ export {
   PayloadBuilderBase,
   removeMetaAndSchema
 };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map(payload => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      // check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n        payloads.map(async (payload) => {\n          const built = await PayloadBuilder.build(payload, options)\n          return built.$hash\n        }),\n      )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map(payload => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  // we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["assertEx","omitBy","isJsonObject","omitByPredicate","assertEx","payload","isJsonObject","omitBy"]}

package/package.json

@@ -10,18 +10,19 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
   },
   "dependencies": {
-    "@xylabs/assert": "^3.6.6",
-    "@xylabs/hex": "^3.6.6",
-    "@xylabs/lodash": "^3.6.6",
-    "@xylabs/logger": "^3.6.6",
-    "@xylabs/object": "^3.6.6",
-    "@xylabs/promise": "^3.6.6",
-    "@xyo-network/hash": "^2.110.19",
-    "@xyo-network/payload-model": "^2.110.19"
+    "@xylabs/assert": "^3.6.8",
+    "@xylabs/hex": "^3.6.8",
+    "@xylabs/lodash": "^3.6.8",
+    "@xylabs/logger": "^3.6.8",
+    "@xylabs/object": "^3.6.8",
+    "@xylabs/promise": "^3.6.8",
+    "@xyo-network/hash": "^2.111.1",
+    "@xyo-network/payload-model": "^2.111.1"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "^3.14.1",
-    "@xylabs/tsconfig": "^3.14.1",
+    "@xylabs/ts-scripts-yarn3": "^3.15.8",
+    "@xylabs/tsconfig": "^3.15.8",
+    "tslib": "^2.6.3",
     "typescript": "^5.5.4"
   },
   "description": "Primary SDK for using XYO Protocol 2.0",
@@ -34,7 +35,7 @@
         },
         "import": {
           "types": "./dist/browser/index.d.mts",
-          "default": "./dist/browser/index.js"
+          "default": "./dist/browser/index.mjs"
         }
       },
       "node": {
@@ -44,14 +45,14 @@
         },
         "import": {
           "types": "./dist/node/index.d.mts",
-          "default": "./dist/node/index.js"
+          "default": "./dist/node/index.mjs"
         }
       }
     },
     "./package.json": "./package.json"
   },
   "main": "dist/node/index.cjs",
-  "module": "dist/node/index.js",
+  "module": "dist/node/index.mjs",
   "homepage": "https://xyo.network",
   "license": "LGPL-3.0-only",
   "publishConfig": {
@@ -63,6 +64,6 @@
   },
   "sideEffects": false,
   "types": "dist/node/index.d.ts",
-  "version": "2.110.19",
+  "version": "2.111.1",
   "type": "module"
 }

package/src/Builder.ts

@@ -26,12 +26,12 @@ export class PayloadBuilder<
   static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>
   static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {
     if (Array.isArray(payload)) {
-      return await Promise.all(payload.map((payload) => this.build(payload, options)))
+      return await Promise.all(payload.map(payload => this.build(payload, options)))
     } else {
       const { stamp = false, validate = true } = options
       const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>
 
-      //check for legacy signatures
+      // check for legacy signatures
       const { _signatures } = payload as { _signatures?: JsonArray }
       if (_signatures && !incomingMeta.signatures) {
         incomingMeta.signatures = _signatures
@@ -70,13 +70,13 @@ export class PayloadBuilder<
   static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>
   static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>
   static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {
-    return payloads ?
-        await Promise.all(
-          payloads.map(async (payload) => {
-            const built = await PayloadBuilder.build(payload, options)
-            return built.$hash
-          }),
-        )
+    return payloads
+      ? await Promise.all(
+        payloads.map(async (payload) => {
+          const built = await PayloadBuilder.build(payload, options)
+          return built.$hash
+        }),
+      )
       : undefined
   }
 
@@ -86,12 +86,12 @@ export class PayloadBuilder<
 
   static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {
     const hashes = Array.isArray(hash) ? hash : [hash]
-    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])
+    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map(pair => pair[0])
   }
 
   static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {
     const hashes = Array.isArray(hash) ? hash : [hash]
-    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])
+    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map(pair => pair[0])
   }
 
   static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {
@@ -193,7 +193,7 @@ export class PayloadBuilder<
   static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]
   static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {
     if (Array.isArray(payloads)) {
-      return payloads.map((payload) => this.withoutMeta(payload))
+      return payloads.map(payload => this.withoutMeta(payload))
     } else {
       if (payloads) {
         // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/src/BuilderBase.ts

@@ -73,7 +73,7 @@ export class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extend
     )
   }
 
-  //we do not require sending in $hash since it will be generated anyway
+  // we do not require sending in $hash since it will be generated anyway
   fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {
     if (fields) {
       // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/dist/browser/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map((payload) => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      //check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads ?\n        await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload, options)\n            return built.$hash\n          }),\n        )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map((payload) => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["assertEx","omitBy","isJsonObject","omitByPredicate","assertEx","payload","isJsonObject","omitBy"]}

package/dist/neutral/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map((payload) => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      //check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads ?\n        await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload, options)\n            return built.$hash\n          }),\n        )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map((payload) => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["assertEx","omitBy","isJsonObject","omitByPredicate","assertEx","payload","isJsonObject","omitBy"]}

package/dist/node/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonArray, JsonObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase, removeMetaAndSchema, WithoutMeta, WithoutSchema } from './BuilderBase.ts'\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport interface BuildOptions {\n  stamp?: boolean\n  validate?: boolean\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilder<\n  T extends Payload = Payload<AnyObject>,\n  O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>,\n> extends PayloadBuilderBase<T, O> {\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T, options?: BuildOptions): Promise<WithMeta<T>>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T[], options?: BuildOptions): Promise<WithMeta<T>[]>\n  static async build<T extends Payload = Payload<AnyObject>>(payload: T | T[], options: BuildOptions = {}) {\n    if (Array.isArray(payload)) {\n      return await Promise.all(payload.map((payload) => this.build(payload, options)))\n    } else {\n      const { stamp = false, validate = true } = options\n      const { schema, $hash: incomingDataHash, $meta: incomingMeta = {} } = payload as WithMeta<T>\n\n      //check for legacy signatures\n      const { _signatures } = payload as { _signatures?: JsonArray }\n      if (_signatures && !incomingMeta.signatures) {\n        incomingMeta.signatures = _signatures\n      }\n\n      const fields = removeMetaAndSchema(payload)\n      const dataHashableFields = await PayloadBuilder.dataHashableFields(schema, fields)\n      const $hash = validate || incomingDataHash === undefined ? await PayloadHasher.hash(dataHashableFields) : incomingDataHash\n      const $meta: JsonObject = { ...incomingMeta }\n      if ($meta.timestamp === undefined && stamp) {\n        $meta.timestamp = Date.now()\n      }\n      const hashableFields: WithMeta<Payload> = { ...dataHashableFields, $hash, schema }\n\n      if (Object.keys($meta).length > 0) {\n        hashableFields.$meta = $meta\n      }\n\n      return hashableFields as WithMeta<T>\n    }\n  }\n\n  static async dataHash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return (await this.build(payload, options)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined, options?: BuildOptions): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[], options?: BuildOptions): Promise<Hash[] | undefined> {\n    return payloads ?\n        await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload, options)\n            return built.$hash\n          }),\n        )\n      : undefined\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash)\n  }\n\n  static async filterExcludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterIncludeByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async findByDataHash<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\n  }\n\n  static async hash<T extends Payload>(payload: T, options?: BuildOptions): Promise<Hash> {\n    return await PayloadHasher.hash(await PayloadBuilder.build(payload, options))\n  }\n\n  /**\n   * Creates an array of payload/hash tuples based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns An array of payload/hash tuples\n   */\n  static async hashPairs<T extends Payload>(payloads: T[], options?: BuildOptions): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map<Promise<[WithMeta<T>, Hash]>>(async (payload) => {\n        const built = await PayloadBuilder.build(payload, options)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\n  }\n\n  static async hashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n    $meta?: JsonObject,\n    $hash?: Hash,\n    timestamp?: number,\n    stamp = false,\n  ): Promise<WithMeta<T>> {\n    const dataFields = await this.dataHashableFields<T>(schema, fields)\n    assertEx($meta === undefined || isJsonObject($meta), () => '$meta must be JsonObject')\n    const result: WithMeta<T> = omitBy(\n      {\n        ...dataFields,\n        $hash: $hash ?? (await PayloadBuilder.dataHash(dataFields)),\n        schema,\n      } as WithMeta<T>,\n      omitByPredicate('_'),\n    ) as WithMeta<T>\n\n    const clonedMeta = { ...$meta }\n\n    if (timestamp) {\n      clonedMeta.timestamp = timestamp\n    }\n\n    if (clonedMeta.timestamp === undefined && stamp) {\n      clonedMeta.timestamp = Date.now()\n    }\n\n    if (Object.keys(clonedMeta).length > 0) {\n      result.$meta = clonedMeta\n    }\n\n    return result\n  }\n\n  static async hashes(payloads: undefined): Promise<undefined>\n  static async hashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async hashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return await PayloadHasher.hashes(payloads)\n  }\n\n  static async toAllHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n      result[pair[0].$hash] = pair[0]\n    }\n    return result\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.dataHashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  /**\n   * Creates an object map of payload hashes to payloads based on the payloads passed in\n   * @param objs Any array of payloads\n   * @returns A map of hashes to payloads\n   */\n  static async toHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, WithMeta<T>>> {\n    const result: Record<Hash, WithMeta<T>> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  static withoutMeta(payload: undefined): undefined\n  static withoutMeta<T extends PayloadWithMeta>(payload: T): Omit<T, '$meta'>\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T[]): Omit<T, '$meta'>[]\n  static withoutMeta<T extends PayloadWithMeta>(payloads: T | T[]) {\n    if (Array.isArray(payloads)) {\n      return payloads.map((payload) => this.withoutMeta(payload))\n    } else {\n      if (payloads) {\n        // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        const { $meta, ...result } = payloads\n        return result as Omit<T, '$meta'>\n      }\n    }\n  }\n\n  async build(options?: BuildOptions): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    return await PayloadBuilder.build<T>({ ...dataHashableFields, $meta: this._$meta, schema: this._schema } as Payload as T, options)\n  }\n\n  async hashableFields() {\n    return await PayloadBuilder.hashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n      this._$meta,\n    )\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { omitBy } from '@xylabs/lodash'\nimport { AnyObject, isJsonObject, JsonObject, toJson } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta, WithOptionalMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options.ts'\n\nexport type WithOptionalSchema<T extends Payload> = Omit<T, 'schema'> & Partial<T>\n\nexport type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>\n\nexport type WithoutMeta<T extends WithOptionalMeta<Payload>> = Omit<T, '$hash' | '$meta'>\n\nexport const removeMetaAndSchema = <T extends Payload>(payload: WithOptionalSchema<WithOptionalMeta<T>>): WithoutSchema<WithoutMeta<T>> => {\n  const { ...result } = payload\n  delete result.$hash\n  delete result.$meta\n  delete result.schema\n  return result as Omit<T, 'schema'>\n}\n\nconst omitByPredicate = (prefix: string) => (_: unknown, key: string) => {\n  assertEx(typeof key === 'string', () => `Invalid key type [${key}, ${typeof key}]`)\n  return key.startsWith(prefix)\n}\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: WithoutSchema<WithoutMeta<T>>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = removeEmptyFields(fields ?? {}) as WithoutSchema<WithoutMeta<T>>\n    this._$meta = meta\n  }\n\n  static dataHashableFields<T extends Payload = Payload<AnyObject>>(\n    schema: string,\n    fields?: WithoutSchema<WithoutMeta<T>>,\n  ): Promisable<Omit<T, '$hash' | '$meta'>> {\n    const cleanFields = fields ? removeEmptyFields(fields) : undefined\n    assertEx(\n      cleanFields === undefined || isJsonObject(cleanFields),\n      () => `Fields must be JsonObject: ${JSON.stringify(toJson(cleanFields), null, 2)}`,\n    )\n    return omitBy(omitBy({ schema, ...cleanFields }, omitByPredicate('$')), omitByPredicate('_')) as unknown as T\n  }\n\n  protected static metaFields(dataHash: Hash, otherMeta?: JsonObject, stamp = true): Promisable<JsonObject> {\n    const meta: JsonObject = { ...otherMeta }\n\n    if (!meta.timestamp && stamp) {\n      meta.timestamp = meta.timestamp ?? Date.now()\n    }\n\n    return meta\n  }\n\n  $meta(meta?: JsonObject) {\n    this._$meta = meta ?? (this._fields as WithMeta<T>).$meta\n    return this\n  }\n\n  async dataHashableFields() {\n    return await PayloadBuilderBase.dataHashableFields(\n      assertEx(this._schema, () => 'Payload: Missing Schema'),\n      this._fields,\n    )\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: WithOptionalSchema<WithOptionalMeta<T>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = removeMetaAndSchema<T>(fields)\n    }\n    return this\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n\n  protected async metaFields(dataHash: Hash, stamp = true): Promise<JsonObject> {\n    return await PayloadBuilderBase.metaFields(dataHash, this._$meta, stamp)\n  }\n}\n"],"mappings":"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","names":["assertEx","omitBy","isJsonObject","omitByPredicate","assertEx","payload","isJsonObject","omitBy"]}