@digitalcard/sdk 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @digitalcard/sdk
+
+TypeScript SDK for [EIL Card](https://eilcard.com) — resolve canonical organization and person profiles for AI agents.
+
+## Install
+
+```bash
+npm install @digitalcard/sdk
+```
+
+## Quick start
+
+```typescript
+import { DigitalCard, toSchemaOrg } from '@digitalcard/sdk';
+
+const { card, meta } = await DigitalCard.resolve({ domain: 'example.com' });
+
+if (card.type === 'organization') {
+  console.log(card.name.official);
+}
+
+const jsonLd = toSchemaOrg(card);
+console.log(meta.source); // "registry" | "well-known"
+```
+
+Resolve by registry handle:
+
+```typescript
+const { card } = await DigitalCard.resolve({ handle: 'my-org' });
+```
+
+## Client options
+
+```typescript
+import { DigitalCardClient } from '@digitalcard/sdk';
+
+const client = new DigitalCardClient({
+  registryBaseUrl: 'https://eilcard.com',
+  apiKey: process.env.EILCARD_API_KEY,
+  timeout: 10_000,
+  skipWellKnownFallback: false,
+});
+
+const result = await client.resolve({ domain: 'example.com' });
+```
+
+## Discovery chain
+
+1. **Registry** — `GET {registry}/api/v1/resolve?domain=` or `/api/v1/cards/{handle}`
+2. **Fallback** — `GET https://{domain}/.well-known/digital-card`
+
+## Bridge functions
+
+| Function | Output |
+|----------|--------|
+| `toSchemaOrg(card)` | schema.org JSON-LD |
+| `toVCard(card)` | vCard 4.0 (person cards) |
+| `toLlmsTxtSection(card)` | llms.txt Markdown section |
+
+## License
+
+MIT — see [LICENSE](../../LICENSE) in the repository root.

package/dist/bridges.d.ts

@@ -0,0 +1,18 @@
+import type { Card } from './types.js';
+/** schema.org JSON-LD object (Organization or Person) */
+export type SchemaOrgDocument = Record<string, unknown>;
+/**
+ * Convert Digital Card → schema.org JSON-LD.
+ * @see packages/sdk/SDK.md §6
+ */
+export declare function toSchemaOrg(card: Card): SchemaOrgDocument;
+/**
+ * Convert Person Card → vCard 4.0 text.
+ * Organization cards throw SchemaValidationError.
+ */
+export declare function toVCard(card: Card): string;
+/**
+ * Generate an llms.txt section for site-level agent discovery.
+ */
+export declare function toLlmsTxtSection(card: Card): string;
+//# sourceMappingURL=bridges.d.ts.map

package/dist/bridges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridges.d.ts","sourceRoot":"","sources":["../src/bridges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAgC,MAAM,YAAY,CAAC;AAGrE,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAUxD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,CAsDzD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAoB1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsBnD"}

package/dist/bridges.js

@@ -0,0 +1,126 @@
+import { SchemaValidationError } from './errors.js';
+function isOrganization(card) {
+    return card.type === 'organization';
+}
+function isPerson(card) {
+    return card.type === 'person';
+}
+/**
+ * Convert Digital Card → schema.org JSON-LD.
+ * @see packages/sdk/SDK.md §6
+ */
+export function toSchemaOrg(card) {
+    if (isOrganization(card)) {
+        const baseUrl = card.contact.website ?? `https://${card.card_id}`;
+        const doc = {
+            '@context': 'https://schema.org',
+            '@type': 'Organization',
+            '@id': `${baseUrl}/#organization`,
+            name: card.name.official,
+            url: card.contact.website ?? baseUrl,
+        };
+        if (card.name.short)
+            doc.alternateName = card.name.short;
+        if (card.contact.email)
+            doc.email = card.contact.email;
+        if (card.contact.phone)
+            doc.telephone = card.contact.phone;
+        if (card.logo_url)
+            doc.logo = card.logo_url;
+        if (card.same_as?.length)
+            doc.sameAs = card.same_as;
+        const desc = [card.description?.tagline, card.description?.summary]
+            .filter(Boolean)
+            .join(' — ');
+        if (desc)
+            doc.description = desc;
+        return doc;
+    }
+    if (isPerson(card)) {
+        const baseUrl = card.human_url ?? `https://eilcard.com/kart/${card.handle ?? card.card_id}`;
+        const doc = {
+            '@context': 'https://schema.org',
+            '@type': 'Person',
+            '@id': `${baseUrl}/#person`,
+            name: card.name.full,
+            url: baseUrl,
+        };
+        if (card.name.title)
+            doc.jobTitle = card.name.title;
+        if (card.contact.email)
+            doc.email = card.contact.email;
+        if (card.contact.phone)
+            doc.telephone = card.contact.phone;
+        if (card.photo_url)
+            doc.image = card.photo_url;
+        if (card.same_as?.length)
+            doc.sameAs = card.same_as;
+        if (card.description?.summary)
+            doc.description = card.description.summary;
+        if (card.organization_ref) {
+            doc.worksFor = {
+                '@id': card.organization_ref.startsWith('http')
+                    ? card.organization_ref
+                    : `https://${card.organization_ref}/#organization`,
+            };
+        }
+        return doc;
+    }
+    throw new SchemaValidationError(`Unsupported card type`);
+}
+/**
+ * Convert Person Card → vCard 4.0 text.
+ * Organization cards throw SchemaValidationError.
+ */
+export function toVCard(card) {
+    if (!isPerson(card)) {
+        throw new SchemaValidationError('toVCard() supports person cards only');
+    }
+    const lines = [
+        'BEGIN:VCARD',
+        'VERSION:4.0',
+        `FN:${escapeVCard(card.name.full)}`,
+    ];
+    if (card.name.given)
+        lines.push(`N:${escapeVCard(card.name.family ?? '')};${escapeVCard(card.name.given)};;;`);
+    if (card.name.title)
+        lines.push(`TITLE:${escapeVCard(card.name.title)}`);
+    if (card.contact.email)
+        lines.push(`EMAIL:${card.contact.email}`);
+    if (card.contact.phone)
+        lines.push(`TEL:${card.contact.phone}`);
+    if (card.human_url)
+        lines.push(`URL:${card.human_url}`);
+    if (card.organization_ref)
+        lines.push(`ORG:${escapeVCard(card.organization_ref)}`);
+    lines.push('END:VCARD');
+    return lines.join('\r\n');
+}
+/**
+ * Generate an llms.txt section for site-level agent discovery.
+ */
+export function toLlmsTxtSection(card) {
+    const title = isOrganization(card)
+        ? card.name.official
+        : card.name.full;
+    const lines = [`# ${title}`, ''];
+    if (card.description?.tagline)
+        lines.push(`> ${card.description.tagline}`, '');
+    if (card.description?.summary)
+        lines.push(card.description.summary, '');
+    if (isOrganization(card) && card.products?.length) {
+        lines.push('## Products', '');
+        for (const p of card.products) {
+            lines.push(`- ${p.name}${p.description ? `: ${p.description}` : ''}`);
+        }
+        lines.push('');
+    }
+    if (card.human_url)
+        lines.push(`- [Digital Card](${card.human_url})`, '');
+    if (card.registry_url)
+        lines.push(`- [Registry JSON](${card.registry_url})`, '');
+    return lines.join('\n').trim();
+}
+function escapeVCard(value) {
+    return value.replace(/\\/g, '\\\\').replace(/;/g, '\\;').replace(/\n/g, '\\n');
+}

package/dist/client.d.ts

@@ -0,0 +1,21 @@
+import type { DigitalCardClientOptions, ResolveInput, ResolveResult } from './types.js';
+export declare class DigitalCardClient {
+    private readonly registryBaseUrl;
+    private readonly apiKey?;
+    private readonly timeout;
+    private readonly skipWellKnownFallback;
+    private readonly fetchFn;
+    constructor(options?: DigitalCardClientOptions);
+    resolve(input: ResolveInput): Promise<ResolveResult>;
+    private resolveByHandle;
+    private resolveByDomain;
+    private fetchRegistryCard;
+    private fetchWellKnownCard;
+    private buildHeaders;
+    private fetchWithTimeout;
+}
+/** Convenience singleton-style API */
+export declare const DigitalCard: {
+    resolve(input: ResolveInput, options?: DigitalCardClientOptions): Promise<ResolveResult>;
+};
+//# 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":"AAKA,OAAO,KAAK,EAEV,wBAAwB,EACxB,YAAY,EAEZ,aAAa,EACd,MAAM,YAAY,CAAC;AAOpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,OAAO,GAAE,wBAA6B;IAQ5C,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;YAY5C,eAAe;YAgBf,eAAe;YAyCf,iBAAiB;YAgBjB,kBAAkB;IAahC,OAAO,CAAC,YAAY;YAQN,gBAAgB;CAS/B;AAED,sCAAsC;AACtC,eAAO,MAAM,WAAW;mBACP,YAAY,YAAY,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzF,CAAC"}

package/dist/client.js

@@ -0,0 +1,138 @@
+import { CardNotFoundError, InvalidResolveInputError, RegistryError, } from './errors.js';
+const DEFAULT_REGISTRY = 'https://eilcard.com';
+const API_PREFIX = '/api/v1';
+const DEFAULT_TIMEOUT = 10_000;
+const WELL_KNOWN_PATH = '/.well-known/digital-card';
+export class DigitalCardClient {
+    registryBaseUrl;
+    apiKey;
+    timeout;
+    skipWellKnownFallback;
+    fetchFn;
+    constructor(options = {}) {
+        this.registryBaseUrl = (options.registryBaseUrl ?? DEFAULT_REGISTRY).replace(/\/$/, '');
+        this.apiKey = options.apiKey;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.skipWellKnownFallback = options.skipWellKnownFallback ?? false;
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async resolve(input) {
+        if (Boolean(input.domain) === Boolean(input.handle)) {
+            throw new InvalidResolveInputError();
+        }
+        if (input.handle) {
+            return this.resolveByHandle(input.handle);
+        }
+        return this.resolveByDomain(input.domain);
+    }
+    async resolveByHandle(handle) {
+        const url = `${this.registryBaseUrl}${API_PREFIX}/cards/${encodeURIComponent(handle)}`;
+        const card = await this.fetchRegistryCard(url);
+        return {
+            card,
+            meta: {
+                source: 'registry',
+                registry_url: url,
+                well_known_url: card.contact.website
+                    ? `${card.contact.website.replace(/\/$/, '')}${WELL_KNOWN_PATH}`
+                    : undefined,
+                resolved_at: new Date().toISOString(),
+            },
+        };
+    }
+    async resolveByDomain(domain) {
+        const normalized = normalizeDomain(domain);
+        const registryUrl = `${this.registryBaseUrl}${API_PREFIX}/resolve?domain=${encodeURIComponent(normalized)}`;
+        try {
+            const card = await this.fetchRegistryCard(registryUrl);
+            return {
+                card,
+                meta: {
+                    source: 'registry',
+                    registry_url: registryUrl,
+                    well_known_url: `https://${normalized}${WELL_KNOWN_PATH}`,
+                    resolved_at: new Date().toISOString(),
+                },
+            };
+        }
+        catch (error) {
+            if (!(error instanceof RegistryError) || error.status !== 404) {
+                throw error;
+            }
+        }
+        if (this.skipWellKnownFallback) {
+            throw new CardNotFoundError({ domain: normalized });
+        }
+        const wellKnownUrl = `https://${normalized}${WELL_KNOWN_PATH}`;
+        const card = await this.fetchWellKnownCard(wellKnownUrl);
+        if (!card) {
+            throw new CardNotFoundError({ domain: normalized });
+        }
+        return {
+            card,
+            meta: {
+                source: 'well-known',
+                well_known_url: wellKnownUrl,
+                resolved_at: new Date().toISOString(),
+            },
+        };
+    }
+    async fetchRegistryCard(url) {
+        const response = await this.fetchWithTimeout(url, {
+            headers: this.buildHeaders({ accept: 'application/json' }),
+        });
+        if (response.status === 404) {
+            throw new RegistryError(`Registry returned 404 for ${url}`, 404);
+        }
+        if (!response.ok) {
+            throw new RegistryError(`Registry error ${response.status}`, response.status);
+        }
+        const body = (await response.json());
+        return 'card' in body && body.card ? body.card : body;
+    }
+    async fetchWellKnownCard(url) {
+        try {
+            const response = await this.fetchWithTimeout(url, {
+                headers: { Accept: 'application/json' },
+            });
+            if (response.status === 404)
+                return null;
+            if (!response.ok)
+                return null;
+            return (await response.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    buildHeaders(extra) {
+        const headers = { ...extra };
+        if (this.apiKey) {
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+    async fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            return await this.fetchFn(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+/** Convenience singleton-style API */
+export const DigitalCard = {
+    resolve(input, options) {
+        return new DigitalCardClient(options).resolve(input);
+    },
+};
+function normalizeDomain(domain) {
+    return domain
+        .trim()
+        .toLowerCase()
+        .replace(/^https?:\/\//, '')
+        .replace(/\/.*$/, '');
+}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+import type { ResolveInput } from './types.js';
+export declare class DigitalCardError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class CardNotFoundError extends DigitalCardError {
+    readonly input: ResolveInput;
+    constructor(input: ResolveInput);
+}
+export declare class InvalidResolveInputError extends DigitalCardError {
+    constructor();
+}
+export declare class RegistryError extends DigitalCardError {
+    readonly status?: number;
+    constructor(message: string, status?: number, cause?: unknown);
+}
+export declare class SchemaValidationError extends DigitalCardError {
+    constructor(message: 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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;gBAEjB,KAAK,EAAE,YAAY;CAMhC;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;;CAK7D;AAED,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK9D;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,35 @@
+export class DigitalCardError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'DigitalCardError';
+    }
+}
+export class CardNotFoundError extends DigitalCardError {
+    input;
+    constructor(input) {
+        const target = input.domain ?? input.handle ?? 'unknown';
+        super(`Digital card not found: ${target}`);
+        this.name = 'CardNotFoundError';
+        this.input = input;
+    }
+}
+export class InvalidResolveInputError extends DigitalCardError {
+    constructor() {
+        super('Provide exactly one of domain or handle');
+        this.name = 'InvalidResolveInputError';
+    }
+}
+export class RegistryError extends DigitalCardError {
+    status;
+    constructor(message, status, cause) {
+        super(message, { cause });
+        this.name = 'RegistryError';
+        this.status = status;
+    }
+}
+export class SchemaValidationError extends DigitalCardError {
+    constructor(message) {
+        super(message);
+        this.name = 'SchemaValidationError';
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DigitalCard, DigitalCardClient } from './client.js';
+export { toSchemaOrg, toVCard, toLlmsTxtSection } from './bridges.js';
+export type { SchemaOrgDocument } from './bridges.js';
+export { CardNotFoundError, DigitalCardError, InvalidResolveInputError, RegistryError, SchemaValidationError, } from './errors.js';
+export type { ActionType, Apps, Card, CardAction, CardBase, CardMode, CardType, Contact, Description, DigitalCardClientOptions, Legal, LegalType, OrganizationCard, OrganizationName, PersonCard, PersonName, Product, ResolveInput, ResolveMeta, ResolveResult, ResolveSource, VerificationMethod, } from './types.js';
+export { SCHEMA_VERSION } from './types.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,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,WAAW,EACX,wBAAwB,EACxB,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,OAAO,EACP,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { DigitalCard, DigitalCardClient } from './client.js';
+export { toSchemaOrg, toVCard, toLlmsTxtSection } from './bridges.js';
+export { CardNotFoundError, DigitalCardError, InvalidResolveInputError, RegistryError, SchemaValidationError, } from './errors.js';
+export { SCHEMA_VERSION } from './types.js';

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @digitalcard/sdk — types aligned with schema/v1.0.schema.json
+ * Faz B3 — specification types (implementation in Faz D)
+ */
+export declare const SCHEMA_VERSION: "1.0";
+export type CardType = 'organization' | 'person';
+export type VerificationMethod = 'dns' | 'email' | 'tls' | 'trade_registry' | 'public_record';
+export type LegalType = 'technology_company' | 'smb' | 'enterprise' | 'public_institution' | 'university' | 'ngo' | 'individual';
+export type ActionType = 'call' | 'email' | 'link' | 'vcard' | 'calendar' | 'whatsapp' | 'app';
+export interface OrganizationName {
+    official: string;
+    short?: string;
+    alternate?: string[];
+}
+export interface PersonName {
+    full: string;
+    given?: string;
+    family?: string;
+    title?: string;
+}
+export interface Contact {
+    phone?: string;
+    email?: string;
+    website?: string;
+    whatsapp?: string;
+}
+export interface Legal {
+    country: string;
+    type?: LegalType;
+    tax_id?: string;
+    trade_registry?: string;
+}
+export interface Description {
+    tagline?: string;
+    summary?: string;
+}
+export interface Product {
+    id: string;
+    name: string;
+    description?: string;
+    url?: string;
+}
+export interface Apps {
+    play_store?: string;
+    app_store?: string;
+    web_app?: string;
+}
+export interface CardAction {
+    type: ActionType;
+    label: string;
+    value?: string;
+    url?: string;
+}
+export interface CardMode {
+    id: string;
+    label: string;
+    active_links?: string[];
+}
+export interface CardBase {
+    schema_version: typeof SCHEMA_VERSION;
+    card_id: string;
+    type: CardType;
+    handle?: string;
+    verified?: boolean;
+    verification_method?: VerificationMethod[];
+    contact: Contact;
+    description?: Description;
+    actions?: CardAction[];
+    same_as?: string[];
+    updated_at: string;
+    created_at?: string;
+    human_url?: string;
+    registry_url?: string;
+}
+export interface OrganizationCard extends CardBase {
+    type: 'organization';
+    name: OrganizationName;
+    legal?: Legal;
+    products?: Product[];
+    apps?: Apps;
+    logo_url?: string;
+}
+export interface PersonCard extends CardBase {
+    type: 'person';
+    name: PersonName;
+    organization_ref?: string;
+    modes?: CardMode[];
+    photo_url?: string;
+}
+export type Card = OrganizationCard | PersonCard;
+export type ResolveSource = 'registry' | 'well-known';
+export interface ResolveMeta {
+    source: ResolveSource;
+    well_known_url?: string;
+    registry_url?: string;
+    resolved_at: string;
+}
+export interface ResolveResult {
+    card: Card;
+    meta: ResolveMeta;
+}
+export interface ResolveInput {
+    /** Domain — e.g. sinyalle.com */
+    domain?: string;
+    /** Registry handle — e.g. sinyalle */
+    handle?: string;
+}
+export interface DigitalCardClientOptions {
+    /** Registry API base — default https://api.digitalcard.tr */
+    registryBaseUrl?: string;
+    /** Optional API key for higher quota */
+    apiKey?: string;
+    /** Request timeout ms — default 10000 */
+    timeout?: number;
+    /** Skip well-known fallback */
+    skipWellKnownFallback?: boolean;
+    /** Custom fetch implementation (Node, edge, test mocks) */
+    fetch?: typeof fetch;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * @digitalcard/sdk — types aligned with schema/v1.0.schema.json
+ * Faz B3 — specification types (implementation in Faz D)
+ */
+export const SCHEMA_VERSION = '1.0';

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@digitalcard/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for EIL Card — resolve canonical entity profiles for AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "eil",
+    "digital-card",
+    "entity-identity",
+    "agent",
+    "schema.org",
+    "llms",
+    "resolve"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mendocan/eilcard.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://eilcard.com",
+  "bugs": {
+    "url": "https://github.com/Mendocan/eilcard/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  }
+}