@soederpop/luca 0.0.29 → 0.0.30

package/src/node/features/file-manager.ts

@@ -78,12 +78,12 @@ export class FileManager<
   });
 
   /** Returns an array of all relative file paths indexed by the file manager. */
-  get fileIds() {
+  get fileIds(): string[] {
     return Array.from(this.files.keys());
   }
 
   /** Returns an array of all file metadata objects indexed by the file manager. */
-  get fileObjects() {
+  get fileObjects(): File[] {
     return Array.from(this.files.values());
   }
 
@@ -92,7 +92,7 @@ export class FileManager<
    * @param {string | string[]} patterns - The patterns to match against the file IDs
    * @returns {string[]} The file IDs that match the patterns
   */
-  match(patterns: string | string[]) {
+  match(patterns: string | string[]): string[] {
     return micromatch(this.files.keys(), patterns);
   }
 
@@ -102,7 +102,7 @@ export class FileManager<
    * @param {string | string[]} patterns - The patterns to match against the file IDs
    * @returns {File[]} The file objects that match the patterns
   */
-  matchFiles(patterns: string | string[]) {
+  matchFiles(patterns: string | string[]): (File | undefined)[] {
     const fileIds = this.match(Array.isArray(patterns) ? patterns : [patterns]);
     return fileIds.map((fileId) => this.files.get(fileId));
   }
@@ -110,7 +110,7 @@ export class FileManager<
   /** 
    * Returns the directory IDs for all of the files in the project.
   */
-  get directoryIds() {
+  get directoryIds(): string[] {
     return Array.from(
       new Set(
         this.files
@@ -122,7 +122,7 @@ export class FileManager<
   }
 
   /** Returns an array of unique file extensions found across all indexed files. */
-  get uniqueExtensions() {
+  get uniqueExtensions(): string[] {
     return Array.from(
       new Set(
         this.files.values().map((file) => file.extension)
@@ -131,17 +131,17 @@ export class FileManager<
   }
 
   /** Whether the file manager has completed its initial scan. */
-  get isStarted() {
+  get isStarted(): boolean {
     return !!this.state.get("started");
   }
 
   /** Whether the file manager is currently performing its initial scan. */
-  get isStarting() {
+  get isStarting(): boolean {
     return !!this.state.get("starting");
   }
 
   /** Whether the file watcher is actively monitoring for changes. */
-  get isWatching() {
+  get isWatching(): boolean {
     return !!this.state.get("watching");
   }
 
@@ -156,7 +156,7 @@ export class FileManager<
    * @param {string | string[]} [options.exclude] - The patterns to exclude from the scan
    * @returns {Promise<FileManager>} The file manager instance
   */
-  async start(options: { exclude?: string | string[] } = {}) {
+  async start(options: { exclude?: string | string[] } = {}): Promise<this> {
     if (this.isStarted) {
       return this;
     }
@@ -302,7 +302,7 @@ export class FileManager<
    * @param {string | string[]} [options.exclude] - The patterns to exclude from the scan
    * @returns {Promise<FileManager>} The file manager instance
   */
-  async scanFiles(options: { exclude?: string | string[] } = {}) {
+  async scanFiles(options: { exclude?: string | string[] } = {}): Promise<this> {
     const { cwd, git, fs } = this.container;
 
     const fileIds: string[] = [];
@@ -416,7 +416,7 @@ export class FileManager<
    * @param {string | string[]} [options.exclude] - The patterns to exclude from the watch
    * @returns {Promise<void>}
   */
-  async watch(options: { paths?: string | string[]; exclude?: string | string[] } = {}) {
+  async watch(options: { paths?: string | string[]; exclude?: string | string[] } = {}): Promise<void> {
     const pathsToWatch = castArray(options.paths || this.directoryIds.map(id => this.container.paths.resolve(id)))
       .map(p => this.container.paths.resolve(p));
 
@@ -487,7 +487,7 @@ export class FileManager<
     this.watcher = watcher;
   }
 
-  async stopWatching() {
+  async stopWatching(): Promise<void> {
     if (!this.isWatching) {
       return;
     }
@@ -500,7 +500,7 @@ export class FileManager<
     }
   }
 
-  async updateFile(path: string) {
+  async updateFile(path: string): Promise<void> {
     const absolutePath = this.container.paths.resolve(path);
     const { name, ext, dir } = parse(absolutePath);
 
@@ -526,7 +526,7 @@ export class FileManager<
     }
   }
 
-  async removeFile(path: string) {
+  async removeFile(path: string): Promise<void> {
     this.files.delete(path);
   }
 }

package/src/node/features/fs.ts

@@ -13,6 +13,7 @@ import {
   realpathSync,
 
   rmSync as nodeRmSync,
+  type Stats,
 } from "fs";
 import { join, resolve, dirname, relative } from "path";
 import { readFile, stat, lstat, realpath, unlink, mkdir, writeFile, appendFile, readdir, cp, rename, rm as nodeRm } from "fs/promises";
@@ -145,7 +146,7 @@ export class FS extends Feature {
    * console.log(config.version)
    * ```
    */
-  readJson(path: string) {
+  readJson(path: string): any {
     return JSON.parse(this.readFile(path) as string)
   }
   
@@ -153,7 +154,7 @@ export class FS extends Feature {
     * Read and parse a JSON file synchronously
     * @alias readJson
    */
-  readJsonSync(path: string) {
+  readJsonSync(path: string): any {
     return this.readJson(path)
   }
 
@@ -170,7 +171,7 @@ export class FS extends Feature {
    * console.log(config.version)
    * ```
    */
-  async readJsonAsync(path: string) {
+  async readJsonAsync(path: string): Promise<any> {
     const content = await this.readFileAsync(path)
     return JSON.parse(content as string)
   }
@@ -188,7 +189,7 @@ export class FS extends Feature {
    * console.log(entries) // ['index.ts', 'utils.ts', 'components']
    * ```
    */
-  readdirSync(path: string) {
+  readdirSync(path: string): string[] {
     return readdirSync(this.container.paths.resolve(path))
   }
 
@@ -205,7 +206,7 @@ export class FS extends Feature {
    * console.log(entries) // ['index.ts', 'utils.ts', 'components']
    * ```
    */
-  async readdir(path: string) {
+  async readdir(path: string): Promise<string[]> {
     return await readdir(this.container.paths.resolve(path))
   }
 
@@ -226,7 +227,7 @@ export class FS extends Feature {
    * fs.writeFile('data.bin', Buffer.from([1, 2, 3, 4]))
    * ```
    */
-  writeFile(path: string, content: Buffer | string) {
+  writeFile(path: string, content: Buffer | string): void {
     writeFileSync(this.container.paths.resolve(path), content)
   }
 
@@ -261,7 +262,7 @@ export class FS extends Feature {
    * fs.writeJson('config.json', { version: '1.0.0', debug: false })
    * ```
    */
-  writeJson(path: string, data: any, indent: number = 2) {
+  writeJson(path: string, data: any, indent: number = 2): void {
     this.writeFile(path, JSON.stringify(data, null, indent) + '\n')
   }
 
@@ -294,7 +295,7 @@ export class FS extends Feature {
    * fs.appendFile('log.txt', 'New line\n')
    * ```
    */
-  appendFile(path: string, content: Buffer | string) {
+  appendFile(path: string, content: Buffer | string): void {
     appendFileSync(this.container.paths.resolve(path), content)
   }
 
@@ -332,7 +333,7 @@ export class FS extends Feature {
    * fs.ensureFile('logs/app.log', '', false)
    * ```
    */
-  ensureFile(path: string, content: string, overwrite = false) {
+  ensureFile(path: string, content: string, overwrite = false): string {
     path = this.container.paths.resolve(path);
 
     if (this.exists(path) && !overwrite) {
@@ -359,7 +360,7 @@ export class FS extends Feature {
    * await fs.ensureFileAsync('config/settings.json', '{}', true)
    * ```
    */
-  async ensureFileAsync(path: string, content: string, overwrite = false) {
+  async ensureFileAsync(path: string, content: string, overwrite = false): Promise<string> {
     path = this.container.paths.resolve(path);
 
     if (this.exists(path) && !overwrite) {
@@ -384,7 +385,7 @@ export class FS extends Feature {
    * fs.ensureFolder('logs/debug')
    * ```
    */
-  ensureFolder(path: string) {
+  ensureFolder(path: string): string {
     mkdirSync(this.container.paths.resolve(path), { recursive: true });
     return this.container.paths.resolve(path);
   }
@@ -401,7 +402,7 @@ export class FS extends Feature {
    * await fs.ensureFolderAsync('logs/debug')
    * ```
    */
-  async ensureFolderAsync(path: string) {
+  async ensureFolderAsync(path: string): Promise<string> {
     const resolved = this.container.paths.resolve(path);
     await mkdir(resolved, { recursive: true });
     return resolved;
@@ -418,7 +419,7 @@ export class FS extends Feature {
    * fs.mkdirp('deep/nested/path')
    * ```
    */
-  mkdirp(folder: string) {
+  mkdirp(folder: string): string {
     return this.ensureFolder(folder)
   }
 
@@ -479,7 +480,7 @@ export class FS extends Feature {
    * }
    * ```
    */
-  async existsAsync(path: string) {
+  async existsAsync(path: string): Promise<boolean> {
     const filePath = this.container.paths.resolve(path);
     return stat(filePath).then(() => true).catch(() => false)
   }
@@ -519,7 +520,7 @@ export class FS extends Feature {
    * console.log(info.size, info.mtime)
    * ```
    */
-  stat(path: string) {
+  stat(path: string): Stats {
     return statSync(this.container.paths.resolve(path))
   }
 
@@ -536,7 +537,7 @@ export class FS extends Feature {
    * console.log(info.size, info.mtime)
    * ```
    */
-  async statAsync(path: string) {
+  async statAsync(path: string): Promise<Stats> {
     return stat(this.container.paths.resolve(path))
   }
 
@@ -631,7 +632,7 @@ export class FS extends Feature {
    * fs.rmSync('temp/cache.tmp')
    * ```
    */
-  rmSync(path: string) {
+  rmSync(path: string): void {
     nodeRmSync(this.container.paths.resolve(path), { force: true })
   }
 
@@ -662,7 +663,7 @@ export class FS extends Feature {
    * fs.rmdirSync('temp/cache')
    * ```
    */
-  rmdirSync(dirPath: string) {
+  rmdirSync(dirPath: string): void {
     nodeRmSync(this.container.paths.resolve(dirPath), { recursive: true, force: true })
   }
 
@@ -702,7 +703,7 @@ export class FS extends Feature {
    * fs.copy('src', 'backup/src')
    * ```
    */
-  copy(src: string, dest: string, options: { overwrite?: boolean } = {}) {
+  copy(src: string, dest: string, options: { overwrite?: boolean } = {}): void {
     const { overwrite = true } = options
     const resolvedSrc = this.container.paths.resolve(src)
     const resolvedDest = this.container.paths.resolve(dest)
@@ -746,7 +747,7 @@ export class FS extends Feature {
    * fs.move('old-dir', 'new-dir')
    * ```
    */
-  move(src: string, dest: string) {
+  move(src: string, dest: string): void {
     const resolvedSrc = this.container.paths.resolve(src)
     const resolvedDest = this.container.paths.resolve(dest)
     const destDir = dirname(resolvedDest)
@@ -819,7 +820,7 @@ export class FS extends Feature {
    * const relative = fs.walk('inbox', { relative: true }) // => { files: ['contact-1.json', ...] }
    * ```
    */
-  walk(basePath: string, options: WalkOptions = {}) {
+  walk(basePath: string, options: WalkOptions = {}): { directories: string[], files: string[] } {
     const {
       directories = true,
       files = true,
@@ -898,7 +899,7 @@ export class FS extends Feature {
    * // files.files => ['contact-1.json', 'subfolder/file.txt', ...]
    * ```
    */
-  async walkAsync(baseDir: string, options: WalkOptions = {}) {
+  async walkAsync(baseDir: string, options: WalkOptions = {}): Promise<{ directories: string[], files: string[] }> {
     const {
       directories = true,
       files = true,

package/src/node/features/git.ts

@@ -98,7 +98,7 @@ export class Git extends Feature {
      * })
      * ```
      */
-    async lsFiles(options: LsFilesOptions = {}) {
+    async lsFiles(options: LsFilesOptions = {}): Promise<string[]> {
         const { 
             cached = false, 
             deleted = false, 
@@ -153,7 +153,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    get branch() {
+    get branch(): string | null {
         if(!this.isRepo) { return null }
         return this.container.feature('proc').exec(`${this.gitPath} branch`).split("\n").filter(line => line.startsWith('*')).map(line => line.replace('*', '').trim()).pop()
     }
@@ -171,7 +171,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    get sha() {
+    get sha(): string | null {
         if(!this.isRepo) { return null }
         return this.container.feature('proc').exec(`${this.gitPath} rev-parse HEAD`, { cwd: this.repoRoot })
     }
@@ -190,7 +190,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    get isRepo() {
+    get isRepo(): boolean {
         return !!this.repoRoot
     }
     
@@ -208,7 +208,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    get isRepoRoot() {
+    get isRepoRoot(): boolean {
         return this.repoRoot == this.container.cwd
     }
     
@@ -228,7 +228,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    get repoRoot() {
+    get repoRoot(): string | null {
         if (this.state.has('repoRoot')) {
             return this.state.get('repoRoot')
         }
@@ -260,7 +260,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    async getLatestChanges(numberOfChanges: number = 10) {
+    async getLatestChanges(numberOfChanges: number = 10): Promise<Array<{ title: string, message: string, author: string }>> {
         if (!this.isRepo) return []
 
         const separator = '---COMMIT---'
@@ -299,7 +299,7 @@ export class Git extends Feature {
      * }
      * ```
      */
-    fileLog(...files: string[]) {
+    fileLog(...files: string[]): Array<{ sha: string, message: string }> {
         if (!this.isRepo || !files.length) return []
 
         const proc = this.container.feature('proc')
@@ -349,7 +349,7 @@ export class Git extends Feature {
      * const d = git.diff('src/index.ts', 'feature-branch', 'main')
      * ```
      */
-    diff(file: string, compareTo: string, compareFrom?: string) {
+    diff(file: string, compareTo: string, compareFrom?: string): string {
         if (!this.isRepo) return ''
 
         const proc = this.container.feature('proc')
@@ -531,7 +531,7 @@ export class Git extends Feature {
      * const history = git.getChangeHistoryForFiles('src/node/features/*.ts')
      * ```
      */
-    getChangeHistoryForFiles(...paths: string[]) {
+    getChangeHistoryForFiles(...paths: string[]): Array<{ sha: string, message: string, longMessage: string, filesMatched: string[] }> {
         if (!this.isRepo || !paths.length) return []
 
         const proc = this.container.feature('proc')

package/src/node/features/ink.ts

@@ -128,7 +128,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * Exposed so consumers don't need a separate react import.
    * Lazy-loaded — first access triggers the import.
    */
-  get React() {
+  get React(): typeof import('react') {
     // return a promise the first time, but for ergonomics we also
     // expose a sync getter that throws if react hasn't loaded yet.
     if (this._reactModule) return this._reactModule
@@ -151,7 +151,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * const { Box, Text } = ink.components
    * ```
    */
-  async loadModules() {
+  async loadModules(): Promise<this> {
     await Promise.all([this._getInk(), this._getReact()])
     return this
   }
@@ -163,7 +163,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * const { Box, Text, Static, Spacer } = ink.components
    * ```
    */
-  get components() {
+  get components(): { Box: typeof import('ink').Box; Text: typeof import('ink').Text; Static: typeof import('ink').Static; Transform: typeof import('ink').Transform; Newline: typeof import('ink').Newline; Spacer: typeof import('ink').Spacer } {
     const ink = this._inkModule
     if (!ink) {
       throw new Error(
@@ -188,7 +188,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * const { useInput, useApp, useFocus } = ink.hooks
    * ```
    */
-  get hooks() {
+  get hooks(): { useInput: typeof import('ink').useInput; useApp: typeof import('ink').useApp; useStdin: typeof import('ink').useStdin; useStdout: typeof import('ink').useStdout; useStderr: typeof import('ink').useStderr; useFocus: typeof import('ink').useFocus; useFocusManager: typeof import('ink').useFocusManager; useCursor: typeof import('ink').useCursor } {
     const ink = this._inkModule
     if (!ink) {
       throw new Error(
@@ -211,7 +211,7 @@ export class Ink extends Feature<InkState, InkOptions> {
   /**
    * The Ink measureElement utility.
    */
-  get measureElement() {
+  get measureElement(): typeof import('ink').measureElement {
     const ink = this._inkModule
     if (!ink) {
       throw new Error('Ink not loaded yet.')
@@ -229,7 +229,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * @param options - Ink render options (stdout, stdin, debug, etc.)
    * @returns The Ink instance with rerender, unmount, waitUntilExit, clear
    */
-  async render(node: any, options: Record<string, any> = {}) {
+  async render(node: any, options: Record<string, any> = {}): Promise<any> {
     const ink = await this._getInk()
     await this._getReact()
 
@@ -280,7 +280,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * ink.rerender(React.createElement(Text, null, 'Updated!'))
    * ```
    */
-  rerender(node: any) {
+  rerender(node: any): void {
     if (!this._instance) {
       throw new Error('No mounted ink app. Call render() first.')
     }
@@ -304,7 +304,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * console.log(ink.isMounted) // false
    * ```
    */
-  unmount() {
+  unmount(): void {
     if (this._instance) {
       this._instance.unmount()
       this.setState({ mounted: false })
@@ -351,7 +351,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * ink.clear()
    * ```
    */
-  clear() {
+  clear(): void {
     if (this._instance) {
       this._instance.clear()
     }
@@ -367,7 +367,7 @@ export class Ink extends Feature<InkState, InkOptions> {
   /**
    * The raw ink render instance if you need low-level access.
    */
-  get instance() {
+  get instance(): any | null {
     return this._instance
   }
 
@@ -387,7 +387,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * )
    * ```
    */
-  registerBlock(name: string, component: Function) {
+  registerBlock(name: string, component: Function): this {
     this._blocks.set(name, component)
     return this
   }
@@ -407,7 +407,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * await ink.renderBlock('Greeting', { name: 'Jon' })
    * ```
    */
-  async renderBlock(name: string, data?: Record<string, any>) {
+  async renderBlock(name: string, data?: Record<string, any>): Promise<void> {
     const component = this._blocks.get(name)
     if (!component) {
       throw new Error(`No block registered with name "${name}". Available: ${[...this._blocks.keys()].join(', ') || '(none)'}`)
@@ -450,7 +450,7 @@ export class Ink extends Feature<InkState, InkOptions> {
    * await renderAsync('AsyncChart', { url: 'https://api.example.com/data' })
    * ```
    */
-  async renderBlockAsync(name: string, data?: Record<string, any>, options?: { timeout?: number }) {
+  async renderBlockAsync(name: string, data?: Record<string, any>, options?: { timeout?: number }): Promise<void> {
     const component = this._blocks.get(name)
     if (!component) {
       throw new Error(`No block registered with name "${name}". Available: ${[...this._blocks.keys()].join(', ') || '(none)'}`)

package/src/node/features/ipc-socket.ts

@@ -139,7 +139,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    *
    * @returns True if the socket is configured as a client
    */
-  get isClient() {
+  get isClient(): boolean {
     return this.state.get('mode') === 'client'
   }
 
@@ -148,14 +148,14 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    *
    * @returns True if the socket is configured as a server
    */
-  get isServer() {
+  get isServer(): boolean {
     return this.state.get('mode') === 'server'
   }
 
   /**
    * Returns the number of currently connected clients (server mode).
    */
-  get clientCount() {
+  get clientCount(): number {
     return this.clients.size
   }
 
@@ -326,7 +326,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    * 
    * @returns The active Socket connection, or undefined if not connected
    */
-  get connection() {
+  get connection(): Socket | undefined {
     return this._connection
   }
 
@@ -337,7 +337,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    * @param exclude - Optional client ID to exclude from broadcast
    * @returns This instance for method chaining
    */
-  broadcast(message: any, exclude?: string) {
+  broadcast(message: any, exclude?: string): this {
     const envelope = JSON.stringify({
       data: message,
       id: this.container.utils.uuid()
@@ -377,7 +377,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    *
    * @param message - The message to send
    */
-  async send(message: any) {
+  async send(message: any): Promise<void> {
     if(!this._connection) {
       throw new Error("No connection.")
     }
@@ -449,7 +449,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
    * @param data - The reply payload
    * @param clientId - Target client (server mode; for client mode, omit)
    */
-  reply(requestId: string, data: any, clientId?: string) {
+  reply(requestId: string, data: any, clientId?: string): void {
     const envelope = JSON.stringify({
       id: this.container.utils.uuid(),
       data,
@@ -557,7 +557,7 @@ export class IpcSocket<T extends IpcState = IpcState> extends Feature<T> {
   /**
    * Disconnects the client and stops any reconnection attempts.
    */
-  disconnect() {
+  disconnect(): void {
     this._reconnect.enabled = false
     if (this._reconnect.timer) {
       clearTimeout(this._reconnect.timer)

package/src/node/features/networking.ts

@@ -249,11 +249,11 @@ export class Networking extends Feature<NetworkingState, NetworkingOptions> {
     return this._binCache[name]
   }
 
-  get proc() {
+  get proc(): ReturnType<typeof this.container.feature<'proc'>> {
     return this.container.feature('proc')
   }
 
-  get os() {
+  get os(): ReturnType<typeof this.container.feature<'os'>> {
     return this.container.feature('os')
   }
   
@@ -630,7 +630,7 @@ export class Networking extends Feature<NetworkingState, NetworkingOptions> {
   /**
    * Optional nmap wrapper for users that already have nmap installed.
    */
-  get nmap() {
+  get nmap(): { isAvailable: () => Promise<boolean>; scan: (target: string, args?: string[]) => Promise<{ hosts: NmapHost[]; raw: string }>; quickScan: (cidr: string) => Promise<{ hosts: NmapHost[]; raw: string }>; fullScan: (target: string) => Promise<{ hosts: NmapHost[]; raw: string }> } {
     return {
       isAvailable: async () => this.isNmapAvailable(),
       scan: async (target: string, args: string[] = []) => this.runNmapScan(target, args),

package/src/node/features/os.ts

@@ -48,7 +48,7 @@ export class OS extends Feature {
    * console.log(`Running on ${arch} architecture`)
    * ```
    */
-  get arch() {
+  get arch(): string {
     return os.arch()
   }
   
@@ -63,7 +63,7 @@ export class OS extends Feature {
    * console.log(`Temp directory: ${tempDir}`)
    * ```
    */
-  get tmpdir() {
+  get tmpdir(): string {
     return os.tmpdir()
   }
   
@@ -78,7 +78,7 @@ export class OS extends Feature {
    * console.log(`User home: ${home}`)
    * ```
    */
-  get homedir() {
+  get homedir(): string {
     return os.homedir()
   }
   
@@ -93,7 +93,7 @@ export class OS extends Feature {
    * console.log(`System has ${cores} CPU cores`)
    * ```
    */
-  get cpuCount() {
+  get cpuCount(): number {
     return os.cpus().length
   }
 
@@ -108,7 +108,7 @@ export class OS extends Feature {
    * console.log(`Hostname: ${hostname}`)
    * ```
    */
-  get hostname() {
+  get hostname(): string {
     return os.hostname()
   }
 
@@ -125,7 +125,7 @@ export class OS extends Feature {
    * }
    * ```
    */
-  get platform() {
+  get platform(): string {
     return os.platform()
   }
   
@@ -142,7 +142,7 @@ export class OS extends Feature {
    * })
    * ```
    */
-  get networkInterfaces() {
+  get networkInterfaces(): NodeJS.Dict<os.NetworkInterfaceInfo[]> {
     return os.networkInterfaces()
   }