@rbxts/replion 1.0.8 → 1.0.10

package/README.md

@@ -2,4 +2,4 @@
 
 ## Install
 Install with [wally](https://wally.run/):\
-`Replion = "shouxtech/replion@1.0.8"`
+`Replion = "shouxtech/replion@1.0.10"`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rbxts/replion",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "",
   "main": "src/init.lua",
   "scripts": {},
@@ -25,4 +25,4 @@
     "@rbxts/sift": "^0.0.11",
     "@rbxts/sleitnick-signal": "^1.0.8"
   }
-}
+}

package/src/Server.lua

@@ -5,12 +5,14 @@ local isTypeScriptEnv = script.Parent.Name == 'src';
 local dependencies = if isTypeScriptEnv then script.Parent.Parent.Parent else script.Parent.Parent;
 local Shared = require(script.Parent.Shared);
 local Sift = require(isTypeScriptEnv and dependencies.sift.out or dependencies.Sift);
+local Signal = require(isTypeScriptEnv and dependencies['sleitnick-signal'] or dependencies.Signal);
 
 type ServerConfig = {
 	channel: string;
 	replicateTo: Player?;
 	data: Shared.GenericDataTable;
 };
+type Observer = (newValue: any, oldValue: any) -> ();
 
 local remote = script.Parent:FindFirstChild(Shared.REMOTE_NAME) :: RemoteEvent;
 if not remote then
@@ -19,7 +21,7 @@ if not remote then
 	remote.Parent = script.Parent;
 end;
 
-local function setNestedValue(root: any, path: {string}, value: any)
+local function setNestedValue(root: any, path: { string }, value: any)
 	local current = root;
 	for i = 1, #path - 1 do
 		local key = path[i];
@@ -35,7 +37,7 @@ local function setNestedValue(root: any, path: {string}, value: any)
 	return oldValue;
 end;
 
-local function queueNestedUpdate(queue: any, path: {string}, value: any)
+local function queueNestedUpdate(queue: any, path: { string }, value: any)
 	local current = queue;
 	for i = 1, #path - 1 do
 		local key = path[i];
@@ -76,6 +78,9 @@ function Server.new(config: ServerConfig)
 	self.channel = config.channel;
 	self.data = Sift.Dictionary.copyDeep(config.data);
 
+	self._signals = {} :: { [string]: any };
+	self._allSignal = Signal.new();
+
 	self._queuedUpdates = {} :: Shared.GenericDataTable;
 	self._isQueued = false;
 	self._destroyed = false;
@@ -94,19 +99,46 @@ function Server.new(config: ServerConfig)
 	return self;
 end;
 
+function Server:observe(key: string?, callback: Observer)
+	if not key then
+		task.spawn(callback, self.data, nil);
+		return self._allSignal:Connect(callback);
+	end;
+
+	if not self._signals[key] then
+		self._signals[key] = Signal.new();
+	end;
+
+	task.spawn(callback, self.data[key], nil);
+	return self._signals[key]:Connect(callback);
+end;
+
 function Server:set(key: string | {string}, value: any)
 	if self._destroyed then return; end;
 
 	local path = if typeof(key) == 'table' then key else {key};
-	local oldValue = Shared.getNestedValue(self.data, path);
+	local topKey = path[1];
 
+	local oldValue = Shared.getNestedValue(self.data, path);
 	local newValue = if typeof(value) == 'function' then value(oldValue) else value;
-
 	if oldValue == newValue then return; end;
 
+	local oldTop = self.data[topKey]; 
+
 	setNestedValue(self.data, path, newValue);
 	queueNestedUpdate(self._queuedUpdates, path, newValue);
 	self:_scheduleUpdatesFlush();
+
+	do
+		local signal = self._signals[topKey];
+		if signal then
+			signal:Fire(self.data[topKey], oldTop);
+		end;
+
+		local thisUpdate = {};
+		setNestedValue(thisUpdate, path, newValue);
+		self._allSignal:Fire(self.data, thisUpdate);
+	end;
 end;
 
 function Server:get(key: (string | {string})?)
@@ -123,6 +155,12 @@ function Server:destroy()
 	self.data = {};
 	self._queuedUpdates = {};
 
+	self._allSignal:Destroy();
+	for _, signal in self._signals do
+		signal:Destroy();
+	end;
+	self._signals = {};
+
 	if self.player then
 		local playerReplions = self._activeReplions[self.player];
 		if not playerReplions then return; end;
@@ -149,7 +187,6 @@ function Server:_flushUpdates()
 	self._isQueued = false;
 
 	local updates = self._queuedUpdates;
-
 	local nUpdates = Sift.Dictionary.count(updates);
 	if nUpdates == 0 then return; end;
 

package/src/Shared.lua

@@ -6,7 +6,7 @@ local Shared = {};
 Shared.REMOTE_NAME = 'ReplionNetwork';
 Shared.NIL_SENTINEL = '\0\0__NIL__\0\0';
 
-function Shared.getNestedValue(root: any, path: {string})
+function Shared.getNestedValue(root: any, path: { string })
 	local current = root;
 	for _, key in path do
 		if typeof(current) ~= 'table' then return nil; end;

package/src/index.d.ts

@@ -17,6 +17,12 @@ declare namespace Replion {
 		get<K extends keyof T>(key: K): T[K];
 		get(path: string[]): any;
 
+		observe(key: undefined, callback: (newValue: T, oldValue: Partial<T>) => void): Connection;
+		observe<K extends keyof T>(
+			key: K,
+			callback: (newValue: T[K], oldValue: T[K] | undefined) => void,
+		): Connection;
+
 		destroy(): void;
 	}
 
@@ -27,7 +33,7 @@ declare namespace Replion {
 		get<K extends keyof T>(key: K): T[K];
 		get(path: string[]): any;
 
-		observe(key: undefined, callback: (newValue: T, oldValue: T | undefined) => void): Connection;
+		observe(key: undefined, callback: (newValue: T, oldValue: Partial<T>) => void): Connection;
 		observe<K extends keyof T>(
 			key: K,
 			callback: (newValue: T[K], oldValue: T[K] | undefined) => void,