Add TypeScript types (#6)

index.d.ts

@@ -0,0 +1,18 @@
+/**
+Strip the final [newline character](https://en.wikipedia.org/wiki/Newline) from a string or Uint8Array.
+
+@returns The input without any final newline.
+
+@example
+```
+import stripFinalNewline from 'strip-final-newline';
+
+stripFinalNewline('foo\nbar\n\n');
+//=> 'foo\nbar\n'
+
+const uint8Array = new TextEncoder().encode('foo\nbar\n\n')
+new TextDecoder().decode(stripFinalNewline(uint8Array));
+//=> 'foo\nbar\n'
+```
+*/
+export default function stripFinalNewline<T extends string | Uint8Array>(input: T): T;

index.test-d.ts

@@ -0,0 +1,7 @@
+import {expectType, expectError} from 'tsd';
+import stripFinalNewline from './index.js';
+
+expectType<''>(stripFinalNewline(''));
+expectType<Uint8Array>(stripFinalNewline(new TextEncoder().encode('')));
+expectError(stripFinalNewline(true));
+expectError(stripFinalNewline(new Uint16Array(new ArrayBuffer(0))));

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "strip-final-newline",
 	"version": "3.0.0",
-	"description": "Strip the final newline character from a string/buffer",
+	"description": "Strip the final newline character from a string or Uint8Array",
 	"license": "MIT",
 	"repository": "sindresorhus/strip-final-newline",
 	"funding": "https://github.com/sponsors/sindresorhus",
@@ -11,15 +11,19 @@
 		"url": "https://sindresorhus.com"
 	},
 	"type": "module",
-	"exports": "./index.js",
+	"exports": {
+		"types": "./index.d.ts",
+		"default": "./index.js"
+	},
 	"engines": {
 		"node": ">=18"
 	},
 	"scripts": {
-		"test": "xo && ava"
+		"test": "xo && ava && tsd"
 	},
 	"files": [
-		"index.js"
+		"index.js",
+		"index.d.ts"
 	],
 	"keywords": [
 		"strip",
@@ -34,10 +38,11 @@
 		"linebreak",
 		"character",
 		"string",
-		"buffer"
+		"uint8array"
 	],
 	"devDependencies": {
 		"ava": "^6.0.1",
+		"tsd": "^0.29.0",
 		"xo": "^0.56.0"
 	}
 }

readme.md

@@ -1,6 +1,6 @@
 # strip-final-newline
 
-> Strip the final [newline character](https://en.wikipedia.org/wiki/Newline) from a string/buffer
+> Strip the final [newline character](https://en.wikipedia.org/wiki/Newline) from a string or Uint8Array.
 
 This can be useful when parsing the output of, for example, `ChildProcess#execFile()`, as [binaries usually output a newline at the end](https://stackoverflow.com/questions/729692/why-should-text-files-end-with-a-newline). You cannot use `stdout.trimEnd()` for this as it removes all trailing newlines and whitespaces at the end.
 
@@ -18,6 +18,7 @@ import stripFinalNewline from 'strip-final-newline';
 stripFinalNewline('foo\nbar\n\n');
 //=> 'foo\nbar\n'
 
-stripFinalNewline(Buffer.from('foo\nbar\n\n')).toString();
+const uint8Array = new TextEncoder().encode('foo\nbar\n\n')
+new TextDecoder().decode(stripFinalNewline(uint8Array));
 //=> 'foo\nbar\n'
 ```