Feature Comparison

Complete comparison of all 4 Sharokey client libraries to help you choose the right tool for your project.

🎯 Quick Decision Guide

🖥️ Use CLI C# if you need:

• Shell scripts & automation
• CI/CD pipeline integration
• Pipe data from other commands
• Cross-platform executable

📦 Use JavaScript SDK if you need:

• Node.js applications
• Complex web applications
• Full TypeScript support
• Advanced filtering & search

🌐 Use JavaScript CDN if you need:

• Quick browser integration
• No build process
• Simple HTML projects
• Minimal setup

🐍 Use Python SDK if you need:

• Python applications
• Data science & ML projects
• CLI-consistent API
• Async/await support

📊 Feature Matrix

Configuration & Setup

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
Token Configuration	✅	✅	✅	✅
Custom API URL	✅	✅	✅	✅
Connection Testing	✅	✅	✅	✅
Environment Variables	✅	✅	✅	✅

Secret Management

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
Create Secrets	✅	✅	✅	✅
List Secrets	✅	✅	✅	✅
Get Secret Details	✅	✅	✅	✅
Delete Secrets	✅	✅	✅	✅
Bulk Operations	✅	❌	❌	❌

Security Features

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
Zero Knowledge Encryption	✅	✅	✅	✅
Password Protection	✅	✅	✅	✅
OTP via Email	✅	✅	✅	✅
OTP via SMS	✅	✅	✅	✅
Custom Expiration	✅	✅	✅	✅
View Limits	✅	✅	✅	✅

File Support

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
File Attachments	✅	✅	✅	✅
Multiple Files	✅	✅	✅	✅
10MB Size Validation	✅	✅	✅	✅
File Type Validation	✅	✅	✅	✅
Drag & Drop	N/A	✅	✅	N/A

Advanced Features

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
Advanced Filtering	❌	✅	❌	❌
Search Functionality	✅	✅	❌	✅
Active Secrets Only	❌	✅	❌	❌
Pagination	✅	✅	❌	✅
Stdin/Pipe Input	✅	❌	❌	❌

Output & Formatting

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
JSON Output	✅	✅	✅	✅
Table Format	✅	❌	❌	❌
Verbose Mode	✅	❌	❌	❌
Colored Output	✅	N/A	N/A	❌

Development Experience

Feature	CLI C#	JavaScript SDK	JavaScript CDN	Python SDK
TypeScript Support	N/A	✅	✅	N/A
Type Hints	N/A	✅	✅	✅
Async/Await	✅	✅	✅	✅
Error Handling	✅	✅	✅	✅
Unit Tests	✅	✅	✅	✅
Documentation	✅	✅	✅	✅

🔄 API Consistency

All libraries maintain consistent method naming for core operations:

Create Secret

CLI

sharokey create "secret" --hours 24 --views 1

JS Complete

await client.createSecret("secret", {expirationHours: 24, maximumViews: 1});

JS Simple

await Sharokey.create("secret", 24, 1);

Python

secret = await client.create("secret", 24, 1)

List Secrets

CLI

sharokey list --limit 10 --status active

JS Complete

await client.getSecrets({limit: 10, status: 'active'});

JS Simple

await Sharokey.list({limit: 10});

Python

secrets = await client.list(limit=10, status='active')

Delete Secret

CLI

sharokey delete ABC123

JS Complete

await client.deleteSecret('ABC123');

JS Simple

await Sharokey.delete('ABC123');

Python

await client.delete('ABC123')

📦 Installation & Setup

Library	Installation	Configuration
CLI C#	winget install Sharokey.CLI	sharokey config --token xxx
JS Complete	npm install @sharokey/client	new SharokeyClient({token})
JS Simple	npm install @sharokey/simple	Sharokey.config({token})
Python SDK	pip install sharokey	SharokeyClient(token='xxx')

🔐 Encryption Compatibility

All libraries use identical Zero Knowledge encryption:

• Algorithm: AES-GCM-256
• Key Derivation: PBKDF2 with 10,000 iterations
• Salt: Random 16 bytes per secret
• IV: Random 16 bytes per secret
• Cross-compatibility: Secrets created by any library can be decrypted by any other

📊 Performance Comparison

Metric	CLI C#	JS Complete	JS Simple	Python SDK
Bundle Size	~15MB	~2.1MB	~850KB	~45MB
Cold Start	~100ms	~50ms	~20ms	~200ms
Memory Usage	~25MB	~15MB	~8MB	~35MB
Encryption Speed	Fast	Fast	Fast	Medium
Network Efficiency	High	High	High	High

🎯 Use Case Matrix

Use Case	Recommended Library	Why?
Shell Scripts	CLI C#	Native shell integration, pipe support
CI/CD Pipelines	CLI C#	Cross-platform executable, JSON output
React Applications	JS Simple	Small bundle, easy integration
Node.js APIs	JS Complete	Full features, TypeScript support
Vue.js Projects	JS Simple	Lightweight, minimal setup
Python Web Apps	Python SDK	Native Python integration
Data Science	Python SDK	Async support, Jupyter compatibility
Desktop Applications	CLI C#	System integration, file handling
Microservices	JS Complete or Python SDK	Depending on stack
Automation Scripts	CLI C# or Python SDK	Both excellent for automation

🚀 Migration Between Libraries

From CLI to Python SDK

# CLI: sharokey create "secret" --hours 24 --views 1
secret = await client.create("secret", 24, 1)

# CLI: sharokey list --limit 5
secrets = await client.list(limit=5)

# CLI: sharokey delete ABC123
await client.delete("ABC123")

From JS Simple to JS Complete

// JS Simple
await Sharokey.create("secret", 24, 1);

// JS Complete equivalent
await client.createSecret("secret", {
  expirationHours: 24,
  maximumViews: 1
});

📈 Library Maturity

Library	Version	Stability	Last Updated
CLI C#	v2.1.0	Stable	2025-01-10
JS Complete	v1.8.3	Stable	2025-01-12
JS Simple	v1.5.2	Stable	2025-01-08
Python SDK	v1.0.0	New	2025-01-14

🎉 Conclusion

• For automation: Choose CLI C# or Python SDK
• For web development: Choose JS Complete or JS Simple
• For enterprise: Choose CLI C# or JS Complete
• For simplicity: Choose JS Simple or Python SDK

All libraries provide identical security and Zero Knowledge encryption. Your choice depends on your development environment and feature requirements.