@better-i18n/next 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/next",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Better-i18n Next.js integration",
   "license": "MIT",
   "repository": {
@@ -32,6 +32,10 @@
       "types": "./src/middleware.ts",
       "default": "./src/middleware.ts"
     },
+    "./proxy": {
+      "types": "./src/proxy.ts",
+      "default": "./src/proxy.ts"
+    },
     "./package.json": "./package.json"
   },
   "files": [

package/src/client.ts

@@ -26,7 +26,7 @@ type ClientCacheEntry = {
 const clientCache = new Map<string, ClientCacheEntry>();
 
 const getCacheKey = (config: I18nConfig) =>
-  `${config.cdnBaseUrl || "https://cdn.better-i18n.com"}|${config.workspaceId}|${config.projectSlug}`;
+  `${config.cdnBaseUrl || "https://cdn.better-i18n.com"}|${config.project}`;
 
 const fetchManifestLanguages = async (
   config: I18nConfig,
@@ -62,8 +62,7 @@ export const useManifestLanguages = (
   const normalized = useMemo(
     () => normalizeConfig(config),
     [
-      config.workspaceId,
-      config.projectSlug,
+      config.project,
       config.defaultLocale,
       config.cdnBaseUrl,
       config.localePrefix,

package/src/config.ts

@@ -1,20 +1,37 @@
-import type { I18nConfig, NormalizedConfig } from "./types";
+import type { I18nConfig, NormalizedConfig, ParsedProject } from "./types";
 
 const DEFAULT_CDN_BASE_URL = "https://cdn.better-i18n.com";
 
-export const normalizeConfig = (config: I18nConfig): NormalizedConfig => {
-  if (!config.workspaceId?.trim()) {
-    throw new Error("[better-i18n] workspaceId is required");
+/**
+ * Parse project string "org/slug" into workspaceId and projectSlug
+ */
+export const parseProject = (project: string): ParsedProject => {
+  const parts = project.split("/");
+  if (parts.length !== 2 || !parts[0] || !parts[1]) {
+    throw new Error(
+      `[better-i18n] Invalid project format "${project}". Expected "org/project" (e.g., "carna/landing")`
+    );
   }
-  if (!config.projectSlug?.trim()) {
-    throw new Error("[better-i18n] projectSlug is required");
+  return {
+    workspaceId: parts[0],
+    projectSlug: parts[1],
+  };
+};
+
+export const normalizeConfig = (config: I18nConfig): NormalizedConfig => {
+  if (!config.project?.trim()) {
+    throw new Error("[better-i18n] project is required");
   }
   if (!config.defaultLocale?.trim()) {
     throw new Error("[better-i18n] defaultLocale is required");
   }
 
+  const { workspaceId, projectSlug } = parseProject(config.project);
+
   return {
     ...config,
+    workspaceId,
+    projectSlug,
     cdnBaseUrl: config.cdnBaseUrl?.replace(/\/$/, "") || DEFAULT_CDN_BASE_URL,
     localePrefix: config.localePrefix ?? "as-needed",
     manifestCacheTtlMs: config.manifestCacheTtlMs ?? 5 * 60 * 1000,

package/src/core.ts

@@ -1,4 +1,4 @@
-import { normalizeConfig, getProjectBaseUrl } from "./config";
+import { getProjectBaseUrl, normalizeConfig } from "./config";
 import { createLogger } from "./logger";
 import { extractLanguages } from "./manifest";
 import type {
@@ -18,7 +18,7 @@ type ManifestCacheEntry = {
 const manifestCache = new Map<string, ManifestCacheEntry>();
 
 const buildCacheKey = (config: NormalizedConfig) =>
-  `${config.cdnBaseUrl}|${config.workspaceId}|${config.projectSlug}`;
+  `${config.cdnBaseUrl}|${config.project}`;
 
 const withRevalidate = (
   init: NextFetchRequestInit,

package/src/proxy.ts

@@ -0,0 +1 @@
+export { createI18nProxy } from "./middleware";

package/src/types.ts

@@ -5,8 +5,8 @@ export type LocalePrefix = "as-needed" | "always" | "never";
 export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
 
 export interface I18nConfig {
-  workspaceId: string;
-  projectSlug: string;
+  /** Project identifier in format "org/project" (e.g., "carna/landing") */
+  project: string;
   defaultLocale: string;
   cdnBaseUrl?: string;
   localePrefix?: LocalePrefix;
@@ -18,7 +18,13 @@ export interface I18nConfig {
   fetch?: typeof fetch;
 }
 
-export interface NormalizedConfig extends I18nConfig {
+/** Parsed project identifier */
+export interface ParsedProject {
+  workspaceId: string;
+  projectSlug: string;
+}
+
+export interface NormalizedConfig extends I18nConfig, ParsedProject {
   cdnBaseUrl: string;
   localePrefix: LocalePrefix;
 }