node-type-registry 0.36.0 → 0.37.0

package/data/data-meter-rate-limit.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitEnforceRate = void 0;
+exports.LimitEnforceRate = {
+    name: 'LimitEnforceRate',
+    slug: 'limit_enforce_rate',
+    category: 'limit_enforce',
+    display_name: 'Enforce Rate Limit',
+    description: 'Attaches a BEFORE trigger that calls check_rate_limit() to enforce sliding-window rate limits before allowing mutations. The function checks all three scopes (entity, actor-in-entity, actor) in a single call; which scopes are actually enforced is controlled by what rows exist in rate_window_limits (plan-based config). Requires a provisioned meter_rate_limits_module and billing_module for the target database.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            meter_slug: {
+                type: 'string',
+                description: 'Slug of the billing meter to check rate limits against (must match a meters table entry, e.g. "messaging", "inference")',
+            },
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the target table that holds the entity id (org) for rate limiting',
+                default: 'entity_id',
+            },
+            actor_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the target table that holds the actor id (user) for rate limiting',
+                default: 'owner_id',
+            },
+            events: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['INSERT', 'UPDATE'],
+                },
+                description: 'Which DML events to enforce rate limits on (DELETE is excluded since it reduces load)',
+                default: ['INSERT'],
+            },
+        },
+        required: ['meter_slug'],
+    },
+    tags: ['rate-limits', 'triggers', 'enforce', 'metering', 'abuse-protection'],
+};

package/data/event-tracker.d.ts

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

package/data/event-tracker.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventTracker = void 0;
+const conditions_1 = require("../conditions");
+exports.EventTracker = {
+    name: 'EventTracker',
+    slug: 'event_tracker',
+    category: 'event',
+    display_name: 'Event Tracker',
+    description: 'Creates triggers that record events via the events module when table rows change. ' +
+        'Supports the same compound condition system as JobTrigger (condition_field, watch_fields, ' +
+        'or full AND/OR/NOT conditions). Events are recorded to app_events and aggregated ' +
+        'automatically. Use with achievements (blueprint-level) to unlock levels and grant ' +
+        'credits based on event accumulation.',
+    parameter_schema: {
+        type: 'object',
+        $defs: conditions_1.conditionDefs,
+        properties: {
+            event_name: {
+                type: 'string',
+                description: 'Event type name to record (e.g., "avatar_uploaded", "order_completed")'
+            },
+            events: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: [
+                        'INSERT',
+                        'UPDATE',
+                        'DELETE'
+                    ]
+                },
+                description: 'DML events that trigger recording',
+                default: ['INSERT']
+            },
+            count: {
+                type: 'integer',
+                description: 'Number of events to record per trigger fire',
+                default: 1
+            },
+            toggle: {
+                type: 'boolean',
+                description: 'Toggle mode: records event when condition is met, removes when condition is unmet',
+                default: false
+            },
+            actor_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column containing the actor (user) ID to attribute the event to',
+                default: 'owner_id'
+            },
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column containing the entity ID (org/group) for entity-scoped events. Omit for user-only events.'
+            },
+            auto_register_type: {
+                type: 'boolean',
+                description: 'Automatically register the event_name in event_types during provisioning',
+                default: true
+            },
+            ...conditions_1.conditionProperties
+        },
+        required: [
+            'event_name'
+        ]
+    },
+    tags: [
+        'events',
+        'triggers',
+        'analytics',
+        'tracking'
+    ]
+};

package/data/index.d.ts

@@ -2,15 +2,16 @@ export { CheckGreaterThan } from './check-greater-than';
 export { CheckLessThan } from './check-less-than';
 export { CheckNotEqual } from './check-not-equal';
 export { CheckOneOf } from './check-one-of';
-export { LimitAggregate } from './data-aggregate-limit-counter';
-export { BillingMeter } from './data-billing-meter';
+export { LimitEnforceAggregate } from './data-aggregate-limit-counter';
+export { LimitTrackUsage } from './data-billing-meter';
 export { DataBulk } from './data-bulk';
 export { ProcessChunks } from './data-chunks';
 export { DataCompositeField } from './data-composite-field';
 export { DataDirectOwner } from './data-direct-owner';
 export { DataEntityMembership } from './data-entity-membership';
+export { EventTracker } from './event-tracker';
 export { ProcessFileEmbedding } from './data-file-embedding';
-export { LimitFeatureFlag } from './data-feature-flag';
+export { LimitEnforceFeature } from './data-feature-flag';
 export { DataForceCurrentUser } from './data-force-current-user';
 export { DataId } from './data-id';
 export { ProcessImageEmbedding } from './data-image-embedding';
@@ -18,7 +19,11 @@ export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
 export { JobTrigger } from './data-job-trigger';
-export { LimitCounter } from './data-limit-counter';
+export { LimitEnforceCounter } from './data-limit-counter';
+export { LimitEnforceRate } from './data-meter-rate-limit';
+export { LimitWarningCounter } from './limit-warning-counter';
+export { LimitWarningAggregate } from './limit-warning-aggregate';
+export { LimitWarningRate } from './limit-warning-rate';
 export { DataJsonb } from './data-jsonb';
 export { DataOwnedFields } from './data-owned-fields';
 export { ProcessExtraction } from './process-extraction';

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.ProcessImageVersions = exports.ProcessExtraction = exports.DataOwnedFields = exports.DataJsonb = exports.LimitCounter = exports.JobTrigger = exports.DataInheritFromParent = exports.DataInflection = exports.DataImmutableFields = exports.ProcessImageEmbedding = exports.DataId = exports.DataForceCurrentUser = exports.LimitFeatureFlag = exports.ProcessFileEmbedding = exports.DataEntityMembership = exports.DataDirectOwner = exports.DataCompositeField = exports.ProcessChunks = exports.DataBulk = exports.BillingMeter = exports.LimitAggregate = 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.ProcessImageVersions = exports.ProcessExtraction = exports.DataOwnedFields = exports.DataJsonb = exports.LimitWarningRate = exports.LimitWarningAggregate = exports.LimitWarningCounter = exports.LimitEnforceRate = exports.LimitEnforceCounter = exports.JobTrigger = exports.DataInheritFromParent = exports.DataInflection = exports.DataImmutableFields = exports.ProcessImageEmbedding = exports.DataId = exports.DataForceCurrentUser = exports.LimitEnforceFeature = exports.ProcessFileEmbedding = exports.EventTracker = exports.DataEntityMembership = exports.DataDirectOwner = exports.DataCompositeField = exports.ProcessChunks = exports.DataBulk = exports.LimitTrackUsage = exports.LimitEnforceAggregate = 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");
@@ -10,9 +10,9 @@ Object.defineProperty(exports, "CheckNotEqual", { enumerable: true, get: functio
 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_aggregate_limit_counter_1 = require("./data-aggregate-limit-counter");
-Object.defineProperty(exports, "LimitAggregate", { enumerable: true, get: function () { return data_aggregate_limit_counter_1.LimitAggregate; } });
+Object.defineProperty(exports, "LimitEnforceAggregate", { enumerable: true, get: function () { return data_aggregate_limit_counter_1.LimitEnforceAggregate; } });
 var data_billing_meter_1 = require("./data-billing-meter");
-Object.defineProperty(exports, "BillingMeter", { enumerable: true, get: function () { return data_billing_meter_1.BillingMeter; } });
+Object.defineProperty(exports, "LimitTrackUsage", { enumerable: true, get: function () { return data_billing_meter_1.LimitTrackUsage; } });
 var data_bulk_1 = require("./data-bulk");
 Object.defineProperty(exports, "DataBulk", { enumerable: true, get: function () { return data_bulk_1.DataBulk; } });
 var data_chunks_1 = require("./data-chunks");
@@ -23,10 +23,12 @@ var data_direct_owner_1 = require("./data-direct-owner");
 Object.defineProperty(exports, "DataDirectOwner", { enumerable: true, get: function () { return data_direct_owner_1.DataDirectOwner; } });
 var data_entity_membership_1 = require("./data-entity-membership");
 Object.defineProperty(exports, "DataEntityMembership", { enumerable: true, get: function () { return data_entity_membership_1.DataEntityMembership; } });
+var event_tracker_1 = require("./event-tracker");
+Object.defineProperty(exports, "EventTracker", { enumerable: true, get: function () { return event_tracker_1.EventTracker; } });
 var data_file_embedding_1 = require("./data-file-embedding");
 Object.defineProperty(exports, "ProcessFileEmbedding", { enumerable: true, get: function () { return data_file_embedding_1.ProcessFileEmbedding; } });
 var data_feature_flag_1 = require("./data-feature-flag");
-Object.defineProperty(exports, "LimitFeatureFlag", { enumerable: true, get: function () { return data_feature_flag_1.LimitFeatureFlag; } });
+Object.defineProperty(exports, "LimitEnforceFeature", { enumerable: true, get: function () { return data_feature_flag_1.LimitEnforceFeature; } });
 var data_force_current_user_1 = require("./data-force-current-user");
 Object.defineProperty(exports, "DataForceCurrentUser", { enumerable: true, get: function () { return data_force_current_user_1.DataForceCurrentUser; } });
 var data_id_1 = require("./data-id");
@@ -42,7 +44,15 @@ Object.defineProperty(exports, "DataInheritFromParent", { enumerable: true, get:
 var data_job_trigger_1 = require("./data-job-trigger");
 Object.defineProperty(exports, "JobTrigger", { enumerable: true, get: function () { return data_job_trigger_1.JobTrigger; } });
 var data_limit_counter_1 = require("./data-limit-counter");
-Object.defineProperty(exports, "LimitCounter", { enumerable: true, get: function () { return data_limit_counter_1.LimitCounter; } });
+Object.defineProperty(exports, "LimitEnforceCounter", { enumerable: true, get: function () { return data_limit_counter_1.LimitEnforceCounter; } });
+var data_meter_rate_limit_1 = require("./data-meter-rate-limit");
+Object.defineProperty(exports, "LimitEnforceRate", { enumerable: true, get: function () { return data_meter_rate_limit_1.LimitEnforceRate; } });
+var limit_warning_counter_1 = require("./limit-warning-counter");
+Object.defineProperty(exports, "LimitWarningCounter", { enumerable: true, get: function () { return limit_warning_counter_1.LimitWarningCounter; } });
+var limit_warning_aggregate_1 = require("./limit-warning-aggregate");
+Object.defineProperty(exports, "LimitWarningAggregate", { enumerable: true, get: function () { return limit_warning_aggregate_1.LimitWarningAggregate; } });
+var limit_warning_rate_1 = require("./limit-warning-rate");
+Object.defineProperty(exports, "LimitWarningRate", { enumerable: true, get: function () { return limit_warning_rate_1.LimitWarningRate; } });
 var data_jsonb_1 = require("./data-jsonb");
 Object.defineProperty(exports, "DataJsonb", { enumerable: true, get: function () { return data_jsonb_1.DataJsonb; } });
 var data_owned_fields_1 = require("./data-owned-fields");

package/data/limit-warning-aggregate.d.ts

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

package/data/limit-warning-aggregate.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitWarningAggregate = void 0;
+exports.LimitWarningAggregate = {
+    name: 'LimitWarningAggregate',
+    slug: 'limit_warning_aggregate',
+    category: 'limit_warning',
+    display_name: 'Warning Aggregate',
+    description: 'Attaches an AFTER INSERT trigger that checks if the entity\'s aggregate usage has crossed any warning threshold configured in the limit_warnings table. If a threshold is reached for the first time, enqueues a background job (e.g. email notification). Uses limit_warning_state for one-time dedup per warning/actor/entity triple. Requires a provisioned limits_module with limit_warnings and aggregate limits enabled.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            limit_name: {
+                type: 'string',
+                description: 'Name of the aggregate limit to watch (must match a limit_warnings.name entry, e.g. "databases", "members")',
+            },
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the target table that holds the entity id for aggregate limit lookup',
+                default: 'entity_id',
+            },
+        },
+        required: ['limit_name'],
+    },
+    tags: ['limits', 'triggers', 'aggregates', 'warning', 'notifications'],
+};

package/data/limit-warning-counter.d.ts

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

package/data/limit-warning-counter.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitWarningCounter = void 0;
+exports.LimitWarningCounter = {
+    name: 'LimitWarningCounter',
+    slug: 'limit_warning_counter',
+    category: 'limit_warning',
+    display_name: 'Warning Counter',
+    description: 'Attaches an AFTER INSERT trigger that checks if the actor\'s current usage has crossed any warning threshold configured in the limit_warnings table. If a threshold is reached for the first time, enqueues a background job (e.g. email notification). Uses limit_warning_state for one-time dedup per warning/actor pair. Requires a provisioned limits_module with limit_warnings enabled.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            limit_name: {
+                type: 'string',
+                description: 'Name of the limit to watch (must match a limit_warnings.name entry, e.g. "projects", "members")',
+            },
+            scope: {
+                type: 'string',
+                enum: ['app', 'org'],
+                description: 'Limit scope: "app" (membership_type=1, user-level) or "org" (membership_type=2, entity-level)',
+                default: 'app',
+            },
+            actor_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the target table that holds the actor id for limit lookup',
+                default: 'owner_id',
+            },
+        },
+        required: ['limit_name'],
+    },
+    tags: ['limits', 'triggers', 'warning', 'notifications'],
+};

package/data/limit-warning-rate.d.ts

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

package/data/limit-warning-rate.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitWarningRate = void 0;
+exports.LimitWarningRate = {
+    name: 'LimitWarningRate',
+    slug: 'limit_warning_rate',
+    category: 'limit_warning',
+    display_name: 'Warning Rate Limit',
+    description: 'Attaches an AFTER INSERT trigger that checks if the actor\'s current request count in the active sliding window has crossed any warning threshold configured in the limit_warnings table. If a threshold is reached for the first time, enqueues a background job (e.g. email notification). Uses limit_warning_state for one-time dedup per warning/actor pair. Requires both a limits_module with limit_warnings enabled and a rate_limit_meters_module.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            meter_slug: {
+                type: 'string',
+                description: 'Slug of the billing meter to check rate limits against (must match a meters table entry)',
+            },
+            entity_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the target table that holds the entity id for rate limit lookup',
+                default: 'entity_id',
+            },
+            actor_field: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column on the target table that holds the actor id for rate limit lookup',
+                default: 'owner_id',
+            },
+        },
+        required: ['meter_slug'],
+    },
+    tags: ['rate-limits', 'triggers', 'warning', 'notifications', 'metering'],
+};

package/data/process-extraction.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessExtraction = void 0;
+const conditions_1 = require("../conditions");
 /**
  * File extraction processing node.
  *
@@ -25,6 +26,7 @@ exports.ProcessExtraction = {
         'Typically used upstream of ProcessFileEmbedding or ProcessChunks.',
     parameter_schema: {
         type: 'object',
+        $defs: conditions_1.conditionDefs,
         properties: {
             // ── Output fields ─────────────────────────────────────────────
             text_field: {
@@ -39,6 +41,18 @@ exports.ProcessExtraction = {
                 description: 'JSONB field for extraction metadata (page count, language, etc.)',
                 default: 'extracted_metadata'
             },
+            // ── Model config (optional — flows into job payload) ──────────
+            extraction_model: {
+                type: 'string',
+                description: 'Extraction model identifier (e.g. a vision model for OCR, an LLM for ' +
+                    'structured extraction). Included in the job payload so the worker knows ' +
+                    'which model to use. When null, the worker falls back to runtime config.'
+            },
+            extraction_provider: {
+                type: 'string',
+                description: 'Extraction provider name (e.g. "ollama", "openai"). ' +
+                    'When null, the worker falls back to runtime config.'
+            },
             // ── MIME scoping ──────────────────────────────────────────────
             mime_patterns: {
                 type: 'array',
@@ -70,16 +84,7 @@ exports.ProcessExtraction = {
                     bucket_id: 'bucket_id'
                 }
             },
-            trigger_conditions: {
-                description: 'Additional compound conditions beyond MIME filtering. ' +
-                    'Merged with the auto-generated MIME conditions via AND. ' +
-                    'Use this to add status checks (e.g., status = \'uploaded\').',
-                'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
-                oneOf: [
-                    { $ref: '#/$defs/triggerCondition' },
-                    { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
-                ]
-            },
+            trigger_conditions: conditions_1.triggerConditionsProperty,
             // ── Job options ───────────────────────────────────────────────
             queue_name: {
                 type: 'string',

package/data/process-image-versions.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessImageVersions = void 0;
+const conditions_1 = require("../conditions");
 /**
  * Image version processing node.
  *
@@ -26,6 +27,7 @@ exports.ProcessImageVersions = {
         'file records linked to the source image.',
     parameter_schema: {
         type: 'object',
+        $defs: conditions_1.conditionDefs,
         required: ['versions'],
         properties: {
             // ── Version definitions ───────────────────────────────────────
@@ -101,15 +103,7 @@ exports.ProcessImageVersions = {
                     bucket_id: 'bucket_id'
                 }
             },
-            trigger_conditions: {
-                description: 'Additional compound conditions beyond MIME filtering. ' +
-                    'Merged with the auto-generated MIME conditions via AND.',
-                'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
-                oneOf: [
-                    { $ref: '#/$defs/triggerCondition' },
-                    { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
-                ]
-            },
+            trigger_conditions: conditions_1.triggerConditionsProperty,
             // ── Job options ───────────────────────────────────────────────
             queue_name: {
                 type: 'string',

package/data/search-unified.js

@@ -111,6 +111,14 @@ exports.SearchUnified = {
                             format: 'column-ref'
                         }
                     },
+                    embedding_model: {
+                        type: 'string',
+                        description: 'Embedding model identifier. When null, the worker falls back to runtime config.'
+                    },
+                    embedding_provider: {
+                        type: 'string',
+                        description: 'Embedding provider name. When null, the worker falls back to runtime config.'
+                    },
                     search_score_weight: {
                         type: 'number',
                         default: 1

package/data/search-vector.js

@@ -53,6 +53,18 @@ exports.SearchVector = {
                 },
                 description: 'Column names that feed the embedding. Used by stale trigger to detect content changes.'
             },
+            // ── Model config (optional — flows into job payload) ──────────
+            embedding_model: {
+                type: 'string',
+                description: 'Embedding model identifier (e.g. "nomic-embed-text", "text-embedding-3-small"). ' +
+                    'Included in the job payload so the worker knows which model to use. ' +
+                    'When null, the worker falls back to runtime config (llm_module / env vars).'
+            },
+            embedding_provider: {
+                type: 'string',
+                description: 'Embedding provider name (e.g. "ollama", "openai"). ' +
+                    'When null, the worker falls back to runtime config.'
+            },
             enqueue_job: {
                 type: 'boolean',
                 description: 'Auto-create trigger that enqueues embedding generation jobs',

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

@@ -830,6 +830,41 @@ export interface BlueprintStorageConfig {
         buckets?: BlueprintEntityTableProvision;
     };
 }
+/** A requirement entry within a blueprint achievement. Defines what events must occur to earn the achievement. */
+export interface BlueprintAchievementRequirement {
+    /** Name identifier matching an event_type or step name. */
+    event_name: string;
+    /** Number of events needed to satisfy this requirement. */
+    count: number;
+    /** Human-readable description of what this requirement entails. */
+    description?: string;
+}
+/** A reward entry within a blueprint achievement. Defines credits granted when the achievement is earned. */
+export interface BlueprintAchievementReward {
+    /** Type of reward: limit_credit (grants limit credits) or meter_credit (grants meter credits). */
+    reward_type: 'limit_credit' | 'meter_credit';
+    /** Target limit name or meter slug for the credit grant. */
+    target_name: string;
+    /** Number of credits to grant. */
+    amount: number;
+    /** Credit type: permanent, expiring, etc. Defaults to "permanent". */
+    credit_type?: string;
+}
+/** 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). */
+export interface BlueprintAchievement {
+    /** Unique name for the achievement level. */
+    name: string;
+    /** Human-readable description of this achievement. */
+    description?: string;
+    /** Display ordering priority; lower values appear first. Defaults to 100. */
+    priority?: number;
+    /** Requirements that must be met to earn this achievement. */
+    requirements: BlueprintAchievementRequirement[];
+    /** Rewards granted when the achievement is earned. */
+    rewards?: BlueprintAchievementReward[];
+    /** Entity prefix to scope this achievement to (e.g., "org", "app"). Used to resolve the correct events_module. Defaults to "app". */
+    entity_prefix?: string;
+}
 /** Override object for the entity table created by a BlueprintEntityType. Shape mirrors BlueprintTable / secure_table_provision vocabulary. When supplied, policies[] replaces the default entity-table policies entirely. */
 export interface BlueprintEntityTableProvision {
     /** Whether to enable RLS on the entity table. Forwarded to secure_table_provision. Defaults to true. */
@@ -870,6 +905,8 @@ export interface BlueprintEntityType {
     has_storage?: boolean;
     /** Whether to provision entity-scoped invite tables ({prefix}_invites, {prefix}_claimed_invites) and a submit_{prefix}_invite_code() function. Defaults to false. */
     has_invites?: boolean;
+    /** 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. */
+    has_invite_achievements?: boolean;
     /** Escape hatch: when true AND table_provision is NULL, zero policies are provisioned on the entity table. Defaults to false. */
     skip_entity_policies?: boolean;
     /** 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). */
@@ -1142,4 +1179,6 @@ export interface BlueprintDefinition {
     entity_types?: BlueprintEntityType[];
     /** App-level storage configuration. Creates a storage_module (membership_type = NULL), seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS). Use provisions for per-table policy overrides. For entity-scoped storage, use entity_types[].has_storage + entity_types[].storage instead. */
     storage?: BlueprintStorageConfig;
+    /** 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). */
+    achievements?: BlueprintAchievement[];
 }

package/esm/codegen/generate-types.js

@@ -493,6 +493,37 @@ function buildBlueprintStorageConfig() {
         ])), 'Per-table overrides for storage tables. Each key targets a specific storage table (files, buckets) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision targeting the corresponding table. When a key includes policies[], those REPLACE the default storage policies for that table; tables without a key still get defaults.')
     ]), 'Storage configuration for an entity type. Seeds initial buckets, overrides module-level settings (expiry times, file size limits, CORS), and provides per-table provisioning overrides via provisions.');
 }
+// ---------------------------------------------------------------------------
+// Achievement types
+// ---------------------------------------------------------------------------
+function buildBlueprintAchievementRequirement() {
+    return addJSDoc(exportInterface('BlueprintAchievementRequirement', [
+        addJSDoc(requiredProp('event_name', t.tsStringKeyword()), 'Name identifier matching an event_type or step name.'),
+        addJSDoc(requiredProp('count', t.tsNumberKeyword()), 'Number of events needed to satisfy this requirement.'),
+        addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Human-readable description of what this requirement entails.')
+    ]), 'A requirement entry within a blueprint achievement. Defines what events must occur to earn the achievement.');
+}
+function buildBlueprintAchievementReward() {
+    return addJSDoc(exportInterface('BlueprintAchievementReward', [
+        addJSDoc(requiredProp('reward_type', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('limit_credit')),
+            t.tsLiteralType(t.stringLiteral('meter_credit'))
+        ])), 'Type of reward: limit_credit (grants limit credits) or meter_credit (grants meter credits).'),
+        addJSDoc(requiredProp('target_name', t.tsStringKeyword()), 'Target limit name or meter slug for the credit grant.'),
+        addJSDoc(requiredProp('amount', t.tsNumberKeyword()), 'Number of credits to grant.'),
+        addJSDoc(optionalProp('credit_type', t.tsStringKeyword()), 'Credit type: permanent, expiring, etc. Defaults to "permanent".')
+    ]), 'A reward entry within a blueprint achievement. Defines credits granted when the achievement is earned.');
+}
+function buildBlueprintAchievement() {
+    return addJSDoc(exportInterface('BlueprintAchievement', [
+        addJSDoc(requiredProp('name', t.tsStringKeyword()), 'Unique name for the achievement level.'),
+        addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Human-readable description of this achievement.'),
+        addJSDoc(optionalProp('priority', t.tsNumberKeyword()), 'Display ordering priority; lower values appear first. Defaults to 100.'),
+        addJSDoc(requiredProp('requirements', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievementRequirement')))), 'Requirements that must be met to earn this achievement.'),
+        addJSDoc(optionalProp('rewards', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievementReward')))), 'Rewards granted when the achievement is earned.'),
+        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).');
+}
 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.'),
@@ -518,6 +549,7 @@ function buildBlueprintEntityType() {
         addJSDoc(optionalProp('has_levels', t.tsBooleanKeyword()), 'Whether to provision a levels module for this entity type. Defaults to false.'),
         addJSDoc(optionalProp('has_storage', t.tsBooleanKeyword()), 'Whether to provision a storage module (buckets, files tables) for this entity type. Defaults to false.'),
         addJSDoc(optionalProp('has_invites', t.tsBooleanKeyword()), 'Whether to provision entity-scoped invite tables ({prefix}_invites, {prefix}_claimed_invites) and a submit_{prefix}_invite_code() function. Defaults to false.'),
+        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.tsTypeReference(t.identifier('BlueprintStorageConfig'))), 'Storage configuration. Only used when has_storage is true. Controls RLS policies on storage tables, seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS).')
@@ -548,7 +580,8 @@ function buildBlueprintDefinition() {
         addJSDoc(optionalProp('full_text_searches', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFullTextSearch')))), 'Full-text search configurations.'),
         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.tsTypeReference(t.identifier('BlueprintStorageConfig'))), 'App-level storage configuration. Creates a storage_module (membership_type = NULL), seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS). Use provisions for per-table policy overrides. For entity-scoped storage, use entity_types[].has_storage + entity_types[].storage instead.')
+        addJSDoc(optionalProp('storage', t.tsTypeReference(t.identifier('BlueprintStorageConfig'))), 'App-level storage configuration. Creates a storage_module (membership_type = NULL), seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS). Use provisions for per-table policy overrides. For entity-scoped storage, use entity_types[].has_storage + 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).')
     ]), 'The complete blueprint definition -- the JSONB shape accepted by construct_blueprint().');
 }
 // ---------------------------------------------------------------------------
@@ -607,6 +640,9 @@ function buildProgram(meta) {
     statements.push(buildBlueprintTableUniqueConstraint());
     statements.push(buildBlueprintBucketSeed());
     statements.push(buildBlueprintStorageConfig());
+    statements.push(buildBlueprintAchievementRequirement());
+    statements.push(buildBlueprintAchievementReward());
+    statements.push(buildBlueprintAchievement());
     statements.push(buildBlueprintEntityTableProvision());
     statements.push(buildBlueprintEntityType());
     // -- Node types discriminated union --

package/esm/conditions/index.d.ts

@@ -0,0 +1 @@
+export { conditionDefs, conditionProperties, triggerConditionSchema, triggerConditionsProperty } from './trigger-condition';

package/esm/conditions/index.js

@@ -0,0 +1 @@
+export { conditionDefs, conditionProperties, triggerConditionSchema, triggerConditionsProperty } from './trigger-condition';

package/esm/conditions/trigger-condition.d.ts

@@ -0,0 +1,35 @@
+import type { JSONSchema } from '../types';
+/**
+ * Shared trigger condition schema used by any node type that creates
+ * PostgreSQL triggers with conditional WHEN clauses.
+ *
+ * Consumed by: JobTrigger, EventTracker, ProcessExtraction,
+ * ProcessImageVersions, ProcessFileEmbedding, ProcessImageEmbedding.
+ *
+ * On the SQL side, these conditions are compiled to AST via
+ * metaschema_generators.build_condition_ast().
+ */
+export declare const triggerConditionSchema: JSONSchema;
+/**
+ * $defs block for parameter_schema. Spread into any node that uses conditions.
+ *
+ * Usage:
+ *   parameter_schema: { type: 'object', $defs: conditionDefs, properties: { ... } }
+ */
+export declare const conditionDefs: Record<string, JSONSchema>;
+/**
+ * Common condition-related properties for trigger-based nodes.
+ * Three mutually exclusive options for WHEN clause specification.
+ *
+ * Usage:
+ *   properties: { event_name: { ... }, ...conditionProperties }
+ */
+export declare const conditionProperties: Record<string, JSONSchema>;
+/**
+ * Standalone trigger_conditions property for nodes that compose on top of
+ * JobTrigger (Process* nodes). These use trigger_conditions instead of
+ * the full condition_field/conditions/watch_fields trio because the
+ * underlying JobTrigger handles the WHEN clause; this property adds
+ * additional conditions merged via AND.
+ */
+export declare const triggerConditionsProperty: JSONSchema;