digital-objects 1.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> digital-objects@0.1.0 build /Users/nathanclevenger/projects/primitives.org.ai/packages/digital-objects
+> tsc -p tsconfig.json
+

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [1.0.0] - 2026-01-15
+
+### Added
+- Core model: Nouns, Verbs, Things, Actions
+- MemoryProvider for in-memory storage
+- NS Durable Object with SQLite persistence
+- NSClient HTTP client
+- R2 persistence (snapshots, WAL, JSONL)
+- ai-database adapter (DBProvider interface)
+- Schema validation with opt-in validation
+- Batch operations (createMany, updateMany, deleteMany, performMany)
+- Graph traversal (related, edges)
+- Linguistic derivation (pluralization, verb conjugation)
+- Query limits (DEFAULT_LIMIT=100, MAX_LIMIT=1000)
+- Custom error classes (NotFoundError, ValidationError, ConflictError)
+
+### Security
+- SQL injection prevention with orderBy validation
+- GDPR compliance with deleteAction support
+
+### Documentation
+- Comprehensive MDX documentation in content/digital-objects/
+- README with quick start and examples

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 .org.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,476 @@
+# digital-objects
+
+Unified storage primitive for AI primitives - a linguistically-aware entity and graph system.
+
+> **Documentation:** For comprehensive guides and examples, see the [Digital Objects documentation](https://primitives.org.ai/digital-objects).
+
+## Overview
+
+`digital-objects` provides a coherent model for defining and managing entities (nouns/things) and relationships (verbs/actions). It automatically derives linguistic forms (pluralization, verb conjugation) and unifies events, graph edges, and audit trails into a single "action" concept.
+
+## Core Concepts
+
+### Nouns and Things
+
+**Nouns** define entity types. **Things** are instances of nouns.
+
+```typescript
+import { createMemoryProvider } from 'digital-objects'
+
+const provider = createMemoryProvider()
+
+// Define a noun (entity type)
+const postNoun = await provider.defineNoun({
+  name: 'Post',
+  description: 'A blog post',
+  schema: {
+    title: 'string',
+    body: 'markdown',
+    publishedAt: 'datetime?',
+  },
+})
+
+// Linguistic forms are auto-derived:
+// postNoun.singular = 'post'
+// postNoun.plural = 'posts'
+// postNoun.slug = 'post'
+
+// Create a thing (entity instance)
+const post = await provider.create('Post', {
+  title: 'Hello World',
+  body: '# Welcome\n\nThis is my first post.',
+})
+```
+
+### Verbs and Actions
+
+**Verbs** define action types. **Actions** represent events, graph edges, and audit records - unified.
+
+```typescript
+// Define a verb
+const publishVerb = await provider.defineVerb({
+  name: 'publish',
+  inverse: 'unpublish',
+})
+
+// Conjugations are auto-derived:
+// publishVerb.action = 'publish'     (imperative)
+// publishVerb.act = 'publishes'      (3rd person)
+// publishVerb.activity = 'publishing' (gerund)
+// publishVerb.event = 'published'     (past participle)
+// publishVerb.reverseBy = 'publishedBy'
+// publishVerb.reverseAt = 'publishedAt'
+
+// Perform an action (creates an event + edge)
+const action = await provider.perform(
+  'publish',      // verb
+  author.id,      // subject (who/from)
+  post.id,        // object (what/to)
+  { featured: true } // metadata
+)
+```
+
+### Actions as Graph Edges
+
+Actions form a directed graph. Use `related()` and `edges()` for traversal:
+
+```typescript
+// Get all things this author has published
+const publishedPosts = await provider.related(author.id, 'publish', 'out')
+
+// Get who published this post
+const publishers = await provider.related(post.id, 'publish', 'in')
+
+// Get all relationships (both directions)
+const allRelated = await provider.related(post.id, undefined, 'both')
+
+// Get edge details (the actions themselves)
+const publishActions = await provider.edges(author.id, 'publish', 'out')
+```
+
+## Linguistic Derivation
+
+The package automatically derives linguistic forms from base words.
+
+### Noun Derivation
+
+```typescript
+import { deriveNoun, pluralize, singularize } from 'digital-objects'
+
+deriveNoun('Post')      // { singular: 'post', plural: 'posts', slug: 'post' }
+deriveNoun('BlogPost')  // { singular: 'blog post', plural: 'blog posts', slug: 'blog-post' }
+deriveNoun('Person')    // { singular: 'person', plural: 'people', slug: 'person' }
+
+pluralize('category')   // 'categories'
+pluralize('child')      // 'children'
+singularize('posts')    // 'post'
+```
+
+### Verb Derivation
+
+```typescript
+import { deriveVerb } from 'digital-objects'
+
+deriveVerb('create')
+// {
+//   action: 'create',
+//   act: 'creates',
+//   activity: 'creating',
+//   event: 'created',
+//   reverseBy: 'createdBy',
+//   reverseAt: 'createdAt'
+// }
+
+deriveVerb('write')
+// {
+//   action: 'write',
+//   act: 'writes',
+//   activity: 'writing',
+//   event: 'written',        (irregular)
+//   reverseBy: 'writtenBy',
+//   reverseAt: 'writtenAt'
+// }
+```
+
+## Providers
+
+### MemoryProvider
+
+In-memory implementation for testing and development:
+
+```typescript
+import { createMemoryProvider, MemoryProvider } from 'digital-objects'
+
+// Factory function
+const provider = createMemoryProvider()
+
+// Or instantiate directly
+const provider = new MemoryProvider()
+
+// Clean up
+await provider.close()
+```
+
+### NS (Namespace Durable Object)
+
+SQLite-backed implementation for Cloudflare Workers with multi-tenant support:
+
+```typescript
+// In wrangler.toml:
+// [[durable_objects.bindings]]
+// name = "NS"
+// class_name = "NS"
+
+// Import for Workers
+import { NS } from 'digital-objects/ns'
+
+// Access via HTTP
+export default {
+  async fetch(request: Request, env: Env) {
+    const namespace = 'tenant-123'
+    const id = env.NS.idFromName(namespace)
+    const stub = env.NS.get(id)
+    return stub.fetch(request)
+  }
+}
+
+// HTTP API endpoints:
+// POST /nouns        - Define a noun
+// GET  /nouns/:name  - Get a noun
+// GET  /nouns        - List nouns
+// POST /verbs        - Define a verb
+// POST /things       - Create a thing
+// GET  /things/:id   - Get a thing
+// PATCH /things/:id  - Update a thing
+// DELETE /things/:id - Delete a thing
+// POST /actions      - Perform an action
+// GET  /related/:id  - Get related things
+```
+
+### NS Client
+
+HTTP client for accessing NS from other services:
+
+```typescript
+import { createNSClient } from 'digital-objects'
+
+const client = createNSClient({
+  baseUrl: 'https://ns.example.com',
+  namespace: 'my-namespace',
+})
+
+const post = await client.create('Post', { title: 'Hello' })
+```
+
+## R2 Persistence
+
+Backup, restore, and export functionality using Cloudflare R2.
+
+### Snapshots
+
+```typescript
+import { createSnapshot, restoreSnapshot } from 'digital-objects'
+
+// Create a full snapshot
+const result = await createSnapshot(provider, r2, 'my-namespace', {
+  timestamp: true, // Include timestamp in filename
+})
+// result.key = 'snapshots/my-namespace/1234567890.json'
+
+// Restore from snapshot
+await restoreSnapshot(provider, r2, 'my-namespace')
+// or specify a snapshot key:
+await restoreSnapshot(provider, r2, 'my-namespace', 'snapshots/my-namespace/1234567890.json')
+```
+
+### Write-Ahead Log (WAL)
+
+```typescript
+import { appendWAL, replayWAL, compactWAL } from 'digital-objects'
+
+// Append operation to WAL
+await appendWAL(r2, 'my-namespace', {
+  type: 'create',
+  noun: 'Post',
+  id: post.id,
+  data: post.data,
+  timestamp: Date.now(),
+})
+
+// Replay WAL entries
+const replayed = await replayWAL(provider, r2, 'my-namespace', lastSnapshotTimestamp)
+
+// Clean up old WAL entries
+const deleted = await compactWAL(r2, 'my-namespace', snapshotTimestamp)
+```
+
+### JSONL Export/Import
+
+```typescript
+import { exportJSONL, importJSONL, exportToR2, importFromR2 } from 'digital-objects'
+
+// Export to string
+const jsonl = await exportJSONL(provider)
+
+// Import from string
+const stats = await importJSONL(provider, jsonl)
+// stats = { nouns: 5, verbs: 3, things: 100, actions: 250 }
+
+// Export directly to R2
+await exportToR2(provider, r2, 'exports/backup.jsonl')
+
+// Import directly from R2
+await importFromR2(provider, r2, 'exports/backup.jsonl')
+```
+
+## ai-database Adapter
+
+Use digital-objects as a storage backend for ai-database:
+
+```typescript
+import { createMemoryProvider, createDBProviderAdapter } from 'digital-objects'
+
+const doProvider = createMemoryProvider()
+const dbProvider = createDBProviderAdapter(doProvider)
+
+// Now use ai-database's interface
+const user = await dbProvider.create('User', undefined, {
+  name: 'Alice',
+  email: 'alice@example.com',
+})
+// Returns: { $id: 'uuid', $type: 'User', name: 'Alice', email: '...' }
+
+// Get by ID
+const found = await dbProvider.get('User', user.$id)
+
+// List with filters
+const admins = await dbProvider.list('User', {
+  where: { role: 'admin' },
+  orderBy: 'name',
+  limit: 10,
+})
+
+// Create relationships
+await dbProvider.relate('User', user.$id, 'author', 'Post', post.$id)
+
+// Query relationships
+const userPosts = await dbProvider.related('Post', user.$id, 'author')
+```
+
+## Type Definitions
+
+### Noun
+
+```typescript
+interface Noun {
+  name: string        // 'Post'
+  singular: string    // 'post'
+  plural: string      // 'posts'
+  slug: string        // 'post' (URL-safe)
+  description?: string
+  schema?: Record<string, FieldDefinition>
+  createdAt: Date
+}
+```
+
+### Verb
+
+```typescript
+interface Verb {
+  name: string        // 'create'
+  action: string      // 'create' (imperative)
+  act: string         // 'creates' (3rd person)
+  activity: string    // 'creating' (gerund)
+  event: string       // 'created' (past participle)
+  reverseBy?: string  // 'createdBy'
+  reverseAt?: string  // 'createdAt'
+  inverse?: string    // 'delete'
+  description?: string
+  createdAt: Date
+}
+```
+
+### Thing
+
+```typescript
+interface Thing<T = Record<string, unknown>> {
+  id: string
+  noun: string        // References noun.name
+  data: T
+  createdAt: Date
+  updatedAt: Date
+}
+```
+
+### Action
+
+```typescript
+interface Action<T = Record<string, unknown>> {
+  id: string
+  verb: string        // References verb.name
+  subject?: string    // Thing ID (actor/from)
+  object?: string     // Thing ID (target/to)
+  data?: T            // Payload/metadata
+  status: ActionStatus
+  createdAt: Date
+  completedAt?: Date
+}
+
+type ActionStatus = 'pending' | 'active' | 'completed' | 'failed' | 'cancelled'
+```
+
+### Field Types
+
+```typescript
+type FieldDefinition =
+  | 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json' | 'markdown' | 'url'
+  | `${string}.${string}`      // Relation: 'Author.posts'
+  | `[${string}.${string}]`    // Array relation: '[Tag.posts]'
+  | `${PrimitiveType}?`        // Optional field
+```
+
+## Schema Validation
+
+Digital Objects provides runtime schema validation with clear, actionable error messages.
+
+### Enable Validation
+
+Validation is opt-in. Pass `{ validate: true }` to `create()` or `update()`:
+
+```typescript
+// Define a noun with schema
+await provider.defineNoun({
+  name: 'User',
+  schema: {
+    email: { type: 'string', required: true },
+    age: 'number',
+    bio: 'string?', // Optional
+  },
+})
+
+// Validation enabled - will throw on errors
+await provider.create('User', { name: 'Alice' }, undefined, { validate: true })
+// Error: Validation failed (1 error):
+//   - Missing required field 'email'
+```
+
+### Pre-flight Validation
+
+Use `validateOnly()` to check data before attempting operations:
+
+```typescript
+import { validateOnly } from 'digital-objects'
+
+const schema = {
+  email: { type: 'string', required: true },
+  age: 'number',
+}
+
+const result = validateOnly({ age: '25' }, schema)
+
+if (!result.valid) {
+  console.log('Errors:', result.errors)
+  // [
+  //   {
+  //     field: 'email',
+  //     message: "Missing required field 'email'",
+  //     code: 'REQUIRED_FIELD',
+  //     expected: 'string',
+  //     received: 'undefined'
+  //   },
+  //   {
+  //     field: 'age',
+  //     message: "Field 'age' has wrong type: expected number, got string",
+  //     code: 'TYPE_MISMATCH',
+  //     expected: 'number',
+  //     received: 'string',
+  //     suggestion: 'Convert to number: 25'
+  //   }
+  // ]
+}
+```
+
+### Error Codes
+
+| Code | Description |
+|------|-------------|
+| `REQUIRED_FIELD` | A required field is missing or null |
+| `TYPE_MISMATCH` | Value has wrong type for the field |
+| `INVALID_FORMAT` | Value format doesn't match expected pattern |
+| `UNKNOWN_FIELD` | Field not defined in schema (future feature) |
+
+### Suggestions
+
+Validation errors include helpful suggestions when possible:
+
+```typescript
+// String that looks like a number
+{ age: '25' }
+// suggestion: "Convert to number: 25"
+
+// Number when string expected
+{ name: 42 }
+// suggestion: 'Convert to string: "42"'
+
+// String boolean
+{ active: 'true' }
+// suggestion: "Convert to boolean: true"
+
+// Wrong type for array
+{ tags: 'single-tag' }
+// suggestion: "Wrap value in an array: [value]"
+
+// Wrong type for date
+{ createdAt: 1705312800000 }
+// suggestion: "Provide a valid ISO 8601 date string"
+```
+
+## Installation
+
+```bash
+npm install digital-objects
+```
+
+## License
+
+MIT

package/dist/ai-database-adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ai-database Adapter
+ *
+ * Wraps a DigitalObjectsProvider to provide the ai-database DBProvider interface.
+ * This enables ai-database to use digital-objects as its storage backend.
+ */
+import type { DigitalObjectsProvider } from './types.js';
+export interface ListOptions {
+    limit?: number;
+    offset?: number;
+    where?: Record<string, unknown>;
+    orderBy?: string;
+    order?: 'asc' | 'desc';
+}
+export interface SearchOptions extends ListOptions {
+    fields?: string[];
+}
+export interface SemanticSearchOptions extends SearchOptions {
+    embedding?: number[];
+    minScore?: number;
+}
+export interface HybridSearchOptions extends SearchOptions {
+    semanticWeight?: number;
+    ftsWeight?: number;
+    minScore?: number;
+}
+/**
+ * ai-database DBProvider interface (simplified)
+ */
+export interface DBProvider {
+    get(type: string, id: string): Promise<Record<string, unknown> | null>;
+    list(type: string, options?: ListOptions): Promise<Record<string, unknown>[]>;
+    search(type: string, query: string, options?: SearchOptions): Promise<Record<string, unknown>[]>;
+    create(type: string, id: string | undefined, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update(type: string, id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    delete(type: string, id: string): Promise<boolean>;
+    related(type: string, id: string, relation: string): Promise<Record<string, unknown>[]>;
+    relate(fromType: string, fromId: string, relation: string, toType: string, toId: string, metadata?: {
+        matchMode?: 'exact' | 'fuzzy';
+        similarity?: number;
+        matchedType?: string;
+    }): Promise<void>;
+    unrelate(fromType: string, fromId: string, relation: string, toType: string, toId: string): Promise<void>;
+}
+/**
+ * Create a DBProvider adapter from a DigitalObjectsProvider
+ */
+export declare function createDBProviderAdapter(provider: DigitalObjectsProvider): DBProvider;
+//# sourceMappingURL=ai-database-adapter.d.ts.map

package/dist/ai-database-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-database-adapter.d.ts","sourceRoot":"","sources":["../src/ai-database-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,YAAY,CAAA;AAGnB,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAEzB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACtE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IAChG,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACjG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAGlD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IACvF,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACtF,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB;AAuBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,UAAU,CAgGpF"}

package/dist/ai-database-adapter.js

@@ -0,0 +1,89 @@
+/**
+ * ai-database Adapter
+ *
+ * Wraps a DigitalObjectsProvider to provide the ai-database DBProvider interface.
+ * This enables ai-database to use digital-objects as its storage backend.
+ */
+/**
+ * Convert Thing to entity format (with $id, $type)
+ */
+function thingToEntity(thing) {
+    return {
+        $id: thing.id,
+        $type: thing.noun,
+        ...thing.data,
+    };
+}
+/**
+ * Extract data from entity (remove $id, $type)
+ */
+function entityToData(entity) {
+    const { $id, $type, ...data } = entity;
+    return data;
+}
+/**
+ * Create a DBProvider adapter from a DigitalObjectsProvider
+ */
+export function createDBProviderAdapter(provider) {
+    return {
+        async get(type, id) {
+            const thing = await provider.get(id);
+            if (!thing || thing.noun !== type)
+                return null;
+            return thingToEntity(thing);
+        },
+        async list(type, options) {
+            const things = await provider.list(type, options);
+            return things.map(thingToEntity);
+        },
+        async search(type, query, options) {
+            const things = await provider.search(query, { ...options, where: { ...options?.where } });
+            // Filter by type since search is global
+            return things.filter((t) => t.noun === type).map(thingToEntity);
+        },
+        async create(type, id, data) {
+            // Ensure noun is defined
+            const existingNoun = await provider.getNoun(type);
+            if (!existingNoun) {
+                await provider.defineNoun({ name: type });
+            }
+            const thing = await provider.create(type, entityToData(data), id);
+            return thingToEntity(thing);
+        },
+        async update(_type, id, data) {
+            const thing = await provider.update(id, entityToData(data));
+            return thingToEntity(thing);
+        },
+        async delete(_type, id) {
+            return provider.delete(id);
+        },
+        async related(type, id, relation) {
+            // ai-database expects related entities of a specific type via a relation
+            // digital-objects uses verb as the relation type
+            const things = await provider.related(id, relation, 'both');
+            // Filter by expected type
+            return things.filter((t) => t.noun === type).map(thingToEntity);
+        },
+        async relate(_fromType, fromId, relation, _toType, toId, metadata) {
+            // Ensure verb is defined
+            const existingVerb = await provider.getVerb(relation);
+            if (!existingVerb) {
+                await provider.defineVerb({ name: relation });
+            }
+            await provider.perform(relation, fromId, toId, metadata);
+        },
+        async unrelate(_fromType, fromId, relation, _toType, toId) {
+            // Find the action(s) matching this relation and delete them
+            const actions = await provider.listActions({
+                verb: relation,
+                subject: fromId,
+                object: toId,
+            });
+            // Delete all matching actions (for GDPR compliance)
+            for (const action of actions) {
+                await provider.deleteAction(action.id);
+            }
+        },
+    };
+}
+//# sourceMappingURL=ai-database-adapter.js.map

package/dist/ai-database-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-database-adapter.js","sourceRoot":"","sources":["../src/ai-database-adapter.ts"],"names":[],"mappings":"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"}