@plasius/schema 1.2.17 → 1.3.0

package/README.md

@@ -30,6 +30,25 @@ uses `dist-cjs/*.js` with `type: module`, it must generate
 
 ---
 
+## Player-system event contracts
+
+The package exports versioned contracts for a blob-backed, privacy-safe player
+event pipeline:
+
+```ts
+import {
+  PlayerSystemCuratedSnapshotSchema,
+  PlayerSystemNormalizedEventBatchSchema,
+  PlayerSystemObservedEventBatchSchema,
+} from "@plasius/schema";
+```
+
+The contracts cover raw observed-event ingress, normalized batches with
+deterministic keys, and curated per-player Event Log/Achievement snapshots.
+Only the stable `playerId` is treated as a personal identifier. It is retained
+for storage partitioning and pseudonymized by `sanitizeForLog`; unknown fields
+and hidden server truth are excluded by schema serialization.
+
 ## Demo
 
 ```bash
@@ -88,6 +107,21 @@ const UserFields = {
 ```
 
 Common methods (non‑exhaustive): `.required()`, `.optional()`, `.default(v|fn)`, `.description(text)`, and type‑specific helpers like `.email()`, `.uuid()`, `.min()`, `.max()`, `.enum([...])`.
+
+Validation standards notes:
+
+- `languageCode()` checks a documented RFC 5646/BCP 47 subset
+  case-insensitively, including grandfathered and private-use tags;
+  two-letter primaries are checked against the package's ISO 639-1 registry.
+  Registered 4-8 letter primaries remain outside this dependency-free subset.
+- `uuid()` accepts the RFC 9562 versions 1-8, Nil, and Max text forms. Legacy
+  RFC 4122-named module paths remain compatibility aliases.
+- `email()` is a pragmatic dot-domain mailbox subset, not a claim of complete
+  RFC 5322 grammar support.
+
+Runtime rollout inherits `governance.rfc-compliance-remediation.enabled`;
+disabled consumers may retain the prior validators only during a documented
+migration window.
 Defaults are applied during validation when inputs are missing/`undefined`.
 Fields are required by default; call `.optional()` (or provide `.default()`) to allow omission.
 Use `.internal()` or `.exposure("internal")` on fields that the server may validate/store but must not include in client-facing payloads.

package/dist/index.cjs

@@ -22,6 +22,12 @@ var index_exports = {};
 __export(index_exports, {
   FieldBuilder: () => FieldBuilder,
   IsoLanguageCode: () => IsoLanguageCode,
+  PLAYER_SYSTEM_ACHIEVEMENT_TIERS: () => PLAYER_SYSTEM_ACHIEVEMENT_TIERS,
+  PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES: () => PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES,
+  PLAYER_SYSTEM_EVENT_KINDS: () => PLAYER_SYSTEM_EVENT_KINDS,
+  PlayerSystemCuratedSnapshotSchema: () => PlayerSystemCuratedSnapshotSchema,
+  PlayerSystemNormalizedEventBatchSchema: () => PlayerSystemNormalizedEventBatchSchema,
+  PlayerSystemObservedEventBatchSchema: () => PlayerSystemObservedEventBatchSchema,
   createComponentSchema: () => createComponentSchema,
   createSchema: () => createSchema,
   field: () => field,
@@ -284,8 +290,8 @@ var validateUrl = (value) => {
 // src/validation/uuid.RFC4122.ts
 var validateUUID = (value) => {
   if (typeof value !== "string") return false;
-  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-  return uuidRegex.test(value);
+  const standard = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+  return standard.test(value) || value.toLowerCase() === "00000000-0000-0000-0000-000000000000" || value.toLowerCase() === "ffffffff-ffff-ffff-ffff-ffffffffffff";
 };
 
 // src/validation/dateTime.ISO8601.ts
@@ -1032,10 +1038,10 @@ function isIsoLanguageCode(value) {
   return typeof value === "string" && ISO_LANGUAGE_SET.has(value.toLowerCase());
 }
 function isRegionSubtag(value) {
-  return /^[A-Z]{2}$/.test(value) || /^\d{3}$/.test(value);
+  return /^[A-Za-z]{2}$/.test(value) || /^\d{3}$/.test(value);
 }
 function isScriptSubtag(value) {
-  return /^[A-Z][a-z]{3}$/.test(value);
+  return /^[A-Za-z]{4}$/.test(value);
 }
 function isVariantSubtag(value) {
   return /^([0-9][A-Za-z0-9]{3}|[A-Za-z0-9]{5,8})$/.test(value);
@@ -1055,20 +1061,42 @@ function isPrivateUseSubtag(value) {
 function validateLanguage(value) {
   if (typeof value !== "string" || value.length === 0) return false;
   const parts = value.split("-");
+  if (parts.some((part) => part.length === 0)) return false;
+  const lowerTag = value.toLowerCase();
+  if (GRANDFATHERED_TAGS.has(lowerTag)) return true;
+  if (parts[0]?.toLowerCase() === "x") {
+    return parts.length > 1 && parts.slice(1).every(isPrivateUseSubtag);
+  }
   let i = 0;
   const lang = parts[i];
-  if (!lang || !isIsoLanguageCode(lang)) return false;
+  if (!lang || !/^[A-Za-z]{2,3}$/.test(lang)) return false;
+  if (lang.length === 2 && !isIsoLanguageCode(lang)) return false;
   i += 1;
+  if (lang.length <= 3) {
+    let extlangCount = 0;
+    while (i < parts.length && extlangCount < 3 && /^[A-Za-z]{3}$/.test(parts[i])) {
+      i += 1;
+      extlangCount += 1;
+    }
+  }
   if (i < parts.length && isScriptSubtag(parts[i])) {
     i += 1;
   }
   if (i < parts.length && isRegionSubtag(parts[i].toUpperCase())) {
     i += 1;
   }
+  const variants = /* @__PURE__ */ new Set();
   while (i < parts.length && isVariantSubtag(parts[i])) {
+    const variant = parts[i].toLowerCase();
+    if (variants.has(variant)) return false;
+    variants.add(variant);
     i += 1;
   }
+  const extensionSingletons = /* @__PURE__ */ new Set();
   while (i < parts.length && isExtensionSingleton(parts[i])) {
+    const singleton = parts[i].toLowerCase();
+    if (extensionSingletons.has(singleton)) return false;
+    extensionSingletons.add(singleton);
     i += 1;
     if (!(i < parts.length && isExtensionSubtag(parts[i]))) return false;
     while (i < parts.length && isExtensionSubtag(parts[i])) {
@@ -1084,6 +1112,34 @@ function validateLanguage(value) {
   }
   return i === parts.length;
 }
+var GRANDFATHERED_TAGS = /* @__PURE__ */ new Set([
+  "art-lojban",
+  "cel-gaulish",
+  "en-gb-oed",
+  "i-ami",
+  "i-bnn",
+  "i-default",
+  "i-enochian",
+  "i-hak",
+  "i-klingon",
+  "i-lux",
+  "i-mingo",
+  "i-navajo",
+  "i-pwn",
+  "i-tao",
+  "i-tay",
+  "i-tsu",
+  "no-bok",
+  "no-nyn",
+  "sgn-be-fr",
+  "sgn-be-nl",
+  "sgn-ch-de",
+  "zh-guoyu",
+  "zh-hakka",
+  "zh-min",
+  "zh-min-nan",
+  "zh-xiang"
+]);
 
 // src/field.ts
 var field = {
@@ -2509,10 +2565,129 @@ function getComponentSchema(type) {
 function getAllComponentSchemas() {
   return Array.from(componentSchemaRegistry.entries());
 }
+
+// src/player-system-events.ts
+var PLAYER_SYSTEM_EVENT_KINDS = [
+  "combat",
+  "social",
+  "mission",
+  "crafting",
+  "world"
+];
+var PLAYER_SYSTEM_ACHIEVEMENT_TIERS = [
+  "bronze",
+  "silver",
+  "gold"
+];
+var PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES = [
+  "tracking",
+  "earned"
+];
+var playerIdField = () => field.string().min(1).max(128).PID({
+  classification: "low",
+  action: "none",
+  logHandling: "pseudonym",
+  purpose: "a stable player-scoped storage identifier"
+}).description(
+  "Stable player identifier; the only personal identifier retained in event projections"
+);
+var eventIdField = () => field.string().min(1).max(128);
+var eventKindField = () => field.string().enum(PLAYER_SYSTEM_EVENT_KINDS);
+var eventTitleField = () => field.generalText().min(1).max(120).description("Player-visible event title");
+var eventSummaryField = () => field.generalText().min(1).max(320).description("Player-visible event summary");
+var observedEventFields = (defaultHighlighted = true) => ({
+  id: eventIdField(),
+  playerId: playerIdField(),
+  occurredAt: field.dateTimeISO(),
+  kind: eventKindField(),
+  title: eventTitleField(),
+  summary: eventSummaryField(),
+  highlighted: defaultHighlighted ? field.boolean().default(false) : field.boolean()
+});
+var eventHighlightFields = () => ({
+  id: eventIdField(),
+  title: eventTitleField(),
+  summary: eventSummaryField(),
+  occurredAt: field.dateTimeISO(),
+  kind: eventKindField()
+});
+var eventEntryFields = () => ({
+  id: eventIdField(),
+  title: eventTitleField(),
+  summary: eventSummaryField(),
+  occurredAt: field.dateTimeISO(),
+  kind: eventKindField(),
+  highlighted: field.boolean()
+});
+var achievementFields = () => ({
+  id: eventIdField(),
+  title: eventTitleField(),
+  tier: field.string().enum(PLAYER_SYSTEM_ACHIEVEMENT_TIERS),
+  progressLabel: eventSummaryField(),
+  earnedAt: field.dateTimeISO().optional()
+});
+var achievementTrackFields = () => ({
+  id: eventIdField(),
+  title: eventTitleField(),
+  current: field.number().min(0).max(1e3),
+  target: field.number().min(1).max(1e3),
+  status: field.string().enum(PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES)
+});
+var PlayerSystemObservedEventBatchSchema = createSchema(
+  {
+    source: field.string().min(1).max(120),
+    emittedAt: field.dateTimeISO(),
+    events: field.array(field.object(observedEventFields()))
+  },
+  "player-system-observed-event-batch",
+  {
+    version: "1.0.0",
+    piiEnforcement: "strict"
+  }
+);
+var PlayerSystemNormalizedEventBatchSchema = createSchema(
+  {
+    sourceBlobName: field.string().min(1).max(512),
+    processedAt: field.dateTimeISO(),
+    events: field.array(
+      field.object({
+        ...observedEventFields(false),
+        deterministicKey: field.string().min(1).max(256)
+      })
+    )
+  },
+  "player-system-normalized-event-batch",
+  {
+    version: "1.0.0",
+    piiEnforcement: "strict"
+  }
+);
+var PlayerSystemCuratedSnapshotSchema = createSchema(
+  {
+    playerId: playerIdField(),
+    projectedAt: field.dateTimeISO(),
+    lastObservedAt: field.dateTimeISO(),
+    highlights: field.array(field.object(eventHighlightFields())),
+    events: field.array(field.object(eventEntryFields())),
+    achievements: field.array(field.object(achievementFields())),
+    tracks: field.array(field.object(achievementTrackFields()))
+  },
+  "player-system-curated-snapshot",
+  {
+    version: "1.0.0",
+    piiEnforcement: "strict"
+  }
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   FieldBuilder,
   IsoLanguageCode,
+  PLAYER_SYSTEM_ACHIEVEMENT_TIERS,
+  PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES,
+  PLAYER_SYSTEM_EVENT_KINDS,
+  PlayerSystemCuratedSnapshotSchema,
+  PlayerSystemNormalizedEventBatchSchema,
+  PlayerSystemObservedEventBatchSchema,
   createComponentSchema,
   createSchema,
   field,