@edge-base/admin 0.1.1

package/dist/analytics.js

@@ -0,0 +1,134 @@
+import { HttpClientAdapter, DefaultDbApi } from '@edge-base/core';
+import { DefaultAdminApi } from './generated/admin-api-core.js';
+// ─── AnalyticsClient ───
+export class AnalyticsClient {
+    core;
+    adminCore;
+    constructor(httpClient) {
+        const adapter = new HttpClientAdapter(httpClient);
+        this.core = new DefaultDbApi(adapter);
+        this.adminCore = new DefaultAdminApi(adapter);
+    }
+    // ── Feature 1: Request Log Metrics ──
+    /**
+     * Get a full analytics overview (time series + summary + breakdown + top endpoints).
+     *
+     * @example
+     * const overview = await admin.analytics.overview({ range: '7d' });
+     * console.log(overview.summary.totalRequests);
+     */
+    async overview(options) {
+        const query = this.buildQuery({ ...options, metric: 'overview' });
+        return this.adminCore.queryAnalytics(query);
+    }
+    /**
+     * Get time series data only.
+     *
+     * @example
+     * const ts = await admin.analytics.timeSeries({ range: '24h', category: 'db' });
+     */
+    async timeSeries(options) {
+        const query = this.buildQuery({ ...options, metric: 'timeSeries' });
+        const res = await this.adminCore.queryAnalytics(query);
+        return res.timeSeries;
+    }
+    /**
+     * Get breakdown data (by category, status code, etc.).
+     *
+     * @example
+     * const breakdown = await admin.analytics.breakdown({ range: '30d' });
+     */
+    async breakdown(options) {
+        const query = this.buildQuery({ ...options, metric: 'breakdown' });
+        const res = await this.adminCore.queryAnalytics(query);
+        return res.breakdown;
+    }
+    /**
+     * Get top endpoints by request count.
+     *
+     * @example
+     * const top = await admin.analytics.topEndpoints({ range: '7d', category: 'auth' });
+     */
+    async topEndpoints(options) {
+        const query = this.buildQuery({ ...options, metric: 'topEndpoints' });
+        const res = await this.adminCore.queryAnalytics(query);
+        return res.topItems;
+    }
+    // ── Feature 2: Custom Events ──
+    /**
+     * Track a single custom event.
+     *
+     * @param name       Event name (e.g. 'user_upgraded')
+     * @param properties Arbitrary key-value data (max 50 keys, max 4KB)
+     * @param userId     User ID to associate (Service Key callers only)
+     *
+     * @example
+     * await admin.analytics.track('user_upgraded', { plan: 'pro', amount: 29.99 }, 'user-123');
+     */
+    async track(name, properties, userId) {
+        const event = { name };
+        if (properties)
+            event.properties = properties;
+        if (userId)
+            event.userId = userId;
+        await this.core.trackEvents({ events: [event] });
+    }
+    /**
+     * Track multiple custom events in a single request (max 100).
+     *
+     * @example
+     * await admin.analytics.trackBatch([
+     *   { name: 'page_view', properties: { path: '/pricing' } },
+     *   { name: 'page_view', properties: { path: '/docs' } },
+     * ]);
+     */
+    async trackBatch(events) {
+        await this.core.trackEvents({ events });
+    }
+    /**
+     * Query custom events. Returns different shapes based on `metric`.
+     *
+     * @example
+     * // List events
+     * const list = await admin.analytics.queryEvents({ event: 'purchase', metric: 'list', limit: 20 });
+     *
+     * // Count
+     * const count = await admin.analytics.queryEvents({ event: 'purchase', metric: 'count' });
+     *
+     * // Time series
+     * const ts = await admin.analytics.queryEvents({ metric: 'timeSeries', groupBy: 'day' });
+     *
+     * // Top events
+     * const top = await admin.analytics.queryEvents({ metric: 'topEvents' });
+     */
+    async queryEvents(options) {
+        const query = {};
+        if (options?.range)
+            query.range = options.range;
+        if (options?.event)
+            query.event = options.event;
+        if (options?.userId)
+            query.userId = options.userId;
+        if (options?.metric)
+            query.metric = options.metric;
+        if (options?.groupBy)
+            query.groupBy = options.groupBy;
+        if (options?.limit)
+            query.limit = String(options.limit);
+        if (options?.cursor)
+            query.cursor = options.cursor;
+        return this.adminCore.queryCustomEvents(query);
+    }
+    // ── Internal ──
+    buildQuery(opts) {
+        const q = { metric: opts.metric };
+        if (opts.range)
+            q.range = opts.range;
+        if (opts.category)
+            q.category = opts.category;
+        if (opts.groupBy)
+            q.groupBy = opts.groupBy;
+        return q;
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @edge-base/admin — Admin/Server-side EdgeBase SDK (Node.js / Edge Functions / Dart Frog)
+ *
+ * @example External server (url + serviceKey required):
+ * import { createAdminClient } from '@edge-base/admin';
+ * const admin = createAdminClient('https://my-app.edgebase.fun', {
+ *   serviceKey: process.env.EDGEBASE_SERVICE_KEY,
+ * });
+ * const post = await admin.db('shared').table('posts').insert({ title: 'Hello' });
+ *
+ * @example App Functions (auto-detects url + serviceKey from env):
+ * import { createAdminClient } from '@edge-base/admin';
+ * const admin = createAdminClient();
+ */
+import { DbRef } from '@edge-base/core';
+import { StorageClient } from '@edge-base/core';
+import { FunctionsClient } from '@edge-base/core';
+import { AdminAuthClient } from './admin-auth.js';
+import { KvClient } from './kv.js';
+import { D1Client } from './d1.js';
+import { VectorizeClient } from './vectorize.js';
+import { PushClient } from './push.js';
+import { AnalyticsClient } from './analytics.js';
+/** Options for createAdminClient() */
+export interface JuneAdminClientOptions {
+    /**
+     * Service Key for admin operations.
+     * Optional when called with no args from App Functions — falls back to EDGEBASE_SERVICE_KEY env var.
+     */
+    serviceKey?: string;
+    /** Schema from typegen (build-time metadata) */
+    schema?: Record<string, unknown>;
+}
+/**
+ * Admin-side EdgeBase SDK.
+ * Exposes: auth, db, storage, sql, kv, d1, vector, broadcast, destroy.
+ * Does NOT expose: auth, database-live, presence, channel (client-only).
+ *
+ * @example
+ * const posts = await admin.db('shared').table('posts').get();
+ * const docs = await admin.db('workspace', 'ws-456').table('documents').get();
+ */
+export declare class AdminEdgeBase {
+    /** Admin user management. */
+    readonly auth: AdminAuthClient;
+    readonly storage: StorageClient;
+    readonly push: PushClient;
+    readonly analytics: AnalyticsClient;
+    readonly functions: FunctionsClient;
+    private httpClient;
+    private contextManager;
+    private baseUrl;
+    private core;
+    private adminCore;
+    constructor(url: string, options: JuneAdminClientOptions);
+    /**
+     * Access a DB block by namespace + optional instance ID. (§2)
+     *
+     * @example
+     * // Static shared DB (id omitted)
+     * const posts = await admin.db('shared').table('posts').get();
+     *
+     * // Dynamic workspace DB
+     * const docs = await admin.db('workspace', 'ws-456').table('documents').get();
+     *
+     * // Per-user DB
+     * const notes = await admin.db('user', 'user-123').table('notes').get();
+     */
+    db(namespace: string, id?: string): DbRef;
+    /**
+     * Execute raw SQL on a DB table's DO.
+     *
+     * @param namespace DB namespace ('shared' | 'workspace' | ...)
+     * @param id        DB instance ID for dynamic DOs. Omit for static DBs.
+     * @param query     SQL query string (use '?' for bind params)
+     * @param params    Bind parameters matching '?' placeholders
+     */
+    sql(namespace: string, id: string | undefined, query: string, params?: unknown[]): Promise<unknown[]>;
+    /**
+     * Simple form: sql(query) — executes against default 'shared' namespace.
+     */
+    sql(query: string): Promise<unknown[]>;
+    /**
+     * Broadcast a message to a database-live channel from the server.
+     */
+    broadcast(channel: string, event: string, payload?: Record<string, unknown>): Promise<void>;
+    kv(namespace: string): KvClient;
+    d1(database: string): D1Client;
+    vector(index: string): VectorizeClient;
+    destroy(): void;
+}
+/**
+ * Create an admin-side EdgeBase SDK instance.
+ */
+export declare function createAdminClient(url?: string, options?: JuneAdminClientOptions): AdminEdgeBase;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIjD,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAID;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB;IAmBxD;;;;;;;;;;;;OAYG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;IAIzC;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3G;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA+B5C;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjG,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ;IAI/B,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAI9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAItC,OAAO,IAAI,IAAI;CAChB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,aAAa,CA4Bf"}

package/dist/client.js

@@ -0,0 +1,153 @@
+/**
+ * @edge-base/admin — Admin/Server-side EdgeBase SDK (Node.js / Edge Functions / Dart Frog)
+ *
+ * @example External server (url + serviceKey required):
+ * import { createAdminClient } from '@edge-base/admin';
+ * const admin = createAdminClient('https://my-app.edgebase.fun', {
+ *   serviceKey: process.env.EDGEBASE_SERVICE_KEY,
+ * });
+ * const post = await admin.db('shared').table('posts').insert({ title: 'Hello' });
+ *
+ * @example App Functions (auto-detects url + serviceKey from env):
+ * import { createAdminClient } from '@edge-base/admin';
+ * const admin = createAdminClient();
+ */
+import { HttpClient } from '@edge-base/core';
+import { ContextManager } from '@edge-base/core';
+import { DbRef } from '@edge-base/core';
+import { StorageClient } from '@edge-base/core';
+import { FunctionsClient } from '@edge-base/core';
+import { DefaultDbApi, HttpClientAdapter } from '@edge-base/core';
+import { DefaultAdminApi } from './generated/admin-api-core.js';
+import { AdminAuthClient } from './admin-auth.js';
+import { KvClient } from './kv.js';
+import { D1Client } from './d1.js';
+import { VectorizeClient } from './vectorize.js';
+import { PushClient } from './push.js';
+import { AnalyticsClient } from './analytics.js';
+// ─── Admin SDK ───
+/**
+ * Admin-side EdgeBase SDK.
+ * Exposes: auth, db, storage, sql, kv, d1, vector, broadcast, destroy.
+ * Does NOT expose: auth, database-live, presence, channel (client-only).
+ *
+ * @example
+ * const posts = await admin.db('shared').table('posts').get();
+ * const docs = await admin.db('workspace', 'ws-456').table('documents').get();
+ */
+export class AdminEdgeBase {
+    /** Admin user management. */
+    auth;
+    storage;
+    push;
+    analytics;
+    functions;
+    httpClient;
+    contextManager;
+    baseUrl;
+    core;
+    adminCore;
+    constructor(url, options) {
+        this.baseUrl = url.replace(/\/$/, '');
+        this.contextManager = new ContextManager();
+        this.httpClient = new HttpClient({
+            baseUrl: this.baseUrl,
+            serviceKey: options.serviceKey,
+            contextManager: this.contextManager,
+        });
+        const adapter = new HttpClientAdapter(this.httpClient);
+        this.core = new DefaultDbApi(adapter);
+        this.adminCore = new DefaultAdminApi(adapter);
+        const authClient = new AdminAuthClient(this.httpClient, true);
+        this.auth = authClient;
+        this.storage = new StorageClient(this.httpClient, this.core);
+        this.push = new PushClient(this.httpClient);
+        this.analytics = new AnalyticsClient(this.httpClient);
+        this.functions = new FunctionsClient(this.httpClient);
+    }
+    /**
+     * Access a DB block by namespace + optional instance ID. (§2)
+     *
+     * @example
+     * // Static shared DB (id omitted)
+     * const posts = await admin.db('shared').table('posts').get();
+     *
+     * // Dynamic workspace DB
+     * const docs = await admin.db('workspace', 'ws-456').table('documents').get();
+     *
+     * // Per-user DB
+     * const notes = await admin.db('user', 'user-123').table('notes').get();
+     */
+    db(namespace, id) {
+        return new DbRef(this.core, namespace, id, undefined, undefined, this.httpClient);
+    }
+    async sql(namespaceOrTable, idOrQuery, queryOrParams, params) {
+        // Detect overload: if 3rd arg is string it's the new (namespace, id, query, params) form
+        if (typeof queryOrParams === 'string') {
+            // New form: sql(namespace, id, sql, params)
+            const res = await this.adminCore.executeSql({
+                namespace: namespaceOrTable,
+                id: idOrQuery,
+                sql: queryOrParams,
+                params: params ?? [],
+            });
+            return res.items ?? [];
+        }
+        if (idOrQuery === undefined) {
+            // Simple form: sql(query)
+            const res = await this.adminCore.executeSql({
+                namespace: 'shared',
+                id: undefined,
+                sql: namespaceOrTable,
+                params: [],
+            });
+            return res.items ?? [];
+        }
+        throw new Error('Invalid sql() signature. Use sql(namespace, id, query, params) or sql(query).');
+    }
+    /**
+     * Broadcast a message to a database-live channel from the server.
+     */
+    async broadcast(channel, event, payload) {
+        await this.adminCore.databaseLiveBroadcast({ channel, event, payload });
+    }
+    kv(namespace) {
+        return new KvClient(this.httpClient, namespace);
+    }
+    d1(database) {
+        return new D1Client(this.httpClient, database);
+    }
+    vector(index) {
+        return new VectorizeClient(this.httpClient, index);
+    }
+    destroy() { }
+}
+// ─── Factory ───
+/**
+ * Create an admin-side EdgeBase SDK instance.
+ */
+export function createAdminClient(url, options) {
+    const getEnv = (key) => {
+        const processValue = typeof process !== 'undefined' && process.env
+            ? process.env[key]
+            : undefined;
+        if (typeof processValue === 'string' && processValue.length > 0) {
+            return processValue;
+        }
+        if (typeof globalThis === 'undefined')
+            return undefined;
+        const globalValue = globalThis[key];
+        return typeof globalValue === 'string' ? globalValue : undefined;
+    };
+    const resolvedUrl = url ?? getEnv('EDGEBASE_URL') ?? 'http://localhost';
+    const resolvedServiceKey = options?.serviceKey ?? getEnv('EDGEBASE_SERVICE_KEY');
+    if (!resolvedServiceKey) {
+        console.warn('[EdgeBase] createAdminClient(): no serviceKey provided and EDGEBASE_SERVICE_KEY env var not set. ' +
+            'Admin operations (auth, sql, broadcast) will fail.');
+    }
+    return new AdminEdgeBase(resolvedUrl, {
+        ...options,
+        serviceKey: resolvedServiceKey ?? '',
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/d1.d.ts

@@ -0,0 +1,28 @@
+/**
+ * D1Client — SDK client for user-defined D1 databases
+ *
+ * Usage:
+ *   const admin = createAdminClient(url, { serviceKey });
+ *   const rows = await admin.d1('analytics').exec('SELECT * FROM events WHERE type = ?', ['pageview']);
+ */
+import type { HttpClient } from '@edge-base/core';
+export declare class D1Client {
+    private adminCore;
+    private database;
+    constructor(httpClient: HttpClient, database: string);
+    /**
+     * Execute a SQL query on the D1 database.
+     * All SQL is allowed (DDL included) — Service Key holders are admin-level trusted.
+     * Use ? placeholders for bind parameters (SQL injection prevention).
+     *
+     * @param query SQL query string with ? placeholders
+     * @param params Bind parameters
+     * @returns Array of result rows
+     */
+    exec<T = Record<string, unknown>>(query: string, params?: unknown[]): Promise<T[]>;
+    /**
+     * Alias for `exec()` — execute a SQL query on the D1 database.
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+}
+//# sourceMappingURL=d1.d.ts.map

package/dist/d1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1.d.ts","sourceRoot":"","sources":["../src/d1.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAKpD;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQxF;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAGlF"}

package/dist/d1.js

@@ -0,0 +1,33 @@
+import { HttpClientAdapter } from '@edge-base/core';
+import { DefaultAdminApi } from './generated/admin-api-core.js';
+export class D1Client {
+    adminCore;
+    database;
+    constructor(httpClient, database) {
+        this.adminCore = new DefaultAdminApi(new HttpClientAdapter(httpClient));
+        this.database = database;
+    }
+    /**
+     * Execute a SQL query on the D1 database.
+     * All SQL is allowed (DDL included) — Service Key holders are admin-level trusted.
+     * Use ? placeholders for bind parameters (SQL injection prevention).
+     *
+     * @param query SQL query string with ? placeholders
+     * @param params Bind parameters
+     * @returns Array of result rows
+     */
+    async exec(query, params) {
+        const res = await this.adminCore.executeD1Query(this.database, {
+            query,
+            params,
+        });
+        return res.results;
+    }
+    /**
+     * Alias for `exec()` — execute a SQL query on the D1 database.
+     */
+    query(sql, params) {
+        return this.exec(sql, params);
+    }
+}
+//# sourceMappingURL=d1.js.map

package/dist/d1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1.js","sourceRoot":"","sources":["../src/d1.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,OAAO,QAAQ;IACX,SAAS,CAAkB;IAC3B,QAAQ,CAAS;IAEzB,YAAY,UAAsB,EAAE,QAAgB;QAClD,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAA8B,KAAa,EAAE,MAAkB;QACvE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC7D,KAAK;YACL,MAAM;SACP,CAAqB,CAAC;QACvB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAA8B,GAAW,EAAE,MAAkB;QAChE,OAAO,IAAI,CAAC,IAAI,CAAI,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;CACF"}