viagen-sdk 0.0.0

package/README.md

@@ -0,0 +1,209 @@
+# viagen-sdk
+
+TypeScript client for the viagen platform API. Used by sandboxes, the CLI, and any external consumer that needs to talk to the platform.
+
+## Install
+
+```bash
+npm install viagen-sdk
+```
+
+## Quick Start
+
+### Web (cookie-based)
+
+```ts
+import { createViagen } from 'viagen-sdk'
+
+const viagen = createViagen({ baseUrl: 'https://app.viagen.dev' })
+
+// Redirect to login
+viagen.auth.login('github')
+
+// Get current user (uses session cookie)
+const user = await viagen.auth.me()
+```
+
+### CLI / Node.js (token-based)
+
+```ts
+import { createViagen, saveCredentials, createViagenFromCredentials } from 'viagen-sdk'
+
+// First time: open browser to authorize
+const viagen = createViagen({ baseUrl: 'https://app.viagen.dev' })
+const { token } = await viagen.auth.loginCli()
+
+// Save token for future sessions
+await saveCredentials({ token, baseUrl: 'https://app.viagen.dev' })
+
+// Later: create client from stored credentials
+const client = await createViagenFromCredentials()
+const projects = await client.projects.list()
+```
+
+## API Reference
+
+### `createViagen(config)`
+
+Creates a client instance.
+
+```ts
+// Web: uses cookies
+const viagen = createViagen({ baseUrl: 'http://localhost:5173' })
+
+// CLI: uses Bearer token
+const viagen = createViagen({ baseUrl: 'https://app.viagen.dev', token: 'your-api-token' })
+```
+
+| Option | Type | Description |
+|---|---|---|
+| `baseUrl` | `string` | Platform URL |
+| `token` | `string?` | API token. When set, uses `Authorization: Bearer` instead of cookies |
+
+### `createViagenFromCredentials(overrides?)`
+
+Creates a client from stored credentials (`~/.config/viagen/credentials.json`). Returns `null` if no credentials found.
+
+---
+
+### `viagen.auth`
+
+| Method | Description |
+|---|---|
+| `login(provider?)` | Redirects the browser to OAuth login. Default: `'github'`. Options: `'github'`, `'google'`, `'microsoft'`. Web only |
+| `loginCli(options?)` | Opens browser to authorize, starts localhost server, captures API token. Node.js only |
+| `me()` | Returns the current user + orgs, or `null` if not authenticated |
+| `logout()` | Ends the session. In a browser, reloads the page |
+| `listTokens()` | List the current user's API tokens |
+| `revokeToken(tokenId)` | Revoke an API token by ID |
+
+**`loginCli` options:**
+
+```ts
+{
+  port?: number                      // Preferred localhost port (default: random)
+  onOpenUrl?: (url: string) => void  // Custom handler to open the URL (default: system browser)
+}
+```
+
+---
+
+### `viagen.orgs`
+
+| Method | Description |
+|---|---|
+| `list()` | List the current user's org memberships |
+| `create({ name })` | Create a new org. The caller becomes admin |
+| `addMember({ email })` | Add a member by email. Admin only |
+
+---
+
+### `viagen.projects`
+
+| Method | Description |
+|---|---|
+| `list()` | List all projects in the current org |
+| `create(input)` | Create a project. Admin only |
+| `get(id)` | Get a single project by ID |
+| `update(id, input)` | Update a project. Admin only |
+| `delete(id)` | Delete a project. Admin only |
+
+**`CreateProjectInput`**
+
+```ts
+{
+  name: string
+  templateId?: string        // e.g. 'react-router'
+  vercelProjectId?: string   // link to existing Vercel project
+  githubRepo?: string        // 'owner/repo'
+}
+```
+
+**`UpdateProjectInput`**
+
+```ts
+{
+  name?: string
+  vercelProjectId?: string | null
+  githubRepo?: string | null
+}
+```
+
+---
+
+### `viagen.vercel`
+
+| Method | Description |
+|---|---|
+| `integrationStatus()` | Returns `{ github: boolean, vercel: boolean }` for the current org |
+| `disconnect()` | Remove the org's Vercel connection. Admin only |
+| `listProjects(params?)` | List Vercel projects. Params: `{ search?, limit? }` |
+
+> Connecting Vercel is done via OAuth redirect (`/api/integrations/vercel/start`), not through the SDK.
+
+---
+
+### `viagen.github`
+
+| Method | Description |
+|---|---|
+| `listRepos(params?)` | List repos from the org's connected GitHub account. Params: `{ page?, perPage? }` |
+
+> Connecting GitHub is done via OAuth redirect (`/api/integrations/github/start`), not through the SDK.
+
+---
+
+## Credentials
+
+Utilities for managing stored CLI credentials (`~/.config/viagen/credentials.json`):
+
+```ts
+import { saveCredentials, loadCredentials, clearCredentials } from 'viagen-sdk'
+
+await saveCredentials({ token: '...', baseUrl: 'https://app.viagen.dev' })
+const creds = await loadCredentials()   // { token, baseUrl } | null
+await clearCredentials()                // deletes the file
+```
+
+---
+
+## Error Handling
+
+All methods throw `ViagenApiError` on failure:
+
+```ts
+import { ViagenApiError } from 'viagen-sdk'
+
+try {
+  await viagen.projects.create({ name: 'my-app' })
+} catch (err) {
+  if (err instanceof ViagenApiError) {
+    console.error(err.status, err.message)
+  }
+}
+```
+
+## API Routes
+
+The SDK maps to these platform resource routes:
+
+| SDK | Method | Route |
+|---|---|---|
+| `auth.login` | GET (redirect) | `/api/auth/login/:provider` |
+| `auth.loginCli` | GET (browser) | `/cli/authorize?port=...` |
+| `auth.me` | GET | `/api/auth/me` |
+| `auth.logout` | POST | `/api/auth/logout` |
+| `auth.listTokens` | GET | `/api/auth/tokens` |
+| `auth.revokeToken` | DELETE | `/api/auth/tokens` |
+| `orgs.list` | GET | `/api/orgs` |
+| `orgs.create` | POST | `/api/orgs` |
+| `orgs.addMember` | POST | `/api/orgs/members` |
+| `projects.list` | GET | `/api/projects` |
+| `projects.create` | POST | `/api/projects` |
+| `projects.get` | GET | `/api/projects/:id` |
+| `projects.update` | PATCH | `/api/projects/:id` |
+| `projects.delete` | DELETE | `/api/projects/:id` |
+| `vercel.integrationStatus` | GET | `/api/integrations/status` |
+| `vercel.disconnect` | DELETE | `/api/integrations/vercel` |
+| `vercel.listProjects` | GET | `/api/vercel/projects` |
+| `github.listRepos` | GET | `/api/github/repos` |

package/dist/chunk-TG7LNDF6.js

@@ -0,0 +1,40 @@
+// src/credentials.ts
+import { join } from "path";
+import { readFile, writeFile, mkdir, unlink } from "fs/promises";
+import { homedir } from "os";
+function credentialsDir() {
+  return join(
+    process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"),
+    "viagen"
+  );
+}
+function credentialsPath() {
+  return join(credentialsDir(), "credentials.json");
+}
+async function loadCredentials() {
+  try {
+    const raw = await readFile(credentialsPath(), "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function saveCredentials(creds) {
+  const dir = credentialsDir();
+  await mkdir(dir, { recursive: true });
+  await writeFile(credentialsPath(), JSON.stringify(creds, null, 2) + "\n", {
+    mode: 384
+  });
+}
+async function clearCredentials() {
+  try {
+    await unlink(credentialsPath());
+  } catch {
+  }
+}
+
+export {
+  loadCredentials,
+  saveCredentials,
+  clearCredentials
+};

package/dist/credentials-44RC7NYI.js

@@ -0,0 +1,10 @@
+import {
+  clearCredentials,
+  loadCredentials,
+  saveCredentials
+} from "./chunk-TG7LNDF6.js";
+export {
+  clearCredentials,
+  loadCredentials,
+  saveCredentials
+};

package/dist/index.cjs

@@ -0,0 +1,325 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/credentials.ts
+var credentials_exports = {};
+__export(credentials_exports, {
+  clearCredentials: () => clearCredentials,
+  loadCredentials: () => loadCredentials,
+  saveCredentials: () => saveCredentials
+});
+function credentialsDir() {
+  return (0, import_node_path.join)(
+    process.env.XDG_CONFIG_HOME ?? (0, import_node_path.join)((0, import_node_os.homedir)(), ".config"),
+    "viagen"
+  );
+}
+function credentialsPath() {
+  return (0, import_node_path.join)(credentialsDir(), "credentials.json");
+}
+async function loadCredentials() {
+  try {
+    const raw = await (0, import_promises.readFile)(credentialsPath(), "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function saveCredentials(creds) {
+  const dir = credentialsDir();
+  await (0, import_promises.mkdir)(dir, { recursive: true });
+  await (0, import_promises.writeFile)(credentialsPath(), JSON.stringify(creds, null, 2) + "\n", {
+    mode: 384
+  });
+}
+async function clearCredentials() {
+  try {
+    await (0, import_promises.unlink)(credentialsPath());
+  } catch {
+  }
+}
+var import_node_path, import_promises, import_node_os;
+var init_credentials = __esm({
+  "src/credentials.ts"() {
+    "use strict";
+    import_node_path = require("path");
+    import_promises = require("fs/promises");
+    import_node_os = require("os");
+  }
+});
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ViagenApiError: () => ViagenApiError,
+  clearCredentials: () => clearCredentials,
+  createViagen: () => createViagen,
+  createViagenFromCredentials: () => createViagenFromCredentials,
+  loadCredentials: () => loadCredentials,
+  saveCredentials: () => saveCredentials
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/auth.ts
+function createAuthClient(baseUrl, request) {
+  return {
+    login(provider = "github") {
+      window.location.href = `${baseUrl}/api/auth/login/${provider}`;
+    },
+    async me() {
+      try {
+        const data = await request("/api/auth/me");
+        if (!data.authenticated) return null;
+        return { ...data.user, organizations: data.organizations };
+      } catch {
+        return null;
+      }
+    },
+    async logout() {
+      await request("/api/auth/logout", { method: "POST" });
+      if (typeof window !== "undefined") {
+        window.location.reload();
+      }
+    },
+    async loginCli(options = {}) {
+      const { port: preferredPort, onOpenUrl } = options;
+      const http = await import("http");
+      return new Promise((resolve, reject) => {
+        const server = http.createServer();
+        const timeout = setTimeout(() => {
+          server.close();
+          reject(new Error("Login timed out"));
+        }, 5 * 60 * 1e3);
+        server.listen(preferredPort ?? 0, "127.0.0.1", () => {
+          const address = server.address();
+          const port = address.port;
+          const loginUrl = `${baseUrl}/cli/authorize?port=${port}`;
+          if (onOpenUrl) {
+            onOpenUrl(loginUrl);
+          } else {
+            import("child_process").then(({ exec }) => {
+              const cmd = process.platform === "darwin" ? `open "${loginUrl}"` : process.platform === "win32" ? `start "${loginUrl}"` : `xdg-open "${loginUrl}"`;
+              exec(cmd);
+            }).catch(() => {
+              console.log(`Open this URL in your browser:
+  ${loginUrl}`);
+            });
+          }
+        });
+        server.on("request", (req, res) => {
+          const url = new URL(req.url, `http://127.0.0.1`);
+          if (url.pathname === "/callback") {
+            const token = url.searchParams.get("token");
+            const error = url.searchParams.get("error");
+            if (error || !token) {
+              res.writeHead(200, { "Content-Type": "text/html" });
+              res.end(
+                '<html><body style="font-family:system-ui;display:flex;justify-content:center;padding-top:40vh"><div><h2>Login failed</h2><p>You can close this tab.</p></div></body></html>'
+              );
+              clearTimeout(timeout);
+              server.close();
+              reject(new Error(error ?? "No token received"));
+              return;
+            }
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end(
+              '<html><body style="font-family:system-ui;display:flex;justify-content:center;padding-top:40vh"><div><h2>Login successful!</h2><p>You can close this tab.</p></div></body></html>'
+            );
+            clearTimeout(timeout);
+            server.close();
+            resolve({ token, expiresAt: "" });
+          } else {
+            res.writeHead(404);
+            res.end();
+          }
+        });
+      });
+    },
+    async listTokens() {
+      const data = await request("/api/auth/tokens");
+      return data.tokens;
+    },
+    async revokeToken(tokenId) {
+      await request("/api/auth/tokens", {
+        method: "DELETE",
+        body: JSON.stringify({ tokenId })
+      });
+    }
+  };
+}
+
+// src/orgs.ts
+function createOrgsClient(_baseUrl, request) {
+  return {
+    async list() {
+      const data = await request("/api/orgs");
+      return data.memberships;
+    },
+    async create(input) {
+      const data = await request("/api/orgs", {
+        method: "POST",
+        body: JSON.stringify(input)
+      });
+      return data.organization;
+    },
+    async addMember(input) {
+      await request("/api/orgs/members", {
+        method: "POST",
+        body: JSON.stringify(input)
+      });
+    }
+  };
+}
+
+// src/projects.ts
+function createProjectsClient(_baseUrl, request) {
+  return {
+    async list() {
+      const data = await request("/api/projects");
+      return data.projects;
+    },
+    async create(input) {
+      const data = await request("/api/projects", {
+        method: "POST",
+        body: JSON.stringify(input)
+      });
+      return data.project;
+    },
+    async get(id) {
+      const data = await request(`/api/projects/${id}`);
+      return data.project;
+    },
+    async update(id, input) {
+      const data = await request(`/api/projects/${id}`, {
+        method: "PATCH",
+        body: JSON.stringify(input)
+      });
+      return data.project;
+    },
+    async delete(id) {
+      await request(`/api/projects/${id}`, { method: "DELETE" });
+    }
+  };
+}
+
+// src/vercel.ts
+function createVercelClient(_baseUrl, request) {
+  return {
+    async integrationStatus() {
+      return request("/api/integrations/status");
+    },
+    async disconnect() {
+      await request("/api/integrations/vercel", { method: "DELETE" });
+    },
+    async listProjects(params) {
+      const qs = new URLSearchParams();
+      if (params?.search) qs.set("search", params.search);
+      if (params?.limit) qs.set("limit", String(params.limit));
+      const query = qs.toString();
+      const data = await request(`/api/vercel/projects${query ? `?${query}` : ""}`);
+      return data.projects;
+    }
+  };
+}
+
+// src/github.ts
+function createGitHubClient(_baseUrl, request) {
+  return {
+    async listRepos(params) {
+      const qs = new URLSearchParams();
+      if (params?.page) qs.set("page", String(params.page));
+      if (params?.perPage) qs.set("per_page", String(params.perPage));
+      const query = qs.toString();
+      const data = await request(`/api/github/repos${query ? `?${query}` : ""}`);
+      return data.repos;
+    }
+  };
+}
+
+// src/index.ts
+init_credentials();
+var ViagenApiError = class extends Error {
+  constructor(status, message, detail) {
+    super(message);
+    this.status = status;
+    this.detail = detail;
+    this.name = "ViagenApiError";
+  }
+};
+function createViagen(config) {
+  const baseUrl = config.baseUrl.replace(/\/+$/, "");
+  async function request(path, options) {
+    const headers = {
+      "Content-Type": "application/json",
+      ...options?.headers
+    };
+    if (config.token) {
+      headers["Authorization"] = `Bearer ${config.token}`;
+    }
+    const res = await fetch(`${baseUrl}${path}`, {
+      ...options,
+      ...config.token ? {} : { credentials: "include" },
+      headers
+    });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      throw new ViagenApiError(res.status, body.error ?? "Request failed", body.message);
+    }
+    return res.json();
+  }
+  return {
+    auth: createAuthClient(baseUrl, request),
+    orgs: createOrgsClient(baseUrl, request),
+    projects: createProjectsClient(baseUrl, request),
+    vercel: createVercelClient(baseUrl, request),
+    github: createGitHubClient(baseUrl, request)
+  };
+}
+async function createViagenFromCredentials(overrides) {
+  const { loadCredentials: loadCredentials2 } = await Promise.resolve().then(() => (init_credentials(), credentials_exports));
+  const creds = await loadCredentials2();
+  if (!creds) return null;
+  return createViagen({
+    baseUrl: creds.baseUrl,
+    token: creds.token,
+    ...overrides
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ViagenApiError,
+  clearCredentials,
+  createViagen,
+  createViagenFromCredentials,
+  loadCredentials,
+  saveCredentials
+});

package/dist/index.d.cts

@@ -0,0 +1,189 @@
+interface Project {
+    id: string;
+    organizationId: string;
+    name: string;
+    templateId: string | null;
+    vercelProjectId: string | null;
+    githubRepo: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateProjectInput {
+    name: string;
+    templateId?: string;
+    vercelProjectId?: string;
+    githubRepo?: string;
+}
+interface UpdateProjectInput {
+    name?: string;
+    vercelProjectId?: string | null;
+    githubRepo?: string | null;
+}
+interface ProjectsClient {
+    /** List all projects in the current organization. */
+    list(): Promise<Project[]>;
+    /** Create a new project. Admin only. */
+    create(input: CreateProjectInput): Promise<Project>;
+    /** Get a single project by ID. */
+    get(id: string): Promise<Project>;
+    /** Update a project. Admin only. */
+    update(id: string, input: UpdateProjectInput): Promise<Project>;
+    /** Delete a project by ID. Admin only. */
+    delete(id: string): Promise<void>;
+}
+
+interface ViagenUser {
+    id: string;
+    email: string;
+    name: string | null;
+    avatarUrl: string | null;
+}
+interface OrgInfo {
+    id: string;
+    name: string;
+    role: string;
+}
+interface AuthResult {
+    authenticated: true;
+    user: ViagenUser;
+    organizations: OrgInfo[];
+}
+interface ApiTokenInfo {
+    id: string;
+    name: string;
+    prefix: string;
+    expiresAt: string;
+    lastUsedAt: string | null;
+    createdAt: string;
+}
+interface AuthClient {
+    /** Redirect the browser to a provider login page. (Web only) */
+    login(provider?: 'google' | 'github' | 'microsoft'): void;
+    /** Get the current authenticated user. Works with both cookie and token auth. */
+    me(): Promise<(ViagenUser & {
+        organizations: OrgInfo[];
+    }) | null>;
+    /** Log out the current user. In a browser, reloads the page. */
+    logout(): Promise<void>;
+    /**
+     * CLI login: opens browser to authorize page, starts localhost server, captures token.
+     * Only available in Node.js environments.
+     */
+    loginCli(options?: {
+        port?: number;
+        onOpenUrl?: (url: string) => void;
+    }): Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+    /** List the current user's API tokens. */
+    listTokens(): Promise<ApiTokenInfo[]>;
+    /** Revoke an API token by its hashed ID. */
+    revokeToken(tokenId: string): Promise<void>;
+}
+
+interface OrgMembership {
+    id: string;
+    organizationId: string;
+    organizationName: string;
+    role: string | undefined;
+    status: string;
+}
+interface Org {
+    id: string;
+    name: string;
+}
+interface OrgsClient {
+    /** List the current user's organization memberships. */
+    list(): Promise<OrgMembership[]>;
+    /** Create a new organization. The current user becomes admin. */
+    create(input: {
+        name: string;
+    }): Promise<Org>;
+    /** Add a member by email to the current organization. Admin only. */
+    addMember(input: {
+        email: string;
+    }): Promise<void>;
+}
+
+interface VercelProject {
+    id: string;
+    name: string;
+    framework: string | null;
+    link?: {
+        type: string;
+        org: string;
+        repo: string;
+        productionBranch: string;
+    };
+}
+interface VercelListProjectsParams {
+    search?: string;
+    limit?: number;
+}
+interface IntegrationStatus {
+    github: boolean;
+    vercel: boolean;
+}
+interface VercelClient {
+    /** Check integration connection status for the current org. */
+    integrationStatus(): Promise<IntegrationStatus>;
+    /** Disconnect the org's Vercel integration. Admin only. */
+    disconnect(): Promise<void>;
+    /** List Vercel projects for the org. */
+    listProjects(params?: VercelListProjectsParams): Promise<VercelProject[]>;
+}
+
+interface GitHubRepo {
+    id: number;
+    fullName: string;
+    name: string;
+    owner: string;
+    private: boolean;
+    defaultBranch: string;
+    url: string;
+}
+interface GitHubListReposParams {
+    page?: number;
+    perPage?: number;
+}
+interface GitHubClient {
+    /** List GitHub repos accessible to the org's connected GitHub account. */
+    listRepos(params?: GitHubListReposParams): Promise<GitHubRepo[]>;
+}
+
+interface StoredCredentials {
+    token: string;
+    baseUrl: string;
+    expiresAt?: string;
+}
+declare function loadCredentials(): Promise<StoredCredentials | null>;
+declare function saveCredentials(creds: StoredCredentials): Promise<void>;
+declare function clearCredentials(): Promise<void>;
+
+interface ViagenConfig {
+    baseUrl: string;
+    /** API token for CLI/server-side usage. When set, uses Bearer auth instead of cookies. */
+    token?: string;
+}
+interface ViagenClient {
+    auth: AuthClient;
+    orgs: OrgsClient;
+    projects: ProjectsClient;
+    vercel: VercelClient;
+    github: GitHubClient;
+}
+declare class ViagenApiError extends Error {
+    status: number;
+    detail?: string | undefined;
+    constructor(status: number, message: string, detail?: string | undefined);
+}
+type RequestFn = <T>(path: string, options?: RequestInit) => Promise<T>;
+declare function createViagen(config: ViagenConfig): ViagenClient;
+/**
+ * Create a Viagen client from stored CLI credentials.
+ * Returns null if no credentials are stored.
+ */
+declare function createViagenFromCredentials(overrides?: Partial<ViagenConfig>): Promise<ViagenClient | null>;
+
+export { type ApiTokenInfo, type AuthClient, type AuthResult, type CreateProjectInput, type GitHubClient, type GitHubListReposParams, type GitHubRepo, type IntegrationStatus, type Org, type OrgInfo, type OrgMembership, type OrgsClient, type Project, type ProjectsClient, type RequestFn, type StoredCredentials, type UpdateProjectInput, type VercelClient, type VercelListProjectsParams, type VercelProject, ViagenApiError, type ViagenClient, type ViagenConfig, type ViagenUser, clearCredentials, createViagen, createViagenFromCredentials, loadCredentials, saveCredentials };

package/dist/index.d.ts

@@ -0,0 +1,189 @@
+interface Project {
+    id: string;
+    organizationId: string;
+    name: string;
+    templateId: string | null;
+    vercelProjectId: string | null;
+    githubRepo: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateProjectInput {
+    name: string;
+    templateId?: string;
+    vercelProjectId?: string;
+    githubRepo?: string;
+}
+interface UpdateProjectInput {
+    name?: string;
+    vercelProjectId?: string | null;
+    githubRepo?: string | null;
+}
+interface ProjectsClient {
+    /** List all projects in the current organization. */
+    list(): Promise<Project[]>;
+    /** Create a new project. Admin only. */
+    create(input: CreateProjectInput): Promise<Project>;
+    /** Get a single project by ID. */
+    get(id: string): Promise<Project>;
+    /** Update a project. Admin only. */
+    update(id: string, input: UpdateProjectInput): Promise<Project>;
+    /** Delete a project by ID. Admin only. */
+    delete(id: string): Promise<void>;
+}
+
+interface ViagenUser {
+    id: string;
+    email: string;
+    name: string | null;
+    avatarUrl: string | null;
+}
+interface OrgInfo {
+    id: string;
+    name: string;
+    role: string;
+}
+interface AuthResult {
+    authenticated: true;
+    user: ViagenUser;
+    organizations: OrgInfo[];
+}
+interface ApiTokenInfo {
+    id: string;
+    name: string;
+    prefix: string;
+    expiresAt: string;
+    lastUsedAt: string | null;
+    createdAt: string;
+}
+interface AuthClient {
+    /** Redirect the browser to a provider login page. (Web only) */
+    login(provider?: 'google' | 'github' | 'microsoft'): void;
+    /** Get the current authenticated user. Works with both cookie and token auth. */
+    me(): Promise<(ViagenUser & {
+        organizations: OrgInfo[];
+    }) | null>;
+    /** Log out the current user. In a browser, reloads the page. */
+    logout(): Promise<void>;
+    /**
+     * CLI login: opens browser to authorize page, starts localhost server, captures token.
+     * Only available in Node.js environments.
+     */
+    loginCli(options?: {
+        port?: number;
+        onOpenUrl?: (url: string) => void;
+    }): Promise<{
+        token: string;
+        expiresAt: string;
+    }>;
+    /** List the current user's API tokens. */
+    listTokens(): Promise<ApiTokenInfo[]>;
+    /** Revoke an API token by its hashed ID. */
+    revokeToken(tokenId: string): Promise<void>;
+}
+
+interface OrgMembership {
+    id: string;
+    organizationId: string;
+    organizationName: string;
+    role: string | undefined;
+    status: string;
+}
+interface Org {
+    id: string;
+    name: string;
+}
+interface OrgsClient {
+    /** List the current user's organization memberships. */
+    list(): Promise<OrgMembership[]>;
+    /** Create a new organization. The current user becomes admin. */
+    create(input: {
+        name: string;
+    }): Promise<Org>;
+    /** Add a member by email to the current organization. Admin only. */
+    addMember(input: {
+        email: string;
+    }): Promise<void>;
+}
+
+interface VercelProject {
+    id: string;
+    name: string;
+    framework: string | null;
+    link?: {
+        type: string;
+        org: string;
+        repo: string;
+        productionBranch: string;
+    };
+}
+interface VercelListProjectsParams {
+    search?: string;
+    limit?: number;
+}
+interface IntegrationStatus {
+    github: boolean;
+    vercel: boolean;
+}
+interface VercelClient {
+    /** Check integration connection status for the current org. */
+    integrationStatus(): Promise<IntegrationStatus>;
+    /** Disconnect the org's Vercel integration. Admin only. */
+    disconnect(): Promise<void>;
+    /** List Vercel projects for the org. */
+    listProjects(params?: VercelListProjectsParams): Promise<VercelProject[]>;
+}
+
+interface GitHubRepo {
+    id: number;
+    fullName: string;
+    name: string;
+    owner: string;
+    private: boolean;
+    defaultBranch: string;
+    url: string;
+}
+interface GitHubListReposParams {
+    page?: number;
+    perPage?: number;
+}
+interface GitHubClient {
+    /** List GitHub repos accessible to the org's connected GitHub account. */
+    listRepos(params?: GitHubListReposParams): Promise<GitHubRepo[]>;
+}
+
+interface StoredCredentials {
+    token: string;
+    baseUrl: string;
+    expiresAt?: string;
+}
+declare function loadCredentials(): Promise<StoredCredentials | null>;
+declare function saveCredentials(creds: StoredCredentials): Promise<void>;
+declare function clearCredentials(): Promise<void>;
+
+interface ViagenConfig {
+    baseUrl: string;
+    /** API token for CLI/server-side usage. When set, uses Bearer auth instead of cookies. */
+    token?: string;
+}
+interface ViagenClient {
+    auth: AuthClient;
+    orgs: OrgsClient;
+    projects: ProjectsClient;
+    vercel: VercelClient;
+    github: GitHubClient;
+}
+declare class ViagenApiError extends Error {
+    status: number;
+    detail?: string | undefined;
+    constructor(status: number, message: string, detail?: string | undefined);
+}
+type RequestFn = <T>(path: string, options?: RequestInit) => Promise<T>;
+declare function createViagen(config: ViagenConfig): ViagenClient;
+/**
+ * Create a Viagen client from stored CLI credentials.
+ * Returns null if no credentials are stored.
+ */
+declare function createViagenFromCredentials(overrides?: Partial<ViagenConfig>): Promise<ViagenClient | null>;
+
+export { type ApiTokenInfo, type AuthClient, type AuthResult, type CreateProjectInput, type GitHubClient, type GitHubListReposParams, type GitHubRepo, type IntegrationStatus, type Org, type OrgInfo, type OrgMembership, type OrgsClient, type Project, type ProjectsClient, type RequestFn, type StoredCredentials, type UpdateProjectInput, type VercelClient, type VercelListProjectsParams, type VercelProject, ViagenApiError, type ViagenClient, type ViagenConfig, type ViagenUser, clearCredentials, createViagen, createViagenFromCredentials, loadCredentials, saveCredentials };

package/dist/index.js

@@ -0,0 +1,238 @@
+import {
+  clearCredentials,
+  loadCredentials,
+  saveCredentials
+} from "./chunk-TG7LNDF6.js";
+
+// src/auth.ts
+function createAuthClient(baseUrl, request) {
+  return {
+    login(provider = "github") {
+      window.location.href = `${baseUrl}/api/auth/login/${provider}`;
+    },
+    async me() {
+      try {
+        const data = await request("/api/auth/me");
+        if (!data.authenticated) return null;
+        return { ...data.user, organizations: data.organizations };
+      } catch {
+        return null;
+      }
+    },
+    async logout() {
+      await request("/api/auth/logout", { method: "POST" });
+      if (typeof window !== "undefined") {
+        window.location.reload();
+      }
+    },
+    async loginCli(options = {}) {
+      const { port: preferredPort, onOpenUrl } = options;
+      const http = await import("http");
+      return new Promise((resolve, reject) => {
+        const server = http.createServer();
+        const timeout = setTimeout(() => {
+          server.close();
+          reject(new Error("Login timed out"));
+        }, 5 * 60 * 1e3);
+        server.listen(preferredPort ?? 0, "127.0.0.1", () => {
+          const address = server.address();
+          const port = address.port;
+          const loginUrl = `${baseUrl}/cli/authorize?port=${port}`;
+          if (onOpenUrl) {
+            onOpenUrl(loginUrl);
+          } else {
+            import("child_process").then(({ exec }) => {
+              const cmd = process.platform === "darwin" ? `open "${loginUrl}"` : process.platform === "win32" ? `start "${loginUrl}"` : `xdg-open "${loginUrl}"`;
+              exec(cmd);
+            }).catch(() => {
+              console.log(`Open this URL in your browser:
+  ${loginUrl}`);
+            });
+          }
+        });
+        server.on("request", (req, res) => {
+          const url = new URL(req.url, `http://127.0.0.1`);
+          if (url.pathname === "/callback") {
+            const token = url.searchParams.get("token");
+            const error = url.searchParams.get("error");
+            if (error || !token) {
+              res.writeHead(200, { "Content-Type": "text/html" });
+              res.end(
+                '<html><body style="font-family:system-ui;display:flex;justify-content:center;padding-top:40vh"><div><h2>Login failed</h2><p>You can close this tab.</p></div></body></html>'
+              );
+              clearTimeout(timeout);
+              server.close();
+              reject(new Error(error ?? "No token received"));
+              return;
+            }
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end(
+              '<html><body style="font-family:system-ui;display:flex;justify-content:center;padding-top:40vh"><div><h2>Login successful!</h2><p>You can close this tab.</p></div></body></html>'
+            );
+            clearTimeout(timeout);
+            server.close();
+            resolve({ token, expiresAt: "" });
+          } else {
+            res.writeHead(404);
+            res.end();
+          }
+        });
+      });
+    },
+    async listTokens() {
+      const data = await request("/api/auth/tokens");
+      return data.tokens;
+    },
+    async revokeToken(tokenId) {
+      await request("/api/auth/tokens", {
+        method: "DELETE",
+        body: JSON.stringify({ tokenId })
+      });
+    }
+  };
+}
+
+// src/orgs.ts
+function createOrgsClient(_baseUrl, request) {
+  return {
+    async list() {
+      const data = await request("/api/orgs");
+      return data.memberships;
+    },
+    async create(input) {
+      const data = await request("/api/orgs", {
+        method: "POST",
+        body: JSON.stringify(input)
+      });
+      return data.organization;
+    },
+    async addMember(input) {
+      await request("/api/orgs/members", {
+        method: "POST",
+        body: JSON.stringify(input)
+      });
+    }
+  };
+}
+
+// src/projects.ts
+function createProjectsClient(_baseUrl, request) {
+  return {
+    async list() {
+      const data = await request("/api/projects");
+      return data.projects;
+    },
+    async create(input) {
+      const data = await request("/api/projects", {
+        method: "POST",
+        body: JSON.stringify(input)
+      });
+      return data.project;
+    },
+    async get(id) {
+      const data = await request(`/api/projects/${id}`);
+      return data.project;
+    },
+    async update(id, input) {
+      const data = await request(`/api/projects/${id}`, {
+        method: "PATCH",
+        body: JSON.stringify(input)
+      });
+      return data.project;
+    },
+    async delete(id) {
+      await request(`/api/projects/${id}`, { method: "DELETE" });
+    }
+  };
+}
+
+// src/vercel.ts
+function createVercelClient(_baseUrl, request) {
+  return {
+    async integrationStatus() {
+      return request("/api/integrations/status");
+    },
+    async disconnect() {
+      await request("/api/integrations/vercel", { method: "DELETE" });
+    },
+    async listProjects(params) {
+      const qs = new URLSearchParams();
+      if (params?.search) qs.set("search", params.search);
+      if (params?.limit) qs.set("limit", String(params.limit));
+      const query = qs.toString();
+      const data = await request(`/api/vercel/projects${query ? `?${query}` : ""}`);
+      return data.projects;
+    }
+  };
+}
+
+// src/github.ts
+function createGitHubClient(_baseUrl, request) {
+  return {
+    async listRepos(params) {
+      const qs = new URLSearchParams();
+      if (params?.page) qs.set("page", String(params.page));
+      if (params?.perPage) qs.set("per_page", String(params.perPage));
+      const query = qs.toString();
+      const data = await request(`/api/github/repos${query ? `?${query}` : ""}`);
+      return data.repos;
+    }
+  };
+}
+
+// src/index.ts
+var ViagenApiError = class extends Error {
+  constructor(status, message, detail) {
+    super(message);
+    this.status = status;
+    this.detail = detail;
+    this.name = "ViagenApiError";
+  }
+};
+function createViagen(config) {
+  const baseUrl = config.baseUrl.replace(/\/+$/, "");
+  async function request(path, options) {
+    const headers = {
+      "Content-Type": "application/json",
+      ...options?.headers
+    };
+    if (config.token) {
+      headers["Authorization"] = `Bearer ${config.token}`;
+    }
+    const res = await fetch(`${baseUrl}${path}`, {
+      ...options,
+      ...config.token ? {} : { credentials: "include" },
+      headers
+    });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      throw new ViagenApiError(res.status, body.error ?? "Request failed", body.message);
+    }
+    return res.json();
+  }
+  return {
+    auth: createAuthClient(baseUrl, request),
+    orgs: createOrgsClient(baseUrl, request),
+    projects: createProjectsClient(baseUrl, request),
+    vercel: createVercelClient(baseUrl, request),
+    github: createGitHubClient(baseUrl, request)
+  };
+}
+async function createViagenFromCredentials(overrides) {
+  const { loadCredentials: loadCredentials2 } = await import("./credentials-44RC7NYI.js");
+  const creds = await loadCredentials2();
+  if (!creds) return null;
+  return createViagen({
+    baseUrl: creds.baseUrl,
+    token: creds.token,
+    ...overrides
+  });
+}
+export {
+  ViagenApiError,
+  clearCredentials,
+  createViagen,
+  createViagenFromCredentials,
+  loadCredentials,
+  saveCredentials
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "viagen-sdk",
+  "version": "0.0.0",
+  "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"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  }
+}