@bereasoftware/time-guard 2.6.1 → 2.7.0

package/dist/plugins/relative-time.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"relative-time.cjs","names":[],"sources":["../../src/plugins/relative-time/index.ts"],"sourcesContent":["/**\n * TimeGuard Relative Time Plugin\n * Adds human-readable time differences (e.g., \"2 hours ago\", \"in 3 days\")\n * Follows SOLID principles and Temporal API standards\n */\n\nimport type { ITimeGuardPlugin } from '../../types';\nimport type { TimeGuard } from '../../index';\nimport type {\n  RelativeTimeConfig,\n  RelativeTimeFormats,\n  RelativeTimeThreshold,\n} from './types';\n\nconst DEFAULT_THRESHOLDS: RelativeTimeThreshold[] = [\n  { l: 's', r: 44, d: 'second' },\n  { l: 'm', r: 89 },\n  { l: 'mm', r: 44, d: 'minute' },\n  { l: 'h', r: 89 },\n  { l: 'hh', r: 21, d: 'hour' },\n  { l: 'd', r: 35 },\n  { l: 'dd', r: 25, d: 'day' },\n  { l: 'M', r: 45 },\n  { l: 'MM', r: 10, d: 'month' },\n  { l: 'y', r: 17 },\n  { l: 'yy', d: 'year' },\n];\n\nconst DEFAULT_FORMATS: RelativeTimeFormats = {\n  future: 'in %s',\n  past: '%s ago',\n  s: 'a few seconds',\n  m: 'a minute',\n  mm: '%d minutes',\n  h: 'an hour',\n  hh: '%d hours',\n  d: 'a day',\n  dd: '%d days',\n  M: 'a month',\n  MM: '%d months',\n  y: 'a year',\n  yy: '%d years',\n};\n\nexport class RelativeTimePlugin implements ITimeGuardPlugin {\n  name = 'relative-time';\n  version = '1.0.0';\n\n  private config: RelativeTimeConfig;\n  private formats: RelativeTimeFormats;\n\n  constructor(config?: RelativeTimeConfig) {\n    this.config = {\n      thresholds: config?.thresholds || DEFAULT_THRESHOLDS,\n      rounding: config?.rounding || Math.round,\n    };\n    this.formats = DEFAULT_FORMATS;\n  }\n\n  /**\n   * Install plugin into TimeGuard\n   */\n  install(TimeGuardClass: typeof TimeGuard): void {\n    const plugin = this;\n\n    /**\n     * Get relative time string (e.g., \"2 hours ago\")\n     */\n    (\n      TimeGuardClass.prototype as unknown as {\n        fromNow: (withoutSuffix?: boolean) => string;\n      }\n    ).fromNow = function (withoutSuffix?: boolean): string {\n      return plugin.formatRelativeTime(\n        this as unknown as TimeGuard,\n        false,\n        withoutSuffix,\n      );\n    };\n\n    (\n      TimeGuardClass.prototype as unknown as {\n        toNow: (withoutSuffix?: boolean) => string;\n      }\n    ).toNow = function (withoutSuffix?: boolean): string {\n      return plugin.formatRelativeTime(\n        this as unknown as TimeGuard,\n        true,\n        withoutSuffix,\n      );\n    };\n\n    (\n      TimeGuardClass.prototype as unknown as {\n        humanize: (other?: TimeGuard, withoutSuffix?: boolean) => string;\n      }\n    ).humanize = function (other?: TimeGuard, withoutSuffix?: boolean): string {\n      if (other) {\n        return plugin.formatRelativeTime(\n          this as unknown as TimeGuard,\n          other.isAfter(this as unknown as TimeGuard),\n          withoutSuffix,\n        );\n      }\n      return plugin.formatRelativeTime(\n        this as unknown as TimeGuard,\n        false,\n        withoutSuffix,\n      );\n    };\n  }\n\n  /**\n   * Format relative time\n   */\n  private formatRelativeTime(\n    date: TimeGuard,\n    isFuture: boolean,\n    withoutSuffix?: boolean,\n  ): string {\n    const now = (date.constructor as typeof TimeGuard).now();\n    const diff = now.diff(date, 'millisecond');\n    const absDiff = Math.abs(diff);\n    const isFromNow = diff > 0;\n    const actualIsFuture = isFuture ?? !isFromNow;\n\n    const result = this.getRelativeTimeString(absDiff);\n\n    if (withoutSuffix) {\n      return result;\n    }\n\n    const suffix = actualIsFuture ? this.formats.future : this.formats.past;\n    return suffix.replace('%s', result);\n  }\n\n  /**\n   * Get relative time string based on milliseconds\n   */\n  private getRelativeTimeString(milliseconds: number): string {\n    const thresholds = this.config.thresholds || DEFAULT_THRESHOLDS;\n    const rounding = this.config.rounding || Math.round;\n\n    for (let i = 0; i < thresholds.length; i++) {\n      const threshold = thresholds[i];\n      const nextThreshold =\n        i + 1 < thresholds.length ? thresholds[i + 1] : null;\n\n      // Skip if we haven't reached this threshold\n      if (nextThreshold && threshold.r && milliseconds < threshold.r * 1000) {\n        continue;\n      }\n\n      // Convert to appropriate unit\n      let value: number;\n      if (threshold.d) {\n        const unitMs = this.getUnitMilliseconds(threshold.d);\n        value = rounding(milliseconds / unitMs);\n      } else {\n        value = 1;\n      }\n\n      const label = threshold.l;\n      const format = this.formats[label as keyof typeof this.formats] || label;\n\n      if (typeof format === 'string') {\n        return format.includes('%d')\n          ? format.replace('%d', String(value))\n          : format;\n      }\n\n      return format;\n    }\n\n    // Fallback\n    return `${rounding(milliseconds / 1000)} seconds`;\n  }\n\n  /**\n   * Get milliseconds per unit\n   */\n  private getUnitMilliseconds(unit: string): number {\n    const msMap: Record<string, number> = {\n      second: 1000,\n      minute: 1000 * 60,\n      hour: 1000 * 60 * 60,\n      day: 1000 * 60 * 60 * 24,\n      month: 1000 * 60 * 60 * 24 * 30,\n      year: 1000 * 60 * 60 * 24 * 365,\n    };\n    return msMap[unit] || 1;\n  }\n\n  /**\n   * Set format strings\n   */\n  setFormats(formats: Partial<RelativeTimeFormats>): void {\n    Object.assign(this.formats, formats);\n  }\n\n  /**\n   * Get current formats\n   */\n  getFormats(): RelativeTimeFormats {\n    return { ...this.formats };\n  }\n}\n\n/**\n * Create and export default instance\n */\nexport default new RelativeTimePlugin();\n"],"mappings":"+FAcA,IAAM,EAA8C,CAClD,CAAE,EAAG,IAAK,EAAG,GAAI,EAAG,QAAS,EAC7B,CAAE,EAAG,IAAK,EAAG,EAAG,EAChB,CAAE,EAAG,KAAM,EAAG,GAAI,EAAG,QAAS,EAC9B,CAAE,EAAG,IAAK,EAAG,EAAG,EAChB,CAAE,EAAG,KAAM,EAAG,GAAI,EAAG,MAAO,EAC5B,CAAE,EAAG,IAAK,EAAG,EAAG,EAChB,CAAE,EAAG,KAAM,EAAG,GAAI,EAAG,KAAM,EAC3B,CAAE,EAAG,IAAK,EAAG,EAAG,EAChB,CAAE,EAAG,KAAM,EAAG,GAAI,EAAG,OAAQ,EAC7B,CAAE,EAAG,IAAK,EAAG,EAAG,EAChB,CAAE,EAAG,KAAM,EAAG,MAAO,CACvB,EAEM,EAAuC,CAC3C,OAAQ,QACR,KAAM,SACN,EAAG,gBACH,EAAG,WACH,GAAI,aACJ,EAAG,UACH,GAAI,WACJ,EAAG,QACH,GAAI,UACJ,EAAG,UACH,GAAI,YACJ,EAAG,SACH,GAAI,UACN,EAEa,EAAb,KAA4D,CAC1D,KAAO,gBACP,QAAU,QAEV,OACA,QAEA,YAAY,EAA6B,CACvC,KAAK,OAAS,CACZ,WAAY,GAAQ,YAAc,EAClC,SAAU,GAAQ,UAAY,KAAK,KACrC,EACA,KAAK,QAAU,CACjB,CAKA,QAAQ,EAAwC,CAC9C,IAAM,EAAS,KAKf,EACiB,UAGf,QAAU,SAAU,EAAiC,CACrD,OAAO,EAAO,mBACZ,KACA,GACA,CACF,CACF,EAEA,EACiB,UAGf,MAAQ,SAAU,EAAiC,CACnD,OAAO,EAAO,mBACZ,KACA,GACA,CACF,CACF,EAEA,EACiB,UAGf,SAAW,SAAU,EAAmB,EAAiC,CAQzE,OAPI,EACK,EAAO,mBACZ,KACA,EAAM,QAAQ,IAA4B,EAC1C,CACF,EAEK,EAAO,mBACZ,KACA,GACA,CACF,CACF,CACF,CAKA,mBACE,EACA,EACA,EACQ,CAER,IAAM,EADO,EAAK,YAAiC,IACtC,EAAI,KAAK,EAAM,aAAa,EACnC,EAAU,KAAK,IAAI,CAAI,EAEvB,EAAiB,GAAY,EADjB,EAAO,GAGnB,EAAS,KAAK,sBAAsB,CAAO,EAOjD,OALI,EACK,GAGM,EAAiB,KAAK,QAAQ,OAAS,KAAK,QAAQ,MACrD,QAAQ,KAAM,CAAM,CACpC,CAKA,sBAA8B,EAA8B,CAC1D,IAAM,EAAa,KAAK,OAAO,YAAc,EACvC,EAAW,KAAK,OAAO,UAAY,KAAK,MAE9C,IAAK,IAAI,EAAI,EAAG,EAAI,EAAW,OAAQ,IAAK,CAC1C,IAAM,EAAY,EAAW,GAK7B,GAHE,EAAI,EAAI,EAAW,QAAS,EAAW,EAAI,IAGxB,EAAU,GAAK,EAAe,EAAU,EAAI,IAC/D,SAIF,IAAI,EACJ,AAIE,EAJE,EAAU,EAEJ,EAAS,EADF,KAAK,oBAAoB,EAAU,CAClB,CAAM,EAE9B,EAGV,IAAM,EAAQ,EAAU,EAClB,EAAS,KAAK,QAAQ,IAAuC,EAQnE,OANI,OAAO,GAAW,UACb,EAAO,SAAS,IAAI,EACvB,EAAO,QAAQ,KAAM,OAAO,CAAK,CAAC,EAClC,CAIR,CAGA,MAAO,GAAG,EAAS,EAAe,GAAI,EAAE,SAC1C,CAKA,oBAA4B,EAAsB,CAShD,MAAO,CAPL,OAAQ,IACR,OAAQ,IAAO,GACf,KAAM,IAAO,GAAK,GAClB,IAAK,IAAO,GAAK,GAAK,GACtB,MAAO,IAAO,GAAK,GAAK,GAAK,GAC7B,KAAM,IAAO,GAAK,GAAK,GAAK,GAEvB,EAAM,IAAS,CACxB,CAKA,WAAW,EAA6C,CACtD,OAAO,OAAO,KAAK,QAAS,CAAO,CACrC,CAKA,YAAkC,CAChC,MAAO,CAAE,GAAG,KAAK,OAAQ,CAC3B,CACF,EAKA,EAAe,IAAI"}

package/dist/plugins/relative-time.es.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"relative-time.es.js","names":[],"sources":["../../src/plugins/relative-time/index.ts"],"sourcesContent":["/**\n * TimeGuard Relative Time Plugin\n * Adds human-readable time differences (e.g., \"2 hours ago\", \"in 3 days\")\n * Follows SOLID principles and Temporal API standards\n */\n\nimport type { ITimeGuardPlugin } from '../../types';\nimport type { TimeGuard } from '../../index';\nimport type {\n  RelativeTimeConfig,\n  RelativeTimeFormats,\n  RelativeTimeThreshold,\n} from './types';\n\nconst DEFAULT_THRESHOLDS: RelativeTimeThreshold[] = [\n  { l: 's', r: 44, d: 'second' },\n  { l: 'm', r: 89 },\n  { l: 'mm', r: 44, d: 'minute' },\n  { l: 'h', r: 89 },\n  { l: 'hh', r: 21, d: 'hour' },\n  { l: 'd', r: 35 },\n  { l: 'dd', r: 25, d: 'day' },\n  { l: 'M', r: 45 },\n  { l: 'MM', r: 10, d: 'month' },\n  { l: 'y', r: 17 },\n  { l: 'yy', d: 'year' },\n];\n\nconst DEFAULT_FORMATS: RelativeTimeFormats = {\n  future: 'in %s',\n  past: '%s ago',\n  s: 'a few seconds',\n  m: 'a minute',\n  mm: '%d minutes',\n  h: 'an hour',\n  hh: '%d hours',\n  d: 'a day',\n  dd: '%d days',\n  M: 'a month',\n  MM: '%d months',\n  y: 'a year',\n  yy: '%d years',\n};\n\nexport class RelativeTimePlugin implements ITimeGuardPlugin {\n  name = 'relative-time';\n  version = '1.0.0';\n\n  private config: RelativeTimeConfig;\n  private formats: RelativeTimeFormats;\n\n  constructor(config?: RelativeTimeConfig) {\n    this.config = {\n      thresholds: config?.thresholds || DEFAULT_THRESHOLDS,\n      rounding: config?.rounding || Math.round,\n    };\n    this.formats = DEFAULT_FORMATS;\n  }\n\n  /**\n   * Install plugin into TimeGuard\n   */\n  install(TimeGuardClass: typeof TimeGuard): void {\n    const plugin = this;\n\n    /**\n     * Get relative time string (e.g., \"2 hours ago\")\n     */\n    (\n      TimeGuardClass.prototype as unknown as {\n        fromNow: (withoutSuffix?: boolean) => string;\n      }\n    ).fromNow = function (withoutSuffix?: boolean): string {\n      return plugin.formatRelativeTime(\n        this as unknown as TimeGuard,\n        false,\n        withoutSuffix,\n      );\n    };\n\n    (\n      TimeGuardClass.prototype as unknown as {\n        toNow: (withoutSuffix?: boolean) => string;\n      }\n    ).toNow = function (withoutSuffix?: boolean): string {\n      return plugin.formatRelativeTime(\n        this as unknown as TimeGuard,\n        true,\n        withoutSuffix,\n      );\n    };\n\n    (\n      TimeGuardClass.prototype as unknown as {\n        humanize: (other?: TimeGuard, withoutSuffix?: boolean) => string;\n      }\n    ).humanize = function (other?: TimeGuard, withoutSuffix?: boolean): string {\n      if (other) {\n        return plugin.formatRelativeTime(\n          this as unknown as TimeGuard,\n          other.isAfter(this as unknown as TimeGuard),\n          withoutSuffix,\n        );\n      }\n      return plugin.formatRelativeTime(\n        this as unknown as TimeGuard,\n        false,\n        withoutSuffix,\n      );\n    };\n  }\n\n  /**\n   * Format relative time\n   */\n  private formatRelativeTime(\n    date: TimeGuard,\n    isFuture: boolean,\n    withoutSuffix?: boolean,\n  ): string {\n    const now = (date.constructor as typeof TimeGuard).now();\n    const diff = now.diff(date, 'millisecond');\n    const absDiff = Math.abs(diff);\n    const isFromNow = diff > 0;\n    const actualIsFuture = isFuture ?? !isFromNow;\n\n    const result = this.getRelativeTimeString(absDiff);\n\n    if (withoutSuffix) {\n      return result;\n    }\n\n    const suffix = actualIsFuture ? this.formats.future : this.formats.past;\n    return suffix.replace('%s', result);\n  }\n\n  /**\n   * Get relative time string based on milliseconds\n   */\n  private getRelativeTimeString(milliseconds: number): string {\n    const thresholds = this.config.thresholds || DEFAULT_THRESHOLDS;\n    const rounding = this.config.rounding || Math.round;\n\n    for (let i = 0; i < thresholds.length; i++) {\n      const threshold = thresholds[i];\n      const nextThreshold =\n        i + 1 < thresholds.length ? thresholds[i + 1] : null;\n\n      // Skip if we haven't reached this threshold\n      if (nextThreshold && threshold.r && milliseconds < threshold.r * 1000) {\n        continue;\n      }\n\n      // Convert to appropriate unit\n      let value: number;\n      if (threshold.d) {\n        const unitMs = this.getUnitMilliseconds(threshold.d);\n        value = rounding(milliseconds / unitMs);\n      } else {\n        value = 1;\n      }\n\n      const label = threshold.l;\n      const format = this.formats[label as keyof typeof this.formats] || label;\n\n      if (typeof format === 'string') {\n        return format.includes('%d')\n          ? format.replace('%d', String(value))\n          : format;\n      }\n\n      return format;\n    }\n\n    // Fallback\n    return `${rounding(milliseconds / 1000)} seconds`;\n  }\n\n  /**\n   * Get milliseconds per unit\n   */\n  private getUnitMilliseconds(unit: string): number {\n    const msMap: Record<string, number> = {\n      second: 1000,\n      minute: 1000 * 60,\n      hour: 1000 * 60 * 60,\n      day: 1000 * 60 * 60 * 24,\n      month: 1000 * 60 * 60 * 24 * 30,\n      year: 1000 * 60 * 60 * 24 * 365,\n    };\n    return msMap[unit] || 1;\n  }\n\n  /**\n   * Set format strings\n   */\n  setFormats(formats: Partial<RelativeTimeFormats>): void {\n    Object.assign(this.formats, formats);\n  }\n\n  /**\n   * Get current formats\n   */\n  getFormats(): RelativeTimeFormats {\n    return { ...this.formats };\n  }\n}\n\n/**\n * Create and export default instance\n */\nexport default new RelativeTimePlugin();\n"],"mappings":"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"}