@hasna/microservices 0.0.16 → 0.0.17

package/microservices/microservice-documents/package.json

@@ -1,28 +0,0 @@
-{
-  "name": "@hasna/microservice-documents",
-  "version": "0.0.1",
-  "description": "Document management microservice with SQLite — manage documents, versions, and tags",
-  "type": "module",
-  "bin": {
-    "microservice-documents": "./src/cli/index.ts",
-    "microservice-documents-mcp": "./src/mcp/index.ts"
-  },
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run ./src/cli/index.ts",
-    "test": "bun test"
-  },
-  "dependencies": {
-    "@hasna/cloud": "^0.1.24",
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "commander": "^12.1.0",
-    "zod": "^3.24.0"
-  },
-  "license": "Apache-2.0",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
-  }
-}

package/microservices/microservice-documents/src/cli/index.ts

@@ -1,246 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import {
-  createDocument,
-  getDocument,
-  listDocuments,
-  updateDocument,
-  deleteDocument,
-  countDocuments,
-  searchDocuments,
-  addVersion,
-  listVersions,
-} from "../db/documents.js";
-
-const program = new Command();
-
-program
-  .name("microservice-documents")
-  .description("Document management microservice")
-  .version("0.0.1");
-
-// --- Documents ---
-
-program
-  .command("add")
-  .description("Add a new document")
-  .requiredOption("--title <title>", "Document title")
-  .option("--description <text>", "Description")
-  .option("--file-path <path>", "File path")
-  .option("--file-type <type>", "File type (e.g. pdf, docx)")
-  .option("--file-size <bytes>", "File size in bytes")
-  .option("--status <status>", "Status: draft|active|archived", "draft")
-  .option("--tags <tags>", "Comma-separated tags")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const doc = createDocument({
-      title: opts.title,
-      description: opts.description,
-      file_path: opts.filePath,
-      file_type: opts.fileType,
-      file_size: opts.fileSize ? parseInt(opts.fileSize) : undefined,
-      status: opts.status,
-      tags: opts.tags ? opts.tags.split(",").map((t: string) => t.trim()) : undefined,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(doc, null, 2));
-    } else {
-      console.log(`Created document: ${doc.title} (${doc.id})`);
-    }
-  });
-
-program
-  .command("get")
-  .description("Get a document by ID")
-  .argument("<id>", "Document ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const doc = getDocument(id);
-    if (!doc) {
-      console.error(`Document '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(doc, null, 2));
-    } else {
-      console.log(`${doc.title}`);
-      console.log(`  Status:  ${doc.status}`);
-      console.log(`  Version: ${doc.version}`);
-      if (doc.description) console.log(`  Description: ${doc.description}`);
-      if (doc.file_path) console.log(`  File: ${doc.file_path}`);
-      if (doc.file_type) console.log(`  Type: ${doc.file_type}`);
-      if (doc.file_size) console.log(`  Size: ${doc.file_size} bytes`);
-      if (doc.tags.length) console.log(`  Tags: ${doc.tags.join(", ")}`);
-    }
-  });
-
-program
-  .command("list")
-  .description("List documents")
-  .option("--search <query>", "Search by title or description")
-  .option("--type <type>", "Filter by file type")
-  .option("--status <status>", "Filter by status")
-  .option("--tag <tag>", "Filter by tag")
-  .option("--limit <n>", "Limit results")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const docs = listDocuments({
-      search: opts.search,
-      file_type: opts.type,
-      status: opts.status,
-      tag: opts.tag,
-      limit: opts.limit ? parseInt(opts.limit) : undefined,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(docs, null, 2));
-    } else {
-      if (docs.length === 0) {
-        console.log("No documents found.");
-        return;
-      }
-      for (const d of docs) {
-        const type = d.file_type ? ` [${d.file_type}]` : "";
-        const tags = d.tags.length ? ` {${d.tags.join(", ")}}` : "";
-        console.log(`  ${d.title}${type}  v${d.version}  ${d.status}${tags}`);
-      }
-      console.log(`\n${docs.length} document(s)`);
-    }
-  });
-
-program
-  .command("update")
-  .description("Update a document")
-  .argument("<id>", "Document ID")
-  .option("--title <title>", "Title")
-  .option("--description <text>", "Description")
-  .option("--file-path <path>", "File path")
-  .option("--file-type <type>", "File type")
-  .option("--file-size <bytes>", "File size")
-  .option("--status <status>", "Status: draft|active|archived")
-  .option("--tags <tags>", "Comma-separated tags")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const input: Record<string, unknown> = {};
-    if (opts.title !== undefined) input.title = opts.title;
-    if (opts.description !== undefined) input.description = opts.description;
-    if (opts.filePath !== undefined) input.file_path = opts.filePath;
-    if (opts.fileType !== undefined) input.file_type = opts.fileType;
-    if (opts.fileSize !== undefined) input.file_size = parseInt(opts.fileSize);
-    if (opts.status !== undefined) input.status = opts.status;
-    if (opts.tags !== undefined) input.tags = opts.tags.split(",").map((t: string) => t.trim());
-
-    const doc = updateDocument(id, input);
-    if (!doc) {
-      console.error(`Document '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(doc, null, 2));
-    } else {
-      console.log(`Updated: ${doc.title}`);
-    }
-  });
-
-program
-  .command("delete")
-  .description("Delete a document")
-  .argument("<id>", "Document ID")
-  .action((id) => {
-    const deleted = deleteDocument(id);
-    if (deleted) {
-      console.log(`Deleted document ${id}`);
-    } else {
-      console.error(`Document '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-
-program
-  .command("search")
-  .description("Search documents")
-  .argument("<query>", "Search term")
-  .option("--json", "Output as JSON", false)
-  .action((query, opts) => {
-    const results = searchDocuments(query);
-
-    if (opts.json) {
-      console.log(JSON.stringify(results, null, 2));
-    } else {
-      if (results.length === 0) {
-        console.log(`No documents matching "${query}".`);
-        return;
-      }
-      for (const d of results) {
-        console.log(`  ${d.title} ${d.file_type ? `[${d.file_type}]` : ""} (${d.status})`);
-      }
-    }
-  });
-
-program
-  .command("count")
-  .description("Count documents")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const count = countDocuments();
-    if (opts.json) {
-      console.log(JSON.stringify({ count }));
-    } else {
-      console.log(`${count} document(s)`);
-    }
-  });
-
-// --- Versions ---
-
-const versionCmd = program
-  .command("version")
-  .description("Document version management");
-
-versionCmd
-  .command("add")
-  .description("Add a new version to a document")
-  .requiredOption("--document <id>", "Document ID")
-  .option("--file-path <path>", "New file path")
-  .option("--notes <notes>", "Version notes")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const ver = addVersion({
-      document_id: opts.document,
-      file_path: opts.filePath,
-      notes: opts.notes,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(ver, null, 2));
-    } else {
-      console.log(`Added version ${ver.version} to document ${ver.document_id}`);
-    }
-  });
-
-versionCmd
-  .command("list")
-  .description("List versions for a document")
-  .argument("<document-id>", "Document ID")
-  .option("--json", "Output as JSON", false)
-  .action((documentId, opts) => {
-    const versions = listVersions(documentId);
-
-    if (opts.json) {
-      console.log(JSON.stringify(versions, null, 2));
-    } else {
-      if (versions.length === 0) {
-        console.log("No versions found.");
-        return;
-      }
-      for (const v of versions) {
-        const notes = v.notes ? ` — ${v.notes}` : "";
-        console.log(`  v${v.version}  ${v.created_at}${notes}`);
-      }
-    }
-  });
-
-program.parse(process.argv);

package/microservices/microservice-documents/src/db/database.ts

@@ -1,91 +0,0 @@
-/**
- * Database connection for microservice-documents
- */
-
-import { SqliteAdapter } from "@hasna/cloud";
-import type { Database } from "bun:sqlite";
-import { existsSync, mkdirSync, cpSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { MIGRATIONS } from "./migrations.js";
-
-let _db: Database | null = null;
-
-function getDbPath(): string {
-  const explicit = process.env["HASNA_MICROSERVICES_DIR"] ?? process.env["MICROSERVICES_DIR"];
-  if (explicit) {
-    return join(explicit, "microservice-documents", "data.db");
-  }
-
-  let dir = resolve(process.cwd());
-  while (true) {
-    const msDir = join(dir, ".microservices");
-    if (existsSync(msDir)) return join(msDir, "microservice-documents", "data.db");
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-
-  const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
-  const newDir = join(home, ".hasna", "microservices");
-  const oldDir = join(home, ".microservices");
-  if (!existsSync(newDir) && existsSync(oldDir)) {
-    mkdirSync(join(home, ".hasna"), { recursive: true });
-    cpSync(oldDir, newDir, { recursive: true });
-  }
-  return join(newDir, "microservice-documents", "data.db");
-}
-
-export function getDatabase(): Database {
-  if (_db) return _db;
-
-  const dbPath = getDbPath();
-  const dir = dirname(resolve(dbPath));
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-
-  const adapter = new SqliteAdapter(dbPath);
-  _db = adapter.raw;
-  // SqliteAdapter already sets WAL and foreign_keys
-
-  _db.exec(`
-    CREATE TABLE IF NOT EXISTS _migrations (
-      id INTEGER PRIMARY KEY,
-      name TEXT NOT NULL,
-      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
-    )
-  `);
-
-  const applied = _db
-    .query("SELECT id FROM _migrations ORDER BY id")
-    .all() as { id: number }[];
-  const appliedIds = new Set(applied.map((r) => r.id));
-
-  for (const migration of MIGRATIONS) {
-    if (appliedIds.has(migration.id)) continue;
-
-    _db.exec("BEGIN");
-    try {
-      _db.exec(migration.sql);
-      _db.prepare("INSERT INTO _migrations (id, name) VALUES (?, ?)").run(
-        migration.id,
-        migration.name
-      );
-      _db.exec("COMMIT");
-    } catch (error) {
-      _db.exec("ROLLBACK");
-      throw new Error(
-        `Migration ${migration.id} (${migration.name}) failed: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-
-  return _db;
-}
-
-export function closeDatabase(): void {
-  if (_db) {
-    _db.close();
-    _db = null;
-  }
-}

package/microservices/microservice-documents/src/db/documents.ts

@@ -1,316 +0,0 @@
-/**
- * Document CRUD operations
- */
-
-import { getDatabase } from "./database.js";
-
-export interface Document {
-  id: string;
-  title: string;
-  description: string | null;
-  file_path: string | null;
-  file_type: string | null;
-  file_size: number | null;
-  version: number;
-  status: "draft" | "active" | "archived";
-  tags: string[];
-  metadata: Record<string, unknown>;
-  created_at: string;
-  updated_at: string;
-}
-
-export interface DocumentVersion {
-  id: string;
-  document_id: string;
-  version: number;
-  file_path: string | null;
-  notes: string | null;
-  created_at: string;
-}
-
-interface DocumentRow {
-  id: string;
-  title: string;
-  description: string | null;
-  file_path: string | null;
-  file_type: string | null;
-  file_size: number | null;
-  version: number;
-  status: string;
-  tags: string;
-  metadata: string;
-  created_at: string;
-  updated_at: string;
-}
-
-function rowToDocument(row: DocumentRow): Document {
-  return {
-    ...row,
-    status: row.status as Document["status"],
-    tags: JSON.parse(row.tags || "[]"),
-    metadata: JSON.parse(row.metadata || "{}"),
-  };
-}
-
-export interface CreateDocumentInput {
-  title: string;
-  description?: string;
-  file_path?: string;
-  file_type?: string;
-  file_size?: number;
-  status?: "draft" | "active" | "archived";
-  tags?: string[];
-  metadata?: Record<string, unknown>;
-}
-
-export function createDocument(input: CreateDocumentInput): Document {
-  const db = getDatabase();
-  const id = crypto.randomUUID();
-  const tags = JSON.stringify(input.tags || []);
-  const metadata = JSON.stringify(input.metadata || {});
-
-  db.prepare(
-    `INSERT INTO documents (id, title, description, file_path, file_type, file_size, status, tags, metadata)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    id,
-    input.title,
-    input.description || null,
-    input.file_path || null,
-    input.file_type || null,
-    input.file_size || null,
-    input.status || "draft",
-    tags,
-    metadata
-  );
-
-  // Insert tags into junction table
-  if (input.tags?.length) {
-    const insertTag = db.prepare(
-      "INSERT OR IGNORE INTO document_tags (document_id, tag) VALUES (?, ?)"
-    );
-    for (const tag of input.tags) {
-      insertTag.run(id, tag);
-    }
-  }
-
-  return getDocument(id)!;
-}
-
-export function getDocument(id: string): Document | null {
-  const db = getDatabase();
-  const row = db.prepare("SELECT * FROM documents WHERE id = ?").get(id) as DocumentRow | null;
-  return row ? rowToDocument(row) : null;
-}
-
-export interface ListDocumentsOptions {
-  search?: string;
-  file_type?: string;
-  status?: string;
-  tag?: string;
-  limit?: number;
-  offset?: number;
-}
-
-export function listDocuments(options: ListDocumentsOptions = {}): Document[] {
-  const db = getDatabase();
-  const conditions: string[] = [];
-  const params: unknown[] = [];
-
-  if (options.search) {
-    conditions.push(
-      "(title LIKE ? OR description LIKE ?)"
-    );
-    const q = `%${options.search}%`;
-    params.push(q, q);
-  }
-
-  if (options.file_type) {
-    conditions.push("file_type = ?");
-    params.push(options.file_type);
-  }
-
-  if (options.status) {
-    conditions.push("status = ?");
-    params.push(options.status);
-  }
-
-  if (options.tag) {
-    conditions.push(
-      "id IN (SELECT document_id FROM document_tags WHERE tag = ?)"
-    );
-    params.push(options.tag);
-  }
-
-  let sql = "SELECT * FROM documents";
-  if (conditions.length > 0) {
-    sql += " WHERE " + conditions.join(" AND ");
-  }
-  sql += " ORDER BY updated_at DESC";
-
-  if (options.limit) {
-    sql += " LIMIT ?";
-    params.push(options.limit);
-  }
-  if (options.offset) {
-    sql += " OFFSET ?";
-    params.push(options.offset);
-  }
-
-  const rows = db.prepare(sql).all(...params) as DocumentRow[];
-  return rows.map(rowToDocument);
-}
-
-export interface UpdateDocumentInput {
-  title?: string;
-  description?: string;
-  file_path?: string;
-  file_type?: string;
-  file_size?: number;
-  status?: "draft" | "active" | "archived";
-  tags?: string[];
-  metadata?: Record<string, unknown>;
-}
-
-export function updateDocument(
-  id: string,
-  input: UpdateDocumentInput
-): Document | null {
-  const db = getDatabase();
-  const existing = getDocument(id);
-  if (!existing) return null;
-
-  const sets: string[] = [];
-  const params: unknown[] = [];
-
-  if (input.title !== undefined) {
-    sets.push("title = ?");
-    params.push(input.title);
-  }
-  if (input.description !== undefined) {
-    sets.push("description = ?");
-    params.push(input.description);
-  }
-  if (input.file_path !== undefined) {
-    sets.push("file_path = ?");
-    params.push(input.file_path);
-  }
-  if (input.file_type !== undefined) {
-    sets.push("file_type = ?");
-    params.push(input.file_type);
-  }
-  if (input.file_size !== undefined) {
-    sets.push("file_size = ?");
-    params.push(input.file_size);
-  }
-  if (input.status !== undefined) {
-    sets.push("status = ?");
-    params.push(input.status);
-  }
-  if (input.tags !== undefined) {
-    sets.push("tags = ?");
-    params.push(JSON.stringify(input.tags));
-
-    // Update junction table
-    db.prepare("DELETE FROM document_tags WHERE document_id = ?").run(id);
-    const insertTag = db.prepare(
-      "INSERT OR IGNORE INTO document_tags (document_id, tag) VALUES (?, ?)"
-    );
-    for (const tag of input.tags) {
-      insertTag.run(id, tag);
-    }
-  }
-  if (input.metadata !== undefined) {
-    sets.push("metadata = ?");
-    params.push(JSON.stringify(input.metadata));
-  }
-
-  if (sets.length === 0) return existing;
-
-  sets.push("updated_at = datetime('now')");
-  params.push(id);
-
-  db.prepare(
-    `UPDATE documents SET ${sets.join(", ")} WHERE id = ?`
-  ).run(...params);
-
-  return getDocument(id);
-}
-
-export function deleteDocument(id: string): boolean {
-  const db = getDatabase();
-  const result = db.prepare("DELETE FROM documents WHERE id = ?").run(id);
-  return result.changes > 0;
-}
-
-export function countDocuments(): number {
-  const db = getDatabase();
-  const row = db.prepare("SELECT COUNT(*) as count FROM documents").get() as { count: number };
-  return row.count;
-}
-
-export function searchDocuments(query: string): Document[] {
-  return listDocuments({ search: query });
-}
-
-export function getDocumentsByTag(tag: string): Document[] {
-  return listDocuments({ tag });
-}
-
-// --- Versions ---
-
-export interface AddVersionInput {
-  document_id: string;
-  file_path?: string;
-  notes?: string;
-}
-
-export function addVersion(input: AddVersionInput): DocumentVersion {
-  const db = getDatabase();
-  const id = crypto.randomUUID();
-
-  // Get current version number and increment
-  const doc = db
-    .prepare("SELECT version FROM documents WHERE id = ?")
-    .get(input.document_id) as { version: number } | null;
-
-  if (!doc) {
-    throw new Error(`Document '${input.document_id}' not found.`);
-  }
-
-  const newVersion = doc.version + 1;
-
-  db.prepare(
-    `INSERT INTO document_versions (id, document_id, version, file_path, notes)
-     VALUES (?, ?, ?, ?, ?)`
-  ).run(
-    id,
-    input.document_id,
-    newVersion,
-    input.file_path || null,
-    input.notes || null
-  );
-
-  // Update document version number and file_path if provided
-  const updateSets = ["version = ?", "updated_at = datetime('now')"];
-  const updateParams: unknown[] = [newVersion];
-
-  if (input.file_path) {
-    updateSets.push("file_path = ?");
-    updateParams.push(input.file_path);
-  }
-
-  updateParams.push(input.document_id);
-  db.prepare(
-    `UPDATE documents SET ${updateSets.join(", ")} WHERE id = ?`
-  ).run(...updateParams);
-
-  return db.prepare("SELECT * FROM document_versions WHERE id = ?").get(id) as DocumentVersion;
-}
-
-export function listVersions(documentId: string): DocumentVersion[] {
-  const db = getDatabase();
-  return db
-    .prepare("SELECT * FROM document_versions WHERE document_id = ? ORDER BY version DESC")
-    .all(documentId) as DocumentVersion[];
-}