Registry / serialization / jstransformer

jstransformer

JSON →
library1.0.0jsnpmunverified

JSTransformer is a utility package designed to standardize the APIs of various "jstransformer-*" packages, which encompass template engines, Markdown parsers, and code compilers. Its core purpose is to provide a consistent interface for methods such as `.render`, `.renderAsync`, `.renderFile`, and `.renderFileAsync`, along with properties like `inputFormats` and `outputFormat`. The current and only stable version is 1.0.0, which was last published over 7 years ago (June 2016). The project appears to be unmaintained, with no recent releases or active development within the `jstransformers` GitHub organization. While it aimed to unify over 100 transformers at its peak, its long-term inactivity means it likely lacks support for modern JavaScript features or recent versions of underlying transformer libraries. Its key differentiator was its API normalization, enabling interchangeability of transformers, but this benefit is significantly diminished by its abandoned status.

serializationweb-framework
npm install jstransformer
github ↗package ↗
INSTALL
IMPORT
SIG · JSTRANSFORMER
J
jstransformer
serializationjavascriptv1.0.0
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

transformer
✓ const transformer = require('jstransformer');
✗ import transformer from 'jstransformer';
This package is CommonJS-only and does not support ES module (ESM) imports. Use `require()`.
markedTransformer
✓ const markedTransformer = transformer(require('jstransformer-marked'));
✗ const markedTransformer = require('jstransformer-marked');
The `jstransformer` utility is a factory function that takes another `jstransformer-*` package as an argument to normalize its API.
render
✓ markedTransformer.render(str, options, locals);
✗ markedTransformer(str, options, locals);
Normalized transformers expose `.render`, `.renderAsync`, `.renderFile`, and `.renderFileAsync` methods.

This quickstart demonstrates how to initialize `jstransformer` with a specific transformer (like `jstransformer-marked`) and use both its synchronous `.render` and asynchronous `.renderAsync` methods to process input strings.

const transformer = require('jstransformer'); // You need to install a specific transformer, e.g., 'jstransformer-marked' // npm install jstransformer-marked const markedTransformer = transformer(require('jstransformer-marked')); const markdownString = 'Some **markdown** content to transform.'; const options = {}; // Options for the underlying transformer (e.g., for 'marked') const locals = {}; // Locals for template engines (e.g., Pug, Handlebars) try { // Synchronous rendering const result = markedTransformer.render(markdownString, options, locals); console.log('Transformed Body (Sync):', result.body); console.log('Dependencies (Sync):', result.dependencies); // Asynchronous rendering (returns a Promise) markedTransformer.renderAsync('Async **markdown** content.', options, locals) .then(asyncResult => { console.log('Transformed Body (Async):', asyncResult.body); console.log('Dependencies (Async):', asyncResult.dependencies); }) .catch(error => { console.error('Async render error:', error); }); } catch (error) { console.error('Sync render error:', error); }
Debug
Known issues
gotchaThe `jstransformer` package, along with many `jstransformer-*` plugins, has been abandoned for over 7 years. This means it lacks updates for modern JavaScript, potential security fixes, or compatibility with newer versions of underlying libraries.
fix
Consider migrating to actively maintained libraries or ensuring a thorough security review of all transitive dependencies if using in production.
affects: >=1.0.0
gotchaThe package is CommonJS-only (`require()`) and does not support ES Modules (`import`). Using `import` statements will lead to errors in ESM contexts.
fix
Ensure your project is configured for CommonJS, or use dynamic `import()` if necessary within an ESM environment, though direct `import` syntax will fail.
affects: >=1.0.0
gotchaThe `jstransformer` utility is a wrapper. If the underlying transformer (e.g., `jstransformer-marked`) cannot perform a requested operation (e.g., `renderFile` when it only supports `render`), it may throw an error at runtime.
fix
Consult the documentation for the specific `jstransformer-*` plugin you are using to understand its capabilities and supported methods before calling them via the normalized API.
affects: >=1.0.0
Errors
Common errors & fixes
Error: Cannot find module 'jstransformer-marked'
The `jstransformer` package acts as a wrapper and requires a specific transformer plugin (e.g., `jstransformer-marked`) to be installed separately.
fix
Run `npm install jstransformer-marked` (or the specific transformer you intend to use).
TypeError: transformer(...).render is not a function
The module passed to `transformer()` either doesn't implement a `render` method, or it's not a valid `jstransformer-*` compatible module.
fix
Verify that the module you are passing to `transformer()` is a properly structured `jstransformer-*` plugin and supports the `render` method. Check the plugin's documentation.
SyntaxError: Cannot use import statement outside a module
Attempting to use `import` syntax with `jstransformer`, which is a CommonJS-only package.
fix
Change `import ... from 'jstransformer'` to `const ... = require('jstransformer');` and ensure your project environment supports CommonJS modules.
Upgrade
Version history
1.0.0latest on npm
Audit
Dependencies
jstransformer-markedrequiredThis package acts as a wrapper; actual transformation functionality requires installing specific 'jstransformer-something' packages, such as this Markdown transformer.
Agent activity
2 hits · last 30 days
node
2
Resources
githubhttps://github.com/jstransformers/jstransformer ↗
packagehttps://www.npmjs.com/package/jstransformer ↗
jstransformer — npm install jstransformer · libregistry