@spec0/sdk-public-platform 1.9.0 → 1.11.0

package/dist/generated/index.d.ts

@@ -4,12 +4,14 @@ export { OpenAPI } from './core/OpenAPI.js';
 export type { OpenAPIConfig } from './core/OpenAPI.js';
 export type { AiSearchRequestV1 } from './models/AiSearchRequestV1.js';
 export type { AiSearchResponseV1 } from './models/AiSearchResponseV1.js';
+export type { ApiConsumerCountV1 } from './models/ApiConsumerCountV1.js';
 export type { ApiNamePath } from './models/ApiNamePath.js';
 export type { ApiTeamListItemV1 } from './models/ApiTeamListItemV1.js';
 export type { AuthError } from './models/AuthError.js';
 export type { CiConfigResponseV1 } from './models/CiConfigResponseV1.js';
 export type { CreateMockRequestV1 } from './models/CreateMockRequestV1.js';
 export type { CreateMockResponseV1 } from './models/CreateMockResponseV1.js';
+export type { EnvTargetV1 } from './models/EnvTargetV1.js';
 export type { GovernanceWarningV1 } from './models/GovernanceWarningV1.js';
 export type { MockItemV1 } from './models/MockItemV1.js';
 export type { OrgSlugPath } from './models/OrgSlugPath.js';
@@ -21,6 +23,7 @@ export type { PublicApiMetaV1 } from './models/PublicApiMetaV1.js';
 export type { PublicPublishRequestV1 } from './models/PublicPublishRequestV1.js';
 export type { PublicPublishResponseV1 } from './models/PublicPublishResponseV1.js';
 export type { PutSpectralRulesetRequestV1 } from './models/PutSpectralRulesetRequestV1.js';
+export type { RefreshMockResponseV1 } from './models/RefreshMockResponseV1.js';
 export type { SpecDiffResponseV1 } from './models/SpecDiffResponseV1.js';
 export type { SpectralRulesetResponseV1 } from './models/SpectralRulesetResponseV1.js';
 export type { SpecVersionListItemV1 } from './models/SpecVersionListItemV1.js';

package/dist/generated/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,YAAY,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,YAAY,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAC3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"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"}

package/dist/generated/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":";;;AAAA,+DAA+D;AAC/D,0BAA0B;AAC1B,oBAAoB;AACpB,oBAAoB;AACpB,kDAA8C;AAArC,uGAAA,QAAQ,OAAA;AACjB,oEAA6E;AAApE,yHAAA,iBAAiB,OAAA;AAAE,mHAAA,WAAW,OAAA;AACvC,gDAA4C;AAAnC,qGAAA,OAAO,OAAA;AAmChB,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAC1B,oEAAgE;AAAvD,qHAAA,eAAe,OAAA;AACxB,0EAAsE;AAA7D,2HAAA,kBAAkB,OAAA;AAC3B,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAC1B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,0EAAsE;AAA7D,2HAAA,kBAAkB,OAAA;AAC3B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,0EAAsE;AAA7D,2HAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":";;;AAAA,+DAA+D;AAC/D,0BAA0B;AAC1B,oBAAoB;AACpB,oBAAoB;AACpB,kDAA8C;AAArC,uGAAA,QAAQ,OAAA;AACjB,oEAA6E;AAApE,yHAAA,iBAAiB,OAAA;AAAE,mHAAA,WAAW,OAAA;AACvC,gDAA4C;AAAnC,qGAAA,OAAO,OAAA;AAsChB,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAC1B,oEAAgE;AAAvD,qHAAA,eAAe,OAAA;AACxB,0EAAsE;AAA7D,2HAAA,kBAAkB,OAAA;AAC3B,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAC1B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,0EAAsE;AAA7D,2HAAA,kBAAkB,OAAA;AAC3B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,0EAAsE;AAA7D,2HAAA,kBAAkB,OAAA"}

package/dist/generated/models/ApiConsumerCountV1.d.ts

@@ -0,0 +1,19 @@
+/**
+ * How many consumers depend on an API. Counts only — never names. Who consumes an
+ * API is org-governance information that belongs to the dashboard's consumers view,
+ * with the permissions and approval flow that go with it.
+ *
+ */
+export type ApiConsumerCountV1 = {
+    /**
+     * Every grant on this API, whatever its status. A pending grant is a real
+     * consumer awaiting a decision, so it counts here rather than being hidden.
+     *
+     */
+    total: number;
+    /**
+     * Grants in `APPROVED` — consumers that can actually call the API today.
+     */
+    approved: number;
+};
+//# sourceMappingURL=ApiConsumerCountV1.d.ts.map

package/dist/generated/models/ApiConsumerCountV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiConsumerCountV1.d.ts","sourceRoot":"","sources":["../../../src/generated/models/ApiConsumerCountV1.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/generated/models/ApiConsumerCountV1.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ApiConsumerCountV1.js.map

package/dist/generated/models/ApiConsumerCountV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiConsumerCountV1.js","sourceRoot":"","sources":["../../../src/generated/models/ApiConsumerCountV1.ts"],"names":[],"mappings":""}

package/dist/generated/models/EnvTargetV1.d.ts

@@ -0,0 +1,34 @@
+/**
+ * One environment an API is deployed to: a destination and what's live there.
+ * Carries no variables, credentials or custom metadata.
+ *
+ */
+export type EnvTargetV1 = {
+    /**
+     * The environment's name, as the organisation defined it — unique within the
+     * org, and the whole of its meaning. There is deliberately no kind or
+     * classification alongside it: that would be a second source of truth for the
+     * same fact, free to disagree with the name the org actually typed.
+     *
+     */
+    name?: string;
+    /**
+     * Absolute and already resolved. Where an environment's URL is derived from the
+     * spec's `servers` block, templated variables are expanded before storage, so a
+     * client never has to resolve a template itself.
+     *
+     */
+    url?: string;
+    /**
+     * The spec version live in this environment, or null if nothing has been
+     * published to or promoted into it. A client holding a different version can
+     * say so, instead of reporting the difference as contract drift.
+     *
+     */
+    currentVersion?: string | null;
+    /**
+     * When this environment's configuration for the API last changed.
+     */
+    updatedAt?: string | null;
+};
+//# sourceMappingURL=EnvTargetV1.d.ts.map

package/dist/generated/models/EnvTargetV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvTargetV1.d.ts","sourceRoot":"","sources":["../../../src/generated/models/EnvTargetV1.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC"}

package/dist/generated/models/EnvTargetV1.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=EnvTargetV1.js.map

package/dist/generated/models/EnvTargetV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvTargetV1.js","sourceRoot":"","sources":["../../../src/generated/models/EnvTargetV1.ts"],"names":[],"mappings":""}

package/dist/generated/models/MockItemV1.d.ts

@@ -1,4 +1,12 @@
 export type MockItemV1 = {
+    /**
+     * The spec version this mock is currently serving. May lag the API's latest
+     * published version — a mock is bound to the snapshot it was built from
+     * until refreshed. Clients use this to distinguish version skew from real
+     * contract drift.
+     *
+     */
+    specVersion?: string | null;
     mockServerId?: string;
     apiId?: string;
     apiName?: string;

package/dist/generated/models/MockItemV1.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockItemV1.d.ts","sourceRoot":"","sources":["../../../src/generated/models/MockItemV1.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"MockItemV1.d.ts","sourceRoot":"","sources":["../../../src/generated/models/MockItemV1.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG;IACvB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/generated/models/RefreshMockResponseV1.d.ts

@@ -0,0 +1,26 @@
+export type RefreshMockResponseV1 = {
+    /**
+     * Unchanged by a refresh — the public handle is stable.
+     */
+    mockServerId?: string;
+    /**
+     * The spec version the mock now serves.
+     */
+    specVersion?: string | null;
+    /**
+     * False when the mock already served the current spec.
+     */
+    refreshed?: boolean;
+    /**
+     * Hand-written variants re-created on the rebuilt mock.
+     */
+    customVariantsCarriedOver?: number;
+    /**
+     * Hand-written variants that could not be carried over because their
+     * operation no longer exists in the spec. Reported rather than silently
+     * discarded.
+     *
+     */
+    customVariantsDropped?: Array<string>;
+};
+//# sourceMappingURL=RefreshMockResponseV1.d.ts.map

package/dist/generated/models/RefreshMockResponseV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RefreshMockResponseV1.d.ts","sourceRoot":"","sources":["../../../src/generated/models/RefreshMockResponseV1.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC"}

package/dist/generated/models/RefreshMockResponseV1.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=RefreshMockResponseV1.js.map

package/dist/generated/models/RefreshMockResponseV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RefreshMockResponseV1.js","sourceRoot":"","sources":["../../../src/generated/models/RefreshMockResponseV1.ts"],"names":[],"mappings":""}

package/dist/generated/services/PublicApisService.d.ts

@@ -1,4 +1,6 @@
+import type { ApiConsumerCountV1 } from '../models/ApiConsumerCountV1.js';
 import type { ApiTeamListItemV1 } from '../models/ApiTeamListItemV1.js';
+import type { EnvTargetV1 } from '../models/EnvTargetV1.js';
 import type { PublicApiListItem } from '../models/PublicApiListItem.js';
 import type { PublicApiMetaV1 } from '../models/PublicApiMetaV1.js';
 import type { PublicPublishRequestV1 } from '../models/PublicPublishRequestV1.js';
@@ -92,6 +94,65 @@ export declare class PublicApisService {
     static getTeamApiSpec({ apiId, }: {
         apiId: string;
     }): CancelablePromise<string>;
+    /**
+     * List the environments an API is deployed to
+     * Where this API actually runs — the URLs the platform already knows, so a client
+     * doesn't have to ask a developer to type them.
+     *
+     * **Targets, not client environments.** These are destinations: an environment's
+     * name and the URL it serves at. They carry no variables, tokens or secrets, and
+     * clients must not treat them as a place to put any. Per-API custom metadata
+     * (`envMetadata` on the internal surface) is free-form and may hold credentials in
+     * existing orgs, so it is deliberately **not** returned here.
+     *
+     * Environments are whatever the organisation defined, named however they named
+     * them, and the name is the whole of their meaning. There is no classification
+     * field: this endpoint reports what exists, it does not interpret it.
+     *
+     * Returned in the organisation's promotion order — the same order the dashboard
+     * lays them out in, so the two surfaces agree.
+     *
+     * Choosing a destination is the developer's, so a client should present these and
+     * let one be picked rather than picking on their behalf.
+     *
+     * Authorization stack:
+     * - scope: `read:apis`
+     * - ABAC v2: caller must be permitted to `view` the API resource (cross-org and
+     * cross-team isolation collapse to 404 to avoid leaking existence).
+     *
+     * @returns EnvTargetV1 Environments configured for this API, in the org's promotion order
+     * @throws ApiError
+     */
+    static listTeamApiEnvironments({ apiId, }: {
+        apiId: string;
+    }): CancelablePromise<Array<EnvTargetV1>>;
+    /**
+     * How many consumers depend on an API
+     * The blast-radius number: how many teams and services hold a grant on this API,
+     * and how many of those grants are approved. It answers "if I change this, does
+     * anyone else care?" — the question worth asking *before* editing a contract.
+     *
+     * **Counts, not a roster.** Who consumes what is org-governance information with
+     * its own screen, approval flow and permissions in the dashboard; restating a
+     * slice of it here would create a second, staler place to read it. A client that
+     * needs the detail should link a person to the dashboard, which this count is
+     * sized to prompt.
+     *
+     * `total` counts every grant regardless of status; `approved` counts only those in
+     * `APPROVED`. A pending grant is a real consumer waiting on a decision, so it is
+     * deliberately included in the total rather than hidden.
+     *
+     * Authorization stack:
+     * - scope: `read:apis`
+     * - ABAC v2: caller must be permitted to `view` the API resource (cross-org and
+     * cross-team isolation collapse to 404 to avoid leaking existence).
+     *
+     * @returns ApiConsumerCountV1 Consumer counts for this API
+     * @throws ApiError
+     */
+    static getTeamApiConsumerCount({ apiId, }: {
+        apiId: string;
+    }): CancelablePromise<ApiConsumerCountV1>;
     /**
      * List published versions of a team-scoped private API
      * Mirrors `GET /api/v1/public/registry/{orgSlug}/{apiName}/versions` for the

package/dist/generated/services/PublicApisService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PublicApisService.d.ts","sourceRoot":"","sources":["../../../src/generated/services/PublicApisService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,iBAAiB;IAC5B;;;;;OAKG;WACW,cAAc,IAAI,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAU3E;;;;;;;;OAQG;WACW,gBAAgB,CAAC,EAC7B,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,sBAAsB,CAAC;KACrC,GAAG,iBAAiB,CAAC,uBAAuB,CAAC;IAe9C;;;;;;;;;;OAUG;WACW,YAAY,IAAI,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAUzE;;;;;;;;;;;;;OAaG;WACW,cAAc,CAAC,EAC3B,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,oBAAoB,CAAC;KACnC,GAAG,iBAAiB,CAAC,qBAAqB,CAAC;IAgB5C;;;;;;;;;;;OAWG;WACW,aAAa,CAAC,EAC1B,KAAK,GACN,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,iBAAiB,CAAC,IAAI,CAAC;IAc3B;;;;;;;;;;;;;;;;OAgBG;WACW,cAAc,CAAC,EAC3B,KAAK,GACN,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAc7B;;;;;;;;;OASG;WACW,mBAAmB,CAAC,EAChC,KAAK,GACN,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,iBAAiB,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAcnD;;;;;;;;OAQG;WACW,mBAAmB,CAAC,EAChC,KAAK,EACL,GAAG,GACJ,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAe7B;;;;;;;;;OASG;WACW,yBAAyB,CAAC,EACtC,WAAW,EACX,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,yBAAyB,CAAC;KACxC,GAAG,iBAAiB,CAAC,eAAe,CAAC;IAgBtC;;;;;;;OAOG;WACW,eAAe,CAAC,EAC5B,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,iBAAiB,CAAC,IAAI,CAAC;CAc5B"}
+{"version":3,"file":"PublicApisService.d.ts","sourceRoot":"","sources":["../../../src/generated/services/PublicApisService.ts"],"names":[],"mappings":"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"}

package/dist/generated/services/PublicApisService.js

@@ -152,6 +152,87 @@ class PublicApisService {
             },
         });
     }
+    /**
+     * List the environments an API is deployed to
+     * Where this API actually runs — the URLs the platform already knows, so a client
+     * doesn't have to ask a developer to type them.
+     *
+     * **Targets, not client environments.** These are destinations: an environment's
+     * name and the URL it serves at. They carry no variables, tokens or secrets, and
+     * clients must not treat them as a place to put any. Per-API custom metadata
+     * (`envMetadata` on the internal surface) is free-form and may hold credentials in
+     * existing orgs, so it is deliberately **not** returned here.
+     *
+     * Environments are whatever the organisation defined, named however they named
+     * them, and the name is the whole of their meaning. There is no classification
+     * field: this endpoint reports what exists, it does not interpret it.
+     *
+     * Returned in the organisation's promotion order — the same order the dashboard
+     * lays them out in, so the two surfaces agree.
+     *
+     * Choosing a destination is the developer's, so a client should present these and
+     * let one be picked rather than picking on their behalf.
+     *
+     * Authorization stack:
+     * - scope: `read:apis`
+     * - ABAC v2: caller must be permitted to `view` the API resource (cross-org and
+     * cross-team isolation collapse to 404 to avoid leaking existence).
+     *
+     * @returns EnvTargetV1 Environments configured for this API, in the org's promotion order
+     * @throws ApiError
+     */
+    static listTeamApiEnvironments({ apiId, }) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'GET',
+            url: '/api/v1/public/apis/team/{apiId}/environments',
+            path: {
+                'apiId': apiId,
+            },
+            errors: {
+                401: `Missing, invalid, expired, or revoked token`,
+                403: `Token does not carry the required scope`,
+                404: `Resource not found (or not visible to the calling org)`,
+            },
+        });
+    }
+    /**
+     * How many consumers depend on an API
+     * The blast-radius number: how many teams and services hold a grant on this API,
+     * and how many of those grants are approved. It answers "if I change this, does
+     * anyone else care?" — the question worth asking *before* editing a contract.
+     *
+     * **Counts, not a roster.** Who consumes what is org-governance information with
+     * its own screen, approval flow and permissions in the dashboard; restating a
+     * slice of it here would create a second, staler place to read it. A client that
+     * needs the detail should link a person to the dashboard, which this count is
+     * sized to prompt.
+     *
+     * `total` counts every grant regardless of status; `approved` counts only those in
+     * `APPROVED`. A pending grant is a real consumer waiting on a decision, so it is
+     * deliberately included in the total rather than hidden.
+     *
+     * Authorization stack:
+     * - scope: `read:apis`
+     * - ABAC v2: caller must be permitted to `view` the API resource (cross-org and
+     * cross-team isolation collapse to 404 to avoid leaking existence).
+     *
+     * @returns ApiConsumerCountV1 Consumer counts for this API
+     * @throws ApiError
+     */
+    static getTeamApiConsumerCount({ apiId, }) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'GET',
+            url: '/api/v1/public/apis/team/{apiId}/consumers',
+            path: {
+                'apiId': apiId,
+            },
+            errors: {
+                401: `Missing, invalid, expired, or revoked token`,
+                403: `Token does not carry the required scope`,
+                404: `Resource not found (or not visible to the calling org)`,
+            },
+        });
+    }
     /**
      * List published versions of a team-scoped private API
      * Mirrors `GET /api/v1/public/registry/{orgSlug}/{apiName}/versions` for the

package/dist/generated/services/PublicApisService.js.map

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

package/dist/generated/services/PublicMocksService.d.ts

@@ -1,6 +1,7 @@
 import type { CreateMockRequestV1 } from '../models/CreateMockRequestV1.js';
 import type { CreateMockResponseV1 } from '../models/CreateMockResponseV1.js';
 import type { MockItemV1 } from '../models/MockItemV1.js';
+import type { RefreshMockResponseV1 } from '../models/RefreshMockResponseV1.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare class PublicMocksService {
     /**
@@ -25,6 +26,29 @@ export declare class PublicMocksService {
     static createPublicMock({ requestBody, }: {
         requestBody: CreateMockRequestV1;
     }): CancelablePromise<CreateMockResponseV1>;
+    /**
+     * Re-provision a mock against its API's latest published spec
+     * A mock is bound to the spec snapshot it was created from, so publishing a new
+     * version of an API leaves its mock serving the previous contract. This rebuilds
+     * it against the API's current spec.
+     *
+     * The mock's **public id, URL and API key are unchanged** — those are what CI
+     * configs and clients already hold. Auto-generated variants are replaced with
+     * ones correct for the new spec; hand-written variants are carried over where
+     * their operation still exists, and the ones that couldn't be are listed in the
+     * response rather than silently dropped.
+     *
+     * Idempotent: refreshing a mock that already serves the current spec reports
+     * `refreshed: false` and changes nothing.
+     *
+     * Cross-org returns 404, not 403, so the existence of a mock is not leaked.
+     *
+     * @returns RefreshMockResponseV1 Refresh outcome
+     * @throws ApiError
+     */
+    static refreshPublicMock({ mockServerId, }: {
+        mockServerId: string;
+    }): CancelablePromise<RefreshMockResponseV1>;
     /**
      * Delete a mock server owned by the calling org
      * Hard-deletes the mock server and removes its association with the parent API.

package/dist/generated/services/PublicMocksService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PublicMocksService.d.ts","sourceRoot":"","sources":["../../../src/generated/services/PublicMocksService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,kBAAkB;IAC7B;;;;;;;;;OASG;WACW,eAAe,IAAI,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAUrE;;;;;;;OAOG;WACW,gBAAgB,CAAC,EAC7B,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,mBAAmB,CAAC;KAClC,GAAG,iBAAiB,CAAC,oBAAoB,CAAC;IAc3C;;;;;;;;OAQG;WACW,gBAAgB,CAAC,EAC7B,YAAY,GACb,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,iBAAiB,CAAC,IAAI,CAAC;CAc5B"}
+{"version":3,"file":"PublicMocksService.d.ts","sourceRoot":"","sources":["../../../src/generated/services/PublicMocksService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,kBAAkB;IAC7B;;;;;;;;;OASG;WACW,eAAe,IAAI,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAUrE;;;;;;;OAOG;WACW,gBAAgB,CAAC,EAC7B,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,mBAAmB,CAAC;KAClC,GAAG,iBAAiB,CAAC,oBAAoB,CAAC;IAc3C;;;;;;;;;;;;;;;;;;;OAmBG;WACW,iBAAiB,CAAC,EAC9B,YAAY,GACb,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,iBAAiB,CAAC,qBAAqB,CAAC;IAc5C;;;;;;;;OAQG;WACW,gBAAgB,CAAC,EAC7B,YAAY,GACb,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,iBAAiB,CAAC,IAAI,CAAC;CAc5B"}

package/dist/generated/services/PublicMocksService.js

@@ -46,6 +46,40 @@ class PublicMocksService {
             },
         });
     }
+    /**
+     * Re-provision a mock against its API's latest published spec
+     * A mock is bound to the spec snapshot it was created from, so publishing a new
+     * version of an API leaves its mock serving the previous contract. This rebuilds
+     * it against the API's current spec.
+     *
+     * The mock's **public id, URL and API key are unchanged** — those are what CI
+     * configs and clients already hold. Auto-generated variants are replaced with
+     * ones correct for the new spec; hand-written variants are carried over where
+     * their operation still exists, and the ones that couldn't be are listed in the
+     * response rather than silently dropped.
+     *
+     * Idempotent: refreshing a mock that already serves the current spec reports
+     * `refreshed: false` and changes nothing.
+     *
+     * Cross-org returns 404, not 403, so the existence of a mock is not leaked.
+     *
+     * @returns RefreshMockResponseV1 Refresh outcome
+     * @throws ApiError
+     */
+    static refreshPublicMock({ mockServerId, }) {
+        return (0, request_js_1.request)(OpenAPI_js_1.OpenAPI, {
+            method: 'POST',
+            url: '/api/v1/public/mocks/{mockServerId}/refresh',
+            path: {
+                'mockServerId': mockServerId,
+            },
+            errors: {
+                401: `Missing, invalid, expired, or revoked token`,
+                403: `Token does not carry the required scope`,
+                404: `Resource not found (or not visible to the calling org)`,
+            },
+        });
+    }
     /**
      * Delete a mock server owned by the calling org
      * Hard-deletes the mock server and removes its association with the parent API.

package/dist/generated/services/PublicMocksService.js.map

@@ -1 +1 @@
-{"version":3,"file":"PublicMocksService.js","sourceRoot":"","sources":["../../../src/generated/services/PublicMocksService.ts"],"names":[],"mappings":";;;AAQA,mDAA6C;AAC7C,mDAA0D;AAC1D,MAAa,kBAAkB;IAC7B;;;;;;;;;OASG;IACI,MAAM,CAAC,eAAe;QAC3B,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,sBAAsB;YAC3B,MAAM,EAAE;gBACN,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;aAC/C;SACF,CAAC,CAAC;IACL,CAAC;IACD;;;;;;;OAOG;IACI,MAAM,CAAC,gBAAgB,CAAC,EAC7B,WAAW,GAGZ;QACC,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,sBAAsB;YAC3B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE;gBACN,GAAG,EAAE,aAAa;gBAClB,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;gBAC9C,GAAG,EAAE,wDAAwD;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;IACD;;;;;;;;OAQG;IACI,MAAM,CAAC,gBAAgB,CAAC,EAC7B,YAAY,GAGb;QACC,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,qCAAqC;YAC1C,IAAI,EAAE;gBACJ,cAAc,EAAE,YAAY;aAC7B;YACD,MAAM,EAAE;gBACN,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;gBAC9C,GAAG,EAAE,wDAAwD;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;CACF;AA1ED,gDA0EC"}
+{"version":3,"file":"PublicMocksService.js","sourceRoot":"","sources":["../../../src/generated/services/PublicMocksService.ts"],"names":[],"mappings":";;;AASA,mDAA6C;AAC7C,mDAA0D;AAC1D,MAAa,kBAAkB;IAC7B;;;;;;;;;OASG;IACI,MAAM,CAAC,eAAe;QAC3B,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,sBAAsB;YAC3B,MAAM,EAAE;gBACN,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;aAC/C;SACF,CAAC,CAAC;IACL,CAAC;IACD;;;;;;;OAOG;IACI,MAAM,CAAC,gBAAgB,CAAC,EAC7B,WAAW,GAGZ;QACC,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,sBAAsB;YAC3B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE;gBACN,GAAG,EAAE,aAAa;gBAClB,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;gBAC9C,GAAG,EAAE,wDAAwD;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;IACD;;;;;;;;;;;;;;;;;;;OAmBG;IACI,MAAM,CAAC,iBAAiB,CAAC,EAC9B,YAAY,GAGb;QACC,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,6CAA6C;YAClD,IAAI,EAAE;gBACJ,cAAc,EAAE,YAAY;aAC7B;YACD,MAAM,EAAE;gBACN,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;gBAC9C,GAAG,EAAE,wDAAwD;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;IACD;;;;;;;;OAQG;IACI,MAAM,CAAC,gBAAgB,CAAC,EAC7B,YAAY,GAGb;QACC,OAAO,IAAA,oBAAS,EAAC,oBAAO,EAAE;YACxB,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,qCAAqC;YAC1C,IAAI,EAAE;gBACJ,cAAc,EAAE,YAAY;aAC7B;YACD,MAAM,EAAE;gBACN,GAAG,EAAE,6CAA6C;gBAClD,GAAG,EAAE,yCAAyC;gBAC9C,GAAG,EAAE,wDAAwD;aAC9D;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAhHD,gDAgHC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spec0/sdk-public-platform",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "TypeScript SDK for Spec0's public API surface (https://app.spec0.io). Generated from the OpenAPI spec published at spec0/spec0-platform.",
   "license": "MIT",
   "main": "./dist/index.js",

package/src/generated/index.ts

@@ -9,12 +9,14 @@ export type { OpenAPIConfig } from './core/OpenAPI.js';
 
 export type { AiSearchRequestV1 } from './models/AiSearchRequestV1.js';
 export type { AiSearchResponseV1 } from './models/AiSearchResponseV1.js';
+export type { ApiConsumerCountV1 } from './models/ApiConsumerCountV1.js';
 export type { ApiNamePath } from './models/ApiNamePath.js';
 export type { ApiTeamListItemV1 } from './models/ApiTeamListItemV1.js';
 export type { AuthError } from './models/AuthError.js';
 export type { CiConfigResponseV1 } from './models/CiConfigResponseV1.js';
 export type { CreateMockRequestV1 } from './models/CreateMockRequestV1.js';
 export type { CreateMockResponseV1 } from './models/CreateMockResponseV1.js';
+export type { EnvTargetV1 } from './models/EnvTargetV1.js';
 export type { GovernanceWarningV1 } from './models/GovernanceWarningV1.js';
 export type { MockItemV1 } from './models/MockItemV1.js';
 export type { OrgSlugPath } from './models/OrgSlugPath.js';
@@ -26,6 +28,7 @@ export type { PublicApiMetaV1 } from './models/PublicApiMetaV1.js';
 export type { PublicPublishRequestV1 } from './models/PublicPublishRequestV1.js';
 export type { PublicPublishResponseV1 } from './models/PublicPublishResponseV1.js';
 export type { PutSpectralRulesetRequestV1 } from './models/PutSpectralRulesetRequestV1.js';
+export type { RefreshMockResponseV1 } from './models/RefreshMockResponseV1.js';
 export type { SpecDiffResponseV1 } from './models/SpecDiffResponseV1.js';
 export type { SpectralRulesetResponseV1 } from './models/SpectralRulesetResponseV1.js';
 export type { SpecVersionListItemV1 } from './models/SpecVersionListItemV1.js';

package/src/generated/models/ApiConsumerCountV1.ts

@@ -0,0 +1,23 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * How many consumers depend on an API. Counts only — never names. Who consumes an
+ * API is org-governance information that belongs to the dashboard's consumers view,
+ * with the permissions and approval flow that go with it.
+ *
+ */
+export type ApiConsumerCountV1 = {
+  /**
+   * Every grant on this API, whatever its status. A pending grant is a real
+   * consumer awaiting a decision, so it counts here rather than being hidden.
+   *
+   */
+  total: number;
+  /**
+   * Grants in `APPROVED` — consumers that can actually call the API today.
+   */
+  approved: number;
+};
+

package/src/generated/models/EnvTargetV1.ts

@@ -0,0 +1,38 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * One environment an API is deployed to: a destination and what's live there.
+ * Carries no variables, credentials or custom metadata.
+ *
+ */
+export type EnvTargetV1 = {
+  /**
+   * The environment's name, as the organisation defined it — unique within the
+   * org, and the whole of its meaning. There is deliberately no kind or
+   * classification alongside it: that would be a second source of truth for the
+   * same fact, free to disagree with the name the org actually typed.
+   *
+   */
+  name?: string;
+  /**
+   * Absolute and already resolved. Where an environment's URL is derived from the
+   * spec's `servers` block, templated variables are expanded before storage, so a
+   * client never has to resolve a template itself.
+   *
+   */
+  url?: string;
+  /**
+   * The spec version live in this environment, or null if nothing has been
+   * published to or promoted into it. A client holding a different version can
+   * say so, instead of reporting the difference as contract drift.
+   *
+   */
+  currentVersion?: string | null;
+  /**
+   * When this environment's configuration for the API last changed.
+   */
+  updatedAt?: string | null;
+};
+

package/src/generated/models/MockItemV1.ts

@@ -3,6 +3,14 @@
 /* tslint:disable */
 /* eslint-disable */
 export type MockItemV1 = {
+  /**
+   * The spec version this mock is currently serving. May lag the API's latest
+   * published version — a mock is bound to the snapshot it was built from
+   * until refreshed. Clients use this to distinguish version skew from real
+   * contract drift.
+   *
+   */
+  specVersion?: string | null;
   mockServerId?: string;
   apiId?: string;
   apiName?: string;

package/src/generated/models/RefreshMockResponseV1.ts

@@ -0,0 +1,30 @@
+/* generated using openapi-typescript-codegen -- do not edit */
+/* istanbul ignore file */
+/* tslint:disable */
+/* eslint-disable */
+export type RefreshMockResponseV1 = {
+  /**
+   * Unchanged by a refresh — the public handle is stable.
+   */
+  mockServerId?: string;
+  /**
+   * The spec version the mock now serves.
+   */
+  specVersion?: string | null;
+  /**
+   * False when the mock already served the current spec.
+   */
+  refreshed?: boolean;
+  /**
+   * Hand-written variants re-created on the rebuilt mock.
+   */
+  customVariantsCarriedOver?: number;
+  /**
+   * Hand-written variants that could not be carried over because their
+   * operation no longer exists in the spec. Reported rather than silently
+   * discarded.
+   *
+   */
+  customVariantsDropped?: Array<string>;
+};
+

package/src/generated/services/PublicApisService.ts

@@ -2,7 +2,9 @@
 /* istanbul ignore file */
 /* tslint:disable */
 /* eslint-disable */
+import type { ApiConsumerCountV1 } from '../models/ApiConsumerCountV1.js';
 import type { ApiTeamListItemV1 } from '../models/ApiTeamListItemV1.js';
+import type { EnvTargetV1 } from '../models/EnvTargetV1.js';
 import type { PublicApiListItem } from '../models/PublicApiListItem.js';
 import type { PublicApiMetaV1 } from '../models/PublicApiMetaV1.js';
 import type { PublicPublishRequestV1 } from '../models/PublicPublishRequestV1.js';
@@ -179,6 +181,95 @@ export class PublicApisService {
       },
     });
   }
+  /**
+   * List the environments an API is deployed to
+   * Where this API actually runs — the URLs the platform already knows, so a client
+   * doesn't have to ask a developer to type them.
+   *
+   * **Targets, not client environments.** These are destinations: an environment's
+   * name and the URL it serves at. They carry no variables, tokens or secrets, and
+   * clients must not treat them as a place to put any. Per-API custom metadata
+   * (`envMetadata` on the internal surface) is free-form and may hold credentials in
+   * existing orgs, so it is deliberately **not** returned here.
+   *
+   * Environments are whatever the organisation defined, named however they named
+   * them, and the name is the whole of their meaning. There is no classification
+   * field: this endpoint reports what exists, it does not interpret it.
+   *
+   * Returned in the organisation's promotion order — the same order the dashboard
+   * lays them out in, so the two surfaces agree.
+   *
+   * Choosing a destination is the developer's, so a client should present these and
+   * let one be picked rather than picking on their behalf.
+   *
+   * Authorization stack:
+   * - scope: `read:apis`
+   * - ABAC v2: caller must be permitted to `view` the API resource (cross-org and
+   * cross-team isolation collapse to 404 to avoid leaking existence).
+   *
+   * @returns EnvTargetV1 Environments configured for this API, in the org's promotion order
+   * @throws ApiError
+   */
+  public static listTeamApiEnvironments({
+    apiId,
+  }: {
+    apiId: string,
+  }): CancelablePromise<Array<EnvTargetV1>> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/public/apis/team/{apiId}/environments',
+      path: {
+        'apiId': apiId,
+      },
+      errors: {
+        401: `Missing, invalid, expired, or revoked token`,
+        403: `Token does not carry the required scope`,
+        404: `Resource not found (or not visible to the calling org)`,
+      },
+    });
+  }
+  /**
+   * How many consumers depend on an API
+   * The blast-radius number: how many teams and services hold a grant on this API,
+   * and how many of those grants are approved. It answers "if I change this, does
+   * anyone else care?" — the question worth asking *before* editing a contract.
+   *
+   * **Counts, not a roster.** Who consumes what is org-governance information with
+   * its own screen, approval flow and permissions in the dashboard; restating a
+   * slice of it here would create a second, staler place to read it. A client that
+   * needs the detail should link a person to the dashboard, which this count is
+   * sized to prompt.
+   *
+   * `total` counts every grant regardless of status; `approved` counts only those in
+   * `APPROVED`. A pending grant is a real consumer waiting on a decision, so it is
+   * deliberately included in the total rather than hidden.
+   *
+   * Authorization stack:
+   * - scope: `read:apis`
+   * - ABAC v2: caller must be permitted to `view` the API resource (cross-org and
+   * cross-team isolation collapse to 404 to avoid leaking existence).
+   *
+   * @returns ApiConsumerCountV1 Consumer counts for this API
+   * @throws ApiError
+   */
+  public static getTeamApiConsumerCount({
+    apiId,
+  }: {
+    apiId: string,
+  }): CancelablePromise<ApiConsumerCountV1> {
+    return __request(OpenAPI, {
+      method: 'GET',
+      url: '/api/v1/public/apis/team/{apiId}/consumers',
+      path: {
+        'apiId': apiId,
+      },
+      errors: {
+        401: `Missing, invalid, expired, or revoked token`,
+        403: `Token does not carry the required scope`,
+        404: `Resource not found (or not visible to the calling org)`,
+      },
+    });
+  }
   /**
    * List published versions of a team-scoped private API
    * Mirrors `GET /api/v1/public/registry/{orgSlug}/{apiName}/versions` for the

package/src/generated/services/PublicMocksService.ts

@@ -5,6 +5,7 @@
 import type { CreateMockRequestV1 } from '../models/CreateMockRequestV1.js';
 import type { CreateMockResponseV1 } from '../models/CreateMockResponseV1.js';
 import type { MockItemV1 } from '../models/MockItemV1.js';
+import type { RefreshMockResponseV1 } from '../models/RefreshMockResponseV1.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 import { OpenAPI } from '../core/OpenAPI.js';
 import { request as __request } from '../core/request.js';
@@ -55,6 +56,44 @@ export class PublicMocksService {
       },
     });
   }
+  /**
+   * Re-provision a mock against its API's latest published spec
+   * A mock is bound to the spec snapshot it was created from, so publishing a new
+   * version of an API leaves its mock serving the previous contract. This rebuilds
+   * it against the API's current spec.
+   *
+   * The mock's **public id, URL and API key are unchanged** — those are what CI
+   * configs and clients already hold. Auto-generated variants are replaced with
+   * ones correct for the new spec; hand-written variants are carried over where
+   * their operation still exists, and the ones that couldn't be are listed in the
+   * response rather than silently dropped.
+   *
+   * Idempotent: refreshing a mock that already serves the current spec reports
+   * `refreshed: false` and changes nothing.
+   *
+   * Cross-org returns 404, not 403, so the existence of a mock is not leaked.
+   *
+   * @returns RefreshMockResponseV1 Refresh outcome
+   * @throws ApiError
+   */
+  public static refreshPublicMock({
+    mockServerId,
+  }: {
+    mockServerId: string,
+  }): CancelablePromise<RefreshMockResponseV1> {
+    return __request(OpenAPI, {
+      method: 'POST',
+      url: '/api/v1/public/mocks/{mockServerId}/refresh',
+      path: {
+        'mockServerId': mockServerId,
+      },
+      errors: {
+        401: `Missing, invalid, expired, or revoked token`,
+        403: `Token does not carry the required scope`,
+        404: `Resource not found (or not visible to the calling org)`,
+      },
+    });
+  }
   /**
    * Delete a mock server owned by the calling org
    * Hard-deletes the mock server and removes its association with the parent API.