@spottoai/types-package 1.0.2-beta.43 → 1.0.2-beta.430

package/dist/esm/scheduler/weeklyAvailabilityFixtures.js

@@ -0,0 +1,140 @@
+const rule = (ruleId, daysOfWeek, desiredStateAtLocal, transition) => ({ ruleId, daysOfWeek, desiredStateAtLocal, transition });
+const fixtures = [
+    {
+        caseId: 'business-hours',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [1, 2, 3, 4, 5].map(day => ({
+            periodKey: `weekday-${day}`,
+            start: { dayOfWeek: day, timeLocal: '08:00' },
+            end: { dayOfWeek: day, timeLocal: '18:00' },
+        })),
+        expectedRules: [rule('weekday-restore', [1, 2, 3, 4, 5], '08:00', 'restore'), rule('weekday-reduce', [1, 2, 3, 4, 5], '18:00', 'reduce')],
+        stateSamples: [
+            { instantUtc: '2026-09-13T19:59:59.999Z', expectedState: 'reduced' },
+            { instantUtc: '2026-09-13T20:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-14T06:00:00.000Z', expectedState: 'reduced' },
+        ],
+    },
+    {
+        caseId: 'daily',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [0, 1, 2, 3, 4, 5, 6].map(day => ({
+            periodKey: `day-${day}`,
+            start: { dayOfWeek: day, timeLocal: '08:00' },
+            end: { dayOfWeek: day, timeLocal: '18:00' },
+        })),
+        expectedRules: [rule('daily-restore', [0, 1, 2, 3, 4, 5, 6], '08:00', 'restore'), rule('daily-reduce', [0, 1, 2, 3, 4, 5, 6], '18:00', 'reduce')],
+        stateSamples: [
+            { instantUtc: '2026-09-13T19:59:59.999Z', expectedState: 'reduced' },
+            { instantUtc: '2026-09-13T20:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-14T06:00:00.000Z', expectedState: 'reduced' },
+        ],
+    },
+    {
+        caseId: 'cross-midnight',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [{ periodKey: 'overnight', start: { dayOfWeek: 5, timeLocal: '22:00' }, end: { dayOfWeek: 6, timeLocal: '02:00' } }],
+        expectedRules: [rule('overnight-restore', [5], '22:00', 'restore'), rule('overnight-reduce', [6], '02:00', 'reduce')],
+        stateSamples: [
+            { instantUtc: '2026-09-18T09:59:59.999Z', expectedState: 'reduced' },
+            { instantUtc: '2026-09-18T10:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-18T14:00:00.000Z', expectedState: 'reduced' },
+        ],
+    },
+    {
+        caseId: 'week-wrap',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [{ periodKey: 'week-wrap', start: { dayOfWeek: 0, timeLocal: '22:00' }, end: { dayOfWeek: 1, timeLocal: '02:00' } }],
+        expectedRules: [rule('week-wrap-restore', [0], '22:00', 'restore'), rule('week-wrap-reduce', [1], '02:00', 'reduce')],
+        stateSamples: [
+            { instantUtc: '2026-09-20T09:59:59.999Z', expectedState: 'reduced' },
+            { instantUtc: '2026-09-20T10:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-20T14:00:00.000Z', expectedState: 'reduced' },
+        ],
+    },
+    {
+        caseId: 'touching-periods',
+        timezone: 'UTC',
+        validity: 'valid',
+        periods: [
+            { periodKey: 'morning', start: { dayOfWeek: 1, timeLocal: '08:00' }, end: { dayOfWeek: 1, timeLocal: '12:00' } },
+            { periodKey: 'afternoon', start: { dayOfWeek: 1, timeLocal: '12:00' }, end: { dayOfWeek: 1, timeLocal: '18:00' } },
+        ],
+        expectedRules: [rule('touching-restore', [1], '08:00', 'restore'), rule('touching-reduce', [1], '18:00', 'reduce')],
+        stateSamples: [
+            { instantUtc: '2026-09-14T07:59:59.999Z', expectedState: 'reduced' },
+            { instantUtc: '2026-09-14T08:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-14T12:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-14T18:00:00.000Z', expectedState: 'reduced' },
+        ],
+    },
+    {
+        caseId: 'exact-boundaries',
+        timezone: 'UTC',
+        validity: 'valid',
+        periods: [{ periodKey: 'window', start: { dayOfWeek: 1, timeLocal: '08:00' }, end: { dayOfWeek: 1, timeLocal: '18:00' } }],
+        expectedRules: [rule('window-restore', [1], '08:00', 'restore'), rule('window-reduce', [1], '18:00', 'reduce')],
+        stateSamples: [
+            { instantUtc: '2026-09-14T07:59:59.999Z', expectedState: 'reduced' },
+            { instantUtc: '2026-09-14T08:00:00.000Z', expectedState: 'normal' },
+            { instantUtc: '2026-09-14T18:00:00.000Z', expectedState: 'reduced' },
+        ],
+    },
+    {
+        caseId: 'spring-forward-gap',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [{ periodKey: 'gap', start: { dayOfWeek: 0, timeLocal: '02:30' }, end: { dayOfWeek: 0, timeLocal: '04:00' } }],
+        expectedRules: [rule('gap-restore', [0], '02:30', 'restore'), rule('gap-reduce', [0], '04:00', 'reduce')],
+        stateSamples: [{ instantUtc: '2026-09-26T14:00:00.000Z', expectedState: 'normal' }],
+        dstPolicy: 'spring-forward-first-valid',
+    },
+    {
+        caseId: 'fall-back-restore-first',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [{ periodKey: 'overlap-start', start: { dayOfWeek: 0, timeLocal: '02:30' }, end: { dayOfWeek: 0, timeLocal: '04:00' } }],
+        expectedRules: [rule('overlap-start-restore', [0], '02:30', 'restore'), rule('overlap-start-reduce', [0], '04:00', 'reduce')],
+        stateSamples: [{ instantUtc: '2026-04-04T13:30:00.000Z', expectedState: 'normal' }],
+        dstPolicy: 'fall-back-restore-first',
+    },
+    {
+        caseId: 'fall-back-reduce-second',
+        timezone: 'Pacific/Auckland',
+        validity: 'valid',
+        periods: [{ periodKey: 'overlap-end', start: { dayOfWeek: 0, timeLocal: '00:30' }, end: { dayOfWeek: 0, timeLocal: '02:30' } }],
+        expectedRules: [rule('overlap-end-restore', [0], '00:30', 'restore'), rule('overlap-end-reduce', [0], '02:30', 'reduce')],
+        stateSamples: [{ instantUtc: '2026-04-04T14:30:00.000Z', expectedState: 'reduced' }],
+        dstPolicy: 'fall-back-reduce-second',
+    },
+    {
+        caseId: 'invalid-overlap',
+        timezone: 'UTC',
+        validity: 'invalid',
+        periods: [
+            { periodKey: 'first', start: { dayOfWeek: 1, timeLocal: '08:00' }, end: { dayOfWeek: 1, timeLocal: '12:00' } },
+            { periodKey: 'second', start: { dayOfWeek: 1, timeLocal: '11:00' }, end: { dayOfWeek: 1, timeLocal: '13:00' } },
+        ],
+        invalidReason: 'overlap',
+    },
+    {
+        caseId: 'invalid-conflicting-transition',
+        timezone: 'UTC',
+        validity: 'invalid',
+        periods: [{ periodKey: 'zero-duration', start: { dayOfWeek: 1, timeLocal: '08:00' }, end: { dayOfWeek: 1, timeLocal: '08:00' } }],
+        invalidReason: 'conflicting-transition',
+    },
+];
+function deepFreeze(value) {
+    if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
+        for (const nestedValue of Object.values(value))
+            deepFreeze(nestedValue);
+        Object.freeze(value);
+    }
+    return value;
+}
+export const WEEKLY_AVAILABILITY_FIXTURES_V1 = deepFreeze(fixtures);

package/dist/esm/tags/index.js

@@ -0,0 +1 @@
+export * from './tags.js';

package/dist/esm/tags/tags.js

@@ -0,0 +1,6 @@
+// Bitmask flag constants
+export var TagFlags;
+(function (TagFlags) {
+    TagFlags[TagFlags["Required"] = 1] = "Required";
+    TagFlags[TagFlags["Inherited"] = 2] = "Inherited";
+})(TagFlags || (TagFlags = {}));

package/dist/esm/unknown/services.js

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

package/dist/esm/users/companyUser.js

@@ -0,0 +1,2 @@
+export class CompanyUser {
+}

package/dist/esm/users/index.js

@@ -0,0 +1,2 @@
+export * from './user.js';
+export * from './companyUser.js';

package/dist/esm/users/user.js

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

package/dist/events/actionGroups.d.ts

@@ -0,0 +1,85 @@
+export interface ActionGroupEmailAction {
+    name?: string;
+    email: string;
+}
+export interface ActionGroupSlackOrTeamsAction {
+    name: string;
+    webhookUrl: string;
+}
+export interface ActionGroupWebhookAction {
+    name: string;
+    url: string;
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string;
+    };
+}
+export interface ActionGroupJiraAction {
+    enabled: true;
+    projectKey: string;
+    issueType: string;
+    labels?: string[];
+    epicKey?: string;
+}
+export interface ActionGroupActions {
+    emails?: ActionGroupEmailAction[];
+    slack?: ActionGroupSlackOrTeamsAction[];
+    teams?: ActionGroupSlackOrTeamsAction[];
+    webhooks?: ActionGroupWebhookAction[];
+    jira?: ActionGroupJiraAction;
+}
+export interface ActionGroup {
+    id: string;
+    companyId: string;
+    name: string;
+    actions: ActionGroupActions;
+    createdAt: string;
+    createdByUserId: string;
+    updatedAt: string;
+    updatedByUserId: string;
+}
+export interface ActionGroupCounts {
+    emails: number;
+    slack: number;
+    teams: number;
+    webhooks: number;
+    jira: number;
+    total: number;
+}
+export interface ActionGroupSummary {
+    id: string;
+    companyId: string;
+    name: string;
+    counts: ActionGroupCounts;
+    usageCount: number;
+    alertUsageCount: number;
+    notificationUsageCount: number;
+    createdAt: string;
+    createdByUserId: string;
+    updatedAt: string;
+    updatedByUserId: string;
+}
+export interface ActionGroupRecipientPreview {
+    emails: Array<Pick<ActionGroupEmailAction, 'name' | 'email'>>;
+    slack: Array<Pick<ActionGroupSlackOrTeamsAction, 'name'>>;
+    teams: Array<Pick<ActionGroupSlackOrTeamsAction, 'name'>>;
+    webhooks: Array<Pick<ActionGroupWebhookAction, 'name'>>;
+    hasJira: boolean;
+}
+export interface ActionGroupPreview extends ActionGroupSummary {
+    recipients: ActionGroupRecipientPreview;
+}
+export interface ActionGroupDestinationPreview {
+    type: 'email' | 'slack' | 'teams' | 'webhook' | 'jira';
+    label: string;
+}
+export interface ActionGroupListItem extends ActionGroupSummary {
+    destinationPreviews: ActionGroupDestinationPreview[];
+    remainingDestinationCount: number;
+}
+export interface ActionGroupListResponse {
+    results: ActionGroupListItem[];
+}
+export type CreateActionGroupInput = Pick<ActionGroup, 'name' | 'actions'>;
+export type UpdateActionGroupInput = Pick<ActionGroup, 'name' | 'actions'>;
+//# sourceMappingURL=actionGroups.d.ts.map

package/dist/events/actionGroups.d.ts.map

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

package/dist/events/actionGroups.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=actionGroups.js.map

package/dist/events/actionGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionGroups.js","sourceRoot":"","sources":["../../src/events/actionGroups.ts"],"names":[],"mappings":""}

package/dist/events/alertDefinitionRun.d.ts

@@ -0,0 +1,27 @@
+export type AlertDefinitionRunStatus = 'running' | 'success' | 'failed';
+/**
+ * Runtime metadata for alert definition evaluation runs.
+ * Stored as a blob so the API scheduler can decide when to enqueue the next run.
+ */
+export interface AlertDefinitionRunState {
+    companyId: string;
+    definitionId: string;
+    lastStartedAt?: string;
+    lastCompletedAt?: string;
+    lastStatus?: AlertDefinitionRunStatus;
+    lastDurationMs?: number;
+    lastError?: string;
+    lastCorrelationId?: string;
+    /**
+     * Optional debug: what subscriptions the definition scope resolved to.
+     * This is useful for tag-scoped definitions where subscription discovery can fail.
+     */
+    lastScopeResolvedAt?: string;
+    lastScopeSubscriptionIdsCount?: number;
+    lastScopeSubscriptionIdsSample?: string[];
+    lastScopeCloudAccountIdsCount?: number;
+    lastScopeCloudAccountIdsSample?: string[];
+    lastSourceCoverageStatus?: 'complete' | 'partial';
+    lastSourceFailedItemCount?: number;
+}
+//# sourceMappingURL=alertDefinitionRun.d.ts.map

package/dist/events/alertDefinitionRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertDefinitionRun.d.ts","sourceRoot":"","sources":["../../src/events/alertDefinitionRun.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAErB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,8BAA8B,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1C,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,8BAA8B,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1C,wBAAwB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAClD,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC"}

package/dist/events/alertDefinitionRun.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=alertDefinitionRun.js.map

package/dist/events/alertDefinitionRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertDefinitionRun.js","sourceRoot":"","sources":["../../src/events/alertDefinitionRun.ts"],"names":[],"mappings":""}

package/dist/events/baseAlert.d.ts

@@ -0,0 +1,141 @@
+import type { PaginationParams } from '../common/pagination.js';
+export type AlertSeverity = 'info' | 'warning' | 'critical';
+export type AlertStatus = 'open' | 'acknowledged' | 'resolved';
+export type AlertLifecycleEvent = 'open' | 'acknowledged' | 'resolved';
+export type AlertCategory = 'cost' | 'performance' | 'other';
+export type TagMatchMode = 'any' | 'all';
+export interface BaseAlertTag {
+    key: string;
+    value: string;
+}
+export interface BaseAlertScope {
+    subscriptionIds?: string[];
+    cloudAccountIds?: string[];
+    tags?: BaseAlertTag[];
+    tagMatch?: TagMatchMode;
+}
+export interface BaseAlertDestinationSlackOrTeams {
+    name: string;
+    webhookUrl?: string | null;
+}
+export interface BaseAlertDestinationWebhook {
+    name: string;
+    url?: string | null;
+    /**
+     * v1 defaults to sending only 'open'; when unspecified, treat as ['open'].
+     */
+    events?: AlertLifecycleEvent[];
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string | null;
+    };
+}
+export interface BaseAlertDestinationJira {
+    enabled: boolean;
+    projectKey: string;
+    issueType: string;
+    labels?: string[];
+    epicKey?: string;
+}
+export interface BaseAlertDestinations {
+    slack?: BaseAlertDestinationSlackOrTeams[];
+    teams?: BaseAlertDestinationSlackOrTeams[];
+    webhooks?: BaseAlertDestinationWebhook[];
+    jira?: BaseAlertDestinationJira;
+    emails?: BaseAlertDestinationEmail[];
+}
+export interface BaseAlertDestinationEmail {
+    name?: string;
+    email?: string | null;
+    events?: AlertLifecycleEvent[];
+}
+export interface BaseAlertDefinition<TCriteria = unknown, TDestinations = BaseAlertDestinations, TScope = BaseAlertScope, TType extends string = string> {
+    id: string;
+    companyId: string;
+    name: string;
+    enabled: boolean;
+    category: AlertCategory;
+    type: TType;
+    scope: TScope;
+    criteria?: TCriteria;
+    actionGroupId?: string;
+    notifyOn?: AlertLifecycleEvent[];
+    destinations?: TDestinations;
+    /**
+     * Server-authored audit fields. Optional on create/update requests; always present on persisted records.
+     */
+    createdAt?: string;
+    createdByUserId?: string;
+    updatedAt?: string;
+    updatedByUserId?: string;
+}
+type AlertDefinitionServerAuthoredKey = 'id' | 'companyId' | 'createdAt' | 'createdByUserId' | 'updatedAt' | 'updatedByUserId';
+export type CreateAlertDefinitionInput<TDefinition extends BaseAlertDefinition = BaseAlertDefinition> = TDefinition extends BaseAlertDefinition ? Omit<TDefinition, AlertDefinitionServerAuthoredKey> : never;
+export type UpdateAlertDefinitionInput<TDefinition extends BaseAlertDefinition = BaseAlertDefinition, TCriteria = TDefinition['criteria']> = TDefinition extends BaseAlertDefinition ? Pick<TDefinition, 'name' | 'enabled' | 'scope' | 'actionGroupId' | 'notifyOn' | 'destinations'> & {
+    criteria?: TCriteria;
+} : never;
+export type BaseAlertSummary = Record<string, unknown>;
+export interface BaseAlertComment {
+    id: string;
+    userId: string;
+    userName?: string;
+    message: string;
+    createdAt: string;
+    /**
+     * Optional edit tracking; omit if edits are not supported.
+     */
+    updatedAt?: string;
+    editedByUserId?: string;
+}
+export interface BaseAlertInstance<TSummary = BaseAlertSummary, TScope = BaseAlertScope, TType extends string = string, TBreakdown = unknown> {
+    id: string;
+    companyId: string;
+    companyName: string;
+    definitionId: string;
+    category: AlertCategory;
+    type: TType;
+    status: AlertStatus;
+    severity: AlertSeverity;
+    scope: TScope;
+    discriminator?: {
+        kind: string;
+        value: string;
+    };
+    scopeSignature?: string;
+    createdAt: string;
+    /**
+     * If not yet updated, set equal to createdAt.
+     */
+    lastSeenAt?: string;
+    acknowledgedAt?: string | null;
+    acknowledgedByUserId?: string | null;
+    acknowledgedByUserName?: string | null;
+    /**
+     * Optional freeform note captured when acknowledging an alert.
+     */
+    acknowledgedNote?: string | null;
+    resolvedAt?: string | null;
+    resolvedByUserId?: string | null;
+    resolvedByUserName?: string | null;
+    /**
+     * Optional freeform note captured when resolving an alert.
+     */
+    resolvedNote?: string | null;
+    jiraIssueKey?: string;
+    comments?: BaseAlertComment[];
+    summary?: TSummary;
+    breakdown?: TBreakdown;
+    detailPath?: string;
+    /** Internal definition snapshot used to keep history readable after definition deletion. */
+    definitionSnapshot?: string;
+}
+export interface ListAlertsParams<TType extends string = string> extends PaginationParams {
+    status?: AlertStatus;
+    type?: TType;
+    definitionId?: string;
+    since?: string;
+    until?: string;
+}
+export type ListAlertDefinitionsParams = PaginationParams;
+export {};
+//# sourceMappingURL=baseAlert.d.ts.map

package/dist/events/baseAlert.d.ts.map

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

package/dist/events/baseAlert.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=baseAlert.js.map

package/dist/events/baseAlert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseAlert.js","sourceRoot":"","sources":["../../src/events/baseAlert.ts"],"names":[],"mappings":""}