@pierre/storage 0.1.3 → 0.2.0

package/src/commit.ts

@@ -40,6 +40,8 @@ interface CommitMetadataPayload {
 	expected_head_sha?: string;
 	base_branch?: string;
 	commit_message: string;
+	ephemeral?: boolean;
+	ephemeral_base?: boolean;
 	author: {
 		name: string;
 		email: string;
@@ -72,6 +74,8 @@ type NormalizedCommitOptions = {
 	commitMessage: string;
 	expectedHeadSha?: string;
 	baseBranch?: string;
+	ephemeral?: boolean;
+	ephemeralBase?: boolean;
 	author: CommitSignature;
 	committer?: CommitSignature;
 	signal?: AbortSignal;
@@ -135,6 +139,10 @@ export class CommitBuilderImpl implements CommitBuilder {
 				this.options.baseBranch = trimmedBase;
 			}
 		}
+
+		if (this.options.ephemeralBase && !this.options.baseBranch) {
+			throw new Error('createCommit ephemeralBase requires baseBranch');
+		}
 	}
 
 	addFile(path: string, source: CommitFileSource, options?: CommitFileOptions): CommitBuilder {
@@ -246,6 +254,13 @@ export class CommitBuilderImpl implements CommitBuilder {
 			};
 		}
 
+		if (this.options.ephemeral) {
+			metadata.ephemeral = true;
+		}
+		if (this.options.ephemeralBase) {
+			metadata.ephemeral_base = true;
+		}
+
 		return metadata;
 	}
 
@@ -275,7 +290,7 @@ export class FetchCommitTransport implements CommitTransport {
 		const bodyIterable = buildMessageIterable(request.metadata, request.blobs);
 		const body = toRequestBody(bodyIterable);
 
-		const response = await fetch(this.url, {
+		const init: RequestInit = {
 			method: 'POST',
 			headers: {
 				Authorization: `Bearer ${request.authorization}`,
@@ -284,7 +299,13 @@ export class FetchCommitTransport implements CommitTransport {
 			},
 			body: body as any,
 			signal: request.signal,
-		});
+		};
+
+		if (requiresDuplex(body)) {
+			(init as RequestInit & { duplex: 'half' }).duplex = 'half';
+		}
+
+		const response = await fetch(this.url, init);
 
 		if (!response.ok) {
 			const { statusMessage, statusLabel, refUpdate } = await parseCommitPackError(response);
@@ -349,6 +370,27 @@ function buildMessageIterable(
 	};
 }
 
+function requiresDuplex(body: unknown): boolean {
+	if (!body || typeof body !== 'object') {
+		return false;
+	}
+
+	if (typeof (body as { [Symbol.asyncIterator]?: unknown })[Symbol.asyncIterator] === 'function') {
+		return true;
+	}
+
+	const readableStreamCtor = (
+		globalThis as {
+			ReadableStream?: new (...args: unknown[]) => unknown;
+		}
+	).ReadableStream;
+	if (readableStreamCtor && body instanceof readableStreamCtor) {
+		return true;
+	}
+
+	return false;
+}
+
 function buildCommitResult(ack: CommitPackAck): CommitResult {
 	const refUpdate = toRefUpdate(ack.result);
 	if (!ack.result.success) {
@@ -574,6 +616,8 @@ function normalizeCommitOptions(options: CreateCommitOptions): NormalizedCommitO
 		commitMessage: options.commitMessage,
 		expectedHeadSha: options.expectedHeadSha,
 		baseBranch: options.baseBranch,
+		ephemeral: options.ephemeral === true,
+		ephemeralBase: options.ephemeralBase === true,
 		author: options.author,
 		committer: options.committer,
 		signal: options.signal,

package/src/index.ts

@@ -357,6 +357,9 @@ class RepoImpl implements Repo {
 		if (options.ref) {
 			params.ref = options.ref;
 		}
+		if (typeof options.ephemeral === 'boolean') {
+			params.ephemeral = String(options.ephemeral);
+		}
 
 		// Return the raw fetch Response for streaming
 		return this.api.get({ path: 'repos/file', params }, jwt);
@@ -369,10 +372,17 @@ class RepoImpl implements Repo {
 			ttl,
 		});
 
-		const params: Record<string, string> | undefined = options?.ref
-			? { ref: options.ref }
-			: undefined;
-		const response = await this.api.get({ path: 'repos/files', params }, jwt);
+		const params: Record<string, string> = {};
+		if (options?.ref) {
+			params.ref = options.ref;
+		}
+		if (typeof options?.ephemeral === 'boolean') {
+			params.ephemeral = String(options.ephemeral);
+		}
+		const response = await this.api.get(
+			{ path: 'repos/files', params: Object.keys(params).length ? params : undefined },
+			jwt,
+		);
 
 		const raw = listFilesResponseSchema.parse(await response.json());
 		return { paths: raw.paths, ref: raw.ref };

package/src/types.ts

@@ -88,6 +88,7 @@ export interface CreateRepoOptions extends GitStorageInvocationOptions {
 export interface GetFileOptions extends GitStorageInvocationOptions {
 	path: string;
 	ref?: string;
+	ephemeral?: boolean;
 }
 
 export interface PullUpstreamOptions extends GitStorageInvocationOptions {
@@ -97,6 +98,7 @@ export interface PullUpstreamOptions extends GitStorageInvocationOptions {
 // List Files API types
 export interface ListFilesOptions extends GitStorageInvocationOptions {
 	ref?: string;
+	ephemeral?: boolean;
 }
 
 export type ListFilesResponse = ListFilesResponseRaw;
@@ -228,6 +230,8 @@ interface CreateCommitBaseOptions extends GitStorageInvocationOptions {
 	commitMessage: string;
 	expectedHeadSha?: string;
 	baseBranch?: string;
+	ephemeral?: boolean;
+	ephemeralBase?: boolean;
 	author: CommitSignature;
 	committer?: CommitSignature;
 	signal?: AbortSignal;