@storecraft/database-sql-base 1.0.0 → 1.0.1

package/README.md

@@ -1,7 +1,16 @@
 # Storecraft `SQL` driver
 
+<div style="text-align:center">
+  <img src='https://storecraft.app/storecraft-color.svg' 
+       width='90%'' />
+</div><hr/><br/>
+
 Official `SQL` driver for `StoreCraft` with the dialects abstracted with `Kysely` or your own drivers.
 
+```bash
+npm i @storecraft/database-sql-base
+```
+
 ## usage
 
 ```js
@@ -11,17 +20,29 @@ import { join } from "node:path";
 import { homedir } from "node:os";
 
 import { App } from '@storecraft/core'
-import { NodePlatform } from '@storecraft/platform-node'
-import { MongoDB } from '@storecraft/database-mongodb-node'
-import { NodeLocalStorage } from '@storecraft/storage-node-local'
-
-let app = new App(
-  new NodePlatform(),
-  new MongoDB({ db_name: 'prod', url: '<MONGO-URL>'}),
-  new NodeLocalStorage(join(homedir(), 'tomer'))
-);
+import { NodePlatform } from '@storecraft/platforms/node';
+import { SQL } from '@storecraft/database-sql-base'
+import { migrateToLatest } from '@storecraft/database-sql-base/migrate.js'
+import { NodeLocalStorage } from '@storecraft/storage-local/node'
+
+const app = new App(
+  {
+    auth_admins_emails: ['admin@sc.com'],
+    auth_secret_access_token: 'auth_secret_access_token',
+    auth_secret_refresh_token: 'auth_secret_refresh_token'
+  }
+)
+.withPlatform(new NodePlatform())
+.withDatabase(
+  new SQL({
+    dialect: sqlite_dialect, 
+    dialect_type: 'SQLITE'
+  })
+)
+.withStorage(new NodeLocalStorage(join(homedir(), 'tomer')))
 
 await app.init();
+await migrateToLatest(app.db, false);
  
 const server = http.createServer(app.handler).listen(
   8000,

package/driver.js

@@ -26,8 +26,8 @@ const assert = (b, msg) => {
 }
 
 /**
- * @typedef {import('./types.public.js').Config} Config
- * @typedef {import('./types.sql.tables.js').Database} Database
+ * @typedef {import('./types.public.d.ts').Config} Config
+ * @typedef {import('./types.sql.tables.d.ts').Database} Database
  * @typedef {import('kysely').Dialect} Dialect
  * @typedef {import('@storecraft/core/v-database').db_driver} db_driver
 */
@@ -88,18 +88,6 @@ export class SQL {
     );
   }
 
-  /**
-   * 
-   * @param {boolean} [destroy_db_upon_completion=false] 
-   */
-  async migrateToLatest(destroy_db_upon_completion=false) {
-    this.throwIfNotReady();
-
-    const { migrateToLatest } = await import('./migrate.js');
-
-    await migrateToLatest(this, destroy_db_upon_completion);
-  };
-
   /**
    * 
    * @param {App<any, any, any>} app 
@@ -147,8 +135,8 @@ export class SQL {
     return this.#_resources;
   }
   
-  get name () { 
-    return 'main'; 
+  get name() { 
+    return this?.config?.db_name ?? 'main'; 
   }
 
   get app() { 
@@ -183,8 +171,4 @@ export class SQL {
     return this.dialectType==='MYSQL'; 
   }
 
-  get isMssql() { 
-    return this.dialectType==='MSSQL'; 
-  }
-
 }

package/index.js

@@ -1,3 +1,3 @@
-export * from './driver.js'
+export * from './driver.js';
 
 

package/migrate.js

@@ -29,31 +29,37 @@ export async function migrateToLatest(db_driver, destroy_db_upon_completion=true
 
   current.driver = db_driver;
 
-  const migrator = new Migrator({
-    db,
-    provider: new FileMigrationProvider({
-      fs,
-      path,
-      migrationFolder: path.join(
-        __dirname, 
-        `migrations.${db_driver.dialectType.toLowerCase()}`
+  const migrator = new Migrator(
+    {
+      db,
+      provider: new FileMigrationProvider(
+        {
+          fs,
+          path,
+          migrationFolder: path.join(
+            __dirname, 
+            `migrations.${db_driver.dialectType.toLowerCase()}`
+          ),
+        }
       ),
-    }),
-  })
+    }
+  );
 
   const { error, results } = await migrator.migrateToLatest();
 
-  results?.forEach((it) => {
-    if (it.status === 'Success') {
-      console.log(
-        `migration "${it.migrationName}" was executed successfully`
+  results?.forEach(
+    (it) => {
+      if (it.status === 'Success') {
+        console.log(
+          `migration "${it.migrationName}" was executed successfully`
         );
-    } else if (it.status === 'Error') {
-      console.error(
-        `failed to execute migration "${it.migrationName}"`
+      } else if (it.status === 'Error') {
+        console.error(
+          `failed to execute migration "${it.migrationName}"`
         );
+      }
     }
-  })
+  );
 
   if (error) {
     console.error('failed to migrate')
@@ -62,5 +68,5 @@ export async function migrateToLatest(db_driver, destroy_db_upon_completion=true
   }
 
   if(destroy_db_upon_completion)
-    await db.destroy()
+    await db.destroy();
 }

package/migrations.mysql/00000_init_tables.js

@@ -30,7 +30,7 @@ const add_base_columns = tb => {
 const create_entity_to_value_table = (db, table_name) => {
 
   return db.schema
-    .createTable(table_name)
+    .createTable(table_name).ifNotExists()
     .addColumn('id', 'integer', 
         (col) => col.autoIncrement().primaryKey()
     )
@@ -47,7 +47,7 @@ const create_entity_to_value_table = (db, table_name) => {
  * @param {keyof Database} table_name 
  */
 const create_safe_table = (db, table_name) => {
-  return db.schema.createTable(table_name);
+  return db.schema.createTable(table_name).ifNotExists();
 }
 
 /**
@@ -56,7 +56,7 @@ const create_safe_table = (db, table_name) => {
  * @param {keyof Database} table_name 
  */
 const drop_safe_table = (db, table_name) => {
-  return db.schema.dropTable(table_name).execute();
+  return db.schema.dropTable(table_name).ifExists().execute();
 }
 
 /**
@@ -67,22 +67,22 @@ const drop_safe_table = (db, table_name) => {
  */
 const create_base_indexes = async (db, table_name, include_id=true, include_handle=true) => {
   if(include_id) {
-    await db.schema.createIndex(`index_${table_name}_id_updated_at_asc`)
+    await db.schema.createIndex(`index_${table_name}_id_updated_at_asc`).ifNotExists()
             .on(table_name)
             .columns(['id', 'updated_at asc'])
             .execute();
-    await db.schema.createIndex(`index_${table_name}_id_updated_at_desc`)
+    await db.schema.createIndex(`index_${table_name}_id_updated_at_desc`).ifNotExists()
             .on(table_name)
             .columns(['id', 'updated_at desc'])
             .execute();
   }
 
   if(include_handle) {
-    await db.schema.createIndex(`index_${table_name}_handle_updated_at_asc`)
+    await db.schema.createIndex(`index_${table_name}_handle_updated_at_asc`).ifNotExists()
             .on(table_name)
             .columns(['handle', 'updated_at asc'])
             .execute();
-    await db.schema.createIndex(`index_${table_name}_handle_updated_at_desc`)
+    await db.schema.createIndex(`index_${table_name}_handle_updated_at_desc`).ifNotExists()
             .on(table_name)
             .columns(['handle', 'updated_at desc'])
             .execute();
@@ -94,26 +94,26 @@ const create_base_indexes = async (db, table_name, include_id=true, include_hand
  * @param {keyof Pick<Database, 'entity_to_media' | 
  * 'entity_to_search_terms' | 'entity_to_tags_projections' | 
  * 'products_to_collections' | 'products_to_discounts' | 
- * 'products_to_variants' | 'storefronts_to_other'>} table_name 
+ * 'products_to_variants' | 'storefronts_to_other' | 'products_to_related_products'>} table_name 
  */
 const create_entity_table_indexes = async (db, table_name) => {
-  await db.schema.createIndex(`index_${table_name}_entity_id`)
+  await db.schema.createIndex(`index_${table_name}_entity_id`).ifNotExists()
            .on(table_name)
            .column('entity_id')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_entity_handle`)
+  await db.schema.createIndex(`index_${table_name}_entity_handle`).ifNotExists()
            .on(table_name)
            .column('entity_handle')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_value`)
+  await db.schema.createIndex(`index_${table_name}_value`).ifNotExists()
            .on(table_name)
            .column('value')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_reporter`)
+  await db.schema.createIndex(`index_${table_name}_reporter`).ifNotExists()
            .on(table_name)
            .column('reporter')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_context`)
+  await db.schema.createIndex(`index_${table_name}_context`).ifNotExists()
            .on(table_name)
            .column('context')
            .execute();
@@ -150,7 +150,8 @@ export async function up(db) {
     let tb = create_safe_table(db, 'templates');
     tb = add_base_columns(tb);
     tb = tb.addColumn('title', 'text');
-    tb = tb.addColumn('template', 'text');
+    tb = tb.addColumn('template_html', 'text');
+    tb = tb.addColumn('template_text', 'text');
     tb = tb.addColumn('reference_example_input', 'json');
     await tb.execute();
     await create_base_indexes(db, 'templates');

package/migrations.postgres/00000_init_tables.js

@@ -29,7 +29,7 @@ const add_base_columns = tb => {
 const create_entity_to_value_table = (db, table_name) => {
 
   return db.schema
-    .createTable(table_name)
+    .createTable(table_name).ifNotExists()
     .addColumn('id', 'bigserial', 
         (col) => col.primaryKey()
     )
@@ -46,7 +46,7 @@ const create_entity_to_value_table = (db, table_name) => {
  * @param {keyof Database} table_name 
  */
 const create_safe_table = (db, table_name) => {
-  return db.schema.createTable(table_name);
+  return db.schema.createTable(table_name).ifNotExists();
 }
 
 /**
@@ -55,7 +55,7 @@ const create_safe_table = (db, table_name) => {
  * @param {keyof Database} table_name 
  */
 const drop_safe_table = (db, table_name) => {
-  return db.schema.dropTable(table_name).execute();
+  return db.schema.dropTable(table_name).ifExists().execute();
 }
 
 /**
@@ -66,22 +66,22 @@ const drop_safe_table = (db, table_name) => {
  */
 const create_base_indexes = async (db, table_name, include_id=true, include_handle=true) => {
   if(include_id) {
-    await db.schema.createIndex(`index_${table_name}_id_updated_at_asc`)
+    await db.schema.createIndex(`index_${table_name}_id_updated_at_asc`).ifNotExists()
             .on(table_name)
             .columns(['id', 'updated_at asc'])
             .execute();
-    await db.schema.createIndex(`index_${table_name}_id_updated_at_desc`)
+    await db.schema.createIndex(`index_${table_name}_id_updated_at_desc`).ifNotExists()
             .on(table_name)
             .columns(['id', 'updated_at desc'])
             .execute();
   }
 
   if(include_handle) {
-    await db.schema.createIndex(`index_${table_name}_handle_updated_at_asc`)
+    await db.schema.createIndex(`index_${table_name}_handle_updated_at_asc`).ifNotExists()
             .on(table_name)
             .columns(['handle', 'updated_at asc'])
             .execute();
-    await db.schema.createIndex(`index_${table_name}_handle_updated_at_desc`)
+    await db.schema.createIndex(`index_${table_name}_handle_updated_at_desc`).ifNotExists()
             .on(table_name)
             .columns(['handle', 'updated_at desc'])
             .execute();
@@ -94,26 +94,26 @@ const create_base_indexes = async (db, table_name, include_id=true, include_hand
  * @param {keyof Pick<Database, 'entity_to_media' | 
  * 'entity_to_search_terms' | 'entity_to_tags_projections' | 
  * 'products_to_collections' | 'products_to_discounts' | 
- * 'products_to_variants' | 'storefronts_to_other'>} table_name 
+ * 'products_to_variants' | 'storefronts_to_other' | 'products_to_related_products'>} table_name 
  */
 const create_entity_table_indexes = async (db, table_name) => {
-  await db.schema.createIndex(`index_${table_name}_entity_id`)
+  await db.schema.createIndex(`index_${table_name}_entity_id`).ifNotExists()
            .on(table_name)
            .column('entity_id')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_entity_handle`)
+  await db.schema.createIndex(`index_${table_name}_entity_handle`).ifNotExists()
            .on(table_name)
            .column('entity_handle')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_value`)
+  await db.schema.createIndex(`index_${table_name}_value`).ifNotExists()
            .on(table_name)
            .column('value')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_reporter`)
+  await db.schema.createIndex(`index_${table_name}_reporter`).ifNotExists()
            .on(table_name)
            .column('reporter')
            .execute();
-  await db.schema.createIndex(`index_${table_name}_context`)
+  await db.schema.createIndex(`index_${table_name}_context`).ifNotExists()
            .on(table_name)
            .column('context')
            .execute();
@@ -148,7 +148,8 @@ export async function up(db) {
     let tb = create_safe_table(db, 'templates');
     tb = add_base_columns(tb);
     tb = tb.addColumn('title', 'text');
-    tb = tb.addColumn('template', 'text');
+    tb = tb.addColumn('template_html', 'text');
+    tb = tb.addColumn('template_text', 'text');
     tb = tb.addColumn('reference_example_input', 'json');
     await tb.execute();
     await create_base_indexes(db, 'templates');