@druumen/sessions-db 0.1.0 → 0.1.3

package/package.json

@@ -1,19 +1,37 @@
 {
   "name": "@druumen/sessions-db",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Cross-session traceability for Claude Code — events.jsonl SSoT + JSON projection cache + 3-priority identity reconciliation",
   "license": "Apache-2.0",
   "type": "module",
-  "main": "./lib/index.mjs",
+  "main": "./lib/index.cjs",
+  "module": "./lib/index.mjs",
   "types": "./types/index.d.ts",
   "bin": {
     "sessions-db": "./cli/sessions-db.mjs",
     "sessions-db-session-start": "./cli/sessions-db-session-start.mjs"
   },
   "exports": {
-    ".": "./lib/index.mjs",
-    "./cli": "./cli/sessions-db.mjs",
-    "./hook": "./cli/sessions-db-session-start.mjs"
+    ".": {
+      "import": {
+        "types": "./types/index.d.ts",
+        "default": "./lib/index.mjs"
+      },
+      "require": {
+        "types": "./types/index.d.cts",
+        "default": "./lib/index.cjs"
+      },
+      "default": "./lib/index.mjs"
+    },
+    "./cli": {
+      "import": "./cli/sessions-db.mjs",
+      "default": "./cli/sessions-db.mjs"
+    },
+    "./hook": {
+      "import": "./cli/sessions-db-session-start.mjs",
+      "default": "./cli/sessions-db-session-start.mjs"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "lib/",
@@ -29,7 +47,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@gitlab.tinfant.org:8922/druumen/sessions-db.git"
+    "url": "git+https://github.com/druumen/sessions-db.git"
   },
   "bugs": {
     "email": "security@druumen.com"
@@ -44,10 +62,13 @@
   "scripts": {
     "test": "find __tests__ -name '*.test.mjs' -type f -print0 | xargs -0 node --test",
     "build:types": "tsc -p tsconfig.json",
+    "build:cjs": "esbuild lib/index.mjs --bundle --format=cjs --platform=node --target=node18 --outfile=lib/index.cjs",
+    "build": "npm run build:types && npm run build:cjs",
     "check:types-smoke": "tsc --noEmit -p __tests__/types-smoke/tsconfig.json",
-    "prepublishOnly": "npm run build:types"
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
+    "esbuild": "^0.25.12",
     "typescript": "^5.9.3"
   }
 }

package/types/index.d.cts

@@ -0,0 +1,62 @@
+/**
+ * @druumen/sessions-db — public TypeScript entry point for CJS consumers.
+ *
+ * This is the `.d.cts` sibling of `./index.d.ts`. Both have the same
+ * value + type re-export shape; the only difference is the extension,
+ * which tells TypeScript Node16/NodeNext module resolution that the
+ * underlying runtime module is CJS.
+ *
+ * Without this file, a consumer with `moduleResolution: "Node16"` in
+ * a CJS context (no `"type": "module"` in their package.json) hits
+ * `TS1479` because the Node16 resolver picks the `import` condition's
+ * `.d.mts` types — which TS treats as "ESM origin" — and refuses to
+ * `require()` them from CJS.
+ *
+ * `package.json` exports map nests `types` per runtime condition:
+ *
+ *     "exports": {
+ *       ".": {
+ *         "import": { "types": "./types/index.d.ts",  ... },
+ *         "require": { "types": "./types/index.d.cts", ... }
+ *       }
+ *     }
+ *
+ * This was added in 0.1.1 as part of the cockpit B1 packaging fix.
+ *
+ * NOTE on file content: identical to `index.d.ts` except for the
+ * extension. The runtime IS bundled into a single `lib/index.cjs`
+ * (esbuild) so type signatures match across both .d.mts re-exports
+ * (ESM source paths) and the .cjs bundle (which contains the same
+ * symbols).
+ */
+
+// Runtime VALUES (functions + constants) + their inferred TypeScript types,
+// from the auto-emitted mirror of `lib/index.mjs`. Same source-of-truth as
+// the .d.ts barrel; the .cts extension flips TS's runtime-origin assumption
+// to CJS, matching the actual `lib/index.cjs` bundle that the require()
+// condition resolves at runtime.
+export * from './index.d.mts';
+
+// TYPE NAMES (branded scalars, enums, composite shapes), from the
+// auto-emitted mirror of `lib/types.mjs`'s @typedef block.
+export type {
+  // Branded scalars
+  SessionStableId,
+  ClaudeSessionId,
+  EventId,
+  Iso8601,
+  // Enums
+  ActivityState,
+  Outcome,
+  IdentitySource,
+  IdentityConfidence,
+  EventOp,
+  // Composite shapes
+  TranscriptFile,
+  IdentityResolution,
+  ParentCandidate,
+  KnownSession,
+  ProjectionMeta,
+  Projection,
+  SessionEvent,
+} from './types.d.mts';

package/types/index.d.ts

@@ -1,43 +1,43 @@
 /**
- * @druumen/sessions-db — public TypeScript entry point.
+ * @druumen/sessions-db — public TypeScript entry point (hand-crafted barrel).
  *
- * This file is HAND-CRAFTED and committed to the repo (not regenerated by
- * `tsc`). The `tsc` build emits per-source-file declarations as `.d.mts`
- * (because the sources are `.mjs`); this `.d.ts` curates the public type
- * surface so cockpit-class consumers can write:
+ * Stitches together the two files that `tsc --emitDeclarationOnly` produces
+ * from the JS source so consumers get one curated import surface:
  *
- *     import type {
- *       KnownSession,
- *       Projection,
- *       SessionEvent,
- *       ActivityState,
- *       Outcome,
- *     } from '@druumen/sessions-db';
+ *   - `./index.d.mts` — value re-exports mirroring `lib/index.mjs` (run-
+ *     time functions + constants, with their TypeScript type signatures).
+ *   - `./types.d.mts` — type declarations lifted from the `@typedef`
+ *     block in `lib/types.mjs` (branded scalars, enums, composite shapes).
+ *
+ * Two files exist because `lib/index.mjs` is plain JS — it can re-export
+ * runtime symbols but not `export type` (TypeScript-only syntax). This
+ * file does the type-side stitching that JS cannot.
  *
- * and resolve everything through one entry — without having to memorise
- * which lib/* file each typedef lives in.
+ * `package.json` `"types"` and `exports[".".types]` both point here.
+ * `tsc` never overwrites this file — it emits `.d.mts` for `.mjs`
+ * sources, so the `.d.ts` extension keeps it out of the build path.
  *
- * The `lib/index.mjs` runtime entry is intentionally a Day-1 stub
- * (re-exports happen on Day 3 — once the public *function* surface is
- * settled). This `.d.ts` is safe to ship today because it is types-only
- * and has zero runtime side effects.
+ * Cockpit / consumer pattern:
  *
- * Convention for tsc-emitted neighbours:
- *   - Auto-generated:     `types/<name>.d.mts`  (mirrors `lib/<name>.mjs`)
- *   - Hand-crafted:       `types/index.d.ts`    (this file)
+ *     import {
+ *       loadProjection,         // runtime value
+ *       setAlias,               // runtime value
+ *       type KnownSession,      // type
+ *       type Projection,        // type
+ *     } from '@druumen/sessions-db';
  *
- * `package.json` `"types"` points at `./types/index.d.ts` so this is the
- * resolution entry. The neighbouring `.d.mts` files exist for direct
- * sub-path imports (`@druumen/sessions-db/lib/storage.d.mts`) but cockpit
- * should prefer this curated surface for forward compat.
+ * This barrel was added in 0.1.1 to fix Bug B from 0.1.0, where the
+ * previous hand-crafted file used `export type X = typeof import('...')`
+ * patterns that re-exported type aliases instead of values, breaking
+ * `import { loadProjection }` for cockpit-class consumers under Node16.
  */
 
-// ---------------------------------------------------------------------------
-// Type vocabulary — re-exported from `lib/types.d.mts` (which `tsc` lifted
-// from the `@typedef` block in `lib/types.mjs`). This is the canonical
-// surface for cockpit consumers.
-// ---------------------------------------------------------------------------
+// Runtime VALUES (functions + constants) + their inferred TypeScript types,
+// from the auto-emitted mirror of `lib/index.mjs`.
+export * from './index.d.mts';
 
+// TYPE NAMES (branded scalars, enums, composite shapes), from the
+// auto-emitted mirror of `lib/types.mjs`'s @typedef block.
 export type {
   // Branded scalars
   SessionStableId,
@@ -59,69 +59,3 @@ export type {
   Projection,
   SessionEvent,
 } from './types.d.mts';
-
-// ---------------------------------------------------------------------------
-// Function signatures — re-exported from per-source `.d.mts` neighbours.
-//
-// We re-export TYPES of functions (typeof) rather than the runtime symbols
-// because Day 2 keeps `lib/index.mjs` a runtime stub. Day 3 will flip
-// `lib/index.mjs` into a real re-export hub and at that point `tsc` will
-// regenerate `types/index.d.mts` with the same shape — but consumers who
-// imported through this `.d.ts` see no breakage because the type names
-// are identical.
-//
-// The `typeof import(...)` pattern is the standard TypeScript ambient
-// re-export when the source is JS-with-JSDoc.
-// ---------------------------------------------------------------------------
-
-// uuid.mjs
-export type GenerateSessionId = typeof import('./uuid.d.mts').generateSessionId;
-export type IsSessionId = typeof import('./uuid.d.mts').isSessionId;
-export type ExtractTimestamp = typeof import('./uuid.d.mts').extractTimestamp;
-
-// projection.mjs
-export type ApplyEvent = typeof import('./projection.d.mts').applyEvent;
-export type EmptyProjection = typeof import('./projection.d.mts').emptyProjection;
-export type EmptySession = typeof import('./projection.d.mts').emptySession;
-export type RebuildFromEvents = typeof import('./projection.d.mts').rebuildFromEvents;
-
-// storage.mjs
-export type NewEvent = typeof import('./storage.d.mts').newEvent;
-export type AppendEvent = typeof import('./storage.d.mts').appendEvent;
-export type ReadAllEvents = typeof import('./storage.d.mts').readAllEvents;
-export type LoadProjection = typeof import('./storage.d.mts').loadProjection;
-export type SaveProjection = typeof import('./storage.d.mts').saveProjection;
-export type RebuildProjection = typeof import('./storage.d.mts').rebuildProjection;
-export type TryUpdateProjection = typeof import('./storage.d.mts').tryUpdateProjection;
-export type RecordSessionSeen = typeof import('./storage.d.mts').recordSessionSeen;
-
-// identity.mjs
-export type ResolveIdentity = typeof import('./identity.d.mts').resolveIdentity;
-export type FindByClaudeSessionId = typeof import('./identity.d.mts').findByClaudeSessionId;
-export type FindByTranscriptLineage = typeof import('./identity.d.mts').findByTranscriptLineage;
-export type ScanFingerprintCandidates = typeof import('./identity.d.mts').scanFingerprintCandidates;
-export type CollectParentCandidates = typeof import('./identity.d.mts').collectParentCandidates;
-export type CapParentCandidates = typeof import('./identity.d.mts').capParentCandidates;
-export type ClassifyCorroborators = typeof import('./identity.d.mts').classifyCorroborators;
-export type MeetsThreshold = typeof import('./identity.d.mts').meetsThreshold;
-
-// sweep.mjs
-export type ComputeSweepTransitions = typeof import('./sweep.d.mts').computeSweepTransitions;
-export type ComputeEffectiveLastProgress = typeof import('./sweep.d.mts').computeEffectiveLastProgress;
-
-// sanitize.mjs
-export type SanitizeFirstPrompt = typeof import('./sanitize.d.mts').sanitizeFirstPrompt;
-export type StripSystemReminders = typeof import('./sanitize.d.mts').stripSystemReminders;
-export type StripIdeWrappers = typeof import('./sanitize.d.mts').stripIdeWrappers;
-
-// transcript.mjs
-export type ParseTranscriptFile = typeof import('./transcript.d.mts').parseTranscriptFile;
-export type ListTranscriptFiles = typeof import('./transcript.d.mts').listTranscriptFiles;
-export type WorkspaceHashFromCwd = typeof import('./transcript.d.mts').workspaceHashFromCwd;
-
-// git-context.mjs
-export type GitContextFn = typeof import('./git-context.d.mts').gitContext;
-
-// paths.mjs (Day 4 — storage path resolution chain)
-export type ResolveStoragePaths = typeof import('./paths.d.mts').resolveStoragePaths;
-export type PathsFromRoot = typeof import('./paths.d.mts').pathsFromRoot;