@semiont/api-client 0.1.0

package/dist/utils/validation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Generic validation utilities for @semiont/api-client
+ *
+ * Pure TypeScript validation with no external dependencies.
+ * Safe to use in any JavaScript environment (Node.js, browser, Deno, etc.)
+ */
+/**
+ * Validation result types
+ */
+export type ValidationSuccess<T> = {
+    success: true;
+    data: T;
+};
+export type ValidationFailure = {
+    success: false;
+    error: string;
+    details?: string[];
+};
+export type ValidationResult<T> = ValidationSuccess<T> | ValidationFailure;
+/**
+ * JWT Token validation
+ *
+ * Validates JWT token format (header.payload.signature).
+ * Does not verify signature - use for format validation only.
+ */
+export declare const JWTTokenSchema: {
+    parse(token: unknown): string;
+    safeParse(token: unknown): ValidationResult<string>;
+};
+/**
+ * Generic validation helper with error formatting
+ *
+ * Wraps any schema's parse method with try/catch and returns ValidationResult.
+ *
+ * @example
+ * ```typescript
+ * const result = validateData(JWTTokenSchema, 'eyJ...');
+ * if (result.success) {
+ *   console.log('Valid token:', result.data);
+ * } else {
+ *   console.error('Invalid:', result.error);
+ * }
+ * ```
+ */
+export declare function validateData<T>(schema: {
+    parse(data: unknown): T;
+}, data: unknown): ValidationResult<T>;
+/**
+ * Email validation helper
+ *
+ * Validates email format using RFC 5322 simplified regex.
+ *
+ * @param email - Email address to validate
+ * @returns true if valid email format
+ */
+export declare function isValidEmail(email: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AACtF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,cAAc;iBACZ,OAAO,GAAG,MAAM;qBAeZ,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAWpD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE;IAAE,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAA;CAAE,EACnC,IAAI,EAAE,OAAO,GACZ,gBAAgB,CAAC,CAAC,CAAC,CAUrB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOnD"}

package/dist/utils/validation.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Generic validation utilities for @semiont/api-client
+ *
+ * Pure TypeScript validation with no external dependencies.
+ * Safe to use in any JavaScript environment (Node.js, browser, Deno, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JWTTokenSchema = void 0;
+exports.validateData = validateData;
+exports.isValidEmail = isValidEmail;
+/**
+ * JWT Token validation
+ *
+ * Validates JWT token format (header.payload.signature).
+ * Does not verify signature - use for format validation only.
+ */
+exports.JWTTokenSchema = {
+    parse(token) {
+        if (typeof token !== 'string') {
+            throw new Error('Token must be a string');
+        }
+        if (!token || token.length === 0) {
+            throw new Error('Token is required');
+        }
+        // JWT format: header.payload.signature
+        const jwtRegex = /^[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]*$/;
+        if (!jwtRegex.test(token)) {
+            throw new Error('Invalid JWT token format');
+        }
+        return token;
+    },
+    safeParse(token) {
+        try {
+            const validated = this.parse(token);
+            return { success: true, data: validated };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Invalid JWT token',
+            };
+        }
+    },
+};
+/**
+ * Generic validation helper with error formatting
+ *
+ * Wraps any schema's parse method with try/catch and returns ValidationResult.
+ *
+ * @example
+ * ```typescript
+ * const result = validateData(JWTTokenSchema, 'eyJ...');
+ * if (result.success) {
+ *   console.log('Valid token:', result.data);
+ * } else {
+ *   console.error('Invalid:', result.error);
+ * }
+ * ```
+ */
+function validateData(schema, data) {
+    try {
+        const validated = schema.parse(data);
+        return { success: true, data: validated };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Validation failed',
+        };
+    }
+}
+/**
+ * Email validation helper
+ *
+ * Validates email format using RFC 5322 simplified regex.
+ *
+ * @param email - Email address to validate
+ * @returns true if valid email format
+ */
+function isValidEmail(email) {
+    if (email.length < 1 || email.length > 255) {
+        return false;
+    }
+    // RFC 5322 simplified email regex
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2DH,oCAaC;AAUD,oCAOC;AAhFD;;;;;GAKG;AACU,QAAA,cAAc,GAAG;IAC5B,KAAK,CAAC,KAAc;QAClB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,uCAAuC;QACvC,MAAM,QAAQ,GAAG,qDAAqD,CAAC;QACvE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;aACpE,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,SAAgB,YAAY,CAC1B,MAAmC,EACnC,IAAa;IAEb,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;SACpE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,kCAAkC;IAClC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@semiont/api-client",
+  "version": "0.1.0",
+  "description": "Semiont API SDK - types, client, and utilities",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/The-AI-Alliance/semiont.git",
+    "directory": "packages/api-client"
+  },
+  "scripts": {
+    "bundle-spec": "cd ../.. && npm run openapi:bundle",
+    "copy-spec": "cp ../../specs/openapi.json openapi.json",
+    "generate": "npm run bundle-spec && npm run copy-spec && openapi-typescript openapi.json -o src/types.ts",
+    "build": "tsc && npm run copy-types",
+    "copy-types": "cp src/types.ts dist/types.d.ts",
+    "prebuild": "npm run generate",
+    "watch": "tsc --watch",
+    "clean": "rm -rf dist src/types.ts openapi.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "ky": "^1.2.0"
+  },
+  "devDependencies": {
+    "openapi-typescript": "^7.10.1",
+    "orval": "^6.31.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "semiont",
+    "api",
+    "client",
+    "sdk",
+    "openapi",
+    "annotations",
+    "utilities",
+    "w3c"
+  ],
+  "author": "Semiont Team",
+  "license": "Apache-2.0"
+}