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

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, 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, 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.
@@ -76,7 +76,7 @@ export declare const getPortalsControllerListUrl: (params?: PortalsControllerLis
 export declare const portalsControllerList: (params?: PortalsControllerListParams, options?: RequestInit) => Promise<AppDtoPaginatedEnvelope>;
 export declare const getPortalsControllerCreateUrl: () => string;
 /**
- * @summary Create an org-scoped portal (portal-admin only).
+ * @summary Create a portal. Omit `ownerSpaceUri` for an ORGANISATION portal (portal-admin only); pass your own `xema://users/<id>` for a PERSONAL portal, which any member may create and which nobody else can see until it is promoted.
  */
 export declare const portalsControllerCreate: (createPortalDto: CreatePortalDto, options?: RequestInit) => Promise<AppDtoDataEnvelope>;
 export declare const getPortalsControllerGetOneUrl: (id: string) => string;
@@ -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 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.
+ */
+export declare const portalsControllerRescope: (id: string, rescopePortalDto: RescopePortalDto, options?: RequestInit) => Promise<AppDtoDataEnvelope>;
 export declare const getPortalsControllerInstallBiomeUrl: (id: string) => string;
 /**
  * @summary Install one biome on a portal (portal-admin only). Idempotent per ref; serialized against concurrent installs by a per-portal lock. Returns 422 for a ref no web biome is registered for.

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.portalLaunchEntriesControllerList = exports.getPortalLaunchEntriesControllerListUrl = exports.portalsControllerRefreshLockfile = exports.getPortalsControllerRefreshLockfileUrl = exports.portalsControllerUninstallBiome = exports.getPortalsControllerUninstallBiomeUrl = exports.portalsControllerInstallBiome = exports.getPortalsControllerInstallBiomeUrl = 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 = void 0;
+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;
 const custom_fetch_1 = require("../../custom-fetch");
 const getProjectAppsControllerCreateUrl = () => {
     return `/bff/apps`;
@@ -252,7 +252,7 @@ const getPortalsControllerCreateUrl = () => {
 };
 exports.getPortalsControllerCreateUrl = getPortalsControllerCreateUrl;
 /**
- * @summary Create an org-scoped portal (portal-admin only).
+ * @summary Create a portal. Omit `ownerSpaceUri` for an ORGANISATION portal (portal-admin only); pass your own `xema://users/<id>` for a PERSONAL portal, which any member may create and which nobody else can see until it is promoted.
  */
 const portalsControllerCreate = async (createPortalDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getPortalsControllerCreateUrl)(), {
@@ -351,6 +351,22 @@ const portalsControllerReadopt = async (id, options) => {
     });
 };
 exports.portalsControllerReadopt = portalsControllerReadopt;
+const getPortalsControllerRescopeUrl = (id) => {
+    return `/bff/portals/${id}/rescope`;
+};
+exports.getPortalsControllerRescopeUrl = getPortalsControllerRescopeUrl;
+/**
+ * @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.
+ */
+const portalsControllerRescope = async (id, rescopePortalDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getPortalsControllerRescopeUrl)(id), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(rescopePortalDto)
+    });
+};
+exports.portalsControllerRescope = portalsControllerRescope;
 const getPortalsControllerInstallBiomeUrl = (id) => {
     return `/bff/portals/${id}/biomes`;
 };

package/dist/models/appDto.d.ts

@@ -15,6 +15,8 @@ export interface AppDto {
     orgId: string;
     /** @nullable */
     projectId: string | null;
+    /** Canonical `xema://…` Space URI of the owner. TOTAL — every portal states its owner, and an org-owned portal reads `xema://orgs/<orgId>` rather than an absence, so one fact has exactly one representation. A PERSONAL portal is `xema://users/<id>`; it is visible to its owner by ownership and to nobody else until promoted via `POST /bff/portals/:id/rescope`. Ask THIS field, never `projectId`: an org-owned portal and a personal one both carry `projectId === null`. */
+    ownerSpaceUri: string;
     /** Canonical XemaObjectRef computed from (orgId, projectId, App, slug). */
     ref: string;
     displayName: string;

package/dist/models/createPortalDto.d.ts

@@ -12,6 +12,8 @@ import type { PortalAccessDto } from './portalAccessDto.js';
 export interface CreatePortalDto {
     /** Stable slug unique within (orgId, projectId) for project apps, or (orgId) for portals. */
     slug: string;
+    /** Canonical `xema://…` Space URI of the owner, when it is anything other than the organisation. OMITTED means the organisation owns it — an answer, not a gap, and the state every existing portal is in. A personal portal is `xema://users/<id>`. Refused (422) if the address does not parse or names a tier the `portal` resource kind does not admit; never silently defaulted to the organisation, which would be the widest possible reading of a malformed request. */
+    ownerSpaceUri?: string;
     displayName: string;
     /** Default ExecutionEnvironment slug (e.g. `public-session`). */
     defaultZone: string;

package/dist/models/createProjectAppDto.d.ts

@@ -12,6 +12,8 @@ import type { SurfaceKind } from './surfaceKind.js';
 export interface CreateProjectAppDto {
     /** Stable slug unique within (orgId, projectId) for project apps, or (orgId) for portals. */
     slug: string;
+    /** Canonical `xema://…` Space URI of the owner, when it is anything other than the organisation. OMITTED means the organisation owns it — an answer, not a gap, and the state every existing portal is in. A personal portal is `xema://users/<id>`. Refused (422) if the address does not parse or names a tier the `portal` resource kind does not admit; never silently defaulted to the organisation, which would be the widest possible reading of a malformed request. */
+    ownerSpaceUri?: string;
     /**
        * Project id. Null or absent for org-scoped portals.
        * @nullable

package/dist/models/index.d.ts

@@ -93,6 +93,9 @@ export * from './releaseChannelRevisionSelectorDtoKind';
 export * from './requestMagicLinkDto';
 export * from './requestMagicLinkResultDto';
 export * from './requestMagicLinkResultDtoDataEnvelope';
+export * from './rescopePortalDto';
+export * from './rescopePortalTargetDto';
+export * from './rescopePortalTargetDtoTier';
 export * from './resolvedPortalLaunchDto';
 export * from './resolvedPortalLaunchDtoDataEnvelope';
 export * from './resourceManagedBy';

package/dist/models/index.js

@@ -110,6 +110,9 @@ __exportStar(require("./releaseChannelRevisionSelectorDtoKind"), exports);
 __exportStar(require("./requestMagicLinkDto"), exports);
 __exportStar(require("./requestMagicLinkResultDto"), exports);
 __exportStar(require("./requestMagicLinkResultDtoDataEnvelope"), exports);
+__exportStar(require("./rescopePortalDto"), exports);
+__exportStar(require("./rescopePortalTargetDto"), exports);
+__exportStar(require("./rescopePortalTargetDtoTier"), exports);
 __exportStar(require("./resolvedPortalLaunchDto"), exports);
 __exportStar(require("./resolvedPortalLaunchDtoDataEnvelope"), exports);
 __exportStar(require("./resourceManagedBy"), exports);

package/dist/models/rescopePortalDto.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+import type { RescopePortalTargetDto } from './rescopePortalTargetDto.js';
+export interface RescopePortalDto {
+    /** The Space to promote this portal into. Promotion only ever BROADENS the audience; a demotion or a same-tier move is refused with 422. */
+    toSpace: RescopePortalTargetDto;
+}

package/dist/models/rescopePortalDto.js

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

package/dist/models/rescopePortalTargetDto.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generated by @xemahq/api-client-generator — do not edit manually.
+ * App Runtime API
+ * OpenAPI spec version: 0.1.2
+ */
+import type { RescopePortalTargetDtoTier } from './rescopePortalTargetDtoTier.js';
+export interface RescopePortalTargetDto {
+    /** Owning tier to promote this portal INTO. Only `org` is accepted: promotion only ever broadens, and a portal has no project-owner tier because `projectId` already is its project axis. */
+    tier: RescopePortalTargetDtoTier;
+}

package/dist/models/rescopePortalTargetDto.js

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

package/dist/models/rescopePortalTargetDtoTier.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
+ */
+/**
+ * Owning tier to promote this portal INTO. Only `org` is accepted: promotion only ever broadens, and a portal has no project-owner tier because `projectId` already is its project axis.
+ */
+export type RescopePortalTargetDtoTier = typeof RescopePortalTargetDtoTier[keyof typeof RescopePortalTargetDtoTier];
+export declare const RescopePortalTargetDtoTier: {
+    readonly org: "org";
+};

package/dist/models/rescopePortalTargetDtoTier.js

@@ -0,0 +1,11 @@
+"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.RescopePortalTargetDtoTier = void 0;
+exports.RescopePortalTargetDtoTier = {
+    org: 'org',
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/app-platform-api-client",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -20,7 +20,7 @@
     "service": "app-platform-api",
     "biome": "app-platform",
     "target": "server",
-    "generator": "@xemahq/api-client-generator@0.15.0",
+    "generator": "@xemahq/api-client-generator@0.15.2",
     "source": "openapi.public.json"
   },
   "license": "LicenseRef-Xema-BSL-1.1",