@pierre/storage 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pierre/storage",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Pierre Git Storage SDK",
   "license": "MIT",
   "type": "module",

package/src/index.ts

@@ -14,6 +14,7 @@ import type { RestoreCommitAckRaw } from './schemas';
 import {
 	branchDiffResponseSchema,
 	commitDiffResponseSchema,
+	createBranchResponseSchema,
 	listBranchesResponseSchema,
 	listCommitsResponseSchema,
 	listFilesResponseSchema,
@@ -25,6 +26,9 @@ import type {
 	CommitBuilder,
 	CommitInfo,
 	CommitResult,
+	CreateBranchOptions,
+	CreateBranchResponse,
+	CreateBranchResult,
 	CreateCommitFromDiffOptions,
 	CreateCommitOptions,
 	CreateRepoOptions,
@@ -318,6 +322,15 @@ function transformCommitDiffResult(raw: GetCommitDiffResponse): GetCommitDiffRes
 	};
 }
 
+function transformCreateBranchResult(raw: CreateBranchResponse): CreateBranchResult {
+	return {
+		message: raw.message,
+		targetBranch: raw.target_branch,
+		targetIsEphemeral: raw.target_is_ephemeral,
+		commitSha: raw.commit_sha ?? undefined,
+	};
+}
+
 /**
  * Implementation of the Repo interface
  */
@@ -346,6 +359,14 @@ class RepoImpl implements Repo {
 		return url.toString();
 	}
 
+	async getEphemeralRemoteURL(urlOptions?: GetRemoteURLOptions): Promise<string> {
+		const storageBaseUrl = this.options.storageBaseUrl ?? STORAGE_BASE_URL;
+		const url = new URL(`https://${this.options.name}.${storageBaseUrl}/${this.id}+ephemeral.git`);
+		url.username = `t`;
+		url.password = await this.generateJWT(this.id, urlOptions);
+		return url.toString();
+	}
+
 	async getFileStream(options: GetFileOptions): Promise<Response> {
 		const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
 		const jwt = await this.generateJWT(this.id, {
@@ -491,7 +512,7 @@ class RepoImpl implements Repo {
 		return transformCommitDiffResult(raw);
 	}
 
-	async pullUpstream(options: PullUpstreamOptions): Promise<void> {
+	async pullUpstream(options: PullUpstreamOptions = {}): Promise<void> {
 		const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
 		const jwt = await this.generateJWT(this.id, {
 			permissions: ['git:write'],
@@ -513,6 +534,39 @@ class RepoImpl implements Repo {
 		return;
 	}
 
+	async createBranch(options: CreateBranchOptions): Promise<CreateBranchResult> {
+		const baseBranch = options?.baseBranch?.trim();
+		if (!baseBranch) {
+			throw new Error('createBranch baseBranch is required');
+		}
+		const targetBranch = options?.targetBranch?.trim();
+		if (!targetBranch) {
+			throw new Error('createBranch targetBranch is required');
+		}
+
+		const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+		const jwt = await this.generateJWT(this.id, {
+			permissions: ['git:write'],
+			ttl,
+		});
+
+		const body: Record<string, unknown> = {
+			base_branch: baseBranch,
+			target_branch: targetBranch,
+		};
+
+		if (options.baseIsEphemeral === true) {
+			body.base_is_ephemeral = true;
+		}
+		if (options.targetIsEphemeral === true) {
+			body.target_is_ephemeral = true;
+		}
+
+		const response = await this.api.post({ path: 'repos/branches/create', body }, jwt);
+		const raw = createBranchResponseSchema.parse(await response.json());
+		return transformCreateBranchResult(raw);
+	}
+
 	async restoreCommit(options: RestoreCommitOptions): Promise<RestoreCommitResult> {
 		const targetBranch = options?.targetBranch?.trim();
 		if (!targetBranch) {

package/src/schemas.ts

@@ -73,6 +73,13 @@ export const commitDiffResponseSchema = z.object({
 	filtered_files: z.array(filteredFileRawSchema),
 });
 
+export const createBranchResponseSchema = z.object({
+	message: z.string(),
+	target_branch: z.string(),
+	target_is_ephemeral: z.boolean(),
+	commit_sha: z.string().nullable().optional(),
+});
+
 export const refUpdateResultSchema = z.object({
 	branch: z.string(),
 	old_sha: z.string(),
@@ -134,5 +141,6 @@ export type RawFileDiff = z.infer<typeof diffFileRawSchema>;
 export type RawFilteredFile = z.infer<typeof filteredFileRawSchema>;
 export type GetBranchDiffResponseRaw = z.infer<typeof branchDiffResponseSchema>;
 export type GetCommitDiffResponseRaw = z.infer<typeof commitDiffResponseSchema>;
+export type CreateBranchResponseRaw = z.infer<typeof createBranchResponseSchema>;
 export type CommitPackAckRaw = z.infer<typeof commitPackAckSchema>;
 export type RestoreCommitAckRaw = z.infer<typeof restoreCommitAckSchema>;

package/src/types.ts

@@ -3,6 +3,7 @@
  */
 
 import type {
+	CreateBranchResponseRaw,
 	GetBranchDiffResponseRaw,
 	GetCommitDiffResponseRaw,
 	ListBranchesResponseRaw,
@@ -37,6 +38,7 @@ export interface GetRemoteURLOptions {
 export interface Repo {
 	id: string;
 	getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+	getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
 
 	getFileStream(options: GetFileOptions): Promise<Response>;
 	listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
@@ -44,8 +46,9 @@ export interface Repo {
 	listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
 	getBranchDiff(options: GetBranchDiffOptions): Promise<GetBranchDiffResult>;
 	getCommitDiff(options: GetCommitDiffOptions): Promise<GetCommitDiffResult>;
-	pullUpstream(options: PullUpstreamOptions): Promise<void>;
+	pullUpstream(options?: PullUpstreamOptions): Promise<void>;
 	restoreCommit(options: RestoreCommitOptions): Promise<RestoreCommitResult>;
+	createBranch(options: CreateBranchOptions): Promise<CreateBranchResult>;
 	createCommit(options: CreateCommitOptions): CommitBuilder;
 	createCommitFromDiff(options: CreateCommitFromDiffOptions): Promise<CommitResult>;
 }
@@ -132,6 +135,23 @@ export interface ListBranchesResult {
 	hasMore: boolean;
 }
 
+// Create Branch API types
+export interface CreateBranchOptions extends GitStorageInvocationOptions {
+	baseBranch: string;
+	targetBranch: string;
+	baseIsEphemeral?: boolean;
+	targetIsEphemeral?: boolean;
+}
+
+export type CreateBranchResponse = CreateBranchResponseRaw;
+
+export interface CreateBranchResult {
+	message: string;
+	targetBranch: string;
+	targetIsEphemeral: boolean;
+	commitSha?: string;
+}
+
 // List Commits API types
 export interface ListCommitsOptions extends GitStorageInvocationOptions {
 	branch?: string;