@company-semantics/contracts 0.136.0 → 0.137.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.136.0",
+  "version": "0.137.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/index.ts

@@ -603,3 +603,12 @@ export { wrapSecret, unwrapSecret } from './security/index'
 // Analytics response metadata (shared vocabulary for OLTP/OLAP separation)
 // @see ADR-CTRL-053 for design rationale
 export type { AnalyticsBackend, AnalyticsResponseMeta } from './types/analytics'
+
+// Client request scheduler types (shared tier vocabulary)
+export type {
+  Tier,
+  MutationBehavior,
+  SchedulerResourceKey,
+  RequestDescriptor,
+  SchedulerEvent,
+} from './requests'

package/src/requests.ts

@@ -0,0 +1,28 @@
+export type Tier = 'P0' | 'P1' | 'P2' | 'P3';
+
+export type MutationBehavior = 'collapse' | 'queue' | 'parallel';
+
+export type SchedulerResourceKey = {
+  type: string;
+  orgId?: string;
+  resourceId?: string;
+};
+
+export type RequestDescriptor = {
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  path: string;
+  params?: Record<string, unknown>;
+  tier: Tier;
+  resourceKey: SchedulerResourceKey;
+  signal?: AbortSignal;
+  mutationBehavior?: MutationBehavior;
+  headers?: Record<string, string>;
+  body?: unknown;
+};
+
+export type SchedulerEvent =
+  | { type: 'enqueued'; id: string; descriptor: RequestDescriptor; queuedAt: number }
+  | { type: 'started'; id: string; descriptor: RequestDescriptor; startedAt: number; waitedMs: number }
+  | { type: 'settled'; id: string; descriptor: RequestDescriptor; durationMs: number; ok: boolean; status?: number }
+  | { type: 'aborted'; id: string; descriptor: RequestDescriptor; reason: 'superseded' | 'invalidated' | 'unmounted' | 'external' }
+  | { type: 'deduped'; id: string; descriptor: RequestDescriptor; sharedWith: string };