@atolljs/core 0.1.6 → 0.1.8

package/dist/index6.js

@@ -1,491 +1,163 @@
-import { msgpackrCodec as e } from "./index2.js";
-import { fluent as t, z as n } from "./index3.js";
-import { memberToSpec as r, zodArrayInfo as i, zodObjectShape as a, zodStringBytes as o } from "./index4.js";
-import { fmtBytes as s, scoped as c } from "./index5.js";
-//#region src/contract/sharedMemory.ts
-var l = c("memory"), u = 8, d = (e, t) => e + t - 1 & ~(t - 1), f = (e) => d(e, u), p = (e) => typeof e == "object" && !!e && typeof e.kind == "string" && typeof e.byteLength == "number";
-function m(e) {
-	let t = [];
-	for (let [n, r] of Object.entries(e)) if (p(r)) t.push({
-		path: n,
-		descriptor: r
-	});
-	else for (let [e, i] of Object.entries(r)) {
-		if (!p(i)) throw TypeError(`shared memory "${n}.${e}" is not a field descriptor — intent groups nest one level only`);
-		t.push({
-			path: `${n}.${e}`,
-			descriptor: i
-		});
+import { emitDevtools as e, previewValue as t, registerDevtoolsCommand as n } from "./index5.js";
+//#region src/contract/memoryDevtools.ts
+var r = /* @__PURE__ */ new Map(), i = () => [], a = !1, o = 5, s = 16, c = (e) => {
+	let n = e;
+	if (typeof n.readAt == "function" && typeof n.recordCount == "number") {
+		let e = Array.from({ length: Math.min(o, n.recordCount) }, (e, t) => n.readAt(t));
+		return t({
+			records: n.recordCount,
+			head: e
+		}, 1024);
 	}
-	return t;
-}
-var h = new TextEncoder(), g = new TextDecoder(), _ = {
-	encode: (e) => h.encode(JSON.stringify(e)),
-	decode: (e) => JSON.parse(g.decode(e))
-}, v = /* @__PURE__ */ new Map();
-function y(e, t) {
-	v.set(e, t);
-}
-var b = {
-	i8: 1,
-	u8: 1,
-	i16: 2,
-	u16: 2,
-	i32: 4,
-	u32: 4,
-	f32: 4,
-	f64: 8,
-	i64: 8,
-	u64: 8
-}, x = (e) => typeof e == "string" ? b[e] : "string" in e ? e.string : 1, S = (e) => typeof e == "string" ? b[e] : 1;
-function C(e) {
-	let t = {}, n = {}, i = 0;
-	for (let a of Object.keys(e)) {
-		let o = r(e[a], String(a));
-		n[a] = o, i = d(i, S(o)), t[a] = i, i += x(o);
+	let r = e.read();
+	if (ArrayBuffer.isView(r) && !(r instanceof DataView)) {
+		let e = r, t = Array.from({ length: Math.min(s, e.length) }, (t, n) => typeof e[n] == "bigint" ? `${e[n]}n` : e[n]);
+		return `${r.constructor.name}(${e.length}) ${JSON.stringify(t)}${e.length > s ? "…" : ""}`;
 	}
-	return {
-		layout: n,
-		offsets: t,
-		recordSize: f(i)
+	return t(r, 1024);
+}, l = (e, t) => e.connector(t), u = (e) => e._version ? Atomics.load(e._version.view, e._version.index) : 0, d = (e) => {
+	try {
+		return JSON.parse(e);
+	} catch {
+		return e;
+	}
+}, f = (e) => typeof e == "number" ? e : typeof e == "bigint" ? Number(e) : null, p = (e) => {
+	let n = e.trim();
+	if (n === "change") return {
+		text: n,
+		test: () => !0
 	};
-}
-var w = {
-	number: () => ({
-		kind: "number",
-		byteLength: 8
-	}),
-	boolean: () => ({
-		kind: "boolean",
-		byteLength: 8
-	}),
-	string: (e) => {
-		let { schema: t, maxBytes: n } = e;
-		if (n !== void 0) return {
-			kind: "string",
-			byteLength: 4 + n,
-			schema: t
-		};
-		let r = t ? o(t) : null;
-		if (r !== null) return {
-			kind: "string",
-			byteLength: 4 + r,
-			schema: t
-		};
-		throw TypeError("field.string: pass { maxBytes } or a schema carrying a byte budget — reef.string(n) / z.string().meta({ bytes: n })");
-	},
-	object: (e) => {
-		let { schema: t, maxBytes: n } = e;
-		if (n === void 0 && t) {
-			let e = a(t);
-			if (e) {
-				let { layout: n, offsets: r, recordSize: i } = C(e);
-				return {
-					kind: "object",
-					byteLength: 8 + i,
-					schema: t,
-					layout: n,
-					offsets: r,
-					recordSize: i
-				};
-			}
-			throw TypeError("field.object: schema can't derive a fixed byte width (not a zod object of fixed-width members) — pass { maxBytes } for codec-encoded storage");
-		}
-		if (n === void 0) throw TypeError("field.object: pass { schema } for a fixed-layout field or { maxBytes } for a codec-encoded field");
-		return {
-			kind: "object",
-			byteLength: 4 + n,
-			schema: t
-		};
-	},
-	array: (e) => {
-		let { schema: t, maxBytes: n } = e;
-		if (n === void 0 && t) {
-			let e = i(t);
-			if (e) {
-				if (e.capacity === null) throw TypeError("field.array: z.array() needs .max(n) or .length(n) — bounded arrays are fixed-width");
-				let n;
-				try {
-					n = r(e.element, "array element");
-				} catch (e) {
-					throw TypeError(`field.array: element isn't a fixed-width member — use field.list for arrays of records (${e.message})`);
-				}
-				let i = d(x(n), S(n));
-				return {
-					kind: "array",
-					byteLength: 8 + e.capacity * i,
-					schema: t,
-					element: n,
-					elementStride: i,
-					capacity: e.capacity
-				};
-			}
-			throw TypeError("field.array: schema can't derive a fixed byte width (not a bounded zod array) — pass { maxBytes } for codec-encoded storage");
-		}
-		if (n === void 0) throw TypeError("field.array: pass { schema } for a fixed-layout field or { maxBytes } for a codec-encoded field");
-		return {
-			kind: "array",
-			byteLength: 4 + n,
-			schema: t
-		};
-	},
-	int32Array: ({ length: e }) => ({
-		kind: "Int32",
-		byteLength: e * 4
-	}),
-	float64Array: ({ length: e }) => ({
-		kind: "Float64",
-		byteLength: e * 8
-	}),
-	bigInt64Array: ({ length: e }) => ({
-		kind: "BigInt64",
-		byteLength: e * 8
-	}),
-	uint8Array: ({ length: e }) => ({
-		kind: "Uint8",
-		byteLength: e
-	}),
-	list: ({ schema: e, count: t }) => {
-		let n = a(e);
-		if (!n) throw TypeError("field.list: schema must be a reef.object() of fixed-width members");
-		let { layout: r, offsets: i, recordSize: o } = C(n);
+	let r = /^(>=|<=|==|!=|>|<)\s*(.+)$/.exec(n);
+	if (!r) throw Error(`memory.watch: bad rule '${e}' — use change, > n, < n, >= n, <= n, == v, != v`);
+	let [, i, a] = r;
+	if (i === "==" || i === "!=") {
+		let e = d(a), r = (n) => typeof n == "object" && n ? t(n) === t(e) : Object.is(n, e) || typeof n == "bigint" && Number(n) === e;
 		return {
-			kind: "list",
-			byteLength: o * t,
-			schema: e,
-			layout: r,
-			offsets: i,
-			recordSize: o,
-			count: t
+			text: n,
+			test: i === "==" ? r : (e) => !r(e)
 		};
 	}
-}, T = {
-	Int32: Int32Array,
-	Float64: Float64Array,
-	BigInt64: BigInt64Array,
-	Uint8: Uint8Array
-};
-y("number", (e, t, n) => {
-	let r = new Float64Array(t.buffer, n, 1);
-	return {
-		byteOffset: n,
-		byteLength: e.byteLength,
-		read: () => r[0],
-		write: (e) => {
-			r[0] = e;
-		}
+	let o = Number(a);
+	if (!Number.isFinite(o)) throw Error(`memory.watch: '${a}' is not a number`);
+	let s = {
+		">": (e) => e > o,
+		"<": (e) => e < o,
+		">=": (e) => e >= o,
+		"<=": (e) => e <= o
 	};
-}), y("boolean", (e, t, n) => {
-	let r = new Uint8Array(t.buffer, n, 1);
 	return {
-		byteOffset: n,
-		byteLength: e.byteLength,
-		read: () => r[0] === 1,
-		write: (e) => {
-			r[0] = +!!e;
+		text: n,
+		test: (e) => {
+			let t = f(e);
+			return t !== null && s[i](t);
 		}
 	};
-});
-for (let e of Object.keys(T)) y(e, (t, n, r) => {
-	let i = T[e], a = new i(n.buffer, r, t.byteLength / i.BYTES_PER_ELEMENT);
-	return {
-		byteOffset: r,
-		byteLength: t.byteLength,
-		read: () => a,
-		write: (e) => a.set(e)
-	};
-});
-y("string", (e, t, n) => {
-	let r = new TextEncoder(), i = new TextDecoder(), a = e.byteLength - 4, o = new Uint32Array(t.buffer, n, 1), s = (e) => {
-		if (e.byteLength > a) throw Error(`Encoded value of ${e.byteLength} bytes exceeds field capacity of ${a} bytes at offset ${n}`);
-		o[0] = e.byteLength, new Uint8Array(t.buffer, n + 4, e.byteLength).set(e);
-	}, c = () => new Uint8Array(t.buffer, n + 4, o[0]).slice();
-	return {
-		byteOffset: n,
-		byteLength: e.byteLength,
-		read: () => i.decode(c()),
-		write: (t) => s(r.encode(e.schema ? e.schema.parse(t) : t))
-	};
-});
-function E(e) {
-	let t = new DataView(e.buffer), n = new Uint8Array(e.buffer), r = new TextEncoder(), i = new TextDecoder(), a = {
-		i8: {
-			get: (e) => t.getInt8(e),
-			set: (e, n) => t.setInt8(e, n)
-		},
-		u8: {
-			get: (e) => t.getUint8(e),
-			set: (e, n) => t.setUint8(e, n)
-		},
-		i16: {
-			get: (e) => t.getInt16(e),
-			set: (e, n) => t.setInt16(e, n)
-		},
-		u16: {
-			get: (e) => t.getUint16(e),
-			set: (e, n) => t.setUint16(e, n)
-		},
-		i32: {
-			get: (e) => t.getInt32(e),
-			set: (e, n) => t.setInt32(e, n)
-		},
-		u32: {
-			get: (e) => t.getUint32(e),
-			set: (e, n) => t.setUint32(e, n)
-		},
-		f32: {
-			get: (e) => t.getFloat32(e),
-			set: (e, n) => t.setFloat32(e, n)
-		},
-		f64: {
-			get: (e) => t.getFloat64(e),
-			set: (e, n) => t.setFloat64(e, n)
-		},
-		i64: {
-			get: (e) => t.getBigInt64(e),
-			set: (e, n) => t.setBigInt64(e, n)
-		},
-		u64: {
-			get: (e) => t.getBigUint64(e),
-			set: (e, n) => t.setBigUint64(e, n)
-		}
-	}, o = (e, t) => {
-		let r = n.indexOf(0, e), a = r === -1 || r - e >= t ? t : r - e;
-		return i.decode(n.slice(e, e + a));
-	}, s = /* @__PURE__ */ new Uint8Array(64), c = (e, t, i) => {
-		s.length < t && (s = new Uint8Array(t));
-		let { read: a, written: o } = r.encodeInto(i, s);
-		if (a < i.length || o > t) throw Error(`String exceeds inline field capacity of ${t} bytes`);
-		n.set(s.subarray(0, o), e), o < t && n.fill(0, e + o, e + t);
-	}, l = (e) => {
-		if (typeof e == "string") {
-			let t = a[e];
-			return {
-				get: (e) => t.get(e),
-				set: (e, n) => t.set(e, n)
-			};
+}, m = (t, n, r, i, a) => {
+	let o = r.seen.get(t);
+	if (o && o.version >= a) return;
+	let s = r.rule.text === "change", l = typeof i.readAt == "function", u, d;
+	try {
+		d = c(i), u = s || l ? void 0 : i.read();
+	} catch {
+		return;
+	}
+	r.seen.set(t, {
+		version: a,
+		preview: d
+	}), (s ? d !== o?.preview : !l && r.rule.test(u)) && (r.hits++, e({
+		type: "memory:watch-hit",
+		path: n,
+		version: a,
+		value: d,
+		rule: r.rule.text
+	}));
+}, h = (e, t, n) => {
+	let i = r.get(t);
+	i && m(e, t, i, l(e, t), n);
+}, g = (e, t) => {
+	let n = !1, r = () => {
+		for (let n of i()) {
+			if (!n.bound) continue;
+			let r;
+			try {
+				r = l(n, e);
+			} catch {
+				continue;
+			}
+			m(n, e, t, r, u(r));
 		}
-		return "bool" in e ? {
-			get: (e) => !!t.getUint8(e),
-			set: (e, n) => t.setUint8(e, +!!n)
-		} : {
-			get: (t) => o(t, e.string),
-			set: (t, n) => c(t, e.string, n)
-		};
 	};
-	return {
-		ops: l,
-		compile: (e, t) => {
-			let n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
-			for (let i of Object.keys(e)) {
-				let { get: a, set: o } = l(e[i]), s = t[i];
-				n.set(i, (e, t) => {
-					t[i] = a(e + s);
-				}), r.set(i, (e, t) => o(e + s, t[i]));
-			}
-			let i = [...n.values()], a = [...r.values()];
-			return {
-				read(e, t = {}, r) {
-					if (r) for (let i of r) n.get(i)(e, t);
-					else for (let n of i) n(e, t);
-					return t;
-				},
-				write(e, t, n) {
-					if (n) for (let i of n) r.get(i)(e, t);
-					else for (let n of a) n(e, t);
+	if (typeof Atomics.waitAsync == "function") return (async () => {
+		for (; !n;) {
+			let t = i().find((t) => {
+				try {
+					return t.bound && l(t, e)._version !== void 0;
+				} catch {
+					return !1;
 				}
-			};
+			}), a = t ? l(t, e)._version : void 0;
+			if (a) {
+				let e = Atomics.waitAsync(a.view, a.index, Atomics.load(a.view, a.index), 250);
+				e.async && await e.value;
+			} else await new Promise((e) => setTimeout(e, 250));
+			n || r();
 		}
+	})(), () => {
+		n = !0;
 	};
-}
-var D = (e, t, n) => {
-	let { schema: r, byteLength: i, kind: a } = e, o = e;
-	if (o.layout && o.offsets && o.recordSize !== void 0) {
-		let e = new Uint32Array(t.buffer, n, 2), a = n + 8, s = E(t).compile(o.layout, o.offsets);
-		return {
-			byteOffset: n,
-			byteLength: i,
-			read: () => e[0] ? s.read(a, {}) : void 0,
-			write: (t) => {
-				s.write(a, r ? r.parse(t) : t), e[0] = 1;
-			}
-		};
-	}
-	if (o.element !== void 0 && o.elementStride !== void 0 && o.capacity !== void 0) {
-		let e = new Uint32Array(t.buffer, n, 1), a = new Uint32Array(t.buffer, n + 4, 1), s = E(t).ops(o.element), c = o.elementStride, l = o.capacity, u = n + 8;
-		return {
-			byteOffset: n,
-			byteLength: i,
-			read: () => {
-				if (!e[0]) return;
-				let t = a[0];
-				return Array.from({ length: t }, (e, t) => s.get(u + t * c));
-			},
-			write: (t) => {
-				let n = r ? r.parse(t) : t;
-				if (n.length > l) throw Error(`${n.length} elements exceeds array capacity of ${l}`);
-				n.forEach((e, t) => s.set(u + t * c, e)), a[0] = n.length, e[0] = 1;
+	let a = setInterval(r, 50);
+	return a.unref?.(), () => {
+		n = !0, clearInterval(a);
+	};
+}, _ = () => [...r.entries()].map(([e, t]) => ({
+	path: e,
+	rule: t.rule.text,
+	hits: t.hits
+})), v = (e) => {
+	i = e, !a && (a = !0, n("memory.read", () => {
+		let e = [];
+		return i().forEach((t, n) => {
+			if (t.bound) for (let { path: r } of t.fields()) try {
+				let i = l(t, r);
+				e.push({
+					path: r,
+					value: c(i),
+					version: u(i),
+					contract: n
+				});
+			} catch (t) {
+				e.push({
+					path: r,
+					value: `[unreadable: ${t.message}]`,
+					version: -1,
+					contract: n
+				});
 			}
+		}), e;
+	}), n("memory.watch", (e) => {
+		let t = String(e.path ?? "");
+		if (!t) throw Error("memory.watch: `path` is required");
+		if (!i().some((e) => e.fields().some((e) => e.path === t))) throw Error(`memory.watch: no contract defines a field '${t}'`);
+		let n = p(String(e.rule ?? "change"));
+		r.get(t)?.stop();
+		let a = {
+			rule: n,
+			seen: /* @__PURE__ */ new WeakMap(),
+			stop: () => {},
+			hits: 0
 		};
-	}
-	let s = i - 4, c = new Uint32Array(t.buffer, n, 1), l = (e) => {
-		if (e.byteLength > s) throw Error(`Encoded value of ${e.byteLength} bytes exceeds field capacity of ${s} bytes at offset ${n}`);
-		c[0] = e.byteLength, new Uint8Array(t.buffer, n + 4, e.byteLength).set(e);
-	}, u = () => new Uint8Array(t.buffer, n + 4, c[0]).slice();
-	return {
-		byteOffset: n,
-		byteLength: i,
-		read: () => {
-			let e = u();
-			if (e.byteLength === 0) return;
-			let n = t.codec.decode(e);
-			return r ? r.parse(n) : n;
-		},
-		write: (e) => l(t.codec.encode(r ? r.parse(e) : e))
-	};
-};
-y("object", D), y("array", D);
-function O(e, t, n) {
-	let r = e, { offsets: i, recordSize: a, count: o } = r, s = E(t).compile(r.layout, i), c = (e) => {
-		if (e < 0 || e >= o) throw RangeError(`Record index ${e} out of bounds (0..${o - 1})`);
-	}, l = (e, t = {}, r) => (c(e), s.read(n + e * a, t, r)), u = (e, t, r) => {
-		c(e), s.write(n + e * a, t, r);
-	};
-	return {
-		byteOffset: n,
-		byteLength: e.byteLength,
-		recordCount: o,
-		recordSize: a,
-		readAt: l,
-		writeAt: u,
-		commit: () => {
-			t.version && (Atomics.add(t.version.view, t.version.index, 1), Atomics.notify(t.version.view, t.version.index));
-		},
-		read: () => Array.from({ length: o }, (e, t) => l(t)),
-		write: (e) => {
-			if (e.length > o) throw Error(`${e.length} records exceeds list array capacity of ${o}`);
-			e.forEach((e, t) => u(t, e));
-		}
-	};
-}
-y("list", O);
-var k = [];
-function A(e) {
-	let t = {};
-	for (let [n, r] of Object.entries(e)) t[n] = p(r) ? j(r) : Object.fromEntries(Object.entries(r).map(([e, t]) => [e, j(t)]));
-	return t;
-}
-function j(e) {
-	if (e.schema) return e.schema;
-	switch (e.kind) {
-		case "number": return t(n.number());
-		case "boolean": return t(n.boolean());
-		case "string": return t(n.string());
-		case "Int32": return t(n.instanceof(Int32Array));
-		case "Float64": return t(n.instanceof(Float64Array));
-		case "BigInt64": return t(n.instanceof(BigInt64Array));
-		case "Uint8": return t(n.instanceof(Uint8Array));
-		default: return t(n.unknown());
-	}
-}
-var M = class {
-	totalBytes;
-	spec;
-	schemas;
-	codec;
-	plugins;
-	entries;
-	offsets = /* @__PURE__ */ new Map();
-	versionOffset;
-	connectors = /* @__PURE__ */ new Map();
-	boundListeners = /* @__PURE__ */ new Set();
-	isBound = !1;
-	boundBuffer;
-	constructor(t, n = {}) {
-		this.spec = t, this.codec = n.codec ?? e, this.plugins = n.plugins, this.entries = m(t), this.schemas = A(t);
-		let r = 0;
-		for (let { path: e, descriptor: t } of this.entries) r = f(r), this.offsets.set(e, r), r += t.byteLength;
-		this.versionOffset = f(r), this.totalBytes = this.versionOffset + f(this.entries.length * 4), k.push(this), l.info(`contract defined: ${this.entries.length} field(s), ${s(this.totalBytes)}`, {
-			fields: Object.fromEntries(this.entries.map((e) => [e.path, `${e.descriptor.kind}@${this.offsets.get(e.path)?.toLocaleString()}+${s(e.descriptor.byteLength)}`])),
-			pluginOverrides: Object.keys(this.plugins ?? {})
-		});
-	}
-	bind(e) {
-		this.connectors.clear();
-		let t = new Int32Array(e, this.versionOffset, this.entries.length);
-		this.entries.forEach(({ path: n, descriptor: r }, i) => {
-			let a = this.plugins?.[r.kind] ?? v.get(r.kind);
-			if (!a) throw Error(`Unknown shared memory field kind: ${r.kind}`);
-			l.debug(`bind "${n}" (${r.kind}, ${s(r.byteLength)}) via ${this.plugins?.[r.kind] ? "plugin" : "built-in"} factory`);
-			let o = a(r, {
-				buffer: e,
-				codec: this.codec,
-				version: {
-					view: t,
-					index: i
-				}
-			}, this.offsets.get(n));
-			this.connectors.set(n, {
-				...o,
-				write: (e) => {
-					o.write(e), Atomics.add(t, i, 1), Atomics.notify(t, i);
-				},
-				_version: {
-					view: t,
-					index: i
-				}
+		for (let e of i()) if (e.bound) try {
+			let n = l(e, t);
+			a.seen.set(e, {
+				version: u(n),
+				preview: c(n)
 			});
-		}), this.isBound = !0, this.boundBuffer = e;
-		for (let e of [...this.boundListeners]) e();
-	}
-	get bound() {
-		return this.isBound;
-	}
-	get buffer() {
-		if (!this.boundBuffer) throw Error("Shared memory contract is not bound to a buffer on this thread.");
-		return this.boundBuffer;
-	}
-	fields() {
-		return this.entries.map(({ path: e, descriptor: t }) => ({
-			path: e,
-			byteOffset: this.offsets.get(e),
-			byteLength: t.byteLength
-		}));
-	}
-	onBound(e) {
-		return this.isBound ? (e(), () => {}) : (this.boundListeners.add(e), () => this.boundListeners.delete(e));
-	}
-	connector(e) {
-		let t = String(e), n = this.connectors.get(t);
-		if (!n) throw Error(`Shared memory field "${t}" was accessed before the buffer was bound on this thread.`);
-		return n;
-	}
+		} catch {}
+		return r.set(t, a), a.stop = g(t, a), _();
+	}), n("memory.unwatch", (e) => {
+		let t = String(e.path ?? "");
+		return r.get(t)?.stop(), r.delete(t), _();
+	}), n("memory.watches", () => _()));
 };
-function N(e, t = {}) {
-	let n = new M(e, t);
-	for (let [t, r] of Object.entries(e)) if (p(r)) Object.defineProperty(n, t, {
-		enumerable: !0,
-		get: () => n.connector(t)
-	});
-	else {
-		let e = {};
-		for (let i of Object.keys(r)) Object.defineProperty(e, i, {
-			enumerable: !0,
-			get: () => n.connector(`${t}.${i}`)
-		});
-		Object.defineProperty(n, t, {
-			enumerable: !0,
-			get: () => e
-		});
-	}
-	return n;
-}
-function P(e) {
-	for (let t of k) t.bind(e);
-	l.info(`bound ${k.length} contract(s) — ${s(e.byteLength)} buffer`);
-}
-function F() {
-	return k.length;
-}
 //#endregion
-export { M as SharedMemory, P as bindSharedMemories, N as defineSharedMemory, w as field, F as getDefinedSharedMemoryCount, _ as jsonCodec, y as registerConnectorFactory };
+export { h as checkWatchOnWrite, v as ensureMemoryCommands, c as fieldPreview, r as memoryWatches, p as parseWatchRule };