@pgpm/jwt-claims 0.28.0 → 0.28.4

package/README.md

@@ -306,7 +306,7 @@ pnpm test
 
 ## Related Tooling
 
-* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
+* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/cli): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
 * [pgsql-test](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
 * [supabase-test](https://github.com/constructive-io/constructive/tree/main/postgres/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
 * [graphile-test](https://github.com/constructive-io/constructive/tree/main/graphile/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
@@ -314,21 +314,6 @@ pnpm test
 * [libpg-query-node](https://github.com/constructive-io/libpg-query-node): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
 * [pg-proto-parser](https://github.com/constructive-io/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
 
-### 📚 Documentation & Skills
-
-* [constructive-skills](https://github.com/constructive-io/constructive-skills): **📖 Platform documentation and AI agent skills** — feature catalog, blueprint reference, SDK guides, and deployment guides.
-
-Install skills for AI coding agents:
-
-```bash
-# All platform skills (security, blueprints, codegen, billing, etc.)
-npx skills add constructive-io/constructive-skills
-
-# Individual repo skills (pgpm, testing, CLI, search, etc.)
-npx skills add https://github.com/constructive-io/constructive --skill pgpm
-npx skills add https://github.com/constructive-io/constructive --skill constructive-testing
-```
-
 ## Disclaimer
 
 AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.

package/deploy/schemas/jwt_public/procedures/current_principal_id.sql

@@ -0,0 +1,34 @@
+-- Deploy schemas/jwt_public/procedures/current_principal_id to pg
+-- Retrieves the current principal's ID from JWT claims with validation
+
+-- requires: schemas/jwt_public/schema
+
+BEGIN;
+
+-- Returns the current principal's UUID from the JWT claims
+-- Includes error handling for invalid UUID values
+-- Returns NULL if the claim is not set or invalid
+CREATE FUNCTION jwt_public.current_principal_id()
+  RETURNS uuid
+AS $$
+DECLARE
+  v_identifier_id uuid;
+BEGIN
+  IF current_setting('jwt.claims.principal_id', TRUE)
+    IS NOT NULL THEN
+    BEGIN
+      v_identifier_id = current_setting('jwt.claims.principal_id', TRUE)::uuid;
+    EXCEPTION
+      WHEN OTHERS THEN
+      RAISE NOTICE 'Invalid UUID value';
+    RETURN NULL;
+    END;
+    RETURN v_identifier_id;
+  ELSE
+    RETURN NULL;
+  END IF;
+END;
+$$
+LANGUAGE 'plpgsql' STABLE;
+
+COMMIT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgpm/jwt-claims",
-  "version": "0.28.0",
+  "version": "0.28.4",
   "description": "JWT claim handling and validation functions",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "contributors": [
@@ -21,11 +21,11 @@
     "test:watch": "jest --watch"
   },
   "devDependencies": {
-    "pgpm": "^4.23.2"
+    "pgpm": "^4.28.7"
   },
   "dependencies": {
-    "@pgpm/types": "0.28.0",
-    "@pgpm/verify": "0.28.0"
+    "@pgpm/types": "0.28.4",
+    "@pgpm/verify": "0.28.4"
   },
   "repository": {
     "type": "git",
@@ -35,5 +35,5 @@
   "bugs": {
     "url": "https://github.com/constructive-io/pgpm-modules/issues"
   },
-  "gitHead": "d2ab7ca810ded086eb742eb8f0ca362b6212b97e"
+  "gitHead": "08979b82f1f68af396b540c6ce0cda4b438d34f0"
 }

package/pgpm.plan

@@ -13,6 +13,7 @@ schemas/jwt_public/procedures/current_user_id [schemas/jwt_public/schema] 2020-1
 schemas/jwt_public/procedures/current_ip_address [schemas/jwt_public/schema] 2020-12-17T23:19:17Z Dan Lynch <dlynch@Dans-MBP-3> # add schemas/jwt_public/procedures/current_ip_address
 schemas/jwt_public/procedures/current_user_agent [schemas/jwt_public/schema] 2020-12-17T23:20:04Z Dan Lynch <dlynch@Dans-MBP-3> # add schemas/jwt_public/procedures/current_user_agent
 schemas/jwt_public/procedures/current_origin [schemas/jwt_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/jwt_public/procedures/current_origin
+schemas/jwt_public/procedures/current_principal_id [schemas/jwt_public/schema] 2026-06-26T02:05:00Z Dan Lynch <dlynch@constructive.io> # add schemas/jwt_public/procedures/current_principal_id
 schemas/jwt_private/schema 2020-12-17T06:47:34Z Dan Lynch <dlynch@Dans-MBP-3> # add schemas/jwt_private/schema
 schemas/jwt_private/procedures/current_database_id [schemas/jwt_private/schema] 2020-12-17T23:22:28Z Dan Lynch <dlynch@Dans-MBP-3> # add schemas/jwt_private/procedures/current_database_id
 schemas/jwt_private/procedures/current_token_id [schemas/jwt_private/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/jwt_private/procedures/current_token_id

package/revert/schemas/jwt_public/procedures/current_principal_id.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/jwt_public/procedures/current_principal_id from pg
+
+BEGIN;
+
+DROP FUNCTION IF EXISTS jwt_public.current_principal_id();
+
+COMMIT;

package/verify/schemas/jwt_public/procedures/current_principal_id.sql

@@ -0,0 +1,10 @@
+-- Verify schemas/jwt_public/procedures/current_principal_id on pg
+
+BEGIN;
+
+SELECT has_function_privilege(
+    'jwt_public.current_principal_id()',
+    'execute'
+);
+
+ROLLBACK;