@suluk/cockpit 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suluk/cockpit",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "The pure cockpit core (cycle model · builder model · codegen · deploy planning · validate/audit/preview) shared by the vscode extension and the /superadmin web admin panel. CANDIDATE tooling.",
   "type": "module",
   "main": "src/index.ts",

package/src/cycle.ts

@@ -14,6 +14,7 @@ import type { OpenAPIv4Document, Request, SchemaOrRef, SecurityRequirement } fro
 import { audit, coverage } from "@suluk/hono";
 import { formSpec, tableSpec } from "@suluk/shadcn";
 import { costAudit, costTable, formatMicroUsd } from "@suluk/cost";
+import { readProviders } from "@suluk/builder";
 
 export type LayerStatus = "ok" | "warn" | "error" | "info";
 
@@ -26,7 +27,7 @@ export interface CycleItem {
 }
 
 export interface CycleLayer {
-  id: "data" | "contract" | "auth" | "document" | "cost" | "docs" | "state" | "ui" | "tests";
+  id: "data" | "contract" | "auth" | "document" | "cost" | "docs" | "state" | "ui" | "providers" | "tests";
   title: string;
   status: LayerStatus;
   summary: string;
@@ -140,6 +141,14 @@ export function buildCycle(doc: OpenAPIv4Document, opts: { principal?: Principal
   const undeclared = costFindings.filter((f) => f.code === "no-cost-model").length;
   const costItems: CycleItem[] = declaredCosts.map((d) => ({ label: d.operation, ref: d.operation, detail: `${formatMicroUsd(d.estimateMicroUsd)} · ${d.sources.join(", ")}` }));
 
+  // ── providers: the swappable facet bindings recorded on the document (M3)
+  const providerBindings = readProviders(doc);
+  const providerItems: CycleItem[] = providerBindings.map((b) => ({
+    label: b.facet, ref: b.facet,
+    detail: `${b.title}${b.alternatives.length ? ` · ${b.alternatives.length} alternatives` : ""}`,
+    status: b.known ? undefined : "warn",
+  }));
+
   // ── tests: doc-level contract checks
   const checks = docChecks(doc);
   const testsItems: CycleItem[] = checks.map((c) => ({ label: c.name, status: c.pass ? "ok" : "error", detail: c.pass ? "pass" : c.message }));
@@ -168,6 +177,12 @@ export function buildCycle(doc: OpenAPIv4Document, opts: { principal?: Principal
     { id: "docs", title: "Docs", status: "ok", summary: "Scalar · Swagger", items: docsItems },
     { id: "state", title: "State (Nano Stores)", status: "ok", summary: `${stateItems.length} stores`, items: stateItems },
     { id: "ui", title: "UI (shadcn)", status: uiItems.length ? "ok" : "info", summary: `${uiItems.length} forms/tables`, items: uiItems },
+    {
+      id: "providers", title: "Providers",
+      status: providerItems.length ? "ok" : "info",
+      summary: providerItems.length ? providerBindings.map((b) => `${b.facet}→${b.impl}`).join(" · ") : "none",
+      items: providerItems,
+    },
     {
       id: "tests", title: "Tests (contract checks)",
       status: checks.every((c) => c.pass) ? "ok" : "error",

package/src/index.ts

@@ -11,7 +11,7 @@ export { entityNames, generateForm, generateTable, generateStoresModule, exportV
 export { deployPlan, deployMarkdown } from "./deploy";
 export type { DeployPlan, DeployStep, DeployProvider } from "@suluk/deploy";
 // drift (OBSERVE): compare a LOCAL contract against a DEPLOYED one — the "what's drifted in prod" view (C020).
-export { diffContracts, canonical, type ContractDiff, type ChangedOp, type OpRef } from "./drift";
+export { diffContracts, canonical, type ContractDiff, type ChangedOp, type OpRef, type ProviderDelta, type ProviderChange } from "./drift";
 // cross-cut (M1): one contract refracted through every viewer — the scope-gated surface, the moat.
 export { crossCut, documentScopes, defaultViewers, type Viewer, type ViewerView, type GatedOp, type CrossCut } from "./crosscut";
 // cost formatting, re-exported so the extension shell can render a live /cost ledger without a direct @suluk/cost dep.
@@ -20,5 +20,8 @@ export { formatMicroUsd, summarize, type CostSummary } from "@suluk/cost";
 export {
   installModule, namespaceModule, previewInstall, gradeModule,
   ECOMMERCE, CRM, BILLING, FIRST_PARTY_REGISTRY,
+  PROVIDER_CATALOG, providerFacets, readProviders, swapProvider,
+  parseRegistry, validateModule,
   type SulukModule, type InstallResult, type ModuleEntry, type ModuleRegistry, type ModuleGrade, type InstallPreview,
+  type ProviderImpl, type ProviderBinding, type RegistrySource, type ParsedRegistry,
 } from "@suluk/builder";

package/test/cycle.test.ts

@@ -14,8 +14,8 @@ const petstore = parseDocument(petstoreSrc);
 describe("buildCycle — the cockpit spine (every layer from one hub)", () => {
   const model = buildCycle(petstore);
 
-  test("models all nine layers (incl. cost)", () => {
-    expect(model.layers.map((l) => l.id)).toEqual(["data", "contract", "auth", "document", "cost", "docs", "state", "ui", "tests"]);
+  test("models all ten layers (incl. cost + providers)", () => {
+    expect(model.layers.map((l) => l.id)).toEqual(["data", "contract", "auth", "document", "cost", "docs", "state", "ui", "providers", "tests"]);
   });
   test("the cost layer reflects declared costs (x-suluk-cost) — none on the bare petstore", () => {
     expect(model.layers.find((l) => l.id === "cost")!.summary).toBe("no costs declared");
@@ -110,6 +110,6 @@ describe("codegen actions land real artifacts", () => {
 
 describe("cycleSummary — flat status line", () => {
   test("returns one entry per layer", () => {
-    expect(cycleSummary(buildCycle(petstore)).length).toBe(9);
+    expect(cycleSummary(buildCycle(petstore)).length).toBe(10);
   });
 });

package/test/drift.test.ts

@@ -139,6 +139,15 @@ paths: { "p": { requests: { g: { method: get, responses: { ok: { status: 200 } }
     expect(c.changes.some((x) => x.includes("shape"))).toBe(true); // the residual is not suppressed
   });
 
+  test("provider-slot drift (x-suluk-providers) is reported", () => {
+    const local = { openapi: "4.0.0-candidate", info: { title: "T", version: "1.0.0" }, paths: {}, "x-suluk-providers": { payments: "paddle", email: "resend" } } as unknown as Parameters<typeof diffContracts>[0];
+    const deployed = { openapi: "4.0.0-candidate", info: { title: "T", version: "1.0.0" }, paths: {}, "x-suluk-providers": { payments: "stripe" } } as unknown as Parameters<typeof diffContracts>[0];
+    const d = diffContracts(local, deployed);
+    expect(d.identical).toBe(false);
+    expect(d.providers.changed).toEqual([{ facet: "payments", from: "stripe", to: "paddle" }]);
+    expect(d.providers.added).toEqual([{ facet: "email", impl: "resend" }]);
+    expect(d.summary).toContain("providers");
+  });
   test("canonical() is cycle-safe (does not overflow the stack)", () => {
     const a: Record<string, unknown> = { x: 1 };
     a.self = a;

package/test/module-cycle.test.ts

@@ -43,4 +43,10 @@ describe("installModule → the cockpit cycle lights up", () => {
   test("the document still validates against the v4 meta-schema after the merge", () => {
     expect(after.valid).toBe(true);
   });
+  test("the Providers layer lights up with the module's provider slot (payments→stripe)", () => {
+    const providers = layer(after, "providers");
+    expect(providers.summary).toContain("payments→stripe");
+    expect(providers.items.map((i) => i.label)).toContain("payments");
+    expect(layer(before, "providers").summary).toBe("none"); // the host had no provider slots
+  });
 });