@ecmaos/types 0.4.1 → 0.4.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
 
-> @ecmaos/types@0.4.1 build /home/archmag0s/code/ecmaos/core/types
+> @ecmaos/types@0.4.3 build /home/archmag0s/code/ecmaos/core/types
 > tsc
 

package/CHANGELOG.md

@@ -1,5 +1,176 @@
 # @ecmaos/types
 
+## 0.4.3
+
+### Patch Changes
+
+- 97b4dbf: implement passkey management and login
+
+## 0.4.2
+
+### Patch Changes
+
+- ae8f619: OVERVIEW
+
+  Total Commits: 5
+  Files Changed: 56 files
+  Additions: +1,632 lines
+  Deletions: -539 lines
+  Net Change: +1,093 lines
+
+  ***
+
+  COMMIT DETAILS
+
+  1. c6f2d9c - docs: Update NEWS and README files; add tilde expansion feature in shell commands
+
+  Type: Documentation & Enhancement
+  Date: Wed Dec 31 11:52:52 2025
+
+  Changes:
+
+  - Updated NEWS.md and README.md with new features and improvements
+  - Added tilde expansion feature in shell commands (~ expands to home directory)
+  - Enhanced filesystem type recognition
+  - Improved terminal command handling
+  - Removed 292 lines from core/kernel/src/tree/lib/commands/index.ts (edit command moved to separate package)
+  - Added shell functionality in core/kernel/src/tree/shell.ts (71 new lines)
+  - Enhanced terminal and filesystem modules
+
+  Files Modified: 9 files (+166, -327)
+
+  ***
+
+  2. b4454a1 - chore: Bump turbo package version from 2.5.4 to 2.7.2
+
+  Type: Dependency Update
+
+  Changes:
+
+  - Updated Turbo monorepo tool from version 2.5.4 to 2.7.2
+  - Updated package.json and pnpm-lock.yaml files
+
+  Impact: Infrastructure improvement for better monorepo tooling support
+
+  ***
+
+  3. 6660f4c - chore: Update pnpm-lock.yaml files across multiple applications and modules
+
+  Type: Dependency Maintenance
+
+  Changes:
+
+  - Cleaned up outdated checksum entries in pnpm-lock.yaml files
+  - Ensured consistency in package versions across the monorepo
+  - Updated lockfiles in:
+    - Multiple apps (ai, boilerplate, code, news, python, webamp)
+    - Core packages (bios, jaffa, kernel, metal, swapi, types, utils)
+    - Device packages (audio, battery, bluetooth, echo, gamepad, geo, gpu, hid, midi, presentation, sensors, serial, usb, webgl)
+    - Modules and utils
+
+  Impact: Improved dependency consistency and resolved potential checksum issues
+
+  ***
+
+  4. 01da80e - feat: improve and move edit command to its own package
+
+  Type: Feature (Major Refactor)
+  Date: Wed Dec 31 12:48:45 2025
+
+  Changes:
+
+  - Extracted edit command from kernel into standalone apps/edit package
+  - Created comprehensive editor implementation with:
+    - Multiple editing modes: normal, insert, replace, command
+    - File operations support
+    - Renderer for terminal-based editing
+    - Type definitions for editor state
+  - Removed 292 lines of edit command code from core/kernel/src/tree/lib/commands/index.ts
+  - Added build configuration (build.cjs)
+  - Updated package dependencies
+
+  Files Modified: 14 files (+1,054, -304)
+
+  Impact: Better separation of concerns, improved maintainability, and enhanced editor functionality
+
+  ***
+
+  5. 90072ec - feat: add 'ln' command and enhance 'ls' command to support symbolic and hard link information
+
+  Type: Feature
+  Date: Wed Dec 31 13:11:53 2025
+
+  Changes:
+
+  - Added new ln command for creating symbolic and hard links (core/utils/src/commands/ln.ts - 108 lines)
+  - Enhanced ls command to display link information:
+    - Shows link count for files
+    - Displays target path for symbolic links
+    - Improved file listing with link details
+  - Updated command exports in core/utils/src/index.ts
+
+  Files Modified: 3 files (+196, -11)
+
+  Impact: Better filesystem management capabilities, improved visibility into file relationships
+
+  ***
+
+  SUMMARY BY CATEGORY
+
+  Features:
+
+  - Edit Command Package: Extracted and improved editor into standalone package with multiple modes
+  - Link Command: New ln command for creating symbolic and hard links
+  - Enhanced LS: Improved ls command with link information display
+  - Tilde Expansion: Shell command support for ~ home directory expansion
+
+  Documentation:
+
+  - Updated NEWS and README files with latest changes
+
+  Infrastructure:
+
+  - Turbo version bump (2.5.4 -> 2.7.2)
+  - Dependency lockfile cleanup across entire monorepo
+
+  Code Quality:
+
+  - Better separation of concerns (edit command extraction)
+  - Improved filesystem type recognition
+  - Enhanced terminal command handling
+
+  ***
+
+  AFFECTED PACKAGES
+
+  Core Packages:
+
+  - @ecmaos/kernel - Shell, terminal, filesystem enhancements
+  - @ecmaos/types - Shell type updates
+  - @ecmaos/utils - New ln command, enhanced ls command
+
+  Applications:
+
+  - apps/edit - New standalone editor package
+
+  Dependencies:
+
+  - All packages: Lockfile updates for consistency
+
+  ***
+
+  BREAKING CHANGES
+
+  None identified. All changes appear to be additive or internal refactoring.
+
+  ***
+
+  MIGRATION NOTES
+
+  - The edit command has been moved from the kernel to apps/edit package. Any code referencing the edit command in the kernel should be updated to use the new package.
+  - The ls command now shows additional link information, which may affect scripts parsing its output.
+  - Shell commands now support tilde expansion (~), which may affect scripts that previously handled paths differently.
+
 ## 0.4.1
 
 ### Patch Changes

package/dist/shell.d.ts

@@ -58,5 +58,11 @@ export interface Shell {
      * @param args - Arguments to set
      */
     setPositionalParameters(args: string[]): void;
+    /**
+     * Expands tilde (~) to the user's home directory
+     * @param input - String that may contain tilde
+     * @returns String with tilde expanded to HOME directory
+     */
+    expandTilde(input: string): string;
 }
 //# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,cAAc;IACd,GAAG,EAAE,MAAM,CAAA;IACX,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,eAAe;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,WAAW,EAAE,WAAW,CAAA;IACxB,oBAAoB;IACpB,OAAO,EAAE,YAAY,CAAA;IACrB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,yBAAyB,IAAI,IAAI,CAAA;IAEjC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEtC;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAC9C"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,cAAc;IACd,GAAG,EAAE,MAAM,CAAA;IACX,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,eAAe;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,WAAW,EAAE,WAAW,CAAA;IACxB,oBAAoB;IACpB,OAAO,EAAE,YAAY,CAAA;IACrB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,yBAAyB,IAAI,IAAI,CAAA;IAEjC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEtC;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAE7C;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACnC"}

package/dist/users.d.ts

@@ -50,6 +50,23 @@ export interface AddUserOptions {
     /** Skip writing to passwd file */
     noWrite?: boolean;
 }
+/**
+ * Interface representing a passkey credential
+ */
+export interface Passkey {
+    /** Unique identifier for this passkey */
+    id: string;
+    /** Base64-encoded credential ID from WebAuthn */
+    credentialId: string;
+    /** Public key data (COSE format) */
+    publicKey: ArrayBuffer | Uint8Array;
+    /** Timestamp when passkey was created */
+    createdAt: number;
+    /** Timestamp when passkey was last used (optional) */
+    lastUsed?: number;
+    /** User-friendly name/description (optional) */
+    name?: string;
+}
 /**
  * Interface for user management functionality
  */
@@ -74,9 +91,11 @@ export interface Users {
     /**
      * Login with credentials
      * @param username - Username
-     * @param password - Password
+     * @param password - Password (optional if using passkey)
+     * @param passkeyCredential - Passkey credential (optional if using password)
      */
-    login(username: string, password: string): Promise<{
+    login(username: string, password?: string, passkeyCredential?: PublicKeyCredential): Promise<{
+        user: User;
         cred: {
             uid: number;
             gid: number;
@@ -99,5 +118,33 @@ export interface Users {
      * @param updates - User properties to update
      */
     update(uid: UID, updates: Partial<User>): Promise<void>;
+    /**
+     * Get all passkeys for a user
+     * @param uid - User ID
+     */
+    getPasskeys(uid: UID): Promise<Passkey[]>;
+    /**
+     * Save passkeys for a user
+     * @param uid - User ID
+     * @param passkeys - Array of passkeys to save
+     */
+    savePasskeys(uid: UID, passkeys: Passkey[]): Promise<void>;
+    /**
+     * Add a passkey to a user's collection
+     * @param uid - User ID
+     * @param passkey - Passkey to add
+     */
+    addPasskey(uid: UID, passkey: Passkey): Promise<void>;
+    /**
+     * Remove a passkey by ID
+     * @param uid - User ID
+     * @param passkeyId - Passkey ID to remove
+     */
+    removePasskey(uid: UID, passkeyId: string): Promise<void>;
+    /**
+     * Check if a user has any registered passkeys
+     * @param uid - User ID
+     */
+    hasPasskeys(uid: UID): Promise<boolean>;
 }
 //# sourceMappingURL=users.d.ts.map

package/dist/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../users.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,mBAAmB;AACnB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,oBAAoB;AACpB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;IACX,wBAAwB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc;IACd,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,OAAO,CAAC,EAAE;QACR,qCAAqC;QACrC,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;QAChC,iBAAiB;QACjB,SAAS,EAAE,UAAU,CAAA;KACtB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAE5B;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjE;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,CAAA;IAE/B;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAErB;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;IAE1F;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../users.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,mBAAmB;AACnB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,oBAAoB;AACpB,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;IACX,wBAAwB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc;IACd,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,OAAO,CAAC,EAAE;QACR,qCAAqC;QACrC,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;QAChC,iBAAiB;QACjB,SAAS,EAAE,UAAU,CAAA;KACtB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,SAAS,EAAE,WAAW,GAAG,UAAU,CAAA;IACnC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,oBAAoB;IACpB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAE5B;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjE;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS,CAAA;IAE/B;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAErB;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;IAEhJ;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvD;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAEzC;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAErD;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzD;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACxC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecmaos/types",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Type definitions for ecmaOS",
   "author": "Jay Mathis",
   "license": "MIT+Apache-2.0",

package/shell.ts

@@ -65,4 +65,11 @@ export interface Shell {
    * @param args - Arguments to set
    */
   setPositionalParameters(args: string[]): void
-} 
+
+  /**
+   * Expands tilde (~) to the user's home directory
+   * @param input - String that may contain tilde
+   * @returns String with tilde expanded to HOME directory
+   */
+  expandTilde(input: string): string
+}

package/users.ts

@@ -57,6 +57,24 @@ export interface AddUserOptions {
   noWrite?: boolean
 }
 
+/**
+ * Interface representing a passkey credential
+ */
+export interface Passkey {
+  /** Unique identifier for this passkey */
+  id: string
+  /** Base64-encoded credential ID from WebAuthn */
+  credentialId: string
+  /** Public key data (COSE format) */
+  publicKey: ArrayBuffer | Uint8Array
+  /** Timestamp when passkey was created */
+  createdAt: number
+  /** Timestamp when passkey was last used (optional) */
+  lastUsed?: number
+  /** User-friendly name/description (optional) */
+  name?: string
+}
+
 /**
  * Interface for user management functionality
  */
@@ -85,9 +103,10 @@ export interface Users {
   /**
    * Login with credentials
    * @param username - Username
-   * @param password - Password
+   * @param password - Password (optional if using passkey)
+   * @param passkeyCredential - Passkey credential (optional if using password)
    */
-  login(username: string, password: string): Promise<{ cred: { uid: number, gid: number } }>
+  login(username: string, password?: string, passkeyCredential?: PublicKeyCredential): Promise<{ user: User, cred: { uid: number, gid: number } }>
 
   /**
    * Change a user's password
@@ -108,4 +127,37 @@ export interface Users {
    * @param updates - User properties to update
    */
   update(uid: UID, updates: Partial<User>): Promise<void>
+
+  /**
+   * Get all passkeys for a user
+   * @param uid - User ID
+   */
+  getPasskeys(uid: UID): Promise<Passkey[]>
+
+  /**
+   * Save passkeys for a user
+   * @param uid - User ID
+   * @param passkeys - Array of passkeys to save
+   */
+  savePasskeys(uid: UID, passkeys: Passkey[]): Promise<void>
+
+  /**
+   * Add a passkey to a user's collection
+   * @param uid - User ID
+   * @param passkey - Passkey to add
+   */
+  addPasskey(uid: UID, passkey: Passkey): Promise<void>
+
+  /**
+   * Remove a passkey by ID
+   * @param uid - User ID
+   * @param passkeyId - Passkey ID to remove
+   */
+  removePasskey(uid: UID, passkeyId: string): Promise<void>
+
+  /**
+   * Check if a user has any registered passkeys
+   * @param uid - User ID
+   */
+  hasPasskeys(uid: UID): Promise<boolean>
 }