@onereach/billing-shared 31.17.0 → 31.17.1-beta.13420.0

package/dist/cjs/billing-boundaries/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUtcMidnight = isUtcMidnight;
+exports.isUtcInclusiveDateEnd = isUtcInclusiveDateEnd;
+exports.toExclusiveUtcDateEnd = toExclusiveUtcDateEnd;
+exports.getUtcBillingDateIssues = getUtcBillingDateIssues;
+var UTC_DAY_MS = 24 * 60 * 60 * 1000;
+function isUtcMidnight(value) {
+    return value instanceof Date && Number.isFinite(value.getTime()) && value.getTime() % UTC_DAY_MS === 0;
+}
+function isUtcInclusiveDateEnd(value) {
+    if (!(value instanceof Date) || !Number.isFinite(value.getTime()))
+        return false;
+    var time = value.getTime();
+    return (isUtcMidnight(value) || (time + 1) % UTC_DAY_MS === 0)
+        && Number.isFinite(new Date(Math.floor(time / UTC_DAY_MS) * UTC_DAY_MS + UTC_DAY_MS).getTime());
+}
+function toExclusiveUtcDateEnd(value) {
+    if (!isUtcInclusiveDateEnd(value)) {
+        throw new RangeError('Billing end date must be a UTC calendar date or UTC end of day');
+    }
+    return new Date(Math.floor(value.getTime() / UTC_DAY_MS) * UTC_DAY_MS + UTC_DAY_MS);
+}
+function getUtcBillingDateIssues(startDate, endDate, options) {
+    if (options === void 0) { options = {}; }
+    var issues = [];
+    var prefix = options.pathPrefix ? "".concat(options.pathPrefix, ".") : '';
+    if (!isUtcMidnight(startDate)) {
+        issues.push({
+            path: "".concat(prefix, "startDate"),
+            constraints: { utcMidnight: 'Start date must be a valid date at midnight UTC' },
+        });
+    }
+    var openEnd = options.allowOpenEnd && (endDate === null || endDate === undefined);
+    if (!openEnd && !isUtcInclusiveDateEnd(endDate)) {
+        issues.push({
+            path: "".concat(prefix, "endDate"),
+            constraints: { utcCalendarEnd: 'End date must be a valid UTC calendar date at midnight or 23:59:59.999 UTC (inclusive)' },
+        });
+    }
+    if (isUtcMidnight(startDate) && isUtcInclusiveDateEnd(endDate) && toExclusiveUtcDateEnd(endDate) <= startDate) {
+        issues.push({
+            path: "".concat(prefix, "endDate"),
+            constraints: { minDate: 'End date must not be before the start date' },
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/billing-boundaries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/billing-boundaries/index.ts"],"names":[],"mappings":";;AAIA,sCAEC;AAGD,sDAKC;AAGD,sDAKC;AAED,0DA2BC;AAjDD,IAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,GAAG,UAAU,KAAK,CAAC,CAAC;AACzG,CAAC;AAGD,SAAgB,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,IAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7B,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;WACzD,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACpG,CAAC;AAGD,SAAgB,qBAAqB,CAAC,KAAW;IAC/C,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAAC,gEAAgE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;AACtF,CAAC;AAED,SAAgB,uBAAuB,CACrC,SAAkB,EAClB,OAAgB,EAChB,OAA0C;IAA1C,wBAAA,EAAA,YAA0C;IAE1C,IAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,UAAG,OAAO,CAAC,UAAU,MAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,UAAG,MAAM,cAAW;YAC1B,WAAW,EAAE,EAAE,WAAW,EAAE,iDAAiD,EAAE;SAChF,CAAC,CAAC;IACL,CAAC;IACD,IAAM,OAAO,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC;IACpF,IAAI,CAAC,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,UAAG,MAAM,YAAS;YACxB,WAAW,EAAE,EAAE,cAAc,EAAE,wFAAwF,EAAE;SAC1H,CAAC,CAAC;IACL,CAAC;IACD,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;QAC9G,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,UAAG,MAAM,YAAS;YACxB,WAAW,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/billing-boundaries/types.js

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

package/dist/cjs/billing-boundaries/types.js.map

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

package/dist/cjs/index.js

@@ -18,4 +18,6 @@ __exportStar(require("./enums"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils"), exports);
+__exportStar(require("./usage-granularity"), exports);
+__exportStar(require("./billing-boundaries"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,0CAAwB;AACxB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,0CAAwB;AACxB,0CAAwB;AACxB,sDAAoC;AACpC,uDAAqC"}

package/dist/cjs/usage-granularity/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USAGE_HOUR_MS = exports.DEFAULT_USAGE_GRANULARITY_HOURS = exports.USAGE_GRANULARITY_HOURS = void 0;
+exports.USAGE_GRANULARITY_HOURS = [1, 2, 3, 4, 6, 8, 12, 24];
+exports.DEFAULT_USAGE_GRANULARITY_HOURS = 1;
+exports.USAGE_HOUR_MS = 3600000;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/usage-granularity/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/usage-granularity/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,uBAAuB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AAE9D,QAAA,+BAA+B,GAAG,CAAC,CAAC;AAEpC,QAAA,aAAa,GAAG,OAAO,CAAC"}

package/dist/cjs/usage-granularity/index.js

@@ -0,0 +1,23 @@
+"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("./constants"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./usage-granularity"), exports);
+__exportStar(require("./source-event-policy"), exports);
+__exportStar(require("./reporting.types"), exports);
+__exportStar(require("./metric-policy"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/usage-granularity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usage-granularity/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB;AACxB,sDAAoC;AACpC,wDAAsC;AACtC,oDAAkC;AAClC,kDAAgC"}

package/dist/cjs/usage-granularity/metric-policy.js

@@ -0,0 +1,45 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supportsCoarseUsageCollection = supportsCoarseUsageCollection;
+exports.assertUsageCollectionMetric = assertUsageCollectionMetric;
+var category_namespace_1 = require("../enums/category-namespace");
+var customer_usage_1 = require("../enums/customer-usage");
+var COARSE_EVENTS = (_a = {},
+    _a[customer_usage_1.DataSourceProvider.AZURE] = [
+        category_namespace_1.CategoryNamespace.PROCESSING_FLOW,
+        category_namespace_1.CategoryNamespace.PROCESSING_VOICE,
+        category_namespace_1.CategoryNamespace.EXECUTABLE_GENERAL,
+        category_namespace_1.CategoryNamespace.EXECUTABLE_PORT_IN_IDENTIFIER,
+        category_namespace_1.CategoryNamespace.LOOKUP,
+        category_namespace_1.CategoryNamespace.TELEPHONY_VOICE,
+        category_namespace_1.CategoryNamespace.MESSAGING_TEXT,
+        category_namespace_1.CategoryNamespace.CONVERSATIONS_WAP,
+        category_namespace_1.CategoryNamespace.CARRIER_FEE,
+        category_namespace_1.CategoryNamespace.USER,
+        category_namespace_1.CategoryNamespace.IDENTIFIER,
+        category_namespace_1.CategoryNamespace.STORAGE_GENERAL,
+        category_namespace_1.CategoryNamespace.STORAGE_WEAVIATE,
+    ],
+    _a[customer_usage_1.DataSourceProvider.DRUID] = [
+        category_namespace_1.CategoryNamespace.EXECUTABLE_LLM,
+        category_namespace_1.CategoryNamespace.EXECUTABLE_GENERAL,
+        category_namespace_1.CategoryNamespace.STORAGE_WEAVIATE,
+        category_namespace_1.CategoryNamespace.LOOKUP,
+        category_namespace_1.CategoryNamespace.TELEPHONY_VOICE,
+        category_namespace_1.CategoryNamespace.PROCESSING_VOICE,
+        category_namespace_1.CategoryNamespace.CARRIER_FEE,
+        category_namespace_1.CategoryNamespace.MESSAGING_TEXT,
+    ],
+    _a);
+function supportsCoarseUsageCollection(provider, eventType) {
+    if (provider !== customer_usage_1.DataSourceProvider.AZURE && provider !== customer_usage_1.DataSourceProvider.DRUID)
+        return false;
+    return COARSE_EVENTS[provider].includes(eventType);
+}
+function assertUsageCollectionMetric(provider, eventType, hours) {
+    if (hours > 1 && !supportsCoarseUsageCollection(provider, eventType)) {
+        throw new Error("Coarse collection is not verified for ".concat(provider, "/").concat(eventType, "; use 1h granularity"));
+    }
+}
+//# sourceMappingURL=metric-policy.js.map

package/dist/cjs/usage-granularity/metric-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-policy.js","sourceRoot":"","sources":["../../../src/usage-granularity/metric-policy.ts"],"names":[],"mappings":";;;AA+BA,sEAGC;AAED,kEAIC;AAxCD,kEAAgE;AAChE,0DAA6D;AAE7D,IAAM,aAAa;IACjB,GAAC,mCAAkB,CAAC,KAAK,IAAG;QAC1B,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,kBAAkB;QACpC,sCAAiB,CAAC,6BAA6B;QAC/C,sCAAiB,CAAC,MAAM;QACxB,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,cAAc;QAChC,sCAAiB,CAAC,iBAAiB;QACnC,sCAAiB,CAAC,WAAW;QAC7B,sCAAiB,CAAC,IAAI;QACtB,sCAAiB,CAAC,UAAU;QAC5B,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,gBAAgB;KACnC;IACD,GAAC,mCAAkB,CAAC,KAAK,IAAG;QAC1B,sCAAiB,CAAC,cAAc;QAChC,sCAAiB,CAAC,kBAAkB;QACpC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,MAAM;QACxB,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,WAAW;QAC7B,sCAAiB,CAAC,cAAc;KACjC;OACF,CAAC;AAEF,SAAgB,6BAA6B,CAAC,QAAgB,EAAE,SAA4B;IAC1F,IAAI,QAAQ,KAAK,mCAAkB,CAAC,KAAK,IAAI,QAAQ,KAAK,mCAAkB,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACjG,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,2BAA2B,CAAC,QAAgB,EAAE,SAA4B,EAAE,KAAa;IACvG,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,gDAAyC,QAAQ,cAAI,SAAS,yBAAsB,CAAC,CAAC;IACxG,CAAC;AACH,CAAC"}

package/dist/cjs/usage-granularity/reporting.types.js

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

package/dist/cjs/usage-granularity/reporting.types.js.map

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

package/dist/cjs/usage-granularity/source-event-policy.js

@@ -0,0 +1,48 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DB_EVENT_TYPE_MAP = void 0;
+exports.getDruidEventTypes = getDruidEventTypes;
+var category_namespace_1 = require("../enums/category-namespace");
+var customer_usage_1 = require("../enums/customer-usage");
+exports.DB_EVENT_TYPE_MAP = (_a = {},
+    _a[customer_usage_1.DataSourceProvider.AZURE] = [
+        category_namespace_1.CategoryNamespace.PROCESSING_FLOW,
+        category_namespace_1.CategoryNamespace.PROCESSING_VOICE,
+        category_namespace_1.CategoryNamespace.EXECUTABLE_GENERAL,
+        category_namespace_1.CategoryNamespace.EXECUTABLE_PORT_IN_IDENTIFIER,
+        category_namespace_1.CategoryNamespace.LOOKUP,
+        category_namespace_1.CategoryNamespace.TELEPHONY_VOICE,
+        category_namespace_1.CategoryNamespace.MESSAGING_TEXT,
+        category_namespace_1.CategoryNamespace.CONVERSATIONS_WAP,
+        category_namespace_1.CategoryNamespace.CARRIER_FEE,
+        category_namespace_1.CategoryNamespace.STORAGE_GENERAL,
+        category_namespace_1.CategoryNamespace.STORAGE_WEAVIATE,
+        category_namespace_1.CategoryNamespace.IDENTIFIER,
+        category_namespace_1.CategoryNamespace.USER,
+        category_namespace_1.CategoryNamespace.PRODUCT,
+    ],
+    _a[customer_usage_1.DataSourceProvider.DRUID] = [
+        category_namespace_1.CategoryNamespace.EXECUTABLE_LLM,
+        category_namespace_1.CategoryNamespace.EXECUTABLE_GENERAL,
+        category_namespace_1.CategoryNamespace.STORAGE_WEAVIATE,
+        category_namespace_1.CategoryNamespace.LOOKUP,
+        category_namespace_1.CategoryNamespace.TELEPHONY_VOICE,
+        category_namespace_1.CategoryNamespace.PROCESSING_VOICE,
+        category_namespace_1.CategoryNamespace.CARRIER_FEE,
+        category_namespace_1.CategoryNamespace.MESSAGING_TEXT,
+        category_namespace_1.CategoryNamespace.PRODUCT,
+    ],
+    _a);
+var CATEGORY_NAMESPACES = new Set(Object.values(category_namespace_1.CategoryNamespace));
+function getDruidEventTypes(metadata) {
+    if (!Array.isArray(metadata === null || metadata === void 0 ? void 0 : metadata.tables))
+        return [];
+    var eventTypes = metadata.tables.flatMap(function (table) {
+        if (typeof table !== 'object' || table === null || !('eventTypes' in table))
+            return [];
+        return Array.isArray(table.eventTypes) ? table.eventTypes : [];
+    });
+    return Array.from(new Set(eventTypes.filter(function (eventType) { return (typeof eventType === 'string' && CATEGORY_NAMESPACES.has(eventType)); })));
+}
+//# sourceMappingURL=source-event-policy.js.map

package/dist/cjs/usage-granularity/source-event-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-event-policy.js","sourceRoot":"","sources":["../../../src/usage-granularity/source-event-policy.ts"],"names":[],"mappings":";;;;AAmCA,gDASC;AA5CD,kEAAgE;AAChE,0DAA6D;AAEhD,QAAA,iBAAiB;IAC5B,GAAC,mCAAkB,CAAC,KAAK,IAAG;QAC1B,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,kBAAkB;QACpC,sCAAiB,CAAC,6BAA6B;QAC/C,sCAAiB,CAAC,MAAM;QACxB,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,cAAc;QAChC,sCAAiB,CAAC,iBAAiB;QACnC,sCAAiB,CAAC,WAAW;QAC7B,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,UAAU;QAC5B,sCAAiB,CAAC,IAAI;QACtB,sCAAiB,CAAC,OAAO;KAC1B;IACD,GAAC,mCAAkB,CAAC,KAAK,IAAG;QAC1B,sCAAiB,CAAC,cAAc;QAChC,sCAAiB,CAAC,kBAAkB;QACpC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,MAAM;QACxB,sCAAiB,CAAC,eAAe;QACjC,sCAAiB,CAAC,gBAAgB;QAClC,sCAAiB,CAAC,WAAW;QAC7B,sCAAiB,CAAC,cAAc;QAChC,sCAAiB,CAAC,OAAO;KAC1B;QACD;AAEF,IAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,sCAAiB,CAAC,CAAC,CAAC;AAE9E,SAAgB,kBAAkB,CAAC,QAAkC;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,IAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,UAAA,KAAK;QAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvF,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,UAAC,SAAS,IAAqC,OAAA,CACzF,OAAO,SAAS,KAAK,QAAQ,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CACpE,EAF0F,CAE1F,CAAC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cjs/usage-granularity/types.js

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

package/dist/cjs/usage-granularity/types.js.map

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

package/dist/cjs/usage-granularity/usage-granularity.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUsageGranularityHours = isUsageGranularityHours;
+exports.getCompatibleUsageGranularity = getCompatibleUsageGranularity;
+exports.getUsageSlotStart = getUsageSlotStart;
+exports.resolveUsageGranularity = resolveUsageGranularity;
+exports.scheduleUsageGranularity = scheduleUsageGranularity;
+var constants_1 = require("./constants");
+function isUsageGranularityHours(value) {
+    return typeof value === 'number' && constants_1.USAGE_GRANULARITY_HOURS.some(function (hours) { return hours === value; });
+}
+function getCompatibleUsageGranularity(hours) {
+    var compatible = constants_1.USAGE_GRANULARITY_HOURS.find(function (candidate) { return hours.every(function (value) { return candidate % value === 0; }); });
+    if (compatible === undefined)
+        throw new Error('No compatible usage granularity');
+    return compatible;
+}
+function getUsageSlotStart(date, hours) {
+    var time = date.getTime();
+    if (!Number.isFinite(time) || !isUsageGranularityHours(hours)) {
+        throw new Error('Invalid usage slot date or granularity');
+    }
+    var duration = hours * constants_1.USAGE_HOUR_MS;
+    return new Date(Math.floor(time / duration) * duration);
+}
+function resolveUsageGranularity(state, now) {
+    if (!Number.isFinite(now.getTime()))
+        throw new Error('Invalid usage granularity date');
+    if (state.pendingGranularityHours !== null &&
+        state.granularityEffectiveAt !== null &&
+        new Date(state.granularityEffectiveAt).getTime() <= now.getTime()) {
+        return {
+            granularityHours: state.pendingGranularityHours,
+            pendingGranularityHours: null,
+            granularityEffectiveAt: null,
+        };
+    }
+    return {
+        granularityHours: state.granularityHours,
+        pendingGranularityHours: state.pendingGranularityHours,
+        granularityEffectiveAt: state.granularityEffectiveAt,
+    };
+}
+function scheduleUsageGranularity(state, requested, now) {
+    var current = resolveUsageGranularity(state, now);
+    if (requested === undefined)
+        return current;
+    if (!isUsageGranularityHours(requested))
+        throw new Error('Invalid usage granularity');
+    if (requested === current.granularityHours) {
+        return {
+            granularityHours: requested,
+            pendingGranularityHours: null,
+            granularityEffectiveAt: null,
+        };
+    }
+    if (requested === current.pendingGranularityHours)
+        return current;
+    var sharedHours = getCompatibleUsageGranularity([current.granularityHours, requested]);
+    var boundary = getUsageSlotStart(now, sharedHours);
+    return {
+        granularityHours: current.granularityHours,
+        pendingGranularityHours: requested,
+        granularityEffectiveAt: new Date(boundary.getTime() + sharedHours * constants_1.USAGE_HOUR_MS),
+    };
+}
+//# sourceMappingURL=usage-granularity.js.map

package/dist/cjs/usage-granularity/usage-granularity.js.map

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

package/dist/esm/billing-boundaries/index.js

@@ -0,0 +1,42 @@
+const UTC_DAY_MS = 24 * 60 * 60 * 1000;
+export function isUtcMidnight(value) {
+    return value instanceof Date && Number.isFinite(value.getTime()) && value.getTime() % UTC_DAY_MS === 0;
+}
+export function isUtcInclusiveDateEnd(value) {
+    if (!(value instanceof Date) || !Number.isFinite(value.getTime()))
+        return false;
+    const time = value.getTime();
+    return (isUtcMidnight(value) || (time + 1) % UTC_DAY_MS === 0)
+        && Number.isFinite(new Date(Math.floor(time / UTC_DAY_MS) * UTC_DAY_MS + UTC_DAY_MS).getTime());
+}
+export function toExclusiveUtcDateEnd(value) {
+    if (!isUtcInclusiveDateEnd(value)) {
+        throw new RangeError('Billing end date must be a UTC calendar date or UTC end of day');
+    }
+    return new Date(Math.floor(value.getTime() / UTC_DAY_MS) * UTC_DAY_MS + UTC_DAY_MS);
+}
+export function getUtcBillingDateIssues(startDate, endDate, options = {}) {
+    const issues = [];
+    const prefix = options.pathPrefix ? `${options.pathPrefix}.` : '';
+    if (!isUtcMidnight(startDate)) {
+        issues.push({
+            path: `${prefix}startDate`,
+            constraints: { utcMidnight: 'Start date must be a valid date at midnight UTC' },
+        });
+    }
+    const openEnd = options.allowOpenEnd && (endDate === null || endDate === undefined);
+    if (!openEnd && !isUtcInclusiveDateEnd(endDate)) {
+        issues.push({
+            path: `${prefix}endDate`,
+            constraints: { utcCalendarEnd: 'End date must be a valid UTC calendar date at midnight or 23:59:59.999 UTC (inclusive)' },
+        });
+    }
+    if (isUtcMidnight(startDate) && isUtcInclusiveDateEnd(endDate) && toExclusiveUtcDateEnd(endDate) <= startDate) {
+        issues.push({
+            path: `${prefix}endDate`,
+            constraints: { minDate: 'End date must not be before the start date' },
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/billing-boundaries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/billing-boundaries/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,GAAG,UAAU,KAAK,CAAC,CAAC;AACzG,CAAC;AAGD,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAChF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7B,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;WACzD,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACpG,CAAC;AAGD,MAAM,UAAU,qBAAqB,CAAC,KAAW;IAC/C,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAAC,gEAAgE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAkB,EAClB,OAAgB,EAChB,UAAwC,EAAE;IAE1C,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,GAAG,MAAM,WAAW;YAC1B,WAAW,EAAE,EAAE,WAAW,EAAE,iDAAiD,EAAE;SAChF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC;IACpF,IAAI,CAAC,OAAO,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,GAAG,MAAM,SAAS;YACxB,WAAW,EAAE,EAAE,cAAc,EAAE,wFAAwF,EAAE;SAC1H,CAAC,CAAC;IACL,CAAC;IACD,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;QAC9G,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,GAAG,MAAM,SAAS;YACxB,WAAW,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/billing-boundaries/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/billing-boundaries/types.js.map

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

package/dist/esm/index.js

@@ -2,4 +2,6 @@ export * from './enums';
 export * from './constants';
 export * from './types';
 export * from './utils';
+export * from './usage-granularity';
+export * from './billing-boundaries';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/esm/usage-granularity/constants.js

@@ -0,0 +1,4 @@
+export const USAGE_GRANULARITY_HOURS = [1, 2, 3, 4, 6, 8, 12, 24];
+export const DEFAULT_USAGE_GRANULARITY_HOURS = 1;
+export const USAGE_HOUR_MS = 3600000;
+//# sourceMappingURL=constants.js.map

package/dist/esm/usage-granularity/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/usage-granularity/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AAE3E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC"}

package/dist/esm/usage-granularity/index.js

@@ -0,0 +1,7 @@
+export * from './constants';
+export * from './types';
+export * from './usage-granularity';
+export * from './source-event-policy';
+export * from './reporting.types';
+export * from './metric-policy';
+//# sourceMappingURL=index.js.map

package/dist/esm/usage-granularity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usage-granularity/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/esm/usage-granularity/metric-policy.js

@@ -0,0 +1,40 @@
+import { CategoryNamespace } from '../enums/category-namespace';
+import { DataSourceProvider } from '../enums/customer-usage';
+const COARSE_EVENTS = {
+    [DataSourceProvider.AZURE]: [
+        CategoryNamespace.PROCESSING_FLOW,
+        CategoryNamespace.PROCESSING_VOICE,
+        CategoryNamespace.EXECUTABLE_GENERAL,
+        CategoryNamespace.EXECUTABLE_PORT_IN_IDENTIFIER,
+        CategoryNamespace.LOOKUP,
+        CategoryNamespace.TELEPHONY_VOICE,
+        CategoryNamespace.MESSAGING_TEXT,
+        CategoryNamespace.CONVERSATIONS_WAP,
+        CategoryNamespace.CARRIER_FEE,
+        CategoryNamespace.USER,
+        CategoryNamespace.IDENTIFIER,
+        CategoryNamespace.STORAGE_GENERAL,
+        CategoryNamespace.STORAGE_WEAVIATE,
+    ],
+    [DataSourceProvider.DRUID]: [
+        CategoryNamespace.EXECUTABLE_LLM,
+        CategoryNamespace.EXECUTABLE_GENERAL,
+        CategoryNamespace.STORAGE_WEAVIATE,
+        CategoryNamespace.LOOKUP,
+        CategoryNamespace.TELEPHONY_VOICE,
+        CategoryNamespace.PROCESSING_VOICE,
+        CategoryNamespace.CARRIER_FEE,
+        CategoryNamespace.MESSAGING_TEXT,
+    ],
+};
+export function supportsCoarseUsageCollection(provider, eventType) {
+    if (provider !== DataSourceProvider.AZURE && provider !== DataSourceProvider.DRUID)
+        return false;
+    return COARSE_EVENTS[provider].includes(eventType);
+}
+export function assertUsageCollectionMetric(provider, eventType, hours) {
+    if (hours > 1 && !supportsCoarseUsageCollection(provider, eventType)) {
+        throw new Error(`Coarse collection is not verified for ${provider}/${eventType}; use 1h granularity`);
+    }
+}
+//# sourceMappingURL=metric-policy.js.map

package/dist/esm/usage-granularity/metric-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-policy.js","sourceRoot":"","sources":["../../../src/usage-granularity/metric-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,aAAa,GAA8F;IAC/G,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC1B,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,kBAAkB;QACpC,iBAAiB,CAAC,6BAA6B;QAC/C,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,cAAc;QAChC,iBAAiB,CAAC,iBAAiB;QACnC,iBAAiB,CAAC,WAAW;QAC7B,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,UAAU;QAC5B,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,gBAAgB;KACnC;IACD,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC1B,iBAAiB,CAAC,cAAc;QAChC,iBAAiB,CAAC,kBAAkB;QACpC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,WAAW;QAC7B,iBAAiB,CAAC,cAAc;KACjC;CACF,CAAC;AAEF,MAAM,UAAU,6BAA6B,CAAC,QAAgB,EAAE,SAA4B;IAC1F,IAAI,QAAQ,KAAK,kBAAkB,CAAC,KAAK,IAAI,QAAQ,KAAK,kBAAkB,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACjG,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAgB,EAAE,SAA4B,EAAE,KAAa;IACvG,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,IAAI,SAAS,sBAAsB,CAAC,CAAC;IACxG,CAAC;AACH,CAAC"}

package/dist/esm/usage-granularity/reporting.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reporting.types.js.map

package/dist/esm/usage-granularity/reporting.types.js.map

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

package/dist/esm/usage-granularity/source-event-policy.js

@@ -0,0 +1,43 @@
+import { CategoryNamespace } from '../enums/category-namespace';
+import { DataSourceProvider } from '../enums/customer-usage';
+export const DB_EVENT_TYPE_MAP = {
+    [DataSourceProvider.AZURE]: [
+        CategoryNamespace.PROCESSING_FLOW,
+        CategoryNamespace.PROCESSING_VOICE,
+        CategoryNamespace.EXECUTABLE_GENERAL,
+        CategoryNamespace.EXECUTABLE_PORT_IN_IDENTIFIER,
+        CategoryNamespace.LOOKUP,
+        CategoryNamespace.TELEPHONY_VOICE,
+        CategoryNamespace.MESSAGING_TEXT,
+        CategoryNamespace.CONVERSATIONS_WAP,
+        CategoryNamespace.CARRIER_FEE,
+        CategoryNamespace.STORAGE_GENERAL,
+        CategoryNamespace.STORAGE_WEAVIATE,
+        CategoryNamespace.IDENTIFIER,
+        CategoryNamespace.USER,
+        CategoryNamespace.PRODUCT,
+    ],
+    [DataSourceProvider.DRUID]: [
+        CategoryNamespace.EXECUTABLE_LLM,
+        CategoryNamespace.EXECUTABLE_GENERAL,
+        CategoryNamespace.STORAGE_WEAVIATE,
+        CategoryNamespace.LOOKUP,
+        CategoryNamespace.TELEPHONY_VOICE,
+        CategoryNamespace.PROCESSING_VOICE,
+        CategoryNamespace.CARRIER_FEE,
+        CategoryNamespace.MESSAGING_TEXT,
+        CategoryNamespace.PRODUCT,
+    ],
+};
+const CATEGORY_NAMESPACES = new Set(Object.values(CategoryNamespace));
+export function getDruidEventTypes(metadata) {
+    if (!Array.isArray(metadata === null || metadata === void 0 ? void 0 : metadata.tables))
+        return [];
+    const eventTypes = metadata.tables.flatMap(table => {
+        if (typeof table !== 'object' || table === null || !('eventTypes' in table))
+            return [];
+        return Array.isArray(table.eventTypes) ? table.eventTypes : [];
+    });
+    return Array.from(new Set(eventTypes.filter((eventType) => (typeof eventType === 'string' && CATEGORY_NAMESPACES.has(eventType)))));
+}
+//# sourceMappingURL=source-event-policy.js.map

package/dist/esm/usage-granularity/source-event-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-event-policy.js","sourceRoot":"","sources":["../../../src/usage-granularity/source-event-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC1B,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,kBAAkB;QACpC,iBAAiB,CAAC,6BAA6B;QAC/C,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,cAAc;QAChC,iBAAiB,CAAC,iBAAiB;QACnC,iBAAiB,CAAC,WAAW;QAC7B,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,UAAU;QAC5B,iBAAiB,CAAC,IAAI;QACtB,iBAAiB,CAAC,OAAO;KAC1B;IACD,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC1B,iBAAiB,CAAC,cAAc;QAChC,iBAAiB,CAAC,kBAAkB;QACpC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,MAAM;QACxB,iBAAiB,CAAC,eAAe;QACjC,iBAAiB,CAAC,gBAAgB;QAClC,iBAAiB,CAAC,WAAW;QAC7B,iBAAiB,CAAC,cAAc;QAChC,iBAAiB,CAAC,OAAO;KAC1B;CACF,CAAC;AAEF,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAE9E,MAAM,UAAU,kBAAkB,CAAC,QAAkC;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvF,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAkC,EAAE,CAAC,CACzF,OAAO,SAAS,KAAK,QAAQ,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CACpE,CAAC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/esm/usage-granularity/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/usage-granularity/types.js.map

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

package/dist/esm/usage-granularity/usage-granularity.js

@@ -0,0 +1,60 @@
+import { USAGE_GRANULARITY_HOURS, USAGE_HOUR_MS } from './constants';
+export function isUsageGranularityHours(value) {
+    return typeof value === 'number' && USAGE_GRANULARITY_HOURS.some(hours => hours === value);
+}
+export function getCompatibleUsageGranularity(hours) {
+    const compatible = USAGE_GRANULARITY_HOURS.find(candidate => hours.every(value => candidate % value === 0));
+    if (compatible === undefined)
+        throw new Error('No compatible usage granularity');
+    return compatible;
+}
+export function getUsageSlotStart(date, hours) {
+    const time = date.getTime();
+    if (!Number.isFinite(time) || !isUsageGranularityHours(hours)) {
+        throw new Error('Invalid usage slot date or granularity');
+    }
+    const duration = hours * USAGE_HOUR_MS;
+    return new Date(Math.floor(time / duration) * duration);
+}
+export function resolveUsageGranularity(state, now) {
+    if (!Number.isFinite(now.getTime()))
+        throw new Error('Invalid usage granularity date');
+    if (state.pendingGranularityHours !== null &&
+        state.granularityEffectiveAt !== null &&
+        new Date(state.granularityEffectiveAt).getTime() <= now.getTime()) {
+        return {
+            granularityHours: state.pendingGranularityHours,
+            pendingGranularityHours: null,
+            granularityEffectiveAt: null,
+        };
+    }
+    return {
+        granularityHours: state.granularityHours,
+        pendingGranularityHours: state.pendingGranularityHours,
+        granularityEffectiveAt: state.granularityEffectiveAt,
+    };
+}
+export function scheduleUsageGranularity(state, requested, now) {
+    const current = resolveUsageGranularity(state, now);
+    if (requested === undefined)
+        return current;
+    if (!isUsageGranularityHours(requested))
+        throw new Error('Invalid usage granularity');
+    if (requested === current.granularityHours) {
+        return {
+            granularityHours: requested,
+            pendingGranularityHours: null,
+            granularityEffectiveAt: null,
+        };
+    }
+    if (requested === current.pendingGranularityHours)
+        return current;
+    const sharedHours = getCompatibleUsageGranularity([current.granularityHours, requested]);
+    const boundary = getUsageSlotStart(now, sharedHours);
+    return {
+        granularityHours: current.granularityHours,
+        pendingGranularityHours: requested,
+        granularityEffectiveAt: new Date(boundary.getTime() + sharedHours * USAGE_HOUR_MS),
+    };
+}
+//# sourceMappingURL=usage-granularity.js.map

package/dist/esm/usage-granularity/usage-granularity.js.map

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

package/dist/types/billing-boundaries/index.d.ts

@@ -0,0 +1,6 @@
+import type { BillingDateIssue, BillingDateValidationOptions } from './types';
+export declare function isUtcMidnight(value: unknown): value is Date;
+export declare function isUtcInclusiveDateEnd(value: unknown): value is Date;
+export declare function toExclusiveUtcDateEnd(value: Date): Date;
+export declare function getUtcBillingDateIssues(startDate: unknown, endDate: unknown, options?: BillingDateValidationOptions): BillingDateIssue[];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/billing-boundaries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/billing-boundaries/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAI9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAE3D;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAKnE;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAKvD;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,4BAAiC,GACzC,gBAAgB,EAAE,CAuBpB"}

package/dist/types/billing-boundaries/types.d.ts

@@ -0,0 +1,9 @@
+export interface BillingDateIssue {
+    path: string;
+    constraints: Record<string, string>;
+}
+export interface BillingDateValidationOptions {
+    allowOpenEnd?: boolean;
+    pathPrefix?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/billing-boundaries/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/billing-boundaries/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/index.d.ts

@@ -2,4 +2,6 @@ export * from './enums';
 export * from './constants';
 export * from './types';
 export * from './utils';
+export * from './usage-granularity';
+export * from './billing-boundaries';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/types/usage-granularity/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const USAGE_GRANULARITY_HOURS: readonly [1, 2, 3, 4, 6, 8, 12, 24];
+export declare const DEFAULT_USAGE_GRANULARITY_HOURS = 1;
+export declare const USAGE_HOUR_MS = 3600000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/usage-granularity/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,qCAAsC,CAAC;AAE3E,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,eAAO,MAAM,aAAa,UAAU,CAAC"}

package/dist/types/usage-granularity/index.d.ts

@@ -0,0 +1,7 @@
+export * from './constants';
+export * from './types';
+export * from './usage-granularity';
+export * from './source-event-policy';
+export * from './reporting.types';
+export * from './metric-policy';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/usage-granularity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/types/usage-granularity/metric-policy.d.ts

@@ -0,0 +1,4 @@
+import { CategoryNamespace } from '../enums/category-namespace';
+export declare function supportsCoarseUsageCollection(provider: string, eventType: CategoryNamespace): boolean;
+export declare function assertUsageCollectionMetric(provider: string, eventType: CategoryNamespace, hours: number): void;
+//# sourceMappingURL=metric-policy.d.ts.map

package/dist/types/usage-granularity/metric-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-policy.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/metric-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AA+BhE,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAGrG;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI/G"}

package/dist/types/usage-granularity/reporting.types.d.ts

@@ -0,0 +1,14 @@
+import type { UsageGranularityHours } from './types';
+export type UsageResolutionAdjustment = 'granularityExpanded' | 'rangeExpanded' | 'unknownCoverage' | 'providerOverlapExcluded';
+export interface UsageResolutionMetadata {
+    requestedGranularityHours: UsageGranularityHours;
+    effectiveGranularityHours: UsageGranularityHours;
+    requestedDateFrom: string;
+    requestedDateTo: string;
+    effectiveDateFrom: string;
+    effectiveDateTo: string;
+    adjustments: UsageResolutionAdjustment[];
+    coverageStatus: 'known' | 'partial' | 'unknown';
+    coverageVersion: string;
+}
+//# sourceMappingURL=reporting.types.d.ts.map

package/dist/types/usage-granularity/reporting.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting.types.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/reporting.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,GAAG,eAAe,GAAG,iBAAiB,GAAG,yBAAyB,CAAC;AAEhI,MAAM,WAAW,uBAAuB;IACtC,yBAAyB,EAAE,qBAAqB,CAAC;IACjD,yBAAyB,EAAE,qBAAqB,CAAC;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,yBAAyB,EAAE,CAAC;IACzC,cAAc,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/types/usage-granularity/source-event-policy.d.ts

@@ -0,0 +1,7 @@
+import { CategoryNamespace } from '../enums/category-namespace';
+export declare const DB_EVENT_TYPE_MAP: {
+    azure: CategoryNamespace[];
+    druid: CategoryNamespace[];
+};
+export declare function getDruidEventTypes(metadata?: Record<string, unknown>): CategoryNamespace[];
+//# sourceMappingURL=source-event-policy.d.ts.map

package/dist/types/usage-granularity/source-event-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-event-policy.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/source-event-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,eAAO,MAAM,iBAAiB;;;CA4B7B,CAAC;AAIF,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,EAAE,CAS1F"}

package/dist/types/usage-granularity/types.d.ts

@@ -0,0 +1,8 @@
+import type { USAGE_GRANULARITY_HOURS } from './constants';
+export type UsageGranularityHours = typeof USAGE_GRANULARITY_HOURS[number];
+export type UsageGranularityState = {
+    granularityHours: UsageGranularityHours;
+    pendingGranularityHours: UsageGranularityHours | null;
+    granularityEffectiveAt: Date | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/usage-granularity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,MAAM,qBAAqB,GAAG,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAE3E,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,uBAAuB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACtD,sBAAsB,EAAE,IAAI,GAAG,IAAI,CAAC;CACrC,CAAC"}

package/dist/types/usage-granularity/usage-granularity.d.ts

@@ -0,0 +1,7 @@
+import type { UsageGranularityHours, UsageGranularityState } from './types';
+export declare function isUsageGranularityHours(value: unknown): value is UsageGranularityHours;
+export declare function getCompatibleUsageGranularity(hours: readonly UsageGranularityHours[]): UsageGranularityHours;
+export declare function getUsageSlotStart(date: Date, hours: UsageGranularityHours): Date;
+export declare function resolveUsageGranularity(state: UsageGranularityState, now: Date): UsageGranularityState;
+export declare function scheduleUsageGranularity(state: UsageGranularityState, requested: UsageGranularityHours | undefined, now: Date): UsageGranularityState;
+//# sourceMappingURL=usage-granularity.d.ts.map

package/dist/types/usage-granularity/usage-granularity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-granularity.d.ts","sourceRoot":"","sources":["../../../src/usage-granularity/usage-granularity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE5E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,SAAS,qBAAqB,EAAE,GACtC,qBAAqB,CAIvB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAOhF;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,IAAI,GACR,qBAAqB,CAkBvB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAC5C,GAAG,EAAE,IAAI,GACR,qBAAqB,CAoBvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onereach/billing-shared",
-  "version": "31.17.0",
+  "version": "31.17.1-beta.13420.0",
   "license": "Apache-2.0",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/billing-boundaries/index.ts

@@ -0,0 +1,52 @@
+import type { BillingDateIssue, BillingDateValidationOptions } from './types';
+
+const UTC_DAY_MS = 24 * 60 * 60 * 1000;
+
+export function isUtcMidnight(value: unknown): value is Date {
+  return value instanceof Date && Number.isFinite(value.getTime()) && value.getTime() % UTC_DAY_MS === 0;
+}
+
+/** Inclusive calendar ends accept the API's date-only and UTC end-of-day conventions. */
+export function isUtcInclusiveDateEnd(value: unknown): value is Date {
+  if (!(value instanceof Date) || !Number.isFinite(value.getTime())) return false;
+  const time = value.getTime();
+  return (isUtcMidnight(value) || (time + 1) % UTC_DAY_MS === 0)
+    && Number.isFinite(new Date(Math.floor(time / UTC_DAY_MS) * UTC_DAY_MS + UTC_DAY_MS).getTime());
+}
+
+/** Convert an inclusive UTC calendar end to the next midnight, without changing stored dates. */
+export function toExclusiveUtcDateEnd(value: Date): Date {
+  if (!isUtcInclusiveDateEnd(value)) {
+    throw new RangeError('Billing end date must be a UTC calendar date or UTC end of day');
+  }
+  return new Date(Math.floor(value.getTime() / UTC_DAY_MS) * UTC_DAY_MS + UTC_DAY_MS);
+}
+
+export function getUtcBillingDateIssues(
+  startDate: unknown,
+  endDate: unknown,
+  options: BillingDateValidationOptions = {},
+): BillingDateIssue[] {
+  const issues: BillingDateIssue[] = [];
+  const prefix = options.pathPrefix ? `${options.pathPrefix}.` : '';
+  if (!isUtcMidnight(startDate)) {
+    issues.push({
+      path: `${prefix}startDate`,
+      constraints: { utcMidnight: 'Start date must be a valid date at midnight UTC' },
+    });
+  }
+  const openEnd = options.allowOpenEnd && (endDate === null || endDate === undefined);
+  if (!openEnd && !isUtcInclusiveDateEnd(endDate)) {
+    issues.push({
+      path: `${prefix}endDate`,
+      constraints: { utcCalendarEnd: 'End date must be a valid UTC calendar date at midnight or 23:59:59.999 UTC (inclusive)' },
+    });
+  }
+  if (isUtcMidnight(startDate) && isUtcInclusiveDateEnd(endDate) && toExclusiveUtcDateEnd(endDate) <= startDate) {
+    issues.push({
+      path: `${prefix}endDate`,
+      constraints: { minDate: 'End date must not be before the start date' },
+    });
+  }
+  return issues;
+}

package/src/billing-boundaries/types.ts

@@ -0,0 +1,9 @@
+export interface BillingDateIssue {
+  path: string;
+  constraints: Record<string, string>;
+}
+
+export interface BillingDateValidationOptions {
+  allowOpenEnd?: boolean;
+  pathPrefix?: string;
+}

package/src/index.ts

@@ -2,3 +2,5 @@ export * from './enums';
 export * from './constants';
 export * from './types';
 export * from './utils';
+export * from './usage-granularity';
+export * from './billing-boundaries';

package/src/usage-granularity/constants.ts

@@ -0,0 +1,5 @@
+export const USAGE_GRANULARITY_HOURS = [1, 2, 3, 4, 6, 8, 12, 24] as const;
+
+export const DEFAULT_USAGE_GRANULARITY_HOURS = 1;
+
+export const USAGE_HOUR_MS = 3600000;

package/src/usage-granularity/index.ts

@@ -0,0 +1,6 @@
+export * from './constants';
+export * from './types';
+export * from './usage-granularity';
+export * from './source-event-policy';
+export * from './reporting.types';
+export * from './metric-policy';

package/src/usage-granularity/metric-policy.ts

@@ -0,0 +1,41 @@
+import { CategoryNamespace } from '../enums/category-namespace';
+import { DataSourceProvider } from '../enums/customer-usage';
+
+const COARSE_EVENTS: Record<DataSourceProvider.AZURE | DataSourceProvider.DRUID, readonly CategoryNamespace[]> = {
+  [DataSourceProvider.AZURE]: [
+    CategoryNamespace.PROCESSING_FLOW,
+    CategoryNamespace.PROCESSING_VOICE,
+    CategoryNamespace.EXECUTABLE_GENERAL,
+    CategoryNamespace.EXECUTABLE_PORT_IN_IDENTIFIER,
+    CategoryNamespace.LOOKUP,
+    CategoryNamespace.TELEPHONY_VOICE,
+    CategoryNamespace.MESSAGING_TEXT,
+    CategoryNamespace.CONVERSATIONS_WAP,
+    CategoryNamespace.CARRIER_FEE,
+    CategoryNamespace.USER,
+    CategoryNamespace.IDENTIFIER,
+    CategoryNamespace.STORAGE_GENERAL,
+    CategoryNamespace.STORAGE_WEAVIATE,
+  ],
+  [DataSourceProvider.DRUID]: [
+    CategoryNamespace.EXECUTABLE_LLM,
+    CategoryNamespace.EXECUTABLE_GENERAL,
+    CategoryNamespace.STORAGE_WEAVIATE,
+    CategoryNamespace.LOOKUP,
+    CategoryNamespace.TELEPHONY_VOICE,
+    CategoryNamespace.PROCESSING_VOICE,
+    CategoryNamespace.CARRIER_FEE,
+    CategoryNamespace.MESSAGING_TEXT,
+  ],
+};
+
+export function supportsCoarseUsageCollection(provider: string, eventType: CategoryNamespace): boolean {
+  if (provider !== DataSourceProvider.AZURE && provider !== DataSourceProvider.DRUID) return false;
+  return COARSE_EVENTS[provider].includes(eventType);
+}
+
+export function assertUsageCollectionMetric(provider: string, eventType: CategoryNamespace, hours: number): void {
+  if (hours > 1 && !supportsCoarseUsageCollection(provider, eventType)) {
+    throw new Error(`Coarse collection is not verified for ${provider}/${eventType}; use 1h granularity`);
+  }
+}

package/src/usage-granularity/reporting.types.ts

@@ -0,0 +1,15 @@
+import type { UsageGranularityHours } from './types';
+
+export type UsageResolutionAdjustment = 'granularityExpanded' | 'rangeExpanded' | 'unknownCoverage' | 'providerOverlapExcluded';
+
+export interface UsageResolutionMetadata {
+  requestedGranularityHours: UsageGranularityHours;
+  effectiveGranularityHours: UsageGranularityHours;
+  requestedDateFrom: string;
+  requestedDateTo: string;
+  effectiveDateFrom: string;
+  effectiveDateTo: string;
+  adjustments: UsageResolutionAdjustment[];
+  coverageStatus: 'known' | 'partial' | 'unknown';
+  coverageVersion: string;
+}

package/src/usage-granularity/source-event-policy.ts

@@ -0,0 +1,45 @@
+import { CategoryNamespace } from '../enums/category-namespace';
+import { DataSourceProvider } from '../enums/customer-usage';
+
+export const DB_EVENT_TYPE_MAP = {
+  [DataSourceProvider.AZURE]: [
+    CategoryNamespace.PROCESSING_FLOW,
+    CategoryNamespace.PROCESSING_VOICE,
+    CategoryNamespace.EXECUTABLE_GENERAL,
+    CategoryNamespace.EXECUTABLE_PORT_IN_IDENTIFIER,
+    CategoryNamespace.LOOKUP,
+    CategoryNamespace.TELEPHONY_VOICE,
+    CategoryNamespace.MESSAGING_TEXT,
+    CategoryNamespace.CONVERSATIONS_WAP,
+    CategoryNamespace.CARRIER_FEE,
+    CategoryNamespace.STORAGE_GENERAL,
+    CategoryNamespace.STORAGE_WEAVIATE,
+    CategoryNamespace.IDENTIFIER,
+    CategoryNamespace.USER,
+    CategoryNamespace.PRODUCT,
+  ],
+  [DataSourceProvider.DRUID]: [
+    CategoryNamespace.EXECUTABLE_LLM,
+    CategoryNamespace.EXECUTABLE_GENERAL,
+    CategoryNamespace.STORAGE_WEAVIATE,
+    CategoryNamespace.LOOKUP,
+    CategoryNamespace.TELEPHONY_VOICE,
+    CategoryNamespace.PROCESSING_VOICE,
+    CategoryNamespace.CARRIER_FEE,
+    CategoryNamespace.MESSAGING_TEXT,
+    CategoryNamespace.PRODUCT,
+  ],
+};
+
+const CATEGORY_NAMESPACES = new Set<string>(Object.values(CategoryNamespace));
+
+export function getDruidEventTypes(metadata?: Record<string, unknown>): CategoryNamespace[] {
+  if (!Array.isArray(metadata?.tables)) return [];
+  const eventTypes = metadata.tables.flatMap(table => {
+    if (typeof table !== 'object' || table === null || !('eventTypes' in table)) return [];
+    return Array.isArray(table.eventTypes) ? table.eventTypes : [];
+  });
+  return Array.from(new Set(eventTypes.filter((eventType): eventType is CategoryNamespace => (
+    typeof eventType === 'string' && CATEGORY_NAMESPACES.has(eventType)
+  ))));
+}

package/src/usage-granularity/types.ts

@@ -0,0 +1,9 @@
+import type { USAGE_GRANULARITY_HOURS } from './constants';
+
+export type UsageGranularityHours = typeof USAGE_GRANULARITY_HOURS[number];
+
+export type UsageGranularityState = {
+  granularityHours: UsageGranularityHours;
+  pendingGranularityHours: UsageGranularityHours | null;
+  granularityEffectiveAt: Date | null;
+};

package/src/usage-granularity/usage-granularity.ts

@@ -0,0 +1,72 @@
+import { USAGE_GRANULARITY_HOURS, USAGE_HOUR_MS } from './constants';
+import type { UsageGranularityHours, UsageGranularityState } from './types';
+
+export function isUsageGranularityHours(value: unknown): value is UsageGranularityHours {
+  return typeof value === 'number' && USAGE_GRANULARITY_HOURS.some(hours => hours === value);
+}
+
+export function getCompatibleUsageGranularity(
+  hours: readonly UsageGranularityHours[],
+): UsageGranularityHours {
+  const compatible = USAGE_GRANULARITY_HOURS.find(candidate => hours.every(value => candidate % value === 0));
+  if (compatible === undefined) throw new Error('No compatible usage granularity');
+  return compatible;
+}
+
+export function getUsageSlotStart(date: Date, hours: UsageGranularityHours): Date {
+  const time = date.getTime();
+  if (!Number.isFinite(time) || !isUsageGranularityHours(hours)) {
+    throw new Error('Invalid usage slot date or granularity');
+  }
+  const duration = hours * USAGE_HOUR_MS;
+  return new Date(Math.floor(time / duration) * duration);
+}
+
+export function resolveUsageGranularity(
+  state: UsageGranularityState,
+  now: Date,
+): UsageGranularityState {
+  if (!Number.isFinite(now.getTime())) throw new Error('Invalid usage granularity date');
+  if (
+    state.pendingGranularityHours !== null &&
+    state.granularityEffectiveAt !== null &&
+    new Date(state.granularityEffectiveAt).getTime() <= now.getTime()
+  ) {
+    return {
+      granularityHours: state.pendingGranularityHours,
+      pendingGranularityHours: null,
+      granularityEffectiveAt: null,
+    };
+  }
+  return {
+    granularityHours: state.granularityHours,
+    pendingGranularityHours: state.pendingGranularityHours,
+    granularityEffectiveAt: state.granularityEffectiveAt,
+  };
+}
+
+export function scheduleUsageGranularity(
+  state: UsageGranularityState,
+  requested: UsageGranularityHours | undefined,
+  now: Date,
+): UsageGranularityState {
+  const current = resolveUsageGranularity(state, now);
+  if (requested === undefined) return current;
+  if (!isUsageGranularityHours(requested)) throw new Error('Invalid usage granularity');
+  if (requested === current.granularityHours) {
+    return {
+      granularityHours: requested,
+      pendingGranularityHours: null,
+      granularityEffectiveAt: null,
+    };
+  }
+  if (requested === current.pendingGranularityHours) return current;
+
+  const sharedHours = getCompatibleUsageGranularity([current.granularityHours, requested]);
+  const boundary = getUsageSlotStart(now, sharedHours);
+  return {
+    granularityHours: current.granularityHours,
+    pendingGranularityHours: requested,
+    granularityEffectiveAt: new Date(boundary.getTime() + sharedHours * USAGE_HOUR_MS),
+  };
+}