@appforge-ci/core 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,445 @@
+/**
+ * Shared domain types used by the API, dashboard, CLI, and agent.
+ * These mirror (but do not import from) the Prisma schema in packages/db,
+ * so packages that never need a DB connection don't need Prisma as a dep.
+ */
+export type Platform = "ios" | "android" | "flutter" | "react-native";
+export type BuildStatus = "queued" | "leased" | "running" | "succeeded" | "failed" | "canceled";
+export type AgentStatus = "online" | "offline" | "draining" | "building";
+export interface User {
+    id: string;
+    email: string;
+    name: string | null;
+    createdAt: string;
+    /** True for the platform operator, not a per-org role — fleet
+     *  management (enrolling/draining/rebooting Mac minis) is an
+     *  AppForge-the-service concern, the same way Codemagic customers never
+     *  manage Codemagic's own build machines. Regular org
+     *  owners/admins/members never see or touch fleet endpoints regardless
+     *  of their org role. */
+    isPlatformAdmin: boolean;
+    /** Set once `POST /auth/verify-email` redeems the token from the
+     *  signup verification email (`apps/api/src/lib/email-verification.ts`),
+     *  `null` until then. Purely informational — nothing in this app gates
+     *  on it (see that route's own docblock), so this is safe to ignore
+     *  entirely; it exists so a dashboard page can show verification status
+     *  and offer a resend. */
+    emailVerifiedAt: string | null;
+    /** TOTP 2FA status (apps/api/src/routes/two-factor.ts) — whether a
+     *  confirmed authenticator is required at login, not just enrolled. */
+    twoFactorEnabled: boolean;
+    /** How many single-use recovery codes are still unconsumed — the only
+     *  self-service fallback if the authenticator itself is lost, so
+     *  running out silently is a real lockout risk. `null` whenever 2FA
+     *  isn't enabled (there's nothing to count); always a fresh 10 right
+     *  after enrollment or a regenerate, since both replace the whole set
+     *  (see `packages/db`'s `replaceTotpRecoveryCodes`/
+     *  `countUnusedTotpRecoveryCodes`). */
+    unusedRecoveryCodeCount: number | null;
+}
+export type BillingMode = "prepaid" | "postpaid_monthly";
+export interface Org {
+    id: string;
+    name: string;
+    slug: string;
+    /** Prepaid build tokens. Unused once billingMode is postpaid_monthly. See TOKEN_PACKS / BUILD_COST_TOKENS below. */
+    tokenBalance: number;
+    billingMode: BillingMode;
+    /** Opt-in outgoing webhook, POSTed on every terminal build report for
+     *  any app in this org — see `apps/admin-api/src/lib/build-webhook.ts`.
+     *  null means disabled (the default). */
+    buildWebhookUrl: string | null;
+    createdAt: string;
+}
+/** LHV Paytech is the only postpaid payment provider on this instance —
+ *  Stripe support was removed entirely (#516) rather than left unwired. */
+export type PaymentProvider = "lhv";
+export interface BillingUsage {
+    billingMode: BillingMode;
+    tokenBalance: number;
+    buildCostTokens: number;
+    /** Only meaningful when billingMode is "postpaid_monthly". */
+    accruedUnbilledTokens: number;
+    estimatedAmountCents: number;
+    monthlyInvoiceDay: number;
+    billingPastDue: boolean;
+    lastInvoicedAt: string | null;
+    /** True if LHV has a saved payment method — the only postpaid provider
+     *  left after Stripe's removal (#516); currently always equal to
+     *  `hasLhvCard`, kept as a separate field since it's what the
+     *  dashboard/CLI actually gate "switch to monthly billing" on. */
+    hasPaymentMethod: boolean;
+    hasLhvCard: boolean;
+    lhvCardLastFour: string | null;
+    postpaidProvider: PaymentProvider | null;
+}
+export type MonthlyInvoiceStatus = "pending" | "paid" | "failed";
+export interface MonthlyInvoice {
+    id: string;
+    orgId: string;
+    periodStart: string;
+    periodEnd: string;
+    tokens: number;
+    amountCents: number;
+    status: MonthlyInvoiceStatus;
+    provider: PaymentProvider;
+    createdAt: string;
+    paidAt: string | null;
+}
+export interface Membership {
+    userId: string;
+    orgId: string;
+    role: "owner" | "admin" | "member";
+}
+export interface App {
+    id: string;
+    orgId: string;
+    name: string;
+    platform: Platform;
+    repoUrl: string;
+    defaultBranch: string;
+    createdAt: string;
+    /** Whether an OTA app key has ever been generated for this app — not
+     *  the key itself (that's never exposed once hashed), just enough to
+     *  tell whether clicking "Generate/rotate" is a first-time mint or a
+     *  destructive rotation that invalidates every build already
+     *  embedding the old key. See `appforge ota app-key`. */
+    hasOtaAppKey: boolean;
+}
+/** Public shape of `GET /orgs/:orgId/tokens` — deliberately never
+ *  includes the token value or its hash (see docs/security.md); once
+ *  minted, the raw token is only ever shown once, at creation time. */
+export interface ApiTokenInfo {
+    id: string;
+    label: string;
+    createdAt: string;
+    lastUsedAt: string | null;
+}
+export interface Build {
+    id: string;
+    appId: string;
+    orgId: string;
+    status: BuildStatus;
+    /** The `appforge.yaml` workflow name this build ran (or was queued to
+     *  run) — `"default"` unless a caller passed `--workflow`/`workflow:`
+     *  explicitly. Was silently dropped by `serializeBuild`
+     *  (`apps/api/src/routes/builds.ts`) despite being a real, always-
+     *  present column (`BuildRow.workflow`, `packages/db/src/types.ts`)
+     *  set at trigger time — this repo's own "no client can ever see
+     *  it" bug shape (see `defaultBranch`'s and `triggeredBy`'s own
+     *  fix history in ROADMAP.md). */
+    workflow: string;
+    branch: string;
+    commitSha: string | null;
+    triggeredBy: "manual" | "webhook" | "cli";
+    /** Only meaningful when status is "failed" — see BuildResult.
+     *  failureKind's docblock (packages/agent/src/lib/builder.ts) and
+     *  docs/billing.md for what "infra" means and that it drives an
+     *  automatic refund. Null for a succeeded/canceled build, or a failed
+     *  one reported by an agent that predates this field. */
+    failureKind: "user" | "infra" | null;
+    agentId: string | null;
+    costTokens: number;
+    queuedAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+    artifacts: BuildArtifact[];
+    /** One entry per smoke-test screenshot this build produced (up to 3 on
+     *  Android's fixed-walk v1, at most 1 on iOS today — see
+     *  packages/agent/src/lib/android-smoke-test.ts/ios-smoke-test.ts),
+     *  index-ordered. Empty when `smokeTest: true` wasn't set, or the
+     *  smoke test itself couldn't run (no device/Simulator attached). */
+    smokeTestResults: SmokeTestScreenshotResult[];
+}
+/** Per-screenshot smoke-test state — see `Build.smokeTestResults`. */
+export interface SmokeTestScreenshotResult {
+    screenshotIndex: number;
+    fileName: string;
+    downloadUrl: string;
+    /** Set once automatic analysis (triggered by `GET /builds/:id` — see
+     *  apps/api/src/routes/builds.ts) or a manual "Analyze smoke test"
+     *  click succeeds for this screenshot. Null until then. */
+    verdict: SmokeTestVerdict | null;
+    /** True while automatic analysis of this screenshot is claimed but not
+     *  yet resolved either way — the dashboard polls a bit longer while
+     *  any screenshot is still analyzing instead of stopping the moment
+     *  the build itself reaches a terminal status. */
+    analyzing: boolean;
+    /** Set if automatic analysis of this screenshot was attempted and
+     *  failed (e.g. `ANTHROPIC_API_KEY` isn't configured on this
+     *  deployment) — distinct from `verdict` being null because nothing's
+     *  run yet. */
+    error: string | null;
+}
+export interface BuildArtifact {
+    id: string;
+    buildId: string;
+    fileName: string;
+    sizeBytes: number;
+    downloadUrl: string;
+}
+/**
+ * AI triage of a failed build's log — see apps/api/src/lib/ai-triage.ts.
+ * Best-effort: `confidence: "low"` (or the whole feature 501ing when
+ * ANTHROPIC_API_KEY isn't configured) is expected, not a bug — this is a
+ * starting point for debugging, not a guaranteed diagnosis.
+ */
+export interface BuildFailureExplanation {
+    summary: string;
+    likelyCause: string;
+    suggestedFix: string;
+    confidence: "low" | "medium" | "high";
+}
+export interface AgentInfo {
+    id: string;
+    orgId: string;
+    name: string;
+    status: AgentStatus;
+    /** The Mac's hardware UUID — stable per machine. Null for agents
+     *  enrolled before this field existed (until they next re-enroll) and
+     *  for non-Mac hosts. See @appforge-ci/db's upsertAgent. */
+    machineId: string | null;
+    hostname: string;
+    macOsVersion: string;
+    xcodeVersion: string | null;
+    flutterVersion: string | null;
+    javaVersion: string | null;
+    androidSdkVersion: string | null;
+    cocoapodsVersion: string | null;
+    cpuModel: string;
+    /** This Mac's own packages/agent daemon version, self-reported at
+     *  enroll/heartbeat. Null until it (re-)enrolls or heartbeats on a
+     *  build that sends it — see isAgentVersionCurrent in
+     *  ./agent-readiness.js, the fleet-wide "is this row current" check. */
+    agentVersion: string | null;
+    /** Whether macOS Screen Sharing (the built-in VNC server) is enabled on
+     *  this Mac, self-reported at enroll/heartbeat — see
+     *  @appforge-ci/agent's system-info.ts. Null until it (re-)enrolls or
+     *  heartbeats on a build that sends it. 0/1/null, not a real boolean —
+     *  this is passed straight through from the D1 row (see
+     *  apps/admin-api/src/routes/fleet.ts), not re-serialized. */
+    screenSharingEnabled: number | null;
+    /** Whether a platform admin has authorized forwarding mouse/keyboard
+     *  input into this Mac's VNC session, not just watching it — see
+     *  @appforge/db's migrations/0024_agent_remote_control.sql. Unlike
+     *  screenSharingEnabled just above, this is never self-reported by the
+     *  agent; it only changes via `PATCH /orgs/:orgId/agents/:agentId/
+     *  remote-control` (apps/admin-api) or `appforge-admin agents
+     *  allow-remote-control`. 0/1/null, passed straight through from the
+     *  D1 row same as screenSharingEnabled — but null and 0 both mean "not
+     *  granted" (fail closed), the opposite of screenSharingEnabled's
+     *  permissive-on-null convention, since this gates actual control of
+     *  hardware, not just a read. */
+    remoteControlEnabled: number | null;
+    cpuUsagePercent: number;
+    memUsagePercent: number;
+    diskFreeGb: number;
+    tailscaleHostname: string | null;
+    currentBuildId: string | null;
+    /** How many builds this Mac will run at once, self-reported at every
+     *  heartbeat. 1 for a row an as-yet-unupgraded agent binary has never
+     *  reported this on. See migrations/0017_agent_concurrency.sql. */
+    maxConcurrentBuilds: number;
+    /** JSON array of build ids this agent is running right now (e.g.
+     *  '["bld_a","bld_b"]'), '[]' when idle — passed straight through from
+     *  the D1 row (see apps/admin-api/src/routes/fleet.ts), not
+     *  re-serialized, same as screenSharingEnabled just above. */
+    activeBuildIds: string;
+    lastSeenAt: string;
+}
+export type AgentCommandType = "DRAIN" | "RESUME" | "REBOOT_HOST" | "RESTART_AGENT" | "RUN_MAINTENANCE_SCRIPT" | "UPDATE_AGENT" | "CANCEL_BUILD";
+export interface AgentCommand {
+    id: string;
+    agentId: string;
+    type: AgentCommandType;
+    /** Only used for RUN_MAINTENANCE_SCRIPT — must match a name in the agent's allowlist. */
+    scriptName?: string;
+    /** Only used for CANCEL_BUILD — which of this agent's (possibly several
+     *  concurrent) builds to kill. See migrations/0018_cancel_build_command.sql. */
+    buildId?: string;
+    /** Only used for UPDATE_AGENT — an npm version (e.g. "0.2.0") or, for a
+     *  repo-checkout install, a git ref (tag/sha) to check out. Undefined
+     *  means "whatever the agent's own self-update step treats as latest"
+     *  (npm dist-tag `latest` / the checkout's default branch) — see
+     *  packages/agent/src/lib/self-update.ts. */
+    targetVersion?: string;
+    /** Only meaningful for UPDATE_AGENT — 1 when the fleet's own OTA
+     *  Phase 4 auto-rollback issued this command after detecting a stuck
+     *  self-update, distinct from one a human or Phase 3's ordinary
+     *  auto-update policy issued. Null/0/undefined all mean "not an
+     *  auto-rollback" — same nullable-number-as-boolean convention as
+     *  `AgentInfo.remoteControlEnabled` above; see @appforge/db's
+     *  AgentCommandRow.isAutoRollback for the full story. */
+    isAutoRollback?: number | null;
+    status: "pending" | "acked" | "done" | "failed";
+    createdAt: string;
+    result?: string;
+    /** The admin who issued this command — `GET /agents/:agentId/commands`
+     *  (`packages/db/src/agents.ts`'s `listAgentCommands`) always joins it
+     *  in, but this field was missing from this type even though the
+     *  route/DB layer already returned it: `null` only for a command
+     *  issued before this was tracked, or a since-deleted account — same
+     *  convention as `VncSession.issuedByEmail` above. */
+    issuedByEmail?: string | null;
+}
+/** One VNC "Connect" session request — the audit trail's read side (see
+ *  `apps/admin-api`'s `GET /orgs/:orgId/agents/:agentId/vnc-sessions`).
+ *  `issuedByEmail` is null only for a since-deleted account. */
+export interface VncSession {
+    id: string;
+    agentId: string;
+    issuedByEmail: string | null;
+    /** "view" (screen visibility only) or "control" (also forwards
+     *  mouse/keyboard input) — see @appforge/db's
+     *  migrations/0025_vnc_session_mode.sql. */
+    mode: "view" | "control";
+    /** Whether this request actually succeeded — 0 for a "control"
+     *  request refused because the agent's `remoteControlEnabled` flag
+     *  wasn't on (still recorded, not silently dropped — see
+     *  @appforge/db's migrations/0027_vnc_session_audit_granted.sql). */
+    granted: number;
+    createdAt: string;
+}
+/**
+ * appforge.yaml — the build config a repo owner commits alongside their app.
+ * Intentionally similar in shape to codemagic.yaml / GitHub Actions so it's
+ * easy to port an existing pipeline.
+ */
+export interface AppforgeConfig {
+    platform: Platform;
+    workflows: Record<string, AppforgeWorkflow>;
+}
+export interface AppforgeWorkflow {
+    name?: string;
+    environment?: {
+        node?: string;
+        flutter?: string;
+        xcode?: string;
+        vars?: Record<string, string>;
+    };
+    triggers?: {
+        push?: {
+            branch: string[];
+        };
+    };
+    scripts: {
+        name?: string;
+        script: string;
+    }[];
+    artifacts?: string[];
+    /** Opt-in post-build smoke test (#9 v1) — off by default. */
+    smokeTest?: boolean;
+    /** Opt-in OTA (over-the-air) code-push update publishing. Off by default. */
+    ota?: {
+        channel?: string;
+        mandatory?: boolean;
+    };
+}
+export interface OtaRelease {
+    id: string;
+    appId: string;
+    channel: string;
+    platform: Platform;
+    buildId: string | null;
+    bundleHash: string;
+    r2Key: string;
+    mandatory: boolean;
+    rollout: number;
+    createdAt: string;
+    bundleUrl?: string;
+}
+export interface OtaChannel {
+    channel: string;
+    activeReleaseId: string | null;
+    activeRelease: OtaRelease | null;
+    updatedAt: string;
+}
+export interface OtaManifest {
+    releaseId: string;
+    appId: string;
+    channel: string;
+    platform: Platform;
+    bundleUrl: string;
+    bundleHash: string;
+    mandatory: boolean;
+    rollout: number;
+    createdAt: string;
+}
+/** Verdict from analyzing a build's smoke-test screenshot (#9) — see
+ *  apps/api/src/lib/smoke-test-vision.ts. Best-effort, same "confidence"
+ *  honesty as BuildFailureExplanation: a vision model looking at one
+ *  screenshot can't be certain, so it isn't asked to pretend to be. */
+export interface SmokeTestVerdict {
+    looksOk: boolean;
+    explanation: string;
+}
+export type LedgerReason = "topup" | "build_charge" | "refund" | "adjustment" | "invoice";
+export interface LedgerEntry {
+    id: string;
+    orgId: string;
+    buildId: string | null;
+    deltaTokens: number;
+    reason: LedgerReason;
+    note: string | null;
+    createdAt: string;
+}
+/**
+ * Billing runs on tokens, not direct EUR-per-build, specifically so a
+ * bigger top-up can be cheaper per token without ever changing what a
+ * build costs. `BUILD_COST_TOKENS` is the default/baseline cost — same
+ * as every platform's actual cost today (see `BUILD_COST_TOKENS_BY_PLATFORM`
+ * below), so this PR ships the *mechanism* for per-platform pricing
+ * without changing anyone's bill; a maintainer who actually wants e.g. a
+ * bigger/faster iOS build machine to cost more tokens than a default
+ * Android one (the way Codemagic prices different machine types
+ * differently per minute) edits the map below, the same one-constant
+ * edit `TOKEN_PACKS` already is — no further code change needed.
+ */
+export declare const BUILD_COST_TOKENS = 100;
+/** Every platform costs `BUILD_COST_TOKENS` today — see the note above.
+ *  Kept as an explicit per-platform map (not a single constant) so that
+ *  changing one platform's price is a one-line edit here, not a search
+ *  for every `BUILD_COST_TOKENS` call site. */
+export declare const BUILD_COST_TOKENS_BY_PLATFORM: Record<Platform, number>;
+/**
+ * What a build on this platform actually costs. Takes the DB's storage
+ * format directly (`react_native`, underscore — matches the SQL CHECK
+ * constraint on `App.platform`) rather than making every caller convert
+ * to this module's hyphenated `Platform` type first; falls back to the
+ * flat default for anything unrecognized rather than throwing, since a
+ * charge must never hard-fail over a pricing lookup.
+ */
+export declare function getBuildCostTokens(dbPlatform: string): number;
+export interface TokenPack {
+    id: string;
+    label: string;
+    tokens: number;
+    priceCents: number;
+}
+/**
+ * Fixed volume-discount packs, in ascending size. `BUILD_COST_TOKENS`
+ * tokens = 1 build regardless of which pack they came from, so the
+ * discount is purely "pay less per token by buying a bigger pack" —
+ * never a cheaper build.
+ */
+export declare const TOKEN_PACKS: TokenPack[];
+/**
+ * The smallest pack's rate, used as: (a) the baseline every other pack's discount
+ * is computed against, and (b) the postpaid-monthly invoicing rate — monthly
+ * billing has no volume discount (same as Codemagic's pay-as-you-go minutes,
+ * which are priced flat per machine-type regardless of usage volume), so it
+ * always bills at list price.
+ */
+export declare const LIST_PRICE_PER_TOKEN_CENTS: number;
+export declare function tokenPackDisplay(pack: TokenPack): {
+    priceEur: number;
+    pricePerTokenCents: number;
+    buildsIncluded: number;
+    discountPercent: number;
+    id: string;
+    label: string;
+    tokens: number;
+    priceCents: number;
+};
+export declare function findTokenPack(packId: string): TokenPack | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,80 @@
+/**
+ * Shared domain types used by the API, dashboard, CLI, and agent.
+ * These mirror (but do not import from) the Prisma schema in packages/db,
+ * so packages that never need a DB connection don't need Prisma as a dep.
+ */
+/**
+ * Billing runs on tokens, not direct EUR-per-build, specifically so a
+ * bigger top-up can be cheaper per token without ever changing what a
+ * build costs. `BUILD_COST_TOKENS` is the default/baseline cost — same
+ * as every platform's actual cost today (see `BUILD_COST_TOKENS_BY_PLATFORM`
+ * below), so this PR ships the *mechanism* for per-platform pricing
+ * without changing anyone's bill; a maintainer who actually wants e.g. a
+ * bigger/faster iOS build machine to cost more tokens than a default
+ * Android one (the way Codemagic prices different machine types
+ * differently per minute) edits the map below, the same one-constant
+ * edit `TOKEN_PACKS` already is — no further code change needed.
+ */
+export const BUILD_COST_TOKENS = 100;
+/** Every platform costs `BUILD_COST_TOKENS` today — see the note above.
+ *  Kept as an explicit per-platform map (not a single constant) so that
+ *  changing one platform's price is a one-line edit here, not a search
+ *  for every `BUILD_COST_TOKENS` call site. */
+export const BUILD_COST_TOKENS_BY_PLATFORM = {
+    ios: BUILD_COST_TOKENS,
+    android: BUILD_COST_TOKENS,
+    flutter: BUILD_COST_TOKENS,
+    "react-native": BUILD_COST_TOKENS,
+};
+/**
+ * What a build on this platform actually costs. Takes the DB's storage
+ * format directly (`react_native`, underscore — matches the SQL CHECK
+ * constraint on `App.platform`) rather than making every caller convert
+ * to this module's hyphenated `Platform` type first; falls back to the
+ * flat default for anything unrecognized rather than throwing, since a
+ * charge must never hard-fail over a pricing lookup.
+ */
+export function getBuildCostTokens(dbPlatform) {
+    const platform = dbPlatform.replace("_", "-");
+    return BUILD_COST_TOKENS_BY_PLATFORM[platform] ?? BUILD_COST_TOKENS;
+}
+function pricePerTokenCents(pack) {
+    return pack.priceCents / pack.tokens;
+}
+/** List price is the smallest pack's per-token rate — every larger pack is defined as a discount off it. */
+function discountPercent(pack, listPricePerToken) {
+    return Math.round((1 - pricePerTokenCents(pack) / listPricePerToken) * 100);
+}
+/**
+ * Fixed volume-discount packs, in ascending size. `BUILD_COST_TOKENS`
+ * tokens = 1 build regardless of which pack they came from, so the
+ * discount is purely "pay less per token by buying a bigger pack" —
+ * never a cheaper build.
+ */
+export const TOKEN_PACKS = [
+    { id: "starter", label: "Starter", tokens: 1_000, priceCents: 1_000 }, // €10.00 — 10 builds, list price
+    { id: "growth", label: "Growth", tokens: 6_000, priceCents: 5_400 }, // €54.00 — 60 builds, 10% off
+    { id: "scale", label: "Scale", tokens: 30_000, priceCents: 24_000 }, // €240.00 — 300 builds, 20% off
+    { id: "studio", label: "Studio", tokens: 120_000, priceCents: 84_000 }, // €840.00 — 1200 builds, 30% off
+];
+/**
+ * The smallest pack's rate, used as: (a) the baseline every other pack's discount
+ * is computed against, and (b) the postpaid-monthly invoicing rate — monthly
+ * billing has no volume discount (same as Codemagic's pay-as-you-go minutes,
+ * which are priced flat per machine-type regardless of usage volume), so it
+ * always bills at list price.
+ */
+export const LIST_PRICE_PER_TOKEN_CENTS = pricePerTokenCents(TOKEN_PACKS[0]);
+export function tokenPackDisplay(pack) {
+    return {
+        ...pack,
+        priceEur: pack.priceCents / 100,
+        pricePerTokenCents: pricePerTokenCents(pack),
+        buildsIncluded: Math.floor(pack.tokens / BUILD_COST_TOKENS),
+        discountPercent: discountPercent(pack, LIST_PRICE_PER_TOKEN_CENTS),
+    };
+}
+export function findTokenPack(packId) {
+    return TOKEN_PACKS.find((p) => p.id === packId);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0aH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC;;;+CAG+C;AAC/C,MAAM,CAAC,MAAM,6BAA6B,GAA6B;IACrE,GAAG,EAAE,iBAAiB;IACtB,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,iBAAiB;IAC1B,cAAc,EAAE,iBAAiB;CAClC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAa,CAAC;IAC1D,OAAO,6BAA6B,CAAC,QAAQ,CAAC,IAAI,iBAAiB,CAAC;AACtE,CAAC;AASD,SAAS,kBAAkB,CAAC,IAAe;IACzC,OAAO,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;AACvC,CAAC;AAED,4GAA4G;AAC5G,SAAS,eAAe,CAAC,IAAe,EAAE,iBAAyB;IACjE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,GAAG,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,iCAAiC;IACxG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,8BAA8B;IACnG,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,gCAAgC;IACrG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,iCAAiC;CAC1G,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC;AAE9E,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,IAAI,CAAC,UAAU,GAAG,GAAG;QAC/B,kBAAkB,EAAE,kBAAkB,CAAC,IAAI,CAAC;QAC5C,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC;QAC3D,eAAe,EAAE,eAAe,CAAC,IAAI,EAAE,0BAA0B,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@appforge-ci/core",
+  "version": "0.1.1",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.16.5",
+    "tsx": "^4.23.13",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "echo 'no lint configured for core'",
+    "test": "tsx --import ../../scripts/test-home-sandbox.mjs --test $(find src -name '*.test.ts') --concurrency=4"
+  }
+}