@rawdash/core 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,89 @@
+# @rawdash/core
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/core)](https://www.npmjs.com/package/@rawdash/core)
+[![license](https://img.shields.io/npm/l/@rawdash/core)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Headless dashboard backend primitives for rawdash. Define connectors, dashboards, widgets, and metrics — no UI assumptions, works anywhere.
+
+## What it is
+
+`@rawdash/core` is the foundation of the rawdash ecosystem. It provides the types and functions (`defineConfig`, `defineDashboard`, `defineMetric`, `defineConnector`, `secret`) that every rawdash setup is built on. It has no framework dependencies and no I/O — it only models your dashboard configuration and the connector interface.
+
+Other packages (`@rawdash/server`, `@rawdash/nextjs`, `@rawdash/mcp`) take a config produced by this package and add runtime behavior.
+
+## Install
+
+```sh
+npm install @rawdash/core @rawdash/connector-github
+```
+
+## Quick example
+
+```ts
+import { GitHubActionsConnector } from '@rawdash/connector-github';
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const github = new GitHubActionsConnector({
+  owner: 'my-org',
+  repo: 'my-repo',
+  token: secret('GITHUB_TOKEN'),
+});
+
+export default defineConfig({
+  connectors: [{ connector: github }],
+  dashboards: {
+    engineering: defineDashboard({
+      widgets: {
+        open_prs: {
+          kind: 'stat',
+          title: 'Open PRs',
+          metric: defineMetric({
+            connector: github,
+            shape: 'entity',
+            field: 'id',
+            fn: 'count',
+            filter: [{ field: 'state', op: 'eq', value: 'open' }],
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## API
+
+### `defineConfig(config)`
+
+Validates and returns a `DashboardConfig`. Throws if a widget references an unknown connector or uses invalid shape/fn values.
+
+### `defineDashboard({ widgets })`
+
+Validates and returns a `Dashboard`. Widget keys must be URL-safe (`[a-zA-Z0-9_-]`).
+
+### `defineMetric(options)`
+
+Returns a `ResolvedMetric` that can be used in stat, timeseries, and distribution widgets.
+
+### `secret(name)`
+
+Returns a `SecretRef` that resolves the named environment variable at runtime. Connectors that accept a `token` or API key should use this to avoid hardcoding credentials.
+
+### `defineConnector(options)`
+
+Low-level factory for authoring new connectors. Used by packages like `@rawdash/connector-github`.
+
+## Links
+
+- [rawdash docs](https://rawdash.dev)
+- [GitHub](https://github.com/rawdash/rawdash)
+- [Issues](https://github.com/rawdash/rawdash/issues)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,344 @@
+import { z } from 'zod';
+
+type SecretRef = {
+    $secret: string;
+};
+declare function secret(name: string): SecretRef;
+declare function isSecretRef(value: unknown): value is SecretRef;
+interface SecretsResolver {
+    resolve(name: string): string | undefined;
+}
+declare class EnvSecretsResolver implements SecretsResolver {
+    resolve(name: string): string | undefined;
+}
+declare function resolveSecretRefs<T>(obj: T, resolver: SecretsResolver): T;
+
+type JSONValue = string | number | boolean | null | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+interface Event {
+    name: string;
+    start_ts: number;
+    end_ts: number | null;
+    attributes: Record<string, JSONValue>;
+}
+interface Entity {
+    type: string;
+    id: string;
+    attributes: Record<string, JSONValue>;
+    updated_at: number;
+}
+interface Metric {
+    name: string;
+    ts: number;
+    value: number;
+    attributes: Record<string, JSONValue>;
+}
+interface Edge {
+    from_type: string;
+    from_id: string;
+    kind: string;
+    to_type: string;
+    to_id: string;
+    attributes: Record<string, JSONValue>;
+    updated_at: number;
+}
+type Distribution = {
+    name: string;
+    ts: number;
+    kind: 'histogram';
+    data: {
+        buckets: Array<{
+            le: number;
+            count: number;
+        }>;
+        count: number;
+        sum: number;
+    };
+    attributes: Record<string, JSONValue>;
+} | {
+    name: string;
+    ts: number;
+    kind: 'summary';
+    data: {
+        quantiles: Array<{
+            q: number;
+            value: number;
+        }>;
+        count: number;
+        sum: number;
+    };
+    attributes: Record<string, JSONValue>;
+};
+interface EventQuery {
+    name?: string;
+    start?: number;
+    end?: number;
+}
+interface EntityQuery {
+    type: string;
+}
+interface MetricQuery {
+    name?: string;
+    start?: number;
+    end?: number;
+}
+interface EdgeQuery {
+    fromType?: string;
+    fromId?: string;
+    kind?: string;
+    toType?: string;
+    toId?: string;
+}
+interface DistributionQuery {
+    name?: string;
+    start?: number;
+    end?: number;
+}
+interface StorageHandle {
+    event(e: Event): Promise<void>;
+    entity(e: Entity): Promise<void>;
+    metric(m: Metric): Promise<void>;
+    edge(e: Edge): Promise<void>;
+    distribution(d: Distribution): Promise<void>;
+    events(es: Event[], scope?: {
+        names?: string[];
+    }): Promise<void>;
+    entities(es: Entity[], scope?: {
+        types?: string[];
+    }): Promise<void>;
+    metrics(ms: Metric[], scope?: {
+        names?: string[];
+    }): Promise<void>;
+    edges(es: Edge[], scope?: {
+        kinds?: string[];
+    }): Promise<void>;
+    distributions(ds: Distribution[], scope?: {
+        names?: string[];
+    }): Promise<void>;
+    queryEvents(q: EventQuery): Promise<Event[]>;
+    getEntity(type: string, id: string): Promise<Entity | null>;
+    queryEntities(q: EntityQuery): Promise<Entity[]>;
+    queryMetrics(q: MetricQuery): Promise<Metric[]>;
+    traverse(q: EdgeQuery): Promise<Edge[]>;
+    queryDistributions(q: DistributionQuery): Promise<Distribution[]>;
+    deleteOlderThan(shape: 'events' | 'metrics' | 'distributions', tsUnixMs: number): Promise<{
+        rowsDeleted: number;
+    }>;
+}
+interface CredentialEntry {
+    description: string;
+    auth?: 'none' | 'optional' | 'required';
+}
+type CredentialSchema = Record<string, CredentialEntry>;
+type InferCredentials<TCreds extends CredentialSchema> = {
+    [K in keyof TCreds]: TCreds[K] extends {
+        auth: 'required';
+    } ? string : string | undefined;
+};
+type InferCredentialInput<TCreds extends CredentialSchema> = {
+    [K in keyof TCreds]: TCreds[K] extends {
+        auth: 'required';
+    } ? string | SecretRef : string | SecretRef | undefined;
+};
+interface SyncRequest {
+    mode: 'full' | 'latest';
+    since?: string;
+}
+interface Connector {
+    readonly id: string;
+    readonly credentials?: CredentialSchema;
+    sync(request: SyncRequest, storage: StorageHandle, signal?: AbortSignal): Promise<void>;
+}
+declare abstract class BaseConnector<TSettings = unknown, TCreds extends CredentialSchema = CredentialSchema> implements Connector {
+    abstract readonly id: string;
+    readonly credentials?: TCreds;
+    protected settings: TSettings;
+    protected creds: InferCredentials<TCreds>;
+    constructor(settings: TSettings, creds?: InferCredentialInput<TCreds>);
+    abstract sync(request: SyncRequest, storage: StorageHandle, signal?: AbortSignal): Promise<void>;
+}
+declare function defineConnector<TSettings>(): <TCreds extends CredentialSchema = Record<string, never>>(def: {
+    id: string;
+    credentials?: TCreds;
+    sync: (this: {
+        settings: TSettings;
+        creds: InferCredentials<TCreds>;
+    }, request: SyncRequest, storage: StorageHandle, signal?: AbortSignal) => Promise<void>;
+}) => {
+    new (settings: TSettings, creds?: InferCredentialInput<TCreds>): Connector;
+    readonly id: string;
+    readonly credentials: TCreds | undefined;
+};
+
+interface RetentionConfig {
+    maxAge?: number;
+    maxSize?: number;
+    floor?: number;
+    intervalMs?: number;
+}
+interface RetentionCandidates {
+    events: Event[];
+    metrics: Metric[];
+    distributions: Distribution[];
+}
+declare function selectForDeletion<T>(rows: T[], getTs: (row: T) => number, config: RetentionConfig, nowMs?: number): T[];
+declare function computeRetention(handle: StorageHandle, config: RetentionConfig, nowMs?: number): Promise<RetentionCandidates>;
+
+declare const widgetSchemas: {
+    readonly stat: z.ZodObject<{
+        title: z.ZodString;
+        metric: z.ZodString;
+        window: z.ZodOptional<z.ZodString>;
+        compare: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            "previous-period": "previous-period";
+        }>>;
+    }, z.core.$strip>;
+    readonly status: z.ZodObject<{
+        title: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strip>;
+    readonly timeseries: z.ZodObject<{
+        title: z.ZodString;
+        metric: z.ZodString;
+        window: z.ZodString;
+        granularity: z.ZodDefault<z.ZodEnum<{
+            hour: "hour";
+            day: "day";
+            week: "week";
+        }>>;
+    }, z.core.$strip>;
+    readonly distribution: z.ZodObject<{
+        title: z.ZodString;
+        metric: z.ZodString;
+        window: z.ZodString;
+    }, z.core.$strip>;
+};
+type WidgetKind = keyof typeof widgetSchemas;
+declare function getWidgetSchema(kind: WidgetKind): z.ZodObject<{
+    title: z.ZodString;
+    metric: z.ZodString;
+    window: z.ZodOptional<z.ZodString>;
+    compare: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        "previous-period": "previous-period";
+    }>>;
+}, z.core.$strip> | z.ZodObject<{
+    title: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip> | z.ZodObject<{
+    title: z.ZodString;
+    metric: z.ZodString;
+    window: z.ZodString;
+    granularity: z.ZodDefault<z.ZodEnum<{
+        hour: "hour";
+        day: "day";
+        week: "week";
+    }>>;
+}, z.core.$strip> | z.ZodObject<{
+    title: z.ZodString;
+    metric: z.ZodString;
+    window: z.ZodString;
+}, z.core.$strip>;
+
+type AggFn = 'count' | 'sum' | 'avg' | 'min' | 'max' | 'latest' | 'first';
+type Shape = 'event' | 'entity' | 'metric' | 'edge' | 'distribution';
+type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains';
+interface FilterCondition {
+    field: string;
+    op: FilterOperator;
+    value: string | number | boolean;
+}
+type FilterClause = FilterCondition | {
+    or: FilterCondition[];
+};
+interface GroupBy {
+    field: string;
+    granularity: 'hour' | 'day' | 'week' | 'month';
+}
+interface MetricDef {
+    connector: {
+        id: string;
+    };
+    shape: Shape;
+    name?: string;
+    entityType?: string;
+    field: string;
+    fn: AggFn;
+    window?: string;
+    filter?: FilterClause[];
+    groupBy?: GroupBy;
+}
+interface ResolvedMetric {
+    readonly connectorId: string;
+    readonly shape: Shape;
+    readonly name?: string;
+    readonly entityType?: string;
+    readonly field: string;
+    readonly fn: string;
+    readonly window?: string;
+    readonly filter?: FilterClause[];
+    readonly groupBy?: GroupBy;
+}
+interface StatWidget {
+    kind: 'stat';
+    title: string;
+    metric: ResolvedMetric;
+    window?: string;
+    compare?: 'none' | 'previous-period';
+}
+interface StatusWidget {
+    kind: 'status';
+    title: string;
+    source: string;
+}
+interface TimeseriesWidget {
+    kind: 'timeseries';
+    title: string;
+    metric: ResolvedMetric;
+    window: string;
+    granularity?: 'hour' | 'day' | 'week';
+}
+interface DistributionWidget {
+    kind: 'distribution';
+    title: string;
+    metric: ResolvedMetric;
+    window: string;
+}
+type Widget = StatWidget | StatusWidget | TimeseriesWidget | DistributionWidget;
+
+interface ConnectorEntry {
+    connector: Connector;
+}
+interface Dashboard {
+    widgets: Record<string, Widget>;
+}
+interface DashboardConfig {
+    connectors: ConnectorEntry[];
+    dashboards: Record<string, Dashboard>;
+    retention?: RetentionConfig;
+}
+declare function defineDashboard(options: {
+    widgets: Record<string, Widget>;
+}): Dashboard;
+declare function defineMetric(options: MetricDef): ResolvedMetric;
+declare function defineConfig(config: DashboardConfig): DashboardConfig;
+
+interface WidgetEntry {
+    id: string;
+    widgetId: string;
+    connectorId: string;
+    data: unknown;
+    cachedAt: string | null;
+}
+interface SyncState {
+    status: 'idle' | 'syncing' | 'error';
+    lastSyncAt: string | null;
+    lastError: string | null;
+}
+
+type ConfigFieldsSchema = z.ZodObject<z.ZodRawShape>;
+declare function defineConfigFields<T extends z.ZodRawShape>(schema: z.ZodObject<T>): z.ZodObject<T>;
+
+export { type AggFn, BaseConnector, type ConfigFieldsSchema, type Connector, type ConnectorEntry, type CredentialEntry, type CredentialSchema, type Dashboard, type DashboardConfig, type Distribution, type DistributionQuery, type DistributionWidget, type Edge, type EdgeQuery, type Entity, type EntityQuery, EnvSecretsResolver, type Event, type EventQuery, type FilterClause, type FilterCondition, type FilterOperator, type GroupBy, type InferCredentialInput, type InferCredentials, type JSONValue, type Metric, type MetricDef, type MetricQuery, type ResolvedMetric, type RetentionCandidates, type RetentionConfig, type SecretRef, type SecretsResolver, type Shape, type StatWidget, type StatusWidget, type StorageHandle, type SyncRequest, type SyncState, type TimeseriesWidget, type Widget, type WidgetEntry, type WidgetKind, computeRetention, defineConfig, defineConfigFields, defineConnector, defineDashboard, defineMetric, getWidgetSchema, isSecretRef, resolveSecretRefs, secret, selectForDeletion, widgetSchemas };

package/dist/index.js

@@ -0,0 +1,302 @@
+// src/secrets.ts
+function secret(name) {
+  if (!/^[A-Z][A-Z0-9_]*$/.test(name)) {
+    throw new Error(
+      `Invalid secret name "${name}". Must match /^[A-Z][A-Z0-9_]*$/ (uppercase letters, digits, underscores; must start with a letter).`
+    );
+  }
+  return { $secret: name };
+}
+function isSecretRef(value) {
+  return typeof value === "object" && value !== null && "$secret" in value && typeof value.$secret === "string";
+}
+var EnvSecretsResolver = class {
+  resolve(name) {
+    const env = globalThis.process?.env;
+    return env?.[name];
+  }
+};
+function resolveSecretRefs(obj, resolver) {
+  if (isSecretRef(obj)) {
+    const name = obj.$secret;
+    const value = resolver.resolve(name);
+    if (value === void 0) {
+      throw new Error(
+        `Missing secret "${name}". Set it via process.env.${name} or the CLI: rawdash secrets set ${name} ...`
+      );
+    }
+    return value;
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => resolveSecretRefs(item, resolver));
+  }
+  if (typeof obj === "object" && obj !== null) {
+    const result = {};
+    for (const [key, val] of Object.entries(obj)) {
+      Object.defineProperty(result, key, {
+        value: resolveSecretRefs(val, resolver),
+        enumerable: true,
+        configurable: true,
+        writable: true
+      });
+    }
+    return result;
+  }
+  return obj;
+}
+
+// src/connector.ts
+var BaseConnector = class {
+  credentials;
+  settings;
+  creds;
+  constructor(settings, creds) {
+    this.settings = settings;
+    this.creds = creds ? resolveSecretRefs(
+      creds,
+      new EnvSecretsResolver()
+    ) : {};
+  }
+};
+function defineConnector() {
+  return function(def) {
+    class DynamicConnector extends BaseConnector {
+      static id = def.id;
+      static credentials = def.credentials;
+      id = def.id;
+      credentials = def.credentials;
+      async sync(request, storage, signal) {
+        return def.sync.call(
+          { settings: this.settings, creds: this.creds },
+          request,
+          storage,
+          signal
+        );
+      }
+    }
+    return DynamicConnector;
+  };
+}
+
+// src/widget-schemas.ts
+import { z } from "zod";
+var widgetSchemas = {
+  stat: z.object({
+    title: z.string().meta({ label: "Title", description: "Widget title." }),
+    metric: z.string().meta({ label: "Metric", description: "Metric reference." }),
+    window: z.string().optional().meta({ label: "Window", description: "Time window, e.g. '7d'." }),
+    compare: z.enum(["none", "previous-period"]).default("none").meta({ label: "Compare", description: "Comparison mode." })
+  }),
+  status: z.object({
+    title: z.string().meta({ label: "Title", description: "Widget title." }),
+    source: z.string().meta({
+      label: "Source",
+      description: "Connector or data source reference."
+    })
+  }),
+  timeseries: z.object({
+    title: z.string().meta({ label: "Title", description: "Widget title." }),
+    metric: z.string().meta({ label: "Metric", description: "Metric reference." }),
+    window: z.string().meta({ label: "Window", description: "Time window, e.g. '30d'." }),
+    granularity: z.enum(["hour", "day", "week"]).default("day").meta({ label: "Granularity", description: "Time bucket size." })
+  }),
+  distribution: z.object({
+    title: z.string().meta({ label: "Title", description: "Widget title." }),
+    metric: z.string().meta({ label: "Metric", description: "Metric reference." }),
+    window: z.string().meta({ label: "Window", description: "Time window, e.g. '7d'." })
+  })
+};
+function getWidgetSchema(kind) {
+  return widgetSchemas[kind];
+}
+
+// src/config.ts
+var VALID_WIDGET_KINDS = new Set(Object.keys(widgetSchemas));
+function defineDashboard(options) {
+  for (const [key, widget] of Object.entries(options.widgets)) {
+    if (!VALID_WIDGET_KINDS.has(widget.kind)) {
+      throw new Error(
+        `Widget "${key}": unknown kind "${widget.kind}". Must be one of: ${[...VALID_WIDGET_KINDS].join(", ")}`
+      );
+    }
+    const schema = getWidgetSchema(widget.kind);
+    const parseInput = { ...widget };
+    if (widget.kind !== "status") {
+      const m = widget.metric;
+      if (typeof m !== "object" || m === null) {
+        throw new Error(
+          `Widget "${key}" (kind "${widget.kind}"): metric is required`
+        );
+      }
+      parseInput.metric = "placeholder";
+    }
+    const result = schema.safeParse(parseInput);
+    if (!result.success) {
+      throw new Error(
+        `Widget "${key}" (kind "${widget.kind}"): ${result.error.issues.map((i) => i.message).join("; ")}`
+      );
+    }
+  }
+  return { widgets: options.widgets };
+}
+function defineMetric(options) {
+  return {
+    connectorId: options.connector.id,
+    shape: options.shape,
+    name: options.name,
+    entityType: options.entityType,
+    field: options.field,
+    fn: options.fn,
+    window: options.window,
+    filter: options.filter,
+    groupBy: options.groupBy
+  };
+}
+var VALID_SHAPES = /* @__PURE__ */ new Set([
+  "event",
+  "entity",
+  "metric",
+  "edge",
+  "distribution"
+]);
+var VALID_FNS = /* @__PURE__ */ new Set([
+  "count",
+  "sum",
+  "avg",
+  "min",
+  "max",
+  "latest",
+  "first"
+]);
+var SAFE_KEY_RE = /^[a-zA-Z0-9_-]+$/;
+function validateConfig(config) {
+  if (config.retention) {
+    const { maxAge, maxSize, floor, intervalMs } = config.retention;
+    if (maxAge !== void 0 && (!Number.isFinite(maxAge) || maxAge < 0)) {
+      throw new Error("retention.maxAge must be a finite number >= 0");
+    }
+    if (maxSize !== void 0 && (!Number.isInteger(maxSize) || maxSize < 0)) {
+      throw new Error("retention.maxSize must be an integer >= 0");
+    }
+    if (floor !== void 0 && (!Number.isInteger(floor) || floor < 0)) {
+      throw new Error("retention.floor must be an integer >= 0");
+    }
+    if (intervalMs !== void 0 && (!Number.isFinite(intervalMs) || intervalMs <= 0)) {
+      throw new Error("retention.intervalMs must be a finite number > 0");
+    }
+  }
+  if (!config.dashboards || typeof config.dashboards !== "object" || Array.isArray(config.dashboards)) {
+    throw new Error(
+      'defineConfig: config must include a "dashboards" record \u2014 did you mean to migrate from the old flat "widgets" shape?'
+    );
+  }
+  const connectorIds = new Set(config.connectors.map((e) => e.connector.id));
+  for (const [dashboardKey, dashboard] of Object.entries(config.dashboards)) {
+    if (!dashboard.widgets || typeof dashboard.widgets !== "object" || Array.isArray(dashboard.widgets)) {
+      throw new Error(
+        `Dashboard "${dashboardKey}" must define a "widgets" record`
+      );
+    }
+    if (!SAFE_KEY_RE.test(dashboardKey)) {
+      throw new Error(
+        `Dashboard key "${dashboardKey}" contains URL-unsafe characters; use only letters, digits, hyphens, and underscores`
+      );
+    }
+    for (const [widgetKey, widget] of Object.entries(dashboard.widgets)) {
+      const ref = `Dashboard "${dashboardKey}", widget "${widgetKey}"`;
+      if (!SAFE_KEY_RE.test(widgetKey)) {
+        throw new Error(
+          `${ref}: widget key contains URL-unsafe characters; use only letters, digits, hyphens, and underscores`
+        );
+      }
+      if (widget.kind === "status") {
+        continue;
+      }
+      const { connectorId, shape, fn } = widget.metric;
+      if (!connectorIds.has(connectorId)) {
+        throw new Error(
+          `${ref}: connector "${connectorId}" is not listed in connectors`
+        );
+      }
+      if (!VALID_SHAPES.has(shape)) {
+        throw new Error(`${ref}: invalid shape "${shape}"`);
+      }
+      if (!VALID_FNS.has(fn)) {
+        throw new Error(`${ref}: invalid fn "${fn}"`);
+      }
+    }
+  }
+}
+function defineConfig(config) {
+  validateConfig(config);
+  return config;
+}
+
+// src/retention.ts
+function selectForDeletion(rows, getTs, config, nowMs = Date.now()) {
+  const { maxAge, maxSize, floor = 0 } = config;
+  if (maxAge === void 0 && maxSize === void 0) {
+    return [];
+  }
+  const toDelete = [];
+  for (let i = 0; i < rows.length; i++) {
+    const row = rows[i];
+    if (i < floor) {
+      continue;
+    }
+    const overSize = maxSize !== void 0 && i >= maxSize;
+    const tooOld = maxAge !== void 0 && getTs(row) < nowMs - maxAge;
+    if (overSize || tooOld) {
+      toDelete.push(row);
+    }
+  }
+  return toDelete;
+}
+async function computeRetention(handle, config, nowMs = Date.now()) {
+  const [events, metrics, distributions] = await Promise.all([
+    handle.queryEvents({}),
+    handle.queryMetrics({}),
+    handle.queryDistributions({})
+  ]);
+  const sortedEvents = [...events].sort((a, b) => b.start_ts - a.start_ts);
+  const sortedMetrics = [...metrics].sort((a, b) => b.ts - a.ts);
+  const sortedDistributions = [...distributions].sort((a, b) => b.ts - a.ts);
+  return {
+    events: selectForDeletion(sortedEvents, (e) => e.start_ts, config, nowMs),
+    metrics: selectForDeletion(sortedMetrics, (m) => m.ts, config, nowMs),
+    distributions: selectForDeletion(
+      sortedDistributions,
+      (d) => d.ts,
+      config,
+      nowMs
+    )
+  };
+}
+
+// src/config-fields.ts
+import { z as z2 } from "zod";
+function defineConfigFields(schema) {
+  if (!(schema instanceof z2.ZodObject)) {
+    throw new Error(
+      `configFields must be a Zod object schema (z.object({...})). Received: ${Object.prototype.toString.call(schema)}`
+    );
+  }
+  return schema;
+}
+export {
+  BaseConnector,
+  EnvSecretsResolver,
+  computeRetention,
+  defineConfig,
+  defineConfigFields,
+  defineConnector,
+  defineDashboard,
+  defineMetric,
+  getWidgetSchema,
+  isSecretRef,
+  resolveSecretRefs,
+  secret,
+  selectForDeletion,
+  widgetSchemas
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/secrets.ts","../src/connector.ts","../src/widget-schemas.ts","../src/config.ts","../src/retention.ts","../src/config-fields.ts"],"sourcesContent":["export type SecretRef = { $secret: string };\n\nexport function secret(name: string): SecretRef {\n  if (!/^[A-Z][A-Z0-9_]*$/.test(name)) {\n    throw new Error(\n      `Invalid secret name \"${name}\". Must match /^[A-Z][A-Z0-9_]*$/ ` +\n        `(uppercase letters, digits, underscores; must start with a letter).`,\n    );\n  }\n  return { $secret: name };\n}\n\nexport function isSecretRef(value: unknown): value is SecretRef {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '$secret' in value &&\n    typeof (value as SecretRef).$secret === 'string'\n  );\n}\n\nexport interface SecretsResolver {\n  resolve(name: string): string | undefined;\n}\n\nexport class EnvSecretsResolver implements SecretsResolver {\n  resolve(name: string): string | undefined {\n    const env = (\n      globalThis as { process?: { env?: Record<string, string | undefined> } }\n    ).process?.env;\n    return env?.[name];\n  }\n}\n\nexport function resolveSecretRefs<T>(obj: T, resolver: SecretsResolver): T {\n  if (isSecretRef(obj)) {\n    const name = obj.$secret;\n    const value = resolver.resolve(name);\n    if (value === undefined) {\n      throw new Error(\n        `Missing secret \"${name}\". Set it via process.env.${name} or the CLI: rawdash secrets set ${name} ...`,\n      );\n    }\n    return value as unknown as T;\n  }\n  if (Array.isArray(obj)) {\n    return obj.map((item) => resolveSecretRefs(item, resolver)) as unknown as T;\n  }\n  if (typeof obj === 'object' && obj !== null) {\n    const result: Record<string, unknown> = {};\n    for (const [key, val] of Object.entries(obj as object)) {\n      Object.defineProperty(result, key, {\n        value: resolveSecretRefs(val, resolver),\n        enumerable: true,\n        configurable: true,\n        writable: true,\n      });\n    }\n    return result as T;\n  }\n  return obj;\n}\n","import {\n  EnvSecretsResolver,\n  type SecretRef,\n  resolveSecretRefs,\n} from './secrets';\n\nexport type JSONValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JSONValue[]\n  | { [key: string]: JSONValue };\n\n// ---------------------------------------------------------------------------\n// Five storage shapes\n// ---------------------------------------------------------------------------\n\nexport interface Event {\n  name: string;\n  start_ts: number;\n  end_ts: number | null;\n  attributes: Record<string, JSONValue>;\n}\n\nexport interface Entity {\n  type: string;\n  id: string;\n  attributes: Record<string, JSONValue>;\n  updated_at: number;\n}\n\nexport interface Metric {\n  name: string;\n  ts: number;\n  value: number;\n  attributes: Record<string, JSONValue>;\n}\n\nexport interface Edge {\n  from_type: string;\n  from_id: string;\n  kind: string;\n  to_type: string;\n  to_id: string;\n  attributes: Record<string, JSONValue>;\n  updated_at: number;\n}\n\nexport type Distribution =\n  | {\n      name: string;\n      ts: number;\n      kind: 'histogram';\n      data: {\n        buckets: Array<{ le: number; count: number }>;\n        count: number;\n        sum: number;\n      };\n      attributes: Record<string, JSONValue>;\n    }\n  | {\n      name: string;\n      ts: number;\n      kind: 'summary';\n      data: {\n        quantiles: Array<{ q: number; value: number }>;\n        count: number;\n        sum: number;\n      };\n      attributes: Record<string, JSONValue>;\n    };\n\n// ---------------------------------------------------------------------------\n// Storage query types\n// ---------------------------------------------------------------------------\n\nexport interface EventQuery {\n  name?: string;\n  start?: number;\n  end?: number;\n}\n\nexport interface EntityQuery {\n  type: string;\n}\n\nexport interface MetricQuery {\n  name?: string;\n  start?: number;\n  end?: number;\n}\n\nexport interface EdgeQuery {\n  fromType?: string;\n  fromId?: string;\n  kind?: string;\n  toType?: string;\n  toId?: string;\n}\n\nexport interface DistributionQuery {\n  name?: string;\n  start?: number;\n  end?: number;\n}\n\n// ---------------------------------------------------------------------------\n// StorageHandle — write and read surface\n// ---------------------------------------------------------------------------\n\nexport interface StorageHandle {\n  event(e: Event): Promise<void>;\n  entity(e: Entity): Promise<void>;\n  metric(m: Metric): Promise<void>;\n  edge(e: Edge): Promise<void>;\n  distribution(d: Distribution): Promise<void>;\n\n  events(es: Event[], scope?: { names?: string[] }): Promise<void>;\n  entities(es: Entity[], scope?: { types?: string[] }): Promise<void>;\n  metrics(ms: Metric[], scope?: { names?: string[] }): Promise<void>;\n  edges(es: Edge[], scope?: { kinds?: string[] }): Promise<void>;\n  distributions(\n    ds: Distribution[],\n    scope?: { names?: string[] },\n  ): Promise<void>;\n\n  queryEvents(q: EventQuery): Promise<Event[]>;\n  getEntity(type: string, id: string): Promise<Entity | null>;\n  queryEntities(q: EntityQuery): Promise<Entity[]>;\n  queryMetrics(q: MetricQuery): Promise<Metric[]>;\n  traverse(q: EdgeQuery): Promise<Edge[]>;\n  queryDistributions(q: DistributionQuery): Promise<Distribution[]>;\n\n  // Deletes all rows in the given time-series shape whose timestamp column is\n  // strictly less than `tsUnixMs`. Only covers append-only shapes (events,\n  // metrics, distributions). Entities and edges are excluded because they hold\n  // the latest known state per primary key — deleting by age would lose live\n  // data. The right model for those shapes is \"expire when source disappears.\"\n  deleteOlderThan(\n    shape: 'events' | 'metrics' | 'distributions',\n    tsUnixMs: number,\n  ): Promise<{ rowsDeleted: number }>;\n}\n\n// ---------------------------------------------------------------------------\n// Credentials\n// ---------------------------------------------------------------------------\n\nexport interface CredentialEntry {\n  description: string;\n  auth?: 'none' | 'optional' | 'required';\n}\n\nexport type CredentialSchema = Record<string, CredentialEntry>;\n\nexport type InferCredentials<TCreds extends CredentialSchema> = {\n  [K in keyof TCreds]: TCreds[K] extends { auth: 'required' }\n    ? string\n    : string | undefined;\n};\n\nexport type InferCredentialInput<TCreds extends CredentialSchema> = {\n  [K in keyof TCreds]: TCreds[K] extends { auth: 'required' }\n    ? string | SecretRef\n    : string | SecretRef | undefined;\n};\n\n// ---------------------------------------------------------------------------\n// Sync + Connector\n// ---------------------------------------------------------------------------\n\nexport interface SyncRequest {\n  mode: 'full' | 'latest';\n  since?: string;\n}\n\nexport interface Connector {\n  readonly id: string;\n  readonly credentials?: CredentialSchema;\n  sync(\n    request: SyncRequest,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<void>;\n}\n\nexport abstract class BaseConnector<\n  TSettings = unknown,\n  TCreds extends CredentialSchema = CredentialSchema,\n> implements Connector {\n  abstract readonly id: string;\n  readonly credentials?: TCreds;\n\n  protected settings: TSettings;\n  protected creds: InferCredentials<TCreds>;\n\n  constructor(settings: TSettings, creds?: InferCredentialInput<TCreds>) {\n    this.settings = settings;\n    this.creds = creds\n      ? (resolveSecretRefs(\n          creds,\n          new EnvSecretsResolver(),\n        ) as InferCredentials<TCreds>)\n      : ({} as InferCredentials<TCreds>);\n  }\n\n  abstract sync(\n    request: SyncRequest,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<void>;\n}\n\nexport function defineConnector<TSettings>() {\n  return function <\n    TCreds extends CredentialSchema = Record<string, never>,\n  >(def: {\n    id: string;\n    credentials?: TCreds;\n    sync: (\n      this: { settings: TSettings; creds: InferCredentials<TCreds> },\n      request: SyncRequest,\n      storage: StorageHandle,\n      signal?: AbortSignal,\n    ) => Promise<void>;\n  }): {\n    new (settings: TSettings, creds?: InferCredentialInput<TCreds>): Connector;\n    readonly id: string;\n    readonly credentials: TCreds | undefined;\n  } {\n    class DynamicConnector extends BaseConnector<TSettings, TCreds> {\n      static readonly id = def.id;\n      static readonly credentials = def.credentials;\n\n      readonly id = def.id;\n      override readonly credentials = def.credentials;\n\n      async sync(\n        request: SyncRequest,\n        storage: StorageHandle,\n        signal?: AbortSignal,\n      ): Promise<void> {\n        return def.sync.call(\n          { settings: this.settings, creds: this.creds },\n          request,\n          storage,\n          signal,\n        );\n      }\n    }\n\n    return DynamicConnector as unknown as {\n      new (\n        settings: TSettings,\n        creds?: InferCredentialInput<TCreds>,\n      ): Connector;\n      readonly id: string;\n      readonly credentials: TCreds | undefined;\n    };\n  };\n}\n","import { z } from 'zod';\n\nexport const widgetSchemas = {\n  stat: z.object({\n    title: z.string().meta({ label: 'Title', description: 'Widget title.' }),\n    metric: z\n      .string()\n      .meta({ label: 'Metric', description: 'Metric reference.' }),\n    window: z\n      .string()\n      .optional()\n      .meta({ label: 'Window', description: \"Time window, e.g. '7d'.\" }),\n    compare: z\n      .enum(['none', 'previous-period'])\n      .default('none')\n      .meta({ label: 'Compare', description: 'Comparison mode.' }),\n  }),\n  status: z.object({\n    title: z.string().meta({ label: 'Title', description: 'Widget title.' }),\n    source: z.string().meta({\n      label: 'Source',\n      description: 'Connector or data source reference.',\n    }),\n  }),\n  timeseries: z.object({\n    title: z.string().meta({ label: 'Title', description: 'Widget title.' }),\n    metric: z\n      .string()\n      .meta({ label: 'Metric', description: 'Metric reference.' }),\n    window: z\n      .string()\n      .meta({ label: 'Window', description: \"Time window, e.g. '30d'.\" }),\n    granularity: z\n      .enum(['hour', 'day', 'week'])\n      .default('day')\n      .meta({ label: 'Granularity', description: 'Time bucket size.' }),\n  }),\n  distribution: z.object({\n    title: z.string().meta({ label: 'Title', description: 'Widget title.' }),\n    metric: z\n      .string()\n      .meta({ label: 'Metric', description: 'Metric reference.' }),\n    window: z\n      .string()\n      .meta({ label: 'Window', description: \"Time window, e.g. '7d'.\" }),\n  }),\n} as const;\n\nexport type WidgetKind = keyof typeof widgetSchemas;\n\nexport function getWidgetSchema(kind: WidgetKind) {\n  return widgetSchemas[kind];\n}\n","import type { Connector } from './connector';\nimport type { RetentionConfig } from './retention';\nimport { getWidgetSchema, widgetSchemas } from './widget-schemas';\nimport type { WidgetKind } from './widget-schemas';\n\n// ---------------------------------------------------------------------------\n// Aggregation functions\n// ---------------------------------------------------------------------------\n\nexport type AggFn =\n  | 'count'\n  | 'sum'\n  | 'avg'\n  | 'min'\n  | 'max'\n  | 'latest'\n  | 'first';\n\n// ---------------------------------------------------------------------------\n// Shape\n// ---------------------------------------------------------------------------\n\nexport type Shape = 'event' | 'entity' | 'metric' | 'edge' | 'distribution';\n\n// ---------------------------------------------------------------------------\n// Filters\n// ---------------------------------------------------------------------------\n\nexport type FilterOperator =\n  | 'eq'\n  | 'neq'\n  | 'gt'\n  | 'gte'\n  | 'lt'\n  | 'lte'\n  | 'contains';\n\nexport interface FilterCondition {\n  field: string;\n  op: FilterOperator;\n  value: string | number | boolean;\n}\n\nexport type FilterClause = FilterCondition | { or: FilterCondition[] };\n\n// ---------------------------------------------------------------------------\n// GroupBy\n// ---------------------------------------------------------------------------\n\nexport interface GroupBy {\n  field: string;\n  granularity: 'hour' | 'day' | 'week' | 'month';\n}\n\n// ---------------------------------------------------------------------------\n// Metric definition\n// ---------------------------------------------------------------------------\n\nexport interface MetricDef {\n  connector: { id: string };\n  shape: Shape;\n  name?: string;\n  entityType?: string;\n  field: string;\n  fn: AggFn;\n  window?: string;\n  filter?: FilterClause[];\n  groupBy?: GroupBy;\n}\n\nexport interface ResolvedMetric {\n  readonly connectorId: string;\n  readonly shape: Shape;\n  readonly name?: string;\n  readonly entityType?: string;\n  readonly field: string;\n  readonly fn: string;\n  readonly window?: string;\n  readonly filter?: FilterClause[];\n  readonly groupBy?: GroupBy;\n}\n\n// ---------------------------------------------------------------------------\n// Widget definition\n// ---------------------------------------------------------------------------\n\nexport interface StatWidget {\n  kind: 'stat';\n  title: string;\n  metric: ResolvedMetric;\n  window?: string;\n  compare?: 'none' | 'previous-period';\n}\n\nexport interface StatusWidget {\n  kind: 'status';\n  title: string;\n  source: string;\n}\n\nexport interface TimeseriesWidget {\n  kind: 'timeseries';\n  title: string;\n  metric: ResolvedMetric;\n  window: string;\n  granularity?: 'hour' | 'day' | 'week';\n}\n\nexport interface DistributionWidget {\n  kind: 'distribution';\n  title: string;\n  metric: ResolvedMetric;\n  window: string;\n}\n\nexport type Widget =\n  | StatWidget\n  | StatusWidget\n  | TimeseriesWidget\n  | DistributionWidget;\n\nexport type { WidgetKind };\n\n// ---------------------------------------------------------------------------\n// Dashboard config\n// ---------------------------------------------------------------------------\n\nexport interface ConnectorEntry {\n  connector: Connector;\n}\n\nexport interface Dashboard {\n  widgets: Record<string, Widget>;\n}\n\nexport interface DashboardConfig {\n  connectors: ConnectorEntry[];\n  dashboards: Record<string, Dashboard>;\n  retention?: RetentionConfig;\n}\n\n// ---------------------------------------------------------------------------\n// defineDashboard\n// ---------------------------------------------------------------------------\n\nconst VALID_WIDGET_KINDS = new Set<string>(Object.keys(widgetSchemas));\n\nexport function defineDashboard(options: {\n  widgets: Record<string, Widget>;\n}): Dashboard {\n  for (const [key, widget] of Object.entries(options.widgets)) {\n    if (!VALID_WIDGET_KINDS.has(widget.kind)) {\n      throw new Error(\n        `Widget \"${key}\": unknown kind \"${widget.kind}\". Must be one of: ${[...VALID_WIDGET_KINDS].join(', ')}`,\n      );\n    }\n    const schema = getWidgetSchema(widget.kind as WidgetKind);\n    const parseInput: Record<string, unknown> = { ...widget };\n    if (widget.kind !== 'status') {\n      const m = (widget as { metric?: unknown }).metric;\n      if (typeof m !== 'object' || m === null) {\n        throw new Error(\n          `Widget \"${key}\" (kind \"${widget.kind}\"): metric is required`,\n        );\n      }\n      parseInput.metric = 'placeholder';\n    }\n    const result = schema.safeParse(parseInput);\n    if (!result.success) {\n      throw new Error(\n        `Widget \"${key}\" (kind \"${widget.kind}\"): ${result.error.issues.map((i) => i.message).join('; ')}`,\n      );\n    }\n  }\n  return { widgets: options.widgets };\n}\n\n// ---------------------------------------------------------------------------\n// defineMetric\n// ---------------------------------------------------------------------------\n\nexport function defineMetric(options: MetricDef): ResolvedMetric {\n  return {\n    connectorId: options.connector.id,\n    shape: options.shape,\n    name: options.name,\n    entityType: options.entityType,\n    field: options.field,\n    fn: options.fn,\n    window: options.window,\n    filter: options.filter,\n    groupBy: options.groupBy,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// defineConfig\n// ---------------------------------------------------------------------------\n\nconst VALID_SHAPES = new Set<string>([\n  'event',\n  'entity',\n  'metric',\n  'edge',\n  'distribution',\n]);\nconst VALID_FNS = new Set<string>([\n  'count',\n  'sum',\n  'avg',\n  'min',\n  'max',\n  'latest',\n  'first',\n]);\n\nconst SAFE_KEY_RE = /^[a-zA-Z0-9_-]+$/;\n\nfunction validateConfig(config: DashboardConfig): void {\n  if (config.retention) {\n    const { maxAge, maxSize, floor, intervalMs } = config.retention;\n    if (maxAge !== undefined && (!Number.isFinite(maxAge) || maxAge < 0)) {\n      throw new Error('retention.maxAge must be a finite number >= 0');\n    }\n    if (maxSize !== undefined && (!Number.isInteger(maxSize) || maxSize < 0)) {\n      throw new Error('retention.maxSize must be an integer >= 0');\n    }\n    if (floor !== undefined && (!Number.isInteger(floor) || floor < 0)) {\n      throw new Error('retention.floor must be an integer >= 0');\n    }\n    if (\n      intervalMs !== undefined &&\n      (!Number.isFinite(intervalMs) || intervalMs <= 0)\n    ) {\n      throw new Error('retention.intervalMs must be a finite number > 0');\n    }\n  }\n\n  if (\n    !config.dashboards ||\n    typeof config.dashboards !== 'object' ||\n    Array.isArray(config.dashboards)\n  ) {\n    throw new Error(\n      'defineConfig: config must include a \"dashboards\" record — did you mean to migrate from the old flat \"widgets\" shape?',\n    );\n  }\n\n  const connectorIds = new Set(config.connectors.map((e) => e.connector.id));\n\n  for (const [dashboardKey, dashboard] of Object.entries(config.dashboards)) {\n    if (\n      !dashboard.widgets ||\n      typeof dashboard.widgets !== 'object' ||\n      Array.isArray(dashboard.widgets)\n    ) {\n      throw new Error(\n        `Dashboard \"${dashboardKey}\" must define a \"widgets\" record`,\n      );\n    }\n\n    if (!SAFE_KEY_RE.test(dashboardKey)) {\n      throw new Error(\n        `Dashboard key \"${dashboardKey}\" contains URL-unsafe characters; use only letters, digits, hyphens, and underscores`,\n      );\n    }\n\n    for (const [widgetKey, widget] of Object.entries(dashboard.widgets)) {\n      const ref = `Dashboard \"${dashboardKey}\", widget \"${widgetKey}\"`;\n\n      if (!SAFE_KEY_RE.test(widgetKey)) {\n        throw new Error(\n          `${ref}: widget key contains URL-unsafe characters; use only letters, digits, hyphens, and underscores`,\n        );\n      }\n\n      if (widget.kind === 'status') {\n        continue;\n      }\n\n      const { connectorId, shape, fn } = widget.metric;\n\n      if (!connectorIds.has(connectorId)) {\n        throw new Error(\n          `${ref}: connector \"${connectorId}\" is not listed in connectors`,\n        );\n      }\n\n      if (!VALID_SHAPES.has(shape)) {\n        throw new Error(`${ref}: invalid shape \"${shape}\"`);\n      }\n\n      if (!VALID_FNS.has(fn)) {\n        throw new Error(`${ref}: invalid fn \"${fn}\"`);\n      }\n    }\n  }\n}\n\nexport function defineConfig(config: DashboardConfig): DashboardConfig {\n  validateConfig(config);\n  return config;\n}\n","import type { Distribution, Event, Metric, StorageHandle } from './connector';\n\n// ---------------------------------------------------------------------------\n// RetentionConfig\n// ---------------------------------------------------------------------------\n\nexport interface RetentionConfig {\n  maxAge?: number;\n  maxSize?: number;\n  floor?: number;\n  intervalMs?: number;\n}\n\n// ---------------------------------------------------------------------------\n// RetentionCandidates — rows eligible for deletion across time-series shapes\n// ---------------------------------------------------------------------------\n\nexport interface RetentionCandidates {\n  events: Event[];\n  metrics: Metric[];\n  distributions: Distribution[];\n}\n\n// ---------------------------------------------------------------------------\n// selectForDeletion — pure computation\n//\n// Receives rows pre-sorted newest-first (descending by timestamp).\n// Returns the subset that should be deleted given the policy.\n//\n// Rules applied in order:\n//   1. Rows beyond maxSize are candidates.\n//   2. Rows older than maxAge milliseconds are candidates.\n//   3. Rows within the newest `floor` positions are always kept (overrides 1 & 2).\n// ---------------------------------------------------------------------------\n\nexport function selectForDeletion<T>(\n  rows: T[],\n  getTs: (row: T) => number,\n  config: RetentionConfig,\n  nowMs: number = Date.now(),\n): T[] {\n  const { maxAge, maxSize, floor = 0 } = config;\n\n  if (maxAge === undefined && maxSize === undefined) {\n    return [];\n  }\n\n  const toDelete: T[] = [];\n\n  for (let i = 0; i < rows.length; i++) {\n    const row = rows[i]!;\n    if (i < floor) {\n      continue;\n    }\n\n    const overSize = maxSize !== undefined && i >= maxSize;\n    const tooOld = maxAge !== undefined && getTs(row) < nowMs - maxAge;\n\n    if (overSize || tooOld) {\n      toDelete.push(row);\n    }\n  }\n\n  return toDelete;\n}\n\n// ---------------------------------------------------------------------------\n// computeRetention — async, queries the handle and returns deletion candidates\n//\n// Only covers time-series shapes (events, metrics, distributions) since those\n// grow unboundedly via append. Entities and edges are upsert-keyed and do not\n// accumulate the same way.\n// ---------------------------------------------------------------------------\n\nexport async function computeRetention(\n  handle: StorageHandle,\n  config: RetentionConfig,\n  nowMs: number = Date.now(),\n): Promise<RetentionCandidates> {\n  const [events, metrics, distributions] = await Promise.all([\n    handle.queryEvents({}),\n    handle.queryMetrics({}),\n    handle.queryDistributions({}),\n  ]);\n\n  const sortedEvents = [...events].sort((a, b) => b.start_ts - a.start_ts);\n  const sortedMetrics = [...metrics].sort((a, b) => b.ts - a.ts);\n  const sortedDistributions = [...distributions].sort((a, b) => b.ts - a.ts);\n\n  return {\n    events: selectForDeletion(sortedEvents, (e) => e.start_ts, config, nowMs),\n    metrics: selectForDeletion(sortedMetrics, (m) => m.ts, config, nowMs),\n    distributions: selectForDeletion(\n      sortedDistributions,\n      (d) => d.ts,\n      config,\n      nowMs,\n    ),\n  };\n}\n","import { z } from 'zod';\n\nexport type ConfigFieldsSchema = z.ZodObject<z.ZodRawShape>;\n\nexport function defineConfigFields<T extends z.ZodRawShape>(\n  schema: z.ZodObject<T>,\n): z.ZodObject<T> {\n  if (!(schema instanceof z.ZodObject)) {\n    throw new Error(\n      `configFields must be a Zod object schema (z.object({...})). Received: ${Object.prototype.toString.call(schema)}`,\n    );\n  }\n  return schema;\n}\n"],"mappings":"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","names":["z"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@rawdash/core",
+  "version": "0.1.0",
+  "description": "Rawdash core — headless dashboard backend primitives",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}