@salsita-ai/sdk 0.50.0-develop.bc08a38ffe → 0.50.0-develop.bc204720a8

package/dist/phoenix/services/deployment/index.js

@@ -0,0 +1 @@
+export{readGeneratedEnvMarkers}from"./generated-env-markers.js";export{DeploymentPreparationService}from"./deployment-preparation-service.js";

package/dist/phoenix/services/dev-experience/dev-experience.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from '../../utils/index.js';
+/**
+ * What `phoenix dev` shows around the configurator in the browser.
+ *
+ * `editor` is the internal experience: the Phoenix editor, the detailed dev error pages and Vite's
+ * error overlay. `agent` is the experience of a project whose configurator an AI agent builds: the
+ * editor runs with its UI hidden, so the CLI's inspect commands still work, and every dev error lands
+ * on the "Agent at work" screen while the details go to the terminal logs the agent reads. `plain` is
+ * the configurator alone with the detailed dev error pages, for internal tooling such as asset captures.
+ */
+export type DevExperience = 'editor' | 'agent' | 'plain';
+/**
+ * How `phoenix dev` authenticated with the Phoenix server. Only a session as the signed-in Studio user
+ * runs in agent mode, and only when no editor setting is given; every internal setup keeps the editor.
+ */
+export type CredentialRoute = 'signed-in' | 'development-key' | 'local' | 'no-server';
+/** Inputs of {@link resolveDevExperience}: the explicit settings, unset when absent, and the credential route. */
+export interface ResolveDevExperienceInput {
+    /** `--editor` (true) or `--no-editor` (false). */
+    readonly cliEditor: boolean | undefined;
+    /** The `ENABLE_EDITOR` environment variable. */
+    readonly envEditor: boolean | undefined;
+    readonly route: CredentialRoute;
+}
+/**
+ * Agent mode comes from the credentials alone: the signed-in route gets it when neither `--editor`/`--no-editor`
+ * nor `ENABLE_EDITOR` is set. Those keep their meaning on every route: the editor, or the plain page.
+ */
+export declare const resolveDevExperience: (input: ResolveDevExperienceInput, context: {
+    readonly logger: Logger;
+}) => DevExperience;

package/dist/phoenix/services/dev-experience/dev-experience.js

@@ -0,0 +1 @@
+export const resolveDevExperience=(e,r)=>{let{cliEditor:t,envEditor:i,route:n}=e;if(void 0!==t)return r.logger.detail(`Editor enabled: ${t} (from CLI flag)`),t?"editor":"plain";if(void 0!==i)return r.logger.detail(`Editor enabled: ${i} (from environment variable)`),i?"editor":"plain";let o="signed-in"===n?"agent":"editor";return r.logger.detail("agent"===o?"Dev experience: agent mode, the editor running with its UI hidden (default for the signed-in route)":`Dev experience: editor (default for the ${n} route)`),o};

package/dist/phoenix/services/dev-experience/index.d.ts

@@ -0,0 +1,3 @@
+export { type CredentialRoute, type DevExperience, resolveDevExperience } from './dev-experience.js';
+export { readExplicitEditorSetting } from './read-explicit-editor-setting.js';
+export { resolveRegeneratedPageExperience } from './regenerated-page-experience.js';

package/dist/phoenix/services/dev-experience/index.js

@@ -0,0 +1 @@
+export{resolveDevExperience}from"./dev-experience.js";export{readExplicitEditorSetting}from"./read-explicit-editor-setting.js";export{resolveRegeneratedPageExperience}from"./regenerated-page-experience.js";

package/dist/phoenix/services/dev-experience/read-explicit-editor-setting.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The `ENABLE_EDITOR` a user set, from the process environment, the project's `.env` or the pnpm
+ * workspace root's `.env`, in that order, as the env reader takes it. The generated env file is left
+ * out on purpose: development preparation writes the server's `ENABLE_EDITOR=true` into it, and
+ * reading that back would turn every signed-in session after the first into an editor session.
+ */
+export declare const readExplicitEditorSetting: (projectRoot: string) => boolean | undefined;

package/dist/phoenix/services/dev-experience/read-explicit-editor-setting.js

@@ -0,0 +1 @@
+import{parse as t}from"dotenv";import{bool as r,cleanEnv as e}from"envalid";import{existsSync as o,readFileSync as E}from"fs";import{dirname as i,join as n}from"path";let p=r=>{let e=n(r,".env");return o(e)?t(E(e,"utf8")).ENABLE_EDITOR:void 0},m=t=>{if(o(n(t,"pnpm-workspace.yaml")))return t;let r=i(t);return r===t?void 0:m(r)};export const readExplicitEditorSetting=t=>{let o=m(t);return e({ENABLE_EDITOR:process.env.ENABLE_EDITOR??p(t)??(o&&o!==t?p(o):void 0)},{ENABLE_EDITOR:r({default:void 0})}).ENABLE_EDITOR};

package/dist/phoenix/services/dev-experience/regenerated-page-experience.d.ts

@@ -0,0 +1,24 @@
+import type { PageExperience } from '#package/application-spec';
+import type { Logger } from '../../utils/index.js';
+/** The editor settings {@link resolveRegeneratedPageExperience} weighs. */
+export interface RegeneratedPageExperienceInput {
+    /** `--editor` or `--no-editor`. */
+    readonly cliEditor: boolean | undefined;
+    /** `ENABLE_EDITOR` the user set in the environment or `.env`, the generated env file left out. */
+    readonly userEditor: boolean | undefined;
+    /**
+     * `ENABLE_EDITOR` as the env reader takes it, the generated env file first after the environment. A
+     * deploy build gets `false` there, and a signed-in dev session `true`.
+     */
+    readonly environmentEditor: boolean | undefined;
+}
+/**
+ * The page `phoenix sync`, `build` and `clean` regenerate. `--editor`/`--no-editor` decides first. An
+ * agent-mode page dev generated is kept unless the user set `ENABLE_EDITOR`, so running one while dev is
+ * in agent mode never puts the visible editor back in front of the client; the generated env file's
+ * `ENABLE_EDITOR=true` is not a choice there. Otherwise `ENABLE_EDITOR` decides as the env reader takes
+ * it, the generated env file before `.env`, as it does for a deploy build, and the editor is the default.
+ */
+export declare const resolveRegeneratedPageExperience: (input: RegeneratedPageExperienceInput, context: {
+    readonly logger: Logger;
+}) => PageExperience;

package/dist/phoenix/services/dev-experience/regenerated-page-experience.js

@@ -0,0 +1 @@
+import{existsSync as e,readFileSync as o}from"fs";let t=".phoenix/editor.tsx";export const resolveRegeneratedPageExperience=(i,r)=>{let{cliEditor:n,userEditor:d,environmentEditor:a}=i,l=(e,o)=>(r.logger.detail(`Page: ${e} (${o})`),e);return void 0!==n?l(n?"editor":"plain","from CLI flag"):e(t)&&o(t,"utf8").includes(" hideUi")?void 0===d?l("agent","keeps the agent-mode page phoenix dev generated"):l(d?"editor":"plain","from ENABLE_EDITOR in the environment or .env"):void 0===a?l("editor","default"):l(a?"editor":"plain","from ENABLE_EDITOR")};

package/dist/phoenix/services/index.d.ts

@@ -1,13 +1,15 @@
-export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
+export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecBuildStatus, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
 export { PhoenixPubSub } from './phoenix-pubsub.js';
 export { PhoenixStore } from './phoenix-store.js';
-export { PhoenixApplication } from './phoenix-application.js';
+export { DeploymentPreparationService, readGeneratedEnvMarkers } from './deployment/index.js';
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, type EditorServerHandle, } from './session/index.js';
 export { VariantFileSession } from './variant-file-session.js';
 export { VariantPreviewService } from './variant-preview-service.js';
 export { MockTemplateWatcher, type MockTemplateWatcherConfig } from './mock-template-watcher.js';
 export { ApplicationSpecProjectWatcher, type ApplicationSpecProjectWatcherConfig, } from './application-spec-project-watcher.js';
 export { ApplicationSpecStoryWatcher, type ApplicationSpecStoryWatcherConfig, } from './application-spec-story-watcher.js';
 export { LinguiWatcher, type LinguiWatcherConfig } from './lingui-watcher.js';
+export { bootstrapLinguiCatalogs, extractAndCompileLingui } from '../lingui/index.js';
 export { loadMockTemplates, parseMockTemplateYaml, type LoadMockTemplatesResult, type ParsedMockTemplate, } from './spec-files.js';
 export { LOG_STREAMS, LogBus, type LogEntry, type LogLevel, type LogPage, type LogQuery, type LogStream, } from './log-bus.js';
 export { createBusLogger, type CreateBusLoggerOptions } from './bus-logger.js';
@@ -18,6 +20,9 @@ export { STORY_DEV_MARKER_PATH, readActiveStoryDevMarker, type StoryDevMarker }
 export { composeDefaultBanner } from './phx-banner-plugin.js';
 export { getViteBuildConfigs, getViteDevConfig, setViteLogSink, type ViteLogSink, type ViteLogSinkOptions, } from './vite-config.js';
 export { getServerCredentials, removeServerCredentials, saveServerCredentials } from './cli-credentials.js';
+export { exitCli, setBeforeCliExit } from './cli-exit.js';
 export { createSourceArchive, extractSourceArchive } from './source-archive.js';
 export { resolveSignedInDevelopmentEnvironment } from './signed-in-development-environment.js';
+export { createTelemetryClient, resolveTelemetryCommand, type CommandTelemetryAttempt, type TelemetryAssociation, type TelemetryClient, type TelemetryCommand, } from './telemetry/index.js';
 export { DEFAULT_PHOENIX_REGION, PHOENIX_REGIONS, PUBLIC_PHOENIX_REGIONS, getRegionServerUrl, getRegionStudioUrl, } from './phoenix-regions.js';
+export { type CredentialRoute, type DevExperience, readExplicitEditorSetting, resolveDevExperience, resolveRegeneratedPageExperience, } from './dev-experience/index.js';

package/dist/phoenix/services/index.js

@@ -1 +1 @@
-export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{PhoenixApplication}from"./phoenix-application.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";
+export{PhoenixPubSub}from"./phoenix-pubsub.js";export{PhoenixStore}from"./phoenix-store.js";export{DeploymentPreparationService,readGeneratedEnvMarkers}from"./deployment/index.js";export{PhoenixApplication}from"./session/index.js";export{VariantFileSession}from"./variant-file-session.js";export{VariantPreviewService}from"./variant-preview-service.js";export{MockTemplateWatcher}from"./mock-template-watcher.js";export{ApplicationSpecProjectWatcher}from"./application-spec-project-watcher.js";export{ApplicationSpecStoryWatcher}from"./application-spec-story-watcher.js";export{LinguiWatcher}from"./lingui-watcher.js";export{bootstrapLinguiCatalogs,extractAndCompileLingui}from"../lingui/index.js";export{loadMockTemplates,parseMockTemplateYaml}from"./spec-files.js";export{LOG_STREAMS,LogBus}from"./log-bus.js";export{createBusLogger}from"./bus-logger.js";export{patchConsole}from"./console-capture.js";export{WebhookTunnelMonitor}from"./webhook-tunnel-monitor.js";export{compileWithSwc,watchWithSwc}from"./swc.js";export{STORY_DEV_MARKER_PATH,readActiveStoryDevMarker}from"./story-dev-marker.js";export{composeDefaultBanner}from"./phx-banner-plugin.js";export{getViteBuildConfigs,getViteDevConfig,setViteLogSink}from"./vite-config.js";export{getServerCredentials,removeServerCredentials,saveServerCredentials}from"./cli-credentials.js";export{exitCli,setBeforeCliExit}from"./cli-exit.js";export{createSourceArchive,extractSourceArchive}from"./source-archive.js";export{resolveSignedInDevelopmentEnvironment}from"./signed-in-development-environment.js";export{createTelemetryClient,resolveTelemetryCommand}from"./telemetry/index.js";export{DEFAULT_PHOENIX_REGION,PHOENIX_REGIONS,PUBLIC_PHOENIX_REGIONS,getRegionServerUrl,getRegionStudioUrl}from"./phoenix-regions.js";export{readExplicitEditorSetting,resolveDevExperience,resolveRegeneratedPageExperience}from"./dev-experience/index.js";

package/dist/phoenix/services/lingui-watcher.js

@@ -1 +1 @@
-import e from"promise-queue";import{Subject as t,buffer as i,debounceTime as s}from"rxjs";import{watch as r}from"#package/watch";import{compileLingui as n,extractAndCompileLingui as o}from"./lingui.js";let c=["src/**/*.{ts,tsx}","src/locales/**/*.po"],g=["src/locales/**/*.{ts,tsx}"];export class LinguiWatcher{watcher=null;subscription=null;runQueue=new e(1,1/0);changeSubject$=new t;logger;isShuttingDown=!1;constructor(e){this.logger=e.logger}start(){this.setupFileWatcher(),this.setupRunSubscription()}trigger(){this.changeSubject$.next("<codegen-rebuild>")}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=r(c,{ignored:g,cwd:process.cwd(),ignoreInitial:!0,persistent:!0}),this.watcher.on("all",(e,t)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.debug(`Lingui source ${e}: ${t}`),this.changeSubject$.next(t))}).on("error",e=>{this.logger.error(`Lingui watcher error: ${e instanceof Error?e.message:String(e)}`,e)})}setupRunSubscription(){let e=this.changeSubject$.pipe(s(200));this.subscription=this.changeSubject$.pipe(i(e)).subscribe(e=>{let t=e.some(e=>!e.endsWith(".po"));this.runQueue.add(async()=>{if(!this.isShuttingDown)try{t?(this.logger.info("Lingui sources changed, extracting and compiling i18n messages..."),await o({logger:this.logger})):(this.logger.info("Lingui catalogs changed, compiling i18n messages..."),await n({logger:this.logger}))}catch(e){this.logger.error(`Lingui update failed: ${e instanceof Error?e.message:String(e)}`,e)}})})}}
+import e from"promise-queue";import{Subject as i,buffer as t,debounceTime as s}from"rxjs";import{watch as r}from"#package/watch";import{compileLingui as n,extractAndCompileLingui as o}from"../lingui/index.js";let c=["src/**/*.{ts,tsx}","src/locales/**/*.po"],g=["src/locales/**/*.{ts,tsx}"];export class LinguiWatcher{watcher=null;subscription=null;runQueue=new e(1,1/0);changeSubject$=new i;logger;isShuttingDown=!1;constructor(e){this.logger=e.logger}start(){this.setupFileWatcher(),this.setupRunSubscription()}trigger(){this.changeSubject$.next("<codegen-rebuild>")}async close(){this.isShuttingDown=!0,this.watcher&&(await this.watcher.close(),this.watcher=null),this.subscription?.unsubscribe(),this.changeSubject$.complete()}setupFileWatcher(){this.watcher=r(c,{ignored:g,cwd:process.cwd(),ignoreInitial:!0,persistent:!0}),this.watcher.on("all",(e,i)=>{("change"===e||"add"===e||"unlink"===e)&&(this.logger.debug(`Lingui source ${e}: ${i}`),this.changeSubject$.next(i))}).on("error",e=>{this.logger.error(`Lingui watcher error: ${e instanceof Error?e.message:String(e)}`,e)})}setupRunSubscription(){let e=this.changeSubject$.pipe(s(200));this.subscription=this.changeSubject$.pipe(t(e)).subscribe(e=>{let i=e.some(e=>!e.endsWith(".po"));this.runQueue.add(async()=>{if(!this.isShuttingDown)try{i?(this.logger.info("Lingui sources changed, extracting and compiling i18n messages..."),await o({logger:this.logger})):(this.logger.info("Lingui catalogs changed, compiling i18n messages..."),await n({logger:this.logger}))}catch(e){this.logger.error(`Lingui update failed: ${e instanceof Error?e.message:String(e)}`,e)}})})}}

package/dist/phoenix/services/phoenix-pubsub.d.ts

@@ -1,11 +1,15 @@
 import { Subject } from 'rxjs';
 import type { RawProjectFiles } from '#package/application-spec';
 import type { MockTemplateDefinition } from '#package/editor';
+/** Whether the latest rebuild of the project files succeeded; an agent-mode page shows it on its badge. */
+export type SpecBuildStatus = 'ok' | 'failed';
 /** Batch of project files that changed on disk. */
 export interface SpecUpdateEvent {
     readonly rawProjectFiles: RawProjectFiles;
     readonly projectRoot: string;
     readonly configurationSchemaHash?: string;
+    /** How the rebuild this event reports went; absent when the event reports no rebuild. */
+    readonly build?: SpecBuildStatus;
 }
 /** Updated set of mock template definitions after a file change. */
 export interface MockTemplateUpdateEvent {

package/dist/phoenix/services/phoenix-regions.d.ts

@@ -15,4 +15,4 @@ export declare const getRegionServerUrl: (region: PhoenixRegion) => string;
  * Studio of one workspace in a region. The slug becomes a subdomain, so anything but a plain slug is refused: it
  * could otherwise point the sign-in at another host.
  */
-export declare const getRegionStudioUrl: (region: PhoenixRegion, workspace: string) => string;
+export declare const getRegionStudioUrl: (region: PhoenixRegion, workspace: string | undefined) => string;

package/dist/phoenix/services/phoenix-regions.js

@@ -1 +1 @@
-export const PHOENIX_REGIONS=["eu","us","staging"];export const PUBLIC_PHOENIX_REGIONS=["eu","us"];export const DEFAULT_PHOENIX_REGION="eu";let s={eu:{serverUrl:"https://production-eu-central-1.salsita.ai",studioDomain:"studio.eu.salsita.ai"},us:{serverUrl:"https://production-us-east-1.salsita.ai",studioDomain:"studio.salsita.ai"},staging:{serverUrl:"https://staging.salsita.app",studioDomain:"studio-staging.salsita.app"}},t=/^[a-z0-9-]+$/;export const getRegionServerUrl=t=>s[t].serverUrl;export const getRegionStudioUrl=(e,o)=>{if(!t.test(o))throw Error(`"${o}" is not a workspace slug. A slug has only lowercase letters, digits and dashes; use the one from your Studio address.`);return`https://${o}.${s[e].studioDomain}`};
+export const PHOENIX_REGIONS=["eu","us","staging"];export const PUBLIC_PHOENIX_REGIONS=["eu","us"];export const DEFAULT_PHOENIX_REGION="eu";let s={eu:{serverUrl:"https://production-eu-central-1.salsita.ai",studioDomain:"studio.eu.salsita.ai"},us:{serverUrl:"https://production-us-east-1.salsita.ai",studioDomain:"studio.salsita.ai"},staging:{serverUrl:"https://staging.salsita.app",studioDomain:"studio-staging.salsita.app"}},t=/^[a-z0-9-]+$/;export const getRegionServerUrl=t=>s[t].serverUrl;export const getRegionStudioUrl=(e,o)=>{if(void 0===o)return`https://${s[e].studioDomain}`;if(!t.test(o))throw Error(`"${o}" is not a workspace slug. A slug has only lowercase letters, digits and dashes; use the one from your Studio address.`);return`https://${o}.${s[e].studioDomain}`};

package/dist/phoenix/services/phoenix-store.d.ts

@@ -1,4 +1,5 @@
 import { BehaviorSubject } from 'rxjs';
+import type { ViteDevServer } from 'vite';
 /**
  * A frontend file script or standalone HTML proposal served from `.phoenix/variants/`.
  */
@@ -44,5 +45,7 @@ export interface VariantPreviewState {
  * editor server reaches it only through them. Events that carry no state stay on PhoenixPubSub.
  */
 export declare class PhoenixStore {
+    readonly viteServer$: BehaviorSubject<ViteDevServer | null>;
+    readonly reportedFingerprint$: BehaviorSubject<string | null>;
     readonly variantPreview$: BehaviorSubject<VariantPreviewState>;
 }

package/dist/phoenix/services/phoenix-store.js

@@ -1 +1 @@
-import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}
+import{BehaviorSubject as e}from"rxjs";export class PhoenixStore{viteServer$=new e(null);reportedFingerprint$=new e(null);variantPreview$=new e({open:null,activeChoice:null,unclaimed:null})}

package/dist/phoenix/services/prepare-development-environment.js

@@ -1,2 +1,2 @@
-import{writeFile as e}from"node:fs/promises";import{createApiBaseClient as i}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as r,uploadFilesWithPresignedUrls as a}from"../utils/index.js";import{getDevelopmentCredentialHint as o,getDevelopmentHeaders as s}from"./development-credential.js";export const prepareDevelopmentEnvironment=async(n,l)=>{let{logger:p}=l,{projectSlug:d,environmentSlug:m,serverUrl:c,credential:h,outFile:v,skipUpload:f,overrideSchema:u,projectVersion:g}=n;p.step("Preparing development environment"),p.info(`Preparing development environment for project "${d}", environment "${m}"`);let E=i(c);p.debug(`Using server URL: ${c}`);let b=await t({skipUpload:f,logger:p});p.info("Preparing and activating the development deployment on the server...");let{data:P,error:$}=await E.POST("/environments/development/prepare",{body:{applicationVersion:b.applicationVersion,publishedDataHash:b.publishedDataHash,useAuthHook:b.useAuthHook,overrideSchema:u,configurationSchema:{version:b.schemaVersion,schema:b.schema},adminConfigurationSchema:b.adminSchema?{schema:b.adminSchema,version:b.adminSchemaVersion}:void 0,chat:b.chat,embeddings:b.embeddings,...b.assistant?{assistant:!0}:{},acl:{canCreate:b.aclCanCreate},privateFiles:[...b.assets.privateFilePaths],publicFiles:[...b.assets.publicFilePaths],sdkVersion:g},headers:s(h,{projectSlug:d,environmentSlug:m})});if($)throw Error(`Failed to prepare development deployment for ${d}/${m} on ${c}: ${$.message}. ${o(h,d)}`);if(!P)throw Error("No data returned from server while preparing the development deployment.");let{environmentVariables:y,privateUploadUrls:w,publicUploadUrls:F}=P;if(f)p.debug("Skipping file upload");else{p.info("Uploading files to S3...");let e={privateFiles:[...b.assets.privateFilesFullPaths].map(e=>{let i=e.replace("assets/private/",""),t=w[i];if(!t)throw Error(`No upload URL provided for private file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...b.assets.publicFilesFullPaths].map(e=>{let i=e.replace("assets/public/",""),t=F[i];if(!t)throw Error(`No upload URL provided for public file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:p})}try{await e(v,`${r({...y,PHOENIX_PROJECT_SLUG:d,PHOENIX_ENVIRONMENT_SLUG:m,PHOENIX_SERVER_URL:c})}
+import{writeFile as e}from"node:fs/promises";import{createApiBaseClient as i}from"#package/client";import{resolveApplicationSpecDeploymentData as t}from"../application-spec/index.js";import{formatEnvContent as r,uploadFilesWithPresignedUrls as a}from"../utils/index.js";import{getDevelopmentCredentialHint as o,getDevelopmentHeaders as s}from"./development-credential.js";export const prepareDevelopmentEnvironment=async(n,l)=>{let{logger:p}=l,{projectSlug:d,environmentSlug:m,serverUrl:c,credential:h,outFile:v,skipUpload:f,overrideSchema:u,projectVersion:g}=n;p.step("Preparing development environment"),p.info(`Preparing development environment for project "${d}", environment "${m}"`);let E=i(c);p.debug(`Using server URL: ${c}`);let P=await t({skipUpload:f,logger:p});p.info("Preparing and activating the development deployment on the server...");let{data:b,error:$}=await E.POST("/environments/development/prepare",{body:{applicationVersion:P.applicationVersion,publishedDataHash:P.publishedDataHash,useAuthHook:P.useAuthHook,useCognito:P.useCognito,overrideSchema:u,configurationSchema:{version:P.schemaVersion,schema:P.schema},adminConfigurationSchema:P.adminSchema?{schema:P.adminSchema,version:P.adminSchemaVersion}:void 0,chat:P.chat,embeddings:P.embeddings,...P.assistant?{assistant:!0}:{},acl:{canCreate:P.aclCanCreate},privateFiles:[...P.assets.privateFilePaths],publicFiles:[...P.assets.publicFilePaths],sdkVersion:g},headers:s(h,{projectSlug:d,environmentSlug:m})});if($)throw Error(`Failed to prepare development deployment for ${d}/${m} on ${c}: ${$.message}. ${o(h,d)}`);if(!b)throw Error("No data returned from server while preparing the development deployment.");let{environmentVariables:y,privateUploadUrls:N,publicUploadUrls:w}=b;if(f)p.debug("Skipping file upload");else{p.info("Uploading files to S3...");let e={privateFiles:[...P.assets.privateFilesFullPaths].map(e=>{let i=e.replace("assets/private/",""),t=N[i];if(!t)throw Error(`No upload URL provided for private file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/private directory.`);return{localPath:e,uploadUrl:t}}),publicFiles:[...P.assets.publicFilesFullPaths].map(e=>{let i=e.replace("assets/public/",""),t=w[i];if(!t)throw Error(`No upload URL provided for public file ${i}, the server did not return a presigned URL for this file, please verify the file exists in the assets/public directory.`);return{localPath:e,uploadUrl:t}})};await a(e,{logger:p})}try{await e(v,`${r({...y,PHOENIX_PROJECT_SLUG:d,PHOENIX_ENVIRONMENT_SLUG:m,PHOENIX_SERVER_URL:c,PHOENIX_DEPLOYMENT_FINGERPRINT:P.fingerprint})}
 `),p.debug(`Environment variables written to ${v}`)}catch{throw Error(`Failed to write environment variables to file at ${v}, please verify you have write permissions to this location.`)}p.info(`Project: ${d}`),p.info(`Environment: ${m}`),p.info(`Deployment ID: ${y.DEPLOYMENT_ID}`),p.success("Development environment prepared successfully!")};

package/dist/phoenix/services/session/editor-server-handle.d.ts

@@ -0,0 +1,5 @@
+/** A session-owned editor transport, including the result of binding its port. */
+export interface EditorServerHandle {
+    readonly ready: Promise<void>;
+    readonly close: () => Promise<void>;
+}

package/dist/phoenix/services/session/editor-server-handle.js

@@ -0,0 +1 @@
+export{};

package/dist/phoenix/services/session/index.d.ts

@@ -0,0 +1,2 @@
+export { PhoenixApplication, type PhoenixApplicationProps, type PhoenixApplicationContext, type PhoenixDevelopmentOptions, } from './phoenix-application.js';
+export type { EditorServerHandle } from './editor-server-handle.js';

package/dist/phoenix/services/session/index.js

@@ -0,0 +1 @@
+export{PhoenixApplication}from"./phoenix-application.js";

package/dist/phoenix/services/session/phoenix-application.d.ts

@@ -0,0 +1,83 @@
+import { Subject } from 'rxjs';
+import { createServer } from 'vite';
+import { type Logger } from '../../utils/index.js';
+import { DeploymentPreparationService } from '../deployment/index.js';
+import type { DevExperience } from '../dev-experience/index.js';
+import { type DevelopmentCredential } from '../development-credential.js';
+import { LinguiWatcher } from '../lingui-watcher.js';
+import { LogBus } from '../log-bus.js';
+import { type BrowserConsoleEvent, PhoenixPubSub } from '../phoenix-pubsub.js';
+import { PhoenixStore } from '../phoenix-store.js';
+import { VariantPreviewService } from '../variant-preview-service.js';
+import { WebhookTunnelMonitor } from '../webhook-tunnel-monitor.js';
+import type { EditorServerHandle } from './editor-server-handle.js';
+/** Resolved inputs for one development session; the application constructs its service graph. */
+export interface PhoenixDevelopmentOptions {
+    readonly sdkVersion: string;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly cliUseWorkspace: boolean | undefined;
+    readonly devExperience: DevExperience;
+    readonly debug: boolean;
+    readonly withLingui: boolean;
+    readonly persistenceMode: string | undefined;
+    readonly force: boolean;
+    readonly serverUrl: string | undefined;
+    readonly credential: DevelopmentCredential | undefined;
+    readonly skipUpload: boolean;
+}
+export interface PhoenixApplicationProps {
+    readonly projectRoot: string;
+    readonly mode: 'dev' | 'story';
+    readonly development: PhoenixDevelopmentOptions | undefined;
+    readonly editorPort: number | undefined;
+}
+/** Host adapters for the editor transport and terminal presentation at lifecycle boundaries. */
+export interface PhoenixApplicationContext {
+    readonly logger: Logger;
+    readonly createEditorServer: (props: {
+        readonly port: number;
+        readonly application: PhoenixApplication;
+        readonly logger: Logger;
+        readonly debug: boolean;
+    }) => EditorServerHandle;
+    readonly onProjectPrepared: (logs: LogBus) => void;
+    readonly onStartupFailure: (error: unknown) => void;
+    readonly onBrowserConsole: (event: BrowserConsoleEvent, logs: LogBus) => void;
+}
+/** Composes, starts and closes one dev or story session, including resources acquired during a failed start. */
+export declare class PhoenixApplication {
+    private readonly props;
+    private readonly context;
+    readonly store: PhoenixStore;
+    readonly pubsub: PhoenixPubSub;
+    readonly failures$: Subject<Error>;
+    private readonly logsValue;
+    private readonly tunnelMonitorValue;
+    private readonly deploymentPreparationValue;
+    private variantPreviewsValue;
+    private linguiWatcherValue;
+    private projectWatcher;
+    private storyWatcher;
+    private mockTemplateWatcher;
+    private editorServer;
+    private webhookTunnel;
+    private browserConsoleSubscription;
+    private startPromise;
+    private closePromise;
+    constructor(props: PhoenixApplicationProps, context: PhoenixApplicationContext);
+    get logs(): LogBus | undefined;
+    get tunnelMonitor(): WebhookTunnelMonitor | undefined;
+    get deploymentPreparation(): DeploymentPreparationService | undefined;
+    get projectRoot(): string;
+    get mode(): 'dev' | 'story';
+    get variantPreviews(): VariantPreviewService | undefined;
+    get linguiWatcher(): LinguiWatcher | undefined;
+    start(): Promise<Awaited<ReturnType<typeof createServer>> | undefined>;
+    close(): Promise<void>;
+    private startSession;
+    private startEditor;
+    private startDevelopment;
+    private assertStarting;
+    private closeResources;
+}

package/dist/phoenix/services/session/phoenix-application.js

@@ -0,0 +1,2 @@
+import{Subject as e}from"rxjs";import{createServer as t}from"vite";import{resolveGeneratedEnvFile as r}from"@salsita-ai/common/env";import{generateProjectFiles as o,getDeploymentFingerprint as s}from"../../application-spec/index.js";import{exists as i}from"../../utils/index.js";import{buildWebhooks as n,webhookLogContext as a}from"../../webhooks/index.js";import{ApplicationSpecProjectWatcher as l}from"../application-spec-project-watcher.js";import{ApplicationSpecStoryWatcher as c}from"../application-spec-story-watcher.js";import{DeploymentPreparationService as h,readGeneratedEnvMarkers as p}from"../deployment/index.js";import{getDevelopmentCredentialHint as u}from"../development-credential.js";import{LinguiWatcher as g}from"../lingui-watcher.js";import{LogBus as m}from"../log-bus.js";import{MockTemplateWatcher as d}from"../mock-template-watcher.js";import{PhoenixPubSub as v}from"../phoenix-pubsub.js";import{PhoenixStore as w}from"../phoenix-store.js";import{VariantPreviewService as b}from"../variant-preview-service.js";import{getViteDevConfig as S}from"../vite-config.js";import{createWebhookTunnelTransport as E,readOrCreateTunnelSessionId as x,startWebhookService as f}from"../webhook-service/index.js";import{WebhookTunnelMonitor as P}from"../webhook-tunnel-monitor.js";export class PhoenixApplication{props;context;store=new w;pubsub=new v;failures$=new e;logsValue;tunnelMonitorValue;deploymentPreparationValue;variantPreviewsValue;linguiWatcherValue;projectWatcher;storyWatcher;mockTemplateWatcher;editorServer;webhookTunnel;browserConsoleSubscription;startPromise;closePromise;constructor(e,t){this.props=e,this.context=t;let r="dev"===e.mode?e.development:void 0,o=r&&(!r.persistenceMode||"server"===r.persistenceMode);this.logsValue="dev"===e.mode?new m:void 0,this.tunnelMonitorValue=o&&r.serverUrl?new P(r.serverUrl):void 0,this.deploymentPreparationValue=o&&r.serverUrl&&r.credential?new h({serverUrl:r.serverUrl,credential:r.credential,projectSlug:r.projectSlug,environmentSlug:r.environmentSlug,sdkVersion:r.sdkVersion},{store:this.store,get logger(){return t.logger}}):void 0}get logs(){return this.logsValue}get tunnelMonitor(){return this.tunnelMonitorValue}get deploymentPreparation(){return this.deploymentPreparationValue}get projectRoot(){return this.props.projectRoot}get mode(){return this.props.mode}get variantPreviews(){return this.variantPreviewsValue}get linguiWatcher(){return this.linguiWatcherValue}start(){return this.startPromise??=this.startSession(),this.startPromise}close(){return this.closePromise??=this.closeResources(this.context.logger),this.closePromise}async startSession(){try{if(this.assertStarting(),"story"===this.mode)return void await this.startEditor();let e=this.logs;if(!e)throw Error("Cannot start development: the application has no log bus.");return this.browserConsoleSubscription=this.pubsub.browserConsole$.subscribe(t=>this.context.onBrowserConsole(t,e)),await this.startDevelopment()}catch(e){throw this.closePromise||this.context.onStartupFailure(e),await this.close(),e}}async startEditor(){let e=this.props.editorPort;void 0!==e&&("dev"===this.mode&&this.context.logger.step("Starting editor WebSocket server"),this.editorServer=this.context.createEditorServer({port:e,application:this,logger:this.context.logger,debug:this.props.development?.debug??!1}),await this.editorServer.ready,this.assertStarting(),"dev"===this.mode&&this.context.logger.debug(`Editor WebSocket server started on port ${e}`),this.mockTemplateWatcher=new d({projectRoot:this.projectRoot,pubsub:this.pubsub,logger:this.context.logger}),this.mockTemplateWatcher.start(),"story"===this.mode&&(this.storyWatcher=new c({projectRoot:this.projectRoot,pubsub:this.pubsub,logger:this.context.logger}),this.storyWatcher.start()))}async startDevelopment(){let e=this.props.development,c=this.logs;if(!e||!c)throw Error("Cannot start development: session options are missing. Supply development options when constructing the application.");let{sdkVersion:h,projectSlug:m,environmentSlug:d,cliUseWorkspace:v,devExperience:w,debug:P,withLingui:j,persistenceMode:y,force:k,serverUrl:V,credential:W,skipUpload:R}=e,{store:N,pubsub:T,deploymentPreparation:I,tunnelMonitor:_}=this;process.env.NODE_ENV="development",y&&(process.env.PERSISTENCE_MODE=y);let O=!y||"server"===y;if(O&&V&&(process.env.SERVER_URL=V),this.context.logger.step("Starting development mode"),!await i("spec"))throw Object.assign(Error('Spec folder not found. Run "phoenix init" first.'),{code:"SPEC_NOT_FOUND"});if(O&&(!V||!W))throw Error("Server persistence needs a server and a credential. Run `phoenix login <workspace>`, or create a development environment in Studio and paste its .env block into .env.");this.context.logger.step("Building project files");let{templateFiles:D,applicationSpec:$}=await o({sdkVersion:h,projectSlug:m,environmentSlug:d,cliUseWorkspace:v,pageExperience:w,withLingui:j,force:k},{logger:this.context.logger});if(this.assertStarting(),this.context.logger.success("Project files built successfully"),O&&V&&W){let e=r("."),t=await p(e);k||t?.PHOENIX_PROJECT_SLUG!==m||t.PHOENIX_ENVIRONMENT_SLUG!==d||t.PHOENIX_SERVER_URL!==V||t.PHOENIX_DEPLOYMENT_FINGERPRINT!==s($)?(this.context.logger.step("Preparing development deployment"),await I?.prepareAtStartup({skipUpload:R,debug:P})):this.context.logger.debug(`${e} matches the current development environment, skipping prepare`)}if(this.assertStarting(),this.context.onProjectPrepared(c),j?(this.linguiWatcherValue=new g({logger:this.context.logger}),this.linguiWatcherValue.start()):this.context.logger.warn("Continuous Lingui updates are disabled; missing catalogs were bootstrapped at startup. Pass --withLingui or set WITH_LINGUI=true to enable."),O&&(this.context.logger.step("Building webhooks"),await a.run("webhook",async()=>{await n({experimental:!0,skipNodeEnvOverride:!0,webhookEntryPoint:"./.phoenix/.swc/.phoenix/webhook.js"})})),O&&V&&W){let e=r("."),t=await p(e);if(!t?.DEPLOYMENT_ID)throw Error(`Webhook tunnel cannot start because ${e} has no DEPLOYMENT_ID. Rerun phoenix dev to prepare the development deployment.`);this.assertStarting();let o=await x();this.assertStarting();let s=await f({experimental:!0,transport:E({serverUrl:V,credential:W,projectSlug:m,environmentSlug:d}),rejectionHint:u(W,m),environmentSlug:d,deploymentId:t.DEPLOYMENT_ID,sessionId:o,onStatus:(e,r)=>{_?.setStatus(e,{deploymentId:t.DEPLOYMENT_ID,sessionId:o,message:r??null})},onRequest:e=>_?.record(e)});this.closePromise&&(await s.stop(),this.assertStarting()),this.webhookTunnel=s,_?.setStatus("waiting",{deploymentId:t.DEPLOYMENT_ID,sessionId:o}),s.stopped.catch(e=>{this.failures$.next(Error(`Webhook tunnel failed: ${e instanceof Error?e.message:String(e)}`)),this.close()}),this.context.logger.success("Webhook tunnel started")}this.assertStarting();let M=new l({pubsub:T,logger:this.context.logger,sdkVersion:h,projectSlug:m,environmentSlug:d,cliUseWorkspace:v,pageExperience:w,inlineTemplates:!1,useServer:O},{store:N,linguiWatcher:this.linguiWatcherValue,deploymentPreparation:I});this.projectWatcher=M,this.variantPreviewsValue=new b({projectRoot:this.projectRoot},{store:N,logger:this.context.logger,projectWatcher:M}),"plain"!==w&&void 0!==this.props.editorPort&&await this.startEditor();let C=await S({templateFiles:D,agentMode:"agent"===w}),L=await t(C);return this.closePromise&&(await L.close(),this.assertStarting()),this.store.viteServer$.next(L),await L.listen(),this.assertStarting(),this.context.logger.step("Starting Vite dev server"),M.start(L),L}assertStarting(){if(this.closePromise)throw Error("Cannot continue startup: the session has already closed. Start a new Phoenix application.")}async closeResources(e){"dev"===this.mode&&e.debug("Shutting down...");let t="story"===this.mode?[{name:"story source watcher",close:()=>this.storyWatcher?.close()},{name:"mock-template watcher",close:()=>this.mockTemplateWatcher?.close()},{name:"editor server",close:()=>this.editorServer?.close()}]:[{name:"lingui watcher",close:()=>this.linguiWatcherValue?.close()},{name:"project watcher",close:()=>this.projectWatcher?.close()},{name:"mock template watcher",close:()=>this.mockTemplateWatcher?.close()},{name:"editor server",close:()=>this.editorServer?.close()},{name:"variant previews",close:()=>this.variantPreviewsValue?.dispose()},{name:"vite server",close:()=>this.store.viteServer$.value?.close()},{name:"webhook tunnel",close:()=>this.webhookTunnel?.stop()}],r=[];for(let o of t)try{"dev"===this.mode&&e.debug(`Shutting down ${o.name}`),await o.close()}catch(s){let t=s instanceof Error?s.message:String(s);"story"===this.mode?e.warn(`Failed to close the story-dev ${o.name}: ${t}. The process will continue shutting down.`):r.push(`${o.name}: ${t}`)}this.browserConsoleSubscription?.unsubscribe(),this.failures$.complete(),r.length>0&&e.warn(`Cleanup warnings:
+  ${r.join("\n  ")}`),"dev"===this.mode&&e.debug("Shutdown complete")}}

package/dist/phoenix/services/signed-in-development-environment.js

@@ -1 +1 @@
-import{createApiBaseClient as e}from"#package/client";import{getServerCredentials as o}from"./cli-credentials.js";export const resolveSignedInDevelopmentEnvironment=async n=>{let{serverUrl:r,project:t}=n,i=await o(r);if(!i)throw Error(`phoenix dev has no development key and you are not signed in to ${r}. Run \`phoenix login <workspace>\`, or paste the .env block of a Studio development environment into .env.`);let{data:a,error:p}=await e(r).POST("/environments/development/resolve",{body:{project:t},headers:{authorization:`Bearer ${i.token}`}});if(p||!a)throw Error(`The server did not provide a development environment for project "${t}" in workspace "${i.customerSlug}" on ${r}: ${p?.message??"no response"}`);return{apiToken:i.token,workspaceName:i.customerName,projectSlug:a.projectSlug,environmentSlug:a.environmentSlug}};
+import{createApiBaseClient as e}from"#package/client";import{getServerCredentials as o}from"./cli-credentials.js";export const resolveSignedInDevelopmentEnvironment=async n=>{let{serverUrl:r,project:t}=n,i=await o(r);if(!i)throw Error(`phoenix dev has no development key and you are not signed in to ${r}. Run \`phoenix login\`, or paste the .env block of a Studio development environment into .env.`);let{data:a,error:p}=await e(r).POST("/environments/development/resolve",{body:{project:t},headers:{authorization:`Bearer ${i.token}`}});if(p||!a)throw Error(`The server did not provide a development environment for project "${t}" in workspace "${i.customerSlug??"your current projects"}" on ${r}: ${p?.message??"no response"}`);return{apiToken:i.token,workspaceName:i.customerName??a.projectSlug,projectSlug:a.projectSlug,environmentSlug:a.environmentSlug}};

package/dist/phoenix/services/source-archive.d.ts

@@ -4,6 +4,8 @@ export interface SourceArchive {
     readonly fileCount: number;
     readonly size: number;
     readonly hasConversationLog: boolean;
+    /** Regular files packed from the project's `docs/` folder, which travel privately and are never published. */
+    readonly documentFileCount: number;
     readonly cleanup: () => Promise<void>;
 }
 /** What `extractSourceArchive` wrote and what it left out. */

package/dist/phoenix/services/source-archive.js

@@ -1 +1 @@
-import{execFile as e}from"node:child_process";import{createReadStream as r,createWriteStream as t}from"node:fs";import{lstat as o,mkdir as i,mkdtemp as a,readdir as n,rm as s,stat as c,writeFile as l}from"node:fs/promises";import{tmpdir as h}from"node:os";import{dirname as p,join as f}from"node:path";import{Transform as d}from"node:stream";import{pipeline as w}from"node:stream/promises";import{promisify as m}from"node:util";import{createGunzip as u}from"node:zlib";import{extract as g}from"tar-stream";import{isProjectFile as y,listProjectEntries as v}from"../application-spec/project-files.js";let x=m(e);export const createSourceArchive=async e=>{let r=(await n(e)).includes("conversation.log"),t=[...await v(e),...r?["conversation.log"]:[]],i=await Promise.all(t.map(async r=>({name:r,entry:await o(f(e,r))})));if(i.some(({name:e,entry:r})=>"conversation.log"===e&&r.isDirectory()))throw Error("conversation.log is a directory. Replace it with a regular transcript file and deploy again.");let p=i.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),d=i.filter(({entry:e})=>e.isFile()).map(({name:e})=>e);if(p.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${p.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(0===d.length)throw Error(`No project files were found in ${e}, so there is nothing to deploy. Run phoenix deploy in the folder of an application-spec project.`);let w=await a(f(h(),"phoenix-deploy-")),m="sources.tgz",u=f(w,m),g=f(w,"files");try{await l(g,d.join("\0")),await x("tar",["-czf",m,"-C",e,"--null","-T",g],{cwd:w,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(w,{recursive:!0,force:!0});let e=r instanceof Error?r.message:String(r);throw Error(`Packing the project with tar failed: ${e}. Check that tar is installed and on the PATH.`)}return{path:u,fileCount:d.length,size:(await c(u)).size,hasConversationLog:r,cleanup:()=>s(w,{recursive:!0,force:!0})}};let E=(e,...r)=>e instanceof Error&&"code"in e&&"string"==typeof e.code&&r.includes(e.code),j=async e=>{try{return 0===(await n(e)).length}catch(e){if(E(e,"ENOENT"))return!0;throw e}},T=class ArchiveRefusal extends Error{},b=e=>e.length>0&&!e.startsWith("/")&&!e.includes("\\")&&!/^[A-Za-z]:/.test(e)&&!/[\x00-\x1f\x7f]/.test(e)&&!e.split("/").includes("..");export const extractSourceArchive=async e=>{let o,a,{archivePath:n,targetDir:l}=e,h=(await c(n)).size;if(h>0xc800000)throw Error(`The source archive is ${h} bytes, over the 209715200 byte limit. Remove large files from the project and deploy again.`);if(!await j(l))throw Error(`The folder ${l} is not empty, and extracted sources must not mix with existing files. Extract into a new or empty folder.`);let m=g(),v=new AbortController,x=w(r(n),u(),(a=0,new d({transform(e,r,t){(a+=e.length)>0x40000000?t(new T("The source archive extracts to more than 1073741824 bytes. Remove large files from the project and deploy again.")):t(null,e)}})),m).catch(e=>{o??=e,v.abort()}),$=[],R=0,z=0;try{for await(let e of m){let{type:r}=e.header,o=e.header.name.replace(/^(\.\/)+/,""),a=JSON.stringify(o);if("directory"===r){e.resume();continue}if((z+=1)>1e5)throw new T("The source archive has more than 100000 files. Remove generated or unused files from the project and deploy again.");if(!b(o))throw new T(`The source archive contains ${a}, which is not a plain relative path inside the project. Pack the project with phoenix deploy.`);if("file"!==r)throw new T(`The source archive contains ${a}, which is a ${r??"special file"}. Builds accept only regular files; replace it with a regular file and deploy again.`);if(!y(o)){$.push(o),e.resume();continue}let n=f(l,...o.split("/"));try{await i(p(n),{recursive:!0}),await w(e,t(n,{flags:"wx"}),{signal:v.signal})}catch(e){if(E(e,"EEXIST","ENOTDIR","EISDIR"))throw new T(`The source archive contains ${a}, which repeats or collides with an earlier entry, so its content is ambiguous. Pack the project with phoenix deploy.`);throw e}R+=1}if(await x,void 0!==o)throw o}catch(t){let e=t instanceof T?t:o??t;if(m.destroy(),await x,await s(l,{recursive:!0,force:!0}),e instanceof T)throw e;let r=e instanceof Error?e.message:String(e);throw Error(`The source archive could not be read: ${r}. It is truncated or not a gzip tarball; pack the project with phoenix deploy.`)}return{fileCount:R,skipped:$}};
+import{execFile as e}from"node:child_process";import{createReadStream as r,createWriteStream as t}from"node:fs";import{lstat as o,mkdir as i,mkdtemp as a,readdir as n,rm as s,stat as c,writeFile as l}from"node:fs/promises";import{tmpdir as h}from"node:os";import{dirname as p,join as f}from"node:path";import{Transform as d}from"node:stream";import{pipeline as w}from"node:stream/promises";import{promisify as m}from"node:util";import{createGunzip as u}from"node:zlib";import{extract as g}from"tar-stream";import{isProjectFile as y,listProjectDocumentEntries as v,listProjectEntries as x,listProjectWorkspaceEntries as E}from"../application-spec/index.js";let j=m(e);export const createSourceArchive=async e=>{let r=(await n(e)).includes("conversation.log"),t=await x(e),i=await E(e),p=await v(e),d=[...t,...i,...p,...r?["conversation.log"]:[]],w=await Promise.all(d.map(async r=>({name:r,entry:await o(f(e,r))})));if(w.some(({name:e,entry:r})=>"conversation.log"===e&&r.isDirectory()))throw Error("conversation.log is a directory. Replace it with a regular transcript file and deploy again.");let m=w.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),u=w.filter(({entry:e})=>e.isFile()).map(({name:e})=>e),g=new Set(p);if(m.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${m.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(!u.some(y))throw Error(`No project files were found in ${e}, so there is nothing to deploy. Run phoenix deploy in the folder of an application-spec project.`);let T=await a(f(h(),"phoenix-deploy-")),b="sources.tgz",$=f(T,b),R=f(T,"files");try{await l(R,u.join("\0")),await j("tar",["-czf",b,"-C",e,"--null","-T",R],{cwd:T,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(T,{recursive:!0,force:!0});let e=r instanceof Error?r.message:String(r);throw Error(`Packing the project with tar failed: ${e}. Check that tar is installed and on the PATH.`)}return{path:$,fileCount:u.length,size:(await c($)).size,hasConversationLog:r,documentFileCount:u.filter(e=>g.has(e)).length,cleanup:()=>s(T,{recursive:!0,force:!0})}};let T=(e,...r)=>e instanceof Error&&"code"in e&&"string"==typeof e.code&&r.includes(e.code),b=async e=>{try{return 0===(await n(e)).length}catch(e){if(T(e,"ENOENT"))return!0;throw e}},$=class ArchiveRefusal extends Error{},R=e=>e.length>0&&!e.startsWith("/")&&!e.includes("\\")&&!/^[A-Za-z]:/.test(e)&&!/[\x00-\x1f\x7f]/.test(e)&&!e.split("/").includes("..");export const extractSourceArchive=async e=>{let o,a,{archivePath:n,targetDir:l}=e,h=(await c(n)).size;if(h>0xc800000)throw Error(`The source archive is ${h} bytes, over the 209715200 byte limit. Remove large files from the project and deploy again.`);if(!await b(l))throw Error(`The folder ${l} is not empty, and extracted sources must not mix with existing files. Extract into a new or empty folder.`);let m=g(),v=new AbortController,x=w(r(n),u(),(a=0,new d({transform(e,r,t){(a+=e.length)>0x40000000?t(new $("The source archive extracts to more than 1073741824 bytes. Remove large files from the project and deploy again.")):t(null,e)}})),m).catch(e=>{o??=e,v.abort()}),E=[],j=0,S=0;try{for await(let e of m){let{type:r}=e.header,o=e.header.name.replace(/^(\.\/)+/,""),a=JSON.stringify(o);if("directory"===r){e.resume();continue}if((S+=1)>1e5)throw new $("The source archive has more than 100000 files. Remove generated or unused files from the project and deploy again.");if(!R(o))throw new $(`The source archive contains ${a}, which is not a plain relative path inside the project. Pack the project with phoenix deploy.`);if("file"!==r)throw new $(`The source archive contains ${a}, which is a ${r??"special file"}. Builds accept only regular files; replace it with a regular file and deploy again.`);if(!y(o)){E.push(o),e.resume();continue}let n=f(l,...o.split("/"));try{await i(p(n),{recursive:!0}),await w(e,t(n,{flags:"wx"}),{signal:v.signal})}catch(e){if(T(e,"EEXIST","ENOTDIR","EISDIR"))throw new $(`The source archive contains ${a}, which repeats or collides with an earlier entry, so its content is ambiguous. Pack the project with phoenix deploy.`);throw e}j+=1}if(await x,void 0!==o)throw o}catch(t){let e=t instanceof $?t:o??t;if(m.destroy(),await x,await s(l,{recursive:!0,force:!0}),e instanceof $)throw e;let r=e instanceof Error?e.message:String(e);throw Error(`The source archive could not be read: ${r}. It is truncated or not a gzip tarball; pack the project with phoenix deploy.`)}return{fileCount:j,skipped:E}};

package/dist/phoenix/services/swc.d.ts

@@ -1,16 +1,17 @@
 import { type Logger } from '../utils/index.js';
 export interface SwcCompileProps {
-    readonly sourceDir?: string;
-    readonly outDir?: string;
+    readonly sourceDir: string;
+    readonly outDir: string;
+    readonly ignoredPaths: readonly string[];
 }
-export declare const compileWithSwc: (props?: SwcCompileProps, context?: {
+export declare const compileWithSwc: (props: SwcCompileProps, context?: {
     readonly logger: Logger;
 }) => Promise<void>;
 /**
  * Watch mode for SWC compilation
  * Watches for changes in TypeScript files and non-compilable files
  */
-export declare const watchWithSwc: (props?: SwcCompileProps, context?: {
+export declare const watchWithSwc: (props: SwcCompileProps, context?: {
     readonly logger: Logger;
 }) => Promise<{
     stop: () => Promise<void>;

package/dist/phoenix/services/swc.js

@@ -1,3 +1,3 @@
-import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as i}from"fs/promises";import{globby as r}from"globby";import{dirname as c,relative as l,resolve as n}from"path";import{Subject as p}from"rxjs";import{watch as m}from"#package/watch";import{createLogger as w}from"../utils/index.js";let u=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[["@lingui/swc-plugin",{}]]}}}),d=async(e,t,a)=>{let i=process.cwd(),p=n(i,e),m=n(i,t),w=await r(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:p,ignore:["**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json"],absolute:!1}),u=0,d=0;for(let e of w)try{let t=n(p,e),a=n(m,e);await o(c(a),{recursive:!0}),await s(t,a),u++}catch(t){d++,console.error(`Failed to copy ${l(i,n(p,e))}:`,t)}if(d>0)throw Error(`Failed to copy ${d} file(s)`);u>0&&a.debug(`Copied ${u} non-compilable file(s)`)};export const compileWithSwc=async(s,p)=>{let{sourceDir:m="src",outDir:f="./node_modules/.phoenix"}=s??{},g=p?.logger??w(),h=process.cwd(),x=n(h,m),_=n(h,f);await t(_);let y=await r(["**/*.{ts,tsx}"],{cwd:x,ignore:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),b=u(),$=0,j=0;for(let t of y)try{let s=n(x,t),r=n(_,t.replace(/\.tsx?$/,".js")),l=await a(s,"utf-8"),p=await e(l,{...b,filename:s,sourceMaps:!0,outputPath:r});await o(c(r),{recursive:!0}),await i(r,p.code,"utf-8"),p.map&&await i(`${r}.map`,p.map,"utf-8"),$++}catch(e){j++,console.error(`Failed to compile ${l(h,n(x,t))}:`,e)}if(j>0)throw Error(`Failed to compile ${j} file(s)`);g.isDebug&&g.debug(`Compiled ${$} file(s) with swc`),await d(m,f,g)};let f=async(t,s,r)=>{let l=process.cwd(),p=n(l,s),m=n(l,r),w=u(),d=n(p,t),f=n(m,t.replace(/\.tsx?$/,".js")),g=await a(d,"utf-8"),h=await e(g,{...w,filename:d,sourceMaps:!0,outputPath:f});await o(c(f),{recursive:!0}),await i(f,h.code,"utf-8"),h.map&&await i(`${f}.map`,h.map,"utf-8")},g=async(e,t,a)=>{let i=process.cwd(),r=n(i,t),l=n(i,a),p=n(r,e),m=n(l,e);await o(c(m),{recursive:!0}),await s(p,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s="src",outDir:o="./node_modules/.phoenix"}=e??{},a=t?.logger??w(),i=n(process.cwd(),s);a.isDebug&&a.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o},t),a.isDebug&&a.success("Initial compilation complete");let r=new p,c=m(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:i,ignored:["**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return c.on("all",(e,t)=>{("change"===e||"add"===e)&&r.next({file:t,type:e})}),r.subscribe(async({file:e})=>{let t=l(i,n(i,e));try{e.match(/\.tsx?$/)?(await f(t,s,o),a.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await g(t,s,o),a.fileChanged(t))}catch(e){a.error(`Failed to process ${t}`),a.isDebug&&console.error(e)}}),a.isDebug&&console.log(`
+import{transform as e}from"@swc/core";import{remove as t}from"fs-extra";import{copyFile as s,mkdir as o,readFile as a,writeFile as r}from"fs/promises";import{globby as i}from"globby";import{createRequire as c}from"node:module";import{dirname as l,relative as n,resolve as p}from"path";import{Subject as m}from"rxjs";import{watch as w}from"#package/watch";import{createLogger as u}from"../utils/index.js";let d=()=>({sourceMaps:!0,module:{type:"es6"},jsc:{target:"es2022",parser:{syntax:"typescript",tsx:!0},transform:{react:{runtime:"automatic"}},keepClassNames:!0,experimental:{plugins:[[c(import.meta.url).resolve("@lingui/swc-plugin"),{}]],cacheRoot:"node_modules/.cache/swc"}}}),f=async(e,t,a,r)=>{let c=process.cwd(),m=p(c,e),w=p(c,t),u=await i(["**/*.{html,css,json,txt,md}","**/.env*"],{cwd:m,ignore:[...a,"**/*.{spec,test}.{html,css,json,txt,md}","**/__tests__/**","**/__mocks__/**","**/tsconfig.json",".env.generated"],absolute:!1}),d=0,f=0;for(let e of u)try{let t=p(m,e),a=p(w,e);await o(l(a),{recursive:!0}),await s(t,a),d++}catch(t){f++,console.error(`Failed to copy ${n(c,p(m,e))}:`,t)}if(f>0)throw Error(`Failed to copy ${f} file(s)`);d>0&&r.debug(`Copied ${d} non-compilable file(s)`)};export const compileWithSwc=async(s,c)=>{let{sourceDir:m,outDir:w,ignoredPaths:g}=s,h=c?.logger??u(),_=process.cwd(),x=p(_,m),y=p(_,w);await t(y);let b=await i(["**/*.{ts,tsx}"],{cwd:x,ignore:[...g,"**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/__mocks__/**"],absolute:!1}),$=d(),j=0,v=0;for(let t of b)try{let s=p(x,t),i=p(y,t.replace(/\.tsx?$/,".js")),c=await a(s,"utf-8"),n=await e(c,{...$,filename:s,sourceMaps:!0,outputPath:i});await o(l(i),{recursive:!0}),await r(i,n.code,"utf-8"),n.map&&await r(`${i}.map`,n.map,"utf-8"),j++}catch(e){v++,console.error(`Failed to compile ${n(_,p(x,t))}:`,e)}if(v>0)throw Error(`Failed to compile ${v} file(s)`);h.isDebug&&h.debug(`Compiled ${j} file(s) with swc`),await f(m,w,g,h)};let g=async(t,s,i)=>{let c=process.cwd(),n=p(c,s),m=p(c,i),w=d(),u=p(n,t),f=p(m,t.replace(/\.tsx?$/,".js")),g=await a(u,"utf-8"),h=await e(g,{...w,filename:u,sourceMaps:!0,outputPath:f});await o(l(f),{recursive:!0}),await r(f,h.code,"utf-8"),h.map&&await r(`${f}.map`,h.map,"utf-8")},h=async(e,t,a)=>{let r=process.cwd(),i=p(r,t),c=p(r,a),n=p(i,e),m=p(c,e);await o(l(m),{recursive:!0}),await s(n,m)};export const watchWithSwc=async(e,t)=>{let{sourceDir:s,outDir:o,ignoredPaths:a}=e,r=t?.logger??u(),i=p(process.cwd(),s);r.isDebug&&r.step("Running initial SWC compilation"),await compileWithSwc({sourceDir:s,outDir:o,ignoredPaths:a},t),r.isDebug&&r.success("Initial compilation complete");let c=new m,l=w(["**/*.{ts,tsx,html,css,json,txt,md}","../.env*"],{cwd:i,ignored:[...a,"**/*.{spec,test}.{ts,tsx}","**/__tests__/**","**/cache.json"],persistent:!0,ignoreInitial:!0});return l.on("all",(e,t)=>{("change"===e||"add"===e)&&c.next({file:t,type:e})}),c.subscribe(async({file:e})=>{let t=n(i,p(i,e));try{e.match(/\.tsx?$/)?(await g(t,s,o),r.fileChanged(t)):(e.match(/\.(html|css|json|txt|md)$/)||e.match(/\.env/))&&(await h(t,s,o),r.fileChanged(t))}catch(e){r.error(`Failed to process ${t}`),r.isDebug&&console.error(e)}}),r.isDebug&&console.log(`
 👀 Watching ${s} for changes...
-`),{stop:async()=>{await c.close(),a.isDebug&&a.info("SWC watcher stopped")}}};
+`),{stop:async()=>{await l.close(),r.isDebug&&r.info("SWC watcher stopped")}}};

package/dist/phoenix/services/telemetry/amplitude-telemetry-transport.d.ts

@@ -0,0 +1,9 @@
+import type { TelemetryEvent } from './telemetry-event.js';
+export interface TelemetryTransport {
+    readonly send: (events: readonly TelemetryEvent[], timeoutMs: number) => Promise<void>;
+}
+interface AmplitudeTelemetryTransportContext {
+    readonly fetch: typeof fetch;
+}
+export declare const createAmplitudeTelemetryTransport: (context?: AmplitudeTelemetryTransportContext) => TelemetryTransport;
+export {};

package/dist/phoenix/services/telemetry/amplitude-telemetry-transport.js

@@ -0,0 +1 @@
+let e=e=>({event_type:e.name,device_id:e.deviceId,...void 0===e.userId?{}:{user_id:e.userId},insert_id:e.eventId,time:e.occurredAt.getTime(),event_properties:e.properties}),t=e=>429===e.status||e.status>=500;export const createAmplitudeTelemetryTransport=(r={fetch})=>({send:async(a,i)=>{if(0===a.length)return;let n=new AbortController,o=setTimeout(()=>n.abort(),i),s=JSON.stringify({api_key:"46b8fa9ce868c9da04f8ad2b6715a2f7",events:a.map(e)});try{for(let e=0;e<2;e+=1)try{let e=await r.fetch("https://api2.amplitude.com/2/httpapi",{method:"POST",headers:{"content-type":"application/json"},body:s,signal:n.signal});if(await e.body?.cancel(),e.ok||!t(e))return}catch{if(n.signal.aborted)return}}finally{n.abort(),clearTimeout(o)}}});

package/dist/phoenix/services/telemetry/index.d.ts

@@ -0,0 +1,3 @@
+export { createTelemetryClient, type CommandTelemetryAttempt, type TelemetryClient } from './telemetry-client.js';
+export { resolveTelemetryCommand, type TelemetryCommand } from './telemetry-command.js';
+export type { TelemetryAssociation } from './telemetry-state.js';

package/dist/phoenix/services/telemetry/index.js

@@ -0,0 +1 @@
+export{createTelemetryClient}from"./telemetry-client.js";export{resolveTelemetryCommand}from"./telemetry-command.js";

package/dist/phoenix/services/telemetry/telemetry-client.d.ts

@@ -0,0 +1,25 @@
+import { type TelemetryTransport } from './amplitude-telemetry-transport.js';
+import type { TelemetryCommand } from './telemetry-command.js';
+import { type TelemetryFailureCategory, type TelemetryOutcome } from './telemetry-event.js';
+import { type TelemetryAssociation, type TelemetryIdentity } from './telemetry-state.js';
+export interface CommandTelemetryAttempt {
+    readonly ready: () => void;
+    readonly complete: (outcome: TelemetryOutcome, failureCategory?: TelemetryFailureCategory) => void;
+}
+export interface TelemetryClient {
+    readonly startCommandAttempt: (command: TelemetryCommand) => CommandTelemetryAttempt;
+    readonly identify: (association: TelemetryAssociation) => Promise<void>;
+    readonly flush: () => Promise<void>;
+}
+interface CreateTelemetryClientProps {
+    readonly sdkVersion: string;
+}
+interface TelemetryClientContext {
+    readonly createId: () => string;
+    readonly loadIdentity: () => Promise<TelemetryIdentity>;
+    readonly now: () => Date;
+    readonly saveAssociation: (identity: TelemetryIdentity, association: TelemetryAssociation) => Promise<void>;
+    readonly transport: TelemetryTransport;
+}
+export declare const createTelemetryClient: (props: CreateTelemetryClientProps, context?: TelemetryClientContext) => Promise<TelemetryClient>;
+export {};

package/dist/phoenix/services/telemetry/telemetry-client.js

@@ -0,0 +1 @@
+import{randomUUID as t}from"node:crypto";import{createAmplitudeTelemetryTransport as e}from"./amplitude-telemetry-transport.js";import{createCommandEvent as r}from"./telemetry-event.js";import{loadTelemetryIdentity as o,saveTelemetryAssociation as n}from"./telemetry-state.js";let a={ready:()=>void 0,complete:()=>void 0},s={startCommandAttempt:()=>a,identify:async()=>void 0,flush:async()=>void 0};export const createTelemetryClient=async(a,i={createId:t,loadIdentity:o,now:()=>new Date,saveAssociation:n,transport:e()})=>{if("1"===process.env.PHOENIX_TELEMETRY_DISABLED)return s;try{var d;let t,e;return d=await i.loadIdentity(),t=[],e=d,{startCommandAttempt:o=>{let n=i.createId(),s=i.now(),d=!1,c=!1;return t=[...t,r({identity:e,sdkVersion:a.sdkVersion,command:o,attemptId:n,phase:"started",outcome:"unknown",occurredAt:s},i)],{ready:()=>{if("dev"!==o||c||d)return;c=!0;let m=i.now();t=[...t,r({identity:e,sdkVersion:a.sdkVersion,command:o,attemptId:n,phase:"ready",outcome:"unknown",occurredAt:m,durationMs:Math.max(0,m.getTime()-s.getTime())},i)]},complete:(c,m)=>{if(d)return;d=!0;let u=i.now();t=[...t,r({identity:e,sdkVersion:a.sdkVersion,command:o,attemptId:n,phase:"completed",outcome:c,occurredAt:u,durationMs:Math.max(0,u.getTime()-s.getTime()),failureCategory:m},i)]}}},identify:async t=>{e={...e,...t};try{await i.saveAssociation(e,t)}catch{return}},flush:async()=>{let e=t;t=[];try{await i.transport.send(e,1e3)}catch{return}}}}catch{return s}};

package/dist/phoenix/services/telemetry/telemetry-command.d.ts

@@ -0,0 +1,2 @@
+export type TelemetryCommand = 'build' | 'changelog' | 'check' | 'clean' | 'deploy' | 'deployment:activate' | 'deployment:build-envs' | 'deployment:extract-sources' | 'deployment:finish' | 'deployment:prepare' | 'deployment:prepare-dev' | 'deployment:prepare-local' | 'deployment:register' | 'dev' | 'docs' | 'environment:cleanup' | 'environment:create' | 'environment:list' | 'feedback' | 'fix' | 'init' | 'inspect:assets' | 'inspect:data' | 'inspect:scene' | 'inspect:state' | 'link' | 'login' | 'logout' | 'prepare:ci' | 'screenshot' | 'story' | 'sync' | 'unlink' | 'variants';
+export declare const resolveTelemetryCommand: (arguments_: readonly string[]) => TelemetryCommand | null;

package/dist/phoenix/services/telemetry/telemetry-command.js

@@ -0,0 +1 @@
+let e={b:"build",build:"build",c:"check",changelog:"changelog",check:"check",ci:"prepare:ci",cl:"clean",clean:"clean",clog:"changelog",d:"dev",da:"deployment:activate",dbe:"deployment:build-envs",deploy:"deploy","dep:activate":"deployment:activate","dep:build-envs":"deployment:build-envs","dep:finish":"deployment:finish","dep:prepare":"deployment:prepare","dep:prepare-dev":"deployment:prepare-dev","dep:prepare-local":"deployment:prepare-local","dep:register":"deployment:register","deployment:activate":"deployment:activate","deployment:build-envs":"deployment:build-envs","deployment:extract-sources":"deployment:extract-sources","deployment:finish":"deployment:finish","deployment:prepare":"deployment:prepare","deployment:prepare-dev":"deployment:prepare-dev","deployment:prepare-local":"deployment:prepare-local","deployment:register":"deployment:register",dev:"dev",df:"deployment:finish",doc:"docs",docs:"docs",dp:"deployment:prepare",dpd:"deployment:prepare-dev",dpl:"deployment:prepare-local",dr:"deployment:register",ec:"environment:cleanup","env:cleanup":"environment:cleanup","env:create":"environment:create","env:list":"environment:list","environment:cleanup":"environment:cleanup","environment:create":"environment:create","environment:list":"environment:list",f:"fix",feedback:"feedback",fix:"fix",ia:"inspect:assets",id:"inspect:data",init:"init","inspect:assets":"inspect:assets","inspect:data":"inspect:data","inspect:scene":"inspect:scene","inspect:state":"inspect:state",is:"inspect:state",isc:"inspect:scene",l:"link",link:"link",login:"login",logout:"logout",pci:"prepare:ci","prepare:ci":"prepare:ci",s:"sync",screenshot:"screenshot",ss:"screenshot",st:"story",story:"story",sync:"sync",ul:"unlink",unlink:"unlink",variants:"variants"};export const resolveTelemetryCommand=n=>e[n[0]??""]??null;

package/dist/phoenix/services/telemetry/telemetry-event.d.ts

@@ -0,0 +1,44 @@
+import type { TelemetryCommand } from './telemetry-command.js';
+import type { TelemetryIdentity } from './telemetry-state.js';
+export type TelemetryOutcome = 'succeeded' | 'failed';
+export type TelemetryFailureCategory = 'command_failed';
+export type TelemetrySource = 'cli' | 'studio' | 'backend' | 'preview';
+export type TelemetryClassification = 'internal' | 'beta' | 'general' | 'unknown';
+export interface TelemetryEvent {
+    /** Unique event delivery identity, mapped to Amplitude's insert_id. */
+    readonly eventId: string;
+    readonly name: 'cli_command_started' | 'cli_dev_server_ready' | 'cli_command_completed';
+    readonly occurredAt: Date;
+    readonly deviceId: string;
+    readonly userId?: string;
+    readonly properties: {
+        readonly schema_version: 1;
+        readonly source: TelemetrySource;
+        readonly command: TelemetryCommand;
+        readonly attempt_id: string;
+        readonly phase: 'started' | 'ready' | 'completed';
+        readonly outcome: 'unknown' | TelemetryOutcome;
+        readonly duration_ms?: number;
+        readonly failure_category?: TelemetryFailureCategory;
+        readonly sdk_version: string;
+        readonly classification: TelemetryClassification;
+        readonly work_session_id: string;
+        readonly workspace_id?: string;
+    };
+}
+interface CreateCommandEventProps {
+    readonly identity: TelemetryIdentity;
+    readonly sdkVersion: string;
+    readonly command: TelemetryCommand;
+    readonly attemptId: string;
+    readonly phase: 'started' | 'ready' | 'completed';
+    readonly outcome: 'unknown' | TelemetryOutcome;
+    readonly occurredAt: Date;
+    readonly durationMs?: number;
+    readonly failureCategory?: TelemetryFailureCategory;
+}
+interface TelemetryEventContext {
+    readonly createId: () => string;
+}
+export declare const createCommandEvent: (props: CreateCommandEventProps, context: TelemetryEventContext) => TelemetryEvent;
+export {};

package/dist/phoenix/services/telemetry/telemetry-event.js

@@ -0,0 +1 @@
+export const createCommandEvent=(e,t)=>({eventId:t.createId(),name:"ready"===e.phase?"cli_dev_server_ready":"started"===e.phase?"cli_command_started":"cli_command_completed",occurredAt:e.occurredAt,deviceId:e.identity.installationId,..."userId"in e.identity?{userId:e.identity.userId}:{},properties:{schema_version:1,source:"cli",command:e.command,attempt_id:e.attemptId,phase:e.phase,outcome:e.outcome,...void 0===e.durationMs?{}:{duration_ms:e.durationMs},...void 0===e.failureCategory?{}:{failure_category:e.failureCategory},sdk_version:e.sdkVersion,classification:"userId"in e.identity?"general":"unknown",work_session_id:e.identity.workSessionId,..."workspaceId"in e.identity&&null!==e.identity.workspaceId?{workspace_id:e.identity.workspaceId}:{}}});

package/dist/phoenix/services/telemetry/telemetry-state.d.ts

@@ -0,0 +1,25 @@
+export interface AnonymousTelemetryIdentity {
+    /** Random identifier for one operating-system user profile, without machine or account data. */
+    readonly installationId: string;
+    /** Random identifier for CLI activity separated by less than thirty minutes. */
+    readonly workSessionId: string;
+}
+export interface TelemetryAssociation {
+    /** Stable authenticated builder user ID, mapped to Amplitude's user_id after authentication. */
+    readonly userId: string;
+    /** Internal UUID of the SDK-builder workspace the CLI authenticated against. */
+    readonly workspaceId: string | null;
+}
+export type TelemetryIdentity = AnonymousTelemetryIdentity | (AnonymousTelemetryIdentity & TelemetryAssociation);
+interface TelemetryStateContext {
+    readonly createId: () => string;
+    readonly now: () => Date;
+}
+export declare const getTelemetryStatePath: () => string;
+/**
+ * Loads the anonymous CLI identity and records current activity. Broken or unwritable state never blocks a command:
+ * the invocation gets an ephemeral identity, while an invalid existing file is left untouched for inspection.
+ */
+export declare const loadTelemetryIdentity: (context?: TelemetryStateContext) => Promise<TelemetryIdentity>;
+export declare const saveTelemetryAssociation: (identity: TelemetryIdentity, association: TelemetryAssociation) => Promise<void>;
+export {};

package/dist/phoenix/services/telemetry/telemetry-state.js

@@ -0,0 +1,2 @@
+import{randomUUID as t}from"node:crypto";import{chmod as e,mkdir as i,readFile as n,writeFile as a}from"node:fs/promises";import{homedir as s}from"node:os";import{dirname as r,join as o}from"node:path";import{z as d}from"zod";let l=d.object({installationId:d.string().uuid(),workSessionId:d.string().uuid(),lastActiveAt:d.string().datetime()}),c=d.union([l.extend({userId:d.string().min(5),workspaceId:d.string().uuid().nullable()}),l.strict()]),I={createId:t,now:()=>new Date};export const getTelemetryStatePath=()=>process.env.PHOENIX_TELEMETRY_FILE??o(s(),".phoenix","telemetry.json");let u=async(t,n)=>{await i(r(t),{recursive:!0,mode:448}),await a(t,`${JSON.stringify(n,null,2)}
+`,{mode:384}),await e(t,384)},w=async t=>{let e;try{e=await n(t,"utf8")}catch(t){return t instanceof Error&&"code"in t&&"ENOENT"===t.code?{kind:"missing"}:{kind:"invalid"}}try{let t=c.safeParse(JSON.parse(e));return t.success?{kind:"valid",state:t.data}:{kind:"invalid"}}catch{return{kind:"invalid"}}};export const loadTelemetryIdentity=async(t=I)=>{let e=getTelemetryStatePath(),i=await w(e),n="valid"===i.kind?i.state:null,a=t.now(),s=null===n?null:Date.parse(n.lastActiveAt),r=null===s||a.getTime()-s>=18e5,o=null===n?{installationId:t.createId(),workSessionId:t.createId(),lastActiveAt:a.toISOString()}:{...n,workSessionId:r?t.createId():n.workSessionId,lastActiveAt:a.toISOString()};try{"invalid"!==i.kind&&await u(e,o)}catch{return{installationId:o.installationId,workSessionId:o.workSessionId}}return{installationId:o.installationId,workSessionId:o.workSessionId,..."userId"in o&&"workspaceId"in o?{userId:o.userId,workspaceId:o.workspaceId}:{}}};export const saveTelemetryAssociation=async(t,e)=>{let i=getTelemetryStatePath(),n=await w(i);"valid"===n.kind&&n.state.installationId===t.installationId&&n.state.workSessionId===t.workSessionId&&await u(i,{...n.state,...e})};