@xemahq/app-platform-internal-api-client 0.3.9 → 0.3.11

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

@@ -11,7 +11,7 @@ export declare const getAppsControllerCreateUrl: () => string;
 export declare const appsControllerCreate: (createAppDto: CreateAppDto, options?: RequestInit) => Promise<AppDtoDataEnvelope>;
 export declare const getAppsControllerListUrl: (params?: AppsControllerListParams) => string;
 /**
- * @summary List Apps (filtered by orgId, projectId, portalOnly, and/or slug).
+ * @summary List Apps (filtered by orgId, projectId, portalOnly, and/or slug). Archived Apps are excluded unless `includeArchived=true`.
  */
 export declare const appsControllerList: (params?: AppsControllerListParams, options?: RequestInit) => Promise<AppDtoDataArrayEnvelope>;
 export declare const getAppsControllerGetByIdUrl: (id: string) => string;

package/dist/endpoints/apps/apps.js

@@ -42,7 +42,7 @@ const getAppsControllerListUrl = (params) => {
 };
 exports.getAppsControllerListUrl = getAppsControllerListUrl;
 /**
- * @summary List Apps (filtered by orgId, projectId, portalOnly, and/or slug).
+ * @summary List Apps (filtered by orgId, projectId, portalOnly, and/or slug). Archived Apps are excluded unless `includeArchived=true`.
  */
 const appsControllerList = async (params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getAppsControllerListUrl)(params), {

package/dist/models/appDto.d.ts

@@ -4,6 +4,7 @@
  * OpenAPI spec version: 0.1.2
  */
 import type { AppLockfileDto } from './appLockfileDto.js';
+import type { AudienceKind } from './audienceKind.js';
 import type { BiomeInstallDto } from './biomeInstallDto.js';
 import type { BrandingConfigDto } from './brandingConfigDto.js';
 import type { CapabilityPolicyOverrideDto } from './capabilityPolicyOverrideDto.js';
@@ -22,13 +23,14 @@ export interface AppDto {
     lockfile: AppLockfileDto;
     installedBiomes: BiomeInstallDto[];
     capabilityPolicy: CapabilityPolicyOverrideDto[];
-    /** @nullable */
-    subdomain: string | null;
+    /** Whether this App is reachable on a public host. The host itself is DERIVED (see `codedAppSubdomain`), never tenant-chosen — this is the switch for WHETHER, not WHERE. */
     subdomainEnabled: boolean;
-    defaultAudience: string;
+    defaultAudience: AudienceKind;
     archived: boolean;
     /** Provisioning ownership marker. `iac` = managed by the declarative control plane (Terraform / xema.yaml); `seeder` = a distribution default; `ui` = hand-managed (or adopted from iac/seeder via a UI edit); `system` = platform-shipped; null = unmanaged/legacy. Lets a console badge an IaC-owned resource and surface an "export as code" affordance. */
     managedBy: ResourceManagedBy | null;
+    /** Whether this App can be handed back to the portal reconciler — the exact precondition of POST /bff/portals/:id/readopt (true iff the row carries the reconciler natural key). Read-only, server-derived. A `ui`-managed App with readoptable=false was hand-created and was never reconciler-owned; with readoptable=true it is an adopted default portal, and readopt restores automatic updates. */
+    readoptable: boolean;
     createdAt: string;
     updatedAt: string;
 }

package/dist/models/appsControllerListParams.d.ts

@@ -7,5 +7,12 @@ export type AppsControllerListParams = {
     orgId?: string;
     projectId?: string;
     slug?: string;
+    /**
+     * Restrict to ORG-scoped Apps (projectId IS NULL).
+     */
     portalOnly?: boolean;
+    /**
+     * Include archived Apps. Default false — an archived App is refused by public ingress and by every external-auth flow, so it is out of the listing unless explicitly asked for.
+     */
+    includeArchived?: boolean;
 };

package/dist/models/createAppDto.d.ts

@@ -4,6 +4,7 @@
  * OpenAPI spec version: 0.1.2
  */
 import type { AppLockfileDto } from './appLockfileDto.js';
+import type { AudienceKind } from './audienceKind.js';
 import type { BiomeInstallDto } from './biomeInstallDto.js';
 import type { BrandingConfigDto } from './brandingConfigDto.js';
 import type { CapabilityPolicyOverrideDto } from './capabilityPolicyOverrideDto.js';
@@ -24,10 +25,9 @@ export interface CreateAppDto {
     lockfile: AppLockfileDto;
     installedBiomes: BiomeInstallDto[];
     capabilityPolicy: CapabilityPolicyOverrideDto[];
-    /** @nullable */
-    subdomain?: string | null;
+    /** Whether this App is reachable on a public host. The host itself is DERIVED, never tenant-chosen — this is the switch for WHETHER, not WHERE. */
     subdomainEnabled?: boolean;
-    defaultAudience?: string;
+    defaultAudience?: AudienceKind;
     archived?: boolean;
     /** Authoring tier. `declared` (the default) and `composed` Apps ARE their JSON definition. A `coded` App is one the platform hosts but does not author — a Webapp Studio session builds a container image from the user's own repo, and every release of it carries that image coordinate. Immutable after creation: the tier decides what a release IS, so changing it would leave existing releases describing the wrong thing. */
     surface?: SurfaceKind;

package/dist/models/updateAppDto.d.ts

@@ -4,6 +4,7 @@
  * OpenAPI spec version: 0.1.2
  */
 import type { AppLockfileDto } from './appLockfileDto.js';
+import type { AudienceKind } from './audienceKind.js';
 import type { BiomeInstallDto } from './biomeInstallDto.js';
 import type { BrandingConfigDto } from './brandingConfigDto.js';
 import type { CapabilityPolicyOverrideDto } from './capabilityPolicyOverrideDto.js';
@@ -14,8 +15,7 @@ export interface UpdateAppDto {
     lockfile?: AppLockfileDto;
     installedBiomes?: BiomeInstallDto[];
     capabilityPolicy?: CapabilityPolicyOverrideDto[];
-    /** @nullable */
-    subdomain?: string | null;
+    /** Whether this App is reachable on a public host. The host itself is DERIVED, never tenant-chosen — this is the switch for WHETHER, not WHERE. */
     subdomainEnabled?: boolean;
-    defaultAudience?: string;
+    defaultAudience?: AudienceKind;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/app-platform-internal-api-client",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [