@yimingliao/cms 0.0.14 → 0.0.16

package/dist/{chunk-KEQXXUK2.js → chunk-SEX4DOKX.js}

@@ -204,4 +204,30 @@ var formatFileSize = (size, decimals = 2) => {
   return `${display} ${units[unitIndex]}`;
 };
 
-export { ADMIN_ROLES, FILE_TYPES, POST_TYPES, ROOT_FOLDER, ROOT_FOLDER_ID, ROOT_FOLDER_NAME, SIMPLE_UPLOAD_FOLDER_KEY, SIMPLE_UPLOAD_FOLDER_NAME, classifyFileType, formatFileSize, getMediaInfo, mimeToExtension };
+// src/shared/result/result.ts
+function success({
+  message,
+  data,
+  meta
+}) {
+  return {
+    success: true,
+    ...message !== void 0 ? { message } : {},
+    ...data !== void 0 ? { data } : {},
+    ...meta !== void 0 ? { meta } : {}
+  };
+}
+function error({ message, errors, code }) {
+  return {
+    success: false,
+    ...message !== void 0 ? { message } : {},
+    ...errors !== void 0 ? { errors } : {},
+    ...code !== void 0 ? { code } : {}
+  };
+}
+var result = {
+  success,
+  error
+};
+
+export { ADMIN_ROLES, FILE_TYPES, POST_TYPES, ROOT_FOLDER, ROOT_FOLDER_ID, ROOT_FOLDER_NAME, SIMPLE_UPLOAD_FOLDER_KEY, SIMPLE_UPLOAD_FOLDER_NAME, classifyFileType, formatFileSize, getMediaInfo, mimeToExtension, result };

package/dist/index.d.ts

@@ -27,4 +27,44 @@ interface BlobFile extends File {
     duration: number | null;
 }
 
-export { type BlobFile, FolderFull, ROOT_FOLDER, ROOT_FOLDER_ID, ROOT_FOLDER_NAME, SIMPLE_UPLOAD_FOLDER_KEY, SIMPLE_UPLOAD_FOLDER_NAME, classifyFileType, formatFileSize, getMediaInfo, mimeToExtension };
+interface SuccessResult<D = unknown> {
+    success: true;
+    message?: string;
+    data?: D;
+    meta?: Record<string, unknown>;
+}
+interface ErrorResult {
+    success: false;
+    message?: string;
+    errors?: ErrorDetail[];
+    code?: string;
+}
+interface ErrorDetail {
+    field?: string;
+    message?: string;
+    code?: string;
+}
+type Result<D = unknown> = SuccessResult<D> | ErrorResult;
+
+interface SuccessResultParams<D = unknown> {
+    message?: string;
+    data?: D;
+    meta?: Record<string, unknown>;
+}
+declare function success<D = unknown>({ message, data, meta, }: SuccessResultParams<D>): SuccessResult<D>;
+interface ErrorResultParams {
+    message?: string;
+    errors?: ErrorDetail[];
+    code?: string;
+}
+declare function error({ message, errors, code }: ErrorResultParams): ErrorResult;
+/**
+ * Generic result interface for API and action responses.
+ * Provides a unified structure for success and error outputs.
+ */
+declare const result: {
+    success: typeof success;
+    error: typeof error;
+};
+
+export { type BlobFile, type ErrorDetail, type ErrorResult, type ErrorResultParams, FolderFull, ROOT_FOLDER, ROOT_FOLDER_ID, ROOT_FOLDER_NAME, type Result, SIMPLE_UPLOAD_FOLDER_KEY, SIMPLE_UPLOAD_FOLDER_NAME, type SuccessResult, type SuccessResultParams, classifyFileType, formatFileSize, getMediaInfo, mimeToExtension, result };

package/dist/index.js

@@ -1 +1 @@
-export { ADMIN_ROLES, FILE_TYPES, POST_TYPES, ROOT_FOLDER, ROOT_FOLDER_ID, ROOT_FOLDER_NAME, SIMPLE_UPLOAD_FOLDER_KEY, SIMPLE_UPLOAD_FOLDER_NAME, classifyFileType, formatFileSize, getMediaInfo, mimeToExtension } from './chunk-KEQXXUK2.js';
+export { ADMIN_ROLES, FILE_TYPES, POST_TYPES, ROOT_FOLDER, ROOT_FOLDER_ID, ROOT_FOLDER_NAME, SIMPLE_UPLOAD_FOLDER_KEY, SIMPLE_UPLOAD_FOLDER_NAME, classifyFileType, formatFileSize, getMediaInfo, mimeToExtension, result } from './chunk-SEX4DOKX.js';

package/dist/server/index.d.ts

@@ -1,6 +1,8 @@
 import jwt from 'jsonwebtoken';
 import { BinaryLike } from 'node:crypto';
 import { cookies } from 'next/headers';
+import Keyv from 'keyv';
+import { Logger } from 'logry';
 import { e as AdminRole, v as SingleItem, B as BaseTranslation, a as Admin, c as AdminFull, f as AdminSafe, D as DeviceInfo, d as AdminRefreshToken, k as File, m as FileFull, o as FileType, p as Folder, F as FolderFull, u as PostType, M as MultiItems, E as ExternalLink, j as Faq, T as TocItem, q as Post, s as PostListCard, t as PostTranslation, r as PostFull, S as SeoMetadata, g as AdminTranslation, n as FileTranslation, h as Alternate } from '../base-DbGnfZr6.js';
 
 interface JwtServiceConfig {
@@ -84,6 +86,29 @@ declare function createCookieService(nextCookies: () => Promise<Awaited<ReturnTy
     }) => Promise<void>;
 };
 
+interface CreateServerCacheOptions {
+    redisUrl: string;
+    namespace: string;
+    keyDelimiter?: string;
+}
+declare function createCache({ redisUrl, namespace, keyDelimiter, }: CreateServerCacheOptions): Keyv<unknown>;
+
+type RawCacheKey = string | Array<string | number | boolean | undefined | null>;
+
+interface CacheResultOptions<T> {
+    key: RawCacheKey;
+    ttl?: number;
+    load: () => Promise<T>;
+}
+declare function createCacheResult(cache: Keyv<unknown>, logger: Logger): <T>({ key: rawKey, ttl, load, }: CacheResultOptions<T>) => Promise<T>;
+
+interface RateLimiterOptions {
+    key: RawCacheKey;
+    maxAttempts?: number;
+    timeWindow?: number;
+}
+declare function createIpRateLimiter(cache: Keyv<unknown>, appName: string): ({ key: rawKey, maxAttempts, timeWindow, }: RateLimiterOptions) => Promise<boolean>;
+
 interface CreateParams$4 {
     email: string;
     role: AdminRole;
@@ -585,4 +610,4 @@ declare const POST_ORDER_BY: ({
     index: "asc";
 })[];
 
-export { ADMIN_ORDER_BY, ORDER_BY, POST_ORDER_BY, createAdminCommandRepository, createAdminQueryRepository, createAdminRefreshTokenCommandRepository, createAdminRefreshTokenQueryRepository, createArgon2Service, createCookieService, createCryptoService, createFileCommandRepository, createFileQueryRepository, createFolderCommandRepository, createFolderQueryRepository, createJwtService, createPostCommandRepository, createPostQueryRepository, createSeoMetadataCommandRepository };
+export { ADMIN_ORDER_BY, ORDER_BY, POST_ORDER_BY, createAdminCommandRepository, createAdminQueryRepository, createAdminRefreshTokenCommandRepository, createAdminRefreshTokenQueryRepository, createArgon2Service, createCache, createCacheResult, createCookieService, createCryptoService, createFileCommandRepository, createFileQueryRepository, createFolderCommandRepository, createFolderQueryRepository, createIpRateLimiter, createJwtService, createPostCommandRepository, createPostQueryRepository, createSeoMetadataCommandRepository };

package/dist/server/index.js

@@ -1,8 +1,10 @@
-import { ADMIN_ROLES, mimeToExtension, classifyFileType, ROOT_FOLDER_ID } from '../chunk-KEQXXUK2.js';
+import { ADMIN_ROLES, mimeToExtension, classifyFileType, ROOT_FOLDER_ID } from '../chunk-SEX4DOKX.js';
 import jwt from 'jsonwebtoken';
 import argon2, { argon2id } from 'argon2';
 import crypto, { timingSafeEqual } from 'crypto';
-import 'next/headers';
+import { headers } from 'next/headers';
+import KeyvRedis from '@keyv/redis';
+import Keyv from 'keyv';
 import { ulid } from 'ulid';
 
 function createJwtService(config) {
@@ -194,6 +196,114 @@ function createCookieService(nextCookies, cryptoService) {
   };
 }
 
+// src/server/infrastructure/cache/cache-key-delimiter.ts
+var CACHE_KEY_DELIMITER = "|";
+
+// src/server/infrastructure/cache/create-cache.ts
+function createCache({
+  redisUrl,
+  namespace,
+  keyDelimiter = CACHE_KEY_DELIMITER
+}) {
+  const redisStore = new KeyvRedis(redisUrl, {
+    keyPrefixSeparator: keyDelimiter
+  });
+  return new Keyv({
+    store: redisStore,
+    namespace,
+    useKeyPrefix: false
+  });
+}
+
+// src/server/infrastructure/cache/normalize-cache-key.ts
+var sanitize = (k) => k.replaceAll(/[\u200B-\u200D\uFEFF]/g, "").replaceAll(/[\r\n]/g, "").trim();
+var normalizeCacheKey = (key, delimiter = CACHE_KEY_DELIMITER) => {
+  if (!key) return null;
+  if (Array.isArray(key)) {
+    if (key.length === 0) return null;
+    const normalized = key.map((k) => {
+      if (k === null) return "__null";
+      if (k === void 0) return "__undefined";
+      if (typeof k === "boolean") return k ? "__true" : "__false";
+      return sanitize(String(k));
+    });
+    return normalized.join(delimiter);
+  }
+  if (typeof key === "boolean") return key ? "__true" : "__false";
+  return String(key);
+};
+
+// src/server/infrastructure/cache/create-cache-result.ts
+var DAY = 1e3 * 60 * 60 * 24;
+function createCacheResult(cache, logger) {
+  return async function cacheResult({
+    key: rawKey,
+    ttl = DAY,
+    load
+  }) {
+    const key = normalizeCacheKey(rawKey);
+    if (!key) {
+      logger.error("Cache skipped due to invalid key", {
+        rawKey,
+        scope: "cacheResult"
+      });
+      return load();
+    }
+    try {
+      const cached = await cache.get(key);
+      if (cached !== void 0) {
+        return cached;
+      }
+      const data = await load();
+      if (data !== void 0) {
+        await cache.set(key, data, ttl);
+      }
+      return data;
+    } catch (error) {
+      logger.error("Cache failure, falling back to loader", {
+        key,
+        error,
+        scope: "cacheResult"
+      });
+      return load();
+    }
+  };
+}
+var DEFAULT_MAX_ATTEMPTS = 10;
+var DEFAULT_TIME_WINDOW = 60;
+var lua = `
+    local current = redis.call('INCR', KEYS[1])
+    if current == 1 then
+      redis.call('EXPIRE', KEYS[1], ARGV[1])
+    end
+    return current
+  `;
+function createIpRateLimiter(cache, appName) {
+  return async function ipRateLimiter({
+    key: rawKey,
+    maxAttempts = DEFAULT_MAX_ATTEMPTS,
+    timeWindow = DEFAULT_TIME_WINDOW
+  }) {
+    const secondaryStore = cache.store;
+    const redis = await secondaryStore.getClient();
+    if (!redis) return true;
+    const headersStore = await headers();
+    const ip = headersStore.get("cf-connecting-ip")?.trim() || headersStore.get("x-forwarded-for")?.split(",")[0]?.trim() || "unknown";
+    const key = normalizeCacheKey([
+      appName,
+      "ip-rate-limiter",
+      ...Array.isArray(rawKey) ? rawKey : [rawKey],
+      ip
+    ]);
+    const currentRaw = await redis.eval(lua, {
+      keys: [key],
+      arguments: [timeWindow.toString()]
+    });
+    const current = typeof currentRaw === "number" ? currentRaw : Number(currentRaw);
+    return current <= maxAttempts;
+  };
+}
+
 // src/server/infrastructure/database/utils/connect.ts
 var ids = (items) => items.map(({ id }) => ({ id }));
 function connectOne(item) {
@@ -1307,4 +1417,4 @@ function createSeoMetadataCommandRepository(prisma) {
   };
 }
 
-export { ADMIN_ORDER_BY, ORDER_BY, POST_ORDER_BY, createAdminCommandRepository, createAdminQueryRepository, createAdminRefreshTokenCommandRepository, createAdminRefreshTokenQueryRepository, createArgon2Service, createCookieService, createCryptoService, createFileCommandRepository, createFileQueryRepository, createFolderCommandRepository, createFolderQueryRepository, createJwtService, createPostCommandRepository, createPostQueryRepository, createSeoMetadataCommandRepository };
+export { ADMIN_ORDER_BY, ORDER_BY, POST_ORDER_BY, createAdminCommandRepository, createAdminQueryRepository, createAdminRefreshTokenCommandRepository, createAdminRefreshTokenQueryRepository, createArgon2Service, createCache, createCacheResult, createCookieService, createCryptoService, createFileCommandRepository, createFileQueryRepository, createFolderCommandRepository, createFolderQueryRepository, createIpRateLimiter, createJwtService, createPostCommandRepository, createPostQueryRepository, createSeoMetadataCommandRepository };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yimingliao/cms",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "author": "Yiming Liao",
   "license": "MIT",
   "type": "module",
@@ -26,8 +26,11 @@
     "prepublishOnly": "yarn build"
   },
   "dependencies": {
+    "@keyv/redis": "^5.1.6",
     "argon2": "^0.44.0",
     "jsonwebtoken": "^9.0.3",
+    "keyv": "^5.6.0",
+    "logry": "^2.1.6",
     "mime-types": "^3.0.2",
     "ulid": "^3.0.2"
   },