@uityu/uityu-shared 1.0.2 → 1.0.5

package/dist/common/domain/index.d.ts

@@ -0,0 +1 @@
+export * from "./math";

package/dist/common/domain/index.js

@@ -0,0 +1 @@
+export * from "./math";

package/dist/common/domain/math/clamp-limit.d.ts

@@ -0,0 +1,12 @@
+export interface ClampOptions {
+    /** Value to use when the input is undefined or not finite */
+    defaultValue: number;
+    /** Upper bound; must be a finite number */
+    max: number;
+    /** Optional lower bound; defaults to 1 */
+    min?: number;
+}
+/**
+ * Domain-level guard to clamp numeric limits while providing sane defaults.
+ */
+export declare function clampLimit(value: number | undefined, options: ClampOptions): number;

package/dist/common/domain/math/clamp-limit.js

@@ -0,0 +1,15 @@
+/**
+ * Domain-level guard to clamp numeric limits while providing sane defaults.
+ */
+export function clampLimit(value, options) {
+    const normalized = toFiniteNumber(value, options.defaultValue);
+    const min = toFiniteNumber(options.min, 1);
+    const max = toFiniteNumber(options.max, min);
+    if (max < min) {
+        throw new Error("Clamp max must be greater than or equal to min");
+    }
+    return Math.min(max, Math.max(min, normalized));
+}
+function toFiniteNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}

package/dist/common/domain/math/index.d.ts

@@ -0,0 +1 @@
+export * from "./clamp-limit";

package/dist/common/domain/math/index.js

@@ -0,0 +1 @@
+export * from "./clamp-limit";

package/dist/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./domain";
+export * from "./infrastructure";

package/dist/common/index.js

@@ -0,0 +1,2 @@
+export * from "./domain";
+export * from "./infrastructure";

package/dist/common/infrastructure/index.d.ts

@@ -0,0 +1 @@
+export * from "./logging";

package/dist/common/infrastructure/index.js

@@ -0,0 +1 @@
+export * from "./logging";

package/dist/common/infrastructure/logging/index.d.ts

@@ -0,0 +1 @@
+export * from "./serialize-log-payload";

package/dist/common/infrastructure/logging/index.js

@@ -0,0 +1 @@
+export * from "./serialize-log-payload";

package/dist/common/infrastructure/logging/serialize-log-payload.d.ts

@@ -0,0 +1,11 @@
+export type LogLevel = "INFO" | "ERROR";
+export type LogPayload = {
+    namespace: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+    error?: unknown;
+};
+export declare function serializeLogPayload(payload: unknown): Record<string, unknown>;
+export declare function logInfo(payload: LogPayload): void;
+export declare function logError(payload: LogPayload): void;
+export declare function logFirestoreUsage(collection: string, operation: string, metadata?: Record<string, unknown>, hit?: boolean): void;

package/dist/common/infrastructure/logging/serialize-log-payload.js

@@ -0,0 +1,82 @@
+export function serializeLogPayload(payload) {
+    if (!isSerializableObject(payload)) {
+        return {};
+    }
+    try {
+        const serialized = JSON.parse(JSON.stringify(payload, (_key, value) => normalizeValue(value)));
+        if (isSerializableObject(serialized)) {
+            return serialized;
+        }
+        return { value: serialized };
+    }
+    catch {
+        return { value: "[unserializable]" };
+    }
+}
+export function logInfo(payload) {
+    log("INFO", payload);
+}
+export function logError(payload) {
+    log("ERROR", payload);
+}
+export function logFirestoreUsage(collection, operation, metadata = {}, hit) {
+    logInfo({
+        namespace: "FirestoreUsage",
+        message: `${collection}.${operation}`,
+        metadata: { ...metadata, hit },
+    });
+}
+function log(level, payload) {
+    const entry = {
+        level,
+        timestamp: new Date().toISOString(),
+        namespace: payload.namespace,
+        message: payload.message,
+        metadata: serializeLogPayload(payload.metadata ?? {}),
+        error: normalizeError(payload.error),
+    };
+    const serialized = JSON.stringify(entry);
+    if (level === "ERROR") {
+        console.error(serialized);
+        return;
+    }
+    console.log(serialized);
+}
+function normalizeError(error) {
+    if (!error) {
+        return undefined;
+    }
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+    }
+    return serializeLogPayload(error);
+}
+function normalizeValue(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (hasToJSON(value)) {
+        try {
+            return value.toJSON();
+        }
+        catch {
+            return "[unserializable]";
+        }
+    }
+    return value;
+}
+function hasToJSON(value) {
+    return Boolean(value && typeof value === "object" &&
+        "toJSON" in value &&
+        typeof value.toJSON === "function");
+}
+function isSerializableObject(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export { toApiError } from "./http/error-mapper";
 export type { ApiErrorResponse } from "./http/error-mapper";
 export { createEmptySearchIndex, normalizeSearchText, buildSearchPrefixes, toSearchPrefix, normalizePhoneDigits, } from "./search/search-index";
 export type { SearchIndex } from "./search/search-index";
+export * from "./common";

package/dist/index.js

@@ -3,3 +3,4 @@ export { AppError } from "./errors/app-error";
 export { AppErrorFactory } from "./errors/app-error.factory";
 export { toApiError } from "./http/error-mapper";
 export { createEmptySearchIndex, normalizeSearchText, buildSearchPrefixes, toSearchPrefix, normalizePhoneDigits, } from "./search/search-index";
+export * from "./common";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uityu/uityu-shared",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -18,8 +18,41 @@
       "types": "./dist/search/search-index.d.ts",
       "import": "./dist/search/search-index.js"
     },
+    "./common": {
+      "types": "./dist/common/index.d.ts",
+      "import": "./dist/common/index.js"
+    },
+    "./common/*": {
+      "types": "./dist/common/*/index.d.ts",
+      "import": "./dist/common/*/index.js"
+    },
     "./package.json": "./package.json"
   },
+  "typesVersions": {
+    "*": {
+      "common": [
+        "dist/common/index.d.ts"
+      ],
+      "common/*": [
+        "dist/common/*/index.d.ts"
+      ],
+      "errors": [
+        "dist/errors/index.d.ts"
+      ],
+      "errors/*": [
+        "dist/errors/*/index.d.ts"
+      ],
+      "search-index": [
+        "dist/search/search-index.d.ts"
+      ],
+      "search-index/*": [
+        "dist/search/*/index.d.ts"
+      ],
+      "*": [
+        "dist/index.d.ts"
+      ]
+    }
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json"
   }

package/src/common/domain/index.ts

@@ -0,0 +1 @@
+export * from "./math";

package/src/common/domain/math/clamp-limit.ts

@@ -0,0 +1,27 @@
+export interface ClampOptions {
+  /** Value to use when the input is undefined or not finite */
+  defaultValue: number;
+  /** Upper bound; must be a finite number */
+  max: number;
+  /** Optional lower bound; defaults to 1 */
+  min?: number;
+}
+
+/**
+ * Domain-level guard to clamp numeric limits while providing sane defaults.
+ */
+export function clampLimit(value: number | undefined, options: ClampOptions): number {
+  const normalized = toFiniteNumber(value, options.defaultValue);
+  const min = toFiniteNumber(options.min, 1);
+  const max = toFiniteNumber(options.max, min);
+
+  if (max < min) {
+    throw new Error("Clamp max must be greater than or equal to min");
+  }
+
+  return Math.min(max, Math.max(min, normalized));
+}
+
+function toFiniteNumber(value: number | undefined, fallback: number): number {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}

package/src/common/domain/math/index.ts

@@ -0,0 +1 @@
+export * from "./clamp-limit";

package/src/common/index.ts

@@ -0,0 +1,2 @@
+export * from "./domain";
+export * from "./infrastructure";

package/src/common/infrastructure/index.ts

@@ -0,0 +1 @@
+export * from "./logging";

package/src/common/infrastructure/logging/index.ts

@@ -0,0 +1 @@
+export * from "./serialize-log-payload";

package/src/common/infrastructure/logging/serialize-log-payload.ts

@@ -0,0 +1,116 @@
+export type LogLevel = "INFO" | "ERROR";
+
+export type LogPayload = {
+  namespace: string;
+  message: string;
+  metadata?: Record<string, unknown>;
+  error?: unknown;
+};
+
+export function serializeLogPayload(payload: unknown): Record<string, unknown> {
+  if (!isSerializableObject(payload)) {
+    return {};
+  }
+
+  try {
+    const serialized = JSON.parse(
+      JSON.stringify(payload, (_key, value) => normalizeValue(value)),
+    );
+
+    if (isSerializableObject(serialized)) {
+      return serialized;
+    }
+
+    return { value: serialized };
+  } catch {
+    return { value: "[unserializable]" };
+  }
+}
+
+export function logInfo(payload: LogPayload): void {
+  log("INFO", payload);
+}
+
+export function logError(payload: LogPayload): void {
+  log("ERROR", payload);
+}
+
+export function logFirestoreUsage(
+  collection: string,
+  operation: string,
+  metadata: Record<string, unknown> = {},
+  hit?: boolean,
+): void {
+  logInfo({
+    namespace: "FirestoreUsage",
+    message: `${collection}.${operation}`,
+    metadata: { ...metadata, hit },
+  });
+}
+
+function log(level: LogLevel, payload: LogPayload): void {
+  const entry = {
+    level,
+    timestamp: new Date().toISOString(),
+    namespace: payload.namespace,
+    message: payload.message,
+    metadata: serializeLogPayload(payload.metadata ?? {}),
+    error: normalizeError(payload.error),
+  };
+
+  const serialized = JSON.stringify(entry);
+  if (level === "ERROR") {
+    console.error(serialized);
+    return;
+  }
+
+  console.log(serialized);
+}
+
+function normalizeError(error: unknown): unknown {
+  if (!error) {
+    return undefined;
+  }
+
+  if (error instanceof Error) {
+    return {
+      name: error.name,
+      message: error.message,
+      stack: error.stack,
+    };
+  }
+
+  return serializeLogPayload(error);
+}
+
+function normalizeValue(value: unknown): unknown {
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+
+  if (hasToJSON(value)) {
+    try {
+      return value.toJSON();
+    } catch {
+      return "[unserializable]";
+    }
+  }
+
+  return value;
+}
+
+function hasToJSON(value: unknown): value is { toJSON: () => unknown } {
+  return Boolean(
+    value && typeof value === "object" &&
+      "toJSON" in value &&
+      typeof (value as { toJSON?: unknown }).toJSON === "function",
+  );
+}
+
+function isSerializableObject(value: unknown): value is Record<string, unknown> {
+  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}

package/src/index.ts

@@ -11,3 +11,4 @@ export {
 	normalizePhoneDigits,
 } from "./search/search-index";
 export type { SearchIndex } from "./search/search-index";
+export * from "./common";