@vanit-co/sql-ts 0.0.2 → 0.2.0

package/README.md

@@ -105,6 +105,34 @@ const u = schema({ table: 'users', columns: ['id', 'email'], alias: 'u' })
 
 After calling `schema`, the returned object has a typed property for each column (`users.id`, `users.email`, etc.).
 
+### `as(column)`
+
+Returns the aliased column name as a plain string — the same `prefix_name` string that `selectAs` writes into the SQL `AS` clause. Use this to read a column out of query results by its aliased key without repeating the string manually.
+
+```ts
+import { schema, as, selectAs, all } from '@vanit-co/sql-ts'
+
+const users = schema({ table: 'users', columns: ['id', 'email'] })
+const u = schema({ table: 'users', columns: ['id', 'email'], alias: 'u' })
+
+as(users.id)     // 'users_id'
+as(users.email)  // 'users_email'
+
+as(u.id)         // 'u_id'
+as(u.email)      // 'u_email'
+```
+
+This is particularly useful when mapping over result rows:
+
+```ts
+const rows = await client.query(selectAs`SELECT ${all(users)} FROM ${users}`)
+
+rows.map(row => ({
+  id:    row[as(users.id)],    // row['users_id']
+  email: row[as(users.email)], // row['users_email']
+}))
+```
+
 ---
 
 ### Result object

package/dist/index.d.ts

@@ -46,6 +46,7 @@ type Params<T extends string> = {
     readonly alias?: string;
 };
 declare const schema: <T extends string>({ table, columns, alias }: Params<T>) => SchemaTable<T>;
+declare const as: (col: { [K in symbol]: Column; }) => string;
 
 declare const sql: (strings: TemplateStringsArray, ...binds: Array<any>) => Result;
 declare const select: (strings: TemplateStringsArray, ...binds: Array<any>) => Result;
@@ -68,4 +69,4 @@ declare const pick: (...columns: Array<{
 }>) => Value;
 declare const raw: (content: string) => Value;
 
-export { all, concat, empty, insert, join as j, join, pick, preparedStatementName, raw, select as s, selectAs as sa, schema, select, selectAs, sql, toMysql, toPostgres, update, where as w, where };
+export { all, as, concat, empty, insert, join as j, join, pick, preparedStatementName, raw, select as s, selectAs as sa, schema, select, selectAs, sql, toMysql, toPostgres, update, where as w, where };

package/dist/index.js

@@ -79,6 +79,10 @@ const schema = ({ table, columns, alias }) => {
         ...makeColumns(resolvedAlias, columns)
     };
 };
+const as = (col) => {
+    const c = col[SYM_COLUMN];
+    return c.prefix + '_' + c.name;
+};
 
 const identifier = (content) => ({ [SYM_IDENTIFIER]: true, content });
 
@@ -150,6 +154,7 @@ const raw = (content) => ({
 });
 
 exports.all = all;
+exports.as = as;
 exports.concat = concat;
 exports.empty = empty;
 exports.insert = insert;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanit-co/sql-ts",
-  "version": "0.0.2",
+  "version": "0.2.0",
   "description": "A TypeScript SQL query builder using tagged template literals. Write plain SQL with safe, automatic parameter binding and properly quoted identifiers. No DSL to learn, no magic, no ORM.",
   "type": "module",
   "main": "./dist/index.js",