flowstate-dojo-platform-epicdm-kv-session

Use this skill when a task touches packages/shared/kv-session, imports @epicdm/kv-session, or needs to teach humans/agents how this package works.

Package identity:

• Package: @epicdm/kv-session
• Repository: flowstate-platform
• Version authority: package.json (0.1.0)
• Dojo course: flowstate-dojo-platform-epicdm-kv-session

How to use the package:

• Purpose: Generic typed KV-backed session management for Cloudflare Workers/Pages
• Start with package-local docs when present.
• Verify details against source and tests before changing behavior.
• Use the Dojo course lessons as the teaching path: setup, mental model, core workflow, integration, feature labs, maintenance.

Public surfaces discovered:

• SessionOptions
• createSession
• getSession
• destroySession
• buildSessionCookie
• buildSessionClearCookie
• requireSession

Composable feature skilllets:

• Build Session Clear Cookie: use feature labs for workflow, source anchor, and regression risk.
• Build Session Cookie: use feature labs for workflow, source anchor, and regression risk.
• Create Session: use feature labs for workflow, source anchor, and regression risk.
• Destroy Session: use feature labs for workflow, source anchor, and regression risk.
• Get Session: use feature labs for workflow, source anchor, and regression risk.
• Require Session: use feature labs for workflow, source anchor, and regression risk.

Agent operating rules:

• Treat package.json as the Dojo version authority.
• Do not turn feature inventory into user-facing lessons without workflow context.
• Update this Dojo package when package behavior, docs, examples, or feature inventory changes.
• Verify downstream packages when package use and connection metadata shows inbound dependencies or references.
• Never mark publish status passed without successful cloud publish and catalog lookup.

Use this Dojo skill with package human docs, package-local feature inventory, agent-skillset.md, and the generated course.json in this folder. Keep this manifest version aligned with package.json.