@sylphx/contract 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @sylphx/contract
 
+## 0.3.0
+
+### Minor Changes
+
+- [`03dbd29`](https://github.com/SylphxAI/platform/commit/03dbd2986024fa650378e10958890d6ac063f516) Thanks [@shtse8](https://github.com/shtse8)! - Add a privacy-preserving public auth resend-verification contract and SDK helper.
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/endpoint.d.ts

@@ -46,6 +46,12 @@ export interface Endpoint<Method extends HttpMethod = HttpMethod, Path extends s
      * that customers never consume (super-admin platform administration).
      */
     readonly plane?: 'management' | 'baas' | 'admin';
+    /**
+     * OpenAPI security requirements. Omit for the default bearerAuth contract;
+     * use an empty array for deliberately public endpoints such as sign-in and
+     * email verification resend.
+     */
+    readonly security?: readonly string[];
     /** LLM-targeted description emitted as `x-agent-hint` (OpenAPI 4 forward-compat). */
     readonly agentHint?: string;
 }
@@ -60,6 +66,12 @@ export declare const defineEndpoint: <Method extends HttpMethod, Path extends st
 /**
  * A record of endpoints grouped by a capability namespace — e.g. the object
  * exported from `endpoints/projects.ts`.
+ *
+ * Some capability namespaces are nested (`organizations.billing`,
+ * `security.passkeys`, etc.). Keep that hierarchy in the contract and let
+ * derivations such as `HonoAppFromEndpoints` recursively flatten it.
  */
-export type EndpointGroup = Readonly<Record<string, Endpoint>>;
+export interface EndpointGroup {
+    readonly [key: string]: Endpoint | EndpointGroup;
+}
 //# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEpE;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ,CACxB,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,IAAI,SAAS,MAAM,GAAG,MAAM,EAE5B,MAAM,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,EAE/D,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,EAE9D,IAAI,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,EAE7D,QAAQ,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC;IAEhF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAA;IAChD,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAC1B,MAAM,SAAS,UAAU,EACzB,IAAI,SAAS,MAAM,EACnB,MAAM,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EACrD,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EACpD,IAAI,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EACnD,QAAQ,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,EAE3C,UAAU,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,KAC7D,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAa,CAAA;AAEpE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEpE;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ,CACxB,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,IAAI,SAAS,MAAM,GAAG,MAAM,EAE5B,MAAM,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,EAE/D,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,EAE9D,IAAI,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,GAAG,EAE7D,QAAQ,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC;IAEhF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,CAAA;IAChD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAC1B,MAAM,SAAS,UAAU,EACzB,IAAI,SAAS,MAAM,EACnB,MAAM,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EACrD,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EACpD,IAAI,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,EACnD,QAAQ,SAAS,MAAM,CAAC,MAAM,CAAC,YAAY,EAE3C,UAAU,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,KAC7D,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAa,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAA;CAChD"}

package/dist/endpoints/admin-ai-playground.d.ts

@@ -6,7 +6,7 @@
  * handler-side only — it emits `text/event-stream`, not JSON.
  */
 export declare const adminAiPlaygroundEndpoints: {
-    readonly listModels: import("../endpoint.js").Endpoint<"GET", "/admin/ai-playground/models", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+    readonly listModels: import("../endpoint.js").Endpoint<"GET", "/operator/ai-playground/models", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         models: import("effect/Schema").Array$<import("effect/Schema").Struct<{
             id: typeof import("effect/Schema").String;
             name: typeof import("effect/Schema").String;
@@ -22,7 +22,7 @@ export declare const adminAiPlaygroundEndpoints: {
             outputCostPer1M: typeof import("effect/Schema").Number;
         }>>;
     }>>;
-    readonly chat: import("../endpoint.js").Endpoint<"POST", "/admin/ai-playground/chat", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+    readonly chat: import("../endpoint.js").Endpoint<"POST", "/operator/ai-playground/chat", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
         model: typeof import("effect/Schema").String;
         messages: import("effect/Schema").Array$<import("effect/Schema").Struct<{
@@ -62,7 +62,7 @@ export declare const adminAiPlaygroundEndpoints: {
             arguments: import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>;
         }>>>;
     }>>;
-    readonly chatStream: import("../endpoint.js").Endpoint<"POST", "/admin/ai-playground/chat/stream", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+    readonly chatStream: import("../endpoint.js").Endpoint<"POST", "/operator/ai-playground/chat/stream", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
         model: typeof import("effect/Schema").String;
         messages: import("effect/Schema").Array$<import("effect/Schema").Struct<{

package/dist/endpoints/admin-ai-playground.js

@@ -10,27 +10,27 @@ import { AdminListModelsResult, AdminPlaygroundChatInput, AdminPlaygroundChatRes
 export const adminAiPlaygroundEndpoints = {
     listModels: defineEndpoint({
         method: 'GET',
-        path: '/admin/ai-playground/models',
+        path: '/operator/ai-playground/models',
         response: AdminListModelsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'List AI models available in the playground',
         tags: ['admin-ai-playground'],
     }),
     chat: defineEndpoint({
         method: 'POST',
-        path: '/admin/ai-playground/chat',
+        path: '/operator/ai-playground/chat',
         body: AdminPlaygroundChatInput,
         response: AdminPlaygroundChatResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Non-streaming chat completion in playground',
         tags: ['admin-ai-playground'],
     }),
     chatStream: defineEndpoint({
         method: 'POST',
-        path: '/admin/ai-playground/chat/stream',
+        path: '/operator/ai-playground/chat/stream',
         body: AdminPlaygroundChatInput,
         response: AdminPlaygroundStreamResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Initialise a streaming chat completion (returns streamId)',
         tags: ['admin-ai-playground'],
     }),

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

@@ -5,14 +5,14 @@
  * Production mount: `/admin/anomalies/*`.
  */
 export declare const adminAnomaliesEndpoints: {
-    readonly stats: import("../endpoint.js").Endpoint<"GET", "/admin/anomalies/stats", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+    readonly stats: import("../endpoint.js").Endpoint<"GET", "/operator/anomalies/stats", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         open: typeof import("effect/Schema").Number;
         acknowledged: typeof import("effect/Schema").Number;
         resolved: typeof import("effect/Schema").Number;
         dismissed: typeof import("effect/Schema").Number;
         total: typeof import("effect/Schema").Number;
     }>>;
-    readonly list: import("../endpoint.js").Endpoint<"GET", "/admin/anomalies/", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/operator/anomalies/", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         page: import("effect/Schema").optional<typeof import("effect/Schema").String>;
         limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
         status: import("effect/Schema").optional<import("effect/Schema").Literal<["all", "open", "acknowledged", "resolved", "dismissed"]>>;
@@ -41,7 +41,7 @@ export declare const adminAnomaliesEndpoints: {
             totalPages: typeof import("effect/Schema").Number;
         }>;
     }>>;
-    readonly get: import("../endpoint.js").Endpoint<"GET", "/admin/anomalies/:anomalyId", import("effect/Schema").Struct<{
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/operator/anomalies/:anomalyId", import("effect/Schema").Struct<{
         anomalyId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         id: typeof import("effect/Schema").String;
@@ -59,19 +59,19 @@ export declare const adminAnomaliesEndpoints: {
         resolutionNotes: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
         createdAt: typeof import("effect/Schema").String;
     }>>;
-    readonly acknowledge: import("../endpoint.js").Endpoint<"POST", "/admin/anomalies/:anomalyId/acknowledge", import("effect/Schema").Struct<{
+    readonly acknowledge: import("../endpoint.js").Endpoint<"POST", "/operator/anomalies/:anomalyId/acknowledge", import("effect/Schema").Struct<{
         anomalyId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         success: typeof import("effect/Schema").Boolean;
         status: import("effect/Schema").Literal<["open", "acknowledged", "resolved", "dismissed"]>;
     }>>;
-    readonly dismiss: import("../endpoint.js").Endpoint<"POST", "/admin/anomalies/:anomalyId/dismiss", import("effect/Schema").Struct<{
+    readonly dismiss: import("../endpoint.js").Endpoint<"POST", "/operator/anomalies/:anomalyId/dismiss", import("effect/Schema").Struct<{
         anomalyId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         success: typeof import("effect/Schema").Boolean;
         status: import("effect/Schema").Literal<["open", "acknowledged", "resolved", "dismissed"]>;
     }>>;
-    readonly resolve: import("../endpoint.js").Endpoint<"POST", "/admin/anomalies/:anomalyId/resolve", import("effect/Schema").Struct<{
+    readonly resolve: import("../endpoint.js").Endpoint<"POST", "/operator/anomalies/:anomalyId/resolve", import("effect/Schema").Struct<{
         anomalyId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
         notes: typeof import("effect/Schema").String;
@@ -79,7 +79,7 @@ export declare const adminAnomaliesEndpoints: {
         success: typeof import("effect/Schema").Boolean;
         status: import("effect/Schema").Literal<["open", "acknowledged", "resolved", "dismissed"]>;
     }>>;
-    readonly errorsOverview: import("../endpoint.js").Endpoint<"GET", "/admin/anomalies/errors/overview", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+    readonly errorsOverview: import("../endpoint.js").Endpoint<"GET", "/operator/anomalies/errors/overview", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, 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>;

package/dist/endpoints/admin-anomalies.js

@@ -9,63 +9,63 @@ import { AdminAnomalyActionResult, AdminAnomalyIdParams, AdminAnomalyStatsResult
 export const adminAnomaliesEndpoints = {
     stats: defineEndpoint({
         method: 'GET',
-        path: '/admin/anomalies/stats',
+        path: '/operator/anomalies/stats',
         response: AdminAnomalyStatsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Anomaly counts by status',
         tags: ['admin-anomalies'],
     }),
     list: defineEndpoint({
         method: 'GET',
-        path: '/admin/anomalies/',
+        path: '/operator/anomalies/',
         query: AdminListAnomaliesQuery,
         response: AdminListAnomaliesResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'List spending anomalies with filters + pagination',
         tags: ['admin-anomalies'],
     }),
     get: defineEndpoint({
         method: 'GET',
-        path: '/admin/anomalies/:anomalyId',
+        path: '/operator/anomalies/:anomalyId',
         params: AdminAnomalyIdParams,
         response: AdminGetAnomalyResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Get a single anomaly by ID',
         tags: ['admin-anomalies'],
     }),
     acknowledge: defineEndpoint({
         method: 'POST',
-        path: '/admin/anomalies/:anomalyId/acknowledge',
+        path: '/operator/anomalies/:anomalyId/acknowledge',
         params: AdminAnomalyIdParams,
         response: AdminAnomalyActionResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Mark an anomaly as acknowledged',
         tags: ['admin-anomalies'],
     }),
     dismiss: defineEndpoint({
         method: 'POST',
-        path: '/admin/anomalies/:anomalyId/dismiss',
+        path: '/operator/anomalies/:anomalyId/dismiss',
         params: AdminAnomalyIdParams,
         response: AdminAnomalyActionResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Dismiss an anomaly as a false positive',
         tags: ['admin-anomalies'],
     }),
     resolve: defineEndpoint({
         method: 'POST',
-        path: '/admin/anomalies/:anomalyId/resolve',
+        path: '/operator/anomalies/:anomalyId/resolve',
         params: AdminAnomalyIdParams,
         body: AdminResolveAnomalyInput,
         response: AdminAnomalyActionResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Resolve an anomaly with notes',
         tags: ['admin-anomalies'],
     }),
     errorsOverview: defineEndpoint({
         method: 'GET',
-        path: '/admin/anomalies/errors/overview',
+        path: '/operator/anomalies/errors/overview',
         response: AdminErrorsOverviewResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Cross-project error monitoring overview',
         tags: ['admin-anomalies'],
     }),

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

@@ -5,7 +5,7 @@
  * Production mount: `/admin/apm/*`.
  */
 export declare const adminApmEndpoints: {
-    readonly overview: import("../endpoint.js").Endpoint<"GET", "/admin/apm/:projectId/overview", import("effect/Schema").Struct<{
+    readonly overview: import("../endpoint.js").Endpoint<"GET", "/operator/apm/:projectId/overview", import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Struct<{
         startDate: import("effect/Schema").optional<typeof import("effect/Schema").String>;
@@ -24,7 +24,7 @@ export declare const adminApmEndpoints: {
             end: typeof import("effect/Schema").String;
         }>;
     }>>;
-    readonly endpoints: import("../endpoint.js").Endpoint<"GET", "/admin/apm/:projectId/endpoints", import("effect/Schema").Struct<{
+    readonly endpoints: import("../endpoint.js").Endpoint<"GET", "/operator/apm/:projectId/endpoints", import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Struct<{
         startDate: import("effect/Schema").optional<typeof import("effect/Schema").String>;
@@ -46,7 +46,7 @@ export declare const adminApmEndpoints: {
         total: typeof import("effect/Schema").Number;
         hasMore: typeof import("effect/Schema").Boolean;
     }>>;
-    readonly endpointTrend: import("../endpoint.js").Endpoint<"GET", "/admin/apm/:projectId/endpoints/trend", import("effect/Schema").Struct<{
+    readonly endpointTrend: import("../endpoint.js").Endpoint<"GET", "/operator/apm/:projectId/endpoints/trend", import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Struct<{
         startDate: import("effect/Schema").optional<typeof import("effect/Schema").String>;
@@ -62,7 +62,7 @@ export declare const adminApmEndpoints: {
         p95Ms: typeof import("effect/Schema").Number;
         p99Ms: typeof import("effect/Schema").Number;
     }>>>;
-    readonly slowestEndpoints: import("../endpoint.js").Endpoint<"GET", "/admin/apm/:projectId/endpoints/slowest", import("effect/Schema").Struct<{
+    readonly slowestEndpoints: import("../endpoint.js").Endpoint<"GET", "/operator/apm/:projectId/endpoints/slowest", import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Struct<{
         startDate: import("effect/Schema").optional<typeof import("effect/Schema").String>;
@@ -75,7 +75,7 @@ export declare const adminApmEndpoints: {
         p95Ms: typeof import("effect/Schema").Number;
         requestCount: typeof import("effect/Schema").Number;
     }>>>;
-    readonly errorEndpoints: import("../endpoint.js").Endpoint<"GET", "/admin/apm/:projectId/endpoints/errors", import("effect/Schema").Struct<{
+    readonly errorEndpoints: import("../endpoint.js").Endpoint<"GET", "/operator/apm/:projectId/endpoints/errors", import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Struct<{
         startDate: import("effect/Schema").optional<typeof import("effect/Schema").String>;
@@ -88,7 +88,7 @@ export declare const adminApmEndpoints: {
         errorRate: typeof import("effect/Schema").Number;
         requestCount: typeof import("effect/Schema").Number;
     }>>>;
-    readonly hourlyVolume: import("../endpoint.js").Endpoint<"GET", "/admin/apm/:projectId/volume", import("effect/Schema").Struct<{
+    readonly hourlyVolume: import("../endpoint.js").Endpoint<"GET", "/operator/apm/:projectId/volume", import("effect/Schema").Struct<{
         projectId: typeof import("effect/Schema").String;
     }>, import("effect/Schema").Struct<{
         startDate: import("effect/Schema").optional<typeof import("effect/Schema").String>;

package/dist/endpoints/admin-apm.js

@@ -9,61 +9,61 @@ import { AdminApmDateRangeQuery, AdminApmEndpointsQuery, AdminApmEndpointsResult
 export const adminApmEndpoints = {
     overview: defineEndpoint({
         method: 'GET',
-        path: '/admin/apm/:projectId/overview',
+        path: '/operator/apm/:projectId/overview',
         params: AdminApmProjectParams,
         query: AdminApmDateRangeQuery,
         response: AdminApmOverviewResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'APM overview — totals, error rate, latency percentiles',
         tags: ['admin-apm'],
     }),
     endpoints: defineEndpoint({
         method: 'GET',
-        path: '/admin/apm/:projectId/endpoints',
+        path: '/operator/apm/:projectId/endpoints',
         params: AdminApmProjectParams,
         query: AdminApmEndpointsQuery,
         response: AdminApmEndpointsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Per-endpoint metrics breakdown with pagination',
         tags: ['admin-apm'],
     }),
     endpointTrend: defineEndpoint({
         method: 'GET',
-        path: '/admin/apm/:projectId/endpoints/trend',
+        path: '/operator/apm/:projectId/endpoints/trend',
         params: AdminApmProjectParams,
         query: AdminApmEndpointTrendQuery,
         response: AdminApmEndpointTrendResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Time series trend for a single endpoint',
         tags: ['admin-apm'],
     }),
     slowestEndpoints: defineEndpoint({
         method: 'GET',
-        path: '/admin/apm/:projectId/endpoints/slowest',
+        path: '/operator/apm/:projectId/endpoints/slowest',
         params: AdminApmProjectParams,
         query: AdminApmTopEndpointsQuery,
         response: AdminApmSlowestEndpointsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Endpoints with highest average latency',
         tags: ['admin-apm'],
     }),
     errorEndpoints: defineEndpoint({
         method: 'GET',
-        path: '/admin/apm/:projectId/endpoints/errors',
+        path: '/operator/apm/:projectId/endpoints/errors',
         params: AdminApmProjectParams,
         query: AdminApmTopEndpointsQuery,
         response: AdminApmErrorEndpointsResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Endpoints with highest error rates',
         tags: ['admin-apm'],
     }),
     hourlyVolume: defineEndpoint({
         method: 'GET',
-        path: '/admin/apm/:projectId/volume',
+        path: '/operator/apm/:projectId/volume',
         params: AdminApmProjectParams,
         query: AdminApmDateRangeQuery,
         response: AdminApmHourlyVolumeResult,
-        plane: 'admin',
+        plane: 'management',
         summary: 'Hourly request + error volume for charts',
         tags: ['admin-apm'],
     }),