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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChristmasFox / Arthur Xu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# PUBG Domain
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+PUBG 的平台无关 Domain：官方 PUBG API client、SQLite match/Telemetry store、确定性查询/比较、时间边界、review facts、证据引用和一次性迁移所需的数据结构。OpenClaw plugin 只调用这里的显式 service；本包不依赖 OpenClaw、LangBot、Mastra、Telegram、n8n 或任何 HTTP gateway。
+
+`config/default-team.json` 是**完全虚构、不具备真实查询能力的 fixture**，不再包含真实 PUBG Account ID。生产插件要求显式的 `PUBG_TEAM_CONFIG_FILE`，从仓库外加载队伍配置；未配置将 fail closed。
+
+初始化自己的小队（根据官方昵称解析官方 PUBG Account ID，默认仅写入 Git 忽略的 `.local/`）：
+
+```sh
+node scripts/init-pubg-team.mjs --players PlayerOne,PlayerTwo --platform steam --api-key-file .local/pubg-api-key
+node --test scripts/test-init-pubg-team.mjs
+```
+
+详见 [Community PUBG Setup](../../docs/COMMUNITY_PUBG_SETUP.md)。API key、WhatsApp pairing 数据、真实队伍 ID 和其他凭据不得进入 Git。旧 Python V2 和 Runtime 只在 Git 历史中保留，不继续维护第二套实现。
+
+## Tenant scope and repository ports
+
+Query execution requires an explicit `TeamContext` containing the tenant ID,
+team ID, and validated roster. The caller must resolve that scope before
+entering the Domain; missing or mismatched scope fails closed. Public
+authorization remains the application's responsibility.
+
+`PubgDomainService` depends on the asynchronous `PubgRepositoryPort`. The
+private OpenClaw adapter wraps its existing SQLite repository in
+`SqlitePubgRepositoryAdapter`, pinned to the configured private scope. Public
+PostgreSQL persistence is a separate adapter in `apps/pubg-saas`; it uses the
+public database and application authorization, independently of private SQLite.
+Both adapters must preserve the same `ToolEnvelope`, evidence, coverage,
+partial/unknown and temporal contracts.
+
+`tests/fixtures/shared-edge-cases.json` locks nine independent synthetic stat
+expectations: KD/zero denominator, revives, squad rank, relative 06:00 periods,
+day grouping, no matches, partial/unknown coverage and comparison ratios. Private
+Domain tests run these without PostgreSQL or the public app. The public suite
+then reads the same fixture through both adapters and compares whole deterministic
+results. It also compares team damage/kick/punch/melee, derived evidence and
+parser/feature cache versions, partial unavailable telemetry, successful zero,
+and cache-only reads after reopening each independent store. These are offline
+fixtures, not live independent deployment or restore acceptance.

package/dist/config/default-team.json

@@ -0,0 +1,27 @@
+{
+    "id": "example_squad",
+    "label": "Demo Squad (fixture only)",
+    "platform": "steam",
+    "players": [
+        {
+            "id": "fixture-player-1",
+            "name": "DemoPlayer01",
+            "aliases": ["demo1"]
+        },
+        {
+            "id": "fixture-player-2",
+            "name": "DemoPlayer02",
+            "aliases": ["demo2"]
+        },
+        {
+            "id": "fixture-player-3",
+            "name": "DemoPlayer03",
+            "aliases": ["demo3"]
+        },
+        {
+            "id": "fixture-player-4",
+            "name": "DemoPlayer04",
+            "aliases": ["demo4"]
+        }
+    ]
+}

package/dist/src/config/chicken-index.d.ts

@@ -0,0 +1,9 @@
+export interface ChickenIndexWeights {
+    kd: number;
+    avgDamage: number;
+    avgKills: number;
+    placement: number;
+    top10Rate: number;
+}
+export declare const CHICKEN_INDEX_WEIGHTS: Readonly<ChickenIndexWeights>;
+export declare function normalizeChickenIndexWeights(override?: Partial<ChickenIndexWeights>): ChickenIndexWeights;

package/dist/src/config/chicken-index.js

@@ -0,0 +1,37 @@
+export const CHICKEN_INDEX_WEIGHTS = Object.freeze({
+    kd: 0.35,
+    avgDamage: 0.3,
+    avgKills: 0.2,
+    placement: 0.1,
+    top10Rate: 0.05,
+});
+export function normalizeChickenIndexWeights(override = {}) {
+    const values = {
+        kd: Number.isFinite(override.kd) && (override.kd ?? 0) >= 0
+            ? Number(override.kd)
+            : CHICKEN_INDEX_WEIGHTS.kd,
+        avgDamage: Number.isFinite(override.avgDamage) && (override.avgDamage ?? 0) >= 0
+            ? Number(override.avgDamage)
+            : CHICKEN_INDEX_WEIGHTS.avgDamage,
+        avgKills: Number.isFinite(override.avgKills) && (override.avgKills ?? 0) >= 0
+            ? Number(override.avgKills)
+            : CHICKEN_INDEX_WEIGHTS.avgKills,
+        placement: Number.isFinite(override.placement) && (override.placement ?? 0) >= 0
+            ? Number(override.placement)
+            : CHICKEN_INDEX_WEIGHTS.placement,
+        top10Rate: Number.isFinite(override.top10Rate) && (override.top10Rate ?? 0) >= 0
+            ? Number(override.top10Rate)
+            : CHICKEN_INDEX_WEIGHTS.top10Rate,
+    };
+    const total = Object.values(values).reduce((sum, value) => sum + value, 0);
+    if (total <= 0)
+        return { ...CHICKEN_INDEX_WEIGHTS };
+    return {
+        kd: values.kd / total,
+        avgDamage: values.avgDamage / total,
+        avgKills: values.avgKills / total,
+        placement: values.placement / total,
+        top10Rate: values.top10Rate / total,
+    };
+}
+//# sourceMappingURL=chicken-index.js.map

package/dist/src/config/chicken-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chicken-index.js","sourceRoot":"","sources":["../../../src/config/chicken-index.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,qBAAqB,GAAkC,MAAM,CAAC,MAAM,CAAC;IAChF,EAAE,EAAE,IAAI;IACR,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,MAAM,UAAU,4BAA4B,CAC1C,WAAyC,EAAE;IAE3C,MAAM,MAAM,GAAG;QACb,EAAE,EACA,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;YACrD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrB,CAAC,CAAC,qBAAqB,CAAC,EAAE;QAC9B,SAAS,EACP,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC5B,CAAC,CAAC,qBAAqB,CAAC,SAAS;QACrC,QAAQ,EACN,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3B,CAAC,CAAC,qBAAqB,CAAC,QAAQ;QACpC,SAAS,EACP,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC5B,CAAC,CAAC,qBAAqB,CAAC,SAAS;QACrC,SAAS,EACP,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC5B,CAAC,CAAC,qBAAqB,CAAC,SAAS;KACtC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3E,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACpD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,KAAK;QACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,KAAK;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,KAAK;QACnC,SAAS,EAAE,MAAM,CAAC,SAAS,GAAG,KAAK;KACpC,CAAC;AACJ,CAAC"}

package/dist/src/config/team.d.ts

@@ -0,0 +1,22 @@
+export interface TeamPlayer {
+    id: string;
+    name: string;
+    aliases: string[];
+}
+export interface TeamConfig {
+    id: string;
+    label: string;
+    platform: string;
+    players: TeamPlayer[];
+}
+export declare function assertTeamConfig(value: unknown): TeamConfig;
+/** Checked-in data is a test fixture; production should load an external file. */
+export declare const DEFAULT_TEAM: TeamConfig;
+export declare const DEFAULT_TEAM_PLAYER_IDS: string[];
+export interface TeamConfigLoadOptions {
+    path?: string;
+    environment?: Readonly<Record<string, string | undefined>>;
+    required?: boolean;
+}
+export declare function loadTeamConfig(options?: TeamConfigLoadOptions): TeamConfig;
+export declare function playerAliasMap(team?: TeamConfig): Map<string, TeamPlayer>;

package/dist/src/config/team.js

@@ -0,0 +1,69 @@
+import { readFileSync } from 'node:fs';
+import defaultTeam from '../../config/default-team.json' with { type: 'json' };
+export function assertTeamConfig(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('invalid_team_config');
+    const candidate = value;
+    const players = Array.isArray(candidate.players) ? candidate.players : [];
+    if (!candidate.id || !candidate.label || !candidate.platform || players.length === 0)
+        throw new Error('invalid_team_config');
+    const normalized = players.map((item) => {
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            throw new Error('invalid_team_player');
+        const player = item;
+        const id = String(player.id ?? '').trim();
+        const name = String(player.name ?? '').trim();
+        const aliases = Array.isArray(player.aliases)
+            ? player.aliases
+                .map(String)
+                .map((alias) => alias.trim())
+                .filter(Boolean)
+            : [];
+        if (!id || !name)
+            throw new Error('invalid_team_player');
+        return { id, name, aliases };
+    });
+    const ids = new Set();
+    for (const player of normalized) {
+        if (ids.has(player.id))
+            throw new Error('duplicate_team_player');
+        ids.add(player.id);
+    }
+    return {
+        id: String(candidate.id),
+        label: String(candidate.label),
+        platform: String(candidate.platform),
+        players: normalized,
+    };
+}
+/** Checked-in data is a test fixture; production should load an external file. */
+export const DEFAULT_TEAM = assertTeamConfig(defaultTeam);
+export const DEFAULT_TEAM_PLAYER_IDS = DEFAULT_TEAM.players.map((player) => player.id);
+export function loadTeamConfig(options = {}) {
+    const environment = options.environment ?? process.env;
+    const filePath = options.path ?? environment.PUBG_TEAM_CONFIG_FILE?.trim();
+    if (!filePath) {
+        if (options.required)
+            throw new Error('team_config_file_required');
+        return DEFAULT_TEAM;
+    }
+    try {
+        return assertTeamConfig(JSON.parse(readFileSync(filePath, 'utf8')));
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('invalid_'))
+            throw error;
+        throw new Error('team_config_unreadable:' + filePath, { cause: error });
+    }
+}
+export function playerAliasMap(team = DEFAULT_TEAM) {
+    const aliases = new Map();
+    for (const player of team.players) {
+        aliases.set(player.id.toLowerCase(), player);
+        aliases.set(player.name.toLowerCase(), player);
+        for (const alias of player.aliases)
+            aliases.set(alias.toLowerCase(), player);
+    }
+    return aliases;
+}
+//# sourceMappingURL=team.js.map

package/dist/src/config/team.js.map

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

package/dist/src/context/context-store.d.ts

@@ -0,0 +1,40 @@
+import type { CanonicalQuery } from '../schema/query.js';
+import type { ResultSetRecord, SessionContextRecord } from '../data/model.js';
+export interface ContextStore {
+    getContext(sessionId: string): Promise<SessionContextRecord | null>;
+    setContext(context: SessionContextRecord): Promise<void>;
+    getResultSet(sessionId: string, resultSetId: string): Promise<ResultSetRecord | null>;
+    setResultSet(result: ResultSetRecord): Promise<void>;
+}
+export declare function sessionId(input: {
+    platform: string;
+    chatId: string;
+    userId: string;
+    domain?: string;
+}): string;
+export declare function emptyContext(id: string, now?: Date): SessionContextRecord;
+export declare class InMemoryContextStore implements ContextStore {
+    private readonly contexts;
+    private readonly results;
+    getContext(id: string): Promise<SessionContextRecord | null>;
+    setContext(value: SessionContextRecord): Promise<void>;
+    getResultSet(session: string, id: string): Promise<ResultSetRecord | null>;
+    setResultSet(value: ResultSetRecord): Promise<void>;
+}
+export declare class JsonContextStore implements ContextStore {
+    private readonly filePath;
+    private queue;
+    constructor(filePath: string);
+    private read;
+    private write;
+    getContext(id: string): Promise<SessionContextRecord | null>;
+    setContext(value: SessionContextRecord): Promise<void>;
+    getResultSet(session: string, id: string): Promise<ResultSetRecord | null>;
+    setResultSet(value: ResultSetRecord): Promise<void>;
+}
+export declare function contextForQuery(query: CanonicalQuery, resultSetId: string, sessionIdValue: string, ttlMs?: number): SessionContextRecord;
+export declare function withSessionId(query: CanonicalQuery, id: string): CanonicalQuery & {
+    reference: CanonicalQuery['reference'] & {
+        sessionId: string;
+    };
+};

package/dist/src/context/context-store.js

@@ -0,0 +1,119 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+function validUntil(value) {
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) && timestamp > Date.now();
+}
+export function sessionId(input) {
+    return [input.platform, input.chatId, input.userId, input.domain ?? 'pubg']
+        .map((part) => encodeURIComponent(String(part || 'unknown')))
+        .join(':');
+}
+export function emptyContext(id, now = new Date()) {
+    return {
+        schemaVersion: 3,
+        sessionId: id,
+        activeDomain: null,
+        lastQuery: null,
+        lastSelector: null,
+        lastResultSetId: null,
+        lastSubject: null,
+        references: {},
+        activeMatchId: null,
+        activeMatchOrdinal: null,
+        activeReviewResultSetId: null,
+        sourceMatchResultSetId: null,
+        updatedAt: now.toISOString(),
+        expiresAt: new Date(now.getTime() + 12 * 60 * 60 * 1000).toISOString(),
+    };
+}
+export class InMemoryContextStore {
+    contexts = new Map();
+    results = new Map();
+    async getContext(id) {
+        const value = this.contexts.get(id);
+        return value && validUntil(value.expiresAt) ? structuredClone(value) : null;
+    }
+    async setContext(value) {
+        this.contexts.set(value.sessionId, structuredClone(value));
+    }
+    async getResultSet(session, id) {
+        const value = this.results.get(session + ':' + id);
+        return value && validUntil(value.expiresAt) ? structuredClone(value) : null;
+    }
+    async setResultSet(value) {
+        this.results.set(value.sessionId + ':' + value.id, structuredClone(value));
+    }
+}
+export class JsonContextStore {
+    filePath;
+    queue = Promise.resolve();
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async read() {
+        try {
+            const value = JSON.parse(await fs.readFile(this.filePath, 'utf8'));
+            return { contexts: value.contexts ?? {}, results: value.results ?? {} };
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+            return { contexts: {}, results: {} };
+        }
+    }
+    async write(mutator) {
+        this.queue = this.queue
+            .catch(() => undefined)
+            .then(async () => {
+            const state = await this.read();
+            mutator(state);
+            await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+            const temporaryPath = this.filePath + '.tmp';
+            await fs.writeFile(temporaryPath, JSON.stringify(state), { mode: 0o600 });
+            await fs.rename(temporaryPath, this.filePath);
+        });
+        return this.queue;
+    }
+    async getContext(id) {
+        const state = await this.read();
+        const value = state.contexts[id];
+        return value && validUntil(value.expiresAt) ? structuredClone(value) : null;
+    }
+    async setContext(value) {
+        await this.write((state) => {
+            state.contexts[value.sessionId] = value;
+        });
+    }
+    async getResultSet(session, id) {
+        const state = await this.read();
+        const value = state.results[session + ':' + id];
+        return value && validUntil(value.expiresAt) ? value : null;
+    }
+    async setResultSet(value) {
+        await this.write((state) => {
+            state.results[value.sessionId + ':' + value.id] = value;
+        });
+    }
+}
+export function contextForQuery(query, resultSetId, sessionIdValue, ttlMs = 12 * 60 * 60 * 1000) {
+    const now = new Date();
+    return {
+        schemaVersion: 3,
+        sessionId: sessionIdValue,
+        activeDomain: 'pubg',
+        lastQuery: query,
+        lastSelector: query.selector,
+        lastResultSetId: resultSetId,
+        lastSubject: query.subject,
+        references: {
+            selectorSource: query.reference.selectorExplicit ? 'tool_input' : 'default',
+        },
+        updatedAt: now.toISOString(),
+        expiresAt: new Date(now.getTime() + ttlMs).toISOString(),
+    };
+}
+export function withSessionId(query, id) {
+    return { ...query, reference: { ...query.reference, sessionId: id } };
+}
+//# sourceMappingURL=context-store.js.map

package/dist/src/context/context-store.js.map

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

package/dist/src/context/team-context.d.ts

@@ -0,0 +1,13 @@
+import type { TeamConfig } from '../config/team.js';
+/**
+ * Trusted scope resolved by the calling application before entering PUBG
+ * Domain. Public callers must derive it from verified platform event data and
+ * persisted ownership; model/tool arguments are never a source for this value.
+ */
+export interface TeamContext {
+    tenantId: string;
+    teamId: string;
+    team: TeamConfig;
+}
+export declare function parseTeamContext(value: unknown): TeamContext;
+export declare function createTeamContext(tenantId: string, team: TeamConfig): TeamContext;

package/dist/src/context/team-context.js

@@ -0,0 +1,16 @@
+import { assertTeamConfig } from '../config/team.js';
+export function parseTeamContext(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('invalid_team_context');
+    const candidate = value;
+    const tenantId = typeof candidate.tenantId === 'string' ? candidate.tenantId.trim() : '';
+    const teamId = typeof candidate.teamId === 'string' ? candidate.teamId.trim() : '';
+    const team = assertTeamConfig(candidate.team);
+    if (!tenantId || !teamId || teamId !== team.id)
+        throw new Error('invalid_team_context');
+    return { tenantId, teamId, team };
+}
+export function createTeamContext(tenantId, team) {
+    return parseTeamContext({ tenantId, teamId: team.id, team });
+}
+//# sourceMappingURL=team-context.js.map

package/dist/src/context/team-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-context.js","sourceRoot":"","sources":["../../../src/context/team-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAarD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAgB;IAClE,OAAO,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/src/core.d.ts

@@ -0,0 +1,23 @@
+/** Platform-neutral PUBG domain entry for runtimes that provide their own
+ * repository. Keep private SQLite and legacy import tools on the package root. */
+export * from './config/chicken-index.js';
+export * from './config/team.js';
+export * from './context/context-store.js';
+export * from './context/team-context.js';
+export * from './data/model.js';
+export * from './data/pubg-api-client.js';
+export * from './engine/query-engine.js';
+export * from './review/types.js';
+export * from './review/telemetry-events.js';
+export * from './review/telemetry.js';
+export * from './review/review-facts.js';
+export * from './review/review-analyzer.js';
+export * from './review/fun-candidate-generator.js';
+export * from './review/fun-intelligence.js';
+export * from './review/supplemental-intelligence.js';
+export * from './review/subgraph.js';
+export * from './schema/query.js';
+export * from './schema/status.js';
+export * from './service/pubg-domain-service.js';
+export * from './storage/repository-port.js';
+export * from './time/selector-resolver.js';

package/dist/src/core.js

@@ -0,0 +1,24 @@
+/** Platform-neutral PUBG domain entry for runtimes that provide their own
+ * repository. Keep private SQLite and legacy import tools on the package root. */
+export * from './config/chicken-index.js';
+export * from './config/team.js';
+export * from './context/context-store.js';
+export * from './context/team-context.js';
+export * from './data/model.js';
+export * from './data/pubg-api-client.js';
+export * from './engine/query-engine.js';
+export * from './review/types.js';
+export * from './review/telemetry-events.js';
+export * from './review/telemetry.js';
+export * from './review/review-facts.js';
+export * from './review/review-analyzer.js';
+export * from './review/fun-candidate-generator.js';
+export * from './review/fun-intelligence.js';
+export * from './review/supplemental-intelligence.js';
+export * from './review/subgraph.js';
+export * from './schema/query.js';
+export * from './schema/status.js';
+export * from './service/pubg-domain-service.js';
+export * from './storage/repository-port.js';
+export * from './time/selector-resolver.js';
+//# sourceMappingURL=core.js.map

package/dist/src/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/core.ts"],"names":[],"mappings":"AAAA;kFACkF;AAClF,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC"}

package/dist/src/data/model.d.ts

@@ -0,0 +1,123 @@
+import type { Coverage, DataStatus, Evidence, SourceInfo } from '../schema/status.js';
+import type { CanonicalQuery, Metric, Selector } from '../schema/query.js';
+import type { MatchPickerModel, MatchReviewResult } from '../review/types.js';
+export interface NormalizedPlayer {
+    accountId: string;
+    playerName: string;
+    displayName: string;
+    rank: number | null;
+    kills: number;
+    assists: number;
+    damage: number;
+    dbnos: number;
+    revives: number;
+    headshotKills: number;
+    survivalTime: number;
+    longestKill: number;
+    deaths: number | null;
+    deathSemantics: 'explicit' | 'placement_proxy' | 'unknown';
+}
+export interface NormalizedMatch {
+    schemaVersion: number;
+    matchId: string;
+    shard: string;
+    createdAt: string | null;
+    timestamp: number;
+    matchType: string;
+    gameMode: string;
+    isCompetitive: boolean;
+    mapName: string;
+    duration: number;
+    patchVersion: string;
+    players: NormalizedPlayer[];
+    telemetryUrl?: string | null;
+}
+export interface DataLayerResult {
+    records: NormalizedMatch[];
+    coverage: Coverage;
+    source: SourceInfo;
+    diagnostics?: Record<string, unknown>;
+}
+export interface QueryRow {
+    key: string;
+    label: string;
+    groupBy: 'player' | 'match' | 'day' | 'map' | 'mode' | 'team';
+    metrics: Record<string, number | null | string>;
+    matchId?: string;
+    timestamp?: number | null;
+    createdAt?: string | null;
+    mapName?: string;
+    gameMode?: string;
+    duration?: number;
+    players?: NormalizedPlayer[];
+    activityStatus?: 'ACTIVE' | 'NO_ACTIVITY';
+    bestRank?: number | null;
+    position?: number;
+    tied?: boolean;
+    comparisonRatios?: Record<string, number | null>;
+}
+export interface OperationData {
+    operation: CanonicalQuery['operation'];
+    groupBy: CanonicalQuery['groupBy'];
+    metric?: Metric;
+    direction?: 'asc' | 'desc';
+    rows: QueryRow[];
+    summary: Record<string, unknown>;
+    segments?: Array<{
+        label: string;
+        selector: Selector;
+        rows: QueryRow[];
+        summary: Record<string, unknown>;
+    }>;
+    dailySeries?: QueryRow[];
+    change?: Record<string, unknown>;
+    highlights?: Record<string, QueryRow[]>;
+}
+export interface StructuredResult {
+    queryId: string;
+    sessionId: string;
+    status: DataStatus;
+    data: OperationData;
+    coverage: Coverage;
+    source: SourceInfo;
+    evidence: Evidence;
+    resultSetId?: string;
+    diagnostics: Record<string, unknown>;
+    review?: MatchReviewResult;
+    matchPicker?: MatchPickerModel;
+}
+export interface ResultSetRecord {
+    id: string;
+    queryId: string;
+    sessionId: string;
+    resolvedQuery: CanonicalQuery;
+    resolvedSelector: Selector;
+    playerIds: string[];
+    matchIds: string[];
+    rows: QueryRow[];
+    aggregates: Record<string, unknown>;
+    rankings: QueryRow[];
+    coverage: Coverage;
+    status: DataStatus;
+    source: SourceInfo;
+    createdAt: string;
+    expiresAt: string;
+}
+export interface SessionContextRecord {
+    schemaVersion: 3;
+    sessionId: string;
+    activeDomain: 'pubg' | 'homehub' | null;
+    lastQuery: CanonicalQuery | null;
+    lastSelector: Selector | null;
+    lastResultSetId: string | null;
+    lastSubject: CanonicalQuery['subject'] | null;
+    references: Record<string, unknown>;
+    activeMatchId?: string | null;
+    activeMatchOrdinal?: number | null;
+    activeReviewResultSetId?: string | null;
+    sourceMatchResultSetId?: string | null;
+    updatedAt: string;
+    expiresAt: string;
+}
+export declare function numberOr(value: unknown, fallback?: number): number;
+export declare function normalizeRecords(records: unknown[]): NormalizedMatch[];