@thomasfosterau/effect-rdf 0.0.0-stage → 0.1.0

package/dist/DocumentLoader-D3lZREnB.mjs

@@ -0,0 +1,346 @@
+import { t as __exportAll } from "./rolldown-runtime-D8jQpDG7.mjs";
+import { l as resolve, u as withoutFragment } from "./Iri-Cr92gsQV.mjs";
+import { a as make } from "./JsonLdError-C9J-BxfG.mjs";
+import * as Arr from "effect/Array";
+import * as Iterable from "effect/Iterable";
+import * as MutableHashMap from "effect/MutableHashMap";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Effect from "effect/Effect";
+import * as Record from "effect/Record";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Result from "effect/Result";
+import * as Headers from "effect/http/Headers";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+import * as Ascii from "@thomasfosterau/effect-parse/Ascii";
+import * as Compiler from "@thomasfosterau/effect-parse/Compiler";
+import * as Parser from "@thomasfosterau/effect-parse/Parser";
+import * as Token from "@thomasfosterau/effect-parse/Token";
+// src/jsonld/internal/linkHeader.ts
+/**
+* HTTP `Link` header values (RFC 8288, §3) as an `@thomasfosterau/effect-parse`
+* grammar. Like the user agents the RFC describes, it is lenient: it reads as
+* many link values as it can and ignores what follows them.
+*
+* @internal
+*/
+const space = " 	\r\n\f\v";
+const ows = Token.takeWhile(space);
+const linkTarget = Parser.delimited(Token.literal("<"), Token.takeTill(">"), Token.literal(">"));
+const name = Token.takeTill([space, ";,="], { min: 1 }).pipe(Parser.map((n) => n.toLowerCase()));
+/** `quoted-string`, with its `quoted-pair`s decoded. */
+const quoted = Parser.delimited(Token.literal("\""), Ascii.escaped(Token.takeTill("\"\\", { min: 1 }), "\\", Token.any), Token.literal("\""));
+const paramValue = Parser.alt(quoted, Token.takeTill([space, ";,"]));
+const param = Parser.preceded(Parser.seq(ows, Token.literal(";"), ows), Parser.seq(name, Parser.alt(Parser.preceded(Parser.seq(ows, Token.literal("="), ows), paramValue), Parser.succeed(""))));
+const linkValue = Parser.delimited(ows, Parser.seq(linkTarget, Parser.repeat(param).pipe(Parser.map(Record.fromEntries))), Parser.seq(ows, Parser.opt(Token.literal(",")))).pipe(Parser.map(([target, params]) => ({
+	target,
+	params
+})));
+const links = Compiler.jit(Parser.repeat(linkValue));
+/** The links of a header value (up to the first that cannot be read). */
+const parse = (value) => {
+	const result = Parser.parsePeek(links, value);
+	return Result.isSuccess(result) ? result.success[1] : [];
+};
+// src/jsonld/internal/json.ts
+/**
+* The one `JSON.parse` call of this package. It stays native because the
+* engine's `SyntaxError` text is part of the parse error messages, and
+* `Schema.fromJsonString` replaces it with a generic issue.
+*
+* @internal
+*/
+/**
+* Parses JSON text, failing with the engine's `SyntaxError`.
+*
+* @internal
+*/
+const parseJson = (text) => Result.try({
+	try: () => JSON.parse(text),
+	catch: (e) => e instanceof SyntaxError ? e : new SyntaxError(String(e))
+});
+// src/jsonld/DocumentLoader.ts
+/**
+* Loading of remote JSON-LD documents and contexts.
+*
+* The `DocumentLoader` service retrieves documents by URL. Two layers are
+* provided: `layerHttp`, backed by the Effect `HttpClient` and implementing
+* the JSON-LD content-type and `Link` header rules, and `layerStatic`, which
+* serves documents from an in-memory map (useful for tests, offline use and
+* pinning well-known contexts).
+*
+* @since 0.1.0
+*/
+var DocumentLoader_exports = /* @__PURE__ */ __exportAll({
+	DocumentLoader: () => DocumentLoader,
+	cached: () => cached,
+	extractHtml: () => extractHtml,
+	fromFetch: () => fromFetch,
+	fromResponse: () => fromResponse,
+	layer: () => layer,
+	layerHttp: () => layerHttp,
+	layerStatic: () => layerStatic,
+	makeHttp: () => makeHttp,
+	makeStatic: () => makeStatic,
+	none: () => none,
+	parseLinkHeader: () => parseLinkHeader
+});
+/**
+* The document loader used to dereference remote documents and contexts.
+*
+* @since 0.1.0
+* @category services
+*/
+var DocumentLoader = class extends Context.Service()("@thomasfosterau/effect-rdf/jsonld/DocumentLoader") {};
+const CONTEXT_REL = "http://www.w3.org/ns/json-ld#context";
+/**
+* Parses HTTP `Link` header values (RFC 8288).
+*
+* @since 0.1.0
+* @category utils
+*/
+const parseLinkHeader = (header) => (Predicate.isString(header) ? [header] : header).flatMap(parse);
+/** The media type of a `Content-Type` value: lower-cased, without parameters. */
+const mediaTypeOf = (contentType) => Option.map(contentType, (ct) => {
+	const semicolon = ct.indexOf(";");
+	return (semicolon === -1 ? ct : ct.slice(0, semicolon)).trim().toLowerCase();
+});
+const PROFILE = /;\s*profile\s*=\s*("([^"]*)"|[^;\s]*)/i;
+/** The `profile` parameter of a `Content-Type` value. */
+const profileOf = (contentType) => Option.flatMap(contentType, (ct) => {
+	const m = PROFILE.exec(ct);
+	return m === null ? Option.none() : Option.fromUndefinedOr(m[2] ?? m[1]);
+});
+const isJsonMediaType = (mt) => Option.exists(mt, (t) => t === "application/json" || t === "application/ld+json" || t.endsWith("+json"));
+const isJsonLdMediaType = (mt) => Option.exists(mt, (t) => t === "application/ld+json");
+const isHtmlMediaType = (mt) => Option.exists(mt, (t) => t === "text/html" || t === "application/xhtml+xml");
+const loadingFailed = (url, reason) => make("loading document failed", `${url}: ${reason}`);
+/**
+* Interprets a response following the JSON-LD rules for media types and
+* `Link` headers (JSON-LD 1.1 API §9.4, LoadDocumentCallback).
+*
+* @since 0.1.0
+* @category constructors
+*/
+const fromResponse = (response, options) => Effect.suspend(() => {
+	if (response.status !== void 0 && (response.status < 200 || response.status >= 300)) return Effect.fail(loadingFailed(response.url, `HTTP status ${response.status}`));
+	const contentType = Option.fromUndefinedOr(response.contentType);
+	const mt = mediaTypeOf(contentType);
+	const links = response.link === void 0 ? [] : parseLinkHeader(response.link);
+	if (!isJsonLdMediaType(mt) && !isJsonMediaType(mt)) {
+		const alternate = links.find((l) => l.params["rel"]?.split(/\s+/).includes("alternate") === true && l.params["type"] === "application/ld+json");
+		if (alternate !== void 0) return Effect.succeed({
+			_tag: "Alternate",
+			url: resolve(alternate.target, response.url)
+		});
+	}
+	const contextLinks = !isJsonLdMediaType(mt) && isJsonMediaType(mt) ? links.filter((l) => l.params["rel"]?.split(/\s+/).includes(CONTEXT_REL) === true) : [];
+	if (contextLinks.length > 1) return Effect.fail(make("multiple context link headers", response.url));
+	const contextUrl = Option.getOrUndefined(Option.map(Arr.head(contextLinks), (l) => resolve(l.target, response.url)));
+	if (isHtmlMediaType(mt)) return Effect.map(extractHtml(response.body, response.url, options), (r) => ({
+		_tag: "Document",
+		document: {
+			...r,
+			contentType: Option.getOrUndefined(mt),
+			contextUrl
+		}
+	}));
+	if (!isJsonMediaType(mt)) return Effect.fail(loadingFailed(response.url, `unsupported content type ${String(Option.getOrUndefined(mt))}`));
+	return Result.match(parseJson(response.body), {
+		onFailure: (e) => Effect.fail(loadingFailed(response.url, `invalid JSON: ${String(e)}`)),
+		onSuccess: (document) => Effect.succeed({
+			_tag: "Document",
+			document: {
+				documentUrl: response.url,
+				document,
+				contentType: Option.getOrUndefined(mt),
+				contextUrl,
+				profile: Option.getOrUndefined(profileOf(contentType))
+			}
+		})
+	});
+});
+const ENTITIES = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'"
+};
+const decodeEntities = (s) => s.replace(/&(#x[0-9a-fA-F]+|#[0-9]+|amp|lt|gt|quot|apos);/g, (_, e) => {
+	if (e.startsWith("#x")) return String.fromCodePoint(parseInt(e.slice(2), 16));
+	if (e.startsWith("#")) return String.fromCodePoint(parseInt(e.slice(1), 10));
+	return ENTITIES[e] ?? "";
+});
+/** An element's attributes, by lower-cased name. */
+const attributes = (tag) => {
+	const out = MutableHashMap.empty();
+	const body = tag.replace(/^<\s*[^\s>]+/, "").replace(/\/?>$/, "");
+	Iterable.forEach(body.matchAll(/([^\s=/>]+)(?:\s*=\s*("([^"]*)"|'([^']*)'|([^\s>]+)))?/g), (m) => {
+		const name = m[1];
+		if (name !== void 0) MutableHashMap.set(out, name.toLowerCase(), decodeEntities(m[3] ?? m[4] ?? m[5] ?? ""));
+	});
+	return out;
+};
+const attribute = (attrs, name) => MutableHashMap.get(attrs, name);
+const parseScript = (content) => Result.mapError(parseJson(content), (e) => make("invalid script element", String(e)));
+/**
+* Extracts embedded JSON-LD from an HTML document (`<script
+* type="application/ld+json">` elements), honouring a fragment identifier
+* that selects a script by `id`, and the HTML `<base>` element.
+*
+* @since 0.1.0
+* @category utils
+*/
+const extractHtml = (html, url, options) => Effect.suspend(() => {
+	const base = /<base\s[^>]*>/i.exec(html);
+	const documentUrl = Option.getOrElse(Option.map(Option.flatMap(Option.fromNullOr(base), (b) => attribute(attributes(b[0]), "href")), (href) => resolve(href, url)), () => url);
+	const hash = url.indexOf("#");
+	const fragment = hash === -1 ? "" : decodeURIComponent(url.slice(hash + 1));
+	const scripts = [];
+	Iterable.forEach(html.matchAll(/<script(\s[^>]*)?>([\s\S]*?)<\/script\s*>/gi), (m) => {
+		const attrs = attributes(`<script${m[1] ?? ""}>`);
+		if (isJsonLdMediaType(mediaTypeOf(attribute(attrs, "type")))) scripts.push({
+			attrs,
+			content: m[2] ?? ""
+		});
+	});
+	const remote = (document) => Effect.fromResult(Result.map(document, (d) => ({
+		documentUrl,
+		document: d
+	})));
+	if (fragment !== "") {
+		const script = scripts.find((s) => Option.exists(attribute(s.attrs, "id"), (id) => id === fragment));
+		if (script === void 0) return Effect.fail(loadingFailed(url, `no script element with id ${fragment}`));
+		return remote(parseScript(script.content));
+	}
+	if (options?.extractAllScripts === true) return remote(Result.map(Result.all(scripts.map((s) => parseScript(s.content))), (values) => values.flatMap((v) => Array.isArray(v) ? v : [v])));
+	return Option.match(Arr.head(scripts), {
+		onNone: () => Effect.fail(loadingFailed(url, "no JSON-LD script element")),
+		onSome: (script) => remote(parseScript(script.content))
+	});
+});
+/**
+* Builds a loader from a function fetching raw responses. Responses are
+* interpreted with `fromResponse`; alternate links are followed.
+*
+* @since 0.1.0
+* @category constructors
+*/
+const fromFetch = (fetchResponse) => {
+	const load = (url, depth, options) => fetchResponse(url, options).pipe(Effect.flatMap((response) => fromResponse(response, options)), Effect.flatMap((r) => {
+		if (Predicate.isTagged(r, "Document")) return Effect.succeed(r.document);
+		if (depth > 5) return Effect.fail(loadingFailed(url, "too many alternate links"));
+		return load(r.url, depth + 1, options);
+	}));
+	return { load: (url, options) => load(url, 0, options).pipe(Effect.withSpan("DocumentLoader.load", { attributes: { "url.full": url } })) };
+};
+/**
+* Wraps a loader with an in-memory cache of successfully loaded documents.
+*
+* @since 0.1.0
+* @category combinators
+*/
+const cached = (loader) => {
+	const cache = MutableHashMap.empty();
+	return { load: (url, options) => Effect.suspend(() => {
+		const key = `${options?.extractAllScripts === true ? "*" : ""}${url}`;
+		return Option.match(MutableHashMap.get(cache, key), {
+			onSome: (hit) => Effect.succeed(hit),
+			onNone: () => Effect.tap(loader.load(url, options), (doc) => Effect.sync(() => MutableHashMap.set(cache, key, doc)))
+		});
+	}) };
+};
+/**
+* A loader serving documents from a map of URL to document. Values may be
+* parsed JSON, JSON text, or complete `RemoteDocument`s. Unknown URLs fail
+* with `loading document failed`.
+*
+* @since 0.1.0
+* @category constructors
+*/
+const makeStatic = (documents) => {
+	const lookup = (key) => {
+		if (isMap(documents)) return documents.has(key) ? Option.some(documents.get(key)) : Option.none();
+		return Object.hasOwn(documents, key) ? Option.some(documents[key]) : Option.none();
+	};
+	return { load: (url) => Effect.suspend(() => {
+		const found = lookup(withoutFragment(url));
+		if (Option.isNone(found)) return Effect.fail(loadingFailed(url, "not found"));
+		const value = found.value;
+		if (isRemoteDocument(value)) return Effect.succeed(value);
+		if (Predicate.isString(value)) return Result.match(parseJson(value), {
+			onFailure: (e) => Effect.fail(loadingFailed(url, `invalid JSON: ${String(e)}`)),
+			onSuccess: (document) => Effect.succeed({
+				documentUrl: url,
+				document,
+				contentType: "application/ld+json"
+			})
+		});
+		return Effect.succeed({
+			documentUrl: url,
+			document: value,
+			contentType: "application/ld+json"
+		});
+	}) };
+};
+const isMap = (documents) => documents instanceof Map;
+const isRemoteDocument = (u) => Predicate.hasProperty(u, "documentUrl") && Predicate.hasProperty(u, "document") && Predicate.isString(u.documentUrl);
+/**
+* A loader that fails for every URL (no remote loading).
+*
+* @since 0.1.0
+* @category constructors
+*/
+const none = { load: (url) => Effect.fail(loadingFailed(url, "remote documents are disabled")) };
+/**
+* Provides a static, in-memory `DocumentLoader`.
+*
+* @since 0.1.0
+* @category layers
+*/
+const layerStatic = (documents) => Layer.succeed(DocumentLoader, makeStatic(documents));
+/**
+* Provides a `DocumentLoader` from a loader implementation.
+*
+* @since 0.1.0
+* @category layers
+*/
+const layer = (loader) => Layer.succeed(DocumentLoader, loader);
+const ACCEPT = "application/ld+json, application/json;q=0.9, text/html;q=0.8, application/xhtml+xml;q=0.8, */*;q=0.1";
+/**
+* Builds a loader on top of an `HttpClient`.
+*
+* @since 0.1.0
+* @category constructors
+*/
+const makeHttp = Effect.map(HttpClient.HttpClient, (client) => {
+	const fetchResponse = (url, options) => Effect.gen(function* () {
+		const accept = options?.profile !== void 0 ? `application/ld+json;profile="${options.profile}", ${ACCEPT}` : ACCEPT;
+		const request = HttpClientRequest.get(withoutFragment(url)).pipe(HttpClientRequest.setHeader("accept", accept));
+		const response = yield* client.execute(request);
+		const body = yield* response.text;
+		const finalUrl = response.url === "" ? url : response.url;
+		const hash = url.indexOf("#");
+		return {
+			url: hash === -1 ? finalUrl : finalUrl + url.slice(hash),
+			status: response.status,
+			contentType: Option.getOrUndefined(Headers.get(response.headers, "content-type")),
+			link: Option.getOrUndefined(Headers.get(response.headers, "link")),
+			body
+		};
+	}).pipe(Effect.mapError((e) => loadingFailed(url, String(e))));
+	return cached(fromFetch(fetchResponse));
+});
+/**
+* A caching `DocumentLoader` backed by the Effect `HttpClient`.
+*
+* @since 0.1.0
+* @category layers
+*/
+const layerHttp = Layer.effect(DocumentLoader, makeHttp);
+export { fromFetch as a, layerHttp as c, makeStatic as d, none as f, extractHtml as i, layerStatic as l, parseJson as m, DocumentLoader_exports as n, fromResponse as o, parseLinkHeader as p, cached as r, layer as s, DocumentLoader as t, makeHttp as u };
+
+//# sourceMappingURL=DocumentLoader-D3lZREnB.mjs.map

package/dist/DocumentLoader-D3lZREnB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentLoader-D3lZREnB.mjs","names":["LinkHeader.parse","JsonLdError.make","Iri.resolve","Iri.withoutFragment"],"sources":["../src/jsonld/internal/linkHeader.ts","../src/jsonld/internal/json.ts","../src/jsonld/DocumentLoader.ts"],"sourcesContent":["/**\n * HTTP `Link` header values (RFC 8288, §3) as an `@thomasfosterau/effect-parse`\n * grammar. Like the user agents the RFC describes, it is lenient: it reads as\n * many link values as it can and ignores what follows them.\n *\n * @internal\n */\nimport * as Ascii from '@thomasfosterau/effect-parse/Ascii';\nimport * as Compiler from '@thomasfosterau/effect-parse/Compiler';\nimport * as Parser from '@thomasfosterau/effect-parse/Parser';\nimport * as Token from '@thomasfosterau/effect-parse/Token';\nimport * as Record from 'effect/Record';\nimport * as Result from 'effect/Result';\n\n/** @internal */\nexport interface Link {\n  readonly target: string;\n  readonly params: Readonly<Record<string, string>>;\n}\n\nconst space = ' \\t\\r\\n\\f\\v';\nconst ows = Token.takeWhile(space);\n\nconst linkTarget = Parser.delimited(Token.literal('<'), Token.takeTill('>'), Token.literal('>'));\n\nconst name = Token.takeTill([space, ';,='], { min: 1 }).pipe(Parser.map((n) => n.toLowerCase()));\n\n/** `quoted-string`, with its `quoted-pair`s decoded. */\nconst quoted = Parser.delimited(\n  Token.literal('\"'),\n  Ascii.escaped(Token.takeTill('\"\\\\', { min: 1 }), '\\\\', Token.any),\n  Token.literal('\"'),\n);\n\nconst paramValue = Parser.alt(quoted, Token.takeTill([space, ';,']));\n\nconst param = Parser.preceded(\n  Parser.seq(ows, Token.literal(';'), ows),\n  Parser.seq(\n    name,\n    Parser.alt(\n      Parser.preceded(Parser.seq(ows, Token.literal('='), ows), paramValue),\n      Parser.succeed(''),\n    ),\n  ),\n);\n\nconst linkValue = Parser.delimited(\n  ows,\n  Parser.seq(linkTarget, Parser.repeat(param).pipe(Parser.map(Record.fromEntries))),\n  Parser.seq(ows, Parser.opt(Token.literal(','))),\n).pipe(Parser.map(([target, params]): Link => ({ target, params })));\n\nconst links = Compiler.jit(Parser.repeat(linkValue));\n\n/** The links of a header value (up to the first that cannot be read). */\nexport const parse = (value: string): ReadonlyArray<Link> => {\n  const result = Parser.parsePeek(links, value);\n  return Result.isSuccess(result) ? result.success[1] : [];\n};\n","/**\n * The one `JSON.parse` call of this package. It stays native because the\n * engine's `SyntaxError` text is part of the parse error messages, and\n * `Schema.fromJsonString` replaces it with a generic issue.\n *\n * @internal\n */\nimport * as Result from 'effect/Result';\n\n/**\n * Parses JSON text, failing with the engine's `SyntaxError`.\n *\n * @internal\n */\nexport const parseJson = (text: string): Result.Result<unknown, SyntaxError> =>\n  Result.try({\n    try: () => JSON.parse(text),\n    catch: (e) => (e instanceof SyntaxError ? e : new SyntaxError(String(e))),\n  });\n","/**\n * Loading of remote JSON-LD documents and contexts.\n *\n * The `DocumentLoader` service retrieves documents by URL. Two layers are\n * provided: `layerHttp`, backed by the Effect `HttpClient` and implementing\n * the JSON-LD content-type and `Link` header rules, and `layerStatic`, which\n * serves documents from an in-memory map (useful for tests, offline use and\n * pinning well-known contexts).\n *\n * @since 0.1.0\n */\nimport * as Arr from 'effect/Array';\nimport * as Context from 'effect/Context';\nimport * as Effect from 'effect/Effect';\nimport * as Iterable from 'effect/Iterable';\nimport * as Layer from 'effect/Layer';\nimport * as MutableHashMap from 'effect/MutableHashMap';\nimport * as Option from 'effect/Option';\nimport * as Result from 'effect/Result';\nimport * as Headers from 'effect/http/Headers';\nimport * as HttpClient from 'effect/http/HttpClient';\nimport * as HttpClientRequest from 'effect/http/HttpClientRequest';\nimport * as Iri from '../Iri.ts';\nimport * as LinkHeader from './internal/linkHeader.ts';\nimport { parseJson } from './internal/json.ts';\nimport * as JsonLdError from './JsonLdError.ts';\nimport * as Predicate from 'effect/Predicate';\n\n/**\n * A loaded document (the `RemoteDocument` interface of the JSON-LD API).\n *\n * @since 0.1.0\n * @category models\n */\nexport interface RemoteDocument {\n  /** The final URL of the document, after redirects. */\n  readonly documentUrl: string;\n  /** The parsed JSON document. */\n  readonly document: unknown;\n  /** The media type of the response, without parameters. */\n  readonly contentType?: string | undefined;\n  /** The URL of a context referenced by an HTTP `Link` header. */\n  readonly contextUrl?: string | undefined;\n  /** The `profile` media type parameter, if any. */\n  readonly profile?: string | undefined;\n}\n\n/**\n * @since 0.1.0\n * @category models\n */\nexport interface LoadOptions {\n  /** A profile to request, e.g. `http://www.w3.org/ns/json-ld#context`. */\n  readonly profile?: string | undefined;\n  /** Extract all JSON-LD script elements from HTML documents. */\n  readonly extractAllScripts?: boolean | undefined;\n}\n\n/**\n * The service shape.\n *\n * @since 0.1.0\n * @category models\n */\nexport interface Loader {\n  readonly load: (\n    url: string,\n    options?: LoadOptions,\n  ) => Effect.Effect<RemoteDocument, JsonLdError.JsonLdError>;\n}\n\n/**\n * The document loader used to dereference remote documents and contexts.\n *\n * @since 0.1.0\n * @category services\n */\nexport class DocumentLoader extends Context.Service<DocumentLoader, Loader>()(\n  '@thomasfosterau/effect-rdf/jsonld/DocumentLoader',\n) {}\n\n/**\n * A raw HTTP-like response, interpreted with `fromResponse`.\n *\n * @since 0.1.0\n * @category models\n */\nexport interface Response {\n  /** The final URL after redirects. */\n  readonly url: string;\n  readonly status?: number | undefined;\n  /** The `Content-Type` header. */\n  readonly contentType?: string | undefined;\n  /** The `Link` header value(s). */\n  readonly link?: string | ReadonlyArray<string> | undefined;\n  readonly body: string;\n}\n\nconst CONTEXT_REL = 'http://www.w3.org/ns/json-ld#context';\n\n/**\n * A parsed entry of an HTTP `Link` header.\n *\n * @since 0.1.0\n * @category models\n */\nexport interface Link {\n  readonly target: string;\n  readonly params: Readonly<Record<string, string>>;\n}\n\n/**\n * Parses HTTP `Link` header values (RFC 8288).\n *\n * @since 0.1.0\n * @category utils\n */\nexport const parseLinkHeader = (header: string | ReadonlyArray<string>): ReadonlyArray<Link> =>\n  (Predicate.isString(header) ? [header] : header).flatMap(LinkHeader.parse);\n\n/** The media type of a `Content-Type` value: lower-cased, without parameters. */\nconst mediaTypeOf = (contentType: Option.Option<string>): Option.Option<string> =>\n  Option.map(contentType, (ct) => {\n    const semicolon = ct.indexOf(';');\n    return (semicolon === -1 ? ct : ct.slice(0, semicolon)).trim().toLowerCase();\n  });\n\nconst PROFILE = /;\\s*profile\\s*=\\s*(\"([^\"]*)\"|[^;\\s]*)/i;\n\n/** The `profile` parameter of a `Content-Type` value. */\nconst profileOf = (contentType: Option.Option<string>): Option.Option<string> =>\n  Option.flatMap(contentType, (ct) => {\n    const m = PROFILE.exec(ct);\n    return m === null ? Option.none() : Option.fromUndefinedOr(m[2] ?? m[1]);\n  });\n\nconst isJsonMediaType = (mt: Option.Option<string>): boolean =>\n  Option.exists(\n    mt,\n    (t) => t === 'application/json' || t === 'application/ld+json' || t.endsWith('+json'),\n  );\n\nconst isJsonLdMediaType = (mt: Option.Option<string>): boolean =>\n  Option.exists(mt, (t) => t === 'application/ld+json');\n\nconst isHtmlMediaType = (mt: Option.Option<string>): boolean =>\n  Option.exists(mt, (t) => t === 'text/html' || t === 'application/xhtml+xml');\n\nconst loadingFailed = (url: string, reason: string) =>\n  JsonLdError.make('loading document failed', `${url}: ${reason}`);\n\n/**\n * The result of interpreting a response: either a document, or a redirect\n * to an alternate JSON-LD representation.\n *\n * @since 0.1.0\n * @category models\n */\nexport type Interpreted =\n  | { readonly _tag: 'Document'; readonly document: RemoteDocument }\n  | { readonly _tag: 'Alternate'; readonly url: string };\n\n/**\n * Interprets a response following the JSON-LD rules for media types and\n * `Link` headers (JSON-LD 1.1 API §9.4, LoadDocumentCallback).\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const fromResponse = (\n  response: Response,\n  options?: LoadOptions,\n): Effect.Effect<Interpreted, JsonLdError.JsonLdError> =>\n  Effect.suspend((): Effect.Effect<Interpreted, JsonLdError.JsonLdError> => {\n    if (response.status !== undefined && (response.status < 200 || response.status >= 300)) {\n      return Effect.fail(loadingFailed(response.url, `HTTP status ${response.status}`));\n    }\n    const contentType = Option.fromUndefinedOr(response.contentType);\n    const mt = mediaTypeOf(contentType);\n    const links = response.link === undefined ? [] : parseLinkHeader(response.link);\n    if (!isJsonLdMediaType(mt) && !isJsonMediaType(mt)) {\n      const alternate = links.find(\n        (l) =>\n          l.params['rel']?.split(/\\s+/).includes('alternate') === true &&\n          l.params['type'] === 'application/ld+json',\n      );\n      if (alternate !== undefined) {\n        return Effect.succeed({\n          _tag: 'Alternate' as const,\n          url: Iri.resolve(alternate.target, response.url),\n        });\n      }\n    }\n    const contextLinks =\n      !isJsonLdMediaType(mt) && isJsonMediaType(mt)\n        ? links.filter((l) => l.params['rel']?.split(/\\s+/).includes(CONTEXT_REL) === true)\n        : [];\n    if (contextLinks.length > 1) {\n      return Effect.fail(JsonLdError.make('multiple context link headers', response.url));\n    }\n    const contextUrl = Option.getOrUndefined(\n      Option.map(Arr.head(contextLinks), (l) => Iri.resolve(l.target, response.url)),\n    );\n    if (isHtmlMediaType(mt)) {\n      return Effect.map(extractHtml(response.body, response.url, options), (r) => ({\n        _tag: 'Document' as const,\n        document: { ...r, contentType: Option.getOrUndefined(mt), contextUrl },\n      }));\n    }\n    if (!isJsonMediaType(mt)) {\n      return Effect.fail(\n        loadingFailed(\n          response.url,\n          `unsupported content type ${String(Option.getOrUndefined(mt))}`,\n        ),\n      );\n    }\n    return Result.match(parseJson(response.body), {\n      onFailure: (e) => Effect.fail(loadingFailed(response.url, `invalid JSON: ${String(e)}`)),\n      onSuccess: (document) =>\n        Effect.succeed({\n          _tag: 'Document' as const,\n          document: {\n            documentUrl: response.url,\n            document,\n            contentType: Option.getOrUndefined(mt),\n            contextUrl,\n            profile: Option.getOrUndefined(profileOf(contentType)),\n          },\n        }),\n    });\n  });\n\nconst ENTITIES: Readonly<Record<string, string>> = {\n  amp: '&',\n  lt: '<',\n  gt: '>',\n  quot: '\"',\n  apos: \"'\",\n};\n\nconst decodeEntities = (s: string): string =>\n  s.replace(/&(#x[0-9a-fA-F]+|#[0-9]+|amp|lt|gt|quot|apos);/g, (_, e: string) => {\n    if (e.startsWith('#x')) return String.fromCodePoint(parseInt(e.slice(2), 16));\n    if (e.startsWith('#')) return String.fromCodePoint(parseInt(e.slice(1), 10));\n    // The pattern admits only the named entities in `ENTITIES`.\n    return ENTITIES[e] ?? '';\n  });\n\ntype Attributes = MutableHashMap.MutableHashMap<string, string>;\n\n/** An element's attributes, by lower-cased name. */\nconst attributes = (tag: string): Attributes => {\n  const out: Attributes = MutableHashMap.empty();\n  const body = tag.replace(/^<\\s*[^\\s>]+/, '').replace(/\\/?>$/, '');\n  Iterable.forEach(\n    body.matchAll(/([^\\s=/>]+)(?:\\s*=\\s*(\"([^\"]*)\"|'([^']*)'|([^\\s>]+)))?/g),\n    (m) => {\n      const name = m[1];\n      if (name !== undefined) {\n        MutableHashMap.set(out, name.toLowerCase(), decodeEntities(m[3] ?? m[4] ?? m[5] ?? ''));\n      }\n    },\n  );\n  return out;\n};\n\nconst attribute = (attrs: Attributes, name: string): Option.Option<string> =>\n  MutableHashMap.get(attrs, name);\n\nconst parseScript = (content: string) =>\n  Result.mapError(parseJson(content), (e) => JsonLdError.make('invalid script element', String(e)));\n\n/**\n * Extracts embedded JSON-LD from an HTML document (`<script\n * type=\"application/ld+json\">` elements), honouring a fragment identifier\n * that selects a script by `id`, and the HTML `<base>` element.\n *\n * @since 0.1.0\n * @category utils\n */\nexport const extractHtml = (\n  html: string,\n  url: string,\n  options?: LoadOptions,\n): Effect.Effect<RemoteDocument, JsonLdError.JsonLdError> =>\n  Effect.suspend(() => {\n    const base = /<base\\s[^>]*>/i.exec(html);\n    const documentUrl = Option.getOrElse(\n      Option.map(\n        Option.flatMap(Option.fromNullOr(base), (b) => attribute(attributes(b[0]), 'href')),\n        (href) => Iri.resolve(href, url),\n      ),\n      () => url,\n    );\n    const hash = url.indexOf('#');\n    const fragment = hash === -1 ? '' : decodeURIComponent(url.slice(hash + 1));\n    const scripts: Array<{ attrs: Attributes; content: string }> = [];\n    Iterable.forEach(html.matchAll(/<script(\\s[^>]*)?>([\\s\\S]*?)<\\/script\\s*>/gi), (m) => {\n      const attrs = attributes(`<script${m[1] ?? ''}>`);\n      if (isJsonLdMediaType(mediaTypeOf(attribute(attrs, 'type')))) {\n        scripts.push({ attrs, content: m[2] ?? '' });\n      }\n    });\n    const remote = (document: Result.Result<unknown, JsonLdError.JsonLdError>) =>\n      Effect.fromResult(\n        Result.map(document, (d): RemoteDocument => ({ documentUrl, document: d })),\n      );\n    if (fragment !== '') {\n      const script = scripts.find((s) =>\n        Option.exists(attribute(s.attrs, 'id'), (id) => id === fragment),\n      );\n      if (script === undefined) {\n        return Effect.fail(loadingFailed(url, `no script element with id ${fragment}`));\n      }\n      return remote(parseScript(script.content));\n    }\n    if (options?.extractAllScripts === true) {\n      return remote(\n        Result.map(Result.all(scripts.map((s) => parseScript(s.content))), (values) =>\n          values.flatMap((v) => (Array.isArray(v) ? v : [v])),\n        ),\n      );\n    }\n    return Option.match(Arr.head(scripts), {\n      onNone: () => Effect.fail(loadingFailed(url, 'no JSON-LD script element')),\n      onSome: (script) => remote(parseScript(script.content)),\n    });\n  });\n\n/**\n * Builds a loader from a function fetching raw responses. Responses are\n * interpreted with `fromResponse`; alternate links are followed.\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const fromFetch = (\n  fetchResponse: (\n    url: string,\n    options?: LoadOptions,\n  ) => Effect.Effect<Response, JsonLdError.JsonLdError>,\n): Loader => {\n  const load = (\n    url: string,\n    depth: number,\n    options?: LoadOptions,\n  ): Effect.Effect<RemoteDocument, JsonLdError.JsonLdError> =>\n    fetchResponse(url, options).pipe(\n      Effect.flatMap((response) => fromResponse(response, options)),\n      Effect.flatMap((r) => {\n        if (Predicate.isTagged(r, 'Document')) return Effect.succeed(r.document);\n        if (depth > 5) return Effect.fail(loadingFailed(url, 'too many alternate links'));\n        return load(r.url, depth + 1, options);\n      }),\n    );\n  return {\n    load: (url, options) =>\n      load(url, 0, options).pipe(\n        Effect.withSpan('DocumentLoader.load', { attributes: { 'url.full': url } }),\n      ),\n  };\n};\n\n/**\n * Wraps a loader with an in-memory cache of successfully loaded documents.\n *\n * @since 0.1.0\n * @category combinators\n */\nexport const cached = (loader: Loader): Loader => {\n  const cache = MutableHashMap.empty<string, RemoteDocument>();\n  return {\n    load: (url, options) =>\n      Effect.suspend(() => {\n        const key = `${options?.extractAllScripts === true ? '*' : ''}${url}`;\n        return Option.match(MutableHashMap.get(cache, key), {\n          onSome: (hit) => Effect.succeed(hit),\n          onNone: () =>\n            Effect.tap(loader.load(url, options), (doc) =>\n              Effect.sync(() => MutableHashMap.set(cache, key, doc)),\n            ),\n        });\n      }),\n  };\n};\n\n/**\n * A loader serving documents from a map of URL to document. Values may be\n * parsed JSON, JSON text, or complete `RemoteDocument`s. Unknown URLs fail\n * with `loading document failed`.\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const makeStatic = (\n  documents: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>,\n): Loader => {\n  // A `Map` is read as one; any other value as a record of URL to document.\n  const lookup = (key: string): Option.Option<unknown> => {\n    if (isMap(documents))\n      return documents.has(key) ? Option.some(documents.get(key)) : Option.none();\n    return Object.hasOwn(documents, key) ? Option.some(documents[key]) : Option.none();\n  };\n  return {\n    load: (url) =>\n      Effect.suspend(() => {\n        const found = lookup(Iri.withoutFragment(url));\n        if (Option.isNone(found)) return Effect.fail(loadingFailed(url, 'not found'));\n        const value = found.value;\n        if (isRemoteDocument(value)) return Effect.succeed(value);\n        if (Predicate.isString(value)) {\n          return Result.match(parseJson(value), {\n            onFailure: (e) => Effect.fail(loadingFailed(url, `invalid JSON: ${String(e)}`)),\n            onSuccess: (document) =>\n              Effect.succeed({ documentUrl: url, document, contentType: 'application/ld+json' }),\n          });\n        }\n        return Effect.succeed({\n          documentUrl: url,\n          document: value,\n          contentType: 'application/ld+json',\n        });\n      }),\n  };\n};\n\nconst isMap = (\n  documents: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>,\n): documents is ReadonlyMap<string, unknown> => documents instanceof Map;\n\nconst isRemoteDocument = (u: unknown): u is RemoteDocument =>\n  Predicate.hasProperty(u, 'documentUrl') &&\n  Predicate.hasProperty(u, 'document') &&\n  Predicate.isString(u.documentUrl);\n\n/**\n * A loader that fails for every URL (no remote loading).\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const none: Loader = {\n  load: (url) => Effect.fail(loadingFailed(url, 'remote documents are disabled')),\n};\n\n/**\n * Provides a static, in-memory `DocumentLoader`.\n *\n * @since 0.1.0\n * @category layers\n */\nexport const layerStatic = (\n  documents: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>,\n): Layer.Layer<DocumentLoader> => Layer.succeed(DocumentLoader, makeStatic(documents));\n\n/**\n * Provides a `DocumentLoader` from a loader implementation.\n *\n * @since 0.1.0\n * @category layers\n */\nexport const layer = (loader: Loader): Layer.Layer<DocumentLoader> =>\n  Layer.succeed(DocumentLoader, loader);\n\nconst ACCEPT =\n  'application/ld+json, application/json;q=0.9, text/html;q=0.8, application/xhtml+xml;q=0.8, */*;q=0.1';\n\n/**\n * Builds a loader on top of an `HttpClient`.\n *\n * @since 0.1.0\n * @category constructors\n */\nexport const makeHttp: Effect.Effect<Loader, never, HttpClient.HttpClient> = Effect.map(\n  HttpClient.HttpClient,\n  (client) => {\n    const fetchResponse = (url: string, options?: LoadOptions) =>\n      Effect.gen(function* () {\n        const accept =\n          options?.profile !== undefined\n            ? `application/ld+json;profile=\"${options.profile}\", ${ACCEPT}`\n            : ACCEPT;\n        const request = HttpClientRequest.get(Iri.withoutFragment(url)).pipe(\n          HttpClientRequest.setHeader('accept', accept),\n        );\n        const response = yield* client.execute(request);\n        const body = yield* response.text;\n        const finalUrl = response.url === '' ? url : response.url;\n        const hash = url.indexOf('#');\n        return {\n          url: hash === -1 ? finalUrl : finalUrl + url.slice(hash),\n          status: response.status,\n          contentType: Option.getOrUndefined(Headers.get(response.headers, 'content-type')),\n          link: Option.getOrUndefined(Headers.get(response.headers, 'link')),\n          body,\n        } satisfies Response;\n      }).pipe(Effect.mapError((e) => loadingFailed(url, String(e))));\n    return cached(fromFetch(fetchResponse));\n  },\n);\n\n/**\n * A caching `DocumentLoader` backed by the Effect `HttpClient`.\n *\n * @since 0.1.0\n * @category layers\n */\nexport const layerHttp: Layer.Layer<DocumentLoader, never, HttpClient.HttpClient> = Layer.effect(\n  DocumentLoader,\n  makeHttp,\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,QAAQ;AACd,MAAM,MAAM,MAAM,UAAU,KAAK;AAEjC,MAAM,aAAa,OAAO,UAAU,MAAM,QAAQ,GAAG,GAAG,MAAM,SAAS,GAAG,GAAG,MAAM,QAAQ,GAAG,CAAC;AAE/F,MAAM,OAAO,MAAM,SAAS,CAAC,OAAO,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,KAAK,MAAM,EAAE,YAAY,CAAC,CAAC;;AAG/F,MAAM,SAAS,OAAO,UACpB,MAAM,QAAQ,IAAG,GACjB,MAAM,QAAQ,MAAM,SAAS,QAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,MAAM,GAAG,GAChE,MAAM,QAAQ,IAAG,CACnB;AAEA,MAAM,aAAa,OAAO,IAAI,QAAQ,MAAM,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnE,MAAM,QAAQ,OAAO,SACnB,OAAO,IAAI,KAAK,MAAM,QAAQ,GAAG,GAAG,GAAG,GACvC,OAAO,IACL,MACA,OAAO,IACL,OAAO,SAAS,OAAO,IAAI,KAAK,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,UAAU,GACpE,OAAO,QAAQ,EAAE,CACnB,CACF,CACF;AAEA,MAAM,YAAY,OAAO,UACvB,KACA,OAAO,IAAI,YAAY,OAAO,OAAO,KAAK,CAAC,CAAC,KAAK,OAAO,IAAI,OAAO,WAAW,CAAC,CAAC,GAChF,OAAO,IAAI,KAAK,OAAO,IAAI,MAAM,QAAQ,GAAG,CAAC,CAAC,CAChD,CAAC,CAAC,KAAK,OAAO,KAAK,CAAC,QAAQ,aAAmB;CAAE;CAAQ;AAAO,EAAE,CAAC;AAEnE,MAAM,QAAQ,SAAS,IAAI,OAAO,OAAO,SAAS,CAAC;;AAGnD,MAAa,SAAS,UAAuC;CAC3D,MAAM,SAAS,OAAO,UAAU,OAAO,KAAK;CAC5C,OAAO,OAAO,UAAU,MAAM,IAAI,OAAO,QAAQ,KAAK,CAAC;AACzD;;;;;;;;;;;;;;AC7CA,MAAa,aAAa,SACxB,OAAO,IAAI;CACT,WAAW,KAAK,MAAM,IAAI;CAC1B,QAAQ,MAAO,aAAa,cAAc,IAAI,IAAI,YAAY,OAAO,CAAC,CAAC;AACzE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC2DH,IAAa,iBAAb,cAAoC,QAAQ,QAAgC,CAAC,CAC3E,kDACF,CAAC,CAAC,CAAC;AAmBH,MAAM,cAAc;;;;;;;AAmBpB,MAAa,mBAAmB,YAC7B,UAAU,SAAS,MAAM,IAAI,CAAC,MAAM,IAAI,OAAA,CAAQ,QAAQA,KAAgB;;AAG3E,MAAM,eAAe,gBACnB,OAAO,IAAI,cAAc,OAAO;CAC9B,MAAM,YAAY,GAAG,QAAQ,GAAG;CAChC,QAAQ,cAAc,KAAK,KAAK,GAAG,MAAM,GAAG,SAAS,EAAA,CAAG,KAAK,CAAC,CAAC,YAAY;AAC7E,CAAC;AAEH,MAAM,UAAU;;AAGhB,MAAM,aAAa,gBACjB,OAAO,QAAQ,cAAc,OAAO;CAClC,MAAM,IAAI,QAAQ,KAAK,EAAE;CACzB,OAAO,MAAM,OAAO,OAAO,KAAK,IAAI,OAAO,gBAAgB,EAAE,MAAM,EAAE,EAAE;AACzE,CAAC;AAEH,MAAM,mBAAmB,OACvB,OAAO,OACL,KACC,MAAM,MAAM,sBAAsB,MAAM,yBAAyB,EAAE,SAAS,OAAO,CACtF;AAEF,MAAM,qBAAqB,OACzB,OAAO,OAAO,KAAK,MAAM,MAAM,qBAAqB;AAEtD,MAAM,mBAAmB,OACvB,OAAO,OAAO,KAAK,MAAM,MAAM,eAAe,MAAM,uBAAuB;AAE7E,MAAM,iBAAiB,KAAa,WAClCC,KAAiB,2BAA2B,GAAG,IAAI,IAAI,QAAQ;;;;;;;;AAoBjE,MAAa,gBACX,UACA,YAEA,OAAO,cAAmE;CACxE,IAAI,SAAS,WAAW,KAAA,MAAc,SAAS,SAAS,OAAO,SAAS,UAAU,MAChF,OAAO,OAAO,KAAK,cAAc,SAAS,KAAK,eAAe,SAAS,QAAQ,CAAC;CAElF,MAAM,cAAc,OAAO,gBAAgB,SAAS,WAAW;CAC/D,MAAM,KAAK,YAAY,WAAW;CAClC,MAAM,QAAQ,SAAS,SAAS,KAAA,IAAY,CAAC,IAAI,gBAAgB,SAAS,IAAI;CAC9E,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,EAAE,GAAG;EAClD,MAAM,YAAY,MAAM,MACrB,MACC,EAAE,OAAO,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC,SAAS,WAAW,MAAM,QACxD,EAAE,OAAO,YAAY,qBACzB;EACA,IAAI,cAAc,KAAA,GAChB,OAAO,OAAO,QAAQ;GACpB,MAAM;GACN,KAAKC,QAAY,UAAU,QAAQ,SAAS,GAAG;EACjD,CAAC;CAEL;CACA,MAAM,eACJ,CAAC,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,IACxC,MAAM,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC,SAAS,WAAW,MAAM,IAAI,IAChF,CAAC;CACP,IAAI,aAAa,SAAS,GACxB,OAAO,OAAO,KAAKD,KAAiB,iCAAiC,SAAS,GAAG,CAAC;CAEpF,MAAM,aAAa,OAAO,eACxB,OAAO,IAAI,IAAI,KAAK,YAAY,IAAI,MAAMC,QAAY,EAAE,QAAQ,SAAS,GAAG,CAAC,CAC/E;CACA,IAAI,gBAAgB,EAAE,GACpB,OAAO,OAAO,IAAI,YAAY,SAAS,MAAM,SAAS,KAAK,OAAO,IAAI,OAAO;EAC3E,MAAM;EACN,UAAU;GAAE,GAAG;GAAG,aAAa,OAAO,eAAe,EAAE;GAAG;EAAW;CACvE,EAAE;CAEJ,IAAI,CAAC,gBAAgB,EAAE,GACrB,OAAO,OAAO,KACZ,cACE,SAAS,KACT,4BAA4B,OAAO,OAAO,eAAe,EAAE,CAAC,GAC9D,CACF;CAEF,OAAO,OAAO,MAAM,UAAU,SAAS,IAAI,GAAG;EAC5C,YAAY,MAAM,OAAO,KAAK,cAAc,SAAS,KAAK,iBAAiB,OAAO,CAAC,GAAG,CAAC;EACvF,YAAY,aACV,OAAO,QAAQ;GACb,MAAM;GACN,UAAU;IACR,aAAa,SAAS;IACtB;IACA,aAAa,OAAO,eAAe,EAAE;IACrC;IACA,SAAS,OAAO,eAAe,UAAU,WAAW,CAAC;GACvD;EACF,CAAC;CACL,CAAC;AACH,CAAC;AAEH,MAAM,WAA6C;CACjD,KAAK;CACL,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,MAAM;AACR;AAEA,MAAM,kBAAkB,MACtB,EAAE,QAAQ,oDAAoD,GAAG,MAAc;CAC7E,IAAI,EAAE,WAAW,IAAI,GAAG,OAAO,OAAO,cAAc,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;CAC5E,IAAI,EAAE,WAAW,GAAG,GAAG,OAAO,OAAO,cAAc,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;CAE3E,OAAO,SAAS,MAAM;AACxB,CAAC;;AAKH,MAAM,cAAc,QAA4B;CAC9C,MAAM,MAAkB,eAAe,MAAM;CAC7C,MAAM,OAAO,IAAI,QAAQ,gBAAgB,EAAE,CAAC,CAAC,QAAQ,SAAS,EAAE;CAChE,SAAS,QACP,KAAK,SAAS,yDAAyD,IACtE,MAAM;EACL,MAAM,OAAO,EAAE;EACf,IAAI,SAAS,KAAA,GACX,eAAe,IAAI,KAAK,KAAK,YAAY,GAAG,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;CAE1F,CACF;CACA,OAAO;AACT;AAEA,MAAM,aAAa,OAAmB,SACpC,eAAe,IAAI,OAAO,IAAI;AAEhC,MAAM,eAAe,YACnB,OAAO,SAAS,UAAU,OAAO,IAAI,MAAMD,KAAiB,0BAA0B,OAAO,CAAC,CAAC,CAAC;;;;;;;;;AAUlG,MAAa,eACX,MACA,KACA,YAEA,OAAO,cAAc;CACnB,MAAM,OAAO,iBAAiB,KAAK,IAAI;CACvC,MAAM,cAAc,OAAO,UACzB,OAAO,IACL,OAAO,QAAQ,OAAO,WAAW,IAAI,IAAI,MAAM,UAAU,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,IACjF,SAASC,QAAY,MAAM,GAAG,CACjC,SACM,GACR;CACA,MAAM,OAAO,IAAI,QAAQ,GAAG;CAC5B,MAAM,WAAW,SAAS,KAAK,KAAK,mBAAmB,IAAI,MAAM,OAAO,CAAC,CAAC;CAC1E,MAAM,UAAyD,CAAC;CAChE,SAAS,QAAQ,KAAK,SAAS,6CAA6C,IAAI,MAAM;EACpF,MAAM,QAAQ,WAAW,UAAU,EAAE,MAAM,GAAG,EAAE;EAChD,IAAI,kBAAkB,YAAY,UAAU,OAAO,MAAM,CAAC,CAAC,GACzD,QAAQ,KAAK;GAAE;GAAO,SAAS,EAAE,MAAM;EAAG,CAAC;CAE/C,CAAC;CACD,MAAM,UAAU,aACd,OAAO,WACL,OAAO,IAAI,WAAW,OAAuB;EAAE;EAAa,UAAU;CAAE,EAAE,CAC5E;CACF,IAAI,aAAa,IAAI;EACnB,MAAM,SAAS,QAAQ,MAAM,MAC3B,OAAO,OAAO,UAAU,EAAE,OAAO,IAAI,IAAI,OAAO,OAAO,QAAQ,CACjE;EACA,IAAI,WAAW,KAAA,GACb,OAAO,OAAO,KAAK,cAAc,KAAK,6BAA6B,UAAU,CAAC;EAEhF,OAAO,OAAO,YAAY,OAAO,OAAO,CAAC;CAC3C;CACA,IAAI,SAAS,sBAAsB,MACjC,OAAO,OACL,OAAO,IAAI,OAAO,IAAI,QAAQ,KAAK,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,WAClE,OAAO,SAAS,MAAO,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CACpD,CACF;CAEF,OAAO,OAAO,MAAM,IAAI,KAAK,OAAO,GAAG;EACrC,cAAc,OAAO,KAAK,cAAc,KAAK,2BAA2B,CAAC;EACzE,SAAS,WAAW,OAAO,YAAY,OAAO,OAAO,CAAC;CACxD,CAAC;AACH,CAAC;;;;;;;;AASH,MAAa,aACX,kBAIW;CACX,MAAM,QACJ,KACA,OACA,YAEA,cAAc,KAAK,OAAO,CAAC,CAAC,KAC1B,OAAO,SAAS,aAAa,aAAa,UAAU,OAAO,CAAC,GAC5D,OAAO,SAAS,MAAM;EACpB,IAAI,UAAU,SAAS,GAAG,UAAU,GAAG,OAAO,OAAO,QAAQ,EAAE,QAAQ;EACvE,IAAI,QAAQ,GAAG,OAAO,OAAO,KAAK,cAAc,KAAK,0BAA0B,CAAC;EAChF,OAAO,KAAK,EAAE,KAAK,QAAQ,GAAG,OAAO;CACvC,CAAC,CACH;CACF,OAAO,EACL,OAAO,KAAK,YACV,KAAK,KAAK,GAAG,OAAO,CAAC,CAAC,KACpB,OAAO,SAAS,uBAAuB,EAAE,YAAY,EAAE,YAAY,IAAI,EAAE,CAAC,CAC5E,EACJ;AACF;;;;;;;AAQA,MAAa,UAAU,WAA2B;CAChD,MAAM,QAAQ,eAAe,MAA8B;CAC3D,OAAO,EACL,OAAO,KAAK,YACV,OAAO,cAAc;EACnB,MAAM,MAAM,GAAG,SAAS,sBAAsB,OAAO,MAAM,KAAK;EAChE,OAAO,OAAO,MAAM,eAAe,IAAI,OAAO,GAAG,GAAG;GAClD,SAAS,QAAQ,OAAO,QAAQ,GAAG;GACnC,cACE,OAAO,IAAI,OAAO,KAAK,KAAK,OAAO,IAAI,QACrC,OAAO,WAAW,eAAe,IAAI,OAAO,KAAK,GAAG,CAAC,CACvD;EACJ,CAAC;CACH,CAAC,EACL;AACF;;;;;;;;;AAUA,MAAa,cACX,cACW;CAEX,MAAM,UAAU,QAAwC;EACtD,IAAI,MAAM,SAAS,GACjB,OAAO,UAAU,IAAI,GAAG,IAAI,OAAO,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,OAAO,KAAK;EAC5E,OAAO,OAAO,OAAO,WAAW,GAAG,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI,OAAO,KAAK;CACnF;CACA,OAAO,EACL,OAAO,QACL,OAAO,cAAc;EACnB,MAAM,QAAQ,OAAOC,gBAAoB,GAAG,CAAC;EAC7C,IAAI,OAAO,OAAO,KAAK,GAAG,OAAO,OAAO,KAAK,cAAc,KAAK,WAAW,CAAC;EAC5E,MAAM,QAAQ,MAAM;EACpB,IAAI,iBAAiB,KAAK,GAAG,OAAO,OAAO,QAAQ,KAAK;EACxD,IAAI,UAAU,SAAS,KAAK,GAC1B,OAAO,OAAO,MAAM,UAAU,KAAK,GAAG;GACpC,YAAY,MAAM,OAAO,KAAK,cAAc,KAAK,iBAAiB,OAAO,CAAC,GAAG,CAAC;GAC9E,YAAY,aACV,OAAO,QAAQ;IAAE,aAAa;IAAK;IAAU,aAAa;GAAsB,CAAC;EACrF,CAAC;EAEH,OAAO,OAAO,QAAQ;GACpB,aAAa;GACb,UAAU;GACV,aAAa;EACf,CAAC;CACH,CAAC,EACL;AACF;AAEA,MAAM,SACJ,cAC8C,qBAAqB;AAErE,MAAM,oBAAoB,MACxB,UAAU,YAAY,GAAG,aAAa,KACtC,UAAU,YAAY,GAAG,UAAU,KACnC,UAAU,SAAS,EAAE,WAAW;;;;;;;AAQlC,MAAa,OAAe,EAC1B,OAAO,QAAQ,OAAO,KAAK,cAAc,KAAK,+BAA+B,CAAC,EAChF;;;;;;;AAQA,MAAa,eACX,cACgC,MAAM,QAAQ,gBAAgB,WAAW,SAAS,CAAC;;;;;;;AAQrF,MAAa,SAAS,WACpB,MAAM,QAAQ,gBAAgB,MAAM;AAEtC,MAAM,SACJ;;;;;;;AAQF,MAAa,WAAgE,OAAO,IAClF,WAAW,aACV,WAAW;CACV,MAAM,iBAAiB,KAAa,YAClC,OAAO,IAAI,aAAa;EACtB,MAAM,SACJ,SAAS,YAAY,KAAA,IACjB,gCAAgC,QAAQ,QAAQ,KAAK,WACrD;EACN,MAAM,UAAU,kBAAkB,IAAIA,gBAAoB,GAAG,CAAC,CAAC,CAAC,KAC9D,kBAAkB,UAAU,UAAU,MAAM,CAC9C;EACA,MAAM,WAAW,OAAO,OAAO,QAAQ,OAAO;EAC9C,MAAM,OAAO,OAAO,SAAS;EAC7B,MAAM,WAAW,SAAS,QAAQ,KAAK,MAAM,SAAS;EACtD,MAAM,OAAO,IAAI,QAAQ,GAAG;EAC5B,OAAO;GACL,KAAK,SAAS,KAAK,WAAW,WAAW,IAAI,MAAM,IAAI;GACvD,QAAQ,SAAS;GACjB,aAAa,OAAO,eAAe,QAAQ,IAAI,SAAS,SAAS,cAAc,CAAC;GAChF,MAAM,OAAO,eAAe,QAAQ,IAAI,SAAS,SAAS,MAAM,CAAC;GACjE;EACF;CACF,CAAC,CAAC,CAAC,KAAK,OAAO,UAAU,MAAM,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/D,OAAO,OAAO,UAAU,aAAa,CAAC;AACxC,CACF;;;;;;;AAQA,MAAa,YAAuE,MAAM,OACxF,gBACA,QACF"}

package/dist/DocumentLoader-ZUCEVrW5.d.mts

@@ -0,0 +1,178 @@
+import { n as JsonLdError } from "./JsonLdError-DSOfHkOy.mjs";
+import * as Effect from "effect/Effect";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as HttpClient from "effect/http/HttpClient";
+declare namespace DocumentLoader_d_exports {
+  export { DocumentLoader, Interpreted, Link, LoadOptions, Loader, RemoteDocument, Response, cached, extractHtml, fromFetch, fromResponse, layer, layerHttp, layerStatic, makeHttp, makeStatic, none, parseLinkHeader };
+}
+/**
+ * A loaded document (the `RemoteDocument` interface of the JSON-LD API).
+ *
+ * @since 0.1.0
+ * @category models
+ */
+interface RemoteDocument {
+  /** The final URL of the document, after redirects. */
+  readonly documentUrl: string;
+  /** The parsed JSON document. */
+  readonly document: unknown;
+  /** The media type of the response, without parameters. */
+  readonly contentType?: string | undefined;
+  /** The URL of a context referenced by an HTTP `Link` header. */
+  readonly contextUrl?: string | undefined;
+  /** The `profile` media type parameter, if any. */
+  readonly profile?: string | undefined;
+}
+/**
+ * @since 0.1.0
+ * @category models
+ */
+interface LoadOptions {
+  /** A profile to request, e.g. `http://www.w3.org/ns/json-ld#context`. */
+  readonly profile?: string | undefined;
+  /** Extract all JSON-LD script elements from HTML documents. */
+  readonly extractAllScripts?: boolean | undefined;
+}
+/**
+ * The service shape.
+ *
+ * @since 0.1.0
+ * @category models
+ */
+interface Loader {
+  readonly load: (url: string, options?: LoadOptions) => Effect.Effect<RemoteDocument, JsonLdError>;
+}
+declare const DocumentLoader_base: Context.ServiceClass<DocumentLoader, "@thomasfosterau/effect-rdf/jsonld/DocumentLoader", Loader>;
+/**
+ * The document loader used to dereference remote documents and contexts.
+ *
+ * @since 0.1.0
+ * @category services
+ */
+declare class DocumentLoader extends DocumentLoader_base {}
+/**
+ * A raw HTTP-like response, interpreted with `fromResponse`.
+ *
+ * @since 0.1.0
+ * @category models
+ */
+interface Response {
+  /** The final URL after redirects. */
+  readonly url: string;
+  readonly status?: number | undefined;
+  /** The `Content-Type` header. */
+  readonly contentType?: string | undefined;
+  /** The `Link` header value(s). */
+  readonly link?: string | ReadonlyArray<string> | undefined;
+  readonly body: string;
+}
+/**
+ * A parsed entry of an HTTP `Link` header.
+ *
+ * @since 0.1.0
+ * @category models
+ */
+interface Link {
+  readonly target: string;
+  readonly params: Readonly<Record<string, string>>;
+}
+/**
+ * Parses HTTP `Link` header values (RFC 8288).
+ *
+ * @since 0.1.0
+ * @category utils
+ */
+declare const parseLinkHeader: (header: string | ReadonlyArray<string>) => ReadonlyArray<Link>;
+/**
+ * The result of interpreting a response: either a document, or a redirect
+ * to an alternate JSON-LD representation.
+ *
+ * @since 0.1.0
+ * @category models
+ */
+type Interpreted = {
+  readonly _tag: 'Document';
+  readonly document: RemoteDocument;
+} | {
+  readonly _tag: 'Alternate';
+  readonly url: string;
+};
+/**
+ * Interprets a response following the JSON-LD rules for media types and
+ * `Link` headers (JSON-LD 1.1 API §9.4, LoadDocumentCallback).
+ *
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const fromResponse: (response: Response, options?: LoadOptions) => Effect.Effect<Interpreted, JsonLdError>;
+/**
+ * Extracts embedded JSON-LD from an HTML document (`<script
+ * type="application/ld+json">` elements), honouring a fragment identifier
+ * that selects a script by `id`, and the HTML `<base>` element.
+ *
+ * @since 0.1.0
+ * @category utils
+ */
+declare const extractHtml: (html: string, url: string, options?: LoadOptions) => Effect.Effect<RemoteDocument, JsonLdError>;
+/**
+ * Builds a loader from a function fetching raw responses. Responses are
+ * interpreted with `fromResponse`; alternate links are followed.
+ *
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const fromFetch: (fetchResponse: (url: string, options?: LoadOptions) => Effect.Effect<Response, JsonLdError>) => Loader;
+/**
+ * Wraps a loader with an in-memory cache of successfully loaded documents.
+ *
+ * @since 0.1.0
+ * @category combinators
+ */
+declare const cached: (loader: Loader) => Loader;
+/**
+ * A loader serving documents from a map of URL to document. Values may be
+ * parsed JSON, JSON text, or complete `RemoteDocument`s. Unknown URLs fail
+ * with `loading document failed`.
+ *
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const makeStatic: (documents: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>) => Loader;
+/**
+ * A loader that fails for every URL (no remote loading).
+ *
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const none: Loader;
+/**
+ * Provides a static, in-memory `DocumentLoader`.
+ *
+ * @since 0.1.0
+ * @category layers
+ */
+declare const layerStatic: (documents: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>) => Layer.Layer<DocumentLoader>;
+/**
+ * Provides a `DocumentLoader` from a loader implementation.
+ *
+ * @since 0.1.0
+ * @category layers
+ */
+declare const layer: (loader: Loader) => Layer.Layer<DocumentLoader>;
+/**
+ * Builds a loader on top of an `HttpClient`.
+ *
+ * @since 0.1.0
+ * @category constructors
+ */
+declare const makeHttp: Effect.Effect<Loader, never, HttpClient.HttpClient>;
+/**
+ * A caching `DocumentLoader` backed by the Effect `HttpClient`.
+ *
+ * @since 0.1.0
+ * @category layers
+ */
+declare const layerHttp: Layer.Layer<DocumentLoader, never, HttpClient.HttpClient>;
+export { makeStatic as _, LoadOptions as a, Response as c, fromFetch as d, fromResponse as f, makeHttp as g, layerStatic as h, Link as i, cached as l, layerHttp as m, DocumentLoader_d_exports as n, Loader as o, layer as p, Interpreted as r, RemoteDocument as s, DocumentLoader as t, extractHtml as u, none as v, parseLinkHeader as y };
+//# sourceMappingURL=DocumentLoader-ZUCEVrW5.d.mts.map