chore: release version 5.2.0 with minor updates

- Added `copyToClipboard()` helper function to README.md and exports.
- Included `extractEmailDomain` in the helpers index.
- Updated CHANGELOG.md to reflect the new version and changes.

Author: ogroppo

CHANGELOG.md

@@ -1,5 +1,11 @@
 # deverything
 
+## 5.2.0
+
+### Minor Changes
+
+- email domain
+
 ## 5.1.0
 
 ### Minor Changes

README.md

@@ -108,6 +108,7 @@ Contributions always welcome!
 - `chunkedDynamic()` process with dynamic chunk sizes
 - `clamp()` clamp number in a range
 - `cleanSpaces()` trims and turns double spaces into single space
+- `copyToClipboard()` copy a string to the system clipboard (browser only)
 - `cyclicalItem()` get item from array with cyclical indexing
 - `dir()` get directory listing
 - `enumKeys()` enum FRUIT { APPLE, PEAR } => ["APPLE", "PEAR"]

package.json

@@ -1,6 +1,6 @@
 {
   "name": "deverything",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "Everything you need for Dev",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

src/helpers/copyToClipboard.test.ts

@@ -0,0 +1,23 @@
+import { afterEach, expect, test, vi } from "vitest";
+import { copyToClipboard } from "./copyToClipboard";
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+test("copyToClipboard writes the value to the clipboard", async () => {
+  const writeText = vi.fn().mockResolvedValue(undefined);
+  vi.stubGlobal("navigator", { clipboard: { writeText } });
+
+  await copyToClipboard("hello");
+
+  expect(writeText).toHaveBeenCalledWith("hello");
+});
+
+test("copyToClipboard throws when the Clipboard API is unavailable", async () => {
+  vi.stubGlobal("navigator", {});
+
+  await expect(copyToClipboard("hello")).rejects.toThrow(
+    "Clipboard API is not available in this environment"
+  );
+});

src/helpers/copyToClipboard.ts

@@ -0,0 +1,12 @@
+/**
+ * Copy a string to the system clipboard, works only in the browser
+ * @param value - the string to copy
+ * @returns a promise that resolves once the write is complete, or rejects if the Clipboard API is unavailable or the write fails
+ */
+export const copyToClipboard = async (value: string): Promise<void> => {
+  if (typeof navigator === "undefined" || !navigator.clipboard) {
+    throw new Error("Clipboard API is not available in this environment");
+  }
+
+  await navigator.clipboard.writeText(value);
+};

src/helpers/extractEmailDomain.test.ts

@@ -0,0 +1,26 @@
+import { describe, expect, test } from "vitest";
+import { extractEmailDomain } from "./extractEmailDomain";
+
+describe("extractEmailDomain", () => {
+  test("extracts domain from a standard email", () => {
+    expect(extractEmailDomain("user@example.com")).toBe("example.com");
+  });
+
+  test("extracts domain with subdomain", () => {
+    expect(extractEmailDomain("user@mail.example.com")).toBe(
+      "mail.example.com"
+    );
+  });
+
+  test("returns undefined when there is no @", () => {
+    expect(extractEmailDomain("notanemail")).toBeUndefined();
+  });
+
+  test("returns undefined when @ is the last character", () => {
+    expect(extractEmailDomain("user@")).toBeUndefined();
+  });
+
+  test("handles multiple @ signs (uses first)", () => {
+    expect(extractEmailDomain("a@b@example.com")).toBe("b@example.com");
+  });
+});

src/helpers/extractEmailDomain.ts

@@ -0,0 +1,5 @@
+export const extractEmailDomain = (email: string): string | undefined => {
+  const atIndex = email.indexOf("@");
+  if (atIndex === -1 || atIndex === email.length - 1) return undefined;
+  return email.slice(atIndex + 1);
+};

src/helpers/index.ts

@@ -9,10 +9,12 @@ export * from "./chunkedAsync";
 export * from "./chunkedDynamic";
 export * from "./clamp";
 export * from "./cleanSpaces";
+export * from "./copyToClipboard";
 export * from "./cyclicalItem";
 export * from "./dir";
 export * from "./enumKeys";
 export * from "./enumValues";
+export * from "./extractEmailDomain";
 export * from "./filterAlphanumeric";
 export * from "./first";
 export * from "./firstKey";