trashlytics 0.1.0 → 0.1.1

package/README.md

@@ -28,8 +28,14 @@ yarn add trashlytics effect
 ```typescript
 import { createTracker, TransportError } from "trashlytics"
 
-// 1. Create a tracker with your transport
-const tracker = createTracker({
+// 1. Define your event types
+type MyEvents = {
+  page_view: { page: string; referrer?: string }
+  button_click: { buttonId: string }
+}
+
+// 2. Create a typed tracker with your transport
+const tracker = createTracker<MyEvents>({
   transports: [{
     name: "http",
     send: async (events) => {
@@ -51,18 +57,18 @@ const tracker = createTracker({
   flushIntervalMs: 5000,
 })
 
-// 2. Track events (fire-and-forget)
+// 3. Track events with full type safety (fire-and-forget)
 tracker.track("page_view", { page: "/home" })
 tracker.track("button_click", { buttonId: "signup" })
 
-// 3. Graceful shutdown when done
+// 4. Graceful shutdown when done
 await tracker.shutdown()
 ```
 
 ## Configuration
 
 ```typescript
-import { createTracker } from "trashlytics"
+import { createTracker, consoleLogger, noopLogger } from "trashlytics"
 
 const tracker = createTracker({
   // Required: array of transports
@@ -92,6 +98,9 @@ const tracker = createTracker({
     environment: "production",
   },
 
+  // Logging (default: consoleLogger)
+  logger: consoleLogger,      // Use noopLogger to silence output
+
   // Error Callback (called after all retries exhausted)
   onError: (error, events) => {
     console.error(`Failed to send ${events.length} events:`, error.message)
@@ -275,6 +284,54 @@ class TransportError extends Error {
 }
 ```
 
+### Logger
+
+```typescript
+interface Logger {
+  debug: (message: string, ...args: unknown[]) => void
+  info: (message: string, ...args: unknown[]) => void
+  warn: (message: string, ...args: unknown[]) => void
+  error: (message: string, ...args: unknown[]) => void
+}
+```
+
+## Custom Logging
+
+Control library logging output:
+
+```typescript
+import { createTracker, consoleLogger, noopLogger, createMinLevelLogger } from "trashlytics"
+
+// Default: logs to console
+const tracker = createTracker({
+  transports,
+  logger: consoleLogger,
+})
+
+// Silence all logging
+const silentTracker = createTracker({
+  transports,
+  logger: noopLogger,
+})
+
+// Only log warnings and errors
+const warnTracker = createTracker({
+  transports,
+  logger: createMinLevelLogger("warn"),
+})
+
+// Custom logger integration
+const customTracker = createTracker({
+  transports,
+  logger: {
+    debug: (msg, ...args) => myLogger.debug("[analytics]", msg, ...args),
+    info: (msg, ...args) => myLogger.info("[analytics]", msg, ...args),
+    warn: (msg, ...args) => myLogger.warn("[analytics]", msg, ...args),
+    error: (msg, ...args) => myLogger.error("[analytics]", msg, ...args),
+  },
+})
+```
+
 ## Browser Tips
 
 ### Beacon API Transport

package/dist/index.cjs

@@ -422,14 +422,15 @@ const createRuntime = (config, _generateId, _globalMetadata) => {
 		if (events.length === 0) return;
 		const results = await Promise.allSettled(config.transports.map((transport) => dispatchToTransport(transport, events, retrySchedule)));
 		for (const result of results) if (result.status === "rejected") {
-			const error = result.reason;
+			const error = extractTransportError(result.reason);
 			if (config.onError) config.onError(error, events);
 			config.logger.error("Transport failed:", error.message);
 		}
 	};
 	const batchLoop = effect.Effect.gen(function* () {
 		yield* effect.Effect.forever(effect.Effect.gen(function* () {
-			const events = yield* effect.Effect.race(effect.Queue.takeBetween(queue, config.batchSize, config.batchSize), effect.Effect.sleep(effect.Duration.millis(config.flushIntervalMs)).pipe(effect.Effect.zipRight(effect.Queue.takeUpTo(queue, config.batchSize))));
+			yield* effect.Effect.sleep(effect.Duration.millis(config.flushIntervalMs));
+			const events = yield* effect.Queue.takeUpTo(queue, config.batchSize);
 			if (events.length > 0) yield* effect.Effect.tryPromise({
 				try: () => dispatch([...events]),
 				catch: () => /* @__PURE__ */ new Error("Dispatch failed")
@@ -439,7 +440,7 @@ const createRuntime = (config, _generateId, _globalMetadata) => {
 	const batchFiber = effect.Effect.runFork(batchLoop.pipe(effect.Effect.provideService(effect.Scope.Scope, scope)));
 	return {
 		offer: (event) => {
-			effect.Effect.runFork(effect.Queue.offer(queue, event));
+			effect.Queue.unsafeOffer(queue, event);
 		},
 		offerAsync: (event) => effect.Effect.runPromise(effect.Queue.offer(queue, event)).then(() => void 0),
 		flush: async () => {
@@ -479,6 +480,19 @@ const dispatchToTransport = async (transport, events, retrySchedule) => {
 	}));
 	await effect.Effect.runPromise(effect$1);
 };
+const FiberFailureCauseSymbol = Symbol.for("effect/Runtime/FiberFailure/Cause");
+const extractTransportError = (reason) => {
+	if (reason instanceof TransportError) return reason;
+	if (reason && typeof reason === "object") {
+		const cause = reason[FiberFailureCauseSymbol];
+		if (cause?.error instanceof TransportError) return cause.error;
+	}
+	return new TransportError({
+		transport: "unknown",
+		reason: String(reason),
+		retryable: false
+	});
+};
 
 //#endregion
 exports.TransportError = TransportError;

package/dist/index.js

@@ -422,14 +422,15 @@ const createRuntime = (config, _generateId, _globalMetadata) => {
 		if (events.length === 0) return;
 		const results = await Promise.allSettled(config.transports.map((transport) => dispatchToTransport(transport, events, retrySchedule)));
 		for (const result of results) if (result.status === "rejected") {
-			const error = result.reason;
+			const error = extractTransportError(result.reason);
 			if (config.onError) config.onError(error, events);
 			config.logger.error("Transport failed:", error.message);
 		}
 	};
 	const batchLoop = Effect.gen(function* () {
 		yield* Effect.forever(Effect.gen(function* () {
-			const events = yield* Effect.race(Queue.takeBetween(queue, config.batchSize, config.batchSize), Effect.sleep(Duration.millis(config.flushIntervalMs)).pipe(Effect.zipRight(Queue.takeUpTo(queue, config.batchSize))));
+			yield* Effect.sleep(Duration.millis(config.flushIntervalMs));
+			const events = yield* Queue.takeUpTo(queue, config.batchSize);
 			if (events.length > 0) yield* Effect.tryPromise({
 				try: () => dispatch([...events]),
 				catch: () => /* @__PURE__ */ new Error("Dispatch failed")
@@ -439,7 +440,7 @@ const createRuntime = (config, _generateId, _globalMetadata) => {
 	const batchFiber = Effect.runFork(batchLoop.pipe(Effect.provideService(Scope.Scope, scope)));
 	return {
 		offer: (event) => {
-			Effect.runFork(Queue.offer(queue, event));
+			Queue.unsafeOffer(queue, event);
 		},
 		offerAsync: (event) => Effect.runPromise(Queue.offer(queue, event)).then(() => void 0),
 		flush: async () => {
@@ -479,6 +480,19 @@ const dispatchToTransport = async (transport, events, retrySchedule) => {
 	}));
 	await Effect.runPromise(effect);
 };
+const FiberFailureCauseSymbol = Symbol.for("effect/Runtime/FiberFailure/Cause");
+const extractTransportError = (reason) => {
+	if (reason instanceof TransportError) return reason;
+	if (reason && typeof reason === "object") {
+		const cause = reason[FiberFailureCauseSymbol];
+		if (cause?.error instanceof TransportError) return cause.error;
+	}
+	return new TransportError({
+		transport: "unknown",
+		reason: String(reason),
+		retryable: false
+	});
+};
 
 //#endregion
 export { TransportError, addMetadata, addMetadataFrom, compose, consoleLogger, createEvent, createMinLevelLogger, createTracker, defaults, filter, identity, map, mapName, mapPayload, noopLogger, resolveConfig, tap };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "trashlytics",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A lightweight event tracking library",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -51,6 +51,7 @@
     "@total-typescript/ts-reset": "0.6.1",
     "@types/node": "25.0.3",
     "rolldown": "1.0.0-beta.57",
+    "tsx": "4.21.0",
     "typescript": "5.9.3",
     "ultracite": "6.5.0",
     "vitest": "4.0.16"