@better-i18n/sdk 0.4.0 → 1.0.1

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+import type { ClientConfig, ContentClient } from "./types.js";
+/**
+ * Creates a Better i18n content client.
+ *
+ * Fetches content models and entries from the REST API.
+ * Requires an API key for authentication.
+ *
+ * @example
+ * ```typescript
+ * const client = createClient({
+ *   project: "acme/web-app",
+ *   apiKey: "bi18n_...",
+ * });
+ *
+ * const models = await client.getModels();
+ * const posts = await client.getEntries("blog-posts", { language: "fr" });
+ * const post = await client.getEntry("blog-posts", "hello-world");
+ * ```
+ */
+export declare function createClient(config: ClientConfig): ContentClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK9D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAoBhE"}

package/dist/client.js

@@ -0,0 +1,35 @@
+import { createContentAPIClient } from "./content-api.js";
+const DEFAULT_API_BASE = "https://content.better-i18n.com";
+/**
+ * Creates a Better i18n content client.
+ *
+ * Fetches content models and entries from the REST API.
+ * Requires an API key for authentication.
+ *
+ * @example
+ * ```typescript
+ * const client = createClient({
+ *   project: "acme/web-app",
+ *   apiKey: "bi18n_...",
+ * });
+ *
+ * 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) {
+    const apiBase = (config.apiBase || DEFAULT_API_BASE).replace(/\/$/, "");
+    const parts = config.project.split("/");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new Error(`Invalid project format "${config.project}". Expected "org/project" (e.g., "acme/web-app").`);
+    }
+    const [org, project] = parts;
+    if (!config.apiKey) {
+        throw new Error("API key is required for content API access.\n" +
+            "Set apiKey in your client config:\n\n" +
+            '  createClient({ project: "acme/web-app", apiKey: "bi18n_..." })');
+    }
+    return createContentAPIClient(apiBase, org, project, config.apiKey, config.debug);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,gBAAgB,GAAG,iCAAiC,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,2BAA2B,MAAM,CAAC,OAAO,mDAAmD,CAC7F,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IAE7B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC7C,uCAAuC;YACvC,kEAAkE,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AACpF,CAAC"}

package/dist/content-api.d.ts

@@ -0,0 +1,14 @@
+import type { ContentClient } from "./types.js";
+/**
+ * Creates a content client that fetches from the REST API.
+ *
+ * This mode supports filtering, pagination, and real-time data (no caching lag).
+ * Requires an API key for authentication via the `x-api-key` header.
+ *
+ * URL patterns:
+ * - Models: `{apiBase}/v1/content/{org}/{project}/models`
+ * - Entries: `{apiBase}/v1/content/{org}/{project}/models/{model}/entries`
+ * - Entry: `{apiBase}/v1/content/{org}/{project}/models/{model}/entries/{slug}`
+ */
+export declare function createContentAPIClient(apiBase: string, org: string, project: string, apiKey: string, debug?: boolean): ContentClient;
+//# sourceMappingURL=content-api.d.ts.map

package/dist/content-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-api.d.ts","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,UAAQ,GACZ,aAAa,CA2Ef"}

package/dist/content-api.js

@@ -0,0 +1,74 @@
+/**
+ * Creates a content client that fetches from the REST API.
+ *
+ * This mode supports filtering, pagination, and real-time data (no caching lag).
+ * Requires an API key for authentication via the `x-api-key` header.
+ *
+ * URL patterns:
+ * - Models: `{apiBase}/v1/content/{org}/{project}/models`
+ * - Entries: `{apiBase}/v1/content/{org}/{project}/models/{model}/entries`
+ * - Entry: `{apiBase}/v1/content/{org}/{project}/models/{model}/entries/{slug}`
+ */
+export function createContentAPIClient(apiBase, org, project, apiKey, debug = false) {
+    const base = `${apiBase}/v1/content/${org}/${project}`;
+    const headers = {
+        "x-api-key": apiKey,
+        "content-type": "application/json",
+    };
+    const log = debug
+        ? (...args) => console.log("[better-i18n]", ...args)
+        : () => { };
+    if (debug) {
+        log("Client initialized", { apiBase, org, project, base });
+    }
+    async function request(url, label) {
+        log(`→ ${label}`, url);
+        const res = await fetch(url, { headers });
+        log(`← ${res.status} ${res.statusText}`);
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            log("  Error body:", body);
+            throw new Error(`API error ${label}: ${res.status} ${body}`);
+        }
+        const data = await res.json();
+        log("  Response:", JSON.stringify(data).slice(0, 500));
+        return { res, data };
+    }
+    return {
+        async getModels() {
+            const { data } = await request(`${base}/models`, "getModels");
+            return data;
+        },
+        async getEntries(modelSlug, options) {
+            const params = new URLSearchParams();
+            if (options?.language)
+                params.set("language", options.language);
+            if (options?.status)
+                params.set("status", options.status);
+            if (options?.sort)
+                params.set("sort", options.sort);
+            if (options?.order)
+                params.set("order", options.order);
+            if (options?.page)
+                params.set("page", String(options.page));
+            if (options?.limit)
+                params.set("limit", String(options.limit));
+            const qs = params.toString() ? `?${params}` : "";
+            const { data } = await request(`${base}/models/${modelSlug}/entries${qs}`, `getEntries(${modelSlug})`);
+            return {
+                items: data.items,
+                total: data.total,
+                hasMore: data.hasMore,
+            };
+        },
+        async getEntry(modelSlug, entrySlug, options) {
+            const params = new URLSearchParams();
+            if (options?.language)
+                params.set("language", options.language);
+            const qs = params.toString() ? `?${params}` : "";
+            const { data } = await request(`${base}/models/${modelSlug}/entries/${entrySlug}${qs}`, `getEntry(${modelSlug}/${entrySlug})`);
+            return data;
+        },
+    };
+}
+//# sourceMappingURL=content-api.js.map

package/dist/content-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-api.js","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createClient } from "./client.js";
+export { createContentAPIClient } from "./content-api.js";
+export type { ClientConfig, ContentClient, ContentEntry, ContentEntryListItem, ContentEntryStatus, ContentEntrySortField, ContentModel, ListEntriesOptions, GetEntryOptions, PaginatedResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createClient } from "./client.js";
+export { createContentAPIClient } from "./content-api.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,107 @@
+/** Configuration for creating a Better i18n content client. */
+export interface ClientConfig {
+    /** Project identifier in `org/project` format (e.g., "acme-corp/web-app"). Same as the dashboard URL path. */
+    project: string;
+    /** API key for authenticating content requests. Required. */
+    apiKey: string;
+    /** REST API base URL. Defaults to `https://dash.better-i18n.com`. */
+    apiBase?: string;
+    /** Enable debug logging to see request URLs, headers, and responses. */
+    debug?: boolean;
+}
+/**
+ * A full content entry with all localized fields.
+ *
+ * @typeParam CF - Custom fields shape. Defaults to `Record<string, string | null>`.
+ *
+ * @example
+ * ```typescript
+ * // Typed custom fields
+ * interface BlogFields { readingTime: string | null; category: string | null }
+ * const post = await client.getEntry<BlogFields>("blog", "hello-world");
+ * post.customFields.readingTime; // string | null (typed!)
+ * ```
+ */
+export interface ContentEntry<CF extends Record<string, string | null> = Record<string, string | null>> {
+    id: string;
+    slug: string;
+    status: "draft" | "published" | "archived";
+    publishedAt: string | null;
+    sourceLanguage: string;
+    availableLanguages: string[];
+    featuredImage: string | null;
+    tags: string[];
+    author: {
+        name: string;
+        image: string | null;
+    } | null;
+    customFields: CF;
+    title: string;
+    excerpt: string | null;
+    body: Record<string, any> | null;
+    bodyHtml: string | null;
+    bodyMarkdown: string | null;
+    metaTitle: string | null;
+    metaDescription: string | null;
+}
+/** Entry status filter values. */
+export type ContentEntryStatus = "draft" | "published" | "archived";
+/** A summary item for content entry lists. */
+export interface ContentEntryListItem {
+    slug: string;
+    title: string;
+    excerpt: string | null;
+    publishedAt: string | null;
+    featuredImage: string | null;
+    tags: string[];
+    author: {
+        name: string;
+        image: string | null;
+    } | null;
+}
+/** Paginated response wrapper. */
+export interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    hasMore: boolean;
+}
+/** A content model definition. */
+export interface ContentModel {
+    slug: string;
+    displayName: string;
+    description: string | null;
+    kind: string;
+    entryCount: number;
+}
+/** Sortable fields for content entries. */
+export type ContentEntrySortField = "publishedAt" | "createdAt" | "updatedAt" | "title";
+/** Options for listing content entries. */
+export interface ListEntriesOptions {
+    /** Language code for localized content. Defaults to source language. */
+    language?: string;
+    /** Filter by entry status. */
+    status?: ContentEntryStatus;
+    /** Field to sort by. Defaults to `"updatedAt"`. */
+    sort?: ContentEntrySortField;
+    /** Sort direction. Defaults to `"desc"`. */
+    order?: "asc" | "desc";
+    /** Page number (1-based). */
+    page?: number;
+    /** Max entries per page (1-100). Defaults to 50. */
+    limit?: number;
+}
+/** Options for fetching a single content entry. */
+export interface GetEntryOptions {
+    /** Language code for localized content. Defaults to source language. */
+    language?: string;
+}
+/** Client for fetching content entries and models. */
+export interface ContentClient {
+    /** List all content models in the project. */
+    getModels(): Promise<ContentModel[]>;
+    /** List entries for a content model with pagination. */
+    getEntries(modelSlug: string, options?: ListEntriesOptions): Promise<PaginatedResponse<ContentEntryListItem>>;
+    /** Fetch a single content entry by slug. */
+    getEntry<CF extends Record<string, string | null> = Record<string, string | null>>(modelSlug: string, entrySlug: string, options?: GetEntryOptions): Promise<ContentEntry<CF>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,8GAA8G;IAC9G,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpG,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,YAAY,EAAE,EAAE,CAAC;IAEjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpE,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACvD;AAED,kCAAkC;AAClC,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,2CAA2C;AAC3C,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAExF,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,mDAAmD;IACnD,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrC,wDAAwD;IACxD,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACpD,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAC/E,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Client Configuration ────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE"}

package/package.json

@@ -1,19 +1,26 @@
 {
   "name": "@better-i18n/sdk",
-  "version": "0.4.0",
+  "version": "1.0.1",
   "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",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
   },
   "files": [
-    "src",
+    "dist",
     "README.md"
   ],
   "scripts": {
-    "typecheck": "tsc --noEmit"
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build"
   },
   "keywords": [
     "content",

package/src/client.ts

@@ -1,44 +0,0 @@
-import type { ClientConfig, ContentClient } from "./types";
-import { createContentAPIClient } from "./content-api";
-
-const DEFAULT_API_BASE = "https://dash.better-i18n.com";
-
-/**
- * Creates a Better i18n content client.
- *
- * Fetches content models and entries from the REST API.
- * Requires an API key for authentication.
- *
- * @example
- * ```typescript
- * const client = createClient({
- *   project: "acme/web-app",
- *   apiKey: "bi18n_...",
- * });
- *
- * 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): ContentClient {
-  const apiBase = (config.apiBase || DEFAULT_API_BASE).replace(/\/$/, "");
-
-  const parts = config.project.split("/");
-  if (parts.length !== 2 || !parts[0] || !parts[1]) {
-    throw new Error(
-      `Invalid project format "${config.project}". Expected "org/project" (e.g., "acme/web-app").`,
-    );
-  }
-  const [org, project] = parts;
-
-  if (!config.apiKey) {
-    throw new Error(
-      "API key is required for content API access.\n" +
-        "Set apiKey in your client config:\n\n" +
-        '  createClient({ project: "acme/web-app", apiKey: "bi18n_..." })',
-    );
-  }
-
-  return createContentAPIClient(apiBase, org, project, config.apiKey, config.debug);
-}

package/src/content-api.ts

@@ -1,103 +0,0 @@
-import type {
-  ContentClient,
-  ContentEntry,
-  ContentEntryListItem,
-  ContentModel,
-  ListEntriesOptions,
-  GetEntryOptions,
-  PaginatedResponse,
-} from "./types";
-
-/**
- * Creates a content client that fetches from the REST API.
- *
- * This mode supports filtering, pagination, and real-time data (no caching lag).
- * Requires an API key for authentication via the `x-api-key` header.
- *
- * URL patterns:
- * - Models: `{apiBase}/api/v1/content/{org}/{project}/models`
- * - Entries: `{apiBase}/api/v1/content/{org}/{project}/models/{model}/entries`
- * - Entry: `{apiBase}/api/v1/content/{org}/{project}/models/{model}/entries/{slug}`
- */
-export function createContentAPIClient(
-  apiBase: string,
-  org: string,
-  project: string,
-  apiKey: string,
-  debug = false,
-): ContentClient {
-  const base = `${apiBase}/api/v1/content/${org}/${project}`;
-  const headers: Record<string, string> = {
-    "x-api-key": apiKey,
-    "content-type": "application/json",
-  };
-
-  const log = debug
-    ? (...args: unknown[]) => console.log("[better-i18n]", ...args)
-    : () => {};
-
-  if (debug) {
-    log("Client initialized", { apiBase, org, project, base });
-  }
-
-  async function request<T>(url: string, label: string): Promise<{ res: Response; data: T }> {
-    log(`→ ${label}`, url);
-    const res = await fetch(url, { headers });
-    log(`← ${res.status} ${res.statusText}`);
-    if (!res.ok) {
-      const body = await res.text().catch(() => "");
-      log("  Error body:", body);
-      throw new Error(`API error ${label}: ${res.status} ${body}`);
-    }
-    const data = await res.json() as T;
-    log("  Response:", JSON.stringify(data).slice(0, 500));
-    return { res, data };
-  }
-
-  return {
-    async getModels(): Promise<ContentModel[]> {
-      const { data } = await request<ContentModel[]>(`${base}/models`, "getModels");
-      return data;
-    },
-
-    async getEntries(
-      modelSlug: string,
-      options?: ListEntriesOptions,
-    ): Promise<PaginatedResponse<ContentEntryListItem>> {
-      const params = new URLSearchParams();
-      if (options?.language) params.set("language", options.language);
-      if (options?.status) params.set("status", options.status);
-      if (options?.sort) params.set("sort", options.sort);
-      if (options?.order) params.set("order", options.order);
-      if (options?.page) params.set("page", String(options.page));
-      if (options?.limit) params.set("limit", String(options.limit));
-      const qs = params.toString() ? `?${params}` : "";
-
-      const { data } = await request<{ items: ContentEntryListItem[]; total: number; hasMore: boolean }>(
-        `${base}/models/${modelSlug}/entries${qs}`,
-        `getEntries(${modelSlug})`,
-      );
-      return {
-        items: data.items,
-        total: data.total,
-        hasMore: data.hasMore,
-      };
-    },
-
-    async getEntry<CF extends Record<string, string | null> = Record<string, string | null>>(
-      modelSlug: string,
-      entrySlug: string,
-      options?: GetEntryOptions,
-    ): Promise<ContentEntry<CF>> {
-      const params = new URLSearchParams();
-      if (options?.language) params.set("language", options.language);
-      const qs = params.toString() ? `?${params}` : "";
-
-      const { data } = await request<ContentEntry<CF>>(
-        `${base}/models/${modelSlug}/entries/${entrySlug}${qs}`,
-        `getEntry(${modelSlug}/${entrySlug})`,
-      );
-      return data;
-    },
-  };
-}

package/src/index.ts

@@ -1,14 +0,0 @@
-export { createClient } from "./client";
-export { createContentAPIClient } from "./content-api";
-export type {
-  ClientConfig,
-  ContentClient,
-  ContentEntry,
-  ContentEntryListItem,
-  ContentEntryStatus,
-  ContentEntrySortField,
-  ContentModel,
-  ListEntriesOptions,
-  GetEntryOptions,
-  PaginatedResponse,
-} from "./types";

package/src/types.ts

@@ -1,124 +0,0 @@
-// ─── Client Configuration ────────────────────────────────────────────
-
-/** Configuration for creating a Better i18n content client. */
-export interface ClientConfig {
-  /** Project identifier in `org/project` format (e.g., "acme-corp/web-app"). Same as the dashboard URL path. */
-  project: string;
-  /** API key for authenticating content requests. Required. */
-  apiKey: string;
-  /** REST API base URL. Defaults to `https://dash.better-i18n.com`. */
-  apiBase?: string;
-  /** Enable debug logging to see request URLs, headers, and responses. */
-  debug?: boolean;
-}
-
-// ─── Content Types ───────────────────────────────────────────────────
-
-/**
- * A full content entry with all localized fields.
- *
- * @typeParam CF - Custom fields shape. Defaults to `Record<string, string | null>`.
- *
- * @example
- * ```typescript
- * // Typed custom fields
- * interface BlogFields { readingTime: string | null; category: string | null }
- * const post = await client.getEntry<BlogFields>("blog", "hello-world");
- * post.customFields.readingTime; // string | null (typed!)
- * ```
- */
-export interface ContentEntry<CF extends Record<string, string | null> = Record<string, string | null>> {
-  id: string;
-  slug: string;
-  status: "draft" | "published" | "archived";
-  publishedAt: string | null;
-  sourceLanguage: string;
-  availableLanguages: string[];
-  featuredImage: string | null;
-  tags: string[];
-  author: { name: string; image: string | null } | null;
-  customFields: CF;
-  // Localized content
-  title: string;
-  excerpt: string | null;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  body: Record<string, any> | null;
-  bodyHtml: string | null;
-  bodyMarkdown: string | null;
-  metaTitle: string | null;
-  metaDescription: string | null;
-}
-
-/** Entry status filter values. */
-export type ContentEntryStatus = "draft" | "published" | "archived";
-
-/** A summary item for content entry lists. */
-export interface ContentEntryListItem {
-  slug: string;
-  title: string;
-  excerpt: string | null;
-  publishedAt: string | null;
-  featuredImage: string | null;
-  tags: string[];
-  author: { name: string; image: string | null } | null;
-}
-
-/** Paginated response wrapper. */
-export interface PaginatedResponse<T> {
-  items: T[];
-  total: number;
-  hasMore: boolean;
-}
-
-/** A content model definition. */
-export interface ContentModel {
-  slug: string;
-  displayName: string;
-  description: string | null;
-  kind: string;
-  entryCount: number;
-}
-
-// ─── Client Interface ───────────────────────────────────────────────
-
-/** Sortable fields for content entries. */
-export type ContentEntrySortField = "publishedAt" | "createdAt" | "updatedAt" | "title";
-
-/** Options for listing content entries. */
-export interface ListEntriesOptions {
-  /** Language code for localized content. Defaults to source language. */
-  language?: string;
-  /** Filter by entry status. */
-  status?: ContentEntryStatus;
-  /** Field to sort by. Defaults to `"updatedAt"`. */
-  sort?: ContentEntrySortField;
-  /** Sort direction. Defaults to `"desc"`. */
-  order?: "asc" | "desc";
-  /** Page number (1-based). */
-  page?: number;
-  /** Max entries per page (1-100). Defaults to 50. */
-  limit?: number;
-}
-
-/** Options for fetching a single content entry. */
-export interface GetEntryOptions {
-  /** Language code for localized content. Defaults to source language. */
-  language?: string;
-}
-
-/** Client for fetching content entries and models. */
-export interface ContentClient {
-  /** List all content models in the project. */
-  getModels(): Promise<ContentModel[]>;
-  /** List entries for a content model with pagination. */
-  getEntries(
-    modelSlug: string,
-    options?: ListEntriesOptions,
-  ): Promise<PaginatedResponse<ContentEntryListItem>>;
-  /** Fetch a single content entry by slug. */
-  getEntry<CF extends Record<string, string | null> = Record<string, string | null>>(
-    modelSlug: string,
-    entrySlug: string,
-    options?: GetEntryOptions,
-  ): Promise<ContentEntry<CF>>;
-}