@expandai/sdk 0.14.0 → 0.15.0

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/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.15.0 (2026-02-19)
4
+
5
+ Full Changelog: [v0.14.0...v0.15.0](https://github.com/expandai/expandai-node/compare/v0.14.0...v0.15.0)
6
+
7
+ ### Features
8
+
9
+ * **api:** api update ([caec526](https://github.com/expandai/expandai-node/commit/caec526ac68b6b400126e3f1e38508fd2a5476a6))
10
+
3
11
  ## 0.14.0 (2026-02-18)
4
12
 
5
13
  Full Changelog: [v0.13.3...v0.14.0](https://github.com/expandai/expandai-node/compare/v0.13.3...v0.14.0)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expandai/sdk",
3
- "version": "0.14.0",
3
+ "version": "0.15.0",
4
4
  "description": "The official TypeScript library for the Expand API",
5
5
  "author": "Expand <support@expand.ai>",
6
6
  "types": "./index.d.ts",
@@ -18,27 +18,47 @@ export declare namespace FetchResponse {
18
18
  * HTTP response information (URL, status code, optionally headers)
19
19
  */
20
20
  response: Data.Response;
21
- appendix?: unknown;
21
+ /**
22
+ * Extracted links and sidebar content
23
+ */
24
+ appendix?: string;
22
25
  /**
23
26
  * Unique identifier for the browser session that performed this fetch
24
27
  */
25
28
  browserSessionId?: string;
26
- html?: unknown;
29
+ /**
30
+ * The HTML content of the fetched page
31
+ */
32
+ html?: string;
27
33
  /**
28
34
  * Pruned JSON objects extracted from the page (from HTML and network responses).
29
35
  * This is recomputed on every fetch and is not persisted.
30
36
  */
31
- json?: unknown;
32
- links?: unknown;
33
- markdown?: unknown;
37
+ json?: Array<unknown>;
38
+ /**
39
+ * Links extracted from the page
40
+ */
41
+ links?: Array<Data.Link>;
42
+ /**
43
+ * The markdown-formatted content extracted from the page
44
+ */
45
+ markdown?: string;
34
46
  /**
35
- * Page metadata extracted from HTML head (title, description, Open Graph, Twitter
36
- * Card, icons)
47
+ * Comprehensive metadata extracted from the page HTML head section
37
48
  */
38
- meta?: unknown;
39
- screenshot?: unknown;
40
- snippets?: unknown;
41
- summary?: unknown;
49
+ meta?: Data.Meta;
50
+ /**
51
+ * Base64-encoded data URI of the screenshot image
52
+ */
53
+ screenshot?: string;
54
+ /**
55
+ * Relevant snippets extracted from the page based on the search query
56
+ */
57
+ snippets?: Array<Data.UnionMember0 | Data.UnionMember1>;
58
+ /**
59
+ * AI-generated summary of the page content
60
+ */
61
+ summary?: string;
42
62
  }
43
63
  namespace Data {
44
64
  /**
@@ -61,6 +81,210 @@ export declare namespace FetchResponse {
61
81
  [key: string]: string;
62
82
  };
63
83
  }
84
+ /**
85
+ * A link extracted from the page
86
+ */
87
+ interface Link {
88
+ /**
89
+ * The URL of the link
90
+ */
91
+ url: string;
92
+ /**
93
+ * The anchor text of the link
94
+ */
95
+ text?: string;
96
+ }
97
+ /**
98
+ * Comprehensive metadata extracted from the page HTML head section
99
+ */
100
+ interface Meta {
101
+ /**
102
+ * Canonical URL from <link rel="canonical">
103
+ */
104
+ canonicalUrl?: string;
105
+ /**
106
+ * Character encoding from <meta charset="...">
107
+ */
108
+ charset?: string;
109
+ /**
110
+ * Meta description from <meta name="description">
111
+ */
112
+ description?: string;
113
+ /**
114
+ * Primary favicon URL (first icon found)
115
+ */
116
+ favicon?: string;
117
+ /**
118
+ * All icon links (favicons, apple-touch-icons, etc.)
119
+ */
120
+ icons?: Array<Meta.Icon>;
121
+ /**
122
+ * Page language from <html lang="...">
123
+ */
124
+ language?: string;
125
+ /**
126
+ * Open Graph protocol metadata for rich link previews
127
+ */
128
+ openGraph?: Meta.OpenGraph;
129
+ /**
130
+ * Page title from <title> tag
131
+ */
132
+ title?: string;
133
+ /**
134
+ * Twitter Card metadata for social sharing previews
135
+ */
136
+ twitter?: Meta.Twitter;
137
+ }
138
+ namespace Meta {
139
+ /**
140
+ * Favicon or app icon metadata from <link> tags
141
+ */
142
+ interface Icon {
143
+ /**
144
+ * Icon URL or path
145
+ */
146
+ href: string;
147
+ /**
148
+ * Link relationship type
149
+ */
150
+ rel: string;
151
+ /**
152
+ * Icon dimensions
153
+ */
154
+ sizes?: string;
155
+ /**
156
+ * MIME type of the icon
157
+ */
158
+ type?: string;
159
+ }
160
+ /**
161
+ * Open Graph protocol metadata for rich link previews
162
+ */
163
+ interface OpenGraph {
164
+ /**
165
+ * Open Graph description (og:description)
166
+ */
167
+ description?: string;
168
+ /**
169
+ * Open Graph images (og:image and related properties)
170
+ */
171
+ images?: Array<OpenGraph.Image>;
172
+ /**
173
+ * Locale in language_TERRITORY format (og:locale)
174
+ */
175
+ locale?: string;
176
+ /**
177
+ * Site name (og:site_name)
178
+ */
179
+ siteName?: string;
180
+ /**
181
+ * Open Graph title (og:title)
182
+ */
183
+ title?: string;
184
+ /**
185
+ * Open Graph type (og:type) - website, article, product, etc.
186
+ */
187
+ type?: string;
188
+ /**
189
+ * Canonical URL for the content (og:url)
190
+ */
191
+ url?: string;
192
+ }
193
+ namespace OpenGraph {
194
+ /**
195
+ * Open Graph image with optional dimensions and alt text
196
+ */
197
+ interface Image {
198
+ /**
199
+ * Image URL
200
+ */
201
+ url: string;
202
+ /**
203
+ * Image alt text for accessibility
204
+ */
205
+ alt?: string;
206
+ /**
207
+ * Image height in pixels
208
+ */
209
+ height?: number;
210
+ /**
211
+ * Image width in pixels
212
+ */
213
+ width?: number;
214
+ }
215
+ }
216
+ /**
217
+ * Twitter Card metadata for social sharing previews
218
+ */
219
+ interface Twitter {
220
+ /**
221
+ * Twitter card type (twitter:card)
222
+ */
223
+ card?: string;
224
+ /**
225
+ * Twitter @username of content creator (twitter:creator)
226
+ */
227
+ creator?: string;
228
+ /**
229
+ * Description for Twitter card (twitter:description)
230
+ */
231
+ description?: string;
232
+ /**
233
+ * Image URL for Twitter card (twitter:image)
234
+ */
235
+ image?: string;
236
+ /**
237
+ * Twitter @username of the website (twitter:site)
238
+ */
239
+ site?: string;
240
+ /**
241
+ * Title for Twitter card (twitter:title)
242
+ */
243
+ title?: string;
244
+ }
245
+ }
246
+ interface UnionMember0 {
247
+ _tag: 'MarkdownSnippet';
248
+ /**
249
+ * Original chunk index
250
+ */
251
+ index: number;
252
+ /**
253
+ * Relevance score from the reranker (0-1)
254
+ */
255
+ score: number;
256
+ /**
257
+ * The text content of the snippet
258
+ */
259
+ text: string;
260
+ /**
261
+ * Type identifier for TextPart compatibility
262
+ */
263
+ type?: 'text';
264
+ }
265
+ interface UnionMember1 {
266
+ _tag: 'JsonSnippet';
267
+ /**
268
+ * Original chunk index
269
+ */
270
+ index: number;
271
+ /**
272
+ * The structured JSON subtree value
273
+ */
274
+ json: unknown;
275
+ /**
276
+ * Relevance score from the reranker (0-1)
277
+ */
278
+ score: number;
279
+ /**
280
+ * Pretty-printed JSON chunk text
281
+ */
282
+ text: string;
283
+ /**
284
+ * Type identifier for TextPart compatibility
285
+ */
286
+ type?: 'text';
287
+ }
64
288
  }
65
289
  }
66
290
  export interface FetchParams {
@@ -1 +1 @@
1
- {"version":3,"file":"top-level.d.mts","sourceRoot":"","sources":["../src/resources/top-level.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"top-level.d.mts","sourceRoot":"","sources":["../src/resources/top-level.ts"],"names":[],"mappings":"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"}
@@ -18,27 +18,47 @@ export declare namespace FetchResponse {
18
18
  * HTTP response information (URL, status code, optionally headers)
19
19
  */
20
20
  response: Data.Response;
21
- appendix?: unknown;
21
+ /**
22
+ * Extracted links and sidebar content
23
+ */
24
+ appendix?: string;
22
25
  /**
23
26
  * Unique identifier for the browser session that performed this fetch
24
27
  */
25
28
  browserSessionId?: string;
26
- html?: unknown;
29
+ /**
30
+ * The HTML content of the fetched page
31
+ */
32
+ html?: string;
27
33
  /**
28
34
  * Pruned JSON objects extracted from the page (from HTML and network responses).
29
35
  * This is recomputed on every fetch and is not persisted.
30
36
  */
31
- json?: unknown;
32
- links?: unknown;
33
- markdown?: unknown;
37
+ json?: Array<unknown>;
38
+ /**
39
+ * Links extracted from the page
40
+ */
41
+ links?: Array<Data.Link>;
42
+ /**
43
+ * The markdown-formatted content extracted from the page
44
+ */
45
+ markdown?: string;
34
46
  /**
35
- * Page metadata extracted from HTML head (title, description, Open Graph, Twitter
36
- * Card, icons)
47
+ * Comprehensive metadata extracted from the page HTML head section
37
48
  */
38
- meta?: unknown;
39
- screenshot?: unknown;
40
- snippets?: unknown;
41
- summary?: unknown;
49
+ meta?: Data.Meta;
50
+ /**
51
+ * Base64-encoded data URI of the screenshot image
52
+ */
53
+ screenshot?: string;
54
+ /**
55
+ * Relevant snippets extracted from the page based on the search query
56
+ */
57
+ snippets?: Array<Data.UnionMember0 | Data.UnionMember1>;
58
+ /**
59
+ * AI-generated summary of the page content
60
+ */
61
+ summary?: string;
42
62
  }
43
63
  namespace Data {
44
64
  /**
@@ -61,6 +81,210 @@ export declare namespace FetchResponse {
61
81
  [key: string]: string;
62
82
  };
63
83
  }
84
+ /**
85
+ * A link extracted from the page
86
+ */
87
+ interface Link {
88
+ /**
89
+ * The URL of the link
90
+ */
91
+ url: string;
92
+ /**
93
+ * The anchor text of the link
94
+ */
95
+ text?: string;
96
+ }
97
+ /**
98
+ * Comprehensive metadata extracted from the page HTML head section
99
+ */
100
+ interface Meta {
101
+ /**
102
+ * Canonical URL from <link rel="canonical">
103
+ */
104
+ canonicalUrl?: string;
105
+ /**
106
+ * Character encoding from <meta charset="...">
107
+ */
108
+ charset?: string;
109
+ /**
110
+ * Meta description from <meta name="description">
111
+ */
112
+ description?: string;
113
+ /**
114
+ * Primary favicon URL (first icon found)
115
+ */
116
+ favicon?: string;
117
+ /**
118
+ * All icon links (favicons, apple-touch-icons, etc.)
119
+ */
120
+ icons?: Array<Meta.Icon>;
121
+ /**
122
+ * Page language from <html lang="...">
123
+ */
124
+ language?: string;
125
+ /**
126
+ * Open Graph protocol metadata for rich link previews
127
+ */
128
+ openGraph?: Meta.OpenGraph;
129
+ /**
130
+ * Page title from <title> tag
131
+ */
132
+ title?: string;
133
+ /**
134
+ * Twitter Card metadata for social sharing previews
135
+ */
136
+ twitter?: Meta.Twitter;
137
+ }
138
+ namespace Meta {
139
+ /**
140
+ * Favicon or app icon metadata from <link> tags
141
+ */
142
+ interface Icon {
143
+ /**
144
+ * Icon URL or path
145
+ */
146
+ href: string;
147
+ /**
148
+ * Link relationship type
149
+ */
150
+ rel: string;
151
+ /**
152
+ * Icon dimensions
153
+ */
154
+ sizes?: string;
155
+ /**
156
+ * MIME type of the icon
157
+ */
158
+ type?: string;
159
+ }
160
+ /**
161
+ * Open Graph protocol metadata for rich link previews
162
+ */
163
+ interface OpenGraph {
164
+ /**
165
+ * Open Graph description (og:description)
166
+ */
167
+ description?: string;
168
+ /**
169
+ * Open Graph images (og:image and related properties)
170
+ */
171
+ images?: Array<OpenGraph.Image>;
172
+ /**
173
+ * Locale in language_TERRITORY format (og:locale)
174
+ */
175
+ locale?: string;
176
+ /**
177
+ * Site name (og:site_name)
178
+ */
179
+ siteName?: string;
180
+ /**
181
+ * Open Graph title (og:title)
182
+ */
183
+ title?: string;
184
+ /**
185
+ * Open Graph type (og:type) - website, article, product, etc.
186
+ */
187
+ type?: string;
188
+ /**
189
+ * Canonical URL for the content (og:url)
190
+ */
191
+ url?: string;
192
+ }
193
+ namespace OpenGraph {
194
+ /**
195
+ * Open Graph image with optional dimensions and alt text
196
+ */
197
+ interface Image {
198
+ /**
199
+ * Image URL
200
+ */
201
+ url: string;
202
+ /**
203
+ * Image alt text for accessibility
204
+ */
205
+ alt?: string;
206
+ /**
207
+ * Image height in pixels
208
+ */
209
+ height?: number;
210
+ /**
211
+ * Image width in pixels
212
+ */
213
+ width?: number;
214
+ }
215
+ }
216
+ /**
217
+ * Twitter Card metadata for social sharing previews
218
+ */
219
+ interface Twitter {
220
+ /**
221
+ * Twitter card type (twitter:card)
222
+ */
223
+ card?: string;
224
+ /**
225
+ * Twitter @username of content creator (twitter:creator)
226
+ */
227
+ creator?: string;
228
+ /**
229
+ * Description for Twitter card (twitter:description)
230
+ */
231
+ description?: string;
232
+ /**
233
+ * Image URL for Twitter card (twitter:image)
234
+ */
235
+ image?: string;
236
+ /**
237
+ * Twitter @username of the website (twitter:site)
238
+ */
239
+ site?: string;
240
+ /**
241
+ * Title for Twitter card (twitter:title)
242
+ */
243
+ title?: string;
244
+ }
245
+ }
246
+ interface UnionMember0 {
247
+ _tag: 'MarkdownSnippet';
248
+ /**
249
+ * Original chunk index
250
+ */
251
+ index: number;
252
+ /**
253
+ * Relevance score from the reranker (0-1)
254
+ */
255
+ score: number;
256
+ /**
257
+ * The text content of the snippet
258
+ */
259
+ text: string;
260
+ /**
261
+ * Type identifier for TextPart compatibility
262
+ */
263
+ type?: 'text';
264
+ }
265
+ interface UnionMember1 {
266
+ _tag: 'JsonSnippet';
267
+ /**
268
+ * Original chunk index
269
+ */
270
+ index: number;
271
+ /**
272
+ * The structured JSON subtree value
273
+ */
274
+ json: unknown;
275
+ /**
276
+ * Relevance score from the reranker (0-1)
277
+ */
278
+ score: number;
279
+ /**
280
+ * Pretty-printed JSON chunk text
281
+ */
282
+ text: string;
283
+ /**
284
+ * Type identifier for TextPart compatibility
285
+ */
286
+ type?: 'text';
287
+ }
64
288
  }
65
289
  }
66
290
  export interface FetchParams {
@@ -1 +1 @@
1
- {"version":3,"file":"top-level.d.ts","sourceRoot":"","sources":["../src/resources/top-level.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"top-level.d.ts","sourceRoot":"","sources":["../src/resources/top-level.ts"],"names":[],"mappings":"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"}
@@ -22,36 +22,56 @@ export namespace FetchResponse {
22
22
  */
23
23
  response: Data.Response;
24
24
 
25
- appendix?: unknown;
25
+ /**
26
+ * Extracted links and sidebar content
27
+ */
28
+ appendix?: string;
26
29
 
27
30
  /**
28
31
  * Unique identifier for the browser session that performed this fetch
29
32
  */
30
33
  browserSessionId?: string;
31
34
 
32
- html?: unknown;
35
+ /**
36
+ * The HTML content of the fetched page
37
+ */
38
+ html?: string;
33
39
 
34
40
  /**
35
41
  * Pruned JSON objects extracted from the page (from HTML and network responses).
36
42
  * This is recomputed on every fetch and is not persisted.
37
43
  */
38
- json?: unknown;
44
+ json?: Array<unknown>;
39
45
 
40
- links?: unknown;
46
+ /**
47
+ * Links extracted from the page
48
+ */
49
+ links?: Array<Data.Link>;
41
50
 
42
- markdown?: unknown;
51
+ /**
52
+ * The markdown-formatted content extracted from the page
53
+ */
54
+ markdown?: string;
43
55
 
44
56
  /**
45
- * Page metadata extracted from HTML head (title, description, Open Graph, Twitter
46
- * Card, icons)
57
+ * Comprehensive metadata extracted from the page HTML head section
47
58
  */
48
- meta?: unknown;
59
+ meta?: Data.Meta;
49
60
 
50
- screenshot?: unknown;
61
+ /**
62
+ * Base64-encoded data URI of the screenshot image
63
+ */
64
+ screenshot?: string;
51
65
 
52
- snippets?: unknown;
66
+ /**
67
+ * Relevant snippets extracted from the page based on the search query
68
+ */
69
+ snippets?: Array<Data.UnionMember0 | Data.UnionMember1>;
53
70
 
54
- summary?: unknown;
71
+ /**
72
+ * AI-generated summary of the page content
73
+ */
74
+ summary?: string;
55
75
  }
56
76
 
57
77
  export namespace Data {
@@ -75,6 +95,253 @@ export namespace FetchResponse {
75
95
  */
76
96
  headers?: { [key: string]: string };
77
97
  }
98
+
99
+ /**
100
+ * A link extracted from the page
101
+ */
102
+ export interface Link {
103
+ /**
104
+ * The URL of the link
105
+ */
106
+ url: string;
107
+
108
+ /**
109
+ * The anchor text of the link
110
+ */
111
+ text?: string;
112
+ }
113
+
114
+ /**
115
+ * Comprehensive metadata extracted from the page HTML head section
116
+ */
117
+ export interface Meta {
118
+ /**
119
+ * Canonical URL from <link rel="canonical">
120
+ */
121
+ canonicalUrl?: string;
122
+
123
+ /**
124
+ * Character encoding from <meta charset="...">
125
+ */
126
+ charset?: string;
127
+
128
+ /**
129
+ * Meta description from <meta name="description">
130
+ */
131
+ description?: string;
132
+
133
+ /**
134
+ * Primary favicon URL (first icon found)
135
+ */
136
+ favicon?: string;
137
+
138
+ /**
139
+ * All icon links (favicons, apple-touch-icons, etc.)
140
+ */
141
+ icons?: Array<Meta.Icon>;
142
+
143
+ /**
144
+ * Page language from <html lang="...">
145
+ */
146
+ language?: string;
147
+
148
+ /**
149
+ * Open Graph protocol metadata for rich link previews
150
+ */
151
+ openGraph?: Meta.OpenGraph;
152
+
153
+ /**
154
+ * Page title from <title> tag
155
+ */
156
+ title?: string;
157
+
158
+ /**
159
+ * Twitter Card metadata for social sharing previews
160
+ */
161
+ twitter?: Meta.Twitter;
162
+ }
163
+
164
+ export namespace Meta {
165
+ /**
166
+ * Favicon or app icon metadata from <link> tags
167
+ */
168
+ export interface Icon {
169
+ /**
170
+ * Icon URL or path
171
+ */
172
+ href: string;
173
+
174
+ /**
175
+ * Link relationship type
176
+ */
177
+ rel: string;
178
+
179
+ /**
180
+ * Icon dimensions
181
+ */
182
+ sizes?: string;
183
+
184
+ /**
185
+ * MIME type of the icon
186
+ */
187
+ type?: string;
188
+ }
189
+
190
+ /**
191
+ * Open Graph protocol metadata for rich link previews
192
+ */
193
+ export interface OpenGraph {
194
+ /**
195
+ * Open Graph description (og:description)
196
+ */
197
+ description?: string;
198
+
199
+ /**
200
+ * Open Graph images (og:image and related properties)
201
+ */
202
+ images?: Array<OpenGraph.Image>;
203
+
204
+ /**
205
+ * Locale in language_TERRITORY format (og:locale)
206
+ */
207
+ locale?: string;
208
+
209
+ /**
210
+ * Site name (og:site_name)
211
+ */
212
+ siteName?: string;
213
+
214
+ /**
215
+ * Open Graph title (og:title)
216
+ */
217
+ title?: string;
218
+
219
+ /**
220
+ * Open Graph type (og:type) - website, article, product, etc.
221
+ */
222
+ type?: string;
223
+
224
+ /**
225
+ * Canonical URL for the content (og:url)
226
+ */
227
+ url?: string;
228
+ }
229
+
230
+ export namespace OpenGraph {
231
+ /**
232
+ * Open Graph image with optional dimensions and alt text
233
+ */
234
+ export interface Image {
235
+ /**
236
+ * Image URL
237
+ */
238
+ url: string;
239
+
240
+ /**
241
+ * Image alt text for accessibility
242
+ */
243
+ alt?: string;
244
+
245
+ /**
246
+ * Image height in pixels
247
+ */
248
+ height?: number;
249
+
250
+ /**
251
+ * Image width in pixels
252
+ */
253
+ width?: number;
254
+ }
255
+ }
256
+
257
+ /**
258
+ * Twitter Card metadata for social sharing previews
259
+ */
260
+ export interface Twitter {
261
+ /**
262
+ * Twitter card type (twitter:card)
263
+ */
264
+ card?: string;
265
+
266
+ /**
267
+ * Twitter @username of content creator (twitter:creator)
268
+ */
269
+ creator?: string;
270
+
271
+ /**
272
+ * Description for Twitter card (twitter:description)
273
+ */
274
+ description?: string;
275
+
276
+ /**
277
+ * Image URL for Twitter card (twitter:image)
278
+ */
279
+ image?: string;
280
+
281
+ /**
282
+ * Twitter @username of the website (twitter:site)
283
+ */
284
+ site?: string;
285
+
286
+ /**
287
+ * Title for Twitter card (twitter:title)
288
+ */
289
+ title?: string;
290
+ }
291
+ }
292
+
293
+ export interface UnionMember0 {
294
+ _tag: 'MarkdownSnippet';
295
+
296
+ /**
297
+ * Original chunk index
298
+ */
299
+ index: number;
300
+
301
+ /**
302
+ * Relevance score from the reranker (0-1)
303
+ */
304
+ score: number;
305
+
306
+ /**
307
+ * The text content of the snippet
308
+ */
309
+ text: string;
310
+
311
+ /**
312
+ * Type identifier for TextPart compatibility
313
+ */
314
+ type?: 'text';
315
+ }
316
+
317
+ export interface UnionMember1 {
318
+ _tag: 'JsonSnippet';
319
+
320
+ /**
321
+ * Original chunk index
322
+ */
323
+ index: number;
324
+
325
+ /**
326
+ * The structured JSON subtree value
327
+ */
328
+ json: unknown;
329
+
330
+ /**
331
+ * Relevance score from the reranker (0-1)
332
+ */
333
+ score: number;
334
+
335
+ /**
336
+ * Pretty-printed JSON chunk text
337
+ */
338
+ text: string;
339
+
340
+ /**
341
+ * Type identifier for TextPart compatibility
342
+ */
343
+ type?: 'text';
344
+ }
78
345
  }
79
346
  }
80
347
 
package/src/version.ts CHANGED
@@ -1 +1 @@
1
- export const VERSION = '0.14.0'; // x-release-please-version
1
+ export const VERSION = '0.15.0'; // x-release-please-version
package/version.d.mts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.14.0";
1
+ export declare const VERSION = "0.15.0";
2
2
  //# sourceMappingURL=version.d.mts.map
package/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.14.0";
1
+ export declare const VERSION = "0.15.0";
2
2
  //# sourceMappingURL=version.d.ts.map
package/version.js CHANGED
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.VERSION = void 0;
4
- exports.VERSION = '0.14.0'; // x-release-please-version
4
+ exports.VERSION = '0.15.0'; // x-release-please-version
5
5
  //# sourceMappingURL=version.js.map
package/version.mjs CHANGED
@@ -1,2 +1,2 @@
1
- export const VERSION = '0.14.0'; // x-release-please-version
1
+ export const VERSION = '0.15.0'; // x-release-please-version
2
2
  //# sourceMappingURL=version.mjs.map