@synnaxlabs/x 0.36.0 → 0.38.0

package/dist/{xy-LADI2wVU.cjs → xy-Budz-qz-.cjs}

@@ -1 +1 @@
-"use strict";const O=require("zod"),i=require("./base-B48bPNx5.cjs"),z=O.z.union([O.z.number(),i.xy,i.numberCouple,i.dimensions,i.signedDimensions,i.clientXY]),s=(t,n)=>{if(typeof t=="string"){if(n===void 0)throw new Error("The y coordinate must be given.");return t==="x"?{x:n,y:0}:{x:0,y:n}}return typeof t=="number"?{x:t,y:n??t}:Array.isArray(t)?{x:t[0],y:t[1]}:"signedWidth"in t?{x:t.signedWidth,y:t.signedHeight}:"clientX"in t?{x:t.clientX,y:t.clientY}:"width"in t?{x:t.width,y:t.height}:{x:t.x,y:t.y}},u=Object.freeze({x:0,y:0}),P=Object.freeze({x:1,y:1}),v=Object.freeze({x:1/0,y:1/0}),E=Object.freeze({x:NaN,y:NaN}),g=(t,n,e=0)=>{const r=s(t),o=s(n);return e===0?r.x===o.x&&r.y===o.y:Math.abs(r.x-o.x)<=e&&Math.abs(r.y-o.y)<=e},I=t=>g(t,u),h=(t,n,e)=>{const r=s(t),o=s(n,e);return{x:r.x*o.x,y:r.y*o.y}},_=(t,n)=>{const e=s(t);return{x:e.x+n,y:e.y}},j=(t,n)=>{const e=s(t);return{x:e.x,y:e.y+n}},p=(t,n,e,...r)=>typeof n=="string"&&typeof e=="number"?n==="x"?_(t,e):j(t,e):[t,n,e??u,...r].reduce((o,y)=>{const c=s(y);return{x:o.x+c.x,y:o.y+c.y}},u),Z=(t,n,e)=>{const r=s(t);return n==="x"?{x:e,y:r.y}:{x:r.x,y:e}},w=(t,n)=>{const e=s(t),r=s(n);return Math.sqrt((e.x-r.x)**2+(e.y-r.y)**2)},A=(t,n)=>{const e=s(t),r=s(n);return{x:r.x-e.x,y:r.y-e.y}},T=t=>{const n=s(t);return Number.isNaN(n.x)||Number.isNaN(n.y)},H=t=>{const n=s(t);return Number.isFinite(n.x)&&Number.isFinite(n.y)},R=t=>{const n=s(t);return[n.x,n.y]},S=t=>{const n=s(t);return{left:n.x,top:n.y}},F=(t,n=0)=>{const e=s(t);return{x:Number(e.x.toFixed(n)),y:Number(e.y.toFixed(n))}},m=(t,n)=>{const e=s(t),r=s(n);return{x:e.x-r.x,y:e.y-r.y}},b=t=>{const n=s(t),e=Math.hypot(n.x,n.y);return e===0?{x:0,y:0}:{x:-n.y/e,y:n.x/e}},X=t=>{const n=s(t),e=Math.hypot(n.x,n.y);return e===0?{x:0,y:0}:{x:n.x/e,y:n.y/e}},Y=(...t)=>{const n=t.reduce((e,r)=>p(e,r),u);return h(n,1/t.length)},W=(t,n)=>{const e=[];for(let r=0;r<t.length;r++){const o=t[r];let y,c,d,x;if(r===0){const a=t[r+1],l=m(a,o);c=b(l),d=c,x=n}else if(r===t.length-1){const a=t[r-1],l=m(o,a);y=b(l),d=y,x=n}else{const a=t[r-1],l=t[r+1],f=m(o,a),N=m(l,o);y=b(f),c=b(N);const q=Math.acos((f.x*N.x+f.y*N.y)/(Math.hypot(f.x,f.y)*Math.hypot(N.x,N.y))),M=Math.sin(q/2);M===0?x=n:x=n/M,d=X(Y(y,c))}e.push(h(d,x))}return e},C=Object.freeze(Object.defineProperty({__proto__:null,INFINITY:v,NAN:E,ONE:P,ZERO:u,average:Y,calculateMiters:W,clientXY:i.clientXY,construct:s,couple:R,crudeZ:z,css:S,distance:w,equals:g,isFinite:H,isNan:T,isZero:I,normal:b,normalize:X,scale:h,set:Z,sub:m,translate:p,translateX:_,translateY:j,translation:A,truncate:F,xy:i.xy},Symbol.toStringTag,{value:"Module"}));exports.ONE=P;exports.ZERO=u;exports.construct=s;exports.crudeZ=z;exports.equals=g;exports.translate=p;exports.truncate=F;exports.xy=C;
+"use strict";const O=require("zod"),i=require("./base-B48bPNx5.cjs"),z=O.z.union([O.z.number(),i.xy,i.numberCouple,i.dimensions,i.signedDimensions,i.clientXY]),s=(t,n)=>{if(typeof t=="string"){if(n===void 0)throw new Error("The y coordinate must be given.");return t==="x"?{x:n,y:0}:{x:0,y:n}}return typeof t=="number"?{x:t,y:n??t}:Array.isArray(t)?{x:t[0],y:t[1]}:"signedWidth"in t?{x:t.signedWidth,y:t.signedHeight}:"clientX"in t?{x:t.clientX,y:t.clientY}:"width"in t?{x:t.width,y:t.height}:{x:t.x,y:t.y}},u=Object.freeze({x:0,y:0}),P=Object.freeze({x:1,y:1}),E=Object.freeze({x:1/0,y:1/0}),I=Object.freeze({x:NaN,y:NaN}),g=(t,n,e=0)=>{const r=s(t),o=s(n);return e===0?r.x===o.x&&r.y===o.y:Math.abs(r.x-o.x)<=e&&Math.abs(r.y-o.y)<=e},Z=t=>g(t,u),h=(t,n,e)=>{const r=s(t),o=s(n,e);return{x:r.x*o.x,y:r.y*o.y}},_=(t,n)=>{const e=s(t);return{x:e.x+n,y:e.y}},j=(t,n)=>{const e=s(t);return{x:e.x,y:e.y+n}},p=(t,n,e,...r)=>typeof n=="string"&&typeof e=="number"?n==="x"?_(t,e):j(t,e):[t,n,e??u,...r].reduce((o,y)=>{const c=s(y);return{x:o.x+c.x,y:o.y+c.y}},u),v=(t,n,e)=>{const r=s(t);return n==="x"?{x:e,y:r.y}:{x:r.x,y:e}},w=(t,n)=>{const e=s(t),r=s(n);return Math.sqrt((e.x-r.x)**2+(e.y-r.y)**2)},A=(t,n)=>{const e=s(t),r=s(n);return{x:r.x-e.x,y:r.y-e.y}},T=t=>{const n=s(t);return Number.isNaN(n.x)||Number.isNaN(n.y)},H=t=>{const n=s(t);return Number.isFinite(n.x)&&Number.isFinite(n.y)},R=t=>{const n=s(t);return[n.x,n.y]},S=t=>{const n=s(t);return{left:n.x,top:n.y}},F=(t,n=0)=>{const e=s(t);return{x:Number(e.x.toFixed(n)),y:Number(e.y.toFixed(n))}},m=(t,n)=>{const e=s(t),r=s(n);return{x:e.x-r.x,y:e.y-r.y}},d=t=>{const n=s(t),e=Math.hypot(n.x,n.y);return e===0?{x:0,y:0}:{x:-n.y/e,y:n.x/e}},X=t=>{const n=s(t),e=Math.hypot(n.x,n.y);return e===0?{x:0,y:0}:{x:n.x/e,y:n.y/e}},Y=(...t)=>{const n=t.reduce((e,r)=>p(e,r),u);return h(n,1/t.length)},W=(t,n)=>{const e=[];for(let r=0;r<t.length;r++){const o=t[r];let y,c,b,x;if(r===0){const a=t[r+1],l=m(a,o);c=d(l),b=c,x=n}else if(r===t.length-1){const a=t[r-1],l=m(o,a);y=d(l),b=y,x=n}else{const a=t[r-1],l=t[r+1],f=m(o,a),N=m(l,o);y=d(f),c=d(N);const q=Math.acos((f.x*N.x+f.y*N.y)/(Math.hypot(f.x,f.y)*Math.hypot(N.x,N.y))),M=Math.sin(q/2);M===0?x=n:x=n/M,b=X(Y(y,c))}e.push(h(b,x))}return e},C=Object.freeze(Object.defineProperty({__proto__:null,INFINITY:E,NAN:I,ONE:P,ZERO:u,average:Y,calculateMiters:W,clientXY:i.clientXY,construct:s,couple:R,crudeZ:z,css:S,distance:w,equals:g,isFinite:H,isNan:T,isZero:Z,normal:d,normalize:X,scale:h,set:v,sub:m,translate:p,translateX:_,translateY:j,translation:A,truncate:F,xy:i.xy},Symbol.toStringTag,{value:"Module"}));exports.ONE=P;exports.ZERO=u;exports.construct=s;exports.crudeZ=z;exports.equals=g;exports.translate=p;exports.truncate=F;exports.xy=C;

package/dist/{xy-DQdccWlc.js → xy-DxjPL2DZ.js}

@@ -1,9 +1,9 @@
 import { z as h } from "zod";
-import { x as p, n as I, d as w, s as A, i as M } from "./base-DnZzEvvz.js";
+import { x as p, n as v, d as w, s as A, i as M } from "./base-DnZzEvvz.js";
 const X = h.union([
   h.number(),
   p,
-  I,
+  v,
   w,
   A,
   M
@@ -78,9 +78,9 @@ const X = h.union([
     } else {
       const x = t[r - 1], u = t[r + 1], a = f(o, x), l = f(u, o);
       i = m(a), c = m(l);
-      const v = Math.acos(
+      const I = Math.acos(
         (a.x * l.x + a.y * l.y) / (Math.hypot(a.x, a.y) * Math.hypot(l.x, l.y))
-      ), g = Math.sin(v / 2);
+      ), g = Math.sin(I / 2);
       g === 0 ? y = n : y = n / g, b = j(F(i, c));
     }
     e.push(d(b, y));

package/dist/xy.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./xy-LADI2wVU.cjs");exports.xy=e.xy;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./xy-Budz-qz-.cjs");exports.xy=e.xy;

package/dist/xy.js

@@ -1,4 +1,4 @@
-import { x as r } from "./xy-DQdccWlc.js";
+import { x as r } from "./xy-DxjPL2DZ.js";
 export {
   r as xy
 };

package/dist/zodutil-BfrF8jE3.js

@@ -0,0 +1,23 @@
+import { z as s } from "zod";
+import { t as l, g } from "./path-DD6ytXzr.js";
+const c = (e) => l(e, (t, r, n) => {
+  const i = r === n.length - 1, u = !isNaN(parseInt(t)), a = !isNaN(parseInt(n[r + 1]));
+  return u && (t = "element"), i || a ? t : [t, "shape"];
+}), o = (e, t) => {
+  if (e == null) return null;
+  const r = e[t];
+  return r == null && typeof e == "object" && "sourceType" in e ? e.sourceType()[t] : r;
+}, m = (e, t, r) => g(
+  o(e, "shape"),
+  c(t),
+  { ...r, getter: o }
+), f = s.bigint().or(s.string().transform(BigInt)), y = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  bigInt: f,
+  getFieldSchema: m,
+  getFieldSchemaPath: c
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  f as b,
+  y as z
+};

package/dist/zodutil-DFJyyQd2.cjs

@@ -0,0 +1 @@
+"use strict";const s=require("zod"),c=require("./path-1tZLZ4AN.cjs"),i=e=>c.transformPath(e,(t,n,r)=>{const l=n===r.length-1,a=!isNaN(parseInt(t)),g=!isNaN(parseInt(r[n+1]));return a&&(t="element"),l||g?t:[t,"shape"]}),o=(e,t)=>{if(e==null)return null;const n=e[t];return n==null&&typeof e=="object"&&"sourceType"in e?e.sourceType()[t]:n},f=(e,t,n)=>c.get(o(e,"shape"),i(t),{...n,getter:o}),u=s.z.bigint().or(s.z.string().transform(BigInt)),p=Object.freeze(Object.defineProperty({__proto__:null,bigInt:u,getFieldSchema:f,getFieldSchemaPath:i},Symbol.toStringTag,{value:"Module"}));exports.bigInt=u;exports.zodutil=p;

package/dist/zodutil.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./zodutil-BRjUdYAv.cjs");exports.zodutil=t.zodutil;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./zodutil-DFJyyQd2.cjs");exports.zodutil=t.zodutil;

package/dist/zodutil.js

@@ -1,4 +1,4 @@
-import { z as t } from "./zodutil-DI4gVZkT.js";
+import { z as t } from "./zodutil-BfrF8jE3.js";
 export {
   t as zodutil
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/x",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "type": "module",
   "description": "Common Utilities for Synnax Labs",
   "repository": "https://github.com/synnaxlabs/synnax/tree/main/x/go",
@@ -13,19 +13,18 @@
     "control systems"
   ],
   "dependencies": {
-    "nanoid": "^5.0.7",
+    "nanoid": "^5.0.9",
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@types/node": "^22.7.5",
-    "@vitest/coverage-v8": "^2.1.8",
-    "eslint": "^9.16.0",
-    "typescript": "^5.6.3",
-    "vite": "^6.0.3",
+    "@types/node": "^22.10.6",
+    "eslint": "^9.18.0",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.7",
     "vitest": "^2.1.8",
     "@synnaxlabs/tsconfig": "0.0.2",
-    "eslint-config-synnaxlabs": "0.0.1",
-    "@synnaxlabs/vite-plugin": "0.0.1"
+    "@synnaxlabs/vite-plugin": "0.0.1",
+    "eslint-config-synnaxlabs": "0.0.1"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -180,7 +179,6 @@
   "scripts": {
     "build": "tsc --noEmit && vite build",
     "test": "vitest",
-    "cov": "vitest --coverage",
     "lint": "eslint --cache",
     "fix": "eslint --cache --fix"
   }

package/src/breaker/breaker.spec.ts

@@ -1,4 +1,5 @@
-import { describe, it, expect, vi } from "vitest";
+import { describe, expect, it, vi } from "vitest";
+
 import { breaker } from "@/breaker";
 import { TimeSpan } from "@/telem";
 
@@ -52,9 +53,7 @@ describe("breaker", () => {
     const brk = breaker.create();
     let attempts = 0;
 
-    while (await brk()) {
-      attempts++;
-    }
+    while (await brk()) attempts++;
 
     expect(attempts).toBe(5); // Default maxRetries is 5
   });

package/src/breaker/breaker.ts

@@ -1,7 +1,8 @@
-import { sleep } from "@/sleep";
-import { CrudeTimeSpan, TimeSpan } from "@/telem";
 import { z } from "zod";
 
+import { sleep } from "@/sleep";
+import { type CrudeTimeSpan, TimeSpan } from "@/telem";
+
 export const breakerConfig = z.object({
   interval: TimeSpan.z.optional(),
   maxRetries: z.number().optional(),

package/src/caseconv/caseconv.spec.ts

@@ -51,16 +51,8 @@ describe("caseconv", () => {
           [{ fooBar: 1 }, { bazQux: 2 }],
         ],
         [
-          {
-            channel_key: "test",
-            time_stamp: 123,
-            value: [1, 2, 3],
-          },
-          {
-            channelKey: "test",
-            timeStamp: 123,
-            value: [1, 2, 3],
-          },
+          { channel_key: "test", time_stamp: 123, value: [1, 2, 3] },
+          { channelKey: "test", timeStamp: 123, value: [1, 2, 3] },
         ],
       ];
       SPECS.forEach(([input, expected], i) => {
@@ -108,16 +100,8 @@ describe("caseconv", () => {
           [{ foo_bar: 1 }, { baz_qux: 2 }],
         ],
         [
-          {
-            channelKey: "test",
-            timeStamp: 123,
-            value: [1, 2, 3],
-          },
-          {
-            channel_key: "test",
-            time_stamp: 123,
-            value: [1, 2, 3],
-          },
+          { channelKey: "test", timeStamp: 123, value: [1, 2, 3] },
+          { channel_key: "test", time_stamp: 123, value: [1, 2, 3] },
         ],
       ];
       SPECS.forEach(([input, expected], i) => {
@@ -127,4 +111,20 @@ describe("caseconv", () => {
       });
     });
   });
+  describe("toKebab", () => {
+    const SPECS: [string, string][] = [
+      ["fooBar", "foo-bar"],
+      ["fooBarBaz", "foo-bar-baz"],
+      ["foo bar", "foo-bar"],
+      ["foo bar baz", "foo-bar-baz"],
+      ["foo.bar", "foo.bar"],
+      ["foo.bar.baz", "foo.bar.baz"],
+      ["Foo Bar", "foo-bar"],
+    ];
+    SPECS.forEach(([input, expected]) => {
+      it(`should convert ${input} to ${expected}`, () => {
+        expect(caseconv.toKebab(input)).toBe(expected);
+      });
+    });
+  });
 });

package/src/caseconv/caseconv.ts

@@ -77,6 +77,13 @@ const camelToSnakeStr = (str: string): string =>
   // Don't convert the first character and don't convert a character that is after a
   // non-alphanumeric character
   str.replace(/([a-z0-9])([A-Z])/g, (_, p1, p2) => `${p1}_${p2.toLowerCase()}`);
+
+/**
+ * Converts a camelCase string to snake_case.
+ *
+ * @param str - The string to convert
+ * @returns The converted string in snake_case
+ */
 export const camelToSnake = createConverter(camelToSnakeStr);
 
 /**
@@ -109,22 +116,44 @@ export interface Options {
 /**
  * Default options for convert function. This option is not recursive.
  */
-export const defaultOptions: Options = {
+const defaultOptions: Options = {
   recursive: true,
   recursiveInArray: true,
   keepTypesOnRecursion: [Number, String, Uint8Array],
 };
 
-export const validateOptions = (opt: Options = defaultOptions): Options => {
+const validateOptions = (opt: Options = defaultOptions): Options => {
   if (opt.recursive == null) opt = defaultOptions;
   else opt.recursiveInArray ??= false;
   return opt;
 };
 
-export const isArrayObject = (obj: any): boolean => obj != null && Array.isArray(obj);
+const isArrayObject = (obj: any): boolean => obj != null && Array.isArray(obj);
 
-export const isValidObject = (obj: any): boolean =>
+const isValidObject = (obj: any): boolean =>
   obj != null && typeof obj === "object" && !Array.isArray(obj);
 
-export const belongToTypes = (obj: any, types?: any[]): boolean =>
+const belongToTypes = (obj: any, types?: any[]): boolean =>
   (types || []).some((Type) => obj instanceof Type);
+
+/**
+ * Converts a string to kebab-case.
+ * Handles spaces, camelCase, and uppercase characters.
+ *
+ * @param str - The string to convert
+ * @returns The converted string in kebab-case
+ */
+const toKebabStr = (str: string): string =>
+  str
+    .replace(/\s+/g, "-")
+    .replace(/([a-z0-9])([A-Z])/g, (_, p1, p2) => `${p1}-${p2.toLowerCase()}`)
+    .toLowerCase();
+
+/**
+ * Converts a string to kebab-case.
+ * Handles spaces, camelCase, and uppercase characters.
+ *
+ * @param str - The string to convert
+ * @returns The converted string in kebab-case
+ */
+export const toKebab = createConverter(toKebabStr);

package/src/compare/compare.ts

@@ -99,8 +99,8 @@ export const uniqueUnorderedPrimitiveArrays = <T extends Primitive>(
   a: readonly T[] | T[],
   b: readonly T[] | T[],
 ): number => {
-  const uniqueA = unique(a);
-  const uniqueB = unique(b);
+  const uniqueA = unique.unique(a);
+  const uniqueB = unique.unique(b);
   return unorderedPrimitiveArrays(uniqueA, uniqueB);
 };
 

package/src/deep/path.ts

@@ -146,7 +146,7 @@ export const get = (<V = unknown, T = UnknownRecord>(
     result = v as UnknownRecord;
   }
   return result as V;
-}) as unknown as Get;
+}) as Get;
 
 /**
  * Sets the value at the given path on the object. If the parents of the deep path

package/src/index.ts

@@ -8,6 +8,7 @@
 // included in the file licenses/APL.txt.
 
 export * from "@/binary";
+export * from "@/breaker";
 export * from "@/caseconv";
 export * from "@/change";
 export * from "@/clamp/clamp";
@@ -21,6 +22,7 @@ export * from "@/id";
 export * from "@/identity";
 export * from "@/invert";
 export * from "@/kv";
+export * from "@/link";
 export * from "@/math";
 export * from "@/migrate";
 export * from "@/observe";
@@ -41,4 +43,3 @@ export * from "@/unique";
 export * from "@/url";
 export * from "@/worker";
 export * from "@/zodutil";
-export * from "@/breaker";

package/src/{unique.ts → kv/external.ts}

@@ -7,4 +7,5 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-export const unique = <V>(values: V[] | readonly V[]): V[] => [...new Set(values)];
+export * from "@/kv/mock";
+export * from "@/kv/types";

package/src/kv/index.ts

@@ -7,4 +7,4 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-export * as kv from "@/kv/types";
+export * as kv from "@/kv/external";

package/src/kv/mock.spec.ts

@@ -0,0 +1,101 @@
+// Copyright 2025 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+import { beforeEach, describe, expect, it } from "vitest";
+
+import { kv } from "@/kv";
+
+describe("MockAsync", () => {
+  let db: kv.MockAsync;
+
+  beforeEach(() => {
+    db = new kv.MockAsync();
+  });
+
+  it("should set and get values", async () => {
+    await db.set("key", "value");
+    expect(await db.get("key")).toBe("value");
+  });
+
+  it("should return null for non-existent keys", async () => {
+    expect(await db.get("non-existent")).toBeNull();
+  });
+
+  it("should delete values", async () => {
+    await db.set("key", "value");
+    await db.delete("key");
+    expect(await db.get("key")).toBeNull();
+  });
+
+  it("should return correct length", async () => {
+    expect(await db.length()).toBe(0);
+    await db.set("key1", "value1");
+    await db.set("key2", "value2");
+    expect(await db.length()).toBe(2);
+  });
+
+  it("should clear all values", async () => {
+    await db.set("key1", "value1");
+    await db.set("key2", "value2");
+    await db.clear();
+    expect(await db.length()).toBe(0);
+    expect(await db.get("key1")).toBeNull();
+  });
+
+  it("should handle different value types", async () => {
+    const number = 42;
+    const object = { test: "value" };
+    const array = [1, 2, 3];
+
+    await db.set("number", number);
+    await db.set("object", object);
+    await db.set("array", array);
+
+    expect(await db.get("number")).toBe(number);
+    expect(await db.get("object")).toEqual(object);
+    expect(await db.get("array")).toEqual(array);
+  });
+});
+
+describe("MockSync", () => {
+  let db: kv.MockSync;
+
+  beforeEach(() => {
+    db = new kv.MockSync();
+  });
+
+  it("should set and get values", () => {
+    db.set("key", "value");
+    expect(db.get("key")).toBe("value");
+  });
+
+  it("should return null for non-existent keys", () => {
+    expect(db.get("non-existent")).toBeNull();
+  });
+
+  it("should delete values", () => {
+    db.set("key", "value");
+    db.delete("key");
+    expect(db.get("key")).toBeNull();
+  });
+
+  it("should handle different value types", () => {
+    const number = 42;
+    const object = { test: "value" };
+    const array = [1, 2, 3];
+
+    db.set("number", number);
+    db.set("object", object);
+    db.set("array", array);
+
+    expect(db.get("number")).toBe(number);
+    expect(db.get("object")).toEqual(object);
+    expect(db.get("array")).toEqual(array);
+  });
+});

package/src/kv/mock.ts

@@ -0,0 +1,58 @@
+// Copyright 2024 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+import { type Async, type KV } from "@/kv/types";
+
+/**
+ * A mock implementation of an async key-value store that keeps all data in a map
+ * in memory.
+ */
+export class MockAsync implements Async {
+  readonly store: Map<string, unknown> = new Map();
+
+  async get<V>(key: string): Promise<V | null> {
+    return (this.store.get(key) as V) ?? null;
+  }
+
+  async set<V>(key: string, value: V): Promise<void> {
+    this.store.set(key, value);
+  }
+
+  async delete(key: string): Promise<void> {
+    this.store.delete(key);
+  }
+
+  async length(): Promise<number> {
+    return this.store.size;
+  }
+
+  async clear(): Promise<void> {
+    this.store.clear();
+  }
+}
+
+/**
+ * A mock implementation of a sync key-value store that keeps all data in a map
+ * in memory.
+ */
+export class MockSync implements KV {
+  readonly store: Map<string, unknown> = new Map();
+
+  get<V>(key: string): V | null {
+    return (this.store.get(key) as V) ?? null;
+  }
+
+  set<V>(key: string, value: V): void {
+    this.store.set(key, value);
+  }
+
+  delete(key: string): void {
+    this.store.delete(key);
+  }
+}

package/src/kv/types.ts

@@ -9,57 +9,51 @@
 
 import { z } from "zod";
 
-export interface KV<K = string, V = string, WK = K, WV = V, D = K>
-  extends Reader<K, V>,
-    Writer<WK, WV>,
-    Deleter<D> {}
-
-export interface Reader<K = string, V = string> {
+export interface Reader<V = unknown> {
   /** @returns the value for a given key, or null if the key is not present. */
-  get: (key: K) => V | null;
+  get: (key: string) => V | null;
 }
 
-export interface Writer<K = string, V = string> {
+export interface Writer<V = unknown> {
   /** Sets a key-value pair in the store. */
-  set: (key: K, value: V) => void;
+  set: (key: string, value: V) => void;
 }
 
-export interface Deleter<K = string> {
+export interface Deleter {
   /** Deletes a key-value pair from the store. */
-  delete: (key: K) => void;
+  delete: (key: string) => void;
 }
 
-/** A read-writable key-value store. */
-export interface Async<K = string, V = string, WK = K, WV = V, D = K>
-  extends AsyncReader<K, V>,
-    AsyncWriter<WK, WV>,
-    AsyncDeleter<D> {}
+export interface KV<R = unknown, W = R> extends Reader<R>, Writer<W>, Deleter {}
 
 /** A readable key-value store. */
-export interface AsyncReader<K = string, V = string> {
+export interface AsyncReader<V = unknown> {
   /** Get the value for a given key. */
-  get: (key: K) => Promise<V | null>;
+  get: (key: string) => Promise<V | null>;
 }
 
 /** A writable key-value store. */
-export interface AsyncWriter<K = string, V = string> {
+export interface AsyncWriter<V = unknown> {
   /** Sets a key-value pair in the store. The value must be serializable. */
-  set: (key: K, value: V) => Promise<void>;
+  set: (key: string, value: V) => Promise<void>;
 }
 
 /** A key-value store that can delete key-value pairs. */
-export interface AsyncDeleter<K = string> {
+export interface AsyncDeleter {
   /** Deletes a key-value pair from the store. */
-  delete: (key: K) => Promise<void>;
+  delete: (key: string) => Promise<void>;
 }
 
-export const stringPairZ = z.object({
-  key: z.string(),
-  value: z.string(),
-});
+/** A read-writable key-value store. */
+export interface Async<R = unknown, W = R>
+  extends AsyncReader<R>,
+    AsyncWriter<W>,
+    AsyncDeleter {}
+
+export const stringPairZ = z.object({ key: z.string(), value: z.string() });
 
 /** A general purpose key-value pair. */
-export interface Pair<K = string, V = string> {
-  key: K;
+export interface Pair<V = unknown> {
+  key: string;
   value: V;
 }

package/src/link/index.ts

@@ -0,0 +1,10 @@
+// Copyright 2024 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+export * as link from "@/link/link";

package/src/link/link.spec.ts

@@ -0,0 +1,68 @@
+// Copyright 2024 Synnax Labs, Inc.
+//
+// Use of this software is governed by the Business Source License included in the file
+// licenses/BSL.txt.
+//
+// As of the Change Date specified in that file, in accordance with the Business Source
+// License, use of this software will be governed by the Apache License, Version 2.0,
+// included in the file licenses/APL.txt.
+
+import { describe, expect, it } from "vitest";
+
+import { is } from "@/link/link";
+
+describe("is", () => {
+  // Valid IRIs
+  it("should return true for a simple HTTP URL", () => {
+    expect(is("http://example.com")).toBe(true);
+  });
+
+  it("should return true for an HTTP URL with a port", () => {
+    expect(is("http://example.com:8080")).toBe(true);
+  });
+
+  it("should return true for an HTTPS URL with path, query, and fragment", () => {
+    expect(is("https://example.com/path?query=param#fragment")).toBe(true);
+  });
+
+  it("should return true for an IRI with IPv4", () => {
+    expect(is("http://192.168.1.1")).toBe(true);
+  });
+
+  it("should return true for an IRI with percent-encoded spaces", () => {
+    expect(is("http://example.com/path%20with%20spaces")).toBe(true);
+  });
+
+  it("should return true for an IRI with query and fragment", () => {
+    expect(is("http://example.com/path?query=123#section")).toBe(true);
+  });
+
+  // Invalid IRIs
+  it("should return false for a URL with invalid characters", () => {
+    expect(is("http://example.com/invalid|character")).toBe(false);
+  });
+
+  it("should return false for a scheme with spaces", () => {
+    expect(is("ht tp://example.com")).toBe(false);
+  });
+
+  it("should return false for a URL with a missing host", () => {
+    expect(is("http://")).toBe(false);
+  });
+
+  it("should return false for a URL with an unsupported scheme", () => {
+    expect(is("xyz://example.com")).toBe(false);
+  });
+
+  it("should return false for an IPv6 with double colons", () => {
+    expect(is("http://[2001:db8:::1]")).toBe(false);
+  });
+
+  it("should return false for a scheme with a trailing colon", () => {
+    expect(is("http:/example.com")).toBe(false);
+  });
+
+  it("should return false for a fragment with spaces", () => {
+    expect(is("http://example.com#invalid fragment")).toBe(false);
+  });
+});