handoff-app 1.2.2-7 → 2.0.0-1

package/dist/registry/db/client.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * 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
+ * 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
+ * Postgres/Neon drivers into memory when the registry is not in use.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+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
+ * 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, }) {
+    var _b;
+    if (adapter === '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')));
+        neonConfig.webSocketConstructor = (_b = ws.default) !== null && _b !== void 0 ? _b : ws;
+        const { drizzle } = yield Promise.resolve().then(() => __importStar(require('drizzle-orm/neon-serverless')));
+        const { migrate } = yield Promise.resolve().then(() => __importStar(require('drizzle-orm/neon-serverless/migrator')));
+        const pool = new Pool({ connectionString });
+        try {
+            yield pool.query('select 1');
+        }
+        catch (error) {
+            yield pool.end().catch(() => undefined);
+            throw error;
+        }
+        const db = drizzle(pool, { schema });
+        return {
+            adapter,
+            db,
+            migrate: (migrationsFolder) => migrate(db, { migrationsFolder }),
+            close: () => pool.end(),
+        };
+    }
+    const { Pool } = yield Promise.resolve().then(() => __importStar(require('pg')));
+    const { drizzle } = yield Promise.resolve().then(() => __importStar(require('drizzle-orm/node-postgres')));
+    const { migrate } = yield Promise.resolve().then(() => __importStar(require('drizzle-orm/node-postgres/migrator')));
+    const pool = new Pool({ connectionString });
+    try {
+        yield pool.query('select 1');
+    }
+    catch (error) {
+        yield pool.end().catch(() => undefined);
+        throw error;
+    }
+    const db = drizzle(pool, { schema });
+    return {
+        adapter,
+        db,
+        migrate: (migrationsFolder) => migrate(db, { migrationsFolder }),
+        close: () => pool.end(),
+    };
+});
+exports.createRegistryDbConnection = createRegistryDbConnection;

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

@@ -0,0 +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 { createRegistryDbConnection, type CreateRegistryDbConnectionParams, type RegistryDatabase, type RegistryDbConnection, } from './client';
+export { getMigrationsFolder, runRegistryMigrations } from './migrate';

package/dist/registry/db/index.js

@@ -0,0 +1,24 @@
+"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;
+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; } });
+Object.defineProperty(exports, "components", { enumerable: true, get: function () { return schema_1.components; } });
+Object.defineProperty(exports, "docsArtifacts", { enumerable: true, get: function () { return schema_1.docsArtifacts; } });
+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 client_1 = require("./client");
+Object.defineProperty(exports, "createRegistryDbConnection", { enumerable: true, get: function () { return client_1.createRegistryDbConnection; } });
+var migrate_1 = require("./migrate");
+Object.defineProperty(exports, "getMigrationsFolder", { enumerable: true, get: function () { return migrate_1.getMigrationsFolder; } });
+Object.defineProperty(exports, "runRegistryMigrations", { enumerable: true, get: function () { return migrate_1.runRegistryMigrations; } });

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

@@ -0,0 +1,23 @@
+/**
+ * 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
+ * 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`.
+ */
+import type Handoff from '../../';
+/**
+ * Absolute path to the package-owned migrations folder. Resolved relative to the installed
+ * `handoff-app` package root (`<package>/drizzle`) via {@link Handoff.modulePath} so it is
+ * independent of the consuming project's working directory.
+ */
+export declare const getMigrationsFolder: (handoff: Handoff) => string;
+/**
+ * Run the package-owned registry migrations against the configured database.
+ *
+ * @throws when Handoff is uninitialized, the database URL env var is unset, or the packaged
+ *   migrations are missing — each with an actionable message.
+ */
+export declare const runRegistryMigrations: (handoff: Handoff) => Promise<void>;

package/dist/registry/db/migrate.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * 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
+ * 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`.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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 client_1 = require("./client");
+/**
+ * Absolute path to the package-owned migrations folder. Resolved relative to the installed
+ * `handoff-app` package root (`<package>/drizzle`) via {@link Handoff.modulePath} so it is
+ * independent of the consuming project's working directory.
+ */
+const getMigrationsFolder = (handoff) => path_1.default.resolve(handoff.modulePath, 'drizzle');
+exports.getMigrationsFolder = getMigrationsFolder;
+/**
+ * Run the package-owned registry migrations against the configured database.
+ *
+ * @throws when Handoff is uninitialized, the database URL env var is unset, or the packaged
+ *   migrations are missing — each with an actionable message.
+ */
+const runRegistryMigrations = (handoff) => __awaiter(void 0, void 0, void 0, function* () {
+    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 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 });
+    try {
+        yield connection.migrate(migrationsFolder);
+        logger_1.Logger.success('Registry migrations applied successfully.');
+    }
+    finally {
+        yield connection.close();
+    }
+});
+exports.runRegistryMigrations = runRegistryMigrations;