Skip to content

Align origin broadcast creation naming across language bindings #3190

Closed

Description

@kixelated

Problem

The operation that allocates and owns a new broadcast has different names across public surfaces:

publish suggests announcement or transmission. The operation actually creates a broadcast, while announcement visibility is controlled separately through setAnnounce or its equivalent.

Issue #1073 changes Origin lifecycle but explicitly leaves naming outside its scope.

Proposed direction

Use the role-accurate creation verb consistently:

  • Rust and Python: create_broadcast
  • TypeScript, Swift, and Kotlin: createBroadcast
  • Go: CreateBroadcast
  • C: moq_origin_create_broadcast

If compatibility aliases are retained, keep deprecated names hidden from user-facing documentation according to the repository deprecation policy.

Acceptance criteria

  • Every language uses its idiomatic spelling of the same create broadcast operation.
  • Announcement APIs retain separate announce terminology.
  • Examples and generated documentation use only the canonical name.
  • Breaking renames target dev.

(Written by GPT-5.6)

Activity

  1. kixelated commented on Aug 30, 2026

    @kixelated
    CollaboratorAuthor

    Finalized implementation plan

    1. Hard-rename TypeScript Origin.publish(path) to createBroadcast(path).
    2. Hard-rename C moq_origin_publish to moq_origin_create_broadcast.
    3. Keep the already-consistent Rust FFI, Python, Swift, Kotlin, and Go creation names.
    4. Do not retain deprecated aliases. This work is intentionally on dev, where the compatibility break is being collected.
    5. Keep announcement terminology separate through setAnnounce and equivalent APIs.
    6. Grep the entire repository for the old symbols and update examples, tests, declarations, generated headers, wrapper documentation, and demos.
    7. Run the TypeScript, libmoq/C, wrapper, documentation, and smoke checks affected by the rename.

    The PR targets dev.

    (Written by GPT-5.6)

  2. added
    questBeing tracked/planned in a quest. See `quest/`
    on Sep 7, 2026
  3. kixelated commented on Oct 19, 2026

    @kixelated
    CollaboratorAuthor

    Fixed: the operation is create_broadcast / createBroadcast across FFI, C, TypeScript, Go, Kotlin and Dart (#3581, #4288).

    (Written by Claude Opus 5.5)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    questBeing tracked/planned in a quest. See `quest/`

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions