@lowerdeck/execution-context 1.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,11 @@
+
+$ microbundle
+Build "@lowerdeck/unique" to dist:
+         77 B: index.cjs.gz
+         58 B: index.cjs.br
+         66 B: index.module.js.gz
+         50 B: index.module.js.br
+         88 B: index.module.js.gz
+         72 B: index.module.js.br
+        170 B: index.umd.js.gz
+        137 B: index.umd.js.br

package/.turbo/turbo-test.log

@@ -0,0 +1,26 @@
+
+$ vitest run --passWithNoTests
+[?25l
+ RUN  v3.2.4 /Users/tobias/code/metorial/metorial-enterprise/oss/src/packages/shared/unique
+
+[?2026h
+ ❯ src/index.test.ts [queued]
+
+ Test Files 0 passed (1)
+      Tests 0 passed (0)
+   Start at 10:23:39
+   Duration 101ms
+[?2026l ✓ src/index.test.ts (6 tests) 2ms
+   ✓ unique > should return an array with unique elements 1ms
+   ✓ unique > should handle an empty array 0ms
+   ✓ unique > should handle an array with all unique elements 0ms
+   ✓ unique > should handle an array with all duplicate elements 0ms
+   ✓ unique > should work with strings 0ms
+   ✓ unique > should work with mixed types 0ms
+
+ Test Files  1 passed (1)
+      Tests  6 passed (6)
+   Start at  10:23:39
+   Duration  218ms (transform 29ms, setup 0ms, collect 28ms, tests 2ms, environment 0ms, prepare 40ms)
+
+[?25h

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@lowerdeck/execution-context",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Tobias Herber",
+  "license": "Apache 2",
+  "type": "module",
+  "source": "src/index.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "require": "./dist/index.cjs",
+    "import": "./dist/index.module.js",
+    "default": "./dist/index.module.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.module.js",
+  "types": "dist/index.d.ts",
+  "unpkg": "./dist/index.umd.js",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "lint": "prettier src/**/*.ts --check",
+    "build": "microbundle"
+  },
+  "dependencies": {
+    "@lowerdeck/id": "^1.0.0",
+    "@lowerdeck/sentry": "^1.0.0"
+  },
+  "devDependencies": {
+    "microbundle": "^0.15.1",
+    "@lowerdeck/tsconfig": "^1.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.2"
+  }
+}

package/src/execution-context.ts

@@ -0,0 +1,27 @@
+import { generateId } from '@lowerdeck/id';
+
+export type ExecutionContext = {
+  contextId: string;
+  parent?: ExecutionContext;
+} & (
+  | {
+      type: 'request';
+      userId?: string;
+      memberId?: string;
+      apiKeyId?: string;
+      machineAccessId?: string;
+      ip: string;
+      userAgent: string;
+    }
+  | { type: 'scheduled'; cron: string; name: string }
+  | { type: 'job'; queue: string }
+  | { type: 'unknown' }
+);
+
+export let createExecutionContext = (
+  input: ExecutionContext & { contextId?: string | undefined }
+) => {
+  if (!input.contextId) input.contextId = generateId('ctx_');
+
+  return input as ExecutionContext;
+};

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './execution-context';
+export * from './with-execution-context';

package/src/with-execution-context.ts

@@ -0,0 +1,93 @@
+import { getSentry } from '@lowerdeck/sentry';
+import { AsyncLocalStorage } from 'async_hooks';
+import { ExecutionContext } from './execution-context';
+
+let Sentry = getSentry();
+
+export let ctxStorage = new AsyncLocalStorage<{
+  context: ExecutionContext;
+  afterHooks?: Array<() => Promise<void | any>>;
+}>();
+
+export let withExecutionContext = async <T>(
+  cb: (ctx: ExecutionContext) => Promise<T>
+): Promise<T> => {
+  let ctx = ctxStorage.getStore();
+  if (!ctx) {
+    throw new Error('No execution context found');
+  }
+
+  return await cb(ctx.context);
+};
+
+export let withExecutionContextOptional = async <T>(
+  cb: (ctx: ExecutionContext | null) => Promise<T>
+): Promise<T> => {
+  let ctx = ctxStorage.getStore();
+  return await cb(ctx?.context ?? null);
+};
+
+export let addAfterHook = async (hook: () => Promise<void | any>) => {
+  let ctx = ctxStorage.getStore();
+  if (!ctx) {
+    throw new Error('No execution context found');
+  }
+
+  if (!ctx.afterHooks) {
+    throw new Error('After hooks not enabled for this execution context');
+  }
+
+  ctx.afterHooks.push(hook);
+};
+
+export let provideExecutionContext = async <T>(
+  ctx: ExecutionContext,
+  cb: () => Promise<T>
+): Promise<T> => {
+  let afterHooks: Array<() => Promise<void | any>> = [];
+
+  Sentry.setContext('executionContext', ctx);
+
+  let res = await ctxStorage.run(
+    {
+      context: ctx,
+      afterHooks
+    },
+    async () => await cb()
+  );
+
+  for (let hook of afterHooks) {
+    hook().catch(err => {
+      Sentry.captureException(err);
+
+      console.error('Error in after hook', {
+        err,
+        context: ctx
+      });
+    });
+  }
+
+  return res;
+};
+
+export let setExecutionContextSync = (ctx: ExecutionContext) => {
+  ctxStorage.enterWith({
+    context: ctx
+  });
+};
+
+export let updateExecutionContext = (ctx: Partial<ExecutionContext>) => {
+  let currentCtx = getExecutionContext();
+
+  Object.assign(currentCtx, ctx);
+
+  return currentCtx;
+};
+
+export let getExecutionContext = () => {
+  let ctx = ctxStorage.getStore();
+  if (!ctx) {
+    throw new Error('No execution context found');
+  }
+  return ctx.context;
+};

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@lowerdeck/tsconfig/base.json",
+  "exclude": [
+    "dist"
+  ],
+  "include": [
+    "src"
+  ],
+  "compilerOptions": {
+    "outDir": "dist"
+  }
+}