@pierre/storage 0.2.2 → 0.3.0

package/dist/index.d.cts

@@ -448,6 +448,7 @@ 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>;
@@ -493,6 +494,7 @@ interface GetFileOptions extends GitStorageInvocationOptions {
     path: string;
     ref?: string;
     ephemeral?: boolean;
+    ephemeralBase?: boolean;
 }
 interface PullUpstreamOptions extends GitStorageInvocationOptions {
     ref?: string;
@@ -561,6 +563,8 @@ interface ListCommitsResult {
 interface GetBranchDiffOptions extends GitStorageInvocationOptions {
     branch: string;
     base?: string;
+    ephemeral?: boolean;
+    ephemeralBase?: boolean;
 }
 type GetBranchDiffResponse = GetBranchDiffResponseRaw;
 interface GetBranchDiffResult {
@@ -572,6 +576,7 @@ interface GetBranchDiffResult {
 }
 interface GetCommitDiffOptions extends GitStorageInvocationOptions {
     sha: string;
+    baseSha?: string;
 }
 type GetCommitDiffResponse = GetCommitDiffResponseRaw;
 interface GetCommitDiffResult {
@@ -861,11 +866,11 @@ declare function validateWebhook(payload: string | Buffer, headers: Record<strin
  */
 
 declare class GitStorage {
-    private static overrides;
     private options;
     private api;
     constructor(options: GitStorageOptions);
-    static override(options: OverrideableGitStorageOptions): void;
+    static getDefaultAPIBaseUrl(name: string): string;
+    static getDefaultStorageBaseUrl(name: string): string;
     /**
      * Create a new repository
      * @returns The created repository
@@ -889,6 +894,7 @@ declare class GitStorage {
     private generateJWT;
 }
 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 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 };
+export { ApiError, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, 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

@@ -448,6 +448,7 @@ 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>;
@@ -493,6 +494,7 @@ interface GetFileOptions extends GitStorageInvocationOptions {
     path: string;
     ref?: string;
     ephemeral?: boolean;
+    ephemeralBase?: boolean;
 }
 interface PullUpstreamOptions extends GitStorageInvocationOptions {
     ref?: string;
@@ -561,6 +563,8 @@ interface ListCommitsResult {
 interface GetBranchDiffOptions extends GitStorageInvocationOptions {
     branch: string;
     base?: string;
+    ephemeral?: boolean;
+    ephemeralBase?: boolean;
 }
 type GetBranchDiffResponse = GetBranchDiffResponseRaw;
 interface GetBranchDiffResult {
@@ -572,6 +576,7 @@ interface GetBranchDiffResult {
 }
 interface GetCommitDiffOptions extends GitStorageInvocationOptions {
     sha: string;
+    baseSha?: string;
 }
 type GetCommitDiffResponse = GetCommitDiffResponseRaw;
 interface GetCommitDiffResult {
@@ -861,11 +866,11 @@ declare function validateWebhook(payload: string | Buffer, headers: Record<strin
  */
 
 declare class GitStorage {
-    private static overrides;
     private options;
     private api;
     constructor(options: GitStorageOptions);
-    static override(options: OverrideableGitStorageOptions): void;
+    static getDefaultAPIBaseUrl(name: string): string;
+    static getDefaultStorageBaseUrl(name: string): string;
     /**
      * Create a new repository
      * @returns The created repository
@@ -889,6 +894,7 @@ declare class GitStorage {
     private generateJWT;
 }
 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 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 };
+export { ApiError, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, 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

@@ -442,6 +442,17 @@ function concatChunks(a, b) {
   return merged;
 }
 
+// package.json
+var package_default = {
+  version: "0.3.0"};
+
+// src/version.ts
+var PACKAGE_NAME = "code-storage-sdk";
+var PACKAGE_VERSION = package_default.version;
+function getUserAgent() {
+  return `${PACKAGE_NAME}/${PACKAGE_VERSION}`;
+}
+
 // src/commit.ts
 var DEFAULT_TTL_SECONDS = 60 * 60;
 var HEADS_REF_PREFIX = "refs/heads/";
@@ -614,7 +625,8 @@ var FetchCommitTransport = class {
       headers: {
         Authorization: `Bearer ${request.authorization}`,
         "Content-Type": "application/x-ndjson",
-        Accept: "application/json"
+        Accept: "application/json",
+        "Code-Storage-Agent": getUserAgent()
       },
       body,
       signal: request.signal
@@ -844,7 +856,8 @@ var FetchDiffCommitTransport = class {
       headers: {
         Authorization: `Bearer ${request.authorization}`,
         "Content-Type": "application/x-ndjson",
-        Accept: "application/json"
+        Accept: "application/json",
+        "Code-Storage-Agent": getUserAgent()
       },
       body,
       signal: request.signal
@@ -981,7 +994,8 @@ var ApiFetcher = class {
       method,
       headers: {
         Authorization: `Bearer ${jwt}`,
-        "Content-Type": "application/json"
+        "Content-Type": "application/json",
+        "Code-Storage-Agent": getUserAgent()
       }
     };
     if (method !== "GET" && typeof path !== "string" && path.body) {
@@ -1277,8 +1291,8 @@ function isRecord(value) {
 }
 
 // src/index.ts
-var API_BASE_URL = "https://api.code.storage";
-var STORAGE_BASE_URL = "code.storage";
+var API_BASE_URL = "https://api.{{org}}.code.storage";
+var STORAGE_BASE_URL = "{{org}}.code.storage";
 var API_VERSION = 1;
 var apiInstanceMap = /* @__PURE__ */ new Map();
 var DEFAULT_TOKEN_TTL_SECONDS = 60 * 60;
@@ -1505,14 +1519,19 @@ var RepoImpl = class {
     this.options = options;
     this.generateJWT = generateJWT;
     this.api = getApiInstance(
-      this.options.apiBaseUrl ?? API_BASE_URL,
+      this.options.apiBaseUrl ?? GitStorage.getDefaultAPIBaseUrl(options.name),
       this.options.apiVersion ?? API_VERSION
     );
   }
   api;
   async getRemoteURL(urlOptions) {
-    const storageBaseUrl = this.options.storageBaseUrl ?? STORAGE_BASE_URL;
-    const url = new URL(`https://${this.options.name}.${storageBaseUrl}/${this.id}.git`);
+    const url = new URL(`https://${this.options.storageBaseUrl}/${this.id}.git`);
+    url.username = `t`;
+    url.password = await this.generateJWT(this.id, urlOptions);
+    return url.toString();
+  }
+  async getEphemeralRemoteURL(urlOptions) {
+    const url = new URL(`https://${this.options.storageBaseUrl}/${this.id}+ephemeral.git`);
     url.username = `t`;
     url.password = await this.generateJWT(this.id, urlOptions);
     return url.toString();
@@ -1532,6 +1551,9 @@ var RepoImpl = class {
     if (typeof options.ephemeral === "boolean") {
       params.ephemeral = String(options.ephemeral);
     }
+    if (typeof options.ephemeralBase === "boolean") {
+      params.ephemeral_base = String(options.ephemeralBase);
+    }
     return this.api.get({ path: "repos/file", params }, jwt);
   }
   async listFiles(options) {
@@ -1617,6 +1639,12 @@ var RepoImpl = class {
     if (options.base) {
       params.base = options.base;
     }
+    if (typeof options.ephemeral === "boolean") {
+      params.ephemeral = String(options.ephemeral);
+    }
+    if (typeof options.ephemeralBase === "boolean") {
+      params.ephemeral_base = String(options.ephemeralBase);
+    }
     const response = await this.api.get({ path: "repos/branches/diff", params }, jwt);
     const raw = branchDiffResponseSchema.parse(await response.json());
     return transformBranchDiffResult(raw);
@@ -1630,6 +1658,9 @@ var RepoImpl = class {
     const params = {
       sha: options.sha
     };
+    if (options.baseSha) {
+      params.baseSha = options.baseSha;
+    }
     const response = await this.api.get({ path: "repos/diff", params }, jwt);
     const raw = commitDiffResponseSchema.parse(await response.json());
     return transformCommitDiffResult(raw);
@@ -1749,7 +1780,7 @@ var RepoImpl = class {
   }
   createCommit(options) {
     const version = this.options.apiVersion ?? API_VERSION;
-    const baseUrl = this.options.apiBaseUrl ?? API_BASE_URL;
+    const baseUrl = this.options.apiBaseUrl ?? GitStorage.getDefaultAPIBaseUrl(this.options.name);
     const transport = new FetchCommitTransport({ baseUrl, version });
     const ttl = resolveCommitTtlSeconds(options);
     const builderOptions = {
@@ -1768,7 +1799,7 @@ var RepoImpl = class {
   }
   async createCommitFromDiff(options) {
     const version = this.options.apiVersion ?? API_VERSION;
-    const baseUrl = this.options.apiBaseUrl ?? API_BASE_URL;
+    const baseUrl = this.options.apiBaseUrl ?? GitStorage.getDefaultAPIBaseUrl(this.options.name);
     const transport = new FetchDiffCommitTransport({ baseUrl, version });
     const ttl = resolveCommitTtlSeconds(options);
     const requestOptions = {
@@ -1787,7 +1818,6 @@ var RepoImpl = class {
   }
 };
 var GitStorage = class _GitStorage {
-  static overrides = {};
   options;
   api;
   constructor(options) {
@@ -1802,10 +1832,10 @@ var GitStorage = class _GitStorage {
     if (typeof options.key !== "string" || options.key.trim() === "") {
       throw new Error("GitStorage key must be a non-empty string.");
     }
-    const resolvedApiBaseUrl = options.apiBaseUrl ?? _GitStorage.overrides.apiBaseUrl ?? API_BASE_URL;
-    const resolvedApiVersion = options.apiVersion ?? _GitStorage.overrides.apiVersion ?? API_VERSION;
-    const resolvedStorageBaseUrl = options.storageBaseUrl ?? _GitStorage.overrides.storageBaseUrl ?? STORAGE_BASE_URL;
-    const resolvedDefaultTtl = options.defaultTTL ?? _GitStorage.overrides.defaultTTL;
+    const resolvedApiBaseUrl = options.apiBaseUrl ?? _GitStorage.getDefaultAPIBaseUrl(options.name);
+    const resolvedApiVersion = options.apiVersion ?? API_VERSION;
+    const resolvedStorageBaseUrl = options.storageBaseUrl ?? _GitStorage.getDefaultStorageBaseUrl(options.name);
+    const resolvedDefaultTtl = options.defaultTTL;
     this.api = getApiInstance(resolvedApiBaseUrl, resolvedApiVersion);
     this.options = {
       key: options.key,
@@ -1816,8 +1846,11 @@ var GitStorage = class _GitStorage {
       defaultTTL: resolvedDefaultTtl
     };
   }
-  static override(options) {
-    this.overrides = Object.assign({}, this.overrides, options);
+  static getDefaultAPIBaseUrl(name) {
+    return API_BASE_URL.replace("{{org}}", name);
+  }
+  static getDefaultStorageBaseUrl(name) {
+    return STORAGE_BASE_URL.replace("{{org}}", name);
   }
   /**
    * Create a new repository
@@ -1896,6 +1929,6 @@ function createClient(options) {
   return new GitStorage(options);
 }
 
-export { ApiError, GitStorage, RefUpdateError, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };
+export { ApiError, GitStorage as CodeStorage, GitStorage, RefUpdateError, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map