@loaders.gl/sql 5.0.0-beta.5 → 5.0.0-beta.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -74,6 +74,26 @@ export class SQLDataSource extends DataSource {
74
74
  const adapter = await this.getAdapter();
75
75
  return await adapter.listTables(options);
76
76
  }
77
+ /** Lists stable native table identifiers without fetching any column schemas or data rows. */
78
+ async getTablesMetadata(options = {}) {
79
+ options.signal?.throwIfAborted();
80
+ const tables = await this.listTables();
81
+ options.signal?.throwIfAborted();
82
+ return tables.map(table => ({ name: getTableMetadataName(table), queryable: false }));
83
+ }
84
+ /** Discovers one native table schema; ambiguous unqualified names are rejected. */
85
+ async getTableMetadata(name, options = {}) {
86
+ options.signal?.throwIfAborted();
87
+ const tables = await this.listTables();
88
+ options.signal?.throwIfAborted();
89
+ const exact = tables.filter(table => getTableMetadataName(table) === name);
90
+ const matches = exact.length ? exact : tables.filter(table => table.tableName === name);
91
+ if (matches.length !== 1)
92
+ throw new Error(`Unknown or ambiguous SQL table: ${name}`);
93
+ const schema = await this.getTableSchema(matches[0]);
94
+ options.signal?.throwIfAborted();
95
+ return { name: getTableMetadataName(matches[0]), schema, queryable: false };
96
+ }
77
97
  /** Returns the schema for a specific SQL table. */
78
98
  async getTableSchema(options) {
79
99
  const adapter = await this.getAdapter();
@@ -172,4 +192,11 @@ function getSQLTableQueryDialect(sourceType) {
172
192
  return 'snowflake';
173
193
  throw new Error(`Portable table queries are not supported for SQL source type "${sourceType}".`);
174
194
  }
195
+ /** Preserves native namespace components as one unambiguous provider-defined loaded name. */
196
+ function getTableMetadataName(table) {
197
+ return [table.catalogName, table.schemaName, table.tableName]
198
+ .filter((name) => typeof name === 'string' && name.length > 0)
199
+ .map(name => `"${name.replaceAll('"', '""')}"`)
200
+ .join('.');
201
+ }
175
202
  //# sourceMappingURL=sql-source.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"sql-source.js","sourceRoot":"","sources":["../src/sql-source.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sql-source.js","sourceRoot":"","sources":["../src/sql-source.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@loaders.gl/sql",
3
3
  "description": "DuckDB and Snowflake SQL data sources and portable SQL predicate parsing",
4
- "version": "5.0.0-beta.5",
4
+ "version": "5.0.0-beta.6",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "publishConfig": {
@@ -70,5 +70,5 @@
70
70
  "@duckdb/node-api": "^1.5.2-r.1",
71
71
  "zod": "^4.1.12"
72
72
  },
73
- "gitHead": "673b72c560b284f158ff145ba74707f9a3994935"
73
+ "gitHead": "9f51365702efd62aa5bae5f9c2880260503d76bd"
74
74
  }
package/src/index.ts CHANGED
@@ -76,6 +76,9 @@ export type {
76
76
  export type {
77
77
  TableQueryFilterStep,
78
78
  TableQueryLimitStep,
79
+ TableQuery,
80
+ TableSelection,
81
+ TableQueryExecutionOptions,
79
82
  TableQueryOptions,
80
83
  TableQueryPlan,
81
84
  TableQueryPlanStep,
package/src/sql-source.ts CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  import type {ArrowTable, Schema} from '@loaders.gl/core/schema';
6
6
  import {DataSource} from '@loaders.gl/core/loader-utils';
7
- import type {CoreAPI, RequiredOptions} from '@loaders.gl/core/loader-utils';
7
+ import type {CoreAPI, RequiredOptions, TableMetadata} from '@loaders.gl/core/loader-utils';
8
8
 
9
9
  import type {
10
10
  SQLAdapter,
@@ -108,6 +108,30 @@ export class SQLDataSource extends DataSource<string, SQLSourceOptions> {
108
108
  return await adapter.listTables(options);
109
109
  }
110
110
 
111
+ /** Lists stable native table identifiers without fetching any column schemas or data rows. */
112
+ async getTablesMetadata(options: {signal?: AbortSignal} = {}): Promise<readonly TableMetadata[]> {
113
+ options.signal?.throwIfAborted();
114
+ const tables = await this.listTables();
115
+ options.signal?.throwIfAborted();
116
+ return tables.map(table => ({name: getTableMetadataName(table), queryable: false}));
117
+ }
118
+
119
+ /** Discovers one native table schema; ambiguous unqualified names are rejected. */
120
+ async getTableMetadata(
121
+ name: string,
122
+ options: {signal?: AbortSignal} = {}
123
+ ): Promise<TableMetadata> {
124
+ options.signal?.throwIfAborted();
125
+ const tables = await this.listTables();
126
+ options.signal?.throwIfAborted();
127
+ const exact = tables.filter(table => getTableMetadataName(table) === name);
128
+ const matches = exact.length ? exact : tables.filter(table => table.tableName === name);
129
+ if (matches.length !== 1) throw new Error(`Unknown or ambiguous SQL table: ${name}`);
130
+ const schema = await this.getTableSchema(matches[0]);
131
+ options.signal?.throwIfAborted();
132
+ return {name: getTableMetadataName(matches[0]), schema, queryable: false};
133
+ }
134
+
111
135
  /** Returns the schema for a specific SQL table. */
112
136
  async getTableSchema(options: {
113
137
  catalogName?: string;
@@ -226,3 +250,11 @@ function getSQLTableQueryDialect(sourceType: string): SQLTableQueryDialect {
226
250
  if (sourceType === 'snowflake-sql') return 'snowflake';
227
251
  throw new Error(`Portable table queries are not supported for SQL source type "${sourceType}".`);
228
252
  }
253
+
254
+ /** Preserves native namespace components as one unambiguous provider-defined loaded name. */
255
+ function getTableMetadataName(table: SQLTableInfo): string {
256
+ return [table.catalogName, table.schemaName, table.tableName]
257
+ .filter((name): name is string => typeof name === 'string' && name.length > 0)
258
+ .map(name => `"${name.replaceAll('"', '""')}"`)
259
+ .join('.');
260
+ }