@xemahq/webapp-studio-api-client 0.1.1 → 0.2.0

package/LICENSE

@@ -1 +1,36 @@
-Copyright (c) 2026 Xema. All rights reserved.
+Xema Proprietary License
+
+Copyright (c) 2026 Neuralchowder Inc.. All Rights Reserved.
+
+This software and its source code, object code, documentation, and all
+associated materials (the "Software") are the confidential and proprietary
+property of Neuralchowder Inc. ("Licensor") and are protected by copyright, trade secret,
+and other intellectual property laws.
+
+NO LICENSE IS GRANTED BY THIS FILE. No right or license to use, copy, modify,
+merge, publish, distribute, sublicense, sell, host, embed, or create
+derivative works of the Software is granted, whether by implication, estoppel,
+or otherwise, except under a separate written agreement signed by an
+authorized representative of Neuralchowder Inc..
+
+Unauthorized copying, use, distribution, or disclosure of the Software, in
+whole or in part, by any means, is strictly prohibited and may violate
+applicable law.
+
+Access to the Software, where provided, is granted solely under and subject to
+the terms of a separate written commercial, evaluation, or subscription
+agreement between you and Neuralchowder Inc.. In the event of any conflict between
+this file and such signed agreement, the signed agreement controls.
+
+Third-party software, libraries, packages, and assets included with or used by
+the Software remain subject to their own respective license terms.
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE SOFTWARE IS PROVIDED ON
+AN "AS IS" AND "AS AVAILABLE" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT.
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL
+Neuralchowder Inc. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+CONSEQUENTIAL, OR EXEMPLARY DAMAGES ARISING OUT OF OR RELATED TO THE SOFTWARE.
+
+For licensing inquiries, contact: licensing@neuralchowder.com

package/README.md

@@ -0,0 +1,62 @@
+<!-- Generated by @xemahq/api-client-generator. Do not edit by hand. -->
+<p align="center">
+<svg width="680" height="120" viewBox="0 0 680 120" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="@xemahq/webapp-studio-api-client">
+  <rect width="680" height="120" rx="14" fill="#0B1020"/>
+  <g transform="translate(28,34)">
+    <path d="M26 0 L52 15 L52 45 L26 60 L0 45 L0 15 Z" fill="#14B8A6" opacity="0.18"/>
+    <path d="M26 12 L41 21 L41 39 L26 48 L11 39 L11 21 Z" fill="#14B8A6"/>
+  </g>
+  <text x="92" y="52" font-family="ui-monospace,SFMono-Regular,Menlo,monospace" font-size="22" fill="#F8FAFC" font-weight="700">@xemahq/webapp-studio-api-client</text>
+  <text x="92" y="80" font-family="ui-sans-serif,system-ui,sans-serif" font-size="15" fill="#94A3B8">Typed, generated HTTP client for the Webapp Studio API.</text>
+  <text x="652" y="105" text-anchor="end" font-family="ui-sans-serif,system-ui,sans-serif" font-size="12" fill="#475569">xema.dev</text>
+</svg>
+</p>
+
+<p align="center">
+  <a href="https://xema.dev">Website</a> &middot;
+  <a href="https://www.npmjs.com/package/@xemahq/webapp-studio-api-client">npm</a>
+</p>
+
+<p align="center">
+  <img alt="npm" src="https://img.shields.io/npm/v/%40xemahq%2Fwebapp-studio-api-client?color=2563eb&label=npm">
+  <img alt="license" src="https://img.shields.io/npm/l/%40xemahq%2Fwebapp-studio-api-client?color=10b981">
+  <img alt="types" src="https://img.shields.io/npm/types/%40xemahq%2Fwebapp-studio-api-client?color=3178c6">
+</p>
+
+# @xemahq/webapp-studio-api-client
+
+> Typed, generated HTTP client for the Webapp Studio API.
+
+## Overview
+
+Auto-generated TypeScript client for the **Webapp Studio API**. It exports typed
+request functions and response models that mirror the service's OpenAPI surface,
+so callers get end-to-end type safety without hand-writing HTTP calls. This
+package is produced by `@xemahq/api-client-generator` and regenerated whenever
+the service's API changes — do not edit it by hand.
+
+## When to use it
+
+- Use it from any TypeScript service or app that calls the Webapp Studio API over HTTP.
+- You get compile-time types for every endpoint and payload; regenerate to pick
+  up API changes rather than editing the client.
+
+## Installation
+
+```bash
+pnpm add @xemahq/webapp-studio-api-client
+```
+
+## Usage
+
+```ts
+// Every endpoint function and response model is exported from the package root.
+import * as client from '@xemahq/webapp-studio-api-client';
+```
+
+Call the typed endpoint functions; request and response shapes are fully typed
+from the service's OpenAPI spec.
+
+## License
+
+Proprietary — &copy; Xema. All rights reserved. — [xema.dev](https://xema.dev)

package/dist/endpoints/app-databases/app-databases.d.ts

@@ -1,28 +1,28 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.15.0 🍺
  * Do not edit manually.
  * Webapp Studio API
  * Studio session CRUD + lifecycle + PR-from-working-branch handoff
- * OpenAPI spec version: 0.1.0
+ * OpenAPI spec version: 0.1.1
  */
-import type { AppDbsResponseDto, MigrateAppDbDto, MigrateAppDbResponseDto, PromoteToProdDto, PromoteToProdResponseDto } from '../../models';
+import type { AppDbsResponseDtoDataEnvelope, MigrateAppDbDto, MigrateAppDbResponseDtoDataEnvelope, PromoteToProdDto, PromoteToProdResponseDtoDataEnvelope } from '../../models';
+export declare const getAppDbsControllerListUrl: (studioId: string, appSlug: string) => string;
 /**
  * @summary List the dev (and, when promoted, prod) org-managed databases attached to one app slug of a webapp-studio session.
  */
-export declare const getAppDbsControllerListUrl: (studioId: string, appSlug: string) => string;
-export declare const appDbsControllerList: (studioId: string, appSlug: string, options?: RequestInit) => Promise<AppDbsResponseDto>;
+export declare const appDbsControllerList: (studioId: string, appSlug: string, options?: RequestInit) => Promise<AppDbsResponseDtoDataEnvelope>;
+export declare const getAppDbsControllerEnsureDevUrl: (studioId: string, appSlug: string) => string;
 /**
  * @summary Idempotently provision the dev database for this app and wait for it to become Active. Safe to call on first migration too.
  */
-export declare const getAppDbsControllerEnsureDevUrl: (studioId: string, appSlug: string) => string;
-export declare const appDbsControllerEnsureDev: (studioId: string, appSlug: string, options?: RequestInit) => Promise<AppDbsResponseDto>;
+export declare const appDbsControllerEnsureDev: (studioId: string, appSlug: string, options?: RequestInit) => Promise<AppDbsResponseDtoDataEnvelope>;
+export declare const getAppDbsControllerMigrateUrl: (studioId: string, appSlug: string) => string;
 /**
  * @summary Run the app’s Prisma migration package against its dev DB. Polls org-database-pool-api until the run is succeeded/failed.
  */
-export declare const getAppDbsControllerMigrateUrl: (studioId: string, appSlug: string) => string;
-export declare const appDbsControllerMigrate: (studioId: string, appSlug: string, migrateAppDbDto: MigrateAppDbDto, options?: RequestInit) => Promise<MigrateAppDbResponseDto>;
+export declare const appDbsControllerMigrate: (studioId: string, appSlug: string, migrateAppDbDto: MigrateAppDbDto, options?: RequestInit) => Promise<MigrateAppDbResponseDtoDataEnvelope>;
+export declare const getAppDbsControllerPromoteUrl: (studioId: string, appSlug: string) => string;
 /**
  * @summary Provision (or attach) the prod DB, run the app’s migrations against it, and return the synchronized (dev, prod) pair. `copyData=true` is currently a documented stub and returns 501 NotImplemented.
  */
-export declare const getAppDbsControllerPromoteUrl: (studioId: string, appSlug: string) => string;
-export declare const appDbsControllerPromote: (studioId: string, appSlug: string, promoteToProdDto: PromoteToProdDto, options?: RequestInit) => Promise<PromoteToProdResponseDto>;
+export declare const appDbsControllerPromote: (studioId: string, appSlug: string, promoteToProdDto: PromoteToProdDto, options?: RequestInit) => Promise<PromoteToProdResponseDtoDataEnvelope>;

package/dist/endpoints/app-databases/app-databases.js

@@ -2,13 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.appDbsControllerPromote = exports.getAppDbsControllerPromoteUrl = exports.appDbsControllerMigrate = exports.getAppDbsControllerMigrateUrl = exports.appDbsControllerEnsureDev = exports.getAppDbsControllerEnsureDevUrl = exports.appDbsControllerList = exports.getAppDbsControllerListUrl = void 0;
 const custom_fetch_1 = require("../../custom-fetch");
-/**
- * @summary List the dev (and, when promoted, prod) org-managed databases attached to one app slug of a webapp-studio session.
- */
 const getAppDbsControllerListUrl = (studioId, appSlug) => {
     return `/studio/${studioId}/apps/${appSlug}/dbs`;
 };
 exports.getAppDbsControllerListUrl = getAppDbsControllerListUrl;
+/**
+ * @summary List the dev (and, when promoted, prod) org-managed databases attached to one app slug of a webapp-studio session.
+ */
 const appDbsControllerList = async (studioId, appSlug, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getAppDbsControllerListUrl)(studioId, appSlug), {
         ...options,
@@ -16,13 +16,13 @@ const appDbsControllerList = async (studioId, appSlug, options) => {
     });
 };
 exports.appDbsControllerList = appDbsControllerList;
-/**
- * @summary Idempotently provision the dev database for this app and wait for it to become Active. Safe to call on first migration too.
- */
 const getAppDbsControllerEnsureDevUrl = (studioId, appSlug) => {
     return `/studio/${studioId}/apps/${appSlug}/dbs/ensure-dev`;
 };
 exports.getAppDbsControllerEnsureDevUrl = getAppDbsControllerEnsureDevUrl;
+/**
+ * @summary Idempotently provision the dev database for this app and wait for it to become Active. Safe to call on first migration too.
+ */
 const appDbsControllerEnsureDev = async (studioId, appSlug, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getAppDbsControllerEnsureDevUrl)(studioId, appSlug), {
         ...options,
@@ -30,13 +30,13 @@ const appDbsControllerEnsureDev = async (studioId, appSlug, options) => {
     });
 };
 exports.appDbsControllerEnsureDev = appDbsControllerEnsureDev;
-/**
- * @summary Run the app’s Prisma migration package against its dev DB. Polls org-database-pool-api until the run is succeeded/failed.
- */
 const getAppDbsControllerMigrateUrl = (studioId, appSlug) => {
     return `/studio/${studioId}/apps/${appSlug}/dbs/migrate`;
 };
 exports.getAppDbsControllerMigrateUrl = getAppDbsControllerMigrateUrl;
+/**
+ * @summary Run the app’s Prisma migration package against its dev DB. Polls org-database-pool-api until the run is succeeded/failed.
+ */
 const appDbsControllerMigrate = async (studioId, appSlug, migrateAppDbDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getAppDbsControllerMigrateUrl)(studioId, appSlug), {
         ...options,
@@ -46,13 +46,13 @@ const appDbsControllerMigrate = async (studioId, appSlug, migrateAppDbDto, optio
     });
 };
 exports.appDbsControllerMigrate = appDbsControllerMigrate;
-/**
- * @summary Provision (or attach) the prod DB, run the app’s migrations against it, and return the synchronized (dev, prod) pair. `copyData=true` is currently a documented stub and returns 501 NotImplemented.
- */
 const getAppDbsControllerPromoteUrl = (studioId, appSlug) => {
     return `/studio/${studioId}/apps/${appSlug}/dbs/promote-to-prod`;
 };
 exports.getAppDbsControllerPromoteUrl = getAppDbsControllerPromoteUrl;
+/**
+ * @summary Provision (or attach) the prod DB, run the app’s migrations against it, and return the synchronized (dev, prod) pair. `copyData=true` is currently a documented stub and returns 501 NotImplemented.
+ */
 const appDbsControllerPromote = async (studioId, appSlug, promoteToProdDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getAppDbsControllerPromoteUrl)(studioId, appSlug), {
         ...options,

package/dist/endpoints/studio/studio.d.ts

@@ -1,53 +1,68 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.15.0 🍺
  * Do not edit manually.
  * Webapp Studio API
  * Studio session CRUD + lifecycle + PR-from-working-branch handoff
- * OpenAPI spec version: 0.1.0
+ * OpenAPI spec version: 0.1.1
  */
-import type { CreateStudioDto, DetectFrameworksDto, DetectFrameworksResponseDto, OpenPrResponseDto, PatchStudioAppsDto, StudioControllerListParams, StudioResponseDto, UpdateStudioDto } from '../../models';
+import type { BuildStatusResponseDtoDataEnvelope, CreateStudioDto, DetectFrameworksDto, DetectFrameworksResponseDtoDataEnvelope, OpenPrResponseDtoDataEnvelope, PatchStudioAppsDto, PublishToXemaDto, PublishToXemaResponseDtoDataEnvelope, StartPublishResponseDtoDataEnvelope, StudioControllerListParams, StudioResponseDtoDataEnvelope, StudioResponseDtoPaginatedEnvelope, UpdateStudioDto } from '../../models';
+export declare const getStudioControllerDetectUrl: () => string;
 /**
  * @summary Probe a repo subfolder for a recognised webapp framework. Used by the create dialog to detect mismatches between the user-chosen `kind` and what already lives in the repo. Read-only and safe to call from a debounced input.
  */
-export declare const getStudioControllerDetectUrl: () => string;
-export declare const studioControllerDetect: (detectFrameworksDto: DetectFrameworksDto, options?: RequestInit) => Promise<DetectFrameworksResponseDto>;
+export declare const studioControllerDetect: (detectFrameworksDto: DetectFrameworksDto, options?: RequestInit) => Promise<DetectFrameworksResponseDtoDataEnvelope>;
+export declare const getStudioControllerCreateUrl: () => string;
 /**
  * @summary Create a webapp studio session + provision its interactive agent
  */
-export declare const getStudioControllerCreateUrl: () => string;
-export declare const studioControllerCreate: (createStudioDto: CreateStudioDto, options?: RequestInit) => Promise<StudioResponseDto>;
+export declare const studioControllerCreate: (createStudioDto: CreateStudioDto, options?: RequestInit) => Promise<StudioResponseDtoDataEnvelope>;
+export declare const getStudioControllerListUrl: (params?: StudioControllerListParams) => string;
 /**
  * @summary List studio sessions
  */
-export declare const getStudioControllerListUrl: (params?: StudioControllerListParams) => string;
-export declare const studioControllerList: (params?: StudioControllerListParams, options?: RequestInit) => Promise<StudioResponseDto[]>;
+export declare const studioControllerList: (params?: StudioControllerListParams, options?: RequestInit) => Promise<StudioResponseDtoPaginatedEnvelope>;
+export declare const getStudioControllerGetByIdUrl: (id: string) => string;
 /**
  * @summary Get a studio session by id
  */
-export declare const getStudioControllerGetByIdUrl: (id: string) => string;
-export declare const studioControllerGetById: (id: string, options?: RequestInit) => Promise<StudioResponseDto>;
+export declare const studioControllerGetById: (id: string, options?: RequestInit) => Promise<StudioResponseDtoDataEnvelope>;
+export declare const getStudioControllerUpdateUrl: (id: string) => string;
 /**
  * @summary Update studio metadata (title, description, agent override).
  */
-export declare const getStudioControllerUpdateUrl: (id: string) => string;
-export declare const studioControllerUpdate: (id: string, updateStudioDto: UpdateStudioDto, options?: RequestInit) => Promise<StudioResponseDto>;
+export declare const studioControllerUpdate: (id: string, updateStudioDto: UpdateStudioDto, options?: RequestInit) => Promise<StudioResponseDtoDataEnvelope>;
+export declare const getStudioControllerArchiveUrl: (id: string) => string;
 /**
  * @summary Archive a studio (terminates the interactive session). Does NOT delete the long-lived `xema/webapp/<projectId>` working branch on the SCM remote — other sessions may target the same branch. Idempotent.
  */
-export declare const getStudioControllerArchiveUrl: (id: string) => string;
-export declare const studioControllerArchive: (id: string, options?: RequestInit) => Promise<StudioResponseDto>;
+export declare const studioControllerArchive: (id: string, options?: RequestInit) => Promise<StudioResponseDtoDataEnvelope>;
+export declare const getStudioControllerPatchAppsUrl: (id: string) => string;
 /**
  * @summary Replace the studio app-target list. The supervisor picks up the new list on the next watcher rescan. Refuses on ARCHIVED studios.
  */
-export declare const getStudioControllerPatchAppsUrl: (id: string) => string;
-export declare const studioControllerPatchApps: (id: string, patchStudioAppsDto: PatchStudioAppsDto, options?: RequestInit) => Promise<StudioResponseDto>;
+export declare const studioControllerPatchApps: (id: string, patchStudioAppsDto: PatchStudioAppsDto, options?: RequestInit) => Promise<StudioResponseDtoDataEnvelope>;
+export declare const getStudioControllerRestartUrl: (id: string) => string;
 /**
  * @summary Provision a fresh interactive session for this studio. Reuses the studio identity, working branch, and app-target list. The previous session is terminated; its id is captured in `previousSessionIds` for audit.
  */
-export declare const getStudioControllerRestartUrl: (id: string) => string;
-export declare const studioControllerRestart: (id: string, options?: RequestInit) => Promise<StudioResponseDto>;
+export declare const studioControllerRestart: (id: string, options?: RequestInit) => Promise<StudioResponseDtoDataEnvelope>;
+export declare const getStudioControllerOpenPrUrl: (id: string) => string;
 /**
  * @summary Open (or refresh) a PR from the studio working branch against the repo default branch. Idempotent — calling when a PR is already open returns its URL without creating a duplicate.
  */
-export declare const getStudioControllerOpenPrUrl: (id: string) => string;
-export declare const studioControllerOpenPr: (id: string, options?: RequestInit) => Promise<OpenPrResponseDto>;
+export declare const studioControllerOpenPr: (id: string, options?: RequestInit) => Promise<OpenPrResponseDtoDataEnvelope>;
+export declare const getPublishToXemaControllerStartPublishUrl: (studioId: string, appSlug: string) => string;
+/**
+ * @summary STEP 1 — dispatch the server-side MF web-remote build for this studio app NON-BLOCKING and return a build-run id to poll. Ensures (later, at submit) a store listing for the manifest biome id. A real build is minutes; poll GET .../builds/:buildRunId, then POST .../submit.
+ */
+export declare const publishToXemaControllerStartPublish: (studioId: string, appSlug: string, publishToXemaDto: PublishToXemaDto, options?: RequestInit) => Promise<StartPublishResponseDtoDataEnvelope>;
+export declare const getPublishToXemaControllerGetBuildStatusUrl: (studioId: string, appSlug: string, buildRunId: string) => string;
+/**
+ * @summary STEP 2 — poll a dispatched build-run status: `building` (keep polling), `built` (call the submit endpoint), or `failed` (stop; see failureReason).
+ */
+export declare const publishToXemaControllerGetBuildStatus: (studioId: string, appSlug: string, buildRunId: string, options?: RequestInit) => Promise<BuildStatusResponseDtoDataEnvelope>;
+export declare const getPublishToXemaControllerSubmitBuildUrl: (studioId: string, appSlug: string, buildRunId: string) => string;
+/**
+ * @summary STEP 3 — finalize: once the build is `built`, read the server-produced web-artifact descriptor and submit the version to the Xema store. Re-supply the same { version, manifestSnapshot, notes?, listingId? } body from step 1. 409 while still building; 400 if the build failed.
+ */
+export declare const publishToXemaControllerSubmitBuild: (studioId: string, appSlug: string, buildRunId: string, publishToXemaDto: PublishToXemaDto, options?: RequestInit) => Promise<PublishToXemaResponseDtoDataEnvelope>;

package/dist/endpoints/studio/studio.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.studioControllerOpenPr = exports.getStudioControllerOpenPrUrl = exports.studioControllerRestart = exports.getStudioControllerRestartUrl = exports.studioControllerPatchApps = exports.getStudioControllerPatchAppsUrl = exports.studioControllerArchive = exports.getStudioControllerArchiveUrl = exports.studioControllerUpdate = exports.getStudioControllerUpdateUrl = exports.studioControllerGetById = exports.getStudioControllerGetByIdUrl = exports.studioControllerList = exports.getStudioControllerListUrl = exports.studioControllerCreate = exports.getStudioControllerCreateUrl = exports.studioControllerDetect = exports.getStudioControllerDetectUrl = void 0;
+exports.publishToXemaControllerSubmitBuild = exports.getPublishToXemaControllerSubmitBuildUrl = exports.publishToXemaControllerGetBuildStatus = exports.getPublishToXemaControllerGetBuildStatusUrl = exports.publishToXemaControllerStartPublish = exports.getPublishToXemaControllerStartPublishUrl = exports.studioControllerOpenPr = exports.getStudioControllerOpenPrUrl = exports.studioControllerRestart = exports.getStudioControllerRestartUrl = exports.studioControllerPatchApps = exports.getStudioControllerPatchAppsUrl = exports.studioControllerArchive = exports.getStudioControllerArchiveUrl = exports.studioControllerUpdate = exports.getStudioControllerUpdateUrl = exports.studioControllerGetById = exports.getStudioControllerGetByIdUrl = exports.studioControllerList = exports.getStudioControllerListUrl = exports.studioControllerCreate = exports.getStudioControllerCreateUrl = exports.studioControllerDetect = exports.getStudioControllerDetectUrl = void 0;
 const custom_fetch_1 = require("../../custom-fetch");
-/**
- * @summary Probe a repo subfolder for a recognised webapp framework. Used by the create dialog to detect mismatches between the user-chosen `kind` and what already lives in the repo. Read-only and safe to call from a debounced input.
- */
 const getStudioControllerDetectUrl = () => {
     return `/studio/detect`;
 };
 exports.getStudioControllerDetectUrl = getStudioControllerDetectUrl;
+/**
+ * @summary Probe a repo subfolder for a recognised webapp framework. Used by the create dialog to detect mismatches between the user-chosen `kind` and what already lives in the repo. Read-only and safe to call from a debounced input.
+ */
 const studioControllerDetect = async (detectFrameworksDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerDetectUrl)(), {
         ...options,
@@ -18,13 +18,13 @@ const studioControllerDetect = async (detectFrameworksDto, options) => {
     });
 };
 exports.studioControllerDetect = studioControllerDetect;
-/**
- * @summary Create a webapp studio session + provision its interactive agent
- */
 const getStudioControllerCreateUrl = () => {
     return `/studio`;
 };
 exports.getStudioControllerCreateUrl = getStudioControllerCreateUrl;
+/**
+ * @summary Create a webapp studio session + provision its interactive agent
+ */
 const studioControllerCreate = async (createStudioDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerCreateUrl)(), {
         ...options,
@@ -34,9 +34,6 @@ const studioControllerCreate = async (createStudioDto, options) => {
     });
 };
 exports.studioControllerCreate = studioControllerCreate;
-/**
- * @summary List studio sessions
- */
 const getStudioControllerListUrl = (params) => {
     const normalizedParams = new URLSearchParams();
     Object.entries(params || {}).forEach(([key, value]) => {
@@ -60,6 +57,9 @@ const getStudioControllerListUrl = (params) => {
     return stringifiedParams.length > 0 ? `/studio?${stringifiedParams}` : `/studio`;
 };
 exports.getStudioControllerListUrl = getStudioControllerListUrl;
+/**
+ * @summary List studio sessions
+ */
 const studioControllerList = async (params, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerListUrl)(params), {
         ...options,
@@ -67,13 +67,13 @@ const studioControllerList = async (params, options) => {
     });
 };
 exports.studioControllerList = studioControllerList;
-/**
- * @summary Get a studio session by id
- */
 const getStudioControllerGetByIdUrl = (id) => {
     return `/studio/${id}`;
 };
 exports.getStudioControllerGetByIdUrl = getStudioControllerGetByIdUrl;
+/**
+ * @summary Get a studio session by id
+ */
 const studioControllerGetById = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerGetByIdUrl)(id), {
         ...options,
@@ -81,13 +81,13 @@ const studioControllerGetById = async (id, options) => {
     });
 };
 exports.studioControllerGetById = studioControllerGetById;
-/**
- * @summary Update studio metadata (title, description, agent override).
- */
 const getStudioControllerUpdateUrl = (id) => {
     return `/studio/${id}`;
 };
 exports.getStudioControllerUpdateUrl = getStudioControllerUpdateUrl;
+/**
+ * @summary Update studio metadata (title, description, agent override).
+ */
 const studioControllerUpdate = async (id, updateStudioDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerUpdateUrl)(id), {
         ...options,
@@ -97,13 +97,13 @@ const studioControllerUpdate = async (id, updateStudioDto, options) => {
     });
 };
 exports.studioControllerUpdate = studioControllerUpdate;
-/**
- * @summary Archive a studio (terminates the interactive session). Does NOT delete the long-lived `xema/webapp/<projectId>` working branch on the SCM remote — other sessions may target the same branch. Idempotent.
- */
 const getStudioControllerArchiveUrl = (id) => {
     return `/studio/${id}`;
 };
 exports.getStudioControllerArchiveUrl = getStudioControllerArchiveUrl;
+/**
+ * @summary Archive a studio (terminates the interactive session). Does NOT delete the long-lived `xema/webapp/<projectId>` working branch on the SCM remote — other sessions may target the same branch. Idempotent.
+ */
 const studioControllerArchive = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerArchiveUrl)(id), {
         ...options,
@@ -111,13 +111,13 @@ const studioControllerArchive = async (id, options) => {
     });
 };
 exports.studioControllerArchive = studioControllerArchive;
-/**
- * @summary Replace the studio app-target list. The supervisor picks up the new list on the next watcher rescan. Refuses on ARCHIVED studios.
- */
 const getStudioControllerPatchAppsUrl = (id) => {
     return `/studio/${id}/apps`;
 };
 exports.getStudioControllerPatchAppsUrl = getStudioControllerPatchAppsUrl;
+/**
+ * @summary Replace the studio app-target list. The supervisor picks up the new list on the next watcher rescan. Refuses on ARCHIVED studios.
+ */
 const studioControllerPatchApps = async (id, patchStudioAppsDto, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerPatchAppsUrl)(id), {
         ...options,
@@ -127,13 +127,13 @@ const studioControllerPatchApps = async (id, patchStudioAppsDto, options) => {
     });
 };
 exports.studioControllerPatchApps = studioControllerPatchApps;
-/**
- * @summary Provision a fresh interactive session for this studio. Reuses the studio identity, working branch, and app-target list. The previous session is terminated; its id is captured in `previousSessionIds` for audit.
- */
 const getStudioControllerRestartUrl = (id) => {
     return `/studio/${id}/restart`;
 };
 exports.getStudioControllerRestartUrl = getStudioControllerRestartUrl;
+/**
+ * @summary Provision a fresh interactive session for this studio. Reuses the studio identity, working branch, and app-target list. The previous session is terminated; its id is captured in `previousSessionIds` for audit.
+ */
 const studioControllerRestart = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerRestartUrl)(id), {
         ...options,
@@ -141,13 +141,13 @@ const studioControllerRestart = async (id, options) => {
     });
 };
 exports.studioControllerRestart = studioControllerRestart;
-/**
- * @summary Open (or refresh) a PR from the studio working branch against the repo default branch. Idempotent — calling when a PR is already open returns its URL without creating a duplicate.
- */
 const getStudioControllerOpenPrUrl = (id) => {
     return `/studio/${id}/open-pr`;
 };
 exports.getStudioControllerOpenPrUrl = getStudioControllerOpenPrUrl;
+/**
+ * @summary Open (or refresh) a PR from the studio working branch against the repo default branch. Idempotent — calling when a PR is already open returns its URL without creating a duplicate.
+ */
 const studioControllerOpenPr = async (id, options) => {
     return (0, custom_fetch_1.customFetch)((0, exports.getStudioControllerOpenPrUrl)(id), {
         ...options,
@@ -155,3 +155,49 @@ const studioControllerOpenPr = async (id, options) => {
     });
 };
 exports.studioControllerOpenPr = studioControllerOpenPr;
+const getPublishToXemaControllerStartPublishUrl = (studioId, appSlug) => {
+    return `/studio/${studioId}/apps/${appSlug}/publish-to-xema`;
+};
+exports.getPublishToXemaControllerStartPublishUrl = getPublishToXemaControllerStartPublishUrl;
+/**
+ * @summary STEP 1 — dispatch the server-side MF web-remote build for this studio app NON-BLOCKING and return a build-run id to poll. Ensures (later, at submit) a store listing for the manifest biome id. A real build is minutes; poll GET .../builds/:buildRunId, then POST .../submit.
+ */
+const publishToXemaControllerStartPublish = async (studioId, appSlug, publishToXemaDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getPublishToXemaControllerStartPublishUrl)(studioId, appSlug), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(publishToXemaDto)
+    });
+};
+exports.publishToXemaControllerStartPublish = publishToXemaControllerStartPublish;
+const getPublishToXemaControllerGetBuildStatusUrl = (studioId, appSlug, buildRunId) => {
+    return `/studio/${studioId}/apps/${appSlug}/publish-to-xema/builds/${buildRunId}`;
+};
+exports.getPublishToXemaControllerGetBuildStatusUrl = getPublishToXemaControllerGetBuildStatusUrl;
+/**
+ * @summary STEP 2 — poll a dispatched build-run status: `building` (keep polling), `built` (call the submit endpoint), or `failed` (stop; see failureReason).
+ */
+const publishToXemaControllerGetBuildStatus = async (studioId, appSlug, buildRunId, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getPublishToXemaControllerGetBuildStatusUrl)(studioId, appSlug, buildRunId), {
+        ...options,
+        method: 'GET'
+    });
+};
+exports.publishToXemaControllerGetBuildStatus = publishToXemaControllerGetBuildStatus;
+const getPublishToXemaControllerSubmitBuildUrl = (studioId, appSlug, buildRunId) => {
+    return `/studio/${studioId}/apps/${appSlug}/publish-to-xema/builds/${buildRunId}/submit`;
+};
+exports.getPublishToXemaControllerSubmitBuildUrl = getPublishToXemaControllerSubmitBuildUrl;
+/**
+ * @summary STEP 3 — finalize: once the build is `built`, read the server-produced web-artifact descriptor and submit the version to the Xema store. Re-supply the same { version, manifestSnapshot, notes?, listingId? } body from step 1. 409 while still building; 400 if the build failed.
+ */
+const publishToXemaControllerSubmitBuild = async (studioId, appSlug, buildRunId, publishToXemaDto, options) => {
+    return (0, custom_fetch_1.customFetch)((0, exports.getPublishToXemaControllerSubmitBuildUrl)(studioId, appSlug, buildRunId), {
+        ...options,
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', ...options?.headers },
+        body: JSON.stringify(publishToXemaDto)
+    });
+};
+exports.publishToXemaControllerSubmitBuild = publishToXemaControllerSubmitBuild;

package/dist/index.d.ts

@@ -1,6 +1,4 @@
 export { configureClient, getClientConfig, ClientError, customFetch, type ClientConfig } from './custom-fetch';
 export * from './models';
 export * from './endpoints/app-databases/app-databases';
-export * from './endpoints/health/health';
-export * from './endpoints/internal/internal';
 export * from './endpoints/studio/studio';

package/dist/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.customFetch = exports.ClientError = exports.getClientConfig = exports.configureClient = void 0;
-// Auto-generated by scripts/build-client-index.js — do not edit manually.
+// Auto-generated by @xemahq/api-client-generator — do not edit manually.
 var custom_fetch_1 = require("./custom-fetch");
 Object.defineProperty(exports, "configureClient", { enumerable: true, get: function () { return custom_fetch_1.configureClient; } });
 Object.defineProperty(exports, "getClientConfig", { enumerable: true, get: function () { return custom_fetch_1.getClientConfig; } });
@@ -23,6 +23,4 @@ Object.defineProperty(exports, "ClientError", { enumerable: true, get: function
 Object.defineProperty(exports, "customFetch", { enumerable: true, get: function () { return custom_fetch_1.customFetch; } });
 __exportStar(require("./models"), exports);
 __exportStar(require("./endpoints/app-databases/app-databases"), exports);
-__exportStar(require("./endpoints/health/health"), exports);
-__exportStar(require("./endpoints/internal/internal"), exports);
 __exportStar(require("./endpoints/studio/studio"), exports);

package/dist/models/appDbResponseDto.d.ts

@@ -1,13 +1,13 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.15.0 🍺
  * Do not edit manually.
  * Webapp Studio API
  * Studio session CRUD + lifecycle + PR-from-working-branch handoff
- * OpenAPI spec version: 0.1.0
+ * OpenAPI spec version: 0.1.1
  */
-import type { MigrationRunnerKind } from './migrationRunnerKind';
-import type { OrgDatabasePurpose } from './orgDatabasePurpose';
-import type { OrgDatabaseStatus } from './orgDatabaseStatus';
+import type { MigrationRunnerKind } from './migrationRunnerKind.js';
+import type { OrgDatabasePurpose } from './orgDatabasePurpose.js';
+import type { OrgDatabaseStatus } from './orgDatabaseStatus.js';
 export interface AppDbResponseDto {
     /** org-database-pool-api database id (ULID). */
     id: string;

package/dist/models/appDbsResponseDto.d.ts

@@ -1,11 +1,11 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.15.0 🍺
  * Do not edit manually.
  * Webapp Studio API
  * Studio session CRUD + lifecycle + PR-from-working-branch handoff
- * OpenAPI spec version: 0.1.0
+ * OpenAPI spec version: 0.1.1
  */
-import type { AppDbResponseDto } from './appDbResponseDto';
+import type { AppDbResponseDto } from './appDbResponseDto.js';
 export interface AppDbsResponseDto {
     /** The app slug these databases belong to. */
     appSlug: string;

package/dist/models/appDbsResponseDtoDataEnvelope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.15.0 🍺
+ * Do not edit manually.
+ * Webapp Studio API
+ * Studio session CRUD + lifecycle + PR-from-working-branch handoff
+ * OpenAPI spec version: 0.1.1
+ */
+import type { AppDbsResponseDto } from './appDbsResponseDto.js';
+export interface AppDbsResponseDtoDataEnvelope {
+    data: AppDbsResponseDto;
+}

package/dist/models/appTargetDto.d.ts

@@ -1,11 +1,11 @@
 /**
- * Generated by orval v8.6.2 🍺
+ * Generated by orval v8.15.0 🍺
  * Do not edit manually.
  * Webapp Studio API
  * Studio session CRUD + lifecycle + PR-from-working-branch handoff
- * OpenAPI spec version: 0.1.0
+ * OpenAPI spec version: 0.1.1
  */
-import type { WebappKind } from './webappKind';
+import type { WebappKind } from './webappKind.js';
 export interface AppTargetDto {
     /**
        * Studio app slug — unique per studio, kebab-case. Becomes the `name` in `.xema/preview.yaml` and the tab label in the FE preview pane.

package/dist/models/biomeLifecycle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.15.0 🍺
+ * Do not edit manually.
+ * Webapp Studio API
+ * Studio session CRUD + lifecycle + PR-from-working-branch handoff
+ * OpenAPI spec version: 0.1.1
+ */
+/**
+ * Store-scoped lifecycle of the submitted version (typically `store-submitted` until a reviewer approves it).
+ */
+export type BiomeLifecycle = typeof BiomeLifecycle[keyof typeof BiomeLifecycle];
+export declare const BiomeLifecycle: {
+    readonly draft: "draft";
+    readonly 'sandbox-installed': "sandbox-installed";
+    readonly 'review-required': "review-required";
+    readonly 'org-installed': "org-installed";
+    readonly 'store-submitted': "store-submitted";
+    readonly 'store-approved': "store-approved";
+    readonly archived: "archived";
+};

package/dist/models/biomeLifecycle.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Generated by orval v8.15.0 🍺
+ * Do not edit manually.
+ * Webapp Studio API
+ * Studio session CRUD + lifecycle + PR-from-working-branch handoff
+ * OpenAPI spec version: 0.1.1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiomeLifecycle = void 0;
+exports.BiomeLifecycle = {
+    draft: 'draft',
+    'sandbox-installed': 'sandbox-installed',
+    'review-required': 'review-required',
+    'org-installed': 'org-installed',
+    'store-submitted': 'store-submitted',
+    'store-approved': 'store-approved',
+    archived: 'archived',
+};