Metabridge Changelog

All notable changes to this project will be documented in this file.

[1.0.5] - 2026-03-30

Added

• Dispatch abstraction system — unified client/server dispatch layer with auto-detection and adapter routing:
  • sendDispatch(data) (client) — sends a dispatch alert through the detected (or configured) dispatch system. Supports ps-dispatch, qs-dispatch, rcore_dispatch, cd_dispatch, and a built-in standalone relay out of the box.
  • Standalone server relay — receives MetaBridge:dispatch:sendAlert and broadcasts MetaBridge:dispatch:clientAlert to all clients with blip creation and feed notification.
  • detectDispatch() / normalizeDispatch(name) (shared) — auto-detection and alias normalization for dispatch systems, matching the existing framework and inventory detection pattern.
  • Full BridgeConfig.dispatch support: system (force a specific adapter), send (custom send handler), filter (client-side display filter), filterServer (server-side relay filter).
• Client bridge methods:
  • addTargetGlobalVehicle(options) — adds target options to all vehicles globally; routes to ox_target, qb-target, or qtarget.
  • addTargetGlobalPlayer(options) — adds target options to all players globally; same fallback chain.
  • getItemImage(itemName) — resolves an item's image URL; defaults to the ox_inventory NUI image path, overridable via BridgeConfig.inventory.getItemImage.
• Server bridge methods:
  • getPlayerName(source) — resolves the character's full name from charinfo (firstname + lastname), falling back to playerData.name then native GetPlayerName.
  • canCarryItem(source, itemName, amount) — checks whether a player can carry a given quantity of an item by looking up its weight via getItemDefinition and delegating to canCarryWeight.
  • getItemFromSlot(source, slot) — retrieves item data from a specific inventory slot via the active inventory adapter.

Compatibility

• Public exports, events, and method signatures remain unchanged.
• Both resource mode and @metabridge/init.lua include mode remain supported.

---

[1.0.4] - 2026-03-03

Fixed

• MetaBridge:invokeCallback server net event now silently returns when the requested callback is not registered in the current Lua state, instead of immediately firing a MetaBridge:callbackResponse error back to the client. This eliminates a race condition where the metabridge resource's own Lua state (which holds no downstream resource callbacks) would respond with success = false before the resource that actually owns the callback could respond with the real result. The previous behaviour caused every requestCallbackAwait call in resources that embed metabridge via @metabridge/init.lua (without ox_lib in their own shared_scripts) to silently receive nil.

Compatibility

• Public exports, events, and method signatures remain unchanged.
• Both resource mode and @metabridge/init.lua include mode remain supported.

---

[1.0.3] - 2026-02-20

Added

• Server bridge inventory methods:
  • getItemDefinition(source, itemName)
  • removeItemExact(source, itemName, amount, meta, slot)
  • registerCreateItemHook(handler, options)
• Server callbacks for client-side inventory abstractions:
  • MetaBridge:getItemCount
  • MetaBridge:getItemDefinition
• Client bridge methods:
  • getItemCount(itemName, meta)
  • hasItem(itemName, amount, meta)
  • displayMetadata(metadataMap)
  • addTargetLocalEntity(entity, options) — adds target options to a local (non-networked) entity; routes to ox_target, qb-target, or qtarget.
  • removeTargetLocalEntity(entity) — removes all target options from a local entity; same fallback chain.
  • removeTargetModel(models) — removes model-based targets registered via addTargetModel.
  • alertDialog(data) — shows a confirm/cancel alert dialog; defaults to lib.alertDialog, overridable via BridgeConfig.alertDialog.client.
  • addZoneSphere(data) — creates a proximity sphere zone; defaults to lib.zones.sphere, overridable via BridgeConfig.zones.sphere.
  • addPoint(data) — creates a proximity tracking point; defaults to lib.points.new, overridable via BridgeConfig.points.new.
  • requestModel(model, timeoutMs) — loads a model hash and waits until ready; returns boolean.

Fixed

• Fixed requestCallbackAwait in resource/client.lua to preserve all return values from lib.callback.await (including multi-return responses).
• Hardened getJob resolution for QBCore/Qbox and added fallback extraction from normalized player payloads to reduce unexpected nil job results.

Changed

• Added bridge debug mode support via BridgeConfig.debug and runtime diagnostics in shared/core adapter paths.
• Centralized repeated vehicle helper logic (setFuel, giveVehicleKeys) in resource/shared.lua and reused it across framework adapters.
• Converted adapters/*.lua and inventories/*.lua to shim-only compatibility files that forward-load canonical implementations.
• Removed leftover duplicate/unused helper logic from active framework files during cleanup.
• Extended inventory adapters with item-definition and exact-removal support.
• Updated ox_inventory adapter to support bridge-level createItem hook registration.
• Enabled downstream resources to stop calling ox_inventory directly for item counts, metadata display, and slot-targeted removals.

Compatibility

• Public exports, events, and method signatures remain unchanged.
• Both resource mode and @metabridge/init.lua include mode remain supported.

[1.0.2] - 2026-02-20

Changed

• Added shared helper utilities in resource/shared.lua for safe export invocation and notification payload normalization.
• Updated runtime bridge code (resource/client.lua, resource/bridge.lua) to use shared helpers instead of duplicated local implementations.
• Removed duplicate client export declarations from resource/client.lua; client export registration now has a single source of truth in exports/client.lua.
• Added legacy compatibility forward-load shims in adapters/*.lua and inventories/*.lua so those paths always execute canonical implementations in links/frameworks/*.lua and links/inventories/*.lua.

Compatibility

• Public exports, events, and method signatures remain unchanged.
• Both resource mode and @metabridge/init.lua include mode remain supported.

[1.0.1] - 2026-02-19

Added

• Server bridge API methods:
  • canCarryWeight(source, weight)
  • getEmptySlot(source)
  • getSlotsWithItem(source, itemName, meta)
  • setItemMetadata(source, slot, metadata)
• ox_inventory adapter support for the methods above.
• Framework inventory adapter fallback implementations for safer cross-inventory behavior.

Notes

• These additions are exported through exports/server.lua automatically with the rest of MetaBridge methods.
• This update fixes missing-method runtime issues in resources that rely on inventory capacity checks, slot scans, and metadata updates.