create-monolayer-app 0.1.2 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-monolayer-app",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "CLI to scaffold a new Monolayer application",
   "type": "module",
   "bin": {

package/template/_gitignore

@@ -1,7 +1,12 @@
 .DS_Store
+
 .env
 /node_modules/
 
 # React Router
+
 /.react-router/
 /build/
+
+.pglite_development/
+.pglite_test/

package/template/lib/db/client.ts

@@ -0,0 +1,30 @@
+import assert from "node:assert";
+
+import { PGlite } from "@electric-sql/pglite";
+import { PGliteDialect } from "kysely";
+
+import { DSQLDialect } from "../../vendor/kysely-dsql/dsql/dialect";
+import { DSQLKysely } from "../../vendor/kysely-dsql/dsql/dsql-kysely";
+import { createDSQLPool } from "../../vendor/kysely-dsql/dsql/pool";
+import plugins from "../../vendor/kysely-dsql/plugins";
+import type { Database } from "./db.js";
+
+function dialect() {
+  if (process.env.NODE_ENV === "production") {
+    const endpoint = process.env.CLUSTER_ENDPOINT;
+    assert.ok(endpoint);
+    return new DSQLDialect({
+      pool: createDSQLPool(endpoint),
+    });
+  }
+  return new PGliteDialect({
+    pglite: new PGlite(
+      `./.pglite_${process.env.NODE_ENV === "test" ? "test" : "development"}`
+    ),
+  });
+}
+
+export const db: DSQLKysely<Database> = new DSQLKysely<Database>({
+  dialect: dialect(),
+  plugins,
+});

package/template/lib/db/db.ts

@@ -0,0 +1,4 @@
+// This file is generated by @mnlyr-apps/db. Do not edit this file.
+
+// oxlint-disable-next-line typescript/no-empty-interface typescript/no-empty-object-type
+export interface Database {}

package/template/oxlint.config.ts

@@ -29,6 +29,17 @@ export default defineConfig({
     "no-use-before-define": "off",
     "no-empty-pattern": "off",
     "react-doctor/rendering-svg-precision": "off",
+    "arrow-body-style": "off",
   },
+  overrides: [
+    {
+      files: ["lib/db/migrations/*.ts"],
+      rules: {
+        "typescript/no-explicit-any": "off",
+        "no-unused-vars": "off",
+        "unicorn/filename-case": "off",
+      },
+    },
+  ],
   settings: jsPluginSettings,
 });

package/template/package.json

@@ -7,28 +7,48 @@
     "dev": "react-router dev",
     "start": "react-router-serve ./build/server/index.js",
     "check": "react-router typegen && tsc && ultracite check",
-    "fix": "ultracite fix"
+    "fix": "ultracite fix",
+    "migrate:latest": "kysely migrate:latest",
+    "postmigrate:latest": "npm run db:create-types",
+    "migrate:up": "kysely migrate:up",
+    "postmigrate:up": "npm run db:create-types",
+    "migrate:down": "kysely migrate:down",
+    "postmigrate:down": "npm run db:create-types",
+    "migrate:list": "kysely migrate:list",
+    "migrate:make": "tsx vendor/kysely-dsql/generator/create-migration.ts",
+    "db:create-types": "tsx vendor/kysely-dsql/generator/generate-types-from-pglite.ts"
   },
   "dependencies": {
+    "@aws-sdk/dsql-signer": "^3.1126.0",
+    "@aws/aurora-dsql-node-postgres-connector": "^0.1.9",
+    "@kysera/infra": "^0.10.0",
     "@react-router/node": "^8",
     "@react-router/serve": "^8",
+    "@types/pg": "^8.23.1",
     "isbot": "^5.1.36",
+    "kysely": "^0.29.5",
+    "pg": "^8.23.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8"
   },
   "devDependencies": {
+    "@electric-sql/pglite": "^0.5.8",
+    "@electric-sql/pglite-socket": "^0.2.11",
     "@react-router/dev": "^8",
     "@tailwindcss/vite": "^4.2.2",
-    "@types/node": "^22",
+    "@types/node": "^24",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
+    "kysely-ctl": "^0.21.0",
     "oxfmt": "^0.65.0",
     "oxlint": "^1.80.0",
     "oxlint-plugin-react-doctor": "^0.9.12",
     "tailwindcss": "^4.2.2",
+    "tsx": "^4.23.13",
     "typescript": "^7.0.2",
     "ultracite": "^7.10.7",
-    "vite": "^8.0.3"
+    "vite": "^8.0.3",
+    "vitest": "^5.0.0"
   }
 }

package/template/tsconfig.json

@@ -3,11 +3,12 @@
     "**/*",
     "**/.server/**/*",
     "**/.client/**/*",
-    ".react-router/types/**/*"
+    ".react-router/types/**/*",
+    ".config/*"
   ],
   "compilerOptions": {
     "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
-    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "lib": ["DOM", "DOM.Iterable", "ES2022", "ES2023"],
     "types": ["node", "vite/client"],
     "target": "ES2022",
     "module": "ES2022",

package/template/vendor/kysely-dsql/dsql/adapter.ts

@@ -0,0 +1,15 @@
+// oxlint-disable typescript/no-explicit-any class-methods-use-this require-await
+import { PostgresAdapter } from "kysely";
+import type { MigrationLockOptions } from "kysely";
+
+import type { AnyKysely } from "./types";
+
+export class DQSLAdapter extends PostgresAdapter {
+  async acquireMigrationLock(_db: AnyKysely, _opt: MigrationLockOptions) {
+    console.log("ACQUIRE");
+  }
+  // oxlint-disable-next-line require-await class-methods-use-this
+  async releaseMigrationLock(_db: AnyKysely, _opt: MigrationLockOptions) {
+    console.log("RELEASE");
+  }
+}

package/template/vendor/kysely-dsql/dsql/alter-column-builder.ts

@@ -0,0 +1,105 @@
+// oxlint-disable max-classes-per-file
+import { AlterColumnBuilder, ColumnDefinitionBuilder } from "kysely";
+import type { AlteredColumnBuilder } from "kysely";
+
+/**
+ * Restricts column definition options when adding columns during table alteration.
+ *
+ * Aurora DSQL only allows the IF NOT EXISTS modifier when adding columns.
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLAlterAddColumnDefinitionBuilder extends ColumnDefinitionBuilder {
+  /**
+   * Adds the IF NOT EXISTS clause when adding a column.
+   *
+   * @returns The restricted column definition builder.
+   */
+  declare ifNotExists: () => DSQLAlterAddColumnDefinitionBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare primaryKey: (this: never, ...args: never[]) => never;
+  declare unique: (this: never, ...args: never[]) => never;
+  declare nullsNotDistinct: (this: never, ...args: never[]) => never;
+  declare notNull: (this: never, ...args: never[]) => never;
+  declare defaultTo: (this: never, ...args: never[]) => never;
+  declare check: (this: never, ...args: never[]) => never;
+  declare references: (this: never, ...args: never[]) => never;
+  declare onDelete: (this: never, ...args: never[]) => never;
+  declare onUpdate: (this: never, ...args: never[]) => never;
+  declare autoIncrement: (this: never, ...args: never[]) => never;
+  declare identity: (this: never, ...args: never[]) => never;
+  declare unsigned: (this: never, ...args: never[]) => never;
+  declare generatedAlwaysAs: (this: never, ...args: never[]) => never;
+  declare generatedAlwaysAsIdentity: (this: never, ...args: never[]) => never;
+  declare generatedByDefaultAsIdentity: (
+    this: never,
+    ...args: never[]
+  ) => never;
+  declare stored: (this: never, ...args: never[]) => never;
+  declare modifyFront: (this: never, ...args: never[]) => never;
+  declare modifyEnd: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Callback function to configure a column definition when adding a column to an existing table.
+ */
+export type DSQLAlterAddColumnDefinitionBuilderCallback = (
+  builder: DSQLAlterAddColumnDefinitionBuilder
+) => DSQLAlterAddColumnDefinitionBuilder;
+
+/**
+ * Restricts column alteration options in Aurora DSQL.
+ *
+ * Aurora DSQL supports setting/dropping defaults and dropping NOT NULL constraints.
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLAlterColumnBuilder extends AlterColumnBuilder {
+  /**
+   * Sets a default value for the column.
+   *
+   * @param args - The default value arguments.
+   * @returns The altered column builder.
+   */
+  declare setDefault: (
+    ...args: Parameters<AlterColumnBuilder["setDefault"]>
+  ) => AlteredColumnBuilder;
+
+  /**
+   * Drops the default value from the column.
+   *
+   * @returns The altered column builder.
+   */
+  declare dropDefault: () => AlteredColumnBuilder;
+
+  /**
+   * Drops the NOT NULL constraint from the column.
+   *
+   * @returns The altered column builder.
+   */
+  declare dropNotNull: () => AlteredColumnBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare setNotNull: (this: never, ...args: never[]) => never;
+  declare setDataType: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Callback function to alter an existing column definition.
+ */
+export type DSQLAlterColumnBuilderCallback = (
+  builder: DSQLAlterColumnBuilder
+) => AlteredColumnBuilder;

package/template/vendor/kysely-dsql/dsql/alter-table-builders.ts

@@ -0,0 +1,195 @@
+// oxlint-disable-next-line max-classes-per-file
+import { AlterTableBuilder, AlterTableColumnAlteringBuilder } from "kysely";
+import type { DropColumnBuilderCallback } from "kysely";
+
+import type {
+  DSQLAlterAddColumnDefinitionBuilderCallback,
+  DSQLAlterColumnBuilderCallback,
+} from "./alter-column-builder.js";
+import type { DSQLColumnDataType } from "./create-column-builder.js";
+
+/**
+ * Restricts new column types after an Aurora DSQL table alteration starts.
+ *
+ * This class adds type declarations only. Kysely supplies all runtime behavior.
+ *
+ * @example
+ * ```ts
+ * db.schema.alterTable("person").dropColumn("name").addColumn("name", "text");
+ * ```
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLAlterTableColumnAlteringBuilder extends AlterTableColumnAlteringBuilder {
+  /**
+   * Adds a column with an Aurora DSQL data type.
+   *
+   * @param columnName - The column name.
+   * @param dataType - The Aurora DSQL data type.
+   * @param build - The optional column builder callback.
+   * @returns The restricted table alteration builder.
+   * @example
+   * ```ts
+   * builder.addColumn("name", "text");
+   * ```
+   */
+  declare addColumn: (
+    columnName: string,
+    dataType: DSQLColumnDataType,
+    build?: DSQLAlterAddColumnDefinitionBuilderCallback
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Alters a column and keeps the restricted builder.
+   *
+   * @param column - The column name.
+   * @param alteration - The column alteration callback.
+   * @returns The restricted table alteration builder.
+   * @example
+   * ```ts
+   * builder.alterColumn("name", (column) => column.dropNotNull());
+   * ```
+   */
+  declare alterColumn: (
+    column: string,
+    alteration: DSQLAlterColumnBuilderCallback
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Drops a column and keeps the restricted builder.
+   *
+   * @param column - The column name.
+   * @param build - Optional drop column callback.
+   * @returns The restricted table alteration builder.
+   * @example
+   * ```ts
+   * builder.dropColumn("legacy_name");
+   * ```
+   */
+  declare dropColumn: (
+    column: string,
+    build?: DropColumnBuilderCallback
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Renames a column and keeps the restricted builder.
+   *
+   * @param column - The current column name.
+   * @param newColumn - The new column name.
+   * @returns The restricted table alteration builder.
+   * @example
+   * ```ts
+   * builder.renameColumn("old_name", "new_name");
+   * ```
+   */
+  declare renameColumn: (
+    column: string,
+    newColumn: string
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare modifyColumn: (this: never, ...args: never[]) => never;
+  declare addForeignKeyConstraint: (this: never, ...args: never[]) => never;
+  declare addPrimaryKeyConstraint: (this: never, ...args: never[]) => never;
+  declare addUniqueConstraint: (this: never, ...args: never[]) => never;
+  declare addIndex: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Restricts new column types for an Aurora DSQL table alteration.
+ *
+ * This class adds type declarations only. Kysely supplies all runtime behavior.
+ *
+ * @example
+ * ```ts
+ * db.schema.alterTable("person").addColumn("name", "text");
+ * ```
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLAlterTableBuilder extends AlterTableBuilder {
+  /**
+   * Adds a column with an Aurora DSQL data type.
+   *
+   * @param columnName - The column name.
+   * @param dataType - The Aurora DSQL data type.
+   * @param build - The optional column builder callback.
+   * @returns The restricted column alteration builder.
+   * @example
+   * ```ts
+   * builder.addColumn("name", "text");
+   * ```
+   */
+  declare addColumn: (
+    columnName: string,
+    dataType: DSQLColumnDataType,
+    build?: DSQLAlterAddColumnDefinitionBuilderCallback
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Alters a column and returns the restricted builder.
+   *
+   * @param column - The column name.
+   * @param alteration - The column alteration callback.
+   * @returns The restricted column alteration builder.
+   * @example
+   * ```ts
+   * builder.alterColumn("name", (column) => column.dropNotNull());
+   * ```
+   */
+  declare alterColumn: (
+    column: string,
+    alteration: DSQLAlterColumnBuilderCallback
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Drops a column and returns the restricted builder.
+   *
+   * @param column - The column name.
+   * @param build - Optional drop column callback.
+   * @returns The restricted column alteration builder.
+   * @example
+   * ```ts
+   * builder.dropColumn("legacy_name");
+   * ```
+   */
+  declare dropColumn: (
+    column: string,
+    build?: DropColumnBuilderCallback
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Renames a column and returns the restricted builder.
+   *
+   * @param column - The current column name.
+   * @param newColumn - The new column name.
+   * @returns The restricted column alteration builder.
+   * @example
+   * ```ts
+   * builder.renameColumn("old_name", "new_name");
+   * ```
+   */
+  declare renameColumn: (
+    column: string,
+    newColumn: string
+  ) => DSQLAlterTableColumnAlteringBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare modifyColumn: (this: never, ...args: never[]) => never;
+  declare addForeignKeyConstraint: (this: never, ...args: never[]) => never;
+  declare addPrimaryKeyConstraint: (this: never, ...args: never[]) => never;
+  declare addUniqueConstraint: (this: never, ...args: never[]) => never;
+  declare addIndex: (this: never, ...args: never[]) => never;
+}