@treeseed/sdk 0.4.8 → 0.4.10

package/dist/operations/services/project-platform.d.ts

@@ -0,0 +1,835 @@
+import { type ControlPlaneReporter } from '../../control-plane.ts';
+export type ProjectPlatformScope = 'local' | 'staging' | 'prod';
+export type ProjectPlatformAction = 'provision' | 'deploy_code' | 'publish_content' | 'monitor';
+export interface ProjectPlatformActionOptions {
+    tenantRoot: string;
+    scope: ProjectPlatformScope;
+    projectId?: string | null;
+    previewId?: string | null;
+    dryRun?: boolean;
+    reporter?: ControlPlaneReporter;
+}
+export declare function inferEnvironmentFromBranch(tenantRoot: string): "staging" | "prod";
+export declare function resolveScope(environment: string | null): ProjectPlatformScope;
+export declare function provisionProjectPlatform(options: ProjectPlatformActionOptions): Promise<{
+    ok: boolean;
+    scope: ProjectPlatformScope;
+    target: any;
+    summary: {
+        target: any;
+        workerName: any;
+        siteUrl: any;
+        accountId: any;
+        pages: any;
+        formGuardKv: any;
+        sessionKv: any;
+        siteDataDb: any;
+        queue: any;
+        content: any;
+    };
+    verification: {
+        ok: boolean;
+        target: any;
+        checks: {
+            pages: boolean;
+            formGuardKv: boolean;
+            sessionKv: boolean;
+            d1: boolean;
+            queue: boolean;
+            dlq: boolean;
+            r2: boolean;
+        };
+        state: any;
+    };
+    railway: {
+        services: string[];
+        schedules: {
+            id: any;
+            status: string;
+            enabled: any;
+            command: any;
+            service: string;
+            projectId: string | null;
+            projectName: string | null;
+            serviceId: string | null;
+            serviceName: string | null;
+            environment: string;
+            environmentId: string | null;
+            expression: string;
+            logicalName: string;
+        }[];
+        verification: {
+            ok: boolean;
+            checks: {
+                id: any;
+                ok: boolean;
+                service: string;
+                projectId: string | null;
+                projectName: string | null;
+                serviceId: string | null;
+                serviceName: string | null;
+                environment: string;
+                environmentId: string | null;
+                expression: string;
+                command: string | null;
+                enabled: boolean;
+                logicalName: string;
+            }[];
+        } | {
+            ok: boolean;
+            checks: {
+                id: any;
+                status: string;
+                enabled: any;
+                command: any;
+                service: string;
+                projectId: string | null;
+                projectName: string | null;
+                serviceId: string | null;
+                serviceName: string | null;
+                environment: string;
+                environmentId: string | null;
+                expression: string;
+                logicalName: string;
+            }[];
+        };
+    };
+}>;
+export declare function deployProjectPlatform(options: ProjectPlatformActionOptions): Promise<{
+    ok: boolean;
+    scope: ProjectPlatformScope;
+    monitor: {
+        ok: true;
+        target: any;
+        checks: {
+            r2: {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+                objectKey?: undefined;
+            } | {
+                ok: boolean;
+                objectKey: string;
+                skipped?: undefined;
+                reason?: undefined;
+            };
+            queue: {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+                messageId?: undefined;
+                attempts?: undefined;
+            } | {
+                ok: boolean;
+                reason: string;
+                skipped?: undefined;
+                messageId?: undefined;
+                attempts?: undefined;
+            } | {
+                ok: boolean;
+                messageId: string;
+                attempts: number;
+                skipped?: undefined;
+                reason?: undefined;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            runner: {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+                status?: undefined;
+                payload?: undefined;
+                heartbeatPresent?: undefined;
+                attempt?: undefined;
+                error?: undefined;
+            } | {
+                ok: any;
+                status: number;
+                payload: any;
+                heartbeatPresent: any;
+                attempt: number;
+                skipped?: undefined;
+                reason?: undefined;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                reason: string;
+                skipped?: undefined;
+                status?: undefined;
+                payload?: undefined;
+                heartbeatPresent?: undefined;
+                attempt?: undefined;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                error: string;
+                skipped?: undefined;
+                reason?: undefined;
+                status?: undefined;
+                payload?: undefined;
+                heartbeatPresent?: undefined;
+                attempt?: undefined;
+            };
+            pages: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            };
+            apiHealth: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            apiReady: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            d1Health: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            agentHealth: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            scaleProbe: {
+                ok: boolean;
+                mocked: boolean;
+                serviceId: any;
+            };
+            readiness: any;
+        };
+    };
+    serviceResults: {
+        service: any;
+        status: string;
+        command: string;
+        cwd: any;
+        publicBaseUrl: any;
+    }[];
+}>;
+export declare function publishProjectContent(options: ProjectPlatformActionOptions): Promise<{
+    ok: boolean;
+    scope: ProjectPlatformScope;
+    mode: string;
+    revision: string;
+    previewId: string | null;
+    previewUrl: string | null;
+    target: any;
+}>;
+export declare function monitorProjectPlatform(options: ProjectPlatformActionOptions): Promise<{
+    ok: true;
+    target: any;
+    checks: {
+        r2: {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+            objectKey?: undefined;
+        } | {
+            ok: boolean;
+            objectKey: string;
+            skipped?: undefined;
+            reason?: undefined;
+        };
+        queue: {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+            messageId?: undefined;
+            attempts?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            skipped?: undefined;
+            messageId?: undefined;
+            attempts?: undefined;
+        } | {
+            ok: boolean;
+            messageId: string;
+            attempts: number;
+            skipped?: undefined;
+            reason?: undefined;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        runner: {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+            status?: undefined;
+            payload?: undefined;
+            heartbeatPresent?: undefined;
+            attempt?: undefined;
+            error?: undefined;
+        } | {
+            ok: any;
+            status: number;
+            payload: any;
+            heartbeatPresent: any;
+            attempt: number;
+            skipped?: undefined;
+            reason?: undefined;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            skipped?: undefined;
+            status?: undefined;
+            payload?: undefined;
+            heartbeatPresent?: undefined;
+            attempt?: undefined;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            error: string;
+            skipped?: undefined;
+            reason?: undefined;
+            status?: undefined;
+            payload?: undefined;
+            heartbeatPresent?: undefined;
+            attempt?: undefined;
+        };
+        pages: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        };
+        apiHealth: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        apiReady: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        d1Health: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        agentHealth: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        scaleProbe: {
+            ok: boolean;
+            mocked: boolean;
+            serviceId: any;
+        };
+        readiness: any;
+    };
+}>;
+export declare function syncControlPlaneState(options: ProjectPlatformActionOptions): Promise<void>;
+export declare function runProjectPlatformAction(action: ProjectPlatformAction, options: ProjectPlatformActionOptions): Promise<{
+    ok: boolean;
+    scope: ProjectPlatformScope;
+    mode: string;
+    revision: string;
+    previewId: string | null;
+    previewUrl: string | null;
+    target: any;
+} | {
+    ok: boolean;
+    scope: ProjectPlatformScope;
+    target: any;
+    summary: {
+        target: any;
+        workerName: any;
+        siteUrl: any;
+        accountId: any;
+        pages: any;
+        formGuardKv: any;
+        sessionKv: any;
+        siteDataDb: any;
+        queue: any;
+        content: any;
+    };
+    verification: {
+        ok: boolean;
+        target: any;
+        checks: {
+            pages: boolean;
+            formGuardKv: boolean;
+            sessionKv: boolean;
+            d1: boolean;
+            queue: boolean;
+            dlq: boolean;
+            r2: boolean;
+        };
+        state: any;
+    };
+    railway: {
+        services: string[];
+        schedules: {
+            id: any;
+            status: string;
+            enabled: any;
+            command: any;
+            service: string;
+            projectId: string | null;
+            projectName: string | null;
+            serviceId: string | null;
+            serviceName: string | null;
+            environment: string;
+            environmentId: string | null;
+            expression: string;
+            logicalName: string;
+        }[];
+        verification: {
+            ok: boolean;
+            checks: {
+                id: any;
+                ok: boolean;
+                service: string;
+                projectId: string | null;
+                projectName: string | null;
+                serviceId: string | null;
+                serviceName: string | null;
+                environment: string;
+                environmentId: string | null;
+                expression: string;
+                command: string | null;
+                enabled: boolean;
+                logicalName: string;
+            }[];
+        } | {
+            ok: boolean;
+            checks: {
+                id: any;
+                status: string;
+                enabled: any;
+                command: any;
+                service: string;
+                projectId: string | null;
+                projectName: string | null;
+                serviceId: string | null;
+                serviceName: string | null;
+                environment: string;
+                environmentId: string | null;
+                expression: string;
+                logicalName: string;
+            }[];
+        };
+    };
+} | {
+    ok: true;
+    target: any;
+    checks: {
+        r2: {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+            objectKey?: undefined;
+        } | {
+            ok: boolean;
+            objectKey: string;
+            skipped?: undefined;
+            reason?: undefined;
+        };
+        queue: {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+            messageId?: undefined;
+            attempts?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            skipped?: undefined;
+            messageId?: undefined;
+            attempts?: undefined;
+        } | {
+            ok: boolean;
+            messageId: string;
+            attempts: number;
+            skipped?: undefined;
+            reason?: undefined;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        runner: {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+            status?: undefined;
+            payload?: undefined;
+            heartbeatPresent?: undefined;
+            attempt?: undefined;
+            error?: undefined;
+        } | {
+            ok: any;
+            status: number;
+            payload: any;
+            heartbeatPresent: any;
+            attempt: number;
+            skipped?: undefined;
+            reason?: undefined;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            reason: string;
+            skipped?: undefined;
+            status?: undefined;
+            payload?: undefined;
+            heartbeatPresent?: undefined;
+            attempt?: undefined;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            error: string;
+            skipped?: undefined;
+            reason?: undefined;
+            status?: undefined;
+            payload?: undefined;
+            heartbeatPresent?: undefined;
+            attempt?: undefined;
+        };
+        pages: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        };
+        apiHealth: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        apiReady: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        d1Health: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        agentHealth: {
+            ok: boolean;
+            status: number;
+            url: string;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            status: null;
+            url: string;
+            error: string;
+        } | {
+            ok: boolean;
+            skipped: boolean;
+            reason: string;
+        };
+        scaleProbe: {
+            ok: boolean;
+            mocked: boolean;
+            serviceId: any;
+        };
+        readiness: any;
+    };
+} | {
+    ok: boolean;
+    scope: ProjectPlatformScope;
+    monitor: {
+        ok: true;
+        target: any;
+        checks: {
+            r2: {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+                objectKey?: undefined;
+            } | {
+                ok: boolean;
+                objectKey: string;
+                skipped?: undefined;
+                reason?: undefined;
+            };
+            queue: {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+                messageId?: undefined;
+                attempts?: undefined;
+            } | {
+                ok: boolean;
+                reason: string;
+                skipped?: undefined;
+                messageId?: undefined;
+                attempts?: undefined;
+            } | {
+                ok: boolean;
+                messageId: string;
+                attempts: number;
+                skipped?: undefined;
+                reason?: undefined;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            runner: {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+                status?: undefined;
+                payload?: undefined;
+                heartbeatPresent?: undefined;
+                attempt?: undefined;
+                error?: undefined;
+            } | {
+                ok: any;
+                status: number;
+                payload: any;
+                heartbeatPresent: any;
+                attempt: number;
+                skipped?: undefined;
+                reason?: undefined;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                reason: string;
+                skipped?: undefined;
+                status?: undefined;
+                payload?: undefined;
+                heartbeatPresent?: undefined;
+                attempt?: undefined;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                error: string;
+                skipped?: undefined;
+                reason?: undefined;
+                status?: undefined;
+                payload?: undefined;
+                heartbeatPresent?: undefined;
+                attempt?: undefined;
+            };
+            pages: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            };
+            apiHealth: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            apiReady: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            d1Health: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            agentHealth: {
+                ok: boolean;
+                status: number;
+                url: string;
+                error?: undefined;
+            } | {
+                ok: boolean;
+                status: null;
+                url: string;
+                error: string;
+            } | {
+                ok: boolean;
+                skipped: boolean;
+                reason: string;
+            };
+            scaleProbe: {
+                ok: boolean;
+                mocked: boolean;
+                serviceId: any;
+            };
+            readiness: any;
+        };
+    };
+    serviceResults: {
+        service: any;
+        status: string;
+        command: string;
+        cwd: any;
+        publicBaseUrl: any;
+    }[];
+}>;