Clarify event hook descriptions and add post-hook info

Updated terminology and added post-hook event section.

Signed-off-by: Linden <65407488+thelindat@users.noreply.github.com>

Author: thelindat

pages/ox_inventory/Functions/Server/Hooks.mdx

@@ -1,15 +1,25 @@
+import { Callout } from 'nextra/components'
+
 # Hooks
 
-Event hooks allow 3rd party resources to define new behaviour without modifying the inventory code directly.
+Event hooks allow third-party resources to define new behaviour without modifying the inventory code directly.
 
 ## registerHook
 
 ```lua
 exports.ox_inventory:registerHook(eventName, function(payload) end, options)
 ```
 
+<Callout type="error">
+  Hook callbacks are intended for validation only and should avoid side effects such as modifying data, writing to a database, or triggering additional operations.
+
+  Because actions may still be in progress or may fail, modifying item or inventory state before completion can lead to race conditions or inconsistent behavior.
+
+  To avoid issues, perform state changes or follow-up logic in post-hook events.
+</Callout>
+
 - eventName: `string`
-- payload: `table`
+- callback: `function(payload: table)`
 - options?: `table`
   - print?: `boolean`
     - Print to the console when triggering the event.
@@ -22,7 +32,7 @@ exports.ox_inventory:registerHook(eventName, function(payload) end, options)
 
 Return:
 
-- hookId: `number`
+- hookId: `string`
 
 ### swapItems
 
@@ -40,7 +50,8 @@ By returning `false`, you can cancel the action and revert the inventory state.
   - toSlot?: `table` or `number`
   - count: `number`
 
-**Example**
+<details>
+<summary><b>Example</b></summary>
 
 Blacklists "water" from being moved into or from gloveboxes and trunks.
 
@@ -60,6 +71,8 @@ end, {
 })
 ```
 
+</details>
+
 ### openInventory
 
 - Payload: `table`
@@ -70,7 +83,8 @@ end, {
 Triggered when a player tries to open a secondary inventory.  
 By returning `false`, you can cancel the action and keep the player's inventory closed.
 
-**Example**
+<details>
+<summary><b>Example</b></summary>
 
 Disables gloveboxes and trunks.
 
@@ -87,6 +101,8 @@ end, {
 })
 ```
 
+</summary>
+
 ### openShop
 
 - Payload: `table`
@@ -103,7 +119,8 @@ end, {
 Triggered when a player tries to open a shop inventory.  
 By returning `false`, you can cancel the action and keep the shop inventory closed.
 
-**Example**
+<details>
+<summary><b>Example</b></summary>
 
 Disable General stores.
 
@@ -119,6 +136,8 @@ end, {
 })
 ```
 
+</details>
+
 ### createItem
 
 - Payload: `table`
@@ -130,7 +149,10 @@ end, {
 Triggered when an item is created, either by buying it, using AddItem, or when converting inventory data.  
 By returning a table you can modify or replace the metadata given to an item.
 
-**Example**
+Post-hook events are not necessary for this event, but are still recommended
+
+<details>
+<summary><b>Example</b></summary>
 
 Sets the label for "water" to "Mineral Water".
 
@@ -148,6 +170,8 @@ end, {
 })
 ```
 
+</details>
+
 ### buyItem
 
 - Payload: `table`
@@ -165,7 +189,8 @@ end, {
 
 Triggered when an item is about to be purchased and can return `false` to prevent the transaction.
 
-**Example**
+<details>
+<summary><b>Example</b></summary>
 
 Prevents players from purchasing items at General stores.
 
@@ -182,6 +207,8 @@ end, {
 
 ```
 
+</details>
+
 ### craftItem
 
 - Payload: `table`
@@ -198,7 +225,8 @@ end, {
   - toInventory: `number`
   - toSlot: `number`
 
-**Example**
+<details>
+<summary><b>Example</b></summary>
 
 Prevent lockpicks from being crafted by players.
 
@@ -215,6 +243,8 @@ end, {
 
 ```
 
+</details>
+
 ### usingItem
 
 Triggered when an item is about to be used.
@@ -234,7 +264,8 @@ By returning `false`, you can fully prevent it from being used.
     - metadata: `table`
   - consume: `number`
 
-**Example**
+<details>
+<summary><b>Example</b></summary>
 
 Prevent the player from using the "water" item.
 
@@ -250,6 +281,8 @@ end, {
 })
 ```
 
+</details>
+
 ## removeHooks
 
 Removes a hook created by the invoking resource with the the specified id.  
@@ -259,4 +292,27 @@ If no id is specified then all hooks registered by the resource are removed.
 exports.ox_inventory:removeHooks(id)
 ```
 
-- id?: `number`
+- id?: `string`
+
+## Post-hook events
+
+Post-hook events let you register an event handler that runs after all hooks have finished and the action has either completed successfully or been rejected.
+
+Use the `hookId` returned by registerHook with AddEventHandler to handle post-hook logic.
+
+```lua
+---Use filter logic so only relevant inventories trigger the post-hook event.
+local hookId = exports.ox_inventory:registerHook('swapItems', nil, {
+    inventoryFilter = {
+        '^glove[%w]+',
+        '^trunk[%w]+',
+    }
+})
+
+---Print everytime an item is moved to or from a vehicle inventory.
+---Success will be false if using a hook callback for validation, or if the action was rejected internally by ox_inventory.
+AddEventHandler(hookId, function(success, payload)
+    print(hookId, success)
+    lib.print.info(payload)
+end)
+```