Registry / web-framework / tessellate-bundler

tessellate-bundler

library0.1.4jsnpmunverified

Tessellate Bundler is a web service specifically designed to create JavaScript bundles for Mosaic fragments, leveraging Webpack. It functions as a microservice within the Zalando Mosaic ecosystem, primarily compiling React component trees from abstract JSON definitions into Universal Module Definition (UMD) bundles. These bundles are then consumed by `tessellate-fragment` to render static HTML. The package is currently at version 0.1.4, which, combined with its origin in the `zalando-incubator` program and a last significant commit date around 2017, indicates that the project is abandoned and no longer actively maintained. Its key differentiation was providing a dynamic fragment solution for micro-frontends, allowing bundles to be updated independently. It relies on older versions of Koa and Webpack 2, making it incompatible with modern development practices and environments. It does not follow a regular release cadence.

web-framework devops

npm install tessellate-bundler

github ↗package ↗

INSTALL

IMPORT

SIG · TESSELLATE-BUNDLER

tessellate-bundler

web-frameworkjavascriptv0.1.4

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.

start

✓ const start = require('tessellate-bundler');

✗ import { start } from 'tessellate-bundler';

This package is primarily a standalone service. The `start` function is the main programmatic entry point to launch the bundler's web server. As a legacy project from the Node.js >=6 era, it uses CommonJS `require` syntax exclusively.

app

✓ const app = require('tessellate-bundler/app');

✗ import app from 'tessellate-bundler/app';

The Koa application instance, exposed for deeper programmatic interaction such as testing or custom middleware injection, though not a typical use case for a deployed service. Uses CommonJS `require`.

createBundler

✓ const createBundler = require('tessellate-bundler/lib/bundler');

✗ import { createBundler } from 'tessellate-bundler/lib/bundler';

A utility function that encapsulates the Webpack bundling logic. Useful if extending or modifying the core bundling process. Uses CommonJS `require`.

This demonstrates how to set up and run the Tessellate Bundler service from its source repository, starting the web server on a specified port.

git clone https://github.com/zalando-incubator/tessellate.git cd tessellate/tessellate-bundler npm install # Configure via environment variables or CLI arguments # For example, to run on port 8080 npm start -- --port 8080

Debug

Known issues

breakingThe `tessellate-bundler` project is abandoned, with no active maintenance or updates since approximately 2017. This means no further bug fixes, security patches, or compatibility improvements will be provided.

fix

Avoid using this package for new projects. For existing projects, consider a full migration to a modern bundling solution or fork the repository for self-maintenance.

affects: >=0.1.4

breakingThe bundler is hard-locked to Webpack `^2.2.0`. This version of Webpack is very old and is not compatible with modern Webpack configurations, loaders, or plugins, which have introduced numerous breaking changes over subsequent major versions.

fix

Updating Webpack would require significant refactoring of the bundler's internal logic and configuration. It is generally not feasible to use this bundler with modern Webpack setups.

affects: >=0.1.4

gotchaThe package is written entirely in CommonJS (CJS) syntax, as it originates from the Node.js >=6 era. Attempting to use ES Modules (ESM) `import`/`export` syntax will lead to `SyntaxError`s or unexpected behavior.

fix

Ensure all programmatic interactions with `tessellate-bundler` use `require()` statements for module imports.

affects: >=0.1.4

gotchaBeing an early `0.1.4` version from an incubator project, the software may be unstable, lack robust error handling, or contain undiscovered bugs. It was likely a proof-of-concept or internal tool.

fix

Thoroughly test in your specific environment if you must use this package. Be prepared for unexpected behavior and a lack of support.

affects: >=0.1.4

Errors

Common errors & fixes

Error: Cannot find module 'webpack' (or similar for other peer/direct dependencies)

The required `webpack` (or other dependencies like `koa`) is not installed or not resolvable in the project's `node_modules`.

fix

Run `npm install` within the `tessellate-bundler` directory, or explicitly `npm install webpack koa koa-router-rx rxjs`.

TypeError: (some property or method) is not a function

Often occurs when a dependency (like Koa or RxJS) is an incompatible version with what `tessellate-bundler` expects (`koa@2.x.x`, `rxjs@5.x.x`).

fix

Verify that your installed peer dependencies strictly match the versions specified in `tessellate-bundler`'s `peerDependencies`.

SyntaxError: Unexpected token 'export' (or 'import')

Attempting to use ES Modules (ESM) syntax (e.g., `import { start } from 'tessellate-bundler';`) in this CommonJS-only package.

fix

Replace ESM syntax with CommonJS `require()` statements (e.g., `const start = require('tessellate-bundler');`).

Webpack compilation errors related to outdated configuration or features.

The bundler's Webpack configuration is designed for Webpack 2, and attempting to bundle modern JavaScript features, use newer Webpack APIs, or incompatible loaders/plugins will fail.

fix

Ensure the components being bundled are compatible with Webpack 2 features and syntax. Significant updates to the bundler itself would be required to support newer Webpack versions.

Upgrade

Version history

0.1.4latest on npm

Audit

Dependencies

koarequiredPeer dependency for the underlying web server framework. Requires `2.x.x`.

koa-router-rxrequiredPeer dependency for reactive routing within the Koa application. Requires `0.3.x`.

rxjsrequiredPeer dependency for reactive programming, primarily used by `koa-router-rx`. Requires `5.x.x`.

webpackrequiredCore runtime dependency for performing the actual JavaScript bundling. Explicitly depends on `^2.2.0`.

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/zalando-incubator/tessellate ↗

packagehttps://www.npmjs.com/package/tessellate-bundler ↗