Enforce/check compatibility with secret/internal APIs by yamcodes · Pull Request #573 · yamcodes/arkenv

yamcodes · 2025-12-21T11:21:25Z

Since we are using secret/internal APIs in #228, we need to somehow enforce or check the compatibility, given that arktype is a peerDependency (and not a direct dependency we can pin).

Alternatively, avoid the usage of secret/internal APIs altogether, if possible. We are only using them for coercion currently (not in the main branch yet).

…chema definitions and refinements, and refine various type and regex functionalities.

… handling and new unit tests.

…ort` to use `parsedNumber`, and integrate `port` into the ArkType scope.

…, and enhance `number` and `boolean` coercion in `arkenv`.

…ransformation, supporting numeric refinements.

…ding numeric and boolean values.

…ort.

…ve boolean from the root scope.

… inputs.

…t coercion from their definitions and from the `type` export, relying on global coercion instead.

… values.

…bers, booleans, ranges, and optional properties.

…s in `createEnv` by introducing loose parsing keywords.

… add a test for this behavior.

…ent its behavior, edge cases, and internal API reliance.

…dd `process.env` isolation to tests

…nce coercion with internal property helpers and version checks.

…move the external compatibility workflow, and update related documentation and tests.

changeset-bot · 2025-12-21T11:21:28Z

🦋 Changeset detected

Latest commit: af0d408

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 6 packages

Name	Type
arkenv	Minor
@repo/keywords	Minor
@repo/scope	Minor
@arkenv/bun-plugin	Patch
@arkenv/vite-plugin	Patch
@repo/types	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2025-12-21T11:21:29Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
arkenv	Ready	Preview, Comment	Dec 21, 2025 11:24am

coderabbitai · 2025-12-21T11:21:30Z

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch secret-api-compatibility

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

pkg-pr-new · 2025-12-21T11:22:13Z

Open in StackBlitz

npm i https://pkg.pr.new/arkenv@573

npm i https://pkg.pr.new/@arkenv/bun-plugin@573

npm i https://pkg.pr.new/@arkenv/vite-plugin@573

commit: af0d408

arkenv-bot · 2025-12-21T11:23:19Z

📦 Bundle Size Report

Package	Size	Limit	Diff	Status
`arkenv`	1.2 kB	2 kB	+68.8%	✅

✅ All size limits passed!

yamcodes · 2025-12-22T14:56:57Z

Closing in favor of #578 which is uses 100% public API.

yamcodes added 21 commits December 21, 2025 02:49

feat: Enhance documentation with new components and content, update s…

74e426d

…chema definitions and refinements, and refine various type and regex functionalities.

refactor: improve coerce utility with explicit root-level primitive…

b4f1a35

… handling and new unit tests.

feat: Introduce parsedNumber and parsedBoolean types, refactor `p…

c564f9e

…ort` to use `parsedNumber`, and integrate `port` into the ArkType scope.

feat: add parsedNumber keyword, rename boolean to parsedBoolean…

23cdd76

…, and enhance `number` and `boolean` coercion in `arkenv`.

test: add test case for strict number literals coercion

d12e074

feat: Implement string-to-number/boolean coercion via global schema t…

5fbabe4

…ransformation, supporting numeric refinements.

docs: rename problem and solution sections to why and what changes

8cfcbf9

feat: add specification for environment variable type coercion, inclu…

b9f9c40

…ding numeric and boolean values.

docs: clarify coercion specification purpose and remove an unused imp…

742a121

…ort.

feat: Simplify port keyword to accept only number integers and remo…

6812925

…ve boolean from the root scope.

fix: Improve type coercion for numeric and boolean values from string…

82ccd6b

… inputs.

feat: Simplify port and boolean type handling by removing implici…

d779ac7

…t coercion from their definitions and from the `type` export, relying on global coercion instead.

test: update boolean and number.port type assertions to use primitive…

471cce5

… values.

feat: add comprehensive coercion tests for createEnv, including num…

74fab46

…bers, booleans, ranges, and optional properties.

feat: Enable automatic string coercion for number and boolean literal…

fb67bdb

…s in `createEnv` by introducing loose parsing keywords.

fix: Prevent empty or whitespace strings from coercing to numbers and…

f7cc6d4

… add a test for this behavior.

docs: Reformat coercion spec scenarios to use concise WHEN/THEN syntax.

7bfafd3

feat: Implement 'loose' coercion using maybeParsed morphs and docum…

0e18d76

…ent its behavior, edge cases, and internal API reliance.

refactor: enhance coerce utility with ArkType internal typing and a…

dfd847a

…dd `process.env` isolation to tests

feat: Add ArkType compatibility workflow and contract tests, and enha…

b4cf3f2

…nce coercion with internal property helpers and version checks.

feat: Add internal ArkType compatibility checks to coercion logic, re…

e1b4a96

…move the external compatibility workflow, and update related documentation and tests.

[autofix.ci] apply automated fixes

af0d408

yamcodes changed the base branch from main to coercion-improvements December 21, 2025 11:22

vercel bot deployed to Preview December 21, 2025 11:24 View deployment

Base automatically changed from coercion-improvements to coercion December 21, 2025 13:45

yamcodes closed this Dec 22, 2025

yamcodes deleted the secret-api-compatibility branch December 22, 2025 19:36

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Enforce/check compatibility with secret/internal APIs#573

Enforce/check compatibility with secret/internal APIs#573
yamcodes wants to merge 22 commits intocoercionfrom
secret-api-compatibility

yamcodes commented Dec 21, 2025 •

edited

Loading

Uh oh!

changeset-bot bot commented Dec 21, 2025 •

edited

Loading

Uh oh!

vercel bot commented Dec 21, 2025 •

edited

Loading

Uh oh!

coderabbitai bot commented Dec 21, 2025

Review skipped

Uh oh!

pkg-pr-new bot commented Dec 21, 2025 •

edited

Loading

Uh oh!

arkenv-bot bot commented Dec 21, 2025

Uh oh!

yamcodes commented Dec 22, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

yamcodes commented Dec 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Dec 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Dec 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Dec 21, 2025

Review skipped

Uh oh!

pkg-pr-new bot commented Dec 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

arkenv-bot bot commented Dec 21, 2025

📦 Bundle Size Report

Uh oh!

yamcodes commented Dec 22, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

yamcodes commented Dec 21, 2025 •

edited

Loading

changeset-bot bot commented Dec 21, 2025 •

edited

Loading

vercel bot commented Dec 21, 2025 •

edited

Loading

pkg-pr-new bot commented Dec 21, 2025 •

edited

Loading