@azure-net/kit 3.1.0 → 3.9.2

package/dist/core/shared/boundaryProvider/Provider.js

@@ -1,11 +1,12 @@
 import { RequestContext } from '../../../edges/context/index.js';
-import { EnvironmentUtil } from 'azure-net-tools';
+import { BROWSER } from '@azure-net/tools/environment';
+import { AzureNetKitInternalError } from '../appError/AppError.js';
 const clientCache = new Map();
 const factoriesCache = new WeakMap();
 const providerProxyCache = new Map();
 const clientBootFlags = new Map();
 const getProviderCache = (providerName) => {
-    if (EnvironmentUtil.isBrowser) {
+    if (BROWSER) {
         if (!clientCache.has(providerName)) {
             clientCache.set(providerName, new Map());
         }
@@ -28,7 +29,7 @@ const getProviderCache = (providerName) => {
     }
 };
 const getBootFlag = (providerName) => {
-    if (EnvironmentUtil.isBrowser) {
+    if (BROWSER) {
         return clientBootFlags.get(providerName) ?? false;
     }
     else {
@@ -41,7 +42,7 @@ const getBootFlag = (providerName) => {
     }
 };
 const setBootFlag = (providerName, value) => {
-    if (EnvironmentUtil.isBrowser) {
+    if (BROWSER) {
         clientBootFlags.set(providerName, value);
     }
     else {
@@ -56,7 +57,7 @@ const setBootFlag = (providerName, value) => {
 export const createBoundaryProvider = (name, settings) => {
     const { dependsOn = {}, boot, register } = settings;
     const providerFn = () => {
-        if (EnvironmentUtil.isBrowser && providerProxyCache.has(name)) {
+        if (BROWSER && providerProxyCache.has(name)) {
             return providerProxyCache.get(name);
         }
         const cache = getProviderCache(name);
@@ -82,7 +83,7 @@ export const createBoundaryProvider = (name, settings) => {
                 });
             }
             factories = register(deps);
-            if (EnvironmentUtil.isBrowser) {
+            if (BROWSER) {
                 factoriesCache.set(register, factories);
             }
             return factories;
@@ -94,10 +95,16 @@ export const createBoundaryProvider = (name, settings) => {
                 }
                 const factories = getFactories();
                 if (!(key in factories)) {
-                    throw new Error(`Service '${key}' not found in provider '${name}'`);
+                    throw new AzureNetKitInternalError(`[BoundaryProvider] Service '${key}' not found in provider '${name}'`);
                 }
                 const factory = factories[key];
+                if (typeof factory !== 'function') {
+                    throw new AzureNetKitInternalError('[BoundaryProvider] Factory must be a function');
+                }
                 const instance = factory();
+                if (instance && typeof instance?.then === 'function') {
+                    throw new AzureNetKitInternalError(`[BoundaryProvider] Service '${key}' in provider '${name}' returned Promise.`);
+                }
                 cache.set(key, instance);
                 return instance;
             },
@@ -114,7 +121,7 @@ export const createBoundaryProvider = (name, settings) => {
                 return [...new Set([...cachedKeys, ...factoryKeys])];
             }
         });
-        if (EnvironmentUtil.isBrowser) {
+        if (BROWSER) {
             providerProxyCache.set(name, providerProxy);
         }
         if (boot && !getBootFlag(name)) {
@@ -143,7 +150,7 @@ export function cleanupProvider(name) {
         await Promise.all(promises);
         cache.clear();
     };
-    if (EnvironmentUtil.isBrowser) {
+    if (BROWSER) {
         const cache = clientCache.get(name);
         if (cache) {
             void cleanupCache(cache);

package/dist/core/shared/classMirror/ClassMirror.d.ts

@@ -1,3 +1,8 @@
-export declare class ClassMirror<Target extends object> {
-    constructor(target: Target);
+declare const MIRROR_TARGET: unique symbol;
+declare const MIRROR_CACHE: unique symbol;
+export declare class ClassMirror {
+    private [MIRROR_TARGET];
+    private [MIRROR_CACHE];
+    constructor(target: object);
 }
+export {};

package/dist/core/shared/classMirror/ClassMirror.js

@@ -1,19 +1,38 @@
+const MIRROR_TARGET = Symbol('class-mirror-target');
+const MIRROR_CACHE = Symbol('class-mirror-cache');
 export class ClassMirror {
+    [MIRROR_TARGET];
+    [MIRROR_CACHE];
     constructor(target) {
-        const proto = Object.getPrototypeOf(target);
-        for (const name of Object.getOwnPropertyNames(proto)) {
-            if (name === 'constructor')
-                continue;
-            const descriptor = Object.getOwnPropertyDescriptor(proto, name);
-            if (!descriptor || typeof descriptor.value !== 'function')
-                continue;
-            if (name in this)
-                continue;
-            Object.defineProperty(this, name, {
-                value: descriptor.value.bind(target),
-                configurable: true,
-                writable: true
-            });
-        }
+        this[MIRROR_TARGET] = target;
+        this[MIRROR_CACHE] = new Map();
+        return new Proxy(this, {
+            get(proxyTarget, prop, receiver) {
+                if (Reflect.has(proxyTarget, prop)) {
+                    return Reflect.get(proxyTarget, prop, receiver);
+                }
+                const mirrorTarget = proxyTarget[MIRROR_TARGET];
+                const mirroredValue = Reflect.get(mirrorTarget, prop, mirrorTarget);
+                if (typeof mirroredValue !== 'function') {
+                    return mirroredValue;
+                }
+                const cache = proxyTarget[MIRROR_CACHE];
+                if (cache.has(prop)) {
+                    return cache.get(prop);
+                }
+                const bound = mirroredValue.bind(mirrorTarget);
+                cache.set(prop, bound);
+                return bound;
+            },
+            has(proxyTarget, prop) {
+                return Reflect.has(proxyTarget, prop) || Reflect.has(proxyTarget[MIRROR_TARGET], prop);
+            },
+            ownKeys(proxyTarget) {
+                return [...new Set([...Reflect.ownKeys(proxyTarget), ...Reflect.ownKeys(proxyTarget[MIRROR_TARGET])])];
+            },
+            getOwnPropertyDescriptor(proxyTarget, prop) {
+                return Reflect.getOwnPropertyDescriptor(proxyTarget, prop) ?? Reflect.getOwnPropertyDescriptor(proxyTarget[MIRROR_TARGET], prop);
+            }
+        });
     }
 }

package/dist/core/shared/cookie/UniversalCookie.js

@@ -1,5 +1,6 @@
-import { Cookies, EnvironmentUtil } from 'azure-net-tools';
-import { RequestContext } from 'edges-svelte/context';
+import { Cookies } from '@azure-net/tools';
+import { BROWSER } from '@azure-net/tools/environment';
+import { RequestContext } from '@azure-net/edges/context';
 /**
  * Utility class for managing cookies in svelte ssr (browser and server).
  * Supports setting, getting, deleting, checking, and clearing cookies.
@@ -17,11 +18,11 @@ export class UniversalCookie {
      * @returns {void}
      */
     static set(name, value, options) {
-        if (EnvironmentUtil.isBrowser) {
+        if (BROWSER) {
             Cookies.set(name, value, options);
             return;
         }
-        if (EnvironmentUtil.isServer) {
+        else {
             const event = RequestContext.current().event;
             if (event) {
                 const encodedKey = encodeURIComponent(name);
@@ -53,7 +54,6 @@ export class UniversalCookie {
                 return;
             }
         }
-        throw new Error('Could not detect current environment');
     }
     /**
      * Retrieves the value of a cookie by key.
@@ -64,10 +64,10 @@ export class UniversalCookie {
      * @returns {T | undefined} The cookie value, parsed as type T or null if not found.
      */
     static get(name) {
-        if (EnvironmentUtil.isBrowser) {
+        if (BROWSER) {
             return Cookies.get(name) ?? undefined;
         }
-        if (EnvironmentUtil.isServer) {
+        else {
             const event = RequestContext.current().event;
             if (event) {
                 const encodedKey = encodeURIComponent(name);
@@ -85,7 +85,6 @@ export class UniversalCookie {
             }
             return undefined;
         }
-        return undefined;
     }
     /**
      * Retrieves all cookies as a key-value record.
@@ -95,10 +94,10 @@ export class UniversalCookie {
      * @returns {T | undefined} An object with all cookie keys and their values.
      */
     static getAll() {
-        if (EnvironmentUtil.isBrowser) {
+        if (BROWSER) {
             return Cookies.getAll();
         }
-        if (EnvironmentUtil.isServer) {
+        else {
             const event = RequestContext.current().event;
             const result = {};
             if (event) {
@@ -114,7 +113,6 @@ export class UniversalCookie {
             }
             return result;
         }
-        return undefined;
     }
     /**
      * Checks if a cookie with the given key exists.

package/dist/core/shared/middleware/Middleware.js

@@ -1,12 +1,12 @@
 import { error, redirect } from '@sveltejs/kit';
-import { RequestContext } from 'edges-svelte/context';
+import { RequestContext } from '@azure-net/edges/context';
 import { beforeNavigate, goto } from '$app/navigation';
 import { page } from '$app/state';
-import { EnvironmentUtil } from 'azure-net-tools';
+import { BROWSER } from '@azure-net/tools/environment';
 import { UniversalCookie } from '../cookie/index.js';
 export const createMiddlewareManager = (middlewares) => {
     const universalRedirect = (location, status = 301, navigation) => {
-        if (EnvironmentUtil.isBrowser) {
+        if (BROWSER) {
             if (navigation) {
                 navigation?.cancel();
             }
@@ -18,8 +18,8 @@ export const createMiddlewareManager = (middlewares) => {
     };
     const executeMiddlewares = async (navigation) => {
         let event;
-        let from = undefined;
-        if (EnvironmentUtil.isServer) {
+        let from;
+        if (!BROWSER) {
             event = RequestContext.current().event;
             const referer = event?.request.headers.get('referer');
             from = referer ? new URL(referer) : undefined;
@@ -27,7 +27,7 @@ export const createMiddlewareManager = (middlewares) => {
         else {
             from = navigation?.from?.url ?? undefined;
         }
-        const to = (EnvironmentUtil.isBrowser ? (navigation?.to?.url ?? page?.url) : event?.url);
+        const to = (BROWSER ? (navigation?.to?.url ?? page?.url) : event?.url);
         for (const middleware of middlewares) {
             let shouldContinue = false;
             const next = (location, status = 301) => {
@@ -40,14 +40,14 @@ export const createMiddlewareManager = (middlewares) => {
                 event,
                 page,
                 cookies: UniversalCookie,
-                isServer: EnvironmentUtil.isServer,
+                isServer: !BROWSER,
                 to,
                 from,
                 error,
                 next
             });
             if (!shouldContinue) {
-                if (EnvironmentUtil.isBrowser) {
+                if (BROWSER) {
                     navigation?.cancel();
                     if (from) {
                         void goto(from.pathname);
@@ -61,7 +61,11 @@ export const createMiddlewareManager = (middlewares) => {
         }
     };
     const serverMiddleware = async () => await executeMiddlewares();
+    let clientRegistered = false;
     const clientMiddleware = () => {
+        if (!BROWSER || clientRegistered)
+            return;
+        clientRegistered = true;
         beforeNavigate(async (navigation) => {
             await executeMiddlewares(navigation);
         });

package/dist/core/svelte/ActiveForm/ActiveForm.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { RequestErrors } from '../../delivery/schema/index.js';
-import type { AsyncActionResponse } from '../../index.js';
-type InitialData<FormData, Initial extends Partial<FormData>> = Initial | Promise<Initial> | (() => Initial | Promise<Initial>);
+import type { AsyncActionResponse } from '../../delivery/injectableDependencies/AsyncHelpers.js';
+type InitialData<FormData, Initial extends Partial<FormData>> = () => Initial | Promise<Initial>;
 type PathRequiredShape<T, P extends string> = P extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? {
     [K in Head]-?: PathRequiredShape<NonNullable<T[K]>, Tail>;
 } : unknown : P extends keyof T ? {
@@ -8,19 +8,23 @@ type PathRequiredShape<T, P extends string> = P extends `${infer Head}.${infer T
 } : unknown;
 type UnionToIntersection<U> = (U extends unknown ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
 type RequiredByPaths<T, P extends string> = [P] extends [never] ? object : UnionToIntersection<PathRequiredShape<T, P>>;
+type ResetBehaviors = 'clear' | 'initial' | 'reloadInitial' | 'default';
 export interface FormConfig<FormData, Response, Initial extends Partial<FormData> = Partial<FormData>, RequiredPath extends string = never> {
     initialData?: InitialData<FormData, Initial>;
     required?: readonly RequiredPath[];
     onSuccess?: (response: Response) => Promise<void> | void;
     onError?: () => Promise<void> | void;
-    beforeSubmit?: (form: ActiveFormController<FormData, RequiredPath>, abort: () => void) => Promise<void> | void;
-    waitForInitialData?: boolean;
+    beforeSubmit?: (actions: {
+        form: ActiveFormController<FormData, RequiredPath>;
+        abort: () => void;
+    }) => Promise<void> | void;
+    successBehavior?: ResetBehaviors;
 }
 export interface ActiveForm<FormData, Response, Custom, RequiredPath extends string = never> {
     data: Partial<FormData> & RequiredByPaths<FormData, RequiredPath>;
     errors: RequestErrors<FormData>;
     submit: () => Promise<AsyncActionResponse<Response, FormData, Custom>>;
-    reset: (toInitial?: boolean) => void;
+    reset: (behavior?: ResetBehaviors) => Promise<void>;
     pending: boolean;
     dirty: boolean;
     ready: Promise<Partial<FormData>>;
@@ -28,7 +32,7 @@ export interface ActiveForm<FormData, Response, Custom, RequiredPath extends str
 export interface ActiveFormController<FormData, RequiredPath extends string = never> {
     data: Partial<FormData> & RequiredByPaths<FormData, RequiredPath>;
     errors: RequestErrors<FormData>;
-    reset: (toInitial?: boolean) => void;
+    reset: (behavior?: ResetBehaviors) => Promise<void>;
 }
 type ExtractResponse<T> = T extends AsyncActionResponse<infer R, unknown, unknown> ? R : never;
 type ExtractFormData<T> = T extends AsyncActionResponse<unknown, infer D, unknown> ? D : never;

package/dist/core/svelte/ActiveForm/ActiveForm.svelte.js

@@ -1,59 +1,55 @@
-import { ObjectUtil } from 'azure-net-tools';
+import { ObjectUtil } from '@azure-net/tools';
 export const createActiveForm = (onSubmit, config) => {
     const isPromise = (value) => {
         return typeof value?.then === 'function';
     };
-    const resolveInitialSource = () => {
-        const source = config?.initialData;
-        if (!source) {
-            return { sync: true, value: {} };
-        }
-        const result = typeof source === 'function' ? source() : source;
-        if (isPromise(result)) {
-            return { sync: false, promise: result };
-        }
-        return { sync: true, value: (result ?? {}) };
-    };
-    const initialSource = resolveInitialSource();
-    let initial = initialSource.sync ? initialSource.value : {};
+    let initial = {};
     let formData = $state(ObjectUtil.deepClone(initial));
     let formErrors = $state({});
     let pending = $state(false);
-    const dirty = $derived(JSON.stringify(formData) !== JSON.stringify(initial));
-    const ready = (async () => {
-        if (!initialSource.sync) {
-            initial = (await initialSource.promise) ?? {};
-            if (config?.waitForInitialData !== false) {
-                formData = ObjectUtil.deepClone(initial);
-            }
+    const dirty = $derived(!ObjectUtil.equals(formData, initial));
+    const loadInitialData = async () => {
+        const source = config?.initialData;
+        if (!source) {
+            initial = {};
+            formData = ObjectUtil.deepClone(initial);
+            formErrors = {};
+            return initial;
         }
+        const value = source();
+        const nextInitial = isPromise(value) ? await value : value;
+        initial = (nextInitial ?? {});
+        formData = ObjectUtil.deepClone(initial);
+        formErrors = {};
         return initial;
-    })();
+    };
+    const ready = loadInitialData();
     const submit = async () => {
         pending = true;
-        if (config?.beforeSubmit) {
-            let aborted = false;
-            const abort = () => {
-                aborted = true;
-                pending = false;
-            };
-            await config.beforeSubmit(formApi, () => abort());
-            if (aborted) {
-                return {
-                    success: false,
-                    response: undefined
+        try {
+            if (config?.beforeSubmit) {
+                let aborted = false;
+                const abort = () => {
+                    aborted = true;
+                    pending = false;
                 };
+                await config.beforeSubmit({ form: formApi, abort: () => abort() });
+                if (aborted) {
+                    return {
+                        success: false,
+                        response: undefined
+                    };
+                }
             }
-        }
-        try {
             const result = await onSubmit($state.snapshot(formData));
-            if (result.error?.fields) {
-                formErrors = result.error.fields;
-            }
             if (result.success) {
                 await config?.onSuccess?.(result.response);
+                await reset(config?.successBehavior ?? 'default');
             }
             else {
+                if (result.error?.validation) {
+                    formErrors = result.error.validation;
+                }
                 await config?.onError?.();
             }
             return result;
@@ -62,8 +58,18 @@ export const createActiveForm = (onSubmit, config) => {
             pending = false;
         }
     };
-    const reset = (toInitial = false) => {
-        formData = toInitial ? ObjectUtil.deepClone(initial) : {};
+    const reset = async (behavior = 'clear') => {
+        switch (behavior) {
+            case 'clear':
+                formData = {};
+                break;
+            case 'initial':
+                formData = ObjectUtil.deepClone(initial);
+                break;
+            case 'reloadInitial':
+                await loadInitialData();
+                break;
+        }
         formErrors = {};
     };
     const formApi = {
@@ -100,8 +106,8 @@ export const createActiveForm = (onSubmit, config) => {
         get pending() {
             return pending;
         },
-        ready,
         submit,
+        ready,
         reset
     };
 };

package/dist/core/svelte/AsyncSignal/AsyncSignal.svelte.d.ts

@@ -3,7 +3,6 @@ export type AsyncSignalSource = 'auto' | 'manual' | 'global';
 export interface AsyncSignalOptions<TData, TError = Error> {
     server?: boolean;
     immediate?: boolean;
-    watch?: (() => unknown)[];
     initialData?: TData | (() => TData);
     beforeSend?: (meta: {
         initial: boolean;

package/dist/core/svelte/AsyncSignal/AsyncSignal.svelte.js

@@ -1,7 +1,7 @@
 import { untrack } from 'svelte';
-import { EnvironmentUtil } from 'azure-net-tools';
+import { BROWSER } from '@azure-net/tools/environment';
 const createAsyncSignalManager = () => {
-    const instances = EnvironmentUtil.isBrowser ? new Map() : undefined;
+    const instances = BROWSER ? new Map() : undefined;
     const generateUid = () => {
         return Math.random().toString(36).substring(2, 9);
     };
@@ -46,7 +46,7 @@ const createAsyncSignalManager = () => {
 };
 const asyncSignalManager = createAsyncSignalManager();
 export const createAsyncSignal = (handler, options = {}) => {
-    const { server = false, immediate = true, watch = [], initialData = undefined, key } = options;
+    const { server = false, immediate = true, initialData = undefined, key } = options;
     const resolvedInitialData = typeof initialData === 'function' ? initialData() : initialData;
     let data = $state(resolvedInitialData);
     let error = $state();
@@ -59,24 +59,29 @@ export const createAsyncSignal = (handler, options = {}) => {
     const run = async (runId, source) => {
         const initial = !started;
         started = true;
-        if (abortController) {
-            abortController.abort();
+        const prevController = abortController;
+        if (prevController) {
+            prevController.abort();
         }
-        abortController = new AbortController();
+        const localController = new AbortController();
+        abortController = localController;
         if (options.beforeSend) {
             await options.beforeSend({ initial, source });
         }
+        if (runId !== currentRunId || abortController !== localController || localController.signal.aborted) {
+            return undefined;
+        }
         status = 'pending';
         error = undefined;
         try {
-            const result = await handler(abortController.signal);
-            if (abortController.signal.aborted) {
+            const result = await handler(localController.signal);
+            if (runId !== currentRunId || abortController !== localController || localController.signal.aborted) {
                 return undefined;
             }
             data = result;
             status = 'success';
             if (options.onSuccess) {
-                options.onSuccess(result);
+                await options.onSuccess(result);
             }
             return result;
         }
@@ -84,10 +89,13 @@ export const createAsyncSignal = (handler, options = {}) => {
             if (err instanceof Error && err.name === 'AbortError') {
                 return undefined;
             }
+            if (runId !== currentRunId || abortController !== localController || localController.signal.aborted) {
+                return undefined;
+            }
             error = err;
             status = 'error';
             if (options.onError) {
-                options.onError(err);
+                await options.onError(err);
             }
             return undefined;
         }
@@ -98,9 +106,6 @@ export const createAsyncSignal = (handler, options = {}) => {
         }
     };
     const start = (source) => {
-        if (currentPromise) {
-            return currentPromise;
-        }
         const runId = ++currentRunId;
         const localPromise = run(runId, source);
         currentPromise = localPromise;
@@ -113,7 +118,7 @@ export const createAsyncSignal = (handler, options = {}) => {
         }
         await start('manual');
     };
-    if (EnvironmentUtil.isBrowser) {
+    if (BROWSER) {
         const signalKey = key ?? asyncSignalManager.generateKey();
         const callback = (source) => start(source);
         asyncSignalManager.register(signalKey, callback);
@@ -122,28 +127,14 @@ export const createAsyncSignal = (handler, options = {}) => {
                 asyncSignalManager.unregister(signalKey, callback);
             };
         });
-        if (watch.length > 0) {
-            let isFirst = true;
-            $effect(() => {
-                watch.forEach((dep) => dep());
-                if (isFirst && !immediate) {
-                    isFirst = false;
-                    return;
-                }
-                if (!isFirst) {
-                    void start('auto');
-                }
-                isFirst = false;
-            });
-        }
     }
     if (immediate) {
-        if (EnvironmentUtil.isServer && server) {
+        if (!BROWSER && server) {
             untrack(() => {
                 void start('auto');
             });
         }
-        else if (EnvironmentUtil.isBrowser) {
+        else if (BROWSER) {
             void start('auto');
         }
     }

package/dist/core/svelte/Query/Query.svelte.d.ts

@@ -1,20 +1,19 @@
-export type QuerySignal = {
-    refresh: () => Promise<void>;
-};
+export interface QueryOnChangeContext<T extends Record<string, unknown>> {
+    snapshot: T;
+    changedKeys: (keyof T)[];
+    signal: AbortSignal;
+}
+export interface QueryOnChangeOptions<T extends Record<string, unknown>> {
+    include: (keyof T)[];
+    handler: (ctx: QueryOnChangeContext<T>) => Promise<void> | void;
+}
 export interface CreateQueryOptions<T extends Record<string, unknown>> {
-    initial: T;
-    signal?: QuerySignal;
-    excludeKeys?: (keyof T)[];
-    debounceMs?: number;
-    autoRefresh?: boolean;
+    onChange?: QueryOnChangeOptions<T>;
 }
 export interface QueryController<T extends Record<string, unknown>> {
     data: T;
-    patch: (values: Partial<T>) => void;
-    set: <K extends keyof T>(key: K, value: T[K]) => void;
     reset: () => void;
     snapshot: () => T;
     initial: () => T;
-    attachSignal: (signal?: QuerySignal) => void;
 }
-export declare const createQuery: <T extends Record<string, unknown>>(options: CreateQueryOptions<T>) => QueryController<T>;
+export declare const createQuery: <T extends Record<string, unknown>>(initialValue: T, options?: CreateQueryOptions<T>) => QueryController<T>;