@uluops/ops-sdk 1.8.3 → 1.8.4

package/dist/config/validators.d.ts

@@ -1,19 +1,52 @@
 import { z } from 'zod';
 /**
- * Validation error with details
+ * Client-side validation error thrown when input fails Zod schema validation.
+ *
+ * Contains structured error details from Zod for programmatic inspection.
+ * Import from `@uluops/ops-sdk/errors` or `@uluops/ops-sdk/config`.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateSaveRunInput(data);
+ * } catch (err) {
+ *   if (err instanceof InputValidationError) {
+ *     console.log(err.message);  // "Invalid save run: project: String must contain at least 1 character(s)"
+ *     console.log(err.errors);   // Zod issue array with path, code, message per field
+ *   }
+ * }
+ * ```
  */
 export declare class InputValidationError extends Error {
     readonly errors: z.ZodError['issues'];
     constructor(message: string, errors: z.ZodError['issues']);
 }
+/**
+ * Validate user registration input.
+ * @param data - Raw input: `{ email: string (valid email, max 255), password: string (8-128 chars, requires uppercase + lowercase + digit) }`
+ * @returns Validated `RegisterInput`
+ * @throws {InputValidationError} If email is invalid or password doesn't meet requirements
+ */
 export declare function validateRegisterInput(data: unknown): {
     email: string;
     password: string;
 };
+/**
+ * Validate login input.
+ * @param data - Raw input: `{ email: string, password: string }`
+ * @returns Validated `LoginInput`
+ * @throws {InputValidationError} If email or password is missing
+ */
 export declare function validateLoginInput(data: unknown): {
     email: string;
     password: string;
 };
+/**
+ * Validate profile update input. At least one field must be provided.
+ * @param data - Raw input: `{ username?, name?, bio?, timezone?, websiteUrl?, avatar?, avatarMimeType? }`
+ * @returns Validated `UpdateProfileInput`
+ * @throws {InputValidationError} If no fields provided, or username doesn't match `^[a-z][a-z0-9_]{2,29}$`
+ */
 export declare function validateUpdateProfileInput(data: unknown): {
     username?: string | null | undefined;
     name?: string | null | undefined;
@@ -23,29 +56,74 @@ export declare function validateUpdateProfileInput(data: unknown): {
     avatar?: string | null | undefined;
     avatarMimeType?: "image/png" | "image/jpeg" | "image/gif" | "image/webp" | null | undefined;
 };
+/**
+ * Validate password change input.
+ * @param data - Raw input: `{ currentPassword: string, newPassword: string (8-128, upper+lower+digit) }`
+ * @returns Validated `ChangePasswordInput`
+ * @throws {InputValidationError} If current password missing or new password doesn't meet requirements
+ */
 export declare function validateChangePasswordInput(data: unknown): {
     currentPassword: string;
     newPassword: string;
 };
+/**
+ * Validate password reset input (from reset email).
+ * @param data - Raw input: `{ token: string, password: string (8-128, upper+lower+digit) }`
+ * @returns Validated `ResetPasswordInput`
+ * @throws {InputValidationError} If token missing or password doesn't meet requirements
+ */
 export declare function validateResetPasswordInput(data: unknown): {
     token: string;
     password: string;
 };
+/**
+ * Validate API key creation input.
+ * @param data - Raw input: `{ name?: string (max 100), expiresAt?: string (ISO 8601) }`
+ * @returns Validated `CreateApiKeyInput`
+ * @throws {InputValidationError} If name exceeds 100 chars or expiresAt is not valid ISO 8601
+ */
 export declare function validateCreateApiKeyInput(data: unknown): {
     name?: string | undefined;
     expiresAt?: string | undefined;
 };
+/**
+ * Validate project creation input.
+ * @param data - Raw input: `{ name: string (1-200 chars) }`
+ * @returns Validated `CreateProjectInput`
+ * @throws {InputValidationError} If name is empty or exceeds 200 chars
+ */
 export declare function validateCreateProjectInput(data: unknown): {
     name: string;
 };
+/**
+ * Validate project deletion input. Requires explicit confirmation.
+ * @param data - Raw input: `{ confirm: true, confirmationPhrase: string }`
+ * @returns Validated `DeleteProjectInput`
+ * @throws {InputValidationError} If confirm is not `true` or confirmationPhrase is missing
+ */
 export declare function validateDeleteProjectInput(data: unknown): {
     confirm: true;
     confirmationPhrase: string;
 };
+/**
+ * Validate project rename input.
+ * @param data - Raw input: `{ oldName: string, newName: string (1-200 chars) }`
+ * @returns Validated `RenameProjectInput`
+ * @throws {InputValidationError} If either name is empty or newName exceeds 200 chars
+ */
 export declare function validateRenameProjectInput(data: unknown): {
     oldName: string;
     newName: string;
 };
+/**
+ * Validate save run input. This is the primary validation for `client.runs.save()`.
+ * @param data - Raw input with required fields: `project` (1-200), `workflowType` (1-100),
+ *   `agents` (non-empty array), `recommendations` (array, use `[]` for empty).
+ *   Optional: `summary`, `rawMarkdown`, `idempotencyKey`, `definitionType/Name/Version/Hash`,
+ *   `analysisRecords`, `analysisSummary`.
+ * @returns Validated `SaveRunInput`
+ * @throws {InputValidationError} If required fields missing, agents empty, or field constraints violated
+ */
 export declare function validateSaveRunInput(data: unknown): {
     project: string;
     workflowType: string;
@@ -64,6 +142,7 @@ export declare function validateSaveRunInput(data: unknown): {
             totalEffectiveTokens?: number | undefined;
         } | undefined;
         durationMs?: number | undefined;
+        definitionVersion?: string | undefined;
     }[];
     recommendations: {
         agent: string;
@@ -94,6 +173,7 @@ export declare function validateSaveRunInput(data: unknown): {
     definitionName?: string | undefined;
     definitionVersion?: string | undefined;
     definitionHash?: string | undefined;
+    definitionId?: string | undefined;
     definitionMinSubscription?: "free" | "hobbyist" | "plus" | "pro" | "enterprise" | undefined;
     analysisRecords?: {
         recordType: string;
@@ -130,6 +210,13 @@ export declare function validateSaveRunInput(data: unknown): {
         auditImplications?: string[] | null | undefined;
     }[] | undefined;
 };
+/**
+ * Validate archive runs input.
+ * @param data - Raw input: `{ project: string }` plus at least one filter:
+ *   `beforeRunNumber?`, `beforeDate?` (ISO 8601), `keepLast?`, `reason?` (max 500)
+ * @returns Validated `ArchiveRunsInput`
+ * @throws {InputValidationError} If project missing or filter constraints violated
+ */
 export declare function validateArchiveRunsInput(data: unknown): {
     project: string;
     beforeRunNumber?: number | undefined;
@@ -137,6 +224,15 @@ export declare function validateArchiveRunsInput(data: unknown): {
     keepLast?: number | undefined;
     reason?: string | undefined;
 };
+/**
+ * Validate user-submitted issue creation input.
+ * @param data - Raw input with required: `project` (1-200), `title` (1-500),
+ *   `priority` ('critical' | 'high' | 'suggested' | 'backlog').
+ *   Optional: `severity`, `category`, `description` (max 10000), `filePath`, `lineNumber`,
+ *   `failureCode` (e.g. 'SEM-VAL/H'), `failureDomain`, `failureMode`, `agent`, `type`.
+ * @returns Validated `CreateUserIssueInput`
+ * @throws {InputValidationError} If required fields missing or constraints violated
+ */
 export declare function validateCreateUserIssueInput(data: unknown): {
     project: string;
     title: string;
@@ -152,6 +248,12 @@ export declare function validateCreateUserIssueInput(data: unknown): {
     agent?: string | undefined;
     type?: "observation" | "feature" | "bug" | "refactor" | "config" | "docs" | "infra" | "security" | "test" | "deficiency" | "ambiguity" | undefined;
 };
+/**
+ * Validate issue metadata update input. All fields optional.
+ * @param data - Raw input: `{ title?, status?, priority?, severity?, failureCode?, filePath?, lineNumber?, ... }`
+ * @returns Validated `UpdateIssueInput`
+ * @throws {InputValidationError} If any provided field violates its constraints
+ */
 export declare function validateUpdateIssueInput(data: unknown): {
     title?: string | undefined;
     status?: "open" | "completed" | "deferred" | "wontfix" | "merged" | "false-positive" | "observation" | undefined;
@@ -165,15 +267,33 @@ export declare function validateUpdateIssueInput(data: unknown): {
     filePath?: string | null | undefined;
     lineNumber?: number | null | undefined;
 };
+/**
+ * Validate issue status update input.
+ * @param data - Raw input: `{ status: Status, reason?: string (max 500) }`
+ * @returns Validated `UpdateIssueStatusInput`
+ * @throws {InputValidationError} If status is not a valid Status enum value
+ */
 export declare function validateUpdateIssueStatusInput(data: unknown): {
     status: "open" | "completed" | "deferred" | "wontfix" | "merged" | "false-positive" | "observation";
     reason?: string | undefined;
 };
+/**
+ * Validate issue note creation input.
+ * @param data - Raw input: `{ content: string (1-10000), noteType?: NoteType, createdBy?: string }`
+ * @returns Validated `CreateIssueNoteInput`
+ * @throws {InputValidationError} If content is empty or exceeds 10000 chars
+ */
 export declare function validateCreateIssueNoteInput(data: unknown): {
     content: string;
     noteType?: "context" | "resolution" | "blocker" | undefined;
     createdBy?: string | undefined;
 };
+/**
+ * Validate bulk issue status update input. Max 100 items per request.
+ * @param data - Raw input: `{ updates: Array<{ issueId?: string, id?: string, status: Status, reason?: string }> }`
+ * @returns Validated bulk update input
+ * @throws {InputValidationError} If updates array is empty, exceeds 100 items, or any item has invalid status
+ */
 export declare function validateBulkStatusUpdateInput(data: unknown): {
     updates: {
         status: "open" | "completed" | "deferred" | "wontfix" | "merged" | "false-positive" | "observation";
@@ -182,7 +302,27 @@ export declare function validateBulkStatusUpdateInput(data: unknown): {
         reason?: string | undefined;
     }[];
 };
+/**
+ * Validate that a string is a valid UUID v1-5.
+ * @param value - The string to validate
+ * @param fieldName - Field name for error messages (e.g. 'projectId', 'issueId')
+ * @throws {InputValidationError} If value is not a valid UUID format
+ */
 export declare function validateUuid(value: string, fieldName: string): void;
+/**
+ * Validate that a value is a non-empty string after trimming.
+ * @param value - The value to validate
+ * @param fieldName - Field name for error messages
+ * @returns The trimmed string
+ * @throws {InputValidationError} If value is not a string or is empty after trimming
+ */
 export declare function validateRequiredString(value: unknown, fieldName: string): string;
+/**
+ * Validate that a value is a positive integer (> 0).
+ * @param value - The value to validate (coerced via `Number()`)
+ * @param fieldName - Field name for error messages
+ * @returns The validated number
+ * @throws {InputValidationError} If value is not a positive integer
+ */
 export declare function validatePositiveInt(value: unknown, fieldName: string): number;
 //# sourceMappingURL=validators.d.ts.map

package/dist/config/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/config/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAD5C,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;CAK/C;AA2BD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO;;;EAElD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO;;;EAE/C;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;;;;;;EAEvD;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO;;;EAExD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;EAEvD;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO;;;EAEtD;AAMD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;EAEvD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;EAEvD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;EAEvD;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO;;;;;;EAErD;AAMD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;EAEzD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;EAErD;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO;;;EAE3D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO;;;;EAEzD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO;;;;;;;EAE1D;AAOD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM7E"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/config/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAD5C,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;CAK/C;AA2BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO;;;EAElD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO;;;EAE/C;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;;;;;;EAEvD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO;;;EAExD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;EAEvD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO;;;EAEtD;AAMD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;EAEvD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;EAEvD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO;;;EAEvD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO;;;;;;EAErD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;;EAEzD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;EAErD;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO;;;EAE3D;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO;;;;EAEzD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO;;;;;;;EAE1D;AAOD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOnE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM7E"}

package/dist/config/validators.js

@@ -1,6 +1,21 @@
 import { CreateProjectInputSchema, SaveRunInputSchema, CreateUserIssueInputSchema, UpdateIssueStatusInputSchema, CreateIssueNoteInputSchema, ArchiveRunsInputSchema, RegisterInputSchema, LoginInputSchema, UpdateProfileInputSchema, ChangePasswordInputSchema, ResetPasswordInputSchema, CreateApiKeyInputSchema, BulkStatusUpdateInputSchema, DeleteProjectInputSchema, RenameProjectInputSchema, UpdateIssueInputSchema, } from '../types/schemas.js';
 /**
- * Validation error with details
+ * Client-side validation error thrown when input fails Zod schema validation.
+ *
+ * Contains structured error details from Zod for programmatic inspection.
+ * Import from `@uluops/ops-sdk/errors` or `@uluops/ops-sdk/config`.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateSaveRunInput(data);
+ * } catch (err) {
+ *   if (err instanceof InputValidationError) {
+ *     console.log(err.message);  // "Invalid save run: project: String must contain at least 1 character(s)"
+ *     console.log(err.errors);   // Zod issue array with path, code, message per field
+ *   }
+ * }
+ * ```
  */
 export class InputValidationError extends Error {
     errors;
@@ -11,7 +26,7 @@ export class InputValidationError extends Error {
     }
 }
 /**
- * Generic validation function
+ * Format a single Zod issue into a human-readable string.
  */
 function formatZodIssue(e) {
     const field = e.path.join('.') || '(root)';
@@ -32,78 +47,205 @@ function validate(schema, data, context) {
 // ============================================
 // AUTH VALIDATORS
 // ============================================
+/**
+ * Validate user registration input.
+ * @param data - Raw input: `{ email: string (valid email, max 255), password: string (8-128 chars, requires uppercase + lowercase + digit) }`
+ * @returns Validated `RegisterInput`
+ * @throws {InputValidationError} If email is invalid or password doesn't meet requirements
+ */
 export function validateRegisterInput(data) {
     return validate(RegisterInputSchema, data, 'register input');
 }
+/**
+ * Validate login input.
+ * @param data - Raw input: `{ email: string, password: string }`
+ * @returns Validated `LoginInput`
+ * @throws {InputValidationError} If email or password is missing
+ */
 export function validateLoginInput(data) {
     return validate(LoginInputSchema, data, 'login input');
 }
+/**
+ * Validate profile update input. At least one field must be provided.
+ * @param data - Raw input: `{ username?, name?, bio?, timezone?, websiteUrl?, avatar?, avatarMimeType? }`
+ * @returns Validated `UpdateProfileInput`
+ * @throws {InputValidationError} If no fields provided, or username doesn't match `^[a-z][a-z0-9_]{2,29}$`
+ */
 export function validateUpdateProfileInput(data) {
     return validate(UpdateProfileInputSchema, data, 'profile update');
 }
+/**
+ * Validate password change input.
+ * @param data - Raw input: `{ currentPassword: string, newPassword: string (8-128, upper+lower+digit) }`
+ * @returns Validated `ChangePasswordInput`
+ * @throws {InputValidationError} If current password missing or new password doesn't meet requirements
+ */
 export function validateChangePasswordInput(data) {
     return validate(ChangePasswordInputSchema, data, 'password change');
 }
+/**
+ * Validate password reset input (from reset email).
+ * @param data - Raw input: `{ token: string, password: string (8-128, upper+lower+digit) }`
+ * @returns Validated `ResetPasswordInput`
+ * @throws {InputValidationError} If token missing or password doesn't meet requirements
+ */
 export function validateResetPasswordInput(data) {
     return validate(ResetPasswordInputSchema, data, 'password reset');
 }
+/**
+ * Validate API key creation input.
+ * @param data - Raw input: `{ name?: string (max 100), expiresAt?: string (ISO 8601) }`
+ * @returns Validated `CreateApiKeyInput`
+ * @throws {InputValidationError} If name exceeds 100 chars or expiresAt is not valid ISO 8601
+ */
 export function validateCreateApiKeyInput(data) {
     return validate(CreateApiKeyInputSchema, data, 'API key creation');
 }
 // ============================================
 // PROJECT VALIDATORS
 // ============================================
+/**
+ * Validate project creation input.
+ * @param data - Raw input: `{ name: string (1-200 chars) }`
+ * @returns Validated `CreateProjectInput`
+ * @throws {InputValidationError} If name is empty or exceeds 200 chars
+ */
 export function validateCreateProjectInput(data) {
     return validate(CreateProjectInputSchema, data, 'project creation');
 }
+/**
+ * Validate project deletion input. Requires explicit confirmation.
+ * @param data - Raw input: `{ confirm: true, confirmationPhrase: string }`
+ * @returns Validated `DeleteProjectInput`
+ * @throws {InputValidationError} If confirm is not `true` or confirmationPhrase is missing
+ */
 export function validateDeleteProjectInput(data) {
     return validate(DeleteProjectInputSchema, data, 'project deletion');
 }
+/**
+ * Validate project rename input.
+ * @param data - Raw input: `{ oldName: string, newName: string (1-200 chars) }`
+ * @returns Validated `RenameProjectInput`
+ * @throws {InputValidationError} If either name is empty or newName exceeds 200 chars
+ */
 export function validateRenameProjectInput(data) {
     return validate(RenameProjectInputSchema, data, 'project rename');
 }
 // ============================================
 // RUN VALIDATORS
 // ============================================
+/**
+ * Validate save run input. This is the primary validation for `client.runs.save()`.
+ * @param data - Raw input with required fields: `project` (1-200), `workflowType` (1-100),
+ *   `agents` (non-empty array), `recommendations` (array, use `[]` for empty).
+ *   Optional: `summary`, `rawMarkdown`, `idempotencyKey`, `definitionType/Name/Version/Hash`,
+ *   `analysisRecords`, `analysisSummary`.
+ * @returns Validated `SaveRunInput`
+ * @throws {InputValidationError} If required fields missing, agents empty, or field constraints violated
+ */
 export function validateSaveRunInput(data) {
     return validate(SaveRunInputSchema, data, 'save run');
 }
+/**
+ * Validate archive runs input.
+ * @param data - Raw input: `{ project: string }` plus at least one filter:
+ *   `beforeRunNumber?`, `beforeDate?` (ISO 8601), `keepLast?`, `reason?` (max 500)
+ * @returns Validated `ArchiveRunsInput`
+ * @throws {InputValidationError} If project missing or filter constraints violated
+ */
 export function validateArchiveRunsInput(data) {
     return validate(ArchiveRunsInputSchema, data, 'archive runs');
 }
 // ============================================
 // ISSUE VALIDATORS
 // ============================================
+/**
+ * Validate user-submitted issue creation input.
+ * @param data - Raw input with required: `project` (1-200), `title` (1-500),
+ *   `priority` ('critical' | 'high' | 'suggested' | 'backlog').
+ *   Optional: `severity`, `category`, `description` (max 10000), `filePath`, `lineNumber`,
+ *   `failureCode` (e.g. 'SEM-VAL/H'), `failureDomain`, `failureMode`, `agent`, `type`.
+ * @returns Validated `CreateUserIssueInput`
+ * @throws {InputValidationError} If required fields missing or constraints violated
+ */
 export function validateCreateUserIssueInput(data) {
     return validate(CreateUserIssueInputSchema, data, 'issue creation');
 }
+/**
+ * Validate issue metadata update input. All fields optional.
+ * @param data - Raw input: `{ title?, status?, priority?, severity?, failureCode?, filePath?, lineNumber?, ... }`
+ * @returns Validated `UpdateIssueInput`
+ * @throws {InputValidationError} If any provided field violates its constraints
+ */
 export function validateUpdateIssueInput(data) {
     return validate(UpdateIssueInputSchema, data, 'issue update');
 }
+/**
+ * Validate issue status update input.
+ * @param data - Raw input: `{ status: Status, reason?: string (max 500) }`
+ * @returns Validated `UpdateIssueStatusInput`
+ * @throws {InputValidationError} If status is not a valid Status enum value
+ */
 export function validateUpdateIssueStatusInput(data) {
     return validate(UpdateIssueStatusInputSchema, data, 'status update');
 }
+/**
+ * Validate issue note creation input.
+ * @param data - Raw input: `{ content: string (1-10000), noteType?: NoteType, createdBy?: string }`
+ * @returns Validated `CreateIssueNoteInput`
+ * @throws {InputValidationError} If content is empty or exceeds 10000 chars
+ */
 export function validateCreateIssueNoteInput(data) {
     return validate(CreateIssueNoteInputSchema, data, 'issue note');
 }
+/**
+ * Validate bulk issue status update input. Max 100 items per request.
+ * @param data - Raw input: `{ updates: Array<{ issueId?: string, id?: string, status: Status, reason?: string }> }`
+ * @returns Validated bulk update input
+ * @throws {InputValidationError} If updates array is empty, exceeds 100 items, or any item has invalid status
+ */
 export function validateBulkStatusUpdateInput(data) {
     return validate(BulkStatusUpdateInputSchema, data, 'bulk status update');
 }
 // ============================================
 // SIMPLE VALIDATORS
 // ============================================
+/**
+ * Validate that a string is a valid UUID v1-5.
+ * @param value - The string to validate
+ * @param fieldName - Field name for error messages (e.g. 'projectId', 'issueId')
+ * @throws {InputValidationError} If value is not a valid UUID format
+ */
 export function validateUuid(value, fieldName) {
     const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
     if (!uuidRegex.test(value)) {
-        throw new InputValidationError(`Invalid ${fieldName}: must be a valid UUID`, []);
+        throw new InputValidationError(`Invalid ${fieldName}: must be a valid UUID`, [
+            { code: 'custom', path: [fieldName], message: 'must be a valid UUID' }
+        ]);
     }
 }
+/**
+ * Validate that a value is a non-empty string after trimming.
+ * @param value - The value to validate
+ * @param fieldName - Field name for error messages
+ * @returns The trimmed string
+ * @throws {InputValidationError} If value is not a string or is empty after trimming
+ */
 export function validateRequiredString(value, fieldName) {
     if (typeof value !== 'string' || value.trim().length === 0) {
-        throw new InputValidationError(`${fieldName} is required`, []);
+        throw new InputValidationError(`${fieldName} is required`, [
+            { code: 'custom', path: [fieldName], message: 'is required' }
+        ]);
     }
     return value.trim();
 }
+/**
+ * Validate that a value is a positive integer (> 0).
+ * @param value - The value to validate (coerced via `Number()`)
+ * @param fieldName - Field name for error messages
+ * @returns The validated number
+ * @throws {InputValidationError} If value is not a positive integer
+ */
 export function validatePositiveInt(value, fieldName) {
     const num = Number(value);
     if (!Number.isInteger(num) || num <= 0) {

package/dist/config/validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/config/validators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/config/validators.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG3B;IAFlB,YACE,OAAe,EACC,MAA4B;QAE5C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAsB;QAG5C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,CAA+B;IACrD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,QAAQ,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,GAAG,KAAK,oBAAoB,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAI,MAAoB,EAAE,IAAa,EAAE,OAAe;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,oBAAoB,CAAC,WAAW,OAAO,KAAK,QAAQ,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,+CAA+C;AAC/C,kBAAkB;AAClB,+CAA+C;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,QAAQ,CAAC,mBAAmB,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,QAAQ,CAAC,gBAAgB,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,QAAQ,CAAC,wBAAwB,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,OAAO,QAAQ,CAAC,yBAAyB,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,QAAQ,CAAC,wBAAwB,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAa;IACrD,OAAO,QAAQ,CAAC,uBAAuB,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;AACrE,CAAC;AAED,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,QAAQ,CAAC,wBAAwB,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,QAAQ,CAAC,wBAAwB,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,QAAQ,CAAC,wBAAwB,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACpE,CAAC;AAED,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,QAAQ,CAAC,kBAAkB,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,OAAO,QAAQ,CAAC,sBAAsB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAa;IACxD,OAAO,QAAQ,CAAC,0BAA0B,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,OAAO,QAAQ,CAAC,sBAAsB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAa;IAC1D,OAAO,QAAQ,CAAC,4BAA4B,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAa;IACxD,OAAO,QAAQ,CAAC,0BAA0B,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAa;IACzD,OAAO,QAAQ,CAAC,2BAA2B,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC;AAC3E,CAAC;AAGD,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,SAAiB;IAC3D,MAAM,SAAS,GAAG,4EAA4E,CAAC;IAC/F,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,oBAAoB,CAAC,WAAW,SAAS,wBAAwB,EAAE;YAC3E,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,SAAiB;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,oBAAoB,CAAC,GAAG,SAAS,cAAc,EAAE;YACzD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,SAAiB;IACnE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,oBAAoB,CAAC,GAAG,SAAS,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/http/http-client.d.ts

@@ -9,21 +9,36 @@ export { toQuery, type QueryParams, type QueryParamValue } from '@uluops/sdk-cor
 import { type QueryParams as _QP } from '@uluops/sdk-core/utils';
 /**
  * Convert a camelCase query object to snake_case QueryParams for the API.
- * Strips 'all' values (API doesn't accept 'all' as a filter — omit to get all).
+ *
+ * @remarks
+ * Values of `'all'` are intentionally stripped — the API interprets an absent
+ * filter parameter as "return all", so `status: 'all'` and omitting `status`
+ * produce the same result. This convention is used by `StatusFilter` and
+ * `PriorityFilter` union types which include `'all'` for consumer ergonomics.
  */
 export declare function toApiQuery(query: object | undefined): _QP | undefined;
 /**
- * HTTP client configuration
+ * HTTP client configuration — shared base for OpsClient and OpsHttpClient.
+ * OpsClientConfig extends this with higher-level options.
  */
 export interface HttpClientConfig {
+    /** API base URL (defaults to production; localhost:3100 when NODE_ENV=development) */
     baseUrl?: string;
+    /** Request timeout in ms */
     timeout?: number;
+    /** Number of retries for transient errors */
     retries?: number;
+    /** Enable debug logging */
     debug?: boolean;
+    /** API key for authentication (preferred) */
     apiKey?: string;
+    /** Email for session-based auth */
     email?: string;
+    /** Password for session-based auth */
     password?: string;
+    /** Existing session token */
     sessionToken?: string;
+    /** Callback when session token is refreshed */
     onTokenRefresh?: (token: string) => void;
     /** Org slug for multi-tenancy — sets X-Org-Slug header on all requests */
     orgSlug?: string;

package/dist/http/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,KAAK,WAAW,IAAI,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,CAkBrE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,MAAM,GAAE,gBAAqB;CAY1C"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,KAAK,WAAW,IAAI,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,CAkBrE;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,MAAM,GAAE,gBAAqB;CAY1C"}

package/dist/http/http-client.js

@@ -11,7 +11,12 @@ export { toQuery } from '@uluops/sdk-core/utils';
 import { toSnakeCase } from '../utils/helpers.js';
 /**
  * Convert a camelCase query object to snake_case QueryParams for the API.
- * Strips 'all' values (API doesn't accept 'all' as a filter — omit to get all).
+ *
+ * @remarks
+ * Values of `'all'` are intentionally stripped — the API interprets an absent
+ * filter parameter as "return all", so `status: 'all'` and omitting `status`
+ * produce the same result. This convention is used by `StatusFilter` and
+ * `PriorityFilter` union types which include `'all'` for consumer ergonomics.
  */
 export function toApiQuery(query) {
     if (!query)

package/dist/http/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAA0C,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS,CAAC,yCAAyC;QACxE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3G,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,qEAAqE;YACrE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YACrF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,mEAAmE;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAmBD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,SAA2B,EAAE;QACvC,KAAK,CAAC;YACJ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;YAC3C,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,gBAAgB;YAC9B,cAAc,EAAE;gBACd,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAA0C,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS,CAAC,yCAAyC;QACxE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3G,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,qEAAqE;YACrE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YACrF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,mEAAmE;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AA6BD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,SAA2B,EAAE;QACvC,KAAK,CAAC;YACJ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;YAC3C,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,gBAAgB;YAC9B,cAAc,EAAE;gBACd,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export { OpsHttpClient, type HttpClientConfig, type QueryParams, type QueryParam
 export { ApiKeyAuth, JwtSessionAuth, createAuthStrategy, type AuthStrategy, type AuthConfig } from './http/auth-strategy.js';
 export * from './errors/errors.js';
 export * from './types/index.js';
+export type { AnalyticsMetric } from './operations/analytics.js';
 export { loadCredentials, loadConfig, loadEnvFiles, type Credentials, type SdkConfig } from './config/loaders.js';
 export { DEFAULT_BASE_URL, API_KEY_PREFIX, ENV_VARS } from './config/constants.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG7H,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG7H,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2DAA2D;AAC3D,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAC;AAE9D,oFAAoF;AACpF,OAAO,EAAE,aAAa,EAAiE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAsC,MAAM,yBAAyB,CAAC;AAE7H,0EAA0E;AAC1E,cAAc,oBAAoB,CAAC;AAEnC,gEAAgE;AAChE,cAAc,kBAAkB,CAAC;AAEjC,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAoC,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2DAA2D;AAC3D,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAC;AAE9D,oFAAoF;AACpF,OAAO,EAAE,aAAa,EAAiE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAsC,MAAM,yBAAyB,CAAC;AAE7H,0EAA0E;AAC1E,cAAc,oBAAoB,CAAC;AAEnC,gEAAgE;AAChE,cAAc,kBAAkB,CAAC;AAKjC,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAoC,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}