@salsita-ai/sdk 0.0.0-stage → 0.49.0-develop.cbee856178

package/dist/phoenix/services/console-capture.js

@@ -0,0 +1 @@
+import{format as o}from"node:util";import{webhookLogContext as e}from"../webhooks/index.js";let r=["log","info","warn","error","debug"],n={log:"info",info:"info",warn:"warn",error:"error",debug:"debug"};export const patchConsole=(t,l={})=>{let f=l.echo??!1,s=r.map(o=>[o,console[o]]);for(let[r,l]of s)console[r]=(...s)=>{let i="webhook"===e.getStore()?"webhook":"other";t.push(i,n[r],o(...s)),f&&l.apply(console,s)};return()=>{for(let[o,e]of s)console[o]=e}};

package/dist/phoenix/services/development-credential.d.ts

@@ -0,0 +1,18 @@
+/**
+ * What authenticates `phoenix dev` against its development environment: the environment's development key from
+ * Studio, or the API token of a signed-in user, which the server accepts for that user's own environment.
+ */
+export type DevelopmentCredential = {
+    readonly developmentKey: string;
+} | {
+    readonly apiToken: string;
+};
+interface DevelopmentEnvironmentRef {
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+}
+/** What to do when the server refuses the credential for a development environment. */
+export declare const getDevelopmentCredentialHint: (credential: DevelopmentCredential, projectSlug: string) => string;
+/** The headers the server's development routes read to authenticate a request and find its environment. */
+export declare const getDevelopmentHeaders: (credential: DevelopmentCredential, environment: DevelopmentEnvironmentRef) => Record<string, string>;
+export {};

package/dist/phoenix/services/development-credential.js

@@ -0,0 +1 @@
+export const getDevelopmentCredentialHint=(e,n)=>"developmentKey"in e?`Create a development environment for project "${n}" in Studio and paste its .env block into .env.`:"Run `phoenix login <workspace>` again if the sign-in was revoked, then restart phoenix dev.";export const getDevelopmentHeaders=(e,n)=>({..."developmentKey"in e?{"x-development-key":e.developmentKey}:{authorization:`Bearer ${e.apiToken}`},"x-project-slug":n.projectSlug,"x-environment-slug":n.environmentSlug});

package/dist/phoenix/services/frontend-config.d.ts

@@ -0,0 +1,19 @@
+interface FrontendBuildConfig {
+    readonly jsonSchemaValidator: 'ajv' | 'csp-compatible';
+    readonly gltfDecoder: 'js' | 'wasm';
+}
+export interface FrontendConfigModule {
+    readonly readRuntimeConfig: () => Record<string, unknown>;
+    readonly frontendBuildConfig: FrontendBuildConfig;
+}
+export declare const loadFrontendConfigModule: () => FrontendConfigModule;
+/**
+ * Reads frontend env vars from .env + .env.generated via the generated frontend.config.ts.
+ *
+ * Returns `{}` when the config file is missing — this happens on the first sync of an
+ * empty project, since frontend.config.ts is itself generated by the application-spec
+ * pipeline. Envs are only consumed downstream for runtime validation, so the initial
+ * parse can safely proceed without them.
+ */
+export declare const readFrontendEnvs: () => Record<string, unknown>;
+export {};

package/dist/phoenix/services/frontend-config.js

@@ -0,0 +1 @@
+import{existsSync as o}from"fs";import{createJiti as t}from"jiti";import{resolve as n}from"path";let r=()=>n(process.cwd(),"./.phoenix/frontend.config.ts");export const loadFrontendConfigModule=()=>t(import.meta.url,{interopDefault:!0})(r());export const readFrontendEnvs=()=>o(r())?{...loadFrontendConfigModule().readRuntimeConfig()}:{};

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

@@ -0,0 +1,18 @@
+export type { BrowserConsoleEvent, DataRequest, DataResult, EditorContextData, EditorLifecycleStatus, EditorStateData, MockTemplateUpdateEvent, SceneRequest, SceneResult, ScreenshotRequest, ScreenshotResult, SpecUpdateEvent, StateRequest, StateResult, StateSection, } from './phoenix-pubsub.js';
+export { PhoenixPubSub } from './phoenix-pubsub.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 { 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';
+export { patchConsole, type PatchConsoleOptions } from './console-capture.js';
+export { WebhookTunnelMonitor, type TunnelEvent, type TunnelRequestEntry, type TunnelRequestSummary, type TunnelStatus, type TunnelStatusState, } from './webhook-tunnel-monitor.js';
+export { compileWithSwc, watchWithSwc } from './swc.js';
+export { STORY_DEV_MARKER_PATH, readActiveStoryDevMarker, type StoryDevMarker } from './story-dev-marker.js';
+export { getViteBuildConfigs, getViteDevConfig, setViteLogSink, type ViteLogSink, type ViteLogSinkOptions, } 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';

package/dist/phoenix/services/index.js

@@ -0,0 +1 @@
+export{PhoenixPubSub}from"./phoenix-pubsub.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{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";

package/dist/phoenix/services/lingui-watcher.d.ts

@@ -0,0 +1,19 @@
+import type { Logger } from '../utils/index.js';
+export interface LinguiWatcherConfig {
+    readonly logger: Logger;
+}
+/** Watches project messages and keeps Lingui catalogs current during development. */
+export declare class LinguiWatcher {
+    private watcher;
+    private subscription;
+    private readonly runQueue;
+    private readonly changeSubject$;
+    private readonly logger;
+    private isShuttingDown;
+    constructor(config: LinguiWatcherConfig);
+    start(): void;
+    trigger(): void;
+    close(): Promise<void>;
+    private setupFileWatcher;
+    private setupRunSubscription;
+}

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

@@ -0,0 +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)}})})}}

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

@@ -0,0 +1,7 @@
+import { type Logger } from '../utils/index.js';
+interface LinguiCommandContext {
+    readonly logger: Logger;
+}
+export declare const compileLingui: (context: LinguiCommandContext) => Promise<void>;
+export declare const extractAndCompileLingui: (context: LinguiCommandContext) => Promise<void>;
+export {};

package/dist/phoenix/services/lingui.js

@@ -0,0 +1 @@
+import{runCommand as i}from"../utils/index.js";let n=async n=>{await i({command:"lingui",args:["extract"],description:"Extracting i18n messages",quiet:!0,extraEnv:{LC_ALL:"en_US.UTF-8"}},n)};export const compileLingui=async n=>{await i({command:"lingui",args:["compile"],description:"Compiling i18n messages",quiet:!0},n)};export const extractAndCompileLingui=async i=>{await n(i),await compileLingui(i)};

package/dist/phoenix/services/log-bus.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Origin of a dev-server log line. Every source in `phoenix dev` is attributed
+ * to exactly one stream so renderers (terminal TUI, editor Logs panel) can
+ * present them separately:
+ *
+ * - `spec` — CLI lifecycle and spec/project watcher output
+ * - `browser` — console messages forwarded from the browser-side editor
+ * - `webhook` — the development webhook tunnel and user webhook-handler output
+ * - `vite` — the Vite dev server
+ * - `other` — unattributed console output from libraries or stray writers
+ */
+export declare const LOG_STREAMS: readonly ['spec', 'browser', 'webhook', 'vite', 'other'];
+export type LogStream = (typeof LOG_STREAMS)[number];
+/** Severity of a log entry; mirrors the Logger interface methods. */
+export type LogLevel = 'debug' | 'detail' | 'info' | 'success' | 'warn' | 'error' | 'step';
+/** One line in the dev-server log buffer. */
+export interface LogEntry {
+    /** Monotonic position in the buffer; also the pagination cursor for query(). */
+    readonly seq: number;
+    readonly stream: LogStream;
+    readonly level: LogLevel;
+    readonly text: string;
+    /** Unix epoch milliseconds at push time. */
+    readonly time: number;
+}
+/** Backward page request: newest entries first when beforeSeq is omitted. */
+export interface LogQuery {
+    readonly stream: LogStream | 'all';
+    /** Return only entries older than this seq; omit for the newest page. */
+    readonly beforeSeq?: number;
+    readonly limit: number;
+}
+export interface LogPage {
+    readonly entries: readonly LogEntry[];
+    /** More matching entries exist in the buffer before this page. */
+    readonly hasMore: boolean;
+}
+/**
+ * Central in-memory sink for all `phoenix dev` log streams.
+ *
+ * Sources push attributed lines; renderers either subscribe for live entries
+ * (terminal TUI, editor subscription) or page backwards through the ring
+ * buffer on demand (editor Logs panel history). The buffer keeps the newest
+ * MAX_ENTRIES lines; per-stream counts are lifetime totals, not buffer sizes.
+ */
+export declare class LogBus {
+    private readonly emitter;
+    private readonly counts;
+    private entries;
+    private seq;
+    push(stream: LogStream, level: LogLevel, text: string): void;
+    all(): readonly LogEntry[];
+    forStream(stream: LogStream): readonly LogEntry[];
+    count(stream: LogStream): number;
+    allCounts(): Record<LogStream, number>;
+    query({ stream, beforeSeq, limit }: LogQuery): LogPage;
+    subscribe(listener: (entry: LogEntry) => void): () => void;
+}

package/dist/phoenix/services/log-bus.js

@@ -0,0 +1 @@
+import{EventEmitter as e}from"node:events";import{stripVTControlCharacters as t}from"node:util";export const LOG_STREAMS=["spec","browser","webhook","vite","other"];export class LogBus{emitter=new e().setMaxListeners(0);counts=new Map;entries=[];seq=0;push(e,s,r){let i=Date.now();for(let n of t(r).replace(/\ufe0f/g,"").replace(/^\n+|\n+$/g,"").split("\n")){let t={seq:++this.seq,stream:e,level:s,text:n,time:i};this.entries.push(t),this.counts.set(e,(this.counts.get(e)??0)+1),this.emitter.emit("entry",t)}this.entries.length>1e4&&(this.entries=this.entries.slice(-1e4))}all(){return this.entries}forStream(e){return this.entries.filter(t=>t.stream===e)}count(e){return this.counts.get(e)??0}allCounts(){return Object.fromEntries(LOG_STREAMS.map(e=>[e,this.count(e)]))}query({stream:e,beforeSeq:t,limit:s}){let r=this.entries.filter(s=>("all"===e||s.stream===e)&&(void 0===t||s.seq<t)),i=s>0?r.slice(-s):[];return{entries:i,hasMore:r.length>i.length}}subscribe(e){return this.emitter.on("entry",e),()=>{this.emitter.off("entry",e)}}}

package/dist/phoenix/services/mock-template-watcher.d.ts

@@ -0,0 +1,24 @@
+import type { Logger } from '../utils/index.js';
+import type { PhoenixPubSub } from './phoenix-pubsub.js';
+export interface MockTemplateWatcherConfig {
+    readonly projectRoot: string;
+    readonly pubsub: PhoenixPubSub;
+    readonly logger: Logger;
+}
+/**
+ * Watches mock template YAML files for changes and broadcasts updates
+ * to subscribers via PhoenixPubSub.mockTemplate$.
+ *
+ * Used by the editor server to keep the editor UI in sync with
+ * mock template files on disk (mocks\/**\/*.{yaml,yml}).
+ */
+export declare class MockTemplateWatcher {
+    private watcher;
+    private readonly handleChange;
+    private readonly pattern;
+    private readonly pubsub;
+    private readonly logger;
+    constructor(config: MockTemplateWatcherConfig);
+    start(): void;
+    close(): Promise<void>;
+}

package/dist/phoenix/services/mock-template-watcher.js

@@ -0,0 +1 @@
+import{convertPathToPattern as e}from"globby";import t from"lodash-es/debounce.js";import{watch as a}from"#package/watch";import{loadMockTemplates as s}from"./spec-files.js";export class MockTemplateWatcher{watcher=null;handleChange;pattern;pubsub;logger;constructor(a){this.pubsub=a.pubsub,this.logger=a.logger,this.pattern=`${e(a.projectRoot)}/mocks/**/*.{yaml,yml}`,this.handleChange=t(async()=>{this.logger.info("Mock template files changed, reloading...");let{templates:e}=await s(this.pattern,{logger:this.logger});this.logger.info(`Loaded ${e.length} mock template(s)`);let t=this.pubsub.mockTemplate$.observers.length;this.logger.debug(`Broadcasting to ${t} subscriber(s)`),this.pubsub.mockTemplate$.next({templates:e}),this.logger.debug("Mock template files reloaded and broadcasted")},50)}start(){this.watcher=a(this.pattern,{ignoreInitial:!0,persistent:!0}),this.watcher.on("change",e=>{this.logger.debug(`Mock template file changed: ${e}`),this.handleChange()}),this.watcher.on("add",e=>{this.logger.debug(`Mock template file added: ${e}`),this.handleChange()}),this.watcher.on("unlink",e=>{this.logger.debug(`Mock template file removed: ${e}`),this.handleChange()}),this.logger.debug("Watching mock template files: mocks/**/*.{yaml,yml}")}async close(){this.handleChange.cancel(),this.watcher&&(await this.watcher.close(),this.watcher=null)}}

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

@@ -0,0 +1,161 @@
+import { Subject } from 'rxjs';
+import type { RawProjectFiles } from '#package/application-spec';
+import type { MockTemplateDefinition } from '#package/editor';
+/** Batch of project files that changed on disk. */
+export interface SpecUpdateEvent {
+    readonly rawProjectFiles: RawProjectFiles;
+    readonly projectRoot: string;
+    readonly configurationSchemaHash?: string;
+}
+/** Updated set of mock template definitions after a file change. */
+export interface MockTemplateUpdateEvent {
+    readonly templates: readonly MockTemplateDefinition[];
+}
+/** Console message forwarded from the browser-side editor iframe. */
+export interface BrowserConsoleEvent {
+    readonly level: 'error' | 'warn' | 'info';
+    readonly message: string;
+    readonly source?: string;
+    readonly timestamp?: string;
+}
+/** CLI → browser request to capture a screenshot. */
+export interface ScreenshotRequest {
+    readonly requestId: string;
+    readonly width: number;
+    readonly height: number;
+    readonly fileFormat: 'PNG' | 'JPEG';
+}
+/** Browser → CLI response containing a captured screenshot. */
+export interface ScreenshotResult {
+    readonly requestId: string;
+    readonly imageBase64: string;
+    readonly fileFormat: 'PNG' | 'JPEG';
+}
+export type StateSection = 'entities' | 'navigation' | 'validation';
+/** CLI → browser request for editor state sections. */
+export interface StateRequest {
+    readonly requestId: string;
+    readonly sections: readonly StateSection[];
+}
+/** Browser → CLI response with editor state snapshot. */
+export interface StateResult {
+    readonly requestId: string;
+    readonly state: EditorStateData;
+}
+/** Readiness flags for each stage of the editor lifecycle. */
+export interface EditorLifecycleStatus {
+    readonly domainLoaded: boolean;
+    readonly domainContextReady: boolean;
+    readonly configuratorReady: boolean;
+    readonly sessionAuthenticated: boolean;
+    readonly editorMode: boolean;
+}
+/** Combined editor state: lifecycle flags + optional entity/navigation/validation sections. */
+export interface EditorStateData {
+    readonly lifecycle: EditorLifecycleStatus;
+    readonly entities: ReadonlyArray<Record<string, unknown>> | null;
+    readonly navigation: Record<string, unknown> | null;
+    readonly validation: Record<string, unknown> | null;
+}
+/** CLI → browser request for editor context data. */
+export interface DataRequest {
+    readonly requestId: string;
+}
+/** Browser → CLI response with editor context data. */
+export interface DataResult {
+    readonly requestId: string;
+    readonly data: EditorContextData;
+}
+/** CLI → browser request for the current 3D scene. */
+export interface SceneRequest {
+    readonly requestId: string;
+}
+/** Browser → CLI response with 3D scene data. */
+export interface SceneResult {
+    readonly requestId: string;
+    readonly scene: Record<string, unknown> | null;
+}
+/** All context data slices available from the editor. */
+export interface EditorContextData {
+    readonly publishedData: Record<string, unknown> | null;
+    readonly frontendData: Record<string, unknown> | null;
+    readonly backendData: Record<string, unknown> | null;
+    readonly sessionData: Record<string, unknown> | null;
+    readonly accessData: Record<string, unknown> | null;
+    readonly webComponentProperties: Record<string, unknown> | null;
+}
+/**
+ * Central event bus for editor↔browser communication during `phoenix dev`.
+ *
+ * Each pair of request$/result$ subjects implements a request-response pattern:
+ * the CLI publishes a request, the browser-side editor responds with a result
+ * carrying the same `requestId`.
+ */
+export declare class PhoenixPubSub {
+    /**
+     * Emitted when spec/expression files change on disk.
+     * Producers: ApplicationSpecProjectWatcher (on rebuild), requestSpecFiles procedure.
+     * Consumers: onSpecChange subscription (editor UI receives updated file list).
+     */
+    readonly specFile$: Subject<SpecUpdateEvent>;
+    /**
+     * Emitted when mock template YAML files are added, changed, or removed.
+     * Producers: editor-server file watcher, saveMock procedure.
+     * Consumers: onMockTemplateChange subscription (editor UI receives updated templates).
+     */
+    readonly mockTemplate$: Subject<MockTemplateUpdateEvent>;
+    /**
+     * Forwarded console messages from the browser-side editor.
+     * Producers: reportBrowserConsole procedure (called by editor iframe).
+     * Consumers: onBrowserConsole subscription (CLI logging / diagnostics).
+     */
+    readonly browserConsole$: Subject<BrowserConsoleEvent>;
+    /**
+     * CLI requests a screenshot from the browser-side editor.
+     * Producers: takeScreenshot procedure.
+     * Consumers: onScreenshotRequest subscription (ScreenshotHandler in editor).
+     */
+    readonly screenshotRequest$: Subject<ScreenshotRequest>;
+    /**
+     * Browser-side editor responds with a captured screenshot.
+     * Producers: submitScreenshot procedure (called by ScreenshotHandler).
+     * Consumers: takeScreenshot procedure (awaits matching requestId).
+     */
+    readonly screenshotResult$: Subject<ScreenshotResult>;
+    /**
+     * CLI requests editor state (entities, navigation, validation).
+     * Producers: getEditorState procedure.
+     * Consumers: onStateRequest subscription (StateHandler in editor).
+     */
+    readonly stateRequest$: Subject<StateRequest>;
+    /**
+     * Browser-side editor responds with current state snapshot.
+     * Producers: submitEditorState procedure (called by StateHandler).
+     * Consumers: getEditorState procedure (awaits matching requestId).
+     */
+    readonly stateResult$: Subject<StateResult>;
+    /**
+     * CLI requests editor context data (published, frontend, backend, session, access, web component props).
+     * Producers: getEditorData procedure.
+     * Consumers: onDataRequest subscription (DataHandler in editor).
+     */
+    readonly dataRequest$: Subject<DataRequest>;
+    /**
+     * Browser-side editor responds with context data.
+     * Producers: submitEditorData procedure (called by DataHandler).
+     * Consumers: getEditorData procedure (awaits matching requestId).
+     */
+    readonly dataResult$: Subject<DataResult>;
+    /**
+     * CLI requests the current 3D scene from the browser-side editor.
+     * Producers: getEditorScene procedure.
+     * Consumers: onSceneRequest subscription (SceneHandler in editor).
+     */
+    readonly sceneRequest$: Subject<SceneRequest>;
+    /**
+     * Browser-side editor responds with scene data.
+     * Producers: submitEditorScene procedure (called by SceneHandler).
+     * Consumers: getEditorScene procedure (awaits matching requestId).
+     */
+    readonly sceneResult$: Subject<SceneResult>;
+}

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

@@ -0,0 +1 @@
+import{Subject as e}from"rxjs";export class PhoenixPubSub{specFile$=new e;mockTemplate$=new e;browserConsole$=new e;screenshotRequest$=new e;screenshotResult$=new e;stateRequest$=new e;stateResult$=new e;dataRequest$=new e;dataResult$=new e;sceneRequest$=new e;sceneResult$=new e}

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

@@ -0,0 +1,18 @@
+/**
+ * The hosted Phoenix installations the CLI can sign in to. Each region has its own server and its own Studio domain,
+ * on which every workspace gets a subdomain.
+ */
+export declare const PHOENIX_REGIONS: readonly ['eu', 'us', 'staging'];
+export type PhoenixRegion = (typeof PHOENIX_REGIONS)[number];
+/**
+ * The regions offered to users as `--region`. Staging is internal: it is reachable only through the
+ * `PHOENIX_REGION` environment variable.
+ */
+export declare const PUBLIC_PHOENIX_REGIONS: readonly ["eu", "us"];
+export declare const DEFAULT_PHOENIX_REGION: PhoenixRegion;
+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;

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

@@ -0,0 +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}`};

package/dist/phoenix/services/phx-csp-nonce-plugin.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin } from 'vite';
+export interface CspNonceBundleChunk {
+    readonly type: 'chunk';
+    readonly fileName: string;
+    code: string;
+}
+export interface CspNonceBundleAsset {
+    readonly type: 'asset';
+    readonly fileName: string;
+}
+export type CspNonceBundleItem = CspNonceBundleChunk | CspNonceBundleAsset;
+export type CspNonceBundle = Record<string, CspNonceBundleItem>;
+export declare const cspNonceBootstrapCode = ";(function(){\n  if (typeof window === 'undefined' || typeof document === 'undefined') {\n    return;\n  }\n\n  var globalWindow = window;\n  var currentNonce = '';\n\n  if (typeof globalWindow.__phx_csp_nonce__ === 'string' && globalWindow.__phx_csp_nonce__.length > 0) {\n    currentNonce = globalWindow.__phx_csp_nonce__;\n  } else if (typeof globalWindow.__nonce__ === 'string' && globalWindow.__nonce__.length > 0) {\n    currentNonce = globalWindow.__nonce__;\n  }\n\n  var currentScript = document.currentScript;\n  if (!currentNonce && currentScript && typeof currentScript.nonce === 'string' && currentScript.nonce.length > 0) {\n    currentNonce = currentScript.nonce;\n  }\n\n  var nonceMeta = document.querySelector('meta[property=\"csp-nonce\"]');\n  if (\n    !currentNonce &&\n    nonceMeta &&\n    typeof nonceMeta.getAttribute === 'function'\n  ) {\n    var nonceFromMeta = nonceMeta.getAttribute('content');\n    if (typeof nonceFromMeta === 'string' && nonceFromMeta.length > 0) {\n      currentNonce = nonceFromMeta;\n    }\n  }\n\n  if (!currentNonce) {\n    var elements = document.getElementsByTagName('*');\n    for (var index = 0; index < elements.length; index += 1) {\n      var currentElement = elements[index];\n      var currentTagName = currentElement.tagName;\n      if (typeof currentTagName === 'string' && currentTagName.indexOf('SALSITA-') === 0) {\n        var nonceFromElement = currentElement.nonce;\n        if (typeof nonceFromElement === 'string' && nonceFromElement.length > 0) {\n          currentNonce = nonceFromElement;\n          break;\n        }\n      }\n    }\n  }\n\n  if (!currentNonce) {\n    return;\n  }\n\n  globalWindow.__phx_csp_nonce__ = currentNonce;\n  globalWindow.__nonce__ = currentNonce;\n\n  var head = document.head || document.getElementsByTagName('head')[0];\n  if (!head) {\n    return;\n  }\n\n  if (!nonceMeta) {\n    nonceMeta = document.createElement('meta');\n    nonceMeta.setAttribute('property', 'csp-nonce');\n    head.appendChild(nonceMeta);\n  }\n  nonceMeta.setAttribute('content', currentNonce);\n\n  var gooberStyle = document.getElementById('_goober');\n  if (!gooberStyle || gooberStyle.tagName !== 'STYLE') {\n    gooberStyle = document.createElement('style');\n    gooberStyle.id = '_goober';\n    gooberStyle.nonce = currentNonce;\n    gooberStyle.appendChild(document.createTextNode(' '));\n    head.appendChild(gooberStyle);\n  } else if (!gooberStyle.parentNode) {\n    head.appendChild(gooberStyle);\n  }\n\n  if (!gooberStyle.firstChild) {\n    gooberStyle.appendChild(document.createTextNode(' '));\n  }\n\n  gooberStyle.nonce = currentNonce;\n  globalWindow['_goober'] = gooberStyle;\n})();\n";
+export declare const prependCspNonceBootstrap: (code: string) => string;
+export declare const prependCspNonceBootstrapToBundle: (bundle: CspNonceBundle) => void;
+export declare const phxCspNoncePlugin: () => Plugin;

package/dist/phoenix/services/phx-csp-nonce-plugin.js

@@ -0,0 +1,84 @@
+let e="_goober",n="csp-nonce",t=`meta[property="${n}"]`;export const cspNonceBootstrapCode=`;(function(){
+  if (typeof window === 'undefined' || typeof document === 'undefined') {
+    return;
+  }
+
+  var globalWindow = window;
+  var currentNonce = '';
+
+  if (typeof globalWindow.__phx_csp_nonce__ === 'string' && globalWindow.__phx_csp_nonce__.length > 0) {
+    currentNonce = globalWindow.__phx_csp_nonce__;
+  } else if (typeof globalWindow.__nonce__ === 'string' && globalWindow.__nonce__.length > 0) {
+    currentNonce = globalWindow.__nonce__;
+  }
+
+  var currentScript = document.currentScript;
+  if (!currentNonce && currentScript && typeof currentScript.nonce === 'string' && currentScript.nonce.length > 0) {
+    currentNonce = currentScript.nonce;
+  }
+
+  var nonceMeta = document.querySelector('${t}');
+  if (
+    !currentNonce &&
+    nonceMeta &&
+    typeof nonceMeta.getAttribute === 'function'
+  ) {
+    var nonceFromMeta = nonceMeta.getAttribute('content');
+    if (typeof nonceFromMeta === 'string' && nonceFromMeta.length > 0) {
+      currentNonce = nonceFromMeta;
+    }
+  }
+
+  if (!currentNonce) {
+    var elements = document.getElementsByTagName('*');
+    for (var index = 0; index < elements.length; index += 1) {
+      var currentElement = elements[index];
+      var currentTagName = currentElement.tagName;
+      if (typeof currentTagName === 'string' && currentTagName.indexOf('SALSITA-') === 0) {
+        var nonceFromElement = currentElement.nonce;
+        if (typeof nonceFromElement === 'string' && nonceFromElement.length > 0) {
+          currentNonce = nonceFromElement;
+          break;
+        }
+      }
+    }
+  }
+
+  if (!currentNonce) {
+    return;
+  }
+
+  globalWindow.__phx_csp_nonce__ = currentNonce;
+  globalWindow.__nonce__ = currentNonce;
+
+  var head = document.head || document.getElementsByTagName('head')[0];
+  if (!head) {
+    return;
+  }
+
+  if (!nonceMeta) {
+    nonceMeta = document.createElement('meta');
+    nonceMeta.setAttribute('property', '${n}');
+    head.appendChild(nonceMeta);
+  }
+  nonceMeta.setAttribute('content', currentNonce);
+
+  var gooberStyle = document.getElementById('${e}');
+  if (!gooberStyle || gooberStyle.tagName !== 'STYLE') {
+    gooberStyle = document.createElement('style');
+    gooberStyle.id = '${e}';
+    gooberStyle.nonce = currentNonce;
+    gooberStyle.appendChild(document.createTextNode(' '));
+    head.appendChild(gooberStyle);
+  } else if (!gooberStyle.parentNode) {
+    head.appendChild(gooberStyle);
+  }
+
+  if (!gooberStyle.firstChild) {
+    gooberStyle.appendChild(document.createTextNode(' '));
+  }
+
+  gooberStyle.nonce = currentNonce;
+  globalWindow['${e}'] = gooberStyle;
+})();
+`;export const prependCspNonceBootstrap=e=>`${cspNonceBootstrapCode}${e}`;let o=e=>"chunk"===e.type&&e.fileName.endsWith(".js");export const prependCspNonceBootstrapToBundle=e=>{for(let n of Object.values(e))o(n)&&(n.code=prependCspNonceBootstrap(n.code))};export const phxCspNoncePlugin=()=>({name:"vite:phx-csp-nonce",enforce:"post",generateBundle(e,n){prependCspNonceBootstrapToBundle(n)}});

package/dist/phoenix/services/phx-global-isolation-plugin.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'vite';
+interface PhxGlobalIsolationPluginOptions {
+    /** Callback to get deployment ID. Called on each transform/render. */
+    readonly getDeploymentId: () => string;
+}
+/** Sanitize deployment ID to be a valid JS identifier part. */
+export declare const sanitizeDeploymentId: (deploymentId: string) => string;
+/** Get the isolated global name from deployment ID. */
+export declare const getIsolatedGlobalName: (deploymentId: string) => string;
+export declare const phxGlobalIsolationPlugin: (options: PhxGlobalIsolationPluginOptions) => Plugin;
+export {};

package/dist/phoenix/services/phx-global-isolation-plugin.js

@@ -0,0 +1 @@
+export const sanitizeDeploymentId=e=>e.replace(/[^a-zA-Z0-9_]/g,"_");export const getIsolatedGlobalName=e=>`__phx_${e.replace(/[^a-zA-Z0-9_]/g,"_")}__`;export const phxGlobalIsolationPlugin=e=>{let l,{getDeploymentId:n}=e;return{name:"vite:phx-global-isolation",configResolved(e){l=e},transform(e,o){if("serve"!==l.command||!/\.[jt]sx?$/.test(o)||o.includes("/node_modules/")||o.includes("/dist/"))return null;let a=getIsolatedGlobalName(n()),t=e.replace(/\bglobalThis\.phx\.(?!(?:frontendEnv|runtimeConfig)\b)/g,`globalThis.${a}.`).replace(/(?<![a-zA-Z0-9_$"'`])(?<!(?<!\.\.)\.)phx\.(?!(?:frontendEnv|runtimeConfig)\b)/g,`globalThis.${a}.`);return{code:`globalThis.${a}??={};${t}`,map:null}},renderChunk(e,o){if("build"!==l.command||!o.fileName.endsWith(".js"))return null;let a=getIsolatedGlobalName(n()),t=e.replace(/\bglobalThis\.phx\b/g,a).replace(/(?<![a-zA-Z0-9_$"'`])(?<!(?<!\.\.)\.)phx\./g,`${a}.`);return{code:`const ${a}=globalThis.${a}??={};${t}`,map:null}}}};

package/dist/phoenix/services/prepare-development-environment.d.ts

@@ -0,0 +1,17 @@
+import { type Logger } from '../utils/index.js';
+import { type DevelopmentCredential } from './development-credential.js';
+/** Inputs for preparing this pipeline’s development deployment and generated environment file. */
+export interface DevelopmentEnvironmentProps {
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+    readonly serverUrl: string;
+    readonly credential: DevelopmentCredential;
+    readonly outFile: string;
+    readonly skipUpload: boolean;
+    readonly overrideSchema: boolean;
+    readonly debug: boolean;
+    readonly projectVersion: string;
+}
+export declare const prepareDevelopmentEnvironment: (props: DevelopmentEnvironmentProps, context: {
+    readonly logger: Logger;
+}) => Promise<void>;

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

@@ -0,0 +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,assistant:b.assistant,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})}
+`),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/signed-in-development-environment.d.ts

@@ -0,0 +1,17 @@
+interface SignedInDevelopmentEnvironmentProps {
+    readonly serverUrl: string;
+    readonly project: string;
+}
+/** The development environment `phoenix dev` works in when it authenticates with the stored login. */
+interface SignedInDevelopmentEnvironment {
+    readonly apiToken: string;
+    readonly workspaceName: string;
+    readonly projectSlug: string;
+    readonly environmentSlug: string;
+}
+/**
+ * Asks the server for the signed-in user's development environment in a project. The server creates it on the first
+ * call, so nothing has to be set up in Studio.
+ */
+export declare const resolveSignedInDevelopmentEnvironment: (props: SignedInDevelopmentEnvironmentProps) => Promise<SignedInDevelopmentEnvironment>;
+export {};

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

@@ -0,0 +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}};

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

@@ -0,0 +1,31 @@
+/** The packed project files of a `phoenix deploy`, in a temporary folder the caller removes with `cleanup`. */
+export interface SourceArchive {
+    readonly path: string;
+    readonly fileCount: number;
+    readonly size: number;
+    readonly cleanup: () => Promise<void>;
+}
+/** What `extractSourceArchive` wrote and what it left out. */
+export interface ExtractedSources {
+    readonly fileCount: number;
+    /** Archive members that are not project files, which were not extracted. */
+    readonly skipped: readonly string[];
+}
+export interface ExtractSourceArchiveProps {
+    readonly archivePath: string;
+    /** A new or empty folder, so extracted files never mix with or overwrite existing ones. */
+    readonly targetDir: string;
+}
+/**
+ * Packs the project files of an application-spec project into a gzip tarball in a temporary folder. It refuses
+ * links and special files, which the build does not accept. It uses the system `tar`, which macOS, Linux and
+ * Windows 10 or later all provide, without a shell.
+ */
+export declare const createSourceArchive: (projectDir: string) => Promise<SourceArchive>;
+/**
+ * Validates an uploaded source archive and extracts its project files. The archive is customer-controlled and this
+ * runs in a trusted job, so nothing is taken on trust: links, special files, unsafe paths, colliding members and
+ * oversized content are refused, and members that are not project files are left out. On a refusal or an
+ * unreadable archive the target folder is removed, so a partly extracted project is never used.
+ */
+export declare const extractSourceArchive: (props: ExtractSourceArchiveProps) => Promise<ExtractedSources>;

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

@@ -0,0 +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 Promise.all((await v(e)).map(async r=>({name:r,entry:await o(f(e,r))}))),t=r.filter(({entry:e})=>!e.isDirectory()&&(!e.isFile()||e.nlink>1)),i=r.filter(({entry:e})=>e.isFile()).map(({name:e})=>e);if(t.length>0)throw Error(`These project files are links or special files, which builds do not accept: ${t.map(({name:e})=>e).join(", ")}. Replace them with regular files and deploy again.`);if(0===i.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 n=await a(f(h(),"phoenix-deploy-")),p="sources.tgz",d=f(n,p),w=f(n,"files");try{await l(w,i.join("\0")),await x("tar",["-czf",p,"-C",e,"--null","-T",w],{cwd:n,env:{...process.env,COPYFILE_DISABLE:"1"}})}catch(r){await s(n,{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:d,fileCount:i.length,size:(await c(d)).size,cleanup:()=>s(n,{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()}),$=[],z=0,R=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((R+=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}z+=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:z,skipped:$}};