Skip to content
CAI
Software that uses CAICheck a score

hyper63/hyper

52.7

Adequate · 21 September 2026

6.6k

lines of production code

TypeScript

with JavaScript

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Hyper is a modular service framework that provides a unified interface for managing data, cache, storage, search, and queue services. It offers multiple integration points, including RESTful APIs via Express and Opine, a GraphQL endpoint, and client SDKs for Node.js and Deno. The system is designed to be extensible through a plugin architecture, allowing developers to swap out underlying adapters for each service while maintaining a consistent, validated API layer.

How it got here

2020 — Deno 2 migration and TypeScript refactoring

12 changes.

The project underwent a comprehensive migration to TypeScript and Deno 2 compatibility, with core packages refactored to use Zod for strict input/output validation. This period also introduced new application adapters for Express and GraphQL, alongside a standalone developer instance, while updating dependencies to support modern Node.js versions.

2021 — API and SDK expansion

13 changes.

This period focused on expanding the Hyper framework's interface layer by introducing new service ports for queues and crawlers, alongside comprehensive API adapters for REST and GraphQL. The work also delivered a fully featured Deno client for the Hyper Connect SDK, establishing a unified, multi-language SDK experience.

2022–2023 — Core library refactoring and API expansion

11 changes.

This period focused on migrating the core library modules (cache, data, queue, storage, search) to TypeScript and implementing comprehensive test coverage for Node.js and Deno environments. Simultaneously, the project expanded its public API by adding new endpoints and middleware to the Express application, while introducing utility functions for consistent error handling.

Features

Add API routes and tests for data, cache, crawler, queue, search, and storage services

The express API now exposes endpoints for managing data, cache, crawlers, queues, search indexes, and storage buckets. Each service is implemented in its own module (e.g., \data.ts\, \cache.ts\) and paired with comprehensive integration tests (\\*.test.ts\) that verify route parameters, request bodies, and response headers. The \mod.ts\ file conditionally mounts these routes based on the presence of corresponding services in the \HyperServices\ object, ensuring the API only exposes functionality for available backends.

packages/app-express/api · high confidence

Add Hyper crawler instance configuration

The images/crawler directory now includes the foundational files to run a Hyper-based crawler. A new deps.js file exports the core application logic, the Opine adapter, and the Hyper spider adapter. A hyper.config.js file configures the crawler to use the Opine app and the Spider plugin, which is initialized with a SPIDER\_URL environment variable for links and content. The entry point mod.js loads this configuration and initializes the core, effectively setting up the crawler instance.

images/crawler · high confidence

Add deepSwap and HyperErr utility functions

The packages/utils directory now includes two new utility functions: deepSwap, which recursively replaces object keys (e.g., 'id' to '\_id'), and HyperErr, a constructor and helper functions (isHyperErr, isBaseHyperErr) for creating and validating standardized error objects. These are exported via mod.js and configured in deno.json for the @hyper63/utils package.

packages/utils · high confidence

Add error mapping utilities and HyperErr handling in core utils

The core library now includes new utility functions (\mapErr\, \mapStatus\, \HyperErrFrom\) in \packages/core/lib/utils/err.js\ to parse error objects and map them to \HyperErr\ instances, including specific handling for \ZodError\ validation failures. These utilities are exported via \mod.ts\ and integrated into the core's async reader pipeline to ensure all errors are consistently wrapped in \HyperErr\ objects with appropriate status codes and messages, improving error handling and debugging for API consumers.

packages/core/lib/utils · high confidence

Add hyper-nano binary download and execution script

A new Node.js script has been added to the nano bin directory. This script automatically downloads the appropriate hyper-nano binary for the user's operating system (Linux, Windows, or macOS) and executes it. The script handles platform-specific binary naming and architecture detection (x86\_64 vs arm64 on macOS) and ensures the binary is placed in the current working directory before execution.

images/nano/bin · high confidence

Add the Crawler Service port

The \packages/port-crawler\ package now provides a new Crawler Service port, including the main implementation (\mod.ts\), the port schema and types (\port.ts\), and corresponding tests (\mod.test.ts\). The port defines the interface for crawling operations (upsert, get, start, delete) and enforces input/output validation using Zod. The package is configured for Deno (via \deno.json\) and published as \@hyper63/port-crawler\ version 0.1.0.

packages/port-crawler · high confidence

Added Deno utility modules for connect

Added new utility modules for the Deno implementation of the connect package, including a hand-rolled Either type, a query builder, a request builder with a fetch shim, and a signature verification function for Hyper queues.

packages/connect/deno/utils · high confidence

Added core utilities for plugin loading and configuration validation

Introduced new utility modules in packages/core/utils to handle plugin lifecycle and configuration validation. The changes include a config-schema validator, a plugin-schema validator, an event manager for handling asynchronous events, and a plugin loader that composes plugin load and link functions to initialize adapters. Corresponding test files were added to verify the behavior of each utility.

packages/core/utils · high confidence

Added search functionality with index and document management

The core library now includes a new search module that provides methods to create, delete, and query search indexes, as well as to index, retrieve, update, and remove documents within those indexes. This change introduces the full set of search operations (createIndex, deleteIndex, bulk, query, indexDoc, getDoc, updateDoc, removeDoc) and their corresponding tests.

packages/core/lib/search · high confidence

Deno client implementation for Hyper Connect

The Deno client for Hyper Connect has been implemented, providing a complete set of APIs for data, cache, search, storage, and queue services. The implementation includes type definitions, dependency shims for Node.js compatibility, and utility functions for JWT generation and MIME type detection. This brings feature parity with the Node.js client, allowing Deno users to interact with all Hyper services.

packages/connect/deno · high confidence

Deno client services for cache, data, queue, search, and storage

The Deno implementation of the Connect client now includes dedicated service modules for cache, data, queue, search, and storage. Each service exposes functions for common operations: cache and data support create, get, update, remove, and destroy (with confirmation); data and search support query and bulk operations; queue supports enqueue, status checks, and create/destroy; storage supports upload, download, signed URLs, and remove. All services include create and destroy endpoints, with destroy requiring explicit confirmation to prevent accidental deletions.

packages/connect/deno/services · high confidence

Initial release of the Express app adapter

The \packages/app-express\ directory is introduced, providing a RESTful Express.js adapter for the Hyper service framework. This change adds the core application logic (\main.ts\, \mod.ts\), utility functions (\utils.ts\), and type definitions (\types.ts\) required to run Hyper services via an Express server. It also includes a test harness (\harness.ts\) and utilities (\test-utils.ts\) to facilitate unit testing of the routes and middleware. The package is configured with \deno.jsonc\ and \egg.json\ for the Deno and Nest.land registries, and includes a \README.md\ for documentation.

packages/app-express · high confidence

Initial release of the Queue port package

The \port-queue\ package is introduced, providing a queue service port for the hyper Service Framework. The package includes a TypeScript implementation (\mod.ts\, \port.ts\) that validates inputs and outputs using Zod schemas, exposing methods for creating, deleting, posting, getting, canceling, and retrying jobs. The package is configured with \deno.json\ and \deno.lock\ for dependency management, includes an Apache 2.0 license, and provides a \README\ with usage instructions and test commands.

packages/port-queue · high confidence

Initial release of the hyper-app-opine adapter

The diff introduces the complete source code for the \app-opine\ package, establishing the RESTful API layer for the Hyper service framework using the Opine web server. This includes the main application entry point (\mod.js\) which configures middleware such as CORS, Helmet, and form data parsing, alongside the routing logic (\router.js\) that maps Hyper ports to REST endpoints for cache, data, storage, search, queue, and crawler services. The package also includes a deprecation notice in the README, a Deno configuration (\deno.jsonc\), and a comprehensive suite of tests (\\*.test.js\) verifying the behavior of the form data and legacy GET header handling.

packages/app-opine · high confidence

Introduce GraphQL API for Cache, Data, Storage, and Crawler services

The app-graphql package now exposes a unified GraphQL interface for interacting with core hyper services. Users can query and mutate Cache, Data, Storage, and Crawler resources through a structured schema that includes metadata (PortInfo, RootInfo) and service-specific operations (e.g., createCacheStore, deleteData, makeStorageBucket, startCrawlerJob). The API supports standard JSON scalars and provides result types (CacheResult, DataResult, etc.) that implement a common PortResult interface for consistent error and status handling.

packages/app-graphql/lib · high confidence

Introduce hyper-nano as a standalone developer instance with in-memory adapters

Users can now run a local, standalone instance of hyper (hyper-nano) for development and sandboxed environments. This image bundles in-memory adapters for data (MongoDB), cache (SQLite), storage (filesystem), search (Minisearch), and queue (in-memory), allowing zero-config local usage. The entry point supports bootstrapping services on startup via the \--experimental\ flag, and the image provides compiled binaries for Linux, macOS (x86\_64 and ARM), and Windows, alongside Node.js (\npx\) and Deno execution options.

images/nano · high confidence

Introduce standalone GraphQL app with crawler service support

A new standalone GraphQL application is added to the codebase, exposing a full API for cache, data, storage, and crawler services. The schema defines queries and mutations for managing these services, including specific support for crawler jobs (e.g., create, start, delete). The app includes endpoints for file storage operations (get/put) and a GraphQL router, packaged with an Apache 2.0 license and a README.

packages/app-graphql · high confidence

New API endpoints for cache, crawler, data, queue, search, and storage

The app-opine API now exposes new endpoints for managing caches, crawlers, data stores, queues, search indexes, and storage buckets. Users can now create, read, update, and delete resources for each service via RESTful routes (e.g., /cache, /crawler, /data, /queue, /search, /storage). The storage endpoint supports both direct file uploads and signed URL generation, while the cache and data endpoints support legacy header-based toggling for backward compatibility.

packages/app-opine/api · high confidence

New middleware for JSON parsing, legacy headers, and object uploads

Added new middleware in the app-express package to handle specific request patterns. The json middleware now parses request bodies as JSON with a default 10mb size limit and a wildcard content-type to accommodate clients that omit headers. A legacyGet middleware was added to read the X-HYPER-LEGACY-GET header and set a corresponding flag on the request object. Additionally, an objectBodyParser middleware was introduced to route multipart/form-data uploads, raw binary data, or signed URL requests based on content type and query parameters.

packages/app-express/middleware · high confidence

Release of hyper-port-hooks v2.0.0

The hyper63 port-hooks package has been released as version 2.0.0, providing a validation layer for the Hooks Service adapter. This release includes the core implementation (mod.ts, port.ts) which uses Zod to parse and validate the adapter, along with a minimal test suite (mod.test.ts). The package is now fully configured for distribution via Deno's JSR and Nest.land registries, with a lockfile (deno.lock) pinning dependencies like Zod 3.20.5 and @std/assert 1.0.6.

packages/port-hooks · high confidence

Behavioural changes

Cache port validation and structure refactored for Deno 2

The cache port implementation has been refactored to TypeScript and updated for Deno 2, introducing strict input and output validation using Zod schemas. This ensures that adapters conform to the expected interface, with all cache operations (createStore, destroyStore, createDoc, getDoc, updateDoc, deleteDoc, listDocs) now validated against a defined schema. The package is now version 2.0.1, includes an Apache 2.0 license, and provides a deno.jsonc configuration for formatting and linting.

packages/port-cache · medium confidence

Core package refactored to TypeScript with Deno 2 compatibility

The core package has been fully refactored from JavaScript to TypeScript, introducing strict typing and improved developer experience. This includes the addition of a \deno.json\ configuration file for Deno 2 compatibility, a \crocks.d.ts\ type definition file for the crocks library, and a \model.ts\ file defining Zod schemas for configuration validation. The codebase now exports a typed \Config\ interface and leverages Deno's native module resolution, replacing the previous npm-based dependency management with a \deno.lock\ file and JSR/npm imports in \deno.json\. Additionally, the entry point and README have been updated to reflect the new structure, and the package is now published as an egg for the Nest.land registry.

packages/core · high confidence

Data port validation and adapter wrapper refactored to TypeScript with Zod schemas

The \port-data\ package has been refactored from JavaScript to TypeScript, introducing formal Zod-based validation for all data port methods (create, retrieve, update, remove, list, query, index, and bulk operations). The \mod.ts\ module now wraps adapters to enforce these schemas, ensuring inputs and outputs conform to the expected Hyper response format. This change improves type safety and runtime validation for data service adapters.

packages/port-data · high confidence

Enforced pre-commit linting via Husky

A new pre-commit hook has been added to the repository, automatically running 'deno task staged' on staged files before each commit. This change enforces code quality and linting checks at the time of commit, ensuring that only valid, linted code is committed to the repository.

.husky · high confidence

Hyper-connect SDK v0.13.0 release and build infrastructure

The hyper-connect SDK has been released at version 0.13.0, which includes a strict resource validation fix and requires strict true for destroy confirmations. This release also introduces a new build pipeline that uses deno2node to transpile the Deno client into Node.js-compatible code, with the Makefile and tsconfig files updated to support this dual-environment workflow. The package is now configured for publishing to both npm and the Nest.land registry via the new egg.json and deno.jsonc files.

packages/connect · high confidence

Port-Storage package restructured with TypeScript and Zod validation

The port-storage package has been refactored into TypeScript, introducing comprehensive input and output validation using the Zod library. This change ensures that all adapter implementations strictly adhere to the defined storage port interface, catching schema mismatches early. The package now includes a formalized \StoragePort\ type and validation schemas for all storage operations (makeBucket, removeBucket, listBuckets, putObject, removeObject, getObject, listObjects), providing stronger type safety and error handling for developers integrating storage adapters.

packages/port-storage · high confidence

Project renamed to hyper with updated documentation and tooling

The project has been renamed from 'Project Hubble' to 'hyper' (or 'hyper63' in some contexts), reflected in the README, contributing guidelines, and code of conduct. The README now features a comprehensive overview of the hyper Service Framework, including status, local running instructions, and links to documentation. Additionally, Deno configuration files (deno.json, deno.lock) and Gitpod setup files (.gitpod.Dockerfile, .gitpod.yml) have been added to support the development environment, alongside a .gitignore file.

(repo-wide) · high confidence

Queue module refactored to TypeScript with improved error handling

The queue module has been rewritten in TypeScript, introducing a new \job.ts\ file that handles job posting and cancellation, while \queue.ts\ and \mod.ts\ manage queue lifecycle operations. Error handling has been improved by passing specific status codes to \HyperErr\ for known errors, ensuring they are bubbled as non-fatal. Additionally, the module now triggers specific events (e.g., \queue:post\, \queue:cancel\) for better observability.

packages/core/lib/queue · medium confidence

Refactor data layer to TypeScript and add index options

The data layer in packages/core/lib/data has been refactored from JavaScript to TypeScript, introducing stricter type safety for database and document operations. Additionally, the \data.index\ function now accepts a \partialFilter\ option, and the \listDocuments\ operation supports a \descending\ sort order, allowing users to control the sort direction of query results.

packages/core/lib/data · high confidence

Refactored core cache module to use AsyncReader and expose document-level operations

The cache module in packages/core/lib/cache has been refactored to use the AsyncReader pattern for handling side effects and errors, with new files doc.ts and store.ts implementing the logic for document and store operations respectively. The main module (mod.ts) now exposes createDoc, updateDoc, getDoc, and deleteDoc alongside the existing store operations (index, createStore, deleteStore, queryStore). Tests in mod.test.ts verify the new behavior, including validation of store and document keys, and error handling for invalid names.

packages/core/lib/cache · high confidence

Refactored storage module to TypeScript with improved test coverage

The storage implementation in \packages/core/lib/storage\ has been refactored from JavaScript to TypeScript, introducing strict typing for bucket and object operations (make, remove, list, put, get, remove, list). This change improves code safety and maintainability while maintaining the same functional behavior for storage interactions.

packages/core/lib/storage · medium confidence

Release of hyper-port-search v2.0 with TypeScript and Deno 2 migration

The port-search package has been refactored to TypeScript and migrated to Deno 2, introducing a new \port.ts\ schema definition using Zod for validating adapter implementations. This change includes updated package metadata in \deno.json\ and \egg.json\ (version 2.0.0), a new \LICENSE\ file (Apache 2.0), and comprehensive test coverage in \mod.test.ts\ that validates input and output schemas for all search port methods (createIndex, deleteIndex, indexDoc, updateDoc, getDoc, removeDoc, bulk, query).

packages/port-search · high confidence

Test coverage

Add Node.js integration and unit tests for hyper-connect; Added comprehensive test coverage for the Deno connect package; Added test suite for cache, data, and search adapters.

Dependencies

Updated hyper-connect and hyper-nano dependencies

The hyper-connect package has been updated to version 0.13.0, which now requires Node.js 18 or higher and includes updated dependencies such as undici, jose, and ramda. Additionally, the hyper-nano package has been updated to version 3.0.1, with corresponding updates to its dependencies like chalk and ora. These changes ensure compatibility with modern Node.js versions and incorporate the latest library updates.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 49 → 53 (+3.5)
  • Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

Lenses

  • Code Health 81 → 81 (-0.0)
  • Architecture 99 → 86 (-12.8)
  • Maturity 58 → 58 (+0.0)
  • Readiness 45 → 53 (+7.9)
  • Security 37 → 43 (+6.8)

Resolved (77)

  • Change coupling: cache.ts ↔ data.ts (packages/connect/deno/services/cache.ts)
  • Change coupling: cache.ts ↔ search.ts (packages/connect/deno/services/cache.ts)
  • Change coupling: deps.js ↔ dev_deps.js (packages/app-opine/deps.js)
  • Coverage not included — suite not readable by the collector
  • Dependency hygiene not measured — no supported dependency manifest was read
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High vulnerability: [GHSA redacted] (packages/connect/yarn.lock)
  • High vulnerability: [GHSA redacted] (packages/connect/yarn.lock)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • …and 57 more

New (194)

  • Documentation: no installation or build instructions (README.md)
  • Floating npm dependency: hyper-connect
  • Floating npm dependency: hyper-connect
  • FunctionTooLong: mod.connect (packages/connect/deno/mod.ts)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High CVE: [GHSA redacted] (packages/connect/yarn.lock)
  • High IaC: WD-DOCKER-0001 (.gitpod.Dockerfile)
  • High vulnerability: [GHSA redacted] (packages/connect/yarn.lock)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • …and 174 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

hyper63/hyper was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 21 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 56a8ba9fb97ea2200fa7a10d5438d7c16c7e23b1 — the exact code this score is about.
  • Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
  • Measured by watchdog.canine.dev using codehealth-analyzer preprod-b84573e22831.