@ned-ai/sdk 1.0.0

package/README.md

@@ -0,0 +1,94 @@
+# @ned-ai/sdk
+
+TypeScript SDK for the [Ned AI](https://meetned.com) API. Access your Shopify store analytics, profitability, customer segments, and marketing metrics programmatically.
+
+## Install
+
+```bash
+npm install @ned-ai/sdk
+```
+
+## Quick Start
+
+```typescript
+import { NedClient } from '@ned-ai/sdk';
+
+const ned = new NedClient({ apiKey: process.env.NED_API_KEY! });
+
+// Get today's sales
+const sales = await ned.analytics.getSalesContext({ period: 'today' });
+console.log(sales.data.metrics.revenue);
+```
+
+## API Reference
+
+### Analytics
+
+```typescript
+// Sales analytics with period comparison
+ned.analytics.getSalesContext({ period: 'this_month', comparison: 'year_ago' })
+
+// Daily sales breakdown
+ned.analytics.getDailySales({ period: 'last_30_days' })
+
+// Revenue forecast (Growth+ tier)
+ned.analytics.getForecast(30)
+
+// Profitability summary
+ned.analytics.getProfitability({ period: 'this_month', view_type: 'summary' })
+
+// Product-level profitability
+ned.analytics.getProductProfitability({ sort_by: 'profit', limit: 10 })
+```
+
+### Customers
+
+```typescript
+// Customer overview
+ned.customers.getSummary()
+
+// Customer segments by profit or activity tier
+ned.customers.getSegments({ segment: 'profit_tier', limit: 10 })
+
+// At-risk high-value customers
+ned.customers.getAtRisk({ limit: 20 })
+```
+
+### Marketing
+
+```typescript
+// Marketing efficiency (MER, CAC, ROAS)
+ned.marketing.getMetrics({ period: 'this_month', view_type: 'summary' })
+
+// Ad performance across platforms
+ned.marketing.getAds({ period: 'last_30_days', platform: 'meta' })
+```
+
+### Period Options
+
+`today` | `yesterday` | `this_week` | `last_week` | `this_month` | `last_month` | `last_7_days` | `last_30_days` | `mtd` | `ytd`
+
+## Error Handling
+
+```typescript
+import { NedApiError, NedRateLimitError } from '@ned-ai/sdk';
+
+try {
+  const sales = await ned.analytics.getSalesContext();
+} catch (err) {
+  if (err instanceof NedRateLimitError) {
+    console.log(`Rate limited. Retry after ${err.retryAfter}s`);
+  } else if (err instanceof NedApiError) {
+    console.log(`API error ${err.statusCode}: ${err.message}`);
+  }
+}
+```
+
+## Requirements
+
+- Node.js 18+
+- A Ned API key (get one at [meetned.com](https://meetned.com))
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,60 @@
+/**
+ * NedClient - Main SDK client for the Ned AI API
+ *
+ * Usage:
+ *   import { NedClient } from '@ned-ai/sdk';
+ *
+ *   const ned = new NedClient({ apiKey: process.env.NED_API_KEY });
+ *   const sales = await ned.analytics.getSalesContext({ period: 'today' });
+ */
+import { AnalyticsResource } from './resources/analytics.js';
+import { CustomersResource } from './resources/customers.js';
+import { MarketingResource } from './resources/marketing.js';
+export interface NedClientOptions {
+    /**
+     * Your Ned API key (starts with ned_live_)
+     */
+    apiKey: string;
+    /**
+     * Base URL for the Ned API
+     * @default 'https://api.meetned.com'
+     */
+    baseUrl?: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000
+     */
+    timeout?: number;
+}
+export interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: unknown;
+    params?: Record<string, string | number | boolean | undefined>;
+}
+/**
+ * NedClient - TypeScript SDK for the Ned AI API
+ */
+export declare class NedClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(options: NedClientOptions);
+    /**
+     * Make an authenticated request to the Ned API
+     * @internal
+     */
+    request<T>(endpoint: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Analytics resource for sales, profitability, and forecast data
+     */
+    get analytics(): AnalyticsResource;
+    /**
+     * Customers resource for segments, summaries, and at-risk analysis
+     */
+    get customers(): CustomersResource;
+    /**
+     * Marketing resource for marketing metrics and ad performance
+     */
+    get marketing(): MarketingResource;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,gBAAgB;IAcrC;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IA0D5E;;OAEG;IACH,IAAI,SAAS,IAAI,iBAAiB,CAEjC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,iBAAiB,CAEjC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,iBAAiB,CAEjC;CACF"}

package/dist/client.js

@@ -0,0 +1,100 @@
+/**
+ * NedClient - Main SDK client for the Ned AI API
+ *
+ * Usage:
+ *   import { NedClient } from '@ned-ai/sdk';
+ *
+ *   const ned = new NedClient({ apiKey: process.env.NED_API_KEY });
+ *   const sales = await ned.analytics.getSalesContext({ period: 'today' });
+ */
+import { AnalyticsResource } from './resources/analytics.js';
+import { CustomersResource } from './resources/customers.js';
+import { MarketingResource } from './resources/marketing.js';
+import { NedApiError } from './errors.js';
+/**
+ * NedClient - TypeScript SDK for the Ned AI API
+ */
+export class NedClient {
+    apiKey;
+    baseUrl;
+    timeout;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('API key is required');
+        }
+        if (!options.apiKey.startsWith('ned_live_')) {
+            throw new Error('Invalid API key format. Keys should start with ned_live_');
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl || 'https://api.meetned.com';
+        this.timeout = options.timeout || 30000;
+    }
+    /**
+     * Make an authenticated request to the Ned API
+     * @internal
+     */
+    async request(endpoint, options = {}) {
+        const { method = 'GET', body, params } = options;
+        // Build URL with query params
+        const url = new URL(`${this.baseUrl}/api/v1${endpoint}`);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            });
+        }
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method,
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorBody = await response.json().catch(() => ({}));
+                throw new NedApiError(errorBody.message || `API error: ${response.status}`, response.status, errorBody.error);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof NedApiError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    throw new Error(`Request timeout after ${this.timeout}ms`);
+                }
+                throw error;
+            }
+            throw new Error('Unknown error occurred');
+        }
+    }
+    /**
+     * Analytics resource for sales, profitability, and forecast data
+     */
+    get analytics() {
+        return new AnalyticsResource(this);
+    }
+    /**
+     * Customers resource for segments, summaries, and at-risk analysis
+     */
+    get customers() {
+        return new CustomersResource(this);
+    }
+    /**
+     * Marketing resource for marketing metrics and ad performance
+     */
+    get marketing() {
+        return new MarketingResource(this);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Error classes for the Ned SDK
+ */
+/**
+ * Base error class for Ned API errors
+ */
+export declare class NedApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode?: string;
+    constructor(message: string, statusCode: number, errorCode?: string);
+}
+/**
+ * Error class for rate limit errors (429)
+ */
+export declare class NedRateLimitError extends NedApiError {
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number);
+}
+/**
+ * Error class for authentication errors (401)
+ */
+export declare class NedAuthError extends NedApiError {
+    constructor(message?: string);
+}
+/**
+ * Error class for forbidden access (403)
+ */
+export declare class NedForbiddenError extends NedApiError {
+    constructor(message?: string);
+}
+/**
+ * Error class for validation errors (400)
+ */
+export declare class NedValidationError extends NedApiError {
+    readonly parameter?: string;
+    constructor(message: string, parameter?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAMpE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKjD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,GAAE,MAAqC;CAI3D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,GAAE,MAAgE;CAItF;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKhD"}

package/dist/errors.js

@@ -0,0 +1,57 @@
+/**
+ * Error classes for the Ned SDK
+ */
+/**
+ * Base error class for Ned API errors
+ */
+export class NedApiError extends Error {
+    statusCode;
+    errorCode;
+    constructor(message, statusCode, errorCode) {
+        super(message);
+        this.name = 'NedApiError';
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+    }
+}
+/**
+ * Error class for rate limit errors (429)
+ */
+export class NedRateLimitError extends NedApiError {
+    retryAfter;
+    constructor(message, retryAfter) {
+        super(message, 429, 'rate_limit_exceeded');
+        this.name = 'NedRateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Error class for authentication errors (401)
+ */
+export class NedAuthError extends NedApiError {
+    constructor(message = 'Invalid or expired API key') {
+        super(message, 401, 'unauthorized');
+        this.name = 'NedAuthError';
+    }
+}
+/**
+ * Error class for forbidden access (403)
+ */
+export class NedForbiddenError extends NedApiError {
+    constructor(message = 'Access denied - upgrade your plan to use this feature') {
+        super(message, 403, 'forbidden');
+        this.name = 'NedForbiddenError';
+    }
+}
+/**
+ * Error class for validation errors (400)
+ */
+export class NedValidationError extends NedApiError {
+    parameter;
+    constructor(message, parameter) {
+        super(message, 400, 'invalid_parameter');
+        this.name = 'NedValidationError';
+        this.parameter = parameter;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,UAAU,CAAS;IACnB,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,UAAkB,EAAE,SAAkB;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IACvC,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,YAAY,UAAkB,4BAA4B;QACxD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YAAY,UAAkB,uDAAuD;QACnF,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACxC,SAAS,CAAU;IAE5B,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @ned-ai/sdk - TypeScript SDK for the Ned AI API
+ *
+ * Usage:
+ *   import { NedClient } from '@ned-ai/sdk';
+ *
+ *   const ned = new NedClient({ apiKey: process.env.NED_API_KEY });
+ *   const sales = await ned.analytics.getSalesContext({ period: 'today' });
+ */
+export { NedClient } from './client.js';
+export type { NedClientOptions, RequestOptions } from './client.js';
+export { AnalyticsResource } from './resources/analytics.js';
+export type { Period, Comparison, GetSalesContextParams, GetDailySalesParams, GetProfitabilityParams, GetProductProfitabilityParams, SalesContextResponse, DailySalesResponse, ForecastResponse, ProfitabilityResponse, ProductProfitabilityResponse, } from './resources/analytics.js';
+export { CustomersResource } from './resources/customers.js';
+export type { GetCustomerSegmentsParams, GetAtRiskParams, CustomerSummaryResponse, CustomerSegmentsResponse, AtRiskCustomersResponse, } from './resources/customers.js';
+export { MarketingResource } from './resources/marketing.js';
+export type { GetMarketingMetricsParams, GetAdsParams, MarketingMetricsResponse, AdsPerformanceResponse, } from './resources/marketing.js';
+export { NedApiError, NedRateLimitError, NedAuthError, NedForbiddenError, NedValidationError, } from './errors.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;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,MAAM,EACN,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,yBAAyB,EACzB,YAAY,EACZ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @ned-ai/sdk - TypeScript SDK for the Ned AI API
+ *
+ * Usage:
+ *   import { NedClient } from '@ned-ai/sdk';
+ *
+ *   const ned = new NedClient({ apiKey: process.env.NED_API_KEY });
+ *   const sales = await ned.analytics.getSalesContext({ period: 'today' });
+ */
+export { NedClient } from './client.js';
+// Resource classes and types
+export { AnalyticsResource } from './resources/analytics.js';
+export { CustomersResource } from './resources/customers.js';
+export { MarketingResource } from './resources/marketing.js';
+// Error classes
+export { NedApiError, NedRateLimitError, NedAuthError, NedForbiddenError, NedValidationError, } from './errors.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;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAe7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAS7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQ7D,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/resources/analytics.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Analytics Resource - Sales, Profitability, and Forecast endpoints
+ */
+import type { NedClient } from '../client.js';
+/**
+ * Period options for analytics queries
+ */
+export type Period = 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'last_7_days' | 'last_30_days' | 'mtd' | 'ytd';
+/**
+ * Comparison options
+ */
+export type Comparison = 'year_ago' | 'prior_period';
+/**
+ * Parameters for getSalesContext
+ */
+export interface GetSalesContextParams {
+    period?: Period;
+    comparison?: Comparison;
+    timezone?: string;
+}
+/**
+ * Parameters for getProfitability
+ */
+export interface GetProfitabilityParams {
+    period?: Period;
+    view_type?: 'summary' | 'daily';
+}
+/**
+ * Parameters for getProductProfitability
+ */
+export interface GetProductProfitabilityParams {
+    period?: Period;
+    sort_by?: 'revenue' | 'profit' | 'margin' | 'units';
+    limit?: number;
+}
+/**
+ * Sales analytics response
+ */
+export interface SalesContextResponse {
+    data: {
+        period: string;
+        metrics: {
+            revenue: number;
+            orders: number;
+            aov: number;
+            new_customers: number;
+            returning_customers: number;
+            unique_customers: number;
+        };
+        profitability: Record<string, unknown> | null;
+        customer_economics: Record<string, unknown> | null;
+        marketing: Record<string, unknown> | null;
+        comparisons: Record<string, unknown>;
+        insights: unknown[];
+    };
+    metadata: {
+        source: string;
+        period: string;
+        timezone: string;
+        comparison: string;
+        data_freshness: string;
+        requested_at: string;
+    };
+}
+/**
+ * Forecast response
+ */
+export interface ForecastResponse {
+    data: {
+        forecasts: unknown[];
+        summary: Record<string, unknown>;
+    };
+    metadata: {
+        method: string;
+        historical_days: number;
+        trend_direction: string;
+        confidence_level: number;
+        timezone: string;
+        requested_at: string;
+    };
+}
+/**
+ * Profitability response
+ */
+export interface ProfitabilityResponse {
+    data: {
+        view_type: string;
+        date_range: Record<string, unknown>;
+        days_analyzed: number;
+        summary: Record<string, unknown> | null;
+        daily_data: unknown[] | null;
+        cogs_coverage: Record<string, unknown> | null;
+    };
+    metadata: {
+        source: string;
+        period: string;
+        view_type: string;
+        requested_at: string;
+    };
+}
+/**
+ * Product profitability response
+ */
+export interface ProductProfitabilityResponse {
+    data: {
+        date_range: Record<string, unknown>;
+        products_count: number;
+        products: unknown[];
+    };
+    metadata: {
+        source: string;
+        period: string;
+        sort_by: string;
+        limit: number;
+        requested_at: string;
+    };
+}
+/**
+ * Parameters for getDailySales
+ */
+export interface GetDailySalesParams {
+    period?: Period;
+    timezone?: string;
+}
+/**
+ * Daily sales response
+ */
+export interface DailySalesResponse {
+    data: {
+        period: {
+            start_date: string;
+            end_date: string;
+            days_count: number;
+        };
+        days: Array<{
+            date: string;
+            revenue: number;
+            orders: number;
+            aov: number;
+            new_customers: number;
+            returning_customers: number;
+            net_profit: number;
+            margin_pct: number;
+        }>;
+        totals: {
+            revenue: number;
+            orders: number;
+            new_customers: number;
+            returning_customers: number;
+            net_profit: number;
+            aov: number;
+        };
+    };
+    metadata: {
+        source: string;
+        period: string;
+        timezone: string;
+        requested_at: string;
+    };
+}
+/**
+ * Analytics resource for sales, profitability, and forecast data
+ */
+export declare class AnalyticsResource {
+    private client;
+    constructor(client: NedClient);
+    /**
+     * Get sales context/analytics
+     *
+     * @example
+     * const sales = await ned.analytics.getSalesContext({ period: 'today' });
+     * console.log(sales.data.metrics.revenue);
+     */
+    getSalesContext(params?: GetSalesContextParams): Promise<SalesContextResponse>;
+    /**
+     * Get daily sales breakdown
+     *
+     * @example
+     * const daily = await ned.analytics.getDailySales({ period: 'last_30_days' });
+     * console.log(daily.data.days);
+     */
+    getDailySales(params?: GetDailySalesParams): Promise<DailySalesResponse>;
+    /**
+     * Get revenue forecast (Growth+ tier required)
+     *
+     * @example
+     * const forecast = await ned.analytics.getForecast(30);
+     * console.log(forecast.data.forecasts[0].predicted_revenue);
+     */
+    getForecast(days?: number): Promise<ForecastResponse>;
+    /**
+     * Get profitability metrics
+     *
+     * @example
+     * const profit = await ned.analytics.getProfitability({ period: 'this_month' });
+     * console.log(profit.data.metrics.gross_margin);
+     */
+    getProfitability(params?: GetProfitabilityParams): Promise<ProfitabilityResponse>;
+    /**
+     * Get product-level profitability
+     *
+     * @example
+     * const products = await ned.analytics.getProductProfitability({
+     *   period: 'last_30_days',
+     *   sort_by: 'profit',
+     *   limit: 10
+     * });
+     * console.log(products.data.products);
+     */
+    getProductProfitability(params?: GetProductProfitabilityParams): Promise<ProductProfitabilityResponse>;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/resources/analytics.d.ts.map

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

package/dist/resources/analytics.js

@@ -0,0 +1,93 @@
+/**
+ * Analytics Resource - Sales, Profitability, and Forecast endpoints
+ */
+/**
+ * Analytics resource for sales, profitability, and forecast data
+ */
+export class AnalyticsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get sales context/analytics
+     *
+     * @example
+     * const sales = await ned.analytics.getSalesContext({ period: 'today' });
+     * console.log(sales.data.metrics.revenue);
+     */
+    async getSalesContext(params = {}) {
+        return this.client.request('/sales/analytics', {
+            params: {
+                period: params.period,
+                comparison: params.comparison,
+                timezone: params.timezone,
+            },
+        });
+    }
+    /**
+     * Get daily sales breakdown
+     *
+     * @example
+     * const daily = await ned.analytics.getDailySales({ period: 'last_30_days' });
+     * console.log(daily.data.days);
+     */
+    async getDailySales(params = {}) {
+        return this.client.request('/sales/daily', {
+            params: {
+                period: params.period,
+                timezone: params.timezone,
+            },
+        });
+    }
+    /**
+     * Get revenue forecast (Growth+ tier required)
+     *
+     * @example
+     * const forecast = await ned.analytics.getForecast(30);
+     * console.log(forecast.data.forecasts[0].predicted_revenue);
+     */
+    async getForecast(days = 30) {
+        return this.client.request('/sales/forecast', {
+            params: {
+                days,
+            },
+        });
+    }
+    /**
+     * Get profitability metrics
+     *
+     * @example
+     * const profit = await ned.analytics.getProfitability({ period: 'this_month' });
+     * console.log(profit.data.metrics.gross_margin);
+     */
+    async getProfitability(params = {}) {
+        return this.client.request('/profitability/summary', {
+            params: {
+                period: params.period,
+                view_type: params.view_type,
+            },
+        });
+    }
+    /**
+     * Get product-level profitability
+     *
+     * @example
+     * const products = await ned.analytics.getProductProfitability({
+     *   period: 'last_30_days',
+     *   sort_by: 'profit',
+     *   limit: 10
+     * });
+     * console.log(products.data.products);
+     */
+    async getProductProfitability(params = {}) {
+        return this.client.request('/profitability/products', {
+            params: {
+                period: params.period,
+                sort_by: params.sort_by,
+                limit: params.limit,
+            },
+        });
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/resources/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/resources/analytics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqLH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEzC;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,SAAgC,EAAE;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAuB,kBAAkB,EAAE;YACnE,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,SAA8B,EAAE;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB,cAAc,EAAE;YAC7D,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAmB,iBAAiB,EAAE;YAC9D,MAAM,EAAE;gBACN,IAAI;aACL;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CAAC,SAAiC,EAAE;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB,wBAAwB,EAAE;YAC1E,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,uBAAuB,CAAC,SAAwC,EAAE;QACtE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA+B,yBAAyB,EAAE;YAClF,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/customers.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Customers Resource - Customer segments, summaries, and at-risk analysis
+ */
+import type { NedClient } from '../client.js';
+/**
+ * Parameters for getSegments
+ */
+export interface GetCustomerSegmentsParams {
+    segment?: 'profit_tier' | 'activity_tier' | 'both';
+    limit?: number;
+    min_orders?: number;
+}
+/**
+ * Parameters for getAtRisk
+ */
+export interface GetAtRiskParams {
+    limit?: number;
+}
+/**
+ * Customer summary response
+ */
+export interface CustomerSummaryResponse {
+    data: {
+        total_customers: number;
+        avg_customer_profit: number;
+        avg_customer_ltv: number;
+        profitable_customer_pct: number;
+        by_profit_tier: {
+            whale: number;
+            profitable: number;
+            marginal: number;
+            unprofitable: number;
+        };
+        by_activity_tier: {
+            active: number;
+            cooling: number;
+            at_risk: number;
+            churned: number;
+        };
+        top_profitable_customers: unknown[];
+        at_risk_whales: unknown[];
+    };
+    metadata: {
+        source: string;
+        requested_at: string;
+    };
+}
+/**
+ * Customer segments response
+ */
+export interface CustomerSegmentsResponse {
+    data: {
+        by_profit_tier?: Record<string, unknown[]>;
+        by_activity_tier?: Record<string, unknown[]>;
+    };
+    metadata: {
+        source: string;
+        segment: string;
+        limit: number;
+        min_orders: number;
+        requested_at: string;
+    };
+}
+/**
+ * At-risk customers response
+ */
+export interface AtRiskCustomersResponse {
+    data: {
+        customers: unknown[];
+        total_profit_at_risk: number;
+        customers_count: number;
+    };
+    metadata: {
+        source: string;
+        limit: number;
+        requested_at: string;
+    };
+}
+/**
+ * Customers resource for customer analytics and segmentation
+ */
+export declare class CustomersResource {
+    private client;
+    constructor(client: NedClient);
+    /**
+     * Get customer summary overview
+     *
+     * @example
+     * const summary = await ned.customers.getSummary();
+     * console.log(summary.data.total_customers);
+     */
+    getSummary(): Promise<CustomerSummaryResponse>;
+    /**
+     * Get customer segments breakdown
+     *
+     * @example
+     * const segments = await ned.customers.getSegments({ segment: 'profit_tier', limit: 10 });
+     * console.log(segments.data.by_profit_tier);
+     */
+    getSegments(params?: GetCustomerSegmentsParams): Promise<CustomerSegmentsResponse>;
+    /**
+     * Get at-risk customers (high-value customers showing churn signals)
+     *
+     * @example
+     * const atRisk = await ned.customers.getAtRisk({ limit: 20 });
+     * console.log(atRisk.data.total_profit_at_risk);
+     */
+    getAtRisk(params?: GetAtRiskParams): Promise<AtRiskCustomersResponse>;
+}
+//# sourceMappingURL=customers.d.ts.map

package/dist/resources/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/resources/customers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,MAAM,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE;QACJ,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,gBAAgB,EAAE,MAAM,CAAC;QACzB,uBAAuB,EAAE,MAAM,CAAC;QAChC,cAAc,EAAE;YACd,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC;YACjB,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,gBAAgB,EAAE;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,wBAAwB,EAAE,OAAO,EAAE,CAAC;QACpC,cAAc,EAAE,OAAO,EAAE,CAAC;KAC3B,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE;QACJ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;KAC9C,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE;QACJ,SAAS,EAAE,OAAO,EAAE,CAAC;QACrB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAErC;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAIpD;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,GAAE,yBAA8B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAU5F;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAOhF"}

package/dist/resources/customers.js

@@ -0,0 +1,53 @@
+/**
+ * Customers Resource - Customer segments, summaries, and at-risk analysis
+ */
+/**
+ * Customers resource for customer analytics and segmentation
+ */
+export class CustomersResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get customer summary overview
+     *
+     * @example
+     * const summary = await ned.customers.getSummary();
+     * console.log(summary.data.total_customers);
+     */
+    async getSummary() {
+        return this.client.request('/customers/summary');
+    }
+    /**
+     * Get customer segments breakdown
+     *
+     * @example
+     * const segments = await ned.customers.getSegments({ segment: 'profit_tier', limit: 10 });
+     * console.log(segments.data.by_profit_tier);
+     */
+    async getSegments(params = {}) {
+        return this.client.request('/customers/segments', {
+            params: {
+                segment: params.segment,
+                limit: params.limit,
+                min_orders: params.min_orders,
+            },
+        });
+    }
+    /**
+     * Get at-risk customers (high-value customers showing churn signals)
+     *
+     * @example
+     * const atRisk = await ned.customers.getAtRisk({ limit: 20 });
+     * console.log(atRisk.data.total_profit_at_risk);
+     */
+    async getAtRisk(params = {}) {
+        return this.client.request('/customers/at-risk', {
+            params: {
+                limit: params.limit,
+            },
+        });
+    }
+}
+//# sourceMappingURL=customers.js.map

package/dist/resources/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../../src/resources/customers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmFH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEzC;;;;;;OAMG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B,oBAAoB,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,SAAoC,EAAE;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA2B,qBAAqB,EAAE;YAC1E,MAAM,EAAE;gBACN,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,SAA0B,EAAE;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B,oBAAoB,EAAE;YACxE,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/marketing.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Marketing Resource - Marketing metrics and ad performance
+ */
+import type { NedClient } from '../client.js';
+import type { Period } from './analytics.js';
+/**
+ * Parameters for getMetrics
+ */
+export interface GetMarketingMetricsParams {
+    period?: Period;
+    view_type?: 'summary' | 'daily' | 'weekly' | 'monthly';
+    limit?: number;
+}
+/**
+ * Parameters for getAds
+ */
+export interface GetAdsParams {
+    period?: Period;
+    platform?: 'meta' | 'google';
+    limit?: number;
+}
+/**
+ * Marketing metrics response
+ */
+export interface MarketingMetricsResponse {
+    data: {
+        view_type: string;
+        period: string;
+        count: number | null;
+        metrics: Record<string, unknown>;
+        comparison: Record<string, unknown> | null;
+    };
+    metadata: {
+        source: string;
+        period: string;
+        view_type: string;
+        requested_at: string;
+    };
+}
+/**
+ * Ads performance response
+ */
+export interface AdsPerformanceResponse {
+    data: {
+        ads_count: number;
+        ads: Array<{
+            platform: string;
+            ad_id: string;
+            name: string;
+            campaign_id: string | null;
+            ad_set_id: string | null;
+            status: string;
+            impressions: number;
+            clicks: number;
+            spend: string;
+            conversions: number;
+            conversion_value: string;
+            ctr: string | null;
+            cpc: string | null;
+            roas: string | null;
+        }>;
+        connected_platforms: {
+            meta: Array<{
+                id: string;
+                account_id: string;
+                name: string;
+            }>;
+            google: Array<{
+                id: string;
+                customer_id: string;
+                name: string;
+            }>;
+        };
+    };
+    metadata: {
+        period: string;
+        platform_filter: string;
+        date_range: {
+            start: string;
+            end: string;
+        };
+        limit: number;
+        requested_at: string;
+    };
+}
+/**
+ * Marketing resource for marketing metrics and ad performance
+ */
+export declare class MarketingResource {
+    private client;
+    constructor(client: NedClient);
+    /**
+     * Get marketing efficiency metrics (MER, CAC, ROAS)
+     *
+     * @example
+     * const metrics = await ned.marketing.getMetrics({ period: 'this_month' });
+     * console.log(metrics.data.metrics);
+     */
+    getMetrics(params?: GetMarketingMetricsParams): Promise<MarketingMetricsResponse>;
+    /**
+     * Get ad performance data across connected platforms
+     *
+     * @example
+     * const ads = await ned.marketing.getAds({ period: 'last_30_days', platform: 'meta' });
+     * console.log(ads.data.ads);
+     */
+    getAds(params?: GetAdsParams): Promise<AdsPerformanceResponse>;
+}
+//# sourceMappingURL=marketing.d.ts.map

package/dist/resources/marketing.d.ts.map

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

package/dist/resources/marketing.js

@@ -0,0 +1,45 @@
+/**
+ * Marketing Resource - Marketing metrics and ad performance
+ */
+/**
+ * Marketing resource for marketing metrics and ad performance
+ */
+export class MarketingResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get marketing efficiency metrics (MER, CAC, ROAS)
+     *
+     * @example
+     * const metrics = await ned.marketing.getMetrics({ period: 'this_month' });
+     * console.log(metrics.data.metrics);
+     */
+    async getMetrics(params = {}) {
+        return this.client.request('/marketing/metrics', {
+            params: {
+                period: params.period,
+                view_type: params.view_type,
+                limit: params.limit,
+            },
+        });
+    }
+    /**
+     * Get ad performance data across connected platforms
+     *
+     * @example
+     * const ads = await ned.marketing.getAds({ period: 'last_30_days', platform: 'meta' });
+     * console.log(ads.data.ads);
+     */
+    async getAds(params = {}) {
+        return this.client.request('/marketing/ads', {
+            params: {
+                period: params.period,
+                platform: params.platform,
+                limit: params.limit,
+            },
+        });
+    }
+}
+//# sourceMappingURL=marketing.js.map

package/dist/resources/marketing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketing.js","sourceRoot":"","sources":["../../src/resources/marketing.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8EH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAEzC;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,SAAoC,EAAE;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA2B,oBAAoB,EAAE;YACzE,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,SAAuB,EAAE;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAyB,gBAAgB,EAAE;YACnE,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@ned-ai/sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for the Ned AI API",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ned",
+    "ai",
+    "sdk",
+    "shopify",
+    "analytics",
+    "api"
+  ],
+  "author": "Ned AI",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ned-ai/ned.git",
+    "directory": "packages/sdk"
+  }
+}