@bcts/uniform-resources 1.0.0-alpha.11 → 1.0.0-alpha.13

package/dist/index.mjs

@@ -4897,7 +4897,13 @@ var TagsStore = class {
 	/**
 	* Insert a tag into the registry.
 	*
-	* @param tag - The tag to register
+	* Matches Rust's TagsStore::insert() behavior:
+	* - Throws if the tag name is undefined or empty
+	* - Throws if a tag with the same value exists with a different name
+	* - Allows re-registering the same tag value with the same name
+	*
+	* @param tag - The tag to register (must have a non-empty name)
+	* @throws Error if tag has no name, empty name, or conflicts with existing registration
 	*
 	* @example
 	* ```typescript
@@ -4906,9 +4912,13 @@ var TagsStore = class {
 	* ```
 	*/
 	insert(tag) {
+		const name = tag.name;
+		if (name === void 0 || name === "") throw new Error(`Tag ${tag.value} must have a non-empty name`);
 		const key = this.#valueKey(tag.value);
+		const existing = this.#tagsByValue.get(key);
+		if (existing?.name !== void 0 && existing.name !== name) throw new Error(`Attempt to register tag: ${tag.value} '${existing.name}' with different name: '${name}'`);
 		this.#tagsByValue.set(key, tag);
-		if (tag.name !== void 0) this.#tagsByName.set(tag.name, tag);
+		this.#tagsByName.set(name, tag);
 	}
 	/**
 	* Insert multiple tags into the registry.
@@ -4946,21 +4956,6 @@ var TagsStore = class {
 		const key = this.#valueKey(tagValue$1);
 		this.#summarizers.set(key, summarizer);
 	}
-	/**
-	* Remove a tag from the registry.
-	*
-	* @param tagValue - The numeric tag value to remove
-	* @returns true if a tag was removed, false otherwise
-	*/
-	remove(tagValue$1) {
-		const key = this.#valueKey(tagValue$1);
-		const tag = this.#tagsByValue.get(key);
-		if (tag === void 0) return false;
-		this.#tagsByValue.delete(key);
-		if (tag.name !== void 0) this.#tagsByName.delete(tag.name);
-		this.#summarizers.delete(key);
-		return true;
-	}
 	assignedNameForTag(tag) {
 		const key = this.#valueKey(tag.value);
 		return this.#tagsByValue.get(key)?.name;
@@ -4984,30 +4979,6 @@ var TagsStore = class {
 		return this.#summarizers.get(key);
 	}
 	/**
-	* Get all registered tags.
-	*
-	* @returns Array of all registered tags
-	*/
-	getAllTags() {
-		return Array.from(this.#tagsByValue.values());
-	}
-	/**
-	* Clear all registered tags and summarizers.
-	*/
-	clear() {
-		this.#tagsByValue.clear();
-		this.#tagsByName.clear();
-		this.#summarizers.clear();
-	}
-	/**
-	* Get the number of registered tags.
-	*
-	* @returns Number of tags in the registry
-	*/
-	get size() {
-		return this.#tagsByValue.size;
-	}
-	/**
 	* Create a string key for a numeric tag value.
 	* Handles both number and bigint types.
 	*
@@ -5370,11 +5341,17 @@ function formatMap(map, opts) {
 }
 /**
 * Format tagged value.
+*
+* Matches Rust's diag_item() for Tagged case.
 */
 function formatTagged(tag, content, opts) {
 	if (opts.summarize === true) {
 		const summarizer = resolveTagsStore(opts.tags)?.summarizer(tag);
-		if (summarizer !== void 0) return summarizer(content, opts.flat ?? false);
+		if (summarizer !== void 0) {
+			const result$1 = summarizer(content, opts.flat ?? false);
+			if (result$1.ok) return result$1.value;
+			else return `<error: ${result$1.error.type === "Custom" ? result$1.error.message : result$1.error.type === "WrongTag" ? `expected CBOR tag ${result$1.error.expected.value}, but got ${result$1.error.actual.value}` : result$1.error.type}>`;
+		}
 	}
 	let comment;
 	if (opts.annotate === true) {
@@ -6005,21 +5982,20 @@ let EdgeType = /* @__PURE__ */ function(EdgeType$1) {
 * @param cbor - The CBOR value to traverse
 * @param initialState - Initial state value
 * @param visitor - Function to call for each element
-* @returns Final state after traversal
 *
 * @example
 * ```typescript
-* // Count all text strings in a structure
-* interface CountState { count: number }
+* // Count all text strings in a structure using RefCell-like pattern
+* const count = { value: 0 };
 *
 * const structure = cbor({ name: 'Alice', tags: ['urgent', 'draft'] });
-* const result = walk(structure, { count: 0 }, (element, level, edge, state) => {
+* walk(structure, null, (element, level, edge, state) => {
 *   if (element.type === 'single' && element.cbor.type === MajorType.Text) {
-*     return [{ count: state.count + 1 }, false];
+*     count.value++;
 *   }
 *   return [state, false];
 * });
-* console.log(result.count); // 3 (name, urgent, draft)
+* console.log(count.value); // 3 (name, urgent, draft)
 * ```
 *
 * @example
@@ -6028,7 +6004,7 @@ let EdgeType = /* @__PURE__ */ function(EdgeType$1) {
 * const structure = cbor([1, 2, 3, 'found', 5, 6]);
 * let found = false;
 *
-* walk(structure, null, (element, level, edge) => {
+* walk(structure, null, (element, level, edge, state) => {
 *   if (element.type === 'single' &&
 *       element.cbor.type === MajorType.Text &&
 *       element.cbor.value === 'found') {
@@ -6040,7 +6016,7 @@ let EdgeType = /* @__PURE__ */ function(EdgeType$1) {
 * ```
 */
 const walk = (cbor$1, initialState, visitor) => {
-	return walkInternal(cbor$1, 0, { type: EdgeType.None }, initialState, visitor);
+	walkInternal(cbor$1, 0, { type: EdgeType.None }, initialState, visitor);
 };
 /**
 * Internal recursive walk implementation.
@@ -6524,7 +6500,7 @@ const attachMethods = (obj) => {
 			return this.value;
 		},
 		walk(initialState, visitor) {
-			return walk(this, initialState, visitor);
+			walk(this, initialState, visitor);
 		},
 		validateTag(expectedTags) {
 			if (this.type !== MajorType.Tagged) throw new CborError({ type: "WrongType" });
@@ -6660,6 +6636,16 @@ var CBORError = class extends URError {
 	}
 };
 /**
+* Error type for UR decoder errors.
+* Matches Rust's Error::UR(String) variant.
+*/
+var URDecodeError = class extends URError {
+	constructor(message) {
+		super(`UR decoder error (${message})`);
+		this.name = "URDecodeError";
+	}
+};
+/**
 * Helper function to check if a result is an error.
 */
 function isError(result) {
@@ -6688,13 +6674,6 @@ function isValidURType(urType) {
 	return Array.from(urType).every((char) => isURTypeChar(char));
 }
 /**
-* Validates and returns a UR type, or throws an error if invalid.
-*/
-function validateURType(urType) {
-	if (!isValidURType(urType)) throw new InvalidTypeError();
-	return urType;
-}
-/**
 * Bytewords for encoding/decoding bytes as words.
 * See: https://github.com/BlockchainCommons/Research/blob/master/papers/bcr-2020-004-bytewords.md
 */
@@ -8122,14 +8101,6 @@ var MultipartEncoder = class {
 		this._fountainEncoder = new FountainEncoder(ur.cbor().toData(), maxFragmentLen);
 	}
 	/**
-	* Returns whether the message fits in a single part.
-	*
-	* For single-part messages, consider using UR.string() directly.
-	*/
-	isSinglePart() {
-		return this._fountainEncoder.isSinglePart();
-	}
-	/**
 	* Gets the next part of the encoding.
 	*
 	* Parts 1 through seqLen are "pure" fragments containing one piece each.
@@ -8187,22 +8158,6 @@ var MultipartEncoder = class {
 	partsCount() {
 		return this._fountainEncoder.seqLen;
 	}
-	/**
-	* 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() {
-		return this._fountainEncoder.isComplete();
-	}
-	/**
-	* Resets the encoder to start from the beginning.
-	*/
-	reset() {
-		this._currentIndex = 0;
-		this._fountainEncoder.reset();
-	}
 };
 
 //#endregion
@@ -8313,24 +8268,8 @@ var MultipartDecoder = class {
 	message() {
 		return this._decodedMessage;
 	}
-	/**
-	* Returns the decoding progress as a fraction (0 to 1).
-	*/
-	progress() {
-		if (this._decodedMessage !== null) return 1;
-		if (this._fountainDecoder === null) return 0;
-		return this._fountainDecoder.progress();
-	}
-	/**
-	* Resets the decoder to receive a new message.
-	*/
-	reset() {
-		this._urType = null;
-		this._fountainDecoder = null;
-		this._decodedMessage = null;
-	}
 };
 
 //#endregion
-export { BYTEMOJIS, BYTEWORDS, BYTEWORDS_MAP, BytewordsError, BytewordsStyle, CBORError, FountainDecoder, FountainEncoder, InvalidSchemeError, InvalidTypeError, MINIMAL_BYTEWORDS_MAP, MultipartDecoder, MultipartEncoder, NotSinglePartError, TypeUnspecifiedError, UR, 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, TypeUnspecifiedError, UR, URDecodeError, URError, URType, UnexpectedTypeError, decodeBytewords, encodeBytemojisIdentifier, encodeBytewords, encodeBytewordsIdentifier, isError, isURCodable, isURDecodable, isUREncodable };
 //# sourceMappingURL=index.mjs.map