Define the GuildPass SDK V2 public domain types #488

Difficulty

Medium

Type

Architecture / SDK

Background

GuildPass SDK V2 should expose a stable, developer-facing representation of the platform without leaking Core implementation details or frontend-specific assumptions.

Problem

The rebuilt SDK has a clean foundation, but it still needs a canonical public type surface for Guilds, Members, Passes, access decisions, activity events, Stellar accounts, and supported networks.

Expected Outcome

The SDK exports a coherent set of public V2 types aligned with GuildPass Core while remaining suitable for external consumers.

Suggested Implementation

• Define public SDK types for Guild, Member, Pass, AccessPolicy, AccessDecision, ActivityEvent, StellarAccount, and Network.
• Align the public type shapes with the canonical Core domain contracts.
• Avoid exposing internal Core persistence or service implementation details.
• Remove EVM-oriented terminology and address assumptions.
• Use Stellar-first naming and account representations.
• Export the public types through the package entry point.

Acceptance Criteria

• Public V2 domain types are defined.
• Types are aligned with Core contracts.
• No database-specific types are exported.
• No frontend-specific types are exported.
• No EVM-specific account assumptions remain.
• Stellar network and account concepts are represented clearly.
• Public types are exported from the SDK package entry point.
• Typecheck and tests pass.

Likely Affected Files/Directories

• src/types/
• src/index.ts
• test/