@antelopejs/postgres 0.2.0 → 0.2.1

package/dist/config.d.ts

@@ -1,6 +1,9 @@
 import type { PoolConfig } from "pg";
 export type MigrationMode = "safe" | "destructive";
 export type Mode = "owned" | "external";
+export interface CatalogOptions {
+    enabled?: boolean;
+}
 export interface Options {
     mode?: Mode;
     url?: string;
@@ -13,6 +16,7 @@ export interface Options {
     changeRetentionMs?: number;
     changeBatchSize?: number;
     changePollIntervalMs?: number;
+    catalog?: CatalogOptions;
 }
 export interface ResolvedOptions {
     mode: Mode;
@@ -26,6 +30,7 @@ export interface ResolvedOptions {
     changeRetentionMs: number;
     changeBatchSize: number;
     changePollIntervalMs: number;
+    catalog: CatalogOptions;
 }
 export declare function SetOptions(options?: Options): ResolvedOptions;
 export declare function GetOptions(): ResolvedOptions;

package/dist/config.js

@@ -72,6 +72,7 @@ function SetOptions(options) {
         changeRetentionMs: PositiveSafeInteger("changeRetentionMs", options?.changeRetentionMs, DEFAULT_CHANGE_RETENTION_MS),
         changeBatchSize: PositiveSafeInteger("changeBatchSize", options?.changeBatchSize, DEFAULT_CHANGE_BATCH_SIZE),
         changePollIntervalMs: PositiveSafeInteger("changePollIntervalMs", options?.changePollIntervalMs, DEFAULT_CHANGE_POLL_INTERVAL_MS),
+        catalog: options?.catalog ?? {},
     };
     return resolved;
 }

package/dist/config.js.map

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

package/dist/implementations/catalog/index.d.ts

@@ -0,0 +1,7 @@
+import type { CatalogInfo, Measure, ProfileRequest, ReferenceCheck, ReferenceMatch, RelationDescription, RelationProfile, RelationSummary, RowSample, SampleRequest } from "@antelopejs/interface-database-catalog";
+export declare function Info(): Promise<CatalogInfo>;
+export declare function ListRelations(schemas?: string[]): Promise<RelationSummary[]>;
+export declare function DescribeRelations(relations: string[]): Promise<RelationDescription[]>;
+export declare function Profile(request: ProfileRequest): Promise<RelationProfile>;
+export declare function CheckReference(check: ReferenceCheck): Promise<Measure<ReferenceMatch>>;
+export declare function SampleRows(request: SampleRequest): Promise<RowSample>;

package/dist/implementations/catalog/index.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Info = Info;
+exports.ListRelations = ListRelations;
+exports.DescribeRelations = DescribeRelations;
+exports.Profile = Profile;
+exports.CheckReference = CheckReference;
+exports.SampleRows = SampleRows;
+const runtime_1 = require("@antelopejs/interface-core/runtime");
+const config_1 = require("../../config");
+const external_discovery_1 = require("../database/external-discovery");
+const external_measures_1 = require("../database/external-measures");
+const external_profile_1 = require("../database/external-profile");
+const external_reference_1 = require("../database/external-reference");
+const external_rows_1 = require("../database/external-rows");
+const OWNED_REFUSAL = "the catalog describes a database an external instance was pointed at; this instance owns its tables";
+const DEVELOPMENT_REFUSAL = "the catalog is a development tool: it answers under ajs project dev or run, or with catalog.enabled";
+async function IsEnabled() {
+    const configured = (0, config_1.GetOptions)().catalog.enabled;
+    return configured ?? (await (0, runtime_1.GetRuntimeInfo)()).dev;
+}
+async function Guard() {
+    if (!(0, config_1.IsExternal)()) {
+        throw new Error(OWNED_REFUSAL);
+    }
+    if (!(await IsEnabled())) {
+        throw new Error(DEVELOPMENT_REFUSAL);
+    }
+}
+async function Info() {
+    await Guard();
+    return (0, external_discovery_1.ReadInfo)();
+}
+async function ListRelations(schemas) {
+    await Guard();
+    return (0, external_measures_1.Sequentially)(await (0, external_discovery_1.ReadRelationRows)(schemas), external_discovery_1.Summarize);
+}
+async function DescribeRelations(relations) {
+    await Guard();
+    const rows = await (0, external_discovery_1.ReadNamedRelationRows)(relations);
+    const found = new Set(rows.map(external_discovery_1.RelationName));
+    const missing = relations.filter((relation) => !found.has(relation));
+    if (missing.length > 0) {
+        throw new Error(`No relation ${missing.join(", ")} that the connected role can see`);
+    }
+    return (0, external_measures_1.Sequentially)(rows, external_discovery_1.DescribeRow);
+}
+async function Profile(request) {
+    await Guard();
+    return (0, external_profile_1.ProfileRelation)(request);
+}
+async function CheckReference(check) {
+    await Guard();
+    return (0, external_reference_1.CheckColumnReference)(check);
+}
+async function SampleRows(request) {
+    await Guard();
+    return (0, external_rows_1.SampleRelationRows)(request);
+}
+//# sourceMappingURL=index.js.map

package/dist/implementations/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/catalog/index.ts"],"names":[],"mappings":";;AAgDA,oBAGC;AAED,sCAKC;AAED,8CAaC;AAED,0BAKC;AAED,wCAKC;AAED,gCAGC;AA5FD,gEAAoE;AAcpE,yCAAsD;AACtD,uEAOwC;AACxC,qEAA6D;AAC7D,mEAA+D;AAC/D,uEAAsE;AACtE,6DAA+D;AAE/D,MAAM,aAAa,GACjB,qGAAqG,CAAC;AACxG,MAAM,mBAAmB,GACvB,qGAAqG,CAAC;AAExG,KAAK,UAAU,SAAS;IACtB,MAAM,UAAU,GAAG,IAAA,mBAAU,GAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAChD,OAAO,UAAU,IAAI,CAAC,MAAM,IAAA,wBAAc,GAAE,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAGD,KAAK,UAAU,KAAK;IAClB,IAAI,CAAC,IAAA,mBAAU,GAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,IAAI;IACxB,MAAM,KAAK,EAAE,CAAC;IACd,OAAO,IAAA,6BAAQ,GAAE,CAAC;AACpB,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,OAAkB;IAElB,MAAM,KAAK,EAAE,CAAC;IACd,OAAO,IAAA,gCAAY,EAAC,MAAM,IAAA,qCAAgB,EAAC,OAAO,CAAC,EAAE,8BAAS,CAAC,CAAC;AAClE,CAAC;AAEM,KAAK,UAAU,iBAAiB,CACrC,SAAmB;IAEnB,MAAM,KAAK,EAAE,CAAC;IACd,MAAM,IAAI,GAAG,MAAM,IAAA,0CAAqB,EAAC,SAAS,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,iCAAY,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,gCAAY,EAAC,IAAI,EAAE,gCAAW,CAAC,CAAC;AACzC,CAAC;AAEM,KAAK,UAAU,OAAO,CAC3B,OAAuB;IAEvB,MAAM,KAAK,EAAE,CAAC;IACd,OAAO,IAAA,kCAAe,EAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAEM,KAAK,UAAU,cAAc,CAClC,KAAqB;IAErB,MAAM,KAAK,EAAE,CAAC;IACd,OAAO,IAAA,yCAAoB,EAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,OAAsB;IACrD,MAAM,KAAK,EAAE,CAAC;IACd,OAAO,IAAA,kCAAkB,EAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/implementations/database/external-catalog.d.ts

@@ -10,6 +10,17 @@ export interface CatalogColumn {
     hasDefault: boolean;
     generated: boolean;
     identity: string;
+    comment: string | null;
+    enumLabels: string[] | null;
+}
+export interface CatalogIndex {
+    name: string;
+    primary: boolean;
+    unique: boolean;
+    btree: boolean;
+    total: boolean;
+    notNull: boolean;
+    columns: string[];
 }
 export interface CatalogRelation {
     kind: string;
@@ -19,4 +30,8 @@ export interface CatalogRelation {
     keyName?: string;
     indexes: string[][];
 }
+export declare const RELATION_KINDS = "('r', 'p', 'v', 'm', 'f')";
+export declare function KeyOf(indexes: CatalogIndex[]): CatalogIndex | undefined;
+export declare function ReadColumns(oid: number): Promise<CatalogColumn[]>;
+export declare function ReadIndexes(oid: number): Promise<CatalogIndex[]>;
 export declare function ReadRelation(schemaName: string, relationName: string): Promise<CatalogRelation | undefined>;

package/dist/implementations/database/external-catalog.js

@@ -1,18 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RELATION_KINDS = void 0;
+exports.KeyOf = KeyOf;
+exports.ReadColumns = ReadColumns;
+exports.ReadIndexes = ReadIndexes;
 exports.ReadRelation = ReadRelation;
 const connection_1 = require("../../connection");
-const RELATION_KINDS = "('r', 'p', 'v', 'm', 'f')";
+exports.RELATION_KINDS = "('r', 'p', 'v', 'm', 'f')";
 const RELATION_SQL = `
   SELECT c.oid, c.relkind AS kind, has_table_privilege(c.oid, 'SELECT') AS readable
   FROM pg_class c
   JOIN pg_namespace n ON n.oid = c.relnamespace
-  WHERE n.nspname = $1 AND c.relname = $2 AND c.relkind IN ${RELATION_KINDS}`;
+  WHERE n.nspname = $1 AND c.relname = $2 AND c.relkind IN ${exports.RELATION_KINDS}`;
 const COLUMNS_SQL = `
   SELECT a.attname AS name, format_type(a.atttypid, a.atttypmod) AS native,
     b.typname, format_type(b.oid, NULL) AS "castType", b.typtype, b.typcategory AS category,
     e.typname AS element, a.attnotnull AS "notNull", a.atthasdef AS "hasDefault",
-    a.attgenerated <> '' AS generated, a.attidentity AS identity
+    a.attgenerated <> '' AS generated, a.attidentity AS identity,
+    col_description(a.attrelid, a.attnum) AS comment,
+    CASE WHEN b.typtype = 'e' THEN ARRAY(
+      SELECT l.enumlabel::text FROM pg_enum l WHERE l.enumtypid = b.oid ORDER BY l.enumsortorder
+    ) END AS "enumLabels"
   FROM pg_attribute a
   JOIN pg_type t ON t.oid = a.atttypid
   JOIN pg_type b ON b.oid = CASE WHEN t.typtype = 'd' THEN t.typbasetype ELSE t.oid END
@@ -58,6 +66,12 @@ function ServingIndexes(indexes) {
         .filter((index) => index.btree && index.total)
         .map((index) => index.columns);
 }
+async function ReadColumns(oid) {
+    return (await (0, connection_1.Query)(COLUMNS_SQL, [oid])).rows;
+}
+async function ReadIndexes(oid) {
+    return (await (0, connection_1.Query)(INDEXES_SQL, [oid])).rows;
+}
 async function ReadRelation(schemaName, relationName) {
     const found = await (0, connection_1.Query)(RELATION_SQL, [
         schemaName,
@@ -67,16 +81,16 @@ async function ReadRelation(schemaName, relationName) {
         return undefined;
     }
     const relation = found.rows[0];
-    const columns = await (0, connection_1.Query)(COLUMNS_SQL, [relation.oid]);
-    const indexes = await (0, connection_1.Query)(INDEXES_SQL, [relation.oid]);
-    const key = KeyOf(indexes.rows);
+    const columns = await ReadColumns(relation.oid);
+    const indexes = await ReadIndexes(relation.oid);
+    const key = KeyOf(indexes);
     return {
         kind: relation.kind,
         readable: relation.readable,
-        columns: columns.rows,
+        columns,
         key: key?.columns,
         keyName: key?.name,
-        indexes: ServingIndexes(indexes.rows),
+        indexes: ServingIndexes(indexes),
     };
 }
 //# sourceMappingURL=external-catalog.js.map

package/dist/implementations/database/external-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"external-catalog.js","sourceRoot":"","sources":["../../../src/implementations/database/external-catalog.ts"],"names":[],"mappings":";;AA4HA,oCAuBC;AAnJD,iDAAyC;AAqDzC,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAEnD,MAAM,YAAY,GAAG;;;;6DAIwC,cAAc,EAAE,CAAC;AAE9E,MAAM,WAAW,GAAG;;;;;;;;;;oBAUA,CAAC;AAErB,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;qBAmBC,CAAC;AAGtB,SAAS,cAAc,CAAC,KAAmB;IACzC,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;AACtD,CAAC;AAGD,SAAS,eAAe,CAAC,IAAkB,EAAE,KAAmB;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACzD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAGD,SAAS,KAAK,CAAC,OAAuB;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,OAAuB;IAC7C,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;SAC7C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAMM,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,YAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAK,EAAc,YAAY,EAAE;QACnD,UAAU;QACV,YAAY;KACb,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAK,EAAgB,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAK,EAAe,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,GAAG,EAAE,GAAG,EAAE,OAAO;QACjB,OAAO,EAAE,GAAG,EAAE,IAAI;QAClB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;KACtC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"external-catalog.js","sourceRoot":"","sources":["../../../src/implementations/database/external-catalog.ts"],"names":[],"mappings":";;;AAiHA,sBAMC;AAYD,kCAEC;AAED,kCAEC;AAED,oCAuBC;AAlKD,iDAAyC;AAwD5B,QAAA,cAAc,GAAG,2BAA2B,CAAC;AAE1D,MAAM,YAAY,GAAG;;;;6DAIwC,sBAAc,EAAE,CAAC;AAE9E,MAAM,WAAW,GAAG;;;;;;;;;;;;;;oBAcA,CAAC;AAErB,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;qBAmBC,CAAC;AAGtB,SAAS,cAAc,CAAC,KAAmB;IACzC,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;AACtD,CAAC;AAGD,SAAS,eAAe,CAAC,IAAkB,EAAE,KAAmB;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACzD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAGD,SAAgB,KAAK,CAAC,OAAuB;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,cAAc,CAAC,OAAuB;IAC7C,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;SAC7C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAMM,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,OAAO,CAAC,MAAM,IAAA,kBAAK,EAAgB,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,OAAO,CAAC,MAAM,IAAA,kBAAK,EAAe,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAEM,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,YAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,IAAA,kBAAK,EAAc,YAAY,EAAE;QACnD,UAAU;QACV,YAAY;KACb,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,OAAO;QACP,GAAG,EAAE,GAAG,EAAE,OAAO;QACjB,OAAO,EAAE,GAAG,EAAE,IAAI;QAClB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/implementations/database/external-column-profile.d.ts

@@ -0,0 +1,18 @@
+import type { ColumnProfile } from "@antelopejs/interface-database-catalog";
+import type { CatalogColumn } from "./external-catalog";
+import { type MeasureSession } from "./external-measures";
+import { type Source } from "./external-sample";
+import { type NativeFamily } from "./external-types";
+import type { SqlType } from "./types";
+export interface ProfiledColumn {
+    name: string;
+    family: NativeFamily;
+    kind: SqlType;
+    quoted: string;
+}
+export declare function Profiled(column: CatalogColumn): ProfiledColumn | undefined;
+export interface ColumnRoles {
+    keys: Set<string>;
+    references: Set<string>;
+}
+export declare function ProfileColumn(session: MeasureSession, column: ProfiledColumn, source: Source, rows: number | undefined, roles: ColumnRoles): Promise<ColumnProfile>;

package/dist/implementations/database/external-column-profile.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Profiled = Profiled;
+exports.ProfileColumn = ProfileColumn;
+const external_measures_1 = require("./external-measures");
+const external_sample_1 = require("./external-sample");
+const external_declarations_1 = require("./external-declarations");
+const external_types_1 = require("./external-types");
+const sql_1 = require("./sql");
+const CATEGORY_LIMIT = 25;
+const CATEGORY_MIN_ROWS = 5;
+const ENUM_LIKE_MIN_ROWS = 100;
+const MONTH_LIMIT = 36;
+const LABEL_DISTINCT_SHARE = 0.9;
+const LABEL_MAX_LENGTH = 80;
+const TIME_AXIS_FILLED_SHARE = 0.9;
+const TIME_AXIS_MIN_MONTHS = 3;
+const MONTHS_PER_YEAR = 12;
+const TEXT_FAMILIES = ["text", "citext", "bpchar"];
+const CATEGORY_FAMILIES = [
+    ...TEXT_FAMILIES,
+    "enum",
+    "int",
+    "int8",
+    "bool",
+];
+const RANGED_KINDS = ["float", "timestamp"];
+const DISTINCT_KINDS = [
+    "text",
+    "float",
+    "bool",
+    "timestamp",
+];
+function Profiled(column) {
+    const family = (0, external_types_1.FamilyOf)(column);
+    const [proposed] = (0, external_declarations_1.AcceptedDeclarations)(column);
+    if (!family || !proposed) {
+        return undefined;
+    }
+    return {
+        name: column.name,
+        family,
+        kind: proposed.kind,
+        quoted: `${external_sample_1.SOURCE_ALIAS}.${(0, sql_1.QuoteIdentifier)(column.name)}`,
+    };
+}
+function RangeExpression(column) {
+    if (column.family === "enum") {
+        return `(${column.quoted})`;
+    }
+    if (!RANGED_KINDS.includes(column.kind.kind)) {
+        return undefined;
+    }
+    return column.kind.kind === "timestamp"
+        ? InstantExpression(column)
+        : `(${column.quoted})::float8`;
+}
+const INSTANTS = {
+    timestamptz: (column) => column,
+    timestamp: (column) => `(${column} AT TIME ZONE 'UTC')`,
+    date: (column) => `((${column})::timestamp AT TIME ZONE 'UTC')`,
+};
+function InstantExpression(column) {
+    return (INSTANTS[column.family] ?? ((value) => value))(column.quoted);
+}
+function BaseSql(column, source) {
+    const range = RangeExpression(column);
+    const isText = TEXT_FAMILIES.includes(column.family);
+    const length = `length(${column.quoted})`;
+    return `SELECT (count(*) - count(${column.quoted}))::float8 AS nulls,
+    ${range ? `min(${range})` : "NULL"} AS min, ${range ? `max(${range})` : "NULL"} AS max,
+    ${isText ? `min(${length})` : "NULL"}::float8 AS "minLength",
+    ${isText ? `avg(${length})` : "NULL"}::float8 AS "avgLength",
+    ${isText ? `max(${length})` : "NULL"}::float8 AS "maxLength"
+    FROM ${source.from}`;
+}
+function RangeValue(column, row) {
+    if (row.min === null || row.max === null) {
+        return undefined;
+    }
+    return { min: RangeEnd(row.min), max: RangeEnd(row.max) };
+}
+function RangeEnd(value) {
+    return value instanceof Date ? value.toISOString() : value;
+}
+function LengthValue(row) {
+    if (row.minLength === null ||
+        row.avgLength === null ||
+        row.maxLength === null) {
+        return undefined;
+    }
+    return { min: row.minLength, avg: row.avgLength, max: row.maxLength };
+}
+async function MeasureBase(session, column, source) {
+    const measured = await session.measure(BaseSql(column, source));
+    const base = { nulls: (0, external_measures_1.FirstRow)(measured, (row) => row.nulls) };
+    const row = (0, external_measures_1.ValueOf)(measured)?.[0];
+    if (RangeExpression(column)) {
+        base.range =
+            measured.status === "ok"
+                ? Present(row && RangeValue(column, row))
+                : measured;
+    }
+    if (TEXT_FAMILIES.includes(column.family)) {
+        base.length =
+            measured.status === "ok" ? Present(row && LengthValue(row)) : measured;
+    }
+    return base;
+}
+function Present(value) {
+    return value === undefined
+        ? { status: "error", code: "empty" }
+        : { status: "ok", value };
+}
+async function MeasureDistinct(session, column, source) {
+    if (!DISTINCT_KINDS.includes(column.kind.kind)) {
+        return undefined;
+    }
+    const measured = await session.measure(`SELECT count(DISTINCT ${column.quoted})::float8 AS distinct FROM ${source.from}`);
+    return (0, external_measures_1.FirstRow)(measured, (row) => row.distinct);
+}
+const CATEGORY_VALUES = {
+    int: (column) => `(${column})::float8`,
+    int8: (column) => `(${column})::float8`,
+    bool: (column) => column,
+};
+function CategoryValue(column) {
+    return (CATEGORY_VALUES[column.family] ?? ((value) => `(${value})::text`))(column.quoted);
+}
+function AsCategories(rows) {
+    const named = rows.filter((row) => row.rows >= CATEGORY_MIN_ROWS);
+    const other = rows
+        .filter((row) => row.rows < CATEGORY_MIN_ROWS)
+        .reduce((total, row) => total + row.rows, 0);
+    return {
+        values: named.map(({ value, rows: count }) => ({ value, rows: count })),
+        other,
+    };
+}
+async function MeasureCategories(session, column, source, distinct) {
+    const isCategorical = column.family === "enum" || (distinct ?? Infinity) <= CATEGORY_LIMIT;
+    if (!CATEGORY_FAMILIES.includes(column.family) || !isCategorical) {
+        return undefined;
+    }
+    const measured = await session.measure(`SELECT ${CategoryValue(column)} AS value, count(*)::float8 AS rows FROM ${source.from}
+      WHERE ${column.quoted} IS NOT NULL GROUP BY 1 ORDER BY 2 DESC, 1 LIMIT ${CATEGORY_LIMIT + 1}`);
+    return (0, external_measures_1.Mapped)(measured, AsCategories);
+}
+async function MeasureMonths(session, column, source) {
+    if (column.kind.kind !== "timestamp") {
+        return undefined;
+    }
+    const measured = await session.measure(`SELECT to_char(date_trunc('month', ${InstantExpression(column)} AT TIME ZONE 'UTC'), 'YYYY-MM') AS month,
+      count(*)::float8 AS rows FROM ${source.from}
+      WHERE ${column.quoted} IS NOT NULL GROUP BY 1 ORDER BY 1 DESC LIMIT ${MONTH_LIMIT}`);
+    return (0, external_measures_1.Mapped)(measured, (rows) => rows.reverse());
+}
+function MonthsSpanned(range) {
+    const start = new Date(String(range.min));
+    const end = new Date(String(range.max));
+    return ((end.getUTCFullYear() - start.getUTCFullYear()) * MONTHS_PER_YEAR +
+        end.getUTCMonth() -
+        start.getUTCMonth() +
+        1);
+}
+function Filled(facts) {
+    const nulls = (0, external_measures_1.ValueOf)(facts.profile.nulls);
+    return facts.rows === undefined || nulls === undefined
+        ? undefined
+        : facts.rows - nulls;
+}
+const TRAIT_RULES = {
+    "enum-like": (facts) => facts.column.family === "enum" ||
+        (CATEGORY_FAMILIES.includes(facts.column.family) &&
+            ((0, external_measures_1.ValueOf)(facts.profile.distinct) ?? Infinity) <= CATEGORY_LIMIT &&
+            (facts.rows ?? 0) >= ENUM_LIKE_MIN_ROWS),
+    "identifier-like": (facts) => (facts.rows ?? 0) > 0 &&
+        (0, external_measures_1.ValueOf)(facts.profile.nulls) === 0 &&
+        (0, external_measures_1.ValueOf)(facts.profile.distinct) === facts.rows,
+    "label-candidate": (facts) => {
+        const filled = Filled(facts) ?? 0;
+        const distinct = (0, external_measures_1.ValueOf)(facts.profile.distinct) ?? 0;
+        const length = (0, external_measures_1.ValueOf)(facts.profile.length);
+        return (TEXT_FAMILIES.includes(facts.column.family) &&
+            filled > 0 &&
+            distinct >= LABEL_DISTINCT_SHARE * filled &&
+            length !== undefined &&
+            length.avg <= LABEL_MAX_LENGTH);
+    },
+    "time-axis": (facts) => {
+        const range = (0, external_measures_1.ValueOf)(facts.profile.range);
+        return (facts.column.kind.kind === "timestamp" &&
+            range !== undefined &&
+            (Filled(facts) ?? 0) >=
+                TIME_AXIS_FILLED_SHARE * (facts.rows ?? Infinity) &&
+            MonthsSpanned(range) >= TIME_AXIS_MIN_MONTHS);
+    },
+    measure: (facts) => facts.column.kind.kind === "float" &&
+        !facts.roles.keys.has(facts.column.name) &&
+        !facts.roles.references.has(facts.column.name),
+};
+function TraitsOf(facts) {
+    return Object.keys(TRAIT_RULES).filter((trait) => TRAIT_RULES[trait](facts));
+}
+async function ProfileColumn(session, column, source, rows, roles) {
+    const base = await MeasureBase(session, column, source);
+    const distinct = await MeasureDistinct(session, column, source);
+    const categories = await MeasureCategories(session, column, source, (0, external_measures_1.ValueOf)(distinct));
+    const months = await MeasureMonths(session, column, source);
+    const profile = { name: column.name, ...base, traits: [] };
+    if (distinct) {
+        profile.distinct = distinct;
+    }
+    if (categories) {
+        profile.categories = categories;
+    }
+    if (months) {
+        profile.months = months;
+    }
+    profile.traits = TraitsOf({ column, profile, rows, roles });
+    return profile;
+}
+//# sourceMappingURL=external-column-profile.js.map

package/dist/implementations/database/external-column-profile.js.map

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

package/dist/implementations/database/external-declarations.d.ts

@@ -0,0 +1,9 @@
+import type { CatalogColumn } from "./external-catalog";
+import { type SqlType } from "./types";
+export interface AcceptedDeclaration {
+    declared: string;
+    kind: SqlType;
+    lossy?: string;
+}
+export declare function AcceptedDeclarations(column: CatalogColumn): AcceptedDeclaration[];
+export declare function UnsupportedReason(column: CatalogColumn): string;

package/dist/implementations/database/external-declarations.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcceptedDeclarations = AcceptedDeclarations;
+exports.UnsupportedReason = UnsupportedReason;
+const external_types_1 = require("./external-types");
+const types_1 = require("./types");
+const PROPOSED_KIND = {
+    text: types_1.TEXT,
+    citext: types_1.TEXT,
+    bpchar: types_1.TEXT,
+    uuid: types_1.TEXT,
+    enum: types_1.TEXT,
+    rendered: types_1.TEXT,
+    int: types_1.FLOAT,
+    int8: types_1.FLOAT,
+    numeric: types_1.FLOAT,
+    float4: types_1.FLOAT,
+    float8: types_1.FLOAT,
+    bool: types_1.BOOL,
+    timestamptz: types_1.TIMESTAMP,
+    timestamp: types_1.TIMESTAMP,
+    date: types_1.TIMESTAMP,
+    jsonb: types_1.OPAQUE,
+    json: types_1.OPAQUE,
+};
+const SCALAR_KINDS = [types_1.TEXT, types_1.FLOAT, types_1.BOOL, types_1.TIMESTAMP, types_1.OPAQUE];
+const FIELD_TOKENS = {
+    text: "string",
+    float: "number",
+    bool: "boolean",
+    timestamp: "date",
+    json: "object",
+};
+const ARRAY_SUFFIX = "[]";
+function FieldToken(kind) {
+    return kind.kind === "array"
+        ? `${FieldToken(kind.elem)}${ARRAY_SUFFIX}`
+        : FIELD_TOKENS[kind.kind];
+}
+function ProposedFirst(kinds, proposed) {
+    return [
+        ...kinds.filter((kind) => kind === proposed),
+        ...kinds.filter((kind) => kind !== proposed),
+    ];
+}
+function CandidateKinds(column) {
+    const family = (0, external_types_1.FamilyOf)(column);
+    if (family === "array") {
+        const element = (0, external_types_1.ElementFamily)(column);
+        const proposed = element && element !== "array" ? PROPOSED_KIND[element] : undefined;
+        return ProposedFirst([...SCALAR_KINDS], proposed ?? types_1.TEXT).map(types_1.ArrayOf);
+    }
+    return family ? ProposedFirst([...SCALAR_KINDS], PROPOSED_KIND[family]) : [];
+}
+function AcceptedDeclarations(column) {
+    const family = (0, external_types_1.FamilyOf)(column);
+    return CandidateKinds(column).flatMap((kind) => {
+        const reading = (0, external_types_1.ReadingOf)(kind, family, column);
+        return reading
+            ? [{ declared: FieldToken(kind), kind, lossy: reading.lossy }]
+            : [];
+    });
+}
+function UnsupportedReason(column) {
+    return `no field type reads a ${column.native} column`;
+}
+//# sourceMappingURL=external-declarations.js.map

package/dist/implementations/database/external-declarations.js.map

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

package/dist/implementations/database/external-discovery.d.ts

@@ -0,0 +1,39 @@
+import type { CatalogInfo, EstimateSource, Reference, RelationDescription, RelationKey, RelationSummary } from "@antelopejs/interface-database-catalog";
+import { type CatalogColumn, type CatalogIndex } from "./external-catalog";
+export interface RelationRow {
+    oid: number;
+    schema: string;
+    name: string;
+    kind: string;
+    readable: boolean;
+    someColumns: boolean;
+    insert: boolean;
+    update: boolean;
+    delete: boolean;
+    analyzed: boolean;
+    statistics: number | null;
+    liveTuples: number | null;
+    comment: string | null;
+}
+interface ReferenceRow {
+    name: string;
+    fromRelation: string;
+    fromColumns: string[];
+    toRelation: string;
+    toColumns: string[];
+}
+export declare function RelationName(row: RelationRow): string;
+export declare function ReadInfo(): Promise<CatalogInfo>;
+export declare function ReadRelationRows(schemas?: string[]): Promise<RelationRow[]>;
+export declare function ReadNamedRelationRows(relations: string[]): Promise<RelationRow[]>;
+interface Estimate {
+    estimatedRows: number | null;
+    estimate: EstimateSource | null;
+}
+export declare function EstimateOf(row: RelationRow): Promise<Estimate>;
+export declare function KeyFrom(indexes: CatalogIndex[], columns: CatalogColumn[]): RelationKey | null;
+export declare function Summarize(row: RelationRow): Promise<RelationSummary>;
+export declare function ReferenceOf(row: ReferenceRow): Reference;
+export declare function ReadReferences(oid: number): Promise<ReferenceRow[]>;
+export declare function DescribeRow(row: RelationRow): Promise<RelationDescription>;
+export {};