{"id":"@lssm-tech/integration.lssm-os-ingress-mqtt","slug":"integration.lssm-os-ingress-mqtt","name":"@lssm-tech/integration.lssm-os-ingress-mqtt","version":"2.0.4","path":"packages/integrations/lssm-os-ingress-mqtt","manifestPath":"packages/integrations/lssm-os-ingress-mqtt/package.json","manifestBlobSha":"cb8080b598ef1280437869ae0055bb6c726dd63f","layer":"integrations","physicalArea":null,"primaryArea":"delivery-and-infrastructure","classification":{"privateDeclared":null,"catalogFamily":"integrations","catalogKind":"integration","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Authenticated MQTT publication normalization into the LSSM OS durable inbox.","descriptionOrigin":"package.json","catalog":{"family":"integrations","kind":"integration","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["bun","node"],"entrypoints":["."],"documentation":[{"title":"LSSM OS MQTT ingress","url":"https://www.npmjs.com/package/%40lssm-tech%2Fintegration.lssm-os-ingress-mqtt","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"lssm-os.ingress.mqtt","title":"Authenticated MQTT ingress","description":"Validate and normalize qualified MQTT publications into the durable LSSM OS inbox without granting MQTT work-queue or execution authority.","status":"active","useCases":["Admit MQTT 3.1.1 or 5.0 publications through a trusted normalizer","Enforce topic, QoS, session, expiry, authentication, payload, and broker capability policy before durable admission"],"aliases":["MQTT","IoT ingress","durable inbox"],"pythonEquivalents":["paho-mqtt ingress adapter"],"canonicalImports":[{"from":"@lssm-tech/integration.lssm-os-ingress-mqtt","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["bun","node"],"avoidWhen":["MQTT publications are expected to bypass ordinary operation, Connect, work-order, claim, or fence authority.","The broker and topic binding cannot be qualified exactly or payload bounds cannot be enforced before admission."],"requires":["MQTT broker adapter","trusted normalizer","LSSM OS durable inbox"]},"alternatives":[],"relationships":[],"resolutionPriority":65}]},"canonicalImports":[{"capabilityId":"lssm-os.ingress.mqtt","from":"@lssm-tech/integration.lssm-os-ingress-mqtt","symbols":[]}],"scripts":{"build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","lint:check":"node ../../../scripts/biome.cjs check .","pack:verify":"bun run build && bun scripts/verify-pack.ts","test":"bun test","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.lssm-os-runtime":"^2.1.1","@lssm-tech/lib.orchestration-spec":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","@types/bun":"catalog:types","typescript":"^7.0.2"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./adapter":"./src/adapter.ts","./dependencies":"./src/dependencies.ts","./invoke":"./src/invoke.ts","./result":"./src/result.ts","./snapshot":"./src/snapshot.ts","./types":"./src/types.ts","./validation":"./src/validation.ts","./validation-publication":"./src/validation-publication.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./adapter":{"types":"./dist/adapter.d.ts","browser":"./dist/browser/adapter.js","bun":"./dist/adapter.js","node":"./dist/node/adapter.js","default":"./dist/adapter.js"},"./dependencies":{"types":"./dist/dependencies.d.ts","browser":"./dist/browser/dependencies.js","bun":"./dist/dependencies.js","node":"./dist/node/dependencies.js","default":"./dist/dependencies.js"},"./invoke":{"types":"./dist/invoke.d.ts","browser":"./dist/browser/invoke.js","bun":"./dist/invoke.js","node":"./dist/node/invoke.js","default":"./dist/invoke.js"},"./result":{"types":"./dist/result.d.ts","browser":"./dist/browser/result.js","bun":"./dist/result.js","node":"./dist/node/result.js","default":"./dist/result.js"},"./snapshot":{"types":"./dist/snapshot.d.ts","browser":"./dist/browser/snapshot.js","bun":"./dist/snapshot.js","node":"./dist/node/snapshot.js","default":"./dist/snapshot.js"},"./types":{"types":"./dist/types.d.ts","browser":"./dist/browser/types.js","bun":"./dist/types.js","node":"./dist/node/types.js","default":"./dist/types.js"},"./validation":{"types":"./dist/validation.d.ts","browser":"./dist/browser/validation.js","bun":"./dist/validation.js","node":"./dist/node/validation.js","default":"./dist/validation.js"},"./validation-publication":{"types":"./dist/validation-publication.d.ts","browser":"./dist/browser/validation-publication.js","bun":"./dist/validation-publication.js","node":"./dist/node/validation-publication.js","default":"./dist/validation-publication.js"}},"types":"./dist/index.d.ts","files":["dist","!dist/**/*test*","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./adapter","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/adapter","target":"./src/adapter.ts","targets":[{"conditions":[],"target":"./src/adapter.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/adapter.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/adapter.ts","sourceStatus":"verified source file"}]},{"subpath":"./dependencies","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/dependencies","target":"./src/dependencies.ts","targets":[{"conditions":[],"target":"./src/dependencies.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/dependencies.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/dependencies.ts","sourceStatus":"verified source file"}]},{"subpath":"./invoke","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/invoke","target":"./src/invoke.ts","targets":[{"conditions":[],"target":"./src/invoke.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/invoke.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/invoke.ts","sourceStatus":"verified source file"}]},{"subpath":"./result","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/result","target":"./src/result.ts","targets":[{"conditions":[],"target":"./src/result.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/result.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/result.ts","sourceStatus":"verified source file"}]},{"subpath":"./snapshot","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/snapshot","target":"./src/snapshot.ts","targets":[{"conditions":[],"target":"./src/snapshot.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/snapshot.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/snapshot.ts","sourceStatus":"verified source file"}]},{"subpath":"./types","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/types","target":"./src/types.ts","targets":[{"conditions":[],"target":"./src/types.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/types.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/types.ts","sourceStatus":"verified source file"}]},{"subpath":"./validation","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/validation","target":"./src/validation.ts","targets":[{"conditions":[],"target":"./src/validation.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/validation.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/validation.ts","sourceStatus":"verified source file"}]},{"subpath":"./validation-publication","importPath":"@lssm-tech/integration.lssm-os-ingress-mqtt/validation-publication","target":"./src/validation-publication.ts","targets":[{"conditions":[],"target":"./src/validation-publication.ts","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/src/validation-publication.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/src/validation-publication.ts","sourceStatus":"verified source file"}]}],"entryCount":9,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"LSSM OS MQTT ingress","url":"https://www.npmjs.com/package/%40lssm-tech%2Fintegration.lssm-os-ingress-mqtt","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/integration.lssm-os-ingress-mqtt.txt"},"readme":{"status":"available","body":"# LSSM OS MQTT ingress\n\nThis package accepts qualified MQTT 3.1.1/5.0 publications and normalizes them\nthrough an injected trusted normalizer into the durable LSSM OS inbox. MQTT is\nnever a work queue or execution-authority source. Topic scope, QoS, session,\nexpiry, authentication reference, payload bounds, and exact broker capability\nare validated before durable admission. Business execution still requires the\nordinary Runtime Node operation, Connect decision, work order, claim, and fence.\n\nProduction composition uses `createMqttIngressBrokerV2`. It binds the MQTT\ntransport profile separately from the authoritative durable-queue profile,\nrequires both components to share exact scope/topology/generation, and accepts\nonly a source-digest-bound durable admission receipt. The additive\n`createDurableQueueIngressV1` runtime helper derives the outbox identity from\nthe immutable publication digest and admits through the existing Durable Queue\nV2 port. PostgreSQL can therefore remain the complete queue and inbox authority\nwhile MQTT supplies only authenticated ingress.\n\n`createMqttIngressBrokerV1` remains available as a compatibility-only\nsingle-binding constructor. New deployments should not use it to claim an\nindependently qualified MQTT transport and SQL durability component.\n","sourcePath":"packages/integrations/lssm-os-ingress-mqtt/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/integrations/lssm-os-ingress-mqtt/README.md","blobSha":"4908ca5256793561c97e64e7924508a242d69af3","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"delivery-and-infrastructure","areaTitle":"Delivery, infrastructure and runtime operations","displayName":"integration.lssm-os-ingress-mqtt","runtimes":["bun","node"],"platforms":["server"],"kind":"integration","scope":"Package manifest","canonicalRoute":"/docs/packages/integration.lssm-os-ingress-mqtt/","contextUrl":"/docs/packages/integration.lssm-os-ingress-mqtt.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}