bosa-connectors-binary 0.1.7__cp312-cp312-win_amd64.whl → 0.1.8__cp312-cp312-win_amd64.whl

bosa_connectors/action.pyi

@@ -32,6 +32,8 @@ class ActionExecutor:
         """
     def params(self, params: dict[str, Any]) -> ActionExecutor:
         """Set additional parameters."""
+    def account(self, account: str | None = None) -> ActionExecutor:
+        """Set the user account for the action."""
     def headers(self, headers: dict[str, str]) -> ActionExecutor:
         """Set request headers."""
     def max_attempts(self, attempts: int) -> ActionExecutor:

bosa_connectors/connector.pyi

@@ -78,12 +78,24 @@ class BosaConnector:
         Returns:
             True if the user has an integration for the given app
         """
-    def remove_integration(self, app_name: str, token: str) -> ActionResult:
-        """Removes a 3rd party integration for a user against a certain client.
+    def select_integration(self, app_name: str, token: str, user_identifier: str) -> ActionResult:
+        """Selects a 3rd party integration for a user against a certain client.
 
         Args:
+            token: The BOSA User Token
             app_name: The name of the app/connector to use
+            user_identifier: User identifier to specify which integration to select
+
+        Returns:
+            Result that contains an error message (if any), and the success status.
+        """
+    def remove_integration(self, app_name: str, token: str, user_identifier: str) -> ActionResult:
+        """Removes a 3rd party integration for a user against a certain client.
+
+        Args:
             token: The BOSA User Token
+            app_name: The name of the app/connector to use
+            user_identifier: User identifier to specify which integration to remove
 
         Returns:
             Result that contains an error message (if any), and the success status.
@@ -115,7 +127,7 @@ class BosaConnector:
         Returns:
             Action: A new Action instance for the specified connector
         """
-    def execute(self, app_name: str, action: str, *, max_attempts: int = ..., input_: dict[str, Any] = None, token: str | None = None, headers: dict[str, str] | None = None, timeout: int | None = ..., **kwargs) -> tuple[dict[str, Any] | ConnectorFile, int]:
+    def execute(self, app_name: str, action: str, *, account: str | None = None, max_attempts: int = ..., input_: dict[str, Any] = None, token: str | None = None, headers: dict[str, str] | None = None, timeout: int | None = ..., **kwargs) -> tuple[dict[str, Any] | ConnectorFile, int]:
         """Execute an action on a specific module and return raw response.
 
         The method supports both ways of passing parameters:
@@ -127,6 +139,7 @@ class BosaConnector:
             action: The action to execute
             input_: Optional input data for the action
             token: The BOSA User Token
+            account: Optional user integration account identifier
             headers: Optional headers to include in the request
             max_attempts: The number of times the request can be retried for. Default is 0 (does not retry). Note that
                 the backoff factor is 2^(N - 1) with the basic value being 1 second (1, 2, 4, 8, 16, 32, ...).

bosa_connectors/helpers/integrations.pyi

@@ -5,6 +5,7 @@ from bosa_connectors.models.result import ActionResult as ActionResult
 class BosaIntegrationHelper:
     """Helper class for BOSA API integrations."""
     OAUTH2_FLOW_ENDPOINT: str
+    INTEGRATION_USER_ENDPOINT: str
     INTEGRATION_CHECK_ENDPOINT: str
     DEFAULT_TIMEOUT: int
     api_base_url: Incomplete
@@ -37,12 +38,24 @@ class BosaIntegrationHelper:
         Returns:
             The integration URL
         """
-    def remove_integration(self, app_name: str, token: str) -> ActionResult:
+    def select_integration(self, app_name: str, token: str, user_identifier: str) -> ActionResult:
+        """Selects a 3rd party integration for a user against a certain client.
+
+        Args:
+            token: The BOSA User Token
+            app_name: The name of the app/connector to use
+            user_identifier: User identifier to specify which integration to select
+
+        Returns:
+            Result that contains an error message (if any), and the success status.
+        """
+    def remove_integration(self, app_name: str, token: str, user_identifier: str) -> ActionResult:
         """Removes a 3rd party integration for a user against a certain client.
 
         Args:
             app_name: The name of the app/connector to use
             token: The BOSA User Token
+            user_identifier: User identifier to specify which integration to remove
 
         Returns:
             Result that contains an error message (if any), and the success status.

bosa_connectors/models/action.pyi

@@ -13,4 +13,5 @@ class InitialExecutorRequest(BaseModel):
     headers: dict[str, str] | None
     max_attempts: int | None
     token: str | None
+    account: str | None
     timeout: int | None

bosa_connectors/models/user.pyi

@@ -8,6 +8,7 @@ class ThirdPartyIntegrationAuthBasic(BaseModel):
     user_id: UUID
     connector: str
     user_identifier: str
+    selected: bool
 
 class BosaUser(BaseModel):
     """Model for a BOSA User."""

bosa_connectors/module.pyi

@@ -55,7 +55,7 @@ class BosaConnectorModule:
         Returns:
             Tuple of (cleaned_params, error_details) where error_details is empty if validation passed
         """
-    def execute(self, action: str, max_attempts: int, input_: dict = None, token: str | None = None, authenticator: BaseAuthenticator | None = None, headers: dict[str, str] | None = None, timeout: int | None = ...) -> tuple[dict[str, Any] | ConnectorFile, int]:
+    def execute(self, action: str, max_attempts: int, input_: dict = None, token: str | None = None, account: str | None = None, authenticator: BaseAuthenticator | None = None, headers: dict[str, str] | None = None, timeout: int | None = ...) -> tuple[dict[str, Any] | ConnectorFile, int]:
         """Execute an action with validated parameters and return typed response.
 
         Args:
@@ -64,6 +64,7 @@ class BosaConnectorModule:
                   Will be capped at MAX_RETRY (10) to prevent excessive retries.
             input_: Optional dictionary of parameters
             token: Optional BOSA User Token. If not provided, will use the default token
+            account: Optional integration account to use for the request
             authenticator: Optional authenticator to use for the request
             headers: Optional headers to include in the request
 

{bosa_connectors_binary-0.1.7.dist-info → bosa_connectors_binary-0.1.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: bosa-connectors-binary
-Version: 0.1.7
+Version: 0.1.8
 Summary: BOSA Connectors
 Author-email: Bosa Engineers <bosa-eng@gdplabs.id>
 Requires-Python: <3.14,>=3.11
@@ -38,32 +38,34 @@ A Python SDK for seamlessly connecting to APIs that implement BOSA's Plugin Arch
 - Response fields filtering based on action and output
 
 ## Prerequisites
+
 After the `bosa-api` ready, you can perform the following tasks:
+
 - Ensure Bosa API is running. If you want to test locally, or you can use Staging or Production environments.
 - Create Client
-    - You can send a `create-client` request to the `bosa-api` using Postman with the following header and body:
-        - Header
-            - `x-api-user`: KEY1
-        - Body
-            - `name`: "`{client name}`"
-    - Response :
-      ```json
-      {
-           "data": {
-               "id": "{client_id}",
-               "name": "admin",
-               "api_key": "{client_api_key}",
-               "is_active": true
-           },
-           "meta": null
-      }
-        ```
+  - You can send a `create-client` request to the `bosa-api` using Postman with the following header and body:
+    - Header
+      - `x-api-key`: KEY1
+    - Body
+      - `name`: "`{client name}`"
+  - Response :
+    ```json
+    {
+      "data": {
+        "id": "{client_id}",
+        "name": "admin",
+        "api_key": "{client_api_key}",
+        "is_active": true
+      },
+      "meta": null
+    }
+    ```
 - Register the user, see the details [here](/python/bosa-connectors/README.md#user-authentication).
 
-
 ## Installation
 
 ### Prerequisites
+
 - Python 3.11+ - [Install here](https://www.python.org/downloads/)
 - Pip (if using Pip) - [Install here](https://pip.pypa.io/en/stable/installation/)
 - Poetry 2.1.3+ (if using Poetry) - [Install here](https://python-poetry.org/docs/#installation)
@@ -72,20 +74,25 @@ After the `bosa-api` ready, you can perform the following tasks:
   - Access to the [GDP Labs SDK github repository](https://github.com/GDP-ADMIN/bosa-sdk)
 
 ### 1. Installation from Pypi
+
 Choose one of the following methods to install the package:
 
 #### Using pip
+
 ```bash
 pip install bosa-connectors-binary
 ```
 
 #### Using Poetry
+
 ```bash
 poetry add bosa-connectors-binary
 ```
 
 ### 2. Development Installation (Git)
+
 For development purposes, you can install directly from the Git repository:
+
 ```bash
 poetry add "git+ssh://git@github.com/GDP-ADMIN/bosa-sdk.git#subdirectory=python/bosa-connectors"
 ```
@@ -109,7 +116,6 @@ bosa = BosaConnector(api_base_url="YOUR_BOSA_API_BASE_URL", api_key="YOUR_API_KE
 
 After initializing the connector, you can authenticate with your BOSA API key.
 
-
 ```python
 # User token from authentication
 user_token = "Enter your key (bearer token) here from authentication, or refer to User Authentication section below"
@@ -151,6 +157,7 @@ data, status = bosa.execute("github", "list_collaborators", token=user_token, ma
 print(data)
 print(status)
 ```
+
 More details about parameters and actions in bosa-api docs `{domain}/docs`
 
 ### Alternative Approach (Fluent Interface)
@@ -225,7 +232,7 @@ params = {
 }
 
 # Execute actions with run method
-response = bosa.run('github', 'list_pull_requests', params)
+response = bosa.run('github', 'list_pull_requests', input_=params)
 print(response.get_data())
 ```
 
@@ -375,25 +382,31 @@ user_info = bosa.get_user_info(token.token)
 
 ### ❗ Important Notes
 
-***🛡️ Best Practice:*** Since bearer tokens can have a long lifespan, it is highly recommended to **reuse existing tokens** whenever possible. While creating new tokens is functionally acceptable, be aware that older tokens may become dangling and can pose a security risk if they are exposed or misused.
-
-***⚠️ Security Reminder:*** When you register a new BOSA user, you will receive a token that starts with **"sk-user-..."**. It is essential to keep this token safe, as it **cannot be recovered if lost**, and currently, there is **no option to reset** it.
+**_🛡️ Best Practice:_** Since bearer tokens can have a long lifespan, it is highly recommended to **reuse existing tokens** whenever possible. While creating new tokens is functionally acceptable, be aware that older tokens may become dangling and can pose a security risk if they are exposed or misused.
 
+**_⚠️ Security Reminder:_** When you register a new BOSA user, you will receive a token that starts with **"sk-user-..."**. It is essential to keep this token safe, as it **cannot be recovered if lost**, and currently, there is **no option to reset** it.
 
 ## Integration Management
 
 The BOSA Connector provides methods to manage third-party integrations for authenticated users:
 
 ```python
-# Check if a user has an integration for a connector
-has_integration = bosa.user_has_integration("github", user_token)
-
 # Initiate the OAuth2 flow for a connector
 auth_url = bosa.initiate_connector_auth("github", user_token, "https://your-callback-uri.com")
 # Redirect the user to auth_url to complete authentication
 
+# Check if a user has an integration for a connector
+has_integration = bosa.user_has_integration("github", user_token)
+
+# Retrieve all user integrations information
+user_info = bosa.get_user_info(user_token)
+integrations = user_info.integrations
+
+# Select an integration
+select_result = bosa.select_integration("github", user_token, integrations[0].user_identifier)
+
 # Remove an integration
-remove_result = bosa.remove_integration("github", user_token)
+remove_result = bosa.remove_integration("github", user_token, integrations[0].user_identifier)
 ```
 
 ## References

{bosa_connectors_binary-0.1.7.dist-info → bosa_connectors_binary-0.1.8.dist-info}/RECORD

@@ -1,26 +1,26 @@
-bosa_connectors.cp312-win_amd64.pyd,sha256=bR-xtYRCdm5kfiqSZyXGHe0E-iO_jP5j4JD_B8iRSmc,826880
+bosa_connectors.cp312-win_amd64.pyd,sha256=S-6Sw9Ja1pQD0txmPPqZZ6cRMY_A0yv4GaRh6b2V7NQ,839168
 bosa_connectors.pyi,sha256=nHURoVUwcgMfcsbiXPeT96DBCaaiRIuNm0va3oT_wC8,676
 bosa_connectors/__init__.pyi,sha256=QMIggUyhAA-5o6XI5jl8Mt_xWHSvxrYRZR9zr7qHfXI,390
-bosa_connectors/action.pyi,sha256=huLMYmr6epahbhsFPdploOo7MnLTvOefTORKIqn8KpA,3438
+bosa_connectors/action.pyi,sha256=liB79eOQJFyWHr98tQU6RX_GFMx5-nk7kXBYEdSZZ9I,3560
 bosa_connectors/action_response.pyi,sha256=Ppen9Tp96oubgMopfA9Tx2GYSfH3-QDvW_18roxKvCY,3760
-bosa_connectors/connector.pyi,sha256=ya9q2O79ScJSuuJxHXpQ5L6TPOYBxIxhUBTbYQjFnUI,7440
-bosa_connectors/module.pyi,sha256=XckrNEOuswIW8VblEH7iLZJ9VcbL5CHVeyH-edpt30Q,3353
+bosa_connectors/connector.pyi,sha256=j8FQyNkfXJ8KaPOCEzgIbtuiakO4oLEWCiZlaKj3oqg,8143
+bosa_connectors/module.pyi,sha256=4CvPptWuRkN0Xo0kZ98loqnBy4EA0o_gfzju5tz6xfU,3455
 bosa_connectors/tool.pyi,sha256=Rbd28iEiqChHv7zOrtq5B0dmVS5gwJWToU9Rwuyue0Q,1771
 bosa_connectors/auth/__init__.pyi,sha256=G-QUJ_hSlhki_Hg7BNGwsUtRD04zHDKqCc_XuriVZik,181
 bosa_connectors/auth/api_key.pyi,sha256=jsG1n5cqU_6vcsgsd3ZavXA_CUuqatvo5nVtFW-OOAE,649
 bosa_connectors/auth/base.pyi,sha256=xnNHnbI1SJYNYIfrW6XuBmcLvMArBjs5u8BAx8nDd3Y,329
 bosa_connectors/helpers/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 bosa_connectors/helpers/authenticator.pyi,sha256=vNvEbf_x6h7haom6H3nWCLc1XUZ0TYBh_elbizYE6ck,1566
-bosa_connectors/helpers/integrations.pyi,sha256=slBWBTUvBF6PSrqrLwEUIbZLA3JS7P1Pz7cKz0Ck6kI,2010
+bosa_connectors/helpers/integrations.pyi,sha256=ja1B_nhTNrbUsr3Oby7-h2U87-kNUCX8mYuBRqkzxQY,2654
 bosa_connectors/helpers/model_request_generator.pyi,sha256=blbmp249-R7Qhx04x3wXfpw7Wclb2apWbmw-bXHc5n0,642
 bosa_connectors/models/__init__.pyi,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-bosa_connectors/models/action.pyi,sha256=zTLxMAihqSIiv7E0CC7BBcFU3ReDkmpQluEfSGFETEk,547
+bosa_connectors/models/action.pyi,sha256=tc1pEQYD4L7POjZMHhwxMziwvJovECLXnV1lyn4_hqI,572
 bosa_connectors/models/file.pyi,sha256=R0srYRhrMyYzkPpiZzE6CEVt4QZal0URr6-Yqh4kMtM,245
 bosa_connectors/models/result.pyi,sha256=OSCprPSOgz6BplUzeG8kqpMJ4HCoG6KpLv0j45q3flE,142
 bosa_connectors/models/token.pyi,sha256=2bg8OdilTkUS3WdQzJHQkTofkvD6VglVm9U3Fn-b7r0,216
-bosa_connectors/models/user.pyi,sha256=cW4fGZT7dye34tPZh8gP3WXXi4YW6WJxgADlbetnG_c,688
+bosa_connectors/models/user.pyi,sha256=wgkVol54K5lnRiqrtSf31ToZTD9rnKMYVxPcAi-Lb2I,708
 bosa_connectors.build/.gitignore,sha256=aEiIwOuxfzdCmLZe4oB1JsBmCUxwG8x-u-HBCV9JT8E,1
-bosa_connectors_binary-0.1.7.dist-info/METADATA,sha256=XSz8Po7Z5Nbk8sOEoq2GIS3b1TJ67ahNwR2eq18bBp0,16706
-bosa_connectors_binary-0.1.7.dist-info/WHEEL,sha256=x5rgv--I0NI0IT1Lh9tN1VG2cI637p3deednwYLKnxc,96
-bosa_connectors_binary-0.1.7.dist-info/top_level.txt,sha256=3UzTb-ce0A17T_gQLs-Bhq-ilOx6tosXQJkZbGsRWW8,16
-bosa_connectors_binary-0.1.7.dist-info/RECORD,,
+bosa_connectors_binary-0.1.8.dist-info/METADATA,sha256=CHnXGKytQLQAh2hk938A4RLQBVhCNcPglC4rcrk8tp0,16934
+bosa_connectors_binary-0.1.8.dist-info/WHEEL,sha256=x5rgv--I0NI0IT1Lh9tN1VG2cI637p3deednwYLKnxc,96
+bosa_connectors_binary-0.1.8.dist-info/top_level.txt,sha256=3UzTb-ce0A17T_gQLs-Bhq-ilOx6tosXQJkZbGsRWW8,16
+bosa_connectors_binary-0.1.8.dist-info/RECORD,,