@owlmeans/viable-common 0.0.33 → 0.0.35

package/build/intent/entrypoints.js

@@ -0,0 +1,28 @@
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint';
+import { frontend, route, RouteMethod } from '@owlmeans/route';
+import { INTENT_API_PATH, INTENT_LANDING_PATH, intent } from './consts.js';
+import { IntentPickupBodySchema, IntentStashBodySchema } from './schemas.js';
+/**
+ * Declare the intent-first hand-off: two GUEST API routes and the landing screen's address.
+ *
+ * No guard and no gate anywhere on the API — the caller is a visitor who has no account yet — and
+ * no `service` on any route: each consumer fills it in (the public site names the platform's
+ * services in its own configuration; the manager binds them to its own).
+ *
+ * TODO(cors): these routes ride the framework's global `origin: '*'` CORS policy (no credentials).
+ * If viable ever restricts allowed origins globally, this entrypoint must keep answering the public
+ * site's origins — owlmeans.com, owlmeans.pl and, in dev/stage, `http://localhost:4321`.
+ *
+ * The landing screen is `sticky`, like the OAuth consent screens: it is an ordinary in-app screen
+ * that a visitor arrives at directly from another origin.
+ */
+export const makeIntentProtocols = (opts = {}) => {
+    const base = openProtocol(route(intent.base, opts.path ?? INTENT_API_PATH));
+    return {
+        base,
+        stash: protocol(route(intent.stash, '/', { parent: base, method: RouteMethod.POST }), contract.request({ body: typed(IntentStashBodySchema) }, typed())),
+        pickup: protocol(route(intent.pickup, '/pickup', { parent: base, method: RouteMethod.POST }), contract.request({ body: typed(IntentPickupBodySchema) }, typed())),
+        landing: openProtocol(route(intent.landing, opts.landing ?? INTENT_LANDING_PATH, frontend()), { sticky: true }),
+    };
+};
+//# sourceMappingURL=entrypoints.js.map

package/build/intent/entrypoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoints.js","sourceRoot":"","sources":["../../src/intent/entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAK5E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,GAA0B,EAAE,EAAE,EAAE;IACtE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,IAAI;QAEJ,KAAK,EAAE,QAAQ,CACb,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAkB,qBAAqB,CAAC,EAAE,EAAE,KAAK,EAAqB,CAAC,CACtG;QAED,MAAM,EAAE,QAAQ,CACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAmB,sBAAsB,CAAC,EAAE,EAAE,KAAK,EAAsB,CAAC,CACzG;QAED,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAChH,CAAA;AACH,CAAC,CAAA"}

package/build/intent/errors.d.ts

@@ -0,0 +1,20 @@
+import { ResilientError } from '@owlmeans/error';
+export declare class IntentError extends ResilientError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** No stashed prompt under that reference — expired, already picked up, or never existed. */
+export declare class IntentExpired extends IntentError {
+    static typeName: string;
+    /** The reference answers nothing (any more): answered 404. */
+    static httpStatus: number;
+    constructor(message?: string);
+}
+/** Too many stashes or pickups from one address, or across everyone. */
+export declare class IntentThrottled extends IntentError {
+    static typeName: string;
+    /** Answered 429. */
+    static httpStatus: number;
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/intent/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/intent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,qBAAa,WAAY,SAAQ,cAAc;IAC7C,OAAuB,QAAQ,SAA2C;IAE1E,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,6FAA6F;AAC7F,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAuB,QAAQ,SAAmC;IAClE,8DAA8D;IAC9D,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,wEAAwE;AACxE,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,OAAuB,QAAQ,SAAqC;IACpE,oBAAoB;IACpB,OAAc,UAAU,SAAM;IAE9B,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF"}

package/build/intent/errors.js

@@ -0,0 +1,28 @@
+import { ResilientError } from '@owlmeans/error';
+export class IntentError extends ResilientError {
+    static typeName = `ViableIntent${ResilientError.typeName}`;
+    constructor(message = 'error') {
+        super(IntentError.typeName, `viable-intent:${message}`);
+    }
+}
+/** No stashed prompt under that reference — expired, already picked up, or never existed. */
+export class IntentExpired extends IntentError {
+    static typeName = `Expired${IntentError.typeName}`;
+    /** The reference answers nothing (any more): answered 404. */
+    static httpStatus = 404;
+    constructor(message = 'error') {
+        super(`expired:${message}`);
+        this.type = IntentExpired.typeName;
+    }
+}
+/** Too many stashes or pickups from one address, or across everyone. */
+export class IntentThrottled extends IntentError {
+    static typeName = `Throttled${IntentError.typeName}`;
+    /** Answered 429. */
+    static httpStatus = 429;
+    constructor(message = 'error') {
+        super(`throttled:${message}`);
+        this.type = IntentThrottled.typeName;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/intent/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/intent/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,OAAO,WAAY,SAAQ,cAAc;IACtC,MAAM,CAAU,QAAQ,GAAG,eAAe,cAAc,CAAC,QAAQ,EAAE,CAAA;IAE1E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,iBAAiB,OAAO,EAAE,CAAC,CAAA;IACzD,CAAC;CACF;AAED,6FAA6F;AAC7F,MAAM,OAAO,aAAc,SAAQ,WAAW;IACrC,MAAM,CAAU,QAAQ,GAAG,UAAU,WAAW,CAAC,QAAQ,EAAE,CAAA;IAClE,8DAA8D;IACvD,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAA;QAC3B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAA;IACpC,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACvC,MAAM,CAAU,QAAQ,GAAG,YAAY,WAAW,CAAC,QAAQ,EAAE,CAAA;IACpE,oBAAoB;IACb,MAAM,CAAC,UAAU,GAAG,GAAG,CAAA;IAE9B,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAA;IACtC,CAAC;CACF"}

package/build/intent/flow.d.ts

@@ -0,0 +1,17 @@
+import type { ShallowFlow } from '@owlmeans/flow';
+/**
+ * The hand-off flow both sides walk.
+ *
+ * `compose` runs on the public site: the prompt is stashed and `handoff` carries the reference to
+ * `land`, whose module is the platform's landing screen — so the site redirects to
+ * `land`'s address with the payload as query. The landing then enters at `land` FRESH (the
+ * reference arrives as `?ref=`, never as a serialized token, which the platform's own sign-in
+ * parses from `?flow=` on every page), and either goes on to `review` (signed in) or parks the flow
+ * with `suspendFlow` at `sign-in`, whose non-explicit way forward is `review` — the home screen —
+ * so whichever sign-in method finishes lands there.
+ *
+ * The steps address CONCRETE entrypoint aliases, never `$`-prefixed references: this flow is never
+ * the live `FlowService` model and nothing here needs `configureFlows`.
+ */
+export declare const intentFlow: ShallowFlow;
+//# sourceMappingURL=flow.d.ts.map

package/build/intent/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/intent/flow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAKjD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,EAAE,WA6CxB,CAAA"}

package/build/intent/flow.js

@@ -0,0 +1,65 @@
+import { DISPATCHER } from '@owlmeans/auth';
+import { HOME } from '@owlmeans/context';
+import { INTENT_FLOW, INTENT_PAYLOAD_REF, intent, IntentFlowStep } from './consts.js';
+const payloadMap = { [INTENT_PAYLOAD_REF]: 0 };
+/**
+ * The hand-off flow both sides walk.
+ *
+ * `compose` runs on the public site: the prompt is stashed and `handoff` carries the reference to
+ * `land`, whose module is the platform's landing screen — so the site redirects to
+ * `land`'s address with the payload as query. The landing then enters at `land` FRESH (the
+ * reference arrives as `?ref=`, never as a serialized token, which the platform's own sign-in
+ * parses from `?flow=` on every page), and either goes on to `review` (signed in) or parks the flow
+ * with `suspendFlow` at `sign-in`, whose non-explicit way forward is `review` — the home screen —
+ * so whichever sign-in method finishes lands there.
+ *
+ * The steps address CONCRETE entrypoint aliases, never `$`-prefixed references: this flow is never
+ * the live `FlowService` model and nothing here needs `configureFlows`.
+ */
+export const intentFlow = {
+    flow: INTENT_FLOW,
+    initialStep: IntentFlowStep.Compose,
+    steps: {
+        [IntentFlowStep.Compose]: {
+            index: 0,
+            step: IntentFlowStep.Compose,
+            service: '',
+            initial: true,
+            payloadMap,
+            transitions: {
+                handoff: { transition: 'handoff', step: IntentFlowStep.Land },
+            },
+        },
+        [IntentFlowStep.Land]: {
+            index: 1,
+            step: IntentFlowStep.Land,
+            service: '',
+            module: intent.landing,
+            initial: true,
+            payloadMap,
+            transitions: {
+                review: { transition: 'review', step: IntentFlowStep.Review },
+                'sign-in': { transition: 'sign-in', step: IntentFlowStep.SignIn, explicit: true },
+            },
+        },
+        [IntentFlowStep.SignIn]: {
+            index: 2,
+            step: IntentFlowStep.SignIn,
+            service: '',
+            module: DISPATCHER,
+            payloadMap,
+            transitions: {
+                next: { transition: 'next', step: IntentFlowStep.Review },
+            },
+        },
+        [IntentFlowStep.Review]: {
+            index: 3,
+            step: IntentFlowStep.Review,
+            service: '',
+            module: HOME,
+            payloadMap,
+            transitions: {},
+        },
+    },
+};
+//# sourceMappingURL=flow.js.map

package/build/intent/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/intent/flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAExC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAErF,MAAM,UAAU,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAA;AAE9C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,cAAc,CAAC,OAAO;IACnC,KAAK,EAAE;QACL,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE;YACxB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,cAAc,CAAC,OAAO;YAC5B,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,IAAI;YACb,UAAU;YACV,WAAW,EAAE;gBACX,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE;aAC9D;SACF;QACD,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE;YACrB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,OAAO,EAAE,IAAI;YACb,UAAU;YACV,WAAW,EAAE;gBACX,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;gBAC7D,SAAS,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;aAClF;SACF;QACD,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE;YACvB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,cAAc,CAAC,MAAM;YAC3B,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,UAAU;YAClB,UAAU;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE;aAC1D;SACF;QACD,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE;YACvB,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,cAAc,CAAC,MAAM;YAC3B,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,IAAI;YACZ,UAAU;YACV,WAAW,EAAE,EAAE;SAChB;KACF;CACF,CAAA"}

package/build/intent/index.d.ts

@@ -0,0 +1,7 @@
+export * from './consts.js';
+export * from './schemas.js';
+export * from './errors.js';
+export * from './entrypoints.js';
+export * from './flow.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/intent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intent/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,mBAAmB,YAAY,CAAA"}

package/build/intent/index.js

@@ -0,0 +1,6 @@
+export * from './consts.js';
+export * from './schemas.js';
+export * from './errors.js';
+export * from './entrypoints.js';
+export * from './flow.js';
+//# sourceMappingURL=index.js.map

package/build/intent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/intent/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA"}

package/build/intent/schemas.d.ts

@@ -0,0 +1,10 @@
+import type { JSONSchemaType } from 'ajv';
+import type { IntentPickupBody, IntentStashBody } from './types.js';
+/**
+ * The stash body. `consent` is a constant `true`, not a boolean: the data-processing confirmation is
+ * a precondition of the request existing, so the wire refuses its absence instead of the handler
+ * having to remember to look.
+ */
+export declare const IntentStashBodySchema: JSONSchemaType<IntentStashBody>;
+export declare const IntentPickupBodySchema: JSONSchemaType<IntentPickupBody>;
+//# sourceMappingURL=schemas.d.ts.map

package/build/intent/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/intent/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEnE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,eAAe,CAQjE,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,cAAc,CAAC,gBAAgB,CAOnE,CAAA"}

package/build/intent/schemas.js

@@ -0,0 +1,24 @@
+import { INTENT_PROMPT_MAX, INTENT_REF_LENGTH, INTENT_REF_PATTERN } from './consts.js';
+/**
+ * The stash body. `consent` is a constant `true`, not a boolean: the data-processing confirmation is
+ * a precondition of the request existing, so the wire refuses its absence instead of the handler
+ * having to remember to look.
+ */
+export const IntentStashBodySchema = {
+    type: 'object',
+    properties: {
+        prompt: { type: 'string', minLength: 1, maxLength: INTENT_PROMPT_MAX },
+        consent: { type: 'boolean', const: true },
+    },
+    required: ['prompt', 'consent'],
+    additionalProperties: false,
+};
+export const IntentPickupBodySchema = {
+    type: 'object',
+    properties: {
+        ref: { type: 'string', minLength: INTENT_REF_LENGTH, maxLength: INTENT_REF_LENGTH, pattern: INTENT_REF_PATTERN },
+    },
+    required: ['ref'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=schemas.js.map

package/build/intent/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/intent/schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGtF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoC;IACpE,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE;QACtE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE;KAC1C;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC/B,oBAAoB,EAAE,KAAK;CAC5B,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAqC;IACtE,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,kBAAkB,EAAE;KACjH;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,oBAAoB,EAAE,KAAK;CAC5B,CAAA"}

package/build/intent/types.d.ts

@@ -0,0 +1,40 @@
+import type { ResourceRecord } from '@owlmeans/resource';
+/** What the public site sends: the prompt and the person's confirmation of its processing. */
+export interface IntentStashBody {
+    prompt: string;
+    /** Always `true` — the site's checkbox; a request without it is refused by the schema. */
+    consent: true;
+}
+/** The reference the platform answers with, and the moment its record expires. */
+export interface IntentStashResult {
+    ref: string;
+    /** Epoch milliseconds. */
+    expiresAt: number;
+}
+export interface IntentPickupBody {
+    ref: string;
+}
+export interface IntentPickupResult {
+    prompt: string;
+}
+/**
+ * The prompt as it waits in the visitor's browser between pickup and the decision on the home
+ * screen. `expiresAt` is checked on read — browser storage has no TTL of its own.
+ */
+export interface IntentDraft extends ResourceRecord {
+    id: string;
+    /** The reference it was picked up with; a reload of the landing reuses the draft of that ref. */
+    ref: string;
+    prompt: string;
+    expiresAt: number;
+}
+/**
+ * Options of {@link makeIntentProtocols}.
+ */
+export interface IntentProtocolOptions {
+    /** Path prefix of the guest API; defaults to `/public/intent`. */
+    path?: string;
+    /** Path of the landing screen; defaults to `/start`. */
+    landing?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/intent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,0FAA0F;IAC1F,OAAO,EAAE,IAAI,CAAA;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/build/intent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/intent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":""}

package/build/scaffold/consts.d.ts

@@ -1,4 +1,4 @@
-import type { BentoFragmentKind } from './types.js';
+import type { BentoFragmentKind, LandingGateFieldKind } from './types.js';
 /**
  * The shapes a drawn widget can take.
  *
@@ -30,4 +30,17 @@ export declare const AREA_SECTION_CAP = 6;
  * value nothing can draw is a tile with an empty bottom.
  */
 export declare const BENTO_FRAGMENT_KINDS: BentoFragmentKind[];
+/**
+ * The controls a landing-gate field can be — the simplest native inputs, and no picker of any
+ * kind. A closed set for the same reason as {@link BENTO_FRAGMENT_KINDS}: each value is one plain
+ * element the seed's gate knows how to draw.
+ */
+export declare const LANDING_GATE_FIELD_KINDS: LandingGateFieldKind[];
+/** The most fields a landing gate carries. A form longer than this is a screen, not an entry. */
+export declare const LANDING_GATE_MAX_FIELDS = 3;
+/** The options a `select` field carries: fewer is no choice, more is a list to browse. */
+export declare const LANDING_GATE_OPTIONS: {
+    readonly min: 2;
+    readonly max: 6;
+};
 //# sourceMappingURL=consts.d.ts.map

package/build/scaffold/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/scaffold/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD;;;;;;;GAOG;AACH,oBAAY,UAAU;IACpB,6DAA6D;IAC7D,IAAI,SAAS;IACb,gEAAgE;IAChE,KAAK,UAAU;IACf,mCAAmC;IACnC,IAAI,SAAS;IACb,yCAAyC;IACzC,KAAK,UAAU;IACf,+DAA+D;IAC/D,IAAI,SAAS;CACd;AAED,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAAwC,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/scaffold/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEzE;;;;;;;GAOG;AACH,oBAAY,UAAU;IACpB,6DAA6D;IAC7D,IAAI,SAAS;IACb,gEAAgE;IAChE,KAAK,UAAU;IACf,mCAAmC;IACnC,IAAI,SAAS;IACb,yCAAyC;IACzC,KAAK,UAAU;IACf,+DAA+D;IAC/D,IAAI,SAAS;CACd;AAED,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAAwC,CAAA;AAE5F;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBAAoB,EAAyC,CAAA;AAEpG,iGAAiG;AACjG,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB;aAAK,GAAG,EAAE,CAAC;aAAE,GAAG,EAAE,CAAC;CAAW,CAAA"}

package/build/scaffold/consts.js

@@ -30,4 +30,14 @@ export const AREA_SECTION_CAP = 6;
  * value nothing can draw is a tile with an empty bottom.
  */
 export const BENTO_FRAGMENT_KINDS = ['list', 'note', 'people', 'steps'];
+/**
+ * The controls a landing-gate field can be — the simplest native inputs, and no picker of any
+ * kind. A closed set for the same reason as {@link BENTO_FRAGMENT_KINDS}: each value is one plain
+ * element the seed's gate knows how to draw.
+ */
+export const LANDING_GATE_FIELD_KINDS = ['text', 'select', 'number', 'date'];
+/** The most fields a landing gate carries. A form longer than this is a screen, not an entry. */
+export const LANDING_GATE_MAX_FIELDS = 3;
+/** The options a `select` field carries: fewer is no choice, more is a list to browse. */
+export const LANDING_GATE_OPTIONS = { min: 2, max: 6 };
 //# sourceMappingURL=consts.js.map

package/build/scaffold/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/scaffold/consts.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,6DAA6D;IAC7D,2BAAa,CAAA;IACb,gEAAgE;IAChE,6BAAe,CAAA;IACf,mCAAmC;IACnC,2BAAa,CAAA;IACb,yCAAyC;IACzC,6BAAe,CAAA;IACf,+DAA+D;IAC/D,2BAAa,CAAA;AACf,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAErC,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/scaffold/consts.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,6DAA6D;IAC7D,2BAAa,CAAA;IACb,gEAAgE;IAChE,6BAAe,CAAA;IACf,mCAAmC;IACnC,2BAAa,CAAA;IACb,yCAAyC;IACzC,6BAAe,CAAA;IACf,+DAA+D;IAC/D,2BAAa,CAAA;AACf,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAErC,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;AAE5F;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AAEpG,iGAAiG;AACjG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAExC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAW,CAAA"}

package/build/scaffold/schemas.d.ts

@@ -2,4 +2,11 @@ import type { JSONSchemaType } from 'ajv';
 import type { ProductIdentity, ScaffoldPlan } from './types.js';
 export declare const ProductIdentitySchema: JSONSchemaType<ProductIdentity>;
 export declare const ScaffoldPlanSchema: JSONSchemaType<ScaffoldPlan>;
+/**
+ * The plan as the planning MODEL answers it — {@link ScaffoldPlanSchema} with the gate held to the
+ * form. The stored schema keeps the pre-form gate keys optional so an old plan still validates;
+ * offering them to the model would let it write a chip picker again. Typed as the stored plan
+ * because every answer is one: the answer's gate is a subset of the stored gate.
+ */
+export declare const ScaffoldPlanAnswerSchema: JSONSchemaType<ScaffoldPlan>;
 //# sourceMappingURL=schemas.d.ts.map

package/build/scaffold/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/scaffold/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAIzC,OAAO,KAAK,EACqC,eAAe,EAC5C,YAAY,EAC/B,MAAM,YAAY,CAAA;AAgenB,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,eAAe,CAkBjE,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,YAAY,CA6B3D,CAAA"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/scaffold/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAIzC,OAAO,KAAK,EAC0E,eAAe,EACjF,YAAY,EAC/B,MAAM,YAAY,CAAA;AA+fnB,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,eAAe,CAkBjE,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,YAAY,CA6B3D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAiBrB,cAAc,CAAC,YAAY,CAAC,CAAA"}

package/build/scaffold/schemas.js

@@ -1,5 +1,5 @@
 import { ProjectArea } from '../areas/consts.js';
-import { BENTO_FRAGMENT_KINDS, WidgetKind } from './consts.js';
+import { BENTO_FRAGMENT_KINDS, LANDING_GATE_FIELD_KINDS, WidgetKind } from './consts.js';
 const SketchContentSchema = {
     type: 'object',
     title: 'SketchContent',
@@ -75,7 +75,8 @@ const ScaffoldStoryPlanSchema = {
         screen: {
             type: 'string',
             description: 'The main screen this story will need, named "{section}/{purpose}" -'
-                + ' e.g. "Requests/Submit a request". The section part must equal the section above'
+                + ' e.g. "Requests/Submit request". The purpose is one or two words, never a sentence.'
+                + ' The section part must equal the section above'
         },
         widget: {
             type: 'object',
@@ -213,99 +214,125 @@ const BentoFragmentSchema = {
     required: ['kind', 'rows'],
     additionalProperties: false,
 };
-const LandingGatePlanSchema = {
+const LandingGateFieldSchema = {
     type: 'object',
-    title: 'LandingGatePlan',
-    description: 'The working entry into the key end-user workflow, drawn in the hero instead of the'
-        + ' call-to-action buttons: a guest makes a few picks, sees sample results ranked against them,'
-        + ' and signs in to continue with the picks carried over. Every text is in the end user\'s words',
+    title: 'LandingGateField',
+    description: 'One simple, non-sensitive field of the landing gate',
     properties: {
-        story: {
+        name: {
             type: 'string',
-            description: 'The code of the landing story, copied EXACTLY as given to you. Never shown'
+            description: 'The camelCase key its value travels under, one word - e.g. "dish"'
         },
-        target: {
-            type: 'string', nullable: true,
-            description: 'Leave it out - the platform fills it'
-        },
-        question: {
+        label: {
             type: 'string',
-            description: 'The question the gate asks, 3-6 words, in the end user\'s words - e.g. "What\'s'
-                + ' in your pantry?"'
+            description: 'The visible label in the end user\'s words, 2-5 words - e.g. "What are you baking?"'
         },
-        hint: { type: 'string', description: 'A short reassurance beside it, e.g. "No account needed"' },
-        label: {
+        kind: {
             type: 'string',
-            description: 'The accessible name of the group of choices, 2-3 words - e.g. "Your pantry"'
+            enum: LANDING_GATE_FIELD_KINDS,
+            description: 'text (a short line, the default), select (ONE choice out of 2-6 plain options),'
+                + ' number, or date. Nothing else exists: no chips, no toggles, no multiple choice'
         },
-        inputs: {
-            type: 'array',
-            items: { type: 'string' },
-            description: '5 to 8 things a guest can pick, 1-3 words each, from the story\'s own domain.'
-                + ' Nothing personal, nothing sensitive, nothing that needs an account'
+        placeholder: {
+            type: 'string', nullable: true,
+            description: 'text or number only: an example value, e.g. "Rye sourdough". Never personal'
         },
-        selected: {
-            type: 'array',
+        options: {
+            type: 'array', nullable: true,
             items: { type: 'string' },
-            description: '4 or 5 of the inputs above, copied exactly, pre-selected so the first view'
-                + ' already shows results'
+            description: 'select only: 2 to 6 plain options, 1-3 words each'
         },
+    },
+    required: ['name', 'label', 'kind'],
+    additionalProperties: false,
+};
+/** What the gate's texts tell the planning model — one place, shared by the answer and stored schemas. */
+const GATE_TEXT = {
+    description: 'The working entry into the key end-user workflow, drawn in the hero instead of the'
+        + ' call-to-action buttons: ONE SMALL FORM - a heading, one to three simple non-sensitive'
+        + ' fields, one button. A guest fills it in, signs in, and continues with what they entered.'
+        + ' No choices to browse, no sample results, no counts, no previews. Every text is in the end'
+        + ' user\'s words',
+    story: 'The code of the landing story, copied EXACTLY as given to you. Never shown',
+    target: 'Leave it out - the platform fills it',
+    question: 'The heading of the form, 3-6 words, in the end user\'s words - e.g. "What are you'
+        + ' baking?"',
+    fields: 'The fields, AS FEW AS POSSIBLE: one whenever one is enough, never more than three. They'
+        + ' are the first things the story\'s own screen asks for, in the same words',
+    cta: 'The button label, a verb first, 2-3 words and an arrow - e.g. "Start my post →"',
+    note: 'One short muted line under the form: no account is needed yet and what was entered comes'
+        + ' along - e.g. "No account needed. What you enter comes with you."',
+};
+/** The pre-form keys of a stored gate: optional, described as history, never offered to the model. */
+const LEGACY_GATE_NOTE = 'Pre-form shape, never written';
+/**
+ * What the planning MODEL answers for the gate: the form and nothing older. The stored schema below
+ * adds the pre-form keys as optional, so a plan written before the gate became a form still
+ * validates; the model is never offered them.
+ */
+const LandingGateAnswerSchema = {
+    type: 'object',
+    title: 'LandingGatePlan',
+    description: GATE_TEXT.description,
+    properties: {
+        story: { type: 'string', description: GATE_TEXT.story },
+        target: { type: 'string', nullable: true, description: GATE_TEXT.target },
+        question: { type: 'string', description: GATE_TEXT.question },
+        fields: { type: 'array', items: LandingGateFieldSchema, description: GATE_TEXT.fields },
+        cta: { type: 'string', description: GATE_TEXT.cta },
+        note: { type: 'string', description: GATE_TEXT.note },
+    },
+    required: ['story', 'question', 'fields', 'cta', 'note'],
+    additionalProperties: false,
+};
+/**
+ * The gate as a plan may STORE it: the form, plus the pre-form keys (chips, sample records, a live
+ * count) as optional. A schema that validates a stored document only ever grows optional.
+ */
+const LandingGatePlanSchema = {
+    type: 'object',
+    title: 'LandingGatePlan',
+    description: GATE_TEXT.description,
+    properties: {
+        story: { type: 'string', description: GATE_TEXT.story },
+        target: { type: 'string', nullable: true, description: GATE_TEXT.target },
+        question: { type: 'string', description: GATE_TEXT.question },
+        fields: { type: 'array', nullable: true, items: LandingGateFieldSchema, description: GATE_TEXT.fields },
+        cta: { type: 'string', description: GATE_TEXT.cta },
+        note: { type: 'string', description: GATE_TEXT.note },
+        hint: { type: 'string', nullable: true, description: LEGACY_GATE_NOTE },
+        label: { type: 'string', nullable: true, description: LEGACY_GATE_NOTE },
+        inputs: { type: 'array', nullable: true, items: { type: 'string' }, description: LEGACY_GATE_NOTE },
+        selected: { type: 'array', nullable: true, items: { type: 'string' }, description: LEGACY_GATE_NOTE },
         results: {
-            type: 'array',
+            type: 'array', nullable: true,
             items: {
                 type: 'object',
                 properties: {
-                    title: { type: 'string', description: 'A realistic record title, 2-4 words' },
-                    meta: {
-                        type: 'string',
-                        description: 'One short line: how well it fits and one fact, e.g. "Uses all 3 · 3 h 20 min"'
-                    },
-                    needs: {
-                        type: 'array',
-                        items: { type: 'string' },
-                        description: '2-4 of the inputs above, copied exactly, that this record uses'
-                    },
+                    title: { type: 'string' },
+                    meta: { type: 'string' },
+                    needs: { type: 'array', items: { type: 'string' } },
                 },
                 required: ['title', 'meta', 'needs'],
                 additionalProperties: false,
             },
-            description: '3 or 4 sample records the picks are ranked against - illustrative, never real data'
+            description: LEGACY_GATE_NOTE
         },
         count: {
-            type: 'object',
+            type: 'object', nullable: true,
             properties: {
-                one: { type: 'string', description: 'The count for one match, with {n}: "{n} bake matches"' },
-                many: { type: 'string', description: 'The count for several, with {n}: "{n} bakes match"' },
-                none: { type: 'string', description: 'The count for none, e.g. "No matches yet"' },
+                one: { type: 'string' },
+                many: { type: 'string' },
+                none: { type: 'string' },
             },
             required: ['one', 'many', 'none'],
             additionalProperties: false,
-            description: 'The live count label; write the literal token {n} where the number goes'
-        },
-        empty: {
-            type: 'string',
-            description: 'One line shown when nothing matches, saying what to pick - e.g. "Pick two or more'
-                + ' ingredients to see what you can bake."'
-        },
-        note: {
-            type: 'string',
-            description: 'One short line beside the button: signing in is by email and the picks come'
-                + ' along - e.g. "Sign in with your email. Your picks come with you."'
-        },
-        cta: {
-            type: 'string',
-            description: 'The button label, a verb first, 2-3 words and an arrow - e.g. "Open recipes →"'
-        },
-        lock: {
-            type: 'string',
-            description: 'What unlocks after sign-in, as the accessible name of a lock icon - e.g. "Full'
-                + ' method after sign-in"'
+            description: LEGACY_GATE_NOTE
         },
+        empty: { type: 'string', nullable: true, description: LEGACY_GATE_NOTE },
+        lock: { type: 'string', nullable: true, description: LEGACY_GATE_NOTE },
     },
-    required: [
-        'story', 'question', 'hint', 'label', 'inputs', 'selected', 'results', 'count', 'empty',
-        'note', 'cta', 'lock',
-    ],
+    required: ['story', 'question', 'cta', 'note'],
     additionalProperties: false,
 };
 const GuestHomePlanSchema = {
@@ -520,4 +547,28 @@ export const ScaffoldPlanSchema = {
     required: ['identity', 'guestHome', 'areas', 'stories', 'motifs'],
     additionalProperties: false,
 };
+/**
+ * The plan as the planning MODEL answers it — {@link ScaffoldPlanSchema} with the gate held to the
+ * form. The stored schema keeps the pre-form gate keys optional so an old plan still validates;
+ * offering them to the model would let it write a chip picker again. Typed as the stored plan
+ * because every answer is one: the answer's gate is a subset of the stored gate.
+ */
+export const ScaffoldPlanAnswerSchema = {
+    ...ScaffoldPlanSchema,
+    properties: {
+        ...ScaffoldPlanSchema.properties,
+        guestHome: {
+            ...GuestHomePlanSchema,
+            properties: {
+                ...GuestHomePlanSchema.properties,
+                gate: {
+                    ...LandingGateAnswerSchema,
+                    nullable: true,
+                    description: 'ONLY when you were given a landing story; omit it otherwise. '
+                        + LandingGateAnswerSchema.description,
+                },
+            },
+        },
+    },
+};
 //# sourceMappingURL=schemas.js.map