@savvagent/sveltekit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Savvagent, LLC
+
+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

@@ -0,0 +1,80 @@
+# @savvagent/sveltekit
+
+SvelteKit SDK for Savvagent with server-side load functions and client-side stores.
+
+## Installation
+
+```bash
+npm install @savvagent/sveltekit
+```
+
+## Quick Start
+
+### Server-Side (Load Functions)
+
+```ts
+// src/hooks.server.ts
+import { initSvelteKitServer } from '@savvagent/sveltekit/server';
+
+initSvelteKitServer({
+  apiKey: process.env.SAVVAGENT_API_KEY!,
+});
+```
+
+```ts
+// +page.server.ts
+import { isEnabled } from '@savvagent/sveltekit/server';
+
+export async function load({ cookies }) {
+  const enabled = await isEnabled('new-feature', {
+    user_id: cookies.get('user_id'),
+  });
+
+  return { enabled };
+}
+```
+
+### Client-Side (Stores)
+
+```svelte
+<!-- +layout.svelte -->
+<script>
+import { initSavvagent } from '@savvagent/sveltekit';
+
+initSavvagent({
+  apiKey: import.meta.env.VITE_SAVVAGENT_API_KEY,
+});
+</script>
+```
+
+```svelte
+<!-- +page.svelte -->
+<script>
+import { createFlag } from '@savvagent/sveltekit';
+
+const isEnabled = createFlag('client-feature');
+</script>
+
+{#if $isEnabled}
+  <NewFeature />
+{/if}
+```
+
+## API Reference
+
+### Server-Side (`@savvagent/sveltekit/server`)
+
+- `initSvelteKitServer(config)` - Initialize server client
+- `isEnabled(flagKey, context?)` - Check if flag is enabled
+- `evaluate(flagKey, context?)` - Get detailed result
+- `evaluateForEvent(event, flagKey, context?)` - Evaluate with event context
+- `getEventContext(event, overrides?)` - Extract context from event
+- `trackError(flagKey, error, context?)` - Track errors
+
+### Client-Side
+
+All stores and functions from `@savvagent/svelte` are available.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+export { FlagStoreOptions, FlagStoreValue, createFlag, createFlagStore, createUserIdStore, getSavvagent, initSavvagent, trackError as trackErrorClient } from '@savvagent/svelte';
+export { ApiTypes, ErrorEvent, EvaluationEvent, FlagClient, FlagClientConfig, FlagContext, FlagEvaluationResult, FlagUpdateEvent, components } from '@savvagent/sdk';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { FlagStoreOptions, FlagStoreValue, createFlag, createFlagStore, createUserIdStore, getSavvagent, initSavvagent, trackError as trackErrorClient } from '@savvagent/svelte';
+export { ApiTypes, ErrorEvent, EvaluationEvent, FlagClient, FlagClientConfig, FlagContext, FlagEvaluationResult, FlagUpdateEvent, components } from '@savvagent/sdk';

package/dist/index.js

@@ -0,0 +1,43 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FlagClient: () => import_sdk.FlagClient,
+  createFlag: () => import_svelte.createFlag,
+  createFlagStore: () => import_svelte.createFlagStore,
+  createUserIdStore: () => import_svelte.createUserIdStore,
+  getSavvagent: () => import_svelte.getSavvagent,
+  initSavvagent: () => import_svelte.initSavvagent,
+  trackErrorClient: () => import_svelte.trackError
+});
+module.exports = __toCommonJS(index_exports);
+var import_svelte = require("@savvagent/svelte");
+var import_sdk = require("@savvagent/sdk");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FlagClient,
+  createFlag,
+  createFlagStore,
+  createUserIdStore,
+  getSavvagent,
+  initSavvagent,
+  trackErrorClient
+});

package/dist/index.mjs

@@ -0,0 +1,19 @@
+// src/index.ts
+import {
+  initSavvagent,
+  getSavvagent,
+  createFlagStore,
+  createFlag,
+  createUserIdStore,
+  trackError
+} from "@savvagent/svelte";
+import { FlagClient } from "@savvagent/sdk";
+export {
+  FlagClient,
+  createFlag,
+  createFlagStore,
+  createUserIdStore,
+  getSavvagent,
+  initSavvagent,
+  trackError as trackErrorClient
+};

package/dist/server.d.mts

@@ -0,0 +1,116 @@
+import * as _savvagent_sdk from '@savvagent/sdk';
+import { FlagClientConfig, FlagClient, FlagContext } from '@savvagent/sdk';
+import { RequestEvent } from '@sveltejs/kit';
+
+/**
+ * Initialize the server-side Savvagent client.
+ * Call this once in hooks.server.ts or root +layout.server.ts.
+ *
+ * @param config - Client configuration
+ * @returns The FlagClient instance
+ *
+ * @example
+ * ```ts
+ * // src/hooks.server.ts
+ * import { initSvelteKitServer } from '@savvagent/sveltekit/server';
+ *
+ * initSvelteKitServer({
+ *   apiKey: process.env.SAVVAGENT_API_KEY!,
+ *   applicationId: process.env.SAVVAGENT_APP_ID,
+ * });
+ * ```
+ */
+declare function initSvelteKitServer(config: FlagClientConfig): FlagClient;
+/**
+ * Get the server-side Savvagent client instance.
+ *
+ * @returns The FlagClient instance
+ * @throws Error if client is not initialized
+ */
+declare function getServerClient(): FlagClient;
+/**
+ * Extract context from SvelteKit RequestEvent.
+ * Automatically extracts user_id from cookies and language from headers.
+ *
+ * @param event - SvelteKit RequestEvent
+ * @param overrides - Additional context properties
+ * @returns FlagContext
+ *
+ * @example
+ * ```ts
+ * export async function load({ cookies, request }) {
+ *   const context = getEventContext({ cookies, request });
+ *   const enabled = await isEnabled('my-feature', context);
+ *   return { enabled };
+ * }
+ * ```
+ */
+declare function getEventContext(event: Pick<RequestEvent, 'cookies' | 'request'>, overrides?: FlagContext): FlagContext;
+/**
+ * Check if a feature flag is enabled in a SvelteKit load function.
+ *
+ * @param flagKey - The flag key to evaluate
+ * @param context - Optional context for targeting
+ * @returns Promise<boolean>
+ *
+ * @example
+ * ```ts
+ * // +page.server.ts
+ * import { isEnabled } from '@savvagent/sveltekit/server';
+ *
+ * export async function load({ cookies, request }) {
+ *   const enabled = await isEnabled('new-feature', {
+ *     user_id: cookies.get('user_id'),
+ *   });
+ *
+ *   return { enabled };
+ * }
+ * ```
+ */
+declare function isEnabled(flagKey: string, context?: FlagContext): Promise<boolean>;
+/**
+ * Evaluate a feature flag with detailed result.
+ *
+ * @param flagKey - The flag key to evaluate
+ * @param context - Optional context for targeting
+ * @returns Promise<FlagEvaluationResult>
+ */
+declare function evaluate(flagKey: string, context?: FlagContext): Promise<_savvagent_sdk.FlagEvaluationResult>;
+/**
+ * Execute code conditionally based on flag value.
+ *
+ * @param flagKey - The flag key to check
+ * @param callback - Function to execute if flag is enabled
+ * @param context - Optional context for targeting
+ * @returns Promise with callback result or null
+ */
+declare function withFlag<T>(flagKey: string, callback: () => T | Promise<T>, context?: FlagContext): Promise<T | null>;
+/**
+ * Track an error with flag context.
+ *
+ * @param flagKey - The flag key associated with the error
+ * @param error - The error that occurred
+ * @param context - Optional context
+ */
+declare function trackError(flagKey: string, error: Error, context?: FlagContext): void;
+/**
+ * Helper to evaluate flags in load functions with automatic event context.
+ *
+ * @param event - SvelteKit RequestEvent
+ * @param flagKey - The flag key to evaluate
+ * @param context - Optional additional context
+ * @returns Promise<boolean>
+ *
+ * @example
+ * ```ts
+ * import { evaluateForEvent } from '@savvagent/sveltekit/server';
+ *
+ * export async function load(event) {
+ *   const showBeta = await evaluateForEvent(event, 'beta-ui');
+ *   return { showBeta };
+ * }
+ * ```
+ */
+declare function evaluateForEvent(event: Pick<RequestEvent, 'cookies' | 'request'>, flagKey: string, context?: FlagContext): Promise<boolean>;
+
+export { evaluate, evaluateForEvent, getEventContext, getServerClient, initSvelteKitServer, isEnabled, trackError, withFlag };

package/dist/server.d.ts

@@ -0,0 +1,116 @@
+import * as _savvagent_sdk from '@savvagent/sdk';
+import { FlagClientConfig, FlagClient, FlagContext } from '@savvagent/sdk';
+import { RequestEvent } from '@sveltejs/kit';
+
+/**
+ * Initialize the server-side Savvagent client.
+ * Call this once in hooks.server.ts or root +layout.server.ts.
+ *
+ * @param config - Client configuration
+ * @returns The FlagClient instance
+ *
+ * @example
+ * ```ts
+ * // src/hooks.server.ts
+ * import { initSvelteKitServer } from '@savvagent/sveltekit/server';
+ *
+ * initSvelteKitServer({
+ *   apiKey: process.env.SAVVAGENT_API_KEY!,
+ *   applicationId: process.env.SAVVAGENT_APP_ID,
+ * });
+ * ```
+ */
+declare function initSvelteKitServer(config: FlagClientConfig): FlagClient;
+/**
+ * Get the server-side Savvagent client instance.
+ *
+ * @returns The FlagClient instance
+ * @throws Error if client is not initialized
+ */
+declare function getServerClient(): FlagClient;
+/**
+ * Extract context from SvelteKit RequestEvent.
+ * Automatically extracts user_id from cookies and language from headers.
+ *
+ * @param event - SvelteKit RequestEvent
+ * @param overrides - Additional context properties
+ * @returns FlagContext
+ *
+ * @example
+ * ```ts
+ * export async function load({ cookies, request }) {
+ *   const context = getEventContext({ cookies, request });
+ *   const enabled = await isEnabled('my-feature', context);
+ *   return { enabled };
+ * }
+ * ```
+ */
+declare function getEventContext(event: Pick<RequestEvent, 'cookies' | 'request'>, overrides?: FlagContext): FlagContext;
+/**
+ * Check if a feature flag is enabled in a SvelteKit load function.
+ *
+ * @param flagKey - The flag key to evaluate
+ * @param context - Optional context for targeting
+ * @returns Promise<boolean>
+ *
+ * @example
+ * ```ts
+ * // +page.server.ts
+ * import { isEnabled } from '@savvagent/sveltekit/server';
+ *
+ * export async function load({ cookies, request }) {
+ *   const enabled = await isEnabled('new-feature', {
+ *     user_id: cookies.get('user_id'),
+ *   });
+ *
+ *   return { enabled };
+ * }
+ * ```
+ */
+declare function isEnabled(flagKey: string, context?: FlagContext): Promise<boolean>;
+/**
+ * Evaluate a feature flag with detailed result.
+ *
+ * @param flagKey - The flag key to evaluate
+ * @param context - Optional context for targeting
+ * @returns Promise<FlagEvaluationResult>
+ */
+declare function evaluate(flagKey: string, context?: FlagContext): Promise<_savvagent_sdk.FlagEvaluationResult>;
+/**
+ * Execute code conditionally based on flag value.
+ *
+ * @param flagKey - The flag key to check
+ * @param callback - Function to execute if flag is enabled
+ * @param context - Optional context for targeting
+ * @returns Promise with callback result or null
+ */
+declare function withFlag<T>(flagKey: string, callback: () => T | Promise<T>, context?: FlagContext): Promise<T | null>;
+/**
+ * Track an error with flag context.
+ *
+ * @param flagKey - The flag key associated with the error
+ * @param error - The error that occurred
+ * @param context - Optional context
+ */
+declare function trackError(flagKey: string, error: Error, context?: FlagContext): void;
+/**
+ * Helper to evaluate flags in load functions with automatic event context.
+ *
+ * @param event - SvelteKit RequestEvent
+ * @param flagKey - The flag key to evaluate
+ * @param context - Optional additional context
+ * @returns Promise<boolean>
+ *
+ * @example
+ * ```ts
+ * import { evaluateForEvent } from '@savvagent/sveltekit/server';
+ *
+ * export async function load(event) {
+ *   const showBeta = await evaluateForEvent(event, 'beta-ui');
+ *   return { showBeta };
+ * }
+ * ```
+ */
+declare function evaluateForEvent(event: Pick<RequestEvent, 'cookies' | 'request'>, flagKey: string, context?: FlagContext): Promise<boolean>;
+
+export { evaluate, evaluateForEvent, getEventContext, getServerClient, initSvelteKitServer, isEnabled, trackError, withFlag };

package/dist/server.js

@@ -0,0 +1,89 @@
+"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, {
+  evaluate: () => evaluate,
+  evaluateForEvent: () => evaluateForEvent,
+  getEventContext: () => getEventContext,
+  getServerClient: () => getServerClient,
+  initSvelteKitServer: () => initSvelteKitServer,
+  isEnabled: () => isEnabled,
+  trackError: () => trackError,
+  withFlag: () => withFlag
+});
+module.exports = __toCommonJS(server_exports);
+var import_sdk = require("@savvagent/sdk");
+var serverClient = null;
+function initSvelteKitServer(config) {
+  if (!serverClient) {
+    serverClient = new import_sdk.FlagClient(config);
+  }
+  return serverClient;
+}
+function getServerClient() {
+  if (!serverClient) {
+    throw new Error(
+      "SvelteKit server client not initialized. Call initSvelteKitServer() first."
+    );
+  }
+  return serverClient;
+}
+function getEventContext(event, overrides) {
+  const context = {
+    user_id: event.cookies.get("user_id"),
+    anonymous_id: event.cookies.get("savvagent_anonymous_id"),
+    session_id: event.cookies.get("session_id"),
+    language: event.request.headers.get("accept-language")?.split(",")[0] || void 0,
+    ...overrides
+  };
+  return context;
+}
+async function isEnabled(flagKey, context) {
+  const client = getServerClient();
+  return client.isEnabled(flagKey, context);
+}
+async function evaluate(flagKey, context) {
+  const client = getServerClient();
+  return client.evaluate(flagKey, context);
+}
+async function withFlag(flagKey, callback, context) {
+  const client = getServerClient();
+  return client.withFlag(flagKey, callback, context);
+}
+function trackError(flagKey, error, context) {
+  const client = getServerClient();
+  client.trackError(flagKey, error, context);
+}
+async function evaluateForEvent(event, flagKey, context) {
+  const eventContext = getEventContext(event, context);
+  return isEnabled(flagKey, eventContext);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  evaluate,
+  evaluateForEvent,
+  getEventContext,
+  getServerClient,
+  initSvelteKitServer,
+  isEnabled,
+  trackError,
+  withFlag
+});

package/dist/server.mjs

@@ -0,0 +1,57 @@
+// src/server.ts
+import { FlagClient } from "@savvagent/sdk";
+var serverClient = null;
+function initSvelteKitServer(config) {
+  if (!serverClient) {
+    serverClient = new FlagClient(config);
+  }
+  return serverClient;
+}
+function getServerClient() {
+  if (!serverClient) {
+    throw new Error(
+      "SvelteKit server client not initialized. Call initSvelteKitServer() first."
+    );
+  }
+  return serverClient;
+}
+function getEventContext(event, overrides) {
+  const context = {
+    user_id: event.cookies.get("user_id"),
+    anonymous_id: event.cookies.get("savvagent_anonymous_id"),
+    session_id: event.cookies.get("session_id"),
+    language: event.request.headers.get("accept-language")?.split(",")[0] || void 0,
+    ...overrides
+  };
+  return context;
+}
+async function isEnabled(flagKey, context) {
+  const client = getServerClient();
+  return client.isEnabled(flagKey, context);
+}
+async function evaluate(flagKey, context) {
+  const client = getServerClient();
+  return client.evaluate(flagKey, context);
+}
+async function withFlag(flagKey, callback, context) {
+  const client = getServerClient();
+  return client.withFlag(flagKey, callback, context);
+}
+function trackError(flagKey, error, context) {
+  const client = getServerClient();
+  client.trackError(flagKey, error, context);
+}
+async function evaluateForEvent(event, flagKey, context) {
+  const eventContext = getEventContext(event, context);
+  return isEnabled(flagKey, eventContext);
+}
+export {
+  evaluate,
+  evaluateForEvent,
+  getEventContext,
+  getServerClient,
+  initSvelteKitServer,
+  isEnabled,
+  trackError,
+  withFlag
+};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@savvagent/sveltekit",
+  "version": "1.0.0",
+  "description": "SvelteKit SDK for Savvagent feature flags with server and client support",
+  "author": "Savvagent",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@sveltejs/kit": ">=1.0.0 || >=2.0.0",
+    "svelte": ">=4.0.0"
+  },
+  "dependencies": {
+    "@savvagent/svelte": "1.0.0",
+    "@savvagent/sdk": "1.0.0"
+  },
+  "devDependencies": {
+    "@sveltejs/kit": "^2.5.0",
+    "svelte": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "keywords": [
+    "savvagent",
+    "feature-flags",
+    "sveltekit",
+    "svelte",
+    "server-side",
+    "feature-toggles"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/savvagent/savvagent-sdks",
+    "directory": "packages/sveltekit"
+  },
+  "bugs": {
+    "url": "https://github.com/savvagent/savvagent-sdks/issues"
+  },
+  "homepage": "https://github.com/savvagent/savvagent-sdks/tree/main/packages/sveltekit#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/server.ts --format cjs,esm --dts --external svelte --external @sveltejs/kit",
+    "dev": "tsup src/index.ts src/server.ts --format cjs,esm --dts --external svelte --external @sveltejs/kit --watch",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  }
+}