@treeseed/sdk 0.5.2 → 0.6.0

package/dist/reconcile/engine.d.ts

@@ -0,0 +1,405 @@
+import type { TreeseedObservedUnitState, TreeseedReconcilePlan, TreeseedReconcileResult, TreeseedReconcileStateRecord, TreeseedReconcileTarget, TreeseedUnitVerificationResult } from './contracts.ts';
+export declare function observeTreeseedUnits({ tenantRoot, target, env, write, }: {
+    tenantRoot: string;
+    target: TreeseedReconcileTarget;
+    env?: NodeJS.ProcessEnv;
+    write?: (line: string) => void;
+}): Promise<{
+    units: import("./contracts.ts").TreeseedDesiredUnit[];
+    observations: Map<string, TreeseedObservedUnitState>;
+    state: TreeseedReconcileStateRecord;
+    deployConfig: {
+        name: string;
+        slug: string;
+        siteUrl: string;
+        contactEmail: string;
+        hosting: {
+            kind: string;
+            registration: any;
+            marketBaseUrl: any;
+            teamId: any;
+            projectId: any;
+        };
+        hub: {
+            mode: string;
+        };
+        runtime: {
+            mode: string;
+            registration: any;
+            marketBaseUrl: any;
+            teamId: any;
+            projectId: any;
+        };
+        cloudflare: {
+            accountId: string;
+            zoneId: string | undefined;
+            workerName: string | undefined;
+            queueName: string | undefined;
+            dlqName: string | undefined;
+            d1Binding: string | undefined;
+            queueBinding: string | undefined;
+            pages: {
+                projectName: string | undefined;
+                previewProjectName: string | undefined;
+                productionBranch: string;
+                stagingBranch: string;
+                buildOutputDir: string | undefined;
+            } | undefined;
+            r2: {
+                binding: string | undefined;
+                bucketName: string | undefined;
+                publicBaseUrl: string | undefined;
+                manifestKeyTemplate: string;
+                previewRootTemplate: string;
+                previewTtlHours: number;
+            } | 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;
+            dns: string;
+            content: {
+                runtime: string;
+                publish: string;
+                docs: string;
+                serving: any;
+            };
+            site: string;
+        };
+        surfaces: {
+            [k: string]: {
+                enabled: boolean | undefined;
+                provider: string | undefined;
+                rootDir: string | undefined;
+                publicBaseUrl: string | undefined;
+                localBaseUrl: 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;
+                cache: {
+                    sourcePages: {
+                        browserTtlSeconds: number | undefined;
+                        edgeTtlSeconds: number | undefined;
+                        staleWhileRevalidateSeconds: number | undefined;
+                        staleIfErrorSeconds: number | undefined;
+                    } | {
+                        paths: any[];
+                    } | undefined;
+                    contentPages: {
+                        browserTtlSeconds: number | undefined;
+                        edgeTtlSeconds: number | undefined;
+                        staleWhileRevalidateSeconds: number | undefined;
+                        staleIfErrorSeconds: number | undefined;
+                    } | {
+                        paths: any[];
+                    } | undefined;
+                    r2PublishedObjects: {
+                        browserTtlSeconds: number | undefined;
+                        edgeTtlSeconds: number | undefined;
+                        staleWhileRevalidateSeconds: number | undefined;
+                        staleIfErrorSeconds: number | undefined;
+                    } | {
+                        paths: any[];
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        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;
+                    schedule: any;
+                };
+                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 planTreeseedReconciliation({ tenantRoot, target, env, write, }: {
+    tenantRoot: string;
+    target: TreeseedReconcileTarget;
+    env?: NodeJS.ProcessEnv;
+    write?: (line: string) => void;
+}): Promise<{
+    plans: TreeseedReconcilePlan[];
+    units: import("./contracts.ts").TreeseedDesiredUnit[];
+    observations: Map<string, TreeseedObservedUnitState>;
+    state: TreeseedReconcileStateRecord;
+    deployConfig: {
+        name: string;
+        slug: string;
+        siteUrl: string;
+        contactEmail: string;
+        hosting: {
+            kind: string;
+            registration: any;
+            marketBaseUrl: any;
+            teamId: any;
+            projectId: any;
+        };
+        hub: {
+            mode: string;
+        };
+        runtime: {
+            mode: string;
+            registration: any;
+            marketBaseUrl: any;
+            teamId: any;
+            projectId: any;
+        };
+        cloudflare: {
+            accountId: string;
+            zoneId: string | undefined;
+            workerName: string | undefined;
+            queueName: string | undefined;
+            dlqName: string | undefined;
+            d1Binding: string | undefined;
+            queueBinding: string | undefined;
+            pages: {
+                projectName: string | undefined;
+                previewProjectName: string | undefined;
+                productionBranch: string;
+                stagingBranch: string;
+                buildOutputDir: string | undefined;
+            } | undefined;
+            r2: {
+                binding: string | undefined;
+                bucketName: string | undefined;
+                publicBaseUrl: string | undefined;
+                manifestKeyTemplate: string;
+                previewRootTemplate: string;
+                previewTtlHours: number;
+            } | 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;
+            dns: string;
+            content: {
+                runtime: string;
+                publish: string;
+                docs: string;
+                serving: any;
+            };
+            site: string;
+        };
+        surfaces: {
+            [k: string]: {
+                enabled: boolean | undefined;
+                provider: string | undefined;
+                rootDir: string | undefined;
+                publicBaseUrl: string | undefined;
+                localBaseUrl: 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;
+                cache: {
+                    sourcePages: {
+                        browserTtlSeconds: number | undefined;
+                        edgeTtlSeconds: number | undefined;
+                        staleWhileRevalidateSeconds: number | undefined;
+                        staleIfErrorSeconds: number | undefined;
+                    } | {
+                        paths: any[];
+                    } | undefined;
+                    contentPages: {
+                        browserTtlSeconds: number | undefined;
+                        edgeTtlSeconds: number | undefined;
+                        staleWhileRevalidateSeconds: number | undefined;
+                        staleIfErrorSeconds: number | undefined;
+                    } | {
+                        paths: any[];
+                    } | undefined;
+                    r2PublishedObjects: {
+                        browserTtlSeconds: number | undefined;
+                        edgeTtlSeconds: number | undefined;
+                        staleWhileRevalidateSeconds: number | undefined;
+                        staleIfErrorSeconds: number | undefined;
+                    } | {
+                        paths: any[];
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        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;
+                    schedule: any;
+                };
+                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 reconcileTreeseedTarget({ tenantRoot, target, env, write, }: {
+    tenantRoot: string;
+    target: TreeseedReconcileTarget;
+    env?: NodeJS.ProcessEnv;
+    write?: (line: string) => void;
+}): Promise<{
+    target: TreeseedReconcileTarget;
+    units: import("./contracts.ts").TreeseedDesiredUnit[];
+    plans: TreeseedReconcilePlan[];
+    results: TreeseedReconcileResult[];
+    state: TreeseedReconcileStateRecord;
+}>;
+export declare function destroyTreeseedTargetUnits({ tenantRoot, target, env, write, }: {
+    tenantRoot: string;
+    target: TreeseedReconcileTarget;
+    env?: NodeJS.ProcessEnv;
+    write?: (line: string) => void;
+}): Promise<{
+    target: TreeseedReconcileTarget;
+    results: TreeseedReconcileResult[];
+}>;
+export declare function collectTreeseedReconcileStatus({ tenantRoot, target, env, }: {
+    tenantRoot: string;
+    target: TreeseedReconcileTarget;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    target: TreeseedReconcileTarget;
+    ready: boolean;
+    blockers: string[];
+    warnings: string[];
+    units: {
+        unitId: string;
+        unitType: import("./contracts.ts").TreeseedReconcileUnitType;
+        provider: string;
+        status: import("./contracts.ts").TreeseedReconcileStatusKind;
+        exists: boolean;
+        locators: Record<string, string | null>;
+        warnings: string[];
+        verification: TreeseedUnitVerificationResult | null;
+    }[];
+}>;