@pierre/storage 0.1.4 → 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;
 	}
 
@@ -364,9 +379,11 @@ function requiresDuplex(body: unknown): boolean {
 		return true;
 	}
 
-	const readableStreamCtor = (globalThis as {
-		ReadableStream?: new (...args: unknown[]) => unknown;
-	}).ReadableStream;
+	const readableStreamCtor = (
+		globalThis as {
+			ReadableStream?: new (...args: unknown[]) => unknown;
+		}
+	).ReadableStream;
 	if (readableStreamCtor && body instanceof readableStreamCtor) {
 		return true;
 	}
@@ -599,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;