@stravigor/core 0.1.0 → 0.2.0

package/src/encryption/encryption_manager.ts

@@ -1,4 +1,10 @@
-import { hkdfSync, createCipheriv, createDecipheriv, createHmac, timingSafeEqual } from 'node:crypto'
+import {
+  hkdfSync,
+  createCipheriv,
+  createDecipheriv,
+  createHmac,
+  timingSafeEqual,
+} from 'node:crypto'
 import { inject } from '../core/inject.ts'
 import Configuration from '../config/configuration.ts'
 import type { EncryptionConfig } from './types.ts'

package/src/exceptions/errors.ts

@@ -21,11 +21,7 @@ export class ModelNotFoundError extends StravError {
     public readonly model: string,
     public readonly id?: unknown
   ) {
-    super(
-      id !== undefined
-        ? `${model} with ID ${id} not found`
-        : `${model} not found`
-    )
+    super(id !== undefined ? `${model} with ID ${id} not found` : `${model} not found`)
   }
 }
 

package/src/exceptions/http_exception.ts

@@ -111,7 +111,10 @@ export class ValidationError extends HttpException {
  * throw new RateLimitError(60)  // retry after 60 seconds
  */
 export class RateLimitError extends HttpException {
-  constructor(public readonly retryAfter?: number, message?: string) {
+  constructor(
+    public readonly retryAfter?: number,
+    message?: string
+  ) {
     super(429, message)
   }
 }

package/src/generators/api_generator.ts

@@ -34,7 +34,14 @@ const ARCHETYPE_POLICY: Record<Archetype, string[]> = {
   [Archetype.Entity]: ['canList', 'canView', 'canCreate', 'canUpdate', 'canDelete'],
   [Archetype.Attribute]: ['canList', 'canView', 'canCreate', 'canUpdate', 'canDelete'],
   [Archetype.Reference]: ['canList', 'canView', 'canCreate', 'canUpdate', 'canDelete'],
-  [Archetype.Contribution]: ['canList', 'canView', 'canCreate', 'canUpdate', 'canDelete', 'canModerate'],
+  [Archetype.Contribution]: [
+    'canList',
+    'canView',
+    'canCreate',
+    'canUpdate',
+    'canDelete',
+    'canModerate',
+  ],
   [Archetype.Component]: ['canList', 'canView', 'canUpdate'],
   [Archetype.Event]: ['canList', 'canView', 'canAppend'],
   [Archetype.Configuration]: ['canView', 'canUpsert', 'canReset'],

package/src/generators/doc_generator.ts

@@ -41,14 +41,12 @@ const DEPENDENT_ARCHETYPES: Set<Archetype> = new Set([
 const SYSTEM_COLUMNS = new Set(['id', 'created_at', 'updated_at', 'deleted_at'])
 
 const ARCHETYPE_DESCRIPTIONS: Record<Archetype, string> = {
-  [Archetype.Entity]:
-    'A standalone entity with full CRUD operations and soft delete support.',
+  [Archetype.Entity]: 'A standalone entity with full CRUD operations and soft delete support.',
   [Archetype.Contribution]:
     'A user-contributed resource under a parent entity. Full CRUD with soft delete.',
   [Archetype.Reference]:
     'A lookup/reference table with full CRUD. No soft delete &mdash; records are permanently removed.',
-  [Archetype.Attribute]:
-    'A dependent attribute of a parent entity. Full CRUD with soft delete.',
+  [Archetype.Attribute]: 'A dependent attribute of a parent entity. Full CRUD with soft delete.',
   [Archetype.Component]:
     'A tightly-coupled component of a parent entity. Can be listed, viewed, and updated &mdash; but not independently created or deleted.',
   [Archetype.Event]:
@@ -222,19 +220,29 @@ ${content}
 
     // Introduction & Auth
     lines.push('      <div class="mb-6">')
-    lines.push('        <p class="px-3 text-[0.6875rem] font-semibold uppercase tracking-wider text-zinc-500 mb-2">Getting Started</p>')
-    lines.push('        <a href="#introduction" class="sidebar-link block px-3 py-1.5 text-sm text-zinc-400 rounded-md transition-colors">Introduction</a>')
-    lines.push('        <a href="#authentication" class="sidebar-link block px-3 py-1.5 text-sm text-zinc-400 rounded-md transition-colors">Authentication</a>')
+    lines.push(
+      '        <p class="px-3 text-[0.6875rem] font-semibold uppercase tracking-wider text-zinc-500 mb-2">Getting Started</p>'
+    )
+    lines.push(
+      '        <a href="#introduction" class="sidebar-link block px-3 py-1.5 text-sm text-zinc-400 rounded-md transition-colors">Introduction</a>'
+    )
+    lines.push(
+      '        <a href="#authentication" class="sidebar-link block px-3 py-1.5 text-sm text-zinc-400 rounded-md transition-colors">Authentication</a>'
+    )
     lines.push('      </div>')
 
     // Resources
     lines.push('      <div>')
-    lines.push('        <p class="px-3 text-[0.6875rem] font-semibold uppercase tracking-wider text-zinc-500 mb-2">Resources</p>')
+    lines.push(
+      '        <p class="px-3 text-[0.6875rem] font-semibold uppercase tracking-wider text-zinc-500 mb-2">Resources</p>'
+    )
 
     const emitSchema = (schema: SchemaDefinition): void => {
       const anchor = toSnakeCase(schema.name)
       const label = this.displayName(schema.name)
-      lines.push(`        <a href="#${anchor}" class="sidebar-link block px-3 py-1.5 text-sm text-zinc-400 rounded-md transition-colors">${label}</a>`)
+      lines.push(
+        `        <a href="#${anchor}" class="sidebar-link block px-3 py-1.5 text-sm text-zinc-400 rounded-md transition-colors">${label}</a>`
+      )
 
       const children = childrenOf.get(schema.name)
       if (children?.length) {
@@ -341,10 +349,7 @@ Content-Type: application/json</code></pre>
   // Per-resource section
   // ---------------------------------------------------------------------------
 
-  private buildResourceSection(
-    schema: SchemaDefinition,
-    table: TableDefinition
-  ): string {
+  private buildResourceSection(schema: SchemaDefinition, table: TableDefinition): string {
     const anchor = toSnakeCase(schema.name)
     const label = this.displayName(schema.name)
     const actions = ARCHETYPE_CONTROLLER[schema.archetype] ?? []
@@ -352,9 +357,7 @@ Content-Type: application/json</code></pre>
     const description = ARCHETYPE_DESCRIPTIONS[schema.archetype]
 
     const fieldsTable = this.buildFieldsTable(schema, table)
-    const endpoints = actions
-      .map(action => this.buildEndpoint(action, schema, table))
-      .join('\n')
+    const endpoints = actions.map(action => this.buildEndpoint(action, schema, table)).join('\n')
 
     return `      <section id="${anchor}" class="mb-20">
         <div class="flex items-center gap-3">
@@ -434,11 +437,7 @@ ${rows.join('\n')}
   // Per-endpoint block
   // ---------------------------------------------------------------------------
 
-  private buildEndpoint(
-    action: string,
-    schema: SchemaDefinition,
-    table: TableDefinition
-  ): string {
+  private buildEndpoint(action: string, schema: SchemaDefinition, table: TableDefinition): string {
     const { method, pathPattern, description } = this.actionMeta(action, schema)
     const methodColor = this.methodBadgeColor(method)
     const anchor = `${toSnakeCase(schema.name)}-${action}`
@@ -738,10 +737,7 @@ ${rows.join('\n')}
     }
 
     const statusCode = action === 'store' ? 201 : 200
-    const body =
-      action === 'index'
-        ? JSON.stringify([obj], null, 2)
-        : JSON.stringify(obj, null, 2)
+    const body = action === 'index' ? JSON.stringify([obj], null, 2) : JSON.stringify(obj, null, 2)
 
     return { statusCode, responseBody: body }
   }
@@ -769,7 +765,9 @@ ${rows.join('\n')}
   // ---------------------------------------------------------------------------
 
   private displayName(name: string): string {
-    return toPascalCase(name).replace(/([A-Z])/g, ' $1').trim()
+    return toPascalCase(name)
+      .replace(/([A-Z])/g, ' $1')
+      .trim()
   }
 
   private displayNamePlural(name: string): string {
@@ -915,9 +913,16 @@ ${rows.join('\n')}
       default: {
         const snake = toSnakeCase(fieldName)
         if (snake === 'email' || snake.endsWith('_email')) return 'user@example.com'
-        if (snake === 'url' || snake.endsWith('_url') || snake === 'website' || snake === 'homepage')
+        if (
+          snake === 'url' ||
+          snake.endsWith('_url') ||
+          snake === 'website' ||
+          snake === 'homepage'
+        )
           return 'https://example.com'
-        const label = toPascalCase(fieldName).replace(/([A-Z])/g, ' $1').trim()
+        const label = toPascalCase(fieldName)
+          .replace(/([A-Z])/g, ' $1')
+          .trim()
         return `Sample ${label}`
       }
     }

package/src/generators/model_generator.ts

@@ -272,7 +272,9 @@ export default class ModelGenerator {
     if (needsReferenceImport) decoratorImports.push('reference')
     if (needsAssociateImport) decoratorImports.push('associate')
     if (decoratorImports.length > 0) {
-      importLines.push(`import { ${decoratorImports.join(', ')} } from '@stravigor/core/orm/decorators'`)
+      importLines.push(
+        `import { ${decoratorImports.join(', ')} } from '@stravigor/core/orm/decorators'`
+      )
     }
 
     for (const [entity, enumNames] of enumImports) {