@pierre/storage 0.0.1

package/README.md

@@ -0,0 +1,163 @@
+# @pierre/storage
+
+Pierre Git Storage SDK for TypeScript/JavaScript applications.
+
+## Installation
+
+```bash
+npm install @pierre/storage
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { GitStorage } from '@pierre/storage';
+
+// Initialize the client with your name and key
+const store = new GitStorage({
+  name: 'your-name', // e.g., 'v0'
+  key: 'your-key', // Your API key
+});
+```
+
+### Creating a Repository
+
+```typescript
+// Create a new repository with auto-generated ID
+const repo = await store.createRepo();
+console.log(repo.id); // e.g., '123e4567-e89b-12d3-a456-426614174000'
+
+// Create a repository with custom ID
+const customRepo = await store.createRepo({ id: 'my-custom-repo' });
+console.log(customRepo.id); // 'my-custom-repo'
+```
+
+### Finding a Repository
+
+```typescript
+const foundRepo = await store.findOne({ id: 'repo-id' });
+if (foundRepo) {
+  const url = await foundRepo.getRemoteURL();
+  console.log(`Repository URL: ${url}`);
+}
+```
+
+### Getting Remote URLs
+
+The SDK generates secure URLs with JWT authentication for Git operations:
+
+```typescript
+// Get URL with default permissions (git:write, git:read) and 1-year TTL
+const url = await repo.getRemoteURL();
+// Returns: https://t:JWT@your-name.git.storage/repo-id.git
+
+// Configure the Git remote
+console.log(`Run: git remote add origin ${url}`);
+
+// Get URL with custom permissions and TTL
+const readOnlyUrl = await repo.getRemoteURL({
+  permissions: ['git:read'], // Read-only access
+  ttl: 3600, // 1 hour in seconds
+});
+
+// Available permissions:
+// - 'git:read'   - Read access to Git repository
+// - 'git:write'  - Write access to Git repository
+// - 'repo:write' - Create a repository
+```
+
+## API Reference
+
+### GitStorage
+
+```typescript
+class GitStorage {
+  constructor(options: GitStorageOptions);
+  async createRepo(options?: CreateRepoOptions): Promise<Repo>;
+  async findOne(options: FindOneOptions): Promise<Repo | null>;
+  getConfig(): GitStorageOptions;
+}
+```
+
+### Interfaces
+
+```typescript
+interface GitStorageOptions {
+  name: string; // Your identifier
+  key: string; // Your API key
+}
+
+interface CreateRepoOptions {
+  id?: string; // Optional custom repository ID
+}
+
+interface FindOneOptions {
+  id: string; // Repository ID to find
+}
+
+interface Repo {
+  id: string;
+  getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+}
+
+interface GetRemoteURLOptions {
+  permissions?: ('git:write' | 'git:read' | 'repo:write')[];
+  ttl?: number; // Time to live in seconds (default: 31536000 = 1 year)
+}
+```
+
+## Authentication
+
+The SDK uses JWT (JSON Web Tokens) for authentication. When you call `getRemoteURL()`, it:
+
+1. Creates a JWT with your name, repository ID, and requested permissions
+2. Signs it with your key
+3. Embeds it in the Git remote URL as the password
+
+The generated URLs are compatible with standard Git clients and include all necessary
+authentication.
+
+## Error Handling
+
+The SDK validates inputs and provides helpful error messages:
+
+```typescript
+try {
+  const store = new GitStorage({ name: '', key: 'key' });
+} catch (error) {
+  // Error: GitStorage name must be a non-empty string.
+}
+
+try {
+  const store = new GitStorage({ name: 'v0', key: '' });
+} catch (error) {
+  // Error: GitStorage key must be a non-empty string.
+}
+```
+
+## Development
+
+This package is part of the Pierre monorepo. To work on it locally:
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the package
+moon git-storage-sdk:build
+
+# Run tests
+moon git-storage-sdk:test
+
+# Run in watch mode
+moon git-storage-sdk:dev
+
+# Format code
+moon git-storage-sdk:format-write
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,110 @@
+'use strict';
+
+var jose = require('jose');
+
+// src/index.ts
+var API_BASE_URL = "https://api.git.storage";
+var STORAGE_BASE_URL = "git.storage";
+var GitStorage = class {
+  options;
+  constructor(options) {
+    if (!options || options.name === void 0 || options.key === void 0 || options.name === null || options.key === null) {
+      throw new Error(
+        "GitStorage requires a name and key. Please check your configuration and try again."
+      );
+    }
+    if (typeof options.name !== "string" || options.name.trim() === "") {
+      throw new Error("GitStorage name must be a non-empty string.");
+    }
+    if (typeof options.key !== "string" || options.key.trim() === "") {
+      throw new Error("GitStorage key must be a non-empty string.");
+    }
+    this.options = {
+      key: options.key,
+      name: options.name
+    };
+  }
+  /**
+   * Create a new repository
+   * @returns The created repository
+   */
+  async createRepo(options) {
+    const repoId = options?.id || crypto.randomUUID();
+    const jwt = await this.generateJWT(repoId, {
+      permissions: ["repo:write"],
+      ttl: 1 * 60 * 60
+      // 1hr in seconds
+    });
+    const response = await fetch(`${API_BASE_URL}/api/v1/repos`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${jwt}`
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to create repository: ${response.statusText}`);
+    }
+    return {
+      id: repoId,
+      getRemoteURL: async (urlOptions) => {
+        const url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${repoId}.git`);
+        url.username = `t`;
+        url.password = await this.generateJWT(repoId, urlOptions);
+        return url.toString();
+      }
+    };
+  }
+  /**
+   * Find a repository by ID
+   * @param options The search options
+   * @returns The found repository
+   */
+  async findOne(options) {
+    return {
+      id: options.id,
+      getRemoteURL: async (urlOptions) => {
+        const url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${options.id}.git`);
+        url.username = `t`;
+        url.password = await this.generateJWT(options.id, urlOptions);
+        return url.toString();
+      }
+    };
+  }
+  /**
+   * Get the current configuration
+   * @returns The client configuration
+   */
+  getConfig() {
+    return { ...this.options };
+  }
+  /**
+   * Generate a JWT token for git storage URL authentication
+   * @private
+   */
+  async generateJWT(repoId, options) {
+    const permissions = options?.permissions || ["git:write", "git:read"];
+    const ttl = options?.ttl || 365 * 24 * 60 * 60;
+    const now = Math.floor(Date.now() / 1e3);
+    const payload = {
+      aud: "git.pierre.co",
+      // todo this should be updated to git.storage
+      iss: this.options.name,
+      sub: "@pierre/storage",
+      repo: repoId,
+      scopes: permissions,
+      iat: now,
+      exp: now + ttl
+    };
+    const key = await jose.importPKCS8(this.options.key, "ES256");
+    const jwt = await new jose.SignJWT(payload).setProtectedHeader({ alg: "ES256", typ: "JWT" }).sign(key);
+    return jwt;
+  }
+};
+function createClient(options) {
+  return new GitStorage(options);
+}
+
+exports.GitStorage = GitStorage;
+exports.createClient = createClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["importPKCS8","SignJWT"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Pierre Git Storage SDK\n *\n * A TypeScript SDK for interacting with Pierre's git storage system\n */\n\nimport { importPKCS8, SignJWT } from 'jose';\n\n/**\n * Type definitions for Pierre Git Storage SDK\n */\n\nexport interface GitStorageOptions {\n\tkey: string;\n\tname: string;\n}\n\nexport interface GetRemoteURLOptions {\n\tpermissions?: ('git:write' | 'git:read' | 'repo:write')[];\n\tttl?: number;\n}\n\nexport interface Repo {\n\tid: string;\n\tgetRemoteURL(options?: GetRemoteURLOptions): Promise<string>;\n}\n\nexport interface FindOneOptions {\n\tid: string;\n}\n\nexport interface CreateRepoOptions {\n\tid?: string;\n}\n\nexport interface CreateRepoResponse {\n\trepo_id: string;\n\turl: string;\n}\n\n/**\n * Git Storage API\n */\ndeclare const __API_BASE_URL__: string;\ndeclare const __STORAGE_BASE_URL__: string;\n\nconst API_BASE_URL = __API_BASE_URL__;\nconst STORAGE_BASE_URL = __STORAGE_BASE_URL__;\n\nexport class GitStorage {\n\tprivate options: GitStorageOptions;\n\n\tconstructor(options: GitStorageOptions) {\n\t\tif (\n\t\t\t!options ||\n\t\t\toptions.name === undefined ||\n\t\t\toptions.key === undefined ||\n\t\t\toptions.name === null ||\n\t\t\toptions.key === null\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t'GitStorage requires a name and key. Please check your configuration and try again.',\n\t\t\t);\n\t\t}\n\n\t\tif (typeof options.name !== 'string' || options.name.trim() === '') {\n\t\t\tthrow new Error('GitStorage name must be a non-empty string.');\n\t\t}\n\n\t\tif (typeof options.key !== 'string' || options.key.trim() === '') {\n\t\t\tthrow new Error('GitStorage key must be a non-empty string.');\n\t\t}\n\n\t\tthis.options = {\n\t\t\tkey: options.key,\n\t\t\tname: options.name,\n\t\t};\n\t}\n\n\t/**\n\t * Create a new repository\n\t * @returns The created repository\n\t */\n\tasync createRepo(options?: CreateRepoOptions): Promise<Repo> {\n\t\tconst repoId = options?.id || crypto.randomUUID();\n\n\t\tconst jwt = await this.generateJWT(repoId, {\n\t\t\tpermissions: ['repo:write'],\n\t\t\tttl: 1 * 60 * 60, // 1hr in seconds\n\t\t});\n\n\t\tconst response = await fetch(`${API_BASE_URL}/api/v1/repos`, {\n\t\t\tmethod: 'POST',\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${jwt}`,\n\t\t\t},\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow new Error(`Failed to create repository: ${response.statusText}`);\n\t\t}\n\n\t\treturn {\n\t\t\tid: repoId,\n\t\t\tgetRemoteURL: async (urlOptions?: GetRemoteURLOptions): Promise<string> => {\n\t\t\t\tconst url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${repoId}.git`);\n\t\t\t\turl.username = `t`;\n\t\t\t\turl.password = await this.generateJWT(repoId, urlOptions);\n\t\t\t\treturn url.toString();\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Find a repository by ID\n\t * @param options The search options\n\t * @returns The found repository\n\t */\n\tasync findOne(options: FindOneOptions): Promise<Repo | null> {\n\t\treturn {\n\t\t\tid: options.id,\n\t\t\tgetRemoteURL: async (urlOptions?: GetRemoteURLOptions): Promise<string> => {\n\t\t\t\tconst url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${options.id}.git`);\n\t\t\t\turl.username = `t`;\n\t\t\t\turl.password = await this.generateJWT(options.id, urlOptions);\n\t\t\t\treturn url.toString();\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Get the current configuration\n\t * @returns The client configuration\n\t */\n\tgetConfig(): GitStorageOptions {\n\t\treturn { ...this.options };\n\t}\n\n\t/**\n\t * Generate a JWT token for git storage URL authentication\n\t * @private\n\t */\n\tprivate async generateJWT(repoId: string, options?: GetRemoteURLOptions): Promise<string> {\n\t\t// Default permissions and TTL\n\t\tconst permissions = options?.permissions || ['git:write', 'git:read'];\n\t\tconst ttl = options?.ttl || 365 * 24 * 60 * 60; // 1 year in seconds\n\n\t\t// Create the JWT payload\n\t\tconst now = Math.floor(Date.now() / 1000);\n\t\tconst payload = {\n\t\t\taud: 'git.pierre.co', // todo this should be updated to git.storage\n\t\t\tiss: this.options.name,\n\t\t\tsub: '@pierre/storage',\n\t\t\trepo: repoId,\n\t\t\tscopes: permissions,\n\t\t\tiat: now,\n\t\t\texp: now + ttl,\n\t\t};\n\n\t\t// Sign the JWT with the key as the secret\n\t\t// Using HS256 for symmetric signing with the key\n\t\tconst key = await importPKCS8(this.options.key, 'ES256');\n\t\t// Sign the JWT with the key as the secret\n\t\tconst jwt = await new SignJWT(payload)\n\t\t\t.setProtectedHeader({ alg: 'ES256', typ: 'JWT' })\n\t\t\t.sign(key);\n\n\t\treturn jwt;\n\t}\n}\n\n// Export a default client factory\nexport function createClient(options: GitStorageOptions): GitStorage {\n\treturn new GitStorage(options);\n}\n\n// Type alias for backward compatibility\nexport type StorageOptions = GitStorageOptions;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+/**
+ * Pierre Git Storage SDK
+ *
+ * A TypeScript SDK for interacting with Pierre's git storage system
+ */
+/**
+ * Type definitions for Pierre Git Storage SDK
+ */
+interface GitStorageOptions {
+    key: string;
+    name: string;
+}
+interface GetRemoteURLOptions {
+    permissions?: ('git:write' | 'git:read' | 'repo:write')[];
+    ttl?: number;
+}
+interface Repo {
+    id: string;
+    getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+}
+interface FindOneOptions {
+    id: string;
+}
+interface CreateRepoOptions {
+    id?: string;
+}
+interface CreateRepoResponse {
+    repo_id: string;
+    url: string;
+}
+declare class GitStorage {
+    private options;
+    constructor(options: GitStorageOptions);
+    /**
+     * Create a new repository
+     * @returns The created repository
+     */
+    createRepo(options?: CreateRepoOptions): Promise<Repo>;
+    /**
+     * Find a repository by ID
+     * @param options The search options
+     * @returns The found repository
+     */
+    findOne(options: FindOneOptions): Promise<Repo | null>;
+    /**
+     * Get the current configuration
+     * @returns The client configuration
+     */
+    getConfig(): GitStorageOptions;
+    /**
+     * Generate a JWT token for git storage URL authentication
+     * @private
+     */
+    private generateJWT;
+}
+declare function createClient(options: GitStorageOptions): GitStorage;
+type StorageOptions = GitStorageOptions;
+
+export { type CreateRepoOptions, type CreateRepoResponse, type FindOneOptions, type GetRemoteURLOptions, GitStorage, type GitStorageOptions, type Repo, type StorageOptions, createClient };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Pierre Git Storage SDK
+ *
+ * A TypeScript SDK for interacting with Pierre's git storage system
+ */
+/**
+ * Type definitions for Pierre Git Storage SDK
+ */
+interface GitStorageOptions {
+    key: string;
+    name: string;
+}
+interface GetRemoteURLOptions {
+    permissions?: ('git:write' | 'git:read' | 'repo:write')[];
+    ttl?: number;
+}
+interface Repo {
+    id: string;
+    getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+}
+interface FindOneOptions {
+    id: string;
+}
+interface CreateRepoOptions {
+    id?: string;
+}
+interface CreateRepoResponse {
+    repo_id: string;
+    url: string;
+}
+declare class GitStorage {
+    private options;
+    constructor(options: GitStorageOptions);
+    /**
+     * Create a new repository
+     * @returns The created repository
+     */
+    createRepo(options?: CreateRepoOptions): Promise<Repo>;
+    /**
+     * Find a repository by ID
+     * @param options The search options
+     * @returns The found repository
+     */
+    findOne(options: FindOneOptions): Promise<Repo | null>;
+    /**
+     * Get the current configuration
+     * @returns The client configuration
+     */
+    getConfig(): GitStorageOptions;
+    /**
+     * Generate a JWT token for git storage URL authentication
+     * @private
+     */
+    private generateJWT;
+}
+declare function createClient(options: GitStorageOptions): GitStorage;
+type StorageOptions = GitStorageOptions;
+
+export { type CreateRepoOptions, type CreateRepoResponse, type FindOneOptions, type GetRemoteURLOptions, GitStorage, type GitStorageOptions, type Repo, type StorageOptions, createClient };

package/dist/index.js

@@ -0,0 +1,107 @@
+import { importPKCS8, SignJWT } from 'jose';
+
+// src/index.ts
+var API_BASE_URL = "https://api.git.storage";
+var STORAGE_BASE_URL = "git.storage";
+var GitStorage = class {
+  options;
+  constructor(options) {
+    if (!options || options.name === void 0 || options.key === void 0 || options.name === null || options.key === null) {
+      throw new Error(
+        "GitStorage requires a name and key. Please check your configuration and try again."
+      );
+    }
+    if (typeof options.name !== "string" || options.name.trim() === "") {
+      throw new Error("GitStorage name must be a non-empty string.");
+    }
+    if (typeof options.key !== "string" || options.key.trim() === "") {
+      throw new Error("GitStorage key must be a non-empty string.");
+    }
+    this.options = {
+      key: options.key,
+      name: options.name
+    };
+  }
+  /**
+   * Create a new repository
+   * @returns The created repository
+   */
+  async createRepo(options) {
+    const repoId = options?.id || crypto.randomUUID();
+    const jwt = await this.generateJWT(repoId, {
+      permissions: ["repo:write"],
+      ttl: 1 * 60 * 60
+      // 1hr in seconds
+    });
+    const response = await fetch(`${API_BASE_URL}/api/v1/repos`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${jwt}`
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Failed to create repository: ${response.statusText}`);
+    }
+    return {
+      id: repoId,
+      getRemoteURL: async (urlOptions) => {
+        const url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${repoId}.git`);
+        url.username = `t`;
+        url.password = await this.generateJWT(repoId, urlOptions);
+        return url.toString();
+      }
+    };
+  }
+  /**
+   * Find a repository by ID
+   * @param options The search options
+   * @returns The found repository
+   */
+  async findOne(options) {
+    return {
+      id: options.id,
+      getRemoteURL: async (urlOptions) => {
+        const url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${options.id}.git`);
+        url.username = `t`;
+        url.password = await this.generateJWT(options.id, urlOptions);
+        return url.toString();
+      }
+    };
+  }
+  /**
+   * Get the current configuration
+   * @returns The client configuration
+   */
+  getConfig() {
+    return { ...this.options };
+  }
+  /**
+   * Generate a JWT token for git storage URL authentication
+   * @private
+   */
+  async generateJWT(repoId, options) {
+    const permissions = options?.permissions || ["git:write", "git:read"];
+    const ttl = options?.ttl || 365 * 24 * 60 * 60;
+    const now = Math.floor(Date.now() / 1e3);
+    const payload = {
+      aud: "git.pierre.co",
+      // todo this should be updated to git.storage
+      iss: this.options.name,
+      sub: "@pierre/storage",
+      repo: repoId,
+      scopes: permissions,
+      iat: now,
+      exp: now + ttl
+    };
+    const key = await importPKCS8(this.options.key, "ES256");
+    const jwt = await new SignJWT(payload).setProtectedHeader({ alg: "ES256", typ: "JWT" }).sign(key);
+    return jwt;
+  }
+};
+function createClient(options) {
+  return new GitStorage(options);
+}
+
+export { GitStorage, createClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Pierre Git Storage SDK\n *\n * A TypeScript SDK for interacting with Pierre's git storage system\n */\n\nimport { importPKCS8, SignJWT } from 'jose';\n\n/**\n * Type definitions for Pierre Git Storage SDK\n */\n\nexport interface GitStorageOptions {\n\tkey: string;\n\tname: string;\n}\n\nexport interface GetRemoteURLOptions {\n\tpermissions?: ('git:write' | 'git:read' | 'repo:write')[];\n\tttl?: number;\n}\n\nexport interface Repo {\n\tid: string;\n\tgetRemoteURL(options?: GetRemoteURLOptions): Promise<string>;\n}\n\nexport interface FindOneOptions {\n\tid: string;\n}\n\nexport interface CreateRepoOptions {\n\tid?: string;\n}\n\nexport interface CreateRepoResponse {\n\trepo_id: string;\n\turl: string;\n}\n\n/**\n * Git Storage API\n */\ndeclare const __API_BASE_URL__: string;\ndeclare const __STORAGE_BASE_URL__: string;\n\nconst API_BASE_URL = __API_BASE_URL__;\nconst STORAGE_BASE_URL = __STORAGE_BASE_URL__;\n\nexport class GitStorage {\n\tprivate options: GitStorageOptions;\n\n\tconstructor(options: GitStorageOptions) {\n\t\tif (\n\t\t\t!options ||\n\t\t\toptions.name === undefined ||\n\t\t\toptions.key === undefined ||\n\t\t\toptions.name === null ||\n\t\t\toptions.key === null\n\t\t) {\n\t\t\tthrow new Error(\n\t\t\t\t'GitStorage requires a name and key. Please check your configuration and try again.',\n\t\t\t);\n\t\t}\n\n\t\tif (typeof options.name !== 'string' || options.name.trim() === '') {\n\t\t\tthrow new Error('GitStorage name must be a non-empty string.');\n\t\t}\n\n\t\tif (typeof options.key !== 'string' || options.key.trim() === '') {\n\t\t\tthrow new Error('GitStorage key must be a non-empty string.');\n\t\t}\n\n\t\tthis.options = {\n\t\t\tkey: options.key,\n\t\t\tname: options.name,\n\t\t};\n\t}\n\n\t/**\n\t * Create a new repository\n\t * @returns The created repository\n\t */\n\tasync createRepo(options?: CreateRepoOptions): Promise<Repo> {\n\t\tconst repoId = options?.id || crypto.randomUUID();\n\n\t\tconst jwt = await this.generateJWT(repoId, {\n\t\t\tpermissions: ['repo:write'],\n\t\t\tttl: 1 * 60 * 60, // 1hr in seconds\n\t\t});\n\n\t\tconst response = await fetch(`${API_BASE_URL}/api/v1/repos`, {\n\t\t\tmethod: 'POST',\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${jwt}`,\n\t\t\t},\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow new Error(`Failed to create repository: ${response.statusText}`);\n\t\t}\n\n\t\treturn {\n\t\t\tid: repoId,\n\t\t\tgetRemoteURL: async (urlOptions?: GetRemoteURLOptions): Promise<string> => {\n\t\t\t\tconst url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${repoId}.git`);\n\t\t\t\turl.username = `t`;\n\t\t\t\turl.password = await this.generateJWT(repoId, urlOptions);\n\t\t\t\treturn url.toString();\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Find a repository by ID\n\t * @param options The search options\n\t * @returns The found repository\n\t */\n\tasync findOne(options: FindOneOptions): Promise<Repo | null> {\n\t\treturn {\n\t\t\tid: options.id,\n\t\t\tgetRemoteURL: async (urlOptions?: GetRemoteURLOptions): Promise<string> => {\n\t\t\t\tconst url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${options.id}.git`);\n\t\t\t\turl.username = `t`;\n\t\t\t\turl.password = await this.generateJWT(options.id, urlOptions);\n\t\t\t\treturn url.toString();\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Get the current configuration\n\t * @returns The client configuration\n\t */\n\tgetConfig(): GitStorageOptions {\n\t\treturn { ...this.options };\n\t}\n\n\t/**\n\t * Generate a JWT token for git storage URL authentication\n\t * @private\n\t */\n\tprivate async generateJWT(repoId: string, options?: GetRemoteURLOptions): Promise<string> {\n\t\t// Default permissions and TTL\n\t\tconst permissions = options?.permissions || ['git:write', 'git:read'];\n\t\tconst ttl = options?.ttl || 365 * 24 * 60 * 60; // 1 year in seconds\n\n\t\t// Create the JWT payload\n\t\tconst now = Math.floor(Date.now() / 1000);\n\t\tconst payload = {\n\t\t\taud: 'git.pierre.co', // todo this should be updated to git.storage\n\t\t\tiss: this.options.name,\n\t\t\tsub: '@pierre/storage',\n\t\t\trepo: repoId,\n\t\t\tscopes: permissions,\n\t\t\tiat: now,\n\t\t\texp: now + ttl,\n\t\t};\n\n\t\t// Sign the JWT with the key as the secret\n\t\t// Using HS256 for symmetric signing with the key\n\t\tconst key = await importPKCS8(this.options.key, 'ES256');\n\t\t// Sign the JWT with the key as the secret\n\t\tconst jwt = await new SignJWT(payload)\n\t\t\t.setProtectedHeader({ alg: 'ES256', typ: 'JWT' })\n\t\t\t.sign(key);\n\n\t\treturn jwt;\n\t}\n}\n\n// Export a default client factory\nexport function createClient(options: GitStorageOptions): GitStorage {\n\treturn new GitStorage(options);\n}\n\n// Type alias for backward compatibility\nexport type StorageOptions = GitStorageOptions;\n"]}

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@pierre/storage",
+	"version": "0.0.1",
+	"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": "BUILD_ENV=production pnpm build"
+	},
+	"dependencies": {
+		"jose": "catalog:"
+	},
+	"devDependencies": {
+		"tsup": "catalog:",
+		"typescript": "catalog:",
+		"vitest": "catalog:"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/src/index.ts

@@ -0,0 +1,178 @@
+/**
+ * Pierre Git Storage SDK
+ *
+ * A TypeScript SDK for interacting with Pierre's git storage system
+ */
+
+import { importPKCS8, SignJWT } from 'jose';
+
+/**
+ * Type definitions for Pierre Git Storage SDK
+ */
+
+export interface GitStorageOptions {
+	key: string;
+	name: string;
+}
+
+export interface GetRemoteURLOptions {
+	permissions?: ('git:write' | 'git:read' | 'repo:write')[];
+	ttl?: number;
+}
+
+export interface Repo {
+	id: string;
+	getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+}
+
+export interface FindOneOptions {
+	id: string;
+}
+
+export interface CreateRepoOptions {
+	id?: string;
+}
+
+export interface CreateRepoResponse {
+	repo_id: string;
+	url: string;
+}
+
+/**
+ * Git Storage API
+ */
+declare const __API_BASE_URL__: string;
+declare const __STORAGE_BASE_URL__: string;
+
+const API_BASE_URL = __API_BASE_URL__;
+const STORAGE_BASE_URL = __STORAGE_BASE_URL__;
+
+export class GitStorage {
+	private options: GitStorageOptions;
+
+	constructor(options: GitStorageOptions) {
+		if (
+			!options ||
+			options.name === undefined ||
+			options.key === undefined ||
+			options.name === null ||
+			options.key === null
+		) {
+			throw new Error(
+				'GitStorage requires a name and key. Please check your configuration and try again.',
+			);
+		}
+
+		if (typeof options.name !== 'string' || options.name.trim() === '') {
+			throw new Error('GitStorage name must be a non-empty string.');
+		}
+
+		if (typeof options.key !== 'string' || options.key.trim() === '') {
+			throw new Error('GitStorage key must be a non-empty string.');
+		}
+
+		this.options = {
+			key: options.key,
+			name: options.name,
+		};
+	}
+
+	/**
+	 * Create a new repository
+	 * @returns The created repository
+	 */
+	async createRepo(options?: CreateRepoOptions): Promise<Repo> {
+		const repoId = options?.id || crypto.randomUUID();
+
+		const jwt = await this.generateJWT(repoId, {
+			permissions: ['repo:write'],
+			ttl: 1 * 60 * 60, // 1hr in seconds
+		});
+
+		const response = await fetch(`${API_BASE_URL}/api/v1/repos`, {
+			method: 'POST',
+			headers: {
+				Authorization: `Bearer ${jwt}`,
+			},
+		});
+
+		if (!response.ok) {
+			throw new Error(`Failed to create repository: ${response.statusText}`);
+		}
+
+		return {
+			id: repoId,
+			getRemoteURL: async (urlOptions?: GetRemoteURLOptions): Promise<string> => {
+				const url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${repoId}.git`);
+				url.username = `t`;
+				url.password = await this.generateJWT(repoId, urlOptions);
+				return url.toString();
+			},
+		};
+	}
+
+	/**
+	 * Find a repository by ID
+	 * @param options The search options
+	 * @returns The found repository
+	 */
+	async findOne(options: FindOneOptions): Promise<Repo | null> {
+		return {
+			id: options.id,
+			getRemoteURL: async (urlOptions?: GetRemoteURLOptions): Promise<string> => {
+				const url = new URL(`https://${this.options.name}.${STORAGE_BASE_URL}/${options.id}.git`);
+				url.username = `t`;
+				url.password = await this.generateJWT(options.id, urlOptions);
+				return url.toString();
+			},
+		};
+	}
+
+	/**
+	 * Get the current configuration
+	 * @returns The client configuration
+	 */
+	getConfig(): GitStorageOptions {
+		return { ...this.options };
+	}
+
+	/**
+	 * Generate a JWT token for git storage URL authentication
+	 * @private
+	 */
+	private async generateJWT(repoId: string, options?: GetRemoteURLOptions): Promise<string> {
+		// Default permissions and TTL
+		const permissions = options?.permissions || ['git:write', 'git:read'];
+		const ttl = options?.ttl || 365 * 24 * 60 * 60; // 1 year in seconds
+
+		// Create the JWT payload
+		const now = Math.floor(Date.now() / 1000);
+		const payload = {
+			aud: 'git.pierre.co', // todo this should be updated to git.storage
+			iss: this.options.name,
+			sub: '@pierre/storage',
+			repo: repoId,
+			scopes: permissions,
+			iat: now,
+			exp: now + ttl,
+		};
+
+		// Sign the JWT with the key as the secret
+		// Using HS256 for symmetric signing with the key
+		const key = await importPKCS8(this.options.key, 'ES256');
+		// Sign the JWT with the key as the secret
+		const jwt = await new SignJWT(payload)
+			.setProtectedHeader({ alg: 'ES256', typ: 'JWT' })
+			.sign(key);
+
+		return jwt;
+	}
+}
+
+// Export a default client factory
+export function createClient(options: GitStorageOptions): GitStorage {
+	return new GitStorage(options);
+}
+
+// Type alias for backward compatibility
+export type StorageOptions = GitStorageOptions;

package/src/types.ts

@@ -0,0 +1,31 @@
+/**
+ * Type definitions for Pierre Git Storage SDK
+ */
+
+export interface GitStorageOptions {
+	key: string;
+	name: string;
+}
+
+export interface GetRemoteURLOptions {
+	permissions?: ('git:write' | 'git:read' | 'repo:write')[];
+	ttl?: number;
+}
+
+export interface Repo {
+	id: string;
+	getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
+}
+
+export interface FindOneOptions {
+	id: string;
+}
+
+export interface CreateRepoOptions {
+	id?: string;
+}
+
+export interface CreateRepoResponse {
+	repo_id: string;
+	url: string;
+}