Prepare @oracle/sql-developer-api 25.2.0 release (#5)

* chore: remove unused files

* feat: prepare @oracle/sql-developer-api 25.2.0 release

* fix: add back the accidently removed changes

* style: fix minor styling issue in the readme

Author: baadi99

extension-api/.npmignore

@@ -1,2 +1,4 @@
 *
 !dist/*
+!CHANGELOG.md
+!SECURITY.md

extension-api/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog for @oracle/sql-developer-api
+
+## 25.2.0 - July 2025
+- Features:
+    - Add support for attaching worksheets to a connection session.
+    - Add support for preparing SQL (i.e. extracting binds, substitutions, SQL id, ..etc).
+- Bug fixes:
+    - Fix exported enums are unusable.
+    - Ensure all types are exported.
+
+## 25.1.0 - July 2025
+Initial Release

extension-api/README.md

@@ -1,4 +1,18 @@
-[TOC]
+# Table of Contents <!-- omit in toc -->
+
+- [Introduction](#introduction)
+- [Getting Started](#getting-started)
+    - [Prerequisites](#prerequisites)
+        - [Install `Oracle SQL Developer Extension for VSCode`](#install--oracle-sql-developer-extension-for-vscode-)
+        - [Install Typescript:](#install-typescript-)
+        - [Install Type definitions for VSCode](#install-type-definitions-for-vscode)
+    - [Installation](#installation)
+- [Usage](#usage)
+    - [Connections](#connections)
+    - [Worksheets](#worksheets)
+- [Contributing](#contributing)
+- [Security](#security)
+- [License](#license)
 
 # Introduction
 
@@ -14,45 +28,52 @@ Provides Typescript type definitions for the API exposed by [Oracle SQL Develope
 
 If you haven't already, install `Oracle SQL Developer Extension for VSCode` using the following [link](https://marketplace.visualstudio.com/items?itemName=Oracle.sql-developer).
 
-**Note:** The extension supports VSCode >=1.97.0, so make sure your VSCode version is at least 1.97.
+**Note:** The extension supports VSCode >=1.101.0, so make sure your VSCode version is at least 1.101.0.
 
 ### Install Typescript:
 
 NPM
+
 ```sh
 npm install --save-dev typescript
 ```
 
 YARN
+
 ```sh
 yarn add --dev typescript
 ```
 
 ### Install Type definitions for VSCode
 
 NPM
+
 ```sh
 npm install --save-dev @types/vscode
 ```
 
 YARN
+
 ```sh
 yarn add --dev @types/vscode
 ```
 
 ## Installation
 
 NPM
+
 ```sh
 npm install --save-dev @oracle/sql-developer-api
 ```
 
 YARN
+
 ```sh
 yarn add --dev @oracle/sql-developer-api
 ```
 
 # Usage
+
 The following code sample illustrates how to retrieve an API instance and use it:
 
 ```ts
@@ -65,15 +86,16 @@ if (!extension) {
 const api = extension.exports;
 ```
 
-
 ## Connections
 
 The API exposes a `Connections` interface, allowing access to connections and connection sessions. For instance, the following snippet allows retrieving the first connection in the connections list, connecting to it and executing a script against the session:
+
 ```ts
 const connections = api.connections().list();
 const session = await connections[0].connect();
 const resultSet = await session.executeQuery({ sql: 'SELECT * FROM dual;' });
 ```
+
 The following table lists all available connection and connection session methods:
 
 <table>
@@ -109,25 +131,31 @@ The following table lists all available connection and connection session method
   </tr>
 
   <tr>
-    <td rowspan="2">Connection Session</td>
+    <td rowspan="3">Connection Session</td>
     <td>executeQuery</td>
     <td>Executes a DQL query and returns a ResultSet object.</td>
   </tr>
   <tr>
     <td>execute</td>
     <td>Executes the given SQL script and returns a result in the specified format.</td>
   </tr>
+  <tr>
+    <td>prepareSql</td>
+    <td>Prepares the SQL to execute by analyzing the given sql script and extracts binds and substitutions.</td>
+  </tr>
 
 </table>
 
 ## Worksheets
 
 The API also exposes a `Worksheets` interface, that provides access to SQL worksheets. The following snippets illustrates how this interface can be leveraged to retrieve the content of the active worksheet and executes it against the attached session:
+
 ```ts
 const activeWorksheet = api.worksheets().activeWorksheet;
 const content = activeWorksheet.editor.document.getText();
 const resultSet = await activeWorksheet.session.executeQuery({ sql: content });
 ```
+
 The following table lists all available worksheets methods:
 
 <table>
@@ -172,19 +200,38 @@ The following table lists all available worksheets methods:
     <td>Registers a command that can be executed from within a worksheet e.g. from the toolbar.</td>
   </tr>
 
+  <tr>
+    <td rowspan="3">Worksheet</td>
+    <td>editor</td>
+    <td>The VSCode text editor that's backing the worksheet.</td>
+  </tr>
+  <tr>
+    <td>session</td>
+    <td>The session associated with the worksheet.</td>
+  </tr>
+  <tr>
+    <td>attach</td>
+    <td>Allows attaching the worksheet to a connection session.</td>
+  </tr>
 
 </table>
 
 Consult [the code samples](https://github.com/oracle/sql-developer-vscode/tree/main/samples) for more examples and code snippets on how to use different parts of the API.
 
-<!-- # Changelog: skipped for first release, will be used starting from next release -->
+# Changelog
+
+Refer to the [changelog](./CHANGELOG.md) for full release notes and version history.
+
+# Contributing
+
+Please review our [contribution guide](https://github.com/oracle/sql-developer-vscode/blob/main/CONTRIBUTING.md).
 
-## Contributing
+# Security
 
-Please review our [contribution guide](https://github.com/oracle/sql-developer-vscode/blob/main/CONTRIBUTING.md)
+Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process.
 
 # License
 
 Copyright (c) 2025 Oracle and/or its affiliates.
 
-Released under the Universal Permissive License v1.0 as shown at <https://oss.oracle.com/licenses/upl/>.
+Released under the Universal Permissive License v1.0 as shown at <https://oss.oracle.com/licenses/upl/>.

extension-api/SECURITY.md

@@ -0,0 +1,38 @@
+# Reporting security vulnerabilities
+
+Oracle values the independent security research community and believes that
+responsible disclosure of security vulnerabilities helps us ensure the security
+and privacy of all our users.
+
+Please do NOT raise a GitHub Issue to report a security vulnerability. If you
+believe you have found a security vulnerability, please submit a report to
+[secalert_us@oracle.com][1] preferably with a proof of concept. Please review
+some additional information on [how to report security vulnerabilities to Oracle][2].
+We encourage people who contact Oracle Security to use email encryption using
+[our encryption key][3].
+
+We ask that you do not use other channels or contact the project maintainers
+directly.
+
+Non-vulnerability related security issues including ideas for new or improved
+security features are welcome on GitHub Issues.
+
+## Security updates, alerts and bulletins
+
+Security updates will be released on a regular cadence. Many of our projects
+will typically release security fixes in conjunction with the
+Oracle Critical Patch Update program. Additional
+information, including past advisories, is available on our [security alerts][4]
+page.
+
+## Security-related information
+
+We will provide security related information such as a threat model, considerations
+for secure use, or any known security issues in our documentation. Please note
+that labs and sample code are intended to demonstrate a concept and may not be
+sufficiently hardened for production use.
+
+[1]: mailto:secalert_us@oracle.com
+[2]: https://www.oracle.com/corporate/security-practices/assurance/vulnerability/reporting.html
+[3]: https://www.oracle.com/security-alerts/encryptionkey.html
+[4]: https://www.oracle.com/security-alerts/