@crowdedkingdoms/crowdyjs 17.4.0 → 17.5.0-dev.1

package/dist/generated/graphql.d.ts

@@ -2371,6 +2371,8 @@ export type CreateSessionInput = {
     participantUserIds?: InputMaybe<Array<Scalars['BigInt']['input']>>;
     /** How the roster is judged: 'actor' (default) expires a joined participant with no fresh Buddy actor in the app after the join grace window; 'none' never expires anybody. Use 'none' for turn-based play that talks GraphQL and channel pings and never replicates an actor (kit.matches does), where the roster's only exits are leave and end. */
     presence?: InputMaybe<Scalars['String']['input']>;
+    /** Optional: copy the app's template rows of the listed container types into the new session at creation (see SessionSeedInput). At most 2,000 rows per session; above that the creation is refused with the count and no session exists. The count of rows stamped is on the session's `created` event (containersSeeded) and on GmSession.seededContainerCount of the create response. */
+    seedFromApp?: InputMaybe<SessionSeedInput>;
 };
 /** Create a team in an app. */
 export type CreateTeamInput = {
@@ -4180,6 +4182,8 @@ export type GmContainerType = {
     instantiableBy: Scalars['String']['output'];
     /** JSON object of developer metadata. */
     metadataJson: Scalars['String']['output'];
+    /** Where this type's rows live. 'session' (default): one row per bindingKey per session, and a client inside a session binds the session's row. 'app': one row per bindingKey for the whole app, shared by every session (state that outlives matches: territory, landmarks, a persistent world). On an app-scoped type, gameModelEnsureContainer / gameModelCreateContainer with a sessionId are refused (CONTAINER_TYPE_APP_SCOPED); bind at app scope and pass the session on gameModelInvoke, where is_participant / is_current_turn are judged against the call's session. Changing 'session' to 'app' is refused while the type holds session-scoped rows. */
+    scope: Scalars['String']['output'];
     /** Stable type name (unique per app); used to reference the type. */
     typeName: Scalars['String']['output'];
 };
@@ -4594,6 +4598,8 @@ export type GmSession = {
     presence: Scalars['String']['output'];
     /** Monotonic change counter. Every event in gameModelSessionChanged carries the revision that produced it; gameModelSessionSnapshot returns the revision it describes. Compare as integers. */
     revision: Scalars['String']['output'];
+    /** On the gameModelCreateSession response only: how many container rows seedFromApp stamped into the session (0 when seedFromApp was given and matched nothing). Null on every other read; the durable record is the containersSeeded field of the created event. */
+    seededContainerCount: Maybe<Scalars['Int']['output']>;
     /** Unique session id. */
     sessionId: Scalars['String']['output'];
     /** Lifecycle status (e.g. active). */
@@ -5442,7 +5448,7 @@ export type Mutation = {
     gameModelCancelTimer: Scalars['Int']['output'];
     /** Instantiate a container (a runtime entity of a given type), optionally within a session, with an owner and initial properties. Subject to the type's instantiableBy rule (admin | member | owner). Requires a valid token. */
     gameModelCreateContainer: GmContainer;
-    /** Create a runtime session: an isolated instance scope for containers (e.g. a match, room, or save) with its own roster, host, admission and capacity. Subject to the app's session creation policy. The caller becomes creator, host (term 1) and a joined participant. Presence is actor presence: a participant with no fresh Buddy actor in the app after the join grace window is expired by the server. Requires a valid token. */
+    /** Create a runtime session: an isolated instance scope for containers (e.g. a match, room, or save) with its own roster, host, admission and capacity. Subject to the app's session creation policy. The caller becomes creator, host (term 1) and a joined participant. Presence is actor presence: a participant with no fresh Buddy actor in the app after the join grace window is expired by the server. With seedFromApp, the app's keyed template rows of the listed types are copied into the new session in the same transaction (max 2000 rows, refused above; no per-row events; count on the created event and on seededContainerCount). The copies seedFromApp stamps are dropped by the retention sweep once the session has been ended for GM_SESSION_CONTAINER_RETENTION_DAYS, when the tier's operator has set it (default 0, disabled); hand-made rows are never purged. Requires a valid token. */
     gameModelCreateSession: GmSession;
     /** Define an app feature key that functions can gate on (via a tier_feature authority rule) and that access tiers can be granted. Idempotent on (app, featureKey). Requires app-admin ('manage_apps'). */
     gameModelDefineFeature: GmAppFeature;
@@ -5478,7 +5484,7 @@ export type Mutation = {
     gameModelRunAutomation: GmAutomationRun;
     /** Arm a one-shot timer: invoke a function once, after a delay. The timer is durable (it survives an API restart) and claimed by exactly one replica, so it fires once. A timer whose deadline passes while the app has no players WAITS rather than firing into an empty world, and fires when somebody returns: late, not lost. Read the clock in the handler rather than assuming the delay you asked for is the delay that elapsed. The target function must be autonomousInvocable, because the fire is headless and runs with system authority rather than a player's — which is also why this needs app-admin ('manage_apps'). For player-driven delays, author a timers effect on a function instead so the delay is part of your game logic. Supply dedupeKey to make re-arming replace the pending timer rather than queue another fire. */
     gameModelScheduleInvoke: GmTimer;
-    /** Bulk-create game-model definitions (container types, property defs, functions) and upsert instances (containers + edges) in one transaction — used to initialize or import a model. Seed containers bind as `seed:` + tempId and re-seed maps tempId to the existing id (containersCreated increments only on insert). Requires app-admin ('manage_apps'). */
+    /** Bulk-create game-model definitions (container types, property defs, functions) and upsert instances (containers + edges) in one transaction — used to initialize or import a model. Seed containers bind as `seed:` + tempId, or as the row's own bindingKey when given (admin-instantiable or bind-policied types only, so a runtime gameModelEnsureContainer later resolves the same row; an existing row is adopted only if its owner matches, so a player who claimed the key first is never written onto); re-seed maps tempId to the existing id and containersCreated increments only on insert. At most 1000 containers per call (BAD_REQUEST above, nothing written); the call is all-or-nothing. Seeded rows fire no container_created automation or change-feed events. Requires app-admin ('manage_apps'). */
     gameModelSeed: GmSeedResult;
     /** Enable or disable an automation. Re-enabling also resets its circuit breaker (closed, zero failures, no pause) so a tripped automation resumes. Requires app-admin ('manage_apps'). */
     gameModelSetAutomationEnabled: GmAutomation;
@@ -6831,7 +6837,7 @@ export type OrgTokenWithSecret = {
     orgId: Scalars['BigInt']['output'];
     /** Unique token id (BigInt as string). */
     orgTokenId: Scalars['BigInt']['output'];
-    /** The plaintext token. Save it now; it is not stored. */
+    /** The plaintext token, returned exactly once. Save it now: only its hash is stored and it cannot be shown again. */
     token: Scalars['String']['output'];
 };
 /** Org-level rollup of per-app monthly egress projections for all shared apps. */
@@ -8029,9 +8035,11 @@ export type Query = {
     gameModelContainer: GmContainer;
     /** Fetch a container with its property values filtered to what the CALLER may see (public always; owner/hidden depend on the caller's relationship to the container). Use this for a player-facing view of an entity. Requires a valid token. */
     gameModelContainerState: GmContainerState;
+    /** Bulk twin of gameModelContainerState: identity plus visible property state for up to 500 containers in one call (BAD_REQUEST above). The same visibility rules apply per row (public always; owner/hidden depend on the CALLER's relationship to each container). Ids the app does not hold are omitted rather than errors; duplicates are returned once; order follows the input. Use it after paging gameModelContainers to pull a level's state in a few calls instead of one per object. Requires a valid token. */
+    gameModelContainerStates: Array<GmContainerState>;
     /** List all container types defined for an app. Requires app-admin ('manage_apps'). */
     gameModelContainerTypes: Array<GmContainerType>;
-    /** List containers in an app, optionally filtered by container type and/or session, by bindingKey (get-by-key read of an ensured container), by property predicates (`where`, requires typeName; the same predicate shape automation selectors use — missing properties fall back to the type default), and paged with offset/limit over the stable created-at ordering. Requires a valid token. */
+    /** List containers in an app, optionally filtered by container type and/or session, by bindingKey (get-by-key read of an ensured container), by property predicates (`where`, requires typeName; the same predicate shape automation selectors use — missing properties fall back to the type default), and paged with offset/limit over the stable (createdAt, containerId) ordering. Pages: an omitted limit returns 200 rows; the maximum is 1000 (BAD_REQUEST above it). Without `where` the page is read in SQL; with `where` the predicates are evaluated after reading up to 10000 rows of the type, and a larger type is refused (narrow with sessionId / bindingKey, or page without where). Requires a valid token. */
     gameModelContainers: Array<GmContainer>;
     /** Query the function-invocation event log (audit trail) with optional filters and pagination. Useful for debugging functions or showing recent activity. Requires a valid token. */
     gameModelEvents: Array<GmEvent>;
@@ -8618,6 +8626,10 @@ export type QueryGameModelContainerStateArgs = {
     appId: Scalars['BigInt']['input'];
     containerId: Scalars['String']['input'];
 };
+export type QueryGameModelContainerStatesArgs = {
+    appId: Scalars['BigInt']['input'];
+    containerIds: Array<Scalars['String']['input']>;
+};
 export type QueryGameModelContainerTypesArgs = {
     appId: Scalars['BigInt']['input'];
 };
@@ -9318,6 +9330,8 @@ export type ScheduleInvokeInput = {
 };
 /** A container (instance) to upsert as part of a seed. Re-seed matches on binding_key `seed:` + tempId; same-name instances are allowed. */
 export type SeedContainerInput = {
+    /** Optional caller-supplied binding key (max 128 chars, opaque) the row upserts on INSTEAD of `seed:` + tempId, on the same unique index gameModelEnsureContainer uses (unique per app + type + the batch sessionId). Lets a deploy tool pre-create the exact rows a runtime gameModelEnsureContainer will later ask for, e.g. a placement-id digest per level object. Allowed only on a type that is admin-instantiable or carries a bindPolicy, so a player cannot have squatted the key first (BAD_REQUEST naming the tempId otherwise). May not begin with `seed:`. A row that already exists under this key is adopted only when its ownerUserId equals this row's (a re-seed); a row with a different owner -- one a player claimed first under a permissive or shadow-mode bind policy -- is a per-row BAD_REQUEST and nothing is written. On adoption properties are upserted onto it and idMapJson maps the tempId to it; containersCreated does not count it. */
+    bindingKey?: InputMaybe<Scalars['String']['input']>;
     /** Optional description. */
     description?: InputMaybe<Scalars['String']['input']>;
     /** Human-friendly display name. */
@@ -9328,7 +9342,7 @@ export type SeedContainerInput = {
     ownerUserId?: InputMaybe<Scalars['BigInt']['input']>;
     /** Initial property values for the container. */
     properties?: InputMaybe<Array<SeedPropertyInput>>;
-    /** Developer-assigned id used for edge references and as the seed binding key (`seed:` + tempId). Re-seed maps this tempId to the existing container id. */
+    /** Developer-assigned id used for edge references and, when bindingKey is omitted, as the seed binding key (`seed:` + tempId). Re-seed maps this tempId to the existing container id. */
     tempId: Scalars['String']['input'];
     /** The container type to instantiate. */
     typeName: Scalars['String']['input'];
@@ -9347,6 +9361,8 @@ export type SeedContainerTypeInput = {
     instantiableBy?: InputMaybe<Scalars['String']['input']>;
     /** JSON object of metadata. */
     metadataJson?: InputMaybe<Scalars['String']['input']>;
+    /** Where this type's rows live. 'session' (default): one row per bindingKey per session, and a client inside a session binds the session's row. 'app': one row per bindingKey for the whole app, shared by every session (state that outlives matches: territory, landmarks, a persistent world). On an app-scoped type, gameModelEnsureContainer / gameModelCreateContainer with a sessionId are refused (CONTAINER_TYPE_APP_SCOPED); bind at app scope and pass the session on gameModelInvoke, where is_participant / is_current_turn are judged against the call's session. Changing 'session' to 'app' is refused while the type holds session-scoped rows. */
+    scope?: InputMaybe<Scalars['String']['input']>;
     /** Stable type name (unique per app). */
     typeName: Scalars['String']['input'];
 };
@@ -9567,6 +9583,13 @@ export type ServiceQuota = {
     /** When the rule was last updated (ISO-8601 UTC timestamp). */
     updatedAt: Scalars['DateTime']['output'];
 };
+/** Stamp a new session's world rows from the app's template rows at creation. For every app-scoped (sessionId null) container of each listed type that carries a bindingKey, one row is created in the new session with the same bindingKey, displayName, description, metadata and ownerUserId, inside the session creation transaction: the session exists with its rows or does not exist. The template rows were written by an admin (gameModelSeed), so the copy is not subject to the creator's instantiableBy or bindPolicy. Later changes to an app row do not propagate and a session row never writes back. Copies are marked (seeded_from_container_id) and are the only rows the ended-session retention sweep may drop, on a tier that has enabled it. */
+export type SessionSeedInput = {
+    /** 'defaults' (default): the copies start at the type's property defaults, no property rows written. 'app': each app row's current property rows are copied onto its copy, raw (not visibility-filtered; the copy is server-side and the source is admin-authored). */
+    initialState?: InputMaybe<Scalars['String']['input']>;
+    /** Container types whose app-scoped keyed rows are copied into the new session. Each must be instantiableBy 'admin' or carry a bindPolicy (the same rule gameModelSeed applies to a caller bindingKey: no player may have claimed one of its keys); a plain member type is BAD_REQUEST, as is an undefined type. Types with no app-scoped keyed rows contribute nothing. */
+    typeNames: Array<Scalars['String']['input']>;
+};
 /** Register/update an app's OAuth client settings for the portal handoff (requires manage_apps on the app). */
 export type SetAppClientSettingsInput = {
     appId: Scalars['BigInt']['input'];
@@ -10499,6 +10522,8 @@ export type UpsertContainerTypeInput = {
     instantiableBy?: InputMaybe<Scalars['String']['input']>;
     /** JSON object of metadata. */
     metadataJson?: InputMaybe<Scalars['String']['input']>;
+    /** Where this type's rows live. 'session' (default): one row per bindingKey per session, and a client inside a session binds the session's row. 'app': one row per bindingKey for the whole app, shared by every session (state that outlives matches: territory, landmarks, a persistent world). On an app-scoped type, gameModelEnsureContainer / gameModelCreateContainer with a sessionId are refused (CONTAINER_TYPE_APP_SCOPED); bind at app scope and pass the session on gameModelInvoke, where is_participant / is_current_turn are judged against the call's session. Changing 'session' to 'app' is refused while the type holds session-scoped rows. */
+    scope?: InputMaybe<Scalars['String']['input']>;
     /** Stable type name (unique per app). Acts as the upsert key. */
     typeName: Scalars['String']['input'];
 };
@@ -14678,6 +14703,7 @@ export type GmSessionFieldsFragment = {
     endReason: string | null;
     createdAt: string;
     presence: string;
+    seededContainerCount: number | null;
 };
 export type GmSessionParticipantFieldsFragment = {
     __typename?: 'GmSessionParticipant';
@@ -14758,6 +14784,7 @@ export type GameModelCreateSessionMutation = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     };
 };
 export type GameModelJoinSessionMutationVariables = Exact<{
@@ -14820,6 +14847,7 @@ export type GameModelSetSessionTurnMutation = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     };
 };
 export type GameModelSetSessionAdmissionMutationVariables = Exact<{
@@ -14846,6 +14874,7 @@ export type GameModelSetSessionAdmissionMutation = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     };
 };
 export type GameModelTransferSessionHostMutationVariables = Exact<{
@@ -14872,6 +14901,7 @@ export type GameModelTransferSessionHostMutation = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     };
 };
 export type GameModelEndSessionMutationVariables = Exact<{
@@ -14898,6 +14928,7 @@ export type GameModelEndSessionMutation = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     };
 };
 export type GameModelCreateContainerMutationVariables = Exact<{
@@ -15015,6 +15046,7 @@ export type GameModelContainersQueryVariables = Exact<{
     appId: Scalars['BigInt']['input'];
     typeName?: InputMaybe<Scalars['String']['input']>;
     sessionId?: InputMaybe<Scalars['String']['input']>;
+    bindingKey?: InputMaybe<Scalars['String']['input']>;
     where?: InputMaybe<Array<GmPropertyPredicateInput> | GmPropertyPredicateInput>;
     limit?: InputMaybe<Scalars['Int']['input']>;
     offset?: InputMaybe<Scalars['Int']['input']>;
@@ -15069,6 +15101,23 @@ export type GameModelContainerStateQuery = {
         propertiesJson: string;
     };
 };
+export type GameModelContainerStatesQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    containerIds: Array<Scalars['String']['input']> | Scalars['String']['input'];
+}>;
+export type GameModelContainerStatesQuery = {
+    __typename?: 'Query';
+    gameModelContainerStates: Array<{
+        __typename?: 'GmContainerState';
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        ownerUserId: string | null;
+        propertiesJson: string;
+    }>;
+};
 export type GameModelTraverseQueryVariables = Exact<{
     appId: Scalars['BigInt']['input'];
     rootId: Scalars['String']['input'];
@@ -15126,6 +15175,7 @@ export type GameModelSessionQuery = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     };
 };
 export type GameModelSessionsQueryVariables = Exact<{
@@ -15156,6 +15206,7 @@ export type GameModelSessionsQuery = {
         endReason: string | null;
         createdAt: string;
         presence: string;
+        seededContainerCount: number | null;
     }>;
 };
 export type GameModelSessionSnapshotQueryVariables = Exact<{
@@ -15186,6 +15237,7 @@ export type GameModelSessionSnapshotQuery = {
             endReason: string | null;
             createdAt: string;
             presence: string;
+            seededContainerCount: number | null;
         };
         participants: Array<{
             __typename?: 'GmSessionParticipant';
@@ -15246,6 +15298,7 @@ export type GameModelSessionInspectQuery = {
             endReason: string | null;
             createdAt: string;
             presence: string;
+            seededContainerCount: number | null;
         };
         participants: Array<{
             __typename?: 'GmSessionParticipantInspection';
@@ -15540,6 +15593,7 @@ export type GameModelUpsertContainerTypeMutation = {
         instantiableBy: string;
         defaultPropertyVisibility: string;
         bindPolicyJson: string | null;
+        scope: string;
         metadataJson: string;
     };
 };
@@ -15781,6 +15835,7 @@ export type GameModelContainerTypesQuery = {
         instantiableBy: string;
         defaultPropertyVisibility: string;
         bindPolicyJson: string | null;
+        scope: string;
         metadataJson: string;
     }>;
 };
@@ -20039,6 +20094,7 @@ export declare const GameModelContainerDocument: DocumentNode<GameModelContainer
 export declare const GameModelContainersDocument: DocumentNode<GameModelContainersQuery, GameModelContainersQueryVariables>;
 export declare const GameModelContainerChangedDocument: DocumentNode<GameModelContainerChangedSubscription, GameModelContainerChangedSubscriptionVariables>;
 export declare const GameModelContainerStateDocument: DocumentNode<GameModelContainerStateQuery, GameModelContainerStateQueryVariables>;
+export declare const GameModelContainerStatesDocument: DocumentNode<GameModelContainerStatesQuery, GameModelContainerStatesQueryVariables>;
 export declare const GameModelTraverseDocument: DocumentNode<GameModelTraverseQuery, GameModelTraverseQueryVariables>;
 export declare const GameModelSessionDocument: DocumentNode<GameModelSessionQuery, GameModelSessionQueryVariables>;
 export declare const GameModelSessionsDocument: DocumentNode<GameModelSessionsQuery, GameModelSessionsQueryVariables>;