@distilled.cloud/fly-io 1.0.0-rc.11 → 1.0.0-rc.13

package/lib/sprites-mint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sprites-mint.test.d.ts.map

package/lib/sprites-mint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprites-mint.test.d.ts","sourceRoot":"","sources":["../src/sprites-mint.test.ts"],"names":[],"mappings":""}

package/lib/sprites-mint.test.js

@@ -0,0 +1,170 @@
+import { describe, expect, test } from "bun:test";
+import * as API from "@distilled.cloud/core/api";
+import * as Cause from "effect/Cause";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Redacted from "effect/Redacted";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientResponse from "effect/http/HttpClientResponse";
+import { Credentials } from "./credentials.js";
+import { SpritesProtocol } from "./protocol.js";
+import { ListSpritesRequest } from "./services/sprites.js";
+const mintFixture = (apiKey) => Effect.gen(function* () {
+    const protocol = yield* API.Protocol;
+    const attempts = yield* Effect.forEach([0, 1], () => Effect.gen(function* () {
+        return {
+            started: yield* Deferred.make(),
+            response: yield* Deferred.make(),
+        };
+    }));
+    const discoveries = [];
+    const mints = [];
+    let credentialReads = 0;
+    const client = HttpClient.make((request) => Effect.gen(function* () {
+        if (request.url === "https://fly.test/v1/tokens/current") {
+            discoveries.push(request);
+            return HttpClientResponse.fromWeb(request, Response.json({ tokens: [{ org_slug: "mint-test" }] }));
+        }
+        if (request.method !== "POST" ||
+            request.url !==
+                "https://api.sprites.dev/v1/organizations/mint-test/tokens") {
+            return yield* Effect.die("Unexpected test transport request");
+        }
+        const attempt = attempts[mints.length];
+        mints.push(request);
+        if (!attempt)
+            return yield* Effect.die("Unexpected mint attempt");
+        yield* Deferred.succeed(attempt.started, undefined);
+        const { status, body } = yield* Deferred.await(attempt.response);
+        return HttpClientResponse.fromWeb(request, Response.json(body, { status }));
+    }));
+    const encode = protocol
+        .encode({
+        input: {},
+        inputAst: ListSpritesRequest.ast,
+        config: { input: ListSpritesRequest },
+    })
+        .pipe(Effect.provideService(HttpClient.HttpClient, client), Effect.provideService(Credentials, Effect.sync(() => {
+        credentialReads++;
+        return {
+            apiKey: Redacted.make(apiKey),
+            apiBaseUrl: "https://fly.test",
+        };
+    })));
+    return {
+        encode,
+        discoveries,
+        mints,
+        credentialReads: () => credentialReads,
+        started: (attempt = 0) => Deferred.await(attempts[attempt].started),
+        respond: (body, status = 200, attempt = 0) => Deferred.succeed(attempts[attempt].response, { status, body }),
+    };
+}).pipe(Effect.provide(SpritesProtocol));
+describe("Sprites token mint coordination", () => {
+    test("shares concurrent minting and reuses the successful token without exposing it in request JSON", () => Effect.runPromise(Effect.gen(function* () {
+        const fixture = yield* mintFixture("mint-concurrent-fly-secret");
+        const owner = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* fixture.started();
+        const waiters = yield* Effect.forEach(Array.from({ length: 20 }), () => fixture.encode.pipe(Effect.forkChild({ startImmediately: true })));
+        expect(fixture.credentialReads()).toBe(21);
+        expect(fixture.discoveries).toHaveLength(1);
+        expect(fixture.mints).toHaveLength(1);
+        yield* fixture.respond({ token: "mint-concurrent-sprites-secret" });
+        const requests = yield* Effect.forEach([owner, ...waiters], Fiber.join);
+        requests.push(yield* fixture.encode);
+        for (const request of requests) {
+            expect(request.url).toBe("https://api.sprites.dev/v1/sprites");
+            expect(request.headers.authorization).toBe("Bearer mint-concurrent-sprites-secret");
+            expect(JSON.stringify(request)).not.toContain("mint-concurrent-sprites-secret");
+        }
+        expect(fixture.mints[0].headers.authorization).toBe("FlyV1 mint-concurrent-fly-secret");
+        for (const request of [...fixture.discoveries, ...fixture.mints]) {
+            expect(JSON.stringify(request)).not.toContain("mint-concurrent-fly-secret");
+        }
+        expect(fixture.credentialReads()).toBe(22);
+        expect(fixture.discoveries).toHaveLength(1);
+        expect(fixture.mints).toHaveLength(1);
+    }).pipe(Effect.timeout("2 seconds"))));
+    test("shares a failed mint and allows a subsequent successful retry", () => Effect.runPromise(Effect.gen(function* () {
+        const fixture = yield* mintFixture("mint-retry-fly-secret");
+        const owner = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* fixture.started();
+        const waiter = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        expect(fixture.credentialReads()).toBe(2);
+        expect(fixture.mints).toHaveLength(1);
+        yield* fixture.respond({ message: "synthetic mint failure" }, 500);
+        const exits = yield* Fiber.awaitAll([owner, waiter]);
+        for (const exit of exits) {
+            expect(Exit.isFailure(exit)).toBe(true);
+            if (Exit.isFailure(exit)) {
+                expect(Cause.pretty(exit.cause)).toContain("synthetic mint failure");
+                expect(Cause.pretty(exit.cause)).not.toContain("mint-retry-fly-secret");
+            }
+        }
+        expect(exits[0]).toEqual(exits[1]);
+        const retry = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* fixture.started(1);
+        yield* fixture.respond({ token: "mint-retry-sprites-secret" }, 200, 1);
+        expect((yield* Fiber.join(retry)).headers.authorization).toBe("Bearer mint-retry-sprites-secret");
+        expect((yield* fixture.encode).headers.authorization).toBe("Bearer mint-retry-sprites-secret");
+        expect(fixture.discoveries).toHaveLength(2);
+        expect(fixture.mints).toHaveLength(2);
+    }).pipe(Effect.timeout("2 seconds"))));
+    test("isolates pending and successful tokens for separate credentials", () => Effect.runPromise(Effect.gen(function* () {
+        const first = yield* mintFixture("mint-isolation-first");
+        const second = yield* mintFixture("mint-isolation-second");
+        const firstFiber = yield* first.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        const secondFiber = yield* second.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* first.started();
+        yield* second.started();
+        expect(first.mints[0].headers.authorization).toBe("FlyV1 mint-isolation-first");
+        expect(second.mints[0].headers.authorization).toBe("FlyV1 mint-isolation-second");
+        yield* second.respond({ token: "sprites-isolation-second" });
+        expect((yield* Fiber.join(secondFiber)).headers.authorization).toBe("Bearer sprites-isolation-second");
+        yield* first.respond({ token: "sprites-isolation-first" });
+        expect((yield* Fiber.join(firstFiber)).headers.authorization).toBe("Bearer sprites-isolation-first");
+        expect((yield* first.encode).headers.authorization).toBe("Bearer sprites-isolation-first");
+        expect((yield* second.encode).headers.authorization).toBe("Bearer sprites-isolation-second");
+        expect(first.mints).toHaveLength(1);
+        expect(second.mints).toHaveLength(1);
+    }).pipe(Effect.timeout("2 seconds"))));
+    test("interrupting a waiter does not cancel or evict the active mint", () => Effect.runPromise(Effect.gen(function* () {
+        const fixture = yield* mintFixture("mint-interrupted-waiter");
+        const owner = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* fixture.started();
+        const waiter = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        expect(fixture.credentialReads()).toBe(2);
+        yield* Fiber.interrupt(waiter);
+        expect(Exit.hasInterrupts(yield* Fiber.await(waiter))).toBe(true);
+        const replacementWaiter = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        expect(fixture.credentialReads()).toBe(3);
+        expect(fixture.mints).toHaveLength(1);
+        yield* fixture.respond({ token: "sprites-after-waiter-interruption" });
+        for (const fiber of [owner, replacementWaiter]) {
+            expect((yield* Fiber.join(fiber)).headers.authorization).toBe("Bearer sprites-after-waiter-interruption");
+        }
+        expect(fixture.discoveries).toHaveLength(1);
+    }).pipe(Effect.timeout("2 seconds"))));
+    test("owner interruption releases all waiters and allows another mint", () => Effect.runPromise(Effect.gen(function* () {
+        const fixture = yield* mintFixture("mint-interrupted-owner");
+        const owner = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* fixture.started();
+        const waiters = yield* Effect.forEach([0, 1, 2], () => fixture.encode.pipe(Effect.forkChild({ startImmediately: true })));
+        expect(fixture.credentialReads()).toBe(4);
+        expect(fixture.mints).toHaveLength(1);
+        yield* Fiber.interrupt(owner);
+        for (const exit of yield* Fiber.awaitAll([owner, ...waiters])) {
+            expect(Exit.hasInterrupts(exit)).toBe(true);
+        }
+        const retry = yield* fixture.encode.pipe(Effect.forkChild({ startImmediately: true }));
+        yield* fixture.started(1);
+        yield* fixture.respond({ token: "sprites-after-interruption" }, 200, 1);
+        expect((yield* Fiber.join(retry)).headers.authorization).toBe("Bearer sprites-after-interruption");
+        expect((yield* fixture.encode).headers.authorization).toBe("Bearer sprites-after-interruption");
+        expect(fixture.discoveries).toHaveLength(2);
+        expect(fixture.mints).toHaveLength(2);
+    }).pipe(Effect.timeout("2 seconds"))));
+});
+//# sourceMappingURL=sprites-mint.test.js.map

package/lib/sprites-mint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprites-mint.test.js","sourceRoot":"","sources":["../src/sprites-mint.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distilled.cloud/fly-io",
-  "version": "1.0.0-rc.11",
+  "version": "1.0.0-rc.13",
   "repository": {
     "type": "git",
     "url": "https://github.com/alchemy-run/distilled",
@@ -89,15 +89,15 @@
     }
   },
   "dependencies": {
-    "@distilled.cloud/core": "1.0.0-rc.11"
+    "@distilled.cloud/core": "1.0.0-rc.13"
   },
   "devDependencies": {
     "@types/bun": "1.3.14",
     "@types/node": "26.2.0",
-    "@effect/platform-bun": ">=4.0.0-rc.115 || >=4.0.0"
+    "@effect/platform-bun": "^4.0.0"
   },
   "peerDependencies": {
-    "effect": ">=4.0.0-rc.115 || >=4.0.0"
+    "effect": "^4.0.0"
   },
   "scripts": {
     "convert": "bun scripts/convert.ts",

package/src/protocol.test.ts

@@ -0,0 +1,234 @@
+import { describe, expect, test } from "bun:test";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientResponse from "effect/http/HttpClientResponse";
+import * as ResponseValidation from "@distilled.cloud/core/response-validation";
+import { credentials } from "./credentials.ts";
+import { BadRequest, FlyIoParseError, UnknownFlyIoError } from "./errors.ts";
+import type { FlyIoOpContext } from "./protocol.ts";
+import * as Retry from "./retry.ts";
+import { agreedToProviderTos } from "./services/addons.ts";
+import {
+  MachineStartFromCreatedState,
+  MachineWaitTimeout,
+  startMachine,
+  stopMachine,
+  waitMachine,
+} from "./services/machines.ts";
+
+const recordedMessage =
+  "failed_precondition: unable to start machine from current state: 'created'";
+const machine = { app_name: "decoder-test", machine_id: "machine-test" };
+
+const respondWith = (status: number, body: string) =>
+  Layer.mergeAll(
+    Layer.succeed(
+      HttpClient.HttpClient,
+      HttpClient.make((request) =>
+        Effect.sync(() =>
+          HttpClientResponse.fromWeb(request, new Response(body, { status })),
+        ),
+      ),
+    ),
+    credentials({
+      apiKey: "decoder-test",
+      apiBaseUrl: "https://fly.test",
+    }),
+  );
+
+const decodeError = <A, E>(
+  operation: Effect.Effect<A, E, FlyIoOpContext>,
+  status: number,
+  body: string,
+) =>
+  Effect.runPromise(
+    operation.pipe(
+      Retry.none,
+      Effect.provide(respondWith(status, body)),
+      Effect.flip,
+    ),
+  );
+
+// The suite recorded the message, but not the HTTP status or raw envelope.
+const envelopes = [
+  { name: "error", body: JSON.stringify({ error: recordedMessage }) },
+  { name: "message", body: JSON.stringify({ message: recordedMessage }) },
+  {
+    name: "errors.detail",
+    body: JSON.stringify({ errors: { detail: recordedMessage } }),
+  },
+  { name: "plain text", body: recordedMessage },
+];
+
+describe("Machines start precondition decoding", () => {
+  for (const status of [400, 412]) {
+    for (const { name, body } of envelopes) {
+      test(`decodes the exact recorded message from ${name} at ${status}`, async () => {
+        const error = await decodeError(startMachine(machine), status, body);
+        expect(error).toBeInstanceOf(MachineStartFromCreatedState);
+        expect(error).toMatchObject({ message: recordedMessage });
+      });
+    }
+
+    test(`does not specialize unrelated ${status} errors`, async () => {
+      for (const message of [
+        "invalid machine configuration",
+        "failed_precondition: unable to start machine from current state: 'destroyed'",
+        "failed_precondition: unable to stop machine from current state: 'created'",
+      ]) {
+        const error = await decodeError(
+          startMachine(machine),
+          status,
+          JSON.stringify({ error: message }),
+        );
+        expect(error).toBeInstanceOf(
+          status === 400 ? BadRequest : UnknownFlyIoError,
+        );
+        expect(error).toMatchObject({ message });
+      }
+    });
+  }
+
+  test("only specializes startMachine", async () => {
+    const error = await decodeError(
+      stopMachine(machine),
+      412,
+      JSON.stringify({ error: recordedMessage }),
+    );
+    expect(error).toBeInstanceOf(UnknownFlyIoError);
+    expect(error).toMatchObject({ message: recordedMessage });
+  });
+});
+
+describe("Machines wait timeout decoding", () => {
+  const recordedWaitMessage =
+    "deadline_exceeded: machine failed to reach desired state, started, currently stopped";
+
+  // Statuses are synthetic; the live failure only captured the message.
+  for (const status of [408, 412]) {
+    test(`decodes the recorded waiter failure at ${status}`, async () => {
+      const error = await decodeError(
+        waitMachine(machine),
+        status,
+        JSON.stringify({ error: recordedWaitMessage }),
+      );
+      expect(error).toBeInstanceOf(MachineWaitTimeout);
+      expect(error).toMatchObject({ message: recordedWaitMessage });
+    });
+  }
+
+  test("decodes the recorded waiter failure from plain text", async () => {
+    const error = await decodeError(
+      waitMachine(machine),
+      412,
+      recordedWaitMessage,
+    );
+    expect(error).toBeInstanceOf(MachineWaitTimeout);
+    expect(error).toMatchObject({ message: recordedWaitMessage });
+  });
+
+  test("matches other desired and current machine states", async () => {
+    const message =
+      "deadline_exceeded: machine failed to reach desired state, stopped, currently stopping";
+    const error = await decodeError(
+      waitMachine(machine),
+      412,
+      JSON.stringify({ error: message }),
+    );
+    expect(error).toBeInstanceOf(MachineWaitTimeout);
+    expect(error).toMatchObject({ message });
+  });
+
+  for (const status of [400, 412]) {
+    test(`does not specialize unrelated waiter errors at ${status}`, async () => {
+      for (const message of [
+        "deadline_exceeded: request timed out",
+        "failed_precondition: machine failed to reach desired state, started, currently stopped",
+        "machine failed to reach desired state, started, currently stopped",
+        `other failure: ${recordedWaitMessage}`,
+        `${recordedWaitMessage}; invalid configuration`,
+      ]) {
+        const error = await decodeError(
+          waitMachine(machine),
+          status,
+          JSON.stringify({ error: message }),
+        );
+        expect(error).toBeInstanceOf(
+          status === 400 ? BadRequest : UnknownFlyIoError,
+        );
+        expect(error).toMatchObject({ message });
+      }
+    });
+  }
+
+  test("only specializes waitMachine", async () => {
+    const error = await decodeError(
+      startMachine(machine),
+      412,
+      JSON.stringify({ error: recordedWaitMessage }),
+    );
+    expect(error).toBeInstanceOf(UnknownFlyIoError);
+    expect(error).toMatchObject({ message: recordedWaitMessage });
+  });
+});
+
+describe("GraphQL response validation", () => {
+  const tos = { slug: "decoder-test", providerName: "tigris" };
+  // `agreedToProviderTos` is `boolean | null`; a string is a mismatch.
+  const mismatched = JSON.stringify({
+    data: { organization: { agreedToProviderTos: "yes" } },
+  });
+
+  test("lenient mode returns the payload as read", async () => {
+    const result = await Effect.runPromise(
+      agreedToProviderTos(tos).pipe(
+        Retry.none,
+        Effect.provide(respondWith(200, mismatched)),
+      ),
+    );
+    expect(result as unknown).toBe("yes");
+  });
+
+  test("strict mode fails a mismatched payload with FlyIoParseError", async () => {
+    const error = await Effect.runPromise(
+      agreedToProviderTos(tos).pipe(
+        Retry.none,
+        Effect.provide(respondWith(200, mismatched)),
+        Effect.provide(ResponseValidation.strict),
+        Effect.flip,
+      ),
+    );
+    expect(error).toBeInstanceOf(FlyIoParseError);
+  });
+
+  test("strict mode passes a matching payload", async () => {
+    const result = await Effect.runPromise(
+      agreedToProviderTos(tos).pipe(
+        Retry.none,
+        Effect.provide(
+          respondWith(
+            200,
+            JSON.stringify({
+              data: { organization: { agreedToProviderTos: true } },
+            }),
+          ),
+        ),
+        Effect.provide(ResponseValidation.strict),
+      ),
+    );
+    expect(result).toBe(true);
+  });
+
+  test("a non-JSON body: lenient returns the text, strict fails", async () => {
+    const call = agreedToProviderTos(tos).pipe(
+      Retry.none,
+      Effect.provide(respondWith(200, "not json")),
+    );
+    expect((await Effect.runPromise(call)) as unknown).toBe("not json");
+    const error = await Effect.runPromise(
+      call.pipe(Effect.provide(ResponseValidation.strict), Effect.flip),
+    );
+    expect(error).toBeInstanceOf(FlyIoParseError);
+  });
+});