Skip to content

DDS Plugin SDK 0.5.0 — workspace observation

Pre-release
Pre-release

Choose a tag to compare

View all tags
@hkimw hkimw released this 03 Oct 15:33
v0.5.0
1ee8928
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

DDS Plugin SDK 0.5.0 adds bounded observation of workspace files and existing command jobs.

  • project.watchFiles() samples 1–16 explicit file paths and yields initial/created/changed/deleted revision events. It preserves edit snapshots and unsaved drafts; saving still checks the retained revision.
  • client.watchJob() follows event cursors and reports expired history; waitForJob() returns the terminal snapshot after draining event pages. Observation never submits or cancels the server command.
  • Async iterators fetch only when pulled, share eight slots per client, and support deadlines, AbortSignal, iterator return and connection-bound disposal. Explicit reconnection uses the same job ID and last handled cursor.
  • Existing workspace protocol v1 and 0.4 job methods are unchanged. New packages declare >=0.5.0 <0.6.0; exact 0.3/0.4 archives remain verifiable with their original peers and need publisher validation/repacking for installation on 0.5.

Install the attached archive with Node 22 or 24. GitHub Releases distributes this package; it has zero runtime dependencies.

npm install --ignore-scripts --save-exact https://github.com/Altifigence/dds-plugin-sdk/releases/download/v0.5.0/altifigence-dds-plugin-sdk-0.5.0.tgz
node node_modules/@altifigence/dds-plugin-sdk/examples/workspace-observation/run.mjs

Observation guide · Project sessions · Compatibility

Validation: 177 runtime tests, 14 schemas, TypeScript checks and independently installed package consumers on Windows 2025 and Ubuntu 24.04 with Node 22.23.3/24.21.0. Tests cover retained draft conflicts, cancellation of pending reads, late replies, event pages, shared limits and reconnect without command resubmission.

Developer preview: file changes are sampled and may coalesce. Job records remain in memory. The SDK adds no DDS product UI, recursive OS watcher, durable job store or new permission. Apache-2.0 LICENSE and NOTICE are included; this release does not publish to the npm registry.

한국어: 명시한 파일의 revision 변경과 기존 작업의 이벤트·완료를 관찰하는 도우미를 추가했습니다. 편집 초안을 자동으로 바꾸지 않으며 관찰을 멈춰도 서버 작업은 취소되지 않습니다. 재연결 후 같은 job ID와 처리한 커서로 명시적으로 이어받습니다. 실제 DDS 제품의 화면·설치 지원은 별도 출시 범위입니다.

Assets 4
Loading