@pierre/storage 0.2.2 → 0.2.3

package/README.md

@@ -76,6 +76,26 @@ const readOnlyUrl = await repo.getRemoteURL({
 // - 'repo:write' - Create a repository
 ```
 
+#### Ephemeral Branches
+
+For working with ephemeral branches (temporary branches isolated from the main repository), use
+`getEphemeralRemote()`:
+
+```typescript
+// Get ephemeral namespace remote URL
+const ephemeralUrl = await repo.getEphemeralRemoteURL();
+// Returns: https://t:JWT@your-name.code.storage/repo-id+ephemeral.git
+
+// Configure separate remotes for default and ephemeral branches
+console.log(`Run: git remote add origin ${await repo.getRemoteURL()}`);
+console.log(`Run: git remote add ephemeral ${await repo.getEphemeralRemoteURL()}`);
+
+// Push ephemeral branch
+// git push ephemeral feature-branch
+
+// The ephemeral remote supports all the same options and permission as regular remotes
+```
+
 ### Working with Repository Content
 
 Once you have a repository instance, you can perform various Git operations:
@@ -290,6 +310,7 @@ interface FindOneOptions {
 interface Repo {
   id: string;
   getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+  getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
 
   getFileStream(options: GetFileOptions): Promise<Response>;
   listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;

package/dist/index.cjs

@@ -1523,6 +1523,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, {