silosdk 0.0.0 → 0.0.2

package/dist/source.cjs

@@ -0,0 +1,161 @@
+let expo_sqlite = require("expo-sqlite");
+
+//#region src/source/index.ts
+const sourceNames = /* @__PURE__ */ new Set();
+const sourceNamePattern = /^[A-Za-z][A-Za-z0-9_-]*$/;
+function source(name, defaults) {
+	assertSourceName(name);
+	assertFlatDefaults(name, defaults);
+	if (sourceNames.has(name)) throw new Error(`Source "${name}" is already registered. Define each source once and import the existing source instead.`);
+	sourceNames.add(name);
+	const schema = createSourceSchema(name, defaults);
+	return {
+		name,
+		defaults,
+		schema,
+		collectionOptions(options = {}) {
+			return {
+				id: name,
+				getKey: (item) => item.id,
+				schema,
+				startSync: options.startSync,
+				sync: { sync({ begin, write, commit, markReady, truncate }) {
+					const rows = loadRows(name);
+					begin();
+					truncate();
+					for (const row of rows) write({
+						type: "insert",
+						value: row
+					});
+					commit();
+					markReady();
+				} },
+				onInsert: async ({ transaction }) => {
+					await insertRows(name, transaction.mutations.map((mutation) => mutation.modified));
+				},
+				onUpdate: async ({ transaction }) => {
+					await updateRows(name, transaction.mutations);
+				},
+				onDelete: async ({ transaction }) => {
+					await deleteRows(name, transaction.mutations.map((mutation) => mutation.key));
+				}
+			};
+		}
+	};
+}
+function assertSourceName(name) {
+	if (!sourceNamePattern.test(name)) throw new Error(`Source names must start with a letter and contain only letters, numbers, underscores, or hyphens. Received "${name}".`);
+}
+function assertFlatDefaults(sourceName, defaults) {
+	for (const [field, defaultValue] of Object.entries(defaults)) if (!isFieldValue(resolveDefault(defaultValue))) throw new Error(`Source "${sourceName}" field "${field}" must default to a string, number, boolean, null, or a function returning one of those values.`);
+}
+function createSourceSchema(sourceName, defaults) {
+	return { "~standard": {
+		version: 1,
+		vendor: "silo",
+		validate(value) {
+			if (!isRecord(value)) return failure("Expected a flat source row object.");
+			if (typeof value.id !== "string") return failure("Expected source row field \"id\" to be a string.", ["id"]);
+			const row = { id: value.id };
+			for (const [field, fieldValue] of Object.entries(value)) {
+				if (field === "id") continue;
+				if (!isFieldValue(fieldValue)) return failure(`Source "${sourceName}" field "${field}" must be a string, number, boolean, or null.`, [field]);
+				row[field] = fieldValue;
+			}
+			for (const [field, defaultValue] of Object.entries(defaults)) {
+				if (field in row) continue;
+				row[field] = resolveDefault(defaultValue);
+			}
+			return { value: row };
+		}
+	} };
+}
+function resolveDefault(value) {
+	const resolved = typeof value === "function" ? value() : value;
+	if (!isFieldValue(resolved)) throw new Error("Source defaults must resolve to a string, number, boolean, or null.");
+	return resolved;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFieldValue(value) {
+	return typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null;
+}
+function failure(message, path) {
+	return { issues: [{
+		message,
+		path
+	}] };
+}
+let database;
+function getDatabase() {
+	if (!database) {
+		database = (0, expo_sqlite.openDatabaseSync)("silo.db");
+		database.execSync(`
+      PRAGMA journal_mode = WAL;
+
+      CREATE TABLE IF NOT EXISTS sources (
+        source TEXT NOT NULL,
+        id TEXT NOT NULL,
+        data TEXT NOT NULL,
+        createdAt TEXT NOT NULL,
+        updatedAt TEXT NOT NULL,
+        version INTEGER NOT NULL DEFAULT 1,
+        PRIMARY KEY (source, id)
+      );
+    `);
+	}
+	return database;
+}
+function loadRows(sourceName) {
+	return getDatabase().getAllSync(`SELECT id, data FROM sources WHERE source = ?`, [sourceName]).map((row) => ({
+		id: row.id,
+		...JSON.parse(row.data)
+	}));
+}
+function insertRows(sourceName, rows) {
+	const db = getDatabase();
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	db.withTransactionSync(() => {
+		for (const row of rows) {
+			const { id, ...data } = row;
+			db.runSync(`INSERT INTO sources (source, id, data, createdAt, updatedAt, version)
+         VALUES (?, ?, ?, ?, ?, 1)`, [
+				sourceName,
+				id,
+				JSON.stringify(data),
+				timestamp,
+				timestamp
+			]);
+		}
+	});
+	return Promise.resolve();
+}
+function updateRows(sourceName, mutations) {
+	const db = getDatabase();
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	db.withTransactionSync(() => {
+		for (const mutation of mutations) {
+			const { id, ...data } = mutation.modified;
+			db.runSync(`UPDATE sources
+         SET data = ?, updatedAt = ?, version = version + 1
+         WHERE source = ? AND id = ?`, [
+				JSON.stringify(data),
+				timestamp,
+				sourceName,
+				String(mutation.key)
+			]);
+		}
+	});
+	return Promise.resolve();
+}
+function deleteRows(sourceName, ids) {
+	const db = getDatabase();
+	db.withTransactionSync(() => {
+		for (const id of ids) db.runSync(`DELETE FROM sources WHERE source = ? AND id = ?`, [sourceName, String(id)]);
+	});
+	return Promise.resolve();
+}
+
+//#endregion
+exports.source = source;

package/dist/source.d.cts

@@ -0,0 +1,29 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { CollectionConfig } from "@tanstack/react-db";
+
+//#region src/source/index.d.ts
+type FieldValue = string | number | boolean | null;
+type OptionalKeys<T extends object> = { [K in keyof T]-?: object extends Pick<T, K> ? K : never }[keyof T];
+type RequiredKeys<T extends object> = Exclude<keyof T, OptionalKeys<T>>;
+type InvalidDocumentKeys<T extends object> = { [K in keyof T]-?: Exclude<T[K], undefined> extends FieldValue ? never : K }[keyof T];
+type DocumentData<T extends object> = InvalidDocumentKeys<T> extends never ? T : never;
+type DefaultValue<T> = Exclude<T, undefined> | (() => Exclude<T, undefined>);
+type SourceDefaults<T extends object> = { [K in RequiredKeys<DocumentData<T>>]: DefaultValue<DocumentData<T>[K]> } & { [K in OptionalKeys<DocumentData<T>>]?: DefaultValue<DocumentData<T>[K]> };
+type SourceRow<T extends object> = {
+  id: string;
+} & DocumentData<T>;
+type SourceInput<T extends object> = {
+  id: string;
+} & Partial<DocumentData<T>>;
+type SourceCollectionOptions<T extends object> = {
+  startSync?: boolean;
+};
+type Source<T extends object> = {
+  readonly name: string;
+  readonly defaults: SourceDefaults<T>;
+  readonly schema: StandardSchemaV1<SourceInput<T>, SourceRow<T>>;
+  collectionOptions(options?: SourceCollectionOptions<T>): CollectionConfig<SourceRow<T>, string, StandardSchemaV1<SourceInput<T>, SourceRow<T>>>;
+};
+declare function source<T extends object>(name: string, defaults: SourceDefaults<T>): Source<T>;
+//#endregion
+export { DefaultValue, DocumentData, FieldValue, Source, SourceCollectionOptions, SourceDefaults, SourceInput, SourceRow, source };

package/dist/source.d.mts

@@ -0,0 +1,29 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { CollectionConfig } from "@tanstack/react-db";
+
+//#region src/source/index.d.ts
+type FieldValue = string | number | boolean | null;
+type OptionalKeys<T extends object> = { [K in keyof T]-?: object extends Pick<T, K> ? K : never }[keyof T];
+type RequiredKeys<T extends object> = Exclude<keyof T, OptionalKeys<T>>;
+type InvalidDocumentKeys<T extends object> = { [K in keyof T]-?: Exclude<T[K], undefined> extends FieldValue ? never : K }[keyof T];
+type DocumentData<T extends object> = InvalidDocumentKeys<T> extends never ? T : never;
+type DefaultValue<T> = Exclude<T, undefined> | (() => Exclude<T, undefined>);
+type SourceDefaults<T extends object> = { [K in RequiredKeys<DocumentData<T>>]: DefaultValue<DocumentData<T>[K]> } & { [K in OptionalKeys<DocumentData<T>>]?: DefaultValue<DocumentData<T>[K]> };
+type SourceRow<T extends object> = {
+  id: string;
+} & DocumentData<T>;
+type SourceInput<T extends object> = {
+  id: string;
+} & Partial<DocumentData<T>>;
+type SourceCollectionOptions<T extends object> = {
+  startSync?: boolean;
+};
+type Source<T extends object> = {
+  readonly name: string;
+  readonly defaults: SourceDefaults<T>;
+  readonly schema: StandardSchemaV1<SourceInput<T>, SourceRow<T>>;
+  collectionOptions(options?: SourceCollectionOptions<T>): CollectionConfig<SourceRow<T>, string, StandardSchemaV1<SourceInput<T>, SourceRow<T>>>;
+};
+declare function source<T extends object>(name: string, defaults: SourceDefaults<T>): Source<T>;
+//#endregion
+export { DefaultValue, DocumentData, FieldValue, Source, SourceCollectionOptions, SourceDefaults, SourceInput, SourceRow, source };

package/dist/source.mjs

@@ -0,0 +1,161 @@
+import { openDatabaseSync } from "expo-sqlite";
+
+//#region src/source/index.ts
+const sourceNames = /* @__PURE__ */ new Set();
+const sourceNamePattern = /^[A-Za-z][A-Za-z0-9_-]*$/;
+function source(name, defaults) {
+	assertSourceName(name);
+	assertFlatDefaults(name, defaults);
+	if (sourceNames.has(name)) throw new Error(`Source "${name}" is already registered. Define each source once and import the existing source instead.`);
+	sourceNames.add(name);
+	const schema = createSourceSchema(name, defaults);
+	return {
+		name,
+		defaults,
+		schema,
+		collectionOptions(options = {}) {
+			return {
+				id: name,
+				getKey: (item) => item.id,
+				schema,
+				startSync: options.startSync,
+				sync: { sync({ begin, write, commit, markReady, truncate }) {
+					const rows = loadRows(name);
+					begin();
+					truncate();
+					for (const row of rows) write({
+						type: "insert",
+						value: row
+					});
+					commit();
+					markReady();
+				} },
+				onInsert: async ({ transaction }) => {
+					await insertRows(name, transaction.mutations.map((mutation) => mutation.modified));
+				},
+				onUpdate: async ({ transaction }) => {
+					await updateRows(name, transaction.mutations);
+				},
+				onDelete: async ({ transaction }) => {
+					await deleteRows(name, transaction.mutations.map((mutation) => mutation.key));
+				}
+			};
+		}
+	};
+}
+function assertSourceName(name) {
+	if (!sourceNamePattern.test(name)) throw new Error(`Source names must start with a letter and contain only letters, numbers, underscores, or hyphens. Received "${name}".`);
+}
+function assertFlatDefaults(sourceName, defaults) {
+	for (const [field, defaultValue] of Object.entries(defaults)) if (!isFieldValue(resolveDefault(defaultValue))) throw new Error(`Source "${sourceName}" field "${field}" must default to a string, number, boolean, null, or a function returning one of those values.`);
+}
+function createSourceSchema(sourceName, defaults) {
+	return { "~standard": {
+		version: 1,
+		vendor: "silo",
+		validate(value) {
+			if (!isRecord(value)) return failure("Expected a flat source row object.");
+			if (typeof value.id !== "string") return failure("Expected source row field \"id\" to be a string.", ["id"]);
+			const row = { id: value.id };
+			for (const [field, fieldValue] of Object.entries(value)) {
+				if (field === "id") continue;
+				if (!isFieldValue(fieldValue)) return failure(`Source "${sourceName}" field "${field}" must be a string, number, boolean, or null.`, [field]);
+				row[field] = fieldValue;
+			}
+			for (const [field, defaultValue] of Object.entries(defaults)) {
+				if (field in row) continue;
+				row[field] = resolveDefault(defaultValue);
+			}
+			return { value: row };
+		}
+	} };
+}
+function resolveDefault(value) {
+	const resolved = typeof value === "function" ? value() : value;
+	if (!isFieldValue(resolved)) throw new Error("Source defaults must resolve to a string, number, boolean, or null.");
+	return resolved;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFieldValue(value) {
+	return typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value === null;
+}
+function failure(message, path) {
+	return { issues: [{
+		message,
+		path
+	}] };
+}
+let database;
+function getDatabase() {
+	if (!database) {
+		database = openDatabaseSync("silo.db");
+		database.execSync(`
+      PRAGMA journal_mode = WAL;
+
+      CREATE TABLE IF NOT EXISTS sources (
+        source TEXT NOT NULL,
+        id TEXT NOT NULL,
+        data TEXT NOT NULL,
+        createdAt TEXT NOT NULL,
+        updatedAt TEXT NOT NULL,
+        version INTEGER NOT NULL DEFAULT 1,
+        PRIMARY KEY (source, id)
+      );
+    `);
+	}
+	return database;
+}
+function loadRows(sourceName) {
+	return getDatabase().getAllSync(`SELECT id, data FROM sources WHERE source = ?`, [sourceName]).map((row) => ({
+		id: row.id,
+		...JSON.parse(row.data)
+	}));
+}
+function insertRows(sourceName, rows) {
+	const db = getDatabase();
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	db.withTransactionSync(() => {
+		for (const row of rows) {
+			const { id, ...data } = row;
+			db.runSync(`INSERT INTO sources (source, id, data, createdAt, updatedAt, version)
+         VALUES (?, ?, ?, ?, ?, 1)`, [
+				sourceName,
+				id,
+				JSON.stringify(data),
+				timestamp,
+				timestamp
+			]);
+		}
+	});
+	return Promise.resolve();
+}
+function updateRows(sourceName, mutations) {
+	const db = getDatabase();
+	const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+	db.withTransactionSync(() => {
+		for (const mutation of mutations) {
+			const { id, ...data } = mutation.modified;
+			db.runSync(`UPDATE sources
+         SET data = ?, updatedAt = ?, version = version + 1
+         WHERE source = ? AND id = ?`, [
+				JSON.stringify(data),
+				timestamp,
+				sourceName,
+				String(mutation.key)
+			]);
+		}
+	});
+	return Promise.resolve();
+}
+function deleteRows(sourceName, ids) {
+	const db = getDatabase();
+	db.withTransactionSync(() => {
+		for (const id of ids) db.runSync(`DELETE FROM sources WHERE source = ? AND id = ?`, [sourceName, String(id)]);
+	});
+	return Promise.resolve();
+}
+
+//#endregion
+export { source };

package/package.json

@@ -1,5 +1,56 @@
 {
   "name": "silosdk",
-  "version": "0.0.0",
-  "packageManager": "yarn@4.9.2"
+  "version": "0.0.2",
+  "type": "module",
+  "scripts": {
+    "build": "tsdown",
+    "watch": "tsdown --watch",
+    "test": "vitest run",
+    "publish": "tsdown && npm publish"
+  },
+  "packageManager": "yarn@1.22.22",
+  "files": [
+    "dist/"
+  ],
+  "devDependencies": {
+    "@tanstack/react-db": "^0.1.86",
+    "@tanstack/react-query": "^5.101.0",
+    "@types/node": "^25.3.0",
+    "@types/react": "^19",
+    "expo-sqlite": "*",
+    "prettier": "^3.7.4",
+    "react-native": "0.85.0",
+    "tsdown": "^0.17.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.0.0",
+    "@tanstack/react-db": "^0.1.86",
+    "@tanstack/react-query": "^5.101.0",
+    "nanoid": "5.1.6"
+  },
+  "peerDependencies": {
+    "expo-sqlite": "*",
+    "react": "^19",
+    "react-native": "0.85.x"
+  },
+  "prettier": {
+    "semi": false,
+    "singleQuote": true,
+    "trailingComma": "all",
+    "printWidth": 80,
+    "tabWidth": 2
+  },
+  "main": "./dist/source.cjs",
+  "module": "./dist/source.mjs",
+  "types": "./dist/source.d.cts",
+  "exports": {
+    "./source": {
+      "types": "./dist/source.d.mts",
+      "import": "./dist/source.mjs",
+      "require": "./dist/source.cjs"
+    },
+    "./package.json": "./package.json"
+  }
 }

package/README.md

@@ -1 +0,0 @@
-# silosdk