@happyvertical/smrt-mobile-contract 0.51.32 → 0.51.34

package/dist/build-contract.d.ts

@@ -0,0 +1,3 @@
+import type { MobileContract, MobileContractOptions } from './types.js';
+export declare function buildMobileContract(options: MobileContractOptions): MobileContract;
+//# sourceMappingURL=build-contract.d.ts.map

package/dist/build-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-contract.d.ts","sourceRoot":"","sources":["../src/build-contract.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EAGd,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AAmEpB,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CA2DhB"}

package/dist/contract-version.d.ts

@@ -0,0 +1,8 @@
+/** 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";
+//# sourceMappingURL=contract-version.d.ts.map

package/dist/contract-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-version.d.ts","sourceRoot":"","sources":["../src/contract-version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,kBAAkB,CAAC"}

package/dist/emit-framework.d.ts

@@ -0,0 +1,9 @@
+/** 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>;
+//# sourceMappingURL=emit-framework.d.ts.map

package/dist/emit-framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-framework.d.ts","sourceRoot":"","sources":["../src/emit-framework.ts"],"names":[],"mappings":"AAqOA,2DAA2D;AAC3D,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ1D;AA6GD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}

package/dist/emit-kotlin.d.ts

@@ -0,0 +1,10 @@
+import type { MobileContract } from './types.js';
+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>;
+//# sourceMappingURL=emit-kotlin.d.ts.map

package/dist/emit-kotlin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-kotlin.d.ts","sourceRoot":"","sources":["../src/emit-kotlin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,gBAAgB,QAIjB,CAAC;AAIb;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,GACvB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB"}

package/dist/emit-swift.d.ts

@@ -0,0 +1,8 @@
+import type { MobileContract } from './types.js';
+/**
+ * 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;
+//# sourceMappingURL=emit-swift.d.ts.map

package/dist/emit-swift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-swift.d.ts","sourceRoot":"","sources":["../src/emit-swift.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAqBrE"}

package/dist/file-set.d.ts

@@ -0,0 +1,8 @@
+/** Writes every `relPath → content` entry under `rootDir`. */
+export declare function writeFileSet(rootDir: string, files: Map<string, string>): void;
+/**
+ * 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[];
+//# sourceMappingURL=file-set.d.ts.map

package/dist/file-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-set.d.ts","sourceRoot":"","sources":["../src/file-set.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB,MAAM,EAAE,CASV"}

package/dist/framework-types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * TypeScript wire types for the `/api/mobile` auth + session contract.
+ *
+ * These are the SAME shapes the framework Kotlin contract ships to mobile
+ * clients (`MOBILE_AUTH_CONTRACT_KT` in `emit-framework.ts`, checked into
+ * `@happyvertical/smrt-mobile` as `MobileAuthContract.kt`). Server-side
+ * implementations -- the reusable SvelteKit handlers in
+ * `@happyvertical/smrt-users` (issue #1748) -- import them from here so the
+ * wire contract has one owning package on both sides.
+ *
+ * Two sync guarantees keep the three representations locked together:
+ *
+ * 1. Each interface has a `MobileWireShape` descriptor below. The `satisfies`
+ *    check makes the descriptor fail to COMPILE when it disagrees with the
+ *    interface (missing/extra field, or wrong required/optional/nullable
+ *    kind).
+ * 2. `__tests__/framework-auth-types.test.ts` parses the Kotlin literal and
+ *    asserts it matches the descriptors field-for-field, so editing either
+ *    side without the other fails the contract package's tests.
+ *
+ * Kotlin → TypeScript field mapping:
+ * - `val x: T` (no default)        → `x: T` (required)
+ * - `val x: T = <non-null value>`  → `x?: T` (kotlinx.serialization omits
+ *   default-equal values by default, and decoders fill absent fields from
+ *   defaults — so the wire may omit them in either direction)
+ * - `val x: T? = null`             → `x?: T | null`
+ *
+ * @packageDocumentation
+ */
+/**
+ * Classifies one wire field. Mirrors the three Kotlin declaration forms the
+ * framework contract uses (see the mapping table in the module docs).
+ */
+export type MobileWireFieldKind = 'required' | 'optional' | 'nullable';
+/**
+ * Compile-time-checked shape descriptor for a wire type: one entry per field,
+ * whose kind is DERIVED from the TypeScript declaration. Using
+ * `Extract<keyof T, string>` keeps the mapped type non-homomorphic, so every
+ * key must be listed (optionality is not copied from `T`) while `T[K]` still
+ * carries `undefined` for optional properties.
+ */
+export type MobileWireShape<T> = {
+    [K in Extract<keyof T, string>]: undefined extends T[K] ? null extends T[K] ? 'nullable' : 'optional' : 'required';
+};
+/** Signed-in user summary returned by auth/complete and the session bootstrap. */
+export interface MobileUserSummary {
+    id: string;
+    email?: string;
+    label?: string;
+}
+/** Tenant summary with subscription surface (reserved for app responses). */
+export interface MobileTenantSummary {
+    id: string;
+    name?: string;
+    slug?: string;
+    planName?: string;
+    subscriptionStatus?: string;
+}
+/** One selectable tenant, labeled with the role the user holds there. */
+export interface MobileTenantOption {
+    id: string;
+    name?: string;
+    slug?: string;
+    roleSlug?: string;
+    roleLabel?: string;
+}
+/** One configured auth provider (reserved for app-side provider pickers). */
+export interface MobileAuthProviderSummary {
+    id: string;
+    label?: string;
+    type?: string;
+    supportsPkce?: boolean;
+}
+/** Body of `POST /api/mobile/auth/start`. */
+export interface MobileAuthStartRequest {
+    providerId?: string | null;
+    redirectUri: string;
+    scopes?: string[];
+    state?: string | null;
+    loginHint?: string | null;
+}
+/**
+ * Response of `POST /api/mobile/auth/start`. The client persists `state` and
+ * `codeVerifier` (as an opaque pending handshake) and echoes them back on
+ * `auth/complete`; `state` is also validated against the IdP redirect.
+ */
+export interface MobileAuthStartResponse {
+    providerId: string;
+    authorizationUrl: string;
+    state: string;
+    codeVerifier?: string | null;
+    nonce?: string | null;
+    redirectUri: string;
+}
+/** Body of `POST /api/mobile/auth/complete`. */
+export interface MobileAuthCompleteRequest {
+    providerId?: string | null;
+    code: string;
+    state?: string | null;
+    codeVerifier?: string | null;
+    redirectUri: string;
+}
+/**
+ * Response of `POST /api/mobile/auth/complete` — the mobile bearer session.
+ * `accessToken` goes into `Authorization: Bearer <token>` on every
+ * authenticated `/api/mobile` request.
+ */
+export interface MobileAuthSession {
+    accessToken: string;
+    tokenType?: string;
+    expiresAt?: string;
+    user: MobileUserSummary;
+    activeTenant?: MobileTenantOption | null;
+    tenants?: MobileTenantOption[];
+}
+/**
+ * Response of `GET /api/mobile/session` -- the app-boot payload for a stored
+ * bearer. `extras` is the only app-defined extension point and must remain a
+ * JSON object (the Kotlin side decodes it as `JsonObject`). App-domain fields
+ * placed at the top level are outside the contract and are ignored by the
+ * Kotlin decoder.
+ */
+export interface MobileSessionBootstrap {
+    user: MobileUserSummary;
+    activeTenant?: MobileTenantOption | null;
+    tenants?: MobileTenantOption[];
+    extras?: Record<string, unknown> | null;
+}
+export declare const MOBILE_USER_SUMMARY_SHAPE: {
+    readonly id: "required";
+    readonly email: "optional";
+    readonly label: "optional";
+};
+export declare const MOBILE_TENANT_SUMMARY_SHAPE: {
+    readonly id: "required";
+    readonly name: "optional";
+    readonly slug: "optional";
+    readonly planName: "optional";
+    readonly subscriptionStatus: "optional";
+};
+export declare const MOBILE_TENANT_OPTION_SHAPE: {
+    readonly id: "required";
+    readonly name: "optional";
+    readonly slug: "optional";
+    readonly roleSlug: "optional";
+    readonly roleLabel: "optional";
+};
+export declare const MOBILE_AUTH_PROVIDER_SUMMARY_SHAPE: {
+    readonly id: "required";
+    readonly label: "optional";
+    readonly type: "optional";
+    readonly supportsPkce: "optional";
+};
+export declare const MOBILE_AUTH_START_REQUEST_SHAPE: {
+    readonly providerId: "nullable";
+    readonly redirectUri: "required";
+    readonly scopes: "optional";
+    readonly state: "nullable";
+    readonly loginHint: "nullable";
+};
+export declare const MOBILE_AUTH_START_RESPONSE_SHAPE: {
+    readonly providerId: "required";
+    readonly authorizationUrl: "required";
+    readonly state: "required";
+    readonly codeVerifier: "nullable";
+    readonly nonce: "nullable";
+    readonly redirectUri: "required";
+};
+export declare const MOBILE_AUTH_COMPLETE_REQUEST_SHAPE: {
+    readonly providerId: "nullable";
+    readonly code: "required";
+    readonly state: "nullable";
+    readonly codeVerifier: "nullable";
+    readonly redirectUri: "required";
+};
+export declare const MOBILE_AUTH_SESSION_SHAPE: {
+    readonly accessToken: "required";
+    readonly tokenType: "optional";
+    readonly expiresAt: "optional";
+    readonly user: "required";
+    readonly activeTenant: "nullable";
+    readonly tenants: "optional";
+};
+export declare const MOBILE_SESSION_BOOTSTRAP_SHAPE: {
+    readonly user: "required";
+    readonly activeTenant: "nullable";
+    readonly tenants: "optional";
+    readonly extras: "nullable";
+};
+/**
+ * All auth-contract shape descriptors, keyed by the Kotlin data class name.
+ * The parity test asserts this map covers exactly the data classes declared
+ * in `MobileAuthContract.kt` — adding a class to either side without the
+ * other fails the suite.
+ */
+export declare const MOBILE_AUTH_WIRE_SHAPES: Record<string, Record<string, MobileWireFieldKind>>;
+//# sourceMappingURL=framework-types.d.ts.map

package/dist/framework-types.d.ts.map

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

package/dist/identifiers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Identifier + literal escaping for generated Kotlin/Swift source. Manifest
+ * field names are valid JS identifiers, but may collide with Kotlin/Swift
+ * keywords; string defaults may contain characters that Kotlin string
+ * templates or escapes treat specially.
+ */
+/** Backtick-escapes Kotlin hard keywords (and non-plain identifiers). */
+export declare function kotlinIdentifier(name: string): string;
+/** Backtick-escapes Swift keywords (and non-plain identifiers). */
+export declare function swiftIdentifier(name: string): string;
+/**
+ * Emits a Kotlin double-quoted string literal. Escapes `$` (string-template
+ * interpolation), quotes, backslashes, and control characters — JSON escaping
+ * is NOT Kotlin-safe (`$` stays raw and `\f` is not a Kotlin escape).
+ */
+export declare function kotlinStringLiteral(value: string): string;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../src/identifiers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyFH,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmCzD"}

package/dist/index.d.ts

@@ -1,314 +1,9 @@
-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 const MOBILE_AUTH_COMPLETE_REQUEST_SHAPE: {
-    readonly providerId: "nullable";
-    readonly code: "required";
-    readonly state: "nullable";
-    readonly codeVerifier: "nullable";
-    readonly redirectUri: "required";
-};
-
-export declare const MOBILE_AUTH_PROVIDER_SUMMARY_SHAPE: {
-    readonly id: "required";
-    readonly label: "optional";
-    readonly type: "optional";
-    readonly supportsPkce: "optional";
-};
-
-export declare const MOBILE_AUTH_SESSION_SHAPE: {
-    readonly accessToken: "required";
-    readonly tokenType: "optional";
-    readonly expiresAt: "optional";
-    readonly user: "required";
-    readonly activeTenant: "nullable";
-    readonly tenants: "optional";
-};
-
-export declare const MOBILE_AUTH_START_REQUEST_SHAPE: {
-    readonly providerId: "nullable";
-    readonly redirectUri: "required";
-    readonly scopes: "optional";
-    readonly state: "nullable";
-    readonly loginHint: "nullable";
-};
-
-export declare const MOBILE_AUTH_START_RESPONSE_SHAPE: {
-    readonly providerId: "required";
-    readonly authorizationUrl: "required";
-    readonly state: "required";
-    readonly codeVerifier: "nullable";
-    readonly nonce: "nullable";
-    readonly redirectUri: "required";
-};
-
-/**
- * All auth-contract shape descriptors, keyed by the Kotlin data class name.
- * The parity test asserts this map covers exactly the data classes declared
- * in `MobileAuthContract.kt` — adding a class to either side without the
- * other fails the suite.
- */
-export declare const MOBILE_AUTH_WIRE_SHAPES: Record<string, Record<string, MobileWireFieldKind>>;
-
-export declare const MOBILE_SESSION_BOOTSTRAP_SHAPE: {
-    readonly user: "required";
-    readonly activeTenant: "nullable";
-    readonly tenants: "optional";
-    readonly extras: "nullable";
-};
-
-export declare const MOBILE_TENANT_OPTION_SHAPE: {
-    readonly id: "required";
-    readonly name: "optional";
-    readonly slug: "optional";
-    readonly roleSlug: "optional";
-    readonly roleLabel: "optional";
-};
-
-export declare const MOBILE_TENANT_SUMMARY_SHAPE: {
-    readonly id: "required";
-    readonly name: "optional";
-    readonly slug: "optional";
-    readonly planName: "optional";
-    readonly subscriptionStatus: "optional";
-};
-
-export declare const MOBILE_USER_SUMMARY_SHAPE: {
-    readonly id: "required";
-    readonly email: "optional";
-    readonly label: "optional";
-};
-
-/** Body of `POST /api/mobile/auth/complete`. */
-export declare interface MobileAuthCompleteRequest {
-    providerId?: string | null;
-    code: string;
-    state?: string | null;
-    codeVerifier?: string | null;
-    redirectUri: string;
-}
-
-/** One configured auth provider (reserved for app-side provider pickers). */
-export declare interface MobileAuthProviderSummary {
-    id: string;
-    label?: string;
-    type?: string;
-    supportsPkce?: boolean;
-}
-
-/**
- * Response of `POST /api/mobile/auth/complete` — the mobile bearer session.
- * `accessToken` goes into `Authorization: Bearer <token>` on every
- * authenticated `/api/mobile` request.
- */
-export declare interface MobileAuthSession {
-    accessToken: string;
-    tokenType?: string;
-    expiresAt?: string;
-    user: MobileUserSummary;
-    activeTenant?: MobileTenantOption | null;
-    tenants?: MobileTenantOption[];
-}
-
-/** Body of `POST /api/mobile/auth/start`. */
-export declare interface MobileAuthStartRequest {
-    providerId?: string | null;
-    redirectUri: string;
-    scopes?: string[];
-    state?: string | null;
-    loginHint?: string | null;
-}
-
-/**
- * Response of `POST /api/mobile/auth/start`. The client persists `state` and
- * `codeVerifier` (as an opaque pending handshake) and echoes them back on
- * `auth/complete`; `state` is also validated against the IdP redirect.
- */
-export declare interface MobileAuthStartResponse {
-    providerId: string;
-    authorizationUrl: string;
-    state: string;
-    codeVerifier?: string | null;
-    nonce?: string | null;
-    redirectUri: 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;
-}
-
-/**
- * Response of `GET /api/mobile/session` -- the app-boot payload for a stored
- * bearer. `extras` is the only app-defined extension point and must remain a
- * JSON object (the Kotlin side decodes it as `JsonObject`). App-domain fields
- * placed at the top level are outside the contract and are ignored by the
- * Kotlin decoder.
- */
-export declare interface MobileSessionBootstrap {
-    user: MobileUserSummary;
-    activeTenant?: MobileTenantOption | null;
-    tenants?: MobileTenantOption[];
-    extras?: Record<string, unknown> | null;
-}
-
-/** One selectable tenant, labeled with the role the user holds there. */
-export declare interface MobileTenantOption {
-    id: string;
-    name?: string;
-    slug?: string;
-    roleSlug?: string;
-    roleLabel?: string;
-}
-
-/** Tenant summary with subscription surface (reserved for app responses). */
-export declare interface MobileTenantSummary {
-    id: string;
-    name?: string;
-    slug?: string;
-    planName?: string;
-    subscriptionStatus?: string;
-}
-
-/** Signed-in user summary returned by auth/complete and the session bootstrap. */
-export declare interface MobileUserSummary {
-    id: string;
-    email?: string;
-    label?: string;
-}
-
-/**
- * Classifies one wire field. Mirrors the three Kotlin declaration forms the
- * framework contract uses (see the mapping table in the module docs).
- */
-export declare type MobileWireFieldKind = 'required' | 'optional' | 'nullable';
-
-/**
- * Compile-time-checked shape descriptor for a wire type: one entry per field,
- * whose kind is DERIVED from the TypeScript declaration. Using
- * `Extract<keyof T, string>` keeps the mapped type non-homomorphic, so every
- * key must be listed (optionality is not copied from `T`) while `T[K]` still
- * carries `undefined` for optional properties.
- */
-export declare type MobileWireShape<T> = {
-    [K in Extract<keyof T, string>]: undefined extends T[K] ? null extends T[K] ? 'nullable' : 'optional' : 'required';
-};
-
-/** 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 { }
+export { buildMobileContract } from './build-contract.js';
+export { SMRT_MOBILE_CONTRACT_SCHEMA_VERSION, SMRT_MOBILE_CONTRACT_VERSION, } from './contract-version.js';
+export { frameworkKotlinFiles, frameworkSwiftFiles } from './emit-framework.js';
+export { GENERATED_HEADER, generateKotlinDtoFiles } from './emit-kotlin.js';
+export { generateSwiftDtoFile } from './emit-swift.js';
+export { verifyFileSet, writeFileSet } from './file-set.js';
+export { MOBILE_AUTH_COMPLETE_REQUEST_SHAPE, MOBILE_AUTH_PROVIDER_SUMMARY_SHAPE, MOBILE_AUTH_SESSION_SHAPE, MOBILE_AUTH_START_REQUEST_SHAPE, MOBILE_AUTH_START_RESPONSE_SHAPE, MOBILE_AUTH_WIRE_SHAPES, MOBILE_SESSION_BOOTSTRAP_SHAPE, MOBILE_TENANT_OPTION_SHAPE, MOBILE_TENANT_SUMMARY_SHAPE, MOBILE_USER_SUMMARY_SHAPE, type MobileAuthCompleteRequest, type MobileAuthProviderSummary, type MobileAuthSession, type MobileAuthStartRequest, type MobileAuthStartResponse, type MobileSessionBootstrap, type MobileTenantOption, type MobileTenantSummary, type MobileUserSummary, type MobileWireFieldKind, type MobileWireShape, } from './framework-types.js';
+export type { MobileContract, MobileContractField, MobileContractObject, MobileContractOptions, SmrtManifest, SmrtManifestField, SmrtManifestObject, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,mCAAmC,EACnC,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,yBAAyB,EACzB,+BAA+B,EAC/B,gCAAgC,EAChC,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-mobile-contract",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.34",
   "objects": {},
   "moduleType": "smrt",
   "smrtDependencies": [

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-mobile-contract",
-  "packageVersion": "0.51.32",
+  "packageVersion": "0.51.34",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "474319c0058b0edb26d4961faa23e2ace4ea1d3cba5375a6726d824a7d6b0698",
-    "packageJson": "8f2290624de3009482a08da70fd763f8b3373f4bfac05f4d2ce913d239103826",
+    "manifest": "d97463b793eb6f68ebbb2bd863f4e10ec097e0ec40ea6315eafefeaec14da430",
+    "packageJson": "5971515bc4886638c03afd1119ee9384a60cb093d2c7f92b7706621e7ed807fd",
     "agents": "e3769aff93a1a56f2f6862e175a6e35a7996fc5c77c82bfd5cac629711ea8ebe"
   },
   "exports": [
@@ -17,7 +17,7 @@
   "dependencies": {
     "@happyvertical/smrt-core": "workspace:*",
     "@types/node": "24.13.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },

package/dist/types.d.ts

@@ -1,79 +1,72 @@
-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 { }
+/**
+ * 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 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 interface SmrtManifestObject {
+    name: string;
+    className?: string;
+    qualifiedName?: string;
+    collection?: string | null;
+    packageName?: string;
+    fields?: Record<string, SmrtManifestField>;
+    schema?: {
+        tableName?: string;
+    } | null;
+}
+/** The subset of a SMRT `manifest.json` the codegen consumes. */
+export interface SmrtManifest {
+    version?: number | string;
+    packageName?: string;
+    objects: Record<string, SmrtManifestObject> | SmrtManifestObject[];
+}
+export 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 interface MobileContractObject {
+    name: string;
+    qualifiedName: string;
+    dtoName: string;
+    tableName: string | null;
+    hasTenantId: boolean;
+    fields: MobileContractField[];
+}
+export 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;
+}
+export interface MobileContract {
+    schemaVersion: number;
+    contractVersion: string;
+    sourceLabel: string;
+    sourceHash: string;
+    objectAllowlist: string[];
+    objectCount: number;
+    kotlin: {
+        packageName: string;
+    };
+    typeMappings: Record<string, string>;
+    objects: MobileContractObject[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACxC;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,kBAAkB,EAAE,CAAC;CACpE;AAED,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-mobile-contract",
-  "version": "0.51.32",
+  "version": "0.51.34",
   "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",
@@ -19,9 +19,9 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-core": "0.51.32",
+    "@happyvertical/smrt-core": "0.51.34",
     "@types/node": "24.13.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },