release(v4.0.1): strict-TS publishability fixes
4.0.0 shipped TypeScript source as published main/types, but several
files only compiled inside the monorepo. Consumer projects (Dispatch,
etc.) running their own strict tsc against our published source hit:
- @shade/key-transparency: 4 noUnusedLocals violations
(IndexAbsenceProof, IndexInclusionProof, IndexProofWire, nodeHash)
- @shade/sdk: KT verifier callbacks returned Promise<unknown> instead
of Promise<STHWire> / Promise<{ proof: string[] }>
- @shade/sdk: thumbnail.ts globalThis cast collided with consumer's
lib.dom-supplied createImageBitmap signature
- @shade/files: cycle with @shade/sdk produced "this is not assignable
to type 'Shade'" because hoisted node_modules layouts duplicated the
Shade class. Broken by replacing `import type { Shade }` with a
local structural ShadeBridge interface.
- @shade/storage-encrypted: KeyUsage (lib.dom) used under
lib: ["ES2022"]
- @shade/transport-bridge: ReadableStreamDefaultReader<any> ↔
<Uint8Array> mismatch
- @shade/keychain / @shade/dashboard / @shade/storage-encrypted
tsconfig rootDir / include hygiene
Tooling: scripts/typecheck-all.ts runs `bunx tsc --noEmit` against
every workspace package's tsconfig and fails on any error. Wired into
publish:dry / publish:all and publish-shade.sh as a hard gate so this
class of bug cannot recur.
All 24 packages bumped to 4.0.1 in lockstep.
Migration: <ShadeFilesProvider> now requires an explicit `files` prop
(pass `shade.files`). Wire format unchanged.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
67
packages/shade-files/src/integration/shade-bridge.ts
Normal file
67
packages/shade-files/src/integration/shade-bridge.ts
Normal file
@@ -0,0 +1,67 @@
|
||||
/**
|
||||
* Structural surface @shade/files needs from a Shade instance.
|
||||
*
|
||||
* Defining this locally — instead of `import type { Shade } from '@shade/sdk'`
|
||||
* — breaks the @shade/sdk ↔ @shade/files dependency cycle. Without this
|
||||
* break, a consumer that installs @shade/sdk from a registry ends up with
|
||||
* two distinct `Shade` classes in `node_modules` (one from
|
||||
* `@shade/sdk/node_modules/@shade/files/.../Shade`, one from
|
||||
* `@shade/sdk/Shade`). TypeScript treats them as nominally different types,
|
||||
* raising `this is not assignable to Shade` from inside SDK methods that
|
||||
* pass `this` into `createFilesNamespace`.
|
||||
*
|
||||
* The Shade class structurally implements every member listed below, so
|
||||
* `createFilesNamespace(this)` from the SDK side compiles regardless of
|
||||
* how many copies of @shade/sdk a consumer's package manager installs.
|
||||
*
|
||||
* Member signatures match Shade's exactly so this is a structural
|
||||
* subtype, not a parallel API.
|
||||
*/
|
||||
import type { ShadeEnvelope } from '@shade/core';
|
||||
import type {
|
||||
IncomingTransfer,
|
||||
TransferHandle,
|
||||
TransferOptions,
|
||||
} from '@shade/transfer';
|
||||
import type { ObservabilityHook } from '@shade/observability';
|
||||
|
||||
export interface ShadeBridge {
|
||||
/** Address that names this Shade instance to peers. */
|
||||
readonly myAddress: string;
|
||||
|
||||
/** Encrypt + send `plaintext` to `peer`; returns the wire envelope. */
|
||||
send(peer: string, plaintext: string): Promise<ShadeEnvelope>;
|
||||
|
||||
/**
|
||||
* Subscribe to incoming ratchet plaintext. Returns an unsubscribe.
|
||||
* Handlers may be sync or async; async handlers are awaited in
|
||||
* registration order.
|
||||
*/
|
||||
onMessage(
|
||||
handler: (from: string, plaintext: string) => void | Promise<void>,
|
||||
): () => void;
|
||||
|
||||
/**
|
||||
* Upload bytes via the SDK's transfer engine. Required when the bridge
|
||||
* is used with `streams` content I/O (read/write > 256 KiB).
|
||||
*/
|
||||
upload(opts: TransferOptions): Promise<TransferHandle>;
|
||||
|
||||
/** Subscribe to incoming transfers initiated by a peer. */
|
||||
onIncomingTransfer(
|
||||
handler: (incoming: IncomingTransfer) => void | Promise<void>,
|
||||
): Promise<() => void>;
|
||||
|
||||
/** Fingerprint accessor for the trust-gate hooks. */
|
||||
getFingerprintFor(peer: string): Promise<string>;
|
||||
|
||||
/**
|
||||
* Optional inheritable observability bus. Files inherits the bus when
|
||||
* the SDK passes one in via the namespace; otherwise files runs without
|
||||
* observability hooks.
|
||||
*/
|
||||
getObservability?(): ObservabilityHook | undefined;
|
||||
|
||||
/** Optional control-envelope passthrough used by the WebRTC bridge. */
|
||||
deliverControlEnvelope?(peer: string, envelope: ShadeEnvelope): Promise<void>;
|
||||
}
|
||||
Reference in New Issue
Block a user