import { CrowdyGraphQLError } from '../errors.js';
import type { GameModelAPI } from '../domains/gameModel.js';
import type { GameModelInvokeMutation } from '../generated/graphql.js';
/** The raw server result of a `gameModelInvoke` call. */
export type RawInvokeResult = GameModelInvokeMutation['gameModelInvoke'];
/**
 * A kit invoke outcome: the server's authority/evaluation verdict plus the
 * parsed return value. Authority denials and expression errors are **not**
 * exceptions — check {@link success}.
 *
 * Older `cks-game-api` builds violate that contract for policy denials: they
 * throw a GraphQL error with `extensions.code === 'FORBIDDEN'` instead of
 * resolving with `success: false`. {@link kitInvoke} tolerates both server
 * generations by mapping that error onto a denial result — see {@link raw}
 * for how to recognize the mapped case.
 */
export interface KitInvokeResult<T = unknown> {
    /** `false` when the invoke policy denied the caller or the logic errored (rolled back). */
    success: boolean;
    /** The parsed `returnValueJson`, when present and `success` is true. */
    returnValue?: T;
    /** The server's error message when `success` is false. */
    errorMessage?: string;
    /**
     * The full server result (event id, applied mutations, …).
     *
     * When an older server reported a policy denial as a `FORBIDDEN` GraphQL
     * error (see the interface doc above), no server result exists; the SDK
     * synthesizes a minimal one — `success: false`, `errorMessage` from the
     * GraphQL error, `eventId: ''`, and no applied mutations.
     */
    raw: RawInvokeResult;
}
/**
 * Is this thrown error a **gameplay verdict** rather than a transport/user
 * error — i.e. should a kit invoke helper resolve `{ success: false }`
 * instead of rethrowing? Two server shapes qualify:
 *
 * 1. `FORBIDDEN` — older `cks-game-api` builds threw this for invoke-policy
 *    denials instead of resolving with `success: false`.
 * 2. `BAD_REQUEST` with a message starting `"Invoke params violate"` — the
 *    typed invoke-contract violation `computeInvoke` raises when declared
 *    params fail pre-sandbox validation (game-api 2026-07-19+). To a kit
 *    caller that is a referee "no", not an exception.
 *
 * Anything else (UNAUTHENTICATED, rate limits, network failures, other
 * BAD_REQUESTs like a disabled module) stays a thrown error.
 */
export declare function isKitVerdictError(error: unknown): error is CrowdyGraphQLError;
/** Wrap a raw invoke result, parsing the JSON return value. */
export declare function toKitInvokeResult<T>(raw: RawInvokeResult): KitInvokeResult<T>;
/**
 * Invoke a model function and wrap the result.
 *
 * Server-generation tolerance: current `cks-game-api` builds resolve policy
 * denials with `success: false` (the kit contract), but older builds throw a
 * {@link CrowdyGraphQLError} with `extensions.code === 'FORBIDDEN'` instead.
 * This helper catches every {@link isKitVerdictError | gameplay-verdict
 * error} (the legacy FORBIDDEN denial and the typed invoke-contract
 * violation) and maps it to a `{ success: false, errorMessage }` result with
 * a synthesized {@link KitInvokeResult.raw}, so kit callers see one contract
 * against both server generations. Any other error is rethrown unchanged.
 */
export declare function kitInvoke<T = unknown>(gameModel: GameModelAPI, input: {
    appId: string;
    functionName: string;
    selfContainerId: string;
    params?: Record<string, unknown>;
    sessionId?: string;
}): Promise<KitInvokeResult<T>>;
/** Read a container's visible properties as a parsed object. */
export declare function kitContainerProperties(gameModel: GameModelAPI, appId: string, containerId: string): Promise<Record<string, unknown>>;
//# sourceMappingURL=shared.d.ts.map