RackBill Plugin SDK v0.4.0

RackBill Plugin SDK v0.4.0

Compatibility

• Plugin contract: 16
• Minimum RackBill agent: 0.2.31 (or newer)

Changes

• Fix backup quota rotation to consider additional unprotected snapshots when retention-expired snapshots cannot satisfy byte or snapshot-count limits. Protected snapshots remain excluded; existing backup plugins require no API changes.

• Add ContentProvider, ContentPack and ServeContentProvider for distributing portal translations as standalone plugins or bundle members.

• Support validated locale packs applied through the portal draft and publication workflow, preserving existing wording by default and serializing concurrent edits.

• Allow translations to be prepared for supported languages before they are offered to customers, including first-party dashboard wording and typed date and money messages.

• Add a partial German content plugin example and guidance for exporting the complete portal translation catalog.

Install with go get rackbill.com/sdk@v0.4.0.

RackBill Plugin SDK v0.3.5

RackBill Plugin SDK v0.3.5

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Replace the Python notifier sample's pinned requirements file with an unpinned install command in its README. Python setup and interoperability checks remain opt-in.

Install with go get rackbill.com/sdk@v0.3.5.

RackBill Plugin SDK v0.3.4

RackBill Plugin SDK v0.3.4

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Login providers now receive distinct callback URLs at /api/auth/oauth/{provider}/callback. Register each new URL before upgrading; the shared callback URL is no longer accepted and in-flight sign-ins must be restarted.

• Honor the exact redirect_uri supplied to BeginLogin and CompleteLogin. Provider identity keys and the login RPC contract remain unchanged.

• Admin configuration responses expose values only for currently declared public fields. Secret, Sensitive, sealed and undeclared values are reported by key name only; unavailable plugins expose no saved configuration values.

• Queued user restores are dispatched only while the submitting person and originating API key retain restore authority. Already accepted operations continue recovery.

• Service option responses add value_withheld for private or unclassifiable saved values, including manual configuration. Names and sold prices remain available; sealed continues to indicate actual encryption. New invoice option descriptions omit withheld values without changing charges.

• Product metadata updates preserve saved configuration for an unchanged unavailable provisioner, usage source or registrar when the config object is empty or omitted. Responses continue to hide saved values; selecting another provider does not inherit them.

• Add a Python implementation alongside the Go notifier example, with protobuf generation, mutual TLS, lifecycle handling, setup instructions and a Go host interoperability test. The example uses the existing plugin contract and requires Python 3.11 or later.

• Clarify that the Python notifier example and its interoperability checks are opt-in; normal SDK builds and tests do not require its Python environment or packages.

Install with go get rackbill.com/sdk@v0.3.4.

RackBill Plugin SDK v0.3.3

RackBill Plugin SDK v0.3.3

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Redact credentials supplied through the pw query or form parameter in HTTP diagnostics and RedactSecrets output.
• Usage sources may receive a final Collect call for a fixed consumption window when an activated paid service is cancelled or terminated. The Collect interface is unchanged.

Install with go get rackbill.com/sdk@v0.3.3.

RackBill Plugin SDK v0.3.2

RackBill Plugin SDK v0.3.2

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Withhold hosting-panel sign-in responses from HTTP diagnostics while preserving exchange metadata.
• Redact hosting-panel login URLs and session envelopes from secret-filtered text, including encoded URLs and truncated excerpts.
• Saved tenant configuration now replaces every declared tenant-scoped field for provisioning and bundled usage sources, including blank or omitted values that select plugin defaults. Product-carried account settings remain supported until tenant settings are first saved.
• Provisioning refuses saved-account configuration when the target plugin schema is unavailable.
• Older saved accounts whose effective destination would change require an explicit endpoint review before provisioning or bundled usage collection resumes.
• PBS backup targets require exclusive service and source ownership; existing targets require explicit ownership review before snapshot access or data operations resume.
• Proxmox backup and restore verify the configured PBS server, port, datastore, namespace and source identity before dispatch. Deploy the updated host and first-party plugins together and use matching direct HTTPS storage addresses.
• Discard node-capacity and out-of-band probe results after connection settings change. Retire cached observations for changed connections and clear cached capacity when the provider no longer supports it.
• Treat multiple upstream IPAM records for one normalized address as an ownership conflict. Reconciliation preserves local assignments and reserves unassigned addresses until duplicates are resolved; updates and releases refuse ambiguous listings.

Install with go get rackbill.com/sdk@v0.3.2.

RackBill Plugin SDK v0.3.1

RackBill Plugin SDK v0.3.1

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Preserve scheduled backup intervals across day boundaries and retain jittered calendar runs that fall after midnight.

• Require account reauthentication before linking a LoginProvider identity. Plugin interfaces and OAuth callback parameters remain unchanged.

• Redact credentials passed as key query or form parameters from HTTP diagnostics and secret-filtered text.

• Restore satellite forwarding for optional VM hostname, networking, group, backup, boot, and ISO capabilities while preserving provider refusals.

Install with go get rackbill.com/sdk@v0.3.1.

RackBill Plugin SDK v0.3.0

RackBill Plugin SDK v0.3.0

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Protect linked resources and claimed or dispatched provisioning work from destination changes in product, node and tenant configuration.

• Use ConfigField.Destination to identify protected connection fields while permitting credential rotation and declared workload edits.

• Preserve existing plugin interfaces and wire compatibility.

• Updated agents preserve issued invoice-line accounting configuration when a promotion reprices an unpaid order, including bundled services and regenerated discount lines.

• Existing accounting plugins require no interface or wire-contract changes.

• Notifier plugins can deliver escalations through any channel they declare.

• Escalation destinations can subscribe to exact platform event names or all events without changes to notifier implementations.

• Existing notifier interfaces and wire contracts remain compatible.

• Update golang.org/x/net to v0.62.0 and refresh its required dependencies.

Install with go get rackbill.com/sdk@v0.3.0.

RackBill Plugin SDK v0.2.0

RackBill Plugin SDK v0.2.0

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Publish the Go module as rackbill.com/sdk, with plugin interfaces at rackbill.com/sdk/plugin and currency helpers at rackbill.com/sdk/money.
• Update the included examples and protobuf Go bindings to use the RackBill package namespace.

Install with go get rackbill.com/sdk@v0.2.0.

RackBill Plugin SDK v0.1.0

RackBill Plugin SDK v0.1.0

Compatibility

• Plugin contract: 15
• Minimum RackBill agent: 0.2.21 (or newer)

Changes

• Publish the standalone RackBill Plugin SDK with Go interfaces, protobuf definitions, serving helpers and currency utilities.
• Show each SDK release's plugin contract and minimum compatible RackBill agent version.
• Add notifier and provisioner examples, including commented lifecycle and optional VM, backup, capacity, panel and game-server method stubs.
• Document SDK installation, version selection and plugin development using public guides.

Install with go get kubiq.io/rackbill/sdk@v0.1.0.