@faith-tools/bible-sdk 0.0.0-stage → 0.7.0

package/dist/providers/api-bible.js

@@ -0,0 +1,221 @@
+import { a as e, d as t, l as n, r, s as i, u as a, v as o } from "../runtime-CVlBLU4v.js";
+import { Clock as s, Effect as c, Schema as l } from "effect";
+// src/providers/api-bible.ts
+var u = {
+	contentType: "json",
+	includeTitles: !0,
+	includeNotes: !1,
+	includeChapterNumbers: !1,
+	includeVerseNumbers: !1
+}, d = "https://api.bible/", f = "https://api.bible/terms-and-conditions", p = "14 days", m = 12096e5, h = l.optional(l.NullOr(l.String)), g = l.Struct({
+	id: l.NonEmptyString,
+	name: l.String,
+	nameLocal: h,
+	abbreviation: l.String,
+	abbreviationLocal: h,
+	language: l.Struct({
+		id: e,
+		name: l.String,
+		scriptDirection: h
+	}),
+	copyright: h,
+	info: h
+}), _ = l.Struct({
+	style: l.optional(l.String),
+	verseId: l.optional(l.String)
+}), v = l.suspend(() => l.Union([l.Struct({
+	type: l.Literal("text"),
+	text: l.String,
+	attrs: l.optional(_)
+}), l.Struct({
+	type: l.Literal("tag"),
+	name: l.String,
+	attrs: l.optional(_),
+	items: l.Array(v)
+})])), y = l.Struct({
+	data: l.Struct({
+		id: l.NonEmptyString,
+		bibleId: l.NonEmptyString,
+		reference: l.NonEmptyString,
+		copyright: l.NonEmptyString,
+		content: l.Array(v)
+	}),
+	meta: l.Struct({ fumsToken: l.NonEmptyString })
+}), b = (e) => ({
+	id: e.id,
+	title: e.nameLocal || e.name,
+	abbreviation: e.abbreviationLocal || e.abbreviation,
+	language: new Intl.Locale(e.language.id).language,
+	languageName: e.language.name
+}), x = () => new o({
+	code: "invalid_response",
+	message: "API.Bible returned incomplete or inconsistent passage data."
+}), S = (e) => (t) => l.decodeUnknownEffect(e)(t).pipe(c.mapError(x)), C = (e) => {
+	let t = l.decodeUnknownOption(l.Struct({ statusCode: l.Number }))(e), n = l.decodeUnknownOption(l.Struct({ name: l.String }))(e), r = t._tag === "Some" ? t.value.statusCode : 0, i = n._tag === "Some" && n.value.name === "ValidationError" ? "invalid_response" : r === 401 || r === 403 ? "authentication" : r === 429 ? "rate_limit" : r >= 400 && r < 500 ? "unavailable" : "network";
+	return new o({
+		code: i,
+		message: `API.Bible request failed (${i}).`
+	});
+}, w = (e, t) => r(e, async (e) => {
+	try {
+		return await t(e);
+	} catch (e) {
+		throw C(e);
+	}
+}), T = (e) => e.replace(/^([A-Z0-9]{3}\.[1-9]\d*\.)([1-9]\d*)-\1([1-9]\d*)$/, "$1$2-$3");
+function E(e) {
+	let t = /* @__PURE__ */ new Set(), n = (e) => {
+		if (e.type === "text") return e.attrs?.verseId && t.add(e.attrs.verseId), e.text;
+		let r = e.attrs?.style ?? "";
+		if (e.name === "note" || e.name === "verse" || e.name === "chapter" || /^(?:s\d*|sp|qa|ms\d*|mr|r|sr|mt\d*|mte\d*|cl|cp|cd|v|c|f\w*|x\w*)$/.test(r)) return "";
+		let i = e.items.map(n).join("");
+		return e.name === "para" ? i + (/^q[rmc]?\d*$/.test(r) ? "\n" : "\n\n") : i;
+	};
+	return {
+		text: e.map(n).join("").replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim(),
+		verseIds: t
+	};
+}
+function D({ client: e, defaultVersionId: r }) {
+	if (typeof window < "u") throw new o({
+		code: "unsupported",
+		message: "API.Bible requires a server-side client. Never expose its private key in a browser."
+	});
+	let h = a(p), _ = (t) => h.get(t, () => c.gen(function* () {
+		let n = yield* s.currentTimeMillis, { data: r } = yield* w("apiBible.version", (n) => e.bibles.get(t, n)).pipe(c.flatMap(S(l.Struct({ data: g }))));
+		return r.id !== t || !r.copyright?.trim() ? yield* x() : {
+			data: r,
+			expiresAt: n + m
+		};
+	}));
+	return {
+		id: "api-bible",
+		defaultVersionId: r,
+		cacheTimeToLive: p,
+		clearCache: h.clear,
+		listVersions: c.fn("apiBible.listVersions")(function* () {
+			let { data: t } = yield* w("apiBible.versions", (t) => e.bibles.list({ includeFullDetails: !0 }, t)).pipe(c.flatMap(S(l.Struct({ data: l.Array(g) }))));
+			return t.map(b);
+		}),
+		listBooks: c.fn("apiBible.listBooks")(function* (t) {
+			let { data: n } = yield* w("apiBible.books", (n) => e.books.list(t, void 0, n)).pipe(c.flatMap(S(l.Struct({ data: l.Array(l.Struct({
+				id: l.NonEmptyString,
+				name: l.String
+			})) }))));
+			return n.map((e) => ({
+				id: e.id,
+				title: e.name
+			}));
+		}),
+		listChapters: c.fn("apiBible.listChapters")(function* (t, r) {
+			yield* i(r);
+			let { data: a } = yield* w("apiBible.chapters", (n) => e.chapters.list(t, r, n)).pipe(c.flatMap(S(l.Struct({ data: l.Array(l.Struct({
+				id: l.String,
+				number: l.String
+			})) })))), o = [];
+			for (let e of a) {
+				if (e.number === "intro") continue;
+				let t = yield* n(e.id).pipe(c.mapError(x));
+				if (t.book !== r || t.first !== void 0 || String(t.chapter) !== e.number) return yield* x();
+				o.push({
+					passageId: e.id,
+					number: t.chapter
+				});
+			}
+			return o;
+		}),
+		getPassageData: c.fn("apiBible.getPassageData")(function* (r, i) {
+			let { book: a, chapter: s, first: l, last: p } = yield* n(i), { data: m, expiresAt: h } = yield* _(r), g = `${a}.${s}${l === void 0 ? "" : `.${l}${p === l ? "" : `-${a}.${s}.${p}`}`}`, { data: v, meta: C } = yield* w("apiBible.passage", (t) => l === void 0 ? e.chapters.get(r, g, u, t) : e.passages.get(r, g, u, t)).pipe(c.flatMap(S(y)));
+			if (v.bibleId !== r || T(v.id) !== T(g)) return yield* x();
+			let { text: D, verseIds: O } = E(v.content), k = [];
+			for (let e of O) {
+				let t = yield* n(T(e)).pipe(c.mapError(x));
+				if (t.book !== a || t.chapter !== s || t.first === void 0 || l !== void 0 && (t.first < l || t.last > p)) return yield* x();
+				k.push({
+					first: t.first,
+					last: t.last
+				});
+			}
+			let A = (e) => k.some((t) => t.first <= e && t.last >= e);
+			return !k.length || l !== void 0 && (!A(l) || !A(p)) ? yield* new o({
+				code: "unavailable",
+				message: "API.Bible did not return the requested coverage; passages may be limited to 200 verses."
+			}) : {
+				provider: "api-bible",
+				source: {
+					url: d,
+					versionId: r
+				},
+				requestedPassageId: i,
+				passageId: T(v.id),
+				reference: v.reference,
+				text: D,
+				version: {
+					...b(m),
+					sourceLanguage: m.language.id
+				},
+				attribution: {
+					text: `${v.copyright} · ${b(m).abbreviation} · Source: API.Bible`,
+					urls: [d, f]
+				},
+				publisher: {
+					copyrightHtml: m.copyright,
+					infoHtml: m.info ?? ""
+				},
+				reporting: {
+					kind: "api-bible-fums",
+					token: C.fumsToken
+				},
+				cache: { expiresAt: h },
+				licenses: [{ url: f }],
+				numbering: "unknown",
+				display: {
+					format: "text",
+					whitespace: "pre-wrap",
+					attributionPlacement: "after-passage",
+					direction: m.language.scriptDirection === "rtl" ? "rtl" : m.language.scriptDirection === "ltr" ? "ltr" : void 0,
+					language: b(m).language
+				},
+				instructions: [
+					...t(),
+					{
+						code: "api-bible-fums",
+						level: "required",
+						appliesTo: "all",
+						text: "For web displays, report reporting.token for each actual view, including cache hits. Fetching or prefetching is not a view. The host owns anonymous device/session identifiers and reporting; native-only exemptions do not cover web views.",
+						urls: ["https://care.api.bible/article/417-understanding-fums"]
+					},
+					{
+						code: "api-bible-publisher",
+						level: "required",
+						appliesTo: "all",
+						text: "Preserve publisher copyrightHtml and infoHtml on a linked copyright/about page and identify the translation in context. These fields are untrusted upstream HTML: sanitize before rendering, never insert them directly. Keep the visible API.Bible source link.",
+						urls: [f]
+					},
+					{
+						code: "api-bible-cache",
+						level: "required",
+						appliesTo: "all",
+						text: "cache.expiresAt is an epoch-millisecond refresh deadline, not permission for offline storage. Refresh downstream caches by that deadline. Never retain metadata or content over 30 days without refresh. Honor removal/revocation requests immediately or within their specified shorter deadline.",
+						urls: ["https://care.api.bible/article/401-caching-content", f]
+					},
+					{
+						code: "api-bible-usage",
+						level: "required",
+						appliesTo: "all",
+						text: "Each application needs its own private server key and applicable plan and translation licenses. The host must satisfy DRM, print/device/territory limits, content integrity, account agreements, and removal duties. A working key or this adapter does not establish compliance. Starter is noncommercial even for public-domain text.",
+						urls: [f]
+					},
+					{
+						code: "api-bible-ai",
+						level: "required",
+						appliesTo: "all",
+						text: "Do not send copyrighted or Creative Commons Scripture to an LLM as prompt context or training data without the required permissions. Public-domain runtime prompts are permitted; confirm training and audio/export permissions separately.",
+						urls: ["https://care.api.bible/article/405-express-licensing-faqs", f]
+					}
+				]
+			};
+		})
+	};
+}
+export { D as createApiBibleProvider };

package/dist/providers/fetch-bible.js

@@ -0,0 +1,254 @@
+import { a as e, d as t, f as n, i as r, l as i, n as a, o, r as s, s as c, u as l, v as u } from "../runtime-CVlBLU4v.js";
+import { Effect as d, Schema as f } from "effect";
+import { FetchClient as p } from "@gracious.tech/fetch-client";
+import m from "sanitize-html";
+// src/providers/fetch-bible.ts
+var h = {
+	containerAttributes: { class: "fetch-bible fb-plain scripture-bible no-notes no-chapters" },
+	stylesheets: [{
+		kind: "bible",
+		href: "https://cdn.jsdelivr.net/npm/@gracious.tech/fetch-client@2.6.0/dist/client.css"
+	}]
+}, g = (e) => d.try({
+	try: e,
+	catch: (e) => new u({
+		code: "invalid_response",
+		message: "fetch.bible returned invalid resource data.",
+		cause: e
+	})
+}), _ = f.Union([f.String, f.Struct({
+	type: f.Literals(["heading", "note"]),
+	contents: f.String
+})]), v = a(f.Array(f.Struct({
+	chapter: f.Int,
+	verse: f.Int,
+	content: f.Array(_)
+})));
+function y(_) {
+	let y = {
+		usage: { ..._.usage },
+		remember_fetches: !1
+	}, b = new p(y), x = l(), S = (e) => ({
+		id: e.id,
+		title: e.name_local || e.name_english,
+		abbreviation: e.name_local_abbrev || e.name_english_abbrev || e.id,
+		language: new Intl.Locale(e.language).language
+	}), C = d.fn("fetchBible.catalog")(function* () {
+		return yield* x.get("catalog", () => d.gen(function* () {
+			let t = yield* s("fetchBible.collection", () => b.fetch_collection()), n = yield* g(() => t.bibles.get_resources()).pipe(d.tap(a(f.Array(f.Struct({ language: e })))));
+			return {
+				collection: t,
+				resources: new Map(n.map((e) => [e.id, e]))
+			};
+		}));
+	}), w = d.fnUntraced(function* (e, t) {
+		let { collection: n, resources: r } = yield* C(), i = r.get(e);
+		return i ? t && !n.bibles.has_book(e, t) ? yield* new u({
+			code: "unavailable",
+			message: "Book is not available in this version."
+		}) : {
+			collection: n,
+			item: i
+		} : yield* new u({
+			code: "unavailable",
+			message: "Version is unavailable for this usage configuration."
+		});
+	}), T = d.fn("fetchBible.textBook")(function* (e, t) {
+		let { collection: n, item: r } = yield* w(e, t);
+		return {
+			collection: n,
+			item: r,
+			contents: yield* x.get(JSON.stringify([
+				e,
+				t,
+				"txt"
+			]), () => s("fetchBible.textBook", () => n.bibles.fetch_book(e, t, "txt")).pipe(d.tap((e) => g(() => e.get_list()).pipe(d.flatMap(v)))))
+		};
+	}), E = (e, t) => d.gen(function* () {
+		let { collection: n } = yield* w(e, t);
+		return yield* x.get(JSON.stringify([
+			e,
+			t,
+			"html"
+		]), () => s("fetchBible.htmlBook", () => n.bibles.fetch_book(e, t, "html")).pipe(d.tap((e) => g(() => e.get_list()).pipe(d.flatMap(a(f.Array(f.Struct({ content: f.String }))))))));
+	}), D = (e) => x.get(JSON.stringify([e, "books"]), () => d.gen(function* () {
+		let { collection: t } = yield* w(e);
+		return yield* s("fetchBible.extras", () => t.bibles.fetch_translation_extras(e)), yield* g(() => t.bibles.get_books(e));
+	})), O = {
+		id: "fetch-bible",
+		defaultVersionId: "eng_bsb",
+		clearCache: x.clear.pipe(d.andThen(d.sync(() => {
+			b = new p(y);
+		}))),
+		listVersions: d.fn("fetchBible.listVersions")(function* () {
+			let { collection: e, resources: t } = yield* C();
+			return [...t.values()].map((t) => ({
+				...S(t),
+				languageName: e.bibles.get_language(t.language)?.name_english
+			}));
+		}),
+		listBooks: d.fn("fetchBible.listBooks")(function* (e) {
+			return (yield* D(e)).filter((e) => e.available).map((e) => ({
+				id: e.id.toUpperCase(),
+				title: e.name_local || e.name_english
+			}));
+		}),
+		listChapters: d.fn("fetchBible.listChapters")(function* (e, t) {
+			let n = yield* c(t), { contents: r } = yield* T(e, n.toLowerCase());
+			return [...new Set(r.get_list().map((e) => e.chapter))].map((e) => ({
+				number: e,
+				passageId: `${t}.${e}`
+			}));
+		}),
+		getPassageData: d.fn("fetchBible.getPassageData")(function* (e, r) {
+			let { book: a, chapter: o, first: s, last: c } = yield* i(r), l = a.toLowerCase(), { collection: d, item: f, contents: p } = yield* T(e, l), g = p.get_list(o, 1, o).map((e) => e.verse);
+			yield* n(g, s, c);
+			let _ = p.get_passage(o, s ?? 1, o, c ?? g.at(-1), {
+				attribute: !1,
+				headings: !1,
+				notes: !1,
+				verse_nums: !1
+			});
+			if (a === "PSA" && (s === void 0 || s === 1)) {
+				let t = yield* E(e, l), n = [];
+				m(t.get_verse(o, 1, { attribute: !1 }), {
+					allowedTags: m.defaults.allowedTags,
+					allowedAttributes: { "*": ["class"] },
+					exclusiveFilter: (e) => {
+						let t = e.attribs.class?.split(/\s+/) ?? [];
+						return t.includes("fb-d") ? (n.push(e.text.trim()), !0) : e.tag === "sup" || t.includes("fb-note");
+					}
+				}), n.length && (_ = `${n.join("\n")}\n\n${_}`);
+			}
+			let v = p.get_attribution(f.licenses[0]).trim();
+			if (!v) return yield* new u({
+				code: "unavailable",
+				message: "This Bible version has no display attribution."
+			});
+			let y = d.bibles.get_book_url(e, l, "txt"), b = (yield* D(e)).find((e) => e.id === l).name, x = [{
+				versions: [
+					"eng_bstj",
+					"eng_bstjb",
+					"grc_lxx"
+				],
+				book: "EXO",
+				firstChapter: 35,
+				firstVerse: 1,
+				lastChapter: 40,
+				lastVerse: 38
+			}, {
+				versions: [
+					"eng_bst",
+					"eng_bstb",
+					"eng_bstj",
+					"eng_bstjb",
+					"grc_bre",
+					"grc_lxx"
+				],
+				book: "JER",
+				firstChapter: 25,
+				firstVerse: 14,
+				lastChapter: 52,
+				lastVerse: 34
+			}].filter((t) => t.versions.includes(e)).map((e) => ({
+				kind: "source-trimming",
+				startPassageId: `${e.book}.${e.firstChapter}.${e.firstVerse}`,
+				endPassageId: `${e.book}.${e.lastChapter}.${e.lastVerse}`,
+				appliesToRequest: a === e.book && o >= e.firstChapter && o <= e.lastChapter && (o !== e.firstChapter || c === void 0 || c >= e.firstVerse) && (o !== e.lastChapter || s === void 0 || s <= e.lastVerse)
+			}));
+			return {
+				provider: "fetch-bible",
+				source: {
+					url: y,
+					versionId: f.id
+				},
+				requestedPassageId: r,
+				passageId: r,
+				reference: `${b} ${o}${s === void 0 ? "" : `:${s}${c === s ? "" : `-${c}`}`}`,
+				text: _.trim(),
+				version: {
+					...S(f),
+					sourceLanguage: f.language
+				},
+				attribution: {
+					text: `${v} · Source: fetch.bible`,
+					urls: [
+						f.attribution_url,
+						...f.licenses.map((e) => e.url),
+						"https://fetch.bible/"
+					].filter(Boolean)
+				},
+				licenses: f.licenses.map((e) => ({
+					name: e.name,
+					url: e.url,
+					restrictions: { ...e.restrictions }
+				})),
+				numbering: "kjv",
+				sourceLimitations: x,
+				display: {
+					format: "text",
+					whitespace: "pre-wrap",
+					attributionPlacement: "after-passage",
+					direction: f.direction,
+					language: S(f).language,
+					nativeHtml: h
+				},
+				instructions: [
+					...t(),
+					{
+						code: "fetch-bible-normalization",
+						level: "notice",
+						appliesTo: "all",
+						text: "The official collection uses KJV-normalized numbering, retains empty verse slots, and contains only the Protestant 66-book canon. sourceLimitations identifies documented trimmed ranges for this edition and whether the request overlaps them, not why an individual verse is empty. This is not an exhaustive lossless-source guarantee.",
+						urls: ["https://fetch.bible/content/", "https://fetch.bible/access/"]
+					},
+					{
+						code: "fetch-bible-license",
+						level: "required",
+						appliesTo: "all",
+						text: "Usage filtering does not verify legal permission. Check the returned licenses and restrictions for the selected translation, including commercial, derivative, attribution, and share-alike conditions.",
+						urls: ["https://fetch.bible/legal/terms/"]
+					},
+					{
+						code: "fetch-bible-native-html",
+						level: "required",
+						appliesTo: "html",
+						text: "If you request native HTML through the display provider, apply its returned .fetch-bible container class and client stylesheet. The stylesheet separates notes from Scripture. Do not append inline attribution when displaying the separate attribution field.",
+						urls: ["https://fetch.bible/access/client/"]
+					}
+				]
+			};
+		}),
+		getPassageDisplay: d.fn("fetchBible.getPassageDisplay")(function* (e, t) {
+			let n = yield* O.getPassageData(e, t), { book: r, chapter: a, first: s, last: c } = yield* i(t), l = yield* E(e, r.toLowerCase()), u = s === void 0 ? l.get_chapter(a, { attribute: !1 }) : l.get_passage(a, s, a, c, { attribute: !1 });
+			return {
+				html: m(u, {
+					allowedTags: m.defaults.allowedTags,
+					allowedAttributes: {
+						"*": [
+							"class",
+							"data-c",
+							"data-v",
+							"dir",
+							"lang"
+						],
+						a: ["href"]
+					},
+					allowedSchemes: ["http", "https"],
+					exclusiveFilter: (e) => e.attribs.class?.split(/\s+/).includes("fb-note") || !1
+				}),
+				version: n.version,
+				attribution: n.attribution.text,
+				attributionHtml: `${o(n.attribution.text.replace(" · Source: fetch.bible", ""), n.licenses[0]?.url || "")} · Source: ${o("fetch.bible", "https://fetch.bible/")}`,
+				direction: n.display.direction,
+				containerAttributes: {
+					...h.containerAttributes,
+					lang: n.display.language || ""
+				},
+				stylesheets: h.stylesheets
+			};
+		})
+	};
+	return r(O);
+}
+export { y as createFetchBibleProvider };

package/dist/providers/helloao.js

@@ -0,0 +1 @@
+export { t as createHelloAOProvider, i as helloaoProvider } from "../providers-Ci0Bdu9f.js";

package/dist/providers/youversion.js

@@ -0,0 +1 @@
+export { n as createYouVersionProvider } from "../providers-Ci0Bdu9f.js";