@loglayer/transport-posthog 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Theo Gravity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# PostHog Transport for LogLayer
+
+[![NPM Version](https://img.shields.io/npm/v/%40loglayer%2Ftransport-posthog)](https://www.npmjs.com/package/@loglayer/transport-posthog)
+[![NPM Downloads](https://img.shields.io/npm/dm/%40loglayer%2Ftransport-posthog)](https://www.npmjs.com/package/@loglayer/transport-posthog)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
+
+The PostHog transport for the [LogLayer](https://loglayer.dev) logging library.
+
+[posthog-js](https://posthog.com/docs/logs/installation/javascript) is PostHog's official JavaScript logging SDK.
+
+## Installation
+
+```bash
+npm install loglayer @loglayer/transport-posthog posthog-js serialize-error
+```
+
+## Usage
+
+```typescript
+import { posthog } from 'posthog-js'
+import { serializeError } from 'serialize-error'
+import { LogLayer } from 'loglayer'
+import { PosthogTransport } from "@loglayer/transport-posthog"
+
+// Initialize PostHog with logs configuration
+posthog.init('<ph_project_token>', {
+  api_host: 'https://us.i.posthog.com',
+  defaults: '2026-01-30',
+  logs: {
+    serviceName: 'my-app',
+    environment: 'production',
+  },
+})
+
+const log = new LogLayer({
+  transport: new PosthogTransport({
+    logger: posthog,
+  }),
+  errorSerializer: serializeError,
+})
+
+log.info('hello from LogLayer')
+log.withMetadata({ order_id: 'ord_123' }).info('checkout completed')
+```
+
+## Documentation
+
+For more details, visit [https://loglayer.dev/transports/posthog](https://loglayer.dev/transports/posthog)

package/dist/index.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _loglayer_transport = require("@loglayer/transport");
+//#region src/PosthogTransport.ts
+/**
+* Transport that sends logs to PostHog via the posthog-js SDK's structured logger.
+*
+* Requires an initialized PostHog client instance with the `logs` configuration set.
+*
+* @see {@link https://posthog.com/docs/logs/installation/javascript}
+*/
+var PosthogTransport = class extends _loglayer_transport.BaseTransport {
+	shipToLogger(params) {
+		const { logLevel, messages, data, hasData } = params;
+		const message = messages.join(" ");
+		const logger = this.logger.logger;
+		const method = logLevel;
+		if (hasData && data) logger[method](message, data);
+		else logger[method](message);
+		return messages;
+	}
+};
+//#endregion
+exports.PosthogTransport = PosthogTransport;

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import { BaseTransport, LogLayerTransportParams } from "@loglayer/transport";
+import { PostHog } from "posthog-js";
+
+//#region src/PosthogTransport.d.ts
+/**
+ * Transport that sends logs to PostHog via the posthog-js SDK's structured logger.
+ *
+ * Requires an initialized PostHog client instance with the `logs` configuration set.
+ *
+ * @see {@link https://posthog.com/docs/logs/installation/javascript}
+ */
+declare class PosthogTransport extends BaseTransport<PostHog> {
+  shipToLogger(params: LogLayerTransportParams): any[];
+}
+//#endregion
+export { PosthogTransport };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { BaseTransport, LogLayerTransportParams } from "@loglayer/transport";
+import { PostHog } from "posthog-js";
+
+//#region src/PosthogTransport.d.ts
+/**
+ * Transport that sends logs to PostHog via the posthog-js SDK's structured logger.
+ *
+ * Requires an initialized PostHog client instance with the `logs` configuration set.
+ *
+ * @see {@link https://posthog.com/docs/logs/installation/javascript}
+ */
+declare class PosthogTransport extends BaseTransport<PostHog> {
+  shipToLogger(params: LogLayerTransportParams): any[];
+}
+//#endregion
+export { PosthogTransport };

package/dist/index.js

@@ -0,0 +1,22 @@
+import { BaseTransport } from "@loglayer/transport";
+//#region src/PosthogTransport.ts
+/**
+* Transport that sends logs to PostHog via the posthog-js SDK's structured logger.
+*
+* Requires an initialized PostHog client instance with the `logs` configuration set.
+*
+* @see {@link https://posthog.com/docs/logs/installation/javascript}
+*/
+var PosthogTransport = class extends BaseTransport {
+	shipToLogger(params) {
+		const { logLevel, messages, data, hasData } = params;
+		const message = messages.join(" ");
+		const logger = this.logger.logger;
+		const method = logLevel;
+		if (hasData && data) logger[method](message, data);
+		else logger[method](message);
+		return messages;
+	}
+};
+//#endregion
+export { PosthogTransport };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@loglayer/transport-posthog",
+  "description": "PostHog transport for the LogLayer logging library.",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loglayer/loglayer.git",
+    "directory": "packages/transports/posthog"
+  },
+  "author": "Theo Gravity <theo@suteki.nu>",
+  "keywords": [
+    "logging",
+    "log",
+    "loglayer",
+    "posthog",
+    "posthog logs",
+    "browser",
+    "transport"
+  ],
+  "scripts": {
+    "build": "tsdown src/index.ts",
+    "test": "vitest --run",
+    "clean": "rm -rf .turbo node_modules dist",
+    "lint": "biome check --no-errors-on-unmatched --write --unsafe src",
+    "lint:staged": "biome check --no-errors-on-unmatched --write --unsafe --staged src",
+    "verify-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@loglayer/transport": "workspace:*"
+  },
+  "devDependencies": {
+    "@internal/tsconfig": "workspace:*",
+    "@types/node": "25.9.1",
+    "global-jsdom": "29.0.0",
+    "loglayer": "workspace:*",
+    "posthog-js": "1.376.4",
+    "serialize-error": "13.0.1",
+    "tsdown": "0.22.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.7"
+  },
+  "peerDependencies": {
+    "posthog-js": ">=1.368.0"
+  },
+  "bugs": "https://github.com/loglayer/loglayer/issues",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://loglayer.dev",
+  "packageManager": "pnpm@10.20.0"
+}