@spottoai/types-package 1.0.2-beta.22 → 1.0.2-beta.221

package/dist/azure/recommendationAudit.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecommendationAuditRowKinds = void 0;
+exports.RecommendationAuditRowKinds = {
+    resourceTarget: 'resource-view:target',
+    subscriptionTarget: 'scope-view:target',
+    resourceProviderScopeFeed: 'resource-view:providerScope-feed',
+    subscriptionProviderScopeFeed: 'scope-view:providerScope-feed',
+};
+//# sourceMappingURL=recommendationAudit.js.map

package/dist/azure/recommendationAudit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendationAudit.js","sourceRoot":"","sources":["../../src/azure/recommendationAudit.ts"],"names":[],"mappings":";;;AAEa,QAAA,2BAA2B,GAAG;IACzC,cAAc,EAAE,sBAAsB;IACtC,kBAAkB,EAAE,mBAAmB;IACvC,yBAAyB,EAAE,kCAAkC;IAC7D,6BAA6B,EAAE,+BAA+B;CACtD,CAAC"}

package/dist/azure/recommendationState.d.ts

@@ -1,24 +1,113 @@
-export interface RecommendationState {
+import type { ProviderName, ProviderScope } from '../common/provider';
+export type CommentScope = 'resource' | 'providerScope';
+export type ResourceRecommendationStatesQuery = {
+    providerName: ProviderName;
+    scope: 'resource';
     resourceId: string;
     recommendationId: string;
-    subscriptionId: string;
+    providerScopeId?: never;
+};
+export type ProviderScopeRecommendationStatesQuery = {
+    providerName: ProviderName;
+    scope: 'providerScope';
+    providerScopeId: string;
+    recommendationId: string;
+    resourceId?: never;
+};
+/** @deprecated Use ProviderScopeRecommendationStatesQuery */
+export type SubscriptionRecommendationStatesQuery = ProviderScopeRecommendationStatesQuery;
+/** @deprecated Use GetRecommendationStatesQuery */
+export type LegacyGetRecommendationStatesQuery = {
+    providerName: ProviderName;
+    resourceId: string;
+    recommendationId?: string;
+    providerScopeId?: string;
+} | {
+    providerName: ProviderName;
+    recommendationId?: string;
+    resourceId?: string;
+    providerScopeId: string;
+};
+export type GetRecommendationStatesQuery = ResourceRecommendationStatesQuery | ProviderScopeRecommendationStatesQuery;
+/** Shared recommendation-state properties across scope variants. */
+export interface RecommendationStateBase extends ProviderScope {
+    /**
+     * Deprecated alias retained for compatibility with older UI consumers.
+     * Prefer `providerScopeId`.
+     */
+    subscriptionId?: string;
+    /** Row Key */
+    recommendationId: string;
+    /** Company ID to which the resource belongs */
     companyId: string;
     category: 'Cost' | 'Performance' | 'Security' | 'Compliance' | 'Reliability' | 'Operational Excellence';
     impact: 'High' | 'Medium' | 'Low';
     effort: 'High' | 'Medium' | 'Low';
+    /** true if the user has read the recommendation */
     read: boolean;
-    status: 'Active' | 'Prioritized' | 'Dismissed' | 'Archived';
+    status: 'Active' | 'Prioritized' | 'Dismissed' | 'Archived' | 'Implementing' | 'Implemented' | 'Failed';
+    /** Date the recommendation was scheduled for */
     scheduledAt?: Date;
+    /** Date the recommendation state was created */
     createdAt: Date;
+    /** Date the recommendation state was last updated */
     updatedAt?: Date;
+    /** true if the recommendation is flagged */
     flagged: boolean;
+    /** Latest successful share provider (normalized lowercase channel name). */
+    integrationProviderName?: string;
+    /**
+     * Latest successful share reference.
+     * - `jira` | `halo` | `connectwise`: external ticket id
+     * - `email`: primary recipient email
+     * - `slack` | `teams`: unset
+     */
+    integrationTicketId?: string;
     comments: Comment[];
+    /** ID of the pinned comment */
+    pinnedCommentId?: string;
     history: RecommendationHistory[];
     custom: boolean;
+    /** Date when the status started */
+    statusStartAt?: string;
+    /** Date when the status is expected to change */
+    statusEndAt?: string;
 }
+export interface ResourceRecommendationState extends RecommendationStateBase {
+    /**
+     * Scope discriminator for recommendation commentary identity.
+     * Resource scope identity is keyed by `resourceId + recommendationId`.
+     */
+    scope: 'resource';
+    /** Partition Key: resourceId (Hash) */
+    resourceId: string;
+}
+export interface ProviderScopeRecommendationState extends RecommendationStateBase {
+    /**
+     * Scope discriminator for recommendation commentary identity.
+     * Provider scope identity is keyed by `providerScopeId + recommendationId`.
+     */
+    scope: 'providerScope';
+    /** Provider-scope commentary must not rely on resource identity. */
+    resourceId?: never;
+}
+export type RecommendationState = ResourceRecommendationState | ProviderScopeRecommendationState;
+/** @deprecated Use RecommendationState */
+export type LegacyRecommendationState = RecommendationStateBase & {
+    scope?: CommentScope;
+    resourceId: string;
+};
+/** @deprecated Use RecommendationState */
+export type RecommendationStateRecord = RecommendationState | LegacyRecommendationState;
+export type ResourceRecommendationStateWriteRequest = ResourceRecommendationState;
+export type ProviderScopeRecommendationStateWriteRequest = ProviderScopeRecommendationState;
+/** @deprecated Use ProviderScopeRecommendationStateWriteRequest */
+export type SubscriptionRecommendationStateWriteRequest = ProviderScopeRecommendationStateWriteRequest;
+export type SaveRecommendationStateRequest = ResourceRecommendationStateWriteRequest | ProviderScopeRecommendationStateWriteRequest;
 export interface RecommendationHistory {
     userId: string;
     createdAt: Date;
+    /** restore means back from dismissed state */
     action: 'Dismiss' | 'Restore' | 'Prioritize' | 'Unprioritize' | 'Implement';
     reason?: string;
 }

package/dist/azure/recommendationState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommendationState.d.ts","sourceRoot":"","sources":["../../src/azure/recommendationState.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,mBAAmB;IAElC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,wBAAwB,CAAC;IACxG,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5D,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"recommendationState.d.ts","sourceRoot":"","sources":["../../src/azure/recommendationState.ts"],"names":[],"mappings":"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"}

package/dist/azure/recommendations.d.ts

@@ -1,5 +1,9 @@
-import { Comment, RecommendationHistory } from './recommendationState';
-import { SecurityImpact } from './security';
+import type { Comment, CommentScope, RecommendationHistory } from './recommendationState';
+import type { ProviderScope } from '../common/provider';
+import { SecurityAssessmentStatus, SecurityImpact, SubscriptionSecurityStatus } from './security';
+import { SubscriptionSummaryLite } from './subscriptions';
+import { CostSavingsSummary, SavingsPotential, VmPricePerformanceInsights } from './views';
+import type { HaloRoutingOverrides } from '../integrations/halo';
 export declare enum RecommendationCategory {
     Cost = "Cost",
     Performance = "Performance",
@@ -9,14 +13,182 @@ export declare enum RecommendationCategory {
     OperationalExcellence = "OperationalExcellence",
     OperationalExcellenceAlternative = "Operational Excellence"
 }
+export type RecommendationPriorityTier = 'must_do' | 'normal';
+export type EffortEstimateProfileName = 'clickops' | 'devops' | 'enterprise';
+export interface RecommendationBaseScores {
+    cost_optimization: number;
+    security: number;
+    performance: number;
+    reliability: number;
+    compliance: number;
+    operational_excellence: number;
+}
+export interface RecommendationEffortEstimateBreakdown {
+    discovery: number;
+    implementation: number;
+    validation: number;
+    rollbackPlanning: number;
+    coordination: number;
+}
+export interface RecommendationEffortEstimateProfile {
+    effortHours: number;
+    breakdown: RecommendationEffortEstimateBreakdown;
+    reason: string;
+}
+export interface RecommendationEffortEstimateProfiles {
+    clickops: RecommendationEffortEstimateProfile;
+    devops: RecommendationEffortEstimateProfile;
+    enterprise: RecommendationEffortEstimateProfile;
+}
+export interface RecommendationBulkEffortEstimateProfile {
+    setupHours: number;
+    perResourceHours: number;
+    validationHours: number;
+}
+export interface RecommendationBulkEffortEstimateProfiles {
+    clickops: RecommendationBulkEffortEstimateProfile;
+    devops: RecommendationBulkEffortEstimateProfile;
+    enterprise: RecommendationBulkEffortEstimateProfile;
+}
+export interface RecommendationBulkEffortEstimates {
+    supported: boolean;
+    threshold: number;
+    profiles: RecommendationBulkEffortEstimateProfiles;
+}
+export interface RecommendationEffortEstimates {
+    profiles: RecommendationEffortEstimateProfiles;
+    bulk: RecommendationBulkEffortEstimates;
+    overridden?: boolean;
+    lastUpdatedAt?: string;
+    notes?: string;
+}
+export interface RecommendationActionImpactAssessment {
+    downtime: string;
+    dataLoss: string;
+    accessImpact: string;
+    dependencies: string;
+}
+export type RecommendationActionRiskLevel = 'low' | 'medium' | 'high';
+export interface RecommendationActionRollback {
+    supported: boolean;
+    description: string;
+    limitations: string[];
+}
+export interface RecommendationActionCheck {
+    label: string;
+    description: string;
+}
+export interface RecommendationActionLink {
+    label: string;
+    url: string;
+}
+export interface RecommendationActionPostValidation {
+    label: string;
+    description: string;
+    expectedResult: string;
+    links?: RecommendationActionLink[];
+}
+export type RecommendationActionPermissionProvider = 'azure-rbac';
+export type RecommendationActionPermissionScope = 'targetResource' | 'resourceGroup' | 'subscription' | 'tenant';
+export interface RecommendationActionPermissionRequirement {
+    label: string;
+    name: string;
+    reason: string;
+    links?: RecommendationActionLink[];
+}
+export interface RecommendationActionLeastPrivilegeRole {
+    label: string;
+    description: string;
+}
+export interface RecommendationActionSuggestedRole {
+    label: string;
+    roleName: string;
+    roleDefinitionId?: string;
+    reason: string;
+}
+export interface RecommendationActionRequiredPermissions {
+    provider: RecommendationActionPermissionProvider;
+    scope: RecommendationActionPermissionScope;
+    actions: RecommendationActionPermissionRequirement[];
+    dataActions: RecommendationActionPermissionRequirement[];
+    leastPrivilegeRole?: RecommendationActionLeastPrivilegeRole;
+    suggestedRoles?: RecommendationActionSuggestedRole[];
+}
+export interface RecommendationActionDefinition {
+    verified: boolean;
+    title: string;
+    description: string;
+    estimatedDuration: string;
+    riskLevel: RecommendationActionRiskLevel;
+    requiredPermissions?: RecommendationActionRequiredPermissions;
+    impactAssessment: RecommendationActionImpactAssessment;
+    rollback: RecommendationActionRollback;
+    humanPreChecks: RecommendationActionCheck[];
+    postValidation: RecommendationActionPostValidation[];
+}
+export type RecommendationActionMetadata = RecommendationActionDefinition;
+export type RecommendationImplementActionImpactAssessment = RecommendationActionImpactAssessment;
+export type RecommendationImplementAction = RecommendationActionMetadata;
 export interface RecommendationResources {
     recommendation: CustomAzureRecommendation;
     resourceIds: string[];
 }
+export type HddSsdMigrationTargetTier = 'standardSsd' | 'premiumSsd';
+export type HddDiskPricingRedundancy = 'LRS' | 'ZRS';
+export interface HddOsRetirementCurrentDiskPricing {
+    storageTier: 'standardHdd';
+    skuName: string;
+    pricingRedundancy?: HddDiskPricingRedundancy;
+    sizeGiB: number;
+    monthlyActual: number;
+    monthlyRetail: number;
+}
+export interface HddOsRetirementTargetDiskPricing {
+    storageTier: HddSsdMigrationTargetTier;
+    skuName: string;
+    pricingRedundancy?: HddDiskPricingRedundancy;
+    sizeGiB: number;
+    monthlyRetail: number;
+}
+export interface HddOsRetirementDiskRenderItem {
+    resourceId: string;
+    resourceName: string;
+    resourceType: string;
+    /** Canonical location key used for pricing lookup, e.g. "westus". */
+    pricingLocation?: string;
+    current: HddOsRetirementCurrentDiskPricing;
+    standardSsd: HddOsRetirementTargetDiskPricing & {
+        storageTier: 'standardSsd';
+    };
+    premiumSsd: HddOsRetirementTargetDiskPricing & {
+        storageTier: 'premiumSsd';
+    };
+    defaultSelection?: HddSsdMigrationTargetTier;
+}
+export interface HddOsRetirementRenderStrategyPayload {
+    retirementDate: string;
+    retirementLink: string;
+    currencyCode?: string;
+    currencySymbol?: string;
+    defaultTargetTier?: HddSsdMigrationTargetTier;
+    impactedDiskCount: number;
+    currentMonthlyActual: number;
+    currentMonthlyRetail: number;
+    standardSsdMonthlyRetail: number;
+    premiumSsdMonthlyRetail: number;
+    standardSsdMonthlyDelta: number;
+    premiumSsdMonthlyDelta: number;
+    disks: HddOsRetirementDiskRenderItem[];
+}
+export type RecommendationKnownRenderData = HddOsRetirementRenderStrategyPayload | VmPricePerformanceInsights;
+export type AnyRecommendationRenderData = Record<string, unknown>;
 export interface Recommendation {
+    /** Business identity of a recommendation record (routing/state/sharing/dedupe). */
     id: string;
     name: string;
     category: RecommendationCategory;
+    subCategory?: string;
+    /** custom */
     type?: string;
     description?: string;
     remediation?: string;
@@ -30,28 +202,76 @@ export interface Recommendation {
     potentialBenefits?: string;
     effort?: string;
     effortReason?: string;
+    /** e.g. 10 hours */
+    effortHours?: number;
+    /** Detailed implementation estimates by delivery profile and bulk rollout mode. */
+    effortEstimates?: RecommendationEffortEstimates;
     risk?: string;
     riskReason?: string;
+    /** Could deprecate later */
     costImpact?: number;
     costImpactReason?: string;
-    costImpactDetails?: CostImpactDetails;
+    /*** costImpactDetails is deprecated **/
     performanceImpact?: number;
     performanceImpactReason?: string;
     confidencePercentage?: number;
     confidenceReason?: string;
+    /** array of resources that have this recommendation */
     resources?: ResourceReference[];
+    /** only for security recommendations */
     securityImpactDetails?: SecurityImpact;
-    subcategory?: string;
+    /** whether the recommendation has been resolved or not, eg, Security Assessment is "Healthy" should be true */
+    resolved?: boolean;
+    securityAssessmentStatuses?: SecurityAssessmentStatus[];
+    /** Deprecated fields, kept for compatibility */
     solution?: string;
     source?: string;
     service?: string;
+    /**
+     * Stored as string to allow JSON persistence.
+     * Uses a different name to avoid conflict with RecommendationWithState.createdAt.
+     */
     createdTime?: string;
+    /** Avoids conflict with RecommendationWithState.updatedAt */
     lastUpdatedTime?: string;
+    /** Business story properties */
+    headline: string;
+    bottomLine: string;
+    plainSummary: string;
+    quickSteps: string[];
+    businessOwner: string;
+    keyConstraint: string;
+    validationEvidence: string;
+    /** Technical playbook (only for multi-step implementations) */
+    technicalPlaybook?: string;
+    /** Static recommendation scoring metadata (library-level). */
+    baseScores?: RecommendationBaseScores;
+    overallBaseScore?: number;
+    overallBaseReason?: string;
+    priorityTier?: RecommendationPriorityTier;
+    /** Runtime scoring metadata (per company/tenant). */
+    adjustedScore?: number;
+    objectiveMultiplier?: number;
+    finalScore?: number;
+    /** UI display-only normalized score (0-100). */
+    normalizedScore?: number;
+    /** Cross-feature linkage IDs used for deep links and related views. */
+    linkingIds?: RecommendationLinkingIds;
+    /** Optional UI render payload consumed by recommendation-specific components. */
+    renderData?: RecommendationKnownRenderData | AnyRecommendationRenderData;
+    /** Optional action definition for implement-capable recommendations. */
+    action?: RecommendationActionMetadata;
 }
+export interface RecommendationLinkingIds {
+    serviceRetirementIds?: string[];
+}
+/** Deprecated **/
 export interface CostImpactDetails {
+    /** e.g. "Saving Plan", "Reserved Instance", "Windows migration to Linux" */
     name: string;
     monthlySavings?: number;
     currentSpend?: number;
+    /** e.g. 20 for 20% */
     savingPercentage?: number;
     minMonthlySavings?: number;
     maxMonthlySavings?: number;
@@ -66,6 +286,18 @@ export interface RecommendationSummary {
 export interface RecommendationWithResources {
     recommendation: Recommendation;
     resources: RecommendationResource[];
+    savings?: SavingsPotential;
+}
+/**
+ * Contextual links from one recommendation row to other resources.
+ * Used to model "this disk belongs to that VM" style associations
+ * without changing which resource owns savings totals.
+ */
+export interface RecommendationResourceAssociation {
+    id: string;
+    name?: string;
+    type?: string;
+    relationship?: ResourceRelationship;
 }
 export interface RecommendationResource {
     id: string;
@@ -73,9 +305,19 @@ export interface RecommendationResource {
     type: string;
     spend: number;
     spendAmortized: number;
+    savings?: SavingsPotential;
+    currency?: string;
+    currencySymbol?: string;
+    relationship?: ResourceRelationship;
+    associations?: RecommendationResourceAssociation[];
 }
 export interface RecommendationsView {
     recommendations: RecommendationWithResources[];
+    securityImpactDetails?: SecurityImpact[];
+    subscriptionSecurityStatus?: SubscriptionSecurityStatus;
+    savings?: SavingsPotential;
+    subscription: SubscriptionSummaryLite;
+    costSavingsSummary?: CostSavingsSummary;
 }
 export interface ResourceId {
     id: string;
@@ -83,7 +325,19 @@ export interface ResourceId {
 export interface ResourceReference {
     id: string;
     name: string;
+    type?: string;
+    savings?: SavingsPotential;
+    currency?: string;
+    currencySymbol?: string;
+    relationship?: ResourceRelationship;
+    associations?: RecommendationResourceAssociation[];
 }
+export type ResourceRelationship = {
+    role?: 'primary' | 'related';
+    type?: string;
+    allocationId?: string;
+    metadata?: Record<string, string>;
+};
 export interface ReliabilityRecommendation extends Recommendation {
     referenceID: string;
     resourceType: string;
@@ -91,7 +345,6 @@ export interface ReliabilityRecommendation extends Recommendation {
     service: string;
 }
 export interface CustomAzureRecommendation extends Recommendation {
-    subcategory: string;
     service: string;
     source: string;
     fileName: string;
@@ -101,6 +354,7 @@ export interface RecommendationCollection {
     results: ResourceId[];
 }
 export interface AzureRecommendationLite {
+    /** e.g. Cost, Performance, Reliability, Security, Compliance, OperationalExcellence, Operational Excellence, HighAvailability */
     category: string;
     total: number;
     high: number;
@@ -108,13 +362,18 @@ export interface AzureRecommendationLite {
     low: number;
 }
 export interface RecommendationStats {
+    /** total number of recommendations in the subscription */
     total: number;
+    /** total number of high recommendations in the subscription */
     high: number;
+    /** total number of medium recommendations in the subscription */
     medium: number;
+    /** total number of low recommendations in the subscription */
     low: number;
 }
+/** Recommendation with state information, name "ExtendedRecommendation" in the portal at the moment */
 export interface RecommendationWithState extends Recommendation {
-    status?: 'Active' | 'Prioritized' | 'Postponed' | 'Dismissed' | 'Completed' | 'Archived';
+    status?: 'Active' | 'Prioritized' | 'Postponed' | 'Dismissed' | 'Completed' | 'Archived' | 'Implementing' | 'Implemented' | 'Failed';
     read?: boolean;
     scheduledAt?: Date;
     createdAt?: Date;
@@ -123,4 +382,177 @@ export interface RecommendationWithState extends Recommendation {
     comments?: Comment[];
     history?: RecommendationHistory[];
 }
+export interface DismissRecommendationRequest extends RecommendationActionRequest {
+    dismissReason: string;
+}
+export interface ShareRecommendationRequest extends RecommendationActionRequest {
+    shareType: 'email' | 'slack' | 'teams' | 'jira' | 'halo' | 'connectwise';
+    email?: string;
+    halo?: HaloRoutingOverrides;
+    connectwise?: ConnectWiseRoutingFields;
+}
+export interface RecommendationActionRequest extends ProviderScope {
+    /** `providerScope` maps to subscription identity for Azure providers. */
+    scope?: CommentScope;
+    /** Optional cloud-account identity enriched by trusted server-side callers before queue publish. */
+    cloudAccountId?: string;
+    /** Optional user-provided reason for queue-backed actions such as implement. */
+    reason?: string;
+    recommendationId: string;
+    recommendationTitle?: string;
+    resourceIds: string[];
+    resourceGroupName?: string;
+    companyId: string;
+    byUserId?: string;
+    byUserDisplayName?: string;
+}
+export interface RecommendationActionResponse {
+    success: boolean;
+    message?: string;
+    affectedResources?: string[];
+    eventId?: string;
+}
+export interface ServiceRetirementRecommendation {
+    Id: string;
+    ServiceName: string;
+    RetiringFeature: string;
+    RetirementDate: string;
+    Link: string;
+    effort: string;
+    effortHours: number;
+    effortReason: string;
+    risk: string;
+    riskReason: string;
+    considerations: string;
+    confidencePercentage: number;
+    confidenceReason: string;
+    lastProcessedAt: string;
+    /** Related recommendation IDs for cross-navigation from retirement tracker. */
+    linkedRecommendationIds?: string[];
+}
+export interface JiraShareDetails {
+    projectKey?: string;
+    epicKey?: string;
+    label?: string;
+}
+export interface JiraIntegrationRequestBase {
+    siteUrl: string;
+    email: string;
+    secret?: string;
+    useStoredSecret?: boolean;
+}
+export interface JiraIntegrationTestPayload extends JiraIntegrationRequestBase {
+    projectKey?: string;
+}
+export interface JiraIntegrationEpicsPayload extends JiraIntegrationRequestBase {
+    projectKey: string;
+    maxResults?: number;
+}
+export interface JiraIntegrationProjectsPayload extends JiraIntegrationRequestBase {
+    maxResults?: number;
+}
+export interface JiraIntegrationLabelsPayload extends JiraIntegrationRequestBase {
+    projectKey: string;
+    maxResults?: number;
+    searchQuery?: string;
+}
+export interface JiraEntity {
+    id: string;
+    key: string;
+    name: string;
+}
+export interface JiraLabel {
+    name: string;
+}
+export interface ConnectWiseIntegrationRequestBase {
+    siteUrl: string;
+    companyId: string;
+    publicKey: string;
+    secret?: string;
+    useStoredSecret?: boolean;
+    credentialOwnerCompanyId?: string;
+}
+export type ConnectWiseId = string | number;
+export interface ConnectWiseRoutingFields {
+    boardId?: ConnectWiseId;
+    boardName?: string;
+    statusId?: ConnectWiseId;
+    statusName?: string;
+    customerId?: ConnectWiseId;
+    customerName?: string;
+    projectId?: ConnectWiseId;
+    projectName?: string;
+    typeId?: ConnectWiseId;
+    typeName?: string;
+    subTypeId?: ConnectWiseId;
+    subTypeName?: string;
+    itemId?: ConnectWiseId;
+    itemName?: string;
+    priorityId?: ConnectWiseId;
+    priorityName?: string;
+    contactId?: ConnectWiseId;
+    contactName?: string;
+    agreementId?: ConnectWiseId;
+    agreementName?: string;
+    slaId?: ConnectWiseId;
+    slaName?: string;
+    source?: string;
+}
+export interface ConnectWiseIntegrationTestPayload extends ConnectWiseIntegrationRequestBase, ConnectWiseRoutingFields {
+}
+export type ConnectWiseBoardsPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseCompaniesPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseProjectsPayload = ConnectWiseIntegrationRequestBase;
+export interface ConnectWiseStatusesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWiseTypesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWiseSubTypesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+    typeId?: string;
+    typeName?: string;
+}
+export interface ConnectWiseItemsPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+    typeId?: string;
+    typeName?: string;
+    subTypeId?: string;
+    subTypeName?: string;
+}
+export interface ConnectWiseTypeSubTypeItemAssociationsPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWisePrioritiesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWiseContactsPayload extends ConnectWiseIntegrationRequestBase {
+    searchQuery?: string;
+}
+export type ConnectWiseSourcesPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseAgreementsPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseSlasPayload = ConnectWiseIntegrationRequestBase;
+export interface ConnectWiseEntity {
+    id: string | number;
+    name: string;
+}
+export interface ConnectWiseTypeSubTypeItemAssociation {
+    type?: ConnectWiseEntity;
+    subType?: ConnectWiseEntity;
+    item?: ConnectWiseEntity;
+}
+export interface ConnectWiseContact extends ConnectWiseEntity {
+    email?: string;
+}
+export interface ConnectWiseTicketMetadata extends ConnectWiseRoutingFields {
+    ticketId: ConnectWiseId;
+    ticketUrl?: string;
+}
 //# sourceMappingURL=recommendations.d.ts.map