@opengeni/db 0.2.0

package/dist/migrate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Apply the OpenGeni SQL migration chain.
+ *
+ * STANDALONE (default, unchanged): `migrate()` / `migrate(databaseUrl)` runs the
+ * whole chain with NO search_path manipulation, so every unqualified
+ * table/index/policy lands in the server default schema (`public`). This is the
+ * byte-for-byte historical behavior — the migration test suite calls
+ * `migrate(DB_URL)` and is unaffected.
+ *
+ * EMBEDDED (Step I, §7.8 runtime/SDK half): pass a `schema` (or set
+ * `OPENGENI_DB_SCHEMA`). The migrate session then `CREATE SCHEMA IF NOT EXISTS`
+ * for both `<schema>` and `opengeni_private`, and sets
+ * `search_path = "<schema>", "opengeni_private", "public"`, so EVERY unqualified
+ * DDL statement lands in the dedicated schema with NO per-statement SQL rewrite
+ * (the SPIKE-1 F1 result). Two things make this work and stay idempotent:
+ *   1. The policy-existence guards in the migration SQL use `current_schema()`
+ *      (not a hardcoded `'public'`) — so a re-run finds the policy it already
+ *      created in `<schema>` and DROP/CREATEs idempotently instead of failing
+ *      with "policy already exists". (This guard substitution is the migrate-
+ *      time enabler for the runtime search_path approach; without it the SDK
+ *      entry point silently fails on re-run — the Fork-6 hazard.)
+ *   2. `public` stays LAST on the path so `gen_random_uuid()` (pgcrypto) and the
+ *      `vector` type — both installed into `public` by 0000 — still resolve. The
+ *      `opengeni_private.*` helpers are always called with an absolute prefix.
+ *
+ * `OPENGENI_DB_SCHEMA` defaults UNSET → `public` → standalone, so the default
+ * binding never regresses.
+ */
+declare function migrate(databaseUrl?: string, schema?: string | undefined): Promise<void>;
+/**
+ * SDK entry point (Step I): run the migration chain over a host-supplied admin
+ * connection string against an explicit target schema. This is the embedded
+ * topology's named entry — a host calls `runMigrations(adminConnection,
+ * targetSchema)` from its own provisioning code instead of relying on env vars.
+ * `targetSchema` undefined → `public` → standalone behavior. Thin wrapper over
+ * `migrate` so there is one migration engine.
+ */
+declare function runMigrations(adminConnection: string, targetSchema?: string): Promise<void>;
+
+export { migrate, runMigrations };

package/dist/migrate.js

@@ -0,0 +1,10 @@
+import {
+  migrate,
+  runMigrations
+} from "./chunk-OGCE6O2X.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  migrate,
+  runMigrations
+};
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}