da-proj 1.0.0

package/src/generators/workflow.ts

@@ -0,0 +1,69 @@
+// Generar workflow de GitHub Actions
+export function generateWorkflow(): string {
+  return `name: Sync to Portfolio
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - '.project-metadata.mdx'
+      - 'proj-images/**'
+  workflow_dispatch:
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+      
+      - name: Extract metadata
+        id: metadata
+        run: |
+          bun install gray-matter
+          bun run -e "
+          import matter from 'gray-matter';
+          import { readFileSync } from 'fs';
+          
+          const content = readFileSync('.project-metadata.mdx', 'utf8');
+          const { data, content: markdown } = matter(content);
+          
+          data.repository = {
+            owner: process.env.GITHUB_REPOSITORY.split('/')[0],
+            name: process.env.GITHUB_REPOSITORY.split('/')[1],
+            url: \`https://github.com/\${process.env.GITHUB_REPOSITORY}\`
+          };
+          data.lastCommit = process.env.GITHUB_SHA;
+          data.lastUpdated = new Date().toISOString();
+          
+          console.log('METADATA=' + JSON.stringify({ metadata: data, markdown }));
+          " > output.txt
+          
+          METADATA=$(cat output.txt | grep METADATA | cut -d'=' -f2-)
+          echo "data<<EOF" >> $GITHUB_OUTPUT
+          echo "$METADATA" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+      
+      - name: Notify Portfolio
+        env:
+          PORTFOLIO_API_URL: \${{ secrets.PORTFOLIO_API_URL }}
+          PORTFOLIO_API_KEY: \${{ secrets.PORTFOLIO_API_KEY }}
+        run: |
+          curl -X POST "$PORTFOLIO_API_URL/api/update-project" \\
+            -H "Content-Type: application/json" \\
+            -H "Authorization: Bearer $PORTFOLIO_API_KEY" \\
+            -d '\${{ steps.metadata.outputs.data }}'
+      
+      - name: Create deployment badge
+        if: success()
+        run: |
+          echo "![Synced to Portfolio](https://img.shields.io/badge/portfolio-synced-success)" >> $GITHUB_STEP_SUMMARY
+          echo "Last sync: $(date)" >> $GITHUB_STEP_SUMMARY
+`;
+}

package/src/index.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env bun
+
+import { parseArgs } from "util";
+import { initCommand } from "./commands/init.js";
+import { pullCommand } from "./commands/pull.js";
+import { pushCommand } from "./commands/push.js";
+import { secretsCommand } from "./commands/secrets.js";
+import { setupGitHubSyncCommand } from "./commands/setup-github-sync.js";
+import { syncStatusCommand } from "./commands/sync-status.js";
+import { syncCommand } from "./commands/sync.js";
+import { colors } from "./utils/logger.js";
+
+async function main() {
+  const args = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      help: { type: "boolean", short: "h" },
+      init: { type: "boolean", short: "i" },
+      portfolio: { type: "string", short: "p" },
+      secrets: { type: "boolean", short: "s" },
+      sync: { type: "boolean" },
+      "setup-github-sync": { type: "boolean" },
+      push: { type: "boolean" },
+      pull: { type: "boolean" },
+      "sync-status": { type: "boolean" },
+    },
+    allowPositionals: true,
+  });
+
+  if (args.values.help) {
+    console.log(`
+${colors.bright}da-proj${colors.reset} - CLI tool to setup portfolio project metadata
+
+${colors.bright}USAGE:${colors.reset}
+  bunx da-proj [options]
+
+${colors.bright}OPTIONS:${colors.reset}
+  -i, --init              Initialize project metadata
+  -s, --secrets           Configure GitHub secrets (requires GitHub CLI)
+  --sync                  Sync configuration across computers
+  -p, --portfolio <url>   Portfolio API URL
+  -h, --help              Show this help message
+
+${colors.bright}GITHUB SYNC:${colors.reset}
+  --setup-github-sync     Setup GitHub repository for config sync
+  --push                  Upload local configuration to GitHub
+  --pull                  Download configuration from GitHub
+  --sync-status           Check synchronization status
+
+${colors.bright}EXAMPLES:${colors.reset}
+  bunx da-proj --init
+  bunx da-proj --secrets
+  bunx da-proj --setup-github-sync
+  bunx da-proj --push
+  bunx da-proj --pull
+  bunx da-proj --sync-status
+    `);
+    process.exit(0);
+  }
+
+  // GitHub sync commands
+  if (args.values["setup-github-sync"]) {
+    await setupGitHubSyncCommand();
+    process.exit(0);
+  }
+
+  if (args.values.push) {
+    await pushCommand();
+    process.exit(0);
+  }
+
+  if (args.values.pull) {
+    await pullCommand();
+    process.exit(0);
+  }
+
+  if (args.values["sync-status"]) {
+    await syncStatusCommand();
+    process.exit(0);
+  }
+
+  // Si se usa --secrets, configurar secrets y salir
+  if (args.values.secrets) {
+    await secretsCommand();
+    process.exit(0);
+  }
+
+  // Si se usa --sync, sincronizar configuración
+  if (args.values.sync) {
+    await syncCommand();
+    process.exit(0);
+  }
+
+  // Por defecto o con --init, ejecutar comando init
+  await initCommand();
+}
+
+main().catch(console.error);

package/src/types/index.ts

@@ -0,0 +1,47 @@
+// Tipos para el proyecto
+export interface ProjectMetadata {
+  title: string;
+  category: string;
+  type: "featured" | "small";
+  status: "active" | "archived" | "in-progress";
+  age?: string;
+  repository?: string;
+  demo?: string;
+  technologies: string[];
+  images: {
+    cover: string;
+    gallery: string[];
+  };
+  industry?: string;
+  timeline?: string;
+  details?: string[];
+}
+
+export interface Profile {
+  name: string;
+  portfolioUrl: string;
+  apiKey: string;
+}
+
+export interface Config {
+  profiles?: Profile[];
+}
+
+export interface ExistingSecrets {
+  url: boolean;
+  key: boolean;
+}
+
+// GitHub sync types
+export interface GitHubSyncConfig {
+  repoUrl: string;
+  repoName: string;
+  repoOwner: string;
+}
+
+export interface GitHubRepo {
+  name: string;
+  url: string;
+  description?: string;
+  private: boolean;
+}

package/src/utils/config.ts

@@ -0,0 +1,52 @@
+import { readFile, writeFile } from "fs/promises";
+import { existsSync } from "fs";
+import type { Config, Profile } from "../types/index.js";
+import { log } from "./logger.js";
+
+// Obtener ruta del archivo de configuración global
+export function getConfigPath(): string {
+  const homeDir = process.env.USERPROFILE || process.env.HOME || '';
+  return `${homeDir}/.da-proj-config.json`;
+}
+
+// Leer configuración global
+export async function readGlobalConfig(): Promise<Config> {
+  try {
+    const configPath = getConfigPath();
+    if (existsSync(configPath)) {
+      const content = await readFile(configPath, 'utf-8');
+      return JSON.parse(content);
+    }
+  } catch (error) {
+    // Si hay error, retornar objeto vacío
+  }
+  return { profiles: [] };
+}
+
+// Guardar configuración global
+export async function saveGlobalConfig(profile: Profile): Promise<void> {
+  try {
+    const configPath = getConfigPath();
+    const config = await readGlobalConfig();
+    
+    if (!config.profiles) {
+      config.profiles = [];
+    }
+    
+    // Buscar si ya existe un perfil con ese nombre
+    const existingIndex = config.profiles.findIndex(p => p.name === profile.name);
+    
+    if (existingIndex >= 0) {
+      // Actualizar existente
+      config.profiles[existingIndex] = profile;
+    } else {
+      // Agregar nuevo
+      config.profiles.push(profile);
+    }
+    
+    await writeFile(configPath, JSON.stringify(config, null, 2));
+    log.success(`Configuration saved to ${configPath}`);
+  } catch (error: any) {
+    log.warn(`Could not save config: ${error.message}`);
+  }
+}

package/src/utils/github-config.ts

@@ -0,0 +1,67 @@
+import { existsSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+
+/**
+ * Configuration for GitHub sync
+ */
+export interface GitHubSyncConfig {
+  repoUrl: string; // "https://github.com/user/da-proj-secrets"
+  repoName: string; // "da-proj-secrets"
+  repoOwner: string; // "user"
+}
+
+/**
+ * Get path to GitHub sync configuration file
+ */
+export function getGitHubSyncConfigPath(): string {
+  const homeDir = process.env.USERPROFILE || process.env.HOME || "";
+  return `${homeDir}/.da-proj-github-config`;
+}
+
+/**
+ * Check if GitHub sync is configured
+ */
+export function isGitHubSyncConfigured(): boolean {
+  const configPath = getGitHubSyncConfigPath();
+  return existsSync(configPath);
+}
+
+/**
+ * Read GitHub sync configuration
+ */
+export async function readGitHubSyncConfig(): Promise<GitHubSyncConfig | null> {
+  try {
+    const configPath = getGitHubSyncConfigPath();
+
+    if (!existsSync(configPath)) {
+      return null;
+    }
+
+    const content = await readFile(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Save GitHub sync configuration
+ */
+export async function saveGitHubSyncConfig(
+  config: GitHubSyncConfig
+): Promise<void> {
+  const configPath = getGitHubSyncConfigPath();
+  await writeFile(configPath, JSON.stringify(config, null, 2));
+}
+
+/**
+ * Delete GitHub sync configuration
+ */
+export async function deleteGitHubSyncConfig(): Promise<void> {
+  const configPath = getGitHubSyncConfigPath();
+
+  if (existsSync(configPath)) {
+    const fs = await import("fs/promises");
+    await fs.unlink(configPath);
+  }
+}

package/src/utils/github.ts

@@ -0,0 +1,297 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import type { ExistingSecrets, GitHubRepo } from "../types/index.js";
+import { log } from "./logger.js";
+
+const execAsync = promisify(exec);
+
+// ============================================================================
+// GitHub CLI Utilities
+// ============================================================================
+
+/**
+ * Check if GitHub CLI is installed
+ */
+export async function checkGitHubCLI(): Promise<boolean> {
+  try {
+    await execAsync("gh --version");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get GitHub username from authenticated GitHub CLI
+ */
+export async function getGitHubUsername(): Promise<string> {
+  try {
+    const { stdout } = await execAsync("gh api user --jq .login");
+    return stdout.trim();
+  } catch (error: any) {
+    throw new Error(`Failed to get GitHub username: ${error.message}`);
+  }
+}
+
+// ============================================================================
+// GitHub Secrets (for repository secrets)
+// ============================================================================
+
+/**
+ * Check if a secret exists in the repository
+ */
+export async function checkSecretExists(secretName: string): Promise<boolean> {
+  try {
+    const { stdout } = await execAsync("gh secret list");
+    return stdout.includes(secretName);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get information about existing secrets
+ */
+export async function getExistingSecrets(): Promise<ExistingSecrets> {
+  const urlExists = await checkSecretExists("PORTFOLIO_API_URL");
+  const keyExists = await checkSecretExists("PORTFOLIO_API_KEY");
+  return { url: urlExists, key: keyExists };
+}
+
+/**
+ * Set a GitHub secret
+ */
+export async function setGitHubSecret(
+  name: string,
+  value: string
+): Promise<void> {
+  await execAsync(`gh secret set ${name} --body "${value}"`);
+}
+
+// ============================================================================
+// GitHub Repository Management
+// ============================================================================
+
+/**
+ * Create a private repository using GitHub CLI
+ */
+export async function createPrivateRepo(repoName: string): Promise<string> {
+  try {
+    // Create private repo with description
+    await execAsync(
+      `gh repo create ${repoName} --private --description "da-proj configuration sync"`
+    );
+
+    const username = await getGitHubUsername();
+    const repoUrl = `https://github.com/${username}/${repoName}`;
+
+    log.success(`Created private repository: ${repoName}`);
+    return repoUrl;
+  } catch (error: any) {
+    throw new Error(`Failed to create repository: ${error.message}`);
+  }
+}
+
+/**
+ * List all private repositories for the authenticated user
+ */
+export async function listPrivateRepos(): Promise<GitHubRepo[]> {
+  try {
+    const { stdout } = await execAsync(
+      "gh repo list --json name,url,description,isPrivate --limit 100"
+    );
+
+    const repos = JSON.parse(stdout);
+
+    // Filter only private repos
+    return repos
+      .filter((repo: any) => repo.isPrivate)
+      .map((repo: any) => ({
+        name: repo.name,
+        url: repo.url,
+        description: repo.description || undefined,
+        private: repo.isPrivate,
+      }));
+  } catch (error: any) {
+    throw new Error(`Failed to list repositories: ${error.message}`);
+  }
+}
+
+/**
+ * Check if a repository exists
+ */
+export async function checkRepoExists(repoUrl: string): Promise<boolean> {
+  try {
+    const match = repoUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+    if (!match) {
+      return false;
+    }
+
+    const [, owner, repo] = match;
+
+    await execAsync(`gh api repos/${owner}/${repo}`);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ============================================================================
+// GitHub API File Operations
+// ============================================================================
+
+/**
+ * Upload a file to GitHub repository using GitHub API
+ */
+export async function uploadFile(
+  repoUrl: string,
+  filePath: string,
+  content: string
+): Promise<void> {
+  try {
+    // Extract owner and repo from URL
+    const match = repoUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+    if (!match) {
+      throw new Error("Invalid repository URL");
+    }
+
+    const [, owner, repo] = match;
+
+    // Encode content to base64
+    const base64Content = Buffer.from(content).toString("base64");
+
+    // Check if file exists to get SHA (required for updates)
+    let sha: string | undefined;
+    try {
+      const { stdout: existingFile } = await execAsync(
+        `gh api repos/${owner}/${repo}/contents/${filePath} --jq .sha`
+      );
+      sha = existingFile.trim();
+    } catch {
+      // File doesn't exist, that's okay
+    }
+
+    // Upload using GitHub CLI
+    await execAsync(
+      `gh api repos/${owner}/${repo}/contents/${filePath} -X PUT -f message="Update ${filePath}" -f content="${base64Content}"${
+        sha ? ` -f sha="${sha}"` : ""
+      }`
+    );
+
+    log.success(`Uploaded ${filePath} to ${owner}/${repo}`);
+  } catch (error: any) {
+    throw new Error(`Failed to upload file: ${error.message}`);
+  }
+}
+
+/**
+ * Download a file from GitHub repository using GitHub API
+ */
+export async function downloadFile(
+  repoUrl: string,
+  filePath: string
+): Promise<string> {
+  try {
+    // Extract owner and repo from URL
+    const match = repoUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+    if (!match) {
+      throw new Error("Invalid repository URL");
+    }
+
+    const [, owner, repo] = match;
+
+    // Download file content
+    const { stdout } = await execAsync(
+      `gh api repos/${owner}/${repo}/contents/${filePath} --jq .content`
+    );
+
+    // Decode from base64
+    const base64Content = stdout.trim();
+    const content = Buffer.from(base64Content, "base64").toString("utf-8");
+
+    return content;
+  } catch (error: any) {
+    if (error.message.includes("404")) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    throw new Error(`Failed to download file: ${error.message}`);
+  }
+}
+
+/**
+ * Get the SHA of a file in the repository (needed for updates)
+ */
+export async function getFileSha(
+  repoUrl: string,
+  filePath: string
+): Promise<string | null> {
+  try {
+    const match = repoUrl.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+    if (!match) {
+      throw new Error("Invalid repository URL");
+    }
+
+    const [, owner, repo] = match;
+
+    const { stdout } = await execAsync(
+      `gh api repos/${owner}/${repo}/contents/${filePath} --jq .sha`
+    );
+
+    return stdout.trim();
+  } catch (error: any) {
+    if (error.message.includes("404")) {
+      return null; // File doesn't exist
+    }
+    throw new Error(`Failed to get file SHA: ${error.message}`);
+  }
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+/**
+ * Generate README.md content for the secrets repository
+ */
+export function generateSecretsRepoReadme(): string {
+  return `# da-proj Configuration Sync
+
+This repository stores your \`da-proj\` configuration for synchronization across devices.
+
+## What's stored here?
+
+- \`da-proj-config.json\` - Your portfolio profiles (API keys and URLs)
+
+## Security
+
+⚠️ **This repository is PRIVATE** - Keep it that way!
+
+This file contains sensitive API keys. Never make this repository public.
+
+## Usage
+
+This repository is managed automatically by \`da-proj\` CLI:
+
+\`\`\`bash
+# Upload your local configuration
+bunx da-proj --push
+
+# Download configuration to a new device
+bunx da-proj --pull
+
+# Check sync status
+bunx da-proj --sync-status
+\`\`\`
+
+## Manual Access
+
+If you need to manually edit the configuration:
+
+1. Edit \`da-proj-config.json\` in this repository
+2. Run \`bunx da-proj --pull\` on your device to download changes
+
+---
+
+🔐 Generated by [da-proj](https://github.com/your-username/da-proj)
+`;
+}

package/src/utils/logger.ts

@@ -0,0 +1,20 @@
+// Colores para la terminal
+const colors = {
+  reset: "\x1b[0m",
+  bright: "\x1b[1m",
+  green: "\x1b[32m",
+  blue: "\x1b[34m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+};
+
+export const log = {
+  success: (msg: string) => console.log(`${colors.green}✓${colors.reset} ${msg}`),
+  error: (msg: string) => console.log(`${colors.red}✗${colors.reset} ${msg}`),
+  info: (msg: string) => console.log(`${colors.blue}ℹ${colors.reset} ${msg}`),
+  warn: (msg: string) => console.log(`${colors.yellow}⚠${colors.reset} ${msg}`),
+  title: (msg: string) => console.log(`\n${colors.bright}${colors.cyan}${msg}${colors.reset}\n`),
+};
+
+export { colors };