@fonderie/audit 1.0.0 → 2.0.0

package/brain/outcomes.md

@@ -0,0 +1,14 @@
+<!-- GENERATED — do not edit. Regenerate with: npm run docs:signatures -->
+
+# @fonderie/audit — outcomes
+
+What this package does to a running app: tables its migrations create,
+rows it seeds, routes it registers. Generated from the migration SQL and
+route tables in source — trust this file instead of reading `dist/` or
+downloading tarballs.
+
+## HTTP routes registered
+
+| Method | Path | Middleware chain (auth / validation / handler) |
+|---|---|---|
+| GET | `/audit` | `requireAuth → async (ctx) => { if (!ctx.workspace) return setApiResponse( HTTP.UNPROCESSABLE, 'MISSING_WORKSPACE', 'Workspace context required', ); const url = new URL(ctx.request.url); const params = url.searchParams; const limit = Math.min(Number(params.get('limit') ?? 50), 200); const type = params.get('type') ?? undefined; const actor = params.get('actorId') ?? undefined; const from = params.get('from') ? new Date(params.get('from')!) : undefined; const to = params.get('to') ? new Date(params.get('to')!) : undefined; const cursor = params.get('cursor') ?? undefined; const query: Parameters<AuditEventModel['list']>[0] = { workspaceId: ctx.workspace.id, limit: limit + 1, }; if (type) query.type = type; if (actor) query.actorId = actor; if (from) query.from = from; if (to) query.to = to; if (cursor) query.cursor = cursor; const events = await new AuditEventModel(store).list(query); // fetch one extra to determine if there's a next page const hasMore = events.length > limit; const page = hasMore ? events.slice(0, limit) : events; const lastEvent = page[page.length - 1]; const nextCursor = hasMore && lastEvent ? encodeCursor(lastEvent.createdAt, lastEvent.id) : null; return setApiResponse(HTTP.OK, 'AUDIT_FETCHED', 'Audit events retrieved.', { events: page.map(toAuditEventDTO), nextCursor, }); }` |

package/brain/signatures.md

@@ -0,0 +1,44 @@
+<!-- GENERATED — do not edit. Regenerate with: npm run docs:signatures -->
+
+# @fonderie/audit — signatures
+
+## @fonderie/audit
+
+```ts
+new AuditModule(store: IStoreAdapter): AuditModule
+  .name: "@fonderie/audit"
+  .deps: string[]
+  .install(app: IFonderieApp): void
+
+interface IAuditEvent {
+    id: string;
+    type: string;
+    payload: Record<string, unknown>;
+    meta: Record<string, unknown>;
+    createdAt: Date;
+}
+
+interface IAuditQuery {
+    workspaceId: string;
+    type?: string;
+    actorId?: string;
+    from?: Date;
+    to?: Date;
+    limit?: number;
+    cursor?: string;
+}
+
+interface IAuditEventDTO {
+    id: string;
+    type: string;
+    actorId: string | null;
+    requestId: string | null;
+    payload: Record<string, unknown>;
+    createdAt: string;
+}
+
+interface IAuditPageDTO {
+    events: IAuditEventDTO[];
+    nextCursor: string | null;
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fonderie/audit",
-	"version": "1.0.0",
+	"version": "2.0.0",
 	"description": "Workspace-scoped audit log — query fonderie_events for a human-readable activity trail.",
 	"keywords": [
 		"fonderie-js",
@@ -34,8 +34,8 @@
 		"check": "biome check --write src"
 	},
 	"peerDependencies": {
-		"@fonderie/core": "^0.1.0",
-		"@fonderie/store": "^0.1.0"
+		"@fonderie/core": "^0.2.0",
+		"@fonderie/store": "^0.1.1"
 	},
 	"devDependencies": {
 		"@fonderie/core": "../core",
@@ -50,16 +50,17 @@
 	},
 	"files": [
 		"dist",
+		"brain",
 		"LICENSE",
 		"README.md"
 	],
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/fonderie-js/sdk.git",
+		"url": "git+https://github.com/fonderiejs/sdk.git",
 		"directory": "packages/audit"
 	},
-	"homepage": "https://github.com/fonderie-js/sdk/tree/main/packages/audit#readme",
+	"homepage": "https://github.com/fonderiejs/sdk/tree/main/packages/audit#readme",
 	"bugs": {
-		"url": "https://github.com/fonderie-js/sdk/issues"
+		"url": "https://github.com/fonderiejs/sdk/issues"
 	}
 }