Skip to content
ContractSpec
Start here

Package manual · bundles

·Content, growth and creator operations

bundle.creator-platform

Headless reusable creator platform foundation with governed optional surfaces.

bundlesbundlev3.1.4stableservernode
@lssm-tech/bundle.creator-platform
bun add @lssm-tech/bundle.creator-platform
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Headless reusable creator-platform foundations with governed design selection, gamification helpers, operations ports, server composition, Studio composition, and deterministic fixtures.

The optional ./creator-operations entrypoint now binds the canonical reusable campaign, agreement, submission, accrual, wallet and settlement module. Inject a transactional creator store, current authority and qualified settlement provider. This additive scope follows specs/marketing-creator-operations-v1/REPO-OWNERSHIP.md; application records, credentials, accepted agreements and migration ownership remain with the host. Existing creator APIs and the earlier draft/human-only surfaces keep their previous behavior. Full Hirly parity and live payment qualification are pending.

Import the root only for the manifest and readiness report. Use ./design, ./gamification, ./operations, ./server, ./studio, and ./testing explicitly. Optional React surfaces live at ./ui/design-picker, ./ui/analytics, ./ui/auth, ./ui/gamification, and ./ui/review; governed publishing composition lives at ./publishing. Recommendations never persist or activate a design. Applications own creator data, routes, persistence, campaign rules, payouts, provider credentials, copy, schedules, and experiments.

AI-native operations are exposed only through optional subpaths: ./analysis, ./intelligence, ./learning, ./coaching, and ./authority. The authority resolver composes system, workspace, campaign, consent, and request constraints; lower scopes can narrow authority but cannot broaden it. Consequential creator, campaign, publication, communication, ranking, and money actions are human-only.

./readiness exposes the executable end-to-end capability matrix and validation helpers. ./experience resolves explicit RoleMorph presentation hints, creator role lenses, and design-catalog selections without granting authority. ./ui/experience provides the responsive, accessible Creator Operations Cockpit: next actions, campaigns, evidence-backed signals, coaching, momentum, gamification, and system coverage in one role-aware home. It uses Design System primitives, Creator design packs, Design Studio composition, and synchronized English, French, and Spanish operator copy.

The gamification UI composes @lssm-tech/module.gamification; review uses the product-neutral @lssm-tech/module.human-review rather than the CompanyOS review queue. A credential-free complete composition is available in @lssm-tech/example.creator-platform-foundation.

Stable release additionally requires the visual matrix, clean canary install, and credentialed official-provider smoke tests listed by creatorPlatformReadiness().

learning/native-training provides a pure compatibility adapter for existing app-owned creator-training records. It maps native Date/null fields and reset notices into the shared snapshot, and produces a DB update patch using the shared transition engine. The native boundary retains French/English locales and existing output keys. Existing transactions, request receipts, authorization and canonical write ownership stay in Hirly. This adapter does not migrate data or install a second writer.

Run bun scripts/check-creator-training-compatibility.ts --source-root <creator-platform> from the ContractSpec root to compare the adapter against the current native pure transition block. The report records source hashes and explicitly excludes database, authorization, request-receipt and deployment behavior from its compatibility claim.

learning/posting-streak maps the shared timezone-explicit calendar projection to native Sunday–Saturday slot labels and numbering. Supply participant timezone and current ISO instant explicitly. This adapter does not mutate XP, streak records or compensation.

learning/native-quiz-key maps existing native quiz definitions into private versioned keys, preserving the native 67-percent fallback. Use only in server-owned scoring configuration and bind revision to immutable source content. The mapper omits prompts and labels but still contains correct answers; never return it to learners.

learning/native-quiz-view explicitly projects localized titles, questions and choices from a native definition while omitting correct answers and incidental metadata. Run the mapper server-side and send only its validated result to learners; do not ship the source definition or private key mapper in a learner bundle.

learning/native-quiz-loader composes enrollment-authorized course lookup with private native content loading and learner-safe projection. It verifies course scope, quiz/module membership, requested locale and exact quiz revision before returning public content. Enrollment and native content sources remain app-owned ports.

./tracking/connected-accounts, ./tracking/disconnect-impact, ./tracking/connection-outcome and ./tracking/brand-social-accounts present host-supplied, nonsecret connection projections; they never grant posting, publishing or payout authority.

./publishing/queue and ./publishing/queue-presentation parse the creator publishing queue fail-closed (viewer/creator binding, manual_only, at most 50 items, no duplicates or unknown states, unlisted fields dropped) and present its seven checks in English and French; a test-only account is never provider qualified and nothing grants posting, publishing or payout authority.

./publishing/queue-assembly assembles that queue as a pure function over records the host has already authorized (source exclusion counts, approved-version de-duplication, rights/licence-start mapping, 50-item page and cursor); duplicate or foreign records refuse the whole assembly and authorization stays the host's precondition.

./ui/experience/PublicOverview.web renders an explanatory public overview from brand-supplied copy, locale links, logo and CSS classes. Its data-only model is available at ./ui/experience/public-overview. The screen is web-only and is not re-exported by the root or generic experience/native entries. It uses the existing MarketingLandingPage, HStack, Box and Text exports and grants no workspace access.

Relationships

THIS PACKAGEbundle.creator-platform66 import paths

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

23 declarations

Declared capabilities

Bundle Creator Platform

Headless reusable creator platform foundation with governed optional surfaces.

Creator Platform public overview web UI

An explanatory web overview rendered from caller-supplied brand, locale links and copy, with a separate data-only model; it grants no workspace or action authority.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • lint:checknode ../../../scripts/biome.cjs check .
  • testbun test
  • typechecktsgo --noEmit