@phpsandbox/sdk 0.2.3 → 0.3.0

package/README.md

@@ -372,30 +372,38 @@ MIT
 
 ### Publishing without Helfer
 
-Publishing is a platform capability. An API-key client can assign production settings with `notebook.secrets`, discover destinations and owned resources through `notebook.publication.catalog`, and submit its application choices through `prepareApplication`.
+Publishing is a platform capability. An API-key client can assign production settings with `notebook.secrets`, discover destinations and owned resources through `notebook.publication.catalog`, and submit its application choices through `prepare`.
 
 ```ts
 const notebook = await client.notebook.get('SANDBOX_ID');
-const review = await notebook.publication.prepareApplication({
-  schemaVersion: 1,
-  components: [{
-    id: 'web', kind: 'http-service', root: '.',
+const configuration = await notebook.publication.updateConfiguration({
+  expectedRevision: 0,
+  operations: [{ op: 'add-app', app: {
+    name: 'Backend', kind: 'http', root: '.',
     build: { mode: 'dockerfile', context: '.', dockerfile: { source: 'project', path: 'Dockerfile' } },
-    runtime: { kind: 'http', port: 3333, healthCheck: { path: '/' } },
-    placement: { provider: 'ssh-server', serverId: 'OWNED_SERVER_ID' },
-  }],
+    runtime: { mode: 'container', port: 3333, healthCheck: { path: '/' } },
+    destination: { provider: 'ssh-server', serverId: 'OWNED_SERVER_ID' },
+    routing: { mode: 'managed' }, resourceIds: [],
+  } }],
+});
+const review = await notebook.publication.prepare({
+  expectedRevision: configuration.revision, appIds: [configuration.apps[0].id],
 });
 if (!review.review.ready) {
   console.log(review.review.blockers);
 } else {
   // Present this exact review and obtain confirmation before executing.
-  const application = await notebook.publication.publishApplication({ reviewId: review.review.id });
+  const application = await notebook.publication.publish({ reviewId: review.review.id });
   const current = await notebook.publication.application(application.id);
-  console.log(current.status); // publishing, healthy, failed, or deleted
+  console.log(current.status); // publishing, healthy, partial, failed, or deleted
 }
 notebook.dispose();
 ```
 
-Core owns validation, source snapshots, review expiry, identity, resource ownership, execution and recovery. The confirmation reference binds the resolved review; another client does not copy source revisions or recreate provider logic. Repeated confirmation of an executed reference returns its existing application. A corrected review retains the publication and address. `retryApplication(id)` asks the platform to revalidate and retry failed components; inspect current state and logs when an outcome is uncertain. `destroyApplication(id)` unpublishes, and resource deletion requires the explicit `deleteResources` option.
+Core owns validation, source snapshots, review expiry, identity, resource ownership, execution and recovery. The confirmation reference binds the resolved review; another client does not copy source revisions or recreate provider logic. Repeated confirmation of an executed reference returns its existing application. A corrected review retains the publication and address. `retryApplication(id)` asks the platform to revalidate and retry failed apps; inspect current state and logs when an outcome is uncertain. `destroyApplication(id)` unpublishes, and resource deletion requires the explicit `deleteResources` option.
 
 Helfer presents choices, recommendations and explanations, and resumes its own conversation from platform outcomes. Its chat monitor does not own builds or publication state. The CLI exposes the same operations as `application plan`, `application publish`, `application status`, `application retry`, and `application delete`; JSON input is available for multi-component plans.
+
+`configuration()` is the authoritative saved App configuration and deployment inventory. Changes use explicit revision-checked operations; adding an app preserves omitted apps. Review and confirm use `prepare({ expectedRevision, appIds? })` and `publish({ reviewId })`. The provider-input publishing contract and `PublicationInstance.publish()` have been removed. Inspect per-app reviewed source and route state; a workspace digest includes uncommitted changes, while a native Git destination commits and pushes that workspace before building. The commit reported at review is the last synced commit, not a promise of the final prepared build commit.
+
+Shared managed-resource creation currently starts with one app. After creation, update the resource definition to `reuse` with its actual catalog inventory ID, then attach further apps. Simultaneous first-time shared-resource provisioning is not supported. Historical deployments require explicit adoption by their exact publication ID; new publishing always creates a saved App.

package/dist/browser/phpsandbox-sdk.esm.js

@@ -15146,17 +15146,6 @@ var PublicationInstance = class _PublicationInstance {
   follow() {
     return new PublicationRun(this, this.client).start();
   }
-  async publish() {
-    if (!this.notebookId) {
-      throw new PHPSandboxError("Publishing requires a notebook-scoped publication instance.");
-    }
-    const response = await this.client.post(
-      `/notebook/${encodeURIComponent(this.notebookId)}/publication`
-    );
-    const run = new PublicationRun(new _PublicationInstance(response.data, this.client, this.notebookId), this.client);
-    run.start();
-    return run;
-  }
   async destroy(options = {}) {
     const query = options.deleteResources ? "?deleteResources=1" : "";
     await this.client.delete(`/publications/${encodeURIComponent(this.data.id)}${query}`);
@@ -15283,24 +15272,28 @@ var NotebookPublication = class {
   async readiness() {
     return (await this.client.get(`${this.path}/publication/readiness`)).data;
   }
-  /** Review a publishing plan without committing changes or creating resources. */
+  /** Inspect saved configuration and the actual inventory, including removed and legacy apps. */
+  async configuration() {
+    return (await this.client.get(`${this.path}/publication/configuration`)).data;
+  }
+  /** Explicit operations preserve omitted apps. Removals never stop deployments or delete resource data. */
+  async updateConfiguration(input) {
+    return (await this.client.patch(`${this.path}/publication/configuration`, input)).data;
+  }
+  /** Review all or selected configured apps at an exact saved revision. */
   async prepare(input) {
     return (await this.client.post(`${this.path}/publication/plan`, input)).data;
   }
-  /** Review a multi-component publishing plan without creating resources or starting releases. */
-  async prepareApplication(input) {
-    return (await this.client.post(`${this.path}/publication/application-plan`, input)).data;
-  }
-  /** Publish every component in a reviewed application plan. */
-  async publishApplication(input) {
-    const application = (await this.client.post(`${this.path}/publication/application`, input)).data;
-    this.startApplicationRuns(application);
+  /** Publish the exact app selection in a server-owned review. */
+  async publish(input) {
+    const application = (await this.client.post(`${this.path}/publication`, input)).data;
+    if (!("confirmationRequired" in application)) this.startApplicationRuns(application);
     return application;
   }
   async application(applicationId) {
     return (await this.client.get(`${this.path}/publication/application/${encodeURIComponent(applicationId)}`)).data;
   }
-  /** Retry only failed components while leaving healthy components untouched. */
+  /** Retry failed apps and pending route attachments while preserving running releases. */
   async retryApplication(applicationId) {
     const application = (await this.client.post(
       `${this.path}/publication/application/${encodeURIComponent(applicationId)}/retry`,
@@ -15314,10 +15307,11 @@ var NotebookPublication = class {
     await this.client.delete(`${this.path}/publication/application/${encodeURIComponent(applicationId)}${query}`);
   }
   startApplicationRuns(application) {
-    for (const component of application.components) {
-      if (!["pending", "queued", "building", "deploying"].includes(component.publication.status)) continue;
+    for (const app of application.apps) {
+      if (!(application.selectedAppIds ?? []).includes(app.appId)) continue;
+      if (!["pending", "queued", "building", "deploying"].includes(app.publication.status)) continue;
       new PublicationRun(
-        new PublicationInstance(component.publication, this.client, this.notebookId),
+        new PublicationInstance(app.publication, this.client, this.notebookId),
         this.client
       ).start();
     }
@@ -15329,11 +15323,6 @@ var NotebookPublication = class {
     }
     return (await this.client.get(`${this.path}/publication/catalog?${query}`)).data;
   }
-  /** Core validates the plan, prepares source and executes publishing. */
-  async publish(input) {
-    const response = await this.client.post(`${this.path}/publication`, input);
-    return new PublicationRun(new PublicationInstance(response.data, this.client, this.notebookId), this.client).start();
-  }
 };
 
 // src/publication/providers/laravel-cloud.ts