@scrawn/core 0.0.3 → 0.0.6

package/dist/gen/query/v1/query_pb.d.ts

@@ -0,0 +1,359 @@
+// package: query.v1
+// file: query/v1/query.proto
+
+import * as jspb from "google-protobuf";
+
+export class FilterCondition extends jspb.Message {
+  getField(): string;
+  setField(value: string): void;
+
+  getOperator(): OperatorMap[keyof OperatorMap];
+  setOperator(value: OperatorMap[keyof OperatorMap]): void;
+
+  getValue(): string;
+  setValue(value: string): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): FilterCondition.AsObject;
+  static toObject(includeInstance: boolean, msg: FilterCondition): FilterCondition.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: FilterCondition, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): FilterCondition;
+  static deserializeBinaryFromReader(message: FilterCondition, reader: jspb.BinaryReader): FilterCondition;
+}
+
+export namespace FilterCondition {
+  export type AsObject = {
+    field: string,
+    operator: OperatorMap[keyof OperatorMap],
+    value: string,
+  }
+}
+
+export class FilterGroup extends jspb.Message {
+  getLogical(): LogicalOperatorMap[keyof LogicalOperatorMap];
+  setLogical(value: LogicalOperatorMap[keyof LogicalOperatorMap]): void;
+
+  clearConditionsList(): void;
+  getConditionsList(): Array<FilterCondition>;
+  setConditionsList(value: Array<FilterCondition>): void;
+  addConditions(value?: FilterCondition, index?: number): FilterCondition;
+
+  clearGroupsList(): void;
+  getGroupsList(): Array<FilterGroup>;
+  setGroupsList(value: Array<FilterGroup>): void;
+  addGroups(value?: FilterGroup, index?: number): FilterGroup;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): FilterGroup.AsObject;
+  static toObject(includeInstance: boolean, msg: FilterGroup): FilterGroup.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: FilterGroup, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): FilterGroup;
+  static deserializeBinaryFromReader(message: FilterGroup, reader: jspb.BinaryReader): FilterGroup;
+}
+
+export namespace FilterGroup {
+  export type AsObject = {
+    logical: LogicalOperatorMap[keyof LogicalOperatorMap],
+    conditionsList: Array<FilterCondition.AsObject>,
+    groupsList: Array<FilterGroup.AsObject>,
+  }
+}
+
+export class Aggregation extends jspb.Message {
+  getType(): AggregationTypeMap[keyof AggregationTypeMap];
+  setType(value: AggregationTypeMap[keyof AggregationTypeMap]): void;
+
+  getField(): string;
+  setField(value: string): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): Aggregation.AsObject;
+  static toObject(includeInstance: boolean, msg: Aggregation): Aggregation.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: Aggregation, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): Aggregation;
+  static deserializeBinaryFromReader(message: Aggregation, reader: jspb.BinaryReader): Aggregation;
+}
+
+export namespace Aggregation {
+  export type AsObject = {
+    type: AggregationTypeMap[keyof AggregationTypeMap],
+    field: string,
+  }
+}
+
+export class GroupBy extends jspb.Message {
+  getField(): string;
+  setField(value: string): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): GroupBy.AsObject;
+  static toObject(includeInstance: boolean, msg: GroupBy): GroupBy.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: GroupBy, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): GroupBy;
+  static deserializeBinaryFromReader(message: GroupBy, reader: jspb.BinaryReader): GroupBy;
+}
+
+export namespace GroupBy {
+  export type AsObject = {
+    field: string,
+  }
+}
+
+export class QueryEventsRequest extends jspb.Message {
+  hasWhere(): boolean;
+  clearWhere(): void;
+  getWhere(): FilterGroup | undefined;
+  setWhere(value?: FilterGroup): void;
+
+  hasAggregation(): boolean;
+  clearAggregation(): void;
+  getAggregation(): Aggregation | undefined;
+  setAggregation(value?: Aggregation): void;
+
+  hasGroupBy(): boolean;
+  clearGroupBy(): void;
+  getGroupBy(): GroupBy | undefined;
+  setGroupBy(value?: GroupBy): void;
+
+  getLimit(): number;
+  setLimit(value: number): void;
+
+  getOffset(): number;
+  setOffset(value: number): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): QueryEventsRequest.AsObject;
+  static toObject(includeInstance: boolean, msg: QueryEventsRequest): QueryEventsRequest.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: QueryEventsRequest, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): QueryEventsRequest;
+  static deserializeBinaryFromReader(message: QueryEventsRequest, reader: jspb.BinaryReader): QueryEventsRequest;
+}
+
+export namespace QueryEventsRequest {
+  export type AsObject = {
+    where?: FilterGroup.AsObject,
+    aggregation?: Aggregation.AsObject,
+    groupBy?: GroupBy.AsObject,
+    limit: number,
+    offset: number,
+  }
+}
+
+export class EventRow extends jspb.Message {
+  getEventId(): string;
+  setEventId(value: string): void;
+
+  getEventType(): string;
+  setEventType(value: string): void;
+
+  getUserId(): string;
+  setUserId(value: string): void;
+
+  getReportedTimestamp(): string;
+  setReportedTimestamp(value: string): void;
+
+  getIngestedTimestamp(): string;
+  setIngestedTimestamp(value: string): void;
+
+  hasSdkCallType(): boolean;
+  clearSdkCallType(): void;
+  getSdkCallType(): string;
+  setSdkCallType(value: string): void;
+
+  hasDebitAmount(): boolean;
+  clearDebitAmount(): void;
+  getDebitAmount(): number;
+  setDebitAmount(value: number): void;
+
+  hasModel(): boolean;
+  clearModel(): void;
+  getModel(): string;
+  setModel(value: string): void;
+
+  hasInputTokens(): boolean;
+  clearInputTokens(): void;
+  getInputTokens(): number;
+  setInputTokens(value: number): void;
+
+  hasOutputTokens(): boolean;
+  clearOutputTokens(): void;
+  getOutputTokens(): number;
+  setOutputTokens(value: number): void;
+
+  hasInputDebitAmount(): boolean;
+  clearInputDebitAmount(): void;
+  getInputDebitAmount(): number;
+  setInputDebitAmount(value: number): void;
+
+  hasOutputDebitAmount(): boolean;
+  clearOutputDebitAmount(): void;
+  getOutputDebitAmount(): number;
+  setOutputDebitAmount(value: number): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): EventRow.AsObject;
+  static toObject(includeInstance: boolean, msg: EventRow): EventRow.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: EventRow, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): EventRow;
+  static deserializeBinaryFromReader(message: EventRow, reader: jspb.BinaryReader): EventRow;
+}
+
+export namespace EventRow {
+  export type AsObject = {
+    eventId: string,
+    eventType: string,
+    userId: string,
+    reportedTimestamp: string,
+    ingestedTimestamp: string,
+    sdkCallType: string,
+    debitAmount: number,
+    model: string,
+    inputTokens: number,
+    outputTokens: number,
+    inputDebitAmount: number,
+    outputDebitAmount: number,
+  }
+}
+
+export class AggregationRow extends jspb.Message {
+  hasGroupValue(): boolean;
+  clearGroupValue(): void;
+  getGroupValue(): string;
+  setGroupValue(value: string): void;
+
+  getAggValue(): string;
+  setAggValue(value: string): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): AggregationRow.AsObject;
+  static toObject(includeInstance: boolean, msg: AggregationRow): AggregationRow.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: AggregationRow, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): AggregationRow;
+  static deserializeBinaryFromReader(message: AggregationRow, reader: jspb.BinaryReader): AggregationRow;
+}
+
+export namespace AggregationRow {
+  export type AsObject = {
+    groupValue: string,
+    aggValue: string,
+  }
+}
+
+export class QueryEventsResponse extends jspb.Message {
+  clearRowsList(): void;
+  getRowsList(): Array<EventRow>;
+  setRowsList(value: Array<EventRow>): void;
+  addRows(value?: EventRow, index?: number): EventRow;
+
+  clearAggRowsList(): void;
+  getAggRowsList(): Array<AggregationRow>;
+  setAggRowsList(value: Array<AggregationRow>): void;
+  addAggRows(value?: AggregationRow, index?: number): AggregationRow;
+
+  getTotal(): number;
+  setTotal(value: number): void;
+
+  serializeBinary(): Uint8Array;
+  toObject(includeInstance?: boolean): QueryEventsResponse.AsObject;
+  static toObject(includeInstance: boolean, msg: QueryEventsResponse): QueryEventsResponse.AsObject;
+  static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+  static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+  static serializeBinaryToWriter(message: QueryEventsResponse, writer: jspb.BinaryWriter): void;
+  static deserializeBinary(bytes: Uint8Array): QueryEventsResponse;
+  static deserializeBinaryFromReader(message: QueryEventsResponse, reader: jspb.BinaryReader): QueryEventsResponse;
+}
+
+export namespace QueryEventsResponse {
+  export type AsObject = {
+    rowsList: Array<EventRow.AsObject>,
+    aggRowsList: Array<AggregationRow.AsObject>,
+    total: number,
+  }
+}
+
+export interface OperatorMap {
+  OPERATOR_UNSPECIFIED: 0;
+  EQ: 1;
+  GT: 2;
+  GTE: 3;
+  LT: 4;
+  LTE: 5;
+  NEQ: 6;
+}
+
+export const Operator: OperatorMap;
+
+export interface AggregationTypeMap {
+  AGGREGATION_TYPE_UNSPECIFIED: 0;
+  SUM: 1;
+  COUNT: 2;
+}
+
+export const AggregationType: AggregationTypeMap;
+
+export interface LogicalOperatorMap {
+  LOGICAL_OPERATOR_UNSPECIFIED: 0;
+  AND: 1;
+  OR: 2;
+}
+
+export const LogicalOperator: LogicalOperatorMap;
+
+export interface SdkCallFieldMap {
+  SDK_CALL_FIELD_UNSPECIFIED: 0;
+  SDK_CALL_EVENT_ID: 1;
+  SDK_CALL_EVENT_TYPE: 2;
+  SDK_CALL_USER_ID: 3;
+  SDK_CALL_API_KEY_ID: 4;
+  SDK_CALL_REPORTED_TIMESTAMP: 5;
+  SDK_CALL_INGESTED_TIMESTAMP: 6;
+  SDK_CALL_SDK_CALL_TYPE: 7;
+  SDK_CALL_DEBIT_AMOUNT: 8;
+}
+
+export const SdkCallField: SdkCallFieldMap;
+
+export interface AiTokenFieldMap {
+  AI_TOKEN_FIELD_UNSPECIFIED: 0;
+  AI_TOKEN_EVENT_ID: 1;
+  AI_TOKEN_EVENT_TYPE: 2;
+  AI_TOKEN_USER_ID: 3;
+  AI_TOKEN_API_KEY_ID: 4;
+  AI_TOKEN_REPORTED_TIMESTAMP: 5;
+  AI_TOKEN_INGESTED_TIMESTAMP: 6;
+  AI_TOKEN_MODEL: 7;
+  AI_TOKEN_INPUT_TOKENS: 8;
+  AI_TOKEN_OUTPUT_TOKENS: 9;
+  AI_TOKEN_INPUT_DEBIT_AMOUNT: 10;
+  AI_TOKEN_OUTPUT_DEBIT_AMOUNT: 11;
+}
+
+export const AiTokenField: AiTokenFieldMap;
+
+export interface PaymentFieldMap {
+  PAYMENT_FIELD_UNSPECIFIED: 0;
+  PAYMENT_EVENT_ID: 1;
+  PAYMENT_EVENT_TYPE: 2;
+  PAYMENT_USER_ID: 3;
+  PAYMENT_API_KEY_ID: 4;
+  PAYMENT_REPORTED_TIMESTAMP: 5;
+  PAYMENT_INGESTED_TIMESTAMP: 6;
+  PAYMENT_CREDIT_AMOUNT: 7;
+}
+
+export const PaymentField: PaymentFieldMap;
+

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./core/scrawn.js";
+export * from "./core/types/event.js";
+export * from "./core/types/auth.js";
+export * from "./core/errors/index.js";
+export * from "./core/grpc/index.js";
+export * from "./core/pricing/index.js";
+export { matchPath } from "./utils/pathMatcher.js";
+export * from "./gen/event/v1/event_grpc_pb.js";
+export * from "./gen/event/v1/event_pb.js";
+export * from "./gen/auth/v1/auth_grpc_pb.js";
+export * from "./gen/auth/v1/auth_pb.js";
+export * from "./gen/payment/v1/payment_grpc_pb.js";
+export * from "./gen/payment/v1/payment_pb.js";
+export * from "./gen/query/v1/query_grpc_pb.js";
+export * from "./gen/query/v1/query_pb.js";
+export { DataQueryServiceClient } from "./gen/data/v1/data_grpc_pb.js";
+export { OrderBy, QueryRequest, QueryResponse, Row } from "./gen/data/v1/data_pb.js";
+export { ScrawnConfig, scrawnConfig } from "./config.js";
+export type { ScrawnCLIConfig } from "./config.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,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,yBAAyB,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAGrF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+export * from "./core/scrawn.js";
+export * from "./core/types/event.js";
+export * from "./core/types/auth.js";
+// Export error classes for user error handling
+export * from "./core/errors/index.js";
+// Export gRPC client abstraction layer
+export * from "./core/grpc/index.js";
+// Export pricing DSL for building complex billing expressions
+export * from "./core/pricing/index.js";
+// Export utilities
+export { matchPath } from "./utils/pathMatcher.js";
+// Export generated types for advanced usage
+export * from "./gen/event/v1/event_grpc_pb.js";
+export * from "./gen/event/v1/event_pb.js";
+export * from "./gen/auth/v1/auth_grpc_pb.js";
+export * from "./gen/auth/v1/auth_pb.js";
+export * from "./gen/payment/v1/payment_grpc_pb.js";
+export * from "./gen/payment/v1/payment_pb.js";
+export * from "./gen/query/v1/query_grpc_pb.js";
+export * from "./gen/query/v1/query_pb.js";
+export { DataQueryServiceClient } from "./gen/data/v1/data_grpc_pb.js";
+export { OrderBy, QueryRequest, QueryResponse, Row } from "./gen/data/v1/data_pb.js";
+// Export central configuration
+export { ScrawnConfig, scrawnConfig } from "./config.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,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AAErC,+CAA+C;AAC/C,cAAc,wBAAwB,CAAC;AAEvC,uCAAuC;AACvC,cAAc,sBAAsB,CAAC;AAErC,8DAA8D;AAC9D,cAAc,yBAAyB,CAAC;AAExC,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,4CAA4C;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAErF,+BAA+B;AAC/B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/forkAsyncIterable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Forks an async iterable into two independent async iterables.
+ *
+ * Both returned iterables will receive the same items from the source.
+ * Items are buffered internally so both consumers can read at their own pace.
+ *
+ * @param source - The source async iterable to fork
+ * @returns A tuple of two async iterables that both yield the same items
+ *
+ * @internal
+ */
+export declare function forkAsyncIterable<T>(source: AsyncIterable<T>): [AsyncIterable<T>, AsyncIterable<T>];
+//# sourceMappingURL=forkAsyncIterable.d.ts.map

package/dist/utils/forkAsyncIterable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forkAsyncIterable.d.ts","sourceRoot":"","sources":["../../src/utils/forkAsyncIterable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAyEtC"}

package/dist/utils/forkAsyncIterable.js

@@ -0,0 +1,78 @@
+/**
+ * Forks an async iterable into two independent async iterables.
+ *
+ * Both returned iterables will receive the same items from the source.
+ * Items are buffered internally so both consumers can read at their own pace.
+ *
+ * @param source - The source async iterable to fork
+ * @returns A tuple of two async iterables that both yield the same items
+ *
+ * @internal
+ */
+export function forkAsyncIterable(source) {
+    const buffer1 = [];
+    const buffer2 = [];
+    let resolve1 = null;
+    let resolve2 = null;
+    let done = false;
+    let started = false;
+    // Start consuming the source and push to both buffers
+    async function startConsuming() {
+        if (started)
+            return;
+        started = true;
+        try {
+            for await (const item of source) {
+                buffer1.push(item);
+                buffer2.push(item);
+                // Wake up any waiting consumers
+                if (resolve1) {
+                    resolve1();
+                    resolve1 = null;
+                }
+                if (resolve2) {
+                    resolve2();
+                    resolve2 = null;
+                }
+            }
+        }
+        finally {
+            done = true;
+            // Wake up consumers so they can finish
+            if (resolve1) {
+                resolve1();
+                resolve1 = null;
+            }
+            if (resolve2) {
+                resolve2();
+                resolve2 = null;
+            }
+        }
+    }
+    async function* createIterator(buffer, setResolve) {
+        // Kick off consuming (idempotent)
+        startConsuming();
+        while (true) {
+            if (buffer.length > 0) {
+                yield buffer.shift();
+            }
+            else if (done) {
+                return;
+            }
+            else {
+                // Wait for new item or done
+                await new Promise((resolve) => {
+                    setResolve(resolve);
+                });
+            }
+        }
+    }
+    const iter1 = createIterator(buffer1, (r) => {
+        resolve1 = r;
+    });
+    const iter2 = createIterator(buffer2, (r) => {
+        resolve2 = r;
+    });
+    return [iter1, iter2];
+}
+//# sourceMappingURL=forkAsyncIterable.js.map

package/dist/utils/forkAsyncIterable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forkAsyncIterable.js","sourceRoot":"","sources":["../../src/utils/forkAsyncIterable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAwB;IAExB,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,IAAI,QAAQ,GAAwB,IAAI,CAAC;IACzC,IAAI,QAAQ,GAAwB,IAAI,CAAC;IAEzC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,sDAAsD;IACtD,KAAK,UAAU,cAAc;QAC3B,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QAEf,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEnB,gCAAgC;gBAChC,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,EAAE,CAAC;oBACX,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;gBACD,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,EAAE,CAAC;oBACX,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,GAAG,IAAI,CAAC;YACZ,uCAAuC;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,EAAE,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;YACD,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,EAAE,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,SAAS,CAAC,CAAC,cAAc,CAC5B,MAAW,EACX,UAA4C;QAE5C,kCAAkC;QAClC,cAAc,EAAE,CAAC;QAEjB,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,MAAM,CAAC,KAAK,EAAG,CAAC;YACxB,CAAC;iBAAM,IAAI,IAAI,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;iBAAM,CAAC;gBACN,4BAA4B;gBAC5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAClC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACtB,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QAC1C,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QAC1C,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+export declare class ScrawnLogger {
+    private context;
+    constructor(context?: string);
+    private log;
+    info(msg: string, data?: any): void;
+    warn(msg: string, data?: any): void;
+    error(msg: string, err?: any): void;
+    debug(msg: string, data?: any): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAsBA,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,MAAiB;IAE9C,OAAO,CAAC,GAAG;IAiCX,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAI5B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAI5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG;IAQ5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAG9B"}

package/dist/utils/logger.js

@@ -0,0 +1,62 @@
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import pino from "pino";
+import { ScrawnConfig } from "../config.js";
+// ensure log file directory exists
+const logFilePath = path.resolve(process.cwd(), "scrawn.log");
+fs.mkdirSync(path.dirname(logFilePath), { recursive: true });
+// create pino instance writing to file
+const baseLogger = pino({
+    name: "scrawn",
+    level: ScrawnConfig.logging.enableDebug ? "debug" : "info",
+    timestamp: pino.stdTimeFunctions.isoTime,
+}, pino.destination(logFilePath));
+export class ScrawnLogger {
+    constructor(context = "Scrawn") {
+        this.context = context;
+    }
+    log(level, message, ...args) {
+        const timestamp = `[${new Date().toLocaleTimeString("en-IN", { timeZone: "Asia/Kolkata" })}]`;
+        const prefix = `[${this.context}]`;
+        let colorizedPrefix;
+        switch (level) {
+            case "info":
+                colorizedPrefix = chalk.cyan(`${timestamp} ${prefix}`);
+                baseLogger.info({ context: this.context, ...args[0] }, message);
+                break;
+            case "warn":
+                colorizedPrefix = chalk.yellow(`${timestamp} ${prefix}`);
+                baseLogger.warn({ context: this.context, ...args[0] }, message);
+                break;
+            case "error":
+                colorizedPrefix = chalk.redBright(`${timestamp} ${prefix}`);
+                baseLogger.error({ context: this.context, ...args[0] }, message);
+                break;
+            case "debug":
+                colorizedPrefix = chalk.magenta(`${timestamp} ${prefix}`);
+                baseLogger.debug({ context: this.context, ...args[0] }, message);
+                break;
+            default:
+                colorizedPrefix = `${timestamp} ${prefix}`;
+        }
+        // skip debug unless enabled
+        if (level === "debug" && !process.env.SCRAWN_DEBUG)
+            return;
+        // print to console with color
+        console.log(`${colorizedPrefix} ${message}`);
+    }
+    info(msg, data) {
+        this.log("info", msg, data);
+    }
+    warn(msg, data) {
+        this.log("warn", msg, data);
+    }
+    error(msg, err) {
+        this.log("error", msg, err instanceof Error ? { err: err.message, stack: err.stack } : err);
+    }
+    debug(msg, data) {
+        this.log("debug", msg, data);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/pathMatcher.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Match a path against a pattern with wildcard support.
+ *
+ * Supports:
+ * - Exact match: /api/users
+ * - Single segment wildcard (*): /api/star matches /api/users but not /api/users/123
+ * - Multi-segment wildcard (**): /api/starstar matches /api/users, /api/users/123, etc.
+ * - Mixed patterns: /api/star/profile, /api/starstar/data, starstar.php, etc.
+ *
+ * @param path - The request path to match
+ * @param pattern - The pattern to match against
+ * @returns true if the path matches the pattern
+ *
+ * @example
+ * ```typescript
+ * matchPath('/api/users', '/api/users') // true - exact match
+ * matchPath('/api/users', '/api/*') // true - single segment wildcard
+ * matchPath('/api/users/123', '/api/*') // false - too many segments
+ * matchPath('/api/users/123', '/api/**') // true - multi-segment wildcard
+ * matchPath('/api/v1/users/data', '/api/** /data') // true - mixed pattern
+ * matchPath('/index.php', '**.php') // true - file extension match
+ * ```
+ */
+export declare function matchPath(path: string, pattern: string): boolean;
+//# sourceMappingURL=pathMatcher.d.ts.map

package/dist/utils/pathMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathMatcher.d.ts","sourceRoot":"","sources":["../../src/utils/pathMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAuBhE"}

package/dist/utils/pathMatcher.js

@@ -0,0 +1,46 @@
+/**
+ * Match a path against a pattern with wildcard support.
+ *
+ * Supports:
+ * - Exact match: /api/users
+ * - Single segment wildcard (*): /api/star matches /api/users but not /api/users/123
+ * - Multi-segment wildcard (**): /api/starstar matches /api/users, /api/users/123, etc.
+ * - Mixed patterns: /api/star/profile, /api/starstar/data, starstar.php, etc.
+ *
+ * @param path - The request path to match
+ * @param pattern - The pattern to match against
+ * @returns true if the path matches the pattern
+ *
+ * @example
+ * ```typescript
+ * matchPath('/api/users', '/api/users') // true - exact match
+ * matchPath('/api/users', '/api/*') // true - single segment wildcard
+ * matchPath('/api/users/123', '/api/*') // false - too many segments
+ * matchPath('/api/users/123', '/api/**') // true - multi-segment wildcard
+ * matchPath('/api/v1/users/data', '/api/** /data') // true - mixed pattern
+ * matchPath('/index.php', '**.php') // true - file extension match
+ * ```
+ */
+export function matchPath(path, pattern) {
+    // Exact match
+    if (path === pattern)
+        return true;
+    // No wildcards, no match
+    if (!pattern.includes("*"))
+        return false;
+    // Convert pattern to regex
+    // Escape special regex characters except * and /
+    let regexPattern = pattern
+        .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
+        // Replace ** with a placeholder to handle it separately
+        .replace(/\*\*/g, "___DOUBLE_STAR___")
+        // Replace * with single segment match (anything except /)
+        .replace(/\*/g, "[^/]+")
+        // Replace ** placeholder with multi-segment match (anything including /)
+        .replace(/___DOUBLE_STAR___/g, ".*");
+    // Ensure we match the full path
+    regexPattern = `^${regexPattern}$`;
+    const regex = new RegExp(regexPattern);
+    return regex.test(path);
+}
+//# sourceMappingURL=pathMatcher.js.map