@amazon-devices/kepler-system-info 1.0.2

package/dist/SystemInfoModule.d.ts

@@ -0,0 +1,34 @@
+import { ISystemInfo } from "./turbo-modules/interfaces";
+/**
+ * System Information APIs
+ *
+ * The package "@amazon-devices/kepler-system-info" provides interfaces for querying basic
+ * system-level information about the running operating system instance,
+ * including:
+ * - System uptime
+ * - Operating system version and name
+ * - Build information
+ * - System emulation status
+ *
+ * Key interfaces:
+ * - {@link SystemInfoModule}: Entry point for accessing system information.
+ * - {@link ISystemInfo}: Core interface for querying system information.
+ * - {@link IOperatingSystemInfo}: Interface for querying operating system information.
+ * - {@link IBuildInfo}: Interface for querying build-specific information.
+ *
+ * Example usage:
+ * ```ts
+ * import SystemInfoModule from "@amazon-devices/kepler-system-info"
+ * let systemInfo = SystemInfoModule.getSystemInfo();
+ * let uptime = await systemInfo.getUptime();
+ * ```
+ */
+export default class SystemInfoModule {
+    /**
+     * Returns the instance of {@link ISystemInfo} for querying system
+     * information.
+     *
+     * @return instance of {@link ISystemInfo} for querying system information.
+     */
+    static getSystemInfo(): ISystemInfo;
+}

package/dist/SystemInfoModule.js

@@ -0,0 +1,52 @@
+"use strict";
+/*
+ * Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+ *
+ * AMAZON PROPRIETARY/CONFIDENTIAL
+ *
+ * You may not use this file except in compliance with the terms and
+ * conditions set forth in the accompanying LICENSE.TXT file.
+ *
+ * THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+ * DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+ * IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("./turbo-modules/types");
+/**
+ * System Information APIs
+ *
+ * The package "@amazon-devices/kepler-system-info" provides interfaces for querying basic
+ * system-level information about the running operating system instance,
+ * including:
+ * - System uptime
+ * - Operating system version and name
+ * - Build information
+ * - System emulation status
+ *
+ * Key interfaces:
+ * - {@link SystemInfoModule}: Entry point for accessing system information.
+ * - {@link ISystemInfo}: Core interface for querying system information.
+ * - {@link IOperatingSystemInfo}: Interface for querying operating system information.
+ * - {@link IBuildInfo}: Interface for querying build-specific information.
+ *
+ * Example usage:
+ * ```ts
+ * import SystemInfoModule from "@amazon-devices/kepler-system-info"
+ * let systemInfo = SystemInfoModule.getSystemInfo();
+ * let uptime = await systemInfo.getUptime();
+ * ```
+ */
+class SystemInfoModule {
+    /**
+     * Returns the instance of {@link ISystemInfo} for querying system
+     * information.
+     *
+     * @return instance of {@link ISystemInfo} for querying system information.
+     */
+    static getSystemInfo() {
+        return new types_1.SystemInfo();
+    }
+}
+exports.default = SystemInfoModule;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { default as SystemInfoModule } from "./SystemInfoModule";
+export { ISystemInfo } from "./turbo-modules/interfaces";
+export { IOperatingSystemInfo } from "./turbo-modules/interfaces";
+export { IBuildInfo } from "./turbo-modules/interfaces";
+export { RawTimeValue } from "./turbo-modules/types";
+export { RealTimeInstant } from "./turbo-modules/types";
+export { MonotonicDuration } from "./turbo-modules/types";

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonotonicDuration = exports.RealTimeInstant = exports.RawTimeValue = exports.SystemInfoModule = void 0;
+/*
+ * Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+ *
+ * AMAZON PROPRIETARY/CONFIDENTIAL
+ *
+ * You may not use this file except in compliance with the terms and
+ * conditions set forth in the accompanying LICENSE.TXT file.
+ *
+ * THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+ * DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+ * IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+ */
+var SystemInfoModule_1 = require("./SystemInfoModule");
+Object.defineProperty(exports, "SystemInfoModule", { enumerable: true, get: function () { return __importDefault(SystemInfoModule_1).default; } });
+var types_1 = require("./turbo-modules/types");
+Object.defineProperty(exports, "RawTimeValue", { enumerable: true, get: function () { return types_1.RawTimeValue; } });
+var types_2 = require("./turbo-modules/types");
+Object.defineProperty(exports, "RealTimeInstant", { enumerable: true, get: function () { return types_2.RealTimeInstant; } });
+var types_3 = require("./turbo-modules/types");
+Object.defineProperty(exports, "MonotonicDuration", { enumerable: true, get: function () { return types_3.MonotonicDuration; } });

package/dist/kepler/tm-manifest.json

@@ -0,0 +1 @@
+{"schema":1,"fileSets":{"native":[{"arch":"aarch64","variant":"release","directoryPath":"aarch64-release"},{"arch":"armv7","variant":"release","directoryPath":"armv7-release"},{"arch":"x86_64","variant":"release","directoryPath":"x86_64-release"}]}}

package/dist/turbo-modules/NativeSystemInfo.d.ts

@@ -0,0 +1,18 @@
+import { KeplerTurboModule } from "@amazon-devices/keplerscript-turbomodule-api";
+import { MonotonicDuration } from "./types";
+import { RealTimeInstant } from "./types";
+export interface NativeSystemInfo extends KeplerTurboModule {
+    getUptime(): Promise<MonotonicDuration>;
+    isEmulator(): Promise<boolean>;
+    getOsDisplayName(): Promise<string>;
+    getOsCodeName(): Promise<string>;
+    getOsVersion(): Promise<string>;
+    getBuildDisplayName(): Promise<string>;
+    getBuildId(): Promise<string>;
+    getBuildVariant(): Promise<string>;
+    getBuildTimestamp(): Promise<RealTimeInstant>;
+    getBuildTags(): Promise<string[]>;
+    getBuildFingerprint(): Promise<string>;
+}
+declare const _default: NativeSystemInfo;
+export default _default;

package/dist/turbo-modules/NativeSystemInfo.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const keplerscript_turbomodule_api_1 = require("@amazon-devices/keplerscript-turbomodule-api");
+exports.default = keplerscript_turbomodule_api_1.TurboModuleRegistry.getEnforcing("SystemInfo");

package/dist/turbo-modules/interfaces/IBuildInfo.d.ts

@@ -0,0 +1,55 @@
+import { RealTimeInstant } from "../types";
+/**
+ * Operating system build-specific information.
+ */
+export default interface IBuildInfo {
+    /**
+     * Returns the human-readable name of the operating system. The display name
+     * contains one or more properties of the operating system such as the
+     * codename and version separated by a delimiter.
+     *
+     * The display name DOES NOT follow a fixed schema and must be considered
+     * unique string for each OS release.
+     *
+     * For example, "Kepler/1.1".
+     */
+    getDisplayName(): Promise<string>;
+    /**
+     * Returns the ID that uniquely identifies the build within the operating
+     * system.
+     *
+     * For example, "901010150820"
+     */
+    getId(): Promise<string>;
+    /**
+     * Returns the variant representing the set of configurations used at the
+     * build time to determine how to compile and package with specific features
+     * and dependencies.
+     *
+     * For example, "user", "user-external" and more.
+     */
+    getVariant(): Promise<string>;
+    /**
+     * Returns the timestamp of the build.
+     */
+    getTimestamp(): Promise<RealTimeInstant>;
+    /**
+     * Returns the list of tags describing the build.
+     *
+     * For example, "release-keys", "dev-keys" and more.
+     */
+    getTags(): Promise<string[]>;
+    /**
+     * Returns the fingerprint string which uniquely identifies the build across
+     * devices and operating systems. It may contain one or more pieces of
+     * information such as device manufacturer, product, build id, variant, tags
+     * and more in the future separated by a delimiter.
+     *
+     * The fingerprint DOES NOT follow a fixed schema and must be considered
+     * unique string for each OS release.
+     *
+     * For example,
+     * "Amazon/kepler/901010150820/4.0.96525.0(3072cab629675a74)/1508N:user/release-keys"
+     */
+    getFingerprint(): Promise<string>;
+}

package/dist/turbo-modules/interfaces/IBuildInfo.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/turbo-modules/interfaces/IOperatingSystemInfo.d.ts

@@ -0,0 +1,41 @@
+import IBuildInfo from "./IBuildInfo";
+/**
+ * Operating System information.
+ */
+export default interface IOperatingSystemInfo {
+    /**
+     * Returns the human-readable, localized name of the operating system.
+     *
+     * The returned name is localized according to the following precedence:
+     * 1. User's locale preferences
+     * 2. System default locale
+     * 3. Static codename as fallback if localization is unavailable
+     *
+     * For example,
+     * ```
+     * "Kepler" (en-US)
+     * "केपलर" (hi-IN)
+     * ```
+     */
+    getDisplayName(): Promise<string>;
+    /**
+     * Returns the static codename of the operating system.
+     *
+     * For example, "Kepler".
+     */
+    getCodeName(): Promise<string>;
+    /**
+     * Returns the version identifier of the operating system.
+     *
+     * For example, "1.1".
+     *
+     * The version string DOES NOT follow a fixed schema and must be considered
+     * unique string for each OS release.
+     */
+    getVersion(): Promise<string>;
+    /**
+     * Returns the instance of {@link IBuildInfo} for querying operating system build
+     * information.
+     */
+    getBuildInfo(): IBuildInfo;
+}

package/dist/turbo-modules/interfaces/IOperatingSystemInfo.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/turbo-modules/interfaces/ISystemInfo.d.ts

@@ -0,0 +1,25 @@
+import IOperatingSystemInfo from "./IOperatingSystemInfo";
+import { MonotonicDuration } from "../types";
+/**
+ * Core interface for querying system information.
+ */
+export default interface ISystemInfo {
+    /**
+     * Returns the duration since the system was last booted.
+     */
+    getUptime(): Promise<MonotonicDuration>;
+    /**
+     * Returns `true` if the system is running in a virtualized environment rather
+     * than on real hardware.
+     *
+     * The term “Emulator” is used as a general term to
+     * include both emulators and simulators, so this property returns true for
+     * any non-physical device, regardless of the platform.
+     */
+    isEmulator(): Promise<boolean>;
+    /**
+     * Returns the instance of {@link IOperatingSystemInfo} for querying operating system
+     * information.
+     */
+    getOperatingSystemInfo(): IOperatingSystemInfo;
+}

package/dist/turbo-modules/interfaces/ISystemInfo.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/turbo-modules/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ISystemInfo } from "./ISystemInfo";
+export { default as IOperatingSystemInfo } from "./IOperatingSystemInfo";
+export { default as IBuildInfo } from "./IBuildInfo";

package/dist/turbo-modules/interfaces/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/turbo-modules/types/BuildInfo.d.ts

@@ -0,0 +1,10 @@
+import IBuildInfo from '../interfaces/IBuildInfo';
+import RealTimeInstant from './RealTimeInstant';
+export default class BuildInfo implements IBuildInfo {
+    getDisplayName(): Promise<string>;
+    getId(): Promise<string>;
+    getVariant(): Promise<string>;
+    getTimestamp(): Promise<RealTimeInstant>;
+    getTags(): Promise<string[]>;
+    getFingerprint(): Promise<string>;
+}

package/dist/turbo-modules/types/BuildInfo.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const NativeSystemInfo_1 = __importDefault(require("../NativeSystemInfo"));
+if (!NativeSystemInfo_1.default) {
+    throw new Error('System info is unavailable');
+}
+class BuildInfo {
+    async getDisplayName() {
+        return NativeSystemInfo_1.default.getBuildDisplayName();
+    }
+    async getId() {
+        return NativeSystemInfo_1.default.getBuildId();
+    }
+    async getVariant() {
+        return NativeSystemInfo_1.default.getBuildVariant();
+    }
+    async getTimestamp() {
+        return NativeSystemInfo_1.default.getBuildTimestamp();
+    }
+    async getTags() {
+        return NativeSystemInfo_1.default.getBuildTags();
+    }
+    async getFingerprint() {
+        return NativeSystemInfo_1.default.getBuildFingerprint();
+    }
+}
+exports.default = BuildInfo;

package/dist/turbo-modules/types/MonotonicDuration.d.ts

@@ -0,0 +1,10 @@
+import RawTimeValue from './RawTimeValue';
+/**
+ * Represents a span of time. This type follows ISO 8601 Duration definition.
+ * This type is typically used for system timeouts and can be a result of
+ * comparison operations between two instances of `MonotonicInstant`.
+ */
+export default class MonotonicDuration {
+    time: RawTimeValue;
+    constructor(time: RawTimeValue);
+}

package/dist/turbo-modules/types/MonotonicDuration.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Represents a span of time. This type follows ISO 8601 Duration definition.
+ * This type is typically used for system timeouts and can be a result of
+ * comparison operations between two instances of `MonotonicInstant`.
+ */
+class MonotonicDuration {
+    time;
+    constructor(time) {
+        this.time = time;
+    }
+}
+exports.default = MonotonicDuration;

package/dist/turbo-modules/types/OperatingSystemInfo.d.ts

@@ -0,0 +1,8 @@
+import IOperatingSystemInfo from "../interfaces/IOperatingSystemInfo";
+import IBuildInfo from "../interfaces/IBuildInfo";
+export default class OperatingSystemInfo implements IOperatingSystemInfo {
+    getDisplayName(): Promise<string>;
+    getCodeName(): Promise<string>;
+    getVersion(): Promise<string>;
+    getBuildInfo(): IBuildInfo;
+}

package/dist/turbo-modules/types/OperatingSystemInfo.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BuildInfo_1 = __importDefault(require("./BuildInfo"));
+const NativeSystemInfo_1 = __importDefault(require("../NativeSystemInfo"));
+if (!NativeSystemInfo_1.default) {
+    throw new Error("System info is unavailable");
+}
+class OperatingSystemInfo {
+    async getDisplayName() {
+        return NativeSystemInfo_1.default.getOsDisplayName();
+    }
+    async getCodeName() {
+        return NativeSystemInfo_1.default.getOsCodeName();
+    }
+    async getVersion() {
+        return NativeSystemInfo_1.default.getOsVersion();
+    }
+    getBuildInfo() {
+        return new BuildInfo_1.default();
+    }
+}
+exports.default = OperatingSystemInfo;

package/dist/turbo-modules/types/RawTimeValue.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A basic type used to describe both absolute and relative time.
+ */
+export default class RawTimeValue {
+    seconds: number;
+    nanoseconds: number;
+    constructor(seconds: number, nanoseconds: number);
+}

package/dist/turbo-modules/types/RawTimeValue.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A basic type used to describe both absolute and relative time.
+ */
+class RawTimeValue {
+    seconds;
+    nanoseconds;
+    constructor(seconds, nanoseconds) {
+        this.seconds = seconds;
+        this.nanoseconds = nanoseconds;
+    }
+}
+exports.default = RawTimeValue;

package/dist/turbo-modules/types/RealTimeInstant.d.ts

@@ -0,0 +1,10 @@
+import RawTimeValue from './RawTimeValue';
+/**
+ * Represents a point in time in the system's clock.  Useful for
+ * talking to external entities like the file system or
+ * other processes.
+ */
+export default class RealTimeInstant {
+    time: RawTimeValue;
+    constructor(time: RawTimeValue);
+}

package/dist/turbo-modules/types/RealTimeInstant.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Represents a point in time in the system's clock.  Useful for
+ * talking to external entities like the file system or
+ * other processes.
+ */
+class RealTimeInstant {
+    time;
+    constructor(time) {
+        this.time = time;
+    }
+}
+exports.default = RealTimeInstant;

package/dist/turbo-modules/types/SystemInfo.d.ts

@@ -0,0 +1,8 @@
+import ISystemInfo from "../interfaces/ISystemInfo";
+import IOperatingSystemInfo from "../interfaces/IOperatingSystemInfo";
+import MonotonicDuration from "./MonotonicDuration";
+export default class SystemInfo implements ISystemInfo {
+    getUptime(): Promise<MonotonicDuration>;
+    isEmulator(): Promise<boolean>;
+    getOperatingSystemInfo(): IOperatingSystemInfo;
+}

package/dist/turbo-modules/types/SystemInfo.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const NativeSystemInfo_1 = __importDefault(require("../NativeSystemInfo"));
+const OperatingSystemInfo_1 = __importDefault(require("./OperatingSystemInfo"));
+if (!NativeSystemInfo_1.default) {
+    throw new Error("System info is unavailable");
+}
+class SystemInfo {
+    async getUptime() {
+        return NativeSystemInfo_1.default.getUptime();
+    }
+    async isEmulator() {
+        return NativeSystemInfo_1.default.isEmulator();
+    }
+    getOperatingSystemInfo() {
+        return new OperatingSystemInfo_1.default();
+    }
+}
+exports.default = SystemInfo;

package/dist/turbo-modules/types/index.d.ts

@@ -0,0 +1,4 @@
+export { default as SystemInfo } from './SystemInfo';
+export { default as RawTimeValue } from './RawTimeValue';
+export { default as RealTimeInstant } from './RealTimeInstant';
+export { default as MonotonicDuration } from './MonotonicDuration';

package/dist/turbo-modules/types/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonotonicDuration = exports.RealTimeInstant = exports.RawTimeValue = exports.SystemInfo = void 0;
+var SystemInfo_1 = require("./SystemInfo");
+Object.defineProperty(exports, "SystemInfo", { enumerable: true, get: function () { return __importDefault(SystemInfo_1).default; } });
+var RawTimeValue_1 = require("./RawTimeValue");
+Object.defineProperty(exports, "RawTimeValue", { enumerable: true, get: function () { return __importDefault(RawTimeValue_1).default; } });
+var RealTimeInstant_1 = require("./RealTimeInstant");
+Object.defineProperty(exports, "RealTimeInstant", { enumerable: true, get: function () { return __importDefault(RealTimeInstant_1).default; } });
+var MonotonicDuration_1 = require("./MonotonicDuration");
+Object.defineProperty(exports, "MonotonicDuration", { enumerable: true, get: function () { return __importDefault(MonotonicDuration_1).default; } });

package/kepler-compatibility.json

@@ -0,0 +1,6 @@
+{
+  "versions": {
+    "1.0.1": "/com.amazon.kepler.kepler_system_info_1@IKeplerSystemInfo_0",
+    "1.0.2": "/com.amazon.kepler.kepler_system_info_1@IKeplerSystemInfo_0"
+  }
+}

package/kepler-transformed-package-info.json

@@ -0,0 +1,3 @@
+{
+  "sourcePackageRef": "@amzn/kepler-system-info"
+}

package/package.json

@@ -0,0 +1 @@
+{"name": "@amazon-devices/kepler-system-info", "version": "1.0.2", "main": "dist/index.js", "types": "dist/index.d.ts", "files": ["dist", "react-native.config.js", "kepler-compatibility.json", "SystemModules", "SystemBundles", "THIRD_PARTY_NOTICES.txt", "kepler-transformed-package-info.json"], "scripts": {"clean": "rm -rf node_modules buildinfo.json dist bvm build", "build:js": "tsc -p tsconfig.json", "build:native:debug": "kepler build -b Debug", "build:native:release": "kepler build -b Release", "build": "npm-run-all build:js build:native:release", "build:debug": "npm-run-all build:js build:native:debug", "prepublishOnly": "KEPLER_NPM_COMMAND=npm-pretty-much react-native build-system-bundle-kepler"}, "dependencies": {"@amazon-devices/keplerscript-turbomodule-api": "^1.0.0"}, "devDependencies": {"@react-native/eslint-config": "0.72.2", "@types/jest": "^28.0.0", "@typescript-eslint/eslint-plugin": "^5.30.0", "babel-jest": "^28.0.0", "eslint": "^8.12.0", "jest": "^28.0.0", "metro-react-native-babel-preset": "^0.76.5", "npm-run-all": "^4.1.5", "prettier": "^2.6.2", "ts-jest": "^28.0.0", "typescript": "4.8.4", "@amazon-devices/kepler-cli-platform": "^0", "@react-native-community/cli": "^11.2.0"}, "kepler": {"projectType": "turbomodule", "targets": ["tv"], "features": ["vega"], "api": 0.1}, "license": "See license in LICENSE"}

package/react-native.config.js

@@ -0,0 +1,17 @@
+module.exports = {
+    dependency: {
+        platforms: {
+            kepler: {
+                autolink: {
+                    keplersysteminfo: {
+                        libraryName: 'libKeplerSystemInfoTM.so.1',
+                        linkDynamic: true,
+                        provider: 'custom',
+                        components: [],
+                        turbomodules: ['SystemInfo'],
+                    },
+                },
+            },
+        },
+    },
+};