pigeongov 0.2.0

package/dist/src/storage/vault.js

@@ -0,0 +1,187 @@
+import { randomBytes, randomUUID, createCipheriv, createDecipheriv, pbkdf2Sync, createHash, } from "node:crypto";
+import { readFile, writeFile, stat } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { getVaultDir, ensureDir } from "./paths.js";
+// --- Constants ---
+const PBKDF2_ITERATIONS = 100_000;
+const PBKDF2_KEYLEN = 32; // 256 bits for AES-256
+const PBKDF2_DIGEST = "sha512";
+const SALT_FILENAME = ".vault-salt";
+const INDEX_FILENAME = "vault-index.enc";
+// --- Low-level crypto ---
+/**
+ * Derive a 256-bit key from a passphrase and salt using PBKDF2.
+ */
+export function deriveKey(passphrase, salt) {
+    return pbkdf2Sync(passphrase, salt, PBKDF2_ITERATIONS, PBKDF2_KEYLEN, PBKDF2_DIGEST);
+}
+/**
+ * Encrypt data with AES-256-GCM.
+ */
+export function encrypt(data, key) {
+    const iv = randomBytes(12);
+    const cipher = createCipheriv("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([cipher.update(data), cipher.final()]);
+    const authTag = cipher.getAuthTag();
+    return { iv, authTag, encrypted };
+}
+/**
+ * Decrypt AES-256-GCM ciphertext.
+ */
+export function decrypt(encrypted, key, iv, authTag) {
+    const decipher = createDecipheriv("aes-256-gcm", key, iv);
+    decipher.setAuthTag(authTag);
+    return Buffer.concat([decipher.update(encrypted), decipher.final()]);
+}
+// --- Salt management ---
+async function getSaltPath() {
+    return join(getVaultDir(), SALT_FILENAME);
+}
+async function loadOrCreateSalt() {
+    const saltPath = await getSaltPath();
+    try {
+        return await readFile(saltPath);
+    }
+    catch {
+        const salt = randomBytes(32);
+        await ensureDir(getVaultDir());
+        await writeFile(saltPath, salt);
+        return salt;
+    }
+}
+async function loadSalt() {
+    const saltPath = await getSaltPath();
+    return readFile(saltPath);
+}
+// --- Index management ---
+function getIndexPath() {
+    return join(getVaultDir(), INDEX_FILENAME);
+}
+/**
+ * Pack an encrypted payload into a single buffer: [iv(12)][authTag(16)][ciphertext(rest)].
+ */
+function packEncrypted(enc) {
+    return Buffer.concat([enc.iv, enc.authTag, enc.encrypted]);
+}
+/**
+ * Unpack a buffer produced by `packEncrypted`.
+ */
+function unpackEncrypted(buf) {
+    const iv = buf.subarray(0, 12);
+    const authTag = buf.subarray(12, 28);
+    const encrypted = buf.subarray(28);
+    return { iv, authTag, encrypted };
+}
+async function readIndex(key) {
+    const indexPath = getIndexPath();
+    try {
+        const raw = await readFile(indexPath);
+        const { iv, authTag, encrypted } = unpackEncrypted(raw);
+        const plaintext = decrypt(encrypted, key, iv, authTag);
+        return JSON.parse(plaintext.toString("utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+async function writeIndex(key, entries) {
+    const indexPath = getIndexPath();
+    const plaintext = Buffer.from(JSON.stringify(entries, null, 2), "utf-8");
+    const enc = encrypt(plaintext, key);
+    await writeFile(indexPath, packEncrypted(enc));
+}
+// --- Public API ---
+/**
+ * Initialize the vault: create the salt file and return the derived key.
+ * Idempotent — safe to call when vault already exists.
+ */
+export async function initVault(passphrase) {
+    const salt = await loadOrCreateSalt();
+    return deriveKey(passphrase, salt);
+}
+/**
+ * Encrypt a file and add it to the vault.
+ */
+export async function addToVault(passphrase, filePath, label, tags) {
+    const vaultDir = getVaultDir();
+    await ensureDir(vaultDir);
+    const salt = await loadOrCreateSalt();
+    const key = deriveKey(passphrase, salt);
+    const fileData = await readFile(filePath);
+    const fileStat = await stat(filePath);
+    const checksum = createHash("sha256").update(fileData).digest("hex");
+    const id = randomUUID();
+    const enc = encrypt(fileData, key);
+    const encPath = join(vaultDir, `${id}.enc`);
+    await writeFile(encPath, packEncrypted(enc));
+    const entry = {
+        id,
+        filename: label || basename(filePath),
+        mimeType: guessMimeType(filePath),
+        tags,
+        linkedWorkflows: [],
+        addedAt: new Date().toISOString(),
+        sizeBytes: fileStat.size,
+        checksum,
+    };
+    const entries = await readIndex(key);
+    entries.push(entry);
+    await writeIndex(key, entries);
+    return entry;
+}
+/**
+ * List all vault entries (requires passphrase to decrypt the index).
+ */
+export async function listVault(passphrase) {
+    const salt = await loadSalt();
+    const key = deriveKey(passphrase, salt);
+    return readIndex(key);
+}
+/**
+ * Decrypt a vault entry to a file on disk.
+ */
+export async function getFromVault(passphrase, id, outputPath) {
+    const vaultDir = getVaultDir();
+    const salt = await loadSalt();
+    const key = deriveKey(passphrase, salt);
+    const encPath = join(vaultDir, `${id}.enc`);
+    const raw = await readFile(encPath);
+    const { iv, authTag, encrypted } = unpackEncrypted(raw);
+    const plaintext = decrypt(encrypted, key, iv, authTag);
+    await writeFile(outputPath, plaintext);
+}
+/**
+ * Link a vault document to a workflow.
+ */
+export async function linkToWorkflow(passphrase, docId, workflowId) {
+    const salt = await loadSalt();
+    const key = deriveKey(passphrase, salt);
+    const entries = await readIndex(key);
+    const entry = entries.find((e) => e.id === docId);
+    if (!entry) {
+        throw new Error(`Vault entry not found: ${docId}`);
+    }
+    if (!entry.linkedWorkflows.includes(workflowId)) {
+        entry.linkedWorkflows.push(workflowId);
+    }
+    await writeIndex(key, entries);
+}
+// --- Helpers ---
+function guessMimeType(filePath) {
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    const mimeMap = {
+        pdf: "application/pdf",
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        json: "application/json",
+        txt: "text/plain",
+        csv: "text/csv",
+        xml: "application/xml",
+        html: "text/html",
+        doc: "application/msword",
+        docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    };
+    return mimeMap[ext ?? ""] ?? "application/octet-stream";
+}
+//# sourceMappingURL=vault.js.map

package/dist/src/storage/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../../src/storage/vault.ts"],"names":[],"mappings":"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"}

package/dist/src/testing/synthetic.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate a random input object for the given workflow, using the
+ * starter data as a base and overriding fields with random values.
+ *
+ * Falls back to purely random generation from the described schema
+ * if starter data is not available.
+ */
+export declare function generateRandomInput(workflowId: string, seed: number): Record<string, unknown>;
+/**
+ * Generate N random inputs for a workflow, each with a unique seed
+ * derived from the base seed.
+ */
+export declare function generateRandomInputBatch(workflowId: string, count: number, baseSeed: number): Record<string, unknown>[];

package/dist/src/testing/synthetic.js

@@ -0,0 +1,164 @@
+import { describeWorkflow, getWorkflowStarterData } from "../workflows/registry.js";
+/**
+ * Simple seeded PRNG (mulberry32).
+ * Deterministic, fast, good enough for test data.
+ */
+function createPrng(seed) {
+    let t = seed | 0;
+    return () => {
+        t = (t + 0x6d2b79f5) | 0;
+        let x = Math.imul(t ^ (t >>> 15), 1 | t);
+        x = (x + Math.imul(x ^ (x >>> 7), 61 | x)) ^ x;
+        return ((x ^ (x >>> 14)) >>> 0) / 0x100000000;
+    };
+}
+const FIRST_NAMES = [
+    "Alice", "Bob", "Charlie", "Diana", "Ethan", "Fiona", "George",
+    "Hannah", "Isaac", "Julia", "Kevin", "Laura", "Miguel", "Nina",
+    "Oscar", "Priya", "Quinn", "Rosa", "Sam", "Tara",
+];
+const LAST_NAMES = [
+    "Smith", "Johnson", "Williams", "Brown", "Jones", "Garcia",
+    "Miller", "Davis", "Rodriguez", "Martinez", "Hernandez", "Lopez",
+    "Gonzalez", "Wilson", "Anderson", "Thomas", "Taylor", "Moore",
+];
+const STREETS = [
+    "123 Main St", "456 Oak Ave", "789 Pine Rd", "321 Elm Blvd",
+    "654 Maple Dr", "987 Cedar Ln", "111 Birch Way", "222 Willow Ct",
+];
+const CITIES = [
+    "Springfield", "Portland", "Denver", "Austin", "Sacramento",
+    "Phoenix", "Seattle", "Atlanta", "Miami", "Boston",
+];
+const STATES = [
+    "CA", "NY", "TX", "FL", "WA", "OR", "CO", "IL", "PA", "GA",
+];
+const ZIP_CODES = [
+    "90210", "10001", "73301", "33101", "98101",
+    "97201", "80201", "60601", "19101", "30301",
+];
+const RELATIONSHIPS = ["self", "spouse", "child", "parent"];
+function pickFrom(arr, rand) {
+    return arr[Math.floor(rand() * arr.length)];
+}
+function randomSsn(rand) {
+    const a = String(Math.floor(rand() * 900) + 100);
+    const b = String(Math.floor(rand() * 90) + 10);
+    const c = String(Math.floor(rand() * 9000) + 1000);
+    return `${a}-${b}-${c}`;
+}
+function randomDate(rand, yearStart = 1960, yearEnd = 2005) {
+    const year = Math.floor(rand() * (yearEnd - yearStart)) + yearStart;
+    const month = String(Math.floor(rand() * 12) + 1).padStart(2, "0");
+    const day = String(Math.floor(rand() * 28) + 1).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+function randomCurrency(rand, min = 0, max = 150000) {
+    return Math.round((rand() * (max - min) + min) * 100) / 100;
+}
+/**
+ * Recursively generate a value for a described field.
+ */
+function generateFieldValue(field, rand) {
+    const { kind, name } = field;
+    if (kind === "object" && field.fields) {
+        const obj = {};
+        for (const child of field.fields) {
+            if (child.optional && rand() < 0.3)
+                continue; // skip some optionals
+            obj[child.name] = generateFieldValue(child, rand);
+        }
+        return obj;
+    }
+    if (kind === "array" && field.items) {
+        const length = Math.floor(rand() * 3) + 1;
+        return Array.from({ length }, () => generateFieldValue(field.items, rand));
+    }
+    // Heuristic field generation based on name patterns
+    const lowerName = name.toLowerCase();
+    if (lowerName.includes("firstname") || lowerName === "name") {
+        return pickFrom(FIRST_NAMES, rand);
+    }
+    if (lowerName.includes("lastname")) {
+        return pickFrom(LAST_NAMES, rand);
+    }
+    if (lowerName.includes("ssn")) {
+        return randomSsn(rand);
+    }
+    if (lowerName.includes("street")) {
+        return pickFrom(STREETS, rand);
+    }
+    if (lowerName.includes("city")) {
+        return pickFrom(CITIES, rand);
+    }
+    if (lowerName.includes("state")) {
+        return pickFrom(STATES, rand);
+    }
+    if (lowerName.includes("zip")) {
+        return pickFrom(ZIP_CODES, rand);
+    }
+    if (lowerName.includes("relationship")) {
+        return pickFrom(RELATIONSHIPS, rand);
+    }
+    if (lowerName.includes("date") || lowerName.includes("dob")) {
+        return randomDate(rand);
+    }
+    if (lowerName.includes("email")) {
+        return `${pickFrom(FIRST_NAMES, rand).toLowerCase()}@example.com`;
+    }
+    if (lowerName.includes("phone")) {
+        return `555-${String(Math.floor(rand() * 9000) + 1000)}`;
+    }
+    // Fall back to type-based generation
+    switch (kind) {
+        case "string":
+            return `sample-${name}-${Math.floor(rand() * 1000)}`;
+        case "number":
+            if (lowerName.includes("wage") ||
+                lowerName.includes("income") ||
+                lowerName.includes("amount") ||
+                lowerName.includes("tax") ||
+                lowerName.includes("withh")) {
+                return randomCurrency(rand);
+            }
+            if (lowerName.includes("age")) {
+                return Math.floor(rand() * 80) + 1;
+            }
+            return Math.floor(rand() * 10000);
+        case "boolean":
+            return rand() > 0.5;
+        case "enum":
+            // We don't have enum values from describeField, pick a default
+            return "unknown";
+        default:
+            return `generated-${name}`;
+    }
+}
+/**
+ * Generate a random input object for the given workflow, using the
+ * starter data as a base and overriding fields with random values.
+ *
+ * Falls back to purely random generation from the described schema
+ * if starter data is not available.
+ */
+export function generateRandomInput(workflowId, seed) {
+    const rand = createPrng(seed);
+    const description = describeWorkflow(workflowId);
+    const starterData = getWorkflowStarterData(workflowId);
+    // Start from starter data, then overlay random values from the schema
+    const result = structuredClone(starterData);
+    for (const field of description.inputSchema) {
+        if (field.optional && rand() < 0.2)
+            continue;
+        result[field.name] = generateFieldValue(field, rand);
+    }
+    return result;
+}
+/**
+ * Generate N random inputs for a workflow, each with a unique seed
+ * derived from the base seed.
+ */
+export function generateRandomInputBatch(workflowId, count, baseSeed) {
+    return Array.from({ length: count }, (_, i) => generateRandomInput(workflowId, baseSeed + i));
+}
+//# sourceMappingURL=synthetic.js.map

package/dist/src/testing/synthetic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic.js","sourceRoot":"","sources":["../../../src/testing/synthetic.ts"],"names":[],"mappings":"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"}