@cesar-richard/git-connector-sdk 1.29.0 → 1.30.0

package/README.md

@@ -140,7 +140,19 @@ for (const e of data.events) {
 
 Filters like `?author=cesar` (on `/v1/activities` and `/v1/work-items`) and `?user=cesar` (on `/v1/events`) match the login exactly (case-insensitive). They do NOT fuzzy-match display names. This is a deliberate design choice for auditable activity tracking.
 
-**Known limitation:** GitLab REST commits API doesn't expose the GL user login without a per-commit round-trip. Commits ingested via GL polling have `author: null` + `meta.commitAuthorName` set. Commits ingested via webhook (Push Hook) have `author: <pusher.username>` reliably.
+**GitLab resolver:** commits ingested via polling are resolved server-side by mapping `commit.author_email` → GL user login via the GitLab Users API. The result is cached (default TTL 90 days). If the email cannot be resolved (anonymous commit, email not associated with any GL user, private email on a self-hosted instance), `author` stays `null` and the git-config name lives in `meta.commitAuthorName`. Webhook-ingested GL commits use the pusher's username directly (no resolver needed).
+
+**Structured author access via `authorResolved`:** commit events also carry an `authorResolved` blob with `{login, name, email}` (each nullable) — a single typed accessor that aggregates everything we know about the author:
+
+```ts
+for (const e of data.events) {
+  if (e.type !== "commit") continue;
+  const { login, name, email } = e.authorResolved ?? {};
+  console.log(`${login ?? "anonymous"} (${name ?? "?"} <${email ?? "?"}>)`);
+}
+```
+
+Available on every commit event regardless of provider or ingestion path. `event.author` is always equal to `event.authorResolved?.login`.
 
 ---
 

package/dist/schema.d.ts

@@ -160,6 +160,11 @@ export interface components {
                 meta: {
                     [key: string]: unknown;
                 } | null;
+                authorResolved?: {
+                    login: string | null;
+                    name: string | null;
+                    email: string | null;
+                };
             }[];
             total: string | number;
             nextCursor: string | null;
@@ -180,6 +185,11 @@ export interface components {
             meta: {
                 [key: string]: unknown;
             } | null;
+            authorResolved?: {
+                login: string | null;
+                name: string | null;
+                email: string | null;
+            };
         };
         IterationWithCount: {
             id: string | number;
@@ -1286,6 +1296,11 @@ export interface operations {
                             meta: {
                                 [key: string]: unknown;
                             } | null;
+                            authorResolved?: {
+                                login: string | null;
+                                name: string | null;
+                                email: string | null;
+                            };
                         }[];
                         total: string | number;
                         nextCursor: string | null;
@@ -1307,6 +1322,11 @@ export interface operations {
                             meta: {
                                 [key: string]: unknown;
                             } | null;
+                            authorResolved?: {
+                                login: string | null;
+                                name: string | null;
+                                email: string | null;
+                            };
                         }[];
                         total: string | number;
                         nextCursor: string | null;
@@ -1328,6 +1348,11 @@ export interface operations {
                             meta: {
                                 [key: string]: unknown;
                             } | null;
+                            authorResolved?: {
+                                login: string | null;
+                                name: string | null;
+                                email: string | null;
+                            };
                         }[];
                         total: string | number;
                         nextCursor: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cesar-richard/git-connector-sdk",
-  "version": "1.29.0",
+  "version": "1.30.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": {