@gurulu/node 0.1.1 → 1.0.0

package/dist/middleware/express.d.ts

@@ -0,0 +1,25 @@
+export interface ExpressReqLike {
+    ip?: string;
+    headers: Record<string, string | string[] | undefined>;
+    cookies?: Record<string, string>;
+    socket?: {
+        remoteAddress?: string;
+    };
+    hostname?: string;
+}
+export interface ExpressResLike {
+    setHeader: (name: string, value: string) => void;
+    on: (event: string, cb: () => void) => void;
+}
+export type NextFn = (err?: unknown) => void;
+export interface ExpressMiddlewareOptions {
+    /** Cookie name carrying anonymous_id from browser. Default `gurulu_aid`. */
+    anonymousIdCookie?: string;
+    /** Custom header carrying anonymous_id (server-to-server). Default `x-gurulu-anonymous-id`. */
+    anonymousIdHeader?: string;
+    /** Propagate request_id to response header. Default true. */
+    emitResponseHeader?: boolean;
+}
+/** Returns Express-compatible middleware: `app.use(gurulu.express.middleware())`. */
+export declare function createExpressMiddleware(options?: ExpressMiddlewareOptions): (req: ExpressReqLike, res: ExpressResLike, next: NextFn) => void;
+//# sourceMappingURL=express.d.ts.map

package/dist/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/middleware/express.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,IAM1E,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,MAAM,MAAM,KACX,IAAI,CAoBR"}

package/dist/middleware/express.js

@@ -0,0 +1,66 @@
+// src/context.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var contextStorage = new AsyncLocalStorage;
+function runWithContext(ctx, fn) {
+  return contextStorage.run(ctx, fn);
+}
+function getContext() {
+  return contextStorage.getStore();
+}
+function mergeContext(explicit) {
+  const stored = contextStorage.getStore();
+  if (!stored && !explicit)
+    return {};
+  if (!stored)
+    return explicit ?? {};
+  if (!explicit)
+    return stored;
+  return {
+    ...stored,
+    ...explicit,
+    source_context: { ...stored.source_context, ...explicit.source_context },
+    consent_state: explicit.consent_state ?? stored.consent_state
+  };
+}
+function generateRequestId() {
+  return crypto.randomUUID();
+}
+
+// src/middleware/express.ts
+function createExpressMiddleware(options = {}) {
+  const cookieName = options.anonymousIdCookie ?? "gurulu_aid";
+  const headerName = options.anonymousIdHeader ?? "x-gurulu-anonymous-id";
+  const emit = options.emitResponseHeader ?? true;
+  return function guruluExpressMiddleware(req, res, next) {
+    const headerVal = req.headers[headerName];
+    const headerAid = Array.isArray(headerVal) ? headerVal[0] : headerVal;
+    const cookieAid = req.cookies?.[cookieName];
+    const requestId = pickHeader(req.headers["x-request-id"]) ?? generateRequestId();
+    const traceId = pickHeader(req.headers["x-trace-id"]) ?? pickHeader(req.headers.traceparent);
+    const ctx = {
+      request_id: requestId
+    };
+    if (headerAid || cookieAid)
+      ctx.anonymous_id = headerAid ?? cookieAid;
+    if (traceId)
+      ctx.trace_id = traceId;
+    if (req.ip || req.socket?.remoteAddress)
+      ctx.ip = req.ip ?? req.socket?.remoteAddress;
+    const ua = pickHeader(req.headers["user-agent"]);
+    if (ua)
+      ctx.user_agent = ua;
+    if (req.hostname)
+      ctx.domain = req.hostname;
+    if (emit)
+      res.setHeader("x-gurulu-request-id", requestId);
+    runWithContext(ctx, () => next());
+  };
+}
+function pickHeader(v) {
+  if (Array.isArray(v))
+    return v[0];
+  return v;
+}
+export {
+  createExpressMiddleware
+};

package/dist/middleware/fastify.d.ts

@@ -0,0 +1,20 @@
+export interface FastifyReqLike {
+    ip?: string;
+    headers: Record<string, string | string[] | undefined>;
+    cookies?: Record<string, string>;
+    hostname?: string;
+}
+export interface FastifyReplyLike {
+    header: (name: string, value: string) => unknown;
+}
+export interface FastifyInstanceLike {
+    addHook: (name: 'onRequest', handler: (req: FastifyReqLike, reply: FastifyReplyLike) => Promise<void> | void) => void;
+}
+export interface FastifyPluginOptions {
+    anonymousIdCookie?: string;
+    anonymousIdHeader?: string;
+    emitResponseHeader?: boolean;
+}
+/** Fastify plugin (default async signature). */
+export declare function createFastifyPlugin(options?: FastifyPluginOptions): (fastify: FastifyInstanceLike) => Promise<void>;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/middleware/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/middleware/fastify.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAClD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CACP,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAC5E,IAAI,CAAC;CACX;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,IAK1B,SAAS,mBAAmB,KAAG,OAAO,CAAC,IAAI,CAAC,CAuBvF"}

package/dist/middleware/fastify.js

@@ -0,0 +1,68 @@
+// src/context.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var contextStorage = new AsyncLocalStorage;
+function runWithContext(ctx, fn) {
+  return contextStorage.run(ctx, fn);
+}
+function getContext() {
+  return contextStorage.getStore();
+}
+function mergeContext(explicit) {
+  const stored = contextStorage.getStore();
+  if (!stored && !explicit)
+    return {};
+  if (!stored)
+    return explicit ?? {};
+  if (!explicit)
+    return stored;
+  return {
+    ...stored,
+    ...explicit,
+    source_context: { ...stored.source_context, ...explicit.source_context },
+    consent_state: explicit.consent_state ?? stored.consent_state
+  };
+}
+function generateRequestId() {
+  return crypto.randomUUID();
+}
+
+// src/middleware/fastify.ts
+function createFastifyPlugin(options = {}) {
+  const cookieName = options.anonymousIdCookie ?? "gurulu_aid";
+  const headerName = options.anonymousIdHeader ?? "x-gurulu-anonymous-id";
+  const emit = options.emitResponseHeader ?? true;
+  return async function guruluFastifyPlugin(fastify) {
+    fastify.addHook("onRequest", (req, reply) => {
+      return new Promise((resolve) => {
+        const headerVal = req.headers[headerName];
+        const headerAid = Array.isArray(headerVal) ? headerVal[0] : headerVal;
+        const cookieAid = req.cookies?.[cookieName];
+        const requestId = pickHeader(req.headers["x-request-id"]) ?? generateRequestId();
+        const traceId = pickHeader(req.headers["x-trace-id"]) ?? pickHeader(req.headers.traceparent);
+        const ctx = { request_id: requestId };
+        if (headerAid || cookieAid)
+          ctx.anonymous_id = headerAid ?? cookieAid;
+        if (traceId)
+          ctx.trace_id = traceId;
+        if (req.ip)
+          ctx.ip = req.ip;
+        const ua = pickHeader(req.headers["user-agent"]);
+        if (ua)
+          ctx.user_agent = ua;
+        if (req.hostname)
+          ctx.domain = req.hostname;
+        if (emit)
+          reply.header("x-gurulu-request-id", requestId);
+        runWithContext(ctx, () => resolve());
+      });
+    });
+  };
+}
+function pickHeader(v) {
+  if (Array.isArray(v))
+    return v[0];
+  return v;
+}
+export {
+  createFastifyPlugin
+};

package/dist/middleware/next.d.ts

@@ -0,0 +1,10 @@
+import type { ServerContext } from '../types.ts';
+export interface NextHandlerOptions {
+    anonymousIdCookie?: string;
+    anonymousIdHeader?: string;
+}
+type RouteHandler<T> = (req: Request, ctx: ServerContext) => Promise<T> | T;
+/** App Router wrapper — auto AsyncLocalStorage context per request. */
+export declare function createNextHandler(options?: NextHandlerOptions): <T>(handler: RouteHandler<T>) => (req: Request) => Promise<T>;
+export {};
+//# sourceMappingURL=next.d.ts.map

package/dist/middleware/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/middleware/next.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE5E,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,IAI3C,CAAC,EAAE,SAAS,YAAY,CAAC,CAAC,CAAC,KAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAuBhF"}

package/dist/middleware/next.js

@@ -0,0 +1,69 @@
+// src/context.ts
+import { AsyncLocalStorage } from "node:async_hooks";
+var contextStorage = new AsyncLocalStorage;
+function runWithContext(ctx, fn) {
+  return contextStorage.run(ctx, fn);
+}
+function getContext() {
+  return contextStorage.getStore();
+}
+function mergeContext(explicit) {
+  const stored = contextStorage.getStore();
+  if (!stored && !explicit)
+    return {};
+  if (!stored)
+    return explicit ?? {};
+  if (!explicit)
+    return stored;
+  return {
+    ...stored,
+    ...explicit,
+    source_context: { ...stored.source_context, ...explicit.source_context },
+    consent_state: explicit.consent_state ?? stored.consent_state
+  };
+}
+function generateRequestId() {
+  return crypto.randomUUID();
+}
+
+// src/middleware/next.ts
+function createNextHandler(options = {}) {
+  const cookieName = options.anonymousIdCookie ?? "gurulu_aid";
+  const headerName = options.anonymousIdHeader ?? "x-gurulu-anonymous-id";
+  return function wrap(handler) {
+    return async function nextRouteHandler(req) {
+      const headerAid = req.headers.get(headerName) ?? undefined;
+      const cookieAid = readCookie(req.headers.get("cookie"), cookieName);
+      const requestId = req.headers.get("x-request-id") ?? generateRequestId();
+      const traceId = req.headers.get("x-trace-id") ?? req.headers.get("traceparent") ?? undefined;
+      const ctx = { request_id: requestId };
+      if (headerAid || cookieAid)
+        ctx.anonymous_id = headerAid ?? cookieAid;
+      if (traceId)
+        ctx.trace_id = traceId;
+      const ip = req.headers.get("x-forwarded-for")?.split(",")[0]?.trim();
+      if (ip)
+        ctx.ip = ip;
+      const ua = req.headers.get("user-agent") ?? undefined;
+      if (ua)
+        ctx.user_agent = ua;
+      try {
+        ctx.domain = new URL(req.url).host;
+      } catch {}
+      return await runWithContext(ctx, async () => handler(req, ctx));
+    };
+  };
+}
+function readCookie(cookieHeader, name) {
+  if (!cookieHeader)
+    return;
+  for (const part of cookieHeader.split(";")) {
+    const [k, v] = part.trim().split("=", 2);
+    if (k === name)
+      return v;
+  }
+  return;
+}
+export {
+  createNextHandler
+};

package/dist/queue.d.ts

@@ -0,0 +1,20 @@
+import type { FlushResult, OutgoingEvent, ResolvedConfig } from './types.ts';
+export declare class EventQueue {
+    private readonly config;
+    private readonly buffer;
+    private timer;
+    private flushing;
+    private droppedTotal;
+    private closed;
+    constructor(config: ResolvedConfig);
+    enqueue(event: OutgoingEvent): {
+        queued: boolean;
+        dropped: number;
+    };
+    size(): number;
+    private scheduleFlush;
+    flush(): Promise<FlushResult>;
+    /** Graceful shutdown — flush remaining + cancel timer + max 10s timeout. */
+    drain(timeoutMs?: number): Promise<FlushResult>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7E,qBAAa,UAAU;IAOT,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEM,MAAM,EAAE,cAAc;IAEnD,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAuBnE,IAAI,IAAI,MAAM;IAId,OAAO,CAAC,aAAa;IAUf,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IA6BnC,4EAA4E;IACtE,KAAK,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAwBtD"}

package/dist/track.d.ts

@@ -0,0 +1,10 @@
+import type { EventClass, OutgoingEvent, ResolvedConfig, ServerContext } from './types.ts';
+export interface BuildEventInput {
+    config: ResolvedConfig;
+    eventKey: string;
+    eventType?: EventClass;
+    properties?: Record<string, unknown>;
+    explicitContext?: ServerContext;
+}
+export declare function buildEvent(input: BuildEventInput): OutgoingEvent;
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU3F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CA8BhE"}

package/dist/transport.d.ts

@@ -0,0 +1,16 @@
+import type { OutgoingEvent, OutgoingIdentify, ResolvedConfig } from './types.ts';
+interface PostInput {
+    path: '/v1/ingest/event' | '/v1/ingest/batch' | '/v1/ingest/identify';
+    body: unknown;
+}
+interface PostResult {
+    ok: boolean;
+    status: number;
+    body: unknown;
+}
+/** Internal POST with retry. testMode'da SADECE log + skip transport (core kontrol eder). */
+export declare function postWithRetry(config: ResolvedConfig, input: PostInput): Promise<PostResult>;
+export declare function sendBatch(config: ResolvedConfig, events: OutgoingEvent[]): Promise<void>;
+export declare function sendIdentify(config: ResolvedConfig, payload: OutgoingIdentify): Promise<PostResult>;
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgBlF,UAAU,SAAS;IACjB,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;IACtE,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,6FAA6F;AAC7F,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CjG;AAUD,wBAAsB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAOrB"}

package/dist/types.d.ts

@@ -1,46 +1,132 @@
-/**
- * Node SDK public types.
- *
- * Canonical event shapes (Envelope, ServerEvent, EventTier, EventSource,
- * ConsentLevel, createEnvelope, normalizeLegacy, parseEnvelope) are re-exported
- * from @gurulu/shared-core — single source of truth per W1.2.
- *
- * The only node-sdk-specific addition is the transport config
- * (GuruluClientConfig) which wraps the shared ServerEvent with the knobs
- * needed to actually ship events to the ingest endpoint.
- *
- * Related docs: PHASE-10-ROADMAP.md §W1.2, §W4.2
- */
-import type { ServerEvent } from '@gurulu/shared-core';
-export * from '@gurulu/shared-core';
-/**
- * Dead-letter callback fired when a batch is permanently dropped (either
- * because all retries failed against a 5xx/network error, or because the
- * server replied 4xx).
- */
-export type DeadLetterCallback = (batch: ServerEvent[], reason: {
-    kind: 'client_error' | 'network_error' | 'server_error';
-    status?: number;
-    message: string;
-}) => void;
-export type ErrorCallback = (err: Error) => void;
-export interface GuruluClientConfig {
-    siteId: string;
-    apiKey: string;
+/** K17 — 4-kategori event-level consent snapshot. */
+export interface ServerConsentSnapshot {
+    analytics: boolean;
+    marketing: boolean;
+    functional: boolean;
+    personalization: boolean;
+    captured_at?: string;
+    source?: 'banner' | 'settings' | 'api' | 'sdk' | 'webhook';
+    granular_categories?: Record<string, boolean>;
+}
+/** K16 producer enum (server SDK + webhook iki kanal). */
+export type ServerProducer = 'sdk_server' | 'webhook';
+/** Gurulu native event_type enum (K14 3-sınıf). */
+export type EventClass = 'interaction' | 'intent' | 'outcome';
+/** Request-scope context (AsyncLocalStorage + manuel set). */
+export interface ServerContext {
+    /** Browser cookie'den header X-Gurulu-Anonymous-Id ile gelir. */
+    anonymous_id?: string;
+    person_id?: string;
+    session_id?: string;
+    /** request_id + trace_id auto-populated middleware tarafından. */
+    request_id?: string;
+    trace_id?: string;
+    /** Outcome event'ler için source preservation (UTM + click ID + referrer). */
+    source_context?: {
+        utm_source?: string;
+        utm_medium?: string;
+        utm_campaign?: string;
+        utm_term?: string;
+        utm_content?: string;
+        gclid?: string;
+        fbclid?: string;
+        ttclid?: string;
+        li_fat_id?: string;
+        referrer?: string;
+    };
+    ip?: string;
+    user_agent?: string;
+    domain?: string;
+    consent_state?: ServerConsentSnapshot;
+}
+/** Identify trait dictionary — email/phone hash'lenir, diğerleri raw. */
+export interface IdentifyTraits {
+    email?: string;
+    phone?: string;
+    name?: string;
+    [key: string]: unknown;
+}
+/** Outgoing single event — queue + transport şeması. */
+export interface OutgoingEvent {
+    anonymous_id: string;
+    person_id?: string;
+    session_id?: string;
+    event_id?: string;
+    event_key: string;
+    event_type: EventClass;
+    occurred_at: string;
+    producer: ServerProducer;
+    producer_version?: string;
+    properties?: Record<string, unknown>;
+    context?: {
+        url?: string;
+        referrer?: string;
+        user_agent?: string;
+        ip?: string;
+        domain?: string;
+        utm?: NonNullable<ServerContext['source_context']>;
+        request_id?: string;
+        trace_id?: string;
+    };
+    consent_state?: ServerConsentSnapshot;
+}
+/** Identify payload (M9 /v1/ingest/identify şemasıyla uyumlu). */
+export interface OutgoingIdentify {
+    workspace_id?: string;
+    anonymous_id: string;
+    external_user_id?: string;
+    email?: string;
+    phone?: string;
+    traits?: Record<string, unknown>;
+    context?: {
+        domain?: string;
+        consent_state?: ServerConsentSnapshot;
+    };
+}
+export interface ServerSDKConfig {
+    /** sk_xxx (secret key) — pk_xxx kabul edilmez. */
+    workspaceKey: string;
     endpoint?: string;
-    /** Periodic flush interval in ms. Default 5000. */
-    flushInterval?: number;
-    /** Max events per batch. Auto-flushes when queue reaches this size. Default 50. */
-    batchSize?: number;
-    /** Per-request HTTP timeout in ms. Default 10000. */
-    timeout?: number;
-    /** Fired on every transport error (retryable or not). */
-    onError?: ErrorCallback;
-    /** Fired when a batch is permanently dropped. */
-    onDeadLetter?: DeadLetterCallback;
-    /** Inject fetch for testing (defaults to globalThis.fetch). */
+    flushIntervalMs?: number;
+    maxBatchSize?: number;
+    maxQueueSize?: number;
+    retryMaxAttempts?: number;
+    retryBackoffBaseMs?: number;
+    /** true → console.log JSON, HTTP gönderim atlanır (CI / dev). */
+    testMode?: boolean;
+    defaultConsent?: ServerConsentSnapshot;
+    /** Custom fetch (test injection veya undici override). */
     fetchImpl?: typeof fetch;
-    /** Suppress automatic process.on('beforeExit'/'SIGTERM') hooks. */
-    disableAutoShutdown?: boolean;
-    debug?: boolean;
 }
+export interface ResolvedConfig {
+    workspaceKey: string;
+    endpoint: string;
+    flushIntervalMs: number;
+    maxBatchSize: number;
+    maxQueueSize: number;
+    retryMaxAttempts: number;
+    retryBackoffBaseMs: number;
+    testMode: boolean;
+    defaultConsent: ServerConsentSnapshot;
+    fetchImpl: typeof fetch;
+}
+export interface IdentifyResult {
+    ok: boolean;
+    status: number;
+    body?: unknown;
+}
+export interface TrackResult {
+    queued: boolean;
+    queueSize: number;
+}
+export interface FlushResult {
+    attempted: number;
+    succeeded: number;
+    dropped: number;
+}
+export interface HandleResult {
+    events_emitted: number;
+    vendor: 'stripe' | 'shopify' | 'lemonsqueezy' | 'custom';
+    event_keys: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/webhooks/custom.d.ts

@@ -0,0 +1,30 @@
+import type { HandleResult, OutgoingEvent, ResolvedConfig } from '../types.ts';
+export interface CustomHandleReq {
+    body: string;
+    headers: Record<string, string | string[] | undefined>;
+}
+export interface CustomMapResult {
+    event_key: string;
+    event_id?: string;
+    anonymous_id?: string;
+    person_id?: string;
+    properties?: Record<string, unknown>;
+    occurred_at?: string;
+}
+export interface CreateCustomWebhookOptions {
+    signatureHeader: string;
+    secret: string;
+    /**
+     * Signature verifier — default sha256-hex HMAC.
+     * Custom override için: `(rawBody, signature, secret) => boolean`.
+     */
+    verifySignature?: (rawBody: string, signature: string, secret: string) => boolean;
+    /** Payload → Gurulu event mapping (customer logic). */
+    mapPayload: (payload: unknown) => CustomMapResult | CustomMapResult[];
+}
+export interface CustomWebhookHandler {
+    verify: (rawBody: string, signature: string) => boolean;
+    handle: (req: CustomHandleReq) => Promise<HandleResult>;
+}
+export declare function createCustomWebhook(config: ResolvedConfig, enqueue: (event: OutgoingEvent) => void, options: CreateCustomWebhookOptions): CustomWebhookHandler;
+//# sourceMappingURL=custom.d.ts.map

package/dist/webhooks/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/webhooks/custom.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EAEf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAClF,uDAAuD;IACvD,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,eAAe,GAAG,eAAe,EAAE,CAAC;CACvE;AAqCD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACzD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,OAAO,EAAE,0BAA0B,GAClC,oBAAoB,CA6BtB"}