@unrdf/hooks 26.4.2 → 26.4.4

package/examples/policy-hooks/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/Users/sac/unrdf/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/Users/sac/unrdf/node_modules/.pnpm/tsx@4.21.0/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/Users/sac/unrdf/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/Users/sac/unrdf/node_modules/.pnpm/tsx@4.21.0/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../../node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../../../../../../node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/cli.mjs" "$@"
+fi

package/examples/policy-hooks/node_modules/.bin/vite

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules/vite/bin/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules/vite/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules/vite/bin/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules/vite/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../../node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules/vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../../../../../../node_modules/.pnpm/vite@7.3.1_@types+node@25.5.0_jiti@2.6.1_lightningcss@1.32.0_terser@5.46.1_tsx@4.21.0_yaml@2.8.3/node_modules/vite/bin/vite.js" "$@"
+fi

package/examples/policy-hooks/node_modules/.bin/vitest

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/vitest@4.0.15_@opentelemetry+api@1.9.0_@types+node@24.10.1_@vitest+ui@4.0.15_happy-dom@_4020ef6a5cc83a28d6954792bad1f77a/node_modules/vitest/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vitest@4.0.15_@opentelemetry+api@1.9.0_@types+node@24.10.1_@vitest+ui@4.0.15_happy-dom@_4020ef6a5cc83a28d6954792bad1f77a/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/vitest@4.1.2_@opentelemetry+api@1.9.1_@types+node@25.5.0_@vitest+ui@4.1.2_happy-dom@20._43a84fb45b8a6c418aa4e6591a004ea7/node_modules/vitest/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vitest@4.1.2_@opentelemetry+api@1.9.1_@types+node@25.5.0_@vitest+ui@4.1.2_happy-dom@20._43a84fb45b8a6c418aa4e6591a004ea7/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/vitest@4.0.15_@opentelemetry+api@1.9.0_@types+node@24.10.1_@vitest+ui@4.0.15_happy-dom@_4020ef6a5cc83a28d6954792bad1f77a/node_modules/vitest/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vitest@4.0.15_@opentelemetry+api@1.9.0_@types+node@24.10.1_@vitest+ui@4.0.15_happy-dom@_4020ef6a5cc83a28d6954792bad1f77a/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/vitest@4.1.2_@opentelemetry+api@1.9.1_@types+node@25.5.0_@vitest+ui@4.1.2_happy-dom@20._43a84fb45b8a6c418aa4e6591a004ea7/node_modules/vitest/node_modules:/Users/sac/unrdf/node_modules/.pnpm/vitest@4.1.2_@opentelemetry+api@1.9.1_@types+node@25.5.0_@vitest+ui@4.1.2_happy-dom@20._43a84fb45b8a6c418aa4e6591a004ea7/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"

package/examples/policy-hooks/node_modules/.bin/yaml

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/yaml@2.8.3/node_modules/yaml/node_modules:/Users/sac/unrdf/node_modules/.pnpm/yaml@2.8.3/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/sac/unrdf/node_modules/.pnpm/yaml@2.8.3/node_modules/yaml/node_modules:/Users/sac/unrdf/node_modules/.pnpm/yaml@2.8.3/node_modules:/Users/sac/unrdf/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../../node_modules/.pnpm/yaml@2.8.3/node_modules/yaml/bin.mjs" "$@"
+else
+  exec node  "$basedir/../../../../../../node_modules/.pnpm/yaml@2.8.3/node_modules/yaml/bin.mjs" "$@"
+fi

package/examples/policy-hooks/package.json

@@ -11,8 +11,8 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@unrdf/core": "workspace:*",
-    "@unrdf/hooks": "workspace:*",
+    "@unrdf/core": "26.4.3",
+    "@unrdf/hooks": "26.4.3",
     "n3": "^1.26.0",
     "zod": "^4.1.13"
   },

package/examples/shacl-repair-example.mjs

@@ -0,0 +1,191 @@
+/**
+ * @unrdf/hooks - SHACL Repair Mode Example
+ *
+ * Demonstrates SHACL validation with automatic repair.
+ * When validation fails, repair queries fix data, then re-validate.
+ *
+ * Use cases:
+ * - Auto-filling missing required properties with defaults
+ * - Normalizing invalid references
+ * - Fixing data quality issues automatically
+ */
+
+import { createStore } from '@unrdf/oxigraph';
+import { evaluateCondition } from '../src/hooks/condition-evaluator.mjs';
+import { UnrdfDataFactory as DataFactory } from '@unrdf/core/rdf/n3-justified-only';
+
+const { namedNode, literal, quad } = DataFactory;
+
+console.log('=== SHACL Repair Mode Example ===\n');
+
+// Create a test store
+const store = createStore();
+
+// Add test data (some valid, some missing required properties)
+console.log('1. Loading test data...');
+store.add(
+  quad(
+    namedNode('http://example.org/trade/t1'),
+    namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'),
+    namedNode('http://example.org/Trade')
+  )
+);
+store.add(
+  quad(
+    namedNode('http://example.org/trade/t1'),
+    namedNode('http://example.org/amount'),
+    literal('150000')
+  )
+);
+// Note: missing riskScore
+
+store.add(
+  quad(
+    namedNode('http://example.org/trade/t2'),
+    namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'),
+    namedNode('http://example.org/Trade')
+  )
+);
+// Note: missing both amount and riskScore
+
+console.log(`   Loaded ${store.size} quads\n`);
+
+// Define SHACL condition with repair query
+console.log('2. Defining SHACL repair condition...\n');
+
+const shaclRepairCondition = {
+  kind: 'shacl',
+  ref: {
+    uri: 'file:///shapes/trade-shape.ttl',
+    // Note: in production, provide actual sha256 hash
+    // sha256: 'abc123def456...'
+  },
+  enforcementMode: 'repair',
+  repairConstruct: `
+    # Fill in missing required properties with defaults
+    CONSTRUCT {
+      ?trade ex:riskScore ?defaultRisk ;
+             ex:amount ?defaultAmount ;
+             ex:status ex:Pending .
+    }
+    WHERE {
+      ?trade a ex:Trade .
+      OPTIONAL { ?trade ex:riskScore ?existing . }
+      OPTIONAL { ?trade ex:amount ?existingAmount . }
+      FILTER (!BOUND(?existing) || !BOUND(?existingAmount))
+      BIND (50 as ?defaultRisk)
+      BIND (0 as ?defaultAmount)
+    }
+  `
+};
+
+console.log('Repair CONSTRUCT query:');
+console.log(shaclRepairCondition.repairConstruct);
+console.log('');
+
+// Example 1: Block mode (strictest - no repairs)
+console.log('3. Example: Block Mode (no repairs)\n');
+const blockCondition = {
+  ...shaclRepairCondition,
+  enforcementMode: 'block'
+};
+
+console.log('With block mode:');
+console.log('- Validation failure = hook fails (false)');
+console.log('- No automatic repair attempted');
+console.log('- Application must handle fix separately\n');
+
+// Example 2: Annotate mode (audit trail)
+console.log('4. Example: Annotate Mode (logging)\n');
+const annotateCondition = {
+  ...shaclRepairCondition,
+  enforcementMode: 'annotate'
+};
+
+console.log('With annotate mode:');
+console.log('- Validation failure = add sh:ValidationResult triples');
+console.log('- Returns true (permits operation)');
+console.log('- Violations recorded in RDF for audit trail');
+console.log('- Good for compliance tracking\n');
+
+// Example 3: Repair mode (automatic fixing)
+console.log('5. Example: Repair Mode (automatic fix)\n');
+const repairCondition = {
+  ...shaclRepairCondition,
+  enforcementMode: 'repair'
+};
+
+console.log('With repair mode:');
+console.log('- Validation failure = execute repairConstruct');
+console.log('- Repair adds missing properties with defaults');
+console.log('- Re-validates after repair');
+console.log('- Returns success/failure of final validation\n');
+
+// Example 4: Multi-phase repair strategy
+console.log('6. Complex Example: Multi-Phase Repair\n');
+
+const complexRepairCondition = {
+  kind: 'shacl',
+  ref: { uri: 'file:///shapes/comprehensive.ttl' },
+  enforcementMode: 'repair',
+  repairConstruct: `
+    PREFIX ex: <http://example.org/>
+    PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
+
+    CONSTRUCT {
+      ?entity ex:status ex:Reviewed ;
+              ex:lastChecked ?now ;
+              ex:quality ?quality .
+    }
+    WHERE {
+      ?entity a ex:Entity .
+      BIND (NOW() as ?now)
+
+      # Quality assessment: calculate based on completeness
+      OPTIONAL { ?entity ex:description ?desc . }
+      OPTIONAL { ?entity ex:classification ?class . }
+      OPTIONAL { ?entity ex:owner ?owner . }
+
+      BIND (
+        IF(BOUND(?desc) && BOUND(?class) && BOUND(?owner),
+           "high",
+           "medium")
+        as ?quality
+      )
+    }
+  `
+};
+
+console.log('Multi-phase repair includes:');
+console.log('1. Add status field if missing');
+console.log('2. Record timestamp of check');
+console.log('3. Calculate quality score based on available properties\n');
+
+// Practical workflow
+console.log('7. Practical Workflow\n');
+console.log('Step 1: Data arrives (potentially with gaps)');
+console.log('Step 2: evaluateCondition() with shacl/repair');
+console.log('Step 3: If validation fails:');
+console.log('        - Auto repair executes');
+console.log('        - Missing properties filled with defaults');
+console.log('        - Re-validation checks if repair succeeded');
+console.log('Step 4: Result indicates success/failure');
+console.log('Step 5: Application continues based on result\n');
+
+// Best practices
+console.log('8. Best Practices for Repair Mode\n');
+console.log('✓ Use repair for:');
+console.log('  - Filling optional properties with sensible defaults');
+console.log('  - Normalizing data format (URI standardization)');
+console.log('  - Adding audit/lifecycle properties');
+console.log('');
+console.log('✗ Avoid repair for:');
+console.log('  - Changing core business data semantics');
+console.log('  - Complex transformations (use effects instead)');
+console.log('  - Expensive computations (will run on every violation)');
+console.log('');
+console.log('💡 Combine with effects:');
+console.log('  1. Condition: shacl/repair → auto-fix violations');
+console.log('  2. Effect: sparql-construct → apply business logic\n');
+
+console.log('=== Example Complete ===');

package/examples/window-condition-example.mjs

@@ -0,0 +1,285 @@
+/**
+ * @unrdf/hooks - Window Condition Example
+ *
+ * Demonstrates time-windowed aggregation evaluation.
+ * Triggers rules when aggregated metrics within time windows meet thresholds.
+ *
+ * Use cases:
+ * - Rate limiting: "more than 100 requests/minute"
+ * - Anomaly detection: "average temperature exceeds threshold"
+ * - Traffic analysis: "peak traffic detection"
+ * - Quota enforcement: "daily transaction limit"
+ */
+
+import { createStore } from '@unrdf/oxigraph';
+import { evaluateCondition } from '../src/hooks/condition-evaluator.mjs';
+import { UnrdfDataFactory as DataFactory } from '@unrdf/core/rdf/n3-justified-only';
+
+const { namedNode, literal, quad } = DataFactory;
+
+console.log('=== Window Condition Example ===\n');
+
+// Utility: create window condition
+function createWindowCondition(aggregate, windowMs, query) {
+  return {
+    kind: 'window',
+    spec: {
+      size: windowMs,
+      aggregate: aggregate,
+      query: query
+    }
+  };
+}
+
+// Example 1: Count-based window
+console.log('1. Count Window (Rate Limiting)\n');
+
+const countWindowCondition = createWindowCondition(
+  'count',
+  60000,  // 1 minute
+  `SELECT ?s WHERE {
+    ?s a ex:Request ;
+       ex:timestamp ?t .
+    FILTER (?t > NOW() - PT1M)
+  }`
+);
+
+console.log('Condition:');
+console.log(JSON.stringify(countWindowCondition, null, 2));
+console.log('');
+console.log('Purpose: Count matches in last 60 seconds');
+console.log('Triggers when: count >= configured threshold');
+console.log('Use for: Rate limiting, quota enforcement');
+console.log('');
+
+console.log('Example usage in hook:');
+console.log(`
+{
+  condition: ${JSON.stringify(countWindowCondition, null, 4)},
+  effects: [{
+    kind: 'sparql-construct',
+    query: \`CONSTRUCT { ?s ex:rateLimited true } WHERE { ?s a ex:Request }\`
+  }]
+}
+
+Flow:
+1. Query finds all requests in last 60 seconds
+2. Count results
+3. If count > 100, hook triggers
+4. Affected requests marked as rate-limited
+`);
+
+// Example 2: Sum aggregation
+console.log('\n2. Sum Window (Traffic Volume)\n');
+
+const sumWindowCondition = createWindowCondition(
+  'sum',
+  300000,  // 5 minutes
+  `SELECT ?bytes WHERE {
+    ?transfer ex:transferredBytes ?bytes ;
+              ex:timestamp ?t .
+    FILTER (?t > NOW() - PT5M)
+  }`
+);
+
+console.log('Condition:');
+console.log(JSON.stringify(sumWindowCondition, null, 2));
+console.log('');
+console.log('Purpose: Sum bytes transferred in last 5 minutes');
+console.log('Triggers when: sum > threshold (e.g., 1GB)');
+console.log('Use for: Bandwidth management, peak detection\n');
+
+// Example 3: Average aggregation
+console.log('3. Average Window (Anomaly Detection)\n');
+
+const avgWindowCondition = createWindowCondition(
+  'avg',
+  3600000,  // 1 hour
+  `SELECT ?temp WHERE {
+    ?sensor ex:reading ?temp ;
+            ex:timestamp ?t .
+    FILTER (?t > NOW() - PT1H)
+  }`
+);
+
+console.log('Condition:');
+console.log(JSON.stringify(avgWindowCondition, null, 2));
+console.log('');
+console.log('Purpose: Average temperature over last hour');
+console.log('Triggers when: avg > 85 degrees (anomaly)');
+console.log('Use for: Anomaly detection, SLA monitoring\n');
+
+// Example 4: Min/Max windows
+console.log('4. Min/Max Windows (Range Monitoring)\n');
+
+const minWindowCondition = createWindowCondition(
+  'min',
+  86400000,  // 24 hours
+  `SELECT ?value WHERE {
+    ?metric ex:dailyValue ?value ;
+            ex:timestamp ?t .
+    FILTER (?t > NOW() - P1D)
+  }`
+);
+
+const maxWindowCondition = createWindowCondition(
+  'max',
+  86400000,  // 24 hours
+  `SELECT ?value WHERE {
+    ?metric ex:dailyValue ?value ;
+            ex:timestamp ?t .
+    FILTER (?t > NOW() - P1D)
+  }`
+);
+
+console.log('Min window (find lowest value in window):');
+console.log(JSON.stringify(minWindowCondition, null, 2));
+console.log('');
+console.log('Max window (find highest value in window):');
+console.log(JSON.stringify(maxWindowCondition, null, 2));
+console.log('');
+console.log('Use for: Performance tracking, threshold detection\n');
+
+// Real-world scenarios
+console.log('5. Real-World Scenarios\n');
+
+console.log('Scenario A: API Rate Limiting');
+console.log('-'.repeat(40));
+console.log(`
+Condition: Window count in 1 minute > 1000
+{
+  kind: 'window',
+  spec: {
+    size: 60000,
+    aggregate: 'count',
+    query: 'SELECT ?req WHERE { ?req a ex:APICall ; ex:timestamp ?t }'
+  }
+}
+
+Hook flow:
+1. Client makes API requests
+2. Each request added as RDF triple with timestamp
+3. Window counts requests in last minute
+4. If > 1000, trigger rate limiting effect
+5. Mark client as throttled, return 429 Too Many Requests
+`);
+
+console.log('\nScenario B: Data Quality Monitoring');
+console.log('-'.repeat(40));
+console.log(`
+Condition: Window average error rate in 1 hour > 5%
+{
+  kind: 'window',
+  spec: {
+    size: 3600000,
+    aggregate: 'avg',
+    query: 'SELECT ?rate WHERE { ?batch ex:errorRate ?rate }'
+  }
+}
+
+Hook flow:
+1. Data processing batches complete
+2. Each batch records error rate
+3. Window averages error rates from last hour
+4. If average > 5%, alert operations
+5. Trigger investigation and mitigation effect
+`);
+
+console.log('\nScenario C: Quota Enforcement');
+console.log('-'.repeat(40));
+console.log(`
+Condition: Window sum of usage in 24 hours > quota
+{
+  kind: 'window',
+  spec: {
+    size: 86400000,
+    aggregate: 'sum',
+    query: 'SELECT ?usage WHERE { ?tx ex:usage ?usage }'
+  }
+}
+
+Hook flow:
+1. Transactions recorded with usage amount
+2. Window sums usage over rolling 24 hours
+3. If sum > daily quota, enforce limit
+4. Mark user as over-quota
+5. Require billing upgrade or wait for next period
+`);
+
+// Aggregate functions explained
+console.log('\n6. Aggregate Functions Explained\n');
+
+console.log('count   - Number of matches in window');
+console.log('         Example: How many API calls in last minute?');
+console.log('');
+console.log('sum     - Total of numeric values in window');
+console.log('         Example: Total bytes transferred in 5 minutes?');
+console.log('');
+console.log('avg     - Average of numeric values in window');
+console.log('         Example: Average response time over 1 hour?');
+console.log('');
+console.log('min     - Minimum value in window');
+console.log('         Example: Lowest temperature recorded today?');
+console.log('');
+console.log('max     - Maximum value in window');
+console.log('         Example: Peak memory usage in last hour?\n');
+
+// Window sizing
+console.log('7. Window Size Best Practices\n');
+
+console.log('Use Case             Window Size    Frequency        Aggregate');
+console.log('-'.repeat(60));
+console.log('API rate limiting    1 minute      Per request      count');
+console.log('Traffic analysis     5 minutes     Per measurement  sum/avg');
+console.log('SLA monitoring       1 hour        Per measurement  avg/max');
+console.log('Daily quota          24 hours      Per transaction  sum');
+console.log('Anomaly detection    1 hour        Per event        avg/stddev\n');
+
+// Combining with effects
+console.log('8. Full Hook Example: Rate Limiting\n');
+
+console.log(`
+const rateLimitHook = {
+  name: 'enforce-api-rate-limit',
+
+  condition: {
+    kind: 'window',
+    spec: {
+      size: 60000,      // 1 minute window
+      aggregate: 'count',
+      query: \`
+        SELECT ?request WHERE {
+          ?request a ex:APIRequest ;
+                   ex:clientId ?client ;
+                   ex:timestamp ?t .
+          FILTER (?t > NOW() - PT1M)
+        }
+      \`
+    }
+  },
+
+  effects: [{
+    kind: 'sparql-construct',
+    query: \`
+      CONSTRUCT {
+        ?client ex:rateLimited true ;
+                ex:retryAfter "60"^^xsd:integer ;
+                ex:error "Rate limit exceeded" .
+      }
+      WHERE {
+        ?request a ex:APIRequest ;
+                 ex:clientId ?client .
+      }
+    \`
+  }]
+};
+`);
+
+console.log('\nExecution:');
+console.log('1. Request arrives, added to store with timestamp');
+console.log('2. Window condition counts requests from same client in 1min');
+console.log('3. If count > 1000, condition triggers');
+console.log('4. Effect adds rate limit response triples');
+console.log('5. API returns 429 with retry-after header\n');
+
+console.log('=== Example Complete ===');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unrdf/hooks",
-  "version": "26.4.2",
+  "version": "26.4.4",
   "description": "UNRDF Knowledge Hooks - Policy Definition and Execution Framework",
   "type": "module",
   "bin": {
@@ -47,9 +47,12 @@
     "validation"
   ],
   "dependencies": {
-    "@unrdf/core": "workspace:*",
-    "@unrdf/oxigraph": "workspace:*",
+    "@noble/hashes": "^1.4.0",
+    "@unrdf/core": "26.4.4",
+    "@unrdf/oxigraph": "26.4.4",
     "citty": "^0.1.6",
+    "eyereasoner": "^10",
+    "sparqljs": "^3.7.3",
     "zod": "^4.1.13"
   },
   "devDependencies": {

package/src/atomvm.mjs

@@ -0,0 +1,9 @@
+/**
+ * @unrdf/hooks/atomvm
+ *
+ * AtomVM/Erlang integration for Knowledge Hooks
+ *
+ * @module @unrdf/hooks/atomvm
+ */
+
+export { HooksBridge, createHooksBridge } from './hooks/atomvm-bridge.mjs';