@rc312/effect-snowflake 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @rc312/effect-snowflake
+
+## 0.2.0
+
+### Minor Changes
+
+- Upgrade Effect support to 4.1.2 and require Node.js 22.19 or newer to match Effect's runtime requirements.
+
+  Effect 4.1 promotes typed failures to defects when combined with cleanup defects. Snowflake transaction failures retain both the original error and the cleanup error in the combined Cause.
+
+## 0.1.0
+
+### Minor Changes
+
+- fc1d925: Add an Effect 4 Snowflake client using Apache Arrow ADBC, with scoped resources, Arrow parameter binding, batch streaming, serialized operations, and transactions.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryan Callahan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,175 @@
-# Temporary Holding Version
+# @rc312/effect-snowflake
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An Effect 4 client for Snowflake through Apache Arrow ADBC. Queries return Arrow `Table`s, streams emit Arrow `RecordBatch`es, and parameters are Arrow tables. The adapter preserves Arrow values without coercing decimals, timestamps, binary values, or 64-bit integers into JavaScript numbers or JSON.
+
+## Install
+
+```sh
+bun add @rc312/effect-snowflake effect apache-arrow@^21.1.0
+```
+
+Use Node.js 22.19 or newer. This is a server-only package with a native dependency. The package includes the JavaScript ADBC driver manager; install the Snowflake shared-library driver separately:
+
+```sh
+npm install -g @columnar-tech/dbc
+dbc install snowflake
+```
+
+`make` defaults to the driver name `snowflake`. Set `driver` to an absolute path to a driver library or manifest when needed, or supply `manifestSearchPaths`. Importing this package does not load the native addon; acquisition loads it and reports loading failures as `SnowflakeError`.
+
+See the [ADBC JavaScript guide](https://arrow.apache.org/adbc/current/javascript/quickstart.html) and [Snowflake ADBC driver documentation](https://adbc-drivers.org/drivers/snowflake/) for driver installation, platform support, and native options. The implementation targets driver manager 0.24.x and Arrow 21.x. Native Snowflake driver installation and account access are application deployment requirements.
+
+## Services, Layers, and composition
+
+Provide the native driver at the application boundary and share one client Layer across repositories:
+
+```ts
+import * as Snowflake from "@rc312/effect-snowflake";
+import * as AdbcDriver from "@rc312/effect-snowflake/adbc-driver";
+import { Config, Effect, Layer } from "effect";
+
+const DatabaseLive = Snowflake.layerConfig({
+  account: Config.String("SNOWFLAKE_ACCOUNT"),
+  username: Config.String("SNOWFLAKE_USERNAME"),
+  password: Config.Redacted("SNOWFLAKE_PASSWORD"),
+  warehouse: Config.String("SNOWFLAKE_WAREHOUSE"),
+}).pipe(Layer.provide(AdbcDriver.layer));
+
+const program = Snowflake.query("select current_version() as VERSION").pipe(
+  Snowflake.withTransaction,
+  Effect.provide(DatabaseLive)
+);
+```
+
+`layer(options)` requires `AdbcDriver`; `layerConfig(config)` reads a `Config` or a record of `Config` fields at acquisition. `layerFrom(acquire)` adapts an application-owned acquisition Effect and preserves its errors and dependencies. The Layer supplies Scope and owns the connection until the consuming program finishes. Reuse the same Layer value when several repository Layers should share one connection. Tests can provide another `AdbcDriver` or `Layer.succeed(Snowflake.Snowflake, client)`.
+
+Use `yield* Snowflake.Snowflake` to capture the client in a repository, or compose the module's `query`, `execute`, and `stream` accessors directly. Client methods have no service requirements; accessors require `Snowflake.Snowflake`. `flow` is useful for a reusable input-to-Effect workflow; `pipe` attaches decoding, transaction scope, and provisioning to a particular Effect. See the [complete composition example](examples/composition.ts).
+
+`Snowflake.withTransaction(effect)` uses the provided service. `client.withTransaction(effect)` uses that particular captured client. Both preserve the Effect's success, errors, and service requirements. A client resolves its current transaction session through a private fiber-local service, so repositories that captured it before the transaction still participate. Different clients and independently started fibers keep their own connection routing. Child fibers started within a transaction inherit its session and must finish before it exits. Nested transactions fail with `operation: "transaction.nested"`; Snowflake does not provide savepoints.
+
+The implementation follows the constructor/Layer separation in [Effect's PostgreSQL adapter](https://github.com/Effect-TS/effect/blob/main/packages/sql/pg/src/PgClient.ts) and the per-client transaction service in [Effect SQL](https://github.com/Effect-TS/effect/blob/main/packages/effect/src/sql/SqlClient.ts). Its transport contract remains Arrow tables and record batches; the core `SqlClient` interface uses row results and SQL-dialect compilation. Native acquisition, session execution, transaction handling, and scope ownership are separate modules here. Session operations compose acquisition, native execution, and ownership with `flow`; transaction handling composes a scoped callback with commit, rollback, and autocommit finalizers. The ownership bracket uses named acquisition, joining, and release operations to keep shutdown ordering explicit. The existing `make` and `makeWithDriver` factories remain available for callers that own scopes directly.
+
+## Query and execute
+
+```ts
+import * as Snowflake from "@rc312/effect-snowflake";
+import { tableFromArrays } from "apache-arrow";
+import { Config, Effect } from "effect";
+
+const program = Effect.scoped(
+  Effect.gen(function* () {
+    const db = yield* Snowflake.make({
+      account: yield* Config.String("SNOWFLAKE_ACCOUNT"),
+      username: yield* Config.String("SNOWFLAKE_USERNAME"),
+      authenticator: "auth_jwt",
+      privateKey: yield* Config.Redacted("SNOWFLAKE_PRIVATE_KEY"),
+      warehouse: yield* Config.String("SNOWFLAKE_WAREHOUSE"),
+    });
+
+    const params = tableFromArrays({
+      id: new BigInt64Array([9007199254740993n]),
+    });
+    const table = yield* db.query("select ?::number(38, 0) as ID", params);
+    return table;
+  })
+);
+```
+
+Run `program` at your application's existing Effect runtime boundary. `make` is lazy until executed, and its enclosing Scope owns the connection and database. Use `Layer.effect` with an application service tag to share a scoped client. The adapter does not create an application runtime or retry queries.
+
+`query(sql, parameters?)` collects the result into an Arrow table, including the schema of an empty result. `execute(sql, parameters?)` runs DDL/DML and returns the affected row count (`-1` means unknown). Each operation creates and closes a fresh statement. SQL is passed directly to the driver: use `?` placeholders and an Arrow table with columns in placeholder order. Values are never interpolated into SQL. Provide explicit Arrow types when inference would be ambiguous.
+
+ADBC authentication names differ from the Snowflake JavaScript SDK: `auth_snowflake`, `auth_jwt`, `auth_oauth`, `auth_ext_browser`, `auth_okta`, `auth_mfa`, `auth_pat`, and `auth_wif`. Set `password`, `token`, `privateKey`, and `privateKeyPass` with `Redacted` values or `Config.Redacted`. `privateKey` is an inline PKCS#8 PEM; `privateKeyPath` is a plain filesystem path.
+
+Pass additional native options through `databaseOptions`; every value must be `Redacted`, including credential-bearing connection URIs. Explicit named fields override entries in `databaseOptions`. For example:
+
+```ts
+import { Redacted } from "effect";
+
+const databaseOptions = {
+  "adbc.snowflake.sql.client_option.login_timeout": Redacted.make("30s"),
+  "adbc.snowflake.sql.client_option.request_timeout": Redacted.make("60s"),
+  "adbc.snowflake.sql.client_option.client_timeout": Redacted.make("30s"),
+};
+```
+
+## Streaming
+
+```ts
+import { Stream } from "effect";
+
+// Inside the Scope that owns db:
+const firstBatch = db
+  .stream("select * from EVENTS")
+  .pipe(Stream.take(1), Stream.runCollect);
+```
+
+Streams acquire resources only when consumed. Batches are pulled on demand; there is no adapter-owned prefetch buffer. Native driver prefetch settings still apply. Early termination, errors, and interruption release the Arrow reader before closing its statement. A stream reserves the connection until its consumer releases it. Finish consuming it before starting another operation on the same connection from within that consumer.
+
+Connection operations are serialized, including streamed queries. Use separately scoped clients when parallel connections are required.
+
+## Transactions
+
+```ts
+// Inside the Scope that owns db:
+const insert = db.transaction((tx) =>
+  Effect.gen(function* () {
+    yield* tx.execute(
+      "insert into EVENTS (ID) values (?)",
+      tableFromArrays({ id: [1] })
+    );
+    yield* tx.execute(
+      "insert into EVENTS (ID) values (?)",
+      tableFromArrays({ id: [2] })
+    );
+  })
+);
+```
+
+Transactions reserve the connection, disable autocommit, and serialize work on the supplied session. Use `tx` inside the callback and await its work. Returning from the callback closes its child scope and expires the session before commit. Typed failures, defects, and interruption trigger rollback. Failed commits also attempt rollback. Successful completion or rollback restores autocommit.
+
+Failed reader/statement cleanup, rollback, or autocommit restoration invalidates the client; no further operation is accepted. Recovering a cleanup defect within the callback still prevents commit: the transaction fails with operation `transaction.invalidated` and attempts rollback. Autocommit is never re-enabled after a failed rollback, because doing so could commit pending changes. Cleanup failures are preserved as defects alongside the original failure. In Effect 4.1, a cleanup defect also promotes the original typed failure to a defect in the combined Cause. Acquire a new client after invalidation.
+
+Only the callback is interruptible. Once commit starts, the adapter finishes commit and autocommit restoration before releasing the connection. Interruption during a successful commit does not trigger a subsequent rollback; the caller may still observe interruption after the commit completes.
+
+Captured client methods automatically use the active transaction session on the current fiber. Transactions do not nest; nesting fails with operation `transaction.nested`. Snowflake DDL implicitly commits: use the transaction helper for DML/query work and create tables before the transaction. A transport failure during commit can leave its remote outcome ambiguous; the adapter does not retry it.
+
+## Lifetime, interruption, and errors
+
+The database, connection, statements, and readers have explicit scoped ownership. The client owns a private sequential scope even when its parent scope finalizes in parallel. Scope closure interrupts and joins active acquisition and operations before closing the connection and database, including a connection returned after shutdown begins. Failed acquisition closes and detaches its child scope immediately. Client and transaction-session reuse after closure fails.
+
+ADBC JavaScript 0.24 has no cancellation method or `AbortSignal` support. Native acquisition, execution, and batch reads are therefore awaited uninterruptibly before their resources can be released. An Effect interruption or timeout can wait for an in-flight native call to settle. Configure driver login, request, and network timeouts to bound those waits. The adapter cannot guarantee an immediate remote cancellation or a bounded shutdown if native calls never settle.
+
+`SnowflakeError` exposes a safe `operation` and generic `message`. Raw driver messages, SQL, binds, connection options, and native error causes are excluded. Public operations have tracing spans without sensitive query attributes. Driver logging is configured by the application and is outside this adapter's error sanitization.
+
+For a custom loader or deterministic test, use `makeWithDriver` with the `AdbcDriver` service from `@rc312/effect-snowflake/adbc-driver`. This structural boundary replaces only native resources; Arrow processing and Effect ownership remain real. `make` supplies the default native loader automatically.
+
+## Runnable examples and live E2E tests
+
+The [examples guide](examples/README.md) includes environment setup and complete Node entrypoints for Arrow parameter binding, full and early stream consumption, and transactions. The live suite imports those same scenarios and additionally checks empty-result schemas and closed-client reuse.
+
+```sh
+bun run --cwd packages/effect-snowflake example:check
+bun run --cwd packages/effect-snowflake example:query
+bun run --cwd packages/effect-snowflake example:stream
+bun run --cwd packages/effect-snowflake example:transaction
+bun run --cwd packages/effect-snowflake example:composition
+# After configuring credentials and setting SNOWFLAKE_E2E=1:
+bun run --cwd packages/effect-snowflake test:e2e
+```
+
+The examples read the package-local `.env` at the Node entrypoint. The configuration check validates settings without connecting. Live tests are skipped unless explicitly enabled; they use independent sessions and a temporary table, and require a reachable Snowflake account, a warehouse, and appropriate schema privileges.
+
+## Development
+
+From the workspace root:
+
+```sh
+bun run --cwd packages/effect-snowflake build
+bun run --cwd packages/effect-snowflake typecheck
+bun run --cwd packages/effect-snowflake test
+bun run --cwd packages/effect-snowflake test:coverage
+bun run lint
+```
+
+Unit tests use real Arrow IPC and controlled native resources for precision, acquisition and reader failures, serialized work, combined cleanup causes, transaction interruption, scope retirement, and tracing redaction. The examples and E2E sources are included in typechecking. Coverage reports are written under the package's ignored `coverage/` directory; the live suite runs separately from ordinary unit tests.

package/dist/adbc-driver.d.ts

@@ -0,0 +1,49 @@
+import type { AdbcConnection, AdbcStatement, AdbcDatabase, ConnectOptions } from "@apache-arrow/adbc-driver-manager";
+import { Context, Effect, Layer } from "effect";
+import type { SnowflakeError } from "./snowflake-error.ts";
+/**
+ * Minimal native database resource owned by a scoped client.
+ * Implementations must await acquisition/cleanup rather than detach native work.
+ * @since 0.1.0
+ */
+export interface Database {
+    /** Open a connection; the adapter owns it after this Promise resolves. */
+    readonly connect: () => Promise<Connection>;
+    /** Release database resources after all owned connections have closed. */
+    readonly close: AdbcDatabase["close"];
+}
+/**
+ * Native statement operations used by the adapter. Each query receives a fresh
+ * instance. A returned reader is released before `close` is invoked.
+ * @since 0.1.0
+ */
+export type Statement = Pick<AdbcStatement, "setSqlQuery" | "bind" | "executeQuery" | "executeUpdate" | "close">;
+/**
+ * Native connection boundary. Methods are called under an exclusive permit;
+ * `createStatement` must return a fresh statement for each call.
+ * @since 0.1.0
+ */
+export type Connection = Pick<AdbcConnection, "setAutoCommit" | "commit" | "rollback" | "close"> & {
+    readonly createStatement: () => Promise<Statement>;
+};
+declare const AdbcDriver_base: Context.ServiceClass<AdbcDriver, "@rc312/effect-snowflake/AdbcDriver", {
+    /** Construct the database; the client owns and closes a successful result. */
+    readonly open: (options: ConnectOptions) => Effect.Effect<Database, SnowflakeError>;
+}>;
+/**
+ * Loader service required by `makeWithDriver` for alternate native loading or
+ * controlled tests. `open` must map native failures to sanitized Snowflake errors.
+ * Use {@link layer} for the standard Apache Arrow implementation.
+ * @since 0.1.0
+ */
+export declare class AdbcDriver extends AdbcDriver_base {
+}
+/**
+ * Standard loader layer. Importing it does not load the native addon; `open` does.
+ * Addon import failures use operation `driver.load`; database construction failures
+ * use `database.open`. Raw native messages and causes are excluded from both.
+ * @since 0.1.0
+ */
+export declare const layer: Layer.Layer<AdbcDriver, never, never>;
+export {};
+//# sourceMappingURL=adbc-driver.d.ts.map

package/dist/adbc-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adbc-driver.d.ts","sourceRoot":"","sources":["../src/adbc-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,aAAa,EACb,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,OAAO,CACpE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAC3B,cAAc,EACd,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAClD,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;CAAE,CAAC;;IAWvD,8EAA8E;mBAC/D,CACb,OAAO,EAAE,cAAc,KACpB,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC;;AAZhD;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,eAQS;CAAG;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,KAAK,uCAiBjB,CAAC"}

package/dist/adbc-driver.js

@@ -0,0 +1,29 @@
+import { Context, Effect, Layer } from "effect";
+import { failure } from "./snowflake-error.js";
+/**
+ * Loader service required by `makeWithDriver` for alternate native loading or
+ * controlled tests. `open` must map native failures to sanitized Snowflake errors.
+ * Use {@link layer} for the standard Apache Arrow implementation.
+ * @since 0.1.0
+ */
+export class AdbcDriver extends Context.Service()("@rc312/effect-snowflake/AdbcDriver") {
+}
+/**
+ * Standard loader layer. Importing it does not load the native addon; `open` does.
+ * Addon import failures use operation `driver.load`; database construction failures
+ * use `database.open`. Raw native messages and causes are excluded from both.
+ * @since 0.1.0
+ */
+export const layer = Layer.succeed(AdbcDriver, AdbcDriver.of({
+    open: Effect.fn("Snowflake.AdbcDriver.open")(function* openDatabase(options) {
+        const { AdbcDatabase } = yield* Effect.tryPromise({
+            catch: failure("driver.load"),
+            try: () => import("@apache-arrow/adbc-driver-manager"),
+        });
+        return yield* Effect.try({
+            catch: failure("database.open"),
+            try: () => new AdbcDatabase(options),
+        });
+    }),
+}));
+//# sourceMappingURL=adbc-driver.js.map

package/dist/adbc-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adbc-driver.js","sourceRoot":"","sources":["../src/adbc-driver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAmC/C;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAO,CAAC,OAAO,EAQ5C,CAAC,oCAAoC,CAAC;CAAG;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAChC,UAAU,EACV,UAAU,CAAC,EAAE,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAC1C,QAAQ,CAAC,CAAC,YAAY,CAAC,OAAO;QAC5B,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YAChD,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC;YAC7B,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mCAAmC,CAAC;SACvD,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACvB,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC;YAC/B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC;SACrC,CAAC,CAAC;IACL,CAAC,CACF;CACF,CAAC,CACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import type { RecordBatch, Table } from "apache-arrow";
+import { Config, Context, Effect, Layer, Stream } from "effect";
+import type { SnowflakeClient, SnowflakeOptions, SnowflakeSession } from "./models.ts";
+import type { SnowflakeError } from "./snowflake-error.ts";
+export type { SnowflakeClient, SnowflakeOptions, SnowflakeSession, } from "./models.ts";
+export { SnowflakeError } from "./snowflake-error.ts";
+declare const Snowflake_base: Context.ServiceClass<Snowflake, "@rc312/effect-snowflake/Snowflake", {
+    readonly query: SnowflakeSession["query"];
+    readonly execute: SnowflakeSession["execute"];
+    readonly stream: SnowflakeSession["stream"];
+    readonly transaction: SnowflakeClient["transaction"];
+    readonly withTransaction: SnowflakeClient["withTransaction"];
+}>;
+/**
+ * Injected client service. Its layer owns one connection and captures its driver.
+ * Reuse the same layer value when repositories should share that connection.
+ * @since 0.1.0
+ */
+export declare class Snowflake extends Snowflake_base {
+}
+/**
+ * Acquire a connected client through an injected `AdbcDriver` service.
+ *
+ * @param options Native Snowflake settings; construction performs no I/O.
+ * @returns An Effect requiring `Scope` and `AdbcDriver`. The scope joins active
+ * operations before closing connection and database, even under parallel teardown.
+ * Failed acquisition immediately releases its partial resources and child scope.
+ *
+ * Custom loaders must normalize native errors to sanitized `SnowflakeError`s.
+ * Native calls have no cancellation API: configure driver network/login timeouts
+ * to bound shutdown. Prefer {@link make} when using the standard native manager.
+ * @since 0.1.0
+ */
+export declare const makeWithDriver: (options: SnowflakeOptions) => Effect.Effect<SnowflakeClient, SnowflakeError, import("./adbc-driver.ts").AdbcDriver | import("effect/Scope").Scope>;
+/**
+ * Acquire a server-only Snowflake connection through the Apache Arrow ADBC manager.
+ *
+ * @param options Connection settings. The Snowflake shared-library driver must be
+ * installed separately; `driver` defaults to `snowflake`.
+ * @returns A lazy Effect requiring `Scope`. Its scope owns connection and database.
+ * Driver loading and connection errors are sanitized `SnowflakeError`s. Native
+ * calls settle before interruption releases resources; queries are never retried.
+ *
+ * @example
+ * ```ts
+ * import { make } from "@rc312/effect-snowflake";
+ * import { Config, Effect } from "effect";
+ *
+ * const program = Effect.scoped(Effect.gen(function* () {
+ *   const db = yield* make({
+ *     account: yield* Config.String("SNOWFLAKE_ACCOUNT"),
+ *     username: yield* Config.String("SNOWFLAKE_USERNAME"),
+ *     password: yield* Config.Redacted("SNOWFLAKE_PASSWORD"),
+ *   });
+ *   return yield* db.query("select current_version() as VERSION");
+ * }));
+ * ```
+ * @since 0.1.0
+ */
+export declare const make: (options: SnowflakeOptions) => Effect.Effect<SnowflakeClient, SnowflakeError, import("effect/Scope").Scope>;
+/**
+ * Provide the service from an existing acquisition Effect, retaining its errors
+ * and dependencies. The Layer owns any Scope required by the acquisition.
+ * Useful for application-owned configuration, instrumentation, and test clients.
+ * @since 0.1.0
+ */
+export declare const layerFrom: <E, R>(acquire: Effect.Effect<SnowflakeClient, E, R>) => Layer.Layer<Snowflake, E, Exclude<R, import("effect/Scope").Scope>>;
+/**
+ * Provide a scoped Snowflake service using an injected AdbcDriver.
+ * Compose with `Layer.provide(AdbcDriver.layer)` at the application boundary.
+ * @since 0.1.0
+ */
+export declare const layer: (options: SnowflakeOptions) => Layer.Layer<Snowflake, SnowflakeError, import("./adbc-driver.ts").AdbcDriver>;
+/**
+ * Read Config values when the layer is built, then acquire its scoped client.
+ * Accepts one Config or a record of Config fields; ConfigProvider stays caller-owned.
+ * Requires the same explicit AdbcDriver dependency as {@link layer}.
+ * @since 0.1.0
+ */
+export declare const layerConfig: (options: Config.Wrap<SnowflakeOptions>) => Layer.Layer<Snowflake, Config.ConfigError | SnowflakeError, import("./adbc-driver.ts").AdbcDriver>;
+/** Query the injected client, or the active transaction's scoped session. @since 0.1.0 */
+export declare const query: (sql: string, parameters?: Table) => Effect.Effect<Table<any>, SnowflakeError, Snowflake>;
+/** Execute DML/DDL on the injected client. @since 0.1.0 */
+export declare const execute: (sql: string, parameters?: Table) => Effect.Effect<number, SnowflakeError, Snowflake>;
+/** Lazily stream batches from the injected client; the consumer owns its permit. @since 0.1.0 */
+export declare const stream: (sql: string, parameters?: Table) => Stream.Stream<RecordBatch, SnowflakeError, Snowflake>;
+/**
+ * Run an Effect in a transaction using the injected client. Pipe it around a
+ * composed workflow; accessors and `yield* Snowflake` both resolve its session.
+ * Nested transactions fail with operation `transaction.nested` (Snowflake has no
+ * savepoints). Callback errors, defects, service requirements, and interruption
+ * are preserved by the underlying transaction implementation.
+ * @since 0.1.0
+ */
+export declare const withTransaction: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E | SnowflakeError, R | Snowflake>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAc,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAM5E,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;;oBAUlC,gBAAgB,CAAC,OAAO,CAAC;sBACvB,gBAAgB,CAAC,SAAS,CAAC;qBAC5B,gBAAgB,CAAC,QAAQ,CAAC;0BACrB,eAAe,CAAC,aAAa,CAAC;8BAC1B,eAAe,CAAC,iBAAiB,CAAC;;AAZhE;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cASS;CAAG;AAE3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,qJAE1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,6GAGhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,WACnB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,wEACV,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,KAAK,YAAa,gBAAgB,kFACX,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,uGACJ,CAAC;AAE/D,0FAA0F;AAC1F,eAAO,MAAM,KAAK,QAAS,MAAM,eAAe,KAAK,yDAIlD,CAAC;AAEJ,2DAA2D;AAC3D,eAAO,MAAM,OAAO,QAAS,MAAM,eAAe,KAAK,qDAIpD,CAAC;AAEJ,iGAAiG;AACjG,eAAO,MAAM,MAAM,QACZ,MAAM,eACE,KAAK,KACjB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,SAAS,CAMpD,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,wDAIlE,CAAC"}

package/dist/index.js

@@ -0,0 +1,89 @@
+import { Config, Context, Effect, flow, pipe, Layer, Stream } from "effect";
+import { layer as driverLayer } from "./adbc-driver.js";
+import * as Client from "./internal/client.js";
+import * as Connection from "./internal/connection.js";
+import { acquireOwner } from "./internal/lifecycle.js";
+export { SnowflakeError } from "./snowflake-error.js";
+/**
+ * Injected client service. Its layer owns one connection and captures its driver.
+ * Reuse the same layer value when repositories should share that connection.
+ * @since 0.1.0
+ */
+export class Snowflake extends Context.Service()("@rc312/effect-snowflake/Snowflake") {
+}
+/**
+ * Acquire a connected client through an injected `AdbcDriver` service.
+ *
+ * @param options Native Snowflake settings; construction performs no I/O.
+ * @returns An Effect requiring `Scope` and `AdbcDriver`. The scope joins active
+ * operations before closing connection and database, even under parallel teardown.
+ * Failed acquisition immediately releases its partial resources and child scope.
+ *
+ * Custom loaders must normalize native errors to sanitized `SnowflakeError`s.
+ * Native calls have no cancellation API: configure driver network/login timeouts
+ * to bound shutdown. Prefer {@link make} when using the standard native manager.
+ * @since 0.1.0
+ */
+export const makeWithDriver = Effect.fn("Snowflake.make")(flow(Connection.make, Effect.flatMap(Client.make), acquireOwner));
+/**
+ * Acquire a server-only Snowflake connection through the Apache Arrow ADBC manager.
+ *
+ * @param options Connection settings. The Snowflake shared-library driver must be
+ * installed separately; `driver` defaults to `snowflake`.
+ * @returns A lazy Effect requiring `Scope`. Its scope owns connection and database.
+ * Driver loading and connection errors are sanitized `SnowflakeError`s. Native
+ * calls settle before interruption releases resources; queries are never retried.
+ *
+ * @example
+ * ```ts
+ * import { make } from "@rc312/effect-snowflake";
+ * import { Config, Effect } from "effect";
+ *
+ * const program = Effect.scoped(Effect.gen(function* () {
+ *   const db = yield* make({
+ *     account: yield* Config.String("SNOWFLAKE_ACCOUNT"),
+ *     username: yield* Config.String("SNOWFLAKE_USERNAME"),
+ *     password: yield* Config.Redacted("SNOWFLAKE_PASSWORD"),
+ *   });
+ *   return yield* db.query("select current_version() as VERSION");
+ * }));
+ * ```
+ * @since 0.1.0
+ */
+export const make = Effect.fn("Snowflake.makeDefault")((options) => makeWithDriver(options).pipe(Effect.provide(driverLayer)));
+/**
+ * Provide the service from an existing acquisition Effect, retaining its errors
+ * and dependencies. The Layer owns any Scope required by the acquisition.
+ * Useful for application-owned configuration, instrumentation, and test clients.
+ * @since 0.1.0
+ */
+export const layerFrom = (acquire) => Layer.effect(Snowflake, acquire);
+/**
+ * Provide a scoped Snowflake service using an injected AdbcDriver.
+ * Compose with `Layer.provide(AdbcDriver.layer)` at the application boundary.
+ * @since 0.1.0
+ */
+export const layer = (options) => layerFrom(makeWithDriver(options));
+/**
+ * Read Config values when the layer is built, then acquire its scoped client.
+ * Accepts one Config or a record of Config fields; ConfigProvider stays caller-owned.
+ * Requires the same explicit AdbcDriver dependency as {@link layer}.
+ * @since 0.1.0
+ */
+export const layerConfig = (options) => Layer.unwrap(Config.unwrap(options).pipe(Effect.map(layer)));
+/** Query the injected client, or the active transaction's scoped session. @since 0.1.0 */
+export const query = (sql, parameters) => pipe(Snowflake, Effect.flatMap((client) => client.query(sql, parameters)));
+/** Execute DML/DDL on the injected client. @since 0.1.0 */
+export const execute = (sql, parameters) => pipe(Snowflake, Effect.flatMap((client) => client.execute(sql, parameters)));
+/** Lazily stream batches from the injected client; the consumer owns its permit. @since 0.1.0 */
+export const stream = (sql, parameters) => Stream.unwrap(pipe(Snowflake, Effect.map((client) => client.stream(sql, parameters))));
+/**
+ * Run an Effect in a transaction using the injected client. Pipe it around a
+ * composed workflow; accessors and `yield* Snowflake` both resolve its session.
+ * Nested transactions fail with operation `transaction.nested` (Snowflake has no
+ * savepoints). Callback errors, defects, service requirements, and interruption
+ * are preserved by the underlying transaction implementation.
+ * @since 0.1.0
+ */
+export const withTransaction = (self) => pipe(Snowflake, Effect.flatMap((client) => client.withTransaction(self)));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE5E,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAC;AAC/C,OAAO,KAAK,UAAU,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAcvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,OAAO,SAAU,SAAQ,OAAO,CAAC,OAAO,EAS3C,CAAC,mCAAmC,CAAC;CAAG;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,CACvD,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CACjE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CACpD,CAAC,OAAyB,EAAE,EAAE,CAC5B,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAC5D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,OAA6C,EAC7C,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAyB,EAAE,EAAE,CACjD,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAsC,EAAE,EAAE,CACpE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE/D,0FAA0F;AAC1F,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,UAAkB,EAAE,EAAE,CACvD,IAAI,CACF,SAAS,EACT,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAC1D,CAAC;AAEJ,2DAA2D;AAC3D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,UAAkB,EAAE,EAAE,CACzD,IAAI,CACF,SAAS,EACT,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAC5D,CAAC;AAEJ,iGAAiG;AACjG,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,GAAW,EACX,UAAkB,EACqC,EAAE,CACzD,MAAM,CAAC,MAAM,CACX,IAAI,CACF,SAAS,EACT,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CACvD,CACF,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAU,IAA4B,EAAE,EAAE,CACvE,IAAI,CACF,SAAS,EACT,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CACzD,CAAC"}

package/dist/internal/client.d.ts

@@ -0,0 +1,6 @@
+import { Effect } from "effect";
+import type { SnowflakeClient } from "../models.ts";
+import type { Connection } from "./connection.ts";
+/** Capture the connection; client methods have no dependency requirements. */
+export declare const make: (connection: Connection) => Effect.Effect<SnowflakeClient, never, never>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/internal/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAA6B,MAAM,QAAQ,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQlD,8EAA8E;AAC9E,eAAO,MAAM,IAAI,0EAuDf,CAAC"}

package/dist/internal/client.js

@@ -0,0 +1,29 @@
+import { Context, Effect, Option, Semaphore, Stream } from "effect";
+import { failure } from "../snowflake-error.js";
+import * as Session from "./session.js";
+import * as Transaction from "./transaction.js";
+// Each client needs its own fiber-local session key, as in Effect SqlClient.
+// A transaction on one client must never route another client's queries.
+let nextClientId = 0;
+/** Capture the connection; client methods have no dependency requirements. */
+export const make = Effect.fnUntraced(function* makeClient(connection) {
+    const lock = yield* Semaphore.make(1);
+    const direct = Session.make(connection, connection.owner, lock, connection.isOpen);
+    const transactionSession = Context.Service(`@rc312/effect-snowflake/Transaction/${(nextClientId += 1)}`);
+    const currentSession = Effect.serviceOption(transactionSession).pipe(Effect.map(Option.getOrElse(() => direct)));
+    const runTransaction = Transaction.make(connection, lock);
+    const transaction = (use) => Effect.serviceOption(transactionSession).pipe(Effect.flatMap((current) => {
+        if (Option.isSome(current)) {
+            return Effect.fail(failure("transaction.nested")());
+        }
+        return runTransaction((session) => Effect.provideService(use(session), transactionSession, session));
+    }));
+    return {
+        execute: (sql, parameters) => currentSession.pipe(Effect.flatMap((session) => session.execute(sql, parameters))),
+        query: (sql, parameters) => currentSession.pipe(Effect.flatMap((session) => session.query(sql, parameters))),
+        stream: (sql, parameters) => Stream.unwrap(currentSession.pipe(Effect.map((session) => session.stream(sql, parameters)))),
+        transaction,
+        withTransaction: (self) => transaction(() => self),
+    };
+});
+//# sourceMappingURL=client.js.map

package/dist/internal/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/internal/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGpE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD,6EAA6E;AAC7E,yEAAyE;AACzE,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,UAAU,CACxD,UAAsB;IAEtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CACzB,UAAU,EACV,UAAU,CAAC,KAAK,EAChB,IAAI,EACJ,UAAU,CAAC,MAAM,CAClB,CAAC;IAEF,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CACxC,uCAAuC,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAC7D,CAAC;IAEF,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAClE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAC3C,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAmC,CAClD,GAA0D,EAC1D,EAAE,CACF,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,cAAc,CAAC,CAAC,OAAO,EAAE,EAAE,CAChC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,CACjE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEJ,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAC3B,cAAc,CAAC,IAAI,CACjB,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAC9D;QACH,KAAK,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CACzB,cAAc,CAAC,IAAI,CACjB,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAC5D;QACH,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAC1B,MAAM,CAAC,MAAM,CACX,cAAc,CAAC,IAAI,CACjB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CACzD,CACF;QACH,WAAW;QACX,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KACnD,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/internal/configuration.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectOptions } from "@apache-arrow/adbc-driver-manager";
+import type { SnowflakeOptions } from "../models.ts";
+export declare const configuration: (options: SnowflakeOptions) => ConnectOptions;
+//# sourceMappingURL=configuration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/internal/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,aAAa,YAAa,gBAAgB,KAAG,cAyDzD,CAAC"}

package/dist/internal/configuration.js

@@ -0,0 +1,51 @@
+import { Redacted } from "effect";
+export const configuration = (options) => {
+    const databaseOptions = Object.fromEntries(Object.entries(options.databaseOptions ?? {}).map(([key, value]) => [
+        key,
+        Redacted.value(value),
+    ]));
+    const values = [
+        ["adbc.snowflake.sql.account", options.account],
+        ["username", options.username],
+        ["adbc.snowflake.sql.db", options.database],
+        ["adbc.snowflake.sql.schema", options.schema],
+        ["adbc.snowflake.sql.warehouse", options.warehouse],
+        ["adbc.snowflake.sql.role", options.role],
+        ["adbc.snowflake.sql.auth_type", options.authenticator],
+        [
+            "adbc.snowflake.sql.client_option.jwt_private_key",
+            options.privateKeyPath,
+        ],
+    ];
+    for (const [key, value] of values) {
+        if (value !== undefined) {
+            databaseOptions[key] = value;
+        }
+    }
+    const secrets = [
+        ["password", options.password],
+        ["adbc.snowflake.sql.client_option.auth_token", options.token],
+        [
+            "adbc.snowflake.sql.client_option.jwt_private_key_pkcs8_value",
+            options.privateKey,
+        ],
+        [
+            "adbc.snowflake.sql.client_option.jwt_private_key_pkcs8_password",
+            options.privateKeyPass,
+        ],
+    ];
+    for (const [key, value] of secrets) {
+        if (value !== undefined) {
+            databaseOptions[key] = Redacted.value(value);
+        }
+    }
+    const config = {
+        databaseOptions,
+        driver: options.driver ?? "snowflake",
+    };
+    if (options.manifestSearchPaths !== undefined) {
+        config.manifestSearchPaths = [...options.manifestSearchPaths];
+    }
+    return config;
+};
+//# sourceMappingURL=configuration.js.map

package/dist/internal/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/internal/configuration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAIlC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAyB,EAAkB,EAAE;IACzE,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAClE,GAAG;QACH,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;KACtB,CAAC,CACH,CAAC;IAEF,MAAM,MAAM,GAAG;QACb,CAAC,4BAA4B,EAAE,OAAO,CAAC,OAAO,CAAC;QAC/C,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC9B,CAAC,uBAAuB,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC3C,CAAC,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC;QAC7C,CAAC,8BAA8B,EAAE,OAAO,CAAC,SAAS,CAAC;QACnD,CAAC,yBAAyB,EAAE,OAAO,CAAC,IAAI,CAAC;QACzC,CAAC,8BAA8B,EAAE,OAAO,CAAC,aAAa,CAAC;QACvD;YACE,kDAAkD;YAClD,OAAO,CAAC,cAAc;SACvB;KACO,CAAC;IAEX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,eAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG;QACd,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC9B,CAAC,6CAA6C,EAAE,OAAO,CAAC,KAAK,CAAC;QAC9D;YACE,8DAA8D;YAC9D,OAAO,CAAC,UAAU;SACnB;QACD;YACE,iEAAiE;YACjE,OAAO,CAAC,cAAc;SACvB;KACO,CAAC;IAEX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,eAAe,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAmB;QAC7B,eAAe;QACf,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW;KACtC,CAAC;IAEF,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,mBAAmB,GAAG,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}