accessgrid 0.1.0__tar.gz

accessgrid-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AccessGrid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

accessgrid-0.1.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.2
+Name: accessgrid
+Version: 0.1.0
+Summary: Python SDK for the AccessGrid API
+Home-page: https://github.com/yourusername/accessgrid-python
+Author: Your Name
+Author-email: your.email@example.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.3.0; extra == "dev"
+Requires-Dist: isort>=5.10.1; extra == "dev"
+Requires-Dist: flake8>=4.0.1; extra == "dev"
+Requires-Dist: mypy>=0.981; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.2; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AccessGrid SDK
+
+A JavaScript SDK for interacting with the [AccessGrid.com](https://www.accessgrid.com) API. This SDK provides a simple interface for managing NFC key cards and enterprise templates. Full docs at https://www.accessgrid.com/docs
+
+## Installation
+
+```bash
+npm install accessgrid
+```
+
+## Quick Start
+
+```javascript
+import AccessGrid from 'accessgrid';
+
+const accountId = process.env.ACCOUNT_ID;
+const secretKey = process.env.SECRET_KEY;
+
+const client = new AccessGrid(accountId, secretKey);
+```
+
+## API Reference
+
+### Access Cards
+
+#### Provision a new card
+
+```javascript
+const card = await client.accessCards.provision({
+  cardTemplateId: "0xd3adb00b5",
+  employeeId: "123456789",
+  tagId: "DDEADB33FB00B5",
+  allowOnMultipleDevices: true,
+  fullName: "Employee name",
+  email: "employee@yourwebsite.com",
+  phoneNumber: "+19547212241",
+  classification: "full_time",
+  startDate: "2025-01-31T22:46:25.601Z",
+  expirationDate: "2025-04-30T22:46:25.601Z",
+  employeePhoto: "[image_in_base64_encoded_format]"
+});
+```
+
+#### Update a card
+
+```javascript
+const card = await client.accessCards.update({
+  cardId: "0xc4rd1d",
+  employeeId: "987654321",
+  fullName: "Updated Employee Name",
+  classification: "contractor",
+  expirationDate: "2025-02-22T21:04:03.664Z",
+  employeePhoto: "[image_in_base64_encoded_format]"
+});
+```
+
+#### Manage card states
+
+```javascript
+// Suspend a card
+await client.accessCards.suspend({
+  cardId: "0xc4rd1d"
+});
+
+// Resume a card
+await client.accessCards.resume({
+  cardId: "0xc4rd1d"
+});
+
+// Unlink a card
+await client.accessCards.unlink({
+  cardId: "0xc4rd1d"
+});
+```
+
+### Enterprise Console
+
+#### Create a template
+
+```javascript
+const template = await client.console.createTemplate({
+  name: "Employee NFC key",
+  platform: "apple",
+  useCase: "employee_badge",
+  protocol: "desfire",
+  allowOnMultipleDevices: true,
+  watchCount: 2,
+  iphoneCount: 3,
+  design: {
+    backgroundColor: "#FFFFFF",
+    labelColor: "#000000",
+    labelSecondaryColor: "#333333",
+    backgroundImage: "[image_in_base64_encoded_format]",
+    logoImage: "[image_in_base64_encoded_format]",
+    iconImage: "[image_in_base64_encoded_format]"
+  },
+  supportInfo: {
+    supportUrl: "https://help.yourcompany.com",
+    supportPhoneNumber: "+1-555-123-4567",
+    supportEmail: "support@yourcompany.com",
+    privacyPolicyUrl: "https://yourcompany.com/privacy",
+    termsAndConditionsUrl: "https://yourcompany.com/terms"
+  }
+});
+```
+
+#### Update a template
+
+```javascript
+const template = await client.console.updateTemplate({
+  cardTemplateId: "0xd3adb00b5",
+  name: "Updated Employee NFC key",
+  allowOnMultipleDevices: true,
+  watchCount: 2,
+  iphoneCount: 3,
+  supportInfo: {
+    supportUrl: "https://help.yourcompany.com",
+    supportPhoneNumber: "+1-555-123-4567",
+    supportEmail: "support@yourcompany.com",
+    privacyPolicyUrl: "https://yourcompany.com/privacy",
+    termsAndConditionsUrl: "https://yourcompany.com/terms"
+  }
+});
+```
+
+#### Read a template
+
+```javascript
+const template = await client.console.readTemplate({
+  cardTemplateId: "0xd3adb00b5"
+});
+```
+
+#### Get event logs
+
+```javascript
+const events = await client.console.eventLog({
+  cardTemplateId: "0xd3adb00b5",
+  filters: {
+    device: "mobile", // "mobile" or "watch"
+    startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString(),
+    endDate: new Date().toISOString(),
+    eventType: "install"
+  }
+});
+```
+
+## Configuration
+
+The SDK can be configured with custom options:
+
+```javascript
+const client = new AccessGrid(accountId, secretKey, {
+  baseUrl: 'https://api.staging.accessgrid.com' // Use a different API endpoint
+});
+```
+
+## Error Handling
+
+The SDK throws errors for various scenarios including:
+- Missing required credentials
+- API request failures
+- Invalid parameters
+- Server errors
+
+Example error handling:
+
+```javascript
+try {
+  const card = await client.accessCards.provision({
+    // ... parameters
+  });
+} catch (error) {
+  console.error('Failed to provision card:', error.message);
+}
+```
+
+## Requirements
+
+- Node.js 12 or higher
+- Modern browser environment with support for:
+  - Fetch API
+  - Web Crypto API
+  - Promises
+  - async/await
+
+## Security
+
+The SDK automatically handles:
+- Request signing using HMAC-SHA256
+- Secure payload encoding
+- Authentication headers
+- HTTPS communication
+
+Never expose your `secretKey` in client-side code. Always use environment variables or a secure configuration management system.
+
+## License
+
+MIT License - See LICENSE file for details.

accessgrid-0.1.0/README.md

@@ -0,0 +1,199 @@
+# AccessGrid SDK
+
+A JavaScript SDK for interacting with the [AccessGrid.com](https://www.accessgrid.com) API. This SDK provides a simple interface for managing NFC key cards and enterprise templates. Full docs at https://www.accessgrid.com/docs
+
+## Installation
+
+```bash
+npm install accessgrid
+```
+
+## Quick Start
+
+```javascript
+import AccessGrid from 'accessgrid';
+
+const accountId = process.env.ACCOUNT_ID;
+const secretKey = process.env.SECRET_KEY;
+
+const client = new AccessGrid(accountId, secretKey);
+```
+
+## API Reference
+
+### Access Cards
+
+#### Provision a new card
+
+```javascript
+const card = await client.accessCards.provision({
+  cardTemplateId: "0xd3adb00b5",
+  employeeId: "123456789",
+  tagId: "DDEADB33FB00B5",
+  allowOnMultipleDevices: true,
+  fullName: "Employee name",
+  email: "employee@yourwebsite.com",
+  phoneNumber: "+19547212241",
+  classification: "full_time",
+  startDate: "2025-01-31T22:46:25.601Z",
+  expirationDate: "2025-04-30T22:46:25.601Z",
+  employeePhoto: "[image_in_base64_encoded_format]"
+});
+```
+
+#### Update a card
+
+```javascript
+const card = await client.accessCards.update({
+  cardId: "0xc4rd1d",
+  employeeId: "987654321",
+  fullName: "Updated Employee Name",
+  classification: "contractor",
+  expirationDate: "2025-02-22T21:04:03.664Z",
+  employeePhoto: "[image_in_base64_encoded_format]"
+});
+```
+
+#### Manage card states
+
+```javascript
+// Suspend a card
+await client.accessCards.suspend({
+  cardId: "0xc4rd1d"
+});
+
+// Resume a card
+await client.accessCards.resume({
+  cardId: "0xc4rd1d"
+});
+
+// Unlink a card
+await client.accessCards.unlink({
+  cardId: "0xc4rd1d"
+});
+```
+
+### Enterprise Console
+
+#### Create a template
+
+```javascript
+const template = await client.console.createTemplate({
+  name: "Employee NFC key",
+  platform: "apple",
+  useCase: "employee_badge",
+  protocol: "desfire",
+  allowOnMultipleDevices: true,
+  watchCount: 2,
+  iphoneCount: 3,
+  design: {
+    backgroundColor: "#FFFFFF",
+    labelColor: "#000000",
+    labelSecondaryColor: "#333333",
+    backgroundImage: "[image_in_base64_encoded_format]",
+    logoImage: "[image_in_base64_encoded_format]",
+    iconImage: "[image_in_base64_encoded_format]"
+  },
+  supportInfo: {
+    supportUrl: "https://help.yourcompany.com",
+    supportPhoneNumber: "+1-555-123-4567",
+    supportEmail: "support@yourcompany.com",
+    privacyPolicyUrl: "https://yourcompany.com/privacy",
+    termsAndConditionsUrl: "https://yourcompany.com/terms"
+  }
+});
+```
+
+#### Update a template
+
+```javascript
+const template = await client.console.updateTemplate({
+  cardTemplateId: "0xd3adb00b5",
+  name: "Updated Employee NFC key",
+  allowOnMultipleDevices: true,
+  watchCount: 2,
+  iphoneCount: 3,
+  supportInfo: {
+    supportUrl: "https://help.yourcompany.com",
+    supportPhoneNumber: "+1-555-123-4567",
+    supportEmail: "support@yourcompany.com",
+    privacyPolicyUrl: "https://yourcompany.com/privacy",
+    termsAndConditionsUrl: "https://yourcompany.com/terms"
+  }
+});
+```
+
+#### Read a template
+
+```javascript
+const template = await client.console.readTemplate({
+  cardTemplateId: "0xd3adb00b5"
+});
+```
+
+#### Get event logs
+
+```javascript
+const events = await client.console.eventLog({
+  cardTemplateId: "0xd3adb00b5",
+  filters: {
+    device: "mobile", // "mobile" or "watch"
+    startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString(),
+    endDate: new Date().toISOString(),
+    eventType: "install"
+  }
+});
+```
+
+## Configuration
+
+The SDK can be configured with custom options:
+
+```javascript
+const client = new AccessGrid(accountId, secretKey, {
+  baseUrl: 'https://api.staging.accessgrid.com' // Use a different API endpoint
+});
+```
+
+## Error Handling
+
+The SDK throws errors for various scenarios including:
+- Missing required credentials
+- API request failures
+- Invalid parameters
+- Server errors
+
+Example error handling:
+
+```javascript
+try {
+  const card = await client.accessCards.provision({
+    // ... parameters
+  });
+} catch (error) {
+  console.error('Failed to provision card:', error.message);
+}
+```
+
+## Requirements
+
+- Node.js 12 or higher
+- Modern browser environment with support for:
+  - Fetch API
+  - Web Crypto API
+  - Promises
+  - async/await
+
+## Security
+
+The SDK automatically handles:
+- Request signing using HMAC-SHA256
+- Secure payload encoding
+- Authentication headers
+- HTTPS communication
+
+Never expose your `secretKey` in client-side code. Always use environment variables or a secure configuration management system.
+
+## License
+
+MIT License - See LICENSE file for details.

accessgrid-0.1.0/accessgrid/__init__.py

@@ -0,0 +1,39 @@
+"""
+AccessGrid Python SDK
+~~~~~~~~~~~~~~~~~~~~
+
+A Python SDK for interacting with the AccessGrid.com API.
+
+Basic usage:
+
+    >>> from accessgrid import AccessGrid
+    >>> client = AccessGrid(account_id="your_id", secret_key="your_key")
+    >>> card = client.access_cards.provision(
+    ...     card_template_id="template_id",
+    ...     full_name="Employee Name"
+    ... )
+    >>> print(card.url)
+
+For more information, see https://www.accessgrid.com/docs
+"""
+
+# Import all public components
+from .client import (
+    AccessGrid,
+    AccessGridError,
+    AuthenticationError,
+    AccessCard,
+    Template
+)
+
+# Version of the accessgrid package
+__version__ = "0.1.0"
+
+# List of public objects that will be exported with "from accessgrid import *"
+__all__ = [
+    'AccessGrid',
+    'AccessGridError',
+    'AuthenticationError',
+    'AccessCard',
+    'Template'
+]

accessgrid-0.1.0/accessgrid/client.py

@@ -0,0 +1,183 @@
+import base64
+import hmac
+import hashlib
+import json
+import requests
+from datetime import datetime, timezone
+from urllib.parse import quote
+from typing import Optional, Dict, Any, List
+
+class AccessGridError(Exception):
+    """Base exception for AccessGrid SDK"""
+    pass
+
+class AuthenticationError(AccessGridError):
+    """Raised when authentication fails"""
+    pass
+
+class AccessCard:
+    def __init__(self, client, data: Dict[str, Any]):
+        self._client = client
+        self.id = data.get('id')
+        self.url = data.get('install_url')
+        self.state = data.get('state')
+        self.full_name = data.get('full_name')
+        self.expiration_date = data.get('expiration_date')
+
+class Template:
+    def __init__(self, client, data: Dict[str, Any]):
+        self._client = client
+        self.id = data.get('id')
+        self.name = data.get('name')
+        self.platform = data.get('platform')
+        self.use_case = data.get('use_case')
+        self.protocol = data.get('protocol')
+        self.created_at = data.get('created_at')
+        self.last_published_at = data.get('last_published_at')
+        self.issued_keys_count = data.get('issued_keys_count')
+        self.active_keys_count = data.get('active_keys_count')
+        self.allowed_device_counts = data.get('allowed_device_counts')
+        self.support_settings = data.get('support_settings')
+        self.terms_settings = data.get('terms_settings')
+        self.style_settings = data.get('style_settings')
+
+class AccessCards:
+    def __init__(self, client):
+        self._client = client
+
+    def provision(self, card_template_id: str, **kwargs) -> AccessCard:
+        """Provision a new access card"""
+        payload = {
+            'card_template_id': card_template_id,
+            **kwargs
+        }
+        response = self._client._post('/api/v1/nfc_keys/issue', payload)
+        return AccessCard(self._client, response)
+
+    def update(self, card_id: str, **kwargs) -> AccessCard:
+        """Update an existing access card"""
+        payload = {
+            'card_id': card_id,
+            **kwargs
+        }
+        response = self._client._post('/api/v1/nfc_keys/update', payload)
+        return AccessCard(self._client, response)
+
+    def _manage(self, card_id: str, action: str) -> AccessCard:
+        """Internal method for card management actions"""
+        payload = {
+            'card_id': card_id,
+            'manage_action': action
+        }
+        response = self._client._post('/api/v1/nfc_keys/manage', payload)
+        return AccessCard(self._client, response)
+
+    def suspend(self, card_id: str) -> AccessCard:
+        """Suspend an access card"""
+        return self._manage(card_id, 'suspend')
+
+    def resume(self, card_id: str) -> AccessCard:
+        """Resume a suspended access card"""
+        return self._manage(card_id, 'resume')
+
+    def unlink(self, card_id: str) -> AccessCard:
+        """Unlink an access card"""
+        return self._manage(card_id, 'unlink')
+
+class Console:
+    def __init__(self, client):
+        self._client = client
+
+    def create_template(self, **kwargs) -> Template:
+        """Create a new card template"""
+        response = self._client._post('/api/v1/enterprise/create_template', kwargs)
+        return Template(self._client, response)
+
+    def update_template(self, card_template_id: str, **kwargs) -> Template:
+        """Update an existing card template"""
+        response = self._client._post(f'/api/v1/enterprise/update_template/{card_template_id}', kwargs)
+        return Template(self._client, response)
+
+    def read_template(self, card_template_id: str) -> Template:
+        """Get details of a card template"""
+        response = self._client._get(f'/api/v1/enterprise/read_template/{card_template_id}')
+        return Template(self._client, response)
+
+    def event_log(self, card_template_id: str, filters: Optional[Dict] = None, 
+                 page: int = 1, per_page: int = 50) -> Dict[str, Any]:
+        """Get event logs for a card template"""
+        params = {
+            'page': page,
+            'per_page': per_page
+        }
+        if filters:
+            params['filters'] = filters
+            
+        return self._client._get(f'/api/v1/enterprise/logs/{card_template_id}', params)
+
+class AccessGrid:
+    def __init__(self, account_id: str, secret_key: str, base_url: str = 'https://api.accessgrid.com'):
+        if not account_id:
+            raise ValueError("Account ID is required")
+        if not secret_key:
+            raise ValueError("Secret Key is required")
+
+        self.account_id = account_id
+        self.secret_key = secret_key
+        self.base_url = base_url.rstrip('/')
+        self.access_cards = AccessCards(self)
+        self.console = Console(self)
+
+    def _generate_signature(self, payload: str) -> str:
+        """Generate HMAC signature for the payload"""
+        encoded_payload = base64.b64encode(payload.encode()).decode()
+        return hmac.new(
+            self.secret_key.encode(),
+            encoded_payload.encode(),
+            hashlib.sha256
+        ).hexdigest()
+
+    def _make_request(self, method: str, endpoint: str, 
+                     data: Optional[Dict] = None, 
+                     params: Optional[Dict] = None) -> Dict[str, Any]:
+        """Make an HTTP request to the API"""
+        url = f"{self.base_url}{endpoint}"
+        
+        # Prepare payload and signature
+        payload = json.dumps(data) if data else ""
+        headers = {
+            'X-ACCT-ID': self.account_id,
+            'X-PAYLOAD-SIG': self._generate_signature(payload),
+            'Content-Type': 'application/json'
+        }
+
+        try:
+            response = requests.request(
+                method=method,
+                url=url,
+                headers=headers,
+                json=data if data else None,
+                params=params
+            )
+            
+            if response.status_code == 401:
+                raise AuthenticationError("Invalid credentials")
+            elif response.status_code == 402:
+                raise AccessGridError("Insufficient account balance")
+            elif not 200 <= response.status_code < 300:
+                error_data = response.json() if response.text else {}
+                error_message = error_data.get('message', response.text)
+                raise AccessGridError(f"API request failed: {error_message}")
+
+            return response.json()
+
+        except requests.exceptions.RequestException as e:
+            raise AccessGridError(f"Request failed: {str(e)}")
+
+    def _get(self, endpoint: str, params: Optional[Dict] = None) -> Dict[str, Any]:
+        """Make a GET request"""
+        return self._make_request('GET', endpoint, params=params)
+
+    def _post(self, endpoint: str, data: Dict) -> Dict[str, Any]:
+        """Make a POST request"""
+        return self._make_request('POST', endpoint, data=data)

accessgrid-0.1.0/accessgrid.egg-info/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.2
+Name: accessgrid
+Version: 0.1.0
+Summary: Python SDK for the AccessGrid API
+Home-page: https://github.com/yourusername/accessgrid-python
+Author: Your Name
+Author-email: your.email@example.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.3.0; extra == "dev"
+Requires-Dist: isort>=5.10.1; extra == "dev"
+Requires-Dist: flake8>=4.0.1; extra == "dev"
+Requires-Dist: mypy>=0.981; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.2; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AccessGrid SDK
+
+A JavaScript SDK for interacting with the [AccessGrid.com](https://www.accessgrid.com) API. This SDK provides a simple interface for managing NFC key cards and enterprise templates. Full docs at https://www.accessgrid.com/docs
+
+## Installation
+
+```bash
+npm install accessgrid
+```
+
+## Quick Start
+
+```javascript
+import AccessGrid from 'accessgrid';
+
+const accountId = process.env.ACCOUNT_ID;
+const secretKey = process.env.SECRET_KEY;
+
+const client = new AccessGrid(accountId, secretKey);
+```
+
+## API Reference
+
+### Access Cards
+
+#### Provision a new card
+
+```javascript
+const card = await client.accessCards.provision({
+  cardTemplateId: "0xd3adb00b5",
+  employeeId: "123456789",
+  tagId: "DDEADB33FB00B5",
+  allowOnMultipleDevices: true,
+  fullName: "Employee name",
+  email: "employee@yourwebsite.com",
+  phoneNumber: "+19547212241",
+  classification: "full_time",
+  startDate: "2025-01-31T22:46:25.601Z",
+  expirationDate: "2025-04-30T22:46:25.601Z",
+  employeePhoto: "[image_in_base64_encoded_format]"
+});
+```
+
+#### Update a card
+
+```javascript
+const card = await client.accessCards.update({
+  cardId: "0xc4rd1d",
+  employeeId: "987654321",
+  fullName: "Updated Employee Name",
+  classification: "contractor",
+  expirationDate: "2025-02-22T21:04:03.664Z",
+  employeePhoto: "[image_in_base64_encoded_format]"
+});
+```
+
+#### Manage card states
+
+```javascript
+// Suspend a card
+await client.accessCards.suspend({
+  cardId: "0xc4rd1d"
+});
+
+// Resume a card
+await client.accessCards.resume({
+  cardId: "0xc4rd1d"
+});
+
+// Unlink a card
+await client.accessCards.unlink({
+  cardId: "0xc4rd1d"
+});
+```
+
+### Enterprise Console
+
+#### Create a template
+
+```javascript
+const template = await client.console.createTemplate({
+  name: "Employee NFC key",
+  platform: "apple",
+  useCase: "employee_badge",
+  protocol: "desfire",
+  allowOnMultipleDevices: true,
+  watchCount: 2,
+  iphoneCount: 3,
+  design: {
+    backgroundColor: "#FFFFFF",
+    labelColor: "#000000",
+    labelSecondaryColor: "#333333",
+    backgroundImage: "[image_in_base64_encoded_format]",
+    logoImage: "[image_in_base64_encoded_format]",
+    iconImage: "[image_in_base64_encoded_format]"
+  },
+  supportInfo: {
+    supportUrl: "https://help.yourcompany.com",
+    supportPhoneNumber: "+1-555-123-4567",
+    supportEmail: "support@yourcompany.com",
+    privacyPolicyUrl: "https://yourcompany.com/privacy",
+    termsAndConditionsUrl: "https://yourcompany.com/terms"
+  }
+});
+```
+
+#### Update a template
+
+```javascript
+const template = await client.console.updateTemplate({
+  cardTemplateId: "0xd3adb00b5",
+  name: "Updated Employee NFC key",
+  allowOnMultipleDevices: true,
+  watchCount: 2,
+  iphoneCount: 3,
+  supportInfo: {
+    supportUrl: "https://help.yourcompany.com",
+    supportPhoneNumber: "+1-555-123-4567",
+    supportEmail: "support@yourcompany.com",
+    privacyPolicyUrl: "https://yourcompany.com/privacy",
+    termsAndConditionsUrl: "https://yourcompany.com/terms"
+  }
+});
+```
+
+#### Read a template
+
+```javascript
+const template = await client.console.readTemplate({
+  cardTemplateId: "0xd3adb00b5"
+});
+```
+
+#### Get event logs
+
+```javascript
+const events = await client.console.eventLog({
+  cardTemplateId: "0xd3adb00b5",
+  filters: {
+    device: "mobile", // "mobile" or "watch"
+    startDate: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString(),
+    endDate: new Date().toISOString(),
+    eventType: "install"
+  }
+});
+```
+
+## Configuration
+
+The SDK can be configured with custom options:
+
+```javascript
+const client = new AccessGrid(accountId, secretKey, {
+  baseUrl: 'https://api.staging.accessgrid.com' // Use a different API endpoint
+});
+```
+
+## Error Handling
+
+The SDK throws errors for various scenarios including:
+- Missing required credentials
+- API request failures
+- Invalid parameters
+- Server errors
+
+Example error handling:
+
+```javascript
+try {
+  const card = await client.accessCards.provision({
+    // ... parameters
+  });
+} catch (error) {
+  console.error('Failed to provision card:', error.message);
+}
+```
+
+## Requirements
+
+- Node.js 12 or higher
+- Modern browser environment with support for:
+  - Fetch API
+  - Web Crypto API
+  - Promises
+  - async/await
+
+## Security
+
+The SDK automatically handles:
+- Request signing using HMAC-SHA256
+- Secure payload encoding
+- Authentication headers
+- HTTPS communication
+
+Never expose your `secretKey` in client-side code. Always use environment variables or a secure configuration management system.
+
+## License
+
+MIT License - See LICENSE file for details.

accessgrid-0.1.0/accessgrid.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+accessgrid/__init__.py
+accessgrid/client.py
+accessgrid.egg-info/PKG-INFO
+accessgrid.egg-info/SOURCES.txt
+accessgrid.egg-info/dependency_links.txt
+accessgrid.egg-info/requires.txt
+accessgrid.egg-info/top_level.txt
+tests/__init__.py
+tests/test_accessgrid.py

accessgrid-0.1.0/accessgrid.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

accessgrid-0.1.0/accessgrid.egg-info/requires.txt

@@ -0,0 +1,12 @@
+requests>=2.25.0
+
+[dev]
+pytest>=7.0.0
+pytest-mock>=3.10.0
+pytest-cov>=4.0.0
+black>=22.3.0
+isort>=5.10.1
+flake8>=4.0.1
+mypy>=0.981
+build>=0.10.0
+twine>=4.0.2

accessgrid-0.1.0/accessgrid.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+accessgrid
+tests

accessgrid-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"

accessgrid-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

accessgrid-0.1.0/setup.py

@@ -0,0 +1,46 @@
+from setuptools import setup, find_packages
+
+# Read README for the long description
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="accessgrid",
+    version="0.1.0",
+    author="Your Name",
+    author_email="your.email@example.com",
+    description="Python SDK for the AccessGrid API",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/yourusername/accessgrid-python",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=7.0.0",
+            "pytest-mock>=3.10.0",
+            "pytest-cov>=4.0.0",
+            "black>=22.3.0",
+            "isort>=5.10.1",
+            "flake8>=4.0.1",
+            "mypy>=0.981",
+            "build>=0.10.0",
+            "twine>=4.0.2",
+        ],
+    },
+)

accessgrid-0.1.0/tests/test_accessgrid.py

@@ -0,0 +1,181 @@
+import pytest
+from unittest.mock import patch, Mock
+from accessgrid import AccessGrid, AccessGridError, AuthenticationError
+
+MOCK_ACCOUNT_ID = 'test-account-id'
+MOCK_SECRET_KEY = 'test-secret-key'
+
+@pytest.fixture
+def client():
+    return AccessGrid(MOCK_ACCOUNT_ID, MOCK_SECRET_KEY)
+
+@pytest.fixture
+def mock_response():
+    mock = Mock()
+    mock.json.return_value = {'status': 'success'}
+    mock.status_code = 200
+    mock.text = '{"status": "success"}'
+    return mock
+
+class TestAccessGrid:
+    def test_constructor_missing_account_id(self):
+        with pytest.raises(ValueError, match='Account ID is required'):
+            AccessGrid(None, MOCK_SECRET_KEY)
+
+    def test_constructor_missing_secret_key(self):
+        with pytest.raises(ValueError, match='Secret Key is required'):
+            AccessGrid(MOCK_ACCOUNT_ID, None)
+
+    def test_constructor_with_custom_base_url(self):
+        custom_url = 'https://custom.api.com'
+        client = AccessGrid(MOCK_ACCOUNT_ID, MOCK_SECRET_KEY, base_url=custom_url)
+        assert client.base_url == custom_url.rstrip('/')
+
+class TestAccessCards:
+    @pytest.fixture
+    def mock_provision_params(self):
+        return {
+            'card_template_id': '0xd3adb00b5',
+            'employee_id': '123456789',
+            'tag_id': 'DDEADB33FB00B5',
+            'allow_on_multiple_devices': True,
+            'full_name': 'Employee name',
+            'email': 'employee@yourwebsite.com',
+            'phone_number': '+19547212241',
+            'classification': 'full_time',
+            'start_date': '2025-01-31T22:46:25.601Z',
+            'expiration_date': '2025-04-30T22:46:25.601Z',
+            'employee_photo': 'base64photo'
+        }
+
+    @patch('requests.request')
+    def test_provision_card(self, mock_request, client, mock_response, mock_provision_params):
+        mock_request.return_value = mock_response
+
+        card = client.access_cards.provision(**mock_provision_params)
+
+        mock_request.assert_called_once()
+        call_args = mock_request.call_args[1]
+        assert call_args['method'] == 'POST'
+        assert call_args['url'] == f"{client.base_url}/api/v1/nfc_keys/issue"
+        assert call_args['json'] == mock_provision_params
+        assert call_args['headers']['X-ACCT-ID'] == MOCK_ACCOUNT_ID
+        assert 'X-PAYLOAD-SIG' in call_args['headers']
+        assert call_args['headers']['Content-Type'] == 'application/json'
+
+    @patch('requests.request')
+    def test_provision_card_error(self, mock_request, client, mock_provision_params):
+        error_response = Mock()
+        error_response.status_code = 400
+        error_response.text = '{"message": "Invalid template ID"}'
+        error_response.json.return_value = {"message": "Invalid template ID"}
+        mock_request.return_value = error_response
+
+        with pytest.raises(AccessGridError, match='API request failed: Invalid template ID'):
+            client.access_cards.provision(**mock_provision_params)
+
+    @patch('requests.request')
+    def test_update_card(self, mock_request, client, mock_response):
+        mock_request.return_value = mock_response
+        update_params = {
+            'card_id': '0xc4rd1d',
+            'employee_id': '987654321',
+            'full_name': 'Updated Employee Name',
+            'classification': 'contractor',
+            'expiration_date': '2025-02-22T21:04:03.664Z'
+        }
+        
+        card = client.access_cards.update(**update_params)
+        
+        mock_request.assert_called_once()
+        call_args = mock_request.call_args[1]
+        assert call_args['method'] == 'POST'
+        assert call_args['url'] == f"{client.base_url}/api/v1/nfc_keys/update"
+        assert call_args['json'] == update_params
+
+    @patch('requests.request')
+    def test_manage_operations(self, mock_request, client, mock_response):
+        mock_request.return_value = mock_response
+        card_id = '0xc4rd1d'
+
+        # Test suspend
+        client.access_cards.suspend(card_id)
+        call_args = mock_request.call_args[1]
+        assert call_args['method'] == 'POST'
+        assert call_args['url'] == f"{client.base_url}/api/v1/nfc_keys/manage"
+        assert call_args['json'] == {'card_id': card_id, 'manage_action': 'suspend'}
+
+        # Test resume
+        client.access_cards.resume(card_id)
+        call_args = mock_request.call_args[1]
+        assert call_args['json'] == {'card_id': card_id, 'manage_action': 'resume'}
+
+        # Test unlink
+        client.access_cards.unlink(card_id)
+        call_args = mock_request.call_args[1]
+        assert call_args['json'] == {'card_id': card_id, 'manage_action': 'unlink'}
+
+class TestConsole:
+    @pytest.fixture
+    def mock_template_params(self):
+        return {
+            'name': 'Employee NFC key',
+            'platform': 'apple',
+            'use_case': 'employee_badge',
+            'protocol': 'desfire',
+            'allow_on_multiple_devices': True,
+            'watch_count': 2,
+            'iphone_count': 3,
+            'design': {
+                'background_color': '#FFFFFF',
+                'label_color': '#000000',
+                'label_secondary_color': '#333333'
+            },
+            'support_info': {
+                'support_url': 'https://help.yourcompany.com',
+                'support_phone_number': '+1-555-123-4567',
+                'support_email': 'support@yourcompany.com',
+                'privacy_policy_url': 'https://yourcompany.com/privacy',
+                'terms_and_conditions_url': 'https://yourcompany.com/terms'
+            }
+        }
+
+    @patch('requests.request')
+    def test_create_template(self, mock_request, client, mock_response, mock_template_params):
+        mock_request.return_value = mock_response
+        
+        template = client.console.create_template(**mock_template_params)
+        
+        call_args = mock_request.call_args[1]
+        assert call_args['method'] == 'POST'
+        assert call_args['url'] == f"{client.base_url}/api/v1/enterprise/create_template"
+        assert call_args['json'] == mock_template_params
+
+    @patch('requests.request')
+    def test_read_template(self, mock_request, client, mock_response):
+        mock_request.return_value = mock_response
+        template_id = '0xd3adb00b5'
+        
+        template = client.console.read_template(template_id)
+        
+        call_args = mock_request.call_args[1]
+        assert call_args['method'] == 'GET'
+        assert call_args['url'] == f"{client.base_url}/api/v1/enterprise/read_template/{template_id}"
+
+    @patch('requests.request')
+    def test_event_log(self, mock_request, client, mock_response):
+        mock_request.return_value = mock_response
+        template_id = '0xd3adb00b5'
+        filters = {
+            'device': 'mobile',
+            'start_date': '2025-01-01T00:00:00Z',
+            'end_date': '2025-02-01T00:00:00Z',
+            'event_type': 'install'
+        }
+        
+        events = client.console.event_log(template_id, filters=filters)
+        
+        call_args = mock_request.call_args[1]
+        assert call_args['method'] == 'GET'
+        assert call_args['url'] == f"{client.base_url}/api/v1/enterprise/logs/{template_id}"
+        assert call_args['params'] == {'filters': filters, 'page': 1, 'per_page': 50}