gorsee 0.2.10 → 0.2.12

package/dist-pkg/server/worker-service.js

@@ -0,0 +1,135 @@
+import { emitAIEvent } from "../ai/index.js";
+export function defineWorkerService(name, start) {
+  return { name, start };
+}
+export async function runWorkerService(service, options = {}) {
+  const startedAt = Date.now(), workerId = options.workerId ?? crypto.randomUUID(), controller = new AbortController, cleanupTasks = [];
+  let readySettled = !1, stopPromise = null, resolveReady, rejectReady;
+  const ready = new Promise((resolve, reject) => {
+    resolveReady = resolve;
+    rejectReady = reject;
+  });
+  if (options.signal)
+    if (options.signal.aborted)
+      controller.abort(options.signal.reason);
+    else
+      options.signal.addEventListener("abort", () => controller.abort(options.signal?.reason), { once: !0 });
+  const shutdownPromise = new Promise((resolve) => {
+    if (controller.signal.aborted)
+      resolve();
+    else
+      controller.signal.addEventListener("abort", () => resolve(), { once: !0 });
+  }), context = {
+    name: service.name,
+    workerId,
+    startedAt,
+    signal: controller.signal,
+    emitReady: async () => {
+      if (readySettled)
+        return;
+      readySettled = !0;
+      resolveReady();
+      await emitAIEvent({
+        kind: "worker.ready",
+        severity: "info",
+        source: "runtime",
+        message: `worker ready ${service.name}`,
+        data: {
+          workerId,
+          service: service.name,
+          startedAt
+        }
+      });
+    },
+    emitHeartbeat: async (message = `worker heartbeat ${service.name}`, data) => {
+      await emitAIEvent({
+        kind: "worker.heartbeat",
+        severity: "info",
+        source: "runtime",
+        message,
+        data: {
+          workerId,
+          service: service.name,
+          startedAt,
+          ...data ?? {}
+        }
+      });
+    },
+    waitForShutdown: async () => shutdownPromise
+  };
+  await emitAIEvent({
+    kind: "worker.start",
+    severity: "info",
+    source: "runtime",
+    message: `starting worker ${service.name}`,
+    data: {
+      workerId,
+      service: service.name,
+      startedAt
+    }
+  });
+  try {
+    const startResult = await service.start(context);
+    if (typeof startResult === "function")
+      cleanupTasks.push(startResult);
+    else if (startResult?.stop) {
+      cleanupTasks.push(startResult.stop);
+      if (startResult.ready)
+        startResult.ready.then(() => context.emitReady()).catch((error) => {
+          rejectReady(error);
+        });
+    }
+    if (!readySettled && !(typeof startResult === "object" && startResult?.ready))
+      await context.emitReady();
+  } catch (error) {
+    rejectReady(error);
+    await emitAIEvent({
+      kind: "worker.error",
+      severity: "error",
+      source: "runtime",
+      message: error instanceof Error ? error.message : String(error),
+      data: {
+        workerId,
+        service: service.name,
+        startedAt
+      }
+    });
+    throw error;
+  }
+  const stop = async () => {
+    if (stopPromise)
+      return stopPromise;
+    stopPromise = (async () => {
+      controller.abort();
+      for (const cleanup of cleanupTasks.reverse())
+        await cleanup();
+      await emitAIEvent({
+        kind: "worker.stop",
+        severity: "info",
+        source: "runtime",
+        message: `stopped worker ${service.name}`,
+        data: {
+          workerId,
+          service: service.name,
+          startedAt,
+          stoppedAt: Date.now()
+        }
+      });
+    })();
+    return stopPromise;
+  };
+  if (options.registerSignalHandlers !== !1 && typeof process.on === "function") {
+    const handleSignal = () => {
+      stop();
+    };
+    process.once("SIGINT", handleSignal);
+    process.once("SIGTERM", handleSignal);
+  }
+  return {
+    name: service.name,
+    workerId,
+    startedAt,
+    ready,
+    stop
+  };
+}

package/dist-pkg/server-entry.d.ts

@@ -12,7 +12,8 @@ export { log, setLogLevel } from "./log/index.js";
 /** @deprecated Prefer "gorsee/ai" when AI tooling is the primary concern. */
 export { buildAIHealthReport, buildAIContextBundle, buildIDEProjection, configureAIObservability, createAIMCPServer, createAIContextPacket, createAIBridgeHandler, createAIBridgeServer, createIDEProjectionWatcher, createLineReader, emitAIDiagnostic, emitAIEvent, createTraceIds, readAIDiagnosticsSnapshot, readAIEvents, renderAIContextBundleMarkdown, renderAIContextMarkdown, resolveAISessionPackPaths, resolveIDEProjectionPaths, resolveAIStorePaths, resolveAIObservabilityConfig, runWithAITrace, writeAISessionPack, writeIDEProjection, type AIMCPServerOptions, type AIContextPacket, type AIContextBundle, type AIContextSnippet, type AIHealthReport, type AIEvent, type AIEventSeverity, type IDEProjection, type IDEProjectionPaths, type IDEProjectionWatcher, type IDEProjectionWatcherOptions, type AISessionPackConfig, type AISessionPackPaths, type AIStorePaths, type AITraceContext, type AIDiagnostic, type AIObservabilityConfig, type AIBridgeConfig, type AIBridgeServer, type AIBridgeHandler, type AIBridgeServerOptions, type AIBridgeSnapshot, } from "./ai/index.js";
 export { createNodeRedisLikeClient, createIORedisLikeClient, deleteExpiredRedisKeys, type RedisLikeClient, type NodeRedisClientLike, type IORedisClientLike, } from "./server/redis-client.js";
-export { createMemoryJobQueue, defineJob, type JobContext, type JobDefinition, type JobEnqueueOptions, type JobQueue, type JobRunResult, type EnqueuedJob, } from "./server/jobs.js";
+export { createMemoryJobQueue, defineJob, type JobContext, type JobDefinition, type JobEnqueueOptions, type JobRetryOptions, type JobQueue, type JobRunResult, type EnqueuedJob, type QueuedJobRecord, type TerminalJobRecord, type MemoryJobQueueOptions, } from "./server/jobs.js";
+export { defineWorkerService, runWorkerService, type WorkerServiceContext, type WorkerServiceDefinition, type WorkerServiceStartHandle, type RunWorkerServiceOptions, type RunningWorkerService, } from "./server/worker-service.js";
 export { createRedisJobQueue, type RedisJobQueueOptions } from "./server/redis-job-queue.js";
 /** @deprecated Prefer "gorsee/i18n" when locale contracts are the primary concern. */
 export { setupI18n, loadLocale, getLocale, getLocales, getDefaultLocale, getFallbackLocales, setLocale, t, plural, negotiateLocale, resolveLocaleFromPath, stripLocalePrefix, withLocalePath, buildHreflangLinks, formatNumber, formatDate, formatRelativeTime, type I18nConfig, type LocaleNegotiationInput, type LocaleNegotiationResult, } from "./i18n/index.js";

package/dist-pkg/server-entry.js

@@ -65,6 +65,10 @@ export {
   createMemoryJobQueue,
   defineJob
 } from "./server/jobs.js";
+export {
+  defineWorkerService,
+  runWorkerService
+} from "./server/worker-service.js";
 export { createRedisJobQueue } from "./server/redis-job-queue.js";
 export {
   setupI18n,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gorsee",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "AI-first reactive full-stack TypeScript framework for deterministic human and agent collaboration",
   "type": "module",
   "packageManager": "bun@1.3.9",
@@ -21,7 +21,7 @@
     "web-framework"
   ],
   "bin": {
-    "gorsee": "dist-pkg/bin/gorsee.js"
+    "gorsee": "bin/gorsee.js"
   },
   "exports": {
     ".": "./dist-pkg/index.js",
@@ -58,6 +58,7 @@
     "./deploy": "./dist-pkg/deploy/index.js"
   },
   "files": [
+    "bin/",
     "dist-pkg/",
     "README.md",
     "LICENSE"