Devuelve SOLO codigo de un ModuleScript para servidor Roblox. Sin Markdown, herramientas ni archivos. Reto avanzado: servicio de economia transaccional de un obby. El modulo retorna {new=function(saveFn)...end}. Cada instancia devuelve API de funciones punto (sin self): register(userId,coins), snapshot(userId), stock(), buy(userId,sku,requestId), receipt(userId,purchaseId,productId). Estado aislado entre instancias. Solo Lua 5.4 compatible (sin tipos, +=, continue, typeof) para pruebas con adaptador simulado. Sin otras dependencias ni yield.
CONTRATO EXACTO:
register: userId entero positivo finito, coins entero no negativo finito. Retorna true si valido, false si invalido. Si ya existe NO reinicia saldo/inventario/ids.
snapshot: copia PROFUNDA de {coins=n, inventory={speed=n,shield=n}} o nil. stock(): copia {speed=n,shield=n}; inicial speed=2, shield=1, compartido entre jugadores de ESTA instancia.
buy: sku solo speed (precio10) o shield (precio15); requestId string no vacio; jugador registrado. Una solicitud exitosa por jugador y requestId se aplica solo una vez. Repetir ese mismo requestId para mismo sku retorna true sin guardar ni descontar. Reutilizar requestId exitoso con OTRO sku retorna false. Fallos no consumen requestId. Rechaza entradas invalidas, saldo insuficiente o stock agotado retornando false sin mutaciones ni llamar a saveFn. Exito descuenta saldo, incrementa inventario, reduce stock. Antes de hacer visibles esos cambios, invoca saveFn(payload) via pcall; solo es exito si retorna EXACTAMENTE true. payload={kind="buy",userId=id,coins=saldoPropuesto,inventory=copiaInventarioPropuesto,stock=copiaStockPropuesto,requestId=idSolicitud,sku=sku}. Si saveFn lanza error, retorna false o nil: buy retorna false y deja TODO igual, incluyendo ids; se puede reintentar. Si saveFn modifica payload no debe corromper estado interno ni el estado final confirmado. Sin reentrancia/concurrencia/yield en saveFn.
receipt: producto id numerico exacto 101 concede 50 monedas. purchaseId string no vacio, UserId registrado. Desconocido/invalido/offline retorna "NotProcessedYet" sin guardar ni mutar. IDs de recibo GLOBALMENTE unicos dentro de la instancia: si ya aplicado al MISMO jugador retorna "PurchaseGranted" sin guardar/sumar; si ya usado por OTRO jugador retorna "NotProcessedYet". Antes de confirmar, invoca saveFn con {kind="receipt",userId=id,coins=saldoPropuesto,inventory=copiaInventarioActual,purchaseId=idCompra,productId=101}. Reglas mismas de pcall y retorno true exacto; fallo NO marca recibo y se puede reintentar. Exito suma50 y retorna "PurchaseGranted". Strings se usan como estados para que un adaptador de ProcessReceipt los convierta a Enum, NO implementes el adaptador.
VALIDACION: todos los numeros de entrada deben ser finitos y enteros donde indicado; no aceptar strings numericos, NaN ni infinito. No confiar en cantidades ni precios del cliente. La copia del payload entregada a saveFn y las copias de snapshot/stock JAMAS deben compartir tablas mutables con estado interno.
Maximo 230 lineas. Solo codigo.