sandstream-kit 1.0.0

package/dist/payout-service.js

@@ -0,0 +1,293 @@
+/**
+ * kit Payout Service
+ *
+ * Handles author payouts, revenue tracking, grant applications,
+ * and Stripe Connect integration for marketplace monetization.
+ */
+import { IdGenerators } from "./id-generator.js";
+/**
+ * Payout service for managing author earnings and payments
+ */
+export class PayoutService {
+    db; // Database connection
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Record a plugin download and update revenue
+     */
+    async recordPluginDownload(pluginId, downloadRate = 10) {
+        const revenue = await this.db.query(`SELECT * FROM plugin_revenue WHERE plugin_id = $1`, [pluginId]);
+        const existing = revenue.rows[0];
+        const newGross = (existing?.gross_revenue || 0) + downloadRate;
+        const commission = Math.round(newGross * 0.2); // 20% to kit
+        const earnings = Math.round(newGross * 0.8); // 80% to author
+        const result = await this.db.query(`
+      INSERT INTO plugin_revenue (id, plugin_id, author_id, gross_revenue, kit_commission, author_earnings, updated_at)
+      SELECT $1, $2, author, $3, $4, $5, now()
+      FROM plugins WHERE id = $2
+      ON CONFLICT (plugin_id) DO UPDATE SET
+        gross_revenue = gross_revenue + $3,
+        kit_commission = EXCLUDED.gross_revenue * 0.2,
+        author_earnings = EXCLUDED.gross_revenue * 0.8,
+        updated_at = now()
+      RETURNING *
+      `, [IdGenerators.payout(), pluginId, downloadRate, commission, earnings]);
+        return this.mapRevenue(result.rows[0]);
+    }
+    /**
+     * Calculate monthly earnings for author
+     */
+    async calculateMonthlyEarnings(authorId, year, month) {
+        const result = await this.db.query(`
+      SELECT COALESCE(SUM(author_earnings), 0) as total
+      FROM plugin_revenue
+      WHERE author_id = $1
+        AND EXTRACT(YEAR FROM updated_at) = $2
+        AND EXTRACT(MONTH FROM updated_at) = $3
+      `, [authorId, year, month]);
+        return result.rows[0]?.total || 0;
+    }
+    /**
+     * Create monthly payout transaction
+     */
+    async createPayoutTransaction(authorId, amount, periodStart, periodEnd) {
+        const id = IdGenerators.payout();
+        const result = await this.db.query(`
+      INSERT INTO payment_transactions
+      (id, author_id, amount, status, period_start, period_end, created_at, updated_at)
+      VALUES ($1, $2, $3, $4, $5, $6, now(), now())
+      RETURNING *
+      `, [id, authorId, amount, "pending", periodStart, periodEnd]);
+        return this.mapTransaction(result.rows[0]);
+    }
+    /**
+     * Trigger monthly payouts (cron job, runs 1st of month)
+     */
+    async triggerMonthlyPayouts() {
+        const lastMonth = new Date();
+        lastMonth.setMonth(lastMonth.getMonth() - 1);
+        const year = lastMonth.getFullYear();
+        const month = lastMonth.getMonth() + 1;
+        const authors = await this.db.query(`
+      SELECT DISTINCT author_id FROM plugin_revenue
+      WHERE author_earnings > 0
+      `);
+        const payouts = [];
+        for (const { author_id } of authors.rows) {
+            const earnings = await this.calculateMonthlyEarnings(author_id, year, month);
+            if (earnings > 100) { // Minimum $1.00 payout threshold
+                const periodStart = `${year}-${String(month).padStart(2, "0")}-01`;
+                const periodEnd = new Date(year, month, 0)
+                    .toISOString()
+                    .split("T")[0];
+                const tx = await this.createPayoutTransaction(author_id, earnings, periodStart, periodEnd);
+                payouts.push(tx);
+            }
+        }
+        return payouts;
+    }
+    /**
+     * Process pending payouts (transfers to author Stripe accounts)
+     */
+    async processPayouts(batchSize = 10) {
+        const pending = await this.db.query(`
+      SELECT pt.* FROM payment_transactions pt
+      WHERE pt.status = 'pending'
+      AND pt.created_at < now() - interval '2 days'
+      LIMIT $1
+      `, [batchSize]);
+        const processed = [];
+        for (const tx of pending.rows) {
+            // Get author's Stripe account
+            const account = await this.db.query(`SELECT stripe_account_id FROM author_payout_accounts WHERE author_id = $1`, [tx.author_id]);
+            if (!account.rows[0]?.stripe_account_id) {
+                // Skip if no Stripe account connected
+                continue;
+            }
+            try {
+                // In real implementation, call Stripe API here
+                // const transfer = await stripe.transfers.create({
+                //   destination: account.rows[0].stripe_account_id,
+                //   amount: tx.amount,
+                //   currency: 'usd',
+                // });
+                // For now, simulate successful transfer
+                const result = await this.db.query(`
+          UPDATE payment_transactions
+          SET status = $1, attempted_at = now(), updated_at = now()
+          WHERE id = $2
+          RETURNING *
+          `, ["processing", tx.id]);
+                processed.push(this.mapTransaction(result.rows[0]));
+            }
+            catch (error) {
+                // Log error and mark as failed
+                console.error(`Failed to process payout ${tx.id}:`, error);
+                await this.db.query(`
+          UPDATE payment_transactions
+          SET status = $1, updated_at = now()
+          WHERE id = $2
+          `, ["failed", tx.id]);
+            }
+        }
+        return processed;
+    }
+    /**
+     * Submit grant application
+     */
+    async submitGrant(authorId, pluginId, amountRequested, useCase) {
+        const id = IdGenerators.grant();
+        const result = await this.db.query(`
+      INSERT INTO grant_applications
+      (id, author_id, plugin_id, amount_requested, status, use_case, created_at, updated_at)
+      VALUES ($1, $2, $3, $4, $5, $6, now(), now())
+      RETURNING *
+      `, [id, authorId, pluginId, amountRequested, "pending", useCase]);
+        return this.mapGrant(result.rows[0]);
+    }
+    /**
+     * Approve grant (admin only)
+     */
+    async approveGrant(grantId, approvedBy) {
+        const result = await this.db.query(`
+      UPDATE grant_applications
+      SET status = $1, approved_by = $2, approval_date = now(), updated_at = now()
+      WHERE id = $3
+      RETURNING *
+      `, ["approved", approvedBy, grantId]);
+        const grant = this.mapGrant(result.rows[0]);
+        // Immediately create payout transaction for grant amount
+        await this.createPayoutTransaction(grant.authorId, grant.amountRequested, new Date().toISOString().split("T")[0], new Date().toISOString().split("T")[0]);
+        return grant;
+    }
+    /**
+     * Reject grant (admin only)
+     */
+    async rejectGrant(grantId) {
+        const result = await this.db.query(`
+      UPDATE grant_applications
+      SET status = $1, updated_at = now()
+      WHERE id = $2
+      RETURNING *
+      `, ["rejected", grantId]);
+        return this.mapGrant(result.rows[0]);
+    }
+    /**
+     * Get pending grants (admin dashboard)
+     */
+    async getPendingGrants(limit = 20) {
+        const result = await this.db.query(`
+      SELECT * FROM grant_applications
+      WHERE status = 'pending'
+      ORDER BY created_at DESC
+      LIMIT $1
+      `, [limit]);
+        return result.rows.map((row) => this.mapGrant(row));
+    }
+    /**
+     * Get author payout status
+     */
+    async getPayoutStatus(authorId) {
+        const result = await this.db.query(`SELECT * FROM author_payout_accounts WHERE author_id = $1`, [authorId]);
+        return result.rows[0] ? this.mapPayoutAccount(result.rows[0]) : null;
+    }
+    /**
+     * Setup payout account (initiate Stripe Connect)
+     */
+    async setupPayoutAccount(authorId, email) {
+        // Check if account exists
+        const existing = await this.getPayoutStatus(authorId);
+        if (existing) {
+            return existing;
+        }
+        const id = IdGenerators.payout();
+        const result = await this.db.query(`
+      INSERT INTO author_payout_accounts
+      (id, author_id, status, kyc_status, created_at, updated_at)
+      VALUES ($1, $2, $3, $4, now(), now())
+      RETURNING *
+      `, [id, authorId, "pending", "pending"]);
+        return this.mapPayoutAccount(result.rows[0]);
+    }
+    /**
+     * Mark payout transaction as completed (webhook handler)
+     */
+    async completePayoutTransaction(stripeTransferId) {
+        const result = await this.db.query(`
+      UPDATE payment_transactions
+      SET status = $1, completed_at = now(), updated_at = now()
+      WHERE stripe_transfer_id = $2
+      RETURNING *
+      `, ["completed", stripeTransferId]);
+        return this.mapTransaction(result.rows[0]);
+    }
+    /**
+     * Map database row to PayoutAccount
+     */
+    mapPayoutAccount(row) {
+        return {
+            id: row.id,
+            authorId: row.author_id,
+            stripeAccountId: row.stripe_account_id,
+            status: row.status,
+            kycStatus: row.kyc_status,
+            taxId: row.tax_id,
+            bankAccountId: row.bank_account_id,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Map database row to PluginRevenue
+     */
+    mapRevenue(row) {
+        return {
+            id: row.id,
+            pluginId: row.plugin_id,
+            authorId: row.author_id,
+            grossRevenue: row.gross_revenue,
+            kitCommission: row.kit_commission,
+            authorEarnings: row.author_earnings,
+            currency: row.currency || "USD",
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Map database row to PaymentTransaction
+     */
+    mapTransaction(row) {
+        return {
+            id: row.id,
+            authorId: row.author_id,
+            stripeTransferId: row.stripe_transfer_id,
+            amount: row.amount,
+            status: row.status,
+            periodStart: row.period_start,
+            periodEnd: row.period_end,
+            attemptedAt: row.attempted_at,
+            completedAt: row.completed_at,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Map database row to GrantApplication
+     */
+    mapGrant(row) {
+        return {
+            id: row.id,
+            authorId: row.author_id,
+            pluginId: row.plugin_id,
+            amountRequested: row.amount_requested,
+            status: row.status,
+            useCase: row.use_case,
+            approvedBy: row.approved_by,
+            approvalDate: row.approval_date,
+            paidAt: row.paid_at,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+//# sourceMappingURL=payout-service.js.map

package/dist/payout-service.js.map

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

package/dist/pkg.d.ts

@@ -0,0 +1,30 @@
+/**
+ * kit pkg — Install packages from any ecosystem with mandatory triage.
+ *
+ * Usage:
+ *   kit pkg npm:express
+ *   kit pkg pip:requests
+ *   kit pkg brew:trivy
+ *   kit pkg docker:stalwartlabs/stalwart
+ *   kit pkg go:github.com/sigstore/cosign/v2/cmd/cosign@latest
+ *   kit pkg cargo:ripgrep
+ */
+export interface PkgSpec {
+    ecosystem: string;
+    name: string;
+    version?: string;
+}
+export interface PkgResult {
+    spec: PkgSpec;
+    triagePassed: boolean;
+    installed: boolean;
+    output: string;
+}
+/**
+ * Parse "npm:express@4.18.0" → { ecosystem: "npm", name: "express", version: "4.18.0" }
+ */
+export declare function parsePkgSpec(input: string): PkgSpec | null;
+/**
+ * Install a package with mandatory triage
+ */
+export declare function installPkg(spec: PkgSpec): Promise<PkgResult>;

package/dist/pkg.js

@@ -0,0 +1,162 @@
+/**
+ * kit pkg — Install packages from any ecosystem with mandatory triage.
+ *
+ * Usage:
+ *   kit pkg npm:express
+ *   kit pkg pip:requests
+ *   kit pkg brew:trivy
+ *   kit pkg docker:stalwartlabs/stalwart
+ *   kit pkg go:github.com/sigstore/cosign/v2/cmd/cosign@latest
+ *   kit pkg cargo:ripgrep
+ */
+import { exec as execCb } from "node:child_process";
+import { promisify } from "node:util";
+import { runTriage } from "./triage.js";
+const execAsync = promisify(execCb);
+const ECOSYSTEM_MAP = {
+    npm: {
+        triageType: "npm",
+        installCmd: (name, ver) => ver ? `npm install ${name}@${ver}` : `npm install ${name}`,
+    },
+    "npm-g": {
+        triageType: "npm",
+        installCmd: (name, ver) => ver ? `npm install -g ${name}@${ver}` : `npm install -g ${name}`,
+    },
+    pnpm: {
+        triageType: "npm",
+        installCmd: (name, ver) => ver ? `pnpm add ${name}@${ver}` : `pnpm add ${name}`,
+    },
+    pip: {
+        triageType: "pip",
+        installCmd: (name, ver) => ver ? `pip install ${name}==${ver}` : `pip install ${name}`,
+    },
+    brew: {
+        triageType: "repo",
+        installCmd: (name) => `brew install ${name}`,
+    },
+    docker: {
+        triageType: "docker",
+        installCmd: (name, ver) => ver ? `docker pull ${name}:${ver}` : `docker pull ${name}:latest`,
+    },
+    go: {
+        triageType: "repo",
+        installCmd: (name) => `go install ${name}`,
+    },
+    cargo: {
+        triageType: "repo",
+        installCmd: (name) => `cargo install ${name}`,
+    },
+};
+/**
+ * Parse "npm:express@4.18.0" → { ecosystem: "npm", name: "express", version: "4.18.0" }
+ */
+export function parsePkgSpec(input) {
+    const colonIdx = input.indexOf(":");
+    if (colonIdx === -1)
+        return null;
+    const ecosystem = input.slice(0, colonIdx);
+    const rest = input.slice(colonIdx + 1);
+    // Handle @scoped packages like @socketsecurity/cli@1.0.0
+    let name;
+    let version;
+    if (rest.startsWith("@")) {
+        // Scoped: @scope/pkg@version
+        const lastAt = rest.lastIndexOf("@");
+        if (lastAt > 0 && lastAt !== rest.indexOf("@")) {
+            name = rest.slice(0, lastAt);
+            version = rest.slice(lastAt + 1);
+        }
+        else {
+            name = rest;
+        }
+    }
+    else {
+        const atIdx = rest.indexOf("@");
+        if (atIdx > 0) {
+            name = rest.slice(0, atIdx);
+            version = rest.slice(atIdx + 1);
+        }
+        else {
+            name = rest;
+        }
+    }
+    return { ecosystem, name, version };
+}
+/**
+ * Get GitHub repo URL for brew formulas
+ */
+async function getBrewRepoUrl(name) {
+    try {
+        const { stdout } = await execAsync(`brew info --json=v2 ${name} 2>/dev/null`);
+        const data = JSON.parse(stdout);
+        const formula = data.formulae?.[0] || data.casks?.[0];
+        const homepage = formula?.homepage || "";
+        if (homepage.includes("github.com"))
+            return homepage;
+        return null;
+    }
+    catch {
+        // brew not available or formula not found — try GitHub search
+        return `https://github.com/search?q=${name}`;
+    }
+}
+/**
+ * Install a package with mandatory triage
+ */
+export async function installPkg(spec) {
+    const eco = ECOSYSTEM_MAP[spec.ecosystem];
+    if (!eco) {
+        return {
+            spec,
+            triagePassed: false,
+            installed: false,
+            output: `Unknown ecosystem: ${spec.ecosystem}\nSupported: ${Object.keys(ECOSYSTEM_MAP).join(", ")}`,
+        };
+    }
+    // Step 1: Triage
+    let triageTarget = spec.name;
+    if (spec.ecosystem === "brew") {
+        const repoUrl = await getBrewRepoUrl(spec.name);
+        if (repoUrl && repoUrl.includes("github.com")) {
+            triageTarget = repoUrl;
+        }
+    }
+    else if (spec.ecosystem === "docker" && !spec.name.includes("/")) {
+        // Official Docker images — skip repo triage, do image triage
+        triageTarget = spec.name;
+    }
+    else if (spec.ecosystem === "go") {
+        const ghParts = spec.name.replace("@latest", "").split("/").slice(0, 3);
+        triageTarget = `https://${ghParts.join("/")}`;
+    }
+    const triageResult = await runTriage(eco.triageType, triageTarget);
+    if (!triageResult.passed) {
+        return {
+            spec,
+            triagePassed: false,
+            installed: false,
+            output: `${triageResult.output}\n\n❌ Triage failed. Package not installed.\nReview warnings above. Use --force to override (not recommended).`,
+        };
+    }
+    // Step 2: Install
+    const cmd = eco.installCmd(spec.name, spec.version);
+    try {
+        const { stdout, stderr } = await execAsync(cmd, { timeout: 300_000 });
+        return {
+            spec,
+            triagePassed: true,
+            installed: true,
+            output: `✅ Triage passed\n✅ Installed: ${cmd}\n${stdout}${stderr ? "\n" + stderr : ""}`,
+        };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            spec,
+            triagePassed: true,
+            installed: false,
+            output: `✅ Triage passed\n❌ Install failed: ${cmd}\n${err.stderr || err.message || ""}`,
+        };
+    }
+}
+//# sourceMappingURL=pkg.js.map

package/dist/pkg.js.map

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

package/dist/plugin-loader.d.ts

@@ -0,0 +1,16 @@
+import type { AdapterRegistry } from "./adapters/types.js";
+/**
+ * Load plugin adapters from kitPlugins listed in the project's package.json.
+ *
+ * Plugin registration protocol:
+ * 1. Read `kitPlugins` array from `<projectPath>/package.json`
+ * 2. For each entry, attempt to import `<plugin>/kit-adapter` then `<plugin>`
+ * 3. Expect the module to export `{ adapter: ServiceAdapter }` or `{ adapters: ServiceAdapter[] }`
+ * 4. Invalid/missing plugins are skipped with a warning (never throw)
+ *
+ * @example package.json
+ * ```json
+ * { "kitPlugins": ["@acme/kit-railway", "sandstream-kit-plugin-aws-s3"] }
+ * ```
+ */
+export declare function loadPluginAdapters(projectPath: string): Promise<AdapterRegistry>;

package/dist/plugin-loader.js

@@ -0,0 +1,124 @@
+import { readFile } from "node:fs/promises";
+import { resolve, join } from "node:path";
+/**
+ * Load plugin adapters from kitPlugins listed in the project's package.json.
+ *
+ * Plugin registration protocol:
+ * 1. Read `kitPlugins` array from `<projectPath>/package.json`
+ * 2. For each entry, attempt to import `<plugin>/kit-adapter` then `<plugin>`
+ * 3. Expect the module to export `{ adapter: ServiceAdapter }` or `{ adapters: ServiceAdapter[] }`
+ * 4. Invalid/missing plugins are skipped with a warning (never throw)
+ *
+ * @example package.json
+ * ```json
+ * { "kitPlugins": ["@acme/kit-railway", "sandstream-kit-plugin-aws-s3"] }
+ * ```
+ */
+export async function loadPluginAdapters(projectPath) {
+    const registry = {};
+    const pluginNames = await readkitPlugins(projectPath);
+    if (pluginNames.length === 0)
+        return registry;
+    for (const pluginName of pluginNames) {
+        try {
+            const adapters = await loadSinglePlugin(pluginName, projectPath);
+            for (const adapter of adapters) {
+                registry[adapter.name] = adapter;
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[kit] plugin "${pluginName}" failed to load: ${msg}`);
+        }
+    }
+    return registry;
+}
+/**
+ * Read the kitPlugins array from package.json, returning [] if absent or unreadable.
+ */
+async function readkitPlugins(projectPath) {
+    try {
+        const pkgPath = resolve(projectPath, "package.json");
+        const raw = await readFile(pkgPath, "utf-8");
+        const pkg = JSON.parse(raw);
+        const plugins = pkg["kitPlugins"];
+        if (!Array.isArray(plugins))
+            return [];
+        return plugins.filter((p) => typeof p === "string");
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Attempt to load a plugin by name, trying `<plugin>/kit-adapter` first, then `<plugin>`.
+ * Returns an array of ServiceAdapters or throws if both entry points fail.
+ */
+async function loadSinglePlugin(pluginName, projectPath) {
+    // Resolve the plugin from the project's node_modules (not kit's own node_modules)
+    const candidates = [
+        join(projectPath, "node_modules", pluginName, "kit-adapter.js"),
+        join(projectPath, "node_modules", pluginName, "kit-adapter.cjs"),
+        join(projectPath, "node_modules", pluginName, "index.js"),
+        join(projectPath, "node_modules", pluginName),
+    ];
+    let mod;
+    let lastError;
+    for (const candidate of candidates) {
+        try {
+            mod = await import(candidate);
+            break;
+        }
+        catch (err) {
+            lastError = err;
+        }
+    }
+    if (mod === undefined) {
+        const msg = lastError instanceof Error ? lastError.message : String(lastError);
+        throw new Error(`Could not import "${pluginName}": ${msg}`);
+    }
+    return extractAdapters(mod, pluginName);
+}
+/**
+ * Extract ServiceAdapter(s) from a loaded module, handling both single and array forms.
+ */
+function extractAdapters(mod, pluginName) {
+    if (!mod || typeof mod !== "object") {
+        throw new Error(`Plugin "${pluginName}" does not export an object`);
+    }
+    const exports = mod;
+    // { adapters: ServiceAdapter[] }
+    if (Array.isArray(exports["adapters"])) {
+        const adapters = exports["adapters"].filter(isServiceAdapter);
+        if (adapters.length > 0)
+            return adapters;
+    }
+    // { adapter: ServiceAdapter }
+    if (isServiceAdapter(exports["adapter"])) {
+        return [exports["adapter"]];
+    }
+    // { default: { adapters } } or { default: ServiceAdapter }
+    const def = exports["default"];
+    if (def && typeof def === "object") {
+        const d = def;
+        if (Array.isArray(d["adapters"])) {
+            const adapters = d["adapters"].filter(isServiceAdapter);
+            if (adapters.length > 0)
+                return adapters;
+        }
+        if (isServiceAdapter(def))
+            return [def];
+    }
+    throw new Error(`Plugin "${pluginName}" must export { adapter } or { adapters } — got keys: ${Object.keys(exports).join(", ")}`);
+}
+function isServiceAdapter(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const v = value;
+    return (typeof v["name"] === "string" &&
+        typeof v["description"] === "string" &&
+        typeof v["check"] === "function" &&
+        typeof v["provision"] === "function" &&
+        typeof v["getRequiredTools"] === "function");
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/plugin-loader.js.map

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