lightnet 3.4.1 → 3.4.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # lightnet
 
+## 3.4.3
+
+### Patch Changes
+
+- [#259](https://github.com/LightNetDev/LightNet/pull/259) [`7e61913`](https://github.com/LightNetDev/LightNet/commit/7e61913cf49863807c25cfdb379a878e47642b03) Thanks [@smn-cds](https://github.com/smn-cds)! - Change language selector icon from "scripts" to "web" icon.
+
+- [#259](https://github.com/LightNetDev/LightNet/pull/259) [`7e61913`](https://github.com/LightNetDev/LightNet/commit/7e61913cf49863807c25cfdb379a878e47642b03) Thanks [@smn-cds](https://github.com/smn-cds)! - Change icon of share button, make it consistent with open button.
+
+## 3.4.2
+
+### Patch Changes
+
+- [#256](https://github.com/LightNetDev/LightNet/pull/256) [`3c005c1`](https://github.com/LightNetDev/LightNet/commit/3c005c10ed55061f00f7d9c74e03be879bd5bb85) Thanks [@smn-cds](https://github.com/smn-cds)! - Improve error messages.
+
 ## 3.4.1
 
 ### Patch Changes

package/README.md

@@ -1,8 +1,10 @@
 # LightNet
 
-Share the message of Jesus and strengthen believers worldwide. LightNet empowers you to create digital media libraries, making your content accessible on the web — including videos, audio, images, and books.
+Share the message of Jesus and strengthen believers worldwide.
 
-LightNet is built as an integration for the [Astro](https://astro.build) framework, enabling the creation of statically generated sites that can be hosted on any file server. These sites are fast, easily extendable, and fully support internationalization.
+LightNet empowers ministries to run their own digital media libraries. They can easily share content in the heart language of the communities they serve - including videos, audio, images, and documents.
+
+It is built as an integration for the [Astro framework](https://astro.build), enabling the creation of statically generated sites that can be hosted on any file server. These sites are fast, easily extendable, and fully support internationalization.
 
 ## Documentation
 

package/__e2e__/fixtures/basics/node_modules/.bin/astro

@@ -6,9 +6,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.1_@types+node@22.14.0_jiti@2.4.2_lightningcss@1.29.1_rollup@4.39.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules/astro/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/astro@5.6.2_@types+node@22.14.1_jiti@2.4.2_lightningcss@1.29.1_rollup@4.40.0_terser@5.39.0_typescript@5.8.3_yaml@2.7.1/node_modules:/home/runner/work/LightNet/LightNet/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../astro/astro.js" "$@"

package/__e2e__/fixtures/basics/package.json

@@ -4,11 +4,11 @@
   "version": "0.0.1",
   "private": "true",
   "dependencies": {
-    "@astrojs/react": "^4.2.3",
+    "@astrojs/react": "^4.2.4",
     "@astrojs/tailwind": "^6.0.2",
     "@lightnet/decap-admin": "^3.1.0",
-    "astro": "^5.6.1",
-    "lightnet": "^3.4.0",
+    "astro": "^5.6.2",
+    "lightnet": "^3.4.1",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "sharp": "^0.33.5",

package/package.json

@@ -2,7 +2,7 @@
   "name": "lightnet",
   "type": "module",
   "license": "MIT",
-  "version": "3.4.1",
+  "version": "3.4.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/LightNetDev/lightnet",
@@ -45,17 +45,16 @@
     "@iconify-json/mdi": "^1.2.3",
     "@iconify/tailwind": "^1.2.0",
     "@tailwindcss/typography": "^0.5.16",
-    "@types/react": "^19.1.0",
+    "@types/react": "^19.1.2",
     "daisyui": "^4.12.24",
     "fuse.js": "^7.1.0",
-    "i18next": "^24.2.3",
-    "marked": "^15.0.7",
-    "yaml": "^2.7.1",
-    "zod-validation-error": "^3.4.0"
+    "i18next": "^25.0.0",
+    "marked": "^15.0.8",
+    "yaml": "^2.7.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.51.1",
-    "@types/node": "^22.14.0",
+    "@types/node": "^22.14.1",
     "vitest": "^3.1.1"
   },
   "scripts": {

package/src/astro-integration/integration.ts

@@ -23,7 +23,8 @@ export function lightnet(lightnetConfig: LightnetConfig): AstroIntegration {
         const config = verifySchema(
           configSchema,
           lightnetConfig,
-          "Invalid config passed to LightNet integration.",
+          "Invalid LightNet configuration",
+          "Fix these errors on the LightNet configuration inside astro.config.mjs:",
         )
 
         injectRoute({

package/src/content/get-media-items.ts

@@ -23,5 +23,6 @@ const prepareItem = async (item: unknown) => {
     mediaItemEntrySchema,
     item,
     (id) => `Invalid media item: ${id}`,
+    (id) => `Fix these issues inside "src/content/media/${id}.json":`,
   )
 }

package/src/content/get-media-types.ts

@@ -7,7 +7,8 @@ export const getMediaType = async (id: string) => {
   return verifySchema(
     mediaTypeEntrySchema,
     await getEntry("media-types", id),
-    `Received invalid media type ${id}.`,
+    (id) => `Invalid media type: "${id}"`,
+    (id) => `Fix these issues inside "src/content/media-types/${id}.json":`,
   )
 }
 
@@ -17,7 +18,8 @@ export const getMediaTypes = async () => {
     verifySchema(
       mediaTypeEntrySchema,
       type,
-      (id) => `Received invalid media type '${id}'.`,
+      (id) => `Invalid media type: "${id}"`,
+      (id) => `Fix these issues inside "src/content/media-types/${id}.json":`,
     ),
   )
 }

package/src/content/resolve-category-label.ts

@@ -12,8 +12,8 @@ export const resolveCategoryLabel = (
   const category = categories.find((c) => c.id === categoryId)
   if (!category) {
     throw new AstroError(
-      `Unknown category: ${categoryId}`,
-      "Make sure you add the category to the categories content collection.",
+      `Missing category "${categoryId}"`,
+      `To fix the issue, add a category at "src/content/categories/${categoryId}.json".`,
     )
   }
   return translate(category.data.label)

package/src/i18n/resolve-default-locale.ts

@@ -11,8 +11,8 @@ export const resolveDefaultLocale = ({
   const defaultLanguage = languages.find((l) => l.isDefaultSiteLanguage)
   if (!defaultLanguage) {
     throw new AstroError(
-      "No default site language has been set",
-      "Make sure you have set one language to be the default language by setting the isDefaultSiteLanguage to `true`.",
+      "No default site language set",
+      "To fix the issue, set isDefaultSiteLanguage for one language in the LightNet configuration in your astro.config.mjs file.",
     )
   }
   return defaultLanguage.code

package/src/i18n/resolve-language.ts

@@ -12,7 +12,10 @@ export const resolveLanguage = (bcp47: string) => {
   const language = languages[bcp47]
 
   if (!language) {
-    throw new AstroError(`There is no language definition for: ${bcp47}`)
+    throw new AstroError(
+      `Missing language code "${bcp47}"`,
+      `To fix the issue, add a language with the code "${bcp47}" to the LightNet configuration in your astro.config.mjs file.`,
+    )
   }
   return {
     ...language,

package/src/i18n/translate.ts

@@ -47,7 +47,7 @@ export function useTranslate(bcp47: string | undefined): TranslateFn {
     if (value.match(/^(?:ln|x)\../i)) {
       throw new AstroError(
         `Missing translation: '${key}' is undefined for language '${resolvedLocale}'.`,
-        `Add a translation for '${key}' to src/translations/${resolvedLocale}.yml`,
+        `To fix the issue, add a translation for '${key}' to src/translations/${resolvedLocale}.yml`,
       )
     }
     return value

package/src/layouts/components/Favicon.astro

@@ -17,8 +17,8 @@ const favicons = config.favicon?.map((favicon) => {
   const type = faviconTypes[extname(favicon.href)]
   if (!type) {
     throw new AstroError(
-      `Unsupported favicon ${favicon.href}`,
-      "favicon must be a .ico, .gif, .jpg, .png, or .svg file",
+      `Unsupported favicon type "${extname(favicon.href)}"`,
+      "To fix the issue, set the favicon href to a path ending with .ico, .gif, .jpg, .png, or .svg.",
     )
   }
   return { ...favicon, type }

package/src/layouts/components/LanguagePicker.astro

@@ -27,7 +27,7 @@ function currentPathWithLocale(locale: string) {
 
 {
   translations.length > 1 && (
-    <Menu icon="mdi--translate" label="ln.header.select-language">
+    <Menu icon="mdi--web" label="ln.header.select-language">
       {translations.map(({ label, locale, active, href }) => (
         <MenuItem href={href} hreflang={locale} active={active}>
           {label}

package/src/pages/details-page/DetailsPageRoute.astro

@@ -33,8 +33,8 @@ if (detailsPage?.layout === "custom") {
   ] as () => Promise<any>
   if (!customDetailsImport) {
     throw new AstroError(
-      `Unknown details page ${detailsPage.customComponent}`,
-      "Make sure to add your details component within /src/details-pages/",
+      `Missing custom details page "${detailsPage.customComponent}"`,
+      `To fix the issue, add your details page on "/src/details-pages/${detailsPage.customComponent}".`,
     )
   }
   CustomDetails = (await customDetailsImport()).default

package/src/pages/details-page/components/MediaCollection.astro

@@ -14,7 +14,10 @@ const { collectionId, disableItem } = Astro.props
 
 const collection = await getEntry("media-collections", collectionId)
 if (!collection) {
-  throw new AstroError(`Unknown media collection id ${collection}.`)
+  throw new AstroError(
+    `Missing media-collection "${collectionId}".`,
+    `To fix the issue, add a media-collection at "src/content/media-collections/${collectionId}.json".`,
+  )
 }
 const items = (
   await queryMediaItems(getMediaItems(), {

package/src/pages/details-page/components/main-details/AudioPlayer.astro

@@ -9,7 +9,7 @@ const { src, className } = Astro.props
 if (!src.endsWith(".mp3")) {
   throw new AstroError(
     `Unsupported audio file ${src}`,
-    "Mp3 is the only supported format.",
+    "To fix the issue, reference a mp3 file.",
   )
 }
 ---

package/src/pages/details-page/components/main-details/OpenButton.astro

@@ -18,11 +18,6 @@ const content = createContentMetadata(item.data.content[0])
   target={content.target}
   hreflang={item.data.language}
 >
-  {
-    content.canBeOpened
-      ? Astro.locals.i18n.t(openActionLabel)
-      : Astro.locals.i18n.t("ln.details.download")
-  }
   {
     content.isExternal && (
       <Icon
@@ -31,4 +26,9 @@ const content = createContentMetadata(item.data.content[0])
       />
     )
   }
+  {
+    content.canBeOpened
+      ? Astro.locals.i18n.t(openActionLabel)
+      : Astro.locals.i18n.t("ln.details.download")
+  }
 </a>

package/src/pages/details-page/components/main-details/ShareButton.astro

@@ -10,7 +10,7 @@ interface Props {
   class="flex cursor-pointer items-center justify-center gap-2 rounded-2xl bg-gray-200 px-6 py-3 font-bold uppercase text-gray-600 shadow-sm hover:bg-gray-300"
   class:list={[Astro.props.className]}
   id="share-btn"
-  ><Icon className="mdi--share-variant-outline" ariaLabel="" />
+  ><Icon className="mdi--share" ariaLabel="" />
   {Astro.locals.i18n.t("ln.details.share")}</button
 >
 <div

package/src/pages/search-page/hooks/use-search.ts

@@ -20,7 +20,9 @@ export function useSearch() {
       try {
         const response = await fetch("/api/search.json")
         if (!response.ok) {
-          throw new Error("Network response was not ok")
+          throw new Error(
+            "Was not able to load search results from /api/search.json.",
+          )
         }
         const { items }: SearchResponse = await response.json()
         fuse.current = new Fuse(items, {

package/src/utils/verify-schema.ts

@@ -1,15 +1,15 @@
 import { AstroError } from "astro/errors"
 import { z } from "astro/zod"
-import { fromZodError } from "zod-validation-error"
 
 export async function verifySchemaAsync<T extends z.Schema>(
   schema: T,
   toVerify: unknown,
   errorMessage: string | ((id: string | undefined) => string),
+  hint: string | ((id: string | undefined) => string),
 ): Promise<z.output<T>> {
   const parsed = await schema.safeParseAsync(toVerify)
   if (!parsed.success) {
-    throwParseError(toVerify, errorMessage, parsed)
+    throwParseError(toVerify, errorMessage, hint, parsed)
   }
   return parsed.data
 }
@@ -18,10 +18,11 @@ export function verifySchema<T extends z.Schema>(
   schema: T,
   toVerify: unknown,
   errorMessage: string | ((id: string | undefined) => string),
+  hint: string | ((id: string | undefined) => string),
 ): z.output<T> {
   const parsed = schema.safeParse(toVerify, {})
   if (!parsed.success) {
-    throwParseError(toVerify, errorMessage, parsed)
+    throwParseError(toVerify, errorMessage, hint, parsed)
   }
   return parsed.data
 }
@@ -29,10 +30,15 @@ export function verifySchema<T extends z.Schema>(
 function throwParseError(
   toVerify: unknown,
   errorMessage: string | ((id: string | undefined) => string),
+  hint: string | ((id: string | undefined) => string),
   parsed: z.SafeParseError<unknown>,
 ) {
   const id = z.object({ id: z.string() }).safeParse(toVerify).data?.id
   const message =
     typeof errorMessage === "string" ? errorMessage : errorMessage(id)
-  throw new AstroError(message, fromZodError(parsed.error).toString())
+  const hintFinal = typeof hint === "string" ? hint : hint(id)
+  const issues = parsed.error.errors
+    .map((e) => `- ${e.path.join(".")}: ${e.message}`)
+    .join("\n")
+  throw new AstroError(message, `${hintFinal}\n\n${issues}`)
 }