@pierre/storage 1.0.3 → 1.1.0

package/README.md

@@ -72,6 +72,22 @@ if (foundRepo) {
 }
 ```
 
+### Hydrating a Repository Without a Request
+
+If you already know the repo metadata, you can construct a `Repo` directly:
+
+```typescript
+const repo = store.repo({
+  id: 'repo-id',
+  defaultBranch: 'main',
+  createdAt: '2024-06-15T12:00:00Z',
+});
+
+// No HTTP request is made by repo()
+const url = await repo.getRemoteURL();
+console.log(url);
+```
+
 ### Grep
 
 ```typescript
@@ -363,6 +379,7 @@ class GitStorage {
   constructor(options: GitStorageOptions);
   async createRepo(options?: CreateRepoOptions): Promise<Repo>;
   async findOne(options: FindOneOptions): Promise<Repo | null>;
+  repo(options: RepoOptions): Repo;
   getConfig(): GitStorageOptions;
 }
 ```
@@ -400,6 +417,12 @@ interface FindOneOptions {
   id: string; // Repository ID to find
 }
 
+interface RepoOptions {
+  id: string; // Repository ID
+  defaultBranch?: string; // Defaults to "main"
+  createdAt?: string; // Defaults to ""
+}
+
 interface Repo {
   id: string;
   getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;

package/dist/index.cjs

@@ -514,7 +514,7 @@ function concatChunks(a, b) {
 
 // package.json
 var package_default = {
-  version: "1.0.3"};
+  version: "1.1.0"};
 
 // src/version.ts
 var PACKAGE_NAME = "code-storage-sdk";
@@ -2418,13 +2418,11 @@ var GitStorage = class _GitStorage {
     if (resp.status === 409) {
       throw new Error("Repository already exists");
     }
-    return new RepoImpl(
-      repoId,
-      resolvedDefaultBranch ?? "main",
-      (/* @__PURE__ */ new Date()).toISOString(),
-      this.options,
-      this.generateJWT.bind(this)
-    );
+    return this.repo({
+      id: repoId,
+      defaultBranch: resolvedDefaultBranch ?? "main",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
   }
   /**
    * List repositories for the authenticated organization
@@ -2470,10 +2468,23 @@ var GitStorage = class _GitStorage {
     const body = await resp.json();
     const defaultBranch = body.default_branch ?? "main";
     const createdAt = body.created_at ?? "";
+    return this.repo({
+      id: options.id,
+      defaultBranch,
+      createdAt
+    });
+  }
+  /**
+   * Create a Repo handle from known metadata without making an HTTP request.
+   */
+  repo(options) {
+    if (!options || typeof options.id !== "string" || options.id.trim() === "") {
+      throw new Error("repo requires a non-empty repository id.");
+    }
     return new RepoImpl(
       options.id,
-      defaultBranch,
-      createdAt,
+      options.defaultBranch ?? "main",
+      options.createdAt ?? "",
       this.options,
       this.generateJWT.bind(this)
     );