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

package/dist/index.iife.js

@@ -4900,7 +4900,13 @@ var bctsUniformResources = (function(exports) {
 		/**
 		* 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
@@ -4909,9 +4915,13 @@ var bctsUniformResources = (function(exports) {
 		* ```
 		*/
 		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.
@@ -4949,21 +4959,6 @@ var bctsUniformResources = (function(exports) {
 			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;
@@ -4987,30 +4982,6 @@ var bctsUniformResources = (function(exports) {
 			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.
 		*
@@ -5373,11 +5344,17 @@ var bctsUniformResources = (function(exports) {
 	}
 	/**
 	* 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) {
@@ -6008,21 +5985,20 @@ var bctsUniformResources = (function(exports) {
 	* @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
@@ -6031,7 +6007,7 @@ var bctsUniformResources = (function(exports) {
 	* 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') {
@@ -6043,7 +6019,7 @@ var bctsUniformResources = (function(exports) {
 	* ```
 	*/
 	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.
@@ -6527,7 +6503,7 @@ var bctsUniformResources = (function(exports) {
 				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" });
@@ -6663,6 +6639,16 @@ var bctsUniformResources = (function(exports) {
 		}
 	};
 	/**
+	* 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) {
@@ -6691,13 +6677,6 @@ var bctsUniformResources = (function(exports) {
 		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
 	*/
@@ -8125,14 +8104,6 @@ var bctsUniformResources = (function(exports) {
 			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.
@@ -8190,22 +8161,6 @@ var bctsUniformResources = (function(exports) {
 		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
@@ -8316,48 +8271,25 @@ var bctsUniformResources = (function(exports) {
 		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
 exports.BYTEMOJIS = BYTEMOJIS;
 exports.BYTEWORDS = BYTEWORDS;
-exports.BYTEWORDS_MAP = BYTEWORDS_MAP;
 exports.BytewordsError = BytewordsError;
 exports.BytewordsStyle = BytewordsStyle;
 exports.CBORError = CBORError;
-exports.FountainDecoder = FountainDecoder;
-exports.FountainEncoder = FountainEncoder;
 exports.InvalidSchemeError = InvalidSchemeError;
 exports.InvalidTypeError = InvalidTypeError;
-exports.MINIMAL_BYTEWORDS_MAP = MINIMAL_BYTEWORDS_MAP;
 exports.MultipartDecoder = MultipartDecoder;
 exports.MultipartEncoder = MultipartEncoder;
 exports.NotSinglePartError = NotSinglePartError;
 exports.TypeUnspecifiedError = TypeUnspecifiedError;
 exports.UR = UR;
+exports.URDecodeError = URDecodeError;
 exports.URError = URError;
 exports.URType = URType;
 exports.UnexpectedTypeError = UnexpectedTypeError;
-exports.Xoshiro256 = Xoshiro256;
-exports.chooseFragments = chooseFragments;
-exports.crc32 = crc32;
-exports.createSeed = createSeed;
 exports.decodeBytewords = decodeBytewords;
 exports.encodeBytemojisIdentifier = encodeBytemojisIdentifier;
 exports.encodeBytewords = encodeBytewords;
@@ -8366,12 +8298,6 @@ exports.isError = isError;
 exports.isURCodable = isURCodable;
 exports.isURDecodable = isURDecodable;
 exports.isUREncodable = isUREncodable;
-exports.isURTypeChar = isURTypeChar;
-exports.isValidURType = isValidURType;
-exports.mixFragments = mixFragments;
-exports.splitMessage = splitMessage;
-exports.validateURType = validateURType;
-exports.xorBytes = xorBytes;
 return exports;
 })({});
 //# sourceMappingURL=index.iife.js.map