@sideid/id-profanity-filter 1.1.0 → 1.9.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sideid/id-profanity-filter",
-  "version": "1.1.0",
+  "version": "1.9.4",
   "description": "Library filter kata kotor dalam Bahasa Indonesia",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",

package/src/config/options.ts

@@ -0,0 +1,178 @@
+import { FilterOptions, ProfanityCategory, Region } from "../types";
+
+export const DEFAULT_OPTIONS: FilterOptions = {
+  replaceWith: "*",
+  fullWordCensor: true,
+  detectLeetSpeak: true,
+  checkSubstring: false,
+  whitelist: [],
+  severityThreshold: 0,
+};
+
+export const FILTER_PRESETS = {
+  strict: {
+    ...DEFAULT_OPTIONS,
+    checkSubstring: true,
+    detectLeetSpeak: true,
+    severityThreshold: 0,
+  },
+
+  moderate: {
+    ...DEFAULT_OPTIONS,
+    severityThreshold: 0.5,
+  },
+
+  light: {
+    ...DEFAULT_OPTIONS,
+    severityThreshold: 0.7,
+    categories: ["sexual", "slur", "blasphemy"] as ProfanityCategory[],
+  },
+
+  childSafe: {
+    ...DEFAULT_OPTIONS,
+    checkSubstring: true,
+    detectLeetSpeak: true,
+    fullWordCensor: true,
+    severityThreshold: 0,
+  },
+};
+
+export const CATEGORY_PRESETS = {
+  sexual: {
+    ...DEFAULT_OPTIONS,
+    categories: ["sexual"] as ProfanityCategory[],
+  },
+
+  insults: {
+    ...DEFAULT_OPTIONS,
+    categories: ["insult"] as ProfanityCategory[],
+  },
+
+  profanity: {
+    ...DEFAULT_OPTIONS,
+    categories: ["profanity"] as ProfanityCategory[],
+  },
+};
+
+export const REGION_PRESETS = {
+  general: {
+    ...DEFAULT_OPTIONS,
+    regions: ["general"] as Region[],
+  },
+
+  jawa: {
+    ...DEFAULT_OPTIONS,
+    regions: ["jawa"] as Region[],
+  },
+
+  sunda: {
+    ...DEFAULT_OPTIONS,
+    regions: ["sunda"] as Region[],
+  },
+
+  betawi: {
+    ...DEFAULT_OPTIONS,
+    regions: ["betawi"] as Region[],
+  },
+
+  batak: {
+    ...DEFAULT_OPTIONS,
+    regions: ["batak"] as Region[],
+  },
+};
+
+export const REPLACEMENT_CHARS = {
+  asterisk: "*",
+  hash: "#",
+  dollar: "$",
+  at: "@",
+  percent: "%",
+  underscore: "_",
+  dash: "-",
+  dot: ".",
+  grawlix: "#@$%&!",
+};
+
+/**
+ * Membuat opsi custom dengan menggabungkan dengan default
+ *
+ * @param options Opsi yang akan digabungkan dengan default
+ * @returns Opsi yang sudah digabungkan
+ */
+export function createOptions(
+  options: Partial<FilterOptions> = {},
+): FilterOptions {
+  return {
+    ...DEFAULT_OPTIONS,
+    ...options,
+  };
+}
+
+/**
+ * Mendapatkan opsi dari preset yang ada
+ *
+ * @param presetName Nama preset filter, kategori, atau region
+ * @param additionalOptions Opsi tambahan untuk mengganti preset
+ * @returns Opsi yang sudah digabungkan
+ */
+export function getPresetOptions(
+  presetName: string,
+  additionalOptions: Partial<FilterOptions> = {},
+): FilterOptions {
+  let presetOptions: FilterOptions;
+
+  if (presetName in FILTER_PRESETS) {
+    presetOptions = FILTER_PRESETS[presetName as keyof typeof FILTER_PRESETS];
+  } else if (presetName in CATEGORY_PRESETS) {
+    presetOptions =
+      CATEGORY_PRESETS[presetName as keyof typeof CATEGORY_PRESETS];
+  } else if (presetName in REGION_PRESETS) {
+    presetOptions = REGION_PRESETS[presetName as keyof typeof REGION_PRESETS];
+  } else {
+    presetOptions = FILTER_PRESETS.strict;
+  }
+
+  return {
+    ...presetOptions,
+    ...additionalOptions,
+  };
+}
+
+/**
+ * Mendapatkan karakter pengganti
+ *
+ * @param type Tipe karakter pengganti
+ * @returns Karakter pengganti
+ */
+export function getReplacementChar(
+  type: keyof typeof REPLACEMENT_CHARS = "asterisk",
+): string {
+  return REPLACEMENT_CHARS[type] || REPLACEMENT_CHARS.asterisk;
+}
+
+/**
+ * Membuat karakter pengganti random dari grawlix
+ *
+ * @returns Karakter pengganti random
+ */
+export function getRandomGrawlix(): string {
+  const grawlix = REPLACEMENT_CHARS.grawlix;
+  return grawlix[Math.floor(Math.random() * grawlix.length)];
+}
+
+/**
+ * Membuat string pengganti untuk kata menggunakan grawlix random
+ *
+ * @param length Panjang string
+ * @returns String pengganti
+ */
+export function makeRandomGrawlixString(length: number): string {
+  let result = "";
+  const grawlix = REPLACEMENT_CHARS.grawlix;
+
+  for (let i = 0; i < length; i++) {
+    result += grawlix[Math.floor(Math.random() * grawlix.length)];
+  }
+
+  return result;
+}

package/src/constants/categories/index.ts

@@ -1,31 +1,31 @@
-// import { sexual } from './sexual';
-// import { insult } from './insult';
-// import { profanity } from './profanity';
-// import { slur } from './slur';
-// import { drugs } from './drugs';
-// import { disgusting } from './disgusting';
-// import { blasphemy } from './blasphemy';
-
-// export const categories = {
-//   sexual, // Kata-kata berbau seksual
-//   insult, // Kata-kata penghinaan
-//   profanity, // Umpatan umum
-//   slur, // Perkataan merendahkan berdasarkan identitas
-//   drugs, // Terkait narkoba
-//   disgusting, // Kata-kata menjijikkan
-//   blasphemy, // Penistaan agama
-// };
-
-// export { sexual, insult, profanity, slur, drugs, disgusting, blasphemy };
-
-// export const allCategoryWords = [
-//   ...sexual,
-//   ...insult,
-//   ...profanity,
-//   ...slur,
-//   ...drugs,
-//   ...disgusting,
-//   ...blasphemy,
-// ];
-
-// export default allCategoryWords;
+// import { sexual } from './sexual';
+// import { insult } from './insult';
+// import { profanity } from './profanity';
+// import { slur } from './slur';
+// import { drugs } from './drugs';
+// import { disgusting } from './disgusting';
+// import { blasphemy } from './blasphemy';
+
+// export const categories = {
+//   sexual, // Kata-kata berbau seksual
+//   insult, // Kata-kata penghinaan
+//   profanity, // Umpatan umum
+//   slur, // Perkataan merendahkan berdasarkan identitas
+//   drugs, // Terkait narkoba
+//   disgusting, // Kata-kata menjijikkan
+//   blasphemy, // Penistaan agama
+// };
+
+// export { sexual, insult, profanity, slur, drugs, disgusting, blasphemy };
+
+// export const allCategoryWords = [
+//   ...sexual,
+//   ...insult,
+//   ...profanity,
+//   ...slur,
+//   ...drugs,
+//   ...disgusting,
+//   ...blasphemy,
+// ];
+
+// export default allCategoryWords;

package/src/constants/categories/insult.ts

@@ -1,114 +1,114 @@
-import { ProfanityWord } from '../../types';
-import { general } from '../regions/general';
-import { jawa } from '../regions/jawa';
-import { sunda } from '../regions/sunda';
-import { betawi } from '../regions/betawi';
-
-export const insult: ProfanityWord[] = [
-  ...general.filter((word) => word.category === 'insult'),
-  ...jawa.filter((word) => word.category === 'insult'),
-  ...sunda.filter((word) => word.category === 'insult'),
-  ...betawi.filter((word) => word.category === 'insult'),
-
-  {
-    word: 'idiot',
-    category: 'insult',
-    region: 'general',
-    severity: 0.6,
-    aliases: ['idi0t', 'idot'],
-    description: 'Kata yang mengacu pada kebodohan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap sangat tidak pintar',
-  },
-  {
-    word: 'dungu',
-    category: 'insult',
-    region: 'general',
-    severity: 0.5,
-    aliases: ['dngu', 'dongu'],
-    description: 'Kata yang mengacu pada kebodohan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap tidak pintar',
-  },
-  {
-    word: 'sinting',
-    category: 'insult',
-    region: 'general',
-    severity: 0.6,
-    aliases: ['sintng', 'senteng'],
-    description:
-      'Kata yang mengacu pada kegilaan atau ketidakwarasan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap gila atau tidak waras',
-  },
-  {
-    word: 'sarap',
-    category: 'insult',
-    region: 'general',
-    severity: 0.6,
-    aliases: ['saraf', 'srap'],
-    description:
-      'Kata yang mengacu pada kegilaan atau ketidakwarasan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap gila atau tidak waras',
-  },
-  {
-    word: 'geblek',
-    category: 'insult',
-    region: 'general',
-    severity: 0.5,
-    aliases: ['gblk', 'geblk'],
-    description: 'Kata yang mengacu pada kebodohan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap tidak pintar',
-  },
-  {
-    word: 'kampungan',
-    category: 'insult',
-    region: 'general',
-    severity: 0.5,
-    aliases: ['kmpngn', 'kamphungan'],
-    description:
-      'Kata yang mengacu pada ketidaksopanan atau kenaifan seseorang',
-    context:
-      'Hinaan untuk menyebut orang yang dianggap tidak modern atau primitif',
-  },
-  {
-    word: 'udik',
-    category: 'insult',
-    region: 'general',
-    severity: 0.5,
-    aliases: ['udhik', 'udek'],
-    description:
-      'Kata yang mengacu pada ketidaksopanan atau kenaifan seseorang',
-    context:
-      'Hinaan untuk menyebut orang yang dianggap tidak modern atau primitif',
-  },
-  {
-    word: 'dongo',
-    category: 'insult',
-    region: 'general',
-    severity: 0.5,
-    aliases: ['donggo', 'dungu'],
-    description: 'Kata yang mengacu pada kebodohan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap tidak pintar',
-  },
-  {
-    word: 'tolol',
-    category: 'insult',
-    region: 'general',
-    severity: 0.6,
-    aliases: ['tol0l', 'tollo', 'tlol'],
-    description: 'Kata yang mengacu pada kebodohan seseorang',
-    context: 'Hinaan untuk menyebut orang yang dianggap tidak pintar',
-  },
-  {
-    word: 'brengsek',
-    category: 'insult',
-    region: 'general',
-    severity: 0.7,
-    aliases: ['brengskek', 'brengsik', 'brengzek'],
-    description: 'Kata yang mengacu pada kelakuan buruk atau tidak bermoral',
-    context:
-      'Hinaan untuk menyebut orang yang dianggap memiliki kelakuan buruk',
-  },
-];
-
-export const insultWords = insult.map((item) => item.word);
-
-export default insult;
+import { ProfanityWord } from "../../types";
+import { general } from "../regions/general";
+import { jawa } from "../regions/jawa";
+import { sunda } from "../regions/sunda";
+import { betawi } from "../regions/betawi";
+
+export const insult: ProfanityWord[] = [
+  ...general.filter((word) => word.category === "insult"),
+  ...jawa.filter((word) => word.category === "insult"),
+  ...sunda.filter((word) => word.category === "insult"),
+  ...betawi.filter((word) => word.category === "insult"),
+
+  {
+    word: "idiot",
+    category: "insult",
+    region: "general",
+    severity: 0.6,
+    aliases: ["idi0t", "idot"],
+    description: "Kata yang mengacu pada kebodohan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap sangat tidak pintar",
+  },
+  {
+    word: "dungu",
+    category: "insult",
+    region: "general",
+    severity: 0.5,
+    aliases: ["dngu", "dongu"],
+    description: "Kata yang mengacu pada kebodohan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap tidak pintar",
+  },
+  {
+    word: "sinting",
+    category: "insult",
+    region: "general",
+    severity: 0.6,
+    aliases: ["sintng", "senteng"],
+    description:
+      "Kata yang mengacu pada kegilaan atau ketidakwarasan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap gila atau tidak waras",
+  },
+  {
+    word: "sarap",
+    category: "insult",
+    region: "general",
+    severity: 0.6,
+    aliases: ["saraf", "srap"],
+    description:
+      "Kata yang mengacu pada kegilaan atau ketidakwarasan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap gila atau tidak waras",
+  },
+  {
+    word: "geblek",
+    category: "insult",
+    region: "general",
+    severity: 0.5,
+    aliases: ["gblk", "geblk"],
+    description: "Kata yang mengacu pada kebodohan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap tidak pintar",
+  },
+  {
+    word: "kampungan",
+    category: "insult",
+    region: "general",
+    severity: 0.5,
+    aliases: ["kmpngn", "kamphungan"],
+    description:
+      "Kata yang mengacu pada ketidaksopanan atau kenaifan seseorang",
+    context:
+      "Hinaan untuk menyebut orang yang dianggap tidak modern atau primitif",
+  },
+  {
+    word: "udik",
+    category: "insult",
+    region: "general",
+    severity: 0.5,
+    aliases: ["udhik", "udek"],
+    description:
+      "Kata yang mengacu pada ketidaksopanan atau kenaifan seseorang",
+    context:
+      "Hinaan untuk menyebut orang yang dianggap tidak modern atau primitif",
+  },
+  {
+    word: "dongo",
+    category: "insult",
+    region: "general",
+    severity: 0.5,
+    aliases: ["donggo", "dungu"],
+    description: "Kata yang mengacu pada kebodohan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap tidak pintar",
+  },
+  {
+    word: "tolol",
+    category: "insult",
+    region: "general",
+    severity: 0.6,
+    aliases: ["tol0l", "tollo", "tlol"],
+    description: "Kata yang mengacu pada kebodohan seseorang",
+    context: "Hinaan untuk menyebut orang yang dianggap tidak pintar",
+  },
+  {
+    word: "brengsek",
+    category: "insult",
+    region: "general",
+    severity: 0.7,
+    aliases: ["brengskek", "brengsik", "brengzek"],
+    description: "Kata yang mengacu pada kelakuan buruk atau tidak bermoral",
+    context:
+      "Hinaan untuk menyebut orang yang dianggap memiliki kelakuan buruk",
+  },
+];
+
+export const insultWords = insult.map((item) => item.word);
+
+export default insult;