flowstate-dojo-platform-epicdm-flowstate-api-core

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

Package identity:

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

How to use the package:

• Purpose: Shared Hono middleware, auth, schemas, and app factory for FlowState API workers
• 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:

• createMockBindings
• createMockApiKeyValidator
• createMockKV
• createApiApp
• ok
• created
• paginated
• noContent
• err
• timingSafeEqual
• resetJwksCache
• createAuthMiddleware
• errorHandler
• onErrorHandler
• CreditEventType
• CreditRate
• getCachedRates
• setCachedRates
• getCreditCost
• resetRateCache
• UsageMiddlewareConfig
• usageMiddleware
• IdParamSchema
• IdParam
• SortFilterSchema
• SortFilter
• ErrorResponseSchema
• ErrorResponse
• ValidationErrorDetailSchema
• ValidationErrorResponseSchema

Composable feature skilllets:

• Create Api App: use feature labs for workflow, source anchor, and regression risk.
• Create Auth Middleware: use feature labs for workflow, source anchor, and regression risk.
• Created: use feature labs for workflow, source anchor, and regression risk.
• DELETE /no-content: use feature labs for workflow, source anchor, and regression risk.
• Err: use feature labs for workflow, source anchor, and regression risk.
• Error Handler: use feature labs for workflow, source anchor, and regression risk.
• Error Response Schema: use feature labs for workflow, source anchor, and regression risk.
• GET /docs: use feature labs for workflow, source anchor, and regression risk.
• GET /error: use feature labs for workflow, source anchor, and regression risk.
• GET /error-details: use feature labs for workflow, source anchor, and regression risk.
• GET /explode: use feature labs for workflow, source anchor, and regression risk.
• GET /health: use feature labs for workflow, source anchor, and regression risk.
• GET /http-error: use feature labs for workflow, source anchor, and regression risk.
• GET /ok: use feature labs for workflow, source anchor, and regression risk.
• GET /openapi.json: use feature labs for workflow, source anchor, and regression risk.
• GET /paginated: use feature labs for workflow, source anchor, and regression risk.
• GET /protected: use feature labs for workflow, source anchor, and regression risk.
• GET /test: use feature labs for workflow, source anchor, and regression risk.
• GET /throw: use feature labs for workflow, source anchor, and regression risk.
• GET /zod-error: use feature labs for workflow, source anchor, and regression risk.
• Get Cached Rates: use feature labs for workflow, source anchor, and regression risk.
• Get Credit Cost: use feature labs for workflow, source anchor, and regression risk.
• Id Param Schema: use feature labs for workflow, source anchor, and regression risk.
• No Content: use feature labs for workflow, source anchor, and regression risk.
• Ok: use feature labs for workflow, source anchor, and regression risk.
• On Error Handler: use feature labs for workflow, source anchor, and regression risk.
• Paginated: use feature labs for workflow, source anchor, and regression risk.
• Paginated Response Schema: use feature labs for workflow, source anchor, and regression risk.
• Pagination Query Schema: use feature labs for workflow, source anchor, and regression risk.
• POST /created: use feature labs for workflow, source anchor, and regression risk.
• Reset Jwks Cache: use feature labs for workflow, source anchor, and regression risk.
• Reset Rate Cache: use feature labs for workflow, source anchor, and regression risk.
• Set Cached Rates: use feature labs for workflow, source anchor, and regression risk.
• Sort Filter Schema: use feature labs for workflow, source anchor, and regression risk.
• Timing Safe Equal: use feature labs for workflow, source anchor, and regression risk.
• Usage Middleware: use feature labs for workflow, source anchor, and regression risk.
• USE /*: use feature labs for workflow, source anchor, and regression risk.
• Validation Error Detail Schema: use feature labs for workflow, source anchor, and regression risk.
• Validation Error Response Schema: 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.