@treasuredata/tdx 0.1.0

package/dist/utils/table-ref-parser.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Table reference parser for (catalog).(database).(table) patterns
+ *
+ * Parses table reference patterns with support for wildcards and optional parts.
+ *
+ * Supported formats:
+ * - mytable                 -> table only (searches across all databases)
+ * - mydb.mytable            -> database.table
+ * - td.mydb.mytable         -> catalog.database.table
+ * - mydb.*                  -> database with wildcard table
+ * - *.mytable               -> wildcard database with specific table (explicit)
+ * - *.*                     -> all databases, all tables
+ * - *.user*                 -> wildcard database with table pattern
+ *
+ * Pattern matching:
+ * - * matches any sequence of characters
+ * - ? matches any single character
+ * - Patterns without wildcards are treated as exact names
+ * - To list all tables in a specific database, use: mydb.*
+ */
+/**
+ * Parsed table reference result
+ */
+export interface TableReference {
+    /**
+     * Catalog name (e.g., 'td'), can contain wildcards (*, ?)
+     * undefined if not specified
+     */
+    catalog?: string;
+    /**
+     * Database name, can contain wildcards (*, ?)
+     * undefined if not specified
+     */
+    database?: string;
+    /**
+     * Table name, can contain wildcards (*, ?)
+     * undefined if not specified
+     */
+    table?: string;
+    /**
+     * Original input pattern
+     */
+    original: string;
+}
+/**
+ * Parse a table reference pattern
+ *
+ * Supports multiple formats:
+ * - users                   -> { table: 'users' }
+ * - mydb.users              -> { database: 'mydb', table: 'users' }
+ * - td.mydb.users           -> { catalog: 'td', database: 'mydb', table: 'users' }
+ * - mydb.*                  -> { database: 'mydb', table: '*' }
+ * - *.users                 -> { database: '*', table: 'users' }
+ * - *.*                     -> { database: '*', table: '*' }
+ * - *.user*                 -> { database: '*', table: 'user*' }
+ * - prod_*.access_log       -> { database: 'prod_*', table: 'access_log' }
+ *
+ * @param pattern - Table reference pattern
+ * @returns Parsed table reference
+ * @throws {Error} When pattern is invalid (empty, whitespace-only, or missing required parts)
+ *
+ * @example
+ * ```typescript
+ * parseTableReference('users')
+ * // { table: 'users', original: 'users' }
+ *
+ * parseTableReference('mydb.users')
+ * // { database: 'mydb', table: 'users', original: 'mydb.users' }
+ *
+ * parseTableReference('td.mydb.users')
+ * // { catalog: 'td', database: 'mydb', table: 'users', original: 'td.mydb.users' }
+ *
+ * parseTableReference('mydb.*')
+ * // { database: 'mydb', table: '*', original: 'mydb.*' }
+ *
+ * parseTableReference('*.user*')
+ * // { database: '*', table: 'user*', original: '*.user*' }
+ *
+ * parseTableReference('*.*')
+ * // { database: '*', table: '*', original: '*.*' }
+ * ```
+ */
+export declare function parseTableReference(pattern: string): TableReference;
+/**
+ * Format a table reference for display
+ *
+ * @param ref - Parsed table reference
+ * @returns Human-readable string
+ *
+ * @example
+ * ```typescript
+ * formatTableReference({ database: 'mydb', table: 'users' })
+ * // 'mydb.users'
+ *
+ * formatTableReference({ catalog: 'td', database: 'mydb', table: 'users' })
+ * // 'td.mydb.users'
+ *
+ * formatTableReference({ database: 'prod_*', table: 'access_log' })
+ * // 'prod_*.access_log'
+ * ```
+ */
+export declare function formatTableReference(ref: TableReference): string;
+/**
+ * Validate if a table reference is valid for table list operation
+ *
+ * @param ref - Parsed table reference
+ * @returns Error message if invalid, undefined if valid
+ */
+export declare function validateTableListReference(_ref: TableReference): string | undefined;
+/**
+ * Validate if a table reference is valid for table describe operation
+ *
+ * @param ref - Parsed table reference
+ * @returns Error message if invalid, undefined if valid
+ *
+ * Note: Database is optional if provided via --database option
+ */
+export declare function validateTableDescribeReference(ref: TableReference): string | undefined;
+//# sourceMappingURL=table-ref-parser.d.ts.map

package/dist/utils/table-ref-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-ref-parser.d.ts","sourceRoot":"","sources":["../../src/utils/table-ref-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAoDnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAgBhE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAGnF;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAkBtF"}

package/dist/utils/table-ref-parser.js

@@ -0,0 +1 @@
+function a52_0x3987(_0x4b0e74,_0x191d25){const _0x30e768=a52_0x30e7();return a52_0x3987=function(_0x398730,_0x3825e5){_0x398730=_0x398730-0xac;let _0x3e11bb=_0x30e768[_0x398730];return _0x3e11bb;},a52_0x3987(_0x4b0e74,_0x191d25);}(function(_0x30dd3e,_0x2e86ac){const _0x449c50=a52_0x3987,_0x20a7b1=_0x30dd3e();while(!![]){try{const _0x517423=parseInt(_0x449c50(0xac))/0x1+-parseInt(_0x449c50(0xb5))/0x2+-parseInt(_0x449c50(0xbe))/0x3*(parseInt(_0x449c50(0xc1))/0x4)+parseInt(_0x449c50(0xc2))/0x5+-parseInt(_0x449c50(0xb1))/0x6+-parseInt(_0x449c50(0xba))/0x7+parseInt(_0x449c50(0xc3))/0x8;if(_0x517423===_0x2e86ac)break;else _0x20a7b1['push'](_0x20a7b1['shift']());}catch(_0x22b615){_0x20a7b1['push'](_0x20a7b1['shift']());}}}(a52_0x30e7,0x3fdf5));function hasWildcard(_0x52099a){const _0x1d2200=a52_0x3987;return _0x52099a[_0x1d2200(0xbc)]('*')||_0x52099a[_0x1d2200(0xbc)]('?');}export function parseTableReference(_0x30dcfb){const _0x5aa283=a52_0x3987;if(!_0x30dcfb||_0x30dcfb[_0x5aa283(0xb3)]()[_0x5aa283(0xae)]===0x0)throw new Error(_0x5aa283(0xbd));const _0x5bc398=_0x30dcfb[_0x5aa283(0xb3)](),_0x4a9af8={'original':_0x5bc398},_0xe8d1cc=_0x5bc398[_0x5aa283(0xbf)]('.');if(_0xe8d1cc['length']===0x1){const _0x1c2a4b=_0xe8d1cc[0x0];if(!_0x1c2a4b)throw new Error(_0x5aa283(0xb4));_0x4a9af8[_0x5aa283(0xb6)]=_0x1c2a4b;}else{if(_0xe8d1cc[_0x5aa283(0xae)]===0x2){const [_0x221861,_0x537530]=_0xe8d1cc;if(!_0x221861)throw new Error(_0x5aa283(0xb8));if(!_0x537530)throw new Error(_0x5aa283(0xaf));_0x4a9af8[_0x5aa283(0xb7)]=_0x221861,_0x4a9af8['table']=_0x537530;}else{if(_0xe8d1cc[_0x5aa283(0xae)]===0x3){const [_0x1943d9,_0x22a65e,_0xacfd05]=_0xe8d1cc;if(!_0x1943d9||!_0x22a65e||!_0xacfd05)throw new Error(_0x5aa283(0xad));_0x4a9af8[_0x5aa283(0xbb)]=_0x1943d9,_0x4a9af8[_0x5aa283(0xb7)]=_0x22a65e,_0x4a9af8[_0x5aa283(0xb6)]=_0xacfd05;}else throw new Error(_0x5aa283(0xb9));}}return _0x4a9af8;}export function formatTableReference(_0x294e35){const _0xe668b6=a52_0x3987,_0x126178=[];return _0x294e35['catalog']&&_0x126178[_0xe668b6(0xb0)](_0x294e35['catalog']),_0x294e35[_0xe668b6(0xb7)]&&_0x126178[_0xe668b6(0xb0)](_0x294e35[_0xe668b6(0xb7)]),_0x294e35[_0xe668b6(0xb6)]&&_0x126178[_0xe668b6(0xb0)](_0x294e35[_0xe668b6(0xb6)]),_0x126178[_0xe668b6(0xb2)]('.');}export function validateTableListReference(_0x1bde3c){return undefined;}function a52_0x30e7(){const _0x4e7d0d=['trim','Pattern\x20cannot\x20be\x20just\x20a\x20dot','852014ZwDBTP','table','database','Database\x20part\x20cannot\x20be\x20empty\x20-\x20use\x20\x22*\x22\x20for\x20all\x20databases\x20(e.g.,\x20\x22*.mytable\x22)','Invalid\x20pattern\x20format\x20-\x20too\x20many\x20dots\x20(max:\x20catalog.database.table)','1311541wKzyKR','catalog','includes','Pattern\x20cannot\x20be\x20empty\x20or\x20whitespace-only','51951LovUUw','split','Wildcards\x20are\x20not\x20allowed\x20in\x20database\x20name\x20for\x20describe\x20operation','84luzJis','2510370wuRbwo','4753176KubbKX','315233lSkAOf','Invalid\x20catalog.database.table\x20format\x20-\x20all\x20parts\x20must\x20be\x20non-empty','length','Table\x20part\x20cannot\x20be\x20empty\x20-\x20use\x20\x22*\x22\x20for\x20all\x20tables\x20(e.g.,\x20\x22mydb.*\x22)','push','1036836KhSjjY','join'];a52_0x30e7=function(){return _0x4e7d0d;};return a52_0x30e7();}export function validateTableDescribeReference(_0x37dc24){const _0x1e6f40=a52_0x3987;if(!_0x37dc24[_0x1e6f40(0xb6)])return'Table\x20name\x20is\x20required\x20for\x20describe\x20operation';if(_0x37dc24[_0x1e6f40(0xb7)]&&hasWildcard(_0x37dc24[_0x1e6f40(0xb7)]))return _0x1e6f40(0xc0);if(hasWildcard(_0x37dc24[_0x1e6f40(0xb6)]))return'Wildcards\x20are\x20not\x20allowed\x20in\x20table\x20name\x20for\x20describe\x20operation';return undefined;}

package/dist/utils/table-ref-parser.js.map

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

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@treasuredata/tdx",
+  "version": "0.1.0",
+  "description": "AI-native CLI for Treasure Data - optimized for both human engineers and AI coding assistants",
+  "type": "module",
+  "bin": {
+    "tdx": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./sdk": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build:ts": "tsc && chmod +x dist/cli.js",
+    "build:obfuscate": "javascript-obfuscator ./dist --output ./dist",
+    "build": "npm run build:ts && npm run build:obfuscate",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest src/",
+    "test:integration": "vitest --run tests/",
+    "test:coverage": "vitest --coverage src/",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "release": "scripts/prepare-release.sh"
+  },
+  "keywords": [
+    "treasure-data",
+    "cli",
+    "ai-native",
+    "database",
+    "analytics",
+    "cdp",
+    "workflow"
+  ],
+  "author": "Treasure Data DevAI Unit",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/treasure-data/tdx.git"
+  },
+  "bugs": {
+    "url": "https://github.com/treasure-data/tdx/issues"
+  },
+  "homepage": "https://github.com/treasure-data/tdx#readme",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
+    "ora": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.16.0",
+    "@typescript-eslint/parser": "^8.16.0",
+    "@vitest/coverage-v8": "^4.0.6",
+    "eslint": "^9.15.0",
+    "javascript-obfuscator": "^4.1.1",
+    "prettier": "^3.3.3",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.6"
+  }
+}