fragment-ts 2.0.2 → 2.0.4

package/dist/web/src/router/fragment-router.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterInternals = void 0;
+exports.FragmentRouter = FragmentRouter;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_router_dom_1 = require("react-router-dom");
+const page_1 = require("../core/decorators/page");
+const fragment_fetch_1 = require("../http/fragment-fetch");
+const runtime_1 = require("../core/runtime");
+function prefixMatch(route, pathname) {
+    if (route === "/")
+        return pathname === "/";
+    return pathname === route || pathname.startsWith(`${route}/`);
+}
+async function resolveSession(config) {
+    if (config.fetch.tokenTransport === "cookie") {
+        try {
+            await fragment_fetch_1.FragmentFetch.get("/auth/me", { skipAuth: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    return Boolean(fragment_fetch_1.FragmentFetch.getToken());
+}
+function routeNeedsAuth(path, config) {
+    return config.authenticatedRoutes.some((route) => prefixMatch(route, path));
+}
+function routeIsPublic(path, config) {
+    return config.publicRoutes.some((route) => prefixMatch(route, path));
+}
+function extractRedirectPath(mode, fallback = "/login") {
+    if (!mode)
+        return fallback;
+    if (mode.startsWith("redirect:"))
+        return mode.slice("redirect:".length);
+    return fallback;
+}
+function PageRoute({ page, config }) {
+    const [checking, setChecking] = (0, react_1.useState)(true);
+    const [authenticated, setAuthenticated] = (0, react_1.useState)(false);
+    const [guardAllowed, setGuardAllowed] = (0, react_1.useState)(true);
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        (async () => {
+            const isAuthed = await resolveSession(config);
+            if (cancelled)
+                return;
+            setAuthenticated(isAuthed);
+            if (page.guard) {
+                const guard = new page.guard();
+                if (typeof guard.canActivate === "function") {
+                    const result = await Promise.resolve(guard.canActivate());
+                    if (!cancelled) {
+                        setGuardAllowed(result !== false);
+                    }
+                }
+            }
+            if (!cancelled) {
+                setChecking(false);
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [config]);
+    if (checking) {
+        return (0, jsx_runtime_1.jsx)("div", { children: "Loading..." });
+    }
+    const needsAuth = routeNeedsAuth(page.path, config);
+    const isPublic = routeIsPublic(page.path, config) || !needsAuth;
+    if (needsAuth && !authenticated) {
+        return (0, jsx_runtime_1.jsx)(react_router_dom_1.Navigate, { to: extractRedirectPath(config.fetch.onUnauthorized, "/login"), replace: true });
+    }
+    if (isPublic && page.redirectIfAuthenticated && authenticated) {
+        return (0, jsx_runtime_1.jsx)(react_router_dom_1.Navigate, { to: page.redirectIfAuthenticated, replace: true });
+    }
+    if (!guardAllowed) {
+        return (0, jsx_runtime_1.jsx)(react_router_dom_1.Navigate, { to: extractRedirectPath(config.fetch.onForbidden, "/403"), replace: true });
+    }
+    return (0, runtime_1.renderPageInstance)(page.target);
+}
+function FragmentRouter({ config }) {
+    const pages = (0, react_1.useMemo)(() => (0, page_1.getPages)(), []);
+    return ((0, jsx_runtime_1.jsx)(react_router_dom_1.BrowserRouter, { basename: config.webRoot, children: (0, jsx_runtime_1.jsx)(react_router_dom_1.Routes, { children: pages.map((page) => ((0, jsx_runtime_1.jsx)(react_router_dom_1.Route, { path: page.path, element: (0, jsx_runtime_1.jsx)(PageRoute, { page: page, config: config }) }, page.path))) }) }));
+}
+exports.RouterInternals = {
+    prefixMatch,
+    routeNeedsAuth,
+    routeIsPublic,
+};
+//# sourceMappingURL=fragment-router.js.map

package/dist/web/src/router/fragment-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-router.js","sourceRoot":"","sources":["../../../../src/web/src/router/fragment-router.tsx"],"names":[],"mappings":"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"}

package/dist/web/web/src/index.d.mts

@@ -0,0 +1,137 @@
+interface FragmentFetchConfig {
+    baseUrl: string;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+    headers?: Record<string, string>;
+    tokenTransport?: "cookie" | "localStorage" | "memory";
+    tokenKey?: string;
+    onUnauthorized?: "throw" | `redirect:${string}` | "silent";
+    onForbidden?: "throw" | `redirect:${string}` | "silent";
+    onError?: (err: FragmentHttpError) => void;
+}
+interface RequestOptions {
+    headers?: Record<string, string>;
+    params?: Record<string, string | number | boolean | Array<string | number | boolean>>;
+    timeout?: number;
+    retries?: number;
+    skipAuth?: boolean;
+    signal?: AbortSignal;
+}
+declare class FragmentHttpError extends Error {
+    status: number;
+    statusText: string;
+    body: unknown;
+    request: Request;
+    response: Response;
+    constructor(message: string, init: {
+        status: number;
+        statusText: string;
+        body: unknown;
+        request: Request;
+        response: Response;
+    });
+}
+type RequestInterceptor = (request: Request) => Promise<Request> | Request;
+type ResponseInterceptor = (response: Response, context: {
+    request: Request;
+    error?: FragmentHttpError;
+}) => Promise<Response> | Response;
+declare const FragmentFetch: {
+    configure(config: FragmentFetchConfig): void;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    request<T>(path: string, init?: RequestInit, options?: RequestOptions): Promise<T>;
+    setToken(token: string): void;
+    clearToken(): void;
+    getToken(): string | null;
+    addRequestInterceptor(fn: RequestInterceptor): () => void;
+    addResponseInterceptor(fn: ResponseInterceptor): () => void;
+};
+
+declare function FragmentWebApplication(options: {
+    rootElement: string;
+    strict?: boolean;
+}): ClassDecorator;
+declare class FragmentWebUIApplication {
+    bootstrap(applicationClass: new () => unknown): Promise<void>;
+}
+
+declare function Component(options?: {
+    tag?: string;
+    memo?: boolean;
+    displayName?: string;
+}): ClassDecorator;
+declare function State(initial: unknown): PropertyDecorator;
+declare function Computed(deps?: string[]): MethodDecorator;
+declare function Effect(options: {
+    on: "mount" | "update" | "unmount";
+    deps?: string[];
+}): MethodDecorator;
+declare function Watch(key: string): MethodDecorator;
+declare function Store(store: unknown, selector?: (state: any) => unknown): PropertyDecorator;
+declare function Prop(defaultValue?: unknown): PropertyDecorator;
+declare function Ref(): PropertyDecorator;
+declare function Inject(token: unknown): PropertyDecorator;
+declare function FragmentService(): ClassDecorator;
+declare function Injectable(_scope?: "singleton" | "transient"): ClassDecorator;
+
+declare function Page(options: {
+    path: string;
+    title?: string;
+    layout?: string;
+}): ClassDecorator;
+declare function Layout(options: {
+    name: string;
+}): ClassDecorator;
+declare function Guard(guardClass: new (...args: any[]) => {
+    canActivate?: () => boolean | Promise<boolean>;
+}): ClassDecorator;
+declare function Param(_name: string): PropertyDecorator;
+declare function Query(_name: string, _defaultValue?: string): PropertyDecorator;
+declare function RedirectIfAuthenticated(to?: string): ClassDecorator;
+
+type Token<T = unknown> = string | symbol | (new (...args: any[]) => T);
+declare class DIContainer {
+    private static providers;
+    static register<T>(token: Token<T>, value: T): void;
+    static resolve<T>(token: Token<T>): T;
+    static clear(): void;
+}
+
+type StructureMode = "layered" | "module" | "feature" | "mvvm";
+type StoreAdapter = "zustand" | "jotai" | "redux" | "mobx";
+interface FragmentWebConfig {
+    webRoot: string;
+    serverRoot: string;
+    publicRoutes: string[];
+    authenticatedRoutes: string[];
+    app: {
+        name: string;
+        rootElement: string;
+        strict: boolean;
+        router: "react-router";
+        stateAdapter: StoreAdapter;
+    };
+    fetch: {
+        baseUrl: string;
+        timeout?: number;
+        retries?: number;
+        retryDelay?: number;
+        headers?: Record<string, string>;
+        tokenTransport?: "cookie" | "localStorage" | "memory";
+        tokenKey?: string;
+        onUnauthorized?: "throw" | `redirect:${string}` | "silent";
+        onForbidden?: "throw" | `redirect:${string}` | "silent";
+    };
+    structure: StructureMode;
+    di: {
+        autoScan: boolean;
+        scanPaths: string[];
+    };
+}
+
+export { Component, Computed, DIContainer, Effect, FragmentFetch, FragmentHttpError, FragmentService, FragmentWebApplication, type FragmentWebConfig, FragmentWebUIApplication, Guard, Inject, Injectable, Layout, Page, Param, Prop, Query, RedirectIfAuthenticated, Ref, State, Store, Watch };

package/dist/web/web/src/index.d.ts

@@ -0,0 +1,137 @@
+interface FragmentFetchConfig {
+    baseUrl: string;
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+    headers?: Record<string, string>;
+    tokenTransport?: "cookie" | "localStorage" | "memory";
+    tokenKey?: string;
+    onUnauthorized?: "throw" | `redirect:${string}` | "silent";
+    onForbidden?: "throw" | `redirect:${string}` | "silent";
+    onError?: (err: FragmentHttpError) => void;
+}
+interface RequestOptions {
+    headers?: Record<string, string>;
+    params?: Record<string, string | number | boolean | Array<string | number | boolean>>;
+    timeout?: number;
+    retries?: number;
+    skipAuth?: boolean;
+    signal?: AbortSignal;
+}
+declare class FragmentHttpError extends Error {
+    status: number;
+    statusText: string;
+    body: unknown;
+    request: Request;
+    response: Response;
+    constructor(message: string, init: {
+        status: number;
+        statusText: string;
+        body: unknown;
+        request: Request;
+        response: Response;
+    });
+}
+type RequestInterceptor = (request: Request) => Promise<Request> | Request;
+type ResponseInterceptor = (response: Response, context: {
+    request: Request;
+    error?: FragmentHttpError;
+}) => Promise<Response> | Response;
+declare const FragmentFetch: {
+    configure(config: FragmentFetchConfig): void;
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    request<T>(path: string, init?: RequestInit, options?: RequestOptions): Promise<T>;
+    setToken(token: string): void;
+    clearToken(): void;
+    getToken(): string | null;
+    addRequestInterceptor(fn: RequestInterceptor): () => void;
+    addResponseInterceptor(fn: ResponseInterceptor): () => void;
+};
+
+declare function FragmentWebApplication(options: {
+    rootElement: string;
+    strict?: boolean;
+}): ClassDecorator;
+declare class FragmentWebUIApplication {
+    bootstrap(applicationClass: new () => unknown): Promise<void>;
+}
+
+declare function Component(options?: {
+    tag?: string;
+    memo?: boolean;
+    displayName?: string;
+}): ClassDecorator;
+declare function State(initial: unknown): PropertyDecorator;
+declare function Computed(deps?: string[]): MethodDecorator;
+declare function Effect(options: {
+    on: "mount" | "update" | "unmount";
+    deps?: string[];
+}): MethodDecorator;
+declare function Watch(key: string): MethodDecorator;
+declare function Store(store: unknown, selector?: (state: any) => unknown): PropertyDecorator;
+declare function Prop(defaultValue?: unknown): PropertyDecorator;
+declare function Ref(): PropertyDecorator;
+declare function Inject(token: unknown): PropertyDecorator;
+declare function FragmentService(): ClassDecorator;
+declare function Injectable(_scope?: "singleton" | "transient"): ClassDecorator;
+
+declare function Page(options: {
+    path: string;
+    title?: string;
+    layout?: string;
+}): ClassDecorator;
+declare function Layout(options: {
+    name: string;
+}): ClassDecorator;
+declare function Guard(guardClass: new (...args: any[]) => {
+    canActivate?: () => boolean | Promise<boolean>;
+}): ClassDecorator;
+declare function Param(_name: string): PropertyDecorator;
+declare function Query(_name: string, _defaultValue?: string): PropertyDecorator;
+declare function RedirectIfAuthenticated(to?: string): ClassDecorator;
+
+type Token<T = unknown> = string | symbol | (new (...args: any[]) => T);
+declare class DIContainer {
+    private static providers;
+    static register<T>(token: Token<T>, value: T): void;
+    static resolve<T>(token: Token<T>): T;
+    static clear(): void;
+}
+
+type StructureMode = "layered" | "module" | "feature" | "mvvm";
+type StoreAdapter = "zustand" | "jotai" | "redux" | "mobx";
+interface FragmentWebConfig {
+    webRoot: string;
+    serverRoot: string;
+    publicRoutes: string[];
+    authenticatedRoutes: string[];
+    app: {
+        name: string;
+        rootElement: string;
+        strict: boolean;
+        router: "react-router";
+        stateAdapter: StoreAdapter;
+    };
+    fetch: {
+        baseUrl: string;
+        timeout?: number;
+        retries?: number;
+        retryDelay?: number;
+        headers?: Record<string, string>;
+        tokenTransport?: "cookie" | "localStorage" | "memory";
+        tokenKey?: string;
+        onUnauthorized?: "throw" | `redirect:${string}` | "silent";
+        onForbidden?: "throw" | `redirect:${string}` | "silent";
+    };
+    structure: StructureMode;
+    di: {
+        autoScan: boolean;
+        scanPaths: string[];
+    };
+}
+
+export { Component, Computed, DIContainer, Effect, FragmentFetch, FragmentHttpError, FragmentService, FragmentWebApplication, type FragmentWebConfig, FragmentWebUIApplication, Guard, Inject, Injectable, Layout, Page, Param, Prop, Query, RedirectIfAuthenticated, Ref, State, Store, Watch };