@safenest/sdk 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,228 @@
+import { SafeNestOptions, Usage, DetectBullyingInput, BullyingResult, DetectGroomingInput, GroomingResult, DetectUnsafeInput, UnsafeResult, AnalyzeInput, AnalyzeResult, ContextInput, AnalyzeEmotionsInput, EmotionsResult, GetActionPlanInput, ActionPlanResult, GenerateReportInput, ReportResult, PolicyConfig, PolicyConfigResponse } from './types/index.js';
+/**
+ * SafeNest - AI-powered child safety analysis
+ *
+ * @example
+ * ```typescript
+ * import { SafeNest } from '@safenest/sdk'
+ *
+ * const safenest = new SafeNest(process.env.SAFENEST_API_KEY)
+ *
+ * // Detect bullying
+ * const result = await safenest.detectBullying({
+ *   content: "You're not welcome here",
+ *   context: 'chat'
+ * })
+ *
+ * if (result.is_bullying) {
+ *   console.log('Severity:', result.severity)
+ *   console.log('Rationale:', result.rationale)
+ * }
+ *
+ * // Check usage
+ * console.log(safenest.usage) // { limit: 10000, used: 5234, remaining: 4766 }
+ * ```
+ */
+export declare class SafeNest {
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly retries;
+    private readonly retryDelay;
+    private _usage;
+    private _lastRequestId;
+    private _lastLatencyMs;
+    /**
+     * Create a new SafeNest client
+     *
+     * @param apiKey - Your SafeNest API key
+     * @param options - Optional configuration
+     *
+     * @example
+     * ```typescript
+     * // Simple usage
+     * const safenest = new SafeNest('your-api-key')
+     *
+     * // With options
+     * const safenest = new SafeNest('your-api-key', {
+     *   timeout: 10000
+     * })
+     * ```
+     */
+    constructor(apiKey: string, options?: SafeNestOptions);
+    /**
+     * Get current usage stats from the last request
+     */
+    get usage(): Usage | null;
+    /**
+     * Get the request ID from the last request
+     */
+    get lastRequestId(): string | null;
+    /**
+     * Get the latency from the last request in milliseconds
+     */
+    get lastLatencyMs(): number | null;
+    /**
+     * Validate content length to prevent abuse
+     */
+    private validateContent;
+    /**
+     * Validate messages array
+     */
+    private validateMessages;
+    /**
+     * Normalize context input to API format
+     */
+    private normalizeContext;
+    /**
+     * Make an authenticated request to the API
+     */
+    private request;
+    /**
+     * Handle error responses from the API
+     */
+    private handleErrorResponse;
+    /**
+     * Make a request with retry logic
+     */
+    private requestWithRetry;
+    /**
+     * Detect bullying in content
+     *
+     * @example
+     * ```typescript
+     * const result = await safenest.detectBullying({
+     *   content: "Nobody likes you, loser",
+     *   context: 'chat'
+     * })
+     *
+     * if (result.is_bullying && result.severity === 'high') {
+     *   console.log('High severity bullying detected')
+     *   console.log('Rationale:', result.rationale)
+     * }
+     * ```
+     */
+    detectBullying(input: DetectBullyingInput): Promise<BullyingResult>;
+    /**
+     * Detect grooming patterns in a conversation
+     *
+     * @example
+     * ```typescript
+     * const result = await safenest.detectGrooming({
+     *   messages: [
+     *     { role: 'adult', content: "Don't tell your parents" },
+     *     { role: 'child', content: "Ok" }
+     *   ],
+     *   childAge: 12
+     * })
+     *
+     * if (result.grooming_risk === 'high') {
+     *   console.log('Flags:', result.flags)
+     * }
+     * ```
+     */
+    detectGrooming(input: DetectGroomingInput): Promise<GroomingResult>;
+    /**
+     * Detect unsafe content (self-harm, violence, hate speech, etc.)
+     *
+     * @example
+     * ```typescript
+     * const result = await safenest.detectUnsafe({
+     *   content: "I want to hurt myself"
+     * })
+     *
+     * if (result.unsafe && result.categories.includes('self_harm')) {
+     *   console.log('Show crisis resources')
+     * }
+     * ```
+     */
+    detectUnsafe(input: DetectUnsafeInput): Promise<UnsafeResult>;
+    /**
+     * Quick analysis - runs bullying and unsafe detection, returns combined result
+     *
+     * @example
+     * ```typescript
+     * const result = await safenest.analyze("Some user message")
+     *
+     * if (result.risk_level !== 'safe') {
+     *   console.log('Risk:', result.risk_level)
+     *   console.log('Summary:', result.summary)
+     * }
+     * ```
+     */
+    analyze(content: string, context?: ContextInput): Promise<AnalyzeResult>;
+    analyze(input: AnalyzeInput): Promise<AnalyzeResult>;
+    /**
+     * Analyze emotions in content or conversation
+     *
+     * @example
+     * ```typescript
+     * const result = await safenest.analyzeEmotions({
+     *   content: "I'm so stressed about everything"
+     * })
+     *
+     * console.log('Emotions:', result.dominant_emotions)
+     * console.log('Trend:', result.trend)
+     * ```
+     */
+    analyzeEmotions(input: AnalyzeEmotionsInput): Promise<EmotionsResult>;
+    /**
+     * Get age-appropriate action guidance for a situation
+     *
+     * @example
+     * ```typescript
+     * const plan = await safenest.getActionPlan({
+     *   situation: 'Someone is spreading rumors about me',
+     *   childAge: 12,
+     *   audience: 'child'
+     * })
+     *
+     * console.log('Steps:', plan.steps)
+     * ```
+     */
+    getActionPlan(input: GetActionPlanInput): Promise<ActionPlanResult>;
+    /**
+     * Generate an incident report from messages
+     *
+     * @example
+     * ```typescript
+     * const report = await safenest.generateReport({
+     *   messages: [
+     *     { sender: 'user1', content: 'Harmful message' },
+     *     { sender: 'child', content: 'Response' }
+     *   ],
+     *   childAge: 14
+     * })
+     *
+     * console.log('Summary:', report.summary)
+     * console.log('Risk:', report.risk_level)
+     * console.log('Next steps:', report.recommended_next_steps)
+     * ```
+     */
+    generateReport(input: GenerateReportInput): Promise<ReportResult>;
+    /**
+     * Get the current policy configuration
+     *
+     * @example
+     * ```typescript
+     * const policy = await safenest.getPolicy()
+     * console.log('Bullying enabled:', policy.config?.bullying.enabled)
+     * ```
+     */
+    getPolicy(): Promise<PolicyConfigResponse>;
+    /**
+     * Update the policy configuration
+     *
+     * @example
+     * ```typescript
+     * await safenest.setPolicy({
+     *   bullying: {
+     *     enabled: true,
+     *     minRiskScoreToFlag: 0.5
+     *   }
+     * })
+     * ```
+     */
+    setPolicy(config: PolicyConfig): Promise<PolicyConfigResponse>;
+}
+export { SafeNest as SafeNestClient };
+//# 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,OAAO,EACH,eAAe,EACf,KAAK,EAGL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EAEZ,oBAAoB,EACpB,cAAc,EAEd,kBAAkB,EAClB,gBAAgB,EAEhB,mBAAmB,EACnB,YAAY,EAEZ,YAAY,EACZ,oBAAoB,EACvB,MAAM,kBAAkB,CAAC;AA0B1B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;;;;;;;;;;;;;;OAgBG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB;IAuBzD;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;YACW,OAAO;IAuErB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;YACW,gBAAgB;IAkB9B;;;;;;;;;;;;;;;OAeG;IACG,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAezE;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBzE;;;;;;;;;;;;;OAaG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAenE;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IACxE,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAqG1D;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IA0C3E;;;;;;;;;;;;;OAaG;IACG,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBzE;;;;;;;;;;;;;;;;;OAiBG;IACG,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBvE;;;;;;;;OAQG;IACG,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAOhD;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAOvE;AAGD,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,CAAC"}