@walkeros/cli 4.3.1 → 4.3.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @walkeros/cli
 
+## 4.3.2
+
+### Patch Changes
+
+- a32ac49: The Observe session lifecycle is now available programmatically:
+  `startObserveSession`, `getObserveSession`, and the new `endObserveSession`
+  are exported from `@walkeros/cli`, so tools built on the CLI can open an
+  Observe session on a flow, read its status and record count, and end it.
+  Starting one also accepts `origins` to bind its web activation grant.
+  - @walkeros/collector@4.3.2
+  - @walkeros/core@4.3.2
+  - @walkeros/server-core@4.3.2
+  - @walkeros/server-destination-api@4.3.2
+  - @walkeros/transformer-validate@4.3.2
+
 ## 4.3.1
 
 ### Patch Changes

package/dist/cli.js

@@ -5858,7 +5858,7 @@ var init_contract = __esm({
   "src/core/contract.ts"() {
     "use strict";
     init_config_file();
-    bakedContractVersion = true ? "4.0.0" : PLACEHOLDER;
+    bakedContractVersion = true ? "4.1.0" : PLACEHOLDER;
   }
 });
 
@@ -6353,6 +6353,7 @@ var init_output2 = __esm({
 // src/commands/observe/index.ts
 var observe_exports = {};
 __export(observe_exports, {
+  endObserveSession: () => endObserveSession,
   formatObserveSession: () => formatObserveSession,
   getObserveSession: () => getObserveSession,
   heartbeatObserveSession: () => heartbeatObserveSession,
@@ -6368,7 +6369,10 @@ async function startObserveSession(options) {
   const body = {
     settingsName: options.settingsName,
     ...options.replace ? { replace: true } : {},
-    ...options.level !== void 0 ? { level: options.level } : {}
+    ...options.level !== void 0 ? { level: options.level } : {},
+    // An empty list carries no origin the grant could bind to, so it is
+    // omitted rather than sent as a bare [] the app would have to interpret.
+    ...options.origins?.length ? { origins: options.origins } : {}
   };
   const response = await apiFetch(
     `/api/projects/${pid}/flows/${options.flowId}/observe-sessions`,
@@ -6399,6 +6403,17 @@ async function getObserveSession(options) {
   }
   return response.json();
 }
+async function endObserveSession(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/observe-sessions/${options.sessionId}`,
+    { method: "DELETE" }
+  );
+  if (!response.ok) {
+    const errorBody = await response.json().catch(() => ({}));
+    throwApiResponseError(response, errorBody, "Failed to end observe session");
+  }
+}
 async function heartbeatObserveSession(options) {
   const pid = options.projectId ?? requireProjectId();
   try {
@@ -7738,7 +7753,7 @@ function Nt2(e4, t4, n5) {
   if (!o4 || !r6) throw new Error("Event name is invalid");
   const { timestamp: s4 = Date.now(), name: a4 = `${o4} ${r6}`, data: i5 = {}, context: c2 = {}, globals: u2 = e4.globals, custom: d2 = {}, user: l3 = e4.user, nested: f3 = [], consent: p3 = e4.consent, id: g3 = Ne(), trigger: m3 = "", entity: h2 = o4, action: v3 = r6, timing: y3 = 0, source: w3 = { type: "collector", schema: "4" } } = t4, b3 = w3.count ?? (e4.count += 1), k3 = w3.trace ?? n5?._meta.trace ?? e4.trace, I3 = { ...w3, count: b3 };
   void 0 !== k3 && (I3.trace = k3);
-  const C3 = e4.name ?? w3.platform ?? "default", E2 = e4.release ?? "4.3.1";
+  const C3 = e4.name ?? w3.platform ?? "default", E2 = e4.release ?? "4.3.2";
   return I3.release = { ...w3.release, [C3]: E2 }, { name: a4, data: i5, context: c2, globals: u2, custom: d2, user: l3, nested: f3, consent: p3, id: g3, trigger: m3, entity: h2, action: v3, timestamp: s4, timing: y3, source: I3 };
 }
 function Yt(e4, t4, n5) {
@@ -13793,7 +13808,7 @@ function validateMapping(input) {
 // src/commands/validate/validators/entry.ts
 init_dist();
 import Ajv from "ajv";
-var CLIENT_HEADER = "walkeros-cli/4.3.1";
+var CLIENT_HEADER = "walkeros-cli/4.3.2";
 var SECTIONS = ["destinations", "sources", "transformers"];
 function resolveEntry(path19, flowConfig) {
   const flows = flowConfig.flows;

package/dist/index.d.ts

@@ -9884,6 +9884,7 @@ interface components {
       /** Format: date-time */
       sessionExpiresAt: string;
       sessionGrant?: string;
+      sessionId?: string;
     };
     ObserveSessionResponse: {
       /** @example ses_abc123xyz456 */
@@ -9915,6 +9916,9 @@ interface components {
       previewEnabled: boolean;
       /** Format: uri */
       bundleUrl: string;
+      /** Format: uri */
+      url?: string;
+      binding?: string;
     } | null;
     ObserveSessionServer: {
       /** Format: uri */
@@ -11757,6 +11761,47 @@ interface ListJourneysOptions {
  */
 declare function listJourneys(options: ListJourneysOptions): Promise<any>;
 
+type ObserveSessionResponse = components['schemas']['ObserveSessionResponse'];
+type ObserveLevel = components['schemas']['ObserveLevel'];
+interface StartObserveSessionOptions {
+    projectId?: string;
+    flowId: string;
+    /** Flow settings name; the mint contract requires it. */
+    settingsName: string;
+    /** Replace an existing active session for the flow (`--replace`). */
+    replace?: boolean;
+    /** Observation detail level for the session. */
+    level?: ObserveLevel;
+    /** Origins the session's web activation grant may activate on. */
+    origins?: string[];
+}
+/**
+ * Mint an observe session via the app's authenticated boundary. Thin client:
+ * the app validates topology, inserts the row, and provisions detached; the
+ * mint response comes back immediately (usually `arming`, with the web and
+ * server parts still null - GET assembles them once the session settles).
+ */
+declare function startObserveSession(options: StartObserveSessionOptions): Promise<ObserveSessionResponse>;
+interface GetObserveSessionOptions {
+    projectId?: string;
+    flowId: string;
+    sessionId: string;
+}
+declare function getObserveSession(options: GetObserveSessionOptions): Promise<ObserveSessionResponse>;
+interface EndObserveSessionOptions {
+    projectId?: string;
+    flowId: string;
+    sessionId: string;
+}
+/**
+ * End a session through the app's authenticated boundary: the app tears down
+ * the container, revokes credentials, deletes the web preview, and drops the
+ * row. Ends the WHOLE session including every attached arm. Idempotent
+ * app-side, and the 204 carries no body, so this resolves with nothing; a
+ * session scoped to another flow or project is a 404, never a cross-tenant end.
+ */
+declare function endObserveSession(options: EndObserveSessionOptions): Promise<void>;
+
 interface ListSecretsOptions {
     projectId?: string;
     flowId: string;
@@ -12102,4 +12147,4 @@ declare module '@walkeros/core' {
     }
 }
 
-export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type ExampleLookupResult, type FeedbackOptions, type GetPreviewOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListJourneysOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListSecretsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RegrantPreviewOptions, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clientContextHeaders, compareContract, compareOutput, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, feedback, feedbackCommand, fetchHealth, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listJourneys, listPreviews, listProjects, listProjectsCommand, listSecrets, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, regrantPreview, requestDeviceCode, requireProjectId, resetClientContext, resolveAppUrl, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateCollector, simulateDestination, simulateSource, simulateTransformer, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, validateFlowStructure, whoami, whoamiCommand, wrapSkeleton, writeConfig };
+export { ApiError, type ApiErrorDetail, type BuildOptions, type BundleStats, type CLIBuildOptions, type ClientContext, type ClientType, type CompareContractInput, type ContractComparison, type ContractVerdict, type CreatePreviewOptions, type CreateSecretOptions, type DeletePreviewOptions, type DeleteSecretOptions, type DeployOptions, DeploymentAmbiguityError, type DeploymentSummaryForFlow, type DeviceCodeOptions, type DeviceCodeResult, type EndObserveSessionOptions, type ExampleLookupResult, type FeedbackOptions, type GetObserveSessionOptions, type GetPreviewOptions, type GlobalOptions, type HealthResult, type ListDeploymentsOptions, type ListFlowsOptions, type ListJourneysOptions, type ListPreviewsOptions, type ListProjectsOptions, type ListSecretsOptions, type MinifyOptions, type PollOptions, type PollResult, type PrepareInput, type PreparedFlow, type ProjectFlows, type PushResult, type RegrantPreviewOptions, type RunCommandOptions, type RunOptions, type RunResult, type SSEEvent, type SSEParseResult, type SimulateCollectorOptions, type SimulateDataOptions, type SimulateDestinationOptions, type SimulateSourceOptions, type SimulateTransformerOptions, type StartObserveSessionOptions, type UpdateSecretOptions, VERSION, type ValidateResult, type ValidationError, type ValidationType, type ValidationWarning, type WalkerOSConfig, type WrapSkeletonOptions, annotateErrorWithDrift, apiFetch, bakedContractHash, bakedContractVersion, buildDataPayload, bundle, bundleCommand, canonicalContractHash, classifyStepProperties, clientContextHeaders, compareContract, compareOutput, containsCodeMarkers, createApiClient, createDeployCommand, createDeployment, createDeploymentCommand, createFlow, createFlowCommand, createPreview, createProject, createProjectCommand, createSecret, deleteConfig, deleteDeployment, deleteDeploymentByFlowId, deleteDeploymentCommand, deleteFlow, deleteFlowCommand, deletePreview, deleteProject, deleteProjectCommand, deleteSecret, deploy, deployCommand, deployFetch, duplicateFlow, duplicateFlowCommand, endObserveSession, feedback, feedbackCommand, fetchHealth, findExample, getAuthHeaders, getClientContext, getDefaultProject, getDeployment, getDeploymentBySlug, getDeploymentBySlugCommand, getDeploymentCommand, getFeedbackPreference, getFlow, getFlowCommand, getObserveSession, getPreview, getProject, getProjectCommand, getToken, listAllFlows, listDeployments, listDeploymentsCommand, listFlows, listFlowsCommand, listJourneys, listPreviews, listProjects, listProjectsCommand, listSecrets, loadConfig, loadJsonConfig, loginCommand, logoutCommand, mergeAuthHeaders, parseSSEEvents, pollForToken, publicFetch, push, pushCommand, readConfig, regrantPreview, requestDeviceCode, requireProjectId, resetClientContext, resolveAppUrl, resolveToken, run, runCommand, setClientContext, setDefaultProject, setFeedbackPreference, simulateCollector, simulateDestination, simulateSource, simulateTransformer, startObserveSession, index as telemetry, telemetryDisableCommand, telemetryEnableCommand, telemetryStatusCommand, throwApiError, updateFlow, updateFlowCommand, updateProject, updateProjectCommand, updateSecret, validate, validateCommand, validateFlowStructure, whoami, whoamiCommand, wrapSkeleton, writeConfig };

package/dist/index.js

@@ -8249,7 +8249,7 @@ function validateMapping(input) {
 // src/commands/validate/validators/entry.ts
 import Ajv from "ajv";
 import { fetchPackageSchema } from "@walkeros/core";
-var CLIENT_HEADER = "walkeros-cli/4.3.1";
+var CLIENT_HEADER = "walkeros-cli/4.3.2";
 var SECTIONS = ["destinations", "sources", "transformers"];
 function resolveEntry(path20, flowConfig) {
   const flows = flowConfig.flows;
@@ -8814,8 +8814,8 @@ import createClient from "openapi-fetch";
 init_config_file();
 import { createHash } from "crypto";
 import semver4 from "semver";
-var bakedContractVersion = true ? "4.0.0" : PLACEHOLDER;
-var bakedContractHash = true ? "79c9e2d3bd2a72f1a95ba52742c4acdfe446c3835d5d169654f94e95da0e545e" : "";
+var bakedContractVersion = true ? "4.1.0" : PLACEHOLDER;
+var bakedContractHash = true ? "4a8fe14e34844d44db2257c97807761bd6bb812b5e28cb0595ece294728123aa" : "";
 function isRecord3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -10344,6 +10344,62 @@ async function listJourneys(options) {
   return response.json();
 }
 
+// src/commands/observe/index.ts
+init_auth();
+init_http();
+init_output();
+init_config_file();
+async function startObserveSession(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const body = {
+    settingsName: options.settingsName,
+    ...options.replace ? { replace: true } : {},
+    ...options.level !== void 0 ? { level: options.level } : {},
+    // An empty list carries no origin the grant could bind to, so it is
+    // omitted rather than sent as a bare [] the app would have to interpret.
+    ...options.origins?.length ? { origins: options.origins } : {}
+  };
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/observe-sessions`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    }
+  );
+  if (!response.ok) {
+    const errorBody = await response.json().catch(() => ({}));
+    throwApiResponseError(
+      response,
+      errorBody,
+      "Failed to start observe session"
+    );
+  }
+  return response.json();
+}
+async function getObserveSession(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/observe-sessions/${options.sessionId}`
+  );
+  if (!response.ok) {
+    const errorBody = await response.json().catch(() => ({}));
+    throwApiResponseError(response, errorBody, "Failed to get observe session");
+  }
+  return response.json();
+}
+async function endObserveSession(options) {
+  const pid = options.projectId ?? requireProjectId();
+  const response = await apiFetch(
+    `/api/projects/${pid}/flows/${options.flowId}/observe-sessions/${options.sessionId}`,
+    { method: "DELETE" }
+  );
+  if (!response.ok) {
+    const errorBody = await response.json().catch(() => ({}));
+    throwApiResponseError(response, errorBody, "Failed to end observe session");
+  }
+}
+
 // src/commands/secrets/index.ts
 init_auth();
 init_http();
@@ -10753,6 +10809,7 @@ export {
   deployFetch,
   duplicateFlow,
   duplicateFlowCommand,
+  endObserveSession,
   feedback,
   feedbackCommand,
   fetchHealth,
@@ -10767,6 +10824,7 @@ export {
   getFeedbackPreference,
   getFlow,
   getFlowCommand,
+  getObserveSession,
   getPreview,
   getProject,
   getProjectCommand,
@@ -10807,6 +10865,7 @@ export {
   simulateDestination,
   simulateSource,
   simulateTransformer,
+  startObserveSession,
   telemetry_exports as telemetry,
   telemetryDisableCommand,
   telemetryEnableCommand,