@sylphx/contract 0.2.0

package/dist/endpoints/kv.js

@@ -0,0 +1,82 @@
+/**
+ * KV endpoints — BaaS plane key-value store. Paths mirror `@sylphx/sdk` `kv.ts`
+ * (served under `/sdk/kv/*` upstream on `<your-app>.api.sylphx.com`).
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { KvDeleteResult, KvExistsResult, KvExpireInput, KvGetResult, KvIncrInput, KvIncrResult, KvRateLimitInput, KvRateLimitResult, KvScanQuery, KvScanResult, KvSetInput, KvSetResult, } from '../schemas/kv.js';
+const KeyPath = Schema.Struct({ key: Schema.String });
+export const kvEndpoints = {
+    set: defineEndpoint({
+        method: 'POST',
+        path: '/sdk/kv/set',
+        body: KvSetInput,
+        response: KvSetResult,
+        plane: 'baas',
+        summary: 'Set a key-value pair with optional TTL / NX / XX flags',
+        tags: ['kv'],
+    }),
+    get: defineEndpoint({
+        method: 'GET',
+        path: '/sdk/kv/get/:key',
+        params: KeyPath,
+        response: KvGetResult,
+        plane: 'baas',
+        summary: 'Get a value by key; returns null when absent',
+        tags: ['kv'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/sdk/kv/delete/:key',
+        params: KeyPath,
+        response: KvDeleteResult,
+        plane: 'baas',
+        summary: 'Delete a key',
+        tags: ['kv'],
+    }),
+    exists: defineEndpoint({
+        method: 'GET',
+        path: '/sdk/kv/exists/:key',
+        params: KeyPath,
+        response: KvExistsResult,
+        plane: 'baas',
+        summary: 'Check whether a key exists',
+        tags: ['kv'],
+    }),
+    incr: defineEndpoint({
+        method: 'POST',
+        path: '/sdk/kv/incr',
+        body: KvIncrInput,
+        response: KvIncrResult,
+        plane: 'baas',
+        summary: 'Atomically increment a numeric value',
+        tags: ['kv'],
+    }),
+    expire: defineEndpoint({
+        method: 'POST',
+        path: '/sdk/kv/expire',
+        body: KvExpireInput,
+        response: KvSetResult,
+        plane: 'baas',
+        summary: 'Set / refresh a TTL on an existing key',
+        tags: ['kv'],
+    }),
+    rateLimit: defineEndpoint({
+        method: 'POST',
+        path: '/sdk/kv/ratelimit',
+        body: KvRateLimitInput,
+        response: KvRateLimitResult,
+        plane: 'baas',
+        summary: 'Consume a rate-limit token (sliding window)',
+        tags: ['kv'],
+    }),
+    scan: defineEndpoint({
+        method: 'GET',
+        path: '/sdk/kv/scan',
+        query: KvScanQuery,
+        response: KvScanResult,
+        plane: 'baas',
+        summary: 'Cursor-based key scan by glob pattern',
+        tags: ['kv'],
+    }),
+};

package/dist/endpoints/monitoring-admin.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Monitoring Admin endpoints — Console error-tracking dashboard.
+ * Mirrors `apps/api/src/server/platform/routes/monitoring/*`.
+ *
+ * Production mount: `/monitoring/*`.
+ *
+ * Distinct from the BaaS-plane `monitoringEndpoints` (which serves the
+ * Sentry-style `/sdk/monitoring/exception` + `/sdk/monitoring/message`
+ * capture ingest on the standalone runtime). The admin variant is
+ * `monitoringAdmin` — same shape convention as `consentAdmin`,
+ * `engagementAdmin`, `referralsAdmin` from Wave 3D.
+ */
+export declare const monitoringAdminEndpoints: {
+    readonly listErrors: import("../endpoint.js").Endpoint<"GET", "/monitoring/projects/:id/errors", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        projectId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        environmentId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        severity: import("effect/Schema").optional<import("effect/Schema").Literal<["fatal", "error", "warning", "info"]>>;
+        resolved: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        search: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        errors: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            app: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+                id: typeof import("effect/Schema").String;
+                name: typeof import("effect/Schema").String;
+                slug: typeof import("effect/Schema").String;
+            }>>;
+            environment: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+                id: typeof import("effect/Schema").String;
+                name: typeof import("effect/Schema").String;
+                envType: typeof import("effect/Schema").String;
+            }>>;
+            errorType: typeof import("effect/Schema").String;
+            message: typeof import("effect/Schema").String;
+            severity: import("effect/Schema").Literal<["fatal", "error", "warning", "info"]>;
+            count: typeof import("effect/Schema").Number;
+            firstSeen: typeof import("effect/Schema").String;
+            lastSeen: typeof import("effect/Schema").String;
+            resolved: typeof import("effect/Schema").Boolean;
+            url: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        }>>;
+        total: typeof import("effect/Schema").Number;
+        limit: typeof import("effect/Schema").Number;
+        offset: typeof import("effect/Schema").Number;
+    }>>;
+    readonly getStats: import("../endpoint.js").Endpoint<"GET", "/monitoring/projects/:id/errors/stats", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        days: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        total: typeof import("effect/Schema").Number;
+        unresolved: typeof import("effect/Schema").Number;
+        bySeverity: import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Number>;
+        recentErrors: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            errorType: typeof import("effect/Schema").String;
+            message: typeof import("effect/Schema").String;
+            count: typeof import("effect/Schema").Number;
+            lastSeen: typeof import("effect/Schema").String;
+        }>>;
+        period: typeof import("effect/Schema").String;
+    }>>;
+    readonly getServiceData: import("../endpoint.js").Endpoint<"GET", "/monitoring/projects/:id/service-data", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        app: import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            name: typeof import("effect/Schema").String;
+            slug: typeof import("effect/Schema").String;
+        }>;
+        errorsLast24h: typeof import("effect/Schema").Number;
+        errorsPrevious24h: typeof import("effect/Schema").Number;
+        unresolvedErrors: typeof import("effect/Schema").Number;
+        totalErrors: typeof import("effect/Schema").Number;
+        fatalErrorsThisWeek: typeof import("effect/Schema").Number;
+        errorsByDay: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            date: typeof import("effect/Schema").String;
+            count: typeof import("effect/Schema").Number;
+        }>>;
+        errorsBySeverity: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            severity: typeof import("effect/Schema").String;
+            count: typeof import("effect/Schema").Number;
+        }>>;
+        recentErrors: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            message: typeof import("effect/Schema").String;
+            severity: typeof import("effect/Schema").String;
+            occurrences: typeof import("effect/Schema").Number;
+            lastSeen: typeof import("effect/Schema").String;
+        }>>;
+    }>>;
+    readonly getError: import("../endpoint.js").Endpoint<"GET", "/monitoring/errors/:errorId", import("effect/Schema").Struct<{
+        errorId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+        app: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            name: typeof import("effect/Schema").String;
+            slug: typeof import("effect/Schema").String;
+        }>>;
+        environment: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            name: typeof import("effect/Schema").String;
+            envType: typeof import("effect/Schema").String;
+        }>>;
+        fingerprint: typeof import("effect/Schema").String;
+        errorType: typeof import("effect/Schema").String;
+        message: typeof import("effect/Schema").String;
+        stack: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        severity: import("effect/Schema").Literal<["fatal", "error", "warning", "info"]>;
+        url: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        userAgent: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        userId: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        metadata: import("effect/Schema").NullOr<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        count: typeof import("effect/Schema").Number;
+        firstSeen: typeof import("effect/Schema").String;
+        lastSeen: typeof import("effect/Schema").String;
+        resolved: typeof import("effect/Schema").Boolean;
+        resolvedAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        resolver: import("effect/Schema").NullOr<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            name: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            email: typeof import("effect/Schema").String;
+        }>>;
+        createdAt: typeof import("effect/Schema").String;
+    }>>;
+    readonly resolveError: import("../endpoint.js").Endpoint<"POST", "/monitoring/errors/:errorId/resolve", import("effect/Schema").Struct<{
+        errorId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly unresolveError: import("../endpoint.js").Endpoint<"POST", "/monitoring/errors/:errorId/unresolve", import("effect/Schema").Struct<{
+        errorId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly deleteError: import("../endpoint.js").Endpoint<"DELETE", "/monitoring/errors/:errorId", import("effect/Schema").Struct<{
+        errorId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly resolveStackTrace: import("../endpoint.js").Endpoint<"GET", "/monitoring/errors/:errorId/stacktrace", import("effect/Schema").Struct<{
+        errorId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        resolved: typeof import("effect/Schema").Boolean;
+        reason: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        release: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        frames: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            filename: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            function: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            lineno: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            colno: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            in_app: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+            originalFilename: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            originalLine: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            originalColumn: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            originalName: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            resolved: typeof import("effect/Schema").Boolean;
+        }>>;
+    }>>;
+    readonly listSourceMaps: import("../endpoint.js").Endpoint<"GET", "/monitoring/projects/:id/source-maps", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        release: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        maps: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            id: typeof import("effect/Schema").String;
+            release: typeof import("effect/Schema").String;
+            filename: typeof import("effect/Schema").String;
+            fileSize: import("effect/Schema").NullOr<typeof import("effect/Schema").Number>;
+            validated: typeof import("effect/Schema").Boolean;
+            uploadedAt: typeof import("effect/Schema").String;
+            expiresAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        }>>;
+        total: typeof import("effect/Schema").Number;
+        limit: typeof import("effect/Schema").Number;
+        offset: typeof import("effect/Schema").Number;
+    }>>;
+    readonly deleteSourceMaps: import("../endpoint.js").Endpoint<"DELETE", "/monitoring/projects/:id/source-maps", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        release: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        deletedCount: typeof import("effect/Schema").Number;
+    }>>;
+};
+//# sourceMappingURL=monitoring-admin.d.ts.map

package/dist/endpoints/monitoring-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/monitoring-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsBH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2G3B,CAAA"}

package/dist/endpoints/monitoring-admin.js

@@ -0,0 +1,119 @@
+/**
+ * Monitoring Admin endpoints — Console error-tracking dashboard.
+ * Mirrors `apps/api/src/server/platform/routes/monitoring/*`.
+ *
+ * Production mount: `/monitoring/*`.
+ *
+ * Distinct from the BaaS-plane `monitoringEndpoints` (which serves the
+ * Sentry-style `/sdk/monitoring/exception` + `/sdk/monitoring/message`
+ * capture ingest on the standalone runtime). The admin variant is
+ * `monitoringAdmin` — same shape convention as `consentAdmin`,
+ * `engagementAdmin`, `referralsAdmin` from Wave 3D.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { DeleteErrorResult, DeleteSourceMapsInput, DeleteSourceMapsResult, ErrorIdParams, ErrorListQuery, ErrorStatsQuery, ErrorStatsResult, ErrorWithProjectIdQuery, GetErrorResult, GetMonitoringServiceDataResult, ListErrorsResult, ListSourceMapsResult, MonitoringProjectPath, ResolveErrorResult, ResolveStackTraceResult, SourceMapsQuery, } from '../schemas/monitoring-admin.js';
+export const monitoringAdminEndpoints = {
+    // ── Error list + stats + dashboard data ────────────────────────────────
+    listErrors: defineEndpoint({
+        method: 'GET',
+        path: '/monitoring/projects/:id/errors',
+        params: MonitoringProjectPath,
+        query: ErrorListQuery,
+        response: ListErrorsResult,
+        plane: 'management',
+        summary: 'List errors for a project with filtering + pagination',
+        tags: ['monitoring-admin'],
+    }),
+    getStats: defineEndpoint({
+        method: 'GET',
+        path: '/monitoring/projects/:id/errors/stats',
+        params: MonitoringProjectPath,
+        query: ErrorStatsQuery,
+        response: ErrorStatsResult,
+        plane: 'management',
+        summary: 'Get error statistics for a project over a time period',
+        tags: ['monitoring-admin'],
+    }),
+    getServiceData: defineEndpoint({
+        method: 'GET',
+        path: '/monitoring/projects/:id/service-data',
+        params: MonitoringProjectPath,
+        response: GetMonitoringServiceDataResult,
+        plane: 'management',
+        summary: 'Get the monitoring dashboard service data (trends + breakdowns)',
+        tags: ['monitoring-admin'],
+    }),
+    // ── Error detail CRUD ──────────────────────────────────────────────────
+    getError: defineEndpoint({
+        method: 'GET',
+        path: '/monitoring/errors/:errorId',
+        params: ErrorIdParams,
+        query: ErrorWithProjectIdQuery,
+        response: GetErrorResult,
+        plane: 'management',
+        summary: 'Get error detail (projectId query required for per-project DB)',
+        tags: ['monitoring-admin'],
+    }),
+    resolveError: defineEndpoint({
+        method: 'POST',
+        path: '/monitoring/errors/:errorId/resolve',
+        params: ErrorIdParams,
+        query: ErrorWithProjectIdQuery,
+        response: ResolveErrorResult,
+        plane: 'management',
+        summary: 'Mark an error as resolved',
+        tags: ['monitoring-admin'],
+    }),
+    unresolveError: defineEndpoint({
+        method: 'POST',
+        path: '/monitoring/errors/:errorId/unresolve',
+        params: ErrorIdParams,
+        query: ErrorWithProjectIdQuery,
+        response: ResolveErrorResult,
+        plane: 'management',
+        summary: 'Reopen a resolved error',
+        tags: ['monitoring-admin'],
+    }),
+    deleteError: defineEndpoint({
+        method: 'DELETE',
+        path: '/monitoring/errors/:errorId',
+        params: ErrorIdParams,
+        query: ErrorWithProjectIdQuery,
+        response: DeleteErrorResult,
+        plane: 'management',
+        summary: 'Delete an error record',
+        tags: ['monitoring-admin'],
+    }),
+    // ── Stack traces ───────────────────────────────────────────────────────
+    resolveStackTrace: defineEndpoint({
+        method: 'GET',
+        path: '/monitoring/errors/:errorId/stacktrace',
+        params: ErrorIdParams,
+        query: ErrorWithProjectIdQuery,
+        response: ResolveStackTraceResult,
+        plane: 'management',
+        summary: 'Resolve minified stack trace using uploaded source maps',
+        tags: ['monitoring-admin'],
+    }),
+    // ── Source maps ────────────────────────────────────────────────────────
+    listSourceMaps: defineEndpoint({
+        method: 'GET',
+        path: '/monitoring/projects/:id/source-maps',
+        params: MonitoringProjectPath,
+        query: SourceMapsQuery,
+        response: ListSourceMapsResult,
+        plane: 'management',
+        summary: 'List uploaded source maps for a project',
+        tags: ['monitoring-admin'],
+    }),
+    deleteSourceMaps: defineEndpoint({
+        method: 'DELETE',
+        path: '/monitoring/projects/:id/source-maps',
+        params: MonitoringProjectPath,
+        body: DeleteSourceMapsInput,
+        response: DeleteSourceMapsResult,
+        plane: 'management',
+        summary: 'Delete all source maps for a specific release version',
+        tags: ['monitoring-admin'],
+    }),
+};

package/dist/endpoints/monitoring.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Monitoring endpoints — BaaS plane. Paths mirror production
+ * `@sylphx/sdk/monitoring.ts` (`/sdk/monitoring/*`), which is the
+ * Sentry-style ingest surface the SDK has always posted to.
+ */
+export declare const monitoringEndpoints: {
+    readonly captureException: import("../endpoint.js").Endpoint<"POST", "/sdk/monitoring/exception", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        exception: import("effect/Schema").Struct<{
+            values: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+                type: typeof import("effect/Schema").String;
+                value: typeof import("effect/Schema").String;
+                stacktrace: import("effect/Schema").optional<import("effect/Schema").Struct<{
+                    frames: import("effect/Schema").Array$<import("effect/Schema").Struct<{
+                        filename: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+                        function: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+                        lineno: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                        colno: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+                    }>>;
+                }>>;
+            }>>;
+        }>;
+        level: import("effect/Schema").optional<import("effect/Schema").Literal<["fatal", "error", "warning", "info"]>>;
+        route: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        userAgent: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        release: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        environment: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        tags: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").String>>;
+        extra: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        breadcrumbs: import("effect/Schema").optional<import("effect/Schema").Array$<import("effect/Schema").Struct<{
+            type: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            level: import("effect/Schema").optional<import("effect/Schema").Literal<["fatal", "error", "warning", "info"]>>;
+            message: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            data: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            timestamp: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        }>>>;
+        fingerprint: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+        userId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        timestamp: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        eventId: typeof import("effect/Schema").String;
+        sampled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        isNewError: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        quotaUsage: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        recommendedSampleRate: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly captureMessage: import("../endpoint.js").Endpoint<"POST", "/sdk/monitoring/message", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        message: typeof import("effect/Schema").String;
+        level: import("effect/Schema").optional<import("effect/Schema").Literal<["fatal", "error", "warning", "info"]>>;
+        route: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        release: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        tags: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").String>>;
+        extra: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        userId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        timestamp: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        eventId: typeof import("effect/Schema").String;
+        sampled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        isNewError: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        quotaUsage: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        recommendedSampleRate: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>>;
+};
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/endpoints/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../src/endpoints/monitoring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBtB,CAAA"}

package/dist/endpoints/monitoring.js

@@ -0,0 +1,27 @@
+/**
+ * Monitoring endpoints — BaaS plane. Paths mirror production
+ * `@sylphx/sdk/monitoring.ts` (`/sdk/monitoring/*`), which is the
+ * Sentry-style ingest surface the SDK has always posted to.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { CaptureExceptionInput, CaptureMessageInput, CaptureResult } from '../schemas/monitoring.js';
+export const monitoringEndpoints = {
+    captureException: defineEndpoint({
+        method: 'POST',
+        path: '/sdk/monitoring/exception',
+        body: CaptureExceptionInput,
+        response: CaptureResult,
+        plane: 'baas',
+        summary: 'Capture an exception with stacktrace + context',
+        tags: ['monitoring'],
+    }),
+    captureMessage: defineEndpoint({
+        method: 'POST',
+        path: '/sdk/monitoring/message',
+        body: CaptureMessageInput,
+        response: CaptureResult,
+        plane: 'baas',
+        summary: 'Capture a log message at a given severity level',
+        tags: ['monitoring'],
+    }),
+};