@skmtc/core 0.0.984 → 0.16.2

package/script/types/SkmtcDocument.d.ts

@@ -0,0 +1,81 @@
+import type { OasDocument } from '../oas/document/Document.js';
+import type { GqlDocument } from '../gql/document/GqlDocument.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { GraphQLSchema } from 'graphql';
+/**
+ * Discriminated union representing a *parsed* source document inside the
+ * SKMTC pipeline. Each variant carries the protocol-specific
+ * post-parse document object as `value`, tagged by `type` so generator
+ * dispatch and downstream consumers can narrow with a `switch`.
+ *
+ * This shape is the *output* of the parse phase. The pipeline's public
+ * entry point ({@link SkmtcDocumentInput}) carries raw schema sources
+ * and is converted into this shape inside `CoreContext.toArtifacts`
+ * before the generate phase runs.
+ *
+ * @example Narrowing in a protocol-aware generator
+ * ```typescript
+ * switch (context.document.type) {
+ *   case 'oas':
+ *     // context.document.value is OasDocument
+ *     break
+ *   case 'gql':
+ *     // context.document.value is GqlDocument
+ *     break
+ * }
+ * ```
+ */
+export type SkmtcParsedDocument = {
+    type: 'oas';
+    value: OasDocument;
+} | {
+    type: 'gql';
+    value: GqlDocument;
+};
+/**
+ * Discriminator for the source protocol of a {@link SkmtcParsedDocument}.
+ *
+ * Operation generators declare which protocol they target via this same
+ * value on their generator config; the dispatcher uses it to skip
+ * generators that don't match the current document.
+ */
+export type SkmtcProtocol = SkmtcParsedDocument['type'];
+/**
+ * Wraps an {@link OasDocument} in the OAS variant of {@link SkmtcParsedDocument}.
+ *
+ * Convenience constructor used by the pipeline when transitioning from
+ * the parse phase (which produces an `OasDocument` directly) into the
+ * generate phase (which expects the discriminated wrapper).
+ */
+export declare const toOasParsedDocument: (value: OasDocument) => SkmtcParsedDocument;
+/**
+ * Wraps a {@link GqlDocument} in the GQL variant of {@link SkmtcParsedDocument}.
+ */
+export declare const toGqlParsedDocument: (value: GqlDocument) => SkmtcParsedDocument;
+/**
+ * Discriminated union representing a *raw* source document accepted by
+ * `CoreContext.toArtifacts`. This is the public input shape — callers
+ * supply the schema as the protocol-specific source kind, and the
+ * pipeline runs the protocol-appropriate parser before handing the
+ * post-parse {@link SkmtcParsedDocument} to the generate phase.
+ *
+ * - `oas.value` is an `OpenAPIV3.Document`. Schema versions other than
+ *   3.0 (Swagger 2, OpenAPI 3.1) are normalized to 3.0 by
+ *   `@skmtc/convert` before reaching `toArtifacts`. 3.1 `webhooks` ride
+ *   *on* that document as a retained member (the 3.0 base type omits
+ *   `webhooks`, so it is widened here) — the parser flattens them into
+ *   {@link OasDocument.webhooks}.
+ * - `gql.value` is either a raw SDL string or a pre-built
+ *   `GraphQLSchema`. Strings are run through `buildSchema` inside the
+ *   pipeline; pre-built `GraphQLSchema` instances are used as-is.
+ */
+export type SkmtcDocumentInput = {
+    type: 'oas';
+    value: OpenAPIV3.Document<Record<string, never>> & {
+        webhooks?: Record<string, OpenAPIV3.PathItemObject>;
+    };
+} | {
+    type: 'gql';
+    value: string | GraphQLSchema;
+};
+//# sourceMappingURL=SkmtcDocument.d.ts.map

package/script/types/SkmtcDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkmtcDocument.d.ts","sourceRoot":"","sources":["../../src/types/SkmtcDocument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,WAAW,KAAG,mBAGvD,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,WAAW,KAAG,mBAGvD,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG;QACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,CAAA;KACpD,CAAA;CACF,GACD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,CAAA"}

package/script/types/SkmtcDocument.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toGqlParsedDocument = exports.toOasParsedDocument = void 0;
+/**
+ * Wraps an {@link OasDocument} in the OAS variant of {@link SkmtcParsedDocument}.
+ *
+ * Convenience constructor used by the pipeline when transitioning from
+ * the parse phase (which produces an `OasDocument` directly) into the
+ * generate phase (which expects the discriminated wrapper).
+ */
+const toOasParsedDocument = (value) => ({
+    type: 'oas',
+    value
+});
+exports.toOasParsedDocument = toOasParsedDocument;
+/**
+ * Wraps a {@link GqlDocument} in the GQL variant of {@link SkmtcParsedDocument}.
+ */
+const toGqlParsedDocument = (value) => ({
+    type: 'gql',
+    value
+});
+exports.toGqlParsedDocument = toGqlParsedDocument;

package/script/types/SupportedSubjects.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The subjects each generator supports for a given schema.
+ *
+ * Produced by evaluating every generator's `isSupported` predicate over the
+ * parsed document's operations / models — *without* running transform or
+ * render. An operation generator reports the operations its `isSupported`
+ * accepts; a model generator reports every model (the generate pipeline applies
+ * no model-level `isSupported`). Keyed by generator id.
+ */
+/** A supported OAS operation. */
+export type SupportedOasOperation = {
+    path: string;
+    method: string;
+};
+/** A supported 3.1 webhook. */
+export type SupportedWebhook = {
+    name: string;
+    method: string;
+};
+/** A supported GraphQL operation. */
+export type SupportedGqlOperation = {
+    rootKind: string;
+    fieldName: string;
+};
+/** What one generator supports, discriminated by its subject kind. */
+export type GeneratorSupport = {
+    type: 'oasOperation';
+    operations: SupportedOasOperation[];
+} | {
+    type: 'webhook';
+    webhooks: SupportedWebhook[];
+} | {
+    type: 'gqlOperation';
+    operations: SupportedGqlOperation[];
+} | {
+    type: 'model';
+    models: string[];
+};
+/** Generator id → the subjects that generator supports. */
+export type SupportedSubjects = Record<string, GeneratorSupport>;
+//# sourceMappingURL=SupportedSubjects.d.ts.map

package/script/types/SupportedSubjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupportedSubjects.d.ts","sourceRoot":"","sources":["../../src/types/SupportedSubjects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iCAAiC;AACjC,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpE,+BAA+B;AAC/B,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/D,qCAAqC;AACrC,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3E,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,qBAAqB,EAAE,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,qBAAqB,EAAE,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEvC,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA"}

package/script/types/SupportedSubjects.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * The subjects each generator supports for a given schema.
+ *
+ * Produced by evaluating every generator's `isSupported` predicate over the
+ * parsed document's operations / models — *without* running transform or
+ * render. An operation generator reports the operations its `isSupported`
+ * accepts; a model generator reports every model (the generate pipeline applies
+ * no model-level `isSupported`). Keyed by generator id.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/types/TypeSystem.d.ts

@@ -1,3 +1,4 @@
+import "../_dnt.polyfills.js";
 import type { OasRef } from '../oas/ref/Ref.js';
 import type { OasSchema } from '../oas/schema/Schema.js';
 import type { Modifiers } from './Modifiers.js';

package/script/types/TypeSystem.d.ts.map

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

package/script/types/TypeSystem.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+require("../_dnt.polyfills.js");

package/script/types/Variant.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Operation Variant axis for SKMTC Core
+ *
+ * A **variant** is a named axis below `[path][method]` (OAS) or
+ * `[rootKind][fieldName]` (GraphQL) inside
+ * `client.json#settings.enrichments`. It lets a single operation produce
+ * N Definitions instead of one — e.g. a single broad `PATCH` endpoint
+ * driving several section-edit forms, each scoped to a subset of fields.
+ *
+ * The engine reads variant names off `Object.keys` of the per-operation
+ * enrichment block. The variant name `'main'` is the canonical default
+ * and is guaranteed to be present:
+ *
+ * - When a consumer's `client.json` writes no enrichments at all for a
+ *   `(generatorId, path, method)`, the engine still dispatches once with
+ *   `variant: 'main'` and `enrichments: undefined`.
+ * - When a consumer's `client.json` writes any variants for a
+ *   `(generatorId, path, method)`, `'main'` must be among them — Valibot
+ *   rejects at parse time, and the engine also throws at runtime.
+ *
+ * Variant names are lowercase kebab-case at the convention level
+ * (`'main'`, `'customer'`, `'line-items'`). Runtime comparisons are
+ * case-sensitive. The regex below is the source of truth for what
+ * Valibot accepts.
+ *
+ * @module Variant
+ */
+/**
+ * The canonical default variant name. Every operation that any
+ * variants-aware generator processes is guaranteed to have a `'main'`
+ * variant — the engine fills it in when no enrichments exist, and the
+ * Valibot wrapping at the per-(path, method) level enforces its
+ * presence when other variants are declared.
+ *
+ * Use the literal string `'main'` in generator code; this constant
+ * exists primarily for the engine boundary and for documentation
+ * cross-references.
+ */
+export declare const DEFAULT_VARIANT: "main";
+/**
+ * A named variant of an operation. Lowercase kebab-case at the
+ * convention level; case-sensitive at runtime.
+ *
+ * Branded later if useful — kept as a plain string alias today so that
+ * literal-typed callers (`variant: 'main'`) interoperate cleanly with
+ * dynamic enumeration (`Object.keys(opEnrichments)`).
+ */
+export type Variant = string;
+/**
+ * Regex describing the conventional shape of a variant name.
+ *
+ * Allows: lowercase ASCII letter or digit segments joined by single
+ * hyphens, starting with a lowercase letter. Examples that match:
+ * `main`, `customer`, `line-items`, `customer-data-v2`.
+ *
+ * Rejects: uppercase (`Customer`), leading/trailing hyphen (`-foo`,
+ * `foo-`), double hyphens (`line--items`), other separators (`foo_bar`).
+ *
+ * The uppercase ban is what defuses the only realistic collision in
+ * `withVariant`: if both `lineItems` and `line-items` were permitted,
+ * both would suffix to `LineItems`. Banning uppercase keeps the
+ * kebab → PascalCase transform invertible.
+ */
+export declare const variantNameRegex: RegExp;
+//# sourceMappingURL=Variant.d.ts.map

package/script/types/Variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Variant.d.ts","sourceRoot":"","sources":["../../src/types/Variant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAG,MAAe,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA;AAE5B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAwC,CAAA"}

package/script/types/Variant.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * @fileoverview Operation Variant axis for SKMTC Core
+ *
+ * A **variant** is a named axis below `[path][method]` (OAS) or
+ * `[rootKind][fieldName]` (GraphQL) inside
+ * `client.json#settings.enrichments`. It lets a single operation produce
+ * N Definitions instead of one — e.g. a single broad `PATCH` endpoint
+ * driving several section-edit forms, each scoped to a subset of fields.
+ *
+ * The engine reads variant names off `Object.keys` of the per-operation
+ * enrichment block. The variant name `'main'` is the canonical default
+ * and is guaranteed to be present:
+ *
+ * - When a consumer's `client.json` writes no enrichments at all for a
+ *   `(generatorId, path, method)`, the engine still dispatches once with
+ *   `variant: 'main'` and `enrichments: undefined`.
+ * - When a consumer's `client.json` writes any variants for a
+ *   `(generatorId, path, method)`, `'main'` must be among them — Valibot
+ *   rejects at parse time, and the engine also throws at runtime.
+ *
+ * Variant names are lowercase kebab-case at the convention level
+ * (`'main'`, `'customer'`, `'line-items'`). Runtime comparisons are
+ * case-sensitive. The regex below is the source of truth for what
+ * Valibot accepts.
+ *
+ * @module Variant
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.variantNameRegex = exports.DEFAULT_VARIANT = void 0;
+/**
+ * The canonical default variant name. Every operation that any
+ * variants-aware generator processes is guaranteed to have a `'main'`
+ * variant — the engine fills it in when no enrichments exist, and the
+ * Valibot wrapping at the per-(path, method) level enforces its
+ * presence when other variants are declared.
+ *
+ * Use the literal string `'main'` in generator code; this constant
+ * exists primarily for the engine boundary and for documentation
+ * cross-references.
+ */
+exports.DEFAULT_VARIANT = 'main';
+/**
+ * Regex describing the conventional shape of a variant name.
+ *
+ * Allows: lowercase ASCII letter or digit segments joined by single
+ * hyphens, starting with a lowercase letter. Examples that match:
+ * `main`, `customer`, `line-items`, `customer-data-v2`.
+ *
+ * Rejects: uppercase (`Customer`), leading/trailing hyphen (`-foo`,
+ * `foo-`), double hyphens (`line--items`), other separators (`foo_bar`).
+ *
+ * The uppercase ban is what defuses the only realistic collision in
+ * `withVariant`: if both `lineItems` and `line-items` were permitted,
+ * both would suffix to `LineItems`. Banning uppercase keeps the
+ * kebab → PascalCase transform invertible.
+ */
+exports.variantNameRegex = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;