id.org.ai 0.1.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,555 @@
+/**
+ * @packageDocumentation
+ * @module id.org.ai
+ *
+ * Identity primitives for schema.org.ai
+ *
+ * This package provides identity types for humans and AI agents:
+ * - {@link Identity} - Base identity interface
+ * - {@link User} - Human user identity
+ * - {@link AgentIdentity} - AI agent identity
+ * - {@link Credential} - Authentication credentials
+ * - {@link Session} - Active sessions
+ *
+ * All types follow JSON-LD conventions with `$id` and `$type` fields.
+ *
+ * @example
+ * ```typescript
+ * import { createUser, isUser, UserSchema } from 'id.org.ai'
+ *
+ * const user = createUser({
+ *   email: 'alice@example.com',
+ *   name: 'Alice'
+ * })
+ *
+ * // Runtime validation
+ * if (isUser(unknownData)) {
+ *   console.log(unknownData.email)
+ * }
+ *
+ * // Schema validation
+ * const result = UserSchema.safeParse(data)
+ * ```
+ *
+ * @version 0.1.0
+ */
+import { z } from 'zod';
+// === Internal Helpers ===
+/**
+ * Generates a unique identifier URI for a given resource type
+ * @internal
+ */
+function generateId(prefix) {
+    const uuid = crypto.randomUUID();
+    return `https://schema.org.ai/${prefix}/${uuid}`;
+}
+/**
+ * Generates a secure random token for session authentication
+ * @internal
+ */
+function generateToken() {
+    return crypto.randomUUID().replace(/-/g, '') + crypto.randomUUID().replace(/-/g, '');
+}
+/**
+ * Zod schema for validating Identity objects
+ *
+ * Use this schema for runtime validation of identity data.
+ *
+ * @see {@link Identity}
+ *
+ * @example
+ * ```typescript
+ * const result = IdentitySchema.safeParse(unknownData)
+ * if (result.success) {
+ *   console.log(result.data.$id)
+ * } else {
+ *   console.error(result.error)
+ * }
+ * ```
+ */
+export const IdentitySchema = z.object({
+    $id: z.string(),
+    $type: z.literal('https://schema.org.ai/Identity'),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+/**
+ * Type guard to check if an object is a valid Identity
+ *
+ * Uses Zod schema validation internally to ensure type safety.
+ *
+ * @param obj - Object to validate
+ * @returns True if the object is a valid Identity
+ *
+ * @example
+ * ```typescript
+ * const data: unknown = fetchFromAPI()
+ * if (isIdentity(data)) {
+ *   // TypeScript knows data is Identity
+ *   console.log(data.createdAt)
+ * }
+ * ```
+ */
+export function isIdentity(obj) {
+    return IdentitySchema.safeParse(obj).success;
+}
+/**
+ * Factory function to create a new Identity
+ *
+ * Creates a complete Identity object with auto-generated `$id` (if not provided)
+ * and timestamps. The `$type` is always set to the correct JSON-LD type.
+ *
+ * @param input - Optional partial identity data
+ * @param input.$id - Custom identifier URI (auto-generated if not provided)
+ * @returns A complete Identity object with all required fields
+ *
+ * @example
+ * ```typescript
+ * // Auto-generate all fields
+ * const identity = createIdentity()
+ *
+ * // With custom $id
+ * const identity = createIdentity({ $id: 'https://example.com/id/custom' })
+ * ```
+ */
+export function createIdentity(input) {
+    const now = new Date().toISOString();
+    return {
+        $id: input?.$id ?? generateId('identities'),
+        $type: 'https://schema.org.ai/Identity',
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Zod schema for validating User objects
+ *
+ * Validates all User fields including email format validation.
+ *
+ * @see {@link User}
+ *
+ * @example
+ * ```typescript
+ * const result = UserSchema.safeParse({
+ *   $id: 'https://example.com/users/1',
+ *   $type: 'https://schema.org.ai/User',
+ *   email: 'alice@example.com',
+ *   name: 'Alice',
+ *   createdAt: new Date().toISOString(),
+ *   updatedAt: new Date().toISOString()
+ * })
+ *
+ * if (!result.success) {
+ *   console.error('Invalid email:', result.error.issues)
+ * }
+ * ```
+ */
+export const UserSchema = z.object({
+    $id: z.string(),
+    $type: z.literal('https://schema.org.ai/User'),
+    email: z.string().email(),
+    name: z.string(),
+    profile: z.record(z.unknown()).optional(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+/**
+ * Type guard to check if an object is a valid User
+ *
+ * Uses Zod schema validation internally including email format validation.
+ *
+ * @param obj - Object to validate
+ * @returns True if the object is a valid User
+ *
+ * @example
+ * ```typescript
+ * const data: unknown = await fetchUser(id)
+ * if (isUser(data)) {
+ *   // TypeScript knows data is User
+ *   sendEmail(data.email, `Hello ${data.name}!`)
+ * }
+ * ```
+ */
+export function isUser(obj) {
+    return UserSchema.safeParse(obj).success;
+}
+/**
+ * Factory function to create a new User
+ *
+ * Creates a complete User object with auto-generated `$id` (if not provided),
+ * timestamps, and the correct `$type`. Email and name are required.
+ *
+ * @param input - User data (email and name required)
+ * @param input.email - User's email address
+ * @param input.name - User's display name
+ * @param input.$id - Custom identifier URI (auto-generated if not provided)
+ * @param input.profile - Optional profile metadata
+ * @returns A complete User object ready for storage
+ *
+ * @example
+ * ```typescript
+ * // Basic user creation
+ * const user = createUser({
+ *   email: 'alice@example.com',
+ *   name: 'Alice Smith'
+ * })
+ *
+ * // With profile data
+ * const user = createUser({
+ *   email: 'bob@example.com',
+ *   name: 'Bob Jones',
+ *   profile: {
+ *     avatar: 'https://example.com/bob.png',
+ *     bio: 'Software developer',
+ *     settings: { theme: 'dark' }
+ *   }
+ * })
+ *
+ * // With custom $id
+ * const user = createUser({
+ *   $id: 'https://myapp.com/users/alice',
+ *   email: 'alice@example.com',
+ *   name: 'Alice'
+ * })
+ * ```
+ */
+export function createUser(input) {
+    const now = new Date().toISOString();
+    return {
+        $id: input.$id ?? generateId('users'),
+        $type: 'https://schema.org.ai/User',
+        email: input.email,
+        name: input.name,
+        profile: input.profile,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Zod schema for validating AgentIdentity objects
+ *
+ * Validates all AgentIdentity fields including model, capabilities array,
+ * and autonomous flag.
+ *
+ * @see {@link AgentIdentity}
+ *
+ * @example
+ * ```typescript
+ * const result = AgentIdentitySchema.safeParse(agentData)
+ * if (result.success) {
+ *   const agent = result.data
+ *   if (agent.autonomous) {
+ *     console.log('Agent can act independently')
+ *   }
+ * }
+ * ```
+ */
+export const AgentIdentitySchema = z.object({
+    $id: z.string(),
+    $type: z.literal('https://schema.org.ai/AgentIdentity'),
+    model: z.string(),
+    capabilities: z.array(z.string()),
+    autonomous: z.boolean(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+/**
+ * Type guard to check if an object is a valid AgentIdentity
+ *
+ * Uses Zod schema validation internally to ensure type safety.
+ *
+ * @param obj - Object to validate
+ * @returns True if the object is a valid AgentIdentity
+ *
+ * @example
+ * ```typescript
+ * const identity: unknown = getIdentity(id)
+ * if (isAgentIdentity(identity)) {
+ *   // TypeScript knows identity is AgentIdentity
+ *   console.log(`Agent model: ${identity.model}`)
+ *   console.log(`Capabilities: ${identity.capabilities.join(', ')}`)
+ * }
+ * ```
+ */
+export function isAgentIdentity(obj) {
+    return AgentIdentitySchema.safeParse(obj).success;
+}
+/**
+ * Factory function to create a new AgentIdentity
+ *
+ * Creates a complete AgentIdentity object with auto-generated `$id` (if not provided),
+ * timestamps, and the correct `$type`. Model, capabilities, and autonomous flag are required.
+ *
+ * @param input - Agent identity data
+ * @param input.model - The AI model name (e.g., 'claude-3-opus')
+ * @param input.capabilities - Array of capability strings
+ * @param input.autonomous - Whether the agent can act autonomously
+ * @param input.$id - Custom identifier URI (auto-generated if not provided)
+ * @returns A complete AgentIdentity object ready for storage
+ *
+ * @example
+ * ```typescript
+ * // Create a supervised agent
+ * const assistant = createAgentIdentity({
+ *   model: 'claude-3-opus',
+ *   capabilities: ['text-generation', 'code-analysis'],
+ *   autonomous: false
+ * })
+ *
+ * // Create an autonomous agent
+ * const worker = createAgentIdentity({
+ *   model: 'claude-3-haiku',
+ *   capabilities: ['task-execution', 'tool-use'],
+ *   autonomous: true
+ * })
+ *
+ * // With custom $id
+ * const namedAgent = createAgentIdentity({
+ *   $id: 'https://myapp.com/agents/ralph',
+ *   model: 'claude-3-opus',
+ *   capabilities: ['coding', 'review'],
+ *   autonomous: true
+ * })
+ * ```
+ */
+export function createAgentIdentity(input) {
+    const now = new Date().toISOString();
+    return {
+        $id: input.$id ?? generateId('agents'),
+        $type: 'https://schema.org.ai/AgentIdentity',
+        model: input.model,
+        capabilities: input.capabilities,
+        autonomous: input.autonomous,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Zod schema for validating Credential objects
+ *
+ * Validates credential type as one of the allowed enum values.
+ *
+ * @see {@link Credential}
+ * @see {@link CredentialType}
+ *
+ * @example
+ * ```typescript
+ * const result = CredentialSchema.safeParse(credentialData)
+ * if (result.success) {
+ *   const cred = result.data
+ *   if (cred.credentialType === 'oauth' && cred.provider) {
+ *     console.log(`OAuth via ${cred.provider}`)
+ *   }
+ * }
+ * ```
+ */
+export const CredentialSchema = z.object({
+    $id: z.string(),
+    $type: z.literal('https://schema.org.ai/Credential'),
+    identityId: z.string(),
+    credentialType: z.enum(['password', 'oauth', 'api_key', 'sso']),
+    provider: z.string().optional(),
+    expiresAt: z.string().optional(),
+});
+/**
+ * Type guard to check if an object is a valid Credential
+ *
+ * Uses Zod schema validation internally to ensure type safety.
+ *
+ * @param obj - Object to validate
+ * @returns True if the object is a valid Credential
+ *
+ * @example
+ * ```typescript
+ * const data: unknown = await getCredential(id)
+ * if (isCredential(data)) {
+ *   // TypeScript knows data is Credential
+ *   console.log(`Credential type: ${data.credentialType}`)
+ *   if (data.expiresAt) {
+ *     console.log(`Expires: ${data.expiresAt}`)
+ *   }
+ * }
+ * ```
+ */
+export function isCredential(obj) {
+    return CredentialSchema.safeParse(obj).success;
+}
+/**
+ * Factory function to create a new Credential
+ *
+ * Creates a complete Credential object with auto-generated `$id` (if not provided)
+ * and the correct `$type`. The identityId and credentialType are required.
+ *
+ * @param input - Credential data
+ * @param input.identityId - Reference to the owning identity
+ * @param input.credentialType - Type of credential (password, oauth, api_key, sso)
+ * @param input.$id - Custom identifier URI (auto-generated if not provided)
+ * @param input.provider - OAuth/SSO provider name (optional)
+ * @param input.expiresAt - Expiration timestamp (optional)
+ * @returns A complete Credential object ready for storage
+ *
+ * @example
+ * ```typescript
+ * // Password credential (never expires)
+ * const passwordCred = createCredential({
+ *   identityId: 'https://schema.org.ai/users/123',
+ *   credentialType: 'password'
+ * })
+ *
+ * // OAuth credential with expiration
+ * const oauthCred = createCredential({
+ *   identityId: 'https://schema.org.ai/users/123',
+ *   credentialType: 'oauth',
+ *   provider: 'google',
+ *   expiresAt: '2024-12-31T23:59:59Z'
+ * })
+ *
+ * // API key for programmatic access
+ * const apiKeyCred = createCredential({
+ *   identityId: 'https://schema.org.ai/agents/worker-1',
+ *   credentialType: 'api_key'
+ * })
+ * ```
+ */
+export function createCredential(input) {
+    return {
+        $id: input.$id ?? generateId('credentials'),
+        $type: 'https://schema.org.ai/Credential',
+        identityId: input.identityId,
+        credentialType: input.credentialType,
+        provider: input.provider,
+        expiresAt: input.expiresAt,
+    };
+}
+/**
+ * Zod schema for validating Session objects
+ *
+ * Validates all Session fields including non-empty token requirement.
+ *
+ * @see {@link Session}
+ *
+ * @example
+ * ```typescript
+ * const result = SessionSchema.safeParse(sessionData)
+ * if (result.success) {
+ *   const session = result.data
+ *   // Use the validated session
+ * } else {
+ *   console.error('Invalid session:', result.error.issues)
+ * }
+ * ```
+ */
+export const SessionSchema = z.object({
+    $id: z.string(),
+    $type: z.literal('https://schema.org.ai/Session'),
+    identityId: z.string(),
+    token: z.string().min(1),
+    expiresAt: z.string(),
+    metadata: z.record(z.unknown()).optional(),
+});
+/**
+ * Type guard to check if an object is a valid Session
+ *
+ * Uses Zod schema validation internally to ensure type safety.
+ * Note: This only validates structure, not expiration. Use {@link isSessionExpired}
+ * to check if a session has expired.
+ *
+ * @param obj - Object to validate
+ * @returns True if the object is a valid Session
+ *
+ * @example
+ * ```typescript
+ * const data: unknown = await getSession(token)
+ * if (isSession(data)) {
+ *   // TypeScript knows data is Session
+ *   if (!isSessionExpired(data)) {
+ *     console.log(`Session valid until: ${data.expiresAt}`)
+ *   }
+ * }
+ * ```
+ */
+export function isSession(obj) {
+    return SessionSchema.safeParse(obj).success;
+}
+/**
+ * Factory function to create a new Session
+ *
+ * Creates a complete Session object with auto-generated `$id`, `token`, and
+ * `expiresAt` (24 hours from now) if not provided. Only `identityId` is required.
+ *
+ * @param input - Session data
+ * @param input.identityId - Reference to the authenticated identity
+ * @param input.$id - Custom identifier URI (auto-generated if not provided)
+ * @param input.token - Custom session token (auto-generated if not provided)
+ * @param input.expiresAt - Custom expiration (defaults to 24 hours from now)
+ * @param input.metadata - Optional session metadata
+ * @returns A complete Session object ready for storage
+ *
+ * @example
+ * ```typescript
+ * // Basic session with defaults (24h expiry, auto-generated token)
+ * const session = createSession({
+ *   identityId: 'https://schema.org.ai/users/123'
+ * })
+ *
+ * // Session with custom expiration
+ * const shortSession = createSession({
+ *   identityId: 'https://schema.org.ai/users/123',
+ *   expiresAt: new Date(Date.now() + 60 * 60 * 1000).toISOString() // 1 hour
+ * })
+ *
+ * // Session with metadata
+ * const trackedSession = createSession({
+ *   identityId: 'https://schema.org.ai/users/123',
+ *   metadata: {
+ *     userAgent: 'Mozilla/5.0...',
+ *     ip: '192.168.1.1',
+ *     device: 'desktop'
+ *   }
+ * })
+ * ```
+ */
+export function createSession(input) {
+    // Default expiration: 24 hours from now
+    const defaultExpiresAt = new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString();
+    return {
+        $id: input.$id ?? generateId('sessions'),
+        $type: 'https://schema.org.ai/Session',
+        identityId: input.identityId,
+        token: input.token ?? generateToken(),
+        expiresAt: input.expiresAt ?? defaultExpiresAt,
+        metadata: input.metadata,
+    };
+}
+/**
+ * Check if a session has expired
+ *
+ * Compares the session's `expiresAt` timestamp against the current time.
+ *
+ * @param session - The session to check
+ * @returns True if the session has expired (expiresAt is in the past)
+ *
+ * @example
+ * ```typescript
+ * const session = await getSession(token)
+ * if (isSession(session)) {
+ *   if (isSessionExpired(session)) {
+ *     // Redirect to login
+ *     throw new Error('Session expired')
+ *   }
+ *   // Continue with authenticated request
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Clean up expired sessions
+ * const sessions = await getAllSessions()
+ * const activeSessions = sessions.filter(s => !isSessionExpired(s))
+ * const expiredSessions = sessions.filter(isSessionExpired)
+ * ```
+ */
+export function isSessionExpired(session) {
+    return new Date(session.expiresAt).getTime() < Date.now();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "id.org.ai",
+  "version": "0.1.0",
+  "description": "Identity primitives for AI systems following schema.org.ai conventions",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "keywords": [
+    "identity",
+    "authentication",
+    "schema.org.ai",
+    "json-ld",
+    "ai"
+  ],
+  "license": "MIT"
+}