@pierre/storage 1.2.1 → 1.3.2

package/dist/index.d.cts

@@ -747,6 +747,7 @@ interface Repo {
     createdAt: string;
     getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+    getImportRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getFileStream(options: GetFileOptions): Promise<Response>;
     getArchiveStream(options?: ArchiveOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
@@ -785,7 +786,7 @@ interface RepoOptions {
     defaultBranch?: string;
     createdAt?: string;
 }
-type SupportedRepoProvider = 'github';
+type SupportedRepoProvider = 'github' | 'gitlab' | 'bitbucket' | 'gitea' | 'forgejo' | 'codeberg' | 'sr.ht';
 interface PublicGitHubBaseRepoAuth {
     /**
      * Force public GitHub mode (no GitHub App installation required).
@@ -796,18 +797,52 @@ interface GitHubBaseRepo {
     /**
      * @default github
      */
-    provider?: SupportedRepoProvider;
+    provider?: 'github';
     owner: string;
     name: string;
     defaultBranch?: string;
     auth?: PublicGitHubBaseRepoAuth;
 }
+interface GenericGitBaseRepo {
+    /**
+     * The git host provider. Must be one of the supported generic git providers.
+     */
+    provider: Exclude<SupportedRepoProvider, 'github'>;
+    owner: string;
+    name: string;
+    defaultBranch?: string;
+    /**
+     * Bare hostname for self-hosted instances (e.g. "gitlab.example.com").
+     * Falls back to the provider's default host when omitted.
+     */
+    upstreamHost?: string;
+}
 interface ForkBaseRepo {
     id: string;
     ref?: string;
     sha?: string;
 }
-type BaseRepo = GitHubBaseRepo | ForkBaseRepo;
+type BaseRepo = GitHubBaseRepo | ForkBaseRepo | GenericGitBaseRepo;
+interface CreateGitCredentialOptions {
+    repoId: string;
+    username?: string;
+    password: string;
+    ttl?: number;
+}
+interface UpdateGitCredentialOptions {
+    id: string;
+    username?: string;
+    password: string;
+    ttl?: number;
+}
+interface DeleteGitCredentialOptions {
+    id: string;
+    ttl?: number;
+}
+interface GitCredential {
+    id: string;
+    createdAt?: string;
+}
 interface ListReposOptions extends GitStorageInvocationOptions {
     cursor?: string;
     limit?: number;
@@ -1372,6 +1407,19 @@ declare class GitStorage {
      * @returns The deletion result
      */
     deleteRepo(options: DeleteRepoOptions): Promise<DeleteRepoResult>;
+    /**
+     * Create a generic git credential for a repository.
+     * Used to authenticate sync operations for non-GitHub providers (GitLab, Bitbucket, etc.)
+     */
+    createGitCredential(options: CreateGitCredentialOptions): Promise<GitCredential>;
+    /**
+     * Update an existing generic git credential.
+     */
+    updateGitCredential(options: UpdateGitCredentialOptions): Promise<GitCredential>;
+    /**
+     * Delete a generic git credential.
+     */
+    deleteGitCredential(options: DeleteGitCredentialOptions): Promise<void>;
     /**
      * Get the current configuration
      * @returns The client configuration
@@ -1387,4 +1435,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, type AppendNoteOptions, type ArchiveOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitMetadata, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FileWithMetadata, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListFilesWithMetadataOptions, type ListFilesWithMetadataResponse, type ListFilesWithMetadataResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PublicGitHubBaseRepoAuth, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawCommitMetadata, type RawFileDiff, type RawFileWithMetadata, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RepoOptions, 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 AppendNoteOptions, type ArchiveOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitMetadata, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateGitCredentialOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteGitCredentialOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FileWithMetadata, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GenericGitBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitCredential, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListFilesWithMetadataOptions, type ListFilesWithMetadataResponse, type ListFilesWithMetadataResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PublicGitHubBaseRepoAuth, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawCommitMetadata, type RawFileDiff, type RawFileWithMetadata, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RepoOptions, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type UpdateGitCredentialOptions, 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

@@ -747,6 +747,7 @@ interface Repo {
     createdAt: string;
     getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+    getImportRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getFileStream(options: GetFileOptions): Promise<Response>;
     getArchiveStream(options?: ArchiveOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
@@ -785,7 +786,7 @@ interface RepoOptions {
     defaultBranch?: string;
     createdAt?: string;
 }
-type SupportedRepoProvider = 'github';
+type SupportedRepoProvider = 'github' | 'gitlab' | 'bitbucket' | 'gitea' | 'forgejo' | 'codeberg' | 'sr.ht';
 interface PublicGitHubBaseRepoAuth {
     /**
      * Force public GitHub mode (no GitHub App installation required).
@@ -796,18 +797,52 @@ interface GitHubBaseRepo {
     /**
      * @default github
      */
-    provider?: SupportedRepoProvider;
+    provider?: 'github';
     owner: string;
     name: string;
     defaultBranch?: string;
     auth?: PublicGitHubBaseRepoAuth;
 }
+interface GenericGitBaseRepo {
+    /**
+     * The git host provider. Must be one of the supported generic git providers.
+     */
+    provider: Exclude<SupportedRepoProvider, 'github'>;
+    owner: string;
+    name: string;
+    defaultBranch?: string;
+    /**
+     * Bare hostname for self-hosted instances (e.g. "gitlab.example.com").
+     * Falls back to the provider's default host when omitted.
+     */
+    upstreamHost?: string;
+}
 interface ForkBaseRepo {
     id: string;
     ref?: string;
     sha?: string;
 }
-type BaseRepo = GitHubBaseRepo | ForkBaseRepo;
+type BaseRepo = GitHubBaseRepo | ForkBaseRepo | GenericGitBaseRepo;
+interface CreateGitCredentialOptions {
+    repoId: string;
+    username?: string;
+    password: string;
+    ttl?: number;
+}
+interface UpdateGitCredentialOptions {
+    id: string;
+    username?: string;
+    password: string;
+    ttl?: number;
+}
+interface DeleteGitCredentialOptions {
+    id: string;
+    ttl?: number;
+}
+interface GitCredential {
+    id: string;
+    createdAt?: string;
+}
 interface ListReposOptions extends GitStorageInvocationOptions {
     cursor?: string;
     limit?: number;
@@ -1372,6 +1407,19 @@ declare class GitStorage {
      * @returns The deletion result
      */
     deleteRepo(options: DeleteRepoOptions): Promise<DeleteRepoResult>;
+    /**
+     * Create a generic git credential for a repository.
+     * Used to authenticate sync operations for non-GitHub providers (GitLab, Bitbucket, etc.)
+     */
+    createGitCredential(options: CreateGitCredentialOptions): Promise<GitCredential>;
+    /**
+     * Update an existing generic git credential.
+     */
+    updateGitCredential(options: UpdateGitCredentialOptions): Promise<GitCredential>;
+    /**
+     * Delete a generic git credential.
+     */
+    deleteGitCredential(options: DeleteGitCredentialOptions): Promise<void>;
     /**
      * Get the current configuration
      * @returns The client configuration
@@ -1387,4 +1435,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, type AppendNoteOptions, type ArchiveOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitMetadata, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FileWithMetadata, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListFilesWithMetadataOptions, type ListFilesWithMetadataResponse, type ListFilesWithMetadataResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PublicGitHubBaseRepoAuth, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawCommitMetadata, type RawFileDiff, type RawFileWithMetadata, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RepoOptions, 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 AppendNoteOptions, type ArchiveOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitMetadata, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateGitCredentialOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteGitCredentialOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FileWithMetadata, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GenericGitBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitCredential, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListFilesWithMetadataOptions, type ListFilesWithMetadataResponse, type ListFilesWithMetadataResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PublicGitHubBaseRepoAuth, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawCommitMetadata, type RawFileDiff, type RawFileWithMetadata, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RepoOptions, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type UpdateGitCredentialOptions, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };

package/dist/index.js

@@ -524,7 +524,7 @@ function concatChunks(a, b) {
 
 // package.json
 var package_default = {
-  version: "1.2.1"};
+  version: "1.3.2"};
 
 // src/version.ts
 var PACKAGE_NAME = "code-storage-sdk";
@@ -1819,6 +1819,14 @@ var RepoImpl = class {
     url.password = await this.generateJWT(this.id, urlOptions);
     return url.toString();
   }
+  async getImportRemoteURL(urlOptions) {
+    const url = new URL(
+      `https://${this.options.storageBaseUrl}/${this.id}+import.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, {
@@ -2452,11 +2460,15 @@ var GitStorage = class _GitStorage {
           ...baseRepo.sha ? { sha: baseRepo.sha } : {}
         };
       } else {
+        const syncRepo = baseRepo;
+        const { provider: _p, ...restSnakecased } = snakecaseKeys(
+          baseRepo
+        );
         baseRepoOptions = {
-          provider: "github",
-          ...snakecaseKeys(baseRepo)
+          provider: syncRepo.provider ?? "github",
+          ...restSnakecased
         };
-        resolvedDefaultBranch = baseRepo.defaultBranch;
+        resolvedDefaultBranch = syncRepo.defaultBranch;
       }
     }
     if (!resolvedDefaultBranch) {
@@ -2578,6 +2590,82 @@ var GitStorage = class _GitStorage {
       message: body.message
     };
   }
+  /**
+   * Create a generic git credential for a repository.
+   * Used to authenticate sync operations for non-GitHub providers (GitLab, Bitbucket, etc.)
+   */
+  async createGitCredential(options) {
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(options.repoId, {
+      permissions: ["repo:write"],
+      ttl
+    });
+    const body = {
+      repo_id: options.repoId,
+      password: options.password
+    };
+    if (options.username !== void 0) {
+      body.username = options.username;
+    }
+    const resp = await this.api.post(
+      { path: "repos/git-credentials", body },
+      jwt,
+      { allowedStatus: [409] }
+    );
+    if (resp.status === 409) {
+      throw new Error("A credential already exists for this repository");
+    }
+    const data = await resp.json();
+    return { id: data.id };
+  }
+  /**
+   * Update an existing generic git credential.
+   */
+  async updateGitCredential(options) {
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT("org", {
+      permissions: ["repo:write"],
+      ttl
+    });
+    const body = {
+      id: options.id,
+      password: options.password
+    };
+    if (options.username !== void 0) {
+      body.username = options.username;
+    }
+    const resp = await this.api.put(
+      { path: "repos/git-credentials", body },
+      jwt,
+      { allowedStatus: [404] }
+    );
+    if (resp.status === 404) {
+      throw new Error("Credential not found");
+    }
+    const data = await resp.json();
+    return {
+      id: data.id,
+      ...data.created_at ? { createdAt: data.created_at } : {}
+    };
+  }
+  /**
+   * Delete a generic git credential.
+   */
+  async deleteGitCredential(options) {
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT("org", {
+      permissions: ["repo:write"],
+      ttl
+    });
+    const resp = await this.api.delete(
+      { path: "repos/git-credentials", body: { id: options.id } },
+      jwt,
+      { allowedStatus: [404] }
+    );
+    if (resp.status === 404) {
+      throw new Error("Credential not found");
+    }
+  }
   /**
    * Get the current configuration
    * @returns The client configuration