handoff-app 2.0.0-1 → 2.0.0-2

package/dist/registry/db/client.js

@@ -2,9 +2,9 @@
 /**
  * Bundled Drizzle client + migrator for the registry database.
  *
- * The package ships both built-in adapters (`pg` and `neon`) and the Drizzle client/migrator, so a
+ * The package ships both built-in drivers (`pg` and `neon`) and the Drizzle client/migrator, so a
  * consuming project needs no global Drizzle install or separate CLI. Driver modules are loaded
- * lazily (dynamic import) for the selected adapter only, so workspace dev/build never pulls the
+ * lazily (dynamic import) for the selected driver only, so workspace dev/build never pulls the
  * Postgres/Neon drivers into memory when the registry is not in use.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -43,13 +43,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createRegistryDbConnection = void 0;
 const schema = __importStar(require("./schema"));
 /**
- * Create a registry database connection for the resolved adapter. Both adapters target the
+ * Create a registry database connection for the resolved driver. Both drivers target the
  * Postgres dialect and share the same schema, so the returned connection is interchangeable for
  * migration and (later) the registry store.
  */
-const createRegistryDbConnection = (_a) => __awaiter(void 0, [_a], void 0, function* ({ adapter, connectionString, }) {
+const createRegistryDbConnection = (_a) => __awaiter(void 0, [_a], void 0, function* ({ driver, connectionString, }) {
     var _b;
-    if (adapter === 'neon') {
+    if (driver === 'neon') {
         const { Pool, neonConfig } = yield Promise.resolve().then(() => __importStar(require('@neondatabase/serverless')));
         // Neon's serverless driver needs a WebSocket constructor in Node; reuse the bundled `ws`.
         const ws = yield Promise.resolve().then(() => __importStar(require('ws')));
@@ -66,7 +66,7 @@ const createRegistryDbConnection = (_a) => __awaiter(void 0, [_a], void 0, funct
         }
         const db = drizzle(pool, { schema });
         return {
-            adapter,
+            driver,
             db,
             migrate: (migrationsFolder) => migrate(db, { migrationsFolder }),
             close: () => pool.end(),
@@ -85,7 +85,7 @@ const createRegistryDbConnection = (_a) => __awaiter(void 0, [_a], void 0, funct
     }
     const db = drizzle(pool, { schema });
     return {
-        adapter,
+        driver,
         db,
         migrate: (migrationsFolder) => migrate(db, { migrationsFolder }),
         close: () => pool.end(),

package/dist/registry/db/{adapter.d.ts → driver.d.ts}

@@ -1,25 +1,27 @@
 /**
- * Registry database adapter resolution.
+ * Registry database driver resolution.
  *
- * `runtime.registry.database.adapter` selects one of two built-in adapters shipped with the
- * `handoff-app` package — `pg` (default) and `neon` — both targeting the Postgres dialect.
- * `build --target registry` and `db:migrate` resolve the **same** adapter so build and migration
- * never diverge. Connection credentials are referenced by environment-variable name only and
- * resolved to a value at runtime; the value is never stored in config.
+ * PostgreSQL is the supported database. `runtime.registry.database.driver` selects one of two
+ * built-in connection drivers shipped with the `handoff-app` package — `pg` (default) and `neon` —
+ * both targeting the same Postgres dialect over one package-owned schema and migration set. The
+ * driver picks *how* to connect, not *which* database engine to use. `build --target registry` and
+ * `db:migrate` resolve the **same** driver so build and migration never diverge. Connection
+ * credentials are referenced by environment-variable name only and resolved to a value at runtime;
+ * the value is never stored in config.
  */
 import type { Config } from '../../types/config';
-/** Built-in registry database adapter. Both ship with the package and target Postgres. */
-export type RegistryDatabaseAdapter = 'pg' | 'neon';
+/** Built-in registry database connection driver. Both ship with the package and target Postgres. */
+export type RegistryDatabaseDriver = 'pg' | 'neon';
 /** Default env-var name holding the database connection string. */
 export declare const DEFAULT_DATABASE_URL_ENV = "DATABASE_URL";
 /** Default env-var name holding the registry management API bearer token. */
 export declare const DEFAULT_REGISTRY_API_TOKEN_ENV = "HANDOFF_REGISTRY_API_TOKEN";
-/** Default registry database adapter when none is configured. */
-export declare const DEFAULT_REGISTRY_ADAPTER: RegistryDatabaseAdapter;
+/** Default registry database driver when none is configured. */
+export declare const DEFAULT_REGISTRY_DRIVER: RegistryDatabaseDriver;
 /** Fully resolved registry database connection inputs. */
 export interface ResolvedRegistryDatabase {
-    /** Selected built-in adapter. */
-    adapter: RegistryDatabaseAdapter;
+    /** Selected built-in driver. */
+    driver: RegistryDatabaseDriver;
     /** Name of the env var the connection string was read from. */
     databaseUrlEnv: string;
     /** Resolved connection string (never persisted in config). */
@@ -33,8 +35,8 @@ export declare const resolveDatabaseUrlEnv: (config: Config | null | undefined)
  * value is resolved from the environment at request time and never written to config.
  */
 export declare const resolveApiTokenEnv: (config: Config | null | undefined) => string;
-/** Resolve the configured registry adapter (defaults to `pg`). */
-export declare const resolveRegistryAdapter: (config: Config | null | undefined) => RegistryDatabaseAdapter;
+/** Resolve the configured registry database driver (defaults to `pg`). */
+export declare const resolveRegistryDriver: (config: Config | null | undefined) => RegistryDatabaseDriver;
 /**
  * Resolve the registry database connection from config + environment. Throws an actionable error
  * when the configured env var is unset so the CLI can surface a clear "missing database URL"

package/dist/registry/db/{adapter.js → driver.js}

@@ -1,21 +1,23 @@
 "use strict";
 /**
- * Registry database adapter resolution.
+ * Registry database driver resolution.
  *
- * `runtime.registry.database.adapter` selects one of two built-in adapters shipped with the
- * `handoff-app` package — `pg` (default) and `neon` — both targeting the Postgres dialect.
- * `build --target registry` and `db:migrate` resolve the **same** adapter so build and migration
- * never diverge. Connection credentials are referenced by environment-variable name only and
- * resolved to a value at runtime; the value is never stored in config.
+ * PostgreSQL is the supported database. `runtime.registry.database.driver` selects one of two
+ * built-in connection drivers shipped with the `handoff-app` package — `pg` (default) and `neon` —
+ * both targeting the same Postgres dialect over one package-owned schema and migration set. The
+ * driver picks *how* to connect, not *which* database engine to use. `build --target registry` and
+ * `db:migrate` resolve the **same** driver so build and migration never diverge. Connection
+ * credentials are referenced by environment-variable name only and resolved to a value at runtime;
+ * the value is never stored in config.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveRegistryDatabase = exports.resolveRegistryAdapter = exports.resolveApiTokenEnv = exports.resolveDatabaseUrlEnv = exports.DEFAULT_REGISTRY_ADAPTER = exports.DEFAULT_REGISTRY_API_TOKEN_ENV = exports.DEFAULT_DATABASE_URL_ENV = void 0;
+exports.resolveRegistryDatabase = exports.resolveRegistryDriver = exports.resolveApiTokenEnv = exports.resolveDatabaseUrlEnv = exports.DEFAULT_REGISTRY_DRIVER = exports.DEFAULT_REGISTRY_API_TOKEN_ENV = exports.DEFAULT_DATABASE_URL_ENV = void 0;
 /** Default env-var name holding the database connection string. */
 exports.DEFAULT_DATABASE_URL_ENV = 'DATABASE_URL';
 /** Default env-var name holding the registry management API bearer token. */
 exports.DEFAULT_REGISTRY_API_TOKEN_ENV = 'HANDOFF_REGISTRY_API_TOKEN';
-/** Default registry database adapter when none is configured. */
-exports.DEFAULT_REGISTRY_ADAPTER = 'pg';
+/** Default registry database driver when none is configured. */
+exports.DEFAULT_REGISTRY_DRIVER = 'pg';
 /** Resolve the env-var name holding the database URL (defaults to `DATABASE_URL`). */
 const resolveDatabaseUrlEnv = (config) => {
     var _a, _b, _c;
@@ -34,12 +36,12 @@ const resolveApiTokenEnv = (config) => {
     return configured || exports.DEFAULT_REGISTRY_API_TOKEN_ENV;
 };
 exports.resolveApiTokenEnv = resolveApiTokenEnv;
-/** Resolve the configured registry adapter (defaults to `pg`). */
-const resolveRegistryAdapter = (config) => {
+/** Resolve the configured registry database driver (defaults to `pg`). */
+const resolveRegistryDriver = (config) => {
     var _a, _b, _c, _d;
-    return (_d = (_c = (_b = (_a = config === null || config === void 0 ? void 0 : config.runtime) === null || _a === void 0 ? void 0 : _a.registry) === null || _b === void 0 ? void 0 : _b.database) === null || _c === void 0 ? void 0 : _c.adapter) !== null && _d !== void 0 ? _d : exports.DEFAULT_REGISTRY_ADAPTER;
+    return (_d = (_c = (_b = (_a = config === null || config === void 0 ? void 0 : config.runtime) === null || _a === void 0 ? void 0 : _a.registry) === null || _b === void 0 ? void 0 : _b.database) === null || _c === void 0 ? void 0 : _c.driver) !== null && _d !== void 0 ? _d : exports.DEFAULT_REGISTRY_DRIVER;
 };
-exports.resolveRegistryAdapter = resolveRegistryAdapter;
+exports.resolveRegistryDriver = resolveRegistryDriver;
 /**
  * Resolve the registry database connection from config + environment. Throws an actionable error
  * when the configured env var is unset so the CLI can surface a clear "missing database URL"
@@ -47,13 +49,13 @@ exports.resolveRegistryAdapter = resolveRegistryAdapter;
  */
 const resolveRegistryDatabase = (config) => {
     var _a;
-    const adapter = (0, exports.resolveRegistryAdapter)(config);
+    const driver = (0, exports.resolveRegistryDriver)(config);
     const databaseUrlEnv = (0, exports.resolveDatabaseUrlEnv)(config);
     const connectionString = (_a = process.env[databaseUrlEnv]) === null || _a === void 0 ? void 0 : _a.trim();
     if (!connectionString) {
         throw new Error(`Registry database URL is not configured. Set the "${databaseUrlEnv}" environment variable to a ` +
             `PostgreSQL connection string (or change "runtime.registry.databaseUrlEnv" to point at the env var you use).`);
     }
-    return { adapter, databaseUrlEnv, connectionString };
+    return { driver, databaseUrlEnv, connectionString };
 };
 exports.resolveRegistryDatabase = resolveRegistryDatabase;

package/dist/registry/db/index.d.ts

@@ -1,5 +1,5 @@
 export { buildMetadata, componentFiles, components, docsArtifacts, patternFiles, patterns, registrySchema, type BuildMetadataEntityKind, type DocsArtifactEntityKind, type RegistryReviewMetadata, } from './schema';
 export type { ArtifactBuildStatus as RegistryBuildStatus } from '../../artifacts/types';
-export { DEFAULT_DATABASE_URL_ENV, DEFAULT_REGISTRY_ADAPTER, DEFAULT_REGISTRY_API_TOKEN_ENV, resolveApiTokenEnv, resolveDatabaseUrlEnv, resolveRegistryAdapter, resolveRegistryDatabase, type RegistryDatabaseAdapter, type ResolvedRegistryDatabase, } from './adapter';
+export { DEFAULT_DATABASE_URL_ENV, DEFAULT_REGISTRY_DRIVER, DEFAULT_REGISTRY_API_TOKEN_ENV, resolveApiTokenEnv, resolveDatabaseUrlEnv, resolveRegistryDriver, resolveRegistryDatabase, type RegistryDatabaseDriver, type ResolvedRegistryDatabase, } from './driver';
 export { createRegistryDbConnection, type CreateRegistryDbConnectionParams, type RegistryDatabase, type RegistryDbConnection, } from './client';
 export { getMigrationsFolder, runRegistryMigrations } from './migrate';

package/dist/registry/db/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runRegistryMigrations = exports.getMigrationsFolder = exports.createRegistryDbConnection = exports.resolveRegistryDatabase = exports.resolveRegistryAdapter = exports.resolveDatabaseUrlEnv = exports.resolveApiTokenEnv = exports.DEFAULT_REGISTRY_API_TOKEN_ENV = exports.DEFAULT_REGISTRY_ADAPTER = exports.DEFAULT_DATABASE_URL_ENV = exports.registrySchema = exports.patterns = exports.patternFiles = exports.docsArtifacts = exports.components = exports.componentFiles = exports.buildMetadata = void 0;
+exports.runRegistryMigrations = exports.getMigrationsFolder = exports.createRegistryDbConnection = exports.resolveRegistryDatabase = exports.resolveRegistryDriver = exports.resolveDatabaseUrlEnv = exports.resolveApiTokenEnv = exports.DEFAULT_REGISTRY_API_TOKEN_ENV = exports.DEFAULT_REGISTRY_DRIVER = exports.DEFAULT_DATABASE_URL_ENV = exports.registrySchema = exports.patterns = exports.patternFiles = exports.docsArtifacts = exports.components = exports.componentFiles = exports.buildMetadata = void 0;
 var schema_1 = require("./schema");
 Object.defineProperty(exports, "buildMetadata", { enumerable: true, get: function () { return schema_1.buildMetadata; } });
 Object.defineProperty(exports, "componentFiles", { enumerable: true, get: function () { return schema_1.componentFiles; } });
@@ -9,14 +9,14 @@ Object.defineProperty(exports, "docsArtifacts", { enumerable: true, get: functio
 Object.defineProperty(exports, "patternFiles", { enumerable: true, get: function () { return schema_1.patternFiles; } });
 Object.defineProperty(exports, "patterns", { enumerable: true, get: function () { return schema_1.patterns; } });
 Object.defineProperty(exports, "registrySchema", { enumerable: true, get: function () { return schema_1.registrySchema; } });
-var adapter_1 = require("./adapter");
-Object.defineProperty(exports, "DEFAULT_DATABASE_URL_ENV", { enumerable: true, get: function () { return adapter_1.DEFAULT_DATABASE_URL_ENV; } });
-Object.defineProperty(exports, "DEFAULT_REGISTRY_ADAPTER", { enumerable: true, get: function () { return adapter_1.DEFAULT_REGISTRY_ADAPTER; } });
-Object.defineProperty(exports, "DEFAULT_REGISTRY_API_TOKEN_ENV", { enumerable: true, get: function () { return adapter_1.DEFAULT_REGISTRY_API_TOKEN_ENV; } });
-Object.defineProperty(exports, "resolveApiTokenEnv", { enumerable: true, get: function () { return adapter_1.resolveApiTokenEnv; } });
-Object.defineProperty(exports, "resolveDatabaseUrlEnv", { enumerable: true, get: function () { return adapter_1.resolveDatabaseUrlEnv; } });
-Object.defineProperty(exports, "resolveRegistryAdapter", { enumerable: true, get: function () { return adapter_1.resolveRegistryAdapter; } });
-Object.defineProperty(exports, "resolveRegistryDatabase", { enumerable: true, get: function () { return adapter_1.resolveRegistryDatabase; } });
+var driver_1 = require("./driver");
+Object.defineProperty(exports, "DEFAULT_DATABASE_URL_ENV", { enumerable: true, get: function () { return driver_1.DEFAULT_DATABASE_URL_ENV; } });
+Object.defineProperty(exports, "DEFAULT_REGISTRY_DRIVER", { enumerable: true, get: function () { return driver_1.DEFAULT_REGISTRY_DRIVER; } });
+Object.defineProperty(exports, "DEFAULT_REGISTRY_API_TOKEN_ENV", { enumerable: true, get: function () { return driver_1.DEFAULT_REGISTRY_API_TOKEN_ENV; } });
+Object.defineProperty(exports, "resolveApiTokenEnv", { enumerable: true, get: function () { return driver_1.resolveApiTokenEnv; } });
+Object.defineProperty(exports, "resolveDatabaseUrlEnv", { enumerable: true, get: function () { return driver_1.resolveDatabaseUrlEnv; } });
+Object.defineProperty(exports, "resolveRegistryDriver", { enumerable: true, get: function () { return driver_1.resolveRegistryDriver; } });
+Object.defineProperty(exports, "resolveRegistryDatabase", { enumerable: true, get: function () { return driver_1.resolveRegistryDatabase; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "createRegistryDbConnection", { enumerable: true, get: function () { return client_1.createRegistryDbConnection; } });
 var migrate_1 = require("./migrate");

package/dist/registry/db/migrate.d.ts

@@ -2,7 +2,7 @@
  * Registry migration runner.
  *
  * `handoff-app db:migrate` reads the consuming project's config + DB env vars, resolves the same
- * `runtime.registry.database.adapter` used at runtime/build, and applies the package-owned
+ * `runtime.registry.database.driver` used at runtime/build, and applies the package-owned
  * migration set with the bundled Drizzle migrator. Migrations are resolved relative to the
  * installed package (not the consuming project), so the schema is versioned with the tool. This
  * runs independently of `build`.

package/dist/registry/db/migrate.js

@@ -3,7 +3,7 @@
  * Registry migration runner.
  *
  * `handoff-app db:migrate` reads the consuming project's config + DB env vars, resolves the same
- * `runtime.registry.database.adapter` used at runtime/build, and applies the package-owned
+ * `runtime.registry.database.driver` used at runtime/build, and applies the package-owned
  * migration set with the bundled Drizzle migrator. Migrations are resolved relative to the
  * installed package (not the consuming project), so the schema is versioned with the tool. This
  * runs independently of `build`.
@@ -25,7 +25,7 @@ exports.runRegistryMigrations = exports.getMigrationsFolder = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../../utils/logger");
-const adapter_1 = require("./adapter");
+const driver_1 = require("./driver");
 const client_1 = require("./client");
 /**
  * Absolute path to the package-owned migrations folder. Resolved relative to the installed
@@ -44,15 +44,15 @@ const runRegistryMigrations = (handoff) => __awaiter(void 0, void 0, void 0, fun
     if (!handoff.config) {
         throw new Error('Handoff is not initialized; cannot resolve registry database configuration.');
     }
-    const { adapter, databaseUrlEnv, connectionString } = (0, adapter_1.resolveRegistryDatabase)(handoff.config);
+    const { driver, databaseUrlEnv, connectionString } = (0, driver_1.resolveRegistryDatabase)(handoff.config);
     const migrationsFolder = (0, exports.getMigrationsFolder)(handoff);
     const journalPath = path_1.default.join(migrationsFolder, 'meta', '_journal.json');
     if (!fs_extra_1.default.existsSync(journalPath)) {
         throw new Error(`Packaged registry migrations were not found at "${migrationsFolder}". This indicates a broken ` +
             `handoff-app installation — reinstall the package to restore the bundled migration set.`);
     }
-    logger_1.Logger.info(`Running registry migrations (adapter: "${adapter}", database url from "${databaseUrlEnv}").`);
-    const connection = yield (0, client_1.createRegistryDbConnection)({ adapter, connectionString });
+    logger_1.Logger.info(`Running registry migrations (driver: "${driver}", database url from "${databaseUrlEnv}").`);
+    const connection = yield (0, client_1.createRegistryDbConnection)({ driver, connectionString });
     try {
         yield connection.migrate(migrationsFolder);
         logger_1.Logger.success('Registry migrations applied successfully.');

package/dist/registry/publish/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Connected-workspace publish orchestration.
  *
- * `publish <component|pattern|page> <id>` prepares one entity and uploads its record, source files,
+ * `publish <components|patterns|pages> <id>` prepares one entity and uploads its record, source files,
  * applicable rendered artifacts, and build metadata through the shared registry client.
  *
  * The build is targeted: a component builds the global artifacts + that component; a pattern builds
@@ -25,3 +25,10 @@ export declare const resolveConnectionOrThrow: (handoff: Handoff) => import("../
  * receive a targeted build, while pages are packaged directly from their source.
  */
 export declare const publishEntity: (handoff: Handoff, kind: TransferEntityKind, id: string) => Promise<void>;
+/**
+ * Publish every component, pattern, or page declared in this connected workspace. Builds the kind
+ * once, assembles each entity's package, skips entities whose content hash already matches the
+ * registry (unless `--force`), and reports published/unchanged/failed counts. A per-entity failure is
+ * collected and never aborts the rest; the run throws at the end if any entity failed.
+ */
+export declare const publishEntities: (handoff: Handoff, kind: TransferEntityKind) => Promise<void>;

package/dist/registry/publish/index.js

@@ -2,7 +2,7 @@
 /**
  * Connected-workspace publish orchestration.
  *
- * `publish <component|pattern|page> <id>` prepares one entity and uploads its record, source files,
+ * `publish <components|patterns|pages> <id>` prepares one entity and uploads its record, source files,
  * applicable rendered artifacts, and build metadata through the shared registry client.
  *
  * The build is targeted: a component builds the global artifacts + that component; a pattern builds
@@ -22,7 +22,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.publishEntity = exports.resolveConnectionOrThrow = exports.PublishError = void 0;
+exports.publishEntities = exports.publishEntity = exports.resolveConnectionOrThrow = exports.PublishError = void 0;
 const css_1 = require("../../transformers/preview/component/css");
 const javascript_1 = require("../../transformers/preview/component/javascript");
 const builder_1 = __importDefault(require("../../transformers/preview/component/builder"));
@@ -124,3 +124,89 @@ const publishEntity = (handoff, kind, id) => __awaiter(void 0, void 0, void 0, f
     logger_1.Logger.success(`Published ${kind} "${id}" to the registry.`);
 });
 exports.publishEntity = publishEntity;
+/** The published-content hash a bulk publish compares for skip-unchanged (artifact for rendered kinds, source for pages). */
+const entityHash = (value) => { var _a; return (_a = value.artifactHash) !== null && _a !== void 0 ? _a : value.sourceHash; };
+/**
+ * Run one build covering every entity of the kind, so a bulk publish builds once instead of per id.
+ * Pages carry no rendered artifacts. Components need the global artifacts + all components; patterns
+ * additionally need all patterns composed (each references pre-built component HTML).
+ */
+const runBulkBuild = (handoff, kind) => __awaiter(void 0, void 0, void 0, function* () {
+    if (kind === 'page') {
+        return;
+    }
+    yield (0, javascript_1.buildMainJS)(handoff);
+    yield (0, css_1.buildMainCss)(handoff);
+    yield (0, builder_1.default)(handoff);
+    if (kind === 'pattern') {
+        yield (0, builder_2.processPatterns)(handoff);
+    }
+});
+/** List every declared entity id of the kind from the workspace store. */
+const listWorkspaceEntityIds = (handoff, kind) => __awaiter(void 0, void 0, void 0, function* () {
+    const store = kind === 'component' ? handoff.store.components : kind === 'pattern' ? handoff.store.patterns : handoff.store.pages;
+    return (yield store.list()).map((entity) => entity.id);
+});
+/**
+ * Publish every component, pattern, or page declared in this connected workspace. Builds the kind
+ * once, assembles each entity's package, skips entities whose content hash already matches the
+ * registry (unless `--force`), and reports published/unchanged/failed counts. A per-entity failure is
+ * collected and never aborts the rest; the run throws at the end if any entity failed.
+ */
+const publishEntities = (handoff, kind) => __awaiter(void 0, void 0, void 0, function* () {
+    const connection = (0, exports.resolveConnectionOrThrow)(handoff);
+    logger_1.Logger.info(`Building ${kind}s for publish…`);
+    yield runBulkBuild(handoff, kind);
+    const ids = yield listWorkspaceEntityIds(handoff, kind);
+    if (ids.length === 0) {
+        logger_1.Logger.success(`No ${kind}s are declared in this workspace; nothing to publish.`);
+        return;
+    }
+    const client = (0, client_1.createRegistryClient)({ baseUrl: connection.url, accessToken: connection.accessToken });
+    let remote = [];
+    if (!handoff.force) {
+        try {
+            remote = yield client.listEntities(kind);
+        }
+        catch (_a) {
+            // If the summary listing fails we simply publish everything (the server still overwrites in place).
+            logger_1.Logger.info(`Could not read current registry ${kind}s; publishing all.`);
+        }
+    }
+    const remoteHashById = new Map(remote.map((entry) => [entry.id, entityHash(entry)]));
+    let published = 0;
+    let unchanged = 0;
+    const failed = [];
+    for (const id of ids) {
+        try {
+            const pkg = yield (0, package_1.buildPublishPackage)(handoff, kind, id);
+            (0, package_1.assertRequiredArtifactsPresent)(pkg);
+            const remoteHash = remoteHashById.get(id);
+            const localHash = entityHash(pkg.build);
+            if (!handoff.force && remoteHash && localHash && remoteHash === localHash) {
+                unchanged += 1;
+                logger_1.Logger.info(`Unchanged: ${id}`);
+                continue;
+            }
+            yield client.publish(kind, id, pkg);
+            published += 1;
+            logger_1.Logger.info(`Published: ${id} (${pkg.artifacts.length} artifact(s), ${pkg.files.length} source file(s))`);
+        }
+        catch (error) {
+            const message = error instanceof client_1.RegistryClientError
+                ? (0, errors_1.describeUploadFailure)(error, connection.url, 'package')
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            failed.push({ id, message });
+        }
+    }
+    logger_1.Logger.success(`${kind[0].toUpperCase()}${kind.slice(1)}s publish complete — ${published} published, ${unchanged} unchanged${failed.length ? `, ${failed.length} failed` : ''}.`);
+    if (failed.length > 0) {
+        for (const failure of failed) {
+            logger_1.Logger.error(`  - ${failure.id}: ${failure.message}`);
+        }
+        throw new PublishError(`${failed.length} ${kind}(s) failed to publish.`);
+    }
+});
+exports.publishEntities = publishEntities;

package/dist/registry/transfer.d.ts

@@ -73,3 +73,16 @@ export interface CheckoutPayload {
     item: Record<string, unknown>;
     files: TransferFile[];
 }
+/**
+ * A published entity's summary from `GET /api/registry/transfer/{component|pattern|page}`. Carries
+ * the build hashes so a connected workspace can skip unchanged entities on a bulk publish and
+ * enumerate published ids for a bulk checkout. Components/patterns key on `artifactHash`; pages key
+ * on `sourceHash`.
+ */
+export interface EntitySummary {
+    id: string;
+    kind: TransferEntityKind;
+    status?: string;
+    artifactHash?: string;
+    sourceHash?: string;
+}

package/dist/types/config.d.ts

@@ -139,8 +139,12 @@ export interface HandoffRuntimeConfig {
         /** Name of the env var holding the registry API token. @default "HANDOFF_REGISTRY_API_TOKEN" */
         apiTokenEnv?: string;
         database?: {
-            /** @default "pg" */
-            adapter?: 'pg' | 'neon';
+            /**
+             * PostgreSQL is the supported database. `driver` selects the built-in connection driver — how
+             * to connect, not which engine — over the same package-owned Postgres schema and migrations.
+             * @default "pg"
+             */
+            driver?: 'pg' | 'neon';
         };
         /**
          * Where published asset blobs (icons/logos/fonts/sprites/archives) are stored. Defaults to the
@@ -214,7 +218,7 @@ export interface Config {
      */
     entries?: ConfigEntries;
     /**
-     * Override URLs for the asset zip download links. When unset, each link defaults to the canonical,
+     * Override URLs for the asset zip download links. When unset, each link defaults to the
      * basePath-aware asset route `{basePath}/api/docs/assets/{collection}/{collection}.zip`, served by
      * the docs read API in every runtime mode (from the DB in registry mode, from statically
      * materialized files in a static export).

package/drizzle.config.ts

@@ -5,7 +5,7 @@ import { defineConfig } from 'drizzle-kit';
  *
  * Migrations are generated into `./drizzle` and shipped with the `handoff-app` package; the
  * bundled runner (`handoff-app db:migrate`) applies them at install/deploy time. Both built-in
- * adapters (`pg`, `neon`) target the Postgres dialect, so a single migration set serves both.
+ * drivers (`pg`, `neon`) target the Postgres dialect, so a single migration set serves both.
  *
  * Generate after schema changes with: `npx drizzle-kit generate`
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handoff-app",
-  "version": "2.0.0-1",
+  "version": "2.0.0-2",
   "description": "Automated documentation toolchain for building client side documentation from figma",
   "author ": {
     "name": "Convertiv",

package/src/app/components/Foundations/DisplayLogo.tsx

@@ -2,9 +2,9 @@ import React from 'react';
 import type { DisplayableAsset } from '../util/useCollectionAssets';
 
 export const DisplayLogo: React.FC<{ logo: DisplayableAsset; content?: string; correct?: boolean }> = ({ logo, content }) => {
-  // Workspace/static ships the SVG body inline in tokens.json (`data`) — render it directly so the
-  // logo has no dependency on the fetch-only `/api/assets/logos/*` files (absent on a static host).
-  // Registry has no inline body; it falls back to the individual asset content URL (`src`).
+  // Workspace/static ships the SVG body inline in tokens.json (`data`), so render it directly and
+  // avoid depending on the fetch-only `/api/assets/logos/*` files that a static host won't have.
+  // Registry has no inline body, so it falls back to the individual asset content URL (`src`).
   const src = logo.src ?? `${process.env.HANDOFF_APP_BASE_PATH ?? ''}/api/assets/logos/${logo.path}`;
   return (
     <div className="flex flex-col gap-5">

package/src/app/lib/docs-api/runtime-config.ts

@@ -3,10 +3,10 @@ import path from 'path';
 import type { RuntimeMode } from '@handoff/types/config';
 import {
   DEFAULT_DATABASE_URL_ENV,
-  DEFAULT_REGISTRY_ADAPTER,
+  DEFAULT_REGISTRY_DRIVER,
   DEFAULT_REGISTRY_API_TOKEN_ENV,
-  type RegistryDatabaseAdapter,
-} from '@handoff/registry/db/adapter';
+  type RegistryDatabaseDriver,
+} from '@handoff/registry/db/driver';
 import { DEFAULT_ASSET_STORAGE_ADAPTER, type AssetStorageSettings } from '@handoff/registry/asset-storage/resolve';
 
 /**
@@ -15,7 +15,7 @@ import { DEFAULT_ASSET_STORAGE_ADAPTER, type AssetStorageSettings } from '@hando
  * The docs read API is mode-aware: workspace mode resolves artifacts from generated filesystem
  * files, registry mode resolves them from the database. The browser-facing `client.config.json`
  * carries only the resolved {@link RuntimeMode} (no connection details), so the server needs its
- * own non-secret source for the registry connection *inputs* — the selected adapter and the *name*
+ * own non-secret source for the registry connection *inputs* — the selected driver and the *name*
  * of the env var holding the database URL. The build persists these to `runtime.server.json`
  * alongside `client.config.json`; this module reads them back, never crossing secrets to the
  * browser (the connection-string value is resolved from the env var at request time, not here).
@@ -25,8 +25,8 @@ import { DEFAULT_ASSET_STORAGE_ADAPTER, type AssetStorageSettings } from '@hando
 
 /** Non-secret registry connection inputs resolved on the server. */
 export interface ServerRegistryRuntimeConfig {
-  /** Selected built-in database adapter. */
-  adapter: RegistryDatabaseAdapter;
+  /** Selected built-in database driver. */
+  driver: RegistryDatabaseDriver;
   /** Name of the env var holding the database connection string (value resolved at request time). */
   databaseUrlEnv: string;
   /**
@@ -49,11 +49,11 @@ export interface ServerRuntimeConfig {
 
 let cached: ServerRuntimeConfig | null = null;
 
-/** Safe defaults: workspace mode with the default Postgres adapter + `DATABASE_URL` env var. */
+/** Safe defaults: workspace mode with the default Postgres driver + `DATABASE_URL` env var. */
 const defaults = (): ServerRuntimeConfig => ({
   mode: 'workspace',
   registry: {
-    adapter: DEFAULT_REGISTRY_ADAPTER,
+    driver: DEFAULT_REGISTRY_DRIVER,
     databaseUrlEnv: DEFAULT_DATABASE_URL_ENV,
     apiTokenEnv: DEFAULT_REGISTRY_API_TOKEN_ENV,
   },
@@ -112,7 +112,7 @@ const fromEnv = (): ServerRuntimeConfig | null => {
   return {
     mode: mode === 'registry' ? 'registry' : 'workspace',
     registry: {
-      adapter: process.env.HANDOFF_REGISTRY_ADAPTER?.trim() === 'neon' ? 'neon' : 'pg',
+      driver: process.env.HANDOFF_REGISTRY_DRIVER?.trim() === 'neon' ? 'neon' : 'pg',
       databaseUrlEnv,
       apiTokenEnv,
     },
@@ -156,7 +156,7 @@ export const getServerRuntimeConfig = (): ServerRuntimeConfig => {
       cached = {
         mode: parsed?.mode === 'registry' ? 'registry' : 'workspace',
         registry: {
-          adapter: parsed?.registry?.adapter === 'neon' ? 'neon' : 'pg',
+          driver: parsed?.registry?.driver === 'neon' ? 'neon' : 'pg',
           databaseUrlEnv,
           apiTokenEnv,
         },

package/src/app/lib/registry-api/transfer.ts

@@ -432,6 +432,35 @@ const upsertBuildMetadata = async (db: RegistryDatabase, kind: TransferEntityKin
     .onConflictDoUpdate({ target: [buildMetadata.entityKind, buildMetadata.entityId], set: values as any });
 };
 
+/**
+ * Handles `GET /api/registry/transfer/{component|pattern|page}`. Lists summaries for one kind of
+ * entity: each id plus its build hashes and status. A connected workspace uses these to skip
+ * unchanged entities on a bulk publish and to enumerate published ids for a bulk checkout. The read
+ * is unauthenticated; only the registry-runtime and method guards apply.
+ */
+export const handleEntitySummaryRoute = (req: NextApiRequest, res: NextApiResponse, kind: TransferEntityKind): Promise<void> =>
+  handleRegistryRoute(req, res, ['GET'], async ({ db }) => {
+    const table = ENTITY[kind].table;
+    const rows = await db
+      .select({
+        id: table.id,
+        status: buildMetadata.status,
+        artifactHash: buildMetadata.artifactHash,
+        sourceHash: buildMetadata.sourceHash,
+      })
+      .from(table)
+      .leftJoin(buildMetadata, and(eq(buildMetadata.entityKind, kind), eq(buildMetadata.entityId, table.id)));
+
+    const entities = rows.map((row) => ({
+      id: row.id,
+      kind,
+      status: row.status ?? undefined,
+      artifactHash: row.artifactHash ?? undefined,
+      sourceHash: row.sourceHash ?? undefined,
+    }));
+    sendRegistryData(res, 200, { entities }, buildMeta());
+  });
+
 /**
  * Handle `GET /api/registry/transfer/{component|pattern}/:id` — checkout read. Returns the
  * normalized record plus its registry-safe source files so a connected workspace can reconstruct

package/src/app/lib/registry-connection.ts

@@ -7,7 +7,7 @@ import { getServerRuntimeConfig } from './docs-api/runtime-config';
  * Both the registry-mode docs read API and the registry management API resolve their database
  * through this single helper so one connection pool backs the whole registry runtime rather than
  * one pool per consumer. The connection string is read from the configured env var *name* at
- * request time — never persisted in config — and the selected adapter comes from the server runtime
+ * request time — never persisted in config — and the selected driver comes from the server runtime
  * config baked at build time.
  *
  * Server-only: imported exclusively by registry-mode API route helpers, which are themselves only
@@ -48,7 +48,7 @@ export const getRegistryConnection = (): Promise<RegistryDbConnection> => {
       )
     );
   }
-  connectionPromise = createRegistryDbConnection({ adapter: registry.adapter, connectionString }).catch((error) => {
+  connectionPromise = createRegistryDbConnection({ driver: registry.driver, connectionString }).catch((error) => {
     connectionPromise = null;
     // TODO: Route server errors through the shared logger.
     console.error('Registry database connection failed.', error);

package/src/app/next.config.mjs

@@ -95,7 +95,7 @@ const nextConfig = {
     // config-only — these are derived from `runtime.*`, not inferred from env at runtime. The DB
     // connection string itself is read from the named env var at request time (deployment-supplied).
     HANDOFF_RUNTIME_MODE: '%HANDOFF_RUNTIME_MODE%',
-    HANDOFF_REGISTRY_ADAPTER: '%HANDOFF_REGISTRY_ADAPTER%',
+    HANDOFF_REGISTRY_DRIVER: '%HANDOFF_REGISTRY_DRIVER%',
     HANDOFF_REGISTRY_DATABASE_URL_ENV: '%HANDOFF_REGISTRY_DATABASE_URL_ENV%',
     HANDOFF_REGISTRY_API_TOKEN_ENV: '%HANDOFF_REGISTRY_API_TOKEN_ENV%',
     // Asset storage selection (provider + non-secret options + env-var names). Secret values (Blob

package/src/app/pages/api/registry/transfer/[kind]/index.ts

@@ -0,0 +1,21 @@
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { singleQueryValue } from '@/lib/api/query';
+import { handleRegistryRoute, sendRegistryError } from '@/lib/registry-api';
+import { handleEntitySummaryRoute } from '@/lib/registry-api/transfer';
+
+/**
+ * `GET /api/registry/transfer/{component|pattern|page}`. Lists the registry's published entity
+ * summaries for one kind (id, build hashes, status) so a connected workspace can skip unchanged
+ * entities on a bulk publish and enumerate published ids for a bulk checkout. Registry-runtime only,
+ * enforced by the guard stack. The `tokens` and `assets` summaries have their own static routes,
+ * which Next resolves before this dynamic segment.
+ */
+export default function handler(req: NextApiRequest, res: NextApiResponse): Promise<void> {
+  const kind = singleQueryValue(req.query.kind);
+  if (kind !== 'component' && kind !== 'pattern' && kind !== 'page') {
+    return handleRegistryRoute(req, res, ['GET'], async () => {
+      sendRegistryError(res, 'not_found', `Unknown transfer entity kind "${kind ?? ''}".`);
+    });
+  }
+  return handleEntitySummaryRoute(req, res, kind);
+}