@plasius/schema 1.2.17 → 1.3.0

package/dist/index.d.cts

@@ -339,8 +339,11 @@ declare function getComponentSchema(type: string): Schema<SchemaShape> | undefin
 declare function getAllComponentSchemas(): [string, Schema<SchemaShape>][];
 
 /**
- * Validates an email string using a simplified RFC 5322-compliant regex.
- * Returns true if the input is a string in the format `name@domain.tld`.
+ * Validates the package's pragmatic dot-domain mailbox subset.
+ *
+ * This intentionally does not claim full RFC 5322 mailbox support (for
+ * example, quoted local parts and address literals are outside the product
+ * contract). The legacy filename is retained for import compatibility.
  */
 declare const validateEmail: (value: unknown) => boolean;
 
@@ -358,8 +361,8 @@ declare const validatePhone: (value: unknown) => boolean;
 declare const validateUrl: (value: unknown) => boolean;
 
 /**
- * Validates a string against the RFC 4122 format for UUIDs.
- * Matches UUIDs of versions 1 to 5, e.g., "123e4567-e89b-12d3-a456-426614174000".
+ * Validates the RFC 9562 UUID text format, including versions 1-8 plus Nil and
+ * Max UUIDs. The legacy filename is retained for import compatibility.
  */
 declare const validateUUID: (value: unknown) => boolean;
 
@@ -652,4 +655,112 @@ declare function isPrivateUseSubtag(value: string): boolean;
  */
 declare function validateLanguage(value: unknown): boolean;
 
-export { type DeepReadonly, FieldBuilder, type FieldDefinition, type FieldExposure, type FieldType, type FieldTypeMap, type FieldValidator, type FieldValidatorResult, type Infer, IsoLanguageCode, type PIIEnforcement, type RefEntityId, type Schema, type SchemaOptions, type SchemaShape, type SchemaUpgradeFunction, type SchemaUpgradeResult, type SchemaUpgradeSpec, type SchemaUpgradeStep, type SerializeOptions, type ValidateCompositionOptions, type ValidationIssue, type ValidationIssueInput, type ValidationResult, createComponentSchema, createSchema, field, getAllComponentSchemas, getAllSchemas, getComponentSchema, getSchemaForType, isExtensionSingleton, isExtensionSubtag, isIsoLanguageCode, isPrivateUseSingleton, isPrivateUseSubtag, isRegionSubtag, isScriptSubtag, isVariantSubtag, isoCountryCodes, isoCurrencyCodes, registerComponentSchema, renderSchemaDescription, validateCountryCode, validateCurrencyCode, validateDateTimeISO, validateEmail, validateLanguage, validateName, validatePercentage, validatePhone, validateRichText, validateSafeText, validateSemVer, validateUUID, validateUrl, validateUserId, validateUserIdArray };
+/** Event classes that can be observed by a player. */
+declare const PLAYER_SYSTEM_EVENT_KINDS: readonly ["combat", "social", "mission", "crafting", "world"];
+type PlayerSystemEventKind = (typeof PLAYER_SYSTEM_EVENT_KINDS)[number];
+/** Achievement tiers exposed by the curated player projection. */
+declare const PLAYER_SYSTEM_ACHIEVEMENT_TIERS: readonly ["bronze", "silver", "gold"];
+type PlayerSystemAchievementTier = (typeof PLAYER_SYSTEM_ACHIEVEMENT_TIERS)[number];
+/** Projection states for an achievement progress track. */
+declare const PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES: readonly ["tracking", "earned"];
+type PlayerSystemAchievementTrackStatus = (typeof PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES)[number];
+/** A player-observable event accepted at the ingestion boundary. */
+interface PlayerSystemObservedEvent {
+    id: string;
+    playerId: string;
+    occurredAt: string;
+    kind: PlayerSystemEventKind;
+    title: string;
+    summary: string;
+    highlighted: boolean;
+}
+/** A raw event batch written to the blob-backed ingestion zone. */
+interface PlayerSystemObservedEventBatch {
+    source: string;
+    emittedAt: string;
+    events: readonly PlayerSystemObservedEvent[];
+}
+/** A normalized event enriched with its deterministic deduplication key. */
+interface PlayerSystemNormalizedObservedEvent extends PlayerSystemObservedEvent {
+    deterministicKey: string;
+}
+/** A normalized event batch written by the projection processor. */
+interface PlayerSystemNormalizedEventBatch {
+    sourceBlobName: string;
+    processedAt: string;
+    events: readonly PlayerSystemNormalizedObservedEvent[];
+}
+/** A highlighted event shown in the curated player Event Log. */
+interface PlayerSystemEventHighlight {
+    id: string;
+    title: string;
+    summary: string;
+    occurredAt: string;
+    kind: PlayerSystemEventKind;
+}
+/** A recent event shown in the curated player Event Log. */
+interface PlayerSystemEventEntry extends PlayerSystemEventHighlight {
+    highlighted: boolean;
+}
+/** An earned or explainable achievement projected from observed events. */
+interface PlayerSystemAchievementEntry {
+    id: string;
+    title: string;
+    tier: PlayerSystemAchievementTier;
+    progressLabel: string;
+    earnedAt?: string;
+}
+/** Progress toward an achievement projected from observed events. */
+interface PlayerSystemAchievementTrack {
+    id: string;
+    title: string;
+    current: number;
+    target: number;
+    status: PlayerSystemAchievementTrackStatus;
+}
+/** Curated per-player Event Log and Achievement read model. */
+interface PlayerSystemCuratedSnapshot {
+    playerId: string;
+    projectedAt: string;
+    lastObservedAt: string;
+    highlights: readonly PlayerSystemEventHighlight[];
+    events: readonly PlayerSystemEventEntry[];
+    achievements: readonly PlayerSystemAchievementEntry[];
+    tracks: readonly PlayerSystemAchievementTrack[];
+}
+/** Schema for raw player-observable event batches. */
+declare const PlayerSystemObservedEventBatchSchema: Schema<{
+    source: FieldBuilder<string, string>;
+    emittedAt: FieldBuilder<string, string>;
+    events: FieldBuilder<unknown, unknown>;
+}>;
+/** Schema for normalized event batches used by projections and gossip sourcing. */
+declare const PlayerSystemNormalizedEventBatchSchema: Schema<{
+    sourceBlobName: FieldBuilder<string, string>;
+    processedAt: FieldBuilder<string, string>;
+    events: FieldBuilder<unknown, unknown>;
+}>;
+/** Schema for curated per-player Event Log and Achievement read models. */
+declare const PlayerSystemCuratedSnapshotSchema: Schema<{
+    playerId: FieldBuilder<string, string>;
+    projectedAt: FieldBuilder<string, string>;
+    lastObservedAt: FieldBuilder<string, string>;
+    highlights: FieldBuilder<unknown, unknown>;
+    events: FieldBuilder<unknown, unknown>;
+    achievements: FieldBuilder<unknown, unknown>;
+    tracks: FieldBuilder<unknown, unknown>;
+}>;
+type PlayerSystemObservedEventBatchEntity = PlayerSystemObservedEventBatch & {
+    type: "player-system-observed-event-batch";
+    version: "1.0.0";
+};
+type PlayerSystemNormalizedEventBatchEntity = PlayerSystemNormalizedEventBatch & {
+    type: "player-system-normalized-event-batch";
+    version: "1.0.0";
+};
+type PlayerSystemCuratedSnapshotEntity = PlayerSystemCuratedSnapshot & {
+    type: "player-system-curated-snapshot";
+    version: "1.0.0";
+};
+
+export { type DeepReadonly, FieldBuilder, type FieldDefinition, type FieldExposure, type FieldType, type FieldTypeMap, type FieldValidator, type FieldValidatorResult, type Infer, IsoLanguageCode, type PIIEnforcement, PLAYER_SYSTEM_ACHIEVEMENT_TIERS, PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES, PLAYER_SYSTEM_EVENT_KINDS, type PlayerSystemAchievementEntry, type PlayerSystemAchievementTier, type PlayerSystemAchievementTrack, type PlayerSystemAchievementTrackStatus, type PlayerSystemCuratedSnapshot, type PlayerSystemCuratedSnapshotEntity, PlayerSystemCuratedSnapshotSchema, type PlayerSystemEventEntry, type PlayerSystemEventHighlight, type PlayerSystemEventKind, type PlayerSystemNormalizedEventBatch, type PlayerSystemNormalizedEventBatchEntity, PlayerSystemNormalizedEventBatchSchema, type PlayerSystemNormalizedObservedEvent, type PlayerSystemObservedEvent, type PlayerSystemObservedEventBatch, type PlayerSystemObservedEventBatchEntity, PlayerSystemObservedEventBatchSchema, type RefEntityId, type Schema, type SchemaOptions, type SchemaShape, type SchemaUpgradeFunction, type SchemaUpgradeResult, type SchemaUpgradeSpec, type SchemaUpgradeStep, type SerializeOptions, type ValidateCompositionOptions, type ValidationIssue, type ValidationIssueInput, type ValidationResult, createComponentSchema, createSchema, field, getAllComponentSchemas, getAllSchemas, getComponentSchema, getSchemaForType, isExtensionSingleton, isExtensionSubtag, isIsoLanguageCode, isPrivateUseSingleton, isPrivateUseSubtag, isRegionSubtag, isScriptSubtag, isVariantSubtag, isoCountryCodes, isoCurrencyCodes, registerComponentSchema, renderSchemaDescription, validateCountryCode, validateCurrencyCode, validateDateTimeISO, validateEmail, validateLanguage, validateName, validatePercentage, validatePhone, validateRichText, validateSafeText, validateSemVer, validateUUID, validateUrl, validateUserId, validateUserIdArray };

package/dist/index.d.ts

@@ -339,8 +339,11 @@ declare function getComponentSchema(type: string): Schema<SchemaShape> | undefin
 declare function getAllComponentSchemas(): [string, Schema<SchemaShape>][];
 
 /**
- * Validates an email string using a simplified RFC 5322-compliant regex.
- * Returns true if the input is a string in the format `name@domain.tld`.
+ * Validates the package's pragmatic dot-domain mailbox subset.
+ *
+ * This intentionally does not claim full RFC 5322 mailbox support (for
+ * example, quoted local parts and address literals are outside the product
+ * contract). The legacy filename is retained for import compatibility.
  */
 declare const validateEmail: (value: unknown) => boolean;
 
@@ -358,8 +361,8 @@ declare const validatePhone: (value: unknown) => boolean;
 declare const validateUrl: (value: unknown) => boolean;
 
 /**
- * Validates a string against the RFC 4122 format for UUIDs.
- * Matches UUIDs of versions 1 to 5, e.g., "123e4567-e89b-12d3-a456-426614174000".
+ * Validates the RFC 9562 UUID text format, including versions 1-8 plus Nil and
+ * Max UUIDs. The legacy filename is retained for import compatibility.
  */
 declare const validateUUID: (value: unknown) => boolean;
 
@@ -652,4 +655,112 @@ declare function isPrivateUseSubtag(value: string): boolean;
  */
 declare function validateLanguage(value: unknown): boolean;
 
-export { type DeepReadonly, FieldBuilder, type FieldDefinition, type FieldExposure, type FieldType, type FieldTypeMap, type FieldValidator, type FieldValidatorResult, type Infer, IsoLanguageCode, type PIIEnforcement, type RefEntityId, type Schema, type SchemaOptions, type SchemaShape, type SchemaUpgradeFunction, type SchemaUpgradeResult, type SchemaUpgradeSpec, type SchemaUpgradeStep, type SerializeOptions, type ValidateCompositionOptions, type ValidationIssue, type ValidationIssueInput, type ValidationResult, createComponentSchema, createSchema, field, getAllComponentSchemas, getAllSchemas, getComponentSchema, getSchemaForType, isExtensionSingleton, isExtensionSubtag, isIsoLanguageCode, isPrivateUseSingleton, isPrivateUseSubtag, isRegionSubtag, isScriptSubtag, isVariantSubtag, isoCountryCodes, isoCurrencyCodes, registerComponentSchema, renderSchemaDescription, validateCountryCode, validateCurrencyCode, validateDateTimeISO, validateEmail, validateLanguage, validateName, validatePercentage, validatePhone, validateRichText, validateSafeText, validateSemVer, validateUUID, validateUrl, validateUserId, validateUserIdArray };
+/** Event classes that can be observed by a player. */
+declare const PLAYER_SYSTEM_EVENT_KINDS: readonly ["combat", "social", "mission", "crafting", "world"];
+type PlayerSystemEventKind = (typeof PLAYER_SYSTEM_EVENT_KINDS)[number];
+/** Achievement tiers exposed by the curated player projection. */
+declare const PLAYER_SYSTEM_ACHIEVEMENT_TIERS: readonly ["bronze", "silver", "gold"];
+type PlayerSystemAchievementTier = (typeof PLAYER_SYSTEM_ACHIEVEMENT_TIERS)[number];
+/** Projection states for an achievement progress track. */
+declare const PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES: readonly ["tracking", "earned"];
+type PlayerSystemAchievementTrackStatus = (typeof PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES)[number];
+/** A player-observable event accepted at the ingestion boundary. */
+interface PlayerSystemObservedEvent {
+    id: string;
+    playerId: string;
+    occurredAt: string;
+    kind: PlayerSystemEventKind;
+    title: string;
+    summary: string;
+    highlighted: boolean;
+}
+/** A raw event batch written to the blob-backed ingestion zone. */
+interface PlayerSystemObservedEventBatch {
+    source: string;
+    emittedAt: string;
+    events: readonly PlayerSystemObservedEvent[];
+}
+/** A normalized event enriched with its deterministic deduplication key. */
+interface PlayerSystemNormalizedObservedEvent extends PlayerSystemObservedEvent {
+    deterministicKey: string;
+}
+/** A normalized event batch written by the projection processor. */
+interface PlayerSystemNormalizedEventBatch {
+    sourceBlobName: string;
+    processedAt: string;
+    events: readonly PlayerSystemNormalizedObservedEvent[];
+}
+/** A highlighted event shown in the curated player Event Log. */
+interface PlayerSystemEventHighlight {
+    id: string;
+    title: string;
+    summary: string;
+    occurredAt: string;
+    kind: PlayerSystemEventKind;
+}
+/** A recent event shown in the curated player Event Log. */
+interface PlayerSystemEventEntry extends PlayerSystemEventHighlight {
+    highlighted: boolean;
+}
+/** An earned or explainable achievement projected from observed events. */
+interface PlayerSystemAchievementEntry {
+    id: string;
+    title: string;
+    tier: PlayerSystemAchievementTier;
+    progressLabel: string;
+    earnedAt?: string;
+}
+/** Progress toward an achievement projected from observed events. */
+interface PlayerSystemAchievementTrack {
+    id: string;
+    title: string;
+    current: number;
+    target: number;
+    status: PlayerSystemAchievementTrackStatus;
+}
+/** Curated per-player Event Log and Achievement read model. */
+interface PlayerSystemCuratedSnapshot {
+    playerId: string;
+    projectedAt: string;
+    lastObservedAt: string;
+    highlights: readonly PlayerSystemEventHighlight[];
+    events: readonly PlayerSystemEventEntry[];
+    achievements: readonly PlayerSystemAchievementEntry[];
+    tracks: readonly PlayerSystemAchievementTrack[];
+}
+/** Schema for raw player-observable event batches. */
+declare const PlayerSystemObservedEventBatchSchema: Schema<{
+    source: FieldBuilder<string, string>;
+    emittedAt: FieldBuilder<string, string>;
+    events: FieldBuilder<unknown, unknown>;
+}>;
+/** Schema for normalized event batches used by projections and gossip sourcing. */
+declare const PlayerSystemNormalizedEventBatchSchema: Schema<{
+    sourceBlobName: FieldBuilder<string, string>;
+    processedAt: FieldBuilder<string, string>;
+    events: FieldBuilder<unknown, unknown>;
+}>;
+/** Schema for curated per-player Event Log and Achievement read models. */
+declare const PlayerSystemCuratedSnapshotSchema: Schema<{
+    playerId: FieldBuilder<string, string>;
+    projectedAt: FieldBuilder<string, string>;
+    lastObservedAt: FieldBuilder<string, string>;
+    highlights: FieldBuilder<unknown, unknown>;
+    events: FieldBuilder<unknown, unknown>;
+    achievements: FieldBuilder<unknown, unknown>;
+    tracks: FieldBuilder<unknown, unknown>;
+}>;
+type PlayerSystemObservedEventBatchEntity = PlayerSystemObservedEventBatch & {
+    type: "player-system-observed-event-batch";
+    version: "1.0.0";
+};
+type PlayerSystemNormalizedEventBatchEntity = PlayerSystemNormalizedEventBatch & {
+    type: "player-system-normalized-event-batch";
+    version: "1.0.0";
+};
+type PlayerSystemCuratedSnapshotEntity = PlayerSystemCuratedSnapshot & {
+    type: "player-system-curated-snapshot";
+    version: "1.0.0";
+};
+
+export { type DeepReadonly, FieldBuilder, type FieldDefinition, type FieldExposure, type FieldType, type FieldTypeMap, type FieldValidator, type FieldValidatorResult, type Infer, IsoLanguageCode, type PIIEnforcement, PLAYER_SYSTEM_ACHIEVEMENT_TIERS, PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES, PLAYER_SYSTEM_EVENT_KINDS, type PlayerSystemAchievementEntry, type PlayerSystemAchievementTier, type PlayerSystemAchievementTrack, type PlayerSystemAchievementTrackStatus, type PlayerSystemCuratedSnapshot, type PlayerSystemCuratedSnapshotEntity, PlayerSystemCuratedSnapshotSchema, type PlayerSystemEventEntry, type PlayerSystemEventHighlight, type PlayerSystemEventKind, type PlayerSystemNormalizedEventBatch, type PlayerSystemNormalizedEventBatchEntity, PlayerSystemNormalizedEventBatchSchema, type PlayerSystemNormalizedObservedEvent, type PlayerSystemObservedEvent, type PlayerSystemObservedEventBatch, type PlayerSystemObservedEventBatchEntity, PlayerSystemObservedEventBatchSchema, type RefEntityId, type Schema, type SchemaOptions, type SchemaShape, type SchemaUpgradeFunction, type SchemaUpgradeResult, type SchemaUpgradeSpec, type SchemaUpgradeStep, type SerializeOptions, type ValidateCompositionOptions, type ValidationIssue, type ValidationIssueInput, type ValidationResult, createComponentSchema, createSchema, field, getAllComponentSchemas, getAllSchemas, getComponentSchema, getSchemaForType, isExtensionSingleton, isExtensionSubtag, isIsoLanguageCode, isPrivateUseSingleton, isPrivateUseSubtag, isRegionSubtag, isScriptSubtag, isVariantSubtag, isoCountryCodes, isoCurrencyCodes, registerComponentSchema, renderSchemaDescription, validateCountryCode, validateCurrencyCode, validateDateTimeISO, validateEmail, validateLanguage, validateName, validatePercentage, validatePhone, validateRichText, validateSafeText, validateSemVer, validateUUID, validateUrl, validateUserId, validateUserIdArray };

package/dist/index.js

@@ -223,8 +223,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
@@ -971,10 +971,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);
@@ -994,20 +994,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])) {
@@ -1023,6 +1045,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 = {
@@ -2448,9 +2498,128 @@ 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"
+  }
+);
 export {
   FieldBuilder,
   IsoLanguageCode,
+  PLAYER_SYSTEM_ACHIEVEMENT_TIERS,
+  PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES,
+  PLAYER_SYSTEM_EVENT_KINDS,
+  PlayerSystemCuratedSnapshotSchema,
+  PlayerSystemNormalizedEventBatchSchema,
+  PlayerSystemObservedEventBatchSchema,
   createComponentSchema,
   createSchema,
   field,