content-moderation-sdk 0.0.1 → 0.1.1

package/dist/utils.js

@@ -0,0 +1,229 @@
+import { ModerationAbortError, ModerationAdapterError, ModerationSdkError, ModerationValidationError, } from "./errors.js";
+const MESSAGE_ROLES = new Set(["system", "user", "assistant", "tool"]);
+const BASE64_PATTERN = /^(?:[A-Za-z\d+/]{4})*(?:[A-Za-z\d+/]{2}==|[A-Za-z\d+/]{3}=)?$/;
+export function assertModerationInput(input) {
+    if (!input || typeof input !== "object") {
+        throw new ModerationValidationError("Moderation input must be an object.");
+    }
+    if (input.type === "text") {
+        if (typeof input.text !== "string" || input.text.trim().length === 0) {
+            throw new ModerationValidationError("Text moderation requires non-empty text.");
+        }
+        return;
+    }
+    if (input.type === "image") {
+        assertImageSource(input.source);
+        return;
+    }
+    if (input.type === "conversation") {
+        if (!Array.isArray(input.messages) || input.messages.length === 0) {
+            throw new ModerationValidationError("Conversation moderation requires at least one message.");
+        }
+        for (const [index, message] of input.messages.entries()) {
+            if (!message || typeof message !== "object" || !MESSAGE_ROLES.has(message.role)) {
+                throw new ModerationValidationError(`Conversation message ${index} has an unsupported role.`);
+            }
+            if (typeof message.content !== "string" || message.content.trim().length === 0) {
+                throw new ModerationValidationError(`Conversation message ${index} requires non-empty string content.`);
+            }
+        }
+        return;
+    }
+    throw new ModerationValidationError("Unsupported moderation input type.");
+}
+export function assertImageSource(source) {
+    if (!source || typeof source !== "object") {
+        throw new ModerationValidationError("Image moderation requires an image source.");
+    }
+    if (source.type === "url") {
+        let parsed;
+        try {
+            parsed = new URL(source.url);
+        }
+        catch {
+            throw new ModerationValidationError("Image URL must be a valid HTTP(S) URL.");
+        }
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            throw new ModerationValidationError("Image URL must use HTTP or HTTPS.");
+        }
+        return;
+    }
+    if (source.type === "base64") {
+        assertMediaType(source.mediaType);
+        if (typeof source.data !== "string") {
+            throw new ModerationValidationError("Image base64 data must be a string.");
+        }
+        const normalized = normalizeBase64(source.data);
+        if (normalized.length === 0 || !BASE64_PATTERN.test(normalized)) {
+            throw new ModerationValidationError("Image base64 data is invalid.");
+        }
+        return;
+    }
+    if (source.type === "bytes") {
+        assertMediaType(source.mediaType);
+        if (!isBinaryData(source.data) || binaryByteLength(source.data) === 0) {
+            throw new ModerationValidationError("Image bytes must be a non-empty Uint8Array, ArrayBuffer, or Blob.");
+        }
+        return;
+    }
+    throw new ModerationValidationError("Unsupported image source type.");
+}
+function assertMediaType(mediaType) {
+    if (typeof mediaType !== "string" || !/^image\/[A-Za-z\d.+-]+$/i.test(mediaType)) {
+        throw new ModerationValidationError('Image mediaType must look like "image/png".');
+    }
+}
+function isBinaryData(value) {
+    return value instanceof Uint8Array || value instanceof ArrayBuffer || value instanceof Blob;
+}
+export function flattenConversation(input) {
+    return JSON.stringify(input.messages);
+}
+export function normalizeHttpEndpoint(value, label) {
+    let endpoint;
+    try {
+        endpoint = new URL(value);
+    }
+    catch {
+        throw new ModerationValidationError(`${label} must be a valid HTTP(S) URL.`);
+    }
+    if (endpoint.protocol !== "http:" && endpoint.protocol !== "https:") {
+        throw new ModerationValidationError(`${label} must use HTTP or HTTPS.`);
+    }
+    return endpoint.toString().replace(/\/+$/, "");
+}
+export function normalizeBase64(value) {
+    return value.replace(/\s+/g, "");
+}
+export function base64ByteLength(value) {
+    const normalized = normalizeBase64(value);
+    if (normalized.length === 0)
+        return 0;
+    const padding = normalized.endsWith("==") ? 2 : normalized.endsWith("=") ? 1 : 0;
+    return (normalized.length * 3) / 4 - padding;
+}
+export function binaryByteLength(value) {
+    if (value instanceof Blob)
+        return value.size;
+    return value.byteLength;
+}
+export function imageSourceByteLength(source) {
+    if (source.type === "url")
+        return undefined;
+    if (source.type === "base64")
+        return base64ByteLength(source.data);
+    return binaryByteLength(source.data);
+}
+export async function imageSourceToBase64(source) {
+    if (source.type === "base64")
+        return normalizeBase64(source.data);
+    const bytes = source.data instanceof Blob
+        ? new Uint8Array(await source.data.arrayBuffer())
+        : source.data instanceof ArrayBuffer
+            ? new Uint8Array(source.data)
+            : source.data;
+    return bytesToBase64(bytes);
+}
+function bytesToBase64(bytes) {
+    if (typeof Buffer !== "undefined")
+        return Buffer.from(bytes).toString("base64");
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+export async function imageSourceToDataUrl(source) {
+    return `data:${source.mediaType};base64,${await imageSourceToBase64(source)}`;
+}
+export function normalizeAdapterResult(adapter, value) {
+    if (!value || typeof value !== "object") {
+        throw new ModerationAdapterError("Adapter returned an invalid moderation result.", {
+            adapter,
+            code: "invalid_response",
+        });
+    }
+    if (typeof value.flagged !== "boolean") {
+        throw new ModerationAdapterError('Adapter result requires a boolean "flagged" field.', {
+            adapter,
+            code: "invalid_response",
+        });
+    }
+    if (!value.categories || typeof value.categories !== "object") {
+        throw new ModerationAdapterError('Adapter result requires a "categories" object.', {
+            adapter,
+            code: "invalid_response",
+        });
+    }
+    return { ...value, adapter };
+}
+export function toAdapterError(adapter, error) {
+    if (error instanceof ModerationAdapterError) {
+        if (error.adapter === adapter)
+            return error;
+        return new ModerationAdapterError(error.message, {
+            adapter,
+            code: error.code,
+            status: error.status,
+            retryable: error.retryable,
+            details: error.details,
+            cause: error,
+        });
+    }
+    if (error instanceof ModerationSdkError) {
+        return new ModerationAdapterError(error.message, {
+            adapter,
+            code: error.code,
+            status: error.status,
+            retryable: error.retryable,
+            details: error.details,
+            cause: error,
+        });
+    }
+    return new ModerationAdapterError(error instanceof Error ? error.message : "Moderation adapter failed.", { adapter, cause: error });
+}
+export function normalizeSdkError(error) {
+    if (error instanceof ModerationSdkError)
+        return error;
+    return new ModerationSdkError(error instanceof Error ? error.message : "Moderation failed.", {
+        code: "internal_error",
+        cause: error,
+    });
+}
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new ModerationAbortError(signal.reason);
+}
+export function isAbortLike(error) {
+    return (error instanceof ModerationAbortError ||
+        (error instanceof DOMException && error.name === "AbortError") ||
+        (error instanceof Error && error.name === "AbortError"));
+}
+export async function raceWithAbort(promise, signal) {
+    throwIfAborted(signal);
+    if (!signal)
+        return promise;
+    return new Promise((resolve, reject) => {
+        const abort = () => reject(new ModerationAbortError(signal.reason));
+        signal.addEventListener("abort", abort, { once: true });
+        promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
+    });
+}
+export function sleepWithAbort(ms, signal) {
+    throwIfAborted(signal);
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(done, ms);
+        const abort = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", abort);
+            reject(new ModerationAbortError(signal?.reason));
+        };
+        function done() {
+            signal?.removeEventListener("abort", abort);
+            resolve();
+        }
+        signal?.addEventListener("abort", abort, { once: true });
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,4 +1,79 @@
 {
   "name": "content-moderation-sdk",
-  "version": "0.0.1"
+  "version": "0.1.1",
+  "description": "A provider-agnostic TypeScript SDK for text, image, and conversation moderation.",
+  "keywords": [
+    "azure",
+    "content-moderation",
+    "mistral",
+    "moderation",
+    "openai",
+    "safety",
+    "typescript"
+  ],
+  "homepage": "https://github.com/sophisticatedalterego/content-moderation-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/sophisticatedalterego/content-moderation-sdk/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sophisticatedalterego/content-moderation-sdk.git"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "content-moderation-sdk.jpg",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./openai": {
+      "types": "./dist/openai.d.ts",
+      "import": "./dist/openai.js"
+    },
+    "./azure": {
+      "types": "./dist/azure.d.ts",
+      "import": "./dist/azure.js"
+    },
+    "./mistral": {
+      "types": "./dist/mistral.d.ts",
+      "import": "./dist/mistral.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "check-types": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.type-tests.json",
+    "test": "bun test",
+    "lint": "oxlint src type-tests",
+    "format:check": "oxfmt --check .",
+    "check": "bun run lint && bun run format:check && bun run check-types && bun run test",
+    "pack:check": "bun run build && npm pack --dry-run --ignore-scripts",
+    "prepack": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.4",
+    "@types/node": "^25.9.4",
+    "oxfmt": "^0.46.0",
+    "oxlint": "^1.72.0",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "bun": ">=1.1.0",
+    "node": ">=20.0.0"
+  },
+  "packageManager": "bun@1.4.0"
 }

package/src/azure.ts

@@ -0,0 +1,191 @@
+import { ModerationAdapterError, ModerationValidationError } from "./errors.js";
+import { requestJson } from "./http.js";
+import type {
+  ModerationAdapter,
+  ModerationAdapterResult,
+  ModerationCategoryAssessment,
+  ModerationInput,
+} from "./types.js";
+import { imageSourceByteLength, imageSourceToBase64, normalizeHttpEndpoint } from "./utils.js";
+
+const AZURE_MAX_TEXT_CODE_POINTS = 10_000;
+const AZURE_MAX_IMAGE_BYTES = 4 * 1024 * 1024;
+
+export type AzureModerationCategory = "Hate" | "SelfHarm" | "Sexual" | "Violence";
+export type AzureSeverityThreshold = 2 | 4 | 6;
+
+export type AzureCategoryAnalysis = {
+  category: AzureModerationCategory | (string & {});
+  severity: number;
+};
+
+export type AzureBlocklistMatch = {
+  blocklistName: string;
+  blocklistItemId: string;
+  blocklistItemText: string;
+};
+
+export type AzureTextModerationResponse = {
+  categoriesAnalysis: AzureCategoryAnalysis[];
+  blocklistsMatch?: AzureBlocklistMatch[];
+};
+
+export type AzureImageModerationResponse = {
+  categoriesAnalysis: AzureCategoryAnalysis[];
+};
+
+export type AzureModerationResponse = AzureTextModerationResponse | AzureImageModerationResponse;
+
+export type AzureOptions = {
+  endpoint: string;
+  apiKey: string;
+  apiVersion?: string;
+  threshold?: AzureSeverityThreshold;
+  categories?: readonly AzureModerationCategory[];
+  blocklistNames?: readonly string[];
+  haltOnBlocklistHit?: boolean;
+  headers?: Readonly<Record<string, string>>;
+  fetch?: typeof fetch;
+};
+
+export type AzureAdapter = ModerationAdapter<
+  "azure",
+  { endpoint: string; apiVersion: string; threshold: AzureSeverityThreshold },
+  AzureModerationResponse
+>;
+
+export function azure(options: AzureOptions): AzureAdapter {
+  const endpoint = normalizeHttpEndpoint(options.endpoint, "Azure endpoint");
+  if (typeof options.apiKey !== "string" || options.apiKey.trim().length === 0) {
+    throw new ModerationValidationError("Azure apiKey is required.");
+  }
+
+  const apiVersion = options.apiVersion ?? "2024-09-01";
+  const threshold = options.threshold ?? 4;
+  if (typeof apiVersion !== "string" || apiVersion.trim().length === 0) {
+    throw new ModerationValidationError("Azure apiVersion must be a non-empty string.");
+  }
+  if (threshold !== 2 && threshold !== 4 && threshold !== 6) {
+    throw new ModerationValidationError("Azure threshold must be 2, 4, or 6.");
+  }
+  const fetcher = options.fetch ?? fetch;
+
+  return {
+    name: "azure",
+    capabilities: {
+      text: true,
+      image: true,
+      conversation: "flattened",
+    },
+    raw: { endpoint, apiVersion, threshold },
+    validate(input) {
+      if (input.type === "text" && [...input.text].length > AZURE_MAX_TEXT_CODE_POINTS) {
+        throw new ModerationValidationError(
+          `Azure text input cannot exceed ${AZURE_MAX_TEXT_CODE_POINTS} Unicode code points.`,
+          { adapter: "azure", limit: AZURE_MAX_TEXT_CODE_POINTS },
+        );
+      }
+      if (input.type === "image") {
+        const bytes = imageSourceByteLength(input.source);
+        if (bytes !== undefined && bytes > AZURE_MAX_IMAGE_BYTES) {
+          throw new ModerationValidationError("Azure image input cannot exceed 4 MB.", {
+            adapter: "azure",
+            limit: AZURE_MAX_IMAGE_BYTES,
+            actual: bytes,
+          });
+        }
+      }
+    },
+    async moderate(input, context) {
+      if (input.type === "conversation") {
+        throw new ModerationValidationError(
+          "Azure receives conversations through the client's flattened text path.",
+        );
+      }
+
+      const isText = input.type === "text";
+      const body = await requestJson<AzureModerationResponse>({
+        adapter: "azure",
+        provider: "Azure AI Content Safety",
+        fetcher,
+        url: `${endpoint}/contentsafety/${isText ? "text" : "image"}:analyze?api-version=${encodeURIComponent(apiVersion)}`,
+        init: {
+          method: "POST",
+          signal: context.signal,
+          headers: {
+            "Ocp-Apim-Subscription-Key": options.apiKey,
+            "Content-Type": "application/json",
+            ...options.headers,
+          },
+          body: JSON.stringify(
+            isText ? textPayload(input, options) : await imagePayload(input, options),
+          ),
+        },
+      });
+
+      if (!Array.isArray(body.categoriesAnalysis)) {
+        throw new ModerationAdapterError("Azure returned an invalid moderation response.", {
+          adapter: "azure",
+          code: "invalid_response",
+          details: body,
+        });
+      }
+
+      const categories = toCategoryAssessments(body.categoriesAnalysis, threshold);
+      const blocklistsMatch =
+        "blocklistsMatch" in body && Array.isArray(body.blocklistsMatch)
+          ? body.blocklistsMatch
+          : [];
+
+      return {
+        adapter: "azure",
+        flagged:
+          blocklistsMatch.length > 0 ||
+          Object.values(categories).some((category) => category.flagged === true),
+        categories,
+        raw: body,
+      } satisfies ModerationAdapterResult<"azure", AzureModerationResponse>;
+    },
+  };
+}
+
+function textPayload(input: Extract<ModerationInput, { type: "text" }>, options: AzureOptions) {
+  return {
+    text: input.text,
+    outputType: "FourSeverityLevels",
+    ...(options.categories ? { categories: options.categories } : {}),
+    ...(options.blocklistNames ? { blocklistNames: options.blocklistNames } : {}),
+    ...(options.haltOnBlocklistHit !== undefined
+      ? { haltOnBlocklistHit: options.haltOnBlocklistHit }
+      : {}),
+  };
+}
+
+async function imagePayload(
+  input: Extract<ModerationInput, { type: "image" }>,
+  options: AzureOptions,
+) {
+  return {
+    image:
+      input.source.type === "url"
+        ? { blobUrl: input.source.url }
+        : { content: await imageSourceToBase64(input.source) },
+    outputType: "FourSeverityLevels",
+    ...(options.categories ? { categories: options.categories } : {}),
+  };
+}
+
+function toCategoryAssessments(
+  analyses: readonly AzureCategoryAnalysis[],
+  threshold: AzureSeverityThreshold,
+): Readonly<Record<string, ModerationCategoryAssessment>> {
+  return Object.fromEntries(
+    analyses.map(({ category, severity }) => [
+      category,
+      {
+        flagged: severity >= threshold,
+        severity: { value: severity, max: 6 },
+      },
+    ]),
+  );
+}