@infinitetoken/lumber-kit 0.5.2 → 0.7.0

package/dist/index.js

@@ -22,12 +22,15 @@ 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,
+  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,
@@ -37,10 +40,13 @@ __export(index_exports, {
   isValidSubscriptionLevel: () => isValidSubscriptionLevel,
   isValidTeamMemberRole: () => isValidTeamMemberRole,
   joinApiKey: () => joinApiKey,
+  logDelivery: () => logDelivery,
+  logDeliveryOutcome: () => logDeliveryOutcome,
   logLevelColors: () => logLevelColors,
   logLevelNameToLevel: () => logLevelNameToLevel,
   logLevelToName: () => logLevelToName,
   logLevels: () => logLevels,
+  logRetryDelayMs: () => logRetryDelayMs,
   nameColor: () => nameColor,
   normalizePushThreshold: () => normalizePushThreshold,
   parsePushData: () => parsePushData,
@@ -55,13 +61,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,6 +114,16 @@ 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 */;
@@ -140,6 +156,32 @@ 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);
@@ -157,7 +199,7 @@ var resolveAppColor = (name, color) => color && isValidColor(color) ? color : na
 var personColor = (userId) => nameColor(userId);
 var isValidLogLevel = (value) => logLevels.includes(value);
 var isValidSubscriptionLevel = (value) => subscriptionLevels.includes(value);
-var deviceLinkStatuses = ["pending", "approved", "denied"];
+var deviceLinkStatuses = ["pending", "approved", "denied", "failed"];
 var isValidDeviceLinkStatus = (value) => deviceLinkStatuses.includes(value);
 var teamMemberRoles = ["owner", "admin", "member"];
 var isValidTeamMemberRole = (value) => teamMemberRoles.includes(value);
@@ -199,7 +241,8 @@ var parsePushData = (data) => {
     case "note":
       return isId(d.appId) && isId(d.noteId) ? { type: "note", appId: d.appId, noteId: d.noteId } : null;
     case "device_link":
-      return isId(d.deviceLinkId) ? { type: "device_link", deviceLinkId: d.deviceLinkId, deviceName: typeof d.deviceName === "string" ? d.deviceName : "" } : null;
+    case "device_link_answered":
+      return isId(d.deviceLinkId) ? { type: d.type, deviceLinkId: d.deviceLinkId, deviceName: typeof d.deviceName === "string" ? d.deviceName : "" } : null;
     case "key_check":
       return isId(d.checkId) ? { type: "key_check", checkId: d.checkId } : null;
     case "key_waiting":
@@ -214,12 +257,15 @@ var parsePushData = (data) => {
 0 && (module.exports = {
   APP_COLORS,
   DEFAULT_ACCENT,
+  DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD,
+  LOG_KEY_VERSION,
   LogLevel,
   PUSH_OFF,
   SubscriptionLevel,
   apiErrorCodeOf,
   apiErrorCodes,
+  buildLogPayload,
   isApiErrorCode,
   isValidAppearance,
   isValidColor,
@@ -229,10 +275,13 @@ var parsePushData = (data) => {
   isValidSubscriptionLevel,
   isValidTeamMemberRole,
   joinApiKey,
+  logDelivery,
+  logDeliveryOutcome,
   logLevelColors,
   logLevelNameToLevel,
   logLevelToName,
   logLevels,
+  logRetryDelayMs,
   nameColor,
   normalizePushThreshold,
   parsePushData,

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,6 +52,16 @@ 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 */;
@@ -84,6 +94,32 @@ 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);
@@ -101,7 +137,7 @@ var resolveAppColor = (name, color) => color && isValidColor(color) ? color : na
 var personColor = (userId) => nameColor(userId);
 var isValidLogLevel = (value) => logLevels.includes(value);
 var isValidSubscriptionLevel = (value) => subscriptionLevels.includes(value);
-var deviceLinkStatuses = ["pending", "approved", "denied"];
+var deviceLinkStatuses = ["pending", "approved", "denied", "failed"];
 var isValidDeviceLinkStatus = (value) => deviceLinkStatuses.includes(value);
 var teamMemberRoles = ["owner", "admin", "member"];
 var isValidTeamMemberRole = (value) => teamMemberRoles.includes(value);
@@ -143,7 +179,8 @@ var parsePushData = (data) => {
     case "note":
       return isId(d.appId) && isId(d.noteId) ? { type: "note", appId: d.appId, noteId: d.noteId } : null;
     case "device_link":
-      return isId(d.deviceLinkId) ? { type: "device_link", deviceLinkId: d.deviceLinkId, deviceName: typeof d.deviceName === "string" ? d.deviceName : "" } : null;
+    case "device_link_answered":
+      return isId(d.deviceLinkId) ? { type: d.type, deviceLinkId: d.deviceLinkId, deviceName: typeof d.deviceName === "string" ? d.deviceName : "" } : null;
     case "key_check":
       return isId(d.checkId) ? { type: "key_check", checkId: d.checkId } : null;
     case "key_waiting":
@@ -157,12 +194,15 @@ var parsePushData = (data) => {
 export {
   APP_COLORS,
   DEFAULT_ACCENT,
+  DEFAULT_API_ENDPOINT,
   DEFAULT_PUSH_THRESHOLD,
+  LOG_KEY_VERSION,
   LogLevel,
   PUSH_OFF,
   SubscriptionLevel,
   apiErrorCodeOf,
   apiErrorCodes,
+  buildLogPayload,
   isApiErrorCode,
   isValidAppearance,
   isValidColor,
@@ -172,10 +212,13 @@ export {
   isValidSubscriptionLevel,
   isValidTeamMemberRole,
   joinApiKey,
+  logDelivery,
+  logDeliveryOutcome,
   logLevelColors,
   logLevelNameToLevel,
   logLevelToName,
   logLevels,
+  logRetryDelayMs,
   nameColor,
   normalizePushThreshold,
   parsePushData,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infinitetoken/lumber-kit",
-  "version": "0.5.2",
+  "version": "0.7.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"
   },