@oore/client 0.12.0 → 0.13.0

package/dist/generated/valibot/v-update-notification-channel-request.js

@@ -1,5 +1,6 @@
 // Generated by scripts/generate-valibot-modules.ts. Do not edit.
 import * as v from 'valibot';
+import { vSlackMention } from './v-slack-mention.js';
 import { vUpdateSmtpConfig } from './v-update-smtp-config.js';
 export const vUpdateNotificationChannelRequest = v.object({
     enabled: v.nullish(v.boolean()),
@@ -7,6 +8,7 @@ export const vUpdateNotificationChannelRequest = v.object({
     name: v.nullish(v.string()),
     project_id: v.nullish(v.string()),
     secret: v.nullish(v.string()),
+    slack_mentions: v.nullish(v.array(vSlackMention)),
     smtp_config: v.nullish(vUpdateSmtpConfig),
     url: v.nullish(v.string())
 });

package/dist/generated/valibot/v-update-notification-channel-response.d.ts

@@ -12,6 +12,10 @@ export declare const vUpdateNotificationChannelResponse: v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         readonly name: v.StringSchema<undefined>;
         readonly project_id: v.NullishSchema<v.StringSchema<undefined>, undefined>;
+        readonly slack_mentions: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly identity: v.StringSchema<undefined>;
+            readonly member_id: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly smtp_summary: v.NullishSchema<v.ObjectSchema<{
             readonly from_address: v.StringSchema<undefined>;
             readonly host: v.StringSchema<undefined>;

package/dist/msw-scenarios.d.ts

@@ -1,11 +1,22 @@
 import { type HttpHandler } from 'msw';
 import { type OoreMswHandlerOptions } from './msw.js';
-import type { Project } from './generated/types.gen.js';
+import type { Project, ReleaseDetailResponse } from './generated/types.gen.js';
 export interface OoreMockScenario {
     /** Fixed epoch seconds used for records created during the scenario. */
     now: number;
     projects: ReadonlyArray<Project>;
+    /**
+     * Releases with their history, newest history entry last. The handlers
+     * recompute `allowed_actions` for a maintainer from each release's state.
+     */
+    releases?: ReadonlyArray<ReleaseDetailResponse>;
 }
+/** A Google Play production rollout at 20%, healthy and still moving. */
+export declare const rollingReleaseScenario: ReleaseDetailResponse;
+/** A Google Play rollout the daemon halted at 5% after a crash spike. */
+export declare const haltedReleaseScenario: ReleaseDetailResponse;
+/** An App Store release that finished its phased rollout. */
+export declare const completeReleaseScenario: ReleaseDetailResponse;
 export declare const defaultOoreScenario: OoreMockScenario;
 /**
  * Creates deterministic, stateful handlers for Oore's core demo scenario.

package/dist/msw-scenarios.js

@@ -1,5 +1,159 @@
 import { HttpResponse } from 'msw';
-import { createProjectMock, listProjectsMock, } from './msw.js';
+import { approveReleaseMock, completeReleaseMock, createProjectMock, getReleaseMock, haltReleaseMock, listProjectsMock, listReleaseEventsMock, listReleasesMock, pauseReleaseMock, raiseReleaseMock, resumeReleaseMock, } from './msw.js';
+const DEFAULT_RELEASE_POLICY = {
+    approval: 'none',
+    crash_rate_threshold: 0.02,
+    interval_hours: 24,
+    steps: [0.01, 0.05, 0.2, 0.5, 1],
+};
+/** A Google Play production rollout at 20%, healthy and still moving. */
+export const rollingReleaseScenario = {
+    history: [
+        {
+            at: 1_767_052_800,
+            id: 'release-rolling-h1',
+            to_fraction: 0.01,
+            to_state: 'rolling',
+        },
+        {
+            at: 1_767_139_200,
+            from_fraction: 0.01,
+            from_state: 'rolling',
+            id: 'release-rolling-h2',
+            to_fraction: 0.05,
+            to_state: 'rolling',
+        },
+        {
+            actor_email: 'owner@acme.test',
+            actor_id: 'demo-owner',
+            at: 1_767_200_000,
+            from_fraction: 0.05,
+            from_state: 'rolling',
+            id: 'release-rolling-h3',
+            reason: 'Crash-free rate looks good',
+            to_fraction: 0.2,
+            to_state: 'rolling',
+        },
+    ],
+    release: {
+        allowed_actions: [],
+        artifact_id: 'artifact-rolling',
+        awaiting_approval: false,
+        build_id: 'build-142',
+        build_number: 142,
+        crash_rate: 0.004,
+        crash_rate_threshold: 0.02,
+        created_at: 1_767_052_800,
+        health: 'healthy',
+        id: 'release-rolling',
+        next_fraction: 0.5,
+        next_step_at: 1_767_286_400,
+        package_name: 'com.acme.fluttershop',
+        platform: 'android',
+        policy: DEFAULT_RELEASE_POLICY,
+        project_id: 'project-1',
+        project_name: 'FlutterShop',
+        rollout_fraction: 0.2,
+        state: 'rolling',
+        store: 'google_play',
+        track: 'production',
+        updated_at: 1_767_200_000,
+        version_code: 142,
+        version_name: '2.4.0',
+    },
+};
+/** A Google Play rollout the daemon halted at 5% after a crash spike. */
+export const haltedReleaseScenario = {
+    history: [
+        {
+            at: 1_766_880_000,
+            id: 'release-halted-h1',
+            to_fraction: 0.01,
+            to_state: 'rolling',
+        },
+        {
+            at: 1_766_966_400,
+            from_fraction: 0.01,
+            from_state: 'rolling',
+            id: 'release-halted-h2',
+            to_fraction: 0.05,
+            to_state: 'rolling',
+        },
+        {
+            at: 1_767_000_000,
+            from_fraction: 0.05,
+            from_state: 'rolling',
+            id: 'release-halted-h3',
+            reason: 'Crash rate 3.1% reached the 2% threshold',
+            to_state: 'halted',
+        },
+    ],
+    release: {
+        allowed_actions: [],
+        artifact_id: 'artifact-halted',
+        awaiting_approval: false,
+        build_id: 'build-139',
+        build_number: 139,
+        crash_rate: 0.031,
+        crash_rate_threshold: 0.02,
+        created_at: 1_766_880_000,
+        health: 'breached',
+        id: 'release-halted',
+        package_name: 'com.acme.fluttershop',
+        platform: 'android',
+        policy: DEFAULT_RELEASE_POLICY,
+        project_id: 'project-1',
+        project_name: 'FlutterShop',
+        rollout_fraction: 0.05,
+        state: 'halted',
+        store: 'google_play',
+        track: 'production',
+        updated_at: 1_767_000_000,
+        version_code: 139,
+        version_name: '2.3.1',
+    },
+};
+/** An App Store release that finished its phased rollout. */
+export const completeReleaseScenario = {
+    history: [
+        {
+            at: 1_766_448_000,
+            id: 'release-complete-h1',
+            to_fraction: 0.01,
+            to_state: 'rolling',
+        },
+        {
+            at: 1_767_052_800,
+            from_fraction: 0.5,
+            from_state: 'rolling',
+            id: 'release-complete-h2',
+            to_fraction: 1,
+            to_state: 'complete',
+        },
+    ],
+    release: {
+        allowed_actions: [],
+        artifact_id: 'artifact-complete',
+        awaiting_approval: false,
+        build_id: 'build-137',
+        build_number: 137,
+        created_at: 1_766_448_000,
+        health: 'healthy',
+        id: 'release-complete',
+        package_name: 'com.acme.fluttershop',
+        platform: 'ios',
+        policy: DEFAULT_RELEASE_POLICY,
+        project_id: 'project-1',
+        project_name: 'FlutterShop',
+        rollout_fraction: 1,
+        state: 'complete',
+        store: 'app_store',
+        track: 'app_store',
+        updated_at: 1_767_052_800,
+        version_code: 137,
+        version_name: '2.3.0',
+    },
+};
 export const defaultOoreScenario = {
     now: 1_767_225_600,
     projects: [
@@ -32,7 +186,65 @@ export const defaultOoreScenario = {
             updated_at: 1_767_139_200,
         },
     ],
+    releases: [
+        rollingReleaseScenario,
+        haltedReleaseScenario,
+        completeReleaseScenario,
+    ],
+};
+const isAwaitingApproval = (release) => {
+    if (release.approved_at != null)
+        return false;
+    if (release.state === 'complete' || release.state === 'failed')
+        return false;
+    switch (release.policy.approval ?? 'none') {
+        case 'before_upload':
+            return release.state === 'uploading';
+        case 'before_production':
+            return release.track === 'production';
+        default:
+            return false;
+    }
+};
+/** Mirrors the daemon's rules for a caller who may manage releases. */
+const maintainerActions = (release) => {
+    const awaiting = isAwaitingApproval(release);
+    const { rollout_fraction: fraction, state } = release;
+    const appStore = release.store === 'app_store';
+    const playDraft = release.store === 'google_play' && state === 'paused' && fraction === 0;
+    const moving = state === 'rolling' || state === 'paused';
+    const actions = [];
+    if (!appStore && state === 'rolling' && !awaiting && fraction < 1)
+        actions.push('raise');
+    if (state === 'rolling')
+        actions.push('pause');
+    if ((state === 'paused' || state === 'halted') && !awaiting)
+        actions.push('resume');
+    if (!appStore && !playDraft && moving)
+        actions.push('halt');
+    if (moving && !awaiting)
+        actions.push('complete');
+    if (awaiting)
+        actions.push('approve');
+    return actions;
 };
+const withActions = (release) => ({
+    ...release,
+    allowed_actions: maintainerActions(release),
+    awaiting_approval: isAwaitingApproval(release),
+});
+const apiError = (status, code, error) => HttpResponse.json({ code, error }, { status });
+const cloneRelease = (detail) => ({
+    history: detail.history.map((entry) => ({ ...entry })),
+    release: {
+        ...detail.release,
+        allowed_actions: [...detail.release.allowed_actions],
+        policy: {
+            ...detail.release.policy,
+            steps: detail.release.policy.steps && [...detail.release.policy.steps],
+        },
+    },
+});
 /**
  * Creates deterministic, stateful handlers for Oore's core demo scenario.
  * Each call owns an isolated copy of the supplied state.
@@ -43,6 +255,86 @@ export const createOoreMockHandlers = (scenario = defaultOoreScenario, options)
         settings: { ...project.settings },
     }));
     let nextProjectNumber = projects.length + 1;
+    const releases = (scenario.releases ?? []).map(cloneRelease);
+    let clock = scenario.now;
+    let nextHistoryNumber = 1;
+    const releaseAction = (action) => async ({ params, request, }) => {
+        const detail = releases.find((item) => item.release.id === params.release_id);
+        if (!detail)
+            return apiError(404, 'not_found', 'Release not found');
+        const text = await request.text();
+        const body = text ? JSON.parse(text) : {};
+        const current = detail.release;
+        if (body.fraction != null && action !== 'raise')
+            return apiError(400, 'invalid_input', 'fraction is only accepted by raise');
+        if (!maintainerActions(current).includes(action))
+            return apiError(409, 'invalid_release_state', `Cannot ${action} a release that is ${current.state}`);
+        clock += 60;
+        if (action === 'approve') {
+            detail.release = withActions({
+                ...current,
+                approved_at: clock,
+                approved_by_email: 'owner@acme.test',
+                updated_at: clock,
+            });
+            return HttpResponse.json(detail.release);
+        }
+        let toState;
+        let toFraction;
+        switch (action) {
+            case 'raise': {
+                const fraction = body.fraction ??
+                    current.policy.steps?.find((step) => step > current.rollout_fraction) ??
+                    1;
+                if (!Number.isFinite(fraction) ||
+                    fraction <= current.rollout_fraction ||
+                    fraction > 1)
+                    return apiError(400, 'invalid_input', 'fraction must be above the current rollout and at most 1');
+                toFraction = fraction;
+                toState = fraction >= 1 ? 'complete' : 'rolling';
+                break;
+            }
+            case 'pause':
+                toState = 'paused';
+                break;
+            case 'halt':
+                toState = 'halted';
+                break;
+            case 'resume':
+                toState = 'rolling';
+                if (current.rollout_fraction === 0)
+                    toFraction = current.policy.steps?.[0];
+                break;
+            default:
+                toState = 'complete';
+                toFraction = 1;
+        }
+        const entry = {
+            actor_email: 'owner@acme.test',
+            actor_id: 'demo-owner',
+            at: clock,
+            from_fraction: current.rollout_fraction,
+            from_state: current.state,
+            id: `release-history-${nextHistoryNumber++}`,
+            reason: body.reason ?? null,
+            to_fraction: toFraction ?? null,
+            to_state: toState,
+        };
+        detail.history.push(entry);
+        const rolloutFraction = toFraction ?? current.rollout_fraction;
+        const policySteps = current.policy.steps ?? [];
+        detail.release = withActions({
+            ...current,
+            next_fraction: toState === 'rolling'
+                ? (policySteps.find((step) => step > rolloutFraction) ?? null)
+                : null,
+            next_step_at: null,
+            rollout_fraction: rolloutFraction,
+            state: toState,
+            updated_at: clock,
+        });
+        return HttpResponse.json(detail.release);
+    };
     return [
         listProjectsMock(({ request }) => {
             const url = new URL(request.url);
@@ -74,5 +366,57 @@ export const createOoreMockHandlers = (scenario = defaultOoreScenario, options)
             projects.push(project);
             return HttpResponse.json({ project }, { status: 201 });
         }, options),
+        listReleasesMock(({ request }) => {
+            const url = new URL(request.url);
+            const projectId = url.searchParams.get('project_id');
+            const buildId = url.searchParams.get('build_id');
+            const states = url.searchParams.get('state')?.split(',');
+            const offset = Number(url.searchParams.get('offset') ?? 0);
+            const limit = Number(url.searchParams.get('limit') ?? 50);
+            const matching = releases
+                .map((detail) => detail.release)
+                .filter((release) => (!projectId || release.project_id === projectId) &&
+                (!buildId || release.build_id === buildId) &&
+                (!states || states.includes(release.state)))
+                .sort((a, b) => b.created_at - a.created_at);
+            return HttpResponse.json({
+                releases: matching.slice(offset, offset + limit).map(withActions),
+                total: matching.length,
+            });
+        }, options),
+        getReleaseMock(({ params }) => {
+            const detail = releases.find((item) => item.release.id === params.release_id);
+            if (!detail)
+                return apiError(404, 'not_found', 'Release not found');
+            return HttpResponse.json({
+                history: detail.history,
+                release: withActions(detail.release),
+            });
+        }, options),
+        listReleaseEventsMock(({ request }) => {
+            const url = new URL(request.url);
+            const projectId = url.searchParams.get('project_id');
+            const limit = Number(url.searchParams.get('limit') ?? 50);
+            const events = releases
+                .filter((detail) => !projectId || detail.release.project_id === projectId)
+                .flatMap(({ history, release }) => history.map((entry) => ({
+                ...entry,
+                build_id: release.build_id,
+                project_id: release.project_id,
+                project_name: release.project_name,
+                release_id: release.id,
+                store: release.store,
+                track: release.track,
+                version_name: release.version_name,
+            })))
+                .sort((a, b) => b.at - a.at);
+            return HttpResponse.json({ events: events.slice(0, limit) });
+        }, options),
+        raiseReleaseMock(releaseAction('raise'), options),
+        pauseReleaseMock(releaseAction('pause'), options),
+        resumeReleaseMock(releaseAction('resume'), options),
+        haltReleaseMock(releaseAction('halt'), options),
+        completeReleaseMock(releaseAction('complete'), options),
+        approveReleaseMock(releaseAction('approve'), options),
     ];
 };

package/dist/valibot.d.ts

@@ -245,6 +245,7 @@ export { vSetupSummaryResponse } from './generated/valibot/v-setup-summary-respo
 export { vSetupTrustedProxyClaimOwnerResponse } from './generated/valibot/v-setup-trusted-proxy-claim-owner-response.js';
 export { vSetupTrustedProxyConfigureRequest } from './generated/valibot/v-setup-trusted-proxy-configure-request.js';
 export { vSetupTrustedProxyConfigureResponse } from './generated/valibot/v-setup-trusted-proxy-configure-response.js';
+export { vSlackMention } from './generated/valibot/v-slack-mention.js';
 export { vSmtpTlsMode } from './generated/valibot/v-smtp-tls-mode.js';
 export { vSmtpConfig } from './generated/valibot/v-smtp-config.js';
 export { vCreateNotificationChannelRequest } from './generated/valibot/v-create-notification-channel-request.js';

package/dist/valibot.js

@@ -246,6 +246,7 @@ export { vSetupSummaryResponse } from './generated/valibot/v-setup-summary-respo
 export { vSetupTrustedProxyClaimOwnerResponse } from './generated/valibot/v-setup-trusted-proxy-claim-owner-response.js';
 export { vSetupTrustedProxyConfigureRequest } from './generated/valibot/v-setup-trusted-proxy-configure-request.js';
 export { vSetupTrustedProxyConfigureResponse } from './generated/valibot/v-setup-trusted-proxy-configure-response.js';
+export { vSlackMention } from './generated/valibot/v-slack-mention.js';
 export { vSmtpTlsMode } from './generated/valibot/v-smtp-tls-mode.js';
 export { vSmtpConfig } from './generated/valibot/v-smtp-config.js';
 export { vCreateNotificationChannelRequest } from './generated/valibot/v-create-notification-channel-request.js';

package/openapi/openapi.json

@@ -14046,6 +14046,13 @@
             ],
             "description": "Webhook: HMAC secret for signing payloads. Slack: bot token with\n`users:read.email`, used to mention the triggering user. Optional."
           },
+          "slack_mentions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SlackMention"
+            },
+            "description": "Slack member IDs to mention (Slack only). Works without a bot token."
+          },
           "smtp_config": {
             "oneOf": [
               {
@@ -16043,6 +16050,13 @@
             ],
             "description": "Project this channel is scoped to. Absent means the channel receives\nevents from every project, plus instance-wide events such as runner\noffline."
           },
+          "slack_mentions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SlackMention"
+            },
+            "description": "Slack member IDs to mention, matched against the person behind each\nevent (Slack only). Checked before the bot token lookup. Absent from\ndaemons that predate it, which is the same as none."
+          },
           "smtp_summary": {
             "oneOf": [
               {
@@ -19131,6 +19145,24 @@
           }
         }
       },
+      "SlackMention": {
+        "type": "object",
+        "description": "Maps a person to the Slack member mentioned in their notifications.",
+        "required": [
+          "identity",
+          "member_id"
+        ],
+        "properties": {
+          "identity": {
+            "type": "string",
+            "description": "Oore sign-in email (manual and API builds, releases) or Git username\n(push and merge request builds). Matched without regard to case."
+          },
+          "member_id": {
+            "type": "string",
+            "description": "Slack member ID, such as `U0123ABCD`."
+          }
+        }
+      },
       "SmtpConfig": {
         "type": "object",
         "required": [
@@ -19950,6 +19982,16 @@
             ],
             "description": "New HMAC secret (webhook) or bot token (slack). Omit to keep existing;\npass empty string to clear."
           },
+          "slack_mentions": {
+            "type": [
+              "array",
+              "null"
+            ],
+            "items": {
+              "$ref": "#/components/schemas/SlackMention"
+            },
+            "description": "New Slack member mappings (Slack only). Omit to keep existing; pass an\nempty list to clear."
+          },
           "smtp_config": {
             "oneOf": [
               {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oore/client",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Typed, tree-shakeable client for the Oore API",
   "type": "module",
   "sideEffects": false,
@@ -19,6 +19,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "bin": {
+    "oore-dev": "./dist/cli/main.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -70,7 +73,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun run clean && bun run generate && bun run typecheck && bunx tsc -p tsconfig.build.json",
+    "build": "bun run clean && bun run generate && bun run typecheck && bunx tsc -p tsconfig.build.json && bunx tsc -p tsconfig.cli.json",
     "check": "bun run generate && bun run typecheck && bun run check:coverage && bun test && bun run build && bun run check:exports && bun run check:tree-shaking",
     "check:coverage": "bun run scripts/check-coverage.ts",
     "check:exports": "bun run scripts/check-exports.ts",