@infinitetoken/lumber-kit 0.8.0 → 1.0.0

package/README.md

@@ -36,6 +36,7 @@ import { LogLevel, LogRecord, LogEncrypted, LogPayload, LogsQuery } from '@infin
 | `SubscriptionLevel` | `const enum` | Team tier: Hobby=0 Dev=1 Pro=2 Enterprise=3 |
 | `subscriptionLevelToName` | object | Maps `SubscriptionLevel` to `'hobby' \| 'dev' \| 'pro' \| 'enterprise'` |
 | `subscriptionLimits` | object | Per-tier limits (apps, seats, apiKeys, logRetentionDays, etc.) |
+| `monthlyLogsCap` | object | Past `monthlyLogs`: the lowest level still taken (ERROR) and the hard stop's multiple (2), where every log is refused |
 | `isValidSubscriptionLevel` | function | Type guard for `SubscriptionLevel` values |
 
 ### Plans
@@ -140,6 +141,7 @@ A plugin sends only the token to the API (`Authorization: Bearer <token>`) and e
 | `buildLogPayload` | function | The `LogPayload` a log call encrypts, from its level, message, data and the plugin's automatic context |
 | `DEFAULT_API_ENDPOINT` | constant | `https://api.lumber.infinitetoken.com` |
 | `LOG_KEY_VERSION` | constant | `LogEncrypted`'s `keyVersion` (1) |
+| `MAX_LOG_PAYLOAD_LENGTH` | constant | The longest `encrypted.payload` `POST /logs` takes (16 KB of base64); longer is refused with a 413 |
 | `logDelivery` | object | Attempts, retry delays and the pause after a 429 |
 | `logDeliveryOutcome` | function | `sent`, `retry`, `drop` or `pause` for a `POST /logs` status (null for a network error) |
 | `logRetryDelayMs` | function | The wait after a log's nth failed attempt: 1s, 2s, 4s, up to 30s |

package/contract/schema.json

@@ -388,7 +388,14 @@
             "string",
             "null"
           ],
-          "description": "While the team has sent its plan's monthly logs, when new ones are taken again (the next UTC month); else null."
+          "description": "While the team has sent its plan's monthly logs, when every level is taken again (the next UTC month); else null. Until then only ERROR and FATAL are taken (monthlyLogsCap)."
+        },
+        "logsStoppedUntil": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "While the team is at its hard stop (twice its plan's monthly logs, monthlyLogsCap), when any log is taken again (the next UTC month); else null. Set only alongside logsCappedUntil."
         }
       },
       "required": [
@@ -447,7 +454,14 @@
             "string",
             "null"
           ],
-          "description": "While the team has sent its plan's monthly logs, when new ones are taken again (the next UTC month); else null."
+          "description": "While the team has sent its plan's monthly logs, when every level is taken again (the next UTC month); else null. Until then only ERROR and FATAL are taken (monthlyLogsCap)."
+        },
+        "logsStoppedUntil": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "While the team is at its hard stop (twice its plan's monthly logs, monthlyLogsCap), when any log is taken again (the next UTC month); else null. Set only alongside logsCappedUntil."
         },
         "apiKey": {
           "type": "string"
@@ -1631,8 +1645,13 @@
         "count": {
           "type": "number"
         },
-        "hiddenCount": {
-          "type": "number"
+        "dropped": {
+          "type": "number",
+          "description": "POST /logs past the team's monthly logs: how many logs it dropped (1), below ERROR (monthlyLogsCap)."
+        },
+        "cappedUntil": {
+          "type": "string",
+          "description": "With `dropped`: when every level is taken again (the next UTC month), an ISO time."
         }
       },
       "required": [

package/dist/index.d.mts

@@ -22,8 +22,10 @@ declare const LOG_KEY_VERSION = 1;
 /**
  * How a plugin delivers logs: one POST /logs per log, in the order they were logged. A network error or a 5xx is a
  * failed attempt, tried again after `baseDelayMs`, doubling up to `maxDelayMs`, and dropped after `maxAttempts`. Any
- * other 4xx is dropped at once, since sending it again won't help. A 429 (the team's logs for the month are used up)
- * drops what's queued and every new log until its Retry-After, or for `pauseMs` when it has none.
+ * other 4xx (a 413 for a log over MAX_LOG_PAYLOAD_LENGTH among them) is dropped at once, since sending it again won't
+ * help. Any 2xx is sent, including the 200 the API answers when it drops a log below ERROR past the team's monthly
+ * logs (monthlyLogsCap). A 429 (the team is at its hard stop, twice its plan's monthly logs) drops what's queued and
+ * every new log until its Retry-After, or for `pauseMs` when it has none.
  */
 declare const logDelivery: {
     readonly maxAttempts: 5;
@@ -31,6 +33,12 @@ declare const logDelivery: {
     readonly maxDelayMs: 30000;
     readonly pauseMs: number;
 };
+/**
+ * The longest `encrypted.payload` POST /logs takes, in characters: 16 KB of base64, about 12 KB of log as written (its
+ * message, context and metadata). A longer one is refused with a 413, which a plugin drops at once with a warning
+ * (Jay, 2026-11-13). The server can only measure the ciphertext.
+ */
+declare const MAX_LOG_PAYLOAD_LENGTH: number;
 
 /** Log severity level. Numeric values match the existing Lumber-API level field. */
 declare const enum LogLevel {
@@ -135,8 +143,16 @@ interface AppRecord {
     teamAccess?: AppTeamAccess;
     /** How many days of its logs the app's team's plan keeps, null for no limit (and when missing). */
     retentionDays?: number | null;
-    /** While the team has sent its plan's monthly logs, when new ones are taken again (the next UTC month); else null. */
+    /**
+     * While the team has sent its plan's monthly logs, when every level is taken again (the next UTC month); else null.
+     * Until then only ERROR and FATAL are taken (monthlyLogsCap).
+     */
     logsCappedUntil?: string | null;
+    /**
+     * While the team is at its hard stop (twice its plan's monthly logs, monthlyLogsCap), when any log is taken again
+     * (the next UTC month); else null. Set only alongside logsCappedUntil.
+     */
+    logsStoppedUntil?: string | null;
 }
 /**
  * App creation response.
@@ -546,7 +562,10 @@ interface ResponseMetadata {
     cursor?: string | null;
     hasMore?: boolean;
     count?: number;
-    hiddenCount?: number;
+    /** POST /logs past the team's monthly logs: how many logs it dropped (1), below ERROR (monthlyLogsCap). */
+    dropped?: number;
+    /** With `dropped`: when every level is taken again (the next UTC month), an ISO time. */
+    cappedUntil?: string;
 }
 interface ApiResponse<T> {
     data: T;
@@ -717,6 +736,18 @@ type SubscriptionLimits = {
 };
 /** Per-level resource limits. Use Infinity to mean unlimited or disabled. */
 declare const subscriptionLimits: Record<SubscriptionLevel, SubscriptionLimits>;
+/**
+ * What happens past a team's monthly logs (Jay, 2026-11-13: errors always get through). Past its plan's monthlyLogs,
+ * POST /logs still takes ERROR and FATAL and drops lower levels, answering a dropped log 200 with `metadata.dropped`
+ * so a plugin carries on, until `hardStopMultiple` times monthlyLogs, when it refuses every log with a 429 until the
+ * next UTC month. Only the logs it takes count in usage, so the hard stop measures what every device holds.
+ */
+declare const monthlyLogsCap: {
+    /** The lowest level still taken past the cap. */
+    readonly minLevelPastCap: LogLevel.Error;
+    /** Where every log is refused, as a multiple of the plan's monthlyLogs. */
+    readonly hardStopMultiple: 2;
+};
 type SubscriptionPlan = {
     /** Display name, as every surface shows it. */
     name: string;
@@ -735,8 +766,9 @@ declare const subscriptionPlans: Record<SubscriptionLevel, SubscriptionPlan>;
  */
 declare const buildLogPayload: (level: LogLevel, message: string, data?: LogData, autoContext?: Record<string, unknown>) => LogPayload;
 /**
- * What to do with a log once POST /logs answers with `status`, or null for no answer (a network error): sent on a 2xx,
- * pause on a 429, drop on any other 4xx, and retry on anything else.
+ * What to do with a log once POST /logs answers with `status`, or null for no answer (a network error): sent on a 2xx
+ * (the API's 200 for a log it dropped past the monthly cap too), pause on a 429, drop on any other 4xx, and retry on
+ * anything else.
  */
 declare const logDeliveryOutcome: (status: number | null) => LogDeliveryOutcome;
 /** How long to wait before trying a log again after its `failedAttempts`th failure: 1s, 2s, 4s and so on, up to 30s. */
@@ -786,4 +818,5 @@ declare const apiErrorCodeOf: (body: unknown) => ApiErrorCode | null;
 /** A push notification's data as PushData, or null for data no Lumber push sends. */
 declare const parsePushData: (data: unknown) => PushData | null;
 
-export { APP_COLORS, type ApiErrorBody, type ApiErrorCode, type ApiKeyRecord, type ApiResponse, type AppCreatedRecord, type AppEncryptedKey, type AppKeyUpsertBody, type AppPermission, type AppPersonRecord, type AppRecord, type AppTeamAccess, type Appearance, type AppsQuery, type ClaimantKeyCheck, type ClientToServerEvents, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, DEFAULT_TIME_FORMAT, type DeviceLinkApproveBody, type DeviceLinkCreateBody, type DeviceLinkCreatedRecord, type DeviceLinkPlatform, type DeviceLinkRecord, type DeviceLinkStatus, type FlagRecord, type FlagsQuery, type GuestRecord, type HolderKeyCheck, type InvitationRecord, type KeyCheckResult, type KeyHolder, type KeyPin, LOG_KEY_VERSION, type LogContext, type LogData, type LogDeliveryOutcome, type LogEncrypted, type LogIngestBody, LogLevel, type LogLevelName, type LogPayload, type LogRecord, type LogTimeseriesQuery, type LogsQuery, type NoteEncrypted, type NoteRecord, type NotesQuery, type NotificationPreference, type NotificationPreferences, PUSH_OFF, type PendingAppKey, type PendingDeviceLink, type PushData, type PushThreshold, type PushToken, type PushType, type ResponseMetadata, type ServerToClientEvents, type SocketAppPayload, SubscriptionLevel, type SubscriptionLevelName, type SubscriptionLimits, type SubscriptionPlan, type SubscriptionPlanRecord, type TeamMemberRecord, type TeamRecord, type TeamsQuery, type TimeClock, type TimeFormat, type TimeZoneChoice, type TimeseriesBucket, type TimeseriesResponse, type UserRecord, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, isValidTimeFormat, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, nameColor, normalizePushThreshold, normalizeTimeFormat, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };
+export { APP_COLORS, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, DEFAULT_TIME_FORMAT, LOG_KEY_VERSION, LogLevel, MAX_LOG_PAYLOAD_LENGTH, PUSH_OFF, SubscriptionLevel, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, isValidTimeFormat, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, monthlyLogsCap, nameColor, normalizePushThreshold, normalizeTimeFormat, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };
+export type { ApiErrorBody, ApiErrorCode, ApiKeyRecord, ApiResponse, AppCreatedRecord, AppEncryptedKey, AppKeyUpsertBody, AppPermission, AppPersonRecord, AppRecord, AppTeamAccess, Appearance, AppsQuery, ClaimantKeyCheck, ClientToServerEvents, DeviceLinkApproveBody, DeviceLinkCreateBody, DeviceLinkCreatedRecord, DeviceLinkPlatform, DeviceLinkRecord, DeviceLinkStatus, FlagRecord, FlagsQuery, GuestRecord, HolderKeyCheck, InvitationRecord, KeyCheckResult, KeyHolder, KeyPin, LogContext, LogData, LogDeliveryOutcome, LogEncrypted, LogIngestBody, LogLevelName, LogPayload, LogRecord, LogTimeseriesQuery, LogsQuery, NoteEncrypted, NoteRecord, NotesQuery, NotificationPreference, NotificationPreferences, PendingAppKey, PendingDeviceLink, PushData, PushThreshold, PushToken, PushType, ResponseMetadata, ServerToClientEvents, SocketAppPayload, SubscriptionLevelName, SubscriptionLimits, SubscriptionPlan, SubscriptionPlanRecord, TeamMemberRecord, TeamRecord, TeamsQuery, TimeClock, TimeFormat, TimeZoneChoice, TimeseriesBucket, TimeseriesResponse, UserRecord };

package/dist/index.d.ts

@@ -22,8 +22,10 @@ declare const LOG_KEY_VERSION = 1;
 /**
  * How a plugin delivers logs: one POST /logs per log, in the order they were logged. A network error or a 5xx is a
  * failed attempt, tried again after `baseDelayMs`, doubling up to `maxDelayMs`, and dropped after `maxAttempts`. Any
- * other 4xx is dropped at once, since sending it again won't help. A 429 (the team's logs for the month are used up)
- * drops what's queued and every new log until its Retry-After, or for `pauseMs` when it has none.
+ * other 4xx (a 413 for a log over MAX_LOG_PAYLOAD_LENGTH among them) is dropped at once, since sending it again won't
+ * help. Any 2xx is sent, including the 200 the API answers when it drops a log below ERROR past the team's monthly
+ * logs (monthlyLogsCap). A 429 (the team is at its hard stop, twice its plan's monthly logs) drops what's queued and
+ * every new log until its Retry-After, or for `pauseMs` when it has none.
  */
 declare const logDelivery: {
     readonly maxAttempts: 5;
@@ -31,6 +33,12 @@ declare const logDelivery: {
     readonly maxDelayMs: 30000;
     readonly pauseMs: number;
 };
+/**
+ * The longest `encrypted.payload` POST /logs takes, in characters: 16 KB of base64, about 12 KB of log as written (its
+ * message, context and metadata). A longer one is refused with a 413, which a plugin drops at once with a warning
+ * (Jay, 2026-11-13). The server can only measure the ciphertext.
+ */
+declare const MAX_LOG_PAYLOAD_LENGTH: number;
 
 /** Log severity level. Numeric values match the existing Lumber-API level field. */
 declare const enum LogLevel {
@@ -135,8 +143,16 @@ interface AppRecord {
     teamAccess?: AppTeamAccess;
     /** How many days of its logs the app's team's plan keeps, null for no limit (and when missing). */
     retentionDays?: number | null;
-    /** While the team has sent its plan's monthly logs, when new ones are taken again (the next UTC month); else null. */
+    /**
+     * While the team has sent its plan's monthly logs, when every level is taken again (the next UTC month); else null.
+     * Until then only ERROR and FATAL are taken (monthlyLogsCap).
+     */
     logsCappedUntil?: string | null;
+    /**
+     * While the team is at its hard stop (twice its plan's monthly logs, monthlyLogsCap), when any log is taken again
+     * (the next UTC month); else null. Set only alongside logsCappedUntil.
+     */
+    logsStoppedUntil?: string | null;
 }
 /**
  * App creation response.
@@ -546,7 +562,10 @@ interface ResponseMetadata {
     cursor?: string | null;
     hasMore?: boolean;
     count?: number;
-    hiddenCount?: number;
+    /** POST /logs past the team's monthly logs: how many logs it dropped (1), below ERROR (monthlyLogsCap). */
+    dropped?: number;
+    /** With `dropped`: when every level is taken again (the next UTC month), an ISO time. */
+    cappedUntil?: string;
 }
 interface ApiResponse<T> {
     data: T;
@@ -717,6 +736,18 @@ type SubscriptionLimits = {
 };
 /** Per-level resource limits. Use Infinity to mean unlimited or disabled. */
 declare const subscriptionLimits: Record<SubscriptionLevel, SubscriptionLimits>;
+/**
+ * What happens past a team's monthly logs (Jay, 2026-11-13: errors always get through). Past its plan's monthlyLogs,
+ * POST /logs still takes ERROR and FATAL and drops lower levels, answering a dropped log 200 with `metadata.dropped`
+ * so a plugin carries on, until `hardStopMultiple` times monthlyLogs, when it refuses every log with a 429 until the
+ * next UTC month. Only the logs it takes count in usage, so the hard stop measures what every device holds.
+ */
+declare const monthlyLogsCap: {
+    /** The lowest level still taken past the cap. */
+    readonly minLevelPastCap: LogLevel.Error;
+    /** Where every log is refused, as a multiple of the plan's monthlyLogs. */
+    readonly hardStopMultiple: 2;
+};
 type SubscriptionPlan = {
     /** Display name, as every surface shows it. */
     name: string;
@@ -735,8 +766,9 @@ declare const subscriptionPlans: Record<SubscriptionLevel, SubscriptionPlan>;
  */
 declare const buildLogPayload: (level: LogLevel, message: string, data?: LogData, autoContext?: Record<string, unknown>) => LogPayload;
 /**
- * What to do with a log once POST /logs answers with `status`, or null for no answer (a network error): sent on a 2xx,
- * pause on a 429, drop on any other 4xx, and retry on anything else.
+ * What to do with a log once POST /logs answers with `status`, or null for no answer (a network error): sent on a 2xx
+ * (the API's 200 for a log it dropped past the monthly cap too), pause on a 429, drop on any other 4xx, and retry on
+ * anything else.
  */
 declare const logDeliveryOutcome: (status: number | null) => LogDeliveryOutcome;
 /** How long to wait before trying a log again after its `failedAttempts`th failure: 1s, 2s, 4s and so on, up to 30s. */
@@ -786,4 +818,5 @@ declare const apiErrorCodeOf: (body: unknown) => ApiErrorCode | null;
 /** A push notification's data as PushData, or null for data no Lumber push sends. */
 declare const parsePushData: (data: unknown) => PushData | null;
 
-export { APP_COLORS, type ApiErrorBody, type ApiErrorCode, type ApiKeyRecord, type ApiResponse, type AppCreatedRecord, type AppEncryptedKey, type AppKeyUpsertBody, type AppPermission, type AppPersonRecord, type AppRecord, type AppTeamAccess, type Appearance, type AppsQuery, type ClaimantKeyCheck, type ClientToServerEvents, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, DEFAULT_TIME_FORMAT, type DeviceLinkApproveBody, type DeviceLinkCreateBody, type DeviceLinkCreatedRecord, type DeviceLinkPlatform, type DeviceLinkRecord, type DeviceLinkStatus, type FlagRecord, type FlagsQuery, type GuestRecord, type HolderKeyCheck, type InvitationRecord, type KeyCheckResult, type KeyHolder, type KeyPin, LOG_KEY_VERSION, type LogContext, type LogData, type LogDeliveryOutcome, type LogEncrypted, type LogIngestBody, LogLevel, type LogLevelName, type LogPayload, type LogRecord, type LogTimeseriesQuery, type LogsQuery, type NoteEncrypted, type NoteRecord, type NotesQuery, type NotificationPreference, type NotificationPreferences, PUSH_OFF, type PendingAppKey, type PendingDeviceLink, type PushData, type PushThreshold, type PushToken, type PushType, type ResponseMetadata, type ServerToClientEvents, type SocketAppPayload, SubscriptionLevel, type SubscriptionLevelName, type SubscriptionLimits, type SubscriptionPlan, type SubscriptionPlanRecord, type TeamMemberRecord, type TeamRecord, type TeamsQuery, type TimeClock, type TimeFormat, type TimeZoneChoice, type TimeseriesBucket, type TimeseriesResponse, type UserRecord, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, isValidTimeFormat, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, nameColor, normalizePushThreshold, normalizeTimeFormat, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };
+export { APP_COLORS, DEFAULT_ACCENT, DEFAULT_API_ENDPOINT, DEFAULT_PUSH_THRESHOLD, DEFAULT_TIME_FORMAT, LOG_KEY_VERSION, LogLevel, MAX_LOG_PAYLOAD_LENGTH, PUSH_OFF, SubscriptionLevel, apiErrorCodeOf, apiErrorCodes, buildLogPayload, isApiErrorCode, isValidAppearance, isValidColor, isValidDeviceLinkStatus, isValidImageUrl, isValidLogLevel, isValidSubscriptionLevel, isValidTeamMemberRole, isValidTimeFormat, joinApiKey, logDelivery, logDeliveryOutcome, logLevelColors, logLevelNameToLevel, logLevelToName, logLevels, logRetryDelayMs, monthlyLogsCap, nameColor, normalizePushThreshold, normalizeTimeFormat, parsePushData, personColor, resolveAppColor, splitApiKey, subscriptionLevelToName, subscriptionLevels, subscriptionLimits, subscriptionPlans };
+export type { ApiErrorBody, ApiErrorCode, ApiKeyRecord, ApiResponse, AppCreatedRecord, AppEncryptedKey, AppKeyUpsertBody, AppPermission, AppPersonRecord, AppRecord, AppTeamAccess, Appearance, AppsQuery, ClaimantKeyCheck, ClientToServerEvents, DeviceLinkApproveBody, DeviceLinkCreateBody, DeviceLinkCreatedRecord, DeviceLinkPlatform, DeviceLinkRecord, DeviceLinkStatus, FlagRecord, FlagsQuery, GuestRecord, HolderKeyCheck, InvitationRecord, KeyCheckResult, KeyHolder, KeyPin, LogContext, LogData, LogDeliveryOutcome, LogEncrypted, LogIngestBody, LogLevelName, LogPayload, LogRecord, LogTimeseriesQuery, LogsQuery, NoteEncrypted, NoteRecord, NotesQuery, NotificationPreference, NotificationPreferences, PendingAppKey, PendingDeviceLink, PushData, PushThreshold, PushToken, PushType, ResponseMetadata, ServerToClientEvents, SocketAppPayload, SubscriptionLevelName, SubscriptionLimits, SubscriptionPlan, SubscriptionPlanRecord, TeamMemberRecord, TeamRecord, TeamsQuery, TimeClock, TimeFormat, TimeZoneChoice, TimeseriesBucket, TimeseriesResponse, UserRecord };

package/dist/index.js

@@ -27,6 +27,7 @@ __export(index_exports, {
   DEFAULT_TIME_FORMAT: () => DEFAULT_TIME_FORMAT,
   LOG_KEY_VERSION: () => LOG_KEY_VERSION,
   LogLevel: () => LogLevel,
+  MAX_LOG_PAYLOAD_LENGTH: () => MAX_LOG_PAYLOAD_LENGTH,
   PUSH_OFF: () => PUSH_OFF,
   SubscriptionLevel: () => SubscriptionLevel,
   apiErrorCodeOf: () => apiErrorCodeOf,
@@ -49,6 +50,7 @@ __export(index_exports, {
   logLevelToName: () => logLevelToName,
   logLevels: () => logLevels,
   logRetryDelayMs: () => logRetryDelayMs,
+  monthlyLogsCap: () => monthlyLogsCap,
   nameColor: () => nameColor,
   normalizePushThreshold: () => normalizePushThreshold,
   normalizeTimeFormat: () => normalizeTimeFormat,
@@ -126,6 +128,7 @@ var logDelivery = {
   maxDelayMs: 3e4,
   pauseMs: 60 * 60 * 1e3
 };
+var MAX_LOG_PAYLOAD_LENGTH = 16 * 1024;
 
 // src/constants/notifications.ts
 var PUSH_OFF = 5;
@@ -148,11 +151,17 @@ var subscriptionLevelToName = {
 };
 var subscriptionLevels = [0 /* Hobby */, 1 /* Dev */, 2 /* Pro */, 3 /* Enterprise */];
 var subscriptionLimits = {
-  [0 /* Hobby */]: { apps: 5, seats: 1, apiKeys: 1, logRetentionDays: 7, monthlyLogs: 1e4, realtimeLogs: false, minPushLevel: Infinity },
-  [1 /* Dev */]: { apps: 10, seats: 5, apiKeys: 5, logRetentionDays: 30, monthlyLogs: 25e4, realtimeLogs: true, minPushLevel: 3 /* Error */ },
+  [0 /* Hobby */]: { apps: 5, seats: 1, apiKeys: 1, logRetentionDays: 7, monthlyLogs: 1e5, realtimeLogs: false, minPushLevel: 4 /* Fatal */ },
+  [1 /* Dev */]: { apps: 10, seats: 5, apiKeys: 5, logRetentionDays: 30, monthlyLogs: 5e5, realtimeLogs: true, minPushLevel: 3 /* Error */ },
   [2 /* Pro */]: { apps: 20, seats: 20, apiKeys: 15, logRetentionDays: 90, monthlyLogs: 2e6, realtimeLogs: true, minPushLevel: 2 /* Warn */ },
   [3 /* Enterprise */]: { apps: Infinity, seats: Infinity, apiKeys: Infinity, logRetentionDays: Infinity, monthlyLogs: Infinity, realtimeLogs: true, minPushLevel: 0 /* Debug */ }
 };
+var monthlyLogsCap = {
+  /** The lowest level still taken past the cap. */
+  minLevelPastCap: 3 /* Error */,
+  /** Where every log is refused, as a multiple of the plan's monthlyLogs. */
+  hardStopMultiple: 2
+};
 var subscriptionPlans = {
   [0 /* Hobby */]: { name: "Hobby", monthlyPrice: 0 },
   [1 /* Dev */]: { name: "Dev", monthlyPrice: 9 },
@@ -277,6 +286,7 @@ var parsePushData = (data) => {
   DEFAULT_TIME_FORMAT,
   LOG_KEY_VERSION,
   LogLevel,
+  MAX_LOG_PAYLOAD_LENGTH,
   PUSH_OFF,
   SubscriptionLevel,
   apiErrorCodeOf,
@@ -299,6 +309,7 @@ var parsePushData = (data) => {
   logLevelToName,
   logLevels,
   logRetryDelayMs,
+  monthlyLogsCap,
   nameColor,
   normalizePushThreshold,
   normalizeTimeFormat,

package/dist/index.mjs

@@ -61,6 +61,7 @@ var logDelivery = {
   maxDelayMs: 3e4,
   pauseMs: 60 * 60 * 1e3
 };
+var MAX_LOG_PAYLOAD_LENGTH = 16 * 1024;
 
 // src/constants/notifications.ts
 var PUSH_OFF = 5;
@@ -83,11 +84,17 @@ var subscriptionLevelToName = {
 };
 var subscriptionLevels = [0 /* Hobby */, 1 /* Dev */, 2 /* Pro */, 3 /* Enterprise */];
 var subscriptionLimits = {
-  [0 /* Hobby */]: { apps: 5, seats: 1, apiKeys: 1, logRetentionDays: 7, monthlyLogs: 1e4, realtimeLogs: false, minPushLevel: Infinity },
-  [1 /* Dev */]: { apps: 10, seats: 5, apiKeys: 5, logRetentionDays: 30, monthlyLogs: 25e4, realtimeLogs: true, minPushLevel: 3 /* Error */ },
+  [0 /* Hobby */]: { apps: 5, seats: 1, apiKeys: 1, logRetentionDays: 7, monthlyLogs: 1e5, realtimeLogs: false, minPushLevel: 4 /* Fatal */ },
+  [1 /* Dev */]: { apps: 10, seats: 5, apiKeys: 5, logRetentionDays: 30, monthlyLogs: 5e5, realtimeLogs: true, minPushLevel: 3 /* Error */ },
   [2 /* Pro */]: { apps: 20, seats: 20, apiKeys: 15, logRetentionDays: 90, monthlyLogs: 2e6, realtimeLogs: true, minPushLevel: 2 /* Warn */ },
   [3 /* Enterprise */]: { apps: Infinity, seats: Infinity, apiKeys: Infinity, logRetentionDays: Infinity, monthlyLogs: Infinity, realtimeLogs: true, minPushLevel: 0 /* Debug */ }
 };
+var monthlyLogsCap = {
+  /** The lowest level still taken past the cap. */
+  minLevelPastCap: 3 /* Error */,
+  /** Where every log is refused, as a multiple of the plan's monthlyLogs. */
+  hardStopMultiple: 2
+};
 var subscriptionPlans = {
   [0 /* Hobby */]: { name: "Hobby", monthlyPrice: 0 },
   [1 /* Dev */]: { name: "Dev", monthlyPrice: 9 },
@@ -211,6 +218,7 @@ export {
   DEFAULT_TIME_FORMAT,
   LOG_KEY_VERSION,
   LogLevel,
+  MAX_LOG_PAYLOAD_LENGTH,
   PUSH_OFF,
   SubscriptionLevel,
   apiErrorCodeOf,
@@ -233,6 +241,7 @@ export {
   logLevelToName,
   logLevels,
   logRetryDelayMs,
+  monthlyLogsCap,
   nameColor,
   normalizePushThreshold,
   normalizeTimeFormat,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infinitetoken/lumber-kit",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "Shared TypeScript types and wire format contracts for the Lumber cloud logging suite",
   "keywords": [
     "lumber",
@@ -13,6 +13,10 @@
     "schema",
     "log-schema"
   ],
+  "homepage": "https://lumber.infinitetoken.com",
+  "bugs": {
+    "url": "https://github.com/infinitetoken/Lumber-Kit/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/infinitetoken/lumber-kit.git"
@@ -61,15 +65,15 @@
   "devDependencies": {
     "@infinitetoken/eslint-config": "^0.2.1",
     "@infinitetoken/jest-config": "^0.5.2",
-    "@infinitetoken/tsconfig": "^0.6.0",
+    "@infinitetoken/tsconfig": "^0.7.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.0.0",
+    "@types/node": "^26.6.6",
     "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",
+    "tsup": "^9.0.0",
     "typescript": "^6.0.3"
   },
   "publishConfig": {