integration.app-store-connect
Read-first App Store Connect API integration for ReviewReady app submission readiness, with deterministic mocks and secret-ref-only credentials.
@lssm-tech/integration.app-store-connectbun add @lssm-tech/integration.app-store-connectManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Read-first App Store Connect integration for ReviewReady app submission readiness. It maps supported metadata reads to the ContractSpec provider capability registry and returns typed capability results for everything the official API does not safely expose.
Safety policy
- Read-first / write-disabled. The port exposes no write/update operations. Provider writes are out of scope for this package.
- Mock-by-default. Tests and CI use
createMockAppStoreConnectClient, which performs no network access and is fully deterministic (injected clock + ids). - Live calls are opt-in.
createAppStoreConnectClientonly attempts live access whenenableLiveCallsis true, secret-ref auth is present, and a secret resolver is supplied. Otherwise reads return typeddegradedresults. - No faked data. Fields the API cannot supply (e.g. App Privacy answers) return a typed
manual-required/unsupported/degradedcapability result, never a silent success.
Secret handling
Auth config carries secret references only (privateKeySecretRefId). Raw .p8 private keys, JWTs, and headers are never accepted as config fields, and never appear in snapshots, logs, or fixtures. Log entries record only provider, operation, status, correlationId, and capabilityId.
Usage
import { createMockAppStoreConnectClient } from "@lssm-tech/integration.app-store-connect";
const client = createMockAppStoreConnectClient({
now: "2026-06-07T12:00:00.000Z",
correlationId: "corr-001",
});
const metadata = await client.getAppMetadata({ appId: "1234567890" });
const privacy = await client.getAppPrivacyAnswers({ appId: "1234567890" });
// privacy.status === "manual-required"Source: https://developer.apple.com/documentation/appstoreconnectapi/
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
1 declarations
@lssm-tech/lib.app-submission-readiness-runtimeworkspace:^
Read the package manual ↗
Declared capabilities
Read-first App Store Connect API integration for ReviewReady app submission readiness, with deterministic mocks and secret-ref-only credentials.
Scripts
buildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolint:checknode ../../../scripts/biome.cjs check .lint:fixnode ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit