Skip to content
ContractSpec
Start here

Package manual · integrations

·Integrations and provider selection

integration.provider-higgsfield

Tenant-isolated asynchronous Higgsfield media provider.

integrationsintegrationv0.2.4experimentalserverbunnode
@lssm-tech/integration.provider-higgsfield
bun add @lssm-tech/integration.provider-higgsfield
Package source ↗Manifest ↗

Manifest 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

THIS PACKAGEintegration.provider-higgsfield5 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

1 declarations

Declared capabilities

Higgsfield provider

Provider integration for Higgsfield media workflows.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • cleanrimraf dist .turbo
  • devcontractspec-bun-build dev
  • lint:checknode ../../../scripts/biome.cjs check .
  • lint:fixnode ../../../scripts/biome.cjs check --write .
  • prebuildcontractspec-bun-build prebuild
  • testbun test
  • typechecktsgo --noEmit
  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose