@fly.io/sdk 0.1.0

package/src/errors.ts

@@ -0,0 +1,135 @@
+// Typed Fly API error classes and HTTP/GraphQL error mapping helpers.
+
+import * as errore from 'errore'
+
+import type { MainStatusCode } from './types.ts'
+
+export class FlyApiError extends errore.createTaggedError({
+  name: 'FlyApiError',
+  message: 'Fly API request failed for $method $path with status $httpStatus',
+}) {}
+
+export class FlyBadRequestError extends errore.createTaggedError({
+  name: 'FlyBadRequestError',
+  message: 'Fly API returned 400 for $method $path',
+}) {}
+
+export class FlyUnauthorizedError extends errore.createTaggedError({
+  name: 'FlyUnauthorizedError',
+  message: 'Fly API returned 401 for $method $path',
+}) {}
+
+export class FlyNotFoundError extends errore.createTaggedError({
+  name: 'FlyNotFoundError',
+  message: 'Fly API returned 404 for $method $path',
+}) {}
+
+export class FlyPreconditionFailedError extends errore.createTaggedError({
+  name: 'FlyPreconditionFailedError',
+  message: 'Fly API returned 412 for $method $path',
+}) {}
+
+export class FlyUnprocessableEntityError extends errore.createTaggedError({
+  name: 'FlyUnprocessableEntityError',
+  message: 'Fly API returned 422 for $method $path',
+}) {}
+
+export class FlyInternalServerError extends errore.createTaggedError({
+  name: 'FlyInternalServerError',
+  message: 'Fly API returned 500 for $method $path',
+}) {}
+
+export class FlyGraphQLError extends errore.createTaggedError({
+  name: 'FlyGraphQLError',
+  message: 'Fly GraphQL request failed for $path: $messages',
+}) {}
+
+export type FlyClientError =
+  | FlyApiError
+  | FlyBadRequestError
+  | FlyUnauthorizedError
+  | FlyNotFoundError
+  | FlyPreconditionFailedError
+  | FlyUnprocessableEntityError
+  | FlyInternalServerError
+  | FlyGraphQLError
+
+export type FlyResult<T> = FlyClientError | T
+
+type ErrorResponsePayload = {
+  details?: Record<string, unknown>
+  error?: string
+  status?: MainStatusCode
+}
+
+export function parseErrorResponsePayload({
+  payload,
+}: {
+  payload: unknown
+}): ErrorResponsePayload | null {
+  if (!isObject(payload)) {
+    return null
+  }
+
+  const details = isObject(payload.details) ? payload.details : undefined
+  const error = typeof payload.error === 'string' ? payload.error : undefined
+  const status = isMainStatusCode(payload.status) ? payload.status : undefined
+
+  return { details, error, status }
+}
+
+export function createFlyHttpError({
+  method,
+  path,
+  httpStatus,
+  payload,
+}: {
+  method: 'GET' | 'POST' | 'PUT' | 'DELETE'
+  path: string
+  httpStatus: number
+  payload: unknown
+}): FlyClientError {
+  parseErrorResponsePayload({ payload })
+
+  if (httpStatus === 400) {
+    return new FlyBadRequestError({ method, path })
+  }
+  if (httpStatus === 401) {
+    return new FlyUnauthorizedError({ method, path })
+  }
+  if (httpStatus === 404) {
+    return new FlyNotFoundError({ method, path })
+  }
+  if (httpStatus === 412) {
+    return new FlyPreconditionFailedError({ method, path })
+  }
+  if (httpStatus === 422) {
+    return new FlyUnprocessableEntityError({ method, path })
+  }
+  if (httpStatus === 500) {
+    return new FlyInternalServerError({ method, path })
+  }
+
+  return new FlyApiError({ method, path, httpStatus })
+}
+
+export function createFlyGraphQLError({
+  path,
+  messages,
+}: {
+  path: string
+  messages: string[]
+}): FlyGraphQLError {
+  return new FlyGraphQLError({
+    path,
+    messages: messages.join('; '),
+  })
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null
+}
+
+function isMainStatusCode(value: unknown): value is MainStatusCode {
+  return value === 'unknown' || value === 'insufficient_capacity'
+}

package/src/index.ts

@@ -0,0 +1,141 @@
+// fly-admin — TypeScript client for Fly Machines REST and GraphQL APIs.
+// Vendored fork of supabase/fly-admin. Uses native fetch, adds exec/releaseLease/metadata.
+
+export { Client, FLY_API_GRAPHQL, FLY_API_HOSTNAME } from './client.ts'
+export type { ClientConfig } from './client.ts'
+
+export {
+  FlyApiError,
+  FlyBadRequestError,
+  FlyUnauthorizedError,
+  FlyNotFoundError,
+  FlyPreconditionFailedError,
+  FlyUnprocessableEntityError,
+  FlyInternalServerError,
+  FlyGraphQLError,
+} from './errors.ts'
+export type { FlyClientError, FlyResult } from './errors.ts'
+
+export { App, AppStatus } from './app.ts'
+export type {
+  ListAppRequest,
+  ListAppResponse,
+  ListAppsParams,
+  GetAppRequest,
+  AppOrganizationInfo,
+  AppInfo,
+  AppResponse,
+  IPAddress,
+  CreateAppRequest,
+  DeleteAppRequest,
+  ListCertificatesRequest,
+  RequestAcmeCertificateRequest,
+  RequestCustomCertificateRequest,
+  CertificateRequest,
+  CreateDeployTokenRequest,
+  ListSecretKeysRequest,
+  SecretKeyRequest,
+  SetSecretKeyRequest,
+  SecretKeyDecryptRequest,
+  SecretKeyEncryptRequest,
+  SecretKeySignRequest,
+  SecretKeyVerifyRequest,
+  ListSecretsRequest,
+  UpdateSecretsRequest,
+  SecretRequest,
+  SetSecretRequest,
+  AssignIPAddressRequest,
+  DeleteIPAddressRequest,
+} from './app.ts'
+
+export { Machine, MachineState, ConnectionHandler } from './machine.ts'
+export type {
+  MachineConfig,
+  ListMachineRequest,
+  CreateMachineRequest,
+  MachineEvent,
+  MachineResponse,
+  GetMachineRequest,
+  DeleteMachineRequest,
+  RestartMachineRequest,
+  SignalMachineRequest,
+  StopMachineRequest,
+  StartMachineRequest,
+  UpdateMachineRequest,
+  ListEventsRequest,
+  ListVersionsRequest,
+  ListProcessesRequest,
+  ProcessResponse,
+  WaitMachineRequest,
+  WaitMachineStopRequest,
+  MachineVersionResponse,
+  GetLeaseRequest,
+  LeaseResponse,
+  AcquireLeaseRequest,
+  ReleaseLeaseRequest,
+  CordonMachineRequest,
+  UncordonMachineRequest,
+  ExecMachineRequest,
+  ExecMachineResponse,
+  GetMetadataRequest,
+  UpdateMetadataRequest,
+  GetMetadataPropertyRequest,
+  SetMetadataPropertyRequest,
+  DeleteMetadataPropertyRequest,
+  MachineMemoryResponse,
+  UpdateMemoryRequest,
+  ReclaimMemoryMachineRequest,
+  ReclaimMemoryResponse,
+  ListOrgMachinesRequest,
+  OrgMachinesResponse,
+  ListEventsOptions,
+} from './machine.ts'
+
+export { Network, AddressType } from './network.ts'
+export type {
+  AllocateIPAddressInput,
+  AllocateIPAddressOutput,
+  ReleaseIPAddressInput,
+  ReleaseIPAddressOutput,
+} from './network.ts'
+
+export { Organization } from './organization.ts'
+export type { GetOrganizationInput, GetOrganizationOutput } from './organization.ts'
+
+export { Regions } from './regions.ts'
+export type { GetRegionsOutput, GetPlatformRegionsRequest } from './regions.ts'
+
+export { Token } from './token.ts'
+export type { RequestOIDCTokenRequest } from './token.ts'
+
+export { Secret } from './secret.ts'
+export type {
+  SetSecretsInput,
+  SetSecretsOutput,
+  UnsetSecretsInput,
+  UnsetSecretsOutput,
+} from './secret.ts'
+
+export { Volume } from './volume.ts'
+export type {
+  ListVolumesRequest,
+  CreateVolumeRequest,
+  VolumeResponse,
+  GetVolumeRequest,
+  UpdateVolumeRequest,
+  DeleteVolumeRequest,
+  ExtendVolumeRequest,
+  ExtendVolumeResponse,
+  ListSnapshotsRequest,
+  SnapshotResponse,
+} from './volume.ts'
+
+export type * from './types.ts'
+
+export function createClient(apiKey: string, config?: { graphqlUrl?: string; apiUrl?: string }) {
+  return new Client(apiKey, config)
+}
+
+// Re-export Client as default for backwards compat with supabase/fly-admin
+import { Client } from './client.ts'
+export default Client