optropic 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Optropic GmbH
+
+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.

package/README.md

@@ -0,0 +1,104 @@
+# optropic
+
+Official Optropic SDK for TypeScript and JavaScript. Protect products. Verify authenticity.
+
+[![npm version](https://badge.fury.io/js/optropic.svg)](https://www.npmjs.com/package/optropic)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Install
+
+```bash
+npm install optropic
+```
+
+## Quick Start
+
+```typescript
+import { OptropicClient } from 'optropic';
+
+const client = new OptropicClient({
+  apiKey: process.env.OPTROPIC_API_KEY!,
+});
+
+// Verify an asset
+const result = await client.assets.verify('asset-id');
+console.log(result.signature_valid); // true
+console.log(result.revocation_status); // 'active'
+```
+
+## Resources
+
+### Assets
+
+```typescript
+// Create an asset
+const asset = await client.assets.create({
+  gtin: '01234567890128',
+  serial: 'SN-2026-001',
+});
+
+// List assets
+const assets = await client.assets.list({ limit: 10 });
+
+// Get a single asset
+const asset = await client.assets.get('asset-id');
+
+// Verify an asset
+const verification = await client.assets.verify('asset-id');
+
+// Revoke an asset
+await client.assets.revoke('asset-id', 'recalled');
+
+// Batch create assets
+const batch = await client.assets.batchCreate({
+  assets: [
+    { gtin: '01234567890128', serial: 'SN-001' },
+    { gtin: '01234567890128', serial: 'SN-002' },
+    { gtin: '01234567890128', serial: 'SN-003' },
+  ],
+});
+```
+
+### Keys
+
+```typescript
+// Create a key
+const key = await client.keys.create({ name: 'Production Key' });
+
+// List keys
+const keys = await client.keys.list();
+
+// Revoke a key
+await client.keys.revoke('key-id');
+```
+
+## Error Handling
+
+```typescript
+import { OptropicError, AuthenticationError } from 'optropic';
+
+try {
+  await client.assets.verify(id);
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    // Handle invalid API key
+  } else if (error instanceof OptropicError) {
+    console.error(error.code, error.message);
+  }
+}
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| apiKey | string | required | API key (`optr_live_*` or `optr_test_*`) |
+| baseUrl | string | `https://api.optropic.com` | API base URL |
+| timeout | number | `30000` | Request timeout (ms) |
+| retry | RetryConfig | `{ maxRetries: 3 }` | Retry configuration |
+| headers | Record<string, string> | `{}` | Custom headers |
+
+## License
+
+MIT &copy; [Optropic GmbH](https://optropic.com)