@withpotter/lib 0.13.0-next.101

package/dist/commerce-build/api.js

@@ -0,0 +1,152 @@
+import { ApiRequestError, apiFetch } from "@withpotter/lib/api";
+import {
+  CommerceBuildRequestError,
+  parseCommerceBuildSseFrame,
+  streamCommerceBuildTurn
+} from "./turn-streaming";
+function buildStartCommerceBuildFormData(input) {
+  const formData = new FormData();
+  formData.append("description", input.description.trim());
+  if (input.websiteUrl?.trim()) {
+    formData.append("websiteUrl", input.websiteUrl.trim());
+  }
+  for (const file of input.files) {
+    formData.append("files", file);
+  }
+  for (const image of input.images) {
+    formData.append("images", image);
+  }
+  return formData;
+}
+async function createCommerceBuild(tenantSlug, input) {
+  return apiFetch("/commerce-builds", {
+    method: "POST",
+    tenantSlug,
+    body: buildStartCommerceBuildFormData(input)
+  });
+}
+async function getCommerceBuild(tenantSlug, buildId) {
+  return apiFetch(`/commerce-builds/${buildId}`, {
+    tenantSlug
+  });
+}
+async function getCurrentCommerceBuild(tenantSlug) {
+  try {
+    return await apiFetch("/commerce-builds", {
+      tenantSlug
+    });
+  } catch (error) {
+    if (error instanceof ApiRequestError && error.status === 404) {
+      return null;
+    }
+    throw error;
+  }
+}
+async function acceptCommerceBuildProfile(tenantSlug, buildId, profileRevision) {
+  return apiFetch(
+    `/commerce-builds/${buildId}/accept-profile`,
+    {
+      method: "POST",
+      tenantSlug,
+      body: JSON.stringify({ profileRevision })
+    }
+  );
+}
+async function compileCommerceBuild(tenantSlug, buildId, profileRevision) {
+  return apiFetch(
+    `/commerce-builds/${buildId}/compile`,
+    {
+      method: "POST",
+      tenantSlug,
+      body: JSON.stringify({ profileRevision })
+    }
+  );
+}
+async function createCommerceBuildPreview(tenantSlug, buildId, specRevision) {
+  return apiFetch(`/commerce-builds/${buildId}/preview`, {
+    method: "POST",
+    tenantSlug,
+    body: JSON.stringify({ specRevision })
+  });
+}
+async function verifyCommerceBuild(tenantSlug, buildId, previewId) {
+  return apiFetch(`/commerce-builds/${buildId}/verify`, {
+    method: "POST",
+    tenantSlug,
+    body: JSON.stringify({ previewId })
+  });
+}
+async function proposeCommerceBuildLaunch(tenantSlug, buildId, input) {
+  return apiFetch(
+    `/commerce-builds/${buildId}/propose-launch`,
+    { method: "POST", tenantSlug, body: JSON.stringify(input) }
+  );
+}
+function resolveCurrentProfile(build) {
+  if (build?.currentProfile) return build.currentProfile;
+  if (!build?.profile || !build.currentProfileRevision) return null;
+  return {
+    revision: build.currentProfileRevision,
+    profile: build.profile
+  };
+}
+function resolveCurrentSpec(build) {
+  return build?.currentSpec ?? null;
+}
+function resolveCurrentPlan(build) {
+  return build?.currentPlan ?? null;
+}
+function resolveCurrentPreview(build) {
+  return build?.currentPreview ?? null;
+}
+function resolveCurrentReadiness(build) {
+  return build?.currentReadiness ?? build?.currentVerification?.readiness ?? null;
+}
+function resolveCurrentVerification(build) {
+  return build?.currentVerification ?? null;
+}
+function resolveCurrentLaunch(build) {
+  return build?.currentLaunch ?? null;
+}
+function resolveCurrentDeployment(build) {
+  return build?.currentDeployment ?? null;
+}
+function countEvidenceByKind(evidence) {
+  return evidence.reduce(
+    (counts, item) => {
+      counts[item.kind] += 1;
+      return counts;
+    },
+    {
+      "merchant-description": 0,
+      website: 0,
+      document: 0,
+      image: 0,
+      "host-fact": 0
+    }
+  );
+}
+export {
+  CommerceBuildRequestError,
+  acceptCommerceBuildProfile,
+  buildStartCommerceBuildFormData,
+  compileCommerceBuild,
+  countEvidenceByKind,
+  createCommerceBuild,
+  createCommerceBuildPreview,
+  getCommerceBuild,
+  getCurrentCommerceBuild,
+  parseCommerceBuildSseFrame,
+  proposeCommerceBuildLaunch,
+  resolveCurrentDeployment,
+  resolveCurrentLaunch,
+  resolveCurrentPlan,
+  resolveCurrentPreview,
+  resolveCurrentProfile,
+  resolveCurrentReadiness,
+  resolveCurrentSpec,
+  resolveCurrentVerification,
+  streamCommerceBuildTurn,
+  verifyCommerceBuild
+};
+//# sourceMappingURL=api.js.map

package/dist/commerce-build/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/api.ts"],"sourcesContent":["import { ApiRequestError, apiFetch } from '@withpotter/lib/api';\nimport type {\n  BuildReadinessV1,\n  BusinessProfileRevisionView,\n  CommerceDeploymentView,\n  CommerceLaunchView,\n  CapabilityPlanV1,\n  CommerceCompileResult,\n  CommerceBuildView,\n  CommerceSpecV1,\n  LaunchProposalReceipt,\n  PreviewJobView,\n  SourceEvidence,\n  SourceKind,\n  VerificationJobView,\n} from './contracts';\n\nexport interface StartCommerceBuildInput {\n  description: string;\n  websiteUrl?: string;\n  files: File[];\n  images: File[];\n}\n\nexport {\n  CommerceBuildRequestError,\n  parseCommerceBuildSseFrame,\n  streamCommerceBuildTurn,\n  type CommerceBuildTurnResult,\n} from './turn-streaming';\n\nexport function buildStartCommerceBuildFormData(\n  input: StartCommerceBuildInput,\n): FormData {\n  const formData = new FormData();\n  formData.append('description', input.description.trim());\n  if (input.websiteUrl?.trim()) {\n    formData.append('websiteUrl', input.websiteUrl.trim());\n  }\n  for (const file of input.files) {\n    formData.append('files', file);\n  }\n  for (const image of input.images) {\n    formData.append('images', image);\n  }\n  return formData;\n}\n\nexport async function createCommerceBuild(\n  tenantSlug: string,\n  input: StartCommerceBuildInput,\n): Promise<CommerceBuildView> {\n  return apiFetch<CommerceBuildView>('/commerce-builds', {\n    method: 'POST',\n    tenantSlug,\n    body: buildStartCommerceBuildFormData(input),\n  });\n}\n\nexport async function getCommerceBuild(\n  tenantSlug: string,\n  buildId: string,\n): Promise<CommerceBuildView> {\n  return apiFetch<CommerceBuildView>(`/commerce-builds/${buildId}`, {\n    tenantSlug,\n  });\n}\n\nexport async function getCurrentCommerceBuild(\n  tenantSlug: string,\n): Promise<CommerceBuildView | null> {\n  try {\n    return await apiFetch<CommerceBuildView>('/commerce-builds', {\n      tenantSlug,\n    });\n  } catch (error) {\n    if (error instanceof ApiRequestError && error.status === 404) {\n      return null;\n    }\n    throw error;\n  }\n}\n\nexport async function acceptCommerceBuildProfile(\n  tenantSlug: string,\n  buildId: string,\n  profileRevision: number,\n): Promise<CommerceBuildView> {\n  return apiFetch<CommerceBuildView>(\n    `/commerce-builds/${buildId}/accept-profile`,\n    {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify({ profileRevision }),\n    },\n  );\n}\n\nexport async function compileCommerceBuild(\n  tenantSlug: string,\n  buildId: string,\n  profileRevision: number,\n): Promise<CommerceCompileResult> {\n  return apiFetch<CommerceCompileResult>(\n    `/commerce-builds/${buildId}/compile`,\n    {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify({ profileRevision }),\n    },\n  );\n}\n\nexport async function createCommerceBuildPreview(\n  tenantSlug: string,\n  buildId: string,\n  specRevision: number,\n): Promise<PreviewJobView> {\n  return apiFetch<PreviewJobView>(`/commerce-builds/${buildId}/preview`, {\n    method: 'POST',\n    tenantSlug,\n    body: JSON.stringify({ specRevision }),\n  });\n}\n\nexport async function verifyCommerceBuild(\n  tenantSlug: string,\n  buildId: string,\n  previewId: string,\n): Promise<VerificationJobView> {\n  return apiFetch<VerificationJobView>(`/commerce-builds/${buildId}/verify`, {\n    method: 'POST',\n    tenantSlug,\n    body: JSON.stringify({ previewId }),\n  });\n}\n\nexport async function proposeCommerceBuildLaunch(\n  tenantSlug: string,\n  buildId: string,\n  input: { specRevision: number; readinessRevision: number },\n): Promise<LaunchProposalReceipt> {\n  return apiFetch<LaunchProposalReceipt>(\n    `/commerce-builds/${buildId}/propose-launch`,\n    { method: 'POST', tenantSlug, body: JSON.stringify(input) },\n  );\n}\n\nexport function resolveCurrentProfile(\n  build: CommerceBuildView | null | undefined,\n): BusinessProfileRevisionView | null {\n  if (build?.currentProfile) return build.currentProfile;\n  if (!build?.profile || !build.currentProfileRevision) return null;\n  return {\n    revision: build.currentProfileRevision,\n    profile: build.profile,\n  };\n}\n\nexport function resolveCurrentSpec(\n  build: CommerceBuildView | null | undefined,\n): CommerceSpecV1 | null {\n  return build?.currentSpec ?? null;\n}\n\nexport function resolveCurrentPlan(\n  build: CommerceBuildView | null | undefined,\n): CapabilityPlanV1 | null {\n  return build?.currentPlan ?? null;\n}\n\nexport function resolveCurrentPreview(\n  build: CommerceBuildView | null | undefined,\n): PreviewJobView | null {\n  return build?.currentPreview ?? null;\n}\n\nexport function resolveCurrentReadiness(\n  build: CommerceBuildView | null | undefined,\n): BuildReadinessV1 | null {\n  return (\n    build?.currentReadiness ?? build?.currentVerification?.readiness ?? null\n  );\n}\n\nexport function resolveCurrentVerification(\n  build: CommerceBuildView | null | undefined,\n): VerificationJobView | null {\n  return build?.currentVerification ?? null;\n}\n\nexport function resolveCurrentLaunch(\n  build: CommerceBuildView | null | undefined,\n): CommerceLaunchView | null {\n  return build?.currentLaunch ?? null;\n}\n\nexport function resolveCurrentDeployment(\n  build: CommerceBuildView | null | undefined,\n): CommerceDeploymentView | null {\n  return build?.currentDeployment ?? null;\n}\n\nexport function countEvidenceByKind(evidence: SourceEvidence[]) {\n  return evidence.reduce<Record<SourceKind, number>>(\n    (counts, item) => {\n      counts[item.kind] += 1;\n      return counts;\n    },\n    {\n      'merchant-description': 0,\n      website: 0,\n      document: 0,\n      image: 0,\n      'host-fact': 0,\n    },\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/commerce-build/contracts-profile.d.ts

@@ -0,0 +1,83 @@
+export type CommerceBuildStatus = 'collecting' | 'profile-ready' | 'profile-accepted' | 'compiled' | 'previewing' | 'preview-ready' | 'verifying' | 'ready' | 'blocked' | 'launch-proposed' | 'launched' | 'expired';
+export type SourceKind = 'merchant-description' | 'website' | 'document' | 'image' | 'host-fact';
+export interface SourceEvidence {
+    id: string;
+    kind: SourceKind;
+    sourceRef: string;
+    capturedAt: string;
+    excerpt?: string;
+    contentHash?: string;
+    confidence: number;
+}
+export interface ClarificationNeed {
+    id: string;
+    field: string;
+    question: string;
+    options?: string[];
+    reason: string;
+    blocking: boolean;
+    evidenceIds: string[];
+}
+export interface BusinessProfileDraft {
+    schemaVersion: 1;
+    businessModel: 'physical-products';
+    name?: string;
+    summary: string;
+    customers: Array<{
+        label: string;
+        description?: string;
+    }>;
+    market: {
+        countries: string[];
+        currency?: string;
+        language?: string;
+    };
+    salesModel: 'dtc';
+    catalog: {
+        sourceEvidenceIds: string[];
+        estimatedProductCount?: number;
+    };
+    inventory: {
+        locations: number | null;
+        trackingRequired: boolean | null;
+    };
+    payments: {
+        requestedMethods: string[];
+    };
+    fulfillment: {
+        modes: Array<'local-delivery' | 'national-delivery' | 'pickup'>;
+    };
+    brand: {
+        voice?: string[];
+        audience?: string[];
+        visualEvidenceIds: string[];
+        restrictions?: string[];
+    };
+    objectives: string[];
+    assumptions: Array<{
+        field: string;
+        value: unknown;
+        reason: string;
+        evidenceIds: string[];
+    }>;
+    unresolved: ClarificationNeed[];
+    evidence: SourceEvidence[];
+}
+export interface CommerceBuild {
+    id: string;
+    tenantId: string;
+    status: CommerceBuildStatus;
+    currentProfileRevision?: number;
+    acceptedProfileRevision?: number;
+    currentSpecRevision?: number;
+    currentPlanRevision?: number;
+    currentReadinessRevision?: number;
+    previewId?: string;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string;
+}
+export interface BusinessProfileRevisionView {
+    revision: number;
+    profile: BusinessProfileDraft;
+}

package/dist/commerce-build/contracts-profile.js

@@ -0,0 +1 @@
+//# sourceMappingURL=contracts-profile.js.map

package/dist/commerce-build/contracts-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/commerce-build/contracts-spec.d.ts

@@ -0,0 +1,217 @@
+import type { BusinessProfileDraft, ClarificationNeed, CommerceBuild, BusinessProfileRevisionView, SourceEvidence } from './contracts-profile';
+export interface CommerceSpecV1 {
+    schemaVersion: 1;
+    buildId: string;
+    revision: number;
+    profileRevision: number;
+    catalog: {
+        products: Array<{
+            sourceKey: string;
+            title: string;
+            description?: string;
+            price?: {
+                amount: number;
+                currency: string;
+            };
+            sku?: string;
+            quantity?: number;
+            imageEvidenceIds: string[];
+            evidenceIds: string[];
+        }>;
+    };
+    market: {
+        country: string;
+        currency: string;
+        language: string;
+    };
+    pricing: {
+        model: 'dtc';
+        taxMode: 'inclusive' | 'exclusive' | 'unresolved';
+    };
+    inventory: {
+        locationCount: 1;
+        track: boolean;
+    };
+    payments: {
+        requestedMethods: string[];
+        provider?: string;
+    };
+    fulfillment: {
+        modes: Array<'local-delivery' | 'national-delivery' | 'pickup'>;
+        zones: Array<{
+            label: string;
+            countries: string[];
+            rate?: number;
+        }>;
+    };
+    experience: {
+        templateFamily: string;
+        pages: string[];
+        brandProfileRef?: string;
+        blockRequirements: string[];
+    };
+    policies: {
+        returns?: string;
+        privacyRequired: true;
+        termsRequired: true;
+    };
+    objectives: string[];
+    evidenceIds: string[];
+}
+export interface CapabilitySelection {
+    capabilityId: string;
+    packageName: `@withpotter/${string}`;
+    version: string;
+    configuration: Record<string, unknown>;
+    reason: string;
+    requirementPaths: string[];
+    evidenceIds: string[];
+}
+export interface CapabilityPlanIssue {
+    code: string;
+    message: string;
+    requirementPaths: string[];
+}
+export interface CapabilityPlanV1 {
+    schemaVersion: 1;
+    buildId: string;
+    revision: number;
+    specRevision: number;
+    registryVersion: string;
+    selections: CapabilitySelection[];
+    dependencyClosure: string[];
+    consoleClosure: string[];
+    tier: string;
+    blockers: CapabilityPlanIssue[];
+    warnings: CapabilityPlanIssue[];
+    valid: boolean;
+}
+export interface PreviewJobView {
+    previewId: string;
+    status?: string;
+    specRevision?: number;
+    previewUrl?: string;
+    editorUrl?: string;
+    publicUrl?: string;
+    updatedAt?: string;
+}
+export interface ReadinessCheck {
+    key: string;
+    status: 'passed' | 'failed' | 'blocked' | 'skipped';
+    required: boolean;
+    summary: string;
+    evidenceRefs: string[];
+    startedAt: string;
+    completedAt: string;
+}
+export interface BuildReadinessV1 {
+    schemaVersion: 1;
+    buildId: string;
+    revision: number;
+    specRevision: number;
+    planRevision: number;
+    previewId: string;
+    checks: ReadinessCheck[];
+    readyToLaunch: boolean;
+    blockers: string[];
+}
+export interface VerificationJobView {
+    previewId: string;
+    status?: string;
+    readiness?: BuildReadinessV1 | null;
+    startedAt?: string;
+    completedAt?: string;
+    error?: {
+        code: string;
+        message: string;
+    } | null;
+}
+export interface LaunchProposalReceipt {
+    receiptId?: string;
+    proposalId?: string;
+    proposalIds?: string[];
+    status?: string;
+    summary?: string;
+    specRevision?: number;
+    readinessRevision?: number;
+}
+export interface CommerceLaunchView extends LaunchProposalReceipt {
+    approvedProposalIds?: string[];
+    canPublish?: boolean;
+    rollbackProposalId?: string;
+    rollbackUrl?: string;
+}
+export interface CommerceDeploymentView {
+    status?: string;
+    summary?: string;
+    liveUrl?: string;
+    publishedAt?: string;
+    currentStep?: string;
+    rollbackProposalId?: string;
+    rollbackUrl?: string;
+    canRollback?: boolean;
+    postPublishVerification?: {
+        status?: string;
+        summary?: string;
+        evidenceRefs?: string[];
+        completedAt?: string;
+    } | null;
+}
+export interface CommerceCompileResult {
+    spec: CommerceSpecV1;
+    plan: CapabilityPlanV1;
+}
+export interface CommerceBuildView extends CommerceBuild {
+    profile?: BusinessProfileDraft | null;
+    currentProfile?: BusinessProfileRevisionView | null;
+    acceptedProfile?: BusinessProfileRevisionView | null;
+    currentSpec?: CommerceSpecV1 | null;
+    currentPlan?: CapabilityPlanV1 | null;
+    currentPreview?: PreviewJobView | null;
+    currentReadiness?: BuildReadinessV1 | null;
+    currentVerification?: VerificationJobView | null;
+    currentLaunch?: CommerceLaunchView | null;
+    currentDeployment?: CommerceDeploymentView | null;
+    clarifications?: ClarificationNeed[];
+    lastError?: {
+        code: string;
+        message: string;
+    } | null;
+}
+export interface CommerceBuildTurnRequest {
+    prompt: string;
+}
+export type CommerceBuildTurnEvent = {
+    event: 'session';
+    data: {
+        sessionId: string;
+    };
+} | {
+    event: 'narration';
+    data: {
+        delta: string;
+    };
+} | {
+    event: 'source';
+    data: {
+        evidence: SourceEvidence;
+    };
+} | {
+    event: 'clarify';
+    data: ClarificationNeed;
+} | {
+    event: 'profile';
+    data: {
+        profileRevision: number;
+        profile: BusinessProfileDraft;
+    };
+} | {
+    event: 'done';
+    data: Record<string, never>;
+} | {
+    event: 'error';
+    data: {
+        code: string;
+        message: string;
+    };
+};

package/dist/commerce-build/contracts-spec.js

@@ -0,0 +1 @@
+//# sourceMappingURL=contracts-spec.js.map

package/dist/commerce-build/contracts-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/commerce-build/contracts.d.ts

@@ -0,0 +1,2 @@
+export type { CommerceBuildStatus, SourceKind, SourceEvidence, ClarificationNeed, BusinessProfileDraft, CommerceBuild, BusinessProfileRevisionView, } from './contracts-profile';
+export type { CommerceSpecV1, CapabilitySelection, CapabilityPlanIssue, CapabilityPlanV1, PreviewJobView, ReadinessCheck, BuildReadinessV1, VerificationJobView, LaunchProposalReceipt, CommerceLaunchView, CommerceDeploymentView, CommerceCompileResult, CommerceBuildView, CommerceBuildTurnRequest, CommerceBuildTurnEvent, } from './contracts-spec';

package/dist/commerce-build/contracts.js

@@ -0,0 +1 @@
+//# sourceMappingURL=contracts.js.map

package/dist/commerce-build/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/commerce-build/launch-state.d.ts

@@ -0,0 +1,20 @@
+import type { BuildReadinessV1, CapabilityPlanV1, CommerceBuildStatus, CommerceDeploymentView, CommerceLaunchView, CommerceSpecV1, PreviewJobView } from './contracts';
+interface LaunchStateInput {
+    status?: CommerceBuildStatus;
+    acceptedProfileRevision?: number | null;
+    spec?: CommerceSpecV1 | null;
+    plan?: CapabilityPlanV1 | null;
+    preview?: PreviewJobView | null;
+    readiness?: BuildReadinessV1 | null;
+    launch?: CommerceLaunchView | null;
+    deployment?: CommerceDeploymentView | null;
+}
+export declare function resolveVerifyGuard(input: LaunchStateInput): string | null;
+export declare function resolveLaunchGuard(input: LaunchStateInput): string | null;
+export declare function resolvePublishGuard(input: LaunchStateInput): string | null;
+export declare function resolveLaunchStage(input: Pick<LaunchStateInput, 'status' | 'launch' | 'deployment'>): {
+    label: string;
+    tone: string;
+    description: string;
+};
+export {};

package/dist/commerce-build/launch-state.js

@@ -0,0 +1,72 @@
+function isExpired(status) {
+  return status === "expired";
+}
+function hasApprovedDraft(launch) {
+  const status = launch?.status?.toLowerCase() ?? "";
+  return launch?.canPublish === true || (launch?.approvedProposalIds?.length ?? 0) > 0 || status.includes("approved") || status.includes("draft");
+}
+function resolveVerifyGuard(input) {
+  if (isExpired(input.status)) return "This workspace expired. Start a fresh build.";
+  if (!input.spec || !input.plan) return "Compile a current spec and plan first.";
+  if (!input.plan.valid) return "Resolve compile blockers before verification.";
+  if (input.spec.profileRevision !== input.acceptedProfileRevision)
+    return "Recompile the accepted profile before verifying.";
+  if (!input.preview?.previewId) return "Create a current preview before verifying.";
+  if (input.preview.specRevision != null && input.preview.specRevision !== input.spec.revision) {
+    return "Refresh the preview so it matches the latest compiled revision.";
+  }
+  return null;
+}
+function resolveLaunchGuard(input) {
+  const verifyGuard = resolveVerifyGuard(input);
+  if (verifyGuard) return verifyGuard;
+  if (!input.readiness?.revision) return "Run readiness verification before launch.";
+  if (input.readiness.specRevision !== input.spec?.revision || input.readiness.planRevision !== input.plan?.revision || input.readiness.previewId !== input.preview?.previewId) {
+    return "Readiness is stale. Verify the current preview again.";
+  }
+  if (!input.readiness.readyToLaunch) {
+    return input.readiness.blockers[0] ?? "Required readiness checks still need attention.";
+  }
+  return null;
+}
+function resolvePublishGuard(input) {
+  if (isExpired(input.status)) return "This workspace expired. Start a fresh build.";
+  if (input.deployment?.status?.toLowerCase() === "live") return "This build is already live.";
+  if (input.status === "launched") return "This build is already live.";
+  if (!input.launch?.proposalIds?.length && !input.launch?.proposalId && !input.launch?.receiptId) {
+    return "Create a launch proposal first.";
+  }
+  if (!hasApprovedDraft(input.launch)) {
+    return "Approve the launch proposal into draft before publishing.";
+  }
+  return null;
+}
+function resolveLaunchStage(input) {
+  const deploymentStatus = input.deployment?.status?.toLowerCase();
+  if (deploymentStatus === "failed") {
+    return { label: "Publish failed", tone: "warning", description: input.deployment?.summary ?? "Review the host error and retry the publish flow." };
+  }
+  if (deploymentStatus === "publishing") {
+    return { label: "Publishing", tone: "neutral", description: input.deployment?.summary ?? "Draft changes are moving through the live publish pipeline." };
+  }
+  if (deploymentStatus === "rolled-back") {
+    return { label: "Rolled back", tone: "warning", description: input.deployment?.summary ?? "The live deployment was rolled back to the previous revision." };
+  }
+  if (deploymentStatus === "live" || input.status === "launched") {
+    return { label: "Live", tone: "success", description: input.deployment?.summary ?? "The approved draft is live and post-publish verification is available below." };
+  }
+  if (hasApprovedDraft(input.launch)) {
+    return { label: "Approved draft", tone: "success", description: "The launch proposal is approved into draft. Publish is still a separate live action." };
+  }
+  if (input.status === "launch-proposed" || input.launch?.proposalIds?.length || input.launch?.proposalId) {
+    return { label: "Needs approval", tone: "warning", description: "Review the launch proposal first. Approval only stages a draft." };
+  }
+  return { label: "Preview only", tone: "neutral", description: "Complete readiness and proposal review before anything can go live." };
+}
+export {
+  resolveLaunchGuard,
+  resolveLaunchStage,
+  resolvePublishGuard,
+  resolveVerifyGuard
+};
+//# sourceMappingURL=launch-state.js.map

package/dist/commerce-build/launch-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/launch-state.ts"],"sourcesContent":["import type {\n  BuildReadinessV1,\n  CapabilityPlanV1,\n  CommerceBuildStatus,\n  CommerceDeploymentView,\n  CommerceLaunchView,\n  CommerceSpecV1,\n  PreviewJobView,\n} from './contracts';\n\ninterface LaunchStateInput {\n  status?: CommerceBuildStatus;\n  acceptedProfileRevision?: number | null;\n  spec?: CommerceSpecV1 | null;\n  plan?: CapabilityPlanV1 | null;\n  preview?: PreviewJobView | null;\n  readiness?: BuildReadinessV1 | null;\n  launch?: CommerceLaunchView | null;\n  deployment?: CommerceDeploymentView | null;\n}\n\nfunction isExpired(status?: CommerceBuildStatus) {\n  return status === 'expired';\n}\n\nfunction hasApprovedDraft(launch?: CommerceLaunchView | null) {\n  const status = launch?.status?.toLowerCase() ?? '';\n  return (\n    launch?.canPublish === true ||\n    (launch?.approvedProposalIds?.length ?? 0) > 0 ||\n    status.includes('approved') ||\n    status.includes('draft')\n  );\n}\n\nexport function resolveVerifyGuard(input: LaunchStateInput): string | null {\n  if (isExpired(input.status)) return 'This workspace expired. Start a fresh build.';\n  if (!input.spec || !input.plan) return 'Compile a current spec and plan first.';\n  if (!input.plan.valid) return 'Resolve compile blockers before verification.';\n  if (input.spec.profileRevision !== input.acceptedProfileRevision)\n    return 'Recompile the accepted profile before verifying.';\n  if (!input.preview?.previewId) return 'Create a current preview before verifying.';\n  if (\n    input.preview.specRevision != null &&\n    input.preview.specRevision !== input.spec.revision\n  ) {\n    return 'Refresh the preview so it matches the latest compiled revision.';\n  }\n  return null;\n}\n\nexport function resolveLaunchGuard(input: LaunchStateInput): string | null {\n  const verifyGuard = resolveVerifyGuard(input);\n  if (verifyGuard) return verifyGuard;\n  if (!input.readiness?.revision) return 'Run readiness verification before launch.';\n  if (\n    input.readiness.specRevision !== input.spec?.revision ||\n    input.readiness.planRevision !== input.plan?.revision ||\n    input.readiness.previewId !== input.preview?.previewId\n  ) {\n    return 'Readiness is stale. Verify the current preview again.';\n  }\n  if (!input.readiness.readyToLaunch) {\n    return input.readiness.blockers[0] ?? 'Required readiness checks still need attention.';\n  }\n  return null;\n}\n\nexport function resolvePublishGuard(input: LaunchStateInput): string | null {\n  if (isExpired(input.status)) return 'This workspace expired. Start a fresh build.';\n  if (input.deployment?.status?.toLowerCase() === 'live') return 'This build is already live.';\n  if (input.status === 'launched') return 'This build is already live.';\n  if (!input.launch?.proposalIds?.length && !input.launch?.proposalId && !input.launch?.receiptId) {\n    return 'Create a launch proposal first.';\n  }\n  if (!hasApprovedDraft(input.launch)) {\n    return 'Approve the launch proposal into draft before publishing.';\n  }\n  return null;\n}\n\nexport function resolveLaunchStage(\n  input: Pick<LaunchStateInput, 'status' | 'launch' | 'deployment'>,\n) {\n  const deploymentStatus = input.deployment?.status?.toLowerCase();\n  if (deploymentStatus === 'failed') {\n    return { label: 'Publish failed', tone: 'warning', description: input.deployment?.summary ?? 'Review the host error and retry the publish flow.' };\n  }\n  if (deploymentStatus === 'publishing') {\n    return { label: 'Publishing', tone: 'neutral', description: input.deployment?.summary ?? 'Draft changes are moving through the live publish pipeline.' };\n  }\n  if (deploymentStatus === 'rolled-back') {\n    return { label: 'Rolled back', tone: 'warning', description: input.deployment?.summary ?? 'The live deployment was rolled back to the previous revision.' };\n  }\n  if (deploymentStatus === 'live' || input.status === 'launched') {\n    return { label: 'Live', tone: 'success', description: input.deployment?.summary ?? 'The approved draft is live and post-publish verification is available below.' };\n  }\n  if (hasApprovedDraft(input.launch)) {\n    return { label: 'Approved draft', tone: 'success', description: 'The launch proposal is approved into draft. Publish is still a separate live action.' };\n  }\n  if (input.status === 'launch-proposed' || input.launch?.proposalIds?.length || input.launch?.proposalId) {\n    return { label: 'Needs approval', tone: 'warning', description: 'Review the launch proposal first. Approval only stages a draft.' };\n  }\n  return { label: 'Preview only', tone: 'neutral', description: 'Complete readiness and proposal review before anything can go live.' };\n}\n"],"mappings":"AAqBA,SAAS,UAAU,QAA8B;AAC/C,SAAO,WAAW;AACpB;AAEA,SAAS,iBAAiB,QAAoC;AAC5D,QAAM,SAAS,QAAQ,QAAQ,YAAY,KAAK;AAChD,SACE,QAAQ,eAAe,SACtB,QAAQ,qBAAqB,UAAU,KAAK,KAC7C,OAAO,SAAS,UAAU,KAC1B,OAAO,SAAS,OAAO;AAE3B;AAEO,SAAS,mBAAmB,OAAwC;AACzE,MAAI,UAAU,MAAM,MAAM,EAAG,QAAO;AACpC,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,KAAM,QAAO;AACvC,MAAI,CAAC,MAAM,KAAK,MAAO,QAAO;AAC9B,MAAI,MAAM,KAAK,oBAAoB,MAAM;AACvC,WAAO;AACT,MAAI,CAAC,MAAM,SAAS,UAAW,QAAO;AACtC,MACE,MAAM,QAAQ,gBAAgB,QAC9B,MAAM,QAAQ,iBAAiB,MAAM,KAAK,UAC1C;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,OAAwC;AACzE,QAAM,cAAc,mBAAmB,KAAK;AAC5C,MAAI,YAAa,QAAO;AACxB,MAAI,CAAC,MAAM,WAAW,SAAU,QAAO;AACvC,MACE,MAAM,UAAU,iBAAiB,MAAM,MAAM,YAC7C,MAAM,UAAU,iBAAiB,MAAM,MAAM,YAC7C,MAAM,UAAU,cAAc,MAAM,SAAS,WAC7C;AACA,WAAO;AAAA,EACT;AACA,MAAI,CAAC,MAAM,UAAU,eAAe;AAClC,WAAO,MAAM,UAAU,SAAS,CAAC,KAAK;AAAA,EACxC;AACA,SAAO;AACT;AAEO,SAAS,oBAAoB,OAAwC;AAC1E,MAAI,UAAU,MAAM,MAAM,EAAG,QAAO;AACpC,MAAI,MAAM,YAAY,QAAQ,YAAY,MAAM,OAAQ,QAAO;AAC/D,MAAI,MAAM,WAAW,WAAY,QAAO;AACxC,MAAI,CAAC,MAAM,QAAQ,aAAa,UAAU,CAAC,MAAM,QAAQ,cAAc,CAAC,MAAM,QAAQ,WAAW;AAC/F,WAAO;AAAA,EACT;AACA,MAAI,CAAC,iBAAiB,MAAM,MAAM,GAAG;AACnC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,mBACd,OACA;AACA,QAAM,mBAAmB,MAAM,YAAY,QAAQ,YAAY;AAC/D,MAAI,qBAAqB,UAAU;AACjC,WAAO,EAAE,OAAO,kBAAkB,MAAM,WAAW,aAAa,MAAM,YAAY,WAAW,oDAAoD;AAAA,EACnJ;AACA,MAAI,qBAAqB,cAAc;AACrC,WAAO,EAAE,OAAO,cAAc,MAAM,WAAW,aAAa,MAAM,YAAY,WAAW,8DAA8D;AAAA,EACzJ;AACA,MAAI,qBAAqB,eAAe;AACtC,WAAO,EAAE,OAAO,eAAe,MAAM,WAAW,aAAa,MAAM,YAAY,WAAW,gEAAgE;AAAA,EAC5J;AACA,MAAI,qBAAqB,UAAU,MAAM,WAAW,YAAY;AAC9D,WAAO,EAAE,OAAO,QAAQ,MAAM,WAAW,aAAa,MAAM,YAAY,WAAW,+EAA+E;AAAA,EACpK;AACA,MAAI,iBAAiB,MAAM,MAAM,GAAG;AAClC,WAAO,EAAE,OAAO,kBAAkB,MAAM,WAAW,aAAa,uFAAuF;AAAA,EACzJ;AACA,MAAI,MAAM,WAAW,qBAAqB,MAAM,QAAQ,aAAa,UAAU,MAAM,QAAQ,YAAY;AACvG,WAAO,EAAE,OAAO,kBAAkB,MAAM,WAAW,aAAa,kEAAkE;AAAA,EACpI;AACA,SAAO,EAAE,OAAO,gBAAgB,MAAM,WAAW,aAAa,sEAAsE;AACtI;","names":[]}

package/dist/commerce-build/profile-utils.d.ts

@@ -0,0 +1,5 @@
+import type { BusinessProfileDraft, CommerceBuildView } from './contracts';
+export declare function profileRevisionSummary(build: CommerceBuildView | undefined, draft: {
+    revision: number;
+} | null): string;
+export declare function resolveBlockingClarifications(profile: BusinessProfileDraft | null): import("./contracts-profile").ClarificationNeed[];

package/dist/commerce-build/profile-utils.js

@@ -0,0 +1,14 @@
+function profileRevisionSummary(build, draft) {
+  if (!draft) return "No draft profile yet";
+  if (build?.acceptedProfileRevision === draft.revision)
+    return "Accepted revision";
+  return `Revision ${draft.revision}`;
+}
+function resolveBlockingClarifications(profile) {
+  return (profile?.unresolved ?? []).filter((item) => item.blocking);
+}
+export {
+  profileRevisionSummary,
+  resolveBlockingClarifications
+};
+//# sourceMappingURL=profile-utils.js.map

package/dist/commerce-build/profile-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/profile-utils.ts"],"sourcesContent":["import type { BusinessProfileDraft, CommerceBuildView } from './contracts';\n\nexport function profileRevisionSummary(\n  build: CommerceBuildView | undefined,\n  draft: { revision: number } | null,\n) {\n  if (!draft) return 'No draft profile yet';\n  if (build?.acceptedProfileRevision === draft.revision)\n    return 'Accepted revision';\n  return `Revision ${draft.revision}`;\n}\n\nexport function resolveBlockingClarifications(\n  profile: BusinessProfileDraft | null,\n) {\n  return (profile?.unresolved ?? []).filter((item) => item.blocking);\n}\n"],"mappings":"AAEO,SAAS,uBACd,OACA,OACA;AACA,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,OAAO,4BAA4B,MAAM;AAC3C,WAAO;AACT,SAAO,YAAY,MAAM,QAAQ;AACnC;AAEO,SAAS,8BACd,SACA;AACA,UAAQ,SAAS,cAAc,CAAC,GAAG,OAAO,CAAC,SAAS,KAAK,QAAQ;AACnE;","names":[]}

package/dist/commerce-build/setup-flow.d.ts

@@ -0,0 +1,10 @@
+import type { CommerceBuildView } from './contracts';
+export type CommerceBuildSurfaceMode = 'workspace' | 'setup';
+export type CommerceSetupStage = 'sources' | 'profile' | 'plan' | 'draft';
+export interface CommerceBuildSurfaceConfig {
+    showCompanionLinks: boolean;
+    showLaunchReadiness: boolean;
+    showProposalReview: boolean;
+}
+export declare function resolveCommerceBuildSurface(mode: CommerceBuildSurfaceMode): CommerceBuildSurfaceConfig;
+export declare function resolveCommerceSetupStage(build: CommerceBuildView | null | undefined): CommerceSetupStage;

package/dist/commerce-build/setup-flow.js

@@ -0,0 +1,24 @@
+function resolveCommerceBuildSurface(mode) {
+  return {
+    showCompanionLinks: mode === "workspace",
+    showLaunchReadiness: mode === "workspace",
+    showProposalReview: mode === "workspace"
+  };
+}
+function resolveCommerceSetupStage(build) {
+  if (build?.currentPreview?.previewId) {
+    return "draft";
+  }
+  if (build?.currentSpec?.revision && build?.currentPlan?.revision) {
+    return "plan";
+  }
+  if (build?.acceptedProfileRevision || build?.currentProfileRevision) {
+    return "profile";
+  }
+  return "sources";
+}
+export {
+  resolveCommerceBuildSurface,
+  resolveCommerceSetupStage
+};
+//# sourceMappingURL=setup-flow.js.map

package/dist/commerce-build/setup-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commerce-build/setup-flow.ts"],"sourcesContent":["import type { CommerceBuildView } from './contracts';\n\nexport type CommerceBuildSurfaceMode = 'workspace' | 'setup';\n\nexport type CommerceSetupStage =\n  | 'sources'\n  | 'profile'\n  | 'plan'\n  | 'draft';\n\nexport interface CommerceBuildSurfaceConfig {\n  showCompanionLinks: boolean;\n  showLaunchReadiness: boolean;\n  showProposalReview: boolean;\n}\n\nexport function resolveCommerceBuildSurface(\n  mode: CommerceBuildSurfaceMode,\n): CommerceBuildSurfaceConfig {\n  return {\n    showCompanionLinks: mode === 'workspace',\n    showLaunchReadiness: mode === 'workspace',\n    showProposalReview: mode === 'workspace',\n  };\n}\n\nexport function resolveCommerceSetupStage(\n  build: CommerceBuildView | null | undefined,\n): CommerceSetupStage {\n  if (build?.currentPreview?.previewId) {\n    return 'draft';\n  }\n\n  if (build?.currentSpec?.revision && build?.currentPlan?.revision) {\n    return 'plan';\n  }\n\n  if (build?.acceptedProfileRevision || build?.currentProfileRevision) {\n    return 'profile';\n  }\n\n  return 'sources';\n}\n"],"mappings":"AAgBO,SAAS,4BACd,MAC4B;AAC5B,SAAO;AAAA,IACL,oBAAoB,SAAS;AAAA,IAC7B,qBAAqB,SAAS;AAAA,IAC9B,oBAAoB,SAAS;AAAA,EAC/B;AACF;AAEO,SAAS,0BACd,OACoB;AACpB,MAAI,OAAO,gBAAgB,WAAW;AACpC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,aAAa,YAAY,OAAO,aAAa,UAAU;AAChE,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,2BAA2B,OAAO,wBAAwB;AACnE,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}