unfazed 0.0.1 → 0.1.0

package/dist/wait.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Knobs for any polling wait.
+ *
+ * `sleep` and `now` are injectable so the test suite can drive multi-minute
+ * backoff schedules instantly and assert the exact interval sequence, instead
+ * of actually waiting. Production code never passes them.
+ */
+export interface WaitOptions {
+    /**
+     * Give up after this long. Default 600_000 (10 minutes) — a cold Bun build
+     * plus VM boot and health probe routinely runs into minutes, and the build
+     * microVM's own ceiling is 600s.
+     */
+    timeoutMs?: number;
+    /** First poll delay in ms. Default 1_000. */
+    initialIntervalMs?: number;
+    /** Ceiling for the backoff in ms. Default 10_000. */
+    maxIntervalMs?: number;
+    /** Backoff multiplier. Default 1.5. */
+    factor?: number;
+    /** Cancels the wait; surfaces as {@link UnfazedTimeoutError}. */
+    signal?: AbortSignal;
+    /** Injected clock (tests). */
+    now?: () => number;
+    /** Injected sleep (tests). */
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+export interface ResolvedWaitOptions {
+    timeoutMs: number;
+    initialIntervalMs: number;
+    maxIntervalMs: number;
+    factor: number;
+    signal: AbortSignal | undefined;
+    now: () => number;
+    sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
+}
+export declare function resolveWaitOptions(options?: WaitOptions): ResolvedWaitOptions;
+/** What one poll tick decided. */
+export type PollDecision<T> = {
+    done: true;
+    value: T;
+} | {
+    done: false;
+};
+/**
+ * Generic exponential-backoff poll loop.
+ *
+ * Polls immediately (no initial sleep — most callers have just created the
+ * thing and a first read is nearly free), then backs off geometrically up to
+ * `maxIntervalMs`. The final sleep is clamped so the loop cannot overshoot
+ * `timeoutMs`, which keeps `wait: true` honest as a deadline rather than a
+ * suggestion.
+ *
+ * `onTimeout` builds the error so callers can attach their own context (the
+ * last deployment snapshot, say) instead of getting a bare timeout.
+ */
+export declare function pollWithBackoff<T>(poll: () => Promise<PollDecision<T>>, options: ResolvedWaitOptions, onTimeout: () => Error): Promise<T>;

package/dist/wait.js

@@ -0,0 +1,59 @@
+import { UnfazedTimeoutError } from "./errors.js";
+export function resolveWaitOptions(options = {}) {
+    return {
+        timeoutMs: options.timeoutMs ?? 600_000,
+        initialIntervalMs: options.initialIntervalMs ?? 1_000,
+        maxIntervalMs: options.maxIntervalMs ?? 10_000,
+        factor: options.factor ?? 1.5,
+        signal: options.signal,
+        now: options.now ?? (() => Date.now()),
+        sleep: options.sleep ?? defaultSleep,
+    };
+}
+function defaultSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new UnfazedTimeoutError("unfazed: wait aborted"));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new UnfazedTimeoutError("unfazed: wait aborted"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/**
+ * Generic exponential-backoff poll loop.
+ *
+ * Polls immediately (no initial sleep — most callers have just created the
+ * thing and a first read is nearly free), then backs off geometrically up to
+ * `maxIntervalMs`. The final sleep is clamped so the loop cannot overshoot
+ * `timeoutMs`, which keeps `wait: true` honest as a deadline rather than a
+ * suggestion.
+ *
+ * `onTimeout` builds the error so callers can attach their own context (the
+ * last deployment snapshot, say) instead of getting a bare timeout.
+ */
+export async function pollWithBackoff(poll, options, onTimeout) {
+    const { timeoutMs, initialIntervalMs, maxIntervalMs, factor, signal, now, sleep } = options;
+    const deadline = now() + timeoutMs;
+    let interval = initialIntervalMs;
+    for (;;) {
+        if (signal?.aborted)
+            throw new UnfazedTimeoutError("unfazed: wait aborted");
+        const decision = await poll();
+        if (decision.done)
+            return decision.value;
+        const remaining = deadline - now();
+        if (remaining <= 0)
+            throw onTimeout();
+        await sleep(Math.min(interval, remaining), signal);
+        interval = Math.min(interval * factor, maxIntervalMs);
+    }
+}
+//# sourceMappingURL=wait.js.map

package/dist/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAwClD,MAAM,UAAU,kBAAkB,CAAC,UAAuB,EAAE;IAC1D,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO;QACvC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,KAAK;QACrD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,MAAM;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG;QAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,EAAU,EAAE,MAAoB;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,CAAC,CAAC;YACzD,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAKD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAoC,EACpC,OAA4B,EAC5B,SAAsB;IAEtB,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5F,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC;IACnC,IAAI,QAAQ,GAAG,iBAAiB,CAAC;IAEjC,SAAS,CAAC;QACR,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;QAE5E,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;QAC9B,IAAI,QAAQ,CAAC,IAAI;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC;QAEzC,MAAM,SAAS,GAAG,QAAQ,GAAG,GAAG,EAAE,CAAC;QACnC,IAAI,SAAS,IAAI,CAAC;YAAE,MAAM,SAAS,EAAE,CAAC;QAEtC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QACnD,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,MAAM,EAAE,aAAa,CAAC,CAAC;IACxD,CAAC;AACH,CAAC","sourcesContent":["import { UnfazedTimeoutError } from \"./errors.js\";\n\n/**\n * Knobs for any polling wait.\n *\n * `sleep` and `now` are injectable so the test suite can drive multi-minute\n * backoff schedules instantly and assert the exact interval sequence, instead\n * of actually waiting. Production code never passes them.\n */\nexport interface WaitOptions {\n  /**\n   * Give up after this long. Default 600_000 (10 minutes) — a cold Bun build\n   * plus VM boot and health probe routinely runs into minutes, and the build\n   * microVM's own ceiling is 600s.\n   */\n  timeoutMs?: number;\n  /** First poll delay in ms. Default 1_000. */\n  initialIntervalMs?: number;\n  /** Ceiling for the backoff in ms. Default 10_000. */\n  maxIntervalMs?: number;\n  /** Backoff multiplier. Default 1.5. */\n  factor?: number;\n  /** Cancels the wait; surfaces as {@link UnfazedTimeoutError}. */\n  signal?: AbortSignal;\n  /** Injected clock (tests). */\n  now?: () => number;\n  /** Injected sleep (tests). */\n  sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n}\n\nexport interface ResolvedWaitOptions {\n  timeoutMs: number;\n  initialIntervalMs: number;\n  maxIntervalMs: number;\n  factor: number;\n  signal: AbortSignal | undefined;\n  now: () => number;\n  sleep: (ms: number, signal?: AbortSignal) => Promise<void>;\n}\n\nexport function resolveWaitOptions(options: WaitOptions = {}): ResolvedWaitOptions {\n  return {\n    timeoutMs: options.timeoutMs ?? 600_000,\n    initialIntervalMs: options.initialIntervalMs ?? 1_000,\n    maxIntervalMs: options.maxIntervalMs ?? 10_000,\n    factor: options.factor ?? 1.5,\n    signal: options.signal,\n    now: options.now ?? (() => Date.now()),\n    sleep: options.sleep ?? defaultSleep,\n  };\n}\n\nfunction defaultSleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new UnfazedTimeoutError(\"unfazed: wait aborted\"));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new UnfazedTimeoutError(\"unfazed: wait aborted\"));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n\n/** What one poll tick decided. */\nexport type PollDecision<T> = { done: true; value: T } | { done: false };\n\n/**\n * Generic exponential-backoff poll loop.\n *\n * Polls immediately (no initial sleep — most callers have just created the\n * thing and a first read is nearly free), then backs off geometrically up to\n * `maxIntervalMs`. The final sleep is clamped so the loop cannot overshoot\n * `timeoutMs`, which keeps `wait: true` honest as a deadline rather than a\n * suggestion.\n *\n * `onTimeout` builds the error so callers can attach their own context (the\n * last deployment snapshot, say) instead of getting a bare timeout.\n */\nexport async function pollWithBackoff<T>(\n  poll: () => Promise<PollDecision<T>>,\n  options: ResolvedWaitOptions,\n  onTimeout: () => Error,\n): Promise<T> {\n  const { timeoutMs, initialIntervalMs, maxIntervalMs, factor, signal, now, sleep } = options;\n  const deadline = now() + timeoutMs;\n  let interval = initialIntervalMs;\n\n  for (;;) {\n    if (signal?.aborted) throw new UnfazedTimeoutError(\"unfazed: wait aborted\");\n\n    const decision = await poll();\n    if (decision.done) return decision.value;\n\n    const remaining = deadline - now();\n    if (remaining <= 0) throw onTimeout();\n\n    await sleep(Math.min(interval, remaining), signal);\n    interval = Math.min(interval * factor, maxIntervalMs);\n  }\n}\n"]}

package/package.json

@@ -1,25 +1,69 @@
 {
   "name": "unfazed",
-  "version": "0.0.1",
-  "description": "Placeholder for the unfazed package. Under active development — not ready for use.",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for unfazed. The code-mode companion to the unfazed MCP server: deploy, wait, tail logs and roll back from one script.",
   "license": "MIT",
   "type": "module",
-  "main": "./index.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "index.js"
+    "dist",
+    "schema/schema.graphqls",
+    "schema/SOURCE.json",
+    "README.md",
+    "LICENSE"
   ],
+  "sideEffects": false,
+  "engines": {
+    "bun": ">=1.2",
+    "node": ">=20"
+  },
   "keywords": [
-    "unfazed"
+    "unfazed",
+    "deploy",
+    "deployment",
+    "graphql",
+    "sdk",
+    "agents",
+    "code-mode",
+    "mcp",
+    "bun"
   ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jilio/unfazed-packages.git",
     "directory": "packages/unfazed"
   },
+  "homepage": "https://unfazed.dev",
+  "bugs": {
+    "url": "https://github.com/jilio/unfazed-packages/issues"
+  },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "sync-schema": "bun run scripts/sync-schema.ts",
+    "codegen": "graphql-codegen --config codegen.ts && bun run scripts/postcodegen.ts",
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "smoke": "bun test/smoke-dist.mjs && node test/smoke-dist.mjs",
+    "check": "bun run typecheck && bun test && bun run build && bun run smoke"
+  },
+  "devDependencies": {
+    "@graphql-codegen/cli": "^7.1.2",
+    "@graphql-codegen/client-preset": "^6.0.1",
+    "@types/bun": "^1.3.9",
+    "graphql": "^16.14.2",
+    "typescript": "^6.0.3"
   }
 }

package/schema/SOURCE.json

@@ -0,0 +1,9 @@
+{
+  "$comment": "Provenance for the vendored copy of graph/schema.graphqls. Written by scripts/sync-schema.ts — do not edit by hand.",
+  "repo": "unfazed",
+  "path": "graph/schema.graphqls",
+  "unfazedCommit": "c7068473bafd49e0f7f8705a53bf1d4b451d855b",
+  "schemaLastChangedCommit": "fd278d74ac63bc20c4d5adc274559dd096964dc3",
+  "sha256": "508b78d0661ce28c6be5a10625d0d9804846f645bb2b952ae166232645b921ba",
+  "syncedAt": "2026-08-27"
+}