PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

0.1.2

npm

@0xhoneyjar/quests-engine

Headless quest engine — substrate-step dispatch bridging (gateway → construct → resolution) + future quest publish/query/complete/claim flows. Framework-agnostic. The construct is OPENED via Effect Requirements; consumers plug in their own grader.

effectenginefreesidequestsstate-machine
Published4 May 2026
Direct dependencies6
Transitive dependenciesNot calculated

README

Current package documentation

packages/engine — headless quest logic

The core quest engine library. Stateful where needed; framework-agnostic. What cubquests-dashboard/actions/* becomes when the operator-dashboard chrome is stripped from the engine logic.

Status: scaffolded; content extraction pending

Source: world-sprawl/cubquests-dashboard/actions/ + world-sprawl/cubquests/apps/frontend/lib/. Per ../../docs/EXTRACTION-MAP.md.

Planned contents (post-extraction)

filepurpose
publish.tsQuest publishing flow (validate, persist via injected port, emit completion event). Logic only; DB binding is swappable.
queries.tsCached quest queries; cache layer parameterized.
loader.tsQuest discovery + filtering logic.
generators.tsQuest authoring helpers (generate-input + generate-json + diff utilities).
diff.tsQuest-version diff utility (find-json-differences).
claim/Consumer-side claim flow (validate completion, mint badge, emit event). Currently inline in cubquests' apps/frontend/lib/.
index.tsPublic exports

Why "headless"

The engine has logic that operates on schemas + ports. It does NOT:

  • Render UI (that's packages/ui/)
  • Talk directly to a specific DB (that's adapter-injected)
  • Know about Next.js / SvelteKit / framework specifics
  • Own the partner integrations (those stay in CubQuests)

This makes the engine reusable: any app (Purupuru, Honey Port, Mibera, future) can install + wire up the engine to its own UI + DB + chain integrations.

Composition

  • Imports types + schemas from ../protocol/
  • Implements ports declared in ../ports/
  • Doesn't import ../ui/ (rendering is downstream)
  • Doesn't import ../adapters/ (adapters compose with the engine; engine doesn't depend on transport)

Consumers

  • world-sprawl/cubquests-dashboard/ — post-extraction, dashboard wires its actions to call engine functions instead of inline logic
  • world-sprawl/cubquests/apps/frontend/ — claim flows wire to engine/claim/
  • Future world apps (Purupuru Year 2, Honey Port) — install + wire up the engine
  • Server-rendered surfaces that want quest data without a roundtrip

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 8

Native requirements
6 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
@0xhoneyjar/quests-protocol
Environment
{
  "local_name": "@0xhoneyjar/quests-protocol",
  "alias": false,
  "peer_metadata": null
}
^0.1.2runtime
pg
Environment
{
  "local_name": "pg",
  "alias": false,
  "peer_metadata": null
}
^8.11.0development
effect
Environment
{
  "local_name": "effect",
  "alias": false,
  "peer_metadata": null
}
^3.10.0development
vitest
Environment
{
  "local_name": "vitest",
  "alias": false,
  "peer_metadata": null
}
^2.1.0development
@types/pg
Environment
{
  "local_name": "@types/pg",
  "alias": false,
  "peer_metadata": null
}
^8.11.0development
typescript
Environment
{
  "local_name": "typescript",
  "alias": false,
  "peer_metadata": null
}
^5.7.0development
pg
Environment
{
  "local_name": "pg",
  "alias": false,
  "peer_metadata": {
    "optional": true
  }
}
^8.11.0peer
effect
Environment
{
  "local_name": "effect",
  "alias": false,
  "peer_metadata": null
}
^3.10.0peer

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "3f04d32bb6f6c804bbaea6301aedbfff87442435",
  "tarball": "https://registry.npmjs.org/@0xhoneyjar/quests-engine/-/quests-engine-0.1.2.tgz",
  "fileCount": 107,
  "integrity": "sha512-zwyNmuX3uSLEJBtVe320Nn8YuopqZfa69Jwuyzen4M2kWYjecn5egCPfCiNrc3ck0JLhVINd94sGstRWAYwAog==",
  "signatures": [
    {
      "sig": "MEUCIQD4ZJIALPduCPR71tGXDcBTa5eWpKOQpvq+3Ex7lkpSsAIgSyqHz42lbtzbY0O9somxWfEzqPB+EAJe3U9dFwpEwWk=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 481844
}

Repository

PENDING
0xhoneyjar/freeside-quests

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 21 Oct, 08:56 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:7195e2de3f670a7ce048c94c860876644e04d397e30a2ce5ee5bfeb3b665dd36

Other collected versions

0.1.14 May0.1.04 MayView all collected versions →