@somewhatintelligent/kit 0.0.1-beta.1783705886.297c5be

package/src/version/index.ts

@@ -0,0 +1,85 @@
+/**
+ * `/__version` — one tiny, shared implementation of the version endpoint
+ * so every worker built on these packages answers identically.
+ *
+ * Where the values come from:
+ * - `version` / `commit` are the calling PACKAGE's release stamp (its
+ *   `version.gen.ts`, written by the release workflow at publish) — the
+ *   package IS the versioned artifact. Apps built with vite instead bake
+ *   build-time constants via `define` and pass them through `overrides`.
+ * - `environment` reads the worker's existing `ENVIRONMENT` var.
+ * - Everything falls back safely — local dev / tests (placeholder stamps)
+ *   report `0.0.0-dev` / `unknown` / `development` instead of throwing.
+ */
+
+export interface VersionInfo {
+  worker: string;
+  version: string;
+  commit: string;
+  environment: string;
+}
+
+export { PKG } from "../version.gen";
+
+export const VERSION_PATH = "/__version";
+
+export interface VersionOptions {
+  /** The worker's canonical name (e.g. "guestlist"). */
+  worker: string;
+  /** The worker's env bindings (any shape — only string vars are read). */
+  env?: unknown;
+  /**
+   * Pathnames that answer. Defaults to just `/__version`. A worker mounted
+   * WITHOUT prefix-stripping (guestlist behind bouncer's `/api` passthrough)
+   * adds its mounted spelling too, e.g. `["/__version", "/api/__version"]`,
+   * so the endpoint stays reachable through the mount.
+   */
+  paths?: readonly string[];
+  /** Field overrides for build-time-injected values (vite `define` apps). */
+  overrides?: Partial<Omit<VersionInfo, "worker">>;
+  /**
+   * The calling package's release stamp (its `version.gen.ts` PKG) — the
+   * source of `version`/`commit`. Placeholder in-repo, real at publish.
+   */
+  pkg?: { version?: string; commit?: string };
+}
+
+function readStringVar(env: unknown, key: string): string | undefined {
+  if (typeof env !== "object" || env === null) return undefined;
+  const value = (env as Record<string, unknown>)[key];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+
+/** Resolve the version payload for a worker (fallbacks, never throws). */
+export function versionInfo(options: VersionOptions): VersionInfo {
+  const { worker, env, overrides, pkg } = options;
+  return {
+    worker,
+    version: overrides?.version ?? pkg?.version ?? "0.0.0-dev",
+    commit: overrides?.commit ?? pkg?.commit ?? "unknown",
+    environment: overrides?.environment ?? readStringVar(env, "ENVIRONMENT") ?? "development",
+  };
+}
+
+/** Serialize a payload as the endpoint's JSON response. */
+export function versionResponse(info: VersionInfo): Response {
+  return new Response(JSON.stringify(info), {
+    status: 200,
+    headers: {
+      "content-type": "application/json; charset=utf-8",
+      "cache-control": "no-store",
+    },
+  });
+}
+
+/**
+ * Answer a `/__version` request, or return null so the caller's normal
+ * routing proceeds. GET/HEAD only — anything else falls through.
+ */
+export function handleVersionRequest(request: Request, options: VersionOptions): Response | null {
+  if (request.method !== "GET" && request.method !== "HEAD") return null;
+  const paths = options.paths ?? [VERSION_PATH];
+  const { pathname } = new URL(request.url);
+  if (!paths.includes(pathname)) return null;
+  return versionResponse(versionInfo(options));
+}

package/src/version.gen.ts

@@ -0,0 +1,7 @@
+// AUTO-STAMPED by scripts/stamp-versions.ts at release — the checked-in
+// values are dev placeholders, identical to the runtime fallbacks.
+export const PKG = {
+  name: "@somewhatintelligent/kit",
+  version: "0.0.1-beta.1783705886.297c5be",
+  commit: "297c5be7d3af822a7f5da906acf27a076332609c",
+} as const;