@treeseed/sdk 0.10.28 → 0.12.4

package/dist/reconcile/engine.d.ts

@@ -1,439 +1,72 @@
-import type { TreeseedObservedUnitState, TreeseedReconcilePlan, TreeseedReconcileResult, TreeseedReconcileStateRecord, TreeseedReconcileTarget, TreeseedUnitVerificationResult } from './contracts.ts';
-import { type TreeseedRunnableBootstrapSystem } from './bootstrap-systems.ts';
-import { type TreeseedTimingEntry } from '../timing.ts';
-export declare function observeTreeseedUnits({ tenantRoot, target, env, systems, write, }: {
+import type { TreeseedDesiredUnit, TreeseedObservedUnitState, TreeseedReconcilePlan, TreeseedReconcileResult, TreeseedReconcileRunContext, TreeseedReconcileSelector, TreeseedReconcileStateRecord, TreeseedReconcileTarget, TreeseedUnitVerificationResult } from './contracts.js';
+import { type TreeseedRunnableBootstrapSystem } from './bootstrap-systems.js';
+import { type TreeseedTimingEntry } from '../timing.js';
+export declare function refreshTreeseedUnits({ tenantRoot, target, env, systems, selector, units: explicitUnits, write, }: {
     tenantRoot: string;
     target: TreeseedReconcileTarget;
     env?: NodeJS.ProcessEnv;
     systems?: TreeseedRunnableBootstrapSystem[];
+    selector?: TreeseedReconcileSelector;
+    units?: TreeseedDesiredUnit[];
     write?: (line: string) => void;
 }): Promise<{
-    units: import("./contracts.ts").TreeseedDesiredUnit[];
+    units: 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;
-                local: {
-                    runtime: string | undefined;
-                } | 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;
-                local: {
-                    runtime: string | undefined;
-                } | undefined;
-                cloudflare: {
-                    workerName: string | undefined;
-                };
-                railway: {
-                    projectId: string | undefined;
-                    projectName: string | undefined;
-                    serviceId: string | undefined;
-                    serviceName: string | undefined;
-                    resourceType: string | undefined;
-                    environmentVariable: string | undefined;
-                    serviceTargets: any;
-                    rootDir: string | undefined;
-                    buildCommand: string | undefined;
-                    startCommand: string | undefined;
-                    healthcheckPath: string | undefined;
-                    healthcheckTimeoutSeconds: number | undefined;
-                    healthcheckIntervalSeconds: number | undefined;
-                    restartPolicy: string | undefined;
-                    runtimeMode: string | undefined;
-                    volumeMountPath: string | undefined;
-                    runnerPool: {
-                        bootstrapCount: number | undefined;
-                        maxRunners: number | undefined;
-                        volumeMountPath: string | undefined;
-                    } | 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;
-        };
-    };
+    deployConfig: import("../platform/contracts.js").TreeseedDeployConfig;
 }>;
-export declare function planTreeseedReconciliation({ tenantRoot, target, env, systems, write, }: {
+export declare function planTreeseedReconciliation({ tenantRoot, target, env, systems, selector, units, write, }: {
     tenantRoot: string;
     target: TreeseedReconcileTarget;
     env?: NodeJS.ProcessEnv;
     systems?: TreeseedRunnableBootstrapSystem[];
+    selector?: TreeseedReconcileSelector;
+    units?: TreeseedDesiredUnit[];
     write?: (line: string) => void;
 }): Promise<{
     plans: TreeseedReconcilePlan[];
-    units: import("./contracts.ts").TreeseedDesiredUnit[];
+    units: 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;
-                local: {
-                    runtime: string | undefined;
-                } | 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;
-                local: {
-                    runtime: string | undefined;
-                } | undefined;
-                cloudflare: {
-                    workerName: string | undefined;
-                };
-                railway: {
-                    projectId: string | undefined;
-                    projectName: string | undefined;
-                    serviceId: string | undefined;
-                    serviceName: string | undefined;
-                    resourceType: string | undefined;
-                    environmentVariable: string | undefined;
-                    serviceTargets: any;
-                    rootDir: string | undefined;
-                    buildCommand: string | undefined;
-                    startCommand: string | undefined;
-                    healthcheckPath: string | undefined;
-                    healthcheckTimeoutSeconds: number | undefined;
-                    healthcheckIntervalSeconds: number | undefined;
-                    restartPolicy: string | undefined;
-                    runtimeMode: string | undefined;
-                    volumeMountPath: string | undefined;
-                    runnerPool: {
-                        bootstrapCount: number | undefined;
-                        maxRunners: number | undefined;
-                        volumeMountPath: string | undefined;
-                    } | 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;
-        };
-    };
+    deployConfig: import("../platform/contracts.js").TreeseedDeployConfig;
 }>;
-export declare function reconcileTreeseedTarget({ tenantRoot, target, env, systems, write, }: {
+export declare function reconcileTreeseedTarget({ tenantRoot, target, env, systems, selector, units, write, dryRun, session, }: {
     tenantRoot: string;
     target: TreeseedReconcileTarget;
     env?: NodeJS.ProcessEnv;
     systems?: TreeseedRunnableBootstrapSystem[];
+    selector?: TreeseedReconcileSelector;
+    units?: TreeseedDesiredUnit[];
     write?: (line: string) => void;
+    dryRun?: boolean;
+    session?: Map<string, unknown>;
 }): Promise<{
     target: TreeseedReconcileTarget;
-    units: import("./contracts.ts").TreeseedDesiredUnit[];
+    units: TreeseedDesiredUnit[];
     plans: TreeseedReconcilePlan[];
     results: TreeseedReconcileResult[];
     state: TreeseedReconcileStateRecord;
     timings: TreeseedTimingEntry[];
 }>;
-export declare function destroyTreeseedTargetUnits({ tenantRoot, target, env, write, }: {
+export declare function destroyTreeseedTargetUnits({ tenantRoot, target, env, selector, units: explicitUnits, write, }: {
     tenantRoot: string;
     target: TreeseedReconcileTarget;
     env?: NodeJS.ProcessEnv;
+    selector?: TreeseedReconcileSelector;
+    units?: TreeseedDesiredUnit[];
     write?: (line: string) => void;
 }): Promise<{
     target: TreeseedReconcileTarget;
     results: TreeseedReconcileResult[];
 }>;
-export declare function collectTreeseedReconcileStatus({ tenantRoot, target, env, systems, }: {
+export declare function collectTreeseedReconcileStatus({ tenantRoot, target, env, systems, selector, units, session, }: {
     tenantRoot: string;
     target: TreeseedReconcileTarget;
     env?: NodeJS.ProcessEnv;
     systems?: TreeseedRunnableBootstrapSystem[];
+    selector?: TreeseedReconcileSelector;
+    units?: TreeseedDesiredUnit[];
+    session?: Map<string, unknown>;
 }): Promise<{
     target: TreeseedReconcileTarget;
     ready: boolean;
@@ -441,9 +74,42 @@ export declare function collectTreeseedReconcileStatus({ tenantRoot, target, env
     warnings: string[];
     units: {
         unitId: string;
-        unitType: import("./contracts.ts").TreeseedReconcileUnitType;
+        unitType: import("./contracts.js").TreeseedReconcileUnitType;
         provider: string;
-        status: import("./contracts.ts").TreeseedReconcileStatusKind;
+        status: import("./contracts.js").TreeseedReconcileStatusKind;
+        exists: boolean;
+        locators: Record<string, string | null>;
+        warnings: string[];
+        verification: TreeseedUnitVerificationResult | null;
+    }[];
+}>;
+export declare function reconcileTreeseedNestedTarget({ parentContext, selector, target, dryRun, }: {
+    parentContext: TreeseedReconcileRunContext;
+    selector: TreeseedReconcileSelector;
+    target: TreeseedReconcileTarget;
+    dryRun: boolean;
+}): Promise<{
+    target: TreeseedReconcileTarget;
+    units: TreeseedDesiredUnit[];
+    plans: TreeseedReconcilePlan[];
+    results: TreeseedReconcileResult[];
+    state: TreeseedReconcileStateRecord;
+    timings: TreeseedTimingEntry[];
+}>;
+export declare function verifyTreeseedNestedTarget({ parentContext, selector, target, }: {
+    parentContext: TreeseedReconcileRunContext;
+    selector: TreeseedReconcileSelector;
+    target: TreeseedReconcileTarget;
+}): Promise<{
+    target: TreeseedReconcileTarget;
+    ready: boolean;
+    blockers: string[];
+    warnings: string[];
+    units: {
+        unitId: string;
+        unitType: import("./contracts.js").TreeseedReconcileUnitType;
+        provider: string;
+        status: import("./contracts.js").TreeseedReconcileStatusKind;
         exists: boolean;
         locators: Record<string, string | null>;
         warnings: string[];