@signal24/dk-server-foundation 26.213.615

package/.gitattributes

@@ -0,0 +1,2 @@
+/.yarn/releases/** binary
+/.yarn/plugins/** binary

package/.gitlab-ci.yml

@@ -0,0 +1,49 @@
+image: node:24-alpine
+
+default:
+  interruptible: true
+
+stages:
+  - deploy
+
+test and deploy:
+  stage: deploy
+  services:
+    - name: mysql:8
+      variables:
+        MYSQL_ROOT_PASSWORD: secret
+        MYSQL_DATABASE: default
+    - name: postgres:17-alpine
+      variables:
+        POSTGRES_USER: root
+        POSTGRES_PASSWORD: secret
+        POSTGRES_DB: default
+    - name: redis:alpine
+  variables:
+    MYSQL_HOST: mysql
+    MYSQL_PORT: 3306
+    PG_HOST: postgres
+    PG_PORT: 5432
+    PG_USER: root
+    PG_PASSWORD_SECRET: secret
+    REDIS_HOST: redis
+    REDIS_PORT: 6379
+  script: |
+    set -x
+
+    yarn --immutable
+
+    yarn gen:proto
+    yarn test
+    yarn testapp
+
+    BUILD_VERSION=${CI_PIPELINE_CREATED_AT:2:2}.${CI_PIPELINE_CREATED_AT:5:2}${CI_PIPELINE_CREATED_AT:8:2}.${CI_PIPELINE_CREATED_AT:11:2}${CI_PIPELINE_CREATED_AT:14:2}
+    BUILD_VERSION=$(echo -n ${BUILD_VERSION} | sed -E 's/\.0+/./g')
+    npm version ${BUILD_VERSION} --git-tag-version=false
+    npm run build
+
+    npm config set -- //${PRIVATE_NPM_URL}/:_authToken="${PRIVATE_NPM_PUBLISHER_TOKEN}"
+    npm publish --registry https://${PRIVATE_NPM_URL}/
+
+    npm config set //registry.npmjs.org/:_authToken="${NPM_PUBLISH_TOKEN}"
+    npm publish --registry https://registry.npmjs.org/ --access public

package/.oxlintrc.json

@@ -0,0 +1,40 @@
+{
+    "plugins": ["typescript", "unicorn", "oxc", "promise", "import"],
+    "env": {
+        "builtin": true,
+        "es2025": true,
+        "commonjs": true,
+        "node": true,
+        "shared-node-browser": true
+    },
+    "ignorePatterns": ["dist/", ".yarn/", "src/openapi-client-generated/"],
+    "rules": {
+        "no-array-constructor": "error",
+        "no-case-declarations": "error",
+        "no-empty": "error",
+        "no-fallthrough": "error",
+        "no-prototype-builtins": "error",
+        "no-redeclare": "error",
+        "no-regex-spaces": "error",
+        "no-unused-expressions": "error",
+        "no-var": "error",
+        "prefer-rest-params": "error",
+        "prefer-spread": "error",
+        "typescript/ban-ts-comment": "error",
+        "typescript/no-empty-object-type": "error",
+        "typescript/no-explicit-any": "error",
+        "typescript/no-namespace": "error",
+        "typescript/no-require-imports": "error",
+        "typescript/no-unnecessary-type-constraint": "error",
+        "typescript/no-unsafe-function-type": "error",
+        "typescript/prefer-namespace-keyword": "error"
+    },
+    "overrides": [
+        {
+            "files": ["tests/**/*.spec.ts"],
+            "rules": {
+                "typescript/no-explicit-any": "off"
+            }
+        }
+    ]
+}

package/.prettierignore

@@ -0,0 +1,3 @@
+build
+.yarn
+

package/.prettierrc.json

@@ -0,0 +1,15 @@
+{
+    "arrowParens": "avoid",
+    "printWidth": 150,
+    "singleQuote": true,
+    "tabWidth": 4,
+    "trailingComma": "none",
+    "overrides": [
+        {
+            "files": ["*.yaml", "*.yml"],
+            "options": {
+                "tabWidth": 2
+            }
+        }
+    ]
+}

package/.serena/project.yml

@@ -0,0 +1,111 @@
+# the name by which the project can be referenced within Serena
+project_name: 'dk-server-foundation'
+
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   powershell          python              python_jedi         r                   rego
+#   ruby                ruby_solargraph     rust                scala               swift
+#   terraform           toml                typescript          typescript_vts      vue
+#   yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   Some languages require additional setup/installations.
+#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+  - typescript
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: 'utf-8'
+
+# whether to use project's .gitignore files to ignore files
+ignore_all_files_in_gitignore: true
+
+# list of additional paths to ignore in all projects
+# same syntax as gitignore, so you can use * and **
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions,
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
+included_optional_tools: []
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ''

package/.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Attach",
+            "port": 9201,
+            "request": "attach",
+            "skipFiles": ["<node_internals>/**"],
+            "type": "node"
+        }
+    ]
+}

package/.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+    "editor.codeActionsOnSave": {
+        "source.fixAll.oxc": "explicit"
+    },
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "prettier.configPath": ".prettierrc.json",
+    "search.exclude": {
+        "dist": true,
+        "generated": true
+    }
+}

package/.yarnrc.yml

@@ -0,0 +1,5 @@
+enableGlobalCache: false
+
+nodeLinker: node-modules
+
+yarnPath: .yarn/releases/yarn-4.10.2.cjs

package/CLAUDE.md

@@ -0,0 +1,279 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+`@signal24/dk-server-foundation` is a TypeScript foundation library built on top of the Deepkit framework for building server applications. It provides opinionated abstractions and utilities for common server-side patterns including database management, HTTP handling, authentication, workers, RPC, and observability.
+
+## Core Commands
+
+### Build & Development
+
+```bash
+# Clean build (removes dist/ and rebuilds everything)
+yarn build
+
+# Quick rebuild (doesn't clean first)
+yarn build:dirty
+
+# Watch mode
+yarn dev
+```
+
+### Testing
+
+```bash
+# Run all tests
+yarn test
+
+# Run tests with debugger
+yarn test:debug
+
+# Run a single test file
+yarn test path/to/file.spec.ts
+```
+
+### Code Quality
+
+```bash
+# Format code with Prettier and fix ESLint issues
+yarn format
+```
+
+### Test Application
+
+```bash
+# Build and run the test application
+yarn testapp
+```
+
+## Architecture Overview
+
+### Application Creation Pattern
+
+Applications are created using the `createApp()` factory function (src/app/base.ts:43), which sets up a Deepkit application with opinionated defaults:
+
+- **Dependency Injection**: Uses Deepkit's DI system with custom resolver functions (`resolve()` or `r()`) for accessing providers
+- **Configuration**: Uses `@signal24/config` with a custom loader (CustomConfigLoader) that supports environment variables and defaults
+- **Module System**: Based on Deepkit's module architecture with framework, HTTP, healthcheck, and optional OpenAPI modules (dev only)
+
+Key concepts:
+
+- `createApp()` accepts a config class, database class, framework config, CORS options, and feature flags (worker, Deepkit RPC)
+- The function returns a configured Deepkit App instance with all necessary providers, listeners, and hooks
+- Use `@AutoStart()` decorator on services that should initialize at startup (before DI injection)
+- **Graceful Shutdown**: `ShutdownListener` (src/app/shutdown.ts) intercepts SIGTERM/SIGINT and dispatches `onServerShutdownRequested` before forwarding to Deepkit's built-in shutdown. Listeners on this event are awaited, allowing async cleanup before the framework tears down. Register handlers via `@eventDispatcher.listen(onServerShutdownRequested)`.
+
+### Database Layer
+
+The database system (src/database/) extends Deepkit's ORM with support for both MySQL and PostgreSQL:
+
+- **BaseDatabase**: Core abstraction with transaction hooks, raw query helpers, and session management (src/database/common.ts)
+- **MySQLDatabaseAdapter**: Custom adapter with type transformations for DateString, Coordinate (POINT), and test environment compatibility (src/database/mysql.ts)
+- **PostgresDatabaseAdapter**: Custom adapter with type transformations for DateString and test environment compatibility (src/database/postgres.ts)
+- **Dialect Helpers**: `getDialect()`, `quoteId()`, and dialect-aware SQL fragment generators (src/database/dialect.ts)
+- **Entity Helpers**: Functions like `createEntity()`, `createPersistedEntity()`, `getEntityOr404()` for common CRUD patterns
+- **Transaction Hooks**: Support for pre-commit and post-commit hooks via `session.addPreCommitHook()` and `session.addPostCommitHook()`
+- **Session Locks**: Database-level locking via `session.acquireSessionLock(key)` — uses a `_locks` table on MySQL, `pg_advisory_xact_lock` on PostgreSQL
+
+Entity creation pattern:
+
+```typescript
+// Use createPersistedEntity instead of manually creating and saving
+await createPersistedEntity(MyEntity, { field: value }, session);
+```
+
+Database factory:
+
+```typescript
+// MySQL
+class MyDB extends createMySQLDatabase(
+    {
+        /* pool config */
+    },
+    [Entity1, Entity2]
+) {}
+
+// PostgreSQL
+class MyDB extends createPostgresDatabase(
+    {
+        /* pool config */
+    },
+    [Entity1, Entity2]
+) {}
+```
+
+### HTTP Layer
+
+Custom HTTP handling (src/http/) builds on Deepkit's HTTP module:
+
+- **CustomHttpKernel**: Replaces Deepkit's default HttpKernel with custom middleware and error handling (src/http/kernel.ts)
+- **HTTP Context**: Request context ID generation and pluggable context resolver (src/http/context.ts)
+- **CORS Support**: Multi-origin CORS configuration via HttpCorsListener (src/http/cors.ts)
+- **Authentication**: JWT and Basic Auth providers with decorator-based guards (src/http/auth.ts)
+- **File Uploads**: Support for multipart uploads with `multipartJsonKey: '_payload'` configuration
+- **Workflow**: Custom workflow listener for pre/post request hooks (src/http/workflow.ts)
+
+Response types: Use `OkResponse`, `RedirectResponse`, `EmptyResponse`, or `AnyResponse` for type-safe returns.
+
+### Worker System
+
+Background job processing (src/services/worker/) using BullMQ with Redis:
+
+- **BaseJob**: Extend this class and use `@WorkerJob()` decorator to define jobs
+- **WorkerService**: Queue jobs via `workerSvc.queueJob(JobClass, data, options)`
+- **Job Runners**: Separate process workers that execute queued jobs (src/services/worker/runner.ts)
+- **Job Observer**: Monitors job completion and failures (src/services/worker/observer.ts)
+
+Jobs are automatically registered when `enableWorker: true` is passed to `createApp()`.
+
+Job pattern:
+
+```typescript
+@WorkerJob()
+class MyJob extends BaseJob<InputType, OutputType> {
+    async handle(data: InputType): Promise<OutputType> {
+        // Job logic
+    }
+}
+```
+
+### SRPC (Simple RPC)
+
+Custom bidirectional RPC system (src/srpc/) over WebSocket:
+
+- **SrpcServer**: Server-side RPC handler with WebSocket transport
+- **SrpcClient**: WebSocket client with reconnect and heartbeat
+- **SrpcByteStream**: Efficient binary streaming over existing connections
+
+Use `dksf-gen-proto` CLI to generate TypeScript types from `.proto` files using ts-proto.
+
+Authentication uses HMAC signatures with clock drift tolerance (configurable via `SRPC_AUTH_CLOCK_DRIFT_MS`).
+
+### Observability
+
+Integrated telemetry (src/telemetry/):
+
+- **OpenTelemetry**: Automatic instrumentation for HTTP, database, Redis, DNS, and BullMQ (src/telemetry/otel/)
+- **Sentry**: Error tracking with automatic flushing on uncaught exceptions
+- **Custom Metrics**: MariaDB instrumentation (src/telemetry/otel/MariaDBInstrumentation.ts)
+- **Tracing Helpers**: `withRootSpan()` and `withSpan()` for manual span creation
+
+Initialize telemetry by calling `init()` from src/telemetry/otel/index.ts before other imports.
+
+### Helper Utilities
+
+Organized by category (src/helpers/):
+
+- **async/**: AsyncContext, promise helpers, process utilities
+- **data/**: Array manipulation, object utilities, serialization, transformers
+- **redis/**: Broadcast, cache (with TTL), mutex (Redis-backed distributed locking)
+- **security/**: Crypto (AES-GCM encryption), validation helpers
+- **io/**: Package metadata helpers, stream utilities
+- **utils/**: Date utilities, error handling, UUID v7 generation
+- **framework/**: Deepkit-specific decorators and injection helpers
+
+### Configuration
+
+Configuration (src/app/config.ts) uses `@signal24/config` with environment variable support:
+
+- `BaseAppConfig`: Contains all framework-level configuration (MySQL, PostgreSQL, Redis, Auth, Mail, etc.)
+- Applications should extend BaseAppConfig with their own settings
+- Config is available via `getAppConfig()` or by injecting the config class
+- Secrets should use `_SECRET` suffix in environment variable names
+
+### Services
+
+Core services (src/services/):
+
+- **Logger**: Extended Pino logger with scoped instances via `createLogger(this)` (src/services/logger.ts)
+- **MailService**: Email sending via Postmark or SMTP (src/services/mail/)
+- **CLI Commands**: REPL (`ReplCommand`) and provider invoke (`ProviderInvokeCommand`) for debugging
+- **WorkerService**: Background job queueing (see Worker System above)
+
+### Test Infrastructure
+
+Test infrastructure (tests/):
+
+- Tests use `node:test` runner against compiled output in `dist/`
+- Test compilation: `tsc -p tsconfig.test.json` compiles `tests/` into `dist/tests/`
+- Test runner: `dksf-test` CLI tool (src/cli/dksf-test.ts) handles spawning `node --test`
+- Global setup enforces UTC timezone (tests/shared/globalSetup.ts)
+- Test files use `*.spec.ts` naming convention
+- Test timeout: 180 seconds (high to accommodate `describe()` suite-level timeouts on Node 24+)
+- Testing utilities: `TestingHelpers.createTestingFacade()`, `makeMockRequest()` (src/testing/)
+- Database tests use `forEachAdapter()` to run against both MySQL and PostgreSQL
+- Tests require MySQL and Redis; PostgreSQL tests run when `PG_HOST` is set (skipped otherwise)
+
+Run a single test:
+
+```bash
+yarn test tests/helpers/array.spec.ts
+```
+
+### Type System
+
+Custom types (src/types/):
+
+- **Phone**: Google libphonenumber integration for phone number validation
+- **Coordinate**: Geo-coordinates with MySQL POINT support (MySQL-only)
+- **OnUpdate**: MySQL `ON UPDATE` expression annotation (e.g., `Date & OnUpdate<'CURRENT_TIMESTAMP'>`)
+- Deepkit reflection is enabled (`"reflection": true` in tsconfig.json)
+
+## Important Notes
+
+- **Timezone**: Server always uses UTC. The index.ts enforces this and will throw an error if TZ !== UTC
+- **Identity Maps**: Disabled by default (`session.withIdentityMap = false`) in transactions and sessions
+- **Query Cloning**: The library overrides Deepkit's query cloning behavior to return the same instance for performance
+- **Decorators**: TypeScript experimental decorators are required (`experimentalDecorators: true`)
+- **Postinstall**: Runs `dksf-install` CLI tool (or `patch-package && deepkit-type-install` as fallback)
+- **Test Environment**: Special handling for Date mocks and worker queueing (jobs are not queued in test environment)
+- **Dual Database Support**: Both MySQL (`@deepkit/mysql`) and PostgreSQL (`@deepkit/postgres`) are supported. Coordinate/POINT type is MySQL-only. Session locks use `_locks` table on MySQL and `pg_advisory_xact_lock` on PostgreSQL.
+
+## CLI Tools
+
+- `dksf-test`: Test runner that compiles and runs `node --test` (src/cli/dksf-test.ts)
+- `dksf-install`: Post-install script for setup (src/cli/dksf-install.ts)
+- `dksf-update`: Update utility (src/cli/dksf-update.ts)
+- `dksf-gen-proto`: Generate TypeScript types from .proto files using ts-proto (src/cli/dksf-gen-proto.ts)
+
+## Development Mode Features
+
+When `APP_ENV !== 'production'`:
+
+- OpenAPI schema route (`/_openapi/`) is automatically available in development builds; set `ENABLE_OPENAPI_SCHEMA` to also dump the schema to `openapi.yaml`
+- Additional debugging tools in `src/app/dev.ts`
+- Lower MySQL/PostgreSQL connection pool limits (5 vs 10)
+- Shorter idle timeouts
+
+## Migration System
+
+Database migrations (src/database/migration/):
+
+- Custom migration commands replace Deepkit's defaults
+- Use `runMigrations()` helper to execute migrations programmatically
+- Migrations stored in directory returned by `getMigrationsDir()`
+- Character set standardization via `standardizeDbCollation()` (MySQL-only; no-ops on PostgreSQL)
+
+### Migration Commands
+
+- `migration:create` — Compares entity definitions against the live database and generates a migration file with the DDL to bring the DB in sync. Supports `--non-interactive` flag for CI. Both MySQL and PostgreSQL.
+- `migration:run` — Executes all pending migrations from the migrations directory
+- `migration:reset` — Removes all migrations and regenerates a base migration from the current database schema
+- `migration:characters` — Standardizes character set/collation to `utf8mb4_0900_ai_ci` (MySQL-only)
+
+### Schema Migration Generator (`migration:create`)
+
+The `migration:create` command (src/database/migration/create/) is a custom implementation that:
+
+1. **Reads entity schema** via Deepkit's `ReflectionClass` — resolves all type annotations (`DateString`, `UuidString`, `Length<N>`, `MaxLength<N>`, `MySQLCoordinate`, `OnUpdate<expr>`, enums, etc.) to dialect-specific column types
+2. **Reads database schema** via `information_schema` queries — introspects columns, indexes, foreign keys, and enum types from the live database
+3. **Compares schemas** — diffs entity vs DB to detect added/removed/modified tables, columns, indexes, FKs, and PK changes. Supports interactive rename detection and MySQL column reordering
+4. **Generates DDL** — produces dialect-specific SQL statements (MySQL uses backtick quoting, `MODIFY COLUMN`, `ENUM()`, `AFTER`; PostgreSQL uses double-quote quoting, `ALTER COLUMN`, `CREATE TYPE ... AS ENUM`)
+5. **Writes migration file** — outputs a timestamped `.ts` file using the `createMigration()` format
+
+Key dialect differences handled:
+
+- MySQL: inline `ENUM('a','b')`, `AFTER` clause for column ordering, `TINYINT(1)` for booleans, `AUTO_INCREMENT`
+- PostgreSQL: `CREATE TYPE ... AS ENUM`, no column reordering support, native `BOOLEAN`, `SERIAL`/`BIGSERIAL`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Signal24 LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.