zuburi-game-platform 0.1.0

package/README.md

@@ -0,0 +1,214 @@
+# zuburi-game-platform
+
+ZUBURI のゲームから KZTK Game Platform を利用するための、React 非依存 TypeScript SDK です。
+
+このパッケージは **npmjs.org の public package** として配布します。リポジトリ全体ではなく、`packages/game-platform` の内容だけが publish 対象です。
+
+## Package
+
+```text
+Package:  zuburi-game-platform
+Registry: https://registry.npmjs.org/
+```
+
+## Install
+
+GitHub Packages 用の `.npmrc` や GitHub 認証は不要です。
+
+```bash
+pnpm add zuburi-game-platform @supabase/supabase-js
+```
+
+npm / yarn など、npm registry を利用できる別の package manager からも通常どおり install できます。
+
+## Basic usage
+
+SDK は Supabase Client を生成しません。ゲームが既に利用している、ログイン Session 付きの Client を注入します。
+
+```ts
+import { createGamePlatformClient } from 'zuburi-game-platform'
+import { supabase } from '../lib/supabase'
+
+export const platform = createGamePlatformClient({
+  supabase,
+  gameId: 'coffee_roaster',
+})
+
+const state = await platform.getState()
+const account = await platform.points.getAccount()
+const achievements = await platform.achievements.list()
+```
+
+`service_role` / Supabase Secret key / `userId` は SDK に渡しません。ユーザーは Backend が `auth.uid()` から判定します。
+
+## Client events
+
+Admin で `client` または `both` に設定された Event のみ送信できます。
+
+```ts
+await platform.events.emit({
+  type: 'tutorial_completed',
+  sourceId: 'tutorial:v1',
+})
+```
+
+`sourceId` がある場合、標準の idempotency key は次です。
+
+```text
+{gameId}:{eventType}:{sourceId}
+```
+
+明示的な `idempotencyKey` がある場合はそちらを優先します。
+
+## Typed game-local events
+
+```ts
+type CoffeeRoasterEvents = {
+  tutorial_completed: {
+    value?: never
+    metadata?: never
+  }
+
+  roast_completed: {
+    value: number
+    metadata?: {
+      difficulty?: 'normal' | 'hard'
+    }
+  }
+}
+
+const platform = createGamePlatformClient<CoffeeRoasterEvents>({
+  supabase,
+  gameId: 'coffee_roaster',
+})
+```
+
+Event Definition はゲーム側で型を持ち、共通 SDK 自体へゲーム固有 Event をハードコードしません。
+
+## Points
+
+```ts
+const account = await platform.points.getAccount()
+
+const page = await platform.points.listTransactions({
+  limit: 30,
+  cursor: null,
+})
+```
+
+ポイント額は Backend / Admin ルールで決定します。SDK に `points.add()` や `points.set()` はありません。
+
+## Achievements
+
+```ts
+const achievements = await platform.achievements.list()
+```
+
+現在のゲーム固有実績と Global 実績を取得します。進捗・解除判定・報酬付与は Backend が行います。
+
+## Login bonus
+
+```ts
+const status = await platform.loginBonus.getStatus()
+const result = await platform.loginBonus.claimAvailable()
+```
+
+特定 Campaign だけ受け取る場合:
+
+```ts
+await platform.loginBonus.claimProgram('summer_campaign_2026')
+```
+
+`claimAvailable()` は Backend が現在有効な Standard と Campaign を選択します。ゲーム固有 Standard がある場合は Global Standard より優先されます。
+
+## Development write guard
+
+```ts
+const platform = createGamePlatformClient({
+  supabase,
+  gameId: 'coffee_roaster',
+  writesEnabled: import.meta.env.VITE_DEVELOPMENT_MODE !== 'true',
+})
+```
+
+`writesEnabled=false` の場合、Event送信とLogin Bonus claimは `WRITE_DISABLED` になります。これは開発事故防止であり、セキュリティ境界ではありません。
+
+## Security boundary
+
+SDKは意図的に以下を提供しません。
+
+```text
+points.add()
+points.set()
+achievements.unlock()
+achievements.setProgress()
+events.emitTrusted()
+```
+
+スコア、勝敗、ゲーム終了など改ざん耐性が必要な処理は、ゲーム固有 RPC で検証して Trusted Event を発火してください。
+
+## Repository development
+
+この monorepo は pnpm workspace を使用します。repository root で実行してください。
+
+```bash
+pnpm install
+pnpm check
+```
+
+workspace 定義は `pnpm-workspace.yaml`、使用する pnpm version は root `package.json` の `packageManager` で固定しています。
+
+## Publishing
+
+GitHub Actions の利用時間を抑えるため、release用のbuildは**ローカルマシンで作成してrepositoryへcommit**します。
+
+repository rootで:
+
+```bash
+pnpm release:prepare
+```
+
+これによりローカルでtypecheck / test / buildを行い、次を生成します。
+
+```text
+packages/game-platform/dist/
+packages/game-platform/release-build.json
+```
+
+`release-build.json` にはsourceとdistのSHA-256が記録されるため、build後にsourceだけ変更した状態ではRelease Actionが失敗します。
+
+生成物をcommitしてmainへpushします。
+
+```bash
+git add pnpm-lock.yaml packages/game-platform/dist packages/game-platform/release-build.json packages/game-platform/package.json packages/game-platform/README.md
+git commit -m "Prepare game platform SDK release"
+git push origin main
+```
+
+その後:
+
+```text
+Actions
+→ Release Game Platform SDK
+→ Run workflow
+→ Branch: main
+→ Run workflow
+```
+
+Release Action側では **pnpm install / typecheck / test / buildを実行しません**。commit済みartifactのhash検証、`npm pack --dry-run`、tag作成、npmjs.orgへのpublish、GitHub Release作成だけを行います。
+
+実際の registry publish に `npm publish` を使うのは、npm Trusted Publishing / OIDC 認証を npm CLI が処理するためです。workspace の package manager は pnpm のままです。
+
+初回 publish だけは npm にパッケージがまだ存在しないため、GitHub Actions secret `NPM_TOKEN` を一時的に使用できます。初回 publish 後は npmjs.com の package settings で `ZUBURI/kztk-game-platform` の `publish-sdk.yml` を Trusted Publisher に登録し、`npm publish` を許可してください。その後は `NPM_TOKEN` を削除し、OIDC で publish できます。
+
+ローカルでprebuilt artifactだけ再確認する場合:
+
+```bash
+pnpm release:verify
+```
+
+詳細は [`../../docs/PUBLISHING.md`](../../docs/PUBLISHING.md) を参照してください。
+
+## Supported backend
+
+KZTK Game Platform Backend API v1 を対象とします。

package/dist/achievements/listAchievements.d.ts

@@ -0,0 +1,5 @@
+import { type SupabaseRpcClient } from "../internal/callRpc.js";
+import type { GamePlatformLogger } from "../types/api.js";
+import type { AchievementState } from "../types/achievement.js";
+export declare function listAchievements(supabase: SupabaseRpcClient, gameId: string, logger?: GamePlatformLogger): Promise<AchievementState[]>;
+//# sourceMappingURL=listAchievements.d.ts.map

package/dist/achievements/listAchievements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listAchievements.d.ts","sourceRoot":"","sources":["../../src/achievements/listAchievements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAGxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG7B"}

package/dist/achievements/listAchievements.js

@@ -0,0 +1,8 @@
+import { callRpc } from "../internal/callRpc.js";
+import { mapAchievementState } from "../internal/mappers.js";
+import { array, record } from "../internal/validators.js";
+export async function listAchievements(supabase, gameId, logger) {
+    const raw = await callRpc(supabase, "game_platform_v1_list_achievements", { p_game_id: gameId }, { logger });
+    return array(record(raw, "achievement response").items, "achievement response.items").map(mapAchievementState);
+}
+//# sourceMappingURL=listAchievements.js.map

package/dist/achievements/listAchievements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listAchievements.js","sourceRoot":"","sources":["../../src/achievements/listAchievements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0B,MAAM,wBAAwB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAIzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAA2B,EAC3B,MAAc,EACd,MAA2B;IAE3B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAU,QAAQ,EAAE,oCAAoC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACrH,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;AAChH,CAAC"}

package/dist/client/createGamePlatformClient.d.ts

@@ -0,0 +1,4 @@
+import type { EventMap, DefaultEventMap } from "../types/event.js";
+import type { CreateGamePlatformClientOptions, GamePlatformClient } from "./types.js";
+export declare function createGamePlatformClient<TEvents extends EventMap = DefaultEventMap>(options: CreateGamePlatformClientOptions): GamePlatformClient<TEvents>;
+//# sourceMappingURL=createGamePlatformClient.d.ts.map

package/dist/client/createGamePlatformClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGamePlatformClient.d.ts","sourceRoot":"","sources":["../../src/client/createGamePlatformClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAqB,MAAM,mBAAmB,CAAA;AAWrF,OAAO,KAAK,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGrF,wBAAgB,wBAAwB,CACtC,OAAO,SAAS,QAAQ,GAAG,eAAe,EAC1C,OAAO,EAAE,+BAA+B,GAAG,kBAAkB,CAAC,OAAO,CAAC,CA4BvE"}

package/dist/client/createGamePlatformClient.js

@@ -0,0 +1,37 @@
+import { GamePlatformError } from "../errors/GamePlatformError.js";
+import { listAchievements } from "../achievements/listAchievements.js";
+import { emitEvent } from "../events/emitEvent.js";
+import { getLoginBonusStatus } from "../login-bonus/getStatus.js";
+import { claimAvailableLoginBonuses } from "../login-bonus/claimAvailable.js";
+import { claimLoginBonusProgram } from "../login-bonus/claimProgram.js";
+import { getPointAccount } from "../points/getAccount.js";
+import { listTransactions } from "../points/listTransactions.js";
+import { getState } from "../state/getState.js";
+export function createGamePlatformClient(options) {
+    const gameId = options.gameId.trim();
+    if (!gameId)
+        throw new GamePlatformError("GAME_NOT_FOUND", "gameId is required");
+    const supabase = options.supabase;
+    const writesEnabled = options.writesEnabled ?? true;
+    const logger = options.logger;
+    return Object.freeze({
+        gameId,
+        getState: () => getState(supabase, gameId, logger),
+        events: Object.freeze({
+            emit: (input) => emitEvent(supabase, gameId, writesEnabled, input, logger),
+        }),
+        points: Object.freeze({
+            getAccount: () => getPointAccount(supabase, logger),
+            listTransactions: (input) => listTransactions(supabase, input, logger),
+        }),
+        achievements: Object.freeze({
+            list: () => listAchievements(supabase, gameId, logger),
+        }),
+        loginBonus: Object.freeze({
+            getStatus: () => getLoginBonusStatus(supabase, gameId, logger),
+            claimAvailable: () => claimAvailableLoginBonuses(supabase, gameId, writesEnabled, logger),
+            claimProgram: (programId) => claimLoginBonusProgram(supabase, gameId, programId, writesEnabled, logger),
+        }),
+    });
+}
+//# sourceMappingURL=createGamePlatformClient.js.map

package/dist/client/createGamePlatformClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGamePlatformClient.js","sourceRoot":"","sources":["../../src/client/createGamePlatformClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAA;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAK/C,MAAM,UAAU,wBAAwB,CAEtC,OAAwC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IACpC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,iBAAiB,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAA;IAEhF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAwC,CAAA;IACjE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAA;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM;QACN,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QAClD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAuC,KAAwC,EAAE,EAAE,CACvF,SAAS,CAAiB,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC;SAC5E,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC;YACnD,gBAAgB,EAAE,CAAC,KAA+B,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC;SACjG,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,IAAI,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACvD,CAAC;QACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;YACxB,SAAS,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YAC9D,cAAc,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;YACzF,YAAY,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC;SAChH,CAAC;KACH,CAAC,CAAA;AACJ,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,35 @@
+import type { GamePlatformLogger } from "../types/api.js";
+import type { AchievementState } from "../types/achievement.js";
+import type { DefaultEventMap, EmitEventInputFor, EventMap, EventResult } from "../types/event.js";
+import type { LoginBonusClaimResult, LoginBonusSingleClaimResult, LoginBonusStatus } from "../types/loginBonus.js";
+import type { ListTransactionsOptions, PointAccount, PointTransactionPage } from "../types/point.js";
+import type { GamePlatformState } from "../types/state.js";
+export type SupabaseClientLike = {
+    rpc: (...args: any[]) => any;
+};
+export type CreateGamePlatformClientOptions = {
+    supabase: SupabaseClientLike;
+    gameId: string;
+    writesEnabled?: boolean;
+    logger?: GamePlatformLogger;
+};
+export type GamePlatformClient<TEvents extends EventMap = DefaultEventMap> = {
+    readonly gameId: string;
+    getState: () => Promise<GamePlatformState>;
+    events: {
+        emit: <TType extends keyof TEvents & string>(input: EmitEventInputFor<TEvents, TType>) => Promise<EventResult>;
+    };
+    points: {
+        getAccount: () => Promise<PointAccount>;
+        listTransactions: (options?: ListTransactionsOptions) => Promise<PointTransactionPage>;
+    };
+    achievements: {
+        list: () => Promise<AchievementState[]>;
+    };
+    loginBonus: {
+        getStatus: () => Promise<LoginBonusStatus>;
+        claimAvailable: () => Promise<LoginBonusClaimResult>;
+        claimProgram: (programId: string) => Promise<LoginBonusSingleClaimResult>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAClG,OAAO,KAAK,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAClH,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,OAAO,SAAS,QAAQ,GAAG,eAAe,IAAI;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1C,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,OAAO,GAAG,MAAM,EACzC,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,KACrC,OAAO,CAAC,WAAW,CAAC,CAAA;KAC1B,CAAA;IACD,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAA;QACvC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;KACvF,CAAA;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;KACxC,CAAA;IACD,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;QAC1C,cAAc,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;QACpD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAA;KAC1E,CAAA;CACF,CAAA"}

package/dist/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":""}

package/dist/errors/GamePlatformError.d.ts

@@ -0,0 +1,11 @@
+export type GamePlatformErrorCode = "AUTH_REQUIRED" | "PROFILE_REQUIRED" | "GAME_NOT_FOUND" | "GAME_INACTIVE" | "EVENT_NOT_FOUND" | "EVENT_NOT_ALLOWED" | "SOURCE_ID_REQUIRED" | "INVALID_EVENT_VALUE" | "INVALID_METADATA" | "IDEMPOTENCY_CONFLICT" | "LOGIN_PROGRAM_NOT_FOUND" | "LOGIN_PROGRAM_NOT_ELIGIBLE" | "NETWORK_ERROR" | "RPC_ERROR" | "INVALID_RESPONSE" | "INVALID_CURSOR" | "INVALID_ARGUMENT" | "API_VERSION_MISMATCH" | "WRITE_DISABLED";
+export declare class GamePlatformError extends Error {
+    readonly code: GamePlatformErrorCode;
+    readonly retryable: boolean;
+    readonly cause: unknown;
+    constructor(code: GamePlatformErrorCode, message: string, options?: {
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=GamePlatformError.d.ts.map

package/dist/errors/GamePlatformError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamePlatformError.d.ts","sourceRoot":"","sources":["../../src/errors/GamePlatformError.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,GACrB,kBAAkB,GAClB,sBAAsB,GACtB,yBAAyB,GACzB,4BAA4B,GAC5B,eAAe,GACf,WAAW,GACX,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,sBAAsB,GACtB,gBAAgB,CAAA;AAEpB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,SAAkB,KAAK,EAAE,OAAO,CAAA;gBAG9B,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAQzD"}

package/dist/errors/GamePlatformError.js

@@ -0,0 +1,13 @@
+export class GamePlatformError extends Error {
+    code;
+    retryable;
+    cause;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = "GamePlatformError";
+        this.code = code;
+        this.retryable = options.retryable ?? false;
+        this.cause = options.cause;
+    }
+}
+//# sourceMappingURL=GamePlatformError.js.map

package/dist/errors/GamePlatformError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamePlatformError.js","sourceRoot":"","sources":["../../src/errors/GamePlatformError.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAuB;IAC3B,SAAS,CAAS;IACT,KAAK,CAAS;IAEhC,YACE,IAA2B,EAC3B,OAAe,EACf,UAAoD,EAAE;QAEtD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAC5B,CAAC;CACF"}

package/dist/errors/normalizeError.d.ts

@@ -0,0 +1,3 @@
+import { GamePlatformError } from "./GamePlatformError.js";
+export declare function normalizeError(error: unknown): GamePlatformError;
+//# sourceMappingURL=normalizeError.d.ts.map

package/dist/errors/normalizeError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeError.d.ts","sourceRoot":"","sources":["../../src/errors/normalizeError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA8B,MAAM,wBAAwB,CAAA;AAsDtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAwBhE"}

package/dist/errors/normalizeError.js

@@ -0,0 +1,69 @@
+import { GamePlatformError } from "./GamePlatformError.js";
+const BUSINESS_CODES = new Set([
+    "AUTH_REQUIRED",
+    "PROFILE_REQUIRED",
+    "GAME_NOT_FOUND",
+    "GAME_INACTIVE",
+    "EVENT_NOT_FOUND",
+    "EVENT_NOT_ALLOWED",
+    "SOURCE_ID_REQUIRED",
+    "INVALID_EVENT_VALUE",
+    "INVALID_METADATA",
+    "IDEMPOTENCY_CONFLICT",
+    "LOGIN_PROGRAM_NOT_FOUND",
+    "LOGIN_PROGRAM_NOT_ELIGIBLE",
+]);
+function asMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    if (error && typeof error === "object" && "message" in error) {
+        const message = error.message;
+        if (typeof message === "string")
+            return message;
+    }
+    return "Unknown RPC error";
+}
+function extractBusinessCode(message) {
+    for (const code of BUSINESS_CODES) {
+        if (message === code || message.startsWith(`${code}:`) || message.includes(` ${code}`)) {
+            return code;
+        }
+    }
+    return null;
+}
+function looksNetworkRelated(error, message) {
+    if (error instanceof TypeError && /fetch|network|connection|socket/i.test(message))
+        return true;
+    return /failed to fetch|networkerror|network request failed|econnreset|etimedout|fetch failed/i.test(message);
+}
+function looksTransientRpc(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    const code = error.code;
+    return typeof code === "string" && ["40001", "40P01", "53300", "57P01", "57P03"].includes(code);
+}
+export function normalizeError(error) {
+    if (error instanceof GamePlatformError)
+        return error;
+    const message = asMessage(error);
+    const businessCode = extractBusinessCode(message);
+    if (businessCode) {
+        return new GamePlatformError(businessCode, message, { cause: error });
+    }
+    if (looksNetworkRelated(error, message)) {
+        return new GamePlatformError("NETWORK_ERROR", message, {
+            retryable: true,
+            cause: error,
+        });
+    }
+    if (looksTransientRpc(error)) {
+        return new GamePlatformError("RPC_ERROR", message, {
+            retryable: true,
+            cause: error,
+        });
+    }
+    return new GamePlatformError("RPC_ERROR", message, { cause: error });
+}
+//# sourceMappingURL=normalizeError.js.map

package/dist/errors/normalizeError.js.map

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

package/dist/events/emitEvent.d.ts

@@ -0,0 +1,5 @@
+import { type SupabaseRpcClient } from "../internal/callRpc.js";
+import type { GamePlatformLogger } from "../types/api.js";
+import type { EmitEventInputFor, EventMap, EventResult } from "../types/event.js";
+export declare function emitEvent<TEvents extends EventMap, TType extends keyof TEvents & string>(supabase: SupabaseRpcClient, gameId: string, writesEnabled: boolean, input: EmitEventInputFor<TEvents, TType>, logger?: GamePlatformLogger): Promise<EventResult>;
+//# sourceMappingURL=emitEvent.d.ts.map

package/dist/events/emitEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitEvent.d.ts","sourceRoot":"","sources":["../../src/events/emitEvent.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAGjF,wBAAsB,SAAS,CAC7B,OAAO,SAAS,QAAQ,EACxB,KAAK,SAAS,MAAM,OAAO,GAAG,MAAM,EAEpC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO,EACtB,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,EACxC,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAgCtB"}

package/dist/events/emitEvent.js

@@ -0,0 +1,25 @@
+import { GamePlatformError } from "../errors/GamePlatformError.js";
+import { callRpc } from "../internal/callRpc.js";
+import { mapEventResult } from "../internal/mappers.js";
+import { createIdempotencyKey } from "./idempotency.js";
+export async function emitEvent(supabase, gameId, writesEnabled, input, logger) {
+    if (!writesEnabled) {
+        throw new GamePlatformError("WRITE_DISABLED", "Game Platform writes are disabled");
+    }
+    const idempotencyKey = createIdempotencyKey(gameId, input.type, "sourceId" in input ? input.sourceId : undefined, "idempotencyKey" in input ? input.idempotencyKey : undefined);
+    const raw = await callRpc(supabase, "game_platform_v1_emit_event", {
+        p_game_id: gameId,
+        p_event_type: input.type,
+        p_value: "value" in input ? input.value ?? null : null,
+        p_source_id: "sourceId" in input ? input.sourceId ?? null : null,
+        p_idempotency_key: idempotencyKey,
+        p_metadata: "metadata" in input ? input.metadata ?? {} : {},
+    }, { logger });
+    const result = mapEventResult(raw);
+    logger?.debug?.("Game Platform event processed", {
+        eventType: input.type,
+        duplicate: result.duplicate,
+    });
+    return result;
+}
+//# sourceMappingURL=emitEvent.js.map

package/dist/events/emitEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitEvent.js","sourceRoot":"","sources":["../../src/events/emitEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,OAAO,EAA0B,MAAM,wBAAwB,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAI7B,QAA2B,EAC3B,MAAc,EACd,aAAsB,EACtB,KAAwC,EACxC,MAA2B;IAE3B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,iBAAiB,CAAC,gBAAgB,EAAE,mCAAmC,CAAC,CAAA;IACpF,CAAC;IAED,MAAM,cAAc,GAAG,oBAAoB,CACzC,MAAM,EACN,KAAK,CAAC,IAAI,EACV,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAChD,gBAAgB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAC7D,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,OAAO,CACvB,QAAQ,EACR,6BAA6B,EAC7B;QACE,SAAS,EAAE,MAAM;QACjB,YAAY,EAAE,KAAK,CAAC,IAAI;QACxB,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;QACtD,WAAW,EAAE,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;QAChE,iBAAiB,EAAE,cAAc;QACjC,UAAU,EAAE,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;KAC5D,EACD,EAAE,MAAM,EAAE,CACX,CAAA;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IAClC,MAAM,EAAE,KAAK,EAAE,CAAC,+BAA+B,EAAE;QAC/C,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/events/idempotency.d.ts

@@ -0,0 +1,2 @@
+export declare function createIdempotencyKey(gameId: string, eventType: string, sourceId?: string, explicitKey?: string): string;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/events/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/events/idempotency.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAaR"}

package/dist/events/idempotency.js

@@ -0,0 +1,14 @@
+export function createIdempotencyKey(gameId, eventType, sourceId, explicitKey) {
+    const explicit = explicitKey?.trim();
+    if (explicit)
+        return explicit;
+    const source = sourceId?.trim();
+    if (source)
+        return `${gameId}:${eventType}:${source}`;
+    const cryptoObject = globalThis.crypto;
+    if (cryptoObject && typeof cryptoObject.randomUUID === "function") {
+        return cryptoObject.randomUUID();
+    }
+    return `gp:${Date.now()}:${Math.random().toString(36).slice(2)}:${Math.random().toString(36).slice(2)}`;
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/events/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/events/idempotency.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,SAAiB,EACjB,QAAiB,EACjB,WAAoB;IAEpB,MAAM,QAAQ,GAAG,WAAW,EAAE,IAAI,EAAE,CAAA;IACpC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,MAAM,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC/B,IAAI,MAAM;QAAE,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAA;IAErD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAA;IACtC,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAClE,OAAO,YAAY,CAAC,UAAU,EAAE,CAAA;IAClC,CAAC;IAED,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;AACzG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createGamePlatformClient } from "./client/createGamePlatformClient.js";
+export type { CreateGamePlatformClientOptions, GamePlatformClient, SupabaseClientLike } from "./client/types.js";
+export { GamePlatformError } from "./errors/GamePlatformError.js";
+export type { GamePlatformErrorCode } from "./errors/GamePlatformError.js";
+export type { GamePlatformLogger, Json, JsonObject } from "./types/api.js";
+export type { AchievementProgress, AchievementState, AchievementUnlocked } from "./types/achievement.js";
+export type { DefaultEventMap, EmitEventInputFor, EventMap, EventResult, EventSpec } from "./types/event.js";
+export type { LoginBonusClaim, LoginBonusClaimResult, LoginBonusProgramState, LoginBonusSingleClaimResult, LoginBonusStatus } from "./types/loginBonus.js";
+export type { ListTransactionsOptions, PointAccount, PointTransaction, PointTransactionPage } from "./types/point.js";
+export type { GamePlatformState } from "./types/state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAC/E,YAAY,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEhH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAE1E,YAAY,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC1E,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACxG,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5G,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC1J,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACrH,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createGamePlatformClient } from "./client/createGamePlatformClient.js";
+export { GamePlatformError } from "./errors/GamePlatformError.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAG/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist/internal/callRpc.d.ts

@@ -0,0 +1,20 @@
+import type { GamePlatformLogger } from "../types/api.js";
+type RpcErrorLike = {
+    code?: string;
+    message?: string;
+    details?: string;
+    hint?: string;
+};
+export type SupabaseRpcClient = {
+    rpc: (fn: string, args?: Record<string, unknown>) => PromiseLike<{
+        data: unknown;
+        error: RpcErrorLike | null;
+    }>;
+};
+type CallRpcOptions = {
+    logger?: GamePlatformLogger | undefined;
+    retries?: number;
+};
+export declare function callRpc<T>(client: SupabaseRpcClient, name: string, params: Record<string, unknown> | undefined, options?: CallRpcOptions): Promise<T>;
+export {};
+//# sourceMappingURL=callRpc.d.ts.map

package/dist/internal/callRpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callRpc.d.ts","sourceRoot":"","sources":["../../src/internal/callRpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAKzD,KAAK,YAAY,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,CACH,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,WAAW,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;CAChE,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,MAAM,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAID,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAkCZ"}

package/dist/internal/callRpc.js

@@ -0,0 +1,40 @@
+import { normalizeError } from "../errors/normalizeError.js";
+import { GamePlatformError } from "../errors/GamePlatformError.js";
+import { validateApiVersion } from "./validateApiVersion.js";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export async function callRpc(client, name, params, options = {}) {
+    const maxRetries = options.retries ?? 1;
+    let attempt = 0;
+    while (true) {
+        const startedAt = Date.now();
+        try {
+            const { data, error } = await client.rpc(name, params);
+            if (error)
+                throw normalizeError(error);
+            if (data === null || data === undefined) {
+                throw new GamePlatformError("INVALID_RESPONSE", `${name} returned no data`);
+            }
+            validateApiVersion(data);
+            options.logger?.debug?.("Game Platform RPC completed", {
+                rpc: name,
+                durationMs: Date.now() - startedAt,
+                attempt,
+            });
+            return data;
+        }
+        catch (error) {
+            const normalized = normalizeError(error);
+            options.logger?.warn?.("Game Platform RPC failed", {
+                rpc: name,
+                code: normalized.code,
+                retryable: normalized.retryable,
+                attempt,
+            });
+            if (!normalized.retryable || attempt >= maxRetries)
+                throw normalized;
+            attempt += 1;
+            await sleep(100 * attempt);
+        }
+    }
+}
+//# sourceMappingURL=callRpc.js.map

package/dist/internal/callRpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callRpc.js","sourceRoot":"","sources":["../../src/internal/callRpc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAgB5D,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAErF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAyB,EACzB,IAAY,EACZ,MAA2C,EAC3C,UAA0B,EAAE;IAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAA;IACvC,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACtD,IAAI,KAAK;gBAAE,MAAM,cAAc,CAAC,KAAK,CAAC,CAAA;YACtC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxC,MAAM,IAAI,iBAAiB,CAAC,kBAAkB,EAAE,GAAG,IAAI,mBAAmB,CAAC,CAAA;YAC7E,CAAC;YAED,kBAAkB,CAAC,IAAI,CAAC,CAAA;YACxB,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,6BAA6B,EAAE;gBACrD,GAAG,EAAE,IAAI;gBACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,OAAO;aACR,CAAC,CAAA;YACF,OAAO,IAAS,CAAA;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;YACxC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,0BAA0B,EAAE;gBACjD,GAAG,EAAE,IAAI;gBACT,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,OAAO;aACR,CAAC,CAAA;YAEF,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,OAAO,IAAI,UAAU;gBAAE,MAAM,UAAU,CAAA;YACpE,OAAO,IAAI,CAAC,CAAA;YACZ,MAAM,KAAK,CAAC,GAAG,GAAG,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;AACH,CAAC"}