@ankhorage/repository 0.6.16 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/repository
 
+## 0.7.0
+
+### Minor Changes
+
+- e482ef6: Add a public GitHub owner and repository discovery API with normalized source parsing, complete pagination, rate-limit handling, retries, cancellation, and repository URL preselection.
+
 ## 0.6.16
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/repository
 
-![license: MIT](./paradox/badges/license.svg) ![npm: v0.6.16](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![paradox: warnings](./paradox/badges/docs.svg)
+![license: MIT](./paradox/badges/license.svg) ![npm: v0.7.0](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![paradox: warnings](./paradox/badges/docs.svg)
 
 Standalone repository capability for connecting and managing an app project's source repository.
 

package/dist/github/index.d.ts

@@ -1,8 +1,11 @@
 export type { GitHubRepositoryConnectionOptions } from '../providers/github/definitions/GitHubRepositoryConnectionOptions.js';
 export type { GitHubRepositoryConnectionFailure, GitHubRepositoryConnectionResult, GitHubRepositoryConnectionStatus, } from '../providers/github/definitions/GitHubRepositoryConnectionResult.js';
+export type { GitHubRepositoryAuthentication, GitHubRepositoryDiscoveryOptions, } from '../providers/github/definitions/GitHubRepositoryDiscoveryOptions.js';
+export { type GitHubOwnerType, GitHubRepositoryDiscoveryError, type GitHubRepositoryDiscoveryErrorCode, type GitHubRepositoryDiscoveryRepository, type GitHubRepositoryDiscoveryResult, } from '../providers/github/definitions/GitHubRepositoryDiscoveryResult.js';
 export type { GitHubRepositoryMaterializationOptions } from '../providers/github/definitions/GitHubRepositoryMaterializationOptions.js';
 export type { GitHubRepositoryMaterializationDiagnostic, GitHubRepositoryMaterializationResult, } from '../providers/github/definitions/GitHubRepositoryMaterializationResult.js';
 export type { GitHubRepositoryVisibility } from '../providers/github/definitions/GitHubRepositoryVisibility.js';
 export { connectGitHubRepositoryAsync } from '../providers/github/services/connectGitHubRepositoryAsync.js';
+export { discoverGitHubRepositoriesAsync } from '../providers/github/services/discoverGitHubRepositoriesAsync.js';
 export { materializeGitHubRepositoryAsync } from '../providers/github/services/materializeGitHubRepositoryAsync.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/github/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iCAAiC,EAAE,MAAM,sEAAsE,CAAC;AAC9H,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EAAE,sCAAsC,EAAE,MAAM,2EAA2E,CAAC;AACxI,YAAY,EACV,yCAAyC,EACzC,qCAAqC,GACtC,MAAM,0EAA0E,CAAC;AAClF,YAAY,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iCAAiC,EAAE,MAAM,sEAAsE,CAAC;AAC9H,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EACV,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EACL,KAAK,eAAe,EACpB,8BAA8B,EAC9B,KAAK,kCAAkC,EACvC,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,GACrC,MAAM,oEAAoE,CAAC;AAC5E,YAAY,EAAE,sCAAsC,EAAE,MAAM,2EAA2E,CAAC;AACxI,YAAY,EACV,yCAAyC,EACzC,qCAAqC,GACtC,MAAM,0EAA0E,CAAC;AAClF,YAAY,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC"}

package/dist/github/index.js

@@ -1,3 +1,5 @@
+export { GitHubRepositoryDiscoveryError, } from '../providers/github/definitions/GitHubRepositoryDiscoveryResult.js';
 export { connectGitHubRepositoryAsync } from '../providers/github/services/connectGitHubRepositoryAsync.js';
+export { discoverGitHubRepositoriesAsync } from '../providers/github/services/discoverGitHubRepositoriesAsync.js';
 export { materializeGitHubRepositoryAsync } from '../providers/github/services/materializeGitHubRepositoryAsync.js';
 //# sourceMappingURL=index.js.map

package/dist/github/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,8BAA8B,GAI/B,MAAM,oEAAoE,CAAC;AAO5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC"}

package/dist/providers/github/adapters/createGitHubHttpClient.d.ts

@@ -0,0 +1,17 @@
+import type { GitHubRepositoryAuthentication } from '../definitions/GitHubRepositoryDiscoveryOptions.js';
+export interface GitHubHttpClient {
+    requestBytesAsync(url: string, subject: string, signal?: AbortSignal): Promise<Uint8Array>;
+    requestJsonResponseAsync(url: string, subject: string, signal?: AbortSignal): Promise<{
+        readonly value: unknown;
+        readonly link: string | null;
+    }>;
+}
+export interface GitHubHttpClientOptions {
+    readonly authentication?: GitHubRepositoryAuthentication;
+    readonly now?: () => number;
+    readonly timeoutMilliseconds?: number;
+    readonly waitAsync?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+}
+/*** Create the canonical credential-safe GitHub HTTP client for repository provider adapters. */
+export declare function createGitHubHttpClient(fetcher?: typeof fetch, options?: GitHubHttpClientOptions): GitHubHttpClient;
+//# sourceMappingURL=createGitHubHttpClient.d.ts.map

package/dist/providers/github/adapters/createGitHubHttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGitHubHttpClient.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/adapters/createGitHubHttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AASzG,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3F,wBAAwB,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,8BAA8B,CAAC;IACzD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpF;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,OAAO,KAAa,EAC7B,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAkBlB"}

package/dist/providers/github/adapters/createGitHubHttpClient.js

@@ -0,0 +1,209 @@
+import { GitHubRepositoryDiscoveryError } from '../definitions/GitHubRepositoryDiscoveryResult.js';
+import { rateLimitResponseAsync } from './rateLimitResponseAsync.js';
+const REQUEST_TIMEOUT_MILLISECONDS = 30_000;
+const MAX_REQUEST_ATTEMPTS = 3;
+const MAX_RETRY_WAIT_MILLISECONDS = 60_000;
+const MAX_RETRY_DELAY_MILLISECONDS = 30_000;
+/*** Create the canonical credential-safe GitHub HTTP client for repository provider adapters. */
+export function createGitHubHttpClient(fetcher = fetch, options = {}) {
+    const configuration = {
+        authentication: options.authentication ?? 'environment',
+        now: options.now ?? Date.now,
+        timeoutMilliseconds: options.timeoutMilliseconds ?? REQUEST_TIMEOUT_MILLISECONDS,
+        waitAsync: options.waitAsync ?? waitForRetryAsync,
+    };
+    return {
+        requestBytesAsync: (url, subject, signal) => requestWithRetriesAsync(fetcher, configuration, url, subject, signal, (response) => response.arrayBuffer().then((value) => new Uint8Array(value))),
+        requestJsonResponseAsync: (url, subject, signal) => requestWithRetriesAsync(fetcher, configuration, url, subject, signal, async (response) => ({
+            value: await response.json(),
+            link: response.headers.get('link'),
+        })),
+    };
+}
+/*** Execute one GitHub request with bounded retry time and cancellation across all request phases. */
+async function requestWithRetriesAsync(fetcher, configuration, url, subject, signal, readResponseAsync) {
+    let waitedMilliseconds = 0;
+    for (let attempt = 0; attempt < MAX_REQUEST_ATTEMPTS; attempt += 1) {
+        throwIfAborted(signal);
+        const response = await fetchResponseAsync(fetcher, configuration, url, signal);
+        if (response.ok) {
+            try {
+                return await readResponseWithDeadlineAsync(readResponseAsync, response, configuration, signal);
+            }
+            catch (error) {
+                if (isInterruptionError(error))
+                    throw error;
+                throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub returned malformed data.');
+            }
+        }
+        const rateLimit = await rateLimitResponseAsync(response, configuration.now, (errorResponse) => readResponseWithDeadlineAsync(readGitHubErrorMessageAsync, errorResponse, configuration, signal));
+        const failure = requestError(response, subject, rateLimit);
+        const retryDelay = retryDelayMilliseconds(response, attempt, rateLimit);
+        const canRetry = attempt < MAX_REQUEST_ATTEMPTS - 1 &&
+            retryDelay !== undefined &&
+            waitedMilliseconds + retryDelay <= MAX_RETRY_WAIT_MILLISECONDS;
+        if (!canRetry)
+            throw failure;
+        await configuration.waitAsync(retryDelay, signal);
+        throwIfAborted(signal);
+        waitedMilliseconds += retryDelay;
+    }
+    throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub request retry limit was exceeded.');
+}
+/*** Read a response body under the same bounded cancellation contract as the network request. */
+async function readResponseWithDeadlineAsync(readResponseAsync, response, configuration, signal) {
+    const deadline = createDeadline(signal, configuration.timeoutMilliseconds);
+    try {
+        return await readWithCancellationAsync(readResponseAsync(response), deadline.signal);
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw cancelledError();
+        if (deadline.timedOut())
+            throw timeoutError();
+        throw error;
+    }
+    finally {
+        deadline.dispose();
+    }
+}
+/*** Fetch a GitHub response with a bounded deadline that remains distinguishable from caller cancellation. */
+async function fetchResponseAsync(fetcher, configuration, url, signal) {
+    const deadline = createDeadline(signal, configuration.timeoutMilliseconds);
+    try {
+        return await readWithCancellationAsync(fetcher(url, {
+            headers: requestHeaders(configuration.authentication),
+            signal: deadline.signal,
+        }), deadline.signal);
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw cancelledError();
+        if (deadline.timedOut())
+            throw timeoutError();
+        if (isInterruptionError(error))
+            throw error;
+        throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub request failed.');
+    }
+    finally {
+        deadline.dispose();
+    }
+}
+/*** Create a request-local signal and release its timer and caller listener after each request. */
+function createDeadline(signal, timeoutMilliseconds) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const abortFromCaller = () => controller.abort();
+    signal?.addEventListener('abort', abortFromCaller, { once: true });
+    if (signal?.aborted)
+        controller.abort();
+    const timeout = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+    }, timeoutMilliseconds);
+    return {
+        dispose: () => {
+            clearTimeout(timeout);
+            signal?.removeEventListener('abort', abortFromCaller);
+        },
+        signal: controller.signal,
+        timedOut: () => timedOut,
+    };
+}
+/*** Race a response operation against cancellation and always remove the temporary abort listener. */
+function readWithCancellationAsync(value, signal) {
+    if (!signal)
+        return value;
+    if (signal.aborted)
+        return Promise.reject(cancelledError());
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(cancelledError());
+        signal.addEventListener('abort', abort, { once: true });
+        value.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+    });
+}
+/*** Calculate a retry delay without replacing a provider-required rate-limit wait with backoff. */
+function retryDelayMilliseconds(response, attempt, rateLimit) {
+    if (rateLimit.isRateLimited)
+        return rateLimit.retryAfterMilliseconds;
+    if (response.status === 429 || response.status >= 500)
+        return Math.min(250 * 2 ** attempt, MAX_RETRY_DELAY_MILLISECONDS);
+    return undefined;
+}
+/*** Read only GitHub's structured error message and treat absent or malformed bodies as unknown. */
+async function readGitHubErrorMessageAsync(response) {
+    try {
+        const body = await response.json();
+        if (typeof body !== 'object' || body === null)
+            return undefined;
+        const message = Reflect.get(body, 'message');
+        return typeof message === 'string' ? message : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/*** Map provider failures to credential-free typed errors at the canonical adapter boundary. */
+function requestError(response, subject, rateLimit) {
+    if (rateLimit.isRateLimited) {
+        return new GitHubRepositoryDiscoveryError('rate-limited', 'GitHub rate limit reached. Retry after the reported delay.', rateLimit.retryAfterMilliseconds);
+    }
+    if (response.status === 404 && subject === 'owner') {
+        return new GitHubRepositoryDiscoveryError('owner-not-found', 'GitHub owner was not found.');
+    }
+    if (response.status === 401 || response.status === 403) {
+        return new GitHubRepositoryDiscoveryError('permission-denied', 'GitHub denied access to this resource.');
+    }
+    return new GitHubRepositoryDiscoveryError('api-failure', `GitHub ${subject} request failed with HTTP ${response.status}.`);
+}
+/*** Wait for a retry while promptly cancelling the timer and removing its listener in every outcome. */
+function waitForRetryAsync(milliseconds, signal) {
+    if (!signal)
+        return new Promise((resolve) => setTimeout(resolve, milliseconds));
+    if (signal.aborted)
+        return Promise.reject(cancelledError());
+    return new Promise((resolve, reject) => {
+        const done = () => signal.removeEventListener('abort', abort);
+        const abort = () => {
+            clearTimeout(timeout);
+            done();
+            reject(cancelledError());
+        };
+        const timeout = setTimeout(() => {
+            done();
+            resolve();
+        }, milliseconds);
+        signal.addEventListener('abort', abort, { once: true });
+    });
+}
+/*** Build GitHub request headers only when the caller explicitly selected environment authentication. */
+function requestHeaders(authentication) {
+    const token = authentication === 'environment'
+        ? (process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN)
+        : undefined;
+    return {
+        Accept: 'application/vnd.github+json',
+        'User-Agent': '@ankhorage/repository',
+        'X-GitHub-Api-Version': '2022-11-28',
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    };
+}
+/*** Identify a stable cancellation or timeout error created by this client. */
+function isInterruptionError(error) {
+    return (error instanceof GitHubRepositoryDiscoveryError &&
+        (error.code === 'cancelled' || error.code === 'timeout'));
+}
+/*** Construct the stable cancellation error returned from the GitHub adapter boundary. */
+function cancelledError() {
+    return new GitHubRepositoryDiscoveryError('cancelled', 'GitHub repository operation was cancelled.');
+}
+/*** Construct the stable timeout error without conflating it with an explicit caller cancellation. */
+function timeoutError() {
+    return new GitHubRepositoryDiscoveryError('timeout', 'GitHub request timed out.');
+}
+/*** Stop before starting an adapter request when cancellation has already been requested. */
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw cancelledError();
+}
+//# sourceMappingURL=createGitHubHttpClient.js.map

package/dist/providers/github/adapters/createGitHubHttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGitHubHttpClient.js","sourceRoot":"","sources":["../../../../src/providers/github/adapters/createGitHubHttpClient.ts"],"names":[],"mappings":"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"}

package/dist/providers/github/adapters/createGitHubHttpClient.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createGitHubHttpClient.test.d.ts.map

package/dist/providers/github/adapters/createGitHubHttpClient.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGitHubHttpClient.test.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/adapters/createGitHubHttpClient.test.ts"],"names":[],"mappings":""}

package/dist/providers/github/adapters/createGitHubHttpClient.test.js

@@ -0,0 +1,195 @@
+import { expect, test } from 'bun:test';
+import { createGitHubHttpClient } from './createGitHubHttpClient.js';
+test('omits inherited environment credentials for explicit anonymous requests', async () => {
+    const originalToken = process.env.GITHUB_TOKEN;
+    process.env.GITHUB_TOKEN = 'not-for-public-discovery';
+    const headers = [];
+    try {
+        const client = createGitHubHttpClient(((_input, init) => {
+            headers.push(new Headers(init?.headers));
+            return Promise.resolve(Response.json({ owner: 'public' }));
+        }), { authentication: 'anonymous' });
+        await client.requestJsonResponseAsync('https://api.github.com/users/ankhorage', 'owner');
+        expect(headers).toHaveLength(1);
+        expect(headers[0]?.has('authorization')).toBe(false);
+    }
+    finally {
+        if (originalToken === undefined)
+            delete process.env.GITHUB_TOKEN;
+        else
+            process.env.GITHUB_TOKEN = originalToken;
+    }
+});
+test('cancels an in-flight request through its combined fetch signal', () => {
+    const controller = new AbortController();
+    const client = createGitHubHttpClient(((_input, init) => new Promise((_resolve, reject) => {
+        init?.signal?.addEventListener('abort', () => reject(new DOMException('Aborted', 'AbortError')));
+    })));
+    const request = client.requestJsonResponseAsync('https://api.github.com/users/ankhorage', 'owner', controller.signal);
+    controller.abort();
+    expect(request).rejects.toMatchObject({ code: 'cancelled' });
+});
+test('keeps a permission denial with available primary quota distinct from rate limiting', async () => {
+    let calls = 0;
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(Response.json({ message: 'Resource not accessible by integration' }, {
+            status: 403,
+            headers: { 'x-ratelimit-remaining': '1', 'x-ratelimit-reset': '10' },
+        }));
+    }), { now: () => 10_000, waitAsync: () => Promise.resolve() });
+    expect(await requestFailureAsync(client)).toMatchObject({ code: 'permission-denied' });
+    expect(calls).toBe(1);
+});
+test('does not replace a provider-required rate-limit wait beyond the retry budget with backoff', async () => {
+    let calls = 0;
+    const waits = [];
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(new Response('', { status: 429, headers: { 'retry-after': '120' } }));
+    }), { waitAsync: (milliseconds) => (waits.push(milliseconds), Promise.resolve()) });
+    expect(await requestFailureAsync(client)).toMatchObject({
+        code: 'rate-limited',
+        retryAfterMilliseconds: 120_000,
+    });
+    expect(calls).toBe(1);
+    expect(waits).toEqual([]);
+});
+test('keeps an exhausted-primary reset deadline for HTTP 429 when it is later than Retry-After', async () => {
+    let calls = 0;
+    const waits = [];
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(new Response('', {
+            status: 429,
+            headers: {
+                'retry-after': '2',
+                'x-ratelimit-remaining': '0',
+                'x-ratelimit-reset': '121',
+            },
+        }));
+    }), {
+        now: () => 1_000,
+        waitAsync: (milliseconds) => (waits.push(milliseconds), Promise.resolve()),
+    });
+    expect(await requestFailureAsync(client)).toMatchObject({
+        code: 'rate-limited',
+        retryAfterMilliseconds: 120_000,
+    });
+    expect(calls).toBe(1);
+    expect(waits).toEqual([]);
+});
+test('keeps Retry-After for HTTP 429 when it is later than an exhausted-primary reset deadline', async () => {
+    let calls = 0;
+    const waits = [];
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(new Response('', {
+            status: 429,
+            headers: {
+                'retry-after': '120',
+                'x-ratelimit-remaining': '0',
+                'x-ratelimit-reset': '3',
+            },
+        }));
+    }), {
+        now: () => 1_000,
+        waitAsync: (milliseconds) => (waits.push(milliseconds), Promise.resolve()),
+    });
+    expect(await requestFailureAsync(client)).toMatchObject({
+        code: 'rate-limited',
+        retryAfterMilliseconds: 120_000,
+    });
+    expect(calls).toBe(1);
+    expect(waits).toEqual([]);
+});
+test('retries HTTP 429 after an exhausted-primary reset deadline when Retry-After is absent', async () => {
+    let calls = 0;
+    const waits = [];
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(calls === 1
+            ? new Response('', {
+                status: 429,
+                headers: { 'x-ratelimit-remaining': '0', 'x-ratelimit-reset': '3' },
+            })
+            : Response.json({ owner: 'public' }));
+    }), {
+        now: () => 1_000,
+        waitAsync: (milliseconds) => (waits.push(milliseconds), Promise.resolve()),
+    });
+    expect(await client.requestJsonResponseAsync('https://api.github.com/users/ankhorage', 'owner')).toEqual({ link: null, value: { owner: 'public' } });
+    expect(calls).toBe(2);
+    expect(waits).toEqual([2_000]);
+});
+test('identifies a secondary limit despite available primary quota and reset metadata', async () => {
+    let calls = 0;
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(Response.json({ message: 'You have exceeded a secondary rate limit. Please wait a few minutes.' }, {
+            status: 403,
+            headers: { 'x-ratelimit-remaining': '1', 'x-ratelimit-reset': '10' },
+        }));
+    }), { now: () => 10_000 });
+    expect(await requestFailureAsync(client)).toMatchObject({
+        code: 'rate-limited',
+        retryAfterMilliseconds: undefined,
+    });
+    expect(calls).toBe(1);
+});
+test('keeps a genuine GitHub permission denial distinct from a secondary rate limit', async () => {
+    let calls = 0;
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(Response.json({ message: 'Resource not accessible by integration' }, { status: 403 }));
+    }));
+    expect(await requestFailureAsync(client)).toMatchObject({ code: 'permission-denied' });
+    expect(calls).toBe(1);
+});
+test('uses a primary reset delay only after primary quota exhaustion', async () => {
+    let calls = 0;
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(new Response('', {
+            status: 403,
+            headers: { 'x-ratelimit-remaining': '0', 'x-ratelimit-reset': '121' },
+        }));
+    }), { now: () => 1_000, waitAsync: () => Promise.resolve() });
+    expect(await requestFailureAsync(client)).toMatchObject({
+        code: 'rate-limited',
+        retryAfterMilliseconds: 120_000,
+    });
+    expect(calls).toBe(1);
+});
+test('recognizes Retry-After as rate-limit evidence for HTTP 403', async () => {
+    let calls = 0;
+    const waits = [];
+    const client = createGitHubHttpClient(((_input) => {
+        calls += 1;
+        return Promise.resolve(calls === 1
+            ? new Response('', { status: 403, headers: { 'retry-after': '2' } })
+            : Response.json({ owner: 'public' }));
+    }), { waitAsync: (milliseconds) => (waits.push(milliseconds), Promise.resolve()) });
+    const response = await client.requestJsonResponseAsync('https://api.github.com/users/ankhorage', 'owner');
+    expect(response).toEqual({ link: null, value: { owner: 'public' } });
+    expect(calls).toBe(2);
+    expect(waits).toEqual([2_000]);
+});
+test('times out while GitHub response processing is still pending', () => {
+    const client = createGitHubHttpClient(((_input) => Promise.resolve({
+        headers: new Headers(),
+        json: () => new Promise(() => undefined),
+        ok: true,
+    })), { timeoutMilliseconds: 0 });
+    expect(client.requestJsonResponseAsync('https://api.github.com/users/ankhorage', 'owner')).rejects.toMatchObject({ code: 'timeout' });
+});
+async function requestFailureAsync(client) {
+    try {
+        await client.requestJsonResponseAsync('https://api.github.com/users/ankhorage', 'owner');
+        return undefined;
+    }
+    catch (error) {
+        return error;
+    }
+}
+//# sourceMappingURL=createGitHubHttpClient.test.js.map

package/dist/providers/github/adapters/createGitHubHttpClient.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGitHubHttpClient.test.js","sourceRoot":"","sources":["../../../../src/providers/github/adapters/createGitHubHttpClient.test.ts"],"names":[],"mappings":"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"}

package/dist/providers/github/adapters/createGitHubHttpRepositoryDiscoveryGateway.d.ts

@@ -0,0 +1,9 @@
+import type { GitHubRepositoryDiscoveryGateway } from '../ports/GitHubRepositoryDiscoveryGateway.js';
+type RequestJsonResponseAsync = (url: string, subject: string, signal: AbortSignal | undefined) => Promise<{
+    readonly value: unknown;
+    readonly link: string | null;
+}>;
+/** Create the discovery adapter from the shared GitHub HTTP requester. */
+export declare function createGitHubHttpRepositoryDiscoveryGateway(requestJsonResponseAsync: RequestJsonResponseAsync): GitHubRepositoryDiscoveryGateway;
+export {};
+//# sourceMappingURL=createGitHubHttpRepositoryDiscoveryGateway.d.ts.map

package/dist/providers/github/adapters/createGitHubHttpRepositoryDiscoveryGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGitHubHttpRepositoryDiscoveryGateway.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/adapters/createGitHubHttpRepositoryDiscoveryGateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,gCAAgC,EAEjC,MAAM,8CAA8C,CAAC;AAEtD,KAAK,wBAAwB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAAG,SAAS,KAC5B,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAIxE,0EAA0E;AAC1E,wBAAgB,0CAA0C,CACxD,wBAAwB,EAAE,wBAAwB,GACjD,gCAAgC,CAOlC"}

package/dist/providers/github/adapters/createGitHubHttpRepositoryDiscoveryGateway.js

@@ -0,0 +1,91 @@
+import { GitHubRepositoryDiscoveryError } from '../definitions/GitHubRepositoryDiscoveryResult.js';
+const API_ORIGIN = 'https://api.github.com';
+/** Create the discovery adapter from the shared GitHub HTTP requester. */
+export function createGitHubHttpRepositoryDiscoveryGateway(requestJsonResponseAsync) {
+    return {
+        resolveOwnerAsync: (owner, signal) => resolveOwnerAsync(requestJsonResponseAsync, owner, signal),
+        listOwnerRepositoriesAsync: (owner, signal) => listOwnerRepositoriesAsync(requestJsonResponseAsync, owner, signal),
+    };
+}
+/** Resolve a login through GitHub rather than inferring whether it names a user or organization. */
+async function resolveOwnerAsync(requestJsonResponseAsync, owner, signal) {
+    const { value } = await requestJsonResponseAsync(`${API_ORIGIN}/users/${encodeURIComponent(owner)}`, 'owner', signal);
+    const record = requireRecord(value, 'owner');
+    const type = requireString(record.type, 'owner type');
+    if (type !== 'User' && type !== 'Organization') {
+        throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub returned an unsupported owner type.');
+    }
+    return {
+        login: requireString(record.login, 'owner login'),
+        type: type === 'Organization' ? 'organization' : 'user',
+        url: requireString(record.html_url, 'owner URL'),
+    };
+}
+/** Read every page of repositories visible through GitHub's owner listing endpoints. */
+async function listOwnerRepositoriesAsync(requestJsonResponseAsync, owner, signal) {
+    const route = owner.type === 'organization' ? 'orgs' : 'users';
+    let nextUrl = `${API_ORIGIN}/${route}/${encodeURIComponent(owner.login)}/repos?per_page=100&type=all&sort=full_name&direction=asc`;
+    const repositories = new Map();
+    while (nextUrl !== undefined) {
+        const page = await requestJsonResponseAsync(nextUrl, 'repository list', signal);
+        if (!Array.isArray(page.value)) {
+            throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub returned an invalid repository list.');
+        }
+        for (const value of page.value) {
+            const repository = parseDiscoveredRepository(value);
+            repositories.set(repository.id, repository);
+        }
+        nextUrl = nextPageUrl(page.link);
+    }
+    return [...repositories.values()].sort(compareRepositories);
+}
+/** Parse one listed repository without exposing API-only response data to callers. */
+function parseDiscoveredRepository(value) {
+    const record = requireRecord(value, 'repository');
+    const { id } = record;
+    if (typeof id !== 'number' || !Number.isSafeInteger(id) || id < 1) {
+        throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub returned an invalid repository ID.');
+    }
+    const owner = requireRecord(record.owner, 'repository owner');
+    return {
+        id: String(id),
+        name: requireString(record.name, 'repository name'),
+        owner: requireString(owner.login, 'repository owner login'),
+        url: requireString(record.html_url, 'repository URL'),
+        visibility: record.private === true ? 'private' : 'public',
+    };
+}
+/** Select the next GitHub pagination target while rejecting an unexpected cross-origin link. */
+function nextPageUrl(link) {
+    if (!link)
+        return undefined;
+    const match = /<([^>]+)>;\s*rel="next"/u.exec(link);
+    if (!match?.[1])
+        return undefined;
+    const url = new URL(match[1]);
+    if (url.origin !== API_ORIGIN) {
+        throw new GitHubRepositoryDiscoveryError('api-failure', 'GitHub returned an invalid pagination URL.');
+    }
+    return url.href;
+}
+/** Sort repository identities independently of the provider's page ordering. */
+function compareRepositories(left, right) {
+    const leftIdentity = `${left.owner.toLowerCase()}/${left.name.toLowerCase()}`;
+    const rightIdentity = `${right.owner.toLowerCase()}/${right.name.toLowerCase()}`;
+    return leftIdentity < rightIdentity ? -1 : leftIdentity > rightIdentity ? 1 : 0;
+}
+/** Narrow unknown JSON values to object records. */
+function requireRecord(value, subject) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new GitHubRepositoryDiscoveryError('api-failure', `GitHub returned invalid ${subject}.`);
+    }
+    return Object.fromEntries(Object.entries(value));
+}
+/** Require a non-empty provider string field. */
+function requireString(value, subject) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new GitHubRepositoryDiscoveryError('api-failure', `GitHub returned invalid ${subject}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=createGitHubHttpRepositoryDiscoveryGateway.js.map