@crowdedkingdoms/crowdyjs 12.2.0 → 13.0.0

package/dist/domains/controlPlane.js

@@ -1,12 +1,13 @@
-import { CpEnvironmentsDocument, CpEnvironmentDocument, CpChangeOrdersDocument, CpChangeOrderDocument, CpAuditDocument, CpSecretsDocument, CpEnvSecretsDocument, CpOvhCatalogSummaryDocument, CpComputePlatformCeilingsDocument, CpSetComputePlatformCeilingsDocument, CpUsageSummaryDocument, CpUnreleasedGameApiTagsDocument, CpEnvironmentVersionsDocument, OperatorUsersDocument, SetEnvironmentDeletionProtectionDocument, PutCpSecretDocument, DeleteCpSecretDocument, PutCpEnvSecretDocument, IngestEnvironmentVersionDocument, PublishEnvironmentReleaseFromGameApiTagDocument, YankEnvironmentVersionDocument, } from '../generated/graphql.js';
+import { CpComputePlatformCeilingsDocument, CpSetComputePlatformCeilingsDocument, } from '../generated/graphql.js';
 /**
- * Operator (control-plane) surface — exposed as `client.operator`.
+ * Operator (platform-policy) surface — exposed as `client.operator`.
  *
- * Targets the **management-api**. EVERY operation here requires
- * `users.is_operator` (super-admins implicitly have it). This is the privileged
- * platform-operations surface (cross-org environment administration, secrets,
- * release management) and is NOT for end users. Mutations write audit entries
- * and several have real side effects (GitHub commits, deploy retargeting).
+ * As of the unified galaxy API this surface is reduced to the platform-wide
+ * compute ceilings: dedicated customer environments were retired, and the
+ * infrastructure control plane (environments, change orders, secrets, release
+ * management, audit) moved to the separate infra-control-plane service with
+ * its own auth and operator console. EVERY operation here still requires
+ * `users.is_operator` (super-admins implicitly have it).
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` without a session, `FORBIDDEN`
  *   when the caller is not an operator.
@@ -16,107 +17,10 @@ export class ControlPlaneAPI {
         this.management = management;
     }
     /**
-     * Paginated list of every environment across all orgs (1-based paging).
+     * The platform-wide compute ceilings (max modules, tick rates, fuel,
+     * memory, run time, db-op and egress budgets).
      *
-     * @param opts - Optional `page` (default 1) and `pageSize` (default 50).
-     * @returns A page of operator environment rows.
-     */
-    async environments(opts = {}) {
-        const data = await this.management.request(CpEnvironmentsDocument, {
-            page: opts.page,
-            pageSize: opts.pageSize,
-        });
-        return data.cpEnvironments;
-    }
-    /**
-     * Operator view of one environment by slug (across any org).
-     *
-     * @param slug - Environment slug.
-     * @returns The environment row, or `null` if not found.
-     */
-    async environment(slug) {
-        const data = await this.management.request(CpEnvironmentDocument, { slug });
-        return data.cpEnvironment;
-    }
-    /**
-     * Paginated change orders, optionally filtered by environment.
-     *
-     * @param opts - Optional `environmentId` filter, `page`, `pageSize`.
-     * @returns A page of change-order rows.
-     */
-    async changeOrders(opts = {}) {
-        const data = await this.management.request(CpChangeOrdersDocument, {
-            environmentId: opts.environmentId,
-            page: opts.page,
-            pageSize: opts.pageSize,
-        });
-        return data.cpChangeOrders;
-    }
-    /**
-     * One change order with its tasks and steps.
-     *
-     * @param id - Change order UUID.
-     * @returns The change-order detail, or `null` if not found.
-     */
-    async changeOrder(id) {
-        const data = await this.management.request(CpChangeOrderDocument, { id });
-        return data.cpChangeOrder;
-    }
-    /**
-     * Most recent operator audit entries (newest first), optionally filtered.
-     *
-     * @param opts - Optional `environmentId` filter and `limit` (default 200).
-     * @returns The audit entries.
-     */
-    async audit(opts = {}) {
-        const data = await this.management.request(CpAuditDocument, {
-            environmentId: opts.environmentId,
-            limit: opts.limit,
-        });
-        return data.cpAudit;
-    }
-    /**
-     * Control-plane secret metadata (names/kinds only, never plaintext).
-     *
-     * @param environmentId - Optional environment UUID filter.
-     * @returns The secret metadata rows.
-     */
-    async secrets(environmentId) {
-        const data = await this.management.request(CpSecretsDocument, {
-            environmentId,
-        });
-        return data.cpSecrets;
-    }
-    /**
-     * Environment-delivered secret metadata (names/kinds only, never plaintext).
-     *
-     * @param environmentId - Optional environment UUID filter.
-     * @returns The env-secret metadata rows.
-     */
-    async envSecrets(environmentId) {
-        const data = await this.management.request(CpEnvSecretsDocument, {
-            environmentId,
-        });
-        return data.cpEnvSecrets;
-    }
-    /**
-     * OVH flavor catalog with provider vs. customer pricing.
-     *
-     * @param region - Optional region code filter (e.g. `'GRA11'`).
-     * @returns The catalog rows.
-     */
-    async ovhCatalogSummary(region) {
-        const data = await this.management.request(CpOvhCatalogSummaryDocument, {
-            region,
-        });
-        return data.cpOvhCatalogSummary;
-    }
-    /**
-     * Platform-wide compute ceilings (the maxima `computeSetPolicy` clamps to).
-     * Every knob is nullable: `null` means no operator override, so the
-     * env-var/bootstrap default applies on the game-api side.
-     *
-     * @returns The stored ceiling overrides plus updatedAt/updatedByUserId.
+     * @returns The stored ceilings row.
      */
     async computePlatformCeilings() {
         const data = await this.management.request(CpComputePlatformCeilingsDocument);
@@ -125,10 +29,9 @@ export class ControlPlaneAPI {
     /**
      * Patch the platform compute ceilings. Patch semantics per knob: omit =
      * unchanged, explicit `null` = clear the override (fall back to the
-     * game-api bootstrap default), positive value = set. Changes replica-sync
-     * to game-api and take effect on the next `computeSetPolicy` call (no
-     * restart), within a 30s cache bound. Writes a
-     * `compute.platform_ceilings_set` audit entry.
+     * game-api bootstrap default), positive value = set. Takes effect on the
+     * next `computeSetPolicy` call (no restart), within a 30s cache bound.
+     * Writes a `compute.platform_ceilings_set` audit entry.
      *
      * @param input - The per-knob patch.
      * @returns The stored ceilings after the patch.
@@ -137,142 +40,4 @@ export class ControlPlaneAPI {
         const data = await this.management.request(CpSetComputePlatformCeilingsDocument, { input });
         return data.cpSetComputePlatformCeilings;
     }
-    /**
-     * Operator per-minute usage summary for any environment (not org-scoped).
-     *
-     * @param environmentSlug - Environment slug.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns The usage summary.
-     */
-    async usageSummary(environmentSlug, since) {
-        const data = await this.management.request(CpUsageSummaryDocument, {
-            environmentSlug,
-            since,
-        });
-        return data.cpUsageSummary;
-    }
-    /**
-     * cks-game-api git tags not yet pinned by any environment release.
-     *
-     * @returns The unreleased tags with proposed versions.
-     */
-    async unreleasedGameApiTags() {
-        const data = await this.management.request(CpUnreleasedGameApiTagsDocument, {});
-        return data.cpUnreleasedGameApiTags;
-    }
-    /**
-     * Environment release manifests merged from git + DB.
-     *
-     * @returns The version rows with latest-available and git-source flags.
-     */
-    async environmentVersions() {
-        const data = await this.management.request(CpEnvironmentVersionsDocument, {});
-        return data.cpEnvironmentVersions;
-    }
-    /**
-     * List users with operator and/or super-admin privileges.
-     *
-     * @returns The privileged users.
-     */
-    async operatorUsers() {
-        const data = await this.management.request(OperatorUsersDocument, {});
-        return data.operatorUsers;
-    }
-    /**
-     * Toggle deletion protection on an environment (blocks purge when enabled).
-     * Writes an audit entry.
-     *
-     * @param environmentId - Environment UUID.
-     * @param enabled - `true` to protect, `false` to unprotect.
-     * @returns `true` on success.
-     */
-    async setDeletionProtection(environmentId, enabled) {
-        const data = await this.management.request(SetEnvironmentDeletionProtectionDocument, { environmentId, enabled });
-        return data.setEnvironmentDeletionProtection;
-    }
-    /**
-     * Create/overwrite a control-plane secret (plaintext is write-only). Writes an
-     * audit entry.
-     *
-     * @param environmentId - Environment UUID.
-     * @param name - Secret name/key.
-     * @param plaintext - Secret value to encrypt and store.
-     * @param kind - Optional classification tag.
-     * @returns The secret metadata row.
-     */
-    async putSecret(environmentId, name, plaintext, kind) {
-        const data = await this.management.request(PutCpSecretDocument, {
-            environmentId,
-            name,
-            plaintext,
-            kind,
-        });
-        return data.putCpSecret;
-    }
-    /**
-     * Delete a control-plane secret by environment + name. Writes an audit entry.
-     *
-     * @param environmentId - Environment UUID.
-     * @param name - Secret name/key to delete.
-     * @returns `true` when a secret was removed.
-     */
-    async deleteSecret(environmentId, name) {
-        const data = await this.management.request(DeleteCpSecretDocument, {
-            environmentId,
-            name,
-        });
-        return data.deleteCpSecret;
-    }
-    /**
-     * Create/overwrite an environment-delivered secret (injected into the tenant
-     * runtime; plaintext is write-only). Writes an audit entry.
-     *
-     * @param environmentId - Environment UUID.
-     * @param name - Secret name/key.
-     * @param plaintext - Secret value to encrypt and store.
-     * @param kind - Optional classification tag.
-     * @returns The env-secret metadata row.
-     */
-    async putEnvSecret(environmentId, name, plaintext, kind) {
-        const data = await this.management.request(PutCpEnvSecretDocument, {
-            environmentId,
-            name,
-            plaintext,
-            kind,
-        });
-        return data.putCpEnvSecret;
-    }
-    /**
-     * Ingest a release manifest into the deployable catalog. Writes an audit
-     * entry.
-     *
-     * @param input - {@link IngestEnvironmentVersionInput} (version, force).
-     * @returns The ingested version row.
-     */
-    async ingestEnvironmentVersion(input) {
-        const data = await this.management.request(IngestEnvironmentVersionDocument, { input });
-        return data.ingestEnvironmentVersion;
-    }
-    /**
-     * Cut a new environment release from a cks-game-api git tag (ingests + commits
-     * the manifest to git). SIDE EFFECT: retargets redeploy and writes to GitHub.
-     *
-     * @param input - {@link PublishEnvironmentReleaseFromGameApiTagInput}.
-     * @returns The publish result.
-     */
-    async publishReleaseFromGameApiTag(input) {
-        const data = await this.management.request(PublishEnvironmentReleaseFromGameApiTagDocument, { input });
-        return data.publishEnvironmentReleaseFromGameApiTag;
-    }
-    /**
-     * Yank (withdraw) an environment version so it can no longer be deployed.
-     * Existing environments are unaffected. Writes an audit entry.
-     *
-     * @param version - Environment version to yank (e.g. `'v0.1.4'`).
-     * @returns `true` on success.
-     */
-    async yankEnvironmentVersion(version) {
-        const data = await this.management.request(YankEnvironmentVersionDocument, { version });
-        return data.yankEnvironmentVersion;
-    }
 }

package/dist/domains/usage.d.ts

@@ -1,13 +1,17 @@
 import type { GraphQLClient } from '../client.js';
-import { type EnvironmentUsageSummaryQuery, type OrgUsageByEnvironmentQuery, type EnvironmentUsageByAppQuery, type AppGraphqlOperationsQuery, type AppUsageSummaryQuery, type PlayerPulseQuery } from '../generated/graphql.js';
+import { type AppGraphqlOperationsQuery, type AppUsageSummaryQuery, type PlayerPulseQuery } from '../generated/graphql.js';
 /**
  * Replication + GraphQL usage reporting — exposed as `client.usage` (and
  * grouped under `client.admin`).
  *
- * Targets the **management-api**. All operations are read-only observability and
- * require the `view_usage` org permission. `since` args are ISO-8601 `DateTime`
- * strings; byte/message counters are returned as string counters because they
- * can exceed the 32-bit Int range. `BigInt` ids are decimal strings.
+ * All operations are read-only observability and require the `view_usage` org
+ * permission. `since` args are ISO-8601 `DateTime` strings; byte/message
+ * counters are returned as string counters because they can exceed the 32-bit
+ * Int range. `BigInt` ids are decimal strings.
+ *
+ * As of the unified galaxy API the per-environment rollups
+ * (environmentSummary/orgByEnvironment/environmentByApp) were retired with
+ * dedicated customer environments — usage is org/app-scoped.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` / `SCOPE_MISSING`
  *   per the permission notes above.
@@ -15,33 +19,6 @@ import { type EnvironmentUsageSummaryQuery, type OrgUsageByEnvironmentQuery, typ
 export declare class UsageAPI {
     private readonly management;
     constructor(management: GraphQLClient);
-    /**
-     * Per-minute replication + GraphQL usage time series for one environment,
-     * with rate peaks and live Buddy rates.
-     *
-     * @param orgId - Numeric org id.
-     * @param environmentSlug - Environment slug to report on.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns The {@link EnvironmentUsageSummary}.
-     */
-    environmentSummary(orgId: string, environmentSlug: string, since: string): Promise<EnvironmentUsageSummaryQuery['environmentUsageSummary']>;
-    /**
-     * Aggregate byte totals per environment across an org for a window.
-     *
-     * @param orgId - Numeric org id.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns One rollup row per environment.
-     */
-    orgByEnvironment(orgId: string, since: string): Promise<OrgUsageByEnvironmentQuery['orgUsageByEnvironment']>;
-    /**
-     * Aggregate byte totals per app for the apps linked to an environment.
-     *
-     * @param orgId - Numeric org id.
-     * @param environmentSlug - Environment slug whose apps to roll up.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns One rollup row per app.
-     */
-    environmentByApp(orgId: string, environmentSlug: string, since: string): Promise<EnvironmentUsageByAppQuery['environmentUsageByApp']>;
     /**
      * Top GraphQL operations for an app ranked by bytes.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/domains/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAOL,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,aAAa;IAEtD;;;;;;;;OAQG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,4BAA4B,CAAC,yBAAyB,CAAC,CAAC;IAQnE;;;;;;OAMG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;IAQ/D;;;;;;;OAOG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;IAS/D;;;;;;;;OAQG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IAU7D;;;;;;;;OAQG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAUnD;;;;;;;;OAQG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;CAI5C"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/domains/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,aAAa;IAEtD;;;;;;;;OAQG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IAU7D;;;;;;;;OAQG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAUnD;;;;;;;;OAQG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;CAI5C"}

package/dist/domains/usage.js

@@ -1,12 +1,16 @@
-import { EnvironmentUsageSummaryDocument, OrgUsageByEnvironmentDocument, EnvironmentUsageByAppDocument, AppGraphqlOperationsDocument, AppUsageSummaryDocument, PlayerPulseDocument, } from '../generated/graphql.js';
+import { AppGraphqlOperationsDocument, AppUsageSummaryDocument, PlayerPulseDocument, } from '../generated/graphql.js';
 /**
  * Replication + GraphQL usage reporting — exposed as `client.usage` (and
  * grouped under `client.admin`).
  *
- * Targets the **management-api**. All operations are read-only observability and
- * require the `view_usage` org permission. `since` args are ISO-8601 `DateTime`
- * strings; byte/message counters are returned as string counters because they
- * can exceed the 32-bit Int range. `BigInt` ids are decimal strings.
+ * All operations are read-only observability and require the `view_usage` org
+ * permission. `since` args are ISO-8601 `DateTime` strings; byte/message
+ * counters are returned as string counters because they can exceed the 32-bit
+ * Int range. `BigInt` ids are decimal strings.
+ *
+ * As of the unified galaxy API the per-environment rollups
+ * (environmentSummary/orgByEnvironment/environmentByApp) were retired with
+ * dedicated customer environments — usage is org/app-scoped.
  *
  * @throws {CrowdyGraphQLError} `UNAUTHENTICATED` / `FORBIDDEN` / `SCOPE_MISSING`
  *   per the permission notes above.
@@ -15,49 +19,6 @@ export class UsageAPI {
     constructor(management) {
         this.management = management;
     }
-    /**
-     * Per-minute replication + GraphQL usage time series for one environment,
-     * with rate peaks and live Buddy rates.
-     *
-     * @param orgId - Numeric org id.
-     * @param environmentSlug - Environment slug to report on.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns The {@link EnvironmentUsageSummary}.
-     */
-    async environmentSummary(orgId, environmentSlug, since) {
-        const data = await this.management.request(EnvironmentUsageSummaryDocument, { orgId, environmentSlug, since });
-        return data.environmentUsageSummary;
-    }
-    /**
-     * Aggregate byte totals per environment across an org for a window.
-     *
-     * @param orgId - Numeric org id.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns One rollup row per environment.
-     */
-    async orgByEnvironment(orgId, since) {
-        const data = await this.management.request(OrgUsageByEnvironmentDocument, {
-            orgId,
-            since,
-        });
-        return data.orgUsageByEnvironment;
-    }
-    /**
-     * Aggregate byte totals per app for the apps linked to an environment.
-     *
-     * @param orgId - Numeric org id.
-     * @param environmentSlug - Environment slug whose apps to roll up.
-     * @param since - Start of the window (ISO-8601 DateTime) up to now.
-     * @returns One rollup row per app.
-     */
-    async environmentByApp(orgId, environmentSlug, since) {
-        const data = await this.management.request(EnvironmentUsageByAppDocument, {
-            orgId,
-            environmentSlug,
-            since,
-        });
-        return data.environmentUsageByApp;
-    }
     /**
      * Top GraphQL operations for an app ranked by bytes.
      *