@marinoscar/platform-contract 0.1.0-next.3 → 0.1.0-next.4

package/dist/cjs/android-app/schemas.d.ts

@@ -0,0 +1,358 @@
+import { z } from 'zod';
+import type { AndroidAppTestReason, AndroidAppTestStatus } from './constants.js';
+/**
+ * An Android application id, trimmed, kept case-sensitive.
+ *
+ * @stability experimental
+ */
+export declare const androidPackageNameSchema: z.ZodString;
+/**
+ * A SHA-256 signing certificate fingerprint: 32 colon-separated hex bytes or
+ * 64 hex digits, either case; the output is the stored upper-case colon form.
+ *
+ * @stability experimental
+ */
+export declare const sha256FingerprintSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+/**
+ * One trusted (package, signing key) pair.
+ *
+ * @stability experimental
+ */
+export declare const trustedAndroidAppSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    sha256: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+}, z.core.$strict>;
+/**
+ * One trusted app, typed.
+ *
+ * @stability experimental
+ */
+export type TrustedAndroidApp = z.output<typeof trustedAndroidAppSchema>;
+/**
+ * Drops repeated pairs, keeping the first. Order is otherwise preserved.
+ *
+ * @param apps - the parsed list.
+ * @returns a new list without duplicates.
+ *
+ * @stability experimental
+ */
+export declare function dedupeTrustedApps(apps: readonly TrustedAndroidApp[]): TrustedAndroidApp[];
+/**
+ * The whole trusted list: at most {@link MAX_TRUSTED_ANDROID_APPS}, repeated
+ * pairs dropped.
+ *
+ * @stability experimental
+ */
+export declare const trustedAndroidAppsSchema: z.ZodPipe<z.ZodArray<z.ZodObject<{
+    packageName: z.ZodString;
+    sha256: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+}, z.core.$strict>>, z.ZodTransform<{
+    packageName: string;
+    sha256: string;
+}[], {
+    packageName: string;
+    sha256: string;
+}[]>>;
+/**
+ * The stored value of the `android_app` `system_settings` row.
+ *
+ * @stability experimental
+ */
+export declare const androidAppSettingsValueSchema: z.ZodObject<{
+    trustedApps: z.ZodPipe<z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        sha256: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+    }, z.core.$strict>>, z.ZodTransform<{
+        packageName: string;
+        sha256: string;
+    }[], {
+        packageName: string;
+        sha256: string;
+    }[]>>;
+}, z.core.$strip>;
+/**
+ * The stored value, typed.
+ *
+ * @stability experimental
+ */
+export type AndroidAppSettingsValue = z.output<typeof androidAppSettingsValueSchema>;
+/**
+ * `PUT /api/admin/android-app`: replaces the whole list.
+ *
+ * @stability experimental
+ */
+export declare const updateAndroidAppSchema: z.ZodObject<{
+    trustedApps: z.ZodPipe<z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        sha256: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+    }, z.core.$strict>>, z.ZodTransform<{
+        packageName: string;
+        sha256: string;
+    }[], {
+        packageName: string;
+        sha256: string;
+    }[]>>;
+}, z.core.$strict>;
+/**
+ * The replace body, parsed.
+ *
+ * @stability experimental
+ */
+export type UpdateAndroidAppInput = z.output<typeof updateAndroidAppSchema>;
+/**
+ * One (package, signing key) pair paired devices reported, merged across
+ * every registered device source.
+ *
+ * @stability experimental
+ */
+export declare const reportedAndroidAppSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    sha256: z.ZodString;
+    deviceCount: z.ZodNumber;
+    lastSeenAt: z.ZodNullable<z.ZodISODateTime>;
+    trusted: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * One reported app, typed.
+ *
+ * @stability experimental
+ */
+export type ReportedAndroidApp = z.infer<typeof reportedAndroidAppSchema>;
+/**
+ * One Digital Asset Links statement.
+ *
+ * @stability experimental
+ */
+export declare const assetLinkStatementSchema: z.ZodObject<{
+    relation: z.ZodArray<z.ZodLiteral<"delegate_permission/common.handle_all_urls">>;
+    target: z.ZodObject<{
+        namespace: z.ZodLiteral<"android_app">;
+        package_name: z.ZodString;
+        sha256_cert_fingerprints: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * One statement, typed.
+ *
+ * @stability experimental
+ */
+export type AssetLinkStatement = z.infer<typeof assetLinkStatementSchema>;
+/**
+ * Web Push subscription counts by platform (EvoPath): how many devices the
+ * `android_app` channel can reach.
+ *
+ * @stability experimental
+ */
+export declare const androidPushSubscriptionCountsSchema: z.ZodObject<{
+    androidApp: z.ZodNumber;
+    browser: z.ZodNumber;
+    androidAppUsers: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * The counts, typed.
+ *
+ * @stability experimental
+ */
+export type AndroidPushSubscriptionCounts = z.infer<typeof androidPushSubscriptionCountsSchema>;
+/**
+ * `GET`/`PUT /api/admin/android-app`.
+ *
+ * @stability experimental
+ */
+export declare const androidAppResponseSchema: z.ZodObject<{
+    trustedApps: z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        sha256: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+    }, z.core.$strict>>;
+    reportedApps: z.ZodArray<z.ZodObject<{
+        packageName: z.ZodString;
+        sha256: z.ZodString;
+        deviceCount: z.ZodNumber;
+        lastSeenAt: z.ZodNullable<z.ZodISODateTime>;
+        trusted: z.ZodBoolean;
+    }, z.core.$strip>>;
+    assetLinks: z.ZodArray<z.ZodObject<{
+        relation: z.ZodArray<z.ZodLiteral<"delegate_permission/common.handle_all_urls">>;
+        target: z.ZodObject<{
+            namespace: z.ZodLiteral<"android_app">;
+            package_name: z.ZodString;
+            sha256_cert_fingerprints: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    pushSubscriptions: z.ZodObject<{
+        androidApp: z.ZodNumber;
+        browser: z.ZodNumber;
+        androidAppUsers: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * The admin view, typed.
+ *
+ * @stability experimental
+ */
+export type AndroidAppResponse = z.infer<typeof androidAppResponseSchema>;
+/**
+ * The string spellings a multipart boolean field accepts, as `z.enum` types them.
+ *
+ * @stability experimental
+ */
+export type BooleanFieldEnum = {
+    [K in 'true' | 'false' | '1' | '0']: K;
+};
+/**
+ * The Android test statuses, as `z.enum` types them.
+ *
+ * @stability experimental
+ */
+export type AndroidAppTestStatusEnum = {
+    [K in AndroidAppTestStatus]: K;
+};
+/**
+ * The Android test reasons, as `z.enum` types them.
+ *
+ * @stability experimental
+ */
+export type AndroidAppTestReasonEnum = {
+    [K in AndroidAppTestReason]: K;
+};
+/**
+ * The text fields of a release upload (multipart, so every value arrives as a
+ * string). Strict: an unknown field is refused.
+ *
+ * @stability experimental
+ */
+export declare const releaseUploadFieldsSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    versionName: z.ZodString;
+    versionCode: z.ZodCoercedNumber<unknown>;
+    signingSha256: z.ZodPipe<z.ZodString, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+    notes: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | null, string | undefined>>;
+    makeCurrent: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<BooleanFieldEnum>]>>, z.ZodTransform<boolean, boolean | "0" | "true" | "false" | "1" | undefined>>;
+    force: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<BooleanFieldEnum>]>>, z.ZodTransform<boolean, boolean | "0" | "true" | "false" | "1" | undefined>>;
+    trust: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<BooleanFieldEnum>]>>, z.ZodTransform<boolean, boolean | "0" | "true" | "false" | "1" | undefined>>;
+}, z.core.$strict>;
+/**
+ * The parsed upload fields.
+ *
+ * @stability experimental
+ */
+export type ReleaseUploadFields = z.output<typeof releaseUploadFieldsSchema>;
+/**
+ * What any signed-in user sees of a release (`GET /api/android-app/releases/latest`).
+ *
+ * @stability experimental
+ */
+export declare const publicReleaseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    packageName: z.ZodString;
+    versionName: z.ZodString;
+    versionCode: z.ZodNumber;
+    fileSha256: z.ZodString;
+    sizeBytes: z.ZodString;
+    notes: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+/**
+ * A public release, typed.
+ *
+ * @stability experimental
+ */
+export type PublicRelease = z.infer<typeof publicReleaseSchema>;
+/**
+ * What an administrator sees of a release.
+ *
+ * @stability experimental
+ */
+export declare const adminReleaseSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    packageName: z.ZodString;
+    versionName: z.ZodString;
+    versionCode: z.ZodNumber;
+    fileSha256: z.ZodString;
+    sizeBytes: z.ZodString;
+    notes: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    signingSha256: z.ZodString;
+    isCurrent: z.ZodBoolean;
+    storageProvider: z.ZodNullable<z.ZodString>;
+    uploadedBy: z.ZodNullable<z.ZodObject<{
+        id: z.ZodUUID;
+        email: z.ZodString;
+        displayName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * An admin release, typed.
+ *
+ * @stability experimental
+ */
+export type AdminRelease = z.infer<typeof adminReleaseSchema>;
+/**
+ * `POST /api/android-app/releases/:id/download-link`.
+ *
+ * @stability experimental
+ */
+export declare const downloadLinkSchema: z.ZodObject<{
+    url: z.ZodString;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strip>;
+/**
+ * A download link, typed.
+ *
+ * @stability experimental
+ */
+export type DownloadLink = z.infer<typeof downloadLinkSchema>;
+/**
+ * `POST /api/admin/android-app/test-notification` body.
+ *
+ * @stability experimental
+ */
+export declare const androidAppTestNotificationRequestSchema: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strict>;
+/**
+ * The test request, typed.
+ *
+ * @stability experimental
+ */
+export type AndroidAppTestNotificationRequest = z.infer<typeof androidAppTestNotificationRequestSchema>;
+/**
+ * One subscription's outcome.
+ *
+ * @stability experimental
+ */
+export declare const androidAppTestResultRowSchema: z.ZodObject<{
+    subscriptionId: z.ZodUUID;
+    endpointHost: z.ZodString;
+    status: z.ZodEnum<AndroidAppTestStatusEnum>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * One outcome, typed.
+ *
+ * @stability experimental
+ */
+export type AndroidAppTestResultRow = z.infer<typeof androidAppTestResultRowSchema>;
+/**
+ * The test notification response: always 200 for a valid request.
+ *
+ * @stability experimental
+ */
+export declare const androidAppTestNotificationResponseSchema: z.ZodObject<{
+    userId: z.ZodUUID;
+    androidSubscriptions: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        subscriptionId: z.ZodUUID;
+        endpointHost: z.ZodString;
+        status: z.ZodEnum<AndroidAppTestStatusEnum>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    reason: z.ZodOptional<z.ZodEnum<AndroidAppTestReasonEnum>>;
+}, z.core.$strip>;
+/**
+ * The test response, typed.
+ *
+ * @stability experimental
+ */
+export type AndroidAppTestNotificationResponse = z.infer<typeof androidAppTestNotificationResponseSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/cjs/android-app/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/android-app/schemas.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAIjF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,aAI0E,CAAC;AAEhH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,gFAUjC,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;kBAOzB,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEzE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAUzF;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;KAGN,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;iBAGxC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;kBAKxB,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;iBAWnC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;iBAYnC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC;;;;iBAO9C,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;iBASnC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;KAAG,CAAC,IAAI,MAAM,GAAG,OAAO,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAAE,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;KAAG,CAAC,IAAI,oBAAoB,GAAG,CAAC;CAAE,CAAC;AAE1E;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;KAAG,CAAC,IAAI,oBAAoB,GAAG,CAAC;CAAE,CAAC;AAY1E;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;kBA6B3B,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAiB9B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;iBAkB7B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;iBAK7B,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;;GAIG;AACH,eAAO,MAAM,uCAAuC;;kBAKzC,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC;AAExG;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;iBASxC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF;;;;GAIG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;iBASnD,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wCAAwC,CAAC,CAAC"}

package/dist/cjs/android-app/schemas.js

@@ -0,0 +1,310 @@
+"use strict";
+// =============================================================================
+// The android-app slice's wire shapes (issue #746, PP-9.4)
+// =============================================================================
+//
+// Merged from EvoPath and MemoriaHub: MemoriaHub's fingerprint normalisation
+// (bare 64-hex or colon pairs, stored upper-case colon pairs), its strict
+// upload fields and BigInt `sizeBytes` (a decimal string on the wire), and
+// EvoPath's test notification and push subscription counts.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.androidAppTestNotificationResponseSchema = exports.androidAppTestResultRowSchema = exports.androidAppTestNotificationRequestSchema = exports.downloadLinkSchema = exports.adminReleaseSchema = exports.publicReleaseSchema = exports.releaseUploadFieldsSchema = exports.androidAppResponseSchema = exports.androidPushSubscriptionCountsSchema = exports.assetLinkStatementSchema = exports.reportedAndroidAppSchema = exports.updateAndroidAppSchema = exports.androidAppSettingsValueSchema = exports.trustedAndroidAppsSchema = exports.trustedAndroidAppSchema = exports.sha256FingerprintSchema = exports.androidPackageNameSchema = void 0;
+exports.dedupeTrustedApps = dedupeTrustedApps;
+const zod_1 = require("zod");
+const constants_js_1 = require("./constants.js");
+// ---- trusted apps -----------------------------------------------------------
+/**
+ * An Android application id, trimmed, kept case-sensitive.
+ *
+ * @stability experimental
+ */
+exports.androidPackageNameSchema = zod_1.z
+    .string()
+    .trim()
+    .max(255)
+    .regex(constants_js_1.ANDROID_PACKAGE_NAME_PATTERN, 'packageName must be an Android application id such as com.example.app');
+/**
+ * A SHA-256 signing certificate fingerprint: 32 colon-separated hex bytes or
+ * 64 hex digits, either case; the output is the stored upper-case colon form.
+ *
+ * @stability experimental
+ */
+exports.sha256FingerprintSchema = zod_1.z
+    .string()
+    .transform(constants_js_1.normalizeSha256Fingerprint)
+    .pipe(zod_1.z
+    .string()
+    .regex(constants_js_1.SHA256_FINGERPRINT_PATTERN, 'sha256 must be a SHA-256 certificate fingerprint: 32 colon-separated hex bytes (AA:BB:...) or 64 hex digits'));
+/**
+ * One trusted (package, signing key) pair.
+ *
+ * @stability experimental
+ */
+exports.trustedAndroidAppSchema = zod_1.z
+    .object({
+    /** The application id. */
+    packageName: exports.androidPackageNameSchema,
+    /** The signing certificate fingerprint (stored upper-case colon form). */
+    sha256: exports.sha256FingerprintSchema,
+})
+    .strict();
+/**
+ * Drops repeated pairs, keeping the first. Order is otherwise preserved.
+ *
+ * @param apps - the parsed list.
+ * @returns a new list without duplicates.
+ *
+ * @stability experimental
+ */
+function dedupeTrustedApps(apps) {
+    const seen = new Set();
+    const result = [];
+    for (const app of apps) {
+        const key = (0, constants_js_1.trustedAppKey)(app.packageName, app.sha256);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push({ packageName: app.packageName, sha256: app.sha256 });
+    }
+    return result;
+}
+/**
+ * The whole trusted list: at most {@link MAX_TRUSTED_ANDROID_APPS}, repeated
+ * pairs dropped.
+ *
+ * @stability experimental
+ */
+exports.trustedAndroidAppsSchema = zod_1.z
+    .array(exports.trustedAndroidAppSchema)
+    .max(constants_js_1.MAX_TRUSTED_ANDROID_APPS, `At most ${constants_js_1.MAX_TRUSTED_ANDROID_APPS} trusted apps`)
+    .transform(dedupeTrustedApps);
+/**
+ * The stored value of the `android_app` `system_settings` row.
+ *
+ * @stability experimental
+ */
+exports.androidAppSettingsValueSchema = zod_1.z.object({
+    /** The trusted pairs, in the order the administrator saved them. */
+    trustedApps: exports.trustedAndroidAppsSchema,
+});
+/**
+ * `PUT /api/admin/android-app`: replaces the whole list.
+ *
+ * @stability experimental
+ */
+exports.updateAndroidAppSchema = zod_1.z
+    .object({
+    /** The new list (at most ten pairs). */
+    trustedApps: exports.trustedAndroidAppsSchema,
+})
+    .strict();
+/**
+ * One (package, signing key) pair paired devices reported, merged across
+ * every registered device source.
+ *
+ * @stability experimental
+ */
+exports.reportedAndroidAppSchema = zod_1.z.object({
+    /** The application id the devices run. */
+    packageName: zod_1.z.string(),
+    /** The signing fingerprint they reported (normalised). */
+    sha256: zod_1.z.string(),
+    /** How many devices report this pair. */
+    deviceCount: zod_1.z.number().int().nonnegative(),
+    /** The latest sighting (ISO 8601), or null. */
+    lastSeenAt: zod_1.z.iso.datetime().nullable(),
+    /** Whether the pair is in the trusted list. */
+    trusted: zod_1.z.boolean(),
+});
+/**
+ * One Digital Asset Links statement.
+ *
+ * @stability experimental
+ */
+exports.assetLinkStatementSchema = zod_1.z.object({
+    /** Always `[ASSET_LINKS_RELATION]`. */
+    relation: zod_1.z.array(zod_1.z.literal(constants_js_1.ASSET_LINKS_RELATION)),
+    /** The app the statement trusts. */
+    target: zod_1.z.object({
+        /** Always `android_app`. */
+        namespace: zod_1.z.literal('android_app'),
+        /** The application id. */
+        package_name: zod_1.z.string(),
+        /** Every trusted fingerprint of that package. */
+        sha256_cert_fingerprints: zod_1.z.array(zod_1.z.string()),
+    }),
+});
+/**
+ * Web Push subscription counts by platform (EvoPath): how many devices the
+ * `android_app` channel can reach.
+ *
+ * @stability experimental
+ */
+exports.androidPushSubscriptionCountsSchema = zod_1.z.object({
+    /** Subscriptions registered from the Android app. */
+    androidApp: zod_1.z.number().int().nonnegative(),
+    /** Every other subscription. */
+    browser: zod_1.z.number().int().nonnegative(),
+    /** Distinct users with at least one Android app subscription. */
+    androidAppUsers: zod_1.z.number().int().nonnegative(),
+});
+/**
+ * `GET`/`PUT /api/admin/android-app`.
+ *
+ * @stability experimental
+ */
+exports.androidAppResponseSchema = zod_1.z.object({
+    /** The trusted pairs. */
+    trustedApps: zod_1.z.array(exports.trustedAndroidAppSchema),
+    /** What paired devices report, trusted or not, most devices first. */
+    reportedApps: zod_1.z.array(exports.reportedAndroidAppSchema),
+    /** The statement list `/.well-known/assetlinks.json` serves now. */
+    assetLinks: zod_1.z.array(exports.assetLinkStatementSchema),
+    /** Push subscription counts by platform. */
+    pushSubscriptions: exports.androidPushSubscriptionCountsSchema,
+});
+const booleanFieldStringSchema = zod_1.z.enum(['true', 'false', '1', '0']);
+const androidAppTestStatusSchema = zod_1.z.enum(constants_js_1.ANDROID_APP_TEST_STATUSES);
+const androidAppTestReasonSchema = zod_1.z.enum(constants_js_1.ANDROID_APP_TEST_REASONS);
+const booleanField = (fallback) => zod_1.z
+    .union([zod_1.z.boolean(), booleanFieldStringSchema])
+    .optional()
+    .transform((value) => (value === undefined ? fallback : value === true || value === 'true' || value === '1'));
+/**
+ * The text fields of a release upload (multipart, so every value arrives as a
+ * string). Strict: an unknown field is refused.
+ *
+ * @stability experimental
+ */
+exports.releaseUploadFieldsSchema = zod_1.z
+    .object({
+    /** The application id inside the APK. */
+    packageName: exports.androidPackageNameSchema,
+    /** The human version (`1.4.0`). */
+    versionName: zod_1.z
+        .string()
+        .trim()
+        .min(1)
+        .max(constants_js_1.MAX_VERSION_NAME_LENGTH)
+        .regex(constants_js_1.VERSION_NAME_PATTERN, 'versionName may contain only letters, digits, ".", "_", "+" and "-"'),
+    /** The monotonically increasing build number Android compares. */
+    versionCode: zod_1.z.coerce.number().int('versionCode must be an integer').min(constants_js_1.MIN_VERSION_CODE).max(constants_js_1.MAX_VERSION_CODE),
+    /** The signing certificate fingerprint of the APK. */
+    signingSha256: zod_1.z.string().trim().pipe(exports.sha256FingerprintSchema),
+    /** Release notes shown to users, or absent. */
+    notes: zod_1.z
+        .string()
+        .trim()
+        .max(constants_js_1.MAX_RELEASE_NOTES_LENGTH)
+        .optional()
+        .transform((value) => (value ? value : null)),
+    /** Offer it to users at once (default `true`). */
+    makeCurrent: booleanField(true),
+    /** Make it current even when its versionCode is not newer (default `false`). */
+    force: booleanField(false),
+    /** Add an untrusted (package, signing key) pair to the trusted list (default `false`). */
+    trust: booleanField(false),
+})
+    .strict();
+/**
+ * What any signed-in user sees of a release (`GET /api/android-app/releases/latest`).
+ *
+ * @stability experimental
+ */
+exports.publicReleaseSchema = zod_1.z.object({
+    /** The release id. */
+    id: zod_1.z.uuid(),
+    /** The application id. */
+    packageName: zod_1.z.string(),
+    /** The human version. */
+    versionName: zod_1.z.string(),
+    /** The build number. */
+    versionCode: zod_1.z.number().int(),
+    /** SHA-256 of the APK bytes (64 lower-case hex digits). */
+    fileSha256: zod_1.z.string(),
+    /** The APK size in bytes, as a decimal string (the column is BigInt). */
+    sizeBytes: zod_1.z.string().regex(/^\d+$/),
+    /** Release notes, or null. */
+    notes: zod_1.z.string().nullable(),
+    /** Upload time (ISO 8601). */
+    createdAt: zod_1.z.iso.datetime(),
+});
+/**
+ * What an administrator sees of a release.
+ *
+ * @stability experimental
+ */
+exports.adminReleaseSchema = exports.publicReleaseSchema.extend({
+    /** The signing certificate fingerprint. */
+    signingSha256: zod_1.z.string(),
+    /** Whether this is the release users are offered. */
+    isCurrent: zod_1.z.boolean(),
+    /** The storage provider the bytes were written to, or null. */
+    storageProvider: zod_1.z.string().nullable(),
+    /** Who uploaded it, or null once that account is gone. */
+    uploadedBy: zod_1.z
+        .object({
+        /** The user id. */
+        id: zod_1.z.uuid(),
+        /** Their email. */
+        email: zod_1.z.string(),
+        /** Their display name, or null. */
+        displayName: zod_1.z.string().nullable(),
+    })
+        .nullable(),
+});
+/**
+ * `POST /api/android-app/releases/:id/download-link`.
+ *
+ * @stability experimental
+ */
+exports.downloadLinkSchema = zod_1.z.object({
+    /** A same-origin URL (`/api/android-app/download/<token>`); never log it. */
+    url: zod_1.z.string(),
+    /** When it stops working (ISO 8601). */
+    expiresAt: zod_1.z.iso.datetime(),
+});
+// ---- test notification ------------------------------------------------------
+/**
+ * `POST /api/admin/android-app/test-notification` body.
+ *
+ * @stability experimental
+ */
+exports.androidAppTestNotificationRequestSchema = zod_1.z
+    .object({
+    /** The user whose Android app subscriptions to push to; default the caller. */
+    userId: zod_1.z.uuid().optional(),
+})
+    .strict();
+/**
+ * One subscription's outcome.
+ *
+ * @stability experimental
+ */
+exports.androidAppTestResultRowSchema = zod_1.z.object({
+    /** The subscription id. */
+    subscriptionId: zod_1.z.uuid(),
+    /** The push service host (never the endpoint: it is a capability URL). */
+    endpointHost: zod_1.z.string(),
+    /** `sent`, `failed` or `gone`. */
+    status: androidAppTestStatusSchema,
+    /** Why it failed, when it did. */
+    error: zod_1.z.string().optional(),
+});
+/**
+ * The test notification response: always 200 for a valid request.
+ *
+ * @stability experimental
+ */
+exports.androidAppTestNotificationResponseSchema = zod_1.z.object({
+    /** The target user. */
+    userId: zod_1.z.uuid(),
+    /** How many Android app subscriptions they hold. */
+    androidSubscriptions: zod_1.z.number().int().nonnegative(),
+    /** One row per subscription pushed to. */
+    results: zod_1.z.array(exports.androidAppTestResultRowSchema),
+    /** Why nothing was sent, when nothing was. */
+    reason: androidAppTestReasonSchema.optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/cjs/android-app/schemas.js.map

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