Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
@hyperjump/json-schema-bundle
Advanced tools
Readme
JSON Schema Bundle (JSB) is an implementation of the official JSON Schema bundling process introduced in the Draft 2020-12 specification. Given a schema with external references, any external schemas will be embedded in the schema resulting in a Compound Schema Document with all the schemas necessary to evaluate the given schema.
The bundling process allows schemas to be embedded without needing to modify any references which means you get the same output details whether you validate the bundle or the original unbundled schemas.
JSON Schema Bundle (JSB) is built on JSON Schema Core.
JSB includes support for node.js JavaScript (CommonJS and ES Modules), TypeScript, and browsers.
npm install @hyperjump/json-schema-bundle
When in a browser context, JSB is designed to use the browser's fetch
implementation instead of a node.js fetch clone. The Webpack bundler does this
properly without any extra configuration, but if you are using the Rollup
bundler you will need to include the browser: true
option in your Rollup
configuration.
plugins: [
resolve({
browser: true
}),
commonjs()
]
This project is in beta and there may be breaking changes at any time. When it's stable enough, I'll publish v1.0.0 and follow semantic versioning from there on out.
const Bundler = require("@hyperjump/json-schema-bundle");
// Optionally load schema manually
Bundler.add({
"$id": "https://json-schema.hyperjump.io/schemas/string",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "string"
});
// Get the initial schema to pass to the bundler
const main = await Bundler.get(`file://${__dirname}/schemas/main.schema.json`);
// The bundler will fetch from the file system, network, or internal schemas as
// needed to build to bundle.
const bundle = await Bundler.bundle(main);
Although the package is written in JavaScript, type definitions are included for TypeScript support. The following example shows the types you might want to know.
import Bundler from "@hyperjump/json-schema-bundle";
import type { SchemaDocument, Draft202012Schema, InvalidSchemaError } from "@hyperjump/json-schema-bundle";
(async function () {
const schemaJson: Draft202012Schema = {
"$id": "https://json-schema.hyperjump.io/schemas/string",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "string"
};
Bundler.add(schemaJson);
try {
const main: SchemaDocument = await Bundler.get(`file://${__dirname}/schemas/main.schema.json`);
const bundle: Draft202012Schema = await Bundler.bundle(main);
console.log(JSON.stringify(bundle, null, " "));
} catch (error: unknown) {
if (error instanceof InvalidSchemaError) {
console.log(error.output);
} else {
console.log(error);
}
}
}());
add: (schema: object, url?: URI, schemaVersion?: string) => SDoc
Load a schema. See JSC - $id and JSC - $schema for more information.
get: (url: URI, contextDoc?: SDoc, recursive: boolean = false) => Promise<SDoc>
Fetch a schema. Schemas can come from an HTTP request, a file, or a schema
that was added with add
.
bundle: (schema: SDoc, options: Options) => Promise<SchemaObject>
Create a bundled schema starting with the given schema. External schemas will be fetched from the filesystem, the network, or internally as needed.
Options:
$defs
. When using
"full" mode, it will keep the already embedded schemas around, which will
result in some embedded schema duplication.setMetaOutputFormat: (outputFormat: OutputFormat = DETAILED) => undefined
Set the output format for meta-validation. Meta-validation output is only returned if meta-validation results in an error.
setShouldMetaValidate: (isEnabled: boolean) => undefined
Enable or disable meta-validation.
OutputFormat: [FLAG | BASIC | DETAILED | VERBOSE]
See JSC - Output for more information on output formats.
Run the tests
npm test
Run the tests with a continuous test runner
npm test -- --watch
FAQs
A tool for bundling JSON Schema documents
The npm package @hyperjump/json-schema-bundle receives a total of 39 weekly downloads. As such, @hyperjump/json-schema-bundle popularity was classified as not popular.
We found that @hyperjump/json-schema-bundle demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.