Skip to content

Final naming pass (part 2): full 1.0 consistency sweep#90

Merged
AndroidPoet merged 1 commit into
mainfrom
audit/final-naming
Jun 26, 2026
Merged

Final naming pass (part 2): full 1.0 consistency sweep#90
AndroidPoet merged 1 commit into
mainfrom
audit/final-naming

Conversation

@AndroidPoet

Copy link
Copy Markdown
Owner

The first naming pass landed the safe, high-confidence renames. This second pass finishes the job — resolving the items that were previously deferred — so the public 1.0 surface is uniformly conventional before the freeze. The repo is still at 0.10.0 on Maven, so these renames break no published consumers.

Renames

Enums → UPPER_SNAKE (wire values are derived or constructor-held, so the identifiers are free)

  • SupabaseErrorCategory: CONFLICT, NOT_FOUND, UNAUTHORIZED, RATE_LIMITED, VALIDATION, INTERNAL, NETWORK, UNKNOWN
  • TextSearchType: RAW, PLAIN, PHRASE, WEB_SEARCH

Realtime

  • RealtimeSubscription.channelchannelName
  • The channel-name parameter on subscribe, subscribeToPostgresChanges (all 3 overloads), subscribeToBroadcast, subscribeToPresence, and broadcastchannelName
  • The channel(name) builder factory is intentionally unchanged

Sync

  • RecordSyncRecord, CursorSyncCursor

Storage

  • ObjectListV2ResultObjectListV2Response

Auth admin

  • AuditLogEntryAuditLogEvent
  • userinfoUrluserInfoUrl

Client

  • SupabaseConfig.logLevelhttpLogLevel (the setting only scopes HTTP logging; RealtimeConfig.logLevel is a separate concern, left as-is)

Deliberately kept

  • PostgREST range-operator family rangeGt/rangeGte/rangeLt/rangeLte — mirrors the operator names; renaming would obscure the mapping.

Verification

  • apiCheck detekt spotlessCheck jvmTest — green; API dumps regenerated
  • Docs site builds (39/39 pages); reference docs, CHANGELOG and API_DESIGN updated

Make the public API uniformly conventional ahead of the 1.0 freeze:

- SupabaseErrorCategory entries to UPPER_SNAKE (CONFLICT, NOT_FOUND,
  UNAUTHORIZED, RATE_LIMITED, VALIDATION, INTERNAL, NETWORK, UNKNOWN);
  TextSearchType entries to UPPER_SNAKE (RAW, PLAIN, PHRASE, WEB_SEARCH).
  Wire values are derived/constructor-held, so identifiers are free to rename.
- Realtime: RealtimeSubscription.channel -> channelName, and the matching
  channel-name parameter on subscribe/subscribeToPostgresChanges/
  subscribeToBroadcast/subscribeToPresence/broadcast -> channelName
  (the channel(name) builder factory is unchanged).
- Sync: Record -> SyncRecord, Cursor -> SyncCursor (avoid colliding with
  kotlin.collections naming and read clearly at call sites).
- Storage: ObjectListV2Result -> ObjectListV2Response.
- Auth admin: AuditLogEntry -> AuditLogEvent, userinfoUrl -> userInfoUrl.
- Client: SupabaseConfig.logLevel -> httpLogLevel (scope is HTTP logging).

Regenerated API dumps, updated the reference docs, CHANGELOG and API_DESIGN.
@AndroidPoet AndroidPoet merged commit 1cd9ce1 into main Jun 26, 2026
9 checks passed
@AndroidPoet AndroidPoet deleted the audit/final-naming branch June 26, 2026 21:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant