@rc312/effect-snowflake 0.0.0-stage → 0.2.0

package/dist/internal/connection.d.ts

@@ -0,0 +1,25 @@
+import type { Scope } from "effect";
+import { Effect } from "effect";
+import { AdbcDriver } from "../adbc-driver.ts";
+import type { Connection as NativeConnection } from "../adbc-driver.ts";
+import type { SnowflakeOptions } from "../models.ts";
+import type { SnowflakeError } from "../snowflake-error.ts";
+/** One native connection and the lifetime shared by all of its sessions. */
+export interface Connection {
+    readonly native: NativeConnection;
+    readonly owner: Scope.Scope;
+    readonly isOpen: () => boolean;
+    readonly isHealthy: () => boolean;
+    readonly cleanup: <A>(operation: string, run: () => Promise<A>) => Effect.Effect<A>;
+    readonly setAutoCommit: (enabled: boolean) => Effect.Effect<void, SnowflakeError>;
+}
+/** Called inside the client's private sequential scope. Dependencies are captured once. */
+export declare const make: (options: SnowflakeOptions) => Effect.Effect<{
+    cleanup: <A>(operation: string, run: () => Promise<A>) => Effect.Effect<A>;
+    isHealthy: () => boolean;
+    isOpen: () => boolean;
+    native: NativeConnection;
+    owner: Scope.Scope;
+    setAutoCommit: (enabled: boolean) => Effect.Effect<void, SnowflakeError, never>;
+}, SnowflakeError, AdbcDriver | Scope.Scope>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/internal/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/internal/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,MAAM,EAAQ,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAClB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,CACtB,OAAO,EAAE,OAAO,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED,2FAA2F;AAC3F,eAAO,MAAM,IAAI;cAVI,CAAC,aACP,MAAM,OACZ,MAAM,OAAO,CAAC,CAAC,CAAC,KAClB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;;;;;6BAuDM,OAAO;4CAMlC,CAAC"}

package/dist/internal/connection.js

@@ -0,0 +1,39 @@
+import { Effect, flow } from "effect";
+import { AdbcDriver } from "../adbc-driver.js";
+import { failure } from "../snowflake-error.js";
+import { configuration } from "./configuration.js";
+import { asCleanup } from "./lifecycle.js";
+import { call } from "./native.js";
+/** Called inside the client's private sequential scope. Dependencies are captured once. */
+export const make = Effect.fnUntraced(function* acquireConnection(options) {
+    const driver = yield* AdbcDriver;
+    const owner = yield* Effect.scope;
+    const config = yield* Effect.try({
+        catch: failure("options"),
+        try: () => configuration(options),
+    });
+    let open = true;
+    let healthy = true;
+    const invalidate = Effect.sync(() => {
+        healthy = false;
+    });
+    const finalize = flow(Effect.tapError(() => invalidate), asCleanup);
+    const cleanup = (operation, run) => call(operation, run).pipe(finalize);
+    const database = yield* Effect.acquireRelease(driver.open(config), (resource) => cleanup("database.close", () => resource.close()));
+    const native = yield* Effect.acquireRelease(call("connect", () => database.connect()), (resource) => cleanup("connection.close", () => resource.close()));
+    yield* Effect.addFinalizer(() => Effect.sync(() => {
+        open = false;
+    }));
+    return {
+        cleanup,
+        isHealthy: () => healthy,
+        isOpen: () => open && healthy,
+        native,
+        owner,
+        setAutoCommit: (enabled) => Effect.try({
+            catch: failure("transaction.autocommit"),
+            try: () => native.setAutoCommit(enabled),
+        }).pipe(Effect.tapError(() => invalidate)),
+    };
+});
+//# sourceMappingURL=connection.js.map

package/dist/internal/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/internal/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAiBnC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAC/D,OAAyB;IAEzB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAElC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/B,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC;QACzB,GAAG,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC;KAClC,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QAClC,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,CACnB,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EACjC,SAAS,CACV,CAAC;IAEF,MAAM,OAAO,GAA0B,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CACxD,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CAC3C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EACnB,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAChE,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CACzC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,EACzC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAClE,CAAC;IAEF,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,IAAI,GAAG,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;IAEF,OAAO;QACL,OAAO;QACP,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO;QACxB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,OAAO;QAC7B,MAAM;QACN,KAAK;QACL,aAAa,EAAE,CAAC,OAAgB,EAAE,EAAE,CAClC,MAAM,CAAC,GAAG,CAAC;YACT,KAAK,EAAE,OAAO,CAAC,wBAAwB,CAAC;YACxC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;SACzC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;KACxB,CAAC;AACzB,CAAC,CAAC,CAAC"}

package/dist/internal/lifecycle.d.ts

@@ -0,0 +1,9 @@
+import type { RecordBatch } from "apache-arrow";
+import { Effect, Scope, Stream } from "effect";
+import type { SnowflakeError } from "../snowflake-error.ts";
+export declare const asCleanup: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, never, R>;
+export declare const owned: <A, E, R>(effect: Effect.Effect<A, E, R>, scope: Scope.Scope, isOpen: () => boolean) => Effect.Effect<A, E | SnowflakeError, R>;
+export declare const ownedStream: (stream: Stream.Stream<RecordBatch, SnowflakeError>, owner: Scope.Scope, isOpen: () => boolean) => Stream.Stream<RecordBatch<any>, SnowflakeError, never>;
+/** Join interrupted acquisition before releasing its late native resources. */
+export declare const acquireOwner: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E | SnowflakeError, Scope.Scope | Exclude<R, Scope.Scope>>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/internal/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/internal/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAS,MAAM,EAAe,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAY5D,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,+BACY,CAAC;AAiE9E,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,UACnB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,SACvB,KAAK,CAAC,KAAK,UACV,MAAM,OAAO,KACpB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,CAStC,CAAC;AAmEJ,eAAO,MAAM,WAAW,WACd,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,SAC3C,KAAK,CAAC,KAAK,UACV,MAAM,OAAO,2DACsC,CAAC;AAE9D,+EAA+E;AAC/E,eAAO,MAAM,YAAY,GACvB,CAAC,EACD,CAAC,EACD,CAAC,8GAaD,CAAC"}

package/dist/internal/lifecycle.js

@@ -0,0 +1,81 @@
+import { Cause, Effect, Exit, Fiber, Scope, Stream } from "effect";
+import { failure } from "../snowflake-error.js";
+const cleanupReason = (reason) => Cause.isFailReason(reason)
+    ? Cause.makeDieReason(reason.error).annotate(Cause.reasonAnnotations(reason))
+    : reason;
+const cleanupCause = (cause) => Cause.fromReasons(cause.reasons.map(cleanupReason));
+export const asCleanup = (effect) => Effect.catchCause(effect, (cause) => Effect.failCause(cleanupCause(cause)));
+const cleanupExit = (exit) => {
+    if (Exit.isFailure(exit)) {
+        const reasons = exit.cause.reasons.filter((reason) => !Cause.isInterruptReason(reason));
+        if (reasons.length > 0) {
+            return Effect.failCause(Cause.fromReasons(reasons)).pipe(asCleanup);
+        }
+    }
+    return Effect.void;
+};
+const observeCleanup = (fiber) => Fiber.await(fiber).pipe(Effect.flatMap(cleanupExit));
+const stopOperation = Effect.fnUntraced(function* stopOwnedOperation(fiber) {
+    if (fiber.pollUnsafe() !== undefined) {
+        return;
+    }
+    yield* Fiber.interrupt(fiber);
+    yield* observeCleanup(fiber);
+});
+const acquireOperation = Effect.fnUntraced(function* acquireOwnedOperation(effect, scope) {
+    const lifetime = yield* Scope.fork(scope, "sequential");
+    const fiber = yield* Effect.forkIn(Effect.interruptible(effect), lifetime);
+    // forkIn joins on closure but discards the exit; observe cleanup failures too.
+    const stop = yield* stopOperation(fiber).pipe(Effect.cached);
+    yield* Scope.addFinalizer(lifetime, stop);
+    return { fiber, lifetime, stop };
+});
+const releaseOperation = ({ fiber, lifetime, stop }, exit) => stop.pipe(Effect.andThen(Exit.isFailure(exit) && Cause.hasInterruptsOnly(exit.cause)
+    ? observeCleanup(fiber)
+    : Effect.void), Effect.ensuring(Scope.close(lifetime, exit)));
+// Each operation belongs to both its caller and its client/session Scope. Closing
+// either interrupts AND joins it before the ADBC connection can be destroyed.
+export const owned = (effect, scope, isOpen) => Effect.suspend(() => isOpen()
+    ? Effect.acquireUseRelease(acquireOperation(effect, scope), ({ fiber }) => Fiber.join(fiber), releaseOperation)
+    : Effect.fail(failure("closed")()));
+// Finalizers and concurrent callers must join the same teardown. Scope.close
+// marks a scope closed before its finalizers settle, so it cannot provide this
+// join by itself. Keep the parent registration attached until teardown finishes.
+const makeLifetime = Effect.fnUntraced(function* makeOwnedLifetime(owner) {
+    const registration = yield* Scope.fork(owner, "sequential");
+    const scope = yield* Scope.make("sequential");
+    // Native resources must finalize after any fiber that can acquire or use them.
+    const resources = yield* Scope.fork(scope, "sequential");
+    let firstExit;
+    let retired = false;
+    let open = true;
+    const retire = Effect.suspend(() => {
+        retired = true;
+        return Scope.close(registration, firstExit ?? Exit.void);
+    });
+    const teardown = yield* Effect.suspend(() => {
+        open = false;
+        return Scope.close(scope, firstExit ?? Exit.void);
+    }).pipe(Effect.ensuring(retire), Effect.uninterruptible, Effect.cached);
+    const close = (exit) => Effect.suspend(() => {
+        firstExit ??= exit;
+        return teardown;
+    });
+    yield* Scope.addFinalizerExit(registration, (exit) => retired ? Effect.void : close(exit));
+    return { close, isOpen: () => open, resources, scope };
+});
+const acquireOwnedStream = Effect.fnUntraced(function* acquireStreamLifetime(stream, owner, isOpen) {
+    if (!isOpen()) {
+        return yield* failure("closed")();
+    }
+    const lifetime = yield* Effect.acquireRelease(makeLifetime(owner), (resource, exit) => resource.close(exit));
+    const active = () => lifetime.isOpen() && isOpen();
+    const pull = yield* owned(Stream.toPull(stream).pipe(Scope.provide(lifetime.resources)), lifetime.scope, active);
+    return Stream.fromPull(Effect.succeed(owned(pull, lifetime.scope, active)));
+});
+export const ownedStream = (stream, owner, isOpen) => Stream.unwrap(acquireOwnedStream(stream, owner, isOpen));
+/** Join interrupted acquisition before releasing its late native resources. */
+export const acquireOwner = Effect.fnUntraced(function* acquireClientOwner(self) {
+    return yield* Effect.acquireUseRelease(makeLifetime(yield* Effect.scope), (lifetime) => owned(self.pipe(Scope.provide(lifetime.resources)), lifetime.scope, lifetime.isOpen), (lifetime, exit) => Exit.isFailure(exit) ? lifetime.close(exit) : Effect.void);
+});
+//# sourceMappingURL=lifecycle.js.map

package/dist/internal/lifecycle.js.map

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

package/dist/internal/native.d.ts

@@ -0,0 +1,4 @@
+import { Effect } from "effect";
+/** ADBC JS cannot cancel promises; settle before releasing or reusing resources. */
+export declare const call: <A>(operation: string, run: () => Promise<A>) => Effect.Effect<A, import("../snowflake-error.ts").SnowflakeError, never>;
+//# sourceMappingURL=native.d.ts.map

package/dist/internal/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/internal/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,oFAAoF;AACpF,eAAO,MAAM,IAAI,GAAI,CAAC,aAAa,MAAM,OAAO,MAAM,OAAO,CAAC,CAAC,CAAC,4EAG7D,CAAC"}

package/dist/internal/native.js

@@ -0,0 +1,5 @@
+import { Effect } from "effect";
+import { failure } from "../snowflake-error.js";
+/** ADBC JS cannot cancel promises; settle before releasing or reusing resources. */
+export const call = (operation, run) => Effect.tryPromise({ catch: failure(operation), try: run }).pipe(Effect.uninterruptible);
+//# sourceMappingURL=native.js.map

package/dist/internal/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../src/internal/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,oFAAoF;AACpF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAI,SAAiB,EAAE,GAAqB,EAAE,EAAE,CAClE,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAC7D,MAAM,CAAC,eAAe,CACvB,CAAC"}

package/dist/internal/session.d.ts

@@ -0,0 +1,6 @@
+import type { Scope, Semaphore } from "effect";
+import type { SnowflakeSession } from "../models.ts";
+import type { Connection } from "./connection.ts";
+/** Build session operations over a captured connection, permit, and owning scope. */
+export declare const make: (connection: Connection, owner: Scope.Scope, mutex: Semaphore.Semaphore, active: () => boolean) => SnowflakeSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/internal/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/internal/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAkClD,qFAAqF;AACrF,eAAO,MAAM,IAAI,eACH,UAAU,SACf,KAAK,CAAC,KAAK,SACX,SAAS,CAAC,SAAS,UAClB,MAAM,OAAO,KACpB,gBA8DF,CAAC"}

package/dist/internal/session.js

@@ -0,0 +1,46 @@
+import { Table } from "apache-arrow";
+import { Cause, Effect, flow, pipe, Stream } from "effect";
+import { failure } from "../snowflake-error.js";
+import { owned, ownedStream } from "./lifecycle.js";
+import { call } from "./native.js";
+const executeStatement = (statement) => call("execute", () => statement.executeUpdate());
+const collectBatches = (source) => call("query.read", async () => {
+    await source.open();
+    const { schema } = source;
+    const batches = [];
+    for await (const batch of source) {
+        batches.push(batch);
+    }
+    return new Table(schema, batches);
+});
+// fromAsyncIterable installs an unsanitized iterator.return finalizer. The scoped
+// reader.cancel owns cleanup; this pull only reads on downstream demand.
+const streamBatches = (source) => pipe(call("stream.read", () => Promise.resolve(source.next())), Effect.flatMap((result) => result.done ? Cause.done() : Effect.succeed([result.value])), Effect.succeed, Stream.fromPull);
+/** Build session operations over a captured connection, permit, and owning scope. */
+export const make = (connection, owner, mutex, active) => {
+    const statement = Effect.fnUntraced(function* acquireStatement(sql, parameters) {
+        if (!active()) {
+            return yield* failure("closed")();
+        }
+        const resource = yield* Effect.acquireRelease(call("statement.create", () => connection.native.createStatement()), (value) => connection.cleanup("statement.close", () => value.close()));
+        yield* call("statement.sql", () => resource.setSqlQuery(sql));
+        if (parameters !== undefined) {
+            yield* call("statement.bind", () => resource.bind(parameters));
+        }
+        return resource;
+    });
+    const reader = Effect.fnUntraced(function* acquireReader(sql, parameters) {
+        const resource = yield* statement(sql, parameters);
+        return yield* Effect.acquireRelease(call("query", () => resource.executeQuery()), (value) => connection.cleanup("reader.close", async () => {
+            await value.cancel();
+        }));
+    });
+    const run = (effect) => pipe(effect, Effect.scoped, mutex.withPermit, (self) => owned(self, owner, active));
+    const permit = Effect.acquireRelease(mutex.take(1), () => mutex.release(1));
+    return {
+        execute: Effect.fn("Snowflake.execute")(flow(statement, Effect.flatMap(executeStatement), run)),
+        query: Effect.fn("Snowflake.query")(flow(reader, Effect.flatMap(collectBatches), run)),
+        stream: (sql, parameters) => pipe(permit, Effect.andThen(reader(sql, parameters)), Effect.map(streamBatches), Stream.unwrap, (self) => ownedStream(self, owner, active), Stream.withSpan("Snowflake.stream")),
+    };
+};
+//# sourceMappingURL=session.js.map

package/dist/internal/session.js.map

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

package/dist/internal/transaction.d.ts

@@ -0,0 +1,6 @@
+import { Semaphore } from "effect";
+import type { SnowflakeClient } from "../models.ts";
+import type { Connection } from "./connection.ts";
+/** Serialize the whole transaction and finish native finalization before interruption. */
+export declare const make: (connection: Connection, mutex: Semaphore.Semaphore) => SnowflakeClient["transaction"];
+//# sourceMappingURL=transaction.d.ts.map

package/dist/internal/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/internal/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA0BlD,0FAA0F;AAC1F,eAAO,MAAM,IAAI,eACH,UAAU,SACf,SAAS,CAAC,SAAS,KACzB,eAAe,CAAC,aAAa,CAqD/B,CAAC"}

package/dist/internal/transaction.js

@@ -0,0 +1,38 @@
+import { Effect, Exit, Semaphore } from "effect";
+import { failure } from "../snowflake-error.js";
+import { asCleanup, owned } from "./lifecycle.js";
+import { call } from "./native.js";
+import * as Session from "./session.js";
+/** The callback owns its session; closing its scope expires escaped operations. */
+const acquireSession = Effect.fnUntraced(function* acquireTransactionSession(connection) {
+    let active = true;
+    const owner = yield* Effect.scope;
+    yield* Effect.addFinalizer(() => Effect.sync(() => {
+        active = false;
+    }));
+    const lock = yield* Semaphore.make(1);
+    return Session.make(connection, owner, lock, () => active && connection.isOpen());
+});
+/** Serialize the whole transaction and finish native finalization before interruption. */
+export const make = (connection, mutex) => {
+    const begin = Effect.suspend(() => connection.isOpen()
+        ? connection.setAutoCommit(false)
+        : Effect.fail(failure("closed")()));
+    const commit = Effect.suspend(() => connection.isHealthy()
+        ? call("transaction.commit", () => connection.native.commit())
+        : Effect.fail(failure("transaction.invalidated")()));
+    const rollback = connection.cleanup("transaction.rollback", () => connection.native.rollback());
+    const restoreAutoCommit = Effect.suspend(() => connection.isHealthy()
+        ? connection.setAutoCommit(true).pipe(asCleanup)
+        : Effect.void);
+    const rollbackOnFailure = (exit) => Exit.isFailure(exit) ? rollback : Effect.void;
+    const complete = (self) => self.pipe(Effect.tap(() => commit), Effect.onExit((exit) => rollbackOnFailure(exit)), Effect.ensuring(restoreAutoCommit));
+    const runBody = (use) => acquireSession(connection).pipe(Effect.flatMap(use), Effect.scoped);
+    const transact = (use) => Effect.uninterruptibleMask((restore) => {
+        // Only the callback is interruptible; its scope closes before commit.
+        const body = restore(runBody(use));
+        return begin.pipe(Effect.andThen(complete(body)));
+    });
+    return Effect.fn("Snowflake.transaction")((use) => transact(use).pipe(mutex.withPermit, (self) => owned(self, connection.owner, connection.isOpen)));
+};
+//# sourceMappingURL=transaction.js.map

package/dist/internal/transaction.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,99 @@
+import type { RecordBatch, Table } from "apache-arrow";
+import type { Effect, Redacted, Stream } from "effect";
+import type { SnowflakeError } from "./snowflake-error.ts";
+/**
+ * Snowflake ADBC connection settings. Named fields override `databaseOptions`.
+ * Credentials are revealed only while constructing the native database options.
+ * @since 0.1.0
+ */
+export interface SnowflakeOptions {
+    /** Snowflake account identifier, for example `myorg-myaccount`. */
+    readonly account: string;
+    /** Login user. Some native authentication methods obtain identity elsewhere. */
+    readonly username?: string;
+    /** Login password, wrapped in `Redacted`. */
+    readonly password?: Redacted.Redacted<string>;
+    /** Default database for unqualified SQL names. */
+    readonly database?: string;
+    /** Default schema within the selected database. */
+    readonly schema?: string;
+    /** Compute warehouse used to execute queries. */
+    readonly warehouse?: string;
+    /** Snowflake role to activate for the session. */
+    readonly role?: string;
+    /** ADBC authentication name; the driver defaults to `auth_snowflake`. These differ from SDK authenticator names. */
+    readonly authenticator?: "auth_snowflake" | "auth_oauth" | "auth_ext_browser" | "auth_okta" | "auth_jwt" | "auth_mfa" | "auth_pat" | "auth_wif";
+    /** Redacted authentication token, passed as the native `auth_token` option. */
+    readonly token?: Redacted.Redacted<string>;
+    /** Redacted inline PKCS#8 PEM used with `auth_jwt`. */
+    readonly privateKey?: Redacted.Redacted<string>;
+    /** Redacted passphrase for an encrypted inline PKCS#8 PEM. */
+    readonly privateKeyPass?: Redacted.Redacted<string>;
+    /** Path to a native-driver-supported private-key file; not inline PEM. */
+    readonly privateKeyPath?: string;
+    /** Driver name or absolute library/manifest path. Defaults to snowflake. */
+    readonly driver?: string;
+    /** Additional driver manifest directories, searched before standard locations. */
+    readonly manifestSearchPaths?: readonly string[];
+    /** Advanced native options. Redact every value, including connection URIs. */
+    readonly databaseOptions?: Readonly<Record<string, Redacted.Redacted<string>>>;
+}
+/**
+ * Serialized operations on a single connection. A transaction session expires
+ * when its callback exits. Fully consume a stream before reusing that session.
+ * @since 0.1.0
+ */
+export interface SnowflakeSession {
+    /**
+     * Collect a result into an Arrow table, preserving its schema for empty results.
+     * @param sql Trusted SQL text with `?` placeholders; values are never interpolated.
+     * @param parameters Arrow columns in placeholder order, normally one parameter row.
+     * @returns A lazy Effect that owns a fresh statement and reader until collection ends.
+     * Native errors become `SnowflakeError`; cleanup failures remain defects.
+     */
+    readonly query: (sql: string, parameters?: Table) => Effect.Effect<Table, SnowflakeError>;
+    /**
+     * Execute DDL or DML using a fresh, scoped statement.
+     * @param sql Trusted SQL text with optional `?` placeholders.
+     * @param parameters Arrow columns in placeholder order.
+     * @returns The affected row count, or `-1` when the native driver cannot report it.
+     * Snowflake DDL may implicitly commit; execute it outside transaction callbacks.
+     */
+    readonly execute: (sql: string, parameters?: Table) => Effect.Effect<number, SnowflakeError>;
+    /**
+     * Pull Arrow record batches lazily without collecting the full result.
+     * @param sql Trusted SQL text with optional `?` placeholders.
+     * @param parameters Arrow columns in placeholder order.
+     * @returns A stream that holds the connection until consumption and cleanup finish.
+     * Early termination releases the reader before its statement. In-flight native
+     * reads settle before interruption completes; ADBC JS provides no cancellation.
+     */
+    readonly stream: (sql: string, parameters?: Table) => Stream.Stream<RecordBatch, SnowflakeError>;
+}
+/**
+ * A scoped connection with exclusive transaction callbacks.
+ * @since 0.1.0
+ */
+export interface SnowflakeClient extends SnowflakeSession {
+    /**
+     * Run an Effect inside this client's transaction. Composes with `pipe` and
+     * preserves its success, errors, and environment. Captured repositories and
+     * client methods automatically use the active session on this fiber.
+     */
+    readonly withTransaction: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E | SnowflakeError, R>;
+    /**
+     * Disable autocommit, run `use`, and commit its success or roll back its failure.
+     * @param use Callback using the supplied session; await all work before returning.
+     * @returns The callback value, preserving its error and service requirements.
+     * Defects and callback interruption also roll back. Once commit starts, its
+     * outcome and autocommit restoration finish before interruption is accepted;
+     * an interrupted caller may therefore observe an already committed transaction.
+     * Failed commits attempt rollback. Recovered cleanup defects still prevent
+     * commit and fail with operation `transaction.invalidated`.
+     * Failed rollback or autocommit restoration invalidates the client, and cleanup
+     * defects accompany the original failure. Captured client methods resolve the
+     * active transaction session. Nested transactions fail with `transaction.nested`.
+     */
+    readonly transaction: <A, E, R>(use: (session: SnowflakeSession) => Effect.Effect<A, E, R>) => Effect.Effect<A, E | SnowflakeError, R>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

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

package/dist/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":""}

package/dist/snowflake-error.d.ts

@@ -0,0 +1,19 @@
+import { Schema } from "effect";
+declare const SnowflakeError_base: Schema.Class<SnowflakeError, Schema.TaggedStruct<"SnowflakeError", {
+    readonly message: Schema.String;
+    readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError & {
+    readonly brand: unique symbol;
+}>;
+/**
+ * Sanitized native failure with an operation label and a generic message.
+ * Raw native messages, SQL, bind values, credentials, and original causes are
+ * intentionally excluded. Operation failures use the typed error channel;
+ * cleanup failures are promoted to defects while preserving the original Cause.
+ * @since 0.1.0
+ */
+export declare class SnowflakeError extends SnowflakeError_base {
+}
+export declare const failure: (operation: string) => () => SnowflakeError;
+export {};
+//# sourceMappingURL=snowflake-error.d.ts.map

package/dist/snowflake-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snowflake-error.d.ts","sourceRoot":"","sources":["../src/snowflake-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;oBAYZ,OAAO,MAAM;;AAVjC;;;;;;GAMG;AAEH,qBAAa,cAAe,SAAQ,mBAGuC;CAAG;AAE9E,eAAO,MAAM,OAAO,cAAe,MAAM,yBACoC,CAAC"}

package/dist/snowflake-error.js

@@ -0,0 +1,13 @@
+import { Schema } from "effect";
+/**
+ * Sanitized native failure with an operation label and a generic message.
+ * Raw native messages, SQL, bind values, credentials, and original causes are
+ * intentionally excluded. Operation failures use the typed error channel;
+ * cleanup failures are promoted to defects while preserving the original Cause.
+ * @since 0.1.0
+ */
+// oxlint-disable-next-line unicorn/throw-new-error -- Schema.TaggedError is a class factory.
+export class SnowflakeError extends Schema.TaggedError()("SnowflakeError", { message: Schema.String, operation: Schema.String }) {
+}
+export const failure = (operation) => () => new SnowflakeError({ message: `Snowflake ${operation} failed`, operation });
+//# sourceMappingURL=snowflake-error.js.map

package/dist/snowflake-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snowflake-error.js","sourceRoot":"","sources":["../src/snowflake-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;GAMG;AACH,6FAA6F;AAC7F,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,WAAW,EAGnD,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;CAAG;AAE9E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,EAAE,CACjD,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,aAAa,SAAS,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC"}

package/examples/.env.example

@@ -0,0 +1,16 @@
+# Copy to packages/effect-snowflake/.env. Real .env files are ignored by Git.
+SNOWFLAKE_ACCOUNT=myorg-myaccount
+SNOWFLAKE_USERNAME=example_user
+SNOWFLAKE_DATABASE=EXAMPLE_DB
+SNOWFLAKE_SCHEMA=PUBLIC
+SNOWFLAKE_WAREHOUSE=EXAMPLE_WH
+SNOWFLAKE_AUTHENTICATOR=auth_jwt
+# Choose an existing key file, or supply inline PKCS#8 PEM with SNOWFLAKE_PRIVATE_KEY.
+SNOWFLAKE_PRIVATE_KEY_PATH=/absolute/path/to/rsa_key.p8
+# SNOWFLAKE_PRIVATE_KEY_PASS=encrypted-key-passphrase
+# SNOWFLAKE_ROLE=EXAMPLE_ROLE
+# SNOWFLAKE_ADBC_DRIVER=/absolute/path/to/libadbc_driver_snowflake.so
+# For password authentication use auth_snowflake and SNOWFLAKE_PASSWORD.
+# For OAuth use auth_oauth and SNOWFLAKE_TOKEN.
+# The live E2E suite contacts Snowflake only when this is 1.
+SNOWFLAKE_E2E=0

package/examples/README.md

@@ -0,0 +1,73 @@
+# Snowflake ADBC examples
+
+These are Node.js programs that import the built `@rc312/effect-snowflake` public API. They use the same configuration and scenario functions as the [live E2E suite](../e2e/snowflake.test.ts).
+
+## Setup
+
+From the repository root, install dependencies and the native Snowflake driver:
+
+```sh
+bun install
+npm install -g @columnar-tech/dbc
+dbc install snowflake
+cp packages/effect-snowflake/examples/.env.example packages/effect-snowflake/.env
+```
+
+Edit `packages/effect-snowflake/.env` for a development account, warehouse, database, and schema. The template uses JWT authentication and a private-key file path. For inline keys, remove `SNOWFLAKE_PRIVATE_KEY_PATH` and set `SNOWFLAKE_PRIVATE_KEY` to a PKCS#8 PEM. `SNOWFLAKE_PRIVATE_KEY_PASS` supplies an encrypted inline key's passphrase. For password authentication, set `SNOWFLAKE_AUTHENTICATOR=auth_snowflake` and `SNOWFLAKE_PASSWORD`; for OAuth use `auth_oauth` and `SNOWFLAKE_TOKEN`.
+
+The examples need Node.js 22.19+ and Bun for workspace build scripts. The Node entrypoints load the package-local `.env` using `--env-file-if-exists`; exported environment variables take precedence. Real `.env` files are ignored by Git. Do not commit credentials. Secrets are loaded through `Config.Redacted`, and the configuration check never prints their values.
+
+If manifest discovery is unavailable, set `SNOWFLAKE_ADBC_DRIVER` to the absolute path of an installed driver library or manifest. The shared configuration sets native login and network timeouts to 30 seconds and request retries to 60 seconds. These bound individual native operations; they are not an overall scenario deadline.
+
+## Run
+
+All commands below run from the repository root and build the library and examples before starting Node:
+
+```sh
+# Check environment configuration without loading the native addon or connecting.
+bun run --cwd packages/effect-snowflake example:check
+
+# Bind int64, text, boolean, and a typed null; decode one Arrow row.
+bun run --cwd packages/effect-snowflake example:query
+
+# Drain a stream, stop another after one nonempty batch, and reuse the connection.
+bun run --cwd packages/effect-snowflake example:stream
+
+# Commit one insert and roll another back using a session-temporary table.
+bun run --cwd packages/effect-snowflake example:transaction
+
+# Compose a service accessor, Arrow binding, decoding, and a transaction with flow.
+bun run --cwd packages/effect-snowflake example:composition
+```
+
+The query example casts the int64 result to VARCHAR before decoding it, preserving the exact value `9007199254740993`. It uses explicit Arrow types and places parameter columns in SQL placeholder order. Values containing SQL punctuation remain bind values.
+
+The streaming example counts 1,000 generated rows and then consumes one nonempty batch from a 100,000-row result. Batch size is driver-controlled, so the first batch may contain the entire result. It finishes that consumer before executing the follow-up query on the same connection.
+
+The transaction example creates `EFFECT_SNOWFLAKE_EXAMPLE` as a temporary table before either transaction, because Snowflake DDL implicitly commits. It commits ID 1, rolls back ID 2 with a typed failure, reads back only ID 1, and drops the table in a finalizer. It requires permission to create temporary tables in the configured schema. Each run uses its own session, and no application table is modified. Warehouse queries can incur Snowflake usage charges.
+
+The application boundary in `run.ts` provides a shared Snowflake service Layer and an explicit native driver Layer. It captures configuration once, keeps the connection alive for the whole program, prints only the result, and exits unsuccessfully if acquisition, execution, decoding, or cleanup fails. `composition.ts` uses `flow` and `Snowflake.withTransaction`; `scenarios.ts` also demonstrates the captured client's `withTransaction` combinator. ADBC JS has no native cancellation API; interruption waits for in-flight native work to settle before releasing its resources.
+
+## Live E2E checks
+
+Set `SNOWFLAKE_E2E=1` in the package-local `.env` or exported environment, then run:
+
+```sh
+bun run --cwd packages/effect-snowflake test:e2e
+```
+
+The suite checks the actual native Snowflake path for parameter precision, full and early stream consumption, connection reuse, committed and rolled-back data, empty-result schema, and retained-client rejection after scope closure. Every case acquires its own connection. The temporary table is scoped to its session and dropped explicitly.
+
+Without `SNOWFLAKE_E2E=1`, the suite reports its live cases as skipped. When enabled, missing configuration, missing drivers, authentication failures, and incorrect results fail the suite. Tests have a two-minute harness timeout, but the adapter still must await a non-cancellable native operation during cleanup; a hung native driver can outlast the harness timeout. These checks are separate from the ordinary credential-free unit tests.
+
+## Test and inspect coverage
+
+```sh
+bun run --cwd packages/effect-snowflake typecheck
+bun run --cwd packages/effect-snowflake test:cli
+bun run --cwd packages/effect-snowflake test:coverage
+```
+
+The ordinary test command also runs compiled Node entrypoints as subprocesses, checking configuration validation, sanitized native errors, exit codes, and E2E opt-in behavior without credentials.
+
+Coverage enforces at least 95% lines, statements, and functions, and 90% branches for the library sources. The coverage command writes a terminal summary, `coverage/coverage-summary.json`, and `coverage/index.html`. Unit tests use real Arrow IPC and controlled native-resource implementations with deterministic Promise and Effect gates. They cover asynchronous driver failures, scope retirement, delayed native acquisition and reads, combined failure causes, reader teardown, transaction rollback, configuration, and tracing redaction.

package/examples/check.ts

@@ -0,0 +1,12 @@
+import { Effect } from "effect";
+
+import { optionsFromEnv } from "./options.ts";
+
+// Validate names and credential wrapping without loading the native driver.
+try {
+  await Effect.runPromise(optionsFromEnv());
+  console.info("Snowflake example configuration is valid.");
+} catch (error) {
+  console.error(error);
+  process.exitCode = 1;
+}