hub-launch 1.0.3

package/dist/types/tracking.schema.d.ts

@@ -0,0 +1,340 @@
+import { z } from 'zod';
+export declare const DeploymentStatusSchema: z.ZodEnum<["pending", "success", "failed"]>;
+export type DeploymentStatus = z.infer<typeof DeploymentStatusSchema>;
+/**
+ * Single tracked plan (server concept: Plan, formerly Issue).
+ *
+ * NOTE: The imported `IssueStatusSchema` is intentionally kept under its
+ * current name — it represents hub-launch's internal lifecycle state
+ * machine (`unassigned | initialWaiting | waiting | ready`) and predates
+ * the server's Plan rename. It is not part of the wire-protocol rename.
+ */
+export declare const TrackedPlanSchema: z.ZodObject<{
+    name: z.ZodString;
+    trackingName: z.ZodOptional<z.ZodString>;
+    number: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
+    planPath: z.ZodOptional<z.ZodString>;
+    copilotAssigned: z.ZodOptional<z.ZodBoolean>;
+    trackingStatus: z.ZodEnum<["unassigned", "initialWaiting", "waiting", "ready"]>;
+    priority: z.ZodEnum<["Critical", "High", "Medium", "Low", "Minimal"]>;
+    projectOwner: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    createdById: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    prNumber: z.ZodOptional<z.ZodNumber>;
+    prUrl: z.ZodOptional<z.ZodString>;
+    projectItemId: z.ZodOptional<z.ZodString>;
+    githubState: z.ZodOptional<z.ZodEnum<["open", "closed"]>>;
+    deploymentStatus: z.ZodOptional<z.ZodEnum<["pending", "success", "failed"]>>;
+    deploymentNotifiedAt: z.ZodOptional<z.ZodString>;
+    prSource: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+    priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+    createdAt: string;
+    updatedAt: string;
+    number?: number | undefined;
+    trackingName?: string | undefined;
+    title?: string | undefined;
+    planPath?: string | undefined;
+    copilotAssigned?: boolean | undefined;
+    projectOwner?: string | undefined;
+    projectName?: string | undefined;
+    createdById?: string | undefined;
+    assignees?: string[] | undefined;
+    prNumber?: number | undefined;
+    prUrl?: string | undefined;
+    projectItemId?: string | undefined;
+    githubState?: "open" | "closed" | undefined;
+    deploymentStatus?: "pending" | "success" | "failed" | undefined;
+    deploymentNotifiedAt?: string | undefined;
+    prSource?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    name: string;
+    trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+    priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+    createdAt: string;
+    updatedAt: string;
+    number?: number | undefined;
+    trackingName?: string | undefined;
+    title?: string | undefined;
+    planPath?: string | undefined;
+    copilotAssigned?: boolean | undefined;
+    projectOwner?: string | undefined;
+    projectName?: string | undefined;
+    createdById?: string | undefined;
+    assignees?: string[] | undefined;
+    prNumber?: number | undefined;
+    prUrl?: string | undefined;
+    projectItemId?: string | undefined;
+    githubState?: "open" | "closed" | undefined;
+    deploymentStatus?: "pending" | "success" | "failed" | undefined;
+    deploymentNotifiedAt?: string | undefined;
+    prSource?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+export type TrackedPlan = z.infer<typeof TrackedPlanSchema>;
+export declare const TrackingDataSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    lastUpdated: z.ZodString;
+    plans: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        trackingName: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        planPath: z.ZodOptional<z.ZodString>;
+        copilotAssigned: z.ZodOptional<z.ZodBoolean>;
+        trackingStatus: z.ZodEnum<["unassigned", "initialWaiting", "waiting", "ready"]>;
+        priority: z.ZodEnum<["Critical", "High", "Medium", "Low", "Minimal"]>;
+        projectOwner: z.ZodOptional<z.ZodString>;
+        projectName: z.ZodOptional<z.ZodString>;
+        createdById: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prNumber: z.ZodOptional<z.ZodNumber>;
+        prUrl: z.ZodOptional<z.ZodString>;
+        projectItemId: z.ZodOptional<z.ZodString>;
+        githubState: z.ZodOptional<z.ZodEnum<["open", "closed"]>>;
+        deploymentStatus: z.ZodOptional<z.ZodEnum<["pending", "success", "failed"]>>;
+        deploymentNotifiedAt: z.ZodOptional<z.ZodString>;
+        prSource: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    lastUpdated: string;
+    plans: {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }[];
+}, {
+    lastUpdated: string;
+    plans: {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }[];
+    version?: string | undefined;
+}>;
+export type TrackingData = z.infer<typeof TrackingDataSchema>;
+export declare const TrackedPlansSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    lastUpdated: z.ZodString;
+    plans: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        trackingName: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        planPath: z.ZodOptional<z.ZodString>;
+        copilotAssigned: z.ZodOptional<z.ZodBoolean>;
+        trackingStatus: z.ZodEnum<["unassigned", "initialWaiting", "waiting", "ready"]>;
+        priority: z.ZodEnum<["Critical", "High", "Medium", "Low", "Minimal"]>;
+        projectOwner: z.ZodOptional<z.ZodString>;
+        projectName: z.ZodOptional<z.ZodString>;
+        createdById: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        assignees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        prNumber: z.ZodOptional<z.ZodNumber>;
+        prUrl: z.ZodOptional<z.ZodString>;
+        projectItemId: z.ZodOptional<z.ZodString>;
+        githubState: z.ZodOptional<z.ZodEnum<["open", "closed"]>>;
+        deploymentStatus: z.ZodOptional<z.ZodEnum<["pending", "success", "failed"]>>;
+        deploymentNotifiedAt: z.ZodOptional<z.ZodString>;
+        prSource: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    lastUpdated: string;
+    plans: {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }[];
+}, {
+    lastUpdated: string;
+    plans: {
+        name: string;
+        trackingStatus: "unassigned" | "initialWaiting" | "waiting" | "ready";
+        priority: "Critical" | "High" | "Medium" | "Low" | "Minimal";
+        createdAt: string;
+        updatedAt: string;
+        number?: number | undefined;
+        trackingName?: string | undefined;
+        title?: string | undefined;
+        planPath?: string | undefined;
+        copilotAssigned?: boolean | undefined;
+        projectOwner?: string | undefined;
+        projectName?: string | undefined;
+        createdById?: string | undefined;
+        assignees?: string[] | undefined;
+        prNumber?: number | undefined;
+        prUrl?: string | undefined;
+        projectItemId?: string | undefined;
+        githubState?: "open" | "closed" | undefined;
+        deploymentStatus?: "pending" | "success" | "failed" | undefined;
+        deploymentNotifiedAt?: string | undefined;
+        prSource?: string | undefined;
+        tags?: string[] | undefined;
+    }[];
+    version?: string | undefined;
+}>;
+//# sourceMappingURL=tracking.schema.d.ts.map

package/dist/types/tracking.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.schema.d.ts","sourceRoot":"","sources":["../../src/types/tracking.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,sBAAsB,6CAA2C,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2C5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG9D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqB,CAAC"}

package/dist/types/tracking.schema.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { PrioritySchema, IssueStatusSchema } from './common.schema.js';
+// Deployment status
+export const DeploymentStatusSchema = z.enum(['pending', 'success', 'failed']);
+/**
+ * Single tracked plan (server concept: Plan, formerly Issue).
+ *
+ * NOTE: The imported `IssueStatusSchema` is intentionally kept under its
+ * current name — it represents hub-launch's internal lifecycle state
+ * machine (`unassigned | initialWaiting | waiting | ready`) and predates
+ * the server's Plan rename. It is not part of the wire-protocol rename.
+ */
+export const TrackedPlanSchema = z.object({
+    // Core fields
+    name: z.string(), // Internal identifier: owner/repo#number format
+    trackingName: z.string().optional(), // User-provided custom name for display
+    number: z.number().int().positive().optional(),
+    title: z.string().optional(),
+    planPath: z.string().optional(),
+    copilotAssigned: z.boolean().optional(),
+    trackingStatus: IssueStatusSchema,
+    priority: PrioritySchema,
+    // Project info (from server; renamed from repoOwner/repoName)
+    projectOwner: z.string().optional(),
+    projectName: z.string().optional(),
+    // Server-side ownership (from hula-project API). Used by `clean` to
+    // pre-filter rows the current user cannot untrack on older servers.
+    createdById: z.string().optional(),
+    // Metadata
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    assignees: z.array(z.string()).optional(),
+    // PR information
+    prNumber: z.number().int().positive().optional(),
+    prUrl: z.string().url().optional(),
+    // GitHub Projects sync (legacy local adapter only)
+    projectItemId: z.string().optional(),
+    // GitHub state (open/closed)
+    githubState: z.enum(['open', 'closed']).optional(),
+    // Deployment status tracking
+    deploymentStatus: DeploymentStatusSchema.optional(),
+    deploymentNotifiedAt: z.string().datetime().optional(),
+    // Provenance of the latest Task that opened a PR for this Plan
+    prSource: z.string().optional(), // 'ralph-run' for launched tasks
+    // Additional metadata
+    tags: z.array(z.string()).optional(),
+});
+// Root tracking data structure
+export const TrackingDataSchema = z.object({
+    version: z.string().default('3.0'),
+    lastUpdated: z.string().datetime(),
+    plans: z.array(TrackedPlanSchema),
+});
+// For validation when reading file
+export const TrackedPlansSchema = TrackingDataSchema;
+//# sourceMappingURL=tracking.schema.js.map

package/dist/types/tracking.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.schema.js","sourceRoot":"","sources":["../../src/types/tracking.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,oBAAoB;AACpB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAG/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,cAAc;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,gDAAgD;IAClE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,wCAAwC;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,iBAAiB;IACjC,QAAQ,EAAE,cAAc;IAExB,8DAA8D;IAC9D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,oEAAoE;IACpE,oEAAoE;IACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,WAAW;IACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEzC,iBAAiB;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAElC,mDAAmD;IACnD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEpC,6BAA6B;IAC7B,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAElD,6BAA6B;IAC7B,gBAAgB,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IACnD,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEtD,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,iCAAiC;IAElE,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAGH,+BAA+B;AAC/B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CAClC,CAAC,CAAC;AAGH,mCAAmC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC"}

package/dist/utils/browser-launcher.d.ts

@@ -0,0 +1,60 @@
+import { type BrowserContext } from '@playwright/test';
+import type { Config } from '../types/index.js';
+export interface BrowserLaunchOptions {
+    userDataDir: string;
+    serviceName: string;
+    config: Config;
+    timeout?: number;
+    extraArgs?: string[];
+}
+export interface BrowserLaunchResult {
+    context: BrowserContext;
+    wasHeadless: boolean;
+    needsLogin: boolean;
+}
+export declare const COMMON_CHROME_ARGS: string[];
+/**
+ * Check if user data directory has existing session
+ */
+export declare function hasExistingSession(userDataDir: string): boolean;
+/**
+ * Determine if browser should run in headless mode
+ */
+export declare function shouldRunHeadless(hasSession: boolean, config: Config): boolean;
+/**
+ * Launch browser with conditional headless mode
+ *
+ * Returns context and metadata about launch configuration
+ */
+export declare function launchBrowser(options: BrowserLaunchOptions): Promise<BrowserLaunchResult>;
+/**
+ * Handle session expiration with clear error message
+ */
+export declare function handleSessionExpired(serviceName: string, userDataDir: string): never;
+/**
+ * Check if Playwright Chromium is installed
+ *
+ * @returns true if Chromium browser is installed, false otherwise
+ */
+export declare function checkChromiumInstalled(): Promise<boolean>;
+/**
+ * Install Playwright Chromium browser
+ *
+ * @returns true if installation succeeded, false otherwise
+ */
+export declare function installChromium(): Promise<boolean>;
+export interface RequirePlaywrightOptions {
+    /** Context-specific message explaining why Playwright is needed */
+    featureDescription: string;
+    /** If true, skip interactive prompt (for CI/scripts) */
+    nonInteractive?: boolean;
+    /** If true with nonInteractive, auto-install without prompting */
+    autoInstall?: boolean;
+}
+/**
+ * Ensure Playwright Chromium is available, prompting for installation if needed.
+ *
+ * @returns true if Playwright is available, false if user declined or installation failed
+ */
+export declare function requirePlaywright(options: RequirePlaywrightOptions): Promise<boolean>;
+//# sourceMappingURL=browser-launcher.d.ts.map

package/dist/utils/browser-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../src/utils/browser-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAID,eAAO,MAAM,kBAAkB,UAK9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAYT;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAuH9B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,KAAK,CAmBP;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAwC/D;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAoBxD;AAED,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkC3F"}