Skip to content

feat: add provider authorization adapters on immutable core - #76

Closed
martijn00 wants to merge 48 commits into
letstri:mainfrom
martijn00:feat/providers-on-immutable
Closed

feat: add provider authorization adapters on immutable core#76
martijn00 wants to merge 48 commits into
letstri:mainfrom
martijn00:feat/providers-on-immutable

Conversation

@martijn00

Copy link
Copy Markdown
Contributor

Summary

This supersedes #66. Keep #66 open until this lands, or close it in favor of this rebased branch.

Test plan

  • pnpm test
  • pnpm run check-types
  • pnpm run lint
  • pnpm --filter permix size:compare (new fixtures for adapter/pdp/providers; ~15% budgets; baseline refreshed)
  • cd permix && pnpm run skills:stale
  • pnpm --filter provider-adapters start (PDP + Supabase check over HTTP-shaped handler)

Made with Cursor

martijn00 and others added 30 commits August 27, 2026 19:31
Develop the library on TypeScript 7 while keeping the consumer peer at 5.9–7, and pin shared toolchain versions through a strict pnpm catalog so CI and local installs stay aligned.

Co-authored-by: Cursor <cursoragent@cursor.com>
Give each factory its own provider/hook/Check bindings so nested policies do not share state, and hydrate dehydrated rules on the first client render without mutating during render.

Co-authored-by: Cursor <cursoragent@cursor.com>
Cache one initialized instance per RSC request so concurrent server callers share setup, and keep layouts synchronous with permission work behind Suspense for Cache Components.

Co-authored-by: Cursor <cursoragent@cursor.com>
Subscribe to setup/ready during render instead of after an effect so dehydrated booleans and already-initialized rules are visible on the first paint.

Co-authored-by: Cursor <cursoragent@cursor.com>
Toolchain skills from skills.sh fail format check and are not project source.

Co-authored-by: Cursor <cursoragent@cursor.com>
Oxfmt rejected the barrel and type-test files, and pinning React 18 in the catalog conflicts with docs/fumadocs React 19 peers.

Co-authored-by: Cursor <cursoragent@cursor.com>
Oxfmt requires a single trailing newline after the merge from the React factory branch.

Co-authored-by: Cursor <cursoragent@cursor.com>
Reconstruct published npm history, show it on the docs site, and wire conventional-commit releases.

Co-authored-by: Cursor <cursoragent@cursor.com>
Upgrade Fumadocs to 16.15 with the Base UI alias.

Ignore .agents and .claude so CI format check skips third-party skill files.

Co-authored-by: Cursor <cursoragent@cursor.com>
pnpm 11 rejects packages newer than one day in frozen CI installs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Wire Permix into Nest via APP_GUARD so each request gets its own instance, then enforce @check on handlers without tying the API to Express middleware. Closes letstri#11.

Co-authored-by: Cursor <cursoragent@cursor.com>
Store one Permix instance per Nitro event so Nuxt server routes and Vue SSR share rules without leaking state across requests.

Co-authored-by: Cursor <cursoragent@cursor.com>
Store a per-request Permix instance on Astro locals so middleware, endpoints, and pages can share rules without tying UI islands to a new client adapter.

Co-authored-by: Cursor <cursoragent@cursor.com>
React Router 7 (including Remix) needs a per-request instance on middleware context so loaders can dehydrate into permix/react.

Co-authored-by: Cursor <cursoragent@cursor.com>
Reuse existing Zod, Valibot, or ArkType schemas on action specs and via
permix/standard-schema so ReBAC callbacks stay typed without duplicate
interfaces. check() still does not parse data at runtime.

Co-authored-by: Cursor <cursoragent@cursor.com>
Parse check() data with the entity schema when validate is deny or throw, and lock Zod, Valibot, ArkType, and Effect Schema behind regression tests so those integrations stay working.

Co-authored-by: Cursor <cursoragent@cursor.com>
…talog-extraction

Co-authored-by: Cursor <cursoragent@cursor.com>
…talog-extraction

Co-authored-by: Cursor <cursoragent@cursor.com>
…talog-extraction

Co-authored-by: Cursor <cursoragent@cursor.com>
…talog-extraction

Co-authored-by: Cursor <cursoragent@cursor.com>
…talog-extraction

Co-authored-by: Cursor <cursoragent@cursor.com>
…talog-extraction

Co-authored-by: Cursor <cursoragent@cursor.com>
Avoid passing undefined React Router params. Narrow the generated Svelte
component at its factory boundary so TypeScript 7 checks remain valid.

Co-authored-by: Cursor <cursoragent@cursor.com>
Derive typed definitions and metadata from static permission markers so application usage becomes
the catalog source of truth. Include CLI, watch and check workflows, Next.js integration, typed
payload overlays, provider coverage validation, and consumer guidance.

Co-authored-by: Cursor <cursoragent@cursor.com>
Measure every public entry in CI and preserve tree-shaking boundaries.
Avoid rerendering Check when its permission result is unchanged.

Co-authored-by: Cursor <cursoragent@cursor.com>
…in CI

Hydrate and check treated inherited Object.prototype names as allowing
rules, and Fastify/Elysia could fall through after a custom deny handler.
Freeze a null-prototype copy of rules so caller mutation cannot change
authorization, and gate PRs on the full Vitest suite.

Co-authored-by: Cursor <cursoragent@cursor.com>
Null-prototype frozen rules and Object.hasOwn lookups add ~550 bytes to
the core graph; raise ceilings with the usual 12% headroom and keep
delta caps so later PRs still cannot grow unchecked.

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Aug 28, 2026

Copy link
Copy Markdown

@martijn00 is attempting to deploy a commit to the letstri Team on Vercel.

A member of the Team first needs to authorize it.

Co-authored-by: Cursor <cursoragent@cursor.com>
@martijn00
martijn00 force-pushed the feat/providers-on-immutable branch from b309501 to 94d4b2c Compare August 28, 2026 23:52
martijn00 and others added 16 commits August 29, 2026 01:55
Co-authored-by: Cursor <cursoragent@cursor.com>
…nstance

UI check() now goes through the live instance once rules exist so hooks
and Standard Schema validate run, Svelte hydrate follows state, and Vue
Check caches a computed boolean. Document that core setup() is not
request-safe.

Co-authored-by: Cursor <cursoragent@cursor.com>
…uild

Move chokidar, oxc-parser, and tinyglobby to optional peers so UI-only
installs skip native parser binaries. Cache per-file parses during
watch, and build dist once before the TypeScript compatibility matrix.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep check() boolean while rule functions may return { allow, reason }.
Adapters, UI hooks, and PermixForbiddenError carry the same payload.

Co-authored-by: Cursor <cursoragent@cursor.com>
Split factory from instance so overlapping setup cannot leak across
requests. Adapters stash the returned frozen instance; Next cache()
stores that instance instead of mutating a shared core.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…-first getting started

Co-authored-by: Cursor <cursoragent@cursor.com>
Centralize per-invocation authentication, rule resolution, typed decisions,
dehydration, and catalog coverage for isolated provider integrations.

Co-authored-by: Cursor <cursoragent@cursor.com>
Provide an isolated Fetch handler, deterministic OpenAPI contract, and typed
client for caller-scoped and trusted service authorization checks.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add verified claims and user adapters, generated Database type inference,
typed policy manifests, and secure RLS recipes for Supabase applications.

Co-authored-by: Cursor <cursoragent@cursor.com>
Provide isolated server and client plugins, typed request helpers, and optional
access-control inference without shared mutable rule state.

Co-authored-by: Cursor <cursoragent@cursor.com>
Provide isolated Auth and request resolution, explicit permission mappings,
bearer-token permissions transport, and a thin Next.js convenience layer.

Co-authored-by: Cursor <cursoragent@cursor.com>
Resolve authenticated identities and isolated rules before Convex handlers,
while preserving function validators and generated data-model inference.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add a credential-free acceptance example.
Align consumer skills with the stable adapter APIs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Verify the installed tarball and execute RLS boundaries against local Supabase.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@martijn00
martijn00 force-pushed the feat/providers-on-immutable branch from 94d4b2c to 5e0bd7b Compare August 28, 2026 23:56
@letstri

letstri commented Sep 6, 2026

Copy link
Copy Markdown
Owner

Closing: this changes the public API, which is not something we're taking from external PRs right now.

@letstri letstri closed this Sep 6, 2026
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.

2 participants