@ttt-productions/moderation-core 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { Likelihood, MediaModerationScores, MediaModerationResult, PerspectiveScores, TextModerationResult, PerspectiveThresholds, ModerationLogger, } from "./types.js";
+export { LIKELIHOOD_MAP, LIKELIHOOD_ORDER, likelihoodToString, isRejectionLikelihood, } from "./likelihood.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { LIKELIHOOD_MAP, LIKELIHOOD_ORDER, likelihoodToString, isRejectionLikelihood, } from "./likelihood.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/likelihood.d.ts

@@ -0,0 +1,12 @@
+import type { Likelihood } from "./types.js";
+/** Numeric enum value → string form, matching the Google APIs convention. */
+export declare const LIKELIHOOD_MAP: Record<string | number, Likelihood>;
+/** Comparison order for likelihoods (higher = more severe). */
+export declare const LIKELIHOOD_ORDER: Record<Likelihood, number>;
+export declare function likelihoodToString(value: string | number | null | undefined): Likelihood;
+/**
+ * Returns true if `value` is at or above any of the `rejectionLikelihoods`.
+ * The caller provides the set — `moderation-core` does not bake in TTT thresholds.
+ */
+export declare function isRejectionLikelihood(value: string | number | null | undefined, rejectionLikelihoods: ReadonlySet<string>): boolean;
+//# sourceMappingURL=likelihood.d.ts.map

package/dist/likelihood.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"likelihood.d.ts","sourceRoot":"","sources":["../src/likelihood.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,CAO9D,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOvD,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAMxF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,OAAO,CAGT"}

package/dist/likelihood.js

@@ -0,0 +1,35 @@
+/** Numeric enum value → string form, matching the Google APIs convention. */
+export const LIKELIHOOD_MAP = {
+    0: "UNKNOWN",
+    1: "VERY_UNLIKELY",
+    2: "UNLIKELY",
+    3: "POSSIBLE",
+    4: "LIKELY",
+    5: "VERY_LIKELY",
+};
+/** Comparison order for likelihoods (higher = more severe). */
+export const LIKELIHOOD_ORDER = {
+    UNKNOWN: 0,
+    VERY_UNLIKELY: 1,
+    UNLIKELY: 2,
+    POSSIBLE: 3,
+    LIKELY: 4,
+    VERY_LIKELY: 5,
+};
+export function likelihoodToString(value) {
+    if (value === null || value === undefined)
+        return "UNKNOWN";
+    if (typeof value === "string") {
+        return (LIKELIHOOD_MAP[value] ?? value);
+    }
+    return LIKELIHOOD_MAP[value] ?? "UNKNOWN";
+}
+/**
+ * Returns true if `value` is at or above any of the `rejectionLikelihoods`.
+ * The caller provides the set — `moderation-core` does not bake in TTT thresholds.
+ */
+export function isRejectionLikelihood(value, rejectionLikelihoods) {
+    const str = likelihoodToString(value);
+    return rejectionLikelihoods.has(str);
+}
+//# sourceMappingURL=likelihood.js.map

package/dist/likelihood.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"likelihood.js","sourceRoot":"","sources":["../src/likelihood.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAwC;IACjE,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,aAAa;CACjB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAyC;IAC1E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,cAAc,CAAC,KAAoC,CAAC,IAAK,KAAoB,CAAe,CAAC;IACvG,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAyC,EACzC,oBAAyC;IAEzC,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC"}

package/dist/server/image-moderation.d.ts

@@ -0,0 +1,20 @@
+import type { MediaModerationResult, ModerationLogger } from "../types.js";
+import type * as vision from "@google-cloud/vision";
+export interface ImageModerationOptions {
+    /** Set of likelihood strings that should cause rejection (e.g. new Set(["LIKELY","VERY_LIKELY"])). */
+    rejectionLikelihoods: ReadonlySet<string>;
+    /** Optional logger. */
+    logger?: ModerationLogger;
+    /** Lazy Vision client provider. Defaults to constructing a new ImageAnnotatorClient on first call. */
+    getClient?: () => Promise<vision.ImageAnnotatorClient>;
+}
+/**
+ * Moderate an image via Google Cloud Vision SafeSearch.
+ * Throws on system errors (quota, network, etc.); returns a result on policy decisions.
+ *
+ * @param imageSource - GCS URI ("gs://bucket/path") or HTTPS URL.
+ */
+export declare function moderateImage(imageSource: string, options: ImageModerationOptions): Promise<MediaModerationResult>;
+/** Test-only: reset memoized default client. */
+export declare function __resetDefaultVisionClient(): void;
+//# sourceMappingURL=image-moderation.d.ts.map

package/dist/server/image-moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-moderation.d.ts","sourceRoot":"","sources":["../../src/server/image-moderation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,KAAK,MAAM,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,sGAAsG;IACtG,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,uBAAuB;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;CACxD;AAUD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAkChC;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,SAEzC"}

package/dist/server/image-moderation.js

@@ -0,0 +1,50 @@
+import { isRejectionLikelihood, likelihoodToString, } from "../likelihood.js";
+let _defaultClient = null;
+async function defaultGetVisionClient() {
+    if (_defaultClient)
+        return _defaultClient;
+    const mod = await import("@google-cloud/vision");
+    _defaultClient = new mod.ImageAnnotatorClient();
+    return _defaultClient;
+}
+/**
+ * Moderate an image via Google Cloud Vision SafeSearch.
+ * Throws on system errors (quota, network, etc.); returns a result on policy decisions.
+ *
+ * @param imageSource - GCS URI ("gs://bucket/path") or HTTPS URL.
+ */
+export async function moderateImage(imageSource, options) {
+    const { rejectionLikelihoods, logger } = options;
+    const getClient = options.getClient ?? defaultGetVisionClient;
+    logger?.info?.(`[moderation-core] Image moderation: ${imageSource}`);
+    const client = await getClient();
+    const [result] = await client.safeSearchDetection(imageSource);
+    const safeSearch = result.safeSearchAnnotation;
+    if (!safeSearch) {
+        logger?.warn?.("[moderation-core] SafeSearch returned no annotation; rejecting as precaution");
+        return {
+            safe: false,
+            reason: "Content moderation check failed",
+            scores: { adult: "UNKNOWN", violence: "UNKNOWN", racy: "UNKNOWN" },
+        };
+    }
+    const scores = {
+        adult: likelihoodToString(safeSearch.adult),
+        violence: likelihoodToString(safeSearch.violence),
+        racy: likelihoodToString(safeSearch.racy),
+    };
+    const isAdult = isRejectionLikelihood(safeSearch.adult, rejectionLikelihoods);
+    const isViolent = isRejectionLikelihood(safeSearch.violence, rejectionLikelihoods);
+    const safe = !isAdult && !isViolent;
+    let reason;
+    if (isAdult)
+        reason = "Adult or sexually explicit content is not allowed";
+    else if (isViolent)
+        reason = "Violent or graphic content is not allowed";
+    return { safe, reason, scores };
+}
+/** Test-only: reset memoized default client. */
+export function __resetDefaultVisionClient() {
+    _defaultClient = null;
+}
+//# sourceMappingURL=image-moderation.js.map

package/dist/server/image-moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-moderation.js","sourceRoot":"","sources":["../../src/server/image-moderation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAkB1B,IAAI,cAAc,GAAuC,IAAI,CAAC;AAC9D,KAAK,UAAU,sBAAsB;IACnC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACjD,cAAc,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;IAChD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,OAA+B;IAE/B,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,sBAAsB,CAAC;IAE9D,MAAM,EAAE,IAAI,EAAE,CAAC,uCAAuC,WAAW,EAAE,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAE/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,CAAC,8EAA8E,CAAC,CAAC;QAC/F,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,iCAAiC;YACzC,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACnE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC;QACjD,IAAI,EAAE,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC;KAC1C,CAAC;IAEF,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,qBAAqB,CAAC,UAAU,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAEnF,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC;IACpC,IAAI,MAA0B,CAAC;IAC/B,IAAI,OAAO;QAAE,MAAM,GAAG,mDAAmD,CAAC;SACrE,IAAI,SAAS;QAAE,MAAM,GAAG,2CAA2C,CAAC;IAEzE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,0BAA0B;IACxC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,7 @@
+export { moderateImage, __resetDefaultVisionClient, } from "./image-moderation.js";
+export type { ImageModerationOptions } from "./image-moderation.js";
+export { moderateVideo, __resetDefaultVideoClient, } from "./video-moderation.js";
+export type { VideoModerationOptions } from "./video-moderation.js";
+export { moderateText, perspectiveCheck, quickWordFilter, createWordListCache, } from "./text-moderation.js";
+export type { WordListProvider, PerspectiveCheckOptions, ModerateTextOptions, } from "./text-moderation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EACL,aAAa,EACb,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,4 @@
+export { moderateImage, __resetDefaultVisionClient, } from "./image-moderation.js";
+export { moderateVideo, __resetDefaultVideoClient, } from "./video-moderation.js";
+export { moderateText, perspectiveCheck, quickWordFilter, createWordListCache, } from "./text-moderation.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/server/text-moderation.d.ts

@@ -0,0 +1,46 @@
+import type { ModerationLogger, PerspectiveThresholds, TextModerationResult } from "../types.js";
+export interface WordListProvider {
+    /** Returns the active profanity word list. May read from cache, Firestore, etc. */
+    getWords(): Promise<ReadonlySet<string>>;
+}
+/**
+ * Build a memoized word-list provider. Calls `loader` on first use and
+ * any time the cache is older than `ttlMs`.
+ */
+export declare function createWordListCache(args: {
+    loader: () => Promise<Iterable<string>>;
+    ttlMs: number;
+    logger?: ModerationLogger;
+}): WordListProvider & {
+    __reset(): void;
+};
+export declare function quickWordFilter(text: string, wordList: WordListProvider): Promise<{
+    pass: boolean;
+    flaggedWords: string[];
+}>;
+export interface PerspectiveCheckOptions {
+    apiKey: string;
+    thresholds: PerspectiveThresholds;
+    logger?: ModerationLogger;
+    /** Fetch implementation override (test-friendly). Defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+}
+export declare function perspectiveCheck(text: string, options: PerspectiveCheckOptions): Promise<TextModerationResult>;
+export interface ModerateTextOptions {
+    wordList: WordListProvider;
+    perspective: {
+        getApiKey: () => string | undefined;
+        thresholds: PerspectiveThresholds;
+        fetchImpl?: typeof fetch;
+    };
+    /** Minimum text length before any moderation runs. Default 0 (always run). */
+    minLength?: number;
+    logger?: ModerationLogger;
+}
+/**
+ * Two-layer text moderation: word filter (cheap, local) → Perspective API.
+ * Returns a generic result — the caller decides how to respond
+ * (throw HttpsError, log violation, etc.).
+ */
+export declare function moderateText(text: string, options: ModerateTextOptions): Promise<TextModerationResult>;
+//# sourceMappingURL=text-moderation.d.ts.map

package/dist/server/text-moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-moderation.d.ts","sourceRoot":"","sources":["../../src/server/text-moderation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,gBAAgB,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAmBzC;AAiBD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAYpD;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,qBAAqB,CAAC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAmE/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;QACpC,UAAU,EAAE,qBAAqB,CAAC;QAClC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;KAC1B,CAAC;IACF,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA2B/B"}

package/dist/server/text-moderation.js

@@ -0,0 +1,142 @@
+/**
+ * Build a memoized word-list provider. Calls `loader` on first use and
+ * any time the cache is older than `ttlMs`.
+ */
+export function createWordListCache(args) {
+    let cached = null;
+    let cachedAt = 0;
+    return {
+        async getWords() {
+            const now = Date.now();
+            if (cached && now - cachedAt < args.ttlMs)
+                return cached;
+            const fresh = await args.loader();
+            cached = new Set(fresh);
+            cachedAt = now;
+            args.logger?.info?.(`[moderation-core] Loaded ${cached.size} words into cache`);
+            return cached;
+        },
+        __reset() {
+            cached = null;
+            cachedAt = 0;
+        },
+    };
+}
+const LEET_SPEAK_MAP = {
+    "0": "o", "1": "i", "3": "e", "4": "a", "5": "s",
+    "7": "t", "8": "b", "@": "a", "$": "s", "!": "i", "+": "t",
+};
+function normalizeText(text) {
+    let normalized = text.toLowerCase();
+    for (const [leet, letter] of Object.entries(LEET_SPEAK_MAP)) {
+        normalized = normalized.split(leet).join(letter);
+    }
+    // Collapse 3+ repeated chars to 2 (e.g. "fuuuck" → "fuuck")
+    normalized = normalized.replace(/(.)\1{2,}/g, "$1$1");
+    return normalized;
+}
+export async function quickWordFilter(text, wordList) {
+    const words = await wordList.getWords();
+    if (words.size === 0)
+        return { pass: true, flaggedWords: [] };
+    const normalized = normalizeText(text);
+    const tokens = normalized.split(/[\s.,!?;:'"()[\]{}<>/\\|`~@#$%^&*+=_-]+/);
+    const flagged = [];
+    for (const token of tokens) {
+        const clean = token.replace(/[^a-z0-9]/gi, "");
+        if (clean.length > 1 && words.has(clean))
+            flagged.push(clean);
+    }
+    return { pass: flagged.length === 0, flaggedWords: flagged };
+}
+export async function perspectiveCheck(text, options) {
+    const { apiKey, thresholds, logger } = options;
+    const f = options.fetchImpl ?? fetch;
+    if (!apiKey) {
+        logger?.warn?.("[moderation-core] Perspective API key not provided; skipping Layer 2");
+        return { safe: true };
+    }
+    try {
+        const response = await f(`https://commentanalyzer.googleapis.com/v1alpha1/comments:analyze?key=${apiKey}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                comment: { text },
+                languages: ["en"],
+                requestedAttributes: {
+                    TOXICITY: {},
+                    SEVERE_TOXICITY: {},
+                    IDENTITY_ATTACK: {},
+                    INSULT: {},
+                    PROFANITY: {},
+                    THREAT: {},
+                },
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            logger?.error?.(`Perspective API error: ${response.status} - ${errorText}`);
+            return { safe: true };
+        }
+        const data = (await response.json());
+        const get = (k) => data.attributeScores?.[k]?.summaryScore?.value ?? 0;
+        const scores = {
+            toxicity: get("TOXICITY"),
+            severeToxicity: get("SEVERE_TOXICITY"),
+            identityAttack: get("IDENTITY_ATTACK"),
+            insult: get("INSULT"),
+            profanity: get("PROFANITY"),
+            threat: get("THREAT"),
+        };
+        if (scores.severeToxicity > thresholds.severeToxicity) {
+            return { safe: false, reason: "Content contains severe toxicity", scores, layer: "perspective" };
+        }
+        if (scores.identityAttack > thresholds.identityAttack) {
+            return { safe: false, reason: "Content contains hate speech or identity-based attacks", scores, layer: "perspective" };
+        }
+        if (scores.threat > thresholds.threat) {
+            return { safe: false, reason: "Content contains threats", scores, layer: "perspective" };
+        }
+        if (scores.toxicity > thresholds.toxicity) {
+            return { safe: false, reason: "Content is too toxic", scores, layer: "perspective" };
+        }
+        return { safe: true, scores };
+    }
+    catch (error) {
+        logger?.error?.("[moderation-core] Perspective API request failed:", error);
+        return { safe: true };
+    }
+}
+/**
+ * Two-layer text moderation: word filter (cheap, local) → Perspective API.
+ * Returns a generic result — the caller decides how to respond
+ * (throw HttpsError, log violation, etc.).
+ */
+export async function moderateText(text, options) {
+    const { wordList, perspective, minLength = 0, logger } = options;
+    if (!text || text.trim().length === 0)
+        return { safe: true };
+    if (text.trim().length < minLength)
+        return { safe: true };
+    logger?.info?.(`[moderation-core] Text moderation: ${text.length} chars`);
+    const wordCheck = await quickWordFilter(text, wordList);
+    if (!wordCheck.pass) {
+        return {
+            safe: false,
+            reason: "Content contains prohibited language",
+            flaggedWords: wordCheck.flaggedWords,
+            layer: "word_filter",
+        };
+    }
+    const apiKey = perspective.getApiKey();
+    const perspectiveResult = await perspectiveCheck(text, {
+        apiKey: apiKey ?? "",
+        thresholds: perspective.thresholds,
+        logger,
+        fetchImpl: perspective.fetchImpl,
+    });
+    if (!perspectiveResult.safe)
+        return perspectiveResult;
+    return { safe: true, scores: perspectiveResult.scores };
+}
+//# sourceMappingURL=text-moderation.js.map

package/dist/server/text-moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-moderation.js","sourceRoot":"","sources":["../../src/server/text-moderation.ts"],"names":[],"mappings":"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"}

package/dist/server/video-moderation.d.ts

@@ -0,0 +1,14 @@
+import type { MediaModerationResult, ModerationLogger } from "../types.js";
+import type { VideoIntelligenceServiceClient } from "@google-cloud/video-intelligence";
+export interface VideoModerationOptions {
+    rejectionLikelihoods: ReadonlySet<string>;
+    logger?: ModerationLogger;
+    getClient?: () => Promise<VideoIntelligenceServiceClient>;
+}
+/**
+ * Moderate a video via Google Cloud Video Intelligence.
+ * @param gcsUri - MUST be a GCS URI ("gs://bucket/path"); HTTPS URLs are not supported by the API.
+ */
+export declare function moderateVideo(gcsUri: string, options: VideoModerationOptions): Promise<MediaModerationResult>;
+export declare function __resetDefaultVideoClient(): void;
+//# sourceMappingURL=video-moderation.d.ts.map

package/dist/server/video-moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-moderation.d.ts","sourceRoot":"","sources":["../../src/server/video-moderation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAEvF,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC3D;AAUD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAgDhC;AAED,wBAAgB,yBAAyB,SAExC"}

package/dist/server/video-moderation.js

@@ -0,0 +1,57 @@
+import { isRejectionLikelihood, likelihoodToString, LIKELIHOOD_ORDER, } from "../likelihood.js";
+let _defaultClient = null;
+async function defaultGetVideoClient() {
+    if (_defaultClient)
+        return _defaultClient;
+    const mod = await import("@google-cloud/video-intelligence");
+    _defaultClient = new mod.VideoIntelligenceServiceClient();
+    return _defaultClient;
+}
+/**
+ * Moderate a video via Google Cloud Video Intelligence.
+ * @param gcsUri - MUST be a GCS URI ("gs://bucket/path"); HTTPS URLs are not supported by the API.
+ */
+export async function moderateVideo(gcsUri, options) {
+    const { rejectionLikelihoods, logger } = options;
+    const getClient = options.getClient ?? defaultGetVideoClient;
+    logger?.info?.(`[moderation-core] Video moderation: ${gcsUri}`);
+    const { protos } = await import("@google-cloud/video-intelligence");
+    const client = await getClient();
+    const [operation] = await client.annotateVideo({
+        inputUri: gcsUri,
+        features: [
+            protos.google.cloud.videointelligence.v1.Feature.EXPLICIT_CONTENT_DETECTION,
+        ],
+    });
+    const [result] = await operation.promise();
+    const annotation = result.annotationResults?.[0];
+    const explicitAnnotation = annotation?.explicitAnnotation;
+    if (!explicitAnnotation?.frames?.length) {
+        logger?.warn?.("[moderation-core] No explicit-content frames returned; allowing content");
+        return { safe: true, scores: { adult: "UNKNOWN", violence: "UNKNOWN", racy: "UNKNOWN" } };
+    }
+    let maxAdult = "VERY_UNLIKELY";
+    let foundExplicit = false;
+    for (const frame of explicitAnnotation.frames) {
+        if (isRejectionLikelihood(frame.pornographyLikelihood, rejectionLikelihoods)) {
+            maxAdult = likelihoodToString(frame.pornographyLikelihood);
+            foundExplicit = true;
+            break;
+        }
+        const current = likelihoodToString(frame.pornographyLikelihood);
+        if (LIKELIHOOD_ORDER[current] > LIKELIHOOD_ORDER[maxAdult]) {
+            maxAdult = current;
+        }
+    }
+    const safe = !foundExplicit;
+    const reason = safe ? undefined : "Adult or sexually explicit content is not allowed";
+    return {
+        safe,
+        reason,
+        scores: { adult: maxAdult, violence: "NOT_CHECKED", racy: "NOT_CHECKED" },
+    };
+}
+export function __resetDefaultVideoClient() {
+    _defaultClient = null;
+}
+//# sourceMappingURL=video-moderation.js.map

package/dist/server/video-moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-moderation.js","sourceRoot":"","sources":["../../src/server/video-moderation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAe1B,IAAI,cAAc,GAA0C,IAAI,CAAC;AACjE,KAAK,UAAU,qBAAqB;IAClC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;IAC7D,cAAc,GAAG,IAAI,GAAG,CAAC,8BAA8B,EAAE,CAAC;IAC1D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,OAA+B;IAE/B,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,qBAAqB,CAAC;IAE7D,MAAM,EAAE,IAAI,EAAE,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;IAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IAEjC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;QAC7C,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE;YACR,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,CAAC,0BAA0B;SAC5E;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,kBAAkB,GAAG,UAAU,EAAE,kBAAkB,CAAC;IAE1D,IAAI,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACxC,MAAM,EAAE,IAAI,EAAE,CAAC,yEAAyE,CAAC,CAAC;QAC1F,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,QAAQ,GAAe,eAAe,CAAC;IAC3C,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,qBAAqB,CAAC,KAAK,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,EAAE,CAAC;YAC7E,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC3D,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAChE,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,QAAQ,GAAG,OAAO,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mDAAmD,CAAC;IAEtF,OAAO;QACL,IAAI;QACJ,MAAM;QACN,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+/** Google-style likelihood enum (string form). */
+export type Likelihood = "UNKNOWN" | "VERY_UNLIKELY" | "UNLIKELY" | "POSSIBLE" | "LIKELY" | "VERY_LIKELY";
+export interface MediaModerationScores {
+    adult: string;
+    violence: string;
+    racy: string;
+}
+export interface MediaModerationResult {
+    safe: boolean;
+    reason?: string;
+    scores: MediaModerationScores;
+}
+export interface PerspectiveScores {
+    toxicity: number;
+    severeToxicity: number;
+    identityAttack: number;
+    insult: number;
+    profanity: number;
+    threat: number;
+}
+export interface TextModerationResult {
+    safe: boolean;
+    reason?: string;
+    flaggedWords?: string[];
+    scores?: PerspectiveScores;
+    layer?: "word_filter" | "perspective";
+}
+export interface PerspectiveThresholds {
+    toxicity: number;
+    severeToxicity: number;
+    identityAttack: number;
+    insult: number;
+    profanity: number;
+    threat: number;
+}
+/** Generic logger used for diagnostic output. Consumers wire to their own. */
+export interface ModerationLogger {
+    info?: (message: string, ...args: unknown[]) => void;
+    warn?: (message: string, ...args: unknown[]) => void;
+    error?: (message: string, ...args: unknown[]) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,eAAe,GACf,UAAU,GACV,UAAU,GACV,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACvD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+    "name": "@ttt-productions/moderation-core",
+    "version": "0.2.0",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ttt-productions/ttt-packages.git",
+        "directory": "packages/moderation-core"
+    },
+    "type": "module",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "sideEffects": false,
+    "files": [
+        "dist"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./server": {
+            "types": "./dist/server/index.d.ts",
+            "default": "./dist/server/index.js"
+        }
+    },
+    "scripts": {
+        "build": "tsc",
+        "clean": "rm -rf dist *.tsbuildinfo",
+        "typecheck": "tsc --noEmit",
+        "prepublishOnly": "npm run clean && npm run build"
+    },
+    "peerDependencies": {
+        "@google-cloud/vision": ">=4.0.0",
+        "@google-cloud/video-intelligence": ">=5.0.0"
+    },
+    "peerDependenciesMeta": {
+        "@google-cloud/vision": {
+            "optional": true
+        },
+        "@google-cloud/video-intelligence": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@google-cloud/vision": "^4.0.0",
+        "@google-cloud/video-intelligence": "^5.0.0",
+        "typescript": "^5.8.3"
+    },
+    "engines": {
+        "node": ">=22",
+        "npm": ">=10"
+    },
+    "author": "DJ (TTT Productions)",
+    "license": "MIT"
+}