@taskcast/postgres 0.3.1 → 1.0.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { PostgresLongTermStore } from './long-term.js';
+export { runMigrations, loadMigrationFiles } from './migration-runner.js';
 import { PostgresLongTermStore } from './long-term.js';
 export interface PostgresAdapterOptions {
     url: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAGtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAG5F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAGzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAG5F"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { PostgresLongTermStore } from './long-term.js';
+export { runMigrations, loadMigrationFiles } from './migration-runner.js';
 import postgres from 'postgres';
 import { PostgresLongTermStore } from './long-term.js';
 export function createPostgresAdapter(options) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAOtD,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IAC3E,OAAO,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAA;AACvC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAEzE,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAOtD,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IAC3E,OAAO,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAA;AACvC,CAAC"}

package/dist/migration-runner.d.ts

@@ -0,0 +1,43 @@
+import type postgres from 'postgres';
+export interface MigrationFile {
+    version: number;
+    description: string;
+    sql: string;
+    checksum: Buffer;
+    filename: string;
+}
+export interface MigrationResult {
+    applied: string[];
+    skipped: string[];
+}
+/**
+ * Parse a migration filename into version and description.
+ *
+ * Format: `{version}_{description}.sql`
+ * - version: numeric prefix (e.g. "001" → 1)
+ * - description: rest of filename with underscores replaced by spaces
+ *
+ * Returns null if the filename doesn't match the expected format.
+ */
+export declare function parseMigrationFilename(filename: string): {
+    version: number;
+    description: string;
+} | null;
+/**
+ * Compute a SHA-384 hash of SQL content, matching sqlx's checksum behavior.
+ * Returns a 48-byte Buffer.
+ */
+export declare function computeChecksum(sql: string): Buffer;
+/**
+ * Read and parse all *.sql migration files from a directory, sorted by version.
+ */
+export declare function loadMigrationFiles(migrationsDir: string): MigrationFile[];
+/**
+ * Run pending migrations and verify checksums of already-applied ones.
+ *
+ * This is fully compatible with sqlx's _sqlx_migrations table — the Rust
+ * server and the TS server can share the same database and track migrations
+ * in the same table.
+ */
+export declare function runMigrations(sql: ReturnType<typeof postgres>, migrationsDir: string): Promise<MigrationResult>;
+//# sourceMappingURL=migration-runner.d.ts.map

package/dist/migration-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.d.ts","sourceRoot":"","sources":["../src/migration-runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBxG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAoBzE;AAaD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CAkE1B"}

package/dist/migration-runner.js

@@ -0,0 +1,122 @@
+import { createHash } from 'node:crypto';
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Parse a migration filename into version and description.
+ *
+ * Format: `{version}_{description}.sql`
+ * - version: numeric prefix (e.g. "001" → 1)
+ * - description: rest of filename with underscores replaced by spaces
+ *
+ * Returns null if the filename doesn't match the expected format.
+ */
+export function parseMigrationFilename(filename) {
+    if (!filename.endsWith('.sql'))
+        return null;
+    const withoutExt = filename.slice(0, -4); // remove ".sql"
+    const underscoreIdx = withoutExt.indexOf('_');
+    if (underscoreIdx === -1)
+        return null; // no underscore means no description
+    const versionStr = withoutExt.slice(0, underscoreIdx);
+    const descriptionRaw = withoutExt.slice(underscoreIdx + 1);
+    if (!/^\d+$/.test(versionStr))
+        return null;
+    if (descriptionRaw.length === 0)
+        return null;
+    const version = parseInt(versionStr, 10);
+    const description = descriptionRaw.replace(/_/g, ' ');
+    return { version, description };
+}
+/**
+ * Compute a SHA-384 hash of SQL content, matching sqlx's checksum behavior.
+ * Returns a 48-byte Buffer.
+ */
+export function computeChecksum(sql) {
+    return createHash('sha384').update(sql).digest();
+}
+/**
+ * Read and parse all *.sql migration files from a directory, sorted by version.
+ */
+export function loadMigrationFiles(migrationsDir) {
+    const entries = readdirSync(migrationsDir).filter((f) => f.endsWith('.sql')).sort();
+    const files = [];
+    for (const filename of entries) {
+        const parsed = parseMigrationFilename(filename);
+        if (!parsed)
+            continue;
+        const content = readFileSync(join(migrationsDir, filename), 'utf8');
+        files.push({
+            version: parsed.version,
+            description: parsed.description,
+            sql: content,
+            checksum: computeChecksum(content),
+            filename,
+        });
+    }
+    files.sort((a, b) => a.version - b.version);
+    return files;
+}
+const CREATE_MIGRATIONS_TABLE = `
+CREATE TABLE IF NOT EXISTS _sqlx_migrations (
+    version BIGINT PRIMARY KEY,
+    description TEXT NOT NULL,
+    installed_on TIMESTAMPTZ NOT NULL DEFAULT now(),
+    success BOOLEAN NOT NULL,
+    checksum BYTEA NOT NULL,
+    execution_time BIGINT NOT NULL
+)
+`;
+/**
+ * Run pending migrations and verify checksums of already-applied ones.
+ *
+ * This is fully compatible with sqlx's _sqlx_migrations table — the Rust
+ * server and the TS server can share the same database and track migrations
+ * in the same table.
+ */
+export async function runMigrations(sql, migrationsDir) {
+    // 1. Ensure the migrations table exists
+    await sql.unsafe(CREATE_MIGRATIONS_TABLE);
+    // 2. Check for dirty migrations (success = false)
+    const dirty = await sql.unsafe('SELECT version, description FROM _sqlx_migrations WHERE success = false');
+    if (dirty.length > 0) {
+        const row = dirty[0];
+        throw new Error(`Dirty migration found: version ${row['version']} (${row['description']}). ` +
+            'A previous migration failed. Please fix it manually before running migrations.');
+    }
+    // 3. Load local files and query applied migrations
+    const localFiles = loadMigrationFiles(migrationsDir);
+    const appliedRows = await sql.unsafe('SELECT version, checksum FROM _sqlx_migrations ORDER BY version');
+    const appliedMap = new Map();
+    for (const row of appliedRows) {
+        appliedMap.set(Number(row['version']), Buffer.from(row['checksum']));
+    }
+    const result = { applied: [], skipped: [] };
+    // 4. Process each migration file
+    for (const file of localFiles) {
+        const appliedChecksum = appliedMap.get(file.version);
+        if (appliedChecksum) {
+            // Already applied — verify checksum
+            if (!file.checksum.equals(appliedChecksum)) {
+                throw new Error(`Checksum mismatch for migration ${file.filename} (version ${file.version}). ` +
+                    'The applied migration differs from the local file.');
+            }
+            result.skipped.push(file.filename);
+        }
+        else {
+            // Not yet applied — execute it
+            const startTime = process.hrtime.bigint();
+            await sql.begin(async (tx) => {
+                // Insert the migration record first with execution_time = -1 (in-progress marker)
+                await tx.unsafe('INSERT INTO _sqlx_migrations (version, description, success, checksum, execution_time) VALUES ($1, $2, TRUE, $3, -1)', [file.version, file.description, file.checksum]);
+                // Execute the migration SQL
+                await tx.unsafe(file.sql);
+            });
+            // Update execution_time with actual nanoseconds (outside transaction, matching sqlx behavior)
+            const elapsed = process.hrtime.bigint() - startTime;
+            await sql.unsafe('UPDATE _sqlx_migrations SET execution_time = $1 WHERE version = $2', [elapsed.toString(), file.version]);
+            result.applied.push(file.filename);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=migration-runner.js.map

package/dist/migration-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-runner.js","sourceRoot":"","sources":["../src/migration-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskcast/postgres",
-  "version": "0.3.1",
+  "version": "1.0.0",
   "description": "PostgreSQL long-term store adapter for Taskcast.",
   "repository": {
     "type": "git",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "postgres": "^3.4.5",
-    "@taskcast/core": "0.3.1"
+    "@taskcast/core": "1.0.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0",