durcno@1.0.0-alpha.3

Major Changes

• 45107b5 - Thanks to @almahdi404 !

  change!: unify connector options into single-object defineConfig API

  defineConfig now accepts a single configuration object with a required connector field, instead of taking the connector as a first argument and the config as a second.

  dbCredentials, logger, and pool are no longer top-level fields of Config. They are now passed directly inside the connector factory call as ConnectorOptions.

  // Before
  export default defineConfig(pg(), {
    schema: "db/schema.ts",
    dbCredentials: { url: process.env.DATABASE_URL! },
    logger: createDurcnoLogger(),
  });
  
  // After
  export default defineConfig({
    schema: "db/schema.ts",
    connector: pg({
      dbCredentials: { url: process.env.DATABASE_URL! },
      logger: createDurcnoLogger(),
    }),
  });

  The DurcnoSetup<T> type has been removed. Use Config<T> instead — it now carries the connector type generic directly.

  ConnectorOptions is now exported as a public type for use in tests or shared config helpers.

Minor Changes

• 7a54dd4 - Thanks to @almahdi404 !

  impr(logger): log query execution duration

  execQuery now measures wall-clock time around each query and passes durationMs to the logger alongside the existing sql and arguments fields.

  The built-in Winston formatter renders the new field as a Duration section in the box-drawing output:

    ├ Duration
    │ 3.21ms

  Internally, $Client and $Pool were unified under a shared abstract base class $QueryExecutor so the timing logic only lives in one place.

• 505f4c2 - Thanks to @almahdi404 !

  feat(logger): add query logging support

  Introduces a logger option to Config that enables per-query logging across all connectors and query builders.

  A new DurcnoLogger interface is exported from durcno. Any object with a compatible info(message, meta?) method satisfies it, making the logger adapter-agnostic (Winston, Pino, custom objects, etc.).

  A ready-to-use Winston logger is available via durcno/logger:

  import { createDurcnoLogger } from "durcno/logger";
  
  export default defineConfig(pg(), {
    schema: "db/schema.ts",
    dbCredentials: { url: process.env.DATABASE_URL! },
    logger: createDurcnoLogger(),
  });

  The built-in logger renders each query in a box-drawing style with the SQL and bound arguments printed inline:

  2026-04-24T10:00:00.000Z [durcno] INFO: Query
    ┌ SQL
    │ SELECT "id", "name" FROM "public"."users" WHERE "id" = $1
    ├ Arguments
    │ $1 = 42
    └

  Internally, all query builders now call execQuery() on the executor ($Client / $Pool) instead of query() directly. execQuery() logs the query before forwarding it to the underlying driver, and is a no-op when no logger is configured.