@ascorbic/pds 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,332 @@
+import { DurableObject } from "cloudflare:workers";
+import { BlockMap, CommitData, ReadableBlockstore, Repo, RepoStorage } from "@atproto/repo";
+import { Secp256k1Keypair } from "@atproto/crypto";
+import { CID } from "@atproto/lex-data";
+import { Hono } from "hono";
+import * as hono_types0 from "hono/types";
+
+//#region src/storage.d.ts
+
+/**
+ * SQLite-backed repository storage for Cloudflare Durable Objects.
+ *
+ * Implements the RepoStorage interface from @atproto/repo, storing blocks
+ * in a SQLite database within a Durable Object.
+ */
+declare class SqliteRepoStorage extends ReadableBlockstore implements RepoStorage {
+  private sql;
+  constructor(sql: SqlStorage);
+  /**
+   * Initialize the database schema. Should be called once on DO startup.
+   */
+  initSchema(): void;
+  /**
+   * Get the current root CID of the repository.
+   */
+  getRoot(): Promise<CID | null>;
+  /**
+   * Get the current revision string.
+   */
+  getRev(): Promise<string | null>;
+  /**
+   * Get the current sequence number for firehose events.
+   */
+  getSeq(): Promise<number>;
+  /**
+   * Increment and return the next sequence number.
+   */
+  nextSeq(): Promise<number>;
+  /**
+   * Get the raw bytes for a block by CID.
+   */
+  getBytes(cid: CID): Promise<Uint8Array | null>;
+  /**
+   * Check if a block exists.
+   */
+  has(cid: CID): Promise<boolean>;
+  /**
+   * Get multiple blocks at once.
+   */
+  getBlocks(cids: CID[]): Promise<{
+    blocks: BlockMap;
+    missing: CID[];
+  }>;
+  /**
+   * Store a single block.
+   */
+  putBlock(cid: CID, block: Uint8Array, rev: string): Promise<void>;
+  /**
+   * Store multiple blocks at once.
+   */
+  putMany(blocks: BlockMap, rev: string): Promise<void>;
+  /**
+   * Update the repository root.
+   */
+  updateRoot(cid: CID, rev: string): Promise<void>;
+  /**
+   * Apply a commit atomically: add new blocks, remove old blocks, update root.
+   */
+  applyCommit(commit: CommitData): Promise<void>;
+  /**
+   * Get total storage size in bytes.
+   */
+  sizeInBytes(): Promise<number>;
+  /**
+   * Clear all data (for testing).
+   */
+  destroy(): Promise<void>;
+  /**
+   * Count the number of blocks stored.
+   */
+  countBlocks(): Promise<number>;
+}
+//#endregion
+//#region src/blobs.d.ts
+interface BlobRef {
+  $type: "blob";
+  ref: {
+    $link: string;
+  };
+  mimeType: string;
+  size: number;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * Environment bindings required by the PDS worker.
+ * Consumers must provide these bindings in their wrangler config.
+ */
+interface PDSEnv {
+  /** The account's DID (e.g., did:web:example.com) */
+  DID: string;
+  /** The account's handle (e.g., alice.example.com) */
+  HANDLE: string;
+  /** Public hostname of the PDS */
+  PDS_HOSTNAME: string;
+  /** Bearer token for write operations */
+  AUTH_TOKEN: string;
+  /** Private signing key (hex-encoded) */
+  SIGNING_KEY: string;
+  /** Public signing key (multibase-encoded) */
+  SIGNING_KEY_PUBLIC: string;
+  /** Secret for signing session JWTs */
+  JWT_SECRET: string;
+  /** Bcrypt hash of account password */
+  PASSWORD_HASH: string;
+  /** Durable Object namespace for account storage */
+  ACCOUNT: DurableObjectNamespace<AccountDurableObject>;
+  /** R2 bucket for blob storage (optional) */
+  BLOBS?: R2Bucket;
+}
+//#endregion
+//#region src/account-do.d.ts
+/**
+ * Account Durable Object - manages a single user's AT Protocol repository.
+ *
+ * This DO provides:
+ * - SQLite-backed block storage for the repository
+ * - AT Protocol Repo instance for repository operations
+ * - Firehose WebSocket connections
+ * - Sequence number management
+ */
+declare class AccountDurableObject extends DurableObject<PDSEnv> {
+  private storage;
+  private repo;
+  private keypair;
+  private sequencer;
+  private blobStore;
+  private storageInitialized;
+  private repoInitialized;
+  constructor(ctx: DurableObjectState, env: PDSEnv);
+  /**
+   * Initialize the storage adapter. Called lazily on first storage access.
+   */
+  private ensureStorageInitialized;
+  /**
+   * Initialize the Repo instance. Called lazily on first repo access.
+   */
+  private ensureRepoInitialized;
+  /**
+   * Get the storage adapter for direct access (used by tests and internal operations).
+   */
+  getStorage(): Promise<SqliteRepoStorage>;
+  /**
+   * Get the Repo instance for repository operations.
+   */
+  getRepo(): Promise<Repo>;
+  /**
+   * Get the signing keypair for repository operations.
+   */
+  getKeypair(): Promise<Secp256k1Keypair>;
+  /**
+   * Update the Repo instance after mutations.
+   */
+  setRepo(repo: Repo): Promise<void>;
+  /**
+   * RPC method: Get repo metadata for describeRepo
+   */
+  rpcDescribeRepo(): Promise<{
+    did: string;
+    collections: string[];
+    cid: string;
+  }>;
+  /**
+   * RPC method: Get a single record
+   */
+  rpcGetRecord(collection: string, rkey: string): Promise<{
+    cid: string;
+    record: Rpc.Serializable<any>;
+  } | null>;
+  /**
+   * RPC method: List records in a collection
+   */
+  rpcListRecords(collection: string, opts: {
+    limit: number;
+    cursor?: string;
+    reverse?: boolean;
+  }): Promise<{
+    records: Array<{
+      uri: string;
+      cid: string;
+      value: unknown;
+    }>;
+    cursor?: string;
+  }>;
+  /**
+   * RPC method: Create a record
+   */
+  rpcCreateRecord(collection: string, rkey: string | undefined, record: unknown): Promise<{
+    uri: string;
+    cid: string;
+    commit: {
+      cid: string;
+      rev: string;
+    };
+  }>;
+  /**
+   * RPC method: Delete a record
+   */
+  rpcDeleteRecord(collection: string, rkey: string): Promise<{
+    commit: {
+      cid: string;
+      rev: string;
+    };
+  } | null>;
+  /**
+   * RPC method: Put a record (create or update)
+   */
+  rpcPutRecord(collection: string, rkey: string, record: unknown): Promise<{
+    uri: string;
+    cid: string;
+    commit: {
+      cid: string;
+      rev: string;
+    };
+    validationStatus: string;
+  }>;
+  /**
+   * RPC method: Apply multiple writes (batch create/update/delete)
+   */
+  rpcApplyWrites(writes: Array<{
+    $type: string;
+    collection: string;
+    rkey?: string;
+    value?: unknown;
+  }>): Promise<{
+    commit: {
+      cid: string;
+      rev: string;
+    };
+    results: Array<{
+      $type: string;
+      uri?: string;
+      cid?: string;
+      validationStatus?: string;
+    }>;
+  }>;
+  /**
+   * RPC method: Get repo status
+   */
+  rpcGetRepoStatus(): Promise<{
+    did: string;
+    head: string;
+    rev: string;
+  }>;
+  /**
+   * RPC method: Export repo as CAR
+   */
+  rpcGetRepoCar(): Promise<Uint8Array>;
+  /**
+   * RPC method: Import repo from CAR file
+   * This is used for account migration - importing an existing repository
+   * from another PDS.
+   */
+  rpcImportRepo(carBytes: Uint8Array): Promise<{
+    did: string;
+    rev: string;
+    cid: string;
+  }>;
+  /**
+   * RPC method: Upload a blob to R2
+   */
+  rpcUploadBlob(bytes: Uint8Array, mimeType: string): Promise<BlobRef>;
+  /**
+   * RPC method: Get a blob from R2
+   */
+  rpcGetBlob(cidStr: string): Promise<R2ObjectBody | null>;
+  /**
+   * Encode a firehose frame (header + body CBOR).
+   */
+  private encodeFrame;
+  /**
+   * Encode a commit event frame.
+   */
+  private encodeCommitFrame;
+  /**
+   * Encode an error frame.
+   */
+  private encodeErrorFrame;
+  /**
+   * Backfill firehose events from a cursor.
+   */
+  private backfillFirehose;
+  /**
+   * Broadcast a commit event to all connected firehose clients.
+   */
+  private broadcastCommit;
+  /**
+   * Handle WebSocket upgrade for firehose (subscribeRepos).
+   */
+  handleFirehoseUpgrade(request: Request): Promise<Response>;
+  /**
+   * WebSocket message handler (hibernation API).
+   */
+  webSocketMessage(_ws: WebSocket, _message: string | ArrayBuffer): void;
+  /**
+   * WebSocket close handler (hibernation API).
+   */
+  webSocketClose(_ws: WebSocket, _code: number, _reason: string, _wasClean: boolean): void;
+  /**
+   * WebSocket error handler (hibernation API).
+   */
+  webSocketError(_ws: WebSocket, error: Error): void;
+  /**
+   * Emit an identity event to notify downstream services to refresh identity cache.
+   */
+  rpcEmitIdentityEvent(handle: string): Promise<{
+    seq: number;
+  }>;
+  /**
+   * HTTP fetch handler for WebSocket upgrades.
+   * This is used instead of RPC to avoid WebSocket serialization errors.
+   */
+  fetch(request: Request): Promise<Response>;
+}
+//#endregion
+//#region src/index.d.ts
+declare const app: Hono<{
+  Bindings: PDSEnv;
+}, hono_types0.BlankSchema, "/">;
+//#endregion
+export { AccountDurableObject, type PDSEnv, app as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/storage.ts","../src/blobs.ts","../src/types.ts","../src/account-do.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}