@better-i18n/sdk 2.0.0 → 3.0.0

package/README.md

@@ -8,8 +8,9 @@ Content SDK for [Better i18n](https://better-i18n.com). A lightweight, typed cli
 - 🔒 **Type-Safe** — Full TypeScript types with generic custom fields
 - 🌍 **Language-Aware** — Fetch localized content by language code
 - 📄 **Pagination Built-in** — Paginated listing with total count and `hasMore`
-- 🔍 **Filtering & Sorting** — Filter by status, sort by date or title
-- ⚡ **Lightweight** — Thin wrapper over REST API
+- 🔍 **Filtering, Search & Sorting** — Filter by status, custom fields, full-text search
+- ⚡ **Chainable Query Builder** — Supabase-style `from().eq().order().limit()` API
+- 🛡️ **Error-Safe** — `{ data, error }` pattern — never throws on API errors
 
 ## Installation
 
@@ -27,76 +28,144 @@ const client = createClient({
   apiKey: process.env.BETTER_I18N_API_KEY!,
 });
 
-// List content models
-const models = await client.getModels();
-
-// List published blog posts
-const { items, total, hasMore } = await client.getEntries("blog-posts", {
-  status: "published",
-  sort: "publishedAt",
-  order: "desc",
-  language: "en",
-  limit: 10,
-});
-
-// Get a single entry with localized content
-const post = await client.getEntry("blog-posts", "hello-world", {
-  language: "fr",
-});
-console.log(post.title, post.bodyMarkdown);
+// List published blog posts (chainable API)
+const { data: posts, error, total, hasMore } = await client
+  .from("blog-posts")
+  .eq("status", "published")
+  .order("publishedAt", { ascending: false })
+  .limit(10)
+  .language("en");
+
+// Get a single entry
+const { data: post, error: postError } = await client
+  .from("blog-posts")
+  .expand("author", "category")
+  .language("fr")
+  .single("hello-world");
+
+if (post) {
+  console.log(post.title, post.body);
+}
 ```
 
-## API
+## Chainable Query Builder
 
-| Method | Description |
-| --- | --- |
-| `getModels()` | List all content models with entry counts |
-| `getEntries(modelSlug, options?)` | Paginated list of entries for a model |
-| `getEntry(modelSlug, entrySlug, options?)` | Full content entry with all fields |
+The `from()` method returns an immutable, chainable query builder — inspired by Supabase JS.
 
-### `getEntries` Options
+Every chain method returns a **new** builder instance, so you can safely reuse base queries:
 
-| Option | Type | Default | Description |
-| --- | --- | --- | --- |
-| `language` | `string` | source language | Language code for localized content |
-| `status` | `"draft" \| "published" \| "archived"` | all | Filter by entry status |
-| `sort` | `"publishedAt" \| "createdAt" \| "updatedAt" \| "title"` | `"updatedAt"` | Sort field |
-| `order` | `"asc" \| "desc"` | `"desc"` | Sort direction |
-| `page` | `number` | `1` | Page number (1-based) |
-| `limit` | `number` | `50` | Entries per page (1-100) |
+```typescript
+const publishedPosts = client
+  .from("blog-posts")
+  .eq("status", "published");
+
+// Reuse the base query
+const recentPosts = await publishedPosts
+  .order("publishedAt", { ascending: false })
+  .limit(5);
+
+const popularPosts = await publishedPosts
+  .order("title", { ascending: true })
+  .limit(10);
+```
 
-### `getEntry` Options
+### Chain Methods
 
-| Option | Type | Default | Description |
-| --- | --- | --- | --- |
-| `language` | `string` | source language | Language code for localized content |
+| Method | Description | Example |
+| --- | --- | --- |
+| `.select(...fields)` | Choose which fields to include | `.select("title", "body")` |
+| `.eq(field, value)` | Filter by built-in field (status, etc.) | `.eq("status", "published")` |
+| `.filter(field, value)` | Filter by custom field value | `.filter("category", "engineering")` |
+| `.search(term)` | Full-text search on entry titles | `.search("kubernetes")` |
+| `.language(code)` | Set language for localized content | `.language("fr")` |
+| `.order(field, opts?)` | Set sort field and direction | `.order("publishedAt", { ascending: false })` |
+| `.limit(n)` | Max entries per page (1-100) | `.limit(10)` |
+| `.page(n)` | Page number (1-based) | `.page(2)` |
+| `.expand(...fields)` | Expand relation fields | `.expand("author", "category")` |
+
+### Terminal Methods
+
+| Method | Description | Returns |
+| --- | --- | --- |
+| `.single(slug)` | Fetch a single entry by slug | `{ data, error }` |
+| `await builder` | Execute list query (thenable) | `{ data, error, total, hasMore }` |
 
 ### Response Types
 
-**`getEntries` returns `PaginatedResponse<ContentEntryListItem>`:**
+**List query returns `QueryResult<T[]>`:**
 
 ```typescript
 {
-  items: ContentEntryListItem[]; // slug, title, excerpt, publishedAt, tags, author
-  total: number;                 // total matching entries
-  hasMore: boolean;              // more pages available
+  data: ContentEntryListItem[] | null;  // null on error
+  error: Error | null;                   // null on success
+  total: number;                         // total matching entries
+  hasMore: boolean;                      // more pages available
 }
 ```
 
-**`getEntry` returns `ContentEntry<CF>`:**
+**Single query returns `SingleQueryResult<ContentEntry>`:**
 
 ```typescript
 {
-  id, slug, status, publishedAt, sourceLanguage, availableLanguages,
-  featuredImage, tags, author, customFields,
-  title, excerpt, body, bodyHtml, bodyMarkdown,
-  metaTitle, metaDescription
+  data: ContentEntry | null;  // null on error
+  error: Error | null;        // null on success
 }
 ```
 
+### Examples
+
+```typescript
+// Full-text search
+const { data: results } = await client
+  .from("blog-posts")
+  .search("kubernetes")
+  .limit(5);
+
+// Custom field filtering
+const { data: techPosts } = await client
+  .from("blog-posts")
+  .filter("category", "engineering")
+  .eq("status", "published")
+  .language("en");
+
+// Select specific fields + expand relations
+const { data: entries } = await client
+  .from("blog-posts")
+  .select("title", "body")
+  .expand("author")
+  .order("publishedAt", { ascending: false });
+
+// Pagination
+const { data: page2, hasMore } = await client
+  .from("blog-posts")
+  .eq("status", "published")
+  .limit(20)
+  .page(2);
+```
+
+## Error Handling
+
+The chainable API uses the `{ data, error }` pattern — it never throws on API errors:
+
+```typescript
+const { data, error } = await client
+  .from("blog-posts")
+  .eq("status", "published")
+  .limit(10);
+
+if (error) {
+  console.error("Failed to fetch posts:", error.message);
+  return;
+}
+
+// data is guaranteed non-null here
+console.log(`Found ${data.length} posts`);
+```
+
 ## Typed Custom Fields
 
-Use the generic type parameter for type-safe custom fields:
+Custom fields are returned flat — directly on the entry object (no `customFields` wrapper).
+Use the generic type parameter for type-safe access:
 
 ```typescript
 interface BlogFields {
@@ -104,9 +173,65 @@ interface BlogFields {
   category: string | null;
 }
 
-const post = await client.getEntry<BlogFields>("blog-posts", "hello-world");
-post.customFields.readingTime; // string | null (typed!)
-post.customFields.category;   // string | null (typed!)
+const { data: post } = await client
+  .from("blog-posts")
+  .single<BlogFields>("hello-world");
+
+if (post) {
+  post.readingTime; // string | null (typed!)
+  post.category;    // string | null (typed!)
+}
+```
+
+## Expanding Relations
+
+Use `expand` to resolve related entries in a single request:
+
+```typescript
+const { data: posts } = await client
+  .from("blog-posts")
+  .expand("author", "category")
+  .eq("status", "published");
+
+if (posts) {
+  posts[0].relations?.author?.title;    // "Alice Johnson"
+  posts[0].relations?.author?.avatar;   // "https://..."
+  posts[0].relations?.category?.title;  // "Engineering"
+}
+```
+
+Each expanded relation is a `RelationValue` object with custom fields spread directly:
+
+```typescript
+type RelationValue = {
+  id: string;
+  slug: string;
+  title: string;
+  modelSlug: string;
+} & Record<string, string | null>;
+```
+
+## Legacy API
+
+The method-based API is still available for backward compatibility:
+
+```typescript
+// List content models
+const models = await client.getModels();
+
+// List entries (throws on error)
+const { items, total, hasMore } = await client.getEntries("blog-posts", {
+  status: "published",
+  sort: "publishedAt",
+  order: "desc",
+  language: "en",
+  limit: 10,
+});
+
+// Get single entry (throws on error)
+const post = await client.getEntry("blog-posts", "hello-world", {
+  language: "fr",
+});
 ```
 
 ## Configuration
@@ -115,7 +240,8 @@ post.customFields.category;   // string | null (typed!)
 | --- | --- | --- |
 | `project` | Yes | Project identifier in `org/project` format (e.g., `"acme/web-app"`) |
 | `apiKey` | Yes | API key from [dashboard](https://dash.better-i18n.com) |
-| `apiBase` | No | API base URL (default: `https://dash.better-i18n.com`) |
+| `apiBase` | No | API base URL (default: `https://content.better-i18n.com`) |
+| `debug` | No | Enable debug logging for request/response inspection |
 
 ## Documentation
 

package/dist/client.d.ts

@@ -2,8 +2,8 @@ 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.
+ * Supports both a **Supabase-style chainable API** (`from()`) and the
+ * legacy method-based API (`getEntries`, `getEntry`, `getModels`).
  *
  * @example
  * ```typescript
@@ -12,9 +12,22 @@ import type { ClientConfig, ContentClient } from "./types.js";
  *   apiKey: "bi18n_...",
  * });
  *
+ * // Chainable API (recommended)
+ * const { data, error } = await client
+ *   .from("blog-posts")
+ *   .eq("status", "published")
+ *   .order("publishedAt", { ascending: false })
+ *   .limit(10);
+ *
+ * // Single entry
+ * const { data: post } = await client
+ *   .from("blog-posts")
+ *   .language("fr")
+ *   .single("hello-world");
+ *
+ * // Legacy API (still works)
  * 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;

package/dist/client.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CA6BhE"}

package/dist/client.js

@@ -1,10 +1,11 @@
-import { createContentAPIClient } from "./content-api.js";
+import { createHttpClient } from "./http.js";
+import { ContentQueryBuilder } from "./query-builder.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.
+ * Supports both a **Supabase-style chainable API** (`from()`) and the
+ * legacy method-based API (`getEntries`, `getEntry`, `getModels`).
  *
  * @example
  * ```typescript
@@ -13,9 +14,22 @@ const DEFAULT_API_BASE = "https://content.better-i18n.com";
  *   apiKey: "bi18n_...",
  * });
  *
+ * // Chainable API (recommended)
+ * const { data, error } = await client
+ *   .from("blog-posts")
+ *   .eq("status", "published")
+ *   .order("publishedAt", { ascending: false })
+ *   .limit(10);
+ *
+ * // Single entry
+ * const { data: post } = await client
+ *   .from("blog-posts")
+ *   .language("fr")
+ *   .single("hello-world");
+ *
+ * // Legacy API (still works)
  * 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) {
@@ -30,6 +44,14 @@ export function createClient(config) {
             "Set apiKey in your client config:\n\n" +
             '  createClient({ project: "acme/web-app", apiKey: "bi18n_..." })');
     }
-    return createContentAPIClient(apiBase, org, project, config.apiKey, config.debug);
+    const http = createHttpClient(apiBase, org, project, config.apiKey, config.debug);
+    return {
+        from(modelSlug) {
+            return ContentQueryBuilder.create(http, modelSlug);
+        },
+        getModels: () => http.getModels(),
+        getEntries: (model, opts) => http.getEntries(model, opts),
+        getEntry: (model, slug, opts) => http.getEntry(model, slug, opts),
+    };
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,gBAAgB,GAAG,iCAAiC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAElF,OAAO;QACL,IAAI,CAAC,SAAiB;YACpB,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE;QACjC,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC;QACzD,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/content-api.d.ts

@@ -1,14 +1,5 @@
-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}`
+ * @deprecated Import from `./http.js` instead. This file is kept for backward compatibility.
  */
-export declare function createContentAPIClient(apiBase: string, org: string, project: string, apiKey: string, debug?: boolean): ContentClient;
+export { createHttpClient as createContentAPIClient } from "./http.js";
 //# sourceMappingURL=content-api.d.ts.map

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

@@ -1 +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,CA+Ef"}
+{"version":3,"file":"content-api.d.ts","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/content-api.js

@@ -1,82 +1,5 @@
 /**
- * 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}`
+ * @deprecated Import from `./http.js` instead. This file is kept for backward compatibility.
  */
-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));
-            if (options?.expand?.length)
-                params.set("expand", options.expand.join(","));
-            if (options?.fields?.length)
-                params.set("fields", options.fields.join(","));
-            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);
-            if (options?.expand?.length)
-                params.set("expand", options.expand.join(","));
-            if (options?.fields?.length)
-                params.set("fields", options.fields.join(","));
-            const qs = params.toString() ? `?${params}` : "";
-            const { data } = await request(`${base}/models/${modelSlug}/entries/${entrySlug}${qs}`, `getEntry(${modelSlug}/${entrySlug})`);
-            return data;
-        },
-    };
-}
+export { createHttpClient as createContentAPIClient } from "./http.js";
 //# sourceMappingURL=content-api.js.map

package/dist/content-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-api.js","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content-api.js","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,21 @@
+import type { ContentEntry, ContentEntryListItem, ContentModel, GetEntryOptions, ListEntriesOptions, PaginatedResponse } from "./types.js";
+/** Low-level HTTP client used by both the legacy API and the query builder. */
+export interface HttpClient {
+    /** Make a raw GET request and return `{ data, error }` (never throws). */
+    request<T>(path: string, params?: URLSearchParams): Promise<HttpResult<T>>;
+    /** List content models. */
+    getModels(): Promise<ContentModel[]>;
+    /** List entries with legacy options. */
+    getEntries(model: string, opts?: ListEntriesOptions): Promise<PaginatedResponse<ContentEntryListItem>>;
+    /** Fetch a single entry by slug. */
+    getEntry<CF extends Record<string, string | null> = Record<string, string | null>>(model: string, slug: string, opts?: GetEntryOptions): Promise<ContentEntry<CF>>;
+}
+export type HttpResult<T> = {
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: Error;
+};
+export declare function createHttpClient(apiBase: string, org: string, project: string, apiKey: string, debug?: boolean): HttpClient;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,2BAA2B;IAC3B,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrC,wCAAwC;IACxC,UAAU,CACR,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACpD,oCAAoC;IACpC,QAAQ,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAC/E,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAIjC,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,UAAQ,GACZ,UAAU,CAuFZ"}

package/dist/http.js

@@ -0,0 +1,78 @@
+// ─── Factory ────────────────────────────────────────────────────────
+export function createHttpClient(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 });
+    }
+    /** Internal fetch helper — throws on HTTP errors. */
+    async function rawRequest(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 data;
+    }
+    return {
+        async request(path, params) {
+            const qs = params?.toString() ? `?${params}` : "";
+            const url = `${base}${path}${qs}`;
+            try {
+                const data = await rawRequest(url, `request(${path})`);
+                return { data, error: null };
+            }
+            catch (err) {
+                return { data: null, error: err instanceof Error ? err : new Error(String(err)) };
+            }
+        },
+        async getModels() {
+            return rawRequest(`${base}/models`, "getModels");
+        },
+        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));
+            if (options?.expand?.length)
+                params.set("expand", options.expand.join(","));
+            if (options?.fields?.length)
+                params.set("fields", options.fields.join(","));
+            const qs = params.toString() ? `?${params}` : "";
+            const data = await rawRequest(`${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);
+            if (options?.expand?.length)
+                params.set("expand", options.expand.join(","));
+            if (options?.fields?.length)
+                params.set("fields", options.fields.join(","));
+            const qs = params.toString() ? `?${params}` : "";
+            return rawRequest(`${base}/models/${modelSlug}/entries/${entrySlug}${qs}`, `getEntry(${modelSlug}/${entrySlug})`);
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,8 @@
 export { createClient } from "./client.js";
+export { ContentQueryBuilder, SingleQueryBuilder } from "./query-builder.js";
+export { createHttpClient } from "./http.js";
+/** @deprecated Use `createHttpClient` from `./http.js` instead. */
 export { createContentAPIClient } from "./content-api.js";
-export type { ClientConfig, ContentClient, ContentEntry, ContentEntryListItem, ContentEntryStatus, ContentEntrySortField, ContentModel, ListEntriesOptions, GetEntryOptions, PaginatedResponse, RelationValue, } from "./types.js";
+export type { ClientConfig, ContentClient, ContentEntry, ContentEntryListItem, ContentEntryStatus, ContentEntrySortField, ContentModel, ListEntriesOptions, GetEntryOptions, PaginatedResponse, QueryResult, SingleQueryResult, RelationValue, } from "./types.js";
+export type { HttpClient, HttpResult } from "./http.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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,EACjB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,mEAAmE;AACnE,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,EACjB,WAAW,EACX,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,3 +1,6 @@
 export { createClient } from "./client.js";
+export { ContentQueryBuilder, SingleQueryBuilder } from "./query-builder.js";
+export { createHttpClient } from "./http.js";
+/** @deprecated Use `createHttpClient` from `./http.js` instead. */
 export { createContentAPIClient } from "./content-api.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,mEAAmE;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/query-builder.d.ts

@@ -0,0 +1,134 @@
+import type { HttpClient } from "./http.js";
+import type { ContentEntry, ContentEntryListItem, ContentEntrySortField, QueryResult, SingleQueryResult } from "./types.js";
+interface QueryParams {
+    fields: string[];
+    expand: string[];
+    filters: Record<string, string>;
+    search: string | undefined;
+    language: string | undefined;
+    status: string | undefined;
+    sort: ContentEntrySortField | undefined;
+    ascending: boolean | undefined;
+    limitVal: number | undefined;
+    pageVal: number | undefined;
+}
+/**
+ * Terminal builder for fetching a single entry by slug.
+ * Thenable — can be awaited directly.
+ */
+export declare class SingleQueryBuilder<CF extends Record<string, string | null> = Record<string, string | null>> {
+    private readonly _http;
+    private readonly _model;
+    private readonly _slug;
+    private readonly _params;
+    /** @internal */
+    constructor(_http: HttpClient, _model: string, _slug: string, _params: QueryParams);
+    /** Execute the query. Prefer `await builder` over calling this directly. */
+    execute(): Promise<SingleQueryResult<ContentEntry<CF>>>;
+    /** Makes this object thenable so `await builder.single("slug")` works. */
+    then<TResult1 = SingleQueryResult<ContentEntry<CF>>, TResult2 = never>(onfulfilled?: ((value: SingleQueryResult<ContentEntry<CF>>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+/**
+ * Supabase-style chainable query builder for content entries.
+ *
+ * Each chainable method returns a **new** builder instance (immutable).
+ * The builder is thenable — `await` it to execute the query.
+ *
+ * @example
+ * ```typescript
+ * const { data, error, total, hasMore } = await client
+ *   .from("blog-posts")
+ *   .select("title", "body")
+ *   .eq("status", "published")
+ *   .order("publishedAt", { ascending: false })
+ *   .limit(10)
+ *   .language("en");
+ * ```
+ */
+export declare class ContentQueryBuilder<T = ContentEntryListItem> {
+    private readonly _http;
+    private readonly _model;
+    private readonly _params;
+    /** @internal — use `ContentQueryBuilder.create()` */
+    private constructor();
+    /** @internal */
+    static create(http: HttpClient, model: string): ContentQueryBuilder;
+    private clone;
+    /**
+     * Choose which fields to include in the response.
+     *
+     * @example `.select("title", "body", "category")`
+     */
+    select(...fields: string[]): ContentQueryBuilder<T>;
+    /**
+     * Filter by a built-in field value (status, etc.).
+     *
+     * @example `.eq("status", "published")`
+     */
+    eq(field: string, value: string): ContentQueryBuilder<T>;
+    /**
+     * Filter by a custom field value. Maps to `?filter[field]=value` on the REST API.
+     *
+     * @example `.filter("category", "engineering")`
+     */
+    filter(field: string, value: string): ContentQueryBuilder<T>;
+    /**
+     * Full-text search on entry titles.
+     *
+     * @example `.search("kubernetes")`
+     */
+    search(term: string): ContentQueryBuilder<T>;
+    /**
+     * Set the language for localized content.
+     *
+     * @example `.language("fr")`
+     */
+    language(code: string): ContentQueryBuilder<T>;
+    /**
+     * Set the sort field and direction.
+     *
+     * @example `.order("publishedAt", { ascending: false })`
+     */
+    order(field: ContentEntrySortField, opts?: {
+        ascending?: boolean;
+    }): ContentQueryBuilder<T>;
+    /**
+     * Limit the number of results per page (1-100).
+     *
+     * @example `.limit(10)`
+     */
+    limit(n: number): ContentQueryBuilder<T>;
+    /**
+     * Set the page number (1-based).
+     *
+     * @example `.page(2)`
+     */
+    page(n: number): ContentQueryBuilder<T>;
+    /**
+     * Expand relation fields by name.
+     *
+     * @example `.expand("author", "category")`
+     */
+    expand(...fields: string[]): ContentQueryBuilder<T>;
+    /**
+     * Switch to single-entry mode. Returns a thenable that resolves a single entry.
+     *
+     * @example
+     * ```typescript
+     * const { data: post, error } = await client
+     *   .from("blog-posts")
+     *   .language("fr")
+     *   .single("hello-world");
+     * ```
+     */
+    single<CF extends Record<string, string | null> = Record<string, string | null>>(slug: string): SingleQueryBuilder<CF>;
+    /**
+     * Execute the list query. Prefer `await builder` over calling this directly.
+     */
+    execute(): Promise<QueryResult<T[]>>;
+    /** Makes this object thenable so `await client.from("posts").limit(5)` works. */
+    then<TResult1 = QueryResult<T[]>, TResult2 = never>(onfulfilled?: ((value: QueryResult<T[]>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    private buildSearchParams;
+}
+export {};
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/query-builder.d.ts.map

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

package/dist/query-builder.js

@@ -0,0 +1,237 @@
+function emptyParams() {
+    return {
+        fields: [],
+        expand: [],
+        filters: {},
+        search: undefined,
+        language: undefined,
+        status: undefined,
+        sort: undefined,
+        ascending: undefined,
+        limitVal: undefined,
+        pageVal: undefined,
+    };
+}
+// ─── SingleQueryBuilder ─────────────────────────────────────────────
+/**
+ * Terminal builder for fetching a single entry by slug.
+ * Thenable — can be awaited directly.
+ */
+export class SingleQueryBuilder {
+    _http;
+    _model;
+    _slug;
+    _params;
+    /** @internal */
+    constructor(_http, _model, _slug, _params) {
+        this._http = _http;
+        this._model = _model;
+        this._slug = _slug;
+        this._params = _params;
+    }
+    /** Execute the query. Prefer `await builder` over calling this directly. */
+    async execute() {
+        const params = new URLSearchParams();
+        if (this._params.language)
+            params.set("language", this._params.language);
+        if (this._params.fields.length)
+            params.set("fields", this._params.fields.join(","));
+        if (this._params.expand.length)
+            params.set("expand", this._params.expand.join(","));
+        const result = await this._http.request(`/models/${this._model}/entries/${this._slug}`, params);
+        if (result.error) {
+            return { data: null, error: result.error };
+        }
+        return { data: result.data, error: null };
+    }
+    /** Makes this object thenable so `await builder.single("slug")` works. */
+    then(onfulfilled, onrejected) {
+        return this.execute().then(onfulfilled, onrejected);
+    }
+}
+// ─── ContentQueryBuilder ────────────────────────────────────────────
+/**
+ * Supabase-style chainable query builder for content entries.
+ *
+ * Each chainable method returns a **new** builder instance (immutable).
+ * The builder is thenable — `await` it to execute the query.
+ *
+ * @example
+ * ```typescript
+ * const { data, error, total, hasMore } = await client
+ *   .from("blog-posts")
+ *   .select("title", "body")
+ *   .eq("status", "published")
+ *   .order("publishedAt", { ascending: false })
+ *   .limit(10)
+ *   .language("en");
+ * ```
+ */
+export class ContentQueryBuilder {
+    _http;
+    _model;
+    _params;
+    /** @internal — use `ContentQueryBuilder.create()` */
+    constructor(_http, _model, _params) {
+        this._http = _http;
+        this._model = _model;
+        this._params = _params;
+    }
+    /** @internal */
+    static create(http, model) {
+        return new ContentQueryBuilder(http, model, emptyParams());
+    }
+    // ─── Private helpers ────────────────────────────────────────────
+    clone(patch) {
+        return new ContentQueryBuilder(this._http, this._model, {
+            ...this._params,
+            ...patch,
+        });
+    }
+    // ─── Chainable methods ──────────────────────────────────────────
+    /**
+     * Choose which fields to include in the response.
+     *
+     * @example `.select("title", "body", "category")`
+     */
+    select(...fields) {
+        return this.clone({ fields: [...this._params.fields, ...fields] });
+    }
+    /**
+     * Filter by a built-in field value (status, etc.).
+     *
+     * @example `.eq("status", "published")`
+     */
+    eq(field, value) {
+        if (field === "status") {
+            return this.clone({ status: value });
+        }
+        return this.clone({
+            filters: { ...this._params.filters, [field]: value },
+        });
+    }
+    /**
+     * Filter by a custom field value. Maps to `?filter[field]=value` on the REST API.
+     *
+     * @example `.filter("category", "engineering")`
+     */
+    filter(field, value) {
+        return this.clone({
+            filters: { ...this._params.filters, [field]: value },
+        });
+    }
+    /**
+     * Full-text search on entry titles.
+     *
+     * @example `.search("kubernetes")`
+     */
+    search(term) {
+        return this.clone({ search: term });
+    }
+    /**
+     * Set the language for localized content.
+     *
+     * @example `.language("fr")`
+     */
+    language(code) {
+        return this.clone({ language: code });
+    }
+    /**
+     * Set the sort field and direction.
+     *
+     * @example `.order("publishedAt", { ascending: false })`
+     */
+    order(field, opts) {
+        return this.clone({
+            sort: field,
+            ascending: opts?.ascending,
+        });
+    }
+    /**
+     * Limit the number of results per page (1-100).
+     *
+     * @example `.limit(10)`
+     */
+    limit(n) {
+        return this.clone({ limitVal: n });
+    }
+    /**
+     * Set the page number (1-based).
+     *
+     * @example `.page(2)`
+     */
+    page(n) {
+        return this.clone({ pageVal: n });
+    }
+    /**
+     * Expand relation fields by name.
+     *
+     * @example `.expand("author", "category")`
+     */
+    expand(...fields) {
+        return this.clone({ expand: [...this._params.expand, ...fields] });
+    }
+    // ─── Terminal methods ───────────────────────────────────────────
+    /**
+     * Switch to single-entry mode. Returns a thenable that resolves a single entry.
+     *
+     * @example
+     * ```typescript
+     * const { data: post, error } = await client
+     *   .from("blog-posts")
+     *   .language("fr")
+     *   .single("hello-world");
+     * ```
+     */
+    single(slug) {
+        return new SingleQueryBuilder(this._http, this._model, slug, this._params);
+    }
+    /**
+     * Execute the list query. Prefer `await builder` over calling this directly.
+     */
+    async execute() {
+        const params = this.buildSearchParams();
+        const result = await this._http.request(`/models/${this._model}/entries`, params);
+        if (result.error) {
+            return { data: null, error: result.error, total: 0, hasMore: false };
+        }
+        return {
+            data: result.data.items,
+            error: null,
+            total: result.data.total,
+            hasMore: result.data.hasMore,
+        };
+    }
+    /** Makes this object thenable so `await client.from("posts").limit(5)` works. */
+    then(onfulfilled, onrejected) {
+        return this.execute().then(onfulfilled, onrejected);
+    }
+    // ─── Internal ───────────────────────────────────────────────────
+    buildSearchParams() {
+        const params = new URLSearchParams();
+        if (this._params.language)
+            params.set("language", this._params.language);
+        if (this._params.status)
+            params.set("status", this._params.status);
+        if (this._params.sort)
+            params.set("sort", this._params.sort);
+        if (this._params.ascending !== undefined) {
+            params.set("order", this._params.ascending ? "asc" : "desc");
+        }
+        if (this._params.pageVal)
+            params.set("page", String(this._params.pageVal));
+        if (this._params.limitVal)
+            params.set("limit", String(this._params.limitVal));
+        if (this._params.fields.length)
+            params.set("fields", this._params.fields.join(","));
+        if (this._params.expand.length)
+            params.set("expand", this._params.expand.join(","));
+        if (this._params.search)
+            params.set("search", this._params.search);
+        for (const [key, value] of Object.entries(this._params.filters)) {
+            params.set(`filter[${key}]`, value);
+        }
+        return params;
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/query-builder.js.map

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

package/dist/types.d.ts

@@ -4,13 +4,13 @@ export interface ClientConfig {
     project: string;
     /** API key for authenticating content requests. Required. */
     apiKey: string;
-    /** REST API base URL. Defaults to `https://dash.better-i18n.com`. */
+    /** REST API base URL. Defaults to `https://content.better-i18n.com`. */
     apiBase?: string;
     /** Enable debug logging to see request URLs, headers, and responses. */
     debug?: boolean;
 }
-/** Expanded relation value returned when a relation field is expanded. */
-export interface RelationValue {
+/** Expanded relation value returned when a relation field is expanded. Custom fields are spread directly on the object. */
+export type RelationValue = {
     /** Referenced entry UUID */
     id: string;
     /** Referenced entry slug */
@@ -19,9 +19,10 @@ export interface RelationValue {
     title: string;
     /** Target model slug */
     modelSlug: string;
-}
+} & Record<string, string | null>;
 /**
  * A full content entry with all localized fields.
+ * Custom fields are spread directly on the entry object (flat access).
  *
  * @typeParam CF - Custom fields shape. Defaults to `Record<string, string | null>`.
  *
@@ -29,38 +30,36 @@ export interface RelationValue {
  * ```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!)
+ * const { data: post } = await client.from("blog").single<BlogFields>("hello-world");
+ * post.readingTime; // string | null (typed!)
+ * post.category;    // string | null (typed!)
  * ```
  */
-export interface ContentEntry<CF extends Record<string, string | null> = Record<string, string | null>> {
+export type 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[];
-    customFields: CF;
     /** Expanded relation fields (only present when expand is used) */
     relations?: Record<string, RelationValue | null>;
     title: string;
     /** Rich text body as Markdown string. */
     body: string | null;
-}
+} & CF;
 /** Entry status filter values. */
 export type ContentEntryStatus = "draft" | "published" | "archived";
-/** A summary item for content entry lists. */
-export interface ContentEntryListItem {
+/** A summary item for content entry lists. Custom fields are spread directly on the object. */
+export type ContentEntryListItem<CF extends Record<string, string | null> = Record<string, string | null>> = {
     slug: string;
     title: string;
     publishedAt: string | null;
     /** Markdown body — only present when `fields` includes `"body"`. */
     body?: string | null;
-    /** Custom fields — only present when `fields` includes specific field names. */
-    customFields?: Record<string, string | null>;
     /** Expanded relation fields (only present when expand is used) */
     relations?: Record<string, RelationValue | null>;
-}
+} & CF;
 /** Paginated response wrapper. */
 export interface PaginatedResponse<T> {
     items: T[];
@@ -75,6 +74,18 @@ export interface ContentModel {
     kind: string;
     entryCount: number;
 }
+/** Result of a list query — Supabase-style `{ data, error }` pattern. */
+export interface QueryResult<T> {
+    data: T | null;
+    error: Error | null;
+    total: number;
+    hasMore: boolean;
+}
+/** Result of a single-entry query — Supabase-style `{ data, error }` pattern. */
+export interface SingleQueryResult<T> {
+    data: T | null;
+    error: Error | null;
+}
 /** Sortable fields for content entries. */
 export type ContentEntrySortField = "publishedAt" | "createdAt" | "updatedAt" | "title";
 /** Options for listing content entries. */
@@ -105,13 +116,33 @@ export interface GetEntryOptions {
     /** Relation field names to expand (e.g., ["category", "author"]) */
     expand?: string[];
 }
+import type { ContentQueryBuilder } from "./query-builder.js";
 /** Client for fetching content entries and models. */
 export interface ContentClient {
+    /**
+     * Start a chainable query for a content model — Supabase-style API.
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await client
+     *   .from("blog-posts")
+     *   .eq("status", "published")
+     *   .order("publishedAt", { ascending: false })
+     *   .limit(10);
+     * ```
+     */
+    from(modelSlug: string): ContentQueryBuilder;
     /** List all content models in the project. */
     getModels(): Promise<ContentModel[]>;
-    /** List entries for a content model with pagination. */
+    /**
+     * List entries for a content model with pagination.
+     * @deprecated Use `client.from(modelSlug)` for a chainable, composable API.
+     */
     getEntries(modelSlug: string, options?: ListEntriesOptions): Promise<PaginatedResponse<ContentEntryListItem>>;
-    /** Fetch a single content entry by slug. */
+    /**
+     * Fetch a single content entry by slug.
+     * @deprecated Use `client.from(modelSlug).single(slug)` for error-safe API.
+     */
     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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/sdk",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Content SDK for Better i18n - headless CMS client for fetching content models and entries",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -b --force",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run build"