@synap-core/api-types 1.0.9 → 1.0.10

package/dist/index.d.ts

@@ -1,18 +1,39 @@
+import * as _trpc_server from '@trpc/server';
+import { z } from 'zod';
+import * as _synap_core_types from '@synap-core/types';
 // Generated by dts-bundle-generator v9.5.1
 
 import { Sql } from 'postgres';
 
-type FilterOperator = "equals" | "not_equals" | "contains" | "not_contains" | "in" | "not_in" | "is_empty" | "is_not_empty" | "greater_than" | "less_than" | "greater_than_or_equal" | "less_than_or_equal";
-interface EntityFilter {
+/**
+ * View Query Types
+ *
+ * Single source of truth for all view query and filter types.
+ */
+/**
+ * Filter operator types
+ */
+export type FilterOperator = "equals" | "not_equals" | "contains" | "not_contains" | "in" | "not_in" | "is_empty" | "is_not_empty" | "greater_than" | "less_than" | "greater_than_or_equal" | "less_than_or_equal";
+/**
+ * Filter definition for entity queries
+ */
+export interface EntityFilter {
 	field: string;
 	operator: FilterOperator;
 	value?: unknown;
 }
-interface SortRule {
+/**
+ * Sort rule for entity queries
+ */
+export interface SortRule {
 	field: string;
 	direction: "asc" | "desc";
 }
-interface EntityQuery {
+/**
+ * Query definition for structured views
+ * Defines which entities to show and how to filter them
+ */
+export interface EntityQuery {
 	/** Entity types to include */
 	entityTypes?: string[];
 	/** Specific entity IDs (for fixed sets) */
@@ -30,7 +51,7 @@ interface EntityQuery {
 	/** Group by field (for kanban, timeline) */
 	groupBy?: string;
 }
-interface ColumnDisplayConfig {
+export interface ColumnDisplayConfig {
 	type: "text" | "badge" | "date" | "user" | "url" | "boolean" | "progress" | "rating" | "image" | "file";
 	params?: {
 		colors?: Record<string, string>;
@@ -44,7 +65,7 @@ interface ColumnDisplayConfig {
 		icon?: string;
 	};
 }
-interface ColumnConfig {
+export interface ColumnConfig {
 	id: string;
 	field: string;
 	width?: number;
@@ -52,7 +73,7 @@ interface ColumnConfig {
 	title?: string;
 	display?: ColumnDisplayConfig;
 }
-interface FormattingRule {
+export interface FormattingRule {
 	id: string;
 	name?: string;
 	target: "row" | "cell" | "card";
@@ -66,7 +87,7 @@ interface FormattingRule {
 		icon?: string;
 	};
 }
-interface RenderSettings {
+export interface RenderSettings {
 	rowHeight?: "compact" | "default" | "tall";
 	formatting?: FormattingRule[];
 	columns?: ColumnConfig[];
@@ -85,12 +106,20 @@ interface RenderSettings {
 	nodeColorField?: string;
 	edgeLabelField?: string;
 }
-interface StructuredViewConfig {
+export interface StructuredViewConfig {
 	category: "structured";
 	query: EntityQuery;
 	render?: RenderSettings;
 }
-interface WorkerMetadata {
+/**
+ * Worker Registry - Static worker metadata for Admin UI
+ *
+ * V2.0: Simplified registry with only active workers
+ *
+ * Pattern: Table workers handle {table}.{crud}.requested events
+ * and emit {table}.{crud}.completed events.
+ */
+export interface WorkerMetadata {
 	id: string;
 	name: string;
 	description: string;
@@ -98,7 +127,35 @@ interface WorkerMetadata {
 	outputs?: string[];
 	category: "table" | "shared" | "ai";
 }
-type TableAction = "create.requested" | "create.approved" | "create.validated" | "update.requested" | "update.approved" | "update.validated" | "delete.requested" | "delete.approved" | "delete.validated";
+/**
+ * @synap/events - Schema-Driven Event Generator
+ *
+ * This module generates event types and payload schemas from Drizzle database tables.
+ *
+ * V2.0 CONSOLIDATED PATTERN: {table}.{action}.{modifier}
+ *
+ * Actions: create | update | delete
+ * Modifiers: requested | validated
+ *
+ * Examples:
+ *   entities.create.requested  ← Intent submitted (by user or AI)
+ *   entities.create.validated  ← Change confirmed and applied
+ *   entities.update.requested  ← Update intent
+ *   entities.update.validated  ← Update confirmed
+ *
+ * No direct actions (e.g., entities.create) - all changes go through requested→validated flow.
+ */
+/**
+ * Standard CRUD actions with modifiers for table events
+ *
+ * V2.1: Added 'approved' modifier for 3-phase flow
+ *
+ * Flow:
+ *  1. requested: Intent (user/AI wants to do something)
+ *  2. approved: Validated (permissions checked, user approved if needed)
+ *  3. validated: Completed (DB operation done, entity exists)
+ */
+export type TableAction = "create.requested" | "create.approved" | "create.validated" | "update.requested" | "update.approved" | "update.validated" | "delete.requested" | "delete.approved" | "delete.validated";
 declare const CORE_TABLES: readonly [
 	"entities",
 	"documents",
@@ -114,9 +171,20 @@ declare const CORE_TABLES: readonly [
 	"views",
 	"userPreferences"
 ];
-type CoreTable = (typeof CORE_TABLES)[number];
-type GeneratedEventType = `${CoreTable}.create.requested` | `${CoreTable}.create.validated` | `${CoreTable}.update.requested` | `${CoreTable}.update.validated` | `${CoreTable}.delete.requested` | `${CoreTable}.delete.validated`;
-interface EventRecord {
+export type CoreTable = (typeof CORE_TABLES)[number];
+/**
+ * Flat list of all generated event types (for type checking)
+ *
+ * V2.0: Only requested/validated patterns
+ */
+export type GeneratedEventType = `${CoreTable}.create.requested` | `${CoreTable}.create.validated` | `${CoreTable}.update.requested` | `${CoreTable}.update.validated` | `${CoreTable}.delete.requested` | `${CoreTable}.delete.validated`;
+/**
+ * EventRecord - Database representation of an event
+ *
+ * This is the format returned from the database.
+ * It maps directly to the events_timescale table structure.
+ */
+export interface EventRecord {
 	id: string;
 	timestamp: Date;
 	aggregateId: string;
@@ -130,7 +198,12 @@ interface EventRecord {
 	correlationId?: string;
 	source: string;
 }
-interface Context extends Record<string, unknown> {
+/**
+ * tRPC Context
+ *
+ * PostgreSQL-only with Ory Kratos session authentication for multi-user support.
+ */
+export interface Context extends Record<string, unknown> {
 	db: any;
 	authenticated: boolean;
 	userId?: string | null;

package/dist/index.js

@@ -1,15 +0,0 @@
-/**
- * @synap/api-types
- *
- * Type-only exports for Synap API Router.
- * Frontend-safe package with no server dependencies.
- *
- * @example
- * ```typescript
- * import type { AppRouter } from '@synap/api-types';
- *
- * const trpc = createTRPCReact<AppRouter>();
- * ```
- */
-export {};
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synap-core/api-types",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Type definitions for Synap API Router - tRPC types for frontend",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "src"
   ],
   "scripts": {
-    "build": "dts-bundle-generator -o dist/index.d.ts src/index.ts --no-check --export-referenced-types=false --external-types=postgres",
+    "build": "dts-bundle-generator -o dist/index.d.ts src/index.ts --no-check && node scripts/inject-imports.js",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
@@ -25,6 +25,7 @@
   },
   "devDependencies": {
     "@synap/api": "workspace:*",
+    "@trpc/server": "^11.8.1",
     "drizzle-orm": "^0.45.1",
     "dts-bundle-generator": "^9.5.1",
     "postgres": "^3.4.8",

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js.map

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