@game-infra/api-schemas-core 0.0.0

package/README.md

@@ -0,0 +1,62 @@
+# @game-infra/api-schemas-core
+
+Generic service API contract: valibot schemas plus [toad-contracts](https://github.com/kibertoad/toad-contracts) `defineApiContract` definitions for auth, savegame, game-entity CRUD, admin backup, feedback, and heartbeat. This is the base contract every game backend and frontend shares; the event-editor, balance, file-storage, and progress-tracker contracts build on it.
+
+Published to npm. Also consumable as sibling source (`exports` points at `src/`).
+
+## Install
+
+```jsonc
+// pnpm sibling checkout
+"@game-infra/api-schemas-core": "link:../../game-infra/packages/schemas/api-schemas-core"
+// or from npm
+"@game-infra/api-schemas-core": "^0.1.0"
+```
+
+`valibot` is a peer dependency (`^1.4.0`); the consumer provides it.
+
+## Usage
+
+Contracts carry method, path, params, and request/response schemas in one object. Build a URL with `pathResolver`, derive the route pattern with `mapApiContractToPath`:
+
+```ts
+import {
+  authLoginContract,
+  gameEntityLoadContract,
+  LoginRequestSchema,
+} from "@game-infra/api-schemas-core";
+import { mapApiContractToPath } from "@toad-contracts/valibot";
+
+authLoginContract.pathResolver(); // '/auth/login'
+gameEntityLoadContract.pathResolver({ gameId: "g1", entityType: "item", entityId: "e1" });
+// '/games/g1/entities/item/e1'
+mapApiContractToPath(gameEntityLoadContract); // '/games/:gameId/entities/:entityType/:entityId'
+```
+
+Register on a Hono service with `@toad-contracts/hono` (`buildHonoRoute`) and call from a frontend with `@toad-contracts/frontend-http-client` (`sendByApiContract`) — both drive off the same contract objects.
+
+The API URL is not hardcoded. Build a resolver per deployment:
+
+```ts
+import { createApiUrlResolver } from "@game-infra/api-schemas-core";
+
+const { getApiUrl } = createApiUrlResolver({ productionUrl: "https://api.example.com" });
+getApiUrl(window.location.hostname); // dev URL on localhost, prod otherwise
+```
+
+## Extension points
+
+- **Entity types**: `entityType` is a plain `string()`. The old `EntityTypes` enum (spell/item/persona/secret) was dropped; games re-tighten it via their own config/validation.
+- **AI provider**: `AI_PROVIDERS` / `AIProviderSchema` are the single source of truth for the `provider` field used across AI endpoints.
+
+## Migrating from golem-forge
+
+The old `ApiPaths` constants and `PathResolvers` / `resolve*Path` helpers are gone. Get a URL from the contract itself with `contract.pathResolver(params)` and the `:param` route pattern with `mapApiContractToPath(contract)`. Prefer driving requests through `@toad-contracts/frontend-http-client` (`sendByApiContract`) and routes through `@toad-contracts/hono` (`buildHonoRoute`), which consume the contract directly so you never touch a raw path. Event-editor and hex routes moved to their own packages.
+
+## Dependencies
+
+`@toad-contracts/core`, `@toad-contracts/valibot`; peer `valibot`. No internal `@game-infra/*` deps.
+
+## Consumers
+
+`core-service` (auth/feedback/backup/heartbeat endpoints), game frontends (`shared-fe`), and the other `*-schemas` packages, which re-use `createSuccessResponseSchema` and `AIProviderSchema`.

package/dist/aiProvider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Supported AI providers.
+ *
+ * Single source of truth for the provider field used by every AI-assisted
+ * endpoint contract (event generation, review, balance assist). Games and
+ * services pick one of these when calling an AI endpoint.
+ *
+ * @example
+ * ```ts
+ * import { AI_PROVIDERS, type AIProviderType } from '@game-infra/api-schemas-core'
+ *
+ * const provider: AIProviderType = 'claude'
+ * console.log(AI_PROVIDERS) // ['claude', 'mistral', 'openai']
+ * ```
+ */
+export declare const AI_PROVIDERS: readonly ["claude", "mistral", "openai"];
+export type AIProviderType = (typeof AI_PROVIDERS)[number];
+/**
+ * Valibot schema accepting any of {@link AI_PROVIDERS}. Use in request schemas
+ * that carry a `provider` field.
+ */
+export declare const AIProviderSchema: import("valibot").UnionSchema<[import("valibot").LiteralSchema<"claude", undefined>, import("valibot").LiteralSchema<"mistral", undefined>, import("valibot").LiteralSchema<"openai", undefined>], undefined>;
+//# sourceMappingURL=aiProvider.d.ts.map

package/dist/aiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiProvider.d.ts","sourceRoot":"","sources":["../src/aiProvider.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+MAAoE,CAAC"}

package/dist/aiProvider.js

@@ -0,0 +1,23 @@
+import { literal, union } from "valibot";
+/**
+ * Supported AI providers.
+ *
+ * Single source of truth for the provider field used by every AI-assisted
+ * endpoint contract (event generation, review, balance assist). Games and
+ * services pick one of these when calling an AI endpoint.
+ *
+ * @example
+ * ```ts
+ * import { AI_PROVIDERS, type AIProviderType } from '@game-infra/api-schemas-core'
+ *
+ * const provider: AIProviderType = 'claude'
+ * console.log(AI_PROVIDERS) // ['claude', 'mistral', 'openai']
+ * ```
+ */
+export const AI_PROVIDERS = ["claude", "mistral", "openai"];
+/**
+ * Valibot schema accepting any of {@link AI_PROVIDERS}. Use in request schemas
+ * that carry a `provider` field.
+ */
+export const AIProviderSchema = union([literal("claude"), literal("mistral"), literal("openai")]);
+//# sourceMappingURL=aiProvider.js.map

package/dist/aiProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiProvider.js","sourceRoot":"","sources":["../src/aiProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAIrE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/apiConfig.d.ts

@@ -0,0 +1,49 @@
+/**
+ * API URL configuration.
+ *
+ * The production URL was hardcoded to a golem-specific host in golem-forge. Here
+ * it is a factory: each consumer supplies its own production/development URLs and
+ * gets back a `getApiUrl(hostname)` resolver. This keeps the schema package free
+ * of any deployment-specific hostnames.
+ */
+/**
+ * Default development API URL (local Cloudflare Worker via `wrangler dev`).
+ */
+export declare const DEFAULT_DEVELOPMENT_API_URL = "http://localhost:8787";
+/**
+ * Options for {@link createApiUrlResolver}.
+ */
+export interface ApiUrlResolverOptions {
+    /** URL used for every non-localhost hostname (your deployed backend). */
+    productionUrl: string;
+    /** URL used when the hostname is `localhost`. Defaults to {@link DEFAULT_DEVELOPMENT_API_URL}. */
+    developmentUrl?: string;
+}
+/**
+ * A hostname-aware API URL resolver.
+ */
+export interface ApiUrlResolver {
+    /** Resolve the API URL for a hostname (e.g. `window.location.hostname`). */
+    getApiUrl(hostname?: string): string;
+    /** The configured production URL. */
+    readonly productionUrl: string;
+    /** The configured development URL. */
+    readonly developmentUrl: string;
+}
+/**
+ * Build an API URL resolver that returns the development URL on `localhost` and
+ * the production URL everywhere else.
+ *
+ * @example
+ * ```ts
+ * import { createApiUrlResolver } from '@game-infra/api-schemas-core'
+ *
+ * const { getApiUrl } = createApiUrlResolver({
+ *   productionUrl: 'https://api.example.com',
+ * })
+ *
+ * getApiUrl(window.location.hostname) // dev on localhost, prod otherwise
+ * ```
+ */
+export declare function createApiUrlResolver(options: ApiUrlResolverOptions): ApiUrlResolver;
+//# sourceMappingURL=apiConfig.d.ts.map

package/dist/apiConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiConfig.d.ts","sourceRoot":"","sources":["../src/apiConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,qCAAqC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAWnF"}

package/dist/apiConfig.js

@@ -0,0 +1,39 @@
+/**
+ * API URL configuration.
+ *
+ * The production URL was hardcoded to a golem-specific host in golem-forge. Here
+ * it is a factory: each consumer supplies its own production/development URLs and
+ * gets back a `getApiUrl(hostname)` resolver. This keeps the schema package free
+ * of any deployment-specific hostnames.
+ */
+/**
+ * Default development API URL (local Cloudflare Worker via `wrangler dev`).
+ */
+export const DEFAULT_DEVELOPMENT_API_URL = "http://localhost:8787";
+/**
+ * Build an API URL resolver that returns the development URL on `localhost` and
+ * the production URL everywhere else.
+ *
+ * @example
+ * ```ts
+ * import { createApiUrlResolver } from '@game-infra/api-schemas-core'
+ *
+ * const { getApiUrl } = createApiUrlResolver({
+ *   productionUrl: 'https://api.example.com',
+ * })
+ *
+ * getApiUrl(window.location.hostname) // dev on localhost, prod otherwise
+ * ```
+ */
+export function createApiUrlResolver(options) {
+    const productionUrl = options.productionUrl;
+    const developmentUrl = options.developmentUrl ?? DEFAULT_DEVELOPMENT_API_URL;
+    return {
+        productionUrl,
+        developmentUrl,
+        getApiUrl(hostname = "localhost") {
+            return hostname === "localhost" ? developmentUrl : productionUrl;
+        },
+    };
+}
+//# sourceMappingURL=apiConfig.js.map

package/dist/apiConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiConfig.js","sourceRoot":"","sources":["../src/apiConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAC;AAwBnE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC5C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,2BAA2B,CAAC;IAE7E,OAAO;QACL,aAAa;QACb,cAAc;QACd,SAAS,CAAC,QAAQ,GAAG,WAAW;YAC9B,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/auth.d.ts

@@ -0,0 +1,92 @@
+import { type InferOutput } from "valibot";
+/**
+ * Validation constants - single source of truth for both FE and BE
+ */
+export declare const AuthValidation: {
+    readonly MIN_PASSWORD_LENGTH: 6;
+    readonly MAX_PASSWORD_LENGTH: 128;
+    readonly MIN_USERNAME_LENGTH: 3;
+    readonly MAX_USERNAME_LENGTH: 64;
+};
+/**
+ * Registration request schema
+ */
+export declare const RegisterRequestSchema: import("valibot").ObjectSchema<{
+    readonly email: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").EmailAction<string, undefined>]>;
+    readonly username: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 3, undefined>, import("valibot").MaxLengthAction<string, 64, undefined>]>;
+    readonly password: import("valibot").SchemaWithPipe<readonly [import("valibot").StringSchema<undefined>, import("valibot").MinLengthAction<string, 6, undefined>, import("valibot").MaxLengthAction<string, 128, undefined>]>;
+}, undefined>;
+export type RegisterRequest = InferOutput<typeof RegisterRequestSchema>;
+/**
+ * Common auth response fields (used by both register and login)
+ */
+export declare const AuthResponseFieldsSchema: {
+    token: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    userId: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    username: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+};
+/**
+ * Registration response schema
+ */
+export declare const RegisterResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    token: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    userId: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    username: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type RegisterResponse = InferOutput<typeof RegisterResponseSchema>;
+/**
+ * Login request schema
+ */
+export declare const LoginRequestSchema: import("valibot").ObjectSchema<{
+    readonly identifier: import("valibot").StringSchema<undefined>;
+    readonly password: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type LoginRequest = InferOutput<typeof LoginRequestSchema>;
+/**
+ * Login response schema
+ * Reuses the same fields as RegisterResponse
+ */
+export declare const LoginResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    token: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    userId: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    username: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type LoginResponse = InferOutput<typeof LoginResponseSchema>;
+/**
+ * Validate token request schema
+ */
+export declare const ValidateTokenRequestSchema: import("valibot").ObjectSchema<{
+    readonly token: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type ValidateTokenRequest = InferOutput<typeof ValidateTokenRequestSchema>;
+/**
+ * Validate token response schema
+ */
+export declare const ValidateTokenResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    valid: import("valibot").OptionalSchema<import("valibot").BooleanSchema<undefined>, undefined>;
+    userId: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    username: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type ValidateTokenResponse = InferOutput<typeof ValidateTokenResponseSchema>;
+/**
+ * Validate service token response schema
+ * Used by other services (e.g., file-storage-service) to validate API tokens against golem-castle
+ * This endpoint validates the shared API_TOKEN used for service-to-service communication
+ */
+export declare const ValidateServiceTokenResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    valid: import("valibot").OptionalSchema<import("valibot").BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type ValidateServiceTokenResponse = InferOutput<typeof ValidateServiceTokenResponseSchema>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAUjB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,eAAO,MAAM,cAAc;aACzB,mBAAmB,EAAE,CAAC;aACtB,mBAAmB,EAAE,GAAG;aACxB,mBAAmB,EAAE,CAAC;aACtB,mBAAmB,EAAE,EAAE;CACf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;aAYhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,wBAAwB;IACnC,KAAK;IACL,MAAM;IACN,QAAQ;CACT,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;aAAwD,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;aAG7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;aAAwD,CAAC;AAEzF,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;aAErC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;aAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEpF;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;;;;aAE7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,OAAO,kCAAkC,CAAC,CAAC"}

package/dist/auth.js

@@ -0,0 +1,66 @@
+import { boolean, email, maxLength, minLength, number, object, optional, pipe, string, } from "valibot";
+import { createSuccessResponseSchema } from "./common.js";
+/**
+ * Validation constants - single source of truth for both FE and BE
+ */
+export const AuthValidation = {
+    MIN_PASSWORD_LENGTH: 6,
+    MAX_PASSWORD_LENGTH: 128,
+    MIN_USERNAME_LENGTH: 3,
+    MAX_USERNAME_LENGTH: 64,
+};
+/**
+ * Registration request schema
+ */
+export const RegisterRequestSchema = object({
+    email: pipe(string(), email()),
+    username: pipe(string(), minLength(AuthValidation.MIN_USERNAME_LENGTH), maxLength(AuthValidation.MAX_USERNAME_LENGTH)),
+    password: pipe(string(), minLength(AuthValidation.MIN_PASSWORD_LENGTH), maxLength(AuthValidation.MAX_PASSWORD_LENGTH)),
+});
+/**
+ * Common auth response fields (used by both register and login)
+ */
+export const AuthResponseFieldsSchema = {
+    token: optional(string()),
+    userId: optional(number()),
+    username: optional(string()),
+};
+/**
+ * Registration response schema
+ */
+export const RegisterResponseSchema = createSuccessResponseSchema(AuthResponseFieldsSchema);
+/**
+ * Login request schema
+ */
+export const LoginRequestSchema = object({
+    identifier: string(), // email or username
+    password: string(),
+});
+/**
+ * Login response schema
+ * Reuses the same fields as RegisterResponse
+ */
+export const LoginResponseSchema = createSuccessResponseSchema(AuthResponseFieldsSchema);
+/**
+ * Validate token request schema
+ */
+export const ValidateTokenRequestSchema = object({
+    token: string(),
+});
+/**
+ * Validate token response schema
+ */
+export const ValidateTokenResponseSchema = createSuccessResponseSchema({
+    valid: optional(boolean()),
+    userId: optional(number()),
+    username: optional(string()),
+});
+/**
+ * Validate service token response schema
+ * Used by other services (e.g., file-storage-service) to validate API tokens against golem-castle
+ * This endpoint validates the shared API_TOKEN used for service-to-service communication
+ */
+export const ValidateServiceTokenResponseSchema = createSuccessResponseSchema({
+    valid: optional(boolean()),
+});
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EACP,KAAK,EACL,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,MAAM,GACP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,mBAAmB,EAAE,CAAC;IACtB,mBAAmB,EAAE,GAAG;IACxB,mBAAmB,EAAE,CAAC;IACtB,mBAAmB,EAAE,EAAE;CACf,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;IAC1C,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC;IAC9B,QAAQ,EAAE,IAAI,CACZ,MAAM,EAAE,EACR,SAAS,CAAC,cAAc,CAAC,mBAAmB,CAAC,EAC7C,SAAS,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAC9C;IACD,QAAQ,EAAE,IAAI,CACZ,MAAM,EAAE,EACR,SAAS,CAAC,cAAc,CAAC,mBAAmB,CAAC,EAC7C,SAAS,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAC9C;CACF,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;AAI5F;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;IACvC,UAAU,EAAE,MAAM,EAAE,EAAE,oBAAoB;IAC1C,QAAQ,EAAE,MAAM,EAAE;CACnB,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;AAIzF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;IAC/C,KAAK,EAAE,MAAM,EAAE;CAChB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;IACrE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,2BAA2B,CAAC;IAC5E,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;CAC3B,CAAC,CAAC"}

package/dist/backup.d.ts

@@ -0,0 +1,82 @@
+import { type InferOutput } from "valibot";
+/**
+ * Backup info schema
+ * Represents metadata about a stored backup
+ */
+export declare const BackupInfoSchema: import("valibot").ObjectSchema<{
+    readonly storageId: import("valibot").StringSchema<undefined>;
+    readonly filename: import("valibot").StringSchema<undefined>;
+    readonly recordCount: import("valibot").NumberSchema<undefined>;
+    readonly size: import("valibot").NumberSchema<undefined>;
+    readonly createdAt: import("valibot").StringSchema<undefined>;
+    readonly gameId: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type BackupInfo = InferOutput<typeof BackupInfoSchema>;
+/**
+ * Trigger backup response schema
+ */
+export declare const TriggerBackupResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    storageId: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    filename: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    recordCount: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    size: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type TriggerBackupResponse = InferOutput<typeof TriggerBackupResponseSchema>;
+/**
+ * List backups response schema
+ */
+export declare const ListBackupsResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    backups: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly storageId: import("valibot").StringSchema<undefined>;
+        readonly filename: import("valibot").StringSchema<undefined>;
+        readonly recordCount: import("valibot").NumberSchema<undefined>;
+        readonly size: import("valibot").NumberSchema<undefined>;
+        readonly createdAt: import("valibot").StringSchema<undefined>;
+        readonly gameId: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type ListBackupsResponse = InferOutput<typeof ListBackupsResponseSchema>;
+/**
+ * Restore from backup request schema
+ */
+export declare const RestoreBackupRequestSchema: import("valibot").ObjectSchema<{
+    readonly storageId: import("valibot").StringSchema<undefined>;
+    readonly gameId: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type RestoreBackupRequest = InferOutput<typeof RestoreBackupRequestSchema>;
+/**
+ * Restore from backup response schema
+ */
+export declare const RestoreBackupResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    restoredCount: import("valibot").OptionalSchema<import("valibot").NumberSchema<undefined>, undefined>;
+    preRestoreBackupStorageId: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type RestoreBackupResponse = InferOutput<typeof RestoreBackupResponseSchema>;
+/**
+ * Download backup response schema
+ * Content is streamed back
+ */
+export declare const DownloadBackupResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    backup: import("valibot").OptionalSchema<import("valibot").ObjectSchema<{
+        readonly storageId: import("valibot").StringSchema<undefined>;
+        readonly filename: import("valibot").StringSchema<undefined>;
+        readonly recordCount: import("valibot").NumberSchema<undefined>;
+        readonly size: import("valibot").NumberSchema<undefined>;
+        readonly createdAt: import("valibot").StringSchema<undefined>;
+        readonly gameId: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type DownloadBackupResponse = InferOutput<typeof DownloadBackupResponseSchema>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAA2C,MAAM,SAAS,CAAC;AAGpF;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;aAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;aAKtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;aAEpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;aAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;aAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;aAEvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/backup.js

@@ -0,0 +1,51 @@
+import { array, number, object, optional, string } from "valibot";
+import { createSuccessResponseSchema } from "./common.js";
+/**
+ * Backup info schema
+ * Represents metadata about a stored backup
+ */
+export const BackupInfoSchema = object({
+    storageId: string(),
+    filename: string(),
+    recordCount: number(),
+    size: number(),
+    createdAt: string(),
+    gameId: string(), // Which game this backup belongs to
+});
+/**
+ * Trigger backup response schema
+ */
+export const TriggerBackupResponseSchema = createSuccessResponseSchema({
+    storageId: optional(string()),
+    filename: optional(string()),
+    recordCount: optional(number()),
+    size: optional(number()),
+});
+/**
+ * List backups response schema
+ */
+export const ListBackupsResponseSchema = createSuccessResponseSchema({
+    backups: optional(array(BackupInfoSchema)),
+});
+/**
+ * Restore from backup request schema
+ */
+export const RestoreBackupRequestSchema = object({
+    storageId: string(),
+    gameId: string(), // Which game database to restore to
+});
+/**
+ * Restore from backup response schema
+ */
+export const RestoreBackupResponseSchema = createSuccessResponseSchema({
+    restoredCount: optional(number()),
+    preRestoreBackupStorageId: optional(string()),
+});
+/**
+ * Download backup response schema
+ * Content is streamed back
+ */
+export const DownloadBackupResponseSchema = createSuccessResponseSchema({
+    backup: optional(BackupInfoSchema),
+});
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE;IACnB,QAAQ,EAAE,MAAM,EAAE;IAClB,WAAW,EAAE,MAAM,EAAE;IACrB,IAAI,EAAE,MAAM,EAAE;IACd,SAAS,EAAE,MAAM,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,EAAE,oCAAoC;CACvD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;IACrE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC/B,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CACzB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;IACnE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;CAC3C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;IAC/C,SAAS,EAAE,MAAM,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,EAAE,oCAAoC;CACvD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;IACrE,aAAa,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACjC,yBAAyB,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC9C,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,2BAA2B,CAAC;IACtE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC;CACnC,CAAC,CAAC"}

package/dist/common.d.ts

@@ -0,0 +1,36 @@
+import { type InferOutput, type ObjectSchema } from "valibot";
+/**
+ * Common base schemas used across all API endpoints
+ * Single source of truth for response wrappers and shared fields
+ */
+/**
+ * Base API response schema with success/error fields
+ * All API responses should extend this schema
+ */
+export declare const ApiResponseSchema: ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type ApiResponse = InferOutput<typeof ApiResponseSchema>;
+/**
+ * Helper to create a success response schema with additional data fields
+ * Usage: createSuccessResponseSchema({ data: string() })
+ */
+export declare function createSuccessResponseSchema<T extends Record<string, any>>(dataFields: T): ObjectSchema<(typeof ApiResponseSchema)["entries"] & T, undefined>;
+/**
+ * Timestamp fields commonly used for entity metadata
+ */
+export declare const TimestampFieldsSchema: ObjectSchema<{
+    readonly createdAt: import("valibot").StringSchema<undefined>;
+    readonly updatedAt: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type TimestampFields = InferOutput<typeof TimestampFieldsSchema>;
+/**
+ * Common metadata fields for entities
+ */
+export declare const EntityMetadataSchema: ObjectSchema<{
+    readonly createdAt: import("valibot").StringSchema<undefined>;
+    readonly updatedAt: import("valibot").StringSchema<undefined>;
+}, undefined>;
+export type EntityMetadata = InferOutput<typeof EntityMetadataSchema>;
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAqC,MAAM,SAAS,CAAC;AAEjG;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;aAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvE,UAAU,EAAE,CAAC,GACZ,YAAY,CAAC,CAAC,OAAO,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAKpE;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;aAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;aAE/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/common.js

@@ -0,0 +1,37 @@
+import { boolean, object, optional, string } from "valibot";
+/**
+ * Common base schemas used across all API endpoints
+ * Single source of truth for response wrappers and shared fields
+ */
+/**
+ * Base API response schema with success/error fields
+ * All API responses should extend this schema
+ */
+export const ApiResponseSchema = object({
+    success: boolean(),
+    error: optional(string()),
+});
+/**
+ * Helper to create a success response schema with additional data fields
+ * Usage: createSuccessResponseSchema({ data: string() })
+ */
+export function createSuccessResponseSchema(dataFields) {
+    return object({
+        ...ApiResponseSchema.entries,
+        ...dataFields,
+    });
+}
+/**
+ * Timestamp fields commonly used for entity metadata
+ */
+export const TimestampFieldsSchema = object({
+    createdAt: string(),
+    updatedAt: string(),
+});
+/**
+ * Common metadata fields for entities
+ */
+export const EntityMetadataSchema = object({
+    ...TimestampFieldsSchema.entries,
+});
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjG;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;IACtC,OAAO,EAAE,OAAO,EAAE;IAClB,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAa;IAEb,OAAO,MAAM,CAAC;QACZ,GAAG,iBAAiB,CAAC,OAAO;QAC5B,GAAG,UAAU;KACd,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;IAC1C,SAAS,EAAE,MAAM,EAAE;IACnB,SAAS,EAAE,MAAM,EAAE;CACpB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;IACzC,GAAG,qBAAqB,CAAC,OAAO;CACjC,CAAC,CAAC"}