@pierre/storage 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -398,6 +398,22 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         old_path?: string | null | undefined;
     }[];
 }>;
+declare const createBranchResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    target_branch: z.ZodString;
+    target_is_ephemeral: z.ZodBoolean;
+    commit_sha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    target_branch: string;
+    message: string;
+    target_is_ephemeral: boolean;
+    commit_sha?: string | null | undefined;
+}, {
+    target_branch: string;
+    message: string;
+    target_is_ephemeral: boolean;
+    commit_sha?: string | null | undefined;
+}>;
 type ListFilesResponseRaw = z.infer<typeof listFilesResponseSchema>;
 type RawBranchInfo$1 = z.infer<typeof branchInfoSchema>;
 type ListBranchesResponseRaw = z.infer<typeof listBranchesResponseSchema>;
@@ -407,6 +423,7 @@ type RawFileDiff$1 = z.infer<typeof diffFileRawSchema>;
 type RawFilteredFile$1 = z.infer<typeof filteredFileRawSchema>;
 type GetBranchDiffResponseRaw = z.infer<typeof branchDiffResponseSchema>;
 type GetCommitDiffResponseRaw = z.infer<typeof commitDiffResponseSchema>;
+type CreateBranchResponseRaw = z.infer<typeof createBranchResponseSchema>;
 
 /**
  * Type definitions for Pierre Git Storage SDK
@@ -431,14 +448,16 @@ interface GetRemoteURLOptions {
 interface Repo {
     id: string;
     getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+    getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getFileStream(options: GetFileOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
     listBranches(options?: ListBranchesOptions): Promise<ListBranchesResult>;
     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>;
 }
@@ -505,6 +524,19 @@ interface ListBranchesResult {
     nextCursor?: string;
     hasMore: boolean;
 }
+interface CreateBranchOptions extends GitStorageInvocationOptions {
+    baseBranch: string;
+    targetBranch: string;
+    baseIsEphemeral?: boolean;
+    targetIsEphemeral?: boolean;
+}
+type CreateBranchResponse = CreateBranchResponseRaw;
+interface CreateBranchResult {
+    message: string;
+    targetBranch: string;
+    targetIsEphemeral: boolean;
+    commitSha?: string;
+}
 interface ListCommitsOptions extends GitStorageInvocationOptions {
     branch?: string;
     cursor?: string;
@@ -860,4 +892,4 @@ declare class GitStorage {
 declare function createClient(options: GitStorageOptions): GitStorage;
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, type BaseRepo, type BlobLike, type BranchInfo, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateRepoOptions, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, GitStorage, type GitStorageOptions, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };
+export { ApiError, type BaseRepo, type BlobLike, type BranchInfo, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateRepoOptions, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, GitStorage, type GitStorageOptions, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };

package/dist/index.d.ts

@@ -398,6 +398,22 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         old_path?: string | null | undefined;
     }[];
 }>;
+declare const createBranchResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    target_branch: z.ZodString;
+    target_is_ephemeral: z.ZodBoolean;
+    commit_sha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    target_branch: string;
+    message: string;
+    target_is_ephemeral: boolean;
+    commit_sha?: string | null | undefined;
+}, {
+    target_branch: string;
+    message: string;
+    target_is_ephemeral: boolean;
+    commit_sha?: string | null | undefined;
+}>;
 type ListFilesResponseRaw = z.infer<typeof listFilesResponseSchema>;
 type RawBranchInfo$1 = z.infer<typeof branchInfoSchema>;
 type ListBranchesResponseRaw = z.infer<typeof listBranchesResponseSchema>;
@@ -407,6 +423,7 @@ type RawFileDiff$1 = z.infer<typeof diffFileRawSchema>;
 type RawFilteredFile$1 = z.infer<typeof filteredFileRawSchema>;
 type GetBranchDiffResponseRaw = z.infer<typeof branchDiffResponseSchema>;
 type GetCommitDiffResponseRaw = z.infer<typeof commitDiffResponseSchema>;
+type CreateBranchResponseRaw = z.infer<typeof createBranchResponseSchema>;
 
 /**
  * Type definitions for Pierre Git Storage SDK
@@ -431,14 +448,16 @@ interface GetRemoteURLOptions {
 interface Repo {
     id: string;
     getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+    getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getFileStream(options: GetFileOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
     listBranches(options?: ListBranchesOptions): Promise<ListBranchesResult>;
     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>;
 }
@@ -505,6 +524,19 @@ interface ListBranchesResult {
     nextCursor?: string;
     hasMore: boolean;
 }
+interface CreateBranchOptions extends GitStorageInvocationOptions {
+    baseBranch: string;
+    targetBranch: string;
+    baseIsEphemeral?: boolean;
+    targetIsEphemeral?: boolean;
+}
+type CreateBranchResponse = CreateBranchResponseRaw;
+interface CreateBranchResult {
+    message: string;
+    targetBranch: string;
+    targetIsEphemeral: boolean;
+    commitSha?: string;
+}
 interface ListCommitsOptions extends GitStorageInvocationOptions {
     branch?: string;
     cursor?: string;
@@ -860,4 +892,4 @@ declare class GitStorage {
 declare function createClient(options: GitStorageOptions): GitStorage;
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, type BaseRepo, type BlobLike, type BranchInfo, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateRepoOptions, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, GitStorage, type GitStorageOptions, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };
+export { ApiError, type BaseRepo, type BlobLike, type BranchInfo, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateRepoOptions, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, GitStorage, type GitStorageOptions, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };

package/dist/index.js

@@ -104,6 +104,12 @@ var commitDiffResponseSchema = z.object({
   files: z.array(diffFileRawSchema),
   filtered_files: z.array(filteredFileRawSchema)
 });
+var createBranchResponseSchema = z.object({
+  message: z.string(),
+  target_branch: z.string(),
+  target_is_ephemeral: z.boolean(),
+  commit_sha: z.string().nullable().optional()
+});
 var refUpdateResultSchema = z.object({
   branch: z.string(),
   old_sha: z.string(),
@@ -1485,6 +1491,14 @@ function transformCommitDiffResult(raw) {
     filteredFiles: raw.filtered_files.map(transformFilteredFile)
   };
 }
+function transformCreateBranchResult(raw) {
+  return {
+    message: raw.message,
+    targetBranch: raw.target_branch,
+    targetIsEphemeral: raw.target_is_ephemeral,
+    commitSha: raw.commit_sha ?? void 0
+  };
+}
 var RepoImpl = class {
   constructor(id, options, generateJWT) {
     this.id = id;
@@ -1503,6 +1517,13 @@ var RepoImpl = class {
     url.password = await this.generateJWT(this.id, urlOptions);
     return url.toString();
   }
+  async getEphemeralRemoteURL(urlOptions) {
+    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) {
     const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
     const jwt = await this.generateJWT(this.id, {
@@ -1620,7 +1641,7 @@ var RepoImpl = class {
     const raw = commitDiffResponseSchema.parse(await response.json());
     return transformCommitDiffResult(raw);
   }
-  async pullUpstream(options) {
+  async pullUpstream(options = {}) {
     const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
     const jwt = await this.generateJWT(this.id, {
       permissions: ["git:write"],
@@ -1636,6 +1657,34 @@ var RepoImpl = class {
     }
     return;
   }
+  async createBranch(options) {
+    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 = {
+      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) {
     const targetBranch = options?.targetBranch?.trim();
     if (!targetBranch) {