@retab/node 0.0.0-reserved → 0.0.42

package/dist/utils/webhook_secrets.js

@@ -0,0 +1,107 @@
+import { createHash, createHmac, timingSafeEqual } from 'crypto';
+/**
+ * Generate webhook signature for payload
+ */
+export function generateSignature(payload, secret, timestamp, encoding = 'hex') {
+    const ts = timestamp || Math.floor(Date.now() / 1000);
+    const payloadString = Buffer.isBuffer(payload) ? payload.toString('utf8') : payload;
+    const signedPayload = `${ts}.${payloadString}`;
+    const hmac = createHmac('sha256', secret);
+    hmac.update(signedPayload);
+    return hmac.digest(encoding);
+}
+/**
+ * Verify webhook signature
+ */
+export function verifySignature(payload, signature, secret, timestamp, config = {}) {
+    const { tolerance = 300, encoding = 'hex' } = config; // 5 minute default tolerance
+    try {
+        const ts = timestamp || Math.floor(Date.now() / 1000);
+        const expectedSignature = generateSignature(payload, secret, ts, encoding);
+        // Use timing-safe comparison to prevent timing attacks
+        const sigBuffer = Buffer.from(signature, encoding);
+        const expectedBuffer = Buffer.from(expectedSignature, encoding);
+        if (sigBuffer.length !== expectedBuffer.length) {
+            return false;
+        }
+        const isSignatureValid = timingSafeEqual(sigBuffer, expectedBuffer);
+        // Check timestamp tolerance if provided
+        if (timestamp && tolerance > 0) {
+            const now = Math.floor(Date.now() / 1000);
+            const isTimestampValid = Math.abs(now - timestamp) <= tolerance;
+            return isSignatureValid && isTimestampValid;
+        }
+        return isSignatureValid;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Parse webhook headers for signature and timestamp
+ */
+export function parseWebhookHeaders(headers) {
+    const signature = headers['x-webhook-signature'] ||
+        headers['x-retab-signature'] ||
+        headers['signature'];
+    const timestampHeader = headers['x-webhook-timestamp'] ||
+        headers['x-retab-timestamp'] ||
+        headers['timestamp'];
+    const timestamp = timestampHeader ? parseInt(timestampHeader, 10) : undefined;
+    return { signature, timestamp };
+}
+/**
+ * Verify webhook request
+ */
+export function verifyWebhookRequest(payload, headers, secret, config = {}) {
+    const { signature, timestamp } = parseWebhookHeaders(headers);
+    if (!signature) {
+        return false;
+    }
+    return verifySignature(payload, signature, secret, timestamp, config);
+}
+/**
+ * Generate webhook secret
+ */
+export function generateWebhookSecret(length = 32) {
+    return createHash('sha256')
+        .update(Math.random().toString())
+        .update(Date.now().toString())
+        .digest('hex')
+        .slice(0, length);
+}
+/**
+ * Create webhook signature header
+ */
+export function createSignatureHeader(payload, secret, encoding = 'hex') {
+    const timestamp = Math.floor(Date.now() / 1000);
+    const signature = generateSignature(payload, secret, timestamp, encoding);
+    return { signature, timestamp };
+}
+/**
+ * Webhook middleware for Express-like frameworks
+ */
+export function webhookMiddleware(secret, config = {}) {
+    return (req, res, next) => {
+        try {
+            const payload = req.rawBody || req.body;
+            const headers = req.headers;
+            if (!verifyWebhookRequest(payload, headers, secret, config)) {
+                return res.status(401).json({ error: 'Invalid webhook signature' });
+            }
+            next();
+        }
+        catch (error) {
+            return res.status(400).json({ error: 'Webhook verification failed' });
+        }
+    };
+}
+export default {
+    generateSignature,
+    verifySignature,
+    parseWebhookHeaders,
+    verifyWebhookRequest,
+    generateWebhookSecret,
+    createSignatureHeader,
+    webhookMiddleware,
+};

package/dist/utils/zod_to_json_schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+/**
+ * Convert a Zod schema to JSON Schema.
+ * This is a basic implementation that handles common Zod types.
+ */
+export declare function zodToJsonSchema(zodSchema: z.ZodType<any>): Record<string, any>;
+/**
+ * Extract descriptions from Zod schema and convert them to field descriptions.
+ */
+export declare function extractZodDescriptions(zodSchema: z.ZodType<any>): Record<string, string>;
+//# sourceMappingURL=zod_to_json_schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zod_to_json_schema.d.ts","sourceRoot":"","sources":["../../src/utils/zod_to_json_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA8G9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BxF"}

package/dist/utils/zod_to_json_schema.js

@@ -0,0 +1,123 @@
+/**
+ * Convert a Zod schema to JSON Schema.
+ * This is a basic implementation that handles common Zod types.
+ */
+export function zodToJsonSchema(zodSchema) {
+    function convertZodType(schema) {
+        const def = schema._def;
+        switch (def.typeName) {
+            case 'ZodString':
+                const stringSchema = { type: 'string' };
+                if (def.description) {
+                    stringSchema.description = def.description;
+                }
+                return stringSchema;
+            case 'ZodNumber':
+                const numberSchema = { type: 'number' };
+                if (def.description) {
+                    numberSchema.description = def.description;
+                }
+                return numberSchema;
+            case 'ZodBoolean':
+                const booleanSchema = { type: 'boolean' };
+                if (def.description) {
+                    booleanSchema.description = def.description;
+                }
+                return booleanSchema;
+            case 'ZodArray':
+                return {
+                    type: 'array',
+                    items: convertZodType(def.type),
+                    ...(def.description && { description: def.description })
+                };
+            case 'ZodObject':
+                const properties = {};
+                const required = [];
+                for (const [key, value] of Object.entries(def.shape())) {
+                    properties[key] = convertZodType(value);
+                    // Check if the field is required (not optional)
+                    const zodValue = value;
+                    if (!zodValue._def.typeName?.includes('Optional') &&
+                        zodValue._def.typeName !== 'ZodOptional') {
+                        required.push(key);
+                    }
+                }
+                const objectSchema = {
+                    type: 'object',
+                    properties,
+                    additionalProperties: false
+                };
+                if (required.length > 0) {
+                    objectSchema.required = required;
+                }
+                if (def.description) {
+                    objectSchema.description = def.description;
+                }
+                return objectSchema;
+            case 'ZodOptional':
+                return convertZodType(def.innerType);
+            case 'ZodNullable':
+                const innerSchema = convertZodType(def.innerType);
+                return {
+                    ...innerSchema,
+                    nullable: true
+                };
+            case 'ZodUnion':
+                return {
+                    anyOf: def.options.map((option) => convertZodType(option))
+                };
+            case 'ZodEnum':
+                return {
+                    type: 'string',
+                    enum: def.values,
+                    ...(def.description && { description: def.description })
+                };
+            case 'ZodLiteral':
+                return {
+                    type: typeof def.value,
+                    const: def.value,
+                    ...(def.description && { description: def.description })
+                };
+            case 'ZodRecord':
+                return {
+                    type: 'object',
+                    additionalProperties: convertZodType(def.valueType),
+                    ...(def.description && { description: def.description })
+                };
+            default:
+                // Fallback for unknown types
+                return {
+                    type: 'string',
+                    description: def.description || `Unsupported Zod type: ${def.typeName}`
+                };
+        }
+    }
+    return convertZodType(zodSchema);
+}
+/**
+ * Extract descriptions from Zod schema and convert them to field descriptions.
+ */
+export function extractZodDescriptions(zodSchema) {
+    const descriptions = {};
+    function extractFromType(schema, path = '') {
+        const def = schema._def;
+        if (def.typeName === 'ZodObject') {
+            for (const [key, value] of Object.entries(def.shape())) {
+                const currentPath = path ? `${path}.${key}` : key;
+                const zodValue = value;
+                if (zodValue._def.description) {
+                    descriptions[currentPath] = zodValue._def.description;
+                }
+                extractFromType(zodValue, currentPath);
+            }
+        }
+        else if (def.typeName === 'ZodOptional' || def.typeName === 'ZodNullable') {
+            extractFromType(def.innerType, path);
+        }
+        else if (def.typeName === 'ZodArray') {
+            extractFromType(def.type, path);
+        }
+    }
+    extractFromType(zodSchema);
+    return descriptions;
+}

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+type SchemaTypeInfer<T extends string> = T extends "string" ? string : T extends "number" ? number : T extends "integer" ? number : T extends "boolean" ? boolean : T extends "array" ? any[] : T extends "object" ? Record<string, any> : T extends "null" ? null : never;
+type BuildAnyOf<T> = T extends [infer U, ...infer Rest] ? SchemaInfer<U> | BuildAnyOf<Rest> : never;
+type BuildAllOf<T> = T extends [infer U, ...infer Rest] ? SchemaInfer<U> & BuildAllOf<Rest> : any;
+type WalkProp<Ctx, Prop> = Ctx[Prop];
+type ResolveRelativeRef<Ctx, Ref extends string> = Ref extends `${infer Prop}/${infer Rest}` ? ResolveRelativeRef<WalkProp<Ctx, Prop>, Rest> : WalkProp<Ctx, Ref>;
+type ResolveRef<Ctx, Ref extends string> = Ref extends `#/${infer Rest}` ? ResolveRelativeRef<Ctx, Rest> : never;
+type BuildTypes<T extends string[]> = T extends [infer Type extends string, ...infer Rest extends string[]] ? SchemaTypeInfer<Type> | BuildTypes<Rest> : never;
+type SchemaInfer<T, Ctx = T> = T extends {
+    $ref: string;
+} ? ResolveRef<Ctx, T["$ref"]> : T extends {
+    anyOf: any[];
+} ? BuildAnyOf<T["anyOf"]> : T extends {
+    allOf: any[];
+} ? BuildAllOf<T["allOf"]> : T extends {
+    type: string[];
+} ? BuildTypes<T["type"]> : T extends {
+    type: string;
+} ? SchemaTypeInfer<T["type"]> : never;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,IACjC,CAAC,SAAS,QAAQ,GAAG,MAAM,GAC3B,CAAC,SAAS,QAAQ,GAAG,MAAM,GAC3B,CAAC,SAAS,SAAS,GAAG,MAAM,GAC5B,CAAC,SAAS,SAAS,GAAG,OAAO,GAC7B,CAAC,SAAS,OAAO,GAAG,GAAG,EAAE,GACzB,CAAC,SAAS,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxC,CAAC,SAAS,MAAM,GAAG,IAAI,GACvB,KAAK,CAAC;AAEV,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AACpG,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AAGlG,KAAK,QAAQ,CAAC,GAAG,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AACrC,KAAK,kBAAkB,CAAC,GAAG,EAAE,GAAG,SAAS,MAAM,IAC3C,GAAG,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACrC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAE3B,KAAK,UAAU,CAAC,GAAG,EAAE,GAAG,SAAS,MAAM,IACnC,GAAG,SAAS,KAAK,MAAM,IAAI,EAAE,GAAG,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;AAE1E,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,SAAS,MAAM,EAAE,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AAE/J,KAAK,WAAW,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IACvB,CAAC,SAAS;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GACrD,CAAC,SAAS;IAAC,KAAK,EAAE,GAAG,EAAE,CAAA;CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GACjD,CAAC,SAAS;IAAC,KAAK,EAAE,GAAG,EAAE,CAAA;CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GACjD,CAAC,SAAS;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAClD,CAAC,SAAS;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GACrD,KAAK,CAAC"}

package/dist/utils.js

@@ -0,0 +1 @@
+"use strict";

package/package.json

@@ -1,12 +1,68 @@
 {
   "name": "@retab/node",
-  "version": "0.0.0-reserved",
-  "description": "Reserved for the @retab org",
-  "publishConfig": { "access": "public" },
+  "version": "0.0.42",
+  "description": "Retab official Node.js library",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:verbose": "jest --verbose",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepare": "npm run build",
+    "clean": "rm -rf dist",
+    "rebuild": "npm run clean && npm run build"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/retab/node.git"
+    "url": "https://github.com/Retab-dev/retab"
+  },
+  "keywords": [
+    "retab",
+    "sdk",
+    "api",
+    "client"
+  ],
+  "author": "Retab",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "axios-retry": "^4.0.0",
+    "blake2": "^5.0.0",
+    "dotenv": "^17.2.0",
+    "file-type": "^21.0.0",
+    "form-data": "^4.0.0",
+    "js-yaml": "^4.1.0",
+    "openai": "^5.8.2",
+    "zod": "^3.22.0",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "devDependencies": {
+    "@types/blake2": "^4.0.4",
+    "@types/jest": "^29.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
   },
-  "author": "Retab, Inc.",
-  "license": "MIT"
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/index.js

@@ -1,7 +0,0 @@
-/**
- * Placeholder package – just reserving the name for now.
- * Feel free to open an issue if you’d like to collaborate!
- */
-module.exports = function () {
-  console.log('Package “my-awesome-name” is reserved by @your-npm-user.');
-};