Rename files

ts/util/missingCaseError.std.ts

@@ -0,0 +1,26 @@
+// Copyright 2018 Signal Messenger, LLC
+// SPDX-License-Identifier: AGPL-3.0-only
+
+import { reallyJsonStringify } from './reallyJsonStringify.std.js';
+
+// `missingCaseError` is useful for compile-time checking that all `case`s in
+// a `switch` statement have been handled, e.g.
+//
+// type AttachmentType = 'media' | 'documents';
+//
+// const type: AttachmentType = selectedTab;
+// switch (type) {
+//   case 'media':
+//     return <MediaGridItem/>;
+//   case 'documents':
+//     return <DocumentListItem/>;
+//   default:
+//     return missingCaseError(type);
+// }
+//
+// If we extended `AttachmentType` to `'media' | 'documents' | 'links'` the code
+// above would trigger a compiler error stating that `'links'` has not been
+// handled by our `switch` / `case` statement which is useful for code
+// maintenance and system evolution.
+export const missingCaseError = (x: never): TypeError =>
+  new TypeError(`Unhandled case: ${reallyJsonStringify(x)}`);