@harnessio/react-ccm-optimization-service-client 0.2.0 → 0.3.0

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicy.d.ts

@@ -0,0 +1,53 @@
+import type { AiGovernancePolicyDocument } from '../schemas/AiGovernancePolicyDocument';
+export interface AiGovernancePolicy {
+    accountId?: string;
+    /**
+     * @format date-time
+     */
+    createdAt?: string;
+    createdBy?: string;
+    document?: AiGovernancePolicyDocument;
+    /**
+     * @format uuid
+     */
+    id?: string;
+    name?: string;
+    /**
+     * Count of pending cap-raise approval requests for this policy. Present on list responses only.
+     */
+    pendingUpgradeRequests?: number;
+    /**
+     * Original YAML upload when the policy was created or last updated via rawYaml. Empty when the JSON policy path was used; document is always authoritative.
+     */
+    rawYaml?: string;
+    /**
+     * Total current-period spend across governed subjects for budget-cap rules on this policy. Present on list responses only.
+     */
+    rolledUpSpend?: number;
+    /**
+     * Total number of unique governed subjects across budget-cap rules on this policy. Present on list responses only.
+     */
+    totalUsers?: number;
+    /**
+     * @format date-time
+     */
+    updatedAt?: string;
+    updatedBy?: string;
+    /**
+     * Counts of governed subjects by budget utilization band. Present on list responses only.
+     */
+    userHealth?: {
+        /**
+         * Subjects at or above the at-risk threshold but below budget
+         */
+        atRisk?: number;
+        /**
+         * Subjects below the at-risk spend threshold
+         */
+        good?: number;
+        /**
+         * Subjects at or above 100% of their effective budget ceiling
+         */
+        overBudget?: number;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicy.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyAuthoring.d.ts

@@ -0,0 +1,18 @@
+export interface AiGovernancePolicyAuthoring {
+    /**
+     * Lowercase slug policy name
+     */
+    name: string;
+    /**
+     * Governance rules with flat type-specific fields (same shape as YAML rules)
+     */
+    rules: Array<{
+        [key: string]: any;
+    }>;
+    /**
+     * Policy-level subject selectors
+     */
+    subjects: {
+        [key: string]: any;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyAuthoring.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDetails.d.ts

@@ -0,0 +1,8 @@
+import type { AiGovernancePolicyOverviewMetrics } from '../schemas/AiGovernancePolicyOverviewMetrics';
+export interface AiGovernancePolicyDetails extends AiGovernancePolicyOverviewMetrics {
+    /**
+     * @format uuid
+     */
+    policyId?: string;
+    policyName?: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDetails.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDetailsResponse.d.ts

@@ -0,0 +1,4 @@
+import type { AiGovernancePolicyDetails } from '../schemas/AiGovernancePolicyDetails';
+export interface AiGovernancePolicyDetailsResponse {
+    response: AiGovernancePolicyDetails;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDetailsResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDocument.d.ts

@@ -0,0 +1,22 @@
+export interface AiGovernancePolicyDocument {
+    /**
+     * Persisted rules with platform-assigned ruleIds
+     */
+    rules?: Array<{
+        connectors?: Array<{
+            [key: string]: any;
+        }>;
+        frequency?: string;
+        /**
+         * @format uuid
+         */
+        ruleId?: string;
+        type?: string;
+    }>;
+    /**
+     * Policy-level subject selectors
+     */
+    subjects?: {
+        [key: string]: any;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDocument.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyListItem.d.ts

@@ -0,0 +1,21 @@
+import type { AiGovernancePolicyDocument } from '../schemas/AiGovernancePolicyDocument';
+import type { AiGovernancePolicyOverviewMetrics } from '../schemas/AiGovernancePolicyOverviewMetrics';
+export interface AiGovernancePolicyListItem extends AiGovernancePolicyOverviewMetrics {
+    accountId?: string;
+    /**
+     * @format date-time
+     */
+    createdAt?: string;
+    createdBy?: string;
+    document?: AiGovernancePolicyDocument;
+    /**
+     * @format uuid
+     */
+    id?: string;
+    name?: string;
+    /**
+     * @format date-time
+     */
+    updatedAt?: string;
+    updatedBy?: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyListItem.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyListRequest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Pagination request for listing governance policies
+ */
+export interface AiGovernancePolicyListRequest {
+    filters?: Array<{
+        [key: string]: any;
+    }>;
+    /**
+     * Number of records per page (max 100)
+     * @default 10
+     * @example 10
+     */
+    limit?: number;
+    /**
+     * Page number (1-indexed)
+     * @default 1
+     * @example 1
+     */
+    page?: number;
+    /**
+     * Sorting options
+     */
+    sort?: {
+        /**
+         * @example "name"
+         */
+        field?: 'created_at' | 'name' | 'updated_at';
+        /**
+         * @example "DESC"
+         */
+        type?: 'ASC' | 'DESC';
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyListRequest.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyListResponse.d.ts

@@ -0,0 +1,14 @@
+import type { AiGovernancePolicyListItem } from '../schemas/AiGovernancePolicyListItem';
+export interface AiGovernancePolicyListResponse {
+    response: {
+        items: AiGovernancePolicyListItem[];
+        /**
+         * Total number of pages
+         */
+        pages: number;
+        /**
+         * Total number of policies matching the criteria
+         */
+        total: number;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyListResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyOverviewMetrics.d.ts

@@ -0,0 +1,42 @@
+import type { AiGovernancePolicyUserHealth } from '../schemas/AiGovernancePolicyUserHealth';
+/**
+ * Overview metrics shared by policy list items and the single-policy overview response. Spend fields are populated only after dry-run or reconcile writes the per-policy stats cache.
+ */
+export interface AiGovernancePolicyOverviewMetrics {
+    /**
+     * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
+     */
+    cumulativeSpend?: number | null;
+    pendingRequestsCount: number;
+    period?: {
+        period?: string;
+        range?: {
+            /**
+             * @format date-time
+             */
+            end?: string;
+            /**
+             * @format date-time
+             */
+            start?: string;
+        };
+    };
+    /**
+     * 1-indexed day within the current budget period
+     */
+    periodDay: number;
+    /**
+     * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
+     */
+    spendPercent?: number | null;
+    /**
+     * Total effective budget ceiling for the current policy period across all budget-cap rules
+     */
+    totalPeriodBudget: number;
+    totalSubjects: number;
+    /**
+     * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
+     */
+    userHealth?: AiGovernancePolicyUserHealth | null;
+    warnings?: string[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyOverviewMetrics.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyResponse.d.ts

@@ -0,0 +1,4 @@
+import type { AiGovernancePolicy } from '../schemas/AiGovernancePolicy';
+export interface AiGovernancePolicyResponse {
+    response: AiGovernancePolicy;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySubjectRow.d.ts

@@ -0,0 +1,24 @@
+import type { AiGovernanceApprovalRequestView } from '../schemas/AiGovernanceApprovalRequestView';
+export interface AiGovernancePolicySubjectRow {
+    /**
+     * Effective budget ceiling after active overrides
+     */
+    budget: number;
+    /**
+     * Subject email
+     */
+    email: string;
+    pendingRequest?: AiGovernanceApprovalRequestView;
+    /**
+     * Current-period spend for the primary budget-cap rule
+     */
+    spendAmount: number;
+    /**
+     * Spend as a percentage of effective budget
+     */
+    spendPercent: number;
+    /**
+     * Budget utilization band for the subject
+     */
+    status: 'atRisk' | 'good' | 'overBudget';
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySubjectRow.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySubjectsRequest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pagination and filter request for listing governed subjects on a policy
+ */
+export interface AiGovernancePolicySubjectsRequest {
+    /**
+     * all returns every mapped subject; pending_requests returns only subjects with an open budget raise request
+     * @default "all"
+     */
+    filter?: 'all' | 'pending_requests';
+    /**
+     * Number of records per page (max 100)
+     * @default 10
+     * @example 10
+     */
+    limit?: number;
+    /**
+     * Page number (1-indexed)
+     * @default 1
+     * @example 1
+     */
+    page?: number;
+    /**
+     * Optional search string matched against subject email
+     */
+    query?: string;
+    /**
+     * Sorting options
+     */
+    sort?: {
+        /**
+         * @example "email"
+         */
+        field?: 'email';
+        /**
+         * @example "ASC"
+         */
+        type?: 'ASC' | 'DESC';
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySubjectsRequest.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySubjectsResponse.d.ts

@@ -0,0 +1,14 @@
+import type { AiGovernancePolicySubjectRow } from '../schemas/AiGovernancePolicySubjectRow';
+export interface AiGovernancePolicySubjectsResponse {
+    response: {
+        items: AiGovernancePolicySubjectRow[];
+        /**
+         * Total number of pages
+         */
+        pages: number;
+        /**
+         * Total number of mapped subjects matching the filter
+         */
+        total: number;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySubjectsResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyUpsertRequest.d.ts

@@ -0,0 +1,11 @@
+import type { AiGovernancePolicyAuthoring } from '../schemas/AiGovernancePolicyAuthoring';
+/**
+ * Provide either rawYaml or policy (not both required in schema, but one must be supplied at runtime).
+ */
+export interface AiGovernancePolicyUpsertRequest {
+    policy?: AiGovernancePolicyAuthoring;
+    /**
+     * Full governance policy YAML document with exactly one policy entry containing subjects and rules
+     */
+    rawYaml?: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyUpsertRequest.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyUserHealth.d.ts

@@ -0,0 +1,5 @@
+export interface AiGovernancePolicyUserHealth {
+    atRisk?: number;
+    good?: number;
+    overBudget?: number;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyUserHealth.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverrideItem.d.ts

@@ -0,0 +1,11 @@
+export interface AiGovernanceReviewOverrideItem {
+    action: 'approve' | 'reject';
+    /**
+     * Optional approved ceiling in USD dollars when action is approve; the caller must be authorized for this amount on the pending tier
+     */
+    approved_amount?: number;
+    /**
+     * @format uuid
+     */
+    request_id: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverrideItem.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverrideOutcome.d.ts

@@ -0,0 +1,10 @@
+import type { AiGovernanceApprovalRequest } from '../schemas/AiGovernanceApprovalRequest';
+export interface AiGovernanceReviewOverrideOutcome {
+    message?: string;
+    request?: AiGovernanceApprovalRequest;
+    /**
+     * @format uuid
+     */
+    requestId: string;
+    success: boolean;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverrideOutcome.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverridesRequest.d.ts

@@ -0,0 +1,4 @@
+import type { AiGovernanceReviewOverrideItem } from '../schemas/AiGovernanceReviewOverrideItem';
+export interface AiGovernanceReviewOverridesRequest {
+    items: AiGovernanceReviewOverrideItem[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverridesRequest.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverridesResponse.d.ts

@@ -0,0 +1,12 @@
+import type { AiGovernanceReviewOverridesResult } from '../schemas/AiGovernanceReviewOverridesResult';
+export interface AiGovernanceReviewOverridesResponse {
+    code?: string;
+    errors?: string[];
+    response?: AiGovernanceReviewOverridesResult;
+    success?: boolean;
+    /**
+     * Unix milliseconds timestamp
+     * @format int64
+     */
+    ts?: number;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverridesResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverridesResult.d.ts

@@ -0,0 +1,4 @@
+import type { AiGovernanceReviewOverrideOutcome } from '../schemas/AiGovernanceReviewOverrideOutcome';
+export interface AiGovernanceReviewOverridesResult {
+    results: AiGovernanceReviewOverrideOutcome[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceReviewOverridesResult.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetRow.d.ts

@@ -0,0 +1,48 @@
+import type { AiGovernanceConnectorRef } from '../schemas/AiGovernanceConnectorRef';
+export interface AiGovernanceUserBudgetRow {
+    /**
+     * Budget ceiling from policy YAML, in USD dollars
+     */
+    authoredAmount: number;
+    authoredConnectors: AiGovernanceConnectorRef[];
+    /**
+     * Effective ceiling after active overrides (same as authored until Phase 1b overrides land)
+     */
+    effectiveAmount: number;
+    mode: 'per-subject' | 'pooled';
+    period: 'custom' | 'monthly' | 'quarterly' | 'weekly';
+    /**
+     * Omitted when the budget period is unsupported for spend lookup
+     * @format date-time
+     */
+    periodEnd?: string;
+    /**
+     * Omitted when the budget period is unsupported for spend lookup
+     * @format date-time
+     */
+    periodStart?: string;
+    /**
+     * @format uuid
+     */
+    policyId: string;
+    policyName: string;
+    resolvedConnectors: AiGovernanceConnectorRef[];
+    /**
+     * @format uuid
+     */
+    ruleId: string;
+    /**
+     * Current-period spend in USD cents from attribution
+     * @format int64
+     */
+    spendCents: number;
+    /**
+     * Spend as a percentage of the effective ceiling
+     */
+    spendPercent?: number;
+    /**
+     * Latest governance enforcement state when a record exists
+     */
+    state?: 'enforced' | 'normal' | 'reverted';
+    warnings?: string[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetRow.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgets.d.ts

@@ -0,0 +1,12 @@
+import type { AiGovernanceUserBudgetRow } from '../schemas/AiGovernanceUserBudgetRow';
+export interface AiGovernanceUserBudgets {
+    budgets: AiGovernanceUserBudgetRow[];
+    /**
+     * Canonical subject identifier for the logged-in user (typically email when available)
+     */
+    subjectId: string;
+    /**
+     * Account-level warnings (e.g. policies skipped because usage-derived subjects are not supported for budget visibility)
+     */
+    warnings?: string[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgets.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetsResponse.d.ts

@@ -0,0 +1,4 @@
+import type { AiGovernanceUserBudgets } from '../schemas/AiGovernanceUserBudgets';
+export interface AiGovernanceUserBudgetsResponse {
+    response: AiGovernanceUserBudgets;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetsResponse.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harnessio/react-ccm-optimization-service-client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Harness CCM Optimization Service APIs integrated with react hooks",
   "author": "Harness Inc",
   "license": "MIT",