Initial

Author: paulkr

Diff for: .github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish Python 🐍 distribution 📦 to PyPI
+
+on:
+  push:
+    tags:
+     - '*'
+
+jobs:
+  build-n-publish:
+    name: Build and publish Python 🐍 distribution 📦 to PyPI
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.x"
+    
+    - name: Install pypa/build
+      run: >-
+        python -m
+        pip install
+        build
+        --user
+    - name: Build a binary wheel and a source tarball
+      run: >-
+        python -m
+        build
+        --sdist
+        --wheel
+        --outdir dist/
+        .
+    
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}

Diff for: .gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/
+
+# Operating System Files
+.DS_Store
+Thumbs.db

Diff for: LICENSE

@@ -0,0 +1,46 @@
+# IntegrationOS AuthKit SDK for Python
+
+Secure token generation for [IntegrationOS AuthKit](https://docs.integrationos.com/docs/authkit)
+using [PyPI](https://pypi.org/).
+
+## Installation
+
+You can install the IntegrationOS AuthKit SDK using pip:
+
+```
+pip install integrationos-authkit
+```
+
+## Usage
+
+Here's a quick example of how to use the SDK:
+
+```python
+from integrationos import AuthKit
+
+# Initialize the AuthKit with your secret
+auth_kit = AuthKit("your_secret_here")
+
+# Create an embed token
+payload = {
+    "group": "your_group",
+    "label": "your_label",
+    # Add other required parameters
+}
+
+result = auth_kit.create(payload)
+print(result)
+```
+
+You'll want to switch out the API Key for your own, which will later tell your frontend which integrations you'd like to
+make available to your users.
+
+You'll also want to populate the `Group` and `Label` fields depending on how you want to organize and query your users'
+connected accounts. The Group is especially important as it's used to generate the
+unique [Connection Key](https://docs.integrationos.com/docs/setup) for the user once they successfully connect an
+account.
+
+## Full Documentation
+
+Please refer to the official [IntegrationOS AuthKit](https://docs.integrationos.com/docs/authkit) docs for a more
+holistic understanding of IntegrationOS AuthKit.

Diff for: README.md

@@ -0,0 +1,5 @@
+from .auth_kit import AuthKit
+
+__all__ = ['AuthKit']
+
+__version__ = "0.1.0"

Diff for: integrationos/__init__.py

@@ -0,0 +1,102 @@
+import time
+import requests
+from typing import Dict, List, Union
+
+class AuthKit:
+    def __init__(self, secret: str, configs: Dict = None):
+        self.secret = secret
+        self.configs = configs or {}
+        self.environment = "live" if "sk_live_" in secret else "test"
+
+    def _get_url(self, type: str) -> str:
+        services_url = self.configs.get("base_url", "https://api.integrationos.com")
+        
+        if "localhost" in services_url:
+            api_url = "http://localhost:3005"
+        elif "development" in services_url:
+            api_url = "https://development-api.integrationos.com"
+        else:
+            api_url = "https://api.integrationos.com"
+
+        urls = {
+            "get_settings": f"{services_url}/internal/v1/settings/get",
+            "create_event_link": f"{services_url}/internal/v1/event-links/create",
+            "get_connection_definitions": f"{api_url}/v1/public/connection-definitions?limit=100",
+            "create_embed_token": f"{services_url}/internal/v1/embed-tokens/create",
+            "get_session_id": f"{services_url}/v1/public/generate-id/session_id",
+        }
+        return urls[type]
+
+    def _get_headers(self, type: str = "buildable") -> Dict[str, str]:
+        if type == "buildable":
+            return {
+                "X-Buildable-Secret": self.secret,
+                "Content-Type": "application/json",
+            }
+        elif type == "ios_secret":
+            return {
+                "x-integrationos-secret": self.secret
+            }
+
+    def _api_call(self, method_type: str, url: str, payload: Dict = None, headers: Dict = None) -> Dict:
+        kwargs = {}
+        if payload:
+            kwargs['json'] = payload
+        if headers:
+            kwargs['headers'] = headers
+
+        response = requests.request(method_type, url, **kwargs)
+        response.raise_for_status()
+        return response.json()
+
+    def _get_settings(self) -> Dict:
+        return self._api_call("POST", self._get_url("get_settings"), headers=self._get_headers())
+
+    def _create_event_link(self, payload: Dict) -> Dict:
+        payload["environment"] = "test" if self.secret.startswith("sk_test") else "live"
+        payload["usageSource"] = "sdk"
+        return self._api_call("POST", self._get_url("create_event_link"), payload, self._get_headers())
+
+    def _get_connection_definitions(self) -> Dict:
+        return self._api_call("GET", self._get_url("get_connection_definitions"), headers=self._get_headers("ios_secret"))
+
+    def _get_session_id(self) -> Dict:
+        return self._api_call("GET", self._get_url("get_session_id"))
+
+    def _create_embed_token(self, connected_platforms: List, event_links: Dict, settings: Dict) -> Dict:
+        token_payload = {
+            "linkSettings": {
+                "connectedPlatforms": connected_platforms,
+                "eventIncToken": event_links["token"]
+            },
+            "group": event_links["group"],
+            "label": event_links["label"],
+            "environment": "test" if self.secret.startswith("sk_test") else "live",
+            "expiresAt": int(time.time() * 1000) + (5 * 1000 * 60),
+            "sessionId": self._get_session_id()['id'],
+            "features": settings["features"]
+        }
+        return self._api_call("POST", self._get_url("create_embed_token"), token_payload, self._get_headers())
+
+    def create(self, payload: Dict) -> Union[Dict, str]:
+        try:
+            settings = self._get_settings()
+            event_link = self._create_event_link(payload)
+            connection_definitions = self._get_connection_definitions()
+
+            active_connection_definitions = [cd for cd in connection_definitions.get("rows", []) if cd.get("active")]
+            connected_platforms = [
+                platform for platform in settings.get("connectedPlatforms", [])
+                if platform.get("connectionDefinitionId") in [cd.get("_id") for cd in active_connection_definitions]
+                and platform.get("active")
+                and (
+                    self.environment == "live"
+                    and platform.get("environment") == "live"
+                    or self.environment == "test"
+                    and (platform.get("environment") == "test" or "environment" not in platform)
+                )
+            ]
+
+            return self._create_embed_token(connected_platforms, event_link, settings)
+        except requests.RequestException as e:
+            return {"message": str(e)}

Diff for: integrationos/auth_kit.py

@@ -0,0 +1,31 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="integrationos-authkit",
+    version="0.1.0",
+    author="IntegrationOS",
+    author_email="[email protected]",
+    description="Secure token generation for IntegrationOS AuthKit in Python",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/integration-os/authkit-python",
+    packages=['integrationos'],
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+    ],
+    python_requires=">=3.6",
+    install_requires=[
+        "requests>=2.25.1",
+    ],
+)