@distilled.cloud/daytona 0.0.0-placeholder → 1.0.0-rc.13

package/src/response-validation.test.ts

@@ -0,0 +1,45 @@
+import { describe, expect, test } from "bun:test";
+import { runValidationModes } from "@distilled.cloud/core/testing";
+import * as Effect from "effect/Effect";
+import { credentials } from "./credentials.ts";
+import { DaytonaParseError } from "./errors.ts";
+import * as Retry from "./retry.ts";
+import { getSnapshotBuildLogsUrl } from "./services/snapshots.ts";
+import type { DaytonaOpError } from "./protocol.ts";
+
+// getSnapshotBuildLogsUrl declares `{ url: string }`.
+const run = (body: string) =>
+  runValidationModes(
+    getSnapshotBuildLogsUrl({ id: "snap-1" }).pipe(
+      Retry.none,
+      Effect.provide(credentials({ apiKey: "test" })),
+    ),
+    { body },
+  );
+
+describe("Daytona response validation", () => {
+  test("a matching body succeeds unchanged in both modes", async () => {
+    const body = { url: "https://logs.example/snap-1" };
+    const { lenient, strict } = await run(JSON.stringify(body));
+    expect(lenient).toMatchObject({ _tag: "Success", success: body });
+    expect(strict).toMatchObject({ _tag: "Success", success: body });
+  });
+
+  test("a body missing required members: lenient returns it, strict fails", async () => {
+    const { lenient, strict } = await run("{}");
+    expect(lenient).toMatchObject({ _tag: "Success", success: {} });
+    expect(strict._tag).toBe("Failure");
+    expect((strict as any).failure).toBeInstanceOf(DaytonaParseError);
+  });
+
+  test("a non-JSON body: lenient returns the text, strict fails", async () => {
+    const { lenient, strict } = await run("not json");
+    expect(lenient).toMatchObject({ _tag: "Success", success: "not json" });
+    expect((strict as any).failure).toBeInstanceOf(DaytonaParseError);
+  });
+});
+
+// DaytonaParseError is part of every operation's declared error type.
+export const parseErrorIsDeclared: [DaytonaParseError] extends [DaytonaOpError]
+  ? true
+  : false = true;

package/src/retry.ts

@@ -0,0 +1,74 @@
+/**
+ * Daytona retry surface — a veneer over `@distilled.cloud/core/retry`.
+ *
+ * The `Retry` service tag is threaded into every generated operation via
+ * `API.make({ retry: Retry })`, so a caller-installed policy applies to all
+ * Daytona calls below it and core's `makeDefault` is the fallback when none
+ * is provided.
+ *
+ * @example
+ * ```ts
+ * import * as Daytona from "@distilled.cloud/daytona";
+ *
+ * myEffect.pipe(Daytona.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Retries from "@distilled.cloud/core/retry";
+
+export type Options = Retries.Options;
+export type Factory = Retries.Factory;
+export type Policy = Retries.Policy;
+
+/** Context tag for configuring retry behavior of Daytona API calls. */
+export class Retry extends Context.Service<Retry, Policy>()("DaytonaRetry") {}
+
+/** Provides a custom retry policy to every Daytona API call below it. */
+export const policy: {
+  (
+    options: Options,
+  ): <A, E, R>(
+    effect: Effect.Effect<A, E, R>,
+  ) => Effect.Effect<A, E, Exclude<R, Retry>>;
+  (
+    factory: Factory,
+  ): <A, E, R>(
+    effect: Effect.Effect<A, E, R>,
+  ) => Effect.Effect<A, E, Exclude<R, Retry>>;
+} = (optionsOrFactory: Options | Factory) =>
+  Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+
+/** Disables all automatic retries. */
+export const none: <A, E, R>(
+  effect: Effect.Effect<A, E, R>,
+) => Effect.Effect<A, E, Exclude<R, Retry>> = Effect.provide(
+  Layer.succeed(Retry, { while: () => false }),
+);
+
+/**
+ * The default retry policy (core's): transient/throttling/retryable errors,
+ * capped exponential backoff with jitter, server `retryAfter` hints honored
+ * with precedence.
+ */
+export const makeDefault: Factory = Retries.makeDefault;
+
+export const jittered = Retries.jittered;
+export const capped = Retries.capped;
+
+/** Retry options that retry all throttling errors indefinitely. */
+export const throttlingOptions: Options = Retries.throttlingOptions;
+
+/** Retries all throttling errors indefinitely (honoring server hints). */
+export const throttling: <A, E, R>(
+  effect: Effect.Effect<A, E, R>,
+) => Effect.Effect<A, E, Exclude<R, Retry>> = policy(Retries.throttlingFactory);
+
+/** Retry options that retry all transient errors indefinitely. */
+export const transientOptions: Options = Retries.transientOptions;
+
+/** Retries all transient errors indefinitely. */
+export const transient: <A, E, R>(
+  effect: Effect.Effect<A, E, R>,
+) => Effect.Effect<A, E, Exclude<R, Retry>> = policy(Retries.transientFactory);

package/src/services/api_keys.ts

@@ -0,0 +1,378 @@
+// AUTO-GENERATED by scripts/generate.ts from .generated-specs (specs/spec-mirror-daytona/specs/{openapi,toolbox-openapi,analytics-openapi}.json). Do not edit.
+import * as S from "@distilled.cloud/core/schema";
+import * as API from "@distilled.cloud/core/api";
+import * as T from "../traits.ts";
+import {
+  DaytonaProtocol,
+  type DaytonaOpError,
+  type DaytonaOpContext,
+} from "../protocol.ts";
+import { UnknownDaytonaError } from "../errors.ts";
+import * as Retry from "../retry.ts";
+
+export type { DaytonaOpError, DaytonaOpContext };
+
+export type CreateApiKeyRequestPermissionsItem =
+  | "write:registries"
+  | "delete:registries"
+  | "write:snapshots"
+  | "delete:snapshots"
+  | "write:sandboxes"
+  | "delete:sandboxes"
+  | "read:volumes"
+  | "write:volumes"
+  | "delete:volumes"
+  | "write:regions"
+  | "delete:regions"
+  | "read:runners"
+  | "write:runners"
+  | "delete:runners"
+  | "read:audit_logs"
+  | "manage:api_keys"
+  | "manage:secrets"
+  | "read:limits"
+  | "manage:sso"
+  | "read:billing"
+  | "manage:billing";
+export const CreateApiKeyRequestPermissionsItem = S.String;
+
+/** The list of organization resource permissions explicitly assigned to the API key */
+export type CreateApiKeyRequestPermissionsList = Array<
+  CreateApiKeyRequestPermissionsItem | (string & {})
+>;
+export const CreateApiKeyRequestPermissionsList = /*@__PURE__*/ S.Array(
+  CreateApiKeyRequestPermissionsItem,
+) as any as S.Schema<CreateApiKeyRequestPermissionsList>;
+
+export interface CreateApiKeyRequest {
+  /** Use with JWT to specify the organization ID */
+  xDaytonaOrganizationID?: string;
+  /** The name of the API key */
+  name: string;
+  /** The list of organization resource permissions explicitly assigned to the API key */
+  permissions: CreateApiKeyRequestPermissionsList;
+  /** When the API key expires */
+  expiresAt?: string | null;
+}
+export const CreateApiKeyRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    xDaytonaOrganizationID: S.optional(
+      S.String.pipe(T.Header("X-Daytona-Organization-ID")),
+    ),
+    name: S.String,
+    permissions: CreateApiKeyRequestPermissionsList,
+    expiresAt: S.optional(S.NullOr(S.String)),
+  }).pipe(T.Http({ method: "POST", uri: "/api-keys", code: 200 })),
+).annotate({
+  identifier: "CreateApiKeyRequest",
+}) as any as S.Schema<CreateApiKeyRequest>;
+
+export type ApiKeyResponsePermissionsItem =
+  | "write:registries"
+  | "delete:registries"
+  | "write:snapshots"
+  | "delete:snapshots"
+  | "write:sandboxes"
+  | "delete:sandboxes"
+  | "read:volumes"
+  | "write:volumes"
+  | "delete:volumes"
+  | "write:regions"
+  | "delete:regions"
+  | "read:runners"
+  | "write:runners"
+  | "delete:runners"
+  | "read:audit_logs"
+  | "manage:api_keys"
+  | "manage:secrets"
+  | "read:limits"
+  | "manage:sso"
+  | "read:billing"
+  | "manage:billing";
+export const ApiKeyResponsePermissionsItem = S.String;
+
+/** The list of organization resource permissions assigned to the API key */
+export type ApiKeyResponsePermissionsList =
+  Array<ApiKeyResponsePermissionsItem>;
+export const ApiKeyResponsePermissionsList = /*@__PURE__*/ S.Array(
+  ApiKeyResponsePermissionsItem,
+) as any as S.Schema<ApiKeyResponsePermissionsList>;
+
+export interface ApiKeyResponse {
+  /** The name of the API key */
+  name: string;
+  /** The API key value */
+  value: string;
+  /** When the API key was created */
+  createdAt: string;
+  /** The list of organization resource permissions assigned to the API key */
+  permissions: ApiKeyResponsePermissionsList;
+  /** When the API key expires */
+  expiresAt: string | null;
+}
+export const ApiKeyResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    name: S.String,
+    value: S.String,
+    createdAt: S.String,
+    permissions: ApiKeyResponsePermissionsList,
+    expiresAt: S.NullOr(S.String),
+  }),
+).annotate({ identifier: "ApiKeyResponse" }) as any as S.Schema<ApiKeyResponse>;
+
+export interface DeleteApiKeyRequest {
+  name: string;
+  /** Use with JWT to specify the organization ID */
+  xDaytonaOrganizationID?: string;
+}
+export const DeleteApiKeyRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    name: S.String.pipe(T.Label()),
+    xDaytonaOrganizationID: S.optional(
+      S.String.pipe(T.Header("X-Daytona-Organization-ID")),
+    ),
+  }).pipe(T.Http({ method: "DELETE", uri: "/api-keys/{name}", code: 200 })),
+).annotate({
+  identifier: "DeleteApiKeyRequest",
+}) as any as S.Schema<DeleteApiKeyRequest>;
+
+export interface DeleteApiKeyResponse {}
+export const DeleteApiKeyResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({}),
+).annotate({
+  identifier: "DeleteApiKeyResponse",
+}) as any as S.Schema<DeleteApiKeyResponse>;
+
+export interface DeleteApiKeyForUserRequest {
+  userId: string;
+  name: string;
+  /** Use with JWT to specify the organization ID */
+  xDaytonaOrganizationID?: string;
+}
+export const DeleteApiKeyForUserRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    userId: S.String.pipe(T.Label()),
+    name: S.String.pipe(T.Label()),
+    xDaytonaOrganizationID: S.optional(
+      S.String.pipe(T.Header("X-Daytona-Organization-ID")),
+    ),
+  }).pipe(
+    T.Http({ method: "DELETE", uri: "/api-keys/{userId}/{name}", code: 200 }),
+  ),
+).annotate({
+  identifier: "DeleteApiKeyForUserRequest",
+}) as any as S.Schema<DeleteApiKeyForUserRequest>;
+
+export interface DeleteApiKeyForUserResponse {}
+export const DeleteApiKeyForUserResponse = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({}),
+).annotate({
+  identifier: "DeleteApiKeyForUserResponse",
+}) as any as S.Schema<DeleteApiKeyForUserResponse>;
+
+export interface GetApiKeyRequest {
+  name: string;
+  /** Use with JWT to specify the organization ID */
+  xDaytonaOrganizationID?: string;
+}
+export const GetApiKeyRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    name: S.String.pipe(T.Label()),
+    xDaytonaOrganizationID: S.optional(
+      S.String.pipe(T.Header("X-Daytona-Organization-ID")),
+    ),
+  }).pipe(T.Http({ method: "GET", uri: "/api-keys/{name}", code: 200 })),
+).annotate({
+  identifier: "GetApiKeyRequest",
+}) as any as S.Schema<GetApiKeyRequest>;
+
+export type ApiKeyListPermissionsItem =
+  | "write:registries"
+  | "delete:registries"
+  | "write:snapshots"
+  | "delete:snapshots"
+  | "write:sandboxes"
+  | "delete:sandboxes"
+  | "read:volumes"
+  | "write:volumes"
+  | "delete:volumes"
+  | "write:regions"
+  | "delete:regions"
+  | "read:runners"
+  | "write:runners"
+  | "delete:runners"
+  | "read:audit_logs"
+  | "manage:api_keys"
+  | "manage:secrets"
+  | "read:limits"
+  | "manage:sso"
+  | "read:billing"
+  | "manage:billing";
+export const ApiKeyListPermissionsItem = S.String;
+
+/** The list of organization resource permissions assigned to the API key */
+export type ApiKeyListPermissionsList = Array<ApiKeyListPermissionsItem>;
+export const ApiKeyListPermissionsList = /*@__PURE__*/ S.Array(
+  ApiKeyListPermissionsItem,
+) as any as S.Schema<ApiKeyListPermissionsList>;
+
+export interface ApiKeyList {
+  /** The name of the API key */
+  name: string;
+  /** The masked API key value */
+  value: string;
+  /** When the API key was created */
+  createdAt: string;
+  /** The list of organization resource permissions assigned to the API key */
+  permissions: ApiKeyListPermissionsList;
+  /** When the API key was last used */
+  lastUsedAt: string | null;
+  /** When the API key expires */
+  expiresAt: string | null;
+  /** The user ID of the user who created the API key */
+  userId: string;
+  /** The organization ID associated with the API key */
+  organizationId?: string;
+}
+export const ApiKeyList = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    name: S.String,
+    value: S.String,
+    createdAt: S.String,
+    permissions: ApiKeyListPermissionsList,
+    lastUsedAt: S.NullOr(S.String),
+    expiresAt: S.NullOr(S.String),
+    userId: S.String,
+    organizationId: S.optional(S.String),
+  }),
+).annotate({ identifier: "ApiKeyList" }) as any as S.Schema<ApiKeyList>;
+
+export interface GetCurrentApiKeyRequest {
+  /** Use with JWT to specify the organization ID */
+  xDaytonaOrganizationID?: string;
+}
+export const GetCurrentApiKeyRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    xDaytonaOrganizationID: S.optional(
+      S.String.pipe(T.Header("X-Daytona-Organization-ID")),
+    ),
+  }).pipe(T.Http({ method: "GET", uri: "/api-keys/current", code: 200 })),
+).annotate({
+  identifier: "GetCurrentApiKeyRequest",
+}) as any as S.Schema<GetCurrentApiKeyRequest>;
+
+export interface ListApiKeysRequest {
+  /** Use with JWT to specify the organization ID */
+  xDaytonaOrganizationID?: string;
+}
+export const ListApiKeysRequest = /*@__PURE__*/ S.suspend(() =>
+  S.Struct({
+    xDaytonaOrganizationID: S.optional(
+      S.String.pipe(T.Header("X-Daytona-Organization-ID")),
+    ),
+  }).pipe(T.Http({ method: "GET", uri: "/api-keys", code: 200 })),
+).annotate({
+  identifier: "ListApiKeysRequest",
+}) as any as S.Schema<ListApiKeysRequest>;
+
+export type ListApiKeysResponseBodyList = Array<ApiKeyList>;
+export const ListApiKeysResponseBodyList = /*@__PURE__*/ S.Array(
+  ApiKeyList,
+) as any as S.Schema<ListApiKeysResponseBodyList>;
+
+export type ListApiKeysResponse = ListApiKeysResponseBodyList;
+export const ListApiKeysResponse = /*@__PURE__*/ S.suspend(() =>
+  ListApiKeysResponseBodyList.pipe(T.RawResponseRoot()),
+).annotate({
+  identifier: "ListApiKeysResponse",
+}) as any as S.Schema<ListApiKeysResponse>;
+
+export type CreateApiKeyError = DaytonaOpError;
+/** Create API key */
+export const createApiKey: API.OperationMethod<
+  CreateApiKeyRequest,
+  ApiKeyResponse,
+  CreateApiKeyError,
+  DaytonaOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: CreateApiKeyRequest,
+  output: ApiKeyResponse,
+  errors: [UnknownDaytonaError],
+  protocol: DaytonaProtocol,
+  retry: Retry.Retry,
+}));
+
+export type DeleteApiKeyError = DaytonaOpError;
+/** Delete API key */
+export const deleteApiKey: API.OperationMethod<
+  DeleteApiKeyRequest,
+  DeleteApiKeyResponse,
+  DeleteApiKeyError,
+  DaytonaOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: DeleteApiKeyRequest,
+  output: DeleteApiKeyResponse,
+  errors: [UnknownDaytonaError],
+  protocol: DaytonaProtocol,
+  retry: Retry.Retry,
+}));
+
+export type DeleteApiKeyForUserError = DaytonaOpError;
+/** Delete API key for user */
+export const deleteApiKeyForUser: API.OperationMethod<
+  DeleteApiKeyForUserRequest,
+  DeleteApiKeyForUserResponse,
+  DeleteApiKeyForUserError,
+  DaytonaOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: DeleteApiKeyForUserRequest,
+  output: DeleteApiKeyForUserResponse,
+  errors: [UnknownDaytonaError],
+  protocol: DaytonaProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetApiKeyError = DaytonaOpError;
+/** Get API key */
+export const getApiKey: API.OperationMethod<
+  GetApiKeyRequest,
+  ApiKeyList,
+  GetApiKeyError,
+  DaytonaOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetApiKeyRequest,
+  output: ApiKeyList,
+  errors: [UnknownDaytonaError],
+  protocol: DaytonaProtocol,
+  retry: Retry.Retry,
+}));
+
+export type GetCurrentApiKeyError = DaytonaOpError;
+/** Get current API key's details */
+export const getCurrentApiKey: API.OperationMethod<
+  GetCurrentApiKeyRequest,
+  ApiKeyList,
+  GetCurrentApiKeyError,
+  DaytonaOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: GetCurrentApiKeyRequest,
+  output: ApiKeyList,
+  errors: [UnknownDaytonaError],
+  protocol: DaytonaProtocol,
+  retry: Retry.Retry,
+}));
+
+export type ListApiKeysError = DaytonaOpError;
+/** List API keys */
+export const listApiKeys: API.OperationMethod<
+  ListApiKeysRequest,
+  ListApiKeysResponse,
+  ListApiKeysError,
+  DaytonaOpContext
+> = /*@__PURE__*/ API.make(() => ({
+  input: ListApiKeysRequest,
+  output: ListApiKeysResponse,
+  errors: [UnknownDaytonaError],
+  protocol: DaytonaProtocol,
+  retry: Retry.Retry,
+}));