@xyo-network/payload-model 3.5.2 → 3.6.0-rc.10

package/dist/node/index.mjs

@@ -19,11 +19,8 @@ var asPayload = (schema) => AsObjectFactory.create((value) => isPayload(schema)(
 var isPayloadOfSchemaType = (schema) => {
   return (x) => isAnyPayload(x) && x?.schema === schema;
 };
-var isPayloadOfSchemaTypeWithMeta = (schema) => {
-  return (x) => isPayloadOfSchemaType(schema)(x) && x.$hash !== void 0;
-};
 var isPayloadOfSchemaTypeWithSources = (schema) => {
-  return (x) => isPayloadOfSchemaType(schema)(x) && x.sources !== void 0 && Array.isArray(x.sources);
+  return (x) => isPayloadOfSchemaType(schema)(x) && x.$sources !== void 0 && Array.isArray(x.$sources);
 };
 var notPayloadOfSchemaType = (schema) => {
   return (x) => !isAnyPayload(x) || x?.schema !== schema;
@@ -33,27 +30,6 @@ var notPayloadOfSchemaType = (schema) => {
 var ModuleErrorSchema = "network.xyo.error.module";
 var isModuleError = isPayloadOfSchemaType(ModuleErrorSchema);
 
-// src/isPayloadWithHash.ts
-var isWithHash = (value) => {
-  return typeof value?.$hash === "string";
-};
-var isPayloadWithHash = (value) => {
-  return isAnyPayload(value) && isWithHash(value);
-};
-
-// src/Meta.ts
-var unMeta = (payload) => {
-  if (payload) {
-    const {
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      $meta,
-      $hash,
-      ...result
-    } = payload;
-    return result;
-  }
-};
-
 // src/PayloadSet/PayloadSetSchema.ts
 var PayloadSetSchema = "network.xyo.payload.set";
 
@@ -64,23 +40,188 @@ var isSchema = (value) => {
   return typeof value === "string";
 };
 var asSchema = AsTypeFactory.create(isSchema);
+
+// src/StorageMeta/Sequence.ts
+import { isHex } from "@xylabs/hex";
+var isEpoch = (value) => {
+  return isHex(value) && value.length === SequenceConstants.epochBytes * 2;
+};
+var isNonce = (value) => {
+  return isHex(value) && value.length === SequenceConstants.nonceBytes * 2;
+};
+var isLocalSequence = (value) => {
+  return isHex(value) && value.length === SequenceConstants.localSequenceBytes * 2;
+};
+var isQualifiedSequence = (value) => {
+  return isHex(value) && value.length === SequenceConstants.qualifiedSequenceBytes * 2;
+};
+var isSequence = (value) => {
+  return isLocalSequence(value) || isQualifiedSequence(value);
+};
+var SequenceComponentLengths = {
+  epochBytes: 8,
+  nonceBytes: 8,
+  addressBytes: 20
+};
+var SequenceComponentMinMax = {
+  minEpoch: "0".repeat(SequenceComponentLengths.epochBytes * 2),
+  maxEpoch: "f".repeat(SequenceComponentLengths.epochBytes * 2),
+  minNonce: "0".repeat(SequenceComponentLengths.nonceBytes * 2),
+  maxNonce: "f".repeat(SequenceComponentLengths.nonceBytes * 2),
+  minAddress: "0".repeat(SequenceComponentLengths.addressBytes * 2),
+  maxAddress: "f".repeat(SequenceComponentLengths.addressBytes * 2)
+};
+var LocalSequenceConstants = {
+  ...SequenceComponentLengths,
+  ...SequenceComponentMinMax,
+  localSequenceBytes: SequenceComponentLengths.epochBytes + SequenceComponentLengths.nonceBytes,
+  minLocalSequence: SequenceComponentMinMax.minEpoch + SequenceComponentMinMax.minNonce,
+  maxLocalSequence: SequenceComponentMinMax.maxEpoch + SequenceComponentMinMax.maxNonce
+};
+var QualifiedSequenceConstants = {
+  qualifiedSequenceBytes: LocalSequenceConstants.localSequenceBytes + SequenceComponentLengths.addressBytes,
+  minLocalSequence: LocalSequenceConstants.minLocalSequence + SequenceComponentMinMax.minAddress,
+  maxLocalSequence: LocalSequenceConstants.maxLocalSequence + SequenceComponentMinMax.maxAddress
+};
+var SequenceConstants = {
+  ...LocalSequenceConstants,
+  ...QualifiedSequenceConstants
+};
+
+// src/StorageMeta/SequenceParser.ts
+import { toUint8Array } from "@xylabs/arraybuffer";
+import { assertEx } from "@xylabs/assert";
+import {
+  isAddress,
+  toHex
+} from "@xylabs/hex";
+var SequenceParser = class _SequenceParser {
+  static privateConstructorKey = Date.now().toString();
+  data;
+  constructor(privateConstructorKey, hex) {
+    assertEx(_SequenceParser.privateConstructorKey === privateConstructorKey, () => "Use create function instead of constructor");
+    const paddedHex = toHex(hex, {
+      prefix: false,
+      bitLength: hex.length <= SequenceConstants.localSequenceBytes * 2 ? SequenceConstants.localSequenceBytes * 8 : SequenceConstants.qualifiedSequenceBytes * 8
+    });
+    this.data = toUint8Array(paddedHex);
+  }
+  get address() {
+    const start = SequenceConstants.localSequenceBytes;
+    const end = SequenceConstants.qualifiedSequenceBytes;
+    return toHex(this.data.slice(start, end).buffer, { prefix: false });
+  }
+  get epoch() {
+    const start = 0;
+    const end = SequenceConstants.epochBytes;
+    return toHex(this.data.slice(start, end).buffer, { prefix: false });
+  }
+  get localSequence() {
+    const start = 0;
+    const end = SequenceConstants.localSequenceBytes;
+    return toHex(this.data.slice(start, end).buffer, { prefix: false });
+  }
+  get nonce() {
+    const start = SequenceConstants.epochBytes;
+    const end = SequenceConstants.localSequenceBytes;
+    return toHex(this.data.slice(start, end).buffer, { prefix: false });
+  }
+  get qualifiedSequence() {
+    const start = 0;
+    const end = SequenceConstants.qualifiedSequenceBytes;
+    return toHex(this.data.slice(start, end).buffer, { prefix: false });
+  }
+  static from(timestampOrSequence, nonceOrAddress, address) {
+    if (isSequence(timestampOrSequence)) {
+      if (nonceOrAddress) {
+        assertEx(!isQualifiedSequence(timestampOrSequence), () => "Providing both a qualified sequence and a address is not allowed");
+        assertEx(isAddress(nonceOrAddress), () => "Invalid address provided");
+        return new this(_SequenceParser.privateConstructorKey, timestampOrSequence + address);
+      }
+      return new this(_SequenceParser.privateConstructorKey, timestampOrSequence);
+    }
+    const epoch = _SequenceParser.toEpoch(timestampOrSequence);
+    const nonce = _SequenceParser.toNonce(nonceOrAddress);
+    const addressHex = address ? toHex(address, { bitLength: SequenceConstants.addressBytes * 8 }) : SequenceConstants.minAddress;
+    const hexString = epoch + nonce + addressHex;
+    assertEx(isSequence(hexString), () => `Invalid sequence [${hexString}] [${epoch}, ${nonce}, ${addressHex}]`);
+    return new this(_SequenceParser.privateConstructorKey, hexString);
+  }
+  static parse(value) {
+    const hex = toHex(value);
+    if (isSequence(hex)) {
+      return new this(_SequenceParser.privateConstructorKey, hex);
+    }
+    throw new Error(`Invalid sequence [${value}]`);
+  }
+  // can convert a short number/hex to an epoch (treats it as the whole value) or extract an epoch from a sequence
+  static toEpoch(value) {
+    assertEx(
+      typeof value !== "number" || Number.isInteger(value),
+      () => "Value must be in integer"
+    );
+    const hex = toHex(value, { prefix: false });
+    if (hex.length <= SequenceConstants.epochBytes * 2) {
+      return toHex(value, { prefix: false, bitLength: SequenceConstants.epochBytes * 8 });
+    }
+    if (isSequence(hex)) {
+      return hex.slice(0, SequenceConstants.epochBytes * 2);
+    }
+    throw new Error(`Value could not be converted to epoch [${hex}]`);
+  }
+  // can convert a short number/hex to a nonce (treats it as the whole value) or extract an nonce from a sequence
+  static toNonce(value) {
+    assertEx(
+      typeof value !== "number" || Number.isInteger(value),
+      () => "Value must be in integer"
+    );
+    const hex = toHex(value, { prefix: false });
+    if (isSequence(hex)) {
+      return hex.slice(SequenceConstants.epochBytes * 2, SequenceConstants.localSequenceBytes * 2);
+    }
+    const hash = toHex(hex, { prefix: false, bitLength: SequenceConstants.nonceBytes * 8 });
+    return hash.slice(-SequenceConstants.nonceBytes * 2);
+  }
+};
+
+// src/StorageMeta/StorageMeta.ts
+import { isHash } from "@xylabs/hex";
+var isSequenceMeta = (value) => {
+  return value?._sequence !== void 0;
+};
+var isHashMeta = (value) => {
+  return isHash(value?._hash) && isHash(value?._dataHash);
+};
+var isStorageMeta = (value) => {
+  return isSequenceMeta(value) && isHashMeta(value);
+};
 export {
+  LocalSequenceConstants,
   ModuleErrorSchema,
   PayloadSchema,
   PayloadSetSchema,
+  QualifiedSequenceConstants,
+  SequenceComponentLengths,
+  SequenceComponentMinMax,
+  SequenceConstants,
+  SequenceParser,
   asAnyPayload,
   asPayload,
   asSchema,
   isAnyPayload,
+  isEpoch,
+  isHashMeta,
+  isLocalSequence,
   isModuleError,
+  isNonce,
   isPayload,
   isPayloadOfSchemaType,
-  isPayloadOfSchemaTypeWithMeta,
   isPayloadOfSchemaTypeWithSources,
-  isPayloadWithHash,
+  isQualifiedSequence,
   isSchema,
-  isWithHash,
-  notPayloadOfSchemaType,
-  unMeta
+  isSequence,
+  isSequenceMeta,
+  isStorageMeta,
+  notPayloadOfSchemaType
 };
 //# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/isPayload.ts","../../src/isPayloadOfSchemaType.ts","../../src/Error.ts","../../src/isPayloadWithHash.ts","../../src/Meta.ts","../../src/PayloadSet/PayloadSetSchema.ts","../../src/Schema.ts"],"sourcesContent":["import { AsObjectFactory, isObject } from '@xylabs/object'\n\nimport type { Payload } from './Payload.ts'\n\nexport const isAnyPayload = (value: unknown): value is Payload => {\n  if (isObject(value)) {\n    return typeof value.schema === 'string'\n  }\n  return false\n}\n\nexport const asAnyPayload = AsObjectFactory.create(isAnyPayload)\n\nexport const isPayload\n  = <T extends Payload>(schema: string[]) =>\n    (value: unknown): value is T => {\n      if (isAnyPayload(value)) {\n        return schema.includes(value.schema)\n      }\n      return false\n    }\n\nexport const asPayload = <T extends Payload>(schema: string[]) => AsObjectFactory.create((value: unknown): value is T => isPayload(schema)(value))\n","import { isAnyPayload } from './isPayload.ts'\nimport type { WithMeta } from './Meta.ts'\nimport type { Payload, WithSources } from './Payload.ts'\n\nexport const isPayloadOfSchemaType = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is T => isAnyPayload(x) && x?.schema === schema\n}\n\nexport const isPayloadOfSchemaTypeWithMeta = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is WithMeta<T> => isPayloadOfSchemaType<WithMeta<T>>(schema)(x) && x.$hash !== undefined\n}\n\nexport const isPayloadOfSchemaTypeWithSources = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is WithSources<T> =>\n    isPayloadOfSchemaType<WithSources<T>>(schema)(x) && x.sources !== undefined && Array.isArray(x.sources)\n}\n\nexport const notPayloadOfSchemaType = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is T => !isAnyPayload(x) || x?.schema !== schema\n}\n\n// test types -- keep for future validation, but comment out\n\n/*\ntype TestSchema = 'network.xyo.test'\nconst TestSchema: TestSchema = 'network.xyo.test'\n\ntype Test = Payload<{ field: string }, TestSchema>\n\nconst testPayload: Test = { field: 'test', schema: TestSchema }\nconst testWithMeta: WithMeta<Test> = { $hash: '1234abcd', $meta: { timestamp: Date.now() }, field: 'test', schema: TestSchema }\n\nconst testPayloads: Payload[] = [testPayload]\nconst testMetaPayloads: WithMeta<Payload>[] = [testWithMeta]\n\nconst testType: Test = testWithMeta\n\nconst isTest: Test[] = testPayloads.filter(isPayloadOfSchemaType(TestSchema))\nconst isTestFromMeta: Payload[] = testMetaPayloads.filter(isPayloadOfSchemaType(TestSchema))\nconst isTestFromMetaWithMeta: PayloadWithMeta[] = testMetaPayloads.filter(isPayloadOfSchemaType(TestSchema))\n\nconst isTestFromMetaTyped = testMetaPayloads.filter(isPayloadOfSchemaType<Test>(TestSchema))\n\nconst isTestFromMetaTypedWithMeta: WithMeta<Test>[] = testMetaPayloads.filter(isPayloadOfSchemaType(TestSchema))\n\nconst isTestWithMeta: WithMeta<Test>[] = testPayloads.filter(isPayloadOfSchemaTypeWithMeta(TestSchema))\nconst isTestWithMetaFromMeta: WithMeta<Test>[] = testMetaPayloads.filter(isPayloadOfSchemaTypeWithMeta(TestSchema))\n*/\n","import type { Hash } from '@xylabs/hex'\nimport type { JsonValue } from '@xylabs/object'\n\nimport { isPayloadOfSchemaType } from './isPayloadOfSchemaType.ts'\nimport type { Payload } from './Payload.ts'\n\nexport type ModuleErrorSchema = 'network.xyo.error.module'\nexport const ModuleErrorSchema: ModuleErrorSchema = 'network.xyo.error.module'\n\nexport type ModuleError = Payload<{\n  details?: JsonValue\n  message?: string\n  name?: string\n  query?: Hash\n  schema: ModuleErrorSchema\n  sources?: Hash[]\n}>\n\nexport const isModuleError = isPayloadOfSchemaType<ModuleError>(ModuleErrorSchema)\n","import { isAnyPayload } from './isPayload.ts'\nimport type { WithMeta } from './Meta.ts'\nimport type { Payload } from './Payload.ts'\n\n/**\n * Return true if the value is a payload with the required meta fields\n * @param value The value to check\n * @returns True if the value is a payload with the required meta fields\n */\nexport const isWithHash = <T extends Payload>(value: T): value is WithMeta<T> => {\n  return typeof (value as WithMeta<T>)?.$hash === 'string'\n}\n\n/**\n * Return true if the value is a payload with the required meta fields\n * @param value The value to check\n * @returns True if the value is a payload with the required meta fields\n */\nexport const isPayloadWithHash = <T extends Payload>(value: unknown): value is WithMeta<T> => {\n  return isAnyPayload(value) && isWithHash(value)\n}\n","import type { EmptyObject, JsonObject } from '@xylabs/object'\n\nimport type { Payload, PayloadMetaFields } from './Payload.ts'\nimport type { Schema, WithSchema } from './Schema.ts'\n\nexport type WithMeta<T extends Payload = Payload, M extends JsonObject | void = void> = PayloadMetaFields<M> & T\nexport type WithOptionalMeta<T extends Payload = Payload, M extends JsonObject | void = void> = Partial<WithMeta<T, M>> &\n  Omit<WithMeta<T, M>, '$hash'>\n\nexport type PayloadWithMeta<T extends void | EmptyObject | WithSchema = void, S extends Schema | void = void> = WithMeta<Payload<T, S>>\n\nexport const unMeta = <T extends WithMeta<Payload>>(payload?: T): T | undefined => {\n  if (payload) {\n    const {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      $meta, $hash, ...result\n    } = payload\n    return result as T\n  }\n}\n","export type PayloadSetSchema = 'network.xyo.payload.set'\nexport const PayloadSetSchema: PayloadSetSchema = 'network.xyo.payload.set'\n","import type { EmptyObject } from '@xylabs/object'\nimport { AsTypeFactory } from '@xylabs/object'\n\n/** Schema type in Javascript is a string */\nexport type Schema = string\n\nexport const PayloadSchema = 'network.xyo.payload' as const\nexport type PayloadSchema = typeof PayloadSchema\n\nexport const isSchema = (value: unknown): value is Schema => {\n  return typeof value === 'string'\n}\n\nexport const asSchema = AsTypeFactory.create<Schema>(isSchema)\n\n/** Schema fields for a Payload */\nexport interface SchemaFields extends EmptyObject {\n  /**  Schema of the object */\n  schema: Schema\n}\n\n/** Add the Schema Fields to an object */\nexport type WithSchema<T extends EmptyObject | void = void> = T extends EmptyObject ? SchemaFields & T : SchemaFields\n"],"mappings":";AAAA,SAAS,iBAAiB,gBAAgB;AAInC,IAAM,eAAe,CAAC,UAAqC;AAChE,MAAI,SAAS,KAAK,GAAG;AACnB,WAAO,OAAO,MAAM,WAAW;AAAA,EACjC;AACA,SAAO;AACT;AAEO,IAAM,eAAe,gBAAgB,OAAO,YAAY;AAExD,IAAM,YACT,CAAoB,WACpB,CAAC,UAA+B;AAC9B,MAAI,aAAa,KAAK,GAAG;AACvB,WAAO,OAAO,SAAS,MAAM,MAAM;AAAA,EACrC;AACA,SAAO;AACT;AAEG,IAAM,YAAY,CAAoB,WAAqB,gBAAgB,OAAO,CAAC,UAA+B,UAAU,MAAM,EAAE,KAAK,CAAC;;;AClB1I,IAAM,wBAAwB,CAAoB,WAAmB;AAC1E,SAAO,CAAC,MAA+B,aAAa,CAAC,KAAK,GAAG,WAAW;AAC1E;AAEO,IAAM,gCAAgC,CAAoB,WAAmB;AAClF,SAAO,CAAC,MAAyC,sBAAmC,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU;AAChH;AAEO,IAAM,mCAAmC,CAAoB,WAAmB;AACrF,SAAO,CAAC,MACN,sBAAsC,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,UAAa,MAAM,QAAQ,EAAE,OAAO;AAC1G;AAEO,IAAM,yBAAyB,CAAoB,WAAmB;AAC3E,SAAO,CAAC,MAA+B,CAAC,aAAa,CAAC,KAAK,GAAG,WAAW;AAC3E;;;ACZO,IAAM,oBAAuC;AAW7C,IAAM,gBAAgB,sBAAmC,iBAAiB;;;ACT1E,IAAM,aAAa,CAAoB,UAAmC;AAC/E,SAAO,OAAQ,OAAuB,UAAU;AAClD;AAOO,IAAM,oBAAoB,CAAoB,UAAyC;AAC5F,SAAO,aAAa,KAAK,KAAK,WAAW,KAAK;AAChD;;;ACTO,IAAM,SAAS,CAA8B,YAA+B;AACjF,MAAI,SAAS;AACX,UAAM;AAAA;AAAA,MAEJ;AAAA,MAAO;AAAA,MAAO,GAAG;AAAA,IACnB,IAAI;AACJ,WAAO;AAAA,EACT;AACF;;;AClBO,IAAM,mBAAqC;;;ACAlD,SAAS,qBAAqB;AAKvB,IAAM,gBAAgB;AAGtB,IAAM,WAAW,CAAC,UAAoC;AAC3D,SAAO,OAAO,UAAU;AAC1B;AAEO,IAAM,WAAW,cAAc,OAAe,QAAQ;","names":[]}
+{"version":3,"sources":["../../src/isPayload.ts","../../src/isPayloadOfSchemaType.ts","../../src/Error.ts","../../src/PayloadSet/PayloadSetSchema.ts","../../src/Schema.ts","../../src/StorageMeta/Sequence.ts","../../src/StorageMeta/SequenceParser.ts","../../src/StorageMeta/StorageMeta.ts"],"sourcesContent":["import { AsObjectFactory, isObject } from '@xylabs/object'\n\nimport type { Payload } from './Payload.ts'\n\nexport const isAnyPayload = (value: unknown): value is Payload => {\n  if (isObject(value)) {\n    return typeof value.schema === 'string'\n  }\n  return false\n}\n\nexport const asAnyPayload = AsObjectFactory.create(isAnyPayload)\n\nexport const isPayload\n  = <T extends Payload>(schema: string[]) =>\n    (value: unknown): value is T => {\n      if (isAnyPayload(value)) {\n        return schema.includes(value.schema)\n      }\n      return false\n    }\n\nexport const asPayload = <T extends Payload>(schema: string[]) => AsObjectFactory.create((value: unknown): value is T => isPayload(schema)(value))\n","import { isAnyPayload } from './isPayload.ts'\nimport type { Payload, WithSources } from './Payload.ts'\n\nexport const isPayloadOfSchemaType = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is T => isAnyPayload(x) && x?.schema === schema\n}\n\nexport const isPayloadOfSchemaTypeWithSources = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is WithSources<T> =>\n    isPayloadOfSchemaType<WithSources<T>>(schema)(x) && x.$sources !== undefined && Array.isArray(x.$sources)\n}\n\nexport const notPayloadOfSchemaType = <T extends Payload>(schema: string) => {\n  return (x?: unknown | null): x is T => !isAnyPayload(x) || x?.schema !== schema\n}\n\n// test types -- keep for future validation, but comment out\n\n/*\ntype TestSchema = 'network.xyo.test'\nconst TestSchema: TestSchema = 'network.xyo.test'\n\ntype Test = Payload<{ field: string }, TestSchema>\n\nconst testPayload: Test = { field: 'test', schema: TestSchema }\n\nconst testPayloads: Payload[] = [testPayload]\n\nconst isTest: Test[] = testPayloads.filter(isPayloadOfSchemaType(TestSchema))\n\nconst isTestFromMetaTyped = testMetaPayloads.filter(isPayloadOfSchemaType<Test>(TestSchema))\n*/\n","import type { Hash } from '@xylabs/hex'\nimport type { JsonValue } from '@xylabs/object'\n\nimport { isPayloadOfSchemaType } from './isPayloadOfSchemaType.ts'\nimport type { Payload } from './Payload.ts'\n\nexport type ModuleErrorSchema = 'network.xyo.error.module'\nexport const ModuleErrorSchema: ModuleErrorSchema = 'network.xyo.error.module'\n\nexport type ModuleError = Payload<{\n  details?: JsonValue\n  message?: string\n  name?: string\n  query?: Hash\n  schema: ModuleErrorSchema\n}>\n\nexport const isModuleError = isPayloadOfSchemaType<ModuleError>(ModuleErrorSchema)\n","export type PayloadSetSchema = 'network.xyo.payload.set'\nexport const PayloadSetSchema: PayloadSetSchema = 'network.xyo.payload.set'\n","import type { EmptyObject } from '@xylabs/object'\nimport { AsTypeFactory } from '@xylabs/object'\n\n/** Schema type in Javascript is a string */\nexport type Schema = string\n\nexport const PayloadSchema = 'network.xyo.payload' as const\nexport type PayloadSchema = typeof PayloadSchema\n\nexport const isSchema = (value: unknown): value is Schema => {\n  return typeof value === 'string'\n}\n\nexport const asSchema = AsTypeFactory.create<Schema>(isSchema)\n\n/** Schema fields for a Payload */\nexport interface SchemaFields extends EmptyObject {\n  /**  Schema of the object */\n  schema: Schema\n}\n\n/** Add the Schema Fields to an object */\nexport type WithSchema<T extends EmptyObject | void = void> = T extends EmptyObject ? SchemaFields & T : SchemaFields\n","import type { Address, Hex } from '@xylabs/hex'\nimport { isHex } from '@xylabs/hex'\n\n// we use Exclude to intentionally make the type not equal to string\nexport type LocalSequence = Hex & Exclude<string, 'reserved-local-sequence-value'>\nexport type QualifiedSequence = Hex & Exclude<string, 'reserved-qualified-sequence-value'>\nexport type Sequence = LocalSequence | QualifiedSequence\n\nexport type Epoch = Hex & Exclude<string, 'reserved-epoch-sequence-value'>\n\nexport const isEpoch = (value: unknown): value is Epoch => {\n  return isHex(value) && (value as string).length === SequenceConstants.epochBytes * 2\n}\n\nexport type Nonce = Hex & Exclude<string, 'reserved-nonce-sequence-value'>\n\nexport const isNonce = (value: unknown): value is Epoch => {\n  return isHex(value) && (value as string).length === SequenceConstants.nonceBytes * 2\n}\n\nexport const isLocalSequence = (value: unknown): value is Sequence => {\n  return isHex(value) && (value as string).length === SequenceConstants.localSequenceBytes * 2\n}\n\nexport const isQualifiedSequence = (value: unknown): value is Sequence => {\n  return isHex(value) && (value as string).length === SequenceConstants.qualifiedSequenceBytes * 2\n}\n\nexport const isSequence = (value: unknown): value is Sequence => {\n  return isLocalSequence(value) || isQualifiedSequence(value)\n}\n\nexport const SequenceComponentLengths = {\n  epochBytes: 8,\n  nonceBytes: 8,\n  addressBytes: 20,\n}\n\nexport const SequenceComponentMinMax = {\n  minEpoch: '0'.repeat(SequenceComponentLengths.epochBytes * 2) as Epoch,\n  maxEpoch: 'f'.repeat(SequenceComponentLengths.epochBytes * 2) as Epoch,\n  minNonce: '0'.repeat(SequenceComponentLengths.nonceBytes * 2) as Nonce,\n  maxNonce: 'f'.repeat(SequenceComponentLengths.nonceBytes * 2) as Nonce,\n  minAddress: '0'.repeat(SequenceComponentLengths.addressBytes * 2) as Address,\n  maxAddress: 'f'.repeat(SequenceComponentLengths.addressBytes * 2) as Address,\n}\n\nexport const LocalSequenceConstants = {\n  ...SequenceComponentLengths,\n  ...SequenceComponentMinMax,\n  localSequenceBytes: SequenceComponentLengths.epochBytes + SequenceComponentLengths.nonceBytes,\n  minLocalSequence: SequenceComponentMinMax.minEpoch + SequenceComponentMinMax.minNonce as LocalSequence,\n  maxLocalSequence: SequenceComponentMinMax.maxEpoch + SequenceComponentMinMax.maxNonce as LocalSequence,\n}\n\nexport const QualifiedSequenceConstants = {\n  qualifiedSequenceBytes: LocalSequenceConstants.localSequenceBytes + SequenceComponentLengths.addressBytes,\n  minLocalSequence: LocalSequenceConstants.minLocalSequence + SequenceComponentMinMax.minAddress as QualifiedSequence,\n  maxLocalSequence: LocalSequenceConstants.maxLocalSequence + SequenceComponentMinMax.maxAddress as QualifiedSequence,\n}\n\nexport const SequenceConstants = {\n  ...LocalSequenceConstants,\n  ...QualifiedSequenceConstants,\n}\n\n// \"11111111111111112222222222222222\" is and example of a local sequence string\n\n// \"111111111111111122222222222222223333333333333333333333333333333333333333\" is and example of a local sequence string\n// epoch = \"1111111111111111\"\n// nonce = \"2222222222222222\"\n// address = \"3333333333333333333333333333333333333333\"\n","import { toUint8Array } from '@xylabs/arraybuffer'\nimport { assertEx } from '@xylabs/assert'\nimport {\n  type Address,\n  type Hash, type Hex,\n  isAddress,\n  toHex,\n} from '@xylabs/hex'\n\nimport type {\n  Epoch, LocalSequence, Nonce, QualifiedSequence,\n  Sequence,\n} from './Sequence.ts'\nimport {\n  isQualifiedSequence, isSequence, SequenceConstants,\n} from './Sequence.ts'\n\nexport class SequenceParser {\n  protected static privateConstructorKey = Date.now().toString()\n\n  private readonly data: Readonly<Uint8Array>\n\n  protected constructor(privateConstructorKey: string, hex: Hex) {\n    assertEx(SequenceParser.privateConstructorKey === privateConstructorKey, () => 'Use create function instead of constructor')\n    const paddedHex = toHex(hex, {\n      prefix: false,\n      bitLength: (hex.length <= SequenceConstants.localSequenceBytes * 2)\n        ? SequenceConstants.localSequenceBytes * 8\n        : SequenceConstants.qualifiedSequenceBytes * 8,\n    })\n    this.data = toUint8Array(paddedHex)\n  }\n\n  get address(): Address {\n    const start = SequenceConstants.localSequenceBytes\n    const end = SequenceConstants.qualifiedSequenceBytes\n    return toHex(this.data.slice(start, end).buffer, { prefix: false })\n  }\n\n  get epoch(): Epoch {\n    const start = 0\n    const end = SequenceConstants.epochBytes\n    return toHex(this.data.slice(start, end).buffer, { prefix: false })\n  }\n\n  get localSequence(): LocalSequence {\n    const start = 0\n    const end = SequenceConstants.localSequenceBytes\n    return toHex(this.data.slice(start, end).buffer, { prefix: false })\n  }\n\n  get nonce(): Nonce {\n    const start = SequenceConstants.epochBytes\n    const end = SequenceConstants.localSequenceBytes\n    return toHex(this.data.slice(start, end).buffer, { prefix: false })\n  }\n\n  get qualifiedSequence(): QualifiedSequence {\n    const start = 0\n    const end = SequenceConstants.qualifiedSequenceBytes\n    return toHex(this.data.slice(start, end).buffer, { prefix: false })\n  }\n\n  static from(sequence: Sequence, address?: Address): SequenceParser\n  static from(timestamp: Hex, hash: Hash, address?: Address): SequenceParser\n  static from(timestamp: Hex, hash: Hex, address?: Address): SequenceParser\n  static from(timestamp: Hex, nonce: Nonce, address?: Address): SequenceParser\n  static from(timestamp: number, hash: Hash, address?: Address): SequenceParser\n  static from(timestamp: number, hash: Hex, address?: Address): SequenceParser\n  static from(timestamp: number, nonce: Nonce, address?: Address): SequenceParser\n  static from(timestampOrSequence: Sequence | Hex | number, nonceOrAddress: Hash | Nonce, address?: Address): SequenceParser {\n    if (isSequence(timestampOrSequence)) {\n      if (nonceOrAddress) {\n        assertEx(!isQualifiedSequence(timestampOrSequence), () => 'Providing both a qualified sequence and a address is not allowed')\n        assertEx(isAddress(nonceOrAddress), () => 'Invalid address provided')\n        return new this(SequenceParser.privateConstructorKey, (timestampOrSequence + address) as Hex)\n      }\n      return new this(SequenceParser.privateConstructorKey, timestampOrSequence)\n    }\n    const epoch = SequenceParser.toEpoch(timestampOrSequence)\n    const nonce = SequenceParser.toNonce(nonceOrAddress)\n    const addressHex: Hex = address ? toHex(address, { bitLength: SequenceConstants.addressBytes * 8 }) : SequenceConstants.minAddress\n    const hexString = (epoch + nonce + addressHex) as Hex\n    assertEx(isSequence(hexString), () => `Invalid sequence [${hexString}] [${epoch}, ${nonce}, ${addressHex}]`)\n    return new this(SequenceParser.privateConstructorKey, hexString)\n  }\n\n  static parse(value: Hex | string | ArrayBufferLike): SequenceParser {\n    const hex = toHex(value)\n    if (isSequence(hex)) {\n      return new this(SequenceParser.privateConstructorKey, hex)\n    }\n    throw new Error(`Invalid sequence [${value}]`)\n  }\n\n  // can convert a short number/hex to an epoch (treats it as the whole value) or extract an epoch from a sequence\n  static toEpoch(value: number | Hex | Epoch): Epoch {\n    assertEx(\n      typeof value !== 'number' || Number.isInteger(value),\n      () => 'Value must be in integer',\n    )\n    const hex = toHex(value, { prefix: false })\n    if (hex.length <= SequenceConstants.epochBytes * 2) {\n      return toHex(value, { prefix: false, bitLength: SequenceConstants.epochBytes * 8 }) as Epoch\n    }\n    if (isSequence(hex)) {\n      return hex.slice(0, SequenceConstants.epochBytes * 2) as Epoch\n    }\n    throw new Error(`Value could not be converted to epoch [${hex}]`)\n  }\n\n  // can convert a short number/hex to a nonce (treats it as the whole value) or extract an nonce from a sequence\n  static toNonce(value: Hash | Hex): Nonce {\n    assertEx(\n      typeof value !== 'number' || Number.isInteger(value),\n      () => 'Value must be in integer',\n    )\n    const hex = toHex(value, { prefix: false })\n    if (isSequence(hex)) {\n      return hex.slice(SequenceConstants.epochBytes * 2, SequenceConstants.localSequenceBytes * 2) as Nonce\n    }\n    const hash = toHex((hex as string), { prefix: false, bitLength: SequenceConstants.nonceBytes * 8 })\n    return hash.slice(-SequenceConstants.nonceBytes * 2) as Nonce\n  }\n}\n","import { type Hash, isHash } from '@xylabs/hex'\n\nimport type { Payload } from '../Payload.ts'\nimport type { Sequence } from './Sequence.ts'\n\nexport interface SequenceMeta {\n  _sequence: Sequence\n}\n\nexport type WithPartialSequenceMeta<T extends Payload = Payload> = Partial<WithSequenceMeta<T>>\n\nexport type WithSequenceMeta<T extends Payload = Payload> = T & SequenceMeta\n\nexport interface HashMeta {\n  _dataHash: Hash\n  _hash: Hash\n}\n\nexport type WithPartialHashMeta<T extends Payload = Payload> = Partial<WithHashMeta<T>>\n\nexport type WithHashMeta<T extends Payload = Payload> = T & HashMeta\n\nexport interface StorageMeta extends SequenceMeta, HashMeta {}\n\nexport type WithPartialStorageMeta<T extends Payload = Payload> = Partial<WithStorageMeta<T>>\n\nexport type WithStorageMeta<T extends Payload = Payload> = T & StorageMeta\n\nexport const isSequenceMeta = (value: unknown): value is SequenceMeta => {\n  return (value as WithSequenceMeta)?._sequence !== undefined\n}\n\nexport const isHashMeta = (value: unknown): value is HashMeta => {\n  return isHash((value as WithHashMeta)?._hash) && isHash((value as WithHashMeta)?._dataHash)\n}\n\nexport const isStorageMeta = (value: unknown): value is StorageMeta => {\n  return isSequenceMeta(value) && isHashMeta(value)\n}\n\n// \"00005a7f354762f3ac1bc5ddc6cfd08d14\" is and example of a local sequence string\n\n// \"00005a7f354762f3ac1bc5ddc6cfd08d14a123456789abcdef0123\" is and example of a local sequence string\n// epoch = \"00005a7f354762f3ac\"\n// nonce = \"1bc5ddc6cfd08d14\"\n// address = \"a123456789abcdef0123\"\n"],"mappings":";AAAA,SAAS,iBAAiB,gBAAgB;AAInC,IAAM,eAAe,CAAC,UAAqC;AAChE,MAAI,SAAS,KAAK,GAAG;AACnB,WAAO,OAAO,MAAM,WAAW;AAAA,EACjC;AACA,SAAO;AACT;AAEO,IAAM,eAAe,gBAAgB,OAAO,YAAY;AAExD,IAAM,YACT,CAAoB,WACpB,CAAC,UAA+B;AAC9B,MAAI,aAAa,KAAK,GAAG;AACvB,WAAO,OAAO,SAAS,MAAM,MAAM;AAAA,EACrC;AACA,SAAO;AACT;AAEG,IAAM,YAAY,CAAoB,WAAqB,gBAAgB,OAAO,CAAC,UAA+B,UAAU,MAAM,EAAE,KAAK,CAAC;;;ACnB1I,IAAM,wBAAwB,CAAoB,WAAmB;AAC1E,SAAO,CAAC,MAA+B,aAAa,CAAC,KAAK,GAAG,WAAW;AAC1E;AAEO,IAAM,mCAAmC,CAAoB,WAAmB;AACrF,SAAO,CAAC,MACN,sBAAsC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,UAAa,MAAM,QAAQ,EAAE,QAAQ;AAC5G;AAEO,IAAM,yBAAyB,CAAoB,WAAmB;AAC3E,SAAO,CAAC,MAA+B,CAAC,aAAa,CAAC,KAAK,GAAG,WAAW;AAC3E;;;ACPO,IAAM,oBAAuC;AAU7C,IAAM,gBAAgB,sBAAmC,iBAAiB;;;AChB1E,IAAM,mBAAqC;;;ACAlD,SAAS,qBAAqB;AAKvB,IAAM,gBAAgB;AAGtB,IAAM,WAAW,CAAC,UAAoC;AAC3D,SAAO,OAAO,UAAU;AAC1B;AAEO,IAAM,WAAW,cAAc,OAAe,QAAQ;;;ACZ7D,SAAS,aAAa;AASf,IAAM,UAAU,CAAC,UAAmC;AACzD,SAAO,MAAM,KAAK,KAAM,MAAiB,WAAW,kBAAkB,aAAa;AACrF;AAIO,IAAM,UAAU,CAAC,UAAmC;AACzD,SAAO,MAAM,KAAK,KAAM,MAAiB,WAAW,kBAAkB,aAAa;AACrF;AAEO,IAAM,kBAAkB,CAAC,UAAsC;AACpE,SAAO,MAAM,KAAK,KAAM,MAAiB,WAAW,kBAAkB,qBAAqB;AAC7F;AAEO,IAAM,sBAAsB,CAAC,UAAsC;AACxE,SAAO,MAAM,KAAK,KAAM,MAAiB,WAAW,kBAAkB,yBAAyB;AACjG;AAEO,IAAM,aAAa,CAAC,UAAsC;AAC/D,SAAO,gBAAgB,KAAK,KAAK,oBAAoB,KAAK;AAC5D;AAEO,IAAM,2BAA2B;AAAA,EACtC,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,cAAc;AAChB;AAEO,IAAM,0BAA0B;AAAA,EACrC,UAAU,IAAI,OAAO,yBAAyB,aAAa,CAAC;AAAA,EAC5D,UAAU,IAAI,OAAO,yBAAyB,aAAa,CAAC;AAAA,EAC5D,UAAU,IAAI,OAAO,yBAAyB,aAAa,CAAC;AAAA,EAC5D,UAAU,IAAI,OAAO,yBAAyB,aAAa,CAAC;AAAA,EAC5D,YAAY,IAAI,OAAO,yBAAyB,eAAe,CAAC;AAAA,EAChE,YAAY,IAAI,OAAO,yBAAyB,eAAe,CAAC;AAClE;AAEO,IAAM,yBAAyB;AAAA,EACpC,GAAG;AAAA,EACH,GAAG;AAAA,EACH,oBAAoB,yBAAyB,aAAa,yBAAyB;AAAA,EACnF,kBAAkB,wBAAwB,WAAW,wBAAwB;AAAA,EAC7E,kBAAkB,wBAAwB,WAAW,wBAAwB;AAC/E;AAEO,IAAM,6BAA6B;AAAA,EACxC,wBAAwB,uBAAuB,qBAAqB,yBAAyB;AAAA,EAC7F,kBAAkB,uBAAuB,mBAAmB,wBAAwB;AAAA,EACpF,kBAAkB,uBAAuB,mBAAmB,wBAAwB;AACtF;AAEO,IAAM,oBAAoB;AAAA,EAC/B,GAAG;AAAA,EACH,GAAG;AACL;;;AChEA,SAAS,oBAAoB;AAC7B,SAAS,gBAAgB;AACzB;AAAA,EAGE;AAAA,EACA;AAAA,OACK;AAUA,IAAM,iBAAN,MAAM,gBAAe;AAAA,EAC1B,OAAiB,wBAAwB,KAAK,IAAI,EAAE,SAAS;AAAA,EAE5C;AAAA,EAEP,YAAY,uBAA+B,KAAU;AAC7D,aAAS,gBAAe,0BAA0B,uBAAuB,MAAM,4CAA4C;AAC3H,UAAM,YAAY,MAAM,KAAK;AAAA,MAC3B,QAAQ;AAAA,MACR,WAAY,IAAI,UAAU,kBAAkB,qBAAqB,IAC7D,kBAAkB,qBAAqB,IACvC,kBAAkB,yBAAyB;AAAA,IACjD,CAAC;AACD,SAAK,OAAO,aAAa,SAAS;AAAA,EACpC;AAAA,EAEA,IAAI,UAAmB;AACrB,UAAM,QAAQ,kBAAkB;AAChC,UAAM,MAAM,kBAAkB;AAC9B,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC;AAAA,EACpE;AAAA,EAEA,IAAI,QAAe;AACjB,UAAM,QAAQ;AACd,UAAM,MAAM,kBAAkB;AAC9B,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC;AAAA,EACpE;AAAA,EAEA,IAAI,gBAA+B;AACjC,UAAM,QAAQ;AACd,UAAM,MAAM,kBAAkB;AAC9B,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC;AAAA,EACpE;AAAA,EAEA,IAAI,QAAe;AACjB,UAAM,QAAQ,kBAAkB;AAChC,UAAM,MAAM,kBAAkB;AAC9B,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC;AAAA,EACpE;AAAA,EAEA,IAAI,oBAAuC;AACzC,UAAM,QAAQ;AACd,UAAM,MAAM,kBAAkB;AAC9B,WAAO,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC;AAAA,EACpE;AAAA,EASA,OAAO,KAAK,qBAA8C,gBAA8B,SAAmC;AACzH,QAAI,WAAW,mBAAmB,GAAG;AACnC,UAAI,gBAAgB;AAClB,iBAAS,CAAC,oBAAoB,mBAAmB,GAAG,MAAM,kEAAkE;AAC5H,iBAAS,UAAU,cAAc,GAAG,MAAM,0BAA0B;AACpE,eAAO,IAAI,KAAK,gBAAe,uBAAwB,sBAAsB,OAAe;AAAA,MAC9F;AACA,aAAO,IAAI,KAAK,gBAAe,uBAAuB,mBAAmB;AAAA,IAC3E;AACA,UAAM,QAAQ,gBAAe,QAAQ,mBAAmB;AACxD,UAAM,QAAQ,gBAAe,QAAQ,cAAc;AACnD,UAAM,aAAkB,UAAU,MAAM,SAAS,EAAE,WAAW,kBAAkB,eAAe,EAAE,CAAC,IAAI,kBAAkB;AACxH,UAAM,YAAa,QAAQ,QAAQ;AACnC,aAAS,WAAW,SAAS,GAAG,MAAM,qBAAqB,SAAS,MAAM,KAAK,KAAK,KAAK,KAAK,UAAU,GAAG;AAC3G,WAAO,IAAI,KAAK,gBAAe,uBAAuB,SAAS;AAAA,EACjE;AAAA,EAEA,OAAO,MAAM,OAAuD;AAClE,UAAM,MAAM,MAAM,KAAK;AACvB,QAAI,WAAW,GAAG,GAAG;AACnB,aAAO,IAAI,KAAK,gBAAe,uBAAuB,GAAG;AAAA,IAC3D;AACA,UAAM,IAAI,MAAM,qBAAqB,KAAK,GAAG;AAAA,EAC/C;AAAA;AAAA,EAGA,OAAO,QAAQ,OAAoC;AACjD;AAAA,MACE,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK;AAAA,MACnD,MAAM;AAAA,IACR;AACA,UAAM,MAAM,MAAM,OAAO,EAAE,QAAQ,MAAM,CAAC;AAC1C,QAAI,IAAI,UAAU,kBAAkB,aAAa,GAAG;AAClD,aAAO,MAAM,OAAO,EAAE,QAAQ,OAAO,WAAW,kBAAkB,aAAa,EAAE,CAAC;AAAA,IACpF;AACA,QAAI,WAAW,GAAG,GAAG;AACnB,aAAO,IAAI,MAAM,GAAG,kBAAkB,aAAa,CAAC;AAAA,IACtD;AACA,UAAM,IAAI,MAAM,0CAA0C,GAAG,GAAG;AAAA,EAClE;AAAA;AAAA,EAGA,OAAO,QAAQ,OAA0B;AACvC;AAAA,MACE,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK;AAAA,MACnD,MAAM;AAAA,IACR;AACA,UAAM,MAAM,MAAM,OAAO,EAAE,QAAQ,MAAM,CAAC;AAC1C,QAAI,WAAW,GAAG,GAAG;AACnB,aAAO,IAAI,MAAM,kBAAkB,aAAa,GAAG,kBAAkB,qBAAqB,CAAC;AAAA,IAC7F;AACA,UAAM,OAAO,MAAO,KAAgB,EAAE,QAAQ,OAAO,WAAW,kBAAkB,aAAa,EAAE,CAAC;AAClG,WAAO,KAAK,MAAM,CAAC,kBAAkB,aAAa,CAAC;AAAA,EACrD;AACF;;;AC5HA,SAAoB,cAAc;AA4B3B,IAAM,iBAAiB,CAAC,UAA0C;AACvE,SAAQ,OAA4B,cAAc;AACpD;AAEO,IAAM,aAAa,CAAC,UAAsC;AAC/D,SAAO,OAAQ,OAAwB,KAAK,KAAK,OAAQ,OAAwB,SAAS;AAC5F;AAEO,IAAM,gBAAgB,CAAC,UAAyC;AACrE,SAAO,eAAe,KAAK,KAAK,WAAW,KAAK;AAClD;","names":[]}

package/dist/node/isPayload.d.ts

@@ -1,18 +1,18 @@
 import type { Payload } from './Payload.ts';
 export declare const isAnyPayload: (value: unknown) => value is Payload;
 export declare const asAnyPayload: {
-    <TType extends {
-        schema: string;
-    } & import("./Payload.ts").PayloadFields>(value: import(".store/@xylabs-promise-npm-4.4.9-454de9ac63/package").AnyNonPromise, config?: import("@xylabs/object").TypeCheckConfig): TType | undefined;
-    <TType extends {
-        schema: string;
-    } & import("./Payload.ts").PayloadFields>(value: import(".store/@xylabs-promise-npm-4.4.9-454de9ac63/package").AnyNonPromise, assert: import("@xylabs/object").StringOrAlertFunction<{
-        schema: string;
-    } & import("./Payload.ts").PayloadFields>, config?: import("@xylabs/object").TypeCheckConfig): TType;
+    <TType extends import("@xylabs/object").DeepRestrictToStringKeys<{
+        schema: import("./Schema.ts").Schema;
+    }>>(value: import(".store/@xylabs-promise-npm-4.4.21-54890ce283/package").AnyNonPromise, config?: import("@xylabs/object").TypeCheckConfig): TType | undefined;
+    <TType extends import("@xylabs/object").DeepRestrictToStringKeys<{
+        schema: import("./Schema.ts").Schema;
+    }>>(value: import(".store/@xylabs-promise-npm-4.4.21-54890ce283/package").AnyNonPromise, assert: import("@xylabs/object").StringOrAlertFunction<import("@xylabs/object").DeepRestrictToStringKeys<{
+        schema: import("./Schema.ts").Schema;
+    }>>, config?: import("@xylabs/object").TypeCheckConfig): TType;
 };
 export declare const isPayload: <T extends Payload>(schema: string[]) => (value: unknown) => value is T;
 export declare const asPayload: <T extends Payload>(schema: string[]) => {
-    <TType extends T>(value: import(".store/@xylabs-promise-npm-4.4.9-454de9ac63/package").AnyNonPromise, config?: import("@xylabs/object").TypeCheckConfig): TType | undefined;
-    <TType extends T>(value: import(".store/@xylabs-promise-npm-4.4.9-454de9ac63/package").AnyNonPromise, assert: import("@xylabs/object").StringOrAlertFunction<T>, config?: import("@xylabs/object").TypeCheckConfig): TType;
+    <TType extends T>(value: import(".store/@xylabs-promise-npm-4.4.21-54890ce283/package").AnyNonPromise, config?: import("@xylabs/object").TypeCheckConfig): TType | undefined;
+    <TType extends T>(value: import(".store/@xylabs-promise-npm-4.4.21-54890ce283/package").AnyNonPromise, assert: import("@xylabs/object").StringOrAlertFunction<T>, config?: import("@xylabs/object").TypeCheckConfig): TType;
 };
 //# sourceMappingURL=isPayload.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isPayload.d.ts","sourceRoot":"","sources":["../../src/isPayload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,KAAK,IAAI,OAKtD,CAAA;AAED,eAAO,MAAM,YAAY;;;4DAHpB,qDAGD,iCAAiC,gBAAoB;;;4DAIrD,qDAAe;;+DAGb,gBACK;CARqD,CAAA;AAEhE,eAAO,MAAM,SAAS,GACjB,CAAC,SAAS,OAAO,UAAU,MAAM,EAAE,aAC5B,OAAO,KAAG,KAAK,IAAI,CAK1B,CAAA;AAEL,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,EAAE;oCAdxD,qDAGD,iCAAiC,gBAAoB;oCAIrD,qDAAe,4FAGb,gBACK;CAGuI,CAAA"}
+{"version":3,"file":"isPayload.d.ts","sourceRoot":"","sources":["../../src/isPayload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,KAAK,IAAI,OAKtD,CAAA;AAED,eAAO,MAAM,YAAY;;;sBAHrB,sDAGD,iCAAiC,gBAAoB;;;sBAIpD,sDAAc;;yBAEyB,gBAEjC;CARsD,CAAA;AAEhE,eAAO,MAAM,SAAS,GACjB,CAAC,SAAS,OAAO,UAAU,MAAM,EAAE,aAC5B,OAAO,KAAG,KAAK,IAAI,CAK1B,CAAA;AAEL,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,EAAE;oCAdzD,sDAGD,iCAAiC,gBAAoB;oCAIpD,sDAAc,4FAEyB,gBAEjC;CAGwI,CAAA"}

package/dist/node/isPayloadOfSchemaType.d.ts

@@ -1,7 +1,5 @@
-import type { WithMeta } from './Meta.ts';
 import type { Payload, WithSources } from './Payload.ts';
 export declare const isPayloadOfSchemaType: <T extends Payload>(schema: string) => (x?: unknown | null) => x is T;
-export declare const isPayloadOfSchemaTypeWithMeta: <T extends Payload>(schema: string) => (x?: unknown | null) => x is WithMeta<T>;
 export declare const isPayloadOfSchemaTypeWithSources: <T extends Payload>(schema: string) => (x?: unknown | null) => x is WithSources<T>;
 export declare const notPayloadOfSchemaType: <T extends Payload>(schema: string) => (x?: unknown | null) => x is T;
 //# sourceMappingURL=isPayloadOfSchemaType.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isPayloadOfSchemaType.d.ts","sourceRoot":"","sources":["../../src/isPayloadOfSchemaType.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAExD,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UACzD,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,CACnC,CAAA;AAED,eAAO,MAAM,6BAA6B,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UACjE,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAC7C,CAAA;AAED,eAAO,MAAM,gCAAgC,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UACpE,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAEhD,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UAC1D,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,CACnC,CAAA"}
+{"version":3,"file":"isPayloadOfSchemaType.d.ts","sourceRoot":"","sources":["../../src/isPayloadOfSchemaType.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAExD,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UACzD,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,CACnC,CAAA;AAED,eAAO,MAAM,gCAAgC,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UACpE,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAEhD,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UAC1D,OAAO,GAAG,IAAI,KAAG,CAAC,IAAI,CACnC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/payload-model",
-  "version": "3.5.2",
+  "version": "3.6.0-rc.10",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -37,17 +37,20 @@
   "module": "dist/neutral/index.mjs",
   "types": "dist/neutral/index.d.ts",
   "dependencies": {
-    "@xylabs/hex": "^4.4.9",
-    "@xylabs/object": "^4.4.9"
+    "@xylabs/arraybuffer": "^4.4.21",
+    "@xylabs/assert": "^4.4.21",
+    "@xylabs/hex": "^4.4.21",
+    "@xylabs/object": "^4.4.21"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "^4.2.4",
-    "@xylabs/tsconfig": "^4.2.4",
-    "@xylabs/vitest-extended": "^4.4.9",
+    "@xylabs/ts-scripts-yarn3": "^4.2.6",
+    "@xylabs/tsconfig": "^4.2.6",
+    "@xylabs/vitest-extended": "^4.4.21",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.5"
+    "vitest": "^2.1.8"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "stableVersion": "3.5.2"
 }

package/src/Error.ts

@@ -13,7 +13,6 @@ export type ModuleError = Payload<{
   name?: string
   query?: Hash
   schema: ModuleErrorSchema
-  sources?: Hash[]
 }>
 
 export const isModuleError = isPayloadOfSchemaType<ModuleError>(ModuleErrorSchema)

package/src/Payload.ts

@@ -1,43 +1,55 @@
 import type { Hash } from '@xylabs/hex'
-import type { EmptyObject, JsonObject } from '@xylabs/object'
+import type {
+  DeepOmitStartsWith, DeepPickStartsWith, DeepRestrictToStringKeys, EmptyObject,
+} from '@xylabs/object'
 
 import type { Schema, WithSchema } from './Schema.ts'
 
-/** Meta fields for a payload - Either both $hash and $meta should exist or neither */
-export interface PayloadMetaFields<TAdditionalMeta extends EmptyObject | void = void> extends EmptyObject {
-  /** Hash of the body of the payload excluding the items in the $meta object */
-  $hash: Hash
-  /** Meta data that should be included in the main hash of the payload */
-  $meta?: TAdditionalMeta extends void ? JsonObject : TAdditionalMeta
+export interface SchemaField<T extends Schema = Schema> {
+  schema: T
 }
 
 /** Additional fields for a payload */
-export interface PayloadFields extends EmptyObject {
-  schema: Schema
-}
+export interface PayloadFields extends SchemaField {}
 
-export type WithPayload<T extends EmptyObject | void = void> = WithSchema<T extends EmptyObject ? PayloadFields & T : PayloadFields>
+export type WithPayload<T extends EmptyObject | void = void> =
+  DeepRestrictToStringKeys<WithoutMeta<WithSchema<T extends EmptyObject ? PayloadFields & T : PayloadFields>>>
 
 /** Base Type for Payloads */
 export type Payload<T extends void | EmptyObject | WithSchema = void, S extends Schema | void = void> =
   T extends WithSchema ?
     S extends Schema ?
       /* T (w/Schema) & S provided */
-      WithPayload<Omit<T, 'schema'> & { schema: S } & PayloadFields>
+      WithPayload<Omit<T, 'schema'> & { schema: S }>
       : /* Only T (w/Schema) provided */ WithPayload<T>
     : T extends object ?
       S extends Schema ?
       /* T (w/o Schema) & S provided */
-        WithPayload<T & { schema: S } & PayloadFields>
-        : /* Only T (w/o Schema) provided */ WithPayload<T & { schema: Schema } & PayloadFields>
+        WithPayload<T & { schema: S }>
+        : /* Only T (w/o Schema) provided */ WithPayload<T & PayloadFields>
       : /* Either just S or neither S or T provided */
-        {
-          schema: S extends Schema ? S : Schema
-        } & PayloadFields
+      WithPayload<{
+        schema: S extends Schema ? S : Schema
+      }>
+
+export type OverridablePayload<T extends Payload> = WithoutMeta<Omit<T, 'schema'> & PayloadFields>
+
+export type SourcesMetaField = { $sources: Hash[] }
 
-export type OverridablePayload<T extends Payload> = Omit<T, 'schema'> & { schema: string }
+export type WithSources<T extends EmptyObject> = T & SourcesMetaField
+export type WithOptionalSources<T extends EmptyObject> = (T & SourcesMetaField) | T
 
-export type WithSources<T extends EmptyObject> = T & { sources?: Hash[] }
 export type PayloadWithSources<T extends void | EmptyObject | WithSchema = void, S extends Schema | void = void> = WithSources<Payload<T, S>>
+export type PayloadWithOptionalSources<T extends void | EmptyObject | WithSchema = void, S extends Schema | void = void> = WithOptionalSources<Payload<T, S>>
+
+export type WithAnySchema<T extends Payload> = OverridablePayload<T>
+
+export type WithoutClientMeta<T extends EmptyObject> = DeepOmitStartsWith<T, '$'>
+export type WithoutStorageMeta<T extends EmptyObject> = DeepOmitStartsWith<T, '_'>
+export type WithoutPrivateStorageMeta<T extends EmptyObject> = DeepOmitStartsWith<T, '__'>
+export type WithoutMeta<T extends EmptyObject> = WithoutClientMeta<WithoutStorageMeta<T>>
+
+export type WithoutSchema<T extends WithOptionalSchema<Payload>> = Omit<T, 'schema'>
+export type WithOptionalSchema<T extends EmptyObject = EmptyObject> = WithoutSchema<T> & Partial<T & SchemaField>
 
-export type WithAnySchema<T extends Payload> = Omit<T, 'schema'> & { schema: string }
+export type WithOnlyClientMeta<T extends EmptyObject> = DeepPickStartsWith<T, '$'>

package/src/Query.ts

@@ -22,7 +22,7 @@ export type Query<T extends void | EmptyObject | WithSchema = void, S extends Sc
   T extends void ? QueryFields : T & QueryFields,
   S extends void ?
     T extends WithSchema ? T['schema']
-      : T extends void ? string
+      : T extends void ? Schema
         : void
     : S
 >

package/src/StorageMeta/Sequence.ts

@@ -0,0 +1,72 @@
+import type { Address, Hex } from '@xylabs/hex'
+import { isHex } from '@xylabs/hex'
+
+// we use Exclude to intentionally make the type not equal to string
+export type LocalSequence = Hex & Exclude<string, 'reserved-local-sequence-value'>
+export type QualifiedSequence = Hex & Exclude<string, 'reserved-qualified-sequence-value'>
+export type Sequence = LocalSequence | QualifiedSequence
+
+export type Epoch = Hex & Exclude<string, 'reserved-epoch-sequence-value'>
+
+export const isEpoch = (value: unknown): value is Epoch => {
+  return isHex(value) && (value as string).length === SequenceConstants.epochBytes * 2
+}
+
+export type Nonce = Hex & Exclude<string, 'reserved-nonce-sequence-value'>
+
+export const isNonce = (value: unknown): value is Epoch => {
+  return isHex(value) && (value as string).length === SequenceConstants.nonceBytes * 2
+}
+
+export const isLocalSequence = (value: unknown): value is Sequence => {
+  return isHex(value) && (value as string).length === SequenceConstants.localSequenceBytes * 2
+}
+
+export const isQualifiedSequence = (value: unknown): value is Sequence => {
+  return isHex(value) && (value as string).length === SequenceConstants.qualifiedSequenceBytes * 2
+}
+
+export const isSequence = (value: unknown): value is Sequence => {
+  return isLocalSequence(value) || isQualifiedSequence(value)
+}
+
+export const SequenceComponentLengths = {
+  epochBytes: 8,
+  nonceBytes: 8,
+  addressBytes: 20,
+}
+
+export const SequenceComponentMinMax = {
+  minEpoch: '0'.repeat(SequenceComponentLengths.epochBytes * 2) as Epoch,
+  maxEpoch: 'f'.repeat(SequenceComponentLengths.epochBytes * 2) as Epoch,
+  minNonce: '0'.repeat(SequenceComponentLengths.nonceBytes * 2) as Nonce,
+  maxNonce: 'f'.repeat(SequenceComponentLengths.nonceBytes * 2) as Nonce,
+  minAddress: '0'.repeat(SequenceComponentLengths.addressBytes * 2) as Address,
+  maxAddress: 'f'.repeat(SequenceComponentLengths.addressBytes * 2) as Address,
+}
+
+export const LocalSequenceConstants = {
+  ...SequenceComponentLengths,
+  ...SequenceComponentMinMax,
+  localSequenceBytes: SequenceComponentLengths.epochBytes + SequenceComponentLengths.nonceBytes,
+  minLocalSequence: SequenceComponentMinMax.minEpoch + SequenceComponentMinMax.minNonce as LocalSequence,
+  maxLocalSequence: SequenceComponentMinMax.maxEpoch + SequenceComponentMinMax.maxNonce as LocalSequence,
+}
+
+export const QualifiedSequenceConstants = {
+  qualifiedSequenceBytes: LocalSequenceConstants.localSequenceBytes + SequenceComponentLengths.addressBytes,
+  minLocalSequence: LocalSequenceConstants.minLocalSequence + SequenceComponentMinMax.minAddress as QualifiedSequence,
+  maxLocalSequence: LocalSequenceConstants.maxLocalSequence + SequenceComponentMinMax.maxAddress as QualifiedSequence,
+}
+
+export const SequenceConstants = {
+  ...LocalSequenceConstants,
+  ...QualifiedSequenceConstants,
+}
+
+// "11111111111111112222222222222222" is and example of a local sequence string
+
+// "111111111111111122222222222222223333333333333333333333333333333333333333" is and example of a local sequence string
+// epoch = "1111111111111111"
+// nonce = "2222222222222222"
+// address = "3333333333333333333333333333333333333333"