@better-i18n/sdk 1.1.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -6
- package/dist/content-api.d.ts.map +1 -1
- package/dist/content-api.js +4 -0
- package/dist/content-api.js.map +1 -1
- package/dist/types.d.ts +13 -20
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -43,7 +43,7 @@ const { items, total, hasMore } = await client.getEntries("blog-posts", {
|
|
|
43
43
|
const post = await client.getEntry("blog-posts", "hello-world", {
|
|
44
44
|
language: "fr",
|
|
45
45
|
});
|
|
46
|
-
console.log(post.title, post.
|
|
46
|
+
console.log(post.title, post.body);
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
## API
|
|
@@ -64,12 +64,16 @@ console.log(post.title, post.bodyMarkdown);
|
|
|
64
64
|
| `order` | `"asc" \| "desc"` | `"desc"` | Sort direction |
|
|
65
65
|
| `page` | `number` | `1` | Page number (1-based) |
|
|
66
66
|
| `limit` | `number` | `50` | Entries per page (1-100) |
|
|
67
|
+
| `fields` | `string[]` | all fields | Fields to include in response |
|
|
68
|
+
| `expand` | `string[]` | none | Relation field names to expand |
|
|
67
69
|
|
|
68
70
|
### `getEntry` Options
|
|
69
71
|
|
|
70
72
|
| Option | Type | Default | Description |
|
|
71
73
|
| --- | --- | --- | --- |
|
|
72
74
|
| `language` | `string` | source language | Language code for localized content |
|
|
75
|
+
| `fields` | `string[]` | all fields | Fields to include in response |
|
|
76
|
+
| `expand` | `string[]` | none | Relation field names to expand |
|
|
73
77
|
|
|
74
78
|
### Response Types
|
|
75
79
|
|
|
@@ -77,7 +81,7 @@ console.log(post.title, post.bodyMarkdown);
|
|
|
77
81
|
|
|
78
82
|
```typescript
|
|
79
83
|
{
|
|
80
|
-
items: ContentEntryListItem[]; // slug, title,
|
|
84
|
+
items: ContentEntryListItem[]; // id, slug, title, publishedAt, customFields, relations?
|
|
81
85
|
total: number; // total matching entries
|
|
82
86
|
hasMore: boolean; // more pages available
|
|
83
87
|
}
|
|
@@ -88,9 +92,7 @@ console.log(post.title, post.bodyMarkdown);
|
|
|
88
92
|
```typescript
|
|
89
93
|
{
|
|
90
94
|
id, slug, status, publishedAt, sourceLanguage, availableLanguages,
|
|
91
|
-
|
|
92
|
-
title, excerpt, body, bodyHtml, bodyMarkdown,
|
|
93
|
-
metaTitle, metaDescription
|
|
95
|
+
title, body, customFields, relations?
|
|
94
96
|
}
|
|
95
97
|
```
|
|
96
98
|
|
|
@@ -109,13 +111,41 @@ post.customFields.readingTime; // string | null (typed!)
|
|
|
109
111
|
post.customFields.category; // string | null (typed!)
|
|
110
112
|
```
|
|
111
113
|
|
|
114
|
+
## Expanding Relations
|
|
115
|
+
|
|
116
|
+
Use `expand` to resolve related entries in a single request. Expanded relations are available under the `relations` key.
|
|
117
|
+
|
|
118
|
+
```typescript
|
|
119
|
+
const { items } = await client.getEntries("blog-posts", {
|
|
120
|
+
expand: ["author", "category"],
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
// Access expanded relation fields
|
|
124
|
+
items[0].relations?.author?.title; // "Alice Johnson"
|
|
125
|
+
items[0].relations?.author?.modelSlug; // "users"
|
|
126
|
+
items[0].relations?.author?.customFields?.avatar; // "https://..."
|
|
127
|
+
items[0].relations?.category?.title; // "Engineering"
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Each expanded relation is a `RelationValue` object:
|
|
131
|
+
|
|
132
|
+
```typescript
|
|
133
|
+
interface RelationValue {
|
|
134
|
+
id: string;
|
|
135
|
+
slug: string;
|
|
136
|
+
title: string;
|
|
137
|
+
modelSlug: string;
|
|
138
|
+
customFields?: Record<string, string | null>;
|
|
139
|
+
}
|
|
140
|
+
```
|
|
141
|
+
|
|
112
142
|
## Configuration
|
|
113
143
|
|
|
114
144
|
| Option | Required | Description |
|
|
115
145
|
| --- | --- | --- |
|
|
116
146
|
| `project` | Yes | Project identifier in `org/project` format (e.g., `"acme/web-app"`) |
|
|
117
147
|
| `apiKey` | Yes | API key from [dashboard](https://dash.better-i18n.com) |
|
|
118
|
-
| `apiBase` | No | API base URL (default: `https://
|
|
148
|
+
| `apiBase` | No | API base URL (default: `https://content.better-i18n.com`) |
|
|
119
149
|
|
|
120
150
|
## Documentation
|
|
121
151
|
|
|
@@ -1 +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,
|
|
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"}
|
package/dist/content-api.js
CHANGED
|
@@ -55,6 +55,8 @@ export function createContentAPIClient(apiBase, org, project, apiKey, debug = fa
|
|
|
55
55
|
params.set("limit", String(options.limit));
|
|
56
56
|
if (options?.expand?.length)
|
|
57
57
|
params.set("expand", options.expand.join(","));
|
|
58
|
+
if (options?.fields?.length)
|
|
59
|
+
params.set("fields", options.fields.join(","));
|
|
58
60
|
const qs = params.toString() ? `?${params}` : "";
|
|
59
61
|
const { data } = await request(`${base}/models/${modelSlug}/entries${qs}`, `getEntries(${modelSlug})`);
|
|
60
62
|
return {
|
|
@@ -69,6 +71,8 @@ export function createContentAPIClient(apiBase, org, project, apiKey, debug = fa
|
|
|
69
71
|
params.set("language", options.language);
|
|
70
72
|
if (options?.expand?.length)
|
|
71
73
|
params.set("expand", options.expand.join(","));
|
|
74
|
+
if (options?.fields?.length)
|
|
75
|
+
params.set("fields", options.fields.join(","));
|
|
72
76
|
const qs = params.toString() ? `?${params}` : "";
|
|
73
77
|
const { data } = await request(`${base}/models/${modelSlug}/entries/${entrySlug}${qs}`, `getEntry(${modelSlug}/${entrySlug})`);
|
|
74
78
|
return data;
|
package/dist/content-api.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"content-api.js","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"content-api.js","sourceRoot":"","sources":["../src/content-api.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -4,7 +4,7 @@ export interface ClientConfig {
|
|
|
4
4
|
project: string;
|
|
5
5
|
/** API key for authenticating content requests. Required. */
|
|
6
6
|
apiKey: string;
|
|
7
|
-
/** REST API base URL. Defaults to `https://
|
|
7
|
+
/** REST API base URL. Defaults to `https://content.better-i18n.com`. */
|
|
8
8
|
apiBase?: string;
|
|
9
9
|
/** Enable debug logging to see request URLs, headers, and responses. */
|
|
10
10
|
debug?: boolean;
|
|
@@ -19,6 +19,8 @@ export interface RelationValue {
|
|
|
19
19
|
title: string;
|
|
20
20
|
/** Target model slug */
|
|
21
21
|
modelSlug: string;
|
|
22
|
+
/** The related entry's own custom field values (or user profile fields for _users). */
|
|
23
|
+
customFields?: Record<string, string | null>;
|
|
22
24
|
}
|
|
23
25
|
/**
|
|
24
26
|
* A full content entry with all localized fields.
|
|
@@ -40,22 +42,12 @@ export interface ContentEntry<CF extends Record<string, string | null> = Record<
|
|
|
40
42
|
publishedAt: string | null;
|
|
41
43
|
sourceLanguage: string;
|
|
42
44
|
availableLanguages: string[];
|
|
43
|
-
featuredImage: string | null;
|
|
44
|
-
tags: string[];
|
|
45
|
-
author: {
|
|
46
|
-
name: string;
|
|
47
|
-
image: string | null;
|
|
48
|
-
} | null;
|
|
49
45
|
customFields: CF;
|
|
50
46
|
/** Expanded relation fields (only present when expand is used) */
|
|
51
47
|
relations?: Record<string, RelationValue | null>;
|
|
52
48
|
title: string;
|
|
53
|
-
|
|
54
|
-
body:
|
|
55
|
-
bodyHtml: string | null;
|
|
56
|
-
bodyMarkdown: string | null;
|
|
57
|
-
metaTitle: string | null;
|
|
58
|
-
metaDescription: string | null;
|
|
49
|
+
/** Rich text body as Markdown string. */
|
|
50
|
+
body: string | null;
|
|
59
51
|
}
|
|
60
52
|
/** Entry status filter values. */
|
|
61
53
|
export type ContentEntryStatus = "draft" | "published" | "archived";
|
|
@@ -63,14 +55,11 @@ export type ContentEntryStatus = "draft" | "published" | "archived";
|
|
|
63
55
|
export interface ContentEntryListItem {
|
|
64
56
|
slug: string;
|
|
65
57
|
title: string;
|
|
66
|
-
excerpt: string | null;
|
|
67
58
|
publishedAt: string | null;
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
image: string | null;
|
|
73
|
-
} | null;
|
|
59
|
+
/** Markdown body — only present when `fields` includes `"body"`. */
|
|
60
|
+
body?: string | null;
|
|
61
|
+
/** Custom fields — only present when `fields` includes specific field names. */
|
|
62
|
+
customFields?: Record<string, string | null>;
|
|
74
63
|
/** Expanded relation fields (only present when expand is used) */
|
|
75
64
|
relations?: Record<string, RelationValue | null>;
|
|
76
65
|
}
|
|
@@ -104,6 +93,8 @@ export interface ListEntriesOptions {
|
|
|
104
93
|
page?: number;
|
|
105
94
|
/** Max entries per page (1-100). Defaults to 50. */
|
|
106
95
|
limit?: number;
|
|
96
|
+
/** Fields to include in the response (e.g., ["title", "body", "category"]). Returns all fields when omitted. */
|
|
97
|
+
fields?: string[];
|
|
107
98
|
/** Relation field names to expand (e.g., ["category", "author"]) */
|
|
108
99
|
expand?: string[];
|
|
109
100
|
}
|
|
@@ -111,6 +102,8 @@ export interface ListEntriesOptions {
|
|
|
111
102
|
export interface GetEntryOptions {
|
|
112
103
|
/** Language code for localized content. Defaults to source language. */
|
|
113
104
|
language?: string;
|
|
105
|
+
/** Fields to include in the response (e.g., ["title", "body"]). Returns all fields when omitted. */
|
|
106
|
+
fields?: string[];
|
|
114
107
|
/** Relation field names to expand (e.g., ["category", "author"]) */
|
|
115
108
|
expand?: string[];
|
|
116
109
|
}
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
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,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|