@synap-core/sdk 0.1.0

package/README.md

@@ -0,0 +1,173 @@
+# @synap/sdk
+
+High-level SDK for Synap - Event-sourced personal data platform
+
+## Installation
+
+```bash
+pnpm add @synap/sdk
+```
+
+## Quick Start
+
+```typescript
+import { SynapSDK } from '@synap/sdk';
+
+// Initialize SDK
+const synap = new SynapSDK({
+  url: 'https://api.synap.app',
+  apiKey: 'your-api-key'
+});
+
+// Create entity (event-sourced)
+const { entityId } = await synap.entities.create({
+  type: 'task',
+  title: 'Call Marie tomorrow',
+  metadata: {
+    dueDate: '2024-12-20',
+    priority: 'high'
+  }
+});
+
+// Create relationship (event-sourced)
+await synap.relations.create(entityId, personId, 'assigned_to');
+
+// Query data (direct reads)
+const tasks = await synap.entities.list({ type: 'task' });
+const history = await synap.events.getHistory(entityId);
+```
+
+## Architecture
+
+### Event Sourcing
+
+All **mutations** go through event sourcing:
+- `entities.create/update/delete` → `events.log` → Inngest worker → Database
+- `relations.create/delete` → `events.log` → Inngest worker → Database
+
+All **queries** are direct database reads:
+- `entities.get/list/search` → Direct query
+- `relations.get/getRelated` → Direct query
+- `events.getHistory` → Direct query
+
+### Benefits
+
+- **Audit trail**: Every change logged as immutable event
+- **Time travel**: Replay events to see past states
+- **Reliability**: Workers handle async processing with retries
+- **Real-time**: Events trigger webhooks and SSE broadcasts
+
+## API Reference
+
+### Entities API
+
+```typescript
+// Create
+const { entityId } = await synap.entities.create({
+  type: 'note',
+  title: 'Meeting Notes',
+  content: '# Discussion points...'
+});
+
+// Update
+await synap.entities.update(entityId, {
+  title: 'Updated Title'
+});
+
+// Delete (soft delete)
+await synap.entities.delete(entityId);
+
+// Get
+const entity = await synap.entities.get(entityId);
+
+// List
+const notes = await synap.entities.list({
+  type: 'note',
+  limit: 20
+});
+
+// Search
+const results = await synap.entities.search({
+  query: 'project planning',
+  types: ['note', 'task']
+});
+```
+
+### Relations API
+
+```typescript
+// Create relationship
+await synap.relations.create(
+  sourceEntityId,
+  targetEntityId,
+  'assigned_to'
+);
+
+// Get relations
+const relations = await synap.relations.get(entityId, {
+  type: 'assigned_to',
+  direction: 'both' // 'source' | 'target' | 'both'
+});
+
+// Get related entities
+const people = await synap.relations.getRelated(taskId, {
+  type: 'assigned_to',
+  direction: 'source'
+});
+
+// Get statistics
+const stats = await synap.relations.getStats(entityId);
+// Returns: { total, outgoing, incoming, byType }
+
+// Delete relationship
+await synap.relations.delete(relationId);
+```
+
+### Events API
+
+```typescript
+// Get entity history
+const history = await synap.events.getHistory(entityId, {
+  eventTypes: ['entities.create.validated'],
+  limit: 100
+});
+
+// Get user timeline
+const timeline = await synap.events.getTimeline({
+  limit: 50
+});
+
+// Replay events to rebuild state
+const state = await synap.events.replay(entityId);
+```
+
+## Entity Types
+
+```typescript
+type EntityType = 
+  | 'task'
+  | 'note'
+  | 'person'
+  | 'event'
+  | 'file';
+```
+
+## Relation Types
+
+```typescript
+type RelationType =
+  | 'assigned_to'    // Task → Person
+  | 'mentions'       // Note → Entity
+  | 'links_to'       // Note → Note
+  | 'parent_of'      // Project → Task
+  | 'relates_to'     // Generic
+  | 'tagged_with'    // Entity → Tag
+  | 'created_by'     // Entity → Person
+  | 'attended_by'    // Event → Person
+  | 'depends_on'     // Task → Task
+  | 'blocks';        // Task → Task
+```
+
+## License
+
+AGPL-3.0

package/dist/client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * SynapSDK - Main SDK Client
+ *
+ * Provides high-level APIs for interacting with Synap Data Pod.
+ * All mutations go through event sourcing, all queries are direct reads.
+ */
+import { type SynapClient as TRPCClient } from '@synap/client';
+import { EntitiesAPI } from './resources/entities.js';
+import { RelationsAPI } from './resources/relations.js';
+import { EventsAPI } from './resources/events.js';
+/**
+ * SDK Configuration
+ */
+export interface SynapSDKConfig {
+    /**
+     * Base URL for the Synap API
+     * @example 'https://api.synap.app' or 'http://localhost:3000'
+     */
+    url: string;
+    /**
+     * API key or authentication token
+     * Either provide apiKey OR headers function
+     */
+    apiKey?: string;
+    /**
+     * Custom headers function for dynamic authentication
+     * @example () => ({ Authorization: `Bearer ${getToken()}` })
+     */
+    headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    /**
+     * Custom fetch implementation (for React Native, etc.)
+     */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Synap SDK - High-Level Client
+ *
+ * @example
+ * ```typescript
+ * const synap = new SynapSDK({
+ *   url: 'https://api.synap.app',
+ *   apiKey: 'sk_...'
+ * });
+ *
+ * // Use resource APIs
+ * const task = await synap.entities.create({ type: 'task', title: 'Call Marie' });
+ * await synap.relations.create(task.id, personId, 'assigned_to');
+ * const history = await synap.events.getHistory(task.id);
+ * ```
+ */
+export declare class SynapSDK {
+    /** Internal tRPC client */
+    private readonly trpc;
+    /** Entities API - Generic entity operations */
+    readonly entities: EntitiesAPI;
+    /** Relations API - Relationship management */
+    readonly relations: RelationsAPI;
+    /** Events API - Event history and replay */
+    readonly events: EventsAPI;
+    constructor(config: SynapSDKConfig);
+    /**
+     * Get direct access to underlying tRPC client
+     * Use this for advanced operations not covered by SDK APIs
+     */
+    get client(): TRPCClient;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,KAAK,WAAW,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzE;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACnB,2BAA2B;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,+CAA+C;IAC/C,SAAgB,QAAQ,EAAE,WAAW,CAAC;IAEtC,8CAA8C;IAC9C,SAAgB,SAAS,EAAE,YAAY,CAAC;IAExC,4CAA4C;IAC5C,SAAgB,MAAM,EAAE,SAAS,CAAC;gBAEtB,MAAM,EAAE,cAAc;IAgBlC;;;OAGG;IACH,IAAI,MAAM,IAAI,UAAU,CAEvB;CACF"}

package/dist/client.js

@@ -0,0 +1,58 @@
+/**
+ * SynapSDK - Main SDK Client
+ *
+ * Provides high-level APIs for interacting with Synap Data Pod.
+ * All mutations go through event sourcing, all queries are direct reads.
+ */
+import { createSynapClient } from '@synap/client';
+import { EntitiesAPI } from './resources/entities.js';
+import { RelationsAPI } from './resources/relations.js';
+import { EventsAPI } from './resources/events.js';
+/**
+ * Synap SDK - High-Level Client
+ *
+ * @example
+ * ```typescript
+ * const synap = new SynapSDK({
+ *   url: 'https://api.synap.app',
+ *   apiKey: 'sk_...'
+ * });
+ *
+ * // Use resource APIs
+ * const task = await synap.entities.create({ type: 'task', title: 'Call Marie' });
+ * await synap.relations.create(task.id, personId, 'assigned_to');
+ * const history = await synap.events.getHistory(task.id);
+ * ```
+ */
+export class SynapSDK {
+    /** Internal tRPC client */
+    trpc;
+    /** Entities API - Generic entity operations */
+    entities;
+    /** Relations API - Relationship management */
+    relations;
+    /** Events API - Event history and replay */
+    events;
+    constructor(config) {
+        // Create underlying tRPC client
+        this.trpc = createSynapClient({
+            url: config.url,
+            headers: config.apiKey
+                ? { Authorization: `Bearer ${config.apiKey}` }
+                : config.headers,
+            fetch: config.fetch,
+        });
+        // Initialize resource APIs
+        this.entities = new EntitiesAPI(this.trpc);
+        this.relations = new RelationsAPI(this.trpc);
+        this.events = new EventsAPI(this.trpc);
+    }
+    /**
+     * Get direct access to underlying tRPC client
+     * Use this for advanced operations not covered by SDK APIs
+     */
+    get client() {
+        return this.trpc;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAkC,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA8BlD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,QAAQ;IACnB,2BAA2B;IACV,IAAI,CAAa;IAElC,+CAA+C;IAC/B,QAAQ,CAAc;IAEtC,8CAA8C;IAC9B,SAAS,CAAe;IAExC,4CAA4C;IAC5B,MAAM,CAAY;IAElC,YAAY,MAAsB;QAChC,gCAAgC;QAChC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;YAC5B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,OAAO,EAAE,MAAM,CAAC,MAAM;gBACpB,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE;gBAC9C,CAAC,CAAC,MAAM,CAAC,OAAO;YAClB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @synap/sdk - High-Level SDK for Synap
+ *
+ * Event-sourced personal data platform SDK with type-safe APIs.
+ *
+ * @example
+ * ```typescript
+ * import { SynapSDK } from '@synap/sdk';
+ *
+ * const synap = new SynapSDK({
+ *   url: 'https://api.synap.app',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Create entity (event-sourced)
+ * const task = await synap.entities.create({
+ *   type: 'task',
+ *   title: 'Call Marie',
+ *   metadata: { dueDate: '2024-12-20', priority: 'high' }
+ * });
+ *
+ * // Create relationship (event-sourced)
+ * await synap.relations.create(taskId, personId, 'assigned_to');
+ *
+ * // Query data (direct read)
+ * const tasks = await synap.entities.list({ type: 'task' });
+ * const history = await synap.events.getHistory(taskId);
+ * ```
+ */
+export { SynapSDK, type SynapSDKConfig } from './client.js';
+export { EntitiesAPI } from './resources/entities.js';
+export { RelationsAPI } from './resources/relations.js';
+export { EventsAPI } from './resources/events.js';
+export type { EntityType, EntityMetadata, Entity, NewEntity, UpdateEntity, } from '@synap/types/entities';
+export type { Relation, RelationType, } from './types/relations.js';
+export type { Event, EventFilter, } from './types/events.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,YAAY,EACV,UAAU,EACV,cAAc,EACd,MAAM,EACN,SAAS,EACT,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,QAAQ,EACR,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,KAAK,EACL,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @synap/sdk - High-Level SDK for Synap
+ *
+ * Event-sourced personal data platform SDK with type-safe APIs.
+ *
+ * @example
+ * ```typescript
+ * import { SynapSDK } from '@synap/sdk';
+ *
+ * const synap = new SynapSDK({
+ *   url: 'https://api.synap.app',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Create entity (event-sourced)
+ * const task = await synap.entities.create({
+ *   type: 'task',
+ *   title: 'Call Marie',
+ *   metadata: { dueDate: '2024-12-20', priority: 'high' }
+ * });
+ *
+ * // Create relationship (event-sourced)
+ * await synap.relations.create(taskId, personId, 'assigned_to');
+ *
+ * // Query data (direct read)
+ * const tasks = await synap.entities.list({ type: 'task' });
+ * const history = await synap.events.getHistory(taskId);
+ * ```
+ */
+export { SynapSDK } from './client.js';
+export { EntitiesAPI } from './resources/entities.js';
+export { RelationsAPI } from './resources/relations.js';
+export { EventsAPI } from './resources/events.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,QAAQ,EAAuB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/resources/entities.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Entities API - Generic Entity Operations
+ *
+ * ALL MUTATIONS are event-sourced (go through events.log)
+ * ALL QUERIES are direct reads (fast)
+ */
+import type { SynapClient } from '@synap/client';
+import type { EntityType } from '@synap/types/entities';
+export interface CreateEntityInput<T extends EntityType = EntityType> {
+    type: T;
+    title: string;
+    preview?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateEntityInput {
+    title?: string;
+    preview?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ListEntitiesOptions {
+    type?: EntityType;
+    limit?: number;
+}
+export interface SearchOptions {
+    query: string;
+    types?: EntityType[];
+    limit?: number;
+}
+/**
+ * Entities API
+ *
+ * @example
+ * ```typescript
+ * // Create task (event-sourced)
+ * const task = await sdk.entities.create({
+ *   type: 'task',
+ *   title: 'Call Marie',
+ *   metadata: { dueDate: '2024-12-20', priority: 'high' }
+ * });
+ *
+ * // Get entity (direct read)
+ * const entity = await sdk.entities.get(task.id);
+ *
+ * // List entities (direct read)
+ * const tasks = await sdk.entities.list({ type: 'task' });
+ * ```
+ */
+export declare class EntitiesAPI {
+    private readonly client;
+    constructor(client: SynapClient);
+    /**
+     * Create entity (event-sourced)
+     *
+     * Publishes `entities.create.requested` event → entitiesWorker → DB
+     */
+    create<T extends EntityType>(input: CreateEntityInput<T>): Promise<{
+        entityId: string;
+    }>;
+    /**
+     * Update entity (event-sourced)
+     *
+     * Publishes `entities.update.requested` event → entitiesWorker → DB
+     */
+    update(id: string, input: UpdateEntityInput): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Delete entity (event-sourced soft delete)
+     *
+     * Publishes `entities.delete.requested` event → entitiesWorker → DB
+     */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get entity by ID (direct read)
+     */
+    get(id: string): Promise<{
+        type: string;
+        userId: string;
+        version: number;
+        id: string;
+        title: string | null;
+        preview: string | null;
+        documentId: string | null;
+        fileUrl: string | null;
+        filePath: string | null;
+        fileSize: number | null;
+        fileType: string | null;
+        checksum: string | null;
+        createdAt: string;
+        updatedAt: string;
+        deletedAt: string | null;
+        metadata?: unknown;
+    }>;
+    /**
+     * List entities (direct read)
+     */
+    list(options?: ListEntitiesOptions): Promise<{
+        type: string;
+        userId: string;
+        version: number;
+        id: string;
+        title: string | null;
+        preview: string | null;
+        documentId: string | null;
+        fileUrl: string | null;
+        filePath: string | null;
+        fileSize: number | null;
+        fileType: string | null;
+        checksum: string | null;
+        createdAt: string;
+        updatedAt: string;
+        deletedAt: string | null;
+        metadata?: unknown;
+    }[]>;
+    /**
+     * Search entities (direct read)
+     */
+    search(options: SearchOptions): Promise<{
+        type: string;
+        userId: string;
+        version: number;
+        id: string;
+        title: string | null;
+        preview: string | null;
+        documentId: string | null;
+        fileUrl: string | null;
+        filePath: string | null;
+        fileSize: number | null;
+        fileType: string | null;
+        checksum: string | null;
+        createdAt: string;
+        updatedAt: string;
+        deletedAt: string | null;
+        metadata?: unknown;
+    }[]>;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/resources/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IAClE,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;OAIG;IACG,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB9F;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBjF;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBvD;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;IAKpB;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,mBAAwB;;;;;;;;;;;;;;;;;;IAQ5C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa;;;;;;;;;;;;;;;;;;CAQpC"}

package/dist/resources/entities.js

@@ -0,0 +1,126 @@
+/**
+ * Entities API - Generic Entity Operations
+ *
+ * ALL MUTATIONS are event-sourced (go through events.log)
+ * ALL QUERIES are direct reads (fast)
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Entities API
+ *
+ * @example
+ * ```typescript
+ * // Create task (event-sourced)
+ * const task = await sdk.entities.create({
+ *   type: 'task',
+ *   title: 'Call Marie',
+ *   metadata: { dueDate: '2024-12-20', priority: 'high' }
+ * });
+ *
+ * // Get entity (direct read)
+ * const entity = await sdk.entities.get(task.id);
+ *
+ * // List entities (direct read)
+ * const tasks = await sdk.entities.list({ type: 'task' });
+ * ```
+ */
+export class EntitiesAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create entity (event-sourced)
+     *
+     * Publishes `entities.create.requested` event → entitiesWorker → DB
+     */
+    async create(input) {
+        const entityId = randomUUID();
+        // Call events.log to publish create event
+        await this.client.events.log.mutate({
+            aggregateId: entityId,
+            aggregateType: 'entity',
+            eventType: 'entities.create.requested',
+            data: {
+                id: entityId,
+                entityType: input.type,
+                title: input.title,
+                preview: input.preview,
+                content: input.content,
+                metadata: input.metadata,
+            },
+            metadata: {},
+            version: 1,
+            source: 'api',
+        });
+        return { entityId };
+    }
+    /**
+     * Update entity (event-sourced)
+     *
+     * Publishes `entities.update.requested` event → entitiesWorker → DB
+     */
+    async update(id, input) {
+        await this.client.events.log.mutate({
+            aggregateId: id,
+            aggregateType: 'entity',
+            eventType: 'entities.update.requested',
+            data: {
+                entityId: id,
+                ...input,
+            },
+            metadata: {},
+            version: 1, // TODO: Get actual version
+            source: 'api',
+        });
+        return { success: true };
+    }
+    /**
+     * Delete entity (event-sourced soft delete)
+     *
+     * Publishes `entities.delete.requested` event → entitiesWorker → DB
+     */
+    async delete(id) {
+        await this.client.events.log.mutate({
+            aggregateId: id,
+            aggregateType: 'entity',
+            eventType: 'entities.delete.requested',
+            data: {
+                entityId: id,
+            },
+            metadata: {},
+            version: 1,
+            source: 'api',
+        });
+        return { success: true };
+    }
+    /**
+     * Get entity by ID (direct read)
+     */
+    async get(id) {
+        const result = await this.client.entities.get.query({ id });
+        return result.entity;
+    }
+    /**
+     * List entities (direct read)
+     */
+    async list(options = {}) {
+        const result = await this.client.entities.list.query({
+            type: options.type, // Type cast because router has different enum
+            limit: options.limit || 50,
+        });
+        return result.entities;
+    }
+    /**
+     * Search entities (direct read)
+     */
+    async search(options) {
+        const result = await this.client.entities.search.query({
+            query: options.query,
+            type: options.types?.[0], // Type cast because router has different enum
+            limit: options.limit || 10,
+        });
+        return result.entities;
+    }
+}
+//# sourceMappingURL=entities.js.map

package/dist/resources/entities.js.map

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

package/dist/resources/events.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Events API - Event History and Replay
+ *
+ * ALL OPERATIONS are direct reads (query event log)
+ */
+import type { SynapClient } from '@synap/client';
+import type { Event, EventFilter } from '../types/events.js';
+/**
+ * Events API
+ *
+ * @example
+ * ```typescript
+ * // Get event history for an entity
+ * const history = await sdk.events.getHistory(taskId);
+ *
+ * // Get user's event timeline
+ * const timeline = await sdk.events.getTimeline({
+ *   limit: 100,
+ *   after: new Date('2024-01-01')
+ * });
+ *
+ * // Filter by event types
+ * const creates = await sdk.events.getHistory(entityId, {
+ *   eventTypes: ['entities.create.validated', 'entities.update.validated']
+ * });
+ * ```
+ */
+export declare class EventsAPI {
+    private readonly client;
+    constructor(client: SynapClient);
+    /**
+     * Get event history for a specific subject (entity, relation, etc.)
+     *
+     * Returns all events related to the subject in chronological order
+     */
+    getHistory(subjectId: string, options?: Omit<EventFilter, 'subjectId'>): Promise<Event[]>;
+    /**
+     * Get user's complete event timeline
+     *
+     * Returns all events for the current user
+     */
+    getTimeline(options?: EventFilter): Promise<Event[]>;
+    /**
+     * Replay events to rebuild entity state
+     *
+     * Note: This is a client-side replay for now.
+     * For production, server-side projector rebuild is recommended.
+     */
+    replay(subjectId: string): Promise<any>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/resources/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;OAIG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAM,GAC3C,OAAO,CAAC,KAAK,EAAE,CAAC;IAmBnB;;;;OAIG;IACG,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAS9D;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAyB9C"}

package/dist/resources/events.js

@@ -0,0 +1,92 @@
+/**
+ * Events API - Event History and Replay
+ *
+ * ALL OPERATIONS are direct reads (query event log)
+ */
+/**
+ * Events API
+ *
+ * @example
+ * ```typescript
+ * // Get event history for an entity
+ * const history = await sdk.events.getHistory(taskId);
+ *
+ * // Get user's event timeline
+ * const timeline = await sdk.events.getTimeline({
+ *   limit: 100,
+ *   after: new Date('2024-01-01')
+ * });
+ *
+ * // Filter by event types
+ * const creates = await sdk.events.getHistory(entityId, {
+ *   eventTypes: ['entities.create.validated', 'entities.update.validated']
+ * });
+ * ```
+ */
+export class EventsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get event history for a specific subject (entity, relation, etc.)
+     *
+     * Returns all events related to the subject in chronological order
+     */
+    async getHistory(subjectId, options = {}) {
+        const events = await this.client.events.list.query({
+            // Note: The current events.list doesn't support subjectId filter
+            // For now, we'll get all events and filter client-side
+            // TODO: Enhance events.list router to support subjectId
+            limit: options.limit || 50,
+            type: options.eventTypes?.[0], // Current API only supports single type
+        });
+        // Client-side filter by subjectId
+        // TODO: Move this to server-side once router enhanced
+        // Type cast to any because Event shape from router doesn't match our SDK Event type
+        return events.filter((event) => event.data?.entityId === subjectId ||
+            event.data?.relationId === subjectId ||
+            event.data?.subjectId === subjectId);
+    }
+    /**
+     * Get user's complete event timeline
+     *
+     * Returns all events for the current user
+     */
+    async getTimeline(options = {}) {
+        const events = await this.client.events.list.query({
+            limit: options.limit || 50,
+            type: options.eventTypes?.[0],
+        });
+        return events;
+    }
+    /**
+     * Replay events to rebuild entity state
+     *
+     * Note: This is a client-side replay for now.
+     * For production, server-side projector rebuild is recommended.
+     */
+    async replay(subjectId) {
+        const events = await this.getHistory(subjectId);
+        // Simple event replay (can be enhanced)
+        let state = {};
+        for (const event of events) {
+            switch (event.type) {
+                case 'entity.created':
+                case 'entities.create.validated':
+                    state = { ...event.data };
+                    break;
+                case 'entity.updated':
+                case 'entities.update.validated':
+                    state = { ...state, ...event.data };
+                    break;
+                case 'entity.deleted':
+                case 'entities.delete.validated':
+                    state.deletedAt = event.timestamp;
+                    break;
+            }
+        }
+        return state;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/resources/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;OAIG;IACH,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,UAA0C,EAAE;QAE5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACjD,iEAAiE;YACjE,uDAAuD;YACvD,wDAAwD;YACxD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,wCAAwC;SACxE,CAAC,CAAC;QAEH,kCAAkC;QAClC,sDAAsD;QACtD,oFAAoF;QACpF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CAClC,KAAK,CAAC,IAAI,EAAE,QAAQ,KAAK,SAAS;YAClC,KAAK,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS;YACpC,KAAK,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS,CAC3B,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,UAAuB,EAAE;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;SAC9B,CAAC,CAAC;QAEH,OAAO,MAAe,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEhD,wCAAwC;QACxC,IAAI,KAAK,GAAQ,EAAE,CAAC;QAEpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,gBAAgB,CAAC;gBACtB,KAAK,2BAA2B;oBAC9B,KAAK,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC1B,MAAM;gBACR,KAAK,gBAAgB,CAAC;gBACtB,KAAK,2BAA2B;oBAC9B,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;oBACpC,MAAM;gBACR,KAAK,gBAAgB,CAAC;gBACtB,KAAK,2BAA2B;oBAC9B,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;oBAClC,MAAM;YACV,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/resources/relations.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Relations API - Universal Relationship Management
+ *
+ * ALL MUTATIONS are event-sourced (go through events.log)
+ * ALL QUERIES are direct reads (fast)
+ */
+import type { SynapClient } from '@synap/client';
+import type { RelationType, Relation, RelationFilter } from '../types/relations.js';
+/**
+ * Relations API
+ *
+ * @example
+ * ```typescript
+ * // Create relationship (event-sourced)
+ * await sdk.relations.create(taskId, personId, 'assigned_to');
+ *
+ * // Get relations (direct read)
+ * const relations = await sdk.relations.get(entityId, {
+ *   type: 'assigned_to',
+ *   direction: 'both'
+ * });
+ *
+ * // Get related entities (direct read)
+ * const people = await sdk.relations.getRelated(taskId, {
+ *   type: 'assigned_to',
+ *   direction: 'source'
+ * });
+ * ```
+ */
+export declare class RelationsAPI {
+    private readonly client;
+    constructor(client: SynapClient);
+    /**
+     * Create relationship (event-sourced)
+     *
+     * Publishes `relations.create.requested` event → relationsWorker → DB
+     *
+     * @param sourceId - Source entity ID
+     * @param targetId - Target entity ID
+     * @param type - Relationship type
+     * @param metadata - Optional metadata
+     */
+    create(sourceId: string, targetId: string, type: RelationType | string, metadata?: Record<string, unknown>): Promise<{
+        relationId: string;
+    }>;
+    /**
+     * Delete relationship (event-sourced)
+     *
+     * Publishes `relations.delete.requested` event → relationsWorker → DB
+     */
+    delete(relationId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get relations for an entity (direct read)
+     *
+     * Returns relationship records (not the related entities themselves)
+     */
+    get(entityId: string, options?: Omit<RelationFilter, 'entityId'>): Promise<Relation[]>;
+    /**
+     * Get related entities (direct read with join)
+     *
+     * Returns the actual entity objects that are related
+     */
+    getRelated(entityId: string, options?: Omit<RelationFilter, 'entityId'>): Promise<any>;
+    /**
+     * Get relation statistics for an entity (direct read)
+     */
+    getStats(entityId: string): Promise<any>;
+}
+//# sourceMappingURL=relations.d.ts.map

package/dist/resources/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/resources/relations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGpF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;;;;;OASG;IACG,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,GAAG,MAAM,EAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAsBlC;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgB/D;;;;OAIG;IACG,GAAG,CACP,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAM,GAC7C,OAAO,CAAC,QAAQ,EAAE,CAAC;IAYtB;;;;OAIG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAM;IAahD;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM;CAKhC"}

package/dist/resources/relations.js

@@ -0,0 +1,121 @@
+/**
+ * Relations API - Universal Relationship Management
+ *
+ * ALL MUTATIONS are event-sourced (go through events.log)
+ * ALL QUERIES are direct reads (fast)
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Relations API
+ *
+ * @example
+ * ```typescript
+ * // Create relationship (event-sourced)
+ * await sdk.relations.create(taskId, personId, 'assigned_to');
+ *
+ * // Get relations (direct read)
+ * const relations = await sdk.relations.get(entityId, {
+ *   type: 'assigned_to',
+ *   direction: 'both'
+ * });
+ *
+ * // Get related entities (direct read)
+ * const people = await sdk.relations.getRelated(taskId, {
+ *   type: 'assigned_to',
+ *   direction: 'source'
+ * });
+ * ```
+ */
+export class RelationsAPI {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create relationship (event-sourced)
+     *
+     * Publishes `relations.create.requested` event → relationsWorker → DB
+     *
+     * @param sourceId - Source entity ID
+     * @param targetId - Target entity ID
+     * @param type - Relationship type
+     * @param metadata - Optional metadata
+     */
+    async create(sourceId, targetId, type, metadata) {
+        const relationId = randomUUID();
+        await this.client.events.log.mutate({
+            aggregateId: relationId,
+            aggregateType: 'relation',
+            eventType: 'relations.create.requested',
+            data: {
+                id: relationId,
+                sourceEntityId: sourceId,
+                targetEntityId: targetId,
+                type,
+                metadata,
+            },
+            metadata: {},
+            version: 1,
+            source: 'api',
+        });
+        return { relationId };
+    }
+    /**
+     * Delete relationship (event-sourced)
+     *
+     * Publishes `relations.delete.requested` event → relationsWorker → DB
+     */
+    async delete(relationId) {
+        await this.client.events.log.mutate({
+            aggregateId: relationId,
+            aggregateType: 'relation',
+            eventType: 'relations.delete.requested',
+            data: {
+                relationId,
+            },
+            metadata: {},
+            version: 1,
+            source: 'api',
+        });
+        return { success: true };
+    }
+    /**
+     * Get relations for an entity (direct read)
+     *
+     * Returns relationship records (not the related entities themselves)
+     */
+    async get(entityId, options = {}) {
+        // Type assertion needed because relations router not in AppRouter type yet
+        const result = await this.client.relations.get.query({
+            entityId,
+            type: options.type,
+            direction: options.direction || 'both',
+            limit: options.limit || 50,
+        });
+        return result.relations;
+    }
+    /**
+     * Get related entities (direct read with join)
+     *
+     * Returns the actual entity objects that are related
+     */
+    async getRelated(entityId, options = {}) {
+        // Type assertion needed because relations router not in AppRouter type yet  
+        const result = await this.client.relations.getRelated.query({
+            entityId,
+            type: options.type,
+            direction: options.direction || 'both',
+            limit: options.limit || 50,
+        });
+        return result.entities;
+    }
+    /**
+     * Get relation statistics for an entity (direct read)
+     */
+    async getStats(entityId) {
+        // Type assertion needed because relations router not in AppRouter type yet
+        const result = await this.client.relations.getStats.query({ entityId });
+        return result;
+    }
+}
+//# sourceMappingURL=relations.js.map

package/dist/resources/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/resources/relations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,QAAgB,EAChB,IAA2B,EAC3B,QAAkC;QAElC,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;QAEhC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAClC,WAAW,EAAE,UAAU;YACvB,aAAa,EAAE,UAAU;YACzB,SAAS,EAAE,4BAA4B;YACvC,IAAI,EAAE;gBACJ,EAAE,EAAE,UAAU;gBACd,cAAc,EAAE,QAAQ;gBACxB,cAAc,EAAE,QAAQ;gBACxB,IAAI;gBACJ,QAAQ;aACT;YACD,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QAEH,OAAO,EAAE,UAAU,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;YAClC,WAAW,EAAE,UAAU;YACvB,aAAa,EAAE,UAAU;YACzB,SAAS,EAAE,4BAA4B;YACvC,IAAI,EAAE;gBACJ,UAAU;aACX;YACD,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CACP,QAAgB,EAChB,UAA4C,EAAE;QAE9C,2EAA2E;QAC3E,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,MAAc,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAC5D,QAAQ;YACR,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;SAC3B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,SAAuB,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,UAA4C,EAAE;QAE9C,6EAA6E;QAC7E,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,MAAc,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;YACnE,QAAQ;YACR,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;SAC3B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,2EAA2E;QAC3E,MAAM,MAAM,GAAG,MAAO,IAAI,CAAC,MAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/types/events.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Event Types
+ */
+export interface Event {
+    id: string;
+    timestamp: Date;
+    type: string;
+    subjectId: string;
+    subjectType: string;
+    data: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    source: string;
+    correlationId?: string;
+    userId: string;
+}
+export interface EventFilter {
+    subjectId?: string;
+    subjectType?: string;
+    eventTypes?: string[];
+    limit?: number;
+    after?: Date;
+    before?: Date;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,CAAC;CACf"}

package/dist/types/events.js

@@ -0,0 +1,5 @@
+/**
+ * Event Types
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/relations.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Relation Types
+ */
+export type RelationType = 'assigned_to' | 'mentions' | 'links_to' | 'parent_of' | 'relates_to' | 'tagged_with' | 'created_by' | 'attended_by' | 'depends_on' | 'blocks';
+export interface Relation {
+    id: string;
+    userId: string;
+    sourceEntityId: string;
+    targetEntityId: string;
+    type: RelationType | string;
+    createdAt: Date;
+}
+export interface NewRelation {
+    id?: string;
+    sourceEntityId: string;
+    targetEntityId: string;
+    type: RelationType | string;
+    metadata?: Record<string, unknown>;
+}
+export interface RelationFilter {
+    entityId: string;
+    type?: RelationType | string;
+    direction?: 'source' | 'target' | 'both';
+    limit?: number;
+}
+//# sourceMappingURL=relations.d.ts.map

package/dist/types/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/types/relations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,UAAU,GACV,UAAU,GACV,WAAW,GACX,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/relations.js

@@ -0,0 +1,5 @@
+/**
+ * Relation Types
+ */
+export {};
+//# sourceMappingURL=relations.js.map

package/dist/types/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/types/relations.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@synap-core/sdk",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "High-level SDK for Synap - Event-sourced personal data platform",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "keywords": [
+    "synap",
+    "sdk",
+    "event-sourcing",
+    "personal-data",
+    "knowledge-graph"
+  ],
+  "author": "Synap Team",
+  "license": "AGPL-3.0",
+  "dependencies": {
+    "@synap-core/client": "^0.1.0",
+    "@synap-core/types": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/synap-core/synap-backend",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/synap-core/synap-backend#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}