@infinitetoken/lumber-kit 0.6.0 → 0.8.0

package/dist/index.js

@@ -22,12 +22,16 @@ var index_exports = {};
 __export(index_exports, {
   APP_COLORS: () => APP_COLORS,
   DEFAULT_ACCENT: () => DEFAULT_ACCENT,
+  DEFAULT_API_ENDPOINT: () => DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD: () => DEFAULT_PUSH_THRESHOLD,
+  DEFAULT_TIME_FORMAT: () => DEFAULT_TIME_FORMAT,
+  LOG_KEY_VERSION: () => LOG_KEY_VERSION,
   LogLevel: () => LogLevel,
   PUSH_OFF: () => PUSH_OFF,
   SubscriptionLevel: () => SubscriptionLevel,
   apiErrorCodeOf: () => apiErrorCodeOf,
   apiErrorCodes: () => apiErrorCodes,
+  buildLogPayload: () => buildLogPayload,
   isApiErrorCode: () => isApiErrorCode,
   isValidAppearance: () => isValidAppearance,
   isValidColor: () => isValidColor,
@@ -36,13 +40,18 @@ __export(index_exports, {
   isValidLogLevel: () => isValidLogLevel,
   isValidSubscriptionLevel: () => isValidSubscriptionLevel,
   isValidTeamMemberRole: () => isValidTeamMemberRole,
+  isValidTimeFormat: () => isValidTimeFormat,
   joinApiKey: () => joinApiKey,
+  logDelivery: () => logDelivery,
+  logDeliveryOutcome: () => logDeliveryOutcome,
   logLevelColors: () => logLevelColors,
   logLevelNameToLevel: () => logLevelNameToLevel,
   logLevelToName: () => logLevelToName,
   logLevels: () => logLevels,
+  logRetryDelayMs: () => logRetryDelayMs,
   nameColor: () => nameColor,
   normalizePushThreshold: () => normalizePushThreshold,
+  normalizeTimeFormat: () => normalizeTimeFormat,
   parsePushData: () => parsePushData,
   personColor: () => personColor,
   resolveAppColor: () => resolveAppColor,
@@ -55,13 +64,13 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/constants/logLevel.ts
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2[LogLevel2["Debug"] = 0] = "Debug";
-  LogLevel2[LogLevel2["Info"] = 1] = "Info";
-  LogLevel2[LogLevel2["Warn"] = 2] = "Warn";
-  LogLevel2[LogLevel2["Error"] = 3] = "Error";
-  LogLevel2[LogLevel2["Fatal"] = 4] = "Fatal";
-  return LogLevel2;
+var LogLevel = /* @__PURE__ */ ((LogLevel3) => {
+  LogLevel3[LogLevel3["Debug"] = 0] = "Debug";
+  LogLevel3[LogLevel3["Info"] = 1] = "Info";
+  LogLevel3[LogLevel3["Warn"] = 2] = "Warn";
+  LogLevel3[LogLevel3["Error"] = 3] = "Error";
+  LogLevel3[LogLevel3["Fatal"] = 4] = "Fatal";
+  return LogLevel3;
 })(LogLevel || {});
 var logLevelToName = {
   [0 /* Debug */]: "debug",
@@ -108,9 +117,20 @@ var apiErrorCodes = [
   "HAS_ACCOUNT"
 ];
 
+// src/constants/ingest.ts
+var DEFAULT_API_ENDPOINT = "https://api.lumber.infinitetoken.com";
+var LOG_KEY_VERSION = 1;
+var logDelivery = {
+  maxAttempts: 5,
+  baseDelayMs: 1e3,
+  maxDelayMs: 3e4,
+  pauseMs: 60 * 60 * 1e3
+};
+
 // src/constants/notifications.ts
 var PUSH_OFF = 5;
 var DEFAULT_PUSH_THRESHOLD = 2 /* Warn */;
+var DEFAULT_TIME_FORMAT = { clock: "24h", zone: "local" };
 
 // src/constants/subscription.ts
 var SubscriptionLevel = /* @__PURE__ */ ((SubscriptionLevel3) => {
@@ -140,9 +160,46 @@ var subscriptionPlans = {
   [3 /* Enterprise */]: { name: "Enterprise", monthlyPrice: null }
 };
 
+// src/utils/ingest.ts
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var buildLogPayload = (level, message, data, autoContext) => {
+  const { requestId, traceId, context: givenContext, metadata: givenMetadata, ...rest } = data ?? {};
+  const context = isRecord(givenContext) ? givenContext : void 0;
+  const metadata = isRecord(givenMetadata) ? givenMetadata : void 0;
+  if (givenContext != null && !context) rest.context = givenContext;
+  if (givenMetadata != null && !metadata) rest.metadata = givenMetadata;
+  const mergedMetadata = Object.keys(rest).length > 0 ? { ...rest, ...metadata ?? {} } : metadata;
+  const mergedContext = autoContext && Object.keys(autoContext).length > 0 ? { ...autoContext, ...context ?? {} } : context;
+  const payload = { level, message };
+  if (requestId !== void 0) payload.requestId = requestId;
+  if (traceId !== void 0) payload.traceId = traceId;
+  if (mergedContext !== void 0) payload.context = mergedContext;
+  if (mergedMetadata !== void 0) payload.metadata = mergedMetadata;
+  return payload;
+};
+var logDeliveryOutcome = (status) => {
+  if (status === null) return "retry";
+  if (status >= 200 && status < 300) return "sent";
+  if (status === 429) return "pause";
+  if (status >= 400 && status < 500) return "drop";
+  return "retry";
+};
+var logRetryDelayMs = (failedAttempts) => Math.min(logDelivery.baseDelayMs * 2 ** Math.max(0, failedAttempts - 1), logDelivery.maxDelayMs);
+
 // src/utils/index.ts
 var appearanceValues = ["system", "dark", "light"];
 var isValidAppearance = (value) => appearanceValues.includes(value);
+var timeClocks = ["24h", "12h"];
+var timeZoneChoices = ["local", "utc"];
+var isValidTimeFormat = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const { clock, zone, ...rest } = value;
+  return timeClocks.includes(clock) && timeZoneChoices.includes(zone) && Object.keys(rest).length === 0;
+};
+var normalizeTimeFormat = (value) => {
+  const { clock, zone } = value && typeof value === "object" ? value : {};
+  return { clock: timeClocks.includes(clock) ? clock : DEFAULT_TIME_FORMAT.clock, zone: timeZoneChoices.includes(zone) ? zone : DEFAULT_TIME_FORMAT.zone };
+};
 var isValidColor = (value) => /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(value);
 var hashName = (name) => {
   let hash = 2166136261;
@@ -215,12 +272,16 @@ var parsePushData = (data) => {
 0 && (module.exports = {
   APP_COLORS,
   DEFAULT_ACCENT,
+  DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD,
+  DEFAULT_TIME_FORMAT,
+  LOG_KEY_VERSION,
   LogLevel,
   PUSH_OFF,
   SubscriptionLevel,
   apiErrorCodeOf,
   apiErrorCodes,
+  buildLogPayload,
   isApiErrorCode,
   isValidAppearance,
   isValidColor,
@@ -229,13 +290,18 @@ var parsePushData = (data) => {
   isValidLogLevel,
   isValidSubscriptionLevel,
   isValidTeamMemberRole,
+  isValidTimeFormat,
   joinApiKey,
+  logDelivery,
+  logDeliveryOutcome,
   logLevelColors,
   logLevelNameToLevel,
   logLevelToName,
   logLevels,
+  logRetryDelayMs,
   nameColor,
   normalizePushThreshold,
+  normalizeTimeFormat,
   parsePushData,
   personColor,
   resolveAppColor,

package/dist/index.mjs

@@ -1,11 +1,11 @@
 // src/constants/logLevel.ts
-var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
-  LogLevel2[LogLevel2["Debug"] = 0] = "Debug";
-  LogLevel2[LogLevel2["Info"] = 1] = "Info";
-  LogLevel2[LogLevel2["Warn"] = 2] = "Warn";
-  LogLevel2[LogLevel2["Error"] = 3] = "Error";
-  LogLevel2[LogLevel2["Fatal"] = 4] = "Fatal";
-  return LogLevel2;
+var LogLevel = /* @__PURE__ */ ((LogLevel3) => {
+  LogLevel3[LogLevel3["Debug"] = 0] = "Debug";
+  LogLevel3[LogLevel3["Info"] = 1] = "Info";
+  LogLevel3[LogLevel3["Warn"] = 2] = "Warn";
+  LogLevel3[LogLevel3["Error"] = 3] = "Error";
+  LogLevel3[LogLevel3["Fatal"] = 4] = "Fatal";
+  return LogLevel3;
 })(LogLevel || {});
 var logLevelToName = {
   [0 /* Debug */]: "debug",
@@ -52,9 +52,20 @@ var apiErrorCodes = [
   "HAS_ACCOUNT"
 ];
 
+// src/constants/ingest.ts
+var DEFAULT_API_ENDPOINT = "https://api.lumber.infinitetoken.com";
+var LOG_KEY_VERSION = 1;
+var logDelivery = {
+  maxAttempts: 5,
+  baseDelayMs: 1e3,
+  maxDelayMs: 3e4,
+  pauseMs: 60 * 60 * 1e3
+};
+
 // src/constants/notifications.ts
 var PUSH_OFF = 5;
 var DEFAULT_PUSH_THRESHOLD = 2 /* Warn */;
+var DEFAULT_TIME_FORMAT = { clock: "24h", zone: "local" };
 
 // src/constants/subscription.ts
 var SubscriptionLevel = /* @__PURE__ */ ((SubscriptionLevel3) => {
@@ -84,9 +95,46 @@ var subscriptionPlans = {
   [3 /* Enterprise */]: { name: "Enterprise", monthlyPrice: null }
 };
 
+// src/utils/ingest.ts
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var buildLogPayload = (level, message, data, autoContext) => {
+  const { requestId, traceId, context: givenContext, metadata: givenMetadata, ...rest } = data ?? {};
+  const context = isRecord(givenContext) ? givenContext : void 0;
+  const metadata = isRecord(givenMetadata) ? givenMetadata : void 0;
+  if (givenContext != null && !context) rest.context = givenContext;
+  if (givenMetadata != null && !metadata) rest.metadata = givenMetadata;
+  const mergedMetadata = Object.keys(rest).length > 0 ? { ...rest, ...metadata ?? {} } : metadata;
+  const mergedContext = autoContext && Object.keys(autoContext).length > 0 ? { ...autoContext, ...context ?? {} } : context;
+  const payload = { level, message };
+  if (requestId !== void 0) payload.requestId = requestId;
+  if (traceId !== void 0) payload.traceId = traceId;
+  if (mergedContext !== void 0) payload.context = mergedContext;
+  if (mergedMetadata !== void 0) payload.metadata = mergedMetadata;
+  return payload;
+};
+var logDeliveryOutcome = (status) => {
+  if (status === null) return "retry";
+  if (status >= 200 && status < 300) return "sent";
+  if (status === 429) return "pause";
+  if (status >= 400 && status < 500) return "drop";
+  return "retry";
+};
+var logRetryDelayMs = (failedAttempts) => Math.min(logDelivery.baseDelayMs * 2 ** Math.max(0, failedAttempts - 1), logDelivery.maxDelayMs);
+
 // src/utils/index.ts
 var appearanceValues = ["system", "dark", "light"];
 var isValidAppearance = (value) => appearanceValues.includes(value);
+var timeClocks = ["24h", "12h"];
+var timeZoneChoices = ["local", "utc"];
+var isValidTimeFormat = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const { clock, zone, ...rest } = value;
+  return timeClocks.includes(clock) && timeZoneChoices.includes(zone) && Object.keys(rest).length === 0;
+};
+var normalizeTimeFormat = (value) => {
+  const { clock, zone } = value && typeof value === "object" ? value : {};
+  return { clock: timeClocks.includes(clock) ? clock : DEFAULT_TIME_FORMAT.clock, zone: timeZoneChoices.includes(zone) ? zone : DEFAULT_TIME_FORMAT.zone };
+};
 var isValidColor = (value) => /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(value);
 var hashName = (name) => {
   let hash = 2166136261;
@@ -158,12 +206,16 @@ var parsePushData = (data) => {
 export {
   APP_COLORS,
   DEFAULT_ACCENT,
+  DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD,
+  DEFAULT_TIME_FORMAT,
+  LOG_KEY_VERSION,
   LogLevel,
   PUSH_OFF,
   SubscriptionLevel,
   apiErrorCodeOf,
   apiErrorCodes,
+  buildLogPayload,
   isApiErrorCode,
   isValidAppearance,
   isValidColor,
@@ -172,13 +224,18 @@ export {
   isValidLogLevel,
   isValidSubscriptionLevel,
   isValidTeamMemberRole,
+  isValidTimeFormat,
   joinApiKey,
+  logDelivery,
+  logDeliveryOutcome,
   logLevelColors,
   logLevelNameToLevel,
   logLevelToName,
   logLevels,
+  logRetryDelayMs,
   nameColor,
   normalizePushThreshold,
+  normalizeTimeFormat,
   parsePushData,
   personColor,
   resolveAppColor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infinitetoken/lumber-kit",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Shared TypeScript types and wire format contracts for the Lumber cloud logging suite",
   "keywords": [
     "lumber",
@@ -31,17 +31,20 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
-    }
+    },
+    "./contract/*": "./contract/*"
   },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "contract"
   ],
   "scripts": {
     "build": "tsup",
     "clean": "rm -rf dist coverage",
+    "contract": "node scripts/contract.cjs",
     "fix": "eslint . --fix",
     "lint": "eslint .",
     "prepublishOnly": "npm run build",
@@ -61,9 +64,11 @@
     "@infinitetoken/tsconfig": "^0.6.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.0",
+    "ajv": "^8.20.0",
     "eslint": "^10.2.1",
     "jest": "^30.4.2",
     "prettier": "^3.8.3",
+    "ts-json-schema-generator": "^2.9.0",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3"
   },