@vouchington/utils 0.7.0 → 0.7.1

package/README.md

@@ -21,6 +21,8 @@ import { createScopeCatalog } from '@vouchington/utils/scopes'
 - `cache-tags`: canonical printable-ASCII wire encoding, one-segment URL decoding, validation,
   and escape-boundary truncation. Applications own family names, route recognition, and purge policy.
   Single-tag validation rejects spaces and comma separators; raw commas are percent-encoded.
+- `schema-growth`: `buildUnboundedUnpartitionedTables()` and `classifyTableGrowth()` map tables to
+  caller-supplied growth reasons. Applications own every table name and reason.
 - `sentry-envelope`: bounded UTF-8 envelope record scanning and safe item-type diagnostics.
   Callers choose the byte and type-list limits; DSN, tunnel, request, and logging policy stay local.
 - `scopes`: caller-owned scope catalog validation, prerequisite expansion, audience and surface

package/dist/schema-growth.d.mts

@@ -0,0 +1,20 @@
+type GrowthPolicyGroup = {
+    /** Why these tables may grow without a time or size bound. */
+    reason: string;
+    tables: readonly string[];
+    /** Skip tables that are partitioned (they are bounded by partition retention instead). */
+    excludePartitioned?: boolean;
+};
+export interface BuildUnboundedTablesOptions {
+    partitionedTables: ReadonlySet<string>;
+    /** Applied in order; a later group or entry overrides an earlier reason for the same table. */
+    groups?: readonly GrowthPolicyGroup[];
+    /** Per-table `[table, reason]` entries, applied after `groups`. */
+    entries?: Iterable<readonly [table: string, reason: string]>;
+}
+export type TableGrowthClass = 'partitioned' | 'unbounded' | 'unclassified';
+/** Maps every deliberately unbounded, unpartitioned table to its documented reason. */
+export declare function buildUnboundedUnpartitionedTables(options: BuildUnboundedTablesOptions): Map<string, string>;
+/** Partitioned wins over unbounded; anything else needs an explicit growth decision. */
+export declare function classifyTableGrowth(table: string, partitionedTables: ReadonlySet<string>, unboundedTables: ReadonlyMap<string, string>): TableGrowthClass;
+export {};

package/dist/schema-growth.mjs

@@ -0,0 +1,20 @@
+/** Maps every deliberately unbounded, unpartitioned table to its documented reason. */
+export function buildUnboundedUnpartitionedTables(options) {
+    const result = new Map();
+    for (const group of options.groups ?? []) {
+        for (const table of group.tables) {
+            if (group.excludePartitioned && options.partitionedTables.has(table))
+                continue;
+            result.set(table, group.reason);
+        }
+    }
+    for (const [table, reason] of options.entries ?? [])
+        result.set(table, reason);
+    return result;
+}
+/** Partitioned wins over unbounded; anything else needs an explicit growth decision. */
+export function classifyTableGrowth(table, partitionedTables, unboundedTables) {
+    if (partitionedTables.has(table))
+        return 'partitioned';
+    return unboundedTables.has(table) ? 'unbounded' : 'unclassified';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vouchington/utils",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Dependency-free runtime utilities for Vouchington-style applications.",
   "homepage": "https://github.com/vouchington/vouchington-platform/tree/main/packages/utils#readme",
   "bugs": {
@@ -30,6 +30,11 @@
       "import": "./dist/api-response-contract.mjs",
       "default": "./dist/api-response-contract.mjs"
     },
+    "./schema-growth": {
+      "types": "./dist/schema-growth.d.mts",
+      "import": "./dist/schema-growth.mjs",
+      "default": "./dist/schema-growth.mjs"
+    },
     "./cache-tags": {
       "types": "./dist/cache-tags.d.mts",
       "import": "./dist/cache-tags.mjs",