acrylblends 0.3.0 → 0.4.0

package/plugins/acryl-router/src/core/helper/factory/index.ts

@@ -0,0 +1,375 @@
+/**
+ * @module
+ * Factory Helper for App.
+ */
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { App } from '../../app.ts'
+import type { AppOptions } from '../../app-base.ts'
+import type {
+  Env,
+  H,
+  HandlerResponse,
+  Input,
+  IntersectNonAnyTypes,
+  MiddlewareHandler,
+} from '../../types.ts'
+
+type InitApp<E extends Env = Env> = (app: App<E>) => void
+
+export interface CreateHandlersInterface<E extends Env, P extends string> {
+  <I extends Input = {}, R extends HandlerResponse<any> = any, E2 extends Env = E>(
+    handler1: H<E2, P, I, R>
+  ): [H<E2, P, I, R>]
+
+  // handler x2
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>
+  ): [H<E2, P, I, R>, H<E3, P, I2, R2>]
+
+  // handler x3
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>
+  ): [H<E2, P, I, R>, H<E3, P, I2, R2>, H<E4, P, I3, R3>]
+
+  // handler x4
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>
+  ): [H<E2, P, I, R>, H<E3, P, I2, R2>, H<E4, P, I3, R3>, H<E5, P, I4, R4>]
+
+  // handler x5
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    I5 extends Input = I & I2 & I3 & I4,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    R5 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+    E6 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>,
+    handler5: H<E6, P, I5, R5>
+  ): [H<E2, P, I, R>, H<E3, P, I2, R2>, H<E4, P, I3, R3>, H<E5, P, I4, R4>, H<E6, P, I5, R5>]
+
+  // handler x6
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    I5 extends Input = I & I2 & I3 & I4,
+    I6 extends Input = I & I2 & I3 & I4 & I5,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    R5 extends HandlerResponse<any> = any,
+    R6 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+    E6 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5]>,
+    E7 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>,
+    handler5: H<E6, P, I5, R5>,
+    handler6: H<E7, P, I6, R6>
+  ): [
+    H<E2, P, I, R>,
+    H<E3, P, I2, R2>,
+    H<E4, P, I3, R3>,
+    H<E5, P, I4, R4>,
+    H<E6, P, I5, R5>,
+    H<E7, P, I6, R6>,
+  ]
+
+  // handler x7
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    I5 extends Input = I & I2 & I3 & I4,
+    I6 extends Input = I & I2 & I3 & I4 & I5,
+    I7 extends Input = I & I2 & I3 & I4 & I5 & I6,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    R5 extends HandlerResponse<any> = any,
+    R6 extends HandlerResponse<any> = any,
+    R7 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+    E6 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5]>,
+    E7 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6]>,
+    E8 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>,
+    handler5: H<E6, P, I5, R5>,
+    handler6: H<E7, P, I6, R6>,
+    handler7: H<E8, P, I7, R7>
+  ): [
+    H<E2, P, I, R>,
+    H<E3, P, I2, R2>,
+    H<E4, P, I3, R3>,
+    H<E5, P, I4, R4>,
+    H<E6, P, I5, R5>,
+    H<E7, P, I6, R6>,
+    H<E8, P, I7, R7>,
+  ]
+
+  // handler x8
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    I5 extends Input = I & I2 & I3 & I4,
+    I6 extends Input = I & I2 & I3 & I4 & I5,
+    I7 extends Input = I & I2 & I3 & I4 & I5 & I6,
+    I8 extends Input = I & I2 & I3 & I4 & I5 & I6 & I7,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    R5 extends HandlerResponse<any> = any,
+    R6 extends HandlerResponse<any> = any,
+    R7 extends HandlerResponse<any> = any,
+    R8 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+    E6 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5]>,
+    E7 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6]>,
+    E8 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7]>,
+    E9 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7, E8]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>,
+    handler5: H<E6, P, I5, R5>,
+    handler6: H<E7, P, I6, R6>,
+    handler7: H<E8, P, I7, R7>,
+    handler8: H<E9, P, I8, R8>
+  ): [
+    H<E2, P, I, R>,
+    H<E3, P, I2, R2>,
+    H<E4, P, I3, R3>,
+    H<E5, P, I4, R4>,
+    H<E6, P, I5, R5>,
+    H<E7, P, I6, R6>,
+    H<E8, P, I7, R7>,
+    H<E9, P, I8, R8>,
+  ]
+
+  // handler x9
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    I5 extends Input = I & I2 & I3 & I4,
+    I6 extends Input = I & I2 & I3 & I4 & I5,
+    I7 extends Input = I & I2 & I3 & I4 & I5 & I6,
+    I8 extends Input = I & I2 & I3 & I4 & I5 & I6 & I7,
+    I9 extends Input = I & I2 & I3 & I4 & I5 & I6 & I7 & I8,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    R5 extends HandlerResponse<any> = any,
+    R6 extends HandlerResponse<any> = any,
+    R7 extends HandlerResponse<any> = any,
+    R8 extends HandlerResponse<any> = any,
+    R9 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+    E6 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5]>,
+    E7 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6]>,
+    E8 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7]>,
+    E9 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7, E8]>,
+    E10 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7, E8, E9]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>,
+    handler5: H<E6, P, I5, R5>,
+    handler6: H<E7, P, I6, R6>,
+    handler7: H<E8, P, I7, R7>,
+    handler8: H<E9, P, I8, R8>,
+    handler9: H<E10, P, I9, R9>
+  ): [
+    H<E2, P, I, R>,
+    H<E3, P, I2, R>,
+    H<E4, P, I3, R>,
+    H<E5, P, I4, R>,
+    H<E6, P, I5, R>,
+    H<E7, P, I6, R>,
+    H<E8, P, I7, R>,
+    H<E9, P, I8, R>,
+    H<E10, P, I9, R>,
+  ]
+
+  // handler x10
+  <
+    I extends Input = {},
+    I2 extends Input = I,
+    I3 extends Input = I & I2,
+    I4 extends Input = I & I2 & I3,
+    I5 extends Input = I & I2 & I3 & I4,
+    I6 extends Input = I & I2 & I3 & I4 & I5,
+    I7 extends Input = I & I2 & I3 & I4 & I5 & I6,
+    I8 extends Input = I & I2 & I3 & I4 & I5 & I6 & I7,
+    I9 extends Input = I & I2 & I3 & I4 & I5 & I6 & I7 & I8,
+    I10 extends Input = I & I2 & I3 & I4 & I5 & I6 & I7 & I8 & I9,
+    R extends HandlerResponse<any> = any,
+    R2 extends HandlerResponse<any> = any,
+    R3 extends HandlerResponse<any> = any,
+    R4 extends HandlerResponse<any> = any,
+    R5 extends HandlerResponse<any> = any,
+    R6 extends HandlerResponse<any> = any,
+    R7 extends HandlerResponse<any> = any,
+    R8 extends HandlerResponse<any> = any,
+    R9 extends HandlerResponse<any> = any,
+    R10 extends HandlerResponse<any> = any,
+    E2 extends Env = E,
+    E3 extends Env = IntersectNonAnyTypes<[E, E2]>,
+    E4 extends Env = IntersectNonAnyTypes<[E, E2, E3]>,
+    E5 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4]>,
+    E6 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5]>,
+    E7 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6]>,
+    E8 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7]>,
+    E9 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7, E8]>,
+    E10 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7, E8, E9]>,
+    E11 extends Env = IntersectNonAnyTypes<[E, E2, E3, E4, E5, E6, E7, E8, E9, E10]>,
+  >(
+    handler1: H<E2, P, I, R>,
+    handler2: H<E3, P, I2, R2>,
+    handler3: H<E4, P, I3, R3>,
+    handler4: H<E5, P, I4, R4>,
+    handler5: H<E6, P, I5, R5>,
+    handler6: H<E7, P, I6, R6>,
+    handler7: H<E8, P, I7, R7>,
+    handler8: H<E9, P, I8, R8>,
+    handler9: H<E10, P, I9, R9>,
+    handler10: H<E11, P, I10, R10>
+  ): [
+    H<E2, P, I, R>,
+    H<E3, P, I2, R2>,
+    H<E4, P, I3, R3>,
+    H<E5, P, I4, R4>,
+    H<E6, P, I5, R5>,
+    H<E7, P, I6, R6>,
+    H<E8, P, I7, R7>,
+    H<E9, P, I8, R8>,
+    H<E10, P, I9, R9>,
+    H<E11, P, I10, R10>,
+  ]
+}
+
+export class Factory<E extends Env = Env, P extends string = string> {
+  private initApp?: InitApp<E>
+  #defaultAppOptions?: AppOptions<E>
+
+  constructor(init?: { initApp?: InitApp<E>; defaultAppOptions?: AppOptions<E> }) {
+    this.initApp = init?.initApp
+    this.#defaultAppOptions = init?.defaultAppOptions
+  }
+
+  createApp = (options?: AppOptions<E>): App<E> => {
+    const app = new App<E>(
+      (options && this.#defaultAppOptions
+        ? { ...this.#defaultAppOptions, ...options }
+        : (options ?? this.#defaultAppOptions)) as AppOptions<E>
+    )
+    if (this.initApp) {
+      this.initApp(app)
+    }
+    return app
+  }
+
+  createMiddleware = <I extends Input = {}, R extends HandlerResponse<any> | void = void>(
+    middleware: MiddlewareHandler<E, P, I, R extends void ? Response : R>
+  ): MiddlewareHandler<E, P, I, R extends void ? Response : R> => middleware
+
+  createHandlers: CreateHandlersInterface<E, P> = (...handlers: any) => {
+    // @ts-expect-error this should not be typed
+    return handlers.filter((handler) => handler !== undefined)
+  }
+}
+
+export const createFactory = <E extends Env = Env, P extends string = string>(init?: {
+  initApp?: InitApp<E>
+  defaultAppOptions?: AppOptions<E>
+}): Factory<E, P> => new Factory<E, P>(init)
+
+export const createMiddleware = <
+  E extends Env = any,
+  P extends string = string,
+  I extends Input = {},
+  R extends HandlerResponse<any> | void = void,
+>(
+  middleware: MiddlewareHandler<E, P, I, R extends void ? Response : R>
+): MiddlewareHandler<E, P, I, R extends void ? Response : R> => middleware

package/plugins/acryl-router/src/core/helper/html/index.test.ts

@@ -0,0 +1,78 @@
+import { html, raw } from './index.ts'
+import { HtmlEscapedCallbackPhase, resolveCallback } from '../../utils/html.ts'
+
+describe('Tagged Template Literals', () => {
+  it('Should escape special characters', () => {
+    const name = 'John "Johnny" Smith'
+
+    expect(html`<p>I'm ${name}.</p>`.toString()).toBe("<p>I'm John &quot;Johnny&quot; Smith.</p>")
+  })
+
+  describe('Booleans, Null, and Undefined Are Ignored', () => {
+    it.each([true, false, undefined, null])('%s', (item) => {
+      expect(html`${item}`.toString()).toBe('')
+    })
+
+    it('falsy value', () => {
+      expect(html`${0}`.toString()).toBe('0')
+    })
+  })
+
+  it('Should call $array.flat(Infinity)', () => {
+    const values = [
+      'Name:',
+      ['John "Johnny" Smith', undefined, null],
+      ' Contact:',
+      [html`<a href="http://example.com/">My Website</a>`],
+    ]
+    expect(html`<p>${values}</p>`.toString()).toBe(
+      '<p>Name:John &quot;Johnny&quot; Smith Contact:<a href="http://example.com/">My Website</a></p>'
+    )
+  })
+
+  describe('Promise', () => {
+    it('Should return Promise<string> when some variables contains Promise<string> in variables', async () => {
+      const name = Promise.resolve('John "Johnny" Smith')
+      const res = html`<p>I'm ${name}.</p>`
+      expect(res).toBeInstanceOf(Promise)
+
+      expect((await res).toString()).toBe("<p>I'm John &quot;Johnny&quot; Smith.</p>")
+    })
+
+    it('Should return raw value when some variables contains Promise<HtmlEscapedString> in variables', async () => {
+      const name = Promise.resolve(raw('John "Johnny" Smith'))
+      const res = html`<p>I'm ${name}.</p>`
+      expect(res).toBeInstanceOf(Promise)
+      expect((await res).toString()).toBe('<p>I\'m John "Johnny" Smith.</p>')
+    })
+  })
+
+  describe('HtmlEscapedString', () => {
+    it('Should preserve callbacks', async () => {
+      const name = raw('App', [
+        ({ buffer }) => {
+          if (buffer) {
+            buffer[0] = buffer[0].replace('App', 'App!')
+          }
+          return undefined
+        },
+      ])
+      const res = html`<p>I'm ${name}.</p>`
+      expect(res).toBeInstanceOf(Promise)
+
+      expect((await res).toString()).toBe("<p>I'm App.</p>")
+      expect(await resolveCallback(await res, HtmlEscapedCallbackPhase.Stringify, false, {})).toBe(
+        "<p>I'm App!.</p>"
+      )
+    })
+  })
+})
+
+describe('raw', () => {
+  it('Should be marked as escaped.', () => {
+    const name = 'John &quot;Johnny&quot; Smith'
+    expect(html`<p>I'm ${raw(name)}.</p>`.toString()).toBe(
+      "<p>I'm John &quot;Johnny&quot; Smith.</p>"
+    )
+  })
+})

package/plugins/acryl-router/src/core/helper/html/index.ts

@@ -0,0 +1,57 @@
+/**
+ * @module
+ * html Helper for App.
+ */
+
+import { escapeToBuffer, raw, resolveCallbackSync, stringBufferToString } from '../../utils/html.ts'
+import type { HtmlEscaped, HtmlEscapedString, StringBufferWithCallbacks } from '../../utils/html.ts'
+
+export { raw }
+
+export const html = (
+  strings: TemplateStringsArray,
+  ...values: unknown[]
+): HtmlEscapedString | Promise<HtmlEscapedString> => {
+  const buffer: StringBufferWithCallbacks = [''] as StringBufferWithCallbacks
+
+  for (let i = 0, len = strings.length - 1; i < len; i++) {
+    buffer[0] += strings[i]
+
+    const children = Array.isArray(values[i])
+      ? (values[i] as Array<unknown>).flat(Infinity)
+      : [values[i]]
+    for (let i = 0, len = children.length; i < len; i++) {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const child = children[i] as any
+      if (typeof child === 'string') {
+        escapeToBuffer(child, buffer)
+      } else if (typeof child === 'number') {
+        ;(buffer[0] as string) += child
+      } else if (typeof child === 'boolean' || child === null || child === undefined) {
+        continue
+      } else if (typeof child === 'object' && (child as HtmlEscaped).isEscaped) {
+        if ((child as HtmlEscapedString).callbacks) {
+          buffer.unshift('', child)
+        } else {
+          const tmp = child.toString()
+          if (tmp instanceof Promise) {
+            buffer.unshift('', tmp)
+          } else {
+            buffer[0] += tmp
+          }
+        }
+      } else if (child instanceof Promise) {
+        buffer.unshift('', child)
+      } else {
+        escapeToBuffer(child.toString(), buffer)
+      }
+    }
+  }
+  buffer[0] += strings.at(-1) as string
+
+  return buffer.length === 1
+    ? 'callbacks' in buffer
+      ? raw(resolveCallbackSync(raw(buffer[0], buffer.callbacks)))
+      : raw(buffer[0])
+    : stringBufferToString(buffer, buffer.callbacks)
+}