@shivaedev/sql 0.43.0 → 0.44.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.44.0 - 2026-11-06
+
+### Breaking
+
+- Import `MIGRATIONS_DIRECTORY` and `MIGRATION_FILE_PATTERN` from `@shivaedev/sql/migration.ts` instead of `@shivaedev/sql/migrationConvention.ts`.
+
 ## 0.43.0 - 2026-11-05
 
 ### Breaking

package/README.md

@@ -957,7 +957,7 @@ const migrateOrders = migratePostgres({
 
 Use sequential numbers, not timestamps. Effect's Migrator skips any migration whose ID is not greater than the latest applied ID. A timestamped migration from a branch that merges late could therefore be silently skipped by native Migrator on an already-migrated database. Two branches that choose the same sequential number instead fail loudly with Effect's duplicate-ID `MigrationError` (`kind: "Duplicates"`), forcing the second branch to renumber and re-check. This package also rejects gaps below the latest applied ID, as described below.
 
-`migrationConvention.ts` exports `MIGRATIONS_DIRECTORY` and `MIGRATION_FILE_PATTERN` so template packaging and repository quality configuration share the folder and filename convention.
+`migration.ts` exports `MIGRATIONS_DIRECTORY` and `MIGRATION_FILE_PATTERN` so template packaging and repository quality configuration share the folder and filename convention.
 
 `migratePostgres` rejects loaded migration IDs at or below the latest applied ID that are missing from the ledger with a typed native `MigrationError` (`kind: "BadState"`) naming those IDs. It also rejects a loaded ID recorded under a different name, matching readiness's ID and name checks. Both checks run before any new migration body, schema component or release publication. Later ledger entries absent from the loader are allowed for older releases.
 
@@ -1018,7 +1018,7 @@ Import the module that defines the name; there is no root entry.
 - `@shivaedev/sql/transact.ts`: `transact(effect, options)` or `effect.pipe(transact(options))` — Required `onSqlError` mapper; requires `SqlClient` and `Reactivity`.
 - `@shivaedev/sql/transact.ts`: `invalidateOnCommit(keys, options?)` — Records keys for its client, or invalidates immediately outside a transaction.
 - `@shivaedev/sql/advisoryXactLock.ts`: `advisoryXactLock(key)`, `AdvisoryLockOutsideTransaction` — PostgreSQL transaction lock on a bigint or string hashed with `hashtextextended(key, 0)`; requires an active transaction on the current `SqlClient`.
-- `@shivaedev/sql/migrationConvention.ts`: `MIGRATIONS_DIRECTORY`, `MIGRATION_FILE_PATTERN` — Application folder and four-digit sequential snake_case TypeScript filename pattern.
+- `@shivaedev/sql/migration.ts`: `MIGRATIONS_DIRECTORY`, `MIGRATION_FILE_PATTERN` — Application folder and four-digit sequential snake_case TypeScript filename pattern.
 - `@shivaedev/sql/migrationsFromDirectory.ts`: `migrationsFromDirectory(root)` — Discover migrations under the application root with native `FileSystem` and `Path`.
 - `@shivaedev/sql/migrations.ts`: `migratePostgres(options)` — Native loader, required `lockTimeout`, optional `components`, `release` and ledger `table`, default `effect_sql_migrations`.
 - `@shivaedev/sql/backfillPostgres.ts`: `backfillPostgres({ batchSize, lock, loadProgress, select, process, saveProgress })` — Bounded transactions with application-owned checkpoints; returns the rows processed in this invocation. `BackfillInsideTransaction` rejects an enclosing transaction.

package/dist/{migrationConvention.d.ts → migration.d.ts}

@@ -1,3 +1,3 @@
 export declare const MIGRATIONS_DIRECTORY = "src/server/migrations";
 export declare const MIGRATION_FILE_PATTERN: RegExp;
-//# sourceMappingURL=migrationConvention.d.ts.map
+//# sourceMappingURL=migration.d.ts.map

package/dist/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAC5D,eAAO,MAAM,sBAAsB,QAAkD,CAAC"}

package/dist/{migrationConvention.js → migration.js}

@@ -1,3 +1,3 @@
 export const MIGRATIONS_DIRECTORY = "src/server/migrations";
 export const MIGRATION_FILE_PATTERN = /^[0-9]{4}_[a-z][a-z0-9]*(?:_[a-z0-9]+)*\.ts$/u;
-//# sourceMappingURL=migrationConvention.js.map
+//# sourceMappingURL=migration.js.map

package/dist/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC"}

package/dist/migrationsFromDirectory.js

@@ -1,6 +1,6 @@
 import { Effect, Path } from "effect";
 import * as MigratorFileSystem from "effect/sql/MigratorFileSystem";
-import { MIGRATIONS_DIRECTORY } from "#migrationConvention.ts";
+import { MIGRATIONS_DIRECTORY } from "#migration.ts";
 export function migrationsFromDirectory(root) {
     return Effect.flatMap(Path.Path, (path) => MigratorFileSystem.fromFileSystem(path.join(root, MIGRATIONS_DIRECTORY)));
 }

package/dist/migrationsFromDirectory.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrationsFromDirectory.js","sourceRoot":"","sources":["../src/migrationsFromDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,kBAAkB,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACtH,CAAC"}
+{"version":3,"file":"migrationsFromDirectory.js","sourceRoot":"","sources":["../src/migrationsFromDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,kBAAkB,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACtH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/sql",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "description": "Schema-derived repositories over native Effect SQL",
   "keywords": [
     "effect"
@@ -50,12 +50,12 @@
     "@effect/platform-node": "4.1.0",
     "@effect/sql-pg": "4.1.0",
     "@effect/sql-sqlite-node": "4.1.0",
-    "@shivaedev/contract": "0.40.0",
-    "@shivaedev/jobs": "0.40.0",
-    "@shivaedev/quality": "0.66.0",
-    "@shivaedev/test-kits": "0.8.1",
-    "@shivaedev/test-sql": "0.24.1",
-    "@shivaedev/test-story": "0.42.1",
+    "@shivaedev/contract": "0.41.0",
+    "@shivaedev/jobs": "0.40.1",
+    "@shivaedev/quality": "0.67.0",
+    "@shivaedev/test-kits": "0.9.0",
+    "@shivaedev/test-sql": "0.24.2",
+    "@shivaedev/test-story": "0.43.0",
     "@types/node": "24.19.2",
     "effect": "4.1.0",
     "typescript": "7.0.2",

package/src/migrationsFromDirectory.ts

@@ -1,6 +1,6 @@
 import { Effect, Path } from "effect";
 import * as MigratorFileSystem from "effect/sql/MigratorFileSystem";
-import { MIGRATIONS_DIRECTORY } from "#migrationConvention.ts";
+import { MIGRATIONS_DIRECTORY } from "#migration.ts";
 
 export function migrationsFromDirectory(root: string) {
 	return Effect.flatMap(Path.Path, (path) => MigratorFileSystem.fromFileSystem(path.join(root, MIGRATIONS_DIRECTORY)));

package/dist/migrationConvention.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrationConvention.d.ts","sourceRoot":"","sources":["../src/migrationConvention.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAC5D,eAAO,MAAM,sBAAsB,QAAkD,CAAC"}

package/dist/migrationConvention.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"migrationConvention.js","sourceRoot":"","sources":["../src/migrationConvention.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC"}