sitevision-cli 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/utils/i18n.js

@@ -0,0 +1,279 @@
+export const LANGUAGES = ['en', 'sv'];
+export const LANGUAGE_NAMES = {
+    en: 'English',
+    sv: 'Svenska',
+};
+let current = 'en';
+export function getLanguage() {
+    return current;
+}
+export function setLanguage(language) {
+    current = language;
+}
+export function t(text, vars) {
+    let out = current === 'sv' ? (sv[text] ?? text) : text;
+    if (vars) {
+        for (const [name, value] of Object.entries(vars)) {
+            out = out.split(`{${name}}`).join(String(value));
+        }
+    }
+    return out;
+}
+const sv = {
+    // Frame
+    APP: 'APP',
+    'WORKSPACE {n} apps': 'ARBETSYTA {n} appar',
+    'WORKSPACE 1 app': 'ARBETSYTA 1 app',
+    '{arrow} {n} more': '{arrow} {n} till',
+    'deps·config·sync·signing': 'beroenden·konfig·synk·sign',
+    'Workspace settings': 'Arbetsyteinställningar',
+    TASKS: 'UPPGIFTER',
+    // Tabs
+    Overview: 'Översikt',
+    Config: 'Konfig',
+    Versions: 'Versioner',
+    Log: 'Logg',
+    Ovw: 'Övs',
+    Cfg: 'Kfg',
+    Ver: 'Ver',
+    id: 'id',
+    version: 'version',
+    type: 'typ',
+    addon: 'tillägg',
+    site: 'webbplats',
+    domain: 'domän',
+    auth: 'auth',
+    'signing user': 'signeringsanv.',
+    'not set': 'ej satt',
+    '↑ root': '↑ rot',
+    ' · bundled': ' · paketerad',
+    deps: 'beroenden',
+    config: 'konfig',
+    sync: 'synk',
+    signing: 'signering',
+    scripts: 'scripts',
+    'missing · i to install': 'saknas · i för att installera',
+    'not installed · i to install': 'ej installerat · i för att installera',
+    'dev properties': 'dev-egenskaper',
+    'missing · e to edit': 'saknas · e för att redigera',
+    '{n} diffs · y to apply': '{n} skillnader · y för att tillämpa',
+    '1 diff · y to apply': '1 skillnad · y för att tillämpa',
+    'missing · / set up signing': 'saknas · / konfigurera signering',
+    'not installed': 'ej installerat',
+    '⚠ plaintext password in .dev_properties.json · / migrate': '⚠ lösenord i klartext i .dev_properties.json · / migrera',
+    RECENT: 'SENASTE',
+    '⚠ Configure dev properties first (e).': '⚠ Konfigurera dev-egenskaper först (e).',
+    'Press R to fetch versions from {domain}.': 'Tryck R för att hämta versioner från {domain}.',
+    'APP IDENTIFIER': 'APP-ID',
+    VERSION: 'VERSION',
+    ACTIVE: 'AKTIV',
+    'No versions uploaded to {addon}.': 'Inga versioner uppladdade till {addon}.',
+    '{n} versions · a activate selected · R refresh': '{n} versioner · a aktivera vald · R uppdatera',
+    '1 version · a activate selected · R refresh': '1 version · a aktivera vald · R uppdatera',
+    ' · fetched {time}': ' · hämtad {time}',
+    'No task yet. d dev · w watch · b build · s sign · p deploy': 'Ingen uppgift ännu. d dev · w watch · b build · s sign · p deploy',
+    ' · following': ' · följer',
+    // Palette
+    SETUP: 'INSTÄLLNINGAR',
+    AUTH: 'AUTH',
+    Commands: 'Kommandon',
+    '{n} actions': '{n} åtgärder',
+    'type to filter · ↑↓ move · Enter run · Esc close': 'skriv för att filtrera · ↑↓ flytta · Enter kör · Esc stäng',
+    // Addon picker
+    'Addon Repository': 'Tilläggsförråd',
+    '{n} of {m}': '{n} av {m}',
+    'fetching addons': 'hämtar tillägg',
+    '↑↓ move · Enter select · Esc cancel': '↑↓ flytta · Enter välj · Esc avbryt',
+    // Actions
+    Dev: 'Dev',
+    Watch: 'Watch',
+    Build: 'Build',
+    Sign: 'Sign',
+    Deploy: 'Driftsätt',
+    'Deploy (force)': 'Driftsätt (tvinga)',
+    'to {env}': 'till {env}',
+    'Switch environment': 'Byt miljö',
+    'Add environment': 'Lägg till miljö',
+    'e.g. test or prod, overriding domain and auth': 't.ex. test eller prod, med egen domän och auth',
+    'Environment name (e.g. test, prod)': 'Miljönamn (t.ex. test, prod)',
+    'Deploy the signed {id} to {env} and activate it?': 'Driftsätt signerade {id} till {env} och aktivera?',
+    'Dev never deploys to a production environment ({env}). Switch with E.': 'Dev driftsätter aldrig till en produktionsmiljö ({env}). Byt med E.',
+    'switched to {env}': 'bytte till {env}',
+    'environment {env} added': 'miljön {env} tillagd',
+    environment: 'miljö',
+    production: 'produktion',
+    env: 'miljö',
+    '↑ dev': '↑ dev',
+    'Activate a remote version': 'Aktivera en fjärrversion',
+    'Stop running task': 'Stoppa pågående uppgift',
+    'Edit config': 'Redigera konfig',
+    'Sync package.json': 'Synka package.json',
+    'Migrate password to OS keychain': 'Flytta lösenord till nyckelringen',
+    'Install dependencies': 'Installera beroenden',
+    'Log in': 'Logga in',
+    'Log out': 'Logga ut',
+    Quit: 'Avsluta',
+    Settings: 'Inställningar',
+    'build, sign and deploy on change': 'bygg, signera och driftsätt vid ändring',
+    'build and deploy on change': 'bygg och driftsätt vid ändring',
+    'rebuild and sign only': 'bara bygg om och signera',
+    'rebuild only': 'bara bygg om',
+    'credentials missing': 'uppgifter saknas',
+    'signed zip · confirms first': 'signerad zip · bekräftar först',
+    'shared auth and site config for every app': 'delad auth och webbplatskonfig för alla appar',
+    'dev properties, auth method, signing': 'dev-egenskaper, auth-metod, signering',
+    '{n} diffs': '{n} skillnader',
+    '1 diff': '1 skillnad',
+    'in sync': 'synkad',
+    'forget stored credentials for this site': 'glöm sparade uppgifter för webbplatsen',
+    'language, intro animation, workspace config': 'språk, introanimation, arbetsytans konfig',
+    'Workspace config': 'Arbetsytans konfig',
+    'not configured': 'ej konfigurerad',
+    'basic · password needed': 'basic · lösenord krävs',
+    'oauth2 · not logged in': 'oauth2 · ej inloggad',
+    'sso · not logged in': 'sso · ej inloggad',
+    'Dev properties not configured. Edit config first.': 'Dev-egenskaper ej konfigurerade. Redigera konfig först.',
+    'Deploy password for {user}@{domain}': 'Driftsättningslösenord för {user}@{domain}',
+    'Save to OS keychain': 'Spara i nyckelringen',
+    'Signing credentials not configured.': 'Signeringsuppgifter ej konfigurerade.',
+    'Signing password for {user} (developer.sitevision.se)': 'Signeringslösenord för {user} (developer.sitevision.se)',
+    'A dev/watch task is already running for this app (K stops it).': 'En dev/watch-uppgift körs redan för appen (K stoppar den).',
+    'stopped {n} task(s)': 'stoppade {n} uppgift(er)',
+    'nothing running': 'inget körs',
+    'Not in a workspace: run svc at the repo root.': 'Ingen arbetsyta: kör svc i repots rot.',
+    'package.json updated': 'package.json uppdaterad',
+    'password moved to keychain': 'lösenord flyttat till nyckelringen',
+    'could not access keychain': 'kunde inte nå nyckelringen',
+    'logged in': 'inloggad',
+    'credentials removed': 'uppgifter borttagna',
+    // Config form
+    Domain: 'Domän',
+    'Site name': 'Webbplatsnamn',
+    'Addon name': 'Tilläggsnamn',
+    Username: 'Användarnamn',
+    'Auth method': 'Auth-metod',
+    Password: 'Lösenord',
+    'OAuth2 client id': 'OAuth2 klient-id',
+    'Authorization endpoint': 'Auktoriseringsendpoint',
+    'Token endpoint': 'Token-endpoint',
+    Scopes: 'Scopes',
+    'Client secret': 'Klienthemlighet',
+    'Login URL': 'Inloggnings-URL',
+    'Use HTTP': 'Använd HTTP',
+    'Signing user': 'Signeringsanvändare',
+    Certificate: 'Certifikat',
+    'Signing password': 'Signeringslösenord',
+    '^O pick from repo': '^O välj från förråd',
+    'Space-separated scopes to request. ALL grants the Sitevision API and offline_access adds a refresh token so later runs log in silently. Match the casing your client expects.': 'Scopes att begära, separerade med mellanslag. ALL ger Sitevision-API:et och offline_access ger en refresh-token så att senare körningar loggar in tyst. Använd det skiftläge klienten förväntar sig.',
+    'blank = site root': 'tomt = webbplatsens rot',
+    'required for signed deploys': 'krävs för signerad driftsättning',
+    'blank = prompt each run': 'tomt = fråga varje gång',
+    SIGNING: 'SIGNERING',
+    ENVIRONMENT: 'MILJÖ',
+    'Environment name': 'Miljönamn',
+    Production: 'Produktion',
+    'What this base configuration is: dev, test, prod… Other environments are added on top of it with E or the palette and override only what differs.': 'Vad denna grundkonfiguration är: dev, test, prod… Andra miljöer läggs ovanpå med E eller paletten och skriver bara över det som skiljer.',
+    'Treat deploys to this base environment as production: signed zip, confirmation, activation, and no dev loop. Off by default even when the name says prod, so a repo with only a production site still gets a dev loop.': 'Behandla driftsättningar till grundmiljön som produktion: signerad zip, bekräftelse, aktivering och ingen dev-loop. Av som standard även om namnet säger prod, så att ett repo med bara en produktionssajt ändå får en dev-loop.',
+    'Saved {label}.': 'Sparade {label}.',
+    'Looking up OAuth2 endpoints…': 'Slår upp OAuth2-endpoints…',
+    'Endpoints filled from the site OpenID config.': 'Endpoints ifyllda från webbplatsens OpenID-konfig.',
+    'Could not discover OAuth2 endpoints; enter them by hand.': 'Kunde inte hitta OAuth2-endpoints; ange dem manuellt.',
+    '✗ required': '✗ krävs',
+    keychain: 'nyckelring',
+    local: 'lokal',
+    '•••••••• keychain': '•••••••• nyckelring',
+    FIELD: 'FÄLT',
+    VALUE: 'VÄRDE',
+    SOURCE: 'KÄLLA',
+    "Shared by every app below {root}. An app's own value wins.": 'Delas av alla appar under {root}. Appens eget värde vinner.',
+    'PACKAGE.JSON SYNC': 'PACKAGE.JSON-SYNK',
+    'no workspace package.json · y to set up': 'ingen package.json i arbetsytan · y för att skapa',
+    'Not saved: {error}': 'Inte sparat: {error}',
+    '←→ choose · Enter confirm · Esc cancel': '←→ välj · Enter bekräfta · Esc avbryt',
+    'Enter save · Esc cancel': 'Enter spara · Esc avbryt',
+    '↑↓ field · Enter edit · ^O pick addon': '↑↓ fält · Enter redigera · ^O välj tillägg',
+    '↑↓ field · Enter edit': '↑↓ fält · Enter redigera',
+    'Tab to edit': 'Tab för att redigera',
+    yes: 'ja',
+    no: 'nej',
+    // Shell
+    workspace: 'arbetsyta',
+    settings: 'inställningar',
+    save: 'spara',
+    cancel: 'avbryt',
+    field: 'fält',
+    edit: 'redigera',
+    back: 'tillbaka',
+    quit: 'avsluta',
+    search: 'sök',
+    move: 'flytta',
+    select: 'välj',
+    clear: 'rensa',
+    'no matches': 'inga träffar',
+    '{n} matches': '{n} träffar',
+    '1 match': '1 träff',
+    'edit settings': 'redigera inställningar',
+    apps: 'appar',
+    activate: 'aktivera',
+    refresh: 'uppdatera',
+    deploy: 'driftsätt',
+    commands: 'kommandon',
+    follow: 'följ',
+    wrap: 'radbryt',
+    stop: 'stoppa',
+    'pick addon': 'välj tillägg',
+    login: 'logga in',
+    install: 'installera',
+    '{v} is already active': '{v} är redan aktiv',
+    '{v} activated': '{v} aktiverad',
+    'No credentials.': 'Inga uppgifter.',
+    'not available': 'ej tillgänglig',
+    '{n} tasks': '{n} uppgifter',
+    idle: 'inaktiv',
+    'workspace config saved': 'arbetsytans konfig sparad',
+    'config saved': 'konfig sparad',
+    'Saved {label} as {value} — a domain is a host only.': 'Sparade {label} som {value} — en domän är enbart ett värdnamn.',
+    ' · shared .dev_properties.json at the root': ' · delad .dev_properties.json i roten',
+    ' · new workspace: fill in once, every app inherits · Esc skips': ' · ny arbetsyta: fyll i en gång, alla appar ärver · Esc hoppar över',
+    'y confirm · n cancel': 'y bekräfta · n avbryt',
+    // Config help
+    "Domain of this environment's site (USE or TSE) without https://, e.g. myorg-use.sitevision-cloud.se. Deploys and version lookups go here.": 'Domän för den här miljöns webbplats (USE eller TSE) utan https://, t.ex. myorg-use.sitevision-cloud.se. Driftsättningar och versionslistor går hit.',
+    "Name of the site's root node in Sitevision, exactly as shown in the site tree. It becomes part of the REST API path.": 'Namnet på webbplatsens rotnod i Sitevision, exakt som i webbplatsträdet. Det blir en del av REST API-sökvägen.',
+    "Name of the addon (custom module) in the site's Addon Repository that this app is uploaded into. Ctrl+O lists the existing ones.": 'Namnet på tillägget (custom module) i webbplatsens tilläggsförråd som appen laddas upp till. Ctrl+O listar befintliga.',
+    'Sitevision account used for deploys, usually your Sitevision Cloud e-mail. It needs DEVELOPER or MANAGE_ADDONS permission on the site. Required for basic auth; with oauth2 or cookie it only labels the stored credential.': 'Sitevision-konto som används för driftsättning, oftast din Sitevision Cloud-e-post. Behöver DEVELOPER eller MANAGE_ADDONS på webbplatsen. Krävs för basic; med oauth2 eller cookie används det bara för att märka den sparade inloggningen.',
+    "How deploys authenticate: basic = username and password; oauth2 = bearer token from the site's OAuth2 provider (PKCE, opens a browser); cookie = reuse a browser SSO/SAML session.": 'Hur driftsättningar autentiseras: basic = användarnamn och lösenord; oauth2 = bearer-token från webbplatsens OAuth2-provider (PKCE, öppnar webbläsare); cookie = återanvänd en SSO/SAML-session från webbläsaren.',
+    'Deploy password for the account above. Stored in the OS keychain, never in a file. Leave empty to be asked on each run.': 'Driftsättningslösenord för kontot ovan. Sparas i nyckelringen, aldrig i en fil. Lämna tomt för att bli tillfrågad varje gång.',
+    'Client id of the OAuth2 client registered on the site. Its redirect URI must be http://127.0.0.1:8137/callback.': 'Klient-id för OAuth2-klienten som är registrerad på webbplatsen. Dess redirect-URI måste vara http://127.0.0.1:8137/callback.',
+    "The provider's authorization URL. Filled in from the site's OpenID configuration when it can be discovered.": 'Providerns auktoriserings-URL. Fylls i från webbplatsens OpenID-konfiguration när den kan hittas.',
+    "The provider's token URL. Filled in from the site's OpenID configuration when it can be discovered.": 'Providerns token-URL. Fylls i från webbplatsens OpenID-konfiguration när den kan hittas.',
+    'Secret of a confidential OAuth2 client, stored in the OS keychain. Leave empty for a public client.': 'Hemlighet för en konfidentiell OAuth2-klient, sparas i nyckelringen. Lämna tomt för en publik klient.',
+    'Page opened in the browser for the SSO login. Leave empty to use the site root.': 'Sida som öppnas i webbläsaren för SSO-inloggning. Tomt = webbplatsens rot.',
+    'Use plain HTTP instead of HTTPS for deploys. Only for local or test servers without TLS.': 'Använd HTTP i stället för HTTPS vid driftsättning. Bara för lokala servrar eller testservrar utan TLS.',
+    'Your developer.sitevision.se account. Production deploys need the app signed by it.': 'Ditt konto på developer.sitevision.se. Produktionsdriftsättningar kräver att appen är signerad av det.',
+    'Which certificate to sign with when your developer account has several. Leave empty for the default.': 'Vilket certifikat som ska signera när utvecklarkontot har flera. Tomt = standard.',
+    'Password for the signing account, stored in the OS keychain. Leave empty to be asked on each run.': 'Lösenord för signeringskontot, sparas i nyckelringen. Lämna tomt för att bli tillfrågad varje gång.',
+    // Settings screen
+    Language: 'Språk',
+    'Intro animation': 'Introanimation',
+    on: 'på',
+    off: 'av',
+    'Saved.': 'Sparat.',
+    'stored in {file}': 'sparas i {file}',
+    '↑↓ setting · Enter edit · Esc close': '↑↓ inställning · Enter redigera · Esc stäng',
+    // Password prompt / login
+    'Press Enter to submit, Esc to cancel': 'Tryck Enter för att skicka, Esc för att avbryta',
+    '(Tab to toggle)': '(Tab växlar)',
+    'OAuth2 login': 'OAuth2-inloggning',
+    'Session cookie login': 'Sessionskaka-inloggning',
+    'Waiting for you to finish login in the browser…': 'Väntar på att du loggar in i webbläsaren…',
+    "If the browser didn't open, visit:": 'Om webbläsaren inte öppnades, gå till:',
+    'Opening browser…': 'Öppnar webbläsare…',
+    'Log in in the opened browser, then press Enter to capture the session.': 'Logga in i webbläsaren och tryck sedan Enter för att fånga sessionen.',
+    'Capturing session…': 'Fångar session…',
+    'A Chrome window is open at:': 'Ett Chrome-fönster är öppet på:',
+    '1. Log in to the site there, single sign-on included.': '1. Logga in på webbplatsen där, även med enkel inloggning.',
+    '2. Wait until the site itself has finished loading.': '2. Vänta tills själva webbplatsen har laddat klart.',
+    '3. Come back here and press Enter.': '3. Kom tillbaka hit och tryck Enter.',
+    'Leave the browser window open; it closes once the session is captured.': 'Låt webbläsarfönstret vara öppet; det stängs när sessionen har hämtats.',
+    'Press Esc to cancel.': 'Tryck Esc för att avbryta.',
+};

package/dist/utils/jsonc.d.ts

@@ -0,0 +1,19 @@
+/**
+ * JSONC helpers.
+ *
+ * Sitevision's own manifest documentation shows manifest.json with line and
+ * block comments (e.g. `"name": { // Multilingual-manifest requires SV 10.1`),
+ * so real-world manifests copied from the docs contain them. Strict JSON.parse
+ * rejects those, so we strip comments before parsing.
+ */
+/**
+ * Remove line comments (//...) and block comments from a JSON string, leaving
+ * everything inside string literals untouched (so values like
+ * `"https://example.com"` survive).
+ */
+export declare function stripJsonComments(input: string): string;
+/**
+ * Parse a JSON string that may contain comments (JSONC). Throws the underlying
+ * SyntaxError if the content is invalid even after comments are removed.
+ */
+export declare function parseJsonc<T>(input: string): T;

package/dist/utils/jsonc.js

@@ -0,0 +1,74 @@
+/**
+ * JSONC helpers.
+ *
+ * Sitevision's own manifest documentation shows manifest.json with line and
+ * block comments (e.g. `"name": { // Multilingual-manifest requires SV 10.1`),
+ * so real-world manifests copied from the docs contain them. Strict JSON.parse
+ * rejects those, so we strip comments before parsing.
+ */
+/**
+ * Remove line comments (//...) and block comments from a JSON string, leaving
+ * everything inside string literals untouched (so values like
+ * `"https://example.com"` survive).
+ */
+export function stripJsonComments(input) {
+    let result = '';
+    let inString = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    for (let i = 0; i < input.length; i++) {
+        const char = input[i];
+        const next = input[i + 1];
+        if (inLineComment) {
+            if (char === '\n') {
+                inLineComment = false;
+                result += char;
+            }
+            continue;
+        }
+        if (inBlockComment) {
+            if (char === '*' && next === '/') {
+                inBlockComment = false;
+                i++;
+            }
+            continue;
+        }
+        if (inString) {
+            result += char;
+            // Copy escaped characters verbatim so an escaped quote (\") does not
+            // end the string early.
+            if (char === '\\') {
+                result += next ?? '';
+                i++;
+            }
+            else if (char === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            result += char;
+            continue;
+        }
+        if (char === '/' && next === '/') {
+            inLineComment = true;
+            i++;
+            continue;
+        }
+        if (char === '/' && next === '*') {
+            inBlockComment = true;
+            i++;
+            continue;
+        }
+        result += char;
+    }
+    return result;
+}
+/**
+ * Parse a JSON string that may contain comments (JSONC). Throws the underlying
+ * SyntaxError if the content is invalid even after comments are removed.
+ */
+export function parseJsonc(input) {
+    return JSON.parse(stripJsonComments(input));
+}

package/dist/utils/keychain.d.ts

@@ -4,3 +4,12 @@ export declare function deleteDeployPassword(domain: string, username: string):
 export declare function getSigningPassword(username: string): string | null;
 export declare function setSigningPassword(username: string, password: string): boolean;
 export declare function deleteSigningPassword(username: string): void;
+export declare function getOAuth2RefreshToken(domain: string, clientId: string): string | null;
+export declare function setOAuth2RefreshToken(domain: string, clientId: string, token: string): boolean;
+export declare function deleteOAuth2RefreshToken(domain: string, clientId: string): void;
+export declare function getOAuth2ClientSecret(domain: string, clientId: string): string | null;
+export declare function setOAuth2ClientSecret(domain: string, clientId: string, secret: string): boolean;
+export declare function deleteOAuth2ClientSecret(domain: string, clientId: string): void;
+export declare function getSessionCookie(domain: string, username: string): string | null;
+export declare function setSessionCookie(domain: string, username: string, cookie: string): boolean;
+export declare function deleteSessionCookie(domain: string, username: string): void;

package/dist/utils/keychain.js

@@ -6,6 +6,15 @@ function deployAccount(domain, username) {
 function signingAccount(username) {
     return `signing:${username}`;
 }
+function oauthRefreshAccount(domain, clientId) {
+    return `oauth2-refresh:${clientId}@${domain}`;
+}
+function oauthSecretAccount(domain, clientId) {
+    return `oauth2-secret:${clientId}@${domain}`;
+}
+function sessionCookieAccount(domain, username) {
+    return `session:${username}@${domain}`;
+}
 function safeGet(account) {
     try {
         return new Entry(SERVICE, account).getPassword();
@@ -61,3 +70,48 @@ export function deleteSigningPassword(username) {
         return;
     safeDelete(signingAccount(username));
 }
+export function getOAuth2RefreshToken(domain, clientId) {
+    if (!domain || !clientId)
+        return null;
+    return safeGet(oauthRefreshAccount(domain, clientId));
+}
+export function setOAuth2RefreshToken(domain, clientId, token) {
+    if (!domain || !clientId || !token)
+        return false;
+    return safeSet(oauthRefreshAccount(domain, clientId), token);
+}
+export function deleteOAuth2RefreshToken(domain, clientId) {
+    if (!domain || !clientId)
+        return;
+    safeDelete(oauthRefreshAccount(domain, clientId));
+}
+export function getOAuth2ClientSecret(domain, clientId) {
+    if (!domain || !clientId)
+        return null;
+    return safeGet(oauthSecretAccount(domain, clientId));
+}
+export function setOAuth2ClientSecret(domain, clientId, secret) {
+    if (!domain || !clientId || !secret)
+        return false;
+    return safeSet(oauthSecretAccount(domain, clientId), secret);
+}
+export function deleteOAuth2ClientSecret(domain, clientId) {
+    if (!domain || !clientId)
+        return;
+    safeDelete(oauthSecretAccount(domain, clientId));
+}
+export function getSessionCookie(domain, username) {
+    if (!domain || !username)
+        return null;
+    return safeGet(sessionCookieAccount(domain, username));
+}
+export function setSessionCookie(domain, username, cookie) {
+    if (!domain || !username || !cookie)
+        return false;
+    return safeSet(sessionCookieAccount(domain, username), cookie);
+}
+export function deleteSessionCookie(domain, username) {
+    if (!domain || !username)
+        return;
+    safeDelete(sessionCookieAccount(domain, username));
+}

package/dist/utils/oauth2-auth.d.ts

@@ -0,0 +1,64 @@
+import type { DevProperties } from '../types/index.js';
+/** Default loopback port. Fixed so a single redirect URI can be whitelisted. */
+export declare const DEFAULT_REDIRECT_PORT = 8137;
+export declare const DEFAULT_SCOPES: string[];
+/** RFC 7636 S256 pair. Exported for testing the challenge derivation. */
+export declare function createPkcePair(): {
+    verifier: string;
+    challenge: string;
+};
+export interface DiscoveredOAuth2 {
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    scopesSupported?: string[];
+}
+/**
+ * Fetch the site's OpenID configuration (unauthenticated) to auto-fill the
+ * authorization/token endpoints. Returns null if it isn't published (provider
+ * not enabled) or the response isn't a valid config, so callers fall back to
+ * manual entry.
+ */
+export declare function discoverOAuth2Config(domain: string, useHTTP?: boolean): Promise<DiscoveredOAuth2 | null>;
+export declare function openBrowser(url: string): void;
+/**
+ * Serve the loopback redirect once. Returns the awaited code and a `close()`
+ * that shuts the server down (freeing the port) if the login is cancelled — so
+ * a retry doesn't hit an EADDRINUSE on the fixed redirect port.
+ */
+interface LoopbackResult {
+    code?: string;
+    error?: string;
+}
+/**
+ * Turn a redirect's query params into a result, prioritizing the provider's own
+ * error (the most useful reason) over a generic "no code". Exported for testing.
+ */
+export declare function classifyRedirect(params: {
+    expectedState: string;
+    state: string | null;
+    error: string | null;
+    errorDescription: string | null;
+    code: string | null;
+}): LoopbackResult;
+/**
+ * Start an interactive OAuth2 login. Returns the authorize URL to open and a
+ * `complete()` that awaits the loopback redirect, exchanges the code, stores the
+ * refresh token, and resolves the access token. UI-agnostic, so an Ink screen
+ * can drive it without owning the terminal.
+ */
+export declare function beginOAuth2Login(dev: DevProperties): {
+    authUrl: string;
+    complete: () => Promise<{
+        token?: string;
+        error?: string;
+    }>;
+    cancel: () => void;
+} | null;
+/**
+ * Silently resolve an access token by refreshing the keychain refresh token.
+ * Returns null when there's no refresh token or it's expired/revoked (in which
+ * case the stale token is dropped). Interactive login lives in `beginOAuth2Login`,
+ * driven by the Ink login screen — the access token is never persisted.
+ */
+export declare function resolveOAuth2AccessToken(dev: DevProperties): Promise<string | null>;
+export {};