@quvel-kit/core 1.3.7 → 1.3.9

package/dist/composables/index.d.ts

@@ -16,4 +16,5 @@ export { useQueryMessageHandler, normalizeKey, mapStatusToType } from './useQuer
 export type { MessageHandlerOptions } from './useQueryMessageHandler.js';
 export { useUrlQueryHandler } from './useUrlQueryHandler.js';
 export type { UrlQueryHandlerOptions } from './useUrlQueryHandler.js';
+export { useSSRData } from './useSSRData.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACpG,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACpG,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/composables/index.js

@@ -14,3 +14,4 @@ export { useRecaptcha } from './useRecaptcha.js';
 export { useXsrf } from './useXsrf.js';
 export { useQueryMessageHandler, normalizeKey, mapStatusToType } from './useQueryMessageHandler.js';
 export { useUrlQueryHandler } from './useUrlQueryHandler.js';
+export { useSSRData } from './useSSRData.js';

package/dist/composables/useSSRData.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SSR Data Composable
+ *
+ * Fetches data during SSR, serializes to client, and hydrates on mount.
+ * Eliminates the need for a Pinia store per page for SSR data loading.
+ */
+import { type Ref } from 'vue';
+/**
+ * SSR data loading composable
+ *
+ * @param key - Unique key for this data (used for serialization)
+ * @param fetcher - Async function that fetches the data
+ * @returns Reactive data ref, loading state, and error state
+ *
+ * @example
+ * ```typescript
+ * const { data: household, isLoading, error } = useSSRData(
+ *   `household-${route.params.id}`,
+ *   () => householdService.get(route.params.id)
+ * );
+ * ```
+ */
+export declare function useSSRData<T>(key: string, fetcher: () => Promise<T>): {
+    data: Ref<T | null>;
+    isLoading: Ref<boolean>;
+    error: Ref<Error | null>;
+};
+//# sourceMappingURL=useSSRData.d.ts.map

package/dist/composables/useSSRData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSSRData.d.ts","sourceRoot":"","sources":["../../src/composables/useSSRData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAoC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAejE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACxB;IACD,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAC1B,CAsDA"}

package/dist/composables/useSSRData.js

@@ -0,0 +1,91 @@
+/**
+ * SSR Data Composable
+ *
+ * Fetches data during SSR, serializes to client, and hydrates on mount.
+ * Eliminates the need for a Pinia store per page for SSR data loading.
+ */
+import { ref, onMounted, onServerPrefetch } from 'vue';
+import { useQuvel } from './useQuvel.js';
+const SSR_DATA_PREFIX = '__SSR_DATA_';
+const SSR_ERROR_PREFIX = '__SSR_ERROR_';
+/**
+ * Check if SSR data exists in window (for initial state)
+ */
+function hasSSRData(key) {
+    if (typeof window === 'undefined')
+        return false;
+    const win = window;
+    return win[`${SSR_DATA_PREFIX}${key}`] !== undefined;
+}
+/**
+ * SSR data loading composable
+ *
+ * @param key - Unique key for this data (used for serialization)
+ * @param fetcher - Async function that fetches the data
+ * @returns Reactive data ref, loading state, and error state
+ *
+ * @example
+ * ```typescript
+ * const { data: household, isLoading, error } = useSSRData(
+ *   `household-${route.params.id}`,
+ *   () => householdService.get(route.params.id)
+ * );
+ * ```
+ */
+export function useSSRData(key, fetcher) {
+    const isSSR = typeof window === 'undefined';
+    const container = useQuvel();
+    const dataKey = `${SSR_DATA_PREFIX}${key}`;
+    const errorKey = `${SSR_ERROR_PREFIX}${key}`;
+    const data = ref(null);
+    const error = ref(null);
+    const isLoading = ref(isSSR || !hasSSRData(key));
+    if (isSSR) {
+        onServerPrefetch(async () => {
+            try {
+                const result = await fetcher();
+                data.value = result;
+                container.windowBag?.set(dataKey, result);
+            }
+            catch (e) {
+                const err = e instanceof Error ? e : new Error(String(e));
+                error.value = err;
+                container.windowBag?.set(errorKey, { message: err.message, name: err.name });
+            }
+            finally {
+                isLoading.value = false;
+            }
+        });
+    }
+    else {
+        onMounted(async () => {
+            const win = window;
+            const ssrData = win[dataKey];
+            const ssrError = win[errorKey];
+            delete win[dataKey];
+            delete win[errorKey];
+            if (ssrError) {
+                const err = new Error(ssrError.message);
+                err.name = ssrError.name;
+                error.value = err;
+                isLoading.value = false;
+            }
+            else if (ssrData !== undefined) {
+                data.value = ssrData;
+                isLoading.value = false;
+            }
+            else {
+                try {
+                    data.value = await fetcher();
+                }
+                catch (e) {
+                    error.value = e instanceof Error ? e : new Error(String(e));
+                }
+                finally {
+                    isLoading.value = false;
+                }
+            }
+        });
+    }
+    return { data, isLoading, error };
+}

package/dist/container/ServiceContainer.d.ts

@@ -1,6 +1,7 @@
 import type { Service, ServiceClass } from './types.js';
 import type { QSsrContext } from '@quasar/app-vite';
 import type { AppConfig } from '../types/app.types.js';
+import type { SSRDataBag } from '../types/ssr.js';
 import { LogService } from "../services/LogService.js";
 import { ApiService } from "../services/ApiService.js";
 import { I18nService } from "../services/I18nService.js";
@@ -29,6 +30,11 @@ export declare class ServiceContainer {
      * Get the SSR context
      */
     get ssrContext(): QSsrContext | null | undefined;
+    /**
+     * Get the WindowBag for SSR data serialization
+     * Only available during SSR
+     */
+    get windowBag(): SSRDataBag | undefined;
     /**
      * Initialize services from their classes with config and SSR context
      */

package/dist/container/ServiceContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceContainer.d.ts","sourceRoot":"","sources":["../../src/container/ServiceContainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EACP,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAC,gBAAgB,EAAC,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AAGzD;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAL/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwC;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;gBAGjB,WAAW,CAAC,GAAE,WAAW,GAAG,IAAI,aAAA,EACjD,cAAc,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAa;IAQvD;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,WAAW,GAAG,IAAI,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,GAAG,GAAI,CAAC,SAAS,OAAO,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,KAAG,CAAC,CAkBzD;IAEF;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIzD;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,UAAQ,GAAG,OAAO;IAgBxF;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO;IAIrE;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IAEH,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED,IAAI,UAAU,IAAI,iBAAiB,CAElC;IAED,IAAI,IAAI;;;;;;;MAIP;IAED,IAAI,EAAE,IAAI,gBAAgB,CAEzB;IAED,IAAI,KAAK,IAAI,YAAY,CAExB;CACF"}
+{"version":3,"file":"ServiceContainer.d.ts","sourceRoot":"","sources":["../../src/container/ServiceContainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EACP,YAAY,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAC,gBAAgB,EAAC,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAC;AAGzD;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAL/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwC;IAC1E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;gBAGjB,WAAW,CAAC,GAAE,WAAW,GAAG,IAAI,aAAA,EACjD,cAAc,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAa;IAQvD;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,WAAW,GAAG,IAAI,GAAG,SAAS,CAE/C;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,UAAU,GAAG,SAAS,CAGtC;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,GAAG,GAAI,CAAC,SAAS,OAAO,EAAE,cAAc,YAAY,CAAC,CAAC,CAAC,KAAG,CAAC,CAkBzD;IAEF;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIzD;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,UAAQ,GAAG,OAAO;IAgBxF;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO;IAIrE;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IAEH,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED,IAAI,UAAU,IAAI,iBAAiB,CAElC;IAED,IAAI,IAAI;;;;;;;MAIP;IAED,IAAI,EAAE,IAAI,gBAAgB,CAEzB;IAED,IAAI,KAAK,IAAI,YAAY,CAExB;CACF"}

package/dist/container/ServiceContainer.js

@@ -38,6 +38,14 @@ export class ServiceContainer {
     get ssrContext() {
         return this._ssrContext;
     }
+    /**
+     * Get the WindowBag for SSR data serialization
+     * Only available during SSR
+     */
+    get windowBag() {
+        const req = this._ssrContext?.req;
+        return req?.quvelContext?.windowBag;
+    }
     /**
      * Initialize services from their classes with config and SSR context
      */

package/dist/types/ssr.d.ts

@@ -9,3 +9,13 @@ declare module '@quasar/app-vite' {
     $quvel?: ServiceContainer;
   }
 }
+
+/**
+ * SSR Data Bag interface for component data serialization
+ * Minimal interface matching WindowBag from @quvel-kit/ssr
+ */
+export interface SSRDataBag {
+  set(key: string, value: unknown): void;
+  get<T = unknown>(key: string): T | undefined;
+  has(key: string): boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quvel-kit/core",
-  "version": "1.3.7",
+  "version": "1.3.9",
   "description": "Core utilities for Quvel UI",
   "type": "module",
   "main": "./dist/index.js",
@@ -70,7 +70,7 @@
     "pusher-js": "^8.0.0",
     "quasar": "^2.0.0",
     "vue": "^3.0.0",
-    "vue-i18n": "^10.0.0",
+    "vue-i18n": "^11.0.0",
     "vue-router": "^4.0.0",
     "zod": "^3.25.0"
   },