@cesar-richard/git-connector-sdk 1.63.0 → 1.64.0

package/README.md

@@ -543,6 +543,28 @@ const client = createGitConnectorClient({
 });
 ```
 
+## Listing the labels of a project
+
+`GET /v1/projects/{source}/{projectKey}/labels` returns the live label set
+of a GitLab project or GitHub repository, including `scope` computed
+server-side for GitLab scoped labels (`<scope>::<value>`). Cached in-memory
+for 15 minutes (configurable via `LABELS_CACHE_TTL_MS`).
+
+```ts
+const { data, error } = await client.GET(
+  "/v1/projects/{source}/{projectKey}/labels",
+  { params: { path: { source: "gitlab", projectKey: "group/sub/project" } } },
+);
+if (error) throw error;
+for (const label of data.labels) {
+  console.log(label.scope ?? "(no scope)", label.name, label.color);
+}
+```
+
+The endpoint returns `404` when the project does not exist on the upstream
+provider, `403` when the configured provider token lacks access, and `502`
+on upstream unreachable (e.g. expired GitLab NSC cookie).
+
 ## Compatibility
 
 - Node ≥ 18 (uses global `fetch`).

package/dist/schema.d.ts

@@ -116,6 +116,22 @@ export interface paths {
         patch: operations["patchV1ProjectsBySourceByProjectKeyDelivery-rules"];
         trace?: never;
     };
+    "/v1/projects/{source}/{projectKey}/labels": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getV1ProjectsBySourceByProjectKeyLabels"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -623,6 +639,21 @@ export interface components {
                 matchEnd: string | number;
             } | null;
         };
+        ProjectLabel: {
+            name: string;
+            color: string;
+            description: string | null;
+            scope: string | null;
+        };
+        ProjectLabelsResponse: {
+            labels: {
+                name: string;
+                color: string;
+                description: string | null;
+                scope: string | null;
+            }[];
+            fetchedAt: string;
+        };
         Provider: "github" | "gitlab";
         ResolvedUser: {
             id: string;
@@ -2710,4 +2741,116 @@ export interface operations {
             };
         };
     };
+    getV1ProjectsBySourceByProjectKeyLabels: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                source: string;
+                projectKey: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        labels: {
+                            name: string;
+                            color: string;
+                            description: string | null;
+                            scope: string | null;
+                        }[];
+                        fetchedAt: string;
+                    };
+                    "multipart/form-data": {
+                        labels: {
+                            name: string;
+                            color: string;
+                            description: string | null;
+                            scope: string | null;
+                        }[];
+                        fetchedAt: string;
+                    };
+                    "text/plain": {
+                        labels: {
+                            name: string;
+                            color: string;
+                            description: string | null;
+                            scope: string | null;
+                        }[];
+                        fetchedAt: string;
+                    };
+                };
+            };
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                    "multipart/form-data": {
+                        error: string;
+                    };
+                    "text/plain": {
+                        error: string;
+                    };
+                };
+            };
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                    "multipart/form-data": {
+                        error: string;
+                    };
+                    "text/plain": {
+                        error: string;
+                    };
+                };
+            };
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                    "multipart/form-data": {
+                        error: string;
+                    };
+                    "text/plain": {
+                        error: string;
+                    };
+                };
+            };
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: string;
+                    };
+                    "multipart/form-data": {
+                        error: string;
+                    };
+                    "text/plain": {
+                        error: string;
+                    };
+                };
+            };
+        };
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cesar-richard/git-connector-sdk",
-  "version": "1.63.0",
+  "version": "1.64.0",
   "description": "TypeScript SDK for the git-connector v1 API (work items + iterations aggregated from GitHub/GitLab). Version published on npm tracks server releases.",
   "license": "MIT",
   "repository": {