@rolder/kit 3.0.0-alpha.8 → 3.0.0-alpha.9

package/dist/app/defaultRequestMiddlewares.js

@@ -0,0 +1,24 @@
+import { createMiddleware } from "@tanstack/react-start";
+import { getCookie, getRequestHeader, setCookie } from "@tanstack/react-start/server";
+const defaultRequestMiddlewares_locale = createMiddleware().server(async ({ next })=>{
+    const header = getRequestHeader('accept-language');
+    const headerLocale = header?.split(',')[0] || 'ru-RU';
+    const cookieLocale = getCookie('locale');
+    const cookieTz = getCookie('tz');
+    const locale = cookieLocale || headerLocale;
+    const timeZone = cookieTz || 'UTC';
+    setCookie('locale', locale, {
+        path: '/',
+        maxAge: 31536000
+    });
+    return next({
+        context: {
+            locale,
+            timeZone
+        }
+    });
+});
+const defaultRequestMiddlewares = [
+    defaultRequestMiddlewares_locale
+];
+export { defaultRequestMiddlewares };

package/dist/app/defaultTheme.d.ts

@@ -0,0 +1,141 @@
+export declare const defaultTheme: {
+    focusRing?: "auto" | "always" | "never" | undefined;
+    scale?: number | undefined;
+    fontSmoothing?: boolean | undefined;
+    white?: string | undefined;
+    black?: string | undefined;
+    colors?: {
+        [x: string & {}]: import("@mantine/core").MantineColorsTuple | undefined;
+        dark?: import("@mantine/core").MantineColorsTuple | undefined;
+        gray?: import("@mantine/core").MantineColorsTuple | undefined;
+        red?: import("@mantine/core").MantineColorsTuple | undefined;
+        pink?: import("@mantine/core").MantineColorsTuple | undefined;
+        grape?: import("@mantine/core").MantineColorsTuple | undefined;
+        violet?: import("@mantine/core").MantineColorsTuple | undefined;
+        indigo?: import("@mantine/core").MantineColorsTuple | undefined;
+        blue?: import("@mantine/core").MantineColorsTuple | undefined;
+        cyan?: import("@mantine/core").MantineColorsTuple | undefined;
+        green?: import("@mantine/core").MantineColorsTuple | undefined;
+        lime?: import("@mantine/core").MantineColorsTuple | undefined;
+        yellow?: import("@mantine/core").MantineColorsTuple | undefined;
+        orange?: import("@mantine/core").MantineColorsTuple | undefined;
+        teal?: import("@mantine/core").MantineColorsTuple | undefined;
+    } | undefined;
+    primaryShade?: import("@mantine/core").MantineColorShade | {
+        light?: import("@mantine/core").MantineColorShade | undefined;
+        dark?: import("@mantine/core").MantineColorShade | undefined;
+    } | undefined;
+    primaryColor?: string | undefined;
+    variantColorResolver?: import("@mantine/core").VariantColorsResolver | undefined;
+    autoContrast?: boolean | undefined;
+    luminanceThreshold?: number | undefined;
+    fontFamily?: string | undefined;
+    fontFamilyMonospace?: string | undefined;
+    headings?: {
+        fontFamily?: string | undefined;
+        fontWeight?: string | undefined;
+        textWrap?: "balance" | "nowrap" | "wrap" | "stable" | "pretty" | undefined;
+        sizes?: {
+            h1?: {
+                fontSize?: string | undefined;
+                fontWeight?: string | undefined;
+                lineHeight?: string | undefined;
+            } | undefined;
+            h2?: {
+                fontSize?: string | undefined;
+                fontWeight?: string | undefined;
+                lineHeight?: string | undefined;
+            } | undefined;
+            h3?: {
+                fontSize?: string | undefined;
+                fontWeight?: string | undefined;
+                lineHeight?: string | undefined;
+            } | undefined;
+            h4?: {
+                fontSize?: string | undefined;
+                fontWeight?: string | undefined;
+                lineHeight?: string | undefined;
+            } | undefined;
+            h5?: {
+                fontSize?: string | undefined;
+                fontWeight?: string | undefined;
+                lineHeight?: string | undefined;
+            } | undefined;
+            h6?: {
+                fontSize?: string | undefined;
+                fontWeight?: string | undefined;
+                lineHeight?: string | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    radius?: {
+        [x: string & {}]: string | undefined;
+        xs?: string | undefined;
+        sm?: string | undefined;
+        md?: string | undefined;
+        lg?: string | undefined;
+        xl?: string | undefined;
+    } | undefined;
+    defaultRadius?: import("@mantine/core").MantineRadius | undefined;
+    spacing?: {
+        [x: number]: string | undefined;
+        [x: string & {}]: string | undefined;
+        xs?: string | undefined;
+        sm?: string | undefined;
+        md?: string | undefined;
+        lg?: string | undefined;
+        xl?: string | undefined;
+    } | undefined;
+    fontSizes?: {
+        [x: string & {}]: string | undefined;
+        xs?: string | undefined;
+        sm?: string | undefined;
+        md?: string | undefined;
+        lg?: string | undefined;
+        xl?: string | undefined;
+    } | undefined;
+    lineHeights?: {
+        [x: string & {}]: string | undefined;
+        xs?: string | undefined;
+        sm?: string | undefined;
+        md?: string | undefined;
+        lg?: string | undefined;
+        xl?: string | undefined;
+    } | undefined;
+    breakpoints?: {
+        [x: string & {}]: string | undefined;
+        xs?: string | undefined;
+        sm?: string | undefined;
+        md?: string | undefined;
+        lg?: string | undefined;
+        xl?: string | undefined;
+    } | undefined;
+    shadows?: {
+        [x: string & {}]: string | undefined;
+        xs?: string | undefined;
+        sm?: string | undefined;
+        md?: string | undefined;
+        lg?: string | undefined;
+        xl?: string | undefined;
+    } | undefined;
+    respectReducedMotion?: boolean | undefined;
+    cursorType?: "default" | "pointer" | undefined;
+    defaultGradient?: {
+        from?: string | undefined;
+        to?: string | undefined;
+        deg?: number | undefined;
+    } | undefined;
+    activeClassName?: string | undefined;
+    focusClassName?: string | undefined;
+    components?: {
+        [x: string]: {
+            classNames?: any;
+            styles?: any;
+            vars?: any;
+            defaultProps?: any;
+        } | undefined;
+    } | undefined;
+    other?: {
+        [x: string]: any;
+    } | undefined;
+};

package/dist/app/defaultTheme.js

@@ -0,0 +1,24 @@
+import { Modal, createTheme } from "@mantine/core";
+const defaultTheme = createTheme({
+    components: {
+        Modal: Modal.extend({
+            defaultProps: {
+                centered: true,
+                padding: 'lg'
+            }
+        }),
+        ModalTitle: Modal.Title.extend({
+            defaultProps: {
+                pr: 24
+            }
+        }),
+        ModalCloseButton: Modal.CloseButton.extend({
+            defaultProps: {
+                pos: 'absolute',
+                top: 4,
+                right: 4
+            }
+        })
+    }
+});
+export { defaultTheme };

package/dist/functions/getCookie.d.ts

@@ -0,0 +1,3 @@
+export declare function getCookie<T extends string>(name: string, defaultValue: T): T;
+export declare function getCookie(name: string, defaultValue: string): string;
+export declare function getCookie(name: string, defaultValue?: undefined): string | undefined;

package/dist/functions/getCookie.js

@@ -0,0 +1,8 @@
+import { createIsomorphicFn } from "@tanstack/react-start";
+import { getCookie } from "@tanstack/react-start/server";
+import js_cookie from "js-cookie";
+const getCookieImpl = createIsomorphicFn().server((name, defaultValue)=>getCookie(name) || defaultValue).client((name, defaultValue)=>js_cookie.get(name) || defaultValue);
+function getCookie_getCookie(name, defaultValue) {
+    return getCookieImpl(name, defaultValue);
+}
+export { getCookie_getCookie as getCookie };

package/dist/functions/setCookie.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Изоморфная функция для установки значения куки.
+ * На клиенте использует библиотеку js-cookie для работы с куками.
+ * На сервере использует функции getCookie и setCookie из tanstack start.
+ *
+ * @param {string} name - Имя куки
+ * @param {string} value - Значение куки, если не указано, кука будет удалена
+ * @param {number} [expires=7] - Количество дней до истечения срока действия куки (по умолчанию 7 дней)
+ */
+export declare const setCookie: import("@tanstack/start-fn-stubs").IsomorphicFn<[name: string, value?: string | undefined, expires?: number | undefined], void, void>;

package/dist/functions/setCookie.js

@@ -0,0 +1,19 @@
+import { createIsomorphicFn } from "@tanstack/react-start";
+import { deleteCookie, setCookie } from "@tanstack/react-start/server";
+import js_cookie from "js-cookie";
+const setCookie_setCookie = createIsomorphicFn().server((name, value, expires)=>{
+    const expiresDate = new Date();
+    expiresDate.setDate(expiresDate.getDate() + (expires || 7));
+    if (value) setCookie(name, value, {
+        expires: expiresDate
+    });
+    else deleteCookie(name);
+}).client((name, value, expires)=>{
+    const expiresDate = new Date();
+    expiresDate.setDate(expiresDate.getDate() + (expires || 7));
+    if (value) js_cookie.set(name, value, {
+        expires: expiresDate
+    });
+    else js_cookie.remove(name);
+});
+export { setCookie_setCookie as setCookie };

package/dist/functions/setCookies.d.ts

@@ -0,0 +1,14 @@
+interface Cookie {
+    name: string;
+    value?: string;
+    expires?: number;
+}
+/**
+ * Клиентская функция для установки значения нескольких куки.
+ * На клиенте использует библиотеку js-cookie для работы с куками.
+ * На сервере использует функции getCookie и setCookie из tanstack start.
+ *
+ * @param {Cookie[]} cookies - Массив объектов с данными куки *
+ */
+export declare const setCookies: (cookies: Cookie[]) => void;
+export {};

package/dist/functions/setCookies.js

@@ -0,0 +1,13 @@
+import { createClientOnlyFn } from "@tanstack/react-start";
+import js_cookie from "js-cookie";
+const setCookies = createClientOnlyFn((cookies)=>{
+    cookies.forEach(({ name, value, expires })=>{
+        const expiresDate = new Date();
+        expiresDate.setDate(expiresDate.getDate() + (expires || 7));
+        if (value) js_cookie.set(name, value, {
+            expires: expiresDate
+        });
+        else js_cookie.remove(name);
+    });
+});
+export { setCookies };

package/dist/hooks/useMutation.d.ts

@@ -0,0 +1,4 @@
+import { type UseMutationOptions } from '@tanstack/react-query';
+export declare const useMutation: <T, K = void>(fn: ({ data }: {
+    data: T;
+}) => Promise<K>, options?: Omit<UseMutationOptions<K, Error, T>, "mutationFn">) => import("@tanstack/react-query").UseMutationResult<K, Error, T, unknown>;

package/dist/hooks/useMutation.js

@@ -0,0 +1,8 @@
+import { useMutation } from "@tanstack/react-query";
+const useMutation_useMutation = (fn, options)=>useMutation({
+        mutationFn: (data)=>fn({
+                data
+            }),
+        ...options
+    });
+export { useMutation_useMutation as useMutation };

package/dist/hooks/useMutationWithInvalidate.d.ts

@@ -0,0 +1,4 @@
+import { type UseMutationOptions } from '@tanstack/react-query';
+export declare const useMutationWithInvalidate: <T, K = void>(fn: ({ data }: {
+    data: T;
+}) => Promise<K>, queryKey: string[], options?: Omit<UseMutationOptions<K, Error, T>, "mutationFn" | "onSettled">) => import("@tanstack/react-query").UseMutationResult<K, Error, T, unknown>;

package/dist/hooks/useMutationWithInvalidate.js

@@ -0,0 +1,16 @@
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+const useMutationWithInvalidate = (fn, queryKey, options)=>{
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: (data)=>fn({
+                data
+            }),
+        onSettled: async (_, error)=>{
+            if (!error && queryKey.length) await queryClient.invalidateQueries({
+                queryKey
+            });
+        },
+        ...options
+    });
+};
+export { useMutationWithInvalidate };

package/{src/index.ts → dist/index.d.ts}

@@ -1,66 +1,26 @@
 /** biome-ignore-all assist/source/organizeImports: <> */
-
-//* AI *//
-export {
-  Conversation,
-  type ConversationProps,
-  useChatMessage,
-} from './ai/ui/conversation';
-export {
-  type Accept,
-  PromptInput,
-  type PromptInputProps,
-} from './ai/ui/promptInput';
+export { Conversation, type ConversationProps, useChatMessage, } from './ai/ui/conversation';
+export { type Accept, PromptInput, type PromptInputProps, } from './ai/ui/promptInput';
 export { convertFileUIPartBlobToDataURL } from './ai/utils/convertFileUIPartBlobToDataURL';
 export { parseAiMessagePart } from './ai/utils/parseAiMessagePart';
-
-//* APP *//
 export { DefaultApp } from './app/DefaultApp';
 export { defaultRequestMiddlewares } from './app/defaultRequestMiddlewares';
 export { defaultTheme } from './app/defaultTheme';
-
-//* FUNCTIONS *//
 export { getCookie } from './functions/getCookie';
 export { setCookie } from './functions/setCookie';
 export { setCookies } from './functions/setCookies';
-
-//* HOOKS *//
 export { useMutation } from './hooks/useMutation';
 export { useMutationWithInvalidate } from './hooks/useMutationWithInvalidate';
-
-//* SURREAL *//
 export { getDB } from './surreal/connection';
 export { surrealDeleteFn, surrealUnsubscribeFn } from './surreal/deafaultCrud';
 export { deserialize } from './surreal/deserialize';
 export { encryptionFn } from './surreal/encryption';
-
-//* UI *//
 export { Editor, useEditor } from './ui/editor';
-export {
-  DefaultError,
-  DefaultNotFound,
-  defaultErrorNotification,
-  Forbidden,
-} from './ui/error';
+export { DefaultError, DefaultNotFound, defaultErrorNotification, Forbidden, } from './ui/error';
 export { AnimatedChevron } from './ui/AnimatedChevron';
-export {
-  useAppForm,
-  useFieldContext,
-  withForm,
-  blurOnError,
-  fieldsSchema,
-} from './ui/form';
+export { useAppForm, useFieldContext, withForm, blurOnError, fieldsSchema, } from './ui/form';
 export { HoverPaper, usePaperHover } from './ui/hoverPaper';
 export { JsonInput } from './ui/JsonInput';
 export { RouterLink } from './ui/RouterLink';
 export { SaveInput } from './ui/saveInput';
-export {
-  ScrollArea,
-  useScrollArea,
-  type ScrollAreaContextValue,
-  type ScrollAreaHook,
-  type ScrollAreaProps,
-  type ScrollAreaState,
-  type ScrollButtonProps,
-  type ScrollPosition,
-} from './ui/scrollArea';
+export { ScrollArea, useScrollArea, type ScrollAreaContextValue, type ScrollAreaHook, type ScrollAreaProps, type ScrollAreaState, type ScrollButtonProps, type ScrollPosition, } from './ui/scrollArea';

package/dist/index.js

@@ -0,0 +1,26 @@
+import { Conversation, useChatMessage } from "./ai/ui/conversation/index.js";
+import { PromptInput } from "./ai/ui/promptInput/index.js";
+import { convertFileUIPartBlobToDataURL } from "./ai/utils/convertFileUIPartBlobToDataURL.js";
+import { parseAiMessagePart } from "./ai/utils/parseAiMessagePart.js";
+import { DefaultApp } from "./app/DefaultApp.js";
+import { defaultRequestMiddlewares } from "./app/defaultRequestMiddlewares.js";
+import { defaultTheme } from "./app/defaultTheme.js";
+import { getCookie } from "./functions/getCookie.js";
+import { setCookie } from "./functions/setCookie.js";
+import { setCookies } from "./functions/setCookies.js";
+import { useMutation } from "./hooks/useMutation.js";
+import { useMutationWithInvalidate } from "./hooks/useMutationWithInvalidate.js";
+import { getDB } from "./surreal/connection.js";
+import { surrealDeleteFn, surrealUnsubscribeFn } from "./surreal/deafaultCrud.js";
+import { deserialize } from "./surreal/deserialize.js";
+import { encryptionFn } from "./surreal/encryption.js";
+import { Editor, useEditor } from "./ui/editor/index.js";
+import { DefaultError, DefaultNotFound, Forbidden, defaultErrorNotification } from "./ui/error/index.js";
+import { AnimatedChevron } from "./ui/AnimatedChevron.js";
+import { blurOnError, fieldsSchema, useAppForm, useFieldContext, withForm } from "./ui/form/index.js";
+import { HoverPaper, usePaperHover } from "./ui/hoverPaper/index.js";
+import { JsonInput } from "./ui/JsonInput.js";
+import { RouterLink } from "./ui/RouterLink.js";
+import { SaveInput } from "./ui/saveInput/index.js";
+import { ScrollArea, useScrollArea } from "./ui/scrollArea/index.js";
+export { AnimatedChevron, Conversation, DefaultApp, DefaultError, DefaultNotFound, Editor, Forbidden, HoverPaper, JsonInput, PromptInput, RouterLink, SaveInput, ScrollArea, blurOnError, convertFileUIPartBlobToDataURL, defaultErrorNotification, defaultRequestMiddlewares, defaultTheme, deserialize, encryptionFn, fieldsSchema, getCookie, getDB, parseAiMessagePart, setCookie, setCookies, surrealDeleteFn, surrealUnsubscribeFn, useAppForm, useChatMessage, useEditor, useFieldContext, useMutation, useMutationWithInvalidate, usePaperHover, useScrollArea, withForm };

package/{src → dist}/styles.css

@@ -1,23 +1,17 @@
 .rolder-prompt-input-root {
-  background-color: light-dark(
-    var(--mantine-color-white),
-    var(--mantine-color-dark-6)
-  );
+  background-color: light-dark(var(--mantine-color-white), var(--mantine-color-dark-6));
 
   &:focus-within {
-    outline: none;
     border-color: var(--mantine-primary-color-filled);
-  }
-  &:focus-within {
-    outline: none;
     border-color: var(--mantine-primary-color-filled);
+    outline: none;
   }
 }
 
 .rolder-prompt-input-textarea {
   border: 0;
-  overflow: hidden;
   border-radius: 8px;
+  overflow: hidden;
 }
 
 .rolder-prompt-input-file-action-action {
@@ -29,11 +23,7 @@
 }
 
 .rolder-editor-root {
-  --editor-border-color: light-dark(
-    var(--mantine-color-gray-3),
-    var(--mantine-color-dark-4)
-  );
-
+  --editor-border-color: light-dark(var(--mantine-color-gray-3), var(--mantine-color-dark-4));
   border: rem(1px) solid var(--editor-border-color);
   border-radius: var(--mantine-radius-md);
 }
@@ -49,15 +39,14 @@
 }
 
 .rolder-hover-paper-root {
-  transition: background-color 0.2s ease-in-out;
+  transition: background-color .2s ease-in-out;
+
   &:hover {
-    background-color: light-dark(
-      var(--mantine-color-gray-0),
-      var(--mantine-color-dark-6)
-    );
-    transition: background-color 0.2s ease-in-out;
+    background-color: light-dark(var(--mantine-color-gray-0), var(--mantine-color-dark-6));
     cursor: pointer;
+    transition: background-color .2s ease-in-out;
   }
+
   &[data-disabled] {
     background-color: unset;
     cursor: default;
@@ -65,8 +54,8 @@
 }
 
 .rolder-router-link-root {
-  text-decoration: none;
   color: inherit;
+  text-decoration: none;
 }
 
 .rolder-scroll-area-viewport {
@@ -82,3 +71,4 @@
   border-top-right-radius: var(--radius);
   border-bottom-right-radius: var(--radius);
 }
+

package/dist/surreal/connection.d.ts

@@ -0,0 +1,9 @@
+import { type CodecOptions, Surreal } from 'surrealdb';
+export declare const getDB: (params?: {
+    url?: string;
+    namespace?: string;
+    database?: string;
+    username?: string;
+    password?: string;
+    codecOptions?: CodecOptions;
+} | undefined) => Promise<Surreal>;

package/dist/surreal/connection.js

@@ -0,0 +1,49 @@
+import { createServerOnlyFn } from "@tanstack/react-start";
+import { getCookie } from "@tanstack/react-start/server";
+import { DateTime, Surreal } from "surrealdb";
+let db = null;
+const getDB = createServerOnlyFn(async (params = {})=>{
+    if (db?.isConnected) return db;
+    const locale = getCookie('locale') || 'ru-RU';
+    const timeZone = getCookie('tz') || 'UTC';
+    const instance = new Surreal({
+        codecOptions: params.codecOptions || {
+            valueDecodeVisitor (value) {
+                if (value instanceof DateTime) return new Date(value.toDate()).toLocaleDateString(locale, {
+                    hour: 'numeric',
+                    minute: 'numeric',
+                    timeZone
+                });
+                return value;
+            }
+        }
+    });
+    try {
+        const url = params.url || process.env.SURREALDB_URL;
+        if (!url) throw new Error('Missing required SurrealDB URL');
+        const namespace = params.namespace || process.env.SURREALDB_NAMESPACE;
+        if (!namespace) throw new Error('Missing required SurrealDB namespace');
+        const database = params.database || process.env.SURREALDB_DATABASE;
+        if (!database) throw new Error('Missing required SurrealDB database');
+        const username = params.username || process.env.SURREALDB_USERNAME;
+        const password = params.password || process.env.SURREALDB_PASSWORD;
+        if (username && password) await instance.connect(url, {
+            authentication: {
+                username,
+                password
+            }
+        });
+        else await instance.connect(url);
+        await instance.use({
+            namespace,
+            database
+        });
+        db = instance;
+        return instance;
+    } catch (error) {
+        console.error('Failed to connect to SurrealDB:', error);
+        db = null;
+        throw error;
+    }
+});
+export { getDB };

package/dist/surreal/deafaultCrud.d.ts

@@ -0,0 +1,2 @@
+export declare const surrealDeleteFn: import("@tanstack/start-client-core").RequiredFetcher<undefined, (data: string) => string, Promise<void>>;
+export declare const surrealUnsubscribeFn: import("@tanstack/start-client-core").RequiredFetcher<undefined, (data: string) => string, Promise<void>>;

package/dist/surreal/deafaultCrud.js

@@ -0,0 +1,18 @@
+import { createServerFn } from "@tanstack/react-start";
+import { getDB } from "./connection.js";
+import { deserialize } from "./deserialize.js";
+const surrealDeleteFn = createServerFn({
+    method: 'POST'
+}).inputValidator((data)=>data).handler(async ({ data })=>{
+    const db = await getDB();
+    const id = deserialize(data);
+    await db.delete(id);
+});
+const surrealUnsubscribeFn = createServerFn({
+    method: 'POST'
+}).inputValidator((data)=>data).handler(async ({ data })=>{
+    const db = await getDB();
+    const live = await db.liveOf(data);
+    await live.kill();
+});
+export { surrealDeleteFn, surrealUnsubscribeFn };

package/dist/surreal/deserialize.d.ts

@@ -0,0 +1,17 @@
+import { RecordId } from 'surrealdb';
+/**
+ * Type that converts specified string paths to RecordId, others stay as their original types
+ */
+type DeserializeResult<T, IdPaths extends string = never> = T extends string ? RecordId<string> : T extends (infer U)[] ? U extends object ? {
+    [K in keyof U]: K extends IdPaths ? RecordId<string> : U[K];
+}[] : DeserializeResult<U, IdPaths>[] : T extends object ? T extends Date ? T : {
+    [K in keyof T]: K extends IdPaths ? RecordId<string> : T[K];
+} : T;
+/**
+ * Deserializes DTO back to SurrealDB Record recursively based on specified ID paths
+ */
+export declare function deserialize<T, K extends keyof T & string>(dto: T[], idPaths: K[]): DeserializeResult<T, K>[];
+export declare function deserialize<T, K extends keyof T & string>(dto: T, idPaths: K[]): DeserializeResult<T, K>;
+export declare function deserialize<T>(dto: T[]): DeserializeResult<T>[];
+export declare function deserialize<T>(dto: T): DeserializeResult<T>;
+export {};

package/dist/surreal/deserialize.js

@@ -0,0 +1,46 @@
+import { RecordId } from "surrealdb";
+const extractTableName = (str)=>{
+    const match = str.match(/^([^:]+):/);
+    return match ? match[1] : null;
+};
+const isRecordIdFormat = (str)=>/^[^:]+:.+$/.test(str);
+function deserialize(dto, idPaths) {
+    if (Array.isArray(dto)) return dto.map((item)=>convertStringsToRecordIds(item, idPaths || []));
+    return convertStringsToRecordIds(dto, idPaths || []);
+}
+const convertStringsToRecordIds = (obj, idPaths, currentPath = '')=>{
+    if (null == obj) return obj;
+    if (Array.isArray(obj)) {
+        if (idPaths.includes(currentPath)) return obj.map((item)=>{
+            if ('string' == typeof item && isRecordIdFormat(item)) {
+                const tableName = extractTableName(item);
+                if (tableName) return new RecordId(tableName, item.split(':')[1]);
+            }
+            return item;
+        });
+        return obj.map((item, index)=>convertStringsToRecordIds(item, idPaths, `${currentPath}[${index}]`));
+    }
+    if ('object' == typeof obj && !(obj instanceof Date)) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)){
+            const fieldPath = currentPath ? `${currentPath}.${key}` : key;
+            if ('string' == typeof value) {
+                const shouldConvert = idPaths.includes(fieldPath) && isRecordIdFormat(value);
+                if (shouldConvert) {
+                    const tableName = extractTableName(value);
+                    if (tableName) result[key] = new RecordId(tableName, value.split(':')[1]);
+                    else result[key] = value;
+                } else result[key] = value;
+            } else result[key] = convertStringsToRecordIds(value, idPaths, fieldPath);
+        }
+        return result;
+    }
+    if ('string' == typeof obj) {
+        if (0 === idPaths.length && isRecordIdFormat(obj)) {
+            const tableName = extractTableName(obj);
+            if (tableName) return new RecordId(tableName, obj.split(':')[1]);
+        }
+    }
+    return obj;
+};
+export { deserialize };

package/dist/surreal/encryption.d.ts

@@ -0,0 +1,6 @@
+type EncryptionInstance = {
+    encrypt(text: string): string;
+    decrypt(encryptedText: string): string;
+};
+export declare const encryptionFn: (secretHash: string) => EncryptionInstance;
+export {};