modulePackage manifestv2.0.5

module.integration-hub

Scoped integration-hub module — 3 genuinely reusable primitives (useIntegrationData, useCredentialSetup, renderIntegrationMarkdown) promoted from examples/integration-hub. RSC-directive boundaries are explicit.

@lssm-tech/module.integration-hub
Source, release and verification context

Source snapshot bcc79fcc · Declared package version 2.0.5. This page combines the checked-in package guide and manifest; commands and runtime behavior were not executed in this review.

Package source ↗ Manifest ↗
servernode
EXPLORE THE PACKAGE

See where this package fits.

Follow a declared connection, inspect an import, then open the source guide when you need the detail.

THIS PACKAGEmodule.integration-hubplatform

Arrows point from a package to its direct dependency. Each count is derived from the captured manifests.

4 declarationsSELECT TO INSPECT

@lssm-tech/module.integration-hub

Scoped module hosting four reusable integration-hub primitives. Intentionally narrow — any new export requires a planning loop.

Installation

bash
bun add @lssm-tech/module.integration-hub

Exports

Import path Exports RSC-safe?
@lssm-tech/module.integration-hub/hooks useIntegrationData, useCredentialSetup No — use in client components only
@lssm-tech/module.integration-hub/model buildCredentialSetupModel, credential-setup types, deployment-topology types and validator Yes
@lssm-tech/module.integration-hub/renderers renderIntegrationMarkdown Yes
@lssm-tech/module.integration-hub All of the above Use sub-paths to preserve RSC boundaries

Quick start

Loading integration data (client component)

typescript
'use client';
import { useIntegrationData, type IntegrationDataPort } from '@lssm-tech/module.integration-hub/hooks';

const port: IntegrationDataPort = {
  listIntegrations: (input) => fetch(`/api/integrations?projectId=${input.projectId}`).then(r => r.json()),
  listConnections:  () => fetch('/api/connections').then(r => r.json()),
  listSyncConfigs:  () => fetch('/api/syncs').then(r => r.json()),
};

export function IntegrationCatalog({ projectId }: { projectId: string }) {
  const { integrations, loading, error, stats } = useIntegrationData({ projectId, port });

  if (loading) return <p>Loading…</p>;
  if (error)   return <p>Error: {error.message}</p>;

  return (
    <ul>
      {integrations.map(i => <li key={i.id}>{i.name} — {i.status}</li>)}
    </ul>
  );
}

Credential setup wizard (client component)

typescript
'use client';
import { useCredentialSetup } from '@lssm-tech/module.integration-hub/hooks';
import { buildCredentialSetupModel, type CredentialManifest } from '@lssm-tech/module.integration-hub/model';

const manifest: CredentialManifest = {
  modes: {
    managed: { secretFields: [{ key: 'API_KEY', required: true }] },
    byok:    { configFields: [{ key: 'ENDPOINT', required: true }] },
  },
};

export function CredentialWizard() {
  const { state, advance, reset, setMode } = useCredentialSetup();

  const model = buildCredentialSetupModel({
    mode: state.mode,
    manifest,
    environment: { variables: {}, targets: {} },
    runtime: { configValues: {}, secretRefs: {}, targetIds: [] },
  });

  return (
    <div>
      <p>Step {state.step} / 3 — mode: {state.mode}</p>
      <p>Missing secrets: {model.missingSecrets.length}</p>
      <button onClick={advance}>Next</button>
      <button onClick={reset}>Reset</button>
    </div>
  );
}

Rendering a markdown card (RSC-safe)

typescript
// Works in React Server Components — no 'use client' needed
import { renderIntegrationMarkdown } from '@lssm-tech/module.integration-hub/renderers';

export async function IntegrationCard({ id }: { id: string }) {
  const integration = await fetchIntegration(id);
  const markdown = renderIntegrationMarkdown({
    id: integration.id,
    name: integration.name,
    description: integration.description,
    category: integration.category,
    status: integration.status,
    connectionCount: integration.connections.length,
  });
  return <MarkdownRenderer content={markdown} />;
}

RSC directive boundaries

Hooks carry 'use client' — import them only in client components. Model types and the markdown renderer have no directive and are safe to import anywhere, including React Server Components. See AGENTS.md for the full boundary table and lint rules.

Deployment topology

validateIntegrationDeploymentTopology models service operator, runtime and data placement, credential custody, identity trust, API commercial mode, network policy, residency, and evidence placement as independent axes. It is a pure fail-closed validator: customer API keys cannot be assigned to an LSSM-only vault, and air-gapped profiles cannot depend on live central identity or remote managed data.

The model subpath re-exports the canonical provider-neutral topology contract from @lssm-tech/lib.contracts-integrations. The Hub accepts an optional integration.topology-evidence read port for a secret-free, freshness-bounded provider receipt tied to an exact workspace or connection digest. Installing the port does not verify the provider by itself; only an adapter that has verified its native durable receipt may project this evidence.

What this package does NOT include

  • CompanyOS-specific chrome or view-models (those live in bundle.managed-companyos)
  • RedactedCredentialChip (stays in the bundle pending second consumer)
  • Any example fixtures or mock data (see examples/integration-hub)

Development

bash
bun test --cwd packages/platform/delivery/integration-hub
bun run --cwd packages/platform/delivery/integration-hub typecheck

Feature Hub profile

./hub exports IntegrationFeatureHub, defineIntegrationHub, and installIntegrationHub. The profile uses the canonical platform.integrations feature registry, mounts at /integrations, and depends only on the provider-neutral integration.catalog and integration.connection ports. Its route catalog covers detail, connections, syncs, configuration, credentials/secrets, health, audit, and installation; activation supports both managed credentials and BYOK secret references. integration.topology-evidence is optional so existing installations remain compatible and missing proof remains explicit.

Declared capabilities.

Module Integration Hub

Scoped integration-hub module — 3 genuinely reusable primitives (useIntegrationData, useCredentialSetup, renderIntegrationMarkdown) promoted from examples/integration-hub. RSC-directive boundaries are explicit.

Use it to

  • Adopt scoped integration-hub module — 3 genuinely reusable primitives (useintegrationdata, usecredentialsetup, renderintegrationmarkdown) promoted from examples/integration-hub. rsc-directive boundaries are explicit

Requires

  • TypeScript

Choose another boundary when

  • The @lssm-tech/module.integration-hub package constraints do not match the target runtime or platform.

@lssm-tech/module.integration-hub

@lssm-tech/module.integration-hub/hooks

@lssm-tech/module.integration-hub/hooks/useCredentialSetup

@lssm-tech/module.integration-hub/hooks/useIntegrationData

@lssm-tech/module.integration-hub/hub

@lssm-tech/module.integration-hub/hub/catalog

@lssm-tech/module.integration-hub/hub/integration-hub

@lssm-tech/module.integration-hub/hub/ports

@lssm-tech/module.integration-hub/hub/presentation

@lssm-tech/module.integration-hub/model

@lssm-tech/module.integration-hub/model/credential-setup

@lssm-tech/module.integration-hub/model/deployment-topology

Imports and export paths.

14 entries

These are package-manifest entry points. Named symbols listed above come from the capability catalogue; this is not an exhaustive TypeScript symbol reference.

14 imports

Dependencies and related packages.

Runtime dependencies 4
react
catalog:
Development dependencies 4
@types/react
catalog:types
typescript
catalog:

Package scripts.

Commands declared by this package. Review its setup requirements before running them; no command here was executed by this review.

publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
publish:pkg:canarybun publish:pkg --tag canary
buildcontractspec-bun-build build
build:bundlecontractspec-bun-build transpile
build:typescontractspec-bun-build types
devcontractspec-bun-build dev
cleanrimraf dist .turbo
lintbun lint:fix
lint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .
lint:checknode ../../../../scripts/biome.cjs check .
testbun test --pass-with-no-tests
prebuildcontractspec-bun-build prebuild
typechecktsgo --noEmit
Your view

Make room for your context.

Shape the presentation around this moment. You can change it whenever you need.

Your context

The different parts of you

Choose a starting point

A useful mix of context, visuals and gentle guidance.

Tune each dimension
Each dimension can change independently. Product permissions and available actions stay unchanged.

Support the way you begin and return

Tune your support

Reading comfort

Choose your language

Interface language changes text only. Markets, prices and workflows keep their own settings.

Translation coverage

Original source

Navigation151
Graph616
Categories378
Portfolio833
Examples2,035
Source preview1,542

More translations will be added as content is reviewed.

This preference is saved on this browser.

Search the website

Useful starting points

No results. Try a shorter phrase, an operation name or another search area.

A LITTLE ROOM TO EXPLORE

Find something to explore.

Open a closer look on this page, try a different perspective, or follow the detail into its own page.

How previews and controls work
01

Look before you leave

Hover a link or focus it with Tab to see a preview. Clicking the original link or pressing Enter always opens its destination.

02

Stay with the context

Move into the preview to explore its sections. Use Alt + ↓ from a focused link to enter it with the keyboard. Escape closes it.

03

Open the possibilities

Disclosure rows, perspective choices and highlighted controls reveal more. Your view changes reading comfort and the context you explore.

A separate button for a closer look

Show small preview buttons beside links where there is room. Tap the eye to inspect, or tap the link to go straight there. This choice stays in this tab.

No browsing history is collected. Reduced motion follows your device and Your view.