@fjall/clickhouse 16.0.1 → 17.0.0

package/dist/.build-source-hash

@@ -9,12 +9,12 @@
     "package.json",
     "tsconfig.json"
   ],
-  "hash": "f7bf9e6f14e16e57655046e9c6c21c9bb860fb959a10d5de832a7b6cac34f29d",
+  "hash": "9c73d8e830e4b668a48ef86cee88f0b38bdeb163fce2c773f75f51974ebd958c",
   "files": {
     "src/connectWithRetry.ts": "eb4d131ea8e81922",
     "src/constants.ts": "00b236fd35f098cb",
-    "src/createClient.ts": "ca857dc10c888313",
-    "src/index.ts": "4b819b3a8d8de192",
+    "src/createClient.ts": "83f093bfd7765a9f",
+    "src/index.ts": "2ab0816e1d411108",
     "src/logger.ts": "659d04c534247903",
     "src/provisionUsers.ts": "3e88d53b5eb1ccf5",
     "src/runSqlMigrations.ts": "d187aa5de9e4316e",
@@ -22,9 +22,9 @@
     "src/sleepAbortable.ts": "0286a0719bef3a38",
     "src/verifyExpectedClickHouseSchemaVersion.ts": "84f5463cd47e4a30",
     "../scripts/minify-dist.mjs": "6b2e4b0df8aec601",
-    "package.json": "8f995a1c0e47b4bc",
+    "package.json": "04839b296e7c3d94",
     "tsconfig.json": "db759831ad95f396"
   },
-  "outputHash": "b6d878eba58caac7620f53070709609ac576162f10fe1f31c80a2a7ad070d0cd",
+  "outputHash": "3a47884a7d84ebd1d6ce8dca964dc9572214d5be64156f785355f12ac0a867db",
   "outputFileCount": 21
 }

package/dist/.minified

@@ -1 +1 @@
-10 files minified at 2026-08-22T04:03:41.329Z
+10 files minified at 2026-08-23T02:03:05.878Z

package/dist/createClient.d.ts

@@ -22,13 +22,33 @@ export interface CreateFjallClickHouseClientOptions {
     readonly password?: string;
     /** Optional database name override. */
     readonly database?: string;
-    /** Pass-through to `@clickhouse/client`. */
+    /** Merged over {@link WIRE_FORMAT_CLICKHOUSE_SETTINGS}; caller keys win. */
     readonly clickhouse_settings?: ClickHouseClientConfigOptions["clickhouse_settings"];
     readonly compression?: ClickHouseClientConfigOptions["compression"];
     readonly request_timeout?: number;
     readonly max_open_connections?: number;
     readonly keep_alive?: ClickHouseClientConfigOptions["keep_alive"];
 }
+/**
+ * The Fjall wire-format contract, applied to every client this factory
+ * builds: DateTime/DateTime64 columns serialise as RFC3339 instants with a
+ * timezone designator (`2026-08-23T01:23:45.678Z`), so consumers may
+ * `new Date(value)` any timestamp the server returns — no bespoke parser.
+ * Inputs stay tolerant (`best_effort` accepts both the ISO shape and the
+ * legacy `YYYY-MM-DD hh:mm:ss` form).
+ *
+ * Asymmetry to know: typed query PARAMETERS (`{x:DateTime64(3)}`) are bound
+ * by a separate parser that rejects a trailing `Z` regardless of
+ * `date_time_input_format` — keep formatting bind parameters without the
+ * designator (ClickHouse 26.3, verified).
+ *
+ * Caller-supplied `clickhouse_settings` spread AFTER these, so a caller can
+ * override either setting deliberately.
+ */
+export declare const WIRE_FORMAT_CLICKHOUSE_SETTINGS: {
+    readonly date_time_output_format: "iso";
+    readonly date_time_input_format: "best_effort";
+};
 /**
  * Sync factory wrapping `@clickhouse/client`'s `createClient`. No AWS SDK
  * call, no `await`, no module-level cache — the CA PEM is already on

package/dist/createClient.js

@@ -1 +1 @@
-var a=Object.defineProperty;var d=(e,n)=>a(e,"name",{value:n,configurable:!0});import{createClient as c}from"@clickhouse/client";function l(e={}){const n=process.env.CLICKHOUSE_URL,i=e.url!==void 0&&e.url!==""?e.url:n!==void 0&&n!==""?n:void 0;if(i===void 0)throw new Error("createFjallClickHouseClient: CLICKHOUSE_URL must be set (env or opts.url)");const r=process.env.CLICKHOUSE_CA_CERT,u=e.caCert!==void 0&&e.caCert!==""?e.caCert:r!==void 0&&r!==""?r:void 0;return c({url:i,...e.username!==void 0&&{username:e.username},...e.password!==void 0&&{password:e.password},...e.database!==void 0&&{database:e.database},...e.clickhouse_settings!==void 0&&{clickhouse_settings:e.clickhouse_settings},...e.compression!==void 0&&{compression:e.compression},...e.request_timeout!==void 0&&{request_timeout:e.request_timeout},...e.max_open_connections!==void 0&&{max_open_connections:e.max_open_connections},...e.keep_alive!==void 0&&{keep_alive:e.keep_alive},...u!==void 0&&{tls:{ca_cert:Buffer.from(u,"utf8")}}})}d(l,"createFjallClickHouseClient");export{l as createFjallClickHouseClient};
+var a=Object.defineProperty;var d=(e,n)=>a(e,"name",{value:n,configurable:!0});import{createClient as t}from"@clickhouse/client";const c={date_time_output_format:"iso",date_time_input_format:"best_effort"};function o(e={}){const n=process.env.CLICKHOUSE_URL,i=e.url!==void 0&&e.url!==""?e.url:n!==void 0&&n!==""?n:void 0;if(i===void 0)throw new Error("createFjallClickHouseClient: CLICKHOUSE_URL must be set (env or opts.url)");const r=process.env.CLICKHOUSE_CA_CERT,u=e.caCert!==void 0&&e.caCert!==""?e.caCert:r!==void 0&&r!==""?r:void 0;return t({url:i,...e.username!==void 0&&{username:e.username},...e.password!==void 0&&{password:e.password},...e.database!==void 0&&{database:e.database},clickhouse_settings:{...c,...e.clickhouse_settings},...e.compression!==void 0&&{compression:e.compression},...e.request_timeout!==void 0&&{request_timeout:e.request_timeout},...e.max_open_connections!==void 0&&{max_open_connections:e.max_open_connections},...e.keep_alive!==void 0&&{keep_alive:e.keep_alive},...u!==void 0&&{tls:{ca_cert:Buffer.from(u,"utf8")}}})}d(o,"createFjallClickHouseClient");export{c as WIRE_FORMAT_CLICKHOUSE_SETTINGS,o as createFjallClickHouseClient};

package/dist/index.d.ts

@@ -5,4 +5,4 @@ export { type ConnectWithRetryOpts, connectWithRetry, } from "./connectWithRetry
 export { type ProvisionUsersFromEnvOpts, type ProvisionUsersFromEnvResult, provisionUsersFromEnv, } from "./provisionUsers.js";
 export { type RunSqlMigrationsOpts, type RunSqlMigrationsResult, runSqlMigrations, } from "./runSqlMigrations.js";
 export { type VerifyExpectedClickHouseSchemaVersionOpts, type VerifyExpectedClickHouseSchemaVersionResult, verifyExpectedClickHouseSchemaVersion, } from "./verifyExpectedClickHouseSchemaVersion.js";
-export { type CreateFjallClickHouseClientOptions, createFjallClickHouseClient, } from "./createClient.js";
+export { type CreateFjallClickHouseClientOptions, createFjallClickHouseClient, WIRE_FORMAT_CLICKHOUSE_SETTINGS, } from "./createClient.js";

package/dist/index.js

@@ -1 +1 @@
-import{CLICKHOUSE_MANAGED_USERS_ENV as o,userPasswordEnvName as t}from"./constants.js";import{ManagedUserNameSchema as m,ManagedUserNamesSchema as s}from"./schemas.js";import{createConsoleMigrationLogger as i}from"./logger.js";import{connectWithRetry as p}from"./connectWithRetry.js";import{provisionUsersFromEnv as x}from"./provisionUsers.js";import{runSqlMigrations as E}from"./runSqlMigrations.js";import{verifyExpectedClickHouseSchemaVersion as g}from"./verifyExpectedClickHouseSchemaVersion.js";import{createFjallClickHouseClient as M}from"./createClient.js";export{o as CLICKHOUSE_MANAGED_USERS_ENV,m as ManagedUserNameSchema,s as ManagedUserNamesSchema,p as connectWithRetry,i as createConsoleMigrationLogger,M as createFjallClickHouseClient,x as provisionUsersFromEnv,E as runSqlMigrations,t as userPasswordEnvName,g as verifyExpectedClickHouseSchemaVersion};
+import{CLICKHOUSE_MANAGED_USERS_ENV as o,userPasswordEnvName as t}from"./constants.js";import{ManagedUserNameSchema as m,ManagedUserNamesSchema as s}from"./schemas.js";import{createConsoleMigrationLogger as i}from"./logger.js";import{connectWithRetry as p}from"./connectWithRetry.js";import{provisionUsersFromEnv as S}from"./provisionUsers.js";import{runSqlMigrations as x}from"./runSqlMigrations.js";import{verifyExpectedClickHouseSchemaVersion as l}from"./verifyExpectedClickHouseSchemaVersion.js";import{createFjallClickHouseClient as M,WIRE_FORMAT_CLICKHOUSE_SETTINGS as N}from"./createClient.js";export{o as CLICKHOUSE_MANAGED_USERS_ENV,m as ManagedUserNameSchema,s as ManagedUserNamesSchema,N as WIRE_FORMAT_CLICKHOUSE_SETTINGS,p as connectWithRetry,i as createConsoleMigrationLogger,M as createFjallClickHouseClient,S as provisionUsersFromEnv,x as runSqlMigrations,t as userPasswordEnvName,l as verifyExpectedClickHouseSchemaVersion};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fjall/clickhouse",
-  "version": "16.0.1",
+  "version": "17.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fjall-tech/fjall.git",
@@ -50,7 +50,7 @@
     "@clickhouse/client": "^1.18.0"
   },
   "dependencies": {
-    "@fjall/util": "^16.0.1",
+    "@fjall/util": "^17.0.0",
     "zod": "^4.4.3"
   },
   "engines": {