@spottoai/types-package 1.0.2-beta.169 → 1.0.2-beta.170

package/dist/azure/recommendationAudit.d.ts

@@ -0,0 +1,111 @@
+import type { ProviderName, ProviderScope } from '../common/provider';
+export declare const RecommendationAuditRowKinds: {
+    readonly resourceTarget: "resource-view:target";
+    readonly subscriptionTarget: "scope-view:target";
+    readonly resourceProviderScopeFeed: "resource-view:providerScope-feed";
+    readonly subscriptionProviderScopeFeed: "scope-view:providerScope-feed";
+};
+export type RecommendationAuditRowKind = (typeof RecommendationAuditRowKinds)[keyof typeof RecommendationAuditRowKinds];
+export type RecommendationAuditScope = 'resource' | 'subscription';
+export type RecommendationAuditView = 'target' | 'providerScope-feed';
+export interface RecommendationAuditQueryBase extends ProviderScope {
+    /**
+     * ISO timestamp lower bound (inclusive).
+     * Omit to let consumers default to the contract-defined lookback window.
+     */
+    from?: string;
+    /**
+     * ISO timestamp upper bound (exclusive).
+     * Omit to let consumers default to "now".
+     */
+    to?: string;
+    /** Optional max rows to return (service-level cap still applies). */
+    limit?: number;
+    /**
+     * Read-time request hint to append a `Viewed` audit event.
+     * Services must suppress `Viewed` persistence for global `reader` and `admin`
+     * actors, even when `trackView` is `true`.
+     */
+    trackView?: boolean;
+}
+export type ResourceTargetRecommendationAuditQuery = RecommendationAuditQueryBase & {
+    scope: 'resource';
+    view: 'target';
+    recommendationId: string;
+    resourceId: string;
+};
+export type SubscriptionTargetRecommendationAuditQuery = RecommendationAuditQueryBase & {
+    scope: 'subscription';
+    view: 'target';
+    recommendationId: string;
+    resourceId?: never;
+};
+export type ResourceProviderScopeFeedRecommendationAuditQuery = RecommendationAuditQueryBase & {
+    scope: 'resource';
+    view: 'providerScope-feed';
+    recommendationId?: string;
+    resourceId?: never;
+};
+export type SubscriptionProviderScopeFeedRecommendationAuditQuery = RecommendationAuditQueryBase & {
+    scope: 'subscription';
+    view: 'providerScope-feed';
+    recommendationId?: string;
+    resourceId?: never;
+};
+export type GetRecommendationAuditQueryCanonical = ResourceTargetRecommendationAuditQuery | SubscriptionTargetRecommendationAuditQuery | ResourceProviderScopeFeedRecommendationAuditQuery | SubscriptionProviderScopeFeedRecommendationAuditQuery;
+export type GetRecommendationAuditQuery = GetRecommendationAuditQueryCanonical;
+export type RecommendationAuditEventType = 'Viewed' | 'Added' | 'CommentAdded' | 'CommentUpdated' | 'CommentDeleted' | 'CommentPinned' | 'CommentUnpinned' | 'Shared' | 'Dismissed' | 'Restored' | 'Prioritized' | 'Unprioritized' | 'Implemented';
+/** Flat recommendation audit row columns as persisted in `recommendationsevents`. */
+export interface RecommendationAuditEventRowColumns {
+    CompanyId: string;
+    ProviderName: ProviderName;
+    ProviderScopeId: string;
+    /** For Azure providers, mirrors `ProviderScopeId` (subscription id). */
+    SubscriptionId: string;
+    ResourceId?: string | null;
+    RecommendationId: string;
+    EventType: RecommendationAuditEventType;
+    /** Stringified compact action metadata payload. */
+    EventDetails?: string;
+    UserId: string;
+    /**
+     * Optional actor display name.
+     * May be missing/null for legacy rows or when identity enrichment is unavailable.
+     */
+    UserDisplayName?: string | null;
+    Source: string;
+    /** ISO timestamp for event creation. */
+    Date: string;
+    EventId: string;
+}
+export interface RecommendationAuditEventRow extends RecommendationAuditEventRowColumns {
+    PartitionKey: string;
+    RowKey: string;
+}
+/** Timeline-friendly response event DTO. */
+export interface RecommendationAuditTimelineEvent {
+    eventId: string;
+    eventType: RecommendationAuditEventType;
+    date: string;
+    companyId: string;
+    providerName: ProviderName;
+    providerScopeId: string;
+    subscriptionId: string;
+    resourceId?: string | null;
+    recommendationId: string;
+    eventDetails?: string;
+    userId: string;
+    /**
+     * Optional actor display name.
+     * API may omit this when upstream rows do not contain `UserDisplayName`.
+     */
+    userDisplayName?: string | null;
+    source: string;
+    rowKind: RecommendationAuditRowKind;
+}
+/**
+ * Canonical API response contract for recommendation audit reads.
+ * The service returns a raw event array.
+ */
+export type RecommendationAuditQueryResponse = RecommendationAuditTimelineEvent[];
+//# sourceMappingURL=recommendationAudit.d.ts.map

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

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

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/index.d.ts

@@ -10,6 +10,7 @@ export * from './azure/payloads';
 export * from './azure/prices';
 export * from './azure/relationships';
 export * from './azure/recommendations';
+export * from './azure/recommendationAudit';
 export * from './azure/recommendationState';
 export * from './azure/resources';
 export * from './azure/reports';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./azure/payloads"), exports);
 __exportStar(require("./azure/prices"), exports);
 __exportStar(require("./azure/relationships"), exports);
 __exportStar(require("./azure/recommendations"), exports);
+__exportStar(require("./azure/recommendationAudit"), exports);
 __exportStar(require("./azure/recommendationState"), exports);
 __exportStar(require("./azure/resources"), exports);
 __exportStar(require("./azure/reports"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAAiE;AACjE,iDAA+B;AAC/B,kDAAgC;AAChC,uDAAqC;AACrC,mDAAiC;AACjC,8DAA4C;AAC5C,kDAAgC;AAChC,kDAAgC;AAChC,mDAAiC;AACjC,iDAA+B;AAC/B,wDAAsC;AACtC,0DAAwC;AACxC,8DAA4C;AAC5C,oDAAkC;AAClC,kDAAgC;AAChC,0DAAwC;AACxC,wDAAsC;AACtC,gDAA8B;AAC9B,mDAAiC;AACjC,4DAA0C;AAC1C,iEAA+C;AAC/C,yDAAuC;AACvC,4DAA0C;AAC1C,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,uCAAqB;AACrB,2CAAyB;AACzB,iDAA+B;AAC/B,6CAA2B;AAC3B,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAAiE;AACjE,iDAA+B;AAC/B,kDAAgC;AAChC,uDAAqC;AACrC,mDAAiC;AACjC,8DAA4C;AAC5C,kDAAgC;AAChC,kDAAgC;AAChC,mDAAiC;AACjC,iDAA+B;AAC/B,wDAAsC;AACtC,0DAAwC;AACxC,8DAA4C;AAC5C,8DAA4C;AAC5C,oDAAkC;AAClC,kDAAgC;AAChC,0DAAwC;AACxC,wDAAsC;AACtC,gDAA8B;AAC9B,mDAAiC;AACjC,4DAA0C;AAC1C,iEAA+C;AAC/C,yDAAuC;AACvC,4DAA0C;AAC1C,6CAA2B;AAC3B,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,uCAAqB;AACrB,2CAAyB;AACzB,iDAA+B;AAC/B,6CAA2B;AAC3B,yCAAuB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spottoai/types-package",
-  "version": "1.0.2-beta.169",
+  "version": "1.0.2-beta.170",
   "description": "Shared TypeScript interfaces for SpottoAI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",