@rine-kit/pubg-domain 0.0.0-stage → 0.1.1

package/dist/src/schema/query.js

@@ -0,0 +1,185 @@
+import { z } from 'zod';
+import { DataStatusSchema } from './status.js';
+import { BUSINESS_DAY_START, DEFAULT_TIMEZONE } from '../time/selector-resolver.js';
+export const QUERY_SCHEMA_VERSION = 3;
+export const SubjectSchema = z.object({
+    type: z.enum(['team', 'player', 'players']),
+    ids: z.array(z.string().min(1)),
+    label: z.string().optional(),
+});
+const TimeRangeSelectorSchema = z.object({
+    type: z.literal('time_range'),
+    start: z.string().min(1),
+    end: z.string().min(1),
+    label: z.string().optional(),
+    timezone: z.string().default(DEFAULT_TIMEZONE),
+    businessDayStart: z.string().default(BUSINESS_DAY_START),
+});
+const RelativePeriodSelectorSchema = z.object({
+    type: z.literal('relative_period'),
+    value: z.string().min(1),
+    label: z.string().optional(),
+});
+const RecentDaysSelectorSchema = z.object({
+    type: z.literal('recent_days'),
+    count: z.number().int().min(1).max(366),
+    label: z.string().optional(),
+});
+const LastNMatchesSelectorSchema = z.object({
+    type: z.literal('last_n_matches'),
+    count: z.number().int().min(1).max(1000),
+    offset: z.number().int().min(0).default(0),
+    label: z.string().optional(),
+});
+const ResultSetSelectorSchema = z.object({
+    type: z.literal('result_set'),
+    resultSetId: z.string().min(1),
+    label: z.string().optional(),
+});
+const MatchOrdinalSchema = z.number().int().min(1).max(1000);
+export const MatchRankMetricSchema = z.enum([
+    'teamDamage',
+    'teamKills',
+    'teamAssists',
+    'placement',
+    'duration',
+    'damage',
+    'kills',
+    'assists',
+]);
+// Match selection is deliberately separate from the time selector. The former
+// chooses one item from a resolved ResultSet; it never changes Query semantics.
+export const MatchSelectorSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('match_id'),
+        matchId: z.string().min(1),
+        label: z.string().optional(),
+    }),
+    z.object({ type: z.literal('latest'), recent: z.boolean().optional() }),
+    z.object({ type: z.literal('earliest') }),
+    z.object({ type: z.literal('ordinal'), ordinal: MatchOrdinalSchema }),
+    z.object({ type: z.literal('ordinal_from_end'), ordinal: MatchOrdinalSchema }),
+    z.object({ type: z.literal('filtered'), filters: z.record(z.string(), z.unknown()).default({}) }),
+    z.object({
+        type: z.literal('ranked'),
+        metric: MatchRankMetricSchema,
+        direction: z.enum(['asc', 'desc']),
+    }),
+    z.object({ type: z.literal('active_match') }),
+    z.object({ type: z.literal('previous') }),
+    z.object({ type: z.literal('next') }),
+]);
+export const SelectorSchema = z.discriminatedUnion('type', [
+    TimeRangeSelectorSchema,
+    RelativePeriodSelectorSchema,
+    RecentDaysSelectorSchema,
+    LastNMatchesSelectorSchema,
+    ResultSetSelectorSchema,
+]);
+export const SegmentSchema = z.object({
+    label: z.string().min(1),
+    selector: SelectorSchema,
+});
+export const OperationSchema = z.enum([
+    'report',
+    'detail',
+    'rank',
+    'strongest',
+    'weakest',
+    'compare',
+    'trend',
+    'list',
+    'review_match',
+]);
+export const GroupBySchema = z.enum(['player', 'match', 'day', 'map', 'mode', 'team']);
+export const MetricSchema = z.enum([
+    'matches',
+    'kills',
+    'assists',
+    'damage',
+    'avg_damage',
+    'kd',
+    'deaths',
+    'wins',
+    'top10',
+    'rank',
+    'dbnos',
+    'revives',
+    'headshot_kills',
+    'survival_time',
+    'longest_kill',
+    'performance_score',
+    'chicken_index',
+]);
+export const OrderBySchema = z.object({
+    metric: MetricSchema,
+    direction: z.enum(['asc', 'desc']),
+});
+export const QueryReferenceSchema = z
+    .object({
+    sessionId: z.string().optional(),
+    selectorExplicit: z.boolean().default(false),
+    subjectExplicit: z.boolean().default(false),
+    useResultSet: z.boolean().default(false),
+    resultSetId: z.string().optional(),
+    inheritedFromContext: z.boolean().default(false),
+    inheritedFromResultSet: z.string().optional(),
+    unsupportedCapability: z.string().optional(),
+    planner: z.enum(['openclaw', 'provided']).default('openclaw'),
+})
+    .catchall(z.unknown());
+export const PresentationSchema = z
+    .object({
+    periodLabel: z.string().optional(),
+    renderer: z.string().optional(),
+    profile: z
+        .enum(['default', 'combat', 'weapon', 'vehicle', 'personal', 'fun', 'detailed'])
+        .optional(),
+    compact: z.boolean().default(false),
+})
+    .catchall(z.unknown());
+export const CanonicalQuerySchema = z.object({
+    version: z.literal(QUERY_SCHEMA_VERSION),
+    queryId: z.string().min(1),
+    domain: z.literal('pubg'),
+    subject: SubjectSchema,
+    operation: OperationSchema,
+    selector: SelectorSchema,
+    matchSelector: MatchSelectorSchema.nullable().optional(),
+    segments: z.array(SegmentSchema).default([]),
+    groupBy: GroupBySchema,
+    metrics: z.array(MetricSchema).min(1),
+    filters: z.record(z.string(), z.unknown()).default({}),
+    orderBy: OrderBySchema,
+    limit: z.number().int().min(1).max(1000).nullable(),
+    reference: QueryReferenceSchema.default({
+        selectorExplicit: false,
+        subjectExplicit: false,
+        useResultSet: false,
+        inheritedFromContext: false,
+        planner: 'openclaw',
+    }),
+    presentation: PresentationSchema.default({ compact: false }),
+});
+export const PlannerOutputSchema = CanonicalQuerySchema;
+export const ResultSetSchema = z.object({
+    id: z.string().min(1),
+    queryId: z.string().min(1),
+    sessionId: z.string().min(1),
+    resolvedQuery: CanonicalQuerySchema,
+    resolvedSelector: SelectorSchema,
+    playerIds: z.array(z.string()),
+    matchIds: z.array(z.string()),
+    rows: z.array(z.record(z.string(), z.unknown())),
+    aggregates: z.record(z.string(), z.unknown()).default({}),
+    rankings: z.array(z.record(z.string(), z.unknown())).default([]),
+    coverage: z.record(z.string(), z.unknown()),
+    status: DataStatusSchema,
+    source: z.record(z.string(), z.unknown()),
+    createdAt: z.string(),
+    expiresAt: z.string(),
+});
+export function parseCanonicalQuery(value) {
+    return CanonicalQuerySchema.parse(value);
+}
+//# sourceMappingURL=query.js.map

package/dist/src/schema/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/schema/query.ts"],"names":[],"mappings":"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"}

package/dist/src/schema/status.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export declare const DataStatusSchema: z.ZodEnum<{
+    OK: "OK";
+    NO_MATCHES: "NO_MATCHES";
+    PARTIAL: "PARTIAL";
+    COVERAGE_GAP: "COVERAGE_GAP";
+    SOURCE_UNAVAILABLE: "SOURCE_UNAVAILABLE";
+    INVALID_QUERY: "INVALID_QUERY";
+    UNKNOWN_PLAYER: "UNKNOWN_PLAYER";
+    UNSUPPORTED_CAPABILITY: "UNSUPPORTED_CAPABILITY";
+    STALE: "STALE";
+    MATCH_NOT_FOUND: "MATCH_NOT_FOUND";
+    MATCH_SELECTION_REQUIRED: "MATCH_SELECTION_REQUIRED";
+    REVIEW_PARTIAL: "REVIEW_PARTIAL";
+    FIGHT_ANALYTICS_INVALID: "FIGHT_ANALYTICS_INVALID";
+}>;
+export type DataStatus = z.infer<typeof DataStatusSchema>;
+export declare const CoverageSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        OK: "OK";
+        NO_MATCHES: "NO_MATCHES";
+        PARTIAL: "PARTIAL";
+        COVERAGE_GAP: "COVERAGE_GAP";
+        SOURCE_UNAVAILABLE: "SOURCE_UNAVAILABLE";
+        INVALID_QUERY: "INVALID_QUERY";
+        UNKNOWN_PLAYER: "UNKNOWN_PLAYER";
+        UNSUPPORTED_CAPABILITY: "UNSUPPORTED_CAPABILITY";
+        STALE: "STALE";
+        MATCH_NOT_FOUND: "MATCH_NOT_FOUND";
+        MATCH_SELECTION_REQUIRED: "MATCH_SELECTION_REQUIRED";
+        REVIEW_PARTIAL: "REVIEW_PARTIAL";
+        FIGHT_ANALYTICS_INVALID: "FIGHT_ANALYTICS_INVALID";
+    }>;
+    complete: z.ZodBoolean;
+    coverageStart: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    coverageEnd: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    checkedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failedMatchIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceUnavailable: z.ZodDefault<z.ZodBoolean>;
+    freshness: z.ZodDefault<z.ZodEnum<{
+        unknown: "unknown";
+        fresh: "fresh";
+        stale: "stale";
+    }>>;
+    localComplete: z.ZodOptional<z.ZodBoolean>;
+    queryCovered: z.ZodOptional<z.ZodBoolean>;
+    requiredMatchCount: z.ZodOptional<z.ZodNumber>;
+    availableMatchCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Coverage = z.infer<typeof CoverageSchema>;
+export declare const SourceSchema: z.ZodObject<{
+    store: z.ZodOptional<z.ZodString>;
+    syncInvoked: z.ZodDefault<z.ZodBoolean>;
+    playerApiCalls: z.ZodDefault<z.ZodNumber>;
+    matchApiCalls: z.ZodDefault<z.ZodNumber>;
+    localMatchCount: z.ZodDefault<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type SourceInfo = z.infer<typeof SourceSchema>;
+export declare const EvidenceSchema: z.ZodObject<{
+    matchIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    playerIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    calculation: z.ZodDefault<z.ZodString>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export type Evidence = z.infer<typeof EvidenceSchema>;

package/dist/src/schema/status.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export const DataStatusSchema = z.enum([
+    'OK',
+    'NO_MATCHES',
+    'PARTIAL',
+    'COVERAGE_GAP',
+    'SOURCE_UNAVAILABLE',
+    'INVALID_QUERY',
+    'UNKNOWN_PLAYER',
+    'UNSUPPORTED_CAPABILITY',
+    'STALE',
+    'MATCH_NOT_FOUND',
+    'MATCH_SELECTION_REQUIRED',
+    'REVIEW_PARTIAL',
+    'FIGHT_ANALYTICS_INVALID',
+]);
+export const CoverageSchema = z.object({
+    status: DataStatusSchema,
+    complete: z.boolean(),
+    coverageStart: z.string().nullable().optional(),
+    coverageEnd: z.string().nullable().optional(),
+    checkedAt: z.string().nullable().optional(),
+    failedMatchIds: z.array(z.string()).default([]),
+    sourceUnavailable: z.boolean().default(false),
+    freshness: z.enum(['fresh', 'stale', 'unknown']).default('unknown'),
+    localComplete: z.boolean().optional(),
+    queryCovered: z.boolean().optional(),
+    requiredMatchCount: z.number().int().nonnegative().optional(),
+    availableMatchCount: z.number().int().nonnegative().optional(),
+});
+export const SourceSchema = z
+    .object({
+    store: z.string().optional(),
+    syncInvoked: z.boolean().default(false),
+    playerApiCalls: z.number().int().nonnegative().default(0),
+    matchApiCalls: z.number().int().nonnegative().default(0),
+    localMatchCount: z.number().int().nonnegative().default(0),
+    error: z.string().optional(),
+})
+    .catchall(z.unknown());
+export const EvidenceSchema = z
+    .object({
+    matchIds: z.array(z.string()).default([]),
+    playerIds: z.array(z.string()).default([]),
+    fields: z.array(z.string()).default([]),
+    calculation: z.string().default('deterministic_query_engine'),
+})
+    .catchall(z.unknown());
+//# sourceMappingURL=status.js.map

package/dist/src/schema/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/schema/status.ts"],"names":[],"mappings":"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"}

package/dist/src/service/pubg-domain-service.d.ts

@@ -0,0 +1,192 @@
+import type { TeamConfig } from '../config/team.js';
+import { type TeamContext } from '../context/team-context.js';
+import type { Coverage, Evidence } from '../schema/status.js';
+import type { GroupBy, Metric } from '../schema/query.js';
+import { PubgApiClient } from '../data/pubg-api-client.js';
+import type { PubgRepositoryPort } from '../storage/repository-port.js';
+import { TelemetryWorker, type RawTelemetryArchivePort } from '../review/telemetry.js';
+import type { TeamDamageFact, TeamDamageSource } from '../review/types.js';
+export declare const PUBGMETRIC_VERSION = "pubg-metrics-v1";
+export declare const PUBG_QUERY_VERSION = "pubg-query-v1";
+export declare const PUBG_RESULT_SET_TTL_MS: number;
+export declare const PUBG_REVIEW_SEARCH_MAX_AGE_MS: number;
+export type ToolStatus = 'ok' | 'partial' | 'no_matches' | 'error';
+export interface ToolError {
+    code: string;
+    retryable: boolean;
+    reason: string;
+}
+export interface ToolEnvelope<T = unknown> {
+    status: ToolStatus;
+    data: T;
+    coverage: Coverage;
+    asOf: string;
+    metricVersion: string;
+    queryResolved: Record<string, unknown>;
+    evidenceRefs: Evidence;
+    resultSetId?: string;
+    error?: ToolError;
+}
+export interface SubjectInput {
+    playerIds?: string[];
+    playerNames?: string[];
+    signal?: AbortSignal;
+}
+export interface TimeRangeInput {
+    type: 'time_range';
+    from: string;
+    to: string;
+    timezone?: string;
+    businessDayStart?: string;
+}
+export interface RelativePeriodInput {
+    type: 'relative_period';
+    value: string;
+    label?: string;
+}
+export interface RecentDaysInput {
+    type: 'recent_days';
+    count: number;
+    label?: string;
+}
+export interface LastMatchesInput {
+    type: 'last_n_matches';
+    count: number;
+    offset?: number;
+}
+export interface ResultSetInput {
+    type: 'result_set';
+    resultSetId: string;
+}
+export type ToolSelectorInput = TimeRangeInput | RelativePeriodInput | RecentDaysInput | LastMatchesInput | ResultSetInput;
+export type SearchSelectorInput = TimeRangeInput | RelativePeriodInput | RecentDaysInput;
+export interface StatsToolInput extends SubjectInput {
+    sessionId: string;
+    selector: ToolSelectorInput;
+    metrics: Metric[];
+    operation?: 'report' | 'detail' | 'rank' | 'strongest' | 'weakest' | 'trend' | 'list';
+    groupBy?: GroupBy;
+    orderBy?: {
+        metric: Metric;
+        direction: 'asc' | 'desc';
+    };
+    limit?: number;
+    refresh?: boolean;
+}
+export interface CompareToolInput extends SubjectInput {
+    sessionId: string;
+    segments: Array<{
+        label: string;
+        selector: ToolSelectorInput;
+    }>;
+    metrics: Metric[];
+    groupBy?: GroupBy;
+    orderBy?: {
+        metric: Metric;
+        direction: 'asc' | 'desc';
+    };
+    limit?: number;
+    refresh?: boolean;
+}
+export interface SearchMatchesInput extends SubjectInput {
+    sessionId: string;
+    selector?: SearchSelectorInput;
+    from?: string;
+    to?: string;
+    timezone?: string;
+    gameMode?: string;
+    mapName?: string;
+    sort?: 'asc' | 'desc';
+    page?: number;
+    pageSize?: number;
+    recentN?: number;
+    refresh?: boolean;
+}
+export interface ResolvePlayersInput {
+    sessionId: string;
+    playerNames?: string[];
+    playerIds?: string[];
+    refresh?: boolean;
+    signal?: AbortSignal;
+}
+export interface GetMatchInput {
+    sessionId: string;
+    matchId: string;
+    refresh?: boolean;
+    signal?: AbortSignal;
+}
+export interface GetReviewFactsInput extends GetMatchInput {
+    searchResultSetId: string;
+    playerIds?: string[];
+    categories?: string[];
+}
+export interface GetPeriodReviewInput {
+    sessionId: string;
+    searchResultSetId: string;
+    playerIds?: string[];
+    categories?: string[];
+    signal?: AbortSignal;
+}
+export interface TeamDamageQueryInput {
+    sessionId: string;
+    selector: SearchSelectorInput;
+    /** Explicit configured PUBG name, alias, or account ID; omit both for all directions. */
+    actorPlayer?: string;
+    /** Explicit configured PUBG name, alias, or account ID; omit both for all directions. */
+    victimPlayer?: string;
+    source?: TeamDamageSource;
+    meleeKind?: NonNullable<TeamDamageFact['meleeKind']>;
+    refresh?: boolean;
+    signal?: AbortSignal;
+}
+export interface PrefetchTelemetryInput {
+    maxMatches?: number;
+    maxFetches?: number;
+    concurrency?: number;
+    trigger?: 'hourly' | 'manual';
+    signal?: AbortSignal;
+}
+export interface TelemetrySyncReportInput {
+    reportDate?: string;
+}
+export interface PubgDomainServiceOptions {
+    teamContext: TeamContext;
+    repository: PubgRepositoryPort;
+    apiClient?: PubgApiClient;
+    telemetryWorker?: TelemetryWorker;
+    rawTelemetryArchive?: RawTelemetryArchivePort;
+    timezone?: string;
+    businessDayStart?: string;
+    maxMatches?: number;
+    now?: () => Date;
+    freshnessMs?: number;
+}
+export declare class PubgDomainService {
+    readonly teamContext: TeamContext;
+    readonly repository: PubgRepositoryPort;
+    private readonly apiClient;
+    private readonly telemetryWorker;
+    private readonly timezone;
+    private readonly businessDayStart;
+    private readonly maxMatches;
+    private readonly now;
+    private readonly freshnessMs;
+    private readonly queryEngine;
+    private prefetchInFlight;
+    constructor(options: PubgDomainServiceOptions);
+    get team(): TeamConfig;
+    private refresh;
+    private resolveSubject;
+    resolvePlayers(input: ResolvePlayersInput): Promise<ToolEnvelope>;
+    private errorEnvelope;
+    queryStats(input: StatsToolInput): Promise<ToolEnvelope>;
+    compareStats(input: CompareToolInput): Promise<ToolEnvelope>;
+    searchMatches(input: SearchMatchesInput): Promise<ToolEnvelope>;
+    prefetchTelemetry(input?: PrefetchTelemetryInput): Promise<ToolEnvelope>;
+    private runTelemetryPrefetch;
+    getTelemetrySyncReport(input?: TelemetrySyncReportInput): Promise<ToolEnvelope>;
+    getMatch(input: GetMatchInput): Promise<ToolEnvelope>;
+    getReviewFacts(input: GetReviewFactsInput): Promise<ToolEnvelope>;
+    getPeriodReview(input: GetPeriodReviewInput): Promise<ToolEnvelope>;
+    queryTeamDamage(input: TeamDamageQueryInput): Promise<ToolEnvelope>;
+}