@atproto/dev-env 0.0.0-spaces-alpha-20260818163953

package/LICENSE.txt

@@ -0,0 +1,7 @@
+Dual MIT/Apache-2.0 License
+
+Copyright (c) 2022-2026 Bluesky Social PBC, and Contributors
+
+Except as otherwise noted in individual files, this software is licensed under the MIT license (<http://opensource.org/licenses/MIT>), or the Apache License, Version 2.0 (<http://www.apache.org/licenses/LICENSE-2.0>).
+
+Downstream projects and end users may chose either license individually, or both together, at their discretion. The motivation for this dual-licensing is the additional software patent assurance provided by Apache 2.0.

package/README.md

@@ -0,0 +1,39 @@
+# @atproto/dev-env: Local Developer Environment
+
+A command-line application for developers to construct and manage development environments.
+
+[![NPM](https://img.shields.io/npm/v/@atproto/dev-env)](https://www.npmjs.com/package/@atproto/dev-env)
+[![Github CI Status](https://github.com/bluesky-social/atproto/actions/workflows/repo.yaml/badge.svg)](https://github.com/bluesky-social/atproto/actions/workflows/repo.yaml)
+
+## REPL API
+
+The following methods are available in the REPL.
+
+### `status()`
+
+List the currently active servers.
+
+### `startPds(port?: number)`
+
+Create a new PDS instance. Data is stored in memory.
+
+### `stop(port: number)`
+
+Stop the server at the given port.
+
+### `mkuser(handle: string, pdsPort?: number)`
+
+Create a new user.
+
+### `user(handle: string): ServiceClient`
+
+Get the `ServiceClient` for the given user.
+
+## License
+
+This project is dual-licensed under MIT and Apache 2.0 terms:
+
+- MIT license ([LICENSE-MIT.txt](https://github.com/bluesky-social/atproto/blob/main/LICENSE-MIT.txt) or http://opensource.org/licenses/MIT)
+- Apache License, Version 2.0, ([LICENSE-APACHE.txt](https://github.com/bluesky-social/atproto/blob/main/LICENSE-APACHE.txt) or http://www.apache.org/licenses/LICENSE-2.0)
+
+Downstream projects and end users may chose either license individually, or both together, at their discretion. The motivation for this dual-licensing is the additional software patent assurance provided by Apache 2.0.

package/bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// @NOTE This file exists so that pnpm can properly link the "bin" scripts when
+// the monorepo is being setup (during initial "pnpm install"), but was never
+// built.
+
+import './dist/bin.js'

package/dist/bin-multi-pds.d.ts

@@ -0,0 +1,2 @@
+import './env.js';
+//# sourceMappingURL=bin-multi-pds.d.ts.map

package/dist/bin-multi-pds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-multi-pds.d.ts","sourceRoot":"","sources":["../src/bin-multi-pds.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,CAAA"}

package/dist/bin-multi-pds.js

@@ -0,0 +1,130 @@
+import './env.js';
+import getPort from 'get-port';
+import { IntrospectServer } from './introspect.js';
+import { TestPds } from './pds.js';
+import { TestPlc } from './plc.js';
+import { LexiconAuthorityProfile } from './service-profile-lexicon.js';
+import { mockMailer, mockNetworkUtilities } from './util.js';
+const INTROSPECT_PORT = 2581;
+const PRIMARY_PDS_PORT = 2583;
+const PLC_PORT = 2582;
+// The lex-authority account hosts permission-set / space lexicon docs that
+// dev-env PDSes resolve via `lexiconDidAuthority`. Demo apps can log into this
+// account to publish new lexicons (e.g. `space`-typed documents) at runtime.
+const LEX_AUTHORITY_USER = {
+    email: 'lex-authority@test.com',
+    handle: 'lex-authority.test',
+    password: 'hunter2',
+};
+const parsePdsCount = () => {
+    const arg = process.argv[2];
+    if (arg === undefined)
+        return 3;
+    const n = Number.parseInt(arg, 10);
+    if (!Number.isFinite(n) || n < 1) {
+        throw new Error(`Invalid PDS count "${arg}": must be an integer >= 1`);
+    }
+    return n;
+};
+const run = async () => {
+    const totalPdsCount = parsePdsCount();
+    const extraPdsCount = totalPdsCount - 1;
+    console.log(`
+██████╗
+██╔═══██╗
+██║██╗██║
+██║██║██║
+╚█║████╔╝
+ ╚╝╚═══╝  protocol
+
+[ created by Bluesky ]`);
+    const plc = await TestPlc.create({ port: PLC_PORT });
+    // Step 1 — scratch PDS. We need an existing PDS to host the lex-authority
+    // account creation, but we don't want the scratch to live past startup. The
+    // account migrates to the primary PDS once we know its DID.
+    const scratchPds = await TestPds.create({
+        didPlcUrl: plc.url,
+        inviteRequired: false,
+        port: await getPort(),
+    });
+    // Step 2 — create the lex-authority account on the scratch PDS so we can
+    // capture its DID before any "real" PDS spins up with `lexiconDidAuthority`
+    // pointing at it.
+    const lexAuthority = await LexiconAuthorityProfile.create(scratchPds, LEX_AUTHORITY_USER);
+    const lexAuthorityDid = lexAuthority.did;
+    // Step 3 — primary PDS, configured to resolve lexicons from the authority.
+    const primary = await TestPds.create({
+        port: PRIMARY_PDS_PORT,
+        hostname: 'localhost',
+        enableDidDocWithSession: true,
+        didPlcUrl: plc.url,
+        lexiconDidAuthority: lexAuthorityDid,
+    });
+    // Step 4 — migrate the authority account to the primary PDS, then publish
+    // the seed lexicon docs (permission sets, etc.) at the new home.
+    await lexAuthority.migrateTo(primary);
+    await lexAuthority.createRecords();
+    // Step 5 — extra PDSes, each pointing at the same lex authority.
+    const extraPdses = [];
+    for (let i = 0; i < extraPdsCount; i++) {
+        const domain = `.test${i + 2}`;
+        const extra = await TestPds.create({
+            didPlcUrl: plc.url,
+            port: await getPort(),
+            serviceHandleDomains: [domain],
+            lexiconDidAuthority: lexAuthorityDid,
+        });
+        extraPdses.push(extra);
+    }
+    // Step 6 — close the scratch PDS now that the authority lives on primary.
+    await scratchPds.close();
+    // Mock network utilities (handle/DID resolution) across the surviving PDSes.
+    const allPdsesArray = [primary, ...extraPdses];
+    mockNetworkUtilities(allPdsesArray);
+    for (const pds of allPdsesArray) {
+        mockMailer(pds);
+    }
+    const introspect = await IntrospectServer.start(INTROSPECT_PORT, plc, allPdsesArray, undefined, undefined, undefined, {
+        did: lexAuthorityDid,
+        handle: LEX_AUTHORITY_USER.handle,
+        password: LEX_AUTHORITY_USER.password,
+        pds: primary.url,
+    });
+    console.log(`🔍 Introspection server http://localhost:${introspect.port}`);
+    console.log(`👤 DID Placeholder server ${plc.url}`);
+    const allPdses = [
+        { label: 'pds1 (primary)', pds: primary, domain: 'test' },
+        ...extraPdses.map((pds, i) => ({
+            label: `pds${i + 2}`,
+            pds,
+            domain: `test${i + 2}`,
+        })),
+    ];
+    for (const { label, pds } of allPdses) {
+        console.log(`🌞 ${label} http://localhost:${pds.port}`);
+    }
+    console.log(`\n📚 Lex authority ${LEX_AUTHORITY_USER.handle} (${lexAuthorityDid})`);
+    console.log(`   hosted on pds1 — log in with password "${LEX_AUTHORITY_USER.password}"`);
+    // Seed alice/bob/carol on each PDS so each has data that's reachable cross-PDS.
+    const seedNames = ['alice', 'bob', 'carol'];
+    const seeded = [];
+    for (const { label, pds, domain } of allPdses) {
+        const agent = pds.getAgent();
+        for (const name of seedNames) {
+            const handle = `${name}.${domain}`;
+            const res = await agent.com.atproto.server.createAccount({
+                handle,
+                email: `${name}-${domain}@test.com`,
+                password: `${name}-pass`,
+            });
+            seeded.push({ handle, did: res.data.did, pds: label });
+        }
+    }
+    console.log('\n👥 Seeded accounts:');
+    for (const acct of seeded) {
+        console.log(`  ${acct.pds.padEnd(16)} handle=${acct.handle.padEnd(20)} did=${acct.did}`);
+    }
+    console.log('  (passwords: alice-pass / bob-pass / carol-pass)');
+};
+run();
+//# sourceMappingURL=bin-multi-pds.js.map

package/dist/bin-multi-pds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-multi-pds.js","sourceRoot":"","sources":["../src/bin-multi-pds.ts"],"names":[],"mappings":"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","sourcesContent":["import './env.js'\nimport getPort from 'get-port'\nimport { IntrospectServer } from './introspect.js'\nimport { TestPds } from './pds.js'\nimport { TestPlc } from './plc.js'\nimport { LexiconAuthorityProfile } from './service-profile-lexicon.js'\nimport { mockMailer, mockNetworkUtilities } from './util.js'\n\nconst INTROSPECT_PORT = 2581\nconst PRIMARY_PDS_PORT = 2583\nconst PLC_PORT = 2582\n\n// The lex-authority account hosts permission-set / space lexicon docs that\n// dev-env PDSes resolve via `lexiconDidAuthority`. Demo apps can log into this\n// account to publish new lexicons (e.g. `space`-typed documents) at runtime.\nconst LEX_AUTHORITY_USER = {\n  email: 'lex-authority@test.com',\n  handle: 'lex-authority.test',\n  password: 'hunter2',\n}\n\nconst parsePdsCount = (): number => {\n  const arg = process.argv[2]\n  if (arg === undefined) return 3\n  const n = Number.parseInt(arg, 10)\n  if (!Number.isFinite(n) || n < 1) {\n    throw new Error(`Invalid PDS count \"${arg}\": must be an integer >= 1`)\n  }\n  return n\n}\n\nconst run = async () => {\n  const totalPdsCount = parsePdsCount()\n  const extraPdsCount = totalPdsCount - 1\n\n  console.log(`\n██████╗\n██╔═══██╗\n██║██╗██║\n██║██║██║\n╚█║████╔╝\n ╚╝╚═══╝  protocol\n\n[ created by Bluesky ]`)\n\n  const plc = await TestPlc.create({ port: PLC_PORT })\n\n  // Step 1 — scratch PDS. We need an existing PDS to host the lex-authority\n  // account creation, but we don't want the scratch to live past startup. The\n  // account migrates to the primary PDS once we know its DID.\n  const scratchPds = await TestPds.create({\n    didPlcUrl: plc.url,\n    inviteRequired: false,\n    port: await getPort(),\n  })\n\n  // Step 2 — create the lex-authority account on the scratch PDS so we can\n  // capture its DID before any \"real\" PDS spins up with `lexiconDidAuthority`\n  // pointing at it.\n  const lexAuthority = await LexiconAuthorityProfile.create(\n    scratchPds,\n    LEX_AUTHORITY_USER,\n  )\n  const lexAuthorityDid = lexAuthority.did\n\n  // Step 3 — primary PDS, configured to resolve lexicons from the authority.\n  const primary = await TestPds.create({\n    port: PRIMARY_PDS_PORT,\n    hostname: 'localhost',\n    enableDidDocWithSession: true,\n    didPlcUrl: plc.url,\n    lexiconDidAuthority: lexAuthorityDid,\n  })\n\n  // Step 4 — migrate the authority account to the primary PDS, then publish\n  // the seed lexicon docs (permission sets, etc.) at the new home.\n  await lexAuthority.migrateTo(primary)\n  await lexAuthority.createRecords()\n\n  // Step 5 — extra PDSes, each pointing at the same lex authority.\n  const extraPdses: TestPds[] = []\n  for (let i = 0; i < extraPdsCount; i++) {\n    const domain = `.test${i + 2}`\n    const extra = await TestPds.create({\n      didPlcUrl: plc.url,\n      port: await getPort(),\n      serviceHandleDomains: [domain],\n      lexiconDidAuthority: lexAuthorityDid,\n    })\n    extraPdses.push(extra)\n  }\n\n  // Step 6 — close the scratch PDS now that the authority lives on primary.\n  await scratchPds.close()\n\n  // Mock network utilities (handle/DID resolution) across the surviving PDSes.\n  const allPdsesArray = [primary, ...extraPdses]\n  mockNetworkUtilities(allPdsesArray)\n  for (const pds of allPdsesArray) {\n    mockMailer(pds)\n  }\n\n  const introspect = await IntrospectServer.start(\n    INTROSPECT_PORT,\n    plc,\n    allPdsesArray,\n    undefined,\n    undefined,\n    undefined,\n    {\n      did: lexAuthorityDid,\n      handle: LEX_AUTHORITY_USER.handle,\n      password: LEX_AUTHORITY_USER.password,\n      pds: primary.url,\n    },\n  )\n\n  console.log(`🔍 Introspection server http://localhost:${introspect.port}`)\n  console.log(`👤 DID Placeholder server ${plc.url}`)\n\n  const allPdses: { label: string; pds: TestPds; domain: string }[] = [\n    { label: 'pds1 (primary)', pds: primary, domain: 'test' },\n    ...extraPdses.map((pds, i) => ({\n      label: `pds${i + 2}`,\n      pds,\n      domain: `test${i + 2}`,\n    })),\n  ]\n\n  for (const { label, pds } of allPdses) {\n    console.log(`🌞 ${label} http://localhost:${pds.port}`)\n  }\n\n  console.log(\n    `\\n📚 Lex authority ${LEX_AUTHORITY_USER.handle} (${lexAuthorityDid})`,\n  )\n  console.log(\n    `   hosted on pds1 — log in with password \"${LEX_AUTHORITY_USER.password}\"`,\n  )\n\n  // Seed alice/bob/carol on each PDS so each has data that's reachable cross-PDS.\n  const seedNames = ['alice', 'bob', 'carol']\n  const seeded: { handle: string; did: string; pds: string }[] = []\n  for (const { label, pds, domain } of allPdses) {\n    const agent = pds.getAgent()\n    for (const name of seedNames) {\n      const handle = `${name}.${domain}`\n      const res = await agent.com.atproto.server.createAccount({\n        handle,\n        email: `${name}-${domain}@test.com`,\n        password: `${name}-pass`,\n      })\n      seeded.push({ handle, did: res.data.did, pds: label })\n    }\n  }\n\n  console.log('\\n👥 Seeded accounts:')\n  for (const acct of seeded) {\n    console.log(\n      `  ${acct.pds.padEnd(16)} handle=${acct.handle.padEnd(20)} did=${acct.did}`,\n    )\n  }\n  console.log('  (passwords: alice-pass / bob-pass / carol-pass)')\n}\n\nrun()\n"]}

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+import './env.js';
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,CAAA"}

package/dist/bin.js

@@ -0,0 +1,56 @@
+import './env.js';
+import { generateMockSetup } from './mock/index.js';
+import { TestNetwork } from './network.js';
+import { mockMailer } from './util.js';
+const run = async () => {
+    console.log(`
+██████╗
+██╔═══██╗
+██║██╗██║
+██║██║██║
+╚█║████╔╝
+ ╚╝╚═══╝  protocol
+
+[ created by Bluesky ]`);
+    const network = await TestNetwork.create({
+        pds: {
+            port: 2583,
+            hostname: 'localhost',
+            enableDidDocWithSession: true,
+        },
+        bsky: {
+            dbPostgresSchema: 'bsky',
+            port: 2584,
+            publicUrl: 'http://localhost:2584',
+        },
+        plc: { port: 2582 },
+        ozone: {
+            port: 2587,
+            chatUrl: 'http://localhost:2590', // must run separate chat service
+            chatDid: 'did:example:chat',
+            dbMaterializedViewRefreshIntervalMs: 30_000,
+        },
+        introspect: { port: 2581 },
+    });
+    mockMailer(network.pds);
+    if (network.introspect) {
+        console.log(`🔍 Dev-env introspection server http://localhost:${network.introspect.port}`);
+    }
+    console.log(`👤 DID Placeholder server http://localhost:${network.plc.port}`);
+    console.log(`🌞 Main PDS http://localhost:${network.pds.port}`);
+    console.log(`🌞 Main PDS account DB`, network.pds.ctx.cfg.db.accountDbLoc);
+    console.log(`🔨 Lexicon authority DID ${network.pds.ctx.cfg.lexicon.didAuthority}`);
+    console.log(`🗼 Ozone server http://localhost:${network.ozone.port}`);
+    console.log(`🗼 Ozone service DID ${network.ozone.ctx.cfg.service.did}`);
+    console.log(`🔄 Bsync server http://localhost:${network.bsync.port}`);
+    console.log(`🌅 Bsky Appview http://localhost:${network.bsky.port}`);
+    console.log(`🌅 Bsky Appview DID ${network.bsky.serverDid}`);
+    for (const fg of network.feedGens) {
+        console.log(`🤖 Feed Generator (${fg.did}) http://localhost:${fg.port}`);
+    }
+    console.time('✅ Dev environment is ready');
+    await generateMockSetup(network);
+    console.timeEnd('✅ Dev environment is ready');
+};
+run();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,CAAA;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;IACrB,OAAO,CAAC,GAAG,CAAC;;;;;;;;uBAQS,CAAC,CAAA;IAEtB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC;QACvC,GAAG,EAAE;YACH,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,WAAW;YACrB,uBAAuB,EAAE,IAAI;SAC9B;QACD,IAAI,EAAE;YACJ,gBAAgB,EAAE,MAAM;YACxB,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,uBAAuB;SACnC;QACD,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;QACnB,KAAK,EAAE;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,uBAAuB,EAAE,iCAAiC;YACnE,OAAO,EAAE,kBAAkB;YAC3B,mCAAmC,EAAE,MAAM;SAC5C;QACD,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;KAC3B,CAAC,CAAA;IACF,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAEvB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CACT,oDAAoD,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,8CAA8C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7E,OAAO,CAAC,GAAG,CAAC,gCAAgC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC/D,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,CAAA;IAC1E,OAAO,CAAC,GAAG,CACT,4BAA4B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CACvE,CAAA;IACD,OAAO,CAAC,GAAG,CAAC,oCAAoC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACrE,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACxE,OAAO,CAAC,GAAG,CAAC,oCAAoC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACrE,OAAO,CAAC,GAAG,CAAC,oCAAoC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACpE,OAAO,CAAC,GAAG,CAAC,uBAAuB,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IAC5D,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,GAAG,sBAAsB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;IAC1C,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAChC,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAA;AAC/C,CAAC,CAAA;AAED,GAAG,EAAE,CAAA","sourcesContent":["import './env.js'\nimport { generateMockSetup } from './mock/index.js'\nimport { TestNetwork } from './network.js'\nimport { mockMailer } from './util.js'\n\nconst run = async () => {\n  console.log(`\n██████╗\n██╔═══██╗\n██║██╗██║\n██║██║██║\n╚█║████╔╝\n ╚╝╚═══╝  protocol\n\n[ created by Bluesky ]`)\n\n  const network = await TestNetwork.create({\n    pds: {\n      port: 2583,\n      hostname: 'localhost',\n      enableDidDocWithSession: true,\n    },\n    bsky: {\n      dbPostgresSchema: 'bsky',\n      port: 2584,\n      publicUrl: 'http://localhost:2584',\n    },\n    plc: { port: 2582 },\n    ozone: {\n      port: 2587,\n      chatUrl: 'http://localhost:2590', // must run separate chat service\n      chatDid: 'did:example:chat',\n      dbMaterializedViewRefreshIntervalMs: 30_000,\n    },\n    introspect: { port: 2581 },\n  })\n  mockMailer(network.pds)\n\n  if (network.introspect) {\n    console.log(\n      `🔍 Dev-env introspection server http://localhost:${network.introspect.port}`,\n    )\n  }\n  console.log(`👤 DID Placeholder server http://localhost:${network.plc.port}`)\n  console.log(`🌞 Main PDS http://localhost:${network.pds.port}`)\n  console.log(`🌞 Main PDS account DB`, network.pds.ctx.cfg.db.accountDbLoc)\n  console.log(\n    `🔨 Lexicon authority DID ${network.pds.ctx.cfg.lexicon.didAuthority}`,\n  )\n  console.log(`🗼 Ozone server http://localhost:${network.ozone.port}`)\n  console.log(`🗼 Ozone service DID ${network.ozone.ctx.cfg.service.did}`)\n  console.log(`🔄 Bsync server http://localhost:${network.bsync.port}`)\n  console.log(`🌅 Bsky Appview http://localhost:${network.bsky.port}`)\n  console.log(`🌅 Bsky Appview DID ${network.bsky.serverDid}`)\n  for (const fg of network.feedGens) {\n    console.log(`🤖 Feed Generator (${fg.did}) http://localhost:${fg.port}`)\n  }\n\n  console.time('✅ Dev environment is ready')\n  await generateMockSetup(network)\n  console.timeEnd('✅ Dev environment is ready')\n}\n\nrun()\n"]}

package/dist/bsky.d.ts

@@ -0,0 +1,27 @@
+import { AtpAgent } from '@atproto/api';
+import * as bsky from '@atproto/bsky';
+import { Client } from '@atproto/lex';
+import type { BskyConfig } from './types.js';
+export * from '@atproto/bsky';
+export declare class TestBsky {
+    url: string;
+    port: number;
+    db: bsky.Database;
+    server: bsky.BskyAppView;
+    dataplane: bsky.DataPlaneServer;
+    bsyncSub: bsky.BsyncSubscription;
+    sub: bsky.RepoSubscription;
+    serverDid: string;
+    constructor(url: string, port: number, db: bsky.Database, server: bsky.BskyAppView, dataplane: bsky.DataPlaneServer, bsyncSub: bsky.BsyncSubscription, sub: bsky.RepoSubscription, serverDid: string);
+    static create(cfg: BskyConfig): Promise<TestBsky>;
+    get ctx(): bsky.AppContext;
+    getAgent(): AtpAgent;
+    getClient(): Client;
+    adminAuth(): string;
+    adminAuthHeaders(): {
+        authorization: string;
+    };
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=bsky.d.ts.map

package/dist/bsky.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky.d.ts","sourceRoot":"","sources":["../src/bsky.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,eAAe,CAAA;AAErC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5C,cAAc,eAAe,CAAA;AAE7B,qBAAa,QAAQ;IAEV,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,IAAI,CAAC,QAAQ;IACjB,MAAM,EAAE,IAAI,CAAC,WAAW;IACxB,SAAS,EAAE,IAAI,CAAC,eAAe;IAC/B,QAAQ,EAAE,IAAI,CAAC,iBAAiB;IAChC,GAAG,EAAE,IAAI,CAAC,gBAAgB;IAC1B,SAAS,EAAE,MAAM;IAR1B,YACS,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,IAAI,CAAC,QAAQ,EACjB,MAAM,EAAE,IAAI,CAAC,WAAW,EACxB,SAAS,EAAE,IAAI,CAAC,eAAe,EAC/B,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAChC,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACtB;IAEJ,OAAa,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqHtD;IAED,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAEzB;IAED,QAAQ,IAAI,QAAQ,CAInB;IAED,SAAS,IAAI,MAAM,CAIlB;IAED,SAAS,IAAI,MAAM,CAMlB;IAED,gBAAgB;QAEZ,aAAa;MAEhB;IAEK,KAAK,kBAmBV;IAEK,CAAC,MAAM,CAAC,YAAY,CAAC,kBAE1B;CACF"}

package/dist/bsky.js

@@ -0,0 +1,165 @@
+import { Client as PlcClient } from '@did-plc/lib';
+import getPort from 'get-port';
+import * as ui8 from 'uint8arrays';
+import { AtpAgent } from '@atproto/api';
+import * as bsky from '@atproto/bsky';
+import { Secp256k1Keypair } from '@atproto/crypto';
+import { Client } from '@atproto/lex';
+import { ADMIN_PASSWORD, EXAMPLE_LABELER } from './const.js';
+export * from '@atproto/bsky';
+export class TestBsky {
+    constructor(url, port, db, server, dataplane, bsyncSub, sub, serverDid) {
+        this.url = url;
+        this.port = port;
+        this.db = db;
+        this.server = server;
+        this.dataplane = dataplane;
+        this.bsyncSub = bsyncSub;
+        this.sub = sub;
+        this.serverDid = serverDid;
+    }
+    static async create(cfg) {
+        const serviceKeypair = cfg.privateKey
+            ? await Secp256k1Keypair.import(cfg.privateKey)
+            : await Secp256k1Keypair.create();
+        const plcClient = new PlcClient(cfg.plcUrl);
+        const port = cfg.port || (await getPort());
+        const url = `http://localhost:${port}`;
+        const serverDid = (await plcClient.createDid({
+            signingKey: serviceKeypair.did(),
+            rotationKeys: [serviceKeypair.did()],
+            handle: 'bsky.test',
+            pds: `http://localhost:${port}`,
+            signer: serviceKeypair,
+        }));
+        const endpoint = `http://localhost:${port}`;
+        await plcClient.updateData(serverDid, serviceKeypair, (x) => {
+            x.services['bsky_notif'] = {
+                type: 'BskyNotificationService',
+                endpoint,
+            };
+            x.services['bsky_appview'] = {
+                type: 'BskyAppView',
+                endpoint,
+            };
+            return x;
+        });
+        // shared across server, ingester, and indexer in order to share pool, avoid too many pg connections.
+        const db = new bsky.Database({
+            url: cfg.dbPostgresUrl,
+            schema: cfg.dbPostgresSchema,
+            poolSize: 10,
+        });
+        const dataplanePort = await getPort();
+        const dataplane = await bsky.DataPlaneServer.create(db, dataplanePort, cfg.plcUrl);
+        const config = new bsky.ServerConfig({
+            version: 'unknown',
+            port,
+            didPlcUrl: cfg.plcUrl,
+            publicUrl: 'https://bsky.public.url',
+            serverDid,
+            alternateAudienceDids: [],
+            dataplaneUrls: [`http://localhost:${dataplanePort}`],
+            dataplaneHttpVersion: '1.1',
+            bsyncHttpVersion: '1.1',
+            bsyncApiKey: 'bsync-api-key',
+            modServiceDid: cfg.modServiceDid ?? 'did:example:invalidMod',
+            labelsFromIssuerDids: [EXAMPLE_LABELER],
+            bigThreadUris: new Set(),
+            maxThreadParents: cfg.maxThreadParents ?? 50,
+            disableSsrfProtection: true,
+            searchTagsHide: new Set(),
+            searchTagsHideAll: new Set(),
+            threadTagsBumpDown: new Set(),
+            threadTagsHide: new Set(),
+            visibilityTagHide: '',
+            visibilityTagRankPrefix: '',
+            debugFieldAllowedDids: new Set(),
+            draftsLimit: 500,
+            ...cfg,
+            adminPasswords: [ADMIN_PASSWORD],
+            etcdHosts: [],
+        });
+        // Separate migration db in case migration changes some connection state that we need in the tests, e.g. "alter database ... set ..."
+        const migrationDb = new bsky.Database({
+            url: cfg.dbPostgresUrl,
+            schema: cfg.dbPostgresSchema,
+        });
+        if (cfg.migration) {
+            await migrationDb.migrateToOrThrow(cfg.migration);
+        }
+        else {
+            await migrationDb.migrateToLatestOrThrow();
+        }
+        await migrationDb.close();
+        // api server
+        const server = bsky.BskyAppView.create({
+            config,
+            signingKey: serviceKeypair,
+        });
+        const bsyncSub = new bsky.BsyncSubscription({
+            config,
+            db,
+        });
+        const sub = new bsky.RepoSubscription({
+            service: cfg.repoProvider,
+            db,
+            idResolver: dataplane.idResolver,
+        });
+        await server.start();
+        bsyncSub.start();
+        void sub.start();
+        return new TestBsky(url, port, db, server, dataplane, bsyncSub, sub, serverDid);
+    }
+    get ctx() {
+        return this.server.ctx;
+    }
+    getAgent() {
+        const agent = new AtpAgent({ service: this.url });
+        agent.configureLabelers([EXAMPLE_LABELER]);
+        return agent;
+    }
+    getClient() {
+        const client = new Client({ service: this.url });
+        client.setLabelers([EXAMPLE_LABELER]);
+        return client;
+    }
+    adminAuth() {
+        const [password] = this.ctx.cfg.adminPasswords;
+        return ('Basic ' +
+            ui8.toString(ui8.fromString(`admin:${password}`, 'utf8'), 'base64pad'));
+    }
+    adminAuthHeaders() {
+        return {
+            authorization: this.adminAuth(),
+        };
+    }
+    async close() {
+        // @TODO Use disposable stack when it becomes available (Node24+)
+        try {
+            await this.server.destroy();
+        }
+        finally {
+            try {
+                await this.bsyncSub.destroy();
+            }
+            finally {
+                try {
+                    await this.dataplane.destroy();
+                }
+                finally {
+                    try {
+                        await this.sub.destroy();
+                    }
+                    finally {
+                        await this.db.close();
+                    }
+                }
+            }
+        }
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+}
+//# sourceMappingURL=bsky.js.map

package/dist/bsky.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky.js","sourceRoot":"","sources":["../src/bsky.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client as PlcClient } from '@did-plc/lib'\nimport getPort from 'get-port'\nimport * as ui8 from 'uint8arrays'\nimport { AtpAgent } from '@atproto/api'\nimport * as bsky from '@atproto/bsky'\nimport { Secp256k1Keypair } from '@atproto/crypto'\nimport { Client } from '@atproto/lex'\nimport type { DidString } from '@atproto/syntax'\nimport { ADMIN_PASSWORD, EXAMPLE_LABELER } from './const.js'\nimport type { BskyConfig } from './types.js'\nexport * from '@atproto/bsky'\n\nexport class TestBsky {\n  constructor(\n    public url: string,\n    public port: number,\n    public db: bsky.Database,\n    public server: bsky.BskyAppView,\n    public dataplane: bsky.DataPlaneServer,\n    public bsyncSub: bsky.BsyncSubscription,\n    public sub: bsky.RepoSubscription,\n    public serverDid: string,\n  ) {}\n\n  static async create(cfg: BskyConfig): Promise<TestBsky> {\n    const serviceKeypair = cfg.privateKey\n      ? await Secp256k1Keypair.import(cfg.privateKey)\n      : await Secp256k1Keypair.create()\n    const plcClient = new PlcClient(cfg.plcUrl)\n\n    const port = cfg.port || (await getPort())\n    const url = `http://localhost:${port}`\n    const serverDid = (await plcClient.createDid({\n      signingKey: serviceKeypair.did(),\n      rotationKeys: [serviceKeypair.did()],\n      handle: 'bsky.test',\n      pds: `http://localhost:${port}`,\n      signer: serviceKeypair,\n    })) as DidString\n\n    const endpoint = `http://localhost:${port}`\n\n    await plcClient.updateData(serverDid, serviceKeypair, (x) => {\n      x.services['bsky_notif'] = {\n        type: 'BskyNotificationService',\n        endpoint,\n      }\n      x.services['bsky_appview'] = {\n        type: 'BskyAppView',\n        endpoint,\n      }\n      return x\n    })\n\n    // shared across server, ingester, and indexer in order to share pool, avoid too many pg connections.\n    const db = new bsky.Database({\n      url: cfg.dbPostgresUrl,\n      schema: cfg.dbPostgresSchema,\n      poolSize: 10,\n    })\n\n    const dataplanePort = await getPort()\n    const dataplane = await bsky.DataPlaneServer.create(\n      db,\n      dataplanePort,\n      cfg.plcUrl,\n    )\n\n    const config = new bsky.ServerConfig({\n      version: 'unknown',\n      port,\n      didPlcUrl: cfg.plcUrl,\n      publicUrl: 'https://bsky.public.url',\n      serverDid,\n      alternateAudienceDids: [],\n      dataplaneUrls: [`http://localhost:${dataplanePort}`],\n      dataplaneHttpVersion: '1.1',\n      bsyncHttpVersion: '1.1',\n      bsyncApiKey: 'bsync-api-key',\n      modServiceDid: cfg.modServiceDid ?? 'did:example:invalidMod',\n      labelsFromIssuerDids: [EXAMPLE_LABELER],\n      bigThreadUris: new Set(),\n      maxThreadParents: cfg.maxThreadParents ?? 50,\n      disableSsrfProtection: true,\n      searchTagsHide: new Set(),\n      searchTagsHideAll: new Set(),\n      threadTagsBumpDown: new Set(),\n      threadTagsHide: new Set(),\n      visibilityTagHide: '',\n      visibilityTagRankPrefix: '',\n      debugFieldAllowedDids: new Set(),\n      draftsLimit: 500,\n      ...cfg,\n      adminPasswords: [ADMIN_PASSWORD],\n      etcdHosts: [],\n    })\n\n    // Separate migration db in case migration changes some connection state that we need in the tests, e.g. \"alter database ... set ...\"\n    const migrationDb = new bsky.Database({\n      url: cfg.dbPostgresUrl,\n      schema: cfg.dbPostgresSchema,\n    })\n    if (cfg.migration) {\n      await migrationDb.migrateToOrThrow(cfg.migration)\n    } else {\n      await migrationDb.migrateToLatestOrThrow()\n    }\n    await migrationDb.close()\n\n    // api server\n    const server = bsky.BskyAppView.create({\n      config,\n      signingKey: serviceKeypair,\n    })\n\n    const bsyncSub = new bsky.BsyncSubscription({\n      config,\n      db,\n    })\n\n    const sub = new bsky.RepoSubscription({\n      service: cfg.repoProvider,\n      db,\n      idResolver: dataplane.idResolver,\n    })\n\n    await server.start()\n\n    bsyncSub.start()\n    void sub.start()\n\n    return new TestBsky(\n      url,\n      port,\n      db,\n      server,\n      dataplane,\n      bsyncSub,\n      sub,\n      serverDid,\n    )\n  }\n\n  get ctx(): bsky.AppContext {\n    return this.server.ctx\n  }\n\n  getAgent(): AtpAgent {\n    const agent = new AtpAgent({ service: this.url })\n    agent.configureLabelers([EXAMPLE_LABELER])\n    return agent\n  }\n\n  getClient(): Client {\n    const client = new Client({ service: this.url })\n    client.setLabelers([EXAMPLE_LABELER])\n    return client\n  }\n\n  adminAuth(): string {\n    const [password] = this.ctx.cfg.adminPasswords\n    return (\n      'Basic ' +\n      ui8.toString(ui8.fromString(`admin:${password}`, 'utf8'), 'base64pad')\n    )\n  }\n\n  adminAuthHeaders() {\n    return {\n      authorization: this.adminAuth(),\n    }\n  }\n\n  async close() {\n    // @TODO Use disposable stack when it becomes available (Node24+)\n    try {\n      await this.server.destroy()\n    } finally {\n      try {\n        await this.bsyncSub.destroy()\n      } finally {\n        try {\n          await this.dataplane.destroy()\n        } finally {\n          try {\n            await this.sub.destroy()\n          } finally {\n            await this.db.close()\n          }\n        }\n      }\n    }\n  }\n\n  async [Symbol.asyncDispose]() {\n    await this.close()\n  }\n}\n"]}

package/dist/bsync.d.ts

@@ -0,0 +1,22 @@
+import * as bsync from '@atproto/bsync';
+import type { BsyncConfig } from './types.js';
+export declare class TestBsync {
+    url: string;
+    port: number;
+    service: bsync.BsyncService;
+    constructor(url: string, port: number, service: bsync.BsyncService);
+    static create(cfg: BsyncConfig): Promise<TestBsync>;
+    get ctx(): bsync.AppContext;
+    /**
+     * Current head (max id) of each operation stream. Used to wait for the bsky
+     * bsync subscription to catch up in tests, without waiting for the long-poll
+     * timeout.
+     */
+    getStreamHeads(): Promise<{
+        op?: string;
+        mute?: string;
+        notif?: string;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=bsync.d.ts.map

package/dist/bsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsync.d.ts","sourceRoot":"","sources":["../src/bsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,qBAAa,SAAS;IAEX,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,KAAK,CAAC,YAAY;IAHpC,YACS,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,KAAK,CAAC,YAAY,EAChC;IAEJ,OAAa,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAmBxD;IAED,IAAI,GAAG,IAAI,KAAK,CAAC,UAAU,CAE1B;IAED;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAeD;IAEK,KAAK,kBAEV;CACF"}

package/dist/bsync.js

@@ -0,0 +1,54 @@
+import getPort from 'get-port';
+import * as bsync from '@atproto/bsync';
+export class TestBsync {
+    constructor(url, port, service) {
+        this.url = url;
+        this.port = port;
+        this.service = service;
+    }
+    static async create(cfg) {
+        const port = cfg.port || (await getPort());
+        const url = `http://localhost:${port}`;
+        const config = bsync.envToCfg({
+            port,
+            apiKeys: cfg.apiKeys ?? ['api-key'],
+            dbSchema: 'bsync',
+            // Keep the pool small: a bsync runs alongside every test network, so a
+            // default-sized pool per network quickly exhausts postgres connections.
+            dbPoolSize: cfg.dbPoolSize ?? 5,
+            ...cfg,
+        });
+        const service = await bsync.BsyncService.create(config);
+        await service.ctx.db.migrateToLatestOrThrow();
+        await service.start();
+        return new TestBsync(url, port, service);
+    }
+    get ctx() {
+        return this.service.ctx;
+    }
+    /**
+     * Current head (max id) of each operation stream. Used to wait for the bsky
+     * bsync subscription to catch up in tests, without waiting for the long-poll
+     * timeout.
+     */
+    async getStreamHeads() {
+        const db = this.ctx.db.db;
+        const max = async (table) => {
+            const row = await db
+                .selectFrom(table)
+                .select((eb) => eb.fn.max('id').as('id'))
+                .executeTakeFirst();
+            return row?.id != null ? String(row.id) : undefined;
+        };
+        const [op, mute, notif] = await Promise.all([
+            max('operation'),
+            max('mute_op'),
+            max('notif_op'),
+        ]);
+        return { op, mute, notif };
+    }
+    async close() {
+        await this.service.destroy();
+    }
+}
+//# sourceMappingURL=bsync.js.map

package/dist/bsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsync.js","sourceRoot":"","sources":["../src/bsync.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAA;AAC9B,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAGvC,MAAM,OAAO,SAAS;IACpB,YACS,GAAW,EACX,IAAY,EACZ,OAA2B;mBAF3B,GAAG;oBACH,IAAI;uBACJ,OAAO;IACb,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAgB;QAClC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;QAC1C,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAA;QAEtC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC5B,IAAI;YACJ,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC;YACnC,QAAQ,EAAE,OAAO;YACjB,uEAAuE;YACvE,wEAAwE;YACxE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC;YAC/B,GAAG,GAAG;SACP,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACvD,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAA;QAC7C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QAErB,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAA;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc;QAKlB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAA;QACzB,MAAM,GAAG,GAAG,KAAK,EAAE,KAA2C,EAAE,EAAE;YAChE,MAAM,GAAG,GAAG,MAAM,EAAE;iBACjB,UAAU,CAAC,KAAK,CAAC;iBACjB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;iBACxC,gBAAgB,EAAE,CAAA;YACrB,OAAO,GAAG,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACrD,CAAC,CAAA;QACD,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1C,GAAG,CAAC,WAAW,CAAC;YAChB,GAAG,CAAC,SAAS,CAAC;YACd,GAAG,CAAC,UAAU,CAAC;SAChB,CAAC,CAAA;QACF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IAC9B,CAAC;CACF","sourcesContent":["import getPort from 'get-port'\nimport * as bsync from '@atproto/bsync'\nimport type { BsyncConfig } from './types.js'\n\nexport class TestBsync {\n  constructor(\n    public url: string,\n    public port: number,\n    public service: bsync.BsyncService,\n  ) {}\n\n  static async create(cfg: BsyncConfig): Promise<TestBsync> {\n    const port = cfg.port || (await getPort())\n    const url = `http://localhost:${port}`\n\n    const config = bsync.envToCfg({\n      port,\n      apiKeys: cfg.apiKeys ?? ['api-key'],\n      dbSchema: 'bsync',\n      // Keep the pool small: a bsync runs alongside every test network, so a\n      // default-sized pool per network quickly exhausts postgres connections.\n      dbPoolSize: cfg.dbPoolSize ?? 5,\n      ...cfg,\n    })\n\n    const service = await bsync.BsyncService.create(config)\n    await service.ctx.db.migrateToLatestOrThrow()\n    await service.start()\n\n    return new TestBsync(url, port, service)\n  }\n\n  get ctx(): bsync.AppContext {\n    return this.service.ctx\n  }\n\n  /**\n   * Current head (max id) of each operation stream. Used to wait for the bsky\n   * bsync subscription to catch up in tests, without waiting for the long-poll\n   * timeout.\n   */\n  async getStreamHeads(): Promise<{\n    op?: string\n    mute?: string\n    notif?: string\n  }> {\n    const db = this.ctx.db.db\n    const max = async (table: 'operation' | 'mute_op' | 'notif_op') => {\n      const row = await db\n        .selectFrom(table)\n        .select((eb) => eb.fn.max('id').as('id'))\n        .executeTakeFirst()\n      return row?.id != null ? String(row.id) : undefined\n    }\n    const [op, mute, notif] = await Promise.all([\n      max('operation'),\n      max('mute_op'),\n      max('notif_op'),\n    ])\n    return { op, mute, notif }\n  }\n\n  async close() {\n    await this.service.destroy()\n  }\n}\n"]}

package/dist/const.d.ts

@@ -0,0 +1,4 @@
+export declare const ADMIN_PASSWORD = "admin-pass";
+export declare const JWT_SECRET = "jwt-secret";
+export declare const EXAMPLE_LABELER = "did:example:labeler";
+//# sourceMappingURL=const.d.ts.map

package/dist/const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,eAAe,CAAA;AAC1C,eAAO,MAAM,UAAU,eAAe,CAAA;AACtC,eAAO,MAAM,eAAe,wBAAwB,CAAA"}

package/dist/const.js

@@ -0,0 +1,4 @@
+export const ADMIN_PASSWORD = 'admin-pass';
+export const JWT_SECRET = 'jwt-secret';
+export const EXAMPLE_LABELER = 'did:example:labeler';
+//# sourceMappingURL=const.js.map

package/dist/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAA;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAA","sourcesContent":["export const ADMIN_PASSWORD = 'admin-pass'\nexport const JWT_SECRET = 'jwt-secret'\nexport const EXAMPLE_LABELER = 'did:example:labeler'\n"]}

package/dist/env.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":""}

package/dist/env.js

@@ -0,0 +1,10 @@
+// NOTE: this file should be imported first, particularly before `@atproto/common` (for logging), to ensure that environment variables are respected in library code
+import { config } from 'dotenv';
+const env = process.env.ENV;
+if (env) {
+    config({ path: `./.${env}.env` });
+}
+else {
+    config();
+}
+//# sourceMappingURL=env.js.map