@guidelytech/sveltekit 0.15.0 → 0.17.0

package/README.md

@@ -116,3 +116,38 @@ export {};
 
 Use the same attributes on the server as the browser will have (`id`, traits, `account`) so both
 agree; rollouts and experiments for anonymous visitors (no id on the server) settle in the browser.
+
+## Error monitoring
+
+`handleErrorWithGuidely` replaces Sentry's `handleErrorWithSentry` in both hooks. It reports the
+error with `contexts.sveltekit` (`routeId`, `status`, `message`), then calls your `handleError` (if
+any) and returns its result. 404s are not reported (`{ captureNotFound: true }` to report them).
+
+```ts
+// src/hooks.client.ts: through the browser client initGuidely() creates
+import { handleErrorWithGuidely } from "@guidelytech/sveltekit";
+export const handleError = handleErrorWithGuidely(({ error, message }) => ({ message: "Something went wrong" }));
+```
+
+```ts
+// src/hooks.server.ts: through a server client (@guidelytech/node, secret key)
+import { sequence } from "@sveltejs/kit/hooks";
+import { GUIDELY_SECRET_KEY } from "$env/static/private";
+import { Guidely } from "@guidelytech/node";
+import { guidelyHandle, handleErrorWithGuidely, setGuidelyServerClient } from "@guidelytech/sveltekit/server";
+
+setGuidelyServerClient(new Guidely({ secretKey: GUIDELY_SECRET_KEY, environment: "production" }));
+export const handle = sequence(guidelyHandle(), yourHandle);
+export const handleError = handleErrorWithGuidely();
+```
+
+| Export | Where | Description |
+|---|---|---|
+| `handleErrorWithGuidely(handleError?, options?)` | `@guidelytech/sveltekit` (client hook) | `mechanism: sveltekit.handleError`, tag `routeId`. Errors before `initGuidely()` has a client (a failing first `load`) are sent once it does. |
+| `handleErrorWithGuidely(handleError?, options?)` | `/server` (server hook) | Also sends the request (cookies, `Authorization` and other credential headers removed) and names the transaction `GET /blog/[slug]`. |
+| `guidelyHandle({ client? })` | `/server` | Runs each request in its own scope of the server client (`@guidelytech/node`: breadcrumbs, `setTag`/`setUser` per request). |
+| `setGuidelyServerClient(client)` | `/server` | Any object with `captureException(error, context)` (plus optional `flush()`, `withScope()`). No Node built-ins here: every adapter works. |
+
+Server reporting never throws into the request and never delays the response: the flush runs in
+the background (at most `flushTimeoutMs`, 2000 ms) under the platform's `waitUntil` (Cloudflare's
+`platform.context`, Vercel). On other serverless hosts pass `{ waitForFlush: true }`.

package/dist/index.cjs

@@ -24,14 +24,56 @@ __export(index_exports, {
   createServerFlags: () => createServerFlags,
   getFlags: () => getFlags,
   guidelyEnv: () => guidelyEnv,
+  handleErrorWithGuidely: () => handleErrorWithGuidely,
   initGuidely: () => initGuidely,
   loadFlags: () => loadFlags
 });
 module.exports = __toCommonJS(index_exports);
 var import_environment = require("$app/environment");
 var import_navigation = require("$app/navigation");
+var import_svelte2 = require("@guidelytech/svelte");
+var import_svelte3 = require("svelte");
+
+// src/client-errors.ts
+var import_sdk_core = require("@guidelytech/sdk-core");
 var import_svelte = require("@guidelytech/svelte");
-var import_svelte2 = require("svelte");
+var import_store = require("svelte/store");
+var pending = [];
+function drainPendingErrors(client) {
+  for (const [error, hint] of pending.splice(0)) {
+    try {
+      client.captureException(error, hint);
+    } catch {
+    }
+  }
+}
+function liveClient() {
+  try {
+    const c = (0, import_store.get)(import_svelte.guidely) ?? import_sdk_core.GuidelyClient.get();
+    return c && !c.getState().destroyed ? c : null;
+  } catch {
+    return null;
+  }
+}
+function handleErrorWithGuidely(handleError, options = {}) {
+  return (input) => {
+    try {
+      if (input?.status !== 404 || options.captureNotFound) {
+        const routeId = input?.event?.route?.id ?? null;
+        const hint = { ...routeId ? { tags: { routeId } } : {}, contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: { type: "sveltekit.handleError", handled: false } };
+        const client = liveClient();
+        if (client) client.captureException(input?.error, hint);
+        else if (pending.length < 10) pending.push([input?.error, hint]);
+      }
+    } catch {
+    }
+    if (handleError) return handleError(input);
+    console.error(input?.error);
+    return void 0;
+  };
+}
+
+// src/index.ts
 __reExport(index_exports, require("@guidelytech/svelte"), module.exports);
 
 // src/server.ts
@@ -90,25 +132,26 @@ async function loadFlags(input = {}, options = {}) {
 // src/index.ts
 function initGuidely(options) {
   if (!import_environment.browser) {
-    (0, import_svelte.setGuidelyContext)(null);
+    (0, import_svelte2.setGuidelyContext)(null);
     const flags = options.flags || void 0;
-    (0, import_svelte.setFlagsContext)(flags?.payload ? (0, import_svelte.createStaticFlags)({ payload: flags.payload, attributes: flags.attributes }) : null);
+    (0, import_svelte2.setFlagsContext)(flags?.payload ? (0, import_svelte2.createStaticFlags)({ payload: flags.payload, attributes: flags.attributes }) : null);
     return null;
   }
-  const client = (0, import_svelte.createGuidely)(options);
-  (0, import_svelte.setGuidelyContext)(client);
-  (0, import_svelte.setFlagsContext)(client);
+  const client = (0, import_svelte2.createGuidely)(options);
+  (0, import_svelte2.setGuidelyContext)(client);
+  (0, import_svelte2.setFlagsContext)(client);
+  drainPendingErrors(client);
   (0, import_navigation.afterNavigate)((nav) => {
     if (nav.type !== "enter") client.page(window.location.href);
   });
-  (0, import_svelte2.onDestroy)(() => {
-    if (guidelyStoreIs(client)) (0, import_svelte.destroyGuidely)();
+  (0, import_svelte3.onDestroy)(() => {
+    if (guidelyStoreIs(client)) (0, import_svelte2.destroyGuidely)();
   });
   return client;
 }
 function guidelyStoreIs(client) {
   let current = null;
-  import_svelte.guidely.subscribe((c) => current = c)();
+  import_svelte2.guidely.subscribe((c) => current = c)();
   return current === client;
 }
 function guidelyEnv(env2) {
@@ -124,6 +167,7 @@ function guidelyEnv(env2) {
   createServerFlags,
   getFlags,
   guidelyEnv,
+  handleErrorWithGuidely,
   initGuidely,
   loadFlags,
   ...require("@guidelytech/svelte")

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/server.ts"],"sourcesContent":["import { browser } from \"$app/environment\";\nimport { afterNavigate } from \"$app/navigation\";\nimport { createGuidely, createStaticFlags, destroyGuidely, guidely, setFlagsContext, setGuidelyContext, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/svelte\";\nimport { onDestroy } from \"svelte\";\n\nexport * from \"@guidelytech/svelte\";\n\n/**\n * Call once from the root `+layout.svelte` (during component initialisation). Creates the client\n * in the browser only, calls `page()` after every SvelteKit navigation and destroys the client\n * when the layout unmounts (HMR). Returns `null` on the server. Keep the signed-in user in step\n * with `syncGuidelyUser` (re-exported from `@guidelytech/svelte`).\n *\n * Pass `flags: data.flags` (from `loadFlags()` in `+layout.server.ts`) and the flag stores\n * render the same values on the server and in the browser.\n */\nexport function initGuidely(options: GuidelyOptions): GuidelyClient | null {\n  if (!browser) {\n    setGuidelyContext(null);\n    // Server render: flag stores read a snapshot of the bootstrap payload.\n    const flags = options.flags || undefined;\n    setFlagsContext(flags?.payload ? createStaticFlags({ payload: flags.payload, attributes: flags.attributes }) : null);\n    return null;\n  }\n  const client = createGuidely(options);\n  setGuidelyContext(client);\n  setFlagsContext(client);\n  afterNavigate((nav) => {\n    if (nav.type !== \"enter\") client.page(window.location.href);\n  });\n  onDestroy(() => {\n    if (guidelyStoreIs(client)) destroyGuidely();\n  });\n  return client;\n}\n\nfunction guidelyStoreIs(client: GuidelyClient): boolean {\n  let current: GuidelyClient | null = null;\n  guidely.subscribe((c) => (current = c))();\n  return current === client;\n}\n\n/**\n * Reads the public Guidely variables into client options: `VITE_GUIDELY_*` (from `import.meta.env`)\n * or SvelteKit's `PUBLIC_GUIDELY_*` (from `$env/static/public` or `$env/dynamic/public`).\n */\nexport function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, \"projectId\" | \"environment\" | \"apiUrl\" | \"release\"> {\n  return {\n    projectId: env.VITE_GUIDELY_PROJECT_ID || env.PUBLIC_GUIDELY_PROJECT_ID || \"\",\n    environment: ((env.VITE_GUIDELY_ENV || env.PUBLIC_GUIDELY_ENV) as GuidelyOptions[\"environment\"]) || undefined,\n    apiUrl: env.VITE_GUIDELY_API_URL || env.PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.VITE_GUIDELY_RELEASE || env.PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n\nexport { createServerFlags, getFlags, loadFlags } from \"./server\";\nexport type { LoadFlagsOptions } from \"./server\";\n","/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n"],"mappings":"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","names":["import_svelte","env"]}
+{"version":3,"sources":["../src/index.ts","../src/client-errors.ts","../src/server.ts"],"sourcesContent":["import { browser } from \"$app/environment\";\nimport { afterNavigate } from \"$app/navigation\";\nimport { createGuidely, createStaticFlags, destroyGuidely, guidely, setFlagsContext, setGuidelyContext, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/svelte\";\nimport { onDestroy } from \"svelte\";\nimport { drainPendingErrors } from \"./client-errors\";\n\nexport * from \"@guidelytech/svelte\";\nexport { handleErrorWithGuidely } from \"./client-errors\";\nexport type { ClientHandleErrorInput } from \"./client-errors\";\n\n/**\n * Call once from the root `+layout.svelte` (during component initialisation). Creates the client\n * in the browser only, calls `page()` after every SvelteKit navigation and destroys the client\n * when the layout unmounts (HMR). Returns `null` on the server. Keep the signed-in user in step\n * with `syncGuidelyUser` (re-exported from `@guidelytech/svelte`).\n *\n * Pass `flags: data.flags` (from `loadFlags()` in `+layout.server.ts`) and the flag stores\n * render the same values on the server and in the browser.\n */\nexport function initGuidely(options: GuidelyOptions): GuidelyClient | null {\n  if (!browser) {\n    setGuidelyContext(null);\n    // Server render: flag stores read a snapshot of the bootstrap payload.\n    const flags = options.flags || undefined;\n    setFlagsContext(flags?.payload ? createStaticFlags({ payload: flags.payload, attributes: flags.attributes }) : null);\n    return null;\n  }\n  const client = createGuidely(options);\n  setGuidelyContext(client);\n  setFlagsContext(client);\n  // Errors `handleErrorWithGuidely` saw before the client existed (a failing first `load`).\n  drainPendingErrors(client);\n  afterNavigate((nav) => {\n    if (nav.type !== \"enter\") client.page(window.location.href);\n  });\n  onDestroy(() => {\n    if (guidelyStoreIs(client)) destroyGuidely();\n  });\n  return client;\n}\n\nfunction guidelyStoreIs(client: GuidelyClient): boolean {\n  let current: GuidelyClient | null = null;\n  guidely.subscribe((c) => (current = c))();\n  return current === client;\n}\n\n/**\n * Reads the public Guidely variables into client options: `VITE_GUIDELY_*` (from `import.meta.env`)\n * or SvelteKit's `PUBLIC_GUIDELY_*` (from `$env/static/public` or `$env/dynamic/public`).\n */\nexport function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, \"projectId\" | \"environment\" | \"apiUrl\" | \"release\"> {\n  return {\n    projectId: env.VITE_GUIDELY_PROJECT_ID || env.PUBLIC_GUIDELY_PROJECT_ID || \"\",\n    environment: ((env.VITE_GUIDELY_ENV || env.PUBLIC_GUIDELY_ENV) as GuidelyOptions[\"environment\"]) || undefined,\n    apiUrl: env.VITE_GUIDELY_API_URL || env.PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.VITE_GUIDELY_RELEASE || env.PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n\nexport { createServerFlags, getFlags, loadFlags } from \"./server\";\nexport type { LoadFlagsOptions } from \"./server\";\n","import { GuidelyClient, type CaptureContext } from \"@guidelytech/sdk-core\";\nimport { guidely } from \"@guidelytech/svelte\";\nimport { get } from \"svelte/store\";\n\n/** `handleError`'s input in `hooks.client.ts`. */\nexport interface ClientHandleErrorInput {\n  error: unknown;\n  event: { route?: { id?: string | null }; url?: URL; params?: Record<string, string> };\n  status: number;\n  message: string;\n}\n\ntype Hint = CaptureContext & Record<string, unknown>;\n\n/**\n * Errors from before the client exists: a failing `load` on the first page runs before the root\n * layout's `initGuidely()` creates it. Sent by the next `initGuidely()` client.\n */\nconst pending: Array<[unknown, Hint]> = [];\n\n/** Sends the errors kept while no client existed (called by `initGuidely` once it has one). */\nexport function drainPendingErrors(client: GuidelyClient): void {\n  for (const [error, hint] of pending.splice(0)) {\n    try {\n      client.captureException(error, hint);\n    } catch {\n      // never throw into the app\n    }\n  }\n}\n\nfunction liveClient(): GuidelyClient | null {\n  try {\n    const c = get(guidely) ?? GuidelyClient.get();\n    return c && !c.getState().destroyed ? c : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * `handleError` for `hooks.client.ts` (Sentry's `handleErrorWithSentry`): reports the error with\n * `contexts.sveltekit` (`routeId`, `status`, `message`), then calls your `handleError` and returns\n * what it returns. 404s are not reported unless `captureNotFound`. Without a `handleError` of your\n * own the error is logged, as SvelteKit does.\n *\n * ```ts\n * // src/hooks.client.ts\n * import { handleErrorWithGuidely } from \"@guidelytech/sveltekit\";\n * export const handleError = handleErrorWithGuidely();\n * ```\n */\nexport function handleErrorWithGuidely<R = void>(handleError?: (input: ClientHandleErrorInput) => R, options: { captureNotFound?: boolean } = {}): (input: ClientHandleErrorInput) => R | undefined {\n  return (input) => {\n    try {\n      if (input?.status !== 404 || options.captureNotFound) {\n        const routeId = input?.event?.route?.id ?? null;\n        const hint: Hint = { ...(routeId ? { tags: { routeId } } : {}), contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: { type: \"sveltekit.handleError\", handled: false } };\n        const client = liveClient();\n        if (client) client.captureException(input?.error, hint);\n        else if (pending.length < 10) pending.push([input?.error, hint]);\n      }\n    } catch {\n      // never break the error page\n    }\n    if (handleError) return handleError(input);\n    console.error(input?.error);\n    return undefined;\n  };\n}\n","/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n\n// Error monitoring: `handleErrorWithGuidely` for hooks.server.ts and a request-scope `guidelyHandle()`.\nexport { captureServerError, guidelyHandle, handleErrorWithGuidely, setGuidelyServerClient } from \"./server-errors\";\nexport type { GuidelyServerErrorClient, RequestEventLike, ServerErrorOptions, ServerHandleErrorInput } from \"./server-errors\";\n"],"mappings":"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","names":["import_svelte","env"]}

package/dist/index.d.cts

@@ -2,6 +2,35 @@ import { GuidelyOptions, GuidelyClient } from '@guidelytech/svelte';
 export * from '@guidelytech/svelte';
 import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
 
+/** `handleError`'s input in `hooks.client.ts`. */
+interface ClientHandleErrorInput {
+    error: unknown;
+    event: {
+        route?: {
+            id?: string | null;
+        };
+        url?: URL;
+        params?: Record<string, string>;
+    };
+    status: number;
+    message: string;
+}
+/**
+ * `handleError` for `hooks.client.ts` (Sentry's `handleErrorWithSentry`): reports the error with
+ * `contexts.sveltekit` (`routeId`, `status`, `message`), then calls your `handleError` and returns
+ * what it returns. 404s are not reported unless `captureNotFound`. Without a `handleError` of your
+ * own the error is logged, as SvelteKit does.
+ *
+ * ```ts
+ * // src/hooks.client.ts
+ * import { handleErrorWithGuidely } from "@guidelytech/sveltekit";
+ * export const handleError = handleErrorWithGuidely();
+ * ```
+ */
+declare function handleErrorWithGuidely<R = void>(handleError?: (input: ClientHandleErrorInput) => R, options?: {
+    captureNotFound?: boolean;
+}): (input: ClientHandleErrorInput) => R | undefined;
+
 /**
  * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
  * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
@@ -63,4 +92,4 @@ declare function initGuidely(options: GuidelyOptions): GuidelyClient | null;
  */
 declare function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, "projectId" | "environment" | "apiUrl" | "release">;
 
-export { type LoadFlagsOptions, createServerFlags, getFlags, guidelyEnv, initGuidely, loadFlags };
+export { type ClientHandleErrorInput, type LoadFlagsOptions, createServerFlags, getFlags, guidelyEnv, handleErrorWithGuidely, initGuidely, loadFlags };

package/dist/index.d.ts

@@ -2,6 +2,35 @@ import { GuidelyOptions, GuidelyClient } from '@guidelytech/svelte';
 export * from '@guidelytech/svelte';
 import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
 
+/** `handleError`'s input in `hooks.client.ts`. */
+interface ClientHandleErrorInput {
+    error: unknown;
+    event: {
+        route?: {
+            id?: string | null;
+        };
+        url?: URL;
+        params?: Record<string, string>;
+    };
+    status: number;
+    message: string;
+}
+/**
+ * `handleError` for `hooks.client.ts` (Sentry's `handleErrorWithSentry`): reports the error with
+ * `contexts.sveltekit` (`routeId`, `status`, `message`), then calls your `handleError` and returns
+ * what it returns. 404s are not reported unless `captureNotFound`. Without a `handleError` of your
+ * own the error is logged, as SvelteKit does.
+ *
+ * ```ts
+ * // src/hooks.client.ts
+ * import { handleErrorWithGuidely } from "@guidelytech/sveltekit";
+ * export const handleError = handleErrorWithGuidely();
+ * ```
+ */
+declare function handleErrorWithGuidely<R = void>(handleError?: (input: ClientHandleErrorInput) => R, options?: {
+    captureNotFound?: boolean;
+}): (input: ClientHandleErrorInput) => R | undefined;
+
 /**
  * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
  * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
@@ -63,4 +92,4 @@ declare function initGuidely(options: GuidelyOptions): GuidelyClient | null;
  */
 declare function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, "projectId" | "environment" | "apiUrl" | "release">;
 
-export { type LoadFlagsOptions, createServerFlags, getFlags, guidelyEnv, initGuidely, loadFlags };
+export { type ClientHandleErrorInput, type LoadFlagsOptions, createServerFlags, getFlags, guidelyEnv, handleErrorWithGuidely, initGuidely, loadFlags };

package/dist/index.js

@@ -1,8 +1,49 @@
 // src/index.ts
 import { browser } from "$app/environment";
 import { afterNavigate } from "$app/navigation";
-import { createGuidely, createStaticFlags, destroyGuidely, guidely, setFlagsContext, setGuidelyContext } from "@guidelytech/svelte";
+import { createGuidely, createStaticFlags, destroyGuidely, guidely as guidely2, setFlagsContext, setGuidelyContext } from "@guidelytech/svelte";
 import { onDestroy } from "svelte";
+
+// src/client-errors.ts
+import { GuidelyClient } from "@guidelytech/sdk-core";
+import { guidely } from "@guidelytech/svelte";
+import { get } from "svelte/store";
+var pending = [];
+function drainPendingErrors(client) {
+  for (const [error, hint] of pending.splice(0)) {
+    try {
+      client.captureException(error, hint);
+    } catch {
+    }
+  }
+}
+function liveClient() {
+  try {
+    const c = get(guidely) ?? GuidelyClient.get();
+    return c && !c.getState().destroyed ? c : null;
+  } catch {
+    return null;
+  }
+}
+function handleErrorWithGuidely(handleError, options = {}) {
+  return (input) => {
+    try {
+      if (input?.status !== 404 || options.captureNotFound) {
+        const routeId = input?.event?.route?.id ?? null;
+        const hint = { ...routeId ? { tags: { routeId } } : {}, contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: { type: "sveltekit.handleError", handled: false } };
+        const client = liveClient();
+        if (client) client.captureException(input?.error, hint);
+        else if (pending.length < 10) pending.push([input?.error, hint]);
+      }
+    } catch {
+    }
+    if (handleError) return handleError(input);
+    console.error(input?.error);
+    return void 0;
+  };
+}
+
+// src/index.ts
 export * from "@guidelytech/svelte";
 
 // src/server.ts
@@ -69,6 +110,7 @@ function initGuidely(options) {
   const client = createGuidely(options);
   setGuidelyContext(client);
   setFlagsContext(client);
+  drainPendingErrors(client);
   afterNavigate((nav) => {
     if (nav.type !== "enter") client.page(window.location.href);
   });
@@ -79,7 +121,7 @@ function initGuidely(options) {
 }
 function guidelyStoreIs(client) {
   let current = null;
-  guidely.subscribe((c) => current = c)();
+  guidely2.subscribe((c) => current = c)();
   return current === client;
 }
 function guidelyEnv(env2) {
@@ -94,6 +136,7 @@ export {
   createServerFlags,
   getFlags,
   guidelyEnv,
+  handleErrorWithGuidely,
   initGuidely,
   loadFlags
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/server.ts"],"sourcesContent":["import { browser } from \"$app/environment\";\nimport { afterNavigate } from \"$app/navigation\";\nimport { createGuidely, createStaticFlags, destroyGuidely, guidely, setFlagsContext, setGuidelyContext, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/svelte\";\nimport { onDestroy } from \"svelte\";\n\nexport * from \"@guidelytech/svelte\";\n\n/**\n * Call once from the root `+layout.svelte` (during component initialisation). Creates the client\n * in the browser only, calls `page()` after every SvelteKit navigation and destroys the client\n * when the layout unmounts (HMR). Returns `null` on the server. Keep the signed-in user in step\n * with `syncGuidelyUser` (re-exported from `@guidelytech/svelte`).\n *\n * Pass `flags: data.flags` (from `loadFlags()` in `+layout.server.ts`) and the flag stores\n * render the same values on the server and in the browser.\n */\nexport function initGuidely(options: GuidelyOptions): GuidelyClient | null {\n  if (!browser) {\n    setGuidelyContext(null);\n    // Server render: flag stores read a snapshot of the bootstrap payload.\n    const flags = options.flags || undefined;\n    setFlagsContext(flags?.payload ? createStaticFlags({ payload: flags.payload, attributes: flags.attributes }) : null);\n    return null;\n  }\n  const client = createGuidely(options);\n  setGuidelyContext(client);\n  setFlagsContext(client);\n  afterNavigate((nav) => {\n    if (nav.type !== \"enter\") client.page(window.location.href);\n  });\n  onDestroy(() => {\n    if (guidelyStoreIs(client)) destroyGuidely();\n  });\n  return client;\n}\n\nfunction guidelyStoreIs(client: GuidelyClient): boolean {\n  let current: GuidelyClient | null = null;\n  guidely.subscribe((c) => (current = c))();\n  return current === client;\n}\n\n/**\n * Reads the public Guidely variables into client options: `VITE_GUIDELY_*` (from `import.meta.env`)\n * or SvelteKit's `PUBLIC_GUIDELY_*` (from `$env/static/public` or `$env/dynamic/public`).\n */\nexport function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, \"projectId\" | \"environment\" | \"apiUrl\" | \"release\"> {\n  return {\n    projectId: env.VITE_GUIDELY_PROJECT_ID || env.PUBLIC_GUIDELY_PROJECT_ID || \"\",\n    environment: ((env.VITE_GUIDELY_ENV || env.PUBLIC_GUIDELY_ENV) as GuidelyOptions[\"environment\"]) || undefined,\n    apiUrl: env.VITE_GUIDELY_API_URL || env.PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.VITE_GUIDELY_RELEASE || env.PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n\nexport { createServerFlags, getFlags, loadFlags } from \"./server\";\nexport type { LoadFlagsOptions } from \"./server\";\n","/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n"],"mappings":"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","names":["env"]}
+{"version":3,"sources":["../src/index.ts","../src/client-errors.ts","../src/server.ts"],"sourcesContent":["import { browser } from \"$app/environment\";\nimport { afterNavigate } from \"$app/navigation\";\nimport { createGuidely, createStaticFlags, destroyGuidely, guidely, setFlagsContext, setGuidelyContext, type GuidelyClient, type GuidelyOptions } from \"@guidelytech/svelte\";\nimport { onDestroy } from \"svelte\";\nimport { drainPendingErrors } from \"./client-errors\";\n\nexport * from \"@guidelytech/svelte\";\nexport { handleErrorWithGuidely } from \"./client-errors\";\nexport type { ClientHandleErrorInput } from \"./client-errors\";\n\n/**\n * Call once from the root `+layout.svelte` (during component initialisation). Creates the client\n * in the browser only, calls `page()` after every SvelteKit navigation and destroys the client\n * when the layout unmounts (HMR). Returns `null` on the server. Keep the signed-in user in step\n * with `syncGuidelyUser` (re-exported from `@guidelytech/svelte`).\n *\n * Pass `flags: data.flags` (from `loadFlags()` in `+layout.server.ts`) and the flag stores\n * render the same values on the server and in the browser.\n */\nexport function initGuidely(options: GuidelyOptions): GuidelyClient | null {\n  if (!browser) {\n    setGuidelyContext(null);\n    // Server render: flag stores read a snapshot of the bootstrap payload.\n    const flags = options.flags || undefined;\n    setFlagsContext(flags?.payload ? createStaticFlags({ payload: flags.payload, attributes: flags.attributes }) : null);\n    return null;\n  }\n  const client = createGuidely(options);\n  setGuidelyContext(client);\n  setFlagsContext(client);\n  // Errors `handleErrorWithGuidely` saw before the client existed (a failing first `load`).\n  drainPendingErrors(client);\n  afterNavigate((nav) => {\n    if (nav.type !== \"enter\") client.page(window.location.href);\n  });\n  onDestroy(() => {\n    if (guidelyStoreIs(client)) destroyGuidely();\n  });\n  return client;\n}\n\nfunction guidelyStoreIs(client: GuidelyClient): boolean {\n  let current: GuidelyClient | null = null;\n  guidely.subscribe((c) => (current = c))();\n  return current === client;\n}\n\n/**\n * Reads the public Guidely variables into client options: `VITE_GUIDELY_*` (from `import.meta.env`)\n * or SvelteKit's `PUBLIC_GUIDELY_*` (from `$env/static/public` or `$env/dynamic/public`).\n */\nexport function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, \"projectId\" | \"environment\" | \"apiUrl\" | \"release\"> {\n  return {\n    projectId: env.VITE_GUIDELY_PROJECT_ID || env.PUBLIC_GUIDELY_PROJECT_ID || \"\",\n    environment: ((env.VITE_GUIDELY_ENV || env.PUBLIC_GUIDELY_ENV) as GuidelyOptions[\"environment\"]) || undefined,\n    apiUrl: env.VITE_GUIDELY_API_URL || env.PUBLIC_GUIDELY_API_URL || undefined,\n    release: env.VITE_GUIDELY_RELEASE || env.PUBLIC_GUIDELY_RELEASE || undefined,\n  };\n}\n\nexport { createServerFlags, getFlags, loadFlags } from \"./server\";\nexport type { LoadFlagsOptions } from \"./server\";\n","import { GuidelyClient, type CaptureContext } from \"@guidelytech/sdk-core\";\nimport { guidely } from \"@guidelytech/svelte\";\nimport { get } from \"svelte/store\";\n\n/** `handleError`'s input in `hooks.client.ts`. */\nexport interface ClientHandleErrorInput {\n  error: unknown;\n  event: { route?: { id?: string | null }; url?: URL; params?: Record<string, string> };\n  status: number;\n  message: string;\n}\n\ntype Hint = CaptureContext & Record<string, unknown>;\n\n/**\n * Errors from before the client exists: a failing `load` on the first page runs before the root\n * layout's `initGuidely()` creates it. Sent by the next `initGuidely()` client.\n */\nconst pending: Array<[unknown, Hint]> = [];\n\n/** Sends the errors kept while no client existed (called by `initGuidely` once it has one). */\nexport function drainPendingErrors(client: GuidelyClient): void {\n  for (const [error, hint] of pending.splice(0)) {\n    try {\n      client.captureException(error, hint);\n    } catch {\n      // never throw into the app\n    }\n  }\n}\n\nfunction liveClient(): GuidelyClient | null {\n  try {\n    const c = get(guidely) ?? GuidelyClient.get();\n    return c && !c.getState().destroyed ? c : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * `handleError` for `hooks.client.ts` (Sentry's `handleErrorWithSentry`): reports the error with\n * `contexts.sveltekit` (`routeId`, `status`, `message`), then calls your `handleError` and returns\n * what it returns. 404s are not reported unless `captureNotFound`. Without a `handleError` of your\n * own the error is logged, as SvelteKit does.\n *\n * ```ts\n * // src/hooks.client.ts\n * import { handleErrorWithGuidely } from \"@guidelytech/sveltekit\";\n * export const handleError = handleErrorWithGuidely();\n * ```\n */\nexport function handleErrorWithGuidely<R = void>(handleError?: (input: ClientHandleErrorInput) => R, options: { captureNotFound?: boolean } = {}): (input: ClientHandleErrorInput) => R | undefined {\n  return (input) => {\n    try {\n      if (input?.status !== 404 || options.captureNotFound) {\n        const routeId = input?.event?.route?.id ?? null;\n        const hint: Hint = { ...(routeId ? { tags: { routeId } } : {}), contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: { type: \"sveltekit.handleError\", handled: false } };\n        const client = liveClient();\n        if (client) client.captureException(input?.error, hint);\n        else if (pending.length < 10) pending.push([input?.error, hint]);\n      }\n    } catch {\n      // never break the error page\n    }\n    if (handleError) return handleError(input);\n    console.error(input?.error);\n    return undefined;\n  };\n}\n","/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n\n// Error monitoring: `handleErrorWithGuidely` for hooks.server.ts and a request-scope `guidelyHandle()`.\nexport { captureServerError, guidelyHandle, handleErrorWithGuidely, setGuidelyServerClient } from \"./server-errors\";\nexport type { GuidelyServerErrorClient, RequestEventLike, ServerErrorOptions, ServerHandleErrorInput } from \"./server-errors\";\n"],"mappings":";AAAA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B,SAAS,eAAe,mBAAmB,gBAAgB,WAAAA,UAAS,iBAAiB,yBAAkE;AACvJ,SAAS,iBAAiB;;;ACH1B,SAAS,qBAA0C;AACnD,SAAS,eAAe;AACxB,SAAS,WAAW;AAgBpB,IAAM,UAAkC,CAAC;AAGlC,SAAS,mBAAmB,QAA6B;AAC9D,aAAW,CAAC,OAAO,IAAI,KAAK,QAAQ,OAAO,CAAC,GAAG;AAC7C,QAAI;AACF,aAAO,iBAAiB,OAAO,IAAI;AAAA,IACrC,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAEA,SAAS,aAAmC;AAC1C,MAAI;AACF,UAAM,IAAI,IAAI,OAAO,KAAK,cAAc,IAAI;AAC5C,WAAO,KAAK,CAAC,EAAE,SAAS,EAAE,YAAY,IAAI;AAAA,EAC5C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAcO,SAAS,uBAAiC,aAAoD,UAAyC,CAAC,GAAqD;AAClM,SAAO,CAAC,UAAU;AAChB,QAAI;AACF,UAAI,OAAO,WAAW,OAAO,QAAQ,iBAAiB;AACpD,cAAM,UAAU,OAAO,OAAO,OAAO,MAAM;AAC3C,cAAM,OAAa,EAAE,GAAI,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAI,UAAU,EAAE,WAAW,EAAE,SAAS,QAAQ,OAAO,QAAQ,SAAS,OAAO,QAAQ,EAAE,GAAG,WAAW,EAAE,MAAM,yBAAyB,SAAS,MAAM,EAAE;AACnN,cAAM,SAAS,WAAW;AAC1B,YAAI,OAAQ,QAAO,iBAAiB,OAAO,OAAO,IAAI;AAAA,iBAC7C,QAAQ,SAAS,GAAI,SAAQ,KAAK,CAAC,OAAO,OAAO,IAAI,CAAC;AAAA,MACjE;AAAA,IACF,QAAQ;AAAA,IAER;AACA,QAAI,YAAa,QAAO,YAAY,KAAK;AACzC,YAAQ,MAAM,OAAO,KAAK;AAC1B,WAAO;AAAA,EACT;AACF;;;AD/DA,cAAc;;;AEOd,SAAS,yBAA+H;AAWxI,SAAS,WAAqB;AAC5B,QAAM,IAAI;AACV,SAAQ,EAAE,4BAAF,EAAE,0BAA4B,EAAE,SAAS,oBAAI,IAAI,GAAG,SAAS,MAAM,QAAQ,oBAAI,IAAI,EAAE;AAC/F;AAEA,SAAS,IAAI,MAAkC;AAC7C,MAAI;AACF,WAAQ,WAA0E,SAAS,MAAM,IAAI,KAAK;AAAA,EAC5G,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,kBAAkB,UAAuC,CAAC,GAAgB;AACxF,QAAM,SAAS,QAAQ,UAAU,QAAQ,aAAa,IAAI,iBAAiB,KAAK,IAAI,2BAA2B;AAC/G,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gGAAgG;AAC7H,QAAM,SAAS,QAAQ,UAAU,IAAI,iBAAiB,KAAK,IAAI,wBAAwB;AACvF,QAAM,cAAc,QAAQ,eAAe,IAAI,aAAa,KAAK,IAAI,oBAAoB;AACzF,QAAM,KAAK,GAAG,MAAM,IAAI,UAAU,EAAE,IAAI,eAAe,EAAE,IAAI,QAAQ,eAAe,MAAM;AAC1F,QAAM,MAAM,SAAS;AACrB,MAAI,SAAS,IAAI,QAAQ,IAAI,EAAE;AAC/B,MAAI,CAAC,QAAQ;AACX,aAAS,kBAAkB,EAAE,SAAS,OAAO,GAAG,SAAS,QAAQ,QAAQ,YAAY,CAAC;AACtF,QAAI,QAAQ,IAAI,IAAI,MAAM;AAAA,EAC5B;AACA,MAAI,UAAU;AACd,SAAO;AACT;AASA,SAAS,OAAO,QAAqB,WAAkC;AACrE,MAAI,OAAO,QAAQ,EAAG,QAAO,QAAQ,QAAQ;AAC7C,SAAO,QAAQ,KAAK,CAAC,OAAO,MAAM,GAAG,IAAI,QAAc,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC;AAC1F;AAGA,eAAsB,SAAS,aAAyB,CAAC,GAAG,UAA4B,CAAC,GAA4B;AACnH,QAAM,SAAS,QAAQ,UAAU,SAAS,EAAE,WAAW,kBAAkB;AACzE,QAAM,OAAO,QAAQ,QAAQ,aAAa,IAAI;AAC9C,SAAO,OAAO,QAAQ,UAAU;AAClC;AASA,eAAsB,UAAU,QAA4F,CAAC,GAAG,UAA4B,CAAC,GAAwE;AACnO,QAAM,SAAU,MAAgF;AAChG,QAAM,aAAa,UAAU,OAAO,WAAW,WAAY,OAAO,OAAO,gBAAgB,KAAK,CAAC,IAAM;AACrG,QAAM,SAAS,QAAQ,UAAU,SAAS,EAAE,WAAW,kBAAkB;AACzE,MAAI,OAAO,OAAO,WAAW,SAAS,GAAG;AACvC,UAAM,MAAM,SAAS;AACrB,QAAI,CAAC,IAAI,OAAO,IAAI,OAAO,MAAM,GAAG;AAClC,UAAI,OAAO,IAAI,OAAO,MAAM;AAC5B,cAAQ,KAAK,uLAAkL;AAAA,IACjM;AACA,WAAO,EAAE,SAAS,MAAM,WAAW;AAAA,EACrC;AACA,QAAM,OAAO,QAAQ,QAAQ,aAAa,IAAI;AAC9C,SAAO,EAAE,SAAS,OAAO,WAAW,GAAG,WAAW;AACpD;;;AFhFO,SAAS,YAAY,SAA+C;AACzE,MAAI,CAAC,SAAS;AACZ,sBAAkB,IAAI;AAEtB,UAAM,QAAQ,QAAQ,SAAS;AAC/B,oBAAgB,OAAO,UAAU,kBAAkB,EAAE,SAAS,MAAM,SAAS,YAAY,MAAM,WAAW,CAAC,IAAI,IAAI;AACnH,WAAO;AAAA,EACT;AACA,QAAM,SAAS,cAAc,OAAO;AACpC,oBAAkB,MAAM;AACxB,kBAAgB,MAAM;AAEtB,qBAAmB,MAAM;AACzB,gBAAc,CAAC,QAAQ;AACrB,QAAI,IAAI,SAAS,QAAS,QAAO,KAAK,OAAO,SAAS,IAAI;AAAA,EAC5D,CAAC;AACD,YAAU,MAAM;AACd,QAAI,eAAe,MAAM,EAAG,gBAAe;AAAA,EAC7C,CAAC;AACD,SAAO;AACT;AAEA,SAAS,eAAe,QAAgC;AACtD,MAAI,UAAgC;AACpC,EAAAC,SAAQ,UAAU,CAAC,MAAO,UAAU,CAAE,EAAE;AACxC,SAAO,YAAY;AACrB;AAMO,SAAS,WAAWC,MAAmH;AAC5I,SAAO;AAAA,IACL,WAAWA,KAAI,2BAA2BA,KAAI,6BAA6B;AAAA,IAC3E,aAAeA,KAAI,oBAAoBA,KAAI,sBAAyD;AAAA,IACpG,QAAQA,KAAI,wBAAwBA,KAAI,0BAA0B;AAAA,IAClE,SAASA,KAAI,wBAAwBA,KAAI,0BAA0B;AAAA,EACrE;AACF;","names":["guidely","guidely","env"]}

package/dist/server.cjs

@@ -20,13 +20,156 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
+  captureServerError: () => captureServerError,
   createServerFlags: () => createServerFlags,
   getFlags: () => getFlags,
-  loadFlags: () => loadFlags
+  guidelyHandle: () => guidelyHandle,
+  handleErrorWithGuidely: () => handleErrorWithGuidely,
+  loadFlags: () => loadFlags,
+  setGuidelyServerClient: () => setGuidelyServerClient
 });
 module.exports = __toCommonJS(server_exports);
 var import_flags = require("@guidelytech/flags");
+
+// src/server-errors.ts
 function registry() {
+  const g = globalThis;
+  return g.__guidelySvelteKitErrors ?? (g.__guidelySvelteKitErrors = { client: null, reported: /* @__PURE__ */ new WeakSet(), warned: false });
+}
+function setGuidelyServerClient(client) {
+  registry().client = client;
+}
+var SENSITIVE_HEADER = /^(?:cookie|set-cookie|authorization|proxy-authorization)$|token|secret|password|api[-_]?key|session|csrf/i;
+function safeHeaders(headers) {
+  const out = {};
+  const add = (name, value) => {
+    if (Object.keys(out).length >= 50 || value === void 0 || value === null || SENSITIVE_HEADER.test(name)) return;
+    out[name.toLowerCase()] = (Array.isArray(value) ? value.join(", ") : String(value)).slice(0, 1e3);
+  };
+  try {
+    const h = headers;
+    if (h && typeof h.forEach === "function" && !Array.isArray(h)) h.forEach((value, name) => add(name, value));
+    else if (h && typeof h === "object") for (const [name, value] of Object.entries(h)) add(name, value);
+  } catch {
+  }
+  return out;
+}
+function waitUntilOf(event) {
+  try {
+    const p = event?.platform;
+    const own = p?.context?.waitUntil ?? p?.waitUntil;
+    if (typeof own === "function") return (promise) => own.call(p?.context ?? p, promise);
+    const g = globalThis;
+    const vercel = g[/* @__PURE__ */ Symbol.for("@vercel/request-context")]?.get?.()?.waitUntil;
+    if (typeof vercel === "function") return vercel;
+  } catch {
+  }
+  return void 0;
+}
+function flushSoon(client, options, event) {
+  const timeout = options.flushTimeoutMs ?? 2e3;
+  if (typeof client.flush !== "function" || timeout <= 0) return void 0;
+  let timer;
+  const p = Promise.race([
+    Promise.resolve().then(() => client.flush()).catch(() => {
+    }),
+    new Promise((resolve) => {
+      timer = setTimeout(resolve, timeout);
+      timer.unref?.();
+    })
+  ]).finally(() => clearTimeout(timer));
+  const waitUntil = waitUntilOf(event);
+  if (waitUntil) {
+    try {
+      waitUntil(p);
+    } catch {
+    }
+  }
+  return p;
+}
+var transactionOf = (event) => {
+  const route = event?.route?.id;
+  if (!route) return void 0;
+  const method = typeof event?.request?.method === "string" ? event.request.method.toUpperCase() : "";
+  return `${method ? `${method} ` : ""}${route}`.slice(0, 200);
+};
+function captureServerError(error, input, options = {}) {
+  try {
+    const reg = registry();
+    const client = options.client ?? reg.client;
+    if (!client) {
+      if (!reg.warned) {
+        reg.warned = true;
+        console.warn("[Guidely] A server error was not reported: no server client. Call setGuidelyServerClient(new Guidely({ secretKey, environment })) in hooks.server.ts.");
+      }
+      return { eventId: "" };
+    }
+    if (error && typeof error === "object") {
+      if (reg.reported.has(error)) return { eventId: "" };
+      reg.reported.add(error);
+    }
+    const req = input.event?.request;
+    const ctx = {
+      level: "error",
+      ...input.tags ? { tags: input.tags } : {},
+      ...input.contexts ? { contexts: input.contexts } : {},
+      ...req && typeof req === "object" ? { request: { method: typeof req.method === "string" ? req.method.toUpperCase() : void 0, url: typeof req.url === "string" ? req.url : void 0, headers: safeHeaders(req.headers) } } : {},
+      mechanism: { type: input.mechanism, handled: false }
+    };
+    const transaction = transactionOf(input.event);
+    const run = () => client.captureException(error, ctx);
+    const id = transaction && typeof client.withScope === "function" ? client.withScope((scope) => {
+      scope.setTransactionName?.(transaction);
+      return run();
+    }) : run();
+    return { eventId: typeof id === "string" ? id : "", flushed: flushSoon(client, options, input.event) };
+  } catch {
+    return { eventId: "" };
+  }
+}
+function handleErrorWithGuidely(handleError, options = {}) {
+  return async (input) => {
+    try {
+      if (input?.status !== 404 || options.captureNotFound) {
+        const routeId = input?.event?.route?.id ?? null;
+        const { flushed } = captureServerError(input?.error, { event: input?.event, tags: routeId ? { routeId } : void 0, contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: "sveltekit.handleError" }, options);
+        if (options.waitForFlush && flushed) await flushed;
+      }
+    } catch {
+    }
+    if (handleError) return handleError(input);
+    console.error(input?.error);
+    return void 0;
+  };
+}
+function guidelyHandle(options = {}) {
+  return ({ event, resolve }) => {
+    let client = null;
+    try {
+      client = options.client ?? registry().client;
+    } catch {
+      client = null;
+    }
+    if (!client || typeof client.withScope !== "function") return resolve(event);
+    let entered = false;
+    try {
+      return client.withScope((scope) => {
+        entered = true;
+        try {
+          scope.setTransactionName?.(transactionOf(event));
+        } catch {
+        }
+        return resolve(event);
+      });
+    } catch (error) {
+      if (!entered) return resolve(event);
+      throw error;
+    }
+  };
+}
+
+// src/server.ts
+function registry2() {
   const g = globalThis;
   return g.__guidelySvelteKitFlags ?? (g.__guidelySvelteKitFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
 }
@@ -43,7 +186,7 @@ function createServerFlags(options = {}) {
   const apiUrl = options.apiUrl ?? env("GUIDELY_API_URL") ?? env("PUBLIC_GUIDELY_API_URL");
   const environment = options.environment ?? env("GUIDELY_ENV") ?? env("PUBLIC_GUIDELY_ENV");
   const id = `${sdkKey}|${apiUrl ?? ""}|${environment ?? ""}|${options.pollingMode ?? "auto"}`;
-  const reg = registry();
+  const reg = registry2();
   let client = reg.clients.get(id);
   if (!client) {
     client = (0, import_flags.createFlagsClient)({ storage: false, ...options, sdkKey, apiUrl, environment });
@@ -57,16 +200,16 @@ function settle(client, timeoutMs) {
   return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
 }
 async function getFlags(attributes = {}, options = {}) {
-  const client = options.client ?? registry().current ?? createServerFlags();
+  const client = options.client ?? registry2().current ?? createServerFlags();
   await settle(client, options.timeoutMs ?? 1500);
   return client.forUser(attributes);
 }
 async function loadFlags(input = {}, options = {}) {
   const locals = input.locals;
   const attributes = locals && typeof locals === "object" ? locals.flags?.getAttributes?.() ?? {} : input;
-  const client = options.client ?? registry().current ?? createServerFlags();
+  const client = options.client ?? registry2().current ?? createServerFlags();
   if (client.sdkKey.startsWith("gly_sk_")) {
-    const reg = registry();
+    const reg = registry2();
     if (!reg.warned.has(client.sdkKey)) {
       reg.warned.add(client.sdkKey);
       console.warn("[Guidely] loadFlags() needs a public-key client (pk_\u2026): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.");
@@ -78,8 +221,12 @@ async function loadFlags(input = {}, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  captureServerError,
   createServerFlags,
   getFlags,
-  loadFlags
+  guidelyHandle,
+  handleErrorWithGuidely,
+  loadFlags,
+  setGuidelyServerClient
 });
 //# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,mBAAwI;AAWxI,SAAS,WAAqB;AAC5B,QAAM,IAAI;AACV,SAAQ,EAAE,4BAAF,EAAE,0BAA4B,EAAE,SAAS,oBAAI,IAAI,GAAG,SAAS,MAAM,QAAQ,oBAAI,IAAI,EAAE;AAC/F;AAEA,SAAS,IAAI,MAAkC;AAC7C,MAAI;AACF,WAAQ,WAA0E,SAAS,MAAM,IAAI,KAAK;AAAA,EAC5G,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,kBAAkB,UAAuC,CAAC,GAAgB;AACxF,QAAM,SAAS,QAAQ,UAAU,QAAQ,aAAa,IAAI,iBAAiB,KAAK,IAAI,2BAA2B;AAC/G,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gGAAgG;AAC7H,QAAM,SAAS,QAAQ,UAAU,IAAI,iBAAiB,KAAK,IAAI,wBAAwB;AACvF,QAAM,cAAc,QAAQ,eAAe,IAAI,aAAa,KAAK,IAAI,oBAAoB;AACzF,QAAM,KAAK,GAAG,MAAM,IAAI,UAAU,EAAE,IAAI,eAAe,EAAE,IAAI,QAAQ,eAAe,MAAM;AAC1F,QAAM,MAAM,SAAS;AACrB,MAAI,SAAS,IAAI,QAAQ,IAAI,EAAE;AAC/B,MAAI,CAAC,QAAQ;AACX,iBAAS,gCAAkB,EAAE,SAAS,OAAO,GAAG,SAAS,QAAQ,QAAQ,YAAY,CAAC;AACtF,QAAI,QAAQ,IAAI,IAAI,MAAM;AAAA,EAC5B;AACA,MAAI,UAAU;AACd,SAAO;AACT;AASA,SAAS,OAAO,QAAqB,WAAkC;AACrE,MAAI,OAAO,QAAQ,EAAG,QAAO,QAAQ,QAAQ;AAC7C,SAAO,QAAQ,KAAK,CAAC,OAAO,MAAM,GAAG,IAAI,QAAc,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC;AAC1F;AAGA,eAAsB,SAAS,aAAyB,CAAC,GAAG,UAA4B,CAAC,GAA4B;AACnH,QAAM,SAAS,QAAQ,UAAU,SAAS,EAAE,WAAW,kBAAkB;AACzE,QAAM,OAAO,QAAQ,QAAQ,aAAa,IAAI;AAC9C,SAAO,OAAO,QAAQ,UAAU;AAClC;AASA,eAAsB,UAAU,QAA4F,CAAC,GAAG,UAA4B,CAAC,GAAwE;AACnO,QAAM,SAAU,MAAgF;AAChG,QAAM,aAAa,UAAU,OAAO,WAAW,WAAY,OAAO,OAAO,gBAAgB,KAAK,CAAC,IAAM;AACrG,QAAM,SAAS,QAAQ,UAAU,SAAS,EAAE,WAAW,kBAAkB;AACzE,MAAI,OAAO,OAAO,WAAW,SAAS,GAAG;AACvC,UAAM,MAAM,SAAS;AACrB,QAAI,CAAC,IAAI,OAAO,IAAI,OAAO,MAAM,GAAG;AAClC,UAAI,OAAO,IAAI,OAAO,MAAM;AAC5B,cAAQ,KAAK,uLAAkL;AAAA,IACjM;AACA,WAAO,EAAE,SAAS,MAAM,WAAW;AAAA,EACrC;AACA,QAAM,OAAO,QAAQ,QAAQ,aAAa,IAAI;AAC9C,SAAO,EAAE,SAAS,OAAO,WAAW,GAAG,WAAW;AACpD;","names":[]}
+{"version":3,"sources":["../src/server.ts","../src/server-errors.ts"],"sourcesContent":["/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n\n// Error monitoring: `handleErrorWithGuidely` for hooks.server.ts and a request-scope `guidelyHandle()`.\nexport { captureServerError, guidelyHandle, handleErrorWithGuidely, setGuidelyServerClient } from \"./server-errors\";\nexport type { GuidelyServerErrorClient, RequestEventLike, ServerErrorOptions, ServerHandleErrorInput } from \"./server-errors\";\n","/**\n * Server-side error monitoring for SvelteKit: `handleErrorWithGuidely` for `hooks.server.ts` and a\n * `guidelyHandle()` for `sequence(...)`. Errors go to a server Guidely client you register once\n * (`@guidelytech/node`'s `Guidely`, or anything with its `captureException`), typed structurally so\n * this entry has no Node built-ins and runs on every adapter (Node, Vercel, Cloudflare, Netlify).\n * Nothing here throws into the request, and nothing waits for the network on the request's path.\n */\n\n/** What capture uses from a server client; `new Guidely({ secretKey, environment })` from `@guidelytech/node` fits. */\nexport interface GuidelyServerErrorClient {\n  captureException(error: unknown, context?: Record<string, unknown>): string | void;\n  /** Sends what is queued; used (bounded by `flushTimeoutMs`) to get the error out before a serverless function freezes. */\n  flush?(): Promise<void>;\n  /** Request scopes (breadcrumbs, tags per request) and the event's transaction name (`GET /blog/[slug]`). */\n  withScope?<T>(fn: (scope: { setTransactionName?(name: string | undefined): unknown }) => T): T;\n}\n\nexport interface ServerErrorOptions {\n  /** The client to report to (default: the one given to `setGuidelyServerClient`). */\n  client?: GuidelyServerErrorClient | null;\n  /** Longest the background flush may run (default 2000 ms; 0 skips it). */\n  flushTimeoutMs?: number;\n  /** Wait for the flush before answering, for serverless hosts with no `waitUntil`. Default false. */\n  waitForFlush?: boolean;\n  /** Report 404s too (default false: a missing page is not an error, as in Sentry). */\n  captureNotFound?: boolean;\n}\n\ninterface ErrorRegistry {\n  client: GuidelyServerErrorClient | null;\n  reported: WeakSet<object>;\n  warned: boolean;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads keep the registered client. */\nfunction registry(): ErrorRegistry {\n  const g = globalThis as { __guidelySvelteKitErrors?: ErrorRegistry };\n  return (g.__guidelySvelteKitErrors ??= { client: null, reported: new WeakSet(), warned: false });\n}\n\n/** Registers the server client every capture here reports to (call it once in `hooks.server.ts`). */\nexport function setGuidelyServerClient(client: GuidelyServerErrorClient | null): void {\n  registry().client = client;\n}\n\n/** Credentials never leave the server: cookies, auth headers and anything named like a secret. */\nconst SENSITIVE_HEADER = /^(?:cookie|set-cookie|authorization|proxy-authorization)$|token|secret|password|api[-_]?key|session|csrf/i;\n\n/** Request headers without credentials, as a plain record (at most 50, values ≤ 1000 characters). */\nexport function safeHeaders(headers: unknown): Record<string, string> {\n  const out: Record<string, string> = {};\n  const add = (name: string, value: unknown) => {\n    if (Object.keys(out).length >= 50 || value === undefined || value === null || SENSITIVE_HEADER.test(name)) return;\n    out[name.toLowerCase()] = (Array.isArray(value) ? value.join(\", \") : String(value)).slice(0, 1000);\n  };\n  try {\n    const h = headers as { forEach?: (cb: (value: string, name: string) => void) => void } | null;\n    if (h && typeof h.forEach === \"function\" && !Array.isArray(h)) h.forEach((value, name) => add(name, value));\n    else if (h && typeof h === \"object\") for (const [name, value] of Object.entries(h)) add(name, value);\n  } catch {\n    // unreadable headers: report without them\n  }\n  return out;\n}\n\ntype WaitUntil = (promise: Promise<unknown>) => void;\n\n/** The platform's `waitUntil` for this request: Cloudflare's `platform.context`, else Vercel's request context. */\nfunction waitUntilOf(event: RequestEventLike | undefined): WaitUntil | undefined {\n  try {\n    const p = event?.platform as { context?: { waitUntil?: unknown }; waitUntil?: unknown } | undefined;\n    const own = p?.context?.waitUntil ?? p?.waitUntil;\n    if (typeof own === \"function\") return (promise) => (own as WaitUntil).call(p?.context ?? p, promise);\n    const g = globalThis as Record<symbol, { get?: () => { waitUntil?: WaitUntil } | undefined } | undefined>;\n    const vercel = g[Symbol.for(\"@vercel/request-context\")]?.get?.()?.waitUntil;\n    if (typeof vercel === \"function\") return vercel;\n  } catch {\n    // no request context\n  }\n  return undefined;\n}\n\n/** Flushes in the background, bounded by `flushTimeoutMs`; the promise never rejects. */\nfunction flushSoon(client: GuidelyServerErrorClient, options: ServerErrorOptions, event: RequestEventLike | undefined): Promise<void> | undefined {\n  const timeout = options.flushTimeoutMs ?? 2000;\n  if (typeof client.flush !== \"function\" || timeout <= 0) return undefined;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const p = Promise.race([\n    Promise.resolve()\n      .then(() => client.flush!())\n      .catch(() => {}),\n    new Promise<void>((resolve) => {\n      timer = setTimeout(resolve, timeout);\n      (timer as { unref?: () => void }).unref?.();\n    }),\n  ]).finally(() => clearTimeout(timer));\n  const waitUntil = waitUntilOf(event);\n  if (waitUntil) {\n    try {\n      waitUntil(p);\n    } catch {\n      // the request already ended\n    }\n  }\n  return p;\n}\n\n/** The parts of SvelteKit's `RequestEvent` capture reads. */\nexport interface RequestEventLike {\n  request?: { method?: string; url?: string; headers?: unknown };\n  route?: { id?: string | null };\n  url?: URL | { href?: string; pathname?: string };\n  platform?: unknown;\n}\n\n/** `handleError`'s input in `hooks.server.ts`. */\nexport interface ServerHandleErrorInput {\n  error: unknown;\n  event: RequestEventLike;\n  status: number;\n  message: string;\n}\n\nconst transactionOf = (event: RequestEventLike | undefined): string | undefined => {\n  const route = event?.route?.id;\n  if (!route) return undefined;\n  const method = typeof event?.request?.method === \"string\" ? event.request.method.toUpperCase() : \"\";\n  return `${method ? `${method} ` : \"\"}${route}`.slice(0, 200);\n};\n\n/**\n * Reports one server error (once per error object) and starts a bounded background flush.\n * Returns the event id (\"\" when nothing was reported) and the flush.\n */\nexport function captureServerError(error: unknown, input: { event?: RequestEventLike; contexts?: Record<string, Record<string, unknown>>; tags?: Record<string, string>; mechanism: string }, options: ServerErrorOptions = {}): { eventId: string; flushed?: Promise<void> } {\n  try {\n    const reg = registry();\n    const client = options.client ?? reg.client;\n    if (!client) {\n      if (!reg.warned) {\n        reg.warned = true;\n        console.warn(\"[Guidely] A server error was not reported: no server client. Call setGuidelyServerClient(new Guidely({ secretKey, environment })) in hooks.server.ts.\");\n      }\n      return { eventId: \"\" };\n    }\n    if (error && typeof error === \"object\") {\n      if (reg.reported.has(error)) return { eventId: \"\" };\n      reg.reported.add(error);\n    }\n    const req = input.event?.request;\n    const ctx: Record<string, unknown> = {\n      level: \"error\",\n      ...(input.tags ? { tags: input.tags } : {}),\n      ...(input.contexts ? { contexts: input.contexts } : {}),\n      ...(req && typeof req === \"object\" ? { request: { method: typeof req.method === \"string\" ? req.method.toUpperCase() : undefined, url: typeof req.url === \"string\" ? req.url : undefined, headers: safeHeaders(req.headers) } } : {}),\n      mechanism: { type: input.mechanism, handled: false },\n    };\n    const transaction = transactionOf(input.event);\n    const run = () => client.captureException(error, ctx);\n    const id = transaction && typeof client.withScope === \"function\"\n      ? client.withScope((scope) => {\n          scope.setTransactionName?.(transaction);\n          return run();\n        })\n      : run();\n    return { eventId: typeof id === \"string\" ? id : \"\", flushed: flushSoon(client, options, input.event) };\n  } catch {\n    return { eventId: \"\" };\n  }\n}\n\n/**\n * `handleError` for `hooks.server.ts` (Sentry's `handleErrorWithSentry`): reports the error with\n * the request (credentials removed) and `contexts.sveltekit` (`routeId`, `status`, `message`), then\n * calls your `handleError` and returns what it returns. 404s are not reported unless\n * `captureNotFound`. Without a `handleError` of your own the error is logged, as SvelteKit does.\n *\n * ```ts\n * // src/hooks.server.ts\n * import { Guidely } from \"@guidelytech/node\";\n * import { handleErrorWithGuidely, setGuidelyServerClient } from \"@guidelytech/sveltekit/server\";\n * setGuidelyServerClient(new Guidely({ secretKey: GUIDELY_SECRET_KEY, environment: \"production\" }));\n * export const handleError = handleErrorWithGuidely(({ error, event, status, message }) => ({ message: \"Something went wrong\" }));\n * ```\n */\nexport function handleErrorWithGuidely<R = void>(handleError?: (input: ServerHandleErrorInput) => R | Promise<R>, options: ServerErrorOptions = {}): (input: ServerHandleErrorInput) => Promise<R | undefined> {\n  return async (input) => {\n    try {\n      if (input?.status !== 404 || options.captureNotFound) {\n        const routeId = input?.event?.route?.id ?? null;\n        const { flushed } = captureServerError(input?.error, { event: input?.event, tags: routeId ? { routeId } : undefined, contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: \"sveltekit.handleError\" }, options);\n        if (options.waitForFlush && flushed) await flushed;\n      }\n    } catch {\n      // never break the error page\n    }\n    if (handleError) return handleError(input);\n    console.error(input?.error);\n    return undefined;\n  };\n}\n\n/**\n * A server `handle` for `sequence(guidelyHandle(), …)`: runs each request in its own scope of the\n * server client when it has scopes (`@guidelytech/node` does: breadcrumbs, `setTag` and `setUser`\n * calls made while handling the request stay with its errors), named `GET /blog/[slug]`.\n */\nexport function guidelyHandle(options: Pick<ServerErrorOptions, \"client\"> = {}): <E extends RequestEventLike, T>(input: { event: E; resolve: (event: E) => T }) => T {\n  return ({ event, resolve }) => {\n    let client: GuidelyServerErrorClient | null = null;\n    try {\n      client = options.client ?? registry().client;\n    } catch {\n      client = null;\n    }\n    if (!client || typeof client.withScope !== \"function\") return resolve(event);\n    let entered = false;\n    try {\n      return client.withScope((scope) => {\n        entered = true;\n        try {\n          scope.setTransactionName?.(transactionOf(event));\n        } catch {\n          // a scope without names\n        }\n        return resolve(event);\n      });\n    } catch (error) {\n      // A failure inside the scope machinery must not swallow the request: resolve it plainly.\n      if (!entered) return resolve(event);\n      throw error;\n    }\n  };\n}\n"],"mappings":"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","names":["registry"]}

package/dist/server.d.cts

@@ -1,6 +1,96 @@
 import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
 export { Attributes, FlagDetails, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, JsonValue } from '@guidelytech/flags';
 
+/**
+ * Server-side error monitoring for SvelteKit: `handleErrorWithGuidely` for `hooks.server.ts` and a
+ * `guidelyHandle()` for `sequence(...)`. Errors go to a server Guidely client you register once
+ * (`@guidelytech/node`'s `Guidely`, or anything with its `captureException`), typed structurally so
+ * this entry has no Node built-ins and runs on every adapter (Node, Vercel, Cloudflare, Netlify).
+ * Nothing here throws into the request, and nothing waits for the network on the request's path.
+ */
+/** What capture uses from a server client; `new Guidely({ secretKey, environment })` from `@guidelytech/node` fits. */
+interface GuidelyServerErrorClient {
+    captureException(error: unknown, context?: Record<string, unknown>): string | void;
+    /** Sends what is queued; used (bounded by `flushTimeoutMs`) to get the error out before a serverless function freezes. */
+    flush?(): Promise<void>;
+    /** Request scopes (breadcrumbs, tags per request) and the event's transaction name (`GET /blog/[slug]`). */
+    withScope?<T>(fn: (scope: {
+        setTransactionName?(name: string | undefined): unknown;
+    }) => T): T;
+}
+interface ServerErrorOptions {
+    /** The client to report to (default: the one given to `setGuidelyServerClient`). */
+    client?: GuidelyServerErrorClient | null;
+    /** Longest the background flush may run (default 2000 ms; 0 skips it). */
+    flushTimeoutMs?: number;
+    /** Wait for the flush before answering, for serverless hosts with no `waitUntil`. Default false. */
+    waitForFlush?: boolean;
+    /** Report 404s too (default false: a missing page is not an error, as in Sentry). */
+    captureNotFound?: boolean;
+}
+/** Registers the server client every capture here reports to (call it once in `hooks.server.ts`). */
+declare function setGuidelyServerClient(client: GuidelyServerErrorClient | null): void;
+/** The parts of SvelteKit's `RequestEvent` capture reads. */
+interface RequestEventLike {
+    request?: {
+        method?: string;
+        url?: string;
+        headers?: unknown;
+    };
+    route?: {
+        id?: string | null;
+    };
+    url?: URL | {
+        href?: string;
+        pathname?: string;
+    };
+    platform?: unknown;
+}
+/** `handleError`'s input in `hooks.server.ts`. */
+interface ServerHandleErrorInput {
+    error: unknown;
+    event: RequestEventLike;
+    status: number;
+    message: string;
+}
+/**
+ * Reports one server error (once per error object) and starts a bounded background flush.
+ * Returns the event id ("" when nothing was reported) and the flush.
+ */
+declare function captureServerError(error: unknown, input: {
+    event?: RequestEventLike;
+    contexts?: Record<string, Record<string, unknown>>;
+    tags?: Record<string, string>;
+    mechanism: string;
+}, options?: ServerErrorOptions): {
+    eventId: string;
+    flushed?: Promise<void>;
+};
+/**
+ * `handleError` for `hooks.server.ts` (Sentry's `handleErrorWithSentry`): reports the error with
+ * the request (credentials removed) and `contexts.sveltekit` (`routeId`, `status`, `message`), then
+ * calls your `handleError` and returns what it returns. 404s are not reported unless
+ * `captureNotFound`. Without a `handleError` of your own the error is logged, as SvelteKit does.
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * import { Guidely } from "@guidelytech/node";
+ * import { handleErrorWithGuidely, setGuidelyServerClient } from "@guidelytech/sveltekit/server";
+ * setGuidelyServerClient(new Guidely({ secretKey: GUIDELY_SECRET_KEY, environment: "production" }));
+ * export const handleError = handleErrorWithGuidely(({ error, event, status, message }) => ({ message: "Something went wrong" }));
+ * ```
+ */
+declare function handleErrorWithGuidely<R = void>(handleError?: (input: ServerHandleErrorInput) => R | Promise<R>, options?: ServerErrorOptions): (input: ServerHandleErrorInput) => Promise<R | undefined>;
+/**
+ * A server `handle` for `sequence(guidelyHandle(), …)`: runs each request in its own scope of the
+ * server client when it has scopes (`@guidelytech/node` does: breadcrumbs, `setTag` and `setUser`
+ * calls made while handling the request stay with its errors), named `GET /blog/[slug]`.
+ */
+declare function guidelyHandle(options?: Pick<ServerErrorOptions, "client">): <E extends RequestEventLike, T>(input: {
+    event: E;
+    resolve: (event: E) => T;
+}) => T;
+
 /**
  * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
  * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
@@ -46,4 +136,4 @@ declare function loadFlags(input?: {
     attributes: Attributes;
 }>;
 
-export { type LoadFlagsOptions, createServerFlags, getFlags, loadFlags };
+export { type GuidelyServerErrorClient, type LoadFlagsOptions, type RequestEventLike, type ServerErrorOptions, type ServerHandleErrorInput, captureServerError, createServerFlags, getFlags, guidelyHandle, handleErrorWithGuidely, loadFlags, setGuidelyServerClient };

package/dist/server.d.ts

@@ -1,6 +1,96 @@
 import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
 export { Attributes, FlagDetails, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, JsonValue } from '@guidelytech/flags';
 
+/**
+ * Server-side error monitoring for SvelteKit: `handleErrorWithGuidely` for `hooks.server.ts` and a
+ * `guidelyHandle()` for `sequence(...)`. Errors go to a server Guidely client you register once
+ * (`@guidelytech/node`'s `Guidely`, or anything with its `captureException`), typed structurally so
+ * this entry has no Node built-ins and runs on every adapter (Node, Vercel, Cloudflare, Netlify).
+ * Nothing here throws into the request, and nothing waits for the network on the request's path.
+ */
+/** What capture uses from a server client; `new Guidely({ secretKey, environment })` from `@guidelytech/node` fits. */
+interface GuidelyServerErrorClient {
+    captureException(error: unknown, context?: Record<string, unknown>): string | void;
+    /** Sends what is queued; used (bounded by `flushTimeoutMs`) to get the error out before a serverless function freezes. */
+    flush?(): Promise<void>;
+    /** Request scopes (breadcrumbs, tags per request) and the event's transaction name (`GET /blog/[slug]`). */
+    withScope?<T>(fn: (scope: {
+        setTransactionName?(name: string | undefined): unknown;
+    }) => T): T;
+}
+interface ServerErrorOptions {
+    /** The client to report to (default: the one given to `setGuidelyServerClient`). */
+    client?: GuidelyServerErrorClient | null;
+    /** Longest the background flush may run (default 2000 ms; 0 skips it). */
+    flushTimeoutMs?: number;
+    /** Wait for the flush before answering, for serverless hosts with no `waitUntil`. Default false. */
+    waitForFlush?: boolean;
+    /** Report 404s too (default false: a missing page is not an error, as in Sentry). */
+    captureNotFound?: boolean;
+}
+/** Registers the server client every capture here reports to (call it once in `hooks.server.ts`). */
+declare function setGuidelyServerClient(client: GuidelyServerErrorClient | null): void;
+/** The parts of SvelteKit's `RequestEvent` capture reads. */
+interface RequestEventLike {
+    request?: {
+        method?: string;
+        url?: string;
+        headers?: unknown;
+    };
+    route?: {
+        id?: string | null;
+    };
+    url?: URL | {
+        href?: string;
+        pathname?: string;
+    };
+    platform?: unknown;
+}
+/** `handleError`'s input in `hooks.server.ts`. */
+interface ServerHandleErrorInput {
+    error: unknown;
+    event: RequestEventLike;
+    status: number;
+    message: string;
+}
+/**
+ * Reports one server error (once per error object) and starts a bounded background flush.
+ * Returns the event id ("" when nothing was reported) and the flush.
+ */
+declare function captureServerError(error: unknown, input: {
+    event?: RequestEventLike;
+    contexts?: Record<string, Record<string, unknown>>;
+    tags?: Record<string, string>;
+    mechanism: string;
+}, options?: ServerErrorOptions): {
+    eventId: string;
+    flushed?: Promise<void>;
+};
+/**
+ * `handleError` for `hooks.server.ts` (Sentry's `handleErrorWithSentry`): reports the error with
+ * the request (credentials removed) and `contexts.sveltekit` (`routeId`, `status`, `message`), then
+ * calls your `handleError` and returns what it returns. 404s are not reported unless
+ * `captureNotFound`. Without a `handleError` of your own the error is logged, as SvelteKit does.
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * import { Guidely } from "@guidelytech/node";
+ * import { handleErrorWithGuidely, setGuidelyServerClient } from "@guidelytech/sveltekit/server";
+ * setGuidelyServerClient(new Guidely({ secretKey: GUIDELY_SECRET_KEY, environment: "production" }));
+ * export const handleError = handleErrorWithGuidely(({ error, event, status, message }) => ({ message: "Something went wrong" }));
+ * ```
+ */
+declare function handleErrorWithGuidely<R = void>(handleError?: (input: ServerHandleErrorInput) => R | Promise<R>, options?: ServerErrorOptions): (input: ServerHandleErrorInput) => Promise<R | undefined>;
+/**
+ * A server `handle` for `sequence(guidelyHandle(), …)`: runs each request in its own scope of the
+ * server client when it has scopes (`@guidelytech/node` does: breadcrumbs, `setTag` and `setUser`
+ * calls made while handling the request stay with its errors), named `GET /blog/[slug]`.
+ */
+declare function guidelyHandle(options?: Pick<ServerErrorOptions, "client">): <E extends RequestEventLike, T>(input: {
+    event: E;
+    resolve: (event: E) => T;
+}) => T;
+
 /**
  * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
  * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
@@ -46,4 +136,4 @@ declare function loadFlags(input?: {
     attributes: Attributes;
 }>;
 
-export { type LoadFlagsOptions, createServerFlags, getFlags, loadFlags };
+export { type GuidelyServerErrorClient, type LoadFlagsOptions, type RequestEventLike, type ServerErrorOptions, type ServerHandleErrorInput, captureServerError, createServerFlags, getFlags, guidelyHandle, handleErrorWithGuidely, loadFlags, setGuidelyServerClient };

package/dist/server.js

@@ -1,6 +1,145 @@
 // src/server.ts
 import { createFlagsClient } from "@guidelytech/flags";
+
+// src/server-errors.ts
 function registry() {
+  const g = globalThis;
+  return g.__guidelySvelteKitErrors ?? (g.__guidelySvelteKitErrors = { client: null, reported: /* @__PURE__ */ new WeakSet(), warned: false });
+}
+function setGuidelyServerClient(client) {
+  registry().client = client;
+}
+var SENSITIVE_HEADER = /^(?:cookie|set-cookie|authorization|proxy-authorization)$|token|secret|password|api[-_]?key|session|csrf/i;
+function safeHeaders(headers) {
+  const out = {};
+  const add = (name, value) => {
+    if (Object.keys(out).length >= 50 || value === void 0 || value === null || SENSITIVE_HEADER.test(name)) return;
+    out[name.toLowerCase()] = (Array.isArray(value) ? value.join(", ") : String(value)).slice(0, 1e3);
+  };
+  try {
+    const h = headers;
+    if (h && typeof h.forEach === "function" && !Array.isArray(h)) h.forEach((value, name) => add(name, value));
+    else if (h && typeof h === "object") for (const [name, value] of Object.entries(h)) add(name, value);
+  } catch {
+  }
+  return out;
+}
+function waitUntilOf(event) {
+  try {
+    const p = event?.platform;
+    const own = p?.context?.waitUntil ?? p?.waitUntil;
+    if (typeof own === "function") return (promise) => own.call(p?.context ?? p, promise);
+    const g = globalThis;
+    const vercel = g[/* @__PURE__ */ Symbol.for("@vercel/request-context")]?.get?.()?.waitUntil;
+    if (typeof vercel === "function") return vercel;
+  } catch {
+  }
+  return void 0;
+}
+function flushSoon(client, options, event) {
+  const timeout = options.flushTimeoutMs ?? 2e3;
+  if (typeof client.flush !== "function" || timeout <= 0) return void 0;
+  let timer;
+  const p = Promise.race([
+    Promise.resolve().then(() => client.flush()).catch(() => {
+    }),
+    new Promise((resolve) => {
+      timer = setTimeout(resolve, timeout);
+      timer.unref?.();
+    })
+  ]).finally(() => clearTimeout(timer));
+  const waitUntil = waitUntilOf(event);
+  if (waitUntil) {
+    try {
+      waitUntil(p);
+    } catch {
+    }
+  }
+  return p;
+}
+var transactionOf = (event) => {
+  const route = event?.route?.id;
+  if (!route) return void 0;
+  const method = typeof event?.request?.method === "string" ? event.request.method.toUpperCase() : "";
+  return `${method ? `${method} ` : ""}${route}`.slice(0, 200);
+};
+function captureServerError(error, input, options = {}) {
+  try {
+    const reg = registry();
+    const client = options.client ?? reg.client;
+    if (!client) {
+      if (!reg.warned) {
+        reg.warned = true;
+        console.warn("[Guidely] A server error was not reported: no server client. Call setGuidelyServerClient(new Guidely({ secretKey, environment })) in hooks.server.ts.");
+      }
+      return { eventId: "" };
+    }
+    if (error && typeof error === "object") {
+      if (reg.reported.has(error)) return { eventId: "" };
+      reg.reported.add(error);
+    }
+    const req = input.event?.request;
+    const ctx = {
+      level: "error",
+      ...input.tags ? { tags: input.tags } : {},
+      ...input.contexts ? { contexts: input.contexts } : {},
+      ...req && typeof req === "object" ? { request: { method: typeof req.method === "string" ? req.method.toUpperCase() : void 0, url: typeof req.url === "string" ? req.url : void 0, headers: safeHeaders(req.headers) } } : {},
+      mechanism: { type: input.mechanism, handled: false }
+    };
+    const transaction = transactionOf(input.event);
+    const run = () => client.captureException(error, ctx);
+    const id = transaction && typeof client.withScope === "function" ? client.withScope((scope) => {
+      scope.setTransactionName?.(transaction);
+      return run();
+    }) : run();
+    return { eventId: typeof id === "string" ? id : "", flushed: flushSoon(client, options, input.event) };
+  } catch {
+    return { eventId: "" };
+  }
+}
+function handleErrorWithGuidely(handleError, options = {}) {
+  return async (input) => {
+    try {
+      if (input?.status !== 404 || options.captureNotFound) {
+        const routeId = input?.event?.route?.id ?? null;
+        const { flushed } = captureServerError(input?.error, { event: input?.event, tags: routeId ? { routeId } : void 0, contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: "sveltekit.handleError" }, options);
+        if (options.waitForFlush && flushed) await flushed;
+      }
+    } catch {
+    }
+    if (handleError) return handleError(input);
+    console.error(input?.error);
+    return void 0;
+  };
+}
+function guidelyHandle(options = {}) {
+  return ({ event, resolve }) => {
+    let client = null;
+    try {
+      client = options.client ?? registry().client;
+    } catch {
+      client = null;
+    }
+    if (!client || typeof client.withScope !== "function") return resolve(event);
+    let entered = false;
+    try {
+      return client.withScope((scope) => {
+        entered = true;
+        try {
+          scope.setTransactionName?.(transactionOf(event));
+        } catch {
+        }
+        return resolve(event);
+      });
+    } catch (error) {
+      if (!entered) return resolve(event);
+      throw error;
+    }
+  };
+}
+
+// src/server.ts
+function registry2() {
   const g = globalThis;
   return g.__guidelySvelteKitFlags ?? (g.__guidelySvelteKitFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
 }
@@ -17,7 +156,7 @@ function createServerFlags(options = {}) {
   const apiUrl = options.apiUrl ?? env("GUIDELY_API_URL") ?? env("PUBLIC_GUIDELY_API_URL");
   const environment = options.environment ?? env("GUIDELY_ENV") ?? env("PUBLIC_GUIDELY_ENV");
   const id = `${sdkKey}|${apiUrl ?? ""}|${environment ?? ""}|${options.pollingMode ?? "auto"}`;
-  const reg = registry();
+  const reg = registry2();
   let client = reg.clients.get(id);
   if (!client) {
     client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });
@@ -31,16 +170,16 @@ function settle(client, timeoutMs) {
   return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
 }
 async function getFlags(attributes = {}, options = {}) {
-  const client = options.client ?? registry().current ?? createServerFlags();
+  const client = options.client ?? registry2().current ?? createServerFlags();
   await settle(client, options.timeoutMs ?? 1500);
   return client.forUser(attributes);
 }
 async function loadFlags(input = {}, options = {}) {
   const locals = input.locals;
   const attributes = locals && typeof locals === "object" ? locals.flags?.getAttributes?.() ?? {} : input;
-  const client = options.client ?? registry().current ?? createServerFlags();
+  const client = options.client ?? registry2().current ?? createServerFlags();
   if (client.sdkKey.startsWith("gly_sk_")) {
-    const reg = registry();
+    const reg = registry2();
     if (!reg.warned.has(client.sdkKey)) {
       reg.warned.add(client.sdkKey);
       console.warn("[Guidely] loadFlags() needs a public-key client (pk_\u2026): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.");
@@ -51,8 +190,12 @@ async function loadFlags(input = {}, options = {}) {
   return { payload: client.getPayload(), attributes };
 }
 export {
+  captureServerError,
   createServerFlags,
   getFlags,
-  loadFlags
+  guidelyHandle,
+  handleErrorWithGuidely,
+  loadFlags,
+  setGuidelyServerClient
 };
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n"],"mappings":";AAaA,SAAS,yBAA+H;AAWxI,SAAS,WAAqB;AAC5B,QAAM,IAAI;AACV,SAAQ,EAAE,4BAAF,EAAE,0BAA4B,EAAE,SAAS,oBAAI,IAAI,GAAG,SAAS,MAAM,QAAQ,oBAAI,IAAI,EAAE;AAC/F;AAEA,SAAS,IAAI,MAAkC;AAC7C,MAAI;AACF,WAAQ,WAA0E,SAAS,MAAM,IAAI,KAAK;AAAA,EAC5G,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,kBAAkB,UAAuC,CAAC,GAAgB;AACxF,QAAM,SAAS,QAAQ,UAAU,QAAQ,aAAa,IAAI,iBAAiB,KAAK,IAAI,2BAA2B;AAC/G,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gGAAgG;AAC7H,QAAM,SAAS,QAAQ,UAAU,IAAI,iBAAiB,KAAK,IAAI,wBAAwB;AACvF,QAAM,cAAc,QAAQ,eAAe,IAAI,aAAa,KAAK,IAAI,oBAAoB;AACzF,QAAM,KAAK,GAAG,MAAM,IAAI,UAAU,EAAE,IAAI,eAAe,EAAE,IAAI,QAAQ,eAAe,MAAM;AAC1F,QAAM,MAAM,SAAS;AACrB,MAAI,SAAS,IAAI,QAAQ,IAAI,EAAE;AAC/B,MAAI,CAAC,QAAQ;AACX,aAAS,kBAAkB,EAAE,SAAS,OAAO,GAAG,SAAS,QAAQ,QAAQ,YAAY,CAAC;AACtF,QAAI,QAAQ,IAAI,IAAI,MAAM;AAAA,EAC5B;AACA,MAAI,UAAU;AACd,SAAO;AACT;AASA,SAAS,OAAO,QAAqB,WAAkC;AACrE,MAAI,OAAO,QAAQ,EAAG,QAAO,QAAQ,QAAQ;AAC7C,SAAO,QAAQ,KAAK,CAAC,OAAO,MAAM,GAAG,IAAI,QAAc,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC;AAC1F;AAGA,eAAsB,SAAS,aAAyB,CAAC,GAAG,UAA4B,CAAC,GAA4B;AACnH,QAAM,SAAS,QAAQ,UAAU,SAAS,EAAE,WAAW,kBAAkB;AACzE,QAAM,OAAO,QAAQ,QAAQ,aAAa,IAAI;AAC9C,SAAO,OAAO,QAAQ,UAAU;AAClC;AASA,eAAsB,UAAU,QAA4F,CAAC,GAAG,UAA4B,CAAC,GAAwE;AACnO,QAAM,SAAU,MAAgF;AAChG,QAAM,aAAa,UAAU,OAAO,WAAW,WAAY,OAAO,OAAO,gBAAgB,KAAK,CAAC,IAAM;AACrG,QAAM,SAAS,QAAQ,UAAU,SAAS,EAAE,WAAW,kBAAkB;AACzE,MAAI,OAAO,OAAO,WAAW,SAAS,GAAG;AACvC,UAAM,MAAM,SAAS;AACrB,QAAI,CAAC,IAAI,OAAO,IAAI,OAAO,MAAM,GAAG;AAClC,UAAI,OAAO,IAAI,OAAO,MAAM;AAC5B,cAAQ,KAAK,uLAAkL;AAAA,IACjM;AACA,WAAO,EAAE,SAAS,MAAM,WAAW;AAAA,EACrC;AACA,QAAM,OAAO,QAAQ,QAAQ,aAAa,IAAI;AAC9C,SAAO,EAAE,SAAS,OAAO,WAAW,GAAG,WAAW;AACpD;","names":[]}
+{"version":3,"sources":["../src/server.ts","../src/server-errors.ts"],"sourcesContent":["/**\n * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,\n * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.\n *\n * ```ts\n * // src/hooks.server.ts\n * const flags = createServerFlags();\n * export const handle = async ({ event, resolve }) => {\n *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });\n *   return resolve(event);\n * };\n * ```\n */\nimport { createFlagsClient, type Attributes, type FlagsBootstrap, type FlagsClient, type FlagsClientOptions, type FlagsEvaluator } from \"@guidelytech/flags\";\n\nexport type { Attributes, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, FlagDetails, JsonValue } from \"@guidelytech/flags\";\n\ninterface Registry {\n  clients: Map<string, FlagsClient>;\n  current: FlagsClient | null;\n  warned: Set<string>;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads reuse the client (and its timers). */\nfunction registry(): Registry {\n  const g = globalThis as { __guidelySvelteKitFlags?: Registry };\n  return (g.__guidelySvelteKitFlags ??= { clients: new Map(), current: null, warned: new Set() });\n}\n\nfunction env(name: string): string | undefined {\n  try {\n    return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name] || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The process-wide flags client (created once, reused across requests). Options default to\n * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,\n * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls\n * every 60 s; on serverless / edge adapters use `{ pollingMode: \"lazy\" }`.\n */\nexport function createServerFlags(options: Partial<FlagsClientOptions> = {}): FlagsClient {\n  const sdkKey = options.sdkKey ?? options.projectId ?? env(\"GUIDELY_SDK_KEY\") ?? env(\"PUBLIC_GUIDELY_PROJECT_ID\");\n  if (!sdkKey) throw new Error(\"[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.\");\n  const apiUrl = options.apiUrl ?? env(\"GUIDELY_API_URL\") ?? env(\"PUBLIC_GUIDELY_API_URL\");\n  const environment = options.environment ?? env(\"GUIDELY_ENV\") ?? env(\"PUBLIC_GUIDELY_ENV\");\n  const id = `${sdkKey}|${apiUrl ?? \"\"}|${environment ?? \"\"}|${options.pollingMode ?? \"auto\"}`;\n  const reg = registry();\n  let client = reg.clients.get(id);\n  if (!client) {\n    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });\n    reg.clients.set(id, client);\n  }\n  reg.current = client;\n  return client;\n}\n\nexport interface LoadFlagsOptions {\n  /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */\n  client?: FlagsClient;\n  /** How long to wait for the first download before serving fallbacks (default 1500 ms). */\n  timeoutMs?: number;\n}\n\nfunction settle(client: FlagsClient, timeoutMs: number): Promise<void> {\n  if (client.isReady()) return Promise.resolve();\n  return Promise.race([client.ready(), new Promise<void>((r) => setTimeout(r, timeoutMs))]);\n}\n\n/** Flag getters for one user, for this request (waits briefly for the first download). */\nexport async function getFlags(attributes: Attributes = {}, options: LoadFlagsOptions = {}): Promise<FlagsEvaluator> {\n  const client = options.client ?? registry().current ?? createServerFlags();\n  await settle(client, options.timeoutMs ?? 1500);\n  return client.forUser(attributes);\n}\n\n/**\n * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render\n * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in\n * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.\n * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a\n * public-key client instead.\n */\nexport async function loadFlags(input: { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } } | Attributes = {}, options: LoadFlagsOptions = {}): Promise<{ payload: FlagsBootstrap | null; attributes: Attributes }> {\n  const locals = (input as { locals?: { flags?: Pick<FlagsEvaluator, \"getAttributes\"> | null } }).locals;\n  const attributes = locals && typeof locals === \"object\" ? (locals.flags?.getAttributes?.() ?? {}) : (input as Attributes);\n  const client = options.client ?? registry().current ?? createServerFlags();\n  if (client.sdkKey.startsWith(\"gly_sk_\")) {\n    const reg = registry();\n    if (!reg.warned.has(client.sdkKey)) {\n      reg.warned.add(client.sdkKey);\n      console.warn(\"[Guidely] loadFlags() needs a public-key client (pk_…): a gly_sk_ payload includes server-only flags. Pass { client: createServerFlags({ sdkKey: PUBLIC_GUIDELY_PROJECT_ID }) }.\");\n    }\n    return { payload: null, attributes };\n  }\n  await settle(client, options.timeoutMs ?? 1500);\n  return { payload: client.getPayload(), attributes };\n}\n\n// Error monitoring: `handleErrorWithGuidely` for hooks.server.ts and a request-scope `guidelyHandle()`.\nexport { captureServerError, guidelyHandle, handleErrorWithGuidely, setGuidelyServerClient } from \"./server-errors\";\nexport type { GuidelyServerErrorClient, RequestEventLike, ServerErrorOptions, ServerHandleErrorInput } from \"./server-errors\";\n","/**\n * Server-side error monitoring for SvelteKit: `handleErrorWithGuidely` for `hooks.server.ts` and a\n * `guidelyHandle()` for `sequence(...)`. Errors go to a server Guidely client you register once\n * (`@guidelytech/node`'s `Guidely`, or anything with its `captureException`), typed structurally so\n * this entry has no Node built-ins and runs on every adapter (Node, Vercel, Cloudflare, Netlify).\n * Nothing here throws into the request, and nothing waits for the network on the request's path.\n */\n\n/** What capture uses from a server client; `new Guidely({ secretKey, environment })` from `@guidelytech/node` fits. */\nexport interface GuidelyServerErrorClient {\n  captureException(error: unknown, context?: Record<string, unknown>): string | void;\n  /** Sends what is queued; used (bounded by `flushTimeoutMs`) to get the error out before a serverless function freezes. */\n  flush?(): Promise<void>;\n  /** Request scopes (breadcrumbs, tags per request) and the event's transaction name (`GET /blog/[slug]`). */\n  withScope?<T>(fn: (scope: { setTransactionName?(name: string | undefined): unknown }) => T): T;\n}\n\nexport interface ServerErrorOptions {\n  /** The client to report to (default: the one given to `setGuidelyServerClient`). */\n  client?: GuidelyServerErrorClient | null;\n  /** Longest the background flush may run (default 2000 ms; 0 skips it). */\n  flushTimeoutMs?: number;\n  /** Wait for the flush before answering, for serverless hosts with no `waitUntil`. Default false. */\n  waitForFlush?: boolean;\n  /** Report 404s too (default false: a missing page is not an error, as in Sentry). */\n  captureNotFound?: boolean;\n}\n\ninterface ErrorRegistry {\n  client: GuidelyServerErrorClient | null;\n  reported: WeakSet<object>;\n  warned: boolean;\n}\n\n/** Kept on `globalThis` so Vite's dev-server reloads keep the registered client. */\nfunction registry(): ErrorRegistry {\n  const g = globalThis as { __guidelySvelteKitErrors?: ErrorRegistry };\n  return (g.__guidelySvelteKitErrors ??= { client: null, reported: new WeakSet(), warned: false });\n}\n\n/** Registers the server client every capture here reports to (call it once in `hooks.server.ts`). */\nexport function setGuidelyServerClient(client: GuidelyServerErrorClient | null): void {\n  registry().client = client;\n}\n\n/** Credentials never leave the server: cookies, auth headers and anything named like a secret. */\nconst SENSITIVE_HEADER = /^(?:cookie|set-cookie|authorization|proxy-authorization)$|token|secret|password|api[-_]?key|session|csrf/i;\n\n/** Request headers without credentials, as a plain record (at most 50, values ≤ 1000 characters). */\nexport function safeHeaders(headers: unknown): Record<string, string> {\n  const out: Record<string, string> = {};\n  const add = (name: string, value: unknown) => {\n    if (Object.keys(out).length >= 50 || value === undefined || value === null || SENSITIVE_HEADER.test(name)) return;\n    out[name.toLowerCase()] = (Array.isArray(value) ? value.join(\", \") : String(value)).slice(0, 1000);\n  };\n  try {\n    const h = headers as { forEach?: (cb: (value: string, name: string) => void) => void } | null;\n    if (h && typeof h.forEach === \"function\" && !Array.isArray(h)) h.forEach((value, name) => add(name, value));\n    else if (h && typeof h === \"object\") for (const [name, value] of Object.entries(h)) add(name, value);\n  } catch {\n    // unreadable headers: report without them\n  }\n  return out;\n}\n\ntype WaitUntil = (promise: Promise<unknown>) => void;\n\n/** The platform's `waitUntil` for this request: Cloudflare's `platform.context`, else Vercel's request context. */\nfunction waitUntilOf(event: RequestEventLike | undefined): WaitUntil | undefined {\n  try {\n    const p = event?.platform as { context?: { waitUntil?: unknown }; waitUntil?: unknown } | undefined;\n    const own = p?.context?.waitUntil ?? p?.waitUntil;\n    if (typeof own === \"function\") return (promise) => (own as WaitUntil).call(p?.context ?? p, promise);\n    const g = globalThis as Record<symbol, { get?: () => { waitUntil?: WaitUntil } | undefined } | undefined>;\n    const vercel = g[Symbol.for(\"@vercel/request-context\")]?.get?.()?.waitUntil;\n    if (typeof vercel === \"function\") return vercel;\n  } catch {\n    // no request context\n  }\n  return undefined;\n}\n\n/** Flushes in the background, bounded by `flushTimeoutMs`; the promise never rejects. */\nfunction flushSoon(client: GuidelyServerErrorClient, options: ServerErrorOptions, event: RequestEventLike | undefined): Promise<void> | undefined {\n  const timeout = options.flushTimeoutMs ?? 2000;\n  if (typeof client.flush !== \"function\" || timeout <= 0) return undefined;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const p = Promise.race([\n    Promise.resolve()\n      .then(() => client.flush!())\n      .catch(() => {}),\n    new Promise<void>((resolve) => {\n      timer = setTimeout(resolve, timeout);\n      (timer as { unref?: () => void }).unref?.();\n    }),\n  ]).finally(() => clearTimeout(timer));\n  const waitUntil = waitUntilOf(event);\n  if (waitUntil) {\n    try {\n      waitUntil(p);\n    } catch {\n      // the request already ended\n    }\n  }\n  return p;\n}\n\n/** The parts of SvelteKit's `RequestEvent` capture reads. */\nexport interface RequestEventLike {\n  request?: { method?: string; url?: string; headers?: unknown };\n  route?: { id?: string | null };\n  url?: URL | { href?: string; pathname?: string };\n  platform?: unknown;\n}\n\n/** `handleError`'s input in `hooks.server.ts`. */\nexport interface ServerHandleErrorInput {\n  error: unknown;\n  event: RequestEventLike;\n  status: number;\n  message: string;\n}\n\nconst transactionOf = (event: RequestEventLike | undefined): string | undefined => {\n  const route = event?.route?.id;\n  if (!route) return undefined;\n  const method = typeof event?.request?.method === \"string\" ? event.request.method.toUpperCase() : \"\";\n  return `${method ? `${method} ` : \"\"}${route}`.slice(0, 200);\n};\n\n/**\n * Reports one server error (once per error object) and starts a bounded background flush.\n * Returns the event id (\"\" when nothing was reported) and the flush.\n */\nexport function captureServerError(error: unknown, input: { event?: RequestEventLike; contexts?: Record<string, Record<string, unknown>>; tags?: Record<string, string>; mechanism: string }, options: ServerErrorOptions = {}): { eventId: string; flushed?: Promise<void> } {\n  try {\n    const reg = registry();\n    const client = options.client ?? reg.client;\n    if (!client) {\n      if (!reg.warned) {\n        reg.warned = true;\n        console.warn(\"[Guidely] A server error was not reported: no server client. Call setGuidelyServerClient(new Guidely({ secretKey, environment })) in hooks.server.ts.\");\n      }\n      return { eventId: \"\" };\n    }\n    if (error && typeof error === \"object\") {\n      if (reg.reported.has(error)) return { eventId: \"\" };\n      reg.reported.add(error);\n    }\n    const req = input.event?.request;\n    const ctx: Record<string, unknown> = {\n      level: \"error\",\n      ...(input.tags ? { tags: input.tags } : {}),\n      ...(input.contexts ? { contexts: input.contexts } : {}),\n      ...(req && typeof req === \"object\" ? { request: { method: typeof req.method === \"string\" ? req.method.toUpperCase() : undefined, url: typeof req.url === \"string\" ? req.url : undefined, headers: safeHeaders(req.headers) } } : {}),\n      mechanism: { type: input.mechanism, handled: false },\n    };\n    const transaction = transactionOf(input.event);\n    const run = () => client.captureException(error, ctx);\n    const id = transaction && typeof client.withScope === \"function\"\n      ? client.withScope((scope) => {\n          scope.setTransactionName?.(transaction);\n          return run();\n        })\n      : run();\n    return { eventId: typeof id === \"string\" ? id : \"\", flushed: flushSoon(client, options, input.event) };\n  } catch {\n    return { eventId: \"\" };\n  }\n}\n\n/**\n * `handleError` for `hooks.server.ts` (Sentry's `handleErrorWithSentry`): reports the error with\n * the request (credentials removed) and `contexts.sveltekit` (`routeId`, `status`, `message`), then\n * calls your `handleError` and returns what it returns. 404s are not reported unless\n * `captureNotFound`. Without a `handleError` of your own the error is logged, as SvelteKit does.\n *\n * ```ts\n * // src/hooks.server.ts\n * import { Guidely } from \"@guidelytech/node\";\n * import { handleErrorWithGuidely, setGuidelyServerClient } from \"@guidelytech/sveltekit/server\";\n * setGuidelyServerClient(new Guidely({ secretKey: GUIDELY_SECRET_KEY, environment: \"production\" }));\n * export const handleError = handleErrorWithGuidely(({ error, event, status, message }) => ({ message: \"Something went wrong\" }));\n * ```\n */\nexport function handleErrorWithGuidely<R = void>(handleError?: (input: ServerHandleErrorInput) => R | Promise<R>, options: ServerErrorOptions = {}): (input: ServerHandleErrorInput) => Promise<R | undefined> {\n  return async (input) => {\n    try {\n      if (input?.status !== 404 || options.captureNotFound) {\n        const routeId = input?.event?.route?.id ?? null;\n        const { flushed } = captureServerError(input?.error, { event: input?.event, tags: routeId ? { routeId } : undefined, contexts: { sveltekit: { routeId, status: input?.status, message: input?.message } }, mechanism: \"sveltekit.handleError\" }, options);\n        if (options.waitForFlush && flushed) await flushed;\n      }\n    } catch {\n      // never break the error page\n    }\n    if (handleError) return handleError(input);\n    console.error(input?.error);\n    return undefined;\n  };\n}\n\n/**\n * A server `handle` for `sequence(guidelyHandle(), …)`: runs each request in its own scope of the\n * server client when it has scopes (`@guidelytech/node` does: breadcrumbs, `setTag` and `setUser`\n * calls made while handling the request stay with its errors), named `GET /blog/[slug]`.\n */\nexport function guidelyHandle(options: Pick<ServerErrorOptions, \"client\"> = {}): <E extends RequestEventLike, T>(input: { event: E; resolve: (event: E) => T }) => T {\n  return ({ event, resolve }) => {\n    let client: GuidelyServerErrorClient | null = null;\n    try {\n      client = options.client ?? registry().client;\n    } catch {\n      client = null;\n    }\n    if (!client || typeof client.withScope !== \"function\") return resolve(event);\n    let entered = false;\n    try {\n      return client.withScope((scope) => {\n        entered = true;\n        try {\n          scope.setTransactionName?.(transactionOf(event));\n        } catch {\n          // a scope without names\n        }\n        return resolve(event);\n      });\n    } catch (error) {\n      // A failure inside the scope machinery must not swallow the request: resolve it plainly.\n      if (!entered) return resolve(event);\n      throw error;\n    }\n  };\n}\n"],"mappings":"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","names":["registry"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guidelytech/sveltekit",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "SvelteKit helpers for Guidely",
   "license": "MIT",
   "type": "module",
@@ -25,15 +25,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@guidelytech/flags": "0.15.0",
-    "@guidelytech/svelte": "0.15.0",
-    "@guidelytech/sdk-core": "0.15.0"
+    "@guidelytech/sdk-core": "0.17.0",
+    "@guidelytech/flags": "0.17.0",
+    "@guidelytech/svelte": "0.17.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.7",
-    "happy-dom": "^17.6.3",
+    "vitest": "^4.1.12",
+    "happy-dom": "^21.0.4",
     "eslint": "^9.39.5",
     "@eslint/js": "^9.39.5",
     "typescript-eslint": "^8.46.0",