@classytic/repo-core 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@classytic/repo-core` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.1] - 2026-07-11
+
+### Docs — `DataAdapter.close()` ownership rule
+
+- Clarified the `close?()` contract (doc-only, no type/runtime change): the adapter does **not** own the database connection — the host does, and `close()` must release only adapter/kit-owned resources (TTL/vacuum timers, change streams), never disconnect a shared client/pool. Kits that genuinely own a connection gate its disposal behind an explicit opt-in. This standardizes cleanup semantics across mongokit/sqlitekit/pgkit/prismakit.
+
 ## [0.8.0] - 2026-07-08
 
 ### Added — data-lifecycle contract (archive, streaming, distribution awareness)

package/dist/adapter/types.d.mts

@@ -191,7 +191,25 @@ interface DataAdapter<TDoc = unknown> {
    * SQL adapters, non-Mongo operators, or kits that compile Filter IR.
    */
   matchesFilter?: (item: unknown, filters: Record<string, unknown>) => boolean;
-  /** Close / cleanup resources. */
+  /**
+   * Release resources this ADAPTER (or its repository) allocated —
+   * background timers (TTL / vacuum sweepers), open change streams,
+   * kit-internal caches. Safe to call more than once.
+   *
+   * **Ownership rule (load-bearing).** The adapter does NOT own the
+   * database connection — the HOST does. The host wrote
+   * `new PrismaClient()` / `new Pool()` / `mongoose.connect()`, so the
+   * host closes it (typically in its own `onClose`). `close()` MUST NOT
+   * disconnect a connection it didn't open: several resources commonly
+   * share one client/pool, so tearing it down from one adapter would
+   * break every sibling resource. Kits that must dispose a connection
+   * they genuinely own gate it behind an explicit opt-in (e.g.
+   * prismakit's `ownsClient`).
+   *
+   * Kits with nothing kit-owned to release still MAY implement this as a
+   * documented no-op so hosts can call `adapter.close()` uniformly across
+   * every backend without feature-detecting.
+   */
   close?(): Promise<void>;
   /**
    * Optional: does the underlying schema declare a path with this name?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/repo-core",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
   "type": "module",
   "sideEffects": false,