@phpsandbox/sdk 0.1.2 → 0.1.6

package/dist/publications.d.ts

@@ -1,4 +1,4 @@
-import { type Client, type SecretRef } from './index.js';
+import { type Client } from './index.js';
 import type { PublicationBuildStatus, PublicationDomainDnsRecordType, PublicationEventData, PublicationJurisdiction, PublicationLogChunkData, PublicationProtectionMode, PublicationRegion, PublicationReleaseStatus, PublicationSize, PublicationStatus, PublishStreamEvent, PublishStreamResult } from './schemas/publications.js';
 export * from './schemas/publications.js';
 export interface PublicationPlacement {
@@ -13,10 +13,6 @@ export interface PublicationProtectionData {
     expiresAt?: string;
     url?: string;
 }
-export interface PublicationFeedbackData {
-    enabled: boolean;
-    config: Record<string, unknown>;
-}
 export type PublicationProtectionInput = {
     mode: 'none';
     password?: never;
@@ -24,11 +20,8 @@ export type PublicationProtectionInput = {
     mode: 'password';
     password: string;
 };
-export interface PublicationFeedbackInput {
-    enabled: boolean;
-    config?: Record<string, unknown>;
-}
 export interface CloudflareContainersProviderOptions {
+    accountId: string;
     size?: PublicationSize;
     sleepAfter?: string;
     placement?: PublicationPlacement;
@@ -42,11 +35,9 @@ export interface LaravelCloudProviderData {
     repository?: string;
     branch?: string;
     sourceControlProviderType?: 'github' | 'gitlab' | 'bitbucket';
-    apiKeyConfigured?: boolean;
 }
 export interface LaravelCloudProviderInput {
-    apiKey: SecretRef;
-    region?: LaravelCloudRegion;
+    region: LaravelCloudRegion;
 }
 export interface PublicationProviderInputs {
     'cloudflare-containers': CloudflareContainersProviderOptions;
@@ -73,9 +64,9 @@ export interface PublishInput<TName extends PublicationProviderName = Publicatio
     slug: string;
     provider: PublicationProviderInput<TName>;
     protection?: PublicationProtectionInput;
-    feedback?: PublicationFeedbackInput;
     metadata?: Record<string, unknown>;
 }
+export type PublicationRunResult = PublishStreamResult;
 export interface PublicationBuildData<TProvider extends PublicationProviderName = PublicationProviderName> {
     id: string;
     status: PublicationBuildStatus;
@@ -124,7 +115,6 @@ export interface PublicationData<TProvider extends PublicationProviderName = Pub
     strategy: string;
     provider: PublicationProvider<TProvider>;
     protection: PublicationProtectionData;
-    feedback: PublicationFeedbackData;
     eventStreamUrl: string | null;
     originUrl: string | null;
     currentRelease?: PublicationReleaseData | null;
@@ -144,10 +134,6 @@ export interface PublicationProtectionSessionData {
     expiresAt: string;
     url: string;
 }
-export interface UpdatePublicationFeedbackInput {
-    enabled: boolean;
-    config?: Record<string, unknown>;
-}
 export declare class NotebookPublicationApi {
     private readonly client;
     constructor(client: Client);
@@ -163,7 +149,6 @@ export declare class PublicationApi {
     protection(id: string): Promise<PublicationProtectionData>;
     createProtectionSession(id: string): Promise<PublicationProtectionSessionData>;
     disableProtection<TProvider extends PublicationProviderName = PublicationProviderName>(id: string): Promise<PublicationInstance<TProvider>>;
-    setFeedback<TProvider extends PublicationProviderName = PublicationProviderName>(id: string, input: UpdatePublicationFeedbackInput): Promise<PublicationInstance<TProvider>>;
     listDomains(id: string): Promise<PublicationDomainData[]>;
     createDomain(id: string, input: CreatePublicationDomainInput): Promise<PublicationDomainData>;
     refreshDomain(id: string, domainId: string): Promise<PublicationDomainData>;
@@ -186,7 +171,7 @@ export declare class PublicationRun<TProvider extends PublicationProviderName =
     private readonly subscribers;
     constructor(initial: PublicationInstance<TProvider>, client: Client);
     events(): AsyncIterable<PublishStreamEvent>;
-    result(): Promise<PublishStreamResult>;
+    result(): Promise<PublicationRunResult>;
     publication(): Promise<PublicationInstance<TProvider>>;
     start(): this;
     private subscribe;
@@ -214,7 +199,6 @@ export declare class PublicationInstance<TProvider extends PublicationProviderNa
     protection(): Promise<PublicationProtectionData>;
     createProtectionSession(): Promise<PublicationProtectionSessionData>;
     disableProtection(): Promise<PublicationInstance<TProvider>>;
-    setFeedback(input: UpdatePublicationFeedbackInput): Promise<PublicationInstance<TProvider>>;
     domains(): Promise<PublicationDomainData[]>;
     addDomain(input: CreatePublicationDomainInput): Promise<PublicationDomainData>;
     refreshDomain(domainId: string): Promise<PublicationDomainData>;

package/dist/publications.js

@@ -51,10 +51,6 @@ export class PublicationApi {
         const response = await this.client.delete(`/publications/${id}/protection`);
         return new PublicationInstance(response.data, this.client);
     }
-    async setFeedback(id, input) {
-        const response = await this.client.put(`/publications/${id}/feedback`, input);
-        return new PublicationInstance(response.data, this.client);
-    }
     async listDomains(id) {
         const response = await this.client.get(`/publications/${id}/domains`);
         return unwrapPublicationDomainCollection(response.data);
@@ -156,7 +152,7 @@ export class PublicationRun {
                 if (event.type === 'result') {
                     const { type: _, ...result } = event;
                     this.finalResult = result;
-                    this.resolveResult?.(result);
+                    this.resolveResult?.(this.finalResult);
                 }
             }
             if (!this.finalResult) {
@@ -248,9 +244,6 @@ export class PublicationInstance {
     disableProtection() {
         return this.client.publications.disableProtection(this.data.id);
     }
-    setFeedback(input) {
-        return this.client.publications.setFeedback(this.data.id, input);
-    }
     domains() {
         return this.client.publications.listDomains(this.data.id);
     }

package/dist/runtime/rest.js

@@ -15,18 +15,13 @@ const restActionRoutes = {
     'container.stats': { method: 'GET', path: '/runtime/container/stats' },
     'terminal.list': { method: 'GET', path: '/runtime/terminals' },
     'shell.exec': { method: 'POST', path: '/runtime/executions' },
-    'fs.info': { method: 'POST', path: '/runtime/files/info' },
     'fs.readFile': { method: 'GET', path: '/runtime/files/content' },
     'fs.writeFile': { method: 'PUT', path: '/runtime/files/content' },
-    'fs.write': { method: 'PUT', path: '/runtime/files/text' },
-    'fs.mkdir': { method: 'POST', path: '/runtime/directories' },
     'fs.createDirectory': { method: 'PUT', path: '/runtime/directories' },
     'fs.readDirectory': { method: 'POST', path: '/runtime/directories/read' },
     'fs.stat': { method: 'POST', path: '/runtime/files/stat' },
-    'fs.move': { method: 'POST', path: '/runtime/files/move' },
     'fs.rename': { method: 'POST', path: '/runtime/files/rename' },
     'fs.copy': { method: 'POST', path: '/runtime/files/copy' },
-    'fs.remove': { method: 'POST', path: '/runtime/files/remove' },
     'fs.delete': { method: 'DELETE', path: '/runtime/files' },
     'fs.tail': { method: 'POST', path: '/runtime/files/tail' },
     'fs.find': { method: 'POST', path: '/runtime/files/find' },

package/dist/sandbox-integrations.d.ts

@@ -0,0 +1,44 @@
+import type { Client } from './index.js';
+import { Integration, type IntegrationData, type IntegrationReference } from './integrations.js';
+export type SandboxIntegrationEffect = 'network';
+export interface AttachSandboxIntegrationInput {
+    integration: IntegrationReference;
+    effects?: SandboxIntegrationEffect[];
+}
+export type UpdateSandboxIntegrationInput = {
+    integration: IntegrationReference;
+    effects?: SandboxIntegrationEffect[];
+} | {
+    integration?: IntegrationReference;
+    effects: SandboxIntegrationEffect[];
+};
+export interface SandboxIntegrationData {
+    id: string;
+    integration: IntegrationData;
+    effects: SandboxIntegrationEffect[];
+}
+export type SandboxIntegrationReference = string | SandboxIntegration;
+export declare class SandboxIntegrationApi {
+    private readonly notebookId;
+    private readonly client;
+    constructor(notebookId: string, client: Client);
+    attach(input: AttachSandboxIntegrationInput): Promise<SandboxIntegration>;
+    list(): Promise<SandboxIntegration[]>;
+    get(integration: SandboxIntegrationReference): Promise<SandboxIntegration>;
+    update(integration: SandboxIntegrationReference, input: UpdateSandboxIntegrationInput): Promise<SandboxIntegration>;
+    detach(integration: SandboxIntegrationReference): Promise<void>;
+    private path;
+    private bindingPath;
+}
+export declare class SandboxIntegration {
+    readonly data: SandboxIntegrationData;
+    private readonly notebookId;
+    private readonly client;
+    constructor(data: SandboxIntegrationData, notebookId: string, client: Client);
+    get id(): string;
+    get integration(): Integration;
+    get effects(): SandboxIntegrationEffect[];
+    update(input: UpdateSandboxIntegrationInput): Promise<SandboxIntegration>;
+    detach(): Promise<void>;
+}
+export declare function sandboxIntegrationId(integration: SandboxIntegrationReference): string;

package/dist/sandbox-integrations.js

@@ -0,0 +1,63 @@
+import { Integration, integrationId, } from './integrations.js';
+export class SandboxIntegrationApi {
+    constructor(notebookId, client) {
+        this.notebookId = notebookId;
+        this.client = client;
+    }
+    async attach(input) {
+        const response = await this.client.post(this.path(), {
+            ...input,
+            integration: integrationId(input.integration),
+        });
+        return new SandboxIntegration(response.data, this.notebookId, this.client);
+    }
+    async list() {
+        const response = await this.client.get(this.path());
+        return response.data.map((integration) => new SandboxIntegration(integration, this.notebookId, this.client));
+    }
+    async get(integration) {
+        const response = await this.client.get(this.bindingPath(integration));
+        return new SandboxIntegration(response.data, this.notebookId, this.client);
+    }
+    async update(integration, input) {
+        const response = await this.client.patch(this.bindingPath(integration), {
+            ...input,
+            integration: input.integration === undefined ? undefined : integrationId(input.integration),
+        });
+        return new SandboxIntegration(response.data, this.notebookId, this.client);
+    }
+    async detach(integration) {
+        await this.client.delete(this.bindingPath(integration));
+    }
+    path() {
+        return `/notebook/${this.notebookId}/integrations`;
+    }
+    bindingPath(integration) {
+        return `${this.path()}/${encodeURIComponent(sandboxIntegrationId(integration))}`;
+    }
+}
+export class SandboxIntegration {
+    constructor(data, notebookId, client) {
+        this.data = data;
+        this.notebookId = notebookId;
+        this.client = client;
+    }
+    get id() {
+        return this.data.id;
+    }
+    get integration() {
+        return new Integration(this.data.integration, this.client);
+    }
+    get effects() {
+        return this.data.effects;
+    }
+    update(input) {
+        return new SandboxIntegrationApi(this.notebookId, this.client).update(this, input);
+    }
+    detach() {
+        return new SandboxIntegrationApi(this.notebookId, this.client).detach(this);
+    }
+}
+export function sandboxIntegrationId(integration) {
+    return typeof integration === 'string' ? integration : integration.id;
+}

package/dist/schemas/publications.d.ts

@@ -76,7 +76,7 @@ export declare const PublicationEventDataSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
     sequence: z.ZodNumber;
     type: z.ZodString;
-    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    payload: z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     createdAt: z.ZodNullable<z.ZodString>;
 }, z.core.$loose>;
 export declare const PublicationLogChunkDataSchema: z.ZodObject<{
@@ -108,6 +108,7 @@ export declare const PublishStreamLogSchema: z.ZodObject<{
 export declare const PublishStreamResultSchema: z.ZodObject<{
     success: z.ZodBoolean;
     publicationId: z.ZodString;
+    url: z.ZodString;
     buildId: z.ZodString;
     releaseId: z.ZodString;
     status: z.ZodEnum<{
@@ -145,6 +146,7 @@ export declare const PublishStreamLogEventSchema: z.ZodObject<{
 export declare const PublishStreamResultEventSchema: z.ZodObject<{
     success: z.ZodBoolean;
     publicationId: z.ZodString;
+    url: z.ZodString;
     buildId: z.ZodString;
     releaseId: z.ZodString;
     status: z.ZodEnum<{
@@ -181,6 +183,7 @@ export declare const PublishStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObj
 }, z.core.$strict>, z.ZodObject<{
     success: z.ZodBoolean;
     publicationId: z.ZodString;
+    url: z.ZodString;
     buildId: z.ZodString;
     releaseId: z.ZodString;
     status: z.ZodEnum<{
@@ -235,6 +238,7 @@ export declare const PublishStreamSseDoneEventSchema: z.ZodObject<{
     data: z.ZodObject<{
         success: z.ZodBoolean;
         publicationId: z.ZodString;
+        url: z.ZodString;
         buildId: z.ZodString;
         releaseId: z.ZodString;
         status: z.ZodEnum<{
@@ -256,6 +260,7 @@ export declare const PublishStreamSseResultEventSchema: z.ZodObject<{
     data: z.ZodObject<{
         success: z.ZodBoolean;
         publicationId: z.ZodString;
+        url: z.ZodString;
         buildId: z.ZodString;
         releaseId: z.ZodString;
         status: z.ZodEnum<{
@@ -304,6 +309,7 @@ export declare const PublishStreamSseEventSchema: z.ZodPipe<z.ZodDiscriminatedUn
     data: z.ZodObject<{
         success: z.ZodBoolean;
         publicationId: z.ZodString;
+        url: z.ZodString;
         buildId: z.ZodString;
         releaseId: z.ZodString;
         status: z.ZodEnum<{
@@ -324,6 +330,7 @@ export declare const PublishStreamSseEventSchema: z.ZodPipe<z.ZodDiscriminatedUn
     data: z.ZodObject<{
         success: z.ZodBoolean;
         publicationId: z.ZodString;
+        url: z.ZodString;
         buildId: z.ZodString;
         releaseId: z.ZodString;
         status: z.ZodEnum<{
@@ -356,6 +363,7 @@ export declare const PublishStreamSseEventSchema: z.ZodPipe<z.ZodDiscriminatedUn
 } | {
     success: boolean;
     publicationId: string;
+    url: string;
     buildId: string;
     releaseId: string;
     status: "stopped" | "deleted" | "pending" | "queued" | "building" | "deploying" | "healthy" | "failed" | "deleting" | "delete_failed";
@@ -378,6 +386,7 @@ export declare const PublishStreamSseEventSchema: z.ZodPipe<z.ZodDiscriminatedUn
     data: {
         success: boolean;
         publicationId: string;
+        url: string;
         buildId: string;
         releaseId: string;
         status: "stopped" | "deleted" | "pending" | "queued" | "building" | "deploying" | "healthy" | "failed" | "deleting" | "delete_failed";
@@ -387,6 +396,7 @@ export declare const PublishStreamSseEventSchema: z.ZodPipe<z.ZodDiscriminatedUn
     data: {
         success: boolean;
         publicationId: string;
+        url: string;
         buildId: string;
         releaseId: string;
         status: "stopped" | "deleted" | "pending" | "queued" | "building" | "deploying" | "healthy" | "failed" | "deleting" | "delete_failed";

package/dist/schemas/publications.js

@@ -51,11 +51,12 @@ export const PublicationDomainDnsRecordTypeSchema = z.enum(['CNAME', 'ALIAS', 'A
 export const PublicationProtectionModeSchema = z.enum(['none', 'password']);
 export const PublicationLogStreamSchema = z.enum(['build', 'runtime']);
 export const PublishStreamLogStreamSchema = z.enum(['build', 'publish', 'runtime']);
+const PublicationEventPayloadSchema = z.preprocess((payload) => Array.isArray(payload) && payload.length === 0 ? {} : payload, z.record(z.string(), z.unknown()));
 export const PublicationEventDataSchema = z.object({
     id: z.union([z.number(), z.string()]).optional(),
     sequence: z.number(),
     type: z.string(),
-    payload: z.record(z.string(), z.unknown()),
+    payload: PublicationEventPayloadSchema,
     createdAt: z.string().nullable(),
 }).passthrough();
 export const PublicationLogChunkDataSchema = z.object({
@@ -76,6 +77,7 @@ export const PublishStreamLogSchema = z.object({
 export const PublishStreamResultSchema = z.object({
     success: z.boolean(),
     publicationId: z.string(),
+    url: z.string().url(),
     buildId: z.string(),
     releaseId: z.string(),
     status: PublicationStatusSchema,

package/dist/terminal.d.ts

@@ -17,12 +17,6 @@ export interface TerminalCreateInput {
     env?: Record<string, string | number | boolean>;
     cwd?: string;
 }
-export interface TerminalSpawnInput {
-    command: string | string[];
-    opts: {
-        id: string;
-    } & SpawnOptions;
-}
 export interface TerminalEventData {
     'terminal.output': {
         output: string;
@@ -50,7 +44,6 @@ export interface TerminalActions {
     }>;
     'terminal.list': Action<{}, Task[]>;
     'terminal.create': Action<TerminalCreateInput, Task>;
-    'terminal.spawn': Action<TerminalSpawnInput, Task>;
     'terminal.attach': Action<{
         id: string;
         replayHistory?: boolean;

package/docs/api-summary.md

@@ -91,7 +91,8 @@ Connection lifecycle methods, streaming actions, and event subscriptions require
 ### Git (`notebook.git`)
 
 - `checkpoint(author, message, branch = 'main')`
-- `sync({ provider, repository, author, branch?, credential, direction?, visibility?, setDefault? })`
+- `targets.create({ provider, repository, author, branch?, setDefault? })`
+- `targets.list()`, `targets.get(target)`, and `target.sync({ direction?, author? })`
 - `diff({ url?, token?, ref?, base?, target? })`
 - `merge({ url?, token?, ref?, target?, expectedBaseRef?, author?, message? })`
 - `conflicts()`
@@ -104,6 +105,16 @@ Connection lifecycle methods, streaming actions, and event subscriptions require
 - `log(ref = 'main')`
 - `restore(ref)`
 
+### Sandbox integrations (`notebook.integrations`)
+
+- `attach({ integration, effects? })`
+- A sandbox has one attached integration per provider. `binding.update({ integration })` replaces that provider selection.
+- Provider-backed operations resolve the attached integration when they run; persistent sandbox behavior remains controlled by explicit effects.
+- `list()`
+- `get(binding)`
+- Binding resources expose `update({ effects })` and `detach()`
+- The currently supported sandbox effect is GitHub `network`; effects are explicit and provider-specific.
+
 ### Mail (`notebook.mail`)
 
 - `status()` returning non-sensitive mail configuration state
@@ -113,6 +124,16 @@ Connection lifecycle methods, streaming actions, and event subscriptions require
 - `get(hash)`
 - `delete(hash)`
 
+### Feedback (`sandbox.feedback`)
+
+- `configure({ widget })`, where `widget` is `null` or contains `targets`, optional `label`, and optional `types`
+- `submit({ type, message, author?, context?, metadata? })`
+- `list({ type?, status?, source?, page? })`
+- `get(id)`
+- `update(id, { status })`
+
+Feedback ingestion is always available through the authenticated API. Configuration controls only the optional widget and can target `preview`, `publication`, or both.
+
 ### LSP (`notebook.lsp`)
 
 - Messaging: `start(id)`, `close(id)`, `message(id, payload)`
@@ -130,11 +151,20 @@ Connection lifecycle methods, streaming actions, and event subscriptions require
 
 ## Publications
 
-- `notebook.publish({ slug, provider, protection?, feedback?, metadata? })`
+- `notebook.publish({ slug, provider, protection?, metadata? })`
 - `notebook.publication()` returns the current publication or `null`
 - `client.publications.get(id)`, `destroy(id)`, `events(id)`, `logs(id)`, and `buildLogs(id, buildId)`
-- A publish run exposes `events()` as an `AsyncIterable`, `result()`, and `publication()`.
+- A publish run exposes `events()` as an `AsyncIterable`, `result()` with the final status and URL, and `publication()` when refreshed deployment state is needed.
 - Built-in provider names are `cloudflare-containers`, `ssh-server`, and `laravel-cloud`. Provider maps support TypeScript declaration merging.
+- Cloudflare Containers input uses `{ name: 'cloudflare-containers', accountId, size?, sleepAfter?, placement?, instances? }` and resolves the sandbox's attached Cloudflare integration when each operation runs.
+- Laravel Cloud input uses `{ name: 'laravel-cloud', region }` and resolves the sandbox's attached Laravel Cloud integration when each operation runs.
+
+## Account integrations
+
+- `client.integrations.link({ provider, label?, authorization })`
+- `client.integrations.list()`, `get(integration)`, `update(integration, input)`, and `unlink(integration)`
+- Resource instances expose `update(input)` and `unlink()`.
+- Built-in providers are `cloudflare`, `github`, and `laravel-cloud`; current public authorization uses opaque caller-managed tokens.
 
 ## Common Errors
 

package/examples/README.md

@@ -32,7 +32,7 @@ PHPSANDBOX_TOKEN=your-token PHPSANDBOX_NOTEBOOK_ID=notebook-id \
   npx tsx examples/publish-laravel-cloud.ts
 ```
 
-Publication examples accept `PHPSANDBOX_API_URL` and `PHPSANDBOX_PUBLISH_SLUG`. On the first run they create the notebook's publication; later runs publish it again without changing slug or provider. The SSH example creates a server registration when `PHPSANDBOX_PUBLISH_SERVER_ID` is not set; on local `.test` APIs it also starts local Rook from `PHPSANDBOX_ROOK_DIR` or the sibling `rook` repo. The Laravel Cloud example syncs the notebook to `PHPSANDBOX_LARAVEL_CLOUD_REPOSITORY`, upserts `PHPSANDBOX_GITHUB_TOKEN` into `GITHUB_TOKEN`, and upserts `PHPSANDBOX_LARAVEL_CLOUD_API_KEY` into `LARAVEL_CLOUD_API_KEY` on first publish.
+Publication examples accept `PHPSANDBOX_API_URL` and `PHPSANDBOX_PUBLISH_SLUG`. On the first run they create the notebook's publication; later runs publish it again without changing slug or provider. The SSH example creates a server registration when `PHPSANDBOX_PUBLISH_SERVER_ID` is not set; on local `.test` APIs it also starts local Rook from `PHPSANDBOX_ROOK_DIR` or the sibling `rook` repo. The Laravel Cloud example links or refreshes the GitHub and Laravel Cloud integrations, attaches each provider to the sandbox, synchronizes the notebook to `PHPSANDBOX_LARAVEL_CLOUD_REPOSITORY`, and publishes through the attached Laravel Cloud integration.
 
 ### Running The Laravel Load Test
 

package/examples/publish-cloudflare-container.ts

@@ -13,10 +13,24 @@ if (!notebookId) {
 
 const slug = process.env.PHPSANDBOX_PUBLISH_SLUG ?? `sdk-cloudflare-${Date.now().toString(36)}`;
 const apiUrl = process.env.PHPSANDBOX_API_URL;
+const cloudflareAccountId = process.env.CLOUDFLARE_ACCOUNT_ID;
+const cloudflareApiToken = process.env.CLOUDFLARE_API_TOKEN;
+if (!cloudflareAccountId || !cloudflareApiToken) {
+  throw new Error('Missing CLOUDFLARE_ACCOUNT_ID or CLOUDFLARE_API_TOKEN');
+}
 const client = new Client(token, apiUrl);
 const notebook = await client.notebook.get(notebookId);
 
 try {
+  const existingIntegration = (await client.integrations.list()).find(({ provider }) => provider === 'cloudflare');
+  const integration = existingIntegration
+    ? await existingIntegration.update({ authorization: { type: 'token', token: cloudflareApiToken } })
+    : await client.integrations.link({
+      provider: 'cloudflare',
+      authorization: { type: 'token', token: cloudflareApiToken },
+    });
+  await notebook.integrations.attach({ integration });
+
   const publication = await notebook.publication();
   if (publication && publication.data.provider.name !== 'cloudflare-containers') {
     throw new Error(`Notebook is already published to ${publicationProviderLabel(publication.data.provider.name)}. Destroy that publication before changing providers.`);
@@ -28,6 +42,7 @@ try {
       slug,
       provider: {
         name: 'cloudflare-containers',
+        accountId: cloudflareAccountId,
         size: 'small',
         sleepAfter: '30m',
       },

package/examples/publish-laravel-cloud.ts

@@ -1,4 +1,4 @@
-import { Client, type LaravelCloudRegion } from '../src/index.js';
+import { Client, type Integration, type LaravelCloudRegion } from '../src/index.js';
 import { publicationProviderLabel } from './publication-provider-label.js';
 
 const token = process.env.PHPSANDBOX_TOKEN;
@@ -11,8 +11,6 @@ if (!notebookId) {
   throw new Error('Missing PHPSANDBOX_NOTEBOOK_ID');
 }
 
-const apiKeySecret = 'LARAVEL_CLOUD_API_KEY';
-const githubTokenSecret = 'GITHUB_TOKEN';
 const slug = process.env.PHPSANDBOX_PUBLISH_SLUG ?? `sdk-laravel-cloud-${Date.now().toString(36)}`;
 const region: LaravelCloudRegion = 'eu-central-1';
 const apiUrl = process.env.PHPSANDBOX_API_URL ?? 'https://api.phpsandbox.io/v1';
@@ -74,39 +72,52 @@ async function publishFirstLaravelCloudPublication() {
     throw new Error('Missing PHPSANDBOX_LARAVEL_CLOUD_API_KEY');
   }
 
-  await notebook.secrets.set(githubTokenSecret, {
-    value: githubToken,
-    type: 'credential',
-  });
-
-  const source = await notebook.git.sync({
+  const existingIntegration = (await client.integrations.list()).find(({ provider }) => provider === 'github');
+  const github = existingIntegration
+    ? await existingIntegration.update({ authorization: { type: 'token', token: githubToken } })
+    : await client.integrations.link({
+      provider: 'github',
+      authorization: { type: 'token', token: githubToken },
+    });
+  await selectSandboxIntegration(github);
+  const target = await notebook.git.targets.create({
     provider: 'github',
     repository,
     author: { name: gitAuthorName, email: gitAuthorEmail },
     branch: 'main',
-    credential: {
-      secret: githubTokenSecret,
-    },
     setDefault: true,
   });
+  const source = await target.sync();
 
-  console.log('source:', source.repository, source.branch, source.lastCommitSha);
-
-  const secret = await notebook.secrets.set(apiKeySecret, {
-    value: apiKey,
-    type: 'credential',
-  });
+  console.log('source:', source.data.repository, source.data.branch, source.data.lastCommitSha);
 
-  console.log('secret:', secret.name);
+  const existingLaravelCloudIntegration = (await client.integrations.list())
+    .find(({ provider }) => provider === 'laravel-cloud');
+  const laravelCloud = existingLaravelCloudIntegration
+    ? await existingLaravelCloudIntegration.update({ authorization: { type: 'token', token: apiKey } })
+    : await client.integrations.link({
+      provider: 'laravel-cloud',
+      authorization: { type: 'token', token: apiKey },
+    });
+  await selectSandboxIntegration(laravelCloud);
 
   return notebook.publish({
     slug,
     provider: {
       name: 'laravel-cloud',
-      apiKey: {
-        secret: apiKeySecret,
-      },
       region,
     },
   });
 }
+
+async function selectSandboxIntegration(integration: Integration): Promise<void> {
+  const binding = (await notebook.integrations.list())
+    .find((candidate) => candidate.integration.provider === integration.provider);
+
+  if (binding) {
+    await binding.update({ integration });
+    return;
+  }
+
+  await notebook.integrations.attach({ integration });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phpsandbox/sdk",
-  "version": "0.1.2",
+  "version": "0.1.6",
   "description": "A comprehensive TypeScript SDK for interacting with cloud-based PHP development environments",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -32,7 +32,16 @@
     "build:tsc": "tsc",
     "build:browser": "node build.mjs",
     "clean": "rm -rf dist",
-    "test": "vitest run",
+    "test": "npm run build:tsc && vitest run --config vitest.config.ts",
+    "smoke": "npm run smoke:pr",
+    "smoke:pr": "npm run build:tsc && vitest run --config tests/smoke/vitest.config.ts tests/smoke/pr",
+    "smoke:nightly": "npm run build:tsc && vitest run --config tests/smoke/vitest.config.ts tests/smoke/pr tests/smoke/nightly --exclude tests/smoke/nightly/publication.smoke.ts",
+    "smoke:publications": "npm run build:tsc && vitest run --reporter=verbose --config tests/smoke/vitest.config.ts tests/smoke/nightly/publication.smoke.ts",
+    "smoke:composer-credentials": "npm run build:tsc && vitest run --reporter=verbose --config tests/smoke/vitest.config.ts tests/smoke/integrations/composer-credentials.smoke.ts",
+    "smoke:beacon": "npm run build:tsc && vitest run --reporter=verbose --config tests/smoke/vitest.config.ts tests/smoke/integrations/beacon.smoke.ts",
+    "smoke:feedback-widget": "npm run build:tsc && vitest run --reporter=verbose --config tests/smoke/vitest.config.ts tests/smoke/integrations/feedback-widget.smoke.ts",
+    "smoke:reaper": "npm run build:tsc && vitest run --reporter=verbose --config tests/smoke/vitest.config.ts tests/smoke/maintenance/resources.reaper.smoke.ts",
+    "smoke:typecheck": "npm run build:tsc && tsc --project tests/smoke/tsconfig.json --noEmit",
     "check:examples": "tsc --noEmit --module NodeNext --moduleResolution NodeNext --target ES2020 --types node --skipLibCheck --allowSyntheticDefaultImports --esModuleInterop examples/basic.ts examples/publish-cloudflare-container.ts examples/publish-laravel-cloud.ts examples/publish-ssh-agent.ts examples/get.ts examples/git-merge-smoke.ts examples/laravel-load-test.ts examples/notebook-readonly-smoke.ts",
     "prepublishOnly": "npm test && npm run check:examples && npm run clean && npm run build",
     "bumpAndPublish": "npm version patch && npm publish --access public"
@@ -74,6 +83,7 @@
     "@types/ws": "^8.18.1",
     "axios": "^1.17.0",
     "esbuild": "^0.27.1",
+    "playwright": "^1.62.1",
     "typescript": "^5.7.2",
     "vitest": "^4.1.8"
   }