@arts-n-crafts/ts 3.19.0 → 5.0.0-rc.2

package/packages/v5/dist/useCases/command/shapes/index.d.ts

@@ -0,0 +1,78 @@
+import { M as Message } from '../../../Message-c9XdBoh4.js';
+import { D as DomainEvent } from '../../../DomainEvent-w1jyCjai.js';
+import { I as Intent } from '../../../Intent-BLNY6RoG.js';
+import { R as Rejection } from '../../../Rejection-D9PlzquK.js';
+
+/**
+ * Represents a successful decision made by a decider.
+ *
+ * An accepted decision is the result of a command passing all business rules.
+ * It carries one or more domain events to be appended to the event stream,
+ * and zero or more intents to be staged in the outbox.
+ *
+ * An accepted decision does NOT mean the command has been fully processed —
+ * it means the domain has decided what should happen. Infrastructure concerns
+ * (persisting events, dispatching intents) are handled by the use case handler.
+ */
+type Accepted<TEvent extends DomainEvent, TIntent extends Intent = never> = {
+    readonly accepted: true;
+    readonly events: [TEvent, ...TEvent[]];
+    readonly intents: TIntent[];
+};
+/**
+ * Represents a rejection decision made by a decider.
+ *
+ * A rejection is a first-class business outcome — not an exception or an error.
+ * It means the command was valid and understood, but one or more business rules
+ * prevented it from being accepted. The domain explicitly said no.
+ *
+ * Rejections are never appended to the event stream. They may be recorded in
+ * an audit log by the use case handler, and can be published as an integration
+ * event if other bounded contexts need to know the command did not get through.
+ */
+type Rejected<TRejection extends Rejection> = {
+    readonly accepted: false;
+    readonly rejection: TRejection;
+};
+/**
+ * The return type of a decider's decide() function.
+ *
+ * A Decision is a discriminated union on `accepted`, enabling exhaustive
+ * pattern matching at the use case handler and adapter level.
+ *
+ * Both `Accepted` and `Rejected` are expected business outcomes and are
+ * returned as `Ok` from the use case. Only infrastructure failures such as
+ * a unavailable event store are modelled as `Err` via `GatewayFailure`.
+ *
+ * @example
+ * // Use case handler
+ * const decision = decider.decide(command, state);
+ *
+ * if (!decision.accepted) {
+ *   await auditLog.record(command, decision.rejection);
+ * }
+ *
+ * return okAsync(decision);
+ *
+ * @example
+ * // Adapter
+ * const result = await useCase.execute(command);
+ *
+ * result.match(
+ *   (decision) => {
+ *     if (!decision.accepted) {
+ *       const status = rejectionCodeToStatus[decision.rejection.code];
+ *       return reply.status(status).send({ error: decision.rejection.reason });
+ *     }
+ *     return reply.status(200).send({ events: decision.events });
+ *   },
+ *   (error) => reply.status(503).send({ error: 'Service unavailable' }) // GatewayFailure
+ * );
+ */
+type Decision<TEvent extends DomainEvent, TIntent extends Intent = never, TRejection extends Rejection = never> = Accepted<TEvent, TIntent> | Rejected<TRejection>;
+
+interface Command<TType = string, TPayload = unknown> extends Message<TType, TPayload> {
+    readonly kind: "command";
+}
+
+export type { Accepted, Command, Decision, Rejected };

package/packages/v5/dist/useCases/command/shapes/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/packages/v5/dist/useCases/command/shapes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/packages/v5/dist/useCases/policy/capabilities/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/packages/v5/dist/useCases/policy/capabilities/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/packages/v5/dist/useCases/policy/capabilities/index.d.cts

@@ -0,0 +1,12 @@
+import { I as Intent } from '../../../Intent-B6l0bHZU.cjs';
+import '../../../Message-c9XdBoh4.cjs';
+
+interface HandleIntent<TIntent extends Intent, TResult = Promise<void>> {
+    handle(input: TIntent): TResult;
+}
+
+interface RelayPendingIntents<TResult = Promise<void>> {
+    relay(): TResult;
+}
+
+export type { HandleIntent, RelayPendingIntents };

package/packages/v5/dist/useCases/policy/capabilities/index.d.ts

@@ -0,0 +1,12 @@
+import { I as Intent } from '../../../Intent-BLNY6RoG.js';
+import '../../../Message-c9XdBoh4.js';
+
+interface HandleIntent<TIntent extends Intent, TResult = Promise<void>> {
+    handle(input: TIntent): TResult;
+}
+
+interface RelayPendingIntents<TResult = Promise<void>> {
+    relay(): TResult;
+}
+
+export type { HandleIntent, RelayPendingIntents };

package/packages/v5/dist/useCases/policy/capabilities/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/packages/v5/dist/useCases/policy/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/packages/v5/dist/useCases/query/capabilities/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/packages/v5/dist/useCases/query/capabilities/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/packages/v5/dist/useCases/query/capabilities/index.d.cts

@@ -0,0 +1,8 @@
+import { Query } from '../shapes/index.cjs';
+import '../../../Message-c9XdBoh4.cjs';
+
+interface HandleQuery<TQuery extends Query, TData = Promise<object>> {
+    handle(input: TQuery): TData;
+}
+
+export type { HandleQuery };

package/packages/v5/dist/useCases/query/capabilities/index.d.ts

@@ -0,0 +1,8 @@
+import { Query } from '../shapes/index.js';
+import '../../../Message-c9XdBoh4.js';
+
+interface HandleQuery<TQuery extends Query, TData = Promise<object>> {
+    handle(input: TQuery): TData;
+}
+
+export type { HandleQuery };

package/packages/v5/dist/useCases/query/capabilities/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/packages/v5/dist/useCases/query/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/packages/v5/dist/useCases/query/shapes/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/packages/v5/dist/useCases/query/shapes/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/packages/v5/dist/useCases/query/shapes/index.d.cts

@@ -0,0 +1,7 @@
+import { M as Message } from '../../../Message-c9XdBoh4.cjs';
+
+interface Query<TType = string, TPayload = unknown> extends Message<TType, TPayload> {
+    readonly kind: "query";
+}
+
+export type { Query };

package/packages/v5/dist/useCases/query/shapes/index.d.ts

@@ -0,0 +1,7 @@
+import { M as Message } from '../../../Message-c9XdBoh4.js';
+
+interface Query<TType = string, TPayload = unknown> extends Message<TType, TPayload> {
+    readonly kind: "query";
+}
+
+export type { Query };

package/packages/v5/dist/useCases/query/shapes/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/packages/v5/dist/useCases/query/shapes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/packages/v5/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@arts-n-crafts/ts-v5-package",
+  "version": "5.0.0",
+  "private": true,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arts-n-crafts/typescript.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "scripts": {
+    "dev": "bun run --hot examples/shell/main.ts",
+    "lint": "oxlint src/",
+    "lint:fix": "oxlint --fix src/",
+    "fmt": "oxfmt src/",
+    "fmt:check": "oxfmt --check src/",
+    "test": "NODE_ENV=test vitest",
+    "test:watch": "NODE_ENV=test vitest --coverage --watch",
+    "test:ui": "NODE_ENV=test vitest --watch --coverage --ui",
+    "coverage": "NODE_ENV=test vitest --coverage",
+    "typecheck": "tsc --noEmit",
+    "build": "rimraf dist && tsup"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@cucumber/cucumber": "^12.8.3",
+    "@hono/standard-validator": "^0.2.2",
+    "@release-it/bumper": "^7.0.5",
+    "@types/bun": "^1.3.12",
+    "@vitest/coverage-istanbul": "^4.1.5",
+    "@vitest/ui": "^4.1.5",
+    "changelogen": "^0.6.2",
+    "commitizen": "^4.3.1",
+    "countries-list": "^3.3.0",
+    "cz-conventional-changelog": "^3.3.0",
+    "globals": "^17.5.0",
+    "hono": "^4.12.18",
+    "husky": "^9.1.7",
+    "oxfmt": "^0.46.0",
+    "oxide.ts": "^1.1.0",
+    "oxlint": "^1.61.0",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "uuid": "^14.0.0",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.1.5",
+    "zod": "^4.4.2"
+  },
+  "peerDependencies": {
+    "typescript": "^6.0.3"
+  }
+}