rune-lab 0.2.1 → 0.2.3

package/dist/core/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./internal/message-resolver";
 export * from "./persistence/types";
+export * from "./money/index";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAE5C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAE5C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,eAAe,CAAC"}

package/dist/core/index.js

@@ -1,2 +1,3 @@
 export * from "./internal/message-resolver";
 export * from "./persistence/types";
+export * from "./money/index";

package/dist/core/money/index.d.ts

@@ -0,0 +1,2 @@
+export { addMoney, createMoney, CURRENCY_MAP, type Dinero, type DineroCurrency, formatAmount, formatMoney, multiplyMoney, subtractMoney, } from "./money";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/money/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/core/money/index.js

@@ -0,0 +1,2 @@
+// sdk/core/src/money/index.ts
+export { addMoney, createMoney, CURRENCY_MAP, formatAmount, formatMoney, multiplyMoney, subtractMoney, } from "./money";

package/dist/core/money/money.d.ts

@@ -0,0 +1,37 @@
+import { type Dinero, type DineroCurrency } from "dinero.js";
+/**
+ * Map of ISO 4217 currency codes to Dinero currency objects
+ */
+export declare const CURRENCY_MAP: Record<string, DineroCurrency<number>>;
+/**
+ * Create a Dinero monetary value from an amount in minor units (cents)
+ * @param amount - Amount in minor units (e.g., 1234 = $12.34 for USD)
+ * @param currencyCode - ISO 4217 currency code (e.g., "USD")
+ */
+export declare function createMoney(amount: number, currencyCode: string): Dinero<number>;
+/**
+ * Format a Dinero value as a locale-aware string
+ * @param money - Dinero monetary value
+ * @param locale - BCP 47 locale string (e.g., "en-US", "es-MX")
+ * @param currencyCode - ISO 4217 code for Intl.NumberFormat (e.g., "USD")
+ */
+export declare function formatMoney(money: Dinero<number>, locale?: string, currencyCode?: string): string;
+/**
+ * Format a raw amount (minor units) as a locale-aware currency string
+ * Convenience wrapper around createMoney + formatMoney
+ */
+export declare function formatAmount(amount: number, currencyCode: string, locale?: string): string;
+/**
+ * Add two monetary values (must be same currency)
+ */
+export declare function addMoney(a: Dinero<number>, b: Dinero<number>): Dinero<number>;
+/**
+ * Subtract two monetary values (must be same currency)
+ */
+export declare function subtractMoney(a: Dinero<number>, b: Dinero<number>): Dinero<number>;
+/**
+ * Multiply a monetary value by a factor
+ */
+export declare function multiplyMoney(money: Dinero<number>, factor: number): Dinero<number>;
+export type { Dinero, DineroCurrency };
+//# sourceMappingURL=money.d.ts.map

package/dist/core/money/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/money.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,MAAM,EAEX,KAAK,cAAc,EAYpB,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAY/D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,CAAC,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM,GAAE,MAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,MAAgB,GACvB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EACjB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAChB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EACjB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAChB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,CAAC,CAEhB;AAGD,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/money/money.js

@@ -0,0 +1,79 @@
+// sdk/core/src/money/money.ts
+// Framework-agnostic money utilities using Dinero.js v2
+// Consumers should never import Dinero directly — these helpers encapsulate it.
+import { add as dineroAdd, AED, BRL, CAD, CNY, dinero, EUR, GBP, INR, JPY, KRW, multiply as dineroMultiply, MXN, subtract as dineroSubtract, toDecimal, 
+// ISO 4217 currency definitions
+USD, } from "dinero.js";
+/**
+ * Map of ISO 4217 currency codes to Dinero currency objects
+ */
+export const CURRENCY_MAP = {
+    USD,
+    EUR,
+    MXN,
+    JPY,
+    KRW,
+    CNY,
+    AED,
+    GBP,
+    CAD,
+    BRL,
+    INR,
+};
+/**
+ * Create a Dinero monetary value from an amount in minor units (cents)
+ * @param amount - Amount in minor units (e.g., 1234 = $12.34 for USD)
+ * @param currencyCode - ISO 4217 currency code (e.g., "USD")
+ */
+export function createMoney(amount, currencyCode) {
+    const currency = CURRENCY_MAP[currencyCode];
+    if (!currency) {
+        throw new Error(`Unknown currency code: ${currencyCode}. Add it to CURRENCY_MAP.`);
+    }
+    return dinero({ amount, currency });
+}
+/**
+ * Format a Dinero value as a locale-aware string
+ * @param money - Dinero monetary value
+ * @param locale - BCP 47 locale string (e.g., "en-US", "es-MX")
+ * @param currencyCode - ISO 4217 code for Intl.NumberFormat (e.g., "USD")
+ */
+export function formatMoney(money, locale = "en-US", currencyCode) {
+    return toDecimal(money, ({ value, currency }) => {
+        const code = currencyCode ??
+            Object.entries(CURRENCY_MAP).find(([, c]) => c.code === currency.code)?.[0] ??
+            currency.code;
+        return new Intl.NumberFormat(locale, {
+            style: "currency",
+            currency: code,
+            minimumFractionDigits: currency.exponent,
+            maximumFractionDigits: currency.exponent,
+        }).format(Number(value));
+    });
+}
+/**
+ * Format a raw amount (minor units) as a locale-aware currency string
+ * Convenience wrapper around createMoney + formatMoney
+ */
+export function formatAmount(amount, currencyCode, locale = "en-US") {
+    const money = createMoney(amount, currencyCode);
+    return formatMoney(money, locale, currencyCode);
+}
+/**
+ * Add two monetary values (must be same currency)
+ */
+export function addMoney(a, b) {
+    return dineroAdd(a, b);
+}
+/**
+ * Subtract two monetary values (must be same currency)
+ */
+export function subtractMoney(a, b) {
+    return dineroSubtract(a, b);
+}
+/**
+ * Multiply a monetary value by a factor
+ */
+export function multiplyMoney(money, factor) {
+    return dineroMultiply(money, factor);
+}

package/dist/index.d.ts

@@ -2,10 +2,4 @@ export * from "rune-lab/core";
 export * from "rune-lab/state";
 export * from "rune-lab/ui";
 
-export {
-  cookieDriver,
-  localStorageDriver,
-  sessionStorageDriver,
-} from "rune-lab/state";
-
 export declare const version: () => string;

package/dist/index.js

@@ -2,10 +2,4 @@ export * from "rune-lab/core";
 export * from "rune-lab/state";
 export * from "rune-lab/ui";
 
-export {
-  cookieDriver,
-  localStorageDriver,
-  sessionStorageDriver,
-} from "rune-lab/state";
-
-export const version = () => "0.2.0";
+export const version = () => "0.2.3";

package/dist/state/auth/index.d.ts

@@ -0,0 +1,2 @@
+export type { AuthConfig, Session, User } from "./types";
+export { createSessionStore, getSessionStore, SessionStore, } from "./session.svelte";

package/dist/state/auth/index.js

@@ -0,0 +1,2 @@
+// sdk/state/src/auth/index.ts
+export { createSessionStore, getSessionStore, SessionStore, } from "./session.svelte";

package/dist/state/auth/session.svelte.d.ts

@@ -0,0 +1,40 @@
+import type { Session, User } from "./types";
+/**
+ * SessionStore — reactive authentication state.
+ *
+ * Once Better-Auth is fully integrated, this store will:
+ * - Initialize from the Better-Auth client SDK
+ * - Manage session lifecycle (login, logout, refresh)
+ * - Expose the current user + session tokens
+ * - Fire onSessionChange callbacks
+ *
+ * For now, it provides the interface contract that consuming apps
+ * and other rune-lab components (UserAvatar, UserProfile) can code against.
+ */
+export declare class SessionStore {
+    /** Whether authentication has been checked (vs. loading) */
+    isReady: boolean;
+    /** Whether a user is currently authenticated */
+    isAuthenticated: boolean;
+    /** Current user (null when logged out) */
+    user: User | null;
+    /** Current session (null when logged out) */
+    session: Session | null;
+    /**
+     * Initialize the session — placeholder for Better-Auth client setup
+     */
+    init(): Promise<void>;
+    /**
+     * Log in — placeholder
+     */
+    login(_credentials: {
+        email: string;
+        password: string;
+    }): Promise<boolean>;
+    /**
+     * Log out — placeholder
+     */
+    logout(): Promise<void>;
+}
+export declare function createSessionStore(): SessionStore;
+export declare function getSessionStore(): SessionStore;

package/dist/state/auth/session.svelte.js

@@ -0,0 +1,57 @@
+// sdk/state/src/auth/session.svelte.ts
+// SessionStore — manages authentication state via Svelte 5 runes.
+// This is a SKELETON — full Better-Auth wiring is deferred to a dedicated spec.
+import { getContext } from "svelte";
+import { RUNE_LAB_CONTEXT } from "../context";
+/**
+ * SessionStore — reactive authentication state.
+ *
+ * Once Better-Auth is fully integrated, this store will:
+ * - Initialize from the Better-Auth client SDK
+ * - Manage session lifecycle (login, logout, refresh)
+ * - Expose the current user + session tokens
+ * - Fire onSessionChange callbacks
+ *
+ * For now, it provides the interface contract that consuming apps
+ * and other rune-lab components (UserAvatar, UserProfile) can code against.
+ */
+export class SessionStore {
+    /** Whether authentication has been checked (vs. loading) */
+    isReady = $state(false);
+    /** Whether a user is currently authenticated */
+    isAuthenticated = $state(false);
+    /** Current user (null when logged out) */
+    user = $state(null);
+    /** Current session (null when logged out) */
+    session = $state(null);
+    /**
+     * Initialize the session — placeholder for Better-Auth client setup
+     */
+    async init() {
+        // TODO: Wire Better-Auth client.getSession() here
+        this.isReady = true;
+    }
+    /**
+     * Log in — placeholder
+     */
+    async login(_credentials) {
+        // TODO: Wire Better-Auth client.signIn.email() here
+        console.warn("SessionStore.login() is a stub — implement Better-Auth integration");
+        return false;
+    }
+    /**
+     * Log out — placeholder
+     */
+    async logout() {
+        // TODO: Wire Better-Auth client.signOut() here
+        this.user = null;
+        this.session = null;
+        this.isAuthenticated = false;
+    }
+}
+export function createSessionStore() {
+    return new SessionStore();
+}
+export function getSessionStore() {
+    return getContext(RUNE_LAB_CONTEXT.session);
+}

package/dist/state/auth/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal user representation for rune-lab's auth layer.
+ * Consuming apps can extend this with domain-specific fields.
+ */
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+    avatar_url?: string;
+    role?: string;
+}
+/**
+ * Active session information
+ */
+export interface Session {
+    user: User;
+    accessToken: string;
+    expiresAt: Date;
+}
+/**
+ * Auth configuration passed to RuneProvider
+ */
+export interface AuthConfig {
+    /** Better-Auth client instance */
+    client?: any;
+    /** Callback when session changes (login, logout, expiry) */
+    onSessionChange?: (session: Session | null) => void;
+    /** Routes that require authentication */
+    protectedRoutes?: string[];
+}

package/dist/state/auth/types.js

@@ -0,0 +1,3 @@
+// sdk/state/src/auth/types.ts
+// Core auth types — framework-agnostic interfaces
+export {};

package/dist/state/cart.svelte.d.ts

@@ -0,0 +1,64 @@
+import type { PersistenceDriver } from "rune-lab/core";
+/**
+ * Configuration for creating a CartStore
+ */
+export interface CartStoreConfig<T> {
+    /** Extract a unique identifier from an item */
+    idExtractor: (item: T) => string;
+    /** Extract the price (in minor units / cents) from an item */
+    priceExtractor: (item: T) => number;
+    /** Optional persistence driver for cart recovery */
+    driver?: PersistenceDriver;
+    /** Storage key for persistence */
+    storageKey?: string;
+}
+export interface CartEntry<T> {
+    item: T;
+    qty: number;
+}
+/**
+ * Generic cart store factory.
+ * Works with any item type via extractors.
+ *
+ * **Note**: Consumers must call `setContext(RUNE_LAB_CONTEXT.cart, store)` manually
+ * since CartStore is app-specific (needs `idExtractor` and `priceExtractor`).
+ * RuneProvider can optionally wire it via `config.cart`.
+ *
+ * Usage:
+ *   const cart = createCartStore<Property>({
+ *     idExtractor: (p) => p.id,
+ *     priceExtractor: (p) => p.price,
+ *   });
+ *   cart.add(someProperty);
+ *   cart.totalPrice; // sum of all items * qty in minor units
+ */
+export declare function createCartStore<T>(config: CartStoreConfig<T>): {
+    /** All cart entries */
+    readonly items: CartEntry<T>[];
+    /** Total number of items (sum of quantities) */
+    readonly totalItems: number;
+    /** Total price in minor units */
+    readonly totalPrice: number;
+    /** Whether the cart is empty */
+    readonly isEmpty: boolean;
+    /** Add an item (or increment quantity if already present) */
+    add(item: T, qty?: number): void;
+    /** Remove an item entirely */
+    remove(id: string): void;
+    /** Update the quantity of an item (removes if qty ≤ 0) */
+    updateQty(id: string, qty: number): void;
+    /** Clear all items */
+    clear(): void;
+    /** Check if an item is in the cart */
+    has(id: string): boolean;
+    /** Get a specific entry by ID */
+    getEntry(id: string): CartEntry<T> | undefined;
+};
+/** Return type of createCartStore for context typing */
+export type CartStore<T = unknown> = ReturnType<typeof createCartStore<T>>;
+/**
+ * Get CartStore from Svelte context.
+ * Only works if the consuming app has called setContext(RUNE_LAB_CONTEXT.cart, store)
+ * or passed a cart config to RuneProvider.
+ */
+export declare function getCartStore<T = unknown>(): CartStore<T>;

package/dist/state/cart.svelte.js

@@ -0,0 +1,122 @@
+// sdk/state/src/cart.svelte.ts
+// Generic cart store factory — business-agnostic add/remove/total pattern.
+import { getContext } from "svelte";
+import { RUNE_LAB_CONTEXT } from "./context";
+import { DEV } from "esm-env";
+/**
+ * Generic cart store factory.
+ * Works with any item type via extractors.
+ *
+ * **Note**: Consumers must call `setContext(RUNE_LAB_CONTEXT.cart, store)` manually
+ * since CartStore is app-specific (needs `idExtractor` and `priceExtractor`).
+ * RuneProvider can optionally wire it via `config.cart`.
+ *
+ * Usage:
+ *   const cart = createCartStore<Property>({
+ *     idExtractor: (p) => p.id,
+ *     priceExtractor: (p) => p.price,
+ *   });
+ *   cart.add(someProperty);
+ *   cart.totalPrice; // sum of all items * qty in minor units
+ */
+export function createCartStore(config) {
+    const { idExtractor, priceExtractor, driver, storageKey = "cart", } = config;
+    // Internal entries store — using a plain array for correct serialization
+    let _entries = $state([]);
+    /** Lookup by ID */
+    function _findIndex(id) {
+        return _entries.findIndex((e) => idExtractor(e.item) === id);
+    }
+    /** @internal Persist current state (Map serialized as Array) */
+    function _persist() {
+        if (!driver)
+            return;
+        try {
+            const data = _entries.map((entry) => ({
+                id: idExtractor(entry.item),
+                qty: entry.qty,
+            }));
+            driver.set(storageKey, JSON.stringify(data));
+        }
+        catch {
+            // Persistence is best-effort
+        }
+    }
+    return {
+        /** All cart entries */
+        get items() {
+            return _entries;
+        },
+        /** Total number of items (sum of quantities) */
+        get totalItems() {
+            let total = 0;
+            for (const entry of _entries)
+                total += entry.qty;
+            return total;
+        },
+        /** Total price in minor units */
+        get totalPrice() {
+            let total = 0;
+            for (const entry of _entries) {
+                total += priceExtractor(entry.item) * entry.qty;
+            }
+            return total;
+        },
+        /** Whether the cart is empty */
+        get isEmpty() {
+            return _entries.length === 0;
+        },
+        /** Add an item (or increment quantity if already present) */
+        add(item, qty = 1) {
+            const id = idExtractor(item);
+            const idx = _findIndex(id);
+            if (idx >= 0) {
+                _entries[idx] = { ..._entries[idx], qty: _entries[idx].qty + qty };
+            }
+            else {
+                _entries = [..._entries, { item, qty }];
+            }
+            _persist();
+            if (DEV)
+                console.log(`🛒 Added ${id} (qty: ${qty})`);
+        },
+        /** Remove an item entirely */
+        remove(id) {
+            _entries = _entries.filter((e) => idExtractor(e.item) !== id);
+            _persist();
+        },
+        /** Update the quantity of an item (removes if qty ≤ 0) */
+        updateQty(id, qty) {
+            if (qty <= 0) {
+                this.remove(id);
+                return;
+            }
+            const idx = _findIndex(id);
+            if (idx >= 0) {
+                _entries[idx] = { ..._entries[idx], qty };
+                _persist();
+            }
+        },
+        /** Clear all items */
+        clear() {
+            _entries = [];
+            _persist();
+        },
+        /** Check if an item is in the cart */
+        has(id) {
+            return _findIndex(id) >= 0;
+        },
+        /** Get a specific entry by ID */
+        getEntry(id) {
+            return _entries.find((e) => idExtractor(e.item) === id);
+        },
+    };
+}
+/**
+ * Get CartStore from Svelte context.
+ * Only works if the consuming app has called setContext(RUNE_LAB_CONTEXT.cart, store)
+ * or passed a cart config to RuneProvider.
+ */
+export function getCartStore() {
+    return getContext(RUNE_LAB_CONTEXT.cart);
+}

package/dist/state/composables/useMoney.d.ts

@@ -0,0 +1,15 @@
+import { type Dinero } from "rune-lab/core";
+/**
+ * Context-aware money composable.
+ * Reads CurrencyStore and LanguageStore from rune-lab context.
+ *
+ * Usage:
+ *   const { format, toDinero, add, subtract } = useMoney();
+ *   const display = format(15000); // "$150.00" (based on current currency + locale)
+ */
+export declare function useMoney(): {
+    toDinero: (amount: number, currencyCode?: string) => Dinero<number>;
+    format: (amount: number, currencyCode?: string) => string;
+    add: (a: number, b: number, currencyCode?: string) => Dinero<number>;
+    subtract: (a: number, b: number, currencyCode?: string) => Dinero<number>;
+};

package/dist/state/composables/useMoney.js

@@ -0,0 +1,48 @@
+// sdk/state/src/composables/useMoney.ts
+// Context-aware money composable that reads CurrencyStore + LanguageStore
+import { getContext } from "svelte";
+import { RUNE_LAB_CONTEXT } from "../context";
+import { addMoney, createMoney, formatMoney, subtractMoney, } from "rune-lab/core";
+/**
+ * Context-aware money composable.
+ * Reads CurrencyStore and LanguageStore from rune-lab context.
+ *
+ * Usage:
+ *   const { format, toDinero, add, subtract } = useMoney();
+ *   const display = format(15000); // "$150.00" (based on current currency + locale)
+ */
+export function useMoney() {
+    const currencyStore = getContext(RUNE_LAB_CONTEXT.currency);
+    const languageStore = getContext(RUNE_LAB_CONTEXT.language);
+    /**
+     * Convert minor-unit amount to a Dinero object using current currency
+     */
+    function toDinero(amount, currencyCode) {
+        const code = currencyCode ?? String(currencyStore.current);
+        return createMoney(amount, code);
+    }
+    /**
+     * Format an amount (minor units) as a locale-aware currency string
+     */
+    function format(amount, currencyCode) {
+        const code = currencyCode ?? String(currencyStore.current);
+        const locale = String(languageStore.current) || "en";
+        const money = createMoney(amount, code);
+        return formatMoney(money, locale, code);
+    }
+    /**
+     * Add two amounts (minor units) in the current currency
+     */
+    function add(a, b, currencyCode) {
+        const code = currencyCode ?? String(currencyStore.current);
+        return addMoney(createMoney(a, code), createMoney(b, code));
+    }
+    /**
+     * Subtract two amounts (minor units) in the current currency
+     */
+    function subtract(a, b, currencyCode) {
+        const code = currencyCode ?? String(currencyStore.current);
+        return subtractMoney(createMoney(a, code), createMoney(b, code));
+    }
+    return { toDinero, format, add, subtract };
+}

package/dist/state/composables/useRuneLab.d.ts

@@ -1,4 +1,4 @@
-import { getApiStore, getAppStore, getCommandStore, getCurrencyStore, getLanguageStore, getLayoutStore, getShortcutStore, getThemeStore, getToastStore } from "../index";
+import { getApiStore, getAppStore, getCommandStore, getCurrencyStore, getLanguageStore, getLayoutStore, getShortcutStore, getThemeStore, getToastStore, type SessionStore } from "../index";
 export interface RuneLabContext {
     app: ReturnType<typeof getAppStore>;
     api: ReturnType<typeof getApiStore>;
@@ -9,6 +9,8 @@ export interface RuneLabContext {
     shortcut: ReturnType<typeof getShortcutStore>;
     layout: ReturnType<typeof getLayoutStore>;
     commands: ReturnType<typeof getCommandStore>;
+    /** Available when auth is enabled in RuneProvider config */
+    session?: SessionStore;
 }
 /**
  * Retrieves all Rune Lab stores from the Svelte context tree.

package/dist/state/composables/useRuneLab.js

@@ -1,10 +1,20 @@
 // src/lib/composables/useRuneLab.ts
 import { getApiStore, getAppStore, getCommandStore, getCurrencyStore, getLanguageStore, getLayoutStore, getShortcutStore, getThemeStore, getToastStore, } from "../index";
+import { getContext } from "svelte";
+import { RUNE_LAB_CONTEXT } from "../context";
 /**
  * Retrieves all Rune Lab stores from the Svelte context tree.
  * Must be called during component initialization (in the `<script>` block).
  */
 export function useRuneLab() {
+    // Session is optional — only present when auth is enabled
+    let session;
+    try {
+        session = getContext(RUNE_LAB_CONTEXT.session);
+    }
+    catch {
+        // Auth not enabled — session stays undefined
+    }
     return {
         app: getAppStore(),
         api: getApiStore(),
@@ -15,5 +25,6 @@ export function useRuneLab() {
         shortcut: getShortcutStore(),
         layout: getLayoutStore(),
         commands: getCommandStore(),
+        session,
     };
 }

package/dist/state/context.d.ts

@@ -9,4 +9,6 @@ export declare const RUNE_LAB_CONTEXT: {
     readonly layout: symbol;
     readonly commands: symbol;
     readonly persistence: symbol;
+    readonly cart: symbol;
+    readonly session: symbol;
 };

package/dist/state/context.js

@@ -10,4 +10,6 @@ export const RUNE_LAB_CONTEXT = {
     layout: Symbol("rl:layout"),
     commands: Symbol("rl:commands"),
     persistence: Symbol("rl:persistence"),
+    cart: Symbol("rl:cart"),
+    session: Symbol("rl:session"),
 };

package/dist/state/createConfigStore.svelte.d.ts

@@ -5,16 +5,18 @@ export type ConfigStore<T extends ConfigItem> = {
     set: (id: T[keyof T]) => void;
     get: (id: T[keyof T]) => T | undefined;
     getProp: <K extends keyof T>(prop: K, id?: T[keyof T]) => T[K] | undefined;
+    /** Append additional items (e.g. custom themes/currencies from the consuming app) */
+    addItems: (newItems: T[]) => void;
 };
 /**
  * Generic configuration store factory
  * Creates type-safe stores for theme, language, currency, etc.
  * with validation, persistence, and utilities
  */
-interface ConfigItem {
+export interface ConfigItem {
     [key: string]: any;
 }
-interface ConfigStoreOptions<T extends ConfigItem> {
+export interface ConfigStoreOptions<T extends ConfigItem> {
     /** Array of available items */
     items: readonly T[];
     /** Storage key used by the persistence driver */
@@ -46,5 +48,8 @@ export declare function createConfigStore<T extends ConfigItem>(options: ConfigS
      * Get property from current or specified item
      */
     getProp<K extends keyof T>(prop: K, id?: T[keyof T]): T[K] | undefined;
+    /**
+     * Append additional items (deduplicates by idKey)
+     */
+    addItems(newItems: T[]): void;
 };
-export {};