@treeseed/sdk 0.1.1 → 0.3.0

package/dist/operations/services/d1-migration.d.ts

@@ -0,0 +1,6 @@
+export declare function runLocalD1Migrations({ cwd, wranglerConfig, migrationsRoot, persistTo }: {
+    cwd: any;
+    wranglerConfig: any;
+    migrationsRoot: any;
+    persistTo: any;
+}): void;

package/dist/operations/services/d1-migration.js

@@ -0,0 +1,89 @@
+import { existsSync, readdirSync } from "node:fs";
+import { resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+import { resolveWranglerBin } from "./runtime-tools.js";
+const DATABASE_BINDING = "SITE_DATA_DB";
+function runWrangler(args, { cwd, capture = false } = {}) {
+  return spawnSync(process.execPath, [resolveWranglerBin(), ...args], {
+    cwd,
+    env: { ...process.env },
+    stdio: capture ? ["ignore", "pipe", "pipe"] : "inherit",
+    encoding: capture ? "utf8" : void 0
+  });
+}
+function executeSqlFile({ cwd, wranglerConfig, filePath, persistTo }) {
+  const args = ["d1", "execute", DATABASE_BINDING, "--local", "--config", wranglerConfig, "--file", filePath];
+  if (persistTo) {
+    args.push("--persist-to", persistTo);
+  }
+  const result = runWrangler(args, { cwd });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+function executeSqlCommand({ cwd, wranglerConfig, command, persistTo, capture = false }) {
+  const args = ["d1", "execute", DATABASE_BINDING, "--local", "--config", wranglerConfig, "--command", command];
+  if (persistTo) {
+    args.push("--persist-to", persistTo);
+  }
+  const result = runWrangler(args, { cwd, capture });
+  if (result.status !== 0) {
+    if (capture) {
+      if (result.stdout) process.stdout.write(result.stdout);
+      if (result.stderr) process.stderr.write(result.stderr);
+    }
+    process.exit(result.status ?? 1);
+  }
+  return result;
+}
+function ensureSchemaMigrationsTable({ cwd, wranglerConfig, persistTo }) {
+  executeSqlCommand({
+    cwd,
+    wranglerConfig,
+    persistTo,
+    command: `CREATE TABLE IF NOT EXISTS treeseed_schema_migrations (
+			name TEXT PRIMARY KEY,
+			applied_at TEXT NOT NULL
+		);`
+  });
+}
+function loadAppliedMigrations({ cwd, wranglerConfig, persistTo }) {
+  const result = executeSqlCommand({
+    cwd,
+    wranglerConfig,
+    persistTo,
+    capture: true,
+    command: "SELECT name FROM treeseed_schema_migrations ORDER BY name ASC;"
+  });
+  const parsed = JSON.parse(result.stdout);
+  const rows = (Array.isArray(parsed) ? parsed : [parsed]).flatMap((entry) => entry.results ?? []);
+  return new Set(rows.map((row) => row.name).filter(Boolean));
+}
+function markMigrationApplied({ cwd, wranglerConfig, persistTo, migration }) {
+  executeSqlCommand({
+    cwd,
+    wranglerConfig,
+    persistTo,
+    command: `INSERT OR REPLACE INTO treeseed_schema_migrations (name, applied_at) VALUES ('${migration.replace(/'/g, "''")}', datetime('now'));`
+  });
+}
+function runLocalD1Migrations({ cwd, wranglerConfig, migrationsRoot, persistTo }) {
+  ensureSchemaMigrationsTable({ cwd, wranglerConfig, persistTo });
+  const appliedMigrations = loadAppliedMigrations({ cwd, wranglerConfig, persistTo });
+  const migrations = readdirSync(migrationsRoot).filter((entry) => /^\d+.*\.sql$/i.test(entry)).sort((left, right) => left.localeCompare(right, void 0, { numeric: true }));
+  for (const migration of migrations) {
+    if (appliedMigrations.has(migration)) {
+      continue;
+    }
+    const filePath = resolve(migrationsRoot, migration);
+    if (!existsSync(filePath)) {
+      console.error(`Unable to find migration file at ${filePath}.`);
+      process.exit(1);
+    }
+    executeSqlFile({ cwd, wranglerConfig, filePath, persistTo });
+    markMigrationApplied({ cwd, wranglerConfig, persistTo, migration });
+  }
+}
+export {
+  runLocalD1Migrations
+};

package/dist/operations/services/deploy.d.ts

@@ -0,0 +1,371 @@
+export declare function normalizePersistentScope(scope?: string): string;
+export declare function createPersistentDeployTarget(scope?: string): {
+    kind: string;
+    scope: string;
+};
+export declare function createBranchPreviewDeployTarget(branchName: any): {
+    kind: string;
+    branchName: string;
+};
+export declare function scopeFromTarget(target: any): any;
+export declare function deployTargetLabel(scopeOrTarget?: string): any;
+export declare function loadDeployState(tenantRoot: any, deployConfig: any, options?: {}): any;
+export declare function writeDeployState(tenantRoot: any, state: any, options?: {}): void;
+export declare function resolveGeneratedWranglerPath(tenantRoot: any, options?: {}): string;
+export declare function buildWranglerConfigContents(tenantRoot: any, deployConfig: any, state: any, options?: {}): string;
+export declare function ensureGeneratedWranglerConfig(tenantRoot: any, options?: {}): {
+    wranglerPath: string;
+    deployConfig: {
+        name: string;
+        slug: string;
+        siteUrl: string;
+        contactEmail: string;
+        cloudflare: {
+            accountId: string;
+            workerName: string | undefined;
+            gatewayWorkerName: string | undefined;
+            queueName: string | undefined;
+            dlqName: string | undefined;
+            d1Binding: string | undefined;
+            queueBinding: string | undefined;
+        };
+        plugins: {
+            package: string;
+            enabled: boolean;
+        }[] | {
+            package: string;
+            enabled: boolean | undefined;
+            config: any;
+        }[];
+        providers: {
+            forms: string;
+            agents: {
+                execution: string;
+                mutation: string;
+                repository: string;
+                verification: string;
+                notification: string;
+                research: string;
+            };
+            deploy: string;
+            content: {
+                docs: string;
+            };
+            site: string;
+        };
+        services: {
+            [k: string]: {
+                enabled: boolean | undefined;
+                provider: string | undefined;
+                rootDir: string | undefined;
+                publicBaseUrl: string | undefined;
+                cloudflare: {
+                    workerName: string | undefined;
+                };
+                railway: {
+                    projectId: string | undefined;
+                    projectName: string | undefined;
+                    serviceId: string | undefined;
+                    serviceName: string | undefined;
+                    rootDir: string | undefined;
+                    buildCommand: string | undefined;
+                    startCommand: string | undefined;
+                };
+                environments: {
+                    local: {
+                        baseUrl: string | undefined;
+                        domain: string | undefined;
+                        railwayEnvironment: string | undefined;
+                    };
+                    staging: {
+                        baseUrl: string | undefined;
+                        domain: string | undefined;
+                        railwayEnvironment: string | undefined;
+                    };
+                    prod: {
+                        baseUrl: string | undefined;
+                        domain: string | undefined;
+                        railwayEnvironment: string | undefined;
+                    };
+                };
+            } | undefined;
+        } | undefined;
+        smtp: {
+            enabled: boolean | undefined;
+        };
+        turnstile: {
+            enabled: boolean;
+        };
+    };
+    state: any;
+    manifestFingerprint: string;
+    target: {
+        kind: string;
+        scope: string;
+    } | {
+        kind: string;
+        branchName: string;
+    };
+};
+export declare function collectMissingDeployInputs(tenantRoot: any): {
+    key: string;
+    label: string;
+    message: string;
+}[];
+export declare function promptForMissingDeployInputs(tenantRoot: any): Promise<{
+    prompted: boolean;
+    provided: string[];
+}>;
+export declare function validateDeployPrerequisites(tenantRoot: any, { requireRemote }?: {
+    requireRemote?: boolean | undefined;
+}): {
+    name: string;
+    slug: string;
+    siteUrl: string;
+    contactEmail: string;
+    cloudflare: {
+        accountId: string;
+        workerName: string | undefined;
+        gatewayWorkerName: string | undefined;
+        queueName: string | undefined;
+        dlqName: string | undefined;
+        d1Binding: string | undefined;
+        queueBinding: string | undefined;
+    };
+    plugins: {
+        package: string;
+        enabled: boolean;
+    }[] | {
+        package: string;
+        enabled: boolean | undefined;
+        config: any;
+    }[];
+    providers: {
+        forms: string;
+        agents: {
+            execution: string;
+            mutation: string;
+            repository: string;
+            verification: string;
+            notification: string;
+            research: string;
+        };
+        deploy: string;
+        content: {
+            docs: string;
+        };
+        site: string;
+    };
+    services: {
+        [k: string]: {
+            enabled: boolean | undefined;
+            provider: string | undefined;
+            rootDir: string | undefined;
+            publicBaseUrl: string | undefined;
+            cloudflare: {
+                workerName: string | undefined;
+            };
+            railway: {
+                projectId: string | undefined;
+                projectName: string | undefined;
+                serviceId: string | undefined;
+                serviceName: string | undefined;
+                rootDir: string | undefined;
+                buildCommand: string | undefined;
+                startCommand: string | undefined;
+            };
+            environments: {
+                local: {
+                    baseUrl: string | undefined;
+                    domain: string | undefined;
+                    railwayEnvironment: string | undefined;
+                };
+                staging: {
+                    baseUrl: string | undefined;
+                    domain: string | undefined;
+                    railwayEnvironment: string | undefined;
+                };
+                prod: {
+                    baseUrl: string | undefined;
+                    domain: string | undefined;
+                    railwayEnvironment: string | undefined;
+                };
+            };
+        } | undefined;
+    } | undefined;
+    smtp: {
+        enabled: boolean | undefined;
+    };
+    turnstile: {
+        enabled: boolean;
+    };
+};
+export declare function validateDestroyPrerequisites(tenantRoot: any, { requireRemote }?: {
+    requireRemote?: boolean | undefined;
+}): {
+    name: string;
+    slug: string;
+    siteUrl: string;
+    contactEmail: string;
+    cloudflare: {
+        accountId: string;
+        workerName: string | undefined;
+        gatewayWorkerName: string | undefined;
+        queueName: string | undefined;
+        dlqName: string | undefined;
+        d1Binding: string | undefined;
+        queueBinding: string | undefined;
+    };
+    plugins: {
+        package: string;
+        enabled: boolean;
+    }[] | {
+        package: string;
+        enabled: boolean | undefined;
+        config: any;
+    }[];
+    providers: {
+        forms: string;
+        agents: {
+            execution: string;
+            mutation: string;
+            repository: string;
+            verification: string;
+            notification: string;
+            research: string;
+        };
+        deploy: string;
+        content: {
+            docs: string;
+        };
+        site: string;
+    };
+    services: {
+        [k: string]: {
+            enabled: boolean | undefined;
+            provider: string | undefined;
+            rootDir: string | undefined;
+            publicBaseUrl: string | undefined;
+            cloudflare: {
+                workerName: string | undefined;
+            };
+            railway: {
+                projectId: string | undefined;
+                projectName: string | undefined;
+                serviceId: string | undefined;
+                serviceName: string | undefined;
+                rootDir: string | undefined;
+                buildCommand: string | undefined;
+                startCommand: string | undefined;
+            };
+            environments: {
+                local: {
+                    baseUrl: string | undefined;
+                    domain: string | undefined;
+                    railwayEnvironment: string | undefined;
+                };
+                staging: {
+                    baseUrl: string | undefined;
+                    domain: string | undefined;
+                    railwayEnvironment: string | undefined;
+                };
+                prod: {
+                    baseUrl: string | undefined;
+                    domain: string | undefined;
+                    railwayEnvironment: string | undefined;
+                };
+            };
+        } | undefined;
+    } | undefined;
+    smtp: {
+        enabled: boolean | undefined;
+    };
+    turnstile: {
+        enabled: boolean;
+    };
+};
+export declare function destroyCloudflareResources(tenantRoot: any, options?: {}): {
+    target: {
+        kind: string;
+        scope: string;
+    } | {
+        kind: string;
+        branchName: string;
+    };
+    summary: {
+        target: any;
+        workerName: any;
+        siteUrl: any;
+        accountId: any;
+        formGuardKv: any;
+        sessionKv: any;
+        siteDataDb: any;
+    };
+    operations: {
+        worker: {
+            status: string;
+            name: any;
+        };
+        formGuard: {
+            status: string;
+            id: any;
+            preview?: undefined;
+        } | {
+            status: string;
+            id: any;
+            preview: boolean;
+        };
+        formGuardPreview: {
+            status: string;
+            id: any;
+            preview?: undefined;
+        } | {
+            status: string;
+            id: any;
+            preview: boolean;
+        } | null;
+        session: {
+            status: string;
+            id: any;
+            preview?: undefined;
+        } | {
+            status: string;
+            id: any;
+            preview: boolean;
+        };
+        sessionPreview: {
+            status: string;
+            id: any;
+            preview?: undefined;
+        } | {
+            status: string;
+            id: any;
+            preview: boolean;
+        } | null;
+        database: {
+            status: string;
+            name: any;
+        };
+    };
+};
+export declare function cleanupDestroyedState(tenantRoot: any, options?: {}): void;
+export declare function provisionCloudflareResources(tenantRoot: any, options?: {}): {
+    target: any;
+    workerName: any;
+    siteUrl: any;
+    accountId: any;
+    formGuardKv: any;
+    sessionKv: any;
+    siteDataDb: any;
+};
+export declare function syncCloudflareSecrets(tenantRoot: any, options?: {}): string[];
+export declare function runRemoteD1Migrations(tenantRoot: any, options?: {}): {
+    databaseName: any;
+    dryRun: boolean;
+};
+export declare function markDeploymentInitialized(tenantRoot: any, options?: {}): any;
+export declare function markManagedServicesInitialized(tenantRoot: any, options?: {}): any;
+export declare function assertDeploymentInitialized(tenantRoot: any, options?: {}): any;
+export declare function finalizeDeploymentState(tenantRoot: any, options?: {}): any;
+export declare function printDeploySummary(summary: any): void;
+export declare function printDestroySummary(result: any): void;