@geonosis/observability 1.0.0

package/dist/posthog/index.d.ts

@@ -0,0 +1,58 @@
+import { Result } from 'better-result';
+import { b as SinkFailure, E as ErrorSink, A as Attributes } from '../ports-Ct5eq-HS.js';
+
+/**
+ * The PostHog adapter.
+ *
+ * `posthog-node` is never imported here. The consumer passes a factory that builds a client for one
+ * batch — which is during.day's own shape (`new PostHog(key, { host, flushAt: events.length,
+ * flushInterval: 0 })`, every event pushed, then `shutdown()`) — and it keeps this package at zero
+ * runtime dependencies, keeps the key and the host out of it entirely, and makes the whole adapter
+ * drivable against a stub server without a network.
+ *
+ * `flushInterval: 0` in that line is load-bearing and belongs in the consumer's factory: there is no
+ * long-lived process in workerd to run a background timer in, and a timer left running is an
+ * isolate that will not shut down.
+ */
+type PostHogLike = {
+    captureException: (error: unknown, distinctId?: string, properties?: Record<string, unknown>, uuid?: string) => void;
+    /**
+     * The ONLY place `posthog-node` tells anyone a batch did not land. Measured against 5.50.0:
+     * `shutdown()` resolves over a server that answered 500 and over a port nobody is listening on,
+     * and the failure arrives here instead. during.day's sink awaits `shutdown()` and returns
+     * `events.length`, so it reports "5 sent" having sent none.
+     */
+    on: (event: 'error', handler: (error: unknown) => void) => unknown;
+    shutdown: () => Promise<void>;
+};
+type FlushHandle = {
+    /** How many reports this handle will send. Read it BEFORE awaiting; the buffer is already taken. */
+    readonly pending: number;
+    /** The promise a host hands to `waitUntil`. It resolves, always — a report is never the failure. */
+    readonly promise: Promise<Result<void, SinkFailure>>;
+};
+type PostHogSink = ErrorSink & {
+    /**
+     * Take what is buffered and start sending it. `ctx.waitUntil(sink.flushable().promise)` is the
+     * whole workerd story: the response is not held for the flush, the isolate is not killed before it
+     * lands, and `pending` lets a caller skip the call entirely when there is nothing to send.
+     */
+    flushable: () => FlushHandle;
+};
+type PostHogSinkOptions = {
+    /**
+     * The group key the tenant is filed under. `organization` is during.day's, and it is a DEFAULT,
+     * never a fact: an adapter that hardcoded one repo's group key could not be shared.
+     */
+    groupName?: string;
+    /** Who the report is attributed to. Default: the actor, else the tenant, else the service. */
+    identityOf?: (attributes: Attributes) => string;
+    /**
+     * A client for ONE batch, sized to it. during.day's line, verbatim:
+     * `(size) => new PostHog(key, { host, flushAt: size, flushInterval: 0 })`.
+     */
+    newClient: (batchSize: number) => PostHogLike;
+};
+declare const createPostHogSink: ({ groupName, identityOf, newClient, }: PostHogSinkOptions) => PostHogSink;
+
+export { type FlushHandle, type PostHogLike, type PostHogSink, type PostHogSinkOptions, createPostHogSink };

package/dist/posthog/index.js

@@ -0,0 +1,7 @@
+import {
+  createPostHogSink
+} from "../chunk-EJS3A3ZV.js";
+import "../chunk-2ZTQU3OO.js";
+export {
+  createPostHogSink
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@geonosis/observability",
+  "version": "1.0.0",
+  "description": "Ports whose answer can say failed: an ErrorSink and a Tracer returning Result, one attribute vocabulary (tenant as a group id, never a person), a memory sink, envelope-id dedupe, a PostHog adapter, a tiered health registry, and a probe that plants an error and names the trace id it arrived as.",
+  "keywords": [
+    "observability",
+    "error-tracking",
+    "health-check",
+    "posthog",
+    "tracing",
+    "result",
+    "workers"
+  ],
+  "homepage": "https://github.com/microcompanies/geonosis/tree/main/packages/observability",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/microcompanies/geonosis.git",
+    "directory": "packages/observability"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./health": "./dist/health/index.js",
+    "./posthog": "./dist/posthog/index.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "peerDependencies": {
+    "better-result": "^3.0.0",
+    "posthog-node": ">=5.49.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "posthog-node": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "better-result": "3.0.1",
+    "posthog-node": "5.50.0",
+    "zod": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "geonosis-observability": "bin/geonosis-observability.mjs"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}