@byearlybird/starling 0.2.2 → 0.4.0

package/dist/index.d.ts

@@ -14,19 +14,20 @@ declare namespace value_d_exports {
   export { EncodedValue, decode$3 as decode, encode$3 as encode, isEncoded, merge$2 as merge };
 }
 type EncodedValue<T$1> = {
-  __value: T$1;
-  __eventstamp: string;
+  "~value": T$1;
+  "~eventstamp": string;
 };
 declare const encode$3: <T>(value: T, eventstamp: string) => EncodedValue<T>;
 declare const decode$3: <T>(value: EncodedValue<T>) => T;
 declare const merge$2: <T>(into: EncodedValue<T>, from: EncodedValue<T>) => EncodedValue<T>;
 declare const isEncoded: (value: unknown) => boolean;
 declare namespace record_d_exports {
-  export { EncodedRecord, decode$2 as decode, encode$2 as encode, merge$1 as merge };
+  export { EncodedRecord, decode$2 as decode, encode$2 as encode, isObject, merge$1 as merge };
 }
 type EncodedRecord = {
   [key: string]: EncodedValue<unknown> | EncodedRecord;
 };
+declare const isObject: (value: unknown) => boolean;
 declare const encode$2: <T extends Record<string, unknown>>(obj: T, eventstamp: string) => EncodedRecord;
 declare const decode$2: <T extends Record<string, unknown>>(obj: EncodedRecord) => T;
 declare const merge$1: (into: EncodedRecord, from: EncodedRecord) => EncodedRecord;
@@ -35,11 +36,11 @@ declare namespace document_d_exports {
 }
 type EncodedDocument = {
   "~id": string;
-  "~data": EncodedRecord;
+  "~data": EncodedValue<unknown> | EncodedRecord;
   "~deletedAt": string | null;
 };
-declare const encode$1: <T extends record_d_exports<string, unknown>>(id: string, obj: T, eventstamp: string, deletedAt?: string | null) => EncodedDocument;
-declare const decode$1: <T extends record_d_exports<string, unknown>>(doc: EncodedDocument) => {
+declare const encode$1: <T>(id: string, obj: T, eventstamp: string, deletedAt?: string | null) => EncodedDocument;
+declare const decode$1: <T>(doc: EncodedDocument) => {
   "~id": string;
   "~data": T;
   "~deletedAt": string | null;
@@ -74,19 +75,19 @@ declare const create$1: (iterable?: Iterable<readonly [string, EncodedDocument]>
   };
 };
 declare namespace store_d_exports {
-  export { Plugin, PluginHandle, Store as StarlingStore, StoreHooks, StoreOnBeforeDelete, StoreOnBeforePatch, StoreOnBeforePut, StoreOnDelete, StoreOnPatch, StoreOnPut, StoreTransaction, create };
+  export { Plugin, PluginHandle, PluginMethods, Store as StarlingStore, StoreHooks, StoreOnBeforeDelete, StoreOnBeforePatch, StoreOnBeforePut, StoreOnDelete, StoreOnPatch, StoreOnPut, StoreTransaction, create };
 }
 type DeepPartial<T$1> = T$1 extends object ? { [P in keyof T$1]?: DeepPartial<T$1[P]> } : T$1;
 /**
  * Called once per commit with all put operations accumulated as decoded entries.
  * Only fires if at least one put occurred.
  */
-type StoreOnPut<T$1 extends Record<string, unknown>> = (entries: ReadonlyArray<readonly [string, T$1]>) => void;
+type StoreOnPut<T$1> = (entries: ReadonlyArray<readonly [string, T$1]>) => void;
 /**
  * Called once per commit with all patch operations accumulated as decoded entries.
  * Only fires if at least one patch occurred.
  */
-type StoreOnPatch<T$1 extends Record<string, unknown>> = (entries: ReadonlyArray<readonly [string, T$1]>) => void;
+type StoreOnPatch<T$1> = (entries: ReadonlyArray<readonly [string, T$1]>) => void;
 /**
  * Called once per commit with all deleted keys (IDs).
  * Only fires if at least one delete occurred.
@@ -96,12 +97,12 @@ type StoreOnDelete = (keys: ReadonlyArray<string>) => void;
  * Called before a put operation is applied.
  * Throws to reject the operation.
  */
-type StoreOnBeforePut<T$1 extends Record<string, unknown>> = (key: string, value: T$1) => void;
+type StoreOnBeforePut<T$1> = (key: string, value: T$1) => void;
 /**
  * Called before a patch operation is applied.
  * Throws to reject the operation.
  */
-type StoreOnBeforePatch<T$1 extends Record<string, unknown>> = (key: string, value: DeepPartial<T$1>) => void;
+type StoreOnBeforePatch<T$1> = (key: string, value: DeepPartial<T$1>) => void;
 /**
  * Called before a delete operation is applied.
  * Throws to reject the operation.
@@ -112,7 +113,7 @@ type StoreOnBeforeDelete = (key: string) => void;
  * Hooks fire on commit only, never during staged operations.
  * Arrays are readonly to prevent external mutation.
  */
-type StoreHooks<T$1 extends Record<string, unknown>> = {
+type StoreHooks<T$1> = {
   onBeforePut?: StoreOnBeforePut<T$1>;
   onBeforePatch?: StoreOnBeforePatch<T$1>;
   onBeforeDelete?: StoreOnBeforeDelete;
@@ -120,7 +121,7 @@ type StoreHooks<T$1 extends Record<string, unknown>> = {
   onPatch?: StoreOnPatch<T$1>;
   onDelete?: StoreOnDelete;
 };
-type StoreTransaction<T$1 extends Record<string, unknown>> = {
+type StoreTransaction<T$1> = {
   put: (key: string, value: T$1) => void;
   patch: (key: string, value: DeepPartial<T$1>) => void;
   merge: (doc: EncodedDocument) => void;
@@ -131,13 +132,15 @@ type StoreTransaction<T$1 extends Record<string, unknown>> = {
   }) => void;
   rollback: () => void;
 };
-type PluginHandle<T$1 extends Record<string, unknown>> = {
+type PluginMethods = Record<string, (...args: any[]) => any>;
+type PluginHandle<T$1, M$1 extends PluginMethods = {}> = {
   init: () => Promise<void> | void;
   dispose: () => Promise<void> | void;
   hooks?: StoreHooks<T$1>;
+  methods?: M$1;
 };
-type Plugin<T$1 extends Record<string, unknown>> = (store: Store<T$1>) => PluginHandle<T$1>;
-type Store<T$1 extends Record<string, unknown>> = {
+type Plugin<T$1, M$1 extends PluginMethods = {}> = (store: Store<T$1, any>) => PluginHandle<T$1, M$1>;
+type Store<T$1, Extended = {}> = {
   get: (key: string) => T$1 | null;
   has: (key: string) => boolean;
   readonly size: number;
@@ -148,10 +151,10 @@ type Store<T$1 extends Record<string, unknown>> = {
   patch: (key: string, value: DeepPartial<T$1>) => void;
   del: (key: string) => void;
   begin: () => StoreTransaction<T$1>;
-  use: (plugin: Plugin<T$1>) => Store<T$1>;
-  init: () => Promise<Store<T$1>>;
+  use: <M extends PluginMethods>(plugin: Plugin<T$1, M>) => Store<T$1, Extended & M>;
+  init: () => Promise<Store<T$1, Extended>>;
   dispose: () => Promise<void>;
-};
-declare const create: <T extends Record<string, unknown>>() => Store<T>;
+} & Extended;
+declare const create: <T>() => Store<T, {}>;
 //#endregion
 export { type clock_d_exports as Clock, document_d_exports as Document, eventstamp_d_exports as Eventstamp, kv_d_exports as KV, record_d_exports as Record, store_d_exports as Store, value_d_exports as Value };

package/dist/index.js

@@ -20,8 +20,8 @@ const decode$3 = (eventstamp) => {
 
 //#endregion
 //#region src/clock.ts
-var clock_exports = /* @__PURE__ */ __export({ create: () => create });
-const create = () => {
+var clock_exports = /* @__PURE__ */ __export({ create: () => create$2 });
+const create$2 = () => {
 	let counter = 0;
 	let lastMs = Date.now();
 	return {
@@ -56,21 +56,22 @@ var value_exports = /* @__PURE__ */ __export({
 	merge: () => merge$2
 });
 const encode$2 = (value, eventstamp) => ({
-	__value: value,
-	__eventstamp: eventstamp
+	"~value": value,
+	"~eventstamp": eventstamp
 });
-const decode$2 = (value) => value.__value;
+const decode$2 = (value) => value["~value"];
 const merge$2 = (into, from) => ({
-	__value: into.__eventstamp > from.__eventstamp ? into.__value : from.__value,
-	__eventstamp: into.__eventstamp > from.__eventstamp ? into.__eventstamp : from.__eventstamp
+	"~value": into["~eventstamp"] > from["~eventstamp"] ? into["~value"] : from["~value"],
+	"~eventstamp": into["~eventstamp"] > from["~eventstamp"] ? into["~eventstamp"] : from["~eventstamp"]
 });
-const isEncoded = (value) => !!(typeof value === "object" && value !== null && "__value" in value && "__eventstamp" in value);
+const isEncoded = (value) => !!(typeof value === "object" && value !== null && "~value" in value && "~eventstamp" in value);
 
 //#endregion
 //#region src/record.ts
 var record_exports = /* @__PURE__ */ __export({
 	decode: () => decode$1,
 	encode: () => encode$1,
+	isObject: () => isObject,
 	merge: () => merge$1
 });
 const isObject = (value) => !!(value != null && typeof value === "object" && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype);
@@ -139,19 +140,26 @@ var document_exports = /* @__PURE__ */ __export({
 });
 const encode = (id, obj, eventstamp, deletedAt = null) => ({
 	"~id": id,
-	"~data": encode$1(obj, eventstamp),
+	"~data": isObject(obj) ? encode$1(obj, eventstamp) : encode$2(obj, eventstamp),
 	"~deletedAt": deletedAt
 });
 const decode = (doc) => ({
 	"~id": doc["~id"],
-	"~data": decode$1(doc["~data"]),
+	"~data": isEncoded(doc["~data"]) ? decode$2(doc["~data"]) : decode$1(doc["~data"]),
 	"~deletedAt": doc["~deletedAt"]
 });
-const merge = (into, from) => ({
-	"~id": into["~id"],
-	"~data": merge$1(into["~data"], from["~data"]),
-	"~deletedAt": into["~deletedAt"] && from["~deletedAt"] ? into["~deletedAt"] > from["~deletedAt"] ? into["~deletedAt"] : from["~deletedAt"] : into["~deletedAt"] || from["~deletedAt"] || null
-});
+const merge = (into, from) => {
+	const intoIsValue = isEncoded(into["~data"]);
+	const fromIsValue = isEncoded(from["~data"]);
+	if (intoIsValue !== fromIsValue) throw new Error(`Cannot merge documents with incompatible types: ${intoIsValue ? "primitive" : "object"} vs ${fromIsValue ? "primitive" : "object"}`);
+	const mergedData = intoIsValue && fromIsValue ? merge$2(into["~data"], from["~data"]) : merge$1(into["~data"], from["~data"]);
+	const mergedDeletedAt = into["~deletedAt"] && from["~deletedAt"] ? into["~deletedAt"] > from["~deletedAt"] ? into["~deletedAt"] : from["~deletedAt"] : into["~deletedAt"] || from["~deletedAt"] || null;
+	return {
+		"~id": into["~id"],
+		"~data": mergedData,
+		"~deletedAt": mergedDeletedAt
+	};
+};
 const del = (doc, eventstamp) => ({
 	...doc,
 	"~deletedAt": eventstamp
@@ -159,8 +167,8 @@ const del = (doc, eventstamp) => ({
 
 //#endregion
 //#region src/kv.ts
-var kv_exports = /* @__PURE__ */ __export({ create: () => create$2 });
-const create$2 = (iterable) => {
+var kv_exports = /* @__PURE__ */ __export({ create: () => create$1 });
+const create$1 = (iterable) => {
 	let readMap = new Map(iterable);
 	function cloneMap(src) {
 		return new Map(src);
@@ -217,11 +225,11 @@ const create$2 = (iterable) => {
 
 //#endregion
 //#region src/store.ts
-var store_exports = /* @__PURE__ */ __export({ create: () => create$1 });
-const create$1 = () => {
-	const clock = create();
+var store_exports = /* @__PURE__ */ __export({ create: () => create });
+const create = () => {
+	const kv = create$1();
+	const clock = create$2();
 	const encodeValue = (key, value) => encode(key, value, clock.now());
-	const kv = create$2();
 	const listeners = {
 		beforePut: /* @__PURE__ */ new Set(),
 		beforePatch: /* @__PURE__ */ new Set(),
@@ -247,7 +255,7 @@ const create$1 = () => {
 			function* iterator() {
 				for (const doc of kv.values()) {
 					const data = decodeActive(doc);
-					if (data) yield data;
+					if (data !== null) yield data;
 				}
 			}
 			return iterator();
@@ -256,7 +264,7 @@ const create$1 = () => {
 			function* iterator() {
 				for (const [key, doc] of kv.entries()) {
 					const data = decodeActive(doc);
-					if (data) yield [key, data];
+					if (data !== null) yield [key, data];
 				}
 			}
 			return iterator();
@@ -332,7 +340,7 @@ const create$1 = () => {
 			};
 		},
 		use(plugin) {
-			const { hooks: pluginHooks, init, dispose } = plugin(this);
+			const { hooks: pluginHooks, init, dispose, methods } = plugin(this);
 			if (pluginHooks) {
 				if (pluginHooks.onBeforePut) {
 					const callback = pluginHooks.onBeforePut;
@@ -377,6 +385,7 @@ const create$1 = () => {
 					});
 				}
 			}
+			if (methods) Object.assign(this, methods);
 			initializers.add(init);
 			disposers.add(dispose);
 			return this;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@byearlybird/starling",
-	"version": "0.2.2",
+	"version": "0.4.0",
 	"type": "module",
 	"license": "MIT",
 	"main": "./dist/index.js",