node-type-registry 0.40.0 → 0.41.0

package/blueprint-types.generated.d.ts

@@ -327,6 +327,12 @@ export interface JobTriggerParams {
     condition_value?: string;
     conditions?: TriggerCondition | TriggerCondition[];
     watch_fields?: string[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     job_key?: string;
     queue_name?: string;
     priority?: number;
@@ -343,6 +349,13 @@ export interface ProcessChunksParams {
     metric?: 'cosine' | 'l2' | 'ip';
     chunks_table_name?: string;
     metadata_fields?: string[];
+    search_indexes?: ('fulltext' | 'bm25' | 'trigram')[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     enqueue_chunking_job?: boolean;
     chunking_task_name?: string;
 }
@@ -362,6 +375,12 @@ export interface ProcessFileEmbeddingParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     extraction?: {
         text_field?: string;
         metadata_field?: string;
@@ -393,6 +412,12 @@ export interface ProcessImageEmbeddingParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     extraction?: {
         text_field?: string;
         metadata_field?: string;
@@ -420,6 +445,12 @@ export interface ProcessExtractionParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     queue_name?: string;
     max_attempts?: number;
     priority?: number;
@@ -441,6 +472,12 @@ export interface ProcessImageVersionsParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     queue_name?: string;
     max_attempts?: number;
     priority?: number;

package/esm/blueprint-types.generated.d.ts

@@ -327,6 +327,12 @@ export interface JobTriggerParams {
     condition_value?: string;
     conditions?: TriggerCondition | TriggerCondition[];
     watch_fields?: string[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     job_key?: string;
     queue_name?: string;
     priority?: number;
@@ -343,6 +349,13 @@ export interface ProcessChunksParams {
     metric?: 'cosine' | 'l2' | 'ip';
     chunks_table_name?: string;
     metadata_fields?: string[];
+    search_indexes?: ('fulltext' | 'bm25' | 'trigram')[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     enqueue_chunking_job?: boolean;
     chunking_task_name?: string;
 }
@@ -362,6 +375,12 @@ export interface ProcessFileEmbeddingParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     extraction?: {
         text_field?: string;
         metadata_field?: string;
@@ -393,6 +412,12 @@ export interface ProcessImageEmbeddingParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     extraction?: {
         text_field?: string;
         metadata_field?: string;
@@ -420,6 +445,12 @@ export interface ProcessExtractionParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     queue_name?: string;
     max_attempts?: number;
     priority?: number;
@@ -441,6 +472,12 @@ export interface ProcessImageVersionsParams {
         [key: string]: unknown;
     };
     trigger_conditions?: TriggerCondition | TriggerCondition[];
+    entity_field?: string;
+    entity_lookup?: {
+        obj_table: string;
+        obj_schema?: string;
+        obj_field: string;
+    };
     queue_name?: string;
     max_attempts?: number;
     priority?: number;

package/esm/job/trigger.js

@@ -67,6 +67,34 @@ export const JobTrigger = {
                 default: false
             },
             ...conditionProperties,
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. For direct entity_id columns, just set this field. For FK lookups (e.g., channel_id → channels.entity_id), combine with entity_lookup.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Used when entity_field is a FK (e.g., channel_id) rather than a direct entity_id. The generator validates all fields against metaschema within the same database_id.',
+                properties: {
+                    obj_table: {
+                        type: 'string',
+                        description: 'Name of the related table to look up entity_id from (e.g., "channels"). Required.'
+                    },
+                    obj_schema: {
+                        type: 'string',
+                        description: 'Schema of the related table (user-facing name, e.g., "public"). Optional — if omitted, resolved by table name within the same database_id (raises error if ambiguous).'
+                    },
+                    obj_field: {
+                        type: 'string',
+                        format: 'column-ref',
+                        description: 'Column on the related table that holds the entity_id (e.g., "entity_id"). Required.'
+                    }
+                },
+                required: [
+                    'obj_table',
+                    'obj_field'
+                ]
+            },
             job_key: {
                 type: 'string',
                 description: 'Static job key for upsert semantics (prevents duplicate jobs)'

package/esm/module-presets/full.d.ts

@@ -1,13 +1,13 @@
 import type { ModulePreset } from './types';
 /**
- * `full` — install everything. Equivalent to the default
- * `provision_database_modules(v_modules => ARRAY['all'])` behavior.
+ * `full` — install every standard module.
  *
  * This is the maximalist preset: every module Constructive ships, including
- * `storage_module` for file uploads and `crypto_addresses_module` for
- * wallet-based sign-in. Use it for greenfield apps where you'd rather
- * disable features via `app_settings_auth` toggles than uninstall modules,
- * or for the "kitchen sink" example / demo databases.
+ * `storage_module:full` for file uploads with all feature flags and
+ * `crypto_addresses_module` for wallet-based sign-in.
+ *
+ * Usage logging modules (compute_log, inference_log, transfer_log,
+ * storage_log, db_usage) are NOT included — they are opt-in only.
  *
  * Prefer a more targeted preset for anything production-bound — installing
  * a module you'll never use still costs tables, triggers, and grants.

package/esm/module-presets/full.js

@@ -1,12 +1,12 @@
 /**
- * `full` — install everything. Equivalent to the default
- * `provision_database_modules(v_modules => ARRAY['all'])` behavior.
+ * `full` — install every standard module.
  *
  * This is the maximalist preset: every module Constructive ships, including
- * `storage_module` for file uploads and `crypto_addresses_module` for
- * wallet-based sign-in. Use it for greenfield apps where you'd rather
- * disable features via `app_settings_auth` toggles than uninstall modules,
- * or for the "kitchen sink" example / demo databases.
+ * `storage_module:full` for file uploads with all feature flags and
+ * `crypto_addresses_module` for wallet-based sign-in.
+ *
+ * Usage logging modules (compute_log, inference_log, transfer_log,
+ * storage_log, db_usage) are NOT included — they are opt-in only.
  *
  * Prefer a more targeted preset for anything production-bound — installing
  * a module you'll never use still costs tables, triggers, and grants.
@@ -14,25 +14,80 @@
 export const PresetFull = {
     name: 'full',
     display_name: 'Full (every module)',
-    summary: "Install every Constructive module. Equivalent to v_modules => ARRAY['all'].",
-    description: 'Installs every module in the catalog: everything in `b2b` plus `storage_module` ' +
-        'for file uploads and `crypto_addresses_module` / `crypto_auth_module` for ' +
-        'wallet-based sign-in. This matches the current default when `provision_database_modules` ' +
-        'is called without an explicit `v_modules` argument. Use it for fully-featured ' +
-        'demo/example databases, kitchen-sink reference deployments, or greenfield apps that ' +
-        'would rather feature-flag at the app_settings level than uninstall modules.',
+    summary: 'Install every standard Constructive module with explicit module list.',
+    description: 'Installs every standard module in the catalog: everything in `b2b` plus ' +
+        '`storage_module:full` for file uploads (versioning, content hash, custom keys, audit log), ' +
+        '`crypto_addresses_module` for wallet-based sign-in, `plans_module` and `billing_module` ' +
+        'for subscription management, `notifications_module` for in-app notifications, and ' +
+        '`events_module` at both app and org scopes. Usage logging modules are opt-in only — ' +
+        'add them explicitly if needed.',
     good_for: [
         'Reference / demo databases that showcase every Constructive feature',
         'Greenfield apps where the product scope is still open-ended',
-        'Keeping the provisioning call identical to the pre-preset default'
+        'Integration tests that need the full module stack'
     ],
     not_for: [
         'Production apps with a defined feature set — pick the narrowest preset that fits',
         'Resource-constrained environments — every module costs schema bloat, RLS policies, and grants'
     ],
-    modules: ['all'],
+    modules: [
+        // Core
+        'users_module',
+        'membership_types_module',
+        // App-level (membership_type = 1)
+        'permissions_module:app',
+        'limits_module:app',
+        'memberships_module:app',
+        'events_module:app',
+        'profiles_module:app',
+        // Org-level (membership_type = 2)
+        'permissions_module:org',
+        'limits_module:org',
+        'memberships_module:org',
+        'events_module:org',
+        'profiles_module:org',
+        // Hierarchy
+        'hierarchy_module:org',
+        // Billing & Plans
+        'plans_module',
+        'billing_module',
+        'rate_limit_meters_module',
+        'billing_provider_module',
+        // Auth infrastructure
+        'user_state_module',
+        'sessions_module',
+        'session_secrets_module',
+        'rate_limits_module',
+        'devices_module',
+        'config_secrets_user_module',
+        'rls_module',
+        // Contact modules
+        'emails_module',
+        'phone_numbers_module',
+        'crypto_addresses_module',
+        'webauthn_credentials_module',
+        'notifications_module',
+        // Connected accounts
+        'connected_accounts_module',
+        'identity_providers_module',
+        // Invites & Auth
+        'invites_module:app',
+        'invites_module:org',
+        'user_auth_module',
+        'webauthn_auth_module',
+        // Storage (full features)
+        'storage_module:full',
+    ],
     includes_notes: {
-        all: "Sentinel — the provisioner installs every known module when `modules = ['all']`."
+        'storage_module:full': 'All storage feature flags enabled: versioning, content hash, custom keys, audit log.',
+        billing_module: 'Metered billing with credits waterfall and period reset.',
+        plans_module: 'Subscription plan management with plan-governed caps.',
+        notifications_module: 'In-app notification system with read/unread tracking.'
+    },
+    omits_notes: {
+        compute_log_module: 'Usage logging is opt-in. Add explicitly if needed.',
+        inference_log_module: 'Usage logging is opt-in. Add explicitly if needed.',
+        agent_chat_module: 'Agent infrastructure is opt-in.'
     },
     extends: ['b2b']
 };

package/esm/process/chunks.js

@@ -93,6 +93,22 @@ export const ProcessChunks = {
                     'Omit to mirror the parent table\'s text search indexes. ' +
                     'Set explicitly to override (e.g. ["fulltext", "bm25"]).'
             },
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the parent table that holds (or references) the entity_id for billing scope. Forwarded to the chunking job trigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the chunking job trigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Job trigger ────────────────────────────────────────────────
             enqueue_chunking_job: {
                 type: 'boolean',

package/esm/process/extraction.js

@@ -82,6 +82,22 @@ export const ProcessExtraction = {
                 }
             },
             trigger_conditions: triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Job options ───────────────────────────────────────────────
             queue_name: {
                 type: 'string',

package/esm/process/file-embedding.js

@@ -89,6 +89,22 @@ export const ProcessFileEmbedding = {
                 }
             },
             trigger_conditions: triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',

package/esm/process/image-embedding.js

@@ -96,6 +96,22 @@ export const ProcessImageEmbedding = {
                 }
             },
             trigger_conditions: triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',

package/esm/process/image-versions.js

@@ -101,6 +101,22 @@ export const ProcessImageVersions = {
                 }
             },
             trigger_conditions: triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Job options ───────────────────────────────────────────────
             queue_name: {
                 type: 'string',

package/job/trigger.js

@@ -70,6 +70,34 @@ exports.JobTrigger = {
                 default: false
             },
             ...conditions_1.conditionProperties,
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. For direct entity_id columns, just set this field. For FK lookups (e.g., channel_id → channels.entity_id), combine with entity_lookup.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Used when entity_field is a FK (e.g., channel_id) rather than a direct entity_id. The generator validates all fields against metaschema within the same database_id.',
+                properties: {
+                    obj_table: {
+                        type: 'string',
+                        description: 'Name of the related table to look up entity_id from (e.g., "channels"). Required.'
+                    },
+                    obj_schema: {
+                        type: 'string',
+                        description: 'Schema of the related table (user-facing name, e.g., "public"). Optional — if omitted, resolved by table name within the same database_id (raises error if ambiguous).'
+                    },
+                    obj_field: {
+                        type: 'string',
+                        format: 'column-ref',
+                        description: 'Column on the related table that holds the entity_id (e.g., "entity_id"). Required.'
+                    }
+                },
+                required: [
+                    'obj_table',
+                    'obj_field'
+                ]
+            },
             job_key: {
                 type: 'string',
                 description: 'Static job key for upsert semantics (prevents duplicate jobs)'

package/module-presets/full.d.ts

@@ -1,13 +1,13 @@
 import type { ModulePreset } from './types';
 /**
- * `full` — install everything. Equivalent to the default
- * `provision_database_modules(v_modules => ARRAY['all'])` behavior.
+ * `full` — install every standard module.
  *
  * This is the maximalist preset: every module Constructive ships, including
- * `storage_module` for file uploads and `crypto_addresses_module` for
- * wallet-based sign-in. Use it for greenfield apps where you'd rather
- * disable features via `app_settings_auth` toggles than uninstall modules,
- * or for the "kitchen sink" example / demo databases.
+ * `storage_module:full` for file uploads with all feature flags and
+ * `crypto_addresses_module` for wallet-based sign-in.
+ *
+ * Usage logging modules (compute_log, inference_log, transfer_log,
+ * storage_log, db_usage) are NOT included — they are opt-in only.
  *
  * Prefer a more targeted preset for anything production-bound — installing
  * a module you'll never use still costs tables, triggers, and grants.

package/module-presets/full.js

@@ -2,14 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PresetFull = void 0;
 /**
- * `full` — install everything. Equivalent to the default
- * `provision_database_modules(v_modules => ARRAY['all'])` behavior.
+ * `full` — install every standard module.
  *
  * This is the maximalist preset: every module Constructive ships, including
- * `storage_module` for file uploads and `crypto_addresses_module` for
- * wallet-based sign-in. Use it for greenfield apps where you'd rather
- * disable features via `app_settings_auth` toggles than uninstall modules,
- * or for the "kitchen sink" example / demo databases.
+ * `storage_module:full` for file uploads with all feature flags and
+ * `crypto_addresses_module` for wallet-based sign-in.
+ *
+ * Usage logging modules (compute_log, inference_log, transfer_log,
+ * storage_log, db_usage) are NOT included — they are opt-in only.
  *
  * Prefer a more targeted preset for anything production-bound — installing
  * a module you'll never use still costs tables, triggers, and grants.
@@ -17,25 +17,80 @@ exports.PresetFull = void 0;
 exports.PresetFull = {
     name: 'full',
     display_name: 'Full (every module)',
-    summary: "Install every Constructive module. Equivalent to v_modules => ARRAY['all'].",
-    description: 'Installs every module in the catalog: everything in `b2b` plus `storage_module` ' +
-        'for file uploads and `crypto_addresses_module` / `crypto_auth_module` for ' +
-        'wallet-based sign-in. This matches the current default when `provision_database_modules` ' +
-        'is called without an explicit `v_modules` argument. Use it for fully-featured ' +
-        'demo/example databases, kitchen-sink reference deployments, or greenfield apps that ' +
-        'would rather feature-flag at the app_settings level than uninstall modules.',
+    summary: 'Install every standard Constructive module with explicit module list.',
+    description: 'Installs every standard module in the catalog: everything in `b2b` plus ' +
+        '`storage_module:full` for file uploads (versioning, content hash, custom keys, audit log), ' +
+        '`crypto_addresses_module` for wallet-based sign-in, `plans_module` and `billing_module` ' +
+        'for subscription management, `notifications_module` for in-app notifications, and ' +
+        '`events_module` at both app and org scopes. Usage logging modules are opt-in only — ' +
+        'add them explicitly if needed.',
     good_for: [
         'Reference / demo databases that showcase every Constructive feature',
         'Greenfield apps where the product scope is still open-ended',
-        'Keeping the provisioning call identical to the pre-preset default'
+        'Integration tests that need the full module stack'
     ],
     not_for: [
         'Production apps with a defined feature set — pick the narrowest preset that fits',
         'Resource-constrained environments — every module costs schema bloat, RLS policies, and grants'
     ],
-    modules: ['all'],
+    modules: [
+        // Core
+        'users_module',
+        'membership_types_module',
+        // App-level (membership_type = 1)
+        'permissions_module:app',
+        'limits_module:app',
+        'memberships_module:app',
+        'events_module:app',
+        'profiles_module:app',
+        // Org-level (membership_type = 2)
+        'permissions_module:org',
+        'limits_module:org',
+        'memberships_module:org',
+        'events_module:org',
+        'profiles_module:org',
+        // Hierarchy
+        'hierarchy_module:org',
+        // Billing & Plans
+        'plans_module',
+        'billing_module',
+        'rate_limit_meters_module',
+        'billing_provider_module',
+        // Auth infrastructure
+        'user_state_module',
+        'sessions_module',
+        'session_secrets_module',
+        'rate_limits_module',
+        'devices_module',
+        'config_secrets_user_module',
+        'rls_module',
+        // Contact modules
+        'emails_module',
+        'phone_numbers_module',
+        'crypto_addresses_module',
+        'webauthn_credentials_module',
+        'notifications_module',
+        // Connected accounts
+        'connected_accounts_module',
+        'identity_providers_module',
+        // Invites & Auth
+        'invites_module:app',
+        'invites_module:org',
+        'user_auth_module',
+        'webauthn_auth_module',
+        // Storage (full features)
+        'storage_module:full',
+    ],
     includes_notes: {
-        all: "Sentinel — the provisioner installs every known module when `modules = ['all']`."
+        'storage_module:full': 'All storage feature flags enabled: versioning, content hash, custom keys, audit log.',
+        billing_module: 'Metered billing with credits waterfall and period reset.',
+        plans_module: 'Subscription plan management with plan-governed caps.',
+        notifications_module: 'In-app notification system with read/unread tracking.'
+    },
+    omits_notes: {
+        compute_log_module: 'Usage logging is opt-in. Add explicitly if needed.',
+        inference_log_module: 'Usage logging is opt-in. Add explicitly if needed.',
+        agent_chat_module: 'Agent infrastructure is opt-in.'
     },
     extends: ['b2b']
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-type-registry",
-  "version": "0.40.0",
+  "version": "0.41.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",
@@ -33,8 +33,8 @@
     "@babel/generator": "^7.29.0",
     "@babel/types": "^7.29.0",
     "@pgsql/types": "^17.6.2",
-    "@pgsql/utils": "^17.8.15",
-    "pgsql-deparser": "^17.18.2",
+    "@pgsql/utils": "^17.8.17",
+    "pgsql-deparser": "^17.18.3",
     "schema-typescript": "^0.14.3"
   },
   "devDependencies": {
@@ -47,5 +47,5 @@
     "registry",
     "graphile"
   ],
-  "gitHead": "35e09818297d7ef14a0aa1ed723d7dd0de7cb83a"
+  "gitHead": "030e1144acbd4e288ee74eff2ac0021ca0382ef7"
 }

package/process/chunks.js

@@ -96,6 +96,22 @@ exports.ProcessChunks = {
                     'Omit to mirror the parent table\'s text search indexes. ' +
                     'Set explicitly to override (e.g. ["fulltext", "bm25"]).'
             },
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the parent table that holds (or references) the entity_id for billing scope. Forwarded to the chunking job trigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the chunking job trigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Job trigger ────────────────────────────────────────────────
             enqueue_chunking_job: {
                 type: 'boolean',

package/process/extraction.js

@@ -85,6 +85,22 @@ exports.ProcessExtraction = {
                 }
             },
             trigger_conditions: conditions_1.triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Job options ───────────────────────────────────────────────
             queue_name: {
                 type: 'string',

package/process/file-embedding.js

@@ -92,6 +92,22 @@ exports.ProcessFileEmbedding = {
                 }
             },
             trigger_conditions: conditions_1.triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',

package/process/image-embedding.js

@@ -99,6 +99,22 @@ exports.ProcessImageEmbedding = {
                 }
             },
             trigger_conditions: conditions_1.triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',

package/process/image-versions.js

@@ -104,6 +104,22 @@ exports.ProcessImageVersions = {
                 }
             },
             trigger_conditions: conditions_1.triggerConditionsProperty,
+            // ── Entity billing scope ──────────────────────────────────────
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the trigger table that holds (or references) the entity_id for billing scope. Forwarded to the composed JobTrigger.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Forwarded to the composed JobTrigger.',
+                properties: {
+                    obj_table: { type: 'string', description: 'Name of the related table to look up entity_id from' },
+                    obj_schema: { type: 'string', description: 'Schema of the related table (user-facing name, optional)' },
+                    obj_field: { type: 'string', format: 'column-ref', description: 'Column on the related table that holds the entity_id' }
+                },
+                required: ['obj_table', 'obj_field']
+            },
             // ── Job options ───────────────────────────────────────────────
             queue_name: {
                 type: 'string',