Buncha Games World Provider Kit

@bunchagames/world-provider-kit is the secret-free preparation toolkit for approved World game/provider repositories. It validates WorldProviderCandidateV1, creates deterministic artifact packages, runs non-official local/integration preflight, and builds privacy-safe handoffs for the existing Buncha Games platform task.

It does not review manifests, issue official certification, write the registry, deploy providers, apply migrations, register or activate Worlds, enable private or public capabilities, suspend providers, or apply rollbacks.

The published 0.1.2 package includes the optional provider-cloud-draft-persistence and creator-lifecycle-notifications declarations, strict unofficial evidence, and programmatic provider-owned adapter runners. Publication grants no review, certification, registry, deployment, or activation authority.

Version 0.1.2 narrows credential-assignment scanning at JavaScript token boundaries so ordinary minified loader variables are packageable without weakening detection of embedded credential values.

Source version 0.1.3 is the unpublished Queue resource-kind release candidate. It adds queue to the Candidate V1 logical resource inventory without adding resource creation, deployment, registry, or activation authority. The registry-verified public baseline remains 0.1.2 until the separate publication gate completes.

Cloud-draft preparation

Opt in only when the World has a provider-owned mutable-project design:

import {
  createCandidateTemplate,
  runWorldCloudDraftProviderPreflight
} from "@bunchagames/world-provider-kit";

const candidate = createCandidateTemplate({
  key: "issued-world-key",
  slug: "issued-world-slug",
  parentGameId: "00000000-0000-4000-8000-000000000000",
  profile: "canonical-managed-first-party",
  cloudDrafts: true,
  creatorLifecycleNotifications: true
});

const evidence = await runWorldCloudDraftProviderPreflight({
  adapter: providerOwnedAdapter,
  candidate,
  environment: "local",
  fixtures: { initial: initialFixture, changed: changedFixture },
  payloadAndRetentionAssumptions,
  observedAt: new Date().toISOString()
});

The adapter maps provider-specific routes and project schemas to normalized operations. Opaque project/revision handles and content stay in memory; the result contains only bounded scenario results and usage meters. The CLI never imports or executes adapter modules. Give the validated JSON to worlds provider preflight --cloud-draft-evidence and worlds handoff build --cloud-draft-evidence.

Provider preflight is not official certification and cannot approve cost, deploy a provider, write the registry, or enable cloud drafts.