Docs: Update the utils docs

docs/utils-reference/SUMMARY.md

@@ -5,6 +5,7 @@
   - [runAppleScript](utils-reference/functions/runAppleScript.md)
   - [showFailureToast](utils-reference/functions/showFailureToast.md)
   - [createDeeplink](utils-reference/functions/createDeeplink.md)
+  - [executeSQL](utils-reference/functions/executeSQL.md)
 - [Icons](utils-reference/icons/README.md)
   - [getAvatarIcon](utils-reference/icons/getAvatarIcon.md)
   - [getFavicon](utils-reference/icons/getFavicon.md)

docs/utils-reference/functions/executeSQL.md

@@ -0,0 +1,46 @@
+# `executeSQL`
+
+A function that executes a SQL query on a local SQLite database and returns the query result in JSON format.
+
+## Signature
+
+```ts
+function executeSQL<T = unknown>(databasePath: string, query: string): Promise<T[]>
+```
+
+### Arguments
+
+- `databasePath` is the path to the local SQL database.
+- `query` is the SQL query to run on the database.
+
+### Return
+
+Returns a `Promise` that resolves to an array of objects representing the query results.
+
+## Example
+
+```typescript
+import { closeMainWindow, Clipboard } from "@raycast/api";
+import { executeSQL } from "@raycast/utils";
+
+type Message = { body: string; code: string };
+
+const DB_PATH = "/path/to/chat.db";
+
+export default async function Command() {
+  const query = `
+    SELECT body, code
+    FROM message
+    ORDER BY date DESC
+    LIMIT 1;
+  `;
+
+  const messages = await executeSQL<Message>(DB_PATH, query);
+
+  if (messages.length > 0) {
+    const latestCode = messages[0].code;
+    await Clipboard.paste(latestCode);
+    await closeMainWindow();
+  }
+}
+```

docs/utils-reference/getting-started.md

@@ -16,6 +16,10 @@ npm install --save @raycast/utils
 
 ## Changelog
 
+### v1.18.0
+
+- Add a new [`executeSQL](./functions/executeSQL.md) function.
+
 ### v1.17.0
 
 - Add a new [`createDeeplink`](./functions/createDeeplink.md) function.