@guidelytech/sveltekit 0.6.2 → 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guidely
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -50,4 +50,69 @@ next time they load the app.
 | `initGuidely(options)` | Call once during root layout initialisation. Returns the client in the browser, `null` on the server. Uses `afterNavigate` from `$app/navigation` to call `page()` and destroys the client when the layout is destroyed. |
 | `guidelyEnv(env)` | Reads `PUBLIC_GUIDELY_PROJECT_ID`/`_ENV`/`_API_URL`/`_RELEASE` (`$env/static/public`, `$env/dynamic/public`) or the `VITE_GUIDELY_*` equivalents (`import.meta.env`). |
 | `syncGuidelyUser(user \| null \| undefined)` | Keeps the Guidely user in step with your session (re-exported from `@guidelytech/svelte`). |
-| everything from `@guidelytech/svelte` | stores, actions and context helpers. |
+| everything from `@guidelytech/svelte` | stores (including the flag stores `flag`, `featureValue`, `flagDetails`, `allFlags`, `flagsReady`), actions and context helpers. |
+| `createServerFlags`, `getFlags`, `loadFlags` | Server helpers, also at `@guidelytech/sveltekit/server` (see below). |
+
+## Feature flags
+
+Flags are on with the same public key. Evaluate them on the server and hand the payload to the
+browser so the first render matches — no flicker:
+
+```ts
+// src/hooks.server.ts
+import { createServerFlags } from "@guidelytech/sveltekit/server";
+
+export const handle = async ({ event, resolve }) => {
+  // One client per process (polls Guidely, evaluates locally). Env: GUIDELY_SDK_KEY or PUBLIC_GUIDELY_PROJECT_ID.
+  event.locals.flags = createServerFlags().forUser({ id: event.locals.user?.id, plan: event.locals.user?.plan });
+  return resolve(event);
+};
+```
+
+```ts
+// src/routes/+layout.server.ts
+import { loadFlags } from "@guidelytech/sveltekit/server";
+export const load = async (event) => ({ user: event.locals.user ?? null, flags: await loadFlags(event) });
+```
+
+```svelte
+<!-- src/routes/+layout.svelte -->
+<script lang="ts">
+  import { untrack } from "svelte";
+  let { data, children } = $props();
+  initGuidely({ ...guidelyEnv(env), flags: untrack(() => data.flags) }); // { payload, attributes }
+</script>
+```
+
+```svelte
+<!-- any component -->
+<script lang="ts">
+  import { flag, featureValue } from "@guidelytech/sveltekit";
+  const newBanner = flag("new-dashboard-banner");
+  const color = featureValue("checkout-button-color", "blue");
+</script>
+{#if $newBanner}<NewBanner />{/if}
+```
+
+In `+page.server.ts` and endpoints read `locals.flags.isEnabled("…")` / `getValue(…)` directly.
+Add the type to `src/app.d.ts`:
+
+```ts
+declare global {
+  namespace App {
+    interface Locals {
+      flags: import("@guidelytech/sveltekit/server").FlagsEvaluator;
+    }
+  }
+}
+export {};
+```
+
+| `@guidelytech/sveltekit/server` | Description |
+|---|---|
+| `createServerFlags(options?)` | The process-wide flags client (kept on `globalThis` across dev reloads). Options default to `GUIDELY_SDK_KEY` (`pk_…` or server-only `gly_sk_…`) or `PUBLIC_GUIDELY_PROJECT_ID`, `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL`, `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. On serverless adapters pass `{ pollingMode: "lazy" }`. |
+| `getFlags(attributes, { client?, timeoutMs? })` | Getters for one user; waits up to `timeoutMs` (1500) for the first download. |
+| `loadFlags(event \| attributes, { client?, timeoutMs? })` | `{ payload, attributes }` for `initGuidely({ flags })`; attributes come from `event.locals.flags`. The payload is `null` for a `gly_sk_` client (it contains server-only flags). |
+
+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.

package/dist/index.cjs

@@ -21,8 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  createServerFlags: () => createServerFlags,
+  getFlags: () => getFlags,
   guidelyEnv: () => guidelyEnv,
-  initGuidely: () => initGuidely
+  initGuidely: () => initGuidely,
+  loadFlags: () => loadFlags
 });
 module.exports = __toCommonJS(index_exports);
 var import_environment = require("$app/environment");
@@ -30,13 +33,71 @@ var import_navigation = require("$app/navigation");
 var import_svelte = require("@guidelytech/svelte");
 var import_svelte2 = require("svelte");
 __reExport(index_exports, require("@guidelytech/svelte"), module.exports);
+
+// src/server.ts
+var import_flags = require("@guidelytech/flags");
+function registry() {
+  const g = globalThis;
+  return g.__guidelySvelteKitFlags ?? (g.__guidelySvelteKitFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
+}
+function env(name) {
+  try {
+    return globalThis.process?.env?.[name] || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createServerFlags(options = {}) {
+  const sdkKey = options.sdkKey ?? options.projectId ?? env("GUIDELY_SDK_KEY") ?? env("PUBLIC_GUIDELY_PROJECT_ID");
+  if (!sdkKey) throw new Error("[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.");
+  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();
+  let client = reg.clients.get(id);
+  if (!client) {
+    client = (0, import_flags.createFlagsClient)({ storage: false, ...options, sdkKey, apiUrl, environment });
+    reg.clients.set(id, client);
+  }
+  reg.current = client;
+  return client;
+}
+function settle(client, timeoutMs) {
+  if (client.isReady()) return Promise.resolve();
+  return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
+}
+async function getFlags(attributes = {}, options = {}) {
+  const client = options.client ?? registry().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();
+  if (client.sdkKey.startsWith("gly_sk_")) {
+    const reg = registry();
+    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 }) }.");
+    }
+    return { payload: null, attributes };
+  }
+  await settle(client, options.timeoutMs ?? 1500);
+  return { payload: client.getPayload(), attributes };
+}
+
+// src/index.ts
 function initGuidely(options) {
   if (!import_environment.browser) {
     (0, import_svelte.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);
     return null;
   }
   const client = (0, import_svelte.createGuidely)(options);
   (0, import_svelte.setGuidelyContext)(client);
+  (0, import_svelte.setFlagsContext)(client);
   (0, import_navigation.afterNavigate)((nav) => {
     if (nav.type !== "enter") client.page(window.location.href);
   });
@@ -50,18 +111,21 @@ function guidelyStoreIs(client) {
   import_svelte.guidely.subscribe((c) => current = c)();
   return current === client;
 }
-function guidelyEnv(env) {
+function guidelyEnv(env2) {
   return {
-    projectId: env.VITE_GUIDELY_PROJECT_ID || env.PUBLIC_GUIDELY_PROJECT_ID || "",
-    environment: env.VITE_GUIDELY_ENV || env.PUBLIC_GUIDELY_ENV || void 0,
-    apiUrl: env.VITE_GUIDELY_API_URL || env.PUBLIC_GUIDELY_API_URL || void 0,
-    release: env.VITE_GUIDELY_RELEASE || env.PUBLIC_GUIDELY_RELEASE || void 0
+    projectId: env2.VITE_GUIDELY_PROJECT_ID || env2.PUBLIC_GUIDELY_PROJECT_ID || "",
+    environment: env2.VITE_GUIDELY_ENV || env2.PUBLIC_GUIDELY_ENV || void 0,
+    apiUrl: env2.VITE_GUIDELY_API_URL || env2.PUBLIC_GUIDELY_API_URL || void 0,
+    release: env2.VITE_GUIDELY_RELEASE || env2.PUBLIC_GUIDELY_RELEASE || void 0
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createServerFlags,
+  getFlags,
   guidelyEnv,
   initGuidely,
+  loadFlags,
   ...require("@guidelytech/svelte")
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { browser } from \"$app/environment\";\nimport { afterNavigate } from \"$app/navigation\";\nimport { createGuidely, destroyGuidely, guidely, 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 */\nexport function initGuidely(options: GuidelyOptions): GuidelyClient | null {\n  if (!browser) {\n    setGuidelyContext(null);\n    return null;\n  }\n  const client = createGuidely(options);\n  setGuidelyContext(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"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAwB;AACxB,wBAA8B;AAC9B,oBAAmH;AACnH,IAAAA,iBAA0B;AAE1B,0BAAc,gCALd;AAaO,SAAS,YAAY,SAA+C;AACzE,MAAI,CAAC,4BAAS;AACZ,yCAAkB,IAAI;AACtB,WAAO;AAAA,EACT;AACA,QAAM,aAAS,6BAAc,OAAO;AACpC,uCAAkB,MAAM;AACxB,uCAAc,CAAC,QAAQ;AACrB,QAAI,IAAI,SAAS,QAAS,QAAO,KAAK,OAAO,SAAS,IAAI;AAAA,EAC5D,CAAC;AACD,gCAAU,MAAM;AACd,QAAI,eAAe,MAAM,EAAG,mCAAe;AAAA,EAC7C,CAAC;AACD,SAAO;AACT;AAEA,SAAS,eAAe,QAAgC;AACtD,MAAI,UAAgC;AACpC,wBAAQ,UAAU,CAAC,MAAO,UAAU,CAAE,EAAE;AACxC,SAAO,YAAY;AACrB;AAMO,SAAS,WAAW,KAAmH;AAC5I,SAAO;AAAA,IACL,WAAW,IAAI,2BAA2B,IAAI,6BAA6B;AAAA,IAC3E,aAAe,IAAI,oBAAoB,IAAI,sBAAyD;AAAA,IACpG,QAAQ,IAAI,wBAAwB,IAAI,0BAA0B;AAAA,IAClE,SAAS,IAAI,wBAAwB,IAAI,0BAA0B;AAAA,EACrE;AACF;","names":["import_svelte"]}
+{"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"]}

package/dist/index.d.cts

@@ -1,11 +1,60 @@
 import { GuidelyOptions, GuidelyClient } from '@guidelytech/svelte';
 export * from '@guidelytech/svelte';
+import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
+
+/**
+ * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
+ * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * const flags = createServerFlags();
+ * export const handle = async ({ event, resolve }) => {
+ *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });
+ *   return resolve(event);
+ * };
+ * ```
+ */
+
+/**
+ * The process-wide flags client (created once, reused across requests). Options default to
+ * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,
+ * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls
+ * every 60 s; on serverless / edge adapters use `{ pollingMode: "lazy" }`.
+ */
+declare function createServerFlags(options?: Partial<FlagsClientOptions>): FlagsClient;
+interface LoadFlagsOptions {
+    /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */
+    client?: FlagsClient;
+    /** How long to wait for the first download before serving fallbacks (default 1500 ms). */
+    timeoutMs?: number;
+}
+/** Flag getters for one user, for this request (waits briefly for the first download). */
+declare function getFlags(attributes?: Attributes, options?: LoadFlagsOptions): Promise<FlagsEvaluator>;
+/**
+ * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render
+ * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in
+ * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.
+ * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a
+ * public-key client instead.
+ */
+declare function loadFlags(input?: {
+    locals?: {
+        flags?: Pick<FlagsEvaluator, "getAttributes"> | null;
+    };
+} | Attributes, options?: LoadFlagsOptions): Promise<{
+    payload: FlagsBootstrap | null;
+    attributes: Attributes;
+}>;
 
 /**
  * Call once from the root `+layout.svelte` (during component initialisation). Creates the client
  * in the browser only, calls `page()` after every SvelteKit navigation and destroys the client
  * when the layout unmounts (HMR). Returns `null` on the server. Keep the signed-in user in step
  * with `syncGuidelyUser` (re-exported from `@guidelytech/svelte`).
+ *
+ * Pass `flags: data.flags` (from `loadFlags()` in `+layout.server.ts`) and the flag stores
+ * render the same values on the server and in the browser.
  */
 declare function initGuidely(options: GuidelyOptions): GuidelyClient | null;
 /**
@@ -14,4 +63,4 @@ declare function initGuidely(options: GuidelyOptions): GuidelyClient | null;
  */
 declare function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, "projectId" | "environment" | "apiUrl" | "release">;
 
-export { guidelyEnv, initGuidely };
+export { type LoadFlagsOptions, createServerFlags, getFlags, guidelyEnv, initGuidely, loadFlags };

package/dist/index.d.ts

@@ -1,11 +1,60 @@
 import { GuidelyOptions, GuidelyClient } from '@guidelytech/svelte';
 export * from '@guidelytech/svelte';
+import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
+
+/**
+ * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
+ * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * const flags = createServerFlags();
+ * export const handle = async ({ event, resolve }) => {
+ *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });
+ *   return resolve(event);
+ * };
+ * ```
+ */
+
+/**
+ * The process-wide flags client (created once, reused across requests). Options default to
+ * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,
+ * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls
+ * every 60 s; on serverless / edge adapters use `{ pollingMode: "lazy" }`.
+ */
+declare function createServerFlags(options?: Partial<FlagsClientOptions>): FlagsClient;
+interface LoadFlagsOptions {
+    /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */
+    client?: FlagsClient;
+    /** How long to wait for the first download before serving fallbacks (default 1500 ms). */
+    timeoutMs?: number;
+}
+/** Flag getters for one user, for this request (waits briefly for the first download). */
+declare function getFlags(attributes?: Attributes, options?: LoadFlagsOptions): Promise<FlagsEvaluator>;
+/**
+ * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render
+ * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in
+ * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.
+ * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a
+ * public-key client instead.
+ */
+declare function loadFlags(input?: {
+    locals?: {
+        flags?: Pick<FlagsEvaluator, "getAttributes"> | null;
+    };
+} | Attributes, options?: LoadFlagsOptions): Promise<{
+    payload: FlagsBootstrap | null;
+    attributes: Attributes;
+}>;
 
 /**
  * Call once from the root `+layout.svelte` (during component initialisation). Creates the client
  * in the browser only, calls `page()` after every SvelteKit navigation and destroys the client
  * when the layout unmounts (HMR). Returns `null` on the server. Keep the signed-in user in step
  * with `syncGuidelyUser` (re-exported from `@guidelytech/svelte`).
+ *
+ * Pass `flags: data.flags` (from `loadFlags()` in `+layout.server.ts`) and the flag stores
+ * render the same values on the server and in the browser.
  */
 declare function initGuidely(options: GuidelyOptions): GuidelyClient | null;
 /**
@@ -14,4 +63,4 @@ declare function initGuidely(options: GuidelyOptions): GuidelyClient | null;
  */
 declare function guidelyEnv(env: Record<string, string | undefined>): Pick<GuidelyOptions, "projectId" | "environment" | "apiUrl" | "release">;
 
-export { guidelyEnv, initGuidely };
+export { type LoadFlagsOptions, createServerFlags, getFlags, guidelyEnv, initGuidely, loadFlags };

package/dist/index.js

@@ -1,16 +1,74 @@
 // src/index.ts
 import { browser } from "$app/environment";
 import { afterNavigate } from "$app/navigation";
-import { createGuidely, destroyGuidely, guidely, setGuidelyContext } from "@guidelytech/svelte";
+import { createGuidely, createStaticFlags, destroyGuidely, guidely, setFlagsContext, setGuidelyContext } from "@guidelytech/svelte";
 import { onDestroy } from "svelte";
 export * from "@guidelytech/svelte";
+
+// src/server.ts
+import { createFlagsClient } from "@guidelytech/flags";
+function registry() {
+  const g = globalThis;
+  return g.__guidelySvelteKitFlags ?? (g.__guidelySvelteKitFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
+}
+function env(name) {
+  try {
+    return globalThis.process?.env?.[name] || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createServerFlags(options = {}) {
+  const sdkKey = options.sdkKey ?? options.projectId ?? env("GUIDELY_SDK_KEY") ?? env("PUBLIC_GUIDELY_PROJECT_ID");
+  if (!sdkKey) throw new Error("[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.");
+  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();
+  let client = reg.clients.get(id);
+  if (!client) {
+    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });
+    reg.clients.set(id, client);
+  }
+  reg.current = client;
+  return client;
+}
+function settle(client, timeoutMs) {
+  if (client.isReady()) return Promise.resolve();
+  return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
+}
+async function getFlags(attributes = {}, options = {}) {
+  const client = options.client ?? registry().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();
+  if (client.sdkKey.startsWith("gly_sk_")) {
+    const reg = registry();
+    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 }) }.");
+    }
+    return { payload: null, attributes };
+  }
+  await settle(client, options.timeoutMs ?? 1500);
+  return { payload: client.getPayload(), attributes };
+}
+
+// src/index.ts
 function initGuidely(options) {
   if (!browser) {
     setGuidelyContext(null);
+    const flags = options.flags || void 0;
+    setFlagsContext(flags?.payload ? createStaticFlags({ payload: flags.payload, attributes: flags.attributes }) : null);
     return null;
   }
   const client = createGuidely(options);
   setGuidelyContext(client);
+  setFlagsContext(client);
   afterNavigate((nav) => {
     if (nav.type !== "enter") client.page(window.location.href);
   });
@@ -24,16 +82,19 @@ function guidelyStoreIs(client) {
   guidely.subscribe((c) => current = c)();
   return current === client;
 }
-function guidelyEnv(env) {
+function guidelyEnv(env2) {
   return {
-    projectId: env.VITE_GUIDELY_PROJECT_ID || env.PUBLIC_GUIDELY_PROJECT_ID || "",
-    environment: env.VITE_GUIDELY_ENV || env.PUBLIC_GUIDELY_ENV || void 0,
-    apiUrl: env.VITE_GUIDELY_API_URL || env.PUBLIC_GUIDELY_API_URL || void 0,
-    release: env.VITE_GUIDELY_RELEASE || env.PUBLIC_GUIDELY_RELEASE || void 0
+    projectId: env2.VITE_GUIDELY_PROJECT_ID || env2.PUBLIC_GUIDELY_PROJECT_ID || "",
+    environment: env2.VITE_GUIDELY_ENV || env2.PUBLIC_GUIDELY_ENV || void 0,
+    apiUrl: env2.VITE_GUIDELY_API_URL || env2.PUBLIC_GUIDELY_API_URL || void 0,
+    release: env2.VITE_GUIDELY_RELEASE || env2.PUBLIC_GUIDELY_RELEASE || void 0
   };
 }
 export {
+  createServerFlags,
+  getFlags,
   guidelyEnv,
-  initGuidely
+  initGuidely,
+  loadFlags
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { browser } from \"$app/environment\";\nimport { afterNavigate } from \"$app/navigation\";\nimport { createGuidely, destroyGuidely, guidely, 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 */\nexport function initGuidely(options: GuidelyOptions): GuidelyClient | null {\n  if (!browser) {\n    setGuidelyContext(null);\n    return null;\n  }\n  const client = createGuidely(options);\n  setGuidelyContext(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"],"mappings":";AAAA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B,SAAS,eAAe,gBAAgB,SAAS,yBAAkE;AACnH,SAAS,iBAAiB;AAE1B,cAAc;AAQP,SAAS,YAAY,SAA+C;AACzE,MAAI,CAAC,SAAS;AACZ,sBAAkB,IAAI;AACtB,WAAO;AAAA,EACT;AACA,QAAM,SAAS,cAAc,OAAO;AACpC,oBAAkB,MAAM;AACxB,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,UAAQ,UAAU,CAAC,MAAO,UAAU,CAAE,EAAE;AACxC,SAAO,YAAY;AACrB;AAMO,SAAS,WAAW,KAAmH;AAC5I,SAAO;AAAA,IACL,WAAW,IAAI,2BAA2B,IAAI,6BAA6B;AAAA,IAC3E,aAAe,IAAI,oBAAoB,IAAI,sBAAyD;AAAA,IACpG,QAAQ,IAAI,wBAAwB,IAAI,0BAA0B;AAAA,IAClE,SAAS,IAAI,wBAAwB,IAAI,0BAA0B;AAAA,EACrE;AACF;","names":[]}
+{"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"]}

package/dist/server.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  createServerFlags: () => createServerFlags,
+  getFlags: () => getFlags,
+  loadFlags: () => loadFlags
+});
+module.exports = __toCommonJS(server_exports);
+var import_flags = require("@guidelytech/flags");
+function registry() {
+  const g = globalThis;
+  return g.__guidelySvelteKitFlags ?? (g.__guidelySvelteKitFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
+}
+function env(name) {
+  try {
+    return globalThis.process?.env?.[name] || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createServerFlags(options = {}) {
+  const sdkKey = options.sdkKey ?? options.projectId ?? env("GUIDELY_SDK_KEY") ?? env("PUBLIC_GUIDELY_PROJECT_ID");
+  if (!sdkKey) throw new Error("[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.");
+  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();
+  let client = reg.clients.get(id);
+  if (!client) {
+    client = (0, import_flags.createFlagsClient)({ storage: false, ...options, sdkKey, apiUrl, environment });
+    reg.clients.set(id, client);
+  }
+  reg.current = client;
+  return client;
+}
+function settle(client, timeoutMs) {
+  if (client.isReady()) return Promise.resolve();
+  return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
+}
+async function getFlags(attributes = {}, options = {}) {
+  const client = options.client ?? registry().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();
+  if (client.sdkKey.startsWith("gly_sk_")) {
+    const reg = registry();
+    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 }) }.");
+    }
+    return { payload: null, attributes };
+  }
+  await settle(client, options.timeoutMs ?? 1500);
+  return { payload: client.getPayload(), attributes };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createServerFlags,
+  getFlags,
+  loadFlags
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +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":[]}

package/dist/server.d.cts

@@ -0,0 +1,49 @@
+import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
+export { Attributes, FlagDetails, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, JsonValue } from '@guidelytech/flags';
+
+/**
+ * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
+ * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * const flags = createServerFlags();
+ * export const handle = async ({ event, resolve }) => {
+ *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });
+ *   return resolve(event);
+ * };
+ * ```
+ */
+
+/**
+ * The process-wide flags client (created once, reused across requests). Options default to
+ * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,
+ * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls
+ * every 60 s; on serverless / edge adapters use `{ pollingMode: "lazy" }`.
+ */
+declare function createServerFlags(options?: Partial<FlagsClientOptions>): FlagsClient;
+interface LoadFlagsOptions {
+    /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */
+    client?: FlagsClient;
+    /** How long to wait for the first download before serving fallbacks (default 1500 ms). */
+    timeoutMs?: number;
+}
+/** Flag getters for one user, for this request (waits briefly for the first download). */
+declare function getFlags(attributes?: Attributes, options?: LoadFlagsOptions): Promise<FlagsEvaluator>;
+/**
+ * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render
+ * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in
+ * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.
+ * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a
+ * public-key client instead.
+ */
+declare function loadFlags(input?: {
+    locals?: {
+        flags?: Pick<FlagsEvaluator, "getAttributes"> | null;
+    };
+} | Attributes, options?: LoadFlagsOptions): Promise<{
+    payload: FlagsBootstrap | null;
+    attributes: Attributes;
+}>;
+
+export { type LoadFlagsOptions, createServerFlags, getFlags, loadFlags };

package/dist/server.d.ts

@@ -0,0 +1,49 @@
+import { FlagsClient, FlagsClientOptions, Attributes, FlagsEvaluator, FlagsBootstrap } from '@guidelytech/flags';
+export { Attributes, FlagDetails, FlagsBootstrap, FlagsClient, FlagsClientOptions, FlagsEvaluator, JsonValue } from '@guidelytech/flags';
+
+/**
+ * `@guidelytech/sveltekit/server` — feature flags in `hooks.server.ts`, `+layout.server.ts`,
+ * `+page.server.ts` and endpoints. No `$app` imports, no Svelte.
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * const flags = createServerFlags();
+ * export const handle = async ({ event, resolve }) => {
+ *   event.locals.flags = flags.forUser({ id: event.locals.user?.id });
+ *   return resolve(event);
+ * };
+ * ```
+ */
+
+/**
+ * The process-wide flags client (created once, reused across requests). Options default to
+ * `GUIDELY_SDK_KEY` (public `pk_…` or secret `gly_sk_…`), falling back to `PUBLIC_GUIDELY_PROJECT_ID`,
+ * plus `GUIDELY_API_URL` / `PUBLIC_GUIDELY_API_URL` and `GUIDELY_ENV` / `PUBLIC_GUIDELY_ENV`. Polls
+ * every 60 s; on serverless / edge adapters use `{ pollingMode: "lazy" }`.
+ */
+declare function createServerFlags(options?: Partial<FlagsClientOptions>): FlagsClient;
+interface LoadFlagsOptions {
+    /** A client from `createServerFlags(...)` (default: the last one created, or one from environment variables). */
+    client?: FlagsClient;
+    /** How long to wait for the first download before serving fallbacks (default 1500 ms). */
+    timeoutMs?: number;
+}
+/** Flag getters for one user, for this request (waits briefly for the first download). */
+declare function getFlags(attributes?: Attributes, options?: LoadFlagsOptions): Promise<FlagsEvaluator>;
+/**
+ * For `+layout.server.ts`: the payload and attributes to hand to the browser, so the first render
+ * matches the server. Pass the request `event` (attributes come from `event.locals.flags`, set in
+ * `hooks.server.ts`) or the attributes. Spread the result into `initGuidely({ …, flags: data.flags })`.
+ * The payload is `null` for a `gly_sk_` client (it holds server-only flags): bootstrap from a
+ * public-key client instead.
+ */
+declare function loadFlags(input?: {
+    locals?: {
+        flags?: Pick<FlagsEvaluator, "getAttributes"> | null;
+    };
+} | Attributes, options?: LoadFlagsOptions): Promise<{
+    payload: FlagsBootstrap | null;
+    attributes: Attributes;
+}>;
+
+export { type LoadFlagsOptions, createServerFlags, getFlags, loadFlags };

package/dist/server.js

@@ -0,0 +1,58 @@
+// src/server.ts
+import { createFlagsClient } from "@guidelytech/flags";
+function registry() {
+  const g = globalThis;
+  return g.__guidelySvelteKitFlags ?? (g.__guidelySvelteKitFlags = { clients: /* @__PURE__ */ new Map(), current: null, warned: /* @__PURE__ */ new Set() });
+}
+function env(name) {
+  try {
+    return globalThis.process?.env?.[name] || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function createServerFlags(options = {}) {
+  const sdkKey = options.sdkKey ?? options.projectId ?? env("GUIDELY_SDK_KEY") ?? env("PUBLIC_GUIDELY_PROJECT_ID");
+  if (!sdkKey) throw new Error("[Guidely] createServerFlags: pass `sdkKey` or set GUIDELY_SDK_KEY / PUBLIC_GUIDELY_PROJECT_ID.");
+  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();
+  let client = reg.clients.get(id);
+  if (!client) {
+    client = createFlagsClient({ storage: false, ...options, sdkKey, apiUrl, environment });
+    reg.clients.set(id, client);
+  }
+  reg.current = client;
+  return client;
+}
+function settle(client, timeoutMs) {
+  if (client.isReady()) return Promise.resolve();
+  return Promise.race([client.ready(), new Promise((r) => setTimeout(r, timeoutMs))]);
+}
+async function getFlags(attributes = {}, options = {}) {
+  const client = options.client ?? registry().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();
+  if (client.sdkKey.startsWith("gly_sk_")) {
+    const reg = registry();
+    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 }) }.");
+    }
+    return { payload: null, attributes };
+  }
+  await settle(client, options.timeoutMs ?? 1500);
+  return { payload: client.getPayload(), attributes };
+}
+export {
+  createServerFlags,
+  getFlags,
+  loadFlags
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guidelytech/sveltekit",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "SvelteKit helpers for Guidely",
   "license": "MIT",
   "type": "module",
@@ -13,6 +13,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
     }
   },
   "files": [
@@ -20,8 +25,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@guidelytech/svelte": "0.6.2",
-    "@guidelytech/sdk-core": "0.6.2"
+    "@guidelytech/flags": "0.8.0",
+    "@guidelytech/svelte": "0.8.0",
+    "@guidelytech/sdk-core": "0.8.0"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
@@ -59,7 +65,7 @@
     "sveltekit"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "rm -rf dist && tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",