tablinum 0.4.0 → 0.5.0

package/README.md

@@ -198,6 +198,66 @@ Use it in a component:
 - **`db.status`** tracks initialization and terminal state; **`db.syncStatus`** tracks sync activity
 - **`createTablinum(config)`** still exists as a convenience and resolves once `db.ready` completes
 
+## Logging
+
+Tablinum uses [Effect's built-in logging](https://effect.website/docs/observability/logging/) under the hood. By default, logging is completely silent. Set `logLevel` in your config to enable it:
+
+```typescript
+const db = yield* createTablinum({
+  schema,
+  relays: ["wss://relay.example.com"],
+  logLevel: "debug", // "debug" | "info" | "warning" | "error" | "none"
+});
+```
+
+Wire it to an environment variable for easy toggling:
+
+```typescript
+// Effect API
+createTablinum({
+  schema,
+  relays: ["wss://relay.example.com"],
+  logLevel: import.meta.env.VITE_LOG_LEVEL ?? "none",
+});
+
+// Svelte API
+new Tablinum({
+  schema,
+  relays: ["wss://relay.example.com"],
+  logLevel: import.meta.env.VITE_LOG_LEVEL ?? "none",
+});
+```
+
+### Log levels
+
+| Level | What you see |
+|-------|-------------|
+| `"none"` | Nothing (default) |
+| `"error"` | Unrecoverable failures |
+| `"warning"` | Recoverable issues (e.g. rejected writes from removed members) |
+| `"info"` | Lifecycle milestones — storage opened, identity loaded, sync started/complete |
+| `"debug"` | Everything above plus CRUD operations (with record data), relay reconciliation details, gift wrap processing |
+
+### Log spans
+
+Key operations include timing spans that appear automatically in log output:
+
+```
+[11:50:31] INFO (#1) tablinum.init=13ms: Tablinum ready { ... }
+[11:50:41] INFO (#1) tablinum.sync=520ms: Sync complete { changed: ["todos"] }
+```
+
+Spans: `tablinum.init`, `tablinum.sync`, `tablinum.syncRelay`, `tablinum.negentropy`.
+
+### Using Effect's LogLevel type
+
+Power users can also pass Effect's `LogLevel` type directly:
+
+```typescript
+import { LogLevel } from "tablinum";
+createTablinum({ ..., logLevel: LogLevel.Debug });
+```
+
 ## How it works
 
 Tablinum is built on [Effect](https://effect.website) and stores all data locally in [IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API).

package/dist/crud/collection-handle.d.ts

@@ -1,4 +1,5 @@
 import { Effect, Option, Stream } from "effect";
+import type { LogLevel } from "effect";
 import type { CollectionDef, CollectionFields } from "../schema/collection.ts";
 import type { InferRecord } from "../schema/types.ts";
 import type { RecordValidator, PartialValidator } from "../schema/validate.ts";
@@ -20,4 +21,4 @@ export interface CollectionHandle<C extends CollectionDef<CollectionFields>> {
     readonly orderBy: (field: string & keyof Omit<InferRecord<C>, "id">) => QueryBuilder<InferRecord<C>>;
 }
 export type OnWriteCallback = (event: StoredEvent) => Effect.Effect<void, StorageError>;
-export declare function createCollectionHandle<C extends CollectionDef<CollectionFields>>(def: C, storage: IDBStorageHandle, watchCtx: WatchContext, validator: RecordValidator<C["fields"]>, partialValidator: PartialValidator<C["fields"]>, makeEventId: () => string, localAuthor?: string, onWrite?: OnWriteCallback): CollectionHandle<C>;
+export declare function createCollectionHandle<C extends CollectionDef<CollectionFields>>(def: C, storage: IDBStorageHandle, watchCtx: WatchContext, validator: RecordValidator<C["fields"]>, partialValidator: PartialValidator<C["fields"]>, makeEventId: () => string, localAuthor?: string, onWrite?: OnWriteCallback, logLevel?: LogLevel.LogLevel): CollectionHandle<C>;

package/dist/db/create-tablinum.d.ts

@@ -1,14 +1,18 @@
 import { Effect, Scope } from "effect";
+import type { LogLevel } from "effect";
 import type { SchemaConfig } from "../schema/types.ts";
 import type { DatabaseHandle } from "./database-handle.ts";
 import type { EpochKeyInput } from "./epoch.ts";
 import { CryptoError, StorageError, ValidationError } from "../errors.ts";
+export type TablinumLogLevel = "debug" | "info" | "warning" | "error" | "none" | LogLevel.LogLevel;
+export declare function resolveLogLevel(input: TablinumLogLevel | undefined): LogLevel.LogLevel;
 export interface TablinumConfig<S extends SchemaConfig> {
     readonly schema: S;
     readonly relays: readonly string[];
     readonly privateKey?: Uint8Array | undefined;
     readonly epochKeys?: ReadonlyArray<EpochKeyInput> | undefined;
     readonly dbName?: string | undefined;
+    readonly logLevel?: TablinumLogLevel | undefined;
     readonly onSyncError?: ((error: Error) => void) | undefined;
     readonly onRemoved?: ((info: {
         epochId: string;

package/dist/index.d.ts

@@ -4,7 +4,8 @@ export type { CollectionDef, CollectionFields } from "./schema/collection.ts";
 export type { FieldDef, FieldKind } from "./schema/field.ts";
 export type { InferRecord, SchemaConfig } from "./schema/types.ts";
 export { createTablinum } from "./db/create-tablinum.ts";
-export type { TablinumConfig } from "./db/create-tablinum.ts";
+export type { TablinumConfig, TablinumLogLevel } from "./db/create-tablinum.ts";
+export { LogLevel } from "effect";
 export type { DatabaseHandle, SyncStatus } from "./db/database-handle.ts";
 export { encodeInvite, decodeInvite } from "./db/invite.ts";
 export type { Invite } from "./db/invite.ts";

package/dist/index.js

@@ -54,7 +54,7 @@ function collection(name, fields, options) {
   return { _tag: "CollectionDef", name, fields, indices, eventRetention };
 }
 // src/db/create-tablinum.ts
-import { Effect as Effect22, Layer as Layer9, ServiceMap as ServiceMap10 } from "effect";
+import { Effect as Effect22, Layer as Layer10, References as References4, ServiceMap as ServiceMap10 } from "effect";
 
 // src/db/runtime-config.ts
 import { Effect, Schema as Schema2 } from "effect";
@@ -220,7 +220,7 @@ class Tablinum extends ServiceMap2.Service()("tablinum/Tablinum") {
 }
 
 // src/layers/TablinumLive.ts
-import { Effect as Effect21, Exit, Layer as Layer8, Option as Option9, PubSub as PubSub2, Ref as Ref5, Scope as Scope4 } from "effect";
+import { Effect as Effect21, Exit, Layer as Layer9, Option as Option9, PubSub as PubSub2, References as References3, Ref as Ref5, Scope as Scope4 } from "effect";
 
 // src/crud/watch.ts
 import { Effect as Effect2, PubSub, Ref, Stream } from "effect";
@@ -434,7 +434,7 @@ function buildPartialValidator(collectionName, def) {
 }
 
 // src/crud/collection-handle.ts
-import { Effect as Effect6, Option as Option3 } from "effect";
+import { Effect as Effect6, Option as Option3, References } from "effect";
 
 // src/utils/uuid.ts
 var alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
@@ -682,8 +682,9 @@ function mapRecord(record) {
   const { _d, _u, _a, _e, ...fields } = record;
   return fields;
 }
-function createCollectionHandle(def, storage, watchCtx, validator, partialValidator, makeEventId, localAuthor, onWrite) {
+function createCollectionHandle(def, storage, watchCtx, validator, partialValidator, makeEventId, localAuthor, onWrite, logLevel = "None") {
   const collectionName = def.name;
+  const withLog = (effect) => Effect6.provideService(effect, References.MinimumLogLevel, logLevel);
   const commitEvent = (event) => Effect6.gen(function* () {
     yield* storage.putEvent(event);
     yield* applyEvent(storage, event);
@@ -696,7 +697,7 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
     });
   });
   const handle = {
-    add: (data) => Effect6.gen(function* () {
+    add: (data) => withLog(Effect6.gen(function* () {
       const id = uuidv7();
       const fullRecord = { id, ...data };
       yield* validator(fullRecord);
@@ -710,9 +711,10 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
         author: localAuthor
       };
       yield* commitEvent(event);
+      yield* Effect6.logDebug("Record added", { collection: collectionName, recordId: id, data: fullRecord });
       return id;
-    }),
-    update: (id, data) => Effect6.gen(function* () {
+    })),
+    update: (id, data) => withLog(Effect6.gen(function* () {
       const existing = yield* storage.getRecord(collectionName, id);
       if (!existing || existing._d) {
         return yield* new NotFoundError({
@@ -735,9 +737,10 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
         author: localAuthor
       };
       yield* commitEvent(event);
+      yield* Effect6.logDebug("Record updated", { collection: collectionName, recordId: id, data: diff });
       yield* pruneEvents(storage, collectionName, id, def.eventRetention);
-    }),
-    delete: (id) => Effect6.gen(function* () {
+    })),
+    delete: (id) => withLog(Effect6.gen(function* () {
       const existing = yield* storage.getRecord(collectionName, id);
       if (!existing || existing._d) {
         return yield* new NotFoundError({
@@ -755,8 +758,9 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
         author: localAuthor
       };
       yield* commitEvent(event);
+      yield* Effect6.logDebug("Record deleted", { collection: collectionName, recordId: id });
       yield* pruneEvents(storage, collectionName, id, def.eventRetention);
-    }),
+    })),
     undo: (id) => Effect6.gen(function* () {
       const existing = yield* storage.getRecord(collectionName, id);
       if (!existing) {
@@ -805,7 +809,7 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
 }
 
 // src/sync/sync-service.ts
-import { Effect as Effect8, Option as Option5, Ref as Ref3, Schedule } from "effect";
+import { Effect as Effect8, Layer, Option as Option5, References as References2, Ref as Ref3, Schedule } from "effect";
 import { unwrapEvent } from "nostr-tools/nip59";
 import { GiftWrap as GiftWrap2 } from "nostr-tools/kinds";
 
@@ -1376,8 +1380,13 @@ function reconcileWithRelay(storage, relay, relayUrl, publicKeys) {
         allNeedIds.push(id);
       currentMsg = nextMsg;
     }
+    yield* Effect7.logDebug("Negentropy reconciliation complete", {
+      relay: relayUrl,
+      have: allHaveIds.length,
+      need: allNeedIds.length
+    });
     return { haveIds: allHaveIds, needIds: allNeedIds };
-  });
+  }).pipe(Effect7.withLogSpan("tablinum.negentropy"));
 }
 
 // src/db/key-rotation.ts
@@ -1463,7 +1472,8 @@ function parseRemovalNotice(content, dTag) {
 }
 
 // src/sync/sync-service.ts
-function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStatus, watchCtx, relayUrls, knownCollections, epochStore, personalPrivateKey, personalPublicKey, scope, onSyncError, onNewAuthor, onRemoved, onMembersChanged) {
+function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStatus, watchCtx, relayUrls, knownCollections, epochStore, personalPrivateKey, personalPublicKey, scope, logLevel, onSyncError, onNewAuthor, onRemoved, onMembersChanged) {
+  const logLayer = Layer.succeed(References2.MinimumLogLevel, logLevel);
   const getSubscriptionPubKeys = () => {
     return getAllPublicKeys(epochStore);
   };
@@ -1473,7 +1483,7 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     kind: "create"
   });
   const forkHandled = (effect) => {
-    Effect8.runFork(effect.pipe(Effect8.tapError((e) => Effect8.sync(() => onSyncError?.(e))), Effect8.ignore, Effect8.forkIn(scope)));
+    Effect8.runFork(effect.pipe(Effect8.tapError((e) => Effect8.sync(() => onSyncError?.(e))), Effect8.ignore, Effect8.provide(logLayer), Effect8.forkIn(scope)));
   };
   let autoFlushActive = false;
   const autoFlushEffect = Effect8.gen(function* () {
@@ -1530,6 +1540,7 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     if (rumor.pubkey) {
       const reject = yield* shouldRejectWrite(rumor.pubkey);
       if (reject) {
+        yield* Effect8.logWarning("Rejected write from removed member", { author: rumor.pubkey.slice(0, 12) });
         yield* storage.putGiftWrap({ id: remoteGw.id, createdAt: remoteGw.created_at });
         return null;
       }
@@ -1572,6 +1583,7 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     if (didApply && (kind === "u" || kind === "d")) {
       yield* pruneEvents(storage, collectionName, recordId, retention);
     }
+    yield* Effect8.logDebug("Processed gift wrap", { collection: collectionName, recordId, kind, author: author?.slice(0, 12) });
     if (author && onNewAuthor) {
       onNewAuthor(author);
     }
@@ -1640,12 +1652,14 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     }).pipe(Effect8.tapError((err) => Effect8.sync(() => onSyncError?.(err))), Effect8.ignore);
   }), { discard: true });
   const syncRelay = (url, pubKeys, changedCollections) => Effect8.gen(function* () {
+    yield* Effect8.logDebug("Syncing relay", { relay: url });
     const reconcileResult = yield* Effect8.result(reconcileWithRelay(storage, relay, url, Array.from(pubKeys)));
     if (reconcileResult._tag === "Failure") {
       onSyncError?.(reconcileResult.failure);
       return;
     }
     const { haveIds, needIds } = reconcileResult.success;
+    yield* Effect8.logDebug("Relay reconciliation result", { relay: url, need: needIds.length, have: haveIds.length });
     if (needIds.length > 0) {
       const fetched = yield* relay.fetchEvents(needIds, url).pipe(Effect8.tapError((err) => Effect8.sync(() => onSyncError?.(err))), Effect8.orElseSucceed(() => []));
       const sorted = [...fetched].sort((a, b) => a.created_at - b.created_at);
@@ -1663,9 +1677,10 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
         yield* relay.publish(gw.event, [url]).pipe(Effect8.andThen(storage.stripGiftWrapBlob(id)), Effect8.tapError((err) => Effect8.sync(() => onSyncError?.(err))), Effect8.ignore);
       }), { discard: true });
     }
-  });
+  }).pipe(Effect8.withLogSpan("tablinum.syncRelay"));
   const handle = {
     sync: () => Effect8.gen(function* () {
+      yield* Effect8.logInfo("Sync started");
       yield* syncStatus.set("syncing");
       yield* Ref3.set(watchCtx.replayingRef, true);
       const changedCollections = new Set;
@@ -1679,7 +1694,8 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
         yield* notifyReplayComplete(watchCtx, [...changedCollections]);
         yield* syncStatus.set("idle");
       })));
-    }),
+      yield* Effect8.logInfo("Sync complete", { changed: [...changedCollections] });
+    }).pipe(Effect8.withLogSpan("tablinum.sync")),
     publishLocal: (giftWrap) => Effect8.gen(function* () {
       if (!giftWrap.event)
         return;
@@ -1805,7 +1821,7 @@ class SyncStatus extends ServiceMap9.Service()("tablinum/SyncStatus") {
 }
 
 // src/layers/IdentityLive.ts
-import { Effect as Effect11, Layer } from "effect";
+import { Effect as Effect11, Layer as Layer2 } from "effect";
 import { hexToBytes as hexToBytes3 } from "@noble/hashes/utils.js";
 
 // src/db/identity.ts
@@ -1843,21 +1859,25 @@ function createIdentity(suppliedKey) {
 }
 
 // src/layers/IdentityLive.ts
-var IdentityLive = Layer.effect(Identity, Effect11.gen(function* () {
+var IdentityLive = Layer2.effect(Identity, Effect11.gen(function* () {
   const config = yield* Config;
   const storage = yield* Storage;
   const idbKey = yield* storage.getMeta("identity_key");
   const resolvedKey = config.privateKey ?? (typeof idbKey === "string" && idbKey.length === 64 ? hexToBytes3(idbKey) : undefined);
   const identity = yield* createIdentity(resolvedKey);
   yield* storage.putMeta("identity_key", identity.exportKey());
+  yield* Effect11.logInfo("Identity loaded", {
+    publicKey: identity.publicKey.slice(0, 12) + "...",
+    source: config.privateKey ? "config" : resolvedKey ? "storage" : "generated"
+  });
   return identity;
 }));
 
 // src/layers/EpochStoreLive.ts
-import { Effect as Effect12, Layer as Layer2, Option as Option7 } from "effect";
+import { Effect as Effect12, Layer as Layer3, Option as Option7 } from "effect";
 import { generateSecretKey as generateSecretKey2 } from "nostr-tools/pure";
 import { bytesToHex as bytesToHex3 } from "@noble/hashes/utils.js";
-var EpochStoreLive = Layer2.effect(EpochStore, Effect12.gen(function* () {
+var EpochStoreLive = Layer3.effect(EpochStore, Effect12.gen(function* () {
   const config = yield* Config;
   const identity = yield* Identity;
   const storage = yield* Storage;
@@ -1865,21 +1885,24 @@ var EpochStoreLive = Layer2.effect(EpochStore, Effect12.gen(function* () {
   if (typeof idbRaw === "string") {
     const idbStore = deserializeEpochStore(idbRaw);
     if (Option7.isSome(idbStore)) {
+      yield* Effect12.logInfo("Epoch store loaded", { source: "storage", epochs: idbStore.value.epochs.size });
       return idbStore.value;
     }
   }
   if (config.epochKeys && config.epochKeys.length > 0) {
     const store2 = createEpochStoreFromInputs(config.epochKeys);
     yield* storage.putMeta("epochs", stringifyEpochStore(store2));
+    yield* Effect12.logInfo("Epoch store loaded", { source: "config", epochs: store2.epochs.size });
     return store2;
   }
   const store = createEpochStoreFromInputs([{ epochId: EpochId("epoch-0"), key: bytesToHex3(generateSecretKey2()) }], { createdBy: identity.publicKey });
   yield* storage.putMeta("epochs", stringifyEpochStore(store));
+  yield* Effect12.logInfo("Epoch store loaded", { source: "generated", epochs: store.epochs.size });
   return store;
 }));
 
 // src/layers/StorageLive.ts
-import { Effect as Effect14, Layer as Layer3 } from "effect";
+import { Effect as Effect14, Layer as Layer4 } from "effect";
 
 // src/storage/idb.ts
 import { Effect as Effect13 } from "effect";
@@ -2037,16 +2060,18 @@ function openIDBStorage(dbName, schema) {
 }
 
 // src/layers/StorageLive.ts
-var StorageLive = Layer3.effect(Storage, Effect14.gen(function* () {
+var StorageLive = Layer4.effect(Storage, Effect14.gen(function* () {
   const config = yield* Config;
-  return yield* openIDBStorage(config.dbName, {
+  const handle = yield* openIDBStorage(config.dbName, {
     ...config.schema,
     _members: membersCollectionDef
   });
+  yield* Effect14.logInfo("Storage opened", { dbName: config.dbName });
+  return handle;
 }));
 
 // src/layers/RelayLive.ts
-import { Layer as Layer4 } from "effect";
+import { Layer as Layer5 } from "effect";
 
 // src/sync/relay.ts
 import { Effect as Effect15, Option as Option8, Schema as Schema6, ScopedCache, Scope as Scope3 } from "effect";
@@ -2259,10 +2284,10 @@ function createRelayHandle() {
 }
 
 // src/layers/RelayLive.ts
-var RelayLive = Layer4.effect(Relay, createRelayHandle());
+var RelayLive = Layer5.effect(Relay, createRelayHandle());
 
 // src/layers/GiftWrapLive.ts
-import { Effect as Effect17, Layer as Layer5 } from "effect";
+import { Effect as Effect17, Layer as Layer6 } from "effect";
 
 // src/sync/gift-wrap.ts
 import { Effect as Effect16 } from "effect";
@@ -2299,14 +2324,14 @@ function createEpochGiftWrapHandle(senderPrivateKey, epochStore) {
 }
 
 // src/layers/GiftWrapLive.ts
-var GiftWrapLive = Layer5.effect(GiftWrap3, Effect17.gen(function* () {
+var GiftWrapLive = Layer6.effect(GiftWrap3, Effect17.gen(function* () {
   const identity = yield* Identity;
   const epochStore = yield* EpochStore;
   return createEpochGiftWrapHandle(identity.privateKey, epochStore);
 }));
 
 // src/layers/PublishQueueLive.ts
-import { Effect as Effect19, Layer as Layer6 } from "effect";
+import { Effect as Effect19, Layer as Layer7 } from "effect";
 
 // src/sync/publish-queue.ts
 import { Effect as Effect18, Ref as Ref4 } from "effect";
@@ -2380,14 +2405,14 @@ function createPublishQueue(storage, relay) {
 }
 
 // src/layers/PublishQueueLive.ts
-var PublishQueueLive = Layer6.effect(PublishQueue, Effect19.gen(function* () {
+var PublishQueueLive = Layer7.effect(PublishQueue, Effect19.gen(function* () {
   const storage = yield* Storage;
   const relay = yield* Relay;
   return yield* createPublishQueue(storage, relay);
 }));
 
 // src/layers/SyncStatusLive.ts
-import { Layer as Layer7 } from "effect";
+import { Layer as Layer8 } from "effect";
 
 // src/sync/sync-status.ts
 import { Effect as Effect20, SubscriptionRef } from "effect";
@@ -2411,7 +2436,7 @@ function createSyncStatusHandle() {
 }
 
 // src/layers/SyncStatusLive.ts
-var SyncStatusLive = Layer7.effect(SyncStatus, createSyncStatusHandle());
+var SyncStatusLive = Layer8.effect(SyncStatus, createSyncStatusHandle());
 
 // src/layers/TablinumLive.ts
 function reportSyncError(onSyncError, error) {
@@ -2432,12 +2457,12 @@ function mapMemberRecord(record) {
     ...record.removedInEpoch !== undefined ? { removedInEpoch: record.removedInEpoch } : {}
   };
 }
-var IdentityWithDeps = IdentityLive.pipe(Layer8.provide(StorageLive));
-var EpochStoreWithDeps = EpochStoreLive.pipe(Layer8.provide(IdentityWithDeps), Layer8.provide(StorageLive));
-var GiftWrapWithDeps = GiftWrapLive.pipe(Layer8.provide(IdentityWithDeps), Layer8.provide(EpochStoreWithDeps));
-var PublishQueueWithDeps = PublishQueueLive.pipe(Layer8.provide(StorageLive), Layer8.provide(RelayLive));
-var AllServicesLive = Layer8.mergeAll(IdentityWithDeps, EpochStoreWithDeps, StorageLive, RelayLive, GiftWrapWithDeps, PublishQueueWithDeps, SyncStatusLive);
-var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
+var IdentityWithDeps = IdentityLive.pipe(Layer9.provide(StorageLive));
+var EpochStoreWithDeps = EpochStoreLive.pipe(Layer9.provide(IdentityWithDeps), Layer9.provide(StorageLive));
+var GiftWrapWithDeps = GiftWrapLive.pipe(Layer9.provide(IdentityWithDeps), Layer9.provide(EpochStoreWithDeps));
+var PublishQueueWithDeps = PublishQueueLive.pipe(Layer9.provide(StorageLive), Layer9.provide(RelayLive));
+var AllServicesLive = Layer9.mergeAll(IdentityWithDeps, EpochStoreWithDeps, StorageLive, RelayLive, GiftWrapWithDeps, PublishQueueWithDeps, SyncStatusLive);
+var TablinumLive = Layer9.effect(Tablinum, Effect21.gen(function* () {
   const config = yield* Config;
   const identity = yield* Identity;
   const epochStore = yield* EpochStore;
@@ -2447,6 +2472,7 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
   const publishQueue = yield* PublishQueue;
   const syncStatus = yield* SyncStatus;
   const scope = yield* Effect21.scope;
+  const logLayer = Layer9.succeed(References3.MinimumLogLevel, config.logLevel);
   const pubsub = yield* PubSub2.unbounded();
   const replayingRef = yield* Ref5.make(false);
   const closedRef = yield* Ref5.make(false);
@@ -2455,7 +2481,7 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
   const allSchemaEntries = [...schemaEntries, ["_members", membersCollectionDef]];
   const knownCollections = new Map(allSchemaEntries.map(([, def]) => [def.name, def.eventRetention]));
   let notifyAuthor;
-  const syncHandle = createSyncHandle(storage, giftWrap, relay, publishQueue, syncStatus, watchCtx, config.relays, knownCollections, epochStore, identity.privateKey, identity.publicKey, scope, config.onSyncError ? (error) => reportSyncError(config.onSyncError, error) : undefined, (pubkey) => notifyAuthor?.(pubkey), config.onRemoved, config.onMembersChanged);
+  const syncHandle = createSyncHandle(storage, giftWrap, relay, publishQueue, syncStatus, watchCtx, config.relays, knownCollections, epochStore, identity.privateKey, identity.publicKey, scope, config.logLevel, config.onSyncError ? (error) => reportSyncError(config.onSyncError, error) : undefined, (pubkey) => notifyAuthor?.(pubkey), config.onRemoved, config.onMembersChanged);
   const onWrite = (event) => Effect21.gen(function* () {
     const content = event.kind === "d" ? JSON.stringify(null) : JSON.stringify(event.data);
     const dTag = `${event.collection}:${event.recordId}`;
@@ -2533,16 +2559,21 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
           config.onMembersChanged?.();
         }
       }
-    }).pipe(Effect21.ignore, Effect21.forkIn(scope)));
+    }).pipe(Effect21.ignore, Effect21.provide(logLayer), Effect21.forkIn(scope)));
   };
   const handles = new Map;
   for (const [, def] of allSchemaEntries) {
     const validator = buildValidator(def.name, def);
     const partialValidator = buildPartialValidator(def.name, def);
-    const handle = createCollectionHandle(def, storage, watchCtx, validator, partialValidator, uuidv7, identity.publicKey, onWrite);
+    const handle = createCollectionHandle(def, storage, watchCtx, validator, partialValidator, uuidv7, identity.publicKey, onWrite, config.logLevel);
     handles.set(def.name, handle);
   }
   yield* syncHandle.startSubscription();
+  yield* Effect21.logInfo("Tablinum ready", {
+    dbName: config.dbName,
+    collections: schemaEntries.map(([name]) => name),
+    relays: config.relays
+  });
   const selfMember = yield* storage.getRecord("_members", identity.publicKey);
   if (!selfMember) {
     yield* putMemberRecord({
@@ -2551,18 +2582,19 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
       addedInEpoch: getCurrentEpoch(epochStore).id
     });
   }
-  const ensureOpen = (effect) => Effect21.gen(function* () {
+  const withLog = (effect) => Effect21.provideService(effect, References3.MinimumLogLevel, config.logLevel);
+  const ensureOpen = (effect) => withLog(Effect21.gen(function* () {
     if (yield* Ref5.get(closedRef)) {
       return yield* new StorageError({ message: "Database is closed" });
     }
     return yield* effect;
-  });
-  const ensureSyncOpen = (effect) => Effect21.gen(function* () {
+  }));
+  const ensureSyncOpen = (effect) => withLog(Effect21.gen(function* () {
     if (yield* Ref5.get(closedRef)) {
       return yield* new SyncError({ message: "Database is closed", phase: "init" });
     }
     return yield* effect;
-  });
+  }));
   const dbHandle = {
     collection: (name) => {
       const handle = handles.get(name);
@@ -2578,12 +2610,12 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
       relays: [...config.relays],
       dbName: config.dbName
     }),
-    close: () => Effect21.gen(function* () {
+    close: () => withLog(Effect21.gen(function* () {
       if (yield* Ref5.get(closedRef))
         return;
       yield* Ref5.set(closedRef, true);
       yield* Scope4.close(scope, Exit.void);
-    }),
+    })),
     rebuild: () => ensureOpen(rebuild(storage, allSchemaEntries.map(([, def]) => def.name))),
     sync: () => ensureSyncOpen(syncHandle.sync()),
     getSyncStatus: () => syncStatus.get(),
@@ -2654,9 +2686,25 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
     }))
   };
   return dbHandle;
-})).pipe(Layer8.provide(AllServicesLive));
+}).pipe(Effect21.withLogSpan("tablinum.init"))).pipe(Layer9.provide(AllServicesLive));
 
 // src/db/create-tablinum.ts
+function resolveLogLevel(input) {
+  if (input === undefined || input === "none")
+    return "None";
+  switch (input) {
+    case "debug":
+      return "Debug";
+    case "info":
+      return "Info";
+    case "warning":
+      return "Warn";
+    case "error":
+      return "Error";
+    default:
+      return input;
+  }
+}
 function validateConfig(config) {
   return Effect22.gen(function* () {
     if (Object.keys(config.schema).length === 0) {
@@ -2670,19 +2718,26 @@ function createTablinum(config) {
   return Effect22.gen(function* () {
     yield* validateConfig(config);
     const runtimeConfig = yield* resolveRuntimeConfig(config);
+    const logLevel = resolveLogLevel(config.logLevel);
     const configValue = {
       ...runtimeConfig,
       schema: config.schema,
+      logLevel,
       onSyncError: config.onSyncError,
       onRemoved: config.onRemoved,
       onMembersChanged: config.onMembersChanged
     };
-    const configLayer = Layer9.succeed(Config, configValue);
-    const fullLayer = TablinumLive.pipe(Layer9.provide(configLayer));
-    const ctx = yield* Layer9.build(fullLayer);
+    const configLayer = Layer10.succeed(Config, configValue);
+    const logLayer = Layer10.succeed(References4.MinimumLogLevel, logLevel);
+    const fullLayer = TablinumLive.pipe(Layer10.provide(configLayer), Layer10.provide(logLayer));
+    const ctx = yield* Layer10.build(fullLayer);
     return ServiceMap10.get(ctx, Tablinum);
   });
 }
+
+// src/index.ts
+import { LogLevel } from "effect";
+
 // src/db/invite.ts
 import { Schema as Schema7 } from "effect";
 var InviteSchema = Schema7.Struct({
@@ -2728,6 +2783,7 @@ export {
   StorageError,
   RelayError,
   NotFoundError,
+  LogLevel,
   EpochId,
   DatabaseName,
   CryptoError,

package/dist/services/Config.d.ts

@@ -1,8 +1,10 @@
 import { ServiceMap } from "effect";
+import type { LogLevel } from "effect";
 import type { ResolvedRuntimeConfig } from "../db/runtime-config.ts";
 import type { SchemaConfig } from "../schema/types.ts";
 export interface TablinumConfigShape extends ResolvedRuntimeConfig {
     readonly schema: SchemaConfig;
+    readonly logLevel: LogLevel.LogLevel;
     readonly onSyncError?: ((error: Error) => void) | undefined;
     readonly onRemoved?: ((info: {
         epochId: string;

package/dist/svelte/collection.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { LogLevel } from "effect";
 import type { CollectionDef, CollectionFields } from "../schema/collection.ts";
 import type { InferRecord } from "../schema/types.ts";
 import type { CollectionHandle } from "../crud/collection-handle.ts";
@@ -6,7 +7,7 @@ export declare class Collection<C extends CollectionDef<CollectionFields>> {
     #private;
     error: Error | null;
     /** @internal */
-    _bind(handle: CollectionHandle<C>): void;
+    _bind(handle: CollectionHandle<C>, logLevel?: LogLevel.LogLevel): void;
     /** @internal */
     _fail(err: Error): void;
     add: (data: Omit<InferRecord<C>, "id">) => Promise<string>;

package/dist/svelte/index.svelte.js

@@ -217,10 +217,10 @@ class NotFoundError extends Data.TaggedError("NotFoundError") {
 class ClosedError extends Data.TaggedError("ClosedError") {
 }
 // src/svelte/tablinum.svelte.ts
-import { Effect as Effect25, Exit as Exit2, Scope as Scope6 } from "effect";
+import { Effect as Effect25, Exit as Exit2, References as References6, Scope as Scope6 } from "effect";
 
 // src/db/create-tablinum.ts
-import { Effect as Effect22, Layer as Layer9, ServiceMap as ServiceMap10 } from "effect";
+import { Effect as Effect22, Layer as Layer10, References as References4, ServiceMap as ServiceMap10 } from "effect";
 
 // src/db/runtime-config.ts
 import { Effect, Schema as Schema3 } from "effect";
@@ -255,7 +255,7 @@ class Tablinum extends ServiceMap2.Service()("tablinum/Tablinum") {
 }
 
 // src/layers/TablinumLive.ts
-import { Effect as Effect21, Exit, Layer as Layer8, Option as Option9, PubSub as PubSub2, Ref as Ref5, Scope as Scope4 } from "effect";
+import { Effect as Effect21, Exit, Layer as Layer9, Option as Option9, PubSub as PubSub2, References as References3, Ref as Ref5, Scope as Scope4 } from "effect";
 
 // src/crud/watch.ts
 import { Effect as Effect2, PubSub, Ref, Stream } from "effect";
@@ -469,7 +469,7 @@ function buildPartialValidator(collectionName, def) {
 }
 
 // src/crud/collection-handle.ts
-import { Effect as Effect6, Option as Option3 } from "effect";
+import { Effect as Effect6, Option as Option3, References } from "effect";
 
 // src/utils/uuid.ts
 var alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
@@ -717,8 +717,9 @@ function mapRecord(record) {
   const { _d, _u, _a, _e, ...fields } = record;
   return fields;
 }
-function createCollectionHandle(def, storage, watchCtx, validator, partialValidator, makeEventId, localAuthor, onWrite) {
+function createCollectionHandle(def, storage, watchCtx, validator, partialValidator, makeEventId, localAuthor, onWrite, logLevel = "None") {
   const collectionName = def.name;
+  const withLog = (effect) => Effect6.provideService(effect, References.MinimumLogLevel, logLevel);
   const commitEvent = (event) => Effect6.gen(function* () {
     yield* storage.putEvent(event);
     yield* applyEvent(storage, event);
@@ -731,7 +732,7 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
     });
   });
   const handle = {
-    add: (data) => Effect6.gen(function* () {
+    add: (data) => withLog(Effect6.gen(function* () {
       const id = uuidv7();
       const fullRecord = { id, ...data };
       yield* validator(fullRecord);
@@ -745,9 +746,10 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
         author: localAuthor
       };
       yield* commitEvent(event);
+      yield* Effect6.logDebug("Record added", { collection: collectionName, recordId: id, data: fullRecord });
       return id;
-    }),
-    update: (id, data) => Effect6.gen(function* () {
+    })),
+    update: (id, data) => withLog(Effect6.gen(function* () {
       const existing = yield* storage.getRecord(collectionName, id);
       if (!existing || existing._d) {
         return yield* new NotFoundError({
@@ -770,9 +772,10 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
         author: localAuthor
       };
       yield* commitEvent(event);
+      yield* Effect6.logDebug("Record updated", { collection: collectionName, recordId: id, data: diff });
       yield* pruneEvents(storage, collectionName, id, def.eventRetention);
-    }),
-    delete: (id) => Effect6.gen(function* () {
+    })),
+    delete: (id) => withLog(Effect6.gen(function* () {
       const existing = yield* storage.getRecord(collectionName, id);
       if (!existing || existing._d) {
         return yield* new NotFoundError({
@@ -790,8 +793,9 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
         author: localAuthor
       };
       yield* commitEvent(event);
+      yield* Effect6.logDebug("Record deleted", { collection: collectionName, recordId: id });
       yield* pruneEvents(storage, collectionName, id, def.eventRetention);
-    }),
+    })),
     undo: (id) => Effect6.gen(function* () {
       const existing = yield* storage.getRecord(collectionName, id);
       if (!existing) {
@@ -840,7 +844,7 @@ function createCollectionHandle(def, storage, watchCtx, validator, partialValida
 }
 
 // src/sync/sync-service.ts
-import { Effect as Effect8, Option as Option5, Ref as Ref3, Schedule } from "effect";
+import { Effect as Effect8, Layer, Option as Option5, References as References2, Ref as Ref3, Schedule } from "effect";
 import { unwrapEvent } from "nostr-tools/nip59";
 import { GiftWrap as GiftWrap2 } from "nostr-tools/kinds";
 
@@ -1411,8 +1415,13 @@ function reconcileWithRelay(storage, relay, relayUrl, publicKeys) {
         allNeedIds.push(id);
       currentMsg = nextMsg;
     }
+    yield* Effect7.logDebug("Negentropy reconciliation complete", {
+      relay: relayUrl,
+      have: allHaveIds.length,
+      need: allNeedIds.length
+    });
     return { haveIds: allHaveIds, needIds: allNeedIds };
-  });
+  }).pipe(Effect7.withLogSpan("tablinum.negentropy"));
 }
 
 // src/db/key-rotation.ts
@@ -1498,7 +1507,8 @@ function parseRemovalNotice(content, dTag) {
 }
 
 // src/sync/sync-service.ts
-function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStatus, watchCtx, relayUrls, knownCollections, epochStore, personalPrivateKey, personalPublicKey, scope, onSyncError, onNewAuthor, onRemoved, onMembersChanged) {
+function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStatus, watchCtx, relayUrls, knownCollections, epochStore, personalPrivateKey, personalPublicKey, scope, logLevel, onSyncError, onNewAuthor, onRemoved, onMembersChanged) {
+  const logLayer = Layer.succeed(References2.MinimumLogLevel, logLevel);
   const getSubscriptionPubKeys = () => {
     return getAllPublicKeys(epochStore);
   };
@@ -1508,7 +1518,7 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     kind: "create"
   });
   const forkHandled = (effect) => {
-    Effect8.runFork(effect.pipe(Effect8.tapError((e) => Effect8.sync(() => onSyncError?.(e))), Effect8.ignore, Effect8.forkIn(scope)));
+    Effect8.runFork(effect.pipe(Effect8.tapError((e) => Effect8.sync(() => onSyncError?.(e))), Effect8.ignore, Effect8.provide(logLayer), Effect8.forkIn(scope)));
   };
   let autoFlushActive = false;
   const autoFlushEffect = Effect8.gen(function* () {
@@ -1565,6 +1575,7 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     if (rumor.pubkey) {
       const reject = yield* shouldRejectWrite(rumor.pubkey);
       if (reject) {
+        yield* Effect8.logWarning("Rejected write from removed member", { author: rumor.pubkey.slice(0, 12) });
         yield* storage.putGiftWrap({ id: remoteGw.id, createdAt: remoteGw.created_at });
         return null;
       }
@@ -1607,6 +1618,7 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     if (didApply && (kind === "u" || kind === "d")) {
       yield* pruneEvents(storage, collectionName, recordId, retention);
     }
+    yield* Effect8.logDebug("Processed gift wrap", { collection: collectionName, recordId, kind, author: author?.slice(0, 12) });
     if (author && onNewAuthor) {
       onNewAuthor(author);
     }
@@ -1675,12 +1687,14 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
     }).pipe(Effect8.tapError((err) => Effect8.sync(() => onSyncError?.(err))), Effect8.ignore);
   }), { discard: true });
   const syncRelay = (url, pubKeys, changedCollections) => Effect8.gen(function* () {
+    yield* Effect8.logDebug("Syncing relay", { relay: url });
     const reconcileResult = yield* Effect8.result(reconcileWithRelay(storage, relay, url, Array.from(pubKeys)));
     if (reconcileResult._tag === "Failure") {
       onSyncError?.(reconcileResult.failure);
       return;
     }
     const { haveIds, needIds } = reconcileResult.success;
+    yield* Effect8.logDebug("Relay reconciliation result", { relay: url, need: needIds.length, have: haveIds.length });
     if (needIds.length > 0) {
       const fetched = yield* relay.fetchEvents(needIds, url).pipe(Effect8.tapError((err) => Effect8.sync(() => onSyncError?.(err))), Effect8.orElseSucceed(() => []));
       const sorted = [...fetched].sort((a, b) => a.created_at - b.created_at);
@@ -1698,9 +1712,10 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
         yield* relay.publish(gw.event, [url]).pipe(Effect8.andThen(storage.stripGiftWrapBlob(id)), Effect8.tapError((err) => Effect8.sync(() => onSyncError?.(err))), Effect8.ignore);
       }), { discard: true });
     }
-  });
+  }).pipe(Effect8.withLogSpan("tablinum.syncRelay"));
   const handle = {
     sync: () => Effect8.gen(function* () {
+      yield* Effect8.logInfo("Sync started");
       yield* syncStatus.set("syncing");
       yield* Ref3.set(watchCtx.replayingRef, true);
       const changedCollections = new Set;
@@ -1714,7 +1729,8 @@ function createSyncHandle(storage, giftWrapHandle, relay, publishQueue, syncStat
         yield* notifyReplayComplete(watchCtx, [...changedCollections]);
         yield* syncStatus.set("idle");
       })));
-    }),
+      yield* Effect8.logInfo("Sync complete", { changed: [...changedCollections] });
+    }).pipe(Effect8.withLogSpan("tablinum.sync")),
     publishLocal: (giftWrap) => Effect8.gen(function* () {
       if (!giftWrap.event)
         return;
@@ -1840,7 +1856,7 @@ class SyncStatus extends ServiceMap9.Service()("tablinum/SyncStatus") {
 }
 
 // src/layers/IdentityLive.ts
-import { Effect as Effect11, Layer } from "effect";
+import { Effect as Effect11, Layer as Layer2 } from "effect";
 import { hexToBytes as hexToBytes3 } from "@noble/hashes/utils.js";
 
 // src/db/identity.ts
@@ -1878,21 +1894,25 @@ function createIdentity(suppliedKey) {
 }
 
 // src/layers/IdentityLive.ts
-var IdentityLive = Layer.effect(Identity, Effect11.gen(function* () {
+var IdentityLive = Layer2.effect(Identity, Effect11.gen(function* () {
   const config = yield* Config;
   const storage = yield* Storage;
   const idbKey = yield* storage.getMeta("identity_key");
   const resolvedKey = config.privateKey ?? (typeof idbKey === "string" && idbKey.length === 64 ? hexToBytes3(idbKey) : undefined);
   const identity = yield* createIdentity(resolvedKey);
   yield* storage.putMeta("identity_key", identity.exportKey());
+  yield* Effect11.logInfo("Identity loaded", {
+    publicKey: identity.publicKey.slice(0, 12) + "...",
+    source: config.privateKey ? "config" : resolvedKey ? "storage" : "generated"
+  });
   return identity;
 }));
 
 // src/layers/EpochStoreLive.ts
-import { Effect as Effect12, Layer as Layer2, Option as Option7 } from "effect";
+import { Effect as Effect12, Layer as Layer3, Option as Option7 } from "effect";
 import { generateSecretKey as generateSecretKey2 } from "nostr-tools/pure";
 import { bytesToHex as bytesToHex3 } from "@noble/hashes/utils.js";
-var EpochStoreLive = Layer2.effect(EpochStore, Effect12.gen(function* () {
+var EpochStoreLive = Layer3.effect(EpochStore, Effect12.gen(function* () {
   const config = yield* Config;
   const identity = yield* Identity;
   const storage = yield* Storage;
@@ -1900,21 +1920,24 @@ var EpochStoreLive = Layer2.effect(EpochStore, Effect12.gen(function* () {
   if (typeof idbRaw === "string") {
     const idbStore = deserializeEpochStore(idbRaw);
     if (Option7.isSome(idbStore)) {
+      yield* Effect12.logInfo("Epoch store loaded", { source: "storage", epochs: idbStore.value.epochs.size });
       return idbStore.value;
     }
   }
   if (config.epochKeys && config.epochKeys.length > 0) {
     const store2 = createEpochStoreFromInputs(config.epochKeys);
     yield* storage.putMeta("epochs", stringifyEpochStore(store2));
+    yield* Effect12.logInfo("Epoch store loaded", { source: "config", epochs: store2.epochs.size });
     return store2;
   }
   const store = createEpochStoreFromInputs([{ epochId: EpochId("epoch-0"), key: bytesToHex3(generateSecretKey2()) }], { createdBy: identity.publicKey });
   yield* storage.putMeta("epochs", stringifyEpochStore(store));
+  yield* Effect12.logInfo("Epoch store loaded", { source: "generated", epochs: store.epochs.size });
   return store;
 }));
 
 // src/layers/StorageLive.ts
-import { Effect as Effect14, Layer as Layer3 } from "effect";
+import { Effect as Effect14, Layer as Layer4 } from "effect";
 
 // src/storage/idb.ts
 import { Effect as Effect13 } from "effect";
@@ -2072,16 +2095,18 @@ function openIDBStorage(dbName, schema) {
 }
 
 // src/layers/StorageLive.ts
-var StorageLive = Layer3.effect(Storage, Effect14.gen(function* () {
+var StorageLive = Layer4.effect(Storage, Effect14.gen(function* () {
   const config = yield* Config;
-  return yield* openIDBStorage(config.dbName, {
+  const handle = yield* openIDBStorage(config.dbName, {
     ...config.schema,
     _members: membersCollectionDef
   });
+  yield* Effect14.logInfo("Storage opened", { dbName: config.dbName });
+  return handle;
 }));
 
 // src/layers/RelayLive.ts
-import { Layer as Layer4 } from "effect";
+import { Layer as Layer5 } from "effect";
 
 // src/sync/relay.ts
 import { Effect as Effect15, Option as Option8, Schema as Schema7, ScopedCache, Scope as Scope3 } from "effect";
@@ -2294,10 +2319,10 @@ function createRelayHandle() {
 }
 
 // src/layers/RelayLive.ts
-var RelayLive = Layer4.effect(Relay, createRelayHandle());
+var RelayLive = Layer5.effect(Relay, createRelayHandle());
 
 // src/layers/GiftWrapLive.ts
-import { Effect as Effect17, Layer as Layer5 } from "effect";
+import { Effect as Effect17, Layer as Layer6 } from "effect";
 
 // src/sync/gift-wrap.ts
 import { Effect as Effect16 } from "effect";
@@ -2334,14 +2359,14 @@ function createEpochGiftWrapHandle(senderPrivateKey, epochStore) {
 }
 
 // src/layers/GiftWrapLive.ts
-var GiftWrapLive = Layer5.effect(GiftWrap3, Effect17.gen(function* () {
+var GiftWrapLive = Layer6.effect(GiftWrap3, Effect17.gen(function* () {
   const identity = yield* Identity;
   const epochStore = yield* EpochStore;
   return createEpochGiftWrapHandle(identity.privateKey, epochStore);
 }));
 
 // src/layers/PublishQueueLive.ts
-import { Effect as Effect19, Layer as Layer6 } from "effect";
+import { Effect as Effect19, Layer as Layer7 } from "effect";
 
 // src/sync/publish-queue.ts
 import { Effect as Effect18, Ref as Ref4 } from "effect";
@@ -2415,14 +2440,14 @@ function createPublishQueue(storage, relay) {
 }
 
 // src/layers/PublishQueueLive.ts
-var PublishQueueLive = Layer6.effect(PublishQueue, Effect19.gen(function* () {
+var PublishQueueLive = Layer7.effect(PublishQueue, Effect19.gen(function* () {
   const storage = yield* Storage;
   const relay = yield* Relay;
   return yield* createPublishQueue(storage, relay);
 }));
 
 // src/layers/SyncStatusLive.ts
-import { Layer as Layer7 } from "effect";
+import { Layer as Layer8 } from "effect";
 
 // src/sync/sync-status.ts
 import { Effect as Effect20, SubscriptionRef } from "effect";
@@ -2446,7 +2471,7 @@ function createSyncStatusHandle() {
 }
 
 // src/layers/SyncStatusLive.ts
-var SyncStatusLive = Layer7.effect(SyncStatus, createSyncStatusHandle());
+var SyncStatusLive = Layer8.effect(SyncStatus, createSyncStatusHandle());
 
 // src/layers/TablinumLive.ts
 function reportSyncError(onSyncError, error) {
@@ -2467,12 +2492,12 @@ function mapMemberRecord(record) {
     ...record.removedInEpoch !== undefined ? { removedInEpoch: record.removedInEpoch } : {}
   };
 }
-var IdentityWithDeps = IdentityLive.pipe(Layer8.provide(StorageLive));
-var EpochStoreWithDeps = EpochStoreLive.pipe(Layer8.provide(IdentityWithDeps), Layer8.provide(StorageLive));
-var GiftWrapWithDeps = GiftWrapLive.pipe(Layer8.provide(IdentityWithDeps), Layer8.provide(EpochStoreWithDeps));
-var PublishQueueWithDeps = PublishQueueLive.pipe(Layer8.provide(StorageLive), Layer8.provide(RelayLive));
-var AllServicesLive = Layer8.mergeAll(IdentityWithDeps, EpochStoreWithDeps, StorageLive, RelayLive, GiftWrapWithDeps, PublishQueueWithDeps, SyncStatusLive);
-var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
+var IdentityWithDeps = IdentityLive.pipe(Layer9.provide(StorageLive));
+var EpochStoreWithDeps = EpochStoreLive.pipe(Layer9.provide(IdentityWithDeps), Layer9.provide(StorageLive));
+var GiftWrapWithDeps = GiftWrapLive.pipe(Layer9.provide(IdentityWithDeps), Layer9.provide(EpochStoreWithDeps));
+var PublishQueueWithDeps = PublishQueueLive.pipe(Layer9.provide(StorageLive), Layer9.provide(RelayLive));
+var AllServicesLive = Layer9.mergeAll(IdentityWithDeps, EpochStoreWithDeps, StorageLive, RelayLive, GiftWrapWithDeps, PublishQueueWithDeps, SyncStatusLive);
+var TablinumLive = Layer9.effect(Tablinum, Effect21.gen(function* () {
   const config = yield* Config;
   const identity = yield* Identity;
   const epochStore = yield* EpochStore;
@@ -2482,6 +2507,7 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
   const publishQueue = yield* PublishQueue;
   const syncStatus = yield* SyncStatus;
   const scope = yield* Effect21.scope;
+  const logLayer = Layer9.succeed(References3.MinimumLogLevel, config.logLevel);
   const pubsub = yield* PubSub2.unbounded();
   const replayingRef = yield* Ref5.make(false);
   const closedRef = yield* Ref5.make(false);
@@ -2490,7 +2516,7 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
   const allSchemaEntries = [...schemaEntries, ["_members", membersCollectionDef]];
   const knownCollections = new Map(allSchemaEntries.map(([, def]) => [def.name, def.eventRetention]));
   let notifyAuthor;
-  const syncHandle = createSyncHandle(storage, giftWrap, relay, publishQueue, syncStatus, watchCtx, config.relays, knownCollections, epochStore, identity.privateKey, identity.publicKey, scope, config.onSyncError ? (error) => reportSyncError(config.onSyncError, error) : undefined, (pubkey) => notifyAuthor?.(pubkey), config.onRemoved, config.onMembersChanged);
+  const syncHandle = createSyncHandle(storage, giftWrap, relay, publishQueue, syncStatus, watchCtx, config.relays, knownCollections, epochStore, identity.privateKey, identity.publicKey, scope, config.logLevel, config.onSyncError ? (error) => reportSyncError(config.onSyncError, error) : undefined, (pubkey) => notifyAuthor?.(pubkey), config.onRemoved, config.onMembersChanged);
   const onWrite = (event) => Effect21.gen(function* () {
     const content = event.kind === "d" ? JSON.stringify(null) : JSON.stringify(event.data);
     const dTag = `${event.collection}:${event.recordId}`;
@@ -2568,16 +2594,21 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
           config.onMembersChanged?.();
         }
       }
-    }).pipe(Effect21.ignore, Effect21.forkIn(scope)));
+    }).pipe(Effect21.ignore, Effect21.provide(logLayer), Effect21.forkIn(scope)));
   };
   const handles = new Map;
   for (const [, def] of allSchemaEntries) {
     const validator = buildValidator(def.name, def);
     const partialValidator = buildPartialValidator(def.name, def);
-    const handle = createCollectionHandle(def, storage, watchCtx, validator, partialValidator, uuidv7, identity.publicKey, onWrite);
+    const handle = createCollectionHandle(def, storage, watchCtx, validator, partialValidator, uuidv7, identity.publicKey, onWrite, config.logLevel);
     handles.set(def.name, handle);
   }
   yield* syncHandle.startSubscription();
+  yield* Effect21.logInfo("Tablinum ready", {
+    dbName: config.dbName,
+    collections: schemaEntries.map(([name]) => name),
+    relays: config.relays
+  });
   const selfMember = yield* storage.getRecord("_members", identity.publicKey);
   if (!selfMember) {
     yield* putMemberRecord({
@@ -2586,18 +2617,19 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
       addedInEpoch: getCurrentEpoch(epochStore).id
     });
   }
-  const ensureOpen = (effect) => Effect21.gen(function* () {
+  const withLog = (effect) => Effect21.provideService(effect, References3.MinimumLogLevel, config.logLevel);
+  const ensureOpen = (effect) => withLog(Effect21.gen(function* () {
     if (yield* Ref5.get(closedRef)) {
       return yield* new StorageError({ message: "Database is closed" });
     }
     return yield* effect;
-  });
-  const ensureSyncOpen = (effect) => Effect21.gen(function* () {
+  }));
+  const ensureSyncOpen = (effect) => withLog(Effect21.gen(function* () {
     if (yield* Ref5.get(closedRef)) {
       return yield* new SyncError({ message: "Database is closed", phase: "init" });
     }
     return yield* effect;
-  });
+  }));
   const dbHandle = {
     collection: (name) => {
       const handle = handles.get(name);
@@ -2613,12 +2645,12 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
       relays: [...config.relays],
       dbName: config.dbName
     }),
-    close: () => Effect21.gen(function* () {
+    close: () => withLog(Effect21.gen(function* () {
       if (yield* Ref5.get(closedRef))
         return;
       yield* Ref5.set(closedRef, true);
       yield* Scope4.close(scope, Exit.void);
-    }),
+    })),
     rebuild: () => ensureOpen(rebuild(storage, allSchemaEntries.map(([, def]) => def.name))),
     sync: () => ensureSyncOpen(syncHandle.sync()),
     getSyncStatus: () => syncStatus.get(),
@@ -2689,9 +2721,25 @@ var TablinumLive = Layer8.effect(Tablinum, Effect21.gen(function* () {
     }))
   };
   return dbHandle;
-})).pipe(Layer8.provide(AllServicesLive));
+}).pipe(Effect21.withLogSpan("tablinum.init"))).pipe(Layer9.provide(AllServicesLive));
 
 // src/db/create-tablinum.ts
+function resolveLogLevel(input) {
+  if (input === undefined || input === "none")
+    return "None";
+  switch (input) {
+    case "debug":
+      return "Debug";
+    case "info":
+      return "Info";
+    case "warning":
+      return "Warn";
+    case "error":
+      return "Error";
+    default:
+      return input;
+  }
+}
 function validateConfig(config) {
   return Effect22.gen(function* () {
     if (Object.keys(config.schema).length === 0) {
@@ -2705,22 +2753,25 @@ function createTablinum(config) {
   return Effect22.gen(function* () {
     yield* validateConfig(config);
     const runtimeConfig = yield* resolveRuntimeConfig(config);
+    const logLevel = resolveLogLevel(config.logLevel);
     const configValue = {
       ...runtimeConfig,
       schema: config.schema,
+      logLevel,
       onSyncError: config.onSyncError,
       onRemoved: config.onRemoved,
       onMembersChanged: config.onMembersChanged
     };
-    const configLayer = Layer9.succeed(Config, configValue);
-    const fullLayer = TablinumLive.pipe(Layer9.provide(configLayer));
-    const ctx = yield* Layer9.build(fullLayer);
+    const configLayer = Layer10.succeed(Config, configValue);
+    const logLayer = Layer10.succeed(References4.MinimumLogLevel, logLevel);
+    const fullLayer = TablinumLive.pipe(Layer10.provide(configLayer), Layer10.provide(logLayer));
+    const ctx = yield* Layer10.build(fullLayer);
     return ServiceMap10.get(ctx, Tablinum);
   });
 }
 
 // src/svelte/collection.svelte.ts
-import { Effect as Effect24, Fiber, Option as Option11, Stream as Stream4 } from "effect";
+import { Effect as Effect24, Fiber, Option as Option11, References as References5, Stream as Stream4 } from "effect";
 
 // src/svelte/deferred.ts
 function createDeferred() {
@@ -2813,10 +2864,12 @@ class Collection {
   #version = $state(0);
   #watchAbort = null;
   #watchFiber = null;
-  _bind(handle) {
+  #logLevel = "None";
+  _bind(handle, logLevel = "None") {
     if (this.#handle)
       return;
     this.#handle = handle;
+    this.#logLevel = logLevel;
     this.error = null;
     this.#settleReady();
     this.#startWatch();
@@ -2845,7 +2898,7 @@ class Collection {
       if (!abort.signal.aborted) {
         this.error = e instanceof Error ? e : new Error(String(e));
       }
-    }))));
+    })), Effect24.provideService(References5.MinimumLogLevel, this.#logLevel)));
   }
   #touchVersion = () => {
     this.#version;
@@ -2857,7 +2910,7 @@ class Collection {
   };
   #run = async (getEffect) => {
     await this.#ready.promise;
-    return Effect24.runPromise(getEffect());
+    return Effect24.runPromise(getEffect().pipe(Effect24.provideService(References5.MinimumLogLevel, this.#logLevel)));
   };
   add = (data) => {
     return this.#run(() => this.#handleOrThrow().add(data));
@@ -2924,8 +2977,10 @@ class Tablinum2 {
   #unsubscribeRelayStatus = null;
   #closed = false;
   #readyState = createDeferred();
+  #logLevel;
   constructor(config) {
     this.ready = this.#readyState.promise;
+    this.#logLevel = resolveLogLevel(config.logLevel);
     this.#init(config);
   }
   #settleReady(err) {
@@ -2936,16 +2991,16 @@ class Tablinum2 {
     }
   }
   #bindCollections(handle) {
-    this.#members._bind(handle.members);
+    this.#members._bind(handle.members, this.#logLevel);
     for (const [name, collection2] of this.#collections) {
-      collection2._bind(handle.collection(name));
+      collection2._bind(handle.collection(name), this.#logLevel);
     }
   }
   #runHandleEffect = async (run) => {
     const handle = this.#requireReady();
     try {
       this.error = null;
-      return await Effect25.runPromise(run(handle));
+      return await Effect25.runPromise(run(handle).pipe(Effect25.provideService(References6.MinimumLogLevel, this.#logLevel)));
     } catch (e) {
       this.error = e instanceof Error ? e : new Error(String(e));
       throw this.error;
@@ -3003,7 +3058,7 @@ class Tablinum2 {
       col = new Collection;
       this.#collections.set(name, col);
       if (this.#handle) {
-        col._bind(this.#handle.collection(name));
+        col._bind(this.#handle.collection(name), this.#logLevel);
       }
     }
     return col;

package/dist/sync/sync-service.d.ts

@@ -1,4 +1,5 @@
 import { Effect, Scope } from "effect";
+import type { LogLevel } from "effect";
 import type { IDBStorageHandle, StoredGiftWrap } from "../storage/idb.ts";
 import type { GiftWrapHandle } from "./gift-wrap.ts";
 import type { RelayHandle } from "./relay.ts";
@@ -14,4 +15,4 @@ export interface SyncHandle {
     readonly startSubscription: () => Effect.Effect<void>;
     readonly addEpochSubscription: (publicKey: string) => Effect.Effect<void>;
 }
-export declare function createSyncHandle(storage: IDBStorageHandle, giftWrapHandle: GiftWrapHandle, relay: RelayHandle, publishQueue: PublishQueueHandle, syncStatus: SyncStatusHandle, watchCtx: WatchContext, relayUrls: readonly string[], knownCollections: ReadonlyMap<string, number>, epochStore: EpochStore, personalPrivateKey: Uint8Array, personalPublicKey: string, scope: Scope.Scope, onSyncError?: ((error: unknown) => void) | undefined, onNewAuthor?: ((pubkey: string) => void) | undefined, onRemoved?: ((notice: RemovalNotice) => void) | undefined, onMembersChanged?: (() => void) | undefined): SyncHandle;
+export declare function createSyncHandle(storage: IDBStorageHandle, giftWrapHandle: GiftWrapHandle, relay: RelayHandle, publishQueue: PublishQueueHandle, syncStatus: SyncStatusHandle, watchCtx: WatchContext, relayUrls: readonly string[], knownCollections: ReadonlyMap<string, number>, epochStore: EpochStore, personalPrivateKey: Uint8Array, personalPublicKey: string, scope: Scope.Scope, logLevel: LogLevel.LogLevel, onSyncError?: ((error: unknown) => void) | undefined, onNewAuthor?: ((pubkey: string) => void) | undefined, onRemoved?: ((notice: RemovalNotice) => void) | undefined, onMembersChanged?: (() => void) | undefined): SyncHandle;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tablinum",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kevmodrome/tablinum.git"