silosdk 0.0.9 → 0.0.10

package/dist/media/storage.web.mjs

@@ -0,0 +1,78 @@
+import { createIndexedDbOpener, requestResult, transactionDone } from "../internal/indexed-db.mjs";
+import { createMediaRef, extensionForMimeType } from "./shared.mjs";
+import { randomUUID } from "expo-crypto";
+
+//#region src/media/storage.web.ts
+const objectUrls = /* @__PURE__ */ new Map();
+const mediaStorage = {
+	importMedia,
+	resolveMediaUri,
+	deleteMedia
+};
+const openSiloMediaIndexedDb = createIndexedDbOpener("silo-media", 1, (db) => {
+	if (!db.objectStoreNames.contains("media_files")) db.createObjectStore("media_files", { keyPath: "ref" });
+	if (!db.objectStoreNames.contains("media_blobs")) db.createObjectStore("media_blobs", { keyPath: "ref" });
+});
+async function importMedia(input) {
+	const id = randomUUID();
+	const ref = createMediaRef(input.kind, id);
+	const blob = await (await fetch(input.uri)).blob();
+	const name = input.name ?? `${id}${extensionForMimeType(input.mimeType ?? blob.type)}`;
+	const mimeType = input.mimeType ?? (blob.type || null);
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	const transaction = (await openSiloMediaIndexedDb()).transaction(["media_files", "media_blobs"], "readwrite");
+	transaction.objectStore("media_files").put({
+		ref,
+		uri: ref,
+		kind: input.kind,
+		name,
+		mimeType,
+		size: blob.size,
+		createdAt: timestamp,
+		data: JSON.stringify(input.data ?? {})
+	});
+	transaction.objectStore("media_blobs").put({
+		ref,
+		blob
+	});
+	await transactionDone(transaction);
+	const uri = URL.createObjectURL(blob);
+	objectUrls.set(ref, uri);
+	return {
+		ref,
+		uri
+	};
+}
+async function resolveMediaUri(ref) {
+	const existingUrl = objectUrls.get(ref);
+	if (existingUrl) return existingUrl;
+	const transaction = (await openSiloMediaIndexedDb()).transaction("media_blobs", "readonly");
+	const done = transactionDone(transaction);
+	const row = await requestResult(transaction.objectStore("media_blobs").get(ref));
+	await done;
+	if (!row) return null;
+	const uri = URL.createObjectURL(row.blob);
+	objectUrls.set(ref, uri);
+	return uri;
+}
+async function deleteMedia(ref) {
+	const db = await openSiloMediaIndexedDb();
+	const readTransaction = db.transaction("media_files", "readonly");
+	const readDone = transactionDone(readTransaction);
+	const existing = await requestResult(readTransaction.objectStore("media_files").get(ref));
+	await readDone;
+	if (!existing) return false;
+	const transaction = db.transaction(["media_files", "media_blobs"], "readwrite");
+	transaction.objectStore("media_files").delete(ref);
+	transaction.objectStore("media_blobs").delete(ref);
+	await transactionDone(transaction);
+	const objectUrl = objectUrls.get(ref);
+	if (objectUrl) {
+		URL.revokeObjectURL(objectUrl);
+		objectUrls.delete(ref);
+	}
+	return true;
+}
+
+//#endregion
+export { mediaStorage };

package/dist/media.cjs

@@ -1,167 +1,9 @@
-const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
-let expo_crypto = require("expo-crypto");
-let expo_sqlite = require("expo-sqlite");
-let __tanstack_react_query = require("@tanstack/react-query");
-let expo_file_system = require("expo-file-system");
+const require_shared = require('./media/shared.cjs');
+const require_storage_native = require('./media/storage.native.cjs');
 
-//#region src/media/index.ts
-const media = {
-	queryOptions(ref) {
-		return (0, __tanstack_react_query.queryOptions)({
-			queryKey: mediaQueryKey(ref),
-			queryFn: () => resolveMediaUri(ref)
-		});
-	},
-	mutationOptions(options = {}) {
-		return (0, __tanstack_react_query.mutationOptions)({
-			mutationKey: [
-				"silo",
-				"media",
-				"import"
-			],
-			mutationFn: async (input) => {
-				const imported = await importMedia(input);
-				options.queryClient?.setQueryData(mediaQueryKey(imported.ref), imported.uri);
-				return imported.ref;
-			}
-		});
-	},
-	delete(ref) {
-		return deleteMedia(ref);
-	},
-	deleteMutationOptions(options = {}) {
-		return (0, __tanstack_react_query.mutationOptions)({
-			mutationKey: [
-				"silo",
-				"media",
-				"delete"
-			],
-			mutationFn: async (ref) => {
-				const deleted = await deleteMedia(ref);
-				if (isMediaRef(ref)) options.queryClient?.setQueryData(mediaQueryKey(ref), null);
-				return deleted;
-			}
-		});
-	}
-};
-function isMediaRef(value) {
-	return typeof value === "string" && value.startsWith("media://");
-}
-function mediaQueryKey(ref) {
-	return [
-		"silo",
-		"media",
-		ref ?? null
-	];
-}
-async function importMedia(input) {
-	assertMediaKind(input.kind);
-	const id = (0, expo_crypto.randomUUID)();
-	const ref = createMediaRef(input.kind, id);
-	const source = new expo_file_system.File(input.uri);
-	const name = input.name ?? source.name ?? `${id}${source.extension}`;
-	const destinationDirectory = mediaDirectory(input.kind);
-	destinationDirectory.create({
-		idempotent: true,
-		intermediates: true
-	});
-	const destination = new expo_file_system.File(destinationDirectory, `${id}${extensionFor(name)}`);
-	await source.copy(destination);
-	const info = destination.info();
-	const mimeType = input.mimeType ?? (destination.type || null);
-	const size = info.size ?? destination.size;
-	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-	insertMediaFile({
-		ref,
-		uri: destination.uri,
-		kind: input.kind,
-		name,
-		mimeType,
-		size,
-		createdAt: timestamp,
-		data: input.data ?? {}
-	});
-	return {
-		ref,
-		uri: destination.uri
-	};
-}
-function resolveMediaUri(ref) {
-	if (!isMediaRef(ref)) return null;
-	const row = getMediaFile(ref);
-	if (!row) return null;
-	return new expo_file_system.File(row.uri).exists ? row.uri : null;
-}
-async function deleteMedia(ref) {
-	if (!isMediaRef(ref)) return false;
-	const row = getMediaFile(ref);
-	if (!row) return false;
-	const file = new expo_file_system.File(row.uri);
-	if (file.exists) await file.delete();
-	deleteMediaFileRow(ref);
-	return true;
-}
-function getMediaFile(ref) {
-	return getDatabase().getFirstSync(`SELECT ref, uri FROM media_files WHERE ref = ?`, [ref]);
-}
-function createMediaRef(kind, id) {
-	return `media://silo/${kindDirectoryName(kind)}/${id}`;
-}
-function mediaDirectory(kind) {
-	return new expo_file_system.Directory(expo_file_system.Paths.document, "silo", "media", kindDirectoryName(kind));
-}
-function kindDirectoryName(kind) {
-	switch (kind) {
-		case "image": return "images";
-		case "video": return "videos";
-		case "audio": return "audio";
-		case "file": return "files";
-	}
-}
-function extensionFor(name) {
-	return name.match(/\.[A-Za-z0-9]+$/)?.[0] ?? "";
-}
-function assertMediaKind(kind) {
-	if (kind !== "image" && kind !== "video" && kind !== "audio" && kind !== "file") throw new Error("Media kind must be one of \"image\", \"video\", \"audio\", or \"file\".");
-}
-let database;
-function getDatabase() {
-	if (!database) {
-		database = (0, expo_sqlite.openDatabaseSync)("silo.db");
-		database.execSync(`
-      PRAGMA journal_mode = WAL;
-
-      CREATE TABLE IF NOT EXISTS media_files (
-        ref TEXT PRIMARY KEY,
-        uri TEXT NOT NULL,
-        kind TEXT NOT NULL,
-        name TEXT NOT NULL,
-        mimeType TEXT,
-        size INTEGER NOT NULL,
-        createdAt TEXT NOT NULL,
-        data TEXT NOT NULL
-      );
-    `);
-	}
-	return database;
-}
-function insertMediaFile(file) {
-	getDatabase().runSync(`INSERT INTO media_files (ref, uri, kind, name, mimeType, size, createdAt, data)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
-		file.ref,
-		file.uri,
-		file.kind,
-		file.name,
-		file.mimeType,
-		file.size,
-		file.createdAt,
-		JSON.stringify(file.data)
-	]);
-}
-function deleteMediaFileRow(ref) {
-	getDatabase().runSync(`DELETE FROM media_files WHERE ref = ?`, [ref]);
-}
+//#region src/media/index.native.ts
+const media = require_shared.createMediaApi(require_storage_native.mediaStorage);
 
 //#endregion
-exports.isMediaRef = isMediaRef;
+exports.isMediaRef = require_shared.isMediaRef;
 exports.media = media;

package/dist/media.d.cts

@@ -1,32 +1,12 @@
-import { QueryClient, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+import { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef } from "./media/shared.cjs";
+import * as _tanstack_react_query2 from "@tanstack/react-query";
 
-//#region src/media/index.d.ts
-type MediaRef = `media://${string}`;
-type MediaKind = 'image' | 'video' | 'audio' | 'file';
-type MediaJson = string | number | boolean | null | MediaJson[] | {
-  [key: string]: MediaJson;
-};
-type MediaData = {
-  [key: string]: MediaJson;
-};
-type MediaImportInput = {
-  uri: string;
-  kind: MediaKind;
-  name?: string;
-  mimeType?: string | null;
-  data?: MediaData;
-};
-type MediaDeleteInput = MediaRef | string | null | undefined;
-type MediaQueryKey = readonly ['silo', 'media', MediaRef | string | null];
-type MediaMutationOptions = {
-  queryClient?: QueryClient;
-};
+//#region src/media/index.native.d.ts
 declare const media: {
-  queryOptions(ref: MediaRef | string | null | undefined): UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
-  mutationOptions(options?: MediaMutationOptions): UseMutationOptions<MediaRef, Error, MediaImportInput>;
+  queryOptions(ref: MediaRef | string | null | undefined): _tanstack_react_query2.UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
+  mutationOptions(options?: MediaMutationOptions): _tanstack_react_query2.UseMutationOptions<MediaRef, Error, MediaImportInput>;
   delete(ref: MediaDeleteInput): Promise<boolean>;
-  deleteMutationOptions(options?: MediaMutationOptions): UseMutationOptions<boolean, Error, MediaDeleteInput>;
+  deleteMutationOptions(options?: MediaMutationOptions): _tanstack_react_query2.UseMutationOptions<boolean, Error, MediaDeleteInput>;
 };
-declare function isMediaRef(value: unknown): value is MediaRef;
 //#endregion
-export { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef, media };
+export { type MediaData, type MediaDeleteInput, type MediaImportInput, type MediaJson, type MediaKind, type MediaMutationOptions, type MediaQueryKey, type MediaRef, isMediaRef, media };

package/dist/media.d.mts

@@ -1,32 +1,12 @@
-import { QueryClient, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+import { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef } from "./media/shared.mjs";
+import * as _tanstack_react_query2 from "@tanstack/react-query";
 
-//#region src/media/index.d.ts
-type MediaRef = `media://${string}`;
-type MediaKind = 'image' | 'video' | 'audio' | 'file';
-type MediaJson = string | number | boolean | null | MediaJson[] | {
-  [key: string]: MediaJson;
-};
-type MediaData = {
-  [key: string]: MediaJson;
-};
-type MediaImportInput = {
-  uri: string;
-  kind: MediaKind;
-  name?: string;
-  mimeType?: string | null;
-  data?: MediaData;
-};
-type MediaDeleteInput = MediaRef | string | null | undefined;
-type MediaQueryKey = readonly ['silo', 'media', MediaRef | string | null];
-type MediaMutationOptions = {
-  queryClient?: QueryClient;
-};
+//#region src/media/index.native.d.ts
 declare const media: {
-  queryOptions(ref: MediaRef | string | null | undefined): UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
-  mutationOptions(options?: MediaMutationOptions): UseMutationOptions<MediaRef, Error, MediaImportInput>;
+  queryOptions(ref: MediaRef | string | null | undefined): _tanstack_react_query2.UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
+  mutationOptions(options?: MediaMutationOptions): _tanstack_react_query2.UseMutationOptions<MediaRef, Error, MediaImportInput>;
   delete(ref: MediaDeleteInput): Promise<boolean>;
-  deleteMutationOptions(options?: MediaMutationOptions): UseMutationOptions<boolean, Error, MediaDeleteInput>;
+  deleteMutationOptions(options?: MediaMutationOptions): _tanstack_react_query2.UseMutationOptions<boolean, Error, MediaDeleteInput>;
 };
-declare function isMediaRef(value: unknown): value is MediaRef;
 //#endregion
-export { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef, media };
+export { type MediaData, type MediaDeleteInput, type MediaImportInput, type MediaJson, type MediaKind, type MediaMutationOptions, type MediaQueryKey, type MediaRef, isMediaRef, media };

package/dist/media.mjs

@@ -1,165 +1,8 @@
-import { randomUUID } from "expo-crypto";
-import { openDatabaseSync } from "expo-sqlite";
-import { mutationOptions, queryOptions } from "@tanstack/react-query";
-import { Directory, File, Paths } from "expo-file-system";
+import { createMediaApi, isMediaRef } from "./media/shared.mjs";
+import { mediaStorage } from "./media/storage.native.mjs";
 
-//#region src/media/index.ts
-const media = {
-	queryOptions(ref) {
-		return queryOptions({
-			queryKey: mediaQueryKey(ref),
-			queryFn: () => resolveMediaUri(ref)
-		});
-	},
-	mutationOptions(options = {}) {
-		return mutationOptions({
-			mutationKey: [
-				"silo",
-				"media",
-				"import"
-			],
-			mutationFn: async (input) => {
-				const imported = await importMedia(input);
-				options.queryClient?.setQueryData(mediaQueryKey(imported.ref), imported.uri);
-				return imported.ref;
-			}
-		});
-	},
-	delete(ref) {
-		return deleteMedia(ref);
-	},
-	deleteMutationOptions(options = {}) {
-		return mutationOptions({
-			mutationKey: [
-				"silo",
-				"media",
-				"delete"
-			],
-			mutationFn: async (ref) => {
-				const deleted = await deleteMedia(ref);
-				if (isMediaRef(ref)) options.queryClient?.setQueryData(mediaQueryKey(ref), null);
-				return deleted;
-			}
-		});
-	}
-};
-function isMediaRef(value) {
-	return typeof value === "string" && value.startsWith("media://");
-}
-function mediaQueryKey(ref) {
-	return [
-		"silo",
-		"media",
-		ref ?? null
-	];
-}
-async function importMedia(input) {
-	assertMediaKind(input.kind);
-	const id = randomUUID();
-	const ref = createMediaRef(input.kind, id);
-	const source = new File(input.uri);
-	const name = input.name ?? source.name ?? `${id}${source.extension}`;
-	const destinationDirectory = mediaDirectory(input.kind);
-	destinationDirectory.create({
-		idempotent: true,
-		intermediates: true
-	});
-	const destination = new File(destinationDirectory, `${id}${extensionFor(name)}`);
-	await source.copy(destination);
-	const info = destination.info();
-	const mimeType = input.mimeType ?? (destination.type || null);
-	const size = info.size ?? destination.size;
-	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-	insertMediaFile({
-		ref,
-		uri: destination.uri,
-		kind: input.kind,
-		name,
-		mimeType,
-		size,
-		createdAt: timestamp,
-		data: input.data ?? {}
-	});
-	return {
-		ref,
-		uri: destination.uri
-	};
-}
-function resolveMediaUri(ref) {
-	if (!isMediaRef(ref)) return null;
-	const row = getMediaFile(ref);
-	if (!row) return null;
-	return new File(row.uri).exists ? row.uri : null;
-}
-async function deleteMedia(ref) {
-	if (!isMediaRef(ref)) return false;
-	const row = getMediaFile(ref);
-	if (!row) return false;
-	const file = new File(row.uri);
-	if (file.exists) await file.delete();
-	deleteMediaFileRow(ref);
-	return true;
-}
-function getMediaFile(ref) {
-	return getDatabase().getFirstSync(`SELECT ref, uri FROM media_files WHERE ref = ?`, [ref]);
-}
-function createMediaRef(kind, id) {
-	return `media://silo/${kindDirectoryName(kind)}/${id}`;
-}
-function mediaDirectory(kind) {
-	return new Directory(Paths.document, "silo", "media", kindDirectoryName(kind));
-}
-function kindDirectoryName(kind) {
-	switch (kind) {
-		case "image": return "images";
-		case "video": return "videos";
-		case "audio": return "audio";
-		case "file": return "files";
-	}
-}
-function extensionFor(name) {
-	return name.match(/\.[A-Za-z0-9]+$/)?.[0] ?? "";
-}
-function assertMediaKind(kind) {
-	if (kind !== "image" && kind !== "video" && kind !== "audio" && kind !== "file") throw new Error("Media kind must be one of \"image\", \"video\", \"audio\", or \"file\".");
-}
-let database;
-function getDatabase() {
-	if (!database) {
-		database = openDatabaseSync("silo.db");
-		database.execSync(`
-      PRAGMA journal_mode = WAL;
-
-      CREATE TABLE IF NOT EXISTS media_files (
-        ref TEXT PRIMARY KEY,
-        uri TEXT NOT NULL,
-        kind TEXT NOT NULL,
-        name TEXT NOT NULL,
-        mimeType TEXT,
-        size INTEGER NOT NULL,
-        createdAt TEXT NOT NULL,
-        data TEXT NOT NULL
-      );
-    `);
-	}
-	return database;
-}
-function insertMediaFile(file) {
-	getDatabase().runSync(`INSERT INTO media_files (ref, uri, kind, name, mimeType, size, createdAt, data)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
-		file.ref,
-		file.uri,
-		file.kind,
-		file.name,
-		file.mimeType,
-		file.size,
-		file.createdAt,
-		JSON.stringify(file.data)
-	]);
-}
-function deleteMediaFileRow(ref) {
-	getDatabase().runSync(`DELETE FROM media_files WHERE ref = ?`, [ref]);
-}
+//#region src/media/index.native.ts
+const media = createMediaApi(mediaStorage);
 
 //#endregion
 export { isMediaRef, media };

package/dist/media.web.cjs

@@ -0,0 +1,9 @@
+const require_shared = require('./media/shared.cjs');
+const require_storage_web = require('./media/storage.web.cjs');
+
+//#region src/media/index.web.ts
+const media = require_shared.createMediaApi(require_storage_web.mediaStorage);
+
+//#endregion
+exports.isMediaRef = require_shared.isMediaRef;
+exports.media = media;

package/dist/media.web.d.cts

@@ -0,0 +1,12 @@
+import { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef } from "./media/shared.cjs";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/media/index.web.d.ts
+declare const media: {
+  queryOptions(ref: MediaRef | string | null | undefined): _tanstack_react_query0.UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
+  mutationOptions(options?: MediaMutationOptions): _tanstack_react_query0.UseMutationOptions<MediaRef, Error, MediaImportInput>;
+  delete(ref: MediaDeleteInput): Promise<boolean>;
+  deleteMutationOptions(options?: MediaMutationOptions): _tanstack_react_query0.UseMutationOptions<boolean, Error, MediaDeleteInput>;
+};
+//#endregion
+export { type MediaData, type MediaDeleteInput, type MediaImportInput, type MediaJson, type MediaKind, type MediaMutationOptions, type MediaQueryKey, type MediaRef, isMediaRef, media };

package/dist/media.web.d.mts

@@ -0,0 +1,12 @@
+import { MediaData, MediaDeleteInput, MediaImportInput, MediaJson, MediaKind, MediaMutationOptions, MediaQueryKey, MediaRef, isMediaRef } from "./media/shared.mjs";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/media/index.web.d.ts
+declare const media: {
+  queryOptions(ref: MediaRef | string | null | undefined): _tanstack_react_query0.UseQueryOptions<string | null, Error, string | null, MediaQueryKey>;
+  mutationOptions(options?: MediaMutationOptions): _tanstack_react_query0.UseMutationOptions<MediaRef, Error, MediaImportInput>;
+  delete(ref: MediaDeleteInput): Promise<boolean>;
+  deleteMutationOptions(options?: MediaMutationOptions): _tanstack_react_query0.UseMutationOptions<boolean, Error, MediaDeleteInput>;
+};
+//#endregion
+export { type MediaData, type MediaDeleteInput, type MediaImportInput, type MediaJson, type MediaKind, type MediaMutationOptions, type MediaQueryKey, type MediaRef, isMediaRef, media };

package/dist/media.web.mjs

@@ -0,0 +1,8 @@
+import { createMediaApi, isMediaRef } from "./media/shared.mjs";
+import { mediaStorage } from "./media/storage.web.mjs";
+
+//#region src/media/index.web.ts
+const media = createMediaApi(mediaStorage);
+
+//#endregion
+export { isMediaRef, media };

package/dist/settings/shared.cjs

@@ -0,0 +1,63 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __tanstack_react_query = require("@tanstack/react-query");
+
+//#region src/settings/shared.ts
+const settingNames = /* @__PURE__ */ new Set();
+const settingNamePattern = /^[A-Za-z][A-Za-z0-9_.:-]*$/;
+function createSettingApi(storage) {
+	function setting(name, defaultValue) {
+		assertSettingName(name);
+		assertSettingValue(resolveDefault(defaultValue));
+		if (settingNames.has(name)) throw new Error(`Setting "${name}" is already registered. Define each setting once and import the existing setting instead.`);
+		settingNames.add(name);
+		const queryKey = [
+			"silo",
+			"setting",
+			name
+		];
+		return {
+			name,
+			defaultValue,
+			queryKey,
+			queryOptions() {
+				return (0, __tanstack_react_query.queryOptions)({
+					queryKey,
+					queryFn: () => storage.read(name, defaultValue)
+				});
+			},
+			mutationOptions(options = {}) {
+				return (0, __tanstack_react_query.mutationOptions)({
+					mutationKey: queryKey,
+					mutationFn: async (valueOrUpdater) => {
+						const current = await storage.read(name, defaultValue);
+						const next = typeof valueOrUpdater === "function" ? valueOrUpdater(current) : valueOrUpdater;
+						await storage.write(name, next);
+						return next;
+					},
+					onSuccess(value) {
+						options.queryClient?.setQueryData(queryKey, value);
+					}
+				});
+			}
+		};
+	}
+	return { setting };
+}
+function storageKey(name) {
+	return `silo:setting:${name}`;
+}
+function resolveDefault(defaultValue) {
+	return typeof defaultValue === "function" ? defaultValue() : defaultValue;
+}
+function assertSettingValue(value) {
+	if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean" && value !== null) throw new Error("Settings must be strings, numbers, booleans, or null.");
+}
+function assertSettingName(name) {
+	if (!settingNamePattern.test(name)) throw new Error(`Setting names must start with a letter and contain only letters, numbers, underscores, dots, colons, or hyphens. Received "${name}".`);
+}
+
+//#endregion
+exports.assertSettingValue = assertSettingValue;
+exports.createSettingApi = createSettingApi;
+exports.resolveDefault = resolveDefault;
+exports.storageKey = storageKey;

package/dist/settings/shared.d.cts

@@ -0,0 +1,19 @@
+import { QueryClient, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+
+//#region src/settings/shared.d.ts
+type SettingValue = string | number | boolean | null;
+type SettingDefault<T extends SettingValue> = T | (() => T);
+type SettingMutation<T extends SettingValue> = T | ((current: T) => T);
+type SettingQueryKey = readonly ['silo', 'setting', string];
+type SettingMutationOptions = {
+  queryClient?: QueryClient;
+};
+type Setting<T extends SettingValue> = {
+  readonly name: string;
+  readonly defaultValue: SettingDefault<T>;
+  readonly queryKey: SettingQueryKey;
+  queryOptions(): UseQueryOptions<T, Error, T, SettingQueryKey>;
+  mutationOptions(options?: SettingMutationOptions): UseMutationOptions<T, Error, SettingMutation<T>>;
+};
+//#endregion
+export { Setting, SettingDefault, SettingMutation, SettingMutationOptions, SettingQueryKey, SettingValue };

package/dist/settings/shared.d.mts

@@ -0,0 +1,19 @@
+import { QueryClient, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
+
+//#region src/settings/shared.d.ts
+type SettingValue = string | number | boolean | null;
+type SettingDefault<T extends SettingValue> = T | (() => T);
+type SettingMutation<T extends SettingValue> = T | ((current: T) => T);
+type SettingQueryKey = readonly ['silo', 'setting', string];
+type SettingMutationOptions = {
+  queryClient?: QueryClient;
+};
+type Setting<T extends SettingValue> = {
+  readonly name: string;
+  readonly defaultValue: SettingDefault<T>;
+  readonly queryKey: SettingQueryKey;
+  queryOptions(): UseQueryOptions<T, Error, T, SettingQueryKey>;
+  mutationOptions(options?: SettingMutationOptions): UseMutationOptions<T, Error, SettingMutation<T>>;
+};
+//#endregion
+export { Setting, SettingDefault, SettingMutation, SettingMutationOptions, SettingQueryKey, SettingValue };