@crowdedkingdoms/crowdyjs 7.1.1 → 8.0.1

package/dist/domains/auth.js

@@ -1,207 +1,110 @@
-import { ChangePasswordDocument, ConfirmEmailDocument, LoginDocument, LogoutAllDevicesDocument, LogoutDocument, RegisterDocument, RequestPasswordResetDocument, ResendConfirmationEmailDocument, ResetPasswordDocument, } from '../generated/graphql.js';
-/**
- * Authentication and account-lifecycle flows — exposed as `client.auth`.
- *
- * Targets the **management-api**: every call routes to `managementUrl` (falling
- * back to the game-api endpoint only in legacy single-endpoint mode). The
- * management API owns the `game_tokens` table that backs every login / register
- * / password / email-confirmation flow; the `token` it returns is a
- * `game_tokens` row that game-api validates against the same shared Postgres.
- *
- * {@link login} and {@link register} mint that session token **and** store it on
- * the shared session state automatically, so every later call on *either*
- * endpoint (auth, users, apps, actors, chunks, udp, ...) is authenticated
- * without you threading the token through by hand. Use {@link setToken} to
- * rehydrate a saved token and {@link getToken} to read the current one. `BigInt`
- * ids on the returned user (e.g. `userId`, `orgId`) are decimal strings.
- *
- * **Public — no session required:** {@link login}, {@link register},
- * {@link confirmEmail}, {@link requestPasswordReset}, {@link resetPassword}, and
- * {@link resendConfirmationEmail}. **Require a valid session:** {@link logout},
- * {@link logoutAllDevices}, and {@link changePassword}, which otherwise throw
- * {@link CrowdyGraphQLError} with `UNAUTHENTICATED` when the bearer token is
- * missing, expired, or revoked.
- */
+import { parse } from 'graphql';
+import { LogoutAllDevicesDocument, LogoutDocument } from '../generated/graphql.js';
+const AUTH_RESPONSE_FIELDS = 'token gameTokenId user { userId email gamertag }';
+const IDENTITY_FIELDS = 'identityId provider subject email emailVerified createdAt lastLoginAt';
+const RequestLoginLinkDocument = parse(`mutation RequestLoginLink($input: RequestLoginLinkInput!) { requestLoginLink(input: $input) { sent devToken } }`);
+const CompleteLoginLinkDocument = parse(`mutation CompleteLoginLink($input: CompleteLoginLinkInput!) { completeLoginLink(input: $input) { ${AUTH_RESPONSE_FIELDS} } }`);
+const SocialLoginStartDocument = parse(`mutation SocialLoginStart($input: SocialLoginStartInput!) { socialLoginStart(input: $input) { authorizeUrl state } }`);
+const SocialLoginCompleteDocument = parse(`mutation SocialLoginComplete($input: SocialLoginCompleteInput!) { socialLoginComplete(input: $input) { ${AUTH_RESPONSE_FIELDS} } }`);
+const DevLoginDocument = parse(`mutation DevLogin($input: DevLoginInput!) { devLogin(input: $input) { ${AUTH_RESPONSE_FIELDS} } }`);
+const AvailableLoginProvidersDocument = parse(`query AvailableLoginProviders { availableLoginProviders }`);
+const MyIdentitiesDocument = parse(`query MyIdentities { myIdentities { ${IDENTITY_FIELDS} } }`);
+const LinkIdentityDocument = parse(`mutation LinkIdentity($input: LinkIdentityInput!) { linkIdentity(input: $input) { ${IDENTITY_FIELDS} } }`);
+const UnlinkIdentityDocument = parse(`mutation UnlinkIdentity($identityId: String!) { unlinkIdentity(identityId: $identityId) }`);
 export class AuthAPI {
     constructor(graphql, session) {
         this.graphql = graphql;
         this.session = session;
     }
-    /**
-     * Authenticate with email + password and start a new session. **Public** — no
-     * existing session required.
-     *
-     * On success the returned `token` is minted **and** stored on the shared
-     * session state, so subsequent calls on any sub-client (management-api or
-     * game-api) carry it automatically — no need to call {@link setToken}.
-     *
-     * @param input - Credentials ({@link LoginUserInput}): `email` and `password`
-     *   (min 8 characters).
-     * @returns An {@link AuthResponse}: the opaque session `token` (sent as
-     *   `Authorization: Bearer <token>`), `gameTokenId` (the session row id, a
-     *   string), and the authenticated `user`.
-     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` on invalid credentials, or
-     *   `BAD_USER_INPUT` on malformed input.
-     * @example
-     * ```ts
-     * const { user } = await client.auth.login({ email, password });
-     * // the session token is now stored; later calls are authenticated for you
-     * await client.users.me();
-     * ```
-     */
-    async login(input) {
-        const data = await this.graphql.request(LoginDocument, { input });
-        if (data.login?.token) {
-            this.session.setToken(data.login.token);
-        }
-        return data.login;
-    }
-    /**
-     * Create a new (initially unconfirmed) account, send a confirmation email, and
-     * return a session for immediate login. **Public** — no existing session
-     * required. Same token-persistence behaviour as {@link login}: the new `token`
-     * is stored on the shared session state automatically.
-     *
-     * @param input - New-account details ({@link RegisterUserInput}): `email`
-     *   (where the confirmation email is sent), `password` (min 8 characters), and
-     *   an optional initial `gamertag` (min 3 characters; can also be set later via
-     *   `client.users.updateGamertag`).
-     * @returns An {@link AuthResponse} (session `token`, `gameTokenId`, and the new
-     *   `user`).
-     * @throws {CrowdyGraphQLError} `BAD_USER_INPUT` if the email already exists or
-     *   the input is invalid.
-     */
-    async register(input) {
-        const data = await this.graphql.request(RegisterDocument, { input });
-        if (data.register?.token) {
-            this.session.setToken(data.register.token);
-        }
-        return data.register;
+    /** The federated sign-in providers currently enabled (e.g. `['google']`). */
+    async availableLoginProviders() {
+        const data = await this.graphql.request(AvailableLoginProvidersDocument);
+        return data.availableLoginProviders;
     }
     /**
-     * Single-device logout: revoke the `game_tokens` row that authenticated this
-     * request; other devices/tokens are unaffected. After a successful server-side
-     * revoke the in-memory token is cleared from the shared session state so the
-     * other sub-clients stop using it. Requires a valid session.
-     *
-     * @returns `true` if a token was revoked, or `false` if the request carried no
-     *   game token.
-     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` if the session is invalid.
+     * Passwordless: email the address a one-time magic sign-in link (creating the
+     * account on first sign-in). Always resolves `sent: true` (no enumeration). In
+     * development (`DEV_AUTH_BYPASS`) the response also carries `devToken`, the
+     * token to pass straight to {@link completeLoginLink} without an inbox.
      */
-    async logout() {
-        const data = await this.graphql.request(LogoutDocument);
-        this.session.setToken(null);
-        return data.logout;
+    async requestLoginLink(input) {
+        const data = await this.graphql.request(RequestLoginLinkDocument, { input });
+        return data.requestLoginLink;
     }
-    /**
-     * Revoke **every** active session for the authenticated user (deletes all
-     * their `game_tokens` rows and records revocations). Requires a valid session;
-     * use {@link logout} to end only the current one.
-     *
-     * Note: unlike {@link logout}, this does not clear the SDK's in-memory token —
-     * call {@link setToken}`(null)` afterwards if you also want to drop it locally.
-     *
-     * @returns `true` on success.
-     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` if the session is invalid.
-     */
-    async logoutAllDevices() {
-        const data = await this.graphql.request(LogoutAllDevicesDocument);
-        return data.logoutAllDevices;
-    }
-    /**
-     * Confirm a user's email address using the token from the confirmation email.
-     * **Public** — the token itself authorizes the call.
-     *
-     * @param token - The confirmation token from the emailed link.
-     * @returns `true` on success, or `false` if the token is invalid or expired.
-     * @throws {CrowdyGraphQLError} on transport/validation failures (invalid or
-     *   expired tokens resolve to `false` rather than throwing).
-     */
-    async confirmEmail(token) {
-        const data = await this.graphql.request(ConfirmEmailDocument, { token });
-        return data.confirmEmail;
+    /** Complete a magic-link sign-in; stores the session token on success. */
+    async completeLoginLink(token) {
+        const data = await this.graphql.request(CompleteLoginLinkDocument, {
+            input: { token },
+        });
+        if (data.completeLoginLink?.token)
+            this.session.setToken(data.completeLoginLink.token);
+        return data.completeLoginLink;
     }
     /**
-     * Start the password-reset flow by emailing a reset link to the address.
-     * **Public**. Always returns `true` regardless of whether the email exists or
-     * is confirmed, to prevent account enumeration.
-     *
-     * @param email - Email address to send the password-reset link to.
-     * @returns `true` (always, even when no such account exists).
-     * @throws {CrowdyGraphQLError} on transport/validation failures.
+     * Begin a federated (social) sign-in. Returns an `authorizeUrl` to redirect the
+     * user to and an opaque `state` to round-trip back to {@link socialLoginComplete}.
      */
-    async requestPasswordReset(email) {
-        const data = await this.graphql.request(RequestPasswordResetDocument, {
-            email,
+    async socialLoginStart(provider, redirectUri) {
+        const data = await this.graphql.request(SocialLoginStartDocument, {
+            input: { provider, redirectUri },
         });
-        return data.requestPasswordReset;
+        return data.socialLoginStart;
     }
-    /**
-     * Complete a password reset using the reset token and a new password.
-     * **Public** — the reset token authorizes the call. Existing sessions are
-     * **not** revoked.
-     *
-     * @param input - {@link ResetPasswordInput}: the `token` from the emailed reset
-     *   link and the `newPassword` to set (min 8 characters).
-     * @returns `true` on success.
-     * @throws {CrowdyGraphQLError} `BAD_USER_INPUT` if the token is invalid or
-     *   expired.
-     */
-    async resetPassword(input) {
-        const data = await this.graphql.request(ResetPasswordDocument, {
+    /** Complete a federated sign-in from the provider callback; stores the token. */
+    async socialLoginComplete(input) {
+        const data = await this.graphql.request(SocialLoginCompleteDocument, {
             input,
         });
-        return data.resetPassword;
+        if (data.socialLoginComplete?.token)
+            this.session.setToken(data.socialLoginComplete.token);
+        return data.socialLoginComplete;
     }
     /**
-     * Re-send the email-confirmation link. **Public**. Always returns `true`
-     * regardless of whether the account exists or is already confirmed (prevents
-     * enumeration); the email is only actually sent for existing unconfirmed
-     * accounts.
-     *
-     * @param email - Email address of the account to re-send confirmation to.
-     * @returns `true` (always).
-     * @throws {CrowdyGraphQLError} on transport/validation failures.
+     * DEV ONLY bypass sign-in (active only when the server has `DEV_AUTH_BYPASS`).
+     * Returns a session for `email` without email/social verification; stores it.
+     * Throws `FORBIDDEN` when the bypass is disabled (e.g. production).
      */
-    async resendConfirmationEmail(email) {
-        const data = await this.graphql.request(ResendConfirmationEmailDocument, {
-            email,
+    async devLogin(email) {
+        const data = await this.graphql.request(DevLoginDocument, {
+            input: { email },
         });
-        return data.resendConfirmationEmail;
+        if (data.devLogin?.token)
+            this.session.setToken(data.devLogin.token);
+        return data.devLogin;
     }
-    /**
-     * Change the authenticated user's password after verifying the current one.
-     * Requires a valid session. Existing sessions are **not** revoked.
-     *
-     * @param currentPassword - The user's current password, for verification.
-     * @param newPassword - The new password to set (min 8 characters).
-     * @returns `true` on success.
-     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a valid session, or
-     *   `BAD_USER_INPUT` if the current password is wrong.
-     */
-    async changePassword(currentPassword, newPassword) {
-        const data = await this.graphql.request(ChangePasswordDocument, {
-            currentPassword,
-            newPassword,
+    /** The signed-in user's linked sign-in identities. Requires a session. */
+    async myIdentities() {
+        const data = await this.graphql.request(MyIdentitiesDocument);
+        return data.myIdentities;
+    }
+    /** Link an additional federated identity (from a social callback). */
+    async linkIdentity(input) {
+        const data = await this.graphql.request(LinkIdentityDocument, { input });
+        return data.linkIdentity;
+    }
+    /** Unlink a federated identity (cannot remove the last sign-in method). */
+    async unlinkIdentity(identityId) {
+        const data = await this.graphql.request(UnlinkIdentityDocument, {
+            identityId,
         });
-        return data.changePassword;
+        return data.unlinkIdentity;
     }
-    /**
-     * Imperatively replace the in-memory bearer token on the shared session state
-     * (e.g. to rehydrate a token persisted to disk). Affects every sub-client.
-     * Local only — performs no network call. Pass `null` to clear it.
-     *
-     * @param token - The bearer token to use, or `null` to clear the session.
-     */
+    /** Single-device logout; clears the in-memory token on success. */
+    async logout() {
+        const data = await this.graphql.request(LogoutDocument);
+        this.session.setToken(null);
+        return data.logout;
+    }
+    /** Revoke every active session for the user. Requires a session. */
+    async logoutAllDevices() {
+        const data = await this.graphql.request(LogoutAllDevicesDocument);
+        return data.logoutAllDevices;
+    }
+    /** Imperatively set the in-memory bearer token (e.g. rehydrate). */
     setToken(token) {
         this.session.setToken(token);
     }
-    /**
-     * Read the current in-memory bearer token from the shared session state. Local
-     * only — performs no network call.
-     *
-     * @returns The current bearer token, or `null` if none is set.
-     */
+    /** Read the current in-memory bearer token. */
     getToken() {
         return this.session.getToken();
     }

package/dist/domains/gameModel.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type GameModelCreateSessionMutation, type GameModelCreateSessionMutationVariables, type GameModelJoinSessionMutation, type GameModelJoinSessionMutationVariables, type GameModelSetSessionTurnMutation, type GameModelSetSessionTurnMutationVariables, type GameModelCreateContainerMutation, type GameModelCreateContainerMutationVariables, type GameModelSetPropertyMutation, type GameModelSetPropertyMutationVariables, type GameModelAddEdgeMutation, type GameModelAddEdgeMutationVariables, type GameModelInvokeMutation, type GameModelInvokeMutationVariables, type GameModelContainerQuery, type GameModelContainerQueryVariables, type GameModelContainersQuery, type GameModelContainersQueryVariables, type GameModelContainerStateQuery, type GameModelContainerStateQueryVariables, type GameModelTraverseQuery, type GameModelTraverseQueryVariables, type GameModelSessionQuery, type GameModelSessionQueryVariables, type GameModelSessionsQuery, type GameModelSessionsQueryVariables, type GameModelEventsQuery, type GameModelEventsQueryVariables, type GameModelSeedMutation, type GameModelSeedMutationVariables, type GameModelUpsertContainerTypeMutation, type GameModelUpsertContainerTypeMutationVariables, type GameModelUpsertPropertyDefMutation, type GameModelUpsertPropertyDefMutationVariables, type GameModelUpsertFunctionMutation, type GameModelUpsertFunctionMutationVariables, type GameModelDeleteFunctionMutation, type GameModelDeleteFunctionMutationVariables, type GameModelDefineFeatureMutation, type GameModelDefineFeatureMutationVariables, type GameModelGrantTierFeatureMutation, type GameModelGrantTierFeatureMutationVariables, type GameModelSetPolicyMutation, type GameModelSetPolicyMutationVariables, type GameModelTypeSchemaQuery, type GameModelTypeSchemaQueryVariables, type GameModelContainerTypesQuery, type GameModelContainerTypesQueryVariables, type GameModelPropertyDefsQuery, type GameModelPropertyDefsQueryVariables, type GameModelFunctionQuery, type GameModelFunctionQueryVariables, type GameModelFunctionsQuery, type GameModelFunctionsQueryVariables, type GameModelFeaturesQuery, type GameModelFeaturesQueryVariables, type GameModelTierFeaturesQuery, type GameModelTierFeaturesQueryVariables, type GameModelPolicyQuery, type GameModelPolicyQueryVariables, type GameModelRevokeTierFeatureMutation, type GameModelRevokeTierFeatureMutationVariables, type GameModelEventsConnectionQuery, type GameModelEventsConnectionQueryVariables, type GameModelUpsertAutomationMutation, type GameModelUpsertAutomationMutationVariables, type GameModelDeleteAutomationMutation, type GameModelDeleteAutomationMutationVariables, type GameModelSetAutomationEnabledMutation, type GameModelSetAutomationEnabledMutationVariables, type GameModelUpsertAutomationTriggerMutation, type GameModelUpsertAutomationTriggerMutationVariables, type GameModelDeleteAutomationTriggerMutation, type GameModelDeleteAutomationTriggerMutationVariables, type GameModelSetAutomationPolicyMutation, type GameModelSetAutomationPolicyMutationVariables, type GameModelRunAutomationMutation, type GameModelRunAutomationMutationVariables, type GameModelAutomationsQuery, type GameModelAutomationsQueryVariables, type GameModelAutomationQuery, type GameModelAutomationQueryVariables, type GameModelAutomationTriggersQuery, type GameModelAutomationTriggersQueryVariables, type GameModelAutomationPolicyQuery, type GameModelAutomationPolicyQueryVariables, type GameModelAutomationRunsQuery, type GameModelAutomationRunsQueryVariables, type GameModelAutomationStatsQuery, type GameModelAutomationStatsQueryVariables, type GameModelAppDiagnosticsQuery, type GameModelAppDiagnosticsQueryVariables } from '../generated/graphql.js';
+import { type GameModelCreateSessionMutation, type GameModelCreateSessionMutationVariables, type GameModelJoinSessionMutation, type GameModelJoinSessionMutationVariables, type GameModelSetSessionTurnMutation, type GameModelSetSessionTurnMutationVariables, type GameModelCreateContainerMutation, type GameModelCreateContainerMutationVariables, type GameModelDeleteContainerMutation, type GameModelDeleteContainerMutationVariables, type GameModelSetPropertyMutation, type GameModelSetPropertyMutationVariables, type GameModelAddEdgeMutation, type GameModelAddEdgeMutationVariables, type GameModelDeleteEdgeMutation, type GameModelDeleteEdgeMutationVariables, type GameModelInvokeMutation, type GameModelInvokeMutationVariables, type GameModelContainerQuery, type GameModelContainerQueryVariables, type GameModelContainersQuery, type GameModelContainersQueryVariables, type GameModelContainerStateQuery, type GameModelContainerStateQueryVariables, type GameModelTraverseQuery, type GameModelTraverseQueryVariables, type GameModelSessionQuery, type GameModelSessionQueryVariables, type GameModelSessionsQuery, type GameModelSessionsQueryVariables, type GameModelEventsQuery, type GameModelEventsQueryVariables, type GameModelSeedMutation, type GameModelSeedMutationVariables, type GameModelUpsertContainerTypeMutation, type GameModelUpsertContainerTypeMutationVariables, type GameModelUpsertPropertyDefMutation, type GameModelUpsertPropertyDefMutationVariables, type GameModelDeletePropertyDefMutation, type GameModelDeletePropertyDefMutationVariables, type GameModelDeleteContainerTypeMutation, type GameModelDeleteContainerTypeMutationVariables, type GameModelUpsertFunctionMutation, type GameModelUpsertFunctionMutationVariables, type GameModelDeleteFunctionMutation, type GameModelDeleteFunctionMutationVariables, type GameModelDefineFeatureMutation, type GameModelDefineFeatureMutationVariables, type GameModelGrantTierFeatureMutation, type GameModelGrantTierFeatureMutationVariables, type GameModelSetPolicyMutation, type GameModelSetPolicyMutationVariables, type GameModelTypeSchemaQuery, type GameModelTypeSchemaQueryVariables, type GameModelContainerTypesQuery, type GameModelContainerTypesQueryVariables, type GameModelPropertyDefsQuery, type GameModelPropertyDefsQueryVariables, type GameModelFunctionQuery, type GameModelFunctionQueryVariables, type GameModelFunctionsQuery, type GameModelFunctionsQueryVariables, type GameModelFeaturesQuery, type GameModelFeaturesQueryVariables, type GameModelTierFeaturesQuery, type GameModelTierFeaturesQueryVariables, type GameModelPolicyQuery, type GameModelPolicyQueryVariables, type GameModelRevokeTierFeatureMutation, type GameModelRevokeTierFeatureMutationVariables, type GameModelEventsConnectionQuery, type GameModelEventsConnectionQueryVariables, type GameModelUpsertAutomationMutation, type GameModelUpsertAutomationMutationVariables, type GameModelDeleteAutomationMutation, type GameModelDeleteAutomationMutationVariables, type GameModelSetAutomationEnabledMutation, type GameModelSetAutomationEnabledMutationVariables, type GameModelUpsertAutomationTriggerMutation, type GameModelUpsertAutomationTriggerMutationVariables, type GameModelDeleteAutomationTriggerMutation, type GameModelDeleteAutomationTriggerMutationVariables, type GameModelSetAutomationPolicyMutation, type GameModelSetAutomationPolicyMutationVariables, type GameModelRunAutomationMutation, type GameModelRunAutomationMutationVariables, type GameModelAutomationsQuery, type GameModelAutomationsQueryVariables, type GameModelAutomationQuery, type GameModelAutomationQueryVariables, type GameModelAutomationTriggersQuery, type GameModelAutomationTriggersQueryVariables, type GameModelAutomationPolicyQuery, type GameModelAutomationPolicyQueryVariables, type GameModelAutomationRunsQuery, type GameModelAutomationRunsQueryVariables, type GameModelAutomationStatsQuery, type GameModelAutomationStatsQueryVariables, type GameModelAppDiagnosticsQuery, type GameModelAppDiagnosticsQueryVariables } from '../generated/graphql.js';
 /**
  * Abstract **game-model** sub-client on the **game-api** — a schema-driven,
  * server-authoritative layer for modelling game/world logic on top of the
@@ -52,8 +52,9 @@ import { type GameModelCreateSessionMutation, type GameModelCreateSessionMutatio
  * `client.auth.login()` or `client.setToken()`) scoped to the target app, or it
  * throws {@link CrowdyGraphQLError} (`UNAUTHENTICATED` / `SCOPE_MISSING`). The
  * **studio-authoring** methods ({@link seed}, {@link upsertContainerType},
- * {@link upsertPropertyDef}, {@link upsertFunction}, {@link deleteFunction},
- * {@link defineFeature}, {@link grantTierFeature}, {@link setPolicy}) and the
+ * {@link upsertPropertyDef}, {@link deletePropertyDef}, {@link upsertFunction},
+ * {@link deleteFunction}, {@link deleteContainerType}, {@link defineFeature},
+ * {@link grantTierFeature}, {@link setPolicy}) and the
  * {@link typeSchema} query additionally require the app-admin **`manage_apps`**
  * permission (otherwise `FORBIDDEN`, with `extensions.requiredPermission ===
  * 'manage_apps'`); the runtime/player methods need only a valid token plus
@@ -139,6 +140,18 @@ export declare class GameModelAPI {
      *   unknown type, or `BAD_USER_INPUT` for malformed properties.
      */
     createContainer(input: GameModelCreateContainerMutationVariables['input']): Promise<GameModelCreateContainerMutation['gameModelCreateContainer']>;
+    /**
+     * **Containers** — delete a container instance. Cascades its instance
+     * properties and any edges connected to it. Allowed for an app admin or the
+     * container owner. **Destructive.**
+     *
+     * @param variables - `{ appId, containerId }`: `appId` (decimal string) and
+     *   the container UUID to delete.
+     * @returns `true` if a container was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`, or
+     *   `FORBIDDEN` if the caller is neither an app admin nor the owner.
+     */
+    deleteContainer(variables: GameModelDeleteContainerMutationVariables): Promise<GameModelDeleteContainerMutation['gameModelDeleteContainer']>;
     /**
      * **Containers** — set a single property value on a container directly (outside
      * a function). Allowed only when the property's `writable` rule
@@ -169,6 +182,17 @@ export declare class GameModelAPI {
      *   `NOT_FOUND` if either container is unknown, or `BAD_USER_INPUT`.
      */
     addEdge(input: GameModelAddEdgeMutationVariables['input']): Promise<GameModelAddEdgeMutation['gameModelAddEdge']>;
+    /**
+     * **Edges** — delete a directed relationship edge. Allowed for an app admin or
+     * the owner of the source (`from`) container. **Destructive.**
+     *
+     * @param variables - `{ appId, edgeId }`: `appId` (decimal string) and the
+     *   edge UUID to delete.
+     * @returns `true` if an edge was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`, or
+     *   `FORBIDDEN` if the caller may not delete the edge.
+     */
+    deleteEdge(variables: GameModelDeleteEdgeMutationVariables): Promise<GameModelDeleteEdgeMutation['gameModelDeleteEdge']>;
     /**
      * **Functions** — invoke a studio-defined function against a `self` container
      * with JSON params. This is the primary, *safe* way for players to mutate game
@@ -359,6 +383,33 @@ export declare class GameModelAPI {
      *   unknown container type, or `BAD_USER_INPUT`.
      */
     upsertPropertyDef(input: GameModelUpsertPropertyDefMutationVariables['input']): Promise<GameModelUpsertPropertyDefMutation['gameModelUpsertPropertyDef']>;
+    /**
+     * **Property definitions** — delete a property definition from a container
+     * type. Does **not** remove instance property values already stored on
+     * containers. **Destructive.**
+     *
+     * Requires the app-admin **`manage_apps`** permission.
+     *
+     * @param variables - `{ appId, containerTypeName, key }`.
+     * @returns `true` if a definition was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`, or
+     *   `FORBIDDEN` (`requiredPermission === 'manage_apps'`).
+     */
+    deletePropertyDef(variables: GameModelDeletePropertyDefMutationVariables): Promise<GameModelDeletePropertyDefMutation['gameModelDeletePropertyDef']>;
+    /**
+     * **Container types** — delete a container type and its property definitions.
+     * Refuses if live containers of that type exist, or if functions are bound to
+     * it — delete those first. **Destructive.**
+     *
+     * Requires the app-admin **`manage_apps`** permission.
+     *
+     * @param variables - `{ appId, typeName }`.
+     * @returns `true` if a type was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`,
+     *   `FORBIDDEN` (`requiredPermission === 'manage_apps'`), or `BAD_USER_INPUT`
+     *   when containers or bound functions still exist.
+     */
+    deleteContainerType(variables: GameModelDeleteContainerTypeMutationVariables): Promise<GameModelDeleteContainerTypeMutation['gameModelDeleteContainerType']>;
     /**
      * **Functions** — create or update a studio-defined function: a named,
      * sandboxed behaviour with typed parameters, declared property mutations

package/dist/domains/gameModel.d.ts.map

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

package/dist/domains/gameModel.js

@@ -1,8 +1,8 @@
 import { 
 // Runtime (player) ops
-GameModelCreateSessionDocument, GameModelJoinSessionDocument, GameModelSetSessionTurnDocument, GameModelCreateContainerDocument, GameModelSetPropertyDocument, GameModelAddEdgeDocument, GameModelInvokeDocument, GameModelContainerDocument, GameModelContainersDocument, GameModelContainerStateDocument, GameModelTraverseDocument, GameModelSessionDocument, GameModelSessionsDocument, GameModelEventsDocument, 
+GameModelCreateSessionDocument, GameModelJoinSessionDocument, GameModelSetSessionTurnDocument, GameModelCreateContainerDocument, GameModelDeleteContainerDocument, GameModelSetPropertyDocument, GameModelAddEdgeDocument, GameModelDeleteEdgeDocument, GameModelInvokeDocument, GameModelContainerDocument, GameModelContainersDocument, GameModelContainerStateDocument, GameModelTraverseDocument, GameModelSessionDocument, GameModelSessionsDocument, GameModelEventsDocument, 
 // Studio authoring ops
-GameModelSeedDocument, GameModelUpsertContainerTypeDocument, GameModelUpsertPropertyDefDocument, GameModelUpsertFunctionDocument, GameModelDeleteFunctionDocument, GameModelDefineFeatureDocument, GameModelGrantTierFeatureDocument, GameModelSetPolicyDocument, GameModelTypeSchemaDocument, GameModelContainerTypesDocument, GameModelPropertyDefsDocument, GameModelFunctionDocument, GameModelFunctionsDocument, GameModelFeaturesDocument, GameModelTierFeaturesDocument, GameModelPolicyDocument, GameModelRevokeTierFeatureDocument, GameModelEventsConnectionDocument, 
+GameModelSeedDocument, GameModelUpsertContainerTypeDocument, GameModelUpsertPropertyDefDocument, GameModelDeletePropertyDefDocument, GameModelDeleteContainerTypeDocument, GameModelUpsertFunctionDocument, GameModelDeleteFunctionDocument, GameModelDefineFeatureDocument, GameModelGrantTierFeatureDocument, GameModelSetPolicyDocument, GameModelTypeSchemaDocument, GameModelContainerTypesDocument, GameModelPropertyDefsDocument, GameModelFunctionDocument, GameModelFunctionsDocument, GameModelFeaturesDocument, GameModelTierFeaturesDocument, GameModelPolicyDocument, GameModelRevokeTierFeatureDocument, GameModelEventsConnectionDocument, 
 // Automations (autonomous processes / NPCs)
 GameModelUpsertAutomationDocument, GameModelDeleteAutomationDocument, GameModelSetAutomationEnabledDocument, GameModelUpsertAutomationTriggerDocument, GameModelDeleteAutomationTriggerDocument, GameModelSetAutomationPolicyDocument, GameModelRunAutomationDocument, GameModelAutomationsDocument, GameModelAutomationDocument, GameModelAutomationTriggersDocument, GameModelAutomationPolicyDocument, GameModelAutomationRunsDocument, GameModelAutomationStatsDocument, GameModelAppDiagnosticsDocument, } from '../generated/graphql.js';
 /**
@@ -57,8 +57,9 @@ GameModelUpsertAutomationDocument, GameModelDeleteAutomationDocument, GameModelS
  * `client.auth.login()` or `client.setToken()`) scoped to the target app, or it
  * throws {@link CrowdyGraphQLError} (`UNAUTHENTICATED` / `SCOPE_MISSING`). The
  * **studio-authoring** methods ({@link seed}, {@link upsertContainerType},
- * {@link upsertPropertyDef}, {@link upsertFunction}, {@link deleteFunction},
- * {@link defineFeature}, {@link grantTierFeature}, {@link setPolicy}) and the
+ * {@link upsertPropertyDef}, {@link deletePropertyDef}, {@link upsertFunction},
+ * {@link deleteFunction}, {@link deleteContainerType}, {@link defineFeature},
+ * {@link grantTierFeature}, {@link setPolicy}) and the
  * {@link typeSchema} query additionally require the app-admin **`manage_apps`**
  * permission (otherwise `FORBIDDEN`, with `extensions.requiredPermission ===
  * 'manage_apps'`); the runtime/player methods need only a valid token plus
@@ -158,6 +159,21 @@ export class GameModelAPI {
         const data = await this.gql.request(GameModelCreateContainerDocument, { input });
         return data.gameModelCreateContainer;
     }
+    /**
+     * **Containers** — delete a container instance. Cascades its instance
+     * properties and any edges connected to it. Allowed for an app admin or the
+     * container owner. **Destructive.**
+     *
+     * @param variables - `{ appId, containerId }`: `appId` (decimal string) and
+     *   the container UUID to delete.
+     * @returns `true` if a container was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`, or
+     *   `FORBIDDEN` if the caller is neither an app admin nor the owner.
+     */
+    async deleteContainer(variables) {
+        const data = await this.gql.request(GameModelDeleteContainerDocument, variables);
+        return data.gameModelDeleteContainer;
+    }
     /**
      * **Containers** — set a single property value on a container directly (outside
      * a function). Allowed only when the property's `writable` rule
@@ -194,6 +210,20 @@ export class GameModelAPI {
         const data = await this.gql.request(GameModelAddEdgeDocument, { input });
         return data.gameModelAddEdge;
     }
+    /**
+     * **Edges** — delete a directed relationship edge. Allowed for an app admin or
+     * the owner of the source (`from`) container. **Destructive.**
+     *
+     * @param variables - `{ appId, edgeId }`: `appId` (decimal string) and the
+     *   edge UUID to delete.
+     * @returns `true` if an edge was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`, or
+     *   `FORBIDDEN` if the caller may not delete the edge.
+     */
+    async deleteEdge(variables) {
+        const data = await this.gql.request(GameModelDeleteEdgeDocument, variables);
+        return data.gameModelDeleteEdge;
+    }
     /**
      * **Functions** — invoke a studio-defined function against a `self` container
      * with JSON params. This is the primary, *safe* way for players to mutate game
@@ -421,6 +451,39 @@ export class GameModelAPI {
         const data = await this.gql.request(GameModelUpsertPropertyDefDocument, { input });
         return data.gameModelUpsertPropertyDef;
     }
+    /**
+     * **Property definitions** — delete a property definition from a container
+     * type. Does **not** remove instance property values already stored on
+     * containers. **Destructive.**
+     *
+     * Requires the app-admin **`manage_apps`** permission.
+     *
+     * @param variables - `{ appId, containerTypeName, key }`.
+     * @returns `true` if a definition was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`, or
+     *   `FORBIDDEN` (`requiredPermission === 'manage_apps'`).
+     */
+    async deletePropertyDef(variables) {
+        const data = await this.gql.request(GameModelDeletePropertyDefDocument, variables);
+        return data.gameModelDeletePropertyDef;
+    }
+    /**
+     * **Container types** — delete a container type and its property definitions.
+     * Refuses if live containers of that type exist, or if functions are bound to
+     * it — delete those first. **Destructive.**
+     *
+     * Requires the app-admin **`manage_apps`** permission.
+     *
+     * @param variables - `{ appId, typeName }`.
+     * @returns `true` if a type was deleted, `false` if none matched.
+     * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `SCOPE_MISSING`,
+     *   `FORBIDDEN` (`requiredPermission === 'manage_apps'`), or `BAD_USER_INPUT`
+     *   when containers or bound functions still exist.
+     */
+    async deleteContainerType(variables) {
+        const data = await this.gql.request(GameModelDeleteContainerTypeDocument, variables);
+        return data.gameModelDeleteContainerType;
+    }
     /**
      * **Functions** — create or update a studio-defined function: a named,
      * sandboxed behaviour with typed parameters, declared property mutations

package/dist/domains/host.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type GameHostQuery, type ActorHeartbeatMutation } from '../generated/graphql.js';
+import { type GameHostQuery, type AmIGameHostQuery, type ActorHeartbeatMutation } from '../generated/graphql.js';
 /**
  * Game-host election + actor liveness heartbeat — exposed as `client.host`.
  *
@@ -7,8 +7,10 @@ import { type GameHostQuery, type ActorHeartbeatMutation } from '../generated/gr
  * game-api replicas (the user whose earliest still-connected actor was created
  * first wins). {@link heartbeat} refreshes the caller's actor freshness (keeping
  * them host-eligible) and returns the freshly-elected host in one round-trip —
- * call it on an interval shorter than the server's freshness window. Both
- * require a valid session; `appId` is a `BigInt` decimal string.
+ * call it on an interval shorter than the server's freshness window.
+ * {@link amIHost} is a UI convenience (not authoritative for mutations — use
+ * `gameModelInvoke`'s `is_host` policy for that). All require a valid session;
+ * `appId` is a `BigInt` decimal string.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a session.
  */
@@ -23,6 +25,15 @@ export declare class HostAPI {
      * @returns The elected {@link GameHost}, or `null`.
      */
     get(appId: string): Promise<GameHostQuery['gameHost']>;
+    /**
+     * Return whether the authenticated caller is the currently elected host for
+     * the app. Convenience for UI only — not authoritative for server mutations
+     * (use `gameModelInvoke`'s `is_host` policy for that).
+     *
+     * @param appId - The app to check host election for.
+     * @returns `true` if the caller is the elected host; otherwise `false`.
+     */
+    amIHost(appId: string): Promise<AmIGameHostQuery['amIGameHost']>;
     /**
      * Refresh the caller's actor freshness in an app and return the freshly
      * elected host. Returns `null` when no fresh actors exist for the app.

package/dist/domains/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/domains/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAK5D;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CAIlF"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/domains/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAK5D;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAKtE;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CAIlF"}

package/dist/domains/host.js

@@ -1,4 +1,4 @@
-import { GameHostDocument, ActorHeartbeatDocument, } from '../generated/graphql.js';
+import { GameHostDocument, AmIGameHostDocument, ActorHeartbeatDocument, } from '../generated/graphql.js';
 /**
  * Game-host election + actor liveness heartbeat — exposed as `client.host`.
  *
@@ -6,8 +6,10 @@ import { GameHostDocument, ActorHeartbeatDocument, } from '../generated/graphql.
  * game-api replicas (the user whose earliest still-connected actor was created
  * first wins). {@link heartbeat} refreshes the caller's actor freshness (keeping
  * them host-eligible) and returns the freshly-elected host in one round-trip —
- * call it on an interval shorter than the server's freshness window. Both
- * require a valid session; `appId` is a `BigInt` decimal string.
+ * call it on an interval shorter than the server's freshness window.
+ * {@link amIHost} is a UI convenience (not authoritative for mutations — use
+ * `gameModelInvoke`'s `is_host` policy for that). All require a valid session;
+ * `appId` is a `BigInt` decimal string.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a session.
  */
@@ -26,6 +28,18 @@ export class HostAPI {
         const data = await this.graphql.request(GameHostDocument, { appId });
         return data.gameHost;
     }
+    /**
+     * Return whether the authenticated caller is the currently elected host for
+     * the app. Convenience for UI only — not authoritative for server mutations
+     * (use `gameModelInvoke`'s `is_host` policy for that).
+     *
+     * @param appId - The app to check host election for.
+     * @returns `true` if the caller is the elected host; otherwise `false`.
+     */
+    async amIHost(appId) {
+        const data = await this.graphql.request(AmIGameHostDocument, { appId });
+        return data.amIGameHost;
+    }
     /**
      * Refresh the caller's actor freshness in an app and return the freshly
      * elected host. Returns `null` when no fresh actors exist for the app.