@rahmandayub/pexels-mcp 0.0.0-stage → 0.2.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.
Files changed (57) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +192 -2
  3. package/dist/cache.js +77 -0
  4. package/dist/cache.js.map +1 -0
  5. package/dist/config.js +127 -0
  6. package/dist/config.js.map +1 -0
  7. package/dist/errors.js +57 -0
  8. package/dist/errors.js.map +1 -0
  9. package/dist/index.js +77 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/log.js +56 -0
  12. package/dist/log.js.map +1 -0
  13. package/dist/pexels/client.js +193 -0
  14. package/dist/pexels/client.js.map +1 -0
  15. package/dist/pexels/quirks.js +283 -0
  16. package/dist/pexels/quirks.js.map +1 -0
  17. package/dist/pexels/schemas.js +134 -0
  18. package/dist/pexels/schemas.js.map +1 -0
  19. package/dist/present/collection.js +23 -0
  20. package/dist/present/collection.js.map +1 -0
  21. package/dist/present/envelope.js +20 -0
  22. package/dist/present/envelope.js.map +1 -0
  23. package/dist/present/photo.js +86 -0
  24. package/dist/present/photo.js.map +1 -0
  25. package/dist/present/util.js +24 -0
  26. package/dist/present/util.js.map +1 -0
  27. package/dist/present/video.js +117 -0
  28. package/dist/present/video.js.map +1 -0
  29. package/dist/tools/collection-media.js +54 -0
  30. package/dist/tools/collection-media.js.map +1 -0
  31. package/dist/tools/curated-photos.js +42 -0
  32. package/dist/tools/curated-photos.js.map +1 -0
  33. package/dist/tools/featured-collections.js +42 -0
  34. package/dist/tools/featured-collections.js.map +1 -0
  35. package/dist/tools/get-photo.js +46 -0
  36. package/dist/tools/get-photo.js.map +1 -0
  37. package/dist/tools/get-video.js +46 -0
  38. package/dist/tools/get-video.js.map +1 -0
  39. package/dist/tools/helpers.js +38 -0
  40. package/dist/tools/helpers.js.map +1 -0
  41. package/dist/tools/index.js +21 -0
  42. package/dist/tools/index.js.map +1 -0
  43. package/dist/tools/photo-url.js +84 -0
  44. package/dist/tools/photo-url.js.map +1 -0
  45. package/dist/tools/popular-videos.js +62 -0
  46. package/dist/tools/popular-videos.js.map +1 -0
  47. package/dist/tools/preview.js +21 -0
  48. package/dist/tools/preview.js.map +1 -0
  49. package/dist/tools/search-photos.js +67 -0
  50. package/dist/tools/search-photos.js.map +1 -0
  51. package/dist/tools/search-videos.js +60 -0
  52. package/dist/tools/search-videos.js.map +1 -0
  53. package/dist/types.js +118 -0
  54. package/dist/types.js.map +1 -0
  55. package/dist/version.js +6 -0
  56. package/dist/version.js.map +1 -0
  57. package/package.json +52 -4
@@ -0,0 +1,193 @@
1
+ import { RequestCache } from '../cache.js';
2
+ import { ToolError } from '../errors.js';
3
+ import { log } from '../log.js';
4
+ import { SERVER_NAME, VERSION } from '../version.js';
5
+ import { backoffMs, isPexelsImageUrl, observeRateLimit, retryAfterMs, toToolError } from './quirks.js';
6
+ export const PEXELS_BASE_URL = 'https://api.pexels.com';
7
+ const RETRYABLE_STATUS = new Set([429, 500, 502, 503, 504]);
8
+ /** Preview images are capped so a tool result stays small. */
9
+ export const PREVIEW_MAX_BYTES = 1_500_000;
10
+ export class PexelsClient {
11
+ apiKey;
12
+ baseUrl;
13
+ timeoutMs;
14
+ maxRetries;
15
+ fetchImpl;
16
+ cache;
17
+ sleep;
18
+ now;
19
+ userAgent = `${SERVER_NAME}/${VERSION} (node/${process.versions.node})`;
20
+ constructor(options) {
21
+ this.apiKey = options.apiKey;
22
+ this.baseUrl = (options.baseUrl ?? PEXELS_BASE_URL).replace(/\/+$/, '');
23
+ this.timeoutMs = options.timeoutMs ?? 15_000;
24
+ this.maxRetries = options.maxRetries ?? 2;
25
+ this.fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
26
+ this.cache = options.cache ?? new RequestCache({ ttlMs: 0 });
27
+ this.sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
28
+ this.now = options.now ?? Date.now;
29
+ }
30
+ async get(path, params, schema) {
31
+ const key = RequestCache.key(path, params);
32
+ const started = this.now();
33
+ const result = await this.cache.wrap(key, () => this.requestWithRetry(path, params, schema));
34
+ log('debug', 'upstream_request', {
35
+ path,
36
+ cacheHit: result.cacheHit,
37
+ durationMs: this.now() - started,
38
+ });
39
+ return result;
40
+ }
41
+ /**
42
+ * Fetch image bytes for inline previews.
43
+ *
44
+ * Deliberately separate from `get`: no API key is sent to the CDN, only
45
+ * Pexels-owned hosts are allowed, and the payload has a byte budget so a
46
+ * preview can never blow up the caller's context.
47
+ */
48
+ async getImage(url, options = {}) {
49
+ if (!isPexelsImageUrl(url)) {
50
+ throw new ToolError('INTERNAL', 'refusing to fetch an image outside the Pexels CDN', {
51
+ hint: 'this is a bug in pexels-mcp — image URLs must come from Pexels itself',
52
+ });
53
+ }
54
+ const maxBytes = options.maxBytes ?? PREVIEW_MAX_BYTES;
55
+ const started = this.now();
56
+ const result = await this.cache.wrap(`image:${url}`, async () => {
57
+ let response;
58
+ try {
59
+ response = await this.fetchImpl(url, {
60
+ method: 'GET',
61
+ // Never send the Pexels API key to the image CDN.
62
+ headers: { Accept: 'image/*', 'User-Agent': this.userAgent },
63
+ signal: AbortSignal.timeout(this.timeoutMs),
64
+ });
65
+ }
66
+ catch (error) {
67
+ const isTimeout = error?.name === 'TimeoutError';
68
+ throw new ToolError('NETWORK', isTimeout
69
+ ? `image download timed out after ${this.timeoutMs}ms`
70
+ : `could not download the image (${error.message})`, { hint: 'the API answer is still valid — use the URL without `preview` and retry later' });
71
+ }
72
+ if (!response.ok)
73
+ throw toToolError(response.status, await this.readBody(response));
74
+ const mimeType = (response.headers.get('content-type') ?? '').split(';')[0].trim().toLowerCase();
75
+ if (!mimeType.startsWith('image/')) {
76
+ throw new ToolError('DECODE', `Pexels CDN returned ${mimeType === '' ? 'no content type' : mimeType} instead of an image`, { hint: 'retry, and report this if it persists' });
77
+ }
78
+ const data = Buffer.from(await response.arrayBuffer());
79
+ if (data.byteLength > maxBytes) {
80
+ throw new ToolError('DECODE', `preview is ${Math.round(data.byteLength / 1024)}KB, over the ${Math.round(maxBytes / 1024)}KB budget`, { hint: 'ask for a smaller width, or use the URLs without `preview`' });
81
+ }
82
+ return { mimeType, data, bytes: data.byteLength };
83
+ });
84
+ log('debug', 'image_fetch', {
85
+ cacheHit: result.cacheHit,
86
+ bytes: result.value.bytes,
87
+ durationMs: this.now() - started,
88
+ });
89
+ return { ...result.value, cacheHit: result.cacheHit };
90
+ }
91
+ headers() {
92
+ return {
93
+ // Pexels expects the raw key, no "Bearer" prefix.
94
+ Authorization: this.apiKey,
95
+ Accept: 'application/json',
96
+ 'User-Agent': this.userAgent,
97
+ };
98
+ }
99
+ buildUrl(path, params) {
100
+ const suffix = RequestCache.key(path, params).slice(path.length);
101
+ return `${this.baseUrl}${path}${suffix}`;
102
+ }
103
+ async requestWithRetry(path, params, schema) {
104
+ const url = this.buildUrl(path, params);
105
+ for (let attempt = 0;; attempt += 1) {
106
+ const started = this.now();
107
+ let response;
108
+ try {
109
+ response = await this.fetchImpl(url, {
110
+ method: 'GET',
111
+ headers: this.headers(),
112
+ signal: AbortSignal.timeout(this.timeoutMs),
113
+ });
114
+ }
115
+ catch (error) {
116
+ const isTimeout = error?.name === 'TimeoutError';
117
+ const reason = isTimeout ? `timed out after ${this.timeoutMs}ms` : error.message;
118
+ if (attempt < this.maxRetries) {
119
+ const waitMs = backoffMs(attempt);
120
+ log('warn', 'retry', { path, attempt: attempt + 1, waitMs, reason: 'network' });
121
+ await this.sleep(waitMs);
122
+ continue;
123
+ }
124
+ throw new ToolError('NETWORK', `could not reach Pexels (${reason}) after ${attempt + 1} attempt(s)`, { hint: 'check the network connection, then retry' });
125
+ }
126
+ const durationMs = this.now() - started;
127
+ observeRateLimit(response.headers);
128
+ if (response.ok) {
129
+ const payload = await this.readJson(response, path);
130
+ return this.decode(payload, schema, path);
131
+ }
132
+ const body = await this.readBody(response);
133
+ if (RETRYABLE_STATUS.has(response.status) && attempt < this.maxRetries) {
134
+ const waitMs = retryAfterMs(response.headers.get('retry-after'), this.now) ?? backoffMs(attempt);
135
+ log('warn', 'retry', {
136
+ path,
137
+ attempt: attempt + 1,
138
+ waitMs,
139
+ status: response.status,
140
+ durationMs,
141
+ });
142
+ await this.sleep(waitMs);
143
+ continue;
144
+ }
145
+ log('warn', 'upstream_error', { path, status: response.status, durationMs });
146
+ throw toToolError(response.status, body);
147
+ }
148
+ }
149
+ async readBody(response) {
150
+ try {
151
+ const text = await response.text();
152
+ if (text.trim() === '')
153
+ return undefined;
154
+ try {
155
+ return JSON.parse(text);
156
+ }
157
+ catch {
158
+ return text;
159
+ }
160
+ }
161
+ catch {
162
+ return undefined;
163
+ }
164
+ }
165
+ async readJson(response, path) {
166
+ const text = await response.text();
167
+ try {
168
+ return JSON.parse(text);
169
+ }
170
+ catch {
171
+ throw new ToolError('DECODE', `Pexels returned a non-JSON body for ${path}`, {
172
+ hint: 'this looks like a bug or an outage upstream — retry, and report it if it persists',
173
+ });
174
+ }
175
+ }
176
+ decode(payload, schema, path) {
177
+ const parsed = schema.safeParse(payload);
178
+ if (parsed.success)
179
+ return parsed.data;
180
+ const issues = parsed.error.issues
181
+ .slice(0, 3)
182
+ .map((issue) => {
183
+ const where = issue.path.map(String).join('.');
184
+ return where === '' ? issue.message : `${where}: ${issue.message}`;
185
+ })
186
+ .join('; ');
187
+ log('error', 'decode_error', { path, issues });
188
+ throw new ToolError('DECODE', `unexpected response shape from ${path} (${issues})`, {
189
+ hint: 'the Pexels API changed shape — report this bug with the endpoint name',
190
+ });
191
+ }
192
+ }
193
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/pexels/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,283 @@
1
+ import { log } from '../log.js';
2
+ import { ToolError } from '../errors.js';
3
+ /**
4
+ * Everything Pexels does differently from a well-behaved API lives here.
5
+ * Nothing in this file does I/O, so every rule is unit-testable.
6
+ */
7
+ export const NAMED_COLORS = [
8
+ 'red',
9
+ 'orange',
10
+ 'yellow',
11
+ 'green',
12
+ 'turquoise',
13
+ 'blue',
14
+ 'violet',
15
+ 'pink',
16
+ 'brown',
17
+ 'black',
18
+ 'gray',
19
+ 'white',
20
+ ];
21
+ export const COLOR_MESSAGE = `invalid color — use #rrggbb, #rgb, or one of: ${NAMED_COLORS.join(', ')}`;
22
+ /** Trim and collapse internal whitespace runs to a single space. */
23
+ export function collapseWhitespace(value) {
24
+ return value.trim().replace(/\s+/g, ' ');
25
+ }
26
+ /**
27
+ * Normalise a colour filter to a bare lowercase hex value (no `#`), or keep a
28
+ * known colour name. Returns null when the value is not usable.
29
+ */
30
+ export function normaliseColor(input) {
31
+ const value = input.trim().toLowerCase();
32
+ if (value === '')
33
+ return null;
34
+ if (NAMED_COLORS.includes(value))
35
+ return value;
36
+ const hex = value.startsWith('#') ? value.slice(1) : value;
37
+ if (/^[0-9a-f]{3}$/.test(hex)) {
38
+ return hex
39
+ .split('')
40
+ .map((char) => char + char)
41
+ .join('');
42
+ }
43
+ if (/^[0-9a-f]{6}$/.test(hex))
44
+ return hex;
45
+ return null;
46
+ }
47
+ /** Quirk #10: odd dimensions get a human-readable ratio. */
48
+ const COMMON_RATIOS = [
49
+ [21, 9],
50
+ [16, 9],
51
+ [4, 3],
52
+ [3, 2],
53
+ [5, 4],
54
+ [1, 1],
55
+ [4, 5],
56
+ [2, 3],
57
+ [3, 4],
58
+ [9, 16],
59
+ [2, 1],
60
+ [1, 2],
61
+ ];
62
+ const RATIO_TOLERANCE = 0.015;
63
+ const EXACT_RATIO_MAX = 64;
64
+ function gcd(a, b) {
65
+ let x = Math.abs(a);
66
+ let y = Math.abs(b);
67
+ while (y !== 0) {
68
+ const t = y;
69
+ y = x % y;
70
+ x = t;
71
+ }
72
+ return x || 1;
73
+ }
74
+ export function aspectRatio(width, height) {
75
+ if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
76
+ return '1:1';
77
+ }
78
+ const divisor = gcd(width, height);
79
+ const reducedWidth = Math.round(width / divisor);
80
+ const reducedHeight = Math.round(height / divisor);
81
+ if (reducedWidth <= EXACT_RATIO_MAX && reducedHeight <= EXACT_RATIO_MAX) {
82
+ return `${reducedWidth}:${reducedHeight}`;
83
+ }
84
+ const target = width / height;
85
+ let best;
86
+ let bestError = Number.POSITIVE_INFINITY;
87
+ for (const ratio of COMMON_RATIOS) {
88
+ const error = Math.abs(ratio[0] / ratio[1] - target) / target;
89
+ if (error < bestError) {
90
+ bestError = error;
91
+ best = ratio;
92
+ }
93
+ }
94
+ if (best && bestError <= RATIO_TOLERANCE)
95
+ return `${best[0]}:${best[1]}`;
96
+ return `${reducedWidth}:${reducedHeight}`;
97
+ }
98
+ export function orientationOf(width, height) {
99
+ if (width > height)
100
+ return 'landscape';
101
+ if (height > width)
102
+ return 'portrait';
103
+ return 'square';
104
+ }
105
+ /** Quirk #11: fps arrives as float artifacts like 29.969999. */
106
+ export function round1(value) {
107
+ return Math.round(value * 10) / 10;
108
+ }
109
+ /**
110
+ * Quirk #1 and #9: never forward upstream pagination URLs (they contain a
111
+ * duplicated `/v1`), and derive the numbers from totals when available.
112
+ */
113
+ export function derivePagination(input) {
114
+ const { page, per_page, count, hasNextHint } = input;
115
+ const total = Number.isFinite(input.total_results) ? input.total_results : undefined;
116
+ const hasNext = total !== undefined
117
+ ? count > 0 && page * per_page < total
118
+ : count > 0 && (hasNextHint ?? count >= per_page);
119
+ const pagination = { page, per_page };
120
+ if (total !== undefined)
121
+ pagination.total_results = total;
122
+ if (hasNext)
123
+ pagination.next_page = page + 1;
124
+ if (page > 1)
125
+ pagination.prev_page = page - 1;
126
+ return pagination;
127
+ }
128
+ export const IMAGE_HOST = 'images.pexels.com';
129
+ /** Only ever fetch or derive images on Pexels' own CDN. */
130
+ export function isPexelsImageUrl(value) {
131
+ try {
132
+ const url = new URL(value);
133
+ return url.protocol === 'https:' && url.hostname === IMAGE_HOST;
134
+ }
135
+ catch {
136
+ return false;
137
+ }
138
+ }
139
+ /**
140
+ * Derive a resized/cropped CDN URL from a URL Pexels already returned.
141
+ *
142
+ * The Pexels image CDN honours `w`, `h` and `fit`, so an exact 1600x900 hero
143
+ * costs no API call and no bytes. Verified against the live CDN: `fit=crop`
144
+ * with both dimensions returns exactly that box.
145
+ */
146
+ export function deriveImageUrl(baseUrl, options) {
147
+ if (!isPexelsImageUrl(baseUrl))
148
+ return null;
149
+ const { width, height } = options;
150
+ if (width === undefined && height === undefined)
151
+ return null;
152
+ const url = new URL(baseUrl);
153
+ url.search = '';
154
+ url.searchParams.set('auto', 'compress');
155
+ url.searchParams.set('cs', 'tinysrgb');
156
+ if (width !== undefined)
157
+ url.searchParams.set('w', String(width));
158
+ if (height !== undefined)
159
+ url.searchParams.set('h', String(height));
160
+ const fit = options.fit ?? (width !== undefined && height !== undefined ? 'crop' : undefined);
161
+ if (fit !== undefined)
162
+ url.searchParams.set('fit', fit);
163
+ return url.toString();
164
+ }
165
+ /** Quirk #3: the single-video endpoint really is `/videos/videos/{id}`. */
166
+ export function videoByIdPath(id) {
167
+ return `/videos/videos/${id}`;
168
+ }
169
+ export function photoByIdPath(id) {
170
+ return `/v1/photos/${id}`;
171
+ }
172
+ export function collectionMediaPath(id) {
173
+ return `/v1/collections/${encodeURIComponent(id)}`;
174
+ }
175
+ const QUALITY_RANK = { uhd: 4, hd: 3, sd: 2 };
176
+ /** Brief mode shows the single best rendition; full mode shows them all. */
177
+ export function bestVideoFile(files) {
178
+ let best;
179
+ let bestScore = Number.NEGATIVE_INFINITY;
180
+ for (const file of files) {
181
+ const quality = QUALITY_RANK[(file.quality ?? '').toLowerCase()] ?? 1;
182
+ const score = (file.height ?? 0) * 10_000 + (file.width ?? 0) * 10 + quality;
183
+ if (score > bestScore) {
184
+ bestScore = score;
185
+ best = file;
186
+ }
187
+ }
188
+ return best;
189
+ }
190
+ /** Quirk #6: quota is reported in headers, not in the body. */
191
+ export const RATE_LIMIT_WARN_THRESHOLD = 20;
192
+ export function observeRateLimit(headers) {
193
+ const raw = headers.get('x-ratelimit-remaining');
194
+ if (raw === null)
195
+ return null;
196
+ const remaining = Number(raw);
197
+ if (!Number.isFinite(remaining))
198
+ return null;
199
+ if (remaining < RATE_LIMIT_WARN_THRESHOLD) {
200
+ log('warn', 'rate_limit_low', { remaining });
201
+ }
202
+ return remaining;
203
+ }
204
+ export const RETRY_AFTER_CAP_MS = 10_000;
205
+ export function retryAfterMs(header, now = Date.now) {
206
+ if (header === null || header.trim() === '')
207
+ return undefined;
208
+ const seconds = Number(header);
209
+ const delay = Number.isFinite(seconds)
210
+ ? Math.max(0, seconds * 1000)
211
+ : (() => {
212
+ const at = Date.parse(header);
213
+ return Number.isFinite(at) ? Math.max(0, at - now()) : undefined;
214
+ })();
215
+ if (delay === undefined)
216
+ return undefined;
217
+ return Math.min(delay, RETRY_AFTER_CAP_MS);
218
+ }
219
+ export const BACKOFF_BASE_MS = 500;
220
+ export const BACKOFF_CAP_MS = 8_000;
221
+ export function backoffMs(attempt) {
222
+ return Math.min(BACKOFF_BASE_MS * 2 ** attempt, BACKOFF_CAP_MS);
223
+ }
224
+ /** Quirk #8: error bodies are tiny; turn them into something actionable. */
225
+ function upstreamMessage(body) {
226
+ if (typeof body === 'string') {
227
+ const trimmed = body.trim();
228
+ return trimmed === '' ? undefined : trimmed.slice(0, 300);
229
+ }
230
+ if (body !== null && typeof body === 'object') {
231
+ const record = body;
232
+ for (const key of ['error', 'message', 'detail', 'code']) {
233
+ const value = record[key];
234
+ if (typeof value === 'string' && value.trim() !== '')
235
+ return value.trim();
236
+ if (value !== null && typeof value === 'object') {
237
+ const nested = value.message;
238
+ if (typeof nested === 'string' && nested.trim() !== '')
239
+ return nested.trim();
240
+ }
241
+ }
242
+ }
243
+ return undefined;
244
+ }
245
+ export function toToolError(status, body) {
246
+ const detail = upstreamMessage(body);
247
+ const suffix = detail === undefined ? '' : `: ${detail}`;
248
+ if (status === 401 || status === 403) {
249
+ return new ToolError('UNAUTHORIZED', `Pexels rejected the API key${suffix}`, {
250
+ status,
251
+ hint: 'check PEXELS_API_KEY or the "apiKey" field in ~/.config/pexels-mcp/config.json',
252
+ });
253
+ }
254
+ if (status === 404) {
255
+ return new ToolError('NOT_FOUND', `Pexels has no resource at that id${suffix}`, {
256
+ status,
257
+ hint: 'verify the id — take one from a search result or featured_collections first',
258
+ });
259
+ }
260
+ if (status === 429) {
261
+ return new ToolError('RATE_LIMITED', `Pexels rate limit reached${suffix}`, {
262
+ status,
263
+ hint: 'wait for the quota window to reset; identical queries are served from cache',
264
+ });
265
+ }
266
+ if (status >= 500) {
267
+ return new ToolError('UPSTREAM_UNAVAILABLE', `Pexels is unavailable (HTTP ${status})${suffix}`, {
268
+ status,
269
+ hint: 'retry in a moment — this is on Pexels, not on the request',
270
+ });
271
+ }
272
+ if (status === 400 || status === 422) {
273
+ return new ToolError('INVALID_INPUT', `Pexels rejected the request${suffix}`, {
274
+ status,
275
+ hint: 'check the filters: colour, size and orientation must be supported values',
276
+ });
277
+ }
278
+ return new ToolError('INTERNAL', `unexpected HTTP ${status} from Pexels${suffix}`, {
279
+ status,
280
+ hint: 'report this bug with the tool name and arguments',
281
+ });
282
+ }
283
+ //# sourceMappingURL=quirks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"quirks.js","sourceRoot":"","sources":["../../src/pexels/quirks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,134 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Schemas for raw Pexels payloads.
4
+ *
5
+ * Deliberately tolerant: `passthrough()` plus optional fields with defaults.
6
+ * Pexels adds fields over time; a new one must never break decoding. Only
7
+ * fields that the presenters actually use are required.
8
+ */
9
+ export const ApiPhoto = z
10
+ .object({
11
+ id: z.number().int(),
12
+ width: z.number().int(),
13
+ height: z.number().int(),
14
+ url: z.string(),
15
+ photographer: z.string().default(''),
16
+ photographer_url: z.string().default(''),
17
+ photographer_id: z.number().int().default(0),
18
+ avg_color: z.string().nullish(),
19
+ alt: z.string().nullish(),
20
+ liked: z.boolean().optional(),
21
+ src: z.record(z.string(), z.string()).default({}),
22
+ })
23
+ .passthrough();
24
+ export const ApiVideoFile = z
25
+ .object({
26
+ id: z.number().int().optional(),
27
+ quality: z.string().nullish(),
28
+ file_type: z.string().nullish(),
29
+ width: z.number().int().nullish(),
30
+ height: z.number().int().nullish(),
31
+ fps: z.number().nullish(),
32
+ /** File size in bytes — present on current Pexels payloads. */
33
+ size: z.number().nullish(),
34
+ link: z.string(),
35
+ })
36
+ .passthrough();
37
+ export const ApiVideoPicture = z
38
+ .object({
39
+ id: z.number().int().optional(),
40
+ nr: z.number().int().nullish(),
41
+ picture: z.string(),
42
+ })
43
+ .passthrough();
44
+ export const ApiVideo = z
45
+ .object({
46
+ id: z.number().int(),
47
+ width: z.number().int().default(0),
48
+ height: z.number().int().default(0),
49
+ duration: z.number().nullish(),
50
+ url: z.string().default(''),
51
+ image: z.string().default(''),
52
+ user: z
53
+ .object({
54
+ id: z.number().int().default(0),
55
+ name: z.string().default(''),
56
+ url: z.string().default(''),
57
+ })
58
+ .passthrough()
59
+ .optional(),
60
+ video_files: z.array(ApiVideoFile).default([]),
61
+ video_pictures: z.array(ApiVideoPicture).default([]),
62
+ tags: z.array(z.string()).optional(),
63
+ avg_color: z.string().nullish(),
64
+ })
65
+ .passthrough();
66
+ export const ApiPhotoList = z
67
+ .object({
68
+ page: z.number().int().optional(),
69
+ per_page: z.number().int().optional(),
70
+ total_results: z.number().int().optional(),
71
+ photos: z.array(ApiPhoto).default([]),
72
+ next_page: z.string().optional(),
73
+ prev_page: z.string().optional(),
74
+ })
75
+ .passthrough();
76
+ export const ApiVideoList = z
77
+ .object({
78
+ page: z.number().int().optional(),
79
+ per_page: z.number().int().optional(),
80
+ total_results: z.number().int().optional(),
81
+ videos: z.array(ApiVideo).default([]),
82
+ next_page: z.string().optional(),
83
+ prev_page: z.string().optional(),
84
+ })
85
+ .passthrough();
86
+ export const ApiCollection = z
87
+ .object({
88
+ id: z.union([z.string(), z.number()]),
89
+ title: z.string().nullish(),
90
+ description: z.string().nullish(),
91
+ private: z.boolean().default(false),
92
+ media_count: z.number().int().default(0),
93
+ photos_count: z.number().int().default(0),
94
+ videos_count: z.number().int().default(0),
95
+ })
96
+ .passthrough();
97
+ export const ApiCollectionList = z
98
+ .object({
99
+ page: z.number().int().optional(),
100
+ per_page: z.number().int().optional(),
101
+ total_results: z.number().int().optional(),
102
+ collections: z.array(ApiCollection).default([]),
103
+ next_page: z.string().optional(),
104
+ prev_page: z.string().optional(),
105
+ })
106
+ .passthrough();
107
+ /**
108
+ * Quirk #2: collection media tags arrive capitalised (`"type": "Photo"`).
109
+ * Normalise the tag before discriminating, and accept both spellings.
110
+ */
111
+ export const ApiCollectionMediaItem = z.preprocess((value) => {
112
+ if (value !== null && typeof value === 'object' && 'type' in value) {
113
+ const tag = value.type;
114
+ if (typeof tag === 'string') {
115
+ return { ...value, type: tag.trim().toLowerCase() };
116
+ }
117
+ }
118
+ return value;
119
+ }, z.discriminatedUnion('type', [
120
+ ApiPhoto.extend({ type: z.literal('photo') }),
121
+ ApiVideo.extend({ type: z.literal('video') }),
122
+ ]));
123
+ export const ApiCollectionMedia = z
124
+ .object({
125
+ id: z.union([z.string(), z.number()]).optional(),
126
+ page: z.number().int().optional(),
127
+ per_page: z.number().int().optional(),
128
+ total_results: z.number().int().optional(),
129
+ media: z.array(ApiCollectionMediaItem).default([]),
130
+ next_page: z.string().optional(),
131
+ prev_page: z.string().optional(),
132
+ })
133
+ .passthrough();
134
+ //# sourceMappingURL=schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/pexels/schemas.ts"],"names":[],"mappings":"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"}