@xemahq/app-platform-api-client 0.3.20 → 0.3.21

package/dist/endpoints/project-apps/project-apps.d.ts

@@ -3,7 +3,7 @@
  * App Runtime API
  * OpenAPI spec version: 0.1.2
  */
-import type { AppClientDtoDataArrayEnvelope, AppClientDtoDataEnvelope, AppDtoDataArrayEnvelope, AppDtoDataEnvelope, AppDtoPaginatedEnvelope, AppReleaseActionDto, AppReleaseDtoDataEnvelope, AppReleaseHistoryDtoDataArrayEnvelope, AudiencePolicyDtoDataArrayEnvelope, AudiencePolicyDtoDataEnvelope, CreateAppClientDto, CreateAudiencePolicyDto, CreatePortalDto, CreatePortalLaunchEntryDto, CreateProjectAppDto, CreatedAppClientDtoDataEnvelope, InstallPortalBiomeDto, PortalDetailDtoDataEnvelope, PortalLaunchEntriesControllerRemoveParams, PortalLaunchEntryDtoDataArrayEnvelope, PortalLaunchEntryDtoDataEnvelope, PortalsControllerListParams, ProjectAppsControllerListParams, RescopePortalDto, ResolvedPortalLaunchDtoDataEnvelope, UnarchivePortalDto, UpdateAudiencePolicyDto, UpdatePortalDto, UpdatePortalLaunchEntryDto } from '../../models';
+import type { AppClientDtoDataArrayEnvelope, AppClientDtoDataEnvelope, AppDtoDataArrayEnvelope, AppDtoDataEnvelope, AppDtoPaginatedEnvelope, AppReleaseActionDto, AppReleaseDtoDataEnvelope, AppReleaseHistoryDtoDataArrayEnvelope, AudiencePolicyDtoDataArrayEnvelope, AudiencePolicyDtoDataEnvelope, CreateAppClientDto, CreateAudiencePolicyDto, CreatePortalDto, CreatePortalLaunchEntryDto, CreateProjectAppDto, CreatedAppClientDtoDataEnvelope, InstallPortalBiomeDto, PortalDetailDtoDataEnvelope, PortalLaunchEntriesControllerRemoveParams, PortalLaunchEntryDtoDataArrayEnvelope, PortalLaunchEntryDtoDataEnvelope, PortalPromotionPreviewDtoDataEnvelope, PortalsControllerListParams, ProjectAppsControllerListParams, RescopePortalDto, ResolvedPortalLaunchDtoDataEnvelope, UnarchivePortalDto, UpdateAudiencePolicyDto, UpdatePortalDto, UpdatePortalLaunchEntryDto } from '../../models';
 export declare const getProjectAppsControllerCreateUrl: () => string;
 /**
  * @summary Create an App in the caller org + named project.
@@ -109,6 +109,11 @@ export declare const getPortalsControllerReadoptUrl: (id: string) => string;
  * @summary Hand a UI-adopted default portal back to the reconciler (portal-admin only), so it resumes tracking the installed web biomes.
  */
 export declare const portalsControllerReadopt: (id: string, options?: RequestInit) => Promise<AppDtoDataEnvelope>;
+export declare const getPortalsControllerPromotionPreviewUrl: (id: string) => string;
+/**
+ * @summary READ-ONLY: what WOULD happen if this portal were promoted to the organisation. Reports every reason it would be refused — ownership, org role, an illegal tier move, and the organisation's own growth gate — rather than only the first, and never performs the promotion. Same authority as seeing the portal; it reports no fact about the portal a viewer could not already read. An unreachable policy authority is reported as UNKNOWN, never as permitted.
+ */
+export declare const portalsControllerPromotionPreview: (id: string, options?: RequestInit) => Promise<PortalPromotionPreviewDtoDataEnvelope>;
 export declare const getPortalsControllerRescopeUrl: (id: string) => string;
 /**
  * @summary Promote a PERSONAL portal to organisation ownership — "share this with my organisation". Only the owner may release it (an org admin cannot publish somebody else's), and only `org` is a legal target. A demotion or a same-tier move is 422; a portal you may not see is 404.

package/dist/endpoints/project-apps/project-apps.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.portalsControllerRefreshLockfile = exports.getPortalsControllerRefreshLockfileUrl = exports.portalsControllerUninstallBiome = exports.getPortalsControllerUninstallBiomeUrl = exports.portalsControllerInstallBiome = exports.getPortalsControllerInstallBiomeUrl = exports.portalsControllerRescope = exports.getPortalsControllerRescopeUrl = exports.portalsControllerReadopt = exports.getPortalsControllerReadoptUrl = exports.portalsControllerUnarchive = exports.getPortalsControllerUnarchiveUrl = exports.portalsControllerArchive = exports.getPortalsControllerArchiveUrl = exports.portalsControllerRemove = exports.getPortalsControllerRemoveUrl = exports.portalsControllerUpdate = exports.getPortalsControllerUpdateUrl = exports.portalsControllerGetOne = exports.getPortalsControllerGetOneUrl = exports.portalsControllerCreate = exports.getPortalsControllerCreateUrl = exports.portalsControllerList = exports.getPortalsControllerListUrl = exports.projectAudiencePoliciesControllerDelete = exports.getProjectAudiencePoliciesControllerDeleteUrl = exports.projectAudiencePoliciesControllerUpdate = exports.getProjectAudiencePoliciesControllerUpdateUrl = exports.projectAudiencePoliciesControllerList = exports.getProjectAudiencePoliciesControllerListUrl = exports.projectAudiencePoliciesControllerCreate = exports.getProjectAudiencePoliciesControllerCreateUrl = exports.projectAppReleasesControllerRollback = exports.getProjectAppReleasesControllerRollbackUrl = exports.projectAppReleasesControllerListHistory = exports.getProjectAppReleasesControllerListHistoryUrl = exports.projectAppReleasesControllerGetLive = exports.getProjectAppReleasesControllerGetLiveUrl = exports.projectAppClientsControllerRevoke = exports.getProjectAppClientsControllerRevokeUrl = exports.projectAppClientsControllerList = exports.getProjectAppClientsControllerListUrl = exports.projectAppClientsControllerCreate = exports.getProjectAppClientsControllerCreateUrl = exports.projectAppsControllerGetById = exports.getProjectAppsControllerGetByIdUrl = exports.projectAppsControllerList = exports.getProjectAppsControllerListUrl = exports.projectAppsControllerCreate = exports.getProjectAppsControllerCreateUrl = void 0;
-exports.portalLaunchEntriesControllerResolve = exports.getPortalLaunchEntriesControllerResolveUrl = exports.portalLaunchEntriesControllerRemove = exports.getPortalLaunchEntriesControllerRemoveUrl = exports.portalLaunchEntriesControllerUpdate = exports.getPortalLaunchEntriesControllerUpdateUrl = exports.portalLaunchEntriesControllerCreate = exports.getPortalLaunchEntriesControllerCreateUrl = exports.portalLaunchEntriesControllerList = exports.getPortalLaunchEntriesControllerListUrl = void 0;
+exports.portalsControllerUninstallBiome = exports.getPortalsControllerUninstallBiomeUrl = exports.portalsControllerInstallBiome = exports.getPortalsControllerInstallBiomeUrl = exports.portalsControllerRescope = exports.getPortalsControllerRescopeUrl = exports.portalsControllerPromotionPreview = exports.getPortalsControllerPromotionPreviewUrl = exports.portalsControllerReadopt = exports.getPortalsControllerReadoptUrl = exports.portalsControllerUnarchive = exports.getPortalsControllerUnarchiveUrl = exports.portalsControllerArchive = exports.getPortalsControllerArchiveUrl = exports.portalsControllerRemove = exports.getPortalsControllerRemoveUrl = exports.portalsControllerUpdate = exports.getPortalsControllerUpdateUrl = exports.portalsControllerGetOne = exports.getPortalsControllerGetOneUrl = exports.portalsControllerCreate = exports.getPortalsControllerCreateUrl = exports.portalsControllerList = exports.getPortalsControllerListUrl = exports.projectAudiencePoliciesControllerDelete = exports.getProjectAudiencePoliciesControllerDeleteUrl = exports.projectAudiencePoliciesControllerUpdate = exports.getProjectAudiencePoliciesControllerUpdateUrl = exports.projectAudiencePoliciesControllerList = exports.getProjectAudiencePoliciesControllerListUrl = exports.projectAudiencePoliciesControllerCreate = exports.getProjectAudiencePoliciesControllerCreateUrl = exports.projectAppReleasesControllerRollback = exports.getProjectAppReleasesControllerRollbackUrl = exports.projectAppReleasesControllerListHistory = exports.getProjectAppReleasesControllerListHistoryUrl = exports.projectAppReleasesControllerGetLive = exports.getProjectAppReleasesControllerGetLiveUrl = exports.projectAppClientsControllerRevoke = exports.getProjectAppClientsControllerRevokeUrl = exports.projectAppClientsControllerList = exports.getProjectAppClientsControllerListUrl = exports.projectAppClientsControllerCreate = exports.getProjectAppClientsControllerCreateUrl = exports.projectAppsControllerGetById = exports.getProjectAppsControllerGetByIdUrl = exports.projectAppsControllerList = exports.getProjectAppsControllerListUrl = exports.projectAppsControllerCreate = exports.getProjectAppsControllerCreateUrl = void 0;
+exports.portalLaunchEntriesControllerResolve = exports.getPortalLaunchEntriesControllerResolveUrl = exports.portalLaunchEntriesControllerRemove = exports.getPortalLaunchEntriesControllerRemoveUrl = exports.portalLaunchEntriesControllerUpdate = exports.getPortalLaunchEntriesControllerUpdateUrl = exports.portalLaunchEntriesControllerCreate = exports.getPortalLaunchEntriesControllerCreateUrl = exports.portalLaunchEntriesControllerList = exports.getPortalLaunchEntriesControllerListUrl = exports.portalsControllerRefreshLockfile = exports.getPortalsControllerRefreshLockfileUrl = void 0;
 const custom_fetch_1 = require("../../custom-fetch");
 const getProjectAppsControllerCreateUrl = () => {
     return `/bff/apps`;
@@ -351,6 +351,20 @@ const portalsControllerReadopt = async (id, options) => {
     });
 };
 exports.portalsControllerReadopt = portalsControllerReadopt;
+const getPortalsControllerPromotionPreviewUrl = (id) => {
+    return `/bff/portals/${id}/promotion-preview`;
+};
+exports.getPortalsControllerPromotionPreviewUrl = getPortalsControllerPromotionPreviewUrl;
+/**
+ * @summary READ-ONLY: what WOULD happen if this portal were promoted to the organisation. Reports every reason it would be refused — ownership, org role, an illegal tier move, and the organisation's own growth gate — rather than only the first, and never performs the promotion. Same authority as seeing the portal; it reports no fact about the portal a viewer could not already read. An unreachable policy authority is reported as UNKNOWN, never as permitted.
+ */
+const portalsControllerPromotionPreview = async (id, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getPortalsControllerPromotionPreviewUrl)(id), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.portalsControllerPromotionPreview = portalsControllerPromotionPreview;
 const getPortalsControllerRescopeUrl = (id) => {
     return `/bff/portals/${id}/rescope`;
 };

package/dist/models/index.d.ts

@@ -85,6 +85,11 @@ export * from './portalLaunchEntryDto';
 export * from './portalLaunchEntryDtoDataArrayEnvelope';
 export * from './portalLaunchEntryDtoDataEnvelope';
 export * from './portalLaunchPresentationDto';
+export * from './portalPromotionGovernanceDto';
+export * from './portalPromotionPreviewDto';
+export * from './portalPromotionPreviewDtoDataEnvelope';
+export * from './portalPromotionRefusalDto';
+export * from './portalPromotionRefusalReason';
 export * from './portalShareDto';
 export * from './portalsControllerListParams';
 export * from './projectAppsControllerListParams';
@@ -101,6 +106,7 @@ export * from './resolvedPortalLaunchDtoDataEnvelope';
 export * from './resourceManagedBy';
 export * from './resourceVisibilityPattern';
 export * from './revisionTargetDto';
+export * from './spaceKind';
 export * from './subjectKind';
 export * from './surfaceKind';
 export * from './tokenClass';

package/dist/models/index.js

@@ -102,6 +102,11 @@ __exportStar(require("./portalLaunchEntryDto"), exports);
 __exportStar(require("./portalLaunchEntryDtoDataArrayEnvelope"), exports);
 __exportStar(require("./portalLaunchEntryDtoDataEnvelope"), exports);
 __exportStar(require("./portalLaunchPresentationDto"), exports);
+__exportStar(require("./portalPromotionGovernanceDto"), exports);
+__exportStar(require("./portalPromotionPreviewDto"), exports);
+__exportStar(require("./portalPromotionPreviewDtoDataEnvelope"), exports);
+__exportStar(require("./portalPromotionRefusalDto"), exports);
+__exportStar(require("./portalPromotionRefusalReason"), exports);
 __exportStar(require("./portalShareDto"), exports);
 __exportStar(require("./portalsControllerListParams"), exports);
 __exportStar(require("./projectAppsControllerListParams"), exports);
@@ -118,6 +123,7 @@ __exportStar(require("./resolvedPortalLaunchDtoDataEnvelope"), exports);
 __exportStar(require("./resourceManagedBy"), exports);
 __exportStar(require("./resourceVisibilityPattern"), exports);
 __exportStar(require("./revisionTargetDto"), exports);
+__exportStar(require("./spaceKind"), exports);
 __exportStar(require("./subjectKind"), exports);
 __exportStar(require("./surfaceKind"), exports);
 __exportStar(require("./tokenClass"), exports);

package/dist/models/portalPromotionGovernanceDto.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+export interface PortalPromotionGovernanceDto {
+    /** Whether the organisation growth policy could be READ. False means the authority was unreachable — distinct from a refusal, because a refusal is final and an outage is transient, and a UI must not present one as the other. */
+    known: boolean;
+    /** Whether the organisation's growth gate permits this promotion. Meaningless unless `known` is true; an unreachable authority is never reported as permitted. */
+    allowed: boolean;
+    /** @nullable */
+    detail: string | null;
+}

package/dist/models/portalPromotionGovernanceDto.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/portalPromotionPreviewDto.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+import type { PortalPromotionGovernanceDto } from './portalPromotionGovernanceDto.js';
+import type { PortalPromotionRefusalDto } from './portalPromotionRefusalDto.js';
+import type { SpaceKind } from './spaceKind.js';
+export interface PortalPromotionPreviewDto {
+    currentTier: SpaceKind;
+    /** The only legal promotion target for a portal today: `org`. */
+    target: SpaceKind;
+    /** True only when EVERY check passed and the growth gate was reachable. An unknown gate is not an allowance. */
+    allowed: boolean;
+    /** EVERY reason it would be refused, not just the first. The write path short-circuits, which is right for a write and wrong for a preview — fixing one blocker at a time is three round trips through a human. */
+    refusals: PortalPromotionRefusalDto[];
+    governance: PortalPromotionGovernanceDto;
+}

package/dist/models/portalPromotionPreviewDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/portalPromotionPreviewDtoDataEnvelope.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+import type { PortalPromotionPreviewDto } from './portalPromotionPreviewDto.js';
+export interface PortalPromotionPreviewDtoDataEnvelope {
+    data: PortalPromotionPreviewDto;
+}

package/dist/models/portalPromotionPreviewDtoDataEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/portalPromotionRefusalDto.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+import type { PortalPromotionRefusalReason } from './portalPromotionRefusalReason.js';
+export interface PortalPromotionRefusalDto {
+    /** Which check refused. A CLOSED set, so a renderer can map each to its own remedy instead of printing a message it did not expect. */
+    reason: PortalPromotionRefusalReason;
+    /** The refusing check's own message, verbatim. */
+    detail: string;
+}

package/dist/models/portalPromotionRefusalDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/portalPromotionRefusalReason.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+/**
+ * Which check refused. A CLOSED set, so a renderer can map each to its own remedy instead of printing a message it did not expect.
+ */
+export type PortalPromotionRefusalReason = typeof PortalPromotionRefusalReason[keyof typeof PortalPromotionRefusalReason];
+export declare const PortalPromotionRefusalReason: {
+    readonly 'target-unsupported': "target-unsupported";
+    readonly 'not-the-owner': "not-the-owner";
+    readonly 'org-role': "org-role";
+    readonly 'illegal-promotion': "illegal-promotion";
+    readonly 'org-growth-gate': "org-growth-gate";
+};

package/dist/models/portalPromotionRefusalReason.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PortalPromotionRefusalReason = void 0;
+exports.PortalPromotionRefusalReason = {
+    'target-unsupported': 'target-unsupported',
+    'not-the-owner': 'not-the-owner',
+    'org-role': 'org-role',
+    'illegal-promotion': 'illegal-promotion',
+    'org-growth-gate': 'org-growth-gate',
+};

package/dist/models/spaceKind.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+export type SpaceKind = typeof SpaceKind[keyof typeof SpaceKind];
+export declare const SpaceKind: {
+    readonly system: "system";
+    readonly org: "org";
+    readonly project: "project";
+    readonly app: "app";
+    readonly session: "session";
+    readonly biome: "biome";
+    readonly user: "user";
+};

package/dist/models/spaceKind.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpaceKind = void 0;
+exports.SpaceKind = {
+    system: 'system',
+    org: 'org',
+    project: 'project',
+    app: 'app',
+    session: 'session',
+    biome: 'biome',
+    user: 'user',
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/app-platform-api-client",
-  "version": "0.3.20",
+  "version": "0.3.21",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"