flowstate-url-builder

Use this skill when working on packages/flowstate-url-builder.

Package identity:

• Package: @epicdm/flowstate-url-builder
• Version authority: package.json
• Public source: src/index.ts
• Tests: tests/ServiceUrlBuilder.test.ts

Public API:

• ServiceUrlConfig stores optional kongGatewayUrl and kongGatewayHttpsUrl.
• ServiceUrlBuilder builds FlowState Kong Gateway service URLs.
• createServiceUrlBuilder(config?) returns a ServiceUrlBuilder.

Route behavior:

• Preserved path: getAuthUrl(), getRxdbRestUrl(), getRxdbReplicationUrl(), getOAuthDiscoveryUrl().
• Stripped path: getMcpUrl(), getObsUrl(), getAmsUrl().

Verification:

• yarn workspace @epicdm/flowstate-url-builder typecheck
• yarn workspace @epicdm/flowstate-url-builder test
• yarn workspace @epicdm/flowstate-url-builder build

Pitfalls:

• getRxdbReplicationUrl() exists and is tested, but source marks it deprecated after the D1 migration.
• Do not document getAuthHttpsUrl() or getRxdbRestBaseUrl() as current APIs unless source adds them.
• Do not publish Dojo artifacts unless the task explicitly includes publish approval.

Use this Dojo skill with package human docs under .flowstate/docs, package skill content under .flowstate/skills/flowstate-url-builder/SKILL.md, and feature evidence under .flowstate/feature-matrix/package-features.json. Keep this manifest version aligned with package.json.