Skip to content

docs(packages): fix core description and add keywords to all packages - #191

Merged
tamino-martinius merged 1 commit into
mainfrom
tm/fix-package-descriptions
Jul 13, 2026
Merged

tamino-martinius merged 1 commit into
mainfrom
tm/fix-package-descriptions

Conversation

@tamino-martinius

Copy link
Copy Markdown
Owner

What & why

The @next-model/core package description was stale — leftover from an old AWS-focused fork:

AWS Data API model layer package with zero dependencies to use in lambda

Its keywords were similarly misleading, advertising connector-specific tech (pg, postgres, mysql, data api, aws, serverless) that has no business on the storage-agnostic core.

This PR corrects the core metadata and, while there, brings every published package's package.json metadata up to standard.

Changes

core — the headline fix:

  • Description → A typed, promise-based ORM for TypeScript. Declare models with a factory, chain immutable query scopes, manage associations, and plug in any storage via the Connector interface — with validators, callbacks, soft deletes, and a built-in in-memory connector.
  • Keywords → next-model, orm, typescript, model, database, query-builder, active-record, migrations, validation, esm (dropped the connector-specific/AWS terms).

Improved two terse/awkward descriptions:

  • knex-connector: now names Knex 3 and the supported dialects.
  • aurora-data-api-connector: now describes the RDS Data API / Aurora Serverless v1 targeting and the connection-less, Lambda-friendly design.

Keywords added to all 19 packages that had none — a consistent scheme (shared next-model / orm base + package-specific terms like driver, framework, or DB name) for npm discoverability.

The other 16 descriptions were already accurate against the README and are unchanged.

Verification

  • All 20 package.json files parse as valid JSON.
  • biome format reports no changes needed (matches repo style).
  • Facts checked against source: Knex ^3.2.10, Aurora Serverless v1 via RDS Data API, core tagline matches its own README.

Scope: only the 20 published packages under packages/. The demos/ and examples/ packages are private with no descriptions and are out of scope.

The @next-model/core description was stale leftover from an AWS-focused
fork ("AWS Data API model layer package ... to use in lambda") and its
keywords advertised connector-specific tech (pg, aws, data api, serverless)
that don't belong on the storage-agnostic core. Rewrite it as the typed,
promise-based ORM it actually is, and replace the keywords accordingly.

Also:
- Improve two terse/awkward descriptions (knex-connector, aurora-data-api).
- Add a consistent keywords scheme to all 19 packages that had none, for
  npm discoverability (shared base + package-specific terms).
@github-actions

Copy link
Copy Markdown
Contributor

Coverage report

Package Statements Branches Functions Lines
arktype 80.76% 73.40% 87.50% 90.90%
aurora-data-api-connector 80.40% 60.42% 96.42% 82.97%
core 88.54% 80.64% 89.72% 90.26%
express-rest-api 89.47% 76.99% 100.00% 93.05%
graphql-api 86.32% 68.71% 97.05% 90.33%
knex-connector 80.89% 68.30% 91.34% 83.48%
local-storage-connector 95.87% 93.93% 90.47% 95.55%
mariadb-connector 87.40% 78.87% 85.00% 91.42%
migrations 98.63% 89.10% 100.00% 98.85%
migrations-generator 94.64% 87.75% 100.00% 100.00%
mongodb-connector 83.72% 69.31% 82.97% 87.00%
mysql-connector 77.11% 60.23% 83.54% 79.95%
nextjs-api 82.59% 73.01% 97.50% 85.92%
postgres-connector 84.05% 68.48% 91.25% 86.20%
react 93.73% 83.10% 89.74% 94.45%
redis-connector 80.15% 59.17% 89.09% 84.82%
sqlite-connector 85.22% 72.86% 91.96% 87.78%
typebox 83.11% 70.31% 93.33% 93.10%
valkey-connector 100.00% 66.66% 100.00% 100.00%
zod 85.88% 72.30% 92.85% 94.11%

Posted by .github/scripts/coverage-comment.mjs.

@tamino-martinius
tamino-martinius merged commit 153af7b into main Jul 13, 2026
56 checks passed
@tamino-martinius
tamino-martinius deleted the tm/fix-package-descriptions branch July 13, 2026 16:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant