@ankhorage/repository 0.4.18 → 0.5.0

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

@@ -0,0 +1,115 @@
+/*** Create the read-only GitHub gateway used to materialize repository snapshots over HTTPS. */
+export function createGitHubHttpRepositoryReadGateway(fetcher = fetch) {
+    return {
+        inspectRepositoryAsync: (target) => inspectRepositoryAsync(fetcher, target),
+        resolveRevisionAsync: (target, ref) => resolveRevisionAsync(fetcher, target, ref),
+        readTreeAsync: (target, treeSha) => readTreeAsync(fetcher, target, treeSha),
+        readFileAsync: (target, revision, path) => readFileAsync(fetcher, target, revision, path),
+    };
+}
+const API_ORIGIN = 'https://api.github.com';
+const RAW_ORIGIN = 'https://raw.githubusercontent.com';
+/*** Read repository metadata without mutating provider state. */
+async function inspectRepositoryAsync(fetcher, target) {
+    const value = await requestJsonAsync(fetcher, `${API_ORIGIN}/repos/${encodeURIComponent(target.owner)}/${encodeURIComponent(target.name)}`);
+    const record = requireRecord(value, 'repository metadata');
+    const defaultBranch = requireString(record.default_branch, 'repository default branch');
+    const url = typeof record.html_url === 'string' ? record.html_url : target.url;
+    return { defaultBranch, url };
+}
+/*** Resolve a branch, tag, or commit ref to an immutable commit and tree SHA. */
+async function resolveRevisionAsync(fetcher, target, ref) {
+    const value = await requestJsonAsync(fetcher, `${API_ORIGIN}/repos/${encodeURIComponent(target.owner)}/${encodeURIComponent(target.name)}/commits/${encodeURIComponent(ref)}`);
+    const record = requireRecord(value, 'repository revision');
+    const commit = requireRecord(record.commit, 'repository commit');
+    const tree = requireRecord(commit.tree, 'repository commit tree');
+    return {
+        commitSha: requireString(record.sha, 'repository commit SHA'),
+        treeSha: requireString(tree.sha, 'repository tree SHA'),
+    };
+}
+/*** Read the complete recursive tree for one immutable Git tree SHA. */
+async function readTreeAsync(fetcher, target, treeSha) {
+    const value = await requestJsonAsync(fetcher, `${API_ORIGIN}/repos/${encodeURIComponent(target.owner)}/${encodeURIComponent(target.name)}/git/trees/${encodeURIComponent(treeSha)}?recursive=1`);
+    const record = requireRecord(value, 'repository tree');
+    if (!Array.isArray(record.tree))
+        throw new Error('GitHub returned an invalid repository tree.');
+    return {
+        entries: record.tree.map((entry) => parseTreeEntry(entry)),
+        truncated: record.truncated === true,
+    };
+}
+/*** Read one file from an immutable GitHub revision without executing repository code. */
+async function readFileAsync(fetcher, target, revision, path) {
+    const encodedPath = path
+        .split('/')
+        .map((segment) => encodeURIComponent(segment))
+        .join('/');
+    const response = await fetcher(`${RAW_ORIGIN}/${encodeURIComponent(target.owner)}/${encodeURIComponent(target.name)}/${encodeURIComponent(revision)}/${encodedPath}`, { headers: requestHeaders(), signal: AbortSignal.timeout(30_000) });
+    if (!response.ok)
+        throw requestError(response, 'repository file');
+    return new Uint8Array(await response.arrayBuffer());
+}
+/*** Parse one Git tree item while rejecting malformed provider responses. */
+function parseTreeEntry(value) {
+    const record = requireRecord(value, 'repository tree entry');
+    const type = requireString(record.type, 'repository tree entry type');
+    if (type !== 'blob' && type !== 'tree' && type !== 'commit') {
+        throw new Error(`GitHub returned an unsupported repository tree entry type: ${type}.`);
+    }
+    const { size } = record;
+    if (size !== undefined && (typeof size !== 'number' || !Number.isSafeInteger(size) || size < 0)) {
+        throw new Error('GitHub returned an invalid repository tree entry size.');
+    }
+    return {
+        mode: requireString(record.mode, 'repository tree entry mode'),
+        path: requireString(record.path, 'repository tree entry path'),
+        sha: requireString(record.sha, 'repository tree entry SHA'),
+        type,
+        ...(size === undefined ? {} : { size }),
+    };
+}
+/*** Request GitHub JSON with stable safe errors and optional standard token authentication. */
+async function requestJsonAsync(fetcher, url) {
+    const response = await fetcher(url, {
+        headers: requestHeaders(),
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok)
+        throw requestError(response, 'repository metadata');
+    try {
+        return await response.json();
+    }
+    catch (error) {
+        throw new Error('GitHub returned malformed JSON.', { cause: error });
+    }
+}
+/*** Build GitHub request headers without exposing credentials to callers or errors. */
+function requestHeaders() {
+    const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+    return {
+        Accept: 'application/vnd.github+json',
+        'User-Agent': '@ankhorage/repository',
+        'X-GitHub-Api-Version': '2022-11-28',
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    };
+}
+/*** Convert one failed provider response into a credential-free diagnostic. */
+function requestError(response, subject) {
+    return new Error(`GitHub ${subject} request failed with HTTP ${response.status}.`);
+}
+/*** Narrow unknown JSON values to object records. */
+function requireRecord(value, subject) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new Error(`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 Error(`GitHub returned invalid ${subject}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=createGitHubHttpRepositoryReadGateway.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,80 @@
+import { expect, test } from 'bun:test';
+import { createGitHubHttpRepositoryReadGateway } from './createGitHubHttpRepositoryReadGateway.js';
+test('reads repository metadata, immutable revision, tree, and raw file content', async () => {
+    const urls = [];
+    const gateway = createGitHubHttpRepositoryReadGateway(createFetchFixture(urls));
+    const target = {
+        owner: 'ankhorage',
+        name: 'demo',
+        url: 'https://github.com/ankhorage/demo',
+    };
+    expect(await gateway.inspectRepositoryAsync(target)).toEqual({
+        defaultBranch: 'main',
+        url: 'https://github.com/ankhorage/demo',
+    });
+    expect(await gateway.resolveRevisionAsync(target, 'feature/read')).toEqual({
+        commitSha: 'commit-sha',
+        treeSha: 'tree-sha',
+    });
+    expect(await gateway.readTreeAsync(target, 'tree-sha')).toEqual({
+        entries: [
+            {
+                path: 'src/index.ts',
+                mode: '100644',
+                type: 'blob',
+                sha: 'blob-sha',
+                size: 10,
+            },
+        ],
+        truncated: false,
+    });
+    expect(Buffer.from(await gateway.readFileAsync(target, 'commit-sha', 'src/index.ts')).toString()).toBe('0123456789');
+    expect(urls).toContain('https://raw.githubusercontent.com/ankhorage/demo/commit-sha/src/index.ts');
+});
+function createFetchFixture(urls) {
+    return ((input) => {
+        const url = requestUrl(input);
+        urls.push(url);
+        return Promise.resolve(responseForUrl(url));
+    });
+}
+function requestUrl(input) {
+    if (typeof input === 'string')
+        return input;
+    if (input instanceof URL)
+        return input.href;
+    return input.url;
+}
+function responseForUrl(url) {
+    if (url.endsWith('/repos/ankhorage/demo')) {
+        return Response.json({
+            default_branch: 'main',
+            html_url: 'https://github.com/ankhorage/demo',
+        });
+    }
+    if (url.endsWith('/repos/ankhorage/demo/commits/feature%2Fread')) {
+        return Response.json({
+            sha: 'commit-sha',
+            commit: { tree: { sha: 'tree-sha' } },
+        });
+    }
+    if (url.endsWith('/repos/ankhorage/demo/git/trees/tree-sha?recursive=1')) {
+        return Response.json({
+            truncated: false,
+            tree: [
+                {
+                    path: 'src/index.ts',
+                    mode: '100644',
+                    type: 'blob',
+                    sha: 'blob-sha',
+                    size: 10,
+                },
+            ],
+        });
+    }
+    if (url.endsWith('/ankhorage/demo/commit-sha/src/index.ts')) {
+        return new Response('0123456789');
+    }
+    return new Response('', { status: 404 });
+}
+//# sourceMappingURL=createGitHubHttpRepositoryReadGateway.test.js.map

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

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

package/dist/providers/github/definitions/GitHubRepositoryConnectionOptions.d.ts

@@ -1,6 +1,3 @@
-import type { ProjectSnapshotReader } from '../../../connection/ports/ProjectSnapshotReader.js';
-import type { RepositoryManifestStore } from '../../../connection/ports/RepositoryManifestStore.js';
-import type { GitHubRepositoryGateway } from '../ports/GitHubRepositoryGateway.js';
 import type { GitHubRepositoryVisibility } from './GitHubRepositoryVisibility.js';
 export interface GitHubRepositoryConnectionOptions {
     readonly projectPath?: string;
@@ -8,9 +5,4 @@ export interface GitHubRepositoryConnectionOptions {
     readonly name?: string;
     readonly visibility?: GitHubRepositoryVisibility;
 }
-export interface GitHubRepositoryConnectionDependencies {
-    readonly gateway?: GitHubRepositoryGateway;
-    readonly snapshotReader?: ProjectSnapshotReader;
-    readonly manifestStore?: RepositoryManifestStore;
-}
 //# sourceMappingURL=GitHubRepositoryConnectionOptions.d.ts.map

package/dist/providers/github/definitions/GitHubRepositoryConnectionOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GitHubRepositoryConnectionOptions.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/definitions/GitHubRepositoryConnectionOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AACpG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC;CAClD;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAClD"}
+{"version":3,"file":"GitHubRepositoryConnectionOptions.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/definitions/GitHubRepositoryConnectionOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC;CAClD"}

package/dist/providers/github/definitions/GitHubRepositoryMaterializationOptions.d.ts

@@ -0,0 +1,6 @@
+export interface GitHubRepositoryMaterializationOptions {
+    readonly url: string;
+    readonly ref?: string;
+    readonly destinationPath?: string;
+}
+//# sourceMappingURL=GitHubRepositoryMaterializationOptions.d.ts.map

package/dist/providers/github/definitions/GitHubRepositoryMaterializationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubRepositoryMaterializationOptions.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/definitions/GitHubRepositoryMaterializationOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/dist/providers/github/definitions/GitHubRepositoryMaterializationOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GitHubRepositoryMaterializationOptions.js.map

package/dist/providers/github/definitions/GitHubRepositoryMaterializationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubRepositoryMaterializationOptions.js","sourceRoot":"","sources":["../../../../src/providers/github/definitions/GitHubRepositoryMaterializationOptions.ts"],"names":[],"mappings":""}

package/dist/providers/github/definitions/GitHubRepositoryMaterializationResult.d.ts

@@ -0,0 +1,12 @@
+export interface GitHubRepositoryMaterializationResult {
+    readonly rootPath: string;
+    readonly revision: string;
+    readonly repository: {
+        readonly owner: string;
+        readonly name: string;
+        readonly url: string;
+        readonly defaultBranch: string;
+    };
+    readonly cleanupAsync: () => Promise<void>;
+}
+//# sourceMappingURL=GitHubRepositoryMaterializationResult.d.ts.map

package/dist/providers/github/definitions/GitHubRepositoryMaterializationResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubRepositoryMaterializationResult.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/definitions/GitHubRepositoryMaterializationResult.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/dist/providers/github/definitions/GitHubRepositoryMaterializationResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GitHubRepositoryMaterializationResult.js.map

package/dist/providers/github/definitions/GitHubRepositoryMaterializationResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubRepositoryMaterializationResult.js","sourceRoot":"","sources":["../../../../src/providers/github/definitions/GitHubRepositoryMaterializationResult.ts"],"names":[],"mappings":""}

package/dist/providers/github/ports/GitHubRepositoryReadGateway.d.ts

@@ -0,0 +1,31 @@
+export interface GitHubRepositoryReadTarget {
+    readonly owner: string;
+    readonly name: string;
+    readonly url: string;
+}
+export interface GitHubRepositoryReadMetadata {
+    readonly defaultBranch: string;
+    readonly url: string;
+}
+export interface GitHubRepositoryRevision {
+    readonly commitSha: string;
+    readonly treeSha: string;
+}
+export interface GitHubRepositoryTreeEntry {
+    readonly mode: string;
+    readonly path: string;
+    readonly sha: string;
+    readonly size?: number;
+    readonly type: 'blob' | 'tree' | 'commit';
+}
+export interface GitHubRepositoryTree {
+    readonly entries: readonly GitHubRepositoryTreeEntry[];
+    readonly truncated: boolean;
+}
+export interface GitHubRepositoryReadGateway {
+    inspectRepositoryAsync(target: GitHubRepositoryReadTarget): Promise<GitHubRepositoryReadMetadata>;
+    resolveRevisionAsync(target: GitHubRepositoryReadTarget, ref: string): Promise<GitHubRepositoryRevision>;
+    readTreeAsync(target: GitHubRepositoryReadTarget, treeSha: string): Promise<GitHubRepositoryTree>;
+    readFileAsync(target: GitHubRepositoryReadTarget, revision: string, path: string): Promise<Uint8Array>;
+}
+//# sourceMappingURL=GitHubRepositoryReadGateway.d.ts.map

package/dist/providers/github/ports/GitHubRepositoryReadGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubRepositoryReadGateway.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/ports/GitHubRepositoryReadGateway.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAClG,oBAAoB,CAClB,MAAM,EAAE,0BAA0B,EAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,aAAa,CAAC,MAAM,EAAE,0BAA0B,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClG,aAAa,CACX,MAAM,EAAE,0BAA0B,EAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

package/dist/providers/github/ports/GitHubRepositoryReadGateway.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GitHubRepositoryReadGateway.js.map

package/dist/providers/github/ports/GitHubRepositoryReadGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubRepositoryReadGateway.js","sourceRoot":"","sources":["../../../../src/providers/github/ports/GitHubRepositoryReadGateway.ts"],"names":[],"mappings":""}

package/dist/providers/github/services/connectGitHubRepositoryAsync.d.ts

@@ -1,5 +1,14 @@
-import type { GitHubRepositoryConnectionDependencies, GitHubRepositoryConnectionOptions } from '../definitions/GitHubRepositoryConnectionOptions.js';
+import type { ProjectSnapshotReader } from '../../../connection/ports/ProjectSnapshotReader.js';
+import type { RepositoryManifestStore } from '../../../connection/ports/RepositoryManifestStore.js';
+import type { GitHubRepositoryConnectionOptions } from '../definitions/GitHubRepositoryConnectionOptions.js';
 import type { GitHubRepositoryConnectionResult } from '../definitions/GitHubRepositoryConnectionResult.js';
+import type { GitHubRepositoryGateway } from '../ports/GitHubRepositoryGateway.js';
+interface GitHubRepositoryConnectionDependencies {
+    readonly gateway?: GitHubRepositoryGateway;
+    readonly snapshotReader?: ProjectSnapshotReader;
+    readonly manifestStore?: RepositoryManifestStore;
+}
 /** Connect a standalone app to GitHub and publish its complete snapshot on `main`. */
 export declare function connectGitHubRepositoryAsync(options?: GitHubRepositoryConnectionOptions, dependencies?: GitHubRepositoryConnectionDependencies): Promise<GitHubRepositoryConnectionResult>;
+export {};
 //# sourceMappingURL=connectGitHubRepositoryAsync.d.ts.map

package/dist/providers/github/services/connectGitHubRepositoryAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectGitHubRepositoryAsync.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/services/connectGitHubRepositoryAsync.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,sCAAsC,EACtC,iCAAiC,EAClC,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAGV,gCAAgC,EACjC,MAAM,oDAAoD,CAAC;AAY5D,sFAAsF;AACtF,wBAAsB,4BAA4B,CAChD,OAAO,GAAE,iCAAsC,EAC/C,YAAY,GAAE,sCAA2C,GACxD,OAAO,CAAC,gCAAgC,CAAC,CA+B3C"}
+{"version":3,"file":"connectGitHubRepositoryAsync.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/services/connectGitHubRepositoryAsync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAEpG,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qDAAqD,CAAC;AAC7G,OAAO,KAAK,EAGV,gCAAgC,EACjC,MAAM,oDAAoD,CAAC;AAC5D,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,qCAAqC,CAAC;AAO7C,UAAU,sCAAsC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;CAClD;AAED,sFAAsF;AACtF,wBAAsB,4BAA4B,CAChD,OAAO,GAAE,iCAAsC,EAC/C,YAAY,GAAE,sCAA2C,GACxD,OAAO,CAAC,gCAAgC,CAAC,CA+B3C"}

package/dist/providers/github/services/connectGitHubRepositoryAsync.js.map

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

package/dist/providers/github/services/connectGitHubRepositoryAsync.test.js.map

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

package/dist/providers/github/services/materializeGitHubRepositoryAsync.d.ts

@@ -0,0 +1,5 @@
+import type { GitHubRepositoryMaterializationOptions } from '../definitions/GitHubRepositoryMaterializationOptions.js';
+import type { GitHubRepositoryMaterializationResult } from '../definitions/GitHubRepositoryMaterializationResult.js';
+/*** Materialize one GitHub repository URL into an isolated local filesystem snapshot. */
+export declare function materializeGitHubRepositoryAsync(options: GitHubRepositoryMaterializationOptions): Promise<GitHubRepositoryMaterializationResult>;
+//# sourceMappingURL=materializeGitHubRepositoryAsync.d.ts.map

package/dist/providers/github/services/materializeGitHubRepositoryAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeGitHubRepositoryAsync.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/services/materializeGitHubRepositoryAsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,0DAA0D,CAAC;AACvH,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,yDAAyD,CAAC;AAGrH,yFAAyF;AACzF,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,qCAAqC,CAAC,CAKhD"}

package/dist/providers/github/services/materializeGitHubRepositoryAsync.js

@@ -0,0 +1,7 @@
+import { createGitHubHttpRepositoryReadGateway } from '../adapters/createGitHubHttpRepositoryReadGateway.js';
+import { materializeGitHubRepositoryWithGatewayAsync } from './materializeGitHubRepositoryWithGatewayAsync.js';
+/*** Materialize one GitHub repository URL into an isolated local filesystem snapshot. */
+export async function materializeGitHubRepositoryAsync(options) {
+    return materializeGitHubRepositoryWithGatewayAsync(options, createGitHubHttpRepositoryReadGateway());
+}
+//# sourceMappingURL=materializeGitHubRepositoryAsync.js.map

package/dist/providers/github/services/materializeGitHubRepositoryAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeGitHubRepositoryAsync.js","sourceRoot":"","sources":["../../../../src/providers/github/services/materializeGitHubRepositoryAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,MAAM,sDAAsD,CAAC;AAG7G,OAAO,EAAE,2CAA2C,EAAE,MAAM,kDAAkD,CAAC;AAE/G,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,OAA+C;IAE/C,OAAO,2CAA2C,CAChD,OAAO,EACP,qCAAqC,EAAE,CACxC,CAAC;AACJ,CAAC"}

package/dist/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.d.ts

@@ -0,0 +1,6 @@
+import type { GitHubRepositoryMaterializationOptions } from '../definitions/GitHubRepositoryMaterializationOptions.js';
+import type { GitHubRepositoryMaterializationResult } from '../definitions/GitHubRepositoryMaterializationResult.js';
+import type { GitHubRepositoryReadGateway } from '../ports/GitHubRepositoryReadGateway.js';
+/*** Materialize a GitHub repository through an injected read gateway for deterministic testing. */
+export declare function materializeGitHubRepositoryWithGatewayAsync(options: GitHubRepositoryMaterializationOptions, gateway: GitHubRepositoryReadGateway): Promise<GitHubRepositoryMaterializationResult>;
+//# sourceMappingURL=materializeGitHubRepositoryWithGatewayAsync.d.ts.map

package/dist/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializeGitHubRepositoryWithGatewayAsync.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,0DAA0D,CAAC;AACvH,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,yDAAyD,CAAC;AACrH,OAAO,KAAK,EACV,2BAA2B,EAG5B,MAAM,yCAAyC,CAAC;AAEjD,mGAAmG;AACnG,wBAAsB,2CAA2C,CAC/D,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qCAAqC,CAAC,CA2BhD"}

package/dist/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.js

@@ -0,0 +1,156 @@
+import { chmod, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+/*** Materialize a GitHub repository through an injected read gateway for deterministic testing. */
+export async function materializeGitHubRepositoryWithGatewayAsync(options, gateway) {
+    const target = parseGitHubRepositoryUrl(options.url);
+    const repository = await gateway.inspectRepositoryAsync(target);
+    const ref = normalizeRef(options.ref) ?? repository.defaultBranch;
+    const revision = await gateway.resolveRevisionAsync(target, ref);
+    const tree = await gateway.readTreeAsync(target, revision.treeSha);
+    const files = validateTree(tree.entries, tree.truncated);
+    const rootPath = await createMaterializationRootAsync(options.destinationPath);
+    try {
+        await writeFileBatchesAsync(gateway, target, revision.commitSha, rootPath, files);
+    }
+    catch (error) {
+        await rm(rootPath, { force: true, recursive: true });
+        throw error;
+    }
+    return {
+        rootPath,
+        revision: revision.commitSha,
+        repository: {
+            owner: target.owner,
+            name: target.name,
+            url: repository.url,
+            defaultBranch: repository.defaultBranch,
+        },
+        cleanupAsync: () => rm(rootPath, { force: true, recursive: true }),
+    };
+}
+const MAX_FILE_COUNT = 20_000;
+const MAX_TOTAL_BYTES = 256 * 1024 * 1024;
+const WRITE_BATCH_SIZE = 8;
+/*** Parse the canonical GitHub repository URL accepted by repository materialization. */
+function parseGitHubRepositoryUrl(value) {
+    const url = parseRepositoryUrl(value);
+    assertGitHubRepositoryUrl(url);
+    const segments = url.pathname.split('/').filter(Boolean);
+    if (segments.length !== 2) {
+        throw new Error('Repository URL must use https://github.com/<owner>/<repository>.');
+    }
+    const owner = segments[0] ?? '';
+    const repositorySegment = segments[1] ?? '';
+    const name = repositorySegment.endsWith('.git')
+        ? repositorySegment.slice(0, -4)
+        : repositorySegment;
+    assertRepositoryIdentity(owner, name);
+    return { owner, name, url: `https://github.com/${owner}/${name}` };
+}
+/*** Parse a repository URL while preserving the original parsing failure as the cause. */
+function parseRepositoryUrl(value) {
+    try {
+        return new URL(value);
+    }
+    catch (error) {
+        throw new Error('Repository URL must be a valid GitHub HTTPS URL.', { cause: error });
+    }
+}
+/*** Reject non-GitHub origins, credentials, query strings, and fragments. */
+function assertGitHubRepositoryUrl(url) {
+    if (url.protocol !== 'https:' ||
+        url.hostname.toLowerCase() !== 'github.com' ||
+        url.username !== '' ||
+        url.password !== '' ||
+        url.search !== '' ||
+        url.hash !== '') {
+        throw new Error('Repository URL must use https://github.com/<owner>/<repository>.');
+    }
+}
+/*** Validate canonical GitHub owner and repository path segments. */
+function assertRepositoryIdentity(owner, name) {
+    if (!/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,98}[A-Za-z0-9])?$/u.test(owner)) {
+        throw new Error('GitHub repository owner is invalid.');
+    }
+    if (!/^[A-Za-z0-9._-]{1,100}$/u.test(name) || name === '.' || name === '..') {
+        throw new Error('GitHub repository name is invalid.');
+    }
+}
+/*** Normalize an optional requested ref while rejecting an explicitly empty value. */
+function normalizeRef(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.trim();
+    if (normalized === '')
+        throw new Error('GitHub repository ref must not be empty.');
+    return normalized;
+}
+/*** Reject incomplete or unexpectedly large remote trees before downloading source bytes. */
+function validateTree(entries, truncated) {
+    if (truncated) {
+        throw new Error('GitHub repository tree is truncated and cannot be materialized safely.');
+    }
+    const files = entries.filter((entry) => entry.type === 'blob');
+    if (files.length > MAX_FILE_COUNT) {
+        throw new Error(`GitHub repository exceeds the ${MAX_FILE_COUNT} file materialization limit.`);
+    }
+    if (files.some((entry) => entry.mode === '120000')) {
+        throw new Error('GitHub repository symbolic links are not supported by safe materialization.');
+    }
+    const totalBytes = files.reduce((sum, entry) => {
+        if (entry.size === undefined) {
+            throw new Error(`GitHub repository file size is missing for ${entry.path}.`);
+        }
+        return sum + entry.size;
+    }, 0);
+    if (totalBytes > MAX_TOTAL_BYTES) {
+        throw new Error('GitHub repository exceeds the 256 MiB materialization limit.');
+    }
+    return files;
+}
+/*** Create either an isolated temporary root or one explicitly requested empty destination. */
+async function createMaterializationRootAsync(destinationPath) {
+    if (destinationPath === undefined) {
+        return mkdtemp(join(tmpdir(), 'ankhorage-repository-'));
+    }
+    const rootPath = resolve(destinationPath);
+    await mkdir(dirname(rootPath), { recursive: true });
+    await mkdir(rootPath);
+    return rootPath;
+}
+/*** Download and write bounded groups so large repositories do not fan out unbounded requests. */
+async function writeFileBatchesAsync(gateway, target, revision, rootPath, entries) {
+    const batches = Array.from({ length: Math.ceil(entries.length / WRITE_BATCH_SIZE) }, (_, index) => entries.slice(index * WRITE_BATCH_SIZE, (index + 1) * WRITE_BATCH_SIZE));
+    for (const batch of batches) {
+        await Promise.all(batch.map((entry) => materializeFileAsync(gateway, target, revision, rootPath, entry)));
+    }
+}
+/*** Materialize one ordinary Git blob beneath the isolated root and preserve executable mode. */
+async function materializeFileAsync(gateway, target, revision, rootPath, entry) {
+    const destination = resolveMaterializationPath(rootPath, entry.path);
+    const content = await gateway.readFileAsync(target, revision, entry.path);
+    if (entry.size !== content.byteLength) {
+        throw new Error(`GitHub repository file size changed while reading ${entry.path}.`);
+    }
+    await mkdir(dirname(destination), { recursive: true });
+    await writeFile(destination, content);
+    if (entry.mode === '100755')
+        await chmod(destination, 0o755);
+}
+/*** Resolve one provider path while rejecting traversal outside the materialization root. */
+function resolveMaterializationPath(rootPath, repositoryPath) {
+    if (repositoryPath.trim() === '' ||
+        repositoryPath.includes('\\') ||
+        repositoryPath.startsWith('/') ||
+        repositoryPath.split('/').some((segment) => segment === '..' || segment === '')) {
+        throw new Error(`Unsafe GitHub repository path: ${repositoryPath}.`);
+    }
+    const destination = resolve(rootPath, ...repositoryPath.split('/'));
+    const child = relative(rootPath, destination);
+    if (child === '' || child === '..' || child.startsWith(`..${sep}`) || isAbsolute(child)) {
+        throw new Error(`Unsafe GitHub repository path: ${repositoryPath}.`);
+    }
+    return destination;
+}
+//# sourceMappingURL=materializeGitHubRepositoryWithGatewayAsync.js.map

package/dist/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.js.map

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

package/dist/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.test.d.ts

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

package/dist/providers/github/services/materializeGitHubRepositoryWithGatewayAsync.test.d.ts.map

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