@fluxfast/core 0.0.0-oidc-bootstrap.0

package/dist/prefetch.js

@@ -0,0 +1,78 @@
+"use strict";
+/** In-flight request deduplication and version-safe prefetch caching. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrefetchManager = void 0;
+function fingerprint(url, knownVersions) {
+    const versions = Object.entries(knownVersions).sort(([a], [b]) => a.localeCompare(b));
+    return JSON.stringify([url, versions]);
+}
+function versionsStillAvailable(basedOn, current, envelope) {
+    return Object.entries(basedOn).every(([key, version]) => {
+        const expected = envelope.resources[key]?.version ?? version;
+        return current[key] === expected;
+    });
+}
+class PrefetchManager {
+    defaultTtlMs;
+    inFlight = new Map();
+    cache = new Map();
+    generation = 0;
+    constructor(defaultTtlMs = 10_000) {
+        this.defaultTtlMs = defaultTtlMs;
+    }
+    async fetch(url, transport, knownVersions, ttlMs = this.defaultTtlMs) {
+        const cached = this.getCached(url, knownVersions);
+        if (cached)
+            return cached;
+        const requestFingerprint = fingerprint(url, knownVersions);
+        const pending = this.inFlight.get(requestFingerprint);
+        if (pending)
+            return pending;
+        const generation = this.generation;
+        const promise = transport
+            .visit({
+            url,
+            visitId: `prefetch_${Date.now().toString(36)}`,
+            knownVersions,
+        })
+            .then(envelope => {
+            if (generation !== this.generation) {
+                const cancellation = new Error("Prefetch was cleared");
+                cancellation.name = "AbortError";
+                throw cancellation;
+            }
+            this.cache.set(url, {
+                envelope,
+                expiresAt: Date.now() + ttlMs,
+                basedOnVersions: { ...knownVersions },
+            });
+            return envelope;
+        })
+            .finally(() => {
+            this.inFlight.delete(requestFingerprint);
+        });
+        this.inFlight.set(requestFingerprint, promise);
+        return promise;
+    }
+    getPending(url, knownVersions) {
+        return this.inFlight.get(fingerprint(url, knownVersions));
+    }
+    getCached(url, currentVersions) {
+        const entry = this.cache.get(url);
+        if (!entry)
+            return undefined;
+        if (Date.now() >= entry.expiresAt ||
+            !versionsStillAvailable(entry.basedOnVersions, currentVersions, entry.envelope)) {
+            this.cache.delete(url);
+            return undefined;
+        }
+        return entry.envelope;
+    }
+    clear() {
+        this.generation += 1;
+        this.inFlight.clear();
+        this.cache.clear();
+    }
+}
+exports.PrefetchManager = PrefetchManager;
+//# sourceMappingURL=prefetch.js.map

package/dist/prefetch.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Canonical TypeScript definitions for FluxFast wire protocol (fluxfast/1).
+ * Framework-neutral, zero external runtime dependencies.
+ */
+export type ProtocolVersion = "fluxfast/1";
+export declare const PROTOCOL_VERSION: ProtocolVersion;
+export declare const PROTOCOL_MEDIA_TYPE = "application/vnd.fluxfast+json";
+export interface ResourceWireRecord<T = unknown> {
+    version: string;
+    value: T;
+}
+export interface PageDescriptor {
+    component: string;
+    url: string;
+    meta?: Record<string, unknown>;
+}
+export interface PageEnvelope {
+    protocol: ProtocolVersion;
+    page: PageDescriptor;
+    resources: Record<string, ResourceWireRecord>;
+    appVersion?: string;
+}
+export type PatchOp = "replace-resource" | "merge-object" | "replace-item" | "remove-item" | "append-item";
+export interface ResourcePatch {
+    op: PatchOp;
+    id?: string | number;
+    match?: Record<string, unknown>;
+    value?: unknown;
+}
+export interface MutationPayload {
+    patches?: Record<string, ResourcePatch[]>;
+    invalidate?: string[];
+    redirect?: string;
+    externalRedirect?: string;
+}
+export interface MutationEnvelope {
+    protocol: ProtocolVersion;
+    mutation: MutationPayload;
+}
+export interface ErrorDetail {
+    type: string;
+    message: string;
+    details?: unknown;
+}
+export interface ErrorEnvelope {
+    protocol: ProtocolVersion;
+    error: ErrorDetail;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAE3C,eAAO,MAAM,gBAAgB,EAAE,eAA8B,CAAC;AAC9D,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AAEnE,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GACf,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/protocol.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Canonical TypeScript definitions for FluxFast wire protocol (fluxfast/1).
+ * Framework-neutral, zero external runtime dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOL_MEDIA_TYPE = exports.PROTOCOL_VERSION = void 0;
+exports.PROTOCOL_VERSION = "fluxfast/1";
+exports.PROTOCOL_MEDIA_TYPE = "application/vnd.fluxfast+json";
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIU,QAAA,gBAAgB,GAAoB,YAAY,CAAC;AACjD,QAAA,mBAAmB,GAAG,+BAA+B,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,67 @@
+/** Core navigation engine and coordinator. It has no UI-framework imports. */
+import { PageCache } from "./cache";
+import { EventEmitter, FluxEventListener, FluxEventName } from "./events";
+import { HistoryManager } from "./history";
+import { MutationEnvelope, PageDescriptor, PageEnvelope } from "./protocol";
+import { PrefetchManager } from "./prefetch";
+import { PageStore, ResourceStore } from "./store";
+import { FluxTransport } from "./transport";
+export interface VisitOptions {
+    replace?: boolean;
+    preserveScroll?: boolean;
+    preserveState?: boolean;
+    usePrefetch?: boolean;
+    headers?: Record<string, string>;
+    only?: string[];
+}
+export interface RefreshOptions {
+    only?: string[];
+}
+export interface MutateOptions {
+    method?: string;
+    headers?: Record<string, string>;
+    preserveScroll?: boolean;
+}
+export interface FluxRuntimeOptions {
+    resourceStore?: ResourceStore;
+    pageStore?: PageStore;
+    transport?: FluxTransport;
+    history?: HistoryManager;
+    prefetchManager?: PrefetchManager;
+    pageCache?: PageCache;
+    initialPage?: PageDescriptor;
+    initialResources?: PageEnvelope["resources"];
+    maxResources?: number;
+    maxPages?: number;
+    hardNavigate?: (url: string) => void;
+    deferHistory?: boolean;
+}
+export declare class FluxRouter {
+    readonly resourceStore: ResourceStore;
+    readonly pageStore: PageStore;
+    readonly transport: FluxTransport;
+    readonly events: EventEmitter;
+    readonly history: HistoryManager;
+    readonly prefetchManager: PrefetchManager;
+    readonly pageCache: PageCache;
+    private currentVisitId;
+    private activeController;
+    private visitCounter;
+    private readonly hardNavigate;
+    private stopHistoryListener?;
+    constructor(options?: FluxRuntimeOptions);
+    startHistory(): void;
+    stopHistory(): void;
+    on<E extends FluxEventName>(event: E, listener: FluxEventListener<E>): () => void;
+    visit(url: string, options?: VisitOptions): Promise<void>;
+    refresh(options?: RefreshOptions): Promise<void>;
+    prefetch(url: string): Promise<PageEnvelope>;
+    mutate(url: string, data?: unknown, options?: MutateOptions): Promise<MutationEnvelope>;
+    clear(): void;
+    destroy(): void;
+    private applyPageEnvelope;
+    private emitResourceUpdates;
+    private abortActiveVisit;
+}
+export declare function createFluxRuntime(options?: FluxRuntimeOptions): FluxRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

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

package/dist/router.js

@@ -0,0 +1,242 @@
+"use strict";
+/** Core navigation engine and coordinator. It has no UI-framework imports. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FluxRouter = void 0;
+exports.createFluxRuntime = createFluxRuntime;
+const cache_1 = require("./cache");
+const events_1 = require("./events");
+const history_1 = require("./history");
+const prefetch_1 = require("./prefetch");
+const store_1 = require("./store");
+const transport_1 = require("./transport");
+class FluxRouter {
+    resourceStore;
+    pageStore;
+    transport;
+    events;
+    history;
+    prefetchManager;
+    pageCache;
+    currentVisitId = null;
+    activeController = null;
+    visitCounter = 0;
+    hardNavigate;
+    stopHistoryListener;
+    constructor(options = {}) {
+        this.resourceStore =
+            options.resourceStore ??
+                new store_1.ResourceStore({ maxResources: options.maxResources });
+        this.pageStore = options.pageStore ?? new store_1.PageStore(options.initialPage);
+        this.transport = options.transport ?? (0, transport_1.createFetchTransport)();
+        this.events = new events_1.EventEmitter();
+        this.history = options.history ?? new history_1.HistoryManager();
+        this.prefetchManager = options.prefetchManager ?? new prefetch_1.PrefetchManager();
+        this.pageCache = options.pageCache ?? new cache_1.PageCache(options.maxPages);
+        this.hardNavigate =
+            options.hardNavigate ??
+                (url => {
+                    if (typeof window !== "undefined")
+                        window.location.assign(url);
+                });
+        if (options.initialResources) {
+            this.emitResourceUpdates(this.resourceStore.setMany(options.initialResources));
+        }
+        if (options.initialPage) {
+            this.pageCache.set(options.initialPage, this.resourceStore.exportKnownVersions());
+        }
+        if (!options.deferHistory)
+            this.startHistory();
+    }
+    startHistory() {
+        if (this.stopHistoryListener)
+            return;
+        this.stopHistoryListener = this.history.onPopState(url => {
+            const cached = this.pageCache.getValid(url, this.resourceStore);
+            if (cached) {
+                this.abortActiveVisit();
+                this.pageStore.setPage(cached);
+                this.events.emit("cache:hit", { key: url });
+                return;
+            }
+            this.events.emit("cache:miss", { key: url });
+            void this.visit(url, {
+                preserveState: true,
+                replace: true,
+                usePrefetch: false,
+            }).catch(error => {
+                console.error("[fluxfast] Popstate navigation error:", error);
+            });
+        });
+    }
+    stopHistory() {
+        this.stopHistoryListener?.();
+        this.stopHistoryListener = undefined;
+    }
+    on(event, listener) {
+        return this.events.on(event, listener);
+    }
+    async visit(url, options = {}) {
+        const visitId = `visit_${++this.visitCounter}_${Date.now().toString(36)}`;
+        this.abortActiveVisit();
+        this.currentVisitId = visitId;
+        const controller = new AbortController();
+        this.activeController = controller;
+        this.events.emit("visit:start", { visitId, url });
+        try {
+            const knownVersions = this.resourceStore.exportKnownVersions();
+            let envelope;
+            if (options.usePrefetch !== false && !options.only?.length) {
+                envelope = this.prefetchManager.getCached(url, knownVersions);
+                if (envelope)
+                    this.events.emit("cache:hit", { key: url });
+            }
+            if (!envelope && options.usePrefetch !== false && !options.only?.length) {
+                envelope = await this.prefetchManager.getPending(url, knownVersions);
+            }
+            if (!envelope) {
+                this.events.emit("cache:miss", { key: url });
+                envelope = await this.transport.visit({
+                    url,
+                    visitId,
+                    knownVersions,
+                    only: options.only,
+                    signal: controller.signal,
+                    headers: options.headers,
+                });
+            }
+            if (this.currentVisitId !== visitId) {
+                this.events.emit("visit:cancel", { visitId, url });
+                return;
+            }
+            this.applyPageEnvelope(envelope);
+            if (!options.preserveState) {
+                if (options.replace)
+                    this.history.replace(envelope.page.url || url);
+                else
+                    this.history.push(envelope.page.url || url);
+            }
+            if (!options.preserveScroll && typeof window !== "undefined") {
+                window.scrollTo({ top: 0, left: 0 });
+            }
+            this.events.emit("visit:success", {
+                visitId,
+                url: envelope.page.url || url,
+                component: envelope.page.component,
+            });
+        }
+        catch (error) {
+            if ((error instanceof Error && error.name === "AbortError") ||
+                controller.signal.aborted) {
+                this.events.emit("visit:cancel", { visitId, url });
+                return;
+            }
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            this.events.emit("visit:error", { visitId, url, error: normalized });
+            throw error;
+        }
+        finally {
+            if (this.activeController === controller)
+                this.activeController = null;
+        }
+    }
+    async refresh(options = {}) {
+        const currentUrl = this.pageStore.getSnapshot().url || "/";
+        await this.visit(currentUrl, {
+            preserveState: true,
+            preserveScroll: true,
+            usePrefetch: false,
+            only: options.only,
+        });
+    }
+    async prefetch(url) {
+        this.events.emit("prefetch:start", { url });
+        const knownVersions = this.resourceStore.exportKnownVersions();
+        const envelope = await this.prefetchManager.fetch(url, this.transport, knownVersions);
+        this.emitResourceUpdates(this.resourceStore.setMany(envelope.resources));
+        this.pageCache.set(envelope.page, this.resourceStore.exportKnownVersions());
+        this.events.emit("prefetch:success", { url });
+        return envelope;
+    }
+    async mutate(url, data, options = {}) {
+        this.events.emit("mutation:start", { url });
+        try {
+            const envelope = await this.transport.mutate({
+                url,
+                data,
+                method: options.method ?? "POST",
+                headers: options.headers,
+            });
+            for (const [key, patches] of Object.entries(envelope.mutation.patches ?? {})) {
+                if (this.resourceStore.patch(key, patches)) {
+                    const version = this.resourceStore.getRecord(key)?.version ?? "";
+                    this.events.emit("resource:update", { key, version });
+                }
+            }
+            const activeInvalidations = [];
+            for (const key of envelope.mutation.invalidate ?? []) {
+                if (this.resourceStore.hasSubscribers(key)) {
+                    this.resourceStore.markStale(key);
+                    activeInvalidations.push(key);
+                }
+                else {
+                    this.resourceStore.invalidate(key);
+                }
+                this.events.emit("resource:invalidate", { key });
+            }
+            if (envelope.mutation.externalRedirect) {
+                this.hardNavigate(envelope.mutation.externalRedirect);
+            }
+            else if (envelope.mutation.redirect) {
+                await this.visit(envelope.mutation.redirect, {
+                    preserveScroll: options.preserveScroll,
+                });
+            }
+            else if (activeInvalidations.length > 0) {
+                await this.refresh({ only: activeInvalidations });
+            }
+            this.events.emit("mutation:success", { url });
+            return envelope;
+        }
+        catch (error) {
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            this.events.emit("mutation:error", { url, error: normalized });
+            throw error;
+        }
+    }
+    clear() {
+        this.abortActiveVisit();
+        this.resourceStore.clear();
+        this.pageStore.clear();
+        this.pageCache.clear();
+        this.prefetchManager.clear();
+    }
+    destroy() {
+        this.abortActiveVisit();
+        this.stopHistory();
+        this.history.destroy();
+        this.events.removeAllListeners();
+    }
+    applyPageEnvelope(envelope) {
+        this.emitResourceUpdates(this.resourceStore.setMany(envelope.resources));
+        this.pageStore.setPage(envelope.page);
+        this.pageCache.set(envelope.page, this.resourceStore.exportKnownVersions());
+    }
+    emitResourceUpdates(keys) {
+        for (const key of keys) {
+            const version = this.resourceStore.getRecord(key)?.version ?? "";
+            this.events.emit("resource:update", { key, version });
+        }
+    }
+    abortActiveVisit() {
+        if (this.activeController) {
+            this.activeController.abort();
+            this.activeController = null;
+        }
+        this.currentVisitId = null;
+    }
+}
+exports.FluxRouter = FluxRouter;
+function createFluxRuntime(options = {}) {
+    return new FluxRouter(options);
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Reactive ResourceStore with key-level subscriptions and stable snapshots.
+ * Framework-neutral, suitable for React useSyncExternalStore or other UI bindings.
+ */
+import { PageDescriptor, ResourcePatch, ResourceWireRecord } from "./protocol";
+export interface ResourceRecord<T = unknown> {
+    readonly key: string;
+    readonly version: string;
+    readonly value: T;
+    readonly updatedAt: number;
+}
+export interface PageState {
+    component: string;
+    url: string;
+    meta: Record<string, unknown>;
+}
+export declare class ResourceStore {
+    private records;
+    private subscribers;
+    private globalSubscribers;
+    private lruOrder;
+    private staleKeys;
+    private readonly maxResources;
+    constructor(options?: {
+        maxResources?: number;
+    });
+    /**
+     * Subscribe to changes for a specific resource key.
+     */
+    subscribe(key: string, callback: () => void): () => void;
+    /**
+     * Subscribe to all store changes.
+     */
+    subscribeAll(callback: () => void): () => void;
+    /**
+     * Return stable snapshot of a resource value for useSyncExternalStore.
+     */
+    getSnapshot<T = unknown>(key: string): T | undefined;
+    /**
+     * Return snapshot for server-side rendering.
+     */
+    getServerSnapshot<T = unknown>(key: string): T | undefined;
+    /**
+     * Return full record metadata.
+     */
+    getRecord<T = unknown>(key: string): ResourceRecord<T> | undefined;
+    /**
+     * Insert or update a resource record. Only updates and notifies if version or value changed.
+     */
+    set<T = unknown>(record: {
+        key: string;
+        version: string;
+        value: T;
+    }): boolean;
+    /**
+     * Set multiple wire records from a protocol response.
+     */
+    setMany(resources: Record<string, ResourceWireRecord>): string[];
+    /**
+     * Apply mutation patches to a specific resource.
+     */
+    patch(key: string, patches: ResourcePatch[]): boolean;
+    /**
+     * Invalidate a resource key.
+     */
+    invalidate(key: string): void;
+    /** Keep the last value visible while excluding its version from revalidation. */
+    markStale(key: string): void;
+    isStale(key: string): boolean;
+    hasSubscribers(key: string): boolean;
+    /**
+     * Export map of known versions for X-FluxFast-Known header.
+     */
+    exportKnownVersions(limit?: number): Record<string, string>;
+    /**
+     * Clear all records (e.g. upon user logout).
+     */
+    clear(): void;
+    private notify;
+    private touchLru;
+    private removeFromLru;
+    private evictIfNeeded;
+}
+export declare class PageStore {
+    private state;
+    private subscribers;
+    constructor(initialPage?: PageDescriptor);
+    subscribe(callback: () => void): () => void;
+    getSnapshot(): PageState;
+    setPage(page: PageDescriptor): void;
+    clear(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}