bundle.creator-platform
Headless reusable creator platform foundation with governed optional surfaces.
@lssm-tech/bundle.creator-platformbun add @lssm-tech/bundle.creator-platformManifest 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
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
23 declarations
@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗@lssm-tech/integration.social-tracking-runtimeworkspace:^
Read the package manual ↗@lssm-tech/lib.authos-runtimeworkspace:^
Read the package manual ↗@lssm-tech/lib.content-analysis-runtimeworkspace:^
Read the package manual ↗@lssm-tech/lib.content-analysis-specworkspace:^
Read the package manual ↗@lssm-tech/lib.creative-intelligence-runtimeworkspace:^
Read the package manual ↗
Declared capabilities
Headless reusable creator platform foundation with governed optional surfaces.
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 buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typeslint:checknode ../../../scripts/biome.cjs check .testbun testtypechecktsgo --noEmit