Add raw method

.gha.npmrc

@@ -0,0 +1,2 @@
+# This file is renamed to .npmrc during the build process. See the github actions files.
+//registry.npmjs.org/:_authToken=${NPM_TOKEN}

.github/workflows/build-test-publish.yml

@@ -23,6 +23,8 @@ jobs:
 
       - name: Build & publish core
         run: |
+          mv ./.gha.npmrc ./.npmrc
+          mv ../README.md ./
           npm run build --workspace=core
           npm publish --workspace=core
         env:

README.md

@@ -249,6 +249,8 @@ const [rows] = await sql`
 
 **Remember that embedding plain strings without the `sql` tag will escape/parameterize them.**
 
+- `sql.raw(value: string)`
+
 To embed variables directly without parameterizing them, use the tag's `.raw()` method:
 
 ```js

core/SqlTag.ts

@@ -39,6 +39,17 @@ export class SqlTag<TQueryInfo, TCursorOptions> {
     return new SqlQuery(this.driver, [this.driver.escapeIdentifier(identifier)], []);
   }
 
+  /**
+   * Embeds variables directly without parameterizing them.
+   *
+   * @param string The string to embed.
+   * @returns A SqlExpression representing the raw string.
+   * @example sql.raw('NOW()') // NOW()
+   */
+  raw(string: string): SqlExpression {
+    return new SqlQuery(this.driver, [string], []);
+  }
+
   /**
    * Joins a series of values or expressions with 'AND', wrapped in parentheses.
    *

core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqltags/core",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "Safely create & execute parameterized SQL queries using template strings 🔧✨ minimal API and works with any db driver (pg, mysql, sqlite, etc).",
   "license": "MIT",
   "author": {
@@ -26,8 +26,7 @@
     "url": "git://github.com/brombal/sqltags.git"
   },
   "scripts": {
-    "build": "rm -rf ./dist && parcel build --no-cache",
-    "prepublishOnly": "cp ../README.md ./"
+    "build": "rm -rf ./dist && parcel build --no-cache"
   },
   "engines": {
     "node": ">=16.5"

drivers/mysql/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqltags/mysql",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "MySQL driver for sqltags (@sqltags/core) 🔧✨ Safely create & execute parameterized SQL queries using template strings",
   "license": "MIT",
   "author": {

drivers/postgres/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqltags/pg",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "PostgreSQL driver for SqlTags (@sqltags/core) 🔧✨ Safely create & execute parameterized SQL queries using template strings",
   "license": "MIT",
   "author": {

drivers/sqlite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqltags/sqlite",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "SQLite driver for sqltags (@sqltags/core) 🔧✨ Safely create & execute parameterized SQL queries using template strings",
   "license": "MIT",
   "author": {

test/sqltags.test.ts

@@ -287,6 +287,19 @@ describe('sqltags', () => {
     ]);
   });
 
+  test('.raw embeds raw strings', async () => {
+    const [sql] = createMockSqlTag();
+    const [, info] = await sql`
+      SELECT * FROM users
+      WHERE date = ${sql.raw('NOW()')}
+    `;
+
+    expect(info).toEqual([
+      `SELECT * FROM users
+      WHERE date = NOW()`,
+    ]);
+  });
+
   test('calling .compile() returns sql and params', async () => {
     const [sql] = createMockSqlTag();
     const debug = sql`