@microblink/blinkid-core

This package provides the core BlinkID functionality for browser-based document scanning. It exposes a low-level API for initializing and controlling the BlinkID engine, managing sessions, and processing images. It can be used directly by end users for advanced or custom integrations, or as a dependency of higher-level packages such as @microblink/blinkid.

Overview

• Provides the main API for BlinkID scanning and recognition in the browser.
• Handles initialization, licensing, and session management.
• Can be used directly by end users for advanced use cases.
• Used internally by @microblink/blinkid.

Browser Support

This package supports image processing in these browser versions and newer:

• Chrome / Chromium 96 (desktop and Android)
• Edge 96
• Opera 84
• Firefox 114 (desktop and Android)
• Safari 15.1 (macOS)
• iOS Safari 15.1

These minimums come from the combination of Emscripten-generated WebAssembly, required baseline Wasm features, and the module Web Worker used by @microblink/blinkid-core. This package does not include camera capture or UX components. If you use @microblink/blinkid or the UX manager package, see the browser support section in those packages instead.

Migration from v7 to v8000

For breaking changes and upgrade steps, see the BlinkID v8000 migration guide.

Installation

Install from npm using your preferred package manager:

npm install @microblink/blinkid-core
# or
yarn add @microblink/blinkid-core
# or
pnpm add @microblink/blinkid-core

Usage

You can use @microblink/blinkid-core directly in your project for custom integrations.

Creating a Scanning Session

Use createScanningSession (available via the BlinkIdCore proxy) to start a session:

import { loadBlinkIdCore } from "@microblink/blinkid-core";

const core = await loadBlinkIdCore({
  licenseKey: "your-license-key",
  resourcesLocation: "/resources",
});
const session = await core.createScanningSession();

You can also pass worker-side session options as the second argument. For example, use redactionSettingsResolver to choose result redaction per classified document:

const session = await core.createScanningSession(
  {
    scanningMode: "automatic",
  },
  {
    redactionSettingsResolver: (documentClassInfo) => {
      if (
        documentClassInfo.country === "germany" &&
        documentClassInfo.type === "id"
      ) {
        return {
          mode: "full-result",
          fields: ["documentNumber"],
          documentNumberRedactionSettings: {
            prefixDigitsVisible: 0,
            suffixDigitsVisible: 4,
          },
          redactMrz: true,
          redactBarcode: false,
        };
      }

      // Return null to keep SDK default redaction settings.
      return null;
    },
  },
);

To get the specific document default redaction settings, use the second argument of redactionSettingsResolver

const session = await core.createScanningSession(
  {
    scanningMode: "automatic",
  },
  {
    redactionSettingsResolver: async (
      documentClassInfo,
      getDefaultRedactionSettings,
    ) => {
      if (
        documentClassInfo.country === "germany" &&
        documentClassInfo.type === "id"
      ) {
        const defaults = await getDefaultRedactionSettings(documentClassInfo);

        return {
          mode: "full-result",
          fields: ["documentNumber"],
          documentNumberRedactionSettings: {
            prefixDigitsVisible: 0,
            suffixDigitsVisible: 4,
          },
          redactMrz: defaults.redactMrz,
          redactBarcode: defaults.redactBarcode,
        };
      }

      // Return null to keep SDK default redaction settings.
      return null;
    },
  },
);

redactionSettingsResolver replaces the v7 session-level anonymization settings (scanningSettings.anonymizationMode and scanningSettings.customDocumentAnonymizationSettings). The resolver receives the classified DocumentClassInfo; return RedactionSettings for custom redaction or null to keep the SDK defaults. See the BlinkID v8000 migration guide for the full migration.

See the example apps in the apps/examples directory in the GitHub repository for full usage details.

Environment & Setup

• ESM-only: Use in browsers with a bundler (e.g., Vite) or via <script type="module">.
• Can also be used via esm.sh for direct HTTP imports.

License key

A valid license key is required. Request a free trial at Microblink Developer Hub.

Hosting resources

You must host the dist/resources directory from this package without modification. It contains:

• WebAssembly .wasm and .data files
• Emscripten JS glue code
• The @microblink/blinkid-worker Web Worker script

Hosting requirements

• Must be served in a secure context.

• For multithreaded builds, your site must be cross-origin isolated:

  Cross-Origin-Embedder-Policy: require-corp
  Cross-Origin-Opener-Policy: same-origin

Development

To build the package locally:

1. Install dependencies in the monorepo root:

   pnpm install

2. Build the package:

   pnpm build

The output files will be available in the dist/ and types/ directories.