@sylphx/contract 0.2.0 → 0.3.0

package/dist/endpoints/admin-audit.js

@@ -9,485 +9,485 @@
  * residual `AdminAuditUnknownResult` cases are documented inline.
  */
 import { defineEndpoint } from '../endpoint.js';
-import { AdminAuditAiLogsResult, AdminAuditAiRatesResult, AdminAuditAiResult, AdminAuditAiSummaryResult, AdminAuditAnalyticsResult, AdminAuditBillingResult, AdminAuditBillingUsageResult, AdminAuditChartsResult, AdminAuditDashboardResult, AdminAuditDateRangeQuery, AdminAuditHealthResult, AdminAuditMutationSuccess, AdminAuditObsLogsResult, AdminAuditObsMetricsRangeResult, AdminAuditObsMetricsResult, AdminAuditObsTracesResult, AdminAuditPaginationQuery, AdminAuditProjectOverviewResult, AdminAuditProjectParams, AdminAuditRunFilterQuery, AdminAuditRunsListResult, AdminAuditServiceEnvelope, AdminAuditServicesOverviewResult, AdminAuditTraceParams, AdminAuditTriggerParams, AdminAuditUnknownResult, AdminGetAuditLogsQuery, AdminGetAuditLogsResult, AdminGetRecentActivityQuery, AdminGetRecentActivityResult, } from '../schemas/admin-audit.js';
+import { AdminAuditAiLogsResult, AdminAuditAiRatesResult, AdminAuditAiResult, AdminAuditAiSummaryResult, AdminAuditAnalyticsResult, AdminAuditAnalyticsServiceResult, AdminAuditBillingResult, AdminAuditBillingUsageResult, AdminAuditChartsResult, AdminAuditConsentServiceResult, AdminAuditDashboardResult, AdminAuditDateRangeQuery, AdminAuditEmailServiceResult, AdminAuditHealthResult, AdminAuditJobsServiceResult, AdminAuditMutationSuccess, AdminAuditNewsletterServiceResult, AdminAuditObsLogsResult, AdminAuditObsMetricsRangeResult, AdminAuditObsMetricsResult, AdminAuditObsTracesResult, AdminAuditPaginationQuery, AdminAuditProjectOverviewResult, AdminAuditProjectParams, AdminAuditRunFilterQuery, AdminAuditRunsListResult, AdminAuditRunsServiceResult, AdminAuditServiceEnvelope, AdminAuditServicesOverviewResult, AdminAuditTraceParams, AdminAuditTriggerParams, AdminAuditTriggersServiceResult, AdminAuditUnknownResult, AdminGetAuditLogsQuery, AdminGetAuditLogsResult, AdminGetRecentActivityQuery, AdminGetRecentActivityResult, } from '../schemas/admin-audit.js';
 export const adminAuditEndpoints = {
     // ── Core audit log endpoints ───────────────────────────────────────────
     logs: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/logs',
+        path: '/operator/audit/logs',
         query: AdminGetAuditLogsQuery,
         response: AdminGetAuditLogsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Paginated audit logs with optional filtering and stats mode',
         tags: ['admin-audit'],
     }),
     activity: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/activity',
+        path: '/operator/audit/activity',
         query: AdminGetRecentActivityQuery,
         response: AdminGetRecentActivityResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Recent project activity feed',
         tags: ['admin-audit'],
     }),
     // ── Overview ───────────────────────────────────────────────────────────
     dashboard: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/overview/dashboard',
+        path: '/operator/audit/overview/dashboard',
         response: AdminAuditDashboardResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Operator dashboard — platform-wide stats',
         tags: ['admin-audit'],
     }),
     charts: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/overview/charts',
+        path: '/operator/audit/overview/charts',
         response: AdminAuditChartsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Operator dashboard — chart data',
         tags: ['admin-audit'],
     }),
     health: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/overview/health',
+        path: '/operator/audit/overview/health',
         response: AdminAuditHealthResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Operator dashboard — infra/service health',
         tags: ['admin-audit'],
     }),
     analytics: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/overview/analytics',
+        path: '/operator/audit/overview/analytics',
         response: AdminAuditAnalyticsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Operator dashboard — aggregate analytics',
         tags: ['admin-audit'],
     }),
     projectOverview: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/overview/:id',
+        path: '/operator/audit/overview/:id',
         params: AdminAuditProjectParams,
         response: AdminAuditProjectOverviewResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Per-project overview for operator dashboard',
         tags: ['admin-audit'],
     }),
     servicesOverview: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id',
+        path: '/operator/audit/projects/:id',
         params: AdminAuditProjectParams,
         response: AdminAuditServicesOverviewResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Per-project services overview',
         tags: ['admin-audit'],
     }),
     // ── AI service audit (strict — shapes are stable) ──────────────────────
     ai: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/ai',
+        path: '/operator/audit/projects/:id/ai',
         params: AdminAuditProjectParams,
         response: AdminAuditAiResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'AI service audit data (catalog + usage)',
         tags: ['admin-audit'],
     }),
     aiLogs: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/ai/logs',
+        path: '/operator/audit/projects/:id/ai/logs',
         params: AdminAuditProjectParams,
         response: AdminAuditAiLogsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'AI request log listing',
         tags: ['admin-audit'],
     }),
     aiRates: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/ai/rates',
+        path: '/operator/audit/projects/:id/ai/rates',
         params: AdminAuditProjectParams,
         response: AdminAuditAiRatesResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'AI rate-metrics breakdown',
         tags: ['admin-audit'],
     }),
     aiSummary: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/ai/summary',
+        path: '/operator/audit/projects/:id/ai/summary',
         params: AdminAuditProjectParams,
         response: AdminAuditAiSummaryResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'AI usage summary',
         tags: ['admin-audit'],
     }),
     // ── Billing data (strict) ──────────────────────────────────────────────
     billingUsage: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/billing/usage',
+        path: '/operator/audit/projects/:id/billing/usage',
         params: AdminAuditProjectParams,
         response: AdminAuditBillingUsageResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Per-service billing usage data',
         tags: ['admin-audit'],
     }),
     billing: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/billing',
+        path: '/operator/audit/projects/:id/billing',
         params: AdminAuditProjectParams,
         response: AdminAuditBillingResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Billing service data (plan + subscriptions + transactions)',
         tags: ['admin-audit'],
     }),
     // ── Observability (envelope-typed — inner payload is Grafana-owned) ──
     obsLogs: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/obs/logs',
+        path: '/operator/audit/projects/:id/obs/logs',
         params: AdminAuditProjectParams,
         response: AdminAuditObsLogsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Query observability logs',
         tags: ['admin-audit'],
     }),
     obsLogsStream: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/obs/logs/stream',
+        path: '/operator/audit/projects/:id/obs/logs/stream',
         params: AdminAuditProjectParams,
         // SSE stream — body is a text/event-stream; no JSON schema fits.
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'SSE stream of observability logs',
         tags: ['admin-audit'],
     }),
     obsMetrics: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/obs/metrics',
+        path: '/operator/audit/projects/:id/obs/metrics',
         params: AdminAuditProjectParams,
         response: AdminAuditObsMetricsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Metrics overview',
         tags: ['admin-audit'],
     }),
     obsMetricsRange: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/obs/metrics/range',
+        path: '/operator/audit/projects/:id/obs/metrics/range',
         params: AdminAuditProjectParams,
         response: AdminAuditObsMetricsRangeResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Metrics range query',
         tags: ['admin-audit'],
     }),
     obsTraces: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/obs/traces',
+        path: '/operator/audit/projects/:id/obs/traces',
         params: AdminAuditProjectParams,
         response: AdminAuditObsTracesResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Search observability traces',
         tags: ['admin-audit'],
     }),
     obsTrace: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/obs/traces/:traceId',
+        path: '/operator/audit/projects/:id/obs/traces/:traceId',
         params: AdminAuditTraceParams,
         // Raw Tempo payload — upstream store owns the schema.
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Get a single observability trace',
         tags: ['admin-audit'],
     }),
     // ── Per-service audit (envelope-typed: app ref locked, inner flexible) ─
     authService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/auth',
+        path: '/operator/audit/projects/:id/auth',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Auth service audit data',
         tags: ['admin-audit'],
     }),
     analyticsService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/analytics',
+        path: '/operator/audit/projects/:id/analytics',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditAnalyticsServiceResult,
+        plane: 'management',
         summary: 'Analytics service audit data',
         tags: ['admin-audit'],
     }),
     jobsService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/jobs',
+        path: '/operator/audit/projects/:id/jobs',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditJobsServiceResult,
+        plane: 'management',
         summary: 'Jobs service audit data',
         tags: ['admin-audit'],
     }),
     pushService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/push',
+        path: '/operator/audit/projects/:id/push',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Push notification service audit data',
         tags: ['admin-audit'],
     }),
     runsService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/runs',
+        path: '/operator/audit/projects/:id/runs',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditRunsServiceResult,
+        plane: 'management',
         summary: 'Scheduler runs audit data',
         tags: ['admin-audit'],
     }),
     workersService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/workers',
+        path: '/operator/audit/projects/:id/workers',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditRunsServiceResult,
+        plane: 'management',
         summary: 'Workers audit data',
         tags: ['admin-audit'],
     }),
     listRuns: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/runs/list',
+        path: '/operator/audit/projects/:id/runs/list',
         params: AdminAuditProjectParams,
         query: AdminAuditRunFilterQuery,
         response: AdminAuditRunsListResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'List scheduler runs',
         tags: ['admin-audit'],
     }),
     listWorkerRuns: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/workers/runs',
+        path: '/operator/audit/projects/:id/workers/runs',
         params: AdminAuditProjectParams,
         query: AdminAuditRunFilterQuery,
         response: AdminAuditRunsListResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'List worker runs',
         tags: ['admin-audit'],
     }),
     triggersService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/triggers',
+        path: '/operator/audit/projects/:id/triggers',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditTriggersServiceResult,
+        plane: 'management',
         summary: 'Triggers service audit data',
         tags: ['admin-audit'],
     }),
     // ── Trigger mutations (strict success envelope) ────────────────────────
     pauseTrigger: defineEndpoint({
         method: 'POST',
-        path: '/admin/audit/projects/:id/triggers/:triggerId/pause',
+        path: '/operator/audit/projects/:id/triggers/:triggerId/pause',
         params: AdminAuditTriggerParams,
         response: AdminAuditMutationSuccess,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Pause a trigger',
         tags: ['admin-audit'],
     }),
     resumeTrigger: defineEndpoint({
         method: 'POST',
-        path: '/admin/audit/projects/:id/triggers/:triggerId/resume',
+        path: '/operator/audit/projects/:id/triggers/:triggerId/resume',
         params: AdminAuditTriggerParams,
         response: AdminAuditMutationSuccess,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Resume a trigger',
         tags: ['admin-audit'],
     }),
     fireTrigger: defineEndpoint({
         method: 'POST',
-        path: '/admin/audit/projects/:id/triggers/:triggerId/fire',
+        path: '/operator/audit/projects/:id/triggers/:triggerId/fire',
         params: AdminAuditTriggerParams,
         response: AdminAuditMutationSuccess,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Manually fire a trigger',
         tags: ['admin-audit'],
     }),
     deleteTrigger: defineEndpoint({
         method: 'DELETE',
-        path: '/admin/audit/projects/:id/triggers/:triggerId',
+        path: '/operator/audit/projects/:id/triggers/:triggerId',
         params: AdminAuditTriggerParams,
         response: AdminAuditMutationSuccess,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Delete a trigger',
         tags: ['admin-audit'],
     }),
     functionsService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/functions',
+        path: '/operator/audit/projects/:id/functions',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Functions service audit data',
         tags: ['admin-audit'],
     }),
     listFunctions: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/functions/list',
+        path: '/operator/audit/projects/:id/functions/list',
         params: AdminAuditProjectParams,
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'List functions',
         tags: ['admin-audit'],
     }),
     listPushSubscribers: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/push/subscribers',
+        path: '/operator/audit/projects/:id/push/subscribers',
         params: AdminAuditProjectParams,
         query: AdminAuditPaginationQuery,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'List push subscribers',
         tags: ['admin-audit'],
     }),
     emailService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/email',
+        path: '/operator/audit/projects/:id/email',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditEmailServiceResult,
+        plane: 'management',
         summary: 'Email service audit data',
         tags: ['admin-audit'],
     }),
     consentService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/consent',
+        path: '/operator/audit/projects/:id/consent',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditConsentServiceResult,
+        plane: 'management',
         summary: 'Consent service audit data',
         tags: ['admin-audit'],
     }),
     webhooksService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/webhooks',
+        path: '/operator/audit/projects/:id/webhooks',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Webhooks service audit data',
         tags: ['admin-audit'],
     }),
     referralsService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/referrals',
+        path: '/operator/audit/projects/:id/referrals',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Referrals service audit data',
         tags: ['admin-audit'],
     }),
     databaseService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/database',
+        path: '/operator/audit/projects/:id/database',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Database service audit data (tables + queries)',
         tags: ['admin-audit'],
     }),
     newsletterService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/newsletter',
+        path: '/operator/audit/projects/:id/newsletter',
         params: AdminAuditProjectParams,
-        response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        response: AdminAuditNewsletterServiceResult,
+        plane: 'management',
         summary: 'Newsletter service audit data',
         tags: ['admin-audit'],
     }),
     engagementService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/engagement',
+        path: '/operator/audit/projects/:id/engagement',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Engagement (gamification) service audit data',
         tags: ['admin-audit'],
     }),
     databaseMetrics: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/database/metrics',
+        path: '/operator/audit/projects/:id/database/metrics',
         params: AdminAuditProjectParams,
         // CNPG real-time metrics passthrough — upstream operator owns the shape.
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Database metrics',
         tags: ['admin-audit'],
     }),
     databaseQueries: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/database/queries',
+        path: '/operator/audit/projects/:id/database/queries',
         params: AdminAuditProjectParams,
         // pg_stat_statements slow-query passthrough — Postgres-version dependent.
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Database slow query log',
         tags: ['admin-audit'],
     }),
     databaseTables: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/database/tables',
+        path: '/operator/audit/projects/:id/database/tables',
         params: AdminAuditProjectParams,
         // information_schema passthrough — Postgres-version dependent.
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Database table listing',
         tags: ['admin-audit'],
     }),
     flagsService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/flags',
+        path: '/operator/audit/projects/:id/flags',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Feature flags service audit data',
         tags: ['admin-audit'],
     }),
     monitoringService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/monitoring',
+        path: '/operator/audit/projects/:id/monitoring',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Monitoring service audit data',
         tags: ['admin-audit'],
     }),
     storageService: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/storage',
+        path: '/operator/audit/projects/:id/storage',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Storage service audit data',
         tags: ['admin-audit'],
     }),
     storageBuckets: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/storage/buckets',
+        path: '/operator/audit/projects/:id/storage/buckets',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Storage buckets listing',
         tags: ['admin-audit'],
     }),
     storageFiles: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/projects/:id/storage/files',
+        path: '/operator/audit/projects/:id/storage/files',
         params: AdminAuditProjectParams,
         response: AdminAuditServiceEnvelope,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Storage file listing',
         tags: ['admin-audit'],
     }),
     // Generic date-ranged aggregate used by several audit endpoints.
     dateRange: defineEndpoint({
         method: 'GET',
-        path: '/admin/audit/dateRange',
+        path: '/operator/audit/dateRange',
         query: AdminAuditDateRangeQuery,
         response: AdminAuditUnknownResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Placeholder for shared date-range query (unused direct route)',
         tags: ['admin-audit'],
     }),