@happyvertical/smrt-mobile-contract 0.37.7

package/AGENTS.md

@@ -0,0 +1,53 @@
+# @happyvertical/smrt-mobile-contract
+
+TypeScript codegen bridging the SMRT manifest to the KMP mobile foundation
+(ADR 0001, epic #1745). Generalizes amaru's `amaru-mobile-contract`
+(manifest → allowlist → contract → Kotlin) and reporter's Swift emission.
+Zero runtime dependencies by design — it reads `manifest.json` files
+directly, so it stays out of the smrt package DAG.
+
+## Two generation surfaces
+
+1. **Framework contract** (`frameworkKotlinFiles()` / `frameworkSwiftFiles()`)
+   — the stable files checked into `@happyvertical/smrt-mobile` under
+   `src/commonMain/kotlin/.../contract/` (support types, pack localization,
+   `/api/mobile/*` auth/session/device DTOs). This package is their single
+   source of truth: `pnpm generate:framework` rewrites them; `pnpm build`
+   verifies freshness (`scripts/generate-framework.mjs`). (The script is
+   deliberately NOT named `generate` — turbo's `build` task auto-runs a
+   `generate` script, which would rewrite the files on every build and
+   neutralize the freshness gate.) The Swift mirror
+   (`MobileContract.swift`) is emitted on demand for SwiftUI apps and is not
+   checked into smrt-mobile (iOS wiring is Phase 6).
+2. **Per-app domain DTOs** (`buildMobileContract()` +
+   `generateKotlinDtoFiles()` / `generateSwiftDtoFile()`) — consumer apps
+   pass their SMRT `manifest.json`(s) plus an object allowlist and a Kotlin
+   package; they get `@Serializable` Kotlin DTOs (defaults on every field for
+   safe partial deserialization) and plain Swift structs. Type mapping is
+   driven by manifest field `type` metadata (`text`/`integer`/`decimal`/
+   `boolean`/`datetime`/`foreignKey`/`crossPackageRef`/`json`), with amaru's
+   name heuristics only as a fallback for typeless fields. Relationship
+   declarations (`oneToMany`/`manyToMany`/`hasMany`) are excluded — they are
+   not scalar columns. Field defaults come from `default` (current manifests)
+   with `defaultValue` (amaru-era) as fallback. Decimals emit as
+   `DecimalString` (string-encoded — no float precision loss); field names
+   stay manifest-faithful (wire-format names, including `created_at`).
+
+## Conventions
+
+- `DecimalString`/`Measurement` and the auth contract types are imported from
+  `com.happyvertical.smrt.mobile.contract`, never re-emitted per app.
+- Allowlist entries may be short names or qualified names
+  (`@scope/pkg:Object`); ambiguous short names across manifests are an error.
+- `sourceHash` (sha256 over allowlist + projected objects) is stamped into
+  generated output so drift is detectable.
+- `turbo.json` here widens the build inputs to smrt-mobile's checked-in
+  contract dir so the freshness verify can't replay stale from cache.
+
+## Commands
+
+```bash
+pnpm build                # vite build + verify smrt-mobile framework contract freshness
+pnpm generate:framework   # vite build + REWRITE the smrt-mobile framework contract
+pnpm test                 # vitest
+```

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# @happyvertical/smrt-mobile-contract
+
+Codegen for the SMRT mobile foundation: projects a SMRT `manifest.json`
+through a mobile allowlist into typed Kotlin (`@Serializable` DTOs for the
+KMP module) and Swift (plain structs) — plus the generated framework
+contract files checked into
+[`@happyvertical/smrt-mobile`](../smrt-mobile/README.md).
+
+Design: [ADR 0001](../../docs/content/adr/0001-kmp-mobile-foundation.md);
+epic happyvertical/smrt#1745. Agent/developer guidance:
+[AGENTS.md](./AGENTS.md). Zero runtime dependencies by design — it reads
+`manifest.json` files directly and stays out of the smrt package DAG.
+
+## Install
+
+```bash
+pnpm add -D @happyvertical/smrt-mobile-contract
+```
+
+## Usage — per-app domain DTOs
+
+```ts
+import {
+  buildMobileContract,
+  generateKotlinDtoFiles,
+  generateSwiftDtoFile,
+  writeFileSet,
+} from '@happyvertical/smrt-mobile-contract';
+import { readFileSync, writeFileSync } from 'node:fs';
+
+const manifest = JSON.parse(
+  readFileSync('packages/my-objects/src/manifest/manifest.json', 'utf8'),
+);
+
+const contract = buildMobileContract({
+  manifests: [manifest],                     // one or more SMRT manifests
+  allowlist: ['FieldReport', 'Attachment'],  // short or qualified names
+  kotlinPackage: 'com.example.mobile.generated',
+  sourceLabel: 'packages/my-objects/src/manifest/manifest.json',
+});
+
+writeFileSet(
+  'apps/mobile/shared/src/commonMain/kotlin/generated',
+  generateKotlinDtoFiles(contract),
+);
+writeFileSync(
+  'apps/mobile/iosApp/App/GeneratedMobileDtos.swift',
+  generateSwiftDtoFile(contract),
+);
+```
+
+### Allowlist rules
+
+- Entries may be short names (`FieldReport`) or qualified names
+  (`@scope/pkg:FieldReport`). A short name that matches objects in more than
+  one manifest is an error — use the qualified name.
+- Two allowlisted objects may not share a short name: generated `<Name>Dto`
+  files would overwrite each other, so the build throws instead.
+- Relationship declarations (`oneToMany`/`manyToMany`/`hasMany`) are excluded
+  from DTO projection — they are not scalar columns.
+
+### Type mapping
+
+| Manifest `type` | Kotlin | Swift |
+|---|---|---|
+| `text` / `status` / `foreignKey` / `crossPackageRef` | `String` | `String` |
+| `integer` | `Long` (64-bit — byte sizes/epochs overflow `Int`) | `Int64` |
+| `decimal` | `DecimalString?` (string-encoded, no float precision loss) | `String?` |
+| `boolean` | `Boolean` | `Bool` |
+| `datetime` | `Instant?` | `String?` |
+| `json` | `JsonObject` | `String` (raw JSON) |
+
+Field defaults come from `default` (current manifests) with `defaultValue`
+(amaru-era) as a fallback; every generated Kotlin field default-initializes
+for safe partial deserialization. Field names stay manifest-faithful
+(wire-format names, including `created_at`); keyword collisions are
+backtick-escaped per language. `sourceHash` (sha256 over allowlist +
+projected objects) is stamped into all output so drift is detectable.
+
+## Usage — the framework contract
+
+The stable framework contract (support types, pack localization, and the
+`/api/mobile` auth/session/device DTOs) is emitted by this package and
+checked into `smrt-mobile`'s `contract/` directory. This package's `build`
+byte-verifies those files; regenerate after editing `src/emit-framework.ts`:
+
+```bash
+pnpm --filter @happyvertical/smrt-mobile-contract generate:framework
+```
+
+The Swift mirror (`frameworkSwiftFiles()`) is emitted on demand for SwiftUI
+apps; a parity test keeps it field-for-field in sync with the Kotlin side.
+
+## Development
+
+```bash
+pnpm build   # vite build + framework contract freshness verify
+pnpm test    # vitest (goldens, mapping rules, parity, file-set round-trip)
+```

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+export declare function buildMobileContract(options: MobileContractOptions): MobileContract;
+
+/** Kotlin framework contract files, keyed by file name. */
+export declare function frameworkKotlinFiles(): Map<string, string>;
+
+/**
+ * Swift mirror of the framework contract for SwiftUI apps (reporter
+ * precedent). Not checked into smrt-mobile — iOS wiring lands with
+ * smrt-ios (Phase 6); apps can emit it via this API meanwhile.
+ */
+export declare function frameworkSwiftFiles(): Map<string, string>;
+
+export declare const GENERATED_HEADER: string;
+
+/**
+ * Emits one Kotlin DTO file per allowlisted object, plus a
+ * `MobileContractManifest.kt` recording the contract identity, all in the
+ * consumer's Kotlin package. Framework support types (DecimalString, …) are
+ * imported from `com.happyvertical.smrt.mobile.contract`.
+ */
+export declare function generateKotlinDtoFiles(contract: MobileContract): Map<string, string>;
+
+/**
+ * Emits all allowlisted domain DTOs into a single Swift file. Structs are
+ * plain (no Codable) per the reporter seed — apps decode JSON as needed.
+ * Kotlin `JsonObject` fields arrive as raw JSON strings on the Swift side.
+ */
+export declare function generateSwiftDtoFile(contract: MobileContract): string;
+
+export declare interface MobileContract {
+    schemaVersion: number;
+    contractVersion: string;
+    sourceLabel: string;
+    sourceHash: string;
+    objectAllowlist: string[];
+    objectCount: number;
+    kotlin: {
+        packageName: string;
+    };
+    typeMappings: Record<string, string>;
+    objects: MobileContractObject[];
+}
+
+export declare interface MobileContractField {
+    /** Manifest-faithful wire name (also the generated property name). */
+    name: string;
+    kotlinType: string;
+    swiftType: string;
+    nullable: boolean;
+    /** Kotlin default-value expression, or null for required (id). */
+    kotlinDefault: string | null;
+}
+
+export declare interface MobileContractObject {
+    name: string;
+    qualifiedName: string;
+    dtoName: string;
+    tableName: string | null;
+    hasTenantId: boolean;
+    fields: MobileContractField[];
+}
+
+export declare interface MobileContractOptions {
+    manifests: SmrtManifest[];
+    /** Object names (or qualified names) exposed to mobile. */
+    allowlist: string[];
+    /** Kotlin package the domain DTOs are emitted into. */
+    kotlinPackage: string;
+    /** Provenance label recorded in the contract (e.g. the manifest path). */
+    sourceLabel?: string;
+}
+
+/** Schema version of the mobile-contract.json envelope. */
+export declare const SMRT_MOBILE_CONTRACT_SCHEMA_VERSION = 1;
+
+/**
+ * Version stamp of the framework contract surface (auth/session/device/pack
+ * localization types). Bump when the framework contract shape changes.
+ */
+export declare const SMRT_MOBILE_CONTRACT_VERSION = "2026-07-01.v1";
+
+/** The subset of a SMRT `manifest.json` the codegen consumes. */
+export declare interface SmrtManifest {
+    version?: number | string;
+    packageName?: string;
+    objects: Record<string, SmrtManifestObject> | SmrtManifestObject[];
+}
+
+/**
+ * Shapes for the SMRT mobile contract pipeline:
+ * manifest.json (+ allowlist) → MobileContract → generated Kotlin/Swift DTOs.
+ */
+/** One field entry in a SMRT manifest's `objects[*].fields` map. */
+export declare interface SmrtManifestField {
+    type?: string;
+    required?: boolean;
+    related?: string;
+    /** Current SMRT manifests emit `default`; amaru-era manifests used `defaultValue`. */
+    default?: unknown;
+    defaultValue?: unknown;
+    _meta?: Record<string, unknown>;
+}
+
+/** One object entry in a SMRT manifest (model or collection). */
+export declare interface SmrtManifestObject {
+    name: string;
+    className?: string;
+    qualifiedName?: string;
+    collection?: string | null;
+    packageName?: string;
+    fields?: Record<string, SmrtManifestField>;
+    schema?: {
+        tableName?: string;
+    } | null;
+}
+
+/**
+ * Compares every entry against disk. Returns the list of missing/stale
+ * relative paths (empty = fresh).
+ */
+export declare function verifyFileSet(rootDir: string, files: Map<string, string>): string[];
+
+/** Writes every `relPath → content` entry under `rootDir`. */
+export declare function writeFileSet(rootDir: string, files: Map<string, string>): void;
+
+export { }

package/dist/index.js

@@ -0,0 +1,711 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/contract-version.ts
+var SMRT_MOBILE_CONTRACT_SCHEMA_VERSION = 1;
+var SMRT_MOBILE_CONTRACT_VERSION = "2026-07-01.v1";
+//#endregion
+//#region src/identifiers.ts
+var KOTLIN_HARD_KEYWORDS = /* @__PURE__ */ new Set([
+	"as",
+	"break",
+	"class",
+	"continue",
+	"do",
+	"else",
+	"false",
+	"for",
+	"fun",
+	"if",
+	"in",
+	"interface",
+	"is",
+	"null",
+	"object",
+	"package",
+	"return",
+	"super",
+	"this",
+	"throw",
+	"true",
+	"try",
+	"typealias",
+	"typeof",
+	"val",
+	"var",
+	"when",
+	"while"
+]);
+var SWIFT_KEYWORDS = /* @__PURE__ */ new Set([
+	"associatedtype",
+	"as",
+	"break",
+	"case",
+	"catch",
+	"class",
+	"continue",
+	"default",
+	"defer",
+	"deinit",
+	"do",
+	"else",
+	"enum",
+	"extension",
+	"fallthrough",
+	"false",
+	"fileprivate",
+	"for",
+	"func",
+	"guard",
+	"if",
+	"import",
+	"in",
+	"init",
+	"inout",
+	"internal",
+	"is",
+	"let",
+	"nil",
+	"open",
+	"operator",
+	"private",
+	"protocol",
+	"public",
+	"repeat",
+	"rethrows",
+	"return",
+	"self",
+	"static",
+	"struct",
+	"subscript",
+	"super",
+	"switch",
+	"throw",
+	"throws",
+	"true",
+	"try",
+	"typealias",
+	"var",
+	"where",
+	"while"
+]);
+var PLAIN_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function kotlinIdentifier(name) {
+	return KOTLIN_HARD_KEYWORDS.has(name) || !PLAIN_IDENTIFIER.test(name) ? `\`${name}\`` : name;
+}
+function swiftIdentifier(name) {
+	return SWIFT_KEYWORDS.has(name) || !PLAIN_IDENTIFIER.test(name) ? `\`${name}\`` : name;
+}
+function kotlinStringLiteral(value) {
+	let out = "\"";
+	for (const char of value) switch (char) {
+		case "\\":
+			out += "\\\\";
+			break;
+		case "\"":
+			out += "\\\"";
+			break;
+		case "$":
+			out += "\\$";
+			break;
+		case "\n":
+			out += "\\n";
+			break;
+		case "\r":
+			out += "\\r";
+			break;
+		case "	":
+			out += "\\t";
+			break;
+		default: {
+			const code = char.codePointAt(0) ?? 0;
+			out += code < 32 || code >= 55296 && code <= 57343 ? `\\u${code.toString(16).padStart(4, "0")}` : char;
+		}
+	}
+	return `${out}"`;
+}
+//#endregion
+//#region src/build-contract.ts
+var KOTLIN_TYPE_BY_MANIFEST_TYPE = {
+	id: "String",
+	text: "String",
+	status: "String",
+	foreignKey: "String",
+	crossPackageRef: "String",
+	integer: "Long",
+	decimal: "DecimalString?",
+	boolean: "Boolean",
+	datetime: "Instant?",
+	json: "JsonObject"
+};
+var RELATION_FIELD_TYPES = /* @__PURE__ */ new Set([
+	"oneToMany",
+	"manyToMany",
+	"hasMany"
+]);
+var SWIFT_TYPE_BY_KOTLIN_TYPE = {
+	String: "String",
+	Long: "Int64",
+	Boolean: "Bool",
+	"Instant?": "String?",
+	"DecimalString?": "String?",
+	JsonObject: "String",
+	"List<String>": "[String]"
+};
+var BOOLEAN_FIELD_NAMES = /* @__PURE__ */ new Set([
+	"required",
+	"safetyCritical",
+	"hasSafetyCriticalFallback"
+]);
+var INTEGER_FIELD_NAMES = /* @__PURE__ */ new Set([
+	"version",
+	"sortOrder",
+	"precision",
+	"pageStart",
+	"pageEnd",
+	"replayOrder",
+	"clientRevision",
+	"serverRevision"
+]);
+var STRING_LIST_FIELD_NAMES = /* @__PURE__ */ new Set([
+	"ruleIds",
+	"systemIds",
+	"supportedLocales",
+	"targetLocales",
+	"requestedLocales",
+	"includedLocales"
+]);
+function buildMobileContract(options) {
+	const { manifests, allowlist, kotlinPackage, sourceLabel = "" } = options;
+	const candidates = manifests.flatMap(listObjects);
+	const objects = [];
+	const seenQualifiedNames = /* @__PURE__ */ new Set();
+	for (const entry of allowlist) {
+		const matches = candidates.filter((object) => object.name === entry || object.qualifiedName === entry);
+		if (matches.length === 0) throw new Error(`mobile allowlist references missing object: ${entry}`);
+		if (matches.length > 1) {
+			const found = matches.map((match) => match.qualifiedName ?? match.name).join(", ");
+			throw new Error(`mobile allowlist entry "${entry}" is ambiguous (${found}) \u2014 use the qualified name`);
+		}
+		const qualifiedName = matches[0].qualifiedName ?? matches[0].name;
+		if (seenQualifiedNames.has(qualifiedName)) continue;
+		seenQualifiedNames.add(qualifiedName);
+		objects.push(toMobileObject(matches[0]));
+	}
+	const dtoNameOwners = /* @__PURE__ */ new Map();
+	for (const object of objects) {
+		const prior = dtoNameOwners.get(object.dtoName);
+		if (prior) throw new Error(`mobile allowlist produces duplicate DTO name "${object.dtoName}" (${prior} and ${object.qualifiedName}) \u2014 generated files would overwrite each other; allowlisted objects need unique short names`);
+		dtoNameOwners.set(object.dtoName, object.qualifiedName);
+	}
+	return {
+		schemaVersion: 1,
+		contractVersion: SMRT_MOBILE_CONTRACT_VERSION,
+		sourceLabel,
+		sourceHash: createHash("sha256").update(JSON.stringify({
+			allowlist,
+			objects
+		})).digest("hex"),
+		objectAllowlist: [...allowlist],
+		objectCount: objects.length,
+		kotlin: { packageName: kotlinPackage },
+		typeMappings: { ...KOTLIN_TYPE_BY_MANIFEST_TYPE },
+		objects
+	};
+}
+function listObjects(manifest) {
+	return Array.isArray(manifest.objects) ? manifest.objects : Object.values(manifest.objects);
+}
+function toMobileObject(object) {
+	const fieldEntries = Object.entries(object.fields ?? {});
+	const fields = [];
+	if (!fieldEntries.some(([name]) => name === "id")) fields.push({
+		name: "id",
+		kotlinType: "String",
+		swiftType: "String",
+		nullable: false,
+		kotlinDefault: null
+	});
+	for (const [name, meta] of fieldEntries) {
+		if (meta.type && RELATION_FIELD_TYPES.has(meta.type)) continue;
+		fields.push(mapField(name, meta));
+	}
+	return {
+		name: object.name,
+		qualifiedName: object.qualifiedName ?? object.name,
+		dtoName: `${object.name}Dto`,
+		tableName: object.schema?.tableName ?? null,
+		hasTenantId: fieldEntries.some(([name]) => name === "tenantId"),
+		fields
+	};
+}
+function mapField(name, meta) {
+	const kotlinType = kotlinTypeFor(name, meta);
+	return {
+		name,
+		kotlinType,
+		swiftType: SWIFT_TYPE_BY_KOTLIN_TYPE[kotlinType] ?? "String",
+		nullable: kotlinType.endsWith("?"),
+		kotlinDefault: name === "id" ? null : kotlinDefaultFor(kotlinType, meta)
+	};
+}
+function kotlinTypeFor(name, meta) {
+	if (name === "id") return "String";
+	if (meta.type && KOTLIN_TYPE_BY_MANIFEST_TYPE[meta.type]) return KOTLIN_TYPE_BY_MANIFEST_TYPE[meta.type];
+	if (STRING_LIST_FIELD_NAMES.has(name)) return "List<String>";
+	if (name.endsWith("Json")) return "JsonObject";
+	if (BOOLEAN_FIELD_NAMES.has(name)) return "Boolean";
+	if (INTEGER_FIELD_NAMES.has(name)) return "Long";
+	if (name.endsWith("At") || name.endsWith("On") || name.endsWith("_at")) return "Instant?";
+	return "String";
+}
+function kotlinDefaultFor(kotlinType, meta) {
+	const declared = meta.default !== void 0 ? meta.default : meta.defaultValue;
+	switch (kotlinType) {
+		case "JsonObject": return "JsonObject(emptyMap())";
+		case "List<String>": return "emptyList()";
+		case "Boolean": return declared === true || declared === "true" ? "true" : "false";
+		case "Long": return integerDefault(declared);
+		case "Instant?":
+		case "DecimalString?": return "null";
+		default: return stringDefault(declared);
+	}
+}
+function integerDefault(defaultValue) {
+	const parsed = Number(String(defaultValue ?? "").replace(/['"]/g, ""));
+	return Number.isFinite(parsed) && String(defaultValue ?? "").trim() !== "" ? String(Math.trunc(parsed)) : "0";
+}
+function stringDefault(defaultValue) {
+	if (defaultValue === void 0 || defaultValue === null || defaultValue === "null") return "\"\"";
+	const text = String(defaultValue).trim();
+	if (text === "") return "\"\"";
+	if (text.length > 1 && text.startsWith("\"") && text.endsWith("\"")) try {
+		const parsed = JSON.parse(text);
+		return typeof parsed === "string" ? kotlinStringLiteral(parsed) : "\"\"";
+	} catch {
+		return "\"\"";
+	}
+	const singleQuoted = text.match(/^'([^']*)'$/);
+	if (singleQuoted) return kotlinStringLiteral(singleQuoted[1]);
+	return kotlinStringLiteral(text);
+}
+//#endregion
+//#region src/emit-framework.ts
+var REGENERATE_COMMAND = "pnpm --filter @happyvertical/smrt-mobile-contract generate:framework";
+var HEADER = [
+	"// Generated by @happyvertical/smrt-mobile-contract (framework contract).",
+	`// Do not edit by hand \u2014 regenerate with \`${REGENERATE_COMMAND}\`.`,
+	""
+].join("\n");
+var SUPPORT_TYPES_KT = `${HEADER}
+package com.happyvertical.smrt.mobile.contract
+
+import kotlinx.serialization.Serializable
+
+/**
+ * Decimal values cross the wire as strings so no precision is lost between
+ * the server's DECIMAL columns and platform floating-point types.
+ */
+typealias DecimalString = String
+
+@Serializable
+data class Measurement(
+    val value: DecimalString,
+    val unit: String,
+    val source: String? = null,
+)
+`;
+var PACK_LOCALIZATION_KT = `${HEADER}
+package com.happyvertical.smrt.mobile.contract
+
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.JsonObject
+
+/**
+ * Locale policy for an offline pack: which locale was requested, which are
+ * included, and where lookups fall back when a translation is missing.
+ */
+@Serializable
+data class PackLanguage(
+    val defaultLocale: String = "en-US",
+    val requestedLocales: List<String> = emptyList(),
+    val includedLocales: List<String> = emptyList(),
+    val fallbackLocale: String = "en-US",
+    val policy: String = "",
+    val reviewState: String = "",
+    val hasSafetyCriticalFallback: Boolean = false,
+)
+
+/**
+ * Provenance of one localized string: where the text came from and whether the
+ * translation is reviewed, safety-critical, or a fallback.
+ */
+@Serializable
+data class PackTextSourceRef(
+    val sourceLocale: String = "",
+    val sourceDocumentId: String = "",
+    val sourceSectionId: String = "",
+    val sourceFactId: String = "",
+    val reviewState: String = "",
+    val safetyCritical: Boolean = false,
+    val fallbackReason: String = "",
+)
+
+/**
+ * One locale's bundle of localized strings for a pack, keyed by text key,
+ * with per-key source provenance.
+ */
+@Serializable
+data class PackLanguageBundle(
+    val locale: String = "",
+    val reviewState: String = "",
+    val textHash: String = "",
+    val strings: JsonObject = JsonObject(emptyMap()),
+    val sourceRefs: Map<String, PackTextSourceRef> = emptyMap(),
+    val hasSafetyCriticalFallback: Boolean = false,
+    val policy: String = "",
+)
+`;
+var MOBILE_AUTH_CONTRACT_KT = `${HEADER}
+package com.happyvertical.smrt.mobile.contract
+
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.JsonObject
+
+/**
+ * \`/api/mobile\` auth + session contract (server-brokered PKCE).
+ *
+ * The server owns the OIDC/PKCE exchange: \`auth/start\` returns the
+ * authorization URL plus the \`state\`/\`codeVerifier\` the client must persist
+ * and echo back on \`auth/complete\`. Reference implementation: anytown
+ * dashboard; SMRT-shipped handlers are tracked in issue #1748.
+ */
+
+@Serializable
+data class MobileUserSummary(
+    val id: String,
+    val email: String = "",
+    val label: String = "",
+)
+
+@Serializable
+data class MobileTenantSummary(
+    val id: String,
+    val name: String = "",
+    val slug: String = "",
+    val planName: String = "",
+    val subscriptionStatus: String = "",
+)
+
+@Serializable
+data class MobileTenantOption(
+    val id: String,
+    val name: String = "",
+    val slug: String = "",
+    val roleSlug: String = "",
+    val roleLabel: String = "",
+)
+
+@Serializable
+data class MobileAuthProviderSummary(
+    val id: String,
+    val label: String = "",
+    val type: String = "",
+    val supportsPkce: Boolean = false,
+)
+
+@Serializable
+data class MobileAuthStartRequest(
+    val providerId: String? = null,
+    val redirectUri: String,
+    val scopes: List<String> = emptyList(),
+    val state: String? = null,
+    val loginHint: String? = null,
+)
+
+@Serializable
+data class MobileAuthStartResponse(
+    val providerId: String,
+    val authorizationUrl: String,
+    val state: String,
+    val codeVerifier: String? = null,
+    val nonce: String? = null,
+    val redirectUri: String,
+)
+
+@Serializable
+data class MobileAuthCompleteRequest(
+    val providerId: String? = null,
+    val code: String,
+    val state: String? = null,
+    val codeVerifier: String? = null,
+    val redirectUri: String,
+)
+
+@Serializable
+data class MobileAuthSession(
+    val accessToken: String,
+    val tokenType: String = "Bearer",
+    val expiresAt: String = "",
+    val user: MobileUserSummary,
+    val activeTenant: MobileTenantOption? = null,
+    val tenants: List<MobileTenantOption> = emptyList(),
+)
+
+@Serializable
+data class MobileSessionBootstrap(
+    val user: MobileUserSummary,
+    val activeTenant: MobileTenantOption? = null,
+    val tenants: List<MobileTenantOption> = emptyList(),
+    val extras: JsonObject? = null,
+)
+`;
+var MOBILE_DEVICE_CONTRACT_KT = `${HEADER}
+package com.happyvertical.smrt.mobile.contract
+
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class MobileDevicePermissionState(
+    val status: String,
+    val canRequest: Boolean = false,
+    val reason: String? = null,
+)
+
+@Serializable
+data class MobileDeviceCapability(
+    val surface: String,
+    val label: String = "",
+    val supported: Boolean = false,
+    val permission: MobileDevicePermissionState,
+    val preferredInput: String = "",
+)
+
+@Serializable
+data class MobileDeviceCapabilities(
+    val camera: MobileDeviceCapability,
+    val microphone: MobileDeviceCapability,
+    val checkedAtEpochMillis: Long? = null,
+)
+`;
+var MOBILE_CONTRACT_INFO_KT = `${HEADER}
+package com.happyvertical.smrt.mobile.contract
+
+const val SMRT_MOBILE_CONTRACT_SCHEMA_VERSION: Int = 1
+const val SMRT_MOBILE_CONTRACT_VERSION: String = "${SMRT_MOBILE_CONTRACT_VERSION}"
+`;
+function frameworkKotlinFiles() {
+	return /* @__PURE__ */ new Map([
+		["SupportTypes.kt", SUPPORT_TYPES_KT],
+		["PackLocalization.kt", PACK_LOCALIZATION_KT],
+		["MobileAuthContract.kt", MOBILE_AUTH_CONTRACT_KT],
+		["MobileDeviceContract.kt", MOBILE_DEVICE_CONTRACT_KT],
+		["MobileContractInfo.kt", MOBILE_CONTRACT_INFO_KT]
+	]);
+}
+var MOBILE_CONTRACT_SWIFT = `// Generated by @happyvertical/smrt-mobile-contract (framework contract).
+// Do not edit by hand \u2014 regenerate with \`${REGENERATE_COMMAND}\`.
+import Foundation
+
+let SmrtMobileContractSchemaVersion = 1
+let SmrtMobileContractVersion = "${SMRT_MOBILE_CONTRACT_VERSION}"
+
+/// Decimal values cross the wire as strings (no precision loss).
+typealias DecimalString = String
+
+struct Measurement {
+  let value: DecimalString
+  let unit: String
+  let source: String?
+}
+
+struct MobileUserSummary {
+  let id: String
+  let email: String
+  let label: String
+}
+
+struct MobileTenantSummary {
+  let id: String
+  let name: String
+  let slug: String
+  let planName: String
+  let subscriptionStatus: String
+}
+
+struct MobileTenantOption {
+  let id: String
+  let name: String
+  let slug: String
+  let roleSlug: String
+  let roleLabel: String
+}
+
+struct MobileAuthProviderSummary {
+  let id: String
+  let label: String
+  let type: String
+  let supportsPkce: Bool
+}
+
+struct MobileAuthStartRequest {
+  let providerId: String?
+  let redirectUri: String
+  let scopes: [String]
+  let state: String?
+  let loginHint: String?
+}
+
+struct MobileAuthStartResponse {
+  let providerId: String
+  let authorizationUrl: String
+  let state: String
+  let codeVerifier: String?
+  let nonce: String?
+  let redirectUri: String
+}
+
+struct MobileAuthCompleteRequest {
+  let providerId: String?
+  let code: String
+  let state: String?
+  let codeVerifier: String?
+  let redirectUri: String
+}
+
+struct MobileAuthSession {
+  let accessToken: String
+  let tokenType: String
+  let expiresAt: String
+  let user: MobileUserSummary
+  let activeTenant: MobileTenantOption?
+  let tenants: [MobileTenantOption]
+}
+
+struct MobileSessionBootstrap {
+  let user: MobileUserSummary
+  let activeTenant: MobileTenantOption?
+  let tenants: [MobileTenantOption]
+  let extras: String?
+}
+
+struct MobileDevicePermissionState {
+  let status: String
+  let canRequest: Bool
+  let reason: String?
+}
+
+struct MobileDeviceCapability {
+  let surface: String
+  let label: String
+  let supported: Bool
+  let permission: MobileDevicePermissionState
+  let preferredInput: String
+}
+
+struct MobileDeviceCapabilities {
+  let camera: MobileDeviceCapability
+  let microphone: MobileDeviceCapability
+  let checkedAtEpochMillis: Int64?
+}
+`;
+function frameworkSwiftFiles() {
+	return /* @__PURE__ */ new Map([["MobileContract.swift", MOBILE_CONTRACT_SWIFT]]);
+}
+//#endregion
+//#region src/emit-kotlin.ts
+var GENERATED_HEADER = [
+	"// Generated by @happyvertical/smrt-mobile-contract.",
+	"// Do not edit by hand.",
+	""
+].join("\n");
+var FRAMEWORK_CONTRACT_PACKAGE = "com.happyvertical.smrt.mobile.contract";
+function generateKotlinDtoFiles(contract) {
+	const files = /* @__PURE__ */ new Map();
+	files.set("MobileContractManifest.kt", manifestFile(contract));
+	for (const object of contract.objects) files.set(`${object.dtoName}.kt`, dtoFile(contract, object));
+	return files;
+}
+function manifestFile(contract) {
+	return [
+		GENERATED_HEADER,
+		`package ${contract.kotlin.packageName}`,
+		"",
+		`const val MOBILE_CONTRACT_SCHEMA_VERSION: Int = ${contract.schemaVersion}`,
+		`const val MOBILE_CONTRACT_VERSION: String = "${contract.contractVersion}"`,
+		`const val MOBILE_CONTRACT_SOURCE_HASH: String = "${contract.sourceHash}"`,
+		"",
+		"val MOBILE_CONTRACT_OBJECTS: List<String> = listOf(",
+		...contract.objects.map((object) => `    "${object.name}",`),
+		")",
+		""
+	].join("\n");
+}
+function dtoFile(contract, object) {
+	const imports = /* @__PURE__ */ new Set(["kotlinx.serialization.Serializable"]);
+	for (const field of object.fields) {
+		if (field.kotlinType.includes("Instant")) imports.add("kotlinx.datetime.Instant");
+		if (field.kotlinType.includes("JsonObject")) imports.add("kotlinx.serialization.json.JsonObject");
+		if (field.kotlinType.includes("DecimalString")) imports.add(`${FRAMEWORK_CONTRACT_PACKAGE}.DecimalString`);
+	}
+	return [
+		GENERATED_HEADER,
+		`package ${contract.kotlin.packageName}`,
+		"",
+		...[...imports].sort().map((importPath) => `import ${importPath}`),
+		"",
+		"@Serializable",
+		`data class ${object.dtoName}(`,
+		...object.fields.map((field) => kotlinProperty(field)),
+		")",
+		""
+	].join("\n");
+}
+function kotlinProperty(field) {
+	const defaultValue = field.kotlinDefault === null ? "" : ` = ${field.kotlinDefault}`;
+	return `    val ${kotlinIdentifier(field.name)}: ${field.kotlinType}${defaultValue},`;
+}
+//#endregion
+//#region src/emit-swift.ts
+function generateSwiftDtoFile(contract) {
+	const lines = [
+		"// Generated by @happyvertical/smrt-mobile-contract.",
+		"// Do not edit by hand.",
+		"import Foundation",
+		"",
+		`let MobileContractSchemaVersion = ${contract.schemaVersion}`,
+		`let MobileContractVersion = "${contract.contractVersion}"`,
+		`let MobileContractSourceHash = "${contract.sourceHash}"`,
+		""
+	];
+	for (const object of contract.objects) {
+		lines.push(`struct ${object.dtoName} {`);
+		for (const field of object.fields) lines.push(`  let ${swiftIdentifier(field.name)}: ${swiftType(field)}`);
+		lines.push("}", "");
+	}
+	return lines.join("\n");
+}
+function swiftType(field) {
+	return field.swiftType;
+}
+//#endregion
+//#region src/file-set.ts
+function writeFileSet(rootDir, files) {
+	for (const [relPath, content] of files) {
+		const absPath = join(rootDir, relPath);
+		mkdirSync(dirname(absPath), { recursive: true });
+		writeFileSync(absPath, content);
+	}
+}
+function verifyFileSet(rootDir, files) {
+	const stale = [];
+	for (const [relPath, content] of files) {
+		const absPath = join(rootDir, relPath);
+		if (!existsSync(absPath) || readFileSync(absPath, "utf8") !== content) stale.push(relPath);
+	}
+	return stale;
+}
+//#endregion
+export { GENERATED_HEADER, SMRT_MOBILE_CONTRACT_SCHEMA_VERSION, SMRT_MOBILE_CONTRACT_VERSION, buildMobileContract, frameworkKotlinFiles, frameworkSwiftFiles, generateKotlinDtoFiles, generateSwiftDtoFile, verifyFileSet, writeFileSet };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/contract-version.ts","../src/identifiers.ts","../src/build-contract.ts","../src/emit-framework.ts","../src/emit-kotlin.ts","../src/emit-swift.ts","../src/file-set.ts"],"sourcesContent":["/** Schema version of the mobile-contract.json envelope. */\nexport const SMRT_MOBILE_CONTRACT_SCHEMA_VERSION = 1;\n\n/**\n * Version stamp of the framework contract surface (auth/session/device/pack\n * localization types). Bump when the framework contract shape changes.\n */\nexport const SMRT_MOBILE_CONTRACT_VERSION = '2026-07-01.v1';\n","/**\n * Identifier + literal escaping for generated Kotlin/Swift source. Manifest\n * field names are valid JS identifiers, but may collide with Kotlin/Swift\n * keywords; string defaults may contain characters that Kotlin string\n * templates or escapes treat specially.\n */\n\nconst KOTLIN_HARD_KEYWORDS = new Set([\n  'as',\n  'break',\n  'class',\n  'continue',\n  'do',\n  'else',\n  'false',\n  'for',\n  'fun',\n  'if',\n  'in',\n  'interface',\n  'is',\n  'null',\n  'object',\n  'package',\n  'return',\n  'super',\n  'this',\n  'throw',\n  'true',\n  'try',\n  'typealias',\n  'typeof',\n  'val',\n  'var',\n  'when',\n  'while',\n]);\n\nconst SWIFT_KEYWORDS = new Set([\n  'associatedtype',\n  'as',\n  'break',\n  'case',\n  'catch',\n  'class',\n  'continue',\n  'default',\n  'defer',\n  'deinit',\n  'do',\n  'else',\n  'enum',\n  'extension',\n  'fallthrough',\n  'false',\n  'fileprivate',\n  'for',\n  'func',\n  'guard',\n  'if',\n  'import',\n  'in',\n  'init',\n  'inout',\n  'internal',\n  'is',\n  'let',\n  'nil',\n  'open',\n  'operator',\n  'private',\n  'protocol',\n  'public',\n  'repeat',\n  'rethrows',\n  'return',\n  'self',\n  'static',\n  'struct',\n  'subscript',\n  'super',\n  'switch',\n  'throw',\n  'throws',\n  'true',\n  'try',\n  'typealias',\n  'var',\n  'where',\n  'while',\n]);\n\nconst PLAIN_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Backtick-escapes Kotlin hard keywords (and non-plain identifiers). */\nexport function kotlinIdentifier(name: string): string {\n  return KOTLIN_HARD_KEYWORDS.has(name) || !PLAIN_IDENTIFIER.test(name)\n    ? `\\`${name}\\``\n    : name;\n}\n\n/** Backtick-escapes Swift keywords (and non-plain identifiers). */\nexport function swiftIdentifier(name: string): string {\n  return SWIFT_KEYWORDS.has(name) || !PLAIN_IDENTIFIER.test(name)\n    ? `\\`${name}\\``\n    : name;\n}\n\n/**\n * Emits a Kotlin double-quoted string literal. Escapes `$` (string-template\n * interpolation), quotes, backslashes, and control characters — JSON escaping\n * is NOT Kotlin-safe (`$` stays raw and `\\f` is not a Kotlin escape).\n */\nexport function kotlinStringLiteral(value: string): string {\n  let out = '\"';\n  for (const char of value) {\n    switch (char) {\n      case '\\\\':\n        out += '\\\\\\\\';\n        break;\n      case '\"':\n        out += '\\\\\"';\n        break;\n      case '$':\n        out += '\\\\$';\n        break;\n      case '\\n':\n        out += '\\\\n';\n        break;\n      case '\\r':\n        out += '\\\\r';\n        break;\n      case '\\t':\n        out += '\\\\t';\n        break;\n      default: {\n        const code = char.codePointAt(0) ?? 0;\n        // Control chars and lone surrogates must be \\u-escaped: a raw lone\n        // surrogate would be written to disk as U+FFFD, silently corrupting\n        // the literal.\n        out +=\n          code < 0x20 || (code >= 0xd800 && code <= 0xdfff)\n            ? `\\\\u${code.toString(16).padStart(4, '0')}`\n            : char;\n      }\n    }\n  }\n  return `${out}\"`;\n}\n","import { createHash } from 'node:crypto';\nimport {\n  SMRT_MOBILE_CONTRACT_SCHEMA_VERSION,\n  SMRT_MOBILE_CONTRACT_VERSION,\n} from './contract-version.js';\nimport { kotlinStringLiteral } from './identifiers.js';\nimport type {\n  MobileContract,\n  MobileContractField,\n  MobileContractObject,\n  MobileContractOptions,\n  SmrtManifestField,\n  SmrtManifestObject,\n} from './types.js';\n\n/**\n * SMRT manifest field type → Kotlin type. Decimals cross the wire as\n * `DecimalString` (string-encoded, no float precision loss); timestamps as\n * nullable `Instant`; JSON payloads as `JsonObject`.\n */\nconst KOTLIN_TYPE_BY_MANIFEST_TYPE: Record<string, string> = {\n  id: 'String',\n  text: 'String',\n  status: 'String',\n  foreignKey: 'String',\n  crossPackageRef: 'String',\n  // 64-bit: SMRT INTEGER columns hold values like byte sizes and epoch\n  // millis that overflow a 32-bit Int at decode time.\n  integer: 'Long',\n  decimal: 'DecimalString?',\n  boolean: 'Boolean',\n  datetime: 'Instant?',\n  json: 'JsonObject',\n};\n\n/**\n * Relationship declarations, not scalar columns — an object row's wire\n * payload does not carry them, so they are excluded from DTO projection.\n */\nconst RELATION_FIELD_TYPES = new Set(['oneToMany', 'manyToMany', 'hasMany']);\n\nconst SWIFT_TYPE_BY_KOTLIN_TYPE: Record<string, string> = {\n  String: 'String',\n  // Explicit Int64: Swift Int is 32-bit on watchOS arm64_32/armv7k, and the\n  // whole point of Long is byte-size/epoch values that overflow 32 bits.\n  Long: 'Int64',\n  Boolean: 'Bool',\n  'Instant?': 'String?',\n  'DecimalString?': 'String?',\n  // Raw JSON string on the Swift side — Swift DTOs are plain structs (no\n  // Codable) per the reporter seed; apps parse as needed.\n  JsonObject: 'String',\n  'List<String>': '[String]',\n};\n\n/** Name-based fallbacks for manifest fields that carry no `type`. */\nconst BOOLEAN_FIELD_NAMES = new Set([\n  'required',\n  'safetyCritical',\n  'hasSafetyCriticalFallback',\n]);\nconst INTEGER_FIELD_NAMES = new Set([\n  'version',\n  'sortOrder',\n  'precision',\n  'pageStart',\n  'pageEnd',\n  'replayOrder',\n  'clientRevision',\n  'serverRevision',\n]);\nconst STRING_LIST_FIELD_NAMES = new Set([\n  'ruleIds',\n  'systemIds',\n  'supportedLocales',\n  'targetLocales',\n  'requestedLocales',\n  'includedLocales',\n]);\n\nexport function buildMobileContract(\n  options: MobileContractOptions,\n): MobileContract {\n  const { manifests, allowlist, kotlinPackage, sourceLabel = '' } = options;\n  const candidates = manifests.flatMap(listObjects);\n\n  const objects: MobileContractObject[] = [];\n  const seenQualifiedNames = new Set<string>();\n  for (const entry of allowlist) {\n    const matches = candidates.filter(\n      (object) => object.name === entry || object.qualifiedName === entry,\n    );\n    if (matches.length === 0) {\n      throw new Error(`mobile allowlist references missing object: ${entry}`);\n    }\n    if (matches.length > 1) {\n      const found = matches\n        .map((match) => match.qualifiedName ?? match.name)\n        .join(', ');\n      throw new Error(\n        `mobile allowlist entry \"${entry}\" is ambiguous (${found}) — use the qualified name`,\n      );\n    }\n    const qualifiedName = matches[0].qualifiedName ?? matches[0].name;\n    if (seenQualifiedNames.has(qualifiedName)) {\n      // The same object listed under two spellings (short + qualified) is\n      // redundant, not a collision — project it once.\n      continue;\n    }\n    seenQualifiedNames.add(qualifiedName);\n    objects.push(toMobileObject(matches[0]));\n  }\n\n  const dtoNameOwners = new Map<string, string>();\n  for (const object of objects) {\n    const prior = dtoNameOwners.get(object.dtoName);\n    if (prior) {\n      throw new Error(\n        `mobile allowlist produces duplicate DTO name \"${object.dtoName}\" ` +\n          `(${prior} and ${object.qualifiedName}) — generated files would ` +\n          'overwrite each other; allowlisted objects need unique short names',\n      );\n    }\n    dtoNameOwners.set(object.dtoName, object.qualifiedName);\n  }\n\n  const sourceHash = createHash('sha256')\n    .update(JSON.stringify({ allowlist, objects }))\n    .digest('hex');\n\n  return {\n    schemaVersion: SMRT_MOBILE_CONTRACT_SCHEMA_VERSION,\n    contractVersion: SMRT_MOBILE_CONTRACT_VERSION,\n    sourceLabel,\n    sourceHash,\n    objectAllowlist: [...allowlist],\n    objectCount: objects.length,\n    kotlin: { packageName: kotlinPackage },\n    typeMappings: { ...KOTLIN_TYPE_BY_MANIFEST_TYPE },\n    objects,\n  };\n}\n\nfunction listObjects(manifest: {\n  objects: Record<string, SmrtManifestObject> | SmrtManifestObject[];\n}): SmrtManifestObject[] {\n  return Array.isArray(manifest.objects)\n    ? manifest.objects\n    : Object.values(manifest.objects);\n}\n\nfunction toMobileObject(object: SmrtManifestObject): MobileContractObject {\n  const fieldEntries = Object.entries(object.fields ?? {});\n  const fields: MobileContractField[] = [];\n\n  if (!fieldEntries.some(([name]) => name === 'id')) {\n    fields.push({\n      name: 'id',\n      kotlinType: 'String',\n      swiftType: 'String',\n      nullable: false,\n      kotlinDefault: null,\n    });\n  }\n\n  for (const [name, meta] of fieldEntries) {\n    if (meta.type && RELATION_FIELD_TYPES.has(meta.type)) {\n      continue;\n    }\n    fields.push(mapField(name, meta));\n  }\n\n  return {\n    name: object.name,\n    qualifiedName: object.qualifiedName ?? object.name,\n    dtoName: `${object.name}Dto`,\n    tableName: object.schema?.tableName ?? null,\n    hasTenantId: fieldEntries.some(([name]) => name === 'tenantId'),\n    fields,\n  };\n}\n\nfunction mapField(name: string, meta: SmrtManifestField): MobileContractField {\n  const kotlinType = kotlinTypeFor(name, meta);\n  return {\n    name,\n    kotlinType,\n    swiftType: SWIFT_TYPE_BY_KOTLIN_TYPE[kotlinType] ?? 'String',\n    nullable: kotlinType.endsWith('?'),\n    kotlinDefault: name === 'id' ? null : kotlinDefaultFor(kotlinType, meta),\n  };\n}\n\nfunction kotlinTypeFor(name: string, meta: SmrtManifestField): string {\n  if (name === 'id') return 'String';\n  if (meta.type && KOTLIN_TYPE_BY_MANIFEST_TYPE[meta.type]) {\n    return KOTLIN_TYPE_BY_MANIFEST_TYPE[meta.type];\n  }\n  // Typeless manifest entries: fall back to the name heuristics the amaru\n  // seed codegen used.\n  if (STRING_LIST_FIELD_NAMES.has(name)) return 'List<String>';\n  if (name.endsWith('Json')) return 'JsonObject';\n  if (BOOLEAN_FIELD_NAMES.has(name)) return 'Boolean';\n  if (INTEGER_FIELD_NAMES.has(name)) return 'Long';\n  if (name.endsWith('At') || name.endsWith('On') || name.endsWith('_at'))\n    return 'Instant?';\n  return 'String';\n}\n\nfunction kotlinDefaultFor(kotlinType: string, meta: SmrtManifestField): string {\n  // Current SMRT manifests carry the typed value in `default`; amaru-era\n  // manifests carried a (possibly quoted) string in `defaultValue`.\n  const declared =\n    meta.default !== undefined ? meta.default : meta.defaultValue;\n  switch (kotlinType) {\n    case 'JsonObject':\n      return 'JsonObject(emptyMap())';\n    case 'List<String>':\n      return 'emptyList()';\n    case 'Boolean':\n      return declared === true || declared === 'true' ? 'true' : 'false';\n    case 'Long':\n      return integerDefault(declared);\n    case 'Instant?':\n    case 'DecimalString?':\n      return 'null';\n    default:\n      return stringDefault(declared);\n  }\n}\n\nfunction integerDefault(defaultValue: unknown): string {\n  const parsed = Number(String(defaultValue ?? '').replace(/['\"]/g, ''));\n  return Number.isFinite(parsed) && String(defaultValue ?? '').trim() !== ''\n    ? String(Math.trunc(parsed))\n    : '0';\n}\n\nfunction stringDefault(defaultValue: unknown): string {\n  if (\n    defaultValue === undefined ||\n    defaultValue === null ||\n    defaultValue === 'null'\n  ) {\n    return '\"\"';\n  }\n\n  const text = String(defaultValue).trim();\n  if (text === '') {\n    return '\"\"';\n  }\n  if (text.length > 1 && text.startsWith('\"') && text.endsWith('\"')) {\n    try {\n      const parsed: unknown = JSON.parse(text);\n      return typeof parsed === 'string' ? kotlinStringLiteral(parsed) : '\"\"';\n    } catch {\n      return '\"\"';\n    }\n  }\n\n  const singleQuoted = text.match(/^'([^']*)'$/);\n  if (singleQuoted) {\n    return kotlinStringLiteral(singleQuoted[1]);\n  }\n\n  // A raw (unquoted) string value — the shape current SMRT manifests emit.\n  return kotlinStringLiteral(text);\n}\n","import {\n  SMRT_MOBILE_CONTRACT_SCHEMA_VERSION,\n  SMRT_MOBILE_CONTRACT_VERSION,\n} from './contract-version.js';\n\n/**\n * The generated *framework* contract: the stable files checked into\n * `@happyvertical/smrt-mobile` under\n * `src/commonMain/kotlin/com/happyvertical/smrt/mobile/contract/`.\n * This module is their single source of truth — `pnpm generate:framework`\n * rewrites them; the package build verifies freshness.\n */\n\n// One source for the regenerate command in every emitted header — the script\n// is deliberately named generate:framework (a plain `generate` script would\n// be auto-run by turbo's build task and neutralize the freshness gate).\nconst REGENERATE_COMMAND =\n  'pnpm --filter @happyvertical/smrt-mobile-contract generate:framework';\n\nconst HEADER = [\n  '// Generated by @happyvertical/smrt-mobile-contract (framework contract).',\n  `// Do not edit by hand — regenerate with \\`${REGENERATE_COMMAND}\\`.`,\n  '',\n].join('\\n');\n\nconst SUPPORT_TYPES_KT = `${HEADER}\npackage com.happyvertical.smrt.mobile.contract\n\nimport kotlinx.serialization.Serializable\n\n/**\n * Decimal values cross the wire as strings so no precision is lost between\n * the server's DECIMAL columns and platform floating-point types.\n */\ntypealias DecimalString = String\n\n@Serializable\ndata class Measurement(\n    val value: DecimalString,\n    val unit: String,\n    val source: String? = null,\n)\n`;\n\nconst PACK_LOCALIZATION_KT = `${HEADER}\npackage com.happyvertical.smrt.mobile.contract\n\nimport kotlinx.serialization.Serializable\nimport kotlinx.serialization.json.JsonObject\n\n/**\n * Locale policy for an offline pack: which locale was requested, which are\n * included, and where lookups fall back when a translation is missing.\n */\n@Serializable\ndata class PackLanguage(\n    val defaultLocale: String = \"en-US\",\n    val requestedLocales: List<String> = emptyList(),\n    val includedLocales: List<String> = emptyList(),\n    val fallbackLocale: String = \"en-US\",\n    val policy: String = \"\",\n    val reviewState: String = \"\",\n    val hasSafetyCriticalFallback: Boolean = false,\n)\n\n/**\n * Provenance of one localized string: where the text came from and whether the\n * translation is reviewed, safety-critical, or a fallback.\n */\n@Serializable\ndata class PackTextSourceRef(\n    val sourceLocale: String = \"\",\n    val sourceDocumentId: String = \"\",\n    val sourceSectionId: String = \"\",\n    val sourceFactId: String = \"\",\n    val reviewState: String = \"\",\n    val safetyCritical: Boolean = false,\n    val fallbackReason: String = \"\",\n)\n\n/**\n * One locale's bundle of localized strings for a pack, keyed by text key,\n * with per-key source provenance.\n */\n@Serializable\ndata class PackLanguageBundle(\n    val locale: String = \"\",\n    val reviewState: String = \"\",\n    val textHash: String = \"\",\n    val strings: JsonObject = JsonObject(emptyMap()),\n    val sourceRefs: Map<String, PackTextSourceRef> = emptyMap(),\n    val hasSafetyCriticalFallback: Boolean = false,\n    val policy: String = \"\",\n)\n`;\n\nconst MOBILE_AUTH_CONTRACT_KT = `${HEADER}\npackage com.happyvertical.smrt.mobile.contract\n\nimport kotlinx.serialization.Serializable\nimport kotlinx.serialization.json.JsonObject\n\n/**\n * \\`/api/mobile\\` auth + session contract (server-brokered PKCE).\n *\n * The server owns the OIDC/PKCE exchange: \\`auth/start\\` returns the\n * authorization URL plus the \\`state\\`/\\`codeVerifier\\` the client must persist\n * and echo back on \\`auth/complete\\`. Reference implementation: anytown\n * dashboard; SMRT-shipped handlers are tracked in issue #1748.\n */\n\n@Serializable\ndata class MobileUserSummary(\n    val id: String,\n    val email: String = \"\",\n    val label: String = \"\",\n)\n\n@Serializable\ndata class MobileTenantSummary(\n    val id: String,\n    val name: String = \"\",\n    val slug: String = \"\",\n    val planName: String = \"\",\n    val subscriptionStatus: String = \"\",\n)\n\n@Serializable\ndata class MobileTenantOption(\n    val id: String,\n    val name: String = \"\",\n    val slug: String = \"\",\n    val roleSlug: String = \"\",\n    val roleLabel: String = \"\",\n)\n\n@Serializable\ndata class MobileAuthProviderSummary(\n    val id: String,\n    val label: String = \"\",\n    val type: String = \"\",\n    val supportsPkce: Boolean = false,\n)\n\n@Serializable\ndata class MobileAuthStartRequest(\n    val providerId: String? = null,\n    val redirectUri: String,\n    val scopes: List<String> = emptyList(),\n    val state: String? = null,\n    val loginHint: String? = null,\n)\n\n@Serializable\ndata class MobileAuthStartResponse(\n    val providerId: String,\n    val authorizationUrl: String,\n    val state: String,\n    val codeVerifier: String? = null,\n    val nonce: String? = null,\n    val redirectUri: String,\n)\n\n@Serializable\ndata class MobileAuthCompleteRequest(\n    val providerId: String? = null,\n    val code: String,\n    val state: String? = null,\n    val codeVerifier: String? = null,\n    val redirectUri: String,\n)\n\n@Serializable\ndata class MobileAuthSession(\n    val accessToken: String,\n    val tokenType: String = \"Bearer\",\n    val expiresAt: String = \"\",\n    val user: MobileUserSummary,\n    val activeTenant: MobileTenantOption? = null,\n    val tenants: List<MobileTenantOption> = emptyList(),\n)\n\n@Serializable\ndata class MobileSessionBootstrap(\n    val user: MobileUserSummary,\n    val activeTenant: MobileTenantOption? = null,\n    val tenants: List<MobileTenantOption> = emptyList(),\n    val extras: JsonObject? = null,\n)\n`;\n\nconst MOBILE_DEVICE_CONTRACT_KT = `${HEADER}\npackage com.happyvertical.smrt.mobile.contract\n\nimport kotlinx.serialization.Serializable\n\n@Serializable\ndata class MobileDevicePermissionState(\n    val status: String,\n    val canRequest: Boolean = false,\n    val reason: String? = null,\n)\n\n@Serializable\ndata class MobileDeviceCapability(\n    val surface: String,\n    val label: String = \"\",\n    val supported: Boolean = false,\n    val permission: MobileDevicePermissionState,\n    val preferredInput: String = \"\",\n)\n\n@Serializable\ndata class MobileDeviceCapabilities(\n    val camera: MobileDeviceCapability,\n    val microphone: MobileDeviceCapability,\n    val checkedAtEpochMillis: Long? = null,\n)\n`;\n\nconst MOBILE_CONTRACT_INFO_KT = `${HEADER}\npackage com.happyvertical.smrt.mobile.contract\n\nconst val SMRT_MOBILE_CONTRACT_SCHEMA_VERSION: Int = ${SMRT_MOBILE_CONTRACT_SCHEMA_VERSION}\nconst val SMRT_MOBILE_CONTRACT_VERSION: String = \"${SMRT_MOBILE_CONTRACT_VERSION}\"\n`;\n\n/** Kotlin framework contract files, keyed by file name. */\nexport function frameworkKotlinFiles(): Map<string, string> {\n  return new Map([\n    ['SupportTypes.kt', SUPPORT_TYPES_KT],\n    ['PackLocalization.kt', PACK_LOCALIZATION_KT],\n    ['MobileAuthContract.kt', MOBILE_AUTH_CONTRACT_KT],\n    ['MobileDeviceContract.kt', MOBILE_DEVICE_CONTRACT_KT],\n    ['MobileContractInfo.kt', MOBILE_CONTRACT_INFO_KT],\n  ]);\n}\n\nconst MOBILE_CONTRACT_SWIFT = `// Generated by @happyvertical/smrt-mobile-contract (framework contract).\n// Do not edit by hand — regenerate with \\`${REGENERATE_COMMAND}\\`.\nimport Foundation\n\nlet SmrtMobileContractSchemaVersion = ${SMRT_MOBILE_CONTRACT_SCHEMA_VERSION}\nlet SmrtMobileContractVersion = \"${SMRT_MOBILE_CONTRACT_VERSION}\"\n\n/// Decimal values cross the wire as strings (no precision loss).\ntypealias DecimalString = String\n\nstruct Measurement {\n  let value: DecimalString\n  let unit: String\n  let source: String?\n}\n\nstruct MobileUserSummary {\n  let id: String\n  let email: String\n  let label: String\n}\n\nstruct MobileTenantSummary {\n  let id: String\n  let name: String\n  let slug: String\n  let planName: String\n  let subscriptionStatus: String\n}\n\nstruct MobileTenantOption {\n  let id: String\n  let name: String\n  let slug: String\n  let roleSlug: String\n  let roleLabel: String\n}\n\nstruct MobileAuthProviderSummary {\n  let id: String\n  let label: String\n  let type: String\n  let supportsPkce: Bool\n}\n\nstruct MobileAuthStartRequest {\n  let providerId: String?\n  let redirectUri: String\n  let scopes: [String]\n  let state: String?\n  let loginHint: String?\n}\n\nstruct MobileAuthStartResponse {\n  let providerId: String\n  let authorizationUrl: String\n  let state: String\n  let codeVerifier: String?\n  let nonce: String?\n  let redirectUri: String\n}\n\nstruct MobileAuthCompleteRequest {\n  let providerId: String?\n  let code: String\n  let state: String?\n  let codeVerifier: String?\n  let redirectUri: String\n}\n\nstruct MobileAuthSession {\n  let accessToken: String\n  let tokenType: String\n  let expiresAt: String\n  let user: MobileUserSummary\n  let activeTenant: MobileTenantOption?\n  let tenants: [MobileTenantOption]\n}\n\nstruct MobileSessionBootstrap {\n  let user: MobileUserSummary\n  let activeTenant: MobileTenantOption?\n  let tenants: [MobileTenantOption]\n  let extras: String?\n}\n\nstruct MobileDevicePermissionState {\n  let status: String\n  let canRequest: Bool\n  let reason: String?\n}\n\nstruct MobileDeviceCapability {\n  let surface: String\n  let label: String\n  let supported: Bool\n  let permission: MobileDevicePermissionState\n  let preferredInput: String\n}\n\nstruct MobileDeviceCapabilities {\n  let camera: MobileDeviceCapability\n  let microphone: MobileDeviceCapability\n  let checkedAtEpochMillis: Int64?\n}\n`;\n\n/**\n * Swift mirror of the framework contract for SwiftUI apps (reporter\n * precedent). Not checked into smrt-mobile — iOS wiring lands with\n * smrt-ios (Phase 6); apps can emit it via this API meanwhile.\n */\nexport function frameworkSwiftFiles(): Map<string, string> {\n  return new Map([['MobileContract.swift', MOBILE_CONTRACT_SWIFT]]);\n}\n","import { kotlinIdentifier } from './identifiers.js';\nimport type {\n  MobileContract,\n  MobileContractField,\n  MobileContractObject,\n} from './types.js';\n\nexport const GENERATED_HEADER = [\n  '// Generated by @happyvertical/smrt-mobile-contract.',\n  '// Do not edit by hand.',\n  '',\n].join('\\n');\n\nconst FRAMEWORK_CONTRACT_PACKAGE = 'com.happyvertical.smrt.mobile.contract';\n\n/**\n * Emits one Kotlin DTO file per allowlisted object, plus a\n * `MobileContractManifest.kt` recording the contract identity, all in the\n * consumer's Kotlin package. Framework support types (DecimalString, …) are\n * imported from `com.happyvertical.smrt.mobile.contract`.\n */\nexport function generateKotlinDtoFiles(\n  contract: MobileContract,\n): Map<string, string> {\n  const files = new Map<string, string>();\n\n  files.set('MobileContractManifest.kt', manifestFile(contract));\n  for (const object of contract.objects) {\n    files.set(`${object.dtoName}.kt`, dtoFile(contract, object));\n  }\n\n  return files;\n}\n\nfunction manifestFile(contract: MobileContract): string {\n  return [\n    GENERATED_HEADER,\n    `package ${contract.kotlin.packageName}`,\n    '',\n    `const val MOBILE_CONTRACT_SCHEMA_VERSION: Int = ${contract.schemaVersion}`,\n    `const val MOBILE_CONTRACT_VERSION: String = \"${contract.contractVersion}\"`,\n    `const val MOBILE_CONTRACT_SOURCE_HASH: String = \"${contract.sourceHash}\"`,\n    '',\n    'val MOBILE_CONTRACT_OBJECTS: List<String> = listOf(',\n    ...contract.objects.map((object) => `    \"${object.name}\",`),\n    ')',\n    '',\n  ].join('\\n');\n}\n\nfunction dtoFile(\n  contract: MobileContract,\n  object: MobileContractObject,\n): string {\n  const imports = new Set(['kotlinx.serialization.Serializable']);\n  for (const field of object.fields) {\n    if (field.kotlinType.includes('Instant')) {\n      imports.add('kotlinx.datetime.Instant');\n    }\n    if (field.kotlinType.includes('JsonObject')) {\n      imports.add('kotlinx.serialization.json.JsonObject');\n    }\n    if (field.kotlinType.includes('DecimalString')) {\n      imports.add(`${FRAMEWORK_CONTRACT_PACKAGE}.DecimalString`);\n    }\n  }\n\n  return [\n    GENERATED_HEADER,\n    `package ${contract.kotlin.packageName}`,\n    '',\n    ...[...imports].sort().map((importPath) => `import ${importPath}`),\n    '',\n    '@Serializable',\n    `data class ${object.dtoName}(`,\n    ...object.fields.map((field) => kotlinProperty(field)),\n    ')',\n    '',\n  ].join('\\n');\n}\n\nfunction kotlinProperty(field: MobileContractField): string {\n  const defaultValue =\n    field.kotlinDefault === null ? '' : ` = ${field.kotlinDefault}`;\n  return `    val ${kotlinIdentifier(field.name)}: ${field.kotlinType}${defaultValue},`;\n}\n","import { swiftIdentifier } from './identifiers.js';\nimport type { MobileContract, MobileContractField } from './types.js';\n\n/**\n * Emits all allowlisted domain DTOs into a single Swift file. Structs are\n * plain (no Codable) per the reporter seed — apps decode JSON as needed.\n * Kotlin `JsonObject` fields arrive as raw JSON strings on the Swift side.\n */\nexport function generateSwiftDtoFile(contract: MobileContract): string {\n  const lines: string[] = [\n    '// Generated by @happyvertical/smrt-mobile-contract.',\n    '// Do not edit by hand.',\n    'import Foundation',\n    '',\n    `let MobileContractSchemaVersion = ${contract.schemaVersion}`,\n    `let MobileContractVersion = \"${contract.contractVersion}\"`,\n    `let MobileContractSourceHash = \"${contract.sourceHash}\"`,\n    '',\n  ];\n\n  for (const object of contract.objects) {\n    lines.push(`struct ${object.dtoName} {`);\n    for (const field of object.fields) {\n      lines.push(`  let ${swiftIdentifier(field.name)}: ${swiftType(field)}`);\n    }\n    lines.push('}', '');\n  }\n\n  return lines.join('\\n');\n}\n\nfunction swiftType(field: MobileContractField): string {\n  return field.swiftType;\n}\n","import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\n/** Writes every `relPath → content` entry under `rootDir`. */\nexport function writeFileSet(\n  rootDir: string,\n  files: Map<string, string>,\n): void {\n  for (const [relPath, content] of files) {\n    const absPath = join(rootDir, relPath);\n    mkdirSync(dirname(absPath), { recursive: true });\n    writeFileSync(absPath, content);\n  }\n}\n\n/**\n * Compares every entry against disk. Returns the list of missing/stale\n * relative paths (empty = fresh).\n */\nexport function verifyFileSet(\n  rootDir: string,\n  files: Map<string, string>,\n): string[] {\n  const stale: string[] = [];\n  for (const [relPath, content] of files) {\n    const absPath = join(rootDir, relPath);\n    if (!existsSync(absPath) || readFileSync(absPath, 'utf8') !== content) {\n      stale.push(relPath);\n    }\n  }\n  return stale;\n}\n"],"mappings":";;;;AACO,IAAM,sCAAsC;AAM5C,IAAM,+BAA+B;;;ACA5C,IAAM,uCAAuB,IAAI,IAAI;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,IAAM,iCAAiB,IAAI,IAAI;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,IAAM,mBAAmB;AAGlB,SAAS,iBAAiB,MAAsB;CACrD,OAAO,qBAAqB,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI,IAChE,KAAK,KAAI,MACT;AACN;AAGO,SAAS,gBAAgB,MAAsB;CACpD,OAAO,eAAe,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI,IAC1D,KAAK,KAAI,MACT;AACN;AAOO,SAAS,oBAAoB,OAAuB;CACzD,IAAI,MAAM;CACV,KAAA,MAAW,QAAQ,OACjB,QAAQ,MAAR;EACE,KAAK;GACH,OAAO;GACP;EACF,KAAK;GACH,OAAO;GACP;EACF,KAAK;GACH,OAAO;GACP;EACF,KAAK;GACH,OAAO;GACP;EACF,KAAK;GACH,OAAO;GACP;EACF,KAAK;GACH,OAAO;GACP;EACF,SAAS;GACP,MAAM,OAAO,KAAK,YAAY,CAAC,KAAK;GAIpC,OACE,OAAO,MAAS,QAAQ,SAAU,QAAQ,QACtC,MAAM,KAAK,SAAS,EAAE,CAAA,CAAE,SAAS,GAAG,GAAG,MACvC;EACR;CACF;CAEF,OAAO,GAAG,IAAG;AACf;;;AChIA,IAAM,+BAAuD;CAC3D,IAAI;CACJ,MAAM;CACN,QAAQ;CACR,YAAY;CACZ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"}

package/dist/manifest.json

@@ -0,0 +1,8 @@
+{
+  "version": "1.0.0",
+  "timestamp": 1783048756887,
+  "packageName": "@happyvertical/smrt-mobile-contract",
+  "packageVersion": "0.37.7",
+  "objects": {},
+  "moduleType": "smrt"
+}

package/dist/smrt-knowledge.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-07-03T03:19:17.875Z",
+  "packageName": "@happyvertical/smrt-mobile-contract",
+  "packageVersion": "0.37.7",
+  "sourceManifestPath": "dist/manifest.json",
+  "agentDocPath": "AGENTS.md",
+  "sourceHashes": {
+    "manifest": "6fff72b6fd058fb7db3dc7a8aa088a2239ca6ff3dd835c4c2c9282aa0282d77b",
+    "packageJson": "51583b8d58802f0df9e869e226db3e6857a368683ea0087aac3e19068b4141e9",
+    "agents": "3f6b1c91d0a7809ce9ea67201d7b1d1659e3f03977eac39ca10e0ed8e3fac32a"
+  },
+  "exports": [
+    "."
+  ],
+  "dependencies": {
+    "@types/node": "24.13.2",
+    "typescript": "^5.9.3",
+    "vite": "8.1.2",
+    "vitest": "^4.1.9"
+  },
+  "smrtDependencies": [],
+  "sdkDependencies": [],
+  "tags": [],
+  "risks": [],
+  "objects": [],
+  "surfaces": [],
+  "prompts": [],
+  "relationshipsV2": {
+    "foreignKeyFields": 0,
+    "crossPackageRefFields": 0,
+    "junctionCollections": 0,
+    "hierarchicalObjects": 0,
+    "polymorphicAssociations": 0,
+    "uuidColumns": 0
+  },
+  "agentDoc": "# @happyvertical/smrt-mobile-contract\n\nTypeScript codegen bridging the SMRT manifest to the KMP mobile foundation\n(ADR 0001, epic #1745). Generalizes amaru's `amaru-mobile-contract`\n(manifest → allowlist → contract → Kotlin) and reporter's Swift emission.\nZero runtime dependencies by design — it reads `manifest.json` files\ndirectly, so it stays out of the smrt package DAG.\n\n## Two generation surfaces\n\n1. **Framework contract** (`frameworkKotlinFiles()` / `frameworkSwiftFiles()`)\n   — the stable files checked into `@happyvertical/smrt-mobile` under\n   `src/commonMain/kotlin/.../contract/` (support types, pack localization,\n   `/api/mobile/*` auth/session/device DTOs). This package is their single\n   source of truth: `pnpm generate:framework` rewrites them; `pnpm build`\n   verifies freshness (`scripts/generate-framework.mjs`). (The script is\n   deliberately NOT named `generate` — turbo's `build` task auto-runs a\n   `generate` script, which would rewrite the files on every build and\n   neutralize the freshness gate.) The Swift mirror\n   (`MobileContract.swift`) is emitted on demand for SwiftUI apps and is not\n   checked into smrt-mobile (iOS wiring is Phase 6).\n2. **Per-app domain DTOs** (`buildMobileContract()` +\n   `generateKotlinDtoFiles()` / `generateSwiftDtoFile()`) — consumer apps\n   pass their SMRT `manifest.json`(s) plus an object allowlist and a Kotlin\n   package; they get `@Serializable` Kotlin DTOs (defaults on every field for\n   safe partial deserialization) and plain Swift structs. Type mapping is\n   driven by manifest field `type` metadata (`text`/`integer`/`decimal`/\n   `boolean`/`datetime`/`foreignKey`/`crossPackageRef`/`json`), with amaru's\n   name heuristics only as a fallback for typeless fields. Relationship\n   declarations (`oneToMany`/`manyToMany`/`hasMany`) are excluded — they are\n   not scalar columns. Field defaults come from `default` (current manifests)\n   with `defaultValue` (amaru-era) as fallback. Decimals emit as\n   `DecimalString` (string-encoded — no float precision loss); field names\n   stay manifest-faithful (wire-format names, including `created_at`).\n\n## Conventions\n\n- `DecimalString`/`Measurement` and the auth contract types are imported from\n  `com.happyvertical.smrt.mobile.contract`, never re-emitted per app.\n- Allowlist entries may be short names or qualified names\n  (`@scope/pkg:Object`); ambiguous short names across manifests are an error.\n- `sourceHash` (sha256 over allowlist + projected objects) is stamped into\n  generated output so drift is detectable.\n- `turbo.json` here widens the build inputs to smrt-mobile's checked-in\n  contract dir so the freshness verify can't replay stale from cache.\n\n## Commands\n\n```bash\npnpm build                # vite build + verify smrt-mobile framework contract freshness\npnpm generate:framework   # vite build + REWRITE the smrt-mobile framework contract\npnpm test                 # vitest\n```\n"
+}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+export declare interface MobileContract {
+    schemaVersion: number;
+    contractVersion: string;
+    sourceLabel: string;
+    sourceHash: string;
+    objectAllowlist: string[];
+    objectCount: number;
+    kotlin: {
+        packageName: string;
+    };
+    typeMappings: Record<string, string>;
+    objects: MobileContractObject[];
+}
+
+export declare interface MobileContractField {
+    /** Manifest-faithful wire name (also the generated property name). */
+    name: string;
+    kotlinType: string;
+    swiftType: string;
+    nullable: boolean;
+    /** Kotlin default-value expression, or null for required (id). */
+    kotlinDefault: string | null;
+}
+
+export declare interface MobileContractObject {
+    name: string;
+    qualifiedName: string;
+    dtoName: string;
+    tableName: string | null;
+    hasTenantId: boolean;
+    fields: MobileContractField[];
+}
+
+export declare interface MobileContractOptions {
+    manifests: SmrtManifest[];
+    /** Object names (or qualified names) exposed to mobile. */
+    allowlist: string[];
+    /** Kotlin package the domain DTOs are emitted into. */
+    kotlinPackage: string;
+    /** Provenance label recorded in the contract (e.g. the manifest path). */
+    sourceLabel?: string;
+}
+
+/** The subset of a SMRT `manifest.json` the codegen consumes. */
+export declare interface SmrtManifest {
+    version?: number | string;
+    packageName?: string;
+    objects: Record<string, SmrtManifestObject> | SmrtManifestObject[];
+}
+
+/**
+ * Shapes for the SMRT mobile contract pipeline:
+ * manifest.json (+ allowlist) → MobileContract → generated Kotlin/Swift DTOs.
+ */
+/** One field entry in a SMRT manifest's `objects[*].fields` map. */
+export declare interface SmrtManifestField {
+    type?: string;
+    required?: boolean;
+    related?: string;
+    /** Current SMRT manifests emit `default`; amaru-era manifests used `defaultValue`. */
+    default?: unknown;
+    defaultValue?: unknown;
+    _meta?: Record<string, unknown>;
+}
+
+/** One object entry in a SMRT manifest (model or collection). */
+export declare interface SmrtManifestObject {
+    name: string;
+    className?: string;
+    qualifiedName?: string;
+    collection?: string | null;
+    packageName?: string;
+    fields?: Record<string, SmrtManifestField>;
+    schema?: {
+        tableName?: string;
+    } | null;
+}
+
+export { }

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@happyvertical/smrt-mobile-contract",
+  "version": "0.37.7",
+  "description": "SMRT mobile contract codegen: manifest + allowlist → mobile-contract.json → Kotlin/Swift DTOs, plus the generated framework contract for @happyvertical/smrt-mobile",
+  "author": "HappyVertical",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "CLAUDE.md",
+    "dist",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "24.13.2",
+    "typescript": "^5.9.3",
+    "vite": "8.1.2",
+    "vitest": "^4.1.9"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/smrt-mobile-contract"
+  },
+  "scripts": {
+    "build": "vite build && node scripts/generate-framework.mjs --verify",
+    "build:watch": "vite build --watch",
+    "dev": "npm run build:watch & npm run test:watch",
+    "generate:framework": "vite build && node scripts/generate-framework.mjs --write",
+    "verify:generated": "node scripts/generate-framework.mjs --verify",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js .",
+    "build:fresh": "npm run clean && npm run build && npm run verify:pack"
+  }
+}