@aamini/lib 0.0.1

package/dist/env.d.mts

@@ -0,0 +1,7 @@
+import { ZodTypeAny, z } from "zod";
+
+//#region src/env.d.ts
+declare function createEnv<T extends ZodTypeAny>(schema: T): z.infer<T>;
+//#endregion
+export { createEnv };
+//# sourceMappingURL=env.d.mts.map

package/dist/env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.mts","names":[],"sources":["../src/env.ts"],"mappings":";;;iBAGgB,SAAA,WAAoB,UAAA,CAAA,CAAY,MAAA,EAAQ,CAAA,GAAI,CAAA,CAAE,KAAA,CAAM,CAAA"}

package/dist/env.mjs

@@ -0,0 +1,27 @@
+import { config } from "dotenv";
+//#region src/env.ts
+function createEnv(schema) {
+	const rawEnvironmentName = process.env.RAILWAY_ENVIRONMENT_NAME ?? process.env.NODE_ENV ?? "development";
+	const environmentName = /(?:^|-)pr-\d+$/.test(rawEnvironmentName) ? "staging" : rawEnvironmentName;
+	const fileEnvironment = {};
+	config({
+		path: [
+			`.env.${environmentName}`,
+			".env",
+			`.env.${environmentName}.local`,
+			".env.local"
+		],
+		quiet: true,
+		override: true,
+		processEnv: fileEnvironment
+	});
+	for (const [key, value] of Object.entries(fileEnvironment)) process.env[key] ??= value;
+	return schema.parse({
+		...process.env,
+		...fileEnvironment
+	});
+}
+//#endregion
+export { createEnv };
+
+//# sourceMappingURL=env.mjs.map

package/dist/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","names":[],"sources":["../src/env.ts"],"sourcesContent":["import { config } from 'dotenv'\nimport type { ZodTypeAny, z } from 'zod'\n\nexport function createEnv<T extends ZodTypeAny>(schema: T): z.infer<T> {\n\tconst rawEnvironmentName =\n\t\tprocess.env.RAILWAY_ENVIRONMENT_NAME ??\n\t\tprocess.env.NODE_ENV ??\n\t\t'development'\n\tconst environmentName = /(?:^|-)pr-\\d+$/.test(rawEnvironmentName)\n\t\t? 'staging'\n\t\t: rawEnvironmentName\n\tconst fileEnvironment: Record<string, string> = {}\n\n\tconfig({\n\t\tpath: [\n\t\t\t`.env.${environmentName}`,\n\t\t\t'.env',\n\t\t\t`.env.${environmentName}.local`,\n\t\t\t'.env.local',\n\t\t],\n\t\tquiet: true,\n\t\toverride: true,\n\t\tprocessEnv: fileEnvironment,\n\t})\n\n\tfor (const [key, value] of Object.entries(fileEnvironment)) {\n\t\tprocess.env[key] ??= value\n\t}\n\n\treturn schema.parse({ ...process.env, ...fileEnvironment })\n}\n"],"mappings":";;AAGA,SAAgB,UAAgC,QAAuB;CACtE,MAAM,qBACL,QAAQ,IAAI,4BACZ,QAAQ,IAAI,YACZ;CACD,MAAM,kBAAkB,iBAAiB,KAAK,mBAAmB,GAC9D,YACA;CACH,MAAM,kBAA0C,EAAE;CAElD,OAAO;EACN,MAAM;GACL,QAAQ;GACR;GACA,QAAQ,gBAAgB;GACxB;GACA;EACD,OAAO;EACP,UAAU;EACV,YAAY;EACZ,CAAC;CAEF,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,gBAAgB,EACzD,QAAQ,IAAI,SAAS;CAGtB,OAAO,OAAO,MAAM;EAAE,GAAG,QAAQ;EAAK,GAAG;EAAiB,CAAC"}

package/dist/posthog-proxy.d.mts

@@ -0,0 +1,10 @@
+//#region src/posthog-proxy.d.ts
+type PostHogProxyOptions = {
+  publicPathPrefix: string;
+  upstreamOrigin: string;
+  upstreamPathPrefix?: string;
+};
+declare function createPostHogProxyRequestHandler(options: PostHogProxyOptions): (request: Request) => Promise<Response>;
+//#endregion
+export { createPostHogProxyRequestHandler };
+//# sourceMappingURL=posthog-proxy.d.mts.map

package/dist/posthog-proxy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-proxy.d.mts","names":[],"sources":["../src/posthog-proxy.ts"],"mappings":";KAAK,mBAAA;EACJ,gBAAA;EACA,cAAA;EACA,kBAAA;AAAA;AAAA,iBAce,gCAAA,CAAiC,OAAA,EAAS,mBAAA,IACf,OAAA,EAAS,OAAA,KAAO,OAAA,CAAA,QAAA"}

package/dist/posthog-proxy.mjs

@@ -0,0 +1,58 @@
+//#region src/posthog-proxy.ts
+const HOP_BY_HOP_HEADERS = new Set([
+	"connection",
+	"keep-alive",
+	"proxy-authenticate",
+	"proxy-authorization",
+	"te",
+	"trailer",
+	"transfer-encoding",
+	"upgrade"
+]);
+function createPostHogProxyRequestHandler(options) {
+	return async function proxyPostHogRequest(request) {
+		const requestUrl = new URL(request.url);
+		const upstreamPath = requestUrl.pathname.startsWith(options.publicPathPrefix) ? requestUrl.pathname.slice(options.publicPathPrefix.length) : "";
+		const upstreamUrl = new URL(buildUpstreamPath(options, upstreamPath) + requestUrl.search, trimTrailingSlash(options.upstreamOrigin) + "/");
+		const headers = new Headers(request.headers);
+		const connectionHeader = headers.get("connection");
+		for (const header of HOP_BY_HOP_HEADERS) headers.delete(header);
+		if (connectionHeader) for (const token of connectionHeader.split(",")) {
+			const header = token.trim().toLowerCase();
+			if (header) headers.delete(header);
+		}
+		headers.delete("host");
+		const requestInit = {
+			method: request.method,
+			headers,
+			redirect: "follow"
+		};
+		if (request.method !== "GET" && request.method !== "HEAD") requestInit.body = await request.arrayBuffer();
+		const upstreamResponse = await fetch(upstreamUrl, requestInit);
+		return new Response(upstreamResponse.body, {
+			status: upstreamResponse.status,
+			statusText: upstreamResponse.statusText,
+			headers: upstreamResponse.headers
+		});
+	};
+}
+function buildUpstreamPath(options, upstreamPath) {
+	const prefix = trimSlashes(options.upstreamPathPrefix ?? "");
+	const path = trimLeadingSlash(upstreamPath);
+	if (!prefix) return path;
+	if (!path) return prefix;
+	return `${prefix}/${path}`;
+}
+function trimLeadingSlash(value) {
+	return value.replace(/^\/+/, "");
+}
+function trimSlashes(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function trimTrailingSlash(value) {
+	return value.replace(/\/+$/, "");
+}
+//#endregion
+export { createPostHogProxyRequestHandler };
+
+//# sourceMappingURL=posthog-proxy.mjs.map

package/dist/posthog-proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-proxy.mjs","names":[],"sources":["../src/posthog-proxy.ts"],"sourcesContent":["type PostHogProxyOptions = {\n\tpublicPathPrefix: string\n\tupstreamOrigin: string\n\tupstreamPathPrefix?: string\n}\n\nconst HOP_BY_HOP_HEADERS = new Set([\n\t'connection',\n\t'keep-alive',\n\t'proxy-authenticate',\n\t'proxy-authorization',\n\t'te',\n\t'trailer',\n\t'transfer-encoding',\n\t'upgrade',\n])\n\nexport function createPostHogProxyRequestHandler(options: PostHogProxyOptions) {\n\treturn async function proxyPostHogRequest(request: Request) {\n\t\tconst requestUrl = new URL(request.url)\n\t\tconst upstreamPath = requestUrl.pathname.startsWith(\n\t\t\toptions.publicPathPrefix,\n\t\t)\n\t\t\t? requestUrl.pathname.slice(options.publicPathPrefix.length)\n\t\t\t: ''\n\t\tconst upstreamUrl = new URL(\n\t\t\tbuildUpstreamPath(options, upstreamPath) + requestUrl.search,\n\t\t\ttrimTrailingSlash(options.upstreamOrigin) + '/',\n\t\t)\n\t\tconst headers = new Headers(request.headers)\n\t\tconst connectionHeader = headers.get('connection')\n\n\t\t// Strip hop-by-hop headers before proxying: RFC 9110 §7.6.\n\t\t// https://www.rfc-editor.org/rfc/rfc9110.html#name-connection-specific-header\n\t\tfor (const header of HOP_BY_HOP_HEADERS) {\n\t\t\theaders.delete(header)\n\t\t}\n\n\t\tif (connectionHeader) {\n\t\t\tfor (const token of connectionHeader.split(',')) {\n\t\t\t\tconst header = token.trim().toLowerCase()\n\t\t\t\tif (header) {\n\t\t\t\t\theaders.delete(header)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\theaders.delete('host')\n\n\t\tconst requestInit: RequestInit = {\n\t\t\tmethod: request.method,\n\t\t\theaders,\n\t\t\tredirect: 'follow',\n\t\t}\n\n\t\tif (request.method !== 'GET' && request.method !== 'HEAD') {\n\t\t\trequestInit.body = await request.arrayBuffer()\n\t\t}\n\n\t\tconst upstreamResponse = await fetch(upstreamUrl, requestInit)\n\n\t\treturn new Response(upstreamResponse.body, {\n\t\t\tstatus: upstreamResponse.status,\n\t\t\tstatusText: upstreamResponse.statusText,\n\t\t\theaders: upstreamResponse.headers,\n\t\t})\n\t}\n}\n\nfunction buildUpstreamPath(options: PostHogProxyOptions, upstreamPath: string) {\n\tconst prefix = trimSlashes(options.upstreamPathPrefix ?? '')\n\tconst path = trimLeadingSlash(upstreamPath)\n\n\tif (!prefix) {\n\t\treturn path\n\t}\n\n\tif (!path) {\n\t\treturn prefix\n\t}\n\n\treturn `${prefix}/${path}`\n}\n\nfunction trimLeadingSlash(value: string) {\n\treturn value.replace(/^\\/+/, '')\n}\n\nfunction trimSlashes(value: string) {\n\treturn value.replace(/^\\/+|\\/+$/g, '')\n}\n\nfunction trimTrailingSlash(value: string) {\n\treturn value.replace(/\\/+$/, '')\n}\n"],"mappings":";AAMA,MAAM,qBAAqB,IAAI,IAAI;CAClC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;AAEF,SAAgB,iCAAiC,SAA8B;CAC9E,OAAO,eAAe,oBAAoB,SAAkB;EAC3D,MAAM,aAAa,IAAI,IAAI,QAAQ,IAAI;EACvC,MAAM,eAAe,WAAW,SAAS,WACxC,QAAQ,iBACR,GACE,WAAW,SAAS,MAAM,QAAQ,iBAAiB,OAAO,GAC1D;EACH,MAAM,cAAc,IAAI,IACvB,kBAAkB,SAAS,aAAa,GAAG,WAAW,QACtD,kBAAkB,QAAQ,eAAe,GAAG,IAC5C;EACD,MAAM,UAAU,IAAI,QAAQ,QAAQ,QAAQ;EAC5C,MAAM,mBAAmB,QAAQ,IAAI,aAAa;EAIlD,KAAK,MAAM,UAAU,oBACpB,QAAQ,OAAO,OAAO;EAGvB,IAAI,kBACH,KAAK,MAAM,SAAS,iBAAiB,MAAM,IAAI,EAAE;GAChD,MAAM,SAAS,MAAM,MAAM,CAAC,aAAa;GACzC,IAAI,QACH,QAAQ,OAAO,OAAO;;EAKzB,QAAQ,OAAO,OAAO;EAEtB,MAAM,cAA2B;GAChC,QAAQ,QAAQ;GAChB;GACA,UAAU;GACV;EAED,IAAI,QAAQ,WAAW,SAAS,QAAQ,WAAW,QAClD,YAAY,OAAO,MAAM,QAAQ,aAAa;EAG/C,MAAM,mBAAmB,MAAM,MAAM,aAAa,YAAY;EAE9D,OAAO,IAAI,SAAS,iBAAiB,MAAM;GAC1C,QAAQ,iBAAiB;GACzB,YAAY,iBAAiB;GAC7B,SAAS,iBAAiB;GAC1B,CAAC;;;AAIJ,SAAS,kBAAkB,SAA8B,cAAsB;CAC9E,MAAM,SAAS,YAAY,QAAQ,sBAAsB,GAAG;CAC5D,MAAM,OAAO,iBAAiB,aAAa;CAE3C,IAAI,CAAC,QACJ,OAAO;CAGR,IAAI,CAAC,MACJ,OAAO;CAGR,OAAO,GAAG,OAAO,GAAG;;AAGrB,SAAS,iBAAiB,OAAe;CACxC,OAAO,MAAM,QAAQ,QAAQ,GAAG;;AAGjC,SAAS,YAAY,OAAe;CACnC,OAAO,MAAM,QAAQ,cAAc,GAAG;;AAGvC,SAAS,kBAAkB,OAAe;CACzC,OAAO,MAAM,QAAQ,QAAQ,GAAG"}

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@aamini/lib",
+	"version": "0.0.1",
+	"private": false,
+	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/aamini-stack/projects.git",
+		"directory": "packages/lib"
+	},
+	"bugs": {
+		"url": "https://github.com/aamini-stack/projects/issues"
+	},
+	"homepage": "https://github.com/aamini-stack/projects/tree/main/packages/lib#readme",
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"exports": {
+		"./env": {
+			"types": "./dist/env.d.mts",
+			"import": "./dist/env.mjs",
+			"default": "./dist/env.mjs"
+		},
+		"./posthog-proxy": {
+			"types": "./dist/posthog-proxy.d.mts",
+			"import": "./dist/posthog-proxy.mjs",
+			"default": "./dist/posthog-proxy.mjs"
+		}
+	},
+	"scripts": {
+		"pack": "vp pack",
+		"prepublishOnly": "vp pack",
+		"check": "vp check"
+	},
+	"dependencies": {
+		"dotenv": "^17.4.2",
+		"zod": "^4.3.6"
+	},
+	"devDependencies": {
+		"@aamini/config": "workspace:*",
+		"typescript": "6.0.2"
+	}
+}

package/src/env.ts

@@ -0,0 +1,31 @@
+import { config } from 'dotenv'
+import type { ZodTypeAny, z } from 'zod'
+
+export function createEnv<T extends ZodTypeAny>(schema: T): z.infer<T> {
+	const rawEnvironmentName =
+		process.env.RAILWAY_ENVIRONMENT_NAME ??
+		process.env.NODE_ENV ??
+		'development'
+	const environmentName = /(?:^|-)pr-\d+$/.test(rawEnvironmentName)
+		? 'staging'
+		: rawEnvironmentName
+	const fileEnvironment: Record<string, string> = {}
+
+	config({
+		path: [
+			`.env.${environmentName}`,
+			'.env',
+			`.env.${environmentName}.local`,
+			'.env.local',
+		],
+		quiet: true,
+		override: true,
+		processEnv: fileEnvironment,
+	})
+
+	for (const [key, value] of Object.entries(fileEnvironment)) {
+		process.env[key] ??= value
+	}
+
+	return schema.parse({ ...process.env, ...fileEnvironment })
+}

package/src/posthog-proxy.ts

@@ -0,0 +1,95 @@
+type PostHogProxyOptions = {
+	publicPathPrefix: string
+	upstreamOrigin: string
+	upstreamPathPrefix?: string
+}
+
+const HOP_BY_HOP_HEADERS = new Set([
+	'connection',
+	'keep-alive',
+	'proxy-authenticate',
+	'proxy-authorization',
+	'te',
+	'trailer',
+	'transfer-encoding',
+	'upgrade',
+])
+
+export function createPostHogProxyRequestHandler(options: PostHogProxyOptions) {
+	return async function proxyPostHogRequest(request: Request) {
+		const requestUrl = new URL(request.url)
+		const upstreamPath = requestUrl.pathname.startsWith(
+			options.publicPathPrefix,
+		)
+			? requestUrl.pathname.slice(options.publicPathPrefix.length)
+			: ''
+		const upstreamUrl = new URL(
+			buildUpstreamPath(options, upstreamPath) + requestUrl.search,
+			trimTrailingSlash(options.upstreamOrigin) + '/',
+		)
+		const headers = new Headers(request.headers)
+		const connectionHeader = headers.get('connection')
+
+		// Strip hop-by-hop headers before proxying: RFC 9110 §7.6.
+		// https://www.rfc-editor.org/rfc/rfc9110.html#name-connection-specific-header
+		for (const header of HOP_BY_HOP_HEADERS) {
+			headers.delete(header)
+		}
+
+		if (connectionHeader) {
+			for (const token of connectionHeader.split(',')) {
+				const header = token.trim().toLowerCase()
+				if (header) {
+					headers.delete(header)
+				}
+			}
+		}
+
+		headers.delete('host')
+
+		const requestInit: RequestInit = {
+			method: request.method,
+			headers,
+			redirect: 'follow',
+		}
+
+		if (request.method !== 'GET' && request.method !== 'HEAD') {
+			requestInit.body = await request.arrayBuffer()
+		}
+
+		const upstreamResponse = await fetch(upstreamUrl, requestInit)
+
+		return new Response(upstreamResponse.body, {
+			status: upstreamResponse.status,
+			statusText: upstreamResponse.statusText,
+			headers: upstreamResponse.headers,
+		})
+	}
+}
+
+function buildUpstreamPath(options: PostHogProxyOptions, upstreamPath: string) {
+	const prefix = trimSlashes(options.upstreamPathPrefix ?? '')
+	const path = trimLeadingSlash(upstreamPath)
+
+	if (!prefix) {
+		return path
+	}
+
+	if (!path) {
+		return prefix
+	}
+
+	return `${prefix}/${path}`
+}
+
+function trimLeadingSlash(value: string) {
+	return value.replace(/^\/+/, '')
+}
+
+function trimSlashes(value: string) {
+	return value.replace(/^\/+|\/+$/g, '')
+}
+
+function trimTrailingSlash(value: string) {
+	return value.replace(/\/+$/, '')
+}