@lenso/remote-module-kit

Helpers for building out-of-process Lenso remote modules.

import {
  adminAction,
  declarativeCustom,
  defineRemoteModule,
  getRoute,
  runtimeFunction,
  serveRemoteModule,
} from "@lenso/remote-module-kit";

const manifest = defineRemoteModule({
  admin: declarativeCustom({
    actions: [
      adminAction("sync_contacts", {
        capability: "crm.contacts.sync",
        label: "Sync contacts",
      }),
    ],
  }),
  capabilities: ["crm.contacts.read"],
  httpRoutes: [getRoute("/contacts/{id}")],
  name: "crm",
  runtimeFunctions: [runtimeFunction("crm.contacts.enrich.v1")],
});

const server = await serveRemoteModule(manifest, {
  actions: {
    sync_contacts: ({ input }) => ({ input, synced: true }),
  },
  port: 4100,
});

console.log(server.manifestUrl);

Scripts

• pnpm build: emit JavaScript and declarations into dist/.
• npm pack --dry-run: build and inspect the publish tarball without uploading it.

Publishing

This package is published through the publish remote-module-kit GitHub Actions workflow. The npm package should be configured for trusted publishing with:

• repository: LioRael/lenso-runtime-console
• workflow: publish-remote-module-kit.yml

From the repository root, run the package preflight before opening a release PR:

pnpm package-readiness

After the release PR is merged, run the workflow from main with the package version from packages/remote-module-kit/package.json. The workflow verifies the version is not already published, runs pnpm package-readiness, and then publishes from packages/remote-module-kit.