@spooky-sync/client-solid 0.0.1-canary.9 → 0.0.1-canary.90

package/dist/index.js

@@ -1,12 +1,13 @@
-import { SpookyClient, fileToUint8Array } from "@spooky-sync/core";
+import { Sp00kyClient, fileToUint8Array } from "@spooky-sync/core";
 import { RecordId, Uuid } from "surrealdb";
 import { createComponent, createContext, createEffect, createMemo, createSignal, mergeProps, onCleanup, onMount, useContext } from "solid-js";
+import { createStore, reconcile } from "solid-js/store";
 
 //#region src/lib/context.ts
-const SpookyContext = createContext();
+const Sp00kyContext = createContext();
 function useDb() {
-	const db = useContext(SpookyContext);
-	if (!db) throw new Error("useDb must be used within a <SpookyProvider>. Wrap your app in <SpookyProvider config={...}>.");
+	const db = useContext(Sp00kyContext);
+	if (!db) throw new Error("useDb must be used within a <Sp00kyProvider>. Wrap your app in <Sp00kyProvider config={...}>.");
 	return db;
 }
 
@@ -21,30 +22,56 @@ function useQuery(dbOrQuery, queryOrOptions, maybeOptions) {
 		finalQuery = queryOrOptions;
 		options = maybeOptions;
 	} else {
-		const contextDb = useContext(SpookyContext);
-		if (!contextDb) throw new Error("useQuery: No db argument provided and no SpookyContext found. Either pass a SyncedDb instance or wrap your app in <SpookyProvider>.");
+		const contextDb = useContext(Sp00kyContext);
+		if (!contextDb) throw new Error("useQuery: No db argument provided and no Sp00kyContext found. Either pass a SyncedDb instance or wrap your app in <Sp00kyProvider>.");
 		db = contextDb;
 		finalQuery = dbOrQuery;
 		options = queryOrOptions;
 	}
-	const [data, setData] = createSignal(void 0);
 	const [error, setError] = createSignal(void 0);
 	const [isFetched, setIsFetched] = createSignal(false);
-	const [unsubscribe, setUnsubscribe] = createSignal(void 0);
+	const [isFetching, setIsFetching] = createSignal(false);
+	const [state, setState] = createStore({ value: void 0 });
+	const [version, setVersion] = createSignal(0);
+	const data = () => {
+		version();
+		return state.value;
+	};
 	let prevQueryString;
-	const spooky = db.getSpooky();
-	const initQuery = async (query) => {
+	let runId = 0;
+	let activeUnsub;
+	let activeHash;
+	const teardownActive = () => {
+		activeUnsub?.();
+		activeUnsub = void 0;
+	};
+	const sp00ky = db.getSp00ky();
+	const initQuery = async (query, myRun) => {
 		const { hash } = await query.run();
+		if (myRun !== runId) return;
+		activeHash = hash;
 		setError(void 0);
 		let isFirstCall = true;
-		const unsub = await spooky.subscribe(hash, (e) => {
-			const data = query.isOne ? e[0] : e;
-			setData(() => data);
-			const hasData = query.isOne ? data != null : e.length > 0;
+		const unsub = await sp00ky.subscribe(hash, (e) => {
+			const queryData = query.isOne ? e[0] : e;
+			const reconcileStart = performance.now();
+			setState("value", reconcile(queryData, { key: "id" }));
+			setVersion((v) => v + 1);
+			sp00ky.reportFrontendTiming(hash, performance.now() - reconcileStart);
+			const hasData = query.isOne ? queryData !== null && queryData !== void 0 : e.length > 0;
 			if (!isFirstCall || hasData) setIsFetched(true);
 			isFirstCall = false;
 		}, { immediate: true });
-		setUnsubscribe(() => unsub);
+		const unsubStatus = sp00ky.subscribeQueryStatus(hash, (status) => setIsFetching(status === "fetching"), { immediate: true });
+		const teardown = () => {
+			unsub();
+			unsubStatus();
+		};
+		if (myRun !== runId) {
+			teardown();
+			return;
+		}
+		activeUnsub = teardown;
 	};
 	createEffect(() => {
 		if (!(options?.enabled?.() ?? true)) {
@@ -53,14 +80,18 @@ function useQuery(dbOrQuery, queryOrOptions, maybeOptions) {
 		}
 		const query = typeof finalQuery === "function" ? finalQuery() : finalQuery;
 		if (!query) return;
-		const queryString = JSON.stringify(query);
+		const queryString = String(query.hash);
 		if (queryString === prevQueryString) return;
 		prevQueryString = queryString;
+		const myRun = ++runId;
+		teardownActive();
 		setIsFetched(false);
-		initQuery(query);
-		onCleanup(() => {
-			unsubscribe()?.();
-		});
+		initQuery(query, myRun);
+	});
+	onCleanup(() => {
+		runId++;
+		teardownActive();
+		if (options?.deregisterOnCleanup && activeHash) sp00ky.deregisterQuery(activeHash);
 	});
 	const isLoading = () => {
 		return !isFetched() && error() === void 0;
@@ -68,7 +99,102 @@ function useQuery(dbOrQuery, queryOrOptions, maybeOptions) {
 	return {
 		data,
 		error,
-		isLoading
+		isLoading,
+		isFetching
+	};
+}
+
+//#endregion
+//#region src/lib/use-sync-status.ts
+/**
+* Observe sync health for a "can't reach the server" banner / indicator.
+*
+* Backed by `db.subscribeToSyncHealth`. Individual sync failures (a transient
+* remote 500 on query registration, a dropped socket) are absorbed by the
+* retry and never flip this; `isDegraded()` only goes true once failures
+* persist for the configured number of consecutive rounds (sp00ky core config
+* `syncHealth.degradeAfterConsecutiveFailures`, default 3), and flips back on
+* the next successful round. Must be used within a `<Sp00kyProvider>`.
+*/
+function useSyncStatus() {
+	const db = useDb();
+	const [health, setHealth] = createSignal(db.syncHealth);
+	onCleanup(db.subscribeToSyncHealth(setHealth));
+	return {
+		health,
+		status: () => health().status,
+		isHealthy: () => health().status === "healthy",
+		isDegraded: () => health().status === "degraded"
+	};
+}
+
+//#endregion
+//#region src/lib/use-crdt-field.ts
+function useCrdtField(table, recordId, field, fallbackText) {
+	const db = useContext(Sp00kyContext);
+	if (!db) throw new Error("useCrdtField must be used within a <Sp00kyProvider>");
+	const [crdtField, setCrdtField] = createSignal(null);
+	let currentId;
+	let initialized = false;
+	createEffect(() => {
+		const id = recordId();
+		if (initialized && id === currentId) return;
+		if (currentId && crdtField()) {
+			db.getSp00ky().closeCrdtField(table, currentId, field);
+			setCrdtField(null);
+		}
+		currentId = id;
+		initialized = true;
+		if (!id) return;
+		const sp00ky = db.getSp00ky();
+		const text = fallbackText?.();
+		sp00ky.openCrdtField(table, id, field, text).then((cf) => {
+			if (currentId === id) setCrdtField(cf);
+		}).catch((err) => {
+			console.error(`[useCrdtField] Failed to open CRDT field ${table}.${field} on ${id}:`, err);
+		});
+	});
+	onCleanup(() => {
+		if (currentId && crdtField()) {
+			db.getSp00ky().closeCrdtField(table, currentId, field);
+			setCrdtField(null);
+		}
+	});
+	return crdtField;
+}
+
+//#endregion
+//#region src/lib/use-feature-flag.ts
+/**
+* Subscribe to a feature flag for the currently authenticated user.
+*
+* Returns three Solid accessors that update reactively whenever the
+* server-materialized assignment in `_00_user_feature` changes. Backed by
+* the same SSP + sync pipeline that powers `useQuery`, so toggling a flag
+* via `spky flag enable <key>` propagates to the UI without a refresh.
+*
+* `enabled()` is `true` when the resolved variant exists and is not 'off'.
+* For multi-variant flags, prefer `variant()` directly.
+*/
+function useFeatureFlag(key, options) {
+	const handle = useDb().getSp00ky().feature(key, options);
+	const [variant, setVariant] = createSignal(handle.variant());
+	const [payload, setPayload] = createSignal(handle.payload());
+	const unsub = handle.subscribe((s) => {
+		setVariant(s.variant ?? options?.fallback);
+		setPayload(s.payload);
+	});
+	onCleanup(() => {
+		unsub();
+		handle.close();
+	});
+	return {
+		variant,
+		payload,
+		enabled: () => {
+			const v = variant();
+			return v !== void 0 && v !== "off";
+		}
 	};
 }
 
@@ -94,7 +220,7 @@ function useFileUpload(dbOrBucketName, maybeBucketName) {
 	const validate = (file) => {
 		const config = db.getBucketConfig(bucketName);
 		if (!config) return;
-		if (config.maxSize != null && file.size > config.maxSize) {
+		if (config.maxSize !== null && config.maxSize !== void 0 && file.size > config.maxSize) {
 			const maxMB = (config.maxSize / (1024 * 1024)).toFixed(1);
 			throw new Error(`File exceeds maximum size of ${maxMB} MB.`);
 		}
@@ -203,9 +329,8 @@ function useDownloadFile(dbOrBucketName, bucketNameOrPath, pathOrOptions, maybeO
 	const [error, setError] = createSignal(null);
 	let currentKey = null;
 	let privateUrl = null;
-	let refetchTrigger;
 	const [refetchSignal, setRefetchSignal] = createSignal(0);
-	refetchTrigger = () => setRefetchSignal((n) => n + 1);
+	const refetchTrigger = () => setRefetchSignal((n) => n + 1);
 	async function doDownload(key, filePath) {
 		if (useCache) {
 			const cached = downloadCache.get(key);
@@ -325,8 +450,8 @@ function useDownloadFile(dbOrBucketName, bucketNameOrPath, pathOrOptions, maybeO
 }
 
 //#endregion
-//#region src/lib/SpookyProvider.ts
-function SpookyProvider(props) {
+//#region src/lib/Sp00kyProvider.ts
+function Sp00kyProvider(props) {
 	const merged = mergeProps({ fallback: void 0 }, props);
 	const [db, setDb] = createSignal(void 0);
 	onMount(async () => {
@@ -338,13 +463,13 @@ function SpookyProvider(props) {
 		} catch (e) {
 			const error = e instanceof Error ? e : new Error(String(e));
 			if (merged.onError) merged.onError(error);
-			else console.error("SpookyProvider: Failed to initialize database", error);
+			else console.error("Sp00kyProvider: Failed to initialize database", error);
 		}
 	});
 	return createMemo(() => {
 		const instance = db();
 		if (!instance) return merged.fallback;
-		return createComponent(SpookyContext.Provider, {
+		return createComponent(Sp00kyContext.Provider, {
 			value: instance,
 			get children() {
 				return merged.children;
@@ -356,69 +481,73 @@ function SpookyProvider(props) {
 //#endregion
 //#region src/index.ts
 /**
-* SyncedDb - A thin wrapper around spooky-ts for Solid.js integration
-* Delegates all logic to the underlying spooky-ts instance
+* SyncedDb - A thin wrapper around sp00ky-ts for Solid.js integration
+* Delegates all logic to the underlying sp00ky-ts instance
 */
 var SyncedDb = class {
 	constructor(config) {
-		this.spooky = null;
+		this.sp00ky = null;
 		this._initialized = false;
 		this.config = config;
 	}
-	getSpooky() {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky;
+	getSp00ky() {
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky;
 	}
 	/**
-	* Initialize the spooky-ts instance
+	* Initialize the sp00ky-ts instance
 	*/
 	async init() {
 		if (this._initialized) return;
-		this.spooky = new SpookyClient(this.config);
-		await this.spooky.init();
+		this.sp00ky = new Sp00kyClient(this.config);
+		await this.sp00ky.init();
 		this._initialized = true;
 	}
 	/**
 	* Create a new record in the database
 	*/
 	async create(id, payload) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		await this.spooky.create(id, payload);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		await this.sp00ky.create(id, payload);
 	}
 	/**
 	* Update an existing record in the database
 	*/
 	async update(tableName, recordId, payload, options) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		await this.spooky.update(tableName, recordId, payload, options);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		await this.sp00ky.update(tableName, recordId, payload, options);
 	}
 	/**
 	* Delete an existing record in the database
 	*/
 	async delete(tableName, selector) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		if (typeof selector !== "string") throw new Error("Only string ID selectors are supported currently with core");
-		await this.spooky.delete(tableName, selector);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		const isRecordId = selector instanceof RecordId || selector?.constructor?.name === "RecordId";
+		let id;
+		if (typeof selector === "string") id = selector;
+		else if (isRecordId) id = `${tableName}:${selector.id}`;
+		else throw new Error("Only string ID or RecordId selectors are supported currently with core");
+		await this.sp00ky.delete(tableName, id);
 	}
 	/**
 	* Query data from the database
 	*/
 	query(table) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.query(table, {});
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.query(table, {});
 	}
 	/**
 	* Run a backend operation
 	*/
 	async run(backend, path, payload, options) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		await this.spooky.run(backend, path, payload, options);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		await this.sp00ky.run(backend, path, payload, options);
 	}
 	/**
 	* Authenticate with the database
 	*/
 	async authenticate(token) {
-		await this.spooky?.authenticate(token);
+		await this.sp00ky?.authenticate(token);
 		return new RecordId("user", "me");
 	}
 	/**
@@ -432,48 +561,67 @@ var SyncedDb = class {
 	* Sign out, clear session and local storage
 	*/
 	async signOut() {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		await this.spooky.auth.signOut();
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		await this.sp00ky.auth.signOut();
 	}
 	/**
 	* Execute a function with direct access to the remote database connection
 	*/
 	async useRemote(fn) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return await this.spooky.useRemote(fn);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return await this.sp00ky.useRemote(fn);
 	}
 	/**
 	* Access the remote database service directly
 	*/
 	get remote() {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.remoteClient;
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.remoteClient;
 	}
 	/**
 	* Access the local database service directly
 	*/
 	get local() {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.localClient;
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.localClient;
 	}
 	/**
 	* Access the auth service
 	*/
 	get auth() {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.auth;
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.auth;
 	}
 	get pendingMutationCount() {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.pendingMutationCount;
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.pendingMutationCount;
+	}
+	/** Diagnostic — see `Sp00kyClient.liveRetryCount`. */
+	get liveRetryCount() {
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.liveRetryCount;
 	}
 	subscribeToPendingMutations(cb) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.subscribeToPendingMutations(cb);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.subscribeToPendingMutations(cb);
+	}
+	/** Current sync-health snapshot. See {@link useSyncStatus}. */
+	get syncHealth() {
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.syncHealth;
+	}
+	/**
+	* Observe sync health. Fires immediately with the current status and again
+	* on every healthy↔degraded transition. Prefer the `useSyncStatus` hook in
+	* components; this is the imperative escape hatch.
+	*/
+	subscribeToSyncHealth(cb) {
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.subscribeToSyncHealth(cb);
 	}
 	bucket(name) {
-		if (!this.spooky) throw new Error("SyncedDb not initialized");
-		return this.spooky.bucket(name);
+		if (!this.sp00ky) throw new Error("SyncedDb not initialized");
+		return this.sp00ky.bucket(name);
 	}
 	getBucketConfig(name) {
 		return this.config.schema.buckets?.find((b) => b.name === name);
@@ -481,5 +629,5 @@ var SyncedDb = class {
 };
 
 //#endregion
-export { RecordId, SpookyProvider, SyncedDb, Uuid, useDb, useDownloadFile, useFileUpload, useQuery };
+export { RecordId, Sp00kyProvider, SyncedDb, Uuid, useCrdtField, useDb, useDownloadFile, useFeatureFlag, useFileUpload, useQuery, useSyncStatus };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/lib/context.ts","../src/lib/use-query.ts","../src/lib/use-file-upload.ts","../src/lib/use-download-file.ts","../src/lib/SpookyProvider.ts","../src/index.ts"],"sourcesContent":["import { createContext, useContext } from 'solid-js';\nimport type { SchemaStructure } from '@spooky/query-builder';\nimport type { SyncedDb } from '../index';\n\nexport const SpookyContext = createContext<SyncedDb<any> | undefined>();\n\nexport function useDb<S extends SchemaStructure>(): SyncedDb<S> {\n  const db = useContext(SpookyContext);\n  if (!db) {\n    throw new Error('useDb must be used within a <SpookyProvider>. Wrap your app in <SpookyProvider config={...}>.');\n  }\n  return db as SyncedDb<S>;\n}\n","import {\n  ColumnSchema,\n  FinalQuery,\n  SchemaStructure,\n  TableNames,\n  QueryResult,\n} from '@spooky-sync/query-builder';\nimport { createEffect, createSignal, onCleanup, useContext } from 'solid-js';\nimport { SyncedDb } from '..';\nimport { SpookyQueryResultPromise } from '@spooky-sync/core';\nimport { SpookyContext } from './context';\n\ntype QueryArg<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n> =\n  | FinalQuery<S, TableName, T, RelatedFields, IsOne, SpookyQueryResultPromise>\n  | (() =>\n      | FinalQuery<S, TableName, T, RelatedFields, IsOne, SpookyQueryResultPromise>\n      | null\n      | undefined);\n\ntype QueryOptions = { enabled?: () => boolean };\n\n// Overload: context-based (no explicit db)\nexport function useQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n  TData = QueryResult<S, TableName, RelatedFields, IsOne> | null,\n>(\n  finalQuery: QueryArg<S, TableName, T, RelatedFields, IsOne>,\n  options?: QueryOptions,\n): { data: () => TData | undefined; error: () => Error | undefined; isLoading: () => boolean };\n\n// Overload: explicit db (backward-compatible)\nexport function useQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n  TData = QueryResult<S, TableName, RelatedFields, IsOne> | null,\n>(\n  db: SyncedDb<S>,\n  finalQuery: QueryArg<S, TableName, T, RelatedFields, IsOne>,\n  options?: QueryOptions,\n): { data: () => TData | undefined; error: () => Error | undefined; isLoading: () => boolean };\n\n// Implementation\nexport function useQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends {\n    columns: Record<string, ColumnSchema>;\n  },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n  TData = QueryResult<S, TableName, RelatedFields, IsOne> | null,\n>(\n  dbOrQuery:\n    | SyncedDb<S>\n    | QueryArg<S, TableName, T, RelatedFields, IsOne>,\n  queryOrOptions?:\n    | QueryArg<S, TableName, T, RelatedFields, IsOne>\n    | QueryOptions,\n  maybeOptions?: QueryOptions,\n) {\n  let db: SyncedDb<S>;\n  let finalQuery: QueryArg<S, TableName, T, RelatedFields, IsOne>;\n  let options: QueryOptions | undefined;\n\n  if (dbOrQuery instanceof SyncedDb) {\n    // Explicit db overload: useQuery(db, query, options?)\n    db = dbOrQuery;\n    finalQuery = queryOrOptions as QueryArg<S, TableName, T, RelatedFields, IsOne>;\n    options = maybeOptions;\n  } else {\n    // Context-based overload: useQuery(query, options?)\n    const contextDb = useContext(SpookyContext);\n    if (!contextDb) {\n      throw new Error(\n        'useQuery: No db argument provided and no SpookyContext found. ' +\n        'Either pass a SyncedDb instance or wrap your app in <SpookyProvider>.'\n      );\n    }\n    db = contextDb as SyncedDb<S>;\n    finalQuery = dbOrQuery;\n    options = queryOrOptions as QueryOptions | undefined;\n  }\n\n  const [data, setData] = createSignal<TData | undefined>(undefined);\n  const [error, setError] = createSignal<Error | undefined>(undefined);\n  const [isFetched, setIsFetched] = createSignal(false);\n  const [unsubscribe, setUnsubscribe] = createSignal<(() => void) | undefined>(undefined);\n  let prevQueryString: string | undefined;\n\n  const spooky = db.getSpooky();\n\n  const initQuery = async (\n    query: FinalQuery<S, TableName, T, RelatedFields, IsOne, SpookyQueryResultPromise>\n  ) => {\n    const { hash } = await query.run();\n    setError(undefined);\n\n    let isFirstCall = true;\n    const unsub = await spooky.subscribe(\n      hash,\n      (e) => {\n        const data = (query.isOne ? e[0] : e) as TData;\n        setData(() => data);\n        // The first (immediate) callback with no data likely means the local DB\n        // hasn't synced yet — don't mark as fetched so UI shows loading state\n        const hasData = query.isOne ? data != null : (e as any[]).length > 0;\n        if (!isFirstCall || hasData) {\n          setIsFetched(true);\n        }\n        isFirstCall = false;\n      },\n      { immediate: true }\n    );\n\n    setUnsubscribe(() => unsub);\n  };\n\n  createEffect(() => {\n    const enabled = options?.enabled?.() ?? true;\n\n    // If disabled, clear error and don't run query\n    if (!enabled) {\n      setError(undefined);\n      return;\n    }\n\n    // Init Query\n    const query = typeof finalQuery === 'function' ? finalQuery() : finalQuery;\n    if (!query) {\n      return;\n    }\n\n    // Prevent re-running if query hasn't changed\n    const queryString = JSON.stringify(query);\n    if (queryString === prevQueryString) {\n      return;\n    }\n    prevQueryString = queryString;\n\n    // Reset fetched state when query changes\n    setIsFetched(false);\n    initQuery(query);\n\n    // Cleanup\n    onCleanup(() => {\n      unsubscribe()?.();\n    });\n  });\n\n  const isLoading = () => {\n    return !isFetched() && error() === undefined;\n  };\n\n  return {\n    data,\n    error,\n    isLoading,\n  };\n}\n","import { createSignal, onCleanup } from 'solid-js';\nimport type { SchemaStructure, BucketNames } from '@spooky-sync/query-builder';\nimport { fileToUint8Array } from '@spooky-sync/core';\nimport type { SyncedDb } from '../index';\nimport { useDb } from './context';\n\nexport interface FileUploadResult {\n  isUploading: () => boolean;\n  error: () => Error | null;\n  clearError: () => void;\n  upload: (path: string, file: File | Blob) => Promise<void>;\n  download: (path: string) => Promise<string | null>;\n  remove: (path: string) => Promise<void>;\n  exists: (path: string) => Promise<boolean>;\n}\n\nexport function useFileUpload<S extends SchemaStructure>(\n  bucketName: BucketNames<S>,\n): FileUploadResult;\nexport function useFileUpload<S extends SchemaStructure>(\n  db: SyncedDb<S>,\n  bucketName: BucketNames<S>,\n): FileUploadResult;\nexport function useFileUpload<S extends SchemaStructure>(\n  dbOrBucketName: SyncedDb<S> | BucketNames<S>,\n  maybeBucketName?: BucketNames<S>,\n): FileUploadResult {\n  let db: SyncedDb<S>;\n  let bucketName: BucketNames<S>;\n\n  if (typeof dbOrBucketName === 'string') {\n    db = useDb<S>();\n    bucketName = dbOrBucketName as BucketNames<S>;\n  } else {\n    db = dbOrBucketName as SyncedDb<S>;\n    bucketName = maybeBucketName!;\n  }\n\n  const [isUploading, setIsUploading] = createSignal(false);\n  const [error, setError] = createSignal<Error | null>(null);\n\n  const objectUrls: string[] = [];\n  onCleanup(() => {\n    for (const url of objectUrls) {\n      URL.revokeObjectURL(url);\n    }\n  });\n\n  const clearError = () => setError(null);\n\n  const validate = (file: File | Blob): void => {\n    const config = db.getBucketConfig(bucketName as string);\n    if (!config) return;\n\n    if (config.maxSize != null && file.size > config.maxSize) {\n      const maxMB = (config.maxSize / (1024 * 1024)).toFixed(1);\n      throw new Error(`File exceeds maximum size of ${maxMB} MB.`);\n    }\n\n    if (config.allowedExtensions && config.allowedExtensions.length > 0) {\n      const fileName = (file as File).name;\n      if (fileName) {\n        const ext = fileName.split('.').pop()?.toLowerCase();\n        if (!ext || !config.allowedExtensions.includes(ext)) {\n          throw new Error(\n            `File type not allowed. Accepted: ${config.allowedExtensions.join(', ')}.`\n          );\n        }\n      }\n    }\n  };\n\n  const upload = async (path: string, file: File | Blob): Promise<void> => {\n    setError(null);\n    try {\n      validate(file);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n      return;\n    }\n\n    setIsUploading(true);\n    try {\n      const bytes = await fileToUint8Array(file);\n      await db.bucket(bucketName).put(path, bytes);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setIsUploading(false);\n    }\n  };\n\n  const download = async (path: string): Promise<string | null> => {\n    setError(null);\n    try {\n      const content = await db.bucket(bucketName).get(path);\n      if (!content) return null;\n      const objectUrl = URL.createObjectURL(new Blob([content as BlobPart]));\n      objectUrls.push(objectUrl);\n      return objectUrl;\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n      return null;\n    }\n  };\n\n  const remove = async (path: string): Promise<void> => {\n    setError(null);\n    try {\n      await db.bucket(bucketName).delete(path);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    }\n  };\n\n  const exists = async (path: string): Promise<boolean> => {\n    setError(null);\n    try {\n      return await db.bucket(bucketName).exists(path);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n      return false;\n    }\n  };\n\n  return {\n    isUploading,\n    error,\n    clearError,\n    upload,\n    download,\n    remove,\n    exists,\n  };\n}\n","import { createSignal, createEffect, onCleanup, type Accessor } from 'solid-js';\nimport type { SchemaStructure, BucketNames } from '@spooky-sync/query-builder';\nimport type { SyncedDb } from '../index';\nimport { useDb } from './context';\n\nexport interface UseDownloadFileOptions {\n  cache?: boolean;\n}\n\nexport interface UseDownloadFileResult {\n  url: Accessor<string | null>;\n  isLoading: Accessor<boolean>;\n  error: Accessor<Error | null>;\n  refetch: () => void;\n}\n\ninterface CacheEntry {\n  url: string;\n  refCount: number;\n}\n\nconst downloadCache = new Map<string, CacheEntry>();\nconst inflightRequests = new Map<string, Promise<string | null>>();\n\nfunction cacheKey(bucket: string, path: string): string {\n  return `${bucket}:${path}`;\n}\n\nfunction releaseEntry(key: string): void {\n  const entry = downloadCache.get(key);\n  if (!entry) return;\n  entry.refCount--;\n  if (entry.refCount <= 0) {\n    URL.revokeObjectURL(entry.url);\n    downloadCache.delete(key);\n  }\n}\n\nexport function useDownloadFile<S extends SchemaStructure>(\n  bucketName: BucketNames<S>,\n  path: Accessor<string | null | undefined>,\n  options?: UseDownloadFileOptions,\n): UseDownloadFileResult;\nexport function useDownloadFile<S extends SchemaStructure>(\n  db: SyncedDb<S>,\n  bucketName: BucketNames<S>,\n  path: Accessor<string | null | undefined>,\n  options?: UseDownloadFileOptions,\n): UseDownloadFileResult;\nexport function useDownloadFile<S extends SchemaStructure>(\n  dbOrBucketName: SyncedDb<S> | BucketNames<S>,\n  bucketNameOrPath?: BucketNames<S> | Accessor<string | null | undefined>,\n  pathOrOptions?: Accessor<string | null | undefined> | UseDownloadFileOptions,\n  maybeOptions?: UseDownloadFileOptions,\n): UseDownloadFileResult {\n  let db: SyncedDb<S>;\n  let bucketName: BucketNames<S>;\n  let path: Accessor<string | null | undefined>;\n  let options: UseDownloadFileOptions;\n\n  if (typeof dbOrBucketName === 'string') {\n    db = useDb<S>();\n    bucketName = dbOrBucketName as BucketNames<S>;\n    path = bucketNameOrPath as Accessor<string | null | undefined>;\n    options = (pathOrOptions as UseDownloadFileOptions) ?? {};\n  } else {\n    db = dbOrBucketName as SyncedDb<S>;\n    bucketName = bucketNameOrPath as BucketNames<S>;\n    path = pathOrOptions as Accessor<string | null | undefined>;\n    options = maybeOptions ?? {};\n  }\n\n  const useCache = options.cache !== false;\n\n  const [url, setUrl] = createSignal<string | null>(null);\n  const [isLoading, setIsLoading] = createSignal(false);\n  const [error, setError] = createSignal<Error | null>(null);\n\n  let currentKey: string | null = null;\n  let privateUrl: string | null = null;\n  let refetchTrigger: () => void;\n  const [refetchSignal, setRefetchSignal] = createSignal(0);\n  refetchTrigger = () => setRefetchSignal((n) => n + 1);\n\n  async function doDownload(key: string, filePath: string): Promise<string | null> {\n    if (useCache) {\n      // Check cache\n      const cached = downloadCache.get(key);\n      if (cached) {\n        cached.refCount++;\n        currentKey = key;\n        return cached.url;\n      }\n\n      // Check inflight\n      const inflight = inflightRequests.get(key);\n      if (inflight) {\n        const result = await inflight;\n        if (result) {\n          const entry = downloadCache.get(key);\n          if (entry) {\n            entry.refCount++;\n            currentKey = key;\n          }\n        }\n        return result;\n      }\n\n      // Start new download\n      const promise = (async () => {\n        const content = await db.bucket(bucketName).get(filePath);\n        if (!content) return null;\n        const objectUrl = URL.createObjectURL(new Blob([content as BlobPart]));\n        downloadCache.set(key, { url: objectUrl, refCount: 1 });\n        return objectUrl;\n      })();\n\n      inflightRequests.set(key, promise);\n      try {\n        const result = await promise;\n        currentKey = key;\n        return result;\n      } finally {\n        inflightRequests.delete(key);\n      }\n    } else {\n      // No caching — private URL per instance\n      const content = await db.bucket(bucketName).get(filePath);\n      if (!content) return null;\n      const objectUrl = URL.createObjectURL(new Blob([content as BlobPart]));\n      privateUrl = objectUrl;\n      return objectUrl;\n    }\n  }\n\n  function releaseCurrentEntry() {\n    if (useCache && currentKey) {\n      releaseEntry(currentKey);\n      currentKey = null;\n    }\n    if (!useCache && privateUrl) {\n      URL.revokeObjectURL(privateUrl);\n      privateUrl = null;\n    }\n  }\n\n  createEffect(() => {\n    const filePath = path();\n    // Subscribe to refetch signal so effect re-runs\n    refetchSignal();\n\n    // Release previous entry\n    releaseCurrentEntry();\n\n    if (!filePath) {\n      setUrl(null);\n      setIsLoading(false);\n      setError(null);\n      return;\n    }\n\n    const key = cacheKey(bucketName as string, filePath);\n\n    // Synchronous cache hit\n    if (useCache) {\n      const cached = downloadCache.get(key);\n      if (cached) {\n        cached.refCount++;\n        currentKey = key;\n        setUrl(cached.url);\n        setIsLoading(false);\n        setError(null);\n        return;\n      }\n    }\n\n    let cancelled = false;\n    setIsLoading(true);\n    setError(null);\n\n    doDownload(key, filePath).then(\n      (result) => {\n        if (!cancelled) {\n          setUrl(result);\n          setIsLoading(false);\n        }\n      },\n      (err) => {\n        if (!cancelled) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n          setIsLoading(false);\n        }\n      },\n    );\n\n    onCleanup(() => {\n      cancelled = true;\n    });\n  });\n\n  onCleanup(() => {\n    releaseCurrentEntry();\n  });\n\n  const refetch = () => {\n    // Evict current entry from cache before re-triggering\n    if (useCache && currentKey) {\n      const entry = downloadCache.get(currentKey);\n      if (entry) {\n        URL.revokeObjectURL(entry.url);\n        downloadCache.delete(currentKey);\n      }\n      currentKey = null;\n    }\n    refetchTrigger();\n  };\n\n  return { url, isLoading, error, refetch };\n}\n","import { createSignal, onMount, createComponent, createMemo, JSX, mergeProps } from 'solid-js';\nimport type { SchemaStructure } from '@spooky/query-builder';\nimport type { SyncedDbConfig } from '../types';\nimport { SyncedDb } from '../index';\nimport { SpookyContext } from './context';\n\nexport interface SpookyProviderProps<S extends SchemaStructure> {\n  config: SyncedDbConfig<S>;\n  fallback?: JSX.Element;\n  onError?: (error: Error) => void;\n  onReady?: (db: SyncedDb<S>) => void;\n  children: JSX.Element;\n}\n\nexport function SpookyProvider<S extends SchemaStructure>(\n  props: SpookyProviderProps<S>\n): JSX.Element {\n  const merged = mergeProps(\n    {\n      fallback: undefined as JSX.Element | undefined,\n    },\n    props\n  );\n\n  const [db, setDb] = createSignal<SyncedDb<S> | undefined>(undefined);\n\n  onMount(async () => {\n    try {\n      const instance = new SyncedDb<S>(merged.config);\n      await instance.init();\n      setDb(() => instance);\n      merged.onReady?.(instance);\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(String(e));\n      if (merged.onError) {\n        merged.onError(error);\n      } else {\n        console.error('SpookyProvider: Failed to initialize database', error);\n      }\n    }\n  });\n\n  const content = createMemo(() => {\n    const instance = db();\n    if (!instance) return merged.fallback;\n    return createComponent(SpookyContext.Provider, {\n      value: instance,\n      get children() {\n        return merged.children;\n      },\n    });\n  });\n\n  return content as unknown as JSX.Element;\n}\n","import type { SyncedDbConfig } from './types';\nimport {\n  SpookyClient,\n  AuthService,\n  BucketHandle,\n  type SpookyQueryResultPromise,\n  UpdateOptions,\n  RunOptions,\n} from '@spooky-sync/core';\n\nimport {\n  GetTable,\n  QueryBuilder,\n  SchemaStructure,\n  TableModel,\n  TableNames,\n  QueryResult,\n  RelatedFieldsMap,\n  RelationshipFieldsFromSchema,\n  GetRelationship,\n  RelatedFieldMapEntry,\n  InnerQuery,\n  BackendNames,\n  BackendRoutes,\n  RoutePayload,\n  BucketNames,\n  BucketDefinitionSchema,\n} from '@spooky-sync/query-builder';\n\nimport { RecordId, Uuid, Surreal } from 'surrealdb';\nexport { RecordId, Uuid };\nexport type { Model, GenericModel, GenericSchema, ModelPayload } from './lib/models';\nexport { useQuery } from './lib/use-query';\nexport { useFileUpload, type FileUploadResult } from './lib/use-file-upload';\nexport { useDownloadFile, type UseDownloadFileOptions, type UseDownloadFileResult } from './lib/use-download-file';\nexport { SpookyProvider, type SpookyProviderProps } from './lib/SpookyProvider';\nexport { useDb } from './lib/context';\n\n// export { AuthEventTypes } from \"@spooky-sync/core\"; // TODO: Verify if AuthEventTypes exists in core\nexport type {};\n\n// Re-export query builder types for convenience\nexport type {\n  QueryModifier,\n  QueryModifierBuilder,\n  QueryInfo,\n  RelationshipsMetadata,\n  RelationshipDefinition,\n  InferRelatedModelFromMetadata,\n  GetCardinality,\n  GetTable,\n  TableModel,\n  TableNames,\n  QueryResult,\n} from '@spooky-sync/query-builder';\n\nexport type RelationshipField<\n  Schema extends SchemaStructure,\n  TableName extends TableNames<Schema>,\n  Field extends RelationshipFieldsFromSchema<Schema, TableName>,\n> = GetRelationship<Schema, TableName, Field>;\n\nexport type RelatedFieldsTableScoped<\n  Schema extends SchemaStructure,\n  TableName extends TableNames<Schema>,\n  RelatedFields extends RelationshipFieldsFromSchema<Schema, TableName> =\n    RelationshipFieldsFromSchema<Schema, TableName>,\n> = {\n  [K in RelatedFields]: {\n    to: RelationshipField<Schema, TableName, K>['to'];\n    relatedFields: RelatedFieldsMap;\n    cardinality: RelationshipField<Schema, TableName, K>['cardinality'];\n  };\n};\n\nexport type InferModel<\n  Schema extends SchemaStructure,\n  TableName extends TableNames<Schema>,\n  RelatedFields extends RelatedFieldsTableScoped<Schema, TableName>,\n> = QueryResult<Schema, TableName, RelatedFields, true>;\n\nexport type WithRelated<Field extends string, RelatedFields extends RelatedFieldsMap = {}> = {\n  [K in Field]: Omit<RelatedFieldMapEntry, 'relatedFields'> & {\n    relatedFields: RelatedFields;\n  };\n};\n\nexport type WithRelatedMany<Field extends string, RelatedFields extends RelatedFieldsMap = {}> = {\n  [K in Field]: {\n    to: Field;\n    relatedFields: RelatedFields;\n    cardinality: 'many';\n  };\n};\n\n/**\n * SyncedDb - A thin wrapper around spooky-ts for Solid.js integration\n * Delegates all logic to the underlying spooky-ts instance\n */\nexport class SyncedDb<S extends SchemaStructure> {\n  private config: SyncedDbConfig<S>;\n  private spooky: SpookyClient<S> | null = null;\n  private _initialized = false;\n\n  constructor(config: SyncedDbConfig<S>) {\n    this.config = config;\n  }\n\n  public getSpooky(): SpookyClient<S> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky;\n  }\n\n  /**\n   * Initialize the spooky-ts instance\n   */\n  async init(): Promise<void> {\n    if (this._initialized) return;\n    this.spooky = new SpookyClient<S>(this.config);\n    await this.spooky.init();\n    this._initialized = true;\n  }\n\n  /**\n   * Create a new record in the database\n   */\n  async create(id: string, payload: Record<string, unknown>): Promise<void> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    await this.spooky.create(id, payload as Record<string, unknown>);\n  }\n\n  /**\n   * Update an existing record in the database\n   */\n  async update<TName extends TableNames<S>>(\n    tableName: TName,\n    recordId: string,\n    payload: Partial<TableModel<GetTable<S, TName>>>,\n    options?: UpdateOptions\n  ): Promise<void> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    await this.spooky.update(\n      tableName as string,\n      recordId,\n      payload as Record<string, unknown>,\n      options\n    );\n  }\n\n  /**\n   * Delete an existing record in the database\n   */\n  async delete<TName extends TableNames<S>>(\n    tableName: TName,\n    selector: string | InnerQuery<GetTable<S, TName>, boolean>\n  ): Promise<void> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    if (typeof selector !== 'string')\n      throw new Error('Only string ID selectors are supported currently with core');\n    await this.spooky.delete(tableName as string, selector);\n  }\n\n  /**\n   * Query data from the database\n   */\n  public query<TName extends TableNames<S>>(\n    table: TName\n  ): QueryBuilder<S, TName, SpookyQueryResultPromise, {}, false> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.query(table, {});\n  }\n\n  /**\n   * Run a backend operation\n   */\n  public async run<\n    B extends BackendNames<S>,\n    R extends BackendRoutes<S, B>,\n  >(\n    backend: B,\n    path: R,\n    payload: RoutePayload<S, B, R>,\n    options?: RunOptions,\n  ): Promise<void> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    await this.spooky.run(backend, path, payload, options);\n  }\n\n  /**\n   * Authenticate with the database\n   */\n  public async authenticate(token: string): Promise<RecordId<string>> {\n    const result = await this.spooky?.authenticate(token);\n    // SpookyClient.authenticate returns whatever remote.authenticate returns (boolean or token usually?)\n    // Wait, checked SpookyClient: return this.remote.getClient().authenticate(token);\n    // SurrealDB authenticate returns void? or token?\n    // Assuming void or token.\n    return new RecordId('user', 'me'); // Placeholder or actual?\n  }\n\n  /**\n   * Deauthenticate from the database\n   * @deprecated Use signOut() instead\n   */\n  public async deauthenticate(): Promise<void> {\n    await this.signOut();\n  }\n\n  /**\n   * Sign out, clear session and local storage\n   */\n  public async signOut(): Promise<void> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    await this.spooky.auth.signOut();\n  }\n\n  /**\n   * Execute a function with direct access to the remote database connection\n   */\n  public async useRemote<T>(fn: (db: Surreal) => T | Promise<T>): Promise<T> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return await this.spooky.useRemote(fn);\n  }\n  /**\n   * Access the remote database service directly\n   */\n  get remote(): SpookyClient<S>['remoteClient'] {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.remoteClient;\n  }\n\n  /**\n   * Access the local database service directly\n   */\n  get local(): SpookyClient<S>['localClient'] {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.localClient;\n  }\n\n  /**\n   * Access the auth service\n   */\n  get auth(): AuthService<S> {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.auth;\n  }\n\n  get pendingMutationCount(): number {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.pendingMutationCount;\n  }\n\n  subscribeToPendingMutations(cb: (count: number) => void): () => void {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.subscribeToPendingMutations(cb);\n  }\n\n  bucket<B extends BucketNames<S>>(name: B): BucketHandle {\n    if (!this.spooky) throw new Error('SyncedDb not initialized');\n    return this.spooky.bucket(name);\n  }\n\n  getBucketConfig(name: string): BucketDefinitionSchema | undefined {\n    return this.config.schema.buckets?.find((b) => b.name === name);\n  }\n}\n\nexport * from './types';\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/lib/context.ts","../src/lib/use-query.ts","../src/lib/use-sync-status.ts","../src/lib/use-crdt-field.ts","../src/lib/use-feature-flag.ts","../src/lib/use-file-upload.ts","../src/lib/use-download-file.ts","../src/lib/Sp00kyProvider.ts","../src/index.ts"],"sourcesContent":["import { createContext, useContext } from 'solid-js';\nimport type { SchemaStructure } from '@spooky/query-builder';\nimport type { SyncedDb } from '../index';\n\nexport const Sp00kyContext = createContext<SyncedDb<any> | undefined>();\n\nexport function useDb<S extends SchemaStructure>(): SyncedDb<S> {\n  const db = useContext(Sp00kyContext);\n  if (!db) {\n    throw new Error('useDb must be used within a <Sp00kyProvider>. Wrap your app in <Sp00kyProvider config={...}>.');\n  }\n  return db as SyncedDb<S>;\n}\n","import type {\n  ColumnSchema,\n  FinalQuery,\n  SchemaStructure,\n  TableNames,\n  QueryResult,\n} from '@spooky-sync/query-builder';\nimport { createEffect, createSignal, onCleanup, useContext } from 'solid-js';\nimport { createStore, reconcile } from 'solid-js/store';\nimport { SyncedDb } from '..';\nimport type { Sp00kyQueryResultPromise } from '@spooky-sync/core';\nimport { Sp00kyContext } from './context';\n\ntype QueryArg<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n> =\n  | FinalQuery<S, TableName, T, RelatedFields, IsOne, Sp00kyQueryResultPromise>\n  | (() =>\n      | FinalQuery<S, TableName, T, RelatedFields, IsOne, Sp00kyQueryResultPromise>\n      | null\n      | undefined);\n\ntype QueryOptions = {\n  enabled?: () => boolean;\n  /**\n   * Tear down the query (remote `_00_query` view + local WASM view) when this\n   * hook is disposed and no other subscriber remains, instead of keeping it\n   * resident for cheap re-subscription. Use for viewport-windowed lists that\n   * mount/unmount a query per scroll window and want off-screen windows\n   * cancelled. Trade-off: scrolling back to a torn-down window re-registers it.\n   */\n  deregisterOnCleanup?: boolean;\n};\n\n// Overload: context-based (no explicit db)\nexport function useQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n  TData = QueryResult<S, TableName, RelatedFields, IsOne> | null,\n>(\n  finalQuery: QueryArg<S, TableName, T, RelatedFields, IsOne>,\n  options?: QueryOptions,\n): {\n  data: () => TData | undefined;\n  error: () => Error | undefined;\n  isLoading: () => boolean;\n  isFetching: () => boolean;\n};\n\n// Overload: explicit db (backward-compatible)\nexport function useQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends { columns: Record<string, ColumnSchema> },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n  TData = QueryResult<S, TableName, RelatedFields, IsOne> | null,\n>(\n  db: SyncedDb<S>,\n  finalQuery: QueryArg<S, TableName, T, RelatedFields, IsOne>,\n  options?: QueryOptions,\n): {\n  data: () => TData | undefined;\n  error: () => Error | undefined;\n  isLoading: () => boolean;\n  isFetching: () => boolean;\n};\n\n// Implementation\nexport function useQuery<\n  S extends SchemaStructure,\n  TableName extends TableNames<S>,\n  T extends {\n    columns: Record<string, ColumnSchema>;\n  },\n  RelatedFields extends Record<string, any>,\n  IsOne extends boolean,\n  TData = QueryResult<S, TableName, RelatedFields, IsOne> | null,\n>(\n  dbOrQuery:\n    | SyncedDb<S>\n    | QueryArg<S, TableName, T, RelatedFields, IsOne>,\n  queryOrOptions?:\n    | QueryArg<S, TableName, T, RelatedFields, IsOne>\n    | QueryOptions,\n  maybeOptions?: QueryOptions,\n) {\n  let db: SyncedDb<S>;\n  let finalQuery: QueryArg<S, TableName, T, RelatedFields, IsOne>;\n  let options: QueryOptions | undefined;\n\n  if (dbOrQuery instanceof SyncedDb) {\n    // Explicit db overload: useQuery(db, query, options?)\n    db = dbOrQuery;\n    finalQuery = queryOrOptions as QueryArg<S, TableName, T, RelatedFields, IsOne>;\n    options = maybeOptions;\n  } else {\n    // Context-based overload: useQuery(query, options?)\n    const contextDb = useContext(Sp00kyContext);\n    if (!contextDb) {\n      throw new Error(\n        'useQuery: No db argument provided and no Sp00kyContext found. ' +\n        'Either pass a SyncedDb instance or wrap your app in <Sp00kyProvider>.'\n      );\n    }\n    db = contextDb as SyncedDb<S>;\n    finalQuery = dbOrQuery;\n    options = queryOrOptions as QueryOptions | undefined;\n  }\n\n  const [error, setError] = createSignal<Error | undefined>(undefined);\n  const [isFetched, setIsFetched] = createSignal(false);\n  const [isFetching, setIsFetching] = createSignal(false);\n  // Results live in a store (not a signal) so consecutive live-query emissions\n  // are merged with `reconcile`: unchanged rows keep their object identity and\n  // changed rows are mutated in place. That keeps Solid's reference-keyed `<For>`\n  // rows — and any `useQuery` subscriptions mounted inside them — alive across\n  // updates, instead of tearing every row down and re-registering its queries.\n  const [state, setState] = createStore<{ value: TData | undefined }>({ value: undefined });\n  // `reconcile` (below) merges each emission into `state.value` IN PLACE, keeping\n  // the array reference stable. That's ideal for granular per-row reactivity, but\n  // it means a *coarse* reader of `data()` — `<For each={data()}>`, or an effect\n  // that copies the whole array elsewhere (e.g. GameList's windowed store) — is\n  // NOT re-run when rows are added/removed/reordered within a same-length result\n  // (the classic case: deleting a row in a windowed list shifts the next one in,\n  // so length stays 50 and the array ref never changes). Bump a version on every\n  // emission and read it in `data()` so every consumer re-runs on any change while\n  // reconcile still preserves row identity underneath.\n  const [version, setVersion] = createSignal(0);\n  const data = () => {\n    version();\n    return state.value;\n  };\n\n  let prevQueryString: string | undefined;\n  // Monotonic token for each subscription generation. Bumped whenever the query\n  // identity changes or the hook is disposed, so a slow async `initQuery`\n  // continuation can detect it was superseded and avoid installing a stale (and\n  // leaked) subscription.\n  let runId = 0;\n  let activeUnsub: (() => void) | undefined;\n  // The hash of the currently-installed subscription, for opt-in deregister on\n  // dispose (see `deregisterOnCleanup`).\n  let activeHash: string | undefined;\n\n  const teardownActive = () => {\n    activeUnsub?.();\n    activeUnsub = undefined;\n  };\n\n  const sp00ky = db.getSp00ky();\n\n  const initQuery = async (\n    query: FinalQuery<S, TableName, T, RelatedFields, IsOne, Sp00kyQueryResultPromise>,\n    myRun: number\n  ) => {\n    const { hash } = await query.run();\n    // A newer query identity (or disposal) won the race while we awaited run().\n    if (myRun !== runId) return;\n    activeHash = hash;\n    setError(undefined);\n\n    let isFirstCall = true;\n    const unsub = await sp00ky.subscribe(\n      hash,\n      (e) => {\n        const queryData = (query.isOne ? e[0] : e) as TData;\n        // Merge into the store by record id: unchanged rows keep their identity,\n        // changed rows update in place. Replaces wholesale for `one()`/null.\n        // Time the reconcile → report as the \"frontend\" phase for DevTools/MCP.\n        const reconcileStart = performance.now();\n        setState('value', reconcile(queryData as any, { key: 'id' }));\n        // Notify coarse `data()` readers (see the `version` note above): reconcile\n        // keeps the array ref stable, so this is what re-runs `<For>`/copy-effects\n        // on add/remove/reorder.\n        setVersion((v) => v + 1);\n        sp00ky.reportFrontendTiming(hash, performance.now() - reconcileStart);\n        // The first (immediate) callback with no data likely means the local DB\n        // hasn't synced yet — don't mark as fetched so UI shows loading state\n        const hasData = query.isOne ? queryData !== null && queryData !== undefined : (e as any[]).length > 0;\n        if (!isFirstCall || hasData) {\n          setIsFetched(true);\n        }\n        isFirstCall = false;\n      },\n      { immediate: true }\n    );\n\n    // Mirror the query's fetch status so the UI can show a \"loading more\"\n    // state while the sync engine pulls missing records in the background.\n    const unsubStatus = sp00ky.subscribeQueryStatus(\n      hash,\n      (status) => setIsFetching(status === 'fetching'),\n      { immediate: true }\n    );\n\n    const teardown = () => {\n      unsub();\n      unsubStatus();\n    };\n\n    // Superseded while awaiting subscribe()? Don't leak — tear down immediately.\n    if (myRun !== runId) {\n      teardown();\n      return;\n    }\n    activeUnsub = teardown;\n  };\n\n  createEffect(() => {\n    const enabled = options?.enabled?.() ?? true;\n\n    // If disabled, clear error and don't run query\n    if (!enabled) {\n      setError(undefined);\n      return;\n    }\n\n    // Init Query\n    const query = typeof finalQuery === 'function' ? finalQuery() : finalQuery;\n    if (!query) {\n      return;\n    }\n\n    // Dedup on the query's stable identity hash (cyrb53 of surql + vars), not a\n    // full `JSON.stringify` of the FinalQuery (which walks the whole schema +\n    // inner query on every reactive tick and isn't guaranteed stable). When the\n    // identity is unchanged we keep the existing subscription alive.\n    const queryString = String(query.hash);\n    if (queryString === prevQueryString) {\n      return;\n    }\n    prevQueryString = queryString;\n\n    // New query identity → supersede the previous subscription and start fresh.\n    const myRun = ++runId;\n    teardownActive();\n    setIsFetched(false);\n    initQuery(query, myRun);\n  });\n\n  // Tear down the live subscription when the hook's owner is disposed. Registered\n  // on the hook (component) scope rather than inside the effect, so an effect\n  // re-run that early-returns (unchanged query) doesn't clean up the still-valid\n  // subscription. Bumping runId also invalidates any in-flight initQuery.\n  onCleanup(() => {\n    runId++;\n    teardownActive();\n    // Opt-in: cancel the query once this hook (its last subscriber) is gone.\n    // teardownActive() above already removed this hook's callback, so\n    // deregisterQuery's refcount guard sees the true remaining-subscriber count.\n    if (options?.deregisterOnCleanup && activeHash) {\n      sp00ky.deregisterQuery(activeHash);\n    }\n  });\n\n  const isLoading = () => {\n    return !isFetched() && error() === undefined;\n  };\n\n  return {\n    data,\n    error,\n    isLoading,\n    isFetching,\n  };\n}\n","import { createSignal, onCleanup, type Accessor } from 'solid-js';\nimport { useDb } from './context';\nimport type { SyncHealth, SyncHealthStatus } from '@spooky-sync/core';\n\nexport interface UseSyncStatus {\n  /** Full health snapshot; updates reactively on every transition. */\n  health: Accessor<SyncHealth>;\n  /** `'healthy'` | `'degraded'`. */\n  status: Accessor<SyncHealthStatus>;\n  isHealthy: Accessor<boolean>;\n  /** `true` once sync has failed for a sustained run — drive a banner off this. */\n  isDegraded: Accessor<boolean>;\n}\n\n/**\n * Observe sync health for a \"can't reach the server\" banner / indicator.\n *\n * Backed by `db.subscribeToSyncHealth`. Individual sync failures (a transient\n * remote 500 on query registration, a dropped socket) are absorbed by the\n * retry and never flip this; `isDegraded()` only goes true once failures\n * persist for the configured number of consecutive rounds (sp00ky core config\n * `syncHealth.degradeAfterConsecutiveFailures`, default 3), and flips back on\n * the next successful round. Must be used within a `<Sp00kyProvider>`.\n */\nexport function useSyncStatus(): UseSyncStatus {\n  const db = useDb();\n  // subscribeToSyncHealth fires synchronously with the current status, so the\n  // signal is correct from first read; the initial value just avoids a flash.\n  const [health, setHealth] = createSignal<SyncHealth>(db.syncHealth);\n  const unsub = db.subscribeToSyncHealth(setHealth);\n  onCleanup(unsub);\n\n  return {\n    health,\n    status: () => health().status,\n    isHealthy: () => health().status === 'healthy',\n    isDegraded: () => health().status === 'degraded',\n  };\n}\n","import { createEffect, createSignal, onCleanup, useContext, type Accessor } from 'solid-js';\nimport { Sp00kyContext } from './context';\nimport type { CrdtField } from '@spooky-sync/core';\n\nexport function useCrdtField(\n  table: string,\n  recordId: () => string | undefined,\n  field: string,\n  fallbackText?: () => string | undefined,\n): Accessor<CrdtField | null> {\n  const db = useContext(Sp00kyContext);\n  if (!db) {\n    throw new Error('useCrdtField must be used within a <Sp00kyProvider>');\n  }\n\n  const [crdtField, setCrdtField] = createSignal<CrdtField | null>(null);\n  let currentId: string | undefined;\n  let initialized = false;\n\n  createEffect(() => {\n    const id = recordId();\n\n    // Skip if the ID hasn't changed (but allow the first non-undefined value through)\n    if (initialized && id === currentId) return;\n\n    // Close previous field\n    if (currentId && crdtField()) {\n      db.getSp00ky().closeCrdtField(table, currentId, field);\n      setCrdtField(null);\n    }\n\n    currentId = id;\n    initialized = true;\n\n    if (!id) return;\n\n    const sp00ky = db.getSp00ky();\n    const text = fallbackText?.();\n    sp00ky\n      .openCrdtField(table, id, field, text)\n      .then((cf) => {\n        if (currentId === id) {\n          setCrdtField(cf);\n        }\n      })\n      .catch((err) => {\n        // Silent rejections here leave the consumer's `Show when={field()}`\n        // permanently stuck on its fallback (typically a static `<p>` with\n        // no editing UI), with no error trail. Surface the failure so the\n        // root cause (missing `@crdt` annotation, schema codegen drift,\n        // local DB query failure, etc.) is visible in the console instead\n        // of silently breaking collaborative fields.\n        console.error(\n          `[useCrdtField] Failed to open CRDT field ${table}.${field} on ${id}:`,\n          err,\n        );\n      });\n  });\n\n  onCleanup(() => {\n    if (currentId && crdtField()) {\n      db.getSp00ky().closeCrdtField(table, currentId, field);\n      setCrdtField(null);\n    }\n  });\n\n  return crdtField;\n}\n","import { createSignal, onCleanup, type Accessor } from 'solid-js';\nimport { useDb } from './context';\nimport type { FeatureFlagOptions } from '@spooky-sync/core';\n\nexport interface UseFeatureFlag {\n  variant: Accessor<string | undefined>;\n  payload: Accessor<unknown | undefined>;\n  enabled: Accessor<boolean>;\n}\n\n/**\n * Subscribe to a feature flag for the currently authenticated user.\n *\n * Returns three Solid accessors that update reactively whenever the\n * server-materialized assignment in `_00_user_feature` changes. Backed by\n * the same SSP + sync pipeline that powers `useQuery`, so toggling a flag\n * via `spky flag enable <key>` propagates to the UI without a refresh.\n *\n * `enabled()` is `true` when the resolved variant exists and is not 'off'.\n * For multi-variant flags, prefer `variant()` directly.\n */\nexport function useFeatureFlag(\n  key: string,\n  options?: FeatureFlagOptions,\n): UseFeatureFlag {\n  const db = useDb();\n  const handle = db.getSp00ky().feature(key, options);\n\n  const [variant, setVariant] = createSignal<string | undefined>(handle.variant());\n  const [payload, setPayload] = createSignal<unknown | undefined>(handle.payload());\n\n  const unsub = handle.subscribe((s) => {\n    setVariant(s.variant ?? options?.fallback);\n    setPayload(s.payload);\n  });\n\n  onCleanup(() => {\n    unsub();\n    handle.close();\n  });\n\n  return {\n    variant,\n    payload,\n    enabled: () => {\n      const v = variant();\n      return v !== undefined && v !== 'off';\n    },\n  };\n}\n","import { createSignal, onCleanup } from 'solid-js';\nimport type { SchemaStructure, BucketNames } from '@spooky-sync/query-builder';\nimport { fileToUint8Array } from '@spooky-sync/core';\nimport type { SyncedDb } from '../index';\nimport { useDb } from './context';\n\nexport interface FileUploadResult {\n  isUploading: () => boolean;\n  error: () => Error | null;\n  clearError: () => void;\n  upload: (path: string, file: File | Blob) => Promise<void>;\n  download: (path: string) => Promise<string | null>;\n  remove: (path: string) => Promise<void>;\n  exists: (path: string) => Promise<boolean>;\n}\n\nexport function useFileUpload<S extends SchemaStructure>(\n  bucketName: BucketNames<S>,\n): FileUploadResult;\nexport function useFileUpload<S extends SchemaStructure>(\n  db: SyncedDb<S>,\n  bucketName: BucketNames<S>,\n): FileUploadResult;\nexport function useFileUpload<S extends SchemaStructure>(\n  dbOrBucketName: SyncedDb<S> | BucketNames<S>,\n  maybeBucketName?: BucketNames<S>,\n): FileUploadResult {\n  let db: SyncedDb<S>;\n  let bucketName: BucketNames<S>;\n\n  if (typeof dbOrBucketName === 'string') {\n    db = useDb<S>();\n    bucketName = dbOrBucketName as BucketNames<S>;\n  } else {\n    db = dbOrBucketName as SyncedDb<S>;\n    // oxlint-disable-next-line no-non-null-assertion\n    bucketName = maybeBucketName!;\n  }\n\n  const [isUploading, setIsUploading] = createSignal(false);\n  const [error, setError] = createSignal<Error | null>(null);\n\n  const objectUrls: string[] = [];\n  onCleanup(() => {\n    for (const url of objectUrls) {\n      URL.revokeObjectURL(url);\n    }\n  });\n\n  const clearError = () => setError(null);\n\n  const validate = (file: File | Blob): void => {\n    const config = db.getBucketConfig(bucketName as string);\n    if (!config) return;\n\n    if (config.maxSize !== null && config.maxSize !== undefined && file.size > config.maxSize) {\n      const maxMB = (config.maxSize / (1024 * 1024)).toFixed(1);\n      throw new Error(`File exceeds maximum size of ${maxMB} MB.`);\n    }\n\n    if (config.allowedExtensions && config.allowedExtensions.length > 0) {\n      const fileName = (file as File).name;\n      if (fileName) {\n        const ext = fileName.split('.').pop()?.toLowerCase();\n        if (!ext || !config.allowedExtensions.includes(ext)) {\n          throw new Error(\n            `File type not allowed. Accepted: ${config.allowedExtensions.join(', ')}.`\n          );\n        }\n      }\n    }\n  };\n\n  const upload = async (path: string, file: File | Blob): Promise<void> => {\n    setError(null);\n    try {\n      validate(file);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n      return;\n    }\n\n    setIsUploading(true);\n    try {\n      const bytes = await fileToUint8Array(file);\n      await db.bucket(bucketName).put(path, bytes);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    } finally {\n      setIsUploading(false);\n    }\n  };\n\n  const download = async (path: string): Promise<string | null> => {\n    setError(null);\n    try {\n      const content = await db.bucket(bucketName).get(path);\n      if (!content) return null;\n      const objectUrl = URL.createObjectURL(new Blob([content as BlobPart]));\n      objectUrls.push(objectUrl);\n      return objectUrl;\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n      return null;\n    }\n  };\n\n  const remove = async (path: string): Promise<void> => {\n    setError(null);\n    try {\n      await db.bucket(bucketName).delete(path);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n    }\n  };\n\n  const exists = async (path: string): Promise<boolean> => {\n    setError(null);\n    try {\n      return await db.bucket(bucketName).exists(path);\n    } catch (e) {\n      setError(e instanceof Error ? e : new Error(String(e)));\n      return false;\n    }\n  };\n\n  return {\n    isUploading,\n    error,\n    clearError,\n    upload,\n    download,\n    remove,\n    exists,\n  };\n}\n","import { createSignal, createEffect, onCleanup, type Accessor } from 'solid-js';\nimport type { SchemaStructure, BucketNames } from '@spooky-sync/query-builder';\nimport type { SyncedDb } from '../index';\nimport { useDb } from './context';\n\nexport interface UseDownloadFileOptions {\n  cache?: boolean;\n}\n\nexport interface UseDownloadFileResult {\n  url: Accessor<string | null>;\n  isLoading: Accessor<boolean>;\n  error: Accessor<Error | null>;\n  refetch: () => void;\n}\n\ninterface CacheEntry {\n  url: string;\n  refCount: number;\n}\n\nconst downloadCache = new Map<string, CacheEntry>();\nconst inflightRequests = new Map<string, Promise<string | null>>();\n\nfunction cacheKey(bucket: string, path: string): string {\n  return `${bucket}:${path}`;\n}\n\nfunction releaseEntry(key: string): void {\n  const entry = downloadCache.get(key);\n  if (!entry) return;\n  entry.refCount--;\n  if (entry.refCount <= 0) {\n    URL.revokeObjectURL(entry.url);\n    downloadCache.delete(key);\n  }\n}\n\nexport function useDownloadFile<S extends SchemaStructure>(\n  bucketName: BucketNames<S>,\n  path: Accessor<string | null | undefined>,\n  options?: UseDownloadFileOptions,\n): UseDownloadFileResult;\nexport function useDownloadFile<S extends SchemaStructure>(\n  db: SyncedDb<S>,\n  bucketName: BucketNames<S>,\n  path: Accessor<string | null | undefined>,\n  options?: UseDownloadFileOptions,\n): UseDownloadFileResult;\nexport function useDownloadFile<S extends SchemaStructure>(\n  dbOrBucketName: SyncedDb<S> | BucketNames<S>,\n  bucketNameOrPath?: BucketNames<S> | Accessor<string | null | undefined>,\n  pathOrOptions?: Accessor<string | null | undefined> | UseDownloadFileOptions,\n  maybeOptions?: UseDownloadFileOptions,\n): UseDownloadFileResult {\n  let db: SyncedDb<S>;\n  let bucketName: BucketNames<S>;\n  let path: Accessor<string | null | undefined>;\n  let options: UseDownloadFileOptions;\n\n  if (typeof dbOrBucketName === 'string') {\n    db = useDb<S>();\n    bucketName = dbOrBucketName as BucketNames<S>;\n    path = bucketNameOrPath as Accessor<string | null | undefined>;\n    options = (pathOrOptions as UseDownloadFileOptions) ?? {};\n  } else {\n    db = dbOrBucketName as SyncedDb<S>;\n    bucketName = bucketNameOrPath as BucketNames<S>;\n    path = pathOrOptions as Accessor<string | null | undefined>;\n    options = maybeOptions ?? {};\n  }\n\n  const useCache = options.cache !== false;\n\n  const [url, setUrl] = createSignal<string | null>(null);\n  const [isLoading, setIsLoading] = createSignal(false);\n  const [error, setError] = createSignal<Error | null>(null);\n\n  let currentKey: string | null = null;\n  let privateUrl: string | null = null;\n  const [refetchSignal, setRefetchSignal] = createSignal(0);\n  const refetchTrigger = () => setRefetchSignal((n) => n + 1);\n\n  async function doDownload(key: string, filePath: string): Promise<string | null> {\n    if (useCache) {\n      // Check cache\n      const cached = downloadCache.get(key);\n      if (cached) {\n        cached.refCount++;\n        currentKey = key;\n        return cached.url;\n      }\n\n      // Check inflight\n      const inflight = inflightRequests.get(key);\n      if (inflight) {\n        const result = await inflight;\n        if (result) {\n          const entry = downloadCache.get(key);\n          if (entry) {\n            entry.refCount++;\n            currentKey = key;\n          }\n        }\n        return result;\n      }\n\n      // Start new download\n      const promise = (async () => {\n        const content = await db.bucket(bucketName).get(filePath);\n        if (!content) return null;\n        const objectUrl = URL.createObjectURL(new Blob([content as BlobPart]));\n        downloadCache.set(key, { url: objectUrl, refCount: 1 });\n        return objectUrl;\n      })();\n\n      inflightRequests.set(key, promise);\n      try {\n        const result = await promise;\n        currentKey = key;\n        return result;\n      } finally {\n        inflightRequests.delete(key);\n      }\n    } else {\n      // No caching — private URL per instance\n      const content = await db.bucket(bucketName).get(filePath);\n      if (!content) return null;\n      const objectUrl = URL.createObjectURL(new Blob([content as BlobPart]));\n      privateUrl = objectUrl;\n      return objectUrl;\n    }\n  }\n\n  function releaseCurrentEntry() {\n    if (useCache && currentKey) {\n      releaseEntry(currentKey);\n      currentKey = null;\n    }\n    if (!useCache && privateUrl) {\n      URL.revokeObjectURL(privateUrl);\n      privateUrl = null;\n    }\n  }\n\n  createEffect(() => {\n    const filePath = path();\n    // Subscribe to refetch signal so effect re-runs\n    refetchSignal();\n\n    // Release previous entry\n    releaseCurrentEntry();\n\n    if (!filePath) {\n      setUrl(null);\n      setIsLoading(false);\n      setError(null);\n      return;\n    }\n\n    const key = cacheKey(bucketName as string, filePath);\n\n    // Synchronous cache hit\n    if (useCache) {\n      const cached = downloadCache.get(key);\n      if (cached) {\n        cached.refCount++;\n        currentKey = key;\n        setUrl(cached.url);\n        setIsLoading(false);\n        setError(null);\n        return;\n      }\n    }\n\n    let cancelled = false;\n    setIsLoading(true);\n    setError(null);\n\n    doDownload(key, filePath).then(\n      (result) => {\n        if (!cancelled) {\n          setUrl(result);\n          setIsLoading(false);\n        }\n        return undefined;\n      },\n      (err) => {\n        if (!cancelled) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n          setIsLoading(false);\n        }\n      },\n    );\n\n    onCleanup(() => {\n      cancelled = true;\n    });\n  });\n\n  onCleanup(() => {\n    releaseCurrentEntry();\n  });\n\n  const refetch = () => {\n    // Evict current entry from cache before re-triggering\n    if (useCache && currentKey) {\n      const entry = downloadCache.get(currentKey);\n      if (entry) {\n        URL.revokeObjectURL(entry.url);\n        downloadCache.delete(currentKey);\n      }\n      currentKey = null;\n    }\n    refetchTrigger();\n  };\n\n  return { url, isLoading, error, refetch };\n}\n","import type { JSX} from 'solid-js';\nimport { createSignal, onMount, createComponent, createMemo, mergeProps } from 'solid-js';\nimport type { SchemaStructure } from '@spooky/query-builder';\nimport type { SyncedDbConfig } from '../types';\nimport { SyncedDb } from '../index';\nimport { Sp00kyContext } from './context';\n\nexport interface Sp00kyProviderProps<S extends SchemaStructure> {\n  config: SyncedDbConfig<S>;\n  fallback?: JSX.Element;\n  onError?: (error: Error) => void;\n  onReady?: (db: SyncedDb<S>) => void;\n  children: JSX.Element;\n}\n\nexport function Sp00kyProvider<S extends SchemaStructure>(\n  props: Sp00kyProviderProps<S>\n): JSX.Element {\n  const merged = mergeProps(\n    {\n      fallback: undefined as JSX.Element | undefined,\n    },\n    props\n  );\n\n  const [db, setDb] = createSignal<SyncedDb<S> | undefined>(undefined);\n\n  onMount(async () => {\n    try {\n      const instance = new SyncedDb<S>(merged.config);\n      await instance.init();\n      setDb(() => instance);\n      merged.onReady?.(instance);\n    } catch (e) {\n      const error = e instanceof Error ? e : new Error(String(e));\n      if (merged.onError) {\n        merged.onError(error);\n      } else {\n        // oxlint-disable-next-line no-console\n        console.error('Sp00kyProvider: Failed to initialize database', error);\n      }\n    }\n  });\n\n  const content = createMemo(() => {\n    const instance = db();\n    if (!instance) return merged.fallback;\n    return createComponent(Sp00kyContext.Provider, {\n      value: instance,\n      get children() {\n        return merged.children;\n      },\n    });\n  });\n\n  return content as unknown as JSX.Element;\n}\n","import type { SyncedDbConfig } from './types';\nimport {\n  Sp00kyClient,\n  type Sp00kyQueryResultPromise,\n  type AuthService,\n  type BucketHandle,\n  type UpdateOptions,\n  type RunOptions,\n  type SyncHealth,\n} from '@spooky-sync/core';\n\nimport type {\n  GetTable,\n  QueryBuilder,\n  SchemaStructure,\n  TableModel,\n  TableNames,\n  QueryResult,\n  RelatedFieldsMap,\n  RelationshipFieldsFromSchema,\n  GetRelationship,\n  RelatedFieldMapEntry,\n  InnerQuery,\n  BackendNames,\n  BackendRoutes,\n  RoutePayload,\n  BucketNames,\n  BucketDefinitionSchema,\n  QueryModifier,\n  QueryModifierBuilder,\n  QueryInfo,\n  RelationshipsMetadata,\n  RelationshipDefinition,\n  InferRelatedModelFromMetadata,\n  GetCardinality,\n} from '@spooky-sync/query-builder';\n\nimport { RecordId, Uuid, type Surreal } from 'surrealdb';\nexport { RecordId, Uuid };\nexport type { Model, GenericModel, GenericSchema, ModelPayload } from './lib/models';\nexport { useQuery } from './lib/use-query';\nexport { useSyncStatus, type UseSyncStatus } from './lib/use-sync-status';\nexport type { SyncHealth, SyncHealthStatus, SyncHealthConfig } from '@spooky-sync/core';\nexport { useCrdtField } from './lib/use-crdt-field';\nexport { useFeatureFlag, type UseFeatureFlag } from './lib/use-feature-flag';\nexport { useFileUpload, type FileUploadResult } from './lib/use-file-upload';\nexport { useDownloadFile, type UseDownloadFileOptions, type UseDownloadFileResult } from './lib/use-download-file';\nexport { Sp00kyProvider, type Sp00kyProviderProps } from './lib/Sp00kyProvider';\nexport { useDb } from './lib/context';\n\n// export { AuthEventTypes } from \"@spooky-sync/core\"; // TODO: Verify if AuthEventTypes exists in core\n\n\n// Re-export query builder types for convenience\nexport type {\n  QueryModifier,\n  QueryModifierBuilder,\n  QueryInfo,\n  RelationshipsMetadata,\n  RelationshipDefinition,\n  InferRelatedModelFromMetadata,\n  GetCardinality,\n  GetTable,\n  TableModel,\n  TableNames,\n  QueryResult,\n};\n\nexport type RelationshipField<\n  Schema extends SchemaStructure,\n  TableName extends TableNames<Schema>,\n  Field extends RelationshipFieldsFromSchema<Schema, TableName>,\n> = GetRelationship<Schema, TableName, Field>;\n\nexport type RelatedFieldsTableScoped<\n  Schema extends SchemaStructure,\n  TableName extends TableNames<Schema>,\n  RelatedFields extends RelationshipFieldsFromSchema<Schema, TableName> =\n    RelationshipFieldsFromSchema<Schema, TableName>,\n> = {\n  [K in RelatedFields]: {\n    to: RelationshipField<Schema, TableName, K>['to'];\n    relatedFields: RelatedFieldsMap;\n    cardinality: RelationshipField<Schema, TableName, K>['cardinality'];\n  };\n};\n\nexport type InferModel<\n  Schema extends SchemaStructure,\n  TableName extends TableNames<Schema>,\n  RelatedFields extends RelatedFieldsTableScoped<Schema, TableName>,\n> = QueryResult<Schema, TableName, RelatedFields, true>;\n\nexport type WithRelated<Field extends string, RelatedFields extends RelatedFieldsMap = {}> = {\n  [K in Field]: Omit<RelatedFieldMapEntry, 'relatedFields'> & {\n    relatedFields: RelatedFields;\n  };\n};\n\nexport type WithRelatedMany<Field extends string, RelatedFields extends RelatedFieldsMap = {}> = {\n  [K in Field]: {\n    to: Field;\n    relatedFields: RelatedFields;\n    cardinality: 'many';\n  };\n};\n\n/**\n * SyncedDb - A thin wrapper around sp00ky-ts for Solid.js integration\n * Delegates all logic to the underlying sp00ky-ts instance\n */\nexport class SyncedDb<S extends SchemaStructure> {\n  private config: SyncedDbConfig<S>;\n  private sp00ky: Sp00kyClient<S> | null = null;\n  private _initialized = false;\n\n  constructor(config: SyncedDbConfig<S>) {\n    this.config = config;\n  }\n\n  public getSp00ky(): Sp00kyClient<S> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky;\n  }\n\n  /**\n   * Initialize the sp00ky-ts instance\n   */\n  async init(): Promise<void> {\n    if (this._initialized) return;\n    this.sp00ky = new Sp00kyClient<S>(this.config);\n    await this.sp00ky.init();\n    this._initialized = true;\n  }\n\n  /**\n   * Create a new record in the database\n   */\n  async create(id: string, payload: Record<string, unknown>): Promise<void> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    await this.sp00ky.create(id, payload as Record<string, unknown>);\n  }\n\n  /**\n   * Update an existing record in the database\n   */\n  async update<TName extends TableNames<S>>(\n    tableName: TName,\n    recordId: string,\n    payload: Partial<TableModel<GetTable<S, TName>>>,\n    options?: UpdateOptions\n  ): Promise<void> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    await this.sp00ky.update(\n      tableName as string,\n      recordId,\n      payload as Record<string, unknown>,\n      options\n    );\n  }\n\n  /**\n   * Delete an existing record in the database\n   */\n  async delete<TName extends TableNames<S>>(\n    tableName: TName,\n    selector: string | RecordId | InnerQuery<GetTable<S, TName>, boolean>\n  ): Promise<void> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    // Accept a `\"table:id\"` string OR a RecordId — live-query rows carry their\n    // `id` as a RecordId, so callers can pass `db.delete('game', row.id)`\n    // directly. Build the canonical string from the raw id part (not\n    // `RecordId.toString()`, which escapes special chars) so it round-trips\n    // through the engine's `parseRecordIdString`. InnerQuery selectors are not\n    // supported yet. (cross-package RecordId instances → match by constructor name.)\n    const isRecordId =\n      selector instanceof RecordId || (selector as any)?.constructor?.name === 'RecordId';\n    let id: string;\n    if (typeof selector === 'string') {\n      id = selector;\n    } else if (isRecordId) {\n      id = `${tableName as string}:${(selector as RecordId).id}`;\n    } else {\n      throw new Error('Only string ID or RecordId selectors are supported currently with core');\n    }\n    await this.sp00ky.delete(tableName as string, id);\n  }\n\n  /**\n   * Query data from the database\n   */\n  public query<TName extends TableNames<S>>(\n    table: TName\n  ): QueryBuilder<S, TName, Sp00kyQueryResultPromise, {}, false> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.query(table, {});\n  }\n\n  /**\n   * Run a backend operation\n   */\n  public async run<\n    B extends BackendNames<S>,\n    R extends BackendRoutes<S, B>,\n  >(\n    backend: B,\n    path: R,\n    payload: RoutePayload<S, B, R>,\n    options?: RunOptions,\n  ): Promise<void> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    await this.sp00ky.run(backend, path, payload, options);\n  }\n\n  /**\n   * Authenticate with the database\n   */\n  public async authenticate(token: string): Promise<RecordId<string>> {\n    await this.sp00ky?.authenticate(token);\n    // Sp00kyClient.authenticate returns whatever remote.authenticate returns (boolean or token usually?)\n    // Wait, checked Sp00kyClient: return this.remote.getClient().authenticate(token);\n    // SurrealDB authenticate returns void? or token?\n    // Assuming void or token.\n    return new RecordId('user', 'me'); // Placeholder or actual?\n  }\n\n  /**\n   * Deauthenticate from the database\n   * @deprecated Use signOut() instead\n   */\n  public async deauthenticate(): Promise<void> {\n    await this.signOut();\n  }\n\n  /**\n   * Sign out, clear session and local storage\n   */\n  public async signOut(): Promise<void> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    await this.sp00ky.auth.signOut();\n  }\n\n  /**\n   * Execute a function with direct access to the remote database connection\n   */\n  public async useRemote<T>(fn: (db: Surreal) => T | Promise<T>): Promise<T> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return await this.sp00ky.useRemote(fn);\n  }\n  /**\n   * Access the remote database service directly\n   */\n  get remote(): Sp00kyClient<S>['remoteClient'] {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.remoteClient;\n  }\n\n  /**\n   * Access the local database service directly\n   */\n  get local(): Sp00kyClient<S>['localClient'] {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.localClient;\n  }\n\n  /**\n   * Access the auth service\n   */\n  get auth(): AuthService<S> {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.auth;\n  }\n\n  get pendingMutationCount(): number {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.pendingMutationCount;\n  }\n\n  /** Diagnostic — see `Sp00kyClient.liveRetryCount`. */\n  get liveRetryCount(): number {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.liveRetryCount;\n  }\n\n  subscribeToPendingMutations(cb: (count: number) => void): () => void {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.subscribeToPendingMutations(cb);\n  }\n\n  /** Current sync-health snapshot. See {@link useSyncStatus}. */\n  get syncHealth(): SyncHealth {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.syncHealth;\n  }\n\n  /**\n   * Observe sync health. Fires immediately with the current status and again\n   * on every healthy↔degraded transition. Prefer the `useSyncStatus` hook in\n   * components; this is the imperative escape hatch.\n   */\n  subscribeToSyncHealth(cb: (health: SyncHealth) => void): () => void {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.subscribeToSyncHealth(cb);\n  }\n\n  bucket<B extends BucketNames<S>>(name: B): BucketHandle {\n    if (!this.sp00ky) throw new Error('SyncedDb not initialized');\n    return this.sp00ky.bucket(name);\n  }\n\n  getBucketConfig(name: string): BucketDefinitionSchema | undefined {\n    return this.config.schema.buckets?.find((b) => b.name === name);\n  }\n}\n\nexport * from './types';\n"],"mappings":"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"}