@fedify/uri-template 2.0.0-pr.475.1

package/dist/rfc6570.spec.cjs

@@ -0,0 +1,419 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_compile = require('./compile.cjs');
+const node_assert_strict = require_rolldown_runtime.__toESM(require("node:assert/strict"));
+const node_test = require_rolldown_runtime.__toESM(require("node:test"));
+
+//#region src/rfc6570.spec.ts
+(0, node_test.describe)("basic expansion", () => {
+	(0, node_test.test)("scalar", () => {
+		const t = require_compile.compile("{var}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "value" }), "value");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "va lue" }), "va%20lue");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "100%" }), "100%25");
+	});
+	(0, node_test.test)("list (no explode)", () => {
+		const t = require_compile.compile("{list}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ list: [
+			"red",
+			"green",
+			"blue"
+		] }), "red,green,blue");
+	});
+	(0, node_test.test)("map (no explode)", () => {
+		const t = require_compile.compile("{keys}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ keys: {
+			semi: ";",
+			dot: ".",
+			comma: ","
+		} }), "semi,%3B,dot,.,comma,%2C");
+	});
+	(0, node_test.test)("multiple vars", () => {
+		const t = require_compile.compile("{x,y}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ x: "1024" }), "1024");
+	});
+});
+(0, node_test.describe)("{+var} reserved expansion", () => {
+	(0, node_test.test)("{+var} allows reserved - basic", () => {
+		const t = require_compile.compile("{+var}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "value" }), "value");
+	});
+	(0, node_test.test)("{+var} allows reserved - percent encoding", () => {
+		const t = require_compile.compile("{+hello}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ hello: "Hello World!" }), "Hello%20World!");
+	});
+	(0, node_test.test)("{+var} allows reserved - already encoded", () => {
+		const t = require_compile.compile("{+half}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ half: "50%" }), "50%25");
+	});
+	(0, node_test.test)("{+var} allows reserved - base URL comparison", () => {
+		const t1 = require_compile.compile("{base}index");
+		const t2 = require_compile.compile("{+base}index");
+		const vars = { base: "http://example.com/home/" };
+		(0, node_assert_strict.deepStrictEqual)(t1.expand(vars), "http%3A%2F%2Fexample.com%2Fhome%2Findex");
+		(0, node_assert_strict.deepStrictEqual)(t2.expand(vars), "http://example.com/home/index");
+	});
+	(0, node_test.test)("{+var} allows reserved - empty value", () => {
+		const t = require_compile.compile("O{+empty}X");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ empty: "" }), "OX");
+	});
+	(0, node_test.test)("{+var} allows reserved - undefined value", () => {
+		const t = require_compile.compile("O{+undef}X");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ undef: void 0 }), "OX");
+	});
+	(0, node_test.test)("{+var} allows reserved - path", () => {
+		const t = require_compile.compile("{+path}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ path: "/foo/bar" }), "/foo/bar");
+	});
+	(0, node_test.test)("{+var} allows reserved - path appended", () => {
+		const t = require_compile.compile("{+path}/here");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ path: "/foo/bar" }), "/foo/bar/here");
+	});
+	(0, node_test.test)("{+var} allows reserved - in query", () => {
+		const t = require_compile.compile("here?ref={+path}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ path: "/foo/bar" }), "here?ref=/foo/bar");
+	});
+	(0, node_test.test)("{+var} allows reserved - mixed with normal var", () => {
+		const t = require_compile.compile("up{+path}{var}/here");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			path: "/foo/bar",
+			var: "value"
+		}), "up/foo/barvalue/here");
+	});
+	(0, node_test.test)("{+var} allows reserved - multiple vars", () => {
+		const t = require_compile.compile("{+x,hello,y}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			x: "1024",
+			hello: "Hello World!",
+			y: "768"
+		}), "1024,Hello%20World!,768");
+	});
+	(0, node_test.test)("{+var} allows reserved - multiple vars with path", () => {
+		const t = require_compile.compile("{+path,x}/here");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			path: "/foo/bar",
+			x: "1024"
+		}), "/foo/bar,1024/here");
+	});
+	(0, node_test.test)("{+var} allows reserved - prefix modifier", () => {
+		const t = require_compile.compile("{+path:6}/here");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ path: "/foo/bar" }), "/foo/b/here");
+	});
+	(0, node_test.test)("{+var} allows reserved - list", () => {
+		const t = require_compile.compile("{+list}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ list: [
+			"red",
+			"green",
+			"blue"
+		] }), "red,green,blue");
+	});
+	(0, node_test.test)("{+var} allows reserved - list explode", () => {
+		const t = require_compile.compile("{+list*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ list: [
+			"red",
+			"green",
+			"blue"
+		] }), "red,green,blue");
+	});
+	(0, node_test.test)("{+var} allows reserved - map", () => {
+		const t = require_compile.compile("{+keys}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ keys: {
+			semi: ";",
+			dot: ".",
+			comma: ","
+		} }), "semi,;,dot,.,comma,,");
+	});
+	(0, node_test.test)("{+var} allows reserved - map explode", () => {
+		const t = require_compile.compile("{+keys*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ keys: {
+			semi: ";",
+			dot: ".",
+			comma: ","
+		} }), "semi=;,dot=.,comma=,");
+	});
+});
+(0, node_test.describe)("{#var} fragment expansion", () => {
+	(0, node_test.test)("{#var} fragment", () => {
+		const t = require_compile.compile("{#frag}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ frag: "a b" }), "#a%20b");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ frag: "a/b?c#d" }), "#a/b?c%23d");
+	});
+});
+(0, node_test.describe)("{.var} label expansion", () => {
+	(0, node_test.test)("{.var} label - basic", () => {
+		const t = require_compile.compile("www{.domain}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ domain: "example" }), "www.example");
+	});
+	(0, node_test.test)("{.var} label - single variable", () => {
+		const t = require_compile.compile("{.who}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ who: "fred" }), ".fred");
+	});
+	(0, node_test.test)("{.var} label - same variable twice", () => {
+		const t = require_compile.compile("{.who,who}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ who: "fred" }), ".fred.fred");
+	});
+	(0, node_test.test)("{.var} label - mixed variables with encoding", () => {
+		const t = require_compile.compile("{.half,who}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			half: "50%",
+			who: "fred"
+		}), ".50%25.fred");
+	});
+	(0, node_test.test)("{.var} label - explode with multiple labels", () => {
+		const t = require_compile.compile("www{.dom*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ dom: ["example", "com"] }), "www.example.com");
+	});
+	(0, node_test.test)("{.var} label - with prefix", () => {
+		const t = require_compile.compile("X{.var}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "value" }), "X.value");
+	});
+	(0, node_test.test)("{.var} label - empty value", () => {
+		const t = require_compile.compile("X{.empty}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ empty: "" }), "X.");
+	});
+	(0, node_test.test)("{.var} label - undefined value", () => {
+		const t = require_compile.compile("X{.undef}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ undef: void 0 }), "X");
+	});
+	(0, node_test.test)("{.var} label - prefix modifier", () => {
+		const t = require_compile.compile("X{.var:3}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "value" }), "X.val");
+	});
+	(0, node_test.test)("{.var} label - list without explode", () => {
+		const t = require_compile.compile("X{.list}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ list: [
+			"red",
+			"green",
+			"blue"
+		] }), "X.red,green,blue");
+	});
+	(0, node_test.test)("{.var} label - list with explode", () => {
+		const t = require_compile.compile("X{.list*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ list: [
+			"red",
+			"green",
+			"blue"
+		] }), "X.red.green.blue");
+	});
+	(0, node_test.test)("{.var} label - map without explode", () => {
+		const t = require_compile.compile("X{.keys}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ keys: {
+			semi: ";",
+			dot: ".",
+			comma: ","
+		} }), "X.semi,%3B,dot,.,comma,%2C");
+	});
+	(0, node_test.test)("{.var} label - map with explode", () => {
+		const t = require_compile.compile("X{.keys*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ keys: {
+			semi: ";",
+			dot: ".",
+			comma: ","
+		} }), "X.semi=%3B.dot=..comma=%2C");
+	});
+	(0, node_test.test)("{.var} label - empty map without explode", () => {
+		const t = require_compile.compile("X{.empty_keys}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ empty_keys: {} }), "X");
+	});
+	(0, node_test.test)("{.var} label - empty map with explode", () => {
+		const t = require_compile.compile("X{.empty_keys*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ empty_keys: {} }), "X");
+	});
+});
+(0, node_test.describe)("path and query operators", () => {
+	(0, node_test.test)("{/var} path segment", () => {
+		const t = require_compile.compile("/users{/id}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ id: "a/b" }), "/users/a%2Fb");
+	});
+	(0, node_test.test)("{;x,y} matrix params", () => {
+		const t = require_compile.compile("/res{;x,y}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			x: "a b",
+			y: ""
+		}), "/res;x=a%20b;y");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			x: void 0,
+			y: void 0
+		}), "/res");
+	});
+	(0, node_test.test)("{?x,y} query", () => {
+		const t = require_compile.compile("/search{?q,lang}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			q: "a b",
+			lang: "en"
+		}), "/search?q=a%20b&lang=en");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			q: "",
+			lang: void 0
+		}), "/search?q=");
+	});
+	(0, node_test.test)("{&x,y} query continuation", () => {
+		const t = require_compile.compile("/search?q=init{&x,y}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			x: "1",
+			y: "2"
+		}), "/search?q=init&x=1&y=2");
+	});
+});
+(0, node_test.describe)("explode modifier", () => {
+	(0, node_test.test)("explode list", () => {
+		const t = require_compile.compile("/tags{;tags*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ tags: [
+			"red",
+			"green",
+			"blue"
+		] }), "/tags;tags=red;tags=green;tags=blue");
+	});
+	(0, node_test.test)("explode map", () => {
+		const t = require_compile.compile("{?keys*}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ keys: {
+			semi: ";",
+			dot: ".",
+			comma: ","
+		} }), "?semi=%3B&dot=.&comma=%2C");
+	});
+});
+(0, node_test.describe)("prefix modifier", () => {
+	(0, node_test.test)("prefix :n with scalar", () => {
+		const t = require_compile.compile("{var:3}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: "abcdef" }), "abc");
+	});
+	(0, node_test.test)("prefix with reserved content", () => {
+		const t = require_compile.compile("/cut/{x:5}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ x: "abc/def?ghi" }), "/cut/abc%2Fd");
+	});
+});
+(0, node_test.describe)("round-trip tests", () => {
+	(0, node_test.test)("expand(match(url)) === url (opaque)", () => {
+		const t = require_compile.compile("/repos{/owner,repo}{?q,lang}");
+		const url = t.expand({
+			owner: "alice",
+			repo: "hello/world",
+			q: "a b",
+			lang: "en"
+		});
+		const m = t.match(url, { encoding: "opaque" });
+		(0, node_assert_strict.deepStrictEqual)(m !== null, true);
+		const url2 = t.expand(m.vars);
+		(0, node_assert_strict.deepStrictEqual)(url2, url);
+	});
+	(0, node_test.test)("match(expand(vars)) ≅ vars (cooked)", () => {
+		const t = require_compile.compile("/u{/id}{?q}");
+		const vars = {
+			id: "a/b",
+			q: "x y"
+		};
+		const url = t.expand(vars);
+		const m = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(m !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(m.vars, vars);
+	});
+	(0, node_test.test)("explode list stays list in cooked", () => {
+		const t = require_compile.compile("/t{;tags*}");
+		const url = t.expand({ tags: ["a b", "c"] });
+		const m = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(m !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(m.vars.tags, ["a b", "c"]);
+	});
+	(0, node_test.test)("explode map stays map in cooked", () => {
+		const t = require_compile.compile("{?m*}");
+		const url = t.expand({ m: {
+			a: "1 2",
+			b: "/"
+		} });
+		const m = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(m !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(m.vars.m, {
+			a: "1 2",
+			b: "/"
+		});
+	});
+});
+(0, node_test.describe)("encoding and special cases", () => {
+	/**
+	* Regression for https://github.com/awwright/uri-template-router/issues/11:
+	* Ensure that percent-encoded sequences and '#' handling do not lose information.
+	*/
+	(0, node_test.test)("opaque preserves raw percent sequences", () => {
+		const t = require_compile.compile("{#frag}");
+		const url = t.expand({ frag: "%30#" });
+		const mOpaque = t.match(url, { encoding: "opaque" });
+		(0, node_assert_strict.deepStrictEqual)(mOpaque !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(mOpaque.vars.frag, mOpaque.vars.frag);
+		const mCooked = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(mCooked !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(typeof mCooked.vars.frag, "string");
+		(0, node_assert_strict.deepStrictEqual)(mCooked.vars.frag.includes("#"), true);
+	});
+	(0, node_test.test)("bad percent triplet during match => null (strict default)", () => {
+		const t = require_compile.compile("/x{/id}");
+		const m = t.match("/x/%GZ", { encoding: "opaque" });
+		(0, node_assert_strict.deepStrictEqual)(m, null);
+	});
+	(0, node_test.test)("idempotent expand: do not double-encode existing %XX", () => {
+		const t = require_compile.compile("/p{/x}");
+		const url = t.expand({ x: "a%2Fb" });
+		(0, node_assert_strict.deepStrictEqual)(url, "/p/a%2Fb");
+	});
+	(0, node_test.test)("space encoding", () => {
+		const t = require_compile.compile("/s{/x}{?q}");
+		const url = t.expand({
+			x: "a b",
+			q: "x y"
+		});
+		(0, node_assert_strict.deepStrictEqual)(url, "/s/a%20b?q=x%20y");
+		const m = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(m.vars.x, "a b");
+		(0, node_assert_strict.deepStrictEqual)(m.vars.q, "x y");
+	});
+	(0, node_test.test)("greedy capture until next literal", () => {
+		const t = require_compile.compile("/r{?q}#end");
+		const url = t.expand({ q: "a,b,c" });
+		(0, node_assert_strict.deepStrictEqual)(url, "/r?q=a%2Cb%2Cc#end");
+		const m = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(m !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(m.vars.q, "a,b,c");
+	});
+	(0, node_test.test)("multiple expressions with separators", () => {
+		const t = require_compile.compile("/x{/a}{/b}{?c}{&d}");
+		const url = t.expand({
+			a: "1",
+			b: "2/3",
+			c: "4 5",
+			d: "6"
+		});
+		(0, node_assert_strict.deepStrictEqual)(url, "/x/1/2%2F3?c=4%205&d=6");
+		const m = t.match(url, { encoding: "cooked" });
+		(0, node_assert_strict.deepStrictEqual)(m.vars, {
+			a: "1",
+			b: "2/3",
+			c: "4 5",
+			d: "6"
+		});
+	});
+});
+(0, node_test.describe)("undefined and empty value handling", () => {
+	(0, node_test.test)("undefined omits in simple operator", () => {
+		const t = require_compile.compile("A{var}Z");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ var: void 0 }), "AZ");
+	});
+	(0, node_test.test)("empty string is nameOnly in ';' operator", () => {
+		const t = require_compile.compile("{;x}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ x: "" }), ";x");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({ x: void 0 }), "");
+	});
+	(0, node_test.test)("undefined query param omitted", () => {
+		const t = require_compile.compile("/s{?q,lang}");
+		(0, node_assert_strict.deepStrictEqual)(t.expand({
+			q: void 0,
+			lang: "en"
+		}), "/s?lang=en");
+	});
+	(0, node_test.test)("match allows empty value", () => {
+		const t = require_compile.compile("/s{?q}");
+		const m = t.match("/s?q=", { encoding: "opaque" });
+		(0, node_assert_strict.deepStrictEqual)(m !== null, true);
+		(0, node_assert_strict.deepStrictEqual)(m.vars.q, "");
+	});
+});
+
+//#endregion

package/dist/rfc6570.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/rfc6570.spec.d.ts

@@ -0,0 +1 @@
+export { };