node-type-registry 0.47.0 → 0.49.0

package/README.md

@@ -135,6 +135,17 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 
 * [constructive-skills](https://github.com/constructive-io/constructive-skills): **📖 Platform documentation and AI agent skills** — feature catalog, blueprint reference, SDK guides (i18n, billing, limits, events, uploads, security, entities, search, AI), 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
+```
+
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/codegen/generate-types.js

@@ -827,7 +827,7 @@ function buildProgram(meta) {
     statements.push(buildFieldTypeInterface());
     statements.push(buildFieldDefaultInterface());
     // -- Parameter interfaces grouped by category --
-    const categoryOrder = ['billing', 'check', 'data', 'event', 'limit', 'limit_enforce', 'limit_track', 'limit_warning', 'search', 'job', 'process', 'authz', 'relation', 'view'];
+    const categoryOrder = ['billing', 'check', 'data', 'event', 'guard', 'limit', 'limit_enforce', 'limit_track', 'limit_warning', 'search', 'job', 'process', 'authz', 'relation', 'view'];
     for (const cat of categoryOrder) {
         const nts = categories.get(cat);
         if (!nts || nts.length === 0)

package/data/data-denormalized.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeDefinition } from '../types';
+export declare const DataDenormalized: NodeTypeDefinition;

package/data/data-denormalized.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataDenormalized = void 0;
+exports.DataDenormalized = {
+    name: 'DataDenormalized',
+    slug: 'data_denormalized',
+    category: 'data',
+    display_name: 'Denormalized Field',
+    description: 'Creates INSERT and UPDATE triggers that copy field values from a referenced (parent) table into the current table whenever the FK changes. Used to denormalize frequently-read columns (e.g. database_id on junction tables) so that RLS and queries can filter locally without joining.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'FK field on this table that references the parent row (e.g. view_id)'
+            },
+            set_fields: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'column-ref'
+                },
+                description: 'Field names on this table to be populated from the parent (e.g. ["database_id"])'
+            },
+            ref_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Field on the parent table that is the FK target (e.g. id)'
+            },
+            ref_fields: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'column-ref'
+                },
+                description: 'Field names on the parent table to copy from (e.g. ["database_id"])'
+            },
+            use_updates: {
+                type: 'boolean',
+                description: 'If true, also creates an UPDATE trigger so changes to the FK re-copy values',
+                default: true
+            },
+            update_defaults: {
+                type: 'boolean',
+                description: 'If true, sets the default value of set_fields to uuid_nil() so they are populated by the trigger',
+                default: true
+            },
+            func_name: {
+                type: 'string',
+                description: 'Custom function name suffix (defaults to the FK field name)'
+            },
+            func_order: {
+                type: 'integer',
+                description: 'Trigger ordering (0-padded). Lower numbers fire first',
+                default: 0
+            }
+        },
+        required: [
+            'field',
+            'set_fields',
+            'ref_field',
+            'ref_fields'
+        ]
+    },
+    tags: [
+        'trigger',
+        'denormalization',
+        'schema'
+    ]
+};

package/data/index.d.ts

@@ -3,6 +3,7 @@ export { CheckLessThan } from './check-less-than';
 export { CheckNotEqual } from './check-not-equal';
 export { CheckOneOf } from './check-one-of';
 export { DataBulk } from './data-bulk';
+export { DataDenormalized } from './data-denormalized';
 export { DataCompositeField } from './data-composite-field';
 export { DataDirectOwner } from './data-direct-owner';
 export { DataEntityMembership } from './data-entity-membership';

package/data/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TableUserSettings = exports.TableUserProfiles = exports.TableOrganizationSettings = exports.SearchVector = exports.SearchUnified = exports.SearchTrgm = exports.SearchSpatialAggregate = exports.SearchSpatial = exports.SearchFullText = exports.SearchBm25 = exports.DataTimestamps = exports.DataTags = exports.DataStatusField = exports.DataSoftDelete = exports.DataSlug = exports.DataRealtime = exports.DataPublishable = exports.DataPeoplestamps = exports.DataOwnershipInEntity = exports.DataOwnedFields = exports.DataMemberOwner = exports.DataJsonb = exports.DataInheritFromParent = exports.DataInflection = exports.DataImmutableFields = exports.DataId = exports.DataI18n = exports.DataForceCurrentUser = exports.DataEntityMembership = exports.DataDirectOwner = exports.DataCompositeField = exports.DataBulk = exports.CheckOneOf = exports.CheckNotEqual = exports.CheckLessThan = exports.CheckGreaterThan = void 0;
+exports.TableUserSettings = exports.TableUserProfiles = exports.TableOrganizationSettings = exports.SearchVector = exports.SearchUnified = exports.SearchTrgm = exports.SearchSpatialAggregate = exports.SearchSpatial = exports.SearchFullText = exports.SearchBm25 = exports.DataTimestamps = exports.DataTags = exports.DataStatusField = exports.DataSoftDelete = exports.DataSlug = exports.DataRealtime = exports.DataPublishable = exports.DataPeoplestamps = exports.DataOwnershipInEntity = exports.DataOwnedFields = exports.DataMemberOwner = exports.DataJsonb = exports.DataInheritFromParent = exports.DataInflection = exports.DataImmutableFields = exports.DataId = exports.DataI18n = exports.DataForceCurrentUser = exports.DataEntityMembership = exports.DataDirectOwner = exports.DataCompositeField = exports.DataDenormalized = exports.DataBulk = exports.CheckOneOf = exports.CheckNotEqual = exports.CheckLessThan = exports.CheckGreaterThan = void 0;
 var check_greater_than_1 = require("./check-greater-than");
 Object.defineProperty(exports, "CheckGreaterThan", { enumerable: true, get: function () { return check_greater_than_1.CheckGreaterThan; } });
 var check_less_than_1 = require("./check-less-than");
@@ -11,6 +11,8 @@ var check_one_of_1 = require("./check-one-of");
 Object.defineProperty(exports, "CheckOneOf", { enumerable: true, get: function () { return check_one_of_1.CheckOneOf; } });
 var data_bulk_1 = require("./data-bulk");
 Object.defineProperty(exports, "DataBulk", { enumerable: true, get: function () { return data_bulk_1.DataBulk; } });
+var data_denormalized_1 = require("./data-denormalized");
+Object.defineProperty(exports, "DataDenormalized", { enumerable: true, get: function () { return data_denormalized_1.DataDenormalized; } });
 var data_composite_field_1 = require("./data-composite-field");
 Object.defineProperty(exports, "DataCompositeField", { enumerable: true, get: function () { return data_composite_field_1.DataCompositeField; } });
 var data_direct_owner_1 = require("./data-direct-owner");

package/esm/codegen/generate-types.js

@@ -792,7 +792,7 @@ function buildProgram(meta) {
     statements.push(buildFieldTypeInterface());
     statements.push(buildFieldDefaultInterface());
     // -- Parameter interfaces grouped by category --
-    const categoryOrder = ['billing', 'check', 'data', 'event', 'limit', 'limit_enforce', 'limit_track', 'limit_warning', 'search', 'job', 'process', 'authz', 'relation', 'view'];
+    const categoryOrder = ['billing', 'check', 'data', 'event', 'guard', 'limit', 'limit_enforce', 'limit_track', 'limit_warning', 'search', 'job', 'process', 'authz', 'relation', 'view'];
     for (const cat of categoryOrder) {
         const nts = categories.get(cat);
         if (!nts || nts.length === 0)

package/esm/data/data-denormalized.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeDefinition } from '../types';
+export declare const DataDenormalized: NodeTypeDefinition;

package/esm/data/data-denormalized.js

@@ -0,0 +1,68 @@
+export const DataDenormalized = {
+    name: 'DataDenormalized',
+    slug: 'data_denormalized',
+    category: 'data',
+    display_name: 'Denormalized Field',
+    description: 'Creates INSERT and UPDATE triggers that copy field values from a referenced (parent) table into the current table whenever the FK changes. Used to denormalize frequently-read columns (e.g. database_id on junction tables) so that RLS and queries can filter locally without joining.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'FK field on this table that references the parent row (e.g. view_id)'
+            },
+            set_fields: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'column-ref'
+                },
+                description: 'Field names on this table to be populated from the parent (e.g. ["database_id"])'
+            },
+            ref_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Field on the parent table that is the FK target (e.g. id)'
+            },
+            ref_fields: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    format: 'column-ref'
+                },
+                description: 'Field names on the parent table to copy from (e.g. ["database_id"])'
+            },
+            use_updates: {
+                type: 'boolean',
+                description: 'If true, also creates an UPDATE trigger so changes to the FK re-copy values',
+                default: true
+            },
+            update_defaults: {
+                type: 'boolean',
+                description: 'If true, sets the default value of set_fields to uuid_nil() so they are populated by the trigger',
+                default: true
+            },
+            func_name: {
+                type: 'string',
+                description: 'Custom function name suffix (defaults to the FK field name)'
+            },
+            func_order: {
+                type: 'integer',
+                description: 'Trigger ordering (0-padded). Lower numbers fire first',
+                default: 0
+            }
+        },
+        required: [
+            'field',
+            'set_fields',
+            'ref_field',
+            'ref_fields'
+        ]
+    },
+    tags: [
+        'trigger',
+        'denormalization',
+        'schema'
+    ]
+};

package/esm/data/index.d.ts

@@ -3,6 +3,7 @@ export { CheckLessThan } from './check-less-than';
 export { CheckNotEqual } from './check-not-equal';
 export { CheckOneOf } from './check-one-of';
 export { DataBulk } from './data-bulk';
+export { DataDenormalized } from './data-denormalized';
 export { DataCompositeField } from './data-composite-field';
 export { DataDirectOwner } from './data-direct-owner';
 export { DataEntityMembership } from './data-entity-membership';

package/esm/data/index.js

@@ -3,6 +3,7 @@ export { CheckLessThan } from './check-less-than';
 export { CheckNotEqual } from './check-not-equal';
 export { CheckOneOf } from './check-one-of';
 export { DataBulk } from './data-bulk';
+export { DataDenormalized } from './data-denormalized';
 export { DataCompositeField } from './data-composite-field';
 export { DataDirectOwner } from './data-direct-owner';
 export { DataEntityMembership } from './data-entity-membership';

package/esm/guard/index.d.ts

@@ -0,0 +1 @@
+export { GuardStepUp } from './step-up';

package/esm/guard/index.js

@@ -0,0 +1 @@
+export { GuardStepUp } from './step-up';

package/esm/guard/step-up.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeDefinition } from '../types';
+export declare const GuardStepUp: NodeTypeDefinition;

package/esm/guard/step-up.js

@@ -0,0 +1,37 @@
+import { conditionDefs, conditionProperties } from '../conditions';
+export const GuardStepUp = {
+    name: 'GuardStepUp',
+    slug: 'guard_step_up',
+    category: 'guard',
+    display_name: 'Guard Step-Up',
+    description: 'Attaches a BEFORE trigger that calls require_step_up() to enforce recent ' +
+        'password or MFA verification before allowing mutations. Requires a ' +
+        'provisioned sessions_module (with app_settings_auth) for the target database. ' +
+        'The step_up_window is read from app_settings_auth at runtime (default 30 minutes). ' +
+        'Supports compound conditions (AND/OR/NOT), watch_fields (fire only when specific ' +
+        'fields change), and simple condition_field/condition_value leaf conditions.',
+    parameter_schema: {
+        type: 'object',
+        $defs: conditionDefs,
+        properties: {
+            step_up_type: {
+                type: 'string',
+                enum: ['password', 'mfa', 'password_or_mfa'],
+                description: 'Which verification method satisfies the step-up requirement',
+                default: 'password_or_mfa',
+            },
+            events: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['INSERT', 'UPDATE', 'DELETE'],
+                },
+                description: 'Which DML events require step-up verification',
+                default: ['UPDATE', 'DELETE'],
+            },
+            ...conditionProperties,
+        },
+        required: [],
+    },
+    tags: ['guard', 'triggers', 'auth', 'step-up', 'mfa', 'security'],
+};

package/esm/index.d.ts

@@ -3,6 +3,7 @@ export * from './blueprint-types.generated';
 export * from './conditions';
 export * from './data';
 export * from './event';
+export * from './guard';
 export * from './job';
 export * from './limit';
 export * from './module-presets';

package/esm/index.js

@@ -3,6 +3,7 @@ export * from './blueprint-types.generated';
 export * from './conditions';
 export * from './data';
 export * from './event';
+export * from './guard';
 export * from './job';
 export * from './limit';
 export * from './module-presets';
@@ -12,6 +13,7 @@ export * from './view';
 import * as authz from './authz';
 import * as data from './data';
 import * as event from './event';
+import * as guard from './guard';
 import * as job from './job';
 import * as limit from './limit';
 import * as process from './process';
@@ -21,6 +23,7 @@ export const allNodeTypes = [
     ...Object.values(authz),
     ...Object.values(data),
     ...Object.values(event),
+    ...Object.values(guard),
     ...Object.values(job),
     ...Object.values(limit),
     ...Object.values(process),

package/guard/index.d.ts

@@ -0,0 +1 @@
+export { GuardStepUp } from './step-up';

package/guard/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuardStepUp = void 0;
+var step_up_1 = require("./step-up");
+Object.defineProperty(exports, "GuardStepUp", { enumerable: true, get: function () { return step_up_1.GuardStepUp; } });

package/guard/step-up.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeDefinition } from '../types';
+export declare const GuardStepUp: NodeTypeDefinition;

package/guard/step-up.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuardStepUp = void 0;
+const conditions_1 = require("../conditions");
+exports.GuardStepUp = {
+    name: 'GuardStepUp',
+    slug: 'guard_step_up',
+    category: 'guard',
+    display_name: 'Guard Step-Up',
+    description: 'Attaches a BEFORE trigger that calls require_step_up() to enforce recent ' +
+        'password or MFA verification before allowing mutations. Requires a ' +
+        'provisioned sessions_module (with app_settings_auth) for the target database. ' +
+        'The step_up_window is read from app_settings_auth at runtime (default 30 minutes). ' +
+        'Supports compound conditions (AND/OR/NOT), watch_fields (fire only when specific ' +
+        'fields change), and simple condition_field/condition_value leaf conditions.',
+    parameter_schema: {
+        type: 'object',
+        $defs: conditions_1.conditionDefs,
+        properties: {
+            step_up_type: {
+                type: 'string',
+                enum: ['password', 'mfa', 'password_or_mfa'],
+                description: 'Which verification method satisfies the step-up requirement',
+                default: 'password_or_mfa',
+            },
+            events: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['INSERT', 'UPDATE', 'DELETE'],
+                },
+                description: 'Which DML events require step-up verification',
+                default: ['UPDATE', 'DELETE'],
+            },
+            ...conditions_1.conditionProperties,
+        },
+        required: [],
+    },
+    tags: ['guard', 'triggers', 'auth', 'step-up', 'mfa', 'security'],
+};

package/index.d.ts

@@ -3,6 +3,7 @@ export * from './blueprint-types.generated';
 export * from './conditions';
 export * from './data';
 export * from './event';
+export * from './guard';
 export * from './job';
 export * from './limit';
 export * from './module-presets';

package/index.js

@@ -42,6 +42,7 @@ __exportStar(require("./blueprint-types.generated"), exports);
 __exportStar(require("./conditions"), exports);
 __exportStar(require("./data"), exports);
 __exportStar(require("./event"), exports);
+__exportStar(require("./guard"), exports);
 __exportStar(require("./job"), exports);
 __exportStar(require("./limit"), exports);
 __exportStar(require("./module-presets"), exports);
@@ -51,6 +52,7 @@ __exportStar(require("./view"), exports);
 const authz = __importStar(require("./authz"));
 const data = __importStar(require("./data"));
 const event = __importStar(require("./event"));
+const guard = __importStar(require("./guard"));
 const job = __importStar(require("./job"));
 const limit = __importStar(require("./limit"));
 const process = __importStar(require("./process"));
@@ -60,6 +62,7 @@ exports.allNodeTypes = [
     ...Object.values(authz),
     ...Object.values(data),
     ...Object.values(event),
+    ...Object.values(guard),
     ...Object.values(job),
     ...Object.values(limit),
     ...Object.values(process),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-type-registry",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "description": "Node type definitions for the Constructive blueprint system. Single source of truth for all Authz*, Data*, Relation*, and View* node types.",
   "author": "Constructive <developers@constructive.io>",
   "main": "index.js",
@@ -47,5 +47,5 @@
     "registry",
     "graphile"
   ],
-  "gitHead": "c9ff6a6cec5d8cb455010b190b78c3d055097981"
+  "gitHead": "6d810d1b800a6e70ef25749415b69de17b066e50"
 }