@spottoai/types-package 1.0.2-beta.32 → 1.0.2-beta.321

package/dist/azure/recommendationWorkflow.d.ts

@@ -0,0 +1,181 @@
+import type { ProviderName, ProviderScope } from '../common/provider';
+import type { SystemTrackCardGranularity, SystemTrackId } from './recommendationTracks';
+export declare const RecommendationWorkflowLanes: {
+    readonly prioritized: "prioritized";
+    readonly todo: "todo";
+    readonly inProgress: "in-progress";
+    readonly blocked: "blocked";
+    readonly completed: "completed";
+};
+export type RecommendationWorkflowLane = (typeof RecommendationWorkflowLanes)[keyof typeof RecommendationWorkflowLanes];
+export type RecommendationWorkflowNonBlockedLane = Exclude<RecommendationWorkflowLane, 'blocked'>;
+export declare const RecommendationWorkflowSelectionModes: {
+    readonly allAffected: "all-affected";
+    readonly selectedSubset: "selected-subset";
+    readonly subscriptionWide: "subscription-wide";
+};
+export type RecommendationWorkflowSelectionMode = (typeof RecommendationWorkflowSelectionModes)[keyof typeof RecommendationWorkflowSelectionModes];
+export type RecommendationWorkflowCategory = 'Cost' | 'Performance' | 'Security' | 'Compliance' | 'Reliability' | 'Operational Excellence';
+export type RecommendationWorkflowImpact = 'High' | 'Medium' | 'Low';
+export type RecommendationWorkflowEffort = 'High' | 'Medium' | 'Low';
+export interface RecommendationWorkflowSavingsSnapshot {
+    minAmount?: number;
+    maxAmount?: number;
+    currencyCode?: string;
+    currencySymbol?: string;
+}
+/**
+ * Lightweight card-level snapshot persisted with a workflow item so board cards
+ * can still render when the source recommendation is no longer in the active feed.
+ */
+export interface RecommendationWorkflowSnapshot {
+    title: string;
+    category: RecommendationWorkflowCategory;
+    impact: RecommendationWorkflowImpact;
+    effort: RecommendationWorkflowEffort;
+    subscriptionName?: string;
+    savings?: RecommendationWorkflowSavingsSnapshot | null;
+    updatedAt: string;
+}
+/**
+ * Canonical board-item identity:
+ * company + provider + providerScopeId + recommendationId.
+ */
+export interface RecommendationWorkflowIdentity extends ProviderScope {
+    companyId: string;
+    recommendationId: string;
+}
+interface RecommendationWorkflowItemBase extends RecommendationWorkflowIdentity {
+    /** Stable workflow row identifier used by route params in update endpoints. */
+    flowItemId: string;
+    /**
+     * Deprecated alias retained for compatibility with consumers that still map
+     * provider scope to subscription vocabulary.
+     */
+    subscriptionId?: string;
+    /** Numeric order value within a lane. */
+    laneOrder: number;
+    /** Optional user-defined horizontal swimlane. Absence means Unassigned or the originating system track. */
+    swimLaneId?: string;
+    /** Number of resources currently affected by the recommendation. */
+    affectedResourceCount: number;
+    /** Number of resources explicitly tracked for workflow execution. */
+    trackedResourceCount: number;
+    snapshot: RecommendationWorkflowSnapshot;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    /** Opaque compare-and-set token supplied by the API for guarded mutations. */
+    concurrencyToken?: string;
+    /** Originating system track for touched Spotto suggestions. */
+    systemTrackId?: SystemTrackId;
+    origin?: 'manual' | 'system-track';
+    sourceCardGranularity?: SystemTrackCardGranularity;
+    sourceFingerprint?: string;
+    sourceChangedAt?: string;
+    sourceChangeKind?: 'changed' | 'detected-again';
+}
+interface RecommendationWorkflowAllAffectedSelection {
+    selectionMode: 'all-affected';
+    selectedResourceIds?: never;
+}
+interface RecommendationWorkflowSelectedSubsetSelection {
+    selectionMode: 'selected-subset';
+    selectedResourceIds: [string, ...string[]];
+}
+interface RecommendationWorkflowSubscriptionWideSelection {
+    selectionMode: 'subscription-wide';
+    selectedResourceIds?: never;
+}
+export interface RecommendationWorkflowNonBlockedLaneState {
+    lane: RecommendationWorkflowNonBlockedLane;
+    blockedAt?: never;
+    blockedBy?: never;
+    blockedReason?: never;
+    reviewAt?: never;
+}
+export interface RecommendationWorkflowBlockedLaneState {
+    lane: 'blocked';
+    blockedAt: string;
+    blockedBy: string;
+    blockedReason: string;
+    reviewAt?: string;
+}
+export type RecommendationWorkflowLaneState = RecommendationWorkflowNonBlockedLaneState | RecommendationWorkflowBlockedLaneState;
+export type RecommendationWorkflowAllAffectedItem = RecommendationWorkflowItemBase & RecommendationWorkflowAllAffectedSelection & RecommendationWorkflowLaneState;
+export type RecommendationWorkflowSelectedSubsetItem = RecommendationWorkflowItemBase & RecommendationWorkflowSelectedSubsetSelection & RecommendationWorkflowLaneState;
+export type RecommendationWorkflowSubscriptionWideItem = RecommendationWorkflowItemBase & RecommendationWorkflowSubscriptionWideSelection & RecommendationWorkflowLaneState;
+export type RecommendationWorkflowItem = RecommendationWorkflowAllAffectedItem | RecommendationWorkflowSelectedSubsetItem | RecommendationWorkflowSubscriptionWideItem;
+export interface GetRecommendationWorkflowItemsQuery {
+    providerName: ProviderName;
+    companyId: string;
+    providerScopeIds?: string[];
+    lanes?: RecommendationWorkflowLane[];
+    swimLaneIds?: string[];
+    categories?: RecommendationWorkflowCategory[];
+    search?: string;
+    limit?: number;
+}
+export type GetRecommendationWorkflowItemsResponse = RecommendationWorkflowItem[];
+interface RecommendationWorkflowLaneMutationBase {
+    laneOrder: number;
+}
+export interface RecommendationWorkflowNonBlockedLaneMutation extends RecommendationWorkflowLaneMutationBase {
+    lane: RecommendationWorkflowNonBlockedLane;
+    blockedReason?: never;
+    reviewAt?: never;
+}
+export interface RecommendationWorkflowBlockedLaneMutation extends RecommendationWorkflowLaneMutationBase {
+    lane: 'blocked';
+    blockedReason: string;
+    reviewAt?: string;
+}
+export type UpdateRecommendationWorkflowLaneRequest = RecommendationWorkflowNonBlockedLaneMutation | RecommendationWorkflowBlockedLaneMutation;
+export type PatchRecommendationWorkflowItemLaneRequest = UpdateRecommendationWorkflowLaneRequest & {
+    updatedAt?: string;
+    swimLaneId?: string | null;
+    concurrencyToken?: string;
+};
+export type RecommendationWorkflowLaneBatchUpdateItem = RecommendationWorkflowIdentity & PatchRecommendationWorkflowItemLaneRequest & {
+    flowItemId?: string;
+};
+interface RecommendationWorkflowUpsertBase extends RecommendationWorkflowIdentity {
+    laneOrder: number;
+    swimLaneId?: string | null;
+    affectedResourceCount: number;
+    trackedResourceCount?: number;
+    snapshot: RecommendationWorkflowSnapshot;
+    systemTrackId?: SystemTrackId;
+    origin?: 'manual' | 'system-track';
+    sourceCardGranularity?: SystemTrackCardGranularity;
+    sourceFingerprint?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    concurrencyToken?: string;
+}
+type RecommendationWorkflowSelectionMutation = RecommendationWorkflowAllAffectedSelection | RecommendationWorkflowSelectedSubsetSelection | RecommendationWorkflowSubscriptionWideSelection;
+export type UpsertRecommendationWorkflowItemRequest = RecommendationWorkflowUpsertBase & RecommendationWorkflowSelectionMutation & UpdateRecommendationWorkflowLaneRequest;
+export interface BatchUpdateRecommendationWorkflowLanesRequest {
+    providerName: ProviderName;
+    companyId: string;
+    updates: RecommendationWorkflowLaneBatchUpdateItem[];
+}
+export interface UpdateRecommendationWorkflowLaneResponse {
+    success: true;
+    item: RecommendationWorkflowItem;
+}
+export interface RecommendationWorkflowConcurrencyConflictResponse {
+    success: false;
+    status: 409 | 412;
+    errorCode: 'recommendation-workflow-conflict';
+    message: string;
+    currentItem: RecommendationWorkflowItem;
+}
+export interface DeleteRecommendationWorkflowItemRequest {
+    providerName: ProviderName;
+    companyId: string;
+    flowItemId: string;
+    concurrencyToken?: string;
+}
+export {};
+//# sourceMappingURL=recommendationWorkflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recommendationWorkflow.d.ts","sourceRoot":"","sources":["../../src/azure/recommendationWorkflow.ts"],"names":[],"mappings":"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"}

package/dist/azure/recommendationWorkflow.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecommendationWorkflowSelectionModes = exports.RecommendationWorkflowLanes = void 0;
+exports.RecommendationWorkflowLanes = {
+    prioritized: 'prioritized',
+    todo: 'todo',
+    inProgress: 'in-progress',
+    blocked: 'blocked',
+    completed: 'completed',
+};
+exports.RecommendationWorkflowSelectionModes = {
+    allAffected: 'all-affected',
+    selectedSubset: 'selected-subset',
+    subscriptionWide: 'subscription-wide',
+};
+//# sourceMappingURL=recommendationWorkflow.js.map

package/dist/azure/recommendationWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendationWorkflow.js","sourceRoot":"","sources":["../../src/azure/recommendationWorkflow.ts"],"names":[],"mappings":";;;AAGa,QAAA,2BAA2B,GAAG;IACzC,WAAW,EAAE,aAAa;IAC1B,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,aAAa;IACzB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAME,QAAA,oCAAoC,GAAG;IAClD,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,iBAAiB;IACjC,gBAAgB,EAAE,mBAAmB;CAC7B,CAAC"}