ddd-ts-kit 0.12.0 → 0.13.0

package/README.md

@@ -38,8 +38,8 @@ its limits, `2` wrong usage (the message says what to do).
 ## init
 
 ```
-ddd-ts-kit init [--http express|fastify|nest|none]
-                [--validation zod|class-validator|standard-schema|none]
+ddd-ts-kit init [--http express|fastify|hono|nest|none]
+                [--validation zod|class-validator|typebox|standard-schema|none]
                 [--di tsyringe|nest|manual] [--tests vitest|jest]
                 [--orm drizzle|knex|prisma|typeorm|custom|none]
                 [--database postgres|mysql|sqlite|none]
@@ -53,6 +53,7 @@ ddd-ts-kit init [--http express|fastify|nest|none]
                 [--dependencies signature|listed] [--refusals factories|classes]
                 [--routes controllers|functions] [--value-objects throwing|result]
                 [--literals named|free] [--tenancy none|shared-table] [--queue database|redis|memory]
+                [--schemas shared|per-route]
                 [--package-manager npm|pnpm]
                 [--allow-no-outbox "<reason>"] [--import-alias '$<name>/']
                 [--import-extension none|js] [--sdk]
@@ -165,6 +166,13 @@ file. `--routes functions`, or a config without the key, keeps one `defineRoute`
 route, listed in `<context>.routes.ts`, as 0.1 to 0.3 wrote them; `controllers` moves a
 project from one to the other, a context at a time.
 
+**A shape is declared once.** `init` writes `"stack.schemas": "shared"`: a command route answers
+its identifier with `acceptedSchema` of `@ddd-ts-kit/http`, one `Accepted` component in the
+contract, and `generate schema <context> <Name>` (or `schema shared-kernel <Name>`) writes a
+shape several routes use, which the contract documents once and every route refers to. The
+`schema/*` rules hold that form. `--schemas per-route`, or a config without the key, keeps one
+schema per route, an identifier answer included, as 0.1 to 0.5 wrote them.
+
 **A value object throws its refusals.** `init` writes `"stack.valueObjects": "throwing"`:
 `generate value-object` writes a `create` that returns the value object or throws the refusal of
 its concept, and a spec that asserts it with `expectRefusal(() => ..)`. `--value-objects result`,
@@ -281,6 +289,7 @@ ddd-ts-kit generate --help --json
 | `controller` | the same arguments as `route` | the controller class, whatever `stack.routes` says: for a project of function routes that writes its next route as a class. `--cache` writes its cache policy: `private` (a `GET` of a caller, `max-age=0`, `must-revalidate`, strong `ETag`), `public` (a `GET` of a public use case, `max-age` 1m, `s-maxage` 5m, tagged with the resources of its path), `no-store`; refused on a write, and `public` behind a route group |
 | `route-group` (`group`) | `<context> <Name> [--prefix <path>] [--group <ParentName>] [--public \| --role <role>]` | `presentation/http/<name>.routes.ts`: an empty class carrying `@RouteGroup`, behind `Authenticated` unless `--public` or `--role` says otherwise (`HasRole(Role.Admin)`, the role read from the vocabulary of the platform, `<platformDir>/auth/role.ts`, which gets it when it does not hold it); with `--group` it refines that group and inherits from it |
 | `guard` | `<context> <Name>` | `presentation/http/guards/<name>.guard.ts`: a declared guard class to fill, and its spec |
+| `schema` | `<context\|shared-kernel> <Name>` | `presentation/http/shared/<name>.schema.ts` of the context, or `presentation/<name>.schema.ts` of the shared kernel: one shape of the contract declared once (a zod schema with `.meta({ id })`, a class-validator class, or a schema wrapped by `sharedSchema`), to fill; the routes use it whole, nested or in part |
 | `integration-event` | `<context> <Aggregate> <Fact> [--version n]` | `defineIntegrationEvent` declaration in the published language (its payload in `<event>.v<n>.payload.ts` with class-validator or a schema of your own), index export, the publisher `application/integration/publishers/<event>.publisher.ts`, spec, registration, a line of `platform/audit/audited-events.ts` |
 | `integration-handler` (`consumer`) | `<context> <upstreamContext> <eventType>` | `application/integration/handlers/<name>.integration-handler.ts`, a class `<Name>IntegrationHandler` depending on `CommandBus`, its spec, its idempotent subscription under the consumer name `<context>.<name>`; refused unless the upstream is declared |
 | `event-handler` | `<context> <Aggregate> <Fact> [--phase after-commit]` | reaction to a domain event of the context, spec, subscription; before the commit of the unit of work by default, after it with `--phase after-commit` (an effect no transaction covers, at most once), and the spec runs the reaction in that phase |
@@ -800,6 +809,8 @@ saying what to do instead. Exit code 1 when there is at least one error.
 | `scheduling/job-triggers-use-case` | in `application/scheduling/*.job.ts`: an exported class that does not implement `ScheduledJob`; a `run` that sends no command (no `.execute(` call); a repository in the dependency list or the constructor; an import from `domain/aggregates/`, `domain/entities/`, `domain/services/` or `infrastructure/`. A `builder.job(..)` registration of a class that lives elsewhere |
 | `scheduling/job-name` | the first argument of `@Scheduled(..)` or `.job(..)` that is not a string literal `<context>.<job-name>` in lower-case kebab-case with the context of its file; a `systemActor(..)` of a job file passing another name; one job name used twice in the project |
 | `errors/code-unique` | under `"stack.refusals": "factories"`, in the `domain/errors/` of a context: a code set a second time, by a factory (`refusal('CODE', ..)`) or by a class (`readonly code = 'CODE'`), with the file and line of the first. The same code in two contexts is not reported |
+| `schema/presentation-only` | under `"stack.schemas": "shared"`: in the shared kernel outside `presentation/`, an import of a validation library; in `domain/`, `application/`, `infrastructure/`, `published-language/` and the shared kernel outside `presentation/`, an import of a file of `presentation/` of the shared kernel |
+| `schema/no-duplicate-shape` | under `"stack.schemas": "shared"`, in the presentation layer of one context, or in it and `presentation/` of the shared kernel: a DTO class or an object schema (`z.object`, `v.object`, `Type.Object`) declaring the shape of another one, with the place of the original (the shared kernel, then `presentation/http/shared/`); two contexts are not compared, and request parameters and shapes still carrying a `TODO(domain)` of the generator are not judged |
 | `errors/known-code` | under `"stack.refusals": "factories"`, in a `*.route.ts`: a code of the `errors` list that no refusal of the context of the route sets, that no class outside the contexts sets, and that is not a code of the kit |
 
 More ids belong to `@ddd-ts-kit/eslint-plugin`, which reads the syntax tree where this

package/dist/check/catalogue/architecture-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architecture-rules.d.ts","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA6E7C,gHAAgH;AAChH,eAAO,MAAM,kBAAkB,EAAE,SAAS,IAAI,EA4E7C,CAAC"}
+{"version":3,"file":"architecture-rules.d.ts","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA+E7C,gHAAgH;AAChH,eAAO,MAAM,kBAAkB,EAAE,SAAS,IAAI,EA8E7C,CAAC"}

package/dist/check/catalogue/architecture-rules.js

@@ -64,6 +64,8 @@ import { purityNoEnvironment } from '../rules/purity-no-environment.js';
 import { purityNoSystemClock } from '../rules/purity-no-system-clock.js';
 import { schedulingJobName } from '../rules/scheduling-job-name.js';
 import { schedulingJobTriggersUseCase } from '../rules/scheduling-job-triggers-use-case.js';
+import { schemaNoDuplicateShape } from '../rules/schema-no-duplicate-shape.js';
+import { schemaPresentationOnly } from '../rules/schema-presentation-only.js';
 import { standardNoParallelInterface } from '../rules/standard-no-parallel-interface.js';
 import { tenancyScopedStatement } from '../rules/tenancy-scoped-statement.js';
 import { testBuilderRequired } from '../rules/test-builder-required.js';
@@ -88,6 +90,8 @@ export const ARCHITECTURE_RULES = [
     namingSuffix,
     namingOneConceptPerFile,
     namingSearchNotList,
+    schemaPresentationOnly,
+    schemaNoDuplicateShape,
     testSpecRequired,
     eventsNameFormat,
     eventsDefinedInPublishedLanguage,

package/dist/check/catalogue/architecture-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"architecture-rules.js","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"architecture-rules.js","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"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"}

package/dist/check/explain/rule-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-docs.d.ts","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAoBpD,oGAAoG;AACpG,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBvD,CAAC"}
+{"version":3,"file":"rule-docs.d.ts","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAqBpD,oGAAoG;AACpG,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBvD,CAAC"}

package/dist/check/explain/rule-docs.js

@@ -12,6 +12,7 @@ import { LIFECYCLE_DOCS } from './lifecycle-docs.js';
 import { PERSISTENCE_DOCS } from './persistence-docs.js';
 import { PORTS_DOCS } from './ports-docs.js';
 import { SCHEDULING_DOCS } from './scheduling-docs.js';
+import { SCHEMA_DOCS } from './schema-docs.js';
 import { STANDARD_DOCS } from './standard-docs.js';
 import { TENANCY_DOCS } from './tenancy-docs.js';
 import { TREE_DOCS } from './tree-docs.js';
@@ -32,6 +33,7 @@ export const RULE_DOCS = {
     ...PERSISTENCE_DOCS,
     ...PORTS_DOCS,
     ...SCHEDULING_DOCS,
+    ...SCHEMA_DOCS,
     ...STANDARD_DOCS,
     ...TENANCY_DOCS,
     ...TREE_DOCS,

package/dist/check/explain/rule-docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"rule-docs.js","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAsC;IAC1D,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,mBAAmB;IACtB,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,cAAc;IACjB,GAAG,gBAAgB;IACnB,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,WAAW;CACf,CAAC"}
+{"version":3,"file":"rule-docs.js","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAsC;IAC1D,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,mBAAmB;IACtB,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,cAAc;IACjB,GAAG,gBAAgB;IACnB,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,WAAW;IACd,GAAG,aAAa;IAChB,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,WAAW;CACf,CAAC"}

package/dist/check/explain/schema-docs.d.ts

@@ -0,0 +1,3 @@
+import type { RuleDoc } from '../model/rule-doc.js';
+export declare const SCHEMA_DOCS: Readonly<Record<string, RuleDoc>>;
+//# sourceMappingURL=schema-docs.d.ts.map

package/dist/check/explain/schema-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-docs.d.ts","sourceRoot":"","sources":["../../../src/check/explain/schema-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzD,CAAC"}

package/dist/check/explain/schema-docs.js

@@ -0,0 +1,28 @@
+export const SCHEMA_DOCS = {
+    'schema/presentation-only': {
+        why: 'A schema says what a client sends or receives: it is a presentation type, and it changes with the contract, not with the model. The shared kernel is imported by every layer of every context, so a schema written there reaches the domain and the use cases, which then depend on the shape of a request. A schema shared by several contexts therefore lives under presentation/ of the shared kernel, and only presentation layers import it; a schema of one context lives in its presentation layer (domain/ and application/ are already refused any validation library by the layer rules). Judged: in the shared kernel outside presentation/, an import of a validation library (zod, class-validator, class-transformer, class-validator-jsonschema, valibot, arktype, TypeBox, @ddd-ts-kit/validation); in domain/, application/, infrastructure/ and published-language/ of a context, and in the shared kernel outside presentation/, an import of a file of presentation/ of the shared kernel. Specs are not judged. Judged under "stack.schemas": "shared" only.',
+        bad: `// shared-kernel/money.ts
+import { IsInt, IsString } from 'class-validator';
+export class MoneyDto { @IsInt() cents = 0; @IsString() currency = ''; }
+// contexts/billing/application/commands/issue-invoice/issue-invoice.command.ts
+import { MoneyDto } from '@/shared-kernel/presentation/money.schema';`,
+        good: `// shared-kernel/presentation/money.schema.ts
+export class Money { @IsInt() cents = 0; @IsString() currency = ''; }
+// contexts/billing/presentation/http/invoices/issue-invoice/issue-invoice.mapper.ts
+import type { Money } from '@/shared-kernel/presentation/money.schema';
+// maps Money to the command, which carries plain values`,
+    },
+    'schema/no-duplicate-shape': {
+        why: 'Two routes that declare the same shape by hand document it twice, as two unrelated schemas: the contract grows a copy per route, a client SDK generates two types for one thing, and the day the shape changes one copy is forgotten. Declared once and shared, it lands once in components.schemas and every route points at it with $ref; a route that needs a part of it derives that part (pick, omit, partial, extend) from the one declaration. Judged within one context, and between a context and presentation/ of the shared kernel: two contexts may declare the same structure, because an equal shape with two meanings is two concepts and sharing it would couple contexts that stay extractable. Compared: a DTO class (a class of the module that extends nothing, has no method and decorates each property), compared by its property names, their decorators with their arguments and whether each is optional; and the object of a schema builder (`z.object({...})`, `v.object({...})`, `Type.Object({...})`), compared by its entries whatever their order and layout. Empty shapes, shapes that still carry a TODO(domain) of the generator (every search line starts as `{ id }`), *.params.ts, *.query.ts and *.headers.ts files and the objects assigned to params, query or headers are not judged: a request parameter is documented per operation, never as a component. The original is the declaration of the shared kernel, then the one under presentation/http/shared/ of the context, then the first in path order; each copy is reported with the place of the original. Judged under "stack.schemas": "shared" only.',
+        bad: `// appointments/cancel-appointment/cancel-appointment.accepted.ts
+export class CancelAppointmentAccepted { @IsString() id = ''; }
+// appointments/confirm-appointment/confirm-appointment.accepted.ts
+export class ConfirmAppointmentAccepted { @IsString() id = ''; }`,
+        good: `// both controllers answer with the identifier schema of the platform
+import { acceptedSchema, type Accepted } from '@ddd-ts-kit/http';
+response: { status: 201, description: 'Done.', body: acceptedSchema },
+// a shape of the context, declared once: presentation/http/shared/slot.schema.ts
+export const slotSchema = z.object({ startsAt: z.iso.datetime(), endsAt: z.iso.datetime() }).meta({ id: 'Slot' });`,
+    },
+};
+//# sourceMappingURL=schema-docs.js.map

package/dist/check/explain/schema-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-docs.js","sourceRoot":"","sources":["../../../src/check/explain/schema-docs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAsC;IAC5D,0BAA0B,EAAE;QAC1B,GAAG,EAAE,mhCAAmhC;QACxhC,GAAG,EAAE;;;;sEAI6D;QAClE,IAAI,EAAE;;;;yDAI+C;KACtD;IACD,2BAA2B,EAAE;QAC3B,GAAG,EAAE,4jDAA4jD;QACjkD,GAAG,EAAE;;;iEAGwD;QAC7D,IAAI,EAAE;;;;mHAIyG;KAChH;CACF,CAAC"}

package/dist/check/fixtures/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAqCtC,CAAC"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAsCtC,CAAC"}

package/dist/check/fixtures/fixtures.js

@@ -29,6 +29,7 @@ import { PERSISTENCE_FIXTURES } from './persistence-fixtures.js';
 import { PORTS_FIXTURES } from './ports-fixtures.js';
 import { PURITY_FIXTURES } from './purity-fixtures.js';
 import { SCHEDULING_FIXTURES } from './scheduling-fixtures.js';
+import { SCHEMA_FIXTURES } from './schema-fixtures.js';
 import { STANDARD_FIXTURES } from './standard-fixtures.js';
 import { TENANCY_FIXTURES } from './tenancy-fixtures.js';
 import { TEST_FIXTURES } from './test-fixtures.js';
@@ -53,6 +54,7 @@ export const FIXTURES = [
     ...DECLARATIONS_FIXTURES,
     ...DOMAIN_EVENTS_FIXTURES,
     ...ERRORS_FIXTURES,
+    ...SCHEMA_FIXTURES,
     ...EVENT_SOURCING_FIXTURES,
     ...EVENTS_FIXTURES,
     ...EXTENSION_FIXTURES,

package/dist/check/fixtures/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"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"}

package/dist/check/fixtures/schema-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Fixture } from './fixture.js';
+export declare const SCHEMA_FIXTURES: readonly Fixture[];
+//# sourceMappingURL=schema-fixtures.d.ts.map

package/dist/check/fixtures/schema-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/schema-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA+M5C,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EAAkD,CAAC"}

package/dist/check/fixtures/schema-fixtures.js

@@ -0,0 +1,129 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { config } from './config.js';
+import { PATHS } from './paths.js';
+import { project } from './project.js';
+import { source } from './source.js';
+const { BILLING } = PATHS;
+const HTTP = `${BILLING}/presentation/http/invoices`;
+const SHARED = { [CONFIG_FILE]: config({ stack: { schemas: 'shared' } }) };
+const MONEY_SCHEMA = 'src/shared-kernel/presentation/money.schema.ts';
+const LOOSE_MONEY = 'src/shared-kernel/money.ts';
+const MAPPER = `${HTTP}/issue-invoice/issue-invoice.mapper.ts`;
+const ISSUE_ACCEPTED = `${HTTP}/issue-invoice/issue-invoice.accepted.ts`;
+const VOID_ACCEPTED = `${HTTP}/void-invoice/void-invoice.accepted.ts`;
+const ISSUE_PARAMS = `${HTTP}/issue-invoice/issue-invoice.params.ts`;
+const VOID_PARAMS = `${HTTP}/void-invoice/void-invoice.params.ts`;
+const ISSUE_CONTROLLER = `${HTTP}/issue-invoice/issue-invoice.controller.ts`;
+const AMEND_CONTROLLER = `${HTTP}/amend-invoice/amend-invoice.controller.ts`;
+const SHARED_SLOT = `${BILLING}/presentation/http/shared/slot.schema.ts`;
+const ISSUE_BODY = `${HTTP}/issue-invoice/issue-invoice.body.ts`;
+const CATALOG_ACCEPTED = `${PATHS.CATALOG}/presentation/http/products/list-product/list-product.accepted.ts`;
+const ISSUE_LINE = `${HTTP}/search-invoices/search-invoices.line.ts`;
+const VOID_LINE = `${HTTP}/search-voided-invoices/search-voided-invoices.line.ts`;
+const money = (name) => source("import { IsInt, IsString } from 'class-validator';", '', `export class ${name} {`, '  @IsInt()', '  cents = 0;', '', '  @IsString()', "  currency = '';", '}');
+const dto = (name, property) => source("import { IsString } from 'class-validator';", '', `export class ${name} {`, '  @IsString()', `  ${property} = '';`, '}');
+/** A line as `generate query --search` writes it: an identifier and the mark of what is left to declare. */
+const generatedLine = (name) => source("import { IsString } from 'class-validator';", '', `export class ${name} {`, '  @IsString()', "  id = '';", '', '  // TODO(domain): declare the fields that are part of the public contract.', '}');
+const GENERATED_ZOD_LINE = 'z.object({\n  id: z.string(),\n  // TODO(domain): declare the public fields.\n})';
+const MAPPING = source("import type { Money } from '@/shared-kernel/presentation/money.schema.js';", '', 'export class IssueInvoiceMapper {', '  amountOf(money: Money): number {', '    return money.cents;', '  }', '}');
+const COMMAND_READING_A_SCHEMA = source("import type { Money } from '@/shared-kernel/presentation/money.schema.js';", '', 'export class IssueInvoiceCommand {', '  constructor(readonly amount: Money) {}', '}');
+const controller = (body) => source("import { z } from 'zod';", "import { zodSchema } from '@ddd-ts-kit/validation/zod';", '', `export const body = zodSchema(${body});`);
+const PRESENTATION_ONLY = [
+    {
+        ruleId: 'schema/presentation-only',
+        name: 'a schema shared by the contexts under presentation/ of the shared kernel, read by a presentation layer',
+        expect: 'pass',
+        files: project({ [MONEY_SCHEMA]: money('Money'), [MAPPER]: MAPPING }, SHARED),
+    },
+    {
+        ruleId: 'schema/presentation-only',
+        name: 'a schema declared in the shared kernel outside presentation/',
+        expect: { file: LOOSE_MONEY },
+        files: project({ [LOOSE_MONEY]: money('Money') }, SHARED),
+    },
+    {
+        ruleId: 'schema/presentation-only',
+        name: 'a command that carries a schema of presentation/ of the shared kernel',
+        expect: { file: PATHS.COMMAND },
+        files: project({ [MONEY_SCHEMA]: money('Money'), [PATHS.COMMAND]: COMMAND_READING_A_SCHEMA }, SHARED),
+    },
+    {
+        ruleId: 'schema/presentation-only',
+        name: 'a project that does not say how it writes its schemas is not judged',
+        expect: 'pass',
+        files: project({ [LOOSE_MONEY]: money('Money') }),
+    },
+];
+const NO_DUPLICATE_SHAPE = [
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two answers of different shapes',
+        expect: 'pass',
+        files: project({ [ISSUE_ACCEPTED]: dto('IssueInvoiceAccepted', 'id'), [VOID_ACCEPTED]: dto('VoidInvoiceAccepted', 'reference') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two DTO classes declaring the same properties with the same constraints',
+        expect: { file: VOID_ACCEPTED },
+        files: project({ [ISSUE_ACCEPTED]: dto('IssueInvoiceAccepted', 'id'), [VOID_ACCEPTED]: dto('VoidInvoiceAccepted', 'id') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two zod bodies declaring the same entries in another order and layout',
+        expect: { file: ISSUE_CONTROLLER },
+        files: project({
+            [AMEND_CONTROLLER]: controller('z.object({ cents: z.number().int(), currency: z.string().length(3) })'),
+            [ISSUE_CONTROLLER]: controller('z.object({\n  currency: z.string().length(3),\n  cents: z.number().int(),\n})'),
+        }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two routes reading the same path parameter',
+        expect: 'pass',
+        files: project({ [ISSUE_PARAMS]: dto('IssueInvoiceParams', 'invoiceId'), [VOID_PARAMS]: dto('VoidInvoiceParams', 'invoiceId') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two contexts declaring the same shape, each in its own words',
+        expect: 'pass',
+        files: project({ [ISSUE_ACCEPTED]: dto('IssueInvoiceAccepted', 'id'), [CATALOG_ACCEPTED]: dto('ListProductAccepted', 'id') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'a context copying a shape of presentation/ of the shared kernel',
+        expect: { file: CATALOG_ACCEPTED },
+        files: project({ [MONEY_SCHEMA]: money('Money'), [CATALOG_ACCEPTED]: money('ListProductAccepted') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'a route copying a shape its context shares, though its path sorts first',
+        expect: { file: ISSUE_BODY },
+        files: project({ [SHARED_SLOT]: money('Slot'), [ISSUE_BODY]: money('IssueInvoiceBody') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two search lines the generator left to fill',
+        expect: 'pass',
+        files: project({ [ISSUE_LINE]: generatedLine('SearchInvoicesLine'), [VOID_LINE]: generatedLine('SearchVoidedInvoicesLine') }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'two zod search lines the generator left to fill',
+        expect: 'pass',
+        files: project({
+            [AMEND_CONTROLLER]: controller(GENERATED_ZOD_LINE),
+            [ISSUE_CONTROLLER]: controller(GENERATED_ZOD_LINE),
+        }, SHARED),
+    },
+    {
+        ruleId: 'schema/no-duplicate-shape',
+        name: 'a project that does not say how it writes its schemas is not judged',
+        expect: 'pass',
+        files: project({
+            [ISSUE_ACCEPTED]: dto('IssueInvoiceAccepted', 'id'),
+            [VOID_ACCEPTED]: dto('VoidInvoiceAccepted', 'id'),
+        }),
+    },
+];
+export const SCHEMA_FIXTURES = [...PRESENTATION_ONLY, ...NO_DUPLICATE_SHAPE];
+//# sourceMappingURL=schema-fixtures.js.map

package/dist/check/fixtures/schema-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/schema-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/check/rules/schema-no-duplicate-shape.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const schemaNoDuplicateShape: Rule;
+//# sourceMappingURL=schema-no-duplicate-shape.d.ts.map

package/dist/check/rules/schema-no-duplicate-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-no-duplicate-shape.d.ts","sourceRoot":"","sources":["../../../src/check/rules/schema-no-duplicate-shape.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA4B7C,eAAO,MAAM,sBAAsB,EAAE,IA2BpC,CAAC"}

package/dist/check/rules/schema-no-duplicate-shape.js

@@ -0,0 +1,60 @@
+import { classShapes } from '../schemas/class-shapes.js';
+import { holdsSchemas } from '../schemas/holds-schemas.js';
+import { objectShapes } from '../schemas/object-shapes.js';
+import { restoredCode } from '../schemas/restored-code.js';
+import { sharesSchemas } from '../schemas/shares-schemas.js';
+import { reporter } from '../support/reporter.js';
+/** What a route reads from its path, its query string or its headers is documented per operation, never as a component. */
+const PARAMETER_FILE = /\.(?:params|query|headers)\.ts$/;
+/** Where a context keeps the shapes its routes share: the declaration there is the original, a copy elsewhere is reported. */
+const SHARED_OF_A_CONTEXT = '/presentation/http/shared/';
+/** The home of the shapes of the shared kernel: every context compares its shapes with them. */
+const KERNEL = '';
+const FIX = 'Declare the shape once, under presentation/http/shared/ of its context (`ddd-ts-kit generate schema <context> <Name>`) or under presentation/ of the shared kernel when several contexts use it (`generate schema shared-kernel <Name>`), share it (`.meta({ id })` with zod, `classSchema(Dto, { shared: true })` with class-validator, `sharedSchema(name, schema)` otherwise) and use it in both places, whole or in part. An identifier answer is `acceptedSchema` of @ddd-ts-kit/http.';
+export const schemaNoDuplicateShape = {
+    id: 'schema/no-duplicate-shape',
+    description: 'Under "stack.schemas": "shared", one shape of the HTTP contract is declared once in its context: no two DTO classes, and no two object schemas (zod, valibot, TypeBox), of the presentation layer of one context, or of a context and presentation/ of the shared kernel, declare the same properties with the same constraints. Two contexts may declare the same shape; request parameters and shapes the generator left to fill are not judged.',
+    scope: 'project',
+    run(project) {
+        if (!sharesSchemas(project)) {
+            return [];
+        }
+        const report = reporter(project, this.id);
+        const first = new Map();
+        return shapesOf(project).flatMap((shape) => {
+            const earlier = first.get(`${KERNEL}|${shape.key}`) ?? first.get(`${shape.home}|${shape.key}`);
+            if (earlier === undefined) {
+                first.set(`${shape.home}|${shape.key}`, shape);
+                return [];
+            }
+            const message = `${shape.what} declares the shape ${earlier.what.charAt(0).toLowerCase()}${earlier.what.slice(1)} already declares (${earlier.file}:${String(earlier.line)}).`;
+            return [report({ file: shape.file, line: shape.line }, message, FIX)];
+        });
+    },
+};
+function shapesOf(project) {
+    return project.files
+        .filter((file) => holdsSchemas(project, file) && !PARAMETER_FILE.test(file.path))
+        .map((file) => ({ file, home: file.location.area === 'context' ? file.location.context : KERNEL }))
+        .sort((a, b) => rank(a.file.path, a.home) - rank(b.file.path, b.home) || compare(a.file.path, b.file.path))
+        .flatMap(({ file, home }) => {
+        const code = restoredCode(file);
+        return [...classShapes(file, code), ...objectShapes(file, code)]
+            .sort((a, b) => a.line - b.line)
+            .map((shape) => ({ ...shape, file: file.path, home }));
+    });
+}
+/** The shared kernel first, then the shared shapes of each context, then the routes: a copy is reported, never its original. */
+function rank(path, home) {
+    if (home === KERNEL) {
+        return 0;
+    }
+    return path.includes(SHARED_OF_A_CONTEXT) ? 1 : 2;
+}
+function compare(a, b) {
+    if (a === b) {
+        return 0;
+    }
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=schema-no-duplicate-shape.js.map

package/dist/check/rules/schema-no-duplicate-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-no-duplicate-shape.js","sourceRoot":"","sources":["../../../src/check/rules/schema-no-duplicate-shape.ts"],"names":[],"mappings":"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"}

package/dist/check/rules/schema-presentation-only.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const schemaPresentationOnly: Rule;
+//# sourceMappingURL=schema-presentation-only.d.ts.map

package/dist/check/rules/schema-presentation-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-presentation-only.d.ts","sourceRoot":"","sources":["../../../src/check/rules/schema-presentation-only.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAW7C,eAAO,MAAM,sBAAsB,EAAE,IAgBpC,CAAC"}

package/dist/check/rules/schema-presentation-only.js

@@ -0,0 +1,53 @@
+import { holdsSchemas } from '../schemas/holds-schemas.js';
+import { sharedPresentation } from '../schemas/shared-presentation.js';
+import { sharesSchemas } from '../schemas/shares-schemas.js';
+import { VALIDATION_PACKAGES } from '../schemas/validation-packages.js';
+import { perFile } from '../support/per-file.js';
+/** Where a context reads a type of the contract: its presentation layer; the module file and the specs wire and drive it. */
+const READERS_OUTSIDE = ['domain', 'application', 'infrastructure', 'published-language'];
+export const schemaPresentationOnly = {
+    id: 'schema/presentation-only',
+    description: 'Under "stack.schemas": "shared", a schema of the HTTP contract lives in presentation/: of its context, or of the shared kernel when several contexts answer with it. The shared kernel declares no schema anywhere else, and no domain, application, infrastructure or published language imports one of its presentation/.',
+    scope: 'file',
+    run(project) {
+        if (!sharesSchemas(project)) {
+            return [];
+        }
+        return perFile(project, this.id, (file) => file.isTest || holdsSchemas(project, file)
+            ? []
+            : [...declaredInSharedKernel(file), ...readOutsidePresentation(project, file)]);
+    },
+};
+function declaredInSharedKernel(file) {
+    if (file.location.area !== 'shared-kernel') {
+        return [];
+    }
+    return file.imports
+        .filter(({ target }) => target.kind === 'package' && VALIDATION_PACKAGES.includes(target.name))
+        .map(({ line, specifier }) => ({
+        line,
+        message: `The shared kernel declares a schema outside presentation/ (it imports "${specifier}"): every layer of every context may import the shared kernel, a schema there reaches the domain.`,
+        fix: 'Move the file under presentation/ of the shared kernel (`ddd-ts-kit generate schema shared-kernel <Name>` writes one there), or keep the value object it describes in the shared kernel as plain TypeScript and its schema in presentation/.',
+    }));
+}
+function readOutsidePresentation(project, file) {
+    const { location } = file;
+    const reader = location.area === 'shared-kernel' || (location.area === 'context' && READERS_OUTSIDE.includes(location.layer));
+    if (!reader) {
+        return [];
+    }
+    const directory = sharedPresentation(project.config);
+    return file.imports
+        .filter(({ target }) => target.kind === 'file' && target.path.startsWith(directory))
+        .map(({ line, specifier }) => ({
+        line,
+        message: `${describe(file)} imports "${specifier}", a schema of the HTTP contract: a schema is a presentation type, the model and the use cases never read one.`,
+        fix: 'Import it from presentation/ only, and map it there to the command, the query or the value object the inner layer expects.',
+    }));
+}
+function describe({ location }) {
+    return location.area === 'context'
+        ? `${location.layer}/ of ${location.context}`
+        : 'The shared kernel outside presentation/';
+}
+//# sourceMappingURL=schema-presentation-only.js.map

package/dist/check/rules/schema-presentation-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-presentation-only.js","sourceRoot":"","sources":["../../../src/check/rules/schema-presentation-only.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,6HAA6H;AAC7H,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,sBAAsB,GAAS;IAC1C,EAAE,EAAE,0BAA0B;IAC9B,WAAW,EACT,6TAA6T;IAC/T,KAAK,EAAE,MAAM;IACb,GAAG,CAAC,OAAO;QACT,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CACxC,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,EAAE,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CACjF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,sBAAsB,CAAC,IAAgB;IAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,OAAO;SAChB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAC9F,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI;QACJ,OAAO,EAAE,0EAA0E,SAAS,mGAAmG;QAC/L,GAAG,EAAE,8OAA8O;KACpP,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAgB,EAAE,IAAgB;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE1B,MAAM,MAAM,GACV,QAAQ,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO,IAAI,CAAC,OAAO;SAChB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;SACnF,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI;QACJ,OAAO,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,SAAS,gHAAgH;QAChK,GAAG,EAAE,4HAA4H;KAClI,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,QAAQ,CAAC,EAAE,QAAQ,EAAc;IACxC,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS;QAChC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,QAAQ,QAAQ,CAAC,OAAO,EAAE;QAC7C,CAAC,CAAC,yCAAyC,CAAC;AAChD,CAAC"}

package/dist/check/schemas/class-shapes.d.ts

@@ -0,0 +1,9 @@
+import type { SourceFile } from '../model/source-file.js';
+import type { DeclaredShape } from './declared-shape.js';
+/**
+ * The DTO classes of a source: a class of the module that extends nothing, has no method and
+ * gives a decorator to each of its properties. Its shape is its properties, by name, each with
+ * its decorators and whether it is optional. A class the generator left to fill is not one yet.
+ */
+export declare function classShapes(file: SourceFile, code: string): DeclaredShape[];
+//# sourceMappingURL=class-shapes.d.ts.map

package/dist/check/schemas/class-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-shapes.d.ts","sourceRoot":"","sources":["../../../src/check/schemas/class-shapes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAQ3E"}

package/dist/check/schemas/class-shapes.js

@@ -0,0 +1,52 @@
+import { matchingBracket } from '../text/matching-bracket.js';
+import { stillGenerated } from './still-generated.js';
+import { topLevelStatements } from './top-level-statements.js';
+const DECORATOR_NAME = /@[A-Za-z_$][\w$]*\s*/y;
+const PROPERTY = /^(?:(?:readonly|public|declare)\s+)*([A-Za-z_$][\w$]*)\s*([?!])?/;
+/**
+ * The DTO classes of a source: a class of the module that extends nothing, has no method and
+ * gives a decorator to each of its properties. Its shape is its properties, by name, each with
+ * its decorators and whether it is optional. A class the generator left to fill is not one yet.
+ */
+export function classShapes(file, code) {
+    return file.structure.classes.flatMap((shape) => {
+        const members = dtoMembers(shape, code);
+        return members === undefined || stillGenerated(file, shape.bodyStart, shape.end)
+            ? []
+            : [{ key: `class{${members.join(';')}}`, line: shape.line, what: `The class ${shape.name}` }];
+    });
+}
+function dtoMembers(shape, code) {
+    if (shape.depth !== 0 || shape.superclass !== undefined || shape.methods.length > 0) {
+        return undefined;
+    }
+    const members = topLevelStatements(code.slice(shape.bodyStart + 1, shape.end), ';').map(member);
+    const decorated = members.flatMap((one) => (one === undefined ? [] : [one]));
+    return decorated.length === 0 || decorated.length < members.length ? undefined : decorated.sort();
+}
+/** `name?:@IsString()@MaxLength(500)` for a decorated property; nothing for anything else. */
+function member(statement) {
+    const { decorators, rest } = decoratorsOf(statement.trim());
+    const property = PROPERTY.exec(rest);
+    if (decorators.length === 0 || property === null) {
+        return undefined;
+    }
+    return `${property[1] ?? ''}${property[2] === '?' ? '?' : ''}:${decorators.join('')}`;
+}
+/** The decorators that open a statement, their arguments included, and what follows them. */
+function decoratorsOf(statement) {
+    const decorators = [];
+    let at = 0;
+    for (;;) {
+        DECORATOR_NAME.lastIndex = at;
+        const name = DECORATOR_NAME.exec(statement);
+        if (name === null) {
+            return { decorators, rest: statement.slice(at).trim() };
+        }
+        const open = at + name[0].length;
+        const end = statement.charAt(open) === '(' ? matchingBracket(statement, open) + 1 : open;
+        decorators.push(statement.slice(at, end).replace(/\s+/g, ''));
+        at = end + (statement.slice(end).length - statement.slice(end).trimStart().length);
+    }
+}
+//# sourceMappingURL=class-shapes.js.map

package/dist/check/schemas/class-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-shapes.js","sourceRoot":"","sources":["../../../src/check/schemas/class-shapes.ts"],"names":[],"mappings":"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"}

package/dist/check/schemas/declared-shape.d.ts

@@ -0,0 +1,9 @@
+/** A shape of the HTTP contract written by hand: a DTO class, or the object of a schema builder. */
+export interface DeclaredShape {
+    /** The shape, written the same way whatever its layout: equal keys are one shape. */
+    readonly key: string;
+    readonly line: number;
+    /** How a reader finds it in its file. */
+    readonly what: string;
+}
+//# sourceMappingURL=declared-shape.d.ts.map