@spottoai/types-package 1.0.2-beta.420 → 1.0.2-beta.421

package/dist/esm/scheduler/resourceStrategyValidationShared.js

@@ -0,0 +1,261 @@
+import { RESOURCE_STRATEGY_CONTRACT_LIMITS } from './resourceStrategyContracts.js';
+const FORBIDDEN_AUTHORING_KEYS = new Set([
+    '__proto__',
+    'prototype',
+    'constructor',
+    'actionId',
+    'actionRef',
+    'actionDefinitionId',
+    'actionDefinitionRef',
+    'workflowRef',
+    'operation',
+    'providerOperation',
+    'compiledOperation',
+    'httpMethod',
+    'endpoint',
+    'apiVersion',
+    'requestTemplate',
+    'permissions',
+    'permissionActions',
+    'permissionSetRef',
+    'permissionSetRefs',
+    'baseline',
+    'baselineRef',
+    'selectorRef',
+    'restoreBaseline',
+    'compiledDueRow',
+]);
+const INHERITED_FORBIDDEN_AUTHORING_KEYS = [...FORBIDDEN_AUTHORING_KEYS].filter(key => key !== '__proto__' && key !== 'prototype' && key !== 'constructor');
+export function isRecord(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    try {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            return false;
+        return Reflect.ownKeys(value).every(key => {
+            if (typeof key !== 'string')
+                return false;
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            return descriptor !== undefined && descriptor.enumerable && 'value' in descriptor;
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export function hasOnlyKeys(value, allowed) {
+    try {
+        const allowedSet = new Set(allowed);
+        return (Object.keys(value).every(key => allowedSet.has(key)) &&
+            allowed.every(key => !Reflect.has(value, key) || Object.prototype.hasOwnProperty.call(value, key)));
+    }
+    catch {
+        return false;
+    }
+}
+export function isBoundedString(value, maximum = RESOURCE_STRATEGY_CONTRACT_LIMITS.textLength) {
+    return typeof value === 'string' && value.length > 0 && value.length <= maximum;
+}
+export function isOptionalBoundedString(value, maximum = RESOURCE_STRATEGY_CONTRACT_LIMITS.textLength) {
+    return value === undefined || isBoundedString(value, maximum);
+}
+export function isPositiveInteger(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+}
+export function isNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}
+export function isIsoTimestamp(value) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(value))
+        return false;
+    const instant = new Date(value);
+    if (!Number.isFinite(instant.getTime()))
+        return false;
+    const canonical = instant.toISOString();
+    return value.includes('.') ? canonical === value : canonical.replace('.000Z', 'Z') === value;
+}
+export function isDate(value) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const date = new Date(`${value}T00:00:00.000Z`);
+    return Number.isFinite(date.getTime()) && date.toISOString().slice(0, 10) === value;
+}
+export function isTime(value) {
+    return typeof value === 'string' && /^(?:[01]\d|2[0-3]):[0-5]\d$/.test(value);
+}
+export function isCurrency(value) {
+    return typeof value === 'string' && /^[A-Z]{3}$/.test(value);
+}
+export function isNonNegativeDecimal(value) {
+    return typeof value === 'string' && /^\d{1,15}(?:\.\d{1,8})?$/.test(value);
+}
+export function isIanaTimezone(value) {
+    if (!isBoundedString(value, 100))
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: value }).format(0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function jsonStringByteLengthWithin(value, maximum) {
+    let bytes = 2;
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit === 0x22 ||
+            codeUnit === 0x5c ||
+            codeUnit === 0x08 ||
+            codeUnit === 0x09 ||
+            codeUnit === 0x0a ||
+            codeUnit === 0x0c ||
+            codeUnit === 0x0d) {
+            bytes += 2;
+        }
+        else if (codeUnit <= 0x1f ||
+            (codeUnit >= 0xd800 &&
+                codeUnit <= 0xdfff &&
+                !(codeUnit <= 0xdbff && index + 1 < value.length && value.charCodeAt(index + 1) >= 0xdc00 && value.charCodeAt(index + 1) <= 0xdfff))) {
+            bytes += 6;
+        }
+        else if (codeUnit <= 0x7f) {
+            bytes += 1;
+        }
+        else if (codeUnit <= 0x7ff) {
+            bytes += 2;
+        }
+        else if (codeUnit <= 0xdbff) {
+            bytes += 4;
+            index += 1;
+        }
+        else {
+            bytes += 3;
+        }
+        if (bytes > maximum)
+            return null;
+    }
+    return bytes;
+}
+export function isWithinJsonByteLimit(value, maximum) {
+    if (!Number.isSafeInteger(maximum) || maximum < 0)
+        return false;
+    const stack = [value];
+    let bytes = 0;
+    let nodes = 0;
+    try {
+        while (stack.length > 0) {
+            nodes += 1;
+            if (nodes > 10000)
+                return false;
+            const current = stack.pop();
+            if (current === null) {
+                bytes += 4;
+            }
+            else if (typeof current === 'string') {
+                const stringBytes = jsonStringByteLengthWithin(current, maximum - bytes);
+                if (stringBytes === null)
+                    return false;
+                bytes += stringBytes;
+            }
+            else if (typeof current === 'number') {
+                if (!Number.isFinite(current))
+                    return false;
+                bytes += String(Object.is(current, -0) ? 0 : current).length;
+            }
+            else if (typeof current === 'boolean') {
+                bytes += current ? 4 : 5;
+            }
+            else if (Array.isArray(current)) {
+                if (Object.getPrototypeOf(current) !== Array.prototype)
+                    return false;
+                bytes += 2 + Math.max(0, current.length - 1);
+                if (bytes > maximum)
+                    return false;
+                const ownKeys = Reflect.ownKeys(current);
+                if (ownKeys.length !== current.length + 1 || !ownKeys.includes('length'))
+                    return false;
+                for (let index = 0; index < current.length; index += 1) {
+                    const descriptor = Object.getOwnPropertyDescriptor(current, String(index));
+                    if (descriptor === undefined || !descriptor.enumerable || !('value' in descriptor))
+                        return false;
+                    stack.push(descriptor.value);
+                }
+            }
+            else if (isRecord(current)) {
+                const keys = Object.keys(current);
+                bytes += 2 + Math.max(0, keys.length - 1);
+                if (bytes > maximum)
+                    return false;
+                for (const key of keys) {
+                    const keyBytes = jsonStringByteLengthWithin(key, maximum - bytes);
+                    if (keyBytes === null)
+                        return false;
+                    bytes += keyBytes + 1;
+                    if (bytes > maximum)
+                        return false;
+                    const descriptor = Object.getOwnPropertyDescriptor(current, key);
+                    if (descriptor === undefined || !('value' in descriptor))
+                        return false;
+                    stack.push(descriptor.value);
+                }
+            }
+            else {
+                return false;
+            }
+            if (bytes > maximum)
+                return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isBoundedStringArray(value, maximum = RESOURCE_STRATEGY_CONTRACT_LIMITS.metadataItems) {
+    return Array.isArray(value) && value.length <= maximum && value.every(item => isBoundedString(item, 2000));
+}
+export function containsForbiddenKey(value, depth = 0) {
+    try {
+        if (depth > 8)
+            return true;
+        if (value !== null && typeof value === 'object') {
+            if (INHERITED_FORBIDDEN_AUTHORING_KEYS.some(key => Reflect.has(value, key) && !Object.prototype.hasOwnProperty.call(value, key))) {
+                return true;
+            }
+        }
+        if (Array.isArray(value))
+            return value.some(item => containsForbiddenKey(item, depth + 1));
+        if (!isRecord(value))
+            return false;
+        return Object.keys(value).some(key => FORBIDDEN_AUTHORING_KEYS.has(key) || containsForbiddenKey(value[key], depth + 1));
+    }
+    catch {
+        return true;
+    }
+}
+function isBoundedJsonValue(value, depth = 0) {
+    if (depth > 8)
+        return false;
+    if (value === null || typeof value === 'boolean' || typeof value === 'string')
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.length <= 128 && value.every(item => isBoundedJsonValue(item, depth + 1));
+    if (!isRecord(value) || Object.keys(value).length > 128)
+        return false;
+    return Object.entries(value).every(([key, item]) => !FORBIDDEN_AUTHORING_KEYS.has(key) && isBoundedJsonValue(item, depth + 1));
+}
+export function isBoundedParameters(value) {
+    if (!isWithinJsonByteLimit(value, RESOURCE_STRATEGY_CONTRACT_LIMITS.parameterBytes))
+        return false;
+    return isRecord(value) && isBoundedJsonValue(value) && !containsForbiddenKey(value);
+}
+export function isCapabilityRef(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, ['capabilityId', 'capabilityVersion']) &&
+        isBoundedString(value.capabilityId, 200) &&
+        isPositiveInteger(value.capabilityVersion));
+}

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

@@ -1,5 +1,4 @@
-export * from './bastionSchedule';
-export * from './bastionScheduleProfile';
-export * from './bastionScheduleValidation';
 export * from './scheduler';
+export * from './resourceStrategy';
+export * from './weeklyAvailabilityFixtures';
 //# sourceMappingURL=index.d.ts.map

package/dist/scheduler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}

package/dist/scheduler/index.js

@@ -14,8 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./bastionSchedule"), exports);
-__exportStar(require("./bastionScheduleProfile"), exports);
-__exportStar(require("./bastionScheduleValidation"), exports);
 __exportStar(require("./scheduler"), exports);
+__exportStar(require("./resourceStrategy"), exports);
+__exportStar(require("./weeklyAvailabilityFixtures"), exports);
 //# sourceMappingURL=index.js.map

package/dist/scheduler/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC;AACzC,8DAA4C;AAC5C,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduler/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,qDAAmC;AACnC,+DAA6C"}

package/dist/scheduler/resourceStrategy.d.ts

@@ -0,0 +1,3 @@
+export * from './resourceStrategyContracts';
+export * from './resourceStrategyValidation';
+//# sourceMappingURL=resourceStrategy.d.ts.map

package/dist/scheduler/resourceStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceStrategy.d.ts","sourceRoot":"","sources":["../../src/scheduler/resourceStrategy.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}

package/dist/scheduler/resourceStrategy.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./resourceStrategyContracts"), exports);
+__exportStar(require("./resourceStrategyValidation"), exports);
+//# sourceMappingURL=resourceStrategy.js.map

package/dist/scheduler/resourceStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceStrategy.js","sourceRoot":"","sources":["../../src/scheduler/resourceStrategy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,+DAA6C"}

package/dist/scheduler/resourceStrategyCapabilityValidation.d.ts

@@ -0,0 +1,4 @@
+import { type ResourceSchedulingCapabilityProjection, type ResourceSchedulingReadinessProjection } from './resourceStrategyContracts';
+export declare function isResourceSchedulingCapabilityProjection(value: unknown): value is ResourceSchedulingCapabilityProjection;
+export declare function isResourceSchedulingReadinessProjection(value: unknown): value is ResourceSchedulingReadinessProjection;
+//# sourceMappingURL=resourceStrategyCapabilityValidation.d.ts.map

package/dist/scheduler/resourceStrategyCapabilityValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceStrategyCapabilityValidation.d.ts","sourceRoot":"","sources":["../../src/scheduler/resourceStrategyCapabilityValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sCAAsC,EAC3C,KAAK,qCAAqC,EAE3C,MAAM,6BAA6B,CAAC;AAerC,wBAAgB,wCAAwC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sCAAsC,CA8MxH;AAkBD,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qCAAqC,CAmCtH"}