@better-i18n/sdk 0.1.1 → 0.2.0

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@better-i18n/sdk",
-  "version": "0.1.1",
-  "description": "SDK for fetching content and translations from Better i18n",
+  "version": "0.2.0",
+  "description": "Content SDK for Better i18n - headless CMS client for fetching content models and entries",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./content": "./src/content.ts",
-    "./translations": "./src/translations.ts"
+    ".": "./src/index.ts"
   },
   "files": [
     "src",
@@ -18,11 +16,11 @@
     "typecheck": "tsc --noEmit"
   },
   "keywords": [
-    "i18n",
-    "translations",
     "content",
     "sdk",
-    "headless-cms"
+    "headless-cms",
+    "better-i18n",
+    "cms"
   ],
   "devDependencies": {
     "typescript": "~5.9.3"

package/src/client.ts

@@ -1,15 +1,13 @@
-import type { ClientConfig, BetterI18nClient } from "./types";
+import type { ClientConfig, ContentClient } from "./types";
 import { createContentAPIClient } from "./content-api";
-import { createTranslationsCDNClient } from "./translations-cdn";
 
-const DEFAULT_CDN_BASE = "https://cdn.better-i18n.com";
 const DEFAULT_API_BASE = "https://api.better-i18n.com";
 
 /**
- * Creates a Better i18n client with content and translation sub-clients.
+ * Creates a Better i18n content client.
  *
- * Content is always fetched from the REST API and requires an API key.
- * Translations are served from the CDN for performance (no API key needed).
+ * Fetches content models and entries from the REST API.
+ * Requires an API key for authentication.
  *
  * @example
  * ```typescript
@@ -19,31 +17,22 @@ const DEFAULT_API_BASE = "https://api.better-i18n.com";
  *   apiKey: "bi18n_...",
  * });
  *
- * // Content (API mode, requires apiKey)
- * const posts = await client.content.getEntries("blog-posts", { language: "fr" });
- * const post = await client.content.getEntry("blog-posts", "hello-world");
- * const models = await client.content.getModels();
- *
- * // Translations (CDN mode, no API key needed)
- * const strings = await client.translations.get("common", { language: "fr" });
+ * const models = await client.getModels();
+ * const posts = await client.getEntries("blog-posts", { language: "fr" });
+ * const post = await client.getEntry("blog-posts", "hello-world");
  * ```
  */
-export function createClient(config: ClientConfig): BetterI18nClient {
+export function createClient(config: ClientConfig): ContentClient {
   const { org, project } = config;
-  const cdnBase = (config.cdnBase || DEFAULT_CDN_BASE).replace(/\/$/, "");
   const apiBase = (config.apiBase || DEFAULT_API_BASE).replace(/\/$/, "");
 
   if (!config.apiKey) {
     throw new Error(
-      "API key is required. Content is served via the REST API.\n" +
+      "API key is required for content API access.\n" +
         "Set apiKey in your client config:\n\n" +
         '  createClient({ org: "...", project: "...", apiKey: "bi18n_..." })',
     );
   }
 
-  return {
-    content: createContentAPIClient(apiBase, org, project, config.apiKey),
-    // Translations always served from CDN for performance
-    translations: createTranslationsCDNClient(cdnBase, org, project),
-  };
+  return createContentAPIClient(apiBase, org, project, config.apiKey);
 }

package/src/index.ts

@@ -1,14 +1,11 @@
 export { createClient } from "./client";
+export { createContentAPIClient } from "./content-api";
 export type {
   ClientConfig,
-  BetterI18nClient,
   ContentClient,
-  TranslationsClient,
   ContentEntry,
   ContentEntryListItem,
   ContentModel,
-  TranslationManifest,
   ListEntriesOptions,
   GetEntryOptions,
-  GetTranslationsOptions,
 } from "./types";

package/src/types.ts

@@ -1,6 +1,6 @@
 // ─── Client Configuration ────────────────────────────────────────────
 
-/** Configuration for creating a Better i18n client. */
+/** Configuration for creating a Better i18n content client. */
 export interface ClientConfig {
   /** Organization slug (e.g., "acme-corp"). */
   org: string;
@@ -8,9 +8,7 @@ export interface ClientConfig {
   project: string;
   /** API key for authenticating content requests. Required. */
   apiKey: string;
-  /** CDN base URL for translations. Defaults to `https://cdn.better-i18n.com`. */
-  cdnBase?: string;
-  /** REST API base URL for content. Defaults to `https://api.better-i18n.com`. */
+  /** REST API base URL. Defaults to `https://api.better-i18n.com`. */
   apiBase?: string;
 }
 
@@ -58,27 +56,11 @@ export interface ContentModel {
   entryCount: number;
 }
 
-// ─── Translation Types ───────────────────────────────────────────────
-
-/** Manifest describing project languages and translation coverage. */
-export interface TranslationManifest {
-  projectSlug: string;
-  sourceLanguage: string;
-  languages: Array<{
-    code: string;
-    name: string;
-    nativeName: string;
-    isSource: boolean;
-    keyCount: number;
-  }>;
-  updatedAt: string;
-}
-
-// ─── Client Interfaces ──────────────────────────────────────────────
+// ─── Client Interface ───────────────────────────────────────────────
 
 /** Options for listing content entries. */
 export interface ListEntriesOptions {
-  /** Language code for localized content. Defaults to `"en"`. */
+  /** Language code for localized content. Defaults to source language. */
   language?: string;
   /** Page number (1-based). */
   page?: number;
@@ -88,13 +70,7 @@ export interface ListEntriesOptions {
 
 /** Options for fetching a single content entry. */
 export interface GetEntryOptions {
-  /** Language code for localized content. Defaults to `"en"`. */
-  language?: string;
-}
-
-/** Options for fetching translations. */
-export interface GetTranslationsOptions {
-  /** Language code. Defaults to `"en"`. */
+  /** Language code for localized content. Defaults to source language. */
   language?: string;
 }
 
@@ -114,22 +90,3 @@ export interface ContentClient {
     options?: GetEntryOptions,
   ): Promise<ContentEntry>;
 }
-
-/** Client for fetching translation strings. */
-export interface TranslationsClient {
-  /** Fetch translations for a namespace. */
-  get(
-    namespace: string,
-    options?: GetTranslationsOptions,
-  ): Promise<Record<string, string>>;
-  /** Fetch the project translation manifest. */
-  getManifest(): Promise<TranslationManifest>;
-}
-
-/** The unified Better i18n client. */
-export interface BetterI18nClient {
-  /** Content sub-client for headless CMS operations. */
-  content: ContentClient;
-  /** Translations sub-client for i18n string fetching. */
-  translations: TranslationsClient;
-}

package/src/content.ts

@@ -1,9 +0,0 @@
-export { createContentAPIClient } from "./content-api";
-export type {
-  ContentClient,
-  ContentEntry,
-  ContentEntryListItem,
-  ContentModel,
-  ListEntriesOptions,
-  GetEntryOptions,
-} from "./types";

package/src/translations-cdn.ts

@@ -1,51 +0,0 @@
-import type {
-  TranslationsClient,
-  TranslationManifest,
-  GetTranslationsOptions,
-} from "./types";
-
-/**
- * Creates a translations client that fetches from the CDN.
- *
- * Translation files are pre-built JSON served from Cloudflare R2.
- * No authentication required.
- *
- * URL patterns:
- * - Namespace: `{cdnBase}/{org}/{project}/{lang}/{namespace}.json`
- * - Manifest: `{cdnBase}/{org}/{project}/manifest.json`
- */
-export function createTranslationsCDNClient(
-  cdnBase: string,
-  org: string,
-  project: string,
-): TranslationsClient {
-  const base = `${cdnBase}/${org}/${project}`;
-
-  return {
-    async get(
-      namespace: string,
-      options?: GetTranslationsOptions,
-    ): Promise<Record<string, string>> {
-      const lang = options?.language || "en";
-      const ns = namespace || "default";
-      const res = await fetch(`${base}/${lang}/${ns}.json`);
-      if (!res.ok) {
-        if (res.status === 404) return {};
-        throw new Error(
-          `Failed to fetch translations for ${ns} (${lang}): ${res.status}`,
-        );
-      }
-      return res.json();
-    },
-
-    async getManifest(): Promise<TranslationManifest> {
-      const res = await fetch(`${base}/manifest.json`);
-      if (!res.ok) {
-        throw new Error(
-          `Failed to fetch translation manifest: ${res.status}`,
-        );
-      }
-      return res.json();
-    },
-  };
-}

package/src/translations.ts

@@ -1,6 +0,0 @@
-export { createTranslationsCDNClient } from "./translations-cdn";
-export type {
-  TranslationsClient,
-  TranslationManifest,
-  GetTranslationsOptions,
-} from "./types";