@ 经典/原始

框架-不可知类型Script原始相通 Classytic 包共享. 零运行时间依赖关系. 仅限无害环境管理。 节点22+.

这些是每个经典套件的共同点: Money, (中文(简体) ), DomainEvent, (中文(简体) ), OperationContext,多形态的参考文献。 当a 软件包重复其中的一个形状, 它漂移—— 这个软件包存在所以它 没有.

0.3.0)的加农合同搬迁. 三个模块搬出 @classytic/repo-core 因此,包和弧 看见一个真理的来源 而不是 两个:

• 倾斜 (单位:千美元)OffsetPaginationResult, (中文(简体) ), KeysetPaginationResult, (中文(简体) ), AggregatePaginationResult, (中文(简体) ), PaginationResult, (中文(简体) ), toCanonicalList()页:1 @classytic/repo-core/pagination。 。 。 .
• 租户配置 (单位:千美元)TenantConfig, (中文(简体) ), TenantStrategy, (中文(简体) ), TenantFieldType, (中文(简体) ), resolveTenantConfig, (中文(简体) ), DEFAULT_TENANT_CONFIG, (中文(简体) ), ResolvedTenantConfig页:1 @classytic/repo-core/tenant蒙戈基特和斯克利特基特的电影 MultiTenantOptions extends Pick<TenantConfig, ...>。 。 。 .
• 错误合同 (单位:千美元)HttpError 可抛出, ErrorContract 电线形状, ErrorDetail, (中文(简体) ), ErrorCode, (中文(简体) ), ERROR_CODES, (中文(简体) ), toErrorContract(), (中文(简体) ), statusToErrorCode()页:1 @classytic/repo-core/errors。 。 。 . ArcError implements HttpError。 。 。 .

事情在这里. @classytic/primitives/events 仍为克尼克 来源 EventMeta, (中文(简体) ), DomainEvent, (中文(简体) ), EventHandler, (中文(简体) ), EventLogger, (中文(简体) ), EventTransport, (中文(简体) ), DeadLetteredEvent, (中文(简体) ), PublishManyResult, (中文(简体) ), createEvent, (中文(简体) ), createChildEvent, (中文(简体) ), matchEventPattern弧 2.12 只再出口 运行时间 MemoryEventTransport。 。 。 .

安装

npm install @classytic/primitives

使用

偏爱 子路径导入 ——每个关切都是自己的入门点,类型去除 在编译时间,运行时间的帮助是很小的.

import { addMoney, fromMajor, type Money } from '@classytic/primitives/money';
import { createEvent, type DomainEvent, type EventTransport } from '@classytic/primitives/events';
import type { OperationContext } from '@classytic/primitives/context';
import { allocate, type SplitResult } from '@classytic/primitives/split-allocation';
// Tenant config, error contracts, and pagination now live in repo-core:
import { resolveTenantConfig, type TenantConfig } from '@classytic/repo-core/tenant';
import type { HttpError, ErrorContract } from '@classytic/repo-core/errors';
import type {
  OffsetPaginationResult, KeysetPaginationResult, AggregatePaginationResult,
} from '@classytic/repo-core/pagination';

有故意的,有故意的,没有故意的 无根管 - 一个管子迫使节点无害环境管理 加载器和 TypeScript 编译器在单一方便下行走每个模块 导入,可使 CI 慢化,并将未使用的代码拖入消费者的图表。 使用 仅导入子路径 .

里面的东西

设计

货币——整数小单位,总是

import { fromMajor, addMoney, toMajor } from '@classytic/primitives/money';

const subtotal = fromMajor(19.99, 'USD');     // { amount: 1999, currency: 'USD' }
const shipping = fromMajor(5.00,  'USD');     // { amount: 500,  currency: 'USD' }
const total    = addMoney(subtotal, shipping); // { amount: 2499, currency: 'USD' }
toMajor(total);                                // 24.99

Money.amount 总是货币小单位的整数—— 1 =一个 美元1分,日元1分,科威特第纳尔1分。 混合货币抛出 CurrencyMismatchError这消除了浮起的漂移 当每个软件包卷起时 { amount: number, currency: string }。 。 。 .

域事件——结构与Arc相同

import { createEvent, type EventTransport } from '@classytic/primitives/events';

const event = createEvent('order:placed', { orderId: 'ord_123' }, {
  organizationId: ctx.organizationId,
  userId: ctx.actorId,
  correlationId: ctx.correlationId,
});

await transport.publish(event);

形状匹配 @classytic/arc是因为 DomainEvent 完全——任何弧形运输 (memory, Redis pub/sub, Redis Streams, Kafka) 插件插入到一个期待的包中 此接口没有适配器 。 见PACKAGE RULES.md 第11节.

租户联合会——迁至 @classytic/repo-core/tenant

import { resolveTenantConfig } from '@classytic/repo-core/tenant';

const tenant = resolveTenantConfig(config.tenant);
// { enabled: true, tenantField: 'organizationId', fieldType: 'objectId',
//   ref: 'organization', contextKey: 'organizationId', required: true }

蒙哥基特语 MultiTenantOptions 和sqlitekit的等同两个 extends Pick<TenantConfig, ...> 从repo-core——通过解析的配置 直接进入 multiTenantPlugin(resolved)。 。 。 .

外部参考文献——多形态,无框架

interface ExternalRef {
  sourceId: string;
  sourceModel: string;
}

对于跨越信任界限的参考文献(另一个软件包,另一个服务, Friede, Postgres)——与主机对接 SourceBridge为 ObjectId,UUID,花脸身份证,任何东西。 见PACKAGE RULES.md 第7节.

什么不是这里(目的)

• 鼠类类型 ——使用 ObjectIdLike 从 /reference。任何乌鸦 Types.ObjectId 满足它的结构.
• 交易/ 顺序/ 墨盒形状 - 这些是域类型,不是 原始的 原始的 原始的 他们住在各自的包裹里.
• 错误子类 - 抛出平地 Errors; 主机将其序列化为 ErrorContract (从) @classytic/repo-core/errors在 HTTP 边界 通过 toErrorContract(err)。 。 。 .
• 运行时货币数据库 在应用层装白名单 需要一个. MINOR_UNIT_FACTOR 涵盖普通案件.

许可证

麻省理工学院