Shade/packages/shade-files/src/index.ts

// Schemas — Zod runtime + compile-time types
export * from './schemas/index.js';

// Protocol primitives — kinds, correlation, canonical bytes, envelope codec
export {
  SHADE_FILES_VERSION,
  KIND_PREFIX,
  SUPPORTED_KINDS,
  isSupportedKind,
} from './protocol/version.js';
export type { SupportedKind } from './protocol/version.js';
export {
  KIND_LIST_V1,
  KIND_STAT_V1,
  KIND_MKDIR_V1,
  KIND_DELETE_V1,
  KIND_MOVE_V1,
  KIND_READ_V1,
  KIND_WRITE_V1,
  KIND_GET_THUMBNAIL_V1,
  KIND_CUSTOM_V1,
  KIND_ERROR_V1,
  KIND_CANCEL_V1,
  responseKindOf,
  opOfKind,
  MUTATION_OPS,
} from './protocol/kinds.js';
export type { StandardOp } from './protocol/kinds.js';
export {
  generateRequestId,
  generateIdempotencyKey,
  base64UrlEncode,
  base64UrlDecode,
} from './protocol/correlate.js';
export {
  canonicalRpcBytes,
  canonicalJsonStringify,
  hashArgs,
  bytesToHex,
  bytesToBase64,
  base64ToBytes,
} from './protocol/canonical.js';
export {
  encodeEnvelope,
  looksLikeFileEnvelope,
  tryParseEnvelope,
  classify,
} from './protocol/envelope-codec.js';
export type { ClassifiedEnvelope } from './protocol/envelope-codec.js';

// RPC channel — wires Shade.send/onMessage to the file-RPC routing layer
export { ShadeFileRpcChannel } from './rpc/channel.js';
export type { RpcChannelHooks } from './rpc/channel.js';
export { PendingRpcRegistry } from './rpc/pending.js';
export type { RegisterOptions } from './rpc/pending.js';

// Server side
export { createFileHandler, INTERNAL_SYMBOL } from './server/handler.js';
export type {
  FileHandler,
  FileHandlerConfig,
  FileHandlerOps,
} from './server/handler.js';
export type { OpContext, OpKind } from './server/handler-context.js';
export { validatePath } from './server/path-policy.js';
export type { PathPolicy, PathValidationResult } from './server/path-policy.js';
export { IdempotencyCache } from './server/idempotency-cache.js';
export type { IdempotencyCacheOptions } from './server/idempotency-cache.js';
export { RateLimiter } from './server/rate-limiter.js';
export type { RateLimitConfig } from './server/rate-limiter.js';
export { createCursorBuilder } from './server/cursor.js';
export type { CursorBuilder } from './server/cursor.js';
export {
  createServerStreamsBridge,
  META_KEY_READ_STREAM_ID,
  META_KEY_WRITE_ID,
} from './server/streams-bridge.js';
export type {
  ServerStreamsBridge,
  StreamsBridgeShade,
  CreateServerStreamsBridgeOptions,
  ParkedWrite,
  AwaitWriteOptions,
} from './server/streams-bridge.js';
export type {
  UserReadResult,
  UserReadResultInline,
  UserReadResultStreams,
  UserWriteArgs,
  UserWriteContent,
  UserWriteContentInline,
  UserWriteContentStreams,
  UserThumbnailResult,
} from './server/io-types.js';
export {
  assertThumbnailFormat,
  isThumbnailFormat,
} from './server/thumbnail.js';
export type { ThumbnailFormat } from './server/thumbnail.js';

// Client side
export { createFileClient } from './client/client.js';
export type {
  FileClient,
  BaseOpts,
  CreateFileClientOptions,
  ReadOpts,
  WriteOpts,
  ReadOutput,
  ReadInlineOutput,
  ReadStreamsOutput,
  ThumbnailResult,
} from './client/client.js';
export {
  createClientStreamsBridge,
} from './client/streams-bridge.js';
export type {
  ClientStreamsBridge,
  CreateClientStreamsBridgeOptions,
  AwaitReadOptions,
  ParkedRead,
} from './client/streams-bridge.js';
export {
  decideInline,
  INLINE_THRESHOLD,
} from './client/inline-threshold.js';
export type {
  InlineDecision,
  WriteSource,
} from './client/inline-threshold.js';

// Directory ops — walk + bulk transfers
export { walk } from './client/walk.js';
export type { WalkOpts, WalkItem } from './client/walk.js';
export { uploadDirectory } from './client/upload-directory.js';
export type { UploadDirectoryOptions } from './client/upload-directory.js';
export { downloadDirectory } from './client/download-directory.js';
export type { DownloadDirectoryOptions } from './client/download-directory.js';
export { runWithConcurrency } from './client/concurrency.js';
export type { ConcurrentMapOptions } from './client/concurrency.js';
export {
  DEFAULT_BULK_CONCURRENCY,
  MAX_BULK_CONCURRENCY,
} from './client/directory-types.js';
export type {
  BulkOpts,
  BulkTransferEvent,
  BulkTransferHandle,
  BulkTransferResult,
  DirectoryHandleLike,
  FileHandleLike,
  FileLike,
  WritableStreamLike,
} from './client/directory-types.js';
export { createMemoryDirectory } from './client/memory-directory.js';

// Custom-op registry typing (declaration-merged by consumers)
export type {
  CustomOpDef,
  CustomOpsMap,
  CustomOpRegistration,
  CustomOpRegistrations,
} from './server/custom-ops.js';

// Production hooks: metrics
export {
  METRIC_BYTES_IN,
  METRIC_BYTES_OUT,
  METRIC_FINGERPRINT_REJECT_TOTAL,
  METRIC_IDEMPOTENCY_CONFLICT_TOTAL,
  METRIC_IDEMPOTENCY_HIT_TOTAL,
  METRIC_OP_DURATION_MS,
  METRIC_OP_TOTAL,
  METRIC_RATE_LIMIT_REJECT_TOTAL,
  METRIC_SIGNATURE_REJECT_TOTAL,
  NOOP_METRIC_SINK,
} from './server/metrics.js';
export type { MetricSink, MetricTags } from './server/metrics.js';

export { MAX_SIGNATURE_AGE_MS } from './server/handler.js';

// High-level SDK integration entrypoint
export { createFilesNamespace } from './integration/files-namespace.js';
export type { FilesNamespace } from './integration/files-namespace.js';

// Integration helpers — wire handler + pending registry onto a channel
export { attachFileHandler } from './integration/wire-server.js';
export { attachClientRouting } from './integration/wire-client.js';

// Path utilities
export {
  posixNormalize,
  posixJoin,
  posixDirname,
  posixBasename,
  decodePercentEscapes,
  isPathInside,
} from './utils/path.js';