fix(session-query): checkpoint review round 3

packages/session-query/session-query/src/config.ts

@@ -25,5 +25,37 @@ export interface Config {
   readWindowMax?: number
 }
 
-/** Typed session-query failure with a stable machine-routable code. */
-export class SessionQueryError extends HarnessError {}
+/** Complete stable machine-routable failure taxonomy for session-query. */
+export type SessionQueryErrorCode =
+  | 'SESSION_QUERY_ABORTED'
+  | 'SESSION_QUERY_DUPLICATE_EXTRACTOR'
+  | 'SESSION_QUERY_DUPLICATE_PROVIDER'
+  | 'SESSION_QUERY_EVENT_NOT_FOUND'
+  | 'SESSION_QUERY_INDEX_FAILED'
+  | 'SESSION_QUERY_INVALID_CONFIG'
+  | 'SESSION_QUERY_INVALID_EXTRACTOR'
+  | 'SESSION_QUERY_INVALID_FILTER'
+  | 'SESSION_QUERY_INVALID_LIMIT'
+  | 'SESSION_QUERY_INVALID_LINEAGE'
+  | 'SESSION_QUERY_INVALID_QUERY'
+  | 'SESSION_QUERY_INVALID_SURFACE'
+  | 'SESSION_QUERY_INVALID_WINDOW'
+  | 'SESSION_QUERY_PERSISTENCE_FAILED'
+  | 'SESSION_QUERY_PROVIDER_AMBIGUOUS'
+  | 'SESSION_QUERY_PROVIDER_CONFIGURED_MISSING'
+  | 'SESSION_QUERY_PROVIDER_CONFIGURED_UNAVAILABLE'
+  | 'SESSION_QUERY_PROVIDER_ERROR'
+  | 'SESSION_QUERY_PROVIDER_UNAVAILABLE'
+  | 'SESSION_QUERY_SESSION_NOT_FOUND'
+  | 'SESSION_QUERY_SOURCE_CONFLICT'
+
+/** Typed session-query failure whose `code` is one closed taxonomy member. */
+export class SessionQueryError extends HarnessError {
+  declare readonly code: SessionQueryErrorCode
+
+  // The base stores the value; this signature narrows its open string code.
+  // eslint-disable-next-line @typescript-eslint/no-useless-constructor
+  constructor(message: string, code: SessionQueryErrorCode, options?: ErrorOptions) {
+    super(message, code, options)
+  }
+}