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

package/lib/Connect.d.ts

@@ -0,0 +1,79 @@
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type * as Redacted from "effect/Redacted";
+import type { Database } from "./Database.ts";
+import { type TokenAuthorization } from "./DatabaseToken.ts";
+/**
+ * libSQL connection accessors for one Turso database. Resolving them does
+ * not open a connection; pass the client to `SQL.LibSQL` or
+ * `Drizzle.LibSQL`, or read `url` / `authToken` for `@libsql/client`.
+ */
+export interface ConnectClient {
+    /** libSQL URL of the database (`libsql://<hostname>`). */
+    url: Effect.Effect<string, never, RuntimeContext>;
+    /** SQL auth token for the database. */
+    authToken: Effect.Effect<Redacted.Redacted<string>, never, RuntimeContext>;
+}
+export interface ConnectOptions {
+    /**
+     * Access level of the token minted for this host.
+     * @default "full-access"
+     */
+    authorization?: TokenAuthorization;
+}
+/**
+ * Connect to a Turso database from a Worker, Lambda, or other host. The
+ * host gets the database's URL and its own {@link DatabaseToken}. Your
+ * Turso API token stays on your machine.
+ *
+ * ### Querying a Database
+ * **Example:** Effect SQL over a Turso database
+ * ```typescript
+ * Effect.gen(function* () {
+ *   const conn = yield* Turso.Connect(Db);
+ *   const sql = yield* SQL.LibSQL(conn);
+ *   return {
+ *     fetch: Effect.gen(function* () {
+ *       return yield* HttpServerResponse.json(yield* sql`SELECT 1 AS value`);
+ *     }),
+ *   };
+ * }).pipe(Effect.provide(Turso.ConnectHttp));
+ * ```
+ *
+ * **Example:** Drizzle over a Turso database
+ * ```typescript
+ * const conn = yield* Turso.Connect(Db);
+ * const db = yield* Drizzle.LibSQL(conn, { relations });
+ * ```
+ *
+ * **Example:** AWS Lambda (install the native libSQL client)
+ * ```typescript
+ * export default class Api extends Lambda.Function<Api>()(
+ *   "Api",
+ *   { main: import.meta.url, build: { install: ["@libsql/client"] } },
+ *   Effect.gen(function* () {
+ *     const sql = yield* SQL.LibSQL(yield* Turso.Connect(Db));
+ *     // ...
+ *   }).pipe(Effect.provide(Turso.ConnectHttp)),
+ * ) {}
+ * ```
+ *
+ * **Example:** Read-only access
+ * ```typescript
+ * const conn = yield* Turso.Connect(Db, { authorization: "read-only" });
+ * ```
+ *
+ * @binding
+ * @product Database
+ */
+export interface Connect extends Binding.Service<Connect, "Turso.Connect", (database: Database, options?: ConnectOptions) => Effect.Effect<ConnectClient>> {
+}
+export declare const Connect: Connect;
+/**
+ * Host-independent implementation: the URL and a per-host token are bound
+ * as environment values, so it works on any Platform host.
+ */
+export declare const ConnectHttp: Layer.Layer<Connect, never, never>;
+//# sourceMappingURL=Connect.d.ts.map

package/lib/Connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connect.d.ts","sourceRoot":"","sources":["../src/Connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAClD,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,WAAW,OAAQ,SAAQ,OAAO,CAAC,OAAO,CAC9C,OAAO,EACP,eAAe,EACf,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAC/E;CAAG;AAEJ,eAAO,MAAM,OAAO,SAA4C,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,WAAW,oCAiBvB,CAAC"}

package/lib/Connect.js

@@ -0,0 +1,22 @@
+import * as Binding from "alchemy/Binding";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { DatabaseToken } from "./DatabaseToken.js";
+export const Connect = Binding.Service("Turso.Connect");
+/**
+ * Host-independent implementation: the URL and a per-host token are bound
+ * as environment values, so it works on any Platform host.
+ */
+export const ConnectHttp = Layer.effect(Connect, Effect.gen(function* () {
+    const Token = yield* DatabaseToken;
+    return Effect.fn(function* (database, options) {
+        const host = yield* Binding.Host;
+        const authorization = options?.authorization ?? "full-access";
+        const token = yield* Token(`${host?.LogicalId ?? ""}${database.LogicalId}${authorization === "read-only" ? "ReadOnly" : ""}Token`, { database: database.name, authorization });
+        return {
+            url: yield* database.url,
+            authToken: yield* token.token,
+        };
+    });
+}));
+//# sourceMappingURL=Connect.js.map

package/lib/Connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connect.js","sourceRoot":"","sources":["../src/Connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC;AAyE5E,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAU,eAAe,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CACrC,OAAO,EACP,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC;IACnC,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAkB,EAAE,OAAwB;QACtE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,aAAa,CAAC;QAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CACxB,GAAG,IAAI,EAAE,SAAS,IAAI,EAAE,GAAG,QAAQ,CAAC,SAAS,GAAG,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EACtG,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,CAC3C,CAAC;QACF,OAAO;YACL,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG;YACxB,SAAS,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK;SACN,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC"}

package/lib/Contributions.d.ts

@@ -0,0 +1,7 @@
+import * as Contributions from "alchemy/Contributions";
+declare const _default: {
+    readonly name: "turso";
+    readonly auth: Contributions.Lazy<import("effect/Layer").Layer<never, never, import("alchemy/Auth/AuthProvider").AuthProviders | import("effect/FileSystem").FileSystem | import("effect/Path").Path>>;
+};
+export default _default;
+//# sourceMappingURL=Contributions.d.ts.map

package/lib/Contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Contributions.d.ts","sourceRoot":"","sources":["../src/Contributions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAC;;;;;AAEvD,wBAMG"}

package/lib/Contributions.js

@@ -0,0 +1,6 @@
+import * as Contributions from "alchemy/Contributions";
+export default Contributions.make({
+    name: "turso",
+    auth: Contributions.lazy(() => import("./AuthProvider.js"), (module) => module.TursoAuth),
+});
+//# sourceMappingURL=Contributions.js.map

package/lib/Contributions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Contributions.js","sourceRoot":"","sources":["../src/Contributions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAC;AAEvD,eAAe,aAAa,CAAC,IAAI,CAAC;IAChC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,aAAa,CAAC,IAAI,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,EACjC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAC7B;CACF,CAAC,CAAC"}

package/lib/Credentials.d.ts

@@ -0,0 +1,39 @@
+import { Credentials } from "@distilled.cloud/turso/Credentials";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/http/HttpClient";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+export { Credentials, CredentialsFromEnv, DEFAULT_API_BASE_URL, } from "@distilled.cloud/turso/Credentials";
+declare const Organization_base: Context.ServiceClass<Organization, "Turso.Organization", Effect.Effect<string, never, never>>;
+/**
+ * The Turso organization slug every org-scoped Platform API call targets.
+ * Holds an effect so the slug is resolved (and, when not configured,
+ * discovered from the API token) on first use, never at layer build.
+ */
+export declare class Organization extends Organization_base {
+}
+/** The organization slug for the current Turso credentials. */
+export declare const organization: Effect.Effect<string, never, Organization>;
+/**
+ * Build Turso `Credentials` + `Organization` from an explicit API token.
+ * Useful for tests or when the caller already has a token in hand.
+ *
+ * @example
+ * ```ts
+ * Effect.provide(Turso.fromToken({ apiToken: "...", organization: "my-org" }))
+ * ```
+ */
+export declare const fromToken: (input: {
+    apiToken: string | Redacted.Redacted<string>;
+    organization?: string;
+    apiBaseUrl?: string;
+}) => Layer.Layer<Credentials | Organization, never, HttpClient.HttpClient>;
+/**
+ * Build Turso `Credentials` + `Organization` that resolve through the
+ * Alchemy AuthProvider: environment credentials (`TURSO_API_TOKEN`) when
+ * present, otherwise the selected profile. Resolution is deferred until the
+ * first API call, so building the provider layers never needs a profile.
+ */
+export declare const fromAuthProvider: () => Layer.Layer<Credentials | Organization, never, import("alchemy/Auth/AuthProvider").AuthProviders | HttpClient.HttpClient | import("alchemy/Auth/Profile").ProfileStore>;
+//# sourceMappingURL=Credentials.d.ts.map

package/lib/Credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Credentials.d.ts","sourceRoot":"","sources":["../src/Credentials.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAGZ,MAAM,oCAAoC,CAAC;AAO5C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAO5C,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;;AAE5C;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,iBAEjC;CAAG;AAEJ,+DAA+D;AAC/D,eAAO,MAAM,YAAY,4CAEvB,CAAC;AA6CH;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,UAAW;IAC/B,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,0EAYE,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,+KAmB1B,CAAC"}

package/lib/Credentials.js

@@ -0,0 +1,80 @@
+import { ConfigError } from "@distilled.cloud/core/errors";
+import { Credentials, DEFAULT_API_BASE_URL, } from "@distilled.cloud/turso/Credentials";
+import * as turso from "@distilled.cloud/turso/turso";
+import { deferUntilFirstUse, orDieCredentialsUnavailable, resolveProviderConfig, } from "alchemy/Auth/Resolve";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/http/HttpClient";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { TURSO_AUTH_PROVIDER_NAME, } from "./AuthProvider.js";
+export { Credentials, CredentialsFromEnv, DEFAULT_API_BASE_URL, } from "@distilled.cloud/turso/Credentials";
+/**
+ * The Turso organization slug every org-scoped Platform API call targets.
+ * Holds an effect so the slug is resolved (and, when not configured,
+ * discovered from the API token) on first use, never at layer build.
+ */
+export class Organization extends Context.Service()("Turso.Organization") {
+}
+/** The organization slug for the current Turso credentials. */
+export const organization = Effect.gen(function* () {
+    return yield* yield* Organization;
+});
+/**
+ * Discover the organization an API token acts on: the token's own
+ * organization when it is org-scoped, else the account's only organization.
+ */
+const discoverOrganization = Effect.gen(function* () {
+    const orgs = yield* turso.listOrganizations({});
+    if (orgs.length === 1 && orgs[0]?.slug) {
+        return orgs[0].slug;
+    }
+    return yield* new ConfigError({
+        message: orgs.length === 0
+            ? "Turso: this API token has no organizations."
+            : `Turso: this API token can access ${orgs.length} organizations (${orgs
+                .map((org) => org.slug)
+                .join(", ")}). Set TURSO_ORGANIZATION or configure the organization in your profile.`,
+    });
+});
+const make = (resolve) => Effect.gen(function* () {
+    const http = yield* HttpClient.HttpClient;
+    const cached = yield* Effect.cached(resolve);
+    const credentials = Effect.map(cached, (creds) => ({
+        apiKey: creds.apiToken,
+        apiBaseUrl: creds.apiBaseUrl,
+    }));
+    const organization = yield* Effect.cached(Effect.flatMap(cached, (creds) => creds.organization !== undefined && creds.organization.length > 0
+        ? Effect.succeed(creds.organization)
+        : discoverOrganization.pipe(Effect.provideService(Credentials, credentials), Effect.provideService(HttpClient.HttpClient, http), orDieCredentialsUnavailable(TURSO_AUTH_PROVIDER_NAME))));
+    return Context.make(Credentials, credentials).pipe(Context.add(Organization, organization));
+});
+/**
+ * Build Turso `Credentials` + `Organization` from an explicit API token.
+ * Useful for tests or when the caller already has a token in hand.
+ *
+ * @example
+ * ```ts
+ * Effect.provide(Turso.fromToken({ apiToken: "...", organization: "my-org" }))
+ * ```
+ */
+export const fromToken = (input) => Layer.effectContext(make(Effect.succeed({
+    type: "apiToken",
+    apiToken: typeof input.apiToken === "string" ? Redacted.make(input.apiToken) : input.apiToken,
+    apiBaseUrl: input.apiBaseUrl ?? DEFAULT_API_BASE_URL,
+    organization: input.organization,
+    source: { type: "stored" },
+})));
+/**
+ * Build Turso `Credentials` + `Organization` that resolve through the
+ * Alchemy AuthProvider: environment credentials (`TURSO_API_TOKEN`) when
+ * present, otherwise the selected profile. Resolution is deferred until the
+ * first API call, so building the provider layers never needs a profile.
+ */
+export const fromAuthProvider = () => Layer.effectContext(Effect.gen(function* () {
+    const resolve = yield* resolveProviderConfig(TURSO_AUTH_PROVIDER_NAME).pipe(Effect.flatMap(({ profileName, resolve }) => Effect.mapError(resolve, (e) => new ConfigError({
+        message: `Failed to resolve Turso credentials from ${profileName === undefined ? "the environment" : `profile '${profileName}'`}: ${e.message}`,
+    }))), deferUntilFirstUse);
+    return yield* make(resolve.pipe(orDieCredentialsUnavailable(TURSO_AUTH_PROVIDER_NAME)));
+}));
+//# sourceMappingURL=Credentials.js.map

package/lib/Credentials.js.map

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

package/lib/Database.d.ts

@@ -0,0 +1,217 @@
+import { type MigrationsInput } from "@alchemy.run/sql/Migrations";
+import * as turso from "@distilled.cloud/turso/turso";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "./Providers.ts";
+export interface DatabaseSeed {
+    /**
+     * `"database"` copies an existing database (optionally at a point in
+     * time). `"database_upload"` creates an empty database awaiting an upload
+     * of a SQLite file.
+     */
+    type: "database" | "database_upload";
+    /** Name of the source database when `type` is `"database"`. */
+    name?: string;
+    /**
+     * ISO 8601 recovery point within the source database's retention window
+     * (24 hours, or 30 days on the Scaler plan).
+     */
+    timestamp?: string;
+}
+export interface DatabaseEncryption {
+    /**
+     * Base64-encoded encryption key: 32 bytes for `aes256gcm`,
+     * `chacha20poly1305`, and the `aegis256` variants; 16 bytes for
+     * `aes128gcm` and the `aegis128l` variants.
+     */
+    key: Redacted.Redacted<string>;
+    /** Encryption cipher. */
+    cipher: "aes256gcm" | "aes128gcm" | "chacha20poly1305" | "aegis128l" | "aegis128x2" | "aegis128x4" | "aegis256" | "aegis256x2" | "aegis256x4" | (string & {});
+}
+export interface DatabaseProps {
+    /**
+     * Database name, unique within the organization. Lowercase letters,
+     * numbers, and dashes, at most 64 characters. If omitted, a unique name
+     * is generated from the stack, stage, and logical ID. Changing it
+     * replaces the database.
+     */
+    name?: string;
+    /**
+     * Name of the group the database is created in (e.g. `group.name`).
+     * Changing it replaces the database.
+     */
+    group: string;
+    /**
+     * Seed the new database from an existing database or a pending upload.
+     * Only used when the database is created.
+     */
+    seed?: DatabaseSeed;
+    /**
+     * Encrypt the database at rest with your own key. Only used when the
+     * database is created; changing it replaces the database. Requires a Pro
+     * or Enterprise plan.
+     */
+    encryption?: DatabaseEncryption;
+    /**
+     * Maximum size of the database, in bytes or with a unit (e.g. `"256mb"`,
+     * `"1gb"`). When omitted, the current limit is left unchanged. Only
+     * legacy databases support it — Turso rejects it for databases created on
+     * the current platform ("size_limit is not supported for db-api
+     * controlled databases").
+     */
+    sizeLimit?: string;
+    /**
+     * Allow other databases to be attached to this one with `ATTACH`. Not
+     * supported on AWS-hosted databases, which reject the setting.
+     * @default false
+     */
+    allowAttach?: boolean;
+    /**
+     * Reject every read query.
+     * @default false
+     */
+    blockReads?: boolean;
+    /**
+     * Reject every write query.
+     * @default false
+     */
+    blockWrites?: boolean;
+    /**
+     * Prevent the database from being deleted. While enabled, destroying or
+     * replacing the database fails; set it to `false` and deploy first.
+     * @default false
+     */
+    deleteProtection?: boolean;
+    /**
+     * IP addresses and CIDR blocks allowed to connect. Empty or omitted means
+     * no IP restriction. Requires a paid plan.
+     */
+    allowedIps?: string[];
+    /**
+     * AWS VPC endpoint IDs (`vpce-...`) allowed to connect. Empty or omitted
+     * means no VPC endpoint restriction. Requires a paid plan.
+     */
+    allowedAwsVpcIds?: string[];
+    /**
+     * SQL migrations to apply on deploy. Accepts a directory path, a
+     * `Drizzle.Schema` resource, or `{ dir, table? }`.
+     *
+     * Bookkeeping lives in Alchemy's `__alchemy_migrations` table. A database
+     * previously migrated by drizzle-kit is adopted by a one-way conversion on
+     * first deploy.
+     */
+    migrations?: MigrationsInput;
+    /**
+     * Paths to additional `.sql` files to apply after migrations. Each file is
+     * hashed; only files whose contents change are re-applied.
+     */
+    importFiles?: string[];
+}
+export interface DatabaseAttributes {
+    /** Database UUID. */
+    dbId: string;
+    /** Database name. */
+    name: string;
+    /** The organization slug that owns the database. */
+    organization: string;
+    /** Name of the group the database belongs to. */
+    group: string;
+    /** DNS hostname for libSQL and HTTP connections. */
+    hostname: string;
+    /** libSQL connection URL (`libsql://<hostname>`), for `@libsql/client`. */
+    url: string;
+    /** HTTPS URL (`https://<hostname>`) of the Hrana-over-HTTP endpoint. */
+    httpUrl: string;
+    /** Primary location of the database. */
+    primaryRegion: string;
+    /** Every location the database runs in. */
+    regions: string[];
+    /** Maximum database size, or `undefined` when unlimited. */
+    sizeLimit: string | undefined;
+    /** Whether other databases may be attached. */
+    allowAttach: boolean;
+    /** Whether reads are blocked. */
+    blockReads: boolean;
+    /** Whether writes are blocked. */
+    blockWrites: boolean;
+    /** Whether delete protection is enabled. */
+    deleteProtection: boolean;
+    /** IP addresses and CIDR blocks allowed to connect. */
+    allowedIps: string[];
+    /** AWS VPC endpoint IDs allowed to connect. */
+    allowedAwsVpcIds: string[];
+    /** Directory containing migration files, if configured. */
+    migrationsDir: string | undefined;
+    /** Table used to track applied migrations, if configured. */
+    migrationsTable: string | undefined;
+    /** Content hashes for the last applied migration files. */
+    migrationsHashes: Record<string, string>;
+    /** Content hashes for the last applied import files. */
+    importHashes: Record<string, string>;
+}
+export type Database = Resource<"Turso.Database", DatabaseProps, DatabaseAttributes, never, Providers>;
+/**
+ * A Turso database: a SQLite database that lives in a {@link Group}.
+ * Connect to it from a Worker or Lambda with {@link Connect}, or create a
+ * {@link DatabaseToken} for other apps.
+ * @see https://docs.turso.tech/concepts#databases
+ *
+ * ### Creating a Database
+ * **Example:** Database in a group
+ * ```typescript
+ * const group = yield* Turso.Group("Group", { location: "aws-us-east-1" });
+ * const db = yield* Turso.Database("Db", { group: group.name });
+ * ```
+ *
+ * **Example:** Database with delete protection and an IP allowlist
+ * ```typescript
+ * const db = yield* Turso.Database("Db", {
+ *   group: group.name,
+ *   deleteProtection: true,
+ *   allowedIps: ["203.0.113.0/24"],
+ * });
+ * ```
+ *
+ * ### Branching
+ * **Example:** Copy an existing database
+ * ```typescript
+ * const preview = yield* Turso.Database("Preview", {
+ *   group: group.name,
+ *   seed: { type: "database", name: db.name },
+ * });
+ * ```
+ *
+ * ### Migrations
+ * Point `migrations` at a folder of `.sql` files (or a `Drizzle.Schema`).
+ * Pending migrations are applied in order on each deploy.
+ *
+ * **Example:** Apply migrations from a directory
+ * ```typescript
+ * const db = yield* Turso.Database("Db", {
+ *   group: group.name,
+ *   migrations: "./migrations",
+ * });
+ * ```
+ *
+ * **Example:** Seed with SQL files
+ * ```typescript
+ * const db = yield* Turso.Database("Db", {
+ *   group: group.name,
+ *   importFiles: ["./seed/users.sql"],
+ * });
+ * ```
+ *
+ * ### Querying from a Worker
+ * **Example:** Drizzle over a Turso database
+ * ```typescript
+ * const conn = yield* Turso.Connect(Db);
+ * const db = yield* Drizzle.LibSQL(conn);
+ * ```
+ *
+ * @resource
+ * @product Database
+ */
+export declare const Database: import("alchemy/Resource").ResourceClass<Database>;
+export declare const DatabaseProvider: () => import("effect/Layer").Layer<Provider.Provider<Database>, never, import("effect/FileSystem").FileSystem | import("./Credentials.ts").Organization | import("effect/Path").Path | import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | turso.TursoOpContext>;
+//# sourceMappingURL=Database.d.ts.map

package/lib/Database.d.ts.map

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