@owlmeans/client-did 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OwlMeans Common — Fullstack typescript framework
+
+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,713 @@
+# @owlmeans/client-did
+
+Client-side Decentralized Identity (DID) implementation for OwlMeans applications. This package provides complete DID wallet management, authentication, and account functionality for browser and React Native environments.
+
+## Overview
+
+The `@owlmeans/client-did` package enables client-side decentralized identity functionality, providing:
+
+- **DID Wallet Service**: Complete wallet lifecycle management with lazy initialization
+- **DID Account Models**: Account abstraction for authentication and signing operations
+- **Resource Integration**: Seamless integration with client resource system for persistent storage
+- **Authentication Support**: DID-based authentication credential generation
+- **State Management**: Integration with OwlMeans state system for reactive updates
+- **Cross-Platform Support**: Works in web browsers and React Native environments
+
+This package is part of the OwlMeans DID ecosystem:
+- **@owlmeans/did**: Core DID functionality and wallet implementation
+- **@owlmeans/client-did**: Client-side DID implementation *(this package)*
+- **@owlmeans/basic-keys**: Cryptographic key management
+
+## Installation
+
+```bash
+npm install @owlmeans/client-did
+```
+
+## Dependencies
+
+This package requires:
+- `@owlmeans/did`: Core DID functionality
+- `@owlmeans/client-context`: Client context management
+- `@owlmeans/client-resource`: Client resource system
+- `@owlmeans/basic-keys`: Cryptographic operations
+- `@owlmeans/auth`: Authentication types and interfaces
+- `@owlmeans/state`: State management integration
+
+## Core Concepts
+
+### DID Wallet Service
+
+The DID wallet service manages the lifecycle of decentralized identity wallets, including creation, initialization, and persistence across client sessions.
+
+### DID Account Model
+
+Account models provide a simplified interface for DID-based authentication and credential generation.
+
+### Resource Dependencies
+
+The service uses three key resources for persistent storage:
+- **Keys Resource**: Stores cryptographic key pairs
+- **Meta Resource**: Stores metadata about DID keys
+- **Master Resource**: Stores master wallet configuration
+
+## API Reference
+
+### Types
+
+#### `DIDService`
+
+Main service interface for DID wallet management.
+
+```typescript
+interface DIDService extends LazyService {
+  wallet: DIDWallet                                          // Current wallet instance
+  exists(): Promise<boolean>                                 // Check if wallet exists
+  create(opts?: MakeDIDWalletOptions): Promise<DIDWallet>   // Create new wallet
+  intialize(): Promise<DIDWallet>                           // Initialize existing wallet
+  get(): DIDWallet                                          // Get current wallet
+}
+```
+
+#### `DIDServiceAppend`
+
+Interface for contexts that provide DID service access.
+
+```typescript
+interface DIDServiceAppend {
+  getDidService(alias?: string): DIDService
+}
+```
+
+#### `DIDServiceDeps`
+
+Configuration for service resource dependencies.
+
+```typescript
+interface DIDServiceDeps {
+  keys: string     // Key pair resource alias
+  meta: string     // Key metadata resource alias
+  master: string   // Master wallet resource alias
+}
+```
+
+#### `DIDAccountModel`
+
+Account model interface for DID-based authentication.
+
+```typescript
+interface DIDAccountModel {
+  did: DIDKeyModel                                          // DID key model
+  authenticate<T extends Partial<AuthCredentials>>(auth: T): Promise<T>  // Generate auth credentials
+}
+```
+
+### Factory Functions
+
+#### `makeWalletService(alias?: string, deps?: DIDServiceDeps): DIDService`
+
+Creates a DID wallet service with resource dependencies.
+
+**Parameters:**
+- `alias`: Service alias (default: 'did-wallet')
+- `deps`: Resource dependencies configuration
+
+**Returns:** DIDService instance
+
+**Example:**
+```typescript
+import { makeWalletService } from '@owlmeans/client-did'
+
+const didService = makeWalletService('primary-wallet')
+
+// Custom resource dependencies
+const customService = makeWalletService('custom-wallet', {
+  keys: 'custom-keys',
+  meta: 'custom-meta', 
+  master: 'custom-master'
+})
+```
+
+#### `appendDidService<C extends ClientConfig, T extends ClientContext<C>>(ctx: T, alias?: string, customDeps?: Partial<DIDServiceDeps>): T & DIDServiceAppend`
+
+Appends DID service capabilities to a client context.
+
+**Parameters:**
+- `ctx`: Client context to extend
+- `alias`: Service alias (default: 'did-wallet')
+- `customDeps`: Custom resource dependencies
+
+**Returns:** Context with DID service capabilities
+
+**Features:**
+- Automatically creates required resources if they don't exist
+- Registers DID service with context
+- Adds `getDidService()` method to context
+- Integrates with state debugging
+
+**Example:**
+```typescript
+import { appendDidService } from '@owlmeans/client-did'
+import { makeClientContext } from '@owlmeans/client-context'
+
+const context = makeClientContext(config)
+const contextWithDid = appendDidService(context)
+
+// Initialize context
+await contextWithDid.configure().init()
+
+// Access DID service
+const didService = contextWithDid.getDidService()
+```
+
+#### `makeDidAccountModel(did: KeyPair | DIDKeyModel | string, isPub?: boolean): DIDAccountModel`
+
+Creates a DID account model for authentication operations.
+
+**Parameters:**
+- `did`: DID key material (KeyPair, DIDKeyModel, or string)
+- `isPub`: Whether the string is a public key (default: false)
+
+**Returns:** DIDAccountModel instance
+
+**Example:**
+```typescript
+import { makeDidAccountModel } from '@owlmeans/client-did'
+
+// From existing DID key model
+const account1 = makeDidAccountModel(didKeyModel)
+
+// From key pair
+const account2 = makeDidAccountModel(keyPair)
+
+// From private key string
+const account3 = makeDidAccountModel('ed25519:privateKeyString')
+
+// From public key string
+const account4 = makeDidAccountModel('ed25519:publicKeyString', true)
+```
+
+### Service Methods
+
+#### `exists(): Promise<boolean>`
+
+Checks if a DID wallet already exists in persistent storage.
+
+**Returns:** Promise resolving to boolean indicating existence
+
+**Example:**
+```typescript
+const didService = makeWalletService()
+
+if (await didService.exists()) {
+  console.log('Wallet already exists')
+  await didService.intialize()
+} else {
+  console.log('Creating new wallet')
+  await didService.create()
+}
+```
+
+#### `create(opts?: MakeDIDWalletOptions): Promise<DIDWallet>`
+
+Creates a new DID wallet. Throws error if wallet already exists.
+
+**Parameters:**
+- `opts`: Wallet creation options
+
+**Returns:** Promise resolving to new DIDWallet
+
+**Throws:** `DIDInitializationError` if wallet already exists
+
+**Example:**
+```typescript
+try {
+  const wallet = await didService.create({
+    // Custom wallet options
+    keyType: 'ed25519',
+    derivationPath: "m/44'/60'/0'/0/0"
+  })
+  
+  console.log('Wallet created:', wallet.exportAddress())
+} catch (error) {
+  if (error instanceof DIDInitializationError) {
+    console.error('Wallet already exists')
+  }
+}
+```
+
+#### `intialize(): Promise<DIDWallet>`
+
+Initializes an existing DID wallet from persistent storage.
+
+**Returns:** Promise resolving to initialized DIDWallet
+
+**Example:**
+```typescript
+const wallet = await didService.intialize()
+console.log('Wallet initialized:', wallet.exportAddress())
+```
+
+#### `get(): DIDWallet`
+
+Gets the current wallet instance (must be initialized first).
+
+**Returns:** Current DIDWallet instance
+
+**Example:**
+```typescript
+await didService.intialize()
+const wallet = didService.get()
+
+// Use wallet for operations
+const signature = await wallet.sign('message to sign')
+```
+
+### Account Model Methods
+
+#### `authenticate<T extends Partial<AuthCredentials>>(auth: T): Promise<T>`
+
+Generates authentication credentials using the DID key.
+
+**Parameters:**
+- `auth`: Partial authentication credentials with challenge
+
+**Returns:** Promise resolving to complete authentication credentials
+
+**Process:**
+1. Sets `userId` to DID address
+2. Sets `publicKey` to DID public key
+3. Signs the challenge and sets `credential`
+
+**Example:**
+```typescript
+const account = makeDidAccountModel(didKeyModel)
+
+// Authenticate with challenge
+const authResult = await account.authenticate({
+  challenge: 'authentication-challenge-string',
+  type: 'ed25519'
+})
+
+console.log('User ID:', authResult.userId)
+console.log('Public Key:', authResult.publicKey)
+console.log('Credential:', authResult.credential)
+```
+
+### Constants
+
+#### Service Configuration
+```typescript
+const DEFAULT_ALIAS = 'did-wallet'                    // Default service alias
+
+const DEF_KEYS_RESOURCE = 'did-wallet-keys'          // Default keys resource
+const DEF_META_RESOURCE = 'did-wallet-meta'          // Default meta resource  
+const DEF_MASTER_RESOURCE = 'did-wallet-master'      // Default master resource
+
+const defDeps: DIDServiceDeps = {
+  keys: DEF_KEYS_RESOURCE,
+  meta: DEF_META_RESOURCE,
+  master: DEF_MASTER_RESOURCE
+}
+```
+
+## Usage Examples
+
+### Basic DID Wallet Setup
+
+```typescript
+import { appendDidService } from '@owlmeans/client-did'
+import { makeClientContext } from '@owlmeans/client-context'
+
+// Create context with DID capabilities
+const context = makeClientContext({
+  service: 'my-app',
+  // ... other config
+})
+
+const contextWithDid = appendDidService(context)
+
+// Initialize context
+await contextWithDid.configure().init()
+
+// Access DID service
+const didService = contextWithDid.getDidService()
+
+// Check if wallet exists
+if (await didService.exists()) {
+  await didService.intialize()
+  console.log('Wallet loaded')
+} else {
+  await didService.create()
+  console.log('New wallet created')
+}
+```
+
+### DID-Based Authentication
+
+```typescript
+import { makeDidAccountModel } from '@owlmeans/client-did'
+
+// Create account from wallet
+const didService = context.getDidService()
+const wallet = didService.get()
+const account = makeDidAccountModel(wallet.master)
+
+// Authenticate with server challenge
+const challenge = 'server-provided-challenge'
+const authCredentials = await account.authenticate({
+  challenge,
+  type: 'ed25519'
+})
+
+// Send credentials to server
+const response = await fetch('/api/authenticate', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify(authCredentials)
+})
+```
+
+### Multiple DID Wallets
+
+```typescript
+// Create multiple wallet services
+const primaryContext = appendDidService(context, 'primary', {
+  keys: 'primary-keys',
+  meta: 'primary-meta',
+  master: 'primary-master'
+})
+
+const backupContext = appendDidService(primaryContext, 'backup', {
+  keys: 'backup-keys',
+  meta: 'backup-meta', 
+  master: 'backup-master'
+})
+
+await backupContext.configure().init()
+
+// Use different wallets
+const primaryDid = backupContext.getDidService('primary')
+const backupDid = backupContext.getDidService('backup')
+
+// Create both wallets
+if (!await primaryDid.exists()) {
+  await primaryDid.create()
+}
+
+if (!await backupDid.exists()) {
+  await backupDid.create()
+}
+```
+
+### Wallet Recovery and Import
+
+```typescript
+import { makeDidAccountModel } from '@owlmeans/client-did'
+
+// Recovery from private key
+const recoverWallet = async (privateKeyString: string) => {
+  const account = makeDidAccountModel(privateKeyString)
+  console.log('Recovered wallet address:', account.did.exportAddress())
+  
+  return account
+}
+
+// Import from existing key pair
+const importWallet = async (keyPair: KeyPair) => {
+  const account = makeDidAccountModel(keyPair)
+  
+  // Authenticate to verify ownership
+  const authTest = await account.authenticate({
+    challenge: 'ownership-verification'
+  })
+  
+  return account
+}
+
+// Usage
+const recovered = await recoverWallet('ed25519:private-key-string')
+const imported = await importWallet(existingKeyPair)
+```
+
+### Signing and Verification
+
+```typescript
+// Sign messages with DID wallet
+const didService = context.getDidService()
+const wallet = didService.get()
+
+// Sign arbitrary data
+const signature = await wallet.sign('important message')
+console.log('Signature:', signature)
+
+// Verify signature
+const isValid = await wallet.verify('important message', signature)
+console.log('Signature valid:', isValid)
+
+// Account-based signing
+const account = makeDidAccountModel(wallet.master)
+const authSig = await account.authenticate({
+  challenge: 'server-challenge'
+})
+```
+
+### Integration with Authentication Flow
+
+```typescript
+import { AuthenticationStage } from '@owlmeans/auth'
+
+class DIDAuthenticationFlow {
+  private account: DIDAccountModel
+  
+  constructor(didService: DIDService) {
+    this.account = makeDidAccountModel(didService.get().master)
+  }
+  
+  async initialize() {
+    return {
+      stage: AuthenticationStage.Init,
+      publicKey: this.account.did.exportPublic(),
+      address: this.account.did.exportAddress()
+    }
+  }
+  
+  async authenticate(challenge: string) {
+    const credentials = await this.account.authenticate({
+      challenge,
+      type: 'ed25519'
+    })
+    
+    return {
+      stage: AuthenticationStage.Authenticated,
+      ...credentials
+    }
+  }
+}
+
+// Usage
+const authFlow = new DIDAuthenticationFlow(didService)
+const initResult = await authFlow.initialize()
+
+// Send init to server, receive challenge
+const challenge = await sendToServer('/auth/init', initResult)
+const authResult = await authFlow.authenticate(challenge.challenge)
+```
+
+### State Management Integration
+
+```typescript
+// The service automatically integrates with state debugging
+const contextWithDid = appendDidService(context)
+
+// State changes are tracked for resources
+contextWithDid.getDidService()  // State debugging enabled for did-wallet-*
+
+// Monitor wallet state changes
+const stateService = contextWithDid.service('state')
+stateService.subscribe('did-wallet-master', (change) => {
+  console.log('Wallet state changed:', change)
+})
+```
+
+### Error Handling
+
+```typescript
+import { DIDInitializationError } from '@owlmeans/did'
+
+try {
+  const didService = makeWalletService()
+  
+  // Try to create wallet
+  await didService.create()
+} catch (error) {
+  if (error instanceof DIDInitializationError) {
+    if (error.message.includes('exists:service')) {
+      console.log('Wallet already exists, initializing instead')
+      await didService.intialize()
+    } else {
+      console.error('DID initialization failed:', error.message)
+    }
+  } else {
+    console.error('Unexpected error:', error)
+  }
+}
+```
+
+### Custom Resource Configuration
+
+```typescript
+// Custom resource aliases for different use cases
+const customDeps: DIDServiceDeps = {
+  keys: 'secure-keys',
+  meta: 'wallet-metadata',
+  master: 'master-wallet'
+}
+
+const secureDidService = makeWalletService('secure-wallet', customDeps)
+
+// Or use with appendDidService
+const contextWithCustomDid = appendDidService(context, 'custom', {
+  keys: 'custom-keys-resource',
+  meta: 'custom-meta-resource'
+  // master will default to 'custom-master'
+})
+```
+
+### Cross-Platform Considerations
+
+```typescript
+// Browser-specific initialization
+if (typeof window !== 'undefined') {
+  // Browser environment
+  const context = makeClientContext(browserConfig)
+  const contextWithDid = appendDidService(context)
+}
+
+// React Native-specific initialization  
+if (typeof global !== 'undefined' && global.navigator?.product === 'ReactNative') {
+  // React Native environment
+  const context = makeClientContext(reactNativeConfig)
+  const contextWithDid = appendDidService(context)
+}
+```
+
+## Advanced Features
+
+### Wallet Export and Backup
+
+```typescript
+// Export wallet for backup
+const didService = context.getDidService()
+const wallet = didService.get()
+
+const exportData = {
+  address: wallet.exportAddress(),
+  publicKey: wallet.exportPublic(),
+  // Note: private key export depends on wallet implementation
+  masterKey: wallet.master?.export?.() // If available
+}
+
+// Store backup securely
+localStorage.setItem('wallet-backup', JSON.stringify(exportData))
+```
+
+### Multi-Signature Support
+
+```typescript
+// Create multiple accounts for multi-sig
+const wallet = didService.get()
+const accounts = [
+  makeDidAccountModel(wallet.master),
+  makeDidAccountModel(wallet.createDerived?.(1) || wallet.master),
+  makeDidAccountModel(wallet.createDerived?.(2) || wallet.master)
+]
+
+// Multi-signature authentication
+const multiAuth = async (challenge: string) => {
+  const signatures = await Promise.all(
+    accounts.map(account => 
+      account.authenticate({ challenge, type: 'ed25519' })
+    )
+  )
+  
+  return {
+    type: 'multi-sig',
+    signatures,
+    threshold: 2  // Require 2 of 3 signatures
+  }
+}
+```
+
+### Hierarchical Deterministic Support
+
+```typescript
+// If wallet supports HD derivation
+const wallet = didService.get()
+
+// Create derived accounts for different purposes
+const tradingAccount = wallet.deriveAccount?.('m/44\'/60\'/0\'/0/0')
+const savingsAccount = wallet.deriveAccount?.('m/44\'/60\'/0\'/0/1')
+
+if (tradingAccount && savingsAccount) {
+  const tradingDid = makeDidAccountModel(tradingAccount)
+  const savingsDid = makeDidAccountModel(savingsAccount)
+  
+  console.log('Trading address:', tradingDid.did.exportAddress())
+  console.log('Savings address:', savingsDid.did.exportAddress())
+}
+```
+
+## Security Considerations
+
+### Private Key Protection
+- Private keys are stored using client resource system
+- Use appropriate security measures for key storage
+- Consider hardware security modules for high-value applications
+
+### Authentication Security
+- Always verify challenges come from trusted sources
+- Implement replay attack protection
+- Use secure communication channels for credential exchange
+
+### Wallet Management
+- Implement proper wallet backup and recovery procedures
+- Use strong entropy for wallet generation
+- Consider multi-factor authentication for wallet access
+
+## Best Practices
+
+1. **Initialization**: Check wallet existence before creation
+2. **Error Handling**: Properly handle DID initialization errors
+3. **Resource Management**: Use meaningful resource aliases
+4. **State Integration**: Leverage state debugging for development
+5. **Security**: Never expose private keys in logs or error messages
+6. **Backup**: Implement secure wallet backup procedures
+7. **Testing**: Test authentication flows thoroughly
+
+## Integration with OwlMeans Ecosystem
+
+### Authentication Integration
+```typescript
+import { AuthService } from '@owlmeans/client-auth'
+
+// Use DID for OwlMeans authentication
+const authService = context.service<AuthService>('auth')
+const didService = context.getDidService()
+
+// Custom DID-based authentication
+const authenticateWithDid = async (challenge: string) => {
+  const account = makeDidAccountModel(didService.get().master)
+  const credentials = await account.authenticate({ challenge })
+  
+  await authService.authenticate({ token: credentials.credential })
+}
+```
+
+### Context Integration
+```typescript
+import { makeClientContext } from '@owlmeans/client-context'
+
+// DID service integrates seamlessly with client context
+const context = makeClientContext(config)
+const contextWithDid = appendDidService(context)
+
+// All OwlMeans services work together
+await contextWithDid.configure().init()
+```
+
+## Performance Considerations
+
+- **Lazy Initialization**: Service initializes only when needed
+- **Resource Caching**: Resources are cached after first access
+- **Cryptographic Operations**: Ed25519 operations are computationally efficient
+- **State Updates**: State changes are optimized for performance
+
+## Related Packages
+
+- [`@owlmeans/did`](../did) - Core DID functionality and wallet implementation
+- [`@owlmeans/basic-keys`](../basic-keys) - Cryptographic key management
+- [`@owlmeans/client-context`](../client-context) - Client context management
+- [`@owlmeans/client-resource`](../client-resource) - Client resource system
+- [`@owlmeans/auth`](../auth) - Authentication types and interfaces
+- [`@owlmeans/state`](../state) - State management system

package/build/account.d.ts

@@ -0,0 +1,5 @@
+import type { DIDKeyModel } from '@owlmeans/did';
+import type { DIDAccountModel } from './types.js';
+import { KeyPair } from '@owlmeans/basic-keys';
+export declare const makeDidAccountModel: (did: KeyPair | DIDKeyModel | string, isPub?: boolean) => DIDAccountModel;
+//# sourceMappingURL=account.d.ts.map

package/build/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAc,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAE1D,eAAO,MAAM,mBAAmB,QAAS,OAAO,GAAE,WAAW,GAAG,MAAM,UAAS,OAAO,KAAW,eAuBhG,CAAA"}

package/build/account.js

@@ -0,0 +1,26 @@
+import { makeDidKeyModel } from '@owlmeans/did';
+import { fromPubKey } from '@owlmeans/basic-keys';
+export const makeDidAccountModel = (did, isPub = false) => {
+    if (typeof did === 'string') {
+        if (isPub) {
+            did = makeDidKeyModel(fromPubKey(did).keyPair);
+        }
+        else {
+            did = makeDidKeyModel(did);
+        }
+    }
+    else if (!("keyPair" in did)) {
+        did = makeDidKeyModel(did);
+    }
+    const model = {
+        did,
+        authenticate: async (auth) => {
+            auth.userId = model.did.exportAddress();
+            auth.publicKey = model.did.exportPublic();
+            auth.credential = await model.did.sign(auth.challenge);
+            return auth;
+        }
+    };
+    return model;
+};
+//# sourceMappingURL=account.js.map

package/build/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,UAAU,EAAW,MAAM,sBAAsB,CAAA;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAkC,EAAE,QAAiB,KAAK,EAAmB,EAAE;IACjH,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,CAAC;YACV,GAAG,GAAG,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;QAChD,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;SAAM,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,EAAE,CAAC;QAC/B,GAAG,GAAG,eAAe,CAAC,GAAc,CAAC,CAAA;IACvC,CAAC;IACD,MAAM,KAAK,GAAoB;QAC7B,GAAG;QAEH,YAAY,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,CAAA;YACvC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,CAAA;YACzC,IAAI,CAAC,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAEtD,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/build/consts.d.ts

@@ -0,0 +1,7 @@
+import type { DIDServiceDeps } from './types.js';
+export declare const DEFAULT_ALIAS = "did-wallet";
+export declare const DEF_KEYS_RESOURCE = "did-wallet-keys";
+export declare const DEF_META_RESOURCE = "did-wallet-meta";
+export declare const DEF_MASTER_RESOURCE = "did-wallet-master";
+export declare const defDeps: DIDServiceDeps;
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,aAAa,eAAe,CAAA;AAEzC,eAAO,MAAM,iBAAiB,oBAA0B,CAAA;AACxD,eAAO,MAAM,iBAAiB,oBAA0B,CAAA;AACxD,eAAO,MAAM,mBAAmB,sBAA4B,CAAA;AAE5D,eAAO,MAAM,OAAO,EAAE,cAIrB,CAAA"}

package/build/consts.js

@@ -0,0 +1,10 @@
+export const DEFAULT_ALIAS = 'did-wallet';
+export const DEF_KEYS_RESOURCE = `${DEFAULT_ALIAS}-keys`;
+export const DEF_META_RESOURCE = `${DEFAULT_ALIAS}-meta`;
+export const DEF_MASTER_RESOURCE = `${DEFAULT_ALIAS}-master`;
+export const defDeps = {
+    keys: DEF_KEYS_RESOURCE,
+    meta: DEF_META_RESOURCE,
+    master: DEF_MASTER_RESOURCE
+};
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,aAAa,OAAO,CAAA;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,aAAa,OAAO,CAAA;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,aAAa,SAAS,CAAA;AAE5D,MAAM,CAAC,MAAM,OAAO,GAAmB;IACrC,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,mBAAmB;CAC5B,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './types.js';
+export * from './consts.js';
+export * from './service.js';
+export * from './account.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export * from './service.js';
+export * from './account.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/build/service.d.ts

@@ -0,0 +1,6 @@
+import type { DIDService, DIDServiceAppend, DIDServiceDeps } from './types.js';
+import type { ClientConfig } from '@owlmeans/client-context';
+import type { ClientContext } from '@owlmeans/client';
+export declare const makeWalletService: (alias?: string, deps?: DIDServiceDeps) => DIDService;
+export declare const appendDidService: <C extends ClientConfig, T extends ClientContext<C>>(ctx: T, alias?: string, customDeps?: Partial<DIDServiceDeps>) => T & DIDServiceAppend;
+//# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAK5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,eAAO,MAAM,iBAAiB,WAAW,MAAM,SAAyB,cAAc,KAAG,UAoDxF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,OAC7C,CAAC,UAAS,MAAM,eAA+B,OAAO,CAAC,cAAc,CAAC,KAAG,CAAC,GAAG,gBAoBnF,CAAA"}

package/build/service.js

@@ -0,0 +1,68 @@
+import { assertContext, createLazyService } from '@owlmeans/context';
+import { DEFAULT_ALIAS, defDeps } from './consts.js';
+import { DIDInitializationError, makeWallet, MASTER } from '@owlmeans/did';
+import { appendClientResource } from '@owlmeans/client-resource';
+import { appendStateDebug } from '@owlmeans/client';
+export const makeWalletService = (alias = DEFAULT_ALIAS, deps) => {
+    const location = `did-service:${alias}`;
+    deps = deps ?? defDeps;
+    const service = createLazyService(alias, {
+        exists: async () => {
+            const context = assertContext(service.ctx, location);
+            const resource = context.resource(deps.master);
+            return null != await resource.load(MASTER);
+        },
+        create: async (opts) => {
+            const context = assertContext(service.ctx, location);
+            if (await service.exists()) {
+                throw new DIDInitializationError('exists:service');
+            }
+            return service.wallet = await makeWallet({
+                keys: context.resource(deps.keys),
+                meta: context.resource(deps.meta),
+                master: context.resource(deps.master)
+            }, { force: true, ...opts });
+        },
+        intialize: async () => {
+            const context = assertContext(service.ctx, location);
+            return service.wallet = await makeWallet({
+                keys: context.resource(deps.keys),
+                meta: context.resource(deps.meta),
+                master: context.resource(deps.master)
+            });
+        },
+        get: () => service.wallet
+    }, service => async () => {
+        try {
+            const context = assertContext(service.ctx, location);
+            await context.resource(deps.keys).init?.();
+            if (service.wallet == null && await service.exists()) {
+                await service.intialize();
+            }
+        }
+        catch (e) {
+            console.error('DID Service initialization error', e);
+        }
+        finally {
+            service.initialized = true;
+        }
+    });
+    return service;
+};
+export const appendDidService = (ctx, alias = DEFAULT_ALIAS, customDeps) => {
+    const context = ctx;
+    const deps = {
+        keys: customDeps?.keys ?? `${alias}-keys`,
+        meta: customDeps?.meta ?? `${alias}-meta`,
+        master: customDeps?.master ?? `${alias}-master`
+    };
+    Object.values(deps).forEach(dep => !context.hasResource(dep) && appendClientResource(context, dep));
+    const service = makeWalletService(alias, deps);
+    context.registerService(service);
+    if (context.getDidService == null) {
+        context.getDidService = (_alias) => context.service(_alias ?? alias);
+        Object.values(deps).forEach(dep => appendStateDebug(ctx, dep));
+    }
+    return context;
+};
+//# sourceMappingURL=service.js.map

package/build/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -0,0 +1,23 @@
+import type { AuthCredentials } from '@owlmeans/auth';
+import type { LazyService } from '@owlmeans/context';
+import type { DIDKeyModel, DIDWallet, MakeDIDWalletOptions } from '@owlmeans/did';
+export interface DIDService extends LazyService {
+    wallet: DIDWallet;
+    exists: () => Promise<boolean>;
+    create: (opts?: MakeDIDWalletOptions) => Promise<DIDWallet>;
+    intialize: () => Promise<DIDWallet>;
+    get: () => DIDWallet;
+}
+export interface DIDServiceAppend {
+    getDidService: (alias?: string) => DIDService;
+}
+export interface DIDServiceDeps {
+    keys: string;
+    meta: string;
+    master: string;
+}
+export interface DIDAccountModel {
+    did: DIDKeyModel;
+    authenticate: <T extends Partial<AuthCredentials>>(auth: T) => Promise<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEjF,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAC3D,SAAS,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;IACnC,GAAG,EAAE,MAAM,SAAS,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,UAAU,CAAA;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,WAAW,CAAA;IAChB,YAAY,EAAE,CAAC,CAAC,SAAS,OAAO,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CAC1E"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@owlmeans/client-did",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 84 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/auth": "^0.1.0",
+    "@owlmeans/client": "^0.1.0",
+    "@owlmeans/client-context": "^0.1.0",
+    "@owlmeans/client-resource": "^0.1.0",
+    "@owlmeans/context": "^0.1.0",
+    "@owlmeans/did": "^0.1.0",
+    "@owlmeans/state": "^0.1.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/account.ts

@@ -0,0 +1,29 @@
+import type{ DIDKeyModel } from '@owlmeans/did'
+import { makeDidKeyModel } from '@owlmeans/did'
+import type { DIDAccountModel } from './types.js'
+import { fromPubKey, KeyPair } from '@owlmeans/basic-keys'
+
+export const makeDidAccountModel = (did: KeyPair| DIDKeyModel | string, isPub: boolean = false): DIDAccountModel => {
+  if (typeof did === 'string') {
+    if (isPub) {
+      did = makeDidKeyModel(fromPubKey(did).keyPair)
+    } else {
+      did = makeDidKeyModel(did)
+    }
+  } else if (!("keyPair" in did)) {
+    did = makeDidKeyModel(did as KeyPair)
+  }
+  const model: DIDAccountModel = {
+    did,
+
+    authenticate: async auth => {
+      auth.userId = model.did.exportAddress()
+      auth.publicKey = model.did.exportPublic()
+      auth.credential = await model.did.sign(auth.challenge)
+
+      return auth
+    }
+  }
+
+  return model
+}

package/src/consts.ts

@@ -0,0 +1,13 @@
+import type { DIDServiceDeps } from './types.js'
+
+export const DEFAULT_ALIAS = 'did-wallet'
+
+export const DEF_KEYS_RESOURCE = `${DEFAULT_ALIAS}-keys`
+export const DEF_META_RESOURCE = `${DEFAULT_ALIAS}-meta`
+export const DEF_MASTER_RESOURCE = `${DEFAULT_ALIAS}-master`
+
+export const defDeps: DIDServiceDeps = {
+  keys: DEF_KEYS_RESOURCE,
+  meta: DEF_META_RESOURCE,
+  master: DEF_MASTER_RESOURCE
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export type * from './types.js'
+export * from './consts.js'
+export * from './service.js'
+export * from './account.js'

package/src/service.ts

@@ -0,0 +1,87 @@
+import { assertContext, createLazyService } from '@owlmeans/context'
+import { DEFAULT_ALIAS, defDeps } from './consts.js'
+import type { DIDService, DIDServiceAppend, DIDServiceDeps } from './types.js'
+import type { ClientConfig } from '@owlmeans/client-context'
+import type { KeyMetaResource, KeyPairResource, MasterResource } from '@owlmeans/did'
+import { DIDInitializationError, makeWallet, MASTER } from '@owlmeans/did'
+import { appendClientResource } from '@owlmeans/client-resource'
+import { appendStateDebug } from '@owlmeans/client'
+import type { ClientContext } from '@owlmeans/client'
+
+export const makeWalletService = (alias: string = DEFAULT_ALIAS, deps?: DIDServiceDeps): DIDService => {
+  const location = `did-service:${alias}`
+  deps = deps ?? defDeps
+
+  const service: DIDService = createLazyService<DIDService>(alias, {
+    exists: async () => {
+      const context = assertContext(service.ctx, location) as ClientContext
+      const resource = context.resource<MasterResource>(deps.master)
+
+      return null != await resource.load(MASTER)
+    },
+
+    create: async opts => {
+      const context = assertContext(service.ctx, location) as ClientContext
+
+      if (await service.exists()) {
+        throw new DIDInitializationError('exists:service')
+      }
+
+      return service.wallet = await makeWallet({
+        keys: context.resource<KeyPairResource>(deps.keys),
+        meta: context.resource<KeyMetaResource>(deps.meta),
+        master: context.resource<MasterResource>(deps.master)
+      }, { force: true, ...opts })
+    },
+
+    intialize: async () => {
+      const context = assertContext(service.ctx, location) as ClientContext
+
+      return service.wallet = await makeWallet({
+        keys: context.resource<KeyPairResource>(deps.keys),
+        meta: context.resource<KeyMetaResource>(deps.meta),
+        master: context.resource<MasterResource>(deps.master)
+      })
+    },
+
+    get: () => service.wallet
+  }, service => async () => {
+    try {
+      const context = assertContext(service.ctx, location) as ClientContext
+      await context.resource(deps.keys).init?.()
+      if (service.wallet == null && await service.exists()) {
+        await service.intialize()
+      }
+    } catch (e) {
+      console.error('DID Service initialization error', e)
+    } finally {
+      service.initialized = true
+    }
+  })
+
+  return service
+}
+
+export const appendDidService = <
+  C extends ClientConfig, T extends ClientContext<C>
+>(ctx: T, alias: string = DEFAULT_ALIAS, customDeps?: Partial<DIDServiceDeps>): T & DIDServiceAppend => {
+  const context = ctx as T & DIDServiceAppend
+
+  const deps: DIDServiceDeps = {
+    keys: customDeps?.keys ?? `${alias}-keys`,
+    meta: customDeps?.meta ?? `${alias}-meta`,
+    master: customDeps?.master ?? `${alias}-master`
+  }
+
+  Object.values(deps).forEach(dep => !context.hasResource(dep) && appendClientResource<C, T>(context, dep))
+
+  const service = makeWalletService(alias, deps)
+  context.registerService(service)
+
+  if (context.getDidService == null) {
+    context.getDidService = (_alias?: string) => context.service<DIDService>(_alias ?? alias)
+    Object.values(deps).forEach(dep => appendStateDebug<C, T>(ctx, dep))
+  }
+
+  return context
+}

package/src/types.ts

@@ -0,0 +1,26 @@
+import type { AuthCredentials } from '@owlmeans/auth'
+import type { LazyService } from '@owlmeans/context'
+import type { DIDKeyModel, DIDWallet, MakeDIDWalletOptions } from '@owlmeans/did'
+
+export interface DIDService extends LazyService {
+  wallet: DIDWallet
+  exists: () => Promise<boolean>
+  create: (opts?: MakeDIDWalletOptions) => Promise<DIDWallet>
+  intialize: () => Promise<DIDWallet>
+  get: () => DIDWallet
+}
+
+export interface DIDServiceAppend {
+  getDidService: (alias?: string) => DIDService
+}
+
+export interface DIDServiceDeps {
+  keys: string
+  meta: string
+  master: string
+}
+
+export interface DIDAccountModel {
+  did: DIDKeyModel
+  authenticate: <T extends Partial<AuthCredentials>>(auth: T) => Promise<T>
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": [
+    "../tsconfig.default.json",
+    "../tsconfig.react.json",
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/", /* Specify the root folder within your source files. */
+    "outDir": "./build/", /* Specify an output folder for all emitted files. */
+  },
+  "exclude": [
+    "./dist/**/*",
+    "./build/**/*",
+    "./*.ts"
+  ]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/account.ts","./src/consts.ts","./src/index.ts","./src/service.ts","./src/types.ts"],"version":"5.6.3"}