@crowdedkingdoms/crowdyjs 18.0.0-dev.1 → 18.0.1-dev.1

package/dist/domains/users.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type MeQuery, type UpdateGamertagInput, type UpdateGamertagMutation, type UserQuery, type UsersPaginatedQuery, type UsersPaginatedQueryVariables, type UsersConnectionQuery, type UsersConnectionQueryVariables, type SetSuperAdminMutation, type SetOperatorMutation, type SetEarlyAccessOverrideMutation, type UpdateUserTypeMutation, type ForceLogoutUserMutation, type UpdateUserStateMutation, type UpdateUserStateInput, type FreePlayWindowQuery } from '../generated/graphql.js';
+import { type MeQuery, type UpdateGamertagInput, type UpdateGamertagMutation, type UserQuery, type UpdateUserStateMutation, type UpdateUserStateInput, type FreePlayWindowQuery } from '../generated/graphql.js';
 /**
  * User identity & account management — exposed as `client.users`.
  *
@@ -8,8 +8,8 @@ import { type MeQuery, type UpdateGamertagInput, type UpdateGamertagMutation, ty
  * exposes these identity mutations — calling them against a game-api endpoint
  * throws {@link CrowdyGraphQLError} with `FORBIDDEN`, directing you to the
  * management API. Only the read/identity surface a game client realistically
- * needs lives here; super-admin / operator screens use the management UI
- * directly rather than the SDK.
+ * needs lives here; platform administration (super-admin and operator fields)
+ * is not in the SDK: call the API directly from your own tooling.
  *
  * Every method needs a valid session (a bearer token set by
  * `client.auth.login()` / `register()` or `client.setToken()`); without one the
@@ -62,84 +62,17 @@ export declare class UsersAPI {
      */
     freePlayWindow(): Promise<FreePlayWindowQuery['freePlayWindowInfo']>;
     /**
-     * Look up any user by id. **Super-admin only** (regular callers can only read
-     * their own profile via {@link me}).
+     * Look up a user by id. Requires a valid session.
      *
      * @param id - Numeric user id (`BigInt` as a decimal string).
      * @returns The {@link User}, or `null` if no such user.
      */
     get(id: string): Promise<UserQuery['user']>;
     /**
-     * Search/list users with offset pagination. **Super-admin only.**
+     * Replace the caller's own top-level state blob (base64; `null` clears it).
+     * Only ever writes the caller. Requires a valid session.
      *
-     * @param opts - Optional `query` (prefix match over email/gamertag/id) and
-     *   `limit` / `offset`.
-     * @returns A page of users.
-     * @remarks Prefer {@link listConnection} (Relay cursor pagination) for large
-     *   result sets; the offset args here are deprecated server-side.
-     */
-    paginated(opts?: {
-        query?: UsersPaginatedQueryVariables['query'];
-        limit?: UsersPaginatedQueryVariables['limit'];
-        offset?: UsersPaginatedQueryVariables['offset'];
-    }): Promise<UsersPaginatedQuery['usersPaginated']>;
-    /**
-     * Relay-style cursor pagination over users — the preferred alternative to
-     * {@link paginated}. **Super-admin only.** Page with `first` plus the previous
-     * page's `pageInfo.endCursor` as `after`. See
-     * https://docs.crowdedkingdoms.com/overview/pagination.
-     *
-     * @param args - Optional `first`, `after`, and `query`.
-     * @returns A {@link UsersConnection}.
-     */
-    listConnection(args?: UsersConnectionQueryVariables): Promise<UsersConnectionQuery['usersConnection']>;
-    /**
-     * Grant or revoke the platform `is_super_admin` flag on a user. **Super-admin
-     * only.**
-     *
-     * @param userId - Target user id.
-     * @param value - `true` to grant, `false` to revoke.
-     * @returns The updated user's `userId` + `isSuperAdmin`.
-     */
-    setSuperAdmin(userId: string, value: boolean): Promise<SetSuperAdminMutation['setSuperAdmin']>;
-    /**
-     * Grant or revoke the platform `is_operator` flag (control-plane access) on a
-     * user. **Super-admin only.**
-     *
-     * @param userId - Target user id.
-     * @param value - `true` to grant, `false` to revoke.
-     * @returns The updated user's `userId` + `isOperator`.
-     */
-    setOperator(userId: string, value: boolean): Promise<SetOperatorMutation['setOperator']>;
-    /**
-     * Force an early-access override on a user (bypasses the early-access gate).
-     * **Super-admin only.**
-     *
-     * @param userId - Target user id.
-     * @param value - `true` to grant the override, `false` to clear it.
-     * @returns The updated user's `userId` + `grantEarlyAccessOverride`.
-     */
-    setEarlyAccessOverride(userId: string, value: boolean): Promise<SetEarlyAccessOverrideMutation['setEarlyAccessOverride']>;
-    /**
-     * Set a user's `user_type`. **Super-admin only.**
-     *
-     * @param userId - Target user id.
-     * @param value - The new user type string.
-     * @returns The updated user's `userId` + `userType`.
-     */
-    updateType(userId: string, value: string): Promise<UpdateUserTypeMutation['updateUserType']>;
-    /**
-     * Revoke all of a user's sessions (force logout everywhere). **Super-admin
-     * only.**
-     *
-     * @param userId - Target user id.
-     * @returns `true` on success.
-     */
-    forceLogout(userId: string): Promise<ForceLogoutUserMutation['forceLogoutUser']>;
-    /**
-     * Replace a user's top-level state blob. **Super-admin only.**
-     *
-     * @param input - {@link UpdateUserStateInput} (`userId` + base64 `state`).
+     * @param input - {@link UpdateUserStateInput}: the base64 `state`.
      * @returns The updated user's `userId` + `state`.
      */
     updateState(input: UpdateUserStateInput): Promise<UpdateUserStateMutation['updateUserState']>;

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

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/domains/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAcL,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;;;OAOG;IACG,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAKlC;;;;;;;;;;;;;OAaG;IACG,cAAc,CAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAKpD;;;;;;;;;OASG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;IAK1E;;;;;;OAMG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAKjD;;;;;;;;OAQG;IACG,SAAS,CACb,IAAI,GAAE;QACJ,KAAK,CAAC,EAAE,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,CAAC,EAAE,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;KAC5C,GACL,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAKjD;;;;;;;;OAQG;IACG,cAAc,CAClB,IAAI,GAAE,6BAAkC,GACvC,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAKnD;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAQlD;;;;;;;OAOG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAQ9C;;;;;;;OAOG;IACG,sBAAsB,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,8BAA8B,CAAC,wBAAwB,CAAC,CAAC;IAQpE;;;;;;OAMG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAQpD;;;;;;OAMG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAOtD;;;;;OAKG;IACG,WAAW,CACf,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;CAIvD"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/domains/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAOL,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAEnD;;;;;;;OAOG;IACG,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAKlC;;;;;;;;;;;;;OAaG;IACG,cAAc,CAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAKpD;;;;;;;;;OASG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;IAK1E;;;;;OAKG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAKjD;;;;;;OAMG;IACG,WAAW,CACf,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;CAIvD"}

package/dist/domains/users.js

@@ -1,4 +1,4 @@
-import { MeDocument, UpdateGamertagDocument, DeleteMyAccountDocument, UserDocument, UsersPaginatedDocument, UsersConnectionDocument, SetSuperAdminDocument, SetOperatorDocument, SetEarlyAccessOverrideDocument, UpdateUserTypeDocument, ForceLogoutUserDocument, UpdateUserStateDocument, FreePlayWindowDocument, } from '../generated/graphql.js';
+import { MeDocument, UpdateGamertagDocument, DeleteMyAccountDocument, UserDocument, UpdateUserStateDocument, FreePlayWindowDocument, } from '../generated/graphql.js';
 /**
  * User identity & account management — exposed as `client.users`.
  *
@@ -7,8 +7,8 @@ import { MeDocument, UpdateGamertagDocument, DeleteMyAccountDocument, UserDocume
  * exposes these identity mutations — calling them against a game-api endpoint
  * throws {@link CrowdyGraphQLError} with `FORBIDDEN`, directing you to the
  * management API. Only the read/identity surface a game client realistically
- * needs lives here; super-admin / operator screens use the management UI
- * directly rather than the SDK.
+ * needs lives here; platform administration (super-admin and operator fields)
+ * is not in the SDK: call the API directly from your own tooling.
  *
  * Every method needs a valid session (a bearer token set by
  * `client.auth.login()` / `register()` or `client.setToken()`); without one the
@@ -74,8 +74,7 @@ export class UsersAPI {
         return data.freePlayWindowInfo;
     }
     /**
-     * Look up any user by id. **Super-admin only** (regular callers can only read
-     * their own profile via {@link me}).
+     * Look up a user by id. Requires a valid session.
      *
      * @param id - Numeric user id (`BigInt` as a decimal string).
      * @returns The {@link User}, or `null` if no such user.
@@ -85,107 +84,10 @@ export class UsersAPI {
         return data.user;
     }
     /**
-     * Search/list users with offset pagination. **Super-admin only.**
+     * Replace the caller's own top-level state blob (base64; `null` clears it).
+     * Only ever writes the caller. Requires a valid session.
      *
-     * @param opts - Optional `query` (prefix match over email/gamertag/id) and
-     *   `limit` / `offset`.
-     * @returns A page of users.
-     * @remarks Prefer {@link listConnection} (Relay cursor pagination) for large
-     *   result sets; the offset args here are deprecated server-side.
-     */
-    async paginated(opts = {}) {
-        const data = await this.graphql.request(UsersPaginatedDocument, opts);
-        return data.usersPaginated;
-    }
-    /**
-     * Relay-style cursor pagination over users — the preferred alternative to
-     * {@link paginated}. **Super-admin only.** Page with `first` plus the previous
-     * page's `pageInfo.endCursor` as `after`. See
-     * https://docs.crowdedkingdoms.com/overview/pagination.
-     *
-     * @param args - Optional `first`, `after`, and `query`.
-     * @returns A {@link UsersConnection}.
-     */
-    async listConnection(args = {}) {
-        const data = await this.graphql.request(UsersConnectionDocument, args);
-        return data.usersConnection;
-    }
-    /**
-     * Grant or revoke the platform `is_super_admin` flag on a user. **Super-admin
-     * only.**
-     *
-     * @param userId - Target user id.
-     * @param value - `true` to grant, `false` to revoke.
-     * @returns The updated user's `userId` + `isSuperAdmin`.
-     */
-    async setSuperAdmin(userId, value) {
-        const data = await this.graphql.request(SetSuperAdminDocument, {
-            userId,
-            value,
-        });
-        return data.setSuperAdmin;
-    }
-    /**
-     * Grant or revoke the platform `is_operator` flag (control-plane access) on a
-     * user. **Super-admin only.**
-     *
-     * @param userId - Target user id.
-     * @param value - `true` to grant, `false` to revoke.
-     * @returns The updated user's `userId` + `isOperator`.
-     */
-    async setOperator(userId, value) {
-        const data = await this.graphql.request(SetOperatorDocument, {
-            userId,
-            value,
-        });
-        return data.setOperator;
-    }
-    /**
-     * Force an early-access override on a user (bypasses the early-access gate).
-     * **Super-admin only.**
-     *
-     * @param userId - Target user id.
-     * @param value - `true` to grant the override, `false` to clear it.
-     * @returns The updated user's `userId` + `grantEarlyAccessOverride`.
-     */
-    async setEarlyAccessOverride(userId, value) {
-        const data = await this.graphql.request(SetEarlyAccessOverrideDocument, {
-            userId,
-            value,
-        });
-        return data.setEarlyAccessOverride;
-    }
-    /**
-     * Set a user's `user_type`. **Super-admin only.**
-     *
-     * @param userId - Target user id.
-     * @param value - The new user type string.
-     * @returns The updated user's `userId` + `userType`.
-     */
-    async updateType(userId, value) {
-        const data = await this.graphql.request(UpdateUserTypeDocument, {
-            userId,
-            value,
-        });
-        return data.updateUserType;
-    }
-    /**
-     * Revoke all of a user's sessions (force logout everywhere). **Super-admin
-     * only.**
-     *
-     * @param userId - Target user id.
-     * @returns `true` on success.
-     */
-    async forceLogout(userId) {
-        const data = await this.graphql.request(ForceLogoutUserDocument, {
-            userId,
-        });
-        return data.forceLogoutUser;
-    }
-    /**
-     * Replace a user's top-level state blob. **Super-admin only.**
-     *
-     * @param input - {@link UpdateUserStateInput} (`userId` + base64 `state`).
+     * @param input - {@link UpdateUserStateInput}: the base64 `state`.
      * @returns The updated user's `userId` + `state`.
      */
     async updateState(input) {