@hot-updater/plugin-core 0.36.7 → 1.0.0-rc.0

package/dist/node_modules/.pnpm/verkit@0.3.2/node_modules/verkit/dist/index.mjs

@@ -0,0 +1,341 @@
+//#region ../../node_modules/.pnpm/verkit@0.3.2/node_modules/verkit/dist/index.js
+const LETTER_DASH_NUMBER = "[a-zA-Z0-9-]";
+const NUMERIC_IDENTIFIER = String.raw`0|[1-9]\d*`;
+const NUMERIC_IDENTIFIER_LOOSE = String.raw`\d+`;
+const NON_NUMERIC_IDENTIFIER = String.raw`\d*[a-zA-Z-]${LETTER_DASH_NUMBER}*`;
+const MAIN_VERSION = String.raw`(${NUMERIC_IDENTIFIER})\.(${NUMERIC_IDENTIFIER})\.(${NUMERIC_IDENTIFIER})`;
+const MAIN_VERSION_LOOSE = String.raw`(${NUMERIC_IDENTIFIER_LOOSE})\.(${NUMERIC_IDENTIFIER_LOOSE})\.(${NUMERIC_IDENTIFIER_LOOSE})`;
+const PRERELEASE_IDENTIFIER = `(?:${NON_NUMERIC_IDENTIFIER}|${NUMERIC_IDENTIFIER})`;
+const PRERELEASE_IDENTIFIER_LOOSE = `(?:${NON_NUMERIC_IDENTIFIER}|${NUMERIC_IDENTIFIER_LOOSE})`;
+const PRERELEASE = String.raw`(?:-(${PRERELEASE_IDENTIFIER}(?:\.${PRERELEASE_IDENTIFIER})*))`;
+const PRERELEASE_LOOSE = String.raw`(?:-?(${PRERELEASE_IDENTIFIER_LOOSE}(?:\.${PRERELEASE_IDENTIFIER_LOOSE})*))`;
+const BUILD_IDENTIFIER = `${LETTER_DASH_NUMBER}+`;
+const BUILD = String.raw`(?:\+(${BUILD_IDENTIFIER}(?:\.${BUILD_IDENTIFIER})*))`;
+const FULL_PLAIN = `v?${MAIN_VERSION}${PRERELEASE}?${BUILD}?`;
+const LOOSE_PLAIN = String.raw`[v=\s]*${MAIN_VERSION_LOOSE}${PRERELEASE_LOOSE}?${BUILD}?`;
+const GREATER_LESS_THAN = "((?:<|>)?=?)";
+const XRANGE_IDENTIFIER = String.raw`${NUMERIC_IDENTIFIER}|x|X|\*`;
+const XRANGE_IDENTIFIER_LOOSE = String.raw`${NUMERIC_IDENTIFIER_LOOSE}|x|X|\*`;
+const XRANGE_PLAIN = String.raw`[v=\s]*(${XRANGE_IDENTIFIER})(?:\.(${XRANGE_IDENTIFIER})(?:\.(${XRANGE_IDENTIFIER})(?:${PRERELEASE})?${BUILD}?)?)?`;
+const XRANGE_PLAIN_LOOSE = String.raw`[v=\s]*(${XRANGE_IDENTIFIER_LOOSE})(?:\.(${XRANGE_IDENTIFIER_LOOSE})(?:\.(${XRANGE_IDENTIFIER_LOOSE})(?:${PRERELEASE_LOOSE})?${BUILD}?)?)?`;
+const LONE_TILDE = "(?:~>?)";
+const LONE_CARET = String.raw`(?:\^)`;
+const COERCE_PLAIN = String.raw`(^|[^\d])(\d{1,${16}})(?:\.(\d{1,${16}}))?(?:\.(\d{1,${16}}))?`;
+const COERCE = String.raw`${COERCE_PLAIN}(?:$|[^\d])`;
+const COERCE_FULL = String.raw`${COERCE_PLAIN}(?:${PRERELEASE})?(?:${BUILD})?(?:$|[^\d])`;
+function makeSafeRegexSource(source) {
+	const replacements = [
+		[String.raw`\s`, 1],
+		[String.raw`\d`, 256],
+		[LETTER_DASH_NUMBER, 250]
+	];
+	for (const [token, maximum] of replacements) source = source.split(`${token}*`).join(`${token}{0,${maximum}}`).split(`${token}+`).join(`${token}{1,${maximum}}`);
+	return source;
+}
+function safeRegex(source, flags) {
+	return new RegExp(makeSafeRegexSource(source), flags);
+}
+const NUMERIC$1 = /^\d+$/;
+function compareIdentifiers(left, right) {
+	if (typeof left === "number" && typeof right === "number") return left === right ? 0 : left < right ? -1 : 1;
+	const leftNumeric = NUMERIC$1.test(String(left));
+	const rightNumeric = NUMERIC$1.test(String(right));
+	const normalizedLeft = leftNumeric ? Number(left) : left;
+	const normalizedRight = rightNumeric ? Number(right) : right;
+	return normalizedLeft === normalizedRight ? 0 : leftNumeric && !rightNumeric ? -1 : rightNumeric && !leftNumeric ? 1 : normalizedLeft < normalizedRight ? -1 : 1;
+}
+const FULL = safeRegex(`^${FULL_PLAIN}$`);
+const LOOSE = safeRegex(`^${LOOSE_PLAIN}$`);
+safeRegex(`^${PRERELEASE}$`);
+safeRegex(`^${PRERELEASE_LOOSE}$`);
+const COERCE_EXACT = safeRegex(COERCE);
+const COERCE_FULL_EXACT = safeRegex(COERCE_FULL);
+const NUMERIC = /^\d+$/;
+function formatComparableVersion(version) {
+	const base = `${version.major}.${version.minor}.${version.patch}`;
+	return version.prerelease?.length ? `${base}-${version.prerelease.join(".")}` : base;
+}
+function formatFullVersion(version) {
+	const comparable = formatComparableVersion(version);
+	return version.build?.length ? `${comparable}+${version.build.join(".")}` : comparable;
+}
+function parse(version, options = {}) {
+	if (typeof version !== "string") return version;
+	if (version.length > 256) throw new TypeError(`Version exceeds the maximum length of 256 characters`);
+	const match = version.trim().match(options.loose ? LOOSE : FULL);
+	if (!match) throw new TypeError(`Invalid version syntax: ${version}`);
+	const major = Number(match[1]);
+	const minor = Number(match[2]);
+	const patch = Number(match[3]);
+	if (major > Number.MAX_SAFE_INTEGER || major < 0) throw new TypeError(`Invalid major version: ${match[1]}`);
+	if (minor > Number.MAX_SAFE_INTEGER || minor < 0) throw new TypeError(`Invalid minor version: ${match[2]}`);
+	if (patch > Number.MAX_SAFE_INTEGER || patch < 0) throw new TypeError(`Invalid patch version: ${match[3]}`);
+	const prerelease = match[4] ? match[4].split(".").map((identifier) => {
+		if (NUMERIC.test(identifier)) {
+			const numeric = Number(identifier);
+			if (numeric >= 0 && numeric < Number.MAX_SAFE_INTEGER) return numeric;
+		}
+		return identifier;
+	}) : void 0;
+	return {
+		build: match[5]?.split("."),
+		major,
+		minor,
+		patch,
+		prerelease
+	};
+}
+function tryParse(version, options = {}) {
+	try {
+		return parse(version, options);
+	} catch {
+		return null;
+	}
+}
+function compareMainParsed(left, right) {
+	return left.major === right.major ? left.minor === right.minor ? left.patch === right.patch ? 0 : left.patch < right.patch ? -1 : 1 : left.minor < right.minor ? -1 : 1 : left.major < right.major ? -1 : 1;
+}
+function comparePrereleaseParsed(left, right) {
+	const leftPrerelease = left.prerelease;
+	const rightPrerelease = right.prerelease;
+	if (leftPrerelease?.length && !rightPrerelease?.length) return -1;
+	if (!leftPrerelease?.length && rightPrerelease?.length) return 1;
+	if (!leftPrerelease?.length && !rightPrerelease?.length) return 0;
+	for (let index = 0;; index++) {
+		const leftIdentifier = leftPrerelease?.[index];
+		const rightIdentifier = rightPrerelease?.[index];
+		if (leftIdentifier === void 0 && rightIdentifier === void 0) return 0;
+		if (rightIdentifier === void 0) return 1;
+		if (leftIdentifier === void 0) return -1;
+		if (leftIdentifier !== rightIdentifier) return compareIdentifiers(leftIdentifier, rightIdentifier);
+	}
+}
+function compareParsed(left, right) {
+	return compareMainParsed(left, right) || comparePrereleaseParsed(left, right);
+}
+function coerceParsedVersion(value, options = {}) {
+	if (typeof value === "object") return value;
+	const input = typeof value === "number" ? String(value) : value;
+	if (typeof input !== "string") return null;
+	let match = null;
+	if (options.rtl) {
+		const expression = safeRegex(options.includePrerelease ? COERCE_FULL : COERCE, "g");
+		let next;
+		while ((next = expression.exec(input)) && (!match || match.index + match[0].length !== input.length)) {
+			if (!match || next.index + next[0].length !== match.index + match[0].length) match = next;
+			expression.lastIndex = next.index + next[1].length + next[2].length;
+		}
+	} else match = (options.includePrerelease ? COERCE_FULL_EXACT : COERCE_EXACT).exec(input);
+	if (!match) return null;
+	const major = match[2];
+	return tryParse(`${major}.${match[3] || "0"}.${match[4] || "0"}${options.includePrerelease && match[5] ? `-${match[5]}` : ""}${options.includePrerelease && match[6] ? `+${match[6]}` : ""}`, options);
+}
+const STRICT_COMPARATOR = safeRegex(String.raw`^${GREATER_LESS_THAN}\s*(${FULL_PLAIN})$|^$`);
+const LOOSE_COMPARATOR$1 = safeRegex(String.raw`^${GREATER_LESS_THAN}\s*(${LOOSE_PLAIN})$|^$`);
+function parseComparator(comparator, options = {}) {
+	const normalized = comparator.trim().replaceAll(/\s+/g, " ");
+	const match = normalized.match(options.loose ? LOOSE_COMPARATOR$1 : STRICT_COMPARATOR);
+	if (!match) throw new TypeError(`Invalid comparator: ${normalized}`);
+	const operator = match[1] === "=" ? "" : match[1] || "";
+	const version = match[2] ? parse(match[2], options) : null;
+	return {
+		operator,
+		options,
+		value: version ? `${operator}${formatComparableVersion(version)}` : "",
+		version
+	};
+}
+function testParsedComparator(comparator, version) {
+	if (!comparator.version) return true;
+	const comparison = compareParsed(version, comparator.version);
+	switch (comparator.operator) {
+		case "": return comparison === 0;
+		case ">": return comparison > 0;
+		case ">=": return comparison >= 0;
+		case "<": return comparison < 0;
+		case "<=": return comparison <= 0;
+	}
+}
+function comparatorAllowsPrerelease(comparator, version) {
+	const allowed = comparator.version;
+	return allowed !== null && !!allowed.prerelease?.length && allowed.major === version.major && allowed.minor === version.minor && allowed.patch === version.patch;
+}
+function testComparatorSet(set, version, options) {
+	if (set.some((comparator) => !testParsedComparator(comparator, version))) return false;
+	return !version.prerelease?.length || !!options.includePrerelease || set.some((comparator) => comparatorAllowsPrerelease(comparator, version));
+}
+function compare(left, right, options = {}) {
+	return compareParsed(parse(left, options), parse(right, options));
+}
+const BUILD_STRIP = new RegExp(BUILD, "g");
+const BUILD_SAFE = safeRegex(BUILD);
+const STRICT_HYPHEN = safeRegex(String.raw`^\s*(${XRANGE_PLAIN})\s+-\s+(${XRANGE_PLAIN})\s*$`);
+const LOOSE_HYPHEN = safeRegex(String.raw`^\s*(${XRANGE_PLAIN_LOOSE})\s+-\s+(${XRANGE_PLAIN_LOOSE})\s*$`);
+const COMPARATOR_TRIM = safeRegex(String.raw`(\s*)${GREATER_LESS_THAN}\s*(${LOOSE_PLAIN}|${XRANGE_PLAIN})`, "g");
+const TILDE_TRIM = safeRegex(String.raw`(\s*)${LONE_TILDE}\s+`, "g");
+const CARET_TRIM = safeRegex(String.raw`(\s*)${LONE_CARET}\s+`, "g");
+const STRICT_TILDE = safeRegex(`^${LONE_TILDE}${XRANGE_PLAIN}$`);
+const LOOSE_TILDE = safeRegex(`^${LONE_TILDE}${XRANGE_PLAIN_LOOSE}$`);
+const STRICT_CARET = safeRegex(`^${LONE_CARET}${XRANGE_PLAIN}$`);
+const LOOSE_CARET = safeRegex(`^${LONE_CARET}${XRANGE_PLAIN_LOOSE}$`);
+const STRICT_XRANGE = safeRegex(String.raw`^${GREATER_LESS_THAN}\s*${XRANGE_PLAIN}$`);
+const LOOSE_XRANGE = safeRegex(String.raw`^${GREATER_LESS_THAN}\s*${XRANGE_PLAIN_LOOSE}$`);
+const STAR = safeRegex(String.raw`(<|>)?=?\s*\*`);
+const GTE_ZERO = /^\s*>=\s*0\.0\.0\s*$/;
+const GTE_ZERO_PRERELEASE = /^\s*>=\s*0\.0\.0-0\s*$/;
+const LOOSE_COMPARATOR = safeRegex(String.raw`^${GREATER_LESS_THAN}\s*(${LOOSE_PLAIN})$|^$`);
+function isWildcard(value) {
+	return !value || String(value).toLowerCase() === "x" || String(value) === "*";
+}
+function hasInvalidWildcardOrder(major, minor, patch) {
+	return isWildcard(major) && !isWildcard(minor) || isWildcard(minor) && Boolean(patch) && !isWildcard(patch);
+}
+function replaceTilde(comparator, options) {
+	const expression = options.loose ? LOOSE_TILDE : STRICT_TILDE;
+	const lowerPrerelease = options.includePrerelease ? "-0" : "";
+	return comparator.replace(expression, (_match, major, minor, patch, prerelease) => {
+		if (isWildcard(major)) return "";
+		if (isWildcard(minor)) return `>=${major}.0.0${lowerPrerelease} <${Number(major) + 1}.0.0-0`;
+		if (isWildcard(patch)) return `>=${major}.${minor}.0${lowerPrerelease} <${major}.${Number(minor) + 1}.0-0`;
+		return prerelease ? `>=${major}.${minor}.${patch}-${prerelease} <${major}.${Number(minor) + 1}.0-0` : `>=${major}.${minor}.${patch} <${major}.${Number(minor) + 1}.0-0`;
+	});
+}
+function replaceTildes(comparator, options) {
+	return comparator.trim().split(/\s+/).map((part) => replaceTilde(part, options)).join(" ");
+}
+function replaceCaret(comparator, options) {
+	const expression = options.loose ? LOOSE_CARET : STRICT_CARET;
+	const lowerPrerelease = options.includePrerelease ? "-0" : "";
+	return comparator.replace(expression, (_match, major, minor, patch, prerelease) => {
+		if (isWildcard(major)) return "";
+		if (isWildcard(minor)) return `>=${major}.0.0${lowerPrerelease} <${Number(major) + 1}.0.0-0`;
+		if (isWildcard(patch)) return major === "0" ? `>=${major}.${minor}.0${lowerPrerelease} <${major}.${Number(minor) + 1}.0-0` : `>=${major}.${minor}.0${lowerPrerelease} <${Number(major) + 1}.0.0-0`;
+		if (prerelease) return major === "0" ? minor === "0" ? `>=${major}.${minor}.${patch}-${prerelease} <${major}.${minor}.${Number(patch) + 1}-0` : `>=${major}.${minor}.${patch}-${prerelease} <${major}.${Number(minor) + 1}.0-0` : `>=${major}.${minor}.${patch}-${prerelease} <${Number(major) + 1}.0.0-0`;
+		return major === "0" ? minor === "0" ? `>=${major}.${minor}.${patch} <${major}.${minor}.${Number(patch) + 1}-0` : `>=${major}.${minor}.${patch} <${major}.${Number(minor) + 1}.0-0` : `>=${major}.${minor}.${patch} <${Number(major) + 1}.0.0-0`;
+	});
+}
+function replaceCarets(comparator, options) {
+	return comparator.trim().split(/\s+/).map((part) => replaceCaret(part, options)).join(" ");
+}
+function replaceXRange(comparator, options) {
+	const expression = options.loose ? LOOSE_XRANGE : STRICT_XRANGE;
+	return comparator.trim().replace(expression, (match, rawOperator, rawMajor, rawMinor, rawPatch) => {
+		let operator = rawOperator;
+		let major = rawMajor;
+		let minor = rawMinor;
+		let patch = rawPatch;
+		if (hasInvalidWildcardOrder(String(major), minor === void 0 ? void 0 : String(minor), patch === void 0 ? void 0 : String(patch))) return comparator;
+		const wildcardMajor = isWildcard(major);
+		const wildcardMinor = wildcardMajor || isWildcard(minor);
+		const wildcardPatch = wildcardMinor || isWildcard(patch);
+		if (operator === "=" && wildcardPatch) operator = "";
+		if (wildcardMajor) return operator === ">" || operator === "<" ? "<0.0.0-0" : "*";
+		let prerelease = options.includePrerelease ? "-0" : "";
+		if (operator && wildcardPatch) {
+			if (wildcardMinor) minor = 0;
+			patch = 0;
+			if (operator === ">") {
+				operator = ">=";
+				if (wildcardMinor) {
+					major = Number(major) + 1;
+					minor = 0;
+				} else minor = Number(minor) + 1;
+			} else if (operator === "<=") {
+				operator = "<";
+				if (wildcardMinor) major = Number(major) + 1;
+				else minor = Number(minor) + 1;
+			}
+			if (operator === "<") prerelease = "-0";
+			return `${operator}${major}.${minor}.${patch}${prerelease}`;
+		}
+		if (wildcardMinor) return `>=${major}.0.0${prerelease} <${Number(major) + 1}.0.0-0`;
+		if (wildcardPatch) return `>=${major}.${minor}.0${prerelease} <${major}.${Number(minor) + 1}.0-0`;
+		return match;
+	});
+}
+function replaceXRanges(comparator, options) {
+	return comparator.split(/\s+/).map((part) => replaceXRange(part, options)).join(" ");
+}
+function replaceHyphenRange(range, options) {
+	const expression = options.loose ? LOOSE_HYPHEN : STRICT_HYPHEN;
+	return range.replace(expression, (_match, rawFrom, fromMajor, fromMinor, fromPatch, fromPrerelease, _fromBuild, rawTo, toMajor, toMinor, toPatch, toPrerelease) => {
+		let from = rawFrom;
+		let to = rawTo;
+		if (isWildcard(fromMajor)) from = "";
+		else if (isWildcard(fromMinor)) from = `>=${fromMajor}.0.0${options.includePrerelease ? "-0" : ""}`;
+		else if (isWildcard(fromPatch)) from = `>=${fromMajor}.${fromMinor}.0${options.includePrerelease ? "-0" : ""}`;
+		else if (fromPrerelease) from = `>=${from}`;
+		else from = `>=${from}${options.includePrerelease ? "-0" : ""}`;
+		if (isWildcard(toMajor)) to = "";
+		else if (isWildcard(toMinor)) to = `<${Number(toMajor) + 1}.0.0-0`;
+		else if (isWildcard(toPatch)) to = `<${toMajor}.${Number(toMinor) + 1}.0-0`;
+		else if (toPrerelease) to = `<=${toMajor}.${toMinor}.${toPatch}-${toPrerelease}`;
+		else if (options.includePrerelease) to = `<${toMajor}.${toMinor}.${Number(toPatch) + 1}-0`;
+		else to = `<=${to}`;
+		return `${from} ${to}`.trim();
+	});
+}
+function expandComparator(comparator, options) {
+	return replaceXRanges(replaceTildes(replaceCarets(comparator.replace(BUILD_SAFE, ""), options), options), options).trim().replace(STAR, "");
+}
+function parseSimpleRange(input, options) {
+	let parts = replaceHyphenRange(input.replace(BUILD_STRIP, ""), options).replace(COMPARATOR_TRIM, "$1$2$3").replace(TILDE_TRIM, "$1~").replace(CARET_TRIM, "$1^").split(" ").map((part) => expandComparator(part, options)).join(" ").split(/\s+/).map((part) => part.trim().replace(options.includePrerelease ? GTE_ZERO_PRERELEASE : GTE_ZERO, ""));
+	if (options.loose) parts = parts.filter((part) => LOOSE_COMPARATOR.test(part));
+	const unique = /* @__PURE__ */ new Map();
+	for (const comparator of parts.map((part) => parseComparator(part, options))) {
+		if (comparator.value === "<0.0.0-0") return [comparator];
+		unique.set(comparator.value, comparator);
+	}
+	if (unique.size > 1) unique.delete("");
+	return [...unique.values()];
+}
+function parseRange(range, options = {}) {
+	if (typeof range !== "string") return range;
+	const parsedOptions = { ...options };
+	const raw = range.trim().replaceAll(/\s+/g, " ");
+	let sets = raw.split("||").map((part) => parseSimpleRange(part.trim(), parsedOptions)).filter((set) => set.length);
+	if (!sets.length) throw new TypeError(`Range contains no valid comparator sets: ${raw}`);
+	if (sets.length > 1) {
+		const first = sets[0];
+		sets = sets.filter((set) => set[0]?.value !== "<0.0.0-0");
+		if (!sets.length) sets = [first];
+		else if (sets.length > 1) {
+			const any = sets.find((set) => set.length === 1 && set[0]?.value === "");
+			if (any) sets = [any];
+		}
+	}
+	return {
+		normalized: sets.map((set) => set.map((comparator) => comparator.value).join(" ")).join("||"),
+		options: parsedOptions,
+		raw,
+		sets
+	};
+}
+function tryParseRange(range, options = {}) {
+	try {
+		return parseRange(range, options);
+	} catch {
+		return null;
+	}
+}
+function testParsedRange(range, version) {
+	return range.sets.some((set) => testComparatorSet(set, version, range.options));
+}
+function testRangeVersion(range, version) {
+	const parsed = tryParse(version, range.options);
+	return parsed ? testParsedRange(range, parsed) : false;
+}
+function satisfies(version, range, options = {}) {
+	const parsed = tryParseRange(range, options);
+	return parsed ? testRangeVersion(parsed, version) : false;
+}
+function normalize(version, options = {}) {
+	const parsed = tryParse(version, options);
+	return parsed ? formatComparableVersion(parsed) : null;
+}
+function coerce(value, options = {}) {
+	const parsed = coerceParsedVersion(value, options);
+	return parsed ? formatFullVersion(parsed) : null;
+}
+//#endregion
+export { coerce, compare, normalize, parseRange, satisfies };

package/dist/paginateBundles.d.cts

@@ -1,18 +1,20 @@
-import { Bundle, DatabaseBundleCursor, DatabaseBundleQueryOrder, Paginated } from "./types/index.cjs";
+import { DatabaseBundleCursor, DatabaseBundleQueryOrder, Paginated } from "./types/index.cjs";
 
 //#region src/paginateBundles.d.ts
-declare function paginateBundles({
+declare function paginateBundles<TBundle extends {
+  readonly id: string;
+}>({
   bundles,
   limit,
   offset,
   cursor,
   orderBy
 }: {
-  bundles: Bundle[];
+  bundles: readonly TBundle[];
   limit: number;
   offset?: number;
   cursor?: DatabaseBundleCursor;
   orderBy?: DatabaseBundleQueryOrder;
-}): Paginated<Bundle[]>;
+}): Paginated<TBundle[]>;
 //#endregion
 export { paginateBundles };

package/dist/paginateBundles.d.mts

@@ -1,18 +1,20 @@
-import { Bundle, DatabaseBundleCursor, DatabaseBundleQueryOrder, Paginated } from "./types/index.mjs";
+import { DatabaseBundleCursor, DatabaseBundleQueryOrder, Paginated } from "./types/index.mjs";
 
 //#region src/paginateBundles.d.ts
-declare function paginateBundles({
+declare function paginateBundles<TBundle extends {
+  readonly id: string;
+}>({
   bundles,
   limit,
   offset,
   cursor,
   orderBy
 }: {
-  bundles: Bundle[];
+  bundles: readonly TBundle[];
   limit: number;
   offset?: number;
   cursor?: DatabaseBundleCursor;
   orderBy?: DatabaseBundleQueryOrder;
-}): Paginated<Bundle[]>;
+}): Paginated<TBundle[]>;
 //#endregion
 export { paginateBundles };

package/dist/parseStorageUri.cjs

@@ -1,41 +1,57 @@
 //#region src/parseStorageUri.ts
-const decodeStorageObjectKey = (key) => {
-	try {
-		return decodeURIComponent(key);
-	} catch {
-		return key;
-	}
+const PROTOCOL_PATTERN = /^[a-z][a-z\d+.-]*$/;
+const INVALID_BUCKET_CHARACTER_PATTERN = /[\s/?#%@:\\]/;
+const assertProtocol = (protocol) => {
+	if (!PROTOCOL_PATTERN.test(protocol)) throw new Error(`Invalid storage URI protocol: ${protocol}`);
+};
+const assertBucket = (bucket) => {
+	if (bucket.length === 0 || INVALID_BUCKET_CHARACTER_PATTERN.test(bucket)) throw new Error(`Invalid storage URI bucket: ${bucket}`);
+};
+const getKeySegments = (key) => {
+	if (key.length === 0) throw new Error("Invalid storage URI key: key must not be empty");
+	const segments = key.split("/");
+	if (segments.some((segment) => segment.length === 0 || segment === "." || segment === ".." || segment.includes("\\"))) throw new Error("Invalid storage URI key: segments must not be empty, '.', '..' or contain '\\'");
+	return segments;
 };
 /**
-* Parses a storage URI and validates the protocol.
-*
-* @param storageUri - The storage URI to parse (e.g., "s3://bucket/path/to/file")
-* @param expectedProtocol - The expected protocol without colon (e.g., "s3", "r2", "gs")
-* @returns Parsed storage URI components
-* @throws Error if the URI is invalid or protocol doesn't match
+* Creates a hierarchical storage identifier in the form
+* `protocol://bucket/slash-separated-encoded-key`.
+*/
+const createStorageUri = ({ protocol, bucket, key }) => {
+	assertProtocol(protocol);
+	assertBucket(bucket);
+	return `${protocol}://${bucket}/${getKeySegments(key).map(encodeURIComponent).join("/")}`;
+};
+/**
+* Parses a hierarchical storage identifier and decodes each key segment.
 *
-* @example
-* ```typescript
-* const { bucket, key } = parseStorageUri("s3://my-bucket/path/to/file.zip", "s3");
-* // bucket: "my-bucket"
-* // key: "path/to/file.zip"
-* ```
+* Search parameters and fragments are not part of a storage identifier.
 */
 function parseStorageUri(storageUri, expectedProtocol) {
+	assertProtocol(expectedProtocol);
+	if (storageUri.includes("?") || storageUri.includes("#")) throw new Error(`Invalid storage URI format: ${storageUri}`);
+	const match = /^([a-z][a-z\d+.-]*):\/\/([^/]+)\/(.*)$/.exec(storageUri);
+	if (!match) throw new Error(`Invalid storage URI format: ${storageUri}`);
+	const [, protocol, bucket, encodedKey] = match;
+	if (protocol !== expectedProtocol) throw new Error(`Invalid storage URI protocol. Expected ${expectedProtocol}, got ${protocol}`);
+	assertBucket(bucket);
+	let segments;
 	try {
-		const url = new URL(storageUri);
-		const protocol = url.protocol.replace(":", "");
-		if (protocol !== expectedProtocol) throw new Error(`Invalid storage URI protocol. Expected ${expectedProtocol}, got ${protocol}`);
-		return {
-			protocol,
-			bucket: url.hostname,
-			key: decodeStorageObjectKey(url.pathname.slice(1))
-		};
-	} catch (error) {
-		if (error instanceof TypeError) throw new Error(`Invalid storage URI format: ${storageUri}`);
-		throw error;
+		segments = getKeySegments(encodedKey).map((segment) => {
+			const decoded = decodeURIComponent(segment);
+			if (decoded.includes("/") || decoded.includes("\\")) throw new Error("encoded hierarchy separator");
+			if (encodeURIComponent(decoded) !== segment) throw new Error("non-canonical segment");
+			return decoded;
+		});
+	} catch {
+		throw new Error(`Invalid storage URI format: ${storageUri}`);
 	}
+	return {
+		protocol,
+		bucket,
+		key: segments.join("/")
+	};
 }
 //#endregion
-exports.decodeStorageObjectKey = decodeStorageObjectKey;
+exports.createStorageUri = createStorageUri;
 exports.parseStorageUri = parseStorageUri;

package/dist/parseStorageUri.d.cts

@@ -1,25 +1,28 @@
 //#region src/parseStorageUri.d.ts
 interface ParsedStorageUri {
-  protocol: string;
-  bucket: string;
-  key: string;
+  readonly protocol: string;
+  readonly bucket: string;
+  readonly key: string;
+}
+interface CreateStorageUriInput {
+  readonly protocol: string;
+  readonly bucket: string;
+  readonly key: string;
 }
-declare const decodeStorageObjectKey: (key: string) => string;
 /**
- * Parses a storage URI and validates the protocol.
- *
- * @param storageUri - The storage URI to parse (e.g., "s3://bucket/path/to/file")
- * @param expectedProtocol - The expected protocol without colon (e.g., "s3", "r2", "gs")
- * @returns Parsed storage URI components
- * @throws Error if the URI is invalid or protocol doesn't match
+ * Creates a hierarchical storage identifier in the form
+ * `protocol://bucket/slash-separated-encoded-key`.
+ */
+declare const createStorageUri: ({
+  protocol,
+  bucket,
+  key
+}: CreateStorageUriInput) => string;
+/**
+ * Parses a hierarchical storage identifier and decodes each key segment.
  *
- * @example
- * ```typescript
- * const { bucket, key } = parseStorageUri("s3://my-bucket/path/to/file.zip", "s3");
- * // bucket: "my-bucket"
- * // key: "path/to/file.zip"
- * ```
+ * Search parameters and fragments are not part of a storage identifier.
  */
 declare function parseStorageUri(storageUri: string, expectedProtocol: string): ParsedStorageUri;
 //#endregion
-export { ParsedStorageUri, decodeStorageObjectKey, parseStorageUri };
+export { CreateStorageUriInput, ParsedStorageUri, createStorageUri, parseStorageUri };

package/dist/parseStorageUri.d.mts

@@ -1,25 +1,28 @@
 //#region src/parseStorageUri.d.ts
 interface ParsedStorageUri {
-  protocol: string;
-  bucket: string;
-  key: string;
+  readonly protocol: string;
+  readonly bucket: string;
+  readonly key: string;
+}
+interface CreateStorageUriInput {
+  readonly protocol: string;
+  readonly bucket: string;
+  readonly key: string;
 }
-declare const decodeStorageObjectKey: (key: string) => string;
 /**
- * Parses a storage URI and validates the protocol.
- *
- * @param storageUri - The storage URI to parse (e.g., "s3://bucket/path/to/file")
- * @param expectedProtocol - The expected protocol without colon (e.g., "s3", "r2", "gs")
- * @returns Parsed storage URI components
- * @throws Error if the URI is invalid or protocol doesn't match
+ * Creates a hierarchical storage identifier in the form
+ * `protocol://bucket/slash-separated-encoded-key`.
+ */
+declare const createStorageUri: ({
+  protocol,
+  bucket,
+  key
+}: CreateStorageUriInput) => string;
+/**
+ * Parses a hierarchical storage identifier and decodes each key segment.
  *
- * @example
- * ```typescript
- * const { bucket, key } = parseStorageUri("s3://my-bucket/path/to/file.zip", "s3");
- * // bucket: "my-bucket"
- * // key: "path/to/file.zip"
- * ```
+ * Search parameters and fragments are not part of a storage identifier.
  */
 declare function parseStorageUri(storageUri: string, expectedProtocol: string): ParsedStorageUri;
 //#endregion
-export { ParsedStorageUri, decodeStorageObjectKey, parseStorageUri };
+export { CreateStorageUriInput, ParsedStorageUri, createStorageUri, parseStorageUri };

package/dist/parseStorageUri.mjs

@@ -1,40 +1,56 @@
 //#region src/parseStorageUri.ts
-const decodeStorageObjectKey = (key) => {
-	try {
-		return decodeURIComponent(key);
-	} catch {
-		return key;
-	}
+const PROTOCOL_PATTERN = /^[a-z][a-z\d+.-]*$/;
+const INVALID_BUCKET_CHARACTER_PATTERN = /[\s/?#%@:\\]/;
+const assertProtocol = (protocol) => {
+	if (!PROTOCOL_PATTERN.test(protocol)) throw new Error(`Invalid storage URI protocol: ${protocol}`);
+};
+const assertBucket = (bucket) => {
+	if (bucket.length === 0 || INVALID_BUCKET_CHARACTER_PATTERN.test(bucket)) throw new Error(`Invalid storage URI bucket: ${bucket}`);
+};
+const getKeySegments = (key) => {
+	if (key.length === 0) throw new Error("Invalid storage URI key: key must not be empty");
+	const segments = key.split("/");
+	if (segments.some((segment) => segment.length === 0 || segment === "." || segment === ".." || segment.includes("\\"))) throw new Error("Invalid storage URI key: segments must not be empty, '.', '..' or contain '\\'");
+	return segments;
 };
 /**
-* Parses a storage URI and validates the protocol.
-*
-* @param storageUri - The storage URI to parse (e.g., "s3://bucket/path/to/file")
-* @param expectedProtocol - The expected protocol without colon (e.g., "s3", "r2", "gs")
-* @returns Parsed storage URI components
-* @throws Error if the URI is invalid or protocol doesn't match
+* Creates a hierarchical storage identifier in the form
+* `protocol://bucket/slash-separated-encoded-key`.
+*/
+const createStorageUri = ({ protocol, bucket, key }) => {
+	assertProtocol(protocol);
+	assertBucket(bucket);
+	return `${protocol}://${bucket}/${getKeySegments(key).map(encodeURIComponent).join("/")}`;
+};
+/**
+* Parses a hierarchical storage identifier and decodes each key segment.
 *
-* @example
-* ```typescript
-* const { bucket, key } = parseStorageUri("s3://my-bucket/path/to/file.zip", "s3");
-* // bucket: "my-bucket"
-* // key: "path/to/file.zip"
-* ```
+* Search parameters and fragments are not part of a storage identifier.
 */
 function parseStorageUri(storageUri, expectedProtocol) {
+	assertProtocol(expectedProtocol);
+	if (storageUri.includes("?") || storageUri.includes("#")) throw new Error(`Invalid storage URI format: ${storageUri}`);
+	const match = /^([a-z][a-z\d+.-]*):\/\/([^/]+)\/(.*)$/.exec(storageUri);
+	if (!match) throw new Error(`Invalid storage URI format: ${storageUri}`);
+	const [, protocol, bucket, encodedKey] = match;
+	if (protocol !== expectedProtocol) throw new Error(`Invalid storage URI protocol. Expected ${expectedProtocol}, got ${protocol}`);
+	assertBucket(bucket);
+	let segments;
 	try {
-		const url = new URL(storageUri);
-		const protocol = url.protocol.replace(":", "");
-		if (protocol !== expectedProtocol) throw new Error(`Invalid storage URI protocol. Expected ${expectedProtocol}, got ${protocol}`);
-		return {
-			protocol,
-			bucket: url.hostname,
-			key: decodeStorageObjectKey(url.pathname.slice(1))
-		};
-	} catch (error) {
-		if (error instanceof TypeError) throw new Error(`Invalid storage URI format: ${storageUri}`);
-		throw error;
+		segments = getKeySegments(encodedKey).map((segment) => {
+			const decoded = decodeURIComponent(segment);
+			if (decoded.includes("/") || decoded.includes("\\")) throw new Error("encoded hierarchy separator");
+			if (encodeURIComponent(decoded) !== segment) throw new Error("non-canonical segment");
+			return decoded;
+		});
+	} catch {
+		throw new Error(`Invalid storage URI format: ${storageUri}`);
 	}
+	return {
+		protocol,
+		bucket,
+		key: segments.join("/")
+	};
 }
 //#endregion
-export { decodeStorageObjectKey, parseStorageUri };
+export { createStorageUri, parseStorageUri };