@replanejs/svelte 0.9.0 → 0.9.2

package/README.md

@@ -46,22 +46,31 @@ npm install @replanejs/svelte
 {/if}
 ```
 
-## Client Options
+## Provider Props
 
-The `options` prop accepts the following options:
+| Prop         | Type                        | Required | Description                                             |
+| ------------ | --------------------------- | -------- | ------------------------------------------------------- |
+| `connection` | `ConnectOptions \| null`    | Yes      | Connection options (see below), or `null` to skip connection |
+| `defaults`   | `Record<string, unknown>`   | No       | Default values if server is unavailable                 |
+| `context`    | `Record<string, unknown>`   | No       | Default context for override evaluations                |
+| `snapshot`   | `ReplaneSnapshot`           | No       | Snapshot for SSR hydration                              |
+| `logger`     | `ReplaneLogger`             | No       | Custom logger (default: console)                        |
+| `loader`     | `Snippet`                   | No       | Snippet to show while loading                           |
+| `async`      | `boolean`                   | No       | Connect asynchronously (renders immediately with defaults) |
+
+## Connection Options
+
+The `connection` prop accepts the following options:
 
 | Option                | Type                  | Required | Description                              |
 | --------------------- | --------------------- | -------- | ---------------------------------------- |
 | `baseUrl`             | `string`              | Yes      | Replane server URL                       |
 | `sdkKey`              | `string`              | Yes      | SDK key for authentication               |
-| `context`             | `Record<string, any>` | No       | Default context for override evaluations |
-| `defaults`            | `Record<string, any>` | No       | Default values if server is unavailable  |
 | `connectTimeoutMs`    | `number`              | No       | SDK connection timeout (default: 5000)   |
 | `requestTimeoutMs`    | `number`              | No       | Timeout for SSE requests (default: 2000) |
 | `retryDelayMs`        | `number`              | No       | Base delay between retries (default: 200)|
 | `inactivityTimeoutMs` | `number`              | No       | SSE inactivity timeout (default: 30000)  |
 | `fetchFn`             | `typeof fetch`        | No       | Custom fetch implementation              |
-| `logger`              | `ReplaneLogger`       | No       | Custom logger (default: console)         |
 
 See [`@replanejs/sdk` documentation](https://github.com/replane-dev/replane-javascript/tree/main/packages/sdk#api) for more details.
 
@@ -130,7 +139,7 @@ Create a reactive store from a client directly (without context). Type-safe with
 
 Context component that makes the Replane client available to your component tree.
 
-Can be used in three ways:
+Can be used in several ways:
 
 **1. With a pre-created client:**
 
@@ -150,20 +159,20 @@ Can be used in three ways:
 </ReplaneContext>
 ```
 
-**2. With options (client managed internally):**
+**2. With connection (client managed internally):**
 
 ```svelte
 <script>
   import { ReplaneContext } from '@replanejs/svelte';
 
-  const options = {
+  const connection = {
     baseUrl: 'https://your-replane-server.com',
     sdkKey: 'your-sdk-key',
   };
 </script>
 
 <svelte:boundary onerror={(e) => console.error(e)}>
-  <ReplaneContext {options}>
+  <ReplaneContext {connection}>
     <App />
 
     {#snippet loader()}
@@ -177,7 +186,30 @@ Can be used in three ways:
 </svelte:boundary>
 ```
 
-**3. With a snapshot (for SSR/hydration):**
+**3. With async mode:**
+
+Connect in the background while rendering immediately with defaults:
+
+```svelte
+<script>
+  import { ReplaneContext } from '@replanejs/svelte';
+
+  const connection = {
+    baseUrl: 'https://your-replane-server.com',
+    sdkKey: 'your-sdk-key',
+  };
+
+  const defaults = {
+    featureEnabled: false,
+  };
+</script>
+
+<ReplaneContext {connection} {defaults} async>
+  <App />
+</ReplaneContext>
+```
+
+**4. With a snapshot (for SSR/hydration):**
 
 ```svelte
 <script>
@@ -185,13 +217,13 @@ Can be used in three ways:
 
   let { data, children } = $props();
 
-  const options = {
+  const connection = {
     baseUrl: import.meta.env.VITE_REPLANE_BASE_URL,
     sdkKey: import.meta.env.VITE_REPLANE_SDK_KEY,
   };
 </script>
 
-<ReplaneContext {options} snapshot={data.replaneSnapshot}>
+<ReplaneContext {connection} snapshot={data.replaneSnapshot}>
   {@render children()}
 </ReplaneContext>
 ```
@@ -241,8 +273,10 @@ import { getReplaneSnapshot } from "@replanejs/svelte";
 
 export async function load() {
   const snapshot = await getReplaneSnapshot({
-    baseUrl: import.meta.env.REPLANE_BASE_URL,
-    sdkKey: import.meta.env.REPLANE_SDK_KEY,
+    connection: {
+      baseUrl: import.meta.env.REPLANE_BASE_URL,
+      sdkKey: import.meta.env.REPLANE_SDK_KEY,
+    },
   });
 
   return { replaneSnapshot: snapshot };
@@ -256,13 +290,13 @@ export async function load() {
 
   let { data, children } = $props();
 
-  const options = {
+  const connection = {
     baseUrl: import.meta.env.VITE_REPLANE_BASE_URL,
     sdkKey: import.meta.env.VITE_REPLANE_SDK_KEY,
   };
 </script>
 
-<ReplaneContext {options} snapshot={data.replaneSnapshot}>
+<ReplaneContext {connection} snapshot={data.replaneSnapshot}>
   {@render children()}
 </ReplaneContext>
 ```

package/dist/ReplaneContext.svelte

@@ -26,72 +26,109 @@
     | { status: "ready"; client: Replane<T>; error: null }
     | { status: "error"; client: null; error: Error };
 
-  let state = $state<ClientState>({ status: "loading", client: null, error: null });
-  let clientRef: Replane<T> | null = null;
+  // Determine if we're in sync mode (client available immediately)
+  // This must be computed during initialization, not reactively
+  function computeInitialState(): {
+    state: ClientState;
+    client: Replane<T> | null;
+    isSyncMode: boolean;
+  } {
+    // Pre-created client - use directly
+    if (hasClient(props)) {
+      return {
+        state: { status: "ready", client: props.client, error: null },
+        client: props.client,
+        isSyncMode: true,
+      };
+    }
+
+    const { connection, snapshot, context, logger, defaults } = props;
+    const isAsync = props.async;
+
+    // Sync mode: snapshot, no connection, or async flag
+    if (snapshot || !connection || isAsync) {
+      try {
+        const client = new ReplaneClass<T>({
+          snapshot,
+          logger,
+          context,
+          defaults,
+        });
+        return {
+          state: { status: "ready", client, error: null },
+          client,
+          isSyncMode: true,
+        };
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        return {
+          state: { status: "error", client: null, error },
+          client: null,
+          isSyncMode: true,
+        };
+      }
+    }
+
+    // Loading mode: need to wait for connection
+    return {
+      state: { status: "loading", client: null, error: null },
+      client: null,
+      isSyncMode: false,
+    };
+  }
+
+  // Compute initial state synchronously during component initialization
+  const initialState = computeInitialState();
+  let state = $state<ClientState>(initialState.state);
+  let clientRef: Replane<T> | null = initialState.client;
+
+  // Set context immediately for sync mode (during initialization)
+  if (initialState.isSyncMode && initialState.client) {
+    setReplaneContext<T>(initialState.client);
+  }
+
   let cancelled = false;
 
-  // Handle client initialization based on props
+  // Handle async connection for sync mode, or full async flow for loading mode
   $effect(() => {
     cancelled = false;
 
     if (hasClient(props)) {
-      // Pre-created client - use directly
-      state = { status: "ready", client: props.client, error: null };
+      // Pre-created client - already set up synchronously
       return;
     }
 
-    // Options-based initialization
-    const { options, snapshot } = props;
+    const { connection, logger } = props;
 
-    if (snapshot) {
-      // Restore from snapshot synchronously, connect in background
-      try {
-        const client = new ReplaneClass<T>({
-          snapshot,
-          logger: options.logger,
-          context: options.context,
-          defaults: options.defaults,
-        });
-        // Start connection in background (don't await)
-        client.connect({
-          baseUrl: options.baseUrl,
-          sdkKey: options.sdkKey,
-          fetchFn: options.fetchFn,
-          requestTimeoutMs: options.requestTimeoutMs,
-          retryDelayMs: options.retryDelayMs,
-          inactivityTimeoutMs: options.inactivityTimeoutMs,
-          connectTimeoutMs: options.connectTimeoutMs,
-          agent: options.agent ?? DEFAULT_AGENT,
+    // Get connection options with default agent
+    const connectionWithAgent = connection
+      ? {
+          ...connection,
+          agent: connection.agent ?? DEFAULT_AGENT,
+        }
+      : undefined;
+
+    if (initialState.isSyncMode) {
+      // Sync mode - client already created, just need to connect in background
+      if (connectionWithAgent && clientRef) {
+        clientRef.connect(connectionWithAgent).catch((err) => {
+          (logger ?? console)?.error("Failed to connect Replane client", err);
         });
-        clientRef = client;
-        state = { status: "ready", client, error: null };
-      } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        state = { status: "error", client: null, error };
       }
       return;
     }
 
-    // Async client creation
-    state = { status: "loading", client: null, error: null };
+    // Loading mode - create client and connect
+    const { context, defaults } = props;
 
     const client = new ReplaneClass<T>({
-      logger: options.logger,
-      context: options.context,
-      defaults: options.defaults,
+      logger,
+      context,
+      defaults,
     });
 
     client
-      .connect({
-        baseUrl: options.baseUrl,
-        sdkKey: options.sdkKey,
-        fetchFn: options.fetchFn,
-        requestTimeoutMs: options.requestTimeoutMs,
-        retryDelayMs: options.retryDelayMs,
-        inactivityTimeoutMs: options.inactivityTimeoutMs,
-        connectTimeoutMs: options.connectTimeoutMs,
-        agent: options.agent ?? DEFAULT_AGENT,
-      })
+      .connect(connectionWithAgent!)
       .then(() => {
         if (cancelled) {
           client.disconnect();
@@ -116,9 +153,10 @@
     };
   });
 
-  // Set context when client is ready
+  // Set context when client becomes ready in loading mode
+  // This uses $effect.pre to run before children render
   $effect(() => {
-    if (state.status === "ready" && state.client) {
+    if (!initialState.isSyncMode && state.status === "ready" && state.client) {
       setReplaneContext<T>(state.client);
     }
   });

package/dist/ReplaneContext.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReplaneContext.svelte.d.ts","sourceRoot":"","sources":["../src/ReplaneContext.svelte.ts"],"names":[],"mappings":"AAIE,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,CAAC;AAMJ,iBAAS,QAAQ,CAAC,CAAC,SAAS,MAAM;WAkIL,mBAAmB,CAAC,CAAC,CAAC;;;;;EAA4E;AAC/H,cAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACpC,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3Y,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1I,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,cAAc,EAAE,qBAAmC,CAAC;AACxC,KAAK,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ReplaneContext.svelte.d.ts","sourceRoot":"","sources":["../src/ReplaneContext.svelte.ts"],"names":[],"mappings":"AAIE,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,CAAC;AAMJ,iBAAS,QAAQ,CAAC,CAAC,SAAS,MAAM;WAwKL,mBAAmB,CAAC,CAAC,CAAC;;;;;EAA4E;AAC/H,cAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM;IACpC,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3Y,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1I,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,cAAc,EAAE,qBAAmC,CAAC;AACxC,KAAK,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,eAAe,cAAc,CAAC"}

package/dist/index.d.ts

@@ -3,6 +3,6 @@ export { getReplane, config, configFrom, createTypedReplane, createTypedConfig }
 export { setReplaneContext, getReplaneContext, hasReplaneContext } from "./context";
 export { Replane, getReplaneSnapshot, ReplaneError, ReplaneErrorCode } from "@replanejs/sdk";
 export type { ReplaneSnapshot, ReplaneContext as ReplaneContextType, ReplaneLogger, ReplaneOptions, ConnectOptions, GetConfigOptions, GetReplaneSnapshotOptions, } from "@replanejs/sdk";
-export type { ReplaneContextValue, ReplaneContextProps, ReplaneContextWithClientProps, ReplaneContextWithOptionsProps, ReplaneContextOptions, } from "./types";
-export { hasClient, hasOptions } from "./types";
+export type { ReplaneContextValue, ReplaneContextProps, ReplaneContextWithClientProps, ReplaneContextWithOptionsProps, } from "./types";
+export { hasClient } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGjG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7F,YAAY,EACV,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGjG,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGpF,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7F,YAAY,EACV,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -7,4 +7,4 @@ export { setReplaneContext, getReplaneContext, hasReplaneContext } from "./conte
 // Re-export from SDK for convenience
 export { Replane, getReplaneSnapshot, ReplaneError, ReplaneErrorCode } from "@replanejs/sdk";
 // Type guards
-export { hasClient, hasOptions } from "./types";
+export { hasClient } from "./types";

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { Replane, ReplaneSnapshot, ReplaneContext, ReplaneLogger } from "@replanejs/sdk";
+import type { Replane, ReplaneSnapshot, ReplaneContext as ReplaneContextType, ReplaneLogger, ConnectOptions } from "@replanejs/sdk";
 import type { Snippet } from "svelte";
 /**
  * Context value containing the Replane client
@@ -7,24 +7,29 @@ export interface ReplaneContextValue<T extends object = Record<string, unknown>>
     client: Replane<T>;
 }
 /**
- * Combined options for ReplaneContext.
- * Includes both constructor options (context, logger, defaults) and connection options.
+ * Props for ReplaneContext when using a pre-created client.
  */
-export interface ReplaneContextOptions<T extends object = Record<string, unknown>> {
-    /**
-     * Base URL of the Replane instance (no trailing slash).
-     * @example "https://app.replane.dev"
-     */
-    baseUrl: string;
+export interface ReplaneContextWithClientProps<T extends object = Record<string, unknown>> {
+    /** Pre-created Replane client instance */
+    client: Replane<T>;
+    /** Children snippet */
+    children: Snippet;
+}
+/**
+ * Props for ReplaneContext when letting it manage the client internally.
+ */
+export interface ReplaneContextWithOptionsProps<T extends object = Record<string, unknown>> {
+    /** Children snippet */
+    children: Snippet;
     /**
-     * Project SDK key for authorization.
-     * @example "rp_XXXXXXXXX"
+     * Connection options for connecting to the Replane server.
+     * Pass null to explicitly skip connection (client will use defaults/snapshot only).
      */
-    sdkKey: string;
+    connection: ConnectOptions | null;
     /**
      * Default context for all config evaluations.
      */
-    context?: ReplaneContext;
+    context?: ReplaneContextType;
     /**
      * Optional logger (defaults to console).
      */
@@ -35,57 +40,10 @@ export interface ReplaneContextOptions<T extends object = Record<string, unknown
     defaults?: {
         [K in keyof T]?: T[K];
     };
-    /**
-     * Optional timeout in ms for the initial connection.
-     * @default 5000
-     */
-    connectTimeoutMs?: number;
-    /**
-     * Delay between retries in ms.
-     * @default 200
-     */
-    retryDelayMs?: number;
-    /**
-     * Optional timeout in ms for individual requests.
-     * @default 2000
-     */
-    requestTimeoutMs?: number;
-    /**
-     * Timeout in ms for SSE connection inactivity.
-     * @default 30000
-     */
-    inactivityTimeoutMs?: number;
-    /**
-     * Custom fetch implementation (useful for tests / polyfills).
-     */
-    fetchFn?: typeof fetch;
-    /**
-     * Agent identifier sent in User-Agent header.
-     */
-    agent?: string;
-}
-/**
- * Props for ReplaneContext when using a pre-created client.
- */
-export interface ReplaneContextWithClientProps<T extends object = Record<string, unknown>> {
-    /** Pre-created Replane client instance */
-    client: Replane<T>;
-    /** Children snippet */
-    children: Snippet;
-}
-/**
- * Props for ReplaneContext when letting it manage the client internally.
- */
-export interface ReplaneContextWithOptionsProps<T extends object = Record<string, unknown>> {
-    /** Options to create or restore the Replane client */
-    options: ReplaneContextOptions<T>;
-    /** Children snippet */
-    children: Snippet;
     /**
      * Optional snapshot from server-side rendering.
      * When provided, the client will be restored from the snapshot synchronously
      * instead of fetching configs from the server.
-     * The `options` will be used for live updates connection if provided.
      */
     snapshot?: ReplaneSnapshot<T>;
     /**
@@ -94,14 +52,16 @@ export interface ReplaneContextWithOptionsProps<T extends object = Record<string
      * Ignored when snapshot is provided (restoration is synchronous).
      */
     loader?: Snippet;
+    /**
+     * If true, the client will be connected asynchronously.
+     * Make sure to provide defaults or snapshot.
+     * @default false
+     */
+    async?: boolean;
 }
 export type ReplaneContextProps<T extends object = Record<string, unknown>> = ReplaneContextWithClientProps<T> | ReplaneContextWithOptionsProps<T>;
 /**
  * Type guard to check if props contain a pre-created client.
  */
 export declare function hasClient<T extends object>(props: ReplaneContextProps<T>): props is ReplaneContextWithClientProps<T>;
-/**
- * Type guard to check if props contain options (with or without snapshot).
- */
-export declare function hasOptions<T extends object>(props: ReplaneContextProps<T>): props is ReplaneContextWithOptionsProps<T>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7E,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/E;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IACrC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvF,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxF,sDAAsD;IACtD,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAClC,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtE,6BAA6B,CAAC,CAAC,CAAC,GAChC,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEtC;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,KAAK,IAAI,6BAA6B,CAAC,CAAC,CAAC,CAE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,KAAK,IAAI,8BAA8B,CAAC,CAAC,CAAC,CAE5C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,cAAc,IAAI,kBAAkB,EACpC,aAAa,EACb,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7E,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvF,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxF,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtE,6BAA6B,CAAC,CAAC,CAAC,GAChC,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEtC;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC5B,KAAK,IAAI,6BAA6B,CAAC,CAAC,CAAC,CAE3C"}

package/dist/types.js

@@ -4,9 +4,3 @@
 export function hasClient(props) {
     return "client" in props && props.client !== undefined;
 }
-/**
- * Type guard to check if props contain options (with or without snapshot).
- */
-export function hasOptions(props) {
-    return "options" in props && props.options !== undefined;
-}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
-export declare const VERSION = "0.9.0";
-export declare const DEFAULT_AGENT = "replane-js-svelte/0.9.0";
+export declare const VERSION = "0.9.2";
+export declare const DEFAULT_AGENT = "replane-js-svelte/0.9.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 // Auto-generated - do not edit manually
-export const VERSION = "0.9.0";
+export const VERSION = "0.9.2";
 export const DEFAULT_AGENT = `replane-js-svelte/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replanejs/svelte",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Svelte SDK for Replane - feature flags and remote configuration",
   "type": "module",
   "svelte": "./dist/index.js",
@@ -39,7 +39,7 @@
     "svelte": ">=4.0.0"
   },
   "dependencies": {
-    "@replanejs/sdk": "^0.9.0"
+    "@replanejs/sdk": "^0.9.2"
   },
   "devDependencies": {
     "@sveltejs/package": "^2.3.10",