@paragraphcms/client 1.0.0 → 1.2.0

package/README.md

@@ -291,8 +291,11 @@ await client.media.upload({
 
 ```ts
 client.members.list(query?, options?)
+client.members.get(memberId, options?)
 client.authors.list(query?, options?)
+client.authors.get(authorId, options?)
 client.reviewers.list(query?, options?)
+client.reviewers.get(reviewerId, options?)
 ```
 
 Supported `sort` fields:
@@ -301,7 +304,10 @@ Supported `sort` fields:
 - `email`
 - `created_at`
 
-`authors` and `reviewers` are aliases of the member listing endpoints exposed by the API.
+Notes:
+
+- `members.get()`, `authors.get()`, and `reviewers.get()` are SDK convenience lookups built on top of the paginated list endpoints because the HTTP API does not expose `/members/{id}`, `/authors/{id}`, or `/reviewers/{id}` endpoints.
+- `authors` and `reviewers` are aliases of the member listing endpoints exposed by the API.
 
 ### Statuses
 
@@ -358,10 +364,13 @@ Supported `sort` fields for `dataModels.list()`:
 
 ```ts
 client.locales.list(options?)
+client.locales.get(code, options?)
 client.locales.create(body, options?)
 client.locales.delete(code, options?)
 ```
 
+`locales.get()` is an SDK convenience lookup over `locales.list()` because the HTTP API exposes locale listing and deletion by code, but not a dedicated locale detail endpoint.
+
 ### AI
 
 ```ts

package/dist/client.d.ts

@@ -33,12 +33,15 @@ export declare class Client {
     };
     readonly members: {
         list: (query?: MemberListQuery, options?: RequestOptions) => Promise<ListResponse<Member>>;
+        get: (memberId: string, options?: RequestOptions) => Promise<Member>;
     };
     readonly authors: {
         list: (query?: MemberListQuery, options?: RequestOptions) => Promise<ListResponse<Member>>;
+        get: (authorId: string, options?: RequestOptions) => Promise<Member>;
     };
     readonly reviewers: {
         list: (query?: MemberListQuery, options?: RequestOptions) => Promise<ListResponse<Member>>;
+        get: (reviewerId: string, options?: RequestOptions) => Promise<Member>;
     };
     readonly statuses: {
         list: (query?: StatusListQuery, options?: RequestOptions) => Promise<ListResponse<Status>>;
@@ -65,6 +68,7 @@ export declare class Client {
     };
     readonly locales: {
         list: (options?: RequestOptions) => Promise<Locale[]>;
+        get: (code: string, options?: RequestOptions) => Promise<Locale>;
         create: (body: CreateLocaleRequest, options?: RequestOptions) => Promise<LocaleMutationResult>;
         delete: (code: string, options?: RequestOptions) => Promise<DeleteByCodeResult>;
     };
@@ -77,6 +81,9 @@ export declare class Client {
     getInfo(options?: RequestOptions): Promise<ApiInfo>;
     private requestData;
     private requestList;
+    private findListItem;
+    private findArrayItem;
+    private createLookupError;
     private requestJson;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -2,6 +2,17 @@ import { ParagraphApiError, ParagraphClientError, } from "./errors.js";
 import { RequestRateLimiter } from "./rate-limiter.js";
 const DEFAULT_BASE_URL = "https://api.paragraphcms.com/v1";
 const DEFAULT_REQUESTS_PER_SECOND = 5;
+const LOOKUP_PAGE_SIZE = 100;
+function resolveFetchImplementation(customFetch) {
+    const fetchImpl = customFetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new ParagraphClientError("No fetch implementation available. Pass `fetch` in the client options.");
+    }
+    if (fetchImpl === globalThis.fetch) {
+        return globalThis.fetch.bind(globalThis);
+    }
+    return fetchImpl;
+}
 function normalizeBaseUrl(baseUrl) {
     const trimmed = baseUrl.trim().replace(/\/+$/, "");
     if (!trimmed) {
@@ -286,18 +297,33 @@ export class Client {
             query,
             options,
         }),
+        get: (memberId, options) => this.findListItem("/members", (member) => member.id === memberId, options, {
+            code: "member_not_found",
+            message: "Member not found.",
+            details: { memberId },
+        }),
     };
     authors = {
         list: (query, options) => this.requestList("GET", "/authors", {
             query,
             options,
         }),
+        get: (authorId, options) => this.findListItem("/authors", (author) => author.id === authorId, options, {
+            code: "author_not_found",
+            message: "Author not found.",
+            details: { authorId },
+        }),
     };
     reviewers = {
         list: (query, options) => this.requestList("GET", "/reviewers", {
             query,
             options,
         }),
+        get: (reviewerId, options) => this.findListItem("/reviewers", (reviewer) => reviewer.id === reviewerId, options, {
+            code: "reviewer_not_found",
+            message: "Reviewer not found.",
+            details: { reviewerId },
+        }),
     };
     statuses = {
         list: (query, options) => this.requestList("GET", "/statuses", {
@@ -371,6 +397,11 @@ export class Client {
         list: (options) => this.requestData("GET", "/locales", {
             options,
         }),
+        get: (code, options) => this.findArrayItem("/locales", (locale) => locale.code === code, options, {
+            code: "locale_not_found",
+            message: "Locale not found.",
+            details: { code },
+        }),
         create: (body, options) => this.requestData("POST", "/locales", {
             body,
             options,
@@ -397,13 +428,9 @@ export class Client {
         if (!options.apiKey.trim()) {
             throw new ParagraphClientError("`apiKey` is required.");
         }
-        const fetchImpl = options.fetch ?? globalThis.fetch;
-        if (typeof fetchImpl !== "function") {
-            throw new ParagraphClientError("No fetch implementation available. Pass `fetch` in the client options.");
-        }
         this.apiKey = options.apiKey.trim();
         this.baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_BASE_URL);
-        this.fetchImpl = fetchImpl;
+        this.fetchImpl = resolveFetchImplementation(options.fetch);
         this.defaultHeaders = new Headers(options.headers);
         this.timeoutMs = options.timeoutMs;
         this.limiter = new RequestRateLimiter(options.maxRequestsPerSecond ?? DEFAULT_REQUESTS_PER_SECOND);
@@ -417,6 +444,58 @@ export class Client {
     requestList(method, path, config) {
         return this.requestJson(method, path, config);
     }
+    async findListItem(path, predicate, options, error) {
+        let page = 1;
+        while (true) {
+            const response = await this.requestList("GET", path, {
+                query: {
+                    page,
+                    limit: LOOKUP_PAGE_SIZE,
+                },
+                options,
+            });
+            const match = response.data.find(predicate);
+            if (match) {
+                return match;
+            }
+            if (!response.meta.has_next_page) {
+                break;
+            }
+            page += 1;
+        }
+        throw this.createLookupError("GET", path, {
+            query: {
+                page,
+                limit: LOOKUP_PAGE_SIZE,
+            },
+            code: error.code,
+            message: error.message,
+            details: error.details,
+        });
+    }
+    async findArrayItem(path, predicate, options, error) {
+        const items = await this.requestData("GET", path, {
+            options,
+        });
+        const match = items.find(predicate);
+        if (match) {
+            return match;
+        }
+        throw this.createLookupError("GET", path, {
+            code: error.code,
+            message: error.message,
+            details: error.details,
+        });
+    }
+    createLookupError(method, path, config) {
+        return new ParagraphApiError({
+            status: 404,
+            code: config.code,
+            message: config.message,
+            details: config.details,
+            request: createRequestDescriptor(method, buildUrl(this.baseUrl, path, config.query)),
+        });
+    }
     requestJson(method, path, config) {
         const url = buildUrl(this.baseUrl, path, config?.query);
         const request = createRequestDescriptor(method, url);
@@ -448,7 +527,8 @@ export class Client {
             }
             const requestSignal = createRequestSignal(config?.options?.signal, timeoutMs);
             try {
-                const response = await this.fetchImpl(url, {
+                const fetchImpl = this.fetchImpl;
+                const response = await fetchImpl(url, {
                     method,
                     headers,
                     body,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paragraphcms/client",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Official Paragraph CMS TypeScript client for the Paragraph CMS v1 API.",
   "license": "ISC",
   "author": "Paragraph CMS",