ProvenPin Install

CASL ability rules for resource authorization: working versions (tested 2026-10-15)

Define @casl/ability rules for roles, check can/cannot on subjects, and pack/unpack abilities for transfer, covering update conditions on owned records.

passed3 passed · 0 failed2026-10-15 15:57 UTC
Status
passed
Last passed
2026-10-15 15:57 UTC
Tests
3 / 3
Language
TypeScript
Runtime
node v22.23.3
pinned versions3
@casl/ability@7.0.2@types/node@26.6.5tsx@4.23.15
run it
npm install --no-audit --no-fund --ignore-scripts=false
npm test
test environment
node v22.23.3
linux 6.17.0-1022-azure
x64
runner: github-actions 38764699834

The code

Exactly the files that passed. Your agent can pull them with get_recipe("casl-ability-rules") (install), or see them on GitHub.

package.json
{
  "name": "casl-ability-rules",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node --import tsx --test test/*.test.ts"
  },
  "dependencies": {
    "@casl/ability": "7.0.2"
  },
  "devDependencies": {
    "@types/node": "26.6.5",
    "tsx": "4.23.15"
  }
}
src/abilities.ts
import { AbilityBuilder, createMongoAbility, subject, type MongoAbility, type InferSubjects } from "@casl/ability";

export type Actions = "create" | "read" | "update" | "delete" | "manage";
export type Post = { id: number; authorId: number; published: boolean };
export type Subjects = InferSubjects<Post> | "Post" | "all";
export type AppAbility = MongoAbility<[Actions, Subjects]>;

export type Actor = { id: number; role: "admin" | "author" | "guest" };

export function asPost(p: Post) {
  return subject("Post", p);
}

export function defineAbilityFor(user: Actor): AppAbility {
  const { can, cannot, build } = new AbilityBuilder<AppAbility>(createMongoAbility);
  if (user.role === "admin") {
    can("manage", "all");
  } else if (user.role === "author") {
    can("read", "Post");
    can("create", "Post");
    can("update", "Post", { authorId: user.id });
    cannot("delete", "Post");
  } else {
    can("read", "Post", { published: true });
  }
  return build();
}

export function packAbility(ability: AppAbility) {
  return ability.rules;
}
test/abilities.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { createMongoAbility } from "@casl/ability";
import { asPost, defineAbilityFor, packAbility, type Post } from "../src/abilities.ts";

const owned: Post = { id: 1, authorId: 7, published: false };
const other: Post = { id: 2, authorId: 9, published: true };

test("admin can manage everything", () => {
  const a = defineAbilityFor({ id: 1, role: "admin" });
  assert.equal(a.can("delete", asPost(owned)), true);
  assert.equal(a.can("manage", "all"), true);
});

test("author updates only own posts", () => {
  const a = defineAbilityFor({ id: 7, role: "author" });
  assert.equal(a.can("update", asPost(owned)), true);
  assert.equal(a.can("update", asPost(other)), false);
  assert.equal(a.can("delete", asPost(owned)), false);
  assert.equal(a.can("create", "Post"), true);
});

test("guest reads only published and rules pack", () => {
  const a = defineAbilityFor({ id: 0, role: "guest" });
  assert.equal(a.can("read", asPost(other)), true);
  assert.equal(a.can("read", asPost(owned)), false);
  const packed = packAbility(a);
  const restored = createMongoAbility(packed);
  assert.equal(restored.can("read", asPost(other)), true);
});

Connect to ProvenPin

Add the free MCP server so your agent can pull this recipe and others like it. Same setup as the docs.

terminal
claude mcp add --transport http provenpin https://mcp.provenpin.com/mcp

Any other MCP client: Streamable HTTP at https://mcp.provenpin.com/mcp. No API key, no signup.