alchemy 2.0.0-beta.5 → 2.0.0-beta.51

package/lib/Drizzle/Postgres.js

@@ -0,0 +1,51 @@
+import * as PgClient from "@effect/sql-pg/PgClient";
+import * as PgDrizzle from "drizzle-orm/effect-postgres";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { ExecutionContext } from "../ExecutionContext.js";
+import { proxyChain } from "../Util/proxy-chain.js";
+/**
+ * Open a Drizzle/Postgres database from a connection URL using the
+ * `drizzle-orm/effect-postgres` integration.
+ *
+ * Returns a chainable Proxy over `EffectPgDatabase` (via `proxyChain`) —
+ * every property read records a step, every call records args, and the
+ * chain is replayed against the resolved drizzle db when it's finally
+ * yielded as an Effect. Callers don't need a separate `yield* conn` step:
+ *
+ * ```typescript
+ * const db = yield* Drizzle.postgres(hd.connectionString);
+ *
+ * fetch: Effect.gen(function* () {
+ *   const rows = yield* db.select().from(users);
+ * });
+ * ```
+ *
+ * Behind the scenes the actual connect work is wrapped in `Effect.cached`,
+ * so the pool is built at most once per JS realm. Yielding the
+ * connection string is also deferred until first query, so deploy /
+ * plan-time invocations (where `WorkerEnvironment` isn't provided)
+ * never trigger a real connection attempt.
+ *
+ * The PgClient pool is built against an isolated, never-closing `Scope`
+ * so it outlives whatever scope this helper is yielded under. In a
+ * Cloudflare Worker the surrounding `Cloudflare.Worker` runs init
+ * inside `Effect.scoped`, which closes after returning the exports
+ * object — without an isolated scope, the pool's `end` finalizer
+ * would fire there and every subsequent request would see "Cannot
+ * use a pool after end".
+ *
+ * @binding
+ */
+export const postgres = (connectionString, config) => Effect.sync(function () {
+    const symbol = Symbol();
+    return proxyChain(Effect.gen(function* () {
+        const ctx = yield* ExecutionContext;
+        return yield* (ctx.cache[symbol] ??= yield* Effect.gen(function* () {
+            const pgCtx = yield* Layer.buildWithScope(PgClient.layer({ url: yield* connectionString }), ctx.scope);
+            return yield* PgDrizzle.makeWithDefaults(config).pipe(Effect.provideContext(pgCtx));
+        }).pipe(Effect.cached));
+    }));
+});
+//# sourceMappingURL=Postgres.js.map

package/lib/Drizzle/Postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Postgres.js","sourceRoot":"","sources":["../../src/Drizzle/Postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,SAAS,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAKtB,gBAAgE,EAChE,MAAoD,EACpD,EAAE,CACF,MAAM,CAAC,IAAI,CAAC;IACV,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,OAAO,UAAU,CAKf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC;QACpC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,cAAc,CACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,gBAAgB,EAAE,CAAC,EAChD,GAAG,CAAC,KAAK,CACV,CAAC;YACF,OAAO,KAAK,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CACnD,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAC7B,CAAC;QACJ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1B,CAAC,CAIA,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/lib/Drizzle/Providers.d.ts

@@ -0,0 +1,47 @@
+import * as Layer from "effect/Layer";
+import * as Provider from "../Provider.ts";
+declare const Providers_base: Provider.ProviderCollection<Providers, "Drizzle">;
+export declare class Providers extends Providers_base {
+}
+export type ProviderRequirements = Layer.Services<ReturnType<typeof providers>>;
+/**
+ * Build-time providers for managing Drizzle schemas as Alchemy resources.
+ * Drizzle.Schema regenerates migration SQL via drizzle-kit's programmatic
+ * API on every deploy when the source schema changes.
+ *
+ * @example
+ * ```typescript
+ * import * as Alchemy from "alchemy";
+ * import * as Cloudflare from "alchemy/Cloudflare";
+ * import * as Drizzle from "alchemy/Drizzle";
+ * import * as Neon from "alchemy/Neon";
+ * import * as Effect from "effect/Effect";
+ * import * as Layer from "effect/Layer";
+ *
+ * export default Alchemy.Stack(
+ *   "MyStack",
+ *   {
+ *     providers: Layer.mergeAll(
+ *       Cloudflare.providers(),
+ *       Drizzle.providers(),
+ *       Neon.providers(),
+ *     ),
+ *     state: Alchemy.localState(),
+ *   },
+ *   Effect.gen(function* () {
+ *     const schema = yield* Drizzle.Schema("app-schema", {
+ *       schema: "./src/schema.ts",
+ *     });
+ *     const project = yield* Neon.Project("app-db");
+ *     const branch = yield* Neon.Branch("app-branch", {
+ *       project,
+ *       migrationsDir: schema.out,
+ *     });
+ *     return { branchId: branch.branchId };
+ *   }),
+ * );
+ * ```
+ */
+export declare const providers: () => Layer.Layer<Providers, never, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+export {};
+//# sourceMappingURL=Providers.d.ts.map

package/lib/Drizzle/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../../src/Drizzle/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;;AAG3C,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,SAAS,0GAInB,CAAC"}

package/lib/Drizzle/Providers.js

@@ -0,0 +1,45 @@
+import * as Layer from "effect/Layer";
+import * as Provider from "../Provider.js";
+import { Schema, SchemaProvider } from "./Schema.js";
+export class Providers extends Provider.ProviderCollection()("Drizzle") {
+}
+/**
+ * Build-time providers for managing Drizzle schemas as Alchemy resources.
+ * Drizzle.Schema regenerates migration SQL via drizzle-kit's programmatic
+ * API on every deploy when the source schema changes.
+ *
+ * @example
+ * ```typescript
+ * import * as Alchemy from "alchemy";
+ * import * as Cloudflare from "alchemy/Cloudflare";
+ * import * as Drizzle from "alchemy/Drizzle";
+ * import * as Neon from "alchemy/Neon";
+ * import * as Effect from "effect/Effect";
+ * import * as Layer from "effect/Layer";
+ *
+ * export default Alchemy.Stack(
+ *   "MyStack",
+ *   {
+ *     providers: Layer.mergeAll(
+ *       Cloudflare.providers(),
+ *       Drizzle.providers(),
+ *       Neon.providers(),
+ *     ),
+ *     state: Alchemy.localState(),
+ *   },
+ *   Effect.gen(function* () {
+ *     const schema = yield* Drizzle.Schema("app-schema", {
+ *       schema: "./src/schema.ts",
+ *     });
+ *     const project = yield* Neon.Project("app-db");
+ *     const branch = yield* Neon.Branch("app-branch", {
+ *       project,
+ *       migrationsDir: schema.out,
+ *     });
+ *     return { branchId: branch.branchId };
+ *   }),
+ * );
+ * ```
+ */
+export const providers = () => Layer.effect(Providers, Provider.collection([Schema])).pipe(Layer.provide(SchemaProvider()), Layer.orDie);
+//# sourceMappingURL=Providers.js.map

package/lib/Drizzle/Providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../../src/Drizzle/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CACrE,SAAS,CACV;CAAG;AAIJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CACzD,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,EAC/B,KAAK,CAAC,KAAK,CACZ,CAAC"}

package/lib/Drizzle/Schema.d.ts

@@ -0,0 +1,77 @@
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import type { Providers } from "./Providers.ts";
+export type Dialect = "postgres" | "mysql" | "sqlite";
+export type SchemaProps = {
+    /**
+     * Path to the schema module, relative to the current working directory.
+     * The module is loaded via dynamic `import()` so drizzle-kit can introspect
+     * the table definitions, then diffed against the latest snapshot under
+     * `out` to detect changes.
+     *
+     * @example "./src/schema.ts"
+     */
+    schema: string;
+    /**
+     * Output directory for generated migrations. Each migration is written as
+     * `{out}/{timestamp}_migration/{migration.sql, snapshot.json}`. Pass this
+     * value through to `Neon.Branch`/`Cloudflare.D1Database` as `migrationsDir`
+     * to apply pending migrations on deploy.
+     *
+     * @default "./migrations"
+     */
+    out?: string;
+    /**
+     * SQL dialect to generate migrations for. Selects which `drizzle-kit/api-*`
+     * module is loaded.
+     *
+     * @default "postgres"
+     */
+    dialect?: Dialect;
+};
+export type Schema = Resource<"Drizzle.Schema", SchemaProps, {
+    /** Absolute path to the migrations directory. */
+    out: string;
+    /**
+     * sha256 of the latest snapshot.json. Stable across deploys when the
+     * schema is unchanged; bumps trigger an update which regenerates pending
+     * migration SQL. Downstream `migrationsDir` consumers read this to
+     * detect drift and reapply.
+     */
+    snapshotHash: string;
+    /** Names of all migration directories under `out`, in order. */
+    migrations: string[];
+}, never, Providers>;
+/**
+ * A Drizzle schema managed as an Alchemy resource.
+ *
+ * Wraps drizzle-kit's programmatic API (`generateDrizzleJson` /
+ * `generateMigration`) so migration SQL is regenerated as part of `alchemy
+ * deploy` whenever the source schema changes. The output directory is
+ * intended to be passed straight to a database resource's `migrationsDir`,
+ * giving you a single deploy-driven flow:
+ *
+ * ```typescript
+ * const schema = yield* Drizzle.Schema("app-schema", {
+ *   schema: "./src/schema.ts",
+ * });
+ *
+ * const branch = yield* Neon.Branch("app-branch", {
+ *   project,
+ *   migrationsDir: schema.out,
+ * });
+ * ```
+ *
+ * `Drizzle.Schema` runs first (because `Neon.Branch` depends on its `out`
+ * output), regenerates pending migration files, and `Neon.Branch` then
+ * applies them transactionally.
+ *
+ * The resource is delete-safe: removing it from the stack does **not** wipe
+ * the migrations directory, since migration files are typically checked in
+ * and shared with other environments.
+ */
+export declare const Schema: import("../Resource.ts").ResourceClass<Schema>;
+export declare const SchemaProvider: () => import("effect/Layer").Layer<Provider.Provider<Schema>, never, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=Schema.d.ts.map

package/lib/Drizzle/Schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/Drizzle/Schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAMtD,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,QAAQ,CAC3B,gBAAgB,EAChB,WAAW,EACX;IACE,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,EACD,KAAK,EACL,SAAS,CACV,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,MAAM,gDAAqC,CAAC;AAkBzD,eAAO,MAAM,cAAc,yGAiLxB,CAAC"}

package/lib/Drizzle/Schema.js

@@ -0,0 +1,187 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import * as crypto from "node:crypto";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+/**
+ * A Drizzle schema managed as an Alchemy resource.
+ *
+ * Wraps drizzle-kit's programmatic API (`generateDrizzleJson` /
+ * `generateMigration`) so migration SQL is regenerated as part of `alchemy
+ * deploy` whenever the source schema changes. The output directory is
+ * intended to be passed straight to a database resource's `migrationsDir`,
+ * giving you a single deploy-driven flow:
+ *
+ * ```typescript
+ * const schema = yield* Drizzle.Schema("app-schema", {
+ *   schema: "./src/schema.ts",
+ * });
+ *
+ * const branch = yield* Neon.Branch("app-branch", {
+ *   project,
+ *   migrationsDir: schema.out,
+ * });
+ * ```
+ *
+ * `Drizzle.Schema` runs first (because `Neon.Branch` depends on its `out`
+ * output), regenerates pending migration files, and `Neon.Branch` then
+ * applies them transactionally.
+ *
+ * The resource is delete-safe: removing it from the stack does **not** wipe
+ * the migrations directory, since migration files are typically checked in
+ * and shared with other environments.
+ */
+export const Schema = Resource("Drizzle.Schema");
+const dialectModule = (dialect) => {
+    switch (dialect) {
+        case "postgres":
+            return "drizzle-kit/api-postgres";
+        case "mysql":
+            return "drizzle-kit/api-mysql";
+        case "sqlite":
+            return "drizzle-kit/api-sqlite";
+    }
+};
+const sha = (s) => crypto.createHash("sha256").update(s).digest("hex");
+const tsStamp = () => new Date().toISOString().replace(/[-:T]/g, "").slice(0, 14);
+export const SchemaProvider = () => Provider.effect(Schema, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const resolveOut = (p) => path.resolve(process.cwd(), p.out ?? "./migrations");
+    const resolveSchema = (p) => path.resolve(process.cwd(), p.schema);
+    const loadSchemaModule = (p) => Effect.tryPromise({
+        try: () => import(__rewriteRelativeImportExtension(/* @vite-ignore */ resolveSchema(p))),
+        catch: (cause) => new Error(`Failed to import schema at ${p.schema}: ${cause}`),
+    });
+    const loadKit = (dialect) => Effect.tryPromise({
+        try: () => import(__rewriteRelativeImportExtension(/* @vite-ignore */ dialectModule(dialect))),
+        catch: (cause) => new Error(`Failed to load drizzle-kit/${dialect} (is drizzle-kit installed?): ${cause}`),
+    });
+    // List `<ts>_*` migration directories under `out`, sorted by numeric
+    // prefix. Returns an empty array if `out` doesn't exist.
+    const listMigrationDirs = (out) => Effect.gen(function* () {
+        const exists = yield* fs.exists(out);
+        if (!exists)
+            return [];
+        const entries = yield* fs.readDirectory(out);
+        return entries.filter((name) => /^\d+_/.test(name)).sort();
+    });
+    const readLatestSnapshot = (out) => Effect.gen(function* () {
+        const dirs = yield* listMigrationDirs(out);
+        for (const dir of [...dirs].reverse()) {
+            const snapshotPath = path.join(out, dir, "snapshot.json");
+            const exists = yield* fs.exists(snapshotPath);
+            if (!exists)
+                continue;
+            const text = yield* fs.readFileString(snapshotPath);
+            return {
+                snapshot: JSON.parse(text),
+                hash: sha(text),
+            };
+        }
+        return undefined;
+    });
+    /**
+     * Run drizzle-kit's diff against the latest stored snapshot and
+     * return whether any SQL statements would be emitted. Used by both
+     * `diff` (to decide whether the resource actually needs an update)
+     * and `regenerate` (to decide whether to write a new migration dir).
+     */
+    const detectDrift = (props) => Effect.gen(function* () {
+        const out = resolveOut(props);
+        const dialect = props.dialect ?? "postgres";
+        const kit = yield* loadKit(dialect);
+        const schemaModule = yield* loadSchemaModule(props);
+        const prevEntry = yield* readLatestSnapshot(out);
+        const cur = yield* Effect.tryPromise({
+            try: () => kit.generateDrizzleJson(schemaModule, prevEntry?.snapshot.id),
+            catch: (cause) => new Error(`drizzle-kit generateDrizzleJson failed: ${cause}`),
+        });
+        // For the initial migration, drizzle-kit needs an *empty* snapshot
+        // produced by `generateDrizzleJson({})`, not a bare `{}` — the
+        // snapshot has internal fields (`ddl`, etc.) that the differ reads.
+        const prev = prevEntry?.snapshot ??
+            (yield* Effect.tryPromise({
+                try: () => kit.generateDrizzleJson({}),
+                catch: (cause) => new Error(`drizzle-kit generateDrizzleJson (empty baseline) failed: ${cause}`),
+            }));
+        const sqlStatements = yield* Effect.tryPromise({
+            try: () => kit.generateMigration(prev, cur),
+            catch: (cause) => new Error(`drizzle-kit generateMigration failed: ${cause}`),
+        });
+        return { out, cur, prevEntry, sqlStatements };
+    });
+    /**
+     * Generate a new migration directory if the schema has drifted from
+     * the latest snapshot. Returns the new state regardless.
+     */
+    const regenerate = (props) => Effect.gen(function* () {
+        const { out, cur, sqlStatements } = yield* detectDrift(props);
+        if (sqlStatements.length > 0) {
+            yield* fs.makeDirectory(out, { recursive: true });
+            const dirName = `${tsStamp()}_migration`;
+            const dirPath = path.join(out, dirName);
+            yield* fs.makeDirectory(dirPath, { recursive: true });
+            const sql = sqlStatements.join("\n--> statement-breakpoint\n") + "\n";
+            yield* fs.writeFileString(path.join(dirPath, "migration.sql"), sql);
+            yield* fs.writeFileString(path.join(dirPath, "snapshot.json"), JSON.stringify(cur, null, 2));
+        }
+        const migrations = yield* listMigrationDirs(out);
+        const latest = yield* readLatestSnapshot(out);
+        return {
+            out,
+            snapshotHash: latest?.hash ?? sha(JSON.stringify(cur)),
+            migrations,
+        };
+    });
+    return {
+        diff: Effect.fn(function* ({ news, output }) {
+            if (!isResolved(news))
+                return undefined;
+            if (!output)
+                return undefined;
+            // Only flag an update when drizzle-kit would emit new SQL —
+            // otherwise downstream resources (e.g. Neon.Branch) would see
+            // `schema.out` as an unresolved Output during plan and cascade
+            // into spurious updates of their own.
+            const { sqlStatements } = yield* detectDrift(news);
+            if (sqlStatements.length === 0)
+                return undefined;
+            return { action: "update" };
+        }),
+        read: Effect.fn(function* ({ olds, output }) {
+            if (!output)
+                return undefined;
+            const out = resolveOut(olds ?? {});
+            const exists = yield* fs.exists(out);
+            if (!exists)
+                return undefined;
+            const latest = yield* readLatestSnapshot(out);
+            const migrations = yield* listMigrationDirs(out);
+            return {
+                out,
+                snapshotHash: latest?.hash ?? output.snapshotHash,
+                migrations,
+            };
+        }),
+        reconcile: Effect.fn(function* ({ news, output, session }) {
+            yield* session.note(`${output ? "Regenerating" : "Generating"} drizzle migrations for ${news.schema}`);
+            return yield* regenerate(news);
+        }),
+        delete: Effect.fn(function* () {
+            // Migrations are typically checked in; do not delete on resource
+            // teardown.
+        }),
+    };
+}));
+//# sourceMappingURL=Schema.js.map

package/lib/Drizzle/Schema.js.map

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

package/lib/Drizzle/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./Postgres.ts";
+export * from "./Providers.ts";
+export * from "./Schema.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/Drizzle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Drizzle/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/lib/Drizzle/index.js

@@ -0,0 +1,4 @@
+export * from "./Postgres.js";
+export * from "./Providers.js";
+export * from "./Schema.js";
+//# sourceMappingURL=index.js.map

package/lib/Drizzle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Drizzle/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/lib/ExecutionContext.d.ts

@@ -0,0 +1,18 @@
+import * as Context from "effect/Context";
+import type { Scope } from "effect/Scope";
+declare const ExecutionContext_base: Context.ServiceClass<ExecutionContext, "ExecutionContext", {
+    scope: Scope;
+    cache: {
+        [key: symbol | string]: any;
+    };
+}>;
+/**
+ * The context of an execution in the runtime.
+ *
+ * E.g. the context of a request/event being handled in a Worker or Lambda Function.
+ * E.g. in a serverful environment, it has the lifetime of the whole runtime.
+ */
+export declare class ExecutionContext extends ExecutionContext_base {
+}
+export {};
+//# sourceMappingURL=ExecutionContext.d.ts.map

package/lib/ExecutionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionContext.d.ts","sourceRoot":"","sources":["../src/ExecutionContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;;WAW/B,KAAK;WACL;QACL,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;KAC7B;;AAZL;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,qBAQf;CAAG"}

package/lib/ExecutionContext.js

@@ -0,0 +1,10 @@
+import * as Context from "effect/Context";
+/**
+ * The context of an execution in the runtime.
+ *
+ * E.g. the context of a request/event being handled in a Worker or Lambda Function.
+ * E.g. in a serverful environment, it has the lifetime of the whole runtime.
+ */
+export class ExecutionContext extends Context.Service()("ExecutionContext") {
+}
+//# sourceMappingURL=ExecutionContext.js.map

package/lib/ExecutionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionContext.js","sourceRoot":"","sources":["../src/ExecutionContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAG1C;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,OAAO,CAAC,OAAO,EAQlD,CAAC,kBAAkB,CAAC;CAAG"}

package/lib/FQN.d.ts

@@ -0,0 +1,60 @@
+import type { NamespaceNode } from "./Namespace.ts";
+/**
+ * Separator used in FQN strings.
+ */
+export declare const FQN_SEPARATOR = "/";
+/**
+ * Encode an FQN for safe filesystem storage.
+ * Replaces `/` (FQN separator) with `__` to avoid subdirectory creation.
+ */
+export declare const encodeFqn: (fqn: string) => string;
+/**
+ * Decode a filename back to FQN.
+ */
+export declare const decodeFqn: (filename: string) => string;
+/**
+ * Convert a NamespaceNode chain to an array of namespace IDs, from root to leaf.
+ *
+ * @example
+ * ```ts
+ * const ns = { Id: "Child", Parent: { Id: "Parent", Parent: { Id: "Root" } } };
+ * toPath(ns); // ["Root", "Parent", "Child"]
+ * ```
+ */
+export declare const toPath: (ns: NamespaceNode | undefined) => string[];
+/**
+ * Create a fully-qualified name (FQN) from a namespace and logical ID.
+ * The FQN is a flat key suitable for state storage.
+ *
+ * @example
+ * ```ts
+ * const ns = { Id: "Child", Parent: { Id: "Parent" } };
+ * toFqn(ns, "MyResource"); // "Parent/Child/MyResource"
+ * toFqn(undefined, "MyResource"); // "MyResource"
+ * ```
+ */
+export declare const toFqn: (ns: NamespaceNode | undefined, logicalId: string) => string;
+/**
+ * Parse an FQN back into namespace path segments and the logical ID.
+ *
+ * @example
+ * ```ts
+ * parseFqn("Parent/Child/MyResource"); // { path: ["Parent", "Child"], logicalId: "MyResource" }
+ * parseFqn("MyResource"); // { path: [], logicalId: "MyResource" }
+ * ```
+ */
+export declare const parseFqn: (fqn: string) => {
+    path: string[];
+    logicalId: string;
+};
+/**
+ * Reconstruct a NamespaceNode chain from a path array.
+ *
+ * @example
+ * ```ts
+ * fromPath(["Parent", "Child"]);
+ * // { Id: "Child", Parent: { Id: "Parent" } }
+ * ```
+ */
+export declare const fromPath: (path: string[]) => NamespaceNode | undefined;
+//# sourceMappingURL=FQN.d.ts.map

package/lib/FQN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FQN.d.ts","sourceRoot":"","sources":["../src/FQN.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,MACH,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,KAAG,MACH,CAAC;AAE3C;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,aAAa,GAAG,SAAS,KAAG,MAAM,EAS5D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAChB,IAAI,aAAa,GAAG,SAAS,EAC7B,WAAW,MAAM,KAChB,MAIF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GACnB,KAAK,MAAM,KACV;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAIrC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,KAAG,aAAa,GAAG,SAOzD,CAAC"}

package/lib/FQN.js

@@ -0,0 +1,82 @@
+/**
+ * Separator used in FQN strings.
+ */
+export const FQN_SEPARATOR = "/";
+/**
+ * Encode an FQN for safe filesystem storage.
+ * Replaces `/` (FQN separator) with `__` to avoid subdirectory creation.
+ */
+export const encodeFqn = (fqn) => fqn.replaceAll(FQN_SEPARATOR, "__");
+/**
+ * Decode a filename back to FQN.
+ */
+export const decodeFqn = (filename) => filename.replaceAll("__", FQN_SEPARATOR);
+/**
+ * Convert a NamespaceNode chain to an array of namespace IDs, from root to leaf.
+ *
+ * @example
+ * ```ts
+ * const ns = { Id: "Child", Parent: { Id: "Parent", Parent: { Id: "Root" } } };
+ * toPath(ns); // ["Root", "Parent", "Child"]
+ * ```
+ */
+export const toPath = (ns) => {
+    if (!ns)
+        return [];
+    const path = [];
+    let current = ns;
+    while (current) {
+        path.unshift(current.Id);
+        current = current.Parent;
+    }
+    return path;
+};
+/**
+ * Create a fully-qualified name (FQN) from a namespace and logical ID.
+ * The FQN is a flat key suitable for state storage.
+ *
+ * @example
+ * ```ts
+ * const ns = { Id: "Child", Parent: { Id: "Parent" } };
+ * toFqn(ns, "MyResource"); // "Parent/Child/MyResource"
+ * toFqn(undefined, "MyResource"); // "MyResource"
+ * ```
+ */
+export const toFqn = (ns, logicalId) => {
+    const path = toPath(ns);
+    path.push(logicalId);
+    return path.join(FQN_SEPARATOR);
+};
+/**
+ * Parse an FQN back into namespace path segments and the logical ID.
+ *
+ * @example
+ * ```ts
+ * parseFqn("Parent/Child/MyResource"); // { path: ["Parent", "Child"], logicalId: "MyResource" }
+ * parseFqn("MyResource"); // { path: [], logicalId: "MyResource" }
+ * ```
+ */
+export const parseFqn = (fqn) => {
+    const parts = fqn.split(FQN_SEPARATOR);
+    const logicalId = parts.pop();
+    return { path: parts, logicalId };
+};
+/**
+ * Reconstruct a NamespaceNode chain from a path array.
+ *
+ * @example
+ * ```ts
+ * fromPath(["Parent", "Child"]);
+ * // { Id: "Child", Parent: { Id: "Parent" } }
+ * ```
+ */
+export const fromPath = (path) => {
+    if (path.length === 0)
+        return undefined;
+    let node;
+    for (const id of path) {
+        node = { Id: id, Parent: node };
+    }
+    return node;
+};
+//# sourceMappingURL=FQN.js.map

package/lib/FQN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FQN.js","sourceRoot":"","sources":["../src/FQN.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAC/C,GAAG,CAAC,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAU,EAAE,CACpD,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAA6B,EAAY,EAAE;IAChE,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,OAAO,GAA8B,EAAE,CAAC;IAC5C,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,EAA6B,EAC7B,SAAiB,EACT,EAAE;IACV,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,GAAW,EAC4B,EAAE;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;IAC/B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAc,EAA6B,EAAE;IACpE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,IAA+B,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}