@better-translate/astro 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jorge Alvarenga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @better-translate/astro
+
+`@better-translate/astro` adds request helpers, middleware, and localized content helpers for Astro. Use it with `@better-translate/core` when your Astro app needs request-aware translations.
+
+Full docs: [better-translate-placeholder.com/en/docs/adapters/astro](https://better-translate-placeholder.com/en/docs/adapters/astro)

package/dist/chunk-2ZLSODTJ.js

@@ -0,0 +1,105 @@
+import {
+  readRequestCached
+} from "./chunk-3ERZEJZW.js";
+
+// src/server.ts
+import {
+  getRequestLocale as getStoredRequestLocale,
+  resolveRequestLocale,
+  setRequestLocale as setStoredRequestLocale
+} from "@better-translate/core/server";
+function getRequestConfig(factory) {
+  return factory;
+}
+function setRequestLocale(locale) {
+  setStoredRequestLocale(locale);
+}
+function createServerHelpers(requestConfig) {
+  const requestConfigCacheKey = /* @__PURE__ */ Symbol("better-translate-astro-request-config");
+  function readRequestConfig() {
+    return readRequestCached(requestConfigCacheKey, async () => {
+      const resolved = await requestConfig();
+      const translator = resolved.translator;
+      return {
+        locale: resolved.locale,
+        translator
+      };
+    });
+  }
+  async function getResolvedLocale(options) {
+    const { locale: configLocale, translator } = await readRequestConfig();
+    return resolveRequestLocale(translator, {
+      locale: options?.config?.locale ?? options?.locale,
+      requestLocale: getStoredRequestLocale(),
+      configLocale
+    });
+  }
+  async function getDirection(options) {
+    const [{ translator }, locale] = await Promise.all([
+      readRequestConfig(),
+      getResolvedLocale(options)
+    ]);
+    return translator.getDirection({
+      config: typeof options?.config?.rtl === "boolean" ? {
+        rtl: options.config.rtl
+      } : void 0,
+      locale
+    });
+  }
+  async function isRtl(options) {
+    return await getDirection(options) === "rtl";
+  }
+  return {
+    async getAvailableLanguages() {
+      return (await readRequestConfig()).translator.getAvailableLanguages();
+    },
+    getDirection,
+    async getLocale() {
+      return getResolvedLocale();
+    },
+    async getMessages() {
+      const [{ translator }, locale] = await Promise.all([
+        readRequestConfig(),
+        getResolvedLocale()
+      ]);
+      const loadedMessages = await translator.loadLocale(locale);
+      const cachedMessages = translator.getMessages()[locale];
+      if (loadedMessages) {
+        return loadedMessages;
+      }
+      if (cachedMessages) {
+        return cachedMessages;
+      }
+      throw new Error(
+        `Locale "${locale}" messages are not available. Preload them or register a loader in your Better Translate core config.`
+      );
+    },
+    isRtl,
+    async getTranslations(options) {
+      const [{ translator }, locale] = await Promise.all([
+        readRequestConfig(),
+        getResolvedLocale(options)
+      ]);
+      await translator.loadLocale(locale);
+      return ((...args) => {
+        const [key, translateOptions] = args;
+        return translator.t(
+          key,
+          {
+            ...translateOptions ?? {},
+            locale
+          }
+        );
+      });
+    },
+    async getTranslator() {
+      return (await readRequestConfig()).translator;
+    }
+  };
+}
+
+export {
+  getRequestConfig,
+  setRequestLocale,
+  createServerHelpers
+};

package/dist/chunk-3ERZEJZW.js

@@ -0,0 +1,27 @@
+// src/request-cache.ts
+import { AsyncLocalStorage } from "async_hooks";
+var requestCacheStorage = new AsyncLocalStorage();
+function getOrCreateRequestCacheStore() {
+  const existingStore = requestCacheStorage.getStore();
+  if (existingStore) {
+    return existingStore;
+  }
+  const nextStore = {
+    cache: /* @__PURE__ */ new Map()
+  };
+  requestCacheStorage.enterWith(nextStore);
+  return nextStore;
+}
+function readRequestCached(key, factory) {
+  const store = getOrCreateRequestCacheStore();
+  if (store.cache.has(key)) {
+    return store.cache.get(key);
+  }
+  const value = factory();
+  store.cache.set(key, value);
+  return value;
+}
+
+export {
+  readRequestCached
+};

package/dist/content.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/content.ts
+var content_exports = {};
+__export(content_exports, {
+  ContentDocumentNotFoundError: () => ContentDocumentNotFoundError,
+  createContentCollectionHelpers: () => createContentCollectionHelpers
+});
+module.exports = __toCommonJS(content_exports);
+var import_server = require("@better-translate/core/server");
+
+// src/request-cache.ts
+var import_node_async_hooks = require("async_hooks");
+var requestCacheStorage = new import_node_async_hooks.AsyncLocalStorage();
+function getOrCreateRequestCacheStore() {
+  const existingStore = requestCacheStorage.getStore();
+  if (existingStore) {
+    return existingStore;
+  }
+  const nextStore = {
+    cache: /* @__PURE__ */ new Map()
+  };
+  requestCacheStorage.enterWith(nextStore);
+  return nextStore;
+}
+function readRequestCached(key, factory) {
+  const store = getOrCreateRequestCacheStore();
+  if (store.cache.has(key)) {
+    return store.cache.get(key);
+  }
+  const value = factory();
+  store.cache.set(key, value);
+  return value;
+}
+
+// src/content.ts
+var ContentDocumentNotFoundError = class extends Error {
+  fallbackLocale;
+  id;
+  lookedUpEntryIds;
+  requestedLocale;
+  constructor(options) {
+    super(
+      `Content document "${options.id}" was not found for locale "${options.requestedLocale}" or fallback locale "${options.fallbackLocale}".`
+    );
+    this.name = "ContentDocumentNotFoundError";
+    this.id = options.id;
+    this.requestedLocale = options.requestedLocale;
+    this.fallbackLocale = options.fallbackLocale;
+    this.lookedUpEntryIds = options.lookedUpEntryIds;
+  }
+};
+function normalizeDocumentId(documentId) {
+  const normalizedDocumentId = documentId.trim().replaceAll("\\", "/").replace(/^\/+/, "").replace(/\/+$/, "");
+  if (!normalizedDocumentId || normalizedDocumentId === "." || normalizedDocumentId.startsWith("../") || normalizedDocumentId.includes("/../")) {
+    throw new Error(
+      `Content document id "${documentId}" cannot escape the configured collection root.`
+    );
+  }
+  return normalizedDocumentId;
+}
+function defaultLocalizeId(locale, documentId) {
+  return `${locale}/${documentId}`;
+}
+function createContentCollectionHelpers(requestConfig, options) {
+  const requestConfigCacheKey = /* @__PURE__ */ Symbol(
+    "better-translate-astro-content-request-config"
+  );
+  const collectionCacheKey = /* @__PURE__ */ Symbol(
+    "better-translate-astro-content-collection"
+  );
+  const getEntryId = options.getEntryId ?? ((entry) => entry.id);
+  const localizeId = options.localizeId ?? defaultLocalizeId;
+  function readRequestConfig() {
+    return readRequestCached(requestConfigCacheKey, async () => {
+      const resolved = await requestConfig();
+      const translator = resolved.translator;
+      return {
+        locale: resolved.locale,
+        translator
+      };
+    });
+  }
+  function readCollection() {
+    return readRequestCached(collectionCacheKey, async () => {
+      const entries = await options.getCollection(options.collection);
+      const entryMap = /* @__PURE__ */ new Map();
+      for (const entry of entries) {
+        entryMap.set(getEntryId(entry), entry);
+      }
+      return {
+        entries,
+        entryMap
+      };
+    });
+  }
+  async function getResolvedLocale(requestOptions) {
+    const { locale: configLocale, translator } = await readRequestConfig();
+    return (0, import_server.resolveRequestLocale)(translator, {
+      locale: requestOptions?.locale,
+      requestLocale: (0, import_server.getRequestLocale)(),
+      configLocale
+    });
+  }
+  async function listDocuments() {
+    const [{ entries }, { translator }] = await Promise.all([
+      readCollection(),
+      readRequestConfig()
+    ]);
+    const defaultLocalePrefix = `${translator.defaultLocale}/`;
+    const documentIds = /* @__PURE__ */ new Set();
+    for (const entry of entries) {
+      const entryId = getEntryId(entry);
+      if (!entryId.startsWith(defaultLocalePrefix)) {
+        continue;
+      }
+      documentIds.add(entryId.slice(defaultLocalePrefix.length));
+    }
+    return [...documentIds].sort();
+  }
+  async function getDocument(documentId, requestOptions) {
+    const normalizedDocumentId = normalizeDocumentId(documentId);
+    const [requestedLocale, { translator }, { entryMap }] = await Promise.all([
+      getResolvedLocale(requestOptions),
+      readRequestConfig(),
+      readCollection()
+    ]);
+    const fallbackLocale = translator.fallbackLocale;
+    const localeSearchOrder = requestedLocale === fallbackLocale ? [requestedLocale] : [requestedLocale, fallbackLocale];
+    const lookedUpEntryIds = [];
+    for (const locale of localeSearchOrder) {
+      const entryId = localizeId(locale, normalizedDocumentId);
+      lookedUpEntryIds.push(entryId);
+      const entry = entryMap.get(entryId);
+      if (!entry) {
+        continue;
+      }
+      return {
+        data: entry.data,
+        entry,
+        entryId,
+        id: normalizedDocumentId,
+        locale,
+        requestedLocale,
+        usedFallback: locale !== requestedLocale
+      };
+    }
+    throw new ContentDocumentNotFoundError({
+      fallbackLocale,
+      id: normalizedDocumentId,
+      lookedUpEntryIds,
+      requestedLocale
+    });
+  }
+  async function renderDocument(documentOrId, requestOptions) {
+    if (!options.render) {
+      throw new Error(
+        'renderDocument(...) requires a "render" function in createContentCollectionHelpers(...).'
+      );
+    }
+    const document = typeof documentOrId === "string" ? await getDocument(documentOrId, requestOptions) : documentOrId;
+    return {
+      ...document,
+      rendered: await options.render(document.entry)
+    };
+  }
+  return {
+    async getCollection() {
+      return (await readCollection()).entries;
+    },
+    getDocument,
+    listDocuments,
+    renderDocument
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContentDocumentNotFoundError,
+  createContentCollectionHelpers
+});

package/dist/content.d.cts

@@ -0,0 +1,69 @@
+import { ConfiguredTranslator, TranslationMessages } from '@better-translate/core';
+import { I as InferTranslatorLocale, R as RequestConfigFactory } from './index-B2VGZAji.cjs';
+
+type AnyTranslator = ConfiguredTranslator<any, TranslationMessages>;
+type InferEntryData<TEntry> = TEntry extends {
+    data: infer TData;
+} ? TData : never;
+interface ContentDocumentOptions<TLocale extends string> {
+    locale?: TLocale;
+}
+interface ContentCollectionOptions<TEntry extends {
+    data: unknown;
+    id: string;
+}, TRenderedDocument> {
+    collection: string;
+    getCollection: (collection: string) => readonly TEntry[] | Promise<readonly TEntry[]>;
+    getEntryId?: (entry: TEntry) => string;
+    localizeId?: (locale: string, documentId: string) => string;
+    render?: (entry: TEntry) => TRenderedDocument | Promise<TRenderedDocument>;
+}
+interface LocalizedContentDocument<TLocale extends string, TEntry extends {
+    data: unknown;
+    id: string;
+}> {
+    data: InferEntryData<TEntry>;
+    entry: TEntry;
+    entryId: string;
+    id: string;
+    locale: TLocale;
+    requestedLocale: TLocale;
+    usedFallback: boolean;
+}
+interface RenderedContentDocument<TLocale extends string, TEntry extends {
+    data: unknown;
+    id: string;
+}, TRenderedDocument> extends LocalizedContentDocument<TLocale, TEntry> {
+    rendered: TRenderedDocument;
+}
+interface ContentCollectionHelpers<TLocale extends string, TEntry extends {
+    data: unknown;
+    id: string;
+}, TRenderedDocument> {
+    getCollection(): Promise<readonly TEntry[]>;
+    getDocument(documentId: string, options?: ContentDocumentOptions<TLocale>): Promise<LocalizedContentDocument<TLocale, TEntry>>;
+    listDocuments(): Promise<string[]>;
+    renderDocument(documentId: string, options?: ContentDocumentOptions<TLocale>): Promise<RenderedContentDocument<TLocale, TEntry, TRenderedDocument>>;
+    renderDocument(document: LocalizedContentDocument<TLocale, TEntry>): Promise<RenderedContentDocument<TLocale, TEntry, TRenderedDocument>>;
+}
+declare class ContentDocumentNotFoundError extends Error {
+    readonly fallbackLocale: string;
+    readonly id: string;
+    readonly lookedUpEntryIds: readonly string[];
+    readonly requestedLocale: string;
+    constructor(options: {
+        fallbackLocale: string;
+        id: string;
+        lookedUpEntryIds: readonly string[];
+        requestedLocale: string;
+    });
+}
+declare function createContentCollectionHelpers<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>, TEntry extends {
+    data: unknown;
+    id: string;
+} = {
+    data: unknown;
+    id: string;
+}, TRenderedDocument = unknown>(requestConfig: RequestConfigFactory<TTranslator, TLocale>, options: ContentCollectionOptions<TEntry, TRenderedDocument>): ContentCollectionHelpers<TLocale, TEntry, TRenderedDocument>;
+
+export { type ContentCollectionHelpers, type ContentCollectionOptions, ContentDocumentNotFoundError, type ContentDocumentOptions, type LocalizedContentDocument, type RenderedContentDocument, createContentCollectionHelpers };

package/dist/content.d.ts

@@ -0,0 +1,69 @@
+import { ConfiguredTranslator, TranslationMessages } from '@better-translate/core';
+import { I as InferTranslatorLocale, R as RequestConfigFactory } from './index-B2VGZAji.js';
+
+type AnyTranslator = ConfiguredTranslator<any, TranslationMessages>;
+type InferEntryData<TEntry> = TEntry extends {
+    data: infer TData;
+} ? TData : never;
+interface ContentDocumentOptions<TLocale extends string> {
+    locale?: TLocale;
+}
+interface ContentCollectionOptions<TEntry extends {
+    data: unknown;
+    id: string;
+}, TRenderedDocument> {
+    collection: string;
+    getCollection: (collection: string) => readonly TEntry[] | Promise<readonly TEntry[]>;
+    getEntryId?: (entry: TEntry) => string;
+    localizeId?: (locale: string, documentId: string) => string;
+    render?: (entry: TEntry) => TRenderedDocument | Promise<TRenderedDocument>;
+}
+interface LocalizedContentDocument<TLocale extends string, TEntry extends {
+    data: unknown;
+    id: string;
+}> {
+    data: InferEntryData<TEntry>;
+    entry: TEntry;
+    entryId: string;
+    id: string;
+    locale: TLocale;
+    requestedLocale: TLocale;
+    usedFallback: boolean;
+}
+interface RenderedContentDocument<TLocale extends string, TEntry extends {
+    data: unknown;
+    id: string;
+}, TRenderedDocument> extends LocalizedContentDocument<TLocale, TEntry> {
+    rendered: TRenderedDocument;
+}
+interface ContentCollectionHelpers<TLocale extends string, TEntry extends {
+    data: unknown;
+    id: string;
+}, TRenderedDocument> {
+    getCollection(): Promise<readonly TEntry[]>;
+    getDocument(documentId: string, options?: ContentDocumentOptions<TLocale>): Promise<LocalizedContentDocument<TLocale, TEntry>>;
+    listDocuments(): Promise<string[]>;
+    renderDocument(documentId: string, options?: ContentDocumentOptions<TLocale>): Promise<RenderedContentDocument<TLocale, TEntry, TRenderedDocument>>;
+    renderDocument(document: LocalizedContentDocument<TLocale, TEntry>): Promise<RenderedContentDocument<TLocale, TEntry, TRenderedDocument>>;
+}
+declare class ContentDocumentNotFoundError extends Error {
+    readonly fallbackLocale: string;
+    readonly id: string;
+    readonly lookedUpEntryIds: readonly string[];
+    readonly requestedLocale: string;
+    constructor(options: {
+        fallbackLocale: string;
+        id: string;
+        lookedUpEntryIds: readonly string[];
+        requestedLocale: string;
+    });
+}
+declare function createContentCollectionHelpers<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>, TEntry extends {
+    data: unknown;
+    id: string;
+} = {
+    data: unknown;
+    id: string;
+}, TRenderedDocument = unknown>(requestConfig: RequestConfigFactory<TTranslator, TLocale>, options: ContentCollectionOptions<TEntry, TRenderedDocument>): ContentCollectionHelpers<TLocale, TEntry, TRenderedDocument>;
+
+export { type ContentCollectionHelpers, type ContentCollectionOptions, ContentDocumentNotFoundError, type ContentDocumentOptions, type LocalizedContentDocument, type RenderedContentDocument, createContentCollectionHelpers };

package/dist/content.js

@@ -0,0 +1,152 @@
+import {
+  readRequestCached
+} from "./chunk-3ERZEJZW.js";
+
+// src/content.ts
+import {
+  getRequestLocale as getStoredRequestLocale,
+  resolveRequestLocale
+} from "@better-translate/core/server";
+var ContentDocumentNotFoundError = class extends Error {
+  fallbackLocale;
+  id;
+  lookedUpEntryIds;
+  requestedLocale;
+  constructor(options) {
+    super(
+      `Content document "${options.id}" was not found for locale "${options.requestedLocale}" or fallback locale "${options.fallbackLocale}".`
+    );
+    this.name = "ContentDocumentNotFoundError";
+    this.id = options.id;
+    this.requestedLocale = options.requestedLocale;
+    this.fallbackLocale = options.fallbackLocale;
+    this.lookedUpEntryIds = options.lookedUpEntryIds;
+  }
+};
+function normalizeDocumentId(documentId) {
+  const normalizedDocumentId = documentId.trim().replaceAll("\\", "/").replace(/^\/+/, "").replace(/\/+$/, "");
+  if (!normalizedDocumentId || normalizedDocumentId === "." || normalizedDocumentId.startsWith("../") || normalizedDocumentId.includes("/../")) {
+    throw new Error(
+      `Content document id "${documentId}" cannot escape the configured collection root.`
+    );
+  }
+  return normalizedDocumentId;
+}
+function defaultLocalizeId(locale, documentId) {
+  return `${locale}/${documentId}`;
+}
+function createContentCollectionHelpers(requestConfig, options) {
+  const requestConfigCacheKey = /* @__PURE__ */ Symbol(
+    "better-translate-astro-content-request-config"
+  );
+  const collectionCacheKey = /* @__PURE__ */ Symbol(
+    "better-translate-astro-content-collection"
+  );
+  const getEntryId = options.getEntryId ?? ((entry) => entry.id);
+  const localizeId = options.localizeId ?? defaultLocalizeId;
+  function readRequestConfig() {
+    return readRequestCached(requestConfigCacheKey, async () => {
+      const resolved = await requestConfig();
+      const translator = resolved.translator;
+      return {
+        locale: resolved.locale,
+        translator
+      };
+    });
+  }
+  function readCollection() {
+    return readRequestCached(collectionCacheKey, async () => {
+      const entries = await options.getCollection(options.collection);
+      const entryMap = /* @__PURE__ */ new Map();
+      for (const entry of entries) {
+        entryMap.set(getEntryId(entry), entry);
+      }
+      return {
+        entries,
+        entryMap
+      };
+    });
+  }
+  async function getResolvedLocale(requestOptions) {
+    const { locale: configLocale, translator } = await readRequestConfig();
+    return resolveRequestLocale(translator, {
+      locale: requestOptions?.locale,
+      requestLocale: getStoredRequestLocale(),
+      configLocale
+    });
+  }
+  async function listDocuments() {
+    const [{ entries }, { translator }] = await Promise.all([
+      readCollection(),
+      readRequestConfig()
+    ]);
+    const defaultLocalePrefix = `${translator.defaultLocale}/`;
+    const documentIds = /* @__PURE__ */ new Set();
+    for (const entry of entries) {
+      const entryId = getEntryId(entry);
+      if (!entryId.startsWith(defaultLocalePrefix)) {
+        continue;
+      }
+      documentIds.add(entryId.slice(defaultLocalePrefix.length));
+    }
+    return [...documentIds].sort();
+  }
+  async function getDocument(documentId, requestOptions) {
+    const normalizedDocumentId = normalizeDocumentId(documentId);
+    const [requestedLocale, { translator }, { entryMap }] = await Promise.all([
+      getResolvedLocale(requestOptions),
+      readRequestConfig(),
+      readCollection()
+    ]);
+    const fallbackLocale = translator.fallbackLocale;
+    const localeSearchOrder = requestedLocale === fallbackLocale ? [requestedLocale] : [requestedLocale, fallbackLocale];
+    const lookedUpEntryIds = [];
+    for (const locale of localeSearchOrder) {
+      const entryId = localizeId(locale, normalizedDocumentId);
+      lookedUpEntryIds.push(entryId);
+      const entry = entryMap.get(entryId);
+      if (!entry) {
+        continue;
+      }
+      return {
+        data: entry.data,
+        entry,
+        entryId,
+        id: normalizedDocumentId,
+        locale,
+        requestedLocale,
+        usedFallback: locale !== requestedLocale
+      };
+    }
+    throw new ContentDocumentNotFoundError({
+      fallbackLocale,
+      id: normalizedDocumentId,
+      lookedUpEntryIds,
+      requestedLocale
+    });
+  }
+  async function renderDocument(documentOrId, requestOptions) {
+    if (!options.render) {
+      throw new Error(
+        'renderDocument(...) requires a "render" function in createContentCollectionHelpers(...).'
+      );
+    }
+    const document = typeof documentOrId === "string" ? await getDocument(documentOrId, requestOptions) : documentOrId;
+    return {
+      ...document,
+      rendered: await options.render(document.entry)
+    };
+  }
+  return {
+    async getCollection() {
+      return (await readCollection()).entries;
+    },
+    getDocument,
+    listDocuments,
+    renderDocument
+  };
+}
+export {
+  ContentDocumentNotFoundError,
+  createContentCollectionHelpers
+};

package/dist/index-B2VGZAji.d.cts

@@ -0,0 +1,30 @@
+import { ConfiguredTranslator, TranslationMessages, TranslationLanguageMetadata, TranslationConfig, TranslationDirection, DeepPartialMessages } from '@better-translate/core';
+
+type AnyTranslator = ConfiguredTranslator<any, TranslationMessages>;
+type InferTranslatorLocale<TTranslator> = TTranslator extends ConfiguredTranslator<infer TLocale, TranslationMessages> ? TLocale : never;
+type InferTranslatorMessages<TTranslator> = TTranslator extends ConfiguredTranslator<string, infer TMessages> ? TMessages : TranslationMessages;
+interface BetterTranslateRequestConfig<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>> {
+    locale?: TLocale;
+    translator: TTranslator;
+}
+type RequestConfigFactory<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>> = () => BetterTranslateRequestConfig<TTranslator, TLocale> | Promise<BetterTranslateRequestConfig<TTranslator, TLocale>>;
+type RequestDirectionOptions<TLocale extends string> = {
+    locale?: TLocale;
+    config?: TranslationConfig<TLocale>;
+};
+interface ServerHelpers<TRequestLocale extends string, TTranslator extends AnyTranslator> {
+    getAvailableLanguages(): Promise<readonly TranslationLanguageMetadata<InferTranslatorLocale<TTranslator>>[]>;
+    getDirection(options?: RequestDirectionOptions<InferTranslatorLocale<TTranslator>>): Promise<TranslationDirection>;
+    getLocale(): Promise<TRequestLocale>;
+    getMessages(): Promise<DeepPartialMessages<InferTranslatorMessages<TTranslator>> | InferTranslatorMessages<TTranslator>>;
+    isRtl(options?: RequestDirectionOptions<InferTranslatorLocale<TTranslator>>): Promise<boolean>;
+    getTranslations(options?: {
+        locale?: InferTranslatorLocale<TTranslator>;
+    }): Promise<TTranslator["t"]>;
+    getTranslator(): Promise<TTranslator>;
+}
+declare function getRequestConfig<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>>(factory: RequestConfigFactory<TTranslator, TLocale>): RequestConfigFactory<TTranslator, TLocale>;
+declare function setRequestLocale<TLocale extends string>(locale: TLocale | undefined): void;
+declare function createServerHelpers<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>>(requestConfig: RequestConfigFactory<TTranslator, TLocale>): ServerHelpers<TLocale, TTranslator>;
+
+export { type BetterTranslateRequestConfig as B, type InferTranslatorLocale as I, type RequestConfigFactory as R, type ServerHelpers as S, createServerHelpers as c, getRequestConfig as g, setRequestLocale as s };

package/dist/index-B2VGZAji.d.ts

@@ -0,0 +1,30 @@
+import { ConfiguredTranslator, TranslationMessages, TranslationLanguageMetadata, TranslationConfig, TranslationDirection, DeepPartialMessages } from '@better-translate/core';
+
+type AnyTranslator = ConfiguredTranslator<any, TranslationMessages>;
+type InferTranslatorLocale<TTranslator> = TTranslator extends ConfiguredTranslator<infer TLocale, TranslationMessages> ? TLocale : never;
+type InferTranslatorMessages<TTranslator> = TTranslator extends ConfiguredTranslator<string, infer TMessages> ? TMessages : TranslationMessages;
+interface BetterTranslateRequestConfig<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>> {
+    locale?: TLocale;
+    translator: TTranslator;
+}
+type RequestConfigFactory<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>> = () => BetterTranslateRequestConfig<TTranslator, TLocale> | Promise<BetterTranslateRequestConfig<TTranslator, TLocale>>;
+type RequestDirectionOptions<TLocale extends string> = {
+    locale?: TLocale;
+    config?: TranslationConfig<TLocale>;
+};
+interface ServerHelpers<TRequestLocale extends string, TTranslator extends AnyTranslator> {
+    getAvailableLanguages(): Promise<readonly TranslationLanguageMetadata<InferTranslatorLocale<TTranslator>>[]>;
+    getDirection(options?: RequestDirectionOptions<InferTranslatorLocale<TTranslator>>): Promise<TranslationDirection>;
+    getLocale(): Promise<TRequestLocale>;
+    getMessages(): Promise<DeepPartialMessages<InferTranslatorMessages<TTranslator>> | InferTranslatorMessages<TTranslator>>;
+    isRtl(options?: RequestDirectionOptions<InferTranslatorLocale<TTranslator>>): Promise<boolean>;
+    getTranslations(options?: {
+        locale?: InferTranslatorLocale<TTranslator>;
+    }): Promise<TTranslator["t"]>;
+    getTranslator(): Promise<TTranslator>;
+}
+declare function getRequestConfig<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>>(factory: RequestConfigFactory<TTranslator, TLocale>): RequestConfigFactory<TTranslator, TLocale>;
+declare function setRequestLocale<TLocale extends string>(locale: TLocale | undefined): void;
+declare function createServerHelpers<TTranslator extends AnyTranslator, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>>(requestConfig: RequestConfigFactory<TTranslator, TLocale>): ServerHelpers<TLocale, TTranslator>;
+
+export { type BetterTranslateRequestConfig as B, type InferTranslatorLocale as I, type RequestConfigFactory as R, type ServerHelpers as S, createServerHelpers as c, getRequestConfig as g, setRequestLocale as s };

package/dist/index.cjs

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createServerHelpers: () => createServerHelpers,
+  getRequestConfig: () => getRequestConfig,
+  setRequestLocale: () => setRequestLocale
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/server.ts
+var import_server = require("@better-translate/core/server");
+
+// src/request-cache.ts
+var import_node_async_hooks = require("async_hooks");
+var requestCacheStorage = new import_node_async_hooks.AsyncLocalStorage();
+function getOrCreateRequestCacheStore() {
+  const existingStore = requestCacheStorage.getStore();
+  if (existingStore) {
+    return existingStore;
+  }
+  const nextStore = {
+    cache: /* @__PURE__ */ new Map()
+  };
+  requestCacheStorage.enterWith(nextStore);
+  return nextStore;
+}
+function readRequestCached(key, factory) {
+  const store = getOrCreateRequestCacheStore();
+  if (store.cache.has(key)) {
+    return store.cache.get(key);
+  }
+  const value = factory();
+  store.cache.set(key, value);
+  return value;
+}
+
+// src/server.ts
+function getRequestConfig(factory) {
+  return factory;
+}
+function setRequestLocale(locale) {
+  (0, import_server.setRequestLocale)(locale);
+}
+function createServerHelpers(requestConfig) {
+  const requestConfigCacheKey = /* @__PURE__ */ Symbol("better-translate-astro-request-config");
+  function readRequestConfig() {
+    return readRequestCached(requestConfigCacheKey, async () => {
+      const resolved = await requestConfig();
+      const translator = resolved.translator;
+      return {
+        locale: resolved.locale,
+        translator
+      };
+    });
+  }
+  async function getResolvedLocale(options) {
+    const { locale: configLocale, translator } = await readRequestConfig();
+    return (0, import_server.resolveRequestLocale)(translator, {
+      locale: options?.config?.locale ?? options?.locale,
+      requestLocale: (0, import_server.getRequestLocale)(),
+      configLocale
+    });
+  }
+  async function getDirection(options) {
+    const [{ translator }, locale] = await Promise.all([
+      readRequestConfig(),
+      getResolvedLocale(options)
+    ]);
+    return translator.getDirection({
+      config: typeof options?.config?.rtl === "boolean" ? {
+        rtl: options.config.rtl
+      } : void 0,
+      locale
+    });
+  }
+  async function isRtl(options) {
+    return await getDirection(options) === "rtl";
+  }
+  return {
+    async getAvailableLanguages() {
+      return (await readRequestConfig()).translator.getAvailableLanguages();
+    },
+    getDirection,
+    async getLocale() {
+      return getResolvedLocale();
+    },
+    async getMessages() {
+      const [{ translator }, locale] = await Promise.all([
+        readRequestConfig(),
+        getResolvedLocale()
+      ]);
+      const loadedMessages = await translator.loadLocale(locale);
+      const cachedMessages = translator.getMessages()[locale];
+      if (loadedMessages) {
+        return loadedMessages;
+      }
+      if (cachedMessages) {
+        return cachedMessages;
+      }
+      throw new Error(
+        `Locale "${locale}" messages are not available. Preload them or register a loader in your Better Translate core config.`
+      );
+    },
+    isRtl,
+    async getTranslations(options) {
+      const [{ translator }, locale] = await Promise.all([
+        readRequestConfig(),
+        getResolvedLocale(options)
+      ]);
+      await translator.loadLocale(locale);
+      return ((...args) => {
+        const [key, translateOptions] = args;
+        return translator.t(
+          key,
+          {
+            ...translateOptions ?? {},
+            locale
+          }
+        );
+      });
+    },
+    async getTranslator() {
+      return (await readRequestConfig()).translator;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createServerHelpers,
+  getRequestConfig,
+  setRequestLocale
+});

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+export { B as BetterTranslateRequestConfig, R as RequestConfigFactory, S as ServerHelpers, c as createServerHelpers, g as getRequestConfig, s as setRequestLocale } from './index-B2VGZAji.cjs';
+import '@better-translate/core';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { B as BetterTranslateRequestConfig, R as RequestConfigFactory, S as ServerHelpers, c as createServerHelpers, g as getRequestConfig, s as setRequestLocale } from './index-B2VGZAji.js';
+import '@better-translate/core';

package/dist/index.js

@@ -0,0 +1,11 @@
+import {
+  createServerHelpers,
+  getRequestConfig,
+  setRequestLocale
+} from "./chunk-2ZLSODTJ.js";
+import "./chunk-3ERZEJZW.js";
+export {
+  createServerHelpers,
+  getRequestConfig,
+  setRequestLocale
+};

package/dist/middleware.cjs

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/middleware.ts
+var middleware_exports = {};
+__export(middleware_exports, {
+  createBetterTranslateMiddleware: () => createBetterTranslateMiddleware
+});
+module.exports = __toCommonJS(middleware_exports);
+var import_server2 = require("@better-translate/core/server");
+
+// src/request-cache.ts
+var import_node_async_hooks = require("async_hooks");
+var requestCacheStorage = new import_node_async_hooks.AsyncLocalStorage();
+function getOrCreateRequestCacheStore() {
+  const existingStore = requestCacheStorage.getStore();
+  if (existingStore) {
+    return existingStore;
+  }
+  const nextStore = {
+    cache: /* @__PURE__ */ new Map()
+  };
+  requestCacheStorage.enterWith(nextStore);
+  return nextStore;
+}
+function readRequestCached(key, factory) {
+  const store = getOrCreateRequestCacheStore();
+  if (store.cache.has(key)) {
+    return store.cache.get(key);
+  }
+  const value = factory();
+  store.cache.set(key, value);
+  return value;
+}
+
+// src/server.ts
+var import_server = require("@better-translate/core/server");
+function setRequestLocale(locale) {
+  (0, import_server.setRequestLocale)(locale);
+}
+
+// src/middleware.ts
+function createBetterTranslateMiddleware(requestConfig, options) {
+  const requestConfigCacheKey = /* @__PURE__ */ Symbol(
+    "better-translate-astro-middleware-request-config"
+  );
+  function readConfig() {
+    return readRequestCached(requestConfigCacheKey, () => requestConfig());
+  }
+  return async (context, next) => {
+    const resolvedConfig = await readConfig();
+    const requestedLocale = await options?.resolveLocale?.(context) ?? context.currentLocale;
+    const locale = (0, import_server2.resolveRequestLocale)(resolvedConfig.translator, {
+      locale: requestedLocale,
+      configLocale: resolvedConfig.locale
+    });
+    setRequestLocale(locale);
+    context.locals.betterTranslate = {
+      locale
+    };
+    return next();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createBetterTranslateMiddleware
+});

package/dist/middleware.d.cts

@@ -0,0 +1,25 @@
+import { ConfiguredTranslator, TranslationMessages } from '@better-translate/core';
+import { I as InferTranslatorLocale, R as RequestConfigFactory } from './index-B2VGZAji.cjs';
+
+interface BetterTranslateLocals<TLocale extends string = string> {
+    betterTranslate?: {
+        locale: TLocale;
+    };
+}
+interface BetterTranslateMiddlewareContext<TLocale extends string = string, TLocals extends Record<string, unknown> = Record<string, unknown>> {
+    currentLocale?: string;
+    locals: TLocals & BetterTranslateLocals<TLocale>;
+    params?: Record<string, string | undefined>;
+    preferredLocale?: string;
+    preferredLocaleList?: string[];
+    request: Request;
+    url: URL;
+}
+type BetterTranslateMiddlewareNext = () => Response | Promise<Response>;
+type BetterTranslateMiddlewareHandler<TLocale extends string = string, TLocals extends Record<string, unknown> = Record<string, unknown>> = (context: BetterTranslateMiddlewareContext<TLocale, TLocals>, next: BetterTranslateMiddlewareNext) => Response | Promise<Response>;
+interface CreateBetterTranslateMiddlewareOptions<TLocale extends string, TLocals extends Record<string, unknown> = Record<string, unknown>> {
+    resolveLocale?: (context: BetterTranslateMiddlewareContext<TLocale, TLocals>) => TLocale | string | undefined | Promise<TLocale | string | undefined>;
+}
+declare function createBetterTranslateMiddleware<TTranslator extends ConfiguredTranslator<any, TranslationMessages>, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>, TLocals extends Record<string, unknown> = Record<string, unknown>>(requestConfig: RequestConfigFactory<TTranslator, TLocale>, options?: CreateBetterTranslateMiddlewareOptions<TLocale, TLocals>): BetterTranslateMiddlewareHandler<TLocale, TLocals>;
+
+export { type BetterTranslateLocals, type BetterTranslateMiddlewareContext, type BetterTranslateMiddlewareHandler, type BetterTranslateMiddlewareNext, type CreateBetterTranslateMiddlewareOptions, createBetterTranslateMiddleware };

package/dist/middleware.d.ts

@@ -0,0 +1,25 @@
+import { ConfiguredTranslator, TranslationMessages } from '@better-translate/core';
+import { I as InferTranslatorLocale, R as RequestConfigFactory } from './index-B2VGZAji.js';
+
+interface BetterTranslateLocals<TLocale extends string = string> {
+    betterTranslate?: {
+        locale: TLocale;
+    };
+}
+interface BetterTranslateMiddlewareContext<TLocale extends string = string, TLocals extends Record<string, unknown> = Record<string, unknown>> {
+    currentLocale?: string;
+    locals: TLocals & BetterTranslateLocals<TLocale>;
+    params?: Record<string, string | undefined>;
+    preferredLocale?: string;
+    preferredLocaleList?: string[];
+    request: Request;
+    url: URL;
+}
+type BetterTranslateMiddlewareNext = () => Response | Promise<Response>;
+type BetterTranslateMiddlewareHandler<TLocale extends string = string, TLocals extends Record<string, unknown> = Record<string, unknown>> = (context: BetterTranslateMiddlewareContext<TLocale, TLocals>, next: BetterTranslateMiddlewareNext) => Response | Promise<Response>;
+interface CreateBetterTranslateMiddlewareOptions<TLocale extends string, TLocals extends Record<string, unknown> = Record<string, unknown>> {
+    resolveLocale?: (context: BetterTranslateMiddlewareContext<TLocale, TLocals>) => TLocale | string | undefined | Promise<TLocale | string | undefined>;
+}
+declare function createBetterTranslateMiddleware<TTranslator extends ConfiguredTranslator<any, TranslationMessages>, TLocale extends InferTranslatorLocale<TTranslator> = InferTranslatorLocale<TTranslator>, TLocals extends Record<string, unknown> = Record<string, unknown>>(requestConfig: RequestConfigFactory<TTranslator, TLocale>, options?: CreateBetterTranslateMiddlewareOptions<TLocale, TLocals>): BetterTranslateMiddlewareHandler<TLocale, TLocals>;
+
+export { type BetterTranslateLocals, type BetterTranslateMiddlewareContext, type BetterTranslateMiddlewareHandler, type BetterTranslateMiddlewareNext, type CreateBetterTranslateMiddlewareOptions, createBetterTranslateMiddleware };

package/dist/middleware.js

@@ -0,0 +1,33 @@
+import {
+  setRequestLocale
+} from "./chunk-2ZLSODTJ.js";
+import {
+  readRequestCached
+} from "./chunk-3ERZEJZW.js";
+
+// src/middleware.ts
+import { resolveRequestLocale } from "@better-translate/core/server";
+function createBetterTranslateMiddleware(requestConfig, options) {
+  const requestConfigCacheKey = /* @__PURE__ */ Symbol(
+    "better-translate-astro-middleware-request-config"
+  );
+  function readConfig() {
+    return readRequestCached(requestConfigCacheKey, () => requestConfig());
+  }
+  return async (context, next) => {
+    const resolvedConfig = await readConfig();
+    const requestedLocale = await options?.resolveLocale?.(context) ?? context.currentLocale;
+    const locale = resolveRequestLocale(resolvedConfig.translator, {
+      locale: requestedLocale,
+      configLocale: resolvedConfig.locale
+    });
+    setRequestLocale(locale);
+    context.locals.betterTranslate = {
+      locale
+    };
+    return next();
+  };
+}
+export {
+  createBetterTranslateMiddleware
+};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@better-translate/astro",
+  "version": "1.0.0",
+  "description": "Astro integration package for Better Translate.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js",
+      "require": "./dist/middleware.cjs"
+    },
+    "./content": {
+      "types": "./dist/content.d.ts",
+      "import": "./dist/content.js",
+      "require": "./dist/content.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "LICENSE", "README.md"],
+  "scripts": {
+    "build": "tsup src/index.ts src/middleware.ts src/content.ts --format esm,cjs --dts --clean",
+    "check-types": "tsc --noEmit",
+    "test": "bun test tests/runtime",
+    "test:types": "tsc -p tests/types/tsconfig.json --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jralvarenga/better-translate.git",
+    "directory": "packages/astro"
+  },
+  "homepage": "https://github.com/jralvarenga/better-translate/tree/main/packages/astro#readme",
+  "bugs": {
+    "url": "https://github.com/jralvarenga/better-translate/issues"
+  },
+  "dependencies": {
+    "@better-translate/core": "workspace:^"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "*"
+  },
+  "keywords": [
+    "astro",
+    "i18n",
+    "l10n",
+    "markdown",
+    "mdx",
+    "translations",
+    "typescript"
+  ]
+}