@fabrika/provider-zerops 0.8.2 → 0.9.0-cloudflare.2

package/types/src/api/polling.d.ts

@@ -0,0 +1,41 @@
+import type { Sleeper } from '../collaborators';
+import { type ZeropsApi, type ZeropsProcess } from './types';
+/**
+ * Poll ONE process to completion.
+ *
+ * The same loop `deployPlatformService` (`installation/deploy.ts`) runs over `/app-version`, run over `/process`
+ * instead: read, decide ONLY on a status this build knows to be terminal, sleep, and give up on a deadline
+ * of our own rather than on a coincidence. Returns the finished process so a caller can read
+ * `actionName`/`appVersionId` off it.
+ *
+ * Anything outside `ZEROPS_PROCESS_TERMINAL` means "keep waiting", including a status this build has never
+ * seen — which is why an unpublished vocabulary (see that constant) can cost a timeout and never a false
+ * success. A non-`FINISHED` terminal status throws, naming the status and nothing else.
+ */
+export declare const waitForProcess: (input: {
+    api: Pick<ZeropsApi, "getProcess">;
+    processId: string;
+    sleep: Sleeper;
+    signal: AbortSignal;
+    /** What to call this process in a failure or timeout message. Defaults to its id. */
+    label?: string;
+    intervalMs?: number;
+    attempts?: number;
+}) => Promise<ZeropsProcess>;
+/**
+ * `enableSubdomainAccess`, repeated while the service does not yet publish an HTTP port.
+ *
+ * Live-verified: right after a service's first app version reads ACTIVE the platform still answers
+ * `serviceStackIsNotHttp`, and a minute later the same call is accepted. The ports lag ACTIVE, so that
+ * answer means "not yet" for a bounded window. Past it the last refusal is rethrown unchanged, so a caller
+ * still names the missing port. Any other failure is rethrown at once. The 2xx still proves nothing: the
+ * caller decides by reading `subdomainAccess` back.
+ */
+export declare const enableSubdomainAccessWhenHttp: (input: {
+    api: Pick<ZeropsApi, "enableSubdomainAccess">;
+    serviceId: string;
+    sleep: Sleeper;
+    signal: AbortSignal;
+    intervalMs?: number;
+    attempts?: number;
+}) => Promise<void>;