@rayspec/spec 1.5.0

package/dist/product-views.js

@@ -0,0 +1,317 @@
+/**
+ * Product-YAML VIEW read + projection vocabulary.
+ *
+ * This module declares HOW a Product-YAML view reads backing data and shapes its DTO — as CLOSED,
+ * FAIL-CLOSED, ZERO-CODE data. It resolves the earlier conflation of "what backing
+ * data does the view read" with "what DTO shape does it return") by giving each half its own
+ * declaration with its own validation:
+ *
+ *   - `source` (+ `read`)      = the BACKING DATA: a store / artifact query / capability ref, an
+ *                                equality filter over declared params, exclusions, ordering, and a
+ *                                read MODE (list | single | collect). Validated kind-aware by
+ *                                `product-views-lint.ts` (a contract id NEVER satisfies a source).
+ *   - `response_contract` (+ `read.shape`) = the DTO: the declared contract names the client-facing
+ *                                shape; `shape` declares how rows PROJECT into it. Validated by the
+ *                                shape⊆contract conformance pass (separate from source resolution).
+ *
+ * DESIGN LAWS (enforced by product-views-lint + the @rayspec/views-runtime interpreter):
+ *   - EVERYTHING here is data: literals, column names, param names, JSON paths. There is no
+ *     expression language, no computed string, no handler reference — the "route declarations
+ *     cannot run arbitrary code" gate is structural (closed discriminated unions + strict objects).
+ *   - Every leaf carries a declared `type` from a closed set and an optional literal `default`
+ *     (default `null`): a raw value that does not match the type is replaced by the default, which
+ *     reproduces the frozen legacy read handlers' null-safety (`typeof x === 'number' ? x : null`)
+ *     as DECLARED, stable behavior ("stable null behavior").
+ *   - Recursion is real (a list item may contain lookups/items) but each context is CLOSED: an
+ *     `items` (jsonb-array) shape admits only `item`/`const` fields BY CONSTRUCTION; a `read.absent`
+ *     shape admits only `param`/`const`. Context rules that depend on the read mode (page fields
+ *     only in `list`, group/self-counts only in `collect`, …) live in `product-views-lint.ts`.
+ *
+ * REPRESENTABLE: the recursive `ViewObjectShape` uses `z.lazy`, which the pinned zod@4.4.3
+ * `z.toJSONSchema` exports as a `$defs` self-reference (verified empirically for this shape) — so
+ * `exportProductJsonSchema` keeps working and the committed `product.schema.json` stays derivable.
+ */
+import { z } from 'zod';
+import { SafeIdentifier } from './grammar.js';
+// ---------------------------------------------------------------------------------------
+// params — the view's DECLARED request inputs (path/query), each with a closed shape preset
+// ---------------------------------------------------------------------------------------
+/**
+ * The CLOSED param shape presets ("input params"). A free-form author regex is deliberately NOT
+ * offered (an adversarial pattern is a ReDoS vector; a preset set is fail-closed and product-neutral):
+ *  - `safe_id`         — `/^[A-Za-z0-9_.-]{1,128}$/` (a bounded id/token shape).
+ *  - `positive_int`    — an integer string ≥ 1.
+ *  - `nonnegative_int` — an integer string ≥ 0.
+ *  - `string`          — any non-empty string ≤ 1024 chars (bounded; params are DATA, never code).
+ */
+export const ViewParamShapePreset = z.enum([
+    'safe_id',
+    'positive_int',
+    'nonnegative_int',
+    'string',
+]);
+export const ViewParamSpec = z
+    .object({
+    /** Where the param binds: a `{name}` path segment or a `?name=` query param. */
+    in: z.enum(['path', 'query']),
+    /**
+     * Whether the request MUST carry it. Path params are required by construction (the router only
+     * matches a present segment) — lint rejects `required:false` on a path param. Query params
+     * default to optional.
+     */
+    required: z.boolean().optional(),
+    /** The closed validation preset (see `ViewParamShapePreset`). */
+    shape: ViewParamShapePreset,
+    /** An optional CLOSED value set (e.g. `[mic, system]`) — the param must be one of these. */
+    enum: z.array(z.string().min(1)).min(1).optional(),
+})
+    .strict();
+// ---------------------------------------------------------------------------------------
+// literal values + leaf types (the closed data vocabulary)
+// ---------------------------------------------------------------------------------------
+/** A literal scalar (string/number/boolean). */
+const ViewScalar = z.union([z.string(), z.number(), z.boolean()]);
+/**
+ * A literal DATA value a view may declare: a scalar, `null`, an array of scalars (e.g. the frozen
+ * `artifacts: []`), or the EMPTY object `{}`. Nothing else — a nested object/array literal would be
+ * an un-inspected blob; richer defaults belong in the projection itself.
+ */
+export const ViewConstValue = z.union([
+    ViewScalar,
+    z.null(),
+    z.array(ViewScalar),
+    z.strictObject({}),
+]);
+/**
+ * The CLOSED leaf type a projected value is checked against. A raw value that does not match
+ * is replaced by the field's declared `default` (default `null`) — never passed through mis-typed:
+ *  - `integer` — a finite integer; `number` — any finite number; `string`/`boolean` — typeof checks;
+ *  - `object`  — a non-null, non-array object (e.g. a persisted jsonb payload surfaced verbatim);
+ *  - `array`   — an array (surfaced verbatim; use `items` to PROJECT array elements instead).
+ */
+export const ViewLeafType = z.enum(['string', 'number', 'integer', 'boolean', 'object', 'array']);
+// ---------------------------------------------------------------------------------------
+// value references — how filters and sub-read matches name their inputs
+// ---------------------------------------------------------------------------------------
+/** A reference to a DECLARED view param (validated by lint: the param must exist in `params`). */
+export const ViewParamRef = z.object({ param: z.string().min(1) }).strict();
+/** A literal value. */
+export const ViewConstRef = z.object({ const: ViewConstValue }).strict();
+/** A reference to the PARENT row's column (sub-read matches only). */
+export const ViewColumnRef = z.object({ column: SafeIdentifier }).strict();
+/** A view-level filter argument: a declared param or a literal. */
+export const ViewFilterArg = z.union([ViewParamRef, ViewConstRef]);
+/** A sub-read match argument: the parent row's column, a declared param, or a literal. */
+export const ViewMatchArg = z.union([ViewColumnRef, ViewParamRef, ViewConstRef]);
+/** Order rows by a column (default `asc`). Executed server-side through the tenant-bound facade. */
+export const ViewOrderBy = z
+    .object({ column: SafeIdentifier, dir: z.enum(['asc', 'desc']).optional() })
+    .strict();
+/**
+ * Exclude rows where `column === equals` (e.g. the frozen `dismissed === true` skip). STRICT
+ * equality on a literal — a non-matching / malformed column value is NOT excluded (the safe
+ * read-route default: a read never hides rows on a bad flag — mirrors the canonical `=== true` test).
+ */
+export const ViewExclude = z
+    .object({ column: SafeIdentifier, equals: z.union([ViewScalar, z.null()]) })
+    .strict();
+/**
+ * A nested one-to-many / one-to-one read against another STORE, keyed by equality matches. The
+ * tenant predicate is STRUCTURAL beneath every match (the interpreter reads through the tenant-bound
+ * `HandlerDb` facade over the real `TenantDb` chokepoint) — a match can narrow, never widen. A match
+ * value that resolves to `undefined`/`null` at request time yields NO rows (deterministic, no query)
+ * rather than an unfiltered read — fail-closed.
+ */
+export const ViewSubRead = z
+    .object({
+    store: SafeIdentifier,
+    /** Child-column → parent-column/param/literal equality matches (lint requires ≥ 1). */
+    match: z.record(SafeIdentifier, ViewMatchArg),
+    exclude: z.array(ViewExclude).optional(),
+    order_by: z.array(ViewOrderBy).optional(),
+})
+    .strict();
+// ---------------------------------------------------------------------------------------
+// leaf fields
+// ---------------------------------------------------------------------------------------
+/** Project a row column, type-checked, with a literal default on mismatch/absence. */
+export const ViewFieldColumn = z
+    .object({
+    kind: z.literal('column'),
+    column: SafeIdentifier,
+    type: ViewLeafType,
+    default: ViewConstValue.optional(),
+})
+    .strict();
+/** Project a JSON path INTO a jsonb column (e.g. `payload.duration`), type-checked + defaulted. */
+export const ViewFieldJson = z
+    .object({
+    kind: z.literal('json'),
+    column: SafeIdentifier,
+    /** The key path into the jsonb value (data keys, no expressions). */
+    path: z.array(z.string().min(1)).min(1),
+    type: ViewLeafType,
+    default: ViewConstValue.optional(),
+})
+    .strict();
+/** Echo a DECLARED, validated request param (e.g. `session_id`) into the DTO. */
+export const ViewFieldParam = z
+    .object({ kind: z.literal('param'), param: z.string().min(1) })
+    .strict();
+/** A literal DTO value (the frozen `sample_rate: null`, `artifacts: []`, …). */
+export const ViewFieldConst = z
+    .object({ kind: z.literal('const'), value: ViewConstValue })
+    .strict();
+/** Inside an `items` shape ONLY: project a key path from the CURRENT array element. */
+export const ViewFieldItem = z
+    .object({
+    kind: z.literal('item'),
+    path: z.array(z.string().min(1)).min(1),
+    type: ViewLeafType,
+    default: ViewConstValue.optional(),
+})
+    .strict();
+/**
+ * The shape applied to each element of a jsonb ARRAY (`items` fields). CLOSED BY CONSTRUCTION to
+ * `item`/`const` fields — an array element has no row/param context, so no other kind is even
+ * representable here (fail-closed at the grammar, not by convention).
+ */
+export const ViewItemShape = z
+    .object({ fields: z.record(SafeIdentifier, z.union([ViewFieldItem, ViewFieldConst])) })
+    .strict();
+/** The scalar a `lookup` extracts from its matched row: a column, optionally a JSON path into it. */
+export const ViewLookupLeaf = z
+    .object({ column: SafeIdentifier, path: z.array(z.string().min(1)).optional() })
+    .strict();
+/** The leaf a `group` extracts per row (like a column/json leaf, without the `kind` tag). */
+export const ViewGroupValue = z
+    .object({
+    column: SafeIdentifier,
+    path: z.array(z.string().min(1)).optional(),
+    type: ViewLeafType,
+    default: ViewConstValue.optional(),
+})
+    .strict();
+/**
+ * The recursive object shape. `z.lazy` defers the union so `list`/`group`/`page_items` can nest
+ * shapes; zod@4.4.3 parses this and `z.toJSONSchema` exports it as a `$defs` self-reference.
+ */
+export const ViewObjectShape = z
+    .object({
+    fields: z.record(SafeIdentifier, z.lazy(() => ViewField)),
+})
+    .strict();
+const ViewFieldItemsSchema = z
+    .object({
+    kind: z.literal('items'),
+    column: SafeIdentifier,
+    path: z.array(z.string().min(1)).optional(),
+    shape: ViewItemShape,
+})
+    .strict();
+const ViewFieldListSchema = z
+    .object({ kind: z.literal('list'), source: ViewSubRead, shape: ViewObjectShape })
+    .strict();
+const ViewFieldLookupSchema = z
+    .object({
+    kind: z.literal('lookup'),
+    source: ViewSubRead,
+    field: ViewLookupLeaf,
+    type: ViewLeafType,
+    default: ViewConstValue.optional(),
+})
+    .strict();
+const ViewFieldCountsSchema = z
+    .object({
+    kind: z.literal('counts'),
+    of: ViewSubRead.optional(),
+    by: SafeIdentifier,
+    buckets: z.array(SafeIdentifier).min(1),
+    total: z.enum(['all_rows', 'bucket_rows']),
+})
+    .strict();
+const ViewFieldGroupSchema = z
+    .object({
+    kind: z.literal('group'),
+    column: SafeIdentifier,
+    equals: ViewScalar,
+    mode: z.enum(['list', 'first', 'last']),
+    value: ViewGroupValue.optional(),
+    shape: ViewObjectShape.optional(),
+    absent: ViewConstValue.optional(),
+})
+    .strict();
+const ViewFieldPageItemsSchema = z
+    .object({ kind: z.literal('page_items'), shape: ViewObjectShape })
+    .strict();
+const ViewFieldPageTotalSchema = z.object({ kind: z.literal('page_total') }).strict();
+const ViewFieldPageNextOffsetSchema = z.object({ kind: z.literal('page_next_offset') }).strict();
+/**
+ * The CLOSED field union. An unknown/typo'd `kind` is fail-closed-rejected by the discriminated
+ * union (a `schema_violation`, never a silently-dropped field — the FAIL-OPEN lesson: reject loudly).
+ */
+export const ViewField = z.discriminatedUnion('kind', [
+    ViewFieldColumn,
+    ViewFieldJson,
+    ViewFieldParam,
+    ViewFieldConst,
+    ViewFieldItemsSchema,
+    ViewFieldListSchema,
+    ViewFieldLookupSchema,
+    ViewFieldCountsSchema,
+    ViewFieldGroupSchema,
+    ViewFieldPageItemsSchema,
+    ViewFieldPageTotalSchema,
+    ViewFieldPageNextOffsetSchema,
+]);
+// ---------------------------------------------------------------------------------------
+// read — the view's declarative read (mode + filter + shape [+ absent])
+// ---------------------------------------------------------------------------------------
+/**
+ * How the view reads its source:
+ *  - `list`    — many rows, PAGINATED (pagination declaration required): the top-level shape is the
+ *                ENVELOPE (page_items / page_total / page_next_offset + param/const fields only).
+ *  - `single`  — the first matching row: the top-level shape projects THAT row; `absent` (or
+ *                `absent_state: not_ready_409`) declares what happens when there is none.
+ *  - `collect` — ALL matching rows, aggregated: the top-level shape admits param/const/group/counts.
+ */
+export const ViewReadMode = z.enum(['list', 'single', 'collect']);
+/**
+ * The absent-row DTO for `single` mode with `absent_state: empty_200` (the frozen absent-transcript /
+ * absent-intelligence 200 shapes). CLOSED to `param`/`const` fields by construction — there is no row
+ * to project from.
+ */
+export const ViewAbsentShape = z
+    .object({ fields: z.record(SafeIdentifier, z.union([ViewFieldParam, ViewFieldConst])) })
+    .strict();
+export const ViewRead = z
+    .object({
+    mode: ViewReadMode,
+    /** Source-column → param/literal equality filter (AND; the tenant predicate is beneath it). */
+    filter: z.record(SafeIdentifier, ViewFilterArg).optional(),
+    exclude: z.array(ViewExclude).optional(),
+    order_by: z.array(ViewOrderBy).optional(),
+    /** The DTO projection (SEPARATE from `response_contract`, which names the contract it must fit). */
+    shape: ViewObjectShape,
+    /** `single` + `empty_200` ONLY: the absent-row DTO. */
+    absent: ViewAbsentShape.optional(),
+})
+    .strict();
+/**
+ * Conditional-read behavior. `etag` (GET only): the runtime derives a strong ETag from the
+ * response DTO, sets it on the 200, and answers a matching `If-None-Match` with a bodyless 304.
+ * `If-Range` is DELIBERATELY not a view construct: byte-range serving is Tier-B media-capability
+ * behavior (a media-serving concern), never a Product-YAML view — so it cannot be mis-declared.
+ */
+export const ViewConditionalRead = z.enum(['etag']);
+/**
+ * DTO field / param names that can never be declared (prototype-pollution guards). `SafeIdentifier`
+ * admits a leading underscore, so `__proto__` would otherwise pass — lint rejects these everywhere a
+ * name is declared (fields, params, match keys, buckets).
+ */
+export const VIEW_RESERVED_NAMES = new Set([
+    '__proto__',
+    'constructor',
+    'prototype',
+]);
+//# sourceMappingURL=product-views.js.map

package/dist/product-views.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@rayspec/spec",
+  "version": "1.5.0",
+  "private": false,
+  "files": [
+    "dist"
+  ],
+  "license": "FSL-1.1-ALv2",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "ajv": "8.20.0",
+    "yaml": "2.9.0",
+    "zod": "4.4.3",
+    "@rayspec/core": "1.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.12.0",
+    "typescript": "5.9.3",
+    "vitest": "4.1.9"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}