Add sync and async extension create examples

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

README.md

@@ -259,6 +259,7 @@ Ready-to-run examples are available in `examples/`:
 
 - `examples/async_batch_fetch.py`
 - `examples/async_crawl.py`
+- `examples/async_extension_create.py`
 - `examples/async_extension_list.py`
 - `examples/async_extract.py`
 - `examples/async_profile_list.py`
@@ -270,6 +271,7 @@ Ready-to-run examples are available in `examples/`:
 - `examples/async_web_search.py`
 - `examples/sync_batch_fetch.py`
 - `examples/sync_crawl.py`
+- `examples/sync_extension_create.py`
 - `examples/sync_extension_list.py`
 - `examples/sync_extract.py`
 - `examples/sync_profile_list.py`

examples/async_extension_create.py

@@ -0,0 +1,34 @@
+"""
+Asynchronous extension create example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    export HYPERBROWSER_EXTENSION_ZIP="/absolute/path/to/extension.zip"
+    python3 examples/async_extension_create.py
+"""
+
+import asyncio
+import os
+
+from hyperbrowser import AsyncHyperbrowser
+from hyperbrowser.exceptions import HyperbrowserError
+from hyperbrowser.models.extension import CreateExtensionParams
+
+
+async def main() -> None:
+    extension_zip_path = os.getenv("HYPERBROWSER_EXTENSION_ZIP")
+    if extension_zip_path is None:
+        raise HyperbrowserError("Set HYPERBROWSER_EXTENSION_ZIP before running")
+
+    async with AsyncHyperbrowser() as client:
+        extension = await client.extensions.create(
+            CreateExtensionParams(
+                name="my-extension",
+                file_path=extension_zip_path,
+            )
+        )
+        print(f"Created extension: {extension.id} ({extension.name})")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/sync_extension_create.py

@@ -0,0 +1,33 @@
+"""
+Synchronous extension create example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    export HYPERBROWSER_EXTENSION_ZIP="/absolute/path/to/extension.zip"
+    python3 examples/sync_extension_create.py
+"""
+
+import os
+
+from hyperbrowser import Hyperbrowser
+from hyperbrowser.exceptions import HyperbrowserError
+from hyperbrowser.models.extension import CreateExtensionParams
+
+
+def main() -> None:
+    extension_zip_path = os.getenv("HYPERBROWSER_EXTENSION_ZIP")
+    if extension_zip_path is None:
+        raise HyperbrowserError("Set HYPERBROWSER_EXTENSION_ZIP before running")
+
+    with Hyperbrowser() as client:
+        extension = client.extensions.create(
+            CreateExtensionParams(
+                name="my-extension",
+                file_path=extension_zip_path,
+            )
+        )
+        print(f"Created extension: {extension.id} ({extension.name})")
+
+
+if __name__ == "__main__":
+    main()