@xyo-network/payload-builder 2.89.0-rc.1 → 2.89.0-rc.11

package/dist/node/index.cjs

@@ -21,33 +21,81 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  PayloadBuilder: () => PayloadBuilder
+  PayloadBuilder: () => PayloadBuilder,
+  PayloadBuilderBase: () => PayloadBuilderBase
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/Builder.ts
+var import_hash2 = require("@xyo-network/hash");
+
+// src/BuilderBase.ts
 var import_assert = require("@xylabs/assert");
 var import_hash = require("@xyo-network/hash");
-var _PayloadBuilder = class _PayloadBuilder {
+var _PayloadBuilderBase = class _PayloadBuilderBase {
+  options;
   _$meta;
-  _fields = {};
+  _fields;
   _schema;
-  constructor({ schema, fields, meta }) {
+  constructor(options) {
+    this.options = options;
+    const { schema, fields, meta } = options;
     this._schema = schema;
-    this._fields = fields ?? {};
+    this._fields = fields;
     this._$meta = meta;
   }
-  get schema() {
-    this._schema = this._schema ?? this._fields["schema"];
-    return this._schema;
+  $meta(meta) {
+    this._$meta = meta ?? this._fields.$meta;
+    return this;
+  }
+  async dataHashableFields() {
+    return (0, import_hash.deepOmitPrefixedFields)(await this.hashableFields(), "$");
   }
+  //we do not require sending in $hash since it will be generated anyway
+  fields(fields) {
+    if (fields) {
+      const { $meta, $hash, schema, ...fieldsOnly } = fields;
+      if ($meta) {
+        this.$meta($meta);
+      }
+      if (schema) {
+        this.schema(schema);
+      }
+      this._fields = {
+        ...this._fields,
+        ...(0, import_hash.removeEmptyFields)(fieldsOnly)
+      };
+    }
+    return this;
+  }
+  hashableFields() {
+    const schema = (0, import_assert.assertEx)(this._schema, "Payload: Missing Schema");
+    return {
+      ...(0, import_hash.removeEmptyFields)((0, import_hash.deepOmitPrefixedFields)(this._fields ?? {}, "_")),
+      schema
+    };
+  }
+  schema(value) {
+    this._schema = value;
+  }
+};
+__name(_PayloadBuilderBase, "PayloadBuilderBase");
+var PayloadBuilderBase = _PayloadBuilderBase;
+
+// src/Builder.ts
+var _PayloadBuilder = class _PayloadBuilder extends PayloadBuilderBase {
   static async build(payload) {
+    const { schema, $hash, $meta, ...fields } = payload;
     const builder = new _PayloadBuilder({
+      fields,
+      meta: $meta,
       schema: payload.schema
     });
-    builder.fields(payload);
     return await builder.build();
   }
+  static async dataHash(payload) {
+    return (await this.build(payload)).$hash;
+  }
   static async dataHashPairs(payloads) {
     return await Promise.all(payloads.map(async (payload) => {
       const built = await _PayloadBuilder.build(payload);
@@ -58,28 +106,34 @@ var _PayloadBuilder = class _PayloadBuilder {
     }));
   }
   static async dataHashes(payloads) {
-    return await Promise.all(payloads.map(async (payload) => {
+    return payloads ? await Promise.all(payloads.map(async (payload) => {
       const built = await _PayloadBuilder.build(payload);
       return built.$hash;
-    }));
+    })) : void 0;
   }
   static async filterExclude(payloads = [], hash) {
+    return await import_hash2.PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash);
+  }
+  static async filterExcludeByDataHash(payloads = [], hash) {
     var _a;
     const hashes = Array.isArray(hash) ? hash : [
       hash
     ];
-    return (_a = (await this.hashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
+    return (_a = (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
   }
-  static async filterInclude(payloads = [], hash) {
+  static async filterIncludeByDataHash(payloads = [], hash) {
     var _a;
     const hashes = Array.isArray(hash) ? hash : [
       hash
     ];
-    return (_a = (await this.hashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
+    return (_a = (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
   }
-  static async find(payloads = [], hash) {
+  static async findByDataHash(payloads = [], hash) {
     var _a;
-    return (_a = (await this.hashPairs(payloads)).find(([_, objHash]) => objHash === hash)) == null ? void 0 : _a[0];
+    return (_a = (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)) == null ? void 0 : _a[0];
+  }
+  static async hash(payload) {
+    return await import_hash2.PayloadHasher.hash(payload);
   }
   /**
   * Creates an array of payload/hash tuples based on the payloads passed in
@@ -91,10 +145,13 @@ var _PayloadBuilder = class _PayloadBuilder {
       const built = await _PayloadBuilder.build(payload);
       return [
         built,
-        await import_hash.PayloadHasher.hashAsync(built)
+        await _PayloadBuilder.hash(built)
       ];
     }));
   }
+  static async hashes(payloads) {
+    return await import_hash2.PayloadHasher.hashes(payloads);
+  }
   static async toDataHashMap(objs) {
     const result = {};
     for (const pair of await this.dataHashPairs(objs)) {
@@ -114,13 +171,9 @@ var _PayloadBuilder = class _PayloadBuilder {
     }
     return result;
   }
-  $meta(fields) {
-    this._$meta = fields;
-    return this;
-  }
   async build() {
-    const dataHashableFields = this.dataHashableFields();
-    const $hash = await import_hash.PayloadHasher.hashAsync(dataHashableFields);
+    const dataHashableFields = await this.dataHashableFields();
+    const $hash = await _PayloadBuilder.hash(dataHashableFields);
     const hashableFields = {
       ...dataHashableFields,
       $hash
@@ -130,26 +183,12 @@ var _PayloadBuilder = class _PayloadBuilder {
     }
     return hashableFields;
   }
-  dataHashableFields() {
-    return {
-      ...(0, import_hash.removeEmptyFields)((0, import_hash.deepOmitPrefixedFields)((0, import_hash.deepOmitPrefixedFields)(this._fields, "$"), "_")),
-      schema: (0, import_assert.assertEx)(this.schema, "Payload: Missing Schema")
-    };
-  }
-  fields(fields) {
-    if (fields) {
-      this._fields = {
-        ...this._fields,
-        ...(0, import_hash.removeEmptyFields)(fields)
-      };
-    }
-    return this;
-  }
 };
 __name(_PayloadBuilder, "PayloadBuilder");
 var PayloadBuilder = _PayloadBuilder;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  PayloadBuilder
+  PayloadBuilder,
+  PayloadBuilderBase
 });
 //# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts"],"sourcesContent":["export * from './Builder'\n","import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { JsonObject } from '@xylabs/object'\nimport { deepOmitPrefixedFields, PayloadHasher, removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nexport interface PayloadBuilderOptions<T> {\n  fields?: Partial<T>\n  meta?: JsonObject\n  schema: string\n}\n\nexport class PayloadBuilder<T extends Payload = Payload> {\n  private _$meta?: JsonObject\n  private _fields: Partial<T> = {}\n  private _schema: string\n\n  constructor({ schema, fields, meta }: PayloadBuilderOptions<T>) {\n    this._schema = schema\n    this._fields = fields ?? {}\n    this._$meta = meta\n  }\n\n  get schema() {\n    this._schema = this._schema ?? this._fields['schema']\n    return this._schema\n  }\n\n  static async build<T extends Payload>(payload: T) {\n    const builder = new PayloadBuilder<T>({ schema: payload.schema })\n    builder.fields(payload)\n    return await builder.build()\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[]): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes<T extends Payload>(payloads: T[]): Promise<Hash[]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload)\n        return built.$hash\n      }),\n    )\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.hashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterInclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.hashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async find<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.hashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\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[]): 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)\n        return [built, await PayloadHasher.hashAsync(built)]\n      }),\n    )\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, T>> {\n    const result: Record<Hash, 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, T>> {\n    const result: Record<Hash, T> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  $meta(fields?: JsonObject) {\n    this._$meta = fields\n    return this\n  }\n\n  async build(): Promise<WithMeta<T>> {\n    const dataHashableFields = this.dataHashableFields()\n    const $hash = await PayloadHasher.hashAsync(dataHashableFields)\n    const hashableFields: PayloadWithMeta = { ...dataHashableFields, $hash }\n\n    //only add $meta if it exists and has at least one field\n    if (this._$meta && Object.keys(this._$meta).length > 0) {\n      hashableFields['$meta'] = this._$meta\n    }\n    return hashableFields as WithMeta<T>\n  }\n\n  dataHashableFields() {\n    return {\n      ...removeEmptyFields(deepOmitPrefixedFields(deepOmitPrefixedFields(this._fields, '$'), '_')),\n      schema: assertEx(this.schema, 'Payload: Missing Schema'),\n    } as T\n  }\n\n  fields(fields?: Partial<T>) {\n    if (fields) {\n      this._fields = { ...this._fields, ...removeEmptyFields(fields) }\n    }\n    return this\n  }\n}\n"],"mappings":"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","names":["PayloadBuilder","_$meta","_fields","_schema","constructor","schema","fields","meta","build","payload","builder","dataHashPairs","payloads","Promise","all","map","built","$hash","dataHashes","filterExclude","hash","hashes","Array","isArray","hashPairs","filter","_","objHash","includes","pair","filterInclude","find","PayloadHasher","hashAsync","toDataHashMap","objs","result","toHashMap","$meta","dataHashableFields","hashableFields","Object","keys","length","removeEmptyFields","deepOmitPrefixedFields","assertEx"]}
+{"version":3,"sources":["../../src/index.ts","../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["export * from './Builder'\nexport * from './BuilderBase'\nexport * from './Options'\n","import { Hash } from '@xylabs/hex'\nimport { AnyObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase } from './BuilderBase'\nimport { PayloadBuilderOptions } from './Options'\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: T) {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { schema, $hash, $meta, ...fields } = payload as WithMeta<T>\n    const builder = new PayloadBuilder<T>({ fields: fields as T, meta: $meta, schema: payload.schema })\n    return await builder.build()\n  }\n\n  static async dataHash<T extends Payload>(payload: T): Promise<Hash> {\n    return (await this.build(payload)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[]): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload)\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): Promise<Hash> {\n    return await PayloadHasher.hash(payload)\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[]): 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)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\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 toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, T>> {\n    const result: Record<Hash, 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, T>> {\n    const result: Record<Hash, T> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  async build(): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    const $hash = await PayloadBuilder.hash(dataHashableFields)\n    const hashableFields: PayloadWithMeta = { ...dataHashableFields, $hash }\n\n    //only add $meta if it exists and has at least one field\n    if (this._$meta && Object.keys(this._$meta).length > 0) {\n      hashableFields['$meta'] = this._$meta\n    }\n    return hashableFields as WithMeta<T>\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { AnyObject, JsonObject } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { deepOmitPrefixedFields, removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options'\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: Omit<T, 'schema' | '$hash' | '$meta'>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = fields\n    this._$meta = 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(): Promise<T> {\n    return deepOmitPrefixedFields(await this.hashableFields(), '$')\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: Omit<WithMeta<T>, '$hash' | 'schema'> & Partial<Pick<WithMeta<T>, '$hash' | 'schema'>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields as WithMeta<T>\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = { ...this._fields, ...removeEmptyFields(fieldsOnly) }\n    }\n    return this\n  }\n\n  hashableFields(): Promisable<T> {\n    const schema = assertEx(this._schema, 'Payload: Missing Schema')\n    return {\n      ...removeEmptyFields(deepOmitPrefixedFields(this._fields ?? {}, '_')),\n      schema,\n    } as T\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n}\n"],"mappings":"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","names":["import_hash","PayloadBuilderBase","_$meta","_fields","_schema","constructor","options","schema","fields","meta","$meta","dataHashableFields","deepOmitPrefixedFields","hashableFields","$hash","fieldsOnly","removeEmptyFields","assertEx","value","PayloadBuilder","PayloadBuilderBase","build","payload","schema","$hash","$meta","fields","builder","meta","dataHash","dataHashPairs","payloads","Promise","all","map","built","dataHashes","undefined","filterExclude","hash","PayloadHasher","filterExcludeByHash","filterExcludeByDataHash","hashes","Array","isArray","filter","_","objHash","includes","pair","filterIncludeByDataHash","findByDataHash","find","hashPairs","toDataHashMap","objs","result","toHashMap","dataHashableFields","hashableFields","_$meta","Object","keys","length"]}

package/dist/node/index.d.cts

@@ -1,2 +1,4 @@
 export * from './Builder';
+export * from './BuilderBase';
+export * from './Options';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/dist/node/index.d.mts

@@ -1,2 +1,4 @@
 export * from './Builder';
+export * from './BuilderBase';
+export * from './Options';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/dist/node/index.d.ts

@@ -1,2 +1,4 @@
 export * from './Builder';
+export * from './BuilderBase';
+export * from './Options';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA"}

package/dist/node/index.js

@@ -2,28 +2,75 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/Builder.ts
+import { PayloadHasher } from "@xyo-network/hash";
+
+// src/BuilderBase.ts
 import { assertEx } from "@xylabs/assert";
-import { deepOmitPrefixedFields, PayloadHasher, removeEmptyFields } from "@xyo-network/hash";
-var _PayloadBuilder = class _PayloadBuilder {
+import { deepOmitPrefixedFields, removeEmptyFields } from "@xyo-network/hash";
+var _PayloadBuilderBase = class _PayloadBuilderBase {
+  options;
   _$meta;
-  _fields = {};
+  _fields;
   _schema;
-  constructor({ schema, fields, meta }) {
+  constructor(options) {
+    this.options = options;
+    const { schema, fields, meta } = options;
     this._schema = schema;
-    this._fields = fields ?? {};
+    this._fields = fields;
     this._$meta = meta;
   }
-  get schema() {
-    this._schema = this._schema ?? this._fields["schema"];
-    return this._schema;
+  $meta(meta) {
+    this._$meta = meta ?? this._fields.$meta;
+    return this;
+  }
+  async dataHashableFields() {
+    return deepOmitPrefixedFields(await this.hashableFields(), "$");
   }
+  //we do not require sending in $hash since it will be generated anyway
+  fields(fields) {
+    if (fields) {
+      const { $meta, $hash, schema, ...fieldsOnly } = fields;
+      if ($meta) {
+        this.$meta($meta);
+      }
+      if (schema) {
+        this.schema(schema);
+      }
+      this._fields = {
+        ...this._fields,
+        ...removeEmptyFields(fieldsOnly)
+      };
+    }
+    return this;
+  }
+  hashableFields() {
+    const schema = assertEx(this._schema, "Payload: Missing Schema");
+    return {
+      ...removeEmptyFields(deepOmitPrefixedFields(this._fields ?? {}, "_")),
+      schema
+    };
+  }
+  schema(value) {
+    this._schema = value;
+  }
+};
+__name(_PayloadBuilderBase, "PayloadBuilderBase");
+var PayloadBuilderBase = _PayloadBuilderBase;
+
+// src/Builder.ts
+var _PayloadBuilder = class _PayloadBuilder extends PayloadBuilderBase {
   static async build(payload) {
+    const { schema, $hash, $meta, ...fields } = payload;
     const builder = new _PayloadBuilder({
+      fields,
+      meta: $meta,
       schema: payload.schema
     });
-    builder.fields(payload);
     return await builder.build();
   }
+  static async dataHash(payload) {
+    return (await this.build(payload)).$hash;
+  }
   static async dataHashPairs(payloads) {
     return await Promise.all(payloads.map(async (payload) => {
       const built = await _PayloadBuilder.build(payload);
@@ -34,28 +81,34 @@ var _PayloadBuilder = class _PayloadBuilder {
     }));
   }
   static async dataHashes(payloads) {
-    return await Promise.all(payloads.map(async (payload) => {
+    return payloads ? await Promise.all(payloads.map(async (payload) => {
       const built = await _PayloadBuilder.build(payload);
       return built.$hash;
-    }));
+    })) : void 0;
   }
   static async filterExclude(payloads = [], hash) {
+    return await PayloadHasher.filterExcludeByHash(await this.filterExcludeByDataHash(payloads, hash), hash);
+  }
+  static async filterExcludeByDataHash(payloads = [], hash) {
     var _a;
     const hashes = Array.isArray(hash) ? hash : [
       hash
     ];
-    return (_a = (await this.hashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
+    return (_a = (await this.dataHashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
   }
-  static async filterInclude(payloads = [], hash) {
+  static async filterIncludeByDataHash(payloads = [], hash) {
     var _a;
     const hashes = Array.isArray(hash) ? hash : [
       hash
     ];
-    return (_a = (await this.hashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
+    return (_a = (await this.dataHashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))) == null ? void 0 : _a.map((pair) => pair[0]);
   }
-  static async find(payloads = [], hash) {
+  static async findByDataHash(payloads = [], hash) {
     var _a;
-    return (_a = (await this.hashPairs(payloads)).find(([_, objHash]) => objHash === hash)) == null ? void 0 : _a[0];
+    return (_a = (await this.dataHashPairs(payloads)).find(([_, objHash]) => objHash === hash)) == null ? void 0 : _a[0];
+  }
+  static async hash(payload) {
+    return await PayloadHasher.hash(payload);
   }
   /**
   * Creates an array of payload/hash tuples based on the payloads passed in
@@ -67,10 +120,13 @@ var _PayloadBuilder = class _PayloadBuilder {
       const built = await _PayloadBuilder.build(payload);
       return [
         built,
-        await PayloadHasher.hashAsync(built)
+        await _PayloadBuilder.hash(built)
       ];
     }));
   }
+  static async hashes(payloads) {
+    return await PayloadHasher.hashes(payloads);
+  }
   static async toDataHashMap(objs) {
     const result = {};
     for (const pair of await this.dataHashPairs(objs)) {
@@ -90,13 +146,9 @@ var _PayloadBuilder = class _PayloadBuilder {
     }
     return result;
   }
-  $meta(fields) {
-    this._$meta = fields;
-    return this;
-  }
   async build() {
-    const dataHashableFields = this.dataHashableFields();
-    const $hash = await PayloadHasher.hashAsync(dataHashableFields);
+    const dataHashableFields = await this.dataHashableFields();
+    const $hash = await _PayloadBuilder.hash(dataHashableFields);
     const hashableFields = {
       ...dataHashableFields,
       $hash
@@ -106,25 +158,11 @@ var _PayloadBuilder = class _PayloadBuilder {
     }
     return hashableFields;
   }
-  dataHashableFields() {
-    return {
-      ...removeEmptyFields(deepOmitPrefixedFields(deepOmitPrefixedFields(this._fields, "$"), "_")),
-      schema: assertEx(this.schema, "Payload: Missing Schema")
-    };
-  }
-  fields(fields) {
-    if (fields) {
-      this._fields = {
-        ...this._fields,
-        ...removeEmptyFields(fields)
-      };
-    }
-    return this;
-  }
 };
 __name(_PayloadBuilder, "PayloadBuilder");
 var PayloadBuilder = _PayloadBuilder;
 export {
-  PayloadBuilder
+  PayloadBuilder,
+  PayloadBuilderBase
 };
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Builder.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { Hash } from '@xylabs/hex'\nimport { JsonObject } from '@xylabs/object'\nimport { deepOmitPrefixedFields, PayloadHasher, removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nexport interface PayloadBuilderOptions<T> {\n  fields?: Partial<T>\n  meta?: JsonObject\n  schema: string\n}\n\nexport class PayloadBuilder<T extends Payload = Payload> {\n  private _$meta?: JsonObject\n  private _fields: Partial<T> = {}\n  private _schema: string\n\n  constructor({ schema, fields, meta }: PayloadBuilderOptions<T>) {\n    this._schema = schema\n    this._fields = fields ?? {}\n    this._$meta = meta\n  }\n\n  get schema() {\n    this._schema = this._schema ?? this._fields['schema']\n    return this._schema\n  }\n\n  static async build<T extends Payload>(payload: T) {\n    const builder = new PayloadBuilder<T>({ schema: payload.schema })\n    builder.fields(payload)\n    return await builder.build()\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[]): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes<T extends Payload>(payloads: T[]): Promise<Hash[]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload)\n        return built.$hash\n      }),\n    )\n  }\n\n  static async filterExclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.hashPairs(payloads)).filter(([_, objHash]) => !hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async filterInclude<T extends Payload>(payloads: T[] = [], hash: Hash[] | Hash): Promise<T[]> {\n    const hashes = Array.isArray(hash) ? hash : [hash]\n    return (await this.hashPairs(payloads)).filter(([_, objHash]) => hashes.includes(objHash))?.map((pair) => pair[0])\n  }\n\n  static async find<T extends Payload>(payloads: T[] = [], hash: Hash): Promise<T | undefined> {\n    return (await this.hashPairs(payloads)).find(([_, objHash]) => objHash === hash)?.[0]\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[]): 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)\n        return [built, await PayloadHasher.hashAsync(built)]\n      }),\n    )\n  }\n\n  static async toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, T>> {\n    const result: Record<Hash, 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, T>> {\n    const result: Record<Hash, T> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  $meta(fields?: JsonObject) {\n    this._$meta = fields\n    return this\n  }\n\n  async build(): Promise<WithMeta<T>> {\n    const dataHashableFields = this.dataHashableFields()\n    const $hash = await PayloadHasher.hashAsync(dataHashableFields)\n    const hashableFields: PayloadWithMeta = { ...dataHashableFields, $hash }\n\n    //only add $meta if it exists and has at least one field\n    if (this._$meta && Object.keys(this._$meta).length > 0) {\n      hashableFields['$meta'] = this._$meta\n    }\n    return hashableFields as WithMeta<T>\n  }\n\n  dataHashableFields() {\n    return {\n      ...removeEmptyFields(deepOmitPrefixedFields(deepOmitPrefixedFields(this._fields, '$'), '_')),\n      schema: assertEx(this.schema, 'Payload: Missing Schema'),\n    } as T\n  }\n\n  fields(fields?: Partial<T>) {\n    if (fields) {\n      this._fields = { ...this._fields, ...removeEmptyFields(fields) }\n    }\n    return this\n  }\n}\n"],"mappings":"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","names":["assertEx","deepOmitPrefixedFields","PayloadHasher","removeEmptyFields","PayloadBuilder","_$meta","_fields","_schema","constructor","schema","fields","meta","build","payload","builder","dataHashPairs","payloads","Promise","all","map","built","$hash","dataHashes","filterExclude","hash","hashes","Array","isArray","hashPairs","filter","_","objHash","includes","pair","filterInclude","find","PayloadHasher","hashAsync","toDataHashMap","objs","result","toHashMap","$meta","dataHashableFields","hashableFields","Object","keys","length","removeEmptyFields","deepOmitPrefixedFields","assertEx"]}
+{"version":3,"sources":["../../src/Builder.ts","../../src/BuilderBase.ts"],"sourcesContent":["import { Hash } from '@xylabs/hex'\nimport { AnyObject } from '@xylabs/object'\nimport { PayloadHasher } from '@xyo-network/hash'\nimport { Payload, PayloadWithMeta, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderBase } from './BuilderBase'\nimport { PayloadBuilderOptions } from './Options'\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: T) {\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { schema, $hash, $meta, ...fields } = payload as WithMeta<T>\n    const builder = new PayloadBuilder<T>({ fields: fields as T, meta: $meta, schema: payload.schema })\n    return await builder.build()\n  }\n\n  static async dataHash<T extends Payload>(payload: T): Promise<Hash> {\n    return (await this.build(payload)).$hash\n  }\n\n  static async dataHashPairs<T extends Payload>(payloads: T[]): Promise<[WithMeta<T>, Hash][]> {\n    return await Promise.all(\n      payloads.map(async (payload) => {\n        const built = await PayloadBuilder.build(payload)\n        return [built, built.$hash]\n      }),\n    )\n  }\n\n  static async dataHashes(payloads: undefined): Promise<undefined>\n  static async dataHashes<T extends Payload>(payloads: T[]): Promise<Hash[]>\n  static async dataHashes<T extends Payload>(payloads?: T[]): Promise<Hash[] | undefined> {\n    return payloads\n      ? await Promise.all(\n          payloads.map(async (payload) => {\n            const built = await PayloadBuilder.build(payload)\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): Promise<Hash> {\n    return await PayloadHasher.hash(payload)\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[]): 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)\n        return [built, await PayloadBuilder.hash(built)]\n      }),\n    )\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 toDataHashMap<T extends Payload>(objs: T[]): Promise<Record<Hash, T>> {\n    const result: Record<Hash, 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, T>> {\n    const result: Record<Hash, T> = {}\n    for (const pair of await this.hashPairs(objs)) {\n      result[pair[1]] = pair[0]\n    }\n    return result\n  }\n\n  async build(): Promise<WithMeta<T>> {\n    const dataHashableFields = await this.dataHashableFields()\n    const $hash = await PayloadBuilder.hash(dataHashableFields)\n    const hashableFields: PayloadWithMeta = { ...dataHashableFields, $hash }\n\n    //only add $meta if it exists and has at least one field\n    if (this._$meta && Object.keys(this._$meta).length > 0) {\n      hashableFields['$meta'] = this._$meta\n    }\n    return hashableFields as WithMeta<T>\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { AnyObject, JsonObject } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { deepOmitPrefixedFields, removeEmptyFields } from '@xyo-network/hash'\nimport { Payload, Schema, WithMeta } from '@xyo-network/payload-model'\n\nimport { PayloadBuilderOptions } from './Options'\n\nexport class PayloadBuilderBase<T extends Payload = Payload<AnyObject>, O extends PayloadBuilderOptions<T> = PayloadBuilderOptions<T>> {\n  protected _$meta?: JsonObject\n  protected _fields?: Omit<T, 'schema' | '$hash' | '$meta'>\n  protected _schema: Schema\n\n  constructor(readonly options: O) {\n    const { schema, fields, meta } = options\n    this._schema = schema\n    this._fields = fields\n    this._$meta = 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(): Promise<T> {\n    return deepOmitPrefixedFields(await this.hashableFields(), '$')\n  }\n\n  //we do not require sending in $hash since it will be generated anyway\n  fields(fields: Omit<WithMeta<T>, '$hash' | 'schema'> & Partial<Pick<WithMeta<T>, '$hash' | 'schema'>>) {\n    if (fields) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { $meta, $hash, schema, ...fieldsOnly } = fields as WithMeta<T>\n      if ($meta) {\n        this.$meta($meta)\n      }\n      if (schema) {\n        this.schema(schema)\n      }\n      this._fields = { ...this._fields, ...removeEmptyFields(fieldsOnly) }\n    }\n    return this\n  }\n\n  hashableFields(): Promisable<T> {\n    const schema = assertEx(this._schema, 'Payload: Missing Schema')\n    return {\n      ...removeEmptyFields(deepOmitPrefixedFields(this._fields ?? {}, '_')),\n      schema,\n    } as T\n  }\n\n  schema(value: Schema) {\n    this._schema = value\n  }\n}\n"],"mappings":"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","names":["PayloadHasher","assertEx","deepOmitPrefixedFields","removeEmptyFields","PayloadBuilderBase","_$meta","_fields","_schema","constructor","options","schema","fields","meta","$meta","dataHashableFields","deepOmitPrefixedFields","hashableFields","$hash","fieldsOnly","removeEmptyFields","assertEx","value","PayloadBuilder","PayloadBuilderBase","build","payload","schema","$hash","$meta","fields","builder","meta","dataHash","dataHashPairs","payloads","Promise","all","map","built","dataHashes","undefined","filterExclude","hash","PayloadHasher","filterExcludeByHash","filterExcludeByDataHash","hashes","Array","isArray","filter","_","objHash","includes","pair","filterIncludeByDataHash","findByDataHash","find","hashPairs","toDataHashMap","objs","result","toHashMap","dataHashableFields","hashableFields","_$meta","Object","keys","length"]}

package/package.json

@@ -10,11 +10,13 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
   },
   "dependencies": {
-    "@xylabs/assert": "^2.13.29",
-    "@xylabs/hex": "^2.13.29",
-    "@xylabs/object": "^2.88.5",
-    "@xyo-network/hash": "~2.89.0-rc.1",
-    "@xyo-network/payload-model": "~2.89.0-rc.1"
+    "@xylabs/assert": "^2.14.0",
+    "@xylabs/hex": "^2.14.0",
+    "@xylabs/logger": "^2.14.0",
+    "@xylabs/object": "^2.89.0",
+    "@xylabs/promise": "^2.14.0",
+    "@xyo-network/hash": "~2.89.0-rc.11",
+    "@xyo-network/payload-model": "~2.89.0-rc.11"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "^3.2.42",
@@ -60,7 +62,7 @@
   },
   "sideEffects": false,
   "types": "dist/node/index.d.ts",
-  "version": "2.89.0-rc.1",
+  "version": "2.89.0-rc.11",
   "type": "module",
   "stableVersion": "2.88.3"
 }