UNPKG

statekit-lite

Version:

Minimal proxy-based global state manager for React with nested access, persist, watch, devtools, and realtime sync via plugins.

976 lines (970 loc) 30.3 kB
// src/store.ts import { useSyncExternalStore } from "react"; // node_modules/immer/dist/immer.mjs var NOTHING = Symbol.for("immer-nothing"); var DRAFTABLE = Symbol.for("immer-draftable"); var DRAFT_STATE = Symbol.for("immer-state"); var errors = process.env.NODE_ENV !== "production" ? [ // All error codes, starting by 0: function(plugin) { return `The plugin for '${plugin}' has not been loaded into Immer. To enable the plugin, import and call \`enable${plugin}()\` when initializing your application.`; }, function(thing) { return `produce can only be called on things that are draftable: plain objects, arrays, Map, Set or classes that are marked with '[immerable]: true'. Got '${thing}'`; }, "This object has been frozen and should not be mutated", function(data) { return "Cannot use a proxy that has been revoked. Did you pass an object from inside an immer function to an async process? " + data; }, "An immer producer returned a new value *and* modified its draft. Either return a new value *or* modify the draft.", "Immer forbids circular references", "The first or second argument to `produce` must be a function", "The third argument to `produce` must be a function or undefined", "First argument to `createDraft` must be a plain object, an array, or an immerable object", "First argument to `finishDraft` must be a draft returned by `createDraft`", function(thing) { return `'current' expects a draft, got: ${thing}`; }, "Object.defineProperty() cannot be used on an Immer draft", "Object.setPrototypeOf() cannot be used on an Immer draft", "Immer only supports deleting array indices", "Immer only supports setting array indices and the 'length' property", function(thing) { return `'original' expects a draft, got: ${thing}`; } // Note: if more errors are added, the errorOffset in Patches.ts should be increased // See Patches.ts for additional errors ] : []; function die(error, ...args) { if (process.env.NODE_ENV !== "production") { const e = errors[error]; const msg = typeof e === "function" ? e.apply(null, args) : e; throw new Error(`[Immer] ${msg}`); } throw new Error( `[Immer] minified error nr: ${error}. Full error at: https://bit.ly/3cXEKWf` ); } var getPrototypeOf = Object.getPrototypeOf; function isDraft(value) { return !!value && !!value[DRAFT_STATE]; } function isDraftable(value) { if (!value) return false; return isPlainObject(value) || Array.isArray(value) || !!value[DRAFTABLE] || !!value.constructor?.[DRAFTABLE] || isMap(value) || isSet(value); } var objectCtorString = Object.prototype.constructor.toString(); function isPlainObject(value) { if (!value || typeof value !== "object") return false; const proto = getPrototypeOf(value); if (proto === null) { return true; } const Ctor = Object.hasOwnProperty.call(proto, "constructor") && proto.constructor; if (Ctor === Object) return true; return typeof Ctor == "function" && Function.toString.call(Ctor) === objectCtorString; } function each(obj, iter) { if (getArchtype(obj) === 0) { Reflect.ownKeys(obj).forEach((key) => { iter(key, obj[key], obj); }); } else { obj.forEach((entry, index) => iter(index, entry, obj)); } } function getArchtype(thing) { const state = thing[DRAFT_STATE]; return state ? state.type_ : Array.isArray(thing) ? 1 : isMap(thing) ? 2 : isSet(thing) ? 3 : 0; } function has(thing, prop) { return getArchtype(thing) === 2 ? thing.has(prop) : Object.prototype.hasOwnProperty.call(thing, prop); } function set(thing, propOrOldValue, value) { const t = getArchtype(thing); if (t === 2) thing.set(propOrOldValue, value); else if (t === 3) { thing.add(value); } else thing[propOrOldValue] = value; } function is(x, y) { if (x === y) { return x !== 0 || 1 / x === 1 / y; } else { return x !== x && y !== y; } } function isMap(target) { return target instanceof Map; } function isSet(target) { return target instanceof Set; } function latest(state) { return state.copy_ || state.base_; } function shallowCopy(base, strict) { if (isMap(base)) { return new Map(base); } if (isSet(base)) { return new Set(base); } if (Array.isArray(base)) return Array.prototype.slice.call(base); const isPlain = isPlainObject(base); if (strict === true || strict === "class_only" && !isPlain) { const descriptors = Object.getOwnPropertyDescriptors(base); delete descriptors[DRAFT_STATE]; let keys = Reflect.ownKeys(descriptors); for (let i = 0; i < keys.length; i++) { const key = keys[i]; const desc = descriptors[key]; if (desc.writable === false) { desc.writable = true; desc.configurable = true; } if (desc.get || desc.set) descriptors[key] = { configurable: true, writable: true, // could live with !!desc.set as well here... enumerable: desc.enumerable, value: base[key] }; } return Object.create(getPrototypeOf(base), descriptors); } else { const proto = getPrototypeOf(base); if (proto !== null && isPlain) { return { ...base }; } const obj = Object.create(proto); return Object.assign(obj, base); } } function freeze(obj, deep = false) { if (isFrozen(obj) || isDraft(obj) || !isDraftable(obj)) return obj; if (getArchtype(obj) > 1) { obj.set = obj.add = obj.clear = obj.delete = dontMutateFrozenCollections; } Object.freeze(obj); if (deep) Object.entries(obj).forEach(([key, value]) => freeze(value, true)); return obj; } function dontMutateFrozenCollections() { die(2); } function isFrozen(obj) { return Object.isFrozen(obj); } var plugins = {}; function getPlugin(pluginKey) { const plugin = plugins[pluginKey]; if (!plugin) { die(0, pluginKey); } return plugin; } var currentScope; function getCurrentScope() { return currentScope; } function createScope(parent_, immer_) { return { drafts_: [], parent_, immer_, // Whenever the modified draft contains a draft from another scope, we // need to prevent auto-freezing so the unowned draft can be finalized. canAutoFreeze_: true, unfinalizedDrafts_: 0 }; } function usePatchesInScope(scope, patchListener) { if (patchListener) { getPlugin("Patches"); scope.patches_ = []; scope.inversePatches_ = []; scope.patchListener_ = patchListener; } } function revokeScope(scope) { leaveScope(scope); scope.drafts_.forEach(revokeDraft); scope.drafts_ = null; } function leaveScope(scope) { if (scope === currentScope) { currentScope = scope.parent_; } } function enterScope(immer2) { return currentScope = createScope(currentScope, immer2); } function revokeDraft(draft) { const state = draft[DRAFT_STATE]; if (state.type_ === 0 || state.type_ === 1) state.revoke_(); else state.revoked_ = true; } function processResult(result, scope) { scope.unfinalizedDrafts_ = scope.drafts_.length; const baseDraft = scope.drafts_[0]; const isReplaced = result !== void 0 && result !== baseDraft; if (isReplaced) { if (baseDraft[DRAFT_STATE].modified_) { revokeScope(scope); die(4); } if (isDraftable(result)) { result = finalize(scope, result); if (!scope.parent_) maybeFreeze(scope, result); } if (scope.patches_) { getPlugin("Patches").generateReplacementPatches_( baseDraft[DRAFT_STATE].base_, result, scope.patches_, scope.inversePatches_ ); } } else { result = finalize(scope, baseDraft, []); } revokeScope(scope); if (scope.patches_) { scope.patchListener_(scope.patches_, scope.inversePatches_); } return result !== NOTHING ? result : void 0; } function finalize(rootScope, value, path) { if (isFrozen(value)) return value; const state = value[DRAFT_STATE]; if (!state) { each( value, (key, childValue) => finalizeProperty(rootScope, state, value, key, childValue, path) ); return value; } if (state.scope_ !== rootScope) return value; if (!state.modified_) { maybeFreeze(rootScope, state.base_, true); return state.base_; } if (!state.finalized_) { state.finalized_ = true; state.scope_.unfinalizedDrafts_--; const result = state.copy_; let resultEach = result; let isSet2 = false; if (state.type_ === 3) { resultEach = new Set(result); result.clear(); isSet2 = true; } each( resultEach, (key, childValue) => finalizeProperty(rootScope, state, result, key, childValue, path, isSet2) ); maybeFreeze(rootScope, result, false); if (path && rootScope.patches_) { getPlugin("Patches").generatePatches_( state, path, rootScope.patches_, rootScope.inversePatches_ ); } } return state.copy_; } function finalizeProperty(rootScope, parentState, targetObject, prop, childValue, rootPath, targetIsSet) { if (process.env.NODE_ENV !== "production" && childValue === targetObject) die(5); if (isDraft(childValue)) { const path = rootPath && parentState && parentState.type_ !== 3 && // Set objects are atomic since they have no keys. !has(parentState.assigned_, prop) ? rootPath.concat(prop) : void 0; const res = finalize(rootScope, childValue, path); set(targetObject, prop, res); if (isDraft(res)) { rootScope.canAutoFreeze_ = false; } else return; } else if (targetIsSet) { targetObject.add(childValue); } if (isDraftable(childValue) && !isFrozen(childValue)) { if (!rootScope.immer_.autoFreeze_ && rootScope.unfinalizedDrafts_ < 1) { return; } finalize(rootScope, childValue); if ((!parentState || !parentState.scope_.parent_) && typeof prop !== "symbol" && Object.prototype.propertyIsEnumerable.call(targetObject, prop)) maybeFreeze(rootScope, childValue); } } function maybeFreeze(scope, value, deep = false) { if (!scope.parent_ && scope.immer_.autoFreeze_ && scope.canAutoFreeze_) { freeze(value, deep); } } function createProxyProxy(base, parent) { const isArray = Array.isArray(base); const state = { type_: isArray ? 1 : 0, // Track which produce call this is associated with. scope_: parent ? parent.scope_ : getCurrentScope(), // True for both shallow and deep changes. modified_: false, // Used during finalization. finalized_: false, // Track which properties have been assigned (true) or deleted (false). assigned_: {}, // The parent draft state. parent_: parent, // The base state. base_: base, // The base proxy. draft_: null, // set below // The base copy with any updated values. copy_: null, // Called by the `produce` function. revoke_: null, isManual_: false }; let target = state; let traps = objectTraps; if (isArray) { target = [state]; traps = arrayTraps; } const { revoke, proxy } = Proxy.revocable(target, traps); state.draft_ = proxy; state.revoke_ = revoke; return proxy; } var objectTraps = { get(state, prop) { if (prop === DRAFT_STATE) return state; const source = latest(state); if (!has(source, prop)) { return readPropFromProto(state, source, prop); } const value = source[prop]; if (state.finalized_ || !isDraftable(value)) { return value; } if (value === peek(state.base_, prop)) { prepareCopy(state); return state.copy_[prop] = createProxy(value, state); } return value; }, has(state, prop) { return prop in latest(state); }, ownKeys(state) { return Reflect.ownKeys(latest(state)); }, set(state, prop, value) { const desc = getDescriptorFromProto(latest(state), prop); if (desc?.set) { desc.set.call(state.draft_, value); return true; } if (!state.modified_) { const current2 = peek(latest(state), prop); const currentState = current2?.[DRAFT_STATE]; if (currentState && currentState.base_ === value) { state.copy_[prop] = value; state.assigned_[prop] = false; return true; } if (is(value, current2) && (value !== void 0 || has(state.base_, prop))) return true; prepareCopy(state); markChanged(state); } if (state.copy_[prop] === value && // special case: handle new props with value 'undefined' (value !== void 0 || prop in state.copy_) || // special case: NaN Number.isNaN(value) && Number.isNaN(state.copy_[prop])) return true; state.copy_[prop] = value; state.assigned_[prop] = true; return true; }, deleteProperty(state, prop) { if (peek(state.base_, prop) !== void 0 || prop in state.base_) { state.assigned_[prop] = false; prepareCopy(state); markChanged(state); } else { delete state.assigned_[prop]; } if (state.copy_) { delete state.copy_[prop]; } return true; }, // Note: We never coerce `desc.value` into an Immer draft, because we can't make // the same guarantee in ES5 mode. getOwnPropertyDescriptor(state, prop) { const owner = latest(state); const desc = Reflect.getOwnPropertyDescriptor(owner, prop); if (!desc) return desc; return { writable: true, configurable: state.type_ !== 1 || prop !== "length", enumerable: desc.enumerable, value: owner[prop] }; }, defineProperty() { die(11); }, getPrototypeOf(state) { return getPrototypeOf(state.base_); }, setPrototypeOf() { die(12); } }; var arrayTraps = {}; each(objectTraps, (key, fn) => { arrayTraps[key] = function() { arguments[0] = arguments[0][0]; return fn.apply(this, arguments); }; }); arrayTraps.deleteProperty = function(state, prop) { if (process.env.NODE_ENV !== "production" && isNaN(parseInt(prop))) die(13); return arrayTraps.set.call(this, state, prop, void 0); }; arrayTraps.set = function(state, prop, value) { if (process.env.NODE_ENV !== "production" && prop !== "length" && isNaN(parseInt(prop))) die(14); return objectTraps.set.call(this, state[0], prop, value, state[0]); }; function peek(draft, prop) { const state = draft[DRAFT_STATE]; const source = state ? latest(state) : draft; return source[prop]; } function readPropFromProto(state, source, prop) { const desc = getDescriptorFromProto(source, prop); return desc ? `value` in desc ? desc.value : ( // This is a very special case, if the prop is a getter defined by the // prototype, we should invoke it with the draft as context! desc.get?.call(state.draft_) ) : void 0; } function getDescriptorFromProto(source, prop) { if (!(prop in source)) return void 0; let proto = getPrototypeOf(source); while (proto) { const desc = Object.getOwnPropertyDescriptor(proto, prop); if (desc) return desc; proto = getPrototypeOf(proto); } return void 0; } function markChanged(state) { if (!state.modified_) { state.modified_ = true; if (state.parent_) { markChanged(state.parent_); } } } function prepareCopy(state) { if (!state.copy_) { state.copy_ = shallowCopy( state.base_, state.scope_.immer_.useStrictShallowCopy_ ); } } var Immer2 = class { constructor(config) { this.autoFreeze_ = true; this.useStrictShallowCopy_ = false; this.produce = (base, recipe, patchListener) => { if (typeof base === "function" && typeof recipe !== "function") { const defaultBase = recipe; recipe = base; const self = this; return function curriedProduce(base2 = defaultBase, ...args) { return self.produce(base2, (draft) => recipe.call(this, draft, ...args)); }; } if (typeof recipe !== "function") die(6); if (patchListener !== void 0 && typeof patchListener !== "function") die(7); let result; if (isDraftable(base)) { const scope = enterScope(this); const proxy = createProxy(base, void 0); let hasError = true; try { result = recipe(proxy); hasError = false; } finally { if (hasError) revokeScope(scope); else leaveScope(scope); } usePatchesInScope(scope, patchListener); return processResult(result, scope); } else if (!base || typeof base !== "object") { result = recipe(base); if (result === void 0) result = base; if (result === NOTHING) result = void 0; if (this.autoFreeze_) freeze(result, true); if (patchListener) { const p = []; const ip = []; getPlugin("Patches").generateReplacementPatches_(base, result, p, ip); patchListener(p, ip); } return result; } else die(1, base); }; this.produceWithPatches = (base, recipe) => { if (typeof base === "function") { return (state, ...args) => this.produceWithPatches(state, (draft) => base(draft, ...args)); } let patches, inversePatches; const result = this.produce(base, recipe, (p, ip) => { patches = p; inversePatches = ip; }); return [result, patches, inversePatches]; }; if (typeof config?.autoFreeze === "boolean") this.setAutoFreeze(config.autoFreeze); if (typeof config?.useStrictShallowCopy === "boolean") this.setUseStrictShallowCopy(config.useStrictShallowCopy); } createDraft(base) { if (!isDraftable(base)) die(8); if (isDraft(base)) base = current(base); const scope = enterScope(this); const proxy = createProxy(base, void 0); proxy[DRAFT_STATE].isManual_ = true; leaveScope(scope); return proxy; } finishDraft(draft, patchListener) { const state = draft && draft[DRAFT_STATE]; if (!state || !state.isManual_) die(9); const { scope_: scope } = state; usePatchesInScope(scope, patchListener); return processResult(void 0, scope); } /** * Pass true to automatically freeze all copies created by Immer. * * By default, auto-freezing is enabled. */ setAutoFreeze(value) { this.autoFreeze_ = value; } /** * Pass true to enable strict shallow copy. * * By default, immer does not copy the object descriptors such as getter, setter and non-enumrable properties. */ setUseStrictShallowCopy(value) { this.useStrictShallowCopy_ = value; } applyPatches(base, patches) { let i; for (i = patches.length - 1; i >= 0; i--) { const patch = patches[i]; if (patch.path.length === 0 && patch.op === "replace") { base = patch.value; break; } } if (i > -1) { patches = patches.slice(i + 1); } const applyPatchesImpl = getPlugin("Patches").applyPatches_; if (isDraft(base)) { return applyPatchesImpl(base, patches); } return this.produce( base, (draft) => applyPatchesImpl(draft, patches) ); } }; function createProxy(value, parent) { const draft = isMap(value) ? getPlugin("MapSet").proxyMap_(value, parent) : isSet(value) ? getPlugin("MapSet").proxySet_(value, parent) : createProxyProxy(value, parent); const scope = parent ? parent.scope_ : getCurrentScope(); scope.drafts_.push(draft); return draft; } function current(value) { if (!isDraft(value)) die(10, value); return currentImpl(value); } function currentImpl(value) { if (!isDraftable(value) || isFrozen(value)) return value; const state = value[DRAFT_STATE]; let copy; if (state) { if (!state.modified_) return state.base_; state.finalized_ = true; copy = shallowCopy(value, state.scope_.immer_.useStrictShallowCopy_); } else { copy = shallowCopy(value, true); } each(copy, (key, childValue) => { set(copy, key, currentImpl(childValue)); }); if (state) { state.finalized_ = false; } return copy; } var immer = new Immer2(); var produce = immer.produce; var produceWithPatches = immer.produceWithPatches.bind( immer ); var setAutoFreeze = immer.setAutoFreeze.bind(immer); var setUseStrictShallowCopy = immer.setUseStrictShallowCopy.bind(immer); var applyPatches = immer.applyPatches.bind(immer); var createDraft = immer.createDraft.bind(immer); var finishDraft = immer.finishDraft.bind(immer); // src/store.ts function safeClone(obj) { if (typeof obj !== "object" || obj === null) return obj; if (Array.isArray(obj)) return obj.map(safeClone); const result = {}; for (const key in obj) { const val = obj[key]; result[key] = typeof val === "function" ? val : safeClone(val); } return result; } function getByPath(obj, path) { return path.reduce((acc, key) => acc?.[key], obj); } function setByPath(obj, path, val) { if (!path.length) return val; const [key, ...rest] = path; const isIndex = typeof key === "number" || /^\d+$/.test(String(key)); const prev = obj ?? (isIndex ? [] : {}); const clone = Array.isArray(prev) ? [...prev] : { ...prev }; clone[key] = setByPath(prev[key], rest, val); return clone; } function pathToString(path) { return path.join("."); } function createStore(initialValue, options = {}) { const key = typeof options.persist === "object" ? options.persist.key : options.persist === true ? "statekit-store-" + Math.random().toString(36).slice(2) : null; let value = initialValue; let devtools = null; let lastUpdatedPath = null; if (typeof window !== "undefined" && options.devtools) { const ext = window.__REDUX_DEVTOOLS_EXTENSION__; if (ext?.connect) { devtools = ext.connect({ name: typeof options.devtools === "object" ? options.devtools.name ?? "statekit" : "statekit" }); devtools.init(safeClone(value)); } } if (typeof window !== "undefined" && key) { const stored = localStorage.getItem(key); if (stored) { try { value = JSON.parse(stored); } catch { value = initialValue; } } } const listeners = /* @__PURE__ */ new Set(); const watchers = /* @__PURE__ */ new Map(); const notify = () => listeners.forEach((l) => l()); const store = { get: () => value, set: (v) => { value = v; if (typeof window !== "undefined" && key) { localStorage.setItem(key, JSON.stringify(value)); } if (devtools) { devtools.send({ type: `[set] ${lastUpdatedPath ?? "unknown"}` }, safeClone(value)); } notify(); watchers.forEach((fns, pathStr) => { const path = pathStr.split("."); const val = getByPath(value, path); fns.forEach((fn) => fn(val)); }); }, subscribe: (cb) => { listeners.add(cb); return () => listeners.delete(cb); } }; function createProxy2(path) { const pathStr = pathToString(path); const api = { get: (clone = false) => { const val = getByPath(store.get(), path); return clone ? structuredClone(val) : val; }, set: (val) => { const prev = getByPath(store.get(), path); const next = typeof val === "function" ? options.immer ? produce(prev, val) : val(prev) : val; lastUpdatedPath = pathStr; store.set(setByPath(store.get(), path, next)); }, update: (fn) => { const current2 = getByPath(store.get(), path); const next = fn(current2); store.set(setByPath(store.get(), path, next)); }, use: () => useSyncExternalStore( store.subscribe, () => getByPath(store.get(), path) ), watch: (fn) => { if (!watchers.has(pathStr)) { watchers.set(pathStr, /* @__PURE__ */ new Set()); } const set2 = watchers.get(pathStr); const wrapped = (val) => fn(val, unsub); set2.add(wrapped); const unsub = () => set2.delete(wrapped); return unsub; }, export: () => safeClone(getByPath(store.get(), path)), toJSON: () => getByPath(store.get(), path) }; return new Proxy(api, { get(target, prop) { if (prop in target) return target[prop]; return createProxy2([...path, prop]); } }); } const proxyStore = createProxy2([]); const cleanups = []; if (Array.isArray(options.plugins)) { for (const plugin of options.plugins) { try { const result = plugin(proxyStore); if (typeof result === "function") { cleanups.push(result); } } catch (e) { console.error(`[statekit-lite] Plugin error "${plugin.name}":`, e); } } } proxyStore.dispose = () => { cleanups.forEach((fn) => fn()); }; return proxyStore; } // src/sync-plugin.ts function syncPlugin(options) { return (store) => { const { subscribe, pushUpdate, mapper, debug, path } = options; const log = (...args) => debug && console.log("[syncPlugin]", ...args); const isRoot = !path || path.length === 0; const target = isRoot ? store : path.reduce((acc, key) => acc?.[key], store); if (!target || typeof target.set !== "function") { log("\u274C invalid target at path:", path); return () => { }; } let ignoreNext = false; const unsubscribeRemote = subscribe((incoming) => { const mapped = mapper ? mapper(incoming) : incoming; log("\u2B07\uFE0F incoming:", mapped); ignoreNext = true; if (typeof mapped === "function") { target.set(mapped); } else { target.set(() => mapped); } }); const unsub = pushUpdate ? isRoot ? store.watch(() => { if (ignoreNext) { log("\u{1F6D1} skipping push (from remote)"); ignoreNext = false; return; } const val = store.get?.(true); log("\u2B06\uFE0F pushUpdate:", val); if (val !== void 0) pushUpdate(val); }) : target.watch((val) => { if (ignoreNext) { log("\u{1F6D1} skipping push (from remote)"); ignoreNext = false; return; } log("\u2B06\uFE0F pushUpdate path:", val); if (val !== void 0) pushUpdate(val); }) : void 0; return () => { unsubscribeRemote?.(); unsub?.(); }; }; } // src/plugins/sse-plugin.ts function ssePlugin(options) { const { url, path, mapper, mode = "set", debug } = options; return syncPlugin({ path, debug, subscribe: (emit) => { const source = new EventSource(url); source.onmessage = (e) => { try { const data = JSON.parse(e.data); const mapped = mapper ? mapper(data) : data; if (debug) { console.log("[ssePlugin] raw:", data); console.log("[ssePlugin] mapped:", mapped); } if (mode === "push") { emit((prev) => [...prev || [], mapped]); } else emit(mapped); } catch (err) { if (debug) console.warn("[ssePlugin] parse error:", e.data); } }; return () => source.close(); } }); } // src/plugins/supabase-plugin.ts import { createClient } from "@supabase/supabase-js"; function supabaseGlobalPlugin(options) { const supabase = createClient(options.url, options.anon_key); const { table, primary_key = "key", key, polling = 0, field = "value", debug } = options; const log = (...args) => debug && console.log("[supabaseKVPlugin]", ...args); return (store) => { let ignoreNext = false; let lastSent = ""; let gotEvent = false; let pollTimer; let hasLocalUpdates = false; function startPolling() { if (!polling || polling <= 0) return; log("\u{1F504} Realtime silent \u2014 fallback polling every", polling, "ms"); pollTimer = setInterval(async () => { const { data, error } = await supabase.from(table).select(field).eq(primary_key, key).single(); if (data?.[field]) { const snap = JSON.stringify(data[field]); if (snap !== lastSent) { log("\u{1F4E5} polled update:", data[field]); ignoreNext = true; store.set(() => data[field]); lastSent = snap; } } }, polling); } const channel = supabase.channel(`realtime:${table}`).on("postgres_changes", { event: "*", schema: "public", table }, (payload) => { const rowKey = payload.new?.[primary_key]; const incoming = payload.new?.[field]; if (rowKey !== key || incoming === void 0) return; gotEvent = true; log("\u2B07\uFE0F incoming from Supabase:", incoming); ignoreNext = true; store.set(() => incoming); }).subscribe(); const pushUpdate = async (data) => { await supabase.from(table).upsert({ [primary_key]: key, [field]: data }); }; const unsub = store.watch(() => { const val = store.get?.(true); if (val === void 0) return; hasLocalUpdates = true; const snap = JSON.stringify(val); if (snap === lastSent) return; lastSent = snap; log("\u2B06\uFE0F pushUpdate to Supabase:", val); pushUpdate(val); }); (async () => { const { data, error } = await supabase.from(table).select(field).eq(primary_key, key).single(); if (data?.[field]) { log("\u{1F4E5} initial load:", data[field]); ignoreNext = true; store.set(() => data[field]); } else if (!error) { log("\u{1F4E6} inserting default store state"); await pushUpdate(store.get(true)); } })(); const timeout = setTimeout(() => { if (hasLocalUpdates && !gotEvent) { console.warn( "[supabasePlugin] \u26A0\uFE0F No realtime events received from Supabase after local updates.\nMake sure Realtime is enabled for this table in Supabase Dashboard \u2192 Table Editor \u2192 Realtime tab." ); startPolling(); } }, 5e3); return () => { clearTimeout(timeout); clearInterval(pollTimer); supabase.removeChannel(channel); unsub?.(); }; }; } export { createStore, ssePlugin, supabaseGlobalPlugin as supabasePlugin, syncPlugin };