@scrawn/analytics 0.0.2 → 0.0.5

package/dist/analytics.d.ts

@@ -0,0 +1,64 @@
+import type { Scrawn } from "@scrawn/core";
+import { SdkEventBuilder } from "./query/sdkEvent.js";
+import { AiTokenBuilder } from "./query/aiToken.js";
+import { PaymentBuilder } from "./query/payment.js";
+import { UsersBuilder, SessionsBuilder, TagsBuilder, ExpressionsBuilder, MetadataBuilder } from "./data/tables.js";
+/**
+ * Query interface for event analytics.
+ * Each builder is pre-scoped to the correct event type.
+ */
+export interface EventQueries {
+    sdkEvent: SdkEventBuilder;
+    aiToken: AiTokenBuilder;
+    payment: PaymentBuilder;
+}
+/**
+ * Query interface for administrative data.
+ * Each builder targets a specific table.
+ */
+export interface DataQueries {
+    users: UsersBuilder;
+    sessions: SessionsBuilder;
+    tags: TagsBuilder;
+    expressions: ExpressionsBuilder;
+    metadata: MetadataBuilder;
+}
+/**
+ * Analytics client for the Scrawn platform.
+ *
+ * Provides MongoDB/drizzle-style query builders for event analytics
+ * and administrative data lookups, backed by the Scrawn gRPC API.
+ *
+ * @example
+ * ```typescript
+ * import { Analytics, eq, gt, and, desc } from "@scrawn/analytics";
+ * import { biller } from "./scrawn/biller";
+ *
+ * const analytics = new Analytics(biller);
+ *
+ * // Query SDK events
+ * const events = await analytics.query.sdkEvent
+ *   .where(and(
+ *     eq(analytics.query.sdkEvent.fields.sdkCallType, "RAW"),
+ *     gt(analytics.query.sdkEvent.fields.debitAmount, 100),
+ *   ))
+ *   .orderBy(desc(analytics.query.sdkEvent.fields.reportedTimestamp))
+ *   .limit(10)
+ *   .execute();
+ *
+ * // Query user data
+ * const users = await analytics.data.users
+ *   .where(eq(analytics.data.users.fields.mode, "production"))
+ *   .limit(10)
+ *   .execute();
+ * ```
+ */
+export declare class Analytics {
+    private grpc;
+    /** Event query builders */
+    readonly query: EventQueries;
+    /** Data query builders */
+    readonly data: DataQueries;
+    constructor(biller: Scrawn<string, string>);
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAa;IAEzB,2BAA2B;IAC3B,SAAgB,KAAK,EAAE,YAAY,CAAC;IAEpC,0BAA0B;IAC1B,SAAgB,IAAI,EAAE,WAAW,CAAC;gBAEtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAkB3C"}

package/dist/analytics.js

@@ -0,0 +1,53 @@
+import { SdkEventBuilder } from "./query/sdkEvent.js";
+import { AiTokenBuilder } from "./query/aiToken.js";
+import { PaymentBuilder } from "./query/payment.js";
+import { UsersBuilder, SessionsBuilder, TagsBuilder, ExpressionsBuilder, MetadataBuilder, } from "./data/tables.js";
+/**
+ * Analytics client for the Scrawn platform.
+ *
+ * Provides MongoDB/drizzle-style query builders for event analytics
+ * and administrative data lookups, backed by the Scrawn gRPC API.
+ *
+ * @example
+ * ```typescript
+ * import { Analytics, eq, gt, and, desc } from "@scrawn/analytics";
+ * import { biller } from "./scrawn/biller";
+ *
+ * const analytics = new Analytics(biller);
+ *
+ * // Query SDK events
+ * const events = await analytics.query.sdkEvent
+ *   .where(and(
+ *     eq(analytics.query.sdkEvent.fields.sdkCallType, "RAW"),
+ *     gt(analytics.query.sdkEvent.fields.debitAmount, 100),
+ *   ))
+ *   .orderBy(desc(analytics.query.sdkEvent.fields.reportedTimestamp))
+ *   .limit(10)
+ *   .execute();
+ *
+ * // Query user data
+ * const users = await analytics.data.users
+ *   .where(eq(analytics.data.users.fields.mode, "production"))
+ *   .limit(10)
+ *   .execute();
+ * ```
+ */
+export class Analytics {
+    constructor(biller) {
+        this.grpc = biller.grpc;
+        const apiKey = biller.apikey;
+        this.query = {
+            sdkEvent: new SdkEventBuilder(this.grpc, apiKey),
+            aiToken: new AiTokenBuilder(this.grpc, apiKey),
+            payment: new PaymentBuilder(this.grpc, apiKey),
+        };
+        this.data = {
+            users: new UsersBuilder(this.grpc, apiKey),
+            sessions: new SessionsBuilder(this.grpc, apiKey),
+            tags: new TagsBuilder(this.grpc, apiKey),
+            expressions: new ExpressionsBuilder(this.grpc, apiKey),
+            metadata: new MetadataBuilder(this.grpc, apiKey),
+        };
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAwB1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,SAAS;IASpB,YAAY,MAA8B;QACxC,IAAI,CAAC,IAAI,GAAI,MAA+B,CAAC,IAAI,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAE7B,IAAI,CAAC,KAAK,GAAG;YACX,QAAQ,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YAChD,OAAO,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YAC9C,OAAO,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;SAC/C,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG;YACV,KAAK,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YAC1C,QAAQ,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YAChD,IAAI,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YACxC,WAAW,EAAE,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;YACtD,QAAQ,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;SACjD,CAAC;IACJ,CAAC;CACF"}

package/dist/data/base.d.ts

@@ -0,0 +1,30 @@
+import type { FilterCondition, FilterGroup, OrderBy } from "../operators.js";
+import type { DataQueryResult } from "./types.js";
+export declare abstract class BaseDataBuilder<TFields> {
+    readonly fields: TFields;
+    readonly tableName: string;
+    protected _where?: FilterGroup;
+    protected _orderBy: OrderBy[];
+    protected _limit: number;
+    protected _offset: number;
+    constructor(fields: TFields, tableName: string);
+    where(filter: FilterCondition | FilterGroup): this;
+    orderBy(...orders: OrderBy[]): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    protected buildParams(): {
+        where: FilterGroup | undefined;
+        limit: number;
+        offset: number;
+        orderBy: OrderBy[] | undefined;
+    };
+    protected unwrap(res: {
+        columnsList?: string[];
+        rowsList?: Array<{
+            valuesList?: string[];
+        }>;
+        total?: number;
+    }): DataQueryResult<TFields>;
+    abstract execute(): Promise<DataQueryResult<TFields>>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/data/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/data/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,8BAAsB,eAAe,CAAC,OAAO;aAOzB,MAAM,EAAE,OAAO;aACf,SAAS,EAAE,MAAM;IAPnC,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAM;IACnC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAO;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAK;gBAGZ,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM;IAGnC,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI;IASlD,OAAO,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAKnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB,SAAS,CAAC,WAAW;;;;;;IASrB,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC,OAAO,CAAC;IAWxI,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;CACtD"}

package/dist/data/base.js

@@ -0,0 +1,49 @@
+export class BaseDataBuilder {
+    constructor(fields, tableName) {
+        this.fields = fields;
+        this.tableName = tableName;
+        this._orderBy = [];
+        this._limit = 100;
+        this._offset = 0;
+    }
+    where(filter) {
+        if ("operator" in filter) {
+            this._where = { logical: "AND", conditions: [filter], groups: [] };
+        }
+        else {
+            this._where = filter;
+        }
+        return this;
+    }
+    orderBy(...orders) {
+        this._orderBy = orders;
+        return this;
+    }
+    limit(n) {
+        this._limit = n;
+        return this;
+    }
+    offset(n) {
+        this._offset = n;
+        return this;
+    }
+    buildParams() {
+        return {
+            where: this._where,
+            limit: this._limit,
+            offset: this._offset,
+            orderBy: this._orderBy.length > 0 ? this._orderBy : undefined,
+        };
+    }
+    unwrap(res) {
+        const cols = res.columnsList ?? [];
+        const rows = (res.rowsList ?? []).map((r) => {
+            const vals = r.valuesList ?? [];
+            const obj = {};
+            cols.forEach((c, i) => { obj[c] = vals[i] ?? ""; });
+            return obj;
+        });
+        return { columns: cols, rows, total: res.total ?? 0 };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/data/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/data/base.ts"],"names":[],"mappings":"AAIA,MAAM,OAAgB,eAAe;IAMnC,YACkB,MAAe,EACf,SAAiB;QADjB,WAAM,GAAN,MAAM,CAAS;QACf,cAAS,GAAT,SAAS,CAAQ;QANzB,aAAQ,GAAc,EAAE,CAAC;QACzB,WAAM,GAAW,GAAG,CAAC;QACrB,YAAO,GAAW,CAAC,CAAC;IAK3B,CAAC;IAEJ,KAAK,CAAC,MAAqC;QACzC,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,MAAiB;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,CAAS;QACb,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,CAAS;QACd,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAES,WAAW;QACnB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC;IACJ,CAAC;IAES,MAAM,CAAC,GAA4F;QAC3G,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;YAChC,MAAM,GAAG,GAA2B,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,OAAO,GAAmC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;CAGF"}

package/dist/data/fields.d.ts

@@ -0,0 +1,32 @@
+import { FieldRef } from "../fieldRef.js";
+export declare const usersFields: {
+    readonly id: FieldRef<string>;
+    readonly last_billed_timestamp: FieldRef<string>;
+    readonly payment_provider_user_id: FieldRef<string>;
+    readonly mode: FieldRef<string>;
+};
+export declare const sessionsFields: {
+    readonly id: FieldRef<string>;
+    readonly session_id: FieldRef<string>;
+    readonly user_id: FieldRef<string>;
+    readonly processed: FieldRef<string>;
+    readonly billed_upto: FieldRef<string>;
+    readonly created_at: FieldRef<string>;
+    readonly mode: FieldRef<string>;
+};
+export declare const tagsFields: {
+    readonly id: FieldRef<string>;
+    readonly key: FieldRef<string>;
+    readonly amount: FieldRef<string>;
+};
+export declare const expressionsFields: {
+    readonly id: FieldRef<string>;
+    readonly key: FieldRef<string>;
+    readonly expr: FieldRef<string>;
+};
+export declare const metadataFields: {
+    readonly id: FieldRef<string>;
+    readonly payment_cron: FieldRef<string>;
+    readonly payment_webhook: FieldRef<string>;
+};
+//# sourceMappingURL=fields.d.ts.map

package/dist/data/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/data/fields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;CAIjB,CAAC"}

package/dist/data/fields.js

@@ -0,0 +1,33 @@
+// AUTO-GENERATED by scripts/gen-fields.ts — do not edit
+import { FieldRef } from "../fieldRef.js";
+export const usersFields = {
+    id: new FieldRef("id"),
+    last_billed_timestamp: new FieldRef("last_billed_timestamp"),
+    payment_provider_user_id: new FieldRef("payment_provider_user_id"),
+    mode: new FieldRef("mode"),
+};
+export const sessionsFields = {
+    id: new FieldRef("id"),
+    session_id: new FieldRef("session_id"),
+    user_id: new FieldRef("user_id"),
+    processed: new FieldRef("processed"),
+    billed_upto: new FieldRef("billed_upto"),
+    created_at: new FieldRef("created_at"),
+    mode: new FieldRef("mode"),
+};
+export const tagsFields = {
+    id: new FieldRef("id"),
+    key: new FieldRef("key"),
+    amount: new FieldRef("amount"),
+};
+export const expressionsFields = {
+    id: new FieldRef("id"),
+    key: new FieldRef("key"),
+    expr: new FieldRef("expr"),
+};
+export const metadataFields = {
+    id: new FieldRef("id"),
+    payment_cron: new FieldRef("payment_cron"),
+    payment_webhook: new FieldRef("payment_webhook"),
+};
+//# sourceMappingURL=fields.js.map

package/dist/data/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/data/fields.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,IAAI,QAAQ,CAAS,IAAI,CAAC;IAC9B,qBAAqB,EAAE,IAAI,QAAQ,CAAS,uBAAuB,CAAC;IACpE,wBAAwB,EAAE,IAAI,QAAQ,CAAS,0BAA0B,CAAC;IAC1E,IAAI,EAAE,IAAI,QAAQ,CAAS,MAAM,CAAC;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,QAAQ,CAAS,IAAI,CAAC;IAC9B,UAAU,EAAE,IAAI,QAAQ,CAAS,YAAY,CAAC;IAC9C,OAAO,EAAE,IAAI,QAAQ,CAAS,SAAS,CAAC;IACxC,SAAS,EAAE,IAAI,QAAQ,CAAS,WAAW,CAAC;IAC5C,WAAW,EAAE,IAAI,QAAQ,CAAS,aAAa,CAAC;IAChD,UAAU,EAAE,IAAI,QAAQ,CAAS,YAAY,CAAC;IAC9C,IAAI,EAAE,IAAI,QAAQ,CAAS,MAAM,CAAC;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,EAAE,EAAE,IAAI,QAAQ,CAAS,IAAI,CAAC;IAC9B,GAAG,EAAE,IAAI,QAAQ,CAAS,KAAK,CAAC;IAChC,MAAM,EAAE,IAAI,QAAQ,CAAS,QAAQ,CAAC;CAC9B,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,IAAI,QAAQ,CAAS,IAAI,CAAC;IAC9B,GAAG,EAAE,IAAI,QAAQ,CAAS,KAAK,CAAC;IAChC,IAAI,EAAE,IAAI,QAAQ,CAAS,MAAM,CAAC;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,QAAQ,CAAS,IAAI,CAAC;IAC9B,YAAY,EAAE,IAAI,QAAQ,CAAS,cAAc,CAAC;IAClD,eAAe,EAAE,IAAI,QAAQ,CAAS,iBAAiB,CAAC;CAChD,CAAC"}

package/dist/data/tables.d.ts

@@ -0,0 +1,35 @@
+import { BaseDataBuilder } from "./base.js";
+import type { GrpcClient } from "@scrawn/core";
+import type { DataQueryResult } from "./types.js";
+import { usersFields, sessionsFields, tagsFields, expressionsFields, metadataFields } from "./fields.js";
+export declare class UsersBuilder extends BaseDataBuilder<typeof usersFields> {
+    private grpc;
+    private apiKey;
+    constructor(grpc: GrpcClient, apiKey: string);
+    execute(): Promise<DataQueryResult<typeof usersFields>>;
+}
+export declare class SessionsBuilder extends BaseDataBuilder<typeof sessionsFields> {
+    private grpc;
+    private apiKey;
+    constructor(grpc: GrpcClient, apiKey: string);
+    execute(): Promise<DataQueryResult<typeof sessionsFields>>;
+}
+export declare class TagsBuilder extends BaseDataBuilder<typeof tagsFields> {
+    private grpc;
+    private apiKey;
+    constructor(grpc: GrpcClient, apiKey: string);
+    execute(): Promise<DataQueryResult<typeof tagsFields>>;
+}
+export declare class ExpressionsBuilder extends BaseDataBuilder<typeof expressionsFields> {
+    private grpc;
+    private apiKey;
+    constructor(grpc: GrpcClient, apiKey: string);
+    execute(): Promise<DataQueryResult<typeof expressionsFields>>;
+}
+export declare class MetadataBuilder extends BaseDataBuilder<typeof metadataFields> {
+    private grpc;
+    private apiKey;
+    constructor(grpc: GrpcClient, apiKey: string);
+    execute(): Promise<DataQueryResult<typeof metadataFields>>;
+}
+//# sourceMappingURL=tables.d.ts.map

package/dist/data/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/data/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,YAAa,SAAQ,eAAe,CAAC,OAAO,WAAW,CAAC;IACvD,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,MAAM;gBAAhC,IAAI,EAAE,UAAU,EAAU,MAAM,EAAE,MAAM;IAGtD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,WAAW,CAAC,CAAC;CAK9D;AAED,qBAAa,eAAgB,SAAQ,eAAe,CAAC,OAAO,cAAc,CAAC;IAC7D,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,MAAM;gBAAhC,IAAI,EAAE,UAAU,EAAU,MAAM,EAAE,MAAM;IAGtD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,cAAc,CAAC,CAAC;CAKjE;AAED,qBAAa,WAAY,SAAQ,eAAe,CAAC,OAAO,UAAU,CAAC;IACrD,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,MAAM;gBAAhC,IAAI,EAAE,UAAU,EAAU,MAAM,EAAE,MAAM;IAGtD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,UAAU,CAAC,CAAC;CAK7D;AAED,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,OAAO,iBAAiB,CAAC;IACnE,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,MAAM;gBAAhC,IAAI,EAAE,UAAU,EAAU,MAAM,EAAE,MAAM;IAGtD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,iBAAiB,CAAC,CAAC;CAKpE;AAED,qBAAa,eAAgB,SAAQ,eAAe,CAAC,OAAO,cAAc,CAAC;IAC7D,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,MAAM;gBAAhC,IAAI,EAAE,UAAU,EAAU,MAAM,EAAE,MAAM;IAGtD,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,cAAc,CAAC,CAAC;CAKjE"}

package/dist/data/tables.js

@@ -0,0 +1,64 @@
+import { BaseDataBuilder } from "./base.js";
+import { callDataQuery } from "../grpc/client.js";
+import { usersFields, sessionsFields, tagsFields, expressionsFields, metadataFields, } from "./fields.js";
+export class UsersBuilder extends BaseDataBuilder {
+    constructor(grpc, apiKey) {
+        super(usersFields, "users");
+        this.grpc = grpc;
+        this.apiKey = apiKey;
+    }
+    async execute() {
+        const params = this.buildParams();
+        const res = await callDataQuery(this.grpc, this.apiKey, "users", params);
+        return this.unwrap(res);
+    }
+}
+export class SessionsBuilder extends BaseDataBuilder {
+    constructor(grpc, apiKey) {
+        super(sessionsFields, "sessions");
+        this.grpc = grpc;
+        this.apiKey = apiKey;
+    }
+    async execute() {
+        const params = this.buildParams();
+        const res = await callDataQuery(this.grpc, this.apiKey, "sessions", params);
+        return this.unwrap(res);
+    }
+}
+export class TagsBuilder extends BaseDataBuilder {
+    constructor(grpc, apiKey) {
+        super(tagsFields, "tags");
+        this.grpc = grpc;
+        this.apiKey = apiKey;
+    }
+    async execute() {
+        const params = this.buildParams();
+        const res = await callDataQuery(this.grpc, this.apiKey, "tags", params);
+        return this.unwrap(res);
+    }
+}
+export class ExpressionsBuilder extends BaseDataBuilder {
+    constructor(grpc, apiKey) {
+        super(expressionsFields, "expressions");
+        this.grpc = grpc;
+        this.apiKey = apiKey;
+    }
+    async execute() {
+        const params = this.buildParams();
+        const res = await callDataQuery(this.grpc, this.apiKey, "expressions", params);
+        return this.unwrap(res);
+    }
+}
+export class MetadataBuilder extends BaseDataBuilder {
+    constructor(grpc, apiKey) {
+        super(metadataFields, "metadata");
+        this.grpc = grpc;
+        this.apiKey = apiKey;
+    }
+    async execute() {
+        const params = this.buildParams();
+        const res = await callDataQuery(this.grpc, this.apiKey, "metadata", params);
+        return this.unwrap(res);
+    }
+}
+//# sourceMappingURL=tables.js.map

package/dist/data/tables.js.map

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

package/dist/data/types.d.ts

@@ -0,0 +1,7 @@
+import type { InferRow } from "../fieldRef.ts";
+export interface DataQueryResult<TFields> {
+    columns: string[];
+    rows: InferRow<TFields>[];
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/data/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,eAAe,CAAC,OAAO;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/data/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/data/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":""}

package/dist/fieldRef.d.ts

@@ -0,0 +1,18 @@
+/**
+ * FieldRef — typed field reference for query builders.
+ * Carries the field name along with its TypeScript type for operator type safety.
+ */
+export declare class FieldRef<T> {
+    readonly name: string;
+    constructor(name: string);
+    toString(): string;
+}
+/**
+ * Extracts a row type from a fields object.
+ * Given { id: FieldRef<string>, mode: FieldRef<string> },
+ * yields { id: string, mode: string }.
+ */
+export type InferRow<TFields> = {
+    [K in keyof TFields]: TFields[K] extends FieldRef<infer V> ? V : never;
+};
+//# sourceMappingURL=fieldRef.d.ts.map

package/dist/fieldRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRef.d.ts","sourceRoot":"","sources":["../src/fieldRef.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC;aACO,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAExC,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,OAAO,IAAI;KAC7B,CAAC,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACvE,CAAC"}

package/dist/fieldRef.js

@@ -0,0 +1,13 @@
+/**
+ * FieldRef — typed field reference for query builders.
+ * Carries the field name along with its TypeScript type for operator type safety.
+ */
+export class FieldRef {
+    constructor(name) {
+        this.name = name;
+    }
+    toString() {
+        return this.name;
+    }
+}
+//# sourceMappingURL=fieldRef.js.map

package/dist/fieldRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRef.js","sourceRoot":"","sources":["../src/fieldRef.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACnB,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE5C,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/grpc/client.d.ts

@@ -0,0 +1,18 @@
+import type { GrpcClient } from "@scrawn/core";
+import { QueryEventsResponse } from "@scrawn/core";
+import { QueryResponse } from "@scrawn/core";
+import type { FilterGroup, Aggregation as AggType, OrderBy as OrderByType } from "../operators.ts";
+export declare function callEventQuery(grpc: GrpcClient, apiKey: string, params: {
+    where?: FilterGroup;
+    aggregation?: AggType;
+    groupBy?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<QueryEventsResponse.AsObject>;
+export declare function callDataQuery(grpc: GrpcClient, apiKey: string, tableName: string, params: {
+    where?: FilterGroup;
+    limit?: number;
+    offset?: number;
+    orderBy?: OrderByType[];
+}): Promise<QueryResponse.AsObject>;
+//# sourceMappingURL=client.d.ts.map

package/dist/grpc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/grpc/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAGL,mBAAmB,EAKpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAGL,aAAa,EAId,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACV,WAAW,EACX,WAAW,IAAI,OAAO,EACtB,OAAO,IAAI,WAAW,EACvB,MAAM,iBAAiB,CAAC;AAsCzB,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxG,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAuBvC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,GACxF,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAqBjC"}

package/dist/grpc/client.js

@@ -0,0 +1,87 @@
+import { QueryServiceClient, QueryEventsRequest, FilterGroup as QFilterGroup, FilterCondition as QFilterCondition, Aggregation, GroupBy, } from "@scrawn/core";
+import { DataQueryServiceClient, QueryRequest, FilterGroup as DFilterGroup, FilterCondition as DFilterCondition, OrderBy as DOrderBy, } from "@scrawn/core";
+function opQuery(op) {
+    switch (op) {
+        case "EQ": return 1;
+        case "GT": return 2;
+        case "GTE": return 3;
+        case "LT": return 4;
+        case "LTE": return 5;
+        case "NEQ": return 6;
+        default: return 0;
+    }
+}
+function buildQueryGroup(group) {
+    const fg = new QFilterGroup();
+    fg.setLogical(group.logical === "AND" ? 1 : 2);
+    fg.setConditionsList(group.conditions.map((c) => {
+        const fc = new QFilterCondition();
+        fc.setField(c.field);
+        fc.setOperator(opQuery(c.operator));
+        fc.setValue(c.value);
+        return fc;
+    }));
+    fg.setGroupsList(group.groups.map(buildQueryGroup));
+    return fg;
+}
+function buildDataGroup(group) {
+    const fg = new DFilterGroup();
+    fg.setLogical(group.logical === "AND" ? 1 : 2);
+    fg.setConditionsList(group.conditions.map((c) => {
+        const fc = new DFilterCondition();
+        fc.setField(c.field);
+        fc.setOperator(opQuery(c.operator));
+        fc.setValue(c.value);
+        return fc;
+    }));
+    fg.setGroupsList(group.groups.map(buildDataGroup));
+    return fg;
+}
+export async function callEventQuery(grpc, apiKey, params) {
+    const req = new QueryEventsRequest();
+    if (params.where)
+        req.setWhere(buildQueryGroup(params.where));
+    if (params.aggregation) {
+        const a = new Aggregation();
+        a.setType(params.aggregation.type === "SUM" ? 1 : 2);
+        if (params.aggregation.field)
+            a.setField(params.aggregation.field);
+        req.setAggregation(a);
+    }
+    if (params.groupBy) {
+        const gb = new GroupBy();
+        gb.setField(params.groupBy);
+        req.setGroupBy(gb);
+    }
+    req.setLimit(params.limit ?? 100);
+    req.setOffset(params.offset ?? 0);
+    const res = await grpc
+        .newCall(QueryServiceClient, "queryEvents")
+        .addMetadata("authorization", `Bearer ${apiKey}`)
+        .addPayload(req)
+        .request();
+    return res.toObject();
+}
+export async function callDataQuery(grpc, apiKey, tableName, params) {
+    const req = new QueryRequest();
+    req.setTable(tableName);
+    if (params.where)
+        req.setWhere(buildDataGroup(params.where));
+    if (params.orderBy && params.orderBy.length > 0) {
+        req.setOrderByList(params.orderBy.map((o) => {
+            const ob = new DOrderBy();
+            ob.setField(o.field);
+            ob.setDescending(o.descending);
+            return ob;
+        }));
+    }
+    req.setLimit(params.limit ?? 100);
+    req.setOffset(params.offset ?? 0);
+    const res = await grpc
+        .newCall(DataQueryServiceClient, "query")
+        .addMetadata("authorization", `Bearer ${apiKey}`)
+        .addPayload(req)
+        .request();
+    return res.toObject();
+}
+//# sourceMappingURL=client.js.map

package/dist/grpc/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { Analytics } from "./analytics.js";
+export type { EventQueries, DataQueries } from "./analytics.js";
+export { FieldRef } from "./fieldRef.js";
+export type { InferRow } from "./fieldRef.js";
+export { eq, neq, gt, gte, lt, lte, contains, and, or, asc, desc, sum, count, } from "./operators.js";
+export type { FilterCondition, FilterGroup, OrderBy, Aggregation, QueryOperator, } from "./operators.js";
+export type { EventRow, AggregationRow, EventListResult, EventAggResult } from "./query/types.js";
+export type { DataQueryResult } from "./data/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EACL,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EACnC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,GAC/B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClG,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Analytics } from "./analytics.js";
+export { FieldRef } from "./fieldRef.js";
+export { eq, neq, gt, gte, lt, lte, contains, and, or, asc, desc, sum, count, } from "./operators.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EACL,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EACnC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,GAC/B,MAAM,gBAAgB,CAAC"}

package/dist/operators.d.ts

@@ -0,0 +1,36 @@
+import type { FieldRef } from "./fieldRef.js";
+export type QueryOperator = "EQ" | "GT" | "GTE" | "LT" | "LTE" | "NEQ" | "CONTAINS";
+export interface FilterCondition {
+    field: string;
+    operator: QueryOperator;
+    value: string;
+}
+export interface FilterGroup {
+    logical: "AND" | "OR";
+    conditions: FilterCondition[];
+    groups: FilterGroup[];
+}
+export interface OrderBy {
+    field: string;
+    descending: boolean;
+}
+export interface Aggregation {
+    type: "SUM" | "COUNT";
+    field?: string;
+}
+export declare function eq<T>(field: FieldRef<T>, value: T): FilterCondition;
+export declare function neq<T>(field: FieldRef<T>, value: T): FilterCondition;
+export declare function gt<T>(field: FieldRef<T>, value: T): FilterCondition;
+export declare function gte<T>(field: FieldRef<T>, value: T): FilterCondition;
+export declare function lt<T>(field: FieldRef<T>, value: T): FilterCondition;
+export declare function lte<T>(field: FieldRef<T>, value: T): FilterCondition;
+export declare function contains<T>(field: FieldRef<T>, value: T): FilterCondition;
+type FilterInput = FilterCondition | FilterGroup;
+export declare function and(...filters: FilterInput[]): FilterGroup;
+export declare function or(...filters: FilterInput[]): FilterGroup;
+export declare function asc(field: FieldRef<unknown>): OrderBy;
+export declare function desc(field: FieldRef<unknown>): OrderBy;
+export declare function sum(field: FieldRef<number>): Aggregation;
+export declare function count(): Aggregation;
+export {};
+//# sourceMappingURL=operators.d.ts.map

package/dist/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../src/operators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEnE;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEpE;AAED,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEnE;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEpE;AAED,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEnE;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEpE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAEzE;AAID,KAAK,WAAW,GAAG,eAAe,GAAG,WAAW,CAAC;AAEjD,wBAAgB,GAAG,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAM1D;AAED,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAMzD;AAID,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAErD;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAEtD;AAID,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAExD;AAED,wBAAgB,KAAK,IAAI,WAAW,CAEnC"}

package/dist/operators.js

@@ -0,0 +1,54 @@
+// ---- comparison operators ----
+function condition(field, operator, value) {
+    return { field: field.name, operator, value: String(value) };
+}
+export function eq(field, value) {
+    return condition(field, "EQ", value);
+}
+export function neq(field, value) {
+    return condition(field, "NEQ", value);
+}
+export function gt(field, value) {
+    return condition(field, "GT", value);
+}
+export function gte(field, value) {
+    return condition(field, "GTE", value);
+}
+export function lt(field, value) {
+    return condition(field, "LT", value);
+}
+export function lte(field, value) {
+    return condition(field, "LTE", value);
+}
+export function contains(field, value) {
+    return condition(field, "CONTAINS", value);
+}
+export function and(...filters) {
+    return {
+        logical: "AND",
+        conditions: filters.filter((f) => "field" in f),
+        groups: filters.filter((f) => "logical" in f),
+    };
+}
+export function or(...filters) {
+    return {
+        logical: "OR",
+        conditions: filters.filter((f) => "field" in f),
+        groups: filters.filter((f) => "logical" in f),
+    };
+}
+// ---- sorting ----
+export function asc(field) {
+    return { field: field.name, descending: false };
+}
+export function desc(field) {
+    return { field: field.name, descending: true };
+}
+// ---- aggregation ----
+export function sum(field) {
+    return { type: "SUM", field: field.name };
+}
+export function count() {
+    return { type: "COUNT" };
+}
+//# sourceMappingURL=operators.js.map

package/dist/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../src/operators.ts"],"names":[],"mappings":"AA0BA,iCAAiC;AAEjC,SAAS,SAAS,CAAI,KAAkB,EAAE,QAAuB,EAAE,KAAQ;IACzE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,EAAE,CAAI,KAAkB,EAAE,KAAQ;IAChD,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAkB,EAAE,KAAQ;IACjD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,EAAE,CAAI,KAAkB,EAAE,KAAQ;IAChD,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAkB,EAAE,KAAQ;IACjD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,EAAE,CAAI,KAAkB,EAAE,KAAQ;IAChD,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAkB,EAAE,KAAQ;IACjD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,KAAkB,EAAE,KAAQ;IACtD,OAAO,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAMD,MAAM,UAAU,GAAG,CAAC,GAAG,OAAsB;IAC3C,OAAO;QACL,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;QACrE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,GAAG,OAAsB;IAC1C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;QACrE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,oBAAoB;AAEpB,MAAM,UAAU,GAAG,CAAC,KAAwB;IAC1C,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAwB;IAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,wBAAwB;AAExB,MAAM,UAAU,GAAG,CAAC,KAAuB;IACzC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/query/aiToken.d.ts

@@ -0,0 +1,7 @@
+import { BaseEventBuilder } from "./base.js";
+import type { GrpcClient } from "@scrawn/core";
+import { aiTokenFields } from "./fields.js";
+export declare class AiTokenBuilder extends BaseEventBuilder<typeof aiTokenFields> {
+    constructor(grpc: GrpcClient, apiKey: string);
+}
+//# sourceMappingURL=aiToken.d.ts.map

package/dist/query/aiToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiToken.d.ts","sourceRoot":"","sources":["../../src/query/aiToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,OAAO,aAAa,CAAC;gBAC5D,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;CAG7C"}

package/dist/query/aiToken.js

@@ -0,0 +1,8 @@
+import { BaseEventBuilder } from "./base.js";
+import { aiTokenFields } from "./fields.js";
+export class AiTokenBuilder extends BaseEventBuilder {
+    constructor(grpc, apiKey) {
+        super(aiTokenFields, "AI_TOKEN_USAGE", grpc, apiKey);
+    }
+}
+//# sourceMappingURL=aiToken.js.map

package/dist/query/aiToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiToken.js","sourceRoot":"","sources":["../../src/query/aiToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,cAAe,SAAQ,gBAAsC;IACxE,YAAY,IAAgB,EAAE,MAAc;QAC1C,KAAK,CAAC,aAAa,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/query/base.d.ts

@@ -0,0 +1,33 @@
+import type { FieldRef } from "../fieldRef.js";
+import type { FilterCondition, FilterGroup, Aggregation, OrderBy } from "../operators.js";
+import type { GrpcClient } from "@scrawn/core";
+import type { EventListResult, EventAggResult } from "./types.js";
+export declare abstract class BaseEventBuilder<TFields, TAgg extends boolean = false> {
+    readonly fields: TFields;
+    private grpc;
+    private apiKey;
+    protected _where?: FilterGroup;
+    protected _aggregation?: Aggregation;
+    protected _groupBy?: string;
+    protected _limit: number;
+    protected _offset: number;
+    protected _orderBy: OrderBy[];
+    private _eventTypeFilter;
+    constructor(fields: TFields, eventType: string, grpc: GrpcClient, apiKey: string);
+    where(filter: FilterCondition | FilterGroup): this;
+    orderBy(...orders: OrderBy[]): this;
+    limit(n: number): this;
+    offset(n: number): this;
+    aggregate(agg: Aggregation): BaseEventBuilder<TFields, true>;
+    groupBy(field: FieldRef<unknown>): this;
+    protected buildParams(): {
+        where: FilterGroup;
+        aggregation: Aggregation | undefined;
+        groupBy: string | undefined;
+        limit: number;
+        offset: number;
+        orderBy: OrderBy[] | undefined;
+    };
+    execute(): Promise<TAgg extends true ? EventAggResult : EventListResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/query/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/query/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,OAAO,EACR,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,8BAAsB,gBAAgB,CAAC,OAAO,EAAE,IAAI,SAAS,OAAO,GAAG,KAAK;aAUxD,MAAM,EAAE,OAAO;IAE/B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAZhB,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC/B,SAAS,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAO;IAC/B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAK;IAC9B,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAM;IACnC,OAAO,CAAC,gBAAgB,CAAkB;gBAGxB,MAAM,EAAE,OAAO,EAC/B,SAAS,EAAE,MAAM,EACT,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;IAKxB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI;IAalD,OAAO,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAKnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC;IAK5D,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;IAKvC,SAAS,CAAC,WAAW;;;;;;;;IAWf,OAAO,IAAI,OAAO,CAAC,IAAI,SAAS,IAAI,GAAG,cAAc,GAAG,eAAe,CAAC;CAM/E"}

package/dist/query/base.js

@@ -0,0 +1,64 @@
+import { and } from "../operators.js";
+import { callEventQuery } from "../grpc/client.js";
+export class BaseEventBuilder {
+    constructor(fields, eventType, grpc, apiKey) {
+        this.fields = fields;
+        this.grpc = grpc;
+        this.apiKey = apiKey;
+        this._limit = 100;
+        this._offset = 0;
+        this._orderBy = [];
+        this._eventTypeFilter = { field: "eventType", operator: "EQ", value: eventType };
+    }
+    where(filter) {
+        if ("operator" in filter) {
+            this._where = and(this._eventTypeFilter, filter);
+        }
+        else {
+            this._where = {
+                logical: filter.logical,
+                conditions: [this._eventTypeFilter, ...filter.conditions],
+                groups: filter.groups,
+            };
+        }
+        return this;
+    }
+    orderBy(...orders) {
+        this._orderBy = orders;
+        return this;
+    }
+    limit(n) {
+        this._limit = n;
+        return this;
+    }
+    offset(n) {
+        this._offset = n;
+        return this;
+    }
+    aggregate(agg) {
+        this._aggregation = agg;
+        return this;
+    }
+    groupBy(field) {
+        this._groupBy = field.name;
+        return this;
+    }
+    buildParams() {
+        return {
+            where: this._where ?? and(this._eventTypeFilter),
+            aggregation: this._aggregation,
+            groupBy: this._groupBy,
+            limit: this._limit,
+            offset: this._offset,
+            orderBy: this._orderBy.length > 0 ? this._orderBy : undefined,
+        };
+    }
+    async execute() {
+        const params = this.buildParams();
+        const res = await callEventQuery(this.grpc, this.apiKey, params);
+        if (this._aggregation)
+            return { rows: res.aggRowsList ?? [], total: res.total ?? 0 };
+        return { rows: res.rowsList ?? [], total: res.total ?? 0 };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/query/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/query/base.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,MAAM,OAAgB,gBAAgB;IASpC,YACkB,MAAe,EAC/B,SAAiB,EACT,IAAgB,EAChB,MAAc;QAHN,WAAM,GAAN,MAAM,CAAS;QAEvB,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAQ;QATd,WAAM,GAAW,GAAG,CAAC;QACrB,YAAO,GAAW,CAAC,CAAC;QACpB,aAAQ,GAAc,EAAE,CAAC;QASjC,IAAI,CAAC,gBAAgB,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,MAAqC;QACzC,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG;gBACZ,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;gBACzD,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,MAAiB;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,CAAS;QACb,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,CAAS;QACd,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,GAAgB;QACxB,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QACxB,OAAO,IAAkD,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,KAAwB;QAC9B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAES,WAAW;QACnB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAChD,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,EAAkE,CAAC;QACrJ,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,EAAoE,CAAC;IAC/H,CAAC;CACF"}

package/dist/query/fields.d.ts

@@ -0,0 +1,34 @@
+import { FieldRef } from "../fieldRef.js";
+export declare const sdkEventFields: {
+    readonly eventId: FieldRef<string>;
+    readonly eventType: FieldRef<string>;
+    readonly userId: FieldRef<string>;
+    readonly reportedTimestamp: FieldRef<string>;
+    readonly ingestedTimestamp: FieldRef<string>;
+    readonly apiKeyId: FieldRef<string>;
+    readonly sdkCallType: FieldRef<string>;
+    readonly debitAmount: FieldRef<number>;
+};
+export declare const aiTokenFields: {
+    readonly eventId: FieldRef<string>;
+    readonly eventType: FieldRef<string>;
+    readonly userId: FieldRef<string>;
+    readonly reportedTimestamp: FieldRef<string>;
+    readonly ingestedTimestamp: FieldRef<string>;
+    readonly apiKeyId: FieldRef<string>;
+    readonly model: FieldRef<string>;
+    readonly inputTokens: FieldRef<number>;
+    readonly outputTokens: FieldRef<number>;
+    readonly inputDebitAmount: FieldRef<number>;
+    readonly outputDebitAmount: FieldRef<number>;
+};
+export declare const paymentFields: {
+    readonly eventId: FieldRef<string>;
+    readonly eventType: FieldRef<string>;
+    readonly userId: FieldRef<string>;
+    readonly reportedTimestamp: FieldRef<string>;
+    readonly ingestedTimestamp: FieldRef<string>;
+    readonly apiKeyId: FieldRef<string>;
+    readonly creditAmount: FieldRef<number>;
+};
+//# sourceMappingURL=fields.d.ts.map

package/dist/query/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/query/fields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYhB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;CAQhB,CAAC"}

package/dist/query/fields.js

@@ -0,0 +1,35 @@
+// AUTO-GENERATED by scripts/gen-fields.ts — do not edit
+import { FieldRef } from "../fieldRef.js";
+export const sdkEventFields = {
+    eventId: new FieldRef("eventId"),
+    eventType: new FieldRef("eventType"),
+    userId: new FieldRef("userId"),
+    reportedTimestamp: new FieldRef("reportedTimestamp"),
+    ingestedTimestamp: new FieldRef("ingestedTimestamp"),
+    apiKeyId: new FieldRef("apiKeyId"),
+    sdkCallType: new FieldRef("sdkCallType"),
+    debitAmount: new FieldRef("debitAmount"),
+};
+export const aiTokenFields = {
+    eventId: new FieldRef("eventId"),
+    eventType: new FieldRef("eventType"),
+    userId: new FieldRef("userId"),
+    reportedTimestamp: new FieldRef("reportedTimestamp"),
+    ingestedTimestamp: new FieldRef("ingestedTimestamp"),
+    apiKeyId: new FieldRef("apiKeyId"),
+    model: new FieldRef("model"),
+    inputTokens: new FieldRef("inputTokens"),
+    outputTokens: new FieldRef("outputTokens"),
+    inputDebitAmount: new FieldRef("inputDebitAmount"),
+    outputDebitAmount: new FieldRef("outputDebitAmount"),
+};
+export const paymentFields = {
+    eventId: new FieldRef("eventId"),
+    eventType: new FieldRef("eventType"),
+    userId: new FieldRef("userId"),
+    reportedTimestamp: new FieldRef("reportedTimestamp"),
+    ingestedTimestamp: new FieldRef("ingestedTimestamp"),
+    apiKeyId: new FieldRef("apiKeyId"),
+    creditAmount: new FieldRef("creditAmount"),
+};
+//# sourceMappingURL=fields.js.map

package/dist/query/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/query/fields.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,IAAI,QAAQ,CAAS,SAAS,CAAC;IACxC,SAAS,EAAE,IAAI,QAAQ,CAAS,WAAW,CAAC;IAC5C,MAAM,EAAE,IAAI,QAAQ,CAAS,QAAQ,CAAC;IACtC,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;IAC5D,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;IAC5D,QAAQ,EAAE,IAAI,QAAQ,CAAS,UAAU,CAAC;IAC1C,WAAW,EAAE,IAAI,QAAQ,CAAS,aAAa,CAAC;IAChD,WAAW,EAAE,IAAI,QAAQ,CAAS,aAAa,CAAC;CACxC,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,IAAI,QAAQ,CAAS,SAAS,CAAC;IACxC,SAAS,EAAE,IAAI,QAAQ,CAAS,WAAW,CAAC;IAC5C,MAAM,EAAE,IAAI,QAAQ,CAAS,QAAQ,CAAC;IACtC,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;IAC5D,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;IAC5D,QAAQ,EAAE,IAAI,QAAQ,CAAS,UAAU,CAAC;IAC1C,KAAK,EAAE,IAAI,QAAQ,CAAS,OAAO,CAAC;IACpC,WAAW,EAAE,IAAI,QAAQ,CAAS,aAAa,CAAC;IAChD,YAAY,EAAE,IAAI,QAAQ,CAAS,cAAc,CAAC;IAClD,gBAAgB,EAAE,IAAI,QAAQ,CAAS,kBAAkB,CAAC;IAC1D,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;CACpD,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,IAAI,QAAQ,CAAS,SAAS,CAAC;IACxC,SAAS,EAAE,IAAI,QAAQ,CAAS,WAAW,CAAC;IAC5C,MAAM,EAAE,IAAI,QAAQ,CAAS,QAAQ,CAAC;IACtC,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;IAC5D,iBAAiB,EAAE,IAAI,QAAQ,CAAS,mBAAmB,CAAC;IAC5D,QAAQ,EAAE,IAAI,QAAQ,CAAS,UAAU,CAAC;IAC1C,YAAY,EAAE,IAAI,QAAQ,CAAS,cAAc,CAAC;CAC1C,CAAC"}

package/dist/query/payment.d.ts

@@ -0,0 +1,7 @@
+import { BaseEventBuilder } from "./base.js";
+import type { GrpcClient } from "@scrawn/core";
+import { paymentFields } from "./fields.js";
+export declare class PaymentBuilder extends BaseEventBuilder<typeof paymentFields> {
+    constructor(grpc: GrpcClient, apiKey: string);
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/query/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/query/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,OAAO,aAAa,CAAC;gBAC5D,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;CAG7C"}

package/dist/query/payment.js

@@ -0,0 +1,8 @@
+import { BaseEventBuilder } from "./base.js";
+import { paymentFields } from "./fields.js";
+export class PaymentBuilder extends BaseEventBuilder {
+    constructor(grpc, apiKey) {
+        super(paymentFields, "PAYMENT", grpc, apiKey);
+    }
+}
+//# sourceMappingURL=payment.js.map

package/dist/query/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/query/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,cAAe,SAAQ,gBAAsC;IACxE,YAAY,IAAgB,EAAE,MAAc;QAC1C,KAAK,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/query/sdkEvent.d.ts

@@ -0,0 +1,7 @@
+import { BaseEventBuilder } from "./base.js";
+import type { GrpcClient } from "@scrawn/core";
+import { sdkEventFields } from "./fields.js";
+export declare class SdkEventBuilder extends BaseEventBuilder<typeof sdkEventFields> {
+    constructor(grpc: GrpcClient, apiKey: string);
+}
+//# sourceMappingURL=sdkEvent.d.ts.map

package/dist/query/sdkEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkEvent.d.ts","sourceRoot":"","sources":["../../src/query/sdkEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,eAAgB,SAAQ,gBAAgB,CAAC,OAAO,cAAc,CAAC;gBAC9D,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;CAG7C"}

package/dist/query/sdkEvent.js

@@ -0,0 +1,8 @@
+import { BaseEventBuilder } from "./base.js";
+import { sdkEventFields } from "./fields.js";
+export class SdkEventBuilder extends BaseEventBuilder {
+    constructor(grpc, apiKey) {
+        super(sdkEventFields, "SDK_CALL", grpc, apiKey);
+    }
+}
+//# sourceMappingURL=sdkEvent.js.map

package/dist/query/sdkEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkEvent.js","sourceRoot":"","sources":["../../src/query/sdkEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAO,eAAgB,SAAQ,gBAAuC;IAC1E,YAAY,IAAgB,EAAE,MAAc;QAC1C,KAAK,CAAC,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/query/types.d.ts

@@ -0,0 +1,12 @@
+import type { QueryEventsResponse } from "@scrawn/core";
+export type EventRow = QueryEventsResponse.AsObject["rowsList"][number];
+export type AggregationRow = QueryEventsResponse.AsObject["aggRowsList"][number];
+export interface EventListResult {
+    rows: EventRow[];
+    total: number;
+}
+export interface EventAggResult {
+    rows: AggregationRow[];
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/query/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/query/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/query/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/query/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scrawn/analytics",
-  "version": "0.0.2",
+  "version": "0.0.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",