@basementstudio/mitt-next-plugin 0.0.0-stage → 0.2.0

package/dist/transform.js

@@ -0,0 +1,365 @@
+import { createHmac } from 'node:crypto';
+import MagicString, {} from 'magic-string';
+import { parseSync, visitorKeys } from 'oxc-parser';
+// Elements that never render a box (or whose content React manages outside the host markup), so
+// a pin can't land on them. `html` and `body` are tagged: they are valid fallbacks for a pin.
+const SKIPPED_TAGS = new Set([
+    'head',
+    'script',
+    'style',
+    'meta',
+    'link',
+    'title',
+    'template',
+    'noscript',
+    'base',
+]);
+// Only characters a git SHA (plus `-dirty`) or a CI ref can contain, so the value can sit inside a
+// JSX string literal without escaping.
+const SAFE_COMMIT = /^[\w.-]{1,80}$/;
+// Library components whose default export spreads unknown props onto a single DOM element, keyed
+// by module specifier, with that element's tag: the one the widget records as the anchor's `tag`.
+// Checked in Next 16.4: `next/image` and `next/legacy/image` spread `...rest` onto their `<img>`,
+// `next/link` onto its `<a>`. An explicit list on purpose: an arbitrary component may drop the
+// prop, or let it override a `data-fb` its own root already carries.
+const FORWARDING_COMPONENTS = new Map([
+    ['next/image', 'img'],
+    ['next/image.js', 'img'],
+    ['next/legacy/image', 'img'],
+    ['next/legacy/image.js', 'img'],
+    ['next/link', 'a'],
+    ['next/link.js', 'a'],
+]);
+// Cheap pre-filter: a lowercase intrinsic always starts with `<` and a lowercase letter (JSX allows
+// whitespace in between), and a forwarding component needs its import. Files with neither are
+// returned before paying for a parse.
+const MAYBE_TAGGED = /<\s*[a-z]|['"]next\/(?:legacy\/)?(?:image|link)(?:\.js)?['"]/;
+const ID_LENGTH = 12;
+export function createId(secret, relPath, line, column) {
+    return createHmac('sha256', secret)
+        .update(`${relPath}:${line}:${column}`)
+        .digest('hex')
+        .slice(0, ID_LENGTH);
+}
+function isNode(value) {
+    return typeof value === 'object' && value !== null && typeof value.type === 'string';
+}
+function identifierName(node) {
+    return isNode(node) && node.type === 'Identifier' && typeof node.name === 'string'
+        ? node.name
+        : null;
+}
+const FUNCTION_TYPES = new Set([
+    'FunctionDeclaration',
+    'FunctionExpression',
+    'ArrowFunctionExpression',
+]);
+// The name a reader would use for the function at `ancestors[index]`, or null if it has none.
+// Handles `function Foo`, `const Foo = () =>`, `const Foo = memo(() =>)`, class methods and
+// `export default function () {}`.
+function functionName(ancestors, index) {
+    const fn = ancestors[index];
+    if (!fn)
+        return null;
+    const own = identifierName(fn.id);
+    if (own)
+        return own;
+    let parentIndex = index - 1;
+    let parent = ancestors[parentIndex];
+    // Wrappers like `memo(...)` / `forwardRef(...)`: climb to whatever the call is assigned to.
+    while (parent?.type === 'CallExpression') {
+        parentIndex -= 1;
+        parent = ancestors[parentIndex];
+    }
+    if (!parent)
+        return null;
+    if (parent.type === 'VariableDeclarator')
+        return identifierName(parent.id);
+    if (parent.type === 'ExportDefaultDeclaration')
+        return 'default';
+    if (parent.type === 'MethodDefinition') {
+        const method = identifierName(parent.key);
+        if (!method)
+            return null;
+        // MethodDefinition sits in ClassBody, inside the class itself.
+        const className = identifierName(ancestors[parentIndex - 2]?.id);
+        return className ? `${className}.${method}` : method;
+    }
+    return null;
+}
+function nearestComponent(ancestors) {
+    for (let index = ancestors.length - 1; index >= 0; index--) {
+        const node = ancestors[index];
+        if (node && FUNCTION_TYPES.has(node.type)) {
+            const name = functionName(ancestors, index);
+            if (name)
+                return name;
+        }
+    }
+    return null;
+}
+function stringValue(node) {
+    if (!isNode(node))
+        return null;
+    if (node.type === 'Literal')
+        return typeof node.value === 'string' ? node.value : null;
+    return identifierName(node);
+}
+/** Local names bound to the default export of a FORWARDING_COMPONENTS module, with their tag. */
+function forwardingImports(program) {
+    const found = new Map();
+    const body = Array.isArray(program.body) ? program.body : [];
+    for (const statement of body) {
+        if (!isNode(statement) || statement.type !== 'ImportDeclaration')
+            continue;
+        if (statement.importKind === 'type')
+            continue;
+        const tag = FORWARDING_COMPONENTS.get(stringValue(statement.source) ?? '');
+        if (!tag || !Array.isArray(statement.specifiers))
+            continue;
+        for (const specifier of statement.specifiers) {
+            if (!isNode(specifier) || specifier.importKind === 'type')
+                continue;
+            const isDefault = specifier.type === 'ImportDefaultSpecifier' ||
+                (specifier.type === 'ImportSpecifier' && stringValue(specifier.imported) === 'default');
+            const local = identifierName(specifier.local);
+            if (isDefault && local)
+                found.set(local, tag);
+        }
+    }
+    return found;
+}
+function patternNames(pattern, names) {
+    if (!isNode(pattern))
+        return;
+    switch (pattern.type) {
+        case 'Identifier':
+            if (typeof pattern.name === 'string')
+                names.add(pattern.name);
+            return;
+        case 'ObjectPattern':
+            if (Array.isArray(pattern.properties)) {
+                for (const property of pattern.properties) {
+                    if (isNode(property))
+                        patternNames(property.type === 'Property' ? property.value : property, names);
+                }
+            }
+            return;
+        case 'ArrayPattern':
+            if (Array.isArray(pattern.elements))
+                for (const element of pattern.elements)
+                    patternNames(element, names);
+            return;
+        case 'AssignmentPattern':
+            patternNames(pattern.left, names);
+            return;
+        case 'RestElement':
+            patternNames(pattern.argument, names);
+            return;
+        case 'TSParameterProperty':
+            patternNames(pattern.parameter, names);
+            return;
+    }
+}
+/**
+ * Every value name declared in the file outside its imports. No scope analysis: a name declared
+ * anywhere at all counts, which can only make the transform tag less, never the wrong element.
+ */
+function declaredNames(program) {
+    const names = new Set();
+    const walk = (node) => {
+        if (node.type === 'ImportDeclaration')
+            return;
+        switch (node.type) {
+            case 'VariableDeclarator':
+                patternNames(node.id, names);
+                break;
+            case 'FunctionDeclaration':
+            case 'FunctionExpression':
+            case 'ArrowFunctionExpression':
+                patternNames(node.id, names);
+                if (Array.isArray(node.params))
+                    for (const param of node.params)
+                        patternNames(param, names);
+                break;
+            case 'ClassDeclaration':
+            case 'ClassExpression':
+            case 'TSEnumDeclaration':
+            case 'TSImportEqualsDeclaration':
+            case 'TSModuleDeclaration':
+                patternNames(node.id, names);
+                break;
+            case 'CatchClause':
+                patternNames(node.param, names);
+                break;
+        }
+        const keys = visitorKeys[node.type];
+        if (!keys)
+            return;
+        for (const key of keys) {
+            const child = node[key];
+            if (Array.isArray(child)) {
+                for (const item of child)
+                    if (isNode(item))
+                        walk(item);
+            }
+            else if (isNode(child))
+                walk(child);
+        }
+    };
+    walk(program);
+    return names;
+}
+/** The DOM tag `opening` renders, or null when it isn't one the transform tags. */
+function hostTag(opening, forwarding) {
+    const name = opening.name;
+    if (!isNode(name) || name.type !== 'JSXIdentifier' || typeof name.name !== 'string')
+        return null;
+    const tag = name.name;
+    // Lowercase first letter is React's own rule for host elements; `Foo`, `foo.bar` and `svg:rect`
+    // are components or namespaced names and never reach the DOM as-is.
+    const first = tag.charCodeAt(0);
+    if (first >= 97 && first <= 122)
+        return tag;
+    const forwarded = forwarding.get(tag);
+    if (!forwarded)
+        return null;
+    // `<Link legacyBehavior>` clones its child instead of rendering an `<a>`, and drops its own
+    // props; the child is tagged on its own.
+    return hasAttribute(opening, 'legacyBehavior') ? null : forwarded;
+}
+function hasAttribute(opening, attribute) {
+    const attributes = opening.attributes;
+    if (!Array.isArray(attributes))
+        return false;
+    return attributes.some((item) => isNode(item) &&
+        item.type === 'JSXAttribute' &&
+        isNode(item.name) &&
+        item.name.type === 'JSXIdentifier' &&
+        item.name.name === attribute);
+}
+function lineStarts(source) {
+    const starts = [0];
+    for (let index = source.indexOf('\n'); index !== -1; index = source.indexOf('\n', index + 1)) {
+        starts.push(index + 1);
+    }
+    return starts;
+}
+function locate(starts, offset) {
+    let low = 0;
+    let high = starts.length - 1;
+    while (low < high) {
+        const mid = (low + high + 1) >> 1;
+        if ((starts[mid] ?? 0) <= offset)
+            low = mid;
+        else
+            high = mid - 1;
+    }
+    return { line: low + 1, column: offset - (starts[low] ?? 0) };
+}
+function langFor(relPath) {
+    return /\.m?jsx?$/.test(relPath) ? 'jsx' : 'tsx';
+}
+function unchanged(source, warning) {
+    return warning === undefined
+        ? { code: source, map: null, entries: [] }
+        : { code: source, map: null, entries: [], warning };
+}
+/**
+ * Injects an opaque `data-fb` ID on every lowercase host JSX element, and on the library components
+ * of FORWARDING_COMPONENTS (recorded with the tag they render). Pure: the same source and
+ * options always give the same output, which is what lets the manifest be rebuilt from git
+ * instead of collected from a (cached) build.
+ */
+export function transform(source, options) {
+    const { relPath, secret } = options;
+    let warning;
+    let commit = null;
+    if (options.commit) {
+        if (SAFE_COMMIT.test(options.commit))
+            commit = options.commit;
+        else
+            warning = `[mitt] ignored an unsafe commit value for ${relPath}`;
+    }
+    if (!MAYBE_TAGGED.test(source))
+        return unchanged(source, warning);
+    let program;
+    try {
+        const result = parseSync(relPath, source, {
+            lang: langFor(relPath),
+            sourceType: 'module',
+            preserveParens: false,
+        });
+        if (result.errors.length > 0) {
+            const first = result.errors[0]?.message ?? 'unknown error';
+            return unchanged(source, `[mitt] skipped ${relPath}: could not parse it (${first})`);
+        }
+        program = result.program;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return unchanged(source, `[mitt] skipped ${relPath}: could not parse it (${message})`);
+    }
+    const s = new MagicString(source);
+    const entries = [];
+    const starts = lineStarts(source);
+    const ancestors = [];
+    const forwarding = isNode(program) ? forwardingImports(program) : new Map();
+    if (forwarding.size > 0 && isNode(program)) {
+        // A local `Image` (a parameter, a nested component) may not be next/image at all.
+        for (const name of declaredNames(program))
+            forwarding.delete(name);
+    }
+    const visitOpening = (opening) => {
+        const tag = hostTag(opening, forwarding);
+        if (!tag || SKIPPED_TAGS.has(tag))
+            return;
+        // After `<Image<Props>` type arguments, which only a component can carry.
+        const nameEnd = isNode(opening.typeArguments)
+            ? opening.typeArguments.end
+            : opening.name.end;
+        let insert = '';
+        if (!hasAttribute(opening, 'data-fb')) {
+            const { line, column } = locate(starts, opening.start);
+            const id = createId(secret, relPath, line, column);
+            entries.push({ id, file: relPath, line, column, tag, component: nearestComponent(ancestors) });
+            insert += ` data-fb="${id}"`;
+        }
+        if (tag === 'html' && commit && !hasAttribute(opening, 'data-fb-commit')) {
+            insert += ` data-fb-commit="${commit}"`;
+        }
+        if (insert)
+            s.appendLeft(nameEnd, insert);
+    };
+    const walk = (node) => {
+        if (node.type === 'JSXOpeningElement')
+            visitOpening(node);
+        const keys = visitorKeys[node.type];
+        if (!keys)
+            return;
+        ancestors.push(node);
+        for (const key of keys) {
+            const child = node[key];
+            if (Array.isArray(child)) {
+                for (const item of child)
+                    if (isNode(item))
+                        walk(item);
+            }
+            else if (isNode(child))
+                walk(child);
+        }
+        ancestors.pop();
+    };
+    if (isNode(program))
+        walk(program);
+    if (!s.hasChanged())
+        return unchanged(source, warning);
+    const map = options.sourceMap === false
+        ? null
+        : s.generateMap({ hires: true, source: options.mapSource ?? relPath, includeContent: true });
+    const result = { code: s.toString(), map, entries };
+    if (warning !== undefined)
+        result.warning = warning;
+    return result;
+}
+//# sourceMappingURL=transform.js.map

package/dist/transform.js.map

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

package/dist/with-mitt.d.ts

@@ -0,0 +1,29 @@
+import type { NextConfig } from 'next';
+export type { Entry, TransformOptions, TransformResult } from './transform.js';
+export interface NextConfigContext {
+    defaultConfig: NextConfig;
+}
+export type NextConfigFunction = (phase: string, context: NextConfigContext) => NextConfig | Promise<NextConfig>;
+export interface MittOptions {
+    /**
+     * Lets `next build` fall back to the public dev secret when the secret env var is unset. Only
+     * for builds that are never deployed (e.g. a local e2e target); the IDs it produces can be
+     * reversed by anyone who can guess file paths.
+     */
+    allowDevSecretInBuild?: boolean;
+    /**
+     * The Next app directory. Defaults to the cwd, which is the app directory whenever Next runs
+     * from its package scripts. Next doesn't chdir, so `next build <dir>` from elsewhere needs this.
+     */
+    root?: string;
+    /**
+     * Serve the setup checklist at `/__mitt` under `next dev` (ADR 0013). Default true. Never part
+     * of a production build, whatever this says.
+     */
+    setupPage?: boolean;
+}
+/**
+ * The Node side of `withMitt` (see index.ts), loaded only when Next calls the config function. The
+ * secret itself never enters the config: Next writes the config into the server build output.
+ */
+export declare function applyMitt(nextConfig: NextConfig | NextConfigFunction, options: MittOptions, phase: string, context: NextConfigContext): Promise<NextConfig>;

package/dist/with-mitt.js

@@ -0,0 +1,145 @@
+import { existsSync, realpathSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PROJECT_ID_PATTERN } from '@basementstudio/mitt-shared/formats';
+import { readMittConfig, resolveSecret, secretFingerprint } from './config.js';
+import { resolveCommit } from './git.js';
+// Values of `next/constants`, inlined so the plugin doesn't load Next at config time.
+const PHASE_DEVELOPMENT_SERVER = 'phase-development-server';
+const PHASE_PRODUCTION_BUILD = 'phase-production-build';
+const LOADER_PATH = fileURLToPath(new URL('./loader.js', import.meta.url));
+const JSX_GLOBS = ['*.tsx', '*.jsx'];
+const NEXT_CONFIG_FILES = ['next.config.ts', 'next.config.mts', 'next.config.mjs', 'next.config.js'];
+let warnedDevSecret = false;
+let warnedNoApi = false;
+// Next loads the config several times per build; git's answer doesn't change in between.
+const commits = new Map();
+function commitFor(root, live) {
+    const key = `${root}\0${live}\0${process.env.VERCEL_GIT_COMMIT_SHA ?? ''}`;
+    let commit = commits.get(key);
+    if (commit === undefined) {
+        commit = resolveCommit(root, { live });
+        commits.set(key, commit);
+    }
+    return commit;
+}
+// IDs are keyed by paths relative to this directory and the CLI rebuilds them from the same root,
+// so a wrong guess would make every comment unresolvable (#2): fail the build instead.
+function resolveRoot(option) {
+    const root = realpathSync(resolve(option ?? process.cwd()));
+    if (!NEXT_CONFIG_FILES.some((file) => existsSync(join(root, file)))) {
+        throw new Error(`[mitt] ${root} has no next.config file. Run Next from the app directory or pass ` +
+            'withMitt(config, { root }).');
+    }
+    return root;
+}
+// Only a fingerprint leaves this function; the loader re-reads the secret from the environment.
+function secretOptions(secretEnv, allowDevSecret) {
+    const options = { secretEnv, allowDevSecret };
+    const { secret, devFallback } = resolveSecret(secretEnv, process.env, {
+        allowDev: allowDevSecret,
+    });
+    // No secret and no fallback: the loader fails the build when it first runs. Throwing here would
+    // also break `next typegen`, which loads the config in the build phase but never compiles.
+    if (secret === null)
+        return options;
+    if (devFallback && !warnedDevSecret) {
+        warnedDevSecret = true;
+        console.warn(`[mitt] ${secretEnv} is not set; using the public dev secret for data-fb IDs.`);
+    }
+    return { ...options, fingerprint: secretFingerprint(secret) };
+}
+function httpOrigin(value) {
+    if (!value?.trim())
+        return null;
+    try {
+        const url = new URL(value.trim());
+        return url.protocol === 'http:' || url.protocol === 'https:' ? url.origin : null;
+    }
+    catch {
+        return null;
+    }
+}
+// What <Mitt /> falls back to without props. Next inlines `env` into every bundle that reads these
+// names, so only values already public in the loader tag may go here: never the secret or the CLI
+// token (#3). Values the app set itself win.
+function withEmbedEnv(config, project) {
+    const env = {};
+    const id = typeof project === 'string' ? project : process.env.MITT_PROJECT;
+    if (id && PROJECT_ID_PATTERN.test(id))
+        env.MITT_PROJECT = id;
+    const api = httpOrigin(process.env.MITT_API_URL);
+    if (api)
+        env.MITT_API_URL = api;
+    else if (!config.env?.MITT_API_URL && !warnedNoApi) {
+        warnedNoApi = true;
+        console.warn('[mitt] MITT_API_URL is not set, so <Mitt /> renders nothing unless it gets an `api` prop.');
+    }
+    return { ...config, env: { ...env, ...config.env } };
+}
+function onlyLoaders(items) {
+    return items.every((item) => typeof item === 'string' || 'loader' in item);
+}
+// Ours goes first so it sees the file exactly as it is on disk (and in git): IDs are keyed by
+// line and column, and the manifest rebuilds them from the raw source.
+function prependRule(existing, rule) {
+    if (existing === undefined)
+        return rule;
+    if (!Array.isArray(existing))
+        return [rule, existing];
+    // A plain list of loaders is shorthand for one rule; keep it as one rule.
+    if (onlyLoaders(existing))
+        return [rule, { loaders: existing }];
+    return [rule, ...existing];
+}
+function withTurbopackRules(config, loader) {
+    const rules = { ...config.turbopack?.rules };
+    for (const glob of JSX_GLOBS) {
+        rules[glob] = prependRule(rules[glob], {
+            condition: { not: 'foreign' },
+            loaders: [{ loader: LOADER_PATH, options: { ...loader } }],
+        });
+    }
+    return { ...config, turbopack: { ...config.turbopack, rules } };
+}
+function withWebpackRule(config, loader) {
+    const userWebpack = config.webpack;
+    const webpack = (webpackConfig, context) => {
+        const target = webpackConfig;
+        target.module ??= {};
+        target.module.rules ??= [];
+        target.module.rules.push({
+            test: /\.[jt]sx$/,
+            exclude: /node_modules/,
+            enforce: 'pre',
+            use: [{ loader: LOADER_PATH, options: { ...loader } }],
+        });
+        return userWebpack ? userWebpack(webpackConfig, context) : webpackConfig;
+    };
+    return { ...config, webpack };
+}
+/**
+ * The Node side of `withMitt` (see index.ts), loaded only when Next calls the config function. The
+ * secret itself never enters the config: Next writes the config into the server build output.
+ */
+export async function applyMitt(nextConfig, options, phase, context) {
+    const config = typeof nextConfig === 'function' ? await nextConfig(phase, context) : nextConfig;
+    // Only these phases compile code; `next start` and friends never run the loader.
+    if (phase !== PHASE_DEVELOPMENT_SERVER && phase !== PHASE_PRODUCTION_BUILD)
+        return config;
+    const root = resolveRoot(options.root);
+    const { secretEnv, project } = readMittConfig(root);
+    const allowDevSecret = phase === PHASE_DEVELOPMENT_SERVER || Boolean(options.allowDevSecretInBuild);
+    const loader = { ...secretOptions(secretEnv, allowDevSecret), root };
+    const commit = commitFor(root, phase === PHASE_DEVELOPMENT_SERVER);
+    // Loader options must be plain JSON without nulls, so a missing commit is simply omitted.
+    if (commit)
+        loader.commit = commit;
+    const withLoader = withWebpackRule(withTurbopackRules(withEmbedEnv(config, project), loader), loader);
+    if (phase !== PHASE_DEVELOPMENT_SERVER || options.setupPage === false)
+        return withLoader;
+    // Loaded only here, so builds never even import it.
+    const { setupServerFor, withSetupRewrites } = await import('./setup.js');
+    return withSetupRewrites(withLoader, (await setupServerFor(root)).target);
+}
+//# sourceMappingURL=with-mitt.js.map

package/dist/with-mitt.js.map

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

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "@basementstudio/mitt-next-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Next.js plugin for Mitt: the <Mitt /> loader component, opaque data-fb IDs at build time (Turbopack and webpack), the private manifest rebuilt from git, and a dev-only setup page.",
+  "license": "UNLICENSED",
+  "keywords": [
+    "mitt",
+    "feedback",
+    "nextjs",
+    "next-plugin",
+    "turbopack"
+  ],
+  "homepage": "https://github.com/basementstudio/mitt#readme",
+  "bugs": {
+    "url": "https://github.com/basementstudio/mitt/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/basementstudio/mitt.git",
+    "directory": "packages/next-plugin"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./loader": {
+      "types": "./dist/loader.d.ts",
+      "default": "./dist/loader.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@basementstudio/mitt-shared": "0.2.0",
+    "magic-string": "^1.4.3",
+    "oxc-parser": "^0.154.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "next": "^16.4.2",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "typescript": "7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "peerDependencies": {
+    "next": ">=16",
+    "react": ">=19"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.