create-monolayer-app 0.1.2 → 0.2.1

package/template/vendor/kysely-dsql/dsql/index-view-builders.ts

@@ -0,0 +1,206 @@
+// oxlint-disable-next-line max-classes-per-file
+import {
+  CreateIndexBuilder,
+  CreateViewBuilder,
+  DropIndexBuilder,
+  DropTableBuilder,
+} from "kysely";
+import type { RawBuilder, SelectQueryBuilder } from "kysely";
+
+import type { DSQLIndexColumnName } from "./create-column-builder.js";
+
+/**
+ * Restricts index creation options for Aurora DSQL.
+ *
+ * Aurora DSQL requires asynchronous index creation and rejects WHERE, USING, and sort directions.
+ *
+ * @template C - The indexed column names.
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLCreateIndexBuilder<C = never> extends CreateIndexBuilder<C> {
+  /**
+   * Adds the IF NOT EXISTS clause.
+   *
+   * @returns The restricted index builder.
+   */
+  // @ts-expect-error DSQLCreateIndexBuilder restricts index column names and expressions for Aurora DSQL.
+  declare ifNotExists: () => DSQLCreateIndexBuilder<C>;
+
+  /**
+   * Makes the index unique.
+   *
+   * @returns The restricted index builder.
+   */
+  // @ts-expect-error DSQLCreateIndexBuilder restricts index column names and expressions for Aurora DSQL.
+  declare unique: () => DSQLCreateIndexBuilder<C>;
+
+  /**
+   * Adds the NULLS NOT DISTINCT specifier.
+   *
+   * @returns The restricted index builder.
+   */
+  // @ts-expect-error DSQLCreateIndexBuilder restricts index column names and expressions for Aurora DSQL.
+  declare nullsNotDistinct: () => DSQLCreateIndexBuilder<C>;
+
+  /**
+   * Specifies the target table for the index.
+   *
+   * @param table - The table name.
+   * @returns The restricted index builder.
+   */
+  // @ts-expect-error DSQLCreateIndexBuilder restricts index column names and expressions for Aurora DSQL.
+  declare on: (table: string) => DSQLCreateIndexBuilder<C>;
+
+  /**
+   * Adds a column name to the index.
+   *
+   * @param column - The column name without sort direction.
+   * @returns The restricted index builder with the new column.
+   */
+  // @ts-expect-error DSQLCreateIndexBuilder restricts index column names and expressions for Aurora DSQL.
+  declare column: <CL extends string>(
+    column: DSQLIndexColumnName<CL>
+  ) => DSQLCreateIndexBuilder<C | CL>;
+
+  /**
+   * Adds multiple column names to the index.
+   *
+   * @param columns - The array of column names without sort directions.
+   * @returns The restricted index builder with the added columns.
+   */
+  // @ts-expect-error DSQLCreateIndexBuilder restricts index column names and expressions for Aurora DSQL.
+  declare columns: <CL extends string>(
+    columns: DSQLIndexColumnName<CL>[]
+  ) => DSQLCreateIndexBuilder<C | CL>;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare where: (this: never, ...args: never[]) => never;
+  declare using: (this: never, ...args: never[]) => never;
+  declare expression: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Restricts view creation options for Aurora DSQL.
+ *
+ * Aurora DSQL supports CREATE VIEW and CREATE OR REPLACE VIEW.
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLCreateViewBuilder extends CreateViewBuilder {
+  /**
+   * Adds the OR REPLACE clause.
+   *
+   * @returns The restricted view builder.
+   */
+  declare orReplace: () => DSQLCreateViewBuilder;
+
+  /**
+   * Specifies column names for the view.
+   *
+   * @param columns - The list of view column names.
+   * @returns The restricted view builder.
+   */
+  declare columns: (columns: string[]) => DSQLCreateViewBuilder;
+
+  /**
+   * Specifies the underlying query that creates the view.
+   *
+   * @param query - The select query or raw SQL expression.
+   * @returns The restricted view builder.
+   */
+  declare as: (
+    // SAFETY: Universal query types accept any select or raw query shape.
+    // oxlint-disable-next-line typescript/no-explicit-any
+    query: SelectQueryBuilder<any, any, any> | RawBuilder<any>
+  ) => DSQLCreateViewBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare temporary: (this: never, ...args: never[]) => never;
+  declare materialized: (this: never, ...args: never[]) => never;
+  declare ifNotExists: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Restricts drop index options for Aurora DSQL.
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLDropIndexBuilder extends DropIndexBuilder {
+  /**
+   * Adds the IF EXISTS clause.
+   *
+   * @returns The restricted drop index builder.
+   */
+  declare ifExists: () => DSQLDropIndexBuilder;
+
+  /**
+   * Adds the CASCADE clause.
+   *
+   * @returns The restricted drop index builder.
+   */
+  declare cascade: () => DSQLDropIndexBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare on: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Restricts drop table options for Aurora DSQL.
+ */
+// eslint-disable-next-line max-classes-per-file
+export class DSQLDropTableBuilder extends DropTableBuilder {
+  /**
+   * Adds the IF EXISTS clause.
+   *
+   * @returns The restricted drop table builder.
+   */
+  declare ifExists: () => DSQLDropTableBuilder;
+
+  /**
+   * Adds the CASCADE clause.
+   *
+   * @returns The restricted drop table builder.
+   */
+  declare cascade: () => DSQLDropTableBuilder;
+
+  /**
+   * Calls a custom transformation function.
+   *
+   * @param func - The transformation callback.
+   * @returns The callback result.
+   */
+  declare $call: <T>(func: (qb: this) => T) => T;
+
+  declare temporary: (this: never, ...args: never[]) => never;
+}
+
+/**
+ * Restricts table creation builders for Aurora DSQL.
+ *
+ * @template TB - The table name.
+ * @template C - The column names in the builder.
+ * @example
+ * ```ts
+ * db.schema.createTable("person").addColumn("id", "uuid");
+ * ```
+ */
+// eslint-disable-next-line max-classes-per-file

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

@@ -0,0 +1,40 @@
+import {
+  AuroraDSQLPool,
+  type AuroraDSQLPoolConfig,
+} from "@aws/aurora-dsql-node-postgres-connector";
+
+/**
+ * Options for creating an Aurora DSQL Kysely client.
+ */
+export interface CreateDSQLKyselyOptions {
+  /** The Aurora DSQL cluster endpoint (host). */
+  readonly clusterEndpoint: string;
+  /** Optional Aurora DSQL client options. */
+  readonly clientOptions?:
+    | {
+        /**
+         * The caller-supplied AWS credential identity or provider for a production connection.
+         * The caller selects the AWS profile and creates the provider.
+         */
+        readonly credentialsProvider?: AuroraDSQLPoolConfig["customCredentialsProvider"];
+        readonly region?: string | undefined;
+        readonly role?: string | undefined;
+      }
+    | undefined;
+}
+
+export const createDSQLPool = (
+  clusterEndpoint: string,
+  clientOptions?: CreateDSQLKyselyOptions["clientOptions"]
+): AuroraDSQLPool =>
+  new AuroraDSQLPool({
+    // SAFETY: An undefined value keeps the connector default credential chain.
+    customCredentialsProvider:
+      clientOptions?.credentialsProvider as NonNullable<
+        AuroraDSQLPoolConfig["customCredentialsProvider"]
+      >,
+    host: clusterEndpoint,
+    user: clientOptions?.role ?? "admin",
+    max: 3,
+    idleTimeoutMillis: 60_000,
+  });

package/template/vendor/kysely-dsql/dsql/query-compiler-error.ts

@@ -0,0 +1,18 @@
+import type { DSQLValidationIssue } from "./query-validation.js";
+
+const formatIssueMessage = (issues: readonly DSQLValidationIssue[]): string =>
+  issues.map((issue) => `[${issue.code}] ${issue.message}`).join("; ");
+
+/**
+ * Thrown when a SQL query or operation node violates Amazon Aurora DSQL compatibility rules.
+ */
+export class DSQLQueryCompilerError extends Error {
+  readonly issues: readonly DSQLValidationIssue[];
+
+  constructor(issues: readonly DSQLValidationIssue[]) {
+    const summary = formatIssueMessage(issues);
+    super(`Aurora DSQL query compilation failed: ${summary}`);
+    this.name = "DSQLQueryCompilerError";
+    this.issues = issues;
+  }
+}