@pierre/storage 1.0.2 → 1.1.0

package/package.json

@@ -1,40 +1,41 @@
 {
-  "name": "@pierre/storage",
-  "version": "1.0.2",
-  "description": "Pierre Git Storage SDK",
-  "license": "MIT",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "dependencies": {
-    "jose": "^5.10.0",
-    "snakecase-keys": "^9.0.2",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsup": "8.5.0",
-    "typescript": "5.8.3",
-    "vitest": "3.2.4"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  }
-}
+	"name": "@pierre/storage",
+	"version": "1.1.0",
+	"description": "Pierre Git Storage SDK",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"prepublishOnly": "pnpm build"
+	},
+	"dependencies": {
+		"jose": "^5.10.0",
+		"snakecase-keys": "^9.0.2",
+		"zod": "^3.23.8"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"tsup": "8.5.0",
+		"typescript": "5.8.3",
+		"vitest": "3.2.4"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/src/index.ts

@@ -84,6 +84,7 @@ import type {
   RawFileDiff,
   RawFilteredFile,
   RefUpdate,
+  RepoOptions,
   Repo,
   RestoreCommitOptions,
   RestoreCommitResult,
@@ -1393,13 +1394,11 @@ export class GitStorage {
       throw new Error('Repository already exists');
     }
 
-    return new RepoImpl(
-      repoId,
-      resolvedDefaultBranch ?? 'main',
-      new Date().toISOString(),
-      this.options,
-      this.generateJWT.bind(this)
-    );
+    return this.repo({
+      id: repoId,
+      defaultBranch: resolvedDefaultBranch ?? 'main',
+      createdAt: new Date().toISOString(),
+    });
   }
 
   /**
@@ -1448,13 +1447,33 @@ export class GitStorage {
     if (resp.status === 404) {
       return null;
     }
-    const body = (await resp.json()) as { default_branch?: string; created_at?: string };
+
+    const body = (await resp.json()) as {
+      default_branch?: string;
+      created_at?: string;
+    };
     const defaultBranch = body.default_branch ?? 'main';
     const createdAt = body.created_at ?? '';
-    return new RepoImpl(
-      options.id,
+
+    return this.repo({
+      id: options.id,
       defaultBranch,
       createdAt,
+    });
+  }
+
+  /**
+   * Create a Repo handle from known metadata without making an HTTP request.
+   */
+  repo(options: RepoOptions): Repo {
+    if (!options || typeof options.id !== 'string' || options.id.trim() === '') {
+      throw new Error('repo requires a non-empty repository id.');
+    }
+
+    return new RepoImpl(
+      options.id,
+      options.defaultBranch ?? 'main',
+      options.createdAt ?? '',
       this.options,
       this.generateJWT.bind(this)
     );

package/src/types.ts

@@ -84,8 +84,21 @@ export interface FindOneOptions {
   id: string;
 }
 
+export interface RepoOptions {
+  id: string;
+  defaultBranch?: string;
+  createdAt?: string;
+}
+
 export type SupportedRepoProvider = 'github';
 
+export interface PublicGitHubBaseRepoAuth {
+  /**
+   * Force public GitHub mode (no GitHub App installation required).
+   */
+  authType: 'public';
+}
+
 export interface GitHubBaseRepo {
   /**
    * @default github
@@ -94,6 +107,7 @@ export interface GitHubBaseRepo {
   owner: string;
   name: string;
   defaultBranch?: string;
+  auth?: PublicGitHubBaseRepoAuth;
 }
 
 export interface ForkBaseRepo {