feat(logging): add error serialization and log metadata formatting

- Introduced `loggerSerialization.ts` to handle error serialization and log metadata formatting.
- Added `serializeError` function to convert Error objects into a structured format.
- Implemented `serializeLogValue` to handle various data types including Errors, Dates, RegExps, and plain objects.
- Created `formatLogMetadata` to format log metadata using the serialization functions.

feat(pagination): implement cursor encoding and decoding

- Added `pagination.ts` to manage cursor-based pagination.
- Implemented `encodeCursor` to convert cursor data into a base64 string.
- Developed `decodeCursor` to parse base64 strings back into cursor data, with error handling for invalid inputs.

src/loggerSerialization.ts

@@ -0,0 +1,89 @@
+export type LogMetadata = Record<string, unknown>;
+
+type SerializedError = {
+  name: string;
+  message: string;
+  stack?: string;
+  code?: unknown;
+  statusCode?: unknown;
+} & Record<string, unknown>;
+
+const serializeError = (error: Error): SerializedError => {
+  const serialized: SerializedError = {
+    name: error.name,
+    message: error.message,
+  };
+
+  if (error.stack) {
+    serialized.stack = error.stack;
+  }
+
+  const errorWithFields = error as Error & {
+    code?: unknown;
+    statusCode?: unknown;
+    [key: string]: unknown;
+  };
+
+  if (errorWithFields.code !== undefined) {
+    serialized.code = errorWithFields.code;
+  }
+
+  if (errorWithFields.statusCode !== undefined) {
+    serialized.statusCode = errorWithFields.statusCode;
+  }
+
+  for (const [key, value] of Object.entries(errorWithFields)) {
+    if (serialized[key] === undefined) {
+      serialized[key] = value;
+    }
+  }
+
+  return serialized;
+};
+
+const isPlainObject = (value: unknown): value is Record<string, unknown> => {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+};
+
+export const serializeLogValue = (value: unknown): unknown => {
+  if (value instanceof Error) {
+    return serializeError(value);
+  }
+
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+
+  if (value instanceof RegExp) {
+    return value.toString();
+  }
+
+  if (Array.isArray(value)) {
+    return value.map(serializeLogValue);
+  }
+
+  if (isPlainObject(value)) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nestedValue]) => [
+        key,
+        serializeLogValue(nestedValue),
+      ]),
+    );
+  }
+
+  return value;
+};
+
+export const formatLogMetadata = (metadata: LogMetadata): LogMetadata => {
+  return Object.fromEntries(
+    Object.entries(metadata).map(([key, value]) => [
+      key,
+      serializeLogValue(value),
+    ]),
+  );
+};