@zmdb/core 1.0.0-beta.2

package/src/orm.ts

@@ -0,0 +1,90 @@
+// Repository, transaction, loading, caching, seeding, outbox, replica, and
+// entity-modeling concern. Database clients remain selected driver subpaths.
+
+export {
+  BaseRepository,
+  IncompleteKeyError,
+  ValidationError,
+  batch,
+  createLoaderScope,
+  createTransactionalDb,
+  defineRepository,
+  markTransactionClosed,
+  memoryStore,
+} from '@zmdb/orm';
+export {
+  type ActiveTransactionContext,
+  type ArgsOf,
+  type CacheInvalidationOptions,
+  type CacheOptions,
+  type CacheStore,
+  type ClosedTransactionContext,
+  type DatabaseVertical,
+  type DefineRepositoryOptions,
+  type Driver,
+  type EntityLoader,
+  type ExecuteOptions,
+  type FilterDef,
+  type FilterOverride,
+  type FilterOverrides,
+  type FilterParams,
+  type FilterPredicate,
+  type LoaderScope,
+  type NumericColumnOf,
+  type QueryMeta,
+  type ReadOptions,
+  type RelationLoader,
+  type RelationValueOf,
+  type RepositoryAggregateBuilder,
+  type RepositoryOptions,
+  type ResultOf,
+  type StreamOptions,
+  type TransactionContext,
+  type TransactionOptions,
+  type TransactionRetryPolicy,
+  type TransactionState,
+  type TransactionalDb,
+  type TransactionalDriver,
+  type TxConnection,
+  type UpdatePatch,
+  type UpsertOptions,
+  type ValidationIssue,
+  type WriteOptions,
+} from '@zmdb/orm';
+
+export { makeRng, seedRows } from '@zmdb/orm/seeding';
+export { type SeedOptions } from '@zmdb/orm/seeding';
+
+export { OutboxSchema, createOutboxDispatcher, outboxWriter } from '@zmdb/orm/outbox';
+export {
+  type DeadOutboxRow,
+  type OutboxDispatcher,
+  type OutboxDispatcherOptions,
+  type OutboxRow,
+  type OutboxStatus,
+  type OutboxWriter,
+} from '@zmdb/orm/outbox';
+
+export { isWrite, withReplicas } from '@zmdb/orm/replicas';
+export { type ReplicaOptions } from '@zmdb/orm/replicas';
+
+export { makeEndpoint } from '@zmdb/web/integrations';
+export { type EndpointResult, type Handler } from '@zmdb/web/integrations';
+
+export { EventBus } from '@zmdb/orm/entity-modeling';
+export { discriminatorFor, flattenEmbeddable, liftEmbeddable, rowToSubtype } from '@zmdb/schema/entity-modeling';
+export { type LifecycleEvent, type Subscriber } from '@zmdb/orm/entity-modeling';
+export { type SingleTableInheritance } from '@zmdb/schema/entity-modeling';
+
+export {
+  OUTBOX_TABLE,
+  outboxCandidatesQuery,
+  outboxClaimQuery,
+  outboxMarkDeadQuery,
+  outboxMarkDeliveredQuery,
+  outboxMarkRetryQuery,
+  outboxMigration,
+  outboxPendingIndexDdl,
+  outboxReadBackQuery,
+  outboxTableDdl,
+} from '@zmdb/orm/outbox';

package/src/relations.ts

@@ -0,0 +1,11 @@
+// zmdb/relations — explicit named re-exports of the relations surface.
+//
+// A relation is declared on the type it belongs to — `orders?: Order[] & OneToMany<'orders',
+// 'userId'>`, from `@zmdb/schema/tags` — so there are no builders here to construct one
+// with, and no relations map to pass anywhere. What a consumer needs is resolution and the
+// two row helpers. `Populated`/`PopulatedEntity` live on `@zmdb/schema/derive` with the
+// rest of the type derivation.
+export { aliasRow, attachPopulated, compilePopulate } from '@zmdb/orm/relations';
+export { resolveRelation } from '@zmdb/schema/relations';
+export { type JoinRow, type PopulateDialect, type PopulateQuery } from '@zmdb/orm/relations';
+export { type ResolvedRelation } from '@zmdb/schema/relations';

package/src/schema.ts

@@ -0,0 +1,193 @@
+// Complete schema concern: declarations, derivation, DTOs, relations, IR,
+// JSON Schema, custom codecs, and naming. Every name delegates by identity.
+
+export { ValidationError, claimsValidationIssues, validationIssuesOf } from '@zmdb/validator';
+export { aliasRow, attachPopulated, compilePopulate } from '@zmdb/orm/relations';
+export { applyOrderBy, applyPagination, compileWhere } from '@zmdb/orm/dto';
+export { buildListResult, isRecord, resolveRelation, schemaOf } from '@zmdb/schema';
+export { createStateUpdatePayload, defineEntityStateMachine, defineStateTransitions } from '@zmdb/app';
+export {
+  type AllowedTargetStates,
+  type EntityStateMachine,
+  type EntityStateMachineOptions,
+  type StateTransitions,
+  type StateUpdateDTO,
+} from '@zmdb/app';
+export {
+  type ColumnFlags,
+  type ColumnMeta,
+  type ColumnsMap,
+  type CoreSchema,
+  type CreateDTO,
+  type DeclaredTable,
+  type Entity,
+  type ListDTO,
+  type ListResult,
+  type OrderByDTO,
+  type PaginationDTO,
+  type Populated,
+  type PopulatedEntity,
+  type PrimaryKeyOf,
+  type ReadDTO,
+  type ResolvedRelation,
+  type SqlType,
+  type TaggedSchema,
+  type UpdateDTO,
+  type ValidationRule,
+  type WhereDTO,
+} from '@zmdb/schema';
+export { type JoinRow, type PopulateDialect, type PopulateQuery } from '@zmdb/orm/relations';
+export { type OrderTarget } from '@zmdb/orm/dto';
+export { type ValidationIssue } from '@zmdb/validator';
+
+export {
+  type AnyRelation,
+  type Codec,
+  type ColumnSqlType,
+  type Ext,
+  type ForeignKey,
+  type Fts,
+  type HasDefault,
+  type Length,
+  type ManyToMany,
+  type ManyToOne,
+  type Max,
+  type MaxLength,
+  type Min,
+  type MinLength,
+  type NonNull,
+  type Nullable,
+  type Numeric,
+  type OnDelete,
+  type OnUpdate,
+  type OneToMany,
+  type OneToOne,
+  type Pattern,
+  type Physical,
+  type PrimaryKey,
+  type Proto,
+  type ProtoField,
+  type References,
+  type ReferentialAction,
+  type RelationKind,
+  type Rowstore,
+  type Rule,
+  type Sensitive,
+  type Serial,
+  type ShardKey,
+  type SoftDelete,
+  type SortKey,
+  type Sql,
+  type Table,
+  type Unique,
+  type WireAs,
+} from '@zmdb/schema/tags';
+
+export {
+  type ColumnKeys,
+  type DefaultKeys,
+  type GetDTO,
+  type GetOptions,
+  type KeysCarrying,
+  type NullableKeys,
+  type PrimaryKeyKeys,
+  type Projection,
+  type RelationKeys,
+  type SensitiveKeys,
+  type SerialKeys,
+  type SoftDeleteKeys,
+  type UniqueKeys,
+  type Wire,
+  type WireCreateDTO,
+} from '@zmdb/schema/derive';
+
+export { applyKeysetFilter } from '@zmdb/orm/dto';
+export { buildSearchResult, decodeCursor, describeAggregate, encodeCursor, getResult, project } from '@zmdb/schema/dto';
+export {
+  type AggFn,
+  type AggregateColumn,
+  type AggregateResult,
+  type AggregateSpec,
+  type ComputedSpec,
+  type FieldOps,
+  type OffsetPage,
+  type OrderBySpec,
+  type OrderDir,
+  type PaginationSpec,
+  type SearchDTO,
+  type SearchHit,
+  type SearchResult,
+  type SubqueryTarget,
+  type UnknownRow,
+} from '@zmdb/schema/dto';
+export { type WhereTarget } from '@zmdb/orm/dto';
+
+export {
+  KNOWN_CONSTRAINT_KINDS,
+  PROTO_SCALARS,
+  RELATION_KINDS,
+  SQL_TYPES,
+  appTypeOf,
+  dbDecodedColumns,
+  decodeDbValue,
+  decodeWire,
+  decodeWireValue,
+  encodeWire,
+  encodeWireValue,
+  jsonSchemaForColumn,
+  jsonSchemaFromIR,
+  jsonSchemaFromShape,
+  jsonSchemaFromTypeIR,
+  objectTypeFromIR,
+  objectTypeFromShape,
+  schemaFromIR,
+  shapeOfVariant,
+  wireTypeOf,
+} from '@zmdb/schema/ir';
+export {
+  type ArrayIR,
+  type CodecRegistry,
+  type ColumnIR,
+  type ConstraintKind,
+  type Constraints,
+  type ExtensionType,
+  type ForeignKeyIR,
+  type JsonValue,
+  type Layer,
+  type LiteralIR,
+  type NullIR,
+  type ObjectIR,
+  type PropertyIR,
+  type ProtoScalar,
+  type RefIR,
+  type RelationIR,
+  type ScalarIR,
+  type ScalarKind,
+  type SchemaIR,
+  type ShapeColumnIR,
+  type ShapeIR,
+  type TableOptions,
+  type TagField,
+  type TupleIR,
+  type TypeIR,
+  type UndefinedIR,
+  type UnionIR,
+  type UnknownIR,
+  type UnsupportedIR,
+} from '@zmdb/schema/ir';
+
+export {
+  componentName,
+  toJsonSchema,
+  toJsonSchemaWithRelations,
+  toListSchema,
+  toOpenApiComponents,
+  toSearchSchema,
+} from '@zmdb/schema/openapi';
+export { type EnvelopeSchema, type JsonSchemaObject, type Variant } from '@zmdb/schema/openapi';
+
+export { decodeValue, defineType, encodeValue, wireCodec } from '@zmdb/schema/custom-types';
+export { type CustomType } from '@zmdb/schema/custom-types';
+
+export { resolveNaming, snakeCase, snakeCasePlural } from '@zmdb/schema/naming';
+export { type NamingStrategy, type NamingStrategyConfig, type NamingStrategyName } from '@zmdb/schema/naming';

package/src/sql.ts

@@ -0,0 +1,130 @@
+// Direct SQL compilation and DDL concern. Migration execution and catalog
+// introspection live under `@zmdb/core/migrations`.
+
+export {
+  DISTANCE_OPERATORS,
+  EXPR,
+  OP_MAP,
+  QueryCompilerError,
+  UnsupportedFeatureError,
+  appendComment,
+  coalesce,
+  concat,
+  createQueryCompiler,
+  dec,
+  defineSqlDialect,
+  dialectCapabilities,
+  dialectFamily,
+  dialectName,
+  dialectSupportsReturning,
+  dialectTraits,
+  distance,
+  extendSqlDialect,
+  formatPlaceholder,
+  inc,
+  isSqlDialect,
+  mul,
+  not,
+  proposed,
+  quoteColumn,
+  quoteIdentifier,
+  quoteTable,
+  renderPredicate,
+  renumberPlaceholders,
+  serializeComment,
+  stContains,
+  stDWithin,
+  withComments,
+} from '@zmdb/sql';
+export {
+  type AliasedColumn,
+  type AliasedDistanceExpression,
+  type ColumnExpr,
+  type CommentKey,
+  type CommentKeys,
+  type CommentPairs,
+  type ComparisonPredicate,
+  type CompiledQuery,
+  type DatabaseCapabilities,
+  type DeleteBuilder,
+  type DialectFeature,
+  type DialectSqlType,
+  type DialectTarget,
+  type DialectTypeMap,
+  type Direction,
+  type DistanceExpression,
+  type DistanceOp,
+  type ExtensionColumnOf,
+  type GeoJsonGeometry,
+  type GeometryColumnOf,
+  type GeometryValueOf,
+  type InsertBuilder,
+  type OnConflictBuilder,
+  type Operator,
+  type PaginationTail,
+  type PlaceholderStyle,
+  type Predicate,
+  type PredicateGroup,
+  type QueryCompiler,
+  type QueryCompilerOptions,
+  type QueryTelemetry,
+  type ResolvedDialectTraits,
+  type ReturningCapability,
+  type ReturningStatement,
+  type ReturningStyle,
+  type SchemaObjectOperation,
+  type SelectBuilder,
+  type SetValue,
+  type SpatialPredicate,
+  type SqlDialect,
+  type SqlDialectDefinition,
+  type SqlDialectExtension,
+  type UpdateBuilder,
+  type VectorColumnOf,
+} from '@zmdb/sql';
+
+export { escapeFts5Term, ftsSelectFrom } from '@zmdb/sql/fts';
+export { type FtsOptions, type FtsSelect, type FtsTableOptions } from '@zmdb/sql/fts';
+
+export { joinableSelectFrom } from '@zmdb/sql/joins';
+export { type JoinCondition, type JoinKind, type JoinableSelect } from '@zmdb/sql/joins';
+
+export { aggregateSelectFrom } from '@zmdb/sql/aggregations';
+export { type AggregateSelect } from '@zmdb/sql/aggregations';
+
+export { SET_KEYWORD, batch, setOperation } from '@zmdb/sql/set-ops';
+export { type BatchHandle, type SetOp } from '@zmdb/sql/set-ops';
+
+export {
+  checkConstraintDdl,
+  createExtensionDdl,
+  createIndexDdl,
+  createPolicyDdl,
+  createRoutineDdl,
+  createSchemaDdl,
+  createSequenceDdl,
+  createViewDdl,
+  ddlType,
+  dropRoutineDdl,
+  dropViewDdl,
+  enableRlsDdl,
+  generatedColumnDdl,
+  qualify,
+  quoteId,
+  replaceRoutineStatements,
+  routineFingerprint,
+} from '@zmdb/sql/schema-objects';
+export {
+  type ExtensionDef,
+  type GeneratedColumn,
+  type IndexColumn,
+  type IndexDef,
+  type IndexMethod,
+  type RlsPolicy,
+  type RoutineDef,
+  type RoutineSqlType,
+  type SequenceDef,
+  type ViewDef,
+} from '@zmdb/sql/schema-objects';
+
+export { singularPascalCase } from '@zmdb/schema/naming';

package/src/tags.ts

@@ -0,0 +1,33 @@
+// zmdb/tags — explicit named type exports for schema declarations.
+// The inline type specifiers erase their bindings. With verbatimModuleSyntax,
+// the emitted module retains an empty re-export from @zmdb/schema/tags.
+export {
+  type Codec,
+  type Ext,
+  type Fts,
+  type HasDefault,
+  type Length,
+  type ManyToMany,
+  type ManyToOne,
+  type Max,
+  type MaxLength,
+  type Min,
+  type MinLength,
+  type NonNull,
+  type Nullable,
+  type Numeric,
+  type OneToMany,
+  type OneToOne,
+  type Pattern,
+  type Physical,
+  type PrimaryKey,
+  type Proto,
+  type ProtoField,
+  type References,
+  type Rule,
+  type Sensitive,
+  type Serial,
+  type Sql,
+  type Table,
+  type Unique,
+} from '@zmdb/schema/tags';

package/src/testing/official-dialects.fixture.ts

@@ -0,0 +1,24 @@
+import { cockroach } from '@zmdb/cockroach';
+import { mssql } from '@zmdb/mssql';
+import { mysql } from '@zmdb/mysql';
+import { postgres } from '@zmdb/postgres';
+import { singlestore } from '@zmdb/singlestore';
+import { sqlite } from '@zmdb/sqlite';
+
+export const cockroachDialect = cockroach;
+export const mssqlDialect = mssql;
+export const mysqlDialect = mysql;
+export const postgresDialect = postgres;
+export const singlestoreDialect = singlestore;
+export const sqliteDialect = sqlite;
+
+export const officialDialects = Object.freeze({
+  cockroach: cockroachDialect,
+  mssql: mssqlDialect,
+  mysql: mysqlDialect,
+  postgres: postgresDialect,
+  singlestore: singlestoreDialect,
+  sqlite: sqliteDialect,
+});
+
+export type OfficialDialectName = keyof typeof officialDialects;

package/src/testing.ts

@@ -0,0 +1,7 @@
+// Product-level test application and compiler-backed schema helpers.
+
+export { schemaIrsFrom, schemasFrom, schemasFromFiles } from '@zmdb/compiler/testing';
+export type { SchemasFromFilesOptions, SchemasFromOptions } from '@zmdb/compiler/testing';
+
+export { createTestApp } from '@zmdb/web/testing';
+export type { TestApp, TestAppOptions } from '@zmdb/web/testing';

package/src/validator.ts

@@ -0,0 +1,44 @@
+// Runtime validation, rule composition, and serialization. Compiler-backed
+// reflection and transforms live under `@zmdb/core/compiler`.
+
+export {
+  AssertError,
+  assert,
+  assertEquals,
+  assertShallow,
+  equals,
+  failWith,
+  is,
+  isShallow,
+  issuesFor,
+  random,
+  validate,
+  validateShallow,
+} from '@zmdb/validator';
+export { type TypeIR, type ValidateResult, type ValidationIssue } from '@zmdb/validator';
+
+export { coerce, discriminated, evalRule, refine, transform, union, validateObject } from '@zmdb/validator/advanced';
+export {
+  type Brand,
+  type DiscriminatedRule,
+  type ObjectMode,
+  type RefinePredicate,
+  type RefineRule,
+  type TransformFn,
+  type TransformRule,
+  type UnionRule,
+} from '@zmdb/validator/advanced';
+
+export { assertStringify, decode, parse, stringify } from '@zmdb/validator/serialization';
+export { type ParseResult } from '@zmdb/validator/serialization';
+
+export {
+  MAX_REGEX_CACHE_SIZE,
+  ValidationError,
+  getCachedRegExp,
+  getEnumSet,
+  getRegExp,
+  tags,
+  validatePatternComplexity,
+} from '@zmdb/validator';
+export { type Rule } from '@zmdb/validator';

package/src/web-app.ts

@@ -0,0 +1,9 @@
+// zmdb/web/app — curated HTTP application-composition facade.
+export { createApp } from '@zmdb/web/app';
+export type {
+  OnApplicationBootstrap,
+  OnModuleInit,
+  OnShutdown,
+  WebApplication,
+  WebApplicationOptions,
+} from '@zmdb/web/app';

package/src/web-compression.ts

@@ -0,0 +1,3 @@
+// zmdb/web/compression — curated HTTP compression facade.
+export { compress, compressionInterceptor } from '@zmdb/web/compression';
+export type { CompressionOptions, ContentCoding } from '@zmdb/web/compression';

package/src/web-context.ts

@@ -0,0 +1,3 @@
+// zmdb/web/context — curated request-context facade.
+export { compilePattern, countSegments, extractParams, matchCompiled } from '@zmdb/web/context';
+export type { CompiledPattern, Ctx, HandlerFor, PathParams, QueryValues } from '@zmdb/web/context';

package/src/web-contract-compiler.ts

@@ -0,0 +1,7 @@
+// zmdb/web/contract/compiler — curated build-time re-export.
+export { compileHttpContracts, generateHttpClient, HTTP_CLIENT_GENERATOR_VERSION } from '@zmdb/web/contract/compiler';
+export type {
+  CompileHttpContractsOptions,
+  GeneratedHttpClientModule,
+  HttpContractSource,
+} from '@zmdb/web/contract/compiler';

package/src/web-contract.ts

@@ -0,0 +1,36 @@
+// zmdb/web/contract — curated runtime re-export of @zmdb/web/contract.
+export { defineHttpContract, httpOperation } from '@zmdb/web/contract';
+export type {
+  AuthorizationCodeFlow,
+  ClientCredentialsFlow,
+  CompiledHttpContract,
+  CompiledHttpOperation,
+  HttpBodyDeclaration,
+  HttpBodyIR,
+  HttpBodyKind,
+  HttpContractDeclaration,
+  HttpContractIR,
+  HttpController,
+  HttpMethod,
+  HttpOperationDeclaration,
+  HttpOperationIR,
+  HttpOperationTypes,
+  HttpParameterDeclaration,
+  HttpParameterIR,
+  HttpRequestBodyDeclaration,
+  HttpRequestBodyIR,
+  HttpResponseDeclaration,
+  HttpResponseHeaderDeclaration,
+  HttpResponseHeaderIR,
+  HttpResponseIR,
+  HttpTypeIR,
+  HttpVersionDeclaration,
+  HttpVersionIR,
+  ImplicitFlow,
+  JsonValue,
+  OAuthFlow,
+  OAuthFlows,
+  PasswordFlow,
+  SecurityRequirement,
+  SecurityScheme,
+} from '@zmdb/web/contract';

package/src/web-csrf.ts

@@ -0,0 +1,3 @@
+// zmdb/web/csrf — curated CSRF facade.
+export { createCsrf } from '@zmdb/web/csrf';
+export type { Csrf, CsrfOptions } from '@zmdb/web/csrf';

package/src/web-data.ts

@@ -0,0 +1,2 @@
+// zmdb/web/data — curated HTTP data-conversion facade.
+export { validateWith, wireDecoder, wireEncoder } from '@zmdb/web/data';

package/src/web-devtools.ts

@@ -0,0 +1,12 @@
+// zmdb/web/devtools — curated HTTP graph-inspection facade.
+export { dependentsOf, describeGraph, renderDot, renderTree } from '@zmdb/web/devtools';
+export type {
+  ClassNode,
+  Finding,
+  FindingKind,
+  GraphDescription,
+  GraphFilter,
+  ModuleNode,
+  ProviderNode,
+  RouteNode,
+} from '@zmdb/web/devtools';

package/src/web-dto-pipes.ts

@@ -0,0 +1,3 @@
+// zmdb/web/dto-pipes — curated validation and serialization-pipe facade.
+export { decodePipe, dtoChain, multipartPipe, serializationInterceptor, validationPipe } from '@zmdb/web/dto-pipes';
+export type { DtoChainOptions } from '@zmdb/web/dto-pipes';

package/src/web-gateways.ts

@@ -0,0 +1,3 @@
+// zmdb/web/gateways — curated WebSocket and SSE declaration facade.
+export { Gateway, Subscribe, createGatewayDispatcher, getSubscriptions, sseStream } from '@zmdb/web/gateways';
+export type { GatewayDispatcher, MessageCtx, SseFrame, Subscription } from '@zmdb/web/gateways';

package/src/web-health.ts

@@ -0,0 +1,3 @@
+// zmdb/web/health — curated HTTP health-route facade.
+export { detailedReadyRoute, healthRoutes } from '@zmdb/web/health';
+export type { DetailedBody, HealthProbes } from '@zmdb/web/health';

package/src/web-middleware.ts

@@ -0,0 +1,12 @@
+// zmdb/web/middleware — curated HTTP middleware-chain facade.
+export { ChainError, runChain } from '@zmdb/web/middleware';
+export type {
+  AnyCtx,
+  Chain,
+  ChainHandler,
+  ExceptionFilter,
+  Guard,
+  Interceptor,
+  Pipe,
+  SecurityAwareGuard,
+} from '@zmdb/web/middleware';

package/src/web-openapi.ts

@@ -0,0 +1,15 @@
+// zmdb/web/openapi — curated OpenAPI projection facade.
+export { serveOpenApi, toOpenApi } from '@zmdb/web/openapi';
+export type {
+  AuthorizationCodeFlow,
+  ClientCredentialsFlow,
+  ImplicitFlow,
+  JsonSchema,
+  OAuthFlow,
+  OAuthFlows,
+  OpenApiDocument,
+  OpenApiRenderOptions,
+  PasswordFlow,
+  SecurityRequirement,
+  SecurityScheme,
+} from '@zmdb/web/openapi';