integration.provider-higgsfield
Tenant-isolated asynchronous Higgsfield media provider.
@lssm-tech/integration.provider-higgsfieldbun add @lssm-tech/integration.provider-higgsfieldManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Tenant-isolated HTTP adapter for asynchronous images, image-to-video, and talking presenters. Uses the protocol documented in the official Higgsfield TypeScript SDK. The SDK's current v2 implementation stores credentials globally and retries POSTs; this adapter instead resolves credentials per scoped call and submits once.
Inject credentials, trusted authorization, and exact input/output asset host allowlists. The authority port must check durable request/job ownership, current rights, qualification, and cost reservation. It must never authorize from caller strings alone. Use durable orchestration before calling submit; this low-level adapter does not itself provide idempotent submission storage.
For durable orchestration use lib.content-gen/media/workflow with SqlMediaGenerationStore from integration.growth-persistence/marketing. It saves the provider request ID before asset ingestion and resumes failed imports through an idempotent, host-qualified artifact ingestor.
An uncertain submission returns unknown; never resubmit automatically. Poll only known provider job IDs. Ignore provider-returned status/cancel URLs and use the pinned API origin. Cancellation is unavailable until its semantics are qualified. Outputs are temporary locations to ingest into the host asset store, not publication approvals. Responses and errors never include provider headers or raw error bodies.
BYOK only. Managed provisioning, MCP transport, and live provider certification remain unqualified. HTTP fixture tests do not certify account/model access.
Reference: https://github.com/higgsfield-ai/higgsfield-js
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
1 declarations
@lssm-tech/lib.contracts-integrationsworkspace:^
Read the package manual ↗
Declared capabilities
Provider integration for Higgsfield media workflows.
Scripts
buildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typescleanrimraf dist .turbodevcontractspec-bun-build devlint:checknode ../../../scripts/biome.cjs check .lint:fixnode ../../../scripts/biome.cjs check --write .prebuildcontractspec-bun-build prebuildtestbun testtypechecktsgo --noEmitpublish:pkgbun publish --tolerate-republish --ignore-scripts --verbose