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 déclarationsSELECT 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 Oui
@lssm-tech/module.integration-hub/renderers renderIntegrationMarkdown Oui
@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)

Développement

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
Votre vue

Make room for your context.

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

Votre contexte

The different parts of you

Choose a starting point

Un mélange utile de contexte, de visuels et de guidage discret.

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

Confort de lecture

Choisir votre langue

La langue de l’interface change uniquement le texte. Les marchés, les prix et les parcours conservent leurs propres paramètres.

Couverture des traductions

Une partie du contenu est affichée en anglais.

Navigation151
Graphe616
Catégories378
Portfolio833
Exemples2 035
Aperçu de la source1 542

D’autres traductions seront ajoutées à mesure que le contenu sera relu.

Cette préférence est enregistrée dans ce navigateur.

Rechercher sur le site

Des points de départ utiles

Aucun résultat. Essayez une expression plus courte, un nom d’opération ou un autre périmètre de recherche.

UN PEU DE PLACE POUR EXPLORER

Trouvez quelque chose à explorer.

Ouvrez un aperçu détaillé sur cette page, essayez une autre perspective ou suivez le détail vers sa propre page.

Fonctionnement des aperçus et des commandes
01

Regarder avant de partir

Survolez un lien ou sélectionnez-le avec Tab pour voir un aperçu. Cliquer sur le lien d’origine ou appuyer sur Entrée ouvre toujours sa destination.

02

Rester dans le contexte

Entrez dans l’aperçu pour explorer ses sections. Depuis un lien sélectionné, utilisez Alt + ↓ pour y entrer au clavier. Échap le ferme.

03

Ouvrir les possibilités

Les lignes dépliables, les choix de perspective et les commandes mises en évidence révèlent davantage. Votre vue adapte le confort de lecture et le contexte exploré.

Un bouton séparé pour voir de plus près

Affichez de petits boutons d’aperçu à côté des liens quand l’espace le permet. Touchez l’œil pour examiner ou le lien pour y aller directement. Ce choix reste dans cet onglet.

Aucun historique de navigation n’est collecté. La réduction des animations suit votre appareil et Votre vue.