@lunora/studio 0.0.0 → 1.0.0-alpha.1

package/dist/packem_shared/app.d-CCmwDEVs.d.ts

@@ -0,0 +1,300 @@
+import { CronJobInfo, ScheduleRecord, LunoraClient } from '@lunora/client';
+import { ReactElement } from 'react';
+import { I18n } from '@lingui/core';
+interface CronTriggersPanelProps {
+  /**
+  * Load the code-defined cron triggers. Defaults to `client.getCronJobs`,
+  * which hits the worker's admin-gated `/_lunora/admin/cron-jobs` endpoint —
+  * so the panel works out of the box under `<LunoraProvider>`, provided the
+  * worker is built with a `cronJobs` map and `adminToken`. Override it to
+  * source triggers from elsewhere (e.g. tests).
+  */
+  readonly loadCronJobs?: () => Promise<CronJobInfo[]>;
+  /**
+  * Manually fire one cron job by name. Defaults to `client.runCronJob`, which
+  * hits the admin-gated `POST /_lunora/admin/cron-jobs/run` endpoint (the same
+  * dispatch the scheduled trigger runs). When a custom {@link CronTriggersPanelProps.loadCronJobs}
+  * is supplied without a `runCronJob`, the "Run now" control is hidden — useful
+  * for a read-only view.
+  */
+  readonly runCronJob?: (name: string) => Promise<{
+    name: string;
+    ran: boolean;
+  }>;
+}
+/**
+* Read-only view of the **static cron triggers** — the `cronJobs()` map compiled
+* into the worker — with a per-row **Run now** action. Unlike the dynamic
+* `runAfter` / `runAt` schedule, the triggers themselves are fixed for the
+* deployment (Cloudflare exposes no runtime cron introspection, so the injected
+* map is the only source of truth and nothing here is editable). One row per
+* scheduled invocation: its cron expression, its target (a function dispatch or
+* a durable workflow start), any bound shard / args, and a button to fire it on
+* demand.
+*/
+interface ScheduledJobsProps {
+  /**
+  * Cancel a pending job by id. Defaults to `client.cancelScheduledJob` when
+  * {@link ScheduledJobsProps.loadJobs} is also left to the client. When a
+  * custom `loadJobs` is supplied without a `cancelJob`, the cancel control is
+  * hidden — useful for a read-only view.
+  */
+  readonly cancelJob?: (id: string) => Promise<{
+    cancelled: boolean;
+  }>;
+  /**
+  * Load the pending scheduled jobs. Defaults to `client.listScheduledJobs`,
+  * which hits the worker's admin-gated `/_lunora/admin/scheduled` endpoint —
+  * so the panel works out of the box under `&lt;LunoraProvider>`, provided the
+  * worker is built with a `schedulerDO` namespace and `adminToken`. Override
+  * it to source jobs from elsewhere.
+  */
+  readonly loadJobs?: () => Promise<ScheduleRecord[]>;
+}
+/**
+* View — and cancel — the functions queued via `runAfter` / `runAt` on the
+* scheduler. Cron *triggers* are static wrangler config and don't appear here;
+* this lists the dynamic, in-flight schedule only.
+*
+* Works out of the box under `&lt;LunoraProvider>` via the client's scheduler
+* admin methods; pass {@link ScheduledJobsProps.loadJobs} /
+* {@link ScheduledJobsProps.cancelJob} to override the transport.
+*/
+declare const ScheduledJobs: ({
+  cancelJob,
+  loadJobs
+}?: ScheduledJobsProps) => ReactElement;
+interface SchedulePanelProps {
+  /** Override how the Cron triggers sub-view loads triggers; see {@link CronTriggersPanel}. */
+  readonly loadCronJobs?: CronTriggersPanelProps["loadCronJobs"];
+  /** Override how the Scheduled jobs sub-view cancels a job; see {@link ScheduledJobs}. */
+  readonly scheduledCancel?: ScheduledJobsProps["cancelJob"];
+  /** Override how the Scheduled jobs sub-view loads jobs; see {@link ScheduledJobs}. */
+  readonly scheduledLoad?: ScheduledJobsProps["loadJobs"];
+}
+/**
+* The studio's Schedule tab. Hosts complementary surfaces behind a segmented
+* toggle. **Scheduled jobs** is the dynamic, in-flight queue — functions enqueued
+* via `runAfter` / `runAt`, live-updating and cancellable. **Dead letter** is the
+* recovery surface for jobs that exhausted their retries (retry or drop them).
+* **Pools** shows the workpool backlog / concurrency (`createWorkpool`). **Cron
+* triggers** is the static `cronJobs()` map compiled into the worker: fixed for
+* the deployment and read-only (Cloudflare exposes no runtime cron
+* introspection). Jobs is the default — it is the surface an operator acts on.
+*/
+/** Which client method a {@link FunctionDescriptor} is invoked through. */
+type FunctionKind = "action" | "mutation" | "query";
+/**
+* One argument of a registered function, derived from its `v.*` validator by the
+* worker's `/_lunora/admin/functions` endpoint. A compact signature shape.
+*/
+interface FunctionArgumentDescriptor {
+  /** Element validator kind for an `array` arg (one level), e.g. `string`. */
+  element?: string;
+  /** The (optional-unwrapped) validator kind, e.g. `string`, `id`, `object`. */
+  kind: string;
+  /** The argument name. */
+  name: string;
+  /** True when the arg is wrapped in `v.optional(...)`. */
+  optional: boolean;
+  /** Target table for an `id` arg (`v.id("table")`). */
+  table?: string;
+}
+/**
+* Runtime descriptor for a registered Lunora function. The function's `kind` is
+* a compile-time-only phantom on `FunctionReference`, so the runner needs it
+* spelled out here to know which client method to call. `args` carries the
+* function's argument signature (absent on responses from an older worker).
+*/
+interface FunctionDescriptor {
+  args?: FunctionArgumentDescriptor[];
+  kind: FunctionKind;
+  /** The `&lt;file>:&lt;function>` identifier, e.g. `messages:list`. */
+  path: string;
+}
+/** Outcome of a single `FunctionRunner` invocation. */
+type RunStatus = "error" | "idle" | "running" | "success";
+/** Identifier for each built-in studio tab. */
+type StudioTab = "analytics" | "api" | "audit" | "authConfig" | "authSessions" | "dashboards" | "data" | "drains" | "export" | "files" | "functions" | "health" | "home" | "insights" | "logs" | "mail" | "metrics" | "migrations" | "organizations" | "payments" | "permissions" | "pitr" | "realtime" | "rls" | "schedule" | "schema" | "security" | "settings" | "sql" | "storageRules" | "users" | "vectors" | "workflows";
+interface StudioProps {
+  /**
+  * URL path prefix the studio is mounted under, passed to the router as its
+  * `basepath`. Defaults to `/` (mounted at the origin root). The `@lunora/vite`
+  * dev route serves the studio under `/__lunora`, so it sets this — without
+  * it the router treats `/__lunora` as unknown and bounces to `/data`, escaping
+  * the mount.
+  */
+  readonly basePath?: string;
+  /**
+  * App-owned top-bar + sidebar-footer chrome (theme toggle, admin-token
+  * popover, rules banner). The batteries-included `StudioApp` supplies
+  * this; composing `&lt;Studio>` bare omits those affordances. See {@link StudioChrome}.
+  */
+  readonly chrome?: StudioChrome;
+  /**
+  * Make the data tab editable (insert/edit/delete rows). Off by default so
+  * the studio is read-only unless the host opts in; see {@link TableEditor}.
+  */
+  readonly dataEditable?: boolean;
+  /**
+  * Functions exposed in the runner tab. The runner tab only appears when at
+  * least one descriptor is supplied (a query/mutation/action's `kind` is
+  * compile-time-only, so it must be named here).
+  */
+  readonly functions?: FunctionDescriptor[];
+  /** Reuse an existing Lingui instance (wins over `locale`). */
+  readonly i18n?: I18n;
+  /** Shard key every shard-scoped panel targets on first load. */
+  readonly initialShardKey?: string;
+  /** Active locale for the studio's own UI strings. Defaults to `en`. */
+  readonly locale?: string;
+  /**
+  * Inline OpenAPI 3.1 document rendered by the API tab's reference sub-view.
+  * Thread the generated `_generated/openapi.json` here to render it
+  * without a round-trip. When omitted the reference fetches the worker's
+  * admin-gated `GET /_lunora/admin/openapi` endpoint via the client.
+  */
+  readonly openApiSpec?: unknown;
+  /**
+  * Inline OpenRPC 1.x document rendered by the API tab's reference sub-view
+  * when the OpenRPC format is selected. Thread the generated
+  * `_generated/openrpc.json` here to render it without a round-trip. When
+  * omitted the OpenRPC view fetches the worker's admin-gated
+  * `GET /_lunora/admin/openrpc` endpoint via the client.
+  */
+  readonly openRpcSpec?: unknown;
+  /**
+  * Allow the function runner to execute a function AS a chosen authenticated
+  * identity (the "Run as identity" tool), so an operator can test auth + RLS
+  * behavior. Security-sensitive: it forges identity on an admin-gated RPC, so
+  * the host MUST set this only on a trusted loopback-dev gate (the same gate
+  * as `dataEditable`) — never in a production/static deploy. Off by default;
+  * see {@link FunctionRunner}.
+  */
+  readonly runAsIdentity?: boolean;
+  /**
+  * Override how the schedule tab cancels a job. Defaults to the client's
+  * scheduler admin endpoint; see {@link SchedulePanel}.
+  */
+  readonly scheduledCancel?: SchedulePanelProps["scheduledCancel"];
+  /**
+  * Override how the schedule tab's Cron triggers sub-view loads triggers.
+  * Defaults to the client's `/_lunora/admin/cron-jobs` endpoint; see
+  * {@link SchedulePanel}.
+  */
+  readonly scheduledCron?: SchedulePanelProps["loadCronJobs"];
+  /**
+  * Override how the schedule tab loads jobs. Defaults to the client's
+  * scheduler admin endpoint, so the tab works without extra wiring.
+  */
+  readonly scheduledLoad?: SchedulePanelProps["scheduledLoad"];
+  /**
+  * Enable the visual schema editor overlay on the schema diagram (add table /
+  * column / index, written back to `lunora/schema.ts` + codegen). Off by default
+  * so the diagram stays read-only unless a host opts in. Like {@link
+  * StudioProps.dataEditable}, only the loopback-only dev hosts set this — the
+  * write path needs the project's filesystem + toolchain, so a static deploy
+  * leaves it off.
+  */
+  readonly schemaEditable?: boolean;
+}
+/**
+* Top-bar + sidebar-footer chrome the `StudioApp` owns (theme + admin
+* token state, the rules banner) but which renders *inside* the router-owned
+* {@link StudioLayout} (the header and sidebar footer). The layout is a route
+* component with no props, so it reads this from context rather than threading
+* it through the router. Absent (composing `&lt;Studio>` bare) the layout simply
+* omits those affordances.
+*/
+interface StudioChrome {
+  readonly clearToken: () => void;
+  readonly onTokenChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+  readonly rulesInstalled?: boolean;
+  readonly token: string;
+}
+/**
+* The composable studio. {@link StudioShell} reads its strings from `useT`,
+* which needs a `StudioI18nProvider` above it.
+*
+* When an `i18n` instance or a `locale` is supplied, this owns a provider so the
+* studio localises itself standalone. When neither is given it renders the
+* shell bare and inherits whatever provider is already in scope — the host app's
+* (`StudioApp` owns one for the top bar too) or the shared default — instead
+* of nesting a second, redundant provider.
+*/
+declare const Studio: ({
+  basePath,
+  chrome,
+  dataEditable,
+  functions,
+  i18n,
+  initialShardKey,
+  locale,
+  openApiSpec,
+  openRpcSpec,
+  runAsIdentity,
+  schemaEditable,
+  scheduledCancel,
+  scheduledCron,
+  scheduledLoad
+}: StudioProps) => ReactElement;
+interface StudioAppProps {
+  /**
+  * Admin bearer token to send with every admin request. When omitted the app
+  * renders a small prompt so an operator can paste it at runtime — handy in
+  * dev where you don't want to bake the token into a bundle.
+  */
+  readonly adminToken?: string;
+  /**
+  * URL path prefix the studio is mounted under (router `basepath`). Defaults
+  * to `/`. The `@lunora/vite` dev route sets `/__lunora`. Forwarded to the
+  * composed {@link Studio}.
+  */
+  readonly basePath?: string;
+  /**
+  * Base URL of the Lunora worker the studio talks to. Defaults to the
+  * current origin, which is correct when the studio is served from the
+  * same worker (the `@lunora/vite` dev route) or proxied to it.
+  */
+  readonly baseUrl?: string;
+  /**
+  * Inject a pre-built client instead of constructing one from `baseUrl` +
+  * the admin token. Used by the dev mock harness (and embeddings that own
+  * the client) so the chrome renders against a supplied client; when set,
+  * `baseUrl`/`adminToken` are ignored and this client is never closed here.
+  */
+  readonly client?: LunoraClient;
+  /** UI language for the studio's own strings. Defaults to `en`. */
+  readonly locale?: string;
+  /**
+  * Whether the project's Lunora agent skills ("rules") are installed. When
+  * explicitly `false`, the studio shows a one-line banner pointing at
+  * `lunora rules install`. The loopback dev hosts inject this; a static deploy
+  * leaves it unset (no banner).
+  */
+  readonly rulesInstalled?: boolean;
+  /** Forwarded to the composed {@link Studio} (functions, initialShardKey, scheduled overrides). */
+  readonly studio?: Omit<StudioProps, "children" | "chrome" | "i18n" | "locale">;
+}
+/**
+* A fully self-contained studio page: it constructs a {@link LunoraClient}
+* pointed at the worker, wires it through a `&lt;LunoraProvider>`, manages the
+* admin token + theme, and renders the composed {@link Studio} — handing it the
+* top-bar/sidebar {@link StudioChrome} (theme toggle, admin-token popover, rules
+* banner) so those affordances render inside the sidebar shell.
+*
+* Mount this directly (the standalone app and the `@lunora/vite` dev route both
+* do) when you want the batteries-included page rather than composing panels
+* yourself. For embedding into an existing admin UI, use the individual panels
+* or `&lt;Studio>` under your own provider instead.
+*/
+declare const StudioApp: ({
+  adminToken,
+  basePath,
+  baseUrl,
+  client: injectedClient,
+  rulesInstalled,
+  studio,
+  locale
+}?: StudioAppProps) => ReactElement;
+export { FunctionDescriptor as F, RunStatus as R, StudioAppProps as S, FunctionKind as a, ScheduledJobs as b, ScheduledJobsProps as c, Studio as d, StudioApp as e, StudioProps as f, StudioTab as g };

package/dist/packem_shared/badge-B2PKA1-5.js

@@ -0,0 +1,49 @@
+import { mergeProps } from '@base-ui/react/merge-props';
+import { useRender } from '@base-ui/react/use-render';
+import { cva } from 'class-variance-authority';
+import { c as cn } from './utils-B05Dmz_H.js';
+
+const badgeVariants = cva("group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-none border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pe-1.5 has-data-[icon=inline-start]:ps-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!", {
+  variants: {
+    // Semantic status variants get the Lunora "instrument-panel" label
+    // treatment (Geist Mono, ALL CAPS, tracked). Content variants
+    // (default/secondary/outline/…) stay normal-case so badges carrying
+    // proper nouns — table names, usernames — read correctly.
+    variant: {
+      default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
+      secondary: "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
+      destructive: "bg-destructive/10 text-destructive font-mono text-[11px] tracking-wide uppercase focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
+      outline: "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
+      ghost: "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
+      link: "text-primary underline-offset-4 hover:underline",
+      success: "bg-success/10 text-success font-mono text-[11px] tracking-wide uppercase [a]:hover:bg-success/15 dark:bg-success/15",
+      warning: "bg-warning/10 text-warning font-mono text-[11px] tracking-wide uppercase [a]:hover:bg-warning/15 dark:bg-warning/15",
+      info: "bg-info/10 text-info font-mono text-[11px] tracking-wide uppercase [a]:hover:bg-info/15 dark:bg-info/15"
+    }
+  },
+  defaultVariants: {
+    variant: "default"
+  }
+});
+function Badge({
+  className,
+  variant = "default",
+  render,
+  ...props
+}) {
+  return useRender({
+    defaultTagName: "span",
+    props: mergeProps({
+      className: cn(badgeVariants({
+        variant
+      }), className)
+    }, props),
+    render,
+    state: {
+      slot: "badge",
+      variant
+    }
+  });
+}
+
+export { Badge as B };