@abyss-project/tools 1.0.0 → 1.0.3

package/src/types/interface/models/user.dto.ts

@@ -1,26 +1,26 @@
-import { IAtlas } from './atlas.dto';
-import { IBoard } from './board.dto';
-import { IBoardCardComment } from './board-card-comment.dto';
-import { IDraw } from './draw.dto';
-import { IMemo } from './memo.dto';
-import { IProject } from './project.dto';
-import { IRetrospective } from './retrospective.dto';
-import { IShortLink } from './short-link.dto';
-
-export interface IUser {
-  id?: string;
-  apiKey: string;
-  isAdmin: boolean;
-  updatedAt?: Date;
-  createdAt?: Date;
-
-  // Associations
-  projects?: IProject[];
-  boards?: IBoard[];
-  draws?: IDraw[];
-  retrospectives?: IRetrospective[];
-  atlases?: IAtlas[];
-  memos?: IMemo[];
-  shortLinks?: IShortLink[];
-  boardCardComments?: IBoardCardComment[];
-}
+import { IAtlas } from './atlas.dto';
+import { IBoard } from './board.dto';
+import { IBoardCardComment } from './board-card-comment.dto';
+import { IDraw } from './draw.dto';
+import { IMemo } from './memo.dto';
+import { IProject } from './project.dto';
+import { IRetrospective } from './retrospective.dto';
+import { IShortLink } from './short-link.dto';
+
+export interface IUser {
+  id?: string;
+  apiKey: string;
+  isAdmin: boolean;
+  updatedAt?: Date;
+  createdAt?: Date;
+
+  // Associations
+  projects?: IProject[];
+  boards?: IBoard[];
+  draws?: IDraw[];
+  retrospectives?: IRetrospective[];
+  atlases?: IAtlas[];
+  memos?: IMemo[];
+  shortLinks?: IShortLink[];
+  boardCardComments?: IBoardCardComment[];
+}

package/src/utils/board.utils.ts

@@ -1,57 +1,57 @@
-import { differenceInCalendarDays, isBefore } from 'date-fns';
-import { BoardColumnType, IBoardCard } from '../types';
-
-const BOARD_COLUMN_TYPE_STARTED = [BoardColumnType.DOING, BoardColumnType.DONE];
-const BOARD_COLUMN_TYPE_DONE = [BoardColumnType.DONE];
-
-export const isCardStartDateLate = (
-  boardCard: IBoardCard,
-  boardColumnType: BoardColumnType,
-): boolean => {
-  if (!boardCard.startDate) {
-    return false;
-  }
-  return (
-    isBefore(new Date(boardCard.startDate), new Date()) &&
-    !BOARD_COLUMN_TYPE_STARTED.includes(boardColumnType)
-  );
-};
-
-export const isAlmostCardStartDateLate = (
-  boardCard: IBoardCard,
-  boardColumnType: BoardColumnType,
-): boolean => {
-  if (!boardCard.startDate) {
-    return false;
-  }
-  return (
-    !isCardStartDateLate(boardCard, boardColumnType) &&
-    differenceInCalendarDays(new Date(boardCard.startDate), new Date()) <= 2
-  );
-};
-
-export const isCardEndDateLate = (
-  boardCard: IBoardCard,
-  boardColumnType: BoardColumnType,
-): boolean => {
-  if (!boardCard.endDate) {
-    return false;
-  }
-  return (
-    isBefore(new Date(boardCard.endDate), new Date()) &&
-    !BOARD_COLUMN_TYPE_DONE.includes(boardColumnType)
-  );
-};
-
-export const isAlmostCardEndDateLate = (
-  boardCard: IBoardCard,
-  boardColumnType: BoardColumnType,
-): boolean => {
-  if (!boardCard.endDate) {
-    return false;
-  }
-  return (
-    !isCardEndDateLate(boardCard, boardColumnType) &&
-    Math.abs(differenceInCalendarDays(new Date(boardCard.endDate), new Date())) <= 2
-  );
-};
+import { differenceInCalendarDays, isBefore } from 'date-fns';
+import { BoardColumnType, IBoardCard } from '../types';
+
+const BOARD_COLUMN_TYPE_STARTED = [BoardColumnType.DOING, BoardColumnType.DONE];
+const BOARD_COLUMN_TYPE_DONE = [BoardColumnType.DONE];
+
+export const isCardStartDateLate = (
+  boardCard: IBoardCard,
+  boardColumnType: BoardColumnType,
+): boolean => {
+  if (!boardCard.startDate) {
+    return false;
+  }
+  return (
+    isBefore(new Date(boardCard.startDate), new Date()) &&
+    !BOARD_COLUMN_TYPE_STARTED.includes(boardColumnType)
+  );
+};
+
+export const isAlmostCardStartDateLate = (
+  boardCard: IBoardCard,
+  boardColumnType: BoardColumnType,
+): boolean => {
+  if (!boardCard.startDate) {
+    return false;
+  }
+  return (
+    !isCardStartDateLate(boardCard, boardColumnType) &&
+    differenceInCalendarDays(new Date(boardCard.startDate), new Date()) <= 2
+  );
+};
+
+export const isCardEndDateLate = (
+  boardCard: IBoardCard,
+  boardColumnType: BoardColumnType,
+): boolean => {
+  if (!boardCard.endDate) {
+    return false;
+  }
+  return (
+    isBefore(new Date(boardCard.endDate), new Date()) &&
+    !BOARD_COLUMN_TYPE_DONE.includes(boardColumnType)
+  );
+};
+
+export const isAlmostCardEndDateLate = (
+  boardCard: IBoardCard,
+  boardColumnType: BoardColumnType,
+): boolean => {
+  if (!boardCard.endDate) {
+    return false;
+  }
+  return (
+    !isCardEndDateLate(boardCard, boardColumnType) &&
+    Math.abs(differenceInCalendarDays(new Date(boardCard.endDate), new Date())) <= 2
+  );
+};

package/src/utils/enum.utils.ts

@@ -1,6 +1,5 @@
-// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
-export const enumToArray = (enums: any): string[] => {
-  return Object.keys(enums).map((type) => {
-    return enums[type];
-  });
-};
+export const enumToArray = (enums: Record<string, string>): string[] => {
+  return Object.keys(enums).map((type) => {
+    return enums[type];
+  });
+};

package/src/utils/error.utils.ts

@@ -1,30 +1,30 @@
-import { Code, ErrorType } from '../types';
-
-type ErrorParams = { code: Code; type: ErrorType; message?: string };
-
-export class ServiceException extends Error {
-  private readonly code: Code;
-
-  private readonly type: ErrorType;
-
-  getCode(): Code {
-    return this.code;
-  }
-
-  getType(): ErrorType {
-    return this.type;
-  }
-
-  constructor(params: ErrorParams) {
-    super(params.message);
-    this.code = params.code;
-    this.type = params.type;
-  }
-}
-
-export const handleError = (error: Error | ErrorParams, _params?: ErrorParams): Error => {
-  if (error instanceof Error) {
-    return error;
-  }
-  return new ServiceException(error);
-};
+import { Code, ErrorType } from '../types';
+
+type ErrorParams = { code: Code; type: ErrorType; message?: string };
+
+export class ServiceException extends Error {
+  private readonly code: Code;
+
+  private readonly type: ErrorType;
+
+  getCode(): Code {
+    return this.code;
+  }
+
+  getType(): ErrorType {
+    return this.type;
+  }
+
+  constructor(params: ErrorParams) {
+    super(params.message);
+    this.code = params.code;
+    this.type = params.type;
+  }
+}
+
+export const handleError = (error: Error | ErrorParams, _params?: ErrorParams): Error => {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new ServiceException(error);
+};

package/src/utils/icons.utils.ts

@@ -1,96 +1,96 @@
-export const ICON_LIBRARY = {
-  database: '🗄️',
-  server: '🖥️',
-  cloud: '☁️',
-  network: '🌐',
-  router: '📡',
-  security: '🔒',
-  warning: '⚠️',
-  error: '❌',
-  success: '✅',
-  info: 'ℹ️',
-
-  diamond: '💎',
-  gear: '⚙️',
-  tool: '🔧',
-  wrench: '🔨',
-
-  arrowUp: '⬆️',
-  arrowDown: '⬇️',
-  arrowLeft: '⬅️',
-  arrowRight: '➡️',
-  arrowUpRight: '↗️',
-  arrowDownRight: '↘️',
-  arrowDownLeft: '↙️',
-  arrowUpLeft: '↖️',
-
-  start: '🚀',
-  stop: '🛑',
-  pause: '⏸️',
-  play: '▶️',
-  process: '⚡',
-
-  email: '📧',
-  phone: '📞',
-  message: '💬',
-  notification: '🔔',
-
-  document: '📄',
-  folder: '📁',
-  file: '📋',
-  pdf: '📕',
-  image: '🖼️',
-
-  user: '👤',
-  users: '👥',
-  team: '👪',
-  admin: '👨‍💼',
-
-  add: '➕',
-  remove: '➖',
-  edit: '✏️',
-  search: '🔍',
-  filter: '🔽',
-  sort: '📊',
-
-  online: '🟢',
-  offline: '🔴',
-  pending: '🟡',
-  unknown: '⚪',
-
-  circle: '⭕',
-  square: '⬜',
-  triangle: '🔺',
-  star: '⭐',
-  heart: '❤️',
-
-  settings: '⚙️',
-  power: '🔌',
-  battery: '🔋',
-  wifi: '📶',
-  bluetooth: '📲',
-};
-
-export const ICON_CATEGORIES = {
-  technical: ['database', 'server', 'cloud', 'network', 'router', 'security'],
-  status: ['warning', 'error', 'success', 'info', 'online', 'offline', 'pending', 'unknown'],
-  arrows: [
-    'arrowUp',
-    'arrowDown',
-    'arrowLeft',
-    'arrowRight',
-    'arrowUpRight',
-    'arrowDownRight',
-    'arrowDownLeft',
-    'arrowUpLeft',
-  ],
-  process: ['start', 'stop', 'pause', 'play', 'process', 'gear', 'tool', 'wrench'],
-  communication: ['email', 'phone', 'message', 'notification'],
-  files: ['document', 'folder', 'file', 'pdf', 'image'],
-  users: ['user', 'users', 'team', 'admin'],
-  actions: ['add', 'remove', 'edit', 'search', 'filter', 'sort'],
-  shapes: ['circle', 'square', 'triangle', 'star', 'heart', 'diamond'],
-  system: ['settings', 'power', 'battery', 'wifi', 'bluetooth'],
-};
-
-export type IconType = keyof typeof ICON_LIBRARY;
+export const ICON_LIBRARY = {
+  database: '🗄️',
+  server: '🖥️',
+  cloud: '☁️',
+  network: '🌐',
+  router: '📡',
+  security: '🔒',
+  warning: '⚠️',
+  error: '❌',
+  success: '✅',
+  info: 'ℹ️',
+
+  diamond: '💎',
+  gear: '⚙️',
+  tool: '🔧',
+  wrench: '🔨',
+
+  arrowUp: '⬆️',
+  arrowDown: '⬇️',
+  arrowLeft: '⬅️',
+  arrowRight: '➡️',
+  arrowUpRight: '↗️',
+  arrowDownRight: '↘️',
+  arrowDownLeft: '↙️',
+  arrowUpLeft: '↖️',
+
+  start: '🚀',
+  stop: '🛑',
+  pause: '⏸️',
+  play: '▶️',
+  process: '⚡',
+
+  email: '📧',
+  phone: '📞',
+  message: '💬',
+  notification: '🔔',
+
+  document: '📄',
+  folder: '📁',
+  file: '📋',
+  pdf: '📕',
+  image: '🖼️',
+
+  user: '👤',
+  users: '👥',
+  team: '👪',
+  admin: '👨‍💼',
+
+  add: '➕',
+  remove: '➖',
+  edit: '✏️',
+  search: '🔍',
+  filter: '🔽',
+  sort: '📊',
+
+  online: '🟢',
+  offline: '🔴',
+  pending: '🟡',
+  unknown: '⚪',
+
+  circle: '⭕',
+  square: '⬜',
+  triangle: '🔺',
+  star: '⭐',
+  heart: '❤️',
+
+  settings: '⚙️',
+  power: '🔌',
+  battery: '🔋',
+  wifi: '📶',
+  bluetooth: '📲',
+};
+
+export const ICON_CATEGORIES = {
+  technical: ['database', 'server', 'cloud', 'network', 'router', 'security'],
+  status: ['warning', 'error', 'success', 'info', 'online', 'offline', 'pending', 'unknown'],
+  arrows: [
+    'arrowUp',
+    'arrowDown',
+    'arrowLeft',
+    'arrowRight',
+    'arrowUpRight',
+    'arrowDownRight',
+    'arrowDownLeft',
+    'arrowUpLeft',
+  ],
+  process: ['start', 'stop', 'pause', 'play', 'process', 'gear', 'tool', 'wrench'],
+  communication: ['email', 'phone', 'message', 'notification'],
+  files: ['document', 'folder', 'file', 'pdf', 'image'],
+  users: ['user', 'users', 'team', 'admin'],
+  actions: ['add', 'remove', 'edit', 'search', 'filter', 'sort'],
+  shapes: ['circle', 'square', 'triangle', 'star', 'heart', 'diamond'],
+  system: ['settings', 'power', 'battery', 'wifi', 'bluetooth'],
+};
+
+export type IconType = keyof typeof ICON_LIBRARY;

package/src/utils/index.ts

@@ -1,5 +1,6 @@
-export * from './error.utils';
-export * from './board.utils';
-export * from './shape.utils';
-export * from './icons.utils';
-export * from './enum.utils';
+export * from './error.utils';
+export * from './board.utils';
+export * from './shape.utils';
+export * from './icons.utils';
+export * from './enum.utils';
+export * from './rcb-webhook.utils';

package/src/utils/rcb-webhook.utils.ts

@@ -0,0 +1,30 @@
+// ──────────────────────────────────────────────
+// RCB webhook signature verification (server-side helper for receivers).
+//
+// AbyssTools RCB queue signs every webhook delivery with HMAC-SHA256 of
+// the raw JSON body using the secret provided at extract time. Receivers
+// compare the X-RCB-Signature header (format `sha256=<hex>`) against the
+// same computation. Constant-time compare prevents timing attacks.
+//
+// Lazy-requires `crypto` so the SDK stays browser-compatible when this
+// utility is never invoked (browsers won't receive webhooks anyway).
+// ──────────────────────────────────────────────
+
+export interface VerifyRcbWebhookInput {
+  rawBody: string | Buffer;
+  signatureHeader: string | undefined;
+  secret: string;
+}
+
+export function verifyRcbWebhook(input: VerifyRcbWebhookInput): boolean {
+  if (!input.signatureHeader || !input.secret) return false;
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  const crypto = require('crypto');
+  const provided = input.signatureHeader.replace(/^sha256=/, '');
+  const computed: string = crypto
+    .createHmac('sha256', input.secret)
+    .update(input.rawBody)
+    .digest('hex');
+  if (provided.length !== computed.length) return false;
+  return crypto.timingSafeEqual(Buffer.from(provided, 'hex'), Buffer.from(computed, 'hex'));
+}