@fly.io/sdk 0.1.0

package/src/network.ts

@@ -0,0 +1,87 @@
+// Network (IP address) management via Fly GraphQL API.
+
+import { Client } from './client.ts'
+import type { FlyResult } from './errors.ts'
+
+export enum AddressType {
+  v4 = 'v4',
+  v6 = 'v6',
+  private_v6 = 'private_v6',
+  shared_v4 = 'shared_v4',
+}
+
+export interface AllocateIPAddressInput {
+  appId: string
+  type: AddressType
+  organizationId?: string
+  region?: string
+  network?: string
+}
+
+export interface AllocateIPAddressOutput {
+  allocateIpAddress: {
+    ipAddress: {
+      id: string
+      address: string
+      type: AddressType
+      region: string
+      createdAt: string
+    } | null
+  }
+}
+
+const allocateIpAddressQuery = `mutation($input: AllocateIPAddressInput!) {
+  allocateIpAddress(input: $input) {
+    ipAddress {
+      id
+      address
+      type
+      region
+      createdAt
+    }
+  }
+}`
+
+export interface ReleaseIPAddressInput {
+  appId?: string
+  ipAddressId?: string
+  ip?: string
+}
+
+export interface ReleaseIPAddressOutput {
+  releaseIpAddress: {
+    app: {
+      name: string
+    }
+  }
+}
+
+const releaseIpAddressQuery = `mutation($input: ReleaseIPAddressInput!) {
+  releaseIpAddress(input: $input) {
+    app {
+      name
+    }
+  }
+}`
+
+export class Network {
+  private client: Client
+
+  constructor(client: Client) {
+    this.client = client
+  }
+
+  async allocateIpAddress(input: AllocateIPAddressInput): Promise<FlyResult<AllocateIPAddressOutput>> {
+    return this.client.gqlPostOrThrow({
+      query: allocateIpAddressQuery,
+      variables: { input },
+    })
+  }
+
+  async releaseIpAddress(input: ReleaseIPAddressInput): Promise<FlyResult<ReleaseIPAddressOutput>> {
+    return this.client.gqlPostOrThrow({
+      query: releaseIpAddressQuery,
+      variables: { input },
+    })
+  }
+}

package/src/organization.ts

@@ -0,0 +1,43 @@
+// Organization queries via Fly GraphQL API.
+
+import { Client } from './client.ts'
+import type { FlyResult } from './errors.ts'
+
+export type GetOrganizationInput = string
+
+interface OrganizationResponse {
+  id: string
+  slug: string
+  name: string
+  type: 'PERSONAL' | 'SHARED'
+  viewerRole: 'admin' | 'member'
+}
+
+export interface GetOrganizationOutput {
+  organization: OrganizationResponse
+}
+
+const getOrganizationQuery = `query($slug: String!) {
+  organization(slug: $slug) {
+    id
+    slug
+    name
+    type
+    viewerRole
+  }
+}`
+
+export class Organization {
+  private client: Client
+
+  constructor(client: Client) {
+    this.client = client
+  }
+
+  async getOrganization(slug: GetOrganizationInput): Promise<FlyResult<GetOrganizationOutput>> {
+    return this.client.gqlPostOrThrow({
+      query: getOrganizationQuery,
+      variables: { slug },
+    })
+  }
+}

package/src/regions.ts

@@ -0,0 +1,94 @@
+// Region listing via Fly GraphQL API.
+
+import { Client } from './client.ts'
+import type { FlyResult } from './errors.ts'
+import type {
+  MainGetPlacementsRequest,
+  MainGetPlacementsResponse,
+  MainRegionResponse,
+} from './types.ts'
+
+interface RegionResponse {
+  name: string
+  code: string
+  latitude: number
+  longitude: number
+  gatewayAvailable: boolean
+  requiresPaidPlan: boolean
+}
+
+interface PlatformResponse {
+  requestRegion: string
+  regions: RegionResponse[]
+}
+
+export interface GetRegionsOutput {
+  platform: PlatformResponse
+}
+
+export interface GetPlatformRegionsRequest {
+  size?: string
+  cpu_kind?: string
+  memory_mb?: number
+  cpus?: number
+  gpus?: number
+  gpu_kind?: string
+}
+
+const getRegionsQuery = `query {
+  platform {
+    requestRegion
+    regions {
+      name
+      code
+      latitude
+      longitude
+      gatewayAvailable
+      requiresPaidPlan
+    }
+  }
+}`
+
+export class Regions {
+  private client: Client
+
+  constructor(client: Client) {
+    this.client = client
+  }
+
+  async getRegions(): Promise<FlyResult<GetRegionsOutput>> {
+    return this.client.gqlPostOrThrow({
+      query: getRegionsQuery,
+      variables: {},
+    })
+  }
+
+  async getPlatformRegions(payload: GetPlatformRegionsRequest = {}): Promise<FlyResult<MainRegionResponse>> {
+    const params = new URLSearchParams()
+    if (payload.size) {
+      params.set('size', payload.size)
+    }
+    if (payload.cpu_kind) {
+      params.set('cpu_kind', payload.cpu_kind)
+    }
+    if (payload.memory_mb !== undefined) {
+      params.set('memory_mb', String(payload.memory_mb))
+    }
+    if (payload.cpus !== undefined) {
+      params.set('cpus', String(payload.cpus))
+    }
+    if (payload.gpus !== undefined) {
+      params.set('gpus', String(payload.gpus))
+    }
+    if (payload.gpu_kind) {
+      params.set('gpu_kind', payload.gpu_kind)
+    }
+    const query = params.toString()
+    const path = `platform/regions${query ? `?${query}` : ''}`
+    return await this.client.restOrThrow(path)
+  }
+
+  async getPlacements(request: MainGetPlacementsRequest): Promise<FlyResult<MainGetPlacementsResponse>> {
+    return await this.client.restOrThrow('platform/placements', 'POST', request)
+  }
+}

package/src/secret.ts

@@ -0,0 +1,101 @@
+// Secrets management via Fly GraphQL API.
+
+import { Client } from './client.ts'
+import type { FlyResult } from './errors.ts'
+
+export interface SetSecretsInput {
+  appId: string
+  secrets: { key: string; value: string }[]
+  replaceAll?: boolean
+}
+
+export interface SetSecretsOutput {
+  setSecrets: {
+    release: {
+      id: string
+      version: string
+      reason: string
+      description: string
+      user: { id: string; email: string; name: string }
+      evaluationId: string
+      createdAt: string
+    } | null
+  }
+}
+
+const setSecretsQuery = `mutation($input: SetSecretsInput!) {
+  setSecrets(input: $input) {
+    release {
+      id
+      version
+      reason
+      description
+      user {
+        id
+        email
+        name
+      }
+      evaluationId
+      createdAt
+    }
+  }
+}`
+
+export interface UnsetSecretsInput {
+  appId: string
+  keys: string[]
+}
+
+export interface UnsetSecretsOutput {
+  unsetSecrets: {
+    release: {
+      id: string
+      version: string
+      reason: string
+      description: string
+      user: { id: string; email: string; name: string }
+      evaluationId: string
+      createdAt: string
+    } | null
+  }
+}
+
+const unsetSecretsQuery = `mutation($input: UnsetSecretsInput!) {
+  unsetSecrets(input: $input) {
+    release {
+      id
+      version
+      reason
+      description
+      user {
+        id
+        email
+        name
+      }
+      evaluationId
+      createdAt
+    }
+  }
+}`
+
+export class Secret {
+  private client: Client
+
+  constructor(client: Client) {
+    this.client = client
+  }
+
+  async setSecrets(input: SetSecretsInput): Promise<FlyResult<SetSecretsOutput>> {
+    return await this.client.gqlPostOrThrow({
+      query: setSecretsQuery,
+      variables: { input },
+    })
+  }
+
+  async unsetSecrets(input: UnsetSecretsInput): Promise<FlyResult<UnsetSecretsOutput>> {
+    return await this.client.gqlPostOrThrow({
+      query: unsetSecretsQuery,
+      variables: { input },
+    })
+  }
+}

package/src/token.ts

@@ -0,0 +1,29 @@
+// Token management for Fly Machines REST API.
+
+import { Client } from './client.ts'
+import type { CreateOIDCTokenRequest, CurrentTokenResponse } from './types.ts'
+import type { FlyResult } from './errors.ts'
+
+export interface RequestOIDCTokenRequest {
+  request: CreateOIDCTokenRequest
+}
+
+export class Token {
+  private client: Client
+
+  constructor(client: Client) {
+    this.client = client
+  }
+
+  async requestKmsToken(): Promise<FlyResult<string>> {
+    return await this.client.restOrThrow('tokens/kms', 'POST')
+  }
+
+  async requestOidcToken(payload: RequestOIDCTokenRequest): Promise<FlyResult<string>> {
+    return await this.client.restOrThrow('tokens/oidc', 'POST', payload.request)
+  }
+
+  async getCurrentToken(): Promise<FlyResult<CurrentTokenResponse>> {
+    return await this.client.restOrThrow('tokens/current')
+  }
+}