@sitepong/fastnode 0.2.1 → 0.3.0

package/dist/apple-session-jUzBrql5.d.cts

@@ -0,0 +1,122 @@
+interface AppleSessionConfig {
+    email: string;
+    password: string;
+    onLog?: (msg: string) => void;
+    onPrompt?: (msg: string) => Promise<string>;
+}
+interface ContractMessage {
+    id: string;
+    group: string;
+    subject: string;
+    message: string;
+}
+interface AppleSession {
+    cookies: Record<string, string>;
+    sessionId: string;
+    scnt: string;
+    serviceKey: string;
+    userEmail: string;
+    teamId?: string;
+    pendingAgreements: ContractMessage[];
+}
+/**
+ * State held between beginLogin() and submitTwoFactorCode() — captures
+ * everything needed to resume an in-progress 2FA flow across HTTP requests.
+ * Stored server-side keyed by an opaque session id; never sent to the
+ * browser (the browser only sees the opaque id).
+ */
+interface PendingLogin {
+    cookies: Record<string, string>;
+    sessionId: string;
+    scnt: string;
+    serviceKey: string;
+    userEmail: string;
+}
+/**
+ * Description of the 2FA challenge presented to the user.
+ *
+ * Modern 2FA accounts (the default for everyone) have `kind: "device"` —
+ * Apple pushes the 6-digit code to all the user's trusted Apple devices
+ * (iPhone, Mac, etc.) and the user types it into our wizard. The legacy
+ * `trustedDevices` field is empty in this case; that field only ever
+ * populates for old "two-step verification" accounts which are
+ * essentially extinct.
+ *
+ * `kind: "phone_only"` is reserved for accounts that have no real Apple
+ * devices (Apple's `noTrustedDevices === true` flag) — those accounts
+ * must use SMS to a trusted phone number.
+ *
+ * Either way, the user can opt to receive the code via SMS instead by
+ * picking from `trustedPhoneNumbers` and calling requestSmsCode().
+ */
+interface TwoFactorChallenge {
+    kind: "device" | "phone_only";
+    codeLength: number;
+    trustedPhoneNumbers: {
+        id: number;
+        numberWithDialCode: string;
+        pushMode?: string;
+    }[];
+}
+type BeginLoginResult = {
+    kind: "logged_in";
+    session: AppleSession;
+} | {
+    kind: "needs_2fa";
+    pending: PendingLogin;
+    challenge: TwoFactorChallenge;
+};
+/** Thrown when an Apple Developer Program agreement needs to be accepted */
+declare class ProgramLicenseAgreementError extends Error {
+    agreements: ContractMessage[];
+    constructor(message: string, agreements: ContractMessage[]);
+}
+/**
+ * Check a portal API response for agreement/license errors.
+ * Throws ProgramLicenseAgreementError if detected.
+ * Call this after any portal API call. Mirrors Spaceship::Client#handle_itc_response.
+ */
+declare function checkPortalResponse(body: any, session?: AppleSession): void;
+/**
+ * Step 1 of HTTP-resumable login: do the SIRP exchange and detect whether
+ * 2FA is required. Returns either a fully-established session (no 2FA) or
+ * a pending state + a description of the 2FA challenge.
+ */
+declare function beginLogin(config: {
+    email: string;
+    password: string;
+    onLog?: (msg: string) => void;
+}): Promise<BeginLoginResult>;
+/**
+ * Ask Apple to send an SMS / voice code to the chosen trusted phone.
+ * Used by the wizard's "Send code via text instead" affordance.
+ */
+declare function requestSmsCode(input: {
+    pending: PendingLogin;
+    phoneId: number;
+    mode?: "sms" | "voice";
+}): Promise<void>;
+/**
+ * Step 2 of HTTP-resumable login: submit the 2FA code the user typed.
+ * Returns a fully-established AppleSession on success.
+ *
+ *   source = "device" → 4-digit code from a trusted Apple device
+ *   source = "phone"  → 6-digit code from SMS / push to trusted phone
+ */
+declare function submitTwoFactorCode(rawInput: {
+    pending: PendingLogin;
+    code: string;
+    source: "device" | "phone";
+    phoneId?: number;
+    mode?: "sms" | "voice";
+    onLog?: (msg: string) => void;
+}): Promise<AppleSession>;
+/**
+ * Backward-compatible CLI-style login. Internally uses beginLogin +
+ * submitTwoFactorCode but routes 2FA through the synchronous onPrompt
+ * callback so existing scripts (test-login.ts, test-full-workflow.ts)
+ * keep working.
+ */
+declare function loginWithAppleId(config: AppleSessionConfig): Promise<AppleSession>;
+
+export { type AppleSession as A, type BeginLoginResult as B, type ContractMessage as C, ProgramLicenseAgreementError as P, type TwoFactorChallenge as T, type AppleSessionConfig as a, beginLogin as b, checkPortalResponse as c, type PendingLogin as d, loginWithAppleId as l, requestSmsCode as r, submitTwoFactorCode as s };

package/dist/apple-session-jUzBrql5.d.ts

@@ -0,0 +1,122 @@
+interface AppleSessionConfig {
+    email: string;
+    password: string;
+    onLog?: (msg: string) => void;
+    onPrompt?: (msg: string) => Promise<string>;
+}
+interface ContractMessage {
+    id: string;
+    group: string;
+    subject: string;
+    message: string;
+}
+interface AppleSession {
+    cookies: Record<string, string>;
+    sessionId: string;
+    scnt: string;
+    serviceKey: string;
+    userEmail: string;
+    teamId?: string;
+    pendingAgreements: ContractMessage[];
+}
+/**
+ * State held between beginLogin() and submitTwoFactorCode() — captures
+ * everything needed to resume an in-progress 2FA flow across HTTP requests.
+ * Stored server-side keyed by an opaque session id; never sent to the
+ * browser (the browser only sees the opaque id).
+ */
+interface PendingLogin {
+    cookies: Record<string, string>;
+    sessionId: string;
+    scnt: string;
+    serviceKey: string;
+    userEmail: string;
+}
+/**
+ * Description of the 2FA challenge presented to the user.
+ *
+ * Modern 2FA accounts (the default for everyone) have `kind: "device"` —
+ * Apple pushes the 6-digit code to all the user's trusted Apple devices
+ * (iPhone, Mac, etc.) and the user types it into our wizard. The legacy
+ * `trustedDevices` field is empty in this case; that field only ever
+ * populates for old "two-step verification" accounts which are
+ * essentially extinct.
+ *
+ * `kind: "phone_only"` is reserved for accounts that have no real Apple
+ * devices (Apple's `noTrustedDevices === true` flag) — those accounts
+ * must use SMS to a trusted phone number.
+ *
+ * Either way, the user can opt to receive the code via SMS instead by
+ * picking from `trustedPhoneNumbers` and calling requestSmsCode().
+ */
+interface TwoFactorChallenge {
+    kind: "device" | "phone_only";
+    codeLength: number;
+    trustedPhoneNumbers: {
+        id: number;
+        numberWithDialCode: string;
+        pushMode?: string;
+    }[];
+}
+type BeginLoginResult = {
+    kind: "logged_in";
+    session: AppleSession;
+} | {
+    kind: "needs_2fa";
+    pending: PendingLogin;
+    challenge: TwoFactorChallenge;
+};
+/** Thrown when an Apple Developer Program agreement needs to be accepted */
+declare class ProgramLicenseAgreementError extends Error {
+    agreements: ContractMessage[];
+    constructor(message: string, agreements: ContractMessage[]);
+}
+/**
+ * Check a portal API response for agreement/license errors.
+ * Throws ProgramLicenseAgreementError if detected.
+ * Call this after any portal API call. Mirrors Spaceship::Client#handle_itc_response.
+ */
+declare function checkPortalResponse(body: any, session?: AppleSession): void;
+/**
+ * Step 1 of HTTP-resumable login: do the SIRP exchange and detect whether
+ * 2FA is required. Returns either a fully-established session (no 2FA) or
+ * a pending state + a description of the 2FA challenge.
+ */
+declare function beginLogin(config: {
+    email: string;
+    password: string;
+    onLog?: (msg: string) => void;
+}): Promise<BeginLoginResult>;
+/**
+ * Ask Apple to send an SMS / voice code to the chosen trusted phone.
+ * Used by the wizard's "Send code via text instead" affordance.
+ */
+declare function requestSmsCode(input: {
+    pending: PendingLogin;
+    phoneId: number;
+    mode?: "sms" | "voice";
+}): Promise<void>;
+/**
+ * Step 2 of HTTP-resumable login: submit the 2FA code the user typed.
+ * Returns a fully-established AppleSession on success.
+ *
+ *   source = "device" → 4-digit code from a trusted Apple device
+ *   source = "phone"  → 6-digit code from SMS / push to trusted phone
+ */
+declare function submitTwoFactorCode(rawInput: {
+    pending: PendingLogin;
+    code: string;
+    source: "device" | "phone";
+    phoneId?: number;
+    mode?: "sms" | "voice";
+    onLog?: (msg: string) => void;
+}): Promise<AppleSession>;
+/**
+ * Backward-compatible CLI-style login. Internally uses beginLogin +
+ * submitTwoFactorCode but routes 2FA through the synchronous onPrompt
+ * callback so existing scripts (test-login.ts, test-full-workflow.ts)
+ * keep working.
+ */
+declare function loginWithAppleId(config: AppleSessionConfig): Promise<AppleSession>;
+
+export { type AppleSession as A, type BeginLoginResult as B, type ContractMessage as C, ProgramLicenseAgreementError as P, type TwoFactorChallenge as T, type AppleSessionConfig as a, beginLogin as b, checkPortalResponse as c, type PendingLogin as d, loginWithAppleId as l, requestSmsCode as r, submitTwoFactorCode as s };