ras-stack 0.30.1 → 0.32.0

package/dist/posthog/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/posthog/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAA;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAGnD,MAAM,UAAU,kBAAkB,CAAC,EACjC,QAAQ,EACR,WAAW,EACX,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,sDAAsD,CAAC,EAC9F,OAAO,GAMR;IACC,IAAI,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAA;IACjC,MAAM,gBAAgB,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC/F,OAAO,aAAa,CAClB,eAAe,EACf;QACE,MAAM,EAAE,WAAW,CAAC,YAAY;QAChC,OAAO,EAAE,qBAAqB,CAAC;YAC7B,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;KACH,EACD,aAAa,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAC5D,CAAA;AACH,CAAC","sourcesContent":["import { PostHogErrorBoundary, PostHogProvider } from '@posthog/react'\nimport { createElement, type ReactNode } from 'react'\nimport type { PostHogConfig } from 'posthog-js'\nimport { postHogBrowserOptions } from './client.js'\nimport type { PostHogEnvironment } from './config.js'\n\nexport function PostHogIntegration({\n  children,\n  environment,\n  fallback = createElement('main', null, 'Something went wrong. Refresh the page to try again.'),\n  options,\n}: {\n  children?: ReactNode\n  environment: PostHogEnvironment | undefined\n  fallback?: ReactNode\n  options?: Partial<PostHogConfig>\n}) {\n  if (!environment) return children\n  const tracingHostnames = typeof window === 'undefined' ? undefined : [window.location.hostname]\n  return createElement(\n    PostHogProvider,\n    {\n      apiKey: environment.projectToken,\n      options: postHogBrowserOptions({\n        apiHost: '/ingest',\n        uiHost: environment.uiHost,\n        ...(tracingHostnames ? { tracingHostnames } : {}),\n        ...(options ? { options } : {}),\n      }),\n    },\n    createElement(PostHogErrorBoundary, { fallback }, children),\n  )\n}\n"]}

package/dist/posthog/request.d.ts

@@ -0,0 +1,14 @@
+export declare const POSTHOG_DISTINCT_ID_HEADER = "x-posthog-distinct-id";
+export declare const POSTHOG_SESSION_ID_HEADER = "x-posthog-session-id";
+export type PostHogRequestContext = {
+    distinctId?: string;
+    sessionId?: string;
+    properties: {
+        $session_id?: string;
+    };
+};
+export declare function postHogRequestContext(request: Request, options?: {
+    authenticatedDistinctId?: string;
+    allowAnonymousDistinctId?: boolean;
+}): PostHogRequestContext;
+export declare function postHogIdentifier(value: string | null | undefined): string | undefined;

package/dist/posthog/request.js

@@ -0,0 +1,22 @@
+export const POSTHOG_DISTINCT_ID_HEADER = 'x-posthog-distinct-id';
+export const POSTHOG_SESSION_ID_HEADER = 'x-posthog-session-id';
+export function postHogRequestContext(request, options = {}) {
+    const claimedDistinctId = postHogIdentifier(request.headers.get(POSTHOG_DISTINCT_ID_HEADER));
+    const sessionId = postHogIdentifier(request.headers.get(POSTHOG_SESSION_ID_HEADER));
+    const distinctId = options.authenticatedDistinctId
+        ? claimedDistinctId === options.authenticatedDistinctId
+            ? claimedDistinctId
+            : undefined
+        : options.allowAnonymousDistinctId
+            ? claimedDistinctId
+            : undefined;
+    return {
+        ...(distinctId ? { distinctId } : {}),
+        ...(sessionId ? { sessionId } : {}),
+        properties: sessionId ? { $session_id: sessionId } : {},
+    };
+}
+export function postHogIdentifier(value) {
+    return value && /^[A-Za-z0-9._:@|+-]{1,128}$/.test(value) ? value : undefined;
+}
+//# sourceMappingURL=request.js.map

package/dist/posthog/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/posthog/request.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAA;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAsB,CAAA;AAQ/D,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,OAAO,GAA6E,EAAE;IAEtF,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAA;IAC5F,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAA;IACnF,MAAM,UAAU,GAAG,OAAO,CAAC,uBAAuB;QAChD,CAAC,CAAC,iBAAiB,KAAK,OAAO,CAAC,uBAAuB;YACrD,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,SAAS;QACb,CAAC,CAAC,OAAO,CAAC,wBAAwB;YAChC,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,SAAS,CAAA;IACf,OAAO;QACL,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;KACxD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAgC;IAChE,OAAO,KAAK,IAAI,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/E,CAAC","sourcesContent":["export const POSTHOG_DISTINCT_ID_HEADER = 'x-posthog-distinct-id'\nexport const POSTHOG_SESSION_ID_HEADER = 'x-posthog-session-id'\n\nexport type PostHogRequestContext = {\n  distinctId?: string\n  sessionId?: string\n  properties: { $session_id?: string }\n}\n\nexport function postHogRequestContext(\n  request: Request,\n  options: { authenticatedDistinctId?: string; allowAnonymousDistinctId?: boolean } = {},\n): PostHogRequestContext {\n  const claimedDistinctId = postHogIdentifier(request.headers.get(POSTHOG_DISTINCT_ID_HEADER))\n  const sessionId = postHogIdentifier(request.headers.get(POSTHOG_SESSION_ID_HEADER))\n  const distinctId = options.authenticatedDistinctId\n    ? claimedDistinctId === options.authenticatedDistinctId\n      ? claimedDistinctId\n      : undefined\n    : options.allowAnonymousDistinctId\n      ? claimedDistinctId\n      : undefined\n  return {\n    ...(distinctId ? { distinctId } : {}),\n    ...(sessionId ? { sessionId } : {}),\n    properties: sessionId ? { $session_id: sessionId } : {},\n  }\n}\n\nexport function postHogIdentifier(value: string | null | undefined) {\n  return value && /^[A-Za-z0-9._:@|+-]{1,128}$/.test(value) ? value : undefined\n}\n"]}

package/dist/posthog/server.d.ts

@@ -0,0 +1,4 @@
+import type { PostHog, PostHogOptions } from 'posthog-node';
+import type { PostHogEnvironment } from './config.js';
+export declare function createPostHogServerClient(environment: PostHogEnvironment | undefined, options?: Omit<PostHogOptions, 'host'>): Promise<PostHog | undefined>;
+export declare function shutdownPostHogServerClient(client: PostHog | undefined, timeoutMs?: number): Promise<void>;

package/dist/posthog/server.js

@@ -0,0 +1,17 @@
+export async function createPostHogServerClient(environment, options = {}) {
+    if (!environment)
+        return undefined;
+    const { PostHog } = await import('posthog-node');
+    return new PostHog(environment.projectToken, {
+        host: environment.host,
+        enableExceptionAutocapture: true,
+        ...options,
+    });
+}
+export async function shutdownPostHogServerClient(client, timeoutMs = 10_000) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0)
+        throw new Error('timeoutMs must be a non-negative integer');
+    // oxlint-disable-next-line no-underscore-dangle -- posthog-node's async shutdown API is named `_shutdown`.
+    await client?._shutdown(timeoutMs);
+}
+//# sourceMappingURL=server.js.map

package/dist/posthog/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/posthog/server.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAA2C,EAC3C,OAAO,GAAiC,EAAE;IAE1C,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IAClC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IAChD,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE;QAC3C,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,0BAA0B,EAAE,IAAI;QAChC,GAAG,OAAO;KACX,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAA2B,EAAE,SAAS,GAAG,MAAM;IAC/F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAClH,2GAA2G;IAC3G,MAAM,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;AACpC,CAAC","sourcesContent":["import type { PostHog, PostHogOptions } from 'posthog-node'\nimport type { PostHogEnvironment } from './config.js'\n\nexport async function createPostHogServerClient(\n  environment: PostHogEnvironment | undefined,\n  options: Omit<PostHogOptions, 'host'> = {},\n): Promise<PostHog | undefined> {\n  if (!environment) return undefined\n  const { PostHog } = await import('posthog-node')\n  return new PostHog(environment.projectToken, {\n    host: environment.host,\n    enableExceptionAutocapture: true,\n    ...options,\n  })\n}\n\nexport async function shutdownPostHogServerClient(client: PostHog | undefined, timeoutMs = 10_000) {\n  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0) throw new Error('timeoutMs must be a non-negative integer')\n  // oxlint-disable-next-line no-underscore-dangle -- posthog-node's async shutdown API is named `_shutdown`.\n  await client?._shutdown(timeoutMs)\n}\n"]}

package/dist/preview/cli.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
-export {};
+export declare function runPreviewCli(arguments_: string[]): Promise<void>;

package/dist/preview/cli.js

@@ -1,7 +1,8 @@
-#!/usr/bin/env node
 import { previewStatusFromEnvironment } from './environment.js';
 import { reportPreviewStatus } from './github.js';
-const { options, status } = previewStatusFromEnvironment(process.argv[2]);
-await reportPreviewStatus(options, status);
-console.log(`Preview status set to ${status.state}`);
+export async function runPreviewCli(arguments_) {
+    const { options, status } = previewStatusFromEnvironment(arguments_[0]);
+    await reportPreviewStatus(options, status);
+    console.log(`Preview status set to ${status.state}`);
+}
 //# sourceMappingURL=cli.js.map

package/dist/preview/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/preview/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,4BAA4B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AACzE,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC1C,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA","sourcesContent":["#!/usr/bin/env node\nimport { previewStatusFromEnvironment } from './environment.js'\nimport { reportPreviewStatus } from './github.js'\n\nconst { options, status } = previewStatusFromEnvironment(process.argv[2])\nawait reportPreviewStatus(options, status)\nconsole.log(`Preview status set to ${status.state}`)\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/preview/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAoB;IACtD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACvE,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1C,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;AACtD,CAAC","sourcesContent":["import { previewStatusFromEnvironment } from './environment.js'\nimport { reportPreviewStatus } from './github.js'\n\nexport async function runPreviewCli(arguments_: string[]): Promise<void> {\n  const { options, status } = previewStatusFromEnvironment(arguments_[0])\n  await reportPreviewStatus(options, status)\n  console.log(`Preview status set to ${status.state}`)\n}\n"]}

package/dist/runtime/dev-cli.d.ts

@@ -1,2 +1 @@
-#!/usr/bin/env node
-export {};
+export declare function runRealtimeCli(arguments_: string[]): Promise<void>;

package/dist/runtime/dev-cli.js

@@ -1,10 +1,11 @@
-#!/usr/bin/env node
 import { parseRealtimeDevArguments, runRealtimeDev } from './dev.js';
-try {
-    await runRealtimeDev(parseRealtimeDevArguments(process.argv.slice(2)));
-}
-catch (error) {
-    console.error(error instanceof Error ? error.message : error);
-    process.exitCode = 1;
+export async function runRealtimeCli(arguments_) {
+    try {
+        await runRealtimeDev(parseRealtimeDevArguments(arguments_));
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    }
 }
 //# sourceMappingURL=dev-cli.js.map

package/dist/runtime/dev-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-cli.js","sourceRoot":"","sources":["../../src/runtime/dev-cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEpE,IAAI,CAAC;IACH,MAAM,cAAc,CAAC,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACxE,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { parseRealtimeDevArguments, runRealtimeDev } from './dev.js'\n\ntry {\n  await runRealtimeDev(parseRealtimeDevArguments(process.argv.slice(2)))\n} catch (error) {\n  console.error(error instanceof Error ? error.message : error)\n  process.exitCode = 1\n}\n"]}
+{"version":3,"file":"dev-cli.js","sourceRoot":"","sources":["../../src/runtime/dev-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAEpE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAoB;IACvD,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC","sourcesContent":["import { parseRealtimeDevArguments, runRealtimeDev } from './dev.js'\n\nexport async function runRealtimeCli(arguments_: string[]): Promise<void> {\n  try {\n    await runRealtimeDev(parseRealtimeDevArguments(arguments_))\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : error)\n    process.exitCode = 1\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.30.1",
+  "version": "0.32.0",
   "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
   "keywords": [
     "authentication",
@@ -17,10 +17,7 @@
     "url": "git+https://github.com/richardsolomou/ras-stack.git"
   },
   "bin": {
-    "ras-stack-assets": "./dist/build/cli.js",
-    "ras-stack-policy": "./dist/policy/cli.js",
-    "ras-stack-preview": "./dist/preview/cli.js",
-    "ras-stack-realtime": "./dist/runtime/dev-cli.js"
+    "ras": "./dist/cli.js"
   },
   "files": [
     "dist",
@@ -69,6 +66,26 @@
       "types": "./dist/policy/index.d.ts",
       "default": "./dist/policy/index.js"
     },
+    "./posthog": {
+      "types": "./dist/posthog/index.d.ts",
+      "default": "./dist/posthog/index.js"
+    },
+    "./posthog/client": {
+      "types": "./dist/posthog/client.d.ts",
+      "default": "./dist/posthog/client.js"
+    },
+    "./posthog/proxy": {
+      "types": "./dist/posthog/proxy.d.ts",
+      "default": "./dist/posthog/proxy.js"
+    },
+    "./posthog/react": {
+      "types": "./dist/posthog/react.d.ts",
+      "default": "./dist/posthog/react.js"
+    },
+    "./posthog/server": {
+      "types": "./dist/posthog/server.d.ts",
+      "default": "./dist/posthog/server.js"
+    },
     "./preview/dokploy": {
       "types": "./dist/preview/dokploy.d.ts",
       "default": "./dist/preview/dokploy.js"
@@ -131,7 +148,7 @@
     "format:check": "oxfmt --check .",
     "test": "vitest run --config vitest.config.ts",
     "package:check": "node scripts/checkPackedPackage.mjs",
-    "check": "pnpm format:check && pnpm lint && pnpm config:check && pnpm typecheck && pnpm test && pnpm build && pnpm package:check && pnpm --filter @ras-stack/example-full-stack check && node dist/policy/cli.js check",
+    "check": "pnpm format:check && pnpm lint && pnpm config:check && pnpm typecheck && pnpm test && pnpm build && pnpm package:check && pnpm --filter @ras-stack/example-full-stack check && node dist/cli.js policy check",
     "version-packages": "changeset version"
   },
   "dependencies": {
@@ -140,6 +157,7 @@
   "devDependencies": {
     "@changesets/cli": "^2.31.1",
     "@playwright/test": "1.62.1",
+    "@posthog/react": "^1.10.3",
     "@tanstack/react-query": "^5.101.4",
     "@tanstack/react-start": "^1.168.32",
     "@types/better-sqlite3": "9.6.0",
@@ -155,6 +173,8 @@
     "oxlint": "^1.74.0",
     "oxlint-tsgolint": "^7.0.2001",
     "postgres": "3.4.9",
+    "posthog-js": "^1.415.0",
+    "posthog-node": "^5.48.1",
     "react": "19.2.8",
     "react-test-renderer": "19.2.8",
     "tus-js-client": "^4.3.1",
@@ -163,6 +183,7 @@
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
+    "@posthog/react": ">=1 <2",
     "@tanstack/react-query": ">=5 <6",
     "@tanstack/react-start": ">=1 <2",
     "better-sqlite3": ">=12 <14",
@@ -170,10 +191,15 @@
     "drizzle-orm": ">=0.45 <1",
     "nodemailer": ">=9 <10",
     "postgres": ">=3.4 <4",
+    "posthog-js": ">=1.407 <2",
+    "posthog-node": ">=5.47 <6",
     "react": ">=19 <20",
     "tus-js-client": ">=4 <5"
   },
   "peerDependenciesMeta": {
+    "@posthog/react": {
+      "optional": true
+    },
     "@tanstack/react-query": {
       "optional": true
     },
@@ -200,6 +226,12 @@
     },
     "tus-js-client": {
       "optional": true
+    },
+    "posthog-js": {
+      "optional": true
+    },
+    "posthog-node": {
+      "optional": true
     }
   },
   "engines": {