@substrat-run/contracts 0.91.1 → 0.92.0

package/dist/client-context.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+/**
+ * Where the request came from, as far as the edge could tell.
+ *
+ * `region` is the human name (`Stockholm County`), not a code — codes differ per
+ * country and a person reads the name. `timezone` is an IANA name, which is what a
+ * UI hands to `Intl.DateTimeFormat` to show the visitor's local time.
+ */
+export declare const clientGeo: z.ZodObject<{
+    country: z.ZodNullable<z.ZodString>;
+    region: z.ZodNullable<z.ZodString>;
+    city: z.ZodNullable<z.ZodString>;
+    timezone: z.ZodNullable<z.ZodString>;
+    continent: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ClientGeo = z.infer<typeof clientGeo>;
+export declare const EMPTY_GEO: ClientGeo;
+/**
+ * What kind of thing sent the request. Coarse on purpose: the question a person
+ * asks is "were they on a phone?", and a finer answer than this would be a guess
+ * dressed as a fact — user agents lie, and iPadOS reports itself as a Mac.
+ */
+export declare const clientDeviceKind: z.ZodEnum<{
+    bot: "bot";
+    desktop: "desktop";
+    mobile: "mobile";
+    tablet: "tablet";
+    unknown: "unknown";
+}>;
+export type ClientDeviceKind = z.infer<typeof clientDeviceKind>;
+/** The browser and operating system, parsed out of the `User-Agent` into names a person reads. */
+export declare const clientDevice: z.ZodObject<{
+    browser: z.ZodNullable<z.ZodString>;
+    browserVersion: z.ZodNullable<z.ZodString>;
+    os: z.ZodNullable<z.ZodString>;
+    osVersion: z.ZodNullable<z.ZodString>;
+    kind: z.ZodEnum<{
+        bot: "bot";
+        desktop: "desktop";
+        mobile: "mobile";
+        tablet: "tablet";
+        unknown: "unknown";
+    }>;
+}, z.core.$strip>;
+export type ClientDevice = z.infer<typeof clientDevice>;
+export declare const clientContext: z.ZodObject<{
+    userAgent: z.ZodNullable<z.ZodString>;
+    language: z.ZodNullable<z.ZodString>;
+    device: z.ZodObject<{
+        browser: z.ZodNullable<z.ZodString>;
+        browserVersion: z.ZodNullable<z.ZodString>;
+        os: z.ZodNullable<z.ZodString>;
+        osVersion: z.ZodNullable<z.ZodString>;
+        kind: z.ZodEnum<{
+            bot: "bot";
+            desktop: "desktop";
+            mobile: "mobile";
+            tablet: "tablet";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strip>;
+    geo: z.ZodObject<{
+        country: z.ZodNullable<z.ZodString>;
+        region: z.ZodNullable<z.ZodString>;
+        city: z.ZodNullable<z.ZodString>;
+        timezone: z.ZodNullable<z.ZodString>;
+        continent: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ClientContext = z.infer<typeof clientContext>;
+/**
+ * Turn a `User-Agent` into names a person reads.
+ *
+ * Hand-rolled and small on purpose. A full UA database is a dependency that
+ * changes weekly and answers questions nobody here asks (which Nokia model?); this
+ * answers the four a support agent does — which browser, which OS, phone or not,
+ * human or not — and stores the raw string beside them so a wrong answer can be
+ * re-read later. Absent or unrecognised input is `unknown`, never a throw: a request
+ * with a strange UA is still a request.
+ */
+export declare function parseUserAgent(userAgent: string | null | undefined): ClientDevice;
+/** The subset of the web-standard `Headers` this needs — so a test hands in a plain object. */
+export interface HeadersLike {
+    get(name: string): string | null;
+}
+/**
+ * The first language tag of `Accept-Language`, or null. The header is a weighted
+ * list (`sv-SE,sv;q=0.9,en;q=0.8`) and browsers put the preferred one first, so the
+ * head is the answer; weights are not re-sorted, because no browser sends them out
+ * of order and a hand-written header that does is not worth a parser.
+ */
+export declare function preferredLanguage(acceptLanguage: string | null | undefined): string | null;
+/**
+ * Build a `ClientContext` from a request's headers and whatever geo the host knows.
+ *
+ * This is the runtime-neutral half: the headers are the same on every host, and the
+ * geo is what differs — so a host with none (the node dev server) passes nothing and
+ * gets `EMPTY_GEO`, and one with some (`cloudflareClientContext`) passes what it
+ * normalised. A partial geo is filled out to the full shape so a row always has
+ * every column — and a field that is present but `undefined` counts as absent, since
+ * `Partial` admits it and a spread would carry it through to a schema that does not.
+ */
+export declare function clientContextOf(headers: HeadersLike, geo?: Partial<ClientGeo>): ClientContext;
+//# sourceMappingURL=client-context.d.ts.map

package/dist/client-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-context.d.ts","sourceRoot":"","sources":["../src/client-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgCxB;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;iBAOpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,SAAS,EAAE,SAMtB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAA4D,CAAC;AAC1F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,kGAAkG;AAClG,eAAO,MAAM,YAAY;;;;;;;;;;;;iBASvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;iBAOxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAiG1D;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAsBjF;AAMD,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,aAAa,CAc7F"}

package/dist/client-context.js

@@ -0,0 +1,243 @@
+import { z } from 'zod';
+/**
+ * Who is on the other end of a request — the CLIENT, not the principal.
+ *
+ * A principal says who is authorised; this says what they are holding and roughly
+ * where they are holding it: the browser and OS a support agent needs to reproduce
+ * a bug, the country and timezone that tell them it is 3 am for the person typing,
+ * the language the reply should probably be in. None of it is authority, and none of
+ * it is trusted for anything but display and triage.
+ *
+ * It is a NORMALISED shape, and that is the point of it. Every runtime hands these
+ * facts over differently — Cloudflare puts geo on `request.cf`, another edge puts it
+ * in headers, a node dev server has no geo at all — and a vertical that read the raw
+ * source would be a vertical that only runs on one host. So a host builds one of
+ * these (`@substrat-run/adapter-cloudflare` exports `cloudflareClientContext`), passes
+ * it in as operation input, and module code sees only this. The one part that is the
+ * same everywhere — the `User-Agent` and `Accept-Language` headers — is parsed here,
+ * so every host reads "Safari 17 on iOS" the same way.
+ *
+ * What is deliberately absent: the IP address. It is the most identifying field a
+ * request carries and the least useful to a person reading a conversation; the
+ * country and city it resolves to carry the useful part without the fingerprint.
+ * Every COLLECTED value is nullable, because every one is something a request may not
+ * say; the shape around them is not. `device` and `geo` are always present, and
+ * `device.kind` is always a kind — `'unknown'` when the parser could not tell — so a
+ * reader destructures without guarding and a row always has every column.
+ */
+/** ISO 3166-1 alpha-2, upper case. */
+const countryCode = z.string().regex(/^[A-Z]{2}$/);
+/**
+ * Where the request came from, as far as the edge could tell.
+ *
+ * `region` is the human name (`Stockholm County`), not a code — codes differ per
+ * country and a person reads the name. `timezone` is an IANA name, which is what a
+ * UI hands to `Intl.DateTimeFormat` to show the visitor's local time.
+ */
+export const clientGeo = z.object({
+    country: countryCode.nullable(),
+    region: z.string().nullable(),
+    city: z.string().nullable(),
+    timezone: z.string().nullable(),
+    /** Two-letter continent code as Cloudflare reports it (`EU`, `NA`, …). */
+    continent: z.string().regex(/^[A-Z]{2}$/).nullable(),
+});
+export const EMPTY_GEO = Object.freeze({
+    country: null,
+    region: null,
+    city: null,
+    timezone: null,
+    continent: null,
+});
+/**
+ * What kind of thing sent the request. Coarse on purpose: the question a person
+ * asks is "were they on a phone?", and a finer answer than this would be a guess
+ * dressed as a fact — user agents lie, and iPadOS reports itself as a Mac.
+ */
+export const clientDeviceKind = z.enum(['desktop', 'mobile', 'tablet', 'bot', 'unknown']);
+/** The browser and operating system, parsed out of the `User-Agent` into names a person reads. */
+export const clientDevice = z.object({
+    /** `Chrome`, `Safari`, `Firefox`, `Edge`, `Samsung Internet`, `Opera`, `Internet Explorer`, or a bot's name. */
+    browser: z.string().nullable(),
+    /** As reported, e.g. `126.0.6478.127`; show the major. */
+    browserVersion: z.string().nullable(),
+    /** `iOS`, `Android`, `macOS`, `Windows`, `Linux`, `ChromeOS`. */
+    os: z.string().nullable(),
+    osVersion: z.string().nullable(),
+    kind: clientDeviceKind,
+});
+export const clientContext = z.object({
+    /** The raw header, kept so a better parser can re-read it later. */
+    userAgent: z.string().nullable(),
+    /** The first tag of `Accept-Language` (BCP 47, e.g. `sv-SE`) — what the person asked to be spoken to in. */
+    language: z.string().nullable(),
+    device: clientDevice,
+    geo: clientGeo,
+});
+// ---------------------------------------------------------------------------
+// User-Agent parsing
+// ---------------------------------------------------------------------------
+const UNKNOWN_DEVICE = Object.freeze({
+    browser: null,
+    browserVersion: null,
+    os: null,
+    osVersion: null,
+    kind: 'unknown',
+});
+/**
+ * The bots worth naming. Anything else matching the generic tail is still a bot,
+ * just an unnamed one.
+ */
+const BOT_NAMES = [
+    [/Googlebot/i, 'Googlebot'],
+    [/bingbot/i, 'Bingbot'],
+    [/DuckDuckBot/i, 'DuckDuckBot'],
+    [/Slackbot/i, 'Slackbot'],
+    [/Twitterbot/i, 'Twitterbot'],
+    [/facebookexternalhit/i, 'Facebook'],
+    [/LinkedInBot/i, 'LinkedInBot'],
+    [/Applebot/i, 'Applebot'],
+    [/GPTBot/i, 'GPTBot'],
+    [/ClaudeBot/i, 'ClaudeBot'],
+    [/HeadlessChrome/i, 'Headless Chrome'],
+    [/Lighthouse/i, 'Lighthouse'],
+    [/curl\//i, 'curl'],
+    [/Wget\//i, 'wget'],
+    [/python-requests|python-urllib|aiohttp/i, 'Python'],
+    [/Go-http-client/i, 'Go'],
+    [/node-fetch|undici/i, 'Node'],
+];
+const BOT_GENERIC = /bot|crawl|spider|slurp|scrape|fetch|monitor|preview|headless/i;
+/**
+ * Browsers in the order they must be tried. Every Chromium fork carries `Chrome/`
+ * and every WebKit browser carries `Safari/`, so the specific names go first and
+ * the two generic ones last.
+ */
+const BROWSERS = [
+    [/\bEdg(?:e|A|iOS)?\/([\d.]+)/, 'Edge'],
+    [/\bOPR\/([\d.]+)/, 'Opera'],
+    [/\bOpera[/ ]([\d.]+)/, 'Opera'],
+    [/\bSamsungBrowser\/([\d.]+)/, 'Samsung Internet'],
+    [/\bFirefox\/([\d.]+)/, 'Firefox'],
+    [/\bFxiOS\/([\d.]+)/, 'Firefox'],
+    [/\bCriOS\/([\d.]+)/, 'Chrome'],
+    [/\bChrome\/([\d.]+)/, 'Chrome'],
+    // Safari's own version is in `Version/`; the `Safari/` token is the WebKit build.
+    [/\bVersion\/([\d.]+).*\bSafari\//, 'Safari'],
+    [/\bMSIE ([\d.]+)/, 'Internet Explorer'],
+    [/\bTrident\/.*\brv:([\d.]+)/, 'Internet Explorer'],
+];
+/** `Windows NT 10.0` is Windows 10 (or 11 — the UA cannot tell them apart). */
+const WINDOWS_NT = {
+    '10.0': '10',
+    '6.3': '8.1',
+    '6.2': '8',
+    '6.1': '7',
+    '6.0': 'Vista',
+    '5.1': 'XP',
+};
+function os(ua) {
+    let m;
+    if ((m = /\b(?:iPhone|iPad|iPod)\b.*?\bOS (\d+(?:_\d+)*)/.exec(ua)))
+        return { os: 'iOS', osVersion: m[1].replace(/_/g, '.') };
+    if (/\b(?:iPhone|iPad|iPod)\b/.test(ua))
+        return { os: 'iOS', osVersion: null };
+    if ((m = /\bAndroid (\d+(?:\.\d+)*)/.exec(ua)))
+        return { os: 'Android', osVersion: m[1] };
+    if (/\bAndroid\b/.test(ua))
+        return { os: 'Android', osVersion: null };
+    if ((m = /\bWindows NT (\d+\.\d+)/.exec(ua)))
+        return { os: 'Windows', osVersion: WINDOWS_NT[m[1]] ?? m[1] };
+    if (/\bWindows\b/.test(ua))
+        return { os: 'Windows', osVersion: null };
+    if ((m = /\bMac OS X (\d+(?:[_.]\d+)*)/.exec(ua)))
+        return { os: 'macOS', osVersion: m[1].replace(/_/g, '.') };
+    if (/\bMacintosh\b/.test(ua))
+        return { os: 'macOS', osVersion: null };
+    if (/\bCrOS\b/.test(ua))
+        return { os: 'ChromeOS', osVersion: null };
+    if (/\bLinux\b|\bX11\b/.test(ua))
+        return { os: 'Linux', osVersion: null };
+    return { os: null, osVersion: null };
+}
+function kindOf(ua, osName) {
+    if (/\biPad\b|\bTablet\b/i.test(ua))
+        return 'tablet';
+    // Android reports `Mobile` on phones and omits it on tablets.
+    if (osName === 'Android')
+        return /\bMobile\b/.test(ua) ? 'mobile' : 'tablet';
+    if (/\biPhone\b|\biPod\b|\bMobi/i.test(ua))
+        return 'mobile';
+    if (osName === 'Windows' || osName === 'macOS' || osName === 'Linux' || osName === 'ChromeOS')
+        return 'desktop';
+    return 'unknown';
+}
+/**
+ * Turn a `User-Agent` into names a person reads.
+ *
+ * Hand-rolled and small on purpose. A full UA database is a dependency that
+ * changes weekly and answers questions nobody here asks (which Nokia model?); this
+ * answers the four a support agent does — which browser, which OS, phone or not,
+ * human or not — and stores the raw string beside them so a wrong answer can be
+ * re-read later. Absent or unrecognised input is `unknown`, never a throw: a request
+ * with a strange UA is still a request.
+ */
+export function parseUserAgent(userAgent) {
+    const ua = userAgent?.trim() ?? '';
+    if (!ua)
+        return UNKNOWN_DEVICE;
+    for (const [re, name] of BOT_NAMES)
+        if (re.test(ua))
+            return { ...UNKNOWN_DEVICE, browser: name, kind: 'bot' };
+    const platform = os(ua);
+    let browser = null;
+    let browserVersion = null;
+    for (const [re, name] of BROWSERS) {
+        const m = re.exec(ua);
+        if (m) {
+            browser = name;
+            browserVersion = m[1] ?? null;
+            break;
+        }
+    }
+    // An unnamed crawler that still says "bot" somewhere: a browser never does, so the
+    // browser and OS it may spoof are kept (they are what it claims) and the kind is not.
+    const kind = BOT_GENERIC.test(ua) ? 'bot' : kindOf(ua, platform.os);
+    return { browser, browserVersion, os: platform.os, osVersion: platform.osVersion, kind };
+}
+/**
+ * The first language tag of `Accept-Language`, or null. The header is a weighted
+ * list (`sv-SE,sv;q=0.9,en;q=0.8`) and browsers put the preferred one first, so the
+ * head is the answer; weights are not re-sorted, because no browser sends them out
+ * of order and a hand-written header that does is not worth a parser.
+ */
+export function preferredLanguage(acceptLanguage) {
+    const first = acceptLanguage?.split(',')[0]?.split(';')[0]?.trim() ?? '';
+    return /^[A-Za-z]{1,8}(?:-[A-Za-z0-9]{1,8})*$/.test(first) ? first : null;
+}
+/**
+ * Build a `ClientContext` from a request's headers and whatever geo the host knows.
+ *
+ * This is the runtime-neutral half: the headers are the same on every host, and the
+ * geo is what differs — so a host with none (the node dev server) passes nothing and
+ * gets `EMPTY_GEO`, and one with some (`cloudflareClientContext`) passes what it
+ * normalised. A partial geo is filled out to the full shape so a row always has
+ * every column — and a field that is present but `undefined` counts as absent, since
+ * `Partial` admits it and a spread would carry it through to a schema that does not.
+ */
+export function clientContextOf(headers, geo) {
+    const userAgent = headers.get('user-agent')?.trim() || null;
+    return {
+        userAgent,
+        language: preferredLanguage(headers.get('accept-language')),
+        device: parseUserAgent(userAgent),
+        geo: {
+            country: geo?.country ?? null,
+            region: geo?.region ?? null,
+            city: geo?.city ?? null,
+            timezone: geo?.timezone ?? null,
+            continent: geo?.continent ?? null,
+        },
+    };
+}
+//# sourceMappingURL=client-context.js.map

package/dist/client-context.js.map

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

package/dist/index.d.ts

@@ -42,4 +42,5 @@ export * from './attachments.js';
 export * from './model.js';
 export * from './operations.js';
 export * from './lifecycle.js';
+export * from './client-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -42,4 +42,5 @@ export * from './attachments.js';
 export * from './model.js';
 export * from './operations.js';
 export * from './lifecycle.js';
+export * from './client-context.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/contracts",
-  "version": "0.91.1",
+  "version": "0.92.0",
   "description": "Substrat kernel contract schemas — Zod is the source of truth (master plan D-22); OAS/JSON Schema are emitted artifacts",
   "license": "Apache-2.0",
   "repository": {