@faith-tools/bible-sdk 0.6.0 → 0.7.0

package/dist/data/effect.js

@@ -1,5 +1,5 @@
-import { t as e } from "../providers-D_4UrThl.js";
-import { _ as t, b as n, g as r, h as i, l as a, m as o, n as s, p as c, r as l, s as u, t as d, u as f, v as p, y as m } from "../runtime-C-BCRjZd.js";
+import { t as e } from "../providers-Ci0Bdu9f.js";
+import { _ as t, b as n, g as r, h as i, l as a, m as o, n as s, p as c, r as l, s as u, t as d, u as f, v as p, y as m } from "../runtime-CVlBLU4v.js";
 import { Effect as h, Layer as g, Schema as _ } from "effect";
 // src/data-effect.ts
 var v = _.NonEmptyString.check(_.isTrimmed()), y = (e, t) => _.decodeUnknownEffect(v)(t ?? e.defaultVersionId).pipe(h.mapError((e) => new p({
@@ -39,9 +39,10 @@ function x({ provider: t = e() } = {}) {
 		listChapters: n,
 		getPassageData: n,
 		clearCache: h.void
-	}, u = f(), d = g.succeed(i, {
+	}, u = f(a.cacheTimeToLive), d = g.succeed(i, {
 		id: a.id,
 		defaultVersionId: a.defaultVersionId,
+		cacheTimeToLive: a.cacheTimeToLive,
 		listVersions: () => u.get("versions", () => a.listVersions().pipe(h.tap(s(_.Array(r))))),
 		listBooks: (e) => u.get(JSON.stringify(["books", e]), () => a.listBooks(e).pipe(h.tap(s(_.Array(c))))),
 		listChapters: (e, t) => u.get(JSON.stringify([

package/dist/data.js

@@ -1,5 +1,5 @@
 import { createScriptureClient as e } from "./data/effect.js";
-import { v as t } from "./runtime-C-BCRjZd.js";
+import { v as t } from "./runtime-CVlBLU4v.js";
 import { Effect as n } from "effect";
 // src/data.ts
 function r(t = {}) {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s } from "./providers-D_4UrThl.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s } from "./providers-Ci0Bdu9f.js";
 import { OSIS_BOOK_CODES as c, OSIS_BOOK_NAMES as l, autocompletePassage as u, formatPassageForDisplay as d, getChapterCount as f, getVerseCount as p, parsePassage as m, parseToResolverUrl as h, resolveBookAlias as g, tryParsePassage as _ } from "grab-bcv";
 import { Effect as v, Exit as y, Scope as b } from "effect";
 // src/dom-runtime.ts

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

@@ -1,4 +1,4 @@
-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-C-BCRjZd.js";
+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";

package/dist/providers/helloao.js

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

package/dist/providers/youversion.js

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

package/dist/{providers-D_4UrThl.js → providers-Ci0Bdu9f.js}

@@ -1,4 +1,4 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, u, v as d } from "./runtime-C-BCRjZd.js";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, u, v as d } from "./runtime-CVlBLU4v.js";
 import { Effect as f, Schema as p } from "effect";
 import { FreeUseBibleApi as m } from "free-use-bible-api";
 // src/providers.ts

package/dist/{runtime-C-BCRjZd.js → runtime-CVlBLU4v.js}

@@ -44,6 +44,15 @@ var s = o.Struct({
 		text: o.NonEmptyString,
 		urls: o.Array(o.String)
 	}),
+	publisher: o.optional(o.Struct({
+		copyrightHtml: o.String,
+		infoHtml: o.String
+	})),
+	reporting: o.optional(o.Struct({
+		kind: o.Literal("api-bible-fums"),
+		token: o.NonEmptyString
+	})),
+	cache: o.optional(o.Struct({ expiresAt: o.Number })),
 	licenses: o.Array(o.Struct({
 		name: o.optional(o.String),
 		url: o.String,
@@ -157,19 +166,19 @@ function E() {
 		}
 	];
 }
-function D() {
-	let t = /* @__PURE__ */ new Map(), a = r.runSync(e.makeWith((e) => r.suspend(() => t.get(e)()), {
+function D(t = n.infinity) {
+	let a = /* @__PURE__ */ new Map(), o = r.runSync(e.makeWith((e) => r.suspend(() => a.get(e)()), {
 		capacity: 256,
 		requireServicesAt: "lookup",
-		timeToLive: (e) => i.isSuccess(e) ? n.infinity : n.zero
+		timeToLive: (e) => i.isSuccess(e) ? t : n.zero
 	}));
 	return {
-		get(n, i) {
-			return r.suspend(() => (t.set(n, i), e.get(a, n).pipe(r.ensuring(r.sync(() => {
-				t.get(n) === i && t.delete(n);
+		get(t, n) {
+			return r.suspend(() => (a.set(t, n), e.get(o, t).pipe(r.ensuring(r.sync(() => {
+				a.get(t) === n && a.delete(t);
 			})))));
 		},
-		clear: e.invalidateAll(a)
+		clear: e.invalidateAll(o)
 	};
 }
 // src/runtime.ts