@duckcodeailabs/dql-notebook 1.6.1 → 1.6.3

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.
@@ -2,9 +2,14 @@ import type { ConnectionConfig } from '@duckcodeailabs/dql-connectors';
2
2
  export interface ConnectorFieldSchema {
3
3
  key: keyof ConnectionConfig | 'name';
4
4
  label: string;
5
- type: 'text' | 'number' | 'password' | 'checkbox';
5
+ type: 'text' | 'number' | 'password' | 'checkbox' | 'select' | 'textarea';
6
6
  placeholder?: string;
7
7
  required?: boolean;
8
+ options?: Array<{
9
+ value: string;
10
+ label: string;
11
+ }>;
12
+ helpText?: string;
8
13
  }
9
14
  export interface ConnectorFormSchema {
10
15
  driver: ConnectionConfig['driver'];
@@ -1 +1 @@
1
- {"version":3,"file":"connector-forms.d.ts","sourceRoot":"","sources":["../src/connector-forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,gBAAgB,GAAG,MAAM,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAiJD,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D"}
1
+ {"version":3,"file":"connector-forms.d.ts","sourceRoot":"","sources":["../src/connector-forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,gBAAgB,GAAG,MAAM,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AA4LD,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAE/D"}
@@ -72,7 +72,22 @@ const schemas = [
72
72
  { key: 'database', label: 'Database', type: 'text', required: true },
73
73
  { key: 'schema', label: 'Schema', type: 'text', required: true },
74
74
  { key: 'username', label: 'Username', type: 'text', required: true },
75
- { key: 'password', label: 'Password', type: 'password', required: true },
75
+ {
76
+ key: 'authMethod',
77
+ label: 'Authentication',
78
+ type: 'select',
79
+ options: [
80
+ { value: 'password', label: 'Password' },
81
+ { value: 'key_pair', label: 'Key pair / private key' },
82
+ { value: 'external_browser', label: 'SSO / external browser' },
83
+ { value: 'oauth', label: 'OAuth token' },
84
+ ],
85
+ },
86
+ { key: 'password', label: 'Password / OAuth token', type: 'password' },
87
+ { key: 'privateKeyPath', label: 'Private key file path', type: 'text', placeholder: '~/.ssh/snowflake_key.p8' },
88
+ { key: 'privateKey', label: 'Private key PEM', type: 'textarea', helpText: 'Paste PEM only when a key file cannot be referenced.' },
89
+ { key: 'privateKeyPassphrase', label: 'Private key passphrase', type: 'password' },
90
+ { key: 'authenticator', label: 'Authenticator override', type: 'text', placeholder: 'EXTERNALBROWSER or OAUTH' },
76
91
  { key: 'role', label: 'Role', type: 'text' },
77
92
  ],
78
93
  },
@@ -80,9 +95,22 @@ const schemas = [
80
95
  driver: 'bigquery',
81
96
  label: 'BigQuery',
82
97
  category: 'warehouse',
83
- description: 'Google BigQuery project-level connection.',
98
+ description: 'Google BigQuery project-level connection with ADC or service account credentials.',
84
99
  fields: [
85
100
  { key: 'projectId', label: 'Project ID', type: 'text', required: true },
101
+ { key: 'location', label: 'Location', type: 'text', placeholder: 'US' },
102
+ {
103
+ key: 'authMethod',
104
+ label: 'Authentication',
105
+ type: 'select',
106
+ options: [
107
+ { value: 'application_default', label: 'Application default credentials' },
108
+ { value: 'service_account_key_file', label: 'Service account key file' },
109
+ { value: 'service_account_json', label: 'Service account JSON' },
110
+ ],
111
+ },
112
+ { key: 'keyFilename', label: 'Key file path', type: 'text', placeholder: '/secure/path/service-account.json' },
113
+ { key: 'serviceAccountJson', label: 'Service account JSON', type: 'textarea' },
86
114
  ],
87
115
  },
88
116
  {
@@ -103,25 +131,40 @@ const schemas = [
103
131
  driver: 'databricks',
104
132
  label: 'Databricks SQL',
105
133
  category: 'lakehouse',
106
- description: 'Databricks SQL warehouse hostname, path, and personal access token.',
134
+ description: 'Databricks SQL warehouse hostname, path, and access token.',
107
135
  fields: [
108
136
  { key: 'host', label: 'Server hostname', type: 'text', required: true },
109
137
  { key: 'database', label: 'Catalog / database', type: 'text' },
110
138
  { key: 'schema', label: 'Schema', type: 'text' },
111
139
  { key: 'warehouse', label: 'HTTP path / warehouse', type: 'text', required: true },
112
- { key: 'password', label: 'Access token', type: 'password', required: true },
140
+ { key: 'authMethod', label: 'Authentication', type: 'select', options: [{ value: 'token', label: 'Access token' }] },
141
+ { key: 'token', label: 'Access token', type: 'password', required: true },
113
142
  ],
114
143
  },
115
144
  {
116
145
  driver: 'athena',
117
146
  label: 'Amazon Athena',
118
147
  category: 'lakehouse',
119
- description: 'Athena workgroup-backed query execution via AWS.',
148
+ description: 'Athena workgroup-backed query execution via AWS credentials.',
120
149
  fields: [
121
150
  { key: 'host', label: 'Region', type: 'text', placeholder: 'us-east-1', required: true },
122
151
  { key: 'database', label: 'Database', type: 'text', required: true },
123
- { key: 'schema', label: 'S3 output location', type: 'text', placeholder: 's3://bucket/query-results/', required: true },
124
- { key: 'warehouse', label: 'Workgroup', type: 'text' },
152
+ { key: 'outputLocation', label: 'S3 output location', type: 'text', placeholder: 's3://bucket/query-results/', required: true },
153
+ { key: 'workgroup', label: 'Workgroup', type: 'text' },
154
+ {
155
+ key: 'authMethod',
156
+ label: 'Authentication',
157
+ type: 'select',
158
+ options: [
159
+ { value: 'aws_default', label: 'AWS default provider chain' },
160
+ { value: 'aws_profile', label: 'AWS profile' },
161
+ { value: 'aws_access_key', label: 'Access key / session token' },
162
+ ],
163
+ },
164
+ { key: 'profile', label: 'AWS profile', type: 'text', placeholder: 'prod-analytics' },
165
+ { key: 'accessKeyId', label: 'Access key ID', type: 'password' },
166
+ { key: 'secretAccessKey', label: 'Secret access key', type: 'password' },
167
+ { key: 'sessionToken', label: 'Session token', type: 'password' },
125
168
  ],
126
169
  },
127
170
  {
@@ -1 +1 @@
1
- {"version":3,"file":"connector-forms.js","sourceRoot":"","sources":["../src/connector-forms.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"connector-forms.js","sourceRoot":"","sources":["../src/connector-forms.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACvC,gBAAgB,CAUlB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAsBjE;AAwBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAkE/G"}
1
+ {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACvC,gBAAgB,CAUlB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAsBjE;AAwBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAwE/G"}
package/dist/document.js CHANGED
@@ -59,12 +59,12 @@ export function createWelcomeNotebook(template, projectTitle, driver) {
59
59
  const normalized = template.toLowerCase();
60
60
  const showTablesQuery = listTablesSQL(driver);
61
61
  if (normalized === 'dbt') {
62
- return createNotebookDocument(`${projectTitle} DQL Notebook`, [
62
+ return createNotebookDocument(`${projectTitle} - DQL Workbench`, [
63
63
  {
64
64
  id: 'intro',
65
65
  type: 'markdown',
66
66
  title: 'Welcome',
67
- source: `# ${projectTitle}\n\nThis notebook connects to your dbt project's database. Run the cells below to explore the tables built by dbt.\n\n> DQL is the **answer layer** on top of dbt. dbt transforms your data DQL turns it into trusted, governed analytics answers.`,
67
+ source: `# ${projectTitle}\n\nDQL means **Domain Query Language**. It is the domain layer that turns dbt models, SQL, metrics, notebooks, dashboards, apps, and business definitions into one trusted analytics project.\n\n**Core path:** source data -> dbt model -> DQL block -> business_view -> dashboard/app/AI answer.\n\nThis notebook is your workbench. Explore the dbt-backed database below, then promote useful queries into blocks and business views so the compiler can write \`dql-manifest.json\` with both technical lineage and business lineage.`,
68
68
  },
69
69
  {
70
70
  id: 'sql-tables',
@@ -81,24 +81,24 @@ export function createWelcomeNotebook(template, projectTitle, driver) {
81
81
  {
82
82
  id: 'dql-example',
83
83
  type: 'dql',
84
- title: 'Example DQL Block',
85
- source: `block "Example Block" {\n domain = "analytics"\n type = "custom"\n owner = "data-team"\n description = "An example governed analytics block"\n\n query = """\n -- Replace with your own query\n ${showTablesQuery.replace(/\n/g, '\n ')}\n """\n\n tests {\n assert row_count > 0\n }\n}`,
84
+ title: 'Example Domain Layer',
85
+ source: `term "Customer" {\n domain = "Customer"\n type = "entity"\n status = "draft"\n description = "A person or account that can place orders or receive service."\n owner = "customer-analytics"\n identifiers = ["customer_id"]\n}\n\nblock "Example Customer Rollup" {\n domain = "Customer"\n type = "custom"\n status = "draft"\n description = "Starter customer summary block. Replace this query with a dbt model query."\n owner = "analytics"\n terms = ["Customer"]\n businessOutcome = "Understand customer value and activity."\n decisionUse = "Account planning and retention review."\n\n query = """\n SELECT 1 AS customer_count\n """\n\n tests {\n assert row_count == 1\n }\n}\n\nbusiness_view "Customer 360" {\n domain = "Customer"\n status = "draft"\n description = "Business composition for account review and customer health."\n owner = "customer-analytics"\n terms = ["Customer"]\n businessOutcome = "See customer identity, value, activity, and service risk in one lineage path."\n decisionUse = "Account planning, churn review, and expansion targeting."\n reviewCadence = "weekly"\n\n includes {\n block "Example Customer Rollup"\n }\n}`,
86
86
  },
87
87
  {
88
88
  id: 'next-steps',
89
89
  type: 'markdown',
90
90
  title: 'Next Steps',
91
- source: `## Next steps\n\n1. **Add SQL cells** query any table from your dbt project\n2. **Create DQL blocks** wrap queries with governance (owner, domain, tests)\n3. **Open Block Studio** use the sidebar to browse tables and semantic metrics\n4. **View lineage** — run \`dql lineage\` to see the full data flow\n5. **Export** save as \`.dqlnb\` for git-trackable analytics`,
91
+ source: `## Next steps\n\n1. Query a dbt model and save the useful logic as a DQL block.\n2. Add business terms under \`terms/\` for the vocabulary stakeholders use.\n3. Compose blocks into \`business_view\` files under \`business-views/\`.\n4. Run \`dql compile .\` to refresh \`dql-manifest.json\`.\n5. Open Lineage to trace source -> model -> block -> business view -> consumption.`,
92
92
  },
93
- ], { description: 'DQL notebook for exploring a dbt project.', template: 'dbt' });
93
+ ], { description: 'DQL workbench for turning a dbt project into business lineage.', template: 'dbt' });
94
94
  }
95
95
  // Default notebook for non-dbt projects
96
- return createNotebookDocument(`${projectTitle} DQL Notebook`, [
96
+ return createNotebookDocument(`${projectTitle} - DQL Workbench`, [
97
97
  {
98
98
  id: 'intro',
99
99
  type: 'markdown',
100
100
  title: 'Welcome',
101
- source: `# ${projectTitle}\n\nWelcome to the DQL notebook. Use this notebook to write SQL, create governed DQL blocks, and build analytics answers all tracked in Git.`,
101
+ source: `# ${projectTitle}\n\nDQL means **Domain Query Language**. It turns SQL, business terms, notebooks, dashboards, apps, and lineage into one trusted analytics project.\n\n**Core path:** source data -> DQL block -> business_view -> dashboard/app/AI answer.\n\nThis notebook is your workbench. Start with a table or local file, promote useful SQL into a block, then compose blocks into business views so the compiler can write \`dql-manifest.json\` with both technical lineage and business lineage.`,
102
102
  },
103
103
  {
104
104
  id: 'sql-tables',
@@ -112,12 +112,18 @@ export function createWelcomeNotebook(template, projectTitle, driver) {
112
112
  title: 'Starter Query',
113
113
  source: `-- Write your SQL here\n-- If using DuckDB, you can query local CSV, Parquet, and JSON files directly\n-- Example: SELECT * FROM read_csv_auto('./data/my_file.csv') LIMIT 10;`,
114
114
  },
115
+ {
116
+ id: 'dql-example',
117
+ type: 'dql',
118
+ title: 'Example Domain Layer',
119
+ source: `term "Customer" {\n domain = "Customer"\n type = "entity"\n status = "draft"\n description = "A person or account that can place orders or receive service."\n owner = "customer-analytics"\n identifiers = ["customer_id"]\n}\n\nblock "Example Customer Rollup" {\n domain = "Customer"\n type = "custom"\n status = "draft"\n description = "Starter customer summary block. Replace this query with your own source table."\n owner = "analytics"\n terms = ["Customer"]\n businessOutcome = "Understand customer value and activity."\n decisionUse = "Account planning and retention review."\n\n query = """\n SELECT 1 AS customer_count\n """\n\n tests {\n assert row_count == 1\n }\n}\n\nbusiness_view "Customer 360" {\n domain = "Customer"\n status = "draft"\n description = "Business composition for account review and customer health."\n owner = "customer-analytics"\n terms = ["Customer"]\n businessOutcome = "See customer identity, value, activity, and service risk in one lineage path."\n decisionUse = "Account planning, churn review, and expansion targeting."\n reviewCadence = "weekly"\n\n includes {\n block "Example Customer Rollup"\n }\n}`,
120
+ },
115
121
  {
116
122
  id: 'next-steps',
117
123
  type: 'markdown',
118
124
  title: 'Next Steps',
119
- source: `## Next steps\n\n1. **Add data** place CSV/Parquet files in your project or connect to a database\n2. **Write SQL cells** query your data interactively\n3. **Create DQL blocks** wrap queries with governance (owner, domain, tests)\n4. **Export** save as \`.dqlnb\` for git-trackable analytics`,
125
+ source: `## Next steps\n\n1. Add data by connecting a warehouse or querying local CSV/Parquet files with DuckDB.\n2. Save repeated SQL as DQL blocks under \`blocks/\`.\n3. Add business terms under \`terms/\` for shared vocabulary.\n4. Compose blocks into \`business_view\` files under \`business-views/\`.\n5. Run \`dql compile .\` and open Lineage to inspect the business and technical path.`,
120
126
  },
121
- ], { description: 'DQL notebook for interactive analytics.', template: 'default' });
127
+ ], { description: 'DQL workbench for building a domain-first analytics project.', template: 'default' });
122
128
  }
123
129
  //# sourceMappingURL=document.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@duckcodeailabs/dql-notebook",
3
- "version": "1.6.1",
3
+ "version": "1.6.3",
4
4
  "description": "Notebook document model and execution helpers for DQL",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -24,8 +24,8 @@
24
24
  "access": "public"
25
25
  },
26
26
  "dependencies": {
27
- "@duckcodeailabs/dql-core": "^1.6.1",
28
- "@duckcodeailabs/dql-connectors": "^1.6.1"
27
+ "@duckcodeailabs/dql-core": "^1.6.3",
28
+ "@duckcodeailabs/dql-connectors": "^1.6.3"
29
29
  },
30
30
  "devDependencies": {
31
31
  "@types/node": "^22.0.0",