@memberjunction/external-data-sources 0.0.0 → 5.45.1

package/dist/BaseExternalDataSourceDriver.d.ts

@@ -0,0 +1,34 @@
+import { UserInfo, ExternalSchemaDescriptor } from "@memberjunction/core";
+import { MJExternalDataSourceEntity } from "@memberjunction/core-entities";
+import { ResolvedCredential } from "@memberjunction/credentials";
+import { ExternalConnectionTestResult, ExternalViewParams, ExternalViewResult, ExternalQueryParameter, ExternalQueryResult, ExternalRow } from "./types.js";
+export declare abstract class BaseExternalDataSourceDriver<TConnection = unknown> {
+    abstract TestConnection(dataSource: MJExternalDataSourceEntity, contextUser?: UserInfo): Promise<ExternalConnectionTestResult>;
+    abstract IntrospectSchema(dataSource: MJExternalDataSourceEntity, schemaName: string | undefined, contextUser?: UserInfo): Promise<ExternalSchemaDescriptor>;
+    abstract RunView<TRow extends ExternalRow = ExternalRow>(dataSource: MJExternalDataSourceEntity, params: ExternalViewParams, contextUser?: UserInfo): Promise<ExternalViewResult<TRow>>;
+    abstract LoadSingle<TRow extends ExternalRow = ExternalRow>(dataSource: MJExternalDataSourceEntity, objectName: string, primaryKeys: readonly ExternalQueryParameter[], contextUser?: UserInfo): Promise<TRow | null>;
+    abstract RunNativeQuery<TRow extends ExternalRow = ExternalRow>(dataSource: MJExternalDataSourceEntity, queryText: string, params: ExternalQueryParameter[] | undefined, contextUser?: UserInfo): Promise<ExternalQueryResult<TRow>>;
+    protected abstract getConnection(dataSource: MJExternalDataSourceEntity, contextUser?: UserInfo): Promise<TConnection>;
+    protected resolveCredential<TCred extends Record<string, string> = Record<string, string>>(dataSource: MJExternalDataSourceEntity, contextUser?: UserInfo): Promise<ResolvedCredential<TCred> | null>;
+    protected parseConnectionConfig<TConfig = Record<string, unknown>>(dataSource: MJExternalDataSourceEntity): TConfig;
+    protected assertSecureTransport(opts: {
+        host: string | undefined;
+        tlsEnabled: boolean;
+        allowInsecure: boolean | undefined;
+        dataSourceName: string;
+    }): void;
+    protected isLocalHost(host: string | undefined): boolean;
+    protected errorText(e: unknown): string;
+    protected redactConnectionSecrets(message: string): string;
+    protected normalizeValue(v: unknown): unknown;
+    private deepNormalizeForJson;
+    protected normalizeRows<TRow extends Record<string, unknown>>(rows: TRow[]): TRow[];
+    protected abstract invalidateConnection(dataSourceId: string, expectedIdentity?: unknown): Promise<void>;
+    protected peekConnection(_dataSourceId: string): unknown;
+    CloseConnection(dataSourceId: string): Promise<void>;
+    protected withConnectionRetry<T>(dataSource: MJExternalDataSourceEntity, op: () => Promise<T>): Promise<T>;
+    protected isAuthError(e: unknown): boolean;
+    private static readonly AuthErrorCodes;
+    private extractErrorCode;
+}
+//# sourceMappingURL=BaseExternalDataSourceDriver.d.ts.map

package/dist/BaseExternalDataSourceDriver.d.ts.map

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

package/dist/BaseExternalDataSourceDriver.js

@@ -0,0 +1,181 @@
+import { CredentialEngine } from "@memberjunction/credentials";
+import { redactConnectionSecrets, } from "./types.js";
+export class BaseExternalDataSourceDriver {
+    async resolveCredential(dataSource, contextUser) {
+        if (!dataSource.CredentialID) {
+            return null;
+        }
+        await CredentialEngine.Instance.Config(false, contextUser);
+        return CredentialEngine.Instance.getCredential('', {
+            credentialId: dataSource.CredentialID,
+            contextUser,
+            subsystem: 'ExternalDataSources',
+        });
+    }
+    parseConnectionConfig(dataSource) {
+        if (!dataSource.ConnectionConfig) {
+            return {};
+        }
+        try {
+            return JSON.parse(dataSource.ConnectionConfig);
+        }
+        catch {
+            throw new Error(`ExternalDataSource '${dataSource.Name}' has invalid ConnectionConfig JSON.`);
+        }
+    }
+    assertSecureTransport(opts) {
+        if (opts.tlsEnabled || opts.allowInsecure === true) {
+            return;
+        }
+        if (!this.isLocalHost(opts.host)) {
+            const host = (opts.host ?? '').trim().toLowerCase().replace(/^\[|\]$/g, '');
+            throw new Error(`Refusing to connect to external data source '${opts.dataSourceName}' at '${host || '<unspecified host>'}' over an unencrypted connection. ` +
+                `Enable TLS in ConnectionConfig, or set "allowInsecureTransport": true to explicitly accept a plaintext connection.`);
+        }
+    }
+    isLocalHost(host) {
+        const h = (host ?? '').trim().toLowerCase().replace(/^\[|\]$/g, '');
+        return (h === 'localhost' ||
+            h.endsWith('.localhost') ||
+            h === '::1' ||
+            /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(h));
+    }
+    errorText(e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        return this.redactConnectionSecrets(raw);
+    }
+    redactConnectionSecrets(message) {
+        return redactConnectionSecrets(message);
+    }
+    normalizeValue(v) {
+        if (v === null || v === undefined)
+            return v;
+        if (typeof v === 'bigint')
+            return v.toString();
+        if (v instanceof Date || Buffer.isBuffer(v))
+            return v;
+        if (typeof v === 'object') {
+            const bsonType = v._bsontype;
+            if (bsonType) {
+                switch (bsonType) {
+                    case 'Long':
+                    case 'Decimal128':
+                    case 'ObjectId':
+                    case 'ObjectID':
+                        return v.toString();
+                    case 'Binary': {
+                        const bin = v;
+                        return bin.buffer ?? (typeof bin.value === 'function' ? bin.value(true) : v);
+                    }
+                    case 'Double':
+                    case 'Int32':
+                        return v.valueOf();
+                    default:
+                        return v.toString();
+                }
+            }
+            return JSON.stringify(this.deepNormalizeForJson(v));
+        }
+        return v;
+    }
+    deepNormalizeForJson(v) {
+        if (v === null || v === undefined)
+            return v;
+        if (typeof v === 'bigint')
+            return v.toString();
+        if (v instanceof Date)
+            return v;
+        if (Buffer.isBuffer(v))
+            return v.toString('base64');
+        if (typeof v === 'object') {
+            const bsonType = v._bsontype;
+            if (bsonType) {
+                switch (bsonType) {
+                    case 'Long':
+                    case 'Decimal128':
+                    case 'ObjectId':
+                    case 'ObjectID':
+                        return v.toString();
+                    case 'Binary': {
+                        const bin = v;
+                        const buf = bin.buffer ?? (typeof bin.value === 'function' ? bin.value(true) : undefined);
+                        return Buffer.isBuffer(buf) ? buf.toString('base64') : v.toString();
+                    }
+                    case 'Double':
+                    case 'Int32':
+                        return v.valueOf();
+                    default:
+                        return v.toString();
+                }
+            }
+            if (Array.isArray(v)) {
+                return v.map((x) => this.deepNormalizeForJson(x));
+            }
+            const out = {};
+            for (const k in v) {
+                out[k] = this.deepNormalizeForJson(v[k]);
+            }
+            return out;
+        }
+        return v;
+    }
+    normalizeRows(rows) {
+        for (const row of rows) {
+            for (const k in row) {
+                row[k] = this.normalizeValue(row[k]);
+            }
+        }
+        return rows;
+    }
+    peekConnection(_dataSourceId) {
+        return undefined;
+    }
+    async CloseConnection(dataSourceId) {
+        await this.invalidateConnection(dataSourceId);
+    }
+    async withConnectionRetry(dataSource, op) {
+        const identity = this.peekConnection(dataSource.ID);
+        try {
+            return await op();
+        }
+        catch (e) {
+            if (!this.isAuthError(e)) {
+                throw e;
+            }
+            try {
+                await this.invalidateConnection(dataSource.ID, identity);
+            }
+            catch { }
+            return await op();
+        }
+    }
+    isAuthError(e) {
+        const code = this.extractErrorCode(e);
+        if (code && BaseExternalDataSourceDriver.AuthErrorCodes.has(code)) {
+            return true;
+        }
+        const msg = (e instanceof Error ? e.message : String(e)).toLowerCase();
+        return (msg.includes('authentic') ||
+            msg.includes('authoriz') ||
+            msg.includes('credential') ||
+            msg.includes('login failed') ||
+            msg.includes('access denied') ||
+            msg.includes('28p01') ||
+            msg.includes('28000'));
+    }
+    static { this.AuthErrorCodes = new Set([
+        '28P01', '28000', '1044', '1045', '1698', '4060', '18452', '18456', '18470', '1017', '1031',
+    ]); }
+    extractErrorCode(e) {
+        if (e && typeof e === 'object') {
+            const err = e;
+            for (const c of [err.code, err.errno, err.errorNum, err.number]) {
+                if (c != null && c !== '') {
+                    return String(c).toUpperCase();
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=BaseExternalDataSourceDriver.js.map

package/dist/BaseExternalDataSourceDriver.js.map

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

package/dist/BaseSqlExternalDataSourceDriver.d.ts

@@ -0,0 +1,29 @@
+import { ExternalObjectType, ExternalSchemaRelationship } from "@memberjunction/core";
+import { MJExternalDataSourceEntity } from "@memberjunction/core-entities";
+import { BaseExternalDataSourceDriver } from "./BaseExternalDataSourceDriver.js";
+import { ExternalFkRow, ExternalViewParams, ExternalQueryParameter } from "./types.js";
+import { type SqlDialectKey } from "./sqlReadOnlyScreen.js";
+export declare abstract class BaseSqlExternalDataSourceDriver<TConnection = unknown> extends BaseExternalDataSourceDriver<TConnection> {
+    protected abstract quoteIdent(name: string): string;
+    protected sqlDialectKey(): SqlDialectKey;
+    protected screenReadOnlyNativeQuery(sql: string): void;
+    protected normalizeForReadOnlyParse(sql: string): string;
+    protected buildPrimaryKeyWhere(primaryKeys: readonly ExternalQueryParameter[], placeholder: (index: number) => string): {
+        clause: string;
+        values: Array<ExternalQueryParameter["value"]>;
+    };
+    protected screenReadOnlyClause(clause: string, kind: "where" | "orderby"): void;
+    protected abstract orderAndPageClause(params: ExternalViewParams): string;
+    protected selectTopClause(_params: ExternalViewParams): string;
+    protected quoteLiteral(value: string): string;
+    protected buildIncrementalPredicate(params: ExternalViewParams): string | undefined;
+    protected formatIncrementalLiteral(value: string): string;
+    protected effectiveWhere(params: ExternalViewParams): string | undefined;
+    protected buildCountSql(target: string, params: ExternalViewParams): string;
+    protected buildSelectSql(target: string, params: ExternalViewParams): string;
+    protected applyDefaultOrderBy(params: ExternalViewParams): ExternalViewParams;
+    protected mapObjectType(objectType: string): ExternalObjectType;
+    protected qualifyObject(dataSource: MJExternalDataSourceEntity, objectName: string): string;
+    protected groupForeignKeys(fkRows: ExternalFkRow[]): Map<string, ExternalSchemaRelationship[]>;
+}
+//# sourceMappingURL=BaseSqlExternalDataSourceDriver.d.ts.map

package/dist/BaseSqlExternalDataSourceDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSqlExternalDataSourceDriver.d.ts","sourceRoot":"","sources":["../src/BaseSqlExternalDataSourceDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAmD,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiB1G,8BAAsB,+BAA+B,CAAC,WAAW,GAAG,OAAO,CAAE,SAAQ,4BAA4B,CAAC,WAAW,CAAC;IAE5H,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQnD,SAAS,CAAC,aAAa,IAAI,aAAa;IAWxC,SAAS,CAAC,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAYtD,SAAS,CAAC,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAWxD,SAAS,CAAC,oBAAoB,CAC5B,WAAW,EAAE,SAAS,sBAAsB,EAAE,EAC9C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE;IAoBrE,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAQ/E,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAMzE,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAK9D,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAU7C,SAAS,CAAC,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS;IAanF,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUzD,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS;IAmBxE,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAa3E,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAyB5E,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB;IAS7E,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB;IAK/D,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAe3F,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE,CAAC;CAoB/F"}

package/dist/BaseSqlExternalDataSourceDriver.js

@@ -0,0 +1,112 @@
+import { BaseExternalDataSourceDriver } from "./BaseExternalDataSourceDriver.js";
+import { assertReadOnlyNativeQuery, assertReadOnlyClause } from "./sqlReadOnlyScreen.js";
+export class BaseSqlExternalDataSourceDriver extends BaseExternalDataSourceDriver {
+    sqlDialectKey() {
+        return 'ansi';
+    }
+    screenReadOnlyNativeQuery(sql) {
+        assertReadOnlyNativeQuery(this.normalizeForReadOnlyParse(sql), this.sqlDialectKey());
+    }
+    normalizeForReadOnlyParse(sql) {
+        return sql;
+    }
+    buildPrimaryKeyWhere(primaryKeys, placeholder) {
+        if (primaryKeys.length === 0) {
+            throw new Error("buildPrimaryKeyWhere requires at least one primary-key value.");
+        }
+        const parts = [];
+        const values = [];
+        primaryKeys.forEach((pk, i) => {
+            parts.push(`${this.quoteIdent(pk.name)} = ${placeholder(i)}`);
+            values.push(pk.value);
+        });
+        return { clause: parts.join(" AND "), values };
+    }
+    screenReadOnlyClause(clause, kind) {
+        assertReadOnlyClause(clause, this.sqlDialectKey(), kind);
+    }
+    selectTopClause(_params) {
+        return '';
+    }
+    quoteLiteral(value) {
+        return `'${value.replace(/'/g, "''")}'`;
+    }
+    buildIncrementalPredicate(params) {
+        if (!params.incrementalSince) {
+            return undefined;
+        }
+        return `${this.quoteIdent(params.incrementalSince.Field)} >= ${this.formatIncrementalLiteral(params.incrementalSince.Value)}`;
+    }
+    formatIncrementalLiteral(value) {
+        return this.quoteLiteral(value);
+    }
+    effectiveWhere(params) {
+        const incremental = this.buildIncrementalPredicate(params);
+        const filter = params.filter && params.filter.trim().length > 0 ? params.filter : undefined;
+        if (filter && incremental) {
+            return `(${filter}) AND ${incremental}`;
+        }
+        return filter ?? incremental;
+    }
+    buildCountSql(target, params) {
+        const where = this.effectiveWhere(params);
+        return `SELECT COUNT(*) AS cnt FROM ${target}${where ? ` WHERE ${where}` : ''}`;
+    }
+    buildSelectSql(target, params) {
+        if (params.filter && params.filter.trim().length > 0) {
+            this.screenReadOnlyClause(params.filter, 'where');
+        }
+        if (params.orderBy) {
+            this.screenReadOnlyClause(params.orderBy, 'orderby');
+        }
+        const projection = params.fields?.length ? params.fields.map((f) => this.quoteIdent(f)).join(', ') : '*';
+        const effectiveParams = this.applyDefaultOrderBy(params);
+        const where = this.effectiveWhere(params);
+        let sql = `SELECT ${this.selectTopClause(effectiveParams)}${projection} FROM ${target}`;
+        if (where) {
+            sql += ` WHERE ${where}`;
+        }
+        sql += this.orderAndPageClause(effectiveParams);
+        return sql;
+    }
+    applyDefaultOrderBy(params) {
+        if (params.orderBy || !params.defaultOrderByColumns?.length) {
+            return params;
+        }
+        const quoted = params.defaultOrderByColumns.map((c) => this.quoteIdent(c)).join(', ');
+        return { ...params, orderBy: quoted };
+    }
+    mapObjectType(objectType) {
+        return objectType.toUpperCase() === 'VIEW' ? 'view' : 'table';
+    }
+    qualifyObject(dataSource, objectName) {
+        if (objectName.includes('.')) {
+            return objectName.split('.').map((p) => this.quoteIdent(p)).join('.');
+        }
+        if (dataSource.DefaultSchema) {
+            return `${this.quoteIdent(dataSource.DefaultSchema)}.${this.quoteIdent(objectName)}`;
+        }
+        return this.quoteIdent(objectName);
+    }
+    groupForeignKeys(fkRows) {
+        const byTable = new Map();
+        for (const r of fkRows) {
+            const constraints = byTable.get(r.table_name) ?? new Map();
+            const rel = constraints.get(r.constraint_name) ?? {
+                Name: r.constraint_name,
+                ReferencedObject: r.referenced_table,
+                ReferencedSchema: r.referenced_schema,
+                Columns: [],
+            };
+            rel.Columns.push({ Column: r.column_name, ReferencedColumn: r.referenced_column });
+            constraints.set(r.constraint_name, rel);
+            byTable.set(r.table_name, constraints);
+        }
+        const out = new Map();
+        for (const [table, constraints] of byTable) {
+            out.set(table, Array.from(constraints.values()));
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=BaseSqlExternalDataSourceDriver.js.map

package/dist/BaseSqlExternalDataSourceDriver.js.map

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

package/dist/ExternalDataSourceReadRouterImpl.d.ts

@@ -0,0 +1,14 @@
+import { CompositeKey, EntityInfo, ExternalDataSourceReadRouter, ExternalSchemaDescriptor, IMetadataProvider, RunQueryParams, RunQueryResult, RunViewParams, RunViewResult, UserInfo } from "@memberjunction/core";
+export declare class ExternalDataSourceReadRouterImpl extends ExternalDataSourceReadRouter {
+    RunViewExternal<T = unknown>(entity: EntityInfo, params: RunViewParams, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<RunViewResult<T>>;
+    LoadExternalRecord<T = unknown>(entity: EntityInfo, compositeKey: CompositeKey, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<RunViewResult<T>>;
+    RunQueryExternal(externalDataSourceID: string, queryID: string, queryName: string, sql: string, _params: RunQueryParams, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<RunQueryResult>;
+    GetCacheTTLSeconds(externalDataSourceID: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<number>;
+    IntrospectExternalSchema(externalDataSourceID: string, schemaName?: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<ExternalSchemaDescriptor>;
+    private resolveMaxRows;
+    private perSourceMaxRowLimit;
+    private failView;
+    private failQuery;
+    private errorText;
+}
+//# sourceMappingURL=ExternalDataSourceReadRouterImpl.d.ts.map

package/dist/ExternalDataSourceReadRouterImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalDataSourceReadRouterImpl.d.ts","sourceRoot":"","sources":["../src/ExternalDataSourceReadRouterImpl.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAoC9B,qBACa,gCAAiC,SAAQ,4BAA4B;IACnE,eAAe,CAAC,CAAC,GAAG,OAAO,EACtC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,aAAa,EACrB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA4Df,kBAAkB,CAAC,CAAC,GAAG,OAAO,EACzC,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,YAAY,EAC1B,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAkCf,gBAAgB,CAC3B,oBAAoB,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,EACvB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,cAAc,CAAC;IAwBb,kBAAkB,CAC7B,oBAAoB,EAAE,MAAM,EAC5B,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,CAAC;IAaL,wBAAwB,CACnC,oBAAoB,EAAE,MAAM,EAC5B,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,wBAAwB,CAAC;IAWpC,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;CAKlB"}

package/dist/ExternalDataSourceReadRouterImpl.js

@@ -0,0 +1,163 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from "@memberjunction/global";
+import { ExternalDataSourceReadRouter, } from "@memberjunction/core";
+import { ExternalDataSourceRouter } from "./ExternalDataSourceRouter.js";
+import { redactConnectionSecrets } from "./types.js";
+const DEFAULT_EXTERNAL_CACHE_TTL_SECONDS = 300;
+const DEFAULT_EXTERNAL_MAX_ROWS = 1000;
+const HARD_MAX_EXTERNAL_ROWS = 50_000;
+let ExternalDataSourceReadRouterImpl = class ExternalDataSourceReadRouterImpl extends ExternalDataSourceReadRouter {
+    async RunViewExternal(entity, params, contextUser, provider) {
+        const start = Date.now();
+        try {
+            const { driver, dataSource } = await ExternalDataSourceRouter.Instance.Resolve(entity.ExternalDataSourceID, contextUser, provider);
+            const offset = params.StartRow && params.StartRow > 0 ? params.StartRow : undefined;
+            const orderBy = params.OrderBy || undefined;
+            let defaultOrderByColumns;
+            if (!orderBy && offset != null) {
+                if (entity.PrimaryKeys.length > 0) {
+                    defaultOrderByColumns = entity.PrimaryKeys.map((pk) => pk.Name);
+                }
+                else {
+                    return this.failView(`External entity '${entity.Name}' has no primary key; offset pagination requires an explicit OrderBy for stable pages.`, Date.now() - start);
+                }
+            }
+            const viewParams = {
+                objectName: entity.ExternalObjectName || entity.BaseTable || entity.Name,
+                fields: params.Fields && params.Fields.length ? params.Fields : undefined,
+                filter: params.ExtraFilter || undefined,
+                orderBy,
+                defaultOrderByColumns,
+                maxRows: this.resolveMaxRows(params, entity, dataSource),
+                offset,
+            };
+            const res = await driver.RunView(dataSource, viewParams, contextUser);
+            if (!res.success) {
+                return this.failView(res.errorMessage ?? 'External RunView failed', Date.now() - start);
+            }
+            return {
+                Success: true,
+                Results: res.rows,
+                RowCount: res.rows.length,
+                TotalRowCount: res.totalRowCount ?? res.rows.length,
+                ExecutionTime: res.executionTimeMs,
+                ErrorMessage: '',
+            };
+        }
+        catch (e) {
+            return this.failView(this.errorText(e), Date.now() - start);
+        }
+    }
+    async LoadExternalRecord(entity, compositeKey, contextUser, provider) {
+        const start = Date.now();
+        try {
+            const { driver, dataSource } = await ExternalDataSourceRouter.Instance.Resolve(entity.ExternalDataSourceID, contextUser, provider);
+            const primaryKeys = compositeKey.KeyValuePairs.map((kv) => ({
+                name: kv.FieldName,
+                value: kv.Value,
+            }));
+            if (primaryKeys.length === 0) {
+                return this.failView(`Cannot load external record for '${entity.Name}': no primary key values were supplied.`, Date.now() - start);
+            }
+            const objectName = entity.ExternalObjectName || entity.BaseTable || entity.Name;
+            const row = await driver.LoadSingle(dataSource, objectName, primaryKeys, contextUser);
+            return {
+                Success: true,
+                Results: (row ? [row] : []),
+                RowCount: row ? 1 : 0,
+                TotalRowCount: row ? 1 : 0,
+                ExecutionTime: Date.now() - start,
+                ErrorMessage: '',
+            };
+        }
+        catch (e) {
+            return this.failView(this.errorText(e), Date.now() - start);
+        }
+    }
+    async RunQueryExternal(externalDataSourceID, queryID, queryName, sql, _params, contextUser, provider) {
+        const start = Date.now();
+        try {
+            const { driver, dataSource } = await ExternalDataSourceRouter.Instance.Resolve(externalDataSourceID, contextUser, provider);
+            const res = await driver.RunNativeQuery(dataSource, sql, undefined, contextUser);
+            if (!res.success) {
+                return this.failQuery(queryID, queryName, res.errorMessage ?? 'External query failed', Date.now() - start);
+            }
+            return {
+                Success: true,
+                QueryID: queryID,
+                QueryName: queryName,
+                Results: res.rows,
+                RowCount: res.rows.length,
+                TotalRowCount: res.rowCount,
+                ExecutionTime: res.executionTimeMs,
+                ErrorMessage: '',
+            };
+        }
+        catch (e) {
+            return this.failQuery(queryID, queryName, this.errorText(e), Date.now() - start);
+        }
+    }
+    async GetCacheTTLSeconds(externalDataSourceID, contextUser, provider) {
+        try {
+            const { dataSource } = await ExternalDataSourceRouter.Instance.Resolve(externalDataSourceID, contextUser, provider);
+            const ttl = dataSource.DefaultCacheTTLSeconds;
+            return typeof ttl === 'number' ? ttl : DEFAULT_EXTERNAL_CACHE_TTL_SECONDS;
+        }
+        catch {
+            return DEFAULT_EXTERNAL_CACHE_TTL_SECONDS;
+        }
+    }
+    async IntrospectExternalSchema(externalDataSourceID, schemaName, contextUser, provider) {
+        const { driver, dataSource } = await ExternalDataSourceRouter.Instance.Resolve(externalDataSourceID, contextUser, provider);
+        return driver.IntrospectSchema(dataSource, schemaName, contextUser);
+    }
+    resolveMaxRows(params, entity, dataSource) {
+        const requested = params.MaxRows && params.MaxRows > 0
+            ? params.MaxRows
+            : entity.UserViewMaxRows && entity.UserViewMaxRows > 0
+                ? entity.UserViewMaxRows
+                : DEFAULT_EXTERNAL_MAX_ROWS;
+        const ceiling = this.perSourceMaxRowLimit(dataSource) ?? HARD_MAX_EXTERNAL_ROWS;
+        return Math.min(requested, ceiling);
+    }
+    perSourceMaxRowLimit(dataSource) {
+        if (!dataSource.ConnectionConfig) {
+            return undefined;
+        }
+        try {
+            const cfg = JSON.parse(dataSource.ConnectionConfig);
+            return typeof cfg.maxRowLimit === 'number' && cfg.maxRowLimit > 0 ? cfg.maxRowLimit : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    failView(errorMessage, executionTime) {
+        return { Success: false, Results: [], RowCount: 0, TotalRowCount: 0, ExecutionTime: executionTime, ErrorMessage: errorMessage };
+    }
+    failQuery(queryID, queryName, errorMessage, executionTime) {
+        return {
+            Success: false,
+            QueryID: queryID,
+            QueryName: queryName,
+            Results: [],
+            RowCount: 0,
+            TotalRowCount: 0,
+            ExecutionTime: executionTime,
+            ErrorMessage: errorMessage,
+        };
+    }
+    errorText(e) {
+        return redactConnectionSecrets(e instanceof Error ? e.message : String(e));
+    }
+};
+ExternalDataSourceReadRouterImpl = __decorate([
+    RegisterClass(ExternalDataSourceReadRouter, 'ExternalDataSourceReadRouter')
+], ExternalDataSourceReadRouterImpl);
+export { ExternalDataSourceReadRouterImpl };
+//# sourceMappingURL=ExternalDataSourceReadRouterImpl.js.map

package/dist/ExternalDataSourceReadRouterImpl.js.map

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

package/dist/ExternalDataSourceRouter.d.ts

@@ -0,0 +1,22 @@
+import { BaseSingleton } from "@memberjunction/global";
+import { BaseEntityEvent, IMetadataProvider, UserInfo } from "@memberjunction/core";
+import { MJExternalDataSourceEntity, MJExternalDataSourceTypeEntity } from "@memberjunction/core-entities";
+import { BaseExternalDataSourceDriver } from "./BaseExternalDataSourceDriver.js";
+export interface ResolvedExternalDataSource {
+    dataSource: MJExternalDataSourceEntity;
+    dataSourceType: MJExternalDataSourceTypeEntity;
+    driver: BaseExternalDataSourceDriver;
+}
+export declare class ExternalDataSourceRouter extends BaseSingleton<ExternalDataSourceRouter> {
+    private driverCache;
+    private cacheInvalidationSubscribed;
+    protected constructor();
+    static get Instance(): ExternalDataSourceRouter;
+    Resolve(dataSourceId: string, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<ResolvedExternalDataSource>;
+    private createResolved;
+    private ensureCacheInvalidationSubscription;
+    protected handleEntityChange(event: BaseEntityEvent): Promise<void>;
+    ClearCache(dataSourceId?: string): Promise<void>;
+    private evictAndClose;
+}
+//# sourceMappingURL=ExternalDataSourceRouter.d.ts.map

package/dist/ExternalDataSourceRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalDataSourceRouter.d.ts","sourceRoot":"","sources":["../src/ExternalDataSourceRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAc,eAAe,EAAE,iBAAiB,EAAsB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC3G,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAO9E,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,0BAA0B,CAAC;IACvC,cAAc,EAAE,8BAA8B,CAAC;IAC/C,MAAM,EAAE,4BAA4B,CAAC;CACtC;AAeD,qBAAa,wBAAyB,SAAQ,aAAa,CAAC,wBAAwB,CAAC;IAKnF,OAAO,CAAC,WAAW,CAA0D;IAG7E,OAAO,CAAC,2BAA2B,CAAS;IAE5C,SAAS;IAIT,WAAkB,QAAQ,IAAI,wBAAwB,CAErD;IAOY,OAAO,CAClB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,0BAA0B,CAAC;YAkBxB,cAAc;IAyD5B,OAAO,CAAC,mCAAmC;cAkB3B,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5D,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAS/C,aAAa;CAa5B"}

package/dist/ExternalDataSourceRouter.js

@@ -0,0 +1,103 @@
+import { BaseSingleton, MJEventType, MJGlobal } from "@memberjunction/global";
+import { BaseEntity, LogError, Metadata } from "@memberjunction/core";
+import { BaseExternalDataSourceDriver } from "./BaseExternalDataSourceDriver.js";
+const EXTERNAL_DATA_SOURCE_ENTITY = 'mj: external data sources';
+const EXTERNAL_DATA_SOURCE_TYPE_ENTITY = 'mj: external data source types';
+export class ExternalDataSourceRouter extends BaseSingleton {
+    constructor() {
+        super();
+        this.driverCache = new Map();
+        this.cacheInvalidationSubscribed = false;
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    async Resolve(dataSourceId, contextUser, provider) {
+        this.ensureCacheInvalidationSubscription();
+        const existing = this.driverCache.get(dataSourceId);
+        if (existing) {
+            return existing;
+        }
+        const creating = this.createResolved(dataSourceId, contextUser, provider);
+        this.driverCache.set(dataSourceId, creating);
+        creating.catch(() => {
+            if (this.driverCache.get(dataSourceId) === creating) {
+                this.driverCache.delete(dataSourceId);
+            }
+        });
+        return creating;
+    }
+    async createResolved(dataSourceId, contextUser, provider) {
+        const md = provider ?? Metadata.Provider;
+        if (!md) {
+            throw new Error('No metadata provider available to resolve external data source.');
+        }
+        const dataSource = await md.GetEntityObject('MJ: External Data Sources', contextUser);
+        if (!(await dataSource.Load(dataSourceId))) {
+            throw new Error(`External data source '${dataSourceId}' not found.`);
+        }
+        if (dataSource.Status !== 'Active') {
+            throw new Error(`External data source '${dataSource.Name}' is ${dataSource.Status}; reads are disabled.`);
+        }
+        const dataSourceType = await md.GetEntityObject('MJ: External Data Source Types', contextUser);
+        if (!(await dataSourceType.Load(dataSource.TypeID))) {
+            throw new Error(`External data source type '${dataSource.TypeID}' (for '${dataSource.Name}') not found.`);
+        }
+        const cf = MJGlobal.Instance.ClassFactory;
+        if (!cf.GetRegistration(BaseExternalDataSourceDriver, dataSourceType.DriverClass)) {
+            throw new Error(`No external data source driver registered for DriverClass '${dataSourceType.DriverClass}' ` +
+                `(data source '${dataSource.Name}'). Ensure the driver package is installed and its @RegisterClass key matches.`);
+        }
+        const driver = cf.CreateInstance(BaseExternalDataSourceDriver, dataSourceType.DriverClass);
+        return { dataSource, dataSourceType, driver };
+    }
+    ensureCacheInvalidationSubscription() {
+        if (this.cacheInvalidationSubscribed) {
+            return;
+        }
+        this.cacheInvalidationSubscribed = true;
+        MJGlobal.Instance.GetEventListener(false).subscribe((event) => {
+            if (event.event === MJEventType.ComponentEvent && event.eventCode === BaseEntity.BaseEventCode) {
+                this.handleEntityChange(event.args).catch((e) => LogError(e));
+            }
+        });
+    }
+    async handleEntityChange(event) {
+        if (!event) {
+            return;
+        }
+        const entityName = (event.baseEntity?.EntityInfo?.Name ?? event.entityName ?? '').toLowerCase().trim();
+        if (entityName === EXTERNAL_DATA_SOURCE_TYPE_ENTITY) {
+            await this.ClearCache();
+            return;
+        }
+        if (entityName === EXTERNAL_DATA_SOURCE_ENTITY) {
+            const id = event.type !== 'remote-invalidate'
+                ? event.baseEntity?.ID
+                : undefined;
+            await (id ? this.ClearCache(id) : this.ClearCache());
+        }
+    }
+    async ClearCache(dataSourceId) {
+        if (dataSourceId) {
+            await this.evictAndClose(dataSourceId);
+        }
+        else {
+            await Promise.all(Array.from(this.driverCache.keys()).map((id) => this.evictAndClose(id)));
+        }
+    }
+    async evictAndClose(dataSourceId) {
+        const entry = this.driverCache.get(dataSourceId);
+        this.driverCache.delete(dataSourceId);
+        if (!entry) {
+            return;
+        }
+        try {
+            const { driver } = await entry;
+            await driver.CloseConnection(dataSourceId);
+        }
+        catch {
+        }
+    }
+}
+//# sourceMappingURL=ExternalDataSourceRouter.js.map

package/dist/ExternalDataSourceRouter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./temporal.js";
+export * from "./sqlReadOnlyScreen.js";
+export * from "./BaseExternalDataSourceDriver.js";
+export * from "./BaseSqlExternalDataSourceDriver.js";
+export * from "./ExternalDataSourceRouter.js";
+export * from "./ExternalDataSourceReadRouterImpl.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAG3C,cAAc,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./temporal.js";
+export * from "./sqlReadOnlyScreen.js";
+export * from "./BaseExternalDataSourceDriver.js";
+export * from "./BaseSqlExternalDataSourceDriver.js";
+export * from "./ExternalDataSourceRouter.js";
+export * from "./ExternalDataSourceReadRouterImpl.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAG3C,cAAc,oCAAoC,CAAC"}

package/dist/sqlReadOnlyScreen.d.ts

@@ -0,0 +1,4 @@
+export type SqlDialectKey = "sqlserver" | "ansi";
+export declare function assertReadOnlyNativeQuery(sql: string, dialectKey: SqlDialectKey): void;
+export declare function assertReadOnlyClause(clause: string, dialectKey: SqlDialectKey, kind: "where" | "orderby"): void;
+//# sourceMappingURL=sqlReadOnlyScreen.d.ts.map

package/dist/sqlReadOnlyScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlReadOnlyScreen.d.ts","sourceRoot":"","sources":["../src/sqlReadOnlyScreen.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AA6EjD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAqDtF;AAmBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CA6B/G"}

package/dist/sqlReadOnlyScreen.js

@@ -0,0 +1,75 @@
+import { SQLParser } from "@memberjunction/sql-parser";
+import { SQLServerDialect, PostgreSQLDialect } from "@memberjunction/sql-dialect";
+function dialectFor(key) {
+    return key === "sqlserver" ? new SQLServerDialect() : new PostgreSQLDialect();
+}
+const WRITE_NODE_TYPES = new Set([
+    "insert", "update", "delete", "merge", "replace", "drop", "create", "alter", "truncate",
+    "rename", "call", "exec", "execute", "grant", "revoke", "use", "load", "copy", "do",
+]);
+function astContainsWriteNode(node) {
+    if (!node || typeof node !== "object") {
+        return false;
+    }
+    if (Array.isArray(node)) {
+        return node.some(astContainsWriteNode);
+    }
+    const obj = node;
+    const type = obj.type;
+    if (typeof type === "string" && WRITE_NODE_TYPES.has(type.toLowerCase())) {
+        return true;
+    }
+    return Object.values(obj).some(astContainsWriteNode);
+}
+function isSingleTypedStatement(ast) {
+    const statements = Array.isArray(ast) ? ast : [ast];
+    if (statements.length !== 1) {
+        return false;
+    }
+    const stmt = statements[0];
+    return !!stmt && typeof stmt === "object" && typeof stmt.type === "string";
+}
+export function assertReadOnlyNativeQuery(sql, dialectKey) {
+    const dialect = dialectFor(dialectKey);
+    if (SQLParser.HasStackedStatements(sql, dialect)) {
+        throw new Error("External native query rejected: multiple statements are not allowed against a read-only external data source.");
+    }
+    const leadingTrimmed = sql.replace(/^(?:\s+|--[^\n]*\n?|\/\*[\s\S]*?\*\/)+/, "");
+    if (/^(grant|revoke|deny)\b/i.test(leadingTrimmed)) {
+        throw new Error("External native query rejected: permission (GRANT/REVOKE/DENY) statements are not permitted — External Data Sources are read-only.");
+    }
+    const parser = new SQLParser(sql, dialect);
+    if (!parser.IsValid) {
+        throw new Error("External native query rejected: SQL could not be parsed/validated as read-only — refusing under uncertainty (External Data Sources are read-only).");
+    }
+    if (parser.HasWriteStatement) {
+        throw new Error("External native query rejected: write/DDL statements are not permitted — External Data Sources are read-only.");
+    }
+    if (parser.StatementKind === "select-into") {
+        throw new Error("External native query rejected: SELECT ... INTO creates a table — External Data Sources are read-only.");
+    }
+    const ast = parser.AST;
+    if (astContainsWriteNode(ast)) {
+        throw new Error("External native query rejected: a write/DDL statement nested in a CTE or subquery is not permitted — External Data Sources are read-only.");
+    }
+    if (!isSingleTypedStatement(ast)) {
+        throw new Error("External native query rejected: only a single, well-formed read statement is allowed — refusing under uncertainty (External Data Sources are read-only).");
+    }
+}
+export function assertReadOnlyClause(clause, dialectKey, kind) {
+    if (/--|\/\*|\*\//.test(clause)) {
+        throw new Error(`External ${kind} clause rejected: SQL comment markers are not allowed.`);
+    }
+    if (/;/.test(clause)) {
+        throw new Error(`External ${kind} clause rejected: statement separators are not allowed.`);
+    }
+    const wrapped = kind === "where"
+        ? `SELECT 1 FROM __mj_clause_screen WHERE (${clause})`
+        : `SELECT 1 FROM __mj_clause_screen ORDER BY ${clause}`;
+    const dialect = dialectFor(dialectKey);
+    const parser = new SQLParser(wrapped, dialect);
+    if (!parser.IsValid || parser.HasWriteStatement || parser.StatementKind !== "select") {
+        throw new Error(`External ${kind} clause rejected: not a safe read-only ${kind} fragment — refusing under uncertainty.`);
+    }
+}
+//# sourceMappingURL=sqlReadOnlyScreen.js.map

package/dist/sqlReadOnlyScreen.js.map

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

package/dist/temporal.d.ts

@@ -0,0 +1,5 @@
+export declare const ISO_8601_DATETIME_RE: RegExp;
+export declare function isIso8601DateTime(value: string): boolean;
+export declare function iso8601Zone(value: string): string | null;
+export declare function parseIso8601AsUtc(value: string): Date | null;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,oBAAoB,QAA2E,CAAC;AAG7G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAQD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAO5D"}

package/dist/temporal.js

@@ -0,0 +1,17 @@
+export const ISO_8601_DATETIME_RE = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})(\.\d+)?(Z|[+-]\d{2}:?\d{2})?$/;
+export function isIso8601DateTime(value) {
+    return ISO_8601_DATETIME_RE.test(value);
+}
+export function iso8601Zone(value) {
+    const m = ISO_8601_DATETIME_RE.exec(value);
+    return m ? (m[4] ?? null) : null;
+}
+export function parseIso8601AsUtc(value) {
+    if (!isIso8601DateTime(value)) {
+        return null;
+    }
+    const normalized = iso8601Zone(value) ? value : `${value}Z`;
+    const d = new Date(normalized);
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+//# sourceMappingURL=temporal.js.map

package/dist/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../src/temporal.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,oBAAoB,GAAG,wEAAwE,CAAC;AAG7G,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAGD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAQD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;IAC5D,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+export type ExternalRow = Record<string, unknown>;
+export interface ExternalConnectionTestResult {
+    success: boolean;
+    message: string;
+    testedAt: Date;
+    latencyMs?: number;
+}
+export interface ExternalViewParams {
+    objectName: string;
+    fields?: string[];
+    filter?: string;
+    orderBy?: string;
+    defaultOrderByColumns?: readonly string[];
+    maxRows?: number;
+    offset?: number;
+    incrementalSince?: {
+        Field: string;
+        Value: string;
+    };
+}
+export interface ExternalViewResult<TRow extends ExternalRow = ExternalRow> {
+    success: boolean;
+    rows: TRow[];
+    totalRowCount?: number;
+    errorMessage?: string;
+    executionTimeMs: number;
+}
+export interface ExternalFkRow {
+    constraint_name: string;
+    table_name: string;
+    column_name: string;
+    referenced_table: string;
+    referenced_schema: string;
+    referenced_column: string;
+}
+export interface ExternalQueryParameter {
+    name: string;
+    value: string | number | boolean | Date | null;
+}
+export interface ExternalQueryResult<TRow extends ExternalRow = ExternalRow> {
+    success: boolean;
+    rows: TRow[];
+    rowCount: number;
+    errorMessage?: string;
+    executionTimeMs: number;
+}
+export declare function redactConnectionSecrets(message: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGlD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,CAAC;IAEf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAQD,MAAM,WAAW,kBAAkB;IAEjC,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAGD,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,WAAW,GAAG,WAAW;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,EAAE,CAAC;IAEb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAQD,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;CAChD;AAGD,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,WAAW,GAAG,WAAW;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AASD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/types.js

@@ -0,0 +1,4 @@
+export function redactConnectionSecrets(message) {
+    return message.replace(/([a-z][a-z0-9+.-]*:\/\/)[^@/\s]+@/gi, '$1***@');
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6GA,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,qCAAqC,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/package.json

@@ -1,10 +1,36 @@
 {
   "name": "@memberjunction/external-data-sources",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @memberjunction/external-data-sources",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "version": "5.45.1",
+  "description": "MemberJunction: External Data Sources — live, runtime-proxied read access to remote data systems (Snowflake, Oracle, MongoDB, external SQL Server / PostgreSQL / MySQL) via pluggable @RegisterClass drivers.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "dependencies": {
+    "@memberjunction/core": "5.45.1",
+    "@memberjunction/global": "5.45.1",
+    "@memberjunction/core-entities": "5.45.1",
+    "@memberjunction/credentials": "5.45.1",
+    "@memberjunction/sql-parser": "5.45.1",
+    "@memberjunction/sql-dialect": "5.45.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "tsc-alias": "^1.8.16",
+    "ts-node-dev": "^2.0.0",
+    "vitest": "^3.1.1",
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }

package/README.md

@@ -1,45 +0,0 @@
-# @memberjunction/external-data-sources
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/external-data-sources`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**