@kelpie/server 0.7.0 → 0.9.0

package/src/modules/sample-data/index.ts

@@ -0,0 +1,51 @@
+import type { KelpieModule } from '../../runtime/module.ts'
+import { mountSampleDataRoutes } from './routes.ts'
+import { createSampleDataService } from './service.ts'
+import { registerSampleDataTools } from './tools.ts'
+
+/**
+ * Sample data: one-shot fixture install for a new workspace.
+ *
+ * Owns no tables. Requires the modules whose tables the fixture writes into.
+ * A workspace admin invokes it from the setup wizard or from the admin data
+ * page; an agent invokes it through the matching MCP tool.
+ */
+export function createSampleDataModule(): KelpieModule {
+  return {
+    id: 'sample-data',
+    requires: [
+      'workspace',
+      'pipelines',
+      'companies',
+      'people',
+      'positions',
+      'deals',
+      'plans',
+      'notes',
+      'opportunities',
+      'raises',
+      'partnerships',
+      'enquiries',
+      'hiring',
+    ],
+
+    register(context) {
+      const service = createSampleDataService({
+        db: context.db,
+        transaction: context.transaction,
+        createId: context.createId,
+        now: context.now,
+      })
+
+      context.routes((router) => {
+        mountSampleDataRoutes(router, { db: context.db, now: context.now, service })
+      })
+
+      registerSampleDataTools(context.mcp, service)
+
+      return Promise.resolve()
+    },
+  }
+}
+
+export type { SampleDataCounts, SampleDataService } from './service.ts'

package/src/modules/sample-data/routes.ts

@@ -0,0 +1,50 @@
+import type { Context, Hono } from 'hono'
+
+import type { Actor } from '../auth/actor.ts'
+import { resolveActorFrom } from '../auth/credentials.ts'
+import type { CredentialDependencies } from '../auth/credentials.ts'
+import type { SampleDataCounts, SampleDataService } from './service.ts'
+
+/**
+ * Wire shape for `POST /v1/workspaces/:id/sample-data`.
+ *
+ * No request body: the installer takes no options today. Any option we add
+ * later goes on the body, not the URL.
+ */
+
+export interface SampleDataRoutesDependencies extends CredentialDependencies {
+  readonly service: SampleDataService
+}
+
+export function sampleDataResponse(counts: SampleDataCounts): Record<string, unknown> {
+  return {
+    companies: counts.companies,
+    people: counts.people,
+    positions: counts.positions,
+    deals: counts.deals,
+    plan_items: counts.planItems,
+    notes: counts.notes,
+    opportunities: counts.opportunities,
+    raises: counts.raises,
+    partnerships: counts.partnerships,
+    enquiries: counts.enquiries,
+    roles: counts.roles,
+    candidates: counts.candidates,
+  }
+}
+
+export function mountSampleDataRoutes(
+  router: Hono,
+  dependencies: SampleDataRoutesDependencies,
+): void {
+  const requireActor = (context: Context): Promise<Actor> => resolveActorFrom(dependencies, context)
+
+  router.post('/workspaces/:id/sample-data', async (context) => {
+    const counts = await dependencies.service.install(
+      await requireActor(context),
+      context.req.param('id'),
+    )
+
+    return context.json(sampleDataResponse(counts), 201)
+  })
+}