@bcts/uniform-resources 1.0.0-alpha.12 → 1.0.0-alpha.14

package/dist/index.d.cts

@@ -49,6 +49,13 @@ declare class BytewordsError extends URError {
 declare class CBORError extends URError {
   constructor(message: string);
 }
+/**
+ * Error type for UR decoder errors.
+ * Matches Rust's Error::UR(String) variant.
+ */
+declare class URDecodeError extends URError {
+  constructor(message: string);
+}
 type Result<T> = T | Error;
 /**
  * Helper function to check if a result is an error.
@@ -382,12 +389,6 @@ declare class MultipartEncoder {
    * ```
    */
   constructor(ur: UR, maxFragmentLen: number);
-  /**
-   * Returns whether the message fits in a single part.
-   *
-   * For single-part messages, consider using UR.string() directly.
-   */
-  isSinglePart(): boolean;
   /**
    * Gets the next part of the encoding.
    *
@@ -408,7 +409,8 @@ declare class MultipartEncoder {
    */
   private _encodePart;
   /**
-   * Encodes part metadata and data into bytes for bytewords encoding.
+   * Encodes part metadata and data as CBOR for bytewords encoding.
+   * Format: CBOR array [seqNum, seqLen, messageLen, checksum, data]
    */
   private _encodePartData;
   /**
@@ -422,17 +424,6 @@ declare class MultipartEncoder {
    * for additional redundancy.
    */
   partsCount(): number;
-  /**
-   * Checks if all pure parts have been emitted.
-   *
-   * Even after this returns true, you can continue calling nextPart()
-   * to generate additional rateless parts for redundancy.
-   */
-  isComplete(): boolean;
-  /**
-   * Resets the encoder to start from the beginning.
-   */
-  reset(): void;
 }
 //#endregion
 //#region src/multipart-decoder.d.ts
@@ -473,6 +464,8 @@ declare class MultipartDecoder {
   private _parsePart;
   /**
    * Decodes a multipart UR's fountain part data.
+   *
+   * The multipart body is a CBOR array: [seqNum, seqLen, messageLen, checksum, data]
    */
   private _decodeFountainPart;
   /**
@@ -485,238 +478,14 @@ declare class MultipartDecoder {
    * @returns The decoded UR, or null if not yet complete
    */
   message(): UR | null;
-  /**
-   * Returns the decoding progress as a fraction (0 to 1).
-   */
-  progress(): number;
-  /**
-   * Resets the decoder to receive a new message.
-   */
-  reset(): void;
 }
 //#endregion
-//#region src/fountain.d.ts
-/**
- * Fountain code implementation for multipart URs.
- *
- * This implements a hybrid fixed-rate and rateless fountain code system
- * as specified in BCR-2020-005 and BCR-2024-001.
- *
- * Key concepts:
- * - Parts 1-seqLen are "pure" fragments (fixed-rate)
- * - Parts > seqLen are "mixed" fragments using XOR (rateless)
- * - Xoshiro256** PRNG ensures encoder/decoder agree on mixing
- */
-/**
- * Represents a fountain code part with metadata.
- */
-interface FountainPart {
-  /** Sequence number (1-based) */
-  seqNum: number;
-  /** Total number of pure fragments */
-  seqLen: number;
-  /** Length of original message */
-  messageLen: number;
-  /** CRC32 checksum of original message */
-  checksum: number;
-  /** Fragment data */
-  data: Uint8Array;
-}
-/**
- * Splits data into fragments of the specified size.
- */
-declare function splitMessage(message: Uint8Array, fragmentLen: number): Uint8Array[];
-/**
- * XOR two Uint8Arrays together.
- */
-declare function xorBytes(a: Uint8Array, b: Uint8Array): Uint8Array;
-/**
- * Chooses which fragments to mix for a given sequence number.
- *
- * This uses a seeded Xoshiro256** PRNG to deterministically select fragments,
- * ensuring encoder and decoder agree without explicit coordination.
- *
- * @param seqNum - The sequence number (1-based)
- * @param seqLen - Total number of pure fragments
- * @param checksum - CRC32 checksum of the message
- * @returns Array of fragment indices (0-based)
- */
-declare function chooseFragments(seqNum: number, seqLen: number, checksum: number): number[];
-/**
- * Mixes the selected fragments using XOR.
- */
-declare function mixFragments(fragments: Uint8Array[], indices: number[]): Uint8Array;
-/**
- * Fountain encoder for creating multipart URs.
- */
-declare class FountainEncoder {
-  private readonly fragments;
-  private readonly messageLen;
-  private readonly checksum;
-  private seqNum;
-  /**
-   * Creates a fountain encoder for the given message.
-   *
-   * @param message - The message to encode
-   * @param maxFragmentLen - Maximum length of each fragment
-   */
-  constructor(message: Uint8Array, maxFragmentLen: number);
-  /**
-   * Returns the number of pure fragments.
-   */
-  get seqLen(): number;
-  /**
-   * Returns whether the message fits in a single part.
-   */
-  isSinglePart(): boolean;
-  /**
-   * Returns whether all pure parts have been emitted.
-   */
-  isComplete(): boolean;
-  /**
-   * Generates the next fountain part.
-   */
-  nextPart(): FountainPart;
-  /**
-   * Returns the current sequence number.
-   */
-  currentSeqNum(): number;
-  /**
-   * Resets the encoder to start from the beginning.
-   */
-  reset(): void;
-}
-/**
- * Fountain decoder for reassembling multipart URs.
- */
-declare class FountainDecoder {
-  private seqLen;
-  private messageLen;
-  private checksum;
-  private readonly pureFragments;
-  private readonly mixedParts;
-  /**
-   * Receives a fountain part and attempts to decode.
-   *
-   * @param part - The fountain part to receive
-   * @returns true if the message is now complete
-   */
-  receive(part: FountainPart): boolean;
-  /**
-   * Attempts to extract pure fragments from mixed parts.
-   */
-  private reduceMixedParts;
-  /**
-   * Returns whether all fragments have been received.
-   */
-  isComplete(): boolean;
-  /**
-   * Reconstructs the original message.
-   *
-   * @returns The original message, or null if not yet complete
-   */
-  message(): Uint8Array | null;
-  /**
-   * Returns the progress as a fraction (0 to 1).
-   */
-  progress(): number;
-  /**
-   * Resets the decoder.
-   */
-  reset(): void;
-}
-//#endregion
-//#region src/xoshiro.d.ts
-/**
- * Xoshiro256** PRNG implementation.
- *
- * This is a high-quality, fast pseudo-random number generator used
- * for deterministic fragment selection in fountain codes.
- *
- * Reference: https://prng.di.unimi.it/
- */
-/**
- * Xoshiro256** pseudo-random number generator.
- *
- * This PRNG is used for deterministic mixing in fountain codes,
- * allowing both encoder and decoder to agree on which fragments
- * are combined without transmitting that information.
- */
-declare class Xoshiro256 {
-  private s;
-  /**
-   * Creates a new Xoshiro256** instance from a seed.
-   *
-   * The seed is hashed using SHA-256 to initialize the state.
-   * For consistent results across encoder/decoder, use the same seed.
-   *
-   * @param seed - The seed bytes (any length)
-   */
-  constructor(seed: Uint8Array);
-  /**
-   * Creates a Xoshiro256** instance from raw state values.
-   * Useful for seeding with specific values.
-   */
-  static fromState(s0: bigint, s1: bigint, s2: bigint, s3: bigint): Xoshiro256;
-  /**
-   * Simple hash function for seeding.
-   * This is a basic implementation - in production use SHA-256.
-   */
-  private hashSeed;
-  /**
-   * Converts 8 bytes to a 64-bit BigInt (little-endian).
-   */
-  private bytesToBigInt;
-  /**
-   * Generates the next 64-bit random value.
-   */
-  next(): bigint;
-  /**
-   * Generates a random double in [0, 1).
-   */
-  nextDouble(): number;
-  /**
-   * Generates a random integer in [low, high).
-   */
-  nextInt(low: number, high: number): number;
-  /**
-   * Generates a random byte [0, 255].
-   */
-  nextByte(): number;
-  /**
-   * Generates an array of random bytes.
-   */
-  nextData(count: number): Uint8Array;
-}
-/**
- * Creates a seed for the Xoshiro PRNG from message checksum and sequence number.
- *
- * This ensures that both encoder and decoder produce the same random sequence
- * for a given message and part number.
- */
-declare function createSeed(checksum: number, seqNum: number): Uint8Array;
-//#endregion
 //#region src/utils.d.ts
-/**
- * Checks if a character is a valid UR type character.
- * Valid characters are lowercase letters, digits, and hyphens.
- */
-declare function isURTypeChar(char: string): boolean;
-/**
- * Checks if a string is a valid UR type.
- * Valid UR types contain only lowercase letters, digits, and hyphens.
- */
-declare function isValidURType(urType: string): boolean;
-/**
- * Validates and returns a UR type, or throws an error if invalid.
- */
-declare function validateURType(urType: string): string;
 /**
  * Bytewords for encoding/decoding bytes as words.
  * See: https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-004-bytewords.md
  */
 declare const BYTEWORDS: string[];
-declare const BYTEWORDS_MAP: Map<string, number>;
 /**
  * Bytemojis for encoding/decoding bytes as emojis.
  * See: https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2024-008-bytemoji.md
@@ -736,16 +505,11 @@ declare function encodeBytemojisIdentifier(data: Uint8Array): string;
 declare enum BytewordsStyle {
   /** Full 4-letter words separated by spaces */
   Standard = "standard",
-  /** Full 4-letter words without separators */
+  /** Full 4-letter words separated by hyphens (URI-safe) */
   Uri = "uri",
   /** First and last character only (minimal) - used by UR encoding */
   Minimal = "minimal",
 }
-declare const MINIMAL_BYTEWORDS_MAP: Map<string, number>;
-/**
- * Calculate CRC32 checksum of data.
- */
-declare function crc32(data: Uint8Array): number;
 /**
  * Encode data as bytewords with the specified style.
  * Includes CRC32 checksum.
@@ -757,5 +521,5 @@ declare function encodeBytewords(data: Uint8Array, style?: BytewordsStyle): stri
  */
 declare function decodeBytewords(encoded: string, style?: BytewordsStyle): Uint8Array;
 //#endregion
-export { BYTEMOJIS, BYTEWORDS, BYTEWORDS_MAP, BytewordsError, BytewordsStyle, CBORError, FountainDecoder, FountainEncoder, type FountainPart, InvalidSchemeError, InvalidTypeError, MINIMAL_BYTEWORDS_MAP, MultipartDecoder, MultipartEncoder, NotSinglePartError, type Result, TypeUnspecifiedError, UR, type URCodable, type URDecodable, type UREncodable, URError, URType, UnexpectedTypeError, Xoshiro256, chooseFragments, crc32, createSeed, decodeBytewords, encodeBytemojisIdentifier, encodeBytewords, encodeBytewordsIdentifier, isError, isURCodable, isURDecodable, isUREncodable, isURTypeChar, isValidURType, mixFragments, splitMessage, validateURType, xorBytes };
+export { BYTEMOJIS, BYTEWORDS, BytewordsError, BytewordsStyle, CBORError, InvalidSchemeError, InvalidTypeError, MultipartDecoder, MultipartEncoder, NotSinglePartError, type Result, TypeUnspecifiedError, UR, type URCodable, type URDecodable, URDecodeError, type UREncodable, URError, URType, UnexpectedTypeError, decodeBytewords, encodeBytemojisIdentifier, encodeBytewords, encodeBytewordsIdentifier, isError, isURCodable, isURDecodable, isUREncodable };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/error.ts","../src/ur-type.ts","../src/ur.ts","../src/ur-encodable.ts","../src/ur-decodable.ts","../src/ur-codable.ts","../src/multipart-encoder.ts","../src/multipart-decoder.ts","../src/fountain.ts","../src/xoshiro.ts","../src/utils.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/error.ts","../src/ur-type.ts","../src/ur.ts","../src/ur-encodable.ts","../src/ur-decodable.ts","../src/ur-codable.ts","../src/multipart-encoder.ts","../src/multipart-decoder.ts","../src/utils.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -49,6 +49,13 @@ declare class BytewordsError extends URError {
 declare class CBORError extends URError {
   constructor(message: string);
 }
+/**
+ * Error type for UR decoder errors.
+ * Matches Rust's Error::UR(String) variant.
+ */
+declare class URDecodeError extends URError {
+  constructor(message: string);
+}
 type Result<T> = T | Error;
 /**
  * Helper function to check if a result is an error.
@@ -382,12 +389,6 @@ declare class MultipartEncoder {
    * ```
    */
   constructor(ur: UR, maxFragmentLen: number);
-  /**
-   * Returns whether the message fits in a single part.
-   *
-   * For single-part messages, consider using UR.string() directly.
-   */
-  isSinglePart(): boolean;
   /**
    * Gets the next part of the encoding.
    *
@@ -408,7 +409,8 @@ declare class MultipartEncoder {
    */
   private _encodePart;
   /**
-   * Encodes part metadata and data into bytes for bytewords encoding.
+   * Encodes part metadata and data as CBOR for bytewords encoding.
+   * Format: CBOR array [seqNum, seqLen, messageLen, checksum, data]
    */
   private _encodePartData;
   /**
@@ -422,17 +424,6 @@ declare class MultipartEncoder {
    * for additional redundancy.
    */
   partsCount(): number;
-  /**
-   * Checks if all pure parts have been emitted.
-   *
-   * Even after this returns true, you can continue calling nextPart()
-   * to generate additional rateless parts for redundancy.
-   */
-  isComplete(): boolean;
-  /**
-   * Resets the encoder to start from the beginning.
-   */
-  reset(): void;
 }
 //#endregion
 //#region src/multipart-decoder.d.ts
@@ -473,6 +464,8 @@ declare class MultipartDecoder {
   private _parsePart;
   /**
    * Decodes a multipart UR's fountain part data.
+   *
+   * The multipart body is a CBOR array: [seqNum, seqLen, messageLen, checksum, data]
    */
   private _decodeFountainPart;
   /**
@@ -485,238 +478,14 @@ declare class MultipartDecoder {
    * @returns The decoded UR, or null if not yet complete
    */
   message(): UR | null;
-  /**
-   * Returns the decoding progress as a fraction (0 to 1).
-   */
-  progress(): number;
-  /**
-   * Resets the decoder to receive a new message.
-   */
-  reset(): void;
 }
 //#endregion
-//#region src/fountain.d.ts
-/**
- * Fountain code implementation for multipart URs.
- *
- * This implements a hybrid fixed-rate and rateless fountain code system
- * as specified in BCR-2020-005 and BCR-2024-001.
- *
- * Key concepts:
- * - Parts 1-seqLen are "pure" fragments (fixed-rate)
- * - Parts > seqLen are "mixed" fragments using XOR (rateless)
- * - Xoshiro256** PRNG ensures encoder/decoder agree on mixing
- */
-/**
- * Represents a fountain code part with metadata.
- */
-interface FountainPart {
-  /** Sequence number (1-based) */
-  seqNum: number;
-  /** Total number of pure fragments */
-  seqLen: number;
-  /** Length of original message */
-  messageLen: number;
-  /** CRC32 checksum of original message */
-  checksum: number;
-  /** Fragment data */
-  data: Uint8Array;
-}
-/**
- * Splits data into fragments of the specified size.
- */
-declare function splitMessage(message: Uint8Array, fragmentLen: number): Uint8Array[];
-/**
- * XOR two Uint8Arrays together.
- */
-declare function xorBytes(a: Uint8Array, b: Uint8Array): Uint8Array;
-/**
- * Chooses which fragments to mix for a given sequence number.
- *
- * This uses a seeded Xoshiro256** PRNG to deterministically select fragments,
- * ensuring encoder and decoder agree without explicit coordination.
- *
- * @param seqNum - The sequence number (1-based)
- * @param seqLen - Total number of pure fragments
- * @param checksum - CRC32 checksum of the message
- * @returns Array of fragment indices (0-based)
- */
-declare function chooseFragments(seqNum: number, seqLen: number, checksum: number): number[];
-/**
- * Mixes the selected fragments using XOR.
- */
-declare function mixFragments(fragments: Uint8Array[], indices: number[]): Uint8Array;
-/**
- * Fountain encoder for creating multipart URs.
- */
-declare class FountainEncoder {
-  private readonly fragments;
-  private readonly messageLen;
-  private readonly checksum;
-  private seqNum;
-  /**
-   * Creates a fountain encoder for the given message.
-   *
-   * @param message - The message to encode
-   * @param maxFragmentLen - Maximum length of each fragment
-   */
-  constructor(message: Uint8Array, maxFragmentLen: number);
-  /**
-   * Returns the number of pure fragments.
-   */
-  get seqLen(): number;
-  /**
-   * Returns whether the message fits in a single part.
-   */
-  isSinglePart(): boolean;
-  /**
-   * Returns whether all pure parts have been emitted.
-   */
-  isComplete(): boolean;
-  /**
-   * Generates the next fountain part.
-   */
-  nextPart(): FountainPart;
-  /**
-   * Returns the current sequence number.
-   */
-  currentSeqNum(): number;
-  /**
-   * Resets the encoder to start from the beginning.
-   */
-  reset(): void;
-}
-/**
- * Fountain decoder for reassembling multipart URs.
- */
-declare class FountainDecoder {
-  private seqLen;
-  private messageLen;
-  private checksum;
-  private readonly pureFragments;
-  private readonly mixedParts;
-  /**
-   * Receives a fountain part and attempts to decode.
-   *
-   * @param part - The fountain part to receive
-   * @returns true if the message is now complete
-   */
-  receive(part: FountainPart): boolean;
-  /**
-   * Attempts to extract pure fragments from mixed parts.
-   */
-  private reduceMixedParts;
-  /**
-   * Returns whether all fragments have been received.
-   */
-  isComplete(): boolean;
-  /**
-   * Reconstructs the original message.
-   *
-   * @returns The original message, or null if not yet complete
-   */
-  message(): Uint8Array | null;
-  /**
-   * Returns the progress as a fraction (0 to 1).
-   */
-  progress(): number;
-  /**
-   * Resets the decoder.
-   */
-  reset(): void;
-}
-//#endregion
-//#region src/xoshiro.d.ts
-/**
- * Xoshiro256** PRNG implementation.
- *
- * This is a high-quality, fast pseudo-random number generator used
- * for deterministic fragment selection in fountain codes.
- *
- * Reference: https://prng.di.unimi.it/
- */
-/**
- * Xoshiro256** pseudo-random number generator.
- *
- * This PRNG is used for deterministic mixing in fountain codes,
- * allowing both encoder and decoder to agree on which fragments
- * are combined without transmitting that information.
- */
-declare class Xoshiro256 {
-  private s;
-  /**
-   * Creates a new Xoshiro256** instance from a seed.
-   *
-   * The seed is hashed using SHA-256 to initialize the state.
-   * For consistent results across encoder/decoder, use the same seed.
-   *
-   * @param seed - The seed bytes (any length)
-   */
-  constructor(seed: Uint8Array);
-  /**
-   * Creates a Xoshiro256** instance from raw state values.
-   * Useful for seeding with specific values.
-   */
-  static fromState(s0: bigint, s1: bigint, s2: bigint, s3: bigint): Xoshiro256;
-  /**
-   * Simple hash function for seeding.
-   * This is a basic implementation - in production use SHA-256.
-   */
-  private hashSeed;
-  /**
-   * Converts 8 bytes to a 64-bit BigInt (little-endian).
-   */
-  private bytesToBigInt;
-  /**
-   * Generates the next 64-bit random value.
-   */
-  next(): bigint;
-  /**
-   * Generates a random double in [0, 1).
-   */
-  nextDouble(): number;
-  /**
-   * Generates a random integer in [low, high).
-   */
-  nextInt(low: number, high: number): number;
-  /**
-   * Generates a random byte [0, 255].
-   */
-  nextByte(): number;
-  /**
-   * Generates an array of random bytes.
-   */
-  nextData(count: number): Uint8Array;
-}
-/**
- * Creates a seed for the Xoshiro PRNG from message checksum and sequence number.
- *
- * This ensures that both encoder and decoder produce the same random sequence
- * for a given message and part number.
- */
-declare function createSeed(checksum: number, seqNum: number): Uint8Array;
-//#endregion
 //#region src/utils.d.ts
-/**
- * Checks if a character is a valid UR type character.
- * Valid characters are lowercase letters, digits, and hyphens.
- */
-declare function isURTypeChar(char: string): boolean;
-/**
- * Checks if a string is a valid UR type.
- * Valid UR types contain only lowercase letters, digits, and hyphens.
- */
-declare function isValidURType(urType: string): boolean;
-/**
- * Validates and returns a UR type, or throws an error if invalid.
- */
-declare function validateURType(urType: string): string;
 /**
  * Bytewords for encoding/decoding bytes as words.
  * See: https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-004-bytewords.md
  */
 declare const BYTEWORDS: string[];
-declare const BYTEWORDS_MAP: Map<string, number>;
 /**
  * Bytemojis for encoding/decoding bytes as emojis.
  * See: https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2024-008-bytemoji.md
@@ -736,16 +505,11 @@ declare function encodeBytemojisIdentifier(data: Uint8Array): string;
 declare enum BytewordsStyle {
   /** Full 4-letter words separated by spaces */
   Standard = "standard",
-  /** Full 4-letter words without separators */
+  /** Full 4-letter words separated by hyphens (URI-safe) */
   Uri = "uri",
   /** First and last character only (minimal) - used by UR encoding */
   Minimal = "minimal",
 }
-declare const MINIMAL_BYTEWORDS_MAP: Map<string, number>;
-/**
- * Calculate CRC32 checksum of data.
- */
-declare function crc32(data: Uint8Array): number;
 /**
  * Encode data as bytewords with the specified style.
  * Includes CRC32 checksum.
@@ -757,5 +521,5 @@ declare function encodeBytewords(data: Uint8Array, style?: BytewordsStyle): stri
  */
 declare function decodeBytewords(encoded: string, style?: BytewordsStyle): Uint8Array;
 //#endregion
-export { BYTEMOJIS, BYTEWORDS, BYTEWORDS_MAP, BytewordsError, BytewordsStyle, CBORError, FountainDecoder, FountainEncoder, type FountainPart, InvalidSchemeError, InvalidTypeError, MINIMAL_BYTEWORDS_MAP, MultipartDecoder, MultipartEncoder, NotSinglePartError, type Result, TypeUnspecifiedError, UR, type URCodable, type URDecodable, type UREncodable, URError, URType, UnexpectedTypeError, Xoshiro256, chooseFragments, crc32, createSeed, decodeBytewords, encodeBytemojisIdentifier, encodeBytewords, encodeBytewordsIdentifier, isError, isURCodable, isURDecodable, isUREncodable, isURTypeChar, isValidURType, mixFragments, splitMessage, validateURType, xorBytes };
+export { BYTEMOJIS, BYTEWORDS, BytewordsError, BytewordsStyle, CBORError, InvalidSchemeError, InvalidTypeError, MultipartDecoder, MultipartEncoder, NotSinglePartError, type Result, TypeUnspecifiedError, UR, type URCodable, type URDecodable, URDecodeError, type UREncodable, URError, URType, UnexpectedTypeError, decodeBytewords, encodeBytemojisIdentifier, encodeBytewords, encodeBytewordsIdentifier, isError, isURCodable, isURDecodable, isUREncodable };
 //# sourceMappingURL=index.d.mts.map