@plasius/schema 1.2.18 → 1.3.0

package/dist/index.d.cts

@@ -655,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

@@ -655,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

@@ -2498,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,