@nibgate/sdk 0.1.0

package/src/testing.d.ts

@@ -0,0 +1,23 @@
+import type { NibgatePaymentInput, NibgateServerOptions, NibgateServerResource } from './server.js';
+
+export declare function emitTestEvents(resource: NibgateServerResource | string, options?: NibgateServerOptions & {
+  siteId?: string;
+  token?: string;
+  apiBaseUrl?: string;
+  visitorId?: string;
+  sessionId?: string;
+  source?: string;
+  payload?: Record<string, unknown>;
+  payment?: NibgatePaymentInput;
+  paymentProvider?: string;
+  paymentId?: string;
+  rating?: number | false;
+  walletAddress?: string;
+  payer?: string;
+  ratingSignature?: string;
+  signature?: string;
+  reviewHash?: string;
+  txHash?: string;
+  proofType?: string;
+  proof?: string;
+}): Promise<Record<string, unknown>>;

package/src/testing.js

@@ -0,0 +1,56 @@
+import { emitHubEvent, normalizeResource } from './server.js';
+
+export async function emitTestEvents(resourceInput, options = {}) {
+  const resource = normalizeResource(resourceInput);
+  const payment = {
+    paymentProvider: options.paymentProvider || 'nibgate-package-test',
+    paymentId: options.paymentId || `nibgate_test_${Date.now()}`,
+    amount: Number(resource.price || 0),
+    revenue: Number(resource.price || 0),
+    currency: resource.currency || 'USDC',
+    ...(options.payment || {})
+  };
+  const shared = {
+    ...options,
+    payload: {
+      source: options.source || 'nibgate-package-test',
+      ...(options.payload || {})
+    }
+  };
+
+  const events = [];
+  events.push(await emitHubEvent('content_registered', resource, shared));
+  events.push(await emitHubEvent('resource_view', resource, shared));
+  events.push(await emitHubEvent('unlock_started', resource, {
+    ...shared,
+    payload: { ...(shared.payload || {}), paymentProvider: payment.paymentProvider }
+  }));
+  events.push(await emitHubEvent('payment_completed', resource, {
+    ...shared,
+    payload: { ...(shared.payload || {}), ...payment }
+  }));
+  events.push(await emitHubEvent('unlock_completed', resource, {
+    ...shared,
+    payload: { ...(shared.payload || {}), ...payment }
+  }));
+
+  if (options.rating && (options.ratingSignature || options.signature || options.txHash)) {
+    events.push(await emitHubEvent('content_rating', resource, {
+      ...shared,
+      payload: {
+        ...(shared.payload || {}),
+        ...payment,
+        walletAddress: options.walletAddress || options.payer || payment.payer || '',
+        rating: options.rating || 4.5,
+        ratingMessage: options.ratingMessage || '',
+        ratingSignature: options.ratingSignature || options.signature || '',
+        reviewHash: options.reviewHash || '',
+        txHash: options.txHash || '',
+        proofType: options.proofType || (options.txHash ? 'onchain_pending' : 'signed'),
+        proof: options.proof || payment.paymentId
+      }
+    }));
+  }
+
+  return { success: true, events, payment };
+}

package/src/tracking.d.ts

@@ -0,0 +1,18 @@
+import type { NibgatePageOptions, NibgateResource } from './index.js';
+
+export interface NibgateTrackingGate {
+  resource: NibgateResource;
+  content(extra?: Record<string, unknown>): void;
+  view(extra?: Record<string, unknown>): void;
+  track(eventName: string, payload?: Record<string, unknown>): void;
+}
+
+export declare function createTrackingGate(resource: NibgateResource | string): NibgateTrackingGate;
+export declare function trackResourcePage(resource: NibgateResource | string, options?: NibgatePageOptions): NibgateTrackingGate;
+export declare function normalizeResource(resource?: NibgateResource | string): NibgateResource;
+export declare function validateResourceMetadata(resource?: NibgateResource | string, options?: Record<string, unknown>): {
+  ok: boolean;
+  score: number;
+  warnings: string[];
+  errors: string[];
+};

package/src/tracking.js

@@ -0,0 +1 @@
+export * from './browser/tracking.js';