betterstart-cli 0.0.102 → 0.0.104

package/dist/assets/adapters/next/templates/renderers/generators/database/generate-junction-table.ts

@@ -0,0 +1,27 @@
+export function renderJunctionTableGeneratedValueTemplate({
+  toCamelCase,
+  junctionPascal,
+  schemaIdCol,
+  schemaTableRef,
+  relationIdCol,
+  relationIdType,
+  relationTableRef
+}: {
+  toCamelCase: string
+  junctionPascal: string
+  schemaIdCol: string
+  schemaTableRef: string
+  relationIdCol: string
+  relationIdType: string
+  relationTableRef: string
+}): string {
+  return `export const ${toCamelCase} = pgTable(
+  '${junctionPascal}',
+  {
+    ${schemaIdCol}: uuid().notNull().references(() => ${schemaTableRef}.id, { onDelete: 'cascade' }),
+    ${relationIdCol}: ${relationIdType}().notNull().references(() => ${relationTableRef}.id, { onDelete: 'cascade' })
+  },
+  (table) => [primaryKey({ columns: [table.${schemaIdCol}, table.${relationIdCol}] })]
+)
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/database/generate-select-options-table.ts

@@ -0,0 +1,35 @@
+export function renderSelectOptionsTableGeneratedValueTemplate({
+  variableName,
+  tableName,
+  indexName
+}: {
+  variableName: string
+  tableName: string
+  indexName: string
+}): string {
+  return `export const ${variableName} = pgTable(
+  '${tableName}',
+  {
+    id: uuid().defaultRandom().primaryKey().notNull(),
+    fieldName: varchar('fieldName', { length: 100 }).notNull(),
+    label: varchar('label', { length: 255 }).notNull(),
+    value: varchar('value', { length: 255 }).notNull(),
+    createdAt: timestamp('createdAt', { precision: 3, mode: 'string' })
+      .default(sql\`CURRENT_TIMESTAMP\`)
+      .notNull(),
+    updatedAt: timestamp('updatedAt', { precision: 3, mode: 'string' })
+      .default(sql\`CURRENT_TIMESTAMP\`)
+      .notNull(),
+    createdBy: text('createdBy').references(() => user.id, { onDelete: 'set null' }),
+    updatedBy: text('updatedBy').references(() => user.id, { onDelete: 'set null' })
+  },
+  (table) => [
+    uniqueIndex('${indexName}').using(
+      'btree',
+      table.fieldName.asc().nullsLast().op('text_ops'),
+      table.value.asc().nullsLast().op('text_ops')
+    )
+  ]
+)
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/database/generate-table-definition.ts

@@ -0,0 +1,25 @@
+export function renderTableDefinitionGeneratedValueTemplate({
+  variableName,
+  tableName,
+  fieldDefs,
+  publishedField,
+  generatedFields,
+  sortOrderField,
+  indexes
+}: {
+  variableName: string
+  tableName: string
+  fieldDefs: string
+  publishedField: string
+  generatedFields: string
+  sortOrderField: string
+  indexes: string
+}): string {
+  return `export const ${variableName} = pgTable(
+  '${tableName}',
+  {
+${fieldDefs}${publishedField}${generatedFields}${sortOrderField}
+  }${indexes}
+)
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/dev-mode-integration/build-entity-dev-mode-snippets.ts

@@ -0,0 +1,180 @@
+export function renderBuildEntityDevModeSnippetsImportsTemplate({
+  singular,
+  actionModulePath,
+  camelSingular
+}: {
+  singular: string
+  actionModulePath: string
+  camelSingular: string
+}): string {
+  return `import { get${singular}ById } from '${actionModulePath}'
+
+export default async function ${singular}Detail({ id }: { id: string }) {
+  const ${camelSingular} = await get${singular}ById(id)
+
+  if (!${camelSingular}) {
+    return null
+  }
+
+  return <pre>{JSON.stringify(${camelSingular}, null, 2)}</pre>
+}
+`
+}
+
+export function renderBuildEntityDevModeSnippetsImportsDetailsTemplate({
+  singular,
+  actionModulePath,
+  camelSingular
+}: {
+  singular: string
+  actionModulePath: string
+  camelSingular: string
+}): string {
+  return `import { get${singular}BySlug } from '${actionModulePath}'
+
+export default async function ${singular}Detail({ slug }: { slug: string }) {
+  const ${camelSingular} = await get${singular}BySlug(slug)
+
+  if (!${camelSingular}) {
+    return null
+  }
+
+  return <pre>{JSON.stringify(${camelSingular}, null, 2)}</pre>
+}
+`
+}
+
+export function renderBuildEntityDevModeSnippetsImportsLabelTemplate({
+  plural,
+  actionModulePath,
+  camelPlural,
+  toLowerCase
+}: {
+  plural: string
+  actionModulePath: string
+  camelPlural: string
+  toLowerCase: string
+}): string {
+  return `import { get${plural} } from '${actionModulePath}'
+
+export default async function ${plural}List() {
+  const { ${camelPlural}, total } = await get${plural}({ limit: 10, offset: 0 })
+
+  return (
+    <section>
+      <h2>{total} ${toLowerCase}</h2>
+      <pre>{JSON.stringify(${camelPlural}, null, 2)}</pre>
+    </section>
+  )
+}
+`
+}
+
+export function renderBuildEntityDevModeSnippetsClientModuleTemplate({
+  singular,
+  actionModulePath,
+  tsObject,
+  toLowerCase
+}: {
+  singular: string
+  actionModulePath: string
+  tsObject: string
+  toLowerCase: string
+}): string {
+  return `'use client'
+
+import * as React from 'react'
+import { create${singular}, type ${singular}CreateInput } from '${actionModulePath}'
+
+const input: ${singular}CreateInput = ${tsObject}
+
+export function Create${singular}Button() {
+  const [isPending, startTransition] = React.useTransition()
+
+  return (
+    <button
+      type="button"
+      disabled={isPending}
+      onClick={() => {
+        startTransition(async () => {
+          await create${singular}(input)
+        })
+      }}
+    >
+      Create ${toLowerCase}
+    </button>
+  )
+}
+`
+}
+
+export function renderBuildEntityDevModeSnippetsClientModuleSampleTemplate({
+  singular,
+  actionModulePath,
+  tsObject,
+  toLowerCase
+}: {
+  singular: string
+  actionModulePath: string
+  tsObject: string
+  toLowerCase: string
+}): string {
+  return `'use client'
+
+import * as React from 'react'
+import { update${singular}, type ${singular}UpdateInput } from '${actionModulePath}'
+
+export function Update${singular}Button({ id }: { id: string }) {
+  const [isPending, startTransition] = React.useTransition()
+  const input: ${singular}UpdateInput = ${tsObject}
+
+  return (
+    <button
+      type="button"
+      disabled={isPending}
+      onClick={() => {
+        startTransition(async () => {
+          await update${singular}(input)
+        })
+      }}
+    >
+      Update ${toLowerCase}
+    </button>
+  )
+}
+`
+}
+
+export function renderBuildEntityDevModeSnippetsClientModuleDetailsTemplate({
+  singular,
+  actionModulePath,
+  toLowerCase
+}: {
+  singular: string
+  actionModulePath: string
+  toLowerCase: string
+}): string {
+  return `'use client'
+
+import * as React from 'react'
+import { delete${singular} } from '${actionModulePath}'
+
+export function Delete${singular}Button({ id }: { id: string }) {
+  const [isPending, startTransition] = React.useTransition()
+
+  return (
+    <button
+      type="button"
+      disabled={isPending}
+      onClick={() => {
+        startTransition(async () => {
+          await delete${singular}(id)
+        })
+      }}
+    >
+      Delete ${toLowerCase}
+    </button>
+  )
+}
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/dev-mode-integration/build-form-dev-mode-snippets.ts

@@ -0,0 +1,97 @@
+export function renderBuildFormDevModeSnippetsClientModuleTemplate({
+  pascal,
+  actionModulePath,
+  tsObject,
+  toLowerCase
+}: {
+  pascal: string
+  actionModulePath: string
+  tsObject: string
+  toLowerCase: string
+}): string {
+  return `'use client'
+
+import * as React from 'react'
+import {
+  create${pascal}Submission,
+  type Create${pascal}SubmissionInput
+} from '${actionModulePath}'
+
+const input: Create${pascal}SubmissionInput = ${tsObject}
+
+export function ${pascal}SubmitButton() {
+  const [isPending, startTransition] = React.useTransition()
+
+  return (
+    <button
+      type="button"
+      disabled={isPending}
+      onClick={() => {
+        startTransition(async () => {
+          await create${pascal}Submission(input)
+        })
+      }}
+    >
+      Submit ${toLowerCase}
+    </button>
+  )
+}
+`
+}
+
+export function renderBuildFormDevModeSnippetsImportsTemplate({
+  pascal,
+  actionModulePath,
+  toLowerCase
+}: {
+  pascal: string
+  actionModulePath: string
+  toLowerCase: string
+}): string {
+  return `import { get${pascal}Submissions } from '${actionModulePath}'
+
+export default async function ${pascal}Submissions() {
+  const { submissions, total } = await get${pascal}Submissions({ limit: 10, offset: 0 })
+
+  return (
+    <section>
+      <h2>{total} ${toLowerCase} submissions</h2>
+      <pre>{JSON.stringify(submissions, null, 2)}</pre>
+    </section>
+  )
+}
+`
+}
+
+export function renderBuildFormDevModeSnippetsClientModuleDetailsTemplate({
+  pascal,
+  actionModulePath
+}: {
+  pascal: string
+  actionModulePath: string
+}): string {
+  return `'use client'
+
+import * as React from 'react'
+import { delete${pascal}Submission } from '${actionModulePath}'
+
+import { DEFAULT_ADMIN_IMPORT_ALIAS, ENTITY_ACTION_FIELD_EXCLUSIONS, SAMPLE_FORMATTED_TIMESTAMP, SAMPLE_UUID, SINGLETON_ID, SINGLE_ACTION_FIELD_EXCLUSIONS } from '@cli-constants/generators.js'
+export function Delete${pascal}SubmissionButton({ id }: { id: string }) {
+  const [isPending, startTransition] = React.useTransition()
+
+  return (
+    <button
+      type="button"
+      disabled={isPending}
+      onClick={() => {
+        startTransition(async () => {
+          await delete${pascal}Submission(id)
+        })
+      }}
+    >
+      Delete submission
+    </button>
+  )
+}
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/dev-mode-integration/build-single-dev-mode-snippets.ts

@@ -0,0 +1,60 @@
+export function renderBuildSingleDevModeSnippetsImportsTemplate({
+  singular,
+  actionModulePath,
+  camelSingular
+}: {
+  singular: string
+  actionModulePath: string
+  camelSingular: string
+}): string {
+  return `import { get${singular} } from '${actionModulePath}'
+
+export default async function ${singular}Summary() {
+  const ${camelSingular} = await get${singular}()
+
+  if (!${camelSingular}) {
+    return null
+  }
+
+  return <pre>{JSON.stringify(${camelSingular}, null, 2)}</pre>
+}
+`
+}
+
+export function renderBuildSingleDevModeSnippetsClientModuleTemplate({
+  singular,
+  actionModulePath,
+  tsObject,
+  toLowerCase
+}: {
+  singular: string
+  actionModulePath: string
+  tsObject: string
+  toLowerCase: string
+}): string {
+  return `'use client'
+
+import * as React from 'react'
+import { upsert${singular}, type ${singular}UpsertInput } from '${actionModulePath}'
+
+const input: ${singular}UpsertInput = ${tsObject}
+
+export function Save${singular}Button() {
+  const [isPending, startTransition] = React.useTransition()
+
+  return (
+    <button
+      type="button"
+      disabled={isPending}
+      onClick={() => {
+        startTransition(async () => {
+          await upsert${singular}(input)
+        })
+      }}
+    >
+      Save ${toLowerCase}
+    </button>
+  )
+}
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/dev-mode-integration/create-dev-mode-integration-artifact.ts

@@ -0,0 +1,89 @@
+export function renderCreateDevModeIntegrationArtifactImportsTemplate({
+  adminImportAlias,
+  exportName,
+  stringify,
+  stringifySerializedValue,
+  stringifyText,
+  loadExportName,
+  join,
+  dynamicImports,
+  snippetValues,
+  lifecycleHookValues
+}: {
+  adminImportAlias: string
+  exportName: string
+  stringify: string
+  stringifySerializedValue: string
+  stringifyText: string
+  loadExportName: string
+  join: string
+  dynamicImports: string
+  snippetValues: string
+  lifecycleHookValues: string
+}): string {
+  return `import type {
+  DevModeIntegration,
+  DevModeIntegrationMetadata,
+  DevModeLifecycleHookExample,
+  DevModeSnippet
+} from '${adminImportAlias}/components/shared/dev-mode/dev-mode-types'
+
+export const ${exportName} = {
+  schemaName: ${stringify},
+  schemaLabel: ${stringifySerializedValue},
+  schemaType: ${stringifyText}
+} satisfies DevModeIntegrationMetadata
+
+export async function ${loadExportName}(): Promise<DevModeIntegration> {
+  const [${join}] = await Promise.all([
+${dynamicImports}
+  ])
+  const snippets = [
+${snippetValues}
+  ] as DevModeSnippet[]
+  const lifecycleHooks = [
+${lifecycleHookValues}
+  ] as DevModeLifecycleHookExample[]
+
+  return {
+    ...${exportName},
+    schemaJson: JSON.stringify(schemaModule.default, null, 2),
+    snippets,
+    lifecycleHooks
+  }
+}
+`
+}
+
+export function renderCreateDevModeIntegrationArtifactClientModuleTemplate({
+  adminImportAlias,
+  exportName,
+  loadExportName,
+  buttonExportName
+}: {
+  adminImportAlias: string
+  exportName: string
+  loadExportName: string
+  buttonExportName: string
+}): string {
+  return `'use client'
+
+import type { Setting } from '${adminImportAlias}/actions/settings'
+import { DevModeIntegrateButton } from '${adminImportAlias}/components/shared/dev-mode-integrate'
+import { ${exportName}, ${loadExportName} } from './integration'
+
+interface ${buttonExportName}Props {
+  initialSettings?: Setting | null
+}
+
+export function ${buttonExportName}({ initialSettings }: ${buttonExportName}Props) {
+  return (
+    <DevModeIntegrateButton
+      integration={${exportName}}
+      loadIntegration={${loadExportName}}
+      initialSettings={initialSettings}
+    />
+  )
+}
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/dev-mode-integration/lifecycle-hook-code.ts

@@ -0,0 +1,55 @@
+export function renderLifecycleHookCodeImportsTemplate({
+  adminImportAlias,
+  schemaName,
+  event,
+  entityLabel,
+  actionLabel
+}: {
+  adminImportAlias: string
+  schemaName: string
+  event: string
+  entityLabel: string
+  actionLabel: string
+}): string {
+  return `import { registerHook } from '${adminImportAlias}/lib/lifecycle-hooks'
+
+registerHook('${schemaName}', '${event}', async (ctx) => {
+  console.log('${entityLabel} ${actionLabel} requested', {
+    actorId: ctx.user?.id ?? null,
+    entityId: ctx.entityId,
+    input: ctx.input
+  })
+
+  // Return an abort result to stop this mutation.
+  // return { abort: true, reason: '${entityLabel} is not ready for this change' }
+})
+`
+}
+
+export function renderLifecycleHookCodeImportsDetailsTemplate({
+  adminImportAlias,
+  schemaName,
+  event,
+  lifecycleHookId
+}: {
+  adminImportAlias: string
+  schemaName: string
+  event: string
+  lifecycleHookId: string
+}): string {
+  return `import { registerHook } from '${adminImportAlias}/lib/lifecycle-hooks'
+
+registerHook('${schemaName}', '${event}', async (ctx) => {
+  await fetch('https://example.com/webhooks/${schemaName}/${lifecycleHookId}', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      actorId: ctx.user?.id ?? null,
+      entityType: ctx.entityType,
+      entityId: ctx.entityId,
+      data: ctx.data
+    })
+  })
+})
+`
+}

package/dist/assets/adapters/next/templates/renderers/generators/edit-page.ts

@@ -0,0 +1,33 @@
+export function renderEditPageComponentTemplate({
+  singular,
+  actionImportPath,
+  kebabName,
+  camelSingular
+}: {
+  singular: string
+  actionImportPath: string
+  kebabName: string
+  camelSingular: string
+}): string {
+  return `import { notFound } from 'next/navigation'
+import { get${singular}ById } from '@admin/actions/${actionImportPath}'
+import { ${singular}Form } from '../../${kebabName}-form'
+
+interface PageProps {
+  params: Promise<{
+    id: string
+  }>
+}
+
+export default async function Edit${singular}Page({ params }: PageProps) {
+  const { id } = await params
+  const ${camelSingular} = await get${singular}ById(id)
+
+  if (!${camelSingular}) {
+    notFound()
+  }
+
+  return <${singular}Form key={\`\${${camelSingular}.id}-\${${camelSingular}.updatedAt}\`} initialData={${camelSingular}} pageTitle="Edit ${singular}" />
+}
+`
+}