node-type-registry 0.40.0 → 0.42.0

package/esm/codegen/generate-types.js

@@ -461,7 +461,7 @@ function buildBlueprintTableUniqueConstraint() {
 /**
  * Build the BlueprintBucketSeed interface.
  *
- * Matches the bucket entries in storage_config.buckets[].
+ * Matches the bucket entries in storage.buckets[].
  */
 function buildBlueprintBucketSeed() {
     return addJSDoc(exportInterface('BlueprintBucketSeed', [
@@ -471,12 +471,12 @@ function buildBlueprintBucketSeed() {
         addJSDoc(optionalProp('allowed_mime_types', t.tsArrayType(t.tsStringKeyword())), 'MIME type allowlist (e.g., ["image/png", "image/jpeg"]). NULL means all types allowed.'),
         addJSDoc(optionalProp('max_file_size', t.tsNumberKeyword()), 'Maximum file size in bytes for this bucket. NULL means no limit.'),
         addJSDoc(optionalProp('allowed_origins', t.tsArrayType(t.tsStringKeyword())), 'CORS allowed origins for this bucket.')
-    ]), 'A bucket seed entry for storage_config.buckets[]. Creates an initial bucket row in the {prefix}_buckets table during entity type provisioning. Only used for app-level storage (not entity-scoped).');
+    ]), 'A bucket seed entry for storage.buckets[]. Creates an initial bucket row in the {prefix}_buckets table during entity type provisioning. Only used for app-level storage (not entity-scoped).');
 }
 /**
  * Build the BlueprintStorageConfig interface.
  *
- * Matches the jsonb shape accepted by storage_config on entity_type_provision.
+ * Matches the jsonb shape accepted by storage on entity_type_provision.
  */
 function buildBlueprintStorageConfig() {
     return addJSDoc(exportInterface('BlueprintStorageConfig', [
@@ -529,6 +529,108 @@ function buildBlueprintAchievement() {
         addJSDoc(optionalProp('entity_prefix', t.tsStringKeyword()), 'Entity prefix to scope this achievement to (e.g., "org", "app"). Used to resolve the correct events_module. Defaults to "app".')
     ]), 'An achievement entry for the blueprint achievements[] section. Creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module).');
 }
+// ---------------------------------------------------------------------------
+// Module config types (namespace, function, agent, graph)
+// ---------------------------------------------------------------------------
+/**
+ * Build the BlueprintNamespaceConfig interface.
+ *
+ * Matches the jsonb shape accepted by namespaces on entity_type_provision
+ * and the top-level definition.namespaces[] array in construct_blueprint().
+ */
+function buildBlueprintNamespaceConfig() {
+    return addJSDoc(exportInterface('BlueprintNamespaceConfig', [
+        addJSDoc(optionalProp('scope', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('app')),
+            t.tsLiteralType(t.stringLiteral('org'))
+        ])), 'Namespace scope. "app" (default) creates app-level namespaces (membership_type = NULL). "org" creates per-org namespaces. Only used at the top level of a blueprint definition — entity-scoped namespaces inherit scope from the entity type.'),
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module namespaces. Defaults to "default" (omitted from table names). Non-default keys appear as an infix: {prefix}_{key}_namespaces.'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the namespaces table. NULL = apply defaults from apply_namespace_security().'),
+        addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
+            optionalProp('namespaces', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('namespace_events', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
+        ])), 'Per-table overrides for namespace tables. Each key targets a specific table (namespaces, namespace_events) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision.')
+    ]), 'Namespace module configuration. When used at the top level of a blueprint, the scope field controls whether namespaces are app-level ("app", default) or org-level ("org"). When used inside entity_types[], scope is inherited from the entity type. Provisions a namespaces table with computed-name proxy, rename trigger, and entity-scoped RLS.');
+}
+/**
+ * Build the BlueprintFunctionConfig interface.
+ *
+ * Matches the jsonb shape accepted by functions on entity_type_provision
+ * and the top-level definition.functions[] array in construct_blueprint().
+ */
+function buildBlueprintFunctionConfig() {
+    return addJSDoc(exportInterface('BlueprintFunctionConfig', [
+        addJSDoc(optionalProp('scope', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('app')),
+            t.tsLiteralType(t.stringLiteral('org'))
+        ])), 'Function scope. "app" (default) creates app-level functions (membership_type = NULL). "org" creates per-org functions. Only used at the top level of a blueprint definition — entity-scoped functions inherit scope from the entity type.'),
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module functions. Defaults to "default" (omitted from table names). Non-default keys appear as an infix: {prefix}_{key}_function_definitions.'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the function tables. NULL = apply defaults from apply_function_security().'),
+        addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
+            optionalProp('definitions', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('invocations', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('execution_logs', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
+        ])), 'Per-table overrides for function tables. Each key targets a specific table (definitions, invocations, execution_logs) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision.')
+    ]), 'Function module configuration. When used at the top level of a blueprint, the scope field controls whether functions are app-level ("app", default) or org-level ("org"). When used inside entity_types[], scope is inherited from the entity type. Provisions function_definitions, function_invocations (partitioned, 12-month retention), and function_execution_logs tables.');
+}
+/**
+ * Build the BlueprintAgentConfig interface.
+ *
+ * Matches the jsonb shape accepted by agents on entity_type_provision
+ * and the top-level definition.agents[] array in construct_blueprint().
+ */
+function buildBlueprintAgentConfig() {
+    return addJSDoc(exportInterface('BlueprintAgentConfig', [
+        addJSDoc(optionalProp('scope', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('app')),
+            t.tsLiteralType(t.stringLiteral('org'))
+        ])), 'Agent scope. "app" (default) creates app-level agent tables (membership_type = NULL). "org" creates per-org agent tables. Only used at the top level of a blueprint definition — entity-scoped agents inherit scope from the entity type.'),
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module agents. Defaults to "default" (omitted from table names). Non-default keys appear as an infix: {prefix}_{key}_agent_thread.'),
+        addJSDoc(optionalProp('api_name', t.tsStringKeyword()), 'API name for the agent module. Used in GraphQL naming. Defaults to "agent".'),
+        addJSDoc(optionalProp('has_knowledge', t.tsBooleanKeyword()), 'Whether to provision the agent_knowledge table with vector embeddings, tags, and trigger_phrases. Also inferred when a "knowledge" key is present. Defaults to false.'),
+        addJSDoc(optionalProp('knowledge', t.tsTypeLiteral([
+            optionalProp('has_chunks', t.tsBooleanKeyword()),
+            optionalProp('dimensions', t.tsNumberKeyword()),
+            optionalProp('chunk_size', t.tsNumberKeyword()),
+            optionalProp('chunk_overlap', t.tsNumberKeyword()),
+            optionalProp('chunk_strategy', t.tsUnionType([
+                t.tsLiteralType(t.stringLiteral('fixed')),
+                t.tsLiteralType(t.stringLiteral('sentence')),
+                t.tsLiteralType(t.stringLiteral('paragraph')),
+                t.tsLiteralType(t.stringLiteral('semantic'))
+            ])),
+            optionalProp('embedding_model', t.tsStringKeyword()),
+            optionalProp('embedding_provider', t.tsStringKeyword()),
+            optionalProp('search_indexes', t.tsArrayType(t.tsUnionType([
+                t.tsLiteralType(t.stringLiteral('fulltext')),
+                t.tsLiteralType(t.stringLiteral('bm25')),
+                t.tsLiteralType(t.stringLiteral('trigram'))
+            ])))
+        ])), 'Knowledge configuration overrides. Set has_chunks to false to disable the chunking pipeline. Controls vector dimensions, chunking strategy, embedding model/provider, and text search indexes for the agent_knowledge table. Presence implies has_knowledge = true.'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the agent tables. NULL = apply defaults from apply_agent_security().'),
+        addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
+            optionalProp('thread', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('message', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('task', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('prompt', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('knowledge', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
+        ])), 'Per-table overrides for agent tables. Each key targets a specific table (thread, message, task, prompt, knowledge) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision.')
+    ]), 'Agent module configuration. When used at the top level of a blueprint, the scope field controls whether agents are app-level ("app", default) or org-level ("org"). When used inside entity_types[], scope is inherited from the entity type. Provisions thread, message, task, prompt tables (and optionally knowledge with vector embeddings).');
+}
+/**
+ * Build the BlueprintGraphConfig interface.
+ *
+ * Matches the jsonb shape accepted by graphs on entity_type_provision.
+ * Graph module requires a merkle_store_module_id dependency, so
+ * entity_type_provision only registers permissions. The graph module itself
+ * must be provisioned separately with the merkle store dependency resolved.
+ */
+function buildBlueprintGraphConfig() {
+    return addJSDoc(exportInterface('BlueprintGraphConfig', [
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module graphs. Defaults to "default".'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the graph tables. NULL = apply defaults from apply_graph_security().')
+    ]), 'Graph module configuration. Presence triggers permission registration (manage_graphs, execute_graphs). The graph module requires a merkle_store_module_id dependency, so entity_type_provision only registers permissions here — the graph module itself must be provisioned separately.');
+}
 function buildBlueprintEntityTableProvision() {
     return addJSDoc(exportInterface('BlueprintEntityTableProvision', [
         addJSDoc(optionalProp('use_rls', t.tsBooleanKeyword()), 'Whether to enable RLS on the entity table. Forwarded to secure_table_provision. Defaults to true.'),
@@ -556,7 +658,11 @@ function buildBlueprintEntityType() {
         addJSDoc(optionalProp('has_invite_achievements', t.tsBooleanKeyword()), "Whether to auto-attach an EventTracker to the claimed_invites table for invite-based achievements. Requires has_invites=true AND has_levels=true. When true, records 'invite_claimed' events credited to the sender (inviter) on each claimed invite. Defaults to false."),
         addJSDoc(optionalProp('skip_entity_policies', t.tsBooleanKeyword()), 'Escape hatch: when true AND table_provision is NULL, zero policies are provisioned on the entity table. Defaults to false.'),
         addJSDoc(optionalProp('table_provision', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))), 'Override for the entity table. Shape mirrors BlueprintTable / secure_table_provision vocabulary. When supplied, its policies[] replaces the five default entity-table policies; is_visible becomes a no-op. When NULL (default), the five default policies are applied (gated by is_visible).'),
-        addJSDoc(optionalProp('storage', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintStorageConfig')))), 'Storage module configuration array. Each entry provisions a separate storage module with its own tables, RLS, and settings. When non-empty, has_storage is derived as true. Each entry may specify a storage_key for multi-module support (defaults to "default").')
+        addJSDoc(optionalProp('storage', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintStorageConfig')))), 'Storage module configuration array. Presence triggers provisioning (same inference model as namespaces, functions, agents). Each entry provisions a separate storage module with its own tables, RLS, and settings. Each entry may specify a storage_key for multi-module support (defaults to "default").'),
+        addJSDoc(optionalProp('namespaces', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintNamespaceConfig')))), 'Namespace module configuration array. Presence triggers provisioning. Each entry provisions a namespace_module with its own tables, computed-name proxy, and entity-scoped RLS. Registers manage_namespaces permission bit. "[{}]" = provision one default namespace module.'),
+        addJSDoc(optionalProp('functions', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFunctionConfig')))), 'Function module configuration array. Presence triggers provisioning. Each entry provisions function_definitions, function_invocations (partitioned), and function_execution_logs tables. Registers manage_functions + invoke_functions permission bits. "[{}]" = provision one default function module.'),
+        addJSDoc(optionalProp('agents', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAgentConfig')))), 'Agent module configuration array. Presence triggers provisioning. Each entry provisions thread, message, task, prompt tables (and optionally knowledge with vector embeddings). "[{}]" = provision one default agent module.'),
+        addJSDoc(optionalProp('graphs', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintGraphConfig')))), 'Graph module configuration array. Presence triggers permission registration (manage_graphs, execute_graphs). Graph module requires a merkle_store_module_id dependency, so entity_type_provision only registers permissions here. "[{}]" = register default graph permissions.')
     ]), 'An entity type entry for Phase 0 of construct_blueprint(). When name is provided, provisions a new entity type with its own entity table, membership modules, and security policies via entity_type_provision. When name is omitted and only prefix is given, extends an existing entity type (e.g., the built-in "org") with additional capabilities like storage — without creating a new entity type.');
 }
 function buildBlueprintTable() {
@@ -585,7 +691,10 @@ function buildBlueprintDefinition() {
         addJSDoc(optionalProp('unique_constraints', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintUniqueConstraint')))), 'Unique constraints on table columns.'),
         addJSDoc(optionalProp('entity_types', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintEntityType')))), 'Entity types to provision in Phase 0 (before tables). Each entry creates an entity table with membership modules and security.'),
         addJSDoc(optionalProp('storage', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintStorageConfig')))), 'Top-level storage configuration array. Each entry has an optional scope ("app" or "org"). App-scoped (default) creates storage_module with membership_type = NULL. Org-scoped creates per-org/user storage with owner_id and AFTER INSERT bucket seeding. When infra is installed, a private "functions" bucket is auto-injected into org-scoped entries. For child entity type storage, use entity_types[].storage instead.'),
-        addJSDoc(optionalProp('achievements', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievement')))), 'Achievement definitions. Each entry creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module).')
+        addJSDoc(optionalProp('achievements', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievement')))), 'Achievement definitions. Each entry creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module).'),
+        addJSDoc(optionalProp('namespaces', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintNamespaceConfig')))), 'Top-level namespace configuration array (Phase 0.6). Each entry has an optional scope ("app" or "org"). App-scoped (default) creates namespace_module with membership_type = NULL. Org-scoped creates per-org namespaces. For entity-scoped namespaces, use entity_types[].namespaces instead.'),
+        addJSDoc(optionalProp('functions', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFunctionConfig')))), 'Top-level function configuration array (Phase 0.6). Each entry has an optional scope ("app" or "org"). App-scoped (default) creates function_module with membership_type = NULL. Org-scoped creates per-org functions. For entity-scoped functions, use entity_types[].functions instead.'),
+        addJSDoc(optionalProp('agents', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAgentConfig')))), 'Top-level agent configuration array (Phase 0.6). Each entry has an optional scope ("app" or "org"). App-scoped (default) creates agent_module with membership_type = NULL. Org-scoped creates per-org agents. For entity-scoped agents, use entity_types[].agents instead.')
     ]), 'The complete blueprint definition -- the JSONB shape accepted by construct_blueprint().');
 }
 // ---------------------------------------------------------------------------
@@ -620,7 +729,7 @@ function buildProgram(meta) {
     statements.push(sectionComment('Shared recursive types'));
     statements.push(buildTriggerConditionInterface());
     // -- Parameter interfaces grouped by category --
-    const categoryOrder = ['billing', 'check', 'data', 'limit', 'search', 'job', 'process', 'authz', 'relation', 'view'];
+    const categoryOrder = ['billing', 'check', 'data', 'event', '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)
@@ -647,6 +756,10 @@ function buildProgram(meta) {
     statements.push(buildBlueprintAchievementRequirement());
     statements.push(buildBlueprintAchievementReward());
     statements.push(buildBlueprintAchievement());
+    statements.push(buildBlueprintNamespaceConfig());
+    statements.push(buildBlueprintFunctionConfig());
+    statements.push(buildBlueprintAgentConfig());
+    statements.push(buildBlueprintGraphConfig());
     statements.push(buildBlueprintEntityTableProvision());
     statements.push(buildBlueprintEntityType());
     // -- Node types discriminated union --

package/esm/data/data-member-owner.d.ts

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

package/esm/data/data-member-owner.js

@@ -0,0 +1,50 @@
+export const DataMemberOwner = {
+    name: 'DataMemberOwner',
+    slug: 'data_member_owner',
+    category: 'data',
+    display_name: 'Member Owner',
+    description: 'Adds owner_id and entity_id columns with a compound AuthzMemberOwner policy. The actor must own the row (owner_id = current_user_id()) AND be a member of the entity (entity_id in SPRT). Use for private data within an entity scope — e.g., personal chat threads that belong to the company but only the author can see.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            owner_field_name: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column name for the owner reference',
+                default: 'owner_id'
+            },
+            entity_field_name: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column name for the entity reference',
+                default: 'entity_id'
+            },
+            include_id: {
+                type: 'boolean',
+                description: 'If true, also adds a UUID primary key column with auto-generation',
+                default: true
+            },
+            include_user_fk: {
+                type: 'boolean',
+                description: 'If true, adds foreign key constraints from owner_id and entity_id to the users table',
+                default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates B-tree indexes on the owner and entity columns',
+                default: true
+            },
+            membership_type: {
+                type: 'integer',
+                description: 'Membership type for SPRT resolution. Required for entity-scoped provisioning.',
+                default: null
+            }
+        }
+    },
+    tags: [
+        'ownership',
+        'membership',
+        'security',
+        'schema'
+    ]
+};

package/esm/data/index.d.ts

@@ -12,6 +12,7 @@ export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
 export { DataJsonb } from './data-jsonb';
+export { DataMemberOwner } from './data-member-owner';
 export { DataOwnedFields } from './data-owned-fields';
 export { DataOwnershipInEntity } from './data-ownership-in-entity';
 export { DataPeoplestamps } from './data-peoplestamps';

package/esm/data/index.js

@@ -12,6 +12,7 @@ export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
 export { DataJsonb } from './data-jsonb';
+export { DataMemberOwner } from './data-member-owner';
 export { DataOwnedFields } from './data-owned-fields';
 export { DataOwnershipInEntity } from './data-ownership-in-entity';
 export { DataPeoplestamps } from './data-peoplestamps';

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_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.