@fiodos/web-core 0.1.0

package/LICENSE

@@ -0,0 +1,77 @@
+Fiodos SDK License Agreement
+
+Copyright (c) 2026 Fiodos / Rodrigo Martínez. All rights reserved.
+
+This is a proprietary, commercial software license. It is NOT an open-source
+license. Please read it carefully before installing or using the Software.
+
+1. Definitions.
+   "Software" means the Fiodos SDK packages (including, without limitation, the
+   @fiodos/* npm packages and the fiodos_flutter package) together with any
+   accompanying files, documentation, and updates provided by the Licensor.
+   "Service" means the hosted Fiodos backend, APIs, and related services
+   operated by the Licensor.
+   "Licensor" means Fiodos / Rodrigo Martínez (and, once incorporated, the
+   company that succeeds to these rights).
+   "You" means the individual or legal entity that installs or uses the
+   Software.
+
+2. Grant of License.
+   Subject to Your continued compliance with this Agreement, the Licensor grants
+   You a limited, non-exclusive, non-transferable, non-sublicensable, and
+   revocable license to install and use the Software solely for the purpose of
+   integrating with and accessing the Fiodos Service from within Your own
+   applications.
+
+3. Restrictions.
+   Except as expressly permitted in Section 2, You may NOT, in whole or in part:
+   (a) copy the Software, except for the copying strictly necessary to install
+       and run it for its intended purpose;
+   (b) modify, adapt, translate, or create derivative works of the Software;
+   (c) redistribute, publish, sublicense, sell, rent, lease, lend, or otherwise
+       make the Software available to any third party as a standalone item;
+   (d) reverse engineer, decompile, or disassemble the Software, or attempt to
+       derive its source code, except and only to the extent that this
+       restriction is expressly prohibited by applicable law;
+   (e) remove, obscure, or alter any copyright, trademark, or other proprietary
+       notices contained in the Software; or
+   (f) use the Software, or any portion of it, to develop, train, or assist in
+       developing a product or service that competes with Fiodos.
+
+4. Reservation of Rights.
+   The Software is licensed, not sold. All right, title, and interest in and to
+   the Software, including all related intellectual property rights, are and
+   shall remain the exclusive property of the Licensor. All rights not expressly
+   granted to You under this Agreement are reserved by the Licensor.
+
+5. Termination.
+   This license terminates automatically and immediately if You breach any term
+   of this Agreement. Upon termination, You must cease all use of the Software
+   and delete all copies in Your possession or control. Sections 3, 4, 6, and 7
+   survive termination.
+
+6. Disclaimer of Warranty.
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+7. Limitation of Liability.
+   TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE
+   LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN
+   ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION
+   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+8. Contact.
+   For licensing inquiries, contact Rodrigo Martínez (Fiodos).
+
+--------------------------------------------------------------------------------
+
+Nota (ES) — Licencia propietaria:
+Se permite INSTALAR y USAR el SDK únicamente para integrar y acceder al servicio
+Fiodos desde tus propias aplicaciones. Quedan PROHIBIDOS: copiar el código (salvo
+la copia imprescindible para instalarlo y ejecutarlo), modificarlo, redistribuirlo,
+sublicenciarlo, venderlo, hacer ingeniería inversa o crear obras derivadas o un
+producto que compita con Fiodos. El software se licencia, no se vende; todos los
+derechos no concedidos expresamente quedan reservados al Licenciante. Este texto
+corresponde a la fase de pruebas y será revisado por un abogado al constituir la
+sociedad.

package/dist/cjs/adapters/webNavigationAdapter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Web NavigationAdapter — framework-agnostic. The manifest route strings for a
+ * web app are URL paths (e.g. "/cart"). The host provides a `navigate` delegate
+ * (Vue Router's `router.push`, SvelteKit's `goto`, Angular Router's
+ * `navigateByUrl`, or a plain `location.assign`) and the adapter forwards the
+ * opaque route string. The router owns query-string / param interpretation.
+ *
+ * `setCurrentRoute` lets the host keep `getCurrentRoute()` in sync with the
+ * live pathname (telemetry + LLM context). No framework imports here — each
+ * binding wires its own router-change subscription.
+ */
+import type { NavigationAdapter } from '@fiodos/core';
+export declare const BACK_ROUTE = "BACK";
+export interface WebNavigationAdapterOptions {
+    /**
+     * Forwards a manifest route string to the host router. MUST throw on failure
+     * so the engine can degrade to an ActionResult error.
+     */
+    navigate: (route: string) => void;
+    /** Go back. Defaults to history.back() (or backFallbackRoute when empty). */
+    back?: () => void;
+    /** Current route. Defaults to location.pathname + location.search. */
+    getCurrentRoute?: () => string | null;
+    /** Route navigated to when back() is called with no history. */
+    backFallbackRoute?: string;
+}
+export interface WebNavigationAdapter extends NavigationAdapter {
+    /** Updates the tracked current route (called by the host on route change). */
+    setCurrentRoute(route: string | null): void;
+}
+export declare function createWebNavigationAdapter(options: WebNavigationAdapterOptions): WebNavigationAdapter;

package/dist/cjs/adapters/webNavigationAdapter.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACK_ROUTE = void 0;
+exports.createWebNavigationAdapter = createWebNavigationAdapter;
+exports.BACK_ROUTE = 'BACK';
+function defaultCurrentRoute() {
+    if (typeof window === 'undefined' || !window.location)
+        return null;
+    return `${window.location.pathname}${window.location.search}`;
+}
+function createWebNavigationAdapter(options) {
+    let tracked = null;
+    let hasNavigated = false;
+    return {
+        navigate(route) {
+            if (!route || route === exports.BACK_ROUTE) {
+                this.back();
+                return;
+            }
+            hasNavigated = true;
+            options.navigate(route);
+        },
+        back() {
+            if (options.back) {
+                options.back();
+                return;
+            }
+            if (hasNavigated && typeof window !== 'undefined' && window.history?.length > 1) {
+                window.history.back();
+                return;
+            }
+            if (options.backFallbackRoute) {
+                options.navigate(options.backFallbackRoute);
+            }
+        },
+        getCurrentRoute() {
+            if (tracked != null)
+                return tracked;
+            return options.getCurrentRoute ? options.getCurrentRoute() : defaultCurrentRoute();
+        },
+        setCurrentRoute(route) {
+            tracked = route;
+        },
+    };
+}

package/dist/cjs/adapters/webStorageAdapter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Web StorageAdapter — backs the consent manager (and any future per-app
+ * preferences) with window.localStorage by default. The @fiodos/core contract
+ * is async; localStorage is sync, so we wrap calls in resolved promises. If
+ * localStorage is unavailable (private mode, SSR, disabled) we degrade to an
+ * in-memory map (consent just won't persist across reloads).
+ */
+import type { StorageAdapter } from '@fiodos/core';
+export interface WebStorageAdapterOptions {
+    /** Storage backend. Defaults to window.localStorage. */
+    backend?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+}
+export declare function createWebStorageAdapter(options?: WebStorageAdapterOptions): StorageAdapter;

package/dist/cjs/adapters/webStorageAdapter.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebStorageAdapter = createWebStorageAdapter;
+function resolveBackend(preferred) {
+    if (preferred)
+        return preferred;
+    try {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const probe = '__fyodos_probe__';
+            window.localStorage.setItem(probe, '1');
+            window.localStorage.removeItem(probe);
+            return window.localStorage;
+        }
+    }
+    catch {
+        /* localStorage blocked — fall through to memory */
+    }
+    const mem = new Map();
+    return {
+        getItem: (k) => (mem.has(k) ? mem.get(k) : null),
+        setItem: (k, v) => {
+            mem.set(k, v);
+        },
+        removeItem: (k) => {
+            mem.delete(k);
+        },
+    };
+}
+function createWebStorageAdapter(options = {}) {
+    const backend = resolveBackend(options.backend);
+    return {
+        async getItem(key) {
+            try {
+                return backend.getItem(key);
+            }
+            catch {
+                return null;
+            }
+        },
+        async setItem(key, value) {
+            try {
+                backend.setItem(key, value);
+            }
+            catch {
+                /* quota/availability errors are non-fatal for consent */
+            }
+        },
+        async removeItem(key) {
+            try {
+                backend.removeItem(key);
+            }
+            catch {
+                /* non-fatal */
+            }
+        },
+    };
+}

package/dist/cjs/adapters/webVoiceAdapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Web VoiceAdapter — browser STT via the Web Speech API
+ * (`SpeechRecognition` / `webkitSpeechRecognition`) and TTS playback of
+ * server-generated MP3 (base64) through an <audio> element, with a device
+ * SpeechSynthesis fallback. Availability is browser-dependent (Chrome/Edge/
+ * Safari yes; Firefox no), so `isRecognitionAvailable()` is honest and the UI
+ * must fall back to text input when it returns false.
+ *
+ * Framework-agnostic: shared by every Fiodos web binding.
+ */
+import type { VoiceAdapter } from '@fiodos/core';
+export interface WebVoiceAdapterOptions {
+    /** Disable the SpeechSynthesis fallback when server MP3 is missing. */
+    disableDeviceTtsFallback?: boolean;
+}
+export declare function createWebVoiceAdapter(options?: WebVoiceAdapterOptions): VoiceAdapter;