@alchemy.run/fly 0.0.0 → 2.0.0-beta.84

package/lib/MountVolume.d.ts

@@ -0,0 +1,295 @@
+import * as Binding from "alchemy/Binding";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+/**
+ * Spec for a per-replica Fly disk. Fly Volumes cannot be shared —
+ * `count` Machines get `count` Volumes in one name-group.
+ */
+export interface DiskSpec {
+    /**
+     * Absolute path inside the Machine the disk is mounted at
+     * (e.g. `/data`).
+     */
+    path: string;
+    /**
+     * Size in GB. Fly minimum is 1. Increasing size updates in place
+     * via `extendVolume`. Fly cannot shrink a Volume.
+     */
+    sizeGb: number;
+    /**
+     * Encrypt the Volume at rest. Create-only.
+     */
+    encrypted?: boolean;
+    /**
+     * Filesystem type (`ext4`, …). Create-only.
+     */
+    fstype?: string;
+    /**
+     * Enable scheduled automatic snapshots.
+     *
+     * @default true
+     */
+    autoBackupEnabled?: boolean;
+    /**
+     * Snapshot retention in days. Updated in place via `updateVolume`.
+     */
+    snapshotRetention?: number;
+    /**
+     * Restore from an existing snapshot. Create-only.
+     */
+    snapshotId?: string;
+    /**
+     * Fork from an existing volume. Create-only.
+     */
+    sourceVolumeId?: string;
+    /**
+     * Require the Volume to land in a unique zone. Create-only.
+     */
+    requireUniqueZone?: boolean;
+    /**
+     * Fly volume-group name. If omitted, a unique name is generated
+     * from the host's logical ID and {@link path}.
+     */
+    name?: string;
+}
+export interface MountVolumeOptions extends DiskSpec {
+}
+/**
+ * Runtime view of a disk mounted into a {@link Service}: the path
+ * inside the Machine.
+ */
+export interface MountedVolume {
+    /** Mount path inside the Machine (same value as {@link DiskSpec.path}). */
+    path: string;
+}
+/**
+ * Observed disk attached to a Machine / Service replica.
+ */
+export interface MountedDisk {
+    /** Mount path inside the Machine. */
+    path: string;
+    /** Fly Volume id. */
+    volumeId: string;
+    /** Size in GB. */
+    sizeGb: number;
+    /** Fly volume-group name. */
+    name: string;
+}
+/**
+ * Binding contract accepted by {@link Service} (and Machine) for mounted
+ * disks and injected env.
+ */
+export interface ServiceBinding {
+    env?: Record<string, any>;
+    mounts?: DiskSpec[];
+    /**
+     * Upstash Redis add-on to attach. Redis HTTP bindings write
+     * `REDIS_URL` as an App secret during Service reconcile.
+     */
+    redis?: {
+        name: string;
+        id?: string;
+    };
+    /**
+     * Tigris bucket to attach. Object HTTP bindings write `AWS_*` /
+     * `BUCKET_NAME` as App secrets during Service reconcile.
+     */
+    bucket?: {
+        name: string;
+        id?: string;
+    };
+    /**
+     * Managed Postgres cluster to attach. `Fly.ConnectPostgres` records
+     * the MPG attachment during Service reconcile. Connection URIs travel
+     * as Outputs (`yield* postgres.connectionUri`), not bind env.
+     */
+    postgres?: {
+        clusterId: string;
+        variableName?: string;
+    };
+    /**
+     * Another Service this one calls, recorded by `Fly.bindService` and
+     * `Fly.bindEndpoint`. Service reconcile checks the target is reachable
+     * from this Service's network and, for an endpoint, that the port is
+     * published.
+     */
+    target?: BoundTarget;
+}
+/** A Service bound by `Fly.bindService` or `Fly.bindEndpoint`. */
+export interface BoundTarget {
+    /** Logical id of the bound Service. */
+    service: string;
+    /** Fly App the bound Service runs in. */
+    appName: string;
+    /** Private network of that App. `undefined` for the default network. */
+    network: string | undefined;
+    /** The bound Service's private address; `undefined` when it publishes nothing. */
+    privateUrl: string | undefined;
+    /** The bound Service's caller token. */
+    rpcToken?: import("effect/Redacted").Redacted<string>;
+    /** Port `Fly.bindEndpoint` targets; the binding port for `bindService`. */
+    port?: number;
+    /** Ports the bound Service publishes, for `Fly.bindEndpoint`. */
+    endpoints?: Array<{
+        port: number;
+        handlers: string[];
+    }>;
+}
+/**
+ * Create a per-replica Fly Volume and mount it into a {@link Service}.
+ *
+ * There is no standalone Volume resource. From a {@link Machine}, pass
+ * `mounts: [{ path, sizeGb }]` instead.
+ *
+ *
+ * ### Mount into a Service
+ * Yield `MountVolume` inside init. App and region come from the
+ * parent Service. Provide {@link MountVolumeLive}. At runtime you get
+ * `disk.path`.
+ *
+ * A Volume attaches to one Machine. `count: 3` creates three Volumes
+ * in one name-group, one per replica.
+ *
+ * **Example:** Bind a path
+ * ```typescript
+ * export default class Api extends Fly.Service<Api>()(
+ *   "Api",
+ *   { app: Site, main: import.meta.url, region: "iad", count: 3, port: 3000 },
+ *   Effect.gen(function* () {
+ *     const disk = yield* Fly.MountVolume({ path: "/data", sizeGb: 1 });
+ *     const fs = yield* FileSystem.FileSystem;
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const text = yield* fs.readFileString(`${disk.path}/hello.txt`);
+ *         return HttpServerResponse.text(text);
+ *       }),
+ *     };
+ *   }).pipe(Effect.provide(Fly.MountVolumeLive)),
+ * ) {}
+ * ```
+ *
+ * ### Grow a disk
+ * `sizeGb` can grow in place via `extendVolume`. Fly cannot shrink a
+ * Volume. Minimum size is 1 GB.
+ *
+ * **Example:** 10 GB
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({ path: "/data", sizeGb: 10 });
+ * ```
+ *
+ * ### Encryption
+ * `encrypted` encrypts the Volume at rest.
+ *
+ * **Example:** Encrypted
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   encrypted: true,
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Flipping `encrypted` later is ignored.
+ * :::
+ *
+ * ### Filesystem
+ * `fstype` is the filesystem (`ext4`, …).
+ *
+ * **Example:** ext4
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   fstype: "ext4",
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Flipping `fstype` later is ignored.
+ * :::
+ *
+ * ### Scheduled snapshots
+ * Scheduled snapshots default on (`autoBackupEnabled`).
+ * `snapshotRetention` is days and updates in place. An on-demand
+ * snapshot is {@link VolumeSnapshot}.
+ *
+ * **Example:** Retention
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   autoBackupEnabled: true,
+ *   snapshotRetention: 5,
+ * });
+ * ```
+ *
+ * ### Restore from a snapshot
+ * `snapshotId` restores into a new disk.
+ *
+ * **Example:** snapshotId
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   snapshotId: Nightly.snapshotId,
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Changing `snapshotId` later is ignored.
+ * :::
+ *
+ * ### Fork a volume
+ * `sourceVolumeId` forks from an existing Volume.
+ *
+ * **Example:** sourceVolumeId
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   sourceVolumeId: box.mounts[0].volumeId,
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Changing `sourceVolumeId` later is ignored.
+ * :::
+ *
+ * ### Unique zone
+ * `requireUniqueZone` asks Fly to land the Volume in a unique zone.
+ *
+ * **Example:** Unique zone
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   requireUniqueZone: true,
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Flipping `requireUniqueZone` later is ignored.
+ * :::
+ *
+ * ### Volume name
+ * `name` is the Fly volume-group name. If omitted, a unique name is
+ * generated from the host's logical ID and `path`.
+ *
+ * **Example:** Named group
+ * ```typescript
+ * const disk = yield* Fly.MountVolume({
+ *   path: "/data",
+ *   sizeGb: 1,
+ *   name: "api_data",
+ * });
+ * ```
+ *
+ * @binding
+ * @product Volume
+ */
+export interface MountVolume extends Binding.Service<MountVolume, "Fly.MountVolume", (options: MountVolumeOptions) => Effect.Effect<MountedVolume>> {
+}
+export declare const MountVolume: MountVolume;
+export declare const MountVolumeLive: Layer.Layer<MountVolume, never, never>;
+//# sourceMappingURL=MountVolume.d.ts.map

package/lib/MountVolume.d.ts.map

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

package/lib/MountVolume.js

@@ -0,0 +1,20 @@
+import * as Binding from "alchemy/Binding";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+const isBindHost = (value) => typeof value === "object" &&
+    value !== null &&
+    (value.Type === "Fly.Service" ||
+        value.Type === "Fly.Machine");
+export const MountVolume = Binding.Service("Fly.MountVolume");
+export const MountVolumeLive = Layer.effect(MountVolume, Effect.succeed(Effect.fn(function* (options) {
+    if (!globalThis.__ALCHEMY_RUNTIME__) {
+        const host = yield* Binding.Host;
+        if (isBindHost(host)) {
+            yield* host.bind `Fly.MountVolume(${options.path})`({
+                mounts: [options],
+            });
+        }
+    }
+    return { path: options.path };
+})));
+//# sourceMappingURL=MountVolume.js.map

package/lib/MountVolume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MountVolume.js","sourceRoot":"","sources":["../src/MountVolume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AA+EtC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAuD,EAAE,CACzF,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,CAAE,KAA2B,CAAC,IAAI,KAAK,aAAa;QACjD,KAA2B,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;AAmNzD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAc,iBAAiB,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CACzC,WAAW,EACX,MAAM,CAAC,OAAO,CACZ,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,OAA2B;IAC9C,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA,mBAAmB,OAAO,CAAC,IAAI,GAAG,CAAC;gBACjD,MAAM,EAAE,CAAC,OAAO,CAAC;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC,CAAC,CACH,CACF,CAAC"}

package/lib/Postgres.d.ts

@@ -0,0 +1,298 @@
+import { type MigrationsInput } from "@alchemy.run/sql/Migrations";
+import * as machines from "@distilled.cloud/fly-io/machines";
+import type { ClusterCredentials, GetClusterResponse, ManagedCluster } from "@distilled.cloud/fly-io/mpg";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "./Providers.ts";
+export { stripSslQueryParams } from "./PostgresMigrations.ts";
+export declare const DEFAULT_POSTGRES_PLAN = "basic";
+export declare const DEFAULT_VOLUME_GB = 10;
+export declare const DATABASE_URL_SECRET = "DATABASE_URL";
+export declare const DIRECT_DATABASE_URL_SECRET = "DIRECT_DATABASE_URL";
+export type PostgresPlan = "basic" | "starter" | "launch" | "scale" | "performance" | (string & {});
+export interface PostgresProps {
+    /**
+     * Region the cluster lives in (`iad`, `ord`, `sjc`, …). Required.
+     * The cluster is regional; a {@link App} is global. Changing it
+     * replaces the cluster.
+     */
+    region: string;
+    /**
+     * Hardware plan. `basic` is 2 shared vCPUs / 1 GB RAM.
+     *
+     * @default "basic"
+     */
+    plan?: PostgresPlan;
+    /**
+     * Cluster name. Unique in the organization. If omitted, a unique
+     * name is generated from the stack, stage and logical ID. Changing
+     * it replaces the cluster.
+     */
+    name?: string;
+    /**
+     * Organization slug. Defaults to the current token's org. Changing
+     * it replaces the cluster.
+     */
+    orgSlug?: string;
+    /**
+     * Initial volume size in GB. Fly defaults to 10. Create-only.
+     *
+     * @default 10
+     */
+    volumeSizeGb?: number;
+    /**
+     * Enable PostGIS. Create-only.
+     *
+     * @default false
+     */
+    postgis?: boolean;
+    /**
+     * Postgres major version (`16` or `17`). Create-only.
+     *
+     * @default 16
+     */
+    pgMajorVersion?: number | string;
+    /**
+     * SQL migrations to apply against the cluster. Accepts a directory
+     * path, a `Drizzle.Schema` resource, or `{ dir, table? }`.
+     *
+     * Bookkeeping always lives in Alchemy's `__alchemy_migrations` table. A
+     * database previously migrated by drizzle-kit or Prisma is adopted by a
+     * one-way conversion on first deploy: the old tool's applied history is
+     * copied into Alchemy's table and the old table is left frozen. No
+     * baselining required.
+     *
+     * Applied over the **direct** (non-PgBouncer) URI. Fly Managed Postgres
+     * is reachable on the org private network; deploy-time apply needs a
+     * route to that network (a WireGuard peer, `fly mpg proxy`, or a
+     * machine already on 6PN).
+     */
+    migrations?: MigrationsInput;
+    /**
+     * Paths to additional `.sql` files to apply after migrations. Each file
+     * is hashed; only files whose contents change are re-applied on
+     * subsequent deploys.
+     */
+    importFiles?: string[];
+}
+export type Postgres = Resource<"Fly.Postgres", PostgresProps, {
+    /** Fly Managed Postgres cluster id. */
+    clusterId: string;
+    /** Cluster name (unique in the org). */
+    name: string;
+    /** Observed status (`creating`, `ready`, `error`, `deleted`, …). */
+    status: string | undefined;
+    /** Region the cluster lives in. */
+    region: string;
+    /** Observed hardware plan. */
+    plan: string | undefined;
+    /** Organization slug. */
+    orgSlug: string | undefined;
+    /** Observed disk size in GB. */
+    disk: number | undefined;
+    /** Whether PostGIS is enabled. */
+    postgisEnabled: boolean | undefined;
+    /** Observed engine string, if the API returned one. */
+    engine: string | undefined;
+    /** Observed replica count. */
+    replicas: number | undefined;
+    /** Internal MPG cluster hash id, if the API returned one. */
+    mpgdClusterId: string | undefined;
+    /**
+     * Direct (non-PgBouncer) Postgres URI. Use this for migrations and
+     * session-scoped features. Pass to `Drizzle.Postgres` from a laptop
+     * Action; from a {@link Service} prefer {@link ConnectPostgres}.
+     */
+    connectionUri: string;
+    /** Pooled PgBouncer URI. Prefer {@link ConnectPostgres} from a Service. */
+    pooledConnectionUri: string;
+    migrationsDir: string | undefined;
+    migrationsTable: string | undefined;
+    migrationsHashes: Record<string, string>;
+    importHashes: Record<string, string>;
+}, never, Providers>;
+/**
+ * A Fly.Postgres is a Managed Postgres (MPG) cluster. It is billed.
+ * Do not wrap unmanaged `fly postgres`.
+ *
+ * @see https://fly.io/docs/mpg/create-and-connect/
+ *
+ * ### Create a cluster
+ * `region` is required. Alchemy generates a unique name unless you
+ * pass one. Omit `name` in tests and CI.
+ *
+ * **Example:** Generated name
+ * ```typescript
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "iad",
+ * });
+ * ```
+ *
+ * :::caution[Billed]
+ * Managed Postgres is billed. Basic is about $38 per month.
+ * :::
+ *
+ * ### Plan
+ * `plan` is the hardware size: `basic`, `starter`, `launch`,
+ * `scale`, `performance`. Default is `basic`.
+ *
+ * **Example:** Starter
+ * ```typescript
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "iad",
+ *   plan: "starter",
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Changing `plan` later is ignored. Fly has no cluster update API.
+ * :::
+ *
+ * ### Region
+ * The cluster is regional. An {@link App} is global. Pass `region`
+ * on the cluster, not on the App.
+ *
+ * **Example:** Pin a region
+ * ```typescript
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "lhr",
+ * });
+ * ```
+ *
+ * :::caution[Changing `region` replaces the cluster]
+ * A new cluster is created in the new region. The old cluster is
+ * deleted. Data is not copied.
+ * :::
+ *
+ * ### Volume size
+ * `volumeSizeGb` is the initial disk. Fly defaults to 10 GB.
+ *
+ * **Example:** 20 GB
+ * ```typescript
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "iad",
+ *   volumeSizeGb: 20,
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Changing `volumeSizeGb` later is ignored.
+ * :::
+ *
+ * ### PostGIS
+ * `postgis: true` enables PostGIS at create.
+ *
+ * **Example:** Enable PostGIS
+ * ```typescript
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "iad",
+ *   postgis: true,
+ * });
+ * ```
+ *
+ * :::note[Create-only]
+ * Flipping `postgis` later is ignored.
+ * :::
+ *
+ * ### Connect from a Service
+ * Yield `ConnectPostgres` inside init. Provide
+ * {@link ConnectPostgresHttp}. Pass `conn.connectionString` to
+ * `Drizzle.Postgres` or `SQL.Postgres`.
+ *
+ * **Example:** Bind and query
+ * ```typescript
+ * import * as Drizzle from "@alchemy.run/drizzle/Postgres";
+ * import * as HttpServerResponse from "effect/http/HttpServerResponse";
+ *
+ * export default class Api extends Fly.Service<Api>()(
+ *   "Api",
+ *   { app: Site, main: import.meta.url, port: 3000 },
+ *   Effect.gen(function* () {
+ *     const conn = yield* Fly.ConnectPostgres(Db);
+ *     const db = yield* Drizzle.Postgres(conn.connectionString);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const rows = yield* db.execute("select 1 as ok");
+ *         return HttpServerResponse.json({ rows });
+ *       }),
+ *     };
+ *   }).pipe(Effect.provide(Fly.ConnectPostgresHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Migrations
+ * Pass a directory, `{ dir, table? }`, or a `Drizzle.Schema` resource.
+ * Alchemy applies pending files on deploy over the direct URI.
+ *
+ * **Example:** Directory
+ * ```typescript
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "iad",
+ *   migrations: "./migrations",
+ * });
+ * ```
+ *
+ * **Example:** Drizzle.Schema
+ * ```typescript
+ * const schema = yield* Drizzle.Schema("app-schema", {
+ *   schema: "./src/schema.ts",
+ *   out: "./migrations",
+ * });
+ *
+ * const db = yield* Fly.Postgres("Db", {
+ *   region: "iad",
+ *   migrations: schema,
+ * });
+ * ```
+ *
+ * @resource
+ * @product Postgres
+ */
+export declare const Postgres: import("alchemy/Resource").ResourceClass<Postgres>;
+declare const PostgresNotCreated_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Fly.PostgresNotCreated";
+} & Readonly<A>;
+export declare class PostgresNotCreated extends PostgresNotCreated_base<{
+    name: string;
+    orgSlug: string;
+}> {
+}
+declare const PostgresCreateFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Fly.PostgresCreateFailed";
+} & Readonly<A>;
+export declare class PostgresCreateFailed extends PostgresCreateFailed_base<{
+    clusterId: string;
+    status: string;
+}> {
+}
+declare const PostgresCredentialsMissing_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Fly.PostgresCredentialsMissing";
+} & Readonly<A>;
+export declare class PostgresCredentialsMissing extends PostgresCredentialsMissing_base<{
+    clusterId: string;
+}> {
+}
+declare const PostgresAttachmentFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Fly.PostgresAttachmentFailed";
+} & Readonly<A>;
+export declare class PostgresAttachmentFailed extends PostgresAttachmentFailed_base<{
+    clusterId: string;
+    appName: string;
+}> {
+}
+export declare const isLiveCluster: (cluster: ManagedCluster | undefined) => cluster is ManagedCluster;
+export declare const unwrapSensitive: (value: string | Redacted.Redacted<string> | undefined) => string | undefined;
+export declare const getLiveCluster: (clusterId: string) => Effect.Effect<ManagedCluster | undefined, machines.FlyIoOpError, machines.FlyIoOpContext>;
+export declare const getClusterResponse: (clusterId: string) => Effect.Effect<GetClusterResponse | undefined, machines.FlyIoOpError, machines.FlyIoOpContext>;
+export declare const credentialsUri: (credentials: ClusterCredentials | undefined) => string | undefined;
+export declare const directUri: (_cluster: ManagedCluster | undefined, credentials: ClusterCredentials | undefined) => string | undefined;
+/**
+ * Write `DATABASE_URL` (and `DIRECT_DATABASE_URL` if present) onto an
+ * App and record the MPG attachment. Called from {@link Service}
+ * reconcile when {@link ConnectPostgres} binds a cluster.
+ */
+export declare const attachPostgresSecrets: (appName: string, clusterId: string, variableName?: string | undefined) => Effect.Effect<number | undefined, import("@distilled.cloud/fly-io").BadRequest | import("@distilled.cloud/fly-io").Conflict | import("@distilled.cloud/fly-io").Forbidden | import("@distilled.cloud/fly-io").NotFound | PostgresAttachmentFailed | PostgresCredentialsMissing | import("effect/Cause").TimeoutError | machines.FlyIoOpError, machines.FlyIoOpContext>;
+export declare const PostgresProvider: () => import("effect/Layer").Layer<Provider.Provider<Postgres>, never, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | machines.FlyIoOpContext>;
+//# sourceMappingURL=Postgres.d.ts.map

package/lib/Postgres.d.ts.map

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